@camstack/addon-notifiers 1.2.81 → 1.2.83

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
@@ -7748,111 +7748,6 @@ var CameraSwitchGroupSchema = object({
7748
7748
  fetchedAt: number()
7749
7749
  });
7750
7750
  /**
7751
- * Per-component log CHANNELS — the gate a hot path consults, and the registry
7752
- * an addon declares its channels in.
7753
- *
7754
- * ## Two axes, deliberately separated
7755
- *
7756
- * - **DECLARATION** — which channels exist. Only the addon knows:
7757
- * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
7758
- * baichuan/handshake. A hand-wired central list rots at the first addition,
7759
- * and rots silently. So a channel is declared where it is consulted, and the
7760
- * `log-channels` capability enumerates the declarations.
7761
- * - **VALUE** — at which level, for which scope, until when. That stays ONE
7762
- * thing: the logging settings document on the `system` cap. Two authorities
7763
- * over the values is the exact defect
7764
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
7765
- * remove; re-introducing it from the cure side would be grotesque.
7766
- *
7767
- * Nothing in this file reads a clock, an env var or a store. The registry is
7768
- * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
7769
- * the hot path with a value somebody actually read, and by
7770
- * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
7771
- * never reaches here, so it can neither disarm an armed channel nor arm a
7772
- * disarmed one (D49).
7773
- *
7774
- * ## The canonical call shape
7775
- *
7776
- * ```ts
7777
- * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
7778
- * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
7779
- * }
7780
- * ```
7781
- *
7782
- * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
7783
- * read. Disarmed, a call site costs one load and one branch, and the `extras`
7784
- * object literal is never constructed because it lives inside the branch. It
7785
- * is the same shape already proven in production at `stream-broker.ts:1650`,
7786
- * and the same discipline `LoggingGate.allowsDestination` uses for the
7787
- * destination floor (measured at 1.93 ns/call when off).
7788
- *
7789
- * ## Why a channel emits at `info`
7790
- *
7791
- * `loki-logging.addon.ts` pins the destination default at `info` and
7792
- * `loki-destination.ts` drops everything below it, so a line emitted at
7793
- * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
7794
- * minutes. A diagnostic that cannot be read an hour later is worse than no
7795
- * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
7796
- * emits at the channel's declared level, whose schema floor is `info`.
7797
- */
7798
- /**
7799
- * The level a channel writes at once armed.
7800
- *
7801
- * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
7802
- * not leave the process for Loki, and the whole point of arming a channel is
7803
- * to read it later.
7804
- */
7805
- var LogChannelLevelSchema = _enum([
7806
- "info",
7807
- "warn",
7808
- "error"
7809
- ]);
7810
- /**
7811
- * What an addon declares about one channel. No value, no state — a
7812
- * declaration is inert.
7813
- */
7814
- var LogChannelDescriptorSchema = object({
7815
- /**
7816
- * Dotted `area.thing`, unique across the workspace. `area` is conventionally
7817
- * the addon's short name so an operator reading a channel list can tell who
7818
- * owns it without a second lookup.
7819
- */
7820
- name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
7821
- /** One sentence: what the operator will SEE after arming it. */
7822
- description: string().min(1),
7823
- /** The level its lines are emitted at. Never below `info`. */
7824
- defaultLevel: LogChannelLevelSchema,
7825
- /**
7826
- * Whether this channel can be narrowed to a camera.
7827
- *
7828
- * `true` is a PROMISE with two halves, and both must hold: the gate is
7829
- * consulted with the numeric device id, AND every line the channel admits
7830
- * carries `tags: { deviceId }` with that same numeric id. The second half is
7831
- * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
7832
- * keeps `deviceId` out of the stream labels for cardinality, so the tag in
7833
- * the body is the only way to filter.
7834
- *
7835
- * A channel whose lines carry the device only in `meta` (or not at all) is
7836
- * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
7837
- * the operator narrows to one camera, sees nothing, and concludes the code
7838
- * path was never taken.
7839
- */
7840
- perDevice: boolean()
7841
- });
7842
- /**
7843
- * An armed window over one channel, as the document hands it to a mirror.
7844
- *
7845
- * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
7846
- * expires by itself, which is the one failure a boolean cannot avoid.
7847
- */
7848
- var LogChannelWindowSchema = object({
7849
- channel: string().min(1),
7850
- /** Epoch ms the window closes at. */
7851
- armedUntilMs: number(),
7852
- /** `null` = every camera. A non-empty list narrows to those numeric ids. */
7853
- deviceIds: array(number().int()).readonly().nullable()
7854
- });
7855
- /**
7856
7751
  * Ops-log — the durable, append-only operations audit shared by the
7857
7752
  * recordings and events management surfaces.
7858
7753
  *
@@ -8798,8 +8693,11 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
8798
8693
  * `STORAGE_LOCATION_CARDINALITY` map has been removed.
8799
8694
  *
8800
8695
  * `id` is a stable namespaced string of the form `<type>:<slug>`.
8801
- * The default location for a type uses `id === <type>:default` by
8802
- * convention (the bare type ref like `'backups'` resolves to it).
8696
+ * The seed names its first instance `<type>:default` — a NAME, not a flag.
8697
+ * There is no default location any more (D383): `enabled` is the whole write
8698
+ * model, and a bare type ref resolves to the sole location of the type, or —
8699
+ * transitionally, only while legacy NULL-stamped rows exist — to the row whose
8700
+ * slug is `default`.
8803
8701
  *
8804
8702
  * `isSystem` is a legacy persisted flag. Seed still creates the initial
8805
8703
  * `<type>:default` locations; the flag is no longer a lock, a badge, or a
@@ -8820,21 +8718,20 @@ var StorageLocationSchema = object({
8820
8718
  * flag at upsert time, not here (the schema is provider-agnostic).
8821
8719
  */
