taladb 0.5.0 → 0.6.0

package/dist/index.browser.mjs

@@ -0,0 +1,313 @@
+// src/config.browser.ts
+var ENDPOINT_FIELDS = [
+  "endpoint",
+  "insert_endpoint",
+  "update_endpoint",
+  "delete_endpoint"
+];
+function validateConfig(config) {
+  const sync = config.sync;
+  if (!sync) return;
+  for (const key of ENDPOINT_FIELDS) {
+    const url = sync[key];
+    if (url !== void 0 && !url.startsWith("http://") && !url.startsWith("https://")) {
+      throw new Error(
+        `TalaDB config: invalid endpoint URL "${url}" \u2014 must start with http:// or https://`
+      );
+    }
+  }
+}
+async function loadConfig(_configPath) {
+  return {};
+}
+
+// src/index.ts
+function detectPlatform() {
+  if (globalThis.nativeCallSyncHook !== void 0) {
+    return "react-native";
+  }
+  if (globalThis.window !== void 0 && typeof navigator !== "undefined") {
+    return "browser";
+  }
+  return "node";
+}
+var WorkerProxy = class {
+  constructor(port) {
+    this.pending = /* @__PURE__ */ new Map();
+    this.nextId = 1;
+    this.port = port;
+    this.port.onmessage = (e) => {
+      const { id, result, error } = e.data;
+      const p = this.pending.get(id);
+      if (p) {
+        this.pending.delete(id);
+        if (error === void 0) p.resolve(result);
+        else p.reject(new Error(error));
+      }
+    };
+    this.port.start?.();
+  }
+  send(op, args = {}) {
+    return new Promise((resolve, reject) => {
+      const id = this.nextId++;
+      this.pending.set(id, { resolve, reject });
+      this.port.postMessage({ id, op, ...args });
+    });
+  }
+};
+function makePoller(findFn, callback) {
+  let active = true;
+  let lastJson = "";
+  const poll = async () => {
+    if (!active) return;
+    try {
+      const docs = await findFn();
+      const json = JSON.stringify(docs);
+      if (json !== lastJson) {
+        lastJson = json;
+        callback(docs);
+      }
+    } catch {
+    }
+    if (active) setTimeout(poll, 300);
+  };
+  poll();
+  return () => {
+    active = false;
+  };
+}
+async function createBrowserDB(dbName, config) {
+  const workerUrl = new URL("@taladb/web/worker/taladb.worker.js", import.meta.url);
+  const worker = new Worker(workerUrl, { type: "module", name: "taladb" });
+  const proxy = new WorkerProxy(worker);
+  const configJson = config !== void 0 ? JSON.stringify(config) : void 0;
+  await proxy.send("init", { dbName, configJson });
+  const nudgeCallbacks = /* @__PURE__ */ new Set();
+  let channel = null;
+  if (typeof BroadcastChannel !== "undefined") {
+    channel = new BroadcastChannel(`taladb:${dbName}`);
+    channel.onmessage = (e) => {
+      if (e.data === "taladb:changed") {
+        for (const nudge of nudgeCallbacks) nudge();
+      }
+    };
+  }
+  function wrapCollection(name) {
+    const s = JSON.stringify;
+    return {
+      insert: (doc) => proxy.send("insert", { collection: name, docJson: s(doc) }),
+      insertMany: async (docs) => {
+        const json = await proxy.send("insertMany", {
+          collection: name,
+          docsJson: s(docs)
+        });
+        return JSON.parse(json);
+      },
+      find: async (filter) => {
+        const json = await proxy.send("find", {
+          collection: name,
+          filterJson: filter ? s(filter) : "null"
+        });
+        return JSON.parse(json);
+      },
+      findOne: async (filter) => {
+        const json = await proxy.send("findOne", {
+          collection: name,
+          filterJson: filter ? s(filter) : "null"
+        });
+        return JSON.parse(json);
+      },
+      updateOne: (filter, update) => proxy.send("updateOne", {
+        collection: name,
+        filterJson: s(filter),
+        updateJson: s(update)
+      }),
+      updateMany: (filter, update) => proxy.send("updateMany", {
+        collection: name,
+        filterJson: s(filter),
+        updateJson: s(update)
+      }),
+      deleteOne: (filter) => proxy.send("deleteOne", { collection: name, filterJson: s(filter) }),
+      deleteMany: (filter) => proxy.send("deleteMany", { collection: name, filterJson: s(filter) }),
+      count: (filter) => proxy.send("count", {
+        collection: name,
+        filterJson: filter ? s(filter) : "null"
+      }),
+      createIndex: (field) => proxy.send("createIndex", { collection: name, field }),
+      dropIndex: (field) => proxy.send("dropIndex", { collection: name, field }),
+      createFtsIndex: (field) => proxy.send("createFtsIndex", { collection: name, field }),
+      dropFtsIndex: (field) => proxy.send("dropFtsIndex", { collection: name, field }),
+      createVectorIndex: (field, options) => {
+        if (options.indexType === "hnsw") return Promise.reject(new Error("HNSW vector indexes are not available in the browser (requires native threads). Use Node.js or React Native."));
+        return proxy.send("createVectorIndex", {
+          collection: name,
+          field,
+          dimensions: options.dimensions,
+          metric: options.metric,
+          indexType: null,
+          hnswM: null,
+          hnswEfConstruction: null
+        });
+      },
+      dropVectorIndex: (field) => proxy.send("dropVectorIndex", { collection: name, field }),
+      upgradeVectorIndex: (_field) => Promise.reject(new Error("HNSW vector indexes are not available in the browser (requires native threads). Use Node.js or React Native.")),
+      listIndexes: async () => {
+        const json = await proxy.send("listIndexes", { collection: name });
+        return JSON.parse(json);
+      },
+      findNearest: async (field, vector, topK, filter) => {
+        const json = await proxy.send("findNearest", {
+          collection: name,
+          field,
+          queryJson: JSON.stringify(vector),
+          topK,
+          filterJson: filter ? JSON.stringify(filter) : "null"
+        });
+        return JSON.parse(json);
+      },
+      subscribe: (filter, callback) => {
+        let active = true;
+        let lastJson = "[]";
+        let timer = null;
+        const poll = async () => {
+          if (!active) return;
+          if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+          }
+          try {
+            const json = await proxy.send("find", {
+              collection: name,
+              filterJson: filter ? s(filter) : "null"
+            });
+            if (json !== lastJson) {
+              lastJson = json;
+              callback(JSON.parse(json));
+            }
+          } catch {
+          }
+          if (active) timer = setTimeout(poll, 300);
+        };
+        nudgeCallbacks.add(poll);
+        poll();
+        return () => {
+          active = false;
+          nudgeCallbacks.delete(poll);
+          if (timer !== null) {
+            clearTimeout(timer);
+            timer = null;
+          }
+        };
+      }
+    };
+  }
+  return {
+    collection: (name) => wrapCollection(name),
+    close: async () => {
+      channel?.close();
+      await proxy.send("close");
+      worker.terminate();
+    }
+  };
+}
+async function createNodeDB(dbName, config) {
+  const { TalaDBNode } = await import("@taladb/node");
+  const configJson = config !== void 0 ? JSON.stringify(config) : null;
+  const db = TalaDBNode.open(dbName, configJson);
+  function wrapCollection(name) {
+    const col = db.collection(name);
+    return {
+      insert: async (doc) => col.insert(doc),
+      insertMany: async (docs) => col.insertMany(docs),
+      find: async (filter) => col.find(filter ?? null),
+      findOne: async (filter) => col.findOne(filter) ?? null,
+      updateOne: async (filter, update) => col.updateOne(filter, update),
+      updateMany: async (filter, update) => col.updateMany(filter, update),
+      deleteOne: async (filter) => col.deleteOne(filter),
+      deleteMany: async (filter) => col.deleteMany(filter),
+      count: async (filter) => col.count(filter ?? null),
+      createIndex: async (field) => col.createIndex(field),
+      dropIndex: async (field) => col.dropIndex(field),
+      createFtsIndex: async (field) => col.createFtsIndex(field),
+      dropFtsIndex: async (field) => col.dropFtsIndex(field),
+      createVectorIndex: async (field, options) => col.createVectorIndex(field, options.dimensions, options.metric ?? null, options.indexType ?? null, options.hnswM ?? null, options.hnswEfConstruction ?? null),
+      dropVectorIndex: async (field) => col.dropVectorIndex(field),
+      upgradeVectorIndex: async (field) => col.upgradeVectorIndex(field),
+      listIndexes: async () => {
+        const json = col.listIndexes();
+        return JSON.parse(json);
+      },
+      findNearest: async (field, vector, topK, filter) => {
+        const raw = await col.findNearest(field, vector, topK, filter ?? null);
+        return raw;
+      },
+      subscribe: (filter, callback) => makePoller(async () => col.find(filter ?? null), callback)
+    };
+  }
+  return {
+    collection: (name) => wrapCollection(name),
+    close: async () => {
+    }
+  };
+}
+async function createNativeDB(_dbName) {
+  const maybeNative = globalThis.__TalaDB__;
+  if (!maybeNative) {
+    throw new Error(
+      "@taladb/react-native JSI HostObject not found. Did you call TalaDBModule.initialize() in your app entry point?"
+    );
+  }
+  const native = maybeNative;
+  function wrapCollection(name) {
+    const col = native.collection(name);
+    return {
+      insert: async (doc) => col.insert(doc),
+      insertMany: async (docs) => col.insertMany(docs),
+      find: async (filter) => col.find(filter ?? {}),
+      findOne: async (filter) => col.findOne(filter ?? {}),
+      updateOne: async (filter, update) => col.updateOne(filter, update),
+      updateMany: async (filter, update) => col.updateMany(filter, update),
+      deleteOne: async (filter) => col.deleteOne(filter),
+      deleteMany: async (filter) => col.deleteMany(filter),
+      count: async (filter) => col.count(filter ?? {}),
+      createIndex: async (field) => col.createIndex(field),
+      dropIndex: async (field) => col.dropIndex(field),
+      createFtsIndex: async (field) => col.createFtsIndex(field),
+      dropFtsIndex: async (field) => col.dropFtsIndex(field),
+      createVectorIndex: async (field, options) => col.createVectorIndex(field, options.dimensions, options.metric ?? null, options.indexType ?? null, options.hnswM ?? null, options.hnswEfConstruction ?? null),
+      dropVectorIndex: async (field) => col.dropVectorIndex(field),
+      upgradeVectorIndex: async (field) => col.upgradeVectorIndex(field),
+      listIndexes: async () => JSON.parse(col.listIndexes()),
+      findNearest: async (field, vector, topK, filter) => {
+        const raw = col.findNearest(field, vector, topK, filter ?? null);
+        return raw;
+      },
+      subscribe: (filter, callback) => makePoller(async () => col.find(filter ?? {}), callback)
+    };
+  }
+  return {
+    collection: (name) => wrapCollection(name),
+    close: async () => native.close()
+  };
+}
+async function openDB(dbName = "taladb.db", options) {
+  let resolvedConfig;
+  if (options?.config !== void 0) {
+    validateConfig(options.config);
+    resolvedConfig = options.config;
+  } else {
+    resolvedConfig = await loadConfig(options?.configPath);
+  }
+  const platform = detectPlatform();
+  switch (platform) {
+    case "browser":
+      return createBrowserDB(dbName, resolvedConfig);
+    case "react-native":
+      return createNativeDB(dbName);
+    case "node":
+      return createNodeDB(dbName, resolvedConfig);
+  }
+}
+export {
+  openDB
+};

