@pitcher/cli-scripts 2.3.0 → 2.5.0

package/dist/src/commands/dsrLanding.js

@@ -0,0 +1,150 @@
+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 { readTextFile } from '../core/readInput.js';
+import { parseJsonArray } from '../schema/content.js';
+import { withAuthFlags } from './withAuth.js';
+import { withInstanceFlag } from './withInstance.js';
+import { DSR_SCAFFOLD_HTML, emitScaffold } from './scaffolds.js';
+const DSR_ENDPOINT = '/core/api/protected/dsr-landing-templates';
+const REQUIRED_MARKER = 'data-pitcher-email-gate';
+const TOKEN_HELP = `
+Required marker (the platform injects the email-gate form here at render time):
+  data-pitcher-email-gate    must be present verbatim in --html-file, or create fails client-side
+
+Editable regions (optional, edited in the DSR landing editor without touching markup):
+  data-field-id="..."            unique id for the editable block
+  data-field-editable="true"     marks the block as editable
+  data-field-char-limit="N"      max character length enforced by the editor
+
+Tokens (resolved by the platform at render time; unknown tokens render blank):
+  {{recipient.firstName}}, {{recipient.lastName}}, {{recipient.email}}   recipient fields
+  {{customer.name}}                                                     recipient's company
+  {{organization.name}}                                                 sharing org's display name
+  {{rep.name}}                                                          sharing rep's display name
+  {{sharedLink.valid_until}}                                            share expiry, if set
+
+Run "p dsr-landing scaffold" for a full working example.`;
+export async function runDsrLandingCreate(opts, deps = {}) {
+    try {
+        if (!opts.name)
+            throw createCliError('VALIDATION', '--name is required for dsr-landing create');
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for dsr-landing create');
+        if (!opts.htmlFile)
+            throw createCliError('VALIDATION', '--html-file is required for dsr-landing create');
+        // readTextFile throws VALIDATION on a missing/unreadable file, before any request is made.
+        const html = readTextFile(opts.htmlFile);
+        if (!html.includes(REQUIRED_MARKER)) {
+            throw createCliError('VALIDATION', `landing HTML must contain the ${REQUIRED_MARKER} marker`);
+        }
+        if (opts.language && opts.language.length > 10) {
+            throw createCliError('VALIDATION', '--language must be at most 10 characters');
+        }
+        const body = { instance_id: opts.instanceId, name: opts.name, html };
+        if (opts.cssFile)
+            body.css = readTextFile(opts.cssFile);
+        if (opts.mergeSchema)
+            body.merge_schema = parseJsonArray(opts.mergeSchema, 'merge-schema');
+        if (opts.thumbnailUrl)
+            body.thumbnail_url = opts.thumbnailUrl;
+        if (opts.language)
+            body.language = opts.language;
+        const client = clientFor(opts, deps);
+        const res = await client.post(DSR_ENDPOINT, body, { params: { instance_id: opts.instanceId } });
+        const created = res.data;
+        if (opts.default) {
+            // The template was created, but --default asked for a compound operation:
+            // if set-default can't complete, the instance default is NOT this template.
+            // Report that as a failure (non-ok, non-zero exit) so an agent keying on the
+            // envelope doesn't believe the default changed. The created id is surfaced in
+            // the message so the caller can retry `set-default` without re-creating.
+            const id = created?.id;
+            if (!id) {
+                return fail(createCliError('UNKNOWN', 'template created, but --default could not be applied: server response had no id'));
+            }
+            try {
+                await client.post(`${DSR_ENDPOINT}/${encodeURIComponent(id)}/set-default`, undefined, {
+                    params: { instance_id: opts.instanceId },
+                });
+            }
+            catch (e) {
+                const err = toCliError(e);
+                return fail(createCliError(err.code, `template created (id ${id}), but set-default failed: ${err.message}. ` +
+                    `Retry with: p dsr-landing set-default --instance-id ${opts.instanceId} --id ${id}`));
+            }
+        }
+        return ok(created);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runDsrLandingSetDefault(opts, deps = {}) {
+    try {
+        if (!opts.id)
+            throw createCliError('VALIDATION', '--id is required for dsr-landing set-default');
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for dsr-landing set-default');
+        const client = clientFor(opts, deps);
+        const res = await client.post(`${DSR_ENDPOINT}/${encodeURIComponent(opts.id)}/set-default`, undefined, {
+            params: { instance_id: opts.instanceId },
+        });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runDsrLandingList(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for dsr-landing list');
+        const client = clientFor(opts, deps);
+        const res = await client.get(DSR_ENDPOINT, { params: { instance_id: opts.instanceId } });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runDsrLandingScaffold(opts, _deps = {}) {
+    return emitScaffold(DSR_SCAFFOLD_HTML, opts.out);
+}
+export function createDsrLandingCommand() {
+    const cmd = new Command('dsr-landing').description('create/list DSR (Digital Sales Room) landing-page templates, and set one as default');
+    withInstanceFlag(withAuthFlags(cmd.command('create')))
+        .requiredOption('--name <name>', 'Template name')
+        .requiredOption('--html-file <path>', `Path to the landing HTML (must contain ${REQUIRED_MARKER})`)
+        .option('--css-file <path>', 'Path to a CSS file for the template')
+        .option('--merge-schema <json>', 'Merge schema array as inline JSON')
+        .option('--language <lang>', 'Language code (max 10 chars)')
+        .option('--thumbnail-url <url>', 'Thumbnail image URL')
+        .option('--default', 'Also set this template as the instance-scope default after creating it')
+        .addHelpText('after', TOKEN_HELP)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runDsrLandingCreate({ ...options, quiet: globals.quiet }), globals);
+    });
+    withInstanceFlag(withAuthFlags(cmd.command('set-default')))
+        .requiredOption('--id <id>', 'Template ID')
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runDsrLandingSetDefault({ ...options, quiet: globals.quiet }), globals);
+    });
+    withInstanceFlag(withAuthFlags(cmd.command('list'))).action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runDsrLandingList({ ...options, quiet: globals.quiet }), globals);
+    });
+    withAuthFlags(cmd.command('scaffold'))
+        .description('generate a starter DSR landing page HTML with the required marker and tokens in context')
+        .option('--out <path>', 'Write the scaffold HTML to a file instead of returning it inline')
+        .addHelpText('after', TOKEN_HELP)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runDsrLandingScaffold({ ...options, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

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

@@ -0,0 +1,32 @@
+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 EmailTemplateDeps {
+    client?: AxiosInstance;
+}
+export declare function runEmailTemplateCreate(opts: CommonOpts & {
+    instanceId?: string;
+    name?: string;
+    bodyFile?: string;
+    subject?: string;
+    tags?: string;
+    metadata?: string;
+}, deps?: EmailTemplateDeps): Promise<Envelope<unknown>>;
+export declare function runEmailTemplateList(opts: CommonOpts & {
+    instanceId?: string;
+    name?: string;
+    status?: string;
+    category?: string;
+    target?: string;
+    limit?: number;
+    offset?: number;
+}, deps?: EmailTemplateDeps): Promise<Envelope<unknown>>;
+export declare function runEmailTemplateGet(opts: CommonOpts & {
+    instanceId?: string;
+    id?: string;
+}, deps?: EmailTemplateDeps): Promise<Envelope<unknown>>;
+export declare function runEmailTemplateScaffold(opts: CommonOpts & {
+    out?: string;
+}, _deps?: EmailTemplateDeps): Promise<Envelope<unknown>>;
+export declare function createEmailTemplateCommand(): Command;

package/dist/src/commands/emailTemplate.js

@@ -0,0 +1,124 @@
+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 { readTextFile } from '../core/readInput.js';
+import { listLimitOffsetParams } from '../core/pagination.js';
+import { assertIntFlags, parseJsonObject } from '../schema/content.js';
+import { withAuthFlags } from './withAuth.js';
+import { withInstanceFlag } from './withInstance.js';
+import { EMAIL_SCAFFOLD_HTML, emitScaffold } from './scaffolds.js';
+const TEMPLATES_ENDPOINT = '/core/api/protected/emails/templates';
+const TOKEN_HELP = `
+Tokens (resolved by the emails app at send time; unknown tokens render blank):
+  {{recipient.firstName}}   recipient's first name
+  {{recipient.lastName}}    recipient's last name
+  {{recipient.email}}       recipient's email address
+
+Run "p email-template scaffold" for a full working example.`;
+export async function runEmailTemplateCreate(opts, deps = {}) {
+    try {
+        if (!opts.name)
+            throw createCliError('VALIDATION', '--name is required for email-template create');
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for email-template create');
+        const body = { name: opts.name };
+        if (opts.subject)
+            body.subject = opts.subject;
+        // readTextFile throws VALIDATION on a missing/unreadable file, before any request is made.
+        if (opts.bodyFile)
+            body.body = readTextFile(opts.bodyFile);
+        if (opts.tags)
+            body.tags = parseJsonObject(opts.tags, 'tags');
+        if (opts.metadata)
+            body.metadata = parseJsonObject(opts.metadata, 'metadata');
+        const client = clientFor(opts, deps);
+        const res = await client.post(TEMPLATES_ENDPOINT, body, { headers: { 'x-instance-id': opts.instanceId } });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runEmailTemplateList(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for email-template list');
+        assertIntFlags(opts);
+        const client = clientFor(opts, deps);
+        const params = { ...listLimitOffsetParams(opts) };
+        if (opts.name)
+            params.name = opts.name;
+        if (opts.status)
+            params.status = opts.status;
+        if (opts.category)
+            params.category = opts.category;
+        if (opts.target)
+            params.target = opts.target;
+        const res = await client.get(TEMPLATES_ENDPOINT, { params, headers: { 'x-instance-id': opts.instanceId } });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runEmailTemplateGet(opts, deps = {}) {
+    try {
+        if (!opts.instanceId)
+            throw createCliError('VALIDATION', '--instance-id is required for email-template get');
+        if (!opts.id)
+            throw createCliError('VALIDATION', '--id is required for email-template get');
+        const client = clientFor(opts, deps);
+        const res = await client.get(`${TEMPLATES_ENDPOINT}/${encodeURIComponent(opts.id)}`, {
+            headers: { 'x-instance-id': opts.instanceId },
+        });
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runEmailTemplateScaffold(opts, _deps = {}) {
+    return emitScaffold(EMAIL_SCAFFOLD_HTML, opts.out);
+}
+export function createEmailTemplateCommand() {
+    const cmd = new Command('email-template').description('create/list/get HTML email templates for the emails app');
+    withInstanceFlag(withAuthFlags(cmd.command('create')))
+        .requiredOption('--name <name>', 'Template name')
+        .option('--body-file <path>', 'Path to an HTML file (inline CSS) used as the template body')
+        .option('--subject <text>', 'Email subject (supports {{tokens}})')
+        .option('--tags <json>', 'Tags object as inline JSON')
+        .option('--metadata <json>', 'Metadata object as inline JSON')
+        .addHelpText('after', TOKEN_HELP)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runEmailTemplateCreate({ ...options, quiet: globals.quiet }), globals);
+    });
+    withInstanceFlag(withAuthFlags(cmd.command('list')))
+        .option('--name <name>', 'Case-insensitive substring filter, matched against name OR subject (not exact match)')
+        .option('--status <status>', 'Status filter')
+        .option('--category <category>', 'Category filter')
+        .option('--target <target>', 'Target filter')
+        .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 runEmailTemplateList({ ...options, quiet: globals.quiet }), globals);
+    });
+    withInstanceFlag(withAuthFlags(cmd.command('get')))
+        .requiredOption('--id <id>', 'Template ID')
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runEmailTemplateGet({ ...options, quiet: globals.quiet }), globals);
+    });
+    withAuthFlags(cmd.command('scaffold'))
+        .description('generate a starter HTML email template with tokens in context')
+        .option('--out <path>', 'Write the scaffold HTML to a file instead of returning it inline')
+        .addHelpText('after', TOKEN_HELP)
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runEmailTemplateScaffold({ ...options, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

package/dist/src/commands/files.js

@@ -6,6 +6,7 @@ import { emitEnvelope } from '../core/output.js';
 import { uploadFile } from '../core/upload.js';
 import { listPageParams, listPaginationEcho } from '../core/pagination.js';
 import { parseTags, parseJsonObject, validateAccessType, deepMerge, assertIntFlags } from '../schema/content.js';
+import { withAuthFlags } from './withAuth.js';
 export async function runFilesList(
 // NOTE: no folderId — the Django files list has no folder filter (listing a
 // folder's files is a folders-retrieve concern). tags filters via `tags__in`.
@@ -117,11 +118,7 @@ export async function runFilesUpdate(opts, deps = {}) {
 }
 export function createFilesCommand() {
     const cmd = new Command('files').description('manage Pitcher content files');
-    const withAuth = (c) => c
-        .option('--api-key <apiKey>', 'API Key for authentication')
-        .option('--org <organization>', 'Organization subdomain', 'dev')
-        .option('--url <url>', 'Explicit base URL override');
-    withAuth(cmd.command('list'))
+    withAuthFlags(cmd.command('list'))
         .requiredOption('--instance-id <id>', 'Instance ID')
         .option('--id-in <ids>', 'Comma-separated file IDs')
         .option('--tags <tags>', 'Comma-separated tags (filters via tags__in)')
@@ -131,13 +128,13 @@ export function createFilesCommand() {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runFilesList({ ...options, quiet: globals.quiet }), globals);
     });
-    withAuth(cmd.command('get'))
+    withAuthFlags(cmd.command('get'))
         .argument('<id>', 'File ID')
         .action(async (id, options, command) => {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runFilesGet({ ...options, id, quiet: globals.quiet }), globals);
     });
-    withAuth(cmd.command('create'))
+    withAuthFlags(cmd.command('create'))
         .requiredOption('--instance-id <id>', 'Instance ID')
         .option('--name <name>', 'File name')
         .option('--folder-id <id>', 'Destination folder')
@@ -151,7 +148,7 @@ export function createFilesCommand() {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runFilesCreate({ ...options, filePath: options.file, quiet: globals.quiet }), globals);
     });
