@dotdo/postgres 0.1.2 → 0.1.3

package/dist/worker/do-pglite-manager.js

@@ -4,6 +4,18 @@
  * Handles PGLite instance creation, initialization, and lifecycle.
  * Extracted from PostgresDO to reduce class size and separate concerns.
  *
+ * ## WASM Hoisting Pattern
+ *
+ * This module implements WASM hoisting to reduce "warm start" time from ~1200ms to ~30ms.
+ *
+ * The problem: In Cloudflare Workers, when a DO class is recreated (but the isolate stays alive),
+ * the PGLite WASM needs to be reloaded. WASM initialization takes ~1200ms.
+ *
+ * The solution: Cache the PGLite instance at module level. The module loads once per isolate,
+ * so the PGLite instance survives DO class reinstantiation. This means:
+ * - Cold start: ~1200ms (full WASM initialization)
+ * - Warm start (isolate alive, DO recreated): ~30ms (reuse cached WASM)
+ *
  * @module worker/do-pglite-manager
  */
 import { PluginManager } from './plugin-manager';
@@ -13,6 +25,109 @@ import pgliteWasm from '../pglite-assets/pglite.wasm';
 import pgliteData from '../pglite-assets/pglite.data';
 // Import Workers-compatible PGLite wrapper
 import { createWorkersPGLite } from '../pglite/workers-pglite';
