@camstack/types 1.2.245 → 1.2.247

package/dist/{sleep-i3eUVc-d.mjs → sleep-PEo0-Fz9.mjs}

@@ -1349,6 +1349,56 @@ var DATAPLANE_SECRET_HEADER = "x-camstack-dataplane-secret";
 */
 var SHARE_VIEW_KINDS = ["grid-view", "events-view"];
 //#endregion
+//#region src/interfaces/addon-peer-bytes.ts
+/**
+* How long a minted ticket stays takeable.
+*
+* The consumer's dial is the next thing that happens after the cap call that
+* minted it returns — measured well under 100 ms on the same host for the clip
+* dial this is generalised from. Thirty seconds covers a busy hub and is short
+* enough that a ticket which leaked into a log is worth nothing by the time
+* anybody reads it.
+*/
+var PEER_BYTES_TICKET_TTL_MS = 3e4;
+/**
+* Tickets minted and not yet taken or expired, per addon process.
+*
+* A bound, not a budget: it exists so a caller that mints and never dials
+* cannot grow a map without limit, and so a per-frame misuse of this facility
+* is refused by name rather than working slowly.
+*/
+var PEER_BYTES_MAX_OUTSTANDING = 64;
+/**
+* How long the producer waits on a consumer that has stopped reading before it
+* cuts the body.
+*
+* D447: a raw HTTP stream reads no chunk the socket has not taken. The producer
+* honours `write()`'s return and awaits `drain`; a peer that never drains is
+* a peer that is gone, and holding the body for it is the unbounded buffer this
+* whole facility exists to avoid.
+*/
+var PEER_BYTES_STALL_MS = 15e3;
+/** Bytes handed to the socket per `write()` when the producer holds a buffer. */
+var PEER_BYTES_CHUNK_BYTES = 256 * 1024;
+/** The wire shape of {@link PeerBytesTicket} — see the type for what it is. */
+var PeerBytesTicketSchema = z.object({
+	/** `http://127.0.0.1:<port>/<token>`. One `GET` takes it. */
+	url: z.string().min(1),
+	/**
+	* The HOST node this URL means something on — the hub or a named agent,
+	* never a runner. {@link AddonPeerBytes.open} compares it to its own and
+	* refuses `cross-node` by name when they differ, without dialling.
+	*/
+	hostNodeId: z.string().min(1),
+	expiresAtMs: z.number().int().nonnegative(),
+	/**
+	* What the producer DECLARED the body to be, when it knows — `null` when it
+	* does not. Never `0` for unknown (D393): a consumer sizing a bound off this
+	* must be able to tell "the producer did not say" from "the body is empty".
+	*/
+	declaredBytes: z.number().int().nonnegative().nullable()
+});
+//#endregion
 //#region src/capabilities/schemas/streaming-shared.ts
 /** Shared Zod schemas used across streaming capabilities. */
 var CamProfileSchema = z.enum([
@@ -3581,11 +3631,6 @@ function createDeviceProxy(api, binding, opts) {
 		},
 		enumSensor: { getStatus: (input) => dispatch("enum-sensor", "enumSensor", "getStatus", "query", input) },
 		eventEmitter: { getStatus: (input) => dispatch("event-emitter", "eventEmitter", "getStatus", "query", input) },
-		events: {
-			getEvents: (input) => dispatch("events", "events", "getEvents", "query", input),
-			getEventThumbnail: (input) => dispatch("events", "events", "getEventThumbnail", "query", input),
-			getEventClipUrl: (input) => dispatch("events", "events", "getEventClipUrl", "query", input)
-		},
 		fanControl: {
 			setPercentage: (input) => dispatch("fan-control", "fanControl", "setPercentage", "mutation", input),
 			setPreset: (input) => dispatch("fan-control", "fanControl", "setPreset", "mutation", input),
@@ -3837,6 +3882,13 @@ function createDeviceProxy(api, binding, opts) {
 			setSettings: (input) => dispatch("ptz-autotrack", "ptzAutotrack", "setSettings", "mutation", input)
 		},
 		reboot: { reboot: (input) => dispatch("reboot", "reboot", "reboot", "mutation", input) },
+		recording: {
+			listSources: (input) => dispatch("recording", "recording", "listSources", "query", input),
+			getAvailability: (input) => dispatch("recording", "recording", "getAvailability", "query", input),
+			getDaysWithRecordings: (input) => dispatch("recording", "recording", "getDaysWithRecordings", "query", input),
+			getPlayback: (input) => dispatch("recording", "recording", "getPlayback", "query", input),
+			getPlaybackOptions: (input) => dispatch("recording", "recording", "getPlaybackOptions", "query", input)
+		},
 		recordingOnboard: {
 			getOptions: (input) => dispatch("recording-onboard", "recordingOnboard", "getOptions", "query", input),
 			setSettings: (input) => dispatch("recording-onboard", "recordingOnboard", "setSettings", "mutation", input),
@@ -3912,7 +3964,9 @@ function createDeviceProxy(api, binding, opts) {
 			listSources: (input) => dispatch("videoclips", "videoclips", "listSources", "query", input),
 			getClipPlayback: (input) => dispatch("videoclips", "videoclips", "getClipPlayback", "query", input),
 			readClipBytes: (input) => dispatch("videoclips", "videoclips", "readClipBytes", "query", input),
-			dialClipStream: (input) => dispatch("videoclips", "videoclips", "dialClipStream", "query", input)
+			offerClipBytes: (input) => dispatch("videoclips", "videoclips", "offerClipBytes", "query", input),
+			dialClipStream: (input) => dispatch("videoclips", "videoclips", "dialClipStream", "query", input),
+			getPlaybackOptions: (input) => dispatch("videoclips", "videoclips", "getPlaybackOptions", "query", input)
 		},
 		waterHeater: {
 			setTargetTemp: (input) => dispatch("water-heater", "waterHeater", "setTargetTemp", "mutation", input),
@@ -4072,25 +4126,22 @@ function createDeviceProxy(api, binding, opts) {
 			listPlates: (input) => dispatchSystem("plateGallery", "listPlates", "query", input),
 			getPlateByTrack: (input) => dispatchSystem("plateGallery", "getPlateByTrack", "query", input)
 		},
-		recording: {
-			getAvailability: (input) => dispatchSystem("recording", "getAvailability", "query", input),
-			getDaysWithRecordings: (input) => dispatchSystem("recording", "getDaysWithRecordings", "query", input),
-			getPlaybackManifest: (input) => dispatchSystem("recording", "getPlaybackManifest", "query", input),
-			getDeviceConfig: (input) => dispatchSystem("recording", "getDeviceConfig", "query", input),
-			locateSegment: (input) => dispatchSystem("recording", "locateSegment", "query", input),
-			readSegmentBytes: (input) => dispatchSystem("recording", "readSegmentBytes", "query", input),
-			readGopBytes: (input) => dispatchSystem("recording", "readGopBytes", "query", input),
-			readWindowBytes: (input) => dispatchSystem("recording", "readWindowBytes", "query", input),
-			setDeviceConfig: (input) => dispatchSystem("recording", "setDeviceConfig", "mutation", input),
-			rescanStorage: (input) => dispatchSystem("recording", "rescanStorage", "mutation", input),
-			pruneFootage: (input) => dispatchSystem("recording", "pruneFootage", "mutation", input),
-			deleteFootprint: (input) => dispatchSystem("recording", "deleteFootprint", "mutation", input),
-			renderGif: (input) => dispatchSystem("recording", "renderGif", "mutation", input),
-			renderClip: (input) => dispatchSystem("recording", "renderClip", "mutation", input),
-			getStatus: (input) => dispatchSystem("recording", "getStatus", "query", input),
-			getDeviceSettingsContribution: (input) => dispatchSystem("recording", "getDeviceSettingsContribution", "query", input),
-			getDeviceLiveContribution: (input) => dispatchSystem("recording", "getDeviceLiveContribution", "query", input),
-			applyDeviceSettingsPatch: (input) => dispatchSystem("recording", "applyDeviceSettingsPatch", "mutation", input)
+		recordingArchive: {
+			getDeviceConfig: (input) => dispatchSystem("recordingArchive", "getDeviceConfig", "query", input),
+			locateSegment: (input) => dispatchSystem("recordingArchive", "locateSegment", "query", input),
+			readSegmentBytes: (input) => dispatchSystem("recordingArchive", "readSegmentBytes", "query", input),
+			readGopBytes: (input) => dispatchSystem("recordingArchive", "readGopBytes", "query", input),
+			readWindowBytes: (input) => dispatchSystem("recordingArchive", "readWindowBytes", "query", input),
+			setDeviceConfig: (input) => dispatchSystem("recordingArchive", "setDeviceConfig", "mutation", input),
+			rescanStorage: (input) => dispatchSystem("recordingArchive", "rescanStorage", "mutation", input),
+			pruneFootage: (input) => dispatchSystem("recordingArchive", "pruneFootage", "mutation", input),
+			deleteFootprint: (input) => dispatchSystem("recordingArchive", "deleteFootprint", "mutation", input),
+			renderGif: (input) => dispatchSystem("recordingArchive", "renderGif", "mutation", input),
+			renderClip: (input) => dispatchSystem("recordingArchive", "renderClip", "mutation", input),
+			getStatus: (input) => dispatchSystem("recordingArchive", "getStatus", "query", input),
+			getDeviceSettingsContribution: (input) => dispatchSystem("recordingArchive", "getDeviceSettingsContribution", "query", input),
+			getDeviceLiveContribution: (input) => dispatchSystem("recordingArchive", "getDeviceLiveContribution", "query", input),
+			applyDeviceSettingsPatch: (input) => dispatchSystem("recordingArchive", "applyDeviceSettingsPatch", "mutation", input)
 		},
 		recordingExport: { listExports: (input) => dispatchSystem("recordingExport", "listExports", "query", input) },
 		streamBroker: {
@@ -4155,7 +4206,6 @@ var DEVICE_SCOPED_CAPS = new Set([
 	"doorbell",
 	"enum-sensor",
 	"event-emitter",
-	"events",
 	"fan-control",
 	"feature-probe",
 	"flood",
@@ -4187,6 +4237,7 @@ var DEVICE_SCOPED_CAPS = new Set([
 	"ptz",
 	"ptz-autotrack",
 	"reboot",
+	"recording",
 	"recording-onboard",
 	"recording-signal",
 	"scene-monitor",
@@ -4373,4 +4424,4 @@ function sleepCancellable(ms, signal) {
 	});
 }
 //#endregion
-export { AudioStreamPickSchema as $, DeviceType as A, createDurableState as At, optionalMethod as B, AUDIO_CHUNK_FORMATS as Bt, customAction as C, parseProfileBrokerId as Ct, ChargingStatus as D, DisposerChain as Dt, deviceCustomAction as E, SHARE_VIEW_KINDS as Et, PROVIDER_PIN_FIELD as F, WELL_KNOWN_TAB_MAP as Ft, readNodePin as G, systemMethod as H, expandAudioChunkToF32le as Ht, event as I, collectHydratedFieldEntries as It, ReadinessTimeoutError as J, toNodeId as K, expandCapMethods as L, collectHydratedFieldValues as Lt, DEFAULT_RUNTIME_STATE_DURABILITY as M, emitReadiness as Mt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as N, isEvent as Nt, DeviceFeature as O, BaseAddon as Ot, DEVICE_STATUS_METHOD as P, WELL_KNOWN_TABS as Pt, AudioChunkFormatSchema as Q, isDeviceConfigCap as R, hydrateSchema as Rt, DEVICE_CHILDREN_BATCH_MAX as S, makeSourceBrokerId as St, describeCustomActions as T, DATAPLANE_SECRET_HEADER as Tt, CAP_NODE_PIN_CONTEXT_KEY as U, isAudioChunkFormat as Ut, resolveCapMount as V, audioChunkBytesPerSample as Vt, nodePin as W, readinessKey as X, emitDownForOwnedCaps as Y, scopeKey as Z, createMirrorSource as _, SubscribeAudioChunksInputSchema as _t, asJsonObject as a, CamStreamResolutionSchema as at, deviceOpsCapability as b, SubscribeFramesResultSchema as bt, parseJsonArray as c, DecodedFrameSchema as ct, BOOT_RECOVERY_BACKOFF_MS as d, FrameHandleSchema as dt, BrokerStatsSchema as et, DEVICE_SCOPED_CAPS as f, ProfileRtspEntrySchema as ft, createLazyTrpcSource as g, StreamSourceSchema as gt, createEventBusSliceSource as h, StreamSourceEntrySchema$1 as ht, asJsonArray as i, CamStreamKindSchema as it, adminUiCapability as j, createEvent as jt, DeviceRole as k, normalizeAddonInitResult as kt, parseJsonObject as l, EncodedPacketSchema as lt, createDeviceProxy as m, ProfileSlotStatusSchema as mt, sleepCancellable as n, CAM_PROFILE_ORDER as nt, asNumber as o, CameraStreamSchema as ot, isDeviceScopedCap as p, ProfileSlotSchema as pt, ReadinessRegistry as q, asBoolean as r, CamProfileSchema as rt, asString as s, DecodedAudioChunkSchema as st, sleep as t, BrokerStatusSchema as tt, parseJsonUnknown as u, FrameHandleFormatSchema as ut, createSliceHandle as v, SubscribeAudioChunksResultSchema as vt, defineCustomActions as w, selectAssignedProfileSlots as wt, viewerUiCapability as x, makeProfileBrokerId as xt, RawStateResultSchema as y, SubscribeFramesInputSchema as yt, method as z, resolveHydratedFieldValue as zt };
+export { AudioStreamPickSchema as $, DeviceType as A, DATAPLANE_SECRET_HEADER as At, optionalMethod as B, WELL_KNOWN_TAB_MAP as Bt, customAction as C, parseProfileBrokerId as Ct, ChargingStatus as D, PEER_BYTES_STALL_MS as Dt, deviceCustomAction as E, PEER_BYTES_MAX_OUTSTANDING as Et, PROVIDER_PIN_FIELD as F, createDurableState as Ft, readNodePin as G, AUDIO_CHUNK_FORMATS as Gt, systemMethod as H, collectHydratedFieldValues as Ht, event as I, createEvent as It, ReadinessTimeoutError as J, isAudioChunkFormat as Jt, toNodeId as K, audioChunkBytesPerSample as Kt, expandCapMethods as L, emitReadiness as Lt, DEFAULT_RUNTIME_STATE_DURABILITY as M, DisposerChain as Mt, DEVICE_SETTINGS_CONTRIBUTION_METHODS as N, BaseAddon as Nt, DeviceFeature as O, PEER_BYTES_TICKET_TTL_MS as Ot, DEVICE_STATUS_METHOD as P, normalizeAddonInitResult as Pt, AudioChunkFormatSchema as Q, isDeviceConfigCap as R, isEvent as Rt, DEVICE_CHILDREN_BATCH_MAX as S, makeSourceBrokerId as St, describeCustomActions as T, PEER_BYTES_CHUNK_BYTES as Tt, CAP_NODE_PIN_CONTEXT_KEY as U, hydrateSchema as Ut, resolveCapMount as V, collectHydratedFieldEntries as Vt, nodePin as W, resolveHydratedFieldValue as Wt, readinessKey as X, emitDownForOwnedCaps as Y, scopeKey as Z, createMirrorSource as _, SubscribeAudioChunksInputSchema as _t, asJsonObject as a, CamStreamResolutionSchema as at, deviceOpsCapability as b, SubscribeFramesResultSchema as bt, parseJsonArray as c, DecodedFrameSchema as ct, BOOT_RECOVERY_BACKOFF_MS as d, FrameHandleSchema as dt, BrokerStatsSchema as et, DEVICE_SCOPED_CAPS as f, ProfileRtspEntrySchema as ft, createLazyTrpcSource as g, StreamSourceSchema as gt, createEventBusSliceSource as h, StreamSourceEntrySchema$1 as ht, asJsonArray as i, CamStreamKindSchema as it, adminUiCapability as j, SHARE_VIEW_KINDS as jt, DeviceRole as k, PeerBytesTicketSchema as kt, parseJsonObject as l, EncodedPacketSchema as lt, createDeviceProxy as m, ProfileSlotStatusSchema as mt, sleepCancellable as n, CAM_PROFILE_ORDER as nt, asNumber as o, CameraStreamSchema as ot, isDeviceScopedCap as p, ProfileSlotSchema as pt, ReadinessRegistry as q, expandAudioChunkToF32le as qt, asBoolean as r, CamProfileSchema as rt, asString as s, DecodedAudioChunkSchema as st, sleep as t, BrokerStatusSchema as tt, parseJsonUnknown as u, FrameHandleFormatSchema as ut, createSliceHandle as v, SubscribeAudioChunksResultSchema as vt, defineCustomActions as w, selectAssignedProfileSlots as wt, viewerUiCapability as x, makeProfileBrokerId as xt, RawStateResultSchema as y, SubscribeFramesInputSchema as yt, method as z, WELL_KNOWN_TABS as zt };

package/package.json

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

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

@@ -1,47 +0,0 @@
-import { z } from 'zod';
-import { type InferProvider } from './capability-definition.js';
-import { DeviceType } from '../device/device-type.js';
-declare const EventItemSchema: z.ZodObject<{
-    id: z.ZodString;
-    type: z.ZodString;
-    timestamp: z.ZodNumber;
-    label: z.ZodOptional<z.ZodString>;
-    thumbnailUrl: z.ZodOptional<z.ZodString>;
-    clipUrl: z.ZodOptional<z.ZodString>;
-    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
-export declare const eventsCapability: {
-    readonly name: "events";
-    readonly scope: "device";
-    readonly mode: "singleton";
-    readonly deviceTypes: readonly [DeviceType.Camera];
-    readonly methods: {
-        readonly getEvents: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            deviceId: z.ZodNumber;
-            from: z.ZodOptional<z.ZodNumber>;
-            to: z.ZodOptional<z.ZodNumber>;
-            limit: z.ZodOptional<z.ZodNumber>;
-        }, z.core.$strip>, z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            type: z.ZodString;
-            timestamp: z.ZodNumber;
-            label: z.ZodOptional<z.ZodString>;
-            thumbnailUrl: z.ZodOptional<z.ZodString>;
-            clipUrl: z.ZodOptional<z.ZodString>;
-            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
-        readonly getEventThumbnail: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            deviceId: z.ZodNumber;
-            eventId: z.ZodString;
-        }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
-            base64: z.ZodString;
-            contentType: z.ZodString;
-        }, z.core.$strip>>, import("./capability-definition.js").CapabilityMethodKind>;
-        readonly getEventClipUrl: import("./capability-definition.js").CapabilityMethodSchema<z.ZodObject<{
-            deviceId: z.ZodNumber;
-            eventId: z.ZodString;
-        }, z.core.$strip>, z.ZodNullable<z.ZodString>, import("./capability-definition.js").CapabilityMethodKind>;
-    };
-};
-export type IEventsProvider = InferProvider<typeof eventsCapability>;
-export { EventItemSchema };