@camstack/addon-provider-rademacher 0.2.76 → 0.2.78

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 (3) hide show
  1. package/dist/addon.js +158 -141
  2. package/dist/addon.mjs +158 -141
  3. package/package.json +1 -1
package/dist/addon.js CHANGED
@@ -8600,111 +8600,6 @@ var CameraSwitchGroupSchema = object({
8600
8600
  fetchedAt: number()
8601
8601
  });
8602
8602
  /**
8603
- * Per-component log CHANNELS — the gate a hot path consults, and the registry
8604
- * an addon declares its channels in.
8605
- *
8606
- * ## Two axes, deliberately separated
8607
- *
8608
- * - **DECLARATION** — which channels exist. Only the addon knows:
8609
- * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8610
- * baichuan/handshake. A hand-wired central list rots at the first addition,
8611
- * and rots silently. So a channel is declared where it is consulted, and the
8612
- * `log-channels` capability enumerates the declarations.
8613
- * - **VALUE** — at which level, for which scope, until when. That stays ONE
8614
- * thing: the logging settings document on the `system` cap. Two authorities
8615
- * over the values is the exact defect
8616
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8617
- * remove; re-introducing it from the cure side would be grotesque.
8618
- *
8619
- * Nothing in this file reads a clock, an env var or a store. The registry is
8620
- * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8621
- * the hot path with a value somebody actually read, and by
8622
- * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8623
- * never reaches here, so it can neither disarm an armed channel nor arm a
8624
- * disarmed one (D49).
8625
- *
8626
- * ## The canonical call shape
8627
- *
8628
- * ```ts
8629
- * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8630
- * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8631
- * }
8632
- * ```
8633
- *
8634
- * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8635
- * read. Disarmed, a call site costs one load and one branch, and the `extras`
8636
- * object literal is never constructed because it lives inside the branch. It
8637
- * is the same shape already proven in production at `stream-broker.ts:1650`,
8638
- * and the same discipline `LoggingGate.allowsDestination` uses for the
8639
- * destination floor (measured at 1.93 ns/call when off).
8640
- *
8641
- * ## Why a channel emits at `info`
8642
- *
8643
- * `loki-logging.addon.ts` pins the destination default at `info` and
8644
- * `loki-destination.ts` drops everything below it, so a line emitted at
8645
- * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8646
- * minutes. A diagnostic that cannot be read an hour later is worse than no
8647
- * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8648
- * emits at the channel's declared level, whose schema floor is `info`.
8649
- */
8650
- /**
8651
- * The level a channel writes at once armed.
8652
- *
8653
- * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8654
- * not leave the process for Loki, and the whole point of arming a channel is
8655
- * to read it later.
8656
- */
8657
- var LogChannelLevelSchema = _enum([
8658
- "info",
8659
- "warn",
8660
- "error"
8661
- ]);
8662
- /**
8663
- * What an addon declares about one channel. No value, no state — a
8664
- * declaration is inert.
8665
- */
8666
- var LogChannelDescriptorSchema = object({
8667
- /**
8668
- * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8669
- * the addon's short name so an operator reading a channel list can tell who
8670
- * owns it without a second lookup.
8671
- */
8672
- name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8673
- /** One sentence: what the operator will SEE after arming it. */
8674
- description: string().min(1),
8675
- /** The level its lines are emitted at. Never below `info`. */
8676
- defaultLevel: LogChannelLevelSchema,
8677
- /**
8678
- * Whether this channel can be narrowed to a camera.
8679
- *
8680
- * `true` is a PROMISE with two halves, and both must hold: the gate is
8681
- * consulted with the numeric device id, AND every line the channel admits
8682
- * carries `tags: { deviceId }` with that same numeric id. The second half is
8683
- * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
8684
- * keeps `deviceId` out of the stream labels for cardinality, so the tag in
8685
- * the body is the only way to filter.
8686
- *
8687
- * A channel whose lines carry the device only in `meta` (or not at all) is
8688
- * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
8689
- * the operator narrows to one camera, sees nothing, and concludes the code
8690
- * path was never taken.
8691
- */
8692
- perDevice: boolean()
8693
- });
8694
- /**
8695
- * An armed window over one channel, as the document hands it to a mirror.
8696
- *
8697
- * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
8698
- * expires by itself, which is the one failure a boolean cannot avoid.
8699
- */
8700
- var LogChannelWindowSchema = object({
8701
- channel: string().min(1),
8702
- /** Epoch ms the window closes at. */
8703
- armedUntilMs: number(),
8704
- /** `null` = every camera. A non-empty list narrows to those numeric ids. */
8705
- deviceIds: array(number().int()).readonly().nullable()
8706
- });
8707
- /**
8708
8603
  * Ops-log — the durable, append-only operations audit shared by the
8709
8604
  * recordings and events management surfaces.
8710
8605
  *
@@ -9650,8 +9545,11 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
9650
9545
  * `STORAGE_LOCATION_CARDINALITY` map has been removed.
9651
9546
  *
9652
9547
  * `id` is a stable namespaced string of the form `<type>:<slug>`.
9653
- * The default location for a type uses `id === <type>:default` by
9654
- * convention (the bare type ref like `'backups'` resolves to it).
9548
+ * The seed names its first instance `<type>:default` — a NAME, not a flag.
9549
+ * There is no default location any more (D383): `enabled` is the whole write
9550
+ * model, and a bare type ref resolves to the sole location of the type, or —
9551
+ * transitionally, only while legacy NULL-stamped rows exist — to the row whose
9552
+ * slug is `default`.
9655
9553
  *
9656
9554
  * `isSystem` is a legacy persisted flag. Seed still creates the initial
9657
9555
  * `<type>:default` locations; the flag is no longer a lock, a badge, or a
@@ -9672,21 +9570,20 @@ var StorageLocationSchema = object({
9672
9570
  * flag at upsert time, not here (the schema is provider-agnostic).
9673
9571
  */