+// =============================================================================
+// Module-Level WASM Hoisting (outside class)
+// =============================================================================
+// These persist as long as the isolate lives - helps reduce warm start time.
+// The module loads once per isolate, so the PGLite instance survives
+// across DO class reinstantiations within the same isolate.
+/**
+ * Hoisted PGLite instance - survives DO class reinstantiation within same isolate.
+ * This is the key to reducing warm start time from ~1200ms to ~30ms.
+ */
+let hoistedPglite = null;
+/**
+ * Promise for in-progress PGLite initialization.
+ * Prevents duplicate WASM loading when multiple DO instances initialize concurrently.
+ */
+let hoistedPglitePromise = null;
+/**
+ * Module load time for diagnostics.
+ * Note: Date.now() at module evaluation time in Workers returns 0,
+ * so we capture the first access time instead.
+ */
+let MODULE_LOAD_TIME = null;
+/**
+ * Unique identifier for this module instance (for debugging/diagnostics).
+ */
+const MODULE_INSTANCE_ID = Math.random().toString(36).slice(2, 10);
+/**
+ * Get the module load time (captures on first call since Date.now() is 0 at module load).
+ */
+function getModuleLoadTime() {
+    if (MODULE_LOAD_TIME === null) {
+        MODULE_LOAD_TIME = Date.now();
+    }
+    return MODULE_LOAD_TIME;
+}
+/**
+ * Get or create the hoisted PGLite instance.
+ *
+ * This function implements the singleton pattern with promise deduplication:
+ * - If an instance exists, return it immediately
+ * - If initialization is in progress, return the existing promise
+ * - Otherwise, start initialization and cache both the promise and the result
+ *
+ * @param options - PGLite creation options (only used if creating new instance)
+ * @returns Promise resolving to the PGLite instance
+ */
+async function getOrCreateHoistedPglite(options) {
+    // Fast path: already initialized
+    if (hoistedPglite) {
+        return hoistedPglite;
+    }
+    // Deduplication: return existing promise if initialization in progress
+    if (hoistedPglitePromise) {
+        return hoistedPglitePromise;
+    }
+    // Start initialization
+    hoistedPglitePromise = createWorkersPGLite({
+        wasmModule: pgliteWasm,
+        fsBundle: pgliteData,
+        database: options.database ?? 'postgres',
+        debug: options.debug ?? 0,
+    });
+    try {
+        hoistedPglite = await hoistedPglitePromise;
+        return hoistedPglite;
+    }
+    finally {
+        // Clear the promise after resolution (success or failure)
+        hoistedPglitePromise = null;
+    }
+}
+/**
+ * Check if the hoisted PGLite instance exists.
+ * Useful for diagnostics and testing.
+ */
+export function hasHoistedPglite() {
+    return hoistedPglite !== null;
+}
+/**
+ * Get diagnostics about the hoisted WASM state.
+ * Useful for debugging warm start performance.
+ */
+export function getHoistedPgliteDiagnostics() {
+    const now = Date.now();
+    const loadTime = getModuleLoadTime();
+    return {
+        hasInstance: hoistedPglite !== null,
+        hasPendingPromise: hoistedPglitePromise !== null,
+        moduleInstanceId: MODULE_INSTANCE_ID,
+        moduleLoadTime: loadTime,
+        moduleAgeMs: now - loadTime,
+    };
+}
+/**
+ * Reset the hoisted PGLite instance.
+ * WARNING: This should only be used in tests. In production, the hoisted
+ * instance should persist for the lifetime of the isolate.
+ * @internal
+ */
+export function resetHoistedPglite() {
+    hoistedPglite = null;
+    hoistedPglitePromise = null;
+}
 /**
  * PGLiteManager handles PGLite instance lifecycle.
  *
@@ -45,6 +160,8 @@ export class PGLiteManager {
     initialized = false;
     config;
     pluginManager;
+    /** Track whether this manager is using the hoisted instance */
+    usingHoistedInstance = false;
     constructor(config = {}) {
         // Build config without undefined values for exactOptionalPropertyTypes
         this.config = {
@@ -57,6 +174,9 @@ export class PGLiteManager {
         if (config.createPGLite !== undefined) {
             this.config.createPGLite = config.createPGLite;
         }
+        if (config.disableHoisting !== undefined) {
+            this.config.disableHoisting = config.disableHoisting;
+        }
         // Build plugin manager config without undefined values for exactOptionalPropertyTypes
         const pluginManagerConfig = {};
         if (config.plugins !== undefined) {
@@ -117,10 +237,15 @@ export class PGLiteManager {
     /**
      * Create the PGLite instance
      * Can be overridden for testing
+     *
+     * By default, uses the module-level hoisted PGLite instance for optimal
+     * warm start performance. The hoisted instance survives DO class
+     * reinstantiation within the same isolate.
      */
     async createPGLiteInstance() {
-        // Use custom factory if provided
+        // Use custom factory if provided (for testing)
         if (this.config.createPGLite) {
+            this.usingHoistedInstance = false;
             return this.config.createPGLite();
         }
         // Get enabled plugin extensions (for future extension support)
@@ -128,19 +253,35 @@ export class PGLiteManager {
         // Note: extensions parameter is captured for future use but not passed through
         // as WorkersPGLite doesn't support extension loading yet
         void extensions; // Mark as intentionally unused
-        // Build options without undefined values for exactOptionalPropertyTypes
-        const pgliteOptions = {
-            // Pre-compiled WASM module for Workers
-            wasmModule: pgliteWasm,
-            // Filesystem bundle with PostgreSQL data files
-            fsBundle: pgliteData,
-            // Database configuration
+        // If hoisting is disabled, create a new instance each time
+        if (this.config.disableHoisting) {
+            this.usingHoistedInstance = false;
+            console.log(`[PGLiteManager] WASM hoisting disabled - creating new instance`);
+            return createWorkersPGLite({
+                wasmModule: pgliteWasm,
+                fsBundle: pgliteData,
+                database: this.config.database ?? 'postgres',
+                debug: this.config.debug ? 1 : 0,
+            });
+        }
+        // Use the hoisted PGLite instance for optimal warm start performance.
+        // This is the key optimization: when the DO class is recreated but the
+        // isolate stays alive, we reuse the already-initialized WASM instance
+        // instead of loading it again (~1200ms -> ~30ms).
+        const wasmWasAlreadyLoaded = hoistedPglite !== null;
+        const pg = await getOrCreateHoistedPglite({
+            database: this.config.database,
             debug: this.config.debug ? 1 : 0,
-        };
-        if (this.config.database !== undefined) {
-            pgliteOptions.database = this.config.database;
+        });
+        this.usingHoistedInstance = true;
+        // Log whether we reused the WASM instance (helpful for debugging warm starts)
+        if (wasmWasAlreadyLoaded) {
+            const diagnostics = getHoistedPgliteDiagnostics();
+            console.log(`[PGLiteManager] WASM REUSED - module age: ${diagnostics.moduleAgeMs}ms, instance: ${diagnostics.moduleInstanceId}`);
+        }
+        else {
+            console.log(`[PGLiteManager] WASM LOADED (cold start) - instance: ${MODULE_INSTANCE_ID}`);
         }
-        const pg = await createWorkersPGLite(pgliteOptions);
         return pg;
     }
     /**
@@ -191,9 +332,27 @@ export class PGLiteManager {
     /**
      * Close PGLite instance
      *
+     * Note: When using the hoisted WASM instance (default), this method does NOT
+     * close the underlying PGLite instance, as it's shared across DO instances.
+     * It only clears the local reference. The hoisted instance persists for the
+     * lifetime of the isolate for optimal warm start performance.
+     *
+     * To actually close the hoisted instance, use resetHoistedPglite() followed
+     * by close() on the next manager that initializes. This should only be done
+     * in tests or when the isolate is shutting down.
+     *
      * @param timeoutMs - Maximum time to wait for close (default: 5000ms)
      */
     async close(timeoutMs = 5000) {
+        // If using hoisted instance, don't actually close it - just clear our reference
+        // The hoisted instance should survive for the lifetime of the isolate
+        if (this.usingHoistedInstance) {
+            console.log(`[PGLiteManager] Skipping close of hoisted WASM instance (will be reused)`);
+            this.pglite = null;
+            this.initialized = false;
+            this.usingHoistedInstance = false;
+            return;
+        }
         if (!this.pglite?.close) {
             this.pglite = null;
             this.initialized = false;
@@ -217,6 +376,24 @@ export class PGLiteManager {
     reset() {
         this.pglite = null;
         this.initialized = false;
+        this.usingHoistedInstance = false;
+    }
+    /**
+     * Check if this manager is using the hoisted WASM instance
+     */
+    isUsingHoistedInstance() {
+        return this.usingHoistedInstance;
+    }
+    /**
+     * Get diagnostics about WASM hoisting and initialization state.
+     * Useful for debugging warm start performance.
+     */
+    getDiagnostics() {
+        return {
+            initialized: this.initialized,
+            usingHoistedInstance: this.usingHoistedInstance,
+            hoisted: getHoistedPgliteDiagnostics(),
+        };
     }
 }
 /**

package/dist/worker/do-pglite-manager.js.map

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

package/dist/worker/index.d.ts

@@ -49,12 +49,18 @@ export { DOAuthManager, createDOAuthManager } from './do-auth-manager';
 export type { DOAuthConfig } from './do-auth-manager';
 export { QueryStatsManager, createQueryStatsManager } from './query-stats-manager';
 export type { QueryStats, ExtendedQueryStats, QueryStatsConfig } from './query-stats-manager';
-export { PGLiteManager, createPGLiteManager } from './do-pglite-manager';
+export { PGLiteManager, createPGLiteManager, hasHoistedPglite, getHoistedPgliteDiagnostics, resetHoistedPglite, } from './do-pglite-manager';
 export type { PGLiteManagerConfig } from './do-pglite-manager';
+export { LazyPGLiteManager, createLazyPGLiteManager, hasLazyHoistedPglite, getLazyHoistedPgliteDiagnostics, resetLazyHoistedPglite, } from './lazy-pglite-manager';
+export type { LazyPGLiteManagerConfig, WASMLoadingState } from './lazy-pglite-manager';
+export { BackgroundPGLiteManager, createBackgroundPGLiteManager, hasBgHoistedPglite, isBgWasmLoading, getBgHoistedPgliteDiagnostics, resetBgHoistedPglite, } from './background-pglite-manager';
+export type { BackgroundPGLiteManagerConfig, BGWASMLoadingState } from './background-pglite-manager';
 export { QueryExecutionManager, createQueryExecutionManager } from './query-execution-manager';
 export type { QueryExecutionDependencies, QueryExecutorPGlite } from './query-execution-manager';
 export { HealthCheckManager, createHealthCheckManager } from './health-check-manager';
 export type { HealthCheckDependencies, HealthCheckPGlite, ColumnDescription, DatabaseStats } from './health-check-manager';
 export { RpcMethodsManager, createRpcMethodsManager } from './rpc-methods-manager';
 export type { RpcMethodsDependencies, RpcMethodsPGlite } from './rpc-methods-manager';
+export { createMCPServer, createMCPRoutes, createPGBinding, PG_BINDING_TYPES, searchTool, fetchTool, doTool, getToolDefinitions, createToolHandlers, createSearchHandler, createFetchHandler, createDoHandler, } from '../mcp';
+export type { MCPServer, MCPServerConfig, MCPAuthContext, QueryResult as MCPQueryResult, TableInfo, ColumnInfo, MCPSearchResult, MCPFetchResult, PGBinding, PGTransaction, ToolResponse, SearchInput, FetchInput, DoInput, Tool as MCPTool, QueryExecutor as MCPQueryExecutor, } from '../mcp';
 //# sourceMappingURL=index.d.ts.map

package/dist/worker/index.d.ts.map

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

package/dist/worker/index.js

@@ -57,11 +57,29 @@ export { DOAuthManager, createDOAuthManager } from './do-auth-manager';
 // Query Stats Manager (extracted from PostgresDO for reuse)
 export { QueryStatsManager, createQueryStatsManager } from './query-stats-manager';
 // PGLite Manager (extracted from PostgresDO for reuse)
-export { PGLiteManager, createPGLiteManager } from './do-pglite-manager';
+// Includes WASM hoisting for optimal warm start performance (~1200ms -> ~30ms)
+export { PGLiteManager, createPGLiteManager, 
+// WASM Hoisting utilities
+hasHoistedPglite, getHoistedPgliteDiagnostics, resetHoistedPglite, } from './do-pglite-manager';
+// Lazy PGLite Manager (SPIKE: Lazy WASM loading experiment)
+// Defers WASM loading until first query for improved cold start perception
+export { LazyPGLiteManager, createLazyPGLiteManager, 
+// Lazy WASM Hoisting utilities
+hasLazyHoistedPglite, getLazyHoistedPgliteDiagnostics, resetLazyHoistedPglite, } from './lazy-pglite-manager';
+// Background PGLite Manager (RECOMMENDED: Eager-but-non-blocking pattern)
+// Starts WASM loading immediately but doesn't block - best of both worlds:
+// - Non-query endpoints respond instantly
+// - WASM loads in background (uses ctx.waitUntil)
+// - First query only waits for remaining load time (often zero)
+export { BackgroundPGLiteManager, createBackgroundPGLiteManager, 
+// Background WASM Hoisting utilities
+hasBgHoistedPglite, isBgWasmLoading, getBgHoistedPgliteDiagnostics, resetBgHoistedPglite, } from './background-pglite-manager';
 // Query Execution Manager (extracted from PostgresDO for reuse - Task: postgres-an18)
 export { QueryExecutionManager, createQueryExecutionManager } from './query-execution-manager';
 // Health Check Manager (extracted from PostgresDO for reuse - Task: postgres-an18)
 export { HealthCheckManager, createHealthCheckManager } from './health-check-manager';
 // RPC Methods Manager (extracted from PostgresDO for reuse - Task: postgres-an18)
 export { RpcMethodsManager, createRpcMethodsManager } from './rpc-methods-manager';
+// MCP Server (Model Context Protocol)
+export { createMCPServer, createMCPRoutes, createPGBinding, PG_BINDING_TYPES, searchTool, fetchTool, doTool, getToolDefinitions, createToolHandlers, createSearchHandler, createFetchHandler, createDoHandler, } from '../mcp';
 //# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

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

package/dist/worker/lazy-pglite-manager.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Lazy PGLite Manager for PostgresDO
+ *
+ * SPIKE: Lazy WASM Loading Experiment
+ *
+ * This module implements a lazy loading variant of PGLiteManager that defers
+ * WASM loading until the first query is executed, rather than loading on
+ * DO instantiation.
+ *
+ * ## Hypothesis
+ *
+ * Loading WASM only on first query (not on DO instantiation) may improve:
+ * 1. Cold start perception (faster initial response for non-query endpoints)
+ * 2. Memory usage (don't load if no queries made)
+ *
+ * ## Trade-offs
+ *
+ * - Eager loading: ~1200ms cold start, all subsequent requests fast
+ * - Lazy loading: ~0ms until first query, first query pays ~1200ms, subsequent fast
+ *
+ * For workloads where:
+ * - Many requests hit non-query endpoints (health checks, metadata) -> lazy wins
+ * - All requests are queries -> eager wins (same total latency, better predictability)
+ * - Mixed workload -> depends on query ratio
+ *
+ * ## Implementation
+ *
+ * The manager provides:
+ * - `isWASMLoaded()` - Check if WASM is loaded without triggering load
+ * - `ensureWASMLoaded()` - Explicitly trigger WASM loading
+ * - `query()` - Execute query (lazy loads WASM if needed)
+ * - Promise deduplication for concurrent first queries
+ *
+ * @module worker/lazy-pglite-manager
+ */
+import type { PostgresConfig } from './types';
+import { PluginManager } from './plugin-manager';
+import type { PGliteLike } from './do-pglite-manager';
+/**
+ * Check if the lazy hoisted PGLite instance exists.
+ */
+export declare function hasLazyHoistedPglite(): boolean;
+/**
+ * Get diagnostics about the lazy hoisted WASM state.
+ */
+export declare function getLazyHoistedPgliteDiagnostics(): {
+    hasInstance: boolean;
+    hasPendingPromise: boolean;
+    moduleInstanceId: string;
+    wasmLoadedAt: number | null;
+    timeSinceLoad: number | null;
+};
+/**
+ * Reset the lazy hoisted PGLite instance.
+ * WARNING: This should only be used in tests.
+ * @internal
+ */
+export declare function resetLazyHoistedPglite(): void;
+/**
+ * WASM loading state for diagnostics
+ */
+export type WASMLoadingState = 'not_loaded' | 'loading' | 'loaded' | 'error';
+/**
+ * Configuration for Lazy PGLite manager
+ */
+export interface LazyPGLiteManagerConfig {
+    /** Database name */
+    database?: string;
+    /** Enable debug mode */
+    debug?: boolean;
+    /** Plugin configuration */
+    plugins?: PostgresConfig['plugins'];
+    /** Custom PGLite factory for testing */
+    createPGLite?: () => Promise<PGliteLike>;
+    /**
+     * Disable WASM hoisting optimization.
+     * When false (default), the PGLite WASM instance is cached at module level.
+     * @default false
+     */
+    disableHoisting?: boolean;
+}
+/**
+ * LazyPGLiteManager defers WASM loading until the first query.
+ *
+ * Unlike the eager PGLiteManager, this manager does NOT load WASM during
+ * initialize(). WASM is only loaded when query() or ensureWASMLoaded() is called.
+ *
+ * Benefits:
+ * - Non-query endpoints (health, metadata, stats) respond immediately
+ * - Memory is not consumed until queries are actually executed
+ * - Better cold start perception for mixed workloads
+ *
+ * Trade-offs:
+ * - First query incurs the full WASM loading time (~1200ms)
+ * - Less predictable query latency (first vs subsequent)
+ *
+ * @example
+ * ```typescript
+ * const manager = new LazyPGLiteManager({ database: 'mydb' })
+ *
+ * // Initialize (fast - no WASM loading)
+ * await manager.initialize()
+ *
+ * // Check if WASM is loaded (without triggering load)
+ * console.log(manager.isWASMLoaded()) // false
+ *
+ * // First query triggers WASM load (~1200ms)
+ * const result1 = await manager.query('SELECT 1')
+ *
+ * // Now WASM is loaded
+ * console.log(manager.isWASMLoaded()) // true
+ *
+ * // Subsequent queries are fast (~ms)
+ * const result2 = await manager.query('SELECT 2')
+ * ```
+ */
+export declare class LazyPGLiteManager {
+    private pglite;
+    private initialized;
+    private loadingState;
+    private loadError;
+    private config;
+    private pluginManager;
+    /** Track whether this manager is using the hoisted instance */
+    private usingHoistedInstance;
+    /** Timing metrics for diagnostics */
+    private metrics;
+    constructor(config?: LazyPGLiteManagerConfig);
+    /**
+     * Check if the manager is initialized.
+     * Note: This returns true after initialize() is called, even if WASM is not loaded.
+     */
+    isInitialized(): boolean;
+    /**
+     * Check if WASM is loaded (without triggering load).
+     * This is the key difference from eager loading.
+     */
+    isWASMLoaded(): boolean;
+    /**
+     * Get the current WASM loading state.
+     */
+    getLoadingState(): WASMLoadingState;
+    /**
+     * Get any error that occurred during WASM loading.
+     */
+    getLoadError(): Error | null;
+    /**
+     * Get the PGLite instance (throws if not loaded).
+     * For lazy loading, prefer using query() which handles loading automatically.
+     */
+    getInstance(): PGliteLike;
+    /**
+     * Get the PGLite instance or null if not loaded.
+     */
+    getInstanceOrNull(): PGliteLike | null;
+    /**
+     * Get the plugin manager.
+     */
+    getPluginManager(): PluginManager;
+    /**
+     * Get timing metrics for diagnostics.
+     */
+    getMetrics(): {
+        initializeCalledAt: number | null;
+        firstQueryAt: number | null;
+        wasmLoadStartAt: number | null;
+        wasmLoadEndAt: number | null;
+        wasmLoadDurationMs: number | null;
+        timeToFirstQuery: number | null;
+    };
+    /**
+     * Initialize the manager (does NOT load WASM).
+     *
+     * This is intentionally fast - WASM loading is deferred to first query.
+     * Safe to call multiple times.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Explicitly ensure WASM is loaded.
+     *
+     * Use this if you want to pre-warm WASM loading before the first query,
+     * but still want the option to skip loading entirely for non-query requests.
+     */
+    ensureWASMLoaded(): Promise<void>;
+    /**
+     * Internal method to load WASM.
+     */
+    private loadWASM;
+    /**
+     * Execute a query (lazy loads WASM if needed).
+     *
+     * This is the primary method for interacting with the database.
+     * On first call, it will trigger WASM loading.
+     */
+    query<T = unknown>(sql: string, params?: unknown[]): Promise<{
+        rows: T[];
+        fields: {
+            name: string;
+            dataTypeID: number;
+        }[];
+        affectedRows?: number;
+    }>;
+    /**
+     * Check if PGLite is responsive by running a simple query.
+     * This will trigger WASM loading if not already loaded.
+     */
+    checkLiveness(): Promise<boolean>;
+    /**
+     * Close PGLite instance.
+     */
+    close(timeoutMs?: number): Promise<void>;
+    /**
+     * Reset manager state (for testing or hibernation recovery).
+     */
+    reset(): void;
+    /**
+     * Check if this manager is using the hoisted WASM instance.
+     */
+    isUsingHoistedInstance(): boolean;
+    /**
+     * Get comprehensive diagnostics about lazy loading state.
+     */
+    getDiagnostics(): {
+        initialized: boolean;
+        wasmLoaded: boolean;
+        loadingState: WASMLoadingState;
+        usingHoistedInstance: boolean;
+        metrics: ReturnType<LazyPGLiteManager['getMetrics']>;
+        hoisted: {
+            hasInstance: boolean;
+            hasPendingPromise: boolean;
+            moduleInstanceId: string;
+            wasmLoadedAt: number | null;
+            timeSinceLoad: number | null;
+        };
+    };
+}
+/**
+ * Factory function to create a LazyPGLiteManager.
+ */
+export declare function createLazyPGLiteManager(config?: LazyPGLiteManagerConfig): LazyPGLiteManager;
+//# sourceMappingURL=lazy-pglite-manager.d.ts.map

package/dist/worker/lazy-pglite-manager.d.ts.map

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