@camstack/addon-auth 1.2.106 → 1.2.108

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-DAXzJeTX.mjs
1
+ //#region ../types/dist/event-category-ZyX6jcse.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -559,7 +559,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
559
559
  * a package zone — a newly-appeared stationary object of a package class
560
560
  * that cleared the class / zone / dwell / size gates. Payload:
561
561
  * `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
562
- * entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
562
+ * entryId, className, zoneIds, keyFrameMediaId?, bbox, timestamp }`.
563
563
  * Telemetry (D8): the durable record is the `package-events` store row;
564
564
  * this bus topic drives notifier rules + live UI. See
565
565
  * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
@@ -5345,7 +5345,7 @@ var ZodIssueCode = {
5345
5345
  var ZodFirstPartyTypeKind;
5346
5346
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5347
5347
  //#endregion
5348
- //#region ../types/dist/sleep-BnujYGPe.mjs
5348
+ //#region ../types/dist/sleep-DBKu2-U5.mjs
5349
5349
  /**
5350
5350
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5351
5351
  * window to float samples (D455).
@@ -7308,13 +7308,30 @@ new Set([
7308
7308
  "scene",
7309
7309
  "motion",
7310
7310
  "object",
7311
- "audio"
7311
+ "audio",
7312
+ "mosaic"
7312
7313
  ]);
7313
- new Set([
7314
+ /**
7315
+ * The owner types that are event tables, in the order the event-media resolver
7316
+ * should consider them. Exported so a consumer asking "is this key an event?"
7317
+ * does not re-spell the list and drift from it.
7318
+ */
7319
+ var EVENT_OWNER_TYPES = [
7314
7320
  "motion",
7315
7321
  "object",
7316
7322
  "audio"
7317
- ]);
7323
+ ];
7324
+ /**
7325
+ * The same list as a Zod enum, for the cap inputs that must NAME the table
7326
+ * (D482: `getEventMedia` / `listEventMedia` take an owner, and an owner is
7327
+ * `(table, id)`).
7328
+ *
7329
+ * Built FROM {@link EVENT_OWNER_TYPES} rather than re-spelled: a fourth event
7330
+ * table would otherwise be accepted by the codec and refused at the door, with
7331
+ * nothing failing until a caller asked.
7332
+ */
7333
+ var EventOwnerTypeSchema = _enum(EVENT_OWNER_TYPES);
7334
+ new Set(EVENT_OWNER_TYPES);
7318
7335
  /**
7319
7336
  * Build an `IAddonRouteProvider` from a list of routes. Implements
7320
7337
  * both the operator-facing `getRoutes` (returning route descriptors
@@ -7470,7 +7487,23 @@ var EncodeProfileSchema = object({
7470
7487
  "zerolatency",
7471
7488
  "film",
7472
7489
  "animation"
7473
- ]).optional()
7490
+ ]).optional(),
7491
+ /**
7492
+ * ONE slice per access unit.
7493
+ *
7494
+ * `-tune zerolatency` turns on x264's sliced threads, and a frame then leaves
7495
+ * the encoder as five NAL slices that share one RTP timestamp and carry one
7496
+ * marker bit. A libwebrtc depacketiser sees five frame-starts and one
7497
+ * frame-end per frame: the first pictures render and the video then freezes
7498
+ * for good while the audio, on its own plane, plays on. Measured on this hub
7499
+ * 2026-09-13 against the Echo, and reduced to one slice by this flag alone.
7500
+ *
7501
+ * A NAMED field and not a raw flag, because {@link EgressEncodeSchema} omits
7502
+ * `outputArgs` on purpose: an opaque array is part of the sharing key, so two
7503
+ * consumers meaning the same thing spelled differently would stop sharing one
7504
+ * child. Absent means "whatever the encoder does" — today's behaviour.
7505
+ */
7506
+ singleSlicePerFrame: boolean().optional()
7474
7507
  }),
