bkper 3.8.1 → 4.0.0

package/lib/dev/cloudflared/tunnel.js

@@ -0,0 +1,109 @@
+import { spawn } from 'child_process';
+import { EventEmitter } from 'events';
+import { bin } from './constants.js';
+/**
+ * Regex patterns for parsing cloudflared output.
+ */
+const TRYCLOUDFLARE_URL_REGEX = /https:\/\/[^\s]+\.trycloudflare\.com/;
+const CONNECTION_REGEX = /Connection ([a-f0-9-]+) registered with protocol: .* connIndex=\d+ ip=([\d.]+) location=(\w+)/;
+const DISCONNECTION_REGEX = /Unregistered tunnel connection connIndex=\d+ ip=([\d.]+)/;
+/**
+ * Manages a cloudflared tunnel process.
+ */
+export class Tunnel extends EventEmitter {
+    constructor(args) {
+        super();
+        this._url = null;
+        this._process = this.createProcess(args);
+        this.setupEventHandlers();
+    }
+    /**
+     * The underlying child process.
+     */
+    get process() {
+        return this._process;
+    }
+    /**
+     * The assigned tunnel URL, if available.
+     */
+    get url() {
+        return this._url;
+    }
+    createProcess(args) {
+        var _a, _b;
+        const child = spawn(bin, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        child.on('error', error => this.emit('error', error));
+        child.on('exit', (code, signal) => this.emit('exit', code, signal));
+        (_a = child.stdout) === null || _a === void 0 ? void 0 : _a.on('data', data => this.emit('stdout', data.toString()));
+        (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on('data', data => this.emit('stderr', data.toString()));
+        return child;
+    }
+    setupEventHandlers() {
+        // cloudflared outputs to stderr primarily
+        const handleOutput = (output) => {
+            // Check for URL assignment
+            const urlMatch = output.match(TRYCLOUDFLARE_URL_REGEX);
+            if (urlMatch && !this._url) {
+                this._url = urlMatch[0];
+                this.emit('url', this._url);
+            }
+            // Check for connection
+            const connMatch = output.match(CONNECTION_REGEX);
+            if (connMatch) {
+                this.emit('connected', {
+                    id: connMatch[1],
+                    ip: connMatch[2],
+                    location: connMatch[3],
+                });
+            }
+            // Check for disconnection
+            const disconnMatch = output.match(DISCONNECTION_REGEX);
+            if (disconnMatch) {
+                this.emit('disconnected', {
+                    id: '',
+                    ip: disconnMatch[1],
+                    location: '',
+                });
+            }
+        };
+        this.on('stdout', handleOutput);
+        this.on('stderr', handleOutput);
+    }
+    /**
+     * Stops the tunnel process.
+     */
+    stop() {
+        return this._process.kill('SIGINT');
+    }
+    // Type-safe event emitter methods
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+    emit(event, ...args) {
+        return super.emit(event, ...args);
+    }
+    /**
+     * Creates a Quick Tunnel (no Cloudflare account required).
+     *
+     * @param url - The local URL to tunnel (e.g., 'http://localhost:8080').
+     *              If not provided, uses cloudflared's hello-world mode.
+     * @returns A new Tunnel instance.
+     */
+    static quick(url) {
+        const args = ['tunnel'];
+        if (url) {
+            args.push('--url', url);
+        }
+        else {
+            args.push('--hello-world');
+        }
+        return new Tunnel(args);
+    }
+}
+//# sourceMappingURL=tunnel.js.map

package/lib/dev/cloudflared/tunnel.js.map

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

package/lib/dev/esbuild.d.ts

@@ -0,0 +1,28 @@
+import * as esbuild from 'esbuild';
+/**
+ * Plugin to externalize cloudflare:* and node:* imports.
+ * These are provided by the Workers runtime and should not be bundled.
+ */
+export declare const workersExternalsPlugin: esbuild.Plugin;
+/**
+ * Builds a Worker and returns the bundled code as a string.
+ * Used for Miniflare integration (in-memory).
+ *
+ * Configuration rationale:
+ * - target: es2024 - Workers runtime uses V8 with ES2024 support (not esnext)
+ * - format: esm - Modern Workers require ES Modules
+ * - conditions: ['workerd', 'worker', 'browser'] - Critical for package resolution
+ *
+ * @param entryPoint - Path to TypeScript entry file
+ * @returns The bundled JavaScript code as a string
+ */
+export declare function buildWorker(entryPoint: string): Promise<string>;
+/**
+ * Builds a Worker and writes to a file.
+ * Used for deployment builds.
+ *
+ * @param entryPoint - Path to TypeScript entry file
+ * @param outfile - Path to output JavaScript file
+ */
+export declare function buildWorkerToFile(entryPoint: string, outfile: string): Promise<void>;
+//# sourceMappingURL=esbuild.d.ts.map

package/lib/dev/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","sourceRoot":"","sources":["../../src/dev/esbuild.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,MAS5C,CAAC;AAsBF;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa1F"}

package/lib/dev/esbuild.js

@@ -0,0 +1,83 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as esbuild from 'esbuild';
+import fs from 'fs';
+import path from 'path';
+/**
+ * Plugin to externalize cloudflare:* and node:* imports.
+ * These are provided by the Workers runtime and should not be bundled.
+ */
+export const workersExternalsPlugin = {
+    name: 'workers-externals',
+    setup(build) {
+        // Cloudflare-specific imports (Durable Objects, Sockets, etc.)
+        build.onResolve({ filter: /^cloudflare:.*/ }, () => ({ external: true }));
+        // Node.js built-in modules (when using nodejs_compat)
+        build.onResolve({ filter: /^node:.*/ }, () => ({ external: true }));
+    },
+};
+/**
+ * Shared esbuild configuration for Cloudflare Workers.
+ *
+ * Configuration rationale:
+ * - target: es2024 - Workers runtime uses V8 with ES2024 support (not esnext)
+ * - format: esm - Modern Workers require ES Modules
+ * - conditions: ['workerd', 'worker', 'browser'] - Critical for package resolution
+ */
+function getBaseConfig(entryPoint) {
+    return {
+        entryPoints: [entryPoint],
+        bundle: true,
+        format: 'esm',
+        target: 'es2024',
+        conditions: ['workerd', 'worker', 'browser'],
+        plugins: [workersExternalsPlugin],
+        minify: process.env.NODE_ENV === 'production',
+    };
+}
+/**
+ * Builds a Worker and returns the bundled code as a string.
+ * Used for Miniflare integration (in-memory).
+ *
+ * Configuration rationale:
+ * - target: es2024 - Workers runtime uses V8 with ES2024 support (not esnext)
+ * - format: esm - Modern Workers require ES Modules
+ * - conditions: ['workerd', 'worker', 'browser'] - Critical for package resolution
+ *
+ * @param entryPoint - Path to TypeScript entry file
+ * @returns The bundled JavaScript code as a string
+ */
+export function buildWorker(entryPoint) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const result = yield esbuild.build(Object.assign(Object.assign({}, getBaseConfig(entryPoint)), { write: false, sourcemap: 'inline' }));
+        if (!result.outputFiles || result.outputFiles.length === 0) {
+            throw new Error('Build produced no output files');
+        }
+        return result.outputFiles[0].text;
+    });
+}
+/**
+ * Builds a Worker and writes to a file.
+ * Used for deployment builds.
+ *
+ * @param entryPoint - Path to TypeScript entry file
+ * @param outfile - Path to output JavaScript file
+ */
+export function buildWorkerToFile(entryPoint, outfile) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Ensure parent directory exists
+        const outDir = path.dirname(outfile);
+        if (!fs.existsSync(outDir)) {
+            fs.mkdirSync(outDir, { recursive: true });
+        }
+        yield esbuild.build(Object.assign(Object.assign({}, getBaseConfig(entryPoint)), { outfile, write: true, sourcemap: true }));
+    });
+}
+//# sourceMappingURL=esbuild.js.map

