@camstack/types 1.2.182 → 1.2.183

package/dist/addon.js

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-B1ZwxAhh.js");
-const require_event_category = require("./event-category-BNJ9EE5B.js");
+const require_sleep = require("./sleep-CfDqEZrs.js");
+const require_event_category = require("./event-category-yW4s1MGD.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/addon.mjs

@@ -1,5 +1,5 @@
-import { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, St as normalizeAddonInitResult, Tt as emitReadiness, V as ReadinessRegistry, a as asJsonObject, b as deviceOpsCapability, bt as DisposerChain, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as DATAPLANE_SECRET_HEADER, x as viewerUiCapability, xt as BaseAddon, z as readNodePin } from "./sleep-BnujYGPe.mjs";
-import { t as EventCategory } from "./event-category-DAXzJeTX.mjs";
+import { D as adminUiCapability, E as DeviceType, G as scopeKey, H as ReadinessTimeoutError, M as expandCapMethods, R as nodePin, S as DEVICE_CHILDREN_BATCH_MAX, St as normalizeAddonInitResult, Tt as emitReadiness, V as ReadinessRegistry, a as asJsonObject, b as deviceOpsCapability, bt as DisposerChain, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, m as createDeviceProxy, p as isDeviceScopedCap, s as asString, t as sleep, u as parseJsonUnknown, vt as DATAPLANE_SECRET_HEADER, x as viewerUiCapability, xt as BaseAddon, z as readNodePin } from "./sleep-CnLyvg3w.mjs";
+import { t as EventCategory } from "./event-category-ZyX6jcse.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts
 /**

package/dist/capabilities/data-store-provider.cap.d.ts

@@ -120,6 +120,22 @@ export declare const dataStoreProviderCapability: {
         }, z.core.$strip>, z.ZodObject<{
             id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
         }, z.core.$strip>, "mutation">;
+        /**
+         * Make a slot hold this row, and answer with the id the row HAS. The
+         * engine half of `settings-store.upsert` — read that docblock for why the
+         * store needed a slot that is not the primary key (D482).
+         */
+        readonly upsert: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            namespace: z.ZodOptional<z.ZodString>;
+            collection: z.ZodString;
+            conflict: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            record: z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>;
+        }, z.core.$strip>, z.ZodObject<{
+            id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        }, z.core.$strip>, "mutation">;
         /** Insert many records in ONE transaction. All or nothing. */
         readonly insertMany: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;

package/dist/capabilities/face-gallery.cap.d.ts

@@ -4,7 +4,7 @@ declare const IdentitySchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     sampleCount: z.ZodNumber;
-    coverMediaKey: z.ZodOptional<z.ZodString>;
+    coverMediaId: z.ZodOptional<z.ZodNumber>;
     coverBase64: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Identity = z.infer<typeof IdentitySchema>;
@@ -37,7 +37,7 @@ declare const IdentitySampleAuditRowSchema: z.ZodObject<{
         detected: "detected";
         photo: "photo";
     }>;
