@doync/client 0.1.0

package/dist/client-DHXO0dbf.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-DHXO0dbf.d.cts","names":["Input","Output","StandardTypedV1","Props","version","vendor","types","Types","input","output","InferInput","Schema","NonNullable","InferOutput","StandardSchemaV1","validate","value","Options","options","Result","Promise","SuccessResult","FailureResult","issues","libraryOptions","Record","ReadonlyArray","Issue","message","path","PropertyKey","PathSegment","key","StandardJSONSchemaV1","jsonSchema","Converter","Target","target"],"sources":["../../../node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts","../src/port.ts","../src/mutations.ts","../src/socket.ts","../src/replica/meta.ts","../src/replica/stamps.ts","../src/replica/index.ts","../src/engine.ts","../src/client.ts"],"x_google_ignoreList":[0],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+import { F as ClientMutation, I as ClientMutationHandler, L as ClientMutationRegistry, R as ClientMutationTx, _ as SchemaEventKind, b as ViewStatus, c as FalsyQuery, d as MutationResult, f as OnceView, g as SchemaEvent, h as QueryStatus, l as LogoutBehavior, m as PreloadOptions, o as ConnectionStatus, p as PreloadHandle, s as DoyncClient, u as MutationOptions, v as SubscribeOptions, y as View } from "./client-DHXO0dbf.cjs";
+export type { ClientMutation, ClientMutationHandler, ClientMutationRegistry, ClientMutationTx, ConnectionStatus, DoyncClient, FalsyQuery, LogoutBehavior, MutationOptions, MutationResult, OnceView, PreloadHandle, PreloadOptions, QueryStatus, SchemaEvent, SchemaEventKind, SubscribeOptions, View, ViewStatus };

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import { F as ClientMutation, I as ClientMutationHandler, L as ClientMutationRegistry, R as ClientMutationTx, _ as SchemaEventKind, b as ViewStatus, c as FalsyQuery, d as MutationResult, f as OnceView, g as SchemaEvent, h as QueryStatus, l as LogoutBehavior, m as PreloadOptions, o as ConnectionStatus, p as PreloadHandle, s as DoyncClient, u as MutationOptions, v as SubscribeOptions, y as View } from "./client-CNyLMCw0.js";
+export type { ClientMutation, ClientMutationHandler, ClientMutationRegistry, ClientMutationTx, ConnectionStatus, DoyncClient, FalsyQuery, LogoutBehavior, MutationOptions, MutationResult, OnceView, PreloadHandle, PreloadOptions, QueryStatus, SchemaEvent, SchemaEventKind, SubscribeOptions, View, ViewStatus };

package/dist/internal.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./client-C6jAdhbe.cjs");let t=require("@doync/sqlite-parser");function n(e){return encodeURIComponent(e).replaceAll(`_`,`%5F`)}function r(e,t){let r=n(e);return t===null?`doync__${r}__anon.db`:`doync__${r}__${n(t)}.db`}function i(e){let n;try{n=(0,t.parse)(e)}catch(t){return console.warn(`extractWriteTable: failed to parse SQL statement`,{sql:e,err:t}),null}switch(n.kind){case`STMT_INSERT`:case`STMT_UPDATE`:case`STMT_DELETE`:return n.table??null;default:return null}}exports.ClientEngine=e.r,exports.__CONNECTED_CLOCK_META_KEY=e.i,exports.__LOGOUT_BEHAVIOR_META_KEY=e.a,exports.applyBundledMigrations=e.l,exports.asClientMutation=e.v,exports.bundledSchemaDdl=e.h,exports.classifyClientStatement=e.g,exports.createClientEngine=e.n,exports.createEngineTables=e.u,exports.dbFileForUserId=r,exports.dropConsumerTables=e.d,exports.extractWriteTable=i,exports.isFalsyQuery=e.o,exports.normalizeQuerySurface=e.s,exports.readMeta=e.p,exports.replayMigrations=e.f,exports.settledRejection=e.c,exports.splitClientStatements=e._,exports.toClientMutationRegistry=e.b,exports.validateMutationArgs=e.y,exports.writeMeta=e.m;

