@camstack/addon-post-analysis 1.2.307 → 1.2.309

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.
@@ -12510,6 +12510,68 @@ method(object({
12510
12510
  password: string()
12511
12511
  }), AuthResultSchema.nullable(), { kind: "mutation" }), method(object({ state: string() }), string()), method(record(string(), string()), AuthResultSchema, { kind: "mutation" }), method(object({ token: string() }), AuthResultSchema.nullable());
12512
12512
  /**
12513
+ * How long one snapshot may take end to end: the pinned copy of the whole
12514
+ * database plus `PRAGMA integrity_check` over the copy, on the hub's slowest
12515
+ * disk. ~800 MB at a pessimistic 10 MB/s is under 3 minutes; the bound is
12516
+ * generous because a timeout fails the whole backup run.
12517
+ */
12518
+ var DATABASE_SNAPSHOT_TIMEOUT_MS = 30 * 6e4;
12519
+ /**
12520
+ * The databases an owner snapshots — declared by the OWNER, so a caller never
12521
+ * guesses which file is live from what sits beside it (a cleanly closed
12522
+ * database has no sidecars and is just as owned). Paths are absolute on the
12523
+ * owner's host.
12524
+ */
12525
+ var DatabaseSnapshotTargetsSchema = object({ databases: array(object({ livePath: string() })) });
12526
+ /** One b-tree table of the snapshot and the rows it holds. */
12527
+ var DatabaseSnapshotTableSchema = object({
12528
+ name: string(),
12529
+ rows: number().int().nonnegative()
12530
+ });
12531
+ /**
12532
+ * What the owner wrote. Every path is ABSOLUTE on the owner's host — the
12533
+ * caller pins the call to its own node, so it can read the file; a caller
12534
+ * that finds the path outside its own data root refuses it rather than
12535
+ * archiving something it cannot place.
12536
+ */
12537
+ var DatabaseSnapshotResultSchema = object({
12538
+ /** The live database the snapshot copies. Never to be copied as a file. */
12539
+ livePath: string(),
12540
+ /** The verified copy: `<livePath>` + {@link DATABASE_SNAPSHOT_SUFFIX}. */
12541
+ snapshotPath: string(),
12542
+ sizeBytes: number().int().nonnegative(),
12543
+ pageCount: number().int().nonnegative(),
12544
+ pageSize: number().int().positive(),
12545
+ /**
12546
+ * Every b-tree table with its row count. Read inside the SAME read
12547
+ * transaction the copy was taken from, and found EQUAL on the copy — so
12548
+ * this is the content of the snapshot, not an estimate of the source.
12549
+ */
12550
+ tables: array(DatabaseSnapshotTableSchema),
12551
+ /** Wall time of the pinned copy (row counts included). */
12552
+ copyMs: number().nonnegative(),
12553
+ /** Wall time of the checks on the copy (`integrity_check`, row counts). */
12554
+ verifyMs: number().nonnegative(),
12555
+ /** When the pinned read transaction began (ms epoch) — the snapshot's instant. */
12556
+ takenAt: number()
12557
+ });
12558
+ /**
12559
+ * A snapshot as an ARCHIVE records it (`ArchiveManifest.sqliteSnapshots`):
12560
+ * the same facts, with both paths relative to the archive root (the node's
12561
+ * data dir), because an archive outlives the host that made it.
12562
+ */
12563
+ var ArchiveSqliteSnapshotSchema = DatabaseSnapshotResultSchema.extend({
12564
+ /** Archive-relative path of the live database the archive does NOT carry. */
12565
+ livePath: string(),
12566
+ /** Archive-relative path of the verified copy it carries in its place. */
12567
+ snapshotPath: string()
12568
+ });
12569
+ method(object({}), DatabaseSnapshotTargetsSchema, { auth: "admin" }), method(object({}), DatabaseSnapshotResultSchema, {
12570
+ kind: "mutation",
12571
+ auth: "admin",
12572
+ timeoutMs: DATABASE_SNAPSHOT_TIMEOUT_MS
12573
+ });
12574
+ /**
12513
12575
  * Orchestrator-side destination metadata. The orchestrator computes
12514
12576
  * `id = <addonId>:<subId>` from its provider lookup so consumers
12515
12577
  * (admin UI, restore flow) see one canonical key.
@@ -12620,7 +12682,12 @@ var ArchiveManifestSchema = object({
12620
12682
  locations: array(string()),
12621
12683
  entries: array(ArchiveEntrySchema),
12622
12684
  totalBytes: number(),
12623
- totalFiles: number()
12685
+ totalFiles: number(),
12686
+ /**
12687
+ * Live SQLite databases this archive carries as their OWNER's verified
12688
+ * snapshot instead of as files (D693). Absent on archives made before.
12689
+ */
12690
+ sqliteSnapshots: array(ArchiveSqliteSnapshotSchema).optional()
12624
12691
  });
