@camstack/types 1.1.48 → 1.1.50

package/dist/capabilities/zone-rules.cap.d.ts

@@ -12,6 +12,7 @@ import { DeviceType } from '../device/device-type.js';
  */
 export declare const ZoneRuleStageEnum: z.ZodEnum<{
     motion: "motion";
+    package: "package";
     detection: "detection";
 }>;
 export type ZoneRuleStage = z.infer<typeof ZoneRuleStageEnum>;
@@ -44,6 +45,7 @@ export declare const zoneRulesCapability: {
             deviceId: z.ZodNumber;
             stage: z.ZodEnum<{
                 motion: "motion";
+                package: "package";
                 detection: "detection";
             }>;
         }, z.core.$strip>, z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -68,6 +70,7 @@ export declare const zoneRulesCapability: {
             deviceId: z.ZodNumber;
             stage: z.ZodEnum<{
                 motion: "motion";
+                package: "package";
                 detection: "detection";
             }>;
             rules: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -87,12 +90,20 @@ export declare const zoneRulesCapability: {
         }, z.core.$strip>, z.ZodVoid, "mutation">;
     };
     /**
-     * Runtime-state slice — both stages mirrored together so consumers
+     * Runtime-state slice — every stage mirrored together so consumers
      * see one reactive handle (`device.state.zoneRules.value`) instead
-     * of two. Bulk-replace mutations on either stage write the full
-     * `{motion, detection}` shape, so subscribers always get the
+     * of one per stage. Bulk-replace mutations on any stage write the full
+     * `{motion, detection, package}` shape, so subscribers always get the
      * complete current set. Consumers that only care about one stage
      * just read the matching property.
+     *
+     * `package` backs the package-drop detector — a package zone is a
+     * `ZoneRule` on the `'package'` stage referencing drawn polygons
+     * (see docs/superpowers/specs/2026-07-17-package-zones-design.md §3.1).
+     * The orchestrator provider writes this stage as a first-class slice
+     * (Phase 4): every mutation mirrors the full `{motion, detection,
+     * package}` shape, so consumers read the current package rules directly
+     * off `device.state.zoneRules.value.package`.
      */
     readonly runtimeState: z.ZodObject<{
         motion: z.ZodReadonly<z.ZodArray<z.ZodObject<{
@@ -123,6 +134,20 @@ export declare const zoneRulesCapability: {
             preferMask: z.ZodOptional<z.ZodBoolean>;
             enabled: z.ZodDefault<z.ZodBoolean>;
         }, z.core.$strip>>>;
+        package: z.ZodReadonly<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            zoneIds: z.ZodReadonly<z.ZodArray<z.ZodString>>;
+            mode: z.ZodEnum<{
+                include: "include";
+                exclude: "exclude";
+            }>;
+            classFilter: z.ZodOptional<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+            overlapThreshold: z.ZodOptional<z.ZodNumber>;
+            bboxInclusionPct: z.ZodOptional<z.ZodNumber>;
+            preferMask: z.ZodOptional<z.ZodBoolean>;
+            enabled: z.ZodDefault<z.ZodBoolean>;
+        }, z.core.$strip>>>;
     }, z.core.$strip>;
 };
 export type IZoneRulesProvider = InferProvider<typeof zoneRulesCapability>;

package/dist/enums/event-category.d.ts

