@pylonsync/sync 0.3.298 → 0.3.300

package/dist/index.d.ts

@@ -340,6 +340,12 @@ export declare class SyncEngine {
      * `useSyncStatus` is just a thin reader.
      */
     connectionStatus(): SyncConnectionStatus;
+    /**
+     * Count of optimistic writes still queued locally (not yet acked by the
+     * server) — i.e. the offline outbox depth. 0 when fully synced. Read by the
+     * dev HUD's sync row; also handy for a "saving…" indicator.
+     */
+    pendingCount(): number;
     /**
      * Mutate connection status + notify subscribers. Idempotent — same-
      * status calls are a no-op so the WS onopen → connected transition

package/dist/local-store.d.ts

@@ -33,6 +33,9 @@ export declare class LocalStore {
      *  by `SyncEngine.reconcile` to know which tables to diff against
      *  server truth. */
     entityNames(): string[];
+    /** Total rows held across all entity tables — the local replica size.
+     *  Read by the dev HUD's sync row. */
+    size(): number;
     /**
      * Remove a row whose absence was confirmed by the server-truth
      * reconciler. Records a tombstone at `tombstoneSeq` so a stale

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.298",
+  "version": "0.3.300",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -487,6 +487,15 @@ export class SyncEngine {
     return this._connectionStatus;
   }
 
+  /**
+   * Count of optimistic writes still queued locally (not yet acked by the
+   * server) — i.e. the offline outbox depth. 0 when fully synced. Read by the
+   * dev HUD's sync row; also handy for a "saving…" indicator.
+   */
+  pendingCount(): number {
+    return this.mutations.pending().length;
+  }
+
   /**
    * Mutate connection status + notify subscribers. Idempotent — same-
    * status calls are a no-op so the WS onopen → connected transition
@@ -533,6 +542,22 @@ export class SyncEngine {
     if (this.config.multiTab === false) {
       this.isMultiTabLeader = true;
     }
+    // Dev HUD hook: in dev (the server injects `__PYLON_DEV__` into the page),
+    // publish a tiny read-only status probe the floating dev overlay polls for
+    // the sync row (connection + offline-outbox depth). Gated on the dev marker
+    // so it's never present in production. Defensive — never let it break init.
+    try {
+      const g = globalThis as Record<string, unknown>;
+      if (typeof window !== "undefined" && g.__PYLON_DEV__) {
+        g.__pylonDevSync = {
+          status: () => this.connectionStatus(),
+          pending: () => this.pendingCount(),
+          rows: () => this.store.size(),
+        };
+      }
+    } catch {
+      // ignore — the HUD just won't show a sync row
+    }
   }
 
   /**

package/src/local-store.ts

@@ -60,6 +60,14 @@ export class LocalStore {
     return names;
   }
 
+  /** Total rows held across all entity tables — the local replica size.
+   *  Read by the dev HUD's sync row. */
+  size(): number {
+    let n = 0;
+    for (const table of this.tables.values()) n += table.size;
+    return n;
+  }
+
   /**
    * Remove a row whose absence was confirmed by the server-truth
    * reconciler. Records a tombstone at `tombstoneSeq` so a stale