@camstack/addon-cloudflare 1.1.26 → 1.1.28

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-H4AVePnn.mjs
1
+ //#region ../types/dist/event-category-D4HJq7Mw.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -151,6 +151,11 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
151
151
  /** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
152
152
  * thumb is a scrub gap the recorder's keyframe backfill covers. */
153
153
  EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
154
+ /** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
155
+ * progress bar the client reconciles via `recordingExport.getExport`. */
156
+ EventCategory["RecordingExportProgress"] = "recording.export.progress";
157
+ EventCategory["RecordingExportCompleted"] = "recording.export.completed";
158
+ EventCategory["RecordingExportFailed"] = "recording.export.failed";
154
159
  EventCategory["DetectionEvent"] = "detection.event";
155
160
  EventCategory["SessionTrackNew"] = "session.track.new";
156
161
  EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -440,6 +445,25 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
440
445
  */
441
446
  EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
442
447
  /**
448
+ * Fired by `addon-post-analysis` when a package-drop is confirmed inside
449
+ * a package zone — a newly-appeared stationary object of a package class
450
+ * that cleared the class / zone / dwell / size gates. Payload:
451
+ * `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
452
+ * entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
453
+ * Telemetry (D8): the durable record is the `package-events` store row;
454
+ * this bus topic drives notifier rules + live UI. See
455
+ * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
456
+ */
457
+ EventCategory["PipelineAnalyticsPackageDelivered"] = "pipeline-analytics.package-delivered";
458
+ /**
459
+ * Fired by `addon-post-analysis` when a previously-delivered package
460
+ * leaves its zone (the stationary entry departed — moved or swept).
461
+ * Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
462
+ * `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
463
+ * Telemetry (D8). See package-zones-design §5.2.
464
+ */
465
+ EventCategory["PipelineAnalyticsPackagePickedUp"] = "pipeline-analytics.package-picked-up";
466
+ /**
443
467
  * Fired by `addon-post-analysis` whenever a gallery face row changes:
444
468
  * `kind:'buffered'` a new detected face was persisted, `'assigned'` /
445
469
  * `'unassigned'` its identity link changed, `'deleted'` the row was
@@ -5178,6 +5202,25 @@ function _instanceof(cls, params = {}) {
5178
5202
  };
5179
5203
  return inst;
5180
5204
  }
5205
+ //#endregion
5206
+ //#region ../../node_modules/zod/v4/classic/compat.js
5207
+ /** @deprecated Use the raw string literal codes instead, e.g. "invalid_type". */
5208
+ var ZodIssueCode = {
5209
+ invalid_type: "invalid_type",
5210
+ too_big: "too_big",
5211
+ too_small: "too_small",
5212
+ invalid_format: "invalid_format",
5213
+ not_multiple_of: "not_multiple_of",
5214
+ unrecognized_keys: "unrecognized_keys",
5215
+ invalid_union: "invalid_union",
5216
+ invalid_key: "invalid_key",
5217
+ invalid_element: "invalid_element",
5218
+ invalid_value: "invalid_value",
5219
+ custom: "custom"
5220
+ };
5221
+ /** @deprecated Do not use. Stub definition, only included for zod-to-json-schema compatibility. */
5222
+ var ZodFirstPartyTypeKind;
5223
+ ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5181
5224
  Object.fromEntries([
5182
5225
  {
5183
5226
  id: "overview",
@@ -7284,6 +7327,62 @@ var RecordingConfigSchema = object({
7284
7327
  scrubThumbnails: ScrubThumbnailPresetSchema.optional()
7285
7328
  });
7286
7329
  /**
7330
+ * Ops-log — the durable, append-only operations audit shared by the
7331
+ * recordings and events management surfaces.
7332
+ *
7333
+ * ONE row shape is reused for both domains so a single "Activity" view can
7334
+ * merge the recorder's DurableState ring (recordings ops-log) and the
7335
+ * pipeline-analytics SQLite collection (events ops-log). Each row records a
7336
+ * management operation, WHY it ran (reason), and its measurable effect
7337
+ * (itemsAffected + bytesReclaimed). Writes are best-effort — a failed log must
7338
+ * never fail the operation it records.
7339
+ */
7340
+ /** Which management domain the operation belongs to. */
7341
+ var OpsLogDomainSchema = _enum(["recording", "events"]);
7342
+ /** The kind of management operation performed. */
7343
+ var OpsLogOpSchema = _enum([
7344
+ "prune",
7345
+ "manual-delete",
7346
+ "rescan",
7347
+ "retention-run"
7348
+ ]);
7349
+ /** Why the operation ran. */
7350
+ var OpsLogReasonSchema = _enum([
7351
+ "retention",
7352
+ "quota",
7353
+ "manual",
7354
+ "operator"
7355
+ ]);
7356
+ /** One audit row, shared verbatim by both domains. */
7357
+ var OpsLogEntrySchema = object({
7358
+ /** Unique row id. */
7359
+ id: string(),
7360
+ /** Epoch ms the operation completed. */
7361
+ at: number(),
7362
+ domain: OpsLogDomainSchema,
7363
+ op: OpsLogOpSchema,
7364
+ reason: OpsLogReasonSchema,
7365
+ /** The camera the op targeted; null for a cluster/global op. */
7366
+ deviceId: number().nullable(),
7367
+ /** Node that performed the op (the log carries nodeId — no cross-node aggregation). */
7368
+ nodeId: string(),
7369
+ /** Buckets / rows deleted (op-specific unit). */
7370
+ itemsAffected: number(),
7371
+ /** Bytes reclaimed by the op (0 when not measurable). */
7372
+ bytesReclaimed: number(),
7373
+ /** Free-text detail (e.g. "floor moved to <ts>"); null when none. */
7374
+ detail: string().nullable(),
7375
+ /** Who/what triggered the op. */
7376
+ actor: string()
7377
+ });
7378
+ /** Shared query input for the per-domain `listOpsLog` cap methods. */
7379
+ var OpsLogQueryInputSchema = object({
7380
+ /** Restrict to a single camera; omit for every row. */
7381
+ deviceId: number().optional(),
7382
+ /** Max rows returned, newest-first. */
7383
+ limit: number().int().min(1).max(1e3).optional()
7384
+ });
7385
+ /**
7287
7386
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
7288
7387
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
7289
7388
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -12533,7 +12632,11 @@ array(ZoneRuleSchema).readonly();
12533
12632
  * Extend the enum here when a new gating consumer comes online (audio
12534
12633
  * gating, alert filtering, …) — no other surface needs to change.
12535
12634
  */
12536
- var ZoneRuleStageEnum = _enum(["motion", "detection"]);
12635
+ var ZoneRuleStageEnum = _enum([
12636
+ "motion",
12637
+ "detection",
12638
+ "package"
12639
+ ]);
12537
12640
  DeviceType.Camera, method(object({
12538
12641
  deviceId: number(),
12539
12642
  stage: ZoneRuleStageEnum
@@ -12546,7 +12649,8 @@ DeviceType.Camera, method(object({
12546
12649
  auth: "admin"
12547
12650
  }), object({
12548
12651
  motion: array(ZoneRuleSchema).readonly(),
12549
- detection: array(ZoneRuleSchema).readonly()
12652
+ detection: array(ZoneRuleSchema).readonly(),
12653
+ package: array(ZoneRuleSchema).readonly()
12550
12654
  });
12551
12655
  var ProviderStatusSchema = object({
12552
12656
  connected: boolean(),
@@ -15767,6 +15871,7 @@ var EventKindIconSchema = _enum([
15767
15871
  "smoke",
15768
15872
  "water",
15769
15873
  "button",
15874
+ "package",
15770
15875
  "generic"
15771
15876
  ]);
15772
15877
  var EventKindCategorySchema = _enum([
@@ -15774,7 +15879,8 @@ var EventKindCategorySchema = _enum([
15774
15879
  "audio",
15775
15880
  "detection",
15776
15881
  "sensor",
15777
- "custom"
15882
+ "custom",
15883
+ "package"
15778
15884
  ]);
15779
15885
  var EventKindDescriptorSchema = object({
15780
15886
  /** Stable kind id (e.g. 'motion', 'person', 'contact'). */
@@ -16115,6 +16221,26 @@ var TrackCascadeCountsSchema = object({
16115
16221
  /** Per-track CLIP search vectors removed (best-effort). */
16116
16222
  embeddings: number().int()
16117
16223
  });
16224
+ /** Event-store footprint for one camera. */
16225
+ var EventStoreDeviceFootprintSchema = object({
16226
+ deviceId: number(),
16227
+ /** Persisted event rows (motion + object + audio) for the camera. */
16228
+ rows: number().int(),
16229
+ /** Event-owned media bytes on disk for the camera. */
16230
+ bytes: number().int()
16231
+ });
16232
+ /** Aggregate event-store footprint: global totals + per-camera breakdown. */
16233
+ var EventStoreFootprintSchema = object({
16234
+ totalRows: number().int(),
16235
+ totalBytes: number().int(),
16236
+ devices: array(EventStoreDeviceFootprintSchema).readonly()
16237
+ });
16238
+ /** Per-kind counts returned by the event-prune / device-delete mutations. */
16239
+ var EventPruneCountsSchema = object({
16240
+ motion: number().int(),
16241
+ object: number().int(),
16242
+ audio: number().int()
16243
+ });
16118
16244
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
16119
16245
  deviceId: number(),
16120
16246
  trackId: string()
@@ -16178,6 +16304,21 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
16178
16304
  }), {
16179
16305
  kind: "mutation",
16180
16306
  auth: "admin"
16307
+ }), method(object({}), EventStoreFootprintSchema, {
16308
+ kind: "query",
16309
+ auth: "admin"
16310
+ }), method(object({
16311
+ olderThanMs: number(),
16312
+ reason: OpsLogReasonSchema.optional()
16313
+ }), EventPruneCountsSchema, {
16314
+ kind: "mutation",
16315
+ auth: "admin"
16316
+ }), method(object({ deviceId: number() }), EventPruneCountsSchema, {
16317
+ kind: "mutation",
16318
+ auth: "admin"
16319
+ }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
16320
+ kind: "query",
16321
+ auth: "admin"
16181
16322
  }), method(object({
16182
16323
  eventId: string(),
16183
16324
  kind: MediaFileKindEnum.optional()
@@ -19434,13 +19575,131 @@ method(object({
19434
19575
  }), method(object({ deviceId: number() }), RecordingStatusSchema, {
19435
19576
  kind: "mutation",
19436
19577
  auth: "admin"
19437
- }), method(object({ deviceId: number() }), object({
19578
+ }), method(object({
19579
+ deviceId: number(),
19580
+ reason: OpsLogReasonSchema.optional()
19581
+ }), object({
19438
19582
  floorMs: number().nullable(),
19439
19583
  deletedBuckets: number().int(),
19440
19584
  reclaimedBytes: number().int()
19441
19585
  }), {
19442
19586
  kind: "mutation",
19443
19587
  auth: "admin"
19588
+ }), method(object({
19589
+ deviceId: number(),
19590
+ fromMs: number().optional(),
19591
+ toMs: number().optional()
19592
+ }), object({
19593
+ deletedBuckets: number().int(),
19594
+ reclaimedBytes: number().int()
19595
+ }), {
19596
+ kind: "mutation",
19597
+ auth: "admin"
19598
+ }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
19599
+ kind: "query",
19600
+ auth: "admin"
19601
+ });
19602
+ /**
19603
+ * `recordingExport` cap — render a footage time range into a single downloadable
19604
+ * MP4 (regular / accelerated / decelerated / timelapse, ± audio), kept for a
19605
+ * bounded lifetime with a durable history, auto-expiry, and optional
19606
+ * delete-after-download.
19607
+ *
19608
+ * Like `recording` this is a `scope:'system', mode:'singleton'` cap: the
19609
+ * recorder self-gates so exactly ONE node (the designated `recordingNodeId`,
19610
+ * default `hub`) registers it. Device-scoped methods carry `deviceId` in their
19611
+ * input and dispatch to that single provider; the render runs on the node that
19612
+ * owns the footage (no cross-node segment transfer). Download rides the
19613
+ * framework addon data-plane. State persists in a DurableState blob (NOT
19614
+ * SQLite); history rows survive file deletion for audit.
19615
+ */
19616
+ /** Playback-speed multiplier for the render (1 = realtime). */
19617
+ var ExportSpeedSchema = number().min(.25).max(32);
19618
+ /** Timelapse cadence — sample one source frame per `everyMs`, output at `outputFps`. */
19619
+ var ExportTimelapseSchema = object({
19620
+ everyMs: number().int().positive(),
19621
+ outputFps: number().int().min(1).max(60).optional()
19622
+ });
19623
+ /**
19624
+ * Render options. `speed` and `timelapse` are mutually exclusive. `includeAudio`
19625
+ * is honoured only for a realtime-ish speed (0.5–2×); timelapse is always
19626
+ * silent. `maxLifeMs` bounds how long the finished file is kept;
19627
+ * `deleteAfterDownload` removes it shortly after the first complete download.
19628
+ */
19629
+ var ExportOptionsSchema = object({
19630
+ speed: ExportSpeedSchema.optional(),
19631
+ timelapse: ExportTimelapseSchema.optional(),
19632
+ includeAudio: boolean(),
19633
+ maxLifeMs: number().int().positive(),
19634
+ deleteAfterDownload: boolean(),
19635
+ title: string().max(200).optional()
19636
+ }).superRefine((v, ctx) => {
19637
+ if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
19638
+ code: ZodIssueCode.custom,
19639
+ message: "speed and timelapse are mutually exclusive",
19640
+ path: ["timelapse"]
19641
+ });
19642
+ });
19643
+ var ExportStateSchema = _enum([
19644
+ "queued",
19645
+ "rendering",
19646
+ "ready",
19647
+ "failed",
19648
+ "expired",
19649
+ "deleted"
19650
+ ]);
19651
+ /** One export job / history row. */
19652
+ var ExportRecordSchema = object({
19653
+ id: string(),
19654
+ deviceId: number(),
19655
+ profile: string(),
19656
+ fromMs: number(),
19657
+ toMs: number(),
19658
+ options: ExportOptionsSchema,
19659
+ state: ExportStateSchema,
19660
+ /** 0–100 while rendering; null otherwise. */
19661
+ progressPct: number().nullable(),
19662
+ /** File size once ready; null before. */
19663
+ fileBytes: number().nullable(),
19664
+ expiresAt: number(),
19665
+ deleteAfterDownload: boolean(),
19666
+ /** Epoch of the first complete download; null until then. */
19667
+ downloadedAt: number().nullable(),
19668
+ createdAt: number(),
19669
+ /** User id/name that requested the export. */
19670
+ createdBy: string(),
19671
+ /** Failure reason when state is 'failed'; null otherwise. */
19672
+ error: string().nullable()
19673
+ });
19674
+ /** Candidate download URLs (LAN first, then operator extra hosts). */
19675
+ var ExportDownloadSchema = object({
19676
+ url: string(),
19677
+ endpoints: array(string())
19678
+ });
19679
+ method(object({
19680
+ deviceId: number(),
19681
+ profile: string(),
19682
+ fromMs: number(),
19683
+ toMs: number(),
19684
+ options: ExportOptionsSchema
19685
+ }), ExportRecordSchema, {
19686
+ kind: "mutation",
19687
+ auth: "protected"
19688
+ }), method(object({ deviceId: number().optional() }), array(ExportRecordSchema), {
19689
+ kind: "query",
19690
+ auth: "protected"
19691
+ }), method(object({ exportId: string() }), ExportRecordSchema, {
19692
+ kind: "query",
19693
+ auth: "protected"
19694
+ }), method(object({ exportId: string() }), ExportRecordSchema, {
19695
+ kind: "mutation",
19696
+ auth: "protected"
19697
+ }), method(object({ exportId: string() }), ExportRecordSchema, {
19698
+ kind: "mutation",
19699
+ auth: "protected"
19700
+ }), method(object({ exportId: string() }), ExportDownloadSchema, {
19701
+ kind: "query",
19702
+ auth: "protected"
19444
19703
  });
19445
19704
  /**
19446
19705
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -22460,6 +22719,12 @@ Object.freeze({
22460
22719
  addonId: null,
22461
22720
  access: "delete"
22462
22721
  },
22722
+ "pipelineAnalytics.deleteDeviceEvents": {
22723
+ capName: "pipeline-analytics",
22724
+ capScope: "device",
22725
+ addonId: null,
22726
+ access: "delete"
22727
+ },
22463
22728
  "pipelineAnalytics.deleteTracks": {
22464
22729
  capName: "pipeline-analytics",
22465
22730
  capScope: "device",
@@ -22490,6 +22755,12 @@ Object.freeze({
22490
22755
  addonId: null,
22491
22756
  access: "view"
22492
22757
  },
22758
+ "pipelineAnalytics.getEventStoreFootprint": {
22759
+ capName: "pipeline-analytics",
22760
+ capScope: "device",
22761
+ addonId: null,
22762
+ access: "view"
22763
+ },
22493
22764
  "pipelineAnalytics.getKeyEvents": {
22494
22765
  capName: "pipeline-analytics",
22495
22766
  capScope: "device",
@@ -22532,6 +22803,12 @@ Object.freeze({
22532
22803
  addonId: null,
22533
22804
  access: "view"
22534
22805
  },
22806
+ "pipelineAnalytics.listOpsLog": {
22807
+ capName: "pipeline-analytics",
22808
+ capScope: "device",
22809
+ addonId: null,
22810
+ access: "view"
22811
+ },
22535
22812
  "pipelineAnalytics.listRecentTracks": {
22536
22813
  capName: "pipeline-analytics",
22537
22814
  capScope: "device",
@@ -22544,6 +22821,12 @@ Object.freeze({
22544
22821
  addonId: null,
22545
22822
  access: "view"
22546
22823
  },
22824
+ "pipelineAnalytics.pruneEvents": {
22825
+ capName: "pipeline-analytics",
22826
+ capScope: "device",
22827
+ addonId: null,
22828
+ access: "create"
22829
+ },
22547
22830
  "pipelineAnalytics.pruneEventsBefore": {
22548
22831
  capName: "pipeline-analytics",
22549
22832
  capScope: "device",
@@ -23306,6 +23589,12 @@ Object.freeze({
23306
23589
  addonId: null,
23307
23590
  access: "create"
23308
23591
  },
23592
+ "recording.deleteFootprint": {
23593
+ capName: "recording",
23594
+ capScope: "system",
23595
+ addonId: null,
23596
+ access: "delete"
23597
+ },
23309
23598
  "recording.getAvailability": {
23310
23599
  capName: "recording",
23311
23600
  capScope: "system",
@@ -23336,6 +23625,12 @@ Object.freeze({
23336
23625
  addonId: null,
23337
23626
  access: "view"
23338
23627
  },
23628
+ "recording.listOpsLog": {
23629
+ capName: "recording",
23630
+ capScope: "system",
23631
+ addonId: null,
23632
+ access: "view"
23633
+ },
23339
23634
  "recording.locateSegment": {
23340
23635
  capName: "recording",
23341
23636
  capScope: "system",
@@ -23366,6 +23661,42 @@ Object.freeze({
23366
23661
  addonId: null,
23367
23662
  access: "create"
23368
23663
  },
23664
+ "recordingExport.cancelExport": {
23665
+ capName: "recordingExport",
23666
+ capScope: "system",
23667
+ addonId: null,
23668
+ access: "create"
23669
+ },
23670
+ "recordingExport.createExport": {
23671
+ capName: "recordingExport",
23672
+ capScope: "system",
23673
+ addonId: null,
23674
+ access: "create"
23675
+ },
23676
+ "recordingExport.deleteExport": {
23677
+ capName: "recordingExport",
23678
+ capScope: "system",
23679
+ addonId: null,
23680
+ access: "delete"
23681
+ },
23682
+ "recordingExport.getDownloadUrl": {
23683
+ capName: "recordingExport",
23684
+ capScope: "system",
23685
+ addonId: null,
23686
+ access: "view"
23687
+ },
23688
+ "recordingExport.getExport": {
23689
+ capName: "recordingExport",
23690
+ capScope: "system",
23691
+ addonId: null,
23692
+ access: "view"
23693
+ },
23694
+ "recordingExport.listExports": {
23695
+ capName: "recordingExport",
23696
+ capScope: "system",
23697
+ addonId: null,
23698
+ access: "view"
23699
+ },
23369
23700
  "sceneMonitor.captureReference": {
23370
23701
  capName: "scene-monitor",
23371
23702
  capScope: "device",
@@ -1,4 +1,4 @@
1
- //#region ../types/dist/event-category-H4AVePnn.mjs
1
+ //#region ../types/dist/event-category-D4HJq7Mw.mjs
2
2
  var EventCategory = /* @__PURE__ */ function(EventCategory) {
3
3
  EventCategory["SystemBoot"] = "system.boot";
4
4
  EventCategory["SystemAddonsReady"] = "system.addons-ready";
@@ -151,6 +151,11 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
151
151
  /** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
152
152
  * thumb is a scrub gap the recorder's keyframe backfill covers. */
153
153
  EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
154
+ /** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
155
+ * progress bar the client reconciles via `recordingExport.getExport`. */
156
+ EventCategory["RecordingExportProgress"] = "recording.export.progress";
157
+ EventCategory["RecordingExportCompleted"] = "recording.export.completed";
158
+ EventCategory["RecordingExportFailed"] = "recording.export.failed";
154
159
  EventCategory["DetectionEvent"] = "detection.event";
155
160
  EventCategory["SessionTrackNew"] = "session.track.new";
156
161
  EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -440,6 +445,25 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
440
445
  */
441
446
  EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
442
447
  /**
448
+ * Fired by `addon-post-analysis` when a package-drop is confirmed inside
449
+ * a package zone — a newly-appeared stationary object of a package class
450
+ * that cleared the class / zone / dwell / size gates. Payload:
451
+ * `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
452
+ * entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
453
+ * Telemetry (D8): the durable record is the `package-events` store row;
454
+ * this bus topic drives notifier rules + live UI. See
455
+ * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
456
+ */
457
+ EventCategory["PipelineAnalyticsPackageDelivered"] = "pipeline-analytics.package-delivered";
458
+ /**
459
+ * Fired by `addon-post-analysis` when a previously-delivered package
460
+ * leaves its zone (the stationary entry departed — moved or swept).
461
+ * Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
462
+ * `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
463
+ * Telemetry (D8). See package-zones-design §5.2.
464
+ */
465
+ EventCategory["PipelineAnalyticsPackagePickedUp"] = "pipeline-analytics.package-picked-up";
466
+ /**
443
467
  * Fired by `addon-post-analysis` whenever a gallery face row changes:
444
468
  * `kind:'buffered'` a new detected face was persisted, `'assigned'` /
445
469
  * `'unassigned'` its identity link changed, `'deleted'` the row was
@@ -5178,6 +5202,25 @@ function _instanceof(cls, params = {}) {
5178
5202
  };
5179
5203
  return inst;
5180
5204
  }
5205
+ //#endregion
5206
+ //#region ../../node_modules/zod/v4/classic/compat.js
5207
+ /** @deprecated Use the raw string literal codes instead, e.g. "invalid_type". */
5208
+ var ZodIssueCode = {
5209
+ invalid_type: "invalid_type",
5210
+ too_big: "too_big",
5211
+ too_small: "too_small",
5212
+ invalid_format: "invalid_format",
5213
+ not_multiple_of: "not_multiple_of",
5214
+ unrecognized_keys: "unrecognized_keys",
5215
+ invalid_union: "invalid_union",
5216
+ invalid_key: "invalid_key",
5217
+ invalid_element: "invalid_element",
5218
+ invalid_value: "invalid_value",
5219
+ custom: "custom"
5220
+ };
5221
+ /** @deprecated Do not use. Stub definition, only included for zod-to-json-schema compatibility. */
5222
+ var ZodFirstPartyTypeKind;
5223
+ ZodFirstPartyTypeKind || (ZodFirstPartyTypeKind = {});
5181
5224
  Object.fromEntries([
5182
5225
  {
5183
5226
  id: "overview",
@@ -7284,6 +7327,62 @@ var RecordingConfigSchema = object({
7284
7327
  scrubThumbnails: ScrubThumbnailPresetSchema.optional()
7285
7328
  });
7286
7329
  /**
7330
+ * Ops-log — the durable, append-only operations audit shared by the
7331
+ * recordings and events management surfaces.
7332
+ *
7333
+ * ONE row shape is reused for both domains so a single "Activity" view can
7334
+ * merge the recorder's DurableState ring (recordings ops-log) and the
7335
+ * pipeline-analytics SQLite collection (events ops-log). Each row records a
7336
+ * management operation, WHY it ran (reason), and its measurable effect
7337
+ * (itemsAffected + bytesReclaimed). Writes are best-effort — a failed log must
7338
+ * never fail the operation it records.
7339
+ */
7340
+ /** Which management domain the operation belongs to. */
7341
+ var OpsLogDomainSchema = _enum(["recording", "events"]);
7342
+ /** The kind of management operation performed. */
7343
+ var OpsLogOpSchema = _enum([
7344
+ "prune",
7345
+ "manual-delete",
7346
+ "rescan",
7347
+ "retention-run"
7348
+ ]);
7349
+ /** Why the operation ran. */
7350
+ var OpsLogReasonSchema = _enum([
7351
+ "retention",
7352
+ "quota",
7353
+ "manual",
7354
+ "operator"
7355
+ ]);
7356
+ /** One audit row, shared verbatim by both domains. */
7357
+ var OpsLogEntrySchema = object({
7358
+ /** Unique row id. */
7359
+ id: string(),
7360
+ /** Epoch ms the operation completed. */
7361
+ at: number(),
7362
+ domain: OpsLogDomainSchema,
7363
+ op: OpsLogOpSchema,
7364
+ reason: OpsLogReasonSchema,
7365
+ /** The camera the op targeted; null for a cluster/global op. */
7366
+ deviceId: number().nullable(),
7367
+ /** Node that performed the op (the log carries nodeId — no cross-node aggregation). */
7368
+ nodeId: string(),
7369
+ /** Buckets / rows deleted (op-specific unit). */
7370
+ itemsAffected: number(),
7371
+ /** Bytes reclaimed by the op (0 when not measurable). */
7372
+ bytesReclaimed: number(),
7373
+ /** Free-text detail (e.g. "floor moved to <ts>"); null when none. */
7374
+ detail: string().nullable(),
7375
+ /** Who/what triggered the op. */
7376
+ actor: string()
7377
+ });
7378
+ /** Shared query input for the per-domain `listOpsLog` cap methods. */
7379
+ var OpsLogQueryInputSchema = object({
7380
+ /** Restrict to a single camera; omit for every row. */
7381
+ deviceId: number().optional(),
7382
+ /** Max rows returned, newest-first. */
7383
+ limit: number().int().min(1).max(1e3).optional()
7384
+ });
7385
+ /**
7287
7386
  * `StorageLocationType` — an addon-declared id that identifies the *kind* of
7288
7387
  * storage a location serves. Defined here (not in `capabilities/storage.cap.ts`)
7289
7388
  * so the persisted record schema and the consumer-facing cap can both consume it
@@ -12533,7 +12632,11 @@ array(ZoneRuleSchema).readonly();
12533
12632
  * Extend the enum here when a new gating consumer comes online (audio
12534
12633
  * gating, alert filtering, …) — no other surface needs to change.
12535
12634
  */
12536
- var ZoneRuleStageEnum = _enum(["motion", "detection"]);
12635
+ var ZoneRuleStageEnum = _enum([
12636
+ "motion",
12637
+ "detection",
12638
+ "package"
12639
+ ]);
12537
12640
  DeviceType.Camera, method(object({
12538
12641
  deviceId: number(),
12539
12642
  stage: ZoneRuleStageEnum
@@ -12546,7 +12649,8 @@ DeviceType.Camera, method(object({
12546
12649
  auth: "admin"
12547
12650
  }), object({
12548
12651
  motion: array(ZoneRuleSchema).readonly(),
12549
- detection: array(ZoneRuleSchema).readonly()
12652
+ detection: array(ZoneRuleSchema).readonly(),
12653
+ package: array(ZoneRuleSchema).readonly()
12550
12654
  });
12551
12655
  var ProviderStatusSchema = object({
12552
12656
  connected: boolean(),
@@ -15767,6 +15871,7 @@ var EventKindIconSchema = _enum([
15767
15871
  "smoke",
15768
15872
  "water",
15769
15873
  "button",
15874
+ "package",
15770
15875
  "generic"
15771
15876
  ]);
15772
15877
  var EventKindCategorySchema = _enum([
@@ -15774,7 +15879,8 @@ var EventKindCategorySchema = _enum([
15774
15879
  "audio",
15775
15880
  "detection",
15776
15881
  "sensor",
15777
- "custom"
15882
+ "custom",
15883
+ "package"
15778
15884
  ]);
15779
15885
  var EventKindDescriptorSchema = object({
15780
15886
  /** Stable kind id (e.g. 'motion', 'person', 'contact'). */
@@ -16115,6 +16221,26 @@ var TrackCascadeCountsSchema = object({
16115
16221
  /** Per-track CLIP search vectors removed (best-effort). */
16116
16222
  embeddings: number().int()
16117
16223
  });
16224
+ /** Event-store footprint for one camera. */
16225
+ var EventStoreDeviceFootprintSchema = object({
16226
+ deviceId: number(),
16227
+ /** Persisted event rows (motion + object + audio) for the camera. */
16228
+ rows: number().int(),
16229
+ /** Event-owned media bytes on disk for the camera. */
16230
+ bytes: number().int()
16231
+ });
16232
+ /** Aggregate event-store footprint: global totals + per-camera breakdown. */
16233
+ var EventStoreFootprintSchema = object({
16234
+ totalRows: number().int(),
16235
+ totalBytes: number().int(),
16236
+ devices: array(EventStoreDeviceFootprintSchema).readonly()
16237
+ });
16238
+ /** Per-kind counts returned by the event-prune / device-delete mutations. */
16239
+ var EventPruneCountsSchema = object({
16240
+ motion: number().int(),
16241
+ object: number().int(),
16242
+ audio: number().int()
16243
+ });
16118
16244
  DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).readonly()), method(object({
16119
16245
  deviceId: number(),
16120
16246
  trackId: string()
@@ -16178,6 +16304,21 @@ DeviceType.Camera, method(object({ deviceId: number() }), array(TrackSchema).rea
16178
16304
  }), {
16179
16305
  kind: "mutation",
16180
16306
  auth: "admin"
16307
+ }), method(object({}), EventStoreFootprintSchema, {
16308
+ kind: "query",
16309
+ auth: "admin"
16310
+ }), method(object({
16311
+ olderThanMs: number(),
16312
+ reason: OpsLogReasonSchema.optional()
16313
+ }), EventPruneCountsSchema, {
16314
+ kind: "mutation",
16315
+ auth: "admin"
16316
+ }), method(object({ deviceId: number() }), EventPruneCountsSchema, {
16317
+ kind: "mutation",
16318
+ auth: "admin"
16319
+ }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
16320
+ kind: "query",
16321
+ auth: "admin"
16181
16322
  }), method(object({
16182
16323
  eventId: string(),
16183
16324
  kind: MediaFileKindEnum.optional()
@@ -19434,13 +19575,131 @@ method(object({
19434
19575
  }), method(object({ deviceId: number() }), RecordingStatusSchema, {
19435
19576
  kind: "mutation",
19436
19577
  auth: "admin"
19437
- }), method(object({ deviceId: number() }), object({
19578
+ }), method(object({
19579
+ deviceId: number(),
19580
+ reason: OpsLogReasonSchema.optional()
19581
+ }), object({
19438
19582
  floorMs: number().nullable(),
19439
19583
  deletedBuckets: number().int(),
19440
19584
  reclaimedBytes: number().int()
19441
19585
  }), {
19442
19586
  kind: "mutation",
19443
19587
  auth: "admin"
19588
+ }), method(object({
19589
+ deviceId: number(),
19590
+ fromMs: number().optional(),
19591
+ toMs: number().optional()
19592
+ }), object({
19593
+ deletedBuckets: number().int(),
19594
+ reclaimedBytes: number().int()
19595
+ }), {
19596
+ kind: "mutation",
19597
+ auth: "admin"
19598
+ }), method(OpsLogQueryInputSchema, array(OpsLogEntrySchema).readonly(), {
19599
+ kind: "query",
19600
+ auth: "admin"
19601
+ });
19602
+ /**
19603
+ * `recordingExport` cap — render a footage time range into a single downloadable
19604
+ * MP4 (regular / accelerated / decelerated / timelapse, ± audio), kept for a
19605
+ * bounded lifetime with a durable history, auto-expiry, and optional
19606
+ * delete-after-download.
19607
+ *
19608
+ * Like `recording` this is a `scope:'system', mode:'singleton'` cap: the
19609
+ * recorder self-gates so exactly ONE node (the designated `recordingNodeId`,
19610
+ * default `hub`) registers it. Device-scoped methods carry `deviceId` in their
19611
+ * input and dispatch to that single provider; the render runs on the node that
19612
+ * owns the footage (no cross-node segment transfer). Download rides the
19613
+ * framework addon data-plane. State persists in a DurableState blob (NOT
19614
+ * SQLite); history rows survive file deletion for audit.
19615
+ */
19616
+ /** Playback-speed multiplier for the render (1 = realtime). */
19617
+ var ExportSpeedSchema = number().min(.25).max(32);
19618
+ /** Timelapse cadence — sample one source frame per `everyMs`, output at `outputFps`. */
19619
+ var ExportTimelapseSchema = object({
19620
+ everyMs: number().int().positive(),
19621
+ outputFps: number().int().min(1).max(60).optional()
19622
+ });
19623
+ /**
19624
+ * Render options. `speed` and `timelapse` are mutually exclusive. `includeAudio`
19625
+ * is honoured only for a realtime-ish speed (0.5–2×); timelapse is always
19626
+ * silent. `maxLifeMs` bounds how long the finished file is kept;
19627
+ * `deleteAfterDownload` removes it shortly after the first complete download.
19628
+ */
19629
+ var ExportOptionsSchema = object({
19630
+ speed: ExportSpeedSchema.optional(),
19631
+ timelapse: ExportTimelapseSchema.optional(),
19632
+ includeAudio: boolean(),
19633
+ maxLifeMs: number().int().positive(),
19634
+ deleteAfterDownload: boolean(),
19635
+ title: string().max(200).optional()
19636
+ }).superRefine((v, ctx) => {
19637
+ if (v.speed !== void 0 && v.timelapse !== void 0) ctx.addIssue({
19638
+ code: ZodIssueCode.custom,
19639
+ message: "speed and timelapse are mutually exclusive",
19640
+ path: ["timelapse"]
19641
+ });
19642
+ });
19643
+ var ExportStateSchema = _enum([
19644
+ "queued",
19645
+ "rendering",
19646
+ "ready",
19647
+ "failed",
19648
+ "expired",
19649
+ "deleted"
19650
+ ]);
19651
+ /** One export job / history row. */
19652
+ var ExportRecordSchema = object({
19653
+ id: string(),
19654
+ deviceId: number(),
19655
+ profile: string(),
19656
+ fromMs: number(),
19657
+ toMs: number(),
19658
+ options: ExportOptionsSchema,
19659
+ state: ExportStateSchema,
19660
+ /** 0–100 while rendering; null otherwise. */
19661
+ progressPct: number().nullable(),
19662
+ /** File size once ready; null before. */
19663
+ fileBytes: number().nullable(),
19664
+ expiresAt: number(),
19665
+ deleteAfterDownload: boolean(),
19666
+ /** Epoch of the first complete download; null until then. */
19667
+ downloadedAt: number().nullable(),
19668
+ createdAt: number(),
19669
+ /** User id/name that requested the export. */
19670
+ createdBy: string(),
19671
+ /** Failure reason when state is 'failed'; null otherwise. */
19672
+ error: string().nullable()
19673
+ });
19674
+ /** Candidate download URLs (LAN first, then operator extra hosts). */
19675
+ var ExportDownloadSchema = object({
19676
+ url: string(),
19677
+ endpoints: array(string())
19678
+ });
19679
+ method(object({
19680
+ deviceId: number(),
19681
+ profile: string(),
19682
+ fromMs: number(),
19683
+ toMs: number(),
19684
+ options: ExportOptionsSchema
19685
+ }), ExportRecordSchema, {
19686
+ kind: "mutation",
19687
+ auth: "protected"
19688
+ }), method(object({ deviceId: number().optional() }), array(ExportRecordSchema), {
19689
+ kind: "query",
19690
+ auth: "protected"
19691
+ }), method(object({ exportId: string() }), ExportRecordSchema, {
19692
+ kind: "query",
19693
+ auth: "protected"
19694
+ }), method(object({ exportId: string() }), ExportRecordSchema, {
19695
+ kind: "mutation",
19696
+ auth: "protected"
19697
+ }), method(object({ exportId: string() }), ExportRecordSchema, {
19698
+ kind: "mutation",
19699
+ auth: "protected"
19700
+ }), method(object({ exportId: string() }), ExportDownloadSchema, {
19701
+ kind: "query",
19702
+ auth: "protected"
19444
19703
  });
19445
19704
  /**
19446
19705
  * One publishable camera stream as its OWNING PROVIDER describes it — the same
@@ -22460,6 +22719,12 @@ Object.freeze({
22460
22719
  addonId: null,
22461
22720
  access: "delete"
22462
22721
  },
22722
+ "pipelineAnalytics.deleteDeviceEvents": {
22723
+ capName: "pipeline-analytics",
22724
+ capScope: "device",
22725
+ addonId: null,
22726
+ access: "delete"
22727
+ },
22463
22728
  "pipelineAnalytics.deleteTracks": {
22464
22729
  capName: "pipeline-analytics",
22465
22730
  capScope: "device",
@@ -22490,6 +22755,12 @@ Object.freeze({
22490
22755
  addonId: null,
22491
22756
  access: "view"
22492
22757
  },
22758
+ "pipelineAnalytics.getEventStoreFootprint": {
22759
+ capName: "pipeline-analytics",
22760
+ capScope: "device",
22761
+ addonId: null,
22762
+ access: "view"
22763
+ },
22493
22764
  "pipelineAnalytics.getKeyEvents": {
22494
22765
  capName: "pipeline-analytics",
22495
22766
  capScope: "device",
@@ -22532,6 +22803,12 @@ Object.freeze({
22532
22803
  addonId: null,
22533
22804
  access: "view"
22534
22805
  },
22806
+ "pipelineAnalytics.listOpsLog": {
22807
+ capName: "pipeline-analytics",
22808
+ capScope: "device",
22809
+ addonId: null,
22810
+ access: "view"
22811
+ },
22535
22812
  "pipelineAnalytics.listRecentTracks": {
22536
22813
  capName: "pipeline-analytics",
22537
22814
  capScope: "device",
@@ -22544,6 +22821,12 @@ Object.freeze({
22544
22821
  addonId: null,
22545
22822
  access: "view"
22546
22823
  },
22824
+ "pipelineAnalytics.pruneEvents": {
22825
+ capName: "pipeline-analytics",
22826
+ capScope: "device",
22827
+ addonId: null,
22828
+ access: "create"
22829
+ },
22547
22830
  "pipelineAnalytics.pruneEventsBefore": {
22548
22831
  capName: "pipeline-analytics",
22549
22832
  capScope: "device",
@@ -23306,6 +23589,12 @@ Object.freeze({
23306
23589
  addonId: null,
23307
23590
  access: "create"
23308
23591
  },
23592
+ "recording.deleteFootprint": {
23593
+ capName: "recording",
23594
+ capScope: "system",
23595
+ addonId: null,
23596
+ access: "delete"
23597
+ },
23309
23598
  "recording.getAvailability": {
23310
23599
  capName: "recording",
23311
23600
  capScope: "system",
@@ -23336,6 +23625,12 @@ Object.freeze({
23336
23625
  addonId: null,
23337
23626
  access: "view"
23338
23627
  },
23628
+ "recording.listOpsLog": {
23629
+ capName: "recording",
23630
+ capScope: "system",
23631
+ addonId: null,
23632
+ access: "view"
23633
+ },
23339
23634
  "recording.locateSegment": {
23340
23635
  capName: "recording",
23341
23636
  capScope: "system",
@@ -23366,6 +23661,42 @@ Object.freeze({
23366
23661
  addonId: null,
23367
23662
  access: "create"
23368
23663
  },
23664
+ "recordingExport.cancelExport": {
23665
+ capName: "recordingExport",
23666
+ capScope: "system",
23667
+ addonId: null,
23668
+ access: "create"
23669
+ },
23670
+ "recordingExport.createExport": {
23671
+ capName: "recordingExport",
23672
+ capScope: "system",
23673
+ addonId: null,
23674
+ access: "create"
23675
+ },
23676
+ "recordingExport.deleteExport": {
23677
+ capName: "recordingExport",
23678
+ capScope: "system",
23679
+ addonId: null,
23680
+ access: "delete"
23681
+ },
23682
+ "recordingExport.getDownloadUrl": {
23683
+ capName: "recordingExport",
23684
+ capScope: "system",
23685
+ addonId: null,
23686
+ access: "view"
23687
+ },
23688
+ "recordingExport.getExport": {
23689
+ capName: "recordingExport",
23690
+ capScope: "system",
23691
+ addonId: null,
23692
+ access: "view"
23693
+ },
23694
+ "recordingExport.listExports": {
23695
+ capName: "recordingExport",
23696
+ capScope: "system",
23697
+ addonId: null,
23698
+ access: "view"
23699
+ },
23369
23700
  "sceneMonitor.captureReference": {
23370
23701
  capName: "scene-monitor",
23371
23702
  capScope: "device",
@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
21
21
  enumerable: true
22
22
  }) : target, mod));
23
23
  //#endregion
24
- const require_dist = require("../dist-BLJdubxu.js");
24
+ const require_dist = require("../dist-DMo00v-O.js");
25
25
  let node_path = require("node:path");
26
26
  node_path = __toESM(node_path);
27
27
  let node_crypto = require("node:crypto");
@@ -1,4 +1,4 @@
1
- import { a as BaseAddon, c as boolean, d as number, f as object, m as EventCategory, n as defineCustomActions, o as _enum, p as string, r as networkAccessCapability, s as array, t as customAction, u as literal } from "../dist-CUb5-XFg.mjs";
1
+ import { a as BaseAddon, c as boolean, d as number, f as object, m as EventCategory, n as defineCustomActions, o as _enum, p as string, r as networkAccessCapability, s as array, t as customAction, u as literal } from "../dist-Cp3DWi9N.mjs";
2
2
  import * as path from "node:path";
3
3
  import { randomUUID } from "node:crypto";
4
4
  import { spawn } from "node:child_process";
@@ -1,5 +1,5 @@
1
1
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
- const require_dist = require("../dist-BLJdubxu.js");
2
+ const require_dist = require("../dist-DMo00v-O.js");
3
3
  //#region src/turn/cloudflare-turn.ts
4
4
  /**
5
5
  * Cloudflare returns ICE servers in several flavours depending on which
@@ -1,4 +1,4 @@
1
- import { a as BaseAddon, c as boolean, d as number, f as object, i as turnProviderCapability, l as discriminatedUnion, n as defineCustomActions, p as string, t as customAction, u as literal } from "../dist-CUb5-XFg.mjs";
1
+ import { a as BaseAddon, c as boolean, d as number, f as object, i as turnProviderCapability, l as discriminatedUnion, n as defineCustomActions, p as string, t as customAction, u as literal } from "../dist-Cp3DWi9N.mjs";
2
2
  //#region src/turn/cloudflare-turn.ts
3
3
  /**
4
4
  * Cloudflare returns ICE servers in several flavours depending on which
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@camstack/addon-cloudflare",
3
- "version": "1.1.26",
3
+ "version": "1.1.28",
4
4
  "description": "Cloudflare bundle — Tunnel (network-access) + TURN relay (turn-provider). Multi-entry npm package shipping 2 addons under a single bundle.",
5
5
  "keywords": [
6
6
  "camstack",