@@ -150,6 +150,11 @@ export declare enum EventCategory {
     /** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
      *  thumb is a scrub gap the recorder's keyframe backfill covers. */
     RecordingThumbSampled = "recording.thumb-sampled",
+    /** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
+     *  progress bar the client reconciles via `recordingExport.getExport`. */
+    RecordingExportProgress = "recording.export.progress",
+    RecordingExportCompleted = "recording.export.completed",
+    RecordingExportFailed = "recording.export.failed",
     DetectionEvent = "detection.event",
     SessionTrackNew = "session.track.new",
     SessionTrackExpired = "session.track.expired",
@@ -438,6 +443,25 @@ export declare enum EventCategory {
      * `{ deviceId, entryId, className, phase:'appeared'|'departed', timestamp }`.
      */
     PipelineAnalyticsStationaryChanged = "pipeline-analytics.stationary-changed",
+    /**
+     * Fired by `addon-post-analysis` when a package-drop is confirmed inside
+     * a package zone — a newly-appeared stationary object of a package class
+     * that cleared the class / zone / dwell / size gates. Payload:
+     * `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
+     * entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+     * Telemetry (D8): the durable record is the `package-events` store row;
+     * this bus topic drives notifier rules + live UI. See
+     * docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+     */
+    PipelineAnalyticsPackageDelivered = "pipeline-analytics.package-delivered",
+    /**
+     * Fired by `addon-post-analysis` when a previously-delivered package
+     * leaves its zone (the stationary entry departed — moved or swept).
+     * Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
+     * `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
+     * Telemetry (D8). See package-zones-design §5.2.
+     */
+    PipelineAnalyticsPackagePickedUp = "pipeline-analytics.package-picked-up",
     /**
      * Fired by `addon-post-analysis` whenever a gallery face row changes:
      * `kind:'buffered'` a new detected face was persisted, `'assigned'` /

package/dist/enums.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_event_category = require("./event-category-AkBNxg_X.js");
+const require_event_category = require("./event-category-CGj9fI4L.js");
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/enums.mjs

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-H4AVePnn.mjs";
+import { t as EventCategory } from "./event-category-D4HJq7Mw.mjs";
 //#region src/enums/event-source-type.ts
 var EventSourceType = /* @__PURE__ */ function(EventSourceType) {
 	EventSourceType["Addon"] = "addon";

package/dist/{event-category-AkBNxg_X.js → event-category-CGj9fI4L.js}

@@ -151,6 +151,11 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
 	*  thumb is a scrub gap the recorder's keyframe backfill covers. */
 	EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
+	/** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
+	*  progress bar the client reconciles via `recordingExport.getExport`. */
+	EventCategory["RecordingExportProgress"] = "recording.export.progress";
+	EventCategory["RecordingExportCompleted"] = "recording.export.completed";
+	EventCategory["RecordingExportFailed"] = "recording.export.failed";
 	EventCategory["DetectionEvent"] = "detection.event";
 	EventCategory["SessionTrackNew"] = "session.track.new";
 	EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -440,6 +445,25 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
 	/**
+	* Fired by `addon-post-analysis` when a package-drop is confirmed inside
+	* a package zone — a newly-appeared stationary object of a package class
+	* that cleared the class / zone / dwell / size gates. Payload:
+	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
+	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* Telemetry (D8): the durable record is the `package-events` store row;
+	* this bus topic drives notifier rules + live UI. See
+	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+	*/
+	EventCategory["PipelineAnalyticsPackageDelivered"] = "pipeline-analytics.package-delivered";
+	/**
+	* Fired by `addon-post-analysis` when a previously-delivered package
+	* leaves its zone (the stationary entry departed — moved or swept).
+	* Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
+	* `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
+	* Telemetry (D8). See package-zones-design §5.2.
+	*/
+	EventCategory["PipelineAnalyticsPackagePickedUp"] = "pipeline-analytics.package-picked-up";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was

package/dist/{event-category-H4AVePnn.mjs → event-category-D4HJq7Mw.mjs}

@@ -151,6 +151,11 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	/** Runner-sampled scrub thumbnail (~1/5 s/camera). Telemetry (D8): a lost
 	*  thumb is a scrub gap the recorder's keyframe backfill covers. */
 	EventCategory["RecordingThumbSampled"] = "recording.thumb-sampled";
+	/** Export render progress (0–100). Telemetry (D8): a lost tick is a stale
+	*  progress bar the client reconciles via `recordingExport.getExport`. */
+	EventCategory["RecordingExportProgress"] = "recording.export.progress";
+	EventCategory["RecordingExportCompleted"] = "recording.export.completed";
+	EventCategory["RecordingExportFailed"] = "recording.export.failed";
 	EventCategory["DetectionEvent"] = "detection.event";
 	EventCategory["SessionTrackNew"] = "session.track.new";
 	EventCategory["SessionTrackExpired"] = "session.track.expired";
@@ -440,6 +445,25 @@ var EventCategory = /* @__PURE__ */ function(EventCategory) {
 	*/
 	EventCategory["PipelineAnalyticsStationaryChanged"] = "pipeline-analytics.stationary-changed";
 	/**
+	* Fired by `addon-post-analysis` when a package-drop is confirmed inside
+	* a package zone — a newly-appeared stationary object of a package class
+	* that cleared the class / zone / dwell / size gates. Payload:
+	* `PipelineAnalyticsPackageDeliveredPayload` carrying `{ deviceId,
+	* entryId, className, zoneIds, keyFrameMediaKey?, bbox, timestamp }`.
+	* Telemetry (D8): the durable record is the `package-events` store row;
+	* this bus topic drives notifier rules + live UI. See
+	* docs/superpowers/specs/2026-07-17-package-zones-design.md §5.1.
+	*/
+	EventCategory["PipelineAnalyticsPackageDelivered"] = "pipeline-analytics.package-delivered";
+	/**
+	* Fired by `addon-post-analysis` when a previously-delivered package
+	* leaves its zone (the stationary entry departed — moved or swept).
+	* Payload: `PipelineAnalyticsPackagePickedUpPayload` carrying
+	* `{ deviceId, entryId, deliveredEventId, className, timestamp }`.
+	* Telemetry (D8). See package-zones-design §5.2.
+	*/
+	EventCategory["PipelineAnalyticsPackagePickedUp"] = "pipeline-analytics.package-picked-up";
+	/**
 	* Fired by `addon-post-analysis` whenever a gallery face row changes:
 	* `kind:'buffered'` a new detected face was persisted, `'assigned'` /
 	* `'unassigned'` its identity link changed, `'deleted'` the row was