@camstack/addon-provider-homematic 1.2.180 → 1.2.181

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.
package/dist/addon.mjs CHANGED
@@ -795,7 +795,7 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
795
795
  return EventCategory;
796
796
  }({});
797
797
  //#endregion
798
- //#region ../types/dist/device-type-BOWLtoOt.mjs
798
+ //#region ../types/dist/device-type-CfHw_quR.mjs
799
799
  /**
800
800
  import { errMsg } from '@camstack/types'
801
801
  * Extract a human-readable message from an unknown error value.
@@ -984,6 +984,9 @@ var DeviceFeature = /* @__PURE__ */ function(DeviceFeature) {
984
984
  DeviceFeature["CoverPositionable"] = "cover-positionable";
985
985
  /** Cover exposes slat-tilt control. Gates the tilt slider UI. */
986
986
  DeviceFeature["CoverTilt"] = "cover-tilt";
987
+ /** Cover has a real stop: `stop` halts the travel in place. Gates the stop
988
+ * control in exporters; a provider whose `stop` is a no-op never declares it. */
989
+ DeviceFeature["CoverStoppable"] = "cover-stoppable";
987
990
  /** Valve exposes intermediate position control (0..100). Gates the
988
991
  * position slider / drag surface UI. */
989
992
  DeviceFeature["ValvePositionable"] = "valve-positionable";
@@ -5849,7 +5852,7 @@ var ZodIssueCode = {
5849
5852
  var ZodFirstPartyTypeKind;
5850
5853
  ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5851
5854
  //#endregion
5852
- //#region ../types/dist/sleep-B-vp7x15.mjs
5855
+ //#region ../types/dist/sleep-QsoHs66J.mjs
5853
5856
  /**
5854
5857
  * The audio chunk plane's byte format, and the ONE expansion from a coded
5855
5858
  * window to float samples (D455).
@@ -5966,7 +5969,7 @@ function isKeychainStoredField(field) {
5966
5969
  var SECRET_CLEAR = { $secretClear: true };
5967
5970
  /** The `'***'` token D634 redaction writes for non-admins. */
5968
5971
  var LEGACY_DEVICE_REDACTION = "***";
5969
- function isRecord$6(value) {
5972
+ function isRecord$7(value) {
5970
5973
  return typeof value === "object" && value !== null && !Array.isArray(value);
5971
5974
  }
5972
5975
  function makeSecretMarker(ref) {
@@ -5977,12 +5980,12 @@ function makeSecretMarker(ref) {
5977
5980
  }
5978
5981
  /** A stored marker: an object whose `$secret` is a non-empty string. */
5979
5982
  function isSecretMarker(value) {
5980
- if (!isRecord$6(value)) return false;
5983
+ if (!isRecord$7(value)) return false;
5981
5984
  const ref = value["$secret"];
5982
5985
  return typeof ref === "string" && ref.length > 0;
5983
5986
  }
5984
5987
  function isSecretClear(value) {
5985
- return isRecord$6(value) && value["$secretClear"] === true;
5988
+ return isRecord$7(value) && value["$secretClear"] === true;
5986
5989
  }
5987
5990
  /**
5988
5991
  * The UI view of a stored secret field value: a marker becomes "set", inline
@@ -6688,7 +6691,7 @@ var KeychainWriteRefusedError = class extends Error {
6688
6691
  }
6689
6692
  };
6690
6693
  var KEEP = { kind: "keep" };
6691
- function isRecord$5(value) {
6694
+ function isRecord$6(value) {
6692
6695
  return typeof value === "object" && value !== null && !Array.isArray(value);
6693
6696
  }
6694
6697
  function defaultMintId() {
@@ -6701,7 +6704,7 @@ function collectSecretMarkerRefs(value, out = []) {
6701
6704
  return out;
6702
6705
  }
6703
6706
  if (Array.isArray(value)) for (const item of value) collectSecretMarkerRefs(item, out);
6704
- else if (isRecord$5(value)) for (const child of Object.values(value)) collectSecretMarkerRefs(child, out);
6707
+ else if (isRecord$6(value)) for (const child of Object.values(value)) collectSecretMarkerRefs(child, out);
6705
6708
  return out;
6706
6709
  }
6707
6710
  async function storedValueEquals(secrets, marker, candidate) {
@@ -6756,7 +6759,7 @@ function rowId(row, idKey) {
6756
6759
  return null;
6757
6760
  }
6758
6761
  async function writeArray(ctx, node, incoming, stored, fieldPath) {
6759
- const storedRows = Array.isArray(stored) ? stored.filter(isRecord$5) : [];
6762
+ const storedRows = Array.isArray(stored) ? stored.filter(isRecord$6) : [];
6760
6763
  if (!Array.isArray(incoming)) {
6761
6764
  ctx.deletes.push(...collectSecretMarkerRefs(storedRows));
6762
6765
  return {
@@ -6772,7 +6775,7 @@ async function writeArray(ctx, node, incoming, stored, fieldPath) {
6772
6775
  const kept = /* @__PURE__ */ new Set();
6773
6776
  const rows = [];
6774
6777
  for (const row of incoming) {
6775
- if (!isRecord$5(row)) {
6778
+ if (!isRecord$6(row)) {
6776
6779
  rows.push(row);
6777
6780
  continue;
6778
6781
  }
@@ -6797,7 +6800,7 @@ async function writeNode(ctx, node, incoming, stored, fieldPath) {
6797
6800
  case "leaf": return writeLeaf(ctx, incoming, stored, fieldPath);
6798
6801
  case "array": return writeArray(ctx, node, incoming, stored, fieldPath);
6799
6802
  case "object": {
6800
- if (!isRecord$5(incoming)) {
6803
+ if (!isRecord$6(incoming)) {
6801
6804
  if (incoming === void 0) return KEEP;
6802
6805
  ctx.deletes.push(...collectSecretMarkerRefs(stored));
6803
6806
  return {
@@ -6805,7 +6808,7 @@ async function writeNode(ctx, node, incoming, stored, fieldPath) {
6805
6808
  value: incoming
6806
6809
  };
6807
6810
  }
6808
- const storedObj = isRecord$5(stored) ? stored : {};
6811
+ const storedObj = isRecord$6(stored) ? stored : {};
6809
6812
  return {
6810
6813
  kind: "value",
6811
6814
  value: await writeMembers(ctx, node.children, incoming, storedObj, (m) => `${fieldPath}.${m}`)
@@ -6928,7 +6931,7 @@ async function resolveSecretMarkers(value, secrets, options = {}) {
6928
6931
  value: items
6929
6932
  };
6930
6933
  }
6931
- if (isRecord$5(v)) {
6934
+ if (isRecord$6(v)) {
6932
6935
  const out = {};
6933
6936
  for (const [k, child] of Object.entries(v)) {
6934
6937
  const s = substitute(child);
@@ -6960,7 +6963,7 @@ var SecretOverwriteRefusedError = class extends Error {
6960
6963
  this.name = "SecretOverwriteRefusedError";
6961
6964
  }
6962
6965
  };
6963
- function isRecord$4(value) {
6966
+ function isRecord$5(value) {
6964
6967
  return typeof value === "object" && value !== null && !Array.isArray(value);
6965
6968
  }
6966
6969
  function resolvedValue(pass, marker) {
@@ -6989,7 +6992,7 @@ function inArray(pass, incoming, stored) {
6989
6992
  return incoming.map((item, index) => {
6990
6993
  const twin = stored[index];
6991
6994
  if (isSecretMarker(twin)) return typeof item === "string" && item === resolvedValue(pass, twin) ? twin : item;
6992
- if (isRecord$4(item) && isRecord$4(twin)) return inArrayRow(pass, item, twin);
6995
+ if (isRecord$5(item) && isRecord$5(twin)) return inArrayRow(pass, item, twin);
6993
6996
  if (Array.isArray(item) && Array.isArray(twin)) return inArray(pass, item, twin);
6994
6997
  return item;
6995
6998
  });
@@ -7000,7 +7003,7 @@ function inArrayRow(pass, incoming, stored) {
7000
7003
  const twin = stored[key];
7001
7004
  if (isSecretMarker(twin)) {
7002
7005
  if (typeof value === "string" && value === resolvedValue(pass, twin)) out[key] = twin;
7003
- } else if (isRecord$4(value) && isRecord$4(twin)) out[key] = inArrayRow(pass, value, twin);
7006
+ } else if (isRecord$5(value) && isRecord$5(twin)) out[key] = inArrayRow(pass, value, twin);
7004
7007
  else if (Array.isArray(value) && Array.isArray(twin)) out[key] = inArray(pass, value, twin);
7005
7008
  }
7006
7009
  return out;
@@ -7008,7 +7011,7 @@ function inArrayRow(pass, incoming, stored) {
7008
7011
  async function walk(pass, incoming, stored) {
7009
7012
  if (isSecretMarker(stored)) return atMarker(pass, incoming, stored);
7010
7013
  if (Array.isArray(incoming) && Array.isArray(stored)) return inArray(pass, incoming, stored);
7011
- if (!isRecord$4(incoming) || !isRecord$4(stored)) return incoming;
7014
+ if (!isRecord$5(incoming) || !isRecord$5(stored)) return incoming;
7012
7015
  const out = { ...incoming };
7013
7016
  for (const [key, value] of Object.entries(incoming)) out[key] = await walk(pass, value, stored[key]);
7014
7017
  return out;
@@ -7039,7 +7042,7 @@ async function restoreUnchangedSecrets(input) {
7039
7042
  function isJsonEqual(a, b) {
7040
7043
  if (Object.is(a, b)) return true;
7041
7044
  if (Array.isArray(a)) return Array.isArray(b) && a.length === b.length && a.every((v, i) => isJsonEqual(v, b[i]));
7042
- if (isRecord$4(a) && isRecord$4(b)) {
7045
+ if (isRecord$5(a) && isRecord$5(b)) {
7043
7046
  const keys = Object.keys(a);
7044
7047
  if (keys.length !== Object.keys(b).length) return false;
7045
7048
  return keys.every((k) => Object.prototype.hasOwnProperty.call(b, k) && isJsonEqual(a[k], b[k]));
@@ -7063,7 +7066,7 @@ function markerKeysOf(blob, owner) {
7063
7066
  }
7064
7067
  function nodeFromStored(value, owner) {
7065
7068
  if (isSecretMarker(value)) return isSecretRefOwnedBy(value.$secret, owner) ? { kind: "leaf" } : null;
7066
- if (!isRecord$4(value)) return null;
7069
+ if (!isRecord$5(value)) return null;
7067
7070
  const children = /* @__PURE__ */ new Map();
7068
7071
  for (const [key, child] of Object.entries(value)) {
7069
7072
  const node = nodeFromStored(child, owner);
@@ -7682,6 +7685,44 @@ var BaseAddon = class {
7682
7685
  return null;
7683
7686
  }
7684
7687
  /**
7688
+ * D986 scoped settings: the form shape of the CLUSTER-wide settings one capability this addon
7689
+ * provides owns, or `null` when it has none. `cap` is a capability name the addon's manifest
7690
+ * declares. Stored as `addon-settings` rows `<addonId>.<field>`. The keys of this schema, of
7691
+ * {@link nodeSettingsSchema} and of {@link deviceDefaultsSchema} are disjoint, and a key never
7692
+ * contains `@` (guard `check-scoped-settings-declared`). SHAPE only: values are read by scope.
7693
+ */
7694
+ async clusterSettingsSchema(_cap) {
7695
+ return null;
7696
+ }
7697
+ /**
7698
+ * D986: the form shape of the settings one capability owns PER NODE, or `null`. Stored as
7699
+ * `addon-settings` rows `<addonId>.<field>@<nodeId>` carrying `nodeId` in the row data, so a
7700
+ * forgotten node's rows go in one central delete.
7701
+ */
7702
+ async nodeSettingsSchema(_cap) {
7703
+ return null;
7704
+ }
7705
+ /**
7706
+ * D986: the form shape of the FLEET DEFAULTS of the per-device settings one capability owns,
7707
+ * or `null`. Stored as `addon-settings` rows `<addonId>.<field>`; a device resolves its value
7708
+ * as device row, then this default, then the schema default (`resolveDeviceSettings`).
7709
+ */
7710
+ async deviceDefaultsSchema(_cap) {
7711
+ return null;
7712
+ }
7713
+ /**
7714
+ * The host's read of the scoped declarations: the schema one capability declares for `scope`,
7715
+ * or `null`. Beside {@link getIntegrationFormSchema}, the same shape: the hook is protected, the
7716
+ * host asks this method.
7717
+ */
7718
+ async getScopedSettingsSchema(scope, cap) {
7719
+ switch (scope) {
7720
+ case "cluster": return this.clusterSettingsSchema(cap);
7721
+ case "node": return this.nodeSettingsSchema(cap);
7722
+ case "device-defaults": return this.deviceDefaultsSchema(cap);
7723
+ }
7724
+ }
7725
+ /**
7685
7726
  * What the create wizard and the integration edit page render for one instance: the addon's
7686
7727
  * per-instance schema when it declares one, else its global schema (what they always showed).
7687
7728
  */
@@ -8475,6 +8516,21 @@ function normalizeAddonInitResult(result) {
8475
8516
  if (Array.isArray(result)) return { providers: result };
8476
8517
  return result;
8477
8518
  }
8519
+ /** Limits and names of `ctx.records` (D881). One authority; the engine and the facade read it. */
8520
+ /** The files a kind may live in. `history` is device-history's (D850), never records. */
8521
+ var RECORD_DATABASES = ["settings", "events"];
8522
+ /** The classes of a kind: the `@durable` vocabulary, one authority (replaces the annotation). */
8523
+ var RECORD_CLASSES = [
8524
+ "config",
8525
+ "ledger",
8526
+ "audit",
8527
+ "mirror",
8528
+ "ephemeral"
8529
+ ];
8530
+ var RECORD_DEFAULT_MAX_DATA_BYTES = 64 * 1024;
8531
+ var RECORD_MAX_DATA_BYTES = 1024 * 1024;
8532
+ var RECORD_BATCH_MAX = 1e3;
8533
+ var RECORD_QUERY_MAX = 1e3;
8478
8534
  /**
8479
8535
  * The share-view scope kinds a share-link token can carry. The hub mints
8480
8536
  * and validates them (`ShareViewGrantSchema` builds its
@@ -8499,21 +8555,6 @@ var PeerBytesTicketSchema = object({
8499
8555
  */
8500
8556
  declaredBytes: number().int().nonnegative().nullable()
8501
8557
  });
8502
- /** Limits and names of `ctx.records` (D881). One authority; the engine and the facade read it. */
8503
- /** The files a kind may live in. `history` is device-history's (D850), never records. */
8504
- var RECORD_DATABASES = ["settings", "events"];
8505
- /** The classes of a kind: the `@durable` vocabulary, one authority (replaces the annotation). */
8506
- var RECORD_CLASSES = [
8507
- "config",
8508
- "ledger",
8509
- "audit",
8510
- "mirror",
8511
- "ephemeral"
8512
- ];
8513
- var RECORD_DEFAULT_MAX_DATA_BYTES = 64 * 1024;
8514
- var RECORD_MAX_DATA_BYTES = 1024 * 1024;
8515
- var RECORD_BATCH_MAX = 1e3;
8516
- var RECORD_QUERY_MAX = 1e3;
8517
8558
  function defOf(schema) {
8518
8559
  const zodBag = Reflect.get(schema, "_zod");
8519
8560
  if (typeof zodBag !== "object" || zodBag === null) return {};
@@ -9405,6 +9446,7 @@ var CAP_NAMES = Object.freeze([
9405
9446
  "humidity-sensor",
9406
9447
  "image",
9407
9448
  "image-settings",
9449
+ "integration-instances",
9408
9450
  "integrations",
9409
9451
  "intercom",
9410
9452
  "ir-transmitter",
@@ -11338,7 +11380,7 @@ object({
11338
11380
  params: record(string(), union([string(), number()])).optional()
11339
11381
  });
11340
11382
  //#endregion
11341
- //#region ../types/dist/composition-kKKOdFIG.mjs
11383
+ //#region ../types/dist/composition-Dh3RfMx5.mjs
11342
11384
  /**
11343
11385
  * The ffmpeg build every CamStack node downloads, per platform and arch.
11344
11386
  *
@@ -15594,8 +15636,18 @@ var LogChannelDescriptorSchema = object({
15594
15636
  * the operator narrows to one camera, sees nothing, and concludes the code
15595
15637
  * path was never taken.
15596
15638
  */
15597
- perDevice: boolean()
15598
- });
15639
+ perDevice: boolean(),
15640
+ /**
15641
+ * What the channel is FOR, so the UI can list the channels an addon offers.
15642
+ *
15643
+ * - `diagnostic` (the default): a per-component diagnostic armed from the
15644
+ * Levels page, emitted at its declared level.
15645
+ * - `debug`: a `debug.<channel>` dump watched live for a short window
15646
+ * (`ctx.debug`). Always per-device, and its lines are denied by the log
15647
+ * ring unless somebody is watching that device.
15648
+ */
15649
+ kind: _enum(["diagnostic", "debug"]).default("diagnostic")
15650
+ }).refine((d) => d.kind !== "debug" || d.name.startsWith("debug.") && d.perDevice, { message: "a debug channel is named debug.<channel> and is per-device" });
15599
15651
  /**
15600
15652
  * An armed window over one channel, as the document hands it to a mirror.
15601
15653
  *
@@ -20811,6 +20863,7 @@ var SYSTEM_CAP_VOCABULARY = {
20811
20863
  "load-contribution": system(INTERNAL),
20812
20864
  "local-network": system(NETWORK),
20813
20865
  "log-channels": system(INTERNAL),
20866
+ "integration-instances": system(INTERNAL),
20814
20867
  "log-destination": system(INTERNAL),
20815
20868
  "login-method": system(IDENTITY),
20816
20869
  "mesh-network": system(NETWORK),
@@ -43096,7 +43149,7 @@ var TargetKindCapsSchema = object({
43096
43149
  * the union is large and not meant for runtime validation here; the exported
43097
43150
  * `TargetKind` type re-tightens `configSchema` to `ConfigUISchema`.
43098
43151
  */
43099
- var ConfigSchemaPassthrough$3 = unknown();
43152
+ var ConfigSchemaPassthrough$4 = unknown();
43100
43153
  var TargetKindSchema = object({
43101
43154
  kind: string(),
43102
43155
  label: string(),
@@ -43133,7 +43186,7 @@ var TargetKindSchema = object({
43133
43186
  * its raster path, which is the safe default for an unknown image.
43134
43187
  */
43135
43188
  iconMediaType: string().optional(),
43136
- configSchema: ConfigSchemaPassthrough$3,
43189
+ configSchema: ConfigSchemaPassthrough$4,
43137
43190
  /**
43138
43191
  * The config keys that decide WHERE this kind's secrets are sent (server,
43139
43192
  * base URL, instance, chat, recipient). A save that changes any of them
@@ -50760,6 +50813,45 @@ var deviceProviderCapability = {
50760
50813
  }
50761
50814
  };
50762
50815
  /**
50816
+ * What the passive listener of `local-network` saw on the wire, before any
50817
+ * provider classified it. Device-manager turns an observation into the hits
50818
+ * of the providers whose declared discovery modes it matches.
50819
+ */
50820
+ var DiscoveryObservationSchema = discriminatedUnion("kind", [object({
50821
+ kind: literal("mdns"),
50822
+ /** Normalised DNS-SD service type, e.g. `_esphomelib._tcp`. */
50823
+ serviceType: string(),
50824
+ instance: string(),
50825
+ host: string(),
50826
+ /** The A record address when the announcement carried one. */
50827
+ address: string().nullable(),
50828
+ port: number().int(),
50829
+ txt: record(string(), string())
50830
+ }), object({
50831
+ kind: literal("ssdp"),
50832
+ /** Sender address of the datagram. */
50833
+ host: string(),
50834
+ port: number().int(),
50835
+ /** `NT` of a NOTIFY, `ST` of a search response. */
50836
+ target: string(),
50837
+ headers: record(string(), string())
50838
+ })]);
50839
+ object({
50840
+ addonId: string(),
50841
+ candidate: DiscoveryCandidateSchema,
50842
+ firstSeenAt: number(),
50843
+ lastSeenAt: number(),
50844
+ dismissed: boolean()
50845
+ });
50846
+ var DiscoveryProposalSchema = object({
50847
+ id: string(),
50848
+ addonId: string(),
50849
+ candidate: DiscoveryCandidateSchema,
50850
+ firstSeenAt: number(),
50851
+ lastSeenAt: number(),
50852
+ dismissed: boolean()
50853
+ });
50854
+ /**
50763
50855
  * Device Manager capability — hub-side singleton that unifies device persistence,
50764
50856
  * live registry access, and all management operations into a single tRPC surface.
50765
50857
  *
@@ -51488,6 +51580,19 @@ method(object({
51488
51580
  }), object({ candidates: array(DiscoveryCandidateSchema).readonly() }), {
51489
51581
  kind: "mutation",
51490
51582
  auth: "admin"
51583
+ }), method(object({}), object({ proposals: array(DiscoveryProposalSchema).readonly() }), { auth: "admin" }), method(object({ id: string() }), object({ dismissed: boolean() }), {
51584
+ kind: "mutation",
51585
+ auth: "admin"
51586
+ }), method(object({ observations: array(DiscoveryObservationSchema).max(512) }), object({ proposed: number().int() }), {
51587
+ kind: "mutation",
51588
+ auth: "admin"
51589
+ }), method(object({}), object({
51590
+ providers: number().int(),
51591
+ proposed: number().int()
51592
+ }), {
51593
+ kind: "mutation",
51594
+ auth: "admin",
51595
+ timeoutMs: 12e4
51491
51596
  }), method(object({ addonId: string() }), object({ deviceType: _enum(DeviceType).nullable() }), { auth: "admin" }), method(object({ addonId: string() }), unknown(), { auth: "admin" }), method(object({
51492
51597
  deviceId: number(),
51493
51598
  key: string(),
@@ -54832,6 +54937,78 @@ method(_void(), array(IntegrationWithStateSchema)), method(object({ id: string()
54832
54937
  auth: "admin"
54833
54938
  });
54834
54939
  /**
54940
+ * `integration-instances` - the connection of an addon that holds ONE or SEVERAL
54941
+ * (an account, a relay, a destination) as typed records (D985, D986). The addon's
54942
+ * own function page reads and writes them (Logging for Loki); the Integrations
54943
+ * page lists only the integrations that bring devices (D996).
54944
+ *
54945
+ * A collection of providers: each addon that holds connections registers one and a
54946
+ * caller reaches a provider with the pinned `addonId`.
54947
+ *
54948
+ * Identity: the instance id is immutable and opaque to the caller. A record the
54949
+ * Loki migration made keeps the `integrations` registry id it was created under
54950
+ * (`int_NNNN`); a single instance made by its function page takes the addon id.
54951
+ * `name` is the editable label.
54952
+ *
54953
+ * Secrets: every field the instance kind marks `.meta({ secret: true })` reaches
54954
+ * the form as a `SecretFieldView`, never text (D789). A patch value omitted, `''`
54955
+ * or the redaction token KEEPS the stored secret; `{ $secretClear: true }`
54956
+ * clears it.
54957
+ */
54958
+ var ConfigSchemaPassthrough$3 = custom();
54959
+ var IntegrationInstanceIdSchema = string().min(1);
54960
+ var IntegrationInstanceDescriptionSchema = object({
54961
+ /** `single`: at most one instance can exist (Loki). `multiple`: an account each. */
54962
+ instanceMode: _enum(["single", "multiple"]),
54963
+ /** What the instance is, for the UI (`destination`, `relay`, `account`). */
54964
+ kind: string(),
54965
+ /** True when `testInstance` really probes the remote. */
54966
+ canTest: boolean()
54967
+ });
54968
+ var IntegrationInstanceStatusSchema = object({
54969
+ state: _enum([
54970
+ "ok",
54971
+ "off",
54972
+ "error",
54973
+ "unknown"
54974
+ ]),
54975
+ detail: string().optional()
54976
+ });
54977
+ var IntegrationInstanceSchema = object({
54978
+ id: IntegrationInstanceIdSchema,
54979
+ name: string(),
54980
+ /** The addon's own rule (an URL is present, a client id is present...). */
54981
+ configured: boolean(),
54982
+ /** Values for the instance form; a secret is a `SecretFieldView`, never text. */
54983
+ formValues: record(string(), unknown()),
54984
+ status: IntegrationInstanceStatusSchema.optional()
54985
+ });
54986
+ var IntegrationInstancePatchSchema = object({
54987
+ id: IntegrationInstanceIdSchema,
54988
+ name: string().min(1).optional(),
54989
+ /** Omitted / '' / redaction token keeps a secret; `{ $secretClear: true }` clears it. */
54990
+ values: record(string(), unknown())
54991
+ });
54992
+ method(_void(), IntegrationInstanceDescriptionSchema, { auth: "admin" }), method(object({ id: IntegrationInstanceIdSchema.nullable() }), ConfigSchemaPassthrough$3, { auth: "admin" }), method(_void(), array(IntegrationInstanceSchema).readonly(), { auth: "admin" }), method(object({ id: IntegrationInstanceIdSchema }), IntegrationInstanceSchema.nullable(), { auth: "admin" }), method(object({
54993
+ id: IntegrationInstanceIdSchema,
54994
+ name: string().min(1)
54995
+ }), object({ id: string() }), {
54996
+ kind: "mutation",
54997
+ auth: "admin"
54998
+ }), method(IntegrationInstancePatchSchema, object({ ok: literal(true) }), {
54999
+ kind: "mutation",
55000
+ auth: "admin"
55001
+ }), method(object({ id: IntegrationInstanceIdSchema }), object({ ok: literal(true) }), {
55002
+ kind: "mutation",
55003
+ auth: "admin"
55004
+ }), optionalMethod(object({
55005
+ id: IntegrationInstanceIdSchema.nullable(),
55006
+ values: record(string(), unknown())
55007
+ }), TestConnectionResultSchema$1, {
55008
+ kind: "mutation",
55009
+ auth: "admin"
55010
+ });
55011
+ /**
54835
55012
  * Two-way audio / talk-back cap. Clients open a WebRTC audio-only
54836
55013
  * session (server-initiated offer pattern, identical to the main
54837
55014
  * video WebRTC flow) and the browser captures the mic; the server
@@ -65599,7 +65776,14 @@ var NcMediaPolicySchema = object({
65599
65776
  */
65600
65777
  profile: CamProfileSchema.optional(),
65601
65778
  /** See {@link NcLinkedCameraModeSchema}. */
65602
- linkedCameras: NcLinkedCameraModeSchema.optional()
65779
+ linkedCameras: NcLinkedCameraModeSchema.optional(),
65780
+ /**
65781
+ * Sensor rules only: may this rule wake a SLEEPING battery camera to take
65782
+ * the linked still it attaches (D998)? Absent means yes, an explicit `false`
65783
+ * opts out. Deliberately not a Zod default: a rule that never chose keeps
65784
+ * following the hub's. One bounded wake per event; nothing is attached later.
65785
+ */
65786
+ wakeSleepingCamera: boolean().optional()
65603
65787
  });
65604
65788
  /**
65605
65789
  * Cooldown GRANULARITY over the subject's class — how much a fired
@@ -74156,7 +74340,16 @@ var smokeCapability = {
74156
74340
  * future fields without breaking the existing call sites.
74157
74341
  */
74158
74342
  var EmailAddressSchema = email();
74343
+ /**
74344
+ * Which relay of a multi-relay provider answers (D996). Absent = the provider's first / default
74345
+ * relay, so a caller written before relays existed keeps working unchanged. A provider with one
74346
+ * fixed relay ignores it. This is the integration instance id (`int_NNNN`), NOT the addon id: the
74347
+ * collection pin `addonId` still picks the provider, `instanceId` picks the relay inside it.
74348
+ */
74349
+ var InstanceIdSchema = string().min(1).optional();
74350
+ var RelayPinSchema = object({ instanceId: InstanceIdSchema });
74159
74351
  var SendEmailInputSchema = object({
74352
+ instanceId: InstanceIdSchema,
74160
74353
  to: union([EmailAddressSchema, array(EmailAddressSchema).min(1)]),
74161
74354
  cc: array(EmailAddressSchema).optional(),
74162
74355
  bcc: array(EmailAddressSchema).optional(),
@@ -74192,11 +74385,11 @@ method(SendEmailInputSchema, SendEmailResultSchema, {
74192
74385
  kind: "mutation",
74193
74386
  auth: "admin",
74194
74387
  access: "create"
74195
- }), method(_void(), SmtpStatusSchema, {
74388
+ }), method(RelayPinSchema, SmtpStatusSchema, {
74196
74389
  kind: "mutation",
74197
74390
  auth: "admin",
74198
74391
  access: "view"
74199
- }), method(_void(), SmtpStatusSchema, { auth: "admin" });
74392
+ }), method(RelayPinSchema, SmtpStatusSchema, { auth: "admin" });
74200
74393
  /**
74201
74394
  * A single device snapshot returned as base64 JPEG/PNG.
74202
74395
  *
@@ -74228,10 +74421,12 @@ DeviceType.Camera, method(object({
74228
74421
  * even when the cache is well within the device's
74229
74422
  * `snapshotMaxAgeS` window.
74230
74423
  *
74231
- * **`force` is an OPERATOR signal, not a freshness preference.** On a
74424
+ * **`force` is a demand with a named principal, not a freshness
74425
+ * preference** — an operator button, the scheduled refresh (D847), or a
74426
+ * notification rule that left the camera's wake allowed (D998). On a
74232
74427
  * battery camera it is the one thing that walks past the wrapper's
74233
- * sleep gate and wakes the camera, so a background caller — a poller,
74234
- * an event handler, a thumbnail — must NEVER set it. Every such caller
74428
+ * sleep gate and wakes the camera, so a poller, a thumbnail or a
74429
+ * prestream must NEVER set it. Every such caller
74235
74430
  * gets the cached frame, which on a sleeping battery camera is the
74236
74431
  * correct answer: stale but honest beats woken.
74237
74432
  */
@@ -75801,6 +75996,40 @@ var LoggingSettingsStateSchema = object({
75801
75996
  opsLogRetentionDays: number().int().min(0),
75802
75997
  persisted: boolean()
75803
75998
  });
75999
+ /**
76000
+ * Debug WATCH — a short, per-device window over `debug.<channel>` lines.
76001
+ *
76002
+ * `start` opens (or re-arms) a 10 minute window; `rearm` extends a LIVE one
76003
+ * and never revives a lapsed one; `stop` closes it; `list` only reads. No
76004
+ * chain of re-arms outlives 60 minutes from the first start. The hub holds the
76005
+ * watches in memory and pushes the interest to every node, so a watch lapses
76006
+ * by itself and survives nothing — a restart is a stop.
76007
+ */
76008
+ var DebugWatchInputSchema = object({
76009
+ action: _enum([
76010
+ "list",
76011
+ "start",
76012
+ "rearm",
76013
+ "stop"
76014
+ ]),
76015
+ /** Full channel names, `debug.<channel>`, each declared with `kind: 'debug'`. */
76016
+ channels: array(string().min(1)).readonly().default([]),
76017
+ /** Numeric device ids. Required (non-empty) for `start`. */
76018
+ deviceIds: array(number().int()).readonly().default([])
76019
+ });
76020
+ var DebugWatchStateSchema = object({
76021
+ channel: string(),
76022
+ deviceIds: array(number().int()).readonly(),
76023
+ startedAtMs: number(),
76024
+ untilMs: number(),
76025
+ capAtMs: number()
76026
+ });
76027
+ var DebugWatchResultSchema = object({
76028
+ nowMs: number(),
76029
+ watches: array(DebugWatchStateSchema).readonly(),
76030
+ /** Channels a `rearm` found already lapsed: nothing was revived. */
76031
+ lapsed: array(string()).readonly()
76032
+ });
75804
76033
  method(_void(), SystemInfoSchema), method(_void(), HealthStatusSchema), method(_void(), FeatureManifestSchema), method(_void(), array(NetworkAddressSchema).readonly()), method(_void(), unknown().nullable(), { auth: "admin" }), method(record(string(), unknown()), _null(), {
75805
76034
  kind: "mutation",
75806
76035
  auth: "admin"
@@ -75816,6 +76045,9 @@ method(_void(), SystemInfoSchema), method(_void(), HealthStatusSchema), method(_
75816
76045
  }), method(_void(), RequestCensusStatusSchema, { auth: "admin" }), method(_void(), array(ReportedLoadContributionSchema).readonly(), { auth: "admin" }), method(_void(), array(ReportedFailureContributionSchema).readonly(), { auth: "admin" }), method(GetLoggingSettingsInputSchema, LoggingSettingsStateSchema, { auth: "admin" }), method(SetLoggingSettingsInputSchema, LoggingSettingsStateSchema, {
75817
76046
  kind: "mutation",
75818
76047
  auth: "admin"
76048
+ }), method(DebugWatchInputSchema, DebugWatchResultSchema, {
76049
+ kind: "mutation",
76050
+ auth: "admin"
75819
76051
  });
75820
76052
  /**
75821
76053
  * Tamper / case-open detection sensor. Drives Home Assistant
@@ -78973,7 +79205,7 @@ discriminatedUnion("kind", [object({
78973
79205
  kind: literal("pronto"),
78974
79206
  code: string()
78975
79207
  })]);
78976
- DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
79208
+ DeviceFeature.FanSpeed, DeviceFeature.FanPreset, DeviceFeature.FanDirection, DeviceFeature.FanOscillating, DeviceFeature.CoverStoppable, DeviceFeature.CoverPositionable, DeviceFeature.CoverTilt, DeviceFeature.ValvePositionable, DeviceFeature.MediaPlayerVolume, DeviceFeature.ClimateFanMode;
78977
79209
  SOURCE_CAPS.filter((cap) => cap !== "switch" && cap !== "motion");
78978
79210
  String.raw`rose\(active(\d+), changed(\d+), (\d+(?:\.\d+)?)\)`;
78979
79211
  DeviceRole.BinarySensor, DeviceRole.MotionSensor;
@@ -82854,6 +83086,13 @@ Object.freeze({
82854
83086
  access: "view",
82855
83087
  role: "admin"
82856
83088
  },
83089
+ "deviceManager.dismissDiscoveryProposal": {
83090
+ capName: "device-manager",
83091
+ capScope: "system",
83092
+ addonId: null,
83093
+ access: "create",
83094
+ role: "admin"
83095
+ },
82857
83096
  "deviceManager.enable": {
82858
83097
  capName: "device-manager",
82859
83098
  capScope: "system",
@@ -83036,6 +83275,13 @@ Object.freeze({
83036
83275
  access: "view",
83037
83276
  role: "viewer"
83038
83277
  },
83278
+ "deviceManager.listDiscoveryProposals": {
83279
+ capName: "device-manager",
83280
+ capScope: "system",
83281
+ addonId: null,
83282
+ access: "view",
83283
+ role: "admin"
83284
+ },
83039
83285
  "deviceManager.listLocationDescriptions": {
83040
83286
  capName: "device-manager",
83041
83287
  capScope: "system",
@@ -83190,6 +83436,13 @@ Object.freeze({
83190
83436
  access: "create",
83191
83437
  role: "admin"
83192
83438
  },
83439
+ "deviceManager.reportDiscoveryObservations": {
83440
+ capName: "device-manager",
83441
+ capScope: "system",
83442
+ addonId: null,
83443
+ access: "create",
83444
+ role: "admin"
83445
+ },
83193
83446
  "deviceManager.runDeviceAction": {
83194
83447
  capName: "device-manager",
83195
83448
  capScope: "system",
@@ -83197,6 +83450,13 @@ Object.freeze({
83197
83450
  access: "create",
83198
83451
  role: "admin"
83199
83452
  },
83453
+ "deviceManager.runDiscoverySweep": {
83454
+ capName: "device-manager",
83455
+ capScope: "system",
83456
+ addonId: null,
83457
+ access: "create",
83458
+ role: "admin"
83459
+ },
83200
83460
  "deviceManager.setChildLayout": {
83201
83461
  capName: "device-manager",
83202
83462
  capScope: "system",
@@ -84128,6 +84388,62 @@ Object.freeze({
84128
84388
  access: "create",
84129
84389
  role: "admin"
84130
84390
  },
84391
+ "integrationInstances.createInstance": {
84392
+ capName: "integration-instances",
84393
+ capScope: "system",
84394
+ addonId: null,
84395
+ access: "create",
84396
+ role: "admin"
84397
+ },
84398
+ "integrationInstances.deleteInstance": {
84399
+ capName: "integration-instances",
84400
+ capScope: "system",
84401
+ addonId: null,
84402
+ access: "delete",
84403
+ role: "admin"
84404
+ },
84405
+ "integrationInstances.describe": {
84406
+ capName: "integration-instances",
84407
+ capScope: "system",
84408
+ addonId: null,
84409
+ access: "view",
84410
+ role: "admin"
84411
+ },
84412
+ "integrationInstances.getInstance": {
84413
+ capName: "integration-instances",
84414
+ capScope: "system",
84415
+ addonId: null,
84416
+ access: "view",
84417
+ role: "admin"
84418
+ },
84419
+ "integrationInstances.instanceFormSchema": {
84420
+ capName: "integration-instances",
84421
+ capScope: "system",
84422
+ addonId: null,
84423
+ access: "view",
84424
+ role: "admin"
84425
+ },
84426
+ "integrationInstances.listInstances": {
84427
+ capName: "integration-instances",
84428
+ capScope: "system",
84429
+ addonId: null,
84430
+ access: "view",
84431
+ role: "admin"
84432
+ },
84433
+ "integrationInstances.testInstance": {
84434
+ capName: "integration-instances",
84435
+ capScope: "system",
84436
+ addonId: null,
84437
+ access: "create",
84438
+ role: "admin"
84439
+ },
84440
+ "integrationInstances.updateInstance": {
84441
+ capName: "integration-instances",
84442
+ capScope: "system",
84443
+ addonId: null,
84444
+ access: "create",
84445
+ role: "admin"
84446
+ },
84131
84447
  "integrations.create": {
84132
84448
  capName: "integrations",
84133
84449
  capScope: "system",
@@ -89784,6 +90100,13 @@ Object.freeze({
89784
90100
  access: "create",
89785
90101
  role: "viewer"
89786
90102
  },
90103
+ "system.debugWatch": {
90104
+ capName: "system",
90105
+ capScope: "system",
90106
+ addonId: null,
90107
+ access: "create",
90108
+ role: "admin"
90109
+ },
89787
90110
  "system.detectSiteLocation": {
89788
90111
  capName: "system",
89789
90112
  capScope: "system",
@@ -93702,6 +94025,11 @@ Object.freeze({
93702
94025
  form: "single",
93703
94026
  optional: false
93704
94027
  }],
94028
+ "system.debugWatch": [{
94029
+ name: "deviceIds",
94030
+ form: "array",
94031
+ optional: true
94032
+ }],
93705
94033
  "tamper.getStatus": [{
93706
94034
  name: "deviceId",
93707
94035
  form: "single",
@@ -121059,6 +121387,8 @@ var hmActuatorSchema = hmChildSchema.extend({
121059
121387
  * existing pure decoders (`decodeCover` / `decodeLock` / `decodeClimate`).
121060
121388
  */
121061
121389
  var HmActuatorDevice = class extends HmChildDevice {
121390
+ /** A cover's `stop` drives the channel's real STOP (`coverStop`). */
121391
+ features = this.config.values.kind === "cover" ? [DeviceFeature.CoverStoppable] : [];
121062
121392
  kind;
121063
121393
  /** The actuator cap name actually registered (drives decode routing). */
121064
121394
  registeredCap = null;