@camstack/addon-post-analysis 0.1.1

package/dist/recording-service-facade-Do1PKlAL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-service-facade-Do1PKlAL.js","sources":["../src/recording/recording-service-facade.ts"],"sourcesContent":["/**\n * RecordingServiceFacade — implements the recording-engine capability\n * contract by delegating to the internal service classes.\n *\n * Introduced in session 6 Sprint D.2 to replace the broken hand-written\n * recording.router.ts which invoked non-existent methods via a generic\n * `call()` dispatcher. Each facade method delegates to the correct\n * internal service: RecordingCoordinator, RecordingDb, PlaylistGenerator,\n * or StorageEstimator.\n *\n * The facade is the capability provider registered via\n * `context.registerProvider('recording-engine', facade)` — the auto-\n * generated cap router dispatches typed tRPC procedures directly to\n * these methods with full Zod input/output validation.\n */\n\nimport type { RecordingCoordinator } from './recording/recording-coordinator.js'\nimport type { RecordingDb } from './recording/recording-db.js'\nimport type { PlaylistGenerator } from './recording/playlist-generator.js'\nimport type { StorageEstimator } from './recording/storage-estimator.js'\nimport type {\n  RecordingPolicy,\n  RecordingSegment,\n  RecordingThumbnail,\n  RecordingStorageConfig,\n  StorageEstimate,\n  DataCategory,\n} from './recording/types.js'\n\ninterface FacadeDeps {\n  readonly coordinator: RecordingCoordinator\n  readonly db: RecordingDb\n  readonly playlistGenerator: PlaylistGenerator\n  readonly storageEstimator: StorageEstimator\n}\n\nexport class RecordingServiceFacade {\n  constructor(private readonly deps: FacadeDeps) {}\n\n  // ── Status ────────────────────────────────────────────────────────\n\n  getStatus(): { activeRecordings: number; totalSegments: number; totalSizeMB: number } {\n    const { db, coordinator } = this.deps\n    const activeRecordings = coordinator.getActiveCount()\n    const { segmentCount: totalSegments, totalBytes } = db.getGlobalStorageUsage()\n    return {\n      activeRecordings,\n      totalSegments,\n      totalSizeMB: Math.round(totalBytes / (1024 * 1024)),\n    }\n  }\n\n  // ── Lifecycle ─────────────────────────────────────────────────────\n\n  async enable(input: {\n    deviceId: number\n    policy: Omit<RecordingPolicy, 'deviceId'>\n    storageOverrides?: readonly Omit<RecordingStorageConfig, 'deviceId'>[]\n    ffmpegOverrides?: Record<string, unknown>\n  }): Promise<void> {\n    await this.deps.coordinator.enableRecording(input.deviceId, {\n      policy: input.policy,\n      storageOverrides: input.storageOverrides,\n      ffmpegOverrides: input.ffmpegOverrides,\n    })\n  }\n\n  async disable(input: { deviceId: number }): Promise<void> {\n    await this.deps.coordinator.disableRecording(input.deviceId)\n  }\n\n  // ── Config ────────────────────────────────────────────────────────\n\n  getConfig(input: { deviceId: number }): RecordingPolicy | null {\n    return this.deps.db.getPolicy(input.deviceId)\n  }\n\n  async updateConfig(input: {\n    deviceId: number\n    policy: Omit<RecordingPolicy, 'deviceId'>\n    ffmpegOverrides?: Record<string, unknown>\n  }): Promise<void> {\n    this.deps.db.upsertPolicy({ ...input.policy, deviceId: input.deviceId })\n    // If the device is actively recording, restart with the new config\n    if (this.deps.coordinator.isRecording(input.deviceId)) {\n      await this.deps.coordinator.disableRecording(input.deviceId)\n      await this.deps.coordinator.enableRecording(input.deviceId, {\n        policy: input.policy,\n        ffmpegOverrides: input.ffmpegOverrides,\n      })\n    }\n  }\n\n  // ── Playback ──────────────────────────────────────────────────────\n\n  getPlaylist(input: {\n    deviceId: number\n    streamId: string\n    startTime: number\n    endTime: number\n    live?: boolean\n  }): string {\n    return this.deps.playlistGenerator.generate(\n      input.deviceId,\n      input.streamId,\n      input.startTime,\n      input.endTime,\n      { live: input.live },\n    )\n  }\n\n  getThumbnail(input: {\n    deviceId: number\n    timestamp: number\n    category?: string\n  }): RecordingThumbnail | null {\n    return this.deps.db.findNearestThumbnail(\n      input.deviceId,\n      input.timestamp,\n      input.category ?? 'scrub',\n    )\n  }\n\n  getSegments(input: {\n    deviceId: number\n    streamId: string\n    startTime: number\n    endTime: number\n  }): readonly RecordingSegment[] {\n    return this.deps.db.querySegments(\n      input.deviceId,\n      input.streamId,\n      input.startTime,\n      input.endTime,\n    )\n  }\n\n  getAvailability(input: {\n    deviceId: number\n    startTime: number\n    endTime: number\n  }): readonly { startTime: number; endTime: number; streams: readonly string[] }[] {\n    return this.deps.db.getAvailability(\n      input.deviceId,\n      input.startTime,\n      input.endTime,\n    )\n  }\n\n  // ── Storage ───────────────────────────────────────────────────────\n\n  estimateStorage(input: {\n    deviceId: number\n    motionInput?: { avgEventsPerDay: number; avgDurationSec: number }\n  }): StorageEstimate {\n    return this.deps.storageEstimator.estimateForDevice(\n      input.deviceId,\n      input.motionInput,\n    )\n  }\n\n  estimateGlobalStorage(): StorageEstimate {\n    return this.deps.storageEstimator.estimateGlobal()\n  }\n\n  getStorageUsage(input: { deviceId: number; streamId: string }): {\n    totalBytes: number\n    segmentCount: number\n  } {\n    return this.deps.db.getStorageUsage(input.deviceId, input.streamId)\n  }\n\n  // ── Policy ────────────────────────────────────────────────────────\n\n  setPolicy(input: {\n    deviceId: number\n    policy: Omit<RecordingPolicy, 'deviceId'>\n  }): void {\n    this.deps.db.upsertPolicy({ ...input.policy, deviceId: input.deviceId })\n  }\n\n  getPolicy(input: { deviceId: number }): RecordingPolicy | null {\n    return this.deps.db.getPolicy(input.deviceId)\n  }\n\n  getPolicyStatus(input: { deviceId: number }): {\n    deviceId: number\n    enabled: boolean\n    mode: RecordingPolicy['mode']\n    activeStreams: number\n  } | null {\n    const policy = this.deps.db.getPolicy(input.deviceId)\n    if (!policy) return null\n    const activeStreams = this.deps.coordinator.isRecording(input.deviceId)\n      ? policy.streams.length\n      : 0\n    return {\n      deviceId: input.deviceId,\n      enabled: policy.enabled,\n      mode: policy.mode,\n      activeStreams,\n    }\n  }\n\n  // ── Retention ─────────────────────────────────────────────────────\n\n  getRetentionConfig(input: {\n    deviceId: number\n    dataCategory: DataCategory\n  }): RecordingStorageConfig | null {\n    return this.deps.db.resolveStorageConfig(input.deviceId, input.dataCategory)\n  }\n\n  updateRetentionConfig(input: RecordingStorageConfig): void {\n    this.deps.db.upsertStorageConfig(input)\n  }\n\n  // ── Motion ────────────────────────────────────────────────────────\n\n  getMotionStats(input: {\n    deviceId: number\n    startTime: number\n    endTime: number\n  }): {\n    totalEvents: number\n    avgDurationSec: number\n    avgEventsPerDay: number\n    dutyCyclePercent: number\n  } {\n    return this.deps.db.getMotionStats(\n      input.deviceId,\n      input.startTime,\n      input.endTime,\n    )\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/storage-estimator-CRpoQc9j.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+class StorageEstimator {
+  constructor(db, networkTracker) {
+    this.db = db;
+    this.networkTracker = networkTracker;
+  }
+  estimateForDevice(deviceId, motionInput) {
+    const policy = this.db.getPolicy(deviceId);
+    if (!policy) return { perStream: {}, thumbnails: { estimatedGb: 0 }, totalEstimatedGb: 0 };
+    const stats = this.networkTracker.getDeviceStats(deviceId);
+    const perStream = {};
+    let totalGb = 0;
+    const motionEstimate = motionInput ? {
+      avgEventsPerDay: motionInput.avgEventsPerDay,
+      avgDurationSec: motionInput.avgDurationSec,
+      dutyCyclePercent: motionInput.avgEventsPerDay * motionInput.avgDurationSec / 86400 * 100
+    } : void 0;
+    for (const sp of policy.streams) {
+      const category = `recording:${sp.streamId}`;
+      const config = this.db.resolveStorageConfig(deviceId, category);
+      const retentionDays = config?.retentionDays ?? null;
+      const retentionGb = config?.retentionGb ?? null;
+      const streamStats = stats?.streams[sp.streamId];
+      const observedBitrate = streamStats?.observedBitrateKbps ?? 0;
+      const bitrateKbps = observedBitrate > 0 ? observedBitrate : streamStats?.nominalBitrateKbps ?? 4e3;
+      let estimatedGb = 0;
+      if (retentionDays !== null) {
+        const retentionSeconds = retentionDays * 86400;
+        estimatedGb = bitrateKbps * retentionSeconds / 8 / 1024 / 1024 / 1024;
+      }
+      if (policy.mode === "motion" && motionEstimate) {
+        estimatedGb = estimatedGb * motionEstimate.dutyCyclePercent / 100;
+      }
+      let estimatedDaysAtCapacity = null;
+      if (retentionGb !== null && estimatedGb > retentionGb) {
+        estimatedDaysAtCapacity = retentionDays !== null ? retentionDays * (retentionGb / estimatedGb) : null;
+        estimatedGb = retentionGb;
+      }
+      perStream[sp.streamId] = { bitrateKbps, retentionDays, retentionGb, estimatedGb, estimatedDaysAtCapacity };
+      totalGb += estimatedGb;
+    }
+    const thumbRetentionDays = policy.streams[0] ? this.db.resolveStorageConfig(deviceId, "thumbnail:scrub")?.retentionDays ?? 7 : 7;
+    const thumbGb = 2 * 24 * thumbRetentionDays / 1024;
+    totalGb += thumbGb;
+    return { perStream, thumbnails: { estimatedGb: thumbGb }, totalEstimatedGb: totalGb, motionEstimate };
+  }
+  /**
+   * Estimate global storage across all devices with active policies.
+   * Sums per-device estimates. No motion weighting — uses continuous mode
+   * for the global view.
+   */
+  estimateGlobal() {
+    const allPolicies = this.db.getEnabledPolicies();
+    let totalGb = 0;
+    const perStream = {};
+    let totalThumbGb = 0;
+    for (const policy of allPolicies) {
+      if (!policy.enabled) continue;
+      const deviceEstimate = this.estimateForDevice(policy.deviceId);
+      totalGb += deviceEstimate.totalEstimatedGb;
+      totalThumbGb += deviceEstimate.thumbnails.estimatedGb;
+      for (const [key, val] of Object.entries(deviceEstimate.perStream)) {
+        const globalKey = `${policy.deviceId}/${key}`;
+        perStream[globalKey] = val;
+      }
+    }
+    return { perStream, thumbnails: { estimatedGb: totalThumbGb }, totalEstimatedGb: totalGb };
+  }
+}
+exports.StorageEstimator = StorageEstimator;
+//# sourceMappingURL=storage-estimator-CRpoQc9j.js.map