7475
7508
  audio: union([literal("passthrough"), object({
7476
7509
  codec: _enum([
@@ -7520,7 +7553,7 @@ var BASE_LIVE_EGRESS_PROFILE = {
7520
7553
  audio: "passthrough"
7521
7554
  };
7522
7555
  ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
7523
- ({ ...BASE_LIVE_EGRESS_PROFILE });
7556
+ ({ ...BASE_LIVE_EGRESS_PROFILE }), { ...BASE_LIVE_EGRESS_PROFILE.video };
7524
7557
  /**
7525
7558
  * Deep wiring healthcheck — snapshot of active reachability probes across
7526
7559
  * every declared capability + widget of every installed plugin, on every
@@ -12579,6 +12612,16 @@ method(object({
12579
12612
  filter: QueryFilterSchema.optional(),
12580
12613
  columns: array(string()).readonly().optional()
12581
12614
  }), array(SettingsRecordSchema).readonly()), method(object({
12615
+ namespace: string().optional(),
12616
+ collection: string(),
12617
+ /** Declared columns identifying the slot; must be covered by a UNIQUE
12618
+ * index on the collection. Never empty. */
12619
+ conflict: array(string()).readonly(),
12620
+ record: BulkRecordSchema
12621
+ }), object({
12622
+ /** The id the row HAS: assigned by SQLite on an insert, or the existing
12623
+ * row's own id on an update. */
12624
+ id: union([string(), number()]) }), { kind: "mutation" }), method(object({
12582
12625
  namespace: string().optional(),
12583
12626
  collection: string(),
12584
12627
  record: object({
@@ -12713,6 +12756,14 @@ method(_void(), EngineInfoSchema, { auth: "admin" }), method(object({
12713
12756
  id: union([string(), number()]) }), {
12714
12757
  kind: "mutation",
12715
12758
  auth: "admin"
12759
+ }), method(object({
12760
+ namespace: string().optional(),
12761
+ collection: string(),
12762
+ conflict: array(string()).readonly(),
12763
+ record: BulkRecordSchema
12764
+ }), object({ id: union([string(), number()]) }), {
12765
+ kind: "mutation",
12766
+ auth: "admin"
12716
12767
  }), method(object({
12717
12768
  namespace: string().optional(),
12718
12769
  collection: string(),
@@ -18937,8 +18988,8 @@ var TrackPositionSchema = object({
18937
18988
  var TrackSnapshotSchema = object({
18938
18989
  timestamp: number(),
18939
18990
  position: TrackPositionSchema,
18940
- /** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
18941
- mediaKey: string()
18991
+ /** The snapshot's media row id (D482); resolve via `listTrackMedia({ trackId })`. */
18992
+ mediaId: number().int()
18942
18993
  });
18943
18994
  /**
18944
18995
  * Normalized 0..1 trajectory envelope (min/max over every position bbox,
@@ -19542,14 +19593,14 @@ var ObjectEventSchema = object({
19542
19593
  * pixel-space `bbox` onto a displayed image. Omitted in slim projection. */
19543
19594
  frameWidth: number().optional(),
19544
19595
  frameHeight: number().optional(),
19545
- /** MediaStore key for the crop attached to this event (if any). */
19546
- mediaKey: string().optional(),
19547
- /** Design B: MediaStore key of the track's native-resolution key frame (the
19596
+ /** Media row id of the crop attached to this event (if any) — D482. */
19597
+ mediaId: number().int().optional(),
19598
+ /** Design B: media row id of the track's native-resolution key frame (the
19548
19599
  * best-detection full frame). Resolve via the event-media data-plane
19549
- * (`/addon/<addonId>/event-media/<keyFrameMediaKey>`) for a detail view that
19600
+ * (`/addon/<addonId>/event-media/m/<keyFrameMediaId>`) for a detail view that
19550
19601
  * draws `bbox` over the native frame. Absent on legacy rows / non-decoded
19551
- * sources — consumers fall back to `mediaKey` (the tight crop). */
19552
- keyFrameMediaKey: string().optional(),
19602
+ * sources — consumers fall back to `mediaId` (the tight crop). */
19603
+ keyFrameMediaId: number().int().optional(),
19553
19604
  /** Populated by B5 (recording playback URL for this event). */
19554
19605
  mediaUrl: string().optional(),
19555
19606
  /** The parent track's key-event importance [0,1], propagated to every object
@@ -19599,7 +19650,7 @@ var MediaFileKindEnum = _enum([
19599
19650
  * hub-main's heap on the way past — for an `<img>` that would have cached it.
19600
19651
  *
19601
19652
  * `url` points at the `event-media` data plane
19602
- * (`/addon/<addonId>/event-media/<storedKey>`), which serves the same blob
19653
+ * (`/addon/<addonId>/event-media/m/<mediaId>` — D482), which serves the same blob
19603
19654
  * with an ETag and `Cache-Control: immutable`, honours conditional GETs, can
19604
19655
  * render a `?variant=thumb`, and streams. The hub gate in front of it requires
19605
19656
  * a bearer or the session cookie (`access: 'authenticated'`), so the bytes are
@@ -19607,10 +19658,13 @@ var MediaFileKindEnum = _enum([
19607
19658
  * `data-plane-access.ts` for the rule and the one gap it does not close
19608
19659
  * (per-device scoping).
19609
19660
  *
19610
- * The URL is built from the row's **stored** key, which is not always its
19611
- * published `kind`: a track's face/plate crop is stored as `crop` under
19661
+ * The URL is built from the row's own id, which since D482 says nothing about
19662
+ * the row's owner or kind — and that is the point. The published `kind` is not
19663
+ * the stored one (a track's face/plate crop is stored as `crop` under
19612
19664
  * `('face'|'plate', '<prefix>-<trackId>')` and published as
19613
- * `faceCrop`/`plateCrop`. `MediaStore.getByKey` knows only the stored key.
19665
+ * `faceCrop`/`plateCrop`), and under the old composite key the URL had to be
19666
+ * taken from `row.key` verbatim or it 404'd exactly those two rows. An id
19667
+ * cannot be mis-reconstructed, because there is nothing in it to reconstruct.
19614
19668
  *
19615
19669
  * ## `base64` is TRANSITIONAL and is going away
19616
19670
  *
@@ -19623,7 +19677,19 @@ var MediaFileKindEnum = _enum([
19623
19677
  * `analytics-query-facade.ts`; nothing else reads it.
19624
19678
  */
19625
19679
  var MediaFileSchema = object({
19626
- key: string(),
19680
+ /**
19681
+ * The media row's OWN id — the rowid SQLite assigned it (D482).
19682
+ *
19683
+ * It used to be the row's composite key, `<ownerType>:<ownerId>:<fileKind>
19684
+ * [:<timestampMs>]`, which embedded a FOREIGN id. D474 made event ids
19685
+ * per-table rowid aliases, so `object:101314` and `motion:101314` are two
19686
+ * different rows that spell the same number, and a track whose
19687
+ * `bestEventId` was an object event was served a motion event's snapshot —
19688
+ * a night-time thumbnail on an afternoon track, with no error anywhere. A
19689
+ * surrogate id cannot name the wrong row's owner, because it names no owner
19690
+ * at all.
19691
+ */
19692
+ mediaId: number().int(),
19627
19693
  kind: MediaFileKindEnum,
19628
19694
  sizeBytes: number(),
19629
19695
  timestamp: number()
@@ -19731,7 +19797,7 @@ var RetrainTrackSchema = object({
19731
19797
  });
19732
19798
  /** A frame the picker may offer — an index row, no blob was read to produce it. */
19733
19799
  var RetrainFrameCandidateSchema = object({
19734
- mediaKey: string(),
19800
+ mediaId: number().int(),
19735
19801
  kind: MediaFileKindEnum,
19736
19802
  timestamp: number(),
19737
19803
  sizeBytes: number().int(),
@@ -19745,7 +19811,7 @@ var RetrainFrameSchema = object({
19745
19811
  deviceId: number(),
19746
19812
  trackId: string(),
19747
19813
  /** Provenance only. It may already point at nothing — that is expected. */
19748
- sourceMediaKey: string(),
19814
+ sourceMediaId: number().int(),
19749
19815
  sourceKind: MediaFileKindEnum,
19750
19816
  sizeBytes: number().int(),
19751
19817
  width: number().int(),
@@ -19761,7 +19827,7 @@ var RetrainCopyRefusalSchema = _enum([
19761
19827
  var RetrainFrameSelectionSchema = object({
19762
19828
  copied: array(RetrainFrameSchema).readonly(),
19763
19829
  refused: array(object({
19764
- sourceMediaKey: string(),
19830
+ sourceMediaId: number().int(),
19765
19831
  reason: RetrainCopyRefusalSchema
19766
19832
  })).readonly()
19767
19833
  });
@@ -19769,7 +19835,7 @@ var RetrainFrameListSchema = object({
19769
19835
  candidates: array(RetrainFrameCandidateSchema).readonly(),
19770
19836
  copies: array(RetrainFrameSchema).readonly(),
19771
19837
  /** What the page pre-selects — the native key frame when one survives. */
19772
- autoPickMediaKey: string().optional()
19838
+ autoPickMediaId: number().int().optional()
19773
19839
  });
19774
19840
  /** What the operator asked the assist to look for. */
19775
19841
  var RetrainAssistSubjectSchema = discriminatedUnion("kind", [object({
@@ -19864,9 +19930,11 @@ var RecentTracksQueryInput = object({
19864
19930
  });
19865
19931
  /**
19866
19932
  * A Summary (D359): the per-camera session envelope that references tracks.
19867
- * `groupShotKey` is the media key of its group shot (`ownerKind: 'summary'`,
19868
- * served by the event-media plane by key), null until the first frame with a
19869
- * member visible has been materialised.
19933
+ * `groupShotMediaId` is the media ROW id of its group shot (`ownerKind:
19934
+ * 'summary'`, served by the event-media plane at `/m/<id>`), null until the
19935
+ * first frame with a member visible has been materialised (D482 — it was the
19936
+ * row's composite key, which embedded the owner and could name another table's
19937
+ * row once event ids became per-table rowids).
19870
19938
  */
19871
19939
  var SummarySchema = object({
19872
19940
  id: string(),
@@ -19875,19 +19943,115 @@ var SummarySchema = object({
19875
19943
  lastActiveAt: number(),
19876
19944
  sealedAt: number().nullable(),
19877
19945
  memberCount: number().int().nonnegative(),
19878
- groupShotKey: string().nullable()
19946
+ groupShotMediaId: number().int().nullable()
19879
19947
  });
19880
19948
  var SummariesQueryInput = object({
19881
19949
  deviceIds: array(number()).min(1),
19882
19950
  since: number().optional(),
19883
19951
  until: number().optional(),
19884
- limit: number().int().min(1).max(200).default(50)
19952
+ limit: number().int().min(1).max(200).default(50),
19953
+ /** The same member-wise filter {@link listRecentSummaries} takes — one
19954
+ * meaning of "dog" on every summary surface. */
19955
+ classes: array(string().min(1).max(60)).max(40).optional()
19885
19956
  });
19886
- var SummariesPageSchema = object({ summaries: array(SummarySchema).readonly() });
19887
19957
  var SummaryDetailSchema = object({
19888
19958
  summary: SummarySchema,
19889
- /** Member track ids, in absorption order. */
19890
- trackIds: array(string()).readonly()
19959
+ /** Members in absorption order, oldest join first. */
19960
+ members: array(object({
19961
+ trackId: string(),
19962
+ /**
19963
+ * The track's class at the time it JOINED, or `null` when it was unresolved
19964
+ * and the track no longer exists to fill it.
19965
+ *
19966
+ * The join, not the latest opinion: class voting can re-decide a track's
19967
+ * class afterwards, and a group's composition is the history of who came
19968
+ * together. A consumer counts these to badge a thumbnail — "two people and a
19969
+ * dog" — rather than being handed a second, denormalised tally that would
19970
+ * drift from the members it claims to describe.
19971
+ */
19972
+ className: string().nullable(),
19973
+ /** `primary` is the one member that carries the group's identity. */
19974
+ role: _enum([
19975
+ "primary",
19976
+ "sibling",
19977
+ "child"
19978
+ ]).nullable(),
19979
+ joinedAt: number(),
19980
+ /** Tier 1 — the sub-class (`dog`, `van`), resolved from the member's track
19981
+ * at read time. Absent when nothing resolved, never an empty string. */
19982
+ label: string().optional(),
19983
+ /** Tier 2 — the instance: a person's name, a plate. Absent when the pipeline
19984
+ * recognised nobody, and absent for a member whose track has been pruned —
19985
+ * a thumbnail that names the wrong person is worse than one naming nobody. */
19986
+ subLabel: string().optional()
19987
+ })).readonly()
19988
+ });
19989
+ /**
19990
+ * What a LIST of groups carries: the envelope plus what it is MADE OF.
19991
+ *
19992
+ * Coarse on purpose — the operator's rule is "only the rough data on the list,
19993
+ * we extend when we notice we need more". Enough to draw the card ("two people
19994
+ * and a dog") and no more. The MEMBERS, their names and the per-member links
19995
+ * are on {@link getSummary}: shipping every member of every group so a client
19996
+ * can count them turns a page of two hundred groups into a thousand records to
19997
+ * draw two hundred badges.
19998
+ */
19999
+ var SummaryListItemSchema = object({
20000
+ summary: SummarySchema,
20001
+ /** Class counts, most numerous first; `className: null` is a member whose
20002
+ * class never resolved, counted so the counts add up to `memberCount`. */
20003
+ classes: array(object({
20004
+ className: string().nullable(),
20005
+ count: number().int().positive()
20006
+ })).readonly()
20007
+ });
20008
+ var SummariesPageSchema = object({ summaries: array(SummaryListItemSchema).readonly() });
20009
+ /**
20010
+ * The paged feed, deliberately the SAME shape as {@link RecentTracksQueryInput}.
20011
+ *
20012
+ * The reel on the cameras page and the Events gallery both ride a cursor, so a
20013
+ * summaries feed that could only answer "the last N for these cameras"
20014
+ * (`listSummaries`) would make groups available in the timeline and nowhere
20015
+ * else. Two feeds with different ordering contracts would be two ideas of what
20016
+ * "newest" means, on one screen.
20017
+ */
20018
+ var RecentSummariesQueryInput = object({
20019
+ /** Devices to merge. An empty array yields an empty page. */
20020
+ deviceIds: array(number()),
20021
+ /** Window lower bound on `lastActiveAt` (inclusive). */
20022
+ since: number().optional(),
20023
+ /** Window upper bound on `lastActiveAt` (inclusive). */
20024
+ until: number().optional(),
20025
+ limit: number().int().min(1).max(500).default(100),
20026
+ /** Opaque continuation cursor from a previous page's `nextCursor`. */
20027
+ cursor: string().optional(),
20028
+ /**
20029
+ * Restrict to these classes — THE SAME FIELD `listRecentTracks` takes, and
20030
+ * deliberately the same name: the events filter tree emits one list of ticked
20031
+ * taxonomy nodes, and a summaries feed that called it something else would
20032
+ * make the operator's one filter component produce two shapes.
20033
+ *
20034
+ * A question about the MEMBERS: a group matches when ANY of them does. "Show
20035
+ * me the arrivals with a dog" has to return the group of four people who had
20036
+ * one with them; a filter on the group's own fields could only ever answer
20037
+ * about its primary.
20038
+ *
20039
+ * Matched against all THREE tiers of a member — the class (`animal`), the
20040
+ * sub-class (`dog`) and the instance (a name, a plate) — because which tier a
20041
+ * ticked node lives on is the taxonomy's business, not the caller's. `dog` is
20042
+ * an event kind in the tree and a tier-1 label on an `animal` track; a filter
20043
+ * that read only the class would answer "animal" and never "dog".
20044
+ *
20045
+ * ABSENT or EMPTY means no filter — absent is not a selection of none.
20046
+ */
20047
+ classes: array(string().min(1).max(60)).max(40).optional()
20048
+ });
20049
+ var RecentSummariesPageSchema = object({
20050
+ /** Ordered by (`lastActiveAt` DESC, id DESC). Same light item as
20051
+ * {@link listSummaries} — one list shape, so a card renders the same
20052
+ * whichever feed drew it. */
20053
+ summaries: array(SummaryListItemSchema).readonly(),
20054
+ nextCursor: string().nullable()
19891
20055
  });
19892
20056
  var RecentTracksPageSchema = object({
19893
20057
  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
@@ -20301,7 +20465,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20301
20465
  classes: array(string()).optional(),
20302
20466
  /** See {@link ExcludeSourcesDoc}. */
20303
20467
  excludeSources: array(TrackSourceSchema).optional()
20304
- }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
20468
+ }), array(TrackSchema).readonly()), method(RecentTracksQueryInput, RecentTracksPageSchema), method(SummariesQueryInput, SummariesPageSchema), method(RecentSummariesQueryInput, RecentSummariesPageSchema), method(object({ id: string() }), SummaryDetailSchema.nullable()), method(object({ deviceId: number() }), _void(), {
20305
20469
  kind: "mutation",
20306
20470
  auth: "admin"
20307
20471
  }), method(DeviceEventQueryInput, array(MotionEventSchema).readonly()), method(ObjectEventQueryInput, array(ObjectEventSchema).readonly()), method(DeviceEventQueryInput, array(AudioEventSchema).readonly()), method(object({ deviceId: number() }), array(EventKindDescriptorSchema).readonly()), method(object({ deviceIds: array(number()).min(1).max(200) }), array(EventKindsForDeviceSchema).readonly()), method(object({
@@ -20429,7 +20593,7 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20429
20593
  }), method(object({
20430
20594
  deviceId: number(),
20431
20595
  trackId: string(),
20432
- mediaKeys: array(string()).min(1)
20596
+ mediaIds: array(number().int()).min(1)
20433
20597
  }), RetrainFrameSelectionSchema, {
20434
20598
  kind: "mutation",
20435
20599
  auth: "admin"
@@ -20497,7 +20661,10 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20497
20661
  kind: "query",
20498
20662
  auth: "admin"
20499
20663
  }), method(object({
20500
- eventId: string(),
20664
+ /** Which of the three event tables owns the row. */
20665
+ ownerType: EventOwnerTypeSchema,
20666
+ /** The event's rowid in that table (D474: an event id is a number). */
20667
+ eventId: number().int(),
20501
20668
  kind: MediaFileKindEnum.optional(),
20502
20669
  deviceId: number()
20503
20670
  }), array(MediaFileSchema).readonly()), method(object({
@@ -20508,7 +20675,8 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
20508
20675
  trackId: string(),
20509
20676
  deviceId: number()
20510
20677
  }), array(MediaFileInfoSchema).readonly()), method(object({
20511
- eventId: string(),
20678
+ ownerType: EventOwnerTypeSchema,
20679
+ eventId: number().int(),
20512
20680
  deviceId: number()
20513
20681
  }), array(MediaFileInfoSchema).readonly()), method(SearchObjectEventsInput, array(ScoredObjectEventSchema).readonly()), method(object({}), WipeObjectEmbeddingsResultSchema, {
20514
20682
  kind: "mutation",
@@ -25006,8 +25174,8 @@ var IdentitySchema = object({
25006
25174
  id: string(),
25007
25175
  name: string(),
25008
25176
  sampleCount: number().int().nonnegative(),
25009
- coverMediaKey: string().optional(),
25010
- /** Inline base64 of the cover sample's crop, resolved from `coverMediaKey`.
25177
+ coverMediaId: number().int().optional(),
25178
+ /** Inline base64 of the cover sample's crop, resolved from `coverMediaId`.
25011
25179
  * Lets the UI render the person's face avatar instead of a placeholder icon. */
25012
25180
  coverBase64: string().optional()
25013
25181
  });
@@ -25033,8 +25201,8 @@ var IdentitySampleAuditRowSchema = object({
25033
25201
  enrolledAt: number().int(),
25034
25202
  deviceId: number().int().optional(),
25035
25203
  source: _enum(["detected", "photo"]),
25036
- /** The enrolled crop's media key, so the panel can show the evidence. */
25037
- mediaKey: string().optional(),
25204
+ /** The enrolled crop's media row id, so the panel can show the evidence. */
25205
+ mediaId: number().int().optional(),
25038
25206
  /**
25039
25207
  * False = the sample is stamped with a DIFFERENT face model, and a cosine
25040
25208
  * across feature spaces is a well-formed float with no meaning. Every number
@@ -25103,15 +25271,15 @@ var FaceInfoSchema = object({
25103
25271
  */
25104
25272
  cropUrl: string().optional(),
25105
25273
  /** Design B: the face bbox (pixel space) on the key frame — lets a detail
25106
- * view draw the box over the native `keyFrameMediaKey` frame. Absent on
25274
+ * view draw the box over the native `keyFrameMediaId` frame. Absent on
25107
25275
  * legacy rows written before design B. */
25108
25276
  faceBbox: BoundingBoxSchema.optional(),
25109
25277
  /** Design B: MediaStore key of the track's native-resolution key frame.
25110
25278
  * Fetch the native JPEG via the event-media data-plane
25111
- * (`/addon/<addonId>/event-media/<keyFrameMediaKey>`). Absent when the
25279
+ * (`/addon/<addonId>/event-media/m/<keyFrameMediaId>`). Absent when the
25112
25280
  * track produced no key frame (e.g. native/onboard source) — the UI falls
25113
25281
  * back to the inline `base64` face crop. */
25114
- keyFrameMediaKey: string().optional(),
25282
+ keyFrameMediaId: number().int().optional(),
25115
25283
  /** Winning identity-match cosine (0..1) for this face's track, when an
25116
25284
  * identity was auto-confirmed. Lets the UI surface WHY a face was assigned
25117
25285
  * (confidence badge / low-confidence audit). Absent on legacy rows and on
@@ -25180,11 +25348,14 @@ var FaceClusterSchema = object({
25180
25348
  * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
25181
25349
  * dialog already rendering its key FRAME from the `event-media` plane.
25182
25350
  *
25183
- * `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
25184
- * media key directly, so this needed no new plane and no new access decision.
25351
+ * `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
25352
+ * resolves a media row by its own id, so this needed no new plane and no new
25353
+ * access decision.
25185
25354
  */
25186
25355
  var MediaFileLiteSchema$1 = object({
25187
- key: string(),
25356
+ /** The media row's own id — the same address `MediaFileRef.mediaId` carries
25357
+ * (D482). It was the row's composite key, which embedded the owner. */
25358
+ mediaId: number().int(),
25188
25359
  kind: string(),
25189
25360
  url: string(),
25190
25361
  sizeBytes: number(),
@@ -25201,7 +25372,7 @@ method(object({
25201
25372
  * covers inline, ~10 KB of base64 per row, on a query this UI mounts
25202
25373
  * four times and the viewer holds at `staleTime: 30_000`.
25203
25374
  *
25204
- * Nothing loses its avatar: `coverMediaKey` is already on every row and
25375
+ * Nothing loses its avatar: `coverMediaId` is already on every row and
25205
25376
  * the `event-media` plane serves that key `immutable` with an ETag.
25206
25377
  *
25207
25378
  * **This is an INPUT field, so it does not reach the addon until the
@@ -27669,8 +27840,8 @@ var VehicleSchema = object({
27669
27840
  id: string(),
27670
27841
  name: string(),
27671
27842
  sampleCount: number().int().nonnegative(),
27672
- coverMediaKey: string().optional(),
27673
- /** Inline base64 of the cover sample's plate crop, resolved from `coverMediaKey`. */
27843
+ coverMediaId: number().int().optional(),
27844
+ /** Inline base64 of the cover sample's plate crop, resolved from `coverMediaId`. */
27674
27845
  coverBase64: string().optional()
27675
27846
  });
27676
27847
  var VehicleSampleInfoSchema = object({
@@ -27703,7 +27874,7 @@ var PlateInfoSchema = object({
27703
27874
  /** keyFrame parity: the plate bbox (pixel space) on the native key frame. */
27704
27875
  plateBbox: BoundingBoxSchema.optional(),
27705
27876
  /** keyFrame parity: MediaStore key of the track's native-resolution key frame. */
27706
- keyFrameMediaKey: string().optional(),
27877
+ keyFrameMediaId: number().int().optional(),
27707
27878
  base64: string().optional(),
27708
27879
  /**
27709
27880
  * Same crop as a data-plane URL, always present when the plate has a stored
@@ -27724,11 +27895,14 @@ var PlateInfoSchema = object({
27724
27895
  * `data:image/jpeg;base64,…` from a row whose `key` sat right beside it, in a
27725
27896
  * dialog already rendering its key FRAME from the `event-media` plane.
27726
27897
  *
27727
- * `url` is `/addon/<addonId>/event-media/<encoded key>`. The plane resolves a
27728
- * media key directly, so this needed no new plane and no new access decision.
27898
+ * `url` is `/addon/<addonId>/event-media/m/<mediaId>` (D482). The plane
27899
+ * resolves a media row by its own id, so this needed no new plane and no new
27900
+ * access decision.
27729
27901
  */
27730
27902
  var MediaFileLiteSchema = object({
27731
- key: string(),
27903
+ /** The media row's own id — the same address `MediaFileRef.mediaId` carries
27904
+ * (D482). It was the row's composite key, which embedded the owner. */
27905
+ mediaId: number().int(),
27732
27906
  kind: string(),
27733
27907
  url: string(),
27734
27908
  sizeBytes: number(),
@@ -27787,7 +27961,7 @@ method(object({
27787
27961
  }), method(object({
27788
27962
  /** Inline {@link VehicleSchema.coverBase64} on every row. Default
27789
27963
  * `false` — the vehicle twin of `faceGallery.listIdentities`'s
27790
- * option; `coverMediaKey` + the `event-media` plane carry the picture.
27964
+ * option; `coverMediaId` + the `event-media` plane carry the picture.
27791
27965
  * INPUT field: stripped by the hub router until the train ships, which
27792
27966
  * resolves to `false` and is exactly the intended default. */
27793
27967
  includeCrops: boolean().optional() }).optional(), array(VehicleSchema).readonly()), method(object({ name: string().min(1) }), VehicleSchema, {
@@ -29111,7 +29285,14 @@ var SceneReferenceSchema = object({
29111
29285
  modelId: string(),
29112
29286
  condition: SceneConditionSchema,
29113
29287
  capturedAt: number(),
29114
- thumbnailMediaId: string().optional(),
29288
+ /**
29289
+ * The reference thumbnail's media ROW id (D482).
29290
+ *
29291
+ * The name already said `mediaId` while the value was the row's composite
29292
+ * key — a leftover that read as done and was not. It is the row's own id
29293
+ * now, addressed at `/addon/<addonId>/event-media/m/<id>`.
29294
+ */
29295
+ thumbnailMediaId: number().int().optional(),
29115
29296
  /** Whole-frame (downscaled) embedding captured alongside the ROI crop. The
29116
29297
  * anti-view-shift anchor: a bumped camera, a PTZ preset or a re-aim makes the
29117
29298
  * normalized rect frame a different piece of world, and the scene would
@@ -29925,7 +30106,29 @@ var LoggingSettingsPatchSchema = object({
29925
30106
  * disarmed the channels it did not mention would make the Levels page and
29926
30107
  * the Diagnostics page fight over the same value.
29927
30108
  */
29928
- channels: array(LogChannelWindowPatchSchema).readonly().optional()
30109
+ channels: array(LogChannelWindowPatchSchema).readonly().optional(),
30110
+ /**
30111
+ * How many days the analytics OPS LOG is kept — the audit trail of what
30112
+ * retention actually deleted.
30113
+ *
30114
+ * It lives HERE, on the logging document, and not on the analytics addon's
30115
+ * settings form, on the operator's instruction: every other log-ish window in
30116
+ * this system is configured through this one document, and a retention audit
30117
+ * configured somewhere else is a second place to look when the question is
30118
+ * "what happened to my data".
30119
+ *
30120
+ * That placement has a cost worth stating: this document ships in the
30121
+ * framework closure, so this knob needs a published `@camstack/server` while
30122
+ * the four windows beside it (D485) reach a node on `camstack deploy`.
30123
+ *
30124
+ * `retention-model.ts` argued this one must NOT follow a device window,
30125
+ * because the audit trail is the history of the SWEEP and not of the camera.
30126
+ * That argument stands and is untouched — what changes is that 30 days stops
30127
+ * being a constant nobody can reach. `0` keeps it forever. The floor is 1 day
30128
+ * rather than 0-as-delete: an audit log truncated to nothing is precisely the
30129
+ * state in which the next 9.5 GiB leak cannot be explained.
30130
+ */
30131
+ opsLogRetentionDays: number().int().min(0).max(3650).optional()
29929
30132
  });
29930
30133
  /**
29931
30134
  * Which LAYER of the hierarchy is addressed. Absent = the cluster layer.
@@ -29998,6 +30201,14 @@ var LoggingSettingsStateSchema = object({
29998
30201
  channels: array(LogChannelDescriptorSchema).readonly(),
29999
30202
  /** The channels ARMED right now, each with its deadline. */
30000
30203
  activeChannels: array(LogChannelWindowStateSchema).readonly(),
30204
+ /**
30205
+ * The ops-log window in days, as it is in force. `0` = kept forever.
30206
+ *
30207
+ * Reported rather than left to the caller's memory of what it wrote: this is
30208
+ * the value the analytics sweep will actually use, and an operator asking how
30209
+ * long their audit trail lives should not have to infer it from a default.
30210
+ */
30211
+ opsLogRetentionDays: number().int().min(0),
30001
30212
  persisted: boolean()
30002
30213
  });
30003
30214
  method(_void(), FeatureManifestSchema), method(_void(), HealthStatusSchema), method(_void(), FeatureManifestSchema), method(_void(), array(NetworkAddressSchema).readonly()), method(_void(), unknown().nullable(), { auth: "admin" }), method(record(string(), unknown()), _null(), {
@@ -30559,7 +30770,7 @@ var StationaryObjectSchema = object({
30559
30770
  /** Enrichment label carried from the source track (identity / plate). */
30560
30771
  label: string().optional(),
30561
30772
  /** Native-resolution key-frame media key for the parked object's best image. */
30562
- keyFrameMediaKey: string().optional()
30773
+ keyFrameMediaId: number().int().optional()
30563
30774
  });
30564
30775
  var CameraOccupancySnapshotSchema = object({
30565
30776
  /** Frame timestamp of the inference result that produced this snapshot. */
@@ -31715,6 +31926,12 @@ Object.freeze({
31715
31926
  addonId: null,
31716
31927
  access: "create"
31717
31928
  },
31929
+ "dataStoreProvider.upsert": {
31930
+ capName: "data-store-provider",
31931
+ capScope: "system",
31932
+ addonId: null,
31933
+ access: "create"
31934
+ },
31718
31935
  "dayNight.getOptions": {
31719
31936
  capName: "day-night",
31720
31937
  capScope: "device",
@@ -34151,6 +34368,12 @@ Object.freeze({
34151
34368
  addonId: null,
34152
34369
  access: "view"
34153
34370
  },
34371
+ "pipelineAnalytics.listRecentSummaries": {
34372
+ capName: "pipeline-analytics",
34373
+ capScope: "device",
34374
+ addonId: null,
34375
+ access: "view"
34376
+ },
34154
34377
  "pipelineAnalytics.listRecentTracks": {
34155
34378
  capName: "pipeline-analytics",
34156
34379
  capScope: "device",
@@ -35579,6 +35802,12 @@ Object.freeze({
35579
35802
  addonId: null,
35580
35803
  access: "create"
35581
35804
  },
35805
+ "settingsStore.upsert": {
35806
+ capName: "settings-store",
35807
+ capScope: "system",
35808
+ addonId: null,
35809
+ access: "create"
35810
+ },
35582
35811
  "smtpProvider.getStatus": {
35583
35812
  capName: "smtp-provider",
35584
35813
  capScope: "system",
@@ -37972,6 +38201,11 @@ Object.freeze({
37972
38201
  form: "single",
37973
38202
  optional: true
37974
38203
  }],
38204
+ "pipelineAnalytics.listRecentSummaries": [{
38205
+ name: "deviceIds",
38206
+ form: "array",
38207
+ optional: false
38208
+ }],
37975
38209
  "pipelineAnalytics.listRecentTracks": [{
37976
38210
  name: "deviceIds",
37977
38211
  form: "array",