package/dist/internal.d.cts

@@ -0,0 +1,69 @@
+import { A as readMeta, B as validateMutationArgs, C as isFalsyQuery, D as createEngineTables, E as applyBundledMigrations, L as ClientMutationRegistry, O as dropConsumerTables, S as __LOGOUT_BEHAVIOR_META_KEY, T as settledRejection, U as extractWriteTable, a as ClientEngineConfig, i as ClientEngine, j as writeMeta, k as replayMigrations, r as createClientEngine, w as normalizeQuerySurface, x as __CONNECTED_CLOCK_META_KEY, z as asClientMutation } from "./client-DHXO0dbf.cjs";
+import { DoyncSchema, MutationTree } from "@doync/core";
+
+//#region src/client-mutation-registry.d.ts
+/**
+* Flat `dottedName → {args, handler}` registry the client engine resolves
+* optimistic bodies against (ADR-0019). Feed the SHARED tree so no `.server.ts`
+* override enters the client bundle. Handler may return a promise (exclusive
+* chain awaits); engine validates args at `mutate()` via carried schema.
+*/
+declare function toClientMutationRegistry(tree: MutationTree): ClientMutationRegistry;
+//#endregion
+//#region src/identity.d.ts
+/**
+* Durable replica file for one `(Database name, asserted userId)` pair:
+* `doync__<name>__anon.db` when `userId` is `null`, else
+* `doync__<name>__<userId>.db`. Separators are `__` so hyphens (common in UUIDs
+* and ids) stay unescaped and filenames stay short enough for OPFS. Each half
+* is percent-encoded; `_` is additionally escaped so halves cannot forge a
+* separator.
+*/
+declare function dbFileForUserId(name: string, userId: string | null): string;
+//#endregion
+//#region src/migrate.d.ts
+/**
+* Parser-backed SQL classification for client DDL-only bundled-track replay
+* (ADR-0020 / ADR-0006). Same AST as the server conversation, narrower API: 1.
+* split migrations keeping trigger BEGIN…END whole; 2. ddl vs trigger (skip —
+* apply state, never enforce; ADR-0009/0020) vs backfill DML (skip — data via
+* feed; ADR-0006). Fails closed on unparseable input.
+*/
+/** How the client treats one already-split migration statement. */
+type ClientStatementKind = "ddl" | "trigger" | "dml" | "pragma" | "other";
+/**
+* Split a migration's SQL into its top-level statements. The parser understands
+* statement structure, so a `CREATE TRIGGER … BEGIN … END` body's internal
+* semicolons stay inside one statement — a migration may mix a trigger with
+* surrounding DDL without mis-splitting. Each statement is returned as its
+* canonical unparse (semantically identical to the source); statements that are
+* empty (whitespace/comments only) yield nothing.
+*
+* Fails closed: an unparseable script throws a clear error rather than applying
+* a partial or mis-read migration. Trusted input only in the sense that the
+* consumer authored the migrations — the parse itself validates their syntax.
+*/
+declare function splitClientStatements(sql: string): string[];
+/**
+* Classify ONE already-split statement by its parsed kind. `CREATE TRIGGER` and
+* `DROP TRIGGER` are `'trigger'` (the client neither creates nor drops triggers
+* — it runs none, ADR-0009); every other shape-changing DDL is `'ddl'`
+* (replayed); the row read/write verbs are `'dml'` (backfill, never replayed on
+* the client); `PRAGMA` and anything unrecognized/unparseable land in their own
+* buckets.
+*/
+declare function classifyClientStatement(statement: string): ClientStatementKind;
+/**
+* The non-trigger DDL statements of the bundled migrations in the half-open
+* range `(fromVersion, toVersion]` (0-based migration indices `fromVersion …
+* toVersion − 1`), in order — the replayable shape for the client's DDL-only
+* bundled-track replay (ADR-0020). Trigger DDL is skipped (ADR-0009) and
+* backfill DML never runs on the client (ADR-0006). Passing `fromVersion = 0`
+* yields the full track up to `toVersion` (a fresh replica); a higher
+* `fromVersion` yields just the newly-appended migrations (a mid-session
+* catch-up).
+*/
+declare function bundledSchemaDdl(schema: DoyncSchema, fromVersion: number, toVersion: number): string[];
+//#endregion
+export { ClientEngine, type ClientEngineConfig, type ClientStatementKind, __CONNECTED_CLOCK_META_KEY, __LOGOUT_BEHAVIOR_META_KEY, applyBundledMigrations, asClientMutation, bundledSchemaDdl, classifyClientStatement, createClientEngine, createEngineTables, dbFileForUserId, dropConsumerTables, extractWriteTable, isFalsyQuery, normalizeQuerySurface, readMeta, replayMigrations, settledRejection, splitClientStatements, toClientMutationRegistry, validateMutationArgs, writeMeta };
+//# sourceMappingURL=internal.d.cts.map