package/dist/storage-estimator-CRpoQc9j.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-estimator-CRpoQc9j.js","sources":["../src/recording/recording/storage-estimator.ts"],"sourcesContent":["import type { INetworkQualityTracker } from '@camstack/types'\nimport type { RecordingDb } from './recording-db.js'\nimport type { DataCategory, StorageEstimate, StreamEstimate } from './types.js'\n\ninterface MotionEstimateInput {\n  readonly avgEventsPerDay: number\n  readonly avgDurationSec: number\n}\n\nexport class StorageEstimator {\n  constructor(\n    private readonly db: RecordingDb,\n    private readonly networkTracker: INetworkQualityTracker,\n  ) {}\n\n  estimateForDevice(deviceId: number, motionInput?: MotionEstimateInput): StorageEstimate {\n    const policy = this.db.getPolicy(deviceId)\n    if (!policy) return { perStream: {}, thumbnails: { estimatedGb: 0 }, totalEstimatedGb: 0 }\n\n    const stats = this.networkTracker.getDeviceStats(deviceId)\n    const perStream: Record<string, StreamEstimate> = {}\n    let totalGb = 0\n\n    const motionEstimate = motionInput ? {\n      avgEventsPerDay: motionInput.avgEventsPerDay,\n      avgDurationSec: motionInput.avgDurationSec,\n      dutyCyclePercent: (motionInput.avgEventsPerDay * motionInput.avgDurationSec / 86400) * 100,\n    } : undefined\n\n    for (const sp of policy.streams) {\n      const category = `recording:${sp.streamId}` as DataCategory\n      const config = this.db.resolveStorageConfig(deviceId, category)\n      const retentionDays = config?.retentionDays ?? null\n      const retentionGb = config?.retentionGb ?? null\n\n      const streamStats = stats?.streams[sp.streamId]\n      const observedBitrate = streamStats?.observedBitrateKbps ?? 0\n      const bitrateKbps = observedBitrate > 0\n        ? observedBitrate\n        : (streamStats?.nominalBitrateKbps ?? 4000)\n\n      let estimatedGb = 0\n      if (retentionDays !== null) {\n        const retentionSeconds = retentionDays * 86400\n        estimatedGb = (bitrateKbps * retentionSeconds) / 8 / 1024 / 1024 / 1024\n      }\n\n      if (policy.mode === 'motion' && motionEstimate) {\n        estimatedGb = estimatedGb * motionEstimate.dutyCyclePercent / 100\n      }\n\n      let estimatedDaysAtCapacity: number | null = null\n      if (retentionGb !== null && estimatedGb > retentionGb) {\n        estimatedDaysAtCapacity = retentionDays !== null ? retentionDays * (retentionGb / estimatedGb) : null\n        estimatedGb = retentionGb\n      }\n\n      perStream[sp.streamId] = { bitrateKbps, retentionDays, retentionGb, estimatedGb, estimatedDaysAtCapacity }\n      totalGb += estimatedGb\n    }\n\n    const thumbRetentionDays = policy.streams[0]\n      ? (this.db.resolveStorageConfig(deviceId, 'thumbnail:scrub')?.retentionDays ?? 7)\n      : 7\n    const thumbGb = (2 * 24 * thumbRetentionDays) / 1024\n    totalGb += thumbGb\n\n    return { perStream, thumbnails: { estimatedGb: thumbGb }, totalEstimatedGb: totalGb, motionEstimate }\n  }\n\n  /**\n   * Estimate global storage across all devices with active policies.\n   * Sums per-device estimates. No motion weighting — uses continuous mode\n   * for the global view.\n   */\n  estimateGlobal(): StorageEstimate {\n    const allPolicies = this.db.getEnabledPolicies()\n    let totalGb = 0\n    const perStream: Record<string, StreamEstimate> = {}\n    let totalThumbGb = 0\n\n    for (const policy of allPolicies) {\n      if (!policy.enabled) continue\n      const deviceEstimate = this.estimateForDevice(policy.deviceId)\n      totalGb += deviceEstimate.totalEstimatedGb\n      totalThumbGb += deviceEstimate.thumbnails.estimatedGb\n      for (const [key, val] of Object.entries(deviceEstimate.perStream)) {\n        const globalKey = `${policy.deviceId}/${key}`\n        perStream[globalKey] = val\n      }\n    }\n\n    return { perStream, thumbnails: { estimatedGb: totalThumbGb }, totalEstimatedGb: totalGb }\n  }\n}\n"],"names":[],"mappings":";;AASO,MAAM,iBAAiB;AAAA,EAC5B,YACmB,IACA,gBACjB;AAFiB,SAAA,KAAA;AACA,SAAA,iBAAA;AAAA,EAChB;AAAA,EAEH,kBAAkB,UAAkB,aAAoD;AACtF,UAAM,SAAS,KAAK,GAAG,UAAU,QAAQ;AACzC,QAAI,CAAC,OAAQ,QAAO,EAAE,WAAW,CAAA,GAAI,YAAY,EAAE,aAAa,KAAK,kBAAkB,EAAA;AAEvF,UAAM,QAAQ,KAAK,eAAe,eAAe,QAAQ;AACzD,UAAM,YAA4C,CAAA;AAClD,QAAI,UAAU;AAEd,UAAM,iBAAiB,cAAc;AAAA,MACnC,iBAAiB,YAAY;AAAA,MAC7B,gBAAgB,YAAY;AAAA,MAC5B,kBAAmB,YAAY,kBAAkB,YAAY,iBAAiB,QAAS;AAAA,IAAA,IACrF;AAEJ,eAAW,MAAM,OAAO,SAAS;AAC/B,YAAM,WAAW,aAAa,GAAG,QAAQ;AACzC,YAAM,SAAS,KAAK,GAAG,qBAAqB,UAAU,QAAQ;AAC9D,YAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,YAAM,cAAc,QAAQ,eAAe;AAE3C,YAAM,cAAc,OAAO,QAAQ,GAAG,QAAQ;AAC9C,YAAM,kBAAkB,aAAa,uBAAuB;AAC5D,YAAM,cAAc,kBAAkB,IAClC,kBACC,aAAa,sBAAsB;AAExC,UAAI,cAAc;AAClB,UAAI,kBAAkB,MAAM;AAC1B,cAAM,mBAAmB,gBAAgB;AACzC,sBAAe,cAAc,mBAAoB,IAAI,OAAO,OAAO;AAAA,MACrE;AAEA,UAAI,OAAO,SAAS,YAAY,gBAAgB;AAC9C,sBAAc,cAAc,eAAe,mBAAmB;AAAA,MAChE;AAEA,UAAI,0BAAyC;AAC7C,UAAI,gBAAgB,QAAQ,cAAc,aAAa;AACrD,kCAA0B,kBAAkB,OAAO,iBAAiB,cAAc,eAAe;AACjG,sBAAc;AAAA,MAChB;AAEA,gBAAU,GAAG,QAAQ,IAAI,EAAE,aAAa,eAAe,aAAa,aAAa,wBAAA;AACjF,iBAAW;AAAA,IACb;AAEA,UAAM,qBAAqB,OAAO,QAAQ,CAAC,IACtC,KAAK,GAAG,qBAAqB,UAAU,iBAAiB,GAAG,iBAAiB,IAC7E;AACJ,UAAM,UAAW,IAAI,KAAK,qBAAsB;AAChD,eAAW;AAEX,WAAO,EAAE,WAAW,YAAY,EAAE,aAAa,WAAW,kBAAkB,SAAS,eAAA;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAkC;AAChC,UAAM,cAAc,KAAK,GAAG,mBAAA;AAC5B,QAAI,UAAU;AACd,UAAM,YAA4C,CAAA;AAClD,QAAI,eAAe;AAEnB,eAAW,UAAU,aAAa;AAChC,UAAI,CAAC,OAAO,QAAS;AACrB,YAAM,iBAAiB,KAAK,kBAAkB,OAAO,QAAQ;AAC7D,iBAAW,eAAe;AAC1B,sBAAgB,eAAe,WAAW;AAC1C,iBAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,eAAe,SAAS,GAAG;AACjE,cAAM,YAAY,GAAG,OAAO,QAAQ,IAAI,GAAG;AAC3C,kBAAU,SAAS,IAAI;AAAA,MACzB;AAAA,IACF;AAEA,WAAO,EAAE,WAAW,YAAY,EAAE,aAAa,aAAA,GAAgB,kBAAkB,QAAA;AAAA,EACnF;AACF;;"}

