@camstack/addon-post-analysis 1.2.23 → 1.2.25

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.
@@ -20,7 +20,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
20
20
  enumerable: true
21
21
  }) : target, mod));
22
22
  //#endregion
23
- //#region ../types/dist/event-category-Bz24uP1U.mjs
23
+ //#region ../types/dist/event-category-41fKf-q9.mjs
24
24
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
25
25
  EventCategory["SystemBoot"] = "system.boot";
26
26
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -80,6 +80,26 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
80
80
  */
81
81
  EventCategory["AddonRetryScheduled"] = "addon.retry-scheduled";
82
82
  /**
83
+ * A liveness invariant of this node is false — it has no devices, every
84
+ * camera is offline, or a camera that was recording has stopped producing
85
+ * segments. Emitted by the `liveness-monitor` builtin, once per fault (the
86
+ * `findingId` is stable across ticks), only after its boot grace period.
87
+ * AlertCenter raises a persistent operator-visible alert.
88
+ *
89
+ * It exists because on 2026-08-03 the hub ran four hours with zero devices
90
+ * and zero recordings while every surface stayed quiet.
91
+ *
92
+ * Payload: `{ findingId, severity, title, message, deviceId? }`.
93
+ */
94
+ EventCategory["SystemLivenessFailed"] = "system.liveness-failed";
95
+ /**
96
+ * A previously reported liveness fault is true again. AlertCenter dismisses
97
+ * the matching `SystemLivenessFailed` alert.
98
+ *
99
+ * Payload: `{ findingId }`.
100
+ */
101
+ EventCategory["SystemLivenessRecovered"] = "system.liveness-recovered";
102
+ /**
83
103
  * Monitor is attempting to reload a failed addon NOW. UI uses this
84
104
  * to show a spinner during the retry attempt. Same transient nature
85
105
  * as AddonRetryScheduled.
@@ -9421,6 +9441,14 @@ var NcMediaPolicySchema = object({
9421
9441
  clipPreRollSec: number().int().min(0).max(30).optional(),
9422
9442
  clipPostRollSec: number().int().min(0).max(30).optional(),
9423
9443
  /**
9444
+ * Playback rate of the attached gif / clip. Absent = 2x.
9445
+ *
9446
+ * A notification clip is GLANCED at on a lock screen, not watched: at real
9447
+ * time an eight-second passage is eight seconds of the recipient's attention
9448
+ * and twice the bytes. 1 is real time for the operator who wants it.
9449
+ */
9450
+ clipSpeed: number().min(1).max(8).optional(),
9451
+ /**
9424
9452
  * Which stream profile the footage is cut from. Absent = the CHEAPEST
9425
9453
  * assigned profile: a notification is watched on a phone, so the 4K
9426
9454
  * rendition would burn CPU to produce a file the client downscales anyway.
@@ -9492,7 +9520,21 @@ var NcRuleInputSchema = object({
9492
9520
  * behaviour, visible to all, read-only in the viewer). Present = personal
9493
9521
  * rule owned by this userId. Server-stamped; never trusted from a client.
9494
9522
  */
9495
- ownerUserId: string().optional()
9523
+ ownerUserId: string().optional(),
9524
+ /**
9525
+ * May a non-admin snooze this rule for EVERYONE, not just themselves?
9526
+ *
9527
+ * A snooze is personal by default — it silences the person who set it. This
9528
+ * opts THIS rule into the "the gardener is here all afternoon" case, where
9529
+ * silencing the camera for the whole household is legitimate. It silences
9530
+ * other people, so it is off unless a rule deliberately allows it.
9531
+ *
9532
+ * `.optional()`, deliberately NOT `.default()`: a Zod default does not run on
9533
+ * the addon cap path (three production failures in one day), so absent is
9534
+ * read as `false` by {@link canSetGlobal} in the engine. Admins are not bound
9535
+ * by this flag — see the scope rules on that function.
9536
+ */
9537
+ snoozeAllowGlobal: boolean().optional()
9496
9538
  });
