@camstack/types 1.2.384 → 1.2.385

package/dist/interfaces/event-bus.d.ts

@@ -1,4 +1,5 @@
 import type { BulkUpdateState } from '../capabilities/addons.cap.js';
+import type { AlertEpisodePayload } from '../notification/alert-episode.js';
 import type { MotionRegion } from '../capabilities/motion-detection.cap.js';
 import type { DetectionSource } from '../capabilities/pipeline-analytics.cap.js';
 import type { CamProfile } from '../capabilities/schemas/streaming-shared.js';
@@ -1557,6 +1558,7 @@ export interface EventCatalog {
         alertId: string;
         patch: Record<string, unknown>;
     };
+    'alert.episode': AlertEpisodePayload;
     /**
      * Per-broker stream health transition. Fired by the stream-broker
      * watchdog. `camStreamId` is the canonical identity of the source

package/dist/interfaces/relocate.d.ts

@@ -843,3 +843,28 @@ export declare const StorageCleanupStatusInputSchema: z.ZodObject<{
     jobId: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type StorageCleanupStatusInput = z.infer<typeof StorageCleanupStatusInputSchema>;
+/** The orchestrator's answer to "may a mover touch these locations now?". */
+export interface MoverClearanceAnswer {
+    readonly clear: boolean;
+    readonly repointLocationId?: string | undefined;
+}
+export interface MoverStartDeps {
+    /** `storageMigration.moverClearance` — the orchestrator owns one claim per physical root. */
+    readonly clearance: (locationIds: readonly string[]) => Promise<MoverClearanceAnswer>;
+    /** Registers and starts the job; returns its id. */
+    readonly start: () => string;
+    readonly cancel: (jobId: string) => void;
+    /** The locations the job reads or writes (`*` = every eventMedia location). */
+    readonly locationIds: readonly string[];
+}
+/**
+ * Start a mover only when no single-location repoint holds an overlapping
+ * physical root. Asks BEFORE (cheap refusal, no job) and AFTER registering the
+ * job: the repoint announces its claim and then lists movers, so a mover that
+ * registers first is seen by it and one that registers second sees the claim —
+ * neither side can miss the other (2026-10-20: a repoint and a relocate job
+ * moved and deleted the same event media with no lock between them).
+ *
+ * Fail CLOSED: a clearance that cannot be asked refuses the start.
+ */
+export declare function startMoverUnderClearance(deps: MoverStartDeps): Promise<string>;

package/dist/notification/alert-episode.d.ts

