@camstack/addon-tailscale 1.2.14 → 1.2.15

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.
@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
24
24
  enumerable: true
25
25
  }) : target, mod));
26
26
  //#endregion
27
- const require_dist = require("../dist-BbpHpbVk.js");
27
+ const require_dist = require("../dist-C8p6RC4p.js");
28
28
  let node_child_process = require("node:child_process");
29
29
  let node_util = require("node:util");
30
30
  let node_fs = require("node:fs");
@@ -1,4 +1,4 @@
1
- import { i as EventCategory, n as networkAccessCapability, r as BaseAddon, t as meshNetworkCapability } from "../dist-UJ8lP0Bf.mjs";
1
+ import { i as EventCategory, n as networkAccessCapability, r as BaseAddon, t as meshNetworkCapability } from "../dist-C_wvVtn8.mjs";
2
2
  import { execFile, spawn } from "node:child_process";
3
3
  import { promisify } from "node:util";
4
4
  import * as fs from "node:fs";
@@ -12967,7 +12967,23 @@ var NotificationActionSchema = object({
12967
12967
  * else — see `notification-center/action-token.ts` for what that does and
12968
12968
  * does not buy.
12969
12969
  */
12970
- destructive: boolean().optional()
12970
+ destructive: boolean().optional(),
12971
+ /**
12972
+ * How the tap should REACH the url.
12973
+ *
12974
+ * `navigate` (absent, and every button authored before this field) opens it:
12975
+ * the phone leaves the notification and shows whatever the callback returns.
12976
+ * That is right for a button whose answer the operator wants to read.
12977
+ *
12978
+ * `background` fires it as a POST and stays put. It exists for the buttons
12979
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12980
+ * an answer to the notification, and being thrown into a browser tab to
12981
+ * confirm it costs more attention than the notification did. A backend that
12982
+ * cannot do a background call renders it as an ordinary link (the adapters
12983
+ * fall back rather than dropping the button), so this is a preference, never
12984
+ * a requirement.
12985
+ */
12986
+ mode: _enum(["navigate", "background"]).optional()
12971
12987
  });