package/dist/index.d.mts

@@ -170,17 +170,75 @@ interface TalaDB {
     close(): Promise<void>;
 }
 
+/** HTTP push sync settings. */
+interface SyncConfig {
+    /**
+     * Enable HTTP push sync. Defaults to `false`.
+     * Everything is a no-op when disabled, so a config block without
+     * `enabled: true` is safe to ship.
+     */
+    enabled?: boolean;
+    /**
+     * Default endpoint URL that receives all mutation events.
+     * Required when `enabled: true`.
+     */
+    endpoint?: string;
+    /** HTTP headers sent with every outgoing request (e.g. `Authorization`). */
+    headers?: Record<string, string>;
+    /** Override the endpoint for `insert` events only. */
+    insert_endpoint?: string;
+    /** Override the endpoint for `update` events only. */
+    update_endpoint?: string;
+    /** Override the endpoint for `delete` events only. */
+    delete_endpoint?: string;
+    /**
+     * Document fields to omit from every outgoing sync payload.
+     *
+     * Useful for stripping large computed fields such as embedding vectors
+     * that the remote endpoint doesn't need.
+     *
+     * @example
+     * exclude_fields: ['embedding', 'clip_vector']
+     */
+    exclude_fields?: string[];
+}
+/** Top-level TalaDB configuration. */
+interface TalaDbConfig {
+    /** HTTP push sync configuration. Disabled by default. */
+    sync?: SyncConfig;
+}
+
+/** Options for `openDB`. */
+interface OpenDBOptions {
+    /**
+     * Explicit path to a `taladb.config.yml` / `taladb.config.json` file.
+     * If omitted, TalaDB auto-discovers the file from `process.cwd()` on Node.js.
+     * Ignored on browser and React Native — those platforms do not support
+     * file-based config discovery. Pass `config` inline instead, or on React Native
+     * pass `JSON.stringify(config)` as the second argument to `TalaDBModule.initialize`.
+     */
+    configPath?: string;
+    /**
+     * Inline config object. Takes precedence over any config file when provided.
+     * Useful for passing config programmatically without a config file on disk.
+     */
+    config?: TalaDbConfig;
+}
 /**
  * Open a TalaDB database.
  *
- * @param dbName  Name of the database file (used for OPFS and native file paths).
- *                Ignored for in-memory databases.
+ * @param dbName   Name of the database file (used for OPFS and native file paths).
+ * @param options  Optional config. Pass `{ config }` for inline sync settings or
+ *                 `{ configPath }` to load from a specific file.
  *
  * @example
  * const db = await openDB('myapp.db');
- * const users = db.collection<User>('users');
- * const id = await users.insert({ name: 'Alice', age: 30 });
+ *
+ * @example with inline sync config
+ * const db = await openDB('myapp.db', {
+ *   config: { sync: { enabled: true, endpoint: 'https://api.example.com/events' } },
+ * });
  */
