@officexapp/catalogs-cli

CLI for Catalog Funnel — upload videos, push catalog schemas, manage assets.

Setup

npm install -g @officexapp/catalogs-cli

Configure authentication:

export CATALOGS_API_URL="https://catalog-funnel-api-staging.cloud.zoomgtm.com"
export CATALOGS_TOKEN="cfk_your_api_key_here"

Or create ~/.catalogs-cli/config.json:

{
  "api_url": "https://catalog-funnel-api-staging.cloud.zoomgtm.com",
  "token": "cfk_your_api_key_here"
}

Commands

Video

Upload a video, transcode to HLS, and get the streaming URL:

catalogs video upload ./demo.mp4

Skip transcoding (upload only):

catalogs video upload ./demo.mp4 --no-transcode

Check transcode status:

catalogs video status <videoId>

Catalog

Push a catalog schema (creates or updates):

catalogs catalog push ./my-funnel.json
catalogs catalog push ./my-funnel.json --publish

List all catalogs:

catalogs catalog list

Auth

Check your current config:

catalogs whoami

Using HLS URLs in Catalog Schemas

After uploading a video, use the returned hls_url in your catalog schema:

{
  "id": "comp_intro_video",
  "type": "video",
  "props": {
    "hls_url": "https://d1k9qtz75bfygl.cloudfront.net/media/transcoded/user123/video456/index.m3u8",
    "poster": "https://example.com/thumb.jpg",
    "chapters": [
      { "time": 0, "label": "Intro" },
      { "time": 120, "label": "Demo" },
      { "time": 300, "label": "Pricing" }
    ],
    "skippable": false,
    "require_watch_percent": 80
  }
}