@trillboards/cli 0.1.6 → 0.1.7

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @trillboards/cli
 $ trillboards COMMAND
 running command...
 $ trillboards (--version)
-@trillboards/cli/0.1.6 linux-x64 node-v22.23.3
+@trillboards/cli/0.1.7 linux-x64 node-v22.23.4
 $ trillboards --help [COMMAND]
 USAGE
   $ trillboards COMMAND
@@ -55,6 +55,8 @@ USAGE
 * [`trillboards generated generated-creative-feedback-variants-register EXPERIMENT_ID`](#trillboards-generated-generated-creative-feedback-variants-register-experiment_id)
 * [`trillboards generated generated-csi-venue-history SCREENID`](#trillboards-generated-generated-csi-venue-history-screenid)
 * [`trillboards generated generated-csi-venue-occupancy SCREENID`](#trillboards-generated-generated-csi-venue-occupancy-screenid)
+* [`trillboards generated generated-data-api-ad-sightings`](#trillboards-generated-generated-data-api-ad-sightings)
+* [`trillboards generated generated-data-api-ad-sightings-history`](#trillboards-generated-generated-data-api-ad-sightings-history)
 * [`trillboards generated generated-data-api-aggregate`](#trillboards-generated-generated-data-api-aggregate)
 * [`trillboards generated generated-data-api-list-screens`](#trillboards-generated-generated-data-api-list-screens)
 * [`trillboards generated generated-data-api-lookalike-screens`](#trillboards-generated-generated-data-api-lookalike-screens)
@@ -66,6 +68,7 @@ USAGE
 * [`trillboards generated generated-data-api-stream`](#trillboards-generated-generated-data-api-stream)
 * [`trillboards generated generated-data-api-usage`](#trillboards-generated-generated-data-api-usage)
 * [`trillboards generated generated-device-ota-manifest`](#trillboards-generated-generated-device-ota-manifest)
+* [`trillboards generated generated-device-retained-cctv-review`](#trillboards-generated-generated-device-retained-cctv-review)
 * [`trillboards generated generated-device-sensing-profile`](#trillboards-generated-generated-device-sensing-profile)
 * [`trillboards generated generated-error-code-get CODE`](#trillboards-generated-generated-error-code-get-code)
 * [`trillboards generated generated-error-codes-list`](#trillboards-generated-generated-error-codes-list)
@@ -791,6 +794,73 @@ EXAMPLES
   $ trillboards generated csi-venue-occupancy
 ```
 
+## `trillboards generated generated-data-api-ad-sightings`
+
+Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo link.
+
+```
+USAGE
+  $ trillboards generated generated-data-api-ad-sightings [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--brand <value>]
+    [--brand_id <value>] [--market <value>] [--surface <value>] [--board_id <value>] [--creative_id <value>]
+    [--instrument <value>] [--from <value>] [--to <value>] [--limit <value>] [--cursor <value>]
+
+FLAGS
+  --api-key=<value>      [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>     [default: https://api.trillboards.com] API base URL
+  --board_id=<value>     A board the sighting was matched to, repeatable.
+  --brand=<value>        A brand, repeatable for a brand set (competitors). Matched however it is typed: "McDonald's",
+                         "mcdonalds" and "Mc Donalds" find the same records.
+  --brand_id=<value>     A resolved brand id, repeatable. Combined with `brand` as either-or.
+  --creative_id=<value>  A sighted creative (the campaign artwork), repeatable.
+  --cursor=<value>       The `next_cursor` of the previous page.
+  --format=<option>      Output format
+                         <options: json|table|yaml>
+  --from=<value>         Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.
+  --instrument=<value>   The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.
+  --limit=<value>        Records per page, 1..500 (default 50). The page limit is reserved; the records returned are
+                         billed.
+  --market=<value>       A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.
+  --surface=<value>      The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.
+  --to=<value>           End (exclusive). Default: now. The span is at most 400 days.
+
+DESCRIPTION
+  Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo link.
+
+EXAMPLES
+  $ trillboards generated data-api-ad-sightings
+```
+
+## `trillboards generated generated-data-api-ad-sightings-history`
+
+Outdoor creative history by brand, market and month, from the creative ledger.
+
+```
+USAGE
+  $ trillboards generated generated-data-api-ad-sightings-history [--api-key <value>] [--base-url <value>] [--format json|table|yaml] [--brand <value>]
+    [--brand_id <value>] [--market <value>] [--from <value>] [--to <value>] [--grain <value>] [--limit <value>]
+    [--cursor <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --brand=<value>     A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.
+  --brand_id=<value>  A resolved brand id, repeatable.
+  --cursor=<value>    The `next_cursor` of the previous page.
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+  --from=<value>      First month (YYYY-MM) or day. Default: 12 months before `to`.
+  --grain=<value>     market_month (default) or fleet_month.
+  --limit=<value>     Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are billed.
+  --market=<value>    A market as COUNTRY:CODE, repeatable.
+  --to=<value>        Last month (YYYY-MM, inclusive) or day. Default: this month.
+
+DESCRIPTION
+  Outdoor creative history by brand, market and month, from the creative ledger.
+
+EXAMPLES
+  $ trillboards generated data-api-ad-sightings-history
+```
+
 ## `trillboards generated generated-data-api-aggregate`
 
 Aggregate audience analytics for a time window.
@@ -1061,6 +1131,29 @@ EXAMPLES
   $ trillboards generated device-ota-manifest
 ```
 
+## `trillboards generated generated-device-retained-cctv-review`
+
+Store original CCTV evidence and its completed local review.
+
+```
+USAGE
+  $ trillboards generated generated-device-retained-cctv-review [--api-key <value>] [--base-url <value>] [--format
+  json|table|yaml] [--data <value>]
+
+FLAGS
+  --api-key=<value>   [env: TRILLBOARDS_API_KEY] API key (or set TRILLBOARDS_API_KEY env var)
+  --base-url=<value>  [default: https://api.trillboards.com] API base URL
+  --data=<value>      JSON request body
+  --format=<option>   Output format
+                      <options: json|table|yaml>
+
+DESCRIPTION
+  Store original CCTV evidence and its completed local review.
+
+EXAMPLES
+  $ trillboards generated device-retained-cctv-review
+```
+
 ## `trillboards generated generated-device-sensing-profile`
 
 Active sensing profile for the calling connector's bound screen.

package/dist/commands/generated/generated-data-api-ad-sightings-history.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Dataapiadsightingshistory extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        brand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        brand_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        market: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        grain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-data-api-ad-sightings-history.js

@@ -0,0 +1,53 @@
+// AUTO-GENERATED from OpenAPI spec (data-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Dataapiadsightingshistory extends BaseCommand {
+    static description = "Outdoor creative history by brand, market and month, from the creative ledger.";
+    static examples = [`$ trillboards generated data-api-ad-sightings-history`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'brand': Flags.string({ description: 'A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.' }),
+        'brand_id': Flags.string({ description: 'A resolved brand id, repeatable.' }),
+        'market': Flags.string({ description: 'A market as COUNTRY:CODE, repeatable.' }),
+        'from': Flags.string({ description: 'First month (YYYY-MM) or day. Default: 12 months before `to`.' }),
+        'to': Flags.string({ description: 'Last month (YYYY-MM, inclusive) or day. Default: this month.' }),
+        'grain': Flags.string({ description: 'market_month (default) or fleet_month.' }),
+        'limit': Flags.string({ description: 'Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are billed.' }),
+        'cursor': Flags.string({ description: 'The `next_cursor` of the previous page.' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Dataapiadsightingshistory);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v1/data/ad-sightings/history';
+        const params = {};
+        if (flags['brand'])
+            params['brand'] = flags['brand'];
+        if (flags['brand_id'])
+            params['brand_id'] = flags['brand_id'];
+        if (flags['market'])
+            params['market'] = flags['market'];
+        if (flags['from'])
+            params['from'] = flags['from'];
+        if (flags['to'])
+            params['to'] = flags['to'];
+        if (flags['grain'])
+            params['grain'] = flags['grain'];
+        if (flags['limit'])
+            params['limit'] = flags['limit'];
+        if (flags['cursor'])
+            params['cursor'] = flags['cursor'];
+        const result = await apiRequest('GET', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-data-api-ad-sightings.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Dataapiadsightings extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        brand: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        brand_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        market: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        surface: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        board_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        creative_id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        instrument: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        from: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        to: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-data-api-ad-sightings.js

@@ -0,0 +1,62 @@
+// AUTO-GENERATED from OpenAPI spec (data-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Dataapiadsightings extends BaseCommand {
+    static description = "Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo link.";
+    static examples = [`$ trillboards generated data-api-ad-sightings`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        'brand': Flags.string({ description: 'A brand, repeatable for a brand set (competitors). Matched however it is typed: "McDonald\'s", "mcdonalds" and "Mc Donalds" find the same records.' }),
+        'brand_id': Flags.string({ description: 'A resolved brand id, repeatable. Combined with `brand` as either-or.' }),
+        'market': Flags.string({ description: 'A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.' }),
+        'surface': Flags.string({ description: 'The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.' }),
+        'board_id': Flags.string({ description: 'A board the sighting was matched to, repeatable.' }),
+        'creative_id': Flags.string({ description: 'A sighted creative (the campaign artwork), repeatable.' }),
+        'instrument': Flags.string({ description: 'The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.' }),
+        'from': Flags.string({ description: 'Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.' }),
+        'to': Flags.string({ description: 'End (exclusive). Default: now. The span is at most 400 days.' }),
+        'limit': Flags.string({ description: 'Records per page, 1..500 (default 50). The page limit is reserved; the records returned are billed.' }),
+        'cursor': Flags.string({ description: 'The `next_cursor` of the previous page.' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Dataapiadsightings);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v1/data/ad-sightings';
+        const params = {};
+        if (flags['brand'])
+            params['brand'] = flags['brand'];
+        if (flags['brand_id'])
+            params['brand_id'] = flags['brand_id'];
+        if (flags['market'])
+            params['market'] = flags['market'];
+        if (flags['surface'])
+            params['surface'] = flags['surface'];
+        if (flags['board_id'])
+            params['board_id'] = flags['board_id'];
+        if (flags['creative_id'])
+            params['creative_id'] = flags['creative_id'];
+        if (flags['instrument'])
+            params['instrument'] = flags['instrument'];
+        if (flags['from'])
+            params['from'] = flags['from'];
+        if (flags['to'])
+            params['to'] = flags['to'];
+        if (flags['limit'])
+            params['limit'] = flags['limit'];
+        if (flags['cursor'])
+            params['cursor'] = flags['cursor'];
+        const result = await apiRequest('GET', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/dist/commands/generated/generated-device-retained-cctv-review.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../base-command.js';
+export default class Deviceretainedcctvreview extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {};
+    static flags: {
+        data: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'api-key': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'base-url': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/generated/generated-device-retained-cctv-review.js

@@ -0,0 +1,32 @@
+// AUTO-GENERATED from OpenAPI spec (device-api) -- do not edit manually
+// Regenerate with: npm run generate
+import { Flags } from '@oclif/core';
+import { BaseCommand } from '../../base-command.js';
+import { apiRequest } from '../../http.js';
+import { formatOutput } from '../../output.js';
+export default class Deviceretainedcctvreview extends BaseCommand {
+    static description = "Store original CCTV evidence and its completed local review.";
+    static examples = [`$ trillboards generated device-retained-cctv-review`];
+    static args = {};
+    static flags = {
+        ...BaseCommand.baseFlags,
+        data: Flags.string({ description: 'JSON request body' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Deviceretainedcctvreview);
+        this.setParsedFlags(flags);
+        const apiKey = this.getApiKey();
+        if (!apiKey)
+            this.error('Not logged in. Run: trillboards login');
+        let urlPath = '/v2/earner/cctv-retained/reviews';
+        const params = {};
+        const body = flags.data ? JSON.parse(flags.data) : undefined;
+        const result = await apiRequest('POST', urlPath, {
+            apiKey,
+            baseUrl: flags['base-url'] ?? 'https://api.trillboards.com',
+            params: Object.keys(params).length > 0 ? params : undefined,
+            body,
+        });
+        this.log(formatOutput(result, this.getFormat()));
+    }
+}

package/oclif.manifest.json

@@ -1276,69 +1276,6 @@
         "reconcile.js"
       ]
     },
-    "endpoints": {
-      "aliases": [],
-      "args": {},
-      "description": "Discover available API endpoints",
-      "examples": [
-        "<%= config.bin %> endpoints",
-        "<%= config.bin %> endpoints --search screens",
-        "<%= config.bin %> endpoints --format json"
-      ],
-      "flags": {
-        "api-key": {
-          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
-          "env": "TRILLBOARDS_API_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "description": "API base URL",
-          "name": "base-url",
-          "default": "https://api.trillboards.com",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "format": {
-          "description": "Output format",
-          "name": "format",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "json",
-            "table",
-            "yaml"
-          ],
-          "type": "option"
-        },
-        "search": {
-          "char": "s",
-          "description": "Search query to filter endpoints",
-          "name": "search",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "endpoints",
-      "pluginAlias": "@trillboards/cli",
-      "pluginName": "@trillboards/cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "endpoints",
-        "index.js"
-      ]
-    },
     "errors": {
       "aliases": [],
       "args": {
@@ -2003,6 +1940,245 @@
         "generated-csi-venue-occupancy.js"
       ]
     },
+    "generated:generated-data-api-ad-sightings-history": {
+      "aliases": [],
+      "args": {},
+      "description": "Outdoor creative history by brand, market and month, from the creative ledger.",
+      "examples": [
+        "$ trillboards generated data-api-ad-sightings-history"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "brand": {
+          "description": "A brand by name, repeatable (competitors). Resolved to its brand id the way the brand search does.",
+          "name": "brand",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "brand_id": {
+          "description": "A resolved brand id, repeatable.",
+          "name": "brand_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "market": {
+          "description": "A market as COUNTRY:CODE, repeatable.",
+          "name": "market",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "First month (YYYY-MM) or day. Default: 12 months before `to`.",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "Last month (YYYY-MM, inclusive) or day. Default: this month.",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "grain": {
+          "description": "market_month (default) or fleet_month.",
+          "name": "grain",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Rows per page, 1..500 (default 100). The page limit is reserved; the rows returned are billed.",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cursor": {
+          "description": "The `next_cursor` of the previous page.",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-data-api-ad-sightings-history",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-data-api-ad-sightings-history.js"
+      ]
+    },
+    "generated:generated-data-api-ad-sightings": {
+      "aliases": [],
+      "args": {},
+      "description": "Ad-sighting records: outdoor ads our cab cameras read, each with a signed photo link.",
+      "examples": [
+        "$ trillboards generated data-api-ad-sightings"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "brand": {
+          "description": "A brand, repeatable for a brand set (competitors). Matched however it is typed: \"McDonald's\", \"mcdonalds\" and \"Mc Donalds\" find the same records.",
+          "name": "brand",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "brand_id": {
+          "description": "A resolved brand id, repeatable. Combined with `brand` as either-or.",
+          "name": "brand_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "market": {
+          "description": "A market as COUNTRY:CODE (US DMA or CA CMA), repeatable.",
+          "name": "market",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "surface": {
+          "description": "The surface kind as read (billboard, storefront, bus_shelter, ...), repeatable.",
+          "name": "surface",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "board_id": {
+          "description": "A board the sighting was matched to, repeatable.",
+          "name": "board_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "creative_id": {
+          "description": "A sighted creative (the campaign artwork), repeatable.",
+          "name": "creative_id",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "instrument": {
+          "description": "The reading instrument (ssr-v2, ssr-v1, vlmtext-v1, edge_ocr_v1), repeatable.",
+          "name": "instrument",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "Start (inclusive), YYYY-MM-DD or an ISO-8601 instant. Default: 30 days before `to`.",
+          "name": "from",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "to": {
+          "description": "End (exclusive). Default: now. The span is at most 400 days.",
+          "name": "to",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "limit": {
+          "description": "Records per page, 1..500 (default 50). The page limit is reserved; the records returned are billed.",
+          "name": "limit",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "cursor": {
+          "description": "The `next_cursor` of the previous page.",
+          "name": "cursor",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-data-api-ad-sightings",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-data-api-ad-sightings.js"
+      ]
+    },
     "generated:generated-data-api-aggregate": {
       "aliases": [],
       "args": {},
@@ -2752,6 +2928,66 @@
         "generated-device-ota-manifest.js"
       ]
     },
+    "generated:generated-device-retained-cctv-review": {
+      "aliases": [],
+      "args": {},
+      "description": "Store original CCTV evidence and its completed local review.",
+      "examples": [
+        "$ trillboards generated device-retained-cctv-review"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "data": {
+          "description": "JSON request body",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "generated:generated-device-retained-cctv-review",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "generated",
+        "generated-device-retained-cctv-review.js"
+      ]
+    },
     "generated:generated-device-sensing-profile": {
       "aliases": [],
       "args": {},
@@ -4416,7 +4652,70 @@
         "screens",
         "watch.js"
       ]
+    },
+    "endpoints": {
+      "aliases": [],
+      "args": {},
+      "description": "Discover available API endpoints",
+      "examples": [
+        "<%= config.bin %> endpoints",
+        "<%= config.bin %> endpoints --search screens",
+        "<%= config.bin %> endpoints --format json"
+      ],
+      "flags": {
+        "api-key": {
+          "description": "API key (or set TRILLBOARDS_API_KEY env var)",
+          "env": "TRILLBOARDS_API_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "description": "API base URL",
+          "name": "base-url",
+          "default": "https://api.trillboards.com",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "table",
+            "yaml"
+          ],
+          "type": "option"
+        },
+        "search": {
+          "char": "s",
+          "description": "Search query to filter endpoints",
+          "name": "search",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "endpoints",
+      "pluginAlias": "@trillboards/cli",
+      "pluginName": "@trillboards/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "endpoints",
+        "index.js"
+      ]
     }
   },
-  "version": "0.1.6"
+  "version": "0.1.7"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@trillboards/cli",
   "description": "Official CLI for the Trillboards DOOH API",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "author": "Trillboards",
   "bin": {
     "trillboards": "./bin/run.js"