@camstack/addon-matter-broker 0.2.97 → 0.2.99

package/dist/addon.js

@@ -13,7 +13,7 @@ let node_stream_promises = require("node:stream/promises");
 let node_net = require("node:net");
 let node_dgram = require("node:dgram");
 node_dgram = require_esm.__toESM(node_dgram, 1);
-//#region ../types/dist/event-category-DAXzJeTX.mjs
+//#region ../types/dist/event-category-ZyX6jcse.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -574,7 +574,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.
@@ -5360,7 +5360,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BnujYGPe.mjs
+//#region ../types/dist/sleep-CnLyvg3w.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7327,13 +7327,30 @@ new Set([
 	"scene",
 	"motion",
 	"object",
-	"audio"
+	"audio",
+	"mosaic"
 ]);
-new Set([
+/**
+* The owner types that are event tables, in the order the event-media resolver
+* should consider them. Exported so a consumer asking "is this key an event?"
+* does not re-spell the list and drift from it.
+*/
+var EVENT_OWNER_TYPES = [
 	"motion",
 	"object",
 	"audio"
-]);
+];
+/**
+* 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.
+*/
+var EventOwnerTypeSchema = _enum(EVENT_OWNER_TYPES);
+new Set(EVENT_OWNER_TYPES);
 var EncodeProfileSchema = object({
 	video: object({
 		codec: _enum([
@@ -12581,6 +12598,16 @@ method(object({
 	filter: QueryFilterSchema.optional(),
 	columns: array(string$2()).readonly().optional()
 }), array(SettingsRecordSchema).readonly()), method(object({
+	namespace: string$2().optional(),
+	collection: string$2(),
+	/** Declared columns identifying the slot; must be covered by a UNIQUE
+	*  index on the collection. Never empty. */
+	conflict: array(string$2()).readonly(),
+	record: BulkRecordSchema
+}), object({ 
+/** The id the row HAS: assigned by SQLite on an insert, or the existing
+*  row's own id on an update. */
+id: union([string$2(), number()]) }), { kind: "mutation" }), method(object({
 	namespace: string$2().optional(),
 	collection: string$2(),
 	record: object({
@@ -12715,6 +12742,14 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
 id: union([string$2(), number()]) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	namespace: string$2().optional(),
+	collection: string$2(),
+	conflict: array(string$2()).readonly(),
+	record: BulkRecordSchema
+}), object({ id: union([string$2(), number()]) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	namespace: string$2().optional(),
 	collection: string$2(),
@@ -19214,8 +19249,8 @@ var TrackPositionSchema = object({
 var TrackSnapshotSchema = object({
 	timestamp: number(),
 	position: TrackPositionSchema,
-	/** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
-	mediaKey: string$2()
+	/** The snapshot's media row id (D482); resolve via `listTrackMedia({ trackId })`. */
+	mediaId: number().int()
 });
 /**
 * Normalized 0..1 trajectory envelope (min/max over every position bbox,
@@ -19819,14 +19854,14 @@ var ObjectEventSchema = object({
 	*  pixel-space `bbox` onto a displayed image. Omitted in slim projection. */
 	frameWidth: number().optional(),
 	frameHeight: number().optional(),
-	/** MediaStore key for the crop attached to this event (if any). */
-	mediaKey: string$2().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: 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: string$2().optional(),
+	*  sources — consumers fall back to `mediaId` (the tight crop). */
+	keyFrameMediaId: number().int().optional(),
 	/** Populated by B5 (recording playback URL for this event). */
 	mediaUrl: string$2().optional(),
 	/** The parent track's key-event importance [0,1], propagated to every object
@@ -19876,7 +19911,7 @@ var MediaFileKindEnum = _enum([
 * 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
@@ -19884,10 +19919,13 @@ var MediaFileKindEnum = _enum([
 * `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
 *
@@ -19900,7 +19938,19 @@ var MediaFileKindEnum = _enum([
 * `analytics-query-facade.ts`; nothing else reads it.
 */
 var MediaFileSchema = object({
-	key: string$2(),
+	/**
+	* 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: number().int(),
 	kind: MediaFileKindEnum,
 	sizeBytes: number(),
 	timestamp: number()
@@ -20008,7 +20058,7 @@ var RetrainTrackSchema = object({
 });
 /** A frame the picker may offer — an index row, no blob was read to produce it. */
 var RetrainFrameCandidateSchema = object({
-	mediaKey: string$2(),
+	mediaId: number().int(),
 	kind: MediaFileKindEnum,
 	timestamp: number(),
 	sizeBytes: number().int(),
@@ -20022,7 +20072,7 @@ var RetrainFrameSchema = object({
 	deviceId: number(),
 	trackId: string$2(),
 	/** Provenance only. It may already point at nothing — that is expected. */
-	sourceMediaKey: string$2(),
+	sourceMediaId: number().int(),
 	sourceKind: MediaFileKindEnum,
 	sizeBytes: number().int(),
 	width: number().int(),
@@ -20038,7 +20088,7 @@ var RetrainCopyRefusalSchema = _enum([
 var RetrainFrameSelectionSchema = object({
 	copied: array(RetrainFrameSchema).readonly(),
 	refused: array(object({
-		sourceMediaKey: string$2(),
+		sourceMediaId: number().int(),
 		reason: RetrainCopyRefusalSchema
 	})).readonly()
 });
@@ -20046,7 +20096,7 @@ var RetrainFrameListSchema = object({
 	candidates: array(RetrainFrameCandidateSchema).readonly(),
 	copies: array(RetrainFrameSchema).readonly(),
 	/** What the page pre-selects — the native key frame when one survives. */
-	autoPickMediaKey: string$2().optional()
+	autoPickMediaId: number().int().optional()
 });
 /** What the operator asked the assist to look for. */
 var RetrainAssistSubjectSchema = discriminatedUnion("kind", [object({
@@ -20141,9 +20191,11 @@ var RecentTracksQueryInput = object({
 });
 /**
 * 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).
 */
 var SummarySchema = object({
 	id: string$2(),
@@ -20152,7 +20204,7 @@ var SummarySchema = object({
 	lastActiveAt: number(),
 	sealedAt: number().nullable(),
 	memberCount: number().int().nonnegative(),
-	groupShotKey: string$2().nullable()
+	groupShotMediaId: number().int().nullable()
 });
 var SummariesQueryInput = object({
 	deviceIds: array(number()).min(1),
@@ -20706,7 +20758,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 }), method(object({
 	deviceId: number(),
 	trackId: string$2(),
-	mediaKeys: array(string$2()).min(1)
+	mediaIds: array(number().int()).min(1)
 }), RetrainFrameSelectionSchema, {
 	kind: "mutation",
 	auth: "admin"
@@ -20774,7 +20826,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	kind: "query",
 	auth: "admin"
 }), method(object({
-	eventId: string$2(),
+	/** 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: number().int(),
 	kind: MediaFileKindEnum.optional(),
 	deviceId: number()
 }), array(MediaFileSchema).readonly()), method(object({
@@ -20785,7 +20840,8 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	trackId: string$2(),
 	deviceId: number()
 }), array(MediaFileInfoSchema).readonly()), method(object({
-	eventId: string$2(),
+	ownerType: EventOwnerTypeSchema,
+	eventId: number().int(),
 	deviceId: number()
 }), array(MediaFileInfoSchema).readonly()), method(SearchObjectEventsInput, array(ScoredObjectEventSchema).readonly()), method(object({}), WipeObjectEmbeddingsResultSchema, {
 	kind: "mutation",
@@ -25995,8 +26051,8 @@ var IdentitySchema = object({
 	id: string$2(),
 	name: string$2(),
 	sampleCount: number().int().nonnegative(),
-	coverMediaKey: string$2().optional(),
-	/** Inline base64 of the cover sample's crop, resolved from `coverMediaKey`.
+	coverMediaId: 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: string$2().optional()
 });
@@ -26022,8 +26078,8 @@ var IdentitySampleAuditRowSchema = object({
 	enrolledAt: number().int(),
 	deviceId: number().int().optional(),
 	source: _enum(["detected", "photo"]),
-	/** The enrolled crop's media key, so the panel can show the evidence. */
-	mediaKey: string$2().optional(),
+	/** The enrolled crop's media row id, so the panel can show the evidence. */
+	mediaId: 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
@@ -26092,15 +26148,15 @@ var FaceInfoSchema = object({
 	*/
 	cropUrl: string$2().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: string$2().optional(),
+	keyFrameMediaId: 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
@@ -26169,11 +26225,14 @@ var FaceClusterSchema = object({
 * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
 * dialog already rendering its key FRAME from the `event-media` plane.
 *
-* `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
-* media key directly, so this needed no new plane and no new access decision.
+* `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
+* resolves a media row by its own id, so this needed no new plane and no new
+* access decision.
 */
 var MediaFileLiteSchema$1 = object({
-	key: string$2(),
+	/** 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: number().int(),
 	kind: string$2(),
 	url: string$2(),
 	sizeBytes: number(),
@@ -26190,7 +26249,7 @@ method(object({
 * 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
@@ -29553,8 +29612,8 @@ var VehicleSchema = object({
 	id: string$2(),
 	name: string$2(),
 	sampleCount: number().int().nonnegative(),
-	coverMediaKey: string$2().optional(),
-	/** Inline base64 of the cover sample's plate crop, resolved from `coverMediaKey`. */
+	coverMediaId: number().int().optional(),
+	/** Inline base64 of the cover sample's plate crop, resolved from `coverMediaId`. */
 	coverBase64: string$2().optional()
 });
 var VehicleSampleInfoSchema = object({
@@ -29587,7 +29646,7 @@ var PlateInfoSchema = 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: string$2().optional(),
+	keyFrameMediaId: number().int().optional(),
 	base64: string$2().optional(),
 	/**
 	* Same crop as a data-plane URL, always present when the plate has a stored
@@ -29608,11 +29667,14 @@ var PlateInfoSchema = object({
 * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
 * dialog already rendering its key FRAME from the `event-media` plane.
 *
-* `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
-* media key directly, so this needed no new plane and no new access decision.
+* `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
+* resolves a media row by its own id, so this needed no new plane and no new
+* access decision.
 */
 var MediaFileLiteSchema = object({
-	key: string$2(),
+	/** 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: number().int(),
 	kind: string$2(),
 	url: string$2(),
 	sizeBytes: number(),
@@ -29671,7 +29733,7 @@ method(object({
 }), method(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: boolean().optional() }).optional(), array(VehicleSchema).readonly()), method(object({ name: string$2().min(1) }), VehicleSchema, {
@@ -31240,7 +31302,14 @@ var SceneReferenceSchema = object({
 	modelId: string$2(),
 	condition: SceneConditionSchema,
 	capturedAt: number(),
-	thumbnailMediaId: string$2().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: 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
@@ -33224,7 +33293,7 @@ var StationaryObjectSchema = object({
 	/** Enrichment label carried from the source track (identity / plate). */
 	label: string$2().optional(),
 	/** Native-resolution key-frame media key for the parked object's best image. */
-	keyFrameMediaKey: string$2().optional()
+	keyFrameMediaId: number().int().optional()
 });
 var CameraOccupancySnapshotSchema = object({
 	/** Frame timestamp of the inference result that produced this snapshot. */
@@ -35962,6 +36031,12 @@ 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",
@@ -39826,6 +39901,12 @@ 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/addon.mjs

@@ -11,7 +11,7 @@ import { networkInterfaces, tmpdir, uptime } from "node:os";
 import { finished } from "node:stream/promises";
 import { createConnection, createServer as createServer$2 } from "node:net";
 import * as dgram from "node:dgram";
-//#region ../types/dist/event-category-DAXzJeTX.mjs
+//#region ../types/dist/event-category-ZyX6jcse.mjs
 var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	EventCategory["SystemBoot"] = "system.boot";
 	EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -572,7 +572,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.
@@ -5358,7 +5358,7 @@ var ZodIssueCode = {
 var ZodFirstPartyTypeKind;
 ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
 //#endregion
-//#region ../types/dist/sleep-BnujYGPe.mjs
+//#region ../types/dist/sleep-CnLyvg3w.mjs
 /**
 * The audio chunk plane's byte format, and the ONE expansion from a coded
 * window to float samples (D455).
@@ -7325,13 +7325,30 @@ new Set([
 	"scene",
 	"motion",
 	"object",
-	"audio"
+	"audio",
+	"mosaic"
 ]);
-new Set([
+/**
+* The owner types that are event tables, in the order the event-media resolver
+* should consider them. Exported so a consumer asking "is this key an event?"
+* does not re-spell the list and drift from it.
+*/
+var EVENT_OWNER_TYPES = [
 	"motion",
 	"object",
 	"audio"
-]);
+];
+/**
+* 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.
+*/
+var EventOwnerTypeSchema = _enum(EVENT_OWNER_TYPES);
+new Set(EVENT_OWNER_TYPES);
 var EncodeProfileSchema = object({
 	video: object({
 		codec: _enum([
@@ -12579,6 +12596,16 @@ method(object({
 	filter: QueryFilterSchema.optional(),
 	columns: array(string$2()).readonly().optional()
 }), array(SettingsRecordSchema).readonly()), method(object({
+	namespace: string$2().optional(),
+	collection: string$2(),
+	/** Declared columns identifying the slot; must be covered by a UNIQUE
+	*  index on the collection. Never empty. */
+	conflict: array(string$2()).readonly(),
+	record: BulkRecordSchema
+}), object({ 
+/** The id the row HAS: assigned by SQLite on an insert, or the existing
+*  row's own id on an update. */
+id: union([string$2(), number()]) }), { kind: "mutation" }), method(object({
 	namespace: string$2().optional(),
 	collection: string$2(),
 	record: object({
@@ -12713,6 +12740,14 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
 id: union([string$2(), number()]) }), {
 	kind: "mutation",
 	auth: "admin"
+}), method(object({
+	namespace: string$2().optional(),
+	collection: string$2(),
+	conflict: array(string$2()).readonly(),
+	record: BulkRecordSchema
+}), object({ id: union([string$2(), number()]) }), {
+	kind: "mutation",
+	auth: "admin"
 }), method(object({
 	namespace: string$2().optional(),
 	collection: string$2(),
@@ -19212,8 +19247,8 @@ var TrackPositionSchema = object({
 var TrackSnapshotSchema = object({
 	timestamp: number(),
 	position: TrackPositionSchema,
-	/** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
-	mediaKey: string$2()
+	/** The snapshot's media row id (D482); resolve via `listTrackMedia({ trackId })`. */
+	mediaId: number().int()
 });
 /**
 * Normalized 0..1 trajectory envelope (min/max over every position bbox,
@@ -19817,14 +19852,14 @@ var ObjectEventSchema = object({
 	*  pixel-space `bbox` onto a displayed image. Omitted in slim projection. */
 	frameWidth: number().optional(),
 	frameHeight: number().optional(),
-	/** MediaStore key for the crop attached to this event (if any). */
-	mediaKey: string$2().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: 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: string$2().optional(),
+	*  sources — consumers fall back to `mediaId` (the tight crop). */
+	keyFrameMediaId: number().int().optional(),
 	/** Populated by B5 (recording playback URL for this event). */
 	mediaUrl: string$2().optional(),
 	/** The parent track's key-event importance [0,1], propagated to every object
@@ -19874,7 +19909,7 @@ var MediaFileKindEnum = _enum([
 * 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
@@ -19882,10 +19917,13 @@ var MediaFileKindEnum = _enum([
 * `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
 *
@@ -19898,7 +19936,19 @@ var MediaFileKindEnum = _enum([
 * `analytics-query-facade.ts`; nothing else reads it.
 */
 var MediaFileSchema = object({
-	key: string$2(),
+	/**
+	* 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: number().int(),
 	kind: MediaFileKindEnum,
 	sizeBytes: number(),
 	timestamp: number()
@@ -20006,7 +20056,7 @@ var RetrainTrackSchema = object({
 });
 /** A frame the picker may offer — an index row, no blob was read to produce it. */
 var RetrainFrameCandidateSchema = object({
-	mediaKey: string$2(),
+	mediaId: number().int(),
 	kind: MediaFileKindEnum,
 	timestamp: number(),
 	sizeBytes: number().int(),
@@ -20020,7 +20070,7 @@ var RetrainFrameSchema = object({
 	deviceId: number(),
 	trackId: string$2(),
 	/** Provenance only. It may already point at nothing — that is expected. */
-	sourceMediaKey: string$2(),
+	sourceMediaId: number().int(),
 	sourceKind: MediaFileKindEnum,
 	sizeBytes: number().int(),
 	width: number().int(),
@@ -20036,7 +20086,7 @@ var RetrainCopyRefusalSchema = _enum([
 var RetrainFrameSelectionSchema = object({
 	copied: array(RetrainFrameSchema).readonly(),
 	refused: array(object({
-		sourceMediaKey: string$2(),
+		sourceMediaId: number().int(),
 		reason: RetrainCopyRefusalSchema
 	})).readonly()
 });
@@ -20044,7 +20094,7 @@ var RetrainFrameListSchema = object({
 	candidates: array(RetrainFrameCandidateSchema).readonly(),
 	copies: array(RetrainFrameSchema).readonly(),
 	/** What the page pre-selects — the native key frame when one survives. */
-	autoPickMediaKey: string$2().optional()
+	autoPickMediaId: number().int().optional()
 });
 /** What the operator asked the assist to look for. */
 var RetrainAssistSubjectSchema = discriminatedUnion("kind", [object({
@@ -20139,9 +20189,11 @@ var RecentTracksQueryInput = object({
 });
 /**
 * 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).
 */
 var SummarySchema = object({
 	id: string$2(),
@@ -20150,7 +20202,7 @@ var SummarySchema = object({
 	lastActiveAt: number(),
 	sealedAt: number().nullable(),
 	memberCount: number().int().nonnegative(),
-	groupShotKey: string$2().nullable()
+	groupShotMediaId: number().int().nullable()
 });
 var SummariesQueryInput = object({
 	deviceIds: array(number()).min(1),
@@ -20704,7 +20756,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 }), method(object({
 	deviceId: number(),
 	trackId: string$2(),
-	mediaKeys: array(string$2()).min(1)
+	mediaIds: array(number().int()).min(1)
 }), RetrainFrameSelectionSchema, {
 	kind: "mutation",
 	auth: "admin"
@@ -20772,7 +20824,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	kind: "query",
 	auth: "admin"
 }), method(object({
-	eventId: string$2(),
+	/** 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: number().int(),
 	kind: MediaFileKindEnum.optional(),
 	deviceId: number()
 }), array(MediaFileSchema).readonly()), method(object({
@@ -20783,7 +20838,8 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
 	trackId: string$2(),
 	deviceId: number()
 }), array(MediaFileInfoSchema).readonly()), method(object({
-	eventId: string$2(),
+	ownerType: EventOwnerTypeSchema,
+	eventId: number().int(),
 	deviceId: number()
 }), array(MediaFileInfoSchema).readonly()), method(SearchObjectEventsInput, array(ScoredObjectEventSchema).readonly()), method(object({}), WipeObjectEmbeddingsResultSchema, {
 	kind: "mutation",
@@ -25993,8 +26049,8 @@ var IdentitySchema = object({
 	id: string$2(),
 	name: string$2(),
 	sampleCount: number().int().nonnegative(),
-	coverMediaKey: string$2().optional(),
-	/** Inline base64 of the cover sample's crop, resolved from `coverMediaKey`.
+	coverMediaId: 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: string$2().optional()
 });
@@ -26020,8 +26076,8 @@ var IdentitySampleAuditRowSchema = object({
 	enrolledAt: number().int(),
 	deviceId: number().int().optional(),
 	source: _enum(["detected", "photo"]),
-	/** The enrolled crop's media key, so the panel can show the evidence. */
-	mediaKey: string$2().optional(),
+	/** The enrolled crop's media row id, so the panel can show the evidence. */
+	mediaId: 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
@@ -26090,15 +26146,15 @@ var FaceInfoSchema = object({
 	*/
 	cropUrl: string$2().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: string$2().optional(),
+	keyFrameMediaId: 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
@@ -26167,11 +26223,14 @@ var FaceClusterSchema = object({
 * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
 * dialog already rendering its key FRAME from the `event-media` plane.
 *
-* `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
-* media key directly, so this needed no new plane and no new access decision.
+* `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
+* resolves a media row by its own id, so this needed no new plane and no new
+* access decision.
 */
 var MediaFileLiteSchema$1 = object({
-	key: string$2(),
+	/** 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: number().int(),
 	kind: string$2(),
 	url: string$2(),
 	sizeBytes: number(),
@@ -26188,7 +26247,7 @@ method(object({
 * 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
@@ -29551,8 +29610,8 @@ var VehicleSchema = object({
 	id: string$2(),
 	name: string$2(),
 	sampleCount: number().int().nonnegative(),
-	coverMediaKey: string$2().optional(),
-	/** Inline base64 of the cover sample's plate crop, resolved from `coverMediaKey`. */
+	coverMediaId: number().int().optional(),
+	/** Inline base64 of the cover sample's plate crop, resolved from `coverMediaId`. */
 	coverBase64: string$2().optional()
 });
 var VehicleSampleInfoSchema = object({
@@ -29585,7 +29644,7 @@ var PlateInfoSchema = 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: string$2().optional(),
+	keyFrameMediaId: number().int().optional(),
 	base64: string$2().optional(),
 	/**
 	* Same crop as a data-plane URL, always present when the plate has a stored
@@ -29606,11 +29665,14 @@ var PlateInfoSchema = object({
 * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
 * dialog already rendering its key FRAME from the `event-media` plane.
 *
-* `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
-* media key directly, so this needed no new plane and no new access decision.
+* `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
+* resolves a media row by its own id, so this needed no new plane and no new
+* access decision.
 */
 var MediaFileLiteSchema = object({
-	key: string$2(),
+	/** 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: number().int(),
 	kind: string$2(),
 	url: string$2(),
 	sizeBytes: number(),
@@ -29669,7 +29731,7 @@ method(object({
 }), method(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: boolean().optional() }).optional(), array(VehicleSchema).readonly()), method(object({ name: string$2().min(1) }), VehicleSchema, {
@@ -31238,7 +31300,14 @@ var SceneReferenceSchema = object({
 	modelId: string$2(),
 	condition: SceneConditionSchema,
 	capturedAt: number(),
-	thumbnailMediaId: string$2().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: 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
@@ -33222,7 +33291,7 @@ var StationaryObjectSchema = object({
 	/** Enrichment label carried from the source track (identity / plate). */
 	label: string$2().optional(),
 	/** Native-resolution key-frame media key for the parked object's best image. */
-	keyFrameMediaKey: string$2().optional()
+	keyFrameMediaId: number().int().optional()
 });
 var CameraOccupancySnapshotSchema = object({
 	/** Frame timestamp of the inference result that produced this snapshot. */
@@ -35960,6 +36029,12 @@ 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",
@@ -39824,6 +39899,12 @@ 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-matter-broker",
-  "version": "0.2.97",
+  "version": "0.2.99",
   "description": "Matter broker addon for CamStack — owns a Matter fabric (commissioning + the long-lived controller) via the matter.js controller and brokers commissioned Matter nodes into CamStack",
   "keywords": [
     "camstack",