@signstack/cli 0.1.1

package/dist/apps/signstack-cli/src/lib/preview-output-formatter.d.ts

@@ -0,0 +1,63 @@
+import type { RenderBlueprintResp, TemplateFieldInfo } from '@signstack/base';
+import type { ExtendedValidationSummary as ValidationSummary } from './resource-validator.js';
+import type { EntityDataResult } from './entity-data-resolver.js';
+export interface BlueprintMeta {
+    ref?: string;
+    key?: string;
+    version?: string;
+    name?: string;
+    source: 'local' | 'signstack';
+}
+export interface TemplateMeta {
+    ref?: string;
+    key?: string;
+    version?: string;
+    name?: string;
+    type?: 'pdf' | 'html';
+    source: 'local' | 'signstack';
+}
+export interface TemplatePreviewResult {
+    signedUrl: string;
+    detectedFields?: TemplateFieldInfo[];
+}
+/**
+ * Handles formatting and printing of preview command output
+ */
+export declare class PreviewOutputFormatter {
+    private readonly log;
+    constructor(log: (message: string) => void);
+    /**
+     * Print validation errors
+     */
+    printValidationErrors(summary: ValidationSummary, jsonOutput: boolean): void;
+    /**
+     * Print preview results (works for both local and SignStack flows)
+     */
+    printPreviewResults(result: RenderBlueprintResp, jsonOutput: boolean, entityData: EntityDataResult, blueprint: BlueprintMeta): void;
+    /**
+     * Print template preview results
+     */
+    printTemplatePreviewResults(result: TemplatePreviewResult, jsonOutput: boolean, entityData: EntityDataResult, template: TemplateMeta): void;
+    /**
+     * Print scenarios list
+     */
+    printScenariosList(scenarios: {
+        key: string;
+        name: string;
+    }[], jsonOutput: boolean): void;
+    /**
+     * Print API warnings
+     */
+    printWarnings(warnings: {
+        resourceId: string;
+        message: string;
+    }[]): void;
+    /**
+     * Print validation success message
+     */
+    printValidationSuccess(count: number): void;
+    /**
+     * Print file check results
+     */
+    printFileCheckResults(reusedCount: number, uploadCount: number): void;
+}

package/dist/apps/signstack-cli/src/lib/preview-output-formatter.js