12972
12988
  /**
12973
12989
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13968,6 +13984,9 @@ var NcSystemEventConditionSchema = object({
13968
13984
  nodeIds: array(string().min(1)).min(1).optional(),
13969
13985
  packageNames: array(string().min(1)).min(1).optional()
13970
13986
  });
13987
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
13988
+ * outage the operator asked for once and forgot. */
13989
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13971
13990
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13972
13991
  var NcScheduleSchema = object({
13973
13992
  windows: array(object({
@@ -14344,15 +14363,15 @@ var NcConditionsSchema = object({
14344
14363
  * (an `immediate` rule naming an `audio-*` class, one notification per
14345
14364
  * classified sample) stays exactly as it was for rules that already use it.
14346
14365
  *
14347
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14348
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14349
- * (`camstack/src/data/notification-center.ts`, guarded by
14350
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14366
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14367
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14368
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14369
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14351
14370
  * condition fields it does not know when a rule is saved from the phone.
14352
14371
  * Publishing an editor for a condition the app cannot round-trip is how an
14353
- * operator loses a rule's conditions by opening it — so the descriptor, the
14354
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14355
- * does an audio rule become authorable.
14372
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14373
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14374
+ * follows here.
14356
14375
  */
14357
14376
  audio: NcAudioConditionSchema.optional()
14358
14377
  });
@@ -14588,6 +14607,30 @@ var NcRuleInputSchema = object({
14588
14607
  */
14589
14608
  snoozeAllowGlobal: boolean().optional(),
14590
14609
  /**
14610
+ * The snooze durations THIS rule's notification offers as buttons, in
14611
+ * minutes.
14612
+ *
14613
+ * Three states, and all three are distinct — which is exactly why this is
14614
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14615
+ * addon cap path (three production failures in one day), so a schema default
14616
+ * would collapse the first two:
14617
+ *
14618
+ * | value | meaning |
14619
+ * | --- | --- |
14620
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14621
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14622
+ * | a list | these choices, de-duplicated and sorted, at most four |
14623
+ *
14624
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14625
+ * three buttons in total) and a rule that spent it all on snooze choices
14626
+ * would push its own tap-through actions off the notification.
14627
+ *
14628
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14629
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14630
+ * window from anywhere (D133).
14631
+ */
14632
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14633
+ /**
14591
14634
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14592
14635
  *
14593
14636
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14687,6 +14730,7 @@ var NcConditionDescriptorSchema = object({
14687
14730
  "device",
14688
14731
  "package",
14689
14732
  "occupancy",
14733
+ "audio",
14690
14734
  "system"
14691
14735
  ]),
14692
14736
  label: string(),
@@ -14705,6 +14749,7 @@ var NcConditionDescriptorSchema = object({
14705
14749
  "crossingSelect",
14706
14750
  "polygonDraw",
14707
14751
  "occupancy",
14752
+ "audio",
14708
14753
  "deviceState",
14709
14754
  "systemEvent"
14710
14755
  ]),
@@ -14856,7 +14901,20 @@ var NcSnoozeInputSchema = object({
14856
14901
  ruleId: string().optional(),
14857
14902
  /** Required when `scope: 'device'`. */
14858
14903
  deviceId: number().int().optional(),
14859
- durationMinutes: number().int().min(1).max(1440),
14904
+ /**
14905
+ * Narrow the window to these subject classes — "the cat, not the person".
14906
+ *
14907
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14908
+ * what every window authored before this field meant, so no persisted row
14909
+ * changes meaning and no client has to learn anything to keep working.
14910
+ *
14911
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14912
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14913
+ * not at whichever of their four rules happened to produce the notification
14914
+ * they are dismissing.
14915
+ */
14916
+ classes: array(string().min(1)).min(1).optional(),
14917
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14860
14918
  /**
14861
14919
  * Silence this for EVERY recipient, not just the caller. Permission is
14862
14920
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14881,6 +14939,10 @@ var NcSnoozeSchema = object({
14881
14939
  scope: NcSnoozeScopeSchema,
14882
14940
  ruleId: string().optional(),
14883
14941
  deviceId: number().int().optional(),
14942
+ /** Subject classes this window covers. ABSENT = every class — see
14943
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14944
+ * no SQLite column: nothing queries a window by class. */
14945
+ classes: array(string().min(1)).min(1).optional(),
14884
14946
  startedAt: number(),
14885
14947
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14886
14948
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30514,6 +30576,7 @@ Object.freeze({
30514
30576
  "network-access": "ingress",
30515
30577
  "smtp-provider": "email"
30516
30578
  });
30579
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30517
30580
  new Set(["devices", "classes"]);
30518
30581
  /**
30519
30582
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -12967,7 +12967,23 @@ var NotificationActionSchema = object({
12967
12967
  * else — see `notification-center/action-token.ts` for what that does and
12968
12968
  * does not buy.
12969
12969
  */
12970
- destructive: boolean().optional()
12970
+ destructive: boolean().optional(),
12971
+ /**
12972
+ * How the tap should REACH the url.
12973
+ *
12974
+ * `navigate` (absent, and every button authored before this field) opens it:
12975
+ * the phone leaves the notification and shows whatever the callback returns.
12976
+ * That is right for a button whose answer the operator wants to read.
12977
+ *
12978
+ * `background` fires it as a POST and stays put. It exists for the buttons
12979
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12980
+ * an answer to the notification, and being thrown into a browser tab to
12981
+ * confirm it costs more attention than the notification did. A backend that
12982
+ * cannot do a background call renders it as an ordinary link (the adapters
12983
+ * fall back rather than dropping the button), so this is a preference, never
12984
+ * a requirement.
12985
+ */
12986
+ mode: _enum(["navigate", "background"]).optional()
12971
12987
  });
12972
12988
  /**
12973
12989
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13968,6 +13984,9 @@ var NcSystemEventConditionSchema = object({
13968
13984
  nodeIds: array(string().min(1)).min(1).optional(),
13969
13985
  packageNames: array(string().min(1)).min(1).optional()
13970
13986
  });
13987
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
13988
+ * outage the operator asked for once and forgot. */
13989
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13971
13990
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13972
13991
  var NcScheduleSchema = object({
13973
13992
  windows: array(object({
@@ -14344,15 +14363,15 @@ var NcConditionsSchema = object({
14344
14363
  * (an `immediate` rule naming an `audio-*` class, one notification per
14345
14364
  * classified sample) stays exactly as it was for rules that already use it.
14346
14365
  *
14347
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14348
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14349
- * (`camstack/src/data/notification-center.ts`, guarded by
14350
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14366
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14367
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14368
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14369
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14351
14370
  * condition fields it does not know when a rule is saved from the phone.
14352
14371
  * Publishing an editor for a condition the app cannot round-trip is how an
14353
- * operator loses a rule's conditions by opening it — so the descriptor, the
14354
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14355
- * does an audio rule become authorable.
14372
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14373
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14374
+ * follows here.
14356
14375
  */
14357
14376
  audio: NcAudioConditionSchema.optional()
14358
14377
  });
@@ -14588,6 +14607,30 @@ var NcRuleInputSchema = object({
14588
14607
  */
14589
14608
  snoozeAllowGlobal: boolean().optional(),
14590
14609
  /**
14610
+ * The snooze durations THIS rule's notification offers as buttons, in
14611
+ * minutes.
14612
+ *
14613
+ * Three states, and all three are distinct — which is exactly why this is
14614
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14615
+ * addon cap path (three production failures in one day), so a schema default
14616
+ * would collapse the first two:
14617
+ *
14618
+ * | value | meaning |
14619
+ * | --- | --- |
14620
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14621
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14622
+ * | a list | these choices, de-duplicated and sorted, at most four |
14623
+ *
14624
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14625
+ * three buttons in total) and a rule that spent it all on snooze choices
14626
+ * would push its own tap-through actions off the notification.
14627
+ *
14628
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14629
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14630
+ * window from anywhere (D133).
14631
+ */
14632
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14633
+ /**
14591
14634
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14592
14635
  *
14593
14636
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14687,6 +14730,7 @@ var NcConditionDescriptorSchema = object({
14687
14730
  "device",
14688
14731
  "package",
14689
14732
  "occupancy",
14733
+ "audio",
14690
14734
  "system"
14691
14735
  ]),
14692
14736
  label: string(),
@@ -14705,6 +14749,7 @@ var NcConditionDescriptorSchema = object({
14705
14749
  "crossingSelect",
14706
14750
  "polygonDraw",
14707
14751
  "occupancy",
14752
+ "audio",
14708
14753
  "deviceState",
14709
14754
  "systemEvent"
14710
14755
  ]),
@@ -14856,7 +14901,20 @@ var NcSnoozeInputSchema = object({
14856
14901
  ruleId: string().optional(),
14857
14902
  /** Required when `scope: 'device'`. */
14858
14903
  deviceId: number().int().optional(),
14859
- durationMinutes: number().int().min(1).max(1440),
14904
+ /**
14905
+ * Narrow the window to these subject classes — "the cat, not the person".
14906
+ *
14907
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14908
+ * what every window authored before this field meant, so no persisted row
14909
+ * changes meaning and no client has to learn anything to keep working.
14910
+ *
14911
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14912
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14913
+ * not at whichever of their four rules happened to produce the notification
14914
+ * they are dismissing.
14915
+ */
14916
+ classes: array(string().min(1)).min(1).optional(),
14917
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14860
14918
  /**
14861
14919
  * Silence this for EVERY recipient, not just the caller. Permission is
14862
14920
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14881,6 +14939,10 @@ var NcSnoozeSchema = object({
14881
14939
  scope: NcSnoozeScopeSchema,
14882
14940
  ruleId: string().optional(),
14883
14941
  deviceId: number().int().optional(),
14942
+ /** Subject classes this window covers. ABSENT = every class — see
14943
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14944
+ * no SQLite column: nothing queries a window by class. */
14945
+ classes: array(string().min(1)).min(1).optional(),
14884
14946
  startedAt: number(),
14885
14947
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14886
14948
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -30514,6 +30576,7 @@ Object.freeze({
30514
30576
  "network-access": "ingress",
30515
30577
  "smtp-provider": "email"
30516
30578
  });
30579
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30517
30580
  new Set(["devices", "classes"]);
30518
30581
  /**
30519
30582
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_dist = require("../dist-BbpHpbVk.js");
5
+ const require_dist = require("../dist-C8p6RC4p.js");
6
6
  let node_crypto = require("node:crypto");
7
7
  let node_child_process = require("node:child_process");
8
8
  //#region src/ingress/tailscale-cli.ts
@@ -1,4 +1,4 @@
1
- import { i as EventCategory, n as networkAccessCapability, r as BaseAddon } from "../dist-UJ8lP0Bf.mjs";
1
+ import { i as EventCategory, n as networkAccessCapability, r as BaseAddon } from "../dist-C_wvVtn8.mjs";
2
2
  import { randomUUID } from "node:crypto";
3
3
  import { execFile } from "node:child_process";
4
4
  import { promisify } from "node:util";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-tailscale",
3
- "version": "1.2.14",
3
+ "version": "1.2.15",
4
4
  "description": "Tailscale bundle for CamStack — joins the host to a tailnet (client) and exposes the hub via Serve/Funnel (ingress). Multi-entry npm package shipping 2 addons under a single bundle.",
5
5
  "keywords": [
6
6
  "camstack",