jamdesk 1.0.0

package/dist/lib/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/lib/openapi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,GAGf,MAAM,oBAAoB,CAAC"}

package/dist/lib/output.d.ts

@@ -0,0 +1,14 @@
+declare function success(text: string): void;
+declare function error(text: string): void;
+export declare const output: {
+    header: (text: string) => void;
+    success: typeof success;
+    error: typeof error;
+    warn: (text: string) => void;
+    info: (text: string) => void;
+    hint: (text: string) => void;
+    check: typeof success;
+    fail: typeof error;
+};
+export {};
+//# sourceMappingURL=output.d.ts.map

package/dist/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnC;AAED,iBAAS,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjC;AAED,eAAO,MAAM,MAAM;mBACF,MAAM;;;iBAGR,MAAM;iBACN,MAAM;iBACN,MAAM;;;CAIpB,CAAC"}

package/dist/lib/output.js

@@ -0,0 +1,19 @@
+import chalk from 'chalk';
+function success(text) {
+    console.log(chalk.green(`✓ ${text}`));
+}
+function error(text) {
+    console.log(chalk.red(`✗ ${text}`));
+}
+export const output = {
+    header: (text) => console.log(`\n${chalk.bold(text)}\n`),
+    success,
+    error,
+    warn: (text) => console.log(chalk.yellow(`⚠ ${text}`)),
+    info: (text) => console.log(chalk.blue(`ℹ ${text}`)),
+    hint: (text) => console.log(chalk.gray(`  ${text}`)),
+    // Aliases for semantic clarity
+    check: success,
+    fail: error,
+};
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAChE,OAAO;IACP,KAAK;IACL,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC9D,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,+BAA+B;IAC/B,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,KAAK;CACZ,CAAC"}

package/dist/lib/path-security.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Path Security Utilities
+ *
+ * Validates that file paths stay within the project directory
+ * to prevent path traversal attacks.
+ *
+ * Used by both CLI and build-service.
+ */
+/**
+ * Check if a path stays within the project directory.
+ * Returns true if path is within project, false otherwise.
+ */
+export declare function isPathWithinProject(filePath: string, projectDir: string): boolean;
+/**
+ * Validates that a path stays within the project directory.
+ * Throws Error if path would escape the project.
+ */
+export declare function validatePathWithinProject(filePath: string, projectDir: string): void;
+/**
+ * Validates both source and target paths for rename operations.
+ */
+export declare function validateRenamePaths(from: string, to: string, projectDir: string): void;
+//# sourceMappingURL=path-security.d.ts.map

package/dist/lib/path-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../../src/lib/path-security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAKjF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAIpF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAGtF"}

package/dist/lib/path-security.js

@@ -0,0 +1,35 @@
+/**
+ * Path Security Utilities
+ *
+ * Validates that file paths stay within the project directory
+ * to prevent path traversal attacks.
+ *
+ * Used by both CLI and build-service.
+ */
+import path from 'path';
+/**
+ * Check if a path stays within the project directory.
+ * Returns true if path is within project, false otherwise.
+ */
+export function isPathWithinProject(filePath, projectDir) {
+    const absolutePath = path.resolve(projectDir, filePath);
+    const normalizedProject = path.resolve(projectDir);
+    return absolutePath.startsWith(normalizedProject + path.sep) || absolutePath === normalizedProject;
+}
+/**
+ * Validates that a path stays within the project directory.
+ * Throws Error if path would escape the project.
+ */
+export function validatePathWithinProject(filePath, projectDir) {
+    if (!isPathWithinProject(filePath, projectDir)) {
+        throw new Error(`Path escapes project directory: ${filePath}`);
+    }
+}
+/**
+ * Validates both source and target paths for rename operations.
+ */
+export function validateRenamePaths(from, to, projectDir) {
+    validatePathWithinProject(from, projectDir);
+    validatePathWithinProject(to, projectDir);
+}
+//# sourceMappingURL=path-security.js.map

