@syncular/client 0.0.5-42 → 0.0.6-101

package/dist/sync.d.ts

@@ -0,0 +1,32 @@
+import type { ColumnCodecDialect, ColumnCodecSource, ScopeDefinition, ScopeValuesFromPatterns, SyncSubscriptionRequest } from '@syncular/core';
+import { type CreateClientHandlerOptions } from './handlers/create-handler';
+import type { ClientTableHandler } from './handlers/types';
+import type { SyncClientDb } from './schema';
+type ClientSyncSubscription<ScopeDefs extends readonly ScopeDefinition[]> = Omit<SyncSubscriptionRequest, 'cursor' | 'table' | 'scopes'> & {
+    table: string;
+    scopes?: ScopeValuesFromPatterns<ScopeDefs>;
+};
+type SharedTableName<DB extends SyncClientDb> = keyof DB & string;
+export type ClientSyncHandlerOptionsForTable<DB extends SyncClientDb, TableName extends SharedTableName<DB>, ScopeDefs extends readonly ScopeDefinition[], Identity> = Omit<CreateClientHandlerOptions<DB, TableName, ScopeDefs>, 'codecs' | 'codecDialect' | 'subscribe'> & {
+    codecs?: ColumnCodecSource;
+    codecDialect?: ColumnCodecDialect;
+    subscribe?: ClientSyncSubscription<ScopeDefs> | ClientSyncSubscription<ScopeDefs>[] | null | ((args: {
+        identity: Identity;
+    }) => ClientSyncSubscription<ScopeDefs> | ClientSyncSubscription<ScopeDefs>[] | null);
+};
+export interface ClientSyncConfig<DB extends SyncClientDb = SyncClientDb, Identity = {
+    actorId: string;
+}> {
+    handlers: ClientTableHandler<DB>[];
+    subscriptions(identity: Identity): Array<Omit<SyncSubscriptionRequest, 'cursor'>>;
+}
+export interface DefineClientSyncOptions {
+    codecs?: ColumnCodecSource;
+    codecDialect?: ColumnCodecDialect;
+}
+export interface ClientSyncBuilder<DB extends SyncClientDb, ScopeDefs extends readonly ScopeDefinition[], Identity> extends ClientSyncConfig<DB, Identity> {
+    addHandler<TableName extends SharedTableName<DB>>(options: ClientSyncHandlerOptionsForTable<DB, TableName, ScopeDefs, Identity>): this;
+}
+export declare function defineClientSync<DB extends SyncClientDb, ScopeDefs extends readonly ScopeDefinition[], Identity>(options: DefineClientSyncOptions): ClientSyncBuilder<DB, ScopeDefs, Identity>;
+export {};
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAEf,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,KAAK,0BAA0B,EAEhC,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,KAAK,sBAAsB,CAAC,SAAS,SAAS,SAAS,eAAe,EAAE,IACtE,IAAI,CAAC,uBAAuB,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC,GAAG;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;CAC7C,CAAC;AAEJ,KAAK,eAAe,CAAC,EAAE,SAAS,YAAY,IAAI,MAAM,EAAE,GAAG,MAAM,CAAC;AAElE,MAAM,MAAM,gCAAgC,CAC1C,EAAE,SAAS,YAAY,EACvB,SAAS,SAAS,eAAe,CAAC,EAAE,CAAC,EACrC,SAAS,SAAS,SAAS,eAAe,EAAE,EAC5C,QAAQ,IACN,IAAI,CACN,0BAA0B,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,EACpD,QAAQ,GAAG,cAAc,GAAG,WAAW,CACxC,GAAG;IACF,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAClC,SAAS,CAAC,EACN,sBAAsB,CAAC,SAAS,CAAC,GACjC,sBAAsB,CAAC,SAAS,CAAC,EAAE,GACnC,IAAI,GACJ,CAAC,CAAC,IAAI,EAAE;QACN,QAAQ,EAAE,QAAQ,CAAC;KACpB,KACG,sBAAsB,CAAC,SAAS,CAAC,GACjC,sBAAsB,CAAC,SAAS,CAAC,EAAE,GACnC,IAAI,CAAC,CAAC;CACf,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAC/B,EAAE,SAAS,YAAY,GAAG,YAAY,EACtC,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE;IAE9B,QAAQ,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;IACnC,aAAa,CACX,QAAQ,EAAE,QAAQ,GACjB,KAAK,CAAC,IAAI,CAAC,uBAAuB,EAAE,QAAQ,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB,CAChC,EAAE,SAAS,YAAY,EACvB,SAAS,SAAS,SAAS,eAAe,EAAE,EAC5C,QAAQ,CACR,SAAQ,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtC,UAAU,CAAC,SAAS,SAAS,eAAe,CAAC,EAAE,CAAC,EAC9C,OAAO,EAAE,gCAAgC,CACvC,EAAE,EACF,SAAS,EACT,SAAS,EACT,QAAQ,CACT,GACA,IAAI,CAAC;CACT;AAED,wBAAgB,gBAAgB,CAC9B,EAAE,SAAS,YAAY,EACvB,SAAS,SAAS,SAAS,eAAe,EAAE,EAC5C,QAAQ,EAER,OAAO,EAAE,uBAAuB,GAC/B,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,CAAC,CAuF5C"}