package/dist/storage-estimator-DzD8gWJH.mjs

@@ -0,0 +1,72 @@
+class StorageEstimator {
+  constructor(db, networkTracker) {
+    this.db = db;
+    this.networkTracker = networkTracker;
+  }
+  estimateForDevice(deviceId, motionInput) {
+    const policy = this.db.getPolicy(deviceId);
+    if (!policy) return { perStream: {}, thumbnails: { estimatedGb: 0 }, totalEstimatedGb: 0 };
+    const stats = this.networkTracker.getDeviceStats(deviceId);
+    const perStream = {};
+    let totalGb = 0;
+    const motionEstimate = motionInput ? {
+      avgEventsPerDay: motionInput.avgEventsPerDay,
+      avgDurationSec: motionInput.avgDurationSec,
+      dutyCyclePercent: motionInput.avgEventsPerDay * motionInput.avgDurationSec / 86400 * 100
+    } : void 0;
+    for (const sp of policy.streams) {
+      const category = `recording:${sp.streamId}`;
+      const config = this.db.resolveStorageConfig(deviceId, category);
+      const retentionDays = config?.retentionDays ?? null;
+      const retentionGb = config?.retentionGb ?? null;
+      const streamStats = stats?.streams[sp.streamId];
+      const observedBitrate = streamStats?.observedBitrateKbps ?? 0;
+      const bitrateKbps = observedBitrate > 0 ? observedBitrate : streamStats?.nominalBitrateKbps ?? 4e3;
+      let estimatedGb = 0;
+      if (retentionDays !== null) {
+        const retentionSeconds = retentionDays * 86400;
+        estimatedGb = bitrateKbps * retentionSeconds / 8 / 1024 / 1024 / 1024;
+      }
+      if (policy.mode === "motion" && motionEstimate) {
+        estimatedGb = estimatedGb * motionEstimate.dutyCyclePercent / 100;
+      }
+      let estimatedDaysAtCapacity = null;
+      if (retentionGb !== null && estimatedGb > retentionGb) {
+        estimatedDaysAtCapacity = retentionDays !== null ? retentionDays * (retentionGb / estimatedGb) : null;
+        estimatedGb = retentionGb;
+      }
+      perStream[sp.streamId] = { bitrateKbps, retentionDays, retentionGb, estimatedGb, estimatedDaysAtCapacity };
+      totalGb += estimatedGb;
+    }
+    const thumbRetentionDays = policy.streams[0] ? this.db.resolveStorageConfig(deviceId, "thumbnail:scrub")?.retentionDays ?? 7 : 7;
+    const thumbGb = 2 * 24 * thumbRetentionDays / 1024;
+    totalGb += thumbGb;
+    return { perStream, thumbnails: { estimatedGb: thumbGb }, totalEstimatedGb: totalGb, motionEstimate };
+  }
+  /**
+   * Estimate global storage across all devices with active policies.
+   * Sums per-device estimates. No motion weighting — uses continuous mode
+   * for the global view.
+   */
+  estimateGlobal() {
+    const allPolicies = this.db.getEnabledPolicies();
+    let totalGb = 0;
+    const perStream = {};
+    let totalThumbGb = 0;
+    for (const policy of allPolicies) {
+      if (!policy.enabled) continue;
+      const deviceEstimate = this.estimateForDevice(policy.deviceId);
+      totalGb += deviceEstimate.totalEstimatedGb;
+      totalThumbGb += deviceEstimate.thumbnails.estimatedGb;
+      for (const [key, val] of Object.entries(deviceEstimate.perStream)) {
+        const globalKey = `${policy.deviceId}/${key}`;
+        perStream[globalKey] = val;
+      }
+    }
+    return { perStream, thumbnails: { estimatedGb: totalThumbGb }, totalEstimatedGb: totalGb };
+  }
+}
+export {
+  StorageEstimator
+};
+//# sourceMappingURL=storage-estimator-DzD8gWJH.mjs.map

