@camstack/types 1.2.182 → 1.2.183

package/dist/capabilities/scene-monitor.cap.d.ts

@@ -98,7 +98,7 @@ export declare const SceneReferenceSchema: z.ZodObject<{
     modelId: z.ZodString;
     condition: z.ZodString;
     capturedAt: z.ZodNumber;
-    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+    thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
     anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strip>;
 export declare const SceneMonitorStateSchema: z.ZodObject<{
@@ -109,7 +109,7 @@ export declare const SceneMonitorStateSchema: z.ZodObject<{
         modelId: z.ZodString;
         condition: z.ZodString;
         capturedAt: z.ZodNumber;
-        thumbnailMediaId: z.ZodOptional<z.ZodString>;
+        thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
         anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     }, z.core.$strip>>;
     textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -200,7 +200,7 @@ export declare const SceneMonitorSchema: z.ZodObject<{
             modelId: z.ZodString;
             condition: z.ZodString;
             capturedAt: z.ZodNumber;
-            thumbnailMediaId: z.ZodOptional<z.ZodString>;
+            thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
             anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
         }, z.core.$strip>>;
         textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -295,7 +295,7 @@ export declare const SceneMonitorStatusSchema: z.ZodObject<{
                 modelId: z.ZodString;
                 condition: z.ZodString;
                 capturedAt: z.ZodNumber;
-                thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                 anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
             }, z.core.$strip>>;
             textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -419,7 +419,7 @@ export declare const SceneMonitorStatusForDeviceSchema: z.ZodObject<{
                     modelId: z.ZodString;
                     condition: z.ZodString;
                     capturedAt: z.ZodNumber;
-                    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                    thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                     anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                 }, z.core.$strip>>;
                 textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -528,7 +528,7 @@ export declare const sceneMonitorCapability: {
                         modelId: z.ZodString;
                         condition: z.ZodString;
                         capturedAt: z.ZodNumber;
-                        thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                        thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                         anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                     }, z.core.$strip>>;
                     textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -644,7 +644,7 @@ export declare const sceneMonitorCapability: {
                             modelId: z.ZodString;
                             condition: z.ZodString;
                             capturedAt: z.ZodNumber;
-                            thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                            thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                             anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                         }, z.core.$strip>>;
                         textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -767,7 +767,7 @@ export declare const sceneMonitorCapability: {
                     modelId: z.ZodString;
                     condition: z.ZodString;
                     capturedAt: z.ZodNumber;
-                    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                    thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                     anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                 }, z.core.$strip>>;
                 textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -958,7 +958,7 @@ export declare const sceneMonitorCapability: {
                         modelId: z.ZodString;
                         condition: z.ZodString;
                         capturedAt: z.ZodNumber;
-                        thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                        thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                         anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                     }, z.core.$strip>>;
                     textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -1057,7 +1057,7 @@ export declare const sceneMonitorCapability: {
                     modelId: z.ZodString;
                     condition: z.ZodString;
                     capturedAt: z.ZodNumber;
-                    thumbnailMediaId: z.ZodOptional<z.ZodString>;
+                    thumbnailMediaId: z.ZodOptional<z.ZodNumber>;
                     anchorEmbedding: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
                 }, z.core.$strip>>;
                 textPrompts: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/capabilities/settings-store.cap.d.ts

@@ -195,6 +195,59 @@ export declare const settingsStoreCapability: {
             id: z.ZodString;
             data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
+        /**
+         * Make a SLOT hold this row — insert it, or update whatever already
+         * occupies the slot — and answer with the id the row HAS.
+         *
+         * ## Why the store needed this
+         *
+         * {@link set} is already an upsert, but its slot is the PRIMARY KEY: the
+         * caller has to know the id to address the row. That is exactly what a
+         * collection keyed by an `INTEGER` rowid alias cannot do — SQLite assigns
+         * the id, so a writer whose uniqueness rule is "one row per
+         * `(ownerKind, ownerId, kind, slot)`" has no id to name and no way to
+         * express the rule. {@link insert} can express it (a UNIQUE index
+         * arbitrates) but only by THROWING at the loser of a race, and the loser
+         * here is a legitimate re-capture, not an error.
+         *
+         * Getting there without this method means read-then-write: query the slot,
+         * then `insert` or `update`. Two statements instead of one, a race between
+         * them, and a recovery path that has to recognise a UNIQUE violation by its
+         * MESSAGE — across a process boundary, because the store lives behind an
+         * RPC door. A string match would be the whole gate, and a store that
+         * rephrased its error would lose the row silently. One statement has no
+         * such gate (D482).
+         *
+         * ## The contract
+         *
+         * `conflict` names the DECLARED columns that identify the slot. They must
+         * be covered by a UNIQUE index on the collection — SQLite resolves an
+         * `ON CONFLICT` target against its indexes and REFUSES the statement when
+         * none matches, so a wrong list is a loud error on the first write, never a
+         * silently duplicated row. An empty list is refused rather than passed on:
+         * `ON CONFLICT()` is not valid SQL, and the intent it would most likely
+         * encode ("no slot, just insert") is {@link insert}.
+         *
+         * Row shape is {@link insert}'s: `record.id` is used when the collection
+         * needs a supplied key and IGNORED when the primary key is an `INTEGER`
+         * rowid alias — exactly as `insert` and `insertMany` already treat it.
+         *
+         * Returns the id either way: the one SQLite assigned on an insert, or the
+         * one the row it updated already had. A caller cannot tell which happened,
+         * and deliberately — every caller wants the slot's id, and one that needed
+         * to distinguish creation from replacement would have to read first anyway.
+         */
+        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 a new record. */
         readonly insert: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
             namespace: z.ZodOptional<z.ZodString>;

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

@@ -52,7 +52,7 @@ declare const StationaryObjectSchema: z.ZodObject<{
     becameStationaryAt: z.ZodNumber;
     lastConfirmedAt: z.ZodNumber;
     label: z.ZodOptional<z.ZodString>;
-    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+    keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type StationaryObject = z.infer<typeof StationaryObjectSchema>;
 export declare const CameraOccupancySnapshotSchema: z.ZodObject<{
@@ -89,7 +89,7 @@ export declare const CameraOccupancySnapshotSchema: z.ZodObject<{
         becameStationaryAt: z.ZodNumber;
         lastConfirmedAt: z.ZodNumber;
         label: z.ZodOptional<z.ZodString>;
-        keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+        keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>>;
 }, z.core.$strip>;
 export type CameraOccupancySnapshot = z.infer<typeof CameraOccupancySnapshotSchema>;
@@ -149,7 +149,7 @@ export declare const CameraOccupancySnapshotForDeviceSchema: z.ZodObject<{
             becameStationaryAt: z.ZodNumber;
             lastConfirmedAt: z.ZodNumber;
             label: z.ZodOptional<z.ZodString>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
@@ -250,7 +250,7 @@ export declare const zoneAnalyticsCapability: {
                 becameStationaryAt: z.ZodNumber;
                 lastConfirmedAt: z.ZodNumber;
                 label: z.ZodOptional<z.ZodString>;
-                keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+                keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strip>>>>;
         }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
         /**
@@ -308,7 +308,7 @@ export declare const zoneAnalyticsCapability: {
                     becameStationaryAt: z.ZodNumber;
                     lastConfirmedAt: z.ZodNumber;
                     label: z.ZodOptional<z.ZodString>;
-                    keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+                    keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
                 }, z.core.$strip>>>>;
             }, z.core.$strip>>;
         }, z.core.$strip>>>, import("./capability-definition.js").CapabilityMethodKind>;
@@ -401,7 +401,7 @@ export declare const zoneAnalyticsCapability: {
             becameStationaryAt: z.ZodNumber;
             lastConfirmedAt: z.ZodNumber;
             label: z.ZodOptional<z.ZodString>;
-            keyFrameMediaKey: z.ZodOptional<z.ZodString>;
+            keyFrameMediaId: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>>>;
     }, z.core.$strip>;
     /**

package/dist/enums/event-category.d.ts

@@ -558,7 +558,7 @@ export declare enum EventCategory {
      * a package zone — a newly-appeared stationary object of a package class
      * that cleared the class / zone / dwell / size gates. Payload:
      * `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
-     * entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+     * entryId, className, zoneIds, keyFrameMediaId?, bbox, timestamp }`.
      * Telemetry (D8): the durable record is the `package-events` store row;
      * this bus topic drives notifier rules + live UI. See
      * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-BNJ9EE5B.js");
+const require_event_category = require("./event-category-yW4s1MGD.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-DAXzJeTX.mjs";
+import { t as EventCategory } from "./event-category-ZyX6jcse.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-DAXzJeTX.mjs → event-category-ZyX6jcse.mjs}

@@ -559,7 +559,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	* a package zone — a newly-appeared stationary object of a package class
 	* that cleared the class / zone / dwell / size gates. Payload:
 	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
-	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* entryId, className, zoneIds, keyFrameMediaId?, bbox, timestamp }`.
 	* Telemetry (D8): the durable record is the `package-events` store row;
 	* this bus topic drives notifier rules + live UI. See
 	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.

package/dist/{event-category-BNJ9EE5B.js → event-category-yW4s1MGD.js}

@@ -559,7 +559,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	* a package zone — a newly-appeared stationary object of a package class
 	* that cleared the class / zone / dwell / size gates. Payload:
 	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
-	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* entryId, className, zoneIds, keyFrameMediaId?, bbox, timestamp }`.
 	* Telemetry (D8): the durable record is the `package-events` store row;
 	* this bus topic drives notifier rules + live UI. See
 	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.

package/dist/generated/addon-api.d.ts

@@ -1634,6 +1634,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof dataStoreProviderCapability.methods.insert.output>;
             meta: object;
         }>;
+        upsert: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof dataStoreProviderCapability.methods.upsert.input>;
+            output: z.infer<typeof dataStoreProviderCapability.methods.upsert.output>;
+            meta: object;
+        }>;
         insertMany: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;
@@ -7127,6 +7134,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof settingsStoreCapability.methods.query.output>;
             meta: object;
         }>;
+        upsert: TRPCMutationProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof settingsStoreCapability.methods.upsert.input>;
+            output: z.infer<typeof settingsStoreCapability.methods.upsert.output>;
+            meta: object;
+        }>;
         insert: TRPCMutationProcedure<{
             input: {
                 [x: string]: unknown;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1029 method paths across 129 capabilities.
+ * Coverage: 1031 method paths across 129 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/system-proxy.d.ts

@@ -90,7 +90,7 @@ export interface SystemProxy {
     readonly recording: Pick<InferProvider<typeof recordingCapability>, 'getAvailabilityBatch' | 'getDaysWithRecordingsBatch' | 'getStorageUsage' | 'listOpsLog' | 'pauseForStorageMigration' | 'resumeForStorageMigration' | 'refreshStorageLocationsForMigration' | 'startStorageMigrationMove' | 'getStorageMigrationMoveStatus' | 'cancelStorageMigrationMove' | 'relocateFootage' | 'listRelocateJobs' | 'getRelocateResidue' | 'reconcileLedgerAgainstDisk' | 'cancelRelocateJob' | 'planStorageRebalance' | 'startStorageRebalance' | 'getPlacement' | 'setDevicePlacement'>;
     readonly recordingExport: Pick<InferProvider<typeof recordingExportCapability>, 'createExport' | 'getExport' | 'cancelExport' | 'deleteExport' | 'getDownloadUrl' | 'readExportBytes'>;
     readonly serverManagement: Pick<InferProvider<typeof serverManagementCapability>, 'getServerPackageStatus' | 'checkServerUpdate' | 'applyServerUpdate' | 'rollbackServerUpdate' | 'restartServer'>;
-    readonly settingsStore: Pick<InferProvider<typeof settingsStoreCapability>, 'get' | 'set' | 'query' | 'insert' | 'insertMany' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;
+    readonly settingsStore: Pick<InferProvider<typeof settingsStoreCapability>, 'get' | 'set' | 'query' | 'upsert' | 'insert' | 'insertMany' | 'update' | 'delete' | 'deleteWhere' | 'updateWhere' | 'count' | 'aggregate' | 'histogram' | 'isEmpty' | 'declareCollection'>;
     readonly storage: Pick<InferProvider<typeof storageCapability>, 'resolve' | 'write' | 'read' | 'exists' | 'list' | 'delete' | 'getAvailableSpace' | 'beginUpload' | 'writeChunk' | 'finalizeUpload' | 'abortUpload' | 'beginDownload' | 'readChunk' | 'endDownload' | 'listLocations' | 'listLocationDeclarations' | 'upsertLocation' | 'deleteLocation' | 'listDrainProgress' | 'testLocation' | 'listProviders' | 'testConfig'>;
     readonly storageMigration: Pick<InferProvider<typeof storageMigrationCapability>, 'plan' | 'start' | 'status' | 'cancel' | 'movers' | 'residue' | 'drain' | 'cleanupStart' | 'cleanupStatus' | 'cleanupCancel' | 'history'>;
     readonly streamBroker: Pick<InferProvider<typeof streamBrokerCapability>, 'fetchEventMedia' | 'listAllCameraStreams' | 'listAllProfileSlots' | 'getBrokerStats' | 'probeStream' | 'listClients' | 'killClient' | 'getStreamUrl' | 'getStreamWithCodec' | 'releaseStreamWithCodec' | 'acquireEgressTranscode' | 'releaseEgressTranscode' | 'subscribeAudioChunks' | 'pullAudioChunks' | 'unsubscribeAudioChunks' | 'subscribeFrames' | 'pullFrameHandles' | 'unsubscribeFrames' | 'setPreBufferDuration' | 'getPreBufferInfo' | 'getRtspPort' | 'getAllRtspEntries' | 'getRtspEntry' | 'regenerateRtspToken' | 'setRtspEnabled' | 'isRtspEnabled'>;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from './audio/audio-chunk-format.js';
 export type { EventOwnerType, MediaOwnerKey, MediaOwnerKeyInput, MediaOwnerType, } from './media/media-owner-key.js';
-export { EVENT_OWNER_TYPES, MEDIA_OWNER_TYPES, formatMediaOwnerKey, isEventOwnerType, parseMediaOwnerKey, } from './media/media-owner-key.js';
+export { EVENT_OWNER_TYPES, EventOwnerTypeSchema, MEDIA_OWNER_TYPES, formatMediaOwnerKey, isEventOwnerType, isMediaOwnerType, parseMediaOwnerKey, } from './media/media-owner-key.js';
 export type { CapabilitiesAccess } from './addon/base-addon.js';
 export { BaseAddon, normalizeAddonInitResult } from './addon/base-addon.js';
 export type { AddonRouteInvokeRequest, AddonRouteReplyEnvelope, } from './addon/build-addon-route-provider.js';