@camstack/system 1.2.80 → 1.2.81

package/dist/builtins/snapshot/snapshot-coalescing.d.ts

@@ -42,8 +42,13 @@ export declare const SWR_COLD_WAIT_MS = 10000;
  * Max simultaneous ffmpeg keyframe grabs — the WRAPPER path, the common case for
  * cameras with no vendor snapshot URL. A 20-cam grid mount spawns at most this
  * many ffmpeg processes; the rest serve cached frames (SWR) or queue.
+ *
+ * Raised 3 → 6 on 2026-08-12 (operator): a 17-camera cold start serialised
+ * into 6 waves and the client-side "image displayed" clustering matched the
+ * pool exactly (p90 10.8 s). Measured client-side after the raise — if the
+ * hub shows decode pressure, this is the first knob to lower.
  */
-export declare const MAX_CONCURRENT_GRABS = 3;
+export declare const MAX_CONCURRENT_GRABS = 6;
 /**
  * Max simultaneous cheap native snapshot fetches (vendor HTTP/ONVIF). Higher than
  * the ffmpeg bound because a native fetch is a lightweight HTTP round-trip, not a

package/dist/builtins/snapshot/snapshot.addon.d.ts

@@ -217,6 +217,16 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      * and no cache propagates.
      */
     private resolveOutcome;
+    /**
+     * Reconcile backstop for a stale hit: is the frame we are about to serve the
+     * property of a device that no longer exists?
+     *
+     * Asked ONLY past `staleTtlMs`, which is already the "something is wrong"
+     * threshold — so the common path costs nothing. A `true` answer evicts and
+     * the caller returns null; anything else leaves the existing
+     * keep-the-UI-from-going-blank contract untouched.
+     */
+    private staleHitBelongsToRemovedDevice;
     /**
      * Run the capture ladder ONCE for a device: native provider first, then the
      * stream-broker ffmpeg fallback. Never rejects — resolves a {@link
@@ -289,6 +299,25 @@ export declare class SnapshotAddon extends BaseAddon<SnapshotAddonConfig> {
      */
     private runGrabWithResumeRetry;
     private invalidateCache;
+    /** Forget every cached artefact of one device: frames, derived variants and
+     *  any settled single-flight result that would answer the next request. */
+    private dropDeviceCaches;
+    /**
+     * The device is GONE — drop its cached frames and say so.
+     *
+     * Distinct from `invalidateCache` (a refresh, expected and silent): this is
+     * the terminal case, and a deleted camera that keeps answering with its last
+     * JPEG looks to an operator exactly like a camera that was never deleted.
+     */
+    private evictRemovedDevice;
+    /**
+     * Does device-manager still know this id?
+     *
+     * `null` means the question could not be answered — a transport hiccup is
+     * not a deletion (D49), and the caller keeps serving what it has. Only an
+     * explicit "no such device" evicts.
+     */
+    private deviceStillExists;
     /**
      * Sleep state from the device-state MIRROR, not from a cap round-trip.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/system",
-  "version": "1.2.80",
+  "version": "1.2.81",
   "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
   "keywords": [
     "camstack",