@pitcher/cli-scripts 2.3.0 → 2.5.0

package/README.md

@@ -86,3 +86,223 @@ p dev-sync watch --file-id <pitcher_file_id> --org pitcher
 - Run from your app's project root (with `dist/` folder) or directly from the `dist/` folder
 - The `watch` command automatically reverts changes on graceful shutdown (Ctrl+C)
 - Apps with dev override show a badge in the installed apps view
+
+## To run the `files` command:
+
+Manage Pitcher content files — list within an instance, fetch by id, create (upload or link), or update.
+
+```bash
+# List files in an instance (paginated)
+p files list --instance-id 01... --api-key myapikey
+
+# Filter by tags or specific IDs
+p files list --instance-id 01... --tags brochure,demo --api-key myapikey
+
+# Get a single file by id
+p files get 01FILEID... --api-key myapikey
+
+# Create a file from a local upload
+p files create --instance-id 01... --name "Q3 Deck" --file ./deck.pdf --api-key myapikey
+
+# Create a link/WEB file from a source URL
+p files create --instance-id 01... --name "Product Page" --source-url https://example.com --api-key myapikey
+
+# Update a file's tags or metadata (metadata/app-metadata are deep-merged, not replaced)
+p files update 01FILEID... --tags updated,reviewed --api-key myapikey
+```
+
+## To run the `folders` command:
+
+Manage Pitcher content folders — list, fetch (or the instance root), create, and update smart-folder rules.
+
+```bash
+# List folders in an instance (paginated)
+p folders list --instance-id 01... --api-key myapikey
+
+# Get a folder by id
+p folders get 01FOLDERID... --api-key myapikey
+
+# Get the instance root folder
+p folders get --root --instance-id 01... --api-key myapikey
+
+# Create a folder under a parent
+p folders create --name "Marketing" --parent-folder-id 01PARENTID... --api-key myapikey
+
+# Update a folder's name or access type
+p folders update 01FOLDERID... --name "Sales Enablement" --access-type restricted --api-key myapikey
+```
+
+## To run the `search` command:
+
+```bash
+# Ranked cross-type search (files, canvases, users, apps) within an instance
+p search --instance-id 01... --query "quarterly deck" --api-key myapikey
+```
+
+## To run the `instances` command:
+
+Discover Pitcher instances — resolve names to instance IDs before running other commands.
+
+```bash
+# List instances (optionally filter by region/storage-region/environment)
+p instances list --api-key myapikey
+
+p instances list --environment Demo --api-key myapikey
+
+# Get a single instance by id
+p instances info 01INSTANCEID... --api-key myapikey
+```
+
+## To run the `canvases` command:
+
+Read Pitcher canvases — presentations, sections, and blocks.
+
+```bash
+# List canvases in an instance (paginated)
+p canvases list --instance-id 01... --api-key myapikey
+
+# Only templates or only sections
+p canvases list --instance-id 01... --is-template --api-key myapikey
+p canvases list --instance-id 01... --is-section --api-key myapikey
+
+# Only blocks (blocks are hidden unless --is-block is passed)
+p canvases list --instance-id 01... --is-block --api-key myapikey
+
+# Get a single canvas by id
+p canvases get 01CANVASID... --api-key myapikey
+```
+
+## To run the `shared-links` command:
+
+Create and read share links for canvases or files (returns the `short_url`).
+
+```bash
+# Create a share link for a canvas
+p shared-links create --canvas-id 01CANVASID... --api-key myapikey
+
+# Create a share link for a file
+p shared-links create --file-id 01FILEID... --api-key myapikey
+
+# Fetch the existing share link for a canvas
+p shared-links get --canvas-id 01CANVASID... --api-key myapikey
+```
+
+## To run the `tags` command:
+
+List tags in an instance (the server requires a search term of at least 3 characters).
+
+```bash
+# List tags matching a search term
+p tags list --instance-id 01... --search "demo" --api-key myapikey
+
+# Filter by type
+p tags list --instance-id 01... --search "demo" --type canvases --api-key myapikey
+```
+
+## To run the `email-template` command:
+
+Create/list/get HTML email templates for the emails app. `create`, `list`, and `get` require `--instance-id` (`scaffold` does not).
+
+```bash
+# Create a template from an HTML file (inline CSS)
+p email-template create --instance-id 01... --name "Welcome" --body-file ./welcome.html --api-key myapikey
+
+# List templates (optionally filter by name/status/category/target)
+p email-template list --instance-id 01... --api-key myapikey
+
+# Get a template by id
+p email-template get --instance-id 01... --id 01TEMPLATEID... --api-key myapikey
+
+# Generate a starter HTML file with tokens in context
+p email-template scaffold --out ./welcome.html --api-key myapikey
+```
+
+Run `p email-template create --help` for the full token/marker reference.
+
+`scaffold` returns the starter HTML in the envelope `data` (never printed raw to stdout); pass `--out <path>` to write it to a file instead.
+
+## To run the `dsr-landing` command:
+
+Create/list DSR (Digital Sales Room) landing-page templates, and set one as the instance-scope default. `create`, `list`, and `set-default` require `--instance-id` (`scaffold` does not).
+
+```bash
+# Create a landing template from an HTML file (must contain the email-gate marker)
+p dsr-landing create --instance-id 01... --name "Default" --html-file ./landing.html --api-key myapikey
+
+# Create and set as default in one call
+p dsr-landing create --instance-id 01... --name "Default" --html-file ./landing.html --default --api-key myapikey
+
+# Set an existing template as the default
+p dsr-landing set-default --instance-id 01... --id 01TEMPLATEID... --api-key myapikey
+
+# List templates in an instance
+p dsr-landing list --instance-id 01... --api-key myapikey
+
+# Generate a starter HTML file with the required marker and tokens in context
+p dsr-landing scaffold --out ./landing.html --api-key myapikey
+```
+
+`--html-file` must contain the `data-pitcher-email-gate` marker verbatim (the platform injects the email-gate form there) — `create` fails client-side before any request if it's missing.
+
+Run `p dsr-landing create --help` for the full token/marker reference (editable-region attributes, recipient/customer/org/rep tokens).
+
+`scaffold` returns the starter HTML in the envelope `data`; pass `--out <path>` to write it to a file instead.
+
+## To run the `announcements` command:
+
+Create/list announcement records for the wa-announcements app. `create` and `list` require `--instance-id` (`scaffold` does not).
+
+```bash
+# Create from a JSON data file
+p announcements create --instance-id 01... --from-file ./announcement.json --api-key myapikey
+
+# Create from convenience flags only
+p announcements create --instance-id 01... --title "New feature" --body "<p>Check it out</p>" --api-key myapikey
+
+# List announcements
+p announcements list --instance-id 01... --api-key myapikey
+
+# Generate a fully populated starter data.json
+p announcements scaffold --out ./announcement.json --api-key myapikey
+```
+
+`create` requires either `--from-file` or both `--title` and `--body`. `--title`/`--body`/`--priority` override matching keys from `--from-file` when both are given. Run `p announcements create --help` for the full `data` field catalog (media, links, scheduling, target groups, popup overrides) — note `start_at`/`expires_at` are naive local dates (`YYYY-MM-DD[THH:mm]`), not ISO/UTC.
+
+`scaffold` returns the starter JSON in the envelope `data`; pass `--out <path>` to write it to a file instead.
+
+## To run the `themes` command:
+
+Read canvas/branding themes (colors via `settings`, fonts via `typography`, plus `assets`/`logo`) to reference when authoring email/DSR/canvas content. Read-only.
+
+```bash
+# List all themes in the org (returns full theme objects)
+p themes list --api-key myapikey
+
+# Narrow to one instance; add per-theme canvas usage and canvas ids
+p themes list --instance-id 01... --with-usage --with-canvas-ids --api-key myapikey
+
+# Get one theme by id
+p themes get --id 01THEMEID... --api-key myapikey
+```
+
+`list` is server-capped (newest-first) with no `--limit`/`--page`; when the cap is hit the envelope carries a truncation warning. `--instance-id` narrows to themes bound to that instance and **excludes** org-level (default) themes, so omit it to see everything usable in the org.
+
+## To run the `org` command:
+
+Read the organization the API key belongs to.
+
+```bash
+p org get --api-key myapikey
+```
+
+## To run the `analytics` command:
+
+Read rollup analytics totals for an organization or instance. Requires an org-admin API key — a non-admin key returns an auth error.
+
+```bash
+# Organization-wide rollups (org-admin key required)
+p analytics org --api-key myapikey
+
+# Instance rollups (instance-admin or org-admin key required)
+p analytics instance --instance-id 01... --api-key myapikey
+```

