@camstack/types 1.2.182 → 1.2.184

package/dist/interfaces/event-bus.d.ts

@@ -216,8 +216,8 @@ export interface PipelineAnalyticsTrackLifecyclePayload {
     }>;
     /** The current best image, addressable over HTTP. */
     readonly media?: {
-        readonly keyFrameMediaKey?: string;
-        readonly bestCropMediaKey?: string;
+        readonly keyFrameMediaId?: number;
+        readonly bestCropMediaId?: number;
         readonly bestEventId?: string;
     };
     readonly embeddingId?: string;
@@ -276,8 +276,8 @@ export interface PipelineAnalyticsPackageDeliveredPayload {
     readonly className: string;
     /** Package-zone ids the entry's centroid fell inside. */
     readonly zoneIds: readonly string[];
-    /** Native-res key-frame crop key (resolve via the event-media plane). */
-    readonly keyFrameMediaKey?: string;
+    /** Native-res key-frame media row id (resolve via the event-media plane, D482). */
+    readonly keyFrameMediaId?: number;
     readonly bbox: {
         readonly x: number;
         readonly y: number;

package/dist/interfaces/storage.d.ts

@@ -109,6 +109,20 @@ export interface SettingsInsertInput<T extends object = Record<string, unknown>>
     readonly collection: SettingsCollection;
     readonly record: SettingsInsertRecord<T>;
 }
+/**
+ * Input for an UPSERT against a slot that is not the primary key — see
+ * `settings-store.cap.ts`'s `upsert` docblock (D482).
+ *
+ * `conflict` names declared columns covered by a UNIQUE index. It is never
+ * empty: `ON CONFLICT()` is not valid SQL, and the intent an empty list would
+ * encode is `insert`.
+ */
+export interface SettingsUpsertInput<T extends object = Record<string, unknown>> {
+    readonly namespace?: string;
+    readonly collection: SettingsCollection;
+    readonly conflict: readonly string[];
+    readonly record: SettingsInsertRecord<T>;
+}
 export interface SettingsUpdateInput {
     readonly namespace?: string;
     readonly collection: SettingsCollection;
@@ -182,6 +196,10 @@ export interface ISettingsBackend {
     insert<T extends object = Record<string, unknown>>(input: SettingsInsertInput<T>): Promise<{
         readonly id: string | number;
     }>;
+    /** Make a slot hold this row, answering with the id the row has (D482) */
+    upsert<T extends object = Record<string, unknown>>(input: SettingsUpsertInput<T>): Promise<{
+        readonly id: string | number;
+    }>;
     /** Update an existing record by ID */
     update(input: SettingsUpdateInput): Promise<void>;
     /** Delete a record by key/ID */

package/dist/media/media-owner-key.d.ts

@@ -28,9 +28,19 @@
  * throws: it sits on the media READ path, where an exception takes out every
  * thumbnail and a guess puts the wrong image on screen. A legacy `event:` key
  * is therefore unreadable BY DESIGN - on this hub the 299 883 resolvable ones
- * are rewritten by the D474 data migration, and the 676 that remain were
- * already orphaned, their event having aged out before it.
+ * are rewritten by the D474 data migration.
+ *
+ * The 676 that remain are NOT what this comment used to claim ("already
+ * orphaned, their event having aged out before it"). Measured 2026-09-12
+ * (D480): 675 are notification summary MOSAICS, filed under
+ * `ownerKind: 'event'` with a synthetic `summary-<ruleId>-<windowEndMs>` owner
+ * id that no event row has ever had — 271 MiB on one camera, still growing.
+ * Exactly ONE is a real aged-out orphan. The retention cascade escapes 1 row
+ * in 300 220, and reading this residue as "what the cascade missed" is what
+ * sent D480 looking in the wrong place; read that record before trusting any
+ * count here.
  */
+import { z } from 'zod';
 /**
  * Owner types, i.e. the tables that own media.
  *
@@ -46,7 +56,7 @@
  * rejected their keys the day one appeared. A list derived from data is a list
  * that is correct until the data changes.
  */
-export declare const MEDIA_OWNER_TYPES: readonly ["track", "summary", "face", "identity", "plate", "vehicle", "scene", "motion", "object", "audio"];
+export declare const MEDIA_OWNER_TYPES: readonly ["track", "summary", "face", "identity", "plate", "vehicle", "scene", "motion", "object", "audio", "mosaic"];
 export type MediaOwnerType = (typeof MEDIA_OWNER_TYPES)[number];
 /** A parsed media key. `timestampMs` is absent for the three-segment form. */
 export interface MediaOwnerKey {
@@ -66,6 +76,16 @@ export interface MediaOwnerKeyInput {
     readonly fileKind: string;
     readonly timestampMs?: number;
 }
+/**
+ * Is this string a declared media owner type?
+ *
+ * Exported because the `event-media` plane's path parser needs it (D482): a
+ * path segment is an arbitrary string until something narrows it, and a
+ * hand-written list at the door would drift from {@link MEDIA_OWNER_TYPES} the
+ * day an owner kind is added — the failure this module's own docblock already
+ * records for `vehicle` and `scene`.
+ */
+export declare function isMediaOwnerType(value: string): value is MediaOwnerType;
 /**
  * Read a media key. `null` when it is not one - an unknown owner type, a legacy
  * `event:` key, a missing segment, or a fourth segment that is not a timestamp.
@@ -86,5 +106,19 @@ export declare function formatMediaOwnerKey(key: MediaOwnerKeyInput): string;
  */
 export declare const EVENT_OWNER_TYPES: readonly ["motion", "object", "audio"];
 export type EventOwnerType = (typeof EVENT_OWNER_TYPES)[number];
+/**
+ * The same list as a Zod enum, for the cap inputs that must NAME the table
+ * (D482: `getEventMedia` / `listEventMedia` take an owner, and an owner is
+ * `(table, id)`).
+ *
+ * Built FROM {@link EVENT_OWNER_TYPES} rather than re-spelled: a fourth event
+ * table would otherwise be accepted by the codec and refused at the door, with
+ * nothing failing until a caller asked.
+ */
+export declare const EventOwnerTypeSchema: z.ZodEnum<{
+    motion: 'motion';
+    object: 'object';
+    audio: 'audio';
+}>;
 /** True when this key's owner is one of the three event tables. */
 export declare function isEventOwnerType(ownerType: MediaOwnerType): ownerType is EventOwnerType;

package/dist/{sleep-B1ZwxAhh.js → sleep-CfDqEZrs.js}

@@ -1,4 +1,4 @@
-const require_event_category = require("./event-category-BNJ9EE5B.js");
+const require_event_category = require("./event-category-yW4s1MGD.js");
 let zod = require("zod");
 //#region src/audio/audio-chunk-format.ts
 /**

package/dist/{sleep-BnujYGPe.mjs → sleep-CnLyvg3w.mjs}

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-DAXzJeTX.mjs";
+import { t as EventCategory } from "./event-category-ZyX6jcse.mjs";
 import { z } from "zod";
 //#region src/audio/audio-chunk-format.ts
 /**

package/package.json

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