@@ -0,0 +1,62 @@
+/**
+ * An alert EPISODE as a notification subject.
+ *
+ * The alert centre sends nothing of its own. A critical or error alert reaches
+ * the operator through Notification Center system-event rules, and this file is
+ * the one vocabulary the two sides share: the alert centre mints the episode
+ * identity and announces its two edges on the bus (`alert.episode`), and
+ * Notification Center derives the same identity when it RECONCILES from the
+ * alerts store, because a bus event may be dropped (D8, D11).
+ *
+ * ## Episode identity
+ *
+ * `metadata.episodeId`, minted by the alert centre when an alert opens (new, or
+ * re-opened after it was completed/dismissed, or its emitter changed
+ * `metadata.episodeKey`) and kept through every re-emit while it stays open. An
+ * alert row written before the alert centre minted ids has none: its episode is
+ * `<id>@<createdAt>`, derived here so both sides agree.
+ */
+import { z } from 'zod';
+import { type Alert, type AlertSeverity, type AlertStatus } from '../capabilities/alerts.cap.js';
+import type { NcSystemEventKind } from '../capabilities/notification-rules.cap.js';
+export type AlertEpisodePhase = 'raised' | 'resolved';
+/** The bus payload of `EventCategory.AlertEpisode`. */
+export declare const AlertEpisodePayloadSchema: z.ZodObject<{
+    phase: z.ZodEnum<{
+        raised: "raised";
+        resolved: "resolved";
+    }>;
+    episodeId: z.ZodString;
+    alertId: z.ZodString;
+    severity: z.ZodEnum<{
+        critical: "critical";
+        error: "error";
+        info: "info";
+        success: "success";
+        warning: "warning";
+    }>;
+    category: z.ZodString;
+    title: z.ZodString;
+    message: z.ZodString;
+    sourceType: z.ZodOptional<z.ZodString>;
+    sourceId: z.ZodOptional<z.ZodString>;
+    nodeId: z.ZodOptional<z.ZodString>;
+    actionUrl: z.ZodOptional<z.ZodString>;
+    at: z.ZodNumber;
+}, z.core.$strip>;
+export type AlertEpisodePayload = z.infer<typeof AlertEpisodePayloadSchema>;
+/** The payload of an `alert.episode` event's `data`, or `null` when it is not one. */
+export declare function parseAlertEpisodePayload(data: unknown): AlertEpisodePayload | null;
+/** An episode is closed once its alert is completed or dismissed. */
+export declare function isAlertEpisodeOpen(status: AlertStatus): boolean;
+/** Only these severities are ever announced. */
+export declare function isAlertEpisodeSeverity(severity: AlertSeverity): boolean;
+export declare function alertEpisodeId(alert: Pick<Alert, 'id' | 'createdAt' | 'metadata'>): string;
+/** The node an alert is about, from the places emitters put it. */
+export declare function alertNodeId(alert: Pick<Alert, 'source' | 'metadata'>): string | undefined;
+/**
+ * The system-event kind of an episode edge, or `null` when none is announced
+ * (an `error` episode announces its opening only).
+ */
+export declare function alertEpisodeKind(severity: AlertSeverity, phase: AlertEpisodePhase): NcSystemEventKind | null;
+export declare function alertEpisodePayload(alert: Alert, phase: AlertEpisodePhase, at: number): AlertEpisodePayload;

package/dist/{sleep-REHQvLV6.js → sleep-BE7_6UnC.js}

