prompt-lock 0.2.0

package/dist/runner.d.ts

@@ -0,0 +1,16 @@
+import { PromptLockConfig, RunResult } from './types';
+import { RetryOptions } from './retry';
+export interface RunOptions {
+    dryRun?: boolean;
+    verbose?: boolean;
+    parallel?: boolean;
+    concurrency?: number;
+    cache?: boolean;
+    cacheDir?: string;
+    retry?: Partial<RetryOptions>;
+    onResult?: (result: RunResult) => void;
+    onProgress?: (id: string, status: string) => void;
+}
+export declare function runPrompt(config: PromptLockConfig, opts?: RunOptions): Promise<RunResult>;
+export declare function runAll(configs: PromptLockConfig[], opts?: RunOptions): Promise<RunResult[]>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAqC,MAAM,SAAS,CAAC;AAMzF,OAAO,EAAa,YAAY,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD;AA8CD,wBAAsB,SAAS,CAAC,MAAM,EAAE,gBAAgB,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CA4G/F;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,gBAAgB,EAAE,EAC3B,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,SAAS,EAAE,CAAC,CAetB"}

package/dist/runner.js

@@ -0,0 +1,203 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPrompt = runPrompt;
+exports.runAll = runAll;
+const providers_1 = require("./providers");
+const assertions_1 = require("./assertions");
+const utils_1 = require("./utils");
+const config_validation_1 = require("./config-validation");
+const cache_1 = require("./cache");
+const retry_1 = require("./retry");
+function getCache(opts) {
+    if (!opts?.cache)
+        return null;
+    return new cache_1.OutputCache(opts.cacheDir);
+}
+async function callWithCacheAndRetry(provider, prompt, model, opts, providerOpts) {
+    const cache = getCache(opts);
+    // Check cache
+    if (cache) {
+        const cached = await cache.get(prompt, model);
+        if (cached !== null) {
+            if (opts?.verbose) {
+                process.stderr.write(`  [cache] HIT for ${model}:${prompt.slice(0, 50)}...\n`);
+            }
+            return { output: cached, cached: true };
+        }
+    }
+    // Call with retry
+    const output = await (0, retry_1.withRetry)(() => provider.call(prompt, providerOpts), opts?.retry, opts?.verbose
+        ? (attempt, error, delay) => {
+            process.stderr.write(`  [retry] attempt ${attempt}: ${error.message} — retrying in ${delay}ms\n`);
+        }
+        : undefined);
+    // Save to cache
+    if (cache) {
+        await cache.set(prompt, model, output);
+    }
+    return { output, cached: false };
+}
+async function runPrompt(config, opts) {
+    const startTime = Date.now();
+    // Validate config before running
+    const validation = (0, config_validation_1.validateConfig)(config);
+    if (!validation.valid) {
+        return {
+            id: config.id ?? 'unknown',
+            version: config.version,
+            provider: providerName(config),
+            model: config.model ?? 'unknown',
+            prompt: config.prompt ?? '',
+            promptHash: '',
+            output: '',
+            assertions: [{
+                    type: 'error',
+                    name: 'config-validation',
+                    passed: false,
+                    message: `Invalid config: ${validation.errors.join('; ')}`,
+                }],
+            passed: false,
+            duration: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // Render template with variables
+    const renderedPrompt = config.defaultVars
+        ? (0, utils_1.renderTemplate)(config.prompt, config.defaultVars)
+        : config.prompt;
+    if (opts?.dryRun) {
+        const output = '[DRY RUN — no LLM call made]';
+        const assertionResults = await runAssertionsWithLatency(output, config.assertions, 0);
+        return {
+            id: config.id,
+            version: config.version,
+            provider: providerName(config),
+            model: config.model,
+            prompt: renderedPrompt,
+            promptHash: `sha256:${(0, utils_1.hashString)(renderedPrompt)}`,
+            output,
+            defaultVars: config.defaultVars,
+            assertions: assertionResults,
+            passed: assertionResults.every(r => r.passed),
+            duration: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // Get provider and call LLM (with cache + retry)
+    opts?.onProgress?.(config.id, 'calling LLM...');
+    const provider = (0, providers_1.getProvider)(config.provider, config.model);
+    const callStart = Date.now();
+    const { output, cached } = await callWithCacheAndRetry(provider, renderedPrompt, config.model, opts, config.options);
+    const callDuration = Date.now() - callStart;
+    if (opts?.verbose) {
+        const src = cached ? 'cached' : 'live';
+        process.stderr.write(`  [verbose] ${config.id}: ${src} response in ${callDuration}ms (${output.length} chars)\n`);
+    }
+    // Run assertions (inject latency for max-latency)
+    const assertionResults = await runAssertionsWithLatency(output, config.assertions, callDuration);
+    const allPassed = assertionResults.every(r => r.passed);
+    const totalDuration = Date.now() - startTime;
+    // Dataset runs
+    let datasetResults;
+    if (config.dataset && config.dataset.length > 0) {
+        opts?.onProgress?.(config.id, `running dataset (${config.dataset.length} inputs)...`);
+        datasetResults = [];
+        for (const vars of config.dataset) {
+            const dsPrompt = (0, utils_1.renderTemplate)(config.prompt, vars);
+            const dsStart = Date.now();
+            const dsResult = await callWithCacheAndRetry(provider, dsPrompt, config.model, opts, config.options);
+            const dsDuration = Date.now() - dsStart;
+            const dsAssertions = await runAssertionsWithLatency(dsResult.output, config.assertions, dsDuration);
+            datasetResults.push({
+                vars,
+                output: dsResult.output,
+                assertions: dsAssertions,
+                passed: dsAssertions.every(r => r.passed),
+                duration: dsDuration,
+            });
+        }
+    }
+    const datasetAllPassed = datasetResults
+        ? datasetResults.every(d => d.passed)
+        : true;
+    return {
+        id: config.id,
+        version: config.version,
+        provider: providerName(config),
+        model: config.model,
+        prompt: renderedPrompt,
+        promptHash: `sha256:${(0, utils_1.hashString)(renderedPrompt)}`,
+        output,
+        defaultVars: config.defaultVars,
+        assertions: assertionResults,
+        passed: allPassed && datasetAllPassed,
+        duration: totalDuration,
+        timestamp: new Date().toISOString(),
+        datasetResults,
+    };
+}
+async function runAll(configs, opts) {
+    const parallel = opts?.parallel ?? configs[0]?.options?.parallel ?? false;
+    const concurrency = opts?.concurrency ?? configs[0]?.options?.concurrency ?? 5;
+    if (parallel && configs.length > 1) {
+        return runParallel(configs, concurrency, opts);
+    }
+    const results = [];
+    for (const config of configs) {
+        const result = await runSafe(config, opts);
+        results.push(result);
+        opts?.onResult?.(result);
+    }
+    return results;
+}
+async function runParallel(configs, concurrency, opts) {
+    const results = new Array(configs.length);
+    const queue = [...configs.keys()]; // [0, 1, 2, ...]
+    async function worker() {
+        while (queue.length > 0) {
+            const i = queue.shift();
+            results[i] = await runSafe(configs[i], opts);
+            opts?.onResult?.(results[i]);
+        }
+    }
+    const workers = Array.from({ length: Math.min(concurrency, configs.length) }, () => worker());
+    await Promise.all(workers);
+    return results;
+}
+async function runSafe(config, opts) {
+    try {
+        return await runPrompt(config, opts);
+    }
+    catch (error) {
+        return {
+            id: config.id,
+            version: config.version,
+            provider: providerName(config),
+            model: config.model,
+            prompt: config.prompt,
+            promptHash: `sha256:${(0, utils_1.hashString)(config.prompt)}`,
+            output: '',
+            assertions: [{
+                    type: 'error',
+                    name: 'execution-error',
+                    passed: false,
+                    message: `Error running prompt: ${error.message}`,
+                }],
+            passed: false,
+            duration: 0,
+            timestamp: new Date().toISOString(),
+        };
+    }
+}
+async function runAssertionsWithLatency(output, assertions, durationMs) {
+    const enriched = assertions.map(a => a.type === 'max-latency'
+        ? { ...a, __duration: durationMs }
+        : a);
+    return (0, assertions_1.runAssertions)(output, enriched);
+}
+function providerName(config) {
+    if (typeof config.provider === 'string')
+        return config.provider;
+    return `custom:${config.provider.url}`;
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/snapshot.d.ts

@@ -0,0 +1,7 @@
+import { SnapshotData, RunResult, DiffResult } from './types';
+export declare function saveSnapshot(result: RunResult, baseDir?: string): Promise<string>;
+export declare function loadSnapshot(id: string, baseDir?: string): Promise<SnapshotData | null>;
+export declare function loadSnapshotHistory(id: string, baseDir?: string): Promise<SnapshotData[]>;
+export declare function listSnapshots(baseDir?: string): Promise<string[]>;
+export declare function diffSnapshots(previous: SnapshotData, currentOutput: string): DiffResult;
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAc,MAAM,SAAS,CAAC;AAS1E,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CA0BjB;AAED,wBAAsB,YAAY,CAChC,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkB9B;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,YAAY,EAAE,CAAC,CAkBzB;AAED,wBAAsB,aAAa,CACjC,OAAO,GAAE,MAA6B,GACrC,OAAO,CAAC,MAAM,EAAE,CAAC,CAenB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,MAAM,GACpB,UAAU,CAgBZ"}

package/dist/snapshot.js

@@ -0,0 +1,146 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveSnapshot = saveSnapshot;
+exports.loadSnapshot = loadSnapshot;
+exports.loadSnapshotHistory = loadSnapshotHistory;
+exports.listSnapshots = listSnapshots;
+exports.diffSnapshots = diffSnapshots;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const diff_1 = require("diff");
+const utils_1 = require("./utils");
+const DEFAULT_SNAPSHOT_DIR = '.promptlock/snapshots';
+function sanitizeId(id) {
+    return id.replace(/[^a-zA-Z0-9_\-]/g, '_');
+}
+async function saveSnapshot(result, baseDir = DEFAULT_SNAPSHOT_DIR) {
+    const snapshot = {
+        id: result.id,
+        version: result.version,
+        promptHash: result.promptHash,
+        capturedAt: result.timestamp,
+        model: result.model,
+        defaultVars: result.defaultVars,
+        output: result.output,
+        assertionResults: result.assertions,
+    };
+    const safeId = sanitizeId(result.id);
+    const promptDir = path.join(baseDir, safeId);
+    await (0, utils_1.ensureDir)(promptDir);
+    // Save timestamped version for history
+    const ts = new Date().toISOString().replace(/[:.]/g, '-');
+    const historyPath = path.join(promptDir, `${ts}.json`);
+    await (0, utils_1.writeJsonFile)(historyPath, snapshot);
+    // Also save as "latest.json" for easy access
+    const latestPath = path.join(promptDir, 'latest.json');
+    await (0, utils_1.writeJsonFile)(latestPath, snapshot);
+    return latestPath;
+}
+async function loadSnapshot(id, baseDir = DEFAULT_SNAPSHOT_DIR) {
+    const safeId = sanitizeId(id);
+    // Try new format: {id}/latest.json
+    const latestPath = path.join(baseDir, safeId, 'latest.json');
+    try {
+        const content = await fs.promises.readFile(latestPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        // Fall back to old format: {id}.json
+        const legacyPath = path.join(baseDir, `${safeId}.json`);
+        try {
+            const content = await fs.promises.readFile(legacyPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+async function loadSnapshotHistory(id, baseDir = DEFAULT_SNAPSHOT_DIR) {
+    const safeId = sanitizeId(id);
+    const promptDir = path.join(baseDir, safeId);
+    try {
+        const files = await fs.promises.readdir(promptDir);
+        const snapshots = [];
+        for (const file of files.filter(f => f.endsWith('.json') && f !== 'latest.json').sort()) {
+            try {
+                const content = await fs.promises.readFile(path.join(promptDir, file), 'utf-8');
+                snapshots.push(JSON.parse(content));
+            }
+            catch {
+                // skip corrupt files
+            }
+        }
+        return snapshots;
+    }
+    catch {
+        return [];
+    }
+}
+async function listSnapshots(baseDir = DEFAULT_SNAPSHOT_DIR) {
+    try {
+        const entries = await fs.promises.readdir(baseDir, { withFileTypes: true });
+        const ids = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                ids.push(entry.name);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.json')) {
+                ids.push(entry.name.replace('.json', ''));
+            }
+        }
+        return ids;
+    }
+    catch {
+        return [];
+    }
+}
+function diffSnapshots(previous, currentOutput) {
+    const changes = (0, diff_1.diffLines)(previous.output, currentOutput);
+    const diffChanges = changes.map(change => ({
+        added: change.added,
+        removed: change.removed,
+        value: change.value,
+    }));
+    return {
+        id: previous.id,
+        previousOutput: previous.output,
+        currentOutput,
+        changes: diffChanges,
+        snapshotTimestamp: previous.capturedAt,
+    };
+}
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,138 @@
+export type ProviderConfig = 'openai' | 'anthropic' | CustomProviderConfig;
+export interface CustomProviderConfig {
+    type: 'custom';
+    url: string;
+    headers?: Record<string, string>;
+    bodyTemplate?: Record<string, unknown>;
+    responsePath?: string;
+}
+export interface PromptLockConfig {
+    id: string;
+    version?: string;
+    provider: ProviderConfig;
+    model: string;
+    prompt: string;
+    defaultVars?: Record<string, string>;
+    dataset?: Record<string, string>[];
+    assertions: AssertionConfig[];
+    options?: PromptLockOptions;
+}
+export interface PromptLockOptions {
+    temperature?: number;
+    maxTokens?: number;
+    timeout?: number;
+    parallel?: boolean;
+    concurrency?: number;
+}
+export type AssertionConfig = {
+    type: 'contains';
+    value: string;
+} | {
+    type: 'not-contains';
+    value: string;
+} | {
+    type: 'contains-all';
+    values: string[];
+} | {
+    type: 'starts-with';
+    value: string;
+} | {
+    type: 'ends-with';
+    value: string;
+} | {
+    type: 'matches-regex';
+    pattern: string;
+} | {
+    type: 'max-length';
+    chars: number;
+} | {
+    type: 'min-length';
+    chars: number;
+} | {
+    type: 'json-valid';
+} | {
+    type: 'json-schema';
+    schema: Record<string, unknown>;
+} | {
+    type: 'no-hallucination-words';
+    words?: string[];
+} | {
+    type: 'no-duplicates';
+    separator?: string;
+} | {
+    type: 'max-latency';
+    ms: number;
+} | {
+    type: 'custom';
+    name: string;
+    fn: (output: string) => boolean | Promise<boolean>;
+};
+export interface AssertionResult {
+    type: string;
+    name: string;
+    passed: boolean;
+    expected?: string;
+    actual?: string;
+    message?: string;
+}
+export interface RunResult {
+    id: string;
+    version?: string;
+    provider: string;
+    model: string;
+    prompt: string;
+    promptHash: string;
+    output: string;
+    defaultVars?: Record<string, string>;
+    assertions: AssertionResult[];
+    passed: boolean;
+    duration: number;
+    timestamp: string;
+    datasetResults?: DatasetRunResult[];
+}
+export interface DatasetRunResult {
+    vars: Record<string, string>;
+    output: string;
+    assertions: AssertionResult[];
+    passed: boolean;
+    duration: number;
+}
+export interface SnapshotData {
+    id: string;
+    version?: string;
+    promptHash: string;
+    capturedAt: string;
+    model: string;
+    defaultVars?: Record<string, string>;
+    output: string;
+    assertionResults: AssertionResult[];
+}
+export interface DiffResult {
+    id: string;
+    previousOutput: string;
+    currentOutput: string;
+    changes: DiffChange[];
+    snapshotTimestamp: string;
+}
+export interface DiffChange {
+    added?: boolean;
+    removed?: boolean;
+    value: string;
+}
+export interface PromptLockProjectConfig {
+    promptsDir: string;
+    snapshotDir: string;
+    reportDir: string;
+    defaultProvider: string;
+    defaultModel?: string;
+    ci: {
+        failOnRegression: boolean;
+        reportFormat: ('json' | 'html')[];
+    };
+}
+export interface LLMProvider {
+    call(prompt: string, options?: PromptLockOptions & {
+        model?: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// ── Provider Config ──────────────────────────────────────────────────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,gFAAgF"}

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+export declare function renderTemplate(template: string, variables: Record<string, string>): string;
+export declare function hashString(s: string): string;
+export declare function ensureDir(dir: string): Promise<void>;
+export declare function readJsonFile<T>(filePath: string): T | null;
+export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
+export declare function spinner(message: string): {
+    stop: (finalMessage?: string) => void;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAI1F;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CAO1D;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGlF;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,CAclF"}

package/dist/utils.js

@@ -0,0 +1,83 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTemplate = renderTemplate;
+exports.hashString = hashString;
+exports.ensureDir = ensureDir;
+exports.readJsonFile = readJsonFile;
+exports.writeJsonFile = writeJsonFile;
+exports.spinner = spinner;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function renderTemplate(template, variables) {
+    return template.replace(/\{\{([\w.\-]+)\}\}/g, (match, key) => {
+        return variables[key] !== undefined ? variables[key] : match;
+    });
+}
+function hashString(s) {
+    return crypto.createHash('sha256').update(s).digest('hex');
+}
+async function ensureDir(dir) {
+    await fs.promises.mkdir(dir, { recursive: true });
+}
+function readJsonFile(filePath) {
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+async function writeJsonFile(filePath, data) {
+    await ensureDir(path.dirname(filePath));
+    await fs.promises.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+function spinner(message) {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    const interval = setInterval(() => {
+        process.stderr.write(`\r${frames[i % frames.length]} ${message}`);
+        i++;
+    }, 80);
+    return {
+        stop(finalMessage) {
+            clearInterval(interval);
+            process.stderr.write(`\r${finalMessage ?? message}${''.padEnd(10)}\n`);
+        },
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,wCAIC;AAED,gCAEC;AAED,8BAEC;AAED,oCAOC;AAED,sCAGC;AAED,0BAcC;AA9CD,+CAAiC;AACjC,uCAAyB;AACzB,2CAA6B;AAE7B,SAAgB,cAAc,CAAC,QAAgB,EAAE,SAAiC;IAChF,OAAO,QAAQ,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5D,OAAO,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAgB,UAAU,CAAC,CAAS;IAClC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAEM,KAAK,UAAU,SAAS,CAAC,GAAW;IACzC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAgB,YAAY,CAAI,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAa;IACjE,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxC,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC;AAED,SAAgB,OAAO,CAAC,OAAe;IACrC,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC;QAClE,CAAC,EAAE,CAAC;IACN,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,IAAI,CAAC,YAAqB;YACxB,aAAa,CAAC,QAAQ,CAAC,CAAC;YACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,YAAY,IAAI,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC"}