@camstack/addon-smtp-nodemailer 1.2.76 → 1.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.
@@ -7636,111 +7636,6 @@ var CameraSwitchGroupSchema = object({
7636
7636
  fetchedAt: number()
7637
7637
  });
7638
7638
  /**
7639
- * Per-component log CHANNELS — the gate a hot path consults, and the registry
7640
- * an addon declares its channels in.
7641
- *
7642
- * ## Two axes, deliberately separated
7643
- *
7644
- * - **DECLARATION** — which channels exist. Only the addon knows:
7645
- * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
7646
- * baichuan/handshake. A hand-wired central list rots at the first addition,
7647
- * and rots silently. So a channel is declared where it is consulted, and the
7648
- * `log-channels` capability enumerates the declarations.
7649
- * - **VALUE** — at which level, for which scope, until when. That stays ONE
7650
- * thing: the logging settings document on the `system` cap. Two authorities
7651
- * over the values is the exact defect
7652
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
7653
- * remove; re-introducing it from the cure side would be grotesque.
7654
- *
7655
- * Nothing in this file reads a clock, an env var or a store. The registry is
7656
- * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
7657
- * the hot path with a value somebody actually read, and by
7658
- * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
7659
- * never reaches here, so it can neither disarm an armed channel nor arm a
7660
- * disarmed one (D49).
7661
- *
7662
- * ## The canonical call shape
7663
- *
7664
- * ```ts
7665
- * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
7666
- * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
7667
- * }
7668
- * ```
7669
- *
7670
- * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
7671
- * read. Disarmed, a call site costs one load and one branch, and the `extras`
7672
- * object literal is never constructed because it lives inside the branch. It
7673
- * is the same shape already proven in production at `stream-broker.ts:1650`,
7674
- * and the same discipline `LoggingGate.allowsDestination` uses for the
7675
- * destination floor (measured at 1.93 ns/call when off).
7676
- *
7677
- * ## Why a channel emits at `info`
7678
- *
7679
- * `loki-logging.addon.ts` pins the destination default at `info` and
7680
- * `loki-destination.ts` drops everything below it, so a line emitted at
7681
- * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
7682
- * minutes. A diagnostic that cannot be read an hour later is worse than no
7683
- * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
7684
- * emits at the channel's declared level, whose schema floor is `info`.
7685
- */
7686
- /**
7687
- * The level a channel writes at once armed.
7688
- *
7689
- * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
7690
- * not leave the process for Loki, and the whole point of arming a channel is
7691
- * to read it later.
7692
- */
7693
- var LogChannelLevelSchema = _enum([
7694
- "info",
7695
- "warn",
7696
- "error"
7697
- ]);
7698
- /**
7699
- * What an addon declares about one channel. No value, no state — a
7700
- * declaration is inert.
7701
- */
7702
- var LogChannelDescriptorSchema = object({
7703
- /**
7704
- * Dotted `area.thing`, unique across the workspace. `area` is conventionally
7705
- * the addon's short name so an operator reading a channel list can tell who
7706
- * owns it without a second lookup.
7707
- */
7708
- name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
7709
- /** One sentence: what the operator will SEE after arming it. */
7710
- description: string().min(1),
7711
- /** The level its lines are emitted at. Never below `info`. */
7712
- defaultLevel: LogChannelLevelSchema,
7713
- /**
7714
- * Whether this channel can be narrowed to a camera.
7715
- *
7716
- * `true` is a PROMISE with two halves, and both must hold: the gate is
7717
- * consulted with the numeric device id, AND every line the channel admits
7718
- * carries `tags: { deviceId }` with that same numeric id. The second half is
7719
- * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
7720
- * keeps `deviceId` out of the stream labels for cardinality, so the tag in
7721
- * the body is the only way to filter.
7722
- *
7723
- * A channel whose lines carry the device only in `meta` (or not at all) is
7724
- * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
7725
- * the operator narrows to one camera, sees nothing, and concludes the code
7726
- * path was never taken.
7727
- */
7728
- perDevice: boolean()
7729
- });
7730
- /**
7731
- * An armed window over one channel, as the document hands it to a mirror.
7732
- *
7733
- * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
7734
- * expires by itself, which is the one failure a boolean cannot avoid.
7735
- */
7736
- var LogChannelWindowSchema = object({
7737
- channel: string().min(1),
7738
- /** Epoch ms the window closes at. */
7739
- armedUntilMs: number(),
7740
- /** `null` = every camera. A non-empty list narrows to those numeric ids. */
7741
- deviceIds: array(number().int()).readonly().nullable()
7742
- });
7743
- /**
7744
7639
  * Ops-log — the durable, append-only operations audit shared by the
7745
7640
  * recordings and events management surfaces.
7746
7641
  *
@@ -8686,8 +8581,11 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
8686
8581
  * `STORAGE_LOCATION_CARDINALITY` map has been removed.
8687
8582
  *
8688
8583
  * `id` is a stable namespaced string of the form `<type>:<slug>`.
8689
- * The default location for a type uses `id === <type>:default` by
8690
- * convention (the bare type ref like `'backups'` resolves to it).
8584
+ * The seed names its first instance `<type>:default` — a NAME, not a flag.
8585
+ * There is no default location any more (D383): `enabled` is the whole write
8586
+ * model, and a bare type ref resolves to the sole location of the type, or —
8587
+ * transitionally, only while legacy NULL-stamped rows exist — to the row whose
8588
+ * slug is `default`.
8691
8589
  *
8692
8590
  * `isSystem` is a legacy persisted flag. Seed still creates the initial
8693
8591
  * `<type>:default` locations; the flag is no longer a lock, a badge, or a
@@ -8708,21 +8606,20 @@ var StorageLocationSchema = object({
8708
8606
  * flag at upsert time, not here (the schema is provider-agnostic).
8709
8607
  */
