@camstack/addon-remote-storage 1.2.13 → 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.
package/dist/s3.addon.js CHANGED
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-CgYcIB-Z.js");
5
+ const require_shared = require("./shared-yG0yCeMJ.js");
6
6
  let node_stream = require("node:stream");
7
7
  let _aws_sdk_client_s3 = require("@aws-sdk/client-s3");
8
8
  let _aws_sdk_lib_storage = require("@aws-sdk/lib-storage");
package/dist/s3.addon.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { c as BaseAddon, i as rearmIdleAbort, n as getOptionalBasePath, o as scheduleIdleAbort, s as storageProviderCapability, t as createSessionId } from "./shared-saei9-aP.mjs";
1
+ import { c as BaseAddon, i as rearmIdleAbort, n as getOptionalBasePath, o as scheduleIdleAbort, s as storageProviderCapability, t as createSessionId } from "./shared-Hjb2o6ip.mjs";
2
2
  import { PassThrough } from "node:stream";
3
3
  import { DeleteObjectCommand, GetObjectCommand, HeadBucketCommand, HeadObjectCommand, ListObjectsV2Command, PutObjectCommand, S3Client } from "@aws-sdk/client-s3";
4
4
  import { Upload } from "@aws-sdk/lib-storage";
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-CgYcIB-Z.js");
5
+ const require_shared = require("./shared-yG0yCeMJ.js");
6
6
  let ssh2 = require("ssh2");
7
7
  let node_path = require("node:path");
8
8
  node_path = require_shared.__toESM(node_path);
@@ -1,4 +1,4 @@
1
- import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-saei9-aP.mjs";
1
+ import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-Hjb2o6ip.mjs";
2
2
  import { Client } from "ssh2";
3
3
  import * as path from "node:path";
4
4
  //#region src/providers/sftp/sftp-config-schema.ts
@@ -12952,7 +12952,23 @@ var NotificationActionSchema = object({
12952
12952
  * else — see `notification-center/action-token.ts` for what that does and
12953
12953
  * does not buy.
12954
12954
  */
12955
- destructive: boolean().optional()
12955
+ destructive: boolean().optional(),
12956
+ /**
12957
+ * How the tap should REACH the url.
12958
+ *
12959
+ * `navigate` (absent, and every button authored before this field) opens it:
12960
+ * the phone leaves the notification and shows whatever the callback returns.
12961
+ * That is right for a button whose answer the operator wants to read.
12962
+ *
12963
+ * `background` fires it as a POST and stays put. It exists for the buttons
12964
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12965
+ * an answer to the notification, and being thrown into a browser tab to
12966
+ * confirm it costs more attention than the notification did. A backend that
12967
+ * cannot do a background call renders it as an ordinary link (the adapters
12968
+ * fall back rather than dropping the button), so this is a preference, never
12969
+ * a requirement.
12970
+ */
12971
+ mode: _enum(["navigate", "background"]).optional()
12956
12972
  });
