@camstack/types 0.1.41 → 0.2.0

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,10 +185,24 @@ 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>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type RecordingConfig = z.infer<typeof RecordingConfigSchema>;
-//# sourceMappingURL=recording-config.d.ts.map

package/dist/interfaces/repl.d.ts

@@ -23,4 +23,3 @@ export interface IReplEngine {
     execute(code: string, context: ReplContext): Promise<ReplResult>;
     getCompletions(partial: string, context: ReplContext): Promise<string[]>;
 }
-//# sourceMappingURL=repl.d.ts.map

package/dist/interfaces/restreamer.d.ts

@@ -21,4 +21,3 @@ export interface IRestreamer {
     getExposedResources(deviceId: number): readonly RestreamerExposedResource[];
     proxyWhepOffer?(streamId: string, sdpOffer: string): Promise<string>;
 }
-//# sourceMappingURL=restreamer.d.ts.map

package/dist/interfaces/router.d.ts

@@ -27,4 +27,3 @@ export interface IAddonRouter {
     /** Get the base URL prefix for this addon's routes */
     getBaseUrl(): string;
 }
-//# sourceMappingURL=router.d.ts.map

package/dist/interfaces/rtp-egress.d.ts

@@ -41,4 +41,3 @@ export interface RtpEgress {
     stop(): Promise<void>;
 }
 export type RtpEgressKind = 'webrtc' | 'hap' | 'alexa-rtc' | 'srtp-out';
-//# sourceMappingURL=rtp-egress.d.ts.map

package/dist/interfaces/scoped-token.d.ts

@@ -1,2 +1 @@
 export { type TokenScope, type ScopedToken } from '../schemas/auth-records.js';
-//# sourceMappingURL=scoped-token.d.ts.map

package/dist/interfaces/server-analysis.d.ts

@@ -30,9 +30,9 @@ export interface AnalysisDetection {
     previousZones?: string[];
 }
 export declare const SUB_DETECTION_TYPES: readonly ["face", "plate"];
-export type SubDetectionType = typeof SUB_DETECTION_TYPES[number];
+export type SubDetectionType = (typeof SUB_DETECTION_TYPES)[number];
 export declare const RECOGNITION_TYPES: readonly ["face", "plate", "clip", "custom"];
-export type RecognitionType = typeof RECOGNITION_TYPES[number];
+export type RecognitionType = (typeof RECOGNITION_TYPES)[number];
 export interface AnalysisContext {
     readonly deviceId: string;
     readonly frame: VideoFrame;
@@ -86,4 +86,3 @@ export interface AnalysisEvent {
     readonly description: string;
     readonly data: Readonly<Record<string, unknown>>;
 }
-//# sourceMappingURL=server-analysis.d.ts.map

package/dist/interfaces/server-network.d.ts

@@ -50,4 +50,3 @@ export interface ExposedResourceResponse {
     headers?: Record<string, string>;
     body?: Buffer | string | NodeJS.ReadableStream;
 }
-//# sourceMappingURL=server-network.d.ts.map

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

@@ -31,4 +31,3 @@ export declare const StorageLocationDeclarationSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Inferred TypeScript type for `StorageLocationDeclarationSchema`. */
 export type StorageLocationDeclaration = z.infer<typeof StorageLocationDeclarationSchema>;
-//# sourceMappingURL=storage-location-declaration.d.ts.map

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;
@@ -61,4 +62,3 @@ export type StorageLocation = z.infer<typeof StorageLocationSchema>;
  */
 export declare const StorageLocationRefSchema: z.ZodUnion<readonly [z.ZodString, z.ZodString]>;
 export type StorageLocationRef = z.infer<typeof StorageLocationRefSchema>;
-//# sourceMappingURL=storage-location.d.ts.map

package/dist/interfaces/storage.d.ts

@@ -313,4 +313,3 @@ export interface IStorageLocation {
     structured?: IStructuredStorage;
     files?: IFileStorage;
 }
-//# sourceMappingURL=storage.d.ts.map

package/dist/interfaces/stream-broker.d.ts

@@ -410,5 +410,6 @@ export interface CameraDetectionConfig {
      * default(true) in `resolveDeviceDetectionSettings`.
      */
     readonly onboardMotionDrivesAnalyzer: boolean;
+    readonly occupancyRecheckSec: number;
+    readonly occupancyRecheckFrames: number;
 }
-//# sourceMappingURL=stream-broker.d.ts.map

package/dist/interfaces/streaming.d.ts

@@ -26,4 +26,3 @@ export interface IStreamingEngine {
     listStreams(): StreamInfo[];
     getStreamStatus(streamId: string): StreamStatus | null;
 }
-//# sourceMappingURL=streaming.d.ts.map

package/dist/interfaces/task-handler.d.ts

@@ -43,4 +43,3 @@ export interface ITaskHandler {
     /** Optional cleanup when a running task is cancelled */
     cancel?(): Promise<void>;
 }
-//# sourceMappingURL=task-handler.d.ts.map

package/dist/interfaces/timezones.d.ts

@@ -56,4 +56,3 @@ export interface Timezone {
 export declare const TIMEZONES: readonly Timezone[];
 /** Resolve an IANA id to its `Timezone`, or `undefined` if unknown. */
 export declare function findTimezone(id: string): Timezone | undefined;
-//# sourceMappingURL=timezones.d.ts.map

package/dist/interfaces/webrtc-provider.d.ts

@@ -32,4 +32,3 @@ export interface IWebRtcProvider {
         sessionId: string;
     }): Promise<void>;
 }
-//# sourceMappingURL=webrtc-provider.d.ts.map

package/dist/node.d.ts

@@ -6,4 +6,3 @@ export { FilesystemStorageProvider } from './storage/filesystem-storage-provider
 export { canonicalHash } from './utils/canonical-hash.js';
 export { canonicalDeviceFingerprint, diffExportTargets, resolveExportFingerprint, } from './utils/export-reconciler.js';
 export type { DeviceExportShape, ExportDelta, ExportTargetEntry, } from './utils/export-reconciler.js';
-//# sourceMappingURL=node.d.ts.map