package/dist/lib/path-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-security.js","sourceRoot":"","sources":["../../src/lib/path-security.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,UAAkB;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnD,OAAO,YAAY,CAAC,UAAU,CAAC,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,YAAY,KAAK,iBAAiB,CAAC;AACrG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,UAAkB;IAC5E,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,EAAU,EAAE,UAAkB;IAC9E,yBAAyB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5C,yBAAyB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC"}

package/dist/lib/port.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Port Detection Utilities
+ *
+ * Cross-platform port availability checking using Node's net module.
+ * Works on Windows, macOS, and Linux without external dependencies.
+ */
+/**
+ * Check if a port is in use using Node's net module.
+ * Checks both IPv4 (0.0.0.0) and IPv6 (::) since Next.js binds to both.
+ * This is cross-platform (works on Windows, macOS, Linux).
+ */
+export declare function isPortInUse(port: number): Promise<boolean>;
+/**
+ * Find an available port starting from the preferred port.
+ * Tries up to maxAttempts sequential ports.
+ */
+export declare function findAvailablePort(preferredPort: number, maxAttempts?: number): Promise<number>;
+//# sourceMappingURL=port.d.ts.map

package/dist/lib/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/lib/port.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAahE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAahG"}

package/dist/lib/port.js

@@ -0,0 +1,65 @@
+/**
+ * Port Detection Utilities
+ *
+ * Cross-platform port availability checking using Node's net module.
+ * Works on Windows, macOS, and Linux without external dependencies.
+ */
+import net from 'net';
+/**
+ * Check if a port is in use on a specific host.
+ */
+function checkPort(port, host) {
+    return new Promise((resolve) => {
+        const server = net.createServer();
+        server.once('error', (err) => {
+            // EADDRNOTAVAIL means the address family isn't available (e.g., IPv6 disabled)
+            // In that case, don't count as "in use"
+            if (err.code === 'EADDRNOTAVAIL') {
+                resolve(false);
+            }
+            else {
+                resolve(true); // Port in use or other error
+            }
+        });
+        server.once('listening', () => {
+            server.close(() => {
+                resolve(false); // Port available
+            });
+        });
+        server.listen(port, host);
+    });
+}
+/**
+ * Check if a port is in use using Node's net module.
+ * Checks both IPv4 (0.0.0.0) and IPv6 (::) since Next.js binds to both.
+ * This is cross-platform (works on Windows, macOS, Linux).
+ */
+export async function isPortInUse(port) {
+    // Validate port range
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        return true; // Invalid port, treat as in use
+    }
+    // Check both IPv4 and IPv6 - port must be free on both
+    const [ipv4InUse, ipv6InUse] = await Promise.all([
+        checkPort(port, '0.0.0.0'),
+        checkPort(port, '::'),
+    ]);
+    return ipv4InUse || ipv6InUse;
+}
+/**
+ * Find an available port starting from the preferred port.
+ * Tries up to maxAttempts sequential ports.
+ */
+export async function findAvailablePort(preferredPort, maxAttempts = 10) {
+    let port = preferredPort;
+    for (let i = 0; i < maxAttempts; i++) {
+        const inUse = await isPortInUse(port);
+        if (!inUse) {
+            return port;
+        }
+        port++;
+    }
+    // If all ports in range are taken, return the preferred and let it fail with a clear error
+    return preferredPort;
+}
+//# sourceMappingURL=port.js.map

package/dist/lib/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../src/lib/port.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB;;GAEG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC3C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;QAElC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;YAClD,+EAA+E;YAC/E,wCAAwC;YACxC,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;gBACjC,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,6BAA6B;YAC9C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;gBAChB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,sBAAsB;IACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,OAAO,IAAI,CAAC,CAAC,gCAAgC;IAC/C,CAAC;IAED,uDAAuD;IACvD,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC/C,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC;QAC1B,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;KACtB,CAAC,CAAC;IAEH,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,EAAE,WAAW,GAAG,EAAE;IAC7E,IAAI,IAAI,GAAG,aAAa,CAAC;IAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,EAAE,CAAC;IACT,CAAC;IAED,2FAA2F;IAC3F,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/dist/lib/spinner.d.ts