12957
12973
  /**
12958
12974
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13953,6 +13969,9 @@ var NcSystemEventConditionSchema = object({
13953
13969
  nodeIds: array(string().min(1)).min(1).optional(),
13954
13970
  packageNames: array(string().min(1)).min(1).optional()
13955
13971
  });
13972
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
13973
+ * outage the operator asked for once and forgot. */
13974
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13956
13975
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13957
13976
  var NcScheduleSchema = object({
13958
13977
  windows: array(object({
@@ -14329,15 +14348,15 @@ var NcConditionsSchema = object({
14329
14348
  * (an `immediate` rule naming an `audio-*` class, one notification per
14330
14349
  * classified sample) stays exactly as it was for rules that already use it.
14331
14350
  *
14332
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14333
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14334
- * (`camstack/src/data/notification-center.ts`, guarded by
14335
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14351
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14352
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14353
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14354
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14336
14355
  * condition fields it does not know when a rule is saved from the phone.
14337
14356
  * Publishing an editor for a condition the app cannot round-trip is how an
14338
- * operator loses a rule's conditions by opening it — so the descriptor, the
14339
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14340
- * does an audio rule become authorable.
14357
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14358
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14359
+ * follows here.
14341
14360
  */
14342
14361
  audio: NcAudioConditionSchema.optional()
14343
14362
  });
@@ -14573,6 +14592,30 @@ var NcRuleInputSchema = object({
14573
14592
  */
14574
14593
  snoozeAllowGlobal: boolean().optional(),
14575
14594
  /**
14595
+ * The snooze durations THIS rule's notification offers as buttons, in
14596
+ * minutes.
14597
+ *
14598
+ * Three states, and all three are distinct — which is exactly why this is
14599
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14600
+ * addon cap path (three production failures in one day), so a schema default
14601
+ * would collapse the first two:
14602
+ *
14603
+ * | value | meaning |
14604
+ * | --- | --- |
14605
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14606
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14607
+ * | a list | these choices, de-duplicated and sorted, at most four |
14608
+ *
14609
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14610
+ * three buttons in total) and a rule that spent it all on snooze choices
14611
+ * would push its own tap-through actions off the notification.
14612
+ *
14613
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14614
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14615
+ * window from anywhere (D133).
14616
+ */
14617
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14618
+ /**
14576
14619
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14577
14620
  *
14578
14621
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14672,6 +14715,7 @@ var NcConditionDescriptorSchema = object({
14672
14715
  "device",
14673
14716
  "package",
14674
14717
  "occupancy",
14718
+ "audio",
14675
14719
  "system"
14676
14720
  ]),
14677
14721
  label: string(),
@@ -14690,6 +14734,7 @@ var NcConditionDescriptorSchema = object({
14690
14734
  "crossingSelect",
14691
14735
  "polygonDraw",
14692
14736
  "occupancy",
14737
+ "audio",
14693
14738
  "deviceState",
14694
14739
  "systemEvent"
14695
14740
  ]),
@@ -14841,7 +14886,20 @@ var NcSnoozeInputSchema = object({
14841
14886
  ruleId: string().optional(),
14842
14887
  /** Required when `scope: 'device'`. */
14843
14888
  deviceId: number().int().optional(),
14844
- durationMinutes: number().int().min(1).max(1440),
14889
+ /**
14890
+ * Narrow the window to these subject classes — "the cat, not the person".
14891
+ *
14892
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14893
+ * what every window authored before this field meant, so no persisted row
14894
+ * changes meaning and no client has to learn anything to keep working.
14895
+ *
14896
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14897
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14898
+ * not at whichever of their four rules happened to produce the notification
14899
+ * they are dismissing.
14900
+ */
14901
+ classes: array(string().min(1)).min(1).optional(),
14902
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14845
14903
  /**
14846
14904
  * Silence this for EVERY recipient, not just the caller. Permission is
14847
14905
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14866,6 +14924,10 @@ var NcSnoozeSchema = object({
14866
14924
  scope: NcSnoozeScopeSchema,
14867
14925
  ruleId: string().optional(),
14868
14926
  deviceId: number().int().optional(),
14927
+ /** Subject classes this window covers. ABSENT = every class — see
14928
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14929
+ * no SQLite column: nothing queries a window by class. */
14930
+ classes: array(string().min(1)).min(1).optional(),
14869
14931
  startedAt: number(),
14870
14932
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14871
14933
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -23613,13 +23675,24 @@ method(object({
23613
23675
  /** Playback-speed multiplier for the render (1 = realtime). */
23614
23676
  var ExportSpeedSchema = number().min(.25).max(32);
23615
23677
  /**
23616
- * One dense interval, in SECONDS FROM THE EXPORT'S OWN `fromMs`.
23678
+ * One dense interval, in WALL-CLOCK SECONDS FROM THE EXPORT'S OWN `fromMs`.
23679
+ *
23680
+ * **Wall clock, not ffmpeg's `t`** — and the recorder translates. A caller
23681
+ * derives these bounds from things that happened at a TIME (a track's
23682
+ * `firstSeen`), while `t` runs over the source playlist: the concatenation of
23683
+ * every segment present for the range, with each recording GAP removed. The
23684
+ * two agree only on a window that recorded without one interruption, and only
23685
+ * the render side knows the segments, so the translation lives there
23686
+ * (`export-dense-map.ts`, addon-pipeline).
23687
+ *
23688
+ * It was not always so. These seconds were fed to `between(t,…)` verbatim, and
23689
+ * on a 10 h window holding 29,393 s of footage every range landed late by the
23690
+ * gap accumulated before it — up to 6,607 s, well past EOF. Nothing matched,
23691
+ * the video was a uniform timelapse, and the log line reported the five ranges
23692
+ * that had been ASKED for (2026-08-13, export `57d14363`, camera 615).
23617
23693
  *
23618
- * Relative and not absolute epoch on purpose: the renderer's frame-select
23619
- * expression sees ffmpeg's `t`, which starts at 0 for the export's source
23620
- * playlist. Handing it absolute epochs would make every call site responsible
23621
- * for the same subtraction, and the one that forgot would emit a filter that
23622
- * selects nothing — silently, as a uniform timelapse.
23694
+ * Relative and not absolute epoch, because an absolute epoch would make every
23695
+ * call site responsible for the same subtraction.
23623
23696
  */
23624
23697
  var ExportDenseRangeSchema = object({
23625
23698
  fromSec: number().nonnegative(),
@@ -30472,6 +30545,7 @@ Object.freeze({
30472
30545
  "network-access": "ingress",
30473
30546
  "smtp-provider": "email"
30474
30547
  });
30548
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30475
30549
  new Set(["devices", "classes"]);
30476
30550
  /**
30477
30551
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -30749,25 +30823,32 @@ object({
30749
30823
  var NativeLeaseAdmissionSchema = _enum(["all", "inferred"]);
30750
30824
  object({
30751
30825
  /**
30752
- * How long a retained native frame is served before it counts as a miss.
30826
+ * How many delivered frames the worker HOLDS at once, waiting for each one's
30827
+ * detection result.
30753
30828
  *
30754
- * Must cover the FULL late-crop horizon: detection inference + the
30755
- * cross-process inference-result hop to hub post-analysis + tracking + the
30756
- * tRPC crop round-trip back. Below ~500 ms the busiest cameras' subject crops
30757
- * outrun it and fall back to the ≤640 detection frame; above ~3 s the resident
30758
- * RAM per busy camera grows linearly with no measured hit-rate gain.
30829
+ * This replaced a TTL on 2026-08-13, and the replacement is the whole point:
30830
+ * a time window was never related to the event the pixels were waiting for.
30831
+ * A held frame now lives from delivery until the runner has its `FrameResult`
30832
+ * at which moment the runner cuts the subject tiles it actually wanted and
30833
+ * releases the frame. The bound exists only so a runner that stops answering
30834
+ * cannot pin RAM: above it the OLDEST held frame is dropped and counted.
30835
+ *
30836
+ * Sizing: the steady state is `inferenceLatency × deliveredFps`, measured at
30837
+ * 40-160 ms × ≤25 fps = 1-4 frames. The default leaves headroom for a hiccup
30838
+ * without ever approaching the old resident set (43 frames × 24.9 MB at 4K).
30839
+ * Raising it does not buy hit rate — it buys tolerance for a slow runner, and
30840
+ * `holdOverflow` on the metrics line is what says you need it.
30759
30841
  */
30760
- ttlMs: number().int().min(250).max(1e4),
30842
+ holdFrames: number().int().min(1).max(64),
30761
30843
  /**
30762
30844
  * Hard per-decode-worker RAM ceiling for retained native frames, in MB.
30763
30845
  *
30764
- * Intended as a SAFETY ceiling with the TTL as the effective cap — but check
30765
- * which one is actually binding before reasoning from that. At the shipped
30766
- * 1024 MB and a 2 800 ms TTL, a 4K camera hits the CEILING first (~43 frames
30767
- * at ~24 MB each) and the TTL never gets to expire anything; `leaseMb` /
30768
- * `leaseFrames` on the metrics line say which. When the ceiling binds, a
30769
- * change that admits fewer frames buys retention WINDOW at constant RAM
30770
- * rather than giving RAM back — lower this knob if RAM is what you wanted.
30846
+ * Since 2026-08-13 this is a SAFETY ceiling and nothing else: `holdFrames`
30847
+ * is what decides how much is held, and the ceiling is the number above which
30848
+ * something is wrong. Before that it was the effective cap at 1024 MB with
30849
+ * a 2 800 ms TTL a 4K camera sat pinned at `leaseMb:1020, leaseFrames:43`
30850
+ * with the TTL expiring nothing, which is exactly the confusion the hold
30851
+ * removes. `leaseMb` / `leaseFrames` still say what is resident.
30771
30852
  * `0` DISABLES the lease entirely and falls the worker back to the tiny
30772
30853
  * leak-prone GPU surface ring (~85% crop miss; that is what the lease exists
30773
30854
  * to replace).
@@ -30793,22 +30874,45 @@ object({
30793
30874
  * there is the signal that some caller names frames outside the inference set
30794
30875
  * and that this must go back to `all`.
30795
30876
  */
30796
- admission: NativeLeaseAdmissionSchema
30877
+ admission: NativeLeaseAdmissionSchema,
30878
+ /**
30879
+ * RAM ceiling per decode worker, in MB, for the SUBJECT TILES — the
30880
+ * compressed native crops the worker cuts at the moment a frame's detection
30881
+ * result arrives, and keeps long after the frame itself is freed.
30882
+ *
30883
+ * This is the knob that replaced the old retention window, and it buys about
30884
+ * three orders of magnitude more of it: a tile is one subject at native
30885
+ * resolution, JPEG-encoded (~60-120 KB on a 4K person), against ~24.9 MB for
30886
+ * the frame it was cut from. A frame on which nothing was detected costs
30887
+ * nothing at all, which is the real change — the old lease paid per FRAME and
30888
+ * was interrogated per SUBJECT.
30889
+ *
30890
+ * `0` DISABLES tiles, leaving only the hold window and the ≤640 RAM
30891
+ * fallback — i.e. the pre-2026-08-13 miss profile. Set it there only to
30892
+ * reproduce that.
30893
+ */
30894
+ tileBudgetMb: number().int().min(0).max(1024)
30797
30895
  });
30798
30896
  /**
30799
- * The values in force when the operator has set nothing — byte-for-byte the
30800
- * constants the decode worker shipped with as env-var defaults, so making these
30801
- * settings changed no behaviour on the day it landed.
30897
+ * The values in force when the operator has set nothing.
30898
+ *
30899
+ * `budgetMb` stays at 1024 on the day the hold landed, deliberately: it stopped
30900
+ * being the retention window and became the OOM ceiling, and lowering a ceiling
30901
+ * in the same change that redefines it would make a regression and a retune
30902
+ * indistinguishable. Cut it once `tileHits` / `holdOverflow` have been read on
30903
+ * live traffic.
30802
30904
  */
30803
30905
  var DEFAULT_NATIVE_LEASE_SETTINGS = {
30804
- ttlMs: 1200,
30906
+ holdFrames: 8,
30805
30907
  budgetMb: 1024,
30806
30908
  activityMs: 15e3,
30909
+ tileBudgetMb: 64,
30807
30910
  admission: "inferred"
30808
30911
  };
30809
- DEFAULT_NATIVE_LEASE_SETTINGS.ttlMs;
30912
+ DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
30810
30913
  DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
30811
30914
  DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
30915
+ DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
30812
30916
  DEFAULT_NATIVE_LEASE_SETTINGS.admission;
30813
30917
  //#endregion
30814
30918
  //#region src/shared.ts
@@ -12975,7 +12975,23 @@ var NotificationActionSchema = object({
12975
12975
  * else — see `notification-center/action-token.ts` for what that does and
12976
12976
  * does not buy.
12977
12977
  */
12978
- destructive: boolean().optional()
12978
+ destructive: boolean().optional(),
12979
+ /**
12980
+ * How the tap should REACH the url.
12981
+ *
12982
+ * `navigate` (absent, and every button authored before this field) opens it:
12983
+ * the phone leaves the notification and shows whatever the callback returns.
12984
+ * That is right for a button whose answer the operator wants to read.
12985
+ *
12986
+ * `background` fires it as a POST and stays put. It exists for the buttons
12987
+ * whose whole point is not to interrupt — "silence this for 30 minutes" is
12988
+ * an answer to the notification, and being thrown into a browser tab to
12989
+ * confirm it costs more attention than the notification did. A backend that
12990
+ * cannot do a background call renders it as an ordinary link (the adapters
12991
+ * fall back rather than dropping the button), so this is a preference, never
12992
+ * a requirement.
12993
+ */
12994
+ mode: _enum(["navigate", "background"]).optional()
12979
12995
  });
12980
12996
  /**
12981
12997
  * The canonical notification. `body` is the only hard field (Apprise model).
@@ -13976,6 +13992,9 @@ var NcSystemEventConditionSchema = object({
13976
13992
  nodeIds: array(string().min(1)).min(1).optional(),
13977
13993
  packageNames: array(string().min(1)).min(1).optional()
13978
13994
  });
13995
+ /** Hard ceiling on a window (24h). A snooze that could not expire would be an
13996
+ * outage the operator asked for once and forgot. */
13997
+ var NC_SNOOZE_MAX_MINUTES = 1440;
13979
13998
  /** Weekly schedule — OR of windows; absence on the rule = always active. */
13980
13999
  var NcScheduleSchema = object({
13981
14000
  windows: array(object({
@@ -14352,15 +14371,15 @@ var NcConditionsSchema = object({
14352
14371
  * (an `immediate` rule naming an `audio-*` class, one notification per
14353
14372
  * classified sample) stays exactly as it was for rules that already use it.
14354
14373
  *
14355
- * NOT in {@link NC_CONDITION_CATALOG} yet, and that is the sequencing rule
14356
- * rather than an oversight: the viewer mirrors the descriptor enums BY HAND
14357
- * (`camstack/src/data/notification-center.ts`, guarded by
14358
- * `scripts/check-viewer-condition-mirror.ts`) and its rule editor STRIPS the
14374
+ * In {@link NC_CONDITION_CATALOG} since P2, and the ORDER it got there is the
14375
+ * rule rather than an accident: the viewer mirrors the descriptor enums BY
14376
+ * HAND (`camstack/src/data/notification-center.ts`, guarded by
14377
+ * `scripts/check-viewer-condition-mirror.ts`) and its rule editor strips the
14359
14378
  * condition fields it does not know when a rule is saved from the phone.
14360
14379
  * Publishing an editor for a condition the app cannot round-trip is how an
14361
- * operator loses a rule's conditions by opening it — so the descriptor, the
14362
- * admin widget and the viewer mirror land together (P2 + P3), and only then
14363
- * does an audio rule become authorable.
14380
+ * operator loses a rule's conditions by opening it — so the viewer mirror
14381
+ * (P3, shipped) went FIRST, and the descriptor an editor renders from
14382
+ * follows here.
14364
14383
  */
14365
14384
  audio: NcAudioConditionSchema.optional()
14366
14385
  });
@@ -14596,6 +14615,30 @@ var NcRuleInputSchema = object({
14596
14615
  */
14597
14616
  snoozeAllowGlobal: boolean().optional(),
14598
14617
  /**
14618
+ * The snooze durations THIS rule's notification offers as buttons, in
14619
+ * minutes.
14620
+ *
14621
+ * Three states, and all three are distinct — which is exactly why this is
14622
+ * `.optional()` and never `.default()`. A Zod default does not run on the
14623
+ * addon cap path (three production failures in one day), so a schema default
14624
+ * would collapse the first two:
14625
+ *
14626
+ * | value | meaning |
14627
+ * | --- | --- |
14628
+ * | absent | the operator never said ⇒ {@link NC_DEFAULT_SNOOZE_MINUTES} |
14629
+ * | `[]` | **no snooze buttons on this rule** — the explicit override |
14630
+ * | a list | these choices, de-duplicated and sorted, at most four |
14631
+ *
14632
+ * `.max(4)` because the notifier's own action budget is small (ntfy allows
14633
+ * three buttons in total) and a rule that spent it all on snooze choices
14634
+ * would push its own tap-through actions off the notification.
14635
+ *
14636
+ * An empty list is NOT an alarm exemption: a rule the alarm is about, or
14637
+ * that arms the panel, is exempt automatically and cannot be silenced by a
14638
+ * window from anywhere (D133).
14639
+ */
14640
+ snoozeOptions: array(number().int().min(1).max(NC_SNOOZE_MAX_MINUTES)).max(4).optional(),
14641
+ /**
14599
14642
  * Devices this rule ACTUATES — arm the alarm, open a gate, turn on a light.
14600
14643
  *
14601
14644
  * This is what makes the rule set the alarm's trigger set without the alarm
@@ -14695,6 +14738,7 @@ var NcConditionDescriptorSchema = object({
14695
14738
  "device",
14696
14739
  "package",
14697
14740
  "occupancy",
14741
+ "audio",
14698
14742
  "system"
14699
14743
  ]),
14700
14744
  label: string(),
@@ -14713,6 +14757,7 @@ var NcConditionDescriptorSchema = object({
14713
14757
  "crossingSelect",
14714
14758
  "polygonDraw",
14715
14759
  "occupancy",
14760
+ "audio",
14716
14761
  "deviceState",
14717
14762
  "systemEvent"
14718
14763
  ]),
@@ -14864,7 +14909,20 @@ var NcSnoozeInputSchema = object({
14864
14909
  ruleId: string().optional(),
14865
14910
  /** Required when `scope: 'device'`. */
14866
14911
  deviceId: number().int().optional(),
14867
- durationMinutes: number().int().min(1).max(1440),
14912
+ /**
14913
+ * Narrow the window to these subject classes — "the cat, not the person".
14914
+ *
14915
+ * ORTHOGONAL to `scope`, deliberately, and absent means EVERY class: that is
14916
+ * what every window authored before this field meant, so no persisted row
14917
+ * changes meaning and no client has to learn anything to keep working.
14918
+ *
14919
+ * It is what makes the window's real key `(deviceId, classes[])` and lets it
14920
+ * cross rules (D133): the operator points at a camera and a kind of thing,
14921
+ * not at whichever of their four rules happened to produce the notification
14922
+ * they are dismissing.
14923
+ */
14924
+ classes: array(string().min(1)).min(1).optional(),
14925
+ durationMinutes: number().int().min(1).max(NC_SNOOZE_MAX_MINUTES),
14868
14926
  /**
14869
14927
  * Silence this for EVERY recipient, not just the caller. Permission is
14870
14928
  * checked server-side (the rule's `snoozeAllowGlobal`, or admin for the
@@ -14889,6 +14947,10 @@ var NcSnoozeSchema = object({
14889
14947
  scope: NcSnoozeScopeSchema,
14890
14948
  ruleId: string().optional(),
14891
14949
  deviceId: number().int().optional(),
14950
+ /** Subject classes this window covers. ABSENT = every class — see
14951
+ * {@link NcSnoozeInputSchema.shape.classes}. Lives in the JSON blob and has
14952
+ * no SQLite column: nothing queries a window by class. */
14953
+ classes: array(string().min(1)).min(1).optional(),
14892
14954
  startedAt: number(),
14893
14955
  /** Exclusive: at exactly this instant the snooze is over. Expiry is a
14894
14956
  * COMPARISON, not a job — no sweeper can leave the operator silenced. */
@@ -23636,13 +23698,24 @@ method(object({
23636
23698
  /** Playback-speed multiplier for the render (1 = realtime). */
23637
23699
  var ExportSpeedSchema = number().min(.25).max(32);
23638
23700
  /**
23639
- * One dense interval, in SECONDS FROM THE EXPORT'S OWN `fromMs`.
23701
+ * One dense interval, in WALL-CLOCK SECONDS FROM THE EXPORT'S OWN `fromMs`.
23702
+ *
23703
+ * **Wall clock, not ffmpeg's `t`** — and the recorder translates. A caller
23704
+ * derives these bounds from things that happened at a TIME (a track's
23705
+ * `firstSeen`), while `t` runs over the source playlist: the concatenation of
23706
+ * every segment present for the range, with each recording GAP removed. The
23707
+ * two agree only on a window that recorded without one interruption, and only
23708
+ * the render side knows the segments, so the translation lives there
23709
+ * (`export-dense-map.ts`, addon-pipeline).
23710
+ *
23711
+ * It was not always so. These seconds were fed to `between(t,…)` verbatim, and
23712
+ * on a 10 h window holding 29,393 s of footage every range landed late by the
23713
+ * gap accumulated before it — up to 6,607 s, well past EOF. Nothing matched,
23714
+ * the video was a uniform timelapse, and the log line reported the five ranges
23715
+ * that had been ASKED for (2026-08-13, export `57d14363`, camera 615).
23640
23716
  *
23641
- * Relative and not absolute epoch on purpose: the renderer's frame-select
23642
- * expression sees ffmpeg's `t`, which starts at 0 for the export's source
23643
- * playlist. Handing it absolute epochs would make every call site responsible
23644
- * for the same subtraction, and the one that forgot would emit a filter that
23645
- * selects nothing — silently, as a uniform timelapse.
23717
+ * Relative and not absolute epoch, because an absolute epoch would make every
23718
+ * call site responsible for the same subtraction.
23646
23719
  */
23647
23720
  var ExportDenseRangeSchema = object({
23648
23721
  fromSec: number().nonnegative(),
@@ -30495,6 +30568,7 @@ Object.freeze({
30495
30568
  "network-access": "ingress",
30496
30569
  "smtp-provider": "email"
30497
30570
  });
30571
+ new Map(AUDIO_MACRO_LABELS.flatMap((macro) => macro.icon === void 0 ? [] : [[macro.id, macro.icon]]));
30498
30572
  new Set(["devices", "classes"]);
30499
30573
  /**
30500
30574
  * TimelapseRule — the STANDALONE scheduled timelapse producer's rule model.
@@ -30772,25 +30846,32 @@ object({
30772
30846
  var NativeLeaseAdmissionSchema = _enum(["all", "inferred"]);
30773
30847
  object({
30774
30848
  /**
30775
- * How long a retained native frame is served before it counts as a miss.
30849
+ * How many delivered frames the worker HOLDS at once, waiting for each one's
30850
+ * detection result.
30776
30851
  *
30777
- * Must cover the FULL late-crop horizon: detection inference + the
30778
- * cross-process inference-result hop to hub post-analysis + tracking + the
30779
- * tRPC crop round-trip back. Below ~500 ms the busiest cameras' subject crops
30780
- * outrun it and fall back to the ≤640 detection frame; above ~3 s the resident
30781
- * RAM per busy camera grows linearly with no measured hit-rate gain.
30852
+ * This replaced a TTL on 2026-08-13, and the replacement is the whole point:
30853
+ * a time window was never related to the event the pixels were waiting for.
30854
+ * A held frame now lives from delivery until the runner has its `FrameResult`
30855
+ * at which moment the runner cuts the subject tiles it actually wanted and
30856
+ * releases the frame. The bound exists only so a runner that stops answering
30857
+ * cannot pin RAM: above it the OLDEST held frame is dropped and counted.
30858
+ *
30859
+ * Sizing: the steady state is `inferenceLatency × deliveredFps`, measured at
30860
+ * 40-160 ms × ≤25 fps = 1-4 frames. The default leaves headroom for a hiccup
30861
+ * without ever approaching the old resident set (43 frames × 24.9 MB at 4K).
30862
+ * Raising it does not buy hit rate — it buys tolerance for a slow runner, and
30863
+ * `holdOverflow` on the metrics line is what says you need it.
30782
30864
  */
30783
- ttlMs: number().int().min(250).max(1e4),
30865
+ holdFrames: number().int().min(1).max(64),
30784
30866
  /**
30785
30867
  * Hard per-decode-worker RAM ceiling for retained native frames, in MB.
30786
30868
  *
30787
- * Intended as a SAFETY ceiling with the TTL as the effective cap — but check
30788
- * which one is actually binding before reasoning from that. At the shipped
30789
- * 1024 MB and a 2 800 ms TTL, a 4K camera hits the CEILING first (~43 frames
30790
- * at ~24 MB each) and the TTL never gets to expire anything; `leaseMb` /
30791
- * `leaseFrames` on the metrics line say which. When the ceiling binds, a
30792
- * change that admits fewer frames buys retention WINDOW at constant RAM
30793
- * rather than giving RAM back — lower this knob if RAM is what you wanted.
30869
+ * Since 2026-08-13 this is a SAFETY ceiling and nothing else: `holdFrames`
30870
+ * is what decides how much is held, and the ceiling is the number above which
30871
+ * something is wrong. Before that it was the effective cap at 1024 MB with
30872
+ * a 2 800 ms TTL a 4K camera sat pinned at `leaseMb:1020, leaseFrames:43`
30873
+ * with the TTL expiring nothing, which is exactly the confusion the hold
30874
+ * removes. `leaseMb` / `leaseFrames` still say what is resident.
30794
30875
  * `0` DISABLES the lease entirely and falls the worker back to the tiny
30795
30876
  * leak-prone GPU surface ring (~85% crop miss; that is what the lease exists
30796
30877
  * to replace).
@@ -30816,22 +30897,45 @@ object({
30816
30897
  * there is the signal that some caller names frames outside the inference set
30817
30898
  * and that this must go back to `all`.
30818
30899
  */
30819
- admission: NativeLeaseAdmissionSchema
30900
+ admission: NativeLeaseAdmissionSchema,
30901
+ /**
30902
+ * RAM ceiling per decode worker, in MB, for the SUBJECT TILES — the
30903
+ * compressed native crops the worker cuts at the moment a frame's detection
30904
+ * result arrives, and keeps long after the frame itself is freed.
30905
+ *
30906
+ * This is the knob that replaced the old retention window, and it buys about
30907
+ * three orders of magnitude more of it: a tile is one subject at native
30908
+ * resolution, JPEG-encoded (~60-120 KB on a 4K person), against ~24.9 MB for
30909
+ * the frame it was cut from. A frame on which nothing was detected costs
30910
+ * nothing at all, which is the real change — the old lease paid per FRAME and
30911
+ * was interrogated per SUBJECT.
30912
+ *
30913
+ * `0` DISABLES tiles, leaving only the hold window and the ≤640 RAM
30914
+ * fallback — i.e. the pre-2026-08-13 miss profile. Set it there only to
30915
+ * reproduce that.
30916
+ */
30917
+ tileBudgetMb: number().int().min(0).max(1024)
30820
30918
  });
30821
30919
  /**
30822
- * The values in force when the operator has set nothing — byte-for-byte the
30823
- * constants the decode worker shipped with as env-var defaults, so making these
30824
- * settings changed no behaviour on the day it landed.
30920
+ * The values in force when the operator has set nothing.
30921
+ *
30922
+ * `budgetMb` stays at 1024 on the day the hold landed, deliberately: it stopped
30923
+ * being the retention window and became the OOM ceiling, and lowering a ceiling
30924
+ * in the same change that redefines it would make a regression and a retune
30925
+ * indistinguishable. Cut it once `tileHits` / `holdOverflow` have been read on
30926
+ * live traffic.
30825
30927
  */
30826
30928
  var DEFAULT_NATIVE_LEASE_SETTINGS = {
30827
- ttlMs: 1200,
30929
+ holdFrames: 8,
30828
30930
  budgetMb: 1024,
30829
30931
  activityMs: 15e3,
30932
+ tileBudgetMb: 64,
30830
30933
  admission: "inferred"
30831
30934
  };
30832
- DEFAULT_NATIVE_LEASE_SETTINGS.ttlMs;
30935
+ DEFAULT_NATIVE_LEASE_SETTINGS.holdFrames;
30833
30936
  DEFAULT_NATIVE_LEASE_SETTINGS.budgetMb;
30834
30937
  DEFAULT_NATIVE_LEASE_SETTINGS.activityMs;
30938
+ DEFAULT_NATIVE_LEASE_SETTINGS.tileBudgetMb;
30835
30939
  DEFAULT_NATIVE_LEASE_SETTINGS.admission;
30836
30940
  //#endregion
30837
30941
  //#region src/shared.ts
@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
2
2
  __esModule: { value: true },
3
3
  [Symbol.toStringTag]: { value: "Module" }
4
4
  });
5
- const require_shared = require("./shared-CgYcIB-Z.js");
5
+ const require_shared = require("./shared-yG0yCeMJ.js");
6
6
  let node_stream = require("node:stream");
7
7
  let webdav = require("webdav");
8
8
  //#region src/providers/webdav/webdav-config-schema.ts
@@ -1,4 +1,4 @@
1
- import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-saei9-aP.mjs";
1
+ import { a as safeJoinRemotePath, c as BaseAddon, i as rearmIdleAbort, o as scheduleIdleAbort, r as getRequiredBasePath, s as storageProviderCapability, t as createSessionId } from "./shared-Hjb2o6ip.mjs";
2
2
  import { PassThrough } from "node:stream";
3
3
  import { AuthType, createClient } from "webdav";
4
4
  //#region src/providers/webdav/webdav-config-schema.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-remote-storage",
3
- "version": "1.2.13",
3
+ "version": "1.2.15",
4
4
  "description": "Remote storage providers (SFTP, S3, WebDAV) — unifies remote backends behind the storage-provider cap",
5
5
  "keywords": [
6
6
  "camstack",