9674
9572
  nodeId: string().optional(),
9675
- isDefault: boolean().default(false),
9676
9573
  isSystem: boolean().default(false),
9677
9574
  /**
9678
- * Operator opt-in: whether consumers that BALANCE across several locations
9679
- * of a type may write here. Recordings reads it today; event media and
9680
- * backups are the next consumers, which is why the flag lives on the
9681
- * location rather than in any one addon's store — nothing has to be
9682
- * extended to add the next consumer.
9575
+ * THE write switch, and the only one (D383). `enabled: true` means every
9576
+ * consumer that chooses a write target for this type may write here, and all
9577
+ * enabled locations of a type are used TOGETHER; `false` means read-only —
9578
+ * still read, still played back, still age-swept, still drained, never
9579
+ * written.
9683
9580
  *
9684
- * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
9685
- * flag existed reads back with no flag and keeps working exactly as before;
9686
- * that is the whole compat story, and it is why no migration ships with it.
9687
- * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
9688
- * disk must not silently start writing to it); the default of a type is
9689
- * always stamped `true`.
9581
+ * OPTIONAL only for the wire: an upsert that omits it means "leave what is
9582
+ * stored" on an update and "born inert unless it is the first location of its
9583
+ * type" on a create. On a PERSISTED row absence is legacy and it means
9584
+ * enabled — {@link isLocationEnabled} is the one place that says so, and the
9585
+ * orchestrator stamps every flagless row `true` once at hydrate so absence
9586
+ * stops existing rather than being re-derived on every read.
9690
9587
  */
9691
9588
  enabled: boolean().optional(),
9692
9589
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
@@ -9699,10 +9596,12 @@ var StorageLocationSchema = object({
9699
9596
  createdAt: number(),
9700
9597
  updatedAt: number()
9701
9598
  });
9599
+ object({ isDefault: boolean().optional() });
9702
9600
  /**
9703
9601
  * Reference accepted by consumer-facing `api.storage.*` calls.
9704
9602
  * Either:
9705
- * - a `StorageLocationType` (e.g. `'backups'`) → orchestrator resolves to the default of that type
9603
+ * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
9604
+ * (transitionally, the `<type>:default`-slugged row when several exist)
9706
9605
  * - a fully-qualified id (e.g. `'backups:nas-01'`) → addresses a specific instance
9707
9606
  *
9708
9607
  * The orchestrator's `resolveRef(ref)` handles both cases.
@@ -9878,6 +9777,111 @@ var DecoderSessionConfigSchema = object({
9878
9777
  */