8710
8608
  nodeId: string().optional(),
8711
- isDefault: boolean().default(false),
8712
8609
  isSystem: boolean().default(false),
8713
8610
  /**
8714
- * Operator opt-in: whether consumers that BALANCE across several locations
8715
- * of a type may write here. Recordings reads it today; event media and
8716
- * backups are the next consumers, which is why the flag lives on the
8717
- * location rather than in any one addon's store nothing has to be
8718
- * extended to add the next consumer.
8611
+ * THE write switch, and the only one (D383). `enabled: true` means every
8612
+ * consumer that chooses a write target for this type may write here, and all
8613
+ * enabled locations of a type are used TOGETHER; `false` means read-only
8614
+ * still read, still played back, still age-swept, still drained, never
8615
+ * written.
8719
8616
  *
8720
- * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
8721
- * flag existed reads back with no flag and keeps working exactly as before;
8722
- * that is the whole compat story, and it is why no migration ships with it.
8723
- * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
8724
- * disk must not silently start writing to it); the default of a type is
8725
- * always stamped `true`.
8617
+ * OPTIONAL only for the wire: an upsert that omits it means "leave what is
8618
+ * stored" on an update and "born inert unless it is the first location of its
8619
+ * type" on a create. On a PERSISTED row absence is legacy and it means
8620
+ * enabled {@link isLocationEnabled} is the one place that says so, and the
8621
+ * orchestrator stamps every flagless row `true` once at hydrate so absence
8622
+ * stops existing rather than being re-derived on every read.
8726
8623
  */
8727
8624
  enabled: boolean().optional(),
8728
8625
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
@@ -8735,10 +8632,12 @@ var StorageLocationSchema = object({
8735
8632
  createdAt: number(),
8736
8633
  updatedAt: number()
8737
8634
  });
8635
+ object({ isDefault: boolean().optional() });
8738
8636
  /**
8739
8637
  * Reference accepted by consumer-facing `api.storage.*` calls.
8740
8638
  * Either:
8741
- * - a `StorageLocationType` (e.g. `'backups'`) → orchestrator resolves to the default of that type
8639
+ * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
8640
+ * (transitionally, the `<type>:default`-slugged row when several exist)
8742
8641
  * - a fully-qualified id (e.g. `'backups:nas-01'`) → addresses a specific instance
8743
8642
  *
8744
8643
  * The orchestrator's `resolveRef(ref)` handles both cases.
@@ -8914,6 +8813,111 @@ var DecoderSessionConfigSchema = object({
8914
8813
  */
8915
8814
  debug: boolean().optional()
8916
8815
  });