package/dist/storage-estimator-DzD8gWJH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-estimator-DzD8gWJH.mjs","sources":["../src/recording/recording/storage-estimator.ts"],"sourcesContent":["import type { INetworkQualityTracker } from '@camstack/types'\nimport type { RecordingDb } from './recording-db.js'\nimport type { DataCategory, StorageEstimate, StreamEstimate } from './types.js'\n\ninterface MotionEstimateInput {\n  readonly avgEventsPerDay: number\n  readonly avgDurationSec: number\n}\n\nexport class StorageEstimator {\n  constructor(\n    private readonly db: RecordingDb,\n    private readonly networkTracker: INetworkQualityTracker,\n  ) {}\n\n  estimateForDevice(deviceId: number, motionInput?: MotionEstimateInput): StorageEstimate {\n    const policy = this.db.getPolicy(deviceId)\n    if (!policy) return { perStream: {}, thumbnails: { estimatedGb: 0 }, totalEstimatedGb: 0 }\n\n    const stats = this.networkTracker.getDeviceStats(deviceId)\n    const perStream: Record<string, StreamEstimate> = {}\n    let totalGb = 0\n\n    const motionEstimate = motionInput ? {\n      avgEventsPerDay: motionInput.avgEventsPerDay,\n      avgDurationSec: motionInput.avgDurationSec,\n      dutyCyclePercent: (motionInput.avgEventsPerDay * motionInput.avgDurationSec / 86400) * 100,\n    } : undefined\n\n    for (const sp of policy.streams) {\n      const category = `recording:${sp.streamId}` as DataCategory\n      const config = this.db.resolveStorageConfig(deviceId, category)\n      const retentionDays = config?.retentionDays ?? null\n      const retentionGb = config?.retentionGb ?? null\n\n      const streamStats = stats?.streams[sp.streamId]\n      const observedBitrate = streamStats?.observedBitrateKbps ?? 0\n      const bitrateKbps = observedBitrate > 0\n        ? observedBitrate\n        : (streamStats?.nominalBitrateKbps ?? 4000)\n\n      let estimatedGb = 0\n      if (retentionDays !== null) {\n        const retentionSeconds = retentionDays * 86400\n        estimatedGb = (bitrateKbps * retentionSeconds) / 8 / 1024 / 1024 / 1024\n      }\n\n      if (policy.mode === 'motion' && motionEstimate) {\n        estimatedGb = estimatedGb * motionEstimate.dutyCyclePercent / 100\n      }\n\n      let estimatedDaysAtCapacity: number | null = null\n      if (retentionGb !== null && estimatedGb > retentionGb) {\n        estimatedDaysAtCapacity = retentionDays !== null ? retentionDays * (retentionGb / estimatedGb) : null\n        estimatedGb = retentionGb\n      }\n\n      perStream[sp.streamId] = { bitrateKbps, retentionDays, retentionGb, estimatedGb, estimatedDaysAtCapacity }\n      totalGb += estimatedGb\n    }\n\n    const thumbRetentionDays = policy.streams[0]\n      ? (this.db.resolveStorageConfig(deviceId, 'thumbnail:scrub')?.retentionDays ?? 7)\n      : 7\n    const thumbGb = (2 * 24 * thumbRetentionDays) / 1024\n    totalGb += thumbGb\n\n    return { perStream, thumbnails: { estimatedGb: thumbGb }, totalEstimatedGb: totalGb, motionEstimate }\n  }\n\n  /**\n   * Estimate global storage across all devices with active policies.\n   * Sums per-device estimates. No motion weighting — uses continuous mode\n   * for the global view.\n   */\n  estimateGlobal(): StorageEstimate {\n    const allPolicies = this.db.getEnabledPolicies()\n    let totalGb = 0\n    const perStream: Record<string, StreamEstimate> = {}\n    let totalThumbGb = 0\n\n    for (const policy of allPolicies) {\n      if (!policy.enabled) continue\n      const deviceEstimate = this.estimateForDevice(policy.deviceId)\n      totalGb += deviceEstimate.totalEstimatedGb\n      totalThumbGb += deviceEstimate.thumbnails.estimatedGb\n      for (const [key, val] of Object.entries(deviceEstimate.perStream)) {\n        const globalKey = `${policy.deviceId}/${key}`\n        perStream[globalKey] = val\n      }\n    }\n\n    return { perStream, thumbnails: { estimatedGb: totalThumbGb }, totalEstimatedGb: totalGb }\n  }\n}\n"],"names":[],"mappings":"AASO,MAAM,iBAAiB;AAAA,EAC5B,YACmB,IACA,gBACjB;AAFiB,SAAA,KAAA;AACA,SAAA,iBAAA;AAAA,EAChB;AAAA,EAEH,kBAAkB,UAAkB,aAAoD;AACtF,UAAM,SAAS,KAAK,GAAG,UAAU,QAAQ;AACzC,QAAI,CAAC,OAAQ,QAAO,EAAE,WAAW,CAAA,GAAI,YAAY,EAAE,aAAa,KAAK,kBAAkB,EAAA;AAEvF,UAAM,QAAQ,KAAK,eAAe,eAAe,QAAQ;AACzD,UAAM,YAA4C,CAAA;AAClD,QAAI,UAAU;AAEd,UAAM,iBAAiB,cAAc;AAAA,MACnC,iBAAiB,YAAY;AAAA,MAC7B,gBAAgB,YAAY;AAAA,MAC5B,kBAAmB,YAAY,kBAAkB,YAAY,iBAAiB,QAAS;AAAA,IAAA,IACrF;AAEJ,eAAW,MAAM,OAAO,SAAS;AAC/B,YAAM,WAAW,aAAa,GAAG,QAAQ;AACzC,YAAM,SAAS,KAAK,GAAG,qBAAqB,UAAU,QAAQ;AAC9D,YAAM,gBAAgB,QAAQ,iBAAiB;AAC/C,YAAM,cAAc,QAAQ,eAAe;AAE3C,YAAM,cAAc,OAAO,QAAQ,GAAG,QAAQ;AAC9C,YAAM,kBAAkB,aAAa,uBAAuB;AAC5D,YAAM,cAAc,kBAAkB,IAClC,kBACC,aAAa,sBAAsB;AAExC,UAAI,cAAc;AAClB,UAAI,kBAAkB,MAAM;AAC1B,cAAM,mBAAmB,gBAAgB;AACzC,sBAAe,cAAc,mBAAoB,IAAI,OAAO,OAAO;AAAA,MACrE;AAEA,UAAI,OAAO,SAAS,YAAY,gBAAgB;AAC9C,sBAAc,cAAc,eAAe,mBAAmB;AAAA,MAChE;AAEA,UAAI,0BAAyC;AAC7C,UAAI,gBAAgB,QAAQ,cAAc,aAAa;AACrD,kCAA0B,kBAAkB,OAAO,iBAAiB,cAAc,eAAe;AACjG,sBAAc;AAAA,MAChB;AAEA,gBAAU,GAAG,QAAQ,IAAI,EAAE,aAAa,eAAe,aAAa,aAAa,wBAAA;AACjF,iBAAW;AAAA,IACb;AAEA,UAAM,qBAAqB,OAAO,QAAQ,CAAC,IACtC,KAAK,GAAG,qBAAqB,UAAU,iBAAiB,GAAG,iBAAiB,IAC7E;AACJ,UAAM,UAAW,IAAI,KAAK,qBAAsB;AAChD,eAAW;AAEX,WAAO,EAAE,WAAW,YAAY,EAAE,aAAa,WAAW,kBAAkB,SAAS,eAAA;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAkC;AAChC,UAAM,cAAc,KAAK,GAAG,mBAAA;AAC5B,QAAI,UAAU;AACd,UAAM,YAA4C,CAAA;AAClD,QAAI,eAAe;AAEnB,eAAW,UAAU,aAAa;AAChC,UAAI,CAAC,OAAO,QAAS;AACrB,YAAM,iBAAiB,KAAK,kBAAkB,OAAO,QAAQ;AAC7D,iBAAW,eAAe;AAC1B,sBAAgB,eAAe,WAAW;AAC1C,iBAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,eAAe,SAAS,GAAG;AACjE,cAAM,YAAY,GAAG,OAAO,QAAQ,IAAI,GAAG;AAC3C,kBAAU,SAAS,IAAI;AAAA,MACzB;AAAA,IACF;AAEA,WAAO,EAAE,WAAW,YAAY,EAAE,aAAa,aAAA,GAAgB,kBAAkB,QAAA;AAAA,EACnF;AACF;"}

