@camstack/types 1.2.241 → 1.2.243

package/dist/addon.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_sleep = require("./sleep-vrBqRLsb.js");
+const require_sleep = require("./sleep-mVRRyKVq.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 //#region src/generated/cap-input-defaults.ts

package/dist/addon.mjs

@@ -1,4 +1,4 @@
-import { A as DeviceType, Dt as DisposerChain, G as readNodePin, J as ReadinessTimeoutError, L as expandCapMethods, Mt as emitReadiness, Ot as BaseAddon, S as DEVICE_CHILDREN_BATCH_MAX, T as describeCustomActions, Tt as DATAPLANE_SECRET_HEADER, W as nodePin, Z as scopeKey, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, j as adminUiCapability, kt as normalizeAddonInitResult, m as createDeviceProxy, p as isDeviceScopedCap, q as ReadinessRegistry, s as asString, t as sleep, u as parseJsonUnknown, x as viewerUiCapability } from "./sleep-CUmLTud7.mjs";
+import { A as DeviceType, Dt as DisposerChain, G as readNodePin, J as ReadinessTimeoutError, L as expandCapMethods, Mt as emitReadiness, Ot as BaseAddon, S as DEVICE_CHILDREN_BATCH_MAX, T as describeCustomActions, Tt as DATAPLANE_SECRET_HEADER, W as nodePin, Z as scopeKey, a as asJsonObject, b as deviceOpsCapability, d as BOOT_RECOVERY_BACKOFF_MS, f as DEVICE_SCOPED_CAPS, h as createEventBusSliceSource, j as adminUiCapability, kt as normalizeAddonInitResult, m as createDeviceProxy, p as isDeviceScopedCap, q as ReadinessRegistry, s as asString, t as sleep, u as parseJsonUnknown, x as viewerUiCapability } from "./sleep-De1BvmWo.mjs";
 import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 //#region src/generated/cap-input-defaults.ts

package/dist/capabilities/index.d.ts

@@ -116,8 +116,8 @@ export type { IUserPasskeysProvider, PasskeySummary } from './user-passkeys.cap.
 export { PasskeySummarySchema, userPasskeysCapability } from './user-passkeys.cap.js';
 export type { IVectorStoreProvider } from './vector-store.cap.js';
 export { VectorDeclareIndexInputSchema, VectorDeleteByFilterInputSchema, VectorDeleteInputSchema, VectorDeleteResultSchema, type VectorFilter, VectorFilterSchema, VectorGetInputSchema, VectorGetResultSchema, type VectorItem, VectorItemSchema, type VectorMatch, VectorMatchSchema, type VectorMetadata, VectorMetadataSchema, type VectorMetric, VectorMetricSchema, VectorQueryInputSchema, VectorQueryResultSchema, VectorStatsInputSchema, VectorStatsResultSchema, VectorUpsertInputSchema, VectorUpsertResultSchema, vectorStoreCapability, } from './vector-store.cap.js';
-export type { Clip, ClipBytes, ClipPlayback, ClipSource, ClipSourceAvailability, ClipStillDisposition, ClipStillRefusalCode, ClipWake, IVideoclipsProvider, } from './videoclips.cap.js';
-export { CLIP_STILL_DISPOSITION_HEADER, CLIP_STILL_REASON_CODE_HEADER, CLIP_STILL_REASON_HEADER, ClipBytesSchema, ClipPlaybackSchema, ClipSchema, ClipSourceAvailabilitySchema, ClipSourceSchema, ClipStillDispositionSchema, ClipStillRefusalCodeSchema, ClipWakeSchema, MAX_CLIP_EVENT_IDS, MAX_CLIP_LABELS, VIDEOCLIPS_MAX_READ_BYTES, videoclipsCapability, } from './videoclips.cap.js';
+export type { Clip, ClipBytes, ClipPlayback, ClipSource, ClipSourceAvailability, ClipStillDisposition, ClipStillRefusalCode, ClipStreamAudio, ClipStreamAudioReason, ClipStreamDial, ClipWake, IVideoclipsProvider, } from './videoclips.cap.js';
+export { CLIP_STILL_DISPOSITION_HEADER, CLIP_STILL_REASON_CODE_HEADER, CLIP_STILL_REASON_HEADER, CLIP_STREAM_TRANSPORT_HEADER, ClipBytesSchema, ClipPlaybackSchema, ClipSchema, ClipSourceAvailabilitySchema, ClipSourceSchema, ClipStillDispositionSchema, ClipStillRefusalCodeSchema, ClipStreamAudioReasonSchema, ClipStreamAudioSchema, ClipStreamDialSchema, ClipWakeSchema, MAX_CLIP_EVENT_IDS, MAX_CLIP_LABELS, VIDEOCLIPS_MAX_READ_BYTES, videoclipsCapability, } from './videoclips.cap.js';
 export type { IViewerUiProvider } from './viewer-ui.cap.js';
 export { viewerUiCapability } from './viewer-ui.cap.js';
 export { type IWebrtcSessionProvider, type WebrtcClientHints, type WebrtcLadderDecision, WebrtcLadderDecisionSchema, type WebrtcSessionDebug, WebrtcSessionDebugSchema, type WebrtcStreamChoice, WebrtcStreamChoiceSchema, type WebrtcStreamTarget, WebrtcStreamTargetSchema, type WebrtcTierFailure, WebrtcTierFailureSchema, webrtcClientHintsSchema, webrtcSessionCapability, } from './webrtc-session.cap.js';

package/dist/capabilities/pipeline-orchestrator.cap.d.ts

@@ -1273,9 +1273,11 @@ export declare const pipelineOrchestratorCapability: {
                 unavailableReason: z.ZodOptional<z.ZodEnum<{
                     "no-provider": "no-provider";
                     "source-unreachable": "source-unreachable";
-                    "not-configured": "not-configured";
                     "device-disabled": "device-disabled";
                 }>>;
+                warning: z.ZodOptional<z.ZodEnum<{
+                    "no-privacy-zones": "no-privacy-zones";
+                }>>;
                 enabled: z.ZodBoolean;
                 authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"device-disabled">;
@@ -1349,9 +1351,11 @@ export declare const pipelineOrchestratorCapability: {
                 unavailableReason: z.ZodOptional<z.ZodEnum<{
                     "no-provider": "no-provider";
                     "source-unreachable": "source-unreachable";
-                    "not-configured": "not-configured";
                     "device-disabled": "device-disabled";
                 }>>;
+                warning: z.ZodOptional<z.ZodEnum<{
+                    "no-privacy-zones": "no-privacy-zones";
+                }>>;
                 enabled: z.ZodBoolean;
                 authority: z.ZodDiscriminatedUnion<[z.ZodObject<{
                     kind: z.ZodLiteral<"device-disabled">;

package/dist/capabilities/videoclips.cap.d.ts

@@ -95,6 +95,15 @@ export declare const CLIP_STILL_REASON_HEADER = "x-camstack-reason";
 export declare const CLIP_STILL_REASON_CODE_HEADER = "x-camstack-reason-code";
 /** One {@link ClipStillDispositionSchema} token, alone. */
 export declare const CLIP_STILL_DISPOSITION_HEADER = "x-camstack-disposition";
+/**
+ * The clip STREAM route's own statement of what it is (D597): the value is
+ * `forward-only`. A producer writes it on the 200; a consumer that dials a
+ * URL and does not read it back refuses to play, because a progressive file
+ * through a forward-only feeder looks like it worked until the first seek.
+ * Named here because BOTH the provider and the broker spell it, and two
+ * copies of a header name is how one of them stops being checked.
+ */
+export declare const CLIP_STREAM_TRANSPORT_HEADER = "x-camstack-clip-transport";
 export declare const ClipSchema: z.ZodObject<{
     id: z.ZodString;
     source: z.ZodString;
@@ -239,6 +248,71 @@ export declare const ClipBytesSchema: z.ZodObject<{
     durationMs: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export type ClipBytes = z.infer<typeof ClipBytesSchema>;
+/**
+ * Where a clip's STREAM can be dialled (D597) — the answer to
+ * {@link videoclipsCapability.methods.dialClipStream}.
+ *
+ * `url` is plain `http://` on the provider's own token-gated listener, one
+ * shot, short-lived. It is NOT the hub-proxied `/addon/<id>/clip-stream/…`
+ * path: that plane takes only a user credential, which an addon does not
+ * hold, and the framework offers no addon→addon byte transport — the one
+ * precedent is the broker's own restream URLs (`getStreamWithCodec`), which
+ * a consumer dials directly, and this is that precedent one addon over.
+ */
+/**
+ * The audio a clip stream can be asked for, and the audio it carries.
+ *
+ * The camera stores AAC and no WebRTC session speaks it, so a stream that
+ * carries sound carries it TRANSCODED, muxed as a second track beside the
+ * video by the one ffmpeg the provider already runs (D600). `opus` is
+ * 48 kHz mono, `pcmu` is 8 kHz µ-law — the two codecs a broker session
+ * negotiates — and `none` is a stream asked for, or served, without sound.
+ */
+export declare const ClipStreamAudioSchema: z.ZodEnum<{
+    pcmu: "pcmu";
+    none: "none";
+    opus: "opus";
+}>;
+export type ClipStreamAudio = z.infer<typeof ClipStreamAudioSchema>;
+/**
+ * Why a stream that was ASKED for sound is not carrying it (D600).
+ *
+ * Only ever set beside `servedAudio: 'none'` after a non-`none` ask. Absent
+ * means the ask was honoured, or there was no ask.
+ *
+ * - `not-requested` — the caller asked for `none`.
+ * - `unsupported-ask` — the provider cannot produce that codec.
+ *
+ * Whether the RECORDING has sound at all is not knowable here: the camera
+ * declares no audio track before its first frame arrives. That answer is in
+ * the stream itself — an fMP4 with no audio track — and the broker reads it
+ * there. A dial that says `opus` promises the codec, never the content.
+ */
+export declare const ClipStreamAudioReasonSchema: z.ZodEnum<{
+    "not-requested": "not-requested";
+    "unsupported-ask": "unsupported-ask";
+}>;
+export type ClipStreamAudioReason = z.infer<typeof ClipStreamAudioReasonSchema>;
+export declare const ClipStreamDialSchema: z.ZodObject<{
+    url: z.ZodString;
+    expiresAtMs: z.ZodNumber;
+    transport: z.ZodLiteral<"forward-only">;
+    served: z.ZodEnum<{
+        high: "high";
+        mid: "mid";
+        low: "low";
+    }>;
+    servedAudio: z.ZodEnum<{
+        pcmu: "pcmu";
+        none: "none";
+        opus: "opus";
+    }>;
+    audioReason: z.ZodOptional<z.ZodEnum<{
+        "not-requested": "not-requested";
+        "unsupported-ask": "unsupported-ask";
+    }>>;
+}, z.core.$strip>;
+export type ClipStreamDial = z.infer<typeof ClipStreamDialSchema>;
 export declare const ClipSourceAvailabilitySchema: z.ZodObject<{
     state: z.ZodEnum<{
         ok: "ok";
@@ -489,6 +563,57 @@ export declare const videoclipsCapability: {
         }, z.core.$strip>, "query"> & {
             readonly providerOptional: true;
         };
+        /**
+         * Where this clip's STREAM can be dialled (D597) — the forward-only
+         * fMP4 the provider writes from the first muxed byte, for the broker to
+         * play through the same WebRTC session as recorded footage, with the
+         * first frame at the first fragment instead of after the last byte.
+         *
+         * Nothing is fetched here: the answer is a one-shot URL on the
+         * provider's own listener, and the camera is touched when it is dialled.
+         * The gates the file path runs (`readClipBytes`) run on the dial too —
+         * the id, the row, a clip still being written — and refuse in the same
+         * vocabulary, THROWN with `clipExportFailure(<token>, <prose>)`. Every
+         * profile is served (D599) and the answer states which twin it carries;
+         * `high` is not refused. Optional on the provider for the same reason
+         * `readClipBytes` is: a source with no camera socket behind it (the
+         * recorder's analytics window, a HomeKit tee) has no stream.
+         */
+        readonly dialClipStream: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
+            deviceId: z.ZodNumber;
+            clipId: z.ZodString;
+            provider: z.ZodString;
+            profile: z.ZodOptional<z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>>;
+            audio: z.ZodOptional<z.ZodEnum<{
+                pcmu: "pcmu";
+                none: "none";
+                opus: "opus";
+            }>>;
+        }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+            expiresAtMs: z.ZodNumber;
+            transport: z.ZodLiteral<"forward-only">;
+            served: z.ZodEnum<{
+                high: "high";
+                mid: "mid";
+                low: "low";
+            }>;
+            servedAudio: z.ZodEnum<{
+                pcmu: "pcmu";
+                none: "none";
+                opus: "opus";
+            }>;
+            audioReason: z.ZodOptional<z.ZodEnum<{
+                "not-requested": "not-requested";
+                "unsupported-ask": "unsupported-ask";
+            }>>;
+        }, z.core.$strip>, "query"> & {
+            readonly providerOptional: true;
+        };
     };
 };
 export type IVideoclipsProvider = InferProvider<typeof videoclipsCapability>;

package/dist/device/container-primary-child.d.ts

@@ -90,10 +90,4 @@ export interface ContainerChildRef {
  * they are deliberately absent and fall through to type priority.
  */
 export declare const CONTAINER_CHILD_ROLE_PRIORITY: readonly string[];
-/**
- * The child a container stands for: the operator's pick when it still exists,
- * else the highest-priority type. `null` for a childless container — a caller
- * must decide what an empty container means for it, rather than being handed a
- * child that is not there.
- */
 export declare function resolveContainerPrimaryChild(children: readonly ContainerChildRef[], overrideEntityId: string | null | undefined, containerName?: string): ContainerChildRef | null;

package/dist/device/display-icon-vocabulary.d.ts

@@ -0,0 +1,106 @@
+/**
+ * display-icon-vocabulary — the icon KEYS both UIs share, and the search that
+ * finds one.
+ *
+ * The reason this is here and not in a UI package is the one
+ * `location-icon.ts` already states for the location vocabulary: two surfaces
+ * draw these icons and they do NOT share an icon module. The admin UI imports
+ * `lucide-react`; the viewer imports a hand-maintained per-icon allowlist
+ * (`src/lib/icons.ts`, re-exporting `lucide-react-native/icons/*` because the
+ * barrel is 47 % of that app's modules). Anything shared between them must
+ * therefore be STRINGS, and this module contains no React, no lucide, and no
+ * glyph.
+ *
+ * So the layering is:
+ *
+ * | layer | lives in | holds |
+ * | --- | --- | --- |
+ * | vocabulary + search | here | keys, groups, synonyms, scoring |
+ * | glyph table (web) | `ui-library`'s `DISPLAY_ICON_REGISTRY` | key → lucide-react |
+ * | glyph table (phone) | viewer's accessory icon map | key → lucide-react-native |
+ *
+ * Each glyph table must cover exactly these keys, and a test on each side
+ * pins that. A key offered on one surface and missing on the other falls
+ * through to the next precedence level there, which the operator reads as "my
+ * change did nothing" — the failure this vocabulary exists to make impossible.
+ *
+ * {@link LOCATION_ICON_IDS} is a SUBSET of these keys, pinned by a test. Two
+ * icon vocabularies on the same two surfaces with different members is the
+ * same bug wearing a different name — `briefcase` and `route` are here only
+ * because locations already draw them.
+ *
+ * ## Synonyms, and why they are bilingual
+ *
+ * The keys are English lucide ids and always will be: they name the DRAWING,
+ * mechanically checkable against a package, not the room. But the operator
+ * searching this list types Italian — "tapparella", not "blinds". A picker
+ * whose search only matches the key would make three quarters of the
+ * vocabulary unreachable to them.
+ *
+ * So every entry carries the words it answers to, in both languages. They are
+ * deliberately not translations of a label: they are the words somebody would
+ * actually type looking for that picture, including the wrong-but-obvious
+ * ones (`blinds` answers to `persiana` and `serranda` too).
+ */
+/** What an operator is naming when they pick from this group. */
+export type DisplayIconGroup = 'device' | 'lighting' | 'sensing' | 'place' | 'life';
+/** The order the groups are offered in, and the only members there are. */
+export declare const DISPLAY_ICON_GROUPS: readonly DisplayIconGroup[];
+/** One icon in the shared vocabulary. */
+export interface DisplayIconEntry {
+    /** The kebab-case lucide id. This is the value that is PERSISTED. */
+    readonly key: string;
+    readonly group: DisplayIconGroup;
+    /**
+     * Words this icon answers to in search, English and Italian. Never
+     * rendered — a caller that wants a label supplies its own translation.
+     */
+    readonly synonyms: readonly string[];
+    /**
+     * The key this one is a deprecated spelling OF, drawing the same picture.
+     *
+     * An alias must keep RESOLVING — rows have it persisted — but it must not
+     * be OFFERED: a second, identical tile lets an operator newly choose the
+     * spelling we are trying to retire, and gives them no way to tell the two
+     * apart. So `searchDisplayIcons` skips aliases and `displayIconEntry` does
+     * not.
+     */
+    readonly aliasOf?: string;
+}
+/**
+ * The vocabulary, in the order a picker offers it.
+ *
+ * Adding a key here is not enough to make it pickable: both glyph tables must
+ * gain it too, and their tests fail until they do. That is the intended
+ * friction — it is the only thing that keeps the two surfaces honest.
+ */
+export declare const DISPLAY_ICON_VOCABULARY: readonly DisplayIconEntry[];
+/** Every key, in vocabulary order — aliases included, because they resolve. */
+export declare const DISPLAY_ICON_KEYS: readonly string[];
+/** The keys a picker OFFERS: everything that is not a deprecated spelling. */
+export declare const DISPLAY_ICON_OFFERED_KEYS: readonly string[];
+/** Is this a key of the shared vocabulary? */
+export declare function isDisplayIconKey(value: unknown): boolean;
+/** The entry for a key, or `undefined` — never a guessed one. */
+export declare function displayIconEntry(key: string): DisplayIconEntry | undefined;
+/** The entries of one group, in vocabulary order. */
+export declare function displayIconsInGroup(group: DisplayIconGroup): readonly DisplayIconEntry[];
+/** One search result: the entry, and how strongly it matched. */
+export interface DisplayIconHit {
+    readonly entry: DisplayIconEntry;
+    readonly score: number;
+}
+/**
+ * Rank the vocabulary against a free-text query.
+ *
+ * An empty query returns the WHOLE vocabulary in its declared order, because
+ * a picker's resting state is the full list, not an empty one.
+ *
+ * `extraWords` lets a caller add the words IT can translate — a localised
+ * device-role label, say — without this module knowing what a locale is.
+ * They score exactly like a synonym.
+ *
+ * Ties keep vocabulary order: a search that reshuffles equally-good results
+ * between two keystrokes makes the list unusable.
+ */
+export declare function searchDisplayIcons(query: string, extraWords?: ReadonlyMap<string, readonly string[]>): readonly DisplayIconHit[];

package/dist/generated/addon-api.d.ts

@@ -9087,6 +9087,13 @@ export type AppRouter = TrpcCoreRouter<{
             output: z.infer<typeof videoclipsCapability.methods.readClipBytes.output>;
             meta: object;
         }>;
+        dialClipStream: TRPCQueryProcedure<{
+            input: {
+                [x: string]: unknown;
+            } & z.input<typeof videoclipsCapability.methods.dialClipStream.input>;
+            output: z.infer<typeof videoclipsCapability.methods.dialClipStream.output>;
+            meta: object;
+        }>;
     }>>;
     viewerUi: TRPCBuiltRouter<{
         ctx: TrpcContext;

package/dist/generated/method-access-map.d.ts

@@ -6,7 +6,7 @@
  * scope+access check inside `protectedProcedure` (see
  * `server/backend/src/api/trpc/trpc.middleware.ts`).
  *
- * Coverage: 1164 method paths across 158 capabilities.
+ * Coverage: 1165 method paths across 158 capabilities.
  */
 import type { CapabilityMethodAccess } from '../capabilities/capability-definition.js';
 export interface MethodAccessRecord {

package/dist/generated/method-device-selectors.d.ts

@@ -6,7 +6,7 @@
  * system-scope cap that takes a deviceId was previously never device-filtered
  * — see the generator header).
  *
- * Coverage: 391 methods carry a device reference, of which
+ * Coverage: 392 methods carry a device reference, of which
  * 141 are on SYSTEM-scope caps.
  *
  * Top-level fields, number arrays, and one-level arrays of objects carrying

package/dist/index.d.ts

@@ -176,6 +176,8 @@ export { ChargingStatus, DeviceFeature, DeviceRole, DeviceType } from './device/
 export type { IBatteryOperated, IDoorbellButton, INativeSnapshot, IPanTiltZoom, IRebootable, ITwoWayAudio, } from './device/features.js';
 export type { LocationDescriptionAssignment, LocationIconAssignment, LocationIconId, } from './device/location-icon.js';
 export { LOCATION_ICON_FALLBACK, LOCATION_ICON_IDS, LOCATION_DESCRIPTION_MAX, LocationDescriptionAssignmentSchema, LocationIconAssignmentSchema, LocationIconIdSchema, locationIconKey, resolveLocationIcon, } from './device/location-icon.js';
+export type { DisplayIconEntry, DisplayIconGroup, DisplayIconHit, } from './device/display-icon-vocabulary.js';
+export { DISPLAY_ICON_GROUPS, DISPLAY_ICON_KEYS, DISPLAY_ICON_OFFERED_KEYS, DISPLAY_ICON_VOCABULARY, displayIconEntry, displayIconsInGroup, isDisplayIconKey, searchDisplayIcons, } from './device/display-icon-vocabulary.js';
 export { getByPath, setByPath } from './device/path-util.js';
 export type { ReachabilityPollHandle, ReachabilityPollLogger, ReachabilityPollOptions, } from './device/reachability-poll.js';
 export { REACHABILITY_FAILURES_TO_OFFLINE, REACHABILITY_POLL_INTERVAL_MS, REACHABILITY_PROBE_TIMEOUT_MS, startReachabilityPoll, } from './device/reachability-poll.js';