9497
9539
  /**
9498
9540
  * Partial patch for `updateRule` — any subset of the input fields, plus the
@@ -9577,7 +9619,28 @@ var NcConditionDescriptorSchema = object({
9577
9619
  /** Which delivery kinds the condition applies to. */
9578
9620
  appliesTo: array(NcDeliverySchema),
9579
9621
  phase: string(),
9580
- description: string().optional()
9622
+ description: string().optional(),
9623
+ /**
9624
+ * The CHOICES for a single-choice widget (`sourceSelect`, `crossingSelect`,
9625
+ * `packagePhase`, …), served with the descriptor.
9626
+ *
9627
+ * Before this the descriptor said which widget to render and not what to put
9628
+ * in it, so every option list lived in three places: this file's enums, the
9629
+ * admin's `NC_*_OPTIONS` and the viewer's `NC_*_VALUES`. That triple mirror
9630
+ * is the drift that emptied the viewer's rule editor on 2026-08-04 — the app
9631
+ * mirrors the cap by hand, so it is only ever as current as its last build.
9632
+ *
9633
+ * With the options on the wire, a condition of an EXISTING `valueType` costs
9634
+ * zero client changes. Clients keep a local fallback for an older hub that
9635
+ * does not send them; absent here is "use your own list", not "no choices".
9636
+ */
9637
+ options: array(object({
9638
+ /** Written to the rule verbatim. `''` means the ABSENT state. */
9639
+ value: string(),
9640
+ label: string(),
9641
+ /** What THIS choice matches — shown one at a time, under the control. */
9642
+ hint: string().optional()
9643
+ })).readonly().optional()
9581
9644
  });
