@camstack/addon-export-hap 1.2.163 → 1.2.164

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.
@@ -5464,7 +5464,7 @@ var ZodIssueCode = {
5464
5464
  var ZodFirstPartyTypeKind;
5465
5465
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5466
5466
  //#endregion
5467
- //#region ../types/dist/sleep-yKL5gfrH.mjs
5467
+ //#region ../types/dist/sleep-BSuCCFjf.mjs
5468
5468
  /**
5469
5469
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5470
5470
  * window to float samples (D455).
@@ -17745,7 +17745,19 @@ var DeviceHistorySubjectSchema = discriminatedUnion("kind", [object({
17745
17745
  kind: literal("node"),
17746
17746
  nodeId: string().min(1)
17747
17747
  })]);
17748
+ /**
17749
+ * `enum` stores a STATE as the ordinal of its value in the series' value list
17750
+ * (`DeviceHistorySeriesInfo.values`, append-only, so an ordinal never changes
17751
+ * meaning); a rollup keeps the time spent in each state (`states`).
17752
+ */
17748
17753
  var DeviceHistoryKindSchema = _enum([
17754
+ "gauge",
17755
+ "counter",
17756
+ "boolean",
17757
+ "enum"
17758
+ ]);
17759
+ /** What a PRODUCER may declare. `enum` is cap-only: its value list is the cap field's. */
17760
+ var DeviceHistoryProducerKindSchema = _enum([
17749
17761
  "gauge",
17750
17762
  "counter",
17751
17763
  "boolean"
@@ -17782,7 +17794,13 @@ var SeriesInfoSchema = object({
17782
17794
  /** `null` is unknown (a `unitFrom` series whose device does not state a unit right now), never a guess. */
17783
17795
  unit: string().nullable(),
17784
17796
  displayName: string(),
17785
- source: _enum(["cap", "addon"]),
17797
+ source: _enum([
17798
+ "cap",
17799
+ "addon",
17800
+ "derived"
17801
+ ]),
17802
+ /** `enum`: the value of each ordinal (index = ordinal); `null` for every other kind. */
17803
+ values: array(string()).readonly().nullable(),
17786
17804
  firstTs: number(),
17787
17805
  lastTs: number()
17788
17806
  });
@@ -17796,17 +17814,31 @@ var QueryPointSchema = object({
17796
17814
  twMean: number().nullable(),
17797
17815
  min: number(),
17798
17816
  max: number(),
17799
- /** `null` is unknown, never zero (D393). */
17800
- last: number().nullable()
17817
+ /** `null` is unknown, never zero (D393). For an `enum` series: the ordinal of {@link state}. */
17818
+ last: number().nullable(),
17819
+ /**
17820
+ * The increase over the point: a `counter`'s growth since the previous point
17821
+ * or bucket (a drop is a reset, counted from zero), and for
17822
+ * {@link DEVICE_HISTORY_ENERGY_KEY} the kWh used in the bucket. `null` for
17823
+ * every other kind, and when it cannot be known.
17824
+ */
17825
+ delta: number().nullable(),
17826
+ /** `enum`: the state in force at the end of the point (the name of `last`); `null` otherwise. */
17827
+ state: string().nullable(),
17828
+ /** `enum` rollup: milliseconds spent in each state inside the bucket; `null` for raw points and other kinds. */
17829
+ states: record(string(), number()).nullable()
17801
17830
  });
17802
17831
  var QuerySeriesSchema = object({
17803
17832
  scope: string(),
17804
17833
  /** The last point STRICTLY BEFORE `from` in the chosen tier, so a step chart can start at the held value. */
17805
17834
  before: object({
17806
17835
  t: number(),
17807
- value: number().nullable()
17836
+ value: number().nullable(),
17837
+ state: string().nullable()
17808
17838
  }).nullable(),
17809
- points: array(QueryPointSchema).readonly()
17839
+ points: array(QueryPointSchema).readonly(),
17840
+ /** A derived key: the stored key its points were computed from; `null` for a stored series. */
17841
+ derivedFrom: string().nullable()
17810
17842
  });
17811
17843
  /** The window part of a query, shared by the device and node forms. */
17812
17844
  var QueryWindowShape = {
@@ -17822,6 +17854,23 @@ var QueryResultSchema = object({
17822
17854
  series: array(QuerySeriesSchema).readonly(),
17823
17855
  truncated: boolean()
17824
17856
  });
17857
+ /** One read of a batch: a device's key or a node's key (exactly one subject). */
17858
+ var QueryManyItemSchema = union([object({
17859
+ deviceId: number().int(),
17860
+ key: string(),
17861
+ scope: string().optional()
17862
+ }), object({
17863
+ forNodeId: string().min(1),
17864
+ key: string(),
17865
+ scope: string().optional()
17866
+ })]);
17867
+ var QueryManyEntrySchema = discriminatedUnion("ok", [object({
17868
+ ok: literal(true),
17869
+ result: QueryResultSchema
17870
+ }), object({
17871
+ ok: literal(false),
17872
+ error: string()
17873
+ })]);
17825
17874
  var TierStatusSchema = object({
17826
17875
  tier: DeviceHistoryResolutionSchema,
17827
17876
  /** `null` until the first background count answered. */
@@ -17877,16 +17926,22 @@ var DeviceHistoryStatusSchema = object({
17877
17926
  lastRefreshAt: number().nullable()
17878
17927
  })
17879
17928
  });
17880
- method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ nodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17929
+ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ forNodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17881
17930
  deviceId: number().int(),
17882
17931
  ...QueryWindowShape
17883
17932
  }), QueryResultSchema), method(object({
17884
- nodeId: string().min(1),
17933
+ forNodeId: string().min(1),
17885
17934
  ...QueryWindowShape
17886
17935
  }), QueryResultSchema, { auth: "admin" }), method(object({
17936
+ items: array(QueryManyItemSchema).min(1).max(24),
17937
+ from: QueryWindowShape.from,
17938
+ to: QueryWindowShape.to,
17939
+ resolution: QueryWindowShape.resolution,
17940
+ maxPoints: QueryWindowShape.maxPoints
17941
+ }), object({ results: array(QueryManyEntrySchema).readonly() }), { auth: "admin" }), method(object({
17887
17942
  name: string().regex(/^[a-z0-9-]+$/),
17888
17943
  subjectKind: _enum(["device", "node"]),
17889
- kind: DeviceHistoryKindSchema,
17944
+ kind: DeviceHistoryProducerKindSchema,
17890
17945
  unit: string().optional(),
17891
17946
  displayName: string().min(1),
17892
17947
  ingest: _enum(["points", "buckets"])
@@ -40984,14 +41039,106 @@ var LogEntrySchema = object({
40984
41039
  meta: record(string(), unknown()).optional(),
40985
41040
  tags: record(string(), string()).optional()
40986
41041
  });
40987
- method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
40988
- scope: array(string()).optional(),
41042
+ /**
41043
+ * A history READ against one destination (D898).
41044
+ *
41045
+ * Every filter is applied by the PROVIDER, before the limit — a filter the
41046
+ * browser applied after the limit is what made a rare device's lines
41047
+ * unreachable behind a busy one's. `before` / `after` are cursors the provider
41048
+ * minted (opaque to everyone else): a file position for the rotated files, a
41049
+ * nanosecond timestamp for Loki.
41050
+ *
41051
+ * A read is BOUNDED by `budgetMs`: a filter that matches nothing on a 30-day
41052
+ * store answers `done: false` with the cursor it reached and the bytes it
41053
+ * scanned, and the caller decides whether to go on. That is what makes a long
41054
+ * scan show progress and stop when asked — `cancelRead` ends the slice in
41055
+ * flight, and not asking for the next slice ends the scan.
41056
+ */
41057
+ var LogReadQuerySchema = object({
41058
+ /** Correlates `cancelRead`. Caller-chosen, unique per in-flight read. */
41059
+ requestId: string().min(1).max(64).optional(),
41060
+ /** The device the line is about (`tags.deviceId`, numeric). */
41061
+ deviceId: number().int().optional(),
41062
+ /**
41063
+ * The emitting addon — bare manifest id; `@<version>` / `::<sub>` suffixes
41064
+ * match. Not `addonId`: a cap router reads that name as "which provider".
41065
+ */
41066
+ fromAddonId: string().min(1).max(200).optional(),
41067
+ /**
41068
+ * The emitting node: matches the agent that emitted the line, the node
41069
+ * itself, or a worker under it (`<agent>/<runner>`) — the `agentId`
41070
+ * semantics of `matchesLogTags`. Not `nodeId`: a cap router reads that
41071
+ * name as "which node's provider".
41072
+ */
41073
+ fromNodeId: string().min(1).max(200).optional(),
41074
+ /** Any other tag, exact match (AND). */
41075
+ tags: record(string(), union([string(), number()])).optional(),
41076
+ /** Severity FLOOR: this level and above. */
40989
41077
  level: LogLevelSchema.optional(),
40990
- since: date().optional(),
40991
- until: date().optional(),
40992
- limit: number().optional(),
40993
- tags: record(string(), string()).optional()
40994
- }), array(LogEntrySchema).readonly());
41078
+ /** Case-insensitive substring over message, scope, tag values and meta values. */
41079
+ text: string().min(1).max(200).optional(),
41080
+ /** Epoch ms, inclusive. */
41081
+ since: number().optional(),
41082
+ /** Epoch ms, inclusive. */
41083
+ until: number().optional(),
41084
+ /** Older than this cursor (exclusive). Absent with `after` absent ⇒ from the newest. */
41085
+ before: string().min(1).max(1024).optional(),
41086
+ /** Newer than this cursor (exclusive). */
41087
+ after: string().min(1).max(1024).optional(),
41088
+ limit: number().int().min(1).max(1e3).optional(),
41089
+ /** Wall-clock bound of this slice. The provider caps it. */
41090
+ budgetMs: number().int().min(50).max(1e4).optional()
41091
+ });
41092
+ var LogReadResultSchema = object({
41093
+ /** Newest first. */
41094
+ entries: array(object({
41095
+ /** `<bootId>.<seq>` minted by the emitting LogManager — the dedupe key. */
41096
+ id: string().optional(),
41097
+ /** Epoch ms. */
41098
+ timestamp: number(),
41099
+ level: LogLevelSchema,
41100
+ scope: string().optional(),
41101
+ message: string(),
41102
+ tags: record(string(), union([string(), number()])).optional(),
41103
+ meta: record(string(), unknown()).optional()
41104
+ })),
41105
+ /** Pass as `before` for the next older page; null when nothing older exists. */
41106
+ nextBefore: string().nullable(),
41107
+ /** Pass as `after` to read what arrived since; null when unknown. */
41108
+ nextAfter: string().nullable(),
41109
+ /** Bytes this slice read (files) or received (remote). Progress, not a promise. */
41110
+ scannedBytes: number().int().nonnegative(),
41111
+ /**
41112
+ * True when the scan in this direction reached the end of the store.
41113
+ * False with fewer than `limit` entries means the budget ran out first —
41114
+ * call again with `nextBefore` to go on.
41115
+ */
41116
+ done: boolean(),
41117
+ /** True when `cancelRead` ended this slice early. */
41118
+ cancelled: boolean().optional()
41119
+ });
41120
+ var LogReadCapabilitiesSchema = object({
41121
+ /** False ⇒ this destination only ships lines (console, forwarder, an unconfigured Loki). */
41122
+ readable: boolean(),
41123
+ /** Why not, when `readable` is false — rendered next to the source. */
41124
+ reason: string().nullable(),
41125
+ /** Filters the provider applies itself. A false one is applied by nobody. */
41126
+ filters: object({
41127
+ deviceId: boolean(),
41128
+ addonId: boolean(),
41129
+ nodeId: boolean(),
41130
+ tags: boolean(),
41131
+ level: boolean(),
41132
+ text: boolean(),
41133
+ timeRange: boolean()
41134
+ }),
41135
+ /** How far back the store reaches, when the provider knows (days). */
41136
+ retentionDays: number().nullable()
41137
+ });
41138
+ method(LogEntrySchema, _void(), { kind: "mutation" }), optionalMethod(_void(), LogReadCapabilitiesSchema, { auth: "admin" }), optionalMethod(LogReadQuerySchema, LogReadResultSchema, { auth: "admin" }), optionalMethod(object({ requestId: string().min(1).max(64) }), object({ cancelled: boolean() }), {
41139
+ kind: "mutation",
41140
+ auth: "admin"
41141
+ });
40995
41142
  /**
40996
41143
  * `login-method` — collection cap through which auth addons contribute
40997
41144
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -43547,6 +43694,33 @@ var NcRuleTargetSchema = object({
43547
43694
  params: record(string(), unknown()).optional()
43548
43695
  });
43549
43696
  /**
43697
+ * WHAT THE NOTIFICATION'S PICTURE IS (D897) — the ONE media choice of a rule.
43698
+ *
43699
+ * Every mode starts from the same CLEAN source frame of the trigger moment
43700
+ * (keyFrame → sceneFrame → lastSceneFrame, narrowed to the trigger instant and
43701
+ * to the zone that fired the rule) and renders it once at send time:
43702
+ * - `scene-boxes` — the whole scene, the subject outlined thick in the accent
43703
+ * colour and every OTHER track visible at that instant outlined thin, each
43704
+ * labelled with class and confidence ("dog 87%").
43705
+ * - `crop` — the subject cut out of that frame around its box at that instant.
43706
+ * - `clean` — the whole scene with nothing drawn on it.
43707
+ * - `none` — no picture.
43708
+ *
43709
+ * A mode that cannot be honoured (no box at that instant, a photograph with no
43710
+ * tracked subject) ships `clean` and names the reason in the log, per camera.
43711
+ * It replaces the `attach` × `frame` × `zoneCrop` triple, which let one rule
43712
+ * ship a crop on one event and a boxed scene on the next depending on which
43713
+ * stored kind had landed.
43714
+ */
43715
+ var NcMediaImageSchema = _enum([
43716
+ "scene-boxes",
43717
+ "crop",
43718
+ "clean",
43719
+ "none"
43720
+ ]);
43721
+ /**
43722
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43723
+ *
43550
43724
  * Media attachment policy (P1 still-image subset).
43551
43725
  * - `best` — the best AVAILABLE subject image at dispatch time (D-3).
43552
43726
  * - `best-matching` — the media that explains WHY the rule fired: a rule
@@ -43560,6 +43734,8 @@ var NcRuleTargetSchema = object({
43560
43734
  * - `none` — no attachment.
43561
43735
  */
43562
43736
  /**
43737
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43738
+ *
43563
43739
  * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
43564
43740
  * conflate it with the selection strategy and betray the request: asking for
43565
43741
  * the clean scene frame on an object-event owner used to start at
@@ -43588,16 +43764,29 @@ var NcMediaFrameSchema = _enum([
43588
43764
  */
43589
43765
  var NcLinkedCameraModeSchema = _enum(["mosaic", "each"]);
43590
43766
  var NcMediaPolicySchema = object({
43767
+ /**
43768
+ * The picture — see {@link NcMediaImageSchema}. Absent on a rule nobody has
43769
+ * saved since D897: `normalizeNcMediaPolicy` derives it from the legacy
43770
+ * triple below, at load and at every write, and the store keeps only this.
43771
+ */
43772
+ image: NcMediaImageSchema.optional(),
43773
+ /**
43774
+ * Draw the zone that FIRED the rule on the picture (`scene-boxes` / `clean`;
43775
+ * a `crop` never shows it). Valid only on a rule whose trigger is a zone —
43776
+ * `conditions.zones` or an occupancy zone — and refused on save otherwise.
43777
+ * Replaces `zoneCrop`.
43778
+ */
43779
+ showTriggerZone: boolean().optional(),
43780
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43591
43781
  attach: _enum([
43592
43782
  "best",
43593
43783
  "best-matching",
43594
43784
  "keyFrame",
43595
43785
  "none"
43596
- ]).default("best"),
43597
- /** What the still shows. Absent = `cropped` (the historical `best` shape). */
43786
+ ]).optional(),
43787
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43598
43788
  frame: NcMediaFrameSchema.optional(),
43599
- /** Crop the attached still to the rule's condition-zone bbox (padded) —
43600
- * "show me the ZONE", not the whole scene or the subject crop. */
43789
+ /** @deprecated D897 — folded into `image: 'clean'` + `showTriggerZone` on save. */
43601
43790
  zoneCrop: boolean().optional(),
43602
43791
  /**
43603
43792
  * Also attach a short GIF cut from the stream broker's clip ring around the
@@ -43769,7 +43958,9 @@ var NcRuleInputSchema = object({
43769
43958
  * targets.
43770
43959
  */
43771
43960
  targetUsers: array(string()).optional(),
43772
- media: NcMediaPolicySchema.default({ attach: "best" }),
43961
+ /** Absent = the kind's default picture (`resolveNcMediaImage`): the subject crop for a
43962
+ * detection, the clean scene for a sensor or a sound. Set explicitly on save (D897). */
43963
+ media: NcMediaPolicySchema.default({}),
43773
43964
  throttle: NcThrottleSchema.default({
43774
43965
  cooldownSec: 60,
43775
43966
  scope: "rule-device"
@@ -44706,13 +44897,37 @@ var NcAlarmModeOpeningsSchema = object({
44706
44897
  /** Covered devices whose state could not be read (D49): neither open nor closed. */
44707
44898
  unknown: array(number().int())
44708
44899
  });
44900
+ /**
44901
+ * One alarm INPUT — a (rule, device) pair — the operator bypassed until the
44902
+ * next disarm ("Bypass this input until disarm" on a trigger notification, or
44903
+ * `nc.bypassAlarmInput`). Reported so an armed alarm with a silenced input
44904
+ * never looks fully armed (D62: off must never look like broken).
44905
+ */
44906
+ var NcAlarmInputBypassViewSchema = object({
44907
+ ruleId: string(),
44908
+ /** The rule's current name (its frozen name when the rule is gone). */
44909
+ ruleName: string(),
44910
+ /** The input: the sensor of the match, else its camera. */
44911
+ deviceId: number().int(),
44912
+ /** The input's current name. */
44913
+ name: string(),
44914
+ /** When it was bypassed (ms epoch). */
44915
+ since: number(),
44916
+ /** Triggers from this input dropped since. */
44917
+ dropped: number().int().min(0)
44918
+ });
44709
44919
  var NcAlarmLiveSchema = object({
44710
44920
  state: AlarmStateSchema,
44711
44921
  /** The mode being armed into (exit delay) or held; null when disarmed. */
44712
44922
  targetMode: AlarmArmModeSchema.nullable(),
44713
44923
  availableModes: array(AlarmArmModeSchema),
44714
44924
  openings: array(NcAlarmModeOpeningsSchema),
44715
- exclusions: array(NcAlarmExclusionViewSchema)
44925
+ exclusions: array(NcAlarmExclusionViewSchema),
44926
+ /**
44927
+ * Inputs bypassed for the rest of this arm session; cleared on disarm.
44928
+ * Defaulted so an older hub answer still parses (as "none known").
44929
+ */
44930
+ bypassedInputs: array(NcAlarmInputBypassViewSchema).default([])
44716
44931
  });
44717
44932
  var NcAlarmConfigSchema = object({
44718
44933
  /**
@@ -66605,7 +66820,19 @@ Object.freeze({
66605
66820
  addonId: null,
66606
66821
  access: "view"
66607
66822
  },
66608
- "logDestination.query": {
66823
+ "logDestination.cancelRead": {
66824
+ capName: "log-destination",
66825
+ capScope: "system",
66826
+ addonId: null,
66827
+ access: "create"
66828
+ },
66829
+ "logDestination.describeRead": {
66830
+ capName: "log-destination",
66831
+ capScope: "system",
66832
+ addonId: null,
66833
+ access: "view"
66834
+ },
66835
+ "logDestination.read": {
66609
66836
  capName: "log-destination",
66610
66837
  capScope: "system",
66611
66838
  addonId: null,
@@ -72612,6 +72839,11 @@ Object.freeze({
72612
72839
  form: "single",
72613
72840
  optional: false
72614
72841
  }],
72842
+ "logDestination.read": [{
72843
+ name: "deviceId",
72844
+ form: "single",
72845
+ optional: true
72846
+ }],
72615
72847
  "mediaPlayer.getStatus": [{
72616
72848
  name: "deviceId",
72617
72849
  form: "single",
@@ -5454,7 +5454,7 @@ var ZodIssueCode = {
5454
5454
  var ZodFirstPartyTypeKind;
5455
5455
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5456
5456
  //#endregion
5457
- //#region ../types/dist/sleep-yKL5gfrH.mjs
5457
+ //#region ../types/dist/sleep-BSuCCFjf.mjs
5458
5458
  /**
5459
5459
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5460
5460
  * window to float samples (D455).
@@ -17735,7 +17735,19 @@ var DeviceHistorySubjectSchema = discriminatedUnion("kind", [object({
17735
17735
  kind: literal("node"),
17736
17736
  nodeId: string().min(1)
17737
17737
  })]);
17738
+ /**
17739
+ * `enum` stores a STATE as the ordinal of its value in the series' value list
17740
+ * (`DeviceHistorySeriesInfo.values`, append-only, so an ordinal never changes
17741
+ * meaning); a rollup keeps the time spent in each state (`states`).
17742
+ */
17738
17743
  var DeviceHistoryKindSchema = _enum([
17744
+ "gauge",
17745
+ "counter",
17746
+ "boolean",
17747
+ "enum"
17748
+ ]);
17749
+ /** What a PRODUCER may declare. `enum` is cap-only: its value list is the cap field's. */
17750
+ var DeviceHistoryProducerKindSchema = _enum([
17739
17751
  "gauge",
17740
17752
  "counter",
17741
17753
  "boolean"
@@ -17772,7 +17784,13 @@ var SeriesInfoSchema = object({
17772
17784
  /** `null` is unknown (a `unitFrom` series whose device does not state a unit right now), never a guess. */
17773
17785
  unit: string().nullable(),
17774
17786
  displayName: string(),
17775
- source: _enum(["cap", "addon"]),
17787
+ source: _enum([
17788
+ "cap",
17789
+ "addon",
17790
+ "derived"
17791
+ ]),
17792
+ /** `enum`: the value of each ordinal (index = ordinal); `null` for every other kind. */
17793
+ values: array(string()).readonly().nullable(),
17776
17794
  firstTs: number(),
17777
17795
  lastTs: number()
17778
17796
  });
@@ -17786,17 +17804,31 @@ var QueryPointSchema = object({
17786
17804
  twMean: number().nullable(),
17787
17805
  min: number(),
17788
17806
  max: number(),
17789
- /** `null` is unknown, never zero (D393). */
17790
- last: number().nullable()
17807
+ /** `null` is unknown, never zero (D393). For an `enum` series: the ordinal of {@link state}. */
17808
+ last: number().nullable(),
17809
+ /**
17810
+ * The increase over the point: a `counter`'s growth since the previous point
17811
+ * or bucket (a drop is a reset, counted from zero), and for
17812
+ * {@link DEVICE_HISTORY_ENERGY_KEY} the kWh used in the bucket. `null` for
17813
+ * every other kind, and when it cannot be known.
17814
+ */
17815
+ delta: number().nullable(),
17816
+ /** `enum`: the state in force at the end of the point (the name of `last`); `null` otherwise. */
17817
+ state: string().nullable(),
17818
+ /** `enum` rollup: milliseconds spent in each state inside the bucket; `null` for raw points and other kinds. */
17819
+ states: record(string(), number()).nullable()
17791
17820
  });
17792
17821
  var QuerySeriesSchema = object({
17793
17822
  scope: string(),
17794
17823
  /** The last point STRICTLY BEFORE `from` in the chosen tier, so a step chart can start at the held value. */
17795
17824
  before: object({
17796
17825
  t: number(),
17797
- value: number().nullable()
17826
+ value: number().nullable(),
17827
+ state: string().nullable()
17798
17828
  }).nullable(),
17799
- points: array(QueryPointSchema).readonly()
17829
+ points: array(QueryPointSchema).readonly(),
17830
+ /** A derived key: the stored key its points were computed from; `null` for a stored series. */
17831
+ derivedFrom: string().nullable()
17800
17832
  });
17801
17833
  /** The window part of a query, shared by the device and node forms. */
17802
17834
  var QueryWindowShape = {
@@ -17812,6 +17844,23 @@ var QueryResultSchema = object({
17812
17844
  series: array(QuerySeriesSchema).readonly(),
17813
17845
  truncated: boolean()
17814
17846
  });
17847
+ /** One read of a batch: a device's key or a node's key (exactly one subject). */
17848
+ var QueryManyItemSchema = union([object({
17849
+ deviceId: number().int(),
17850
+ key: string(),
17851
+ scope: string().optional()
17852
+ }), object({
17853
+ forNodeId: string().min(1),
17854
+ key: string(),
17855
+ scope: string().optional()
17856
+ })]);
17857
+ var QueryManyEntrySchema = discriminatedUnion("ok", [object({
17858
+ ok: literal(true),
17859
+ result: QueryResultSchema
17860
+ }), object({
17861
+ ok: literal(false),
17862
+ error: string()
17863
+ })]);
17815
17864
  var TierStatusSchema = object({
17816
17865
  tier: DeviceHistoryResolutionSchema,
17817
17866
  /** `null` until the first background count answered. */
@@ -17867,16 +17916,22 @@ var DeviceHistoryStatusSchema = object({
17867
17916
  lastRefreshAt: number().nullable()
17868
17917
  })
17869
17918
  });
17870
- method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ nodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17919
+ method(object({ deviceId: number().int() }), array(SeriesInfoSchema).readonly()), method(object({ forNodeId: string().min(1) }), array(SeriesInfoSchema).readonly(), { auth: "admin" }), method(object({
17871
17920
  deviceId: number().int(),
17872
17921
  ...QueryWindowShape
17873
17922
  }), QueryResultSchema), method(object({
17874
- nodeId: string().min(1),
17923
+ forNodeId: string().min(1),
17875
17924
  ...QueryWindowShape
17876
17925
  }), QueryResultSchema, { auth: "admin" }), method(object({
17926
+ items: array(QueryManyItemSchema).min(1).max(24),
17927
+ from: QueryWindowShape.from,
17928
+ to: QueryWindowShape.to,
17929
+ resolution: QueryWindowShape.resolution,
17930
+ maxPoints: QueryWindowShape.maxPoints
17931
+ }), object({ results: array(QueryManyEntrySchema).readonly() }), { auth: "admin" }), method(object({
17877
17932
  name: string().regex(/^[a-z0-9-]+$/),
17878
17933
  subjectKind: _enum(["device", "node"]),
17879
- kind: DeviceHistoryKindSchema,
17934
+ kind: DeviceHistoryProducerKindSchema,
17880
17935
  unit: string().optional(),
17881
17936
  displayName: string().min(1),
17882
17937
  ingest: _enum(["points", "buckets"])
@@ -40974,14 +41029,106 @@ var LogEntrySchema = object({
40974
41029
  meta: record(string(), unknown()).optional(),
40975
41030
  tags: record(string(), string()).optional()
40976
41031
  });
40977
- method(LogEntrySchema, _void(), { kind: "mutation" }), method(object({
40978
- scope: array(string()).optional(),
41032
+ /**
41033
+ * A history READ against one destination (D898).
41034
+ *
41035
+ * Every filter is applied by the PROVIDER, before the limit — a filter the
41036
+ * browser applied after the limit is what made a rare device's lines
41037
+ * unreachable behind a busy one's. `before` / `after` are cursors the provider
41038
+ * minted (opaque to everyone else): a file position for the rotated files, a
41039
+ * nanosecond timestamp for Loki.
41040
+ *
41041
+ * A read is BOUNDED by `budgetMs`: a filter that matches nothing on a 30-day
41042
+ * store answers `done: false` with the cursor it reached and the bytes it
41043
+ * scanned, and the caller decides whether to go on. That is what makes a long
41044
+ * scan show progress and stop when asked — `cancelRead` ends the slice in
41045
+ * flight, and not asking for the next slice ends the scan.
41046
+ */
41047
+ var LogReadQuerySchema = object({
41048
+ /** Correlates `cancelRead`. Caller-chosen, unique per in-flight read. */
41049
+ requestId: string().min(1).max(64).optional(),
41050
+ /** The device the line is about (`tags.deviceId`, numeric). */
41051
+ deviceId: number().int().optional(),
41052
+ /**
41053
+ * The emitting addon — bare manifest id; `@<version>` / `::<sub>` suffixes
41054
+ * match. Not `addonId`: a cap router reads that name as "which provider".
41055
+ */
41056
+ fromAddonId: string().min(1).max(200).optional(),
41057
+ /**
41058
+ * The emitting node: matches the agent that emitted the line, the node
41059
+ * itself, or a worker under it (`<agent>/<runner>`) — the `agentId`
41060
+ * semantics of `matchesLogTags`. Not `nodeId`: a cap router reads that
41061
+ * name as "which node's provider".
41062
+ */
41063
+ fromNodeId: string().min(1).max(200).optional(),
41064
+ /** Any other tag, exact match (AND). */
41065
+ tags: record(string(), union([string(), number()])).optional(),
41066
+ /** Severity FLOOR: this level and above. */
40979
41067
  level: LogLevelSchema.optional(),
40980
- since: date().optional(),
40981
- until: date().optional(),
40982
- limit: number().optional(),
40983
- tags: record(string(), string()).optional()
40984
- }), array(LogEntrySchema).readonly());
41068
+ /** Case-insensitive substring over message, scope, tag values and meta values. */
41069
+ text: string().min(1).max(200).optional(),
41070
+ /** Epoch ms, inclusive. */
41071
+ since: number().optional(),
41072
+ /** Epoch ms, inclusive. */
41073
+ until: number().optional(),
41074
+ /** Older than this cursor (exclusive). Absent with `after` absent ⇒ from the newest. */
41075
+ before: string().min(1).max(1024).optional(),
41076
+ /** Newer than this cursor (exclusive). */
41077
+ after: string().min(1).max(1024).optional(),
41078
+ limit: number().int().min(1).max(1e3).optional(),
41079
+ /** Wall-clock bound of this slice. The provider caps it. */
41080
+ budgetMs: number().int().min(50).max(1e4).optional()
41081
+ });
41082
+ var LogReadResultSchema = object({
41083
+ /** Newest first. */
41084
+ entries: array(object({
41085
+ /** `<bootId>.<seq>` minted by the emitting LogManager — the dedupe key. */
41086
+ id: string().optional(),
41087
+ /** Epoch ms. */
41088
+ timestamp: number(),
41089
+ level: LogLevelSchema,
41090
+ scope: string().optional(),
41091
+ message: string(),
41092
+ tags: record(string(), union([string(), number()])).optional(),
41093
+ meta: record(string(), unknown()).optional()
41094
+ })),
41095
+ /** Pass as `before` for the next older page; null when nothing older exists. */
41096
+ nextBefore: string().nullable(),
41097
+ /** Pass as `after` to read what arrived since; null when unknown. */
41098
+ nextAfter: string().nullable(),
41099
+ /** Bytes this slice read (files) or received (remote). Progress, not a promise. */
41100
+ scannedBytes: number().int().nonnegative(),
41101
+ /**
41102
+ * True when the scan in this direction reached the end of the store.
41103
+ * False with fewer than `limit` entries means the budget ran out first —
41104
+ * call again with `nextBefore` to go on.
41105
+ */
41106
+ done: boolean(),
41107
+ /** True when `cancelRead` ended this slice early. */
41108
+ cancelled: boolean().optional()
41109
+ });
41110
+ var LogReadCapabilitiesSchema = object({
41111
+ /** False ⇒ this destination only ships lines (console, forwarder, an unconfigured Loki). */
41112
+ readable: boolean(),
41113
+ /** Why not, when `readable` is false — rendered next to the source. */
41114
+ reason: string().nullable(),
41115
+ /** Filters the provider applies itself. A false one is applied by nobody. */
41116
+ filters: object({
41117
+ deviceId: boolean(),
41118
+ addonId: boolean(),
41119
+ nodeId: boolean(),
41120
+ tags: boolean(),
41121
+ level: boolean(),
41122
+ text: boolean(),
41123
+ timeRange: boolean()
41124
+ }),
41125
+ /** How far back the store reaches, when the provider knows (days). */
41126
+ retentionDays: number().nullable()
41127
+ });
41128
+ method(LogEntrySchema, _void(), { kind: "mutation" }), optionalMethod(_void(), LogReadCapabilitiesSchema, { auth: "admin" }), optionalMethod(LogReadQuerySchema, LogReadResultSchema, { auth: "admin" }), optionalMethod(object({ requestId: string().min(1).max(64) }), object({ cancelled: boolean() }), {
41129
+ kind: "mutation",
41130
+ auth: "admin"
41131
+ });
40985
41132
  /**
40986
41133
  * `login-method` — collection cap through which auth addons contribute
40987
41134
  * their pre-auth login surfaces to the login page. This is the SINGLE,
@@ -43537,6 +43684,33 @@ var NcRuleTargetSchema = object({
43537
43684
  params: record(string(), unknown()).optional()
43538
43685
  });
43539
43686
  /**
43687
+ * WHAT THE NOTIFICATION'S PICTURE IS (D897) — the ONE media choice of a rule.
43688
+ *
43689
+ * Every mode starts from the same CLEAN source frame of the trigger moment
43690
+ * (keyFrame → sceneFrame → lastSceneFrame, narrowed to the trigger instant and
43691
+ * to the zone that fired the rule) and renders it once at send time:
43692
+ * - `scene-boxes` — the whole scene, the subject outlined thick in the accent
43693
+ * colour and every OTHER track visible at that instant outlined thin, each
43694
+ * labelled with class and confidence ("dog 87%").
43695
+ * - `crop` — the subject cut out of that frame around its box at that instant.
43696
+ * - `clean` — the whole scene with nothing drawn on it.
43697
+ * - `none` — no picture.
43698
+ *
43699
+ * A mode that cannot be honoured (no box at that instant, a photograph with no
43700
+ * tracked subject) ships `clean` and names the reason in the log, per camera.
43701
+ * It replaces the `attach` × `frame` × `zoneCrop` triple, which let one rule
43702
+ * ship a crop on one event and a boxed scene on the next depending on which
43703
+ * stored kind had landed.
43704
+ */
43705
+ var NcMediaImageSchema = _enum([
43706
+ "scene-boxes",
43707
+ "crop",
43708
+ "clean",
43709
+ "none"
43710
+ ]);
43711
+ /**
43712
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43713
+ *
43540
43714
  * Media attachment policy (P1 still-image subset).
43541
43715
  * - `best` — the best AVAILABLE subject image at dispatch time (D-3).
43542
43716
  * - `best-matching` — the media that explains WHY the rule fired: a rule
@@ -43550,6 +43724,8 @@ var NcRuleTargetSchema = object({
43550
43724
  * - `none` — no attachment.
43551
43725
  */
43552
43726
  /**
43727
+ * @deprecated Read only by `normalizeNcMediaPolicy` (D897) — see {@link NcMediaImageSchema}.
43728
+ *
43553
43729
  * WHAT THE PICTURE SHOWS — chosen explicitly, because the implicit ladders
43554
43730
  * conflate it with the selection strategy and betray the request: asking for
43555
43731
  * the clean scene frame on an object-event owner used to start at
@@ -43578,16 +43754,29 @@ var NcMediaFrameSchema = _enum([
43578
43754
  */
43579
43755
  var NcLinkedCameraModeSchema = _enum(["mosaic", "each"]);
43580
43756
  var NcMediaPolicySchema = object({
43757
+ /**
43758
+ * The picture — see {@link NcMediaImageSchema}. Absent on a rule nobody has
43759
+ * saved since D897: `normalizeNcMediaPolicy` derives it from the legacy
43760
+ * triple below, at load and at every write, and the store keeps only this.
43761
+ */
43762
+ image: NcMediaImageSchema.optional(),
43763
+ /**
43764
+ * Draw the zone that FIRED the rule on the picture (`scene-boxes` / `clean`;
43765
+ * a `crop` never shows it). Valid only on a rule whose trigger is a zone —
43766
+ * `conditions.zones` or an occupancy zone — and refused on save otherwise.
43767
+ * Replaces `zoneCrop`.
43768
+ */
43769
+ showTriggerZone: boolean().optional(),
43770
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43581
43771
  attach: _enum([
43582
43772
  "best",
43583
43773
  "best-matching",
43584
43774
  "keyFrame",
43585
43775
  "none"
43586
- ]).default("best"),
43587
- /** What the still shows. Absent = `cropped` (the historical `best` shape). */
43776
+ ]).optional(),
43777
+ /** @deprecated D897 — accepted from an editor that predates `image`, folded into it on save. */
43588
43778
  frame: NcMediaFrameSchema.optional(),
43589
- /** Crop the attached still to the rule's condition-zone bbox (padded) —
43590
- * "show me the ZONE", not the whole scene or the subject crop. */
43779
+ /** @deprecated D897 — folded into `image: 'clean'` + `showTriggerZone` on save. */
43591
43780
  zoneCrop: boolean().optional(),
43592
43781
  /**
43593
43782
  * Also attach a short GIF cut from the stream broker's clip ring around the
@@ -43759,7 +43948,9 @@ var NcRuleInputSchema = object({
43759
43948
  * targets.
43760
43949
  */
43761
43950
  targetUsers: array(string()).optional(),
43762
- media: NcMediaPolicySchema.default({ attach: "best" }),
43951
+ /** Absent = the kind's default picture (`resolveNcMediaImage`): the subject crop for a
43952
+ * detection, the clean scene for a sensor or a sound. Set explicitly on save (D897). */
43953
+ media: NcMediaPolicySchema.default({}),
43763
43954
  throttle: NcThrottleSchema.default({
43764
43955
  cooldownSec: 60,
43765
43956
  scope: "rule-device"
@@ -44696,13 +44887,37 @@ var NcAlarmModeOpeningsSchema = object({
44696
44887
  /** Covered devices whose state could not be read (D49): neither open nor closed. */
44697
44888
  unknown: array(number().int())
44698
44889
  });
44890
+ /**
44891
+ * One alarm INPUT — a (rule, device) pair — the operator bypassed until the
44892
+ * next disarm ("Bypass this input until disarm" on a trigger notification, or
44893
+ * `nc.bypassAlarmInput`). Reported so an armed alarm with a silenced input
44894
+ * never looks fully armed (D62: off must never look like broken).
44895
+ */
44896
+ var NcAlarmInputBypassViewSchema = object({
44897
+ ruleId: string(),
44898
+ /** The rule's current name (its frozen name when the rule is gone). */
44899
+ ruleName: string(),
44900
+ /** The input: the sensor of the match, else its camera. */
44901
+ deviceId: number().int(),
44902
+ /** The input's current name. */
44903
+ name: string(),
44904
+ /** When it was bypassed (ms epoch). */
44905
+ since: number(),
44906
+ /** Triggers from this input dropped since. */
44907
+ dropped: number().int().min(0)
44908
+ });
44699
44909
  var NcAlarmLiveSchema = object({
44700
44910
  state: AlarmStateSchema,
44701
44911
  /** The mode being armed into (exit delay) or held; null when disarmed. */
44702
44912
  targetMode: AlarmArmModeSchema.nullable(),
44703
44913
  availableModes: array(AlarmArmModeSchema),
44704
44914
  openings: array(NcAlarmModeOpeningsSchema),
44705
- exclusions: array(NcAlarmExclusionViewSchema)
44915
+ exclusions: array(NcAlarmExclusionViewSchema),
44916
+ /**
44917
+ * Inputs bypassed for the rest of this arm session; cleared on disarm.
44918
+ * Defaulted so an older hub answer still parses (as "none known").
44919
+ */
44920
+ bypassedInputs: array(NcAlarmInputBypassViewSchema).default([])
44706
44921
  });
44707
44922
  var NcAlarmConfigSchema = object({
44708
44923
  /**
@@ -66595,7 +66810,19 @@ Object.freeze({
66595
66810
  addonId: null,
66596
66811
  access: "view"
66597
66812
  },
66598
- "logDestination.query": {
66813
+ "logDestination.cancelRead": {
66814
+ capName: "log-destination",
66815
+ capScope: "system",
66816
+ addonId: null,
66817
+ access: "create"
66818
+ },
66819
+ "logDestination.describeRead": {
66820
+ capName: "log-destination",
66821
+ capScope: "system",
66822
+ addonId: null,
66823
+ access: "view"
66824
+ },
66825
+ "logDestination.read": {
66599
66826
  capName: "log-destination",
66600
66827
  capScope: "system",
66601
66828
  addonId: null,
@@ -72602,6 +72829,11 @@ Object.freeze({
72602
72829
  form: "single",
72603
72830
  optional: false
72604
72831
  }],
72832
+ "logDestination.read": [{
72833
+ name: "deviceId",
72834
+ form: "single",
72835
+ optional: true
72836
+ }],
72605
72837
  "mediaPlayer.getStatus": [{
72606
72838
  name: "deviceId",
72607
72839
  form: "single",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-export-hap",
3
- "version": "1.2.163",
3
+ "version": "1.2.164",
4
4
  "description": "HomeKit (HAP) exporter for CamStack devices. Publishes each exposed device as its own HomeKit accessory: cameras and doorbells with SRTP streaming, HomeKit Secure Video, motion, two-way audio, PTZ and battery; switches, lights, locks and sensors through a capability→service table.",
5
5
  "keywords": [
6
6
  "camstack",