@@ -0,0 +1,4 @@
+import { type Ora } from 'ora';
+export declare function spinner(text: string): Ora;
+export declare function stopSpinner(): void;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/lib/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/lib/spinner.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAIpC,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAMzC;AAED,wBAAgB,WAAW,IAAI,IAAI,CAKlC"}

package/dist/lib/spinner.js

@@ -0,0 +1,16 @@
+import ora from 'ora';
+let currentSpinner = null;
+export function spinner(text) {
+    if (currentSpinner) {
+        currentSpinner.stop();
+    }
+    currentSpinner = ora(text).start();
+    return currentSpinner;
+}
+export function stopSpinner() {
+    if (currentSpinner) {
+        currentSpinner.stop();
+        currentSpinner = null;
+    }
+}
+//# 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,OAAO,GAAiB,MAAM,KAAK,CAAC;AAEpC,IAAI,cAAc,GAAe,IAAI,CAAC;AAEtC,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,IAAI,EAAE,CAAC;IACxB,CAAC;IACD,cAAc,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IACnC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,IAAI,cAAc,EAAE,CAAC;QACnB,cAAc,CAAC,IAAI,EAAE,CAAC;QACtB,cAAc,GAAG,IAAI,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/lib/version.d.ts

@@ -0,0 +1,2 @@
+export declare function checkForUpdates(currentVersion: string): Promise<void>;
+//# sourceMappingURL=version.d.ts.map

package/dist/lib/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAYA,wBAAsB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+C3E"}

package/dist/lib/version.js