-    withAuth(cmd.command('update'))
+    withAuthFlags(cmd.command('update'))
         .argument('<id>', 'File ID')
         .option('--instance-id <id>', 'Instance ID (required only with --file)')
         .option('--name <name>', 'File name')

package/dist/src/commands/folders.js

@@ -5,6 +5,7 @@ import { createCliError } from '../core/errors.js';
 import { emitEnvelope } from '../core/output.js';
 import { listPageParams, listPaginationEcho } from '../core/pagination.js';
 import { parseJsonArray, validateAccessType, assertIntFlags } from '../schema/content.js';
+import { withAuthFlags } from './withAuth.js';
 export async function runFoldersList(opts, deps = {}) {
     try {
         if (!opts.instanceId)
@@ -81,11 +82,7 @@ export async function runFoldersUpdate(opts, deps = {}) {
 }
 export function createFoldersCommand() {
     const cmd = new Command('folders').description('manage Pitcher content folders');
-    const withAuth = (c) => c
-        .option('--api-key <apiKey>', 'API Key for authentication')
-        .option('--org <organization>', 'Organization subdomain', 'dev')
-        .option('--url <url>', 'Explicit base URL override');
-    withAuth(cmd.command('list'))
+    withAuthFlags(cmd.command('list'))
         .requiredOption('--instance-id <id>', 'Instance ID')
         .option('--page <n>', 'Page number', (v) => parseInt(v, 10))
         .option('--page-size <n>', 'Page size (max 500)', (v) => parseInt(v, 10))
@@ -93,7 +90,7 @@ export function createFoldersCommand() {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runFoldersList({ ...options, quiet: globals.quiet }), globals);
     });
-    withAuth(cmd.command('get'))
+    withAuthFlags(cmd.command('get'))
         .argument('[id]', 'Folder ID (omit and use --root for the instance root)')
         .option('--root', 'Fetch the instance root folder')
         .option('--instance-id <id>', 'Instance ID (required with --root)')
@@ -101,7 +98,7 @@ export function createFoldersCommand() {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runFoldersGet({ ...options, id, quiet: globals.quiet }), globals);
     });
