LB-Scripts

Use FiveMesh CDN with LB-Phone or LB-Tablet by configuring a custom upload method. Use presigned uploads so the script can upload phone or tablet media without exposing your FiveMesh service key to clients.

If you use both LB-Phone and LB-Tablet, give each script its own CDN path prefix such as /phone and /tablet. You can restrict service keys to those prefixes from the FiveMesh dashboard.

Prerequisites

Before you begin, confirm:

FiveMesh CDN is set up for the active workspace.
You have a service key with CDN write access.
The service key is scoped to the path prefixes the script should manage.
You can edit the LB-Phone or LB-Tablet server files.

Use these values while configuring the integration:

Value	Description
`FIVEMESH_PRESIGNED_UPLOAD_URL`	The presigned upload endpoint provided for your FiveMesh workspace or integration environment.
`YOUR_API_KEY`	A scoped FiveMesh service key.
`YOUR_CDN_WORKSPACE`	The CDN workspace name you configured during setup.
`file`	The upload field name used by LB-Scripts.

Do not configure direct uploads with a permanent API key in client-visible files. Keep the service key in server-side LB-Scripts files and return presigned upload URLs to the client.

LB-Phone configuration

To use presigned uploads with LB-Phone, update the server and upload configuration.

Configure server credentials

Open lb-phone/server/apiKeys.lua and configure the API keys and target path prefixes.

API_KEYS = {
    Video = "YOUR_API_KEY",
    Image = "YOUR_API_KEY",
    Audio = "YOUR_API_KEY",
}

UPLOAD_PATHS = {
    Video = "phone/video",
    Image = "phone/images",
    Audio = "phone/audio",
}

Request a presigned upload URL

Update lb-phone/server/custom/functions/functions.lua to implement GetPresignedUrl.

function GetPresignedUrl(source, uploadType)
    local apiKey = API_KEYS[uploadType]
    local uploadPath = UPLOAD_PATHS[uploadType]

    if not apiKey then
        infoprint("error", ("[GetPresignedUrl] Invalid uploadType '%s' (missing API key or bucket")):format(uploadType))
        return false
    end

    local p = promise.new()

    PerformHttpRequest(
        ("https://api.fivemesh.io/v1/presigned-url?allowCustomMetadata=true&randomizeName=true&path=%s"):format(uploadPath),
        function(status, body, headers, error)
            if status ~= 201 then
                infoprint("error", ("[GetPresignedUrl] Request failed for '%s', status: %s"):format(uploadType, status))
                if error then
                  infoprint("error", "Error: " .. error)
                end
                p:resolve(false)
                return
            end

            local ok, data = pcall(json.decode, body)
            if not ok or not data or not data.success or not data.uploadUrl then
                infoprint("error", ("[GetPresignedUrl] Invalid response for '%s'"):format(uploadType))
                p:resolve(false)
                return
            end

            p:resolve(data.uploadUrl)
        end,
        "GET",
        nil,
        { ["Authorization"] = ("Bearer %s"):format(apiKey) }
    )

    return Citizen.Await(p)
end

Use presigned URLs in upload settings

In lb-phone/shared/upload.lua, set url to "PRESIGNED_URL" for custom methods.

UploadMethods = {
    Custom = {
        Video = {
            url = "PRESIGNED_URL",
            field = "file",
        },
        Image = {
            url = "PRESIGNED_URL",
            field = "file",
        },
        Audio = {
            url = "PRESIGNED_URL",
            field = "file",
        },
    }
}

Return the custom method

Confirm CustomGetUploadMethod exists in lb-phone/client/custom/functions/functions.lua.

---@param uploadType "Video" | "Image" | "Audio"
---@return UploadMethod?
function CustomGetUploadMethod(uploadType)
    local methods = UploadMethods[Config.UploadMethod[uploadType]]
    if not methods then
        infoprint("error", "Upload methods not found for ", uploadType)
        return
    end

    ---@type UploadMethod?
    local method = methods[uploadType] or methods.Default
    if not method then
        infoprint("error", "Upload method not found for ", uploadType)
        return
    end

    return method
end

LB-Tablet configuration

LB-Tablet uses the same presigned upload pattern.

Configure server credentials

Open lb-tablet/server/apiKeys.lua and add the same API_KEYS and UPLOAD_PATHS values.

Request a presigned upload URL

Update lb-tablet/server/custom/functions/functions.lua with the same GetPresignedUrl function used for LB-Phone.

Use presigned URLs in upload settings

In lb-tablet/config/upload.lua, set url = "PRESIGNED_URL" for each custom media type.

Return the custom method

Confirm CustomGetUploadMethod is implemented in lb-tablet/client/custom/functions/functions.lua.

Dashboard

FiveMesh CDN

FiveMesh Cache

FiveMesh Voice

Integrations

Account

Reference

Prerequisites

LB-Phone configuration

LB-Tablet configuration

​Prerequisites

​LB-Phone configuration

​LB-Tablet configuration

​Related pages

Prerequisites

LB-Phone configuration

LB-Tablet configuration

Related pages