package/lib/dev/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../../src/dev/esbuild.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAmB;IAClD,IAAI,EAAE,mBAAmB;IACzB,KAAK,CAAC,KAAK;QACP,+DAA+D;QAC/D,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1E,sDAAsD;QACtD,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;CACJ,CAAC;AAEF;;;;;;;GAOG;AACH,SAAS,aAAa,CAAC,UAAkB;IACrC,OAAO;QACH,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,QAAQ;QAChB,UAAU,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC;QAC5C,OAAO,EAAE,CAAC,sBAAsB,CAAC;QACjC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;KAChD,CAAC;AACN,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAgB,WAAW,CAAC,UAAkB;;QAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,iCAC3B,aAAa,CAAC,UAAU,CAAC,KAC5B,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,QAAQ,IACrB,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,iBAAiB,CAAC,UAAkB,EAAE,OAAe;;QACvE,iCAAiC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,EAAE,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,CAAC,KAAK,iCACZ,aAAa,CAAC,UAAU,CAAC,KAC5B,OAAO,EACP,KAAK,EAAE,IAAI,EACX,SAAS,EAAE,IAAI,IACjB,CAAC;IACP,CAAC;CAAA"}

package/lib/dev/logger.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Logger utilities for dev server output
+ * Provides prefixed, colored output for different subsystems
+ */
+export type LogPrefix = 'server' | 'events' | 'client' | 'build' | 'types' | 'shared';
+export interface Logger {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+}
+/**
+ * Creates a logger with a specific prefix
+ * @param prefix - The prefix to show in brackets (e.g., "server", "events")
+ * @returns Logger instance with info, success, warn, error, and debug methods
+ */
+export declare function createLogger(prefix: LogPrefix): Logger;
+/**
+ * Formats file size in human-readable format (B, KB, MB)
+ * @param bytes - Size in bytes
+ * @returns Formatted string with appropriate unit
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Logs startup banner for the dev server
+ * @param options - URLs for client, server, and events endpoints
+ */
+export declare function logDevServerBanner(options: {
+    clientUrl?: string;
+    tunnelUrl?: string;
+}): void;
+/**
+ * Logs build results with file sizes
+ * @param results - Build output paths and sizes
+ */
+export declare function logBuildResults(results: {
+    webClient?: {
+        path: string;
+        size: number;
+    };
+    webServer?: {
+        path: string;
+        size: number;
+    };
+    events?: {
+        path: string;
+        size: number;
+    };
+}): void;
+//# sourceMappingURL=logger.d.ts.map