8822
8720
  nodeId: string().optional(),
8823
- isDefault: boolean().default(false),
8824
8721
  isSystem: boolean().default(false),
8825
8722
  /**
8826
- * Operator opt-in: whether consumers that BALANCE across several locations
8827
- * of a type may write here. Recordings reads it today; event media and
8828
- * backups are the next consumers, which is why the flag lives on the
8829
- * location rather than in any one addon's store — nothing has to be
8830
- * extended to add the next consumer.
8723
+ * THE write switch, and the only one (D383). `enabled: true` means every
8724
+ * consumer that chooses a write target for this type may write here, and all
8725
+ * enabled locations of a type are used TOGETHER; `false` means read-only —
8726
+ * still read, still played back, still age-swept, still drained, never
8727
+ * written.
8831
8728
  *
8832
- * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
8833
- * flag existed reads back with no flag and keeps working exactly as before;
8834
- * that is the whole compat story, and it is why no migration ships with it.
8835
- * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
8836
- * disk must not silently start writing to it); the default of a type is
8837
- * always stamped `true`.
8729
+ * OPTIONAL only for the wire: an upsert that omits it means "leave what is
8730
+ * stored" on an update and "born inert unless it is the first location of its
8731
+ * type" on a create. On a PERSISTED row absence is legacy and it means
8732
+ * enabled — {@link isLocationEnabled} is the one place that says so, and the
8733
+ * orchestrator stamps every flagless row `true` once at hydrate so absence
8734
+ * stops existing rather than being re-derived on every read.
8838
8735
  */
8839
8736
  enabled: boolean().optional(),
8840
8737
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
@@ -8847,10 +8744,12 @@ var StorageLocationSchema = object({
8847
8744
  createdAt: number(),
8848
8745
  updatedAt: number()
8849
8746
  });