8816
+ /**
8817
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
8818
+ * an addon declares its channels in.
8819
+ *
8820
+ * ## Two axes, deliberately separated
8821
+ *
8822
+ * - **DECLARATION** — which channels exist. Only the addon knows:
8823
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8824
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
8825
+ * and rots silently. So a channel is declared where it is consulted, and the
8826
+ * `log-channels` capability enumerates the declarations.
8827
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
8828
+ * thing: the logging settings document on the `system` cap. Two authorities
8829
+ * over the values is the exact defect
8830
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8831
+ * remove; re-introducing it from the cure side would be grotesque.
8832
+ *
8833
+ * Nothing in this file reads a clock, an env var or a store. The registry is
8834
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8835
+ * the hot path with a value somebody actually read, and by
8836
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8837
+ * never reaches here, so it can neither disarm an armed channel nor arm a
8838
+ * disarmed one (D49).
8839
+ *
8840
+ * ## The canonical call shape
8841
+ *
8842
+ * ```ts
8843
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8844
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8845
+ * }
8846
+ * ```
8847
+ *
8848
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8849
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
8850
+ * object literal is never constructed because it lives inside the branch. It
8851
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
8852
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
8853
+ * destination floor (measured at 1.93 ns/call when off).
8854
+ *
8855
+ * ## Why a channel emits at `info`
8856
+ *
8857
+ * `loki-logging.addon.ts` pins the destination default at `info` and
8858
+ * `loki-destination.ts` drops everything below it, so a line emitted at
8859
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8860
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
8861
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8862
+ * emits at the channel's declared level, whose schema floor is `info`.
8863
+ */
8864
+ /**
8865
+ * The level a channel writes at once armed.
8866
+ *
8867
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8868
+ * not leave the process for Loki, and the whole point of arming a channel is
8869
+ * to read it later.
8870
+ */
8871
+ var LogChannelLevelSchema = _enum([
8872
+ "info",
8873
+ "warn",
8874
+ "error"
8875
+ ]);
8876
+ /**
8877
+ * What an addon declares about one channel. No value, no state — a
8878
+ * declaration is inert.
8879
+ */
8880
+ var LogChannelDescriptorSchema = object({
8881
+ /**
8882
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8883
+ * the addon's short name so an operator reading a channel list can tell who
8884
+ * owns it without a second lookup.
8885
+ */
8886
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8887
+ /** One sentence: what the operator will SEE after arming it. */
8888
+ description: string().min(1),
8889
+ /** The level its lines are emitted at. Never below `info`. */
8890
+ defaultLevel: LogChannelLevelSchema,
8891
+ /**
8892
+ * Whether this channel can be narrowed to a camera.
8893
+ *
8894
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
8895
+ * consulted with the numeric device id, AND every line the channel admits
8896
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
8897
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
8898
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
8899
+ * the body is the only way to filter.
8900
+ *
8901
+ * A channel whose lines carry the device only in `meta` (or not at all) is
8902
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
8903
+ * the operator narrows to one camera, sees nothing, and concludes the code
8904
+ * path was never taken.
8905
+ */
8906
+ perDevice: boolean()
8907
+ });
8908
+ /**
8909
+ * An armed window over one channel, as the document hands it to a mirror.
8910
+ *
8911
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
8912
+ * expires by itself, which is the one failure a boolean cannot avoid.
8913
+ */
8914
+ var LogChannelWindowSchema = object({
8915
+ channel: string().min(1),
8916
+ /** Epoch ms the window closes at. */
8917
+ armedUntilMs: number(),
8918
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
8919
+ deviceIds: array(number().int()).readonly().nullable()
8920
+ });
8917
8921
  var MODEL_FORMATS = [
8918
8922
  "onnx",
8919
8923
  "coreml",
@@ -10570,12 +10574,30 @@ var BackupDestinationInfoSchema = object({
10570
10574
  lastSuccessAt: number().optional(),
10571
10575
  /** Newest-archive size from `manifests.json`, or undefined. */
10572
10576
  lastSuccessSizeBytes: number().optional(),
10573
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10577
+ /**
10578
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10579
+ * destination, comma-joined. Absent when no enabled schedule targets it
10580
+ * — a destination nothing is scheduled to write to must not advertise a
10581
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10582
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10583
+ * and reading it made a destination with a DISABLED schedule claim a
10584
+ * nightly run.
10585
+ */
10574
10586
  cron: string().optional(),
10575
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10587
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10576
10588
  nextRunAt: number().optional(),
10577
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10578
- lastRunAt: number().optional()
10589
+ /**
10590
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10591
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10592
+ * newest archive that actually landed) and `lastError`.
10593
+ */
10594
+ lastAttemptAt: number().optional(),
10595
+ /**
10596
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10597
+ * landed the archive. A destination that has never been written to has
10598
+ * neither this nor `lastAttemptAt`.
10599
+ */
10600
+ lastError: string().optional()
10579
10601
  });
10580
10602
  /**
10581
10603
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10738,8 +10760,16 @@ var BackupScheduleSchema = object({
10738
10760
  retentionCount: number().int().min(1).max(1e3),
10739
10761
  /** Optional subset of source locations to include; omitted = all. */
10740
10762
  dataSources: array(string()).readonly().optional(),
10741
- /** ms-epoch of last successful run. */
10742
- lastRunAt: number().optional(),
10763
+ /**
10764
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10765
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10766
+ * "succeeded" — a run refused by every destination stamps it too.
10767
+ */
10768
+ lastAttemptAt: number().optional(),
10769
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10770
+ lastSuccessAt: number().optional(),
10771
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10772
+ lastError: string().optional(),
10743
10773
  /** ms-epoch of next computed firing (read-only, filled on list). */
10744
10774
  nextRunAt: number().optional()
10745
10775
  });
