@camstack/types 0.1.41 → 0.1.42

package/dist/{index-BSA_TBea.js → index-CGMPfVaT.js}

@@ -395,6 +395,22 @@ const RecordingScheduleSchema = zod.z.discriminatedUnion("kind", [
   })
 ]);
 const RecordingModeSchema = zod.z.enum(["continuous", "onMotion", "onAudioThreshold"]);
+const RecordingStorageModeSchema = zod.z.enum(["off", "events", "continuous"]);
+const RecordingTriggersSchema = zod.z.object({
+  motion: zod.z.boolean().optional(),
+  audioThresholdDbfs: zod.z.number().optional()
+});
+const RecordingBandModeSchema = zod.z.enum(["continuous", "events"]);
+const RecordingBandTriggersSchema = RecordingTriggersSchema;
+const RecordingBandSchema = zod.z.object({
+  days: zod.z.array(RecordingWeekdaySchema),
+  start: zod.z.string().regex(HHMM),
+  end: zod.z.string().regex(HHMM),
+  mode: RecordingBandModeSchema,
+  triggers: RecordingBandTriggersSchema.optional(),
+  preBufferSec: zod.z.number().min(0).optional(),
+  postBufferSec: zod.z.number().min(0).optional()
+});
 const RecordingRuleSchema = zod.z.object({
   schedule: RecordingScheduleSchema,
   mode: RecordingModeSchema,
@@ -413,9 +429,33 @@ const RecordingRetentionSchema = zod.z.object({
 });
 const RecordingConfigSchema = zod.z.object({
   enabled: zod.z.boolean(),
+  /** Authoritative storage mode. Absent on legacy targets → derived once via
+   *  `migrateRulesToMode`, then persisted. */
+  mode: RecordingStorageModeSchema.optional(),
   profiles: zod.z.array(CamProfileSchema).optional(),
   segmentSeconds: zod.z.number().int().positive().optional(),
+  /** Shared recording time-bands for `events` & `continuous` — record only when
+   *  the wall-clock falls inside one of these windows. Omit or empty = always.
+   *  `continuous` compiles to one rule per band; `events` to band × trigger. */
+  schedules: zod.z.array(RecordingScheduleSchema).optional(),
+  /** Legacy single-band predecessor of `schedules`. Read-compat only — it is
+   *  normalized into `schedules` on read and never written going forward. (Not
+   *  tagged `@deprecated`: the normalization paths must read it cast-free.) */
+  schedule: RecordingScheduleSchema.optional(),
+  /** `events`-mode only — which detectors trigger a recording. */
+  triggers: RecordingTriggersSchema.optional(),
+  /** `events`-mode only — seconds retained before / after a trigger. */
+  preBufferSec: zod.z.number().min(0).optional(),
+  postBufferSec: zod.z.number().min(0).optional(),
+  /** DEPRECATED authoring input; retained for migration/transition. */
   rules: zod.z.array(RecordingRuleSchema).optional(),
+  /**
+   * AUTHORITATIVE mode-per-band recording model (recorder). When present it
+   * is the single source of truth; the legacy `mode`/`schedules`/`schedule`/
+   * `triggers`/`rules` fields above are kept for READ-COMPAT only and are
+   * derived into bands once via `migrateConfigToBands`.
+   */
+  bands: zod.z.array(RecordingBandSchema).optional(),
   retention: RecordingRetentionSchema.optional()
 });
 const StorageLocationTypeSchema = zod.z.string().regex(/^[a-z][a-zA-Z0-9-]*$/);
@@ -428,6 +468,14 @@ const StorageLocationSchema = zod.z.object({
   displayName: zod.z.string().min(1),
   providerId: zod.z.string().min(1),
   config: zod.z.record(zod.z.string(), zod.z.unknown()),
+  /**
+   * Cluster node this location physically lives on. REQUIRED for node-local
+   * providers (filesystem — the path exists on one node's disk), null/absent
+   * for node-agnostic providers (S3/SFTP/WebDAV, reachable from any node).
+   * `'hub'` is the hub node. Validated against the provider's `nodeLocal`
+   * flag at upsert time, not here (the schema is provider-agnostic).
+   */
+  nodeId: zod.z.string().optional(),
   isDefault: zod.z.boolean().default(false),
   isSystem: zod.z.boolean().default(false),
   createdAt: zod.z.number(),
@@ -1961,6 +2009,19 @@ const streamBrokerCapability = {
       zod.z.object({ brokerId: zod.z.string() }),
       BrokerStatsSchema
     ),
+    /**
+     * Force a one-shot probe of a single source stream: transiently dial the
+     * broker (a `warmup` consumer), capture a fresh `BrokerStats` snapshot for
+     * the per-stream "Probed" settings field, then release. Wakes a suspended
+     * (incl. battery) stream for a few seconds. `summary` is the rendered
+     * probed-values string; `probed` is false if the stream never reached
+     * `streaming` within the timeout.
+     */
+    probeStream: method(
+      zod.z.object({ brokerId: zod.z.string() }),
+      zod.z.object({ probed: zod.z.boolean(), summary: zod.z.string() }),
+      { kind: "mutation", auth: "admin" }
+    ),
     listClients: method(
       zod.z.object({ brokerId: zod.z.string() }),
       BrokerClientsSchema
@@ -6057,6 +6118,7 @@ const ProviderListEntrySchema = zod.z.discriminatedUnion("shouldSaveDiskSpace",
     providerId: zod.z.string().min(1),
     displayName: zod.z.string().min(1),
     configSchema: zod.z.unknown(),
+    nodeLocal: zod.z.boolean(),
     shouldSaveDiskSpace: zod.z.literal(true),
     minFreePercent: zod.z.number().min(0).max(100)
   }),
@@ -6064,6 +6126,7 @@ const ProviderListEntrySchema = zod.z.discriminatedUnion("shouldSaveDiskSpace",
     providerId: zod.z.string().min(1),
     displayName: zod.z.string().min(1),
     configSchema: zod.z.unknown(),
+    nodeLocal: zod.z.boolean(),
     shouldSaveDiskSpace: zod.z.literal(false),
     minFreePercent: zod.z.literal(null)
   })
@@ -6200,6 +6263,10 @@ const ProviderInfoSchema = zod.z.discriminatedUnion("shouldSaveDiskSpace", [
     providerId: zod.z.string().min(1),
     displayName: zod.z.string().min(1),
     configSchema: zod.z.unknown(),
+    /** True = provider serves a node-local volume (filesystem): its locations
+     *  bind to a single node and need a node + path. False = reachable from any
+     *  node (remote/object store). */
+    nodeLocal: zod.z.boolean(),
     // Provider manages a finite volume → declares a default free-space threshold.
     shouldSaveDiskSpace: zod.z.literal(true),
     minFreePercent: zod.z.number().min(0).max(100)
@@ -6208,6 +6275,10 @@ const ProviderInfoSchema = zod.z.discriminatedUnion("shouldSaveDiskSpace", [
     providerId: zod.z.string().min(1),
     displayName: zod.z.string().min(1),
     configSchema: zod.z.unknown(),
+    /** True = provider serves a node-local volume (filesystem): its locations
+     *  bind to a single node and need a node + path. False = reachable from any
+     *  node (remote/object store). */
+    nodeLocal: zod.z.boolean(),
     // No local free-space concept (remote/object store) → no threshold.
     shouldSaveDiskSpace: zod.z.literal(false),
     minFreePercent: zod.z.literal(null)
@@ -6335,6 +6406,43 @@ const storageEvictableCapability = {
     )
   }
 };
+const DirEntrySchema = zod.z.object({
+  name: zod.z.string(),
+  path: zod.z.string()
+});
+const BrowseResultSchema = zod.z.object({
+  path: zod.z.string(),
+  entries: zod.z.array(DirEntrySchema).readonly(),
+  freeBytes: zod.z.number(),
+  totalBytes: zod.z.number()
+});
+const filesystemBrowseCapability = {
+  name: "filesystem-browse",
+  scope: "system",
+  // `singleton` + node-routing: every node hosts its own provider; the hub
+  // call carries `{nodeId}` and the cap-router routes to that node via
+  // `createRemoteProxy` (same pattern as `platform-probe`). The codegen's
+  // ALL_CAPABILITY_DEFINITIONS map only matches singleton/collection, and
+  // `per-node` is not an actually-wired runtime mode — singleton is correct.
+  mode: "singleton",
+  internal: true,
+  methods: {
+    /** The allowed roots browsing is sandboxed to on this node. */
+    listAllowedRoots: method(zod.z.void(), zod.z.array(zod.z.string()).readonly(), { auth: "admin" }),
+    /** Immediate subdirectories of `path` (must be within an allowed root) + free/total bytes. */
+    browse: method(
+      zod.z.object({ path: zod.z.string() }),
+      BrowseResultSchema,
+      { auth: "admin" }
+    ),
+    /** Create a subdirectory (within an allowed root). Returns its absolute path. */
+    createDir: method(
+      zod.z.object({ path: zod.z.string() }),
+      zod.z.object({ path: zod.z.string() }),
+      { kind: "mutation", auth: "admin" }
+    )
+  }
+};
 const BackupSubDestinationInfoSchema = zod.z.object({
   /**
    * Sub-id within this addon. Convention `default` for single-
@@ -8040,6 +8148,48 @@ const webrtcSessionCapability = {
     )
   }
 };
+const ClipSchema = zod.z.object({
+  /** Opaque, provider-namespaced id. The default provider encodes the time
+   *  window so `getClipPlayback` is self-contained (no event re-query). */
+  id: zod.z.string(),
+  /** Which provider produced it (`analytics` | `native:<vendor>` | …). */
+  source: zod.z.string(),
+  kind: zod.z.enum(["motion", "object", "audio", "native"]),
+  timeRange: zod.z.object({ startMs: zod.z.number(), endMs: zod.z.number() }),
+  /** Thumbnail URL (lazy; e.g. analytics `getEventMedia`). Never inlined. */
+  thumbnail: zod.z.string().optional()
+});
+const ClipPlaybackSchema = zod.z.object({
+  /** HLS master URL through the hub data-plane (Range + token in path). */
+  playbackUrl: zod.z.string(),
+  /** Optional LAN/remote alternates for the same clip. */
+  playbackEndpoints: zod.z.array(zod.z.string()).optional(),
+  token: zod.z.string().optional()
+});
+const videoclipsCapability = {
+  name: "videoclips",
+  scope: "device",
+  mode: "singleton",
+  kind: "wrapper",
+  defaultActive: true,
+  methods: {
+    listClips: method(
+      zod.z.object({
+        deviceId: zod.z.number(),
+        since: zod.z.number(),
+        until: zod.z.number(),
+        limit: zod.z.number().int().positive().optional()
+      }),
+      zod.z.array(ClipSchema).readonly(),
+      { kind: "query", auth: "admin" }
+    ),
+    getClipPlayback: method(
+      zod.z.object({ deviceId: zod.z.number(), clipId: zod.z.string() }),
+      ClipPlaybackSchema,
+      { kind: "query", auth: "admin" }
+    )
+  }
+};
 const CameraPipelineConfigSchema = zod.z.object({
   engine: PipelineEngineChoiceSchema,
   steps: zod.z.array(PipelineStepInputSchema).readonly(),
@@ -10407,7 +10557,7 @@ const eventsCapability = {
 const RecordingStatusSchema = zod.z.object({
   deviceId: zod.z.number(),
   enabled: zod.z.boolean(),
-  activeMode: zod.z.enum(["off", "continuous"]),
+  activeMode: zod.z.enum(["off", "continuous", "events"]),
   nodeId: zod.z.string(),
   storageBytes: zod.z.number()
 });
@@ -12845,6 +12995,8 @@ exports.CarbonMonoxideStatusSchema = CarbonMonoxideStatusSchema;
 exports.ChargingStatus = ChargingStatus;
 exports.ClientNetworkStatsSchema = ClientNetworkStatsSchema;
 exports.ClimateControlStatusSchema = ClimateControlStatusSchema;
+exports.ClipPlaybackSchema = ClipPlaybackSchema;
+exports.ClipSchema = ClipSchema;
 exports.ClusterAddonNodeDeploymentSchema = ClusterAddonNodeDeploymentSchema;
 exports.ClusterAddonStatusEntrySchema = ClusterAddonStatusEntrySchema;
 exports.CollectionColumnSchema = CollectionColumnSchema;
@@ -13040,6 +13192,9 @@ exports.QueryFilterSchema = QueryFilterSchema;
 exports.RawStateResultSchema = RawStateResultSchema;
 exports.ReadChunkInputSchema = ReadChunkInputSchema;
 exports.RecordingAvailabilitySchema = RecordingAvailabilitySchema;
+exports.RecordingBandModeSchema = RecordingBandModeSchema;
+exports.RecordingBandSchema = RecordingBandSchema;
+exports.RecordingBandTriggersSchema = RecordingBandTriggersSchema;
 exports.RecordingConfigSchema = RecordingConfigSchema;
 exports.RecordingDeviceUsageSchema = RecordingDeviceUsageSchema;
 exports.RecordingLocationUsageSchema = RecordingLocationUsageSchema;
@@ -13050,7 +13205,9 @@ exports.RecordingRetentionSchema = RecordingRetentionSchema;
 exports.RecordingRuleSchema = RecordingRuleSchema;
 exports.RecordingScheduleSchema = RecordingScheduleSchema;
 exports.RecordingStatusSchema = RecordingStatusSchema;
+exports.RecordingStorageModeSchema = RecordingStorageModeSchema;
 exports.RecordingStorageUsageSchema = RecordingStorageUsageSchema;
+exports.RecordingTriggersSchema = RecordingTriggersSchema;
 exports.RecordingWeekdaySchema = RecordingWeekdaySchema;
 exports.RegisteredStreamSchema = RegisteredStreamSchema;
 exports.RegistryStatusSchema = RegistryStatusSchema;
@@ -13214,6 +13371,7 @@ exports.expandCapMethods = expandCapMethods;
 exports.extractSourceInfoFromMetadata = extractSourceInfoFromMetadata;
 exports.fanControlCapability = fanControlCapability;
 exports.featureProbeCapability = featureProbeCapability;
+exports.filesystemBrowseCapability = filesystemBrowseCapability;
 exports.floodCapability = floodCapability;
 exports.gasCapability = gasCapability;
 exports.getAudioMacroClassIds = getAudioMacroClassIds;
@@ -13295,6 +13453,7 @@ exports.userPasskeysCapability = userPasskeysCapability;
 exports.vacuumControlCapability = vacuumControlCapability;
 exports.valveCapability = valveCapability;
 exports.vibrationCapability = vibrationCapability;
+exports.videoclipsCapability = videoclipsCapability;
 exports.waterHeaterCapability = waterHeaterCapability;
 exports.weatherCapability = weatherCapability;
 exports.webrtcCapability = webrtcCapability;
@@ -13308,4 +13467,4 @@ exports.wiringProbeResultSchema = wiringProbeResultSchema;
 exports.zoneAnalyticsCapability = zoneAnalyticsCapability;
 exports.zoneRulesCapability = zoneRulesCapability;
 exports.zonesCapability = zonesCapability;
-//# sourceMappingURL=index-BSA_TBea.js.map
+//# sourceMappingURL=index-CGMPfVaT.js.map