@@ -0,0 +1,49 @@
+import fs from 'fs';
+import path from 'path';
+import { homedir } from 'os';
+const CACHE_FILE = path.join(homedir(), '.jamdesk', 'version-cache.json');
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+export async function checkForUpdates(currentVersion) {
+    try {
+        // Check cache first
+        if (fs.existsSync(CACHE_FILE)) {
+            const cacheContent = fs.readFileSync(CACHE_FILE, 'utf-8');
+            const cache = JSON.parse(cacheContent);
+            if (Date.now() - cache.timestamp < CACHE_TTL) {
+                // Only show update if cache has valid version and it differs
+                if (cache.latest && cache.latest !== currentVersion) {
+                    console.log(`\nUpdate available: ${currentVersion} → ${cache.latest}`);
+                    console.log('Run `jamdesk update` to update\n');
+                }
+                return;
+            }
+        }
+        // Fetch latest version from npm (with timeout)
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const res = await fetch('https://registry.npmjs.org/jamdesk/latest', {
+            signal: controller.signal,
+        });
+        clearTimeout(timeout);
+        const data = await res.json();
+        const latest = data.version;
+        // Skip if package not found on npm (not published yet)
+        if (!latest) {
+            return;
+        }
+        // Cache result
+        const cacheDir = path.dirname(CACHE_FILE);
+        if (!fs.existsSync(cacheDir)) {
+            fs.mkdirSync(cacheDir, { recursive: true });
+        }
+        fs.writeFileSync(CACHE_FILE, JSON.stringify({ latest, timestamp: Date.now() }));
+        if (latest !== currentVersion) {
+            console.log(`\nUpdate available: ${currentVersion} → ${latest}`);
+            console.log('Run `jamdesk update` to update\n');
+        }
+    }
+    catch {
+        // Silently fail - don't block CLI for version check
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/lib/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/lib/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAC1E,MAAM,SAAS,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AAOlD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,cAAsB;IAC1D,IAAI,CAAC;QACH,oBAAoB;QACpB,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,YAAY,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAiB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,SAAS,EAAE,CAAC;gBAC7C,6DAA6D;gBAC7D,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;oBACpD,OAAO,CAAC,GAAG,CAAC,uBAAuB,cAAc,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;oBACvE,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;gBAClD,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC;QAED,+CAA+C;QAC/C,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QAE3D,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,2CAA2C,EAAE;YACnE,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0B,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAE5B,uDAAuD;QACvD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,eAAe;QACf,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7B,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;QAEhF,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,uBAAuB,cAAc,MAAM,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,oDAAoD;IACtD,CAAC;AACH,CAAC"}

package/dist/utils/update-checker.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Update Checker
+ *
+ * Automatically checks for CLI updates and notifies users.
+ * Features:
+ * - 24-hour cache to avoid excessive network calls
+ * - Non-blocking with 3-second timeout
+ * - Respects CI and JAMDESK_NO_UPDATE_CHECK environments
+ * - Shows styled update notice when new version available
+ */
+export interface CheckOptions {
+    force?: boolean;
+    silent?: boolean;
+}
+/**
+ * Compare semantic versions
+ * Returns true if latest is newer than current
+ */
+export declare function isNewerVersion(latest: string, current: string): boolean;
+/**
+ * Check for updates and optionally display notice
+ *
+ * @param currentVersion - Current CLI version
+ * @param options - Check options (force, silent)
+ */
+export declare function checkForUpdates(currentVersion: string, options?: CheckOptions): Promise<{
+    hasUpdate: boolean;
+    latestVersion: string | null;
+}>;
+/**
+ * Clear update cache (useful for testing)
+ */
+export declare function clearUpdateCache(): void;
+//# sourceMappingURL=update-checker.d.ts.map

package/dist/utils/update-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-checker.d.ts","sourceRoot":"","sources":["../../src/utils/update-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAWvE;AA2CD;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAqD/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CASvC"}

package/dist/utils/update-checker.js

@@ -0,0 +1,142 @@
+/**
+ * Update Checker
+ *
+ * Automatically checks for CLI updates and notifies users.
+ * Features:
+ * - 24-hour cache to avoid excessive network calls
+ * - Non-blocking with 3-second timeout
+ * - Respects CI and JAMDESK_NO_UPDATE_CHECK environments
+ * - Shows styled update notice when new version available
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
+import { join } from 'path';
+import chalk from 'chalk';
+const CACHE_DIR = join(homedir(), '.jamdesk');
+const CACHE_FILE = join(CACHE_DIR, 'update-cache.json');
+const CHECK_INTERVAL = 24 * 60 * 60 * 1000; // 24 hours
+const NPM_REGISTRY = 'https://registry.npmjs.org/jamdesk';
+/**
+ * Compare semantic versions
+ * Returns true if latest is newer than current
+ */
+export function isNewerVersion(latest, current) {
+    const latestParts = latest.split('.').map(Number);
+    const currentParts = current.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const l = latestParts[i] || 0;
+        const c = currentParts[i] || 0;
+        if (l > c)
+            return true;
+        if (l < c)
+            return false;
+    }
+    return false;
+}
+/**
+ * Print styled update notice
+ */
+function printUpdateNotice(current, latest) {
+    console.log();
+    console.log(chalk.yellow('╭─────────────────────────────────────────────────────────╮'));
+    console.log(chalk.yellow('│') + '  Update available: ' + chalk.gray(current) + ' → ' + chalk.green(latest) + '                ' + chalk.yellow('│'));
+    console.log(chalk.yellow('│') + '  Run: ' + chalk.cyan('curl -fsSL https://get.jamdesk.com/upgrade | bash') + '  ' + chalk.yellow('│'));
+    console.log(chalk.yellow('│') + '  Or:  ' + chalk.cyan('npm install -g jamdesk@latest') + '                    ' + chalk.yellow('│'));
+    console.log(chalk.yellow('╰─────────────────────────────────────────────────────────╯'));
+    console.log();
+}
+/**
+ * Read cached version info
+ */
+function readCache() {
+    try {
+        if (existsSync(CACHE_FILE)) {
+            return JSON.parse(readFileSync(CACHE_FILE, 'utf-8'));
+        }
+    }
+    catch {
+        // Ignore cache read errors
+    }
+    return { lastCheck: 0, latestVersion: null };
+}
+/**
+ * Write version info to cache
+ */
+function writeCache(cache) {
+    try {
+        if (!existsSync(CACHE_DIR)) {
+            mkdirSync(CACHE_DIR, { recursive: true });
+        }
+        writeFileSync(CACHE_FILE, JSON.stringify(cache));
+    }
+    catch {
+        // Ignore cache write errors
+    }
+}
+/**
+ * Check for updates and optionally display notice
+ *
+ * @param currentVersion - Current CLI version
+ * @param options - Check options (force, silent)
+ */
+export async function checkForUpdates(currentVersion, options = {}) {
+    const { force = false, silent = false } = options;
+    // Skip in CI environments
+    if (process.env.CI || process.env.JAMDESK_NO_UPDATE_CHECK) {
+        return { hasUpdate: false, latestVersion: null };
+    }
+    const cache = readCache();
+    const now = Date.now();
+    // Check cache unless forced
+    if (!force && cache.lastCheck && (now - cache.lastCheck) < CHECK_INTERVAL) {
+        if (cache.latestVersion && isNewerVersion(cache.latestVersion, currentVersion)) {
+            if (!silent) {
+                printUpdateNotice(currentVersion, cache.latestVersion);
+            }
+            return { hasUpdate: true, latestVersion: cache.latestVersion };
+        }
+        return { hasUpdate: false, latestVersion: cache.latestVersion };
+    }
+    // Fetch latest version (non-blocking, with timeout)
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000); // 3s timeout
+        const response = await fetch(NPM_REGISTRY, {
+            signal: controller.signal,
+            headers: { 'Accept': 'application/json' }
+        });
+        clearTimeout(timeout);
+        if (response.ok) {
+            const data = await response.json();
+            const latestVersion = data['dist-tags']?.latest || null;
+            writeCache({ lastCheck: now, latestVersion });
+            if (latestVersion && isNewerVersion(latestVersion, currentVersion)) {
+                if (!silent) {
+                    printUpdateNotice(currentVersion, latestVersion);
+                }
+                return { hasUpdate: true, latestVersion };
+            }
+            return { hasUpdate: false, latestVersion };
+        }
+    }
+    catch {
+        // Silently fail - don't block CLI usage
+        writeCache({ lastCheck: now, latestVersion: cache.latestVersion });
+    }
+    return { hasUpdate: false, latestVersion: null };
+}
+/**
+ * Clear update cache (useful for testing)
+ */
+export function clearUpdateCache() {
+    try {
+        if (existsSync(CACHE_FILE)) {
+            const { unlinkSync } = require('fs');
+            unlinkSync(CACHE_FILE);
+        }
+    }
+    catch {
+        // Ignore errors
+    }
+}
+//# sourceMappingURL=update-checker.js.map