@@ -10788,14 +10818,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10788
10818
  locationId: string(),
10789
10819
  enabled: boolean(),
10790
10820
  retentionCount: number().int().min(1).max(1e3),
10791
- label: string().optional(),
10792
- /**
10793
- * Per-destination cron expression. Empty string clears the
10794
- * schedule (manual-only). Validated server-side via croner;
10795
- * malformed expressions reject the upsert with an actionable
10796
- * message.
10797
- */
10798
- cron: string().optional()
10821
+ label: string().optional()
10799
10822
  }), _void(), {
10800
10823
  kind: "mutation",
10801
10824
  auth: "admin"
@@ -21572,7 +21595,7 @@ method(object({
21572
21595
  downloadId: string(),
21573
21596
  offset: number(),
21574
21597
  length: number()
21575
- }), _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({
21598
+ }), _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({
21576
21599
  createdAt: true,
21577
21600
  updatedAt: true
21578
21601
  }), StorageLocationSchema, {
@@ -34421,12 +34444,6 @@ Object.freeze({
34421
34444
  addonId: null,
34422
34445
  access: "view"
34423
34446
  },
34424
- "storage.getDefaultLocation": {
34425
- capName: "storage",
34426
- capScope: "system",
34427
- addonId: null,
34428
- access: "view"
34429
- },
34430
34447
  "storage.list": {
34431
34448
  capName: "storage",
34432
34449
  capScope: "system",
@@ -7634,111 +7634,6 @@ var CameraSwitchGroupSchema = object({
7634
7634
  fetchedAt: number()
7635
7635
  });
7636
7636
  /**
7637
- * Per-component log CHANNELS — the gate a hot path consults, and the registry
7638
- * an addon declares its channels in.
7639
- *
7640
- * ## Two axes, deliberately separated
7641
- *
7642
- * - **DECLARATION** — which channels exist. Only the addon knows:
7643
- * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
7644
- * baichuan/handshake. A hand-wired central list rots at the first addition,
7645
- * and rots silently. So a channel is declared where it is consulted, and the
7646
- * `log-channels` capability enumerates the declarations.
7647
- * - **VALUE** — at which level, for which scope, until when. That stays ONE
7648
- * thing: the logging settings document on the `system` cap. Two authorities
7649
- * over the values is the exact defect
7650
- * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
7651
- * remove; re-introducing it from the cure side would be grotesque.
7652
- *
7653
- * Nothing in this file reads a clock, an env var or a store. The registry is
7654
- * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
7655
- * the hot path with a value somebody actually read, and by
7656
- * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
7657
- * never reaches here, so it can neither disarm an armed channel nor arm a
7658
- * disarmed one (D49).
7659
- *
7660
- * ## The canonical call shape
7661
- *
7662
- * ```ts
7663
- * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
7664
- * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
7665
- * }
7666
- * ```
7667
- *
7668
- * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
7669
- * read. Disarmed, a call site costs one load and one branch, and the `extras`
7670
- * object literal is never constructed because it lives inside the branch. It
7671
- * is the same shape already proven in production at `stream-broker.ts:1650`,
7672
- * and the same discipline `LoggingGate.allowsDestination` uses for the
7673
- * destination floor (measured at 1.93 ns/call when off).
7674
- *
7675
- * ## Why a channel emits at `info`
7676
- *
7677
- * `loki-logging.addon.ts` pins the destination default at `info` and
7678
- * `loki-destination.ts` drops everything below it, so a line emitted at
7679
- * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
7680
- * minutes. A diagnostic that cannot be read an hour later is worse than no
7681
- * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
7682
- * emits at the channel's declared level, whose schema floor is `info`.
7683
- */
7684
- /**
7685
- * The level a channel writes at once armed.
7686
- *
7687
- * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
7688
- * not leave the process for Loki, and the whole point of arming a channel is
7689
- * to read it later.
7690
- */
7691
- var LogChannelLevelSchema = _enum([
7692
- "info",
7693
- "warn",
7694
- "error"
7695
- ]);
7696
- /**
7697
- * What an addon declares about one channel. No value, no state — a
7698
- * declaration is inert.
7699
- */
7700
- var LogChannelDescriptorSchema = object({
7701
- /**
7702
- * Dotted `area.thing`, unique across the workspace. `area` is conventionally
7703
- * the addon's short name so an operator reading a channel list can tell who
7704
- * owns it without a second lookup.
7705
- */
7706
- name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
7707
- /** One sentence: what the operator will SEE after arming it. */
7708
- description: string().min(1),
7709
- /** The level its lines are emitted at. Never below `info`. */
7710
- defaultLevel: LogChannelLevelSchema,
7711
- /**
7712
- * Whether this channel can be narrowed to a camera.
7713
- *
7714
- * `true` is a PROMISE with two halves, and both must hold: the gate is
7715
- * consulted with the numeric device id, AND every line the channel admits
7716
- * carries `tags: { deviceId }` with that same numeric id. The second half is
7717
- * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
7718
- * keeps `deviceId` out of the stream labels for cardinality, so the tag in
7719
- * the body is the only way to filter.
7720
- *
7721
- * A channel whose lines carry the device only in `meta` (or not at all) is
7722
- * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
7723
- * the operator narrows to one camera, sees nothing, and concludes the code
7724
- * path was never taken.
7725
- */
7726
- perDevice: boolean()
7727
- });
7728
- /**
7729
- * An armed window over one channel, as the document hands it to a mirror.
7730
- *
7731
- * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
7732
- * expires by itself, which is the one failure a boolean cannot avoid.
7733
- */
7734
- var LogChannelWindowSchema = object({
7735
- channel: string().min(1),
7736
- /** Epoch ms the window closes at. */
7737
- armedUntilMs: number(),
7738
- /** `null` = every camera. A non-empty list narrows to those numeric ids. */
7739
- deviceIds: array(number().int()).readonly().nullable()
7740
- });
7741
- /**
7742
7637
  * Ops-log — the durable, append-only operations audit shared by the
7743
7638
  * recordings and events management surfaces.
7744
7639
  *
@@ -8684,8 +8579,11 @@ var StorageLocationTypeSchema = string().regex(/^[a-z][a-zA-Z0-9-]*$/);
8684
8579
  * `STORAGE_LOCATION_CARDINALITY` map has been removed.
8685
8580
  *
8686
8581
  * `id` is a stable namespaced string of the form `<type>:<slug>`.
8687
- * The default location for a type uses `id === <type>:default` by
8688
- * convention (the bare type ref like `'backups'` resolves to it).
8582
+ * The seed names its first instance `<type>:default` — a NAME, not a flag.
8583
+ * There is no default location any more (D383): `enabled` is the whole write
8584
+ * model, and a bare type ref resolves to the sole location of the type, or —
8585
+ * transitionally, only while legacy NULL-stamped rows exist — to the row whose
8586
+ * slug is `default`.
8689
8587
  *
8690
8588
  * `isSystem` is a legacy persisted flag. Seed still creates the initial
8691
8589
  * `<type>:default` locations; the flag is no longer a lock, a badge, or a
@@ -8706,21 +8604,20 @@ var StorageLocationSchema = object({
8706
8604
  * flag at upsert time, not here (the schema is provider-agnostic).
8707
8605
  */
8708
8606
  nodeId: string().optional(),
8709
- isDefault: boolean().default(false),
8710
8607
  isSystem: boolean().default(false),
8711
8608
  /**
8712
- * Operator opt-in: whether consumers that BALANCE across several locations
8713
- * of a type may write here. Recordings reads it today; event media and
8714
- * backups are the next consumers, which is why the flag lives on the
8715
- * location rather than in any one addon's store nothing has to be
8716
- * extended to add the next consumer.
8609
+ * THE write switch, and the only one (D383). `enabled: true` means every
8610
+ * consumer that chooses a write target for this type may write here, and all
8611
+ * enabled locations of a type are used TOGETHER; `false` means read-only
8612
+ * still read, still played back, still age-swept, still drained, never
8613
+ * written.
8717
8614
  *
8718
- * OPTIONAL, and ABSENT MEANS ACTIVE. Every location persisted before the
8719
- * flag existed reads back with no flag and keeps working exactly as before;
8720
- * that is the whole compat story, and it is why no migration ships with it.
8721
- * A newly CREATED sibling is stamped `false` by the orchestrator (creating a
8722
- * disk must not silently start writing to it); the default of a type is
8723
- * always stamped `true`.
8615
+ * OPTIONAL only for the wire: an upsert that omits it means "leave what is
8616
+ * stored" on an update and "born inert unless it is the first location of its
8617
+ * type" on a create. On a PERSISTED row absence is legacy and it means
8618
+ * enabled {@link isLocationEnabled} is the one place that says so, and the
8619
+ * orchestrator stamps every flagless row `true` once at hydrate so absence
8620
+ * stops existing rather than being re-derived on every read.
8724
8621
  */
8725
8622
  enabled: boolean().optional(),
8726
8623
  /** COMPUTED at read time by the orchestrator (statfs of the backing volume
@@ -8733,10 +8630,12 @@ var StorageLocationSchema = object({
8733
8630
  createdAt: number(),
8734
8631
  updatedAt: number()
8735
8632
  });
8633
+ object({ isDefault: boolean().optional() });
8736
8634
  /**
8737
8635
  * Reference accepted by consumer-facing `api.storage.*` calls.
8738
8636
  * Either:
8739
- * - a `StorageLocationType` (e.g. `'backups'`) → orchestrator resolves to the default of that type
8637
+ * - a `StorageLocationType` (e.g. `'backups'`) → the sole location of that type
8638
+ * (transitionally, the `<type>:default`-slugged row when several exist)
8740
8639
  * - a fully-qualified id (e.g. `'backups:nas-01'`) → addresses a specific instance
8741
8640
  *
8742
8641
  * The orchestrator's `resolveRef(ref)` handles both cases.
@@ -8912,6 +8811,111 @@ var DecoderSessionConfigSchema = object({
8912
8811
  */
8913
8812
  debug: boolean().optional()
8914
8813
  });
8814
+ /**
8815
+ * Per-component log CHANNELS — the gate a hot path consults, and the registry
8816
+ * an addon declares its channels in.
8817
+ *
8818
+ * ## Two axes, deliberately separated
8819
+ *
8820
+ * - **DECLARATION** — which channels exist. Only the addon knows:
8821
+ * `stream-broker` knows webrtc/ICE/RTP, `provider-reolink` knows
8822
+ * baichuan/handshake. A hand-wired central list rots at the first addition,
8823
+ * and rots silently. So a channel is declared where it is consulted, and the
8824
+ * `log-channels` capability enumerates the declarations.
8825
+ * - **VALUE** — at which level, for which scope, until when. That stays ONE
8826
+ * thing: the logging settings document on the `system` cap. Two authorities
8827
+ * over the values is the exact defect
8828
+ * `docs/design/plans/2026-08-26-logging-per-componente.md` was written to
8829
+ * remove; re-introducing it from the cure side would be grotesque.
8830
+ *
8831
+ * Nothing in this file reads a clock, an env var or a store. The registry is
8832
+ * a MIRROR: it is moved only by {@link LogChannelRegistry.apply}, called off
8833
+ * the hot path with a value somebody actually read, and by
8834
+ * {@link LogChannelRegistry.tick}, called on a timer. A store read that fails
8835
+ * never reaches here, so it can neither disarm an armed channel nor arm a
8836
+ * disarmed one (D49).
8837
+ *
8838
+ * ## The canonical call shape
8839
+ *
8840
+ * ```ts
8841
+ * if (CH_RTP.on && CH_RTP.wants(deviceId)) {
8842
+ * CH_RTP.log(logger, 'rtp subscriber added', { tags: { deviceId }, meta: { ssrc } })
8843
+ * }
8844
+ * ```
8845
+ *
8846
+ * `on` is a plain boolean FIELD — never a getter — and it is the FIRST thing
8847
+ * read. Disarmed, a call site costs one load and one branch, and the `extras`
8848
+ * object literal is never constructed because it lives inside the branch. It
8849
+ * is the same shape already proven in production at `stream-broker.ts:1650`,
8850
+ * and the same discipline `LoggingGate.allowsDestination` uses for the
8851
+ * destination floor (measured at 1.93 ns/call when off).
8852
+ *
8853
+ * ## Why a channel emits at `info`
8854
+ *
8855
+ * `loki-logging.addon.ts` pins the destination default at `info` and
8856
+ * `loki-destination.ts` drops everything below it, so a line emitted at
8857
+ * `debug` never reaches Loki and the hub's in-memory ring only holds ~35
8858
+ * minutes. A diagnostic that cannot be read an hour later is worse than no
8859
+ * diagnostic, because it looks done. {@link LogChannelGate.log} therefore
8860
+ * emits at the channel's declared level, whose schema floor is `info`.
8861
+ */
8862
+ /**
8863
+ * The level a channel writes at once armed.
8864
+ *
8865
+ * `debug` is absent ON PURPOSE and not by omission: below `info` the line does
8866
+ * not leave the process for Loki, and the whole point of arming a channel is
8867
+ * to read it later.
8868
+ */
8869
+ var LogChannelLevelSchema = _enum([
8870
+ "info",
8871
+ "warn",
8872
+ "error"
8873
+ ]);
8874
+ /**
8875
+ * What an addon declares about one channel. No value, no state — a
8876
+ * declaration is inert.
8877
+ */
8878
+ var LogChannelDescriptorSchema = object({
8879
+ /**
8880
+ * Dotted `area.thing`, unique across the workspace. `area` is conventionally
8881
+ * the addon's short name so an operator reading a channel list can tell who
8882
+ * owns it without a second lookup.
8883
+ */
8884
+ name: string().min(3).regex(/^[a-z0-9-]+(\.[a-z0-9-]+)+$/, "a channel name is dotted lower-kebab, e.g. area.thing"),
8885
+ /** One sentence: what the operator will SEE after arming it. */
8886
+ description: string().min(1),
8887
+ /** The level its lines are emitted at. Never below `info`. */
8888
+ defaultLevel: LogChannelLevelSchema,
8889
+ /**
8890
+ * Whether this channel can be narrowed to a camera.
8891
+ *
8892
+ * `true` is a PROMISE with two halves, and both must hold: the gate is
8893
+ * consulted with the numeric device id, AND every line the channel admits
8894
+ * carries `tags: { deviceId }` with that same numeric id. The second half is
8895
+ * what makes `| json | deviceId="617"` work in Loki — `loki-payload.ts`
8896
+ * keeps `deviceId` out of the stream labels for cardinality, so the tag in
8897
+ * the body is the only way to filter.
8898
+ *
8899
+ * A channel whose lines carry the device only in `meta` (or not at all) is
8900
+ * declared `false`. Declaring it `true` anyway would be a lie the UI repeats:
8901
+ * the operator narrows to one camera, sees nothing, and concludes the code
8902
+ * path was never taken.
8903
+ */
8904
+ perDevice: boolean()
8905
+ });
8906
+ /**
8907
+ * An armed window over one channel, as the document hands it to a mirror.
8908
+ *
8909
+ * A window is a DEADLINE, never a flag (ADR-0244): a channel somebody forgot
8910
+ * expires by itself, which is the one failure a boolean cannot avoid.
8911
+ */
8912
+ var LogChannelWindowSchema = object({
8913
+ channel: string().min(1),
8914
+ /** Epoch ms the window closes at. */
8915
+ armedUntilMs: number(),
8916
+ /** `null` = every camera. A non-empty list narrows to those numeric ids. */
8917
+ deviceIds: array(number().int()).readonly().nullable()
8918
+ });
8915
8919
  var MODEL_FORMATS = [
8916
8920
  "onnx",
8917
8921
  "coreml",
@@ -10568,12 +10572,30 @@ var BackupDestinationInfoSchema = object({
10568
10572
  lastSuccessAt: number().optional(),
10569
10573
  /** Newest-archive size from `manifests.json`, or undefined. */
10570
10574
  lastSuccessSizeBytes: number().optional(),
10571
- /** Per-destination cron expression. Empty = manual-only (no schedule). */
10575
+ /**
10576
+ * Cron cadence(s) of the ENABLED schedules that fan out to this
10577
+ * destination, comma-joined. Absent when no enabled schedule targets it
10578
+ * — a destination nothing is scheduled to write to must not advertise a
10579
+ * cadence (D384). This is never the `backup_destination_policies.cron`
10580
+ * column: that per-location cron has scheduled nothing since 2026-07-28
10581
+ * and reading it made a destination with a DISABLED schedule claim a
10582
+ * nightly run.
10583
+ */
10572
10584
  cron: string().optional(),
10573
- /** ms-epoch of next computed firing for this destination's cron, if any. */
10585
+ /** ms-epoch of the next firing across those schedules (earliest), if any. */
10574
10586
  nextRunAt: number().optional(),
10575
- /** ms-epoch of last successful scheduled run (mirrors policy.lastRunAt). */
10576
- lastRunAt: number().optional()
10587
+ /**
10588
+ * ms-epoch of the last time a run ATTEMPTED to write here — success or
10589
+ * failure. Never a success stamp: pair it with `lastSuccessAt` (the
10590
+ * newest archive that actually landed) and `lastError`.
10591
+ */
10592
+ lastAttemptAt: number().optional(),
10593
+ /**
10594
+ * Why the last attempt failed, verbatim. Absent when the last attempt
10595
+ * landed the archive. A destination that has never been written to has
10596
+ * neither this nor `lastAttemptAt`.
10597
+ */
10598
+ lastError: string().optional()
10577
10599
  });
10578
10600
  /**
10579
10601
  * Per-archive entry returned by `backup.listArchives({ destinationId })`.
@@ -10736,8 +10758,16 @@ var BackupScheduleSchema = object({
10736
10758
  retentionCount: number().int().min(1).max(1e3),
10737
10759
  /** Optional subset of source locations to include; omitted = all. */
10738
10760
  dataSources: array(string()).readonly().optional(),
10739
- /** ms-epoch of last successful run. */
10740
- lastRunAt: number().optional(),
10761
+ /**
10762
+ * ms-epoch of the last tick that FIRED this schedule. Stamped before the
10763
+ * archive runs (it is the dedupe anchor), so it says "attempted", never
10764
+ * "succeeded" — a run refused by every destination stamps it too.
10765
+ */
10766
+ lastAttemptAt: number().optional(),
10767
+ /** ms-epoch of the last run of this schedule that landed at ≥1 destination. */
10768
+ lastSuccessAt: number().optional(),
10769
+ /** Why the last fired run failed, verbatim. Absent when it succeeded. */
10770
+ lastError: string().optional(),
10741
10771
  /** ms-epoch of next computed firing (read-only, filled on list). */
10742
10772
  nextRunAt: number().optional()
10743
10773
  });
@@ -10786,14 +10816,7 @@ method(_void(), array(BackupDestinationInfoSchema).readonly(), { auth: "admin" }
10786
10816
  locationId: string(),
10787
10817
  enabled: boolean(),
10788
10818
  retentionCount: number().int().min(1).max(1e3),
10789
- label: string().optional(),
10790
- /**
10791
- * Per-destination cron expression. Empty string clears the
10792
- * schedule (manual-only). Validated server-side via croner;
10793
- * malformed expressions reject the upsert with an actionable
10794
- * message.
10795
- */
10796
- cron: string().optional()
10819
+ label: string().optional()
10797
10820
  }), _void(), {
10798
10821
  kind: "mutation",
10799
10822
  auth: "admin"
@@ -21570,7 +21593,7 @@ method(object({
21570
21593
  downloadId: string(),
21571
21594
  offset: number(),
21572
21595
  length: number()
21573
- }), _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({
21596
+ }), _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({
21574
21597
  createdAt: true,
21575
21598
  updatedAt: true
21576
21599
  }), StorageLocationSchema, {
@@ -34419,12 +34442,6 @@ Object.freeze({
34419
34442
  addonId: null,
34420
34443
  access: "view"
34421
34444
  },
34422
- "storage.getDefaultLocation": {
34423
- capName: "storage",
34424
- capScope: "system",
34425
- addonId: null,
34426
- access: "view"
34427
- },
34428
34445
  "storage.list": {
34429
34446
  capName: "storage",
34430
34447
  capScope: "system",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-smtp-nodemailer",
3
- "version": "1.2.76",
3
+ "version": "1.2.78",
4
4
  "description": "SMTP email provider addon for CamStack — wraps `nodemailer` and registers a `smtp-provider` cap collection entry. Used by magic-link login + notifier addons.",
5
5
  "keywords": [
6
6
  "camstack",