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

package/dist/studio/index.d.ts

@@ -35,6 +35,7 @@ export declare function applyFormAlterHooks(hooks: FormAlterHook[], schema: Form
 export declare function sortSlotContributions<T extends {
     priority?: number;
 }>(items: T[]): T[];
+export { removeOwnerFromSlots, registerOwnedOnSlot, type OwnedSlotContribution, } from './slot-owner-registry.js';
 /** Register a top-level Studio page contributed by this extension. */
 export declare function registerRoute(route: StudioRoute): void;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/studio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EAEV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,SAAU,SAAQ,YAAY;IACtC,qDAAqD;IACrD,MAAM,IAAI,UAAU,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAoE5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChC,UAAU,CAWZ;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGtF;AAoCD,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAE/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAE3E;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAID,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/studio/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EAEV,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,UAAU,SAAU,SAAQ,YAAY;IACtC,qDAAqD;IACrD,MAAM,IAAI,UAAU,CAAC;CACtB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,CAoE5D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,aAAa,EAAE,EACtB,MAAM,EAAE,UAAU,EAClB,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAChC,UAAU,CAWZ;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAGtF;AAED,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC;AAqClC,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEtD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,gBAAgB,GAAG,IAAI,CAE/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAE3E;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,eAAe,GAAG,IAAI,CAE3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvE;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAID,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,UAAU,EACV,SAAS,GACV,MAAM,uBAAuB,CAAC"}

package/dist/studio/index.js

@@ -109,9 +109,11 @@ export function sortSlotContributions(items) {
     // We rely on Array.prototype.sort being stable (TC39 since 2019).
     return items.slice().sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
 }
+export { removeOwnerFromSlots, registerOwnedOnSlot, } from './slot-owner-registry.js';
 function getStudioGlobal() {
     if (typeof window === 'undefined')
         return null;
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     const g = window.__zveltio;
     if (!g) {
         console.warn('[zveltio/sdk/studio] window.__zveltio is not installed. Is the bundle running inside Studio?');
@@ -176,5 +178,6 @@ export function registerAssetPreview(handler) {
 export function getEngineUrl() {
     if (typeof window === 'undefined')
         return '';
+    // biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
     return window.__ZVELTIO_ENGINE_URL__ || getStudioGlobal()?.engineUrl || '';
 }

package/dist/studio/slot-owner-registry.d.ts

@@ -0,0 +1,13 @@
+import type { SlotContribution } from '../extension/index.js';
+/** Owner tag set by compile-time `contribute.ts` modules; absent on legacy window.__zveltio calls. */
+export type OwnedSlotContribution = SlotContribution & {
+    owner?: string;
+};
+/** Remove every contribution registered by `owner` across all slot names. */
+export declare function removeOwnerFromSlots(slots: Record<string, OwnedSlotContribution[]>, owner: string): Record<string, OwnedSlotContribution[]>;
+/**
+ * Register (or replace) a single owner's contribution on one slot.
+ * Prior entries from the same owner on that slot are dropped first.
+ */
+export declare function registerOwnedOnSlot(slots: Record<string, OwnedSlotContribution[]>, owner: string, slotName: string, contribution: SlotContribution): Record<string, OwnedSlotContribution[]>;
+//# sourceMappingURL=slot-owner-registry.d.ts.map

package/dist/studio/slot-owner-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-owner-registry.d.ts","sourceRoot":"","sources":["../../src/studio/slot-owner-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,sGAAsG;AACtG,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAC9C,KAAK,EAAE,MAAM,GACZ,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAOzC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,EAC9C,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,gBAAgB,GAC7B,MAAM,CAAC,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAMzC"}

package/dist/studio/slot-owner-registry.js

@@ -0,0 +1,21 @@
+/** Remove every contribution registered by `owner` across all slot names. */
+export function removeOwnerFromSlots(slots, owner) {
+    const out = {};
+    for (const [name, list] of Object.entries(slots)) {
+        const kept = list.filter((c) => c.owner !== owner);
+        if (kept.length > 0)
+            out[name] = kept;
+    }
+    return out;
+}
+/**
+ * Register (or replace) a single owner's contribution on one slot.
+ * Prior entries from the same owner on that slot are dropped first.
+ */
+export function registerOwnedOnSlot(slots, owner, slotName, contribution) {
+    const out = { ...slots };
+    const prev = out[slotName] ?? [];
+    const kept = prev.filter((c) => c.owner !== owner);
+    out[slotName] = [...kept, { ...contribution, owner }];
+    return out;
+}

package/dist/svelte.d.ts

@@ -6,7 +6,7 @@
  * ```svelte
  * <script lang="ts">
  *   import { SyncManager } from '@zveltio/sdk';
- *   import { useSyncCollection, useSyncStatus } from '@zveltio/sdk/svelte';
+ *   import { useSyncCollection, useSyncStatus } from '@zveltio/sdk';
  *
  *   let todos = $state<any[]>([]);
  *   const unsub = useSyncCollection(sync, 'todos', (records) => { todos = records; });

package/dist/svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../src/svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,GAC/B,MAAM,IAAI,CAGZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,EACnF,UAAU,SAAO,GAChB,MAAM,IAAI,CAeZ"}
+{"version":3,"file":"svelte.d.ts","sourceRoot":"","sources":["../src/svelte.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,WAAW,EACjB,UAAU,EAAE,MAAM,EAElB,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,GAC/B,MAAM,IAAI,CAGZ;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,KAAK,IAAI,EACnF,UAAU,SAAO,GAChB,MAAM,IAAI,CAeZ"}

package/dist/svelte.js

@@ -6,7 +6,7 @@
  * ```svelte
  * <script lang="ts">
  *   import { SyncManager } from '@zveltio/sdk';
- *   import { useSyncCollection, useSyncStatus } from '@zveltio/sdk/svelte';
+ *   import { useSyncCollection, useSyncStatus } from '@zveltio/sdk';
  *
  *   let todos = $state<any[]>([]);
  *   const unsub = useSyncCollection(sync, 'todos', (records) => { todos = records; });
@@ -23,7 +23,9 @@
  * Calls `setter` immediately with current state and on each update.
  * Returns the unsubscribe function.
  */
-export function useSyncCollection(sync, collection, setter) {
+export function useSyncCollection(sync, collection, 
+// biome-ignore lint/suspicious/noExplicitAny: legacy any; tracked in hardening plan item H-01
+setter) {
     const col = sync.collection(collection);
     return col.subscribe(setter);
 }

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"}