@camstack/types 0.1.39 → 0.1.41

package/dist/stream-selection.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared stream-selection picker for export addons.
+ *
+ * Both `addon-export-alexa` and `addon-export-hap` resolve the
+ * operator's `streamPreference` setting against the broker's RTSP
+ * entries before dialling a camera. Each addon used to roll its own:
+ * Alexa had `pickPreferredRtspEntry` under `handlers/`, HAP had an
+ * inline `"prefer /mid, then /high, then first"` chain inside its
+ * camera-streams mapper. The chains drifted (Alexa honoured
+ * `streamPreference`, HAP didn't; only Alexa got the smart
+ * resolution-targeted auto-pick) and the cross-addon import rule
+ * blocks deduping in either direction.
+ *
+ * Lifting the picker into `@camstack/types` lets every exporter call
+ * the same code path with the consumer's target resolution baked into
+ * the call site — Alexa passes 1280×720, HomeKit passes 1920×1080,
+ * the picker handles the rest.
+ *
+ * Selection algorithm:
+ *   - pref === '<profile>' → profile-keyed entries (from
+ *                         `getProfileRtspEntries`) match on `e.profile`;
+ *                         legacy raw entries match on the brokerId
+ *                         suffix (`brokerId` ENDS WITH `/${pref}`, shape
+ *                         `${deviceId}/${camStreamId}`). Addons store the
+ *                         bare profile/camStream id in their
+ *                         `ExportDeviceSettings.streamPreference`. Falls
+ *                         back to 'auto' when no enabled entry matches
+ *                         either way.
+ *   - pref === 'auto'   → when `targetResolution` is given, pick the
+ *                         entry whose source resolution is closest to
+ *                         it (prefer ≥ target so the consumer
+ *                         downscales instead of upscaling). Without a
+ *                         target, fall back to first-enabled. If no
+ *                         entry advertises a resolution at all
+ *                         (broker hasn't probed yet), also fall back
+ *                         to first-enabled so cold start still serves.
+ *
+ * Returns `null` when nothing is publishable — callers fold that into
+ * the consumer's "no stream" error (Alexa: STREAM_TYPE_UNSUPPORTED;
+ * HAP: a thrown error inside `startFfmpegForSession`).
+ */
+export interface RtspEntryLike {
+    readonly brokerId: string;
+    readonly url: string;
+    readonly mutedUrl: string;
+    readonly enabled: boolean;
+    readonly codec?: string;
+    readonly resolution?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /**
+     * Profile slot this entry serves, set by `getProfileRtspEntries`.
+     * When `pref` is a profile ('high'|'mid'|'low') the picker matches on
+     * this first, before the legacy brokerId-suffix match.
+     */
+    readonly profile?: 'high' | 'mid' | 'low';
+}
+export interface PickedStream {
+    readonly brokerId: string;
+    readonly profileId: string;
+    readonly url: string;
+    readonly mutedUrl: string;
+    readonly enabled: boolean;
+    readonly codec?: string;
+    readonly resolution?: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export interface PickPreferredOptions {
+    /**
+     * Consumer's target resolution (Alexa ≈ 1280×720, HomeKit ≈ 1920×1080).
+     * When set and `pref === 'auto'`, the picker chooses the entry whose
+     * source resolution is closest — prefer ≥ target (downscale ok at
+     * the consumer), among the rest pick the largest source still ≤
+     * target. When absent, 'auto' falls back to first-enabled.
+     */
+    readonly targetResolution?: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export declare function pickPreferredRtspEntry(entries: readonly RtspEntryLike[], pref: 'auto' | string, deviceId: number, options?: PickPreferredOptions): PickedStream | null;
+//# sourceMappingURL=stream-selection.d.ts.map

package/dist/stream-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-selection.d.ts","sourceRoot":"","sources":["../src/stream-selection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACzE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,CAAA;CAC1C;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAChF;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,oBAAyB,GACjC,YAAY,GAAG,IAAI,CA0CrB"}

package/dist/types/detection.d.ts

@@ -200,9 +200,9 @@ export interface AudioDetection extends DetectionBase {
  *
  * Named `DetectionEntry` rather than `Detection` because the
  * device-capabilities namespace already exports a different `Detection`
- * interface for Scrypted-style object detectors. The two live in
- * separate files but both are re-exported at the package root, so
- * keeping names distinct avoids an import-level collision.
+ * interface for object detectors. The two live in separate files but
+ * both are re-exported at the package root, so keeping names distinct
+ * avoids an import-level collision.
  */
 export type DetectionEntry = ObjectDetection | AudioDetection;
 /**

package/dist/types/io.d.ts

@@ -32,9 +32,21 @@ export interface FrameInput {
     readonly height: number;
     readonly timestamp: number;
 }
+/**
+ * Wire-safe audio chunk passed to the audio-analyzer and detection-pipeline
+ * caps.  `data` holds the raw f32le bytes (4 bytes per sample, little-endian
+ * IEEE 754 float).  Using `Uint8Array` rather than `Float32Array` is required
+ * for correct UDS/MsgPack transport: `@msgpack/msgpack` serialises both as a
+ * binary blob, but deserialises it as `Uint8Array`.  A `Float32Array` receiver
+ * would silently read each individual byte (0–255) as a sample, producing
+ * wildly wrong level measurements (~+43 dBFS instead of ≤ 0).
+ *
+ * To iterate samples as floats, reconstruct the view:
+ *   `new Float32Array(chunk.data.buffer, chunk.data.byteOffset, chunk.data.byteLength / 4)`
+ */
 export interface AudioChunkInput {
     readonly [key: string]: unknown;
-    readonly data: Float32Array<ArrayBuffer>;
+    readonly data: Uint8Array<ArrayBuffer>;
     readonly sampleRate: number;
     readonly channels: number;
     readonly timestamp: number;

package/dist/types/io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/types/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEpE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAA;AAEpE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAA;QACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAC7B,CAAA;IACD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAClC"}
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../src/types/io.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEpE,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAA;AAEpE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IAC/B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAMD;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;QACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAA;QACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAC7B,CAAA;IACD,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,EAAE,CAAA;CAClC"}

package/dist/util/location-match.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pure fuzzy matcher for adoption location import. Normalized
+ * case-insensitive Levenshtein similarity, used to reuse an existing
+ * CamStack location when an imported source location (e.g. an HA area) is
+ * close enough — otherwise the caller creates a new location.
+ */
+/** Similarity in [0,1]; 1 = identical (after trim + lowercase). */
+export declare function locationSimilarity(a: string, b: string): number;
+/**
+ * Returns the existing name with the highest similarity to `externalName`,
+ * provided it is at least `threshold`; otherwise `null` (caller should create
+ * a new location named `externalName`).
+ */
+export declare function bestLocationMatch(externalName: string, existing: readonly string[], threshold?: number): string | null;
+//# sourceMappingURL=location-match.d.ts.map

package/dist/util/location-match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location-match.d.ts","sourceRoot":"","sources":["../../src/util/location-match.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA6BH,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,SAAS,SAAM,GACd,MAAM,GAAG,IAAI,CAWf"}

package/dist/utils/canonical-hash.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Deterministic SHA-256 hash of an arbitrary serialisable value. The
+ * canonical form sorts object keys alphabetically at every depth so two
+ * structurally-equal inputs with different key insertion orders produce
+ * the same hash. Returns a 64-char lowercase hex digest.
+ *
+ * Used by export adapters (Alexa, HAP) to short-circuit re-discovery /
+ * accessory-rebuild work when the upstream shape is byte-identical to
+ * the last applied state — preventing user-visible "re-discovery"
+ * notifications on every addon-runner respawn. Each respawn re-fires
+ * `DeviceBindingsChanged` for every cap registration, which without
+ * this guard would propagate redundant pushes.
+ *
+ * Note: this is a SYMPTOMATIC fix layered on top of the binding-change
+ * subscription. The proper fix is a single "device ready" lifecycle
+ * barrier so exports react only when the full cap set has landed —
+ * tracked separately for post-HA-integration work.
+ */
+export declare function canonicalHash(value: unknown): string;
+//# sourceMappingURL=canonical-hash.d.ts.map

package/dist/utils/canonical-hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-hash.d.ts","sourceRoot":"","sources":["../../src/utils/canonical-hash.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/dist/utils/export-reconciler.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Pure, stateless primitives shared by the camera export addons (Alexa, HAP)
+ * to advertise devices to external ecosystems without re-discovery storms.
+ *
+ * Spec: docs/superpowers/specs/2026-06-01-alexa-hap-export-reconciler-design.md
+ *
+ * Two functions, both pure (no I/O, no clock, no randomness, no event
+ * subscriptions) so they are exhaustively unit-testable in isolation:
+ *
+ *   1) `canonicalDeviceFingerprint(shape)` — a stable hash of the
+ *      EXPORT-RELEVANT device shape (coarse type + the persisted
+ *      `DeviceFeature` set). Order-independent and de-duplicated, so an
+ *      unchanged device produces an identical fingerprint across restarts.
+ *      Identity (`deviceId`) and volatile runtime values (online, battery%,
+ *      name, location) are deliberately excluded.
+ *
+ *   2) `diffExportTargets(desired, lastAdvertised)` — a 3-way set diff keyed
+ *      by `deviceId`: what to add, what to update (fingerprint changed), what
+ *      to remove (no longer desired). Each exporter feeds its own persisted
+ *      per-target sync state in and applies the resulting delta to its
+ *      platform.
+ *
+ * The wiring — event subscription, boot scan, platform apply, persistence —
+ * stays in each exporter; only the fingerprint + diff are shared.
+ */
+/** The export-relevant projection of a device, fed into the fingerprint. */
+export interface DeviceExportShape {
+    /** Numeric device id. Identity only — NOT part of the fingerprint. */
+    readonly deviceId: number;
+    /**
+     * Coarse driver classification (e.g. `'camera' | 'battery-camera' | 'nvr'`),
+     * sourced from the `feature-probe` slice's `deviceType`. Part of the shape:
+     * the same feature set on a different device class can map to a different
+     * export surface.
+     */
+    readonly deviceType: string;
+    /**
+     * Export-relevant `DeviceFeature` values (e.g. `'pan-tilt-zoom'`,
+     * `'two-way-audio'`, `'doorbell-button'`, `'motion-trigger'`,
+     * `'battery-operated'`, `'ptz-autotrack'`). Sourced from the PERSISTED
+     * `PersistedDeviceMeta.features`, so it survives restart and is stable
+     * without a re-probe. Hashed order-independently + de-duplicated.
+     */
+    readonly features: readonly string[];
+}
+/**
+ * Compute the stable 64-char lowercase-hex fingerprint of a device's
+ * export-relevant shape. Two structurally-equal shapes (any feature order,
+ * any duplicates, any deviceId) hash identically.
+ */
+export declare function canonicalDeviceFingerprint(shape: DeviceExportShape): string;
+/** Per-export-target sync state for one device, persisted addon-side. */
+export interface ExportTargetEntry {
+    /** Fingerprint last advertised to this target for this device. */
+    readonly fingerprint: string;
+    /**
+     * Platform-specific external ids (Alexa endpoint ids, HAP accessory UUIDs).
+     * Opaque to the diff — carried so the exporter can address what to update or
+     * delete on its platform.
+     */
+    readonly externalIds: readonly string[];
+}
+/** The 3-way delta produced by `diffExportTargets`. */
+export interface ExportDelta<T> {
+    /** Desired devices with no last-advertised entry — publish fresh. */
+    readonly toAdd: readonly T[];
+    /** Desired devices whose fingerprint differs from last-advertised — re-advertise. */
+    readonly toUpdate: readonly T[];
+    /** `deviceId`s present in last-advertised but absent from desired — retract. */
+    readonly toRemove: readonly number[];
+}
+/**
+ * Pure 3-way diff of desired export state against the persisted
+ * last-advertised state, keyed by `deviceId`.
+ *
+ * - `desired` — one entry per device to advertise this cycle, each carrying
+ *   the freshly-computed `fingerprint`.
+ * - `lastAdvertised` — the exporter's persisted per-target sync state.
+ *
+ * Neither input is mutated.
+ */
+export declare function diffExportTargets<T extends {
+    deviceId: number;
+    fingerprint: string;
+}>(desired: readonly T[], lastAdvertised: ReadonlyMap<number, ExportTargetEntry>): ExportDelta<T>;
+/**
+ * Resolve the fingerprint an exporter should feed into `diffExportTargets`
+ * for one device this cycle.
+ *
+ * When a device is NOT yet probe-ready, carry forward its last-advertised
+ * (persisted) fingerprint so it nets to NO CHANGE in `diffExportTargets`
+ * (neither update nor remove) — never advertise a partial mid-probe shape. A
+ * brand-new un-probed device with no persisted entry falls back to `fresh` so
+ * it can advertise once.
+ */
+export declare function resolveExportFingerprint(input: {
+    ready: boolean;
+    fresh: string;
+    persisted: string | undefined;
+}): string;
+//# sourceMappingURL=export-reconciler.d.ts.map

package/dist/utils/export-reconciler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-reconciler.d.ts","sourceRoot":"","sources":["../../src/utils/export-reconciler.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAG3E;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED,uDAAuD;AACvD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAA;IAC5B,qFAAqF;IACrF,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,CAAA;IAC/B,gFAAgF;IAChF,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;CACrC;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EACnF,OAAO,EAAE,SAAS,CAAC,EAAE,EACrB,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,GACrD,WAAW,CAAC,CAAC,CAAC,CAsBhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAC9C,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;CAC9B,GAAG,MAAM,CAGT"}

package/dist/utils/privacy-grid-raster.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Privacy-mask rect ↔ cell rasterizer.
+ *
+ * Converts between a list of normalized axis-aligned rectangles
+ * (the native camera representation) and a row-major boolean cell grid
+ * (the cap model). All coordinates are in [0, 1] normalized space
+ * where (0, 0) is top-left.
+ *
+ * These utilities are pure functions with no side effects — safe to use
+ * in any addon without cross-process concerns.
+ */
+/** Normalized axis-aligned rect: origin (x, y), size (w, h). All values in [0, 1]. */
+export interface NormRect {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+/**
+ * Rasterize a list of normalized rects into a row-major boolean cell grid.
+ *
+ * Each cell at grid position (col, row) has its centre at:
+ *   cx = (col + 0.5) / gridWidth
+ *   cy = (row + 0.5) / gridHeight
+ *
+ * A cell is `true` when its centre falls inside any rect (closed interval
+ * on all four edges so single-pixel-wide rects always activate the cell
+ * whose centre is nearest the edge).
+ *
+ * Returns an array of length `gridWidth * gridHeight` in row-major order.
+ * Returns all-false when `rects` is empty or grid dimensions are ≤ 0.
+ */
+export declare function rectsToCells(rects: readonly NormRect[], gridWidth: number, gridHeight: number): boolean[];
+/**
+ * Convert a row-major boolean cell grid back into normalized rects, capped at
+ * `maxRegions`.
+ *
+ * The algorithm performs a greedy maximal-rectangle cover:
+ * 1. Scans row by row to identify horizontal runs of `true` cells.
+ * 2. Merges vertically adjacent runs with the same column span.
+ * 3. Returns each resulting block as a normalized `NormRect`.
+ * 4. When more than `maxRegions` blocks result, keeps the `maxRegions`
+ *    largest (by cell area).
+ *
+ * Returns an empty array for an empty grid or all-false cells.
+ */
+export declare function cellsToRects(cells: readonly boolean[], gridWidth: number, gridHeight: number, maxRegions: number): NormRect[];
+//# sourceMappingURL=privacy-grid-raster.d.ts.map

package/dist/utils/privacy-grid-raster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-grid-raster.d.ts","sourceRoot":"","sources":["../../src/utils/privacy-grid-raster.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,QAAQ,EAAE,EAC1B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,OAAO,EAAE,CA2BX;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,QAAQ,EAAE,CAsFZ"}

package/dist/utils/sleep.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Promise-based timer helpers — used everywhere the codebase needs to
+ * wait, back off, or schedule a retry. Before these helpers landed, each
+ * call site re-implemented `new Promise(r => setTimeout(r, ms))` inline,
+ * with subtle variations (some swallowing cancellation, some not). Two
+ * shapes cover every observed use case:
+ *
+ *  - {@link sleep} for a plain, uncancellable wait — the default choice.
+ *  - {@link sleepCancellable} for a wait that wakes early when an
+ *    abort signal trips, used by long-running pollers whose teardown
+ *    must stop a pending backoff promptly.
+ */
+/**
+ * Resolve after `ms` milliseconds. Never rejects, never cancels. The
+ * sleep cannot be interrupted; for a wakeable variant use
+ * {@link sleepCancellable}.
+ *
+ * `ms <= 0` resolves on the next microtask via `setTimeout(0)`, which
+ * still gives the event loop a chance to drain — useful for breaking
+ * up tight async loops without changing call-site semantics.
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Resolve after `ms` milliseconds OR when `signal.aborted` flips,
+ * whichever fires first. The returned promise never rejects — aborted
+ * sleeps resolve normally so callers can model "wait or wake" without
+ * try/catch noise.
+ *
+ *   await sleepCancellable(backoffMs, lifecycle.abortSignal)
+ *   if (lifecycle.aborted) return
+ *
+ * If `signal` is already aborted at call time the helper resolves on
+ * the next microtask.
+ */
+export declare function sleepCancellable(ms: number, signal: AbortSignal): Promise<void>;
+//# sourceMappingURL=sleep.d.ts.map

package/dist/utils/sleep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.d.ts","sourceRoot":"","sources":["../../src/utils/sleep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAc/E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",