package/dist/utils/update-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-checker.js","sourceRoot":"","sources":["../../src/utils/update-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,MAAM,OAAO,CAAC;AAO1B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AACxD,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AACvD,MAAM,YAAY,GAAG,oCAAoC,CAAC;AAO1D;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAe;IAC5D,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAEpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAe,EAAE,MAAc;IACxD,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,sBAAsB,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,kBAAkB,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACrJ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,mDAAmD,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACxI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,GAAG,sBAAsB,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtI,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,6DAA6D,CAAC,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CAAC,KAAkB;IACpC,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,4BAA4B;IAC9B,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,cAAsB,EACtB,UAAwB,EAAE;IAE1B,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,MAAM,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAElD,0BAA0B;IAC1B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,CAAC;QAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,4BAA4B;IAC5B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,cAAc,EAAE,CAAC;QAC1E,IAAI,KAAK,CAAC,aAAa,IAAI,cAAc,CAAC,KAAK,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;YAC/E,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,iBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC;IAClE,CAAC;IAED,oDAAoD;IACpD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,aAAa;QAEzE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE;YACzC,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,OAAO,EAAE,EAAE,QAAQ,EAAE,kBAAkB,EAAE;SAC1C,CAAC,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,CAAC;QAEtB,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;YAChB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA2C,CAAC;YAC5E,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;YAExD,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;YAE9C,IAAI,aAAa,IAAI,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,EAAE,CAAC;gBACnE,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,iBAAiB,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;gBACnD,CAAC;gBACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;YAC5C,CAAC;YACD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;QACxC,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,UAAU,CAAC,UAAU,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,125 @@
+{
+  "name": "jamdesk",
+  "version": "1.0.0",
+  "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
+  "keywords": [
+    "jamdesk",
+    "documentation",
+    "documentation-generator",
+    "documentation-platform",
+    "docs",
+    "docs-as-code",
+    "mdx",
+    "markdown",
+    "cli",
+    "dev-server",
+    "hot-reload",
+    "turbopack",
+    "developer-tools",
+    "api-documentation",
+    "openapi",
+    "api-reference",
+    "static-site",
+    "nextjs",
+    "technical-writing",
+    "mintlify",
+    "mintlify-alternative",
+    "documentation-hosting",
+    "documentation-site",
+    "developer-documentation",
+    "api-docs",
+    "react-components",
+    "docs-site-generator",
+    "ai-search"
+  ],
+  "homepage": "https://jamdesk.com",
+  "bugs": {
+    "url": "https://github.com/jamdesk/jamdesk/issues",
+    "email": "support@jamdesk.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jamdesk/jamdesk.git",
+    "directory": "builder/cli"
+  },
+  "license": "MIT",
+  "author": {
+    "name": "Jamdesk",
+    "email": "hello@jamdesk.com",
+    "url": "https://jamdesk.com"
+  },
+  "type": "module",
+  "bin": {
+    "jamdesk": "./bin/jamdesk.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "bin/",
+    "dist/",
+    "templates/",
+    "vendored/components/",
+    "vendored/contexts/",
+    "vendored/hooks/",
+    "vendored/themes/",
+    "vendored/lib/",
+    "vendored/shared/",
+    "vendored/scripts/",
+    "vendored/app/",
+    "vendored/public/images/jamdesk/",
+    "vendored/public/fonts/fontawesome/",
+    "vendored/schema/",
+    "vendored/next.config.js",
+    "vendored/tailwind.config.ts",
+    "vendored/postcss.config.js",
+    "vendored/tsconfig.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "vendor": "node scripts/vendor.js",
+    "security-check": "node scripts/security-check.js",
+    "prepublishOnly": "npm run vendor && npm run build && npm run security-check",
+    "publish:npm": "node scripts/publish.js npm",
+    "publish:github": "node scripts/publish.js github",
+    "publish:dry": "node scripts/publish.js npm --dry-run",
+    "test": "vitest",
+    "test:local": "node scripts/test-local.js",
+    "lint": "eslint src/",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@apidevtools/swagger-parser": "^12.1.0",
+    "@inquirer/prompts": "^8.1.0",
+    "ajv": "^8.17.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "fastest-levenshtein": "^1.0.16",
+    "fs-extra": "^11.2.0",
+    "glob": "^11.0.0",
+    "json5": "^2.2.3",
+    "ora": "^8.0.0"
+  },
+  "devDependencies": {
+    "@mdx-js/mdx": "^3.1.1",
+    "@types/fs-extra": "^11.0.0",
+    "@types/node": "^20.0.0",
+    "gray-matter": "^4.0.3",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}

package/templates/docs.json

@@ -0,0 +1,11 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "navigation": {
+    "groups": [
+      {
+        "group": "Getting Started",
+        "pages": ["introduction", "quickstart"]
+      }
+    ]
+  }
+}

package/templates/introduction.mdx

@@ -0,0 +1,19 @@
+---
+title: Introduction
+description: Welcome to your documentation
+---
+
+# Welcome to {{PROJECT_NAME}}
+
+This is your new documentation site powered by Jamdesk.
+
+## Getting Started
+
+Edit this file to customize your documentation. Add new MDX files and update `docs.json` to add them to the navigation.
+
+## Features
+
+- **MDX Support** - Write documentation with React components
+- **Hot Reload** - See changes instantly during development
+- **Search** - Full-text search built in
+- **Themes** - Choose from multiple themes