package/dist/sync.js

@@ -0,0 +1,55 @@
+import { createClientHandler, } from './handlers/create-handler.js';
+export function defineClientSync(options) {
+    const handlers = [];
+    const registeredTables = new Set();
+    const subscriptionsByTable = new Map();
+    const toScopeValues = (value) => {
+        const result = {};
+        for (const [key, scopeValue] of Object.entries((value ?? {}))) {
+            if (scopeValue === undefined)
+                continue;
+            result[key] = scopeValue;
+        }
+        return result;
+    };
+    const sync = {
+        handlers,
+        addHandler(handlerOptions) {
+            if (registeredTables.has(handlerOptions.table)) {
+                throw new Error(`Client table handler already registered: ${handlerOptions.table}`);
+            }
+            handlers.push(createClientHandler({
+                ...handlerOptions,
+                subscribe: false,
+                codecs: options.codecs,
+                codecDialect: options.codecDialect,
+            }));
+            subscriptionsByTable.set(handlerOptions.table, handlerOptions.subscribe);
+            registeredTables.add(handlerOptions.table);
+            return sync;
+        },
+        subscriptions(identity) {
+            const resolved = [];
+            for (const [table, subscribe] of subscriptionsByTable.entries()) {
+                if (!subscribe)
+                    continue;
+                const value = typeof subscribe === 'function' ? subscribe({ identity }) : subscribe;
+                if (!value)
+                    continue;
+                const entries = Array.isArray(value) ? value : [value];
+                for (const entry of entries) {
+                    resolved.push({
+                        id: entry.id,
+                        table: entry.table ?? table,
+                        scopes: toScopeValues(entry.scopes),
+                        params: entry.params,
+                        bootstrapState: entry.bootstrapState,
+                    });
+                }
+            }
+            return resolved;
+        },
+    };
+    return sync;
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAiEnC,MAAM,UAAU,gBAAgB,CAK9B,OAAgC,EACY;IAC5C,MAAM,QAAQ,GAA6B,EAAE,CAAC;IAC9C,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAQjC,CAAC;IAEJ,MAAM,aAAa,GAAG,CACpB,KAAqD,EACzB,EAAE,CAAC;QAC/B,MAAM,MAAM,GAA+B,EAAE,CAAC;QAC9C,KAAK,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAC5C,CAAC,KAAK,IAAI,EAAE,CAA2C,CACxD,EAAE,CAAC;YACF,IAAI,UAAU,KAAK,SAAS;gBAAE,SAAS;YACvC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;QAC3B,CAAC;QACD,OAAO,MAAM,CAAC;IAAA,CACf,CAAC;IAEF,MAAM,IAAI,GAA+C;QACvD,QAAQ;QACR,UAAU,CACR,cAKC,EACD;YACA,IAAI,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,4CAA4C,cAAc,CAAC,KAAK,EAAE,CACnE,CAAC;YACJ,CAAC;YAED,QAAQ,CAAC,IAAI,CACX,mBAAmB,CAAC;gBAClB,GAAG,cAAc;gBACjB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CACH,CAAC;YACF,oBAAoB,CAAC,GAAG,CACtB,cAAc,CAAC,KAAK,EACpB,cAAc,CAAC,SAKD,CACf,CAAC;YACF,gBAAgB,CAAC,GAAG,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;YAC3C,OAAO,IAAI,CAAC;QAAA,CACb;QACD,aAAa,CACX,QAAkB,EAC8B;YAChD,MAAM,QAAQ,GAAmD,EAAE,CAAC;YACpE,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,oBAAoB,CAAC,OAAO,EAAE,EAAE,CAAC;gBAChE,IAAI,CAAC,SAAS;oBAAE,SAAS;gBACzB,MAAM,KAAK,GACT,OAAO,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBACxE,IAAI,CAAC,KAAK;oBAAE,SAAS;gBACrB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACvD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,QAAQ,CAAC,IAAI,CAAC;wBACZ,EAAE,EAAE,KAAK,CAAC,EAAE;wBACZ,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,KAAK;wBAC3B,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;wBACnC,MAAM,EAAE,KAAK,CAAC,MAAM;wBACpB,cAAc,EAAE,KAAK,CAAC,cAAc;qBACrC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAC;QAAA,CACjB;KACF,CAAC;IAEF,OAAO,IAAI,CAAC;AAAA,CACb"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@syncular/client",
-  "version": "0.0.5-42",
+  "version": "0.0.6-101",
   "description": "Client-side sync engine with offline-first support, outbox, and conflict resolution",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "author": "Benjamin Kniffler",
   "homepage": "https://syncular.dev",
   "repository": {
@@ -46,8 +46,8 @@
     "release": "bunx syncular-publish"
   },
   "dependencies": {
-    "@syncular/core": "0.0.5-42",
-    "@syncular/transport-http": "0.0.5-42"
+    "@syncular/core": "0.0.6-101",
+    "@syncular/transport-http": "0.0.6-101"
   },
   "peerDependencies": {
     "kysely": "*"

package/src/client.test.ts

@@ -1,12 +1,12 @@
 import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
-import type { SyncTransport } from '@syncular/core';
+import { createDatabase, type SyncTransport } from '@syncular/core';
 import type { Kysely } from 'kysely';
 import { sql } from 'kysely';
-import { createBunSqliteDb } from '../../dialect-bun-sqlite/src';
+import { createBunSqliteDialect } from '../../dialect-bun-sqlite/src';
 import { ensureClientBlobSchema } from './blobs/migrate';
 import { Client, type ClientBlobStorage } from './client';
 import { SyncEngine } from './engine/SyncEngine';
-import { ClientTableRegistry } from './handlers/registry';
+import type { ClientHandlerCollection } from './handlers/collection';
 import { ensureClientSyncSchema } from './migrate';
 import type { SyncClientDb } from './schema';
 
@@ -151,7 +151,10 @@ describe('Client conflict events', () => {
   }
 
   beforeEach(async () => {
-    db = createBunSqliteDb<TestDb>({ path: ':memory:' });
+    db = createDatabase<TestDb>({
+      dialect: createBunSqliteDialect({ path: ':memory:' }),
+      family: 'sqlite',
+    });
     await ensureClientSyncSchema(db);
     await db.schema
       .createTable('tasks')
@@ -162,7 +165,7 @@ describe('Client conflict events', () => {
       )
       .execute();
 
-    const handlers = new ClientTableRegistry<TestDb>();
+    const handlers: ClientHandlerCollection<TestDb> = [];
     client = new Client<TestDb>({
       db,
       transport: noopTransport,
@@ -270,12 +273,15 @@ describe('Client blob upload queue recovery', () => {
   }
 
   beforeEach(async () => {
-    db = createBunSqliteDb<TestDb>({ path: ':memory:' });
+    db = createDatabase<TestDb>({
+      dialect: createBunSqliteDialect({ path: ':memory:' }),
+      family: 'sqlite',
+    });
     await ensureClientSyncSchema(db);
     await ensureClientBlobSchema(db);
     initiateCalls = 0;
 
-    const handlers = new ClientTableRegistry<TestDb>();
+    const handlers: ClientHandlerCollection<TestDb> = [];
     const transport: SyncTransport = {
       ...noopTransport,
       blobs: {
@@ -373,10 +379,13 @@ describe('Client inspector snapshot', () => {
   let client: Client<TestDb>;
 
   beforeEach(async () => {
-    db = createBunSqliteDb<TestDb>({ path: ':memory:' });
+    db = createDatabase<TestDb>({
+      dialect: createBunSqliteDialect({ path: ':memory:' }),
+      family: 'sqlite',
+    });
     await ensureClientSyncSchema(db);
 
-    const handlers = new ClientTableRegistry<TestDb>();
+    const handlers: ClientHandlerCollection<TestDb> = [];
     client = new Client<TestDb>({
       db,
       transport: noopTransport,

package/src/client.ts

@@ -15,6 +15,7 @@ import type {
   ColumnCodecSource,
   SyncTransport,
 } from '@syncular/core';
+import { countSyncMetric } from '@syncular/core';
 import type { Kysely } from 'kysely';
 import { sql } from 'kysely';
 import { ensureClientBlobSchema } from './blobs/migrate';
@@ -37,7 +38,7 @@ import type {
   SyncResult,
   TransportHealth,
 } from './engine/types';
-import type { ClientTableRegistry } from './handlers/registry';
+import type { ClientHandlerCollection } from './handlers/collection';
 import { ensureClientSyncSchema } from './migrate';
 import {
   createMutationsApi,
@@ -91,7 +92,7 @@ export interface ClientOptions<DB extends SyncClientDb> {
   transport: SyncTransport;
 
   /** Table handlers for applying snapshots and changes */
-  tableHandlers: ClientTableRegistry<DB>;
+  tableHandlers: ClientHandlerCollection<DB>;
 
   /** Unique client identifier (e.g., device ID) */
   clientId: string;
@@ -132,7 +133,7 @@ export interface ClientOptions<DB extends SyncClientDb> {
   omitColumns?: string[];
 
   /** Optional: Column codec resolver */
-  columnCodecs?: ColumnCodecSource;
+  codecs?: ColumnCodecSource;
 
   /** Optional: Codec dialect override (default: 'sqlite') */
   codecDialect?: ColumnCodecDialect;
@@ -341,7 +342,7 @@ export class Client<DB extends SyncClientDb = SyncClientDb> {
       idColumn: options.idColumn ?? 'id',
       versionColumn: options.versionColumn ?? 'server_version',
       omitColumns: options.omitColumns ?? [],
-      columnCodecs: options.columnCodecs,
+      codecs: options.codecs,
       codecDialect: options.codecDialect,
     });
     this.mutations = createMutationsApi(commitFn) as MutationsApi<DB>;
@@ -714,6 +715,12 @@ export class Client<DB extends SyncClientDb = SyncClientDb> {
 
     await resolveConflict(this.options.db, { id, resolution: resolutionStr });
 
+    countSyncMetric('sync.conflicts.resolved', 1, {
+      attributes: {
+        strategy: resolution.strategy,
+      },
+    });
+
     this.emittedConflictIds.delete(id);
     if (resolvedConflict) {
       this.emit('conflict:resolved', resolvedConflict);

package/src/create-client.test.ts

@@ -0,0 +1,83 @@
+import { afterEach, describe, expect, it } from 'bun:test';
+import { createDatabase } from '@syncular/core';
+import type { Kysely } from 'kysely';
+import { createBunSqliteDialect } from '../../dialect-bun-sqlite/src';
+import { createClient } from './create-client';
+import type { SyncClientDb } from './schema';
+
+interface TasksTable {
+  id: string;
+  user_id: string;
+  title: string;
+  server_version: number;
+}
+
+interface TestDb extends SyncClientDb {
+  tasks: TasksTable;
+}
+
+async function createTestDb(): Promise<Kysely<TestDb>> {
+  const db = createDatabase<TestDb>({
+    dialect: createBunSqliteDialect({ path: ':memory:' }),
+    family: 'sqlite',
+  });
+  await db.schema
+    .createTable('tasks')
+    .addColumn('id', 'text', (col) => col.primaryKey())
+    .addColumn('user_id', 'text', (col) => col.notNull())
+    .addColumn('title', 'text', (col) => col.notNull())
+    .addColumn('server_version', 'integer', (col) => col.notNull().defaultTo(0))
+    .execute();
+  return db;
+}
+
+describe('createClient url normalization', () => {
+  const originalFetch = globalThis.fetch;
+
+  afterEach(() => {
+    globalThis.fetch = originalFetch;
+  });
+
+  it('accepts sync endpoint URLs without duplicating /sync', async () => {
+    const requests: string[] = [];
+    globalThis.fetch = (async (input: RequestInfo | URL) => {
+      const request = input instanceof Request ? input : new Request(input);
+      requests.push(request.url);
+      return new Response(
+        JSON.stringify({
+          ok: true,
+          pull: { ok: true, subscriptions: [] },
+        }),
+        {
+          status: 200,
+          headers: { 'content-type': 'application/json' },
+        }
+      );
+    }) as typeof fetch;
+
+    const db = await createTestDb();
+    try {
+      const { destroy } = await createClient<TestDb>({
+        db,
+        actorId: 'user-1',
+        clientId: 'client-1',
+        url: 'http://localhost:4311/api/sync',
+        handlers: [
+          {
+            table: 'tasks',
+            subscribe: false,
+            async applySnapshot() {},
+            async clearAll() {},
+            async applyChange() {},
+          },
+        ],
+      });
+
+      destroy();
+      expect(requests).toContain('http://localhost:4311/api/sync');
+      expect(requests).not.toContain('http://localhost:4311/api/sync/sync');
+    } finally {
+      await db.destroy();
+    }
+  });
+});

package/src/create-client.ts

@@ -2,7 +2,7 @@
  * Simplified client factory
  *
  * Breaking changes from legacy Client:
- * - handlers: array instead of ClientTableRegistry
+ * - handlers: plain array (no registry class)
  * - url: string instead of transport (transport auto-created)
  * - subscriptions: derived from handler.subscribe (no separate param)
  * - clientId: auto-generated (no longer required)
@@ -19,8 +19,8 @@ import { extractScopeVars } from '@syncular/core';
 import { createHttpTransport } from '@syncular/transport-http';
 import type { Kysely } from 'kysely';
 import { Client } from './client';
+import { createClientHandlerCollection } from './handlers/collection';
 import { createClientHandler } from './handlers/create-handler';
-import { ClientTableRegistry } from './handlers/registry';
 import type { ClientTableHandler } from './handlers/types';
 import type { SyncClientDb } from './schema';
 import { randomUUID } from './utils/id';
@@ -63,24 +63,34 @@ function createAutoHandler<
   table: string,
   scopes: string[],
   options: {
-    columnCodecs?: ColumnCodecSource;
+    codecs?: ColumnCodecSource;
     codecDialect?: ColumnCodecDialect;
   }
 ): ClientTableHandler<DB, TableName> {
   return createClientHandler<DB, TableName>({
     table: table as TableName,
     scopes: scopes as ScopeDefinition[],
-    columnCodecs: options.columnCodecs,
+    codecs: options.codecs,
     codecDialect: options.codecDialect,
   });
 }
 
+function normalizeTransportBaseUrl(url: string): string {
+  const trimmed = url.trim().replace(/\/+$/, '');
+  if (!trimmed.endsWith('/sync')) {
+    return trimmed;
+  }
+
+  const baseUrl = trimmed.slice(0, -'/sync'.length);
+  return baseUrl.length > 0 ? baseUrl : '/';
+}
+
 interface CreateClientOptions<DB extends SyncClientDb> {
   /** Kysely database instance */
   db: Kysely<DB>;
 
   /**
-   * Server URL (e.g., '/api/sync' or 'https://api.example.com').
+   * Sync URL (e.g., '/api/sync') or base API URL (e.g., '/api').
    * Defaults to '/api/sync' if not provided.
    * Ignored if transport is provided.
    */
@@ -88,7 +98,6 @@ interface CreateClientOptions<DB extends SyncClientDb> {
 
   /**
    * Table handlers for applying snapshots and changes.
-   * Array is auto-converted to ClientTableRegistry.
    * Handlers with `subscribe: true` (or an object) are synced.
    * Handlers with `subscribe: false` are local-only.
    * Either handlers or tables must be provided.
@@ -144,7 +153,7 @@ interface CreateClientOptions<DB extends SyncClientDb> {
   stateId?: string;
 
   /** Optional: Column codec resolver */
-  columnCodecs?: ColumnCodecSource;
+  codecs?: ColumnCodecSource;
 
   /** Optional: Codec dialect override (default: 'sqlite') */
   codecDialect?: ColumnCodecDialect;
@@ -211,7 +220,7 @@ export async function createClient<DB extends SyncClientDb>(
     blobStorage,
     plugins,
     stateId,
-    columnCodecs,
+    codecs,
     codecDialect,
     autoStart = true,
   } = options;
@@ -229,22 +238,18 @@ export async function createClient<DB extends SyncClientDb>(
     providedHandlers ??
     tables!.map((table) =>
       createAutoHandler<DB, keyof DB & string>(table, scopes!, {
-        columnCodecs,
+        codecs,
         codecDialect,
       })
     );
 
-  // Build registry from handlers array
-  const tableHandlers = new ClientTableRegistry<DB>();
-  for (const handler of handlers) {
-    tableHandlers.register(handler);
-  }
+  const tableHandlers = createClientHandlerCollection(handlers);
 
   // Create transport from URL if not provided
   let transport = customTransport;
   if (!transport && url) {
     transport = createHttpTransport({
-      baseUrl: url,
+      baseUrl: normalizeTransportBaseUrl(url),
       getHeaders,
     });
   }
@@ -306,7 +311,7 @@ export async function createClient<DB extends SyncClientDb>(
     blobStorage,
     plugins,
     stateId,
-    columnCodecs,
+    codecs,
     codecDialect,
     realtimeEnabled: sync.realtime ?? true,
     pollIntervalMs: sync.pollIntervalMs,