-    mediaKey: z.ZodOptional<z.ZodString>;
+    mediaId: z.ZodOptional<z.ZodNumber>;
     comparable: z.ZodBoolean;
     selfMean: z.ZodNullable<z.ZodNumber>;
     bestForeign: z.ZodOptional<z.ZodObject<{
@@ -64,7 +64,7 @@ declare const IdentitySampleAuditSchema: z.ZodObject<{
             detected: "detected";
             photo: "photo";
         }>;
-        mediaKey: z.ZodOptional<z.ZodString>;
+        mediaId: z.ZodOptional<z.ZodNumber>;
         comparable: z.ZodBoolean;
         selfMean: z.ZodNullable<z.ZodNumber>;
         bestForeign: z.ZodOptional<z.ZodObject<{
@@ -92,7 +92,7 @@ declare const FaceInfoSchema: z.ZodObject<{
         w: z.ZodNumber;
         h: z.ZodNumber;
     }, z.core.$strip>>;
-    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+    keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
     bestMatchScore: z.ZodOptional<z.ZodNumber>;
     nativeFaceShortSidePx: z.ZodOptional<z.ZodNumber>;
     suggestedIdentityId: z.ZodOptional<z.ZodString>;
@@ -148,7 +148,7 @@ export declare const faceGalleryCapability: {
             id: z.ZodString;
             name: z.ZodString;
             sampleCount: z.ZodNumber;
-            coverMediaKey: z.ZodOptional<z.ZodString>;
+            coverMediaId: z.ZodOptional<z.ZodNumber>;
             coverBase64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly createIdentity: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -157,7 +157,7 @@ export declare const faceGalleryCapability: {
             id: z.ZodString;
             name: z.ZodString;
             sampleCount: z.ZodNumber;
-            coverMediaKey: z.ZodOptional<z.ZodString>;
+            coverMediaId: z.ZodOptional<z.ZodNumber>;
             coverBase64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "mutation">;
         readonly renameIdentity: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -209,7 +209,7 @@ export declare const faceGalleryCapability: {
                     detected: "detected";
                     photo: "photo";
                 }>;
-                mediaKey: z.ZodOptional<z.ZodString>;
+                mediaId: z.ZodOptional<z.ZodNumber>;
                 comparable: z.ZodBoolean;
                 selfMean: z.ZodNullable<z.ZodNumber>;
                 bestForeign: z.ZodOptional<z.ZodObject<{
@@ -261,7 +261,7 @@ export declare const faceGalleryCapability: {
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             bestMatchScore: z.ZodOptional<z.ZodNumber>;
             nativeFaceShortSidePx: z.ZodOptional<z.ZodNumber>;
             suggestedIdentityId: z.ZodOptional<z.ZodString>;
@@ -286,7 +286,7 @@ export declare const faceGalleryCapability: {
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             bestMatchScore: z.ZodOptional<z.ZodNumber>;
             nativeFaceShortSidePx: z.ZodOptional<z.ZodNumber>;
             suggestedIdentityId: z.ZodOptional<z.ZodString>;
@@ -295,7 +295,7 @@ export declare const faceGalleryCapability: {
         readonly getFaceMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             faceId: z.ZodString;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            key: z.ZodString;
+            mediaId: z.ZodNumber;
             kind: z.ZodString;
             url: z.ZodString;
             sizeBytes: z.ZodNumber;

package/dist/capabilities/pipeline-analytics.cap.d.ts

@@ -468,7 +468,7 @@ declare const TrackSchema: z.ZodObject<{
             }>>;
             score: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>;
-        mediaKey: z.ZodString;
+        mediaId: z.ZodNumber;
     }, z.core.$strip>>>;
     zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
     zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -637,8 +637,8 @@ declare const ObjectEventSchema: z.ZodObject<{
     }, z.core.$strip>>;
     frameWidth: z.ZodOptional<z.ZodNumber>;
     frameHeight: z.ZodOptional<z.ZodNumber>;
-    mediaKey: z.ZodOptional<z.ZodString>;
-    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+    mediaId: z.ZodOptional<z.ZodNumber>;
+    keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
     mediaUrl: z.ZodOptional<z.ZodString>;
     importance: z.ZodOptional<z.ZodNumber>;
     label: z.ZodOptional<z.ZodString>;
@@ -724,7 +724,7 @@ export type MediaFileKind = z.infer<typeof MediaFileKindEnum>;
  * plus the bytes.
  */
 declare const MediaFileRefSchema: z.ZodObject<{
-    key: z.ZodString;
+    mediaId: z.ZodNumber;
     kind: z.ZodEnum<{
         crop: "crop";
         snapshot: "snapshot";
@@ -771,7 +771,7 @@ export interface MediaFileBytes extends MediaFileRef {
  * hub-main's heap on the way past — for an `<img>` that would have cached it.
  *
  * `url` points at the `event-media` data plane
- * (`/addon/<addonId>/event-media/<storedKey>`), which serves the same blob
+ * (`/addon/<addonId>/event-media/m/<mediaId>` — D482), which serves the same blob
  * with an ETag and `Cache-Control: immutable`, honours conditional GETs, can
  * render a `?variant=thumb`, and streams. The hub gate in front of it requires
  * a bearer or the session cookie (`access: 'authenticated'`), so the bytes are
@@ -779,10 +779,13 @@ export interface MediaFileBytes extends MediaFileRef {
  * `data-plane-access.ts` for the rule and the one gap it does not close
  * (per-device scoping).
  *
- * The URL is built from the row's **stored** key, which is not always its
- * published `kind`: a track's face/plate crop is stored as `crop` under
+ * The URL is built from the row's own id, which since D482 says nothing about
+ * the row's owner or kind — and that is the point. The published `kind` is not
+ * the stored one (a track's face/plate crop is stored as `crop` under
  * `('face'|'plate', '<prefix>-<trackId>')` and published as
- * `faceCrop`/`plateCrop`. `MediaStore.getByKey` knows only the stored key.
+ * `faceCrop`/`plateCrop`), and under the old composite key the URL had to be
+ * taken from `row.key` verbatim or it 404'd exactly those two rows. An id
+ * cannot be mis-reconstructed, because there is nothing in it to reconstruct.
  *
  * ## `base64` is TRANSITIONAL and is going away
  *
@@ -795,7 +798,7 @@ export interface MediaFileBytes extends MediaFileRef {
  * `analytics-query-facade.ts`; nothing else reads it.
  */
 declare const MediaFileSchema: z.ZodObject<{
-    key: z.ZodString;
+    mediaId: z.ZodNumber;
     kind: z.ZodEnum<{
         crop: "crop";
         snapshot: "snapshot";
@@ -832,7 +835,6 @@ export type MediaFile = z.infer<typeof MediaFileSchema>;
  * copy of a route — the embed, the viewer and the admin UI each grew one.
  */
 declare const MediaFileInfoSchema: z.ZodObject<{
-    key: z.ZodString;
     timestamp: z.ZodNumber;
     kind: z.ZodEnum<{
         crop: "crop";
@@ -851,6 +853,7 @@ declare const MediaFileInfoSchema: z.ZodObject<{
     }>;
     url: z.ZodString;
     sizeBytes: z.ZodNumber;
+    mediaId: z.ZodNumber;
 }, z.core.$strip>;
 export type MediaFileInfo = z.infer<typeof MediaFileInfoSchema>;
 /**
@@ -972,7 +975,7 @@ export declare const RetrainTrackSchema: z.ZodObject<{
 export type RetrainTrack = z.infer<typeof RetrainTrackSchema>;
 /** A frame the picker may offer — an index row, no blob was read to produce it. */
 export declare const RetrainFrameCandidateSchema: z.ZodObject<{
-    mediaKey: z.ZodString;
+    mediaId: z.ZodNumber;
     kind: z.ZodEnum<{
         crop: "crop";
         snapshot: "snapshot";
@@ -998,7 +1001,7 @@ export declare const RetrainFrameSchema: z.ZodObject<{
     frameId: z.ZodString;
     deviceId: z.ZodNumber;
     trackId: z.ZodString;
-    sourceMediaKey: z.ZodString;
+    sourceMediaId: z.ZodNumber;
     sourceKind: z.ZodEnum<{
         crop: "crop";
         snapshot: "snapshot";
@@ -1031,7 +1034,7 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
         frameId: z.ZodString;
         deviceId: z.ZodNumber;
         trackId: z.ZodString;
-        sourceMediaKey: z.ZodString;
+        sourceMediaId: z.ZodNumber;
         sourceKind: z.ZodEnum<{
             crop: "crop";
             snapshot: "snapshot";
@@ -1053,7 +1056,7 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
         copiedAt: z.ZodNumber;
     }, z.core.$strip>>>;
     refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-        sourceMediaKey: z.ZodString;
+        sourceMediaId: z.ZodNumber;
         reason: z.ZodEnum<{
             "source-missing": "source-missing";
             "unreadable-image": "unreadable-image";
@@ -1064,7 +1067,7 @@ export declare const RetrainFrameSelectionSchema: z.ZodObject<{
 export type RetrainFrameSelection = z.infer<typeof RetrainFrameSelectionSchema>;
 export declare const RetrainFrameListSchema: z.ZodObject<{
     candidates: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-        mediaKey: z.ZodString;
+        mediaId: z.ZodNumber;
         kind: z.ZodEnum<{
             crop: "crop";
             snapshot: "snapshot";
@@ -1088,7 +1091,7 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
         frameId: z.ZodString;
         deviceId: z.ZodNumber;
         trackId: z.ZodString;
-        sourceMediaKey: z.ZodString;
+        sourceMediaId: z.ZodNumber;
         sourceKind: z.ZodEnum<{
             crop: "crop";
             snapshot: "snapshot";
@@ -1109,7 +1112,7 @@ export declare const RetrainFrameListSchema: z.ZodObject<{
         height: z.ZodNumber;
         copiedAt: z.ZodNumber;
     }, z.core.$strip>>>;
-    autoPickMediaKey: z.ZodOptional<z.ZodString>;
+    autoPickMediaId: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type RetrainFrameList = z.infer<typeof RetrainFrameListSchema>;
 /** What the operator asked the assist to look for. */
@@ -1210,9 +1213,11 @@ declare const RecentTracksQueryInput: z.ZodObject<{
 export type RecentTracksQuery = z.infer<typeof RecentTracksQueryInput>;
 /**
  * A Summary (D359): the per-camera session envelope that references tracks.
- * `groupShotKey` is the media key of its group shot (`ownerKind: 'summary'`,
- * served by the event-media plane by key), null until the first frame with a
- * member visible has been materialised.
+ * `groupShotMediaId` is the media ROW id of its group shot (`ownerKind:
+ * 'summary'`, served by the event-media plane at `/m/<id>`), null until the
+ * first frame with a member visible has been materialised (D482 — it was the
+ * row's composite key, which embedded the owner and could name another table's
+ * row once event ids became per-table rowids).
  */
 export declare const SummarySchema: z.ZodObject<{
     id: z.ZodString;
@@ -1221,7 +1226,7 @@ export declare const SummarySchema: z.ZodObject<{
     lastActiveAt: z.ZodNumber;
     sealedAt: z.ZodNullable<z.ZodNumber>;
     memberCount: z.ZodNumber;
-    groupShotKey: z.ZodNullable<z.ZodString>;
+    groupShotMediaId: z.ZodNullable<z.ZodNumber>;
 }, z.core.$strip>;
 export type Summary = z.infer<typeof SummarySchema>;
 export declare const SUMMARIES_MAX_LIMIT = 200;
@@ -1234,7 +1239,7 @@ declare const SummariesPageSchema: z.ZodObject<{
         lastActiveAt: z.ZodNumber;
         sealedAt: z.ZodNullable<z.ZodNumber>;
         memberCount: z.ZodNumber;
-        groupShotKey: z.ZodNullable<z.ZodString>;
+        groupShotMediaId: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type SummariesPage = z.infer<typeof SummariesPageSchema>;
@@ -1246,7 +1251,7 @@ declare const SummaryDetailSchema: z.ZodObject<{
         lastActiveAt: z.ZodNumber;
         sealedAt: z.ZodNullable<z.ZodNumber>;
         memberCount: z.ZodNumber;
-        groupShotKey: z.ZodNullable<z.ZodString>;
+        groupShotMediaId: z.ZodNullable<z.ZodNumber>;
     }, z.core.$strip>;
     trackIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
@@ -1304,7 +1309,7 @@ declare const RecentTracksPageSchema: z.ZodObject<{
                 }>>;
                 score: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>;
-            mediaKey: z.ZodString;
+            mediaId: z.ZodNumber;
         }, z.core.$strip>>>;
         zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -1550,8 +1555,8 @@ export declare const ScoredObjectEventSchema: z.ZodObject<{
     }, z.core.$strip>>;
     frameWidth: z.ZodOptional<z.ZodNumber>;
     frameHeight: z.ZodOptional<z.ZodNumber>;
-    mediaKey: z.ZodOptional<z.ZodString>;
-    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+    mediaId: z.ZodOptional<z.ZodNumber>;
+    keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
     mediaUrl: z.ZodOptional<z.ZodString>;
     importance: z.ZodOptional<z.ZodNumber>;
     label: z.ZodOptional<z.ZodString>;
@@ -1788,7 +1793,7 @@ export declare const pipelineAnalyticsCapability: {
                     }>>;
                     score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
-                mediaKey: z.ZodString;
+                mediaId: z.ZodNumber;
             }, z.core.$strip>>>;
             zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -1897,7 +1902,7 @@ export declare const pipelineAnalyticsCapability: {
                     }>>;
                     score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
-                mediaKey: z.ZodString;
+                mediaId: z.ZodNumber;
             }, z.core.$strip>>>;
             zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -2035,7 +2040,7 @@ export declare const pipelineAnalyticsCapability: {
                     }>>;
                     score: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>;
-                mediaKey: z.ZodString;
+                mediaId: z.ZodNumber;
             }, z.core.$strip>>>;
             zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
             zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -2169,7 +2174,7 @@ export declare const pipelineAnalyticsCapability: {
                         }>>;
                         score: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>;
-                    mediaKey: z.ZodString;
+                    mediaId: z.ZodNumber;
                 }, z.core.$strip>>>;
                 zonesVisited: z.ZodReadonly<z.ZodArray<z.ZodString>>;
                 zoneNames: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
@@ -2239,7 +2244,7 @@ export declare const pipelineAnalyticsCapability: {
                 lastActiveAt: z.ZodNumber;
                 sealedAt: z.ZodNullable<z.ZodNumber>;
                 memberCount: z.ZodNumber;
-                groupShotKey: z.ZodNullable<z.ZodString>;
+                groupShotMediaId: z.ZodNullable<z.ZodNumber>;
             }, z.core.$strip>>>;
         }, z.core.$strip>, import("./capability-definition.js").CapabilityMethodKind>;
         /** One summary with its member track ids; `null` for an id nobody wrote. */
@@ -2253,7 +2258,7 @@ export declare const pipelineAnalyticsCapability: {
                 lastActiveAt: z.ZodNumber;
                 sealedAt: z.ZodNullable<z.ZodNumber>;
                 memberCount: z.ZodNumber;
-                groupShotKey: z.ZodNullable<z.ZodString>;
+                groupShotMediaId: z.ZodNullable<z.ZodNumber>;
             }, z.core.$strip>;
             trackIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -2333,8 +2338,8 @@ export declare const pipelineAnalyticsCapability: {
             }, z.core.$strip>>;
             frameWidth: z.ZodOptional<z.ZodNumber>;
             frameHeight: z.ZodOptional<z.ZodNumber>;
-            mediaKey: z.ZodOptional<z.ZodString>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            mediaId: z.ZodOptional<z.ZodNumber>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             mediaUrl: z.ZodOptional<z.ZodString>;
             importance: z.ZodOptional<z.ZodNumber>;
             label: z.ZodOptional<z.ZodString>;
@@ -3344,7 +3349,7 @@ export declare const pipelineAnalyticsCapability: {
             trackId: z.ZodString;
         }, z.core.$strip>, z.ZodObject<{
             candidates: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                mediaKey: z.ZodString;
+                mediaId: z.ZodNumber;
                 kind: z.ZodEnum<{
                     crop: "crop";
                     snapshot: "snapshot";
@@ -3368,7 +3373,7 @@ export declare const pipelineAnalyticsCapability: {
                 frameId: z.ZodString;
                 deviceId: z.ZodNumber;
                 trackId: z.ZodString;
-                sourceMediaKey: z.ZodString;
+                sourceMediaId: z.ZodNumber;
                 sourceKind: z.ZodEnum<{
                     crop: "crop";
                     snapshot: "snapshot";
@@ -3389,7 +3394,7 @@ export declare const pipelineAnalyticsCapability: {
                 height: z.ZodNumber;
                 copiedAt: z.ZodNumber;
             }, z.core.$strip>>>;
-            autoPickMediaKey: z.ZodOptional<z.ZodString>;
+            autoPickMediaId: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>, "query">;
         /**
          * COPY-ON-SELECT — the write that makes `trained` safe to evict.
@@ -3408,13 +3413,13 @@ export declare const pipelineAnalyticsCapability: {
         readonly selectRetrainFrames: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             deviceId: z.ZodNumber;
             trackId: z.ZodString;
-            mediaKeys: z.ZodArray<z.ZodString>;
+            mediaIds: z.ZodArray<z.ZodNumber>;
         }, z.core.$strip>, z.ZodObject<{
             copied: z.ZodReadonly<z.ZodArray<z.ZodObject<{
                 frameId: z.ZodString;
                 deviceId: z.ZodNumber;
                 trackId: z.ZodString;
-                sourceMediaKey: z.ZodString;
+                sourceMediaId: z.ZodNumber;
                 sourceKind: z.ZodEnum<{
                     crop: "crop";
                     snapshot: "snapshot";
@@ -3436,7 +3441,7 @@ export declare const pipelineAnalyticsCapability: {
                 copiedAt: z.ZodNumber;
             }, z.core.$strip>>>;
             refused: z.ZodReadonly<z.ZodArray<z.ZodObject<{
-                sourceMediaKey: z.ZodString;
+                sourceMediaId: z.ZodNumber;
                 reason: z.ZodEnum<{
                     "source-missing": "source-missing";
                     "unreadable-image": "unreadable-image";
@@ -3800,8 +3805,31 @@ export declare const pipelineAnalyticsCapability: {
         }, z.core.$strip>, z.ZodObject<{
             url: z.ZodString;
         }, z.core.$strip>, "query">;
+        /**
+         * The media an EVENT owns.
+         *
+         * `ownerType` is REQUIRED, and that is the whole correction (D482). An
+         * event is a row in ONE of three tables, and since D474 each numbers from
+         * 1 independently: `motion:101314` and `object:101314` both exist. This
+         * method took a bare `eventId` and the provider probed motion → object →
+         * audio, stopping at the first hit — so on the live hub, where object
+         * events own no media of their own and 299 883 of 300 559 media rows are
+         * motion-owned, EVERY object event resolved to its motion namesake. A
+         * track from 17:34 on camera 615 was served a snapshot from 22:35 eleven
+         * days earlier, silently.
+         *
+         * D476 had already disambiguated the KEY (`motion:` vs `object:`); this is
+         * the API catching up to it. Naming the table is not a "qualification" of
+         * the ambiguity — a listing BY OWNER has no address to make surrogate: the
+         * owner IS (table, id), and half of it is not a question.
+         */
         readonly getEventMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            eventId: z.ZodString;
+            ownerType: z.ZodEnum<{
+                motion: "motion";
+                object: "object";
+                audio: "audio";
+            }>;
+            eventId: z.ZodNumber;
             kind: z.ZodOptional<z.ZodEnum<{
                 crop: "crop";
                 snapshot: "snapshot";
@@ -3819,7 +3847,7 @@ export declare const pipelineAnalyticsCapability: {
             }>>;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            key: z.ZodString;
+            mediaId: z.ZodNumber;
             kind: z.ZodEnum<{
                 crop: "crop";
                 snapshot: "snapshot";
@@ -3863,7 +3891,7 @@ export declare const pipelineAnalyticsCapability: {
             }>>>;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            key: z.ZodString;
+            mediaId: z.ZodNumber;
             kind: z.ZodEnum<{
                 crop: "crop";
                 snapshot: "snapshot";
@@ -3903,7 +3931,6 @@ export declare const pipelineAnalyticsCapability: {
             trackId: z.ZodString;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            key: z.ZodString;
             timestamp: z.ZodNumber;
             kind: z.ZodEnum<{
                 crop: "crop";
@@ -3922,6 +3949,7 @@ export declare const pipelineAnalyticsCapability: {
             }>;
             url: z.ZodString;
             sizeBytes: z.ZodNumber;
+            mediaId: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * What media an EVENT has, without any of it — the twin `getEventMedia`
@@ -3936,14 +3964,20 @@ export declare const pipelineAnalyticsCapability: {
          * the live hub: one event's `fullFrameBoxed` is 2 824 077 B, base64'd to
          * ~3.8 MB, allocated whole in hub-main's heap, for a list of keys.
          *
-         * Same `deviceId` authorization subject as `getEventMedia`, and the same
-         * rows — this is a projection of that method, never a different question.
+         * Same `deviceId` authorization subject as `getEventMedia`, the same
+         * REQUIRED `ownerType` (read that method's docblock for the night-time
+         * thumbnail this closes — D482), and the same rows: this is a projection
+         * of that method, never a different question.
          */
         readonly listEventMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            eventId: z.ZodString;
+            ownerType: z.ZodEnum<{
+                motion: "motion";
+                object: "object";
+                audio: "audio";
+            }>;
+            eventId: z.ZodNumber;
             deviceId: z.ZodNumber;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            key: z.ZodString;
             timestamp: z.ZodNumber;
             kind: z.ZodEnum<{
                 crop: "crop";
@@ -3962,6 +3996,7 @@ export declare const pipelineAnalyticsCapability: {
             }>;
             url: z.ZodString;
             sizeBytes: z.ZodNumber;
+            mediaId: z.ZodNumber;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
          * Search object events by text query using CLIP cosine similarity.
@@ -4011,8 +4046,8 @@ export declare const pipelineAnalyticsCapability: {
             }, z.core.$strip>>;
             frameWidth: z.ZodOptional<z.ZodNumber>;
             frameHeight: z.ZodOptional<z.ZodNumber>;
-            mediaKey: z.ZodOptional<z.ZodString>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            mediaId: z.ZodOptional<z.ZodNumber>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             mediaUrl: z.ZodOptional<z.ZodString>;
             importance: z.ZodOptional<z.ZodNumber>;
             label: z.ZodOptional<z.ZodString>;

package/dist/capabilities/plate-gallery.cap.d.ts

@@ -4,7 +4,7 @@ declare const VehicleSchema: z.ZodObject<{
     id: z.ZodString;
     name: z.ZodString;
     sampleCount: z.ZodNumber;
-    coverMediaKey: z.ZodOptional<z.ZodString>;
+    coverMediaId: z.ZodOptional<z.ZodNumber>;
     coverBase64: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type Vehicle = z.infer<typeof VehicleSchema>;
@@ -34,7 +34,7 @@ declare const PlateInfoSchema: z.ZodObject<{
         w: z.ZodNumber;
         h: z.ZodNumber;
     }, z.core.$strip>>;
-    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+    keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
     base64: z.ZodOptional<z.ZodString>;
     cropUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -73,7 +73,7 @@ export declare const plateGalleryCapability: {
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             base64: z.ZodOptional<z.ZodString>;
             cropUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -97,14 +97,14 @@ export declare const plateGalleryCapability: {
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             base64: z.ZodOptional<z.ZodString>;
             cropUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly getPlateMedia: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             plateId: z.ZodString;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
-            key: z.ZodString;
+            mediaId: z.ZodNumber;
             kind: z.ZodString;
             url: z.ZodString;
             sizeBytes: z.ZodNumber;
@@ -133,7 +133,7 @@ export declare const plateGalleryCapability: {
                 w: z.ZodNumber;
                 h: z.ZodNumber;
             }, z.core.$strip>>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             base64: z.ZodOptional<z.ZodString>;
             cropUrl: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -163,7 +163,7 @@ export declare const plateGalleryCapability: {
             id: z.ZodString;
             name: z.ZodString;
             sampleCount: z.ZodNumber;
-            coverMediaKey: z.ZodOptional<z.ZodString>;
+            coverMediaId: z.ZodOptional<z.ZodNumber>;
             coverBase64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
         readonly createVehicle: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
@@ -172,7 +172,7 @@ export declare const plateGalleryCapability: {
             id: z.ZodString;
             name: z.ZodString;
             sampleCount: z.ZodNumber;
-            coverMediaKey: z.ZodOptional<z.ZodString>;
+            coverMediaId: z.ZodOptional<z.ZodNumber>;
             coverBase64: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>, "mutation">;
         readonly renameVehicle: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{