@signstack/cli 0.1.1

package/dist/apps/signstack-cli/src/commands/preview.js

@@ -0,0 +1,162 @@
+import { Args, Flags } from '@oclif/core';
+import { AuthenticatedCommand } from '../lib/base-command.js';
+import { PreviewHandler } from '../lib/preview-handler.js';
+import { promptResourceSelection } from '../lib/resource-scanner.js';
+import { SchemaKind } from '../types/schema.types.js';
+export default class Preview extends AuthenticatedCommand {
+    static description = 'Preview a blueprint or template and get signed PDF URL(s)';
+    static examples = [
+        {
+            command: '<%= config.bin %> preview my_blueprint@1.0.0',
+            description: 'Preview using local files + API fallback (default)',
+        },
+        {
+            command: '<%= config.bin %> preview my_blueprint',
+            description: 'Preview latest version (resolved from API)',
+        },
+        {
+            command: '<%= config.bin %> preview my_blueprint@1.0.0 -p ./other-project',
+            description: 'Use a different folder for local files',
+        },
+        {
+            command: '<%= config.bin %> preview my_blueprint@1.0.0 --resolve local',
+            description: 'Strict local mode — all resources must exist in files',
+        },
+        {
+            command: '<%= config.bin %> preview my_blueprint@1.0.0 --resolve remote',
+            description: 'Skip local files — resolve everything from API',
+        },
+        {
+            command: '<%= config.bin %> preview --template my_template@1.0.0',
+            description: 'Preview a single template',
+        },
+        {
+            command: '<%= config.bin %> preview --list-scenarios',
+            description: 'List available scenarios',
+        },
+    ];
+    static args = {
+        blueprint: Args.string({
+            description: 'Blueprint reference as key@version (e.g., my_blueprint@1.0.0) or key (uses latest version)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...AuthenticatedCommand.baseFlags,
+        blueprint: Flags.string({
+            char: 'b',
+            description: 'Blueprint reference (alternative to positional argument)',
+            exclusive: ['template'],
+            hidden: true,
+        }),
+        template: Flags.string({
+            char: 't',
+            description: 'Template reference as key@version (e.g., my_template@1.0.0) or key (uses latest version)',
+        }),
+        path: Flags.string({
+            char: 'p',
+            description: 'Folder path containing YAML resource files (default: current directory)',
+            default: '.',
+        }),
+        resolve: Flags.string({
+            char: 'r',
+            description: 'Resource resolution strategy: local (files only), remote (API only), auto (files first, API fallback)',
+            options: ['local', 'remote', 'auto'],
+        }),
+        scenario: Flags.string({
+            char: 's',
+            description: 'Scenario key for entity data (optional — auto-generates if not provided)',
+        }),
+        'list-scenarios': Flags.boolean({
+            char: 'l',
+            description: 'List available scenarios',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output in JSON format',
+            default: false,
+        }),
+        'skip-signature-fields': Flags.boolean({
+            description: 'Disable dummy signatures, initials, and auto-dates on preview',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Preview);
+        const handler = this.createPreviewHandler();
+        // Handle --list-scenarios
+        if (flags['list-scenarios']) {
+            return handler.listScenarios(flags.json);
+        }
+        // Resolve blueprint from positional arg or --blueprint flag
+        const blueprintRef = args.blueprint ?? flags.blueprint;
+        // Ensure exactly one of blueprint or --template is provided
+        if (blueprintRef && flags.template) {
+            this.error('Cannot specify both a blueprint and --template. Use one or the other.', {
+                exit: 1,
+                suggestions: [
+                    `signstack preview ${blueprintRef}`,
+                    `signstack preview --template ${flags.template}`,
+                ],
+            });
+        }
+        let kind;
+        let ref;
+        if (blueprintRef) {
+            kind = 'blueprint';
+            ref = this.sanitizeInput(blueprintRef);
+        }
+        else if (flags.template) {
+            kind = 'template';
+            ref = this.sanitizeInput(flags.template);
+        }
+        else {
+            // No blueprint or template specified — scan folder and prompt
+            if (flags.json) {
+                this.error('Provide a blueprint reference or use --template.', {
+                    exit: 1,
+                    suggestions: [
+                        'signstack preview my_blueprint@1.0.0 --json',
+                        'signstack preview --template my_template@1.0.0 --json',
+                    ],
+                });
+            }
+            const selected = await promptResourceSelection(flags.path, [SchemaKind.Blueprint, SchemaKind.Template], 'Select a resource to preview');
+            if (!selected) {
+                this.error('No blueprints or templates found in the current directory.', {
+                    exit: 1,
+                    suggestions: [
+                        'signstack preview my_blueprint@1.0.0',
+                        'signstack preview --template my_template@1.0.0',
+                        'Use -p to specify a different folder',
+                    ],
+                });
+            }
+            kind = selected.kind.toLowerCase();
+            ref = selected.ref;
+            // Use the directory containing the selected resource's YAML file
+            // so validation and file resolution work correctly
+            flags.path = selected.resourceDir;
+        }
+        const skipSignatureFields = flags['skip-signature-fields'] || undefined;
+        const combinePdfs = kind === 'blueprint' ? true : undefined;
+        const resolveMode = flags.resolve;
+        if (resolveMode === 'remote') {
+            // Explicit remote — API resolves everything
+            const { key, version } = this.parseResourceRef(ref, kind, false);
+            const run = (kind === 'blueprint' ? handler.runRemote : handler.runTemplateRemote).bind(handler);
+            await run(key, version, flags.scenario ? this.sanitizeInput(flags.scenario) : undefined, flags.json, skipSignatureFields, combinePdfs);
+        }
+        else {
+            // Default: hybrid (local files + API fallback)
+            // key-only refs resolve to the highest local version
+            const inlineOnly = resolveMode === 'local';
+            const run = (kind === 'blueprint' ? handler.runLocal : handler.runTemplateLocal).bind(handler);
+            await run(flags.path, ref, flags.scenario, flags.json, inlineOnly, skipSignatureFields, combinePdfs);
+        }
+    }
+    createPreviewHandler() {
+        return new PreviewHandler(this.apiClient, { orgId: this.cliConfig.orgId, namespaceKey: this.cliConfig.namespaceKey }, this.log.bind(this), this.error.bind(this));
+    }
+}
+//# sourceMappingURL=preview.js.map

package/dist/apps/signstack-cli/src/commands/preview.js.map

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

package/dist/apps/signstack-cli/src/commands/pull.d.ts

@@ -0,0 +1,28 @@
+import { AuthenticatedCommand } from '../lib/base-command.js';
+/**
+ * Find a unique directory name by appending (2), (3), etc. if the base name exists.
+ */
+export declare function findUniqueDir(parentDir: string, baseName: string): string;
+export default class Pull extends AuthenticatedCommand {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static args: {
+        resource: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        kind: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    private listResourceKeys;
+    private listVersions;
+    private resolveLatestVersion;
+    private promptKindSelection;
+    private printPullSummary;
+}

package/dist/apps/signstack-cli/src/commands/pull.js

@@ -0,0 +1,244 @@
+import { Args, Flags } from '@oclif/core';
+import { select } from '@inquirer/prompts';
+import { existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import pc from 'picocolors';
+import { AuthenticatedCommand } from '../lib/base-command.js';
+import { ResourcePuller, OrgPullSource, KIND_TO_ENDPOINT, SCHEMA_KIND_TO_BACKEND, } from '../lib/resource-puller.js';
+import { CLI_FLAG_TO_SCHEMA_KIND, SCHEMA_FLAG_OPTIONS, } from '../types/schema.types.js';
+/** Separator line length for output formatting */
+const SEPARATOR_LENGTH = 50;
+/**
+ * Find a unique directory name by appending (2), (3), etc. if the base name exists.
+ */
+export function findUniqueDir(parentDir, baseName) {
+    const first = join(parentDir, baseName);
+    if (!existsSync(first))
+        return first;
+    let suffix = 2;
+    while (existsSync(join(parentDir, `${baseName} (${suffix})`))) {
+        suffix++;
+    }
+    return join(parentDir, `${baseName} (${suffix})`);
+}
+export default class Pull extends AuthenticatedCommand {
+    static description = 'Pull a resource and all its dependencies from the API into local YAML files.';
+    static examples = [
+        {
+            command: '<%= config.bin %> pull my_blueprint --kind blueprint',
+            description: 'Pull latest active version of a blueprint and all dependencies',
+        },
+        {
+            command: '<%= config.bin %> pull my_template@1.0.0 --kind template',
+            description: 'Pull a specific version of a template',
+        },
+        {
+            command: '<%= config.bin %> pull my_blueprint@draft --kind blueprint',
+            description: 'Pull the draft version of a blueprint',
+        },
+        {
+            command: '<%= config.bin %> pull my_template@1.0.0 --kind template -o ./my-project',
+            description: 'Pull into a specific output directory',
+        },
+    ];
+    static args = {
+        resource: Args.string({
+            description: 'Resource reference as key or key@version (e.g., my_blueprint or my_blueprint@1.0.0)',
+            required: false,
+        }),
+    };
+    static flags = {
+        ...AuthenticatedCommand.baseFlags,
+        kind: Flags.string({
+            char: 'k',
+            description: 'Resource kind',
+            required: false,
+            options: SCHEMA_FLAG_OPTIONS,
+        }),
+        output: Flags.string({
+            char: 'o',
+            description: 'Parent directory for the pull output (default: current directory)',
+        }),
+        verbose: Flags.boolean({
+            char: 'v',
+            description: 'Show detailed output',
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: 'Output in JSON format',
+            default: false,
+        }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Pull);
+        const source = new OrgPullSource(this.cliConfig.orgId, this.cliConfig.namespaceKey);
+        const puller = new ResourcePuller(this.apiClient, source, (msg) => this.log(msg));
+        let kindFlag;
+        let key;
+        let explicitVersion;
+        if (args.resource) {
+            // Explicit resource arg — kind flag is required
+            if (!flags.kind) {
+                this.error('--kind is required when specifying a resource argument.', {
+                    exit: 1,
+                    suggestions: SCHEMA_FLAG_OPTIONS.map((k) => `--kind ${k}`),
+                });
+            }
+            const ref = this.sanitizeInput(args.resource);
+            kindFlag = flags.kind;
+            const parsed = this.parseResourceRef(ref, kindFlag, false);
+            key = parsed.key;
+            explicitVersion = parsed.version;
+        }
+        else {
+            // Interactive mode
+            if (flags.json) {
+                this.error('Resource argument is required in --json mode (non-interactive).', { exit: 1 });
+            }
+            // Step 1: Prompt for kind
+            kindFlag = flags.kind ?? await this.promptKindSelection();
+            // Step 2: Fetch resources of that kind and prompt for selection
+            const schemaKind = CLI_FLAG_TO_SCHEMA_KIND[kindFlag];
+            const backendKind = SCHEMA_KIND_TO_BACKEND[schemaKind];
+            const resources = await this.listResourceKeys(backendKind);
+            if (resources.length === 0) {
+                this.error(`No ${kindFlag} resources found.`, { exit: 1 });
+            }
+            const choices = resources
+                .sort((a, b) => a.key.localeCompare(b.key))
+                .map((r) => ({
+                name: `${r.key}${r.name ? pc.dim(` — ${r.name}`) : ''}`,
+                value: r.key,
+            }));
+            key = await select({
+                message: `Select a ${kindFlag}`,
+                choices,
+                loop: false,
+            });
+            // Step 3: Fetch versions and prompt for selection
+            const versions = await this.listVersions(backendKind, key);
+            if (versions.length === 0) {
+                this.error(`No versions found for ${kindFlag}:${key}.`, { exit: 1 });
+            }
+            if (versions.length === 1) {
+                explicitVersion = versions[0];
+            }
+            else {
+                const versionChoices = versions.map((v) => ({
+                    name: v,
+                    value: v,
+                }));
+                explicitVersion = await select({
+                    message: `Select a version`,
+                    choices: versionChoices,
+                    loop: false,
+                });
+            }
+        }
+        const schemaKind = CLI_FLAG_TO_SCHEMA_KIND[kindFlag];
+        const backendKind = SCHEMA_KIND_TO_BACKEND[schemaKind];
+        // Validate key
+        if (key.includes('..') || key.includes('/') || key.includes('\\')) {
+            this.error(`Invalid resource key: "${key}". Key cannot contain path traversal characters.`, { exit: 1 });
+        }
+        // Resolve version
+        let version;
+        if (explicitVersion) {
+            version = explicitVersion;
+        }
+        else {
+            this.log(pc.dim(`Resolving latest version for ${kindFlag}:${key}...`));
+            const resolved = await this.resolveLatestVersion(backendKind, key);
+            if (!resolved) {
+                this.error(`Resource ${kindFlag}:${key} not found.`, { exit: 1 });
+            }
+            version = resolved;
+            this.log(pc.dim(`Resolved to version ${version}\n`));
+        }
+        // Determine output directory
+        const parentDir = resolve(flags.output ?? '.');
+        const folderName = `${key}@${version}`;
+        const outputDir = findUniqueDir(parentDir, folderName);
+        this.log(pc.cyan(`\nPulling ${kindFlag} ${key}@${version} into ${outputDir}\n`));
+        // Pull resources
+        const summary = await puller.pull({
+            kind: backendKind,
+            key,
+            version,
+            outputDir,
+            verbose: flags.verbose,
+        });
+        // Print summary
+        if (flags.json) {
+            this.log(JSON.stringify(summary));
+        }
+        else {
+            this.printPullSummary(summary);
+        }
+        if (summary.failed > 0) {
+            this.exit(1);
+        }
+    }
+    // ─── Interactive browse helpers (org-scoped) ─────────────────
+    async listResourceKeys(backendKind) {
+        const endpoint = KIND_TO_ENDPOINT[backendKind];
+        if (!endpoint)
+            return [];
+        const resp = await this.apiClient.get(`/v1/orgs/${this.cliConfig.orgId}/namespaces/${this.cliConfig.namespaceKey}/${endpoint}?limit=50`);
+        return resp.data.map((r) => ({
+            key: r.metadata.key,
+            name: r.metadata.name,
+        }));
+    }
+    async listVersions(backendKind, key) {
+        const endpoint = KIND_TO_ENDPOINT[backendKind];
+        if (!endpoint)
+            return [];
+        const resp = await this.apiClient.get(`/v1/orgs/${this.cliConfig.orgId}/namespaces/${this.cliConfig.namespaceKey}/${endpoint}/${encodeURIComponent(key)}/versions?limit=50`);
+        return resp.data.map((r) => r.metadata.version);
+    }
+    async resolveLatestVersion(backendKind, key) {
+        const endpoint = KIND_TO_ENDPOINT[backendKind];
+        if (!endpoint)
+            return null;
+        try {
+            const resp = await this.apiClient.get(`/v1/orgs/${this.cliConfig.orgId}/namespaces/${this.cliConfig.namespaceKey}/${endpoint}/${encodeURIComponent(key)}/versions?skipDraft=true&limit=1`);
+            if (resp.data.length > 0) {
+                return resp.data[0].metadata.version;
+            }
+        }
+        catch {
+            // Resource doesn't exist
+        }
+        return null;
+    }
+    async promptKindSelection() {
+        const choices = SCHEMA_FLAG_OPTIONS.map((k) => ({
+            name: k,
+            value: k,
+        }));
+        return select({
+            message: 'Select a resource kind',
+            choices,
+            loop: false,
+        });
+    }
+    printPullSummary(summary) {
+        this.log(pc.dim('\n' + '─'.repeat(SEPARATOR_LENGTH)));
+        this.log(`\nPull complete: ${summary.total} resource(s) written to ${summary.outputDir}/\n`);
+        // Print counts by kind
+        for (const [kind, count] of Object.entries(summary.byKind)) {
+            this.log(`  ${kind}: ${pc.green(String(count))}`);
+        }
+        if (summary.failed > 0) {
+            this.log(pc.red(`\n  Failed: ${summary.failed}`));
+            for (const r of summary.results) {
+                if (!r.success) {
+                    this.log(pc.red(`    ${r.kind}:${r.key}@${r.version} - ${r.error}`));
+                }
+            }
+        }
+        this.log('');
+    }
+}
+//# sourceMappingURL=pull.js.map

package/dist/apps/signstack-cli/src/commands/pull.js.map

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

package/dist/apps/signstack-cli/src/commands/push.d.ts

@@ -0,0 +1,46 @@
+import { AuthenticatedCommand } from '../lib/base-command.js';
+export default class Push extends AuthenticatedCommand {
+    static description: string;
+    static examples: {
+        command: string;
+        description: string;
+    }[];
+    static args: {
+        resource: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        kind: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        dir: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'api-url': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+    /**
+     * Resolve the resource kind — from --kind flag or inferred from YAML files.
+     */
+    private resolveResourceKind;
+    /**
+     * Run schema validation on all documents in topological order.
+     * Also validates dependencies and file references.
+     * Returns true if all validations pass.
+     */
+    private runValidation;
+    /**
+     * Print a validation error
+     */
+    private printValidationError;
+    /**
+     * Print the push plan showing what will be created in what order
+     */
+    private printPushPlan;
+    /**
+     * Push all resources in topological order
+     */
+    private pushResources;
+    /**
+     * Print push summary
+     */
+    private printPushSummary;
+}