js-bao 0.2.10 → 0.3.0-alpha.0

package/README.md

@@ -1229,6 +1229,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/browser.cjs

@@ -349,7 +349,7 @@ var init_CursorManager = __esm({
           conditions.push(`(${levelCondition})`);
           params.push(...fieldParams);
         }
-        const sql = conditions.join(" OR ");
+        const sql = `(${conditions.join(" OR ")})`;
         return { sql, params };
       }
       /**
@@ -1310,7 +1310,7 @@ var init_BaseModel = __esm({
         Object.setPrototypeOf(this, _RecordNotFoundError.prototype);
       }
     };
-    SCHEMA_ACCESSORS_KEY = Symbol("jsBaoSchemaAccessors");
+    SCHEMA_ACCESSORS_KEY = /* @__PURE__ */ Symbol("jsBaoSchemaAccessors");
     BaseModel = class _BaseModel {
       static modelName;
       static listenersMap = /* @__PURE__ */ new Map();

package/dist/browser.js

@@ -327,7 +327,7 @@ var init_CursorManager = __esm({
           conditions.push(`(${levelCondition})`);
           params.push(...fieldParams);
         }
-        const sql = conditions.join(" OR ");
+        const sql = `(${conditions.join(" OR ")})`;
         return { sql, params };
       }
       /**
@@ -1288,7 +1288,7 @@ var init_BaseModel = __esm({
         Object.setPrototypeOf(this, _RecordNotFoundError.prototype);
       }
     };
-    SCHEMA_ACCESSORS_KEY = Symbol("jsBaoSchemaAccessors");
+    SCHEMA_ACCESSORS_KEY = /* @__PURE__ */ Symbol("jsBaoSchemaAccessors");
     BaseModel = class _BaseModel {
       static modelName;
       static listenersMap = /* @__PURE__ */ new Map();