-    withAuth(cmd.command('create'))
+    withAuthFlags(cmd.command('create'))
         .requiredOption('--name <name>', 'Folder name')
         .requiredOption('--parent-folder-id <id>', 'Parent folder ID')
         .option('--access-type <type>', 'public | restricted | personal')
@@ -110,7 +107,7 @@ export function createFoldersCommand() {
         const globals = command.optsWithGlobals();
         emitEnvelope(await runFoldersCreate({ ...options, quiet: globals.quiet }), globals);
     });
-    withAuth(cmd.command('update'))
+    withAuthFlags(cmd.command('update'))
         .argument('<id>', 'Folder ID')
         .option('--name <name>', 'Folder name')
         .option('--access-type <type>', 'public | restricted | personal')

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

@@ -0,0 +1,21 @@
+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 InstancesDeps {
+    client?: AxiosInstance;
+}
+export declare function runInstancesList(opts: CommonOpts & {
+    region?: string;
+    storageRegion?: string;
+    environment?: string;
+    page?: number;
+    pageSize?: number;
+}, deps?: InstancesDeps): Promise<Envelope<{
+    results: unknown[];
+    pagination: Record<string, unknown>;
+}>>;
+export declare function runInstancesInfo(opts: CommonOpts & {
+    id?: string;
+}, deps?: InstancesDeps): Promise<Envelope<unknown>>;
+export declare function createInstancesCommand(): Command;

