js-bao 0.2.11 → 0.2.12

package/README.md

@@ -848,6 +848,154 @@ const productSummary = await Product.query(
 // Returns: [{ id: "...", name: "...", price: ... }, ...]
 ```
 
+### Includes (Related Data)
+
+Load related records alongside query results using `include`. Each include spec tells the engine how to resolve a relationship between models.
+
+**Include types:**
+
+| Type | Relationship | Example |
+|------|-------------|---------|
+| `refersTo` | Record has a FK field pointing to one target | Order → Customer |
+| `hasMany` | Target records have a FK field pointing back to this record | Customer → Orders |
+| `refersToMany` | Record has a StringSet field containing multiple target IDs | Post → Tags |
+
+#### refersTo — Scalar foreign key
+
+Load a single related record via a foreign key field on the source.
+
+```typescript
+// Schema: Order has a `customerId` field
+const orders = await Order.query({}, {
+  include: [{
+    model: "customers",
+    type: "refersTo",
+    sourceField: "customerId",  // FK field on Order
+    as: "customer",             // result key (optional, defaults to model name)
+    projection: { name: 1 },   // only load specific fields
+  }],
+});
+// Each order gets: order._related.customer = { id, name }
+```
+
+#### hasMany — Reverse foreign key
+
+Load multiple related records that reference this record.
+
+```typescript
+// Schema: Comment has an `articleId` field pointing to Article
+const articles = await Article.query({}, {
+  include: [{
+    model: "comments",
+    type: "hasMany",
+    foreignKey: "articleId",    // FK field on Comment pointing back
+    as: "comments",
+    limit: 10,                 // cap per parent
+    sort: { createdAt: -1 },   // newest first
+  }],
+});
+// Each article gets: article._related.comments = [{ id, text, ... }, ...]
+```
+
+#### refersToMany — StringSet of IDs
+
+Load multiple related records referenced by a StringSet field.
+
+```typescript
+// Schema: Post has a `tagIds` StringSet field containing Tag IDs
+const posts = await Post.query({}, {
+  include: [{
+    model: "tags",
+    type: "refersToMany",
+    sourceField: "tagIds",     // StringSet field on Post
+    as: "tags",
+    projection: { name: 1 },
+  }],
+});
+// Each post gets: post._related.tags = [{ id, name }, ...]
+```
+
+#### End-to-end example: write and query
+
+```typescript
+// 1. Create tags
+const techTag = await Tag.create({ id: generateULID(), name: "Tech" });
+const newsTag = await Tag.create({ id: generateULID(), name: "News" });
+
+// 2. Create a post with references to tags via StringSet
+const post = await Post.create({ id: generateULID(), title: "Hello World" });
+await Post.addToSet(post.id, { tagIds: [techTag.id, newsTag.id] });
+
+// 3. Create a comment referencing the post
+await Comment.create({
+  id: generateULID(),
+  postId: post.id,
+  text: "Great post!",
+});
+
+// 4. Query posts with all related data in one call
+const results = await Post.query({}, {
+  include: [
+    {
+      model: "tags",
+      type: "refersToMany",
+      sourceField: "tagIds",
+      as: "tags",
+    },
+    {
+      model: "comments",
+      type: "hasMany",
+      foreignKey: "postId",
+      as: "comments",
+      sort: { createdAt: -1 },
+    },
+  ],
+});
+
+// Result:
+// results.data[0]._related.tags = [{ id: "...", name: "Tech" }, { id: "...", name: "News" }]
+// results.data[0]._related.comments = [{ id: "...", postId: "...", text: "Great post!" }]
+```
+
+#### Nested includes
+
+Includes can be nested to load relationships on related records:
+
+```typescript
+const articles = await Article.query({}, {
+  include: [{
+    model: "comments",
+    type: "hasMany",
+    foreignKey: "articleId",
+    as: "comments",
+    include: [{
+      model: "users",
+      type: "refersTo",
+      sourceField: "authorId",
+      as: "author",
+      projection: { name: 1 },
+    }],
+  }],
+});
+// article._related.comments[0]._related.author = { id, name }
+```
+
+#### Filtering included records
+
+Apply filters to narrow which related records are loaded:
+
+```typescript
+const posts = await Post.query({}, {
+  include: [{
+    model: "comments",
+    type: "hasMany",
+    foreignKey: "postId",
+    filter: { status: "approved" },  // only approved comments
+    as: "comments",
+  }],
+});
+```
+
 ### Single Document Queries
 
 ```typescript
@@ -1229,6 +1377,32 @@ const user = new User({ name: "John Doe", email: "john@example.com" });
 await user.save({ targetDocument: "main-doc" });
 ```
 
+## Client-Only Import (`js-bao/client`)
+
+If you only need the HTTP client engine (e.g., for browser apps, React/Vue frontends, or Node.js clients that talk to a DO backend over HTTP), use `js-bao/client` instead of `js-bao/cloudflare`. This avoids pulling in server-side Durable Object code and its dependencies.
+
+```typescript
+import { connectDoDb } from "js-bao/client";
+
+const db = connectDoDb({
+  endpoint: "https://my-app.workers.dev",
+  id: "my-document",
+});
+
+// Save a record (schemaless)
+await db.engine.saveModel("todos", "todo-1", { title: "Buy milk", done: false });
+
+// Query records
+const result = await db.engine.queryModel("todos", { done: false });
+console.log(result.data);
+```
+
+**When to use `js-bao/client`:** Browser apps, frontend builds, Node.js HTTP clients — any context where you don't need `createDatabaseDO` or `initJsBaoDO` server setup.
+
+**When to use `js-bao/cloudflare`:** When building the Cloudflare Worker that hosts the Durable Object.
+
+Key exports: `connectDoDb`, `DOClientEngine`, and types (`DoDb`, `DocumentFilter`, `QueryOptions`, `PaginatedResult`, `AggregationOptions`, etc.). This import has no dependencies on Cloudflare Workers APIs, better-sqlite3, sql.js, or Yjs — it's pure fetch-based HTTP.
+
 ## Database Configuration
 
 ### SQLite (Node.js)

package/dist/BaseModel-5YQCROYE.js

@@ -0,0 +1,17 @@
+import {
+  BaseModel,
+  LogLevel,
+  Logger,
+  RecordNotFoundError,
+  UniqueConstraintViolationError,
+  generateULID
+} from "./chunk-3PZWHUZO.js";
+export {
+  BaseModel,
+  LogLevel,
+  Logger,
+  RecordNotFoundError,
+  UniqueConstraintViolationError,
+  generateULID
+};
+//# sourceMappingURL=BaseModel-5YQCROYE.js.map

package/dist/BaseModel-5YQCROYE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/BaseModel-FCNWDJBH.js

@@ -0,0 +1,17 @@
+import {
+  BaseModel,
+  LogLevel,
+  Logger,
+  RecordNotFoundError,
+  UniqueConstraintViolationError,
+  generateULID
+} from "./chunk-6UX3YSCW.js";
+export {
+  BaseModel,
+  LogLevel,
+  Logger,
+  RecordNotFoundError,
+  UniqueConstraintViolationError,
+  generateULID
+};
+//# sourceMappingURL=BaseModel-FCNWDJBH.js.map

package/dist/BaseModel-FCNWDJBH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/BrowserDatabaseFactory-PXOTK2DQ.js

@@ -0,0 +1,119 @@
+import {
+  SqljsEngine
+} from "./chunk-53MS4MN7.js";
+import {
+  features
+} from "./chunk-GO3APTPX.js";
+import {
+  Logger
+} from "./chunk-6UX3YSCW.js";
+
+// src/engines/BrowserDatabaseFactory.ts
+var BrowserDatabaseFactory = class {
+  /**
+   * Dynamically loads browser-compatible engines only
+   */
+  static async loadBrowserEngines() {
+    Logger.debug("[BrowserDatabaseFactory] Browser engines ready");
+  }
+  /**
+   * Auto-detects the best available engine for browser
+   */
+  static getRecommendedEngineType() {
+    if (features.hasWebAssembly) {
+      return "sqljs";
+    }
+    throw new Error(
+      "No compatible database engine found. WebAssembly is required for browser environments."
+    );
+  }
+  /**
+   * Creates a fallback engine when the requested engine is not available
+   */
+  static async createFallbackEngine(requestedType, config) {
+    const fallbackType = this.getRecommendedEngineType();
+    console.warn(
+      `[BrowserDatabaseFactory] Requested engine '${requestedType}' is not available. Falling back to '${fallbackType}'.`
+    );
+    const fallbackConfig = { ...config, type: fallbackType };
+    return this.createEngine(fallbackConfig, false);
+  }
+  /**
+   * Creates the specified database engine (browser-compatible only)
+   */
+  static async createEngine(config, allowFallback = true) {
+    const { type, options } = config;
+    const typeStr = type;
+    switch (type) {
+      case "sqljs":
+        const sqljsEngine = new SqljsEngine(options);
+        await sqljsEngine.ensureReady();
+        return sqljsEngine;
+      case "alasql":
+        throw new Error("AlaSQLEngine not yet implemented.");
+      default:
+        if (typeStr === "duckdb") {
+          if (allowFallback) {
+            console.warn(
+              "[BrowserDatabaseFactory] DuckDB engine is no longer supported, falling back to alternative engine"
+            );
+            return this.createFallbackEngine(typeStr, config);
+          }
+          throw new Error("DuckDB engine is no longer supported");
+        }
+        if (typeStr === "node-sqlite" || typeStr === "node-duckdb") {
+          if (allowFallback) {
+            console.warn(
+              `[BrowserDatabaseFactory] Engine '${typeStr}' is not available in browser. Falling back to browser-compatible engine.`
+            );
+            return this.createFallbackEngine(typeStr, config);
+          }
+          throw new Error(
+            `Engine '${typeStr}' is only available in Node.js environments`
+          );
+        }
+        throw new Error(`Unsupported database engine type: ${typeStr}`);
+    }
+  }
+  static async getEngine(config) {
+    await this.loadBrowserEngines();
+    Logger.debug(
+      `[BrowserDatabaseFactory] Creating engine for type: ${config.type}`
+    );
+    try {
+      const engine = await this.createEngine(config);
+      Logger.debug(
+        `[BrowserDatabaseFactory] Engine for type ${config.type} is ready.`
+      );
+      return engine;
+    } catch (error) {
+      console.error(
+        `[BrowserDatabaseFactory] Failed to create engine for type ${config.type}:`,
+        error
+      );
+      throw error;
+    }
+  }
+  /**
+   * Gets information about available engines in browser environment
+   */
+  static getAvailableEngines() {
+    const engines = [
+      {
+        type: "sqljs",
+        available: features.hasWebAssembly,
+        reason: !features.hasWebAssembly ? "WebAssembly not supported" : void 0
+      },
+      {
+        type: "node-sqlite",
+        available: false,
+        reason: "Node.js engines not available in browser"
+      }
+    ];
+    return engines;
+  }
+};
+export {
+  BrowserDatabaseFactory
+};
+//# sourceMappingURL=BrowserDatabaseFactory-PXOTK2DQ.js.map

package/dist/BrowserDatabaseFactory-PXOTK2DQ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engines/BrowserDatabaseFactory.ts"],"sourcesContent":["import { DatabaseConfig } from \"../types/databaseTypes\";\nimport { DatabaseEngine } from \"./DatabaseEngine\";\nimport { SqljsEngine } from \"./SqljsEngine\";\nimport { features } from \"../utils/environment\";\nimport { Logger } from \"../models/BaseModel\";\n\nexport class BrowserDatabaseFactory {\n  /**\n   * Dynamically loads browser-compatible engines only\n   */\n  private static async loadBrowserEngines() {\n    // No dynamic loading needed for SQL.js as it's imported statically\n    Logger.debug(\"[BrowserDatabaseFactory] Browser engines ready\");\n  }\n\n  /**\n   * Auto-detects the best available engine for browser\n   */\n  private static getRecommendedEngineType(): string {\n    // In browser, prefer SQL.js as it's more stable than DuckDB-WASM\n    if (features.hasWebAssembly) {\n      return \"sqljs\";\n    }\n\n    throw new Error(\n      \"No compatible database engine found. WebAssembly is required for browser environments.\"\n    );\n  }\n\n  /**\n   * Creates a fallback engine when the requested engine is not available\n   */\n  private static async createFallbackEngine(\n    requestedType: string,\n    config: DatabaseConfig\n  ): Promise<DatabaseEngine> {\n    const fallbackType = this.getRecommendedEngineType();\n\n    console.warn(\n      `[BrowserDatabaseFactory] Requested engine '${requestedType}' is not available. ` +\n        `Falling back to '${fallbackType}'.`\n    );\n\n    const fallbackConfig = { ...config, type: fallbackType as any };\n    return this.createEngine(fallbackConfig, false); // Prevent infinite recursion\n  }\n\n  /**\n   * Creates the specified database engine (browser-compatible only)\n   */\n  private static async createEngine(\n    config: DatabaseConfig,\n    allowFallback: boolean = true\n  ): Promise<DatabaseEngine> {\n    const { type, options } = config;\n    const typeStr = type as string; // Cast to handle legacy engine types\n\n    switch (type) {\n      case \"sqljs\":\n        const sqljsEngine = new SqljsEngine(options as any);\n        await sqljsEngine.ensureReady();\n        return sqljsEngine;\n\n      case \"alasql\":\n        throw new Error(\"AlaSQLEngine not yet implemented.\");\n\n      default:\n        // Handle removed engine types and unsupported types\n        if (typeStr === \"duckdb\") {\n          if (allowFallback) {\n            console.warn(\n              \"[BrowserDatabaseFactory] DuckDB engine is no longer supported, falling back to alternative engine\"\n            );\n            return this.createFallbackEngine(typeStr, config);\n          }\n          throw new Error(\"DuckDB engine is no longer supported\");\n        }\n\n        if (typeStr === \"node-sqlite\" || typeStr === \"node-duckdb\") {\n          if (allowFallback) {\n            console.warn(\n              `[BrowserDatabaseFactory] Engine '${typeStr}' is not available in browser. Falling back to browser-compatible engine.`\n            );\n            return this.createFallbackEngine(typeStr, config);\n          }\n          throw new Error(\n            `Engine '${typeStr}' is only available in Node.js environments`\n          );\n        }\n\n        throw new Error(`Unsupported database engine type: ${typeStr}`);\n    }\n  }\n\n  public static async getEngine(\n    config: DatabaseConfig\n  ): Promise<DatabaseEngine> {\n    // Load browser engines\n    await this.loadBrowserEngines();\n\n    Logger.debug(\n      `[BrowserDatabaseFactory] Creating engine for type: ${config.type}`\n    );\n\n    try {\n      const engine = await this.createEngine(config);\n\n      Logger.debug(\n        `[BrowserDatabaseFactory] Engine for type ${config.type} is ready.`\n      );\n      return engine;\n    } catch (error) {\n      console.error(\n        `[BrowserDatabaseFactory] Failed to create engine for type ${config.type}:`,\n        error\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Gets information about available engines in browser environment\n   */\n  public static getAvailableEngines(): {\n    type: string;\n    available: boolean;\n    reason?: string;\n  }[] {\n    const engines = [\n      {\n        type: \"sqljs\",\n        available: features.hasWebAssembly,\n        reason: !features.hasWebAssembly\n          ? \"WebAssembly not supported\"\n          : undefined,\n      },\n      {\n        type: \"node-sqlite\",\n        available: false,\n        reason: \"Node.js engines not available in browser\",\n      },\n    ];\n\n    return engines;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAMO,IAAM,yBAAN,MAA6B;AAAA;AAAA;AAAA;AAAA,EAIlC,aAAqB,qBAAqB;AAExC,WAAO,MAAM,gDAAgD;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,2BAAmC;AAEhD,QAAI,SAAS,gBAAgB;AAC3B,aAAO;AAAA,IACT;AAEA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,aAAqB,qBACnB,eACA,QACyB;AACzB,UAAM,eAAe,KAAK,yBAAyB;AAEnD,YAAQ;AAAA,MACN,8CAA8C,aAAa,wCACrC,YAAY;AAAA,IACpC;AAEA,UAAM,iBAAiB,EAAE,GAAG,QAAQ,MAAM,aAAoB;AAC9D,WAAO,KAAK,aAAa,gBAAgB,KAAK;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAqB,aACnB,QACA,gBAAyB,MACA;AACzB,UAAM,EAAE,MAAM,QAAQ,IAAI;AAC1B,UAAM,UAAU;AAEhB,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,cAAM,cAAc,IAAI,YAAY,OAAc;AAClD,cAAM,YAAY,YAAY;AAC9B,eAAO;AAAA,MAET,KAAK;AACH,cAAM,IAAI,MAAM,mCAAmC;AAAA,MAErD;AAEE,YAAI,YAAY,UAAU;AACxB,cAAI,eAAe;AACjB,oBAAQ;AAAA,cACN;AAAA,YACF;AACA,mBAAO,KAAK,qBAAqB,SAAS,MAAM;AAAA,UAClD;AACA,gBAAM,IAAI,MAAM,sCAAsC;AAAA,QACxD;AAEA,YAAI,YAAY,iBAAiB,YAAY,eAAe;AAC1D,cAAI,eAAe;AACjB,oBAAQ;AAAA,cACN,oCAAoC,OAAO;AAAA,YAC7C;AACA,mBAAO,KAAK,qBAAqB,SAAS,MAAM;AAAA,UAClD;AACA,gBAAM,IAAI;AAAA,YACR,WAAW,OAAO;AAAA,UACpB;AAAA,QACF;AAEA,cAAM,IAAI,MAAM,qCAAqC,OAAO,EAAE;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,aAAoB,UAClB,QACyB;AAEzB,UAAM,KAAK,mBAAmB;AAE9B,WAAO;AAAA,MACL,sDAAsD,OAAO,IAAI;AAAA,IACnE;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,aAAa,MAAM;AAE7C,aAAO;AAAA,QACL,4CAA4C,OAAO,IAAI;AAAA,MACzD;AACA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,6DAA6D,OAAO,IAAI;AAAA,QACxE;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAc,sBAIV;AACF,UAAM,UAAU;AAAA,MACd;AAAA,QACE,MAAM;AAAA,QACN,WAAW,SAAS;AAAA,QACpB,QAAQ,CAAC,SAAS,iBACd,8BACA;AAAA,MACN;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/BrowserDatabaseFactory-WD4VX2VZ.js

@@ -0,0 +1,119 @@
+import {
+  SqljsEngine
+} from "./chunk-DF3JEQXA.js";
+import {
+  features
+} from "./chunk-ID4U6IQC.js";
+import {
+  Logger
+} from "./chunk-3PZWHUZO.js";
+
+// src/engines/BrowserDatabaseFactory.ts
+var BrowserDatabaseFactory = class {
+  /**
+   * Dynamically loads browser-compatible engines only
+   */
+  static async loadBrowserEngines() {
+    Logger.debug("[BrowserDatabaseFactory] Browser engines ready");
+  }
+  /**
+   * Auto-detects the best available engine for browser
+   */
+  static getRecommendedEngineType() {
+    if (features.hasWebAssembly) {
+      return "sqljs";
+    }
+    throw new Error(
+      "No compatible database engine found. WebAssembly is required for browser environments."
+    );
+  }
+  /**
+   * Creates a fallback engine when the requested engine is not available
+   */
+  static async createFallbackEngine(requestedType, config) {
+    const fallbackType = this.getRecommendedEngineType();
+    console.warn(
+      `[BrowserDatabaseFactory] Requested engine '${requestedType}' is not available. Falling back to '${fallbackType}'.`
+    );
+    const fallbackConfig = { ...config, type: fallbackType };
+    return this.createEngine(fallbackConfig, false);
+  }
+  /**
+   * Creates the specified database engine (browser-compatible only)
+   */
+  static async createEngine(config, allowFallback = true) {
+    const { type, options } = config;
+    const typeStr = type;
+    switch (type) {
+      case "sqljs":
+        const sqljsEngine = new SqljsEngine(options);
+        await sqljsEngine.ensureReady();
+        return sqljsEngine;
+      case "alasql":
+        throw new Error("AlaSQLEngine not yet implemented.");
+      default:
+        if (typeStr === "duckdb") {
+          if (allowFallback) {
+            console.warn(
+              "[BrowserDatabaseFactory] DuckDB engine is no longer supported, falling back to alternative engine"
+            );
+            return this.createFallbackEngine(typeStr, config);
+          }
+          throw new Error("DuckDB engine is no longer supported");
+        }
+        if (typeStr === "node-sqlite" || typeStr === "node-duckdb") {
+          if (allowFallback) {
+            console.warn(
+              `[BrowserDatabaseFactory] Engine '${typeStr}' is not available in browser. Falling back to browser-compatible engine.`
+            );
+            return this.createFallbackEngine(typeStr, config);
+          }
+          throw new Error(
+            `Engine '${typeStr}' is only available in Node.js environments`
+          );
+        }
+        throw new Error(`Unsupported database engine type: ${typeStr}`);
+    }
+  }
+  static async getEngine(config) {
+    await this.loadBrowserEngines();
+    Logger.debug(
+      `[BrowserDatabaseFactory] Creating engine for type: ${config.type}`
+    );
+    try {
+      const engine = await this.createEngine(config);
+      Logger.debug(
+        `[BrowserDatabaseFactory] Engine for type ${config.type} is ready.`
+      );
+      return engine;
+    } catch (error) {
+      console.error(
+        `[BrowserDatabaseFactory] Failed to create engine for type ${config.type}:`,
+        error
+      );
+      throw error;
+    }
+  }
+  /**
+   * Gets information about available engines in browser environment
+   */
+  static getAvailableEngines() {
+    const engines = [
+      {
+        type: "sqljs",
+        available: features.hasWebAssembly,
+        reason: !features.hasWebAssembly ? "WebAssembly not supported" : void 0
+      },
+      {
+        type: "node-sqlite",
+        available: false,
+        reason: "Node.js engines not available in browser"
+      }
+    ];
+    return engines;
+  }
+};
+export {
+  BrowserDatabaseFactory
+};
+//# sourceMappingURL=BrowserDatabaseFactory-WD4VX2VZ.js.map

package/dist/BrowserDatabaseFactory-WD4VX2VZ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/engines/BrowserDatabaseFactory.ts"],"sourcesContent":["import { DatabaseConfig } from \"../types/databaseTypes\";\nimport { DatabaseEngine } from \"./DatabaseEngine\";\nimport { SqljsEngine } from \"./SqljsEngine\";\nimport { features } from \"../utils/environment\";\nimport { Logger } from \"../models/BaseModel\";\n\nexport class BrowserDatabaseFactory {\n  /**\n   * Dynamically loads browser-compatible engines only\n   */\n  private static async loadBrowserEngines() {\n    // No dynamic loading needed for SQL.js as it's imported statically\n    Logger.debug(\"[BrowserDatabaseFactory] Browser engines ready\");\n  }\n\n  /**\n   * Auto-detects the best available engine for browser\n   */\n  private static getRecommendedEngineType(): string {\n    // In browser, prefer SQL.js as it's more stable than DuckDB-WASM\n    if (features.hasWebAssembly) {\n      return \"sqljs\";\n    }\n\n    throw new Error(\n      \"No compatible database engine found. WebAssembly is required for browser environments.\"\n    );\n  }\n\n  /**\n   * Creates a fallback engine when the requested engine is not available\n   */\n  private static async createFallbackEngine(\n    requestedType: string,\n    config: DatabaseConfig\n  ): Promise<DatabaseEngine> {\n    const fallbackType = this.getRecommendedEngineType();\n\n    console.warn(\n      `[BrowserDatabaseFactory] Requested engine '${requestedType}' is not available. ` +\n        `Falling back to '${fallbackType}'.`\n    );\n\n    const fallbackConfig = { ...config, type: fallbackType as any };\n    return this.createEngine(fallbackConfig, false); // Prevent infinite recursion\n  }\n\n  /**\n   * Creates the specified database engine (browser-compatible only)\n   */\n  private static async createEngine(\n    config: DatabaseConfig,\n    allowFallback: boolean = true\n  ): Promise<DatabaseEngine> {\n    const { type, options } = config;\n    const typeStr = type as string; // Cast to handle legacy engine types\n\n    switch (type) {\n      case \"sqljs\":\n        const sqljsEngine = new SqljsEngine(options as any);\n        await sqljsEngine.ensureReady();\n        return sqljsEngine;\n\n      case \"alasql\":\n        throw new Error(\"AlaSQLEngine not yet implemented.\");\n\n      default:\n        // Handle removed engine types and unsupported types\n        if (typeStr === \"duckdb\") {\n          if (allowFallback) {\n            console.warn(\n              \"[BrowserDatabaseFactory] DuckDB engine is no longer supported, falling back to alternative engine\"\n            );\n            return this.createFallbackEngine(typeStr, config);\n          }\n          throw new Error(\"DuckDB engine is no longer supported\");\n        }\n\n        if (typeStr === \"node-sqlite\" || typeStr === \"node-duckdb\") {\n          if (allowFallback) {\n            console.warn(\n              `[BrowserDatabaseFactory] Engine '${typeStr}' is not available in browser. Falling back to browser-compatible engine.`\n            );\n            return this.createFallbackEngine(typeStr, config);\n          }\n          throw new Error(\n            `Engine '${typeStr}' is only available in Node.js environments`\n          );\n        }\n\n        throw new Error(`Unsupported database engine type: ${typeStr}`);\n    }\n  }\n\n  public static async getEngine(\n    config: DatabaseConfig\n  ): Promise<DatabaseEngine> {\n    // Load browser engines\n    await this.loadBrowserEngines();\n\n    Logger.debug(\n      `[BrowserDatabaseFactory] Creating engine for type: ${config.type}`\n    );\n\n    try {\n      const engine = await this.createEngine(config);\n\n      Logger.debug(\n        `[BrowserDatabaseFactory] Engine for type ${config.type} is ready.`\n      );\n      return engine;\n    } catch (error) {\n      console.error(\n        `[BrowserDatabaseFactory] Failed to create engine for type ${config.type}:`,\n        error\n      );\n      throw error;\n    }\n  }\n\n  /**\n   * Gets information about available engines in browser environment\n   */\n  public static getAvailableEngines(): {\n    type: string;\n    available: boolean;\n    reason?: string;\n  }[] {\n    const engines = [\n      {\n        type: \"sqljs\",\n        available: features.hasWebAssembly,\n        reason: !features.hasWebAssembly\n          ? \"WebAssembly not supported\"\n          : undefined,\n      },\n      {\n        type: \"node-sqlite\",\n        available: false,\n        reason: \"Node.js engines not available in browser\",\n      },\n    ];\n\n    return engines;\n  }\n}\n"],"mappings":";;;;;;;;;;;AAMO,IAAM,yBAAN,MAA6B;AAAA;AAAA;AAAA;AAAA,EAIlC,aAAqB,qBAAqB;AAExC,WAAO,MAAM,gDAAgD;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA,EAKA,OAAe,2BAAmC;AAEhD,QAAI,SAAS,gBAAgB;AAC3B,aAAO;AAAA,IACT;AAEA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,aAAqB,qBACnB,eACA,QACyB;AACzB,UAAM,eAAe,KAAK,yBAAyB;AAEnD,YAAQ;AAAA,MACN,8CAA8C,aAAa,wCACrC,YAAY;AAAA,IACpC;AAEA,UAAM,iBAAiB,EAAE,GAAG,QAAQ,MAAM,aAAoB;AAC9D,WAAO,KAAK,aAAa,gBAAgB,KAAK;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA,EAKA,aAAqB,aACnB,QACA,gBAAyB,MACA;AACzB,UAAM,EAAE,MAAM,QAAQ,IAAI;AAC1B,UAAM,UAAU;AAEhB,YAAQ,MAAM;AAAA,MACZ,KAAK;AACH,cAAM,cAAc,IAAI,YAAY,OAAc;AAClD,cAAM,YAAY,YAAY;AAC9B,eAAO;AAAA,MAET,KAAK;AACH,cAAM,IAAI,MAAM,mCAAmC;AAAA,MAErD;AAEE,YAAI,YAAY,UAAU;AACxB,cAAI,eAAe;AACjB,oBAAQ;AAAA,cACN;AAAA,YACF;AACA,mBAAO,KAAK,qBAAqB,SAAS,MAAM;AAAA,UAClD;AACA,gBAAM,IAAI,MAAM,sCAAsC;AAAA,QACxD;AAEA,YAAI,YAAY,iBAAiB,YAAY,eAAe;AAC1D,cAAI,eAAe;AACjB,oBAAQ;AAAA,cACN,oCAAoC,OAAO;AAAA,YAC7C;AACA,mBAAO,KAAK,qBAAqB,SAAS,MAAM;AAAA,UAClD;AACA,gBAAM,IAAI;AAAA,YACR,WAAW,OAAO;AAAA,UACpB;AAAA,QACF;AAEA,cAAM,IAAI,MAAM,qCAAqC,OAAO,EAAE;AAAA,IAClE;AAAA,EACF;AAAA,EAEA,aAAoB,UAClB,QACyB;AAEzB,UAAM,KAAK,mBAAmB;AAE9B,WAAO;AAAA,MACL,sDAAsD,OAAO,IAAI;AAAA,IACnE;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,KAAK,aAAa,MAAM;AAE7C,aAAO;AAAA,QACL,4CAA4C,OAAO,IAAI;AAAA,MACzD;AACA,aAAO;AAAA,IACT,SAAS,OAAO;AACd,cAAQ;AAAA,QACN,6DAA6D,OAAO,IAAI;AAAA,QACxE;AAAA,MACF;AACA,YAAM;AAAA,IACR;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,OAAc,sBAIV;AACF,UAAM,UAAU;AAAA,MACd;AAAA,QACE,MAAM;AAAA,QACN,WAAW,SAAS;AAAA,QACpB,QAAQ,CAAC,SAAS,iBACd,8BACA;AAAA,MACN;AAAA,MACA;AAAA,QACE,MAAM;AAAA,QACN,WAAW;AAAA,QACX,QAAQ;AAAA,MACV;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}