12625
12692
  var LocationStatSchema = object({
12626
12693
  name: string(),
@@ -14150,6 +14217,52 @@ var CompositionBlockStateSchema = object({
14150
14217
  reason: string().optional(),
14151
14218
  fields: array(CompositionFieldStateSchema)
14152
14219
  });
14220
+ var ComposerBlockSchema = object({
14221
+ id: string().min(1),
14222
+ name: string().min(1).max(120),
14223
+ enabled: boolean(),
14224
+ updatedAt: number(),
14225
+ composition: CompositionSchema
14226
+ });
14227
+ /**
14228
+ * A stored composition row that no longer PARSES — a schema a release
14229
+ * tightened, a row written by a newer build. Sent by id so the composer keeps
14230
+ * its device as a placeholder and reports the block `failed` naming the parse
14231
+ * error. Leaving it out would read, twice, exactly like a delete (D49).
14232
+ */
14233
+ var ComposerUnreadableBlockSchema = object({
14234
+ id: string().min(1),
14235
+ /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
14236
+ name: string().nullable(),
14237
+ /** The parse error, in the operator's words. */
14238
+ error: string()
14239
+ });
14240
+ method(object({
14241
+ /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
14242
+ integrationId: string().nullable(),
14243
+ /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
14244
+ storeLoaded: boolean(),
14245
+ blocks: array(ComposerBlockSchema),
14246
+ /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
14247
+ restartBlockIds: array(string()),
14248
+ /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
14249
+ unreadableBlocks: array(ComposerUnreadableBlockSchema)
14250
+ }), object({
14251
+ blocks: array(object({
14252
+ blockId: string(),
14253
+ status: CompositionRunStatusSchema,
14254
+ reason: string().optional()
14255
+ })),
14256
+ /**
14257
+ * False when the composer declared and withdrew NOTHING (store not loaded,
14258
+ * integration unknown, its own rows unread or read empty once). An empty
14259
+ * apply the caller owes is paid off only by one the composer acted on (D49).
14260
+ */
14261
+ acted: boolean()
14262
+ }), {
14263
+ kind: "mutation",
14264
+ auth: "admin"
14265
+ }), method(object({ blockIds: array(string()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
14153
14266
  var NUMBER = {
14154
14267
  kind: "fixed",
14155
14268
  result: ["number"]
@@ -14386,52 +14499,6 @@ method(object({}), object({ blocks: array(CoreBlockSchema) }), { auth: "admin" }
14386
14499
  auth: "admin",
14387
14500
  access: "view"
14388
14501
  });
14389
- var ComposerBlockSchema = object({
14390
- id: string().min(1),
14391
- name: string().min(1).max(120),
14392
- enabled: boolean(),
14393
- updatedAt: number(),
14394
- composition: CompositionSchema
14395
- });
14396
- /**
14397
- * A stored composition row that no longer PARSES — a schema a release
14398
- * tightened, a row written by a newer build. Sent by id so the composer keeps
14399
- * its device as a placeholder and reports the block `failed` naming the parse
14400
- * error. Leaving it out would read, twice, exactly like a delete (D49).
14401
- */
14402
- var ComposerUnreadableBlockSchema = object({
14403
- id: string().min(1),
14404
- /** The row's stored name column; null when even that is unreadable (the device keeps the name it has). */
14405
- name: string().nullable(),
14406
- /** The parse error, in the operator's words. */
14407
- error: string()
14408
- });
14409
- method(object({
14410
- /** The shared Blocks integration; null until `core-blocks` has reconciled it. */
14411
- integrationId: string().nullable(),
14412
- /** False when the `core_blocks` read failed: then nothing may be withdrawn (D49). */
14413
- storeLoaded: boolean(),
14414
- blocks: array(ComposerBlockSchema),
14415
- /** Operator restarts: rebuild these runtimes and re-resolve their sources. Stores nothing (D62). */
14416
- restartBlockIds: array(string()),
14417
- /** Composition rows that exist but do not parse: held, never withdrawn, reported failed. */
14418
- unreadableBlocks: array(ComposerUnreadableBlockSchema)
14419
- }), object({
14420
- blocks: array(object({
14421
- blockId: string(),
14422
- status: CompositionRunStatusSchema,
14423
- reason: string().optional()
14424
- })),
14425
- /**
14426
- * False when the composer declared and withdrew NOTHING (store not loaded,
14427
- * integration unknown, its own rows unread or read empty once). An empty
14428
- * apply the caller owes is paid off only by one the composer acted on (D49).
14429
- */
14430
- acted: boolean()
14431
- }), {
14432
- kind: "mutation",
14433
- auth: "admin"
14434
- }), method(object({ blockIds: array(string()) }), object({ states: array(CompositionBlockStateSchema) }), { auth: "admin" });
14435
14502
  /**
14436
14503
  * `custom-model-registry` — collection cap exposing operator-registered
14437
14504
  * custom detection models. Each provider (today: `addon-model-studio`)
@@ -16388,6 +16455,219 @@ method(object({
16388
16455
  caps: array(string()).readonly().optional()
16389
16456
  }), record(string(), record(string(), unknown().nullable())));
16390
16457
  /**
16458
+ * Doorbell button cap. Two kinds of providers coexist behind this cap
16459
+ * name (same pattern as `snapshot`):
16460
+ *
16461
+ * - **Native** providers: registered per-device by device-driver
16462
+ * addons via `ctx.registerNativeCap` — either on a
16463
+ * `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
16464
+ * or directly on the camera (Reolink registers at camera level).
16465
+ * Emits an `onPressed` event every time the firmware pushes a
16466
+ * ring; status tracks the last press and a pressCount since start
16467
+ * (diagnostic).
16468
+ *
16469
+ * - **Wrapper** provider: the `virtual-doorbell` system builtin
16470
+ * (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
16471
+ * device (contact / switch / event-emitter …) into a doorbell for
16472
+ * a camera. `defaultActive: false` — the operator explicitly binds
16473
+ * it per camera in the device-bindings UI, then picks the source
16474
+ * device + trigger in the per-device settings.
16475
+ *
16476
+ * The DeviceEventPropagator re-emits `onPressed` on the camera parent
16477
+ * — subscribers listening at the camera level receive ring events
16478
+ * with `via[]` populated. No code on the parent needed.
16479
+ */
16480
+ var DoorbellStatusSchema = object({
16481
+ /** Ms epoch of the last press. null = never observed since this provider started. */
16482
+ lastPressedAt: number().nullable(),
16483
+ /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
16484
+ pressCountSinceStart: number()
16485
+ });
16486
+ var DoorbellPressEventSchema = object({
16487
+ deviceId: number(),
16488
+ timestamp: number()
16489
+ });
16490
+ /**
16491
+ * The `doorbell-source` extension slot's editable value (D648): the camera's
16492
+ * virtual-doorbell trigger devices, exactly what the wrapper's
16493
+ * `doorbellSources` persists (as `{ deviceId }` records).
16494
+ */
16495
+ var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number().int().positive()) });
16496
+ /**
16497
+ * The `doorbell-source` slot — which devices ring this camera's VIRTUAL
16498
+ * doorbell, owned by the `virtual-doorbell` wrapper over its
16499
+ * `doorbellSources` store (D648). A source rings when one of its
16500
+ * `SOURCE_CAPS` rises. Whether the wrapper is bound to the camera at all is a
16501
+ * different authority (`deviceManager.setWrapperActive`, D62) — the slot
16502
+ * reports it, it never writes it.
16503
+ */
16504
+ var DOORBELL_SOURCE_SLOT = {
16505
+ id: "doorbell-source",
16506
+ label: "Doorbell trigger devices",
16507
+ description: "Any of these becoming active rings this camera's virtual doorbell: a binary sensor when it goes active, a switch when it turns on.",
16508
+ shape: "association",
16509
+ hostDeviceTypes: [DeviceType.Camera],
16510
+ sourceCaps: SOURCE_CAPS,
16511
+ cardinality: "many",
16512
+ value: DoorbellSourceSlotValueSchema
16513
+ };
16514
+ var doorbellCapability = {
16515
+ name: "doorbell",
16516
+ scope: "device",
16517
+ deviceNative: true,
16518
+ mode: "singleton",
16519
+ kind: "wrapper",
16520
+ defaultActive: false,
16521
+ deviceTypes: [DeviceType.Button, DeviceType.Camera],
16522
+ extensionSlots: [DOORBELL_SOURCE_SLOT],
16523
+ methods: {},
16524
+ events: {
16525
+ /**
16526
+ * Fires once per physical press. Reolink delivers via Baichuan
16527
+ * push (`ReolinkSimpleEvent.type === 'doorbell'`). There is no
16528
+ * release/duration — it's a pulse.
16529
+ */
16530
+ onPressed: {
16531
+ data: DoorbellPressEventSchema,
16532
+ fromState: {
16533
+ field: "lastPressedAt",
16534
+ on: "advance"
16535
+ }
16536
+ } },
16537
+ status: {
16538
+ schema: DoorbellStatusSchema,
16539
+ kind: "push"
16540
+ },
16541
+ /**
16542
+ * Runtime-state slice — last press timestamp + lifetime press count.
16543
+ * Mirrored by the kernel and readable via
16544
+ * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
16545
+ * without subscribing.
16546
+ */
16547
+ runtimeState: DoorbellStatusSchema,
16548
+ /**
16549
+ * Runtime-state durability: **restored** — a monotonic accumulator: the slice IS the record. `lastPressedAt` is content here, not a clock, so it is deliberately NOT volatile.
16550
+ *
16551
+ * See `RuntimeStateDurability`. Enforced by
16552
+ * `scripts/check-runtime-state-durability.ts`.
16553
+ */
16554
+ durability: "restored"
16555
+ };
16556
+ var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
16557
+ DeviceType.Camera, DeviceType.Camera;
16558
+ /** A slot's editable value, discriminated on `slot`. */
16559
+ var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
16560
+ DeviceType.Camera;
16561
+ var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
16562
+ state: literal("unreachable"),
16563
+ reason: string()
16564
+ })]);
16565
+ /** One provider of slots — the D554 source-listing row. */
16566
+ var ExtensionSourceSchema = object({
16567
+ /** The routing prefix of every `slotRef` this provider serves. */
16568
+ source: string(),
16569
+ label: string(),
16570
+ /** Stamped by the dispatcher from the registry (D557). */
16571
+ addonId: string().optional(),
16572
+ availability: ExtensionSourceAvailabilitySchema
16573
+ });
16574
+ /**
16575
+ * How one picked source stands. `missing` — no such device (deleted, or an id
16576
+ * that never existed); `foreign` — a device the slot's owner cannot read from
16577
+ * (a source owned by another addon); `unavailable` — it exists but is not a
16578
+ * valid source now (a container, which is never a pick). A source in any of
16579
+ * these states is SHOWN, never silently dropped or re-pointed.
16580
+ */
16581
+ var ExtensionSourceHealthSchema = _enum([
16582
+ "ok",
16583
+ "missing",
16584
+ "foreign",
16585
+ "unavailable"
16586
+ ]);
16587
+ var ExtensionSlotSourceSchema = object({
16588
+ deviceId: number().int(),
16589
+ /** The device's name, or null when it could not be resolved (`missing`). */
16590
+ name: string().nullable(),
16591
+ health: ExtensionSourceHealthSchema,
16592
+ detail: string().optional()
16593
+ });
16594
+ /**
16595
+ * A DIFFERENT authority that gates whether the slot's sources do anything —
16596
+ * reported read-only, named, never written through this contract (D62). The
16597
+ * virtual doorbell's sources ring only while the wrapper is bound to the
16598
+ * camera, and that binding belongs to `deviceManager.setWrapperActive`.
16599
+ * `unknown` means the gate could not be read; it is not "inactive" (D315).
16600
+ */
16601
+ var ExtensionSlotActivationSchema = object({
16602
+ state: _enum([
16603
+ "active",
16604
+ "inactive",
16605
+ "unknown"
16606
+ ]),
16607
+ authority: string(),
16608
+ detail: string().optional()
16609
+ });
16610
+ var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
16611
+ state: literal("ok"),
16612
+ /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
16613
+ slotRef: string(),
16614
+ slot: ExtensionSlotIdSchema,
16615
+ /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
16616
+ authority: string(),
16617
+ activation: ExtensionSlotActivationSchema.nullable(),
16618
+ value: ExtensionSlotValueSchema,
16619
+ sources: array(ExtensionSlotSourceSchema),
16620
+ /**
16621
+ * Devices the owner links to the host ON ITS OWN, by structure, and that
16622
+ * are therefore not in `value` (D655): a camera's device-tree children, and
16623
+ * the child a picked container stands for (D356 — a container is never a
16624
+ * pick, its children are). Read-only; the editor shows them and may offer
16625
+ * per-device options on them (the linked-devices tracked-event opt-in).
16626
+ * Absent when the owner links nothing beyond the picks, and from an owner
16627
+ * older than D655.
16628
+ */
16629
+ impliedSources: array(ExtensionSlotSourceSchema).optional()
16630
+ }), object({
16631
+ state: literal("unreachable"),
16632
+ addonId: string(),
16633
+ reason: string()
16634
+ })]);
16635
+ var ExtensionCandidatesSchema = object({ candidates: array(object({
16636
+ deviceId: number().int(),
16637
+ name: string(),
16638
+ type: string(),
16639
+ location: string().nullable(),
16640
+ /** The container a child belongs to — "Spotlight 2" alone does not say which. */
16641
+ parentName: string().nullable(),
16642
+ /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
16643
+ suggested: boolean(),
16644
+ /** Why it is suggested ("same location"), null when it is not. */
16645
+ reason: string().nullable()
16646
+ })) });
16647
+ /**
16648
+ * What a write did. `none` — applied in place. `host` / `parent` — the owner
16649
+ * reloaded the host (or, for an accessory child, its parent) because the
16650
+ * write changed what the host REGISTERS. A slot never adds a capability to its
16651
+ * host — that is a composition (D663) — so today's owners answer `none`.
16652
+ */
16653
+ var ExtensionSetResultSchema = object({
16654
+ applied: literal(true),
16655
+ reload: _enum([
16656
+ "none",
16657
+ "host",
16658
+ "parent"
16659
+ ])
16660
+ });
16661
+ var ExtensionSlotRefInputSchema = object({
16662
+ deviceId: number().int(),
16663
+ slotRef: string().min(1)
16664
+ });
16665
+ var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
16666
+ method(object({ deviceId: number().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
16667
+ kind: "mutation",
16668
+ auth: "admin"
16669
+ });
16670
+ /**
16391
16671
  * Per-field ownership (D663). A composition may CLAIM fields of a native
16392
16672
  * cap's runtime-state slice on an existing device: `replace` overlays the
16393
16673
  * claimed fields on the native slice, `add` builds a slice the device does
@@ -19557,17 +19837,25 @@ var NcScheduleSchema = object({
19557
19837
  */
19558
19838
  var NcSystemEventDeliveryModeSchema = _enum(["instant", "summary"]);
19559
19839
  /**
19840
+ * How a summary window is SENT (D698): `rule` (absent) = ONE notification with
19841
+ * every section; `section` = one notification per section with something to
19842
+ * say (an unavailable section included), each titled by its section.
19843
+ */
19844
+ var NcStateSummarySplitSchema = _enum(["rule", "section"]);
19845
+ /**
19560
19846
  * `summary`: the rule sends NOTHING per event. When a window of `schedule`
19561
19847
  * CLOSES, it sends one notification with the current state of its kinds
19562
19848
  * (low batteries, consumables to replace, devices offline, updates
19563
- * available, ...), after its own filters. Nothing to report sends nothing.
19849
+ * available, ...), after its own filters — or, with `split: 'section'`
19850
+ * (D698), one notification per section. Nothing to report sends nothing.
19564
19851
  * The schedule is the ordinary `NcSchedule` (weekly windows, IANA timezone,
19565
19852
  * midnight crossing); the send time is each window's END. Refused on the
19566
19853
  * `alarm` family, which stays instant (`systemEventDeliveryProblems`).
19567
19854
  */
19568
19855
  var NcSystemEventDeliverySchema = discriminatedUnion("mode", [object({ mode: literal("instant") }), object({
19569
19856
  mode: literal("summary"),
19570
- schedule: NcScheduleSchema
19857
+ schedule: NcScheduleSchema,
19858
+ split: NcStateSummarySplitSchema.optional()
19571
19859
  })]);
19572
19860
  /** Fuzzy plate matcher — OCR noise makes exact match useless (spec row 12/13). */
19573
19861
  var NcPlateMatcherSchema = object({
@@ -20584,11 +20872,23 @@ var NcStateSummaryPreviewSectionSchema = object({
20584
20872
  reason: string().optional()
20585
20873
  });
20586
20874
  /**
20875
+ * One notification a previewed summary would send (D698): the whole summary on
20876
+ * a `rule` split (no `section`), one section's on a `section` split.
20877
+ */
20878
+ var NcStateSummaryPreviewRowSchema = object({
20879
+ section: string().optional(),
20880
+ /** The section's name on a per-section row; every reported section's, joined, on a combined one. */
20881
+ title: string(),
20882
+ text: string(),
20883
+ count: number().int().nonnegative()
20884
+ });
20885
+ /**
20587
20886
  * The summary a rule would send now. `empty` = nothing to report and every
20588
20887
  * section read: such a summary is NOT sent. `dropped` counts the open states
20589
20888
  * the rule's own filters (or a camera mute) left out, by reason.
20590
20889
  * `excludedGroups` names the kind groups selected that have no state to report
20591
- * (backups & exports).
20890
+ * (backups & exports). `split` and `rows` (D698) say how it would be sent —
20891
+ * optional, so an older hub's answer still parses.
20592
20892
  */
20593
20893
  var NcStateSummaryPreviewSchema = object({
20594
20894
  empty: boolean(),
@@ -20596,7 +20896,9 @@ var NcStateSummaryPreviewSchema = object({
20596
20896
  text: string(),
20597
20897
  sections: array(NcStateSummaryPreviewSectionSchema),
20598
20898
  dropped: record(string(), number().int().nonnegative()),
20599
- excludedGroups: array(string())
20899
+ excludedGroups: array(string()),
20900
+ split: NcStateSummarySplitSchema.optional(),
20901
+ rows: array(NcStateSummaryPreviewRowSchema).optional()
20600
20902
  });
20601
20903
  var NcTestResultSchema = object({
20602
20904
  recordId: string(),
@@ -29701,219 +30003,6 @@ DeviceType.Camera, method(object({
29701
30003
  auth: "protected"
29702
30004
  });
29703
30005
  /**
29704
- * Doorbell button cap. Two kinds of providers coexist behind this cap
29705
- * name (same pattern as `snapshot`):
29706
- *
29707
- * - **Native** providers: registered per-device by device-driver
29708
- * addons via `ctx.registerNativeCap` — either on a
29709
- * `DeviceType.Button` accessory with `role: DeviceRole.Doorbell`,
29710
- * or directly on the camera (Reolink registers at camera level).
29711
- * Emits an `onPressed` event every time the firmware pushes a
29712
- * ring; status tracks the last press and a pressCount since start
29713
- * (diagnostic).
29714
- *
29715
- * - **Wrapper** provider: the `virtual-doorbell` system builtin
29716
- * (`@camstack/system/builtins/doorbell`). Turns ANY binary-ish
29717
- * device (contact / switch / event-emitter …) into a doorbell for
29718
- * a camera. `defaultActive: false` — the operator explicitly binds
29719
- * it per camera in the device-bindings UI, then picks the source
29720
- * device + trigger in the per-device settings.
29721
- *
29722
- * The DeviceEventPropagator re-emits `onPressed` on the camera parent
29723
- * — subscribers listening at the camera level receive ring events
29724
- * with `via[]` populated. No code on the parent needed.
29725
- */
29726
- var DoorbellStatusSchema = object({
29727
- /** Ms epoch of the last press. null = never observed since this provider started. */
29728
- lastPressedAt: number().nullable(),
29729
- /** Counter since provider start. Resets on reboot. Useful for metrics/debug. */
29730
- pressCountSinceStart: number()
29731
- });
29732
- var DoorbellPressEventSchema = object({
29733
- deviceId: number(),
29734
- timestamp: number()
29735
- });
29736
- /**
29737
- * The `doorbell-source` extension slot's editable value (D648): the camera's
29738
- * virtual-doorbell trigger devices, exactly what the wrapper's
29739
- * `doorbellSources` persists (as `{ deviceId }` records).
29740
- */
29741
- var DoorbellSourceSlotValueSchema = object({ deviceIds: array(number().int().positive()) });
29742
- /**
29743
- * The `doorbell-source` slot — which devices ring this camera's VIRTUAL
29744
- * doorbell, owned by the `virtual-doorbell` wrapper over its
29745
- * `doorbellSources` store (D648). A source rings when one of its
29746
- * `SOURCE_CAPS` rises. Whether the wrapper is bound to the camera at all is a
29747
- * different authority (`deviceManager.setWrapperActive`, D62) — the slot
29748
- * reports it, it never writes it.
29749
- */
29750
- var DOORBELL_SOURCE_SLOT = {
29751
- id: "doorbell-source",
29752
- label: "Doorbell trigger devices",
29753
- description: "Any of these becoming active rings this camera's virtual doorbell: a binary sensor when it goes active, a switch when it turns on.",
29754
- shape: "association",
29755
- hostDeviceTypes: [DeviceType.Camera],
29756
- sourceCaps: SOURCE_CAPS,
29757
- cardinality: "many",
29758
- value: DoorbellSourceSlotValueSchema
29759
- };
29760
- var doorbellCapability = {
29761
- name: "doorbell",
29762
- scope: "device",
29763
- deviceNative: true,
29764
- mode: "singleton",
29765
- kind: "wrapper",
29766
- defaultActive: false,
29767
- deviceTypes: [DeviceType.Button, DeviceType.Camera],
29768
- extensionSlots: [DOORBELL_SOURCE_SLOT],
29769
- methods: {},
29770
- events: {
29771
- /**
29772
- * Fires once per physical press. Reolink delivers via Baichuan
29773
- * push (`ReolinkSimpleEvent.type === 'doorbell'`). There is no
29774
- * release/duration — it's a pulse.
29775
- */
29776
- onPressed: {
29777
- data: DoorbellPressEventSchema,
29778
- fromState: {
29779
- field: "lastPressedAt",
29780
- on: "advance"
29781
- }
29782
- } },
29783
- status: {
29784
- schema: DoorbellStatusSchema,
29785
- kind: "push"
29786
- },
29787
- /**
29788
- * Runtime-state slice — last press timestamp + lifetime press count.
29789
- * Mirrored by the kernel and readable via
29790
- * `device.state.doorbell.value`. UIs can show "last ring 5m ago"
29791
- * without subscribing.
29792
- */
29793
- runtimeState: DoorbellStatusSchema,
29794
- /**
29795
- * Runtime-state durability: **restored** — a monotonic accumulator: the slice IS the record. `lastPressedAt` is content here, not a clock, so it is deliberately NOT volatile.
29796
- *
29797
- * See `RuntimeStateDurability`. Enforced by
29798
- * `scripts/check-runtime-state-durability.ts`.
29799
- */
29800
- durability: "restored"
29801
- };
29802
- var ExtensionSlotIdSchema = _enum(["doorbell-source", "linked-devices"]);
29803
- DeviceType.Camera, DeviceType.Camera;
29804
- /** A slot's editable value, discriminated on `slot`. */
29805
- var ExtensionSlotValueSchema = discriminatedUnion("slot", [DoorbellSourceSlotValueSchema.extend({ slot: literal("doorbell-source") }), LinkedDevicesSlotValueSchema.extend({ slot: literal("linked-devices") })]);
29806
- DeviceType.Camera;
29807
- var ExtensionSourceAvailabilitySchema = discriminatedUnion("state", [object({ state: literal("ok") }), object({
29808
- state: literal("unreachable"),
29809
- reason: string()
29810
- })]);
29811
- /** One provider of slots — the D554 source-listing row. */
29812
- var ExtensionSourceSchema = object({
29813
- /** The routing prefix of every `slotRef` this provider serves. */
29814
- source: string(),
29815
- label: string(),
29816
- /** Stamped by the dispatcher from the registry (D557). */
29817
- addonId: string().optional(),
29818
- availability: ExtensionSourceAvailabilitySchema
29819
- });
29820
- /**
29821
- * How one picked source stands. `missing` — no such device (deleted, or an id
29822
- * that never existed); `foreign` — a device the slot's owner cannot read from
29823
- * (a source owned by another addon); `unavailable` — it exists but is not a
29824
- * valid source now (a container, which is never a pick). A source in any of
29825
- * these states is SHOWN, never silently dropped or re-pointed.
29826
- */
29827
- var ExtensionSourceHealthSchema = _enum([
29828
- "ok",
29829
- "missing",
29830
- "foreign",
29831
- "unavailable"
29832
- ]);
29833
- var ExtensionSlotSourceSchema = object({
29834
- deviceId: number().int(),
29835
- /** The device's name, or null when it could not be resolved (`missing`). */
29836
- name: string().nullable(),
29837
- health: ExtensionSourceHealthSchema,
29838
- detail: string().optional()
29839
- });
29840
- /**
29841
- * A DIFFERENT authority that gates whether the slot's sources do anything —
29842
- * reported read-only, named, never written through this contract (D62). The
29843
- * virtual doorbell's sources ring only while the wrapper is bound to the
29844
- * camera, and that binding belongs to `deviceManager.setWrapperActive`.
29845
- * `unknown` means the gate could not be read; it is not "inactive" (D315).
29846
- */
29847
- var ExtensionSlotActivationSchema = object({
29848
- state: _enum([
29849
- "active",
29850
- "inactive",
29851
- "unknown"
29852
- ]),
29853
- authority: string(),
29854
- detail: string().optional()
29855
- });
29856
- var ExtensionSlotRowSchema = discriminatedUnion("state", [object({
29857
- state: literal("ok"),
29858
- /** `<source>:<slotId>` — the routing key for `listCandidates` / `setSlot`. */
29859
- slotRef: string(),
29860
- slot: ExtensionSlotIdSchema,
29861
- /** Names the store written (D62), e.g. `virtual-doorbell:doorbellSources`. */
29862
- authority: string(),
29863
- activation: ExtensionSlotActivationSchema.nullable(),
29864
- value: ExtensionSlotValueSchema,
29865
- sources: array(ExtensionSlotSourceSchema),
29866
- /**
29867
- * Devices the owner links to the host ON ITS OWN, by structure, and that
29868
- * are therefore not in `value` (D655): a camera's device-tree children, and
29869
- * the child a picked container stands for (D356 — a container is never a
29870
- * pick, its children are). Read-only; the editor shows them and may offer
29871
- * per-device options on them (the linked-devices tracked-event opt-in).
29872
- * Absent when the owner links nothing beyond the picks, and from an owner
29873
- * older than D655.
29874
- */
29875
- impliedSources: array(ExtensionSlotSourceSchema).optional()
29876
- }), object({
29877
- state: literal("unreachable"),
29878
- addonId: string(),
29879
- reason: string()
29880
- })]);
29881
- var ExtensionCandidatesSchema = object({ candidates: array(object({
29882
- deviceId: number().int(),
29883
- name: string(),
29884
- type: string(),
29885
- location: string().nullable(),
29886
- /** The container a child belongs to — "Spotlight 2" alone does not say which. */
29887
- parentName: string().nullable(),
29888
- /** Pre-marked by the owner's suggestion rule. NEVER saved on its own (D356). */
29889
- suggested: boolean(),
29890
- /** Why it is suggested ("same location"), null when it is not. */
29891
- reason: string().nullable()
29892
- })) });
29893
- /**
29894
- * What a write did. `none` — applied in place. `host` / `parent` — the owner
29895
- * reloaded the host (or, for an accessory child, its parent) because the
29896
- * write changed what the host REGISTERS. A slot never adds a capability to its
29897
- * host — that is a composition (D663) — so today's owners answer `none`.
29898
- */
29899
- var ExtensionSetResultSchema = object({
29900
- applied: literal(true),
29901
- reload: _enum([
29902
- "none",
29903
- "host",
29904
- "parent"
29905
- ])
29906
- });
29907
- var ExtensionSlotRefInputSchema = object({
29908
- deviceId: number().int(),
29909
- slotRef: string().min(1)
29910
- });
29911
- var ExtensionSetSlotInputSchema = ExtensionSlotRefInputSchema.extend({ value: ExtensionSlotValueSchema });
29912
- method(object({ deviceId: number().int() }), array(ExtensionSourceSchema)), method(object({ deviceId: number().int() }), array(ExtensionSlotRowSchema)), method(ExtensionSlotRefInputSchema, ExtensionCandidatesSchema), method(ExtensionSetSlotInputSchema, ExtensionSetResultSchema, {
29913
- kind: "mutation",
29914
- auth: "admin"
29915
- });
29916
- /**
29917
30006
  * Optional client-side hints sent at session creation to help the provider
29918
30007
  * pick the best native source. All fields optional — a viewer that knows
29919
30008
  * nothing still gets a sane default. (Relocated from the retired `webrtc`
@@ -44876,6 +44965,18 @@ Object.freeze({
44876
44965
  addonId: null,
44877
44966
  access: "view"
44878
44967
  },
44968
+ "databaseSnapshot.listDatabases": {
44969
+ capName: "database-snapshot",
44970
+ capScope: "system",
44971
+ addonId: null,
44972
+ access: "view"
44973
+ },
44974
+ "databaseSnapshot.writeSnapshot": {
44975
+ capName: "database-snapshot",
44976
+ capScope: "system",
44977
+ addonId: null,
44978
+ access: "create"
44979
+ },
44879
44980
  "dataStoreProvider.aggregate": {
44880
44981
  capName: "data-store-provider",
44881
44982
  capScope: "system",
@@ -53790,6 +53891,18 @@ var STATE_SUMMARY_VARS = [
53790
53891
  systemEventKinds: [...SUMMARISABLE],
53791
53892
  systemEventDeliveries: ["summary"]
53792
53893
  },
53894
+ {
53895
+ name: "summarySection",
53896
+ label: "Summary: this section",
53897
+ description: "The section a per-section summary row is about (D698); on a summary sent as one message, every section it reports, comma-separated.",
53898
+ example: "Batterie scariche",
53899
+ group: "system",
53900
+ families: ["rule"],
53901
+ fields: [...RULE_TEXT],
53902
+ kinds: ["system"],
53903
+ systemEventKinds: [...SUMMARISABLE],
53904
+ systemEventDeliveries: ["summary"]
53905
+ },
53793
53906
  ...STATE_SUMMARY_SECTION_VARS.map((v) => ({
53794
53907
  name: v.name,
53795
53908
  label: v.label,
@@ -54630,6 +54743,15 @@ function systemEventSummaryScheduleOf(rule) {
54630
54743
  const delivery = rule.systemEventDelivery;
54631
54744
  return delivery?.mode === "summary" ? delivery.schedule : null;
54632
54745
  }
54746
+ /**
54747
+ * How a summary rule's window is sent (D698): `section` = one notification per
54748
+ * section; absent (every rule before D698) and any non-summary rule = `rule`.
54749
+ * The ONE reader — the scheduler, the rule test, the preview and both editors.
54750
+ */
54751
+ function systemEventSummarySplitOf(rule) {
54752
+ const delivery = rule.systemEventDelivery;
54753
+ return delivery?.mode === "summary" ? delivery.split ?? "rule" : "rule";
54754
+ }
54633
54755
  /** Absent and `instant` are the same answer: a notification per event. */
54634
54756
  function isSystemEventSummaryRule(rule) {
54635
54757
  return systemEventSummaryScheduleOf(rule) !== null;
@@ -57214,6 +57336,12 @@ Object.defineProperty(exports, "systemEventSummaryScheduleOf", {
57214
57336
  return systemEventSummaryScheduleOf;
57215
57337
  }
57216
57338
  });
57339
+ Object.defineProperty(exports, "systemEventSummarySplitOf", {
57340
+ enumerable: true,
57341
+ get: function() {
57342
+ return systemEventSummarySplitOf;
57343
+ }
57344
+ });
57217
57345
  Object.defineProperty(exports, "templateCarriesSummary", {
57218
57346
  enumerable: true,
57219
57347
  get: function() {