package/dist/internal.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.cts","names":[],"sources":["../src/client-mutation-registry.ts","../src/identity.ts","../src/migrate.ts"],"mappings":";;;;;;;;AAqBG;;iBAFa,wBAAA,CACd,IAAA,EAAM,YAAA,GACL,sBAAA;;;;;;;AAFH;;;;iBCgBgB,eAAA,CAAgB,IAAA,UAAc,MAAA;;;;;;ADhB9C;;;;;KEAY,mBAAA;;;AFET;;;;ACcH;;;;AAA8C;;iBCgE9B,qBAAA,CAAsB,GAAA;;AAhFtC;;;;AAAY;AAgFZ;;iBAkBgB,uBAAA,CACd,SAAA,WACC,mBAAA;;AApBmC;AAkBtC;;;;AAEG;AAeH;;;iBAAgB,gBAAA,CACd,MAAA,EAAQ,WAAA,EACR,WAAA,UACA,SAAA"}

package/dist/internal.d.ts

@@ -0,0 +1,69 @@
+import { A as readMeta, B as validateMutationArgs, C as isFalsyQuery, D as createEngineTables, E as applyBundledMigrations, L as ClientMutationRegistry, O as dropConsumerTables, S as __LOGOUT_BEHAVIOR_META_KEY, T as settledRejection, U as extractWriteTable, a as ClientEngineConfig, i as ClientEngine, j as writeMeta, k as replayMigrations, r as createClientEngine, w as normalizeQuerySurface, x as __CONNECTED_CLOCK_META_KEY, z as asClientMutation } from "./client-CNyLMCw0.js";
+import { DoyncSchema, MutationTree } from "@doync/core";
+
+//#region src/client-mutation-registry.d.ts
+/**
+* Flat `dottedName → {args, handler}` registry the client engine resolves
+* optimistic bodies against (ADR-0019). Feed the SHARED tree so no `.server.ts`
+* override enters the client bundle. Handler may return a promise (exclusive
+* chain awaits); engine validates args at `mutate()` via carried schema.
+*/
+declare function toClientMutationRegistry(tree: MutationTree): ClientMutationRegistry;
+//#endregion
+//#region src/identity.d.ts
+/**
+* Durable replica file for one `(Database name, asserted userId)` pair:
+* `doync__<name>__anon.db` when `userId` is `null`, else
+* `doync__<name>__<userId>.db`. Separators are `__` so hyphens (common in UUIDs
+* and ids) stay unescaped and filenames stay short enough for OPFS. Each half
+* is percent-encoded; `_` is additionally escaped so halves cannot forge a
+* separator.
+*/
+declare function dbFileForUserId(name: string, userId: string | null): string;
+//#endregion
+//#region src/migrate.d.ts
+/**
+* Parser-backed SQL classification for client DDL-only bundled-track replay
+* (ADR-0020 / ADR-0006). Same AST as the server conversation, narrower API: 1.
+* split migrations keeping trigger BEGIN…END whole; 2. ddl vs trigger (skip —
+* apply state, never enforce; ADR-0009/0020) vs backfill DML (skip — data via
+* feed; ADR-0006). Fails closed on unparseable input.
+*/
+/** How the client treats one already-split migration statement. */
+type ClientStatementKind = "ddl" | "trigger" | "dml" | "pragma" | "other";
+/**
+* Split a migration's SQL into its top-level statements. The parser understands
+* statement structure, so a `CREATE TRIGGER … BEGIN … END` body's internal
+* semicolons stay inside one statement — a migration may mix a trigger with
+* surrounding DDL without mis-splitting. Each statement is returned as its
+* canonical unparse (semantically identical to the source); statements that are
+* empty (whitespace/comments only) yield nothing.
+*
+* Fails closed: an unparseable script throws a clear error rather than applying
+* a partial or mis-read migration. Trusted input only in the sense that the
+* consumer authored the migrations — the parse itself validates their syntax.
+*/
+declare function splitClientStatements(sql: string): string[];
+/**
+* Classify ONE already-split statement by its parsed kind. `CREATE TRIGGER` and
+* `DROP TRIGGER` are `'trigger'` (the client neither creates nor drops triggers
+* — it runs none, ADR-0009); every other shape-changing DDL is `'ddl'`
+* (replayed); the row read/write verbs are `'dml'` (backfill, never replayed on
+* the client); `PRAGMA` and anything unrecognized/unparseable land in their own
+* buckets.
+*/
+declare function classifyClientStatement(statement: string): ClientStatementKind;
+/**
+* The non-trigger DDL statements of the bundled migrations in the half-open
+* range `(fromVersion, toVersion]` (0-based migration indices `fromVersion …
+* toVersion − 1`), in order — the replayable shape for the client's DDL-only
+* bundled-track replay (ADR-0020). Trigger DDL is skipped (ADR-0009) and
+* backfill DML never runs on the client (ADR-0006). Passing `fromVersion = 0`
+* yields the full track up to `toVersion` (a fresh replica); a higher
+* `fromVersion` yields just the newly-appended migrations (a mid-session
+* catch-up).
+*/
+declare function bundledSchemaDdl(schema: DoyncSchema, fromVersion: number, toVersion: number): string[];
+//#endregion
+export { ClientEngine, type ClientEngineConfig, type ClientStatementKind, __CONNECTED_CLOCK_META_KEY, __LOGOUT_BEHAVIOR_META_KEY, applyBundledMigrations, asClientMutation, bundledSchemaDdl, classifyClientStatement, createClientEngine, createEngineTables, dbFileForUserId, dropConsumerTables, extractWriteTable, isFalsyQuery, normalizeQuerySurface, readMeta, replayMigrations, settledRejection, splitClientStatements, toClientMutationRegistry, validateMutationArgs, writeMeta };
+//# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","names":[],"sources":["../src/client-mutation-registry.ts","../src/identity.ts","../src/migrate.ts"],"mappings":";;;;;;;;AAqBG;;iBAFa,wBAAA,CACd,IAAA,EAAM,YAAA,GACL,sBAAA;;;;;;;AAFH;;;;iBCgBgB,eAAA,CAAgB,IAAA,UAAc,MAAA;;;;;;ADhB9C;;;;;KEAY,mBAAA;;;AFET;;;;ACcH;;;;AAA8C;;iBCgE9B,qBAAA,CAAsB,GAAA;;AAhFtC;;;;AAAY;AAgFZ;;iBAkBgB,uBAAA,CACd,SAAA,WACC,mBAAA;;AApBmC;AAkBtC;;;;AAEG;AAeH;;;iBAAgB,gBAAA,CACd,MAAA,EAAQ,WAAA,EACR,WAAA,UACA,SAAA"}