9879
9778
  debug: boolean().optional()
9880
9779
  });
9780
+ /**
9781
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
9782
+ * an addon declares its channels in.
9783
+ *
9784
+ * ## Two axes, deliberately separated
9785
+ *
9786
+ * - **DECLARATION** — which channels exist. Only the addon knows:
9787
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
9788
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
9789
+ * and rots silently. So a channel is declared where it is consulted, and the
9790
+ * `log-channels` capability enumerates the declarations.
9791
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
9792
+ * thing: the logging settings document on the `system` cap. Two authorities
9793
+ * over the values is the exact defect
9794
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
9795
+ * remove; re-introducing it from the cure side would be grotesque.
9796
+ *
9797
+ * Nothing in this file reads a clock, an env var or a store. The registry is
9798
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
9799
+ * the hot path with a value somebody actually read, and by
9800
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
9801
+ * never reaches here, so it can neither disarm an armed channel nor arm a
9802
+ * disarmed one (D49).
9803
+ *
9804
+ * ## The canonical call shape
9805
+ *
9806
+ * ```ts
9807
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
9808
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
9809
+ * }
9810
+ * ```
9811
+ *
9812
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
9813
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
9814
+ * object literal is never constructed because it lives inside the branch. It
9815
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
9816
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
9817
+ * destination floor (measured at 1.93 ns/call when off).
9818
+ *
9819
+ * ## Why a channel emits at `info`
9820
+ *
9821
+ * `loki-logging.addon.ts` pins the destination default at `info` and
9822
+ * `loki-destination.ts` drops everything below it, so a line emitted at
9823
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
9824
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
9825
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
9826
+ * emits at the channel's declared level, whose schema floor is `info`.
9827
+ */
9828
+ /**
9829
+ * The level a channel writes at once armed.
9830
+ *
9831
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
9832
+ * not leave the process for Loki, and the whole point of arming a channel is
9833
+ * to read it later.
9834
+ */
9835
+ var LogChannelLevelSchema = _enum([
9836
+ "info",
9837
+ "warn",
9838
+ "error"
9839
+ ]);
9840
+ /**
9841
+ * What an addon declares about one channel. No value, no state — a
9842
+ * declaration is inert.
9843
+ */
9844
+ var LogChannelDescriptorSchema = object({
9845
+ /**
9846
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
9847
+ * the addon's short name so an operator reading a channel list can tell who
9848
+ * owns it without a second lookup.
9849
+ */
9850
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
9851
+ /** One sentence: what the operator will SEE after arming it. */
9852
+ description: string().min(1),
9853
+ /** The level its lines are emitted at. Never below `info`. */
9854
+ defaultLevel: LogChannelLevelSchema,
9855
+ /**
9856
+ * Whether this channel can be narrowed to a camera.
9857
+ *
9858
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
9859
+ * consulted with the numeric device id, AND every line the channel admits
9860
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
9861
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
9862
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
9863
+ * the body is the only way to filter.
9864
+ *
9865
+ * A channel whose lines carry the device only in `meta` (or not at all) is
9866
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
9867
+ * the operator narrows to one camera, sees nothing, and concludes the code
9868
+ * path was never taken.
9869
+ */
9870
+ perDevice: boolean()
9871
+ });
9872
+ /**
9873
+ * An armed window over one channel, as the document hands it to a mirror.
9874
+ *
9875
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
9876
+ * expires by itself, which is the one failure a boolean cannot avoid.
9877
+ */
9878
+ var LogChannelWindowSchema = object({
9879
+ channel: string().min(1),
9880
+ /** Epoch ms the window closes at. */
9881
+ armedUntilMs: number(),
9882
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
9883
+ deviceIds: array(number().int()).readonly().nullable()
9884
+ });
9881
9885
  var MODEL_FORMATS = [
9882
9886
  "onnx",
9883
9887
  "coreml",
@@ -11534,12 +11538,30 @@ var BackupDestinationInfoSchema = object({
11534
11538
  lastSuccessAt: number().optional(),
11535
11539
  /** Newest-archive size from `manifests.json`, or undefined. */
11536
11540
  lastSuccessSizeBytes: number().optional(),
11537
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
11541
+ /**
11542
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
11543
+ * destination, comma-joined. Absent when no enabled schedule targets it
11544
+ * — a destination nothing is scheduled to write to must not advertise a
11545
+ * cadence (D384). This is never the `backup_destination_policies.cron`
11546
+ * column: that per-location cron has scheduled nothing since 2026-07-28
11547
+ * and reading it made a destination with a DISABLED schedule claim a
11548
+ * nightly run.
11549
+ */
11538
11550
  cron: string().optional(),
11539
- /** ms-epoch of next computed firing for this destination's cron, if any. */
11551
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
11540
11552
  nextRunAt: number().optional(),
11541
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
11542
- lastRunAt: number().optional()
11553
+ /**
11554
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
11555
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
11556
+ * newest archive that actually landed) and `lastError`.
11557
+ */
11558
+ lastAttemptAt: number().optional(),
11559
+ /**
11560
+ * Why the last attempt failed, verbatim. Absent when the last attempt
11561
+ * landed the archive. A destination that has never been written to has
11562
+ * neither this nor `lastAttemptAt`.
11563
+ */
11564
+ lastError: string().optional()
11543
11565
  });
11544
11566
  /**
11545
11567
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -11702,8 +11724,16 @@ var BackupScheduleSchema = object({
11702
11724
  retentionCount: number().int().min(1).max(1e3),
11703
11725
  /** Optional subset of source locations to include; omitted = all. */
11704
11726
  dataSources: array(string()).readonly().optional(),
11705
- /** ms-epoch of last successful run. */
11706
- lastRunAt: number().optional(),
11727
+ /**
11728
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
11729
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
11730
+ * "succeeded" — a run refused by every destination stamps it too.
11731
+ */
11732
+ lastAttemptAt: number().optional(),
11733
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
11734
+ lastSuccessAt: number().optional(),
11735
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
11736
+ lastError: string().optional(),
11707
11737
  /** ms-epoch of next computed firing (read-only, filled on list). */
11708
11738
  nextRunAt: number().optional()
11709
11739
  });
