camstack 1.1.26 → 1.1.28

package/dist/{chunk-VLAF6UXF.js → chunk-REYL2W37.js}

@@ -14522,7 +14522,7 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 
-// ../types/dist/sleep-Br7r_3fq.mjs
+// ../types/dist/sleep-B3OHhFkL.mjs
 var WELL_KNOWN_TABS = [
   {
     id: "overview",
@@ -15540,6 +15540,13 @@ var RecordingRetentionSchema = external_exports.object({
   maxAgeDays: external_exports.number().min(0).optional(),
   maxSizeGb: external_exports.number().min(0).optional()
 });
+var ScrubThumbnailPresetSchema = external_exports.enum([
+  "minimal",
+  "low",
+  "standard",
+  "high",
+  "max"
+]);
 var RecordingConfigSchema = external_exports.object({
   enabled: external_exports.boolean(),
   /** Authoritative storage mode. Absent on legacy targets → derived once via
@@ -15569,7 +15576,14 @@ var RecordingConfigSchema = external_exports.object({
   * derived into bands once via `migrateConfigToBands`.
   */
   bands: external_exports.array(RecordingBandSchema).optional(),
-  retention: RecordingRetentionSchema.optional()
+  retention: RecordingRetentionSchema.optional(),
+  /**
+  * Per-camera scrub-thumbnail fidelity preset (resolution + JPEG quality for
+  * timeline-scrub sprite previews). Absent = `standard`. Applies to NEW
+  * windows only — existing sheets are immutable, and each window's index
+  * carries its own tile dims so mixed-preset history renders correctly.
+  */
+  scrubThumbnails: ScrubThumbnailPresetSchema.optional()
 });
 var StorageLocationTypeSchema = external_exports.string().regex(/^[a-z][a-zA-Z0-9-]*$/);
 var StorageLocationSchema = external_exports.object({
@@ -18401,7 +18415,10 @@ var doorbellCapability = {
   scope: "device",
   deviceNative: true,
   mode: "singleton",
-  deviceTypes: [DeviceType.Button],
+  kind: "wrapper",
+  defaultActive: false,
+  deviceTypes: [DeviceType.Button, DeviceType.Camera],
+  exposesDeviceSettings: true,
   methods: {},
   events: {
     /**
@@ -23740,6 +23757,13 @@ var ConfigEntrySchema2 = external_exports.object({
   value: external_exports.unknown(),
   description: external_exports.string().optional()
 });
+var DeviceLinkModeSchema = external_exports.enum(["auto", "manual"]);
+var LinkedDeviceSchema = external_exports.object({
+  deviceId: external_exports.number(),
+  name: external_exports.string(),
+  location: external_exports.string().nullable(),
+  features: external_exports.array(external_exports.string())
+});
 var SavedDeviceRowSchema = external_exports.object({
   /** Numeric id reserved at allocateDeviceId time. */
   id: external_exports.number(),
@@ -23842,6 +23866,7 @@ var deviceManagerCapability = {
   name: "device-manager",
   scope: "system",
   mode: "singleton",
+  exposesDeviceSettings: true,
   methods: {
     /** Reserve (or re-resolve) a progressive numeric id for `(addonId, stableId)`.
     *  Idempotent: returns the existing id if one is already persisted for the
@@ -24092,6 +24117,19 @@ var deviceManagerCapability = {
     getDevice: method(external_exports.object({ deviceId: external_exports.number() }), DeviceInfoSchema.nullable()),
     /** List children of a parent device (by parent numeric id). */
     getChildren: method(external_exports.object({ parentDeviceId: external_exports.number() }), external_exports.array(DeviceInfoSchema)),
+    /**
+    * Resolve the devices LINKED to a camera — the single policy authority
+    * both consumers call (viewer devices panel + pipeline-analytics event
+    * kinds/ingest). Device-tree children are ALWAYS included; mode 'auto'
+    * (default) adds every device sharing the camera's non-null `location`,
+    * mode 'manual' adds the persisted manual list instead. Excludes the
+    * camera itself; deduped. Configuration is standard per-device settings
+    * (see the module docblock) — there are no bespoke link mutations.
+    */
+    getLinkedDevices: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.object({
+      mode: DeviceLinkModeSchema,
+      devices: external_exports.array(LinkedDeviceSchema)
+    })),
     /** Get stream sources for a camera device. */
     getStreamSources: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.array(StreamSourceEntrySchema$1)),
     /** Get config entries (key + value + description) for a device. */
@@ -25544,6 +25582,55 @@ var EventKindSchema = external_exports.enum([
   "object",
   "audio"
 ]);
+var TrackZoneFilterSchema = external_exports.discriminatedUnion("kind", [MaskRectShapeSchema, MaskPolygonShapeSchema]);
+var EventKindIconSchema = external_exports.enum([
+  "motion",
+  "audio",
+  "person",
+  "vehicle",
+  "animal",
+  "door",
+  "pir",
+  "smoke",
+  "water",
+  "button",
+  "generic"
+]);
+var EventKindCategorySchema = external_exports.enum([
+  "motion",
+  "audio",
+  "detection",
+  "sensor",
+  "custom"
+]);
+var EventKindDescriptorSchema = external_exports.object({
+  /** Stable kind id (e.g. 'motion', 'person', 'contact'). */
+  kind: external_exports.string(),
+  label: external_exports.string(),
+  /** Hex color for timeline/legend rendering. */
+  color: external_exports.string(),
+  icon: EventKindIconSchema,
+  category: EventKindCategorySchema,
+  /** Which cap + device contributes this kind. For built-ins the camera
+  *  itself; for sensor kinds the LINKED source device. */
+  source: external_exports.object({
+    capName: external_exports.string(),
+    deviceId: external_exports.number()
+  })
+});
+var SensorEventSchema = external_exports.object({
+  id: external_exports.string(),
+  /** The CAMERA the event is attributed to (a sensor linked to N cameras
+  *  yields N rows, one per camera). */
+  deviceId: external_exports.number(),
+  /** The linked sensor device whose state changed. */
+  sourceDeviceId: external_exports.number(),
+  /** Event kind id — matches an `EventKindDescriptor.kind`. */
+  kind: external_exports.string(),
+  /** Snapshot of the sensor cap's runtime-state slice at the change. */
+  value: external_exports.record(external_exports.string(), external_exports.unknown()).nullable(),
+  timestamp: external_exports.number()
+});
 var TrackPositionSchema = external_exports.object({
   x: external_exports.number(),
   y: external_exports.number(),
@@ -25556,6 +25643,13 @@ var TrackSnapshotSchema = external_exports.object({
   /** MediaStore key; resolve via `getTrackMedia({ trackId })`. */
   mediaKey: external_exports.string()
 });
+var TrackEnvelopeSchema = external_exports.object({
+  minX: external_exports.number(),
+  minY: external_exports.number(),
+  maxX: external_exports.number(),
+  maxY: external_exports.number()
+});
+var TrackProjectionSchema = external_exports.enum(["full", "slim"]);
 var TrackAudioLabelSchema = external_exports.object({
   label: external_exports.string(),
   /** Highest classification score observed across the label's episodes. */
@@ -25600,7 +25694,11 @@ var TrackSchema = external_exports.object({
   /** Audio-classification labels heard on the camera during the track's
   *  life (score ≥ device `classificationMinScore`), aggregated per label.
   *  Absent on legacy rows / tracks with no confident audio. */
-  audioLabels: external_exports.array(TrackAudioLabelSchema).readonly().optional()
+  audioLabels: external_exports.array(TrackAudioLabelSchema).readonly().optional(),
+  /** Normalized 0..1 trajectory envelope (see {@link TrackEnvelopeSchema}).
+  *  Populated from the persisted envelope columns on historical reads;
+  *  absent on legacy rows, dims-less tracks and active (in-RAM) tracks. */
+  envelope: TrackEnvelopeSchema.optional()
 });
 var BaseEventFields = {
   id: external_exports.string(),
@@ -25702,11 +25800,13 @@ var MediaFileSchema = external_exports.object({
   sizeBytes: external_exports.number(),
   timestamp: external_exports.number()
 });
+var DEFAULT_EVENT_QUERY_LIMIT = 1e3;
+var MAX_EVENT_QUERY_LIMIT = 5e3;
 var DeviceEventQueryInput = external_exports.object({
   deviceId: external_exports.number(),
   since: external_exports.number().optional(),
   until: external_exports.number().optional(),
-  limit: external_exports.number().int().min(1).max(5e3).default(1e3),
+  limit: external_exports.number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT),
   /** `slim` drops heavy JSON fields (regions/bbox/zones) and carries an
   *  optional `mediaUrl` (populated by B5). `full` (default) keeps today's
   *  exact behaviour. Callers may omit this field — the store defaults to
@@ -25714,6 +25814,27 @@ var DeviceEventQueryInput = external_exports.object({
   projection: external_exports.enum(["full", "slim"]).optional()
 });
 var ObjectEventQueryInput = DeviceEventQueryInput.extend({ classFilter: external_exports.string().optional() });
+var RecentTracksQueryInput = external_exports.object({
+  /** Devices to merge. An empty array yields `{ tracks: [], nextCursor: null }`. */
+  deviceIds: external_exports.array(external_exports.number()),
+  /** Window lower bound on `lastSeen` (inclusive). */
+  since: external_exports.number().optional(),
+  /** Window upper bound on `lastSeen` (inclusive). */
+  until: external_exports.number().optional(),
+  /** Page size. Default 200, max 1000. */
+  limit: external_exports.number().int().min(1).max(1e3).default(200),
+  /** Opaque continuation cursor from a previous page's `nextCursor`.
+  *  Encodes the (lastSeen, trackId) sort position — treat as opaque. */
+  cursor: external_exports.string().optional(),
+  /** See {@link TrackProjectionSchema}. Default `full`. */
+  projection: TrackProjectionSchema.optional()
+});
+var RecentTracksPageSchema = external_exports.object({
+  /** Merged page, ordered by (`lastSeen` DESC, `trackId` DESC). */
+  tracks: external_exports.array(TrackSchema).readonly(),
+  /** Cursor for the next page, or null when this page is the last. */
+  nextCursor: external_exports.string().nullable()
+});
 var KeyEventQueryInput = external_exports.object({
   deviceId: external_exports.number(),
   /** Window lower bound (track firstSeen ≥ since). */
@@ -25810,8 +25931,27 @@ var pipelineAnalyticsCapability = {
       deviceId: external_exports.number(),
       since: external_exports.number().optional(),
       until: external_exports.number().optional(),
-      limit: external_exports.number().optional()
+      limit: external_exports.number().optional(),
+      /** Spatial filter — only tracks whose trajectory intersects the zone
+      *  (normalized 0..1 rect or polygon). SQL-prefiltered on the persisted
+      *  envelope columns, then precisely tested per position. Tracks with
+      *  an unknown envelope (no frame dims at persist time) always match. */
+      zone: TrackZoneFilterSchema.optional(),
+      /** See {@link TrackProjectionSchema}. Default `full` (backward
+      *  compatible — omitting the field keeps today's exact behaviour). */
+      projection: TrackProjectionSchema.optional()
     }), external_exports.array(TrackSchema).readonly()),
+    /**
+    * Batched cluster-wide track listing — ONE call for the events page /
+    * reel first paint instead of a per-camera `listTracks` fan-out. Merges
+    * the persisted completed tracks of every requested device, sorted by
+    * `lastSeen` DESC with a stable (lastSeen, trackId) cursor. Per-device
+    * indexed pages (`idx_tracks_device_lastSeen`) are k-way merged
+    * provider-side; `projection: 'slim'` drops the heavy `positions[]` /
+    * `snapshots[]` JSON (returned as empty arrays). Active in-RAM tracks
+    * are not included (same contract as `listTracks`).
+    */
+    listRecentTracks: method(RecentTracksQueryInput, RecentTracksPageSchema),
     clearTracks: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.void(), {
       kind: "mutation",
       auth: "admin"
@@ -25820,6 +25960,26 @@ var pipelineAnalyticsCapability = {
     getObjectEvents: method(ObjectEventQueryInput, external_exports.array(ObjectEventSchema).readonly()),
     getAudioEvents: method(DeviceEventQueryInput, external_exports.array(AudioEventSchema).readonly()),
     /**
+    * Every event kind the device can produce: built-ins (motion + audio),
+    * detection classes actually observed for the device (from the track
+    * history), and sensor kinds contributed by LINKED devices (resolved via
+    * `device-manager.getLinkedDevices`, mapped through `EVENT_KIND_BY_CAP`).
+    */
+    listEventKinds: method(external_exports.object({ deviceId: external_exports.number() }), external_exports.array(EventKindDescriptorSchema).readonly()),
+    /**
+    * Sensor-event history for a camera: state changes of LINKED sensor
+    * devices, attributed to the camera at ingest time (one row per linked
+    * camera). Mirrors `getAudioEvents` query semantics; `kinds` narrows to
+    * a kind subset.
+    */
+    getSensorEvents: method(external_exports.object({
+      deviceId: external_exports.number(),
+      since: external_exports.number().optional(),
+      until: external_exports.number().optional(),
+      kinds: external_exports.array(external_exports.string()).optional(),
+      limit: external_exports.number().int().min(1).max(MAX_EVENT_QUERY_LIMIT).default(DEFAULT_EVENT_QUERY_LIMIT)
+    }), external_exports.array(SensorEventSchema).readonly()),
+    /**
     * Importance-ranked highlights for a device+window. Queries completed
     * tracks by (deviceId, firstSeen ∈ [since,until]), scores each (or reuses
     * the persisted score), filters by minImportance/classFilter, orders by
@@ -29758,7 +29918,8 @@ var LocateSegmentResultSchema = external_exports.discriminatedUnion("kind", [ext
   bytes: external_exports.number()
 }), external_exports.object({
   kind: external_exports.literal("gap"),
-  nearestEdgeMs: external_exports.number().nullable()
+  nearestEdgeMs: external_exports.number().nullable(),
+  prevEndMs: external_exports.number().nullable().optional()
 })]);
 var ReadSegmentBytesResultSchema = external_exports.object({ data: external_exports.instanceof(Uint8Array) });
 var recordingCapability = {
@@ -31381,6 +31542,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "deviceManager.getLinkedDevices": {
+    capName: "device-manager",
+    capScope: "system",
+    addonId: null,
+    access: "view"
+  },
   "deviceManager.getRoleDisplayDefaults": {
     capName: "device-manager",
     capScope: "system",
@@ -32935,6 +33102,12 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineAnalytics.getSensorEvents": {
+    capName: "pipeline-analytics",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "pipelineAnalytics.getTrack": {
     capName: "pipeline-analytics",
     capScope: "device",
@@ -32947,6 +33120,18 @@ var METHOD_ACCESS_MAP = Object.freeze({
     addonId: null,
     access: "view"
   },
+  "pipelineAnalytics.listEventKinds": {
+    capName: "pipeline-analytics",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
+  "pipelineAnalytics.listRecentTracks": {
+    capName: "pipeline-analytics",
+    capScope: "device",
+    addonId: null,
+    access: "view"
+  },
   "pipelineAnalytics.listTracks": {
     capName: "pipeline-analytics",
     capScope: "device",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runDiscover
-} from "./chunk-VLAF6UXF.js";
+} from "./chunk-REYL2W37.js";
 import "./chunk-K3NQKI34.js";
 
 // src/cli.ts
@@ -1079,7 +1079,7 @@ function isUnknown(_value) {
   return true;
 }
 async function resolveServerInteractive(presetNamespace) {
-  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-BJ6SMXC2.js");
+  const { discoverNodes, resolveHubFromDiscovered, filterHubNodes, DEFAULT_HUB_HTTPS_PORT } = await import("./discover-OTKOLUJJ.js");
   if (presetNamespace) {
     const spinner4 = clack.spinner();
     spinner4.start(`Discovering hub on LAN (namespace "${presetNamespace}")`);

package/dist/{discover-BJ6SMXC2.js → discover-OTKOLUJJ.js}

@@ -5,7 +5,7 @@ import {
   filterHubNodes,
   resolveHubFromDiscovered,
   runDiscover
-} from "./chunk-VLAF6UXF.js";
+} from "./chunk-REYL2W37.js";
 import "./chunk-K3NQKI34.js";
 export {
   DEFAULT_HUB_HTTPS_PORT,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "camstack",
-  "version": "1.1.26",
+  "version": "1.1.28",
   "description": "CLI tool for managing and running CamStack server",
   "keywords": [
     "camstack",