package/dist/src/commands/instances.js

@@ -0,0 +1,58 @@
+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 { assertIntFlags } from '../schema/content.js';
+import { withAuthFlags } from './withAuth.js';
+export async function runInstancesList(opts, deps = {}) {
+    try {
+        assertIntFlags(opts);
+        const client = clientFor(opts, deps);
+        const params = { ...listPageParams(opts) };
+        if (opts.region)
+            params.region = opts.region;
+        if (opts.storageRegion)
+            params.storage_region = opts.storageRegion;
+        if (opts.environment)
+            params.environment = opts.environment;
+        const res = await client.get('/api/v1/instances/', { params });
+        return ok({ results: res.data.results, pagination: listPaginationEcho(opts, res.data) });
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export async function runInstancesInfo(opts, deps = {}) {
+    try {
+        if (!opts.id)
+            throw createCliError('VALIDATION', 'instance id is required');
+        const client = clientFor(opts, deps);
+        const res = await client.get(`/api/v1/instances/${encodeURIComponent(opts.id)}`);
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export function createInstancesCommand() {
+    const cmd = new Command('instances').description('discover Pitcher instances (resolve names to instance IDs)');
+    withAuthFlags(cmd.command('list'))
+        .option('--region <r>', 'Filter by region')
+        .option('--storage-region <r>', 'Filter by storage region')
+        .option('--environment <e>', 'Filter by environment')
+        .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 runInstancesList({ ...options, quiet: globals.quiet }), globals);
+    });
+    withAuthFlags(cmd.command('info'))
+        .argument('<id>', 'Instance ID')
+        .action(async (id, options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runInstancesInfo({ ...options, id, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

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

@@ -0,0 +1,9 @@
+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 OrgDeps {
+    client?: AxiosInstance;
+}
+export declare function runOrgGet(opts: CommonOpts, deps?: OrgDeps): Promise<Envelope<unknown>>;
+export declare function createOrgCommand(): Command;

package/dist/src/commands/org.js

@@ -0,0 +1,26 @@
+import { Command } from 'commander';
+import { clientFor, toCliError } from '../core/http.js';
+import { ok, fail } from '../core/envelope.js';
+import { emitEnvelope } from '../core/output.js';
+import { withAuthFlags } from './withAuth.js';
+export async function runOrgGet(opts, deps = {}) {
+    try {
+        const client = clientFor(opts, deps);
+        // Returns raw settings/metadata (no server allow-list) — may include
+        // integration credentials; treat JSON output as sensitive.
+        const res = await client.get('/api/v1/organization/');
+        return ok(res.data);
+    }
+    catch (e) {
+        return fail(toCliError(e));
+    }
+}
+export function createOrgCommand() {
+    const cmd = new Command('org').description('read the organization this API key belongs to');
+    withAuthFlags(cmd.command('get'))
+        .action(async (options, command) => {
+        const globals = command.optsWithGlobals();
+        emitEnvelope(await runOrgGet({ ...options, quiet: globals.quiet }), globals);
+    });
+    return cmd;
+}

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

@@ -0,0 +1,19 @@
+import { type Envelope } from '../core/envelope.js';
+export declare function emitScaffold(content: string, out?: string): Envelope<unknown>;
+/**
+ * Starter HTML email (inline CSS, table layout) for `p email-template scaffold`.
+ * Contains the common {{recipient.*}} tokens in context, each documented with
+ * an HTML comment. The emails app resolves tokens at send time; unknown
+ * tokens render blank (no server-side validation).
+ */
+export declare const EMAIL_SCAFFOLD_HTML = "<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <title>Sample Email Template</title>\n  </head>\n  <body style=\"margin:0;padding:0;background-color:#f4f4f4;font-family:Arial,Helvetica,sans-serif;\">\n    <table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" style=\"background-color:#f4f4f4;padding:24px 0;\">\n      <tr>\n        <td align=\"center\">\n          <table role=\"presentation\" width=\"600\" cellpadding=\"0\" cellspacing=\"0\" style=\"background-color:#ffffff;border-radius:8px;overflow:hidden;\">\n            <tr>\n              <td style=\"background-color:#29335C;padding:24px;text-align:center;\">\n                <span style=\"color:#ffffff;font-size:20px;font-weight:bold;\">Pitcher</span>\n              </td>\n            </tr>\n            <tr>\n              <td style=\"padding:32px 24px;color:#212121;font-size:15px;line-height:1.5;\">\n                <!-- token: recipient.firstName -> the recipient's first name -->\n                <!-- token: recipient.lastName -> the recipient's last name -->\n                <p style=\"margin:0 0 16px 0;\">Dear {{recipient.firstName}} {{recipient.lastName}},</p>\n                <p style=\"margin:0 0 16px 0;\">\n                  Thanks for your time today. As promised, here is the material we discussed.\n                  Reach out any time if you have questions.\n                </p>\n                <table role=\"presentation\" cellpadding=\"0\" cellspacing=\"0\" style=\"margin:24px 0;\">\n                  <tr>\n                    <td style=\"background-color:#29335C;border-radius:4px;\">\n                      <a href=\"https://example.com\" style=\"display:inline-block;padding:12px 24px;color:#ffffff;text-decoration:none;font-size:14px;font-weight:bold;\">\n                        View content\n                      </a>\n                    </td>\n                  </tr>\n                </table>\n                <!-- token: recipient.email -> the recipient's email address, e.g. for a footer mailto: link -->\n                <p style=\"margin:0;color:#757575;font-size:12px;\">\n                  Sent to {{recipient.email}}. If you'd rather not receive these, let your rep know.\n                </p>\n              </td>\n            </tr>\n          </table>\n        </td>\n      </tr>\n    </table>\n  </body>\n</html>\n";
+/**
+ * Starter DSR (Digital Sales Room) landing page HTML for `p dsr-landing scaffold`.
+ * Contains the required `data-pitcher-email-gate` marker, an editable-region
+ * example via `data-field-*` attributes, a themeable accent color via the
+ * `--p-primary` CSS variable, and the Handlebars tokens the platform resolves
+ * at render time, each documented with an HTML comment. No `<script>` or
+ * external `<link>` tags — the server strips both via DOMPurify.
+ */
+export declare const DSR_SCAFFOLD_HTML = "<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <title>Sample DSR Landing Page</title>\n  </head>\n  <body style=\"margin:0;padding:0;background-color:#f4f4f4;font-family:Arial,Helvetica,sans-serif;color:#212121;\">\n    <table role=\"presentation\" width=\"100%\" cellpadding=\"0\" cellspacing=\"0\" style=\"padding:32px 0;\">\n      <tr>\n        <td align=\"center\">\n          <table role=\"presentation\" width=\"640\" cellpadding=\"0\" cellspacing=\"0\" style=\"background-color:#ffffff;border-radius:8px;overflow:hidden;\">\n            <tr>\n              <td style=\"background-color:var(--p-primary, #29335C);padding:28px;text-align:center;\">\n                <!-- token: organization.name -> the sharing org's display name -->\n                <span style=\"color:#ffffff;font-size:20px;font-weight:bold;\">{{organization.name}}</span>\n              </td>\n            </tr>\n            <tr>\n              <td style=\"padding:32px;\">\n                <!-- token: recipient.firstName -> the recipient's first name -->\n                <!-- token: customer.name -> the recipient's company name -->\n                <h1 style=\"margin:0 0 8px 0;font-size:22px;\">Welcome, {{recipient.firstName}}</h1>\n                <p style=\"margin:0 0 24px 0;color:#757575;font-size:14px;\">Prepared for {{customer.name}}</p>\n\n                <!--\n                  Editable region: admins can edit this block's text in the DSR\n                  landing editor without touching markup. data-field-char-limit\n                  enforces a max length in that editor.\n                -->\n                <div\n                  data-field-id=\"welcome-message\"\n                  data-field-editable=\"true\"\n                  data-field-char-limit=\"120\"\n                  style=\"padding:16px;margin:0 0 24px 0;border-left:3px solid var(--p-primary, #29335C);background-color:#f7f8fb;font-size:15px;line-height:1.5;\"\n                >\n                  Thanks for stopping by. Everything you need for this conversation is right here.\n                </div>\n\n                <!-- token: rep.name -> the sharing rep's display name -->\n                <p style=\"margin:0 0 24px 0;font-size:14px;color:#757575;\">Shared by {{rep.name}}</p>\n\n                <!--\n                  Required marker: the platform injects the email-gate form\n                  into this div at render time. It MUST be present verbatim\n                  (a literal data-pitcher-email-gate attribute) or the\n                  server rejects the template on create/update.\n                -->\n                <div data-pitcher-email-gate></div>\n              </td>\n            </tr>\n            <tr>\n              <td style=\"padding:16px 32px;border-top:1px solid #e0e2ed;text-align:center;color:#757575;font-size:12px;\">\n                <!-- token: sharedLink.valid_until -> when this share expires, if the share sets an expiry -->\n                This link is valid until {{sharedLink.valid_until}}.\n              </td>\n            </tr>\n          </table>\n        </td>\n      </tr>\n    </table>\n  </body>\n</html>\n";
+export declare const ANNOUNCEMENT_SCAFFOLD_JSON: string;