package/lib/dev/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/dev/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEtF,MAAM,WAAW,MAAM;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAiBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAuBtD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAYhD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAgB5F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACrC,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,SAAS,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,GAAG,IAAI,CAgCP"}

package/lib/dev/logger.js

@@ -0,0 +1,102 @@
+/**
+ * Logger utilities for dev server output
+ * Provides prefixed, colored output for different subsystems
+ */
+/**
+ * Icon mapping for different log types
+ */
+const icons = {
+    success: '\u2705',
+    warn: '\u26A0\uFE0F ',
+    error: '\u274C',
+    reload: '\uD83D\uDD04',
+    build: '\uD83D\uDD28',
+    deploy: '\uD83D\uDE80',
+    change: '\uD83D\uDCDD',
+    package: '\uD83D\uDCE6',
+    rocket: '\uD83D\uDE80',
+};
+/**
+ * Creates a logger with a specific prefix
+ * @param prefix - The prefix to show in brackets (e.g., "server", "events")
+ * @returns Logger instance with info, success, warn, error, and debug methods
+ */
+export function createLogger(prefix) {
+    const formatMessage = (message, icon) => {
+        const iconPart = icon ? `${icon} ` : '';
+        return `[${prefix}] ${iconPart}${message}`;
+    };
+    return {
+        info(message) {
+            console.log(formatMessage(message));
+        },
+        success(message) {
+            console.log(formatMessage(message, icons.success));
+        },
+        warn(message) {
+            console.warn(formatMessage(message, icons.warn));
+        },
+        error(message) {
+            console.error(formatMessage(message, icons.error));
+        },
+        debug(message) {
+            console.log(formatMessage(message));
+        },
+    };
+}
+/**
+ * Formats file size in human-readable format (B, KB, MB)
+ * @param bytes - Size in bytes
+ * @returns Formatted string with appropriate unit
+ */
+export function formatSize(bytes) {
+    if (bytes < 1024) {
+        return `${bytes} B`;
+    }
+    const kb = bytes / 1024;
+    if (kb < 1024) {
+        return `${kb.toFixed(1)} KB`;
+    }
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)} MB`;
+}
+/**
+ * Logs startup banner for the dev server
+ * @param options - URLs for client, server, and events endpoints
+ */
+export function logDevServerBanner(options) {
+    console.log('');
+    console.log(`${icons.rocket} Bkper App Development Server`);
+    console.log('');
+    if (options.clientUrl) {
+        console.log(`   ${options.clientUrl}`);
+    }
+    if (options.tunnelUrl) {
+        console.log(`   Events:  ${options.tunnelUrl} (tunneled)`);
+    }
+    console.log('');
+    console.log('   Press Ctrl+C to stop');
+    console.log('');
+}
+/**
+ * Logs build results with file sizes
+ * @param results - Build output paths and sizes
+ */
+export function logBuildResults(results) {
+    console.log('');
+    console.log(`${icons.package} Building Bkper App...`);
+    console.log('');
+    if (results.webClient) {
+        console.log(`   \u2713 Web client    \u2192 ${results.webClient.path.padEnd(20)} (${formatSize(results.webClient.size)})`);
+    }
+    if (results.webServer) {
+        console.log(`   \u2713 Web server    \u2192 ${results.webServer.path.padEnd(20)} (${formatSize(results.webServer.size)})`);
+    }
+    if (results.events) {
+        console.log(`   \u2713 Events        \u2192 ${results.events.path.padEnd(20)} (${formatSize(results.events.size)})`);
+    }
+    console.log('');
+    console.log(`${icons.success} Build complete`);
+    console.log('');
+}
+//# sourceMappingURL=logger.js.map

package/lib/dev/logger.js.map

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

package/lib/dev/miniflare.d.ts

@@ -0,0 +1,32 @@
+import { Miniflare } from 'miniflare';
+export interface WorkerServerOptions {
+    port: number;
+    kvNamespaces?: string[];
+    vars?: Record<string, string>;
+    compatibilityDate?: string;
+    persist?: boolean;
+    persistPath?: string;
+}
+/**
+ * Creates and starts a Miniflare instance for local Worker development
+ *
+ * @param entryPoint - Path to TypeScript Worker entry file
+ * @param options - Server configuration options
+ * @returns Configured and ready Miniflare instance
+ */
+export declare function createWorkerServer(entryPoint: string, options: WorkerServerOptions): Promise<Miniflare>;
+/**
+ * Reloads a Worker with new code (hot reload)
+ * Rebuilds the entry point and updates Miniflare
+ *
+ * @param mf - Existing Miniflare instance
+ * @param entryPoint - Path to TypeScript Worker entry file
+ */
+export declare function reloadWorker(mf: Miniflare, entryPoint: string): Promise<void>;
+/**
+ * Gracefully stops a Miniflare instance
+ *
+ * @param mf - Miniflare instance to stop
+ */
+export declare function stopWorkerServer(mf: Miniflare): Promise<void>;
+//# sourceMappingURL=miniflare.d.ts.map

package/lib/dev/miniflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniflare.d.ts","sourceRoot":"","sources":["../../src/dev/miniflare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAiB,MAAM,WAAW,CAAC;AAGrD,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAuBD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAqDpB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BnF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnE"}

package/lib/dev/miniflare.js

@@ -0,0 +1,111 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { Miniflare, Log, LogLevel } from 'miniflare';
+import { buildWorker } from './esbuild.js';
+/**
+ * Store the base configuration for each Miniflare instance to support hot reload.
+ * Maps Miniflare instance to its base configuration (without modules).
+ */
+const instanceConfigs = new WeakMap();
+/**
+ * Creates and starts a Miniflare instance for local Worker development
+ *
+ * @param entryPoint - Path to TypeScript Worker entry file
+ * @param options - Server configuration options
+ * @returns Configured and ready Miniflare instance
+ */
+export function createWorkerServer(entryPoint, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        // Build the Worker code from TypeScript
+        const script = yield buildWorker(entryPoint);
+        // Build the base configuration (without modules) for hot reload support
+        const baseConfig = {
+            // Server port
+            port: options.port,
+            // Compatibility settings (match production)
+            compatibilityDate: options.compatibilityDate || '2026-01-29',
+            compatibilityFlags: ['nodejs_compat'],
+            // Logging
+            log: new Log(LogLevel.INFO),
+            // Live reload (inject script into HTML responses)
+            liveReload: true,
+            // KV namespaces - convert array to object format
+            // ["KV"] -> { KV: "kv-local" }
+            kvNamespaces: (_a = options.kvNamespaces) === null || _a === void 0 ? void 0 : _a.reduce((acc, ns) => (Object.assign(Object.assign({}, acc), { [ns]: `${ns.toLowerCase()}-local` })), {}),
+            // Persist KV data across restarts
+            kvPersist: options.persist !== false ? (_b = options.persistPath) !== null && _b !== void 0 ? _b : './.mf/kv' : undefined,
+            // Environment variables and secrets
+            bindings: options.vars,
+        };
+        const mf = new Miniflare(Object.assign(Object.assign({}, baseConfig), { 
+            // Use modules array format instead of script string
+            // This allows Miniflare to properly handle dynamic imports of external modules
+            // like cloudflare:workers that are used by libraries (e.g., Hono)
+            modules: [
+                {
+                    type: 'ESModule',
+                    path: 'index.js', // Virtual path for the bundled module
+                    contents: script,
+                },
+            ] }));
+        // Store the base config for hot reload
+        instanceConfigs.set(mf, baseConfig);
+        // Wait for Miniflare to be ready
+        yield mf.ready;
+        return mf;
+    });
+}
+/**
+ * Reloads a Worker with new code (hot reload)
+ * Rebuilds the entry point and updates Miniflare
+ *
+ * @param mf - Existing Miniflare instance
+ * @param entryPoint - Path to TypeScript Worker entry file
+ */
+export function reloadWorker(mf, entryPoint) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const script = yield buildWorker(entryPoint);
+        // Retrieve the stored base config
+        const baseConfig = instanceConfigs.get(mf);
+        if (!baseConfig) {
+            // Fallback: use minimal config if no stored config (shouldn't happen normally)
+            yield mf.setOptions({
+                modules: [
+                    {
+                        type: 'ESModule',
+                        path: 'index.js',
+                        contents: script,
+                    },
+                ],
+            });
+            return;
+        }
+        // Apply the full config with new modules
+        yield mf.setOptions(Object.assign(Object.assign({}, baseConfig), { modules: [
+                {
+                    type: 'ESModule',
+                    path: 'index.js',
+                    contents: script,
+                },
+            ] }));
+    });
+}
+/**
+ * Gracefully stops a Miniflare instance
+ *
+ * @param mf - Miniflare instance to stop
+ */
+export function stopWorkerServer(mf) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield mf.dispose();
+    });
+}
+//# sourceMappingURL=miniflare.js.map

package/lib/dev/miniflare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miniflare.js","sourceRoot":"","sources":["../../src/dev/miniflare.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA0B3C;;;GAGG;AACH,MAAM,eAAe,GAAG,IAAI,OAAO,EAAyB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,UAAgB,kBAAkB,CACpC,UAAkB,EAClB,OAA4B;;;QAE5B,wCAAwC;QACxC,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QAE7C,wEAAwE;QACxE,MAAM,UAAU,GAAe;YAC3B,cAAc;YACd,IAAI,EAAE,OAAO,CAAC,IAAI;YAElB,4CAA4C;YAC5C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,IAAI,YAAY;YAC5D,kBAAkB,EAAE,CAAC,eAAe,CAAC;YAErC,UAAU;YACV,GAAG,EAAE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAE3B,kDAAkD;YAClD,UAAU,EAAE,IAAI;YAEhB,iDAAiD;YACjD,+BAA+B;YAC/B,YAAY,EAAE,MAAA,OAAO,CAAC,YAAY,0CAAE,MAAM,CACtC,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,iCAAM,GAAG,KAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,QAAQ,IAAG,EAC5D,EAA4B,CAC/B;YAED,kCAAkC;YAClC,SAAS,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,MAAA,OAAO,CAAC,WAAW,mCAAI,UAAU,CAAC,CAAC,CAAC,SAAS;YAEpF,oCAAoC;YACpC,QAAQ,EAAE,OAAO,CAAC,IAAI;SACzB,CAAC;QAEF,MAAM,EAAE,GAAG,IAAI,SAAS,iCACjB,UAAU;YACb,oDAAoD;YACpD,+EAA+E;YAC/E,kEAAkE;YAClE,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,UAAU,EAAE,sCAAsC;oBACxD,QAAQ,EAAE,MAAM;iBACnB;aACJ,IACH,CAAC;QAEH,uCAAuC;QACvC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAEpC,iCAAiC;QACjC,MAAM,EAAE,CAAC,KAAK,CAAC;QACf,OAAO,EAAE,CAAC;IACd,CAAC;CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAgB,YAAY,CAAC,EAAa,EAAE,UAAkB;;QAChE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,CAAC;QAE7C,kCAAkC;QAClC,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;YACd,+EAA+E;YAC/E,MAAM,EAAE,CAAC,UAAU,CAAC;gBAChB,OAAO,EAAE;oBACL;wBACI,IAAI,EAAE,UAAU;wBAChB,IAAI,EAAE,UAAU;wBAChB,QAAQ,EAAE,MAAM;qBACnB;iBACJ;aACJ,CAAC,CAAC;YACH,OAAO;QACX,CAAC;QAED,yCAAyC;QACzC,MAAM,EAAE,CAAC,UAAU,iCACZ,UAAU,KACb,OAAO,EAAE;gBACL;oBACI,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,UAAU;oBAChB,QAAQ,EAAE,MAAM;iBACnB;aACJ,IACH,CAAC;IACP,CAAC;CAAA;AAED;;;;GAIG;AACH,MAAM,UAAgB,gBAAgB,CAAC,EAAa;;QAChD,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;CAAA"}

package/lib/dev/preflight.d.ts

@@ -0,0 +1,7 @@
+interface PreflightResult {
+    ok: boolean;
+    message?: string;
+}
+export declare function preflightDependencies(projectRoot: string, clientRoot?: string): PreflightResult;
+export {};
+//# sourceMappingURL=preflight.d.ts.map

package/lib/dev/preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../src/dev/preflight.ts"],"names":[],"mappings":"AAGA,UAAU,eAAe;IACrB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAiCD,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAuC/F"}

package/lib/dev/preflight.js

@@ -0,0 +1,61 @@
+import fs from 'fs';
+import path from 'path';
+function getClientDependencyName(clientRoot) {
+    const pkgPath = path.join(clientRoot, 'package.json');
+    if (!fs.existsSync(pkgPath))
+        return undefined;
+    try {
+        const content = fs.readFileSync(pkgPath, 'utf8');
+        const pkg = JSON.parse(content);
+        const deps = pkg.dependencies || {};
+        const devDeps = pkg.devDependencies || {};
+        const depNames = Object.keys(deps).concat(Object.keys(devDeps));
+        if (depNames.includes('lit'))
+            return 'lit';
+        return depNames[0];
+    }
+    catch (_a) {
+        return undefined;
+    }
+}
+function isDependencyInstalled(projectRoot, depName) {
+    const depPath = path.join(projectRoot, 'node_modules', depName, 'package.json');
+    return fs.existsSync(depPath);
+}
+function hasSharedPackage(projectRoot) {
+    return fs.existsSync(path.join(projectRoot, 'packages/shared'));
+}
+export function preflightDependencies(projectRoot, clientRoot) {
+    const rootPkgPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(rootPkgPath)) {
+        return {
+            ok: false,
+            message: 'Missing dependencies. Run bun install at the app root (no package.json found).',
+        };
+    }
+    const nodeModulesPath = path.join(projectRoot, 'node_modules');
+    if (!fs.existsSync(nodeModulesPath)) {
+        return {
+            ok: false,
+            message: 'Missing dependencies. Run bun install at the app root (node_modules not found).',
+        };
+    }
+    // Check for TypeScript if shared package exists
+    if (hasSharedPackage(projectRoot) && !isDependencyInstalled(projectRoot, 'typescript')) {
+        return {
+            ok: false,
+            message: 'Missing TypeScript. Run bun install at the app root (required for shared package build).',
+        };
+    }
+    if (clientRoot) {
+        const depName = getClientDependencyName(clientRoot);
+        if (depName && !isDependencyInstalled(projectRoot, depName)) {
+            return {
+                ok: false,
+                message: `Missing client dependencies. Run bun install at the app root (cannot resolve ${depName}).`,
+            };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=preflight.js.map

package/lib/dev/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../src/dev/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAOxB,SAAS,uBAAuB,CAAC,UAAkB;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAE9C,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAG7B,CAAC;QAEF,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAEhE,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAAC,WAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,WAAmB,EAAE,OAAe;IAC/D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IAChF,OAAO,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAmB;IACzC,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,WAAmB,EAAE,UAAmB;IAC1E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC9B,OAAO;YACH,EAAE,EAAE,KAAK;YACT,OAAO,EACH,gFAAgF;SACvF,CAAC;IACN,CAAC;IAED,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAClC,OAAO;YACH,EAAE,EAAE,KAAK;YACT,OAAO,EACH,iFAAiF;SACxF,CAAC;IACN,CAAC;IAED,gDAAgD;IAChD,IAAI,gBAAgB,CAAC,WAAW,CAAC,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC;QACrF,OAAO;YACH,EAAE,EAAE,KAAK;YACT,OAAO,EACH,0FAA0F;SACjG,CAAC;IACN,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,OAAO,IAAI,CAAC,qBAAqB,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC;YAC1D,OAAO;gBACH,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,gFAAgF,OAAO,IAAI;aACvG,CAAC;QACN,CAAC;IACL,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/lib/dev/shared.d.ts

@@ -0,0 +1,7 @@
+export interface SharedBuildResult {
+    built: boolean;
+    success: boolean;
+    diagnostics?: string[];
+}
+export declare function buildSharedIfPresent(projectRoot: string): Promise<SharedBuildResult>;
+//# sourceMappingURL=shared.d.ts.map

package/lib/dev/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/dev/shared.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,iBAAiB;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AA4CD,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA0D1F"}