@zveltio/sdk 3.0.0-beta.5 → 3.0.0-beta.68

package/dist/sync-manager.d.ts

@@ -20,6 +20,10 @@ export declare class SyncManager {
     private syncTimer;
     private isOnline;
     private isSyncing;
+    /** Set by `stop()`; `start()` checks it after every await it makes. */
+    private stopped;
+    private readonly onOnline;
+    private readonly onOffline;
     private listeners;
     constructor(client: ZveltioClient, config?: SyncManagerConfig);
     start(realtimeUrl?: string): Promise<void>;
@@ -32,22 +36,22 @@ export declare class SyncManager {
     collection(name: string): {
         /** List records — reads LOCAL instantly */
         list: () => Promise<{
-            _syncStatus: "synced" | "pending" | "conflict";
+            _syncStatus: "conflict" | "synced" | "pending";
             id: string;
         }[]>;
         /** Get one record — reads LOCAL instantly */
         get: (id: string) => Promise<{
-            _syncStatus: "synced" | "pending" | "conflict";
+            _syncStatus: "conflict" | "synced" | "pending";
             id: string;
         } | null>;
         /** Create — writes LOCAL + queues sync */
         create: (data: Record<string, any>) => Promise<{
-            _syncStatus: "synced" | "pending" | "conflict";
+            _syncStatus: "conflict" | "synced" | "pending";
             id: string;
         }>;
         /** Update — writes LOCAL + queues sync */
         update: (id: string, data: Record<string, any>) => Promise<{
-            _syncStatus: "synced" | "pending" | "conflict";
+            _syncStatus: "conflict" | "synced" | "pending";
             id: string;
         }>;
         /** Delete — soft delete LOCAL + queues sync */
@@ -62,6 +66,28 @@ export declare class SyncManager {
     /** Force sync now (non-blocking) */
     syncNow(): Promise<void>;
     private notifyListeners;
+    /**
+     * Open the local store without starting background sync.
+     *
+     * `start()` opens the store, attaches online/offline listeners, connects
+     * realtime and installs a periodic timer. A caller driving `pull()` and
+     * `push()` explicitly — the `OfflineProvider` contract in `offline/` — wants
+     * the store and none of the rest, and a timer firing `syncNow()` underneath it
+     * makes "how many operations did that push send" unanswerable.
+     */
+    open(): Promise<void>;
+    /**
+     * Pull rows for the named collections from the server into the local store.
+     *
+     * There was no way to do this. Records reached the local store only through
+     * realtime events, one at a time, which means a client that was offline while
+     * a row was created never learns it exists: it missed the event and nothing
+     * ever asks the server what it has. `syncNow()` is push-only despite the name.
+     *
+     * Pages through `list()` rather than asking for everything at once, and stops
+     * on the first page that comes back empty or short.
+     */
+    pull(collections: string[], pageSize?: number): Promise<number>;
     /** Status: pending operations count, conflicts count */
     getStatus(): Promise<{
         pending: number;

package/dist/sync-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../src/sync-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;IAC9C,mHAAmH;IACnH,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;CAC7C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,SAAS,CAAyD;gBAE9D,MAAM,EAAE,aAAa,EAAE,MAAM,GAAE,iBAAsB;IAY3D,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8BhD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM;QAEnB,2CAA2C;;;;;QAU3C,6CAA6C;kBAC7B,MAAM;;;;QAUtB,0CAA0C;uBACrB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;QAYxC,0CAA0C;qBACvB,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;QAapD,+CAA+C;qBAC5B,MAAM;QAMzB,qDAAqD;8BAC/B,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI;QA0C9C,8CAA8C;;QAK9C,kCAAkC;8BACN,MAAM,gBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;IAQzE,oCAAoC;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YA8FhB,eAAe;IAmB7B,wDAAwD;IAClD,SAAS,IAAI,OAAO,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IAUI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B"}
+{"version":3,"file":"sync-manager.d.ts","sourceRoot":"","sources":["../src/sync-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IAEpD,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;IAC9C,mHAAmH;IACnH,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;CAC7C;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,MAAM,CAA8B;IAC5C,OAAO,CAAC,SAAS,CAA+C;IAChE,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,SAAS,CAAkB;IACnC,uEAAuE;IACvE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGvB;IACF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAExB;IAEF,OAAO,CAAC,SAAS,CAAyD;gBAE9D,MAAM,EAAE,aAAa,EAAE,MAAM,GAAE,iBAAsB;IAY3D,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BhD;;;;;OAKG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM;QAEnB,2CAA2C;;;;;QAU3C,6CAA6C;kBAC7B,MAAM;;;;QAUtB,0CAA0C;uBAErB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;QAYxC,0CAA0C;qBAEvB,MAAM,QAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;QAapD,+CAA+C;qBAC5B,MAAM;QAMzB,qDAAqD;8BAE/B,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI;QA8C9C,8CAA8C;;QAK9C,kCAAkC;8BAEN,MAAM,gBAAgB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;IAQzE,oCAAoC;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAwGhB,eAAe;IAmB7B;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B;;;;;;;;;;OAUG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBlE,wDAAwD;IAClD,SAAS,IAAI,OAAO,CAAC;QACzB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IAUI,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAY5B"}

package/dist/sync-manager.js

@@ -9,6 +9,16 @@ export class SyncManager {
     syncTimer = null;
     isOnline = true;
     isSyncing = false;
+    /** Set by `stop()`; `start()` checks it after every await it makes. */
+    stopped = false;
+    onOnline = () => {
+        this.isOnline = true;
+        this.syncNow(); // Sync immediately on reconnect
+    };
+    onOffline = () => {
+        this.isOnline = false;
+    };
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     listeners = new Map();
     constructor(client, config = {}) {
         this.store = new LocalStore();
@@ -22,21 +32,24 @@ export class SyncManager {
         };
     }
     async start(realtimeUrl) {
+        this.stopped = false;
         await this.store.open();
+        // A caller that unmounts before `start()` settles calls `stop()` first — a
+        // React effect cleanup, and StrictMode runs one on every mount in
+        // development. Arming the timer and socket after that leaked both forever.
+        if (this.stopped)
+            return this.store.close();
         // Online/offline detection
         if (typeof window !== 'undefined') {
-            window.addEventListener('online', () => {
-                this.isOnline = true;
-                this.syncNow(); // Sync immediately on reconnect
-            });
-            window.addEventListener('offline', () => {
-                this.isOnline = false;
-            });
+            window.addEventListener('online', this.onOnline);
+            window.addEventListener('offline', this.onOffline);
             this.isOnline = navigator.onLine;
         }
         // Realtime: receives push updates from server
         if (realtimeUrl) {
             const { ZveltioRealtime } = await import('./realtime.js');
+            if (this.stopped)
+                return;
             this.realtime = new ZveltioRealtime(realtimeUrl);
             this.realtime.connect();
             // Subscriptions are per-collection via collection()
@@ -75,6 +88,7 @@ export class SyncManager {
                 };
             },
             /** Create — writes LOCAL + queues sync */
+            // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
             create: async (data) => {
                 const id = data.id || generateUUID();
                 const record = await this.store.put(name, id, data);
@@ -87,6 +101,7 @@ export class SyncManager {
                 };
             },
             /** Update — writes LOCAL + queues sync */
+            // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
             update: async (id, data) => {
                 const existing = await this.store.get(name, id);
                 const merged = { ...(existing?.data || {}), ...data };
@@ -106,6 +121,7 @@ export class SyncManager {
                 this.syncNow();
             },
             /** Subscribe la changes (realtime + local writes) */
+            // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
             subscribe: (callback) => {
                 if (!this.listeners.has(name))
                     this.listeners.set(name, new Set());
@@ -114,19 +130,24 @@ export class SyncManager {
                 let unsubRealtime;
                 if (this.realtime) {
                     unsubRealtime = this.realtime.subscribe(name, async (event) => {
-                        // Apply update from server to local store
-                        if (event.event === 'record.created' || event.event === 'record.updated') {
+                        // Apply update from server to local store. The engine's socket
+                        // sends `{ type: 'event', event: 'insert'|'update'|'delete', data }`
+                        // (routes/ws.ts `broadcastEvent`); the id lives on `data`.
+                        const id = event.data?.id;
+                        if (event.type !== 'event' || !id)
+                            return;
+                        if (event.event === 'insert' || event.event === 'update') {
                             try {
-                                const serverRecord = await this.client.collection(name).get(event.record_id);
-                                await this.store.applyServerUpdate(name, event.record_id, serverRecord, Date.now());
+                                const serverRecord = await this.client.collection(name).get(id);
+                                await this.store.applyServerUpdate(name, id, serverRecord, Date.now());
                                 this.notifyListeners(name);
                             }
                             catch {
                                 /* offline or error — ignore, periodic sync will resolve */
                             }
                         }
-                        else if (event.event === 'record.deleted') {
-                            await this.store.delete(name, event.record_id);
+                        else if (event.event === 'delete') {
+                            await this.store.applyServerDelete(name, id);
                             this.notifyListeners(name);
                         }
                     });
@@ -150,6 +171,7 @@ export class SyncManager {
                 return this.store.getConflicts(name);
             },
             /** Resolve a conflict manually */
+            // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
             resolveConflict: async (id, resolvedData) => {
                 await this.store.resolveConflict(name, id, resolvedData);
                 this.notifyListeners(name);
@@ -170,6 +192,7 @@ export class SyncManager {
                     const file = new File([blobItem.blob], `offline_${blobItem.id}`, {
                         type: blobItem.blob.type,
                     });
+                    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
                     const result = (await this.client.storage.upload(file));
                     const url = result?.url || result?.publicUrl || result?.path || '';
                     if (!url)
@@ -214,6 +237,7 @@ export class SyncManager {
                     }
                     await this.store.markSynced(op.id, op.collection, op.recordId, serverVersion);
                     this.notifyListeners(op.collection);
+                    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
                 }
                 catch (err) {
                     // Conflict from server (409) — apply conflict resolution
@@ -224,15 +248,23 @@ export class SyncManager {
                             // CRDT LWW merge if both sides have CRDT docs and strategy is 'lww'
                             if (this.config.conflictResolution === 'lww' &&
                                 localRecord?._crdtDoc &&
+                                // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
                                 serverRecord.__crdt) {
+                                // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
                                 const merged = mergeLWW(localRecord._crdtDoc, serverRecord.__crdt);
-                                const resolvedData = fromDocument(merged);
-                                await this.store.resolveConflict(op.collection, op.recordId, resolvedData);
+                                await this.store.resolveConflict(op.collection, op.recordId, fromDocument(merged));
                             }
                             else {
                                 const resolved = this.config.onConflict(localRecord?.data, serverRecord);
                                 await this.store.resolveConflict(op.collection, op.recordId, resolved);
                             }
+                            // The operation the server just rejected stayed in the queue with
+                            // its original payload and its attempt count untouched, so the next
+                            // tick sent the same payload, took the same 409 and resolved the
+                            // same conflict again — every `syncInterval`, with no end. Count
+                            // the attempt so `maxRetries` retires it; the resolved row is
+                            // queued by `resolveConflict` as its own operation.
+                            await this.store.markFailed(op.id, 'rejected with 409 — resolved locally');
                         }
                         catch {
                             /* fallback: server wins — ignore error */
@@ -268,6 +300,53 @@ export class SyncManager {
             }
         });
     }
+    /**
+     * Open the local store without starting background sync.
+     *
+     * `start()` opens the store, attaches online/offline listeners, connects
+     * realtime and installs a periodic timer. A caller driving `pull()` and
+     * `push()` explicitly — the `OfflineProvider` contract in `offline/` — wants
+     * the store and none of the rest, and a timer firing `syncNow()` underneath it
+     * makes "how many operations did that push send" unanswerable.
+     */
+    async open() {
+        await this.store.open();
+    }
+    /**
+     * Pull rows for the named collections from the server into the local store.
+     *
+     * There was no way to do this. Records reached the local store only through
+     * realtime events, one at a time, which means a client that was offline while
+     * a row was created never learns it exists: it missed the event and nothing
+     * ever asks the server what it has. `syncNow()` is push-only despite the name.
+     *
+     * Pages through `list()` rather than asking for everything at once, and stops
+     * on the first page that comes back empty or short.
+     */
+    async pull(collections, pageSize = 200) {
+        let applied = 0;
+        for (const name of collections) {
+            for (let page = 1;; page++) {
+                const result = await this.client.collection(name).list({ page, limit: pageSize });
+                const rows = result?.data ?? [];
+                for (const row of rows) {
+                    const id = row.id;
+                    if (!id)
+                        continue;
+                    // `Date.now()` as the server version: the collections API does not
+                    // return a version column, and the local store only compares versions
+                    // to decide whether an incoming row is newer than one it already has.
+                    // A server row arriving now IS newer than anything already local.
+                    await this.store.applyServerUpdate(name, id, row, Date.now());
+                    applied++;
+                }
+                if (rows.length < pageSize)
+                    break;
+            }
+            await this.notifyListeners(name);
+        }
+        return applied;
+    }
     /** Status: pending operations count, conflicts count */
     async getStatus() {
         const pending = await this.store.getPendingOps();
@@ -279,9 +358,16 @@ export class SyncManager {
         };
     }
     async stop() {
+        this.stopped = true;
         if (this.syncTimer)
             clearInterval(this.syncTimer);
+        this.syncTimer = null;
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('online', this.onOnline);
+            window.removeEventListener('offline', this.onOffline);
+        }
         this.realtime?.disconnect();
+        this.realtime = null;
         await this.store.close();
     }
 }

package/dist/testing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.js

@@ -24,10 +24,13 @@ import { Hono } from 'hono';
  * `.executeTakeFirstOrThrow()` returns a preset if matched, otherwise
  * an empty list (for execute) or undefined.
  */
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 export function mockDb(presets = {}) {
     const calls = [];
     const presetMap = new Map(Object.entries(presets));
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     function buildChain(prefix) {
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         const proxy = new Proxy(() => { }, {
             get(_, prop) {
                 if (typeof prop === 'symbol')
@@ -78,6 +81,7 @@ export function mockDb(presets = {}) {
         });
         return proxy;
     }
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     return buildChain([]);
 }
 function matchPreset(chain, presets) {
@@ -93,7 +97,9 @@ function matchPreset(chain, presets) {
 }
 export function mockEventBus() {
     const emitted = [];
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     const listeners = new Map();
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     const beforeHandlers = new Map();
     return {
         emit(event, payload) {
@@ -128,12 +134,14 @@ export function mockEventBus() {
             };
         },
         async runBefore(event, seed) {
+            // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
             const payload = { ...seed };
             let aborted = false;
             let abortReason = '';
             payload.abort = (reason) => {
                 aborted = true;
                 abortReason = reason;
+                // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
                 const err = new Error(`Aborted: ${reason}`);
                 err.name = 'AbortHookError';
                 err.reason = reason;
@@ -187,8 +195,10 @@ export function mockServiceRegistry() {
 }
 // ─── Mock queryAlter / entityAccess scoped registries ──────────────────────
 function mockQueryAlterScope() {
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     const entries = [];
     return {
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         register(def) {
             entries.push(def);
         },
@@ -201,8 +211,10 @@ function mockQueryAlterScope() {
     };
 }
 function mockEntityAccessScope() {
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     const entries = [];
     return {
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         register(def) {
             entries.push(def);
         },
@@ -214,6 +226,7 @@ function mockEntityAccessScope() {
         },
     };
 }
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 export function mockAuth(opts = {}) {
     const user = opts.user === undefined ? { id: 'test-user', email: 'test@example.com', roles: [] } : opts.user;
     return {
@@ -224,6 +237,7 @@ export function mockAuth(opts = {}) {
         },
     };
 }
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 export function createTestContext(opts = {}) {
     const db = opts.db ?? mockDb();
     const events = opts.events ?? mockEventBus();
@@ -239,14 +253,20 @@ export function createTestContext(opts = {}) {
             deserialize: (_t, v) => v,
             serialize: (_t, v) => v,
         },
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         events: events,
         checkPermission: async () => true,
         getUserRoles: async () => ['admin'],
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         DDLManager: {},
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         services: mockServiceRegistry(),
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         queryAlter: mockQueryAlterScope(),
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         entityAccess: mockEntityAccessScope(),
         registerPublicRoute: () => { },
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         internals: {},
         ...(opts.extra ?? {}),
     };
@@ -259,7 +279,9 @@ export function createTestContext(opts = {}) {
  * mounts the sub-app at `/ext/<extension.name>` by default — same shape
  * the engine produces in production.
  */
-export async function createTestApp(extension, opts = {}) {
+export async function createTestApp(
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
+extension, opts = {}) {
     const ctx = opts.ctx ?? createTestContext();
     const strategy = extension.mountStrategy ?? 'global';
     if (strategy === 'subapp') {

package/dist/testing/with-test-db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"with-test-db.d.ts","sourceRoot":"","sources":["../../src/testing/with-test-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,8DAA8D;IAC9D,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAChB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA6BD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CA4E/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,EAC/D,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBtD;AAgBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAuErD;AAGD,eAAO,MAAM,iBAAiB;;CAAsB,CAAC"}
+{"version":3,"file":"with-test-db.d.ts","sourceRoot":"","sources":["../../src/testing/with-test-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGrC,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,MAAM;IACrB,8DAA8D;IAE9D,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAChB,+CAA+C;IAC/C,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AA4BD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CA8E/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAEhC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,iBAAiB,EAE/D,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,CAAC,CAYZ;AAED;;;;;;;;;;;GAWG;AAGH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhG;AAED;;;GAGG;AAGH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAIzF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAStD;AAkBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAuErD;AAGD,eAAO,MAAM,iBAAiB;;CAAsB,CAAC"}

package/dist/testing/with-test-db.js

@@ -24,15 +24,15 @@
  *     weight just to use `mockDb`. By importing lazily, the cost is
  *     opt-in at the call site.
  */
+import { parseMigrationSql } from '../validate/migration-parse.js';
 // ── Module-level reuse cache ────────────────────────────────────────────────
 //
 // When `reuse: true`, we keep a single container alive for the process
 // lifetime. The first call to `withTestDb` boots it; subsequent calls open
 // fresh DBs *inside* the same container (CREATE DATABASE per-call), so
 // tests stay isolated without paying the container-start cost again.
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 let _sharedContainer = null;
-let _sharedClient = null;
-let _sharedDbCounter = 0;
 async function loadPgContainer() {
     try {
         return await import('@testcontainers/postgresql');
@@ -64,6 +64,7 @@ export async function startTestDb(opts = {}) {
     let port;
     let username;
     let password;
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     let createdContainer = null;
     if (opts.reuse && _sharedContainer) {
         host = _sharedContainer.getHost();
@@ -87,14 +88,15 @@ export async function startTestDb(opts = {}) {
     const adminPool = await openPgPool(adminConnStr);
     try {
         await adminPool.query(`CREATE DATABASE "${database}"`);
-        _sharedDbCounter++;
     }
     finally {
         await adminPool.end();
     }
     const connectionString = `postgres://${username}:${password}@${host}:${port}/${database}`;
     const pool = await openPgPool(connectionString);
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     const db = new Kysely({
+        // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
         dialect: new PostgresDialect({ pool: pool }),
     });
     if (opts.migrations && opts.migrations.length > 0) {
@@ -147,7 +149,11 @@ export async function startTestDb(opts = {}) {
  *     });
  *   });
  */
-export async function withTestDb(fnOrOpts, maybeFn) {
+export async function withTestDb(
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
+fnOrOpts, 
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
+maybeFn) {
     const opts = typeof fnOrOpts === 'function' ? {} : fnOrOpts;
     const fn = typeof fnOrOpts === 'function' ? fnOrOpts : maybeFn;
     if (typeof fn !== 'function') {
@@ -173,10 +179,17 @@ export async function withTestDb(fnOrOpts, maybeFn) {
  *   const files = glob('engine/migrations/*.sql').map((p) => readFileSync(p, 'utf8'));
  *   await applyMigrationStrings(db, files);
  */
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 export async function applyMigrationStrings(db, sqlStrings) {
     const { sql } = await loadKysely();
     for (const raw of sqlStrings) {
-        const statements = splitStatements(raw);
+        // Only the UP half. A Zveltio migration keeps its rollback in the same file
+        // behind a `-- DOWN` marker, and the runner that applies it in production
+        // splits on that marker — this helper did not, so the documented example
+        // (glob `engine/migrations/*.sql`, hand them all to this function) created
+        // the schema and then dropped it again, in the same call. Every assertion
+        // after it failed on a table that had existed a statement earlier.
+        const statements = splitStatements(parseMigrationSql(raw).up);
         for (const stmt of statements) {
             const trimmed = stmt.trim();
             if (!trimmed)
@@ -189,6 +202,7 @@ export async function applyMigrationStrings(db, sqlStrings) {
  * Same as `applyMigrationStrings` but takes file paths. Reads each file
  * synchronously, applies in order. Bun-native — uses `Bun.file()`.
  */
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 export async function applyMigrationFiles(db, paths) {
     // Bun.file().text() returns a Promise<string>.
     const contents = await Promise.all(paths.map((p) => Bun.file(p).text()));
@@ -200,15 +214,6 @@ export async function applyMigrationFiles(db, paths) {
  * reuse container is active.
  */
 export async function stopReusedTestDb() {
-    if (_sharedClient) {
-        try {
-            await _sharedClient.end();
-        }
-        catch {
-            /* */
-        }
-        _sharedClient = null;
-    }
     if (_sharedContainer) {
         try {
             await _sharedContainer.stop();
@@ -221,12 +226,14 @@ export async function stopReusedTestDb() {
 }
 // ── Internals ───────────────────────────────────────────────────────────────
 /** Open a pg connection pool. Uses `pg` (peer dep with testcontainers). */
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
 async function openPgPool(connectionString) {
     const pg = await import('pg').catch(() => {
         throw new Error(`withTestDb requires the 'pg' npm package. Install it alongside testcontainers:\n` +
             `  bun add -d testcontainers pg @types/pg`);
     });
     // pg's Pool — the Kysely PostgresDialect accepts this directly.
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     return new pg.Pool({ connectionString });
 }
 /**

package/dist/tests/client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=client.test.d.ts.map

package/dist/tests/client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/tests/client.test.ts"],"names":[],"mappings":""}

package/dist/tests/client.test.js

@@ -0,0 +1,55 @@
+import { describe, it, expect, afterEach } from 'bun:test';
+import { createZveltioClient } from '../client.js';
+const realFetch = globalThis.fetch;
+afterEach(() => {
+    globalThis.fetch = realFetch;
+});
+/** Records the URL each call is given and answers `{}` without a network hop. */
+function captureUrls() {
+    const urls = [];
+    globalThis.fetch = (async (input) => {
+        urls.push(String(input));
+        return new Response('{}', { status: 200, headers: { 'content-type': 'application/json' } });
+    });
+    return urls;
+}
+describe('ZveltioClient URL building', () => {
+    it('encodes a record id into a single path segment', async () => {
+        const urls = captureUrls();
+        const client = createZveltioClient({ baseUrl: 'https://engine.test' });
+        const products = client.collection('products');
+        await products.get('a/b');
+        await products.update('a/b', { name: 'x' });
+        await products.delete('a/b');
+        expect(urls).toEqual([
+            'https://engine.test/api/data/products/a%2Fb',
+            'https://engine.test/api/data/products/a%2Fb',
+            'https://engine.test/api/data/products/a%2Fb',
+        ]);
+    });
+    it('encodes the storage folder into the query string', async () => {
+        const urls = captureUrls();
+        const client = createZveltioClient({ baseUrl: 'https://engine.test' });
+        await client.storage.list('invoices&limit=9999');
+        expect(urls).toEqual(['https://engine.test/api/storage?folder_id=invoices%26limit%3D9999']);
+    });
+    it('sends the upload folder under the field name the engine reads', async () => {
+        let body;
+        globalThis.fetch = (async (_input, init) => {
+            body = init?.body;
+            return new Response('{}', { status: 200, headers: { 'content-type': 'application/json' } });
+        });
+        const client = createZveltioClient({ baseUrl: 'https://engine.test' });
+        await client.storage.upload(new File(['x'], 'a.txt'), 'folder-uuid');
+        expect(body?.get('folder_id')).toBe('folder-uuid');
+        expect(body?.has('folder')).toBe(false);
+    });
+    it('leaves an ordinary id and collection name untouched', async () => {
+        const urls = captureUrls();
+        const client = createZveltioClient({ baseUrl: 'https://engine.test/' });
+        await client.collection('order_items').get('018f2a1e-0000-7000-8000-000000000000');
+        expect(urls).toEqual([
+            'https://engine.test/api/data/order_items/018f2a1e-0000-7000-8000-000000000000',
+        ]);
+    });
+});

package/dist/tests/crdt-orset.test.d.ts

@@ -0,0 +1,2 @@
+import './setup';
+//# sourceMappingURL=crdt-orset.test.d.ts.map

package/dist/tests/crdt-orset.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crdt-orset.test.d.ts","sourceRoot":"","sources":["../../src/tests/crdt-orset.test.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,CAAC"}

package/dist/tests/crdt-orset.test.js

@@ -0,0 +1,23 @@
+import './setup';
+import { describe, it, expect } from 'bun:test';
+import { orSetAdd, orSetRemove, orSetMerge, orSetValues } from '../crdt.js';
+describe('OR-Set — removal survives a merge with a stale replica', () => {
+    it('does not resurrect an element that one replica removed', () => {
+        const added = orSetAdd([], 'x');
+        const uid = added[0].uid;
+        const stale = [...added]; // a replica that never saw the removal
+        const removed = orSetRemove(added, uid);
+        const first = orSetMerge(removed, stale);
+        expect(orSetValues(first)).toEqual([]);
+        // The stale replica syncs again. Without its tombstone the merged set has
+        // no record of the removal, so the element reads as a fresh addition.
+        const second = orSetMerge(first, stale);
+        expect(orSetValues(second), 'the removed element came back').toEqual([]);
+    });
+    it('an element added after a removal is kept', () => {
+        const first = orSetAdd([], 'x');
+        const removed = orSetRemove(first, first[0].uid);
+        const readded = orSetAdd(removed, 'x');
+        expect(orSetValues(orSetMerge(readded, removed))).toEqual(['x']);
+    });
+});