9582
9645
  /**
9583
9646
  * The P1 condition surface as data — served by `getConditionCatalog` so
@@ -9671,6 +9734,28 @@ var NC_CONDITION_CATALOG = [
9671
9734
  group: "zones",
9672
9735
  label: "Zone crossing",
9673
9736
  valueType: "crossingSelect",
9737
+ options: [
9738
+ {
9739
+ value: "",
9740
+ label: "Not set — entering",
9741
+ hint: "Entries, and every detection that is not a crossing at all. Exits are excluded. This is what a rule without a crossing condition already does, and choosing it writes nothing to the rule."
9742
+ },
9743
+ {
9744
+ value: "enter",
9745
+ label: "Entered a zone",
9746
+ hint: "The same matches as \"not set\", stated explicitly: entries and non-crossing detections pass, exits do not."
9747
+ },
9748
+ {
9749
+ value: "exit",
9750
+ label: "Left a zone",
9751
+ hint: "ONLY an exit crossing. A detection that is not a crossing fails, so this rule cannot fire on ordinary movement — pair it with the zones the subject must have left. Also matches a tripwire crossed against its drawn direction."
9752
+ },
9753
+ {
9754
+ value: "any",
9755
+ label: "Entered or left",
9756
+ hint: "No direction filter: entries, exits and non-crossing detections alike. This is the only choice that adds exits to what the rule already matched."
9757
+ }
9758
+ ],
9674
9759
  operator: "in",
9675
9760
  appliesTo: ["immediate"],
9676
9761
  phase: "P1",
@@ -9751,6 +9836,24 @@ var NC_CONDITION_CATALOG = [
9751
9836
  group: "scope",
9752
9837
  label: "Detection source",
9753
9838
  valueType: "sourceSelect",
9839
+ options: [
9840
+ {
9841
+ value: "any",
9842
+ label: "Any source"
9843
+ },
9844
+ {
9845
+ value: "pipeline",
9846
+ label: "Pipeline"
9847
+ },
9848
+ {
9849
+ value: "onboard",
9850
+ label: "Onboard (camera)"
9851
+ },
9852
+ {
9853
+ value: "sensor",
9854
+ label: "Sensor"
9855
+ }
9856
+ ],
9754
9857
  operator: "in",
9755
9858
  appliesTo: [
9756
9859
  "immediate",
@@ -9786,6 +9889,20 @@ var NC_CONDITION_CATALOG = [
9786
9889
  group: "package",
9787
9890
  label: "Package phase",
9788
9891
  valueType: "packagePhase",
9892
+ options: [
9893
+ {
9894
+ value: "delivered",
9895
+ label: "Delivered"
9896
+ },
9897
+ {
9898
+ value: "picked-up",
9899
+ label: "Picked up"
9900
+ },
9901
+ {
9902
+ value: "both",
9903
+ label: "Both"
9904
+ }
9905
+ ],
9789
9906
  operator: "in",
9790
9907
  appliesTo: ["package-event"],
9791
9908
  phase: "P1",
@@ -9914,6 +10031,75 @@ var NcHistoryFilterSchema = object({
9914
10031
  until: number().optional(),
9915
10032
  limit: number().int().min(1).max(500).default(100)
9916
10033
  });
10034
+ /**
10035
+ * What a snooze covers. Broader scopes win when several overlap, so one window
10036
+ * leaves ONE digest rather than a rule snooze and a whole-feed snooze both
10037
+ * summarising the same silence.
10038
+ */
10039
+ var NcSnoozeScopeSchema = _enum([
10040
+ "rule",
10041
+ "device",
10042
+ "all"
10043
+ ]);
10044
+ /**
10045
+ * Client-authored snooze. The server stamps `userId`, `startedAt` and
10046
+ * `expiresAt` — a DURATION is sent rather than an instant so a client with a
10047
+ * skewed clock cannot author a window that is already over, or never ends.
10048
+ */
10049
+ var NcSnoozeInputSchema = object({
10050
+ scope: NcSnoozeScopeSchema,
10051
+ /** Required when `scope: 'rule'` — a scoped snooze with no id matches
10052
+ * NOTHING rather than degrading to "everything". */
10053
+ ruleId: string().optional(),
10054
+ /** Required when `scope: 'device'`. */
10055
+ deviceId: number().int().optional(),
10056
+ durationMinutes: number().int().min(1).max(1440),
10057
+ /**
10058
+ * Silence this for EVERY recipient, not just the caller. Permission is
10059
+ * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
10060
+ * broader scopes). Absent = personal.
10061
+ */
10062
+ global: boolean().optional(),
10063
+ /**
10064
+ * Deliver a summary of what was suppressed when the window ends. Absent =
10065
+ * ON: someone silencing a nuisance camera wants it off, someone silencing a
10066
+ * SECURITY camera wants to know what they missed, and choosing "off" for
10067
+ * everybody is how a snooze becomes an outage. Resolved to a concrete
10068
+ * boolean by the server at create time — never left to a Zod default, which
10069
+ * does not run on the addon cap path.
10070
+ */
10071
+ summary: boolean().optional()
10072
+ });
10073
+ /** A persisted snooze window. */
10074
+ var NcSnoozeSchema = object({
10075
+ id: string(),
10076
+ /** Who set it. Also who it silences, unless `global`. */
10077
+ userId: string(),
10078
+ scope: NcSnoozeScopeSchema,
10079
+ ruleId: string().optional(),
10080
+ deviceId: number().int().optional(),
10081
+ startedAt: number(),
10082
+ /** Exclusive: at exactly this instant the snooze is over. Expiry is a
10083
+ * COMPARISON, not a job — no sweeper can leave the operator silenced. */
10084
+ expiresAt: number(),
10085
+ global: boolean(),
10086
+ summary: boolean(),
10087
+ /** When the end-of-window digest went out. Absent = not sent (yet, or the
10088
+ * window has not closed, or `summary` is false). */
10089
+ digestSentAt: number().optional()
10090
+ });
10091
+ /** One line of an end-of-window digest: what one rule hid on one camera. */
10092
+ var NcSnoozeSuppressedSchema = object({
10093
+ snoozeId: string(),
10094
+ targetId: string(),
10095
+ ruleId: string(),
10096
+ ruleName: string(),
10097
+ deviceId: number().int(),
10098
+ /** How many notifications this snooze hid for that pair. */
10099
+ count: number().int(),
10100
+ firstAt: number(),
10101
+ lastAt: number()
10102
+ });
9917
10103
  var notificationRulesCapability = {
9918
10104
  name: "notification-rules",
9919
10105
  scope: "system",
@@ -9980,7 +10166,36 @@ var notificationRulesCapability = {
9980
10166
  * P1 (no user dimension); the P2 viewer History screen adds per-caller
9981
10167
  * scoping on the same method.
9982
10168
  */
9983
- getHistory: method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" })
10169
+ getHistory: method(object({ filter: NcHistoryFilterSchema.default({ limit: 100 }) }), object({ entries: array(NcHistoryEntrySchema) }), { auth: "admin" }),
10170
+ /**
10171
+ * Snooze windows currently in effect, plus any whose digest has not yet
10172
+ * gone out. `caller: 'required'`: a user sees their OWN windows and the
10173
+ * global ones that silence them, never another person's private silence.
10174
+ * An admin sees every window — a household-wide silence is exactly the
10175
+ * thing an operator has to be able to find and cancel.
10176
+ */
10177
+ listSnoozes: method(object({}), object({ snoozes: array(NcSnoozeSchema) }), { caller: "required" }),
10178
+ /**
10179
+ * Open a window. `userId` is stamped from the caller; a GLOBAL window is
10180
+ * permission-checked server-side (the rule's `snoozeAllowGlobal` for a
10181
+ * rule-scoped one, admin for a camera or the whole feed) — a client asking
10182
+ * for one it may not have is rejected, never silently downgraded, because
10183
+ * a snooze the operator believes is in effect and is not is the same
10184
+ * failure as one they cannot end.
10185
+ */
10186
+ createSnooze: method(object({ snooze: NcSnoozeInputSchema }), object({ snooze: NcSnoozeSchema }), {
10187
+ kind: "mutation",
10188
+ caller: "required"
10189
+ }),
10190
+ /**
10191
+ * End a window NOW. The digest still goes out (what was hidden while it
10192
+ * was open is still what the operator missed); only the silence stops.
10193
+ * A user may cancel their own; an admin may cancel any.
10194
+ */
10195
+ cancelSnooze: method(object({ snoozeId: string() }), object({ success: literal(true) }), {
10196
+ kind: "mutation",
10197
+ caller: "required"
10198
+ })
9984
10199
  }
9985
10200
  };