@@ -1,4 +1,4 @@
-const require_event_category = require("./event-category-Hoe-mqbd.js");
+const require_event_category = require("./event-category-eSqkye-K.js");
 let zod = require("zod");
 //#region src/audio/audio-chunk-format.ts
 /**
@@ -6388,6 +6388,7 @@ function createDeviceProxy(api, binding, opts) {
 	const dishwasherInterface = {
 		start: (input) => dispatch("dishwasher", "dishwasher", "start", "mutation", input),
 		pause: (input) => dispatch("dishwasher", "dishwasher", "pause", "mutation", input),
+		resume: (input) => dispatch("dishwasher", "dishwasher", "resume", "mutation", input),
 		stop: (input) => dispatch("dishwasher", "dishwasher", "stop", "mutation", input),
 		setProgram: (input) => dispatch("dishwasher", "dishwasher", "setProgram", "mutation", input),
 		setPower: (input) => dispatch("dishwasher", "dishwasher", "setPower", "mutation", input),
@@ -6398,6 +6399,7 @@ function createDeviceProxy(api, binding, opts) {
 		setVarioSpeedPlus: (input) => dispatch("dishwasher", "dishwasher", "setVarioSpeedPlus", "mutation", input),
 		setChildLock: (input) => dispatch("dishwasher", "dishwasher", "setChildLock", "mutation", input),
 		setOption: (input) => dispatch("dishwasher", "dishwasher", "setOption", "mutation", input),
+		getOptions: (input) => dispatch("dishwasher", "dishwasher", "getOptions", "query", input),
 		getStatus: (input) => dispatch("dishwasher", "dishwasher", "getStatus", "query", input)
 	};
 	const doorbellInterface = { getStatus: (input) => dispatch("doorbell", "doorbell", "getStatus", "query", input) };

package/dist/{sleep-BegKjwUu.mjs → sleep-BxjU_fJM.mjs}

@@ -1,4 +1,4 @@
-import { t as EventCategory } from "./event-category-BvOFi6PY.mjs";
+import { t as EventCategory } from "./event-category-DOl51-Ij.mjs";
 import { z } from "zod";
 //#region src/audio/audio-chunk-format.ts
 /**
@@ -6388,6 +6388,7 @@ function createDeviceProxy(api, binding, opts) {
 	const dishwasherInterface = {
 		start: (input) => dispatch("dishwasher", "dishwasher", "start", "mutation", input),
 		pause: (input) => dispatch("dishwasher", "dishwasher", "pause", "mutation", input),
+		resume: (input) => dispatch("dishwasher", "dishwasher", "resume", "mutation", input),
 		stop: (input) => dispatch("dishwasher", "dishwasher", "stop", "mutation", input),
 		setProgram: (input) => dispatch("dishwasher", "dishwasher", "setProgram", "mutation", input),
 		setPower: (input) => dispatch("dishwasher", "dishwasher", "setPower", "mutation", input),
@@ -6398,6 +6399,7 @@ function createDeviceProxy(api, binding, opts) {
 		setVarioSpeedPlus: (input) => dispatch("dishwasher", "dishwasher", "setVarioSpeedPlus", "mutation", input),
 		setChildLock: (input) => dispatch("dishwasher", "dishwasher", "setChildLock", "mutation", input),
 		setOption: (input) => dispatch("dishwasher", "dishwasher", "setOption", "mutation", input),
+		getOptions: (input) => dispatch("dishwasher", "dishwasher", "getOptions", "query", input),
 		getStatus: (input) => dispatch("dishwasher", "dishwasher", "getStatus", "query", input)
 	};
 	const doorbellInterface = { getStatus: (input) => dispatch("doorbell", "doorbell", "getStatus", "query", input) };

package/dist/utils/oauth-landing.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Where an OAuth round-trip ends: the admin-ui completion route
+ * (`/sso-complete`, the page every popup sign-in already lands on), with the
+ * OUTCOME in the URL fragment.
+ *
+ * The outcome is a status plus a reason CODE from a closed list. It never
+ * carries a token, a code, a client secret or a free-form error message: the
+ * page words each code itself, and an unknown code reads as `unknown` rather
+ * than being echoed. Fragment only, so nothing here reaches a server log.
+ *
+ * Pure and browser-safe.
+ */
+/** The admin-ui route the hub's OAuth completions land on (relative to its mount). */
+export declare const OAUTH_LANDING_PATH = "/sso-complete";
+export declare const OAUTH_LANDING_REASONS: readonly ['access_denied', 'invalid_state', 'invalid_request', 'unknown_broker', 'not_configured', 'exchange_failed', 'no_refresh_token', 'unavailable', 'unknown'];
+export type OauthLandingReason = (typeof OAUTH_LANDING_REASONS)[number];
+export declare function isOauthLandingReason(value: unknown): value is OauthLandingReason;
+export interface OauthLandingOutcome {
+    readonly status: 'success' | 'error';
+    /** The addon that ran the flow — names the integration page to return to, when known. */
+    readonly addonId?: string;
+    /** The broker the flow signed in, when it was one. */
+    readonly brokerId?: string;
+    /** An OAuth integration id (`export-alexa`), when the flow was an account link. */
+    readonly integration?: string;
+    /** Why it failed; an error without one reads as `unknown`. */
+    readonly reason?: OauthLandingReason;
+    /** What the flow did; absent means a sign-in (connect). */
+    readonly action?: 'connect' | 'disconnect';
+}
+/**
+ * The landing URL for `outcome`. `origin` is the hub address the flow already
+ * runs on (from the `local-network` palette role, never a literal); `null`
+ * gives a hub-relative URL.
+ */
+export declare function oauthLandingUrl(origin: string | null, outcome: OauthLandingOutcome): string;
+/** Parse the fragment of a landing URL; `null` for anything that is not one. */
+export declare function parseOauthLandingFragment(hash: string): OauthLandingOutcome | null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.384",
+  "version": "1.2.385",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",