package/dist/index.js

@@ -1,12 +1,23 @@
 #!/usr/bin/env node
-import { Command } from 'commander';
 import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { Command } from 'commander';
 import { createPublishAppCommand } from './src/commands/publishApp.js';
 import { createDevSyncCommand } from './src/commands/devSync.js';
 import { createFilesCommand } from './src/commands/files.js';
 import { createFoldersCommand } from './src/commands/folders.js';
+import { createSearchCommand } from './src/commands/search.js';
+import { createInstancesCommand } from './src/commands/instances.js';
+import { createCanvasesCommand } from './src/commands/canvases.js';
+import { createSharedLinksCommand } from './src/commands/sharedLinks.js';
+import { createTagsCommand } from './src/commands/tags.js';
+import { createOrgCommand } from './src/commands/org.js';
+import { createAnalyticsCommand } from './src/commands/analytics.js';
+import { createAnnouncementsCommand } from './src/commands/announcements.js';
+import { createDsrLandingCommand } from './src/commands/dsrLanding.js';
+import { createEmailTemplateCommand } from './src/commands/emailTemplate.js';
+import { createThemesCommand } from './src/commands/themes.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
@@ -21,4 +32,15 @@ program.addCommand(createPublishAppCommand());
 program.addCommand(createDevSyncCommand());
 program.addCommand(createFilesCommand());
 program.addCommand(createFoldersCommand());