@@ -0,0 +1,198 @@
+import pc from 'picocolors';
+import Table from 'cli-table3';
+/**
+ * Handles formatting and printing of preview command output
+ */
+export class PreviewOutputFormatter {
+    log;
+    constructor(log) {
+        this.log = log;
+    }
+    /**
+     * Print validation errors
+     */
+    printValidationErrors(summary, jsonOutput) {
+        if (jsonOutput) {
+            this.log(JSON.stringify({
+                error: 'Validation failed',
+                failed: summary.failed,
+                hasCycles: summary.hasCycles,
+                errors: summary.results.filter((r) => !r.valid),
+            }, null, 2));
+            return;
+        }
+        this.log('');
+        this.log(pc.red('Validation Errors:'));
+        for (const result of summary.results.filter((r) => !r.valid)) {
+            const fileDisplay = result.resourceKey
+                ? `${result.filePath} [${result.resourceKey}@${result.resourceVersion}]`
+                : result.filePath;
+            this.log(`${pc.red('✗')} ${fileDisplay}`);
+            for (const error of result.errors) {
+                this.log(`    ${pc.red('•')} ${error.message}`);
+                if (error.path !== '/') {
+                    this.log(pc.dim(`      Path: ${error.path}`));
+                }
+            }
+        }
+        if (summary.hasCycles && summary.cycles?.length) {
+            this.log('');
+            this.log(pc.red('Circular dependencies detected:'));
+            for (const cycle of summary.cycles) {
+                const cycleStr = cycle.join(' → ');
+                this.log(pc.red(`  • ${cycleStr}`));
+            }
+        }
+        this.log('');
+    }
+    /**
+     * Print preview results (works for both local and SignStack flows)
+     */
+    printPreviewResults(result, jsonOutput, entityData, blueprint) {
+        if (jsonOutput) {
+            const output = {
+                blueprint: {
+                    ...(blueprint.ref ? { ref: blueprint.ref } : {}),
+                    ...(blueprint.key ? { key: blueprint.key } : {}),
+                    ...(blueprint.name ? { name: blueprint.name } : {}),
+                    ...(blueprint.version ? { version: blueprint.version } : {}),
+                    source: blueprint.source,
+                },
+                entityData: {
+                    source: entityData.isAutoGenerated
+                        ? 'generated'
+                        : entityData.entities.length > 0
+                            ? 'scenario'
+                            : 'none',
+                },
+                warnings: result.warnings,
+            };
+            output['envelopes'] = result.envelopes;
+            this.log(JSON.stringify(output, null, 2));
+            return;
+        }
+        this.log('');
+        this.log(pc.bold(pc.green('Preview Generated Successfully')));
+        if (blueprint.source === 'local') {
+            this.log(pc.dim('(from local files)'));
+        }
+        if (entityData.isAutoGenerated) {
+            this.log(pc.dim('(with generated sample data)'));
+        }
+        this.log('');
+        for (const envelope of result.envelopes) {
+            if (result.envelopes.length > 1) {
+                this.log(pc.bold(`Envelope: ${envelope.envelopeKey}`));
+            }
+            for (const doc of envelope.documents) {
+                this.log(pc.cyan(`📄 ${doc.name}`));
+                this.log(pc.dim('   Signed URL:'));
+                this.log(`   ${doc.signedUrl}`);
+                this.log('');
+            }
+        }
+        this.log(pc.yellow('⚠ Note: Signed URLs expire in 1 hour.'));
+    }
+    /**
+     * Print template preview results
+     */
+    printTemplatePreviewResults(result, jsonOutput, entityData, template) {
+        if (jsonOutput) {
+            this.log(JSON.stringify({
+                template: {
+                    ...(template.ref ? { ref: template.ref } : {}),
+                    ...(template.key ? { key: template.key } : {}),
+                    ...(template.name ? { name: template.name } : {}),
+                    ...(template.version ? { version: template.version } : {}),
+                    ...(template.type ? { type: template.type } : {}),
+                    source: template.source,
+                },
+                entityData: {
+                    source: entityData.isAutoGenerated
+                        ? 'generated'
+                        : entityData.entities.length > 0
+                            ? 'scenario'
+                            : 'none',
+                },
+                signedUrl: result.signedUrl,
+                detectedFields: result.detectedFields,
+            }, null, 2));
+            return;
+        }
+        this.log('');
+        this.log(pc.bold(pc.green('Template Preview Generated Successfully')));
+        if (template.name) {
+            this.log(pc.dim(`Template: ${template.name}${template.version ? ` (v${template.version})` : ''}${template.type ? ` [${template.type.toUpperCase()}]` : ''}`));
+        }
+        if (template.source === 'local') {
+            this.log(pc.dim('(from local files)'));
+        }
+        if (entityData.isAutoGenerated) {
+            this.log(pc.dim('(with generated sample data)'));
+        }
+        this.log('');
+        const name = template.name || template.key || 'Rendered Template';
+        this.log(pc.cyan(`📄 ${name}`));
+        this.log(pc.dim('   Signed URL:'));
+        this.log(`   ${result.signedUrl}`);
+        this.log('');
+        if (result.detectedFields?.length) {
+            this.log(pc.dim(`Detected ${result.detectedFields.length} field(s) in the rendered document.`));
+            this.log('');
+        }
+        this.log(pc.yellow('⚠ Note: Signed URLs expire in 1 hour.'));
+    }
+    /**
+     * Print scenarios list
+     */
+    printScenariosList(scenarios, jsonOutput) {
+        if (jsonOutput) {
+            this.log(JSON.stringify(scenarios, null, 2));
+            return;
+        }
+        if (scenarios.length === 0) {
+            this.log(pc.yellow('No scenarios found.'));
+            this.log(pc.dim('Create a scenario in the SignStack web app to use with preview.'));
+            return;
+        }
+        this.log('');
+        this.log(pc.bold('Available Scenarios'));
+        this.log('');
+        const table = new Table({
+            head: [pc.cyan('Key'), pc.cyan('Display Name')],
+            colWidths: [40, 40],
+        });
+        for (const scenario of scenarios) {
+            table.push([scenario.key, scenario.name]);
+        }
+        this.log(table.toString());
+        this.log('');
+        this.log(pc.dim('Use: signstack preview --blueprint <key> --scenario <scenario-key>'));
+        this.log(pc.dim('Note: Scenario is optional. Without it, sample data is generated dynamically using AI.'));
+    }
+    /**
+     * Print API warnings
+     */
+    printWarnings(warnings) {
+        if (!warnings?.length)
+            return;
+        this.log('');
+        this.log(pc.yellow('Warnings:'));
+        for (const warning of warnings) {
+            this.log(pc.yellow(`  ⚠ ${warning.resourceId}: ${warning.message}`));
+        }
+    }
+    /**
+     * Print validation success message
+     */
+    printValidationSuccess(count) {
+        this.log(pc.green(`✓ Validated ${count} resource(s)`));
+    }
+    /**
+     * Print file check results
+     */
+    printFileCheckResults(reusedCount, uploadCount) {
+        this.log(pc.dim(`File check complete: ${reusedCount} reused, ${uploadCount} to upload`));
+    }
+}
+//# sourceMappingURL=preview-output-formatter.js.map

