@fold-run/cli 0.1.1 → 0.1.3

package/dist/lib/cron.js

@@ -0,0 +1,107 @@
+// Cron expression validator for standard 5-field cron format:
+//   minute hour day-of-month month day-of-week
+// Supports: numbers, ranges (1-5), steps (e.g. every 5), lists (1,3,5), wildcards (*)
+const CRON_FIELDS = [
+    { name: 'minute', min: 0, max: 59 },
+    { name: 'hour', min: 0, max: 23 },
+    { name: 'day of month', min: 1, max: 31 },
+    { name: 'month', min: 1, max: 12 },
+    { name: 'day of week', min: 0, max: 7 }, // 0 and 7 are both Sunday
+];
+// Validate a single cron field value (e.g., "5", "1-10", "1,5,10")
+function validateField(value, field) {
+    // Wildcard
+    if (value === '*') {
+        return null;
+    }
+    // Step values: */5 or 1-10/2
+    if (value.includes('/')) {
+        const [range, stepStr] = value.split('/');
+        const step = parseInt(stepStr, 10);
+        if (Number.isNaN(step) || step < 1) {
+            return `invalid step value "${stepStr}" in ${field.name}`;
+        }
+        // Validate the range part
+        if (range !== '*') {
+            const rangeError = validateField(range, field);
+            if (rangeError)
+                return rangeError;
+        }
+        return null;
+    }
+    // List values: 1,5,10
+    if (value.includes(',')) {
+        const parts = value.split(',');
+        for (const part of parts) {
+            const error = validateField(part.trim(), field);
+            if (error)
+                return error;
+        }
+        return null;
+    }
+    // Range values: 1-10
+    if (value.includes('-')) {
+        const [startStr, endStr] = value.split('-');
+        const start = parseInt(startStr, 10);
+        const end = parseInt(endStr, 10);
+        if (Number.isNaN(start) || Number.isNaN(end)) {
+            return `invalid range "${value}" in ${field.name}`;
+        }
+        if (start < field.min || start > field.max) {
+            return `${field.name} start value ${start} out of range (${field.min}-${field.max})`;
+        }
+        if (end < field.min || end > field.max) {
+            return `${field.name} end value ${end} out of range (${field.min}-${field.max})`;
+        }
+        if (start > end) {
+            return `invalid range "${value}" in ${field.name}: start > end`;
+        }
+        return null;
+    }
+    // Single number
+    const num = parseInt(value, 10);
+    if (Number.isNaN(num)) {
+        return `invalid value "${value}" in ${field.name}`;
+    }
+    if (num < field.min || num > field.max) {
+        return `${field.name} value ${num} out of range (${field.min}-${field.max})`;
+    }
+    return null;
+}
+/**
+ * Validate a cron expression.
+ * Returns { valid: true } or { valid: false, error: "..." }
+ */
+export function validateCron(expression) {
+    const trimmed = expression.trim();
+    if (!trimmed) {
+        return { valid: false, error: 'cron expression cannot be empty' };
+    }
+    const fields = trimmed.split(/\s+/);
+    if (fields.length !== 5) {
+        return {
+            valid: false,
+            error: `expected 5 fields (minute hour day month weekday), got ${fields.length}`,
+        };
+    }
+    for (let i = 0; i < 5; i++) {
+        const error = validateField(fields[i], CRON_FIELDS[i]);
+        if (error) {
+            return { valid: false, error };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Format a cron validation error with usage hint.
+ */
+export function formatCronError(error) {
+    return `Invalid cron expression: ${error}
+
+Format: <minute> <hour> <day> <month> <weekday>
+Examples:
+  */5 * * * *     Every 5 minutes
+  0 9 * * 1-5     9 AM on weekdays
+  0 0 1 * *       Midnight on the 1st of each month`;
+}
+//# sourceMappingURL=cron.js.map

package/dist/lib/cron.js.map

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

package/dist/lib/manifest.d.ts

@@ -0,0 +1,31 @@
+export interface FoldManifest {
+    name?: string;
+    entrypoint?: string;
+    tenant_id?: string;
+    intent?: {
+        trigger?: string;
+        bindings?: string[];
+    };
+}
+export interface ManifestValidationError {
+    field: string;
+    message: string;
+}
+export interface ManifestResult {
+    manifest: FoldManifest | null;
+    errors: ManifestValidationError[];
+    warnings: string[];
+}
+/**
+ * Load and validate fold.json from current directory.
+ * Returns manifest (if valid), errors (blocking), and warnings (non-blocking).
+ */
+export declare function loadManifest(dir?: string): ManifestResult;
+/**
+ * Format validation errors for display.
+ */
+export declare function formatManifestErrors(errors: ManifestValidationError[]): string;
+/**
+ * Format warnings for display.
+ */
+export declare function formatManifestWarnings(warnings: string[]): string;

package/dist/lib/manifest.js

@@ -0,0 +1,195 @@
+// fold.json manifest validation
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+const KNOWN_FIELDS = ['name', 'entrypoint', 'tenant_id', 'intent'];
+const KNOWN_INTENT_FIELDS = ['trigger', 'bindings'];
+const VALID_TRIGGERS = ['http', 'cron', 'webhook', 'queue'];
+const VALID_BINDINGS = ['kv', 'storage', 'db', 'queue', 'ai'];
+function validateType(value, field, expected) {
+    const actual = Array.isArray(value) ? 'array' : typeof value;
+    if (actual !== expected) {
+        return `"${field}" must be a ${expected}, got ${actual}`;
+    }
+    return null;
+}
+/**
+ * Load and validate fold.json from current directory.
+ * Returns manifest (if valid), errors (blocking), and warnings (non-blocking).
+ */
+export function loadManifest(dir) {
+    const manifestPath = resolve(dir ?? '.', 'fold.json');
+    const errors = [];
+    const warnings = [];
+    if (!existsSync(manifestPath)) {
+        return { manifest: null, errors: [], warnings: [] };
+    }
+    let raw;
+    try {
+        raw = readFileSync(manifestPath, 'utf-8');
+    }
+    catch (err) {
+        errors.push({ field: 'file', message: `Could not read fold.json: ${err}` });
+        return { manifest: null, errors, warnings };
+    }
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch (err) {
+        const parseErr = err;
+        errors.push({ field: 'json', message: `Invalid JSON: ${parseErr.message}` });
+        return { manifest: null, errors, warnings };
+    }
+    if (typeof data !== 'object' || data === null || Array.isArray(data)) {
+        errors.push({ field: 'root', message: 'fold.json must be an object' });
+        return { manifest: null, errors, warnings };
+    }
+    const obj = data;
+    // Check for unknown top-level fields
+    for (const key of Object.keys(obj)) {
+        if (!KNOWN_FIELDS.includes(key)) {
+            warnings.push(`Unknown field "${key}" in fold.json (will be ignored)`);
+        }
+    }
+    // Validate name
+    if (obj.name !== undefined) {
+        const typeErr = validateType(obj.name, 'name', 'string');
+        if (typeErr) {
+            errors.push({ field: 'name', message: typeErr });
+        }
+        else if (typeof obj.name === 'string') {
+            if (obj.name.trim() === '') {
+                errors.push({ field: 'name', message: '"name" cannot be empty' });
+            }
+            else if (!/^[a-z0-9][a-z0-9-]*[a-z0-9]$|^[a-z0-9]$/.test(obj.name)) {
+                errors.push({
+                    field: 'name',
+                    message: '"name" must be lowercase alphanumeric with hyphens (e.g., "my-function")',
+                });
+            }
+        }
+    }
+    // Validate entrypoint
+    if (obj.entrypoint !== undefined) {
+        const typeErr = validateType(obj.entrypoint, 'entrypoint', 'string');
+        if (typeErr) {
+            errors.push({ field: 'entrypoint', message: typeErr });
+        }
+        else if (typeof obj.entrypoint === 'string') {
+            if (obj.entrypoint.trim() === '') {
+                errors.push({ field: 'entrypoint', message: '"entrypoint" cannot be empty' });
+            }
+            else {
+                const entryPath = resolve(dir ?? '.', obj.entrypoint);
+                if (!existsSync(entryPath)) {
+                    errors.push({
+                        field: 'entrypoint',
+                        message: `Entrypoint file not found: ${obj.entrypoint}`,
+                    });
+                }
+            }
+        }
+    }
+    // Validate tenant_id
+    if (obj.tenant_id !== undefined) {
+        const typeErr = validateType(obj.tenant_id, 'tenant_id', 'string');
+        if (typeErr) {
+            errors.push({ field: 'tenant_id', message: typeErr });
+        }
+        else if (typeof obj.tenant_id === 'string' && obj.tenant_id.trim() === '') {
+            errors.push({ field: 'tenant_id', message: '"tenant_id" cannot be empty' });
+        }
+    }
+    // Validate intent
+    if (obj.intent !== undefined) {
+        const typeErr = validateType(obj.intent, 'intent', 'object');
+        if (typeErr) {
+            errors.push({ field: 'intent', message: typeErr });
+        }
+        else if (typeof obj.intent === 'object' && obj.intent !== null && !Array.isArray(obj.intent)) {
+            const intent = obj.intent;
+            // Check for unknown intent fields
+            for (const key of Object.keys(intent)) {
+                if (!KNOWN_INTENT_FIELDS.includes(key)) {
+                    warnings.push(`Unknown field "intent.${key}" (will be ignored)`);
+                }
+            }
+            // Validate trigger
+            if (intent.trigger !== undefined) {
+                const triggerErr = validateType(intent.trigger, 'intent.trigger', 'string');
+                if (triggerErr) {
+                    errors.push({ field: 'intent.trigger', message: triggerErr });
+                }
+                else if (typeof intent.trigger === 'string' && !VALID_TRIGGERS.includes(intent.trigger)) {
+                    warnings.push(`Unknown trigger "${intent.trigger}" (valid: ${VALID_TRIGGERS.join(', ')})`);
+                }
+            }
+            // Validate bindings
+            if (intent.bindings !== undefined) {
+                const bindingsErr = validateType(intent.bindings, 'intent.bindings', 'array');
+                if (bindingsErr) {
+                    errors.push({ field: 'intent.bindings', message: bindingsErr });
+                }
+                else if (Array.isArray(intent.bindings)) {
+                    for (let i = 0; i < intent.bindings.length; i++) {
+                        const b = intent.bindings[i];
+                        if (typeof b !== 'string') {
+                            errors.push({
+                                field: `intent.bindings[${i}]`,
+                                message: `Binding must be a string, got ${typeof b}`,
+                            });
+                        }
+                        else if (!VALID_BINDINGS.includes(b)) {
+                            warnings.push(`Unknown binding "${b}" (valid: ${VALID_BINDINGS.join(', ')})`);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (errors.length > 0) {
+        return { manifest: null, errors, warnings };
+    }
+    // Build validated manifest
+    const manifest = {};
+    if (typeof obj.name === 'string')
+        manifest.name = obj.name;
+    if (typeof obj.entrypoint === 'string')
+        manifest.entrypoint = obj.entrypoint;
+    if (typeof obj.tenant_id === 'string')
+        manifest.tenant_id = obj.tenant_id;
+    if (typeof obj.intent === 'object' && obj.intent !== null) {
+        const intent = obj.intent;
+        manifest.intent = {};
+        if (typeof intent.trigger === 'string')
+            manifest.intent.trigger = intent.trigger;
+        if (Array.isArray(intent.bindings)) {
+            manifest.intent.bindings = intent.bindings.filter((b) => typeof b === 'string');
+        }
+    }
+    return { manifest, errors, warnings };
+}
+/**
+ * Format validation errors for display.
+ */
+export function formatManifestErrors(errors) {
+    const lines = ['Invalid fold.json:', ''];
+    for (const err of errors) {
+        lines.push(`  \x1b[31m✗\x1b[0m ${err.message}`);
+    }
+    lines.push('');
+    lines.push('Example fold.json:');
+    lines.push('  {');
+    lines.push('    "name": "my-function",');
+    lines.push('    "entrypoint": "function.ts",');
+    lines.push('    "intent": { "bindings": ["kv"] }');
+    lines.push('  }');
+    return lines.join('\n');
+}
+/**
+ * Format warnings for display.
+ */
+export function formatManifestWarnings(warnings) {
+    return warnings.map((w) => `\x1b[33mWarning:\x1b[0m ${w}`).join('\n');
+}
+//# sourceMappingURL=manifest.js.map

package/dist/lib/manifest.js.map

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

package/dist/lib/prompt.d.ts

@@ -1,3 +1,8 @@
+/**
+ * Prompt for yes/no confirmation. Returns true if user confirms.
+ * Defaults to 'no' if user just presses enter.
+ */
+export declare function confirm(message: string): Promise<boolean>;
 /**
  * Read a line of input with masked output (shows * for each character).
  * Handles backspace and Ctrl+C.

package/dist/lib/prompt.js

@@ -1,4 +1,18 @@
 import { stdin, stdout } from 'node:process';
+import { createInterface } from 'node:readline';
+/**
+ * Prompt for yes/no confirmation. Returns true if user confirms.
+ * Defaults to 'no' if user just presses enter.
+ */
+export async function confirm(message) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    return new Promise((resolve) => {
+        rl.question(`${message} [y/N] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+        });
+    });
+}
 /**
  * Read a line of input with masked output (shows * for each character).
  * Handles backspace and Ctrl+C.

package/dist/lib/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7C;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE;YAC5B,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC/B,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC3B,SAAS;gBACT,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,KAAK,CAAC,GAAG,EAAE,CAAC;oBACZ,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,OAAe;IAC3C,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,EAAE,CAAC,QAAQ,CAAC,GAAG,OAAO,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE;YAC1C,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,CAAC,MAAM,EAAE,CAAC;QACf,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAE3B,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE;YAC5B,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC/B,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,KAAK,CAAC,KAAK,EAAE,CAAC;gBACd,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACrC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;gBAC3B,SAAS;gBACT,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC1C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,KAAK,CAAC,GAAG,EAAE,CAAC;oBACZ,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACxB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/spinner.d.ts

@@ -0,0 +1,14 @@
+export interface Spinner {
+    /** Update the spinner message */
+    update(message: string): void;
+    /** Stop spinner with success checkmark */
+    success(message?: string): void;
+    /** Stop spinner with failure X */
+    fail(message?: string): void;
+    /** Stop spinner without status icon */
+    stop(): void;
+}
+/**
+ * Create a terminal spinner. Returns no-op spinner if in JSON mode or non-TTY.
+ */
+export declare function createSpinner(message: string): Spinner;

package/dist/lib/spinner.js

@@ -0,0 +1,52 @@
+// Simple terminal spinner without external dependencies
+import { isJsonMode } from './output.js';
+const SPINNER_FRAMES = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+const FRAME_INTERVAL_MS = 80;
+/**
+ * Create a terminal spinner. Returns no-op spinner if in JSON mode or non-TTY.
+ */
+export function createSpinner(message) {
+    // Skip spinner in JSON mode or non-TTY environments
+    if (isJsonMode() || !process.stdout.isTTY) {
+        return {
+            update: () => { },
+            success: (msg) => msg && console.log(msg),
+            fail: (msg) => msg && console.error(msg),
+            stop: () => { },
+        };
+    }
+    let frameIndex = 0;
+    let currentMessage = message;
+    let stopped = false;
+    const render = () => {
+        if (stopped)
+            return;
+        const frame = SPINNER_FRAMES[frameIndex % SPINNER_FRAMES.length];
+        process.stdout.write(`\r\x1b[K${frame} ${currentMessage}`);
+        frameIndex++;
+    };
+    const interval = setInterval(render, FRAME_INTERVAL_MS);
+    render();
+    const clear = () => {
+        stopped = true;
+        clearInterval(interval);
+        process.stdout.write('\r\x1b[K');
+    };
+    return {
+        update(msg) {
+            currentMessage = msg;
+        },
+        success(msg) {
+            clear();
+            console.log(`\x1b[32m✓\x1b[0m ${msg ?? currentMessage}`);
+        },
+        fail(msg) {
+            clear();
+            console.log(`\x1b[31m✗\x1b[0m ${msg ?? currentMessage}`);
+        },
+        stop() {
+            clear();
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/lib/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA,wDAAwD;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,cAAc,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAC1E,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAa7B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe;IAC3C,oDAAoD;IACpD,IAAI,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1C,OAAO;YACL,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;YAChB,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YACzC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC;YACxC,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;SACf,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,cAAc,GAAG,OAAO,CAAC;IAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,OAAO;YAAE,OAAO;QACpB,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,cAAc,EAAE,CAAC,CAAC;QAC3D,UAAU,EAAE,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxD,MAAM,EAAE,CAAC;IAET,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,OAAO,GAAG,IAAI,CAAC;QACf,aAAa,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,CAAC,GAAW;YAChB,cAAc,GAAG,GAAG,CAAC;QACvB,CAAC;QACD,OAAO,CAAC,GAAY;YAClB,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,cAAc,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,GAAY;YACf,KAAK,EAAE,CAAC;YACR,OAAO,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,cAAc,EAAE,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI;YACF,KAAK,EAAE,CAAC;QACV,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/lib/version-check.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check npm registry for newer version. Returns update message or null.
+ * Never throws - fails silently on network errors.
+ */
+export declare function checkForUpdate(): Promise<string | null>;
+/**
+ * Print update notice if available. Non-blocking.
+ */
+export declare function printUpdateNotice(notice: string | null): void;

package/dist/lib/version-check.js

@@ -0,0 +1,54 @@
+// Version check utility - checks npm for newer CLI version
+// Runs asynchronously and never blocks or throws
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const { version: currentVersion } = require('../../package.json');
+const NPM_REGISTRY = 'https://registry.npmjs.org/@fold-run/cli/latest';
+const CHECK_TIMEOUT_MS = 2000;
+function compareVersions(current, latest) {
+    const c = current.split('.').map(Number);
+    const l = latest.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        if ((l[i] ?? 0) > (c[i] ?? 0))
+            return 1;
+        if ((l[i] ?? 0) < (c[i] ?? 0))
+            return -1;
+    }
+    return 0;
+}
+/**
+ * Check npm registry for newer version. Returns update message or null.
+ * Never throws - fails silently on network errors.
+ */
+export async function checkForUpdate() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), CHECK_TIMEOUT_MS);
+        const res = await fetch(NPM_REGISTRY, {
+            signal: controller.signal,
+            headers: { Accept: 'application/json' },
+        });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        const latestVersion = data.version;
+        if (compareVersions(currentVersion, latestVersion) > 0) {
+            return `\x1b[33mUpdate available:\x1b[0m ${currentVersion} → \x1b[32m${latestVersion}\x1b[0m\n  Run \x1b[36mnpm i -g @fold-run/cli\x1b[0m to update`;
+        }
+        return null;
+    }
+    catch {
+        // Network error, timeout, etc - fail silently
+        return null;
+    }
+}
+/**
+ * Print update notice if available. Non-blocking.
+ */
+export function printUpdateNotice(notice) {
+    if (notice) {
+        console.log(`\n${notice}\n`);
+    }
+}
+//# sourceMappingURL=version-check.js.map

package/dist/lib/version-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.js","sourceRoot":"","sources":["../../src/lib/version-check.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,iDAAiD;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAwB,CAAC;AAEzF,MAAM,YAAY,GAAG,iDAAiD,CAAC;AACvE,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAM9B,SAAS,eAAe,CAAC,OAAe,EAAE,MAAc;IACtD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;QAEvE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE;YACpC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;SACxC,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;QAC9C,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC;QAEnC,IAAI,eAAe,CAAC,cAAc,EAAE,aAAa,CAAC,GAAG,CAAC,EAAE,CAAC;YACvD,OAAO,oCAAoC,cAAc,cAAc,aAAa,gEAAgE,CAAC;QACvJ,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fold-run/cli",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "CLI for fold.run — deploy serverless functions with TypeScript bundling, secrets, and AI-powered code generation",
   "type": "module",
   "license": "MIT",