-declare function openDB(dbName?: string): Promise<TalaDB>;
+declare function openDB(dbName?: string, options?: OpenDBOptions): Promise<TalaDB>;
 
-export { type Collection, type CollectionIndexInfo, type Document, type Filter, type TalaDB, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, openDB };
+export { type Collection, type CollectionIndexInfo, type Document, type Filter, type OpenDBOptions, type SyncConfig, type TalaDB, type TalaDbConfig, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, openDB };

package/dist/index.d.ts

@@ -170,17 +170,75 @@ interface TalaDB {
     close(): Promise<void>;
 }
 
+/** HTTP push sync settings. */
+interface SyncConfig {
+    /**
+     * Enable HTTP push sync. Defaults to `false`.
+     * Everything is a no-op when disabled, so a config block without
+     * `enabled: true` is safe to ship.
+     */
+    enabled?: boolean;
+    /**
+     * Default endpoint URL that receives all mutation events.
+     * Required when `enabled: true`.
+     */
+    endpoint?: string;
+    /** HTTP headers sent with every outgoing request (e.g. `Authorization`). */
+    headers?: Record<string, string>;
+    /** Override the endpoint for `insert` events only. */
+    insert_endpoint?: string;
+    /** Override the endpoint for `update` events only. */
+    update_endpoint?: string;
+    /** Override the endpoint for `delete` events only. */
+    delete_endpoint?: string;
+    /**
+     * Document fields to omit from every outgoing sync payload.
+     *
+     * Useful for stripping large computed fields such as embedding vectors
+     * that the remote endpoint doesn't need.
+     *
+     * @example
+     * exclude_fields: ['embedding', 'clip_vector']
+     */
+    exclude_fields?: string[];
+}
+/** Top-level TalaDB configuration. */
+interface TalaDbConfig {
+    /** HTTP push sync configuration. Disabled by default. */
+    sync?: SyncConfig;
+}
+
+/** Options for `openDB`. */
+interface OpenDBOptions {
+    /**
+     * Explicit path to a `taladb.config.yml` / `taladb.config.json` file.
+     * If omitted, TalaDB auto-discovers the file from `process.cwd()` on Node.js.
+     * Ignored on browser and React Native — those platforms do not support
+     * file-based config discovery. Pass `config` inline instead, or on React Native
+     * pass `JSON.stringify(config)` as the second argument to `TalaDBModule.initialize`.
+     */
+    configPath?: string;
+    /**
+     * Inline config object. Takes precedence over any config file when provided.
+     * Useful for passing config programmatically without a config file on disk.
+     */
+    config?: TalaDbConfig;
+}
 /**
  * Open a TalaDB database.
  *
- * @param dbName  Name of the database file (used for OPFS and native file paths).
- *                Ignored for in-memory databases.
+ * @param dbName   Name of the database file (used for OPFS and native file paths).
+ * @param options  Optional config. Pass `{ config }` for inline sync settings or
+ *                 `{ configPath }` to load from a specific file.
  *
  * @example
  * const db = await openDB('myapp.db');
- * const users = db.collection<User>('users');
- * const id = await users.insert({ name: 'Alice', age: 30 });
+ *
+ * @example with inline sync config
+ * const db = await openDB('myapp.db', {
+ *   config: { sync: { enabled: true, endpoint: 'https://api.example.com/events' } },
+ * });
  */