package/package.json

@@ -0,0 +1,148 @@
+{
+  "name": "@camstack/addon-post-analysis",
+  "version": "0.1.1",
+  "description": "CamStack Post-Analysis bundle — recording, enrichment, embedding-encoder, pipeline-analytics. Multi-entry npm package shipping 4 addons that consume pipeline output.",
+  "keywords": [
+    "camstack",
+    "addon",
+    "camstack-addon",
+    "post-analysis",
+    "recording",
+    "enrichment",
+    "embedding",
+    "analytics"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/camstack/server"
+  },
+  "main": "./dist/recording/index.js",
+  "exports": {
+    "./recording": {
+      "import": "./dist/recording/index.mjs",
+      "require": "./dist/recording/index.js"
+    },
+    "./enrichment-engine": {
+      "import": "./dist/enrichment-engine/index.mjs",
+      "require": "./dist/enrichment-engine/index.js"
+    },
+    "./embedding-encoder": {
+      "import": "./dist/embedding-encoder/index.mjs",
+      "require": "./dist/embedding-encoder/index.js"
+    },
+    "./pipeline-analytics": {
+      "import": "./dist/pipeline-analytics/index.mjs",
+      "require": "./dist/pipeline-analytics/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "camstack": {
+    "displayName": "Post-Analysis",
+    "bundle": {
+      "displayName": "Post-Analysis",
+      "description": "Recording, enrichment, embedding encoder, and pipeline analytics — consumers of pipeline output."
+    },
+    "nativeDependencies": {
+      "better-sqlite3": "^12.8.0",
+      "onnxruntime-node": "^1.24.3",
+      "sharp": "^0.34.0"
+    },
+    "addons": [
+      {
+        "id": "recording",
+        "name": "Recording",
+        "description": "Per-camera detection-triggered recording with per-stream profile + retention. Subscribes to detection events on the post-analysis bus and writes timestamped clips to the recordings StorageLocation.",
+        "entry": "./dist/recording/index.js",
+        "execution": {
+          "placement": "any"
+        },
+        "protected": true,
+        "capabilities": [
+          {
+            "name": "recording-engine"
+          }
+        ]
+      },
+      {
+        "id": "enrichment-engine",
+        "name": "Enrichment Engine",
+        "description": "Post-detection enrichment workers — embedding dispatcher, scene-state, activity summary. Hub-only consumers that build derived metadata from the detection stream.",
+        "entry": "./dist/enrichment-engine/index.js",
+        "execution": {
+          "placement": "any"
+        },
+        "protected": true,
+        "capabilities": []
+      },
+      {
+        "id": "embedding-encoder",
+        "name": "Embedding Encoder",
+        "description": "ONNX-Runtime image-embedding encoder. Produces semantic vectors from detection crops for similarity search + scene-state tracking.",
+        "entry": "./dist/embedding-encoder/index.js",
+        "execution": {
+          "placement": "any"
+        },
+        "protected": true,
+        "capabilities": [
+          {
+            "name": "embedding-encoder"
+          }
+        ]
+      },
+      {
+        "id": "pipeline-analytics",
+        "name": "Pipeline Analytics",
+        "description": "Zone analytics + audio metrics aggregator. Consumes pipeline events to surface per-camera zone counters and audio-level histograms.",
+        "entry": "./dist/pipeline-analytics/index.js",
+        "execution": {
+          "placement": "any"
+        },
+        "protected": true,
+        "capabilities": [
+          {
+            "name": "pipeline-analytics"
+          },
+          {
+            "name": "zone-analytics"
+          },
+          {
+            "name": "audio-metrics"
+          },
+          {
+            "name": "addon-widgets-source"
+          }
+        ]
+      }
+    ]
+  },
+  "scripts": {
+    "build": "vite build && vite build --config vite.widgets.pipeline-analytics.config.ts",
+    "build:server": "vite build",
+    "build:widgets": "vite build --config vite.widgets.pipeline-analytics.config.ts",
+    "dev": "vite build --watch",
+    "typecheck": "tsc --noEmit",
+    "publish": "npm publish --access public"
+  },
+  "peerDependencies": {
+    "@camstack/types": "^0.1.0",
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@camstack/core": "*",
+    "better-sqlite3": "^12.8.0",
+    "onnxruntime-node": "^1.24.3",
+    "sharp": "^0.34.0"
+  },
+  "devDependencies": {
+    "@camstack/types": "*",
+    "@module-federation/vite": "^1.15.2",
+    "@vitejs/plugin-react": "^4.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "~5.9.0"
+  }
+}