camstack 1.2.143 → 1.2.145

package/dist/{chunk-E3UKNBI7.js → chunk-W67ATFOA.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-BnujYGPe.mjs
+// ../types/dist/sleep-CnLyvg3w.mjs
 var AUDIO_CHUNK_FORMATS = [
   "f32le",
   "pcmu",
@@ -15399,7 +15399,8 @@ var MEDIA_OWNER_TYPES = [
   "scene",
   "motion",
   "object",
-  "audio"
+  "audio",
+  "mosaic"
 ];
 var OWNER_TYPES = new Set(MEDIA_OWNER_TYPES);
 var EVENT_OWNER_TYPES = [
@@ -15407,6 +15408,7 @@ var EVENT_OWNER_TYPES = [
   "object",
   "audio"
 ];
+var EventOwnerTypeSchema = external_exports.enum(EVENT_OWNER_TYPES);
 var EVENT_OWNER_TYPE_SET = new Set(EVENT_OWNER_TYPES);
 var VideoEncodeSchema = external_exports.object({
   codec: external_exports.enum([
@@ -20006,6 +20008,60 @@ var settingsStoreCapability = {
       filter: QueryFilterSchema.optional(),
       columns: external_exports.array(external_exports.string()).readonly().optional()
     }), external_exports.array(SettingsRecordSchema).readonly()),
+    /**
+    * 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.
+    */
+    upsert: method(external_exports.object({
+      namespace: external_exports.string().optional(),
+      collection: external_exports.string(),
+      /** Declared columns identifying the slot; must be covered by a UNIQUE
+      *  index on the collection. Never empty. */
+      conflict: external_exports.array(external_exports.string()).readonly(),
+      record: BulkRecordSchema
+    }), external_exports.object({
+      /** The id the row HAS: assigned by SQLite on an insert, or the existing
+      *  row's own id on an update. */
+      id: external_exports.union([external_exports.string(), external_exports.number()])
+    }), { kind: "mutation" }),
     /** Insert a new record. */
     insert: method(external_exports.object({
       namespace: external_exports.string().optional(),
@@ -20249,6 +20305,20 @@ var dataStoreProviderCapability = {
       kind: "mutation",
       auth: "admin"
     }),
+    /**
+    * 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).
+    */
+    upsert: method(external_exports.object({
+      namespace: external_exports.string().optional(),
+      collection: external_exports.string(),
+      conflict: external_exports.array(external_exports.string()).readonly(),
+      record: BulkRecordSchema
+    }), external_exports.object({ id: external_exports.union([external_exports.string(), external_exports.number()]) }), {
+      kind: "mutation",
+      auth: "admin"
+    }),
     /** Insert many records in ONE transaction. All or nothing. */
     insertMany: method(external_exports.object({
       namespace: external_exports.string().optional(),
@@ -26551,8 +26621,8 @@ var TrackPositionSchema = external_exports.object({
 var TrackSnapshotSchema = external_exports.object({
   timestamp: external_exports.number(),
   position: TrackPositionSchema,
-  /** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
-  mediaKey: external_exports.string()
+  /** The snapshot's media row id (D482); resolve via `listTrackMedia({ trackId })`. */
+  mediaId: external_exports.number().int()
 });
 var TrackEnvelopeSchema = external_exports.object({
   minX: external_exports.number(),
@@ -26991,14 +27061,14 @@ var ObjectEventSchema = external_exports.object({
   *  pixel-space `bbox` onto a displayed image. Omitted in slim projection. */
   frameWidth: external_exports.number().optional(),
   frameHeight: external_exports.number().optional(),
-  /** MediaStore key for the crop attached to this event (if any). */
-  mediaKey: external_exports.string().optional(),
-  /** Design B: MediaStore key of the track's native-resolution key frame (the
+  /** Media row id of the crop attached to this event (if any) — D482. */
+  mediaId: external_exports.number().int().optional(),
+  /** Design B: media row id of the track's native-resolution key frame (the
   *  best-detection full frame). Resolve via the event-media data-plane
-  *  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`) for a detail view that
+  *  (`/addon/<addonId>/event-media/m/<keyFrameMediaId>`) for a detail view that
   *  draws `bbox` over the native frame. Absent on legacy rows / non-decoded
-  *  sources — consumers fall back to `mediaKey` (the tight crop). */
-  keyFrameMediaKey: external_exports.string().optional(),
+  *  sources — consumers fall back to `mediaId` (the tight crop). */
+  keyFrameMediaId: external_exports.number().int().optional(),
   /** Populated by B5 (recording playback URL for this event). */
   mediaUrl: external_exports.string().optional(),
   /** The parent track's key-event importance [0,1], propagated to every object
@@ -27035,7 +27105,19 @@ var MediaFileKindEnum = external_exports.enum([
   "sceneFrame"
 ]);
 var MediaFileRefSchema = external_exports.object({
-  key: external_exports.string(),
+  /**
+  * The media row's OWN id — the rowid SQLite assigned it (D482).
+  *
+  * It used to be the row's composite key, `<ownerType>:<ownerId>:<fileKind>
+  * [:<timestampMs>]`, which embedded a FOREIGN id. D474 made event ids
+  * per-table rowid aliases, so `object:101314` and `motion:101314` are two
+  * different rows that spell the same number, and a track whose
+  * `bestEventId` was an object event was served a motion event's snapshot —
+  * a night-time thumbnail on an afternoon track, with no error anywhere. A
+  * surrogate id cannot name the wrong row's owner, because it names no owner
+  * at all.
+  */
+  mediaId: external_exports.number().int(),
   kind: MediaFileKindEnum,
   sizeBytes: external_exports.number(),
   timestamp: external_exports.number()
@@ -27103,7 +27185,7 @@ var RetrainTrackSchema = external_exports.object({
   annotationCount: external_exports.number().int()
 });
 var RetrainFrameCandidateSchema = external_exports.object({
-  mediaKey: external_exports.string(),
+  mediaId: external_exports.number().int(),
   kind: MediaFileKindEnum,
   timestamp: external_exports.number(),
   sizeBytes: external_exports.number().int(),
@@ -27116,7 +27198,7 @@ var RetrainFrameSchema = external_exports.object({
   deviceId: external_exports.number(),
   trackId: external_exports.string(),
   /** Provenance only. It may already point at nothing — that is expected. */
-  sourceMediaKey: external_exports.string(),
+  sourceMediaId: external_exports.number().int(),
   sourceKind: MediaFileKindEnum,
   sizeBytes: external_exports.number().int(),
   width: external_exports.number().int(),
@@ -27131,7 +27213,7 @@ var RetrainCopyRefusalSchema = external_exports.enum([
 var RetrainFrameSelectionSchema = external_exports.object({
   copied: external_exports.array(RetrainFrameSchema).readonly(),
   refused: external_exports.array(external_exports.object({
-    sourceMediaKey: external_exports.string(),
+    sourceMediaId: external_exports.number().int(),
     reason: RetrainCopyRefusalSchema
   })).readonly()
 });
@@ -27139,7 +27221,7 @@ var RetrainFrameListSchema = external_exports.object({
   candidates: external_exports.array(RetrainFrameCandidateSchema).readonly(),
   copies: external_exports.array(RetrainFrameSchema).readonly(),
   /** What the page pre-selects — the native key frame when one survives. */
-  autoPickMediaKey: external_exports.string().optional()
+  autoPickMediaId: external_exports.number().int().optional()
 });
 var RetrainAssistSubjectSchema = external_exports.discriminatedUnion("kind", [external_exports.object({
   kind: external_exports.literal("package"),
@@ -27232,7 +27314,7 @@ var SummarySchema = external_exports.object({
   lastActiveAt: external_exports.number(),
   sealedAt: external_exports.number().nullable(),
   memberCount: external_exports.number().int().nonnegative(),
-  groupShotKey: external_exports.string().nullable()
+  groupShotMediaId: external_exports.number().int().nullable()
 });
 var SummariesQueryInput = external_exports.object({
   deviceIds: external_exports.array(external_exports.number()).min(1),
@@ -28125,7 +28207,7 @@ var pipelineAnalyticsCapability = {
     selectRetrainFrames: method(external_exports.object({
       deviceId: external_exports.number(),
       trackId: external_exports.string(),
-      mediaKeys: external_exports.array(external_exports.string()).min(1)
+      mediaIds: external_exports.array(external_exports.number().int()).min(1)
     }), RetrainFrameSelectionSchema, {
       kind: "mutation",
       auth: "admin"
@@ -28289,8 +28371,29 @@ var pipelineAnalyticsCapability = {
       kind: "query",
       auth: "admin"
     }),
+    /**
+    * 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.
+    */
     getEventMedia: method(external_exports.object({
-      eventId: external_exports.string(),
+      /** Which of the three event tables owns the row. */
+      ownerType: EventOwnerTypeSchema,
+      /** The event's rowid in that table (D474: an event id is a number). */
+      eventId: external_exports.number().int(),
       kind: MediaFileKindEnum.optional(),
       deviceId: external_exports.number()
     }), external_exports.array(MediaFileSchema).readonly()),
@@ -28335,11 +28438,14 @@ var 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.
     */
     listEventMedia: method(external_exports.object({
-      eventId: external_exports.string(),
+      ownerType: EventOwnerTypeSchema,
+      eventId: external_exports.number().int(),
       deviceId: external_exports.number()
     }), external_exports.array(MediaFileInfoSchema).readonly()),
     /**
@@ -34018,8 +34124,8 @@ var IdentitySchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
   sampleCount: external_exports.number().int().nonnegative(),
-  coverMediaKey: external_exports.string().optional(),
-  /** Inline base64 of the cover sample's crop, resolved from `coverMediaKey`.
+  coverMediaId: external_exports.number().int().optional(),
+  /** Inline base64 of the cover sample's crop, resolved from `coverMediaId`.
   *  Lets the UI render the person's face avatar instead of a placeholder icon. */
   coverBase64: external_exports.string().optional()
 });
@@ -34035,8 +34141,8 @@ var IdentitySampleAuditRowSchema = external_exports.object({
   enrolledAt: external_exports.number().int(),
   deviceId: external_exports.number().int().optional(),
   source: external_exports.enum(["detected", "photo"]),
-  /** The enrolled crop's media key, so the panel can show the evidence. */
-  mediaKey: external_exports.string().optional(),
+  /** The enrolled crop's media row id, so the panel can show the evidence. */
+  mediaId: external_exports.number().int().optional(),
   /**
   * False = the sample is stamped with a DIFFERENT face model, and a cosine
   * across feature spaces is a well-formed float with no meaning. Every number
@@ -34105,15 +34211,15 @@ var FaceInfoSchema = external_exports.object({
   */
   cropUrl: external_exports.string().optional(),
   /** Design B: the face bbox (pixel space) on the key frame — lets a detail
-  *  view draw the box over the native `keyFrameMediaKey` frame. Absent on
+  *  view draw the box over the native `keyFrameMediaId` frame. Absent on
   *  legacy rows written before design B. */
   faceBbox: BoundingBoxSchema.optional(),
   /** Design B: MediaStore key of the track's native-resolution key frame.
   *  Fetch the native JPEG via the event-media data-plane
-  *  (`/addon/<addonId>/event-media/<keyFrameMediaKey>`). Absent when the
+  *  (`/addon/<addonId>/event-media/m/<keyFrameMediaId>`). Absent when the
   *  track produced no key frame (e.g. native/onboard source) — the UI falls
   *  back to the inline `base64` face crop. */
-  keyFrameMediaKey: external_exports.string().optional(),
+  keyFrameMediaId: external_exports.number().int().optional(),
   /** Winning identity-match cosine (0..1) for this face's track, when an
   *  identity was auto-confirmed. Lets the UI surface WHY a face was assigned
   *  (confidence badge / low-confidence audit). Absent on legacy rows and on
@@ -34151,7 +34257,9 @@ var FaceClusterSchema = external_exports.object({
   cohesion: external_exports.number()
 });
 var MediaFileLiteSchema$1 = external_exports.object({
-  key: external_exports.string(),
+  /** The media row's own id — the same address `MediaFileRef.mediaId` carries
+  *  (D482). It was the row's composite key, which embedded the owner. */
+  mediaId: external_exports.number().int(),
   kind: external_exports.string(),
   url: external_exports.string(),
   sizeBytes: external_exports.number(),
@@ -34173,7 +34281,7 @@ var faceGalleryCapability = {
       * covers inline, ~10 KB of base64 per row, on a query this UI mounts
       * four times and the viewer holds at `staleTime: 30_000`.
       *
-      * Nothing loses its avatar: `coverMediaKey` is already on every row and
+      * Nothing loses its avatar: `coverMediaId` is already on every row and
       * the `event-media` plane serves that key `immutable` with an ETag.
       *
       * **This is an INPUT field, so it does not reach the addon until the
@@ -37303,8 +37411,8 @@ var VehicleSchema = external_exports.object({
   id: external_exports.string(),
   name: external_exports.string(),
   sampleCount: external_exports.number().int().nonnegative(),
-  coverMediaKey: external_exports.string().optional(),
-  /** Inline base64 of the cover sample's plate crop, resolved from `coverMediaKey`. */
+  coverMediaId: external_exports.number().int().optional(),
+  /** Inline base64 of the cover sample's plate crop, resolved from `coverMediaId`. */
   coverBase64: external_exports.string().optional()
 });
 var VehicleSampleInfoSchema = external_exports.object({
@@ -37337,7 +37445,7 @@ var PlateInfoSchema = external_exports.object({
   /** keyFrame parity: the plate bbox (pixel space) on the native key frame. */
   plateBbox: BoundingBoxSchema.optional(),
   /** keyFrame parity: MediaStore key of the track's native-resolution key frame. */
-  keyFrameMediaKey: external_exports.string().optional(),
+  keyFrameMediaId: external_exports.number().int().optional(),
   base64: external_exports.string().optional(),
   /**
   * Same crop as a data-plane URL, always present when the plate has a stored
@@ -37348,7 +37456,9 @@ var PlateInfoSchema = external_exports.object({
   cropUrl: external_exports.string().optional()
 });
 var MediaFileLiteSchema = external_exports.object({
-  key: external_exports.string(),
+  /** The media row's own id — the same address `MediaFileRef.mediaId` carries
+  *  (D482). It was the row's composite key, which embedded the owner. */
+  mediaId: external_exports.number().int(),
   kind: external_exports.string(),
   url: external_exports.string(),
   sizeBytes: external_exports.number(),
@@ -37422,7 +37532,7 @@ var plateGalleryCapability = {
     listVehicles: method(external_exports.object({
       /** Inline {@link VehicleSchema.coverBase64} on every row. Default
       *  `false` — the vehicle twin of `faceGallery.listIdentities`'s
-      *  option; `coverMediaKey` + the `event-media` plane carry the picture.
+      *  option; `coverMediaId` + the `event-media` plane carry the picture.
       *  INPUT field: stripped by the hub router until the train ships, which
       *  resolves to `false` and is exactly the intended default. */
       includeCrops: external_exports.boolean().optional()
@@ -38920,7 +39030,14 @@ var SceneReferenceSchema = external_exports.object({
   modelId: external_exports.string(),
   condition: SceneConditionSchema,
   capturedAt: external_exports.number(),
-  thumbnailMediaId: external_exports.string().optional(),
+  /**
+  * The reference thumbnail's media ROW id (D482).
+  *
+  * The name already said `mediaId` while the value was the row's composite
+  * key — a leftover that read as done and was not. It is the row's own id
+  * now, addressed at `/addon/<addonId>/event-media/m/<id>`.
+  */
+  thumbnailMediaId: external_exports.number().int().optional(),
   /** Whole-frame (downscaled) embedding captured alongside the ROI crop. The
   *  anti-view-shift anchor: a bumped camera, a PTZ preset or a re-aim makes the
   *  normalized rect frame a different piece of world, and the scene would
@@ -40612,7 +40729,7 @@ var StationaryObjectSchema = external_exports.object({
   /** Enrichment label carried from the source track (identity / plate). */
   label: external_exports.string().optional(),
   /** Native-resolution key-frame media key for the parked object's best image. */
-  keyFrameMediaKey: external_exports.string().optional()
+  keyFrameMediaId: external_exports.number().int().optional()
 });
 var CameraOccupancySnapshotSchema = external_exports.object({
   /** Frame timestamp of the inference result that produced this snapshot. */
@@ -41876,6 +41993,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "dataStoreProvider.upsert": {
+    capName: "data-store-provider",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "dayNight.getOptions": {
     capName: "day-night",
     capScope: "device",
@@ -45740,6 +45863,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "create"
   },
+  "settingsStore.upsert": {
+    capName: "settings-store",
+    capScope: "system",
+    addonId: null,
+    access: "create"
+  },
   "smtpProvider.getStatus": {
     capName: "smtp-provider",
     capScope: "system",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-E3UKNBI7.js";
+} from "./chunk-W67ATFOA.js";
 import "./chunk-LMMQX4CK.js";
 
 // src/cli.ts
@@ -38,7 +38,7 @@ async function runServe(args) {
     ...typeof values.data === "string" ? { data: values.data } : {}
   };
   Object.assign(process.env, buildServeEnv(opts));
-  await import("./launcher-3ULE3QVN.js");
+  await import("./launcher-LICFWRGL.js");
 }
 
 // src/commands/agent.ts
@@ -83,7 +83,7 @@ async function runAgent(args) {
     ...typeof values.port === "string" ? { port: values.port } : {}
   };
   Object.assign(process.env, buildAgentEnv(opts));
-  await import("./launcher-3ULE3QVN.js");
+  await import("./launcher-LICFWRGL.js");
 }
 
 // src/commands/setup.ts
@@ -1140,7 +1140,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-YH7C75RI.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-CPDHVQWB.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-YH7C75RI.js → discover-CPDHVQWB.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-E3UKNBI7.js";
+} from "./chunk-W67ATFOA.js";
 import "./chunk-LMMQX4CK.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,