-declare function openDB(dbName?: string): Promise<TalaDB>;
+declare function openDB(dbName?: string, options?: OpenDBOptions): Promise<TalaDB>;
 
-export { type Collection, type CollectionIndexInfo, type Document, type Filter, type TalaDB, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, openDB };
+export { type Collection, type CollectionIndexInfo, type Document, type Filter, type OpenDBOptions, type SyncConfig, type TalaDB, type TalaDbConfig, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, openDB };

package/dist/index.js

@@ -33,6 +33,75 @@ __export(index_exports, {
   openDB: () => openDB
 });
 module.exports = __toCommonJS(index_exports);
+
+// src/config.ts
+var ENDPOINT_FIELDS = [
+  "endpoint",
+  "insert_endpoint",
+  "update_endpoint",
+  "delete_endpoint"
+];
+function validateConfig(config) {
+  const sync = config.sync;
+  if (!sync) return;
+  for (const key of ENDPOINT_FIELDS) {
+    const url = sync[key];
+    if (url !== void 0 && !url.startsWith("http://") && !url.startsWith("https://")) {
+      throw new Error(
+        `TalaDB config: invalid endpoint URL "${url}" \u2014 must start with http:// or https://`
+      );
+    }
+  }
+}
+async function loadConfig(configPath) {
+  if (typeof process === "undefined" || typeof process.cwd !== "function") {
+    return {};
+  }
+  const { join, extname } = await import(
+    /* @vite-ignore */
+    "path"
+  );
+  const { readFile, access } = await import(
+    /* @vite-ignore */
+    "fs/promises"
+  );
+  async function parseFile(filePath) {
+    const content = await readFile(filePath, "utf8");
+    const ext = extname(filePath).toLowerCase();
+    let raw;
+    if (ext === ".json") {
+      raw = JSON.parse(content);
+    } else if (ext === ".yml" || ext === ".yaml") {
+      const yaml = await import(
+        /* @vite-ignore */
+        "js-yaml"
+      );
+      raw = yaml.load(content);
+    } else {
+      throw new Error(
+        `TalaDB config: unsupported file extension "${ext}" \u2014 use .json, .yml, or .yaml`
+      );
+    }
+    const config = raw !== null && typeof raw === "object" ? raw : {};
+    validateConfig(config);
+    return config;
+  }
+  if (configPath) {
+    return parseFile(configPath);
+  }
+  const cwd = process.cwd();
+  for (const name of ["taladb.config.yml", "taladb.config.yaml", "taladb.config.json"]) {
+    const full = join(cwd, name);
+    try {
+      await access(full);
+      return parseFile(full);
+    } catch {
+    }
+  }
+  return {};
+}
+
+// src/index.ts
 var import_meta = {};
 function detectPlatform() {
   if (globalThis.nativeCallSyncHook !== void 0) {
@@ -88,11 +157,12 @@ function makePoller(findFn, callback) {
     active = false;
   };
 }
-async function createBrowserDB(dbName) {
+async function createBrowserDB(dbName, config) {
   const workerUrl = new URL("@taladb/web/worker/taladb.worker.js", import_meta.url);
   const worker = new Worker(workerUrl, { type: "module", name: "taladb" });
   const proxy = new WorkerProxy(worker);
-  await proxy.send("init", { dbName });
+  const configJson = config !== void 0 ? JSON.stringify(config) : void 0;
+  await proxy.send("init", { dbName, configJson });
   const nudgeCallbacks = /* @__PURE__ */ new Set();
   let channel = null;
   if (typeof BroadcastChannel !== "undefined") {
@@ -221,9 +291,10 @@ async function createBrowserDB(dbName) {
     }
   };
 }
-async function createNodeDB(dbName) {
+async function createNodeDB(dbName, config) {
   const { TalaDBNode } = await import("@taladb/node");
-  const db = TalaDBNode.open(dbName);
+  const configJson = config !== void 0 ? JSON.stringify(config) : null;
+  const db = TalaDBNode.open(dbName, configJson);
   function wrapCollection(name) {
     const col = db.collection(name);
     return {
@@ -300,15 +371,22 @@ async function createNativeDB(_dbName) {
     close: async () => native.close()
   };
 }
-async function openDB(dbName = "taladb.db") {
+async function openDB(dbName = "taladb.db", options) {
+  let resolvedConfig;
+  if (options?.config !== void 0) {
+    validateConfig(options.config);
+    resolvedConfig = options.config;
+  } else {
+    resolvedConfig = await loadConfig(options?.configPath);
+  }
   const platform = detectPlatform();
   switch (platform) {
     case "browser":
-      return createBrowserDB(dbName);
+      return createBrowserDB(dbName, resolvedConfig);
     case "react-native":
       return createNativeDB(dbName);
     case "node":
-      return createNodeDB(dbName);
+      return createNodeDB(dbName, resolvedConfig);
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -1,3 +1,70 @@
+// src/config.ts
+var ENDPOINT_FIELDS = [
+  "endpoint",
+  "insert_endpoint",
+  "update_endpoint",
+  "delete_endpoint"
+];
+function validateConfig(config) {
+  const sync = config.sync;
+  if (!sync) return;
+  for (const key of ENDPOINT_FIELDS) {
+    const url = sync[key];
+    if (url !== void 0 && !url.startsWith("http://") && !url.startsWith("https://")) {
+      throw new Error(
+        `TalaDB config: invalid endpoint URL "${url}" \u2014 must start with http:// or https://`
+      );
+    }
+  }
+}
+async function loadConfig(configPath) {
+  if (typeof process === "undefined" || typeof process.cwd !== "function") {
+    return {};
+  }
+  const { join, extname } = await import(
+    /* @vite-ignore */
+    "path"
+  );
+  const { readFile, access } = await import(
+    /* @vite-ignore */
+    "fs/promises"
+  );
+  async function parseFile(filePath) {
+    const content = await readFile(filePath, "utf8");
+    const ext = extname(filePath).toLowerCase();
+    let raw;
+    if (ext === ".json") {
+      raw = JSON.parse(content);
+    } else if (ext === ".yml" || ext === ".yaml") {
+      const yaml = await import(
+        /* @vite-ignore */
+        "js-yaml"
+      );
+      raw = yaml.load(content);
+    } else {
+      throw new Error(
+        `TalaDB config: unsupported file extension "${ext}" \u2014 use .json, .yml, or .yaml`
+      );
+    }
+    const config = raw !== null && typeof raw === "object" ? raw : {};
+    validateConfig(config);
+    return config;
+  }
+  if (configPath) {
+    return parseFile(configPath);
+  }
+  const cwd = process.cwd();
+  for (const name of ["taladb.config.yml", "taladb.config.yaml", "taladb.config.json"]) {
+    const full = join(cwd, name);
+    try {
+      await access(full);
+      return parseFile(full);
+    } catch {
+    }
+  }
+  return {};
+}
+
 // src/index.ts
 function detectPlatform() {
   if (globalThis.nativeCallSyncHook !== void 0) {
@@ -53,11 +120,12 @@ function makePoller(findFn, callback) {
     active = false;
   };
 }
-async function createBrowserDB(dbName) {
+async function createBrowserDB(dbName, config) {
   const workerUrl = new URL("@taladb/web/worker/taladb.worker.js", import.meta.url);
   const worker = new Worker(workerUrl, { type: "module", name: "taladb" });
   const proxy = new WorkerProxy(worker);
-  await proxy.send("init", { dbName });
+  const configJson = config !== void 0 ? JSON.stringify(config) : void 0;
+  await proxy.send("init", { dbName, configJson });
   const nudgeCallbacks = /* @__PURE__ */ new Set();
   let channel = null;
   if (typeof BroadcastChannel !== "undefined") {
@@ -186,9 +254,10 @@ async function createBrowserDB(dbName) {
     }
   };
 }
-async function createNodeDB(dbName) {
+async function createNodeDB(dbName, config) {
   const { TalaDBNode } = await import("@taladb/node");
-  const db = TalaDBNode.open(dbName);
+  const configJson = config !== void 0 ? JSON.stringify(config) : null;
+  const db = TalaDBNode.open(dbName, configJson);
   function wrapCollection(name) {
     const col = db.collection(name);
     return {
@@ -265,15 +334,22 @@ async function createNativeDB(_dbName) {
     close: async () => native.close()
   };
 }
-async function openDB(dbName = "taladb.db") {
+async function openDB(dbName = "taladb.db", options) {
+  let resolvedConfig;
+  if (options?.config !== void 0) {
+    validateConfig(options.config);
+    resolvedConfig = options.config;
+  } else {
+    resolvedConfig = await loadConfig(options?.configPath);
+  }
   const platform = detectPlatform();
   switch (platform) {
     case "browser":
-      return createBrowserDB(dbName);
+      return createBrowserDB(dbName, resolvedConfig);
     case "react-native":
       return createNativeDB(dbName);
     case "node":
-      return createNodeDB(dbName);
+      return createNodeDB(dbName, resolvedConfig);
   }
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taladb",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Local-first document and vector database for React, React Native, and Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -8,6 +8,7 @@
   "sideEffects": false,
   "exports": {
     ".": {
+      "browser": "./dist/index.browser.mjs",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
       "require": "./dist/index.js"
@@ -49,7 +50,12 @@
   "engines": {
     "node": ">=18"
   },
+  "dependencies": {
+    "js-yaml": "^4.1.0"
+  },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.9.3",
     "vitest": "^3.2.0"