@camstack/types 0.1.41 → 0.1.42

package/dist/interfaces/recording-config-migrate.d.ts

@@ -0,0 +1,13 @@
+import type { RecordingConfig, RecordingBand } from './recording-config.js';
+/**
+ * One-way migration from the legacy recording-config shape to the authoritative
+ * mode-per-band model. Pure (no clock access).
+ *
+ * - If `config.bands` is present, it is authoritative and returned as-is.
+ * - Otherwise the result is derived from the legacy fields: a disabled config or
+ *   `mode: 'off'` yields no bands; every legacy schedule maps to one band whose
+ *   mode is `continuous` when `config.mode === 'continuous'`, else `events`
+ *   (carrying `triggers`/`preBufferSec`/`postBufferSec`).
+ */
+export declare function migrateConfigToBands(config: RecordingConfig): RecordingBand[];
+//# sourceMappingURL=recording-config-migrate.d.ts.map

package/dist/interfaces/recording-config-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-config-migrate.d.ts","sourceRoot":"","sources":["../../src/interfaces/recording-config-migrate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAqB,aAAa,EAAqB,MAAM,uBAAuB,CAAA;AA8BjH;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,EAAE,CAa7E"}

package/dist/interfaces/recording-config.d.ts

@@ -21,6 +21,75 @@ export declare const RecordingModeSchema: z.ZodEnum<{
     onAudioThreshold: "onAudioThreshold";
 }>;
 export type RecordingMode = z.infer<typeof RecordingModeSchema>;
