@camstack/addon-osd-manager 0.1.123 → 0.1.125

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.
Files changed (20) hide show
  1. package/dist/MotionZonesSettings-a5Xl2ZE4.mjs +310 -0
  2. package/dist/{PrivacyMaskSettings-DVZjIN6W.mjs → PrivacyMaskSettings-B2UgOTdb.mjs} +26 -26
  3. package/dist/{SceneMonitorEditor-vd5ui8yS.mjs → SceneMonitorEditor-8tp57K86.mjs} +295 -295
  4. package/dist/_stub.js +245 -245
  5. package/dist/{_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-BUn-8ukN.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-Co7z8wQJ.mjs} +3 -3
  6. package/dist/_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-BK-eslgm.mjs +26 -0
  7. package/dist/addon-osd-manager.css +1 -1
  8. package/dist/{responsive-BJ6OUcwu.mjs → cap-error-DC-GOnm5.mjs} +8 -8
  9. package/dist/{hostInit-B0QYXY-C.mjs → hostInit-p8Mnw5w9.mjs} +2 -2
  10. package/dist/index.js +401 -18
  11. package/dist/index.mjs +401 -18
  12. package/dist/{player-overlays-CnOtnn9E.mjs → player-overlays-C7IiQKvf.mjs} +1 -1
  13. package/dist/remoteEntry.js +1 -1
  14. package/dist/{scene-monitor-copy-CbOCxWBI.mjs → scene-monitor-copy-B5sXPAoG.mjs} +1 -1
  15. package/dist/{square-C85XpRsl.mjs → square-MsYzEBNo.mjs} +1 -1
  16. package/dist/{trash-2-RZb81dMj.mjs → trash-2-CahmDJ9h.mjs} +1 -1
  17. package/dist/{virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-BYA-5ZRu.mjs → virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-B0w_cAoJ.mjs} +1 -1
  18. package/package.json +1 -1
  19. package/dist/MotionZonesSettings-DN5iDMeX.mjs +0 -310
  20. package/dist/_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare___mf_0_camstack_mf_1_types__loadShare__.js-BzMsLBUL.mjs +0 -26