+program.addCommand(createSearchCommand());
+program.addCommand(createInstancesCommand());
+program.addCommand(createCanvasesCommand());
+program.addCommand(createSharedLinksCommand());
+program.addCommand(createTagsCommand());
+program.addCommand(createAnnouncementsCommand());
+program.addCommand(createDsrLandingCommand());
+program.addCommand(createEmailTemplateCommand());
+program.addCommand(createThemesCommand());
+program.addCommand(createOrgCommand());
+program.addCommand(createAnalyticsCommand());
 program.parseAsync(process.argv);

package/dist/src/commands/analytics.d.ts

@@ -0,0 +1,12 @@
+import { Command } from 'commander';
+import type { AxiosInstance } from 'axios';
+import { type CommonOpts } from '../core/http.js';
+import { type Envelope } from '../core/envelope.js';
+export interface AnalyticsDeps {
+    client?: AxiosInstance;
+}
+export declare function runAnalyticsOrg(opts: CommonOpts, deps?: AnalyticsDeps): Promise<Envelope<unknown>>;
+export declare function runAnalyticsInstance(opts: CommonOpts & {
+    instanceId?: string;
+}, deps?: AnalyticsDeps): Promise<Envelope<unknown>>;
+export declare function createAnalyticsCommand(): Command;

package/dist/src/commands/analytics.js