+/**
+ * First-class, authoritative per-camera storage mode — the netta choice the UI
+ * reads directly (never inferred from `rules`):
+ *  - `off`        — not recording.
+ *  - `events`     — record only around triggers (motion / audio threshold),
+ *                   with pre/post-buffer.
+ *  - `continuous` — record 24/7 within the schedule.
+ *
+ * `mode` compiles one-way to the internal `rules[]` consumed by the policy
+ * engine (see `compileRules`); `rules[]` is never authored directly anymore.
+ */
+export declare const RecordingStorageModeSchema: z.ZodEnum<{
+    events: "events";
+    off: "off";
+    continuous: "continuous";
+}>;
+export type RecordingStorageMode = z.infer<typeof RecordingStorageModeSchema>;
+/** Which detectors trigger an `events`-mode recording. */
+export declare const RecordingTriggersSchema: z.ZodObject<{
+    motion: z.ZodOptional<z.ZodBoolean>;
+    audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RecordingTriggers = z.infer<typeof RecordingTriggersSchema>;
+/**
+ * Mode of a single recording band — the recorder per-band vocabulary.
+ *
+ * Distinct from `RecordingStorageModeSchema` (which carries `off`): a band is
+ * only ever `continuous` or `events`; "off" is expressed by the absence of a
+ * covering band, not by a band value.
+ */
+export declare const RecordingBandModeSchema: z.ZodEnum<{
+    events: "events";
+    continuous: "continuous";
+}>;
+export type RecordingBandMode = z.infer<typeof RecordingBandModeSchema>;
+/**
+ * Triggers for an `events`-mode band. Identical shape to
+ * `RecordingTriggersSchema` — reuse that schema as the band trigger type so the
+ * two never drift.
+ */
+export declare const RecordingBandTriggersSchema: z.ZodObject<{
+    motion: z.ZodOptional<z.ZodBoolean>;
+    audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RecordingBandTriggers = z.infer<typeof RecordingBandTriggersSchema>;
+/**
+ * A single mode-per-band window — the canonical recorder band shape, the
+ * single source of truth re-used by `addon-pipeline/recorder`.
+ *
+ * `days` lists the weekdays the band covers (empty = every day, matching the
+ * band engine's `applies` rule). `start`/`end` are `HH:MM`; an `end <= start`
+ * span wraps past midnight (handled by the band engine).
+ */
+export declare const RecordingBandSchema: z.ZodObject<{
+    days: z.ZodArray<z.ZodNumber>;
+    start: z.ZodString;
+    end: z.ZodString;
+    mode: z.ZodEnum<{
+        events: "events";
+        continuous: "continuous";
+    }>;
+    triggers: z.ZodOptional<z.ZodObject<{
+        motion: z.ZodOptional<z.ZodBoolean>;
+        audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    preBufferSec: z.ZodOptional<z.ZodNumber>;
+    postBufferSec: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type RecordingBand = z.infer<typeof RecordingBandSchema>;
 export declare const RecordingRuleSchema: z.ZodObject<{
     schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
         kind: z.ZodLiteral<"always">;
@@ -54,15 +123,49 @@ export declare const RecordingRetentionSchema: z.ZodObject<{
     maxSizeGb: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type RecordingRetention = z.infer<typeof RecordingRetentionSchema>;
-/** The full per-camera recording intent — the wire shape of a RecordingTarget. */
+/**
+ * The full per-camera recording intent — the wire shape of a RecordingTarget.
+ *
+ * `mode` is the authoritative storage choice; `schedule`/`triggers`/`pre`/`post`
+ * are its mode-specific parameters. `rules` is a DEPRECATED authoring input kept
+ * only for transition + migration (`migrateRulesToMode`); the policy engine
+ * consumes the compiled output of `compileRules(config)`, never `rules` directly.
+ */
 export declare const RecordingConfigSchema: z.ZodObject<{
     enabled: z.ZodBoolean;
+    mode: z.ZodOptional<z.ZodEnum<{
+        events: "events";
+        off: "off";
+        continuous: "continuous";
+    }>>;
     profiles: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         high: "high";
         mid: "mid";
         low: "low";
     }>>>;
     segmentSeconds: z.ZodOptional<z.ZodNumber>;
+    schedules: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"always">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"timeOfDay">;
+        start: z.ZodString;
+        end: z.ZodString;
+        days: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>], "kind">>>;
+    schedule: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        kind: z.ZodLiteral<"always">;
+    }, z.core.$strip>, z.ZodObject<{
+        kind: z.ZodLiteral<"timeOfDay">;
+        start: z.ZodString;
+        end: z.ZodString;
+        days: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    }, z.core.$strip>], "kind">>;
+    triggers: z.ZodOptional<z.ZodObject<{
+        motion: z.ZodOptional<z.ZodBoolean>;
+        audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    preBufferSec: z.ZodOptional<z.ZodNumber>;
+    postBufferSec: z.ZodOptional<z.ZodNumber>;
     rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
         schedule: z.ZodDiscriminatedUnion<[z.ZodObject<{
             kind: z.ZodLiteral<"always">;
@@ -82,6 +185,21 @@ export declare const RecordingConfigSchema: z.ZodObject<{
         resetTimeoutOnNewEvent: z.ZodDefault<z.ZodBoolean>;
         thresholdDbfs: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
+    bands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        days: z.ZodArray<z.ZodNumber>;
+        start: z.ZodString;
+        end: z.ZodString;
+        mode: z.ZodEnum<{
+            events: "events";
+            continuous: "continuous";
+        }>;
+        triggers: z.ZodOptional<z.ZodObject<{
+            motion: z.ZodOptional<z.ZodBoolean>;
+            audioThresholdDbfs: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        preBufferSec: z.ZodOptional<z.ZodNumber>;
+        postBufferSec: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
     retention: z.ZodOptional<z.ZodObject<{
         maxAgeDays: z.ZodOptional<z.ZodNumber>;
         maxSizeGb: z.ZodOptional<z.ZodNumber>;

package/dist/interfaces/recording-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recording-config.d.ts","sourceRoot":"","sources":["../../src/interfaces/recording-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,aAAiC,CAAA;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAIrE,eAAO,MAAM,uBAAuB;;;;;;;2BASlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,mBAAmB;;;;EAAyD,CAAA;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAW9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE,kFAAkF;AAClF,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAMhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"recording-config.d.ts","sourceRoot":"","sources":["../../src/interfaces/recording-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,aAAiC,CAAA;AACpE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAIrE,eAAO,MAAM,uBAAuB;;;;;;;2BASlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE,eAAO,MAAM,mBAAmB;;;;EAAyD,CAAA;AACzF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B;;;;EAA0C,CAAA;AACjF,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAA;AAE7E,0DAA0D;AAC1D,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAA;AACF,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB;;;EAAmC,CAAA;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAA;AAEvE;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;iBAA0B,CAAA;AAClE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAA;AAE/E;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;iBAQ9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;iBAW9B,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB;;;iBAGnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/interfaces/storage-location.d.ts

@@ -45,6 +45,7 @@ export declare const StorageLocationSchema: z.ZodObject<{
     displayName: z.ZodString;
     providerId: z.ZodString;
     config: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    nodeId: z.ZodOptional<z.ZodString>;
     isDefault: z.ZodDefault<z.ZodBoolean>;
     isSystem: z.ZodDefault<z.ZodBoolean>;
     createdAt: z.ZodNumber;

package/dist/interfaces/storage-location.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage-location.d.ts","sourceRoot":"","sources":["../../src/interfaces/storage-location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,aAA2C,CAAA;AAEjF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;iBAahC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,iDAGnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}
+{"version":3,"file":"storage-location.d.ts","sourceRoot":"","sources":["../../src/interfaces/storage-location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,yBAAyB,aAA2C,CAAA;AAEjF;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAA;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;iBAqBhC,CAAA;AACF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,iDAGnC,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA"}

package/dist/node.js

@@ -28,7 +28,7 @@ const promises = require("node:stream/promises");
 const node_stream = require("node:stream");
 const node_child_process = require("node:child_process");
 const node_crypto = require("node:crypto");
-const index = require("./index-BSA_TBea.js");
+const index = require("./index-CGMPfVaT.js");
 require("zod");
 function _interopNamespaceDefault(e) {
   const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });

package/dist/node.mjs

@@ -6,7 +6,7 @@ import { pipeline } from "node:stream/promises";
 import { Readable } from "node:stream";
 import { execFileSync } from "node:child_process";
 import { createHash } from "node:crypto";
-import { e as errMsg } from "./index-Bpj3ScIH.mjs";
+import { e as errMsg } from "./index-BxWo3b49.mjs";
 import "zod";
 function getPlatformInfo() {
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",