8747
+ object({ isDefault: boolean().optional() });
8850
8748
  /**
8851
8749
  * Reference accepted by consumer-facing `api.storage.*` calls.
8852
8750
  * Either:
8853
- * - a `StorageLocationType` (e.g. `'backups'`) → orchestrator resolves to the default of that type
8751
+ * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
8752
+ * (transitionally, the `<type>:default`-slugged row when several exist)
8854
8753
  * - a fully-qualified id (e.g. `'backups:nas-01'`) → addresses a specific instance
8855
8754
  *
8856
8755
  * The orchestrator's `resolveRef(ref)` handles both cases.
@@ -9026,6 +8925,111 @@ var DecoderSessionConfigSchema = object({
9026
8925
  */
9027
8926
  debug: boolean().optional()
9028
8927
  });
8928
+ /**
8929
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
8930
+ * an addon declares its channels in.
8931
+ *
8932
+ * ## Two axes, deliberately separated
8933
+ *
8934
+ * - **DECLARATION** — which channels exist. Only the addon knows:
8935
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8936
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
8937
+ * and rots silently. So a channel is declared where it is consulted, and the
8938
+ * `log-channels` capability enumerates the declarations.
8939
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
8940
+ * thing: the logging settings document on the `system` cap. Two authorities
8941
+ * over the values is the exact defect
8942
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8943
+ * remove; re-introducing it from the cure side would be grotesque.
8944
+ *
8945
+ * Nothing in this file reads a clock, an env var or a store. The registry is
8946
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8947
+ * the hot path with a value somebody actually read, and by
8948
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8949
+ * never reaches here, so it can neither disarm an armed channel nor arm a
8950
+ * disarmed one (D49).
8951
+ *
8952
+ * ## The canonical call shape
8953
+ *
8954
+ * ```ts
8955
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8956
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8957
+ * }
8958
+ * ```
8959
+ *
8960
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8961
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
8962
+ * object literal is never constructed because it lives inside the branch. It
8963
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
8964
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
8965
+ * destination floor (measured at 1.93 ns/call when off).
8966
+ *
8967
+ * ## Why a channel emits at `info`
8968
+ *
8969
+ * `loki-logging.addon.ts` pins the destination default at `info` and
8970
+ * `loki-destination.ts` drops everything below it, so a line emitted at
8971
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8972
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
8973
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8974
+ * emits at the channel's declared level, whose schema floor is `info`.
8975
+ */
8976
+ /**
8977
+ * The level a channel writes at once armed.
8978
+ *
8979
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8980
+ * not leave the process for Loki, and the whole point of arming a channel is
8981
+ * to read it later.
8982
+ */
8983
+ var LogChannelLevelSchema = _enum([
8984
+ "info",
8985
+ "warn",
8986
+ "error"
8987
+ ]);
8988
+ /**
8989
+ * What an addon declares about one channel. No value, no state — a
8990
+ * declaration is inert.
8991
+ */
8992
+ var LogChannelDescriptorSchema = object({
8993
+ /**
8994
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8995
+ * the addon's short name so an operator reading a channel list can tell who
8996
+ * owns it without a second lookup.
8997
+ */
8998
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8999
+ /** One sentence: what the operator will SEE after arming it. */
9000
+ description: string().min(1),
9001
+ /** The level its lines are emitted at. Never below `info`. */
9002
+ defaultLevel: LogChannelLevelSchema,
9003
+ /**
9004
+ * Whether this channel can be narrowed to a camera.
9005
+ *
9006
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
9007
+ * consulted with the numeric device id, AND every line the channel admits
9008
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
9009
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
9010
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
9011
+ * the body is the only way to filter.
9012
+ *
9013
+ * A channel whose lines carry the device only in `meta` (or not at all) is
9014
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
9015
+ * the operator narrows to one camera, sees nothing, and concludes the code
9016
+ * path was never taken.
9017
+ */
9018
+ perDevice: boolean()
9019
+ });
9020
+ /**
9021
+ * An armed window over one channel, as the document hands it to a mirror.
9022
+ *
9023
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
9024
+ * expires by itself, which is the one failure a boolean cannot avoid.
9025
+ */
9026
+ var LogChannelWindowSchema = object({
9027
+ channel: string().min(1),
9028
+ /** Epoch ms the window closes at. */
9029
+ armedUntilMs: number(),
9030
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
9031
+ deviceIds: array(number().int()).readonly().nullable()
9032
+ });
9029
9033
  var MODEL_FORMATS = [
9030
9034
  "onnx",
9031
9035
  "coreml",
@@ -10701,12 +10705,30 @@ var BackupDestinationInfoSchema = object({
10701
10705
  lastSuccessAt: number().optional(),
10702
10706
  /** Newest-archive size from `manifests.json`, or undefined. */
10703
10707
  lastSuccessSizeBytes: number().optional(),
10704
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10708
+ /**
10709
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10710
+ * destination, comma-joined. Absent when no enabled schedule targets it
10711
+ * — a destination nothing is scheduled to write to must not advertise a
10712
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10713
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10714
+ * and reading it made a destination with a DISABLED schedule claim a
10715
+ * nightly run.
10716
+ */
10705
10717
  cron: string().optional(),
10706
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10718
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10707
10719
  nextRunAt: number().optional(),
10708
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10709
- lastRunAt: number().optional()
10720
+ /**
10721
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10722
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10723
+ * newest archive that actually landed) and `lastError`.
10724
+ */
10725
+ lastAttemptAt: number().optional(),
10726
+ /**
10727
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10728
+ * landed the archive. A destination that has never been written to has
10729
+ * neither this nor `lastAttemptAt`.
10730
+ */
10731
+ lastError: string().optional()
10710
10732
  });
10711
10733
  /**
10712
10734
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10869,8 +10891,16 @@ var BackupScheduleSchema = object({
10869
10891
  retentionCount: number().int().min(1).max(1e3),
10870
10892
  /** Optional subset of source locations to include; omitted = all. */
10871
10893
  dataSources: array(string()).readonly().optional(),
10872
- /** ms-epoch of last successful run. */
10873
- lastRunAt: number().optional(),
10894
+ /**
10895
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10896
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10897
+ * "succeeded" — a run refused by every destination stamps it too.
10898
+ */
10899
+ lastAttemptAt: number().optional(),
10900
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10901
+ lastSuccessAt: number().optional(),
10902
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10903
+ lastError: string().optional(),
10874
10904
  /** ms-epoch of next computed firing (read-only, filled on list). */
10875
10905
  nextRunAt: number().optional()
10876
10906
  });