package/dist/index.mjs CHANGED
@@ -5359,7 +5359,7 @@ var ZodIssueCode = {
5359
5359
  var ZodFirstPartyTypeKind;
5360
5360
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5361
5361
  //#endregion
5362
- //#region ../types/dist/sleep-CiR4z7r9.mjs
5362
+ //#region ../types/dist/sleep-7AN_Txmu.mjs
5363
5363
  /**
5364
5364
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5365
5365
  * window to float samples (D455).
@@ -15936,14 +15936,30 @@ var deviceManagerCapability = {
15936
15936
  */
15937
15937
  getAllBindings: method(object({}), array(DeviceBindingsForDeviceSchema)),
15938
15938
  /**
15939
- * Activate (or deactivate) a wrapper addon for a (device, cap) pair.
15940
- * Persists the binding via ctx.settings. active=false clears the wrapper
15941
- * (falls back to native if registered).
15939
+ * Activate (or deactivate) a wrapper addon — or ONE of its sources — for a
15940
+ * (device, cap) pair.
15941
+ *
15942
+ * Persists the binding via ctx.settings; `active: false` on a SINGLETON cap
15943
+ * clears the wrapper (falling back to native if one is registered). On a
15944
+ * COLLECTION cap it adds to the per-device DENY set instead, and the
15945
+ * wrapper binding is left exactly as it was — a cap with several sources
15946
+ * has no "which one" for `getBindings` to answer (D556).
15947
+ *
15948
+ * `sourceId` is what makes the switch match its label. One addon can serve
15949
+ * several of a device's sources (`addon-provider-reolink` answers a hub
15950
+ * child with `native:reolink:onboard` AND `native:reolink:hub`), so a
15951
+ * toggle keyed by addon would turn off both while saying it turned off one
15952
+ * — the D62 defect with the polarity reversed (D557). Naming the source
15953
+ * denies exactly that source. OMITTING it keeps the cap-wide meaning
15954
+ * D556 shipped: every source this addon serves for this device, which is
15955
+ * also how a deny entry persisted before the re-key is still read.
15942
15956
  */
15943
15957
  setWrapperActive: method(object({
15944
15958
  deviceId: number(),
15945
15959
  capName: string(),
15946
15960
  wrapperAddonId: string(),
15961
+ /** The `ClipSource.source` id to toggle. Absent = all of the addon's. */
15962
+ sourceId: string().optional(),
15947
15963
  active: boolean()
15948
15964
  }), _void(), {
15949
15965
  kind: "mutation",
@@ -27105,10 +27121,9 @@ var ServerBootModeSchema = _enum([
27105
27121
  * - `idle` / `checking` / `staging` — steady / in-flight registry work.
27106
27122
  * - `pending-restart` — a version is staged and the node has NOT yet
27107
27123
  * restarted onto it (still running the OLD version).
27108
- * - `awaiting-confirmation` — the node HAS restarted onto the staged version
27109
- * (it is the active probation boot) and is waiting to confirm boot-health.
27110
- * Apply/rollback are refused in this state and the node must NOT be
27111
- * manually restarted, or the probation boot auto-rolls-back.
27124
+ * - `awaiting-confirmation` — RETIRED with the probation boot (single-copy
27125
+ * collapse, 2026-07-18). Kept in the enum so an older client still parses;
27126
+ * no provider emits it.
27112
27127
  */
27113
27128
  var ServerUpdateStateSchema = _enum([
27114
27129
  "idle",
@@ -27197,12 +27212,35 @@ var ServerRollbackInfoSchema = object({
27197
27212
  var ServerPackageStatusSchema = object({
27198
27213
  /** Root package name (`@camstack/server` on the hub). */
27199
27214
  packageName: string(),
27200
- /** Version of the code the running process ACTUALLY loaded. */
27215
+ /**
27216
+ * Version of the code THIS PROCESS loaded — captured once, at boot, from the
27217
+ * package.json of the copy the code was loaded from, and never re-read. A
27218
+ * copy replaced on disk under a live process must not move this number;
27219
+ * that divergence is what `installedVersion` is for. Before 2026-09-20 this
27220
+ * was a lazy disk read that would have followed such a swap silently.
27221
+ */
27201
27222
  runningVersion: string().nullable(),
27202
27223
  /** Node.js runtime version the node's process runs on (`process.versions.node`). */
27203
27224
  nodeRuntimeVersion: string().nullable(),
27204
27225
  /** Active data-dir root version; null when booted from seed/workspace. */
27205
27226
  activeVersion: string().nullable(),
27227
+ /**
27228
+ * Version of the root package in the data-root `current/` copy RIGHT NOW —
27229
+ * what the next boot would load if nothing is staged. Normally equal to
27230
+ * `runningVersion`; differs only when the copy on disk changed under the
27231
+ * live process. `null` when there is no data-root copy (baked seed or
27232
+ * workspace boot). Optional for version skew: an older provider omits it.
27233
+ */
27234
+ installedVersion: string().nullable().optional(),
27235
+ /**
27236
+ * True when the code that would run after a restart is NOT the code running
27237
+ * now: a version is staged (`pendingVersion`), or `installedVersion` differs
27238
+ * from `runningVersion`. Derived on every read, never stored. This is the
27239
+ * one field that lets an operator or a script say "1.2.353 is installed and
27240
+ * will run after a restart" instead of reading it off a number that means
27241
+ * "installed". Optional for version skew.
27242
+ */
27243
+ restartRequired: boolean().optional(),
27206
27244
  /** N-1 version kept for rollback; null when no previous version exists. */
27207
27245
  previousVersion: string().nullable(),
27208
27246
  /** Version of the immutable baked seed closure (image fallback). */
@@ -27237,19 +27275,71 @@ var ServerPackageStatusSchema = object({
27237
27275
  });
27238
27276
  var ServerUpdateCheckResultSchema = object({
27239
27277
  packageName: string(),
27278
+ /** Same meaning as on the status payload: what THIS process loaded. */
27240
27279
  runningVersion: string().nullable(),
27241
27280
  latestVersion: string().nullable(),
27281
+ /**
27282
+ * `latestVersion` is newer than `runningVersion` AND is not the version
27283
+ * already staged on this node. A staged-and-waiting version is not "an
27284
+ * update available" — applying it again is refused (`already-staged`), and
27285
+ * a button that announced "updating…" on this boolean then got refused
27286
+ * would be lying. It is reported through `pendingVersion` instead.
27287
+ */
27242
27288
  updateAvailable: boolean(),
27243
27289
  checkedAtMs: number(),
27244
27290
  /** Non-null when the registry lookup failed (offline, bad registry, …). */
27245
- error: string().nullable()
27291
+ error: string().nullable(),
27292
+ /**
27293
+ * Version staged on this node and awaiting its restart, when one is. Before
27294
+ * 2026-09-20 a check answered `{runningVersion, updateAvailable:false}` for a
27295
+ * node whose staged closure had never booted, and the caller had no way to
27296
+ * see the difference. Optional for version skew.
27297
+ */
27298
+ pendingVersion: string().nullable().optional(),
27299
+ /** See the status payload: staged, or installed-on-disk ≠ running. Optional for skew. */
27300
+ restartRequired: boolean().optional()
27246
27301
  });
27302
+ /**
27303
+ * What an action DID — the discriminant `accepted` cannot carry. Before
27304
+ * 2026-09-20 `applyServerUpdate` answered `accepted:false` both for a refusal
27305
+ * where nothing was wrong (already current, already staged) and for a staging
27306
+ * install that died on `npm error code ECONNRESET`; the only difference was
27307
+ * prose in `message`, and an operator restarted a container on the strength of
27308
+ * it, booting the previous version.
27309
+ *
27310
+ * - `staged` — the closure is installed and validated; the node
27311
+ * restarts to apply it (`restarting:true`). NOTHING
27312
+ * runs the new code until that restart completes.
27313
+ * - `restart-scheduled` — a plain, version-preserving restart was accepted.
27314
+ * - `already-current` — the target IS the running version; nothing done.
27315
+ * - `refused` — dropped by a gate; `reason` names which.
27316
+ * - `failed` — attempted and did not land; `error` says why.
27317
+ */
27318
+ var ServerUpdateOutcomeSchema = _enum([
27319
+ "staged",
27320
+ "restart-scheduled",
27321
+ "already-current",
27322
+ "refused",
27323
+ "failed"
27324
+ ]);
27247
27325
  var ServerUpdateActionResultSchema = object({
27248
27326
  accepted: boolean(),
27249
27327
  targetVersion: string().nullable(),
27250
27328
  /** True when a graceful restart was scheduled to apply the change. */
27251
27329
  restarting: boolean(),
27252
- message: string()
27330
+ message: string(),
27331
+ /** See {@link ServerUpdateOutcomeSchema}. Optional for version skew. */
27332
+ outcome: ServerUpdateOutcomeSchema.optional(),
27333
+ /**
27334
+ * Stable, greppable cause for `refused` / `failed` (the engine's
27335
+ * `UpdateRefusalReason`, `staging-failed`, …). `null` on success.
27336
+ */
27337
+ reason: string().nullable().optional(),
27338
+ /**
27339
+ * The failure itself, verbatim enough to act on (the npm output for a
27340
+ * staging install). Non-null only for `failed`.
27341
+ */
27342
+ error: string().nullable().optional()
27253
27343
  });
27254
27344
  var serverManagementCapability = {
27255
27345
  name: "server-management",
@@ -28940,41 +29030,323 @@ var ClipSchema = object({
28940
29030
  holes: array(object({
28941
29031
  startMs: number(),
28942
29032
  endMs: number()
28943
- })).optional()
29033
+ })).optional(),
29034
+ /**
29035
+ * A URL that MAY produce this clip's still, asked only for rows actually on
29036
+ * screen. The opposite of {@link ClipSchema.thumbnail}: that one is VOUCHED
29037
+ * (a JPEG is already on disk), this one is an offer. The route answers 200
29038
+ * with the image, or 204 with `x-camstack-reason` when it could not mint one
29039
+ * — a surface latches that refusal to the instant rather than retrying.
29040
+ *
29041
+ * Never both: a clip with a vouched `thumbnail` needs no mint.
29042
+ */
29043
+ thumbnailMint: string().optional(),
29044
+ /**
29045
+ * Why no still will be produced for this clip RIGHT NOW — set when the
29046
+ * provider already knows, so the surface draws the glyph and the reason
29047
+ * instead of firing a mint that cannot succeed.
29048
+ *
29049
+ * `sleeping` — a standalone battery camera; a read would be a wake (D549 4).
29050
+ * `camera-refused` — the camera answered the CoverPreview with a refusal.
29051
+ * `no-keyframe` — the window holds no decodable I-frame (an event that sits
29052
+ * inside no file is the measured case).
29053
+ * `unsupported` — this source cannot mint stills at all.
29054
+ */
29055
+ thumbnailUnavailable: object({ reason: _enum([
29056
+ "sleeping",
29057
+ "camera-refused",
29058
+ "no-keyframe",
29059
+ "unsupported"
29060
+ ]) }).optional(),
29061
+ /**
29062
+ * When the catalog this row came from was last CONFIRMED against the device.
29063
+ * Absent means "this row was read live". A persisted catalog served while a
29064
+ * camera sleeps carries the age it really has — a cached list is never drawn
29065
+ * as current (D549 13).
29066
+ */
29067
+ catalogAsOf: number().optional(),
29068
+ /**
29069
+ * The camera's OWN type strings for this clip, all of them, unmapped
29070
+ * (`md`, `people`, `dog_cat`, `sched`, …). Kept beside {@link labels}
29071
+ * because a firmware inventing a type must not vanish: the mapping into our
29072
+ * filter vocabulary is lossy on purpose and this is the lossless copy
29073
+ * (D549 20).
29074
+ */
29075
+ nativeTypes: array(string()).optional(),
29076
+ /**
29077
+ * What the subject DID — `crossline`, `intrude`, `loitering`. A behaviour
29078
+ * travels BESIDE a class, never instead of one, and the class filter ignores
29079
+ * it: "a person crossed a line" is still a person (D549 20).
29080
+ */
29081
+ behaviours: array(string()).optional(),
29082
+ /**
29083
+ * The same recording as two files — the sub twin (what the row and its
29084
+ * thumbnail are) and its main twin, matched at listing time so a quality
29085
+ * change never re-searches the camera (D549 15). `getClipPlayback`'s
29086
+ * `profile` picks between them: `low | mid` → sub, `high` → main.
29087
+ */
29088
+ streams: object({
29089
+ sub: object({
29090
+ id: string(),
29091
+ bytes: number().optional()
29092
+ }).optional(),
29093
+ main: object({
29094
+ id: string(),
29095
+ bytes: number().optional()
29096
+ }).optional()
29097
+ }).optional(),
29098
+ /** The camera says it holds a sub-stream copy of this recording. */
29099
+ supportSub: boolean().optional(),
29100
+ /**
29101
+ * Whether this row has bytes behind it. ABSENT means yes — every clip that
29102
+ * IS a file is playable, and only a source that lists EVENTS can produce a
29103
+ * row with nothing to play (the measured case: 1 of 29 hub events on 3628
29104
+ * fell inside no file). Such a row is shown, never dropped and never offered
29105
+ * as playable-then-failing (D549 19).
29106
+ */
29107
+ playable: boolean().optional(),
29108
+ /** Why {@link playable} is false, verbatim (`no-file-for-window`). */
29109
+ unplayableReason: string().optional()
28944
29110
  });
28945
29111
  var ClipPlaybackSchema = object({
28946
- /** HLS master URL through the hub data-plane (Range + token in path). */
29112
+ /**
29113
+ * A media URL through the hub data-plane. {@link ClipPlaybackSchema.format}
29114
+ * says what kind — an HLS master playlist for a recording-derived clip, a
29115
+ * progressive MP4 for a native file the vendor addon muxed and serves with
29116
+ * `Range`. The URL is NOT a credential: both planes are registered
29117
+ * `access: 'authenticated'` and the hub's `/addon/<id>/<prefix>` proxy takes
29118
+ * the session cookie, so nothing is appended to it (D549 22).
29119
+ */
28947
29120
  playbackUrl: string(),
29121
+ /**
29122
+ * How to play {@link playbackUrl}. Absent means `hls` — the shape every
29123
+ * existing consumer already assumes. A player that branches on this is the
29124
+ * one change a native clip needs; a player that ignores it will hand an MP4
29125
+ * to hls.js and fail parsing it as a manifest.
29126
+ */
29127
+ format: _enum(["hls", "mp4"]).optional(),
29128
+ /**
29129
+ * Which twin was actually served. A clip that holds only one stream answers
29130
+ * with the one it has, and the surface SAYS so — a missing main twin is
29131
+ * never served silently as if it were the asked-for quality (D549 15).
29132
+ */
29133
+ served: CamProfileSchema.optional(),
28948
29134
  /** Optional LAN/remote alternates for the same clip. */
28949
29135
  playbackEndpoints: array(string()).optional(),
28950
29136
  token: string().optional()
28951
29137
  });
29138
+ /**
29139
+ * Why a source cannot answer right now — per SOURCE, never fleet-wide.
29140
+ *
29141
+ * `ok` is the only state whose clip list may be read as complete. The other
29142
+ * three exist because an empty list from a sleeping camera reads as "this
29143
+ * camera has no recordings", which is the defect this whole line of work is
29144
+ * about: a battery camera nobody woke (`sleeping`), a camera that could not be
29145
+ * reached at all (`unreachable`, also what a provider that THREW reports), a
29146
+ * camera whose SD card is not mounted (`no-storage`, measured on 640 —
29147
+ * `HddInfo mount 0`, honestly nothing to list rather than "no clips"), and a
29148
+ * camera whose OWN index disagrees with its OWN calendar (`index-empty`,
29149
+ * measured on 618: the calendar marks 3–20 September, days 6–20 list zero
29150
+ * files on both streams and both filters, with 177 GB free). That last one is
29151
+ * a defect ON THE CAMERA, and the only honest thing a provider can do is say
29152
+ * which days it asked for and got nothing — "no clips" would be a lie about a
29153
+ * card that is full of them.
29154
+ */
29155
+ var ClipSourceAvailabilitySchema = object({
29156
+ state: _enum([
29157
+ "ok",
29158
+ "sleeping",
29159
+ "unreachable",
29160
+ "no-storage",
29161
+ "index-empty"
29162
+ ]),
29163
+ /** Free text, shown verbatim. Names the camera's own refusal when there is one. */
29164
+ reason: string().optional(),
29165
+ /** When this source's catalog was last CONFIRMED. A cached list is never
29166
+ * drawn as current: the surface shows the age whenever it is older than the
29167
+ * refresh interval. */
29168
+ catalogAsOf: number().optional()
29169
+ });
29170
+ /**
29171
+ * One SOURCE of clips for a camera — a row of the picker, and the namespace
29172
+ * every clip id from it is prefixed with (`analytics`,
29173
+ * `native:reolink:onboard`, `hksv`, …).
29174
+ *
29175
+ * A provider lists the sources IT serves for that device, and answers for each
29176
+ * of them whether it can answer at all. A provider with nothing to offer on a
29177
+ * camera returns `[]` — it is not that camera's business.
29178
+ */
29179
+ var ClipSourceSchema = object({
29180
+ /** The value this source stamps on {@link ClipSchema.source}, and the prefix
29181
+ * of every clip id it mints. `getClipPlayback` routes on it. */
29182
+ source: string(),
29183
+ /** Operator-facing name of the source ("CamStack recordings", "SD card"). */
29184
+ label: string(),
29185
+ /**
29186
+ * The addon that SERVES this row.
29187
+ *
29188
+ * A surface cannot otherwise resolve a source to who answers it, and the
29189
+ * alternative — a `native:reolink:* → provider-reolink` table inside the
29190
+ * widget — is a second authority on provider identity living in the one
29191
+ * package with no business knowing it, wrong the day a third source appears
29192
+ * (D557). One addon may serve SEVERAL sources: `addon-provider-reolink`
29193
+ * answers a hub child with both `native:reolink:onboard` and
29194
+ * `native:reolink:hub`, which is why the per-device switch is keyed by
29195
+ * SOURCE and not by this (D555).
29196
+ *
29197
+ * Optional for version skew only. The collection dispatcher stamps it from
29198
+ * the registry, so a row that travelled through the fan-out carries the
29199
+ * authoritative id whatever the provider filled in.
29200
+ */
29201
+ addonId: string().optional(),
29202
+ /**
29203
+ * Which API this source resolved to FOR THIS CAMERA, when it has a choice.
29204
+ *
29205
+ * A source may cover one store through more than one surface — the Reolink
29206
+ * provider reads a hub child through the parent's event log and a standalone
29207
+ * through its own file list, because that is what each camera answers. The
29208
+ * CHOICE is the provider's, made from what the camera is, and is never a row
29209
+ * the operator has to understand; but it is REPORTED, because a source that
29210
+ * silently reads a different API on two cameras and then behaves differently
29211
+ * is the thing nobody can debug later. Absent when the source has only one
29212
+ * way to read its store.
29213
+ */
29214
+ via: string().optional(),
29215
+ availability: ClipSourceAvailabilitySchema,
29216
+ /**
29217
+ * The operator switched this source OFF for this camera.
29218
+ *
29219
+ * Deliberately NOT a member of {@link ClipSourceAvailabilitySchema}'s
29220
+ * vocabulary. That enum models what the source CAN do — a sleeping camera, an
29221
+ * unmounted card, an index that disagrees with its own calendar — and a
29222
+ * switched-off source could answer perfectly well; the operator decided it
29223
+ * should not. Folding the choice in is how `disabled` and `broken` stop being
29224
+ * distinguishable, which is the D62 rule this repo has already paid for twice:
29225
+ * an off switch is REPORTED off (`CameraStatus.switchedOff`, the same word),
29226
+ * and disabled must never look like broken. It is also what lets every
29227
+ * exhaustive consumer of the availability enum keep compiling.
29228
+ *
29229
+ * A switched-off source contributes NO clips (`listClips` never calls it) and
29230
+ * its row carries no `catalogAsOf`: nothing confirms a catalog it is not
29231
+ * allowed to serve, and a frozen age that can only grow draws a stalling
29232
+ * source rather than an off switch.
29233
+ *
29234
+ * The row survives BECAUSE it is the control the operator switches the source
29235
+ * back on from — D554 decision 4's rule ("a source that cannot answer
29236
+ * produces a ROW, not an absence") applied to the one case D556 carved out of
29237
+ * it, and D557's own kept property ("a source is never hidden, only its
29238
+ * rows"). Absent means on.
29239
+ *
29240
+ * A provider never sets this — like {@link ClipSourceSchema.addonId} it is
29241
+ * stamped by the collection dispatcher, which holds the registry's projection
29242
+ * of the persisted authority (D556) and is the only place that knows it.
29243
+ */
29244
+ switchedOff: boolean().optional()
29245
+ });
28952
29246
  var videoclipsCapability = {
28953
29247
  name: "videoclips",
28954
29248
  scope: "device",
28955
- mode: "singleton",
29249
+ mode: "collection",
28956
29250
  kind: "wrapper",
28957
29251
  defaultActive: true,
28958
29252
  /** A clip is a window over a camera's footage — the cap is meaningless on a
28959
29253
  * sensor, a button or an event emitter, and the `defaultActive` auto-bind
28960
29254
  * reads this to decide which devices it may claim. */
28961
29255
  deviceTypes: [DeviceType.Camera],
29256
+ /**
29257
+ * The Clips section of a camera's device details is FRAMEWORK-DERIVED (D14):
29258
+ * the aggregator turns this declaration into the `type:'widget'` section and
29259
+ * `DeviceDetail.tsx` is never edited. `videoclips` is the first WRAPPER cap
29260
+ * to declare one — every previous `host/` widget cap is `deviceNative` — so
29261
+ * `device-config-widget-wrapped-binding.spec.ts` pins that a `kind:'wrapped'`
29262
+ * binding entry derives the same section a native one does.
29263
+ *
29264
+ * **It is a SECTION of the Recording tab, at the end of it — not a tab of
29265
+ * its own.** It shipped as a `clips` top-tab and the operator rejected the
29266
+ * placement: *"utilizzerei la stessa tab recordings, lì abbiamo già tutto il
29267
+ * necessario, una nuova sezione alla fine per le clips"*. The Recording tab
29268
+ * already holds the recorder's panel, the schedule bands and the unified
29269
+ * retention policy; footage the camera itself holds is the same question,
29270
+ * asked of a different store. `order: 100` puts it after all of them with
29271
+ * room left in front. The `clips` entry in `WELL_KNOWN_TABS` went with it —
29272
+ * a well-known id nobody declares is an invitation to mint the tab again.
29273
+ *
29274
+ * `topTab` stays: the browser owns a pane (a day's tiles, a source list and
29275
+ * a player) and the Config tab's inner bar has no room for one. The widget
29276
+ * itself is `host/clips-browser` in ui-library's `HOST_WIDGETS`, and because
29277
+ * the admin Recordings page renders every `location:'top-tab'` +
29278
+ * `tab:'recording'` section behind its camera picker
29279
+ * (`CameraRecordingSettingsSection`), this declaration lands the section on
29280
+ * BOTH surfaces with no second wiring.
29281
+ */
29282
+ deviceConfig: { ui: {
29283
+ kind: "widget",
29284
+ widgetId: "host/clips-browser",
29285
+ tab: "recording",
29286
+ topTab: true,
29287
+ label: "Clips",
29288
+ order: 100
29289
+ } },
28962
29290
  methods: {
28963
29291
  listClips: method(object({
28964
29292
  deviceId: number(),
28965
29293
  since: number(),
28966
29294
  until: number(),
28967
- limit: number().int().positive().optional()
29295
+ limit: number().int().positive().optional(),
29296
+ /**
29297
+ * WHICH provider to ask — the `addonId` a {@link ClipSourceSchema} row
29298
+ * carries, never a source id and never a list.
29299
+ *
29300
+ * Absent means the device's BOUND provider, which is CamStack on every
29301
+ * camera today because that is what `deviceManager.getBindings`
29302
+ * answers with. A provider the device is not bound to is refused by
29303
+ * name rather than answered by another one (D552's
29304
+ * `rejectUnresolvedAddonPin` rule).
29305
+ *
29306
+ * It replaced `sources?: string[]`, a VIEW filter over source ids that
29307
+ * assumed the answer was a fan-out over everything a camera has. The
29308
+ * operator settled otherwise on 2026-09-20 — *"il get videoclips
29309
+ * prendere un provider opzionale, di default va su camstack"*,
29310
+ * *"l'utilizzatore è uno solo"* — so the list is asked of one provider
29311
+ * at a time and there is nothing to filter out of it.
29312
+ */
29313
+ provider: string().optional()
28968
29314
  }), array(ClipSchema).readonly(), {
28969
29315
  kind: "query",
28970
- auth: "admin"
29316
+ auth: "protected"
29317
+ }),
29318
+ /**
29319
+ * The sources this camera has, WITH the reason any of them cannot answer.
29320
+ *
29321
+ * Asked separately from `listClips` because an empty clip list is
29322
+ * ambiguous and this is the only place the ambiguity is resolved: every
29323
+ * bound provider contributes its own rows, and a provider that could not
29324
+ * be reached at all still produces one row saying so. A surface that draws
29325
+ * "no clips" without reading this is drawing a guess.
29326
+ */
29327
+ listSources: method(object({ deviceId: number() }), array(ClipSourceSchema).readonly(), {
29328
+ kind: "query",
29329
+ auth: "protected"
28971
29330
  }),
28972
29331
  getClipPlayback: method(object({
28973
29332
  deviceId: number(),
28974
- clipId: string()
29333
+ clipId: string(),
29334
+ /**
29335
+ * Which twin to serve, on the ONE quality scale the system already has
29336
+ * (`CamProfileSchema`). `low | mid` → the sub file, `high` → the main
29337
+ * twin; both ids are already on the row so this never re-searches the
29338
+ * camera. Absent means the provider's own default (the sub file, which
29339
+ * every source is measured to hold).
29340
+ *
29341
+ * `auto` is deliberately NOT accepted here: a stored file has no
29342
+ * broker session, so the adaptive tier cannot be resolved for it. The
29343
+ * viewer resolves `auto` to a profile the same way live does, before
29344
+ * it calls (D549 15).
29345
+ */
29346
+ profile: CamProfileSchema.optional()
28975
29347
  }), ClipPlaybackSchema, {
28976
29348
  kind: "query",
28977
- auth: "admin"
29349
+ auth: "protected"
28978
29350
  })
28979
29351
  }
28980
29352
  };
@@ -47068,6 +47440,12 @@ Object.freeze({
47068
47440
  addonId: null,
47069
47441
  access: "view"
47070
47442
  },
47443
+ "videoclips.listSources": {
47444
+ capName: "videoclips",
47445
+ capScope: "device",
47446
+ addonId: null,
47447
+ access: "view"
47448
+ },
47071
47449
  "viewerUi.getStaticDir": {
47072
47450
  capName: "viewer-ui",
47073
47451
  capScope: "system",
@@ -49076,6 +49454,11 @@ Object.freeze({
49076
49454
  form: "single",
49077
49455
  optional: false
49078
49456
  }],
49457
+ "videoclips.listSources": [{
49458
+ name: "deviceId",
49459
+ form: "single",
49460
+ optional: false
49461
+ }],
49079
49462
  "waterHeater.setAway": [{
49080
49463
  name: "deviceId",
49081
49464
  form: "single",
@@ -1,5 +1,5 @@
1
1
  import { h as e, l as t, u as n, y as r } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-Bs1t18EM.mjs";
2
- import { o as i, s as a } from "./responsive-BJ6OUcwu.mjs";
2
+ import { o as i, s as a } from "./cap-error-DC-GOnm5.mjs";
3
3
  import { n as o, r as s, t as c } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react_mf_1_jsx_mf_2_runtime__loadShare__.js-DalfdIDw.mjs";
4
4
  var l = a("chevron-down", [["path", {
5
5
  d: "m6 9 6 6 6-6",
@@ -1,2 +1,2 @@
1
- import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-BYA-5ZRu.mjs";
1
+ import { n as e, t } from "./virtual_mf-REMOTE_ENTRY_ID___mfe_internal__addon_osd_manager_page__remoteEntry_js-B0w_cAoJ.mjs";
2
2
  export { t as get, e as init };
@@ -1,5 +1,5 @@
1
1
  import { c as e, h as t, p as n, y as r } from "./_virtual_mf___mfe_internal__addon_osd_manager_page__loadShare__react__loadShare__.js-Bs1t18EM.mjs";
2
- import { s as i } from "./responsive-BJ6OUcwu.mjs";
2
+ import { s as i } from "./cap-error-DC-GOnm5.mjs";
3
3
  var a = i("camera", [["path", {
4
4
  d: "M13.997 4a2 2 0 0 1 1.76 1.05l.486.9A2 2 0 0 0 18.003 7H20a2 2 0 0 1 2 2v9a2 2 0 0 1-2 2H4a2 2 0 0 1-2-2V9a2 2 0 0 1 2-2h1.997a2 2 0 0 0 1.759-1.048l.489-.904A2 2 0 0 1 10.004 4z",
5
5
  key: "18u6gg"
@@ -1,4 +1,4 @@
1
- import { s as e } from "./responsive-BJ6OUcwu.mjs";
1
+ import { s as e } from "./cap-error-DC-GOnm5.mjs";
2
2
  var t = e("eye-off", [
3
3
  ["path", {
4
4
  d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49",
@@ -1,4 +1,4 @@
1
- import { s as e } from "./responsive-BJ6OUcwu.mjs";
1
+ import { s as e } from "./cap-error-DC-GOnm5.mjs";
2
2
  var t = e("trash-2", [
3
3
  ["path", {
4
4
  d: "M10 11v6",
@@ -2753,7 +2753,7 @@ async function rr(e) {
2753
2753
  }
2754
2754
  }
2755
2755
  async function ir() {
2756
- return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-BUn-8ukN.mjs")).catch((e) => {
2756
+ return tr ||= rr(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_osd_manager_page-Co7z8wQJ.mjs")).catch((e) => {
2757
2757
  throw tr = void 0, e;
2758
2758
  }), tr;
2759
2759
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-osd-manager",
3
- "version": "0.1.123",
3
+ "version": "0.1.125",
4
4
  "description": "Binds camera on-screen-display slots to live state and recognitions",
5
5
  "keywords": [
6
6
  "camstack",