@@ -0,0 +1,45 @@
+import { Command } from 'commander';
+import { clientFor, toCliError } from '../core/http.js';
+import { ok, fail } from '../core/envelope.js';
+import { createCliError } from '../core/errors.js';
+import { emitEnvelope } from '../core/output.js';
+import { withAuthFlags } from './withAuth.js';
+export async function runAnalyticsOrg(opts, deps = {}) {
+    try {
+        const client = clientFor(opts, deps);
+        const res = await client.get('/api/v1/organization/analytics/');
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runAnalyticsInstance(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for analytics instance');
+        const client = clientFor(opts, deps);
+        const res = await client.get(`/api/v1/instances/${encodeURIComponent(opts.instanceId)}/analytics/`);
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export function createAnalyticsCommand() {
+    const cmd = new Command('analytics').description('read rollup analytics totals (requires an org-admin API key)');
+    withAuthFlags(cmd.command('org'))
+        .description('organization rollups (org-admin key required)')
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runAnalyticsOrg({ ...options, quiet: globals.quiet }), globals);
+    });
+    withAuthFlags(cmd.command('instance'))
+        .requiredOption('--instance-id <id>', 'Instance ID')
+        .description('instance rollups (instance-admin or org-admin key required)')
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runAnalyticsInstance({ ...options, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

package/dist/src/commands/announcements.d.ts

@@ -0,0 +1,23 @@
+import type { AxiosInstance } from 'axios';
+import { Command } from 'commander';
+import { type Envelope } from '../core/envelope.js';
+import { type CommonOpts } from '../core/http.js';
+export interface AnnouncementsDeps {
+    client?: AxiosInstance;
+}
+export declare function runAnnouncementsCreate(opts: CommonOpts & {
+    instanceId?: string;
+    fromFile?: string;
+    title?: string;
+    body?: string;
+    priority?: string;
+}, deps?: AnnouncementsDeps): Promise<Envelope<unknown>>;
+export declare function runAnnouncementsList(opts: CommonOpts & {
+    instanceId?: string;
+    limit?: number;
+    offset?: number;
+}, deps?: AnnouncementsDeps): Promise<Envelope<unknown>>;
+export declare function runAnnouncementsScaffold(opts: CommonOpts & {
+    out?: string;
+}, _deps?: AnnouncementsDeps): Promise<Envelope<unknown>>;
+export declare function createAnnouncementsCommand(): Command;

package/dist/src/commands/announcements.js

@@ -0,0 +1,131 @@
+import { Command } from 'commander';
+import { ok, fail } from '../core/envelope.js';
+import { createCliError } from '../core/errors.js';
+import { clientFor, toCliError } from '../core/http.js';
+import { emitEnvelope } from '../core/output.js';
+import { readJsonFile } from '../core/readInput.js';
+import { listLimitOffsetParams } from '../core/pagination.js';
+import { assertIntFlags, isPlainObject } from '../schema/content.js';
+import { ANNOUNCEMENT_SCAFFOLD_JSON, emitScaffold } from './scaffolds.js';
+import { withAuthFlags } from './withAuth.js';
+import { withInstanceFlag } from './withInstance.js';
+const APPSDB_ENDPOINT = '/core/api/protected/appsdb';
+const ANNOUNCEMENT_TYPE = 'wa-announcement';
+const FIELD_HELP = `
+data fields (wa-announcements app; all optional except title/body):
+  title              string, required           announcement headline
+  body               string (HTML), required    announcement body
+  media_type         'none' | 'image' | 'video'  media attachment kind
+  media_url          string                      URL of the attached media
+  link_type          'url' | 'file'              call-to-action link kind
+  link_url           string                      target URL when link_type='url'
+  link_label         string                      call-to-action button text
+  link_file_id       string                      target file id when link_type='file'
+  link_target_name   string                      display name for the linked target
+  priority           'normal' | 'important'      visual emphasis
+  author_name        string                      displayed author
+  published_at       string                      display-only publish label
+  start_at           string                      when the announcement becomes visible
+  expires_at         string                      when the announcement stops being visible
+  target_groups      string[]                    content-distribution group scoping
+  display_mode       ('inline' | 'popup')[]      where the announcement renders
+  popup_title        string | null               popup-only title override
+  popup_body         string | null               popup-only body override
+  popup_link_label   string | null               popup-only link label override
+
+Naive local dates: start_at/expires_at are 'YYYY-MM-DD' or 'YYYY-MM-DDTHH:mm'
+compared as LOCAL wall-clock time by the app, not ISO/UTC. '' means "none".
+Do not convert these to ISO/UTC — that would shift the displayed time.
+
+Run "p announcements scaffold" for a fully populated example.`;
+export async function runAnnouncementsCreate(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for announcements create');
+        if (!opts.fromFile && !(opts.title && opts.body)) {
+            throw createCliError('VALIDATION', 'announcements create requires either --from-file or both --title and --body');
+        }
+        let data = {};
+        if (opts.fromFile) {
+            // readJsonFile throws VALIDATION on a missing/unreadable/malformed file, before any request is made.
+            const fromFileData = readJsonFile(opts.fromFile);
+            if (!isPlainObject(fromFileData)) {
+                throw createCliError('VALIDATION', '--from-file must contain a JSON object (not an array or primitive)');
+            }
+            data = { ...fromFileData };
+        }
+        // Convenience flags override matching keys from --from-file when set.
+        if (opts.title !== undefined)
+            data.title = opts.title;
+        if (opts.body !== undefined)
+            data.body = opts.body;
+        if (opts.priority !== undefined)
+            data.priority = opts.priority;
+        // Re-check after the merge: a --from-file missing (or mistyping) title/body
+        // — e.g. `{}`, `{ "body": "x" }`, or `{ "title": 123 }` — must not slip
+        // through just because --from-file was present. Require non-empty strings,
+        // not just truthy values. No request may be sent when this fails.
+        const isNonEmptyString = (v) => typeof v === 'string' && v.trim().length > 0;
+        if (!isNonEmptyString(data.title) || !isNonEmptyString(data.body)) {
+            throw createCliError('VALIDATION', 'announcement requires non-empty string title and body (via --from-file or --title/--body)');
+        }
+        const client = clientFor(opts, deps);
+        // Deliberately omit `user_id`/`no_user_id`: omitting user_id yields the
+        // desired instance-shared row (see design §4.3); there is no --owned flag.
+        const res = await client.post(APPSDB_ENDPOINT, { type: ANNOUNCEMENT_TYPE, instance_id: opts.instanceId, data }, { params: { instance_id: opts.instanceId }, headers: { 'x-instance-id': opts.instanceId } });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runAnnouncementsList(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for announcements list');
+        assertIntFlags(opts);
+        const client = clientFor(opts, deps);
+        const params = {
+            type: ANNOUNCEMENT_TYPE,
+            instance_id: opts.instanceId,
+            ...listLimitOffsetParams(opts),
+        };
+        const res = await client.get(APPSDB_ENDPOINT, { params, headers: { 'x-instance-id': opts.instanceId } });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runAnnouncementsScaffold(opts, _deps = {}) {
+    return emitScaffold(ANNOUNCEMENT_SCAFFOLD_JSON, opts.out);
+}
+export function createAnnouncementsCommand() {
+    const cmd = new Command('announcements').description('create/list announcement records for the wa-announcements app');
+    withInstanceFlag(withAuthFlags(cmd.command('create')))
+        .option('--from-file <path>', 'Path to a JSON file with the announcement data object')
+        .option('--title <text>', 'Announcement title (overrides a matching --from-file key)')
+        .option('--body <html>', 'Announcement body HTML (overrides a matching --from-file key)')
+        .option('--priority <priority>', "Priority, e.g. 'normal' or 'important' (overrides a matching --from-file key)")
+        .addHelpText('after', FIELD_HELP)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runAnnouncementsCreate({ ...options, quiet: globals.quiet }), globals);
+    });
+    withInstanceFlag(withAuthFlags(cmd.command('list')))
+        .option('--limit <n>', 'Limit', (v) => parseInt(v, 10))
+        .option('--offset <n>', 'Offset', (v) => parseInt(v, 10))
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runAnnouncementsList({ ...options, quiet: globals.quiet }), globals);
+    });
+    withAuthFlags(cmd.command('scaffold'))
+        .description('generate a fully populated starter announcement data.json')
+        .option('--out <path>', 'Write the scaffold JSON to a file instead of returning it inline')
+        .addHelpText('after', FIELD_HELP)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runAnnouncementsScaffold({ ...options, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

package/dist/src/commands/canvases.d.ts

@@ -0,0 +1,25 @@
+import { Command } from 'commander';
+import type { AxiosInstance } from 'axios';
+import { type CommonOpts } from '../core/http.js';
+import { type Envelope } from '../core/envelope.js';
+export interface CanvasesDeps {
+    client?: AxiosInstance;
+}
+export declare function runCanvasesList(opts: CommonOpts & {
+    instanceId?: string;
+    isTemplate?: boolean;
+    isSection?: boolean;
+    isBlock?: boolean;
+    tags?: string;
+    idIn?: string;
+    accessType?: string;
+    page?: number;
+    pageSize?: number;
+}, deps?: CanvasesDeps): Promise<Envelope<{
+    results: unknown[];
+    pagination: Record<string, unknown>;
+}>>;
+export declare function runCanvasesGet(opts: CommonOpts & {
+    id?: string;
+}, deps?: CanvasesDeps): Promise<Envelope<unknown>>;
+export declare function createCanvasesCommand(): Command;

package/dist/src/commands/canvases.js

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+import { clientFor, toCliError } from '../core/http.js';
+import { ok, fail } from '../core/envelope.js';
+import { createCliError } from '../core/errors.js';
+import { emitEnvelope } from '../core/output.js';
+import { listPageParams, listPaginationEcho } from '../core/pagination.js';
+import { validateAccessType, assertIntFlags } from '../schema/content.js';
+import { withAuthFlags } from './withAuth.js';
+export async function runCanvasesList(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for canvases list');
+        assertIntFlags(opts);
+        const client = clientFor(opts, deps);
+        const params = { instance_id: opts.instanceId, ...listPageParams(opts) };
+        // Send each type flag ONLY when set. The server FilterSet does
+        // setdefault("is_block", False), so blocks are hidden unless --is-block.
+        if (opts.isTemplate)
+            params.is_template = true;
+        if (opts.isSection)
+            params.is_section = true;
+        if (opts.isBlock)
+            params.is_block = true;
+        if (opts.tags)
+            params.tags__in = opts.tags;
+        if (opts.idIn)
+            params.id__in = opts.idIn;
+        const accessType = validateAccessType(opts.accessType);
+        if (accessType)
+            params.access_type = accessType;
+        const res = await client.get('/api/v1/canvases/', { params });
+        return ok({ results: res.data.results, pagination: listPaginationEcho(opts, res.data) });
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runCanvasesGet(opts, deps = {}) {
+    try {
+        if (!opts.id)
+            throw createCliError('VALIDATION', 'canvas id is required');
+        const client = clientFor(opts, deps);
+        const res = await client.get(`/api/v1/canvases/${encodeURIComponent(opts.id)}`);
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export function createCanvasesCommand() {
+    const cmd = new Command('canvases').description('read Pitcher canvases (presentations, sections, blocks)');
+    withAuthFlags(cmd.command('list'))
+        .requiredOption('--instance-id <id>', 'Instance ID')
+        .option('--is-template', 'Only templates')
+        .option('--is-section', 'Only sections')
+        .option('--is-block', 'Only blocks (blocks are hidden unless this flag is set)')
+        .option('--tags <tags>', 'Comma-separated tags (filters via tags__in)')
+        .option('--id-in <ids>', 'Comma-separated canvas IDs')
+        .option('--access-type <type>', 'public | restricted | personal')
+        .option('--page <n>', 'Page number', (v) => parseInt(v, 10))
+        .option('--page-size <n>', 'Page size (max 500)', (v) => parseInt(v, 10))
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runCanvasesList({ ...options, quiet: globals.quiet }), globals);
+    });
+    withAuthFlags(cmd.command('get'))
+        .argument('<id>', 'Canvas ID')
+        .action(async (id, options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runCanvasesGet({ ...options, id, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

package/dist/src/commands/dsrLanding.d.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+import type { AxiosInstance } from 'axios';
+import { type CommonOpts } from '../core/http.js';
+import { type Envelope } from '../core/envelope.js';
+export interface DsrLandingDeps {
+    client?: AxiosInstance;
+}
+export declare function runDsrLandingCreate(opts: CommonOpts & {
+    instanceId?: string;
+    name?: string;
+    htmlFile?: string;
+    cssFile?: string;
+    mergeSchema?: string;
+    thumbnailUrl?: string;
+    language?: string;
+    default?: boolean;
+}, deps?: DsrLandingDeps): Promise<Envelope<unknown>>;
+export declare function runDsrLandingSetDefault(opts: CommonOpts & {
+    instanceId?: string;
+    id?: string;
+}, deps?: DsrLandingDeps): Promise<Envelope<unknown>>;
+export declare function runDsrLandingList(opts: CommonOpts & {
+    instanceId?: string;
+}, deps?: DsrLandingDeps): Promise<Envelope<unknown>>;
+export declare function runDsrLandingScaffold(opts: CommonOpts & {
+    out?: string;
+}, _deps?: DsrLandingDeps): Promise<Envelope<unknown>>;
+export declare function createDsrLandingCommand(): Command;