@@ -10919,14 +10949,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10919
10949
  locationId: string(),
10920
10950
  enabled: boolean(),
10921
10951
  retentionCount: number().int().min(1).max(1e3),
10922
- label: string().optional(),
10923
- /**
10924
- * Per-destination cron expression. Empty string clears the
10925
- * schedule (manual-only). Validated server-side via croner;
10926
- * malformed expressions reject the upsert with an actionable
10927
- * message.
10928
- */
10929
- cron: string().optional()
10952
+ label: string().optional()
10930
10953
  }), _void(), {
10931
10954
  kind: "mutation",
10932
10955
  auth: "admin"
@@ -21726,7 +21749,7 @@ method(object({
21726
21749
  downloadId: string(),
21727
21750
  offset: number(),
21728
21751
  length: number()
21729
- }), _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({
21752
+ }), _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({
21730
21753
  createdAt: true,
21731
21754
  updatedAt: true
21732
21755
  }), StorageLocationSchema, {
@@ -34575,12 +34598,6 @@ Object.freeze({
34575
34598
  addonId: null,
34576
34599
  access: "view"
34577
34600
  },
34578
- "storage.getDefaultLocation": {
34579
- capName: "storage",
34580
- capScope: "system",
34581
- addonId: null,
34582
- access: "view"
34583
- },
34584
34601
  "storage.list": {
34585
34602
  capName: "storage",
34586
34603
  capScope: "system",
package/dist/addon.mjs CHANGED
@@ -7721,111 +7721,6 @@ var CameraSwitchGroupSchema = object({
7721
7721
  fetchedAt: number()
7722
7722
  });
7723
7723
  /**
7724
- * Per-component log CHANNELS — the gate a hot path consults, and the registry
7725
- * an addon declares its channels in.
7726
- *
7727
- * ## Two axes, deliberately separated
7728
- *
7729
- * - **DECLARATION** — which channels exist. Only the addon knows:
7730
- * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
7731
- * baichuan/handshake. A hand-wired central list rots at the first addition,
7732
- * and rots silently. So a channel is declared where it is consulted, and the
7733
- * `log-channels` capability enumerates the declarations.
7734
- * - **VALUE** — at which level, for which scope, until when. That stays ONE
7735
- * thing: the logging settings document on the `system` cap. Two authorities
7736
- * over the values is the exact defect
7737
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
7738
- * remove; re-introducing it from the cure side would be grotesque.
7739
- *
7740
- * Nothing in this file reads a clock, an env var or a store. The registry is
7741
- * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
7742
- * the hot path with a value somebody actually read, and by
7743
- * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
7744
- * never reaches here, so it can neither disarm an armed channel nor arm a
7745
- * disarmed one (D49).
7746
- *
7747
- * ## The canonical call shape
7748
- *
7749
- * ```ts
7750
- * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
7751
- * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
7752
- * }
7753
- * ```
7754
- *
7755
- * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
7756
- * read. Disarmed, a call site costs one load and one branch, and the `extras`
7757
- * object literal is never constructed because it lives inside the branch. It
7758
- * is the same shape already proven in production at `stream-broker.ts:1650`,
7759
- * and the same discipline `LoggingGate.allowsDestination` uses for the
7760
- * destination floor (measured at 1.93 ns/call when off).
7761
- *
7762
- * ## Why a channel emits at `info`
7763
- *
7764
- * `loki-logging.addon.ts` pins the destination default at `info` and
7765
- * `loki-destination.ts` drops everything below it, so a line emitted at
7766
- * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
7767
- * minutes. A diagnostic that cannot be read an hour later is worse than no
7768
- * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
7769
- * emits at the channel's declared level, whose schema floor is `info`.
7770
- */
7771
- /**
7772
- * The level a channel writes at once armed.
7773
- *
7774
- * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
7775
- * not leave the process for Loki, and the whole point of arming a channel is
7776
- * to read it later.
7777
- */
7778
- var LogChannelLevelSchema = _enum([
7779
- "info",
7780
- "warn",
7781
- "error"
7782
- ]);
7783
- /**
7784
- * What an addon declares about one channel. No value, no state — a
7785
- * declaration is inert.
7786
- */
7787
- var LogChannelDescriptorSchema = object({
7788
- /**
7789
- * Dotted `area.thing`, unique across the workspace. `area` is conventionally
7790
- * the addon's short name so an operator reading a channel list can tell who
7791
- * owns it without a second lookup.
7792
- */
7793
- name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
7794
- /** One sentence: what the operator will SEE after arming it. */
7795
- description: string().min(1),
7796
- /** The level its lines are emitted at. Never below `info`. */
7797
- defaultLevel: LogChannelLevelSchema,
7798
- /**
7799
- * Whether this channel can be narrowed to a camera.
7800
- *
7801
- * `true` is a PROMISE with two halves, and both must hold: the gate is
7802
- * consulted with the numeric device id, AND every line the channel admits
7803
- * carries `tags: { deviceId }` with that same numeric id. The second half is
7804
- * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
7805
- * keeps `deviceId` out of the stream labels for cardinality, so the tag in
7806
- * the body is the only way to filter.
7807
- *
7808
- * A channel whose lines carry the device only in `meta` (or not at all) is
7809
- * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
7810
- * the operator narrows to one camera, sees nothing, and concludes the code
7811
- * path was never taken.
7812
- */
7813
- perDevice: boolean()
7814
- });
7815
- /**
7816
- * An armed window over one channel, as the document hands it to a mirror.
7817
- *
7818
- * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
7819
- * expires by itself, which is the one failure a boolean cannot avoid.
7820
- */
7821
- var LogChannelWindowSchema = object({
7822
- channel: string().min(1),
7823
- /** Epoch ms the window closes at. */
7824
- armedUntilMs: number(),
7825
- /** `null` = every camera. A non-empty list narrows to those numeric ids. */
7826
- deviceIds: array(number().int()).readonly().nullable()
7827
- });
7828
- /**
7829
7724
  * Ops-log — the durable, append-only operations audit shared by the
7830
7725
  * recordings and events management surfaces.
7831
7726
  *
@@ -8771,8 +8666,11 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
8771
8666
  * `STORAGE_LOCATION_CARDINALITY` map has been removed.
8772
8667
  *
8773
8668
  * `id` is a stable namespaced string of the form `<type>:<slug>`.
8774
- * The default location for a type uses `id === <type>:default` by
8775
- * convention (the bare type ref like `'backups'` resolves to it).
8669
+ * The seed names its first instance `<type>:default` — a NAME, not a flag.
8670
+ * There is no default location any more (D383): `enabled` is the whole write
8671
+ * model, and a bare type ref resolves to the sole location of the type, or —
8672
+ * transitionally, only while legacy NULL-stamped rows exist — to the row whose
8673
+ * slug is `default`.
8776
8674
  *
8777
8675
  * `isSystem` is a legacy persisted flag. Seed still creates the initial
8778
8676
  * `<type>:default` locations; the flag is no longer a lock, a badge, or a
@@ -8793,21 +8691,20 @@ var StorageLocationSchema = object({
8793
8691
  * flag at upsert time, not here (the schema is provider-agnostic).
8794
8692
  */
8795
8693
  nodeId: string().optional(),
8796
- isDefault: boolean().default(false),
8797
8694
  isSystem: boolean().default(false),
8798
8695
  /**
8799
- * Operator opt-in: whether consumers that BALANCE across several locations
8800
- * of a type may write here. Recordings reads it today; event media and
8801
- * backups are the next consumers, which is why the flag lives on the
8802
- * location rather than in any one addon's store — nothing has to be
8803
- * extended to add the next consumer.
8696
+ * THE write switch, and the only one (D383). `enabled: true` means every
8697
+ * consumer that chooses a write target for this type may write here, and all
8698
+ * enabled locations of a type are used TOGETHER; `false` means read-only —
8699
+ * still read, still played back, still age-swept, still drained, never
8700
+ * written.
8804
8701
  *
8805
- * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
8806
- * flag existed reads back with no flag and keeps working exactly as before;
8807
- * that is the whole compat story, and it is why no migration ships with it.
8808
- * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
8809
- * disk must not silently start writing to it); the default of a type is
8810
- * always stamped `true`.
8702
+ * OPTIONAL only for the wire: an upsert that omits it means "leave what is
8703
+ * stored" on an update and "born inert unless it is the first location of its
8704
+ * type" on a create. On a PERSISTED row absence is legacy and it means
8705
+ * enabled — {@link isLocationEnabled} is the one place that says so, and the
8706
+ * orchestrator stamps every flagless row `true` once at hydrate so absence
8707
+ * stops existing rather than being re-derived on every read.
8811
8708
  */
8812
8709
  enabled: boolean().optional(),
8813
8710
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
@@ -8820,10 +8717,12 @@ var StorageLocationSchema = object({
8820
8717
  createdAt: number(),
8821
8718
  updatedAt: number()
8822
8719
  });
8720
+ object({ isDefault: boolean().optional() });
8823
8721
  /**
8824
8722
  * Reference accepted by consumer-facing `api.storage.*` calls.
8825
8723
  * Either:
8826
- * - a `StorageLocationType` (e.g. `'backups'`) → orchestrator resolves to the default of that type
8724
+ * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
8725
+ * (transitionally, the `<type>:default`-slugged row when several exist)
8827
8726
  * - a fully-qualified id (e.g. `'backups:nas-01'`) → addresses a specific instance
8828
8727
  *
8829
8728
  * The orchestrator's `resolveRef(ref)` handles both cases.
@@ -8999,6 +8898,111 @@ var DecoderSessionConfigSchema = object({
8999
8898
  */
9000
8899
  debug: boolean().optional()
9001
8900
  });
8901
+ /**
8902
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
8903
+ * an addon declares its channels in.
8904
+ *
8905
+ * ## Two axes, deliberately separated
8906
+ *
8907
+ * - **DECLARATION** — which channels exist. Only the addon knows:
8908
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8909
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
8910
+ * and rots silently. So a channel is declared where it is consulted, and the
8911
+ * `log-channels` capability enumerates the declarations.
8912
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
8913
+ * thing: the logging settings document on the `system` cap. Two authorities
8914
+ * over the values is the exact defect
8915
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8916
+ * remove; re-introducing it from the cure side would be grotesque.
8917
+ *
8918
+ * Nothing in this file reads a clock, an env var or a store. The registry is
8919
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8920
+ * the hot path with a value somebody actually read, and by
8921
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8922
+ * never reaches here, so it can neither disarm an armed channel nor arm a
8923
+ * disarmed one (D49).
8924
+ *
8925
+ * ## The canonical call shape
8926
+ *
8927
+ * ```ts
8928
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8929
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8930
+ * }
8931
+ * ```
8932
+ *
8933
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8934
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
8935
+ * object literal is never constructed because it lives inside the branch. It
8936
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
8937
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
8938
+ * destination floor (measured at 1.93 ns/call when off).
8939
+ *
8940
+ * ## Why a channel emits at `info`
8941
+ *
8942
+ * `loki-logging.addon.ts` pins the destination default at `info` and
8943
+ * `loki-destination.ts` drops everything below it, so a line emitted at
8944
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8945
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
8946
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8947
+ * emits at the channel's declared level, whose schema floor is `info`.
8948
+ */
8949
+ /**
8950
+ * The level a channel writes at once armed.
8951
+ *
8952
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8953
+ * not leave the process for Loki, and the whole point of arming a channel is
8954
+ * to read it later.
8955
+ */
8956
+ var LogChannelLevelSchema = _enum([
8957
+ "info",
8958
+ "warn",
8959
+ "error"
8960
+ ]);
8961
+ /**
8962
+ * What an addon declares about one channel. No value, no state — a
8963
+ * declaration is inert.
8964
+ */
8965
+ var LogChannelDescriptorSchema = object({
8966
+ /**
8967
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8968
+ * the addon's short name so an operator reading a channel list can tell who
8969
+ * owns it without a second lookup.
8970
+ */
8971
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8972
+ /** One sentence: what the operator will SEE after arming it. */
8973
+ description: string().min(1),
8974
+ /** The level its lines are emitted at. Never below `info`. */
8975
+ defaultLevel: LogChannelLevelSchema,
8976
+ /**
8977
+ * Whether this channel can be narrowed to a camera.
8978
+ *
8979
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
8980
+ * consulted with the numeric device id, AND every line the channel admits
8981
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
8982
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
8983
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
8984
+ * the body is the only way to filter.
8985
+ *
8986
+ * A channel whose lines carry the device only in `meta` (or not at all) is
8987
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
8988
+ * the operator narrows to one camera, sees nothing, and concludes the code
8989
+ * path was never taken.
8990
+ */
8991
+ perDevice: boolean()
8992
+ });
8993
+ /**
8994
+ * An armed window over one channel, as the document hands it to a mirror.
8995
+ *
8996
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
8997
+ * expires by itself, which is the one failure a boolean cannot avoid.
8998
+ */
8999
+ var LogChannelWindowSchema = object({
9000
+ channel: string().min(1),
9001
+ /** Epoch ms the window closes at. */
9002
+ armedUntilMs: number(),
9003
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
9004
+ deviceIds: array(number().int()).readonly().nullable()
9005
+ });
9002
9006
  var MODEL_FORMATS = [
9003
9007
  "onnx",
9004
9008
  "coreml",
@@ -10674,12 +10678,30 @@ var BackupDestinationInfoSchema = object({
10674
10678
  lastSuccessAt: number().optional(),
10675
10679
  /** Newest-archive size from `manifests.json`, or undefined. */
10676
10680
  lastSuccessSizeBytes: number().optional(),
10677
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10681
+ /**
10682
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10683
+ * destination, comma-joined. Absent when no enabled schedule targets it
10684
+ * — a destination nothing is scheduled to write to must not advertise a
10685
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10686
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10687
+ * and reading it made a destination with a DISABLED schedule claim a
10688
+ * nightly run.
10689
+ */
10678
10690
  cron: string().optional(),
10679
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10691
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10680
10692
  nextRunAt: number().optional(),
10681
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10682
- lastRunAt: number().optional()
10693
+ /**
10694
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10695
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10696
+ * newest archive that actually landed) and `lastError`.
10697
+ */
10698
+ lastAttemptAt: number().optional(),
10699
+ /**
10700
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10701
+ * landed the archive. A destination that has never been written to has
10702
+ * neither this nor `lastAttemptAt`.
10703
+ */
10704
+ lastError: string().optional()
10683
10705
  });
10684
10706
  /**
10685
10707
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10842,8 +10864,16 @@ var BackupScheduleSchema = object({
10842
10864
  retentionCount: number().int().min(1).max(1e3),
10843
10865
  /** Optional subset of source locations to include; omitted = all. */
10844
10866
  dataSources: array(string()).readonly().optional(),
10845
- /** ms-epoch of last successful run. */
10846
- lastRunAt: number().optional(),
10867
+ /**
10868
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10869
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10870
+ * "succeeded" — a run refused by every destination stamps it too.
10871
+ */
10872
+ lastAttemptAt: number().optional(),
10873
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10874
+ lastSuccessAt: number().optional(),
10875
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10876
+ lastError: string().optional(),
10847
10877
  /** ms-epoch of next computed firing (read-only, filled on list). */
10848
10878
  nextRunAt: number().optional()
10849
10879
  });
@@ -10892,14 +10922,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10892
10922
  locationId: string(),
10893
10923
  enabled: boolean(),
10894
10924
  retentionCount: number().int().min(1).max(1e3),
10895
- label: string().optional(),
10896
- /**
10897
- * Per-destination cron expression. Empty string clears the
10898
- * schedule (manual-only). Validated server-side via croner;
10899
- * malformed expressions reject the upsert with an actionable
10900
- * message.
10901
- */
10902
- cron: string().optional()
10925
+ label: string().optional()
10903
10926
  }), _void(), {
10904
10927
  kind: "mutation",
10905
10928
  auth: "admin"
@@ -21699,7 +21722,7 @@ method(object({
21699
21722
  downloadId: string(),
21700
21723
  offset: number(),
21701
21724
  length: number()
21702
- }), _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({
21725
+ }), _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({
21703
21726
  createdAt: true,
21704
21727
  updatedAt: true
21705
21728
  }), StorageLocationSchema, {
@@ -34548,12 +34571,6 @@ Object.freeze({
34548
34571
  addonId: null,
34549
34572
  access: "view"
34550
34573
  },
34551
- "storage.getDefaultLocation": {
34552
- capName: "storage",
34553
- capScope: "system",
34554
- addonId: null,
34555
- access: "view"
34556
- },
34557
34574
  "storage.list": {
34558
34575
  capName: "storage",
34559
34576
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-notifiers",
3
- "version": "1.2.81",
3
+ "version": "1.2.83",
4
4
  "description": "System notifiers addon for CamStack — a `notification-output` collection provider hosting per-kind notifier adapters (ntfy, pushover, gotify, telegram, discord, webhook, zentik).",
5
5
  "keywords": [
6
6
  "camstack",