9986
10201
  /**
@@ -10760,7 +10975,15 @@ method(object({
10760
10975
  format: _enum(["gif", "mp4"]).default("gif"),
10761
10976
  maxWidth: number().int().min(120).max(1920).default(480),
10762
10977
  /** GIF only — MP4 keeps the source cadence. */
10763
- fps: number().int().min(1).max(15).default(5)
10978
+ fps: number().int().min(1).max(15).default(5),
10979
+ /**
10980
+ * Playback rate. A notification clip is GLANCED at on a lock screen,
10981
+ * not watched, so 2x is the default: the recipient sees the whole
10982
+ * passage in half the time and the GIF is half the bytes. `1` is real
10983
+ * time. Applies to MP4 as well — the operator set a speed, not a GIF
10984
+ * speed.
10985
+ */
10986
+ speed: number().min(1).max(8).default(2)
10764
10987
  }), object({
10765
10988
  base64: string(),
10766
10989
  mime: string(),
@@ -15596,6 +15819,20 @@ var QueryFilterSchema = object({
15596
15819
  limit: number().optional(),
15597
15820
  offset: number().optional()
15598
15821
  });
15822
+ /**
15823
+ * The predicate half of a filter, for BULK MUTATIONS.
15824
+ *
15825
+ * Deliberately not `QueryFilterSchema`: `orderBy` / `limit` / `offset` have no
15826
+ * meaning for a statement that rewrites a set, and accepting them would invite
15827
+ * a caller to believe `limit` bounds the damage. Every field is optional here
15828
+ * only so the shape stays composable — the implementation REJECTS a filter
15829
+ * that compiles to no predicate, because that is the whole collection.
15830
+ */
15831
+ var MutationFilterSchema = object({
15832
+ where: record(string(), unknown()).optional(),
15833
+ whereIn: record(string(), array(unknown())).optional(),
15834
+ whereBetween: record(string(), tuple([unknown(), unknown()])).optional()
15835
+ });
15599
15836
  /** A single stored record: `{ id, data }`. */
15600
15837
  var SettingsRecordSchema = object({
15601
15838
  id: string(),
@@ -15621,7 +15858,18 @@ var CollectionColumnSchema = object({
15621
15858
  ]),
15622
15859
  primaryKey: boolean().optional(),
15623
15860
  notNull: boolean().optional(),
15624
- unique: boolean().optional()
15861
+ unique: boolean().optional(),
15862
+ /**
15863
+ * Column DEFAULT. Required for B2: the four `ensureTable` consumers declare
15864
+ * columns like `enabled INTEGER NOT NULL DEFAULT 1`, and without this the
15865
+ * collection surface simply cannot express their existing tables — which is
15866
+ * why they were still on the uncapped `table*` API.
15867
+ */
15868
+ defaultValue: union([
15869
+ string(),
15870
+ number(),
15871
+ boolean()
15872
+ ]).optional()
15625
15873
  });
15626
15874
  var CollectionIndexSchema = object({
15627
15875
  name: string(),
@@ -15655,6 +15903,15 @@ method(object({
15655
15903
  collection: string(),
15656
15904
  key: string()
15657
15905
  }), _void(), { kind: "mutation" }), method(object({
15906
+ namespace: string().optional(),
15907
+ collection: string(),
15908
+ filter: MutationFilterSchema
15909
+ }), object({ deleted: number().int() }), { kind: "mutation" }), method(object({
15910
+ namespace: string().optional(),
15911
+ collection: string(),
15912
+ filter: MutationFilterSchema,
15913
+ data: record(string(), unknown())
15914
+ }), object({ updated: number().int() }), { kind: "mutation" }), method(object({
15658
15915
  namespace: string().optional(),
15659
15916
  collection: string(),
15660
15917
  filter: QueryFilterSchema.optional()
@@ -15721,6 +15978,15 @@ method(_void(), EngineInfoSchema), method(object({
15721
15978
  collection: string(),
15722
15979
  key: string()
15723
15980
  }), _void(), { kind: "mutation" }), method(object({
15981
+ namespace: string().optional(),
15982
+ collection: string(),
15983
+ filter: MutationFilterSchema
15984
+ }), object({ deleted: number().int() }), { kind: "mutation" }), method(object({
15985
+ namespace: string().optional(),
15986
+ collection: string(),
15987
+ filter: MutationFilterSchema,
15988
+ data: record(string(), unknown())
15989
+ }), object({ updated: number().int() }), { kind: "mutation" }), method(object({
15724
15990
  namespace: string().optional(),
15725
15991
  collection: string(),
15726
15992
  filter: QueryFilterSchema.optional()
@@ -23262,6 +23528,12 @@ Object.freeze({
23262
23528
  addonId: null,
23263
23529
  access: "delete"
23264
23530
  },
23531
+ "dataStoreProvider.deleteWhere": {
23532
+ capName: "data-store-provider",
23533
+ capScope: "system",
23534
+ addonId: null,
23535
+ access: "delete"
23536
+ },
23265
23537
  "dataStoreProvider.get": {
23266
23538
  capName: "data-store-provider",
23267
23539
  capScope: "system",
@@ -23310,6 +23582,12 @@ Object.freeze({
23310
23582
  addonId: null,
23311
23583
  access: "create"
23312
23584
  },
23585
+ "dataStoreProvider.updateWhere": {
23586
+ capName: "data-store-provider",
23587
+ capScope: "system",
23588
+ addonId: null,
23589
+ access: "create"
23590
+ },
23313
23591
  "dayNight.getOptions": {
23314
23592
  capName: "day-night",
23315
23593
  capScope: "device",
@@ -25104,12 +25382,24 @@ Object.freeze({
25104
25382
  addonId: null,
25105
25383
  access: "create"
25106
25384
  },
25385
+ "notificationRules.cancelSnooze": {
25386
+ capName: "notification-rules",
25387
+ capScope: "system",
25388
+ addonId: null,
25389
+ access: "create"
25390
+ },
25107
25391
  "notificationRules.createRule": {
25108
25392
  capName: "notification-rules",
25109
25393
  capScope: "system",
25110
25394
  addonId: null,
25111
25395
  access: "create"
25112
25396
  },
25397
+ "notificationRules.createSnooze": {
25398
+ capName: "notification-rules",
25399
+ capScope: "system",
25400
+ addonId: null,
25401
+ access: "create"
25402
+ },
25113
25403
  "notificationRules.deleteRule": {
25114
25404
  capName: "notification-rules",
25115
25405
  capScope: "system",
@@ -25140,6 +25430,12 @@ Object.freeze({
25140
25430
  addonId: null,
25141
25431
  access: "view"
25142
25432
  },
25433
+ "notificationRules.listSnoozes": {
25434
+ capName: "notification-rules",
25435
+ capScope: "system",
25436
+ addonId: null,
25437
+ access: "view"
25438
+ },
25143
25439
  "notificationRules.setRuleEnabled": {
25144
25440
  capName: "notification-rules",
25145
25441
  capScope: "system",
@@ -26388,6 +26684,12 @@ Object.freeze({
26388
26684
  addonId: null,
26389
26685
  access: "delete"
26390
26686
  },
26687
+ "settingsStore.deleteWhere": {
26688
+ capName: "settings-store",
26689
+ capScope: "system",
26690
+ addonId: null,
26691
+ access: "delete"
26692
+ },
26391
26693
  "settingsStore.get": {
26392
26694
  capName: "settings-store",
26393
26695
  capScope: "system",
@@ -26430,6 +26732,12 @@ Object.freeze({
26430
26732
  addonId: null,
26431
26733
  access: "create"
26432
26734
  },
26735
+ "settingsStore.updateWhere": {
26736
+ capName: "settings-store",
26737
+ capScope: "system",
26738
+ addonId: null,
26739
+ access: "create"
26740
+ },
26433
26741
  "smtpProvider.getStatus": {
26434
26742
  capName: "smtp-provider",
26435
26743
  capScope: "system",
@@ -27533,6 +27841,24 @@ Object.defineProperty(exports, "NcRuleSchema", {
27533
27841
  return NcRuleSchema;
27534
27842
  }
27535
27843
  });
27844
+ Object.defineProperty(exports, "NcSnoozeInputSchema", {
27845
+ enumerable: true,
27846
+ get: function() {
27847
+ return NcSnoozeInputSchema;
27848
+ }
27849
+ });
27850
+ Object.defineProperty(exports, "NcSnoozeSchema", {
27851
+ enumerable: true,
27852
+ get: function() {
27853
+ return NcSnoozeSchema;
27854
+ }
27855
+ });
27856
+ Object.defineProperty(exports, "NcSnoozeSuppressedSchema", {
27857
+ enumerable: true,
27858
+ get: function() {
27859
+ return NcSnoozeSuppressedSchema;
27860
+ }
27861
+ });
27536
27862
  Object.defineProperty(exports, "NcTaxonomySchema", {
27537
27863
  enumerable: true,
27538
27864
  get: function() {