package/dist/internal.js

@@ -0,0 +1,2 @@
+import{_ as e,a as t,b as n,c as r,d as i,f as a,g as o,h as s,i as c,l,m as u,n as d,o as f,p,r as m,s as h,u as g,v as _,y as v}from"./client-ClV8ce6X.js";import{parse as y}from"@doync/sqlite-parser";function b(e){return encodeURIComponent(e).replaceAll(`_`,`%5F`)}function x(e,t){let n=b(e);return t===null?`doync__${n}__anon.db`:`doync__${n}__${b(t)}.db`}function S(e){let t;try{t=y(e)}catch(t){return console.warn(`extractWriteTable: failed to parse SQL statement`,{sql:e,err:t}),null}switch(t.kind){case`STMT_INSERT`:case`STMT_UPDATE`:case`STMT_DELETE`:return t.table??null;default:return null}}export{m as ClientEngine,c as __CONNECTED_CLOCK_META_KEY,t as __LOGOUT_BEHAVIOR_META_KEY,l as applyBundledMigrations,_ as asClientMutation,s as bundledSchemaDdl,o as classifyClientStatement,d as createClientEngine,g as createEngineTables,x as dbFileForUserId,i as dropConsumerTables,S as extractWriteTable,f as isFalsyQuery,h as normalizeQuerySurface,p as readMeta,a as replayMigrations,r as settledRejection,e as splitClientStatements,n as toClientMutationRegistry,v as validateMutationArgs,u as writeMeta};
+//# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.js","names":[],"sources":["../src/identity.ts","../src/port.ts"],"sourcesContent":["/**\n * Per-(Database name, identity) replica filename (CONTEXT.md Database name;\n * ADR-0019 addendum / closeio/doync#187 / #321) — a PURE helper shared by every\n * platform that owns a durable replica file (web OPFS, mobile op-sqlite, …).\n *\n * The file key is `(name, userId)`: two Database names in one app never collide\n * on the same store, and each identity (`doync__<name>__<userId|anon>.db`) owns\n * its own replica, clientId, cookie, and pending queue so a shared device never\n * leaks one user's rows into another's session. The id is percent-encoded so an\n * exotic identity can never escape the filename (a `/` would otherwise mean a\n * subpath); a numeric/alphanumeric id (the common case, e.g. a GitHub id)\n * encodes to itself, keeping the file readable. Pre-release: no migration of\n * pre-#187 / pre-#321 filenames — wipe/redeploy owns the cutover.\n */\n\n/**\n * Encode one half of the replica filename so it cannot contain the format's\n * `__` separator and cannot form a path segment (`/`, etc.).\n *\n * `encodeURIComponent` leaves `_` intact; escaping `_` → `%5F` keeps `(name:\n * 'a__b', user: 'c')` from colliding with `(name: 'a', user: 'b__c')`.\n * UUID-shaped names (hyphens only) encode to themselves.\n */\nfunction encodeHalf(value: string): string {\n  return encodeURIComponent(value).replaceAll('_', '%5F')\n}\n\n/**\n * Durable replica file for one `(Database name, asserted userId)` pair:\n * `doync__<name>__anon.db` when `userId` is `null`, else\n * `doync__<name>__<userId>.db`. Separators are `__` so hyphens (common in UUIDs\n * and ids) stay unescaped and filenames stay short enough for OPFS. Each half\n * is percent-encoded; `_` is additionally escaped so halves cannot forge a\n * separator.\n */\nexport function dbFileForUserId(name: string, userId: string | null): string {\n  const encodedName = encodeHalf(name)\n  return userId === null\n    ? `doync__${encodedName}__anon.db`\n    : `doync__${encodedName}__${encodeHalf(userId)}.db`\n}\n","import type { SqlValue } from '@doync/core'\nimport type { Statement } from '@doync/sqlite-parser'\n\nimport { parse } from '@doync/sqlite-parser'\n\n/** One local-replica row: column name → {@link SqlValue}. */\nexport interface LocalRow {\n  [column: string]: SqlValue\n}\n\n// ADR-0019 (synchronous local-DB port; platform adapters supply the impl).\n/**\n * Synchronous local SQLite port the client engine drives. Platform adapters\n * (wa-sqlite, node:sqlite, op-sqlite) implement this; app code does not.\n * Transactions and savepoints are ordinary SQL via {@link LocalDb.exec}.\n */\nexport interface LocalDb {\n  /**\n   * Run one parameterized statement; return its rows (empty for writes/DDL/\n   * transaction control).\n   */\n  exec<T extends LocalRow = LocalRow>(sql: string, ...params: SqlValue[]): T[]\n\n  /**\n   * Run a multi-statement DDL script (no parameters). Used to replay bundled\n   * migrations when creating a fresh replica. Trusted input only.\n   */\n  execBatch(script: string): void\n\n  /**\n   * Consumer tables written since the last call, then clear the set. Used so\n   * only affected subscriptions re-project after a mutation or rebase.\n   */\n  drainWrittenTables(): Set<string>\n}\n\n/**\n * Extract the target table of one WRITE statement from its SQL text — the\n * adapter-side stand-in where no synchronous native change feed exists\n * (ADR-0019): node:sqlite has no update hook, and op-sqlite's hook delivers\n * callbacks via `invokeAsync` — a later event-loop turn, unusable for the\n * engine's drain-after-apply contract (closeio/doync#202 device pass).\n *\n * A real parse over `@doync/sqlite-parser`, not a keyword recognizer: the AST\n * attaches a `WITH …` CTE prefix to the DML node itself, so CTE-topped writes\n * (`WITH src AS (…) INSERT INTO t …`) extract their target with no string\n * games. Returns the unquoted table name for INSERT / REPLACE / UPDATE /\n * DELETE, or `null` for a non-write (SELECT, SAVEPOINT, PRAGMA, DDL) or\n * unparseable input.\n *\n * TRIGGER cascades remain invisible to statement text — and stay out of scope\n * by design: client replicas carry no triggers (the bundled-track replay strips\n * CREATE TRIGGER; ADR-0009 — clients apply state, never enforce).\n */\nexport function extractWriteTable(sql: string): string | null {\n  let statement: Statement\n  try {\n    statement = parse(sql)\n  } catch (err) {\n    console.warn('extractWriteTable: failed to parse SQL statement', {\n      sql,\n      err,\n    })\n    return null\n  }\n  switch (statement.kind) {\n    case 'STMT_INSERT':\n    case 'STMT_UPDATE':\n    case 'STMT_DELETE':\n      return statement.table ?? null\n    default:\n      return null\n  }\n}\n"],"mappings":"0MAuBA,SAAS,EAAW,EAAuB,CACzC,OAAO,mBAAmB,CAAK,CAAC,CAAC,WAAW,IAAK,KAAK,CACxD,CAUA,SAAgB,EAAgB,EAAc,EAA+B,CAC3E,IAAM,EAAc,EAAW,CAAI,EACnC,OAAO,IAAW,KACd,UAAU,EAAY,WACtB,UAAU,EAAY,IAAI,EAAW,CAAM,EAAE,IACnD,CCcA,SAAgB,EAAkB,EAA4B,CAC5D,IAAI,EACJ,GAAI,CACF,EAAY,EAAM,CAAG,CACvB,OAAS,EAAK,CAKZ,OAJA,QAAQ,KAAK,mDAAoD,CAC/D,MACA,KACF,CAAC,EACM,IACT,CACA,OAAQ,EAAU,KAAlB,CACE,IAAK,cACL,IAAK,cACL,IAAK,cACH,OAAO,EAAU,OAAS,KAC5B,QACE,OAAO,IACX,CACF"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@doync/client",
+  "version": "0.1.0",
+  "description": "doync client engine: optimistic Layer-1 savepoint/rebase over a synchronous local-DB port",
+  "keywords": [
+    "client",
+    "doync",
+    "local-first",
+    "sqlite",
+    "sync-engine"
+  ],
+  "license": "MIT",
+  "author": "Vitor Buzinaro",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/closeio/doync.git",
+    "directory": "packages/client"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./adapter": {
+      "import": {
+        "types": "./dist/adapter.d.ts",
+        "default": "./dist/adapter.js"
+      },
+      "require": {
+        "types": "./dist/adapter.d.cts",
+        "default": "./dist/adapter.cjs"
+      }
+    },
+    "./internal": {
+      "import": {
+        "types": "./dist/internal.d.ts",
+        "default": "./dist/internal.js"
+      },
+      "require": {
+        "types": "./dist/internal.d.cts",
+        "default": "./dist/internal.cjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@doync/core": "0.1.0",
+    "@doync/sqlite-parser": "0.3053001.0"
+  },
+  "devDependencies": {
+    "@standard-schema/spec": "^1.1.0",
+    "@types/node": "^24.13.2",
+    "drizzle-kit": "^0.31.10",
+    "drizzle-orm": "^0.45.2",
+    "tsdown": "^0.22.3",
+    "typescript": "^7.0.2",
+    "unplugin-raw": "^0.7.0",
+    "vitest": "4.1.9",
+    "@doync/drizzle": "0.1.0"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsdown",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,25 @@
+/**
+ * `@doync/client/adapter` (ADR-0033): the adapter-author surface — host-seam
+ * ports (`LocalDb`, `SyncSocket`), the reconnect coordinator, and
+ * `createClient` / `CreateClientOptions`. Same lockstep semver as the main
+ * entry; the distinction is audience (third-party adapter authors), not
+ * stability. App-facing call-surface types (`DoyncClient`, views, mutation
+ * types, `LogoutBehavior`) live on `@doync/client`. Engine construction
+ * plumbing (`createClientEngine`, replica DDL, mutation dispatch helpers) lives
+ * under `/internal`.
+ *
+ * Our own platform packages (`@doync/web`, `@doync/mobile`) use
+ * `createClientEngine` from `/internal` rather than `createClient` — the latter
+ * is the only real call site audience for a third-party adapter.
+ */
+
+export { createClient, type CreateClientOptions } from './client'
+export type { LocalDb, LocalRow } from './port'
+export type { SeamStatus, SyncSocket, SyncSocketHandlers } from './socket'
+export {
+  createReconnectingSocket,
+  type ReconnectSocket,
+  type ReconnectingSocket,
+  type ReconnectingSocketConfig,
+  type SocketCloseInfo,
+} from './socket-reconnect'

package/src/client-mutation-registry.ts

@@ -0,0 +1,31 @@
+/**
+ * Flatten a shared MutationTree to the engine's name-keyed client mutation
+ * registry (ADR-0019/0021, #167). Internal helper for {@link createClient} and
+ * `@doync/web` `createWorker` — consumers pass a MutationTree; the lib
+ * flattens.
+ */
+
+import type { MutationTree } from '@doync/core'
+
+import { flattenMutations } from '@doync/core/internal'
+
+import type { ClientMutation, ClientMutationRegistry } from './mutations'
+
+/**
+ * Flat `dottedName → {args, handler}` registry the client engine resolves
+ * optimistic bodies against (ADR-0019). Feed the SHARED tree so no `.server.ts`
+ * override enters the client bundle. Handler may return a promise (exclusive
+ * chain awaits); engine validates args at `mutate()` via carried schema.
+ */
+export function toClientMutationRegistry(
+  tree: MutationTree,
+): ClientMutationRegistry {
+  const out: Record<string, ClientMutation> = {}
+  for (const [name, def] of Object.entries(flattenMutations(tree))) {
+    out[name] = {
+      args: def.args,
+      handler: (args, ctx, sql) => def.body(args, ctx, sql),
+    }
+  }
+  return out
+}

package/src/client.ts

@@ -0,0 +1,100 @@
+import type { DoyncSchema, MutationTree } from '@doync/core'
+
+import type { DoyncClient, LogoutBehavior, SchemaEvent } from './engine'
+import type { LocalDb } from './port'
+import type { SyncSocket } from './socket'
+
+import { toClientMutationRegistry } from './client-mutation-registry'
+import { ClientEngine, __LOGOUT_BEHAVIOR_META_KEY } from './engine'
+import { createEngineTables, writeMeta } from './replica'
+
+// The durable logout-policy seam (ADR-0022) is owned by the engine (the layer
+// that owns `__doync_meta` and the runtime {@link ClientEngine.setLogoutBehavior}).
+// Only LogoutBehavior is public; the meta key stays on `./internal`.
+export type { LogoutBehavior } from './engine'
+
+// Identity is the asserted triple `{ token, ctx, userId }` — never derived
+// from a bearer token (ADR-0018 asserted-identity).
+/**
+ * Options for {@link createClient}. Platform adapters (`@doync/web`,
+ * `@doync/mobile`) fill these; app code rarely calls `createClient` directly.
+ */
+export interface CreateClientOptions<TAuthData = unknown> {
+  /** Synchronous local SQLite port (wa-sqlite / node:sqlite / op-sqlite). */
+  readonly db: LocalDb
+  /** Synced schema shared with Origin and Mirror. */
+  readonly schema: DoyncSchema
+  /**
+   * Shared mutation tree from `defineMutations(shared)` — no server overrides
+   * in the client bundle.
+   */
+  readonly mutations: MutationTree
+  /** Transport to the Mirror. */
+  readonly socket: SyncSocket
+  /**
+   * Bearer credential for the handshake. Does not drive `userId` or `ctx`. Omit
+   * for cookie-session auth.
+   */
+  readonly token?: string
+  /**
+   * Projected auth context for optimistic query/mutation resolution (mirror
+   * your server `toContext`). Defaults to `{}`.
+   */
+  readonly ctx?: TAuthData
+  /**
+   * Authenticated identity, or `null`/omit for anonymous. Never derived from
+   * `token`.
+   */
+  readonly userId?: string | null
+  /** Pin a durable client id across restarts. */
+  readonly clientId?: string
+  /** Observe schema/recovery transitions. */
+  readonly onSchemaEvent?: (event: SchemaEvent) => void
+  /**
+   * Initial {@link LogoutBehavior}, written durably when provided. Omit to keep
+   * a previously stored choice (a restart will not revert `forget` to `keep`).
+   * Change later via {@link DoyncClient.setLogoutBehavior}.
+   */
+  readonly logoutBehavior?: LogoutBehavior
+}
+
+/**
+ * Construct a {@link DoyncClient} from local DB, schema, shared mutations, and a
+ * Mirror socket. App code normally goes through `@doync/web` / `@doync/mobile`
+ * instead.
+ */
+export function createClient<TAuthData = unknown>(
+  options: CreateClientOptions<TAuthData>,
+): DoyncClient {
+  return createClientEngine(options)
+}
+
+/**
+ * Concrete-engine factory (ADR-0033 / closeio/doync#241). Same construction as
+ * {@link createClient}, but typed as {@link ClientEngine} so platform adapters
+ * (web DB-worker, mobile wrapper) can reach engine-only fields like `clientId`
+ * without an unchecked downcast. Exported on `@doync/client/internal` only.
+ */
+export function createClientEngine<TAuthData = unknown>(
+  options: CreateClientOptions<TAuthData>,
+): ClientEngine {
+  // Logout policy must land before boot (ADR-0022 / #135): construction opens
+  // the optimistic overlay (ADR-0019), so a later write on this connection would
+  // join the savepoint and roll back. Pre-boot is autocommit.
+  if (options.logoutBehavior !== undefined) {
+    createEngineTables(options.db)
+    writeMeta(options.db, __LOGOUT_BEHAVIOR_META_KEY, options.logoutBehavior)
+  }
+  return new ClientEngine({
+    db: options.db,
+    schema: options.schema,
+    mutations: toClientMutationRegistry(options.mutations),
+    socket: options.socket,
+    // Asserted identity (ADR-0018 / #167): never derived.
+    ctx: (options.ctx as Record<string, unknown> | undefined) ?? {},
+    token: options.token,
+    userId: options.userId ?? null,
+    clientId: options.clientId,
+    onSchemaEvent: options.onSchemaEvent,
+  })
+}