@@ -11752,14 +11782,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11752
11782
  locationId: string(),
11753
11783
  enabled: boolean(),
11754
11784
  retentionCount: number().int().min(1).max(1e3),
11755
- label: string().optional(),
11756
- /**
11757
- * Per-destination cron expression. Empty string clears the
11758
- * schedule (manual-only). Validated server-side via croner;
11759
- * malformed expressions reject the upsert with an actionable
11760
- * message.
11761
- */
11762
- cron: string().optional()
11785
+ label: string().optional()
11763
11786
  }), _void(), {
11764
11787
  kind: "mutation",
11765
11788
  auth: "admin"
@@ -22891,7 +22914,7 @@ method(object({
22891
22914
  downloadId: string(),
22892
22915
  offset: number(),
22893
22916
  length: number()
22894
- }), _instanceof(Uint8Array)), method(object({ downloadId: string() }), _void(), { kind: "mutation" }), method(object({ type: StorageLocationTypeSchema.optional() }), array(StorageLocationSchema).readonly()), method(object({ type: StorageLocationTypeSchema }), StorageLocationSchema.nullable()), method(_void(), array(StorageLocationDeclarationSchema).readonly()), method(StorageLocationSchema.omit({
22917
+ }), _instanceof(Uint8Array)), method(object({ downloadId: string() }), _void(), { kind: "mutation" }), method(object({ type: StorageLocationTypeSchema.optional() }), array(StorageLocationSchema).readonly()), method(_void(), array(StorageLocationDeclarationSchema).readonly()), method(StorageLocationSchema.omit({
22895
22918
  createdAt: true,
22896
22919
  updatedAt: true
22897
22920
  }), StorageLocationSchema, {
@@ -39736,12 +39759,6 @@ Object.freeze({
39736
39759
  addonId: null,
39737
39760
  access: "view"
39738
39761
  },
39739
- "storage.getDefaultLocation": {
39740
- capName: "storage",
39741
- capScope: "system",
39742
- addonId: null,
39743
- access: "view"
39744
- },
39745
39762
  "storage.list": {
39746
39763
  capName: "storage",
39747
39764
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -8599,111 +8599,6 @@ var CameraSwitchGroupSchema = object({
8599
8599
  fetchedAt: number()
8600
8600
  });
8601
8601
  /**
8602
- * Per-component log CHANNELS — the gate a hot path consults, and the registry
8603
- * an addon declares its channels in.
8604
- *
8605
- * ## Two axes, deliberately separated
8606
- *
8607
- * - **DECLARATION** — which channels exist. Only the addon knows:
8608
- * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8609
- * baichuan/handshake. A hand-wired central list rots at the first addition,
8610
- * and rots silently. So a channel is declared where it is consulted, and the
8611
- * `log-channels` capability enumerates the declarations.
8612
- * - **VALUE** — at which level, for which scope, until when. That stays ONE
8613
- * thing: the logging settings document on the `system` cap. Two authorities
8614
- * over the values is the exact defect
8615
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8616
- * remove; re-introducing it from the cure side would be grotesque.
8617
- *
8618
- * Nothing in this file reads a clock, an env var or a store. The registry is
8619
- * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8620
- * the hot path with a value somebody actually read, and by
8621
- * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8622
- * never reaches here, so it can neither disarm an armed channel nor arm a
8623
- * disarmed one (D49).
8624
- *
8625
- * ## The canonical call shape
8626
- *
8627
- * ```ts
8628
- * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8629
- * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8630
- * }
8631
- * ```
8632
- *
8633
- * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8634
- * read. Disarmed, a call site costs one load and one branch, and the `extras`
8635
- * object literal is never constructed because it lives inside the branch. It
8636
- * is the same shape already proven in production at `stream-broker.ts:1650`,
8637
- * and the same discipline `LoggingGate.allowsDestination` uses for the
8638
- * destination floor (measured at 1.93 ns/call when off).
8639
- *
8640
- * ## Why a channel emits at `info`
8641
- *
8642
- * `loki-logging.addon.ts` pins the destination default at `info` and
8643
- * `loki-destination.ts` drops everything below it, so a line emitted at
8644
- * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8645
- * minutes. A diagnostic that cannot be read an hour later is worse than no
8646
- * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8647
- * emits at the channel's declared level, whose schema floor is `info`.
8648
- */
8649
- /**
8650
- * The level a channel writes at once armed.
8651
- *
8652
- * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8653
- * not leave the process for Loki, and the whole point of arming a channel is
8654
- * to read it later.
8655
- */
8656
- var LogChannelLevelSchema = _enum([
8657
- "info",
8658
- "warn",
8659
- "error"
8660
- ]);
8661
- /**
8662
- * What an addon declares about one channel. No value, no state — a
8663
- * declaration is inert.
8664
- */
8665
- var LogChannelDescriptorSchema = object({
8666
- /**
8667
- * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8668
- * the addon's short name so an operator reading a channel list can tell who
8669
- * owns it without a second lookup.
8670
- */
8671
- name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8672
- /** One sentence: what the operator will SEE after arming it. */
8673
- description: string().min(1),
8674
- /** The level its lines are emitted at. Never below `info`. */
8675
- defaultLevel: LogChannelLevelSchema,
8676
- /**
8677
- * Whether this channel can be narrowed to a camera.
8678
- *
8679
- * `true` is a PROMISE with two halves, and both must hold: the gate is
8680
- * consulted with the numeric device id, AND every line the channel admits
8681
- * carries `tags: { deviceId }` with that same numeric id. The second half is
8682
- * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
8683
- * keeps `deviceId` out of the stream labels for cardinality, so the tag in
8684
- * the body is the only way to filter.
8685
- *
8686
- * A channel whose lines carry the device only in `meta` (or not at all) is
8687
- * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
8688
- * the operator narrows to one camera, sees nothing, and concludes the code
8689
- * path was never taken.
8690
- */
8691
- perDevice: boolean()
8692
- });
8693
- /**
8694
- * An armed window over one channel, as the document hands it to a mirror.
8695
- *
8696
- * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
8697
- * expires by itself, which is the one failure a boolean cannot avoid.
8698
- */
8699
- var LogChannelWindowSchema = object({
8700
- channel: string().min(1),
8701
- /** Epoch ms the window closes at. */
8702
- armedUntilMs: number(),
8703
- /** `null` = every camera. A non-empty list narrows to those numeric ids. */
8704
- deviceIds: array(number().int()).readonly().nullable()
8705
- });
8706
- /**
8707
8602
  * Ops-log — the durable, append-only operations audit shared by the
8708
8603
  * recordings and events management surfaces.
8709
8604
  *
@@ -9649,8 +9544,11 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
9649
9544
  * `STORAGE_LOCATION_CARDINALITY` map has been removed.
9650
9545
  *
9651
9546
  * `id` is a stable namespaced string of the form `<type>:<slug>`.
9652
- * The default location for a type uses `id === <type>:default` by
9653
- * convention (the bare type ref like `'backups'` resolves to it).
9547
+ * The seed names its first instance `<type>:default` — a NAME, not a flag.
9548
+ * There is no default location any more (D383): `enabled` is the whole write
9549
+ * model, and a bare type ref resolves to the sole location of the type, or —
9550
+ * transitionally, only while legacy NULL-stamped rows exist — to the row whose
9551
+ * slug is `default`.
9654
9552
  *
9655
9553
  * `isSystem` is a legacy persisted flag. Seed still creates the initial
9656
9554
  * `<type>:default` locations; the flag is no longer a lock, a badge, or a
@@ -9671,21 +9569,20 @@ var StorageLocationSchema = object({
9671
9569
  * flag at upsert time, not here (the schema is provider-agnostic).
9672
9570
  */
9673
9571
  nodeId: string().optional(),
9674
- isDefault: boolean().default(false),
9675
9572
  isSystem: boolean().default(false),
9676
9573
  /**
9677
- * Operator opt-in: whether consumers that BALANCE across several locations
9678
- * of a type may write here. Recordings reads it today; event media and
9679
- * backups are the next consumers, which is why the flag lives on the
9680
- * location rather than in any one addon's store — nothing has to be
9681
- * extended to add the next consumer.
9574
+ * THE write switch, and the only one (D383). `enabled: true` means every
9575
+ * consumer that chooses a write target for this type may write here, and all
9576
+ * enabled locations of a type are used TOGETHER; `false` means read-only —
9577
+ * still read, still played back, still age-swept, still drained, never
9578
+ * written.
9682
9579
  *
9683
- * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
9684
- * flag existed reads back with no flag and keeps working exactly as before;
9685
- * that is the whole compat story, and it is why no migration ships with it.
9686
- * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
9687
- * disk must not silently start writing to it); the default of a type is
9688
- * always stamped `true`.
9580
+ * OPTIONAL only for the wire: an upsert that omits it means "leave what is
9581
+ * stored" on an update and "born inert unless it is the first location of its
9582
+ * type" on a create. On a PERSISTED row absence is legacy and it means
9583
+ * enabled — {@link isLocationEnabled} is the one place that says so, and the
9584
+ * orchestrator stamps every flagless row `true` once at hydrate so absence
9585
+ * stops existing rather than being re-derived on every read.
9689
9586
  */
9690
9587
  enabled: boolean().optional(),
9691
9588
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
@@ -9698,10 +9595,12 @@ var StorageLocationSchema = object({
9698
9595
  createdAt: number(),
9699
9596
  updatedAt: number()
9700
9597
  });
9598
+ object({ isDefault: boolean().optional() });
9701
9599
  /**
9702
9600
  * Reference accepted by consumer-facing `api.storage.*` calls.
9703
9601
  * Either:
9704
- * - a `StorageLocationType` (e.g. `'backups'`) → orchestrator resolves to the default of that type
9602
+ * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
9603
+ * (transitionally, the `<type>:default`-slugged row when several exist)
9705
9604
  * - a fully-qualified id (e.g. `'backups:nas-01'`) → addresses a specific instance
9706
9605
  *
9707
9606
  * The orchestrator's `resolveRef(ref)` handles both cases.
@@ -9877,6 +9776,111 @@ var DecoderSessionConfigSchema = object({
9877
9776
  */
9878
9777
  debug: boolean().optional()
9879
9778
  });
9779
+ /**
9780
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
9781
+ * an addon declares its channels in.
9782
+ *
9783
+ * ## Two axes, deliberately separated
9784
+ *
9785
+ * - **DECLARATION** — which channels exist. Only the addon knows:
9786
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
9787
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
9788
+ * and rots silently. So a channel is declared where it is consulted, and the
9789
+ * `log-channels` capability enumerates the declarations.
9790
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
9791
+ * thing: the logging settings document on the `system` cap. Two authorities
9792
+ * over the values is the exact defect
9793
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
9794
+ * remove; re-introducing it from the cure side would be grotesque.
9795
+ *
9796
+ * Nothing in this file reads a clock, an env var or a store. The registry is
9797
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
9798
+ * the hot path with a value somebody actually read, and by
9799
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
9800
+ * never reaches here, so it can neither disarm an armed channel nor arm a
9801
+ * disarmed one (D49).
9802
+ *
9803
+ * ## The canonical call shape
9804
+ *
9805
+ * ```ts
9806
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
9807
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
9808
+ * }
9809
+ * ```
9810
+ *
9811
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
9812
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
9813
+ * object literal is never constructed because it lives inside the branch. It
9814
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
9815
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
9816
+ * destination floor (measured at 1.93 ns/call when off).
9817
+ *
9818
+ * ## Why a channel emits at `info`
9819
+ *
9820
+ * `loki-logging.addon.ts` pins the destination default at `info` and
9821
+ * `loki-destination.ts` drops everything below it, so a line emitted at
9822
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
9823
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
9824
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
9825
+ * emits at the channel's declared level, whose schema floor is `info`.
9826
+ */
9827
+ /**
9828
+ * The level a channel writes at once armed.
9829
+ *
9830
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
9831
+ * not leave the process for Loki, and the whole point of arming a channel is
9832
+ * to read it later.
9833
+ */
9834
+ var LogChannelLevelSchema = _enum([
9835
+ "info",
9836
+ "warn",
9837
+ "error"
9838
+ ]);
9839
+ /**
9840
+ * What an addon declares about one channel. No value, no state — a
9841
+ * declaration is inert.
9842
+ */
9843
+ var LogChannelDescriptorSchema = object({
9844
+ /**
9845
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
9846
+ * the addon's short name so an operator reading a channel list can tell who
9847
+ * owns it without a second lookup.
9848
+ */
9849
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
9850
+ /** One sentence: what the operator will SEE after arming it. */
9851
+ description: string().min(1),
9852
+ /** The level its lines are emitted at. Never below `info`. */
9853
+ defaultLevel: LogChannelLevelSchema,
9854
+ /**
9855
+ * Whether this channel can be narrowed to a camera.
9856
+ *
9857
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
9858
+ * consulted with the numeric device id, AND every line the channel admits
9859
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
9860
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
9861
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
9862
+ * the body is the only way to filter.
9863
+ *
9864
+ * A channel whose lines carry the device only in `meta` (or not at all) is
9865
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
9866
+ * the operator narrows to one camera, sees nothing, and concludes the code
9867
+ * path was never taken.
9868
+ */
9869
+ perDevice: boolean()
9870
+ });
9871
+ /**
9872
+ * An armed window over one channel, as the document hands it to a mirror.
9873
+ *
9874
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
9875
+ * expires by itself, which is the one failure a boolean cannot avoid.
9876
+ */
9877
+ var LogChannelWindowSchema = object({
9878
+ channel: string().min(1),
9879
+ /** Epoch ms the window closes at. */
9880
+ armedUntilMs: number(),
9881
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
9882
+ deviceIds: array(number().int()).readonly().nullable()
9883
+ });
9880
9884
  var MODEL_FORMATS = [
9881
9885
  "onnx",
9882
9886
  "coreml",
@@ -11533,12 +11537,30 @@ var BackupDestinationInfoSchema = object({
11533
11537
  lastSuccessAt: number().optional(),
11534
11538
  /** Newest-archive size from `manifests.json`, or undefined. */
11535
11539
  lastSuccessSizeBytes: number().optional(),
11536
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
11540
+ /**
11541
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
11542
+ * destination, comma-joined. Absent when no enabled schedule targets it
11543
+ * — a destination nothing is scheduled to write to must not advertise a
11544
+ * cadence (D384). This is never the `backup_destination_policies.cron`
11545
+ * column: that per-location cron has scheduled nothing since 2026-07-28
11546
+ * and reading it made a destination with a DISABLED schedule claim a
11547
+ * nightly run.
11548
+ */
11537
11549
  cron: string().optional(),
11538
- /** ms-epoch of next computed firing for this destination's cron, if any. */
11550
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
11539
11551
  nextRunAt: number().optional(),
11540
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
11541
- lastRunAt: number().optional()
11552
+ /**
11553
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
11554
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
11555
+ * newest archive that actually landed) and `lastError`.
11556
+ */
11557
+ lastAttemptAt: number().optional(),
11558
+ /**
11559
+ * Why the last attempt failed, verbatim. Absent when the last attempt
11560
+ * landed the archive. A destination that has never been written to has
11561
+ * neither this nor `lastAttemptAt`.
11562
+ */
11563
+ lastError: string().optional()
11542
11564
  });
11543
11565
  /**
11544
11566
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -11701,8 +11723,16 @@ var BackupScheduleSchema = object({
11701
11723
  retentionCount: number().int().min(1).max(1e3),
11702
11724
  /** Optional subset of source locations to include; omitted = all. */
11703
11725
  dataSources: array(string()).readonly().optional(),
11704
- /** ms-epoch of last successful run. */
11705
- lastRunAt: number().optional(),
11726
+ /**
11727
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
11728
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
11729
+ * "succeeded" — a run refused by every destination stamps it too.
11730
+ */
11731
+ lastAttemptAt: number().optional(),
11732
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
11733
+ lastSuccessAt: number().optional(),
11734
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
11735
+ lastError: string().optional(),
11706
11736
  /** ms-epoch of next computed firing (read-only, filled on list). */
11707
11737
  nextRunAt: number().optional()
11708
11738
  });
@@ -11751,14 +11781,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
11751
11781
  locationId: string(),
11752
11782
  enabled: boolean(),
11753
11783
  retentionCount: number().int().min(1).max(1e3),
11754
- label: string().optional(),
11755
- /**
11756
- * Per-destination cron expression. Empty string clears the
11757
- * schedule (manual-only). Validated server-side via croner;
11758
- * malformed expressions reject the upsert with an actionable
11759
- * message.
11760
- */
11761
- cron: string().optional()
11784
+ label: string().optional()
11762
11785
  }), _void(), {
11763
11786
  kind: "mutation",
11764
11787
  auth: "admin"
@@ -22890,7 +22913,7 @@ method(object({
22890
22913
  downloadId: string(),
22891
22914
  offset: number(),
22892
22915
  length: number()
22893
- }), _instanceof(Uint8Array)), method(object({ downloadId: string() }), _void(), { kind: "mutation" }), method(object({ type: StorageLocationTypeSchema.optional() }), array(StorageLocationSchema).readonly()), method(object({ type: StorageLocationTypeSchema }), StorageLocationSchema.nullable()), method(_void(), array(StorageLocationDeclarationSchema).readonly()), method(StorageLocationSchema.omit({
22916
+ }), _instanceof(Uint8Array)), method(object({ downloadId: string() }), _void(), { kind: "mutation" }), method(object({ type: StorageLocationTypeSchema.optional() }), array(StorageLocationSchema).readonly()), method(_void(), array(StorageLocationDeclarationSchema).readonly()), method(StorageLocationSchema.omit({
22894
22917
  createdAt: true,
22895
22918
  updatedAt: true
22896
22919
  }), StorageLocationSchema, {
@@ -39735,12 +39758,6 @@ Object.freeze({
39735
39758
  addonId: null,
39736
39759
  access: "view"
39737
39760
  },
39738
- "storage.getDefaultLocation": {
39739
- capName: "storage",
39740
- capScope: "system",
39741
- addonId: null,
39742
- access: "view"
39743
- },
39744
39761
  "storage.list": {
39745
39762
  capName: "storage",
39746
39763
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-provider-rademacher",
3
- "version": "0.2.76",
3
+ "version": "0.2.78",
4
4
  "description": "Rademacher HomePilot device-provider addon for CamStack — wraps the @apocaliss92/noderademacher local-hub client (roller shutters over the cover cap)",
5
5
  "keywords": [
6
6
  "camstack",