package/dist/apps/signstack-cli/src/lib/preview-output-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-output-formatter.js","sourceRoot":"","sources":["../../../../../src/lib/preview-output-formatter.ts"],"names":[],"mappings":"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"}

package/dist/apps/signstack-cli/src/lib/public-api-client.d.ts

@@ -0,0 +1,13 @@
+import type { HttpClient } from './resource-puller.js';
+/**
+ * Unauthenticated HTTP client for public library endpoints. Supports the
+ * `@OptionalAuth` routes on the backend (anonymous callers see `scope: public`
+ * listings only).
+ */
+export declare class PublicApiClient implements HttpClient {
+    private readonly apiUrl;
+    constructor(apiUrl?: string);
+    get<T>(path: string): Promise<T>;
+    post<T>(path: string, body: unknown): Promise<T>;
+    private _request;
+}

package/dist/apps/signstack-cli/src/lib/public-api-client.js

@@ -0,0 +1,39 @@
+import { getApiUrl } from './config.js';
+/**
+ * Unauthenticated HTTP client for public library endpoints. Supports the
+ * `@OptionalAuth` routes on the backend (anonymous callers see `scope: public`
+ * listings only).
+ */
+export class PublicApiClient {
+    apiUrl;
+    constructor(apiUrl) {
+        this.apiUrl = apiUrl ?? getApiUrl();
+    }
+    async get(path) {
+        return this._request('GET', path);
+    }
+    async post(path, body) {
+        return this._request('POST', path, body);
+    }
+    async _request(method, path, body) {
+        const url = `${this.apiUrl}${path}`;
+        const response = await fetch(url, {
+            method,
+            headers: { 'Content-Type': 'application/json' },
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+        if (!response.ok) {
+            let message = response.statusText || 'Request failed';
+            try {
+                const parsed = await response.json();
+                message = parsed.errorInfo?.message || message;
+            }
+            catch {
+                // ignore parse errors
+            }
+            throw new Error(`${response.status}: ${message}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=public-api-client.js.map

package/dist/apps/signstack-cli/src/lib/public-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-api-client.js","sourceRoot":"","sources":["../../../../../src/lib/public-api-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;GAIG;AACH,MAAM,OAAO,eAAe;IACT,MAAM,CAAS;IAEhC,YAAY,MAAe;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,IAAY;QACvB,OAAO,IAAI,CAAC,QAAQ,CAAI,KAAK,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,IAAY,EAAE,IAAa;QACvC,OAAO,IAAI,CAAC,QAAQ,CAAI,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,MAAsB,EACtB,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM;YACN,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC5D,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,OAAO,GAAG,QAAQ,CAAC,UAAU,IAAI,gBAAgB,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACrC,OAAO,GAAG,MAAM,CAAC,SAAS,EAAE,OAAO,IAAI,OAAO,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC;gBACP,sBAAsB;YACxB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAgB,CAAC;IACvC,CAAC;CACF"}

package/dist/apps/signstack-cli/src/lib/resource-puller.d.ts

@@ -0,0 +1,131 @@
+import { SchemaKind } from '../types/schema.types.js';
+/** Minimal HTTP client interface. */
+export interface HttpClient {
+    get<T>(path: string): Promise<T>;
+}
+/** Abstracts URL building for different pull sources. */
+export interface PullSource {
+    buildDependencyTreeUrl(kind: string, key: string, version: string): string;
+    buildResourceUrl(kind: string, key: string, version: string): string;
+    fetchFileDownloadUrl(client: HttpClient, fileId: string): Promise<string>;
+}
+/** Org-scoped pull source — uses authenticated org/namespace endpoints. */
+export declare class OrgPullSource implements PullSource {
+    readonly orgId: string;
+    readonly nsKey: string;
+    constructor(orgId: string, nsKey: string);
+    buildDependencyTreeUrl(kind: string, key: string, version: string): string;
+    buildResourceUrl(kind: string, key: string, version: string): string;
+    fetchFileDownloadUrl(client: HttpClient, fileId: string): Promise<string>;
+}
+/**
+ * Public library pull source — scoped by the listing that's being pulled. All
+ * URLs are keyed by the listing (`listingKey@listingVersion`), not the
+ * underlying resource. Sub-resources are fetched through the listing so the
+ * backend can authorize access once at the listing level. No auth required.
+ */
+export declare class LibraryPullSource implements PullSource {
+    readonly listingKey: string;
+    readonly listingVersion: string;
+    constructor(listingKey: string, listingVersion: string);
+    private get _prefix();
+    buildDependencyTreeUrl(): string;
+    buildResourceUrl(kind: string, key: string, version: string): string;
+    fetchFileDownloadUrl(client: HttpClient, fileId: string): Promise<string>;
+}
+/** Result of pulling a single resource */
+export interface PullResourceResult {
+    resourceId: string;
+    kind: SchemaKind;
+    key: string;
+    version: string;
+    success: boolean;
+    yamlPath?: string;
+    additionalFiles?: string[];
+    error?: string;
+}
+/** Overall pull summary */
+export interface PullSummary {
+    outputDir: string;
+    total: number;
+    succeeded: number;
+    failed: number;
+    results: PullResourceResult[];
+    byKind: Record<string, number>;
+}
+/** Parameters for the pull operation */
+export interface PullParams {
+    kind: string;
+    key: string;
+    version: string;
+    outputDir: string;
+    verbose: boolean;
+}
+/** Map CLI SchemaKind to backend ResourceKind */
+export declare const SCHEMA_KIND_TO_BACKEND: Record<SchemaKind, string>;
+/** Map backend ResourceKind to API endpoint path segment */
+export declare const KIND_TO_ENDPOINT: Record<string, string>;
+/**
+ * ResourcePuller — Fetches SignStack resources from the API and converts them to YAML files.
+ *
+ * This is the inverse of ResourcePusher. It:
+ * 1. Fetches the dependency tree for a resource
+ * 2. Downloads each dependent resource
+ * 3. Converts API responses to YAML format
+ * 4. Downloads binary files for assets with fileIds
+ * 5. Writes everything to a local folder structure
+ */
+export declare class ResourcePuller {
+    private readonly client;
+    private readonly source;
+    private readonly log;
+    constructor(client: HttpClient, source: PullSource, log: (msg: string) => void);
+    /**
+     * Pull a resource and all its dependencies from the API.
+     */
+    pull(params: PullParams): Promise<PullSummary>;
+    /**
+     * Fetch the transitive dependency tree and collect all unique resource IDs.
+     * Also includes the root resource itself.
+     */
+    private fetchAllDependencyIds;
+    /**
+     * Recursively flatten a dependency tree into a set of resource IDs.
+     * Handles both org format ({ resourceId }) and library format ({ kind, key, version }).
+     */
+    private flattenTree;
+    /**
+     * Pull a single resource: fetch from API, convert to YAML, write files.
+     */
+    private pullSingleResource;
+    /**
+     * Convert an API response to a YAML document object.
+     * Also writes any additional files (JSON definitions, HTML/CSS content, binary files).
+     */
+    private convertResource;
+    private convertSchema;
+    private convertAsset;
+    /**
+     * Convert API htmlConfig refs back to YAML format.
+     */
+    private convertHtmlConfig;
+    /**
+     * Convert a template and, when contentKey was absent from the API response
+     * (supplement templates like exhibit_a_nwmls), also write a stub asset YAML
+     * so that --resolve local preview can find the content dependency.
+     */
+    private convertTemplateWithAssetStub;
+    private convertTemplate;
+    private convertBlueprint;
+    private convertJsonataFunction;
+    /**
+     * Get a signed download URL for a file.
+     */
+    private getSignedUrl;
+    /**
+     * Determine file extension by making a HEAD request to the signed URL.
+     * Falls back to the default extension for the asset type if the Content-Type
+     * is unrecognized or the request fails.
+     */
+    private getFileExtension;
+}