@camstack/types 0.1.14 → 0.1.15

package/dist/interfaces/stream-broker.d.ts

@@ -1,10 +1,72 @@
+import { z } from 'zod';
+import type { FrameFormat } from '../types/io.js';
+export declare const DecoderStatsSchema: z.ZodObject<{
+    inputFps: z.ZodNumber;
+    outputFps: z.ZodNumber;
+    avgDecodeTimeMs: z.ZodNumber;
+    droppedFrames: z.ZodNumber;
+}, z.core.$strip>;
+export declare const DecoderSessionConfigSchema: z.ZodObject<{
+    codec: z.ZodString;
+    maxFps: z.ZodDefault<z.ZodNumber>;
+    outputFormat: z.ZodDefault<z.ZodEnum<{
+        jpeg: "jpeg";
+        rgb: "rgb";
+        bgr: "bgr";
+        yuv420: "yuv420";
+        gray: "gray";
+    }>>;
+    scale: z.ZodDefault<z.ZodNumber>;
+    width: z.ZodOptional<z.ZodNumber>;
+    height: z.ZodOptional<z.ZodNumber>;
+    deviceId: z.ZodOptional<z.ZodNumber>;
+    tag: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
 export type Unsubscribe = () => void;
+/**
+ * Discriminator for `StreamSource.type`. Values that the broker
+ * understands today:
+ *
+ * - `'rtsp'`     — pull mode. Broker connects to a `rtsp://` URL,
+ *                   demuxes RTP, exposes raw RTP via `onVideoRtp`.
+ * - `'rtmp'`     — pull mode. Broker connects to a `rtmp://` URL,
+ *                   demuxes flv into AnnexB packets. No source RTP
+ *                   available (RTMP carries no RTP), so the WebRTC
+ *                   path falls back to AnnexB → writeVideoNals.
+ *                   Reserved — implementation pending.
+ * - `'push'`     — push mode. Provider addon delivers AnnexB packets
+ *                   via `pushEncodedPacket()` (Reolink Baichuan,
+ *                   Frigate event streams, etc.).
+ * - `'push-rtp'` — push mode with raw RTP packets. Provider addon
+ *                   delivers source RTP via `pushVideoRtp()` AND
+ *                   AnnexB-equivalents via `pushEncodedPacket()` so
+ *                   downstream consumers (decoder, restreamer) keep
+ *                   working. Lets the WebRTC path use the H.265
+ *                   repacketizer for push-mode H.265 streams. Reserved
+ *                   — implementation pending.
+ * - `'placeholder'` — silent black-image placeholder reader.
+ *
+ * String type instead of a literal union so addons remain free to
+ * add new source types — the broker's switch statement falls through
+ * to "data is pushed externally" for unknown values.
+ */
+export type StreamSourceType = 'rtsp' | 'rtmp' | 'push' | 'push-rtp' | 'rfc4571' | 'placeholder' | (string & {});
 export interface StreamSource {
-    readonly type: string;
+    readonly type: StreamSourceType;
+    /** Stream URL — required for pull-based sources (rtsp, rtmp). Not used for push sources. */
     readonly url: string;
     readonly videoCodec?: string;
     readonly audioCodec?: string;
     readonly metadata?: Readonly<Record<string, unknown>>;
+    /**
+     * Push-source flag — when true, a stall in the input stream is
+     * treated as a valid suspension (battery cameras intentionally go
+     * silent between motion events) rather than an error. The broker
+     * stops emitting the black-image placeholder and pauses the watchdog
+     * until the next packet arrives. Default: false (legacy behaviour —
+     * stall is an error).
+     */
+    readonly allowStall?: boolean;
 }
 export interface StreamSourceOption {
     readonly id: string;
@@ -23,12 +85,40 @@ export interface EncodedPacket {
     readonly dts: number;
     readonly keyframe: boolean;
     readonly codec: string;
+    /**
+     * `true` when the packet was synthesized by the broker's placeholder
+     * pump (state-aware "RECONNECTING" / "SLEEPING" / etc. keyframes
+     * pushed at 1Hz while no real RTP is flowing). Consumers that
+     * accumulate per-stream codec state (sticky SPS/PPS, decoder config)
+     * MUST treat these as throwaway: the placeholder is a different
+     * resolution and parameter set than the live camera, so caching its
+     * SPS/PPS and prepending them to real keyframes silently corrupts
+     * the decoder state and freezes the WebRTC viewer on the last
+     * placeholder until the consumer is re-created. Absent on packets
+     * produced from real source data.
+     */
+    readonly isPlaceholder?: boolean;
+}
+/**
+ * Audio metadata declared by push-source providers before they emit the
+ * first audio `EncodedPacket`. Mirrors the slice of an SDP audio track
+ * the broker actually consumes — `codec` is canonical lowercase
+ * ('aac' | 'opus' | 'pcmu' | 'pcma' | ...).
+ *
+ * `extraData` carries codec-specific config bytes (e.g. AAC
+ * AudioSpecificConfig) when the codec needs them at decoder-init time.
+ */
+export interface PushAudioInfo {
+    readonly codec: string;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly extraData?: Uint8Array;
 }
 export interface DecodedFrame {
     readonly data: Buffer;
     readonly width: number;
     readonly height: number;
-    readonly format: 'jpeg' | 'rgb' | 'yuv420';
+    readonly format: FrameFormat;
     readonly timestamp: number;
 }
 export interface DecodedAudioChunk {
@@ -39,8 +129,20 @@ export interface DecodedAudioChunk {
 }
 export interface DecodeOptions {
     readonly maxFps?: number;
-    readonly format?: 'jpeg' | 'rgb' | 'yuv420';
+    readonly format?: FrameFormat;
     readonly scale?: number;
+    /**
+     * Caller identity tag (Phase 10). Surfaced by `listClients` so
+     * operators can tell who's holding the broker open. Short and stable:
+     * `motion`, `detection`, `snapshot`, `webrtc:<sessionId>`,
+     * `benchmark`. Missing tag → recorded as `'unknown'` with a broker-
+     * side warn log.
+     */
+    readonly tag?: string;
+}
+export interface AudioSubscribeOptions {
+    /** Caller identity tag. See DecodeOptions.tag. */
+    readonly tag?: string;
 }
 export type BrokerStatus = 'idle' | 'connecting' | 'streaming' | 'error' | 'stopped';
 export interface BrokerStats {
@@ -50,43 +152,209 @@ export interface BrokerStats {
     readonly encodedSubscribers: number;
     readonly decodedSubscribers: number;
     readonly uptimeMs: number;
+    /** Measured bitrate in kbps (averaged over 2s window) */
+    readonly bitrateKbps: number;
+    /** Time between last two keyframes in ms (IDR interval) */
+    readonly idrIntervalMs: number;
+    /** Detected video codec (h264, h265) */
+    readonly codec?: string;
+    /** Total bytes received since broker start */
+    readonly totalBytes: number;
+    /** Total encoded packets received since broker start */
+    readonly packetCount: number;
+    /** Number of connected RTSP restream clients */
+    readonly rtspClients: number;
+    /** Number of connected TCP pipe clients */
+    readonly pipeClients: number;
+    /** Pre-buffer configured duration in seconds */
+    readonly preBufferSec: number;
+    /** Pre-buffer actual buffered duration in ms */
+    readonly preBufferMs: number;
+    /** Pre-buffer packet count */
+    readonly preBufferPackets: number;
+    /**
+     * Moleculer node id of the decoder provider currently servicing this
+     * stream's decoded subscribers. `null` until the deferred decoder is
+     * created (no decoded clients yet, or codec not detected).
+     */
+    readonly decoderNodeId: string | null;
+    /**
+     * Detected audio track parameters from the RTSP DESCRIBE / SDP. Null
+     * when the stream has no audio track or the broker is still in cold
+     * start. `supported` reflects whether the local native + ffmpeg-based
+     * decoder pipeline can produce PCM chunks for downstream consumers
+     * (audio-analyzer). When `false`, the codec is detected but skipped.
+     */
+    readonly audio?: {
+        readonly codec: string;
+        readonly sampleRate: number;
+        readonly channels: number;
+        readonly supported: boolean;
+    } | null;
 }
 export interface IStreamBroker {
     readonly deviceId: string;
     readonly status: BrokerStatus;
+    readonly suspended: boolean;
     start(source: StreamSource): Promise<void>;
     stop(): Promise<void>;
+    /**
+     * Push an encoded packet into the broker from an external source.
+     *
+     * Used by camera provider addons that deliver media data directly
+     * (e.g. Reolink Baichuan protocol, Frigate event streams) instead
+     * of exposing an RTSP URL for the broker to pull from.
+     *
+     * The broker fans out the packet to all consumers: pre-buffer, RTSP
+     * restreamer, TCP pipe, decoder sessions, and encoded subscribers.
+     */
+    pushEncodedPacket(packet: EncodedPacket): void;
+    /**
+     * Push-source audio metadata. Push providers (Reolink Baichuan,
+     * Frigate, etc.) call this BEFORE the first audio EncodedPacket so
+     * the broker can wire the audio-codec capability — RTSP sources get
+     * the same data from the SDP audio track. Repeat calls update the
+     * declared codec; calling with `null` retracts (broker tears down
+     * any audio decode session).
+     *
+     * Typical Reolink Baichuan audio: AAC-LC 16 kHz mono. Cameras that
+     * push G.711 should still call this so the broker can bypass the
+     * codec cap for the supported native codecs.
+     */
+    pushAudioInfo?(info: PushAudioInfo | null): void;
+    /**
+     * Push a raw video RTP packet from an external source (used by
+     * `'push-rtp'`-typed sources, e.g. Reolink Baichuan adapter that
+     * synthesizes RTP from its packetizer-friendly access units). The
+     * broker fans out to `onVideoRtp` subscribers, including the
+     * WebRTC server's H.265 repacketizer path.
+     *
+     * Sources that don't carry per-packet RTP MAY ignore this entirely
+     * and call only `pushEncodedPacket`. Implementations are free to
+     * be a no-op when no RTP subscribers exist.
+     */
+    pushVideoRtp?(rtpData: Buffer): void;
     onEncodedData(callback: (packet: EncodedPacket) => void): Unsubscribe;
+    /**
+     * Subscribe to source video RTP packets (raw on-wire bytes, before
+     * depacketization). Used by the WebRTC server's H.265 path to feed
+     * a packet-level repacketizer that preserves the original RTP header
+     * layout — Chrome's HEVC depacketizer is sensitive to it.
+     *
+     * Sources that don't have an underlying RTP wire (e.g. Frigate event
+     * streams that call `pushEncodedPacket`) MAY register zero callbacks
+     * and emit nothing.
+     */
+    onVideoRtp(callback: (rtpData: Buffer) => void): Unsubscribe;
+    /**
+     * Codec parameter sets harvested from the camera's SDP (sprop-vps /
+     * sprop-sps / sprop-pps). Cameras like Reolink high-profile streams
+     * publish VPS/SPS/PPS only via SDP — Chrome's HEVC decoder needs them
+     * to initialise. Returns null when the broker hasn't connected yet
+     * or the camera ships param sets in-band.
+     */
+    getSdpParameterSets(): ReadonlyArray<Buffer> | null;
+    /**
+     * Subscribe to SDP-derived VPS/SPS/PPS deliveries. Fires once
+     * synchronously if the broker already has them (late-subscriber
+     * shape), and again every time `onVideoTrack` repopulates them on a
+     * reader rebuild. Used by the WebRTC server's H.265 path so a
+     * session created during the wake-up window — when
+     * `getSdpParameterSets()` still returns null — can seed its
+     * `H265Repacketizer` once the camera's first RTP+SDP arrive.
+     */
+    onSdpParameterSets(callback: (ps: ReadonlyArray<Buffer>) => void): Unsubscribe;
+    /**
+     * Source type as configured at `start()` — see `StreamSourceType`
+     * for the supported values. `null` before `start()` resolves.
+     */
+    getSourceType(): StreamSourceType | null;
+    /**
+     * True when the broker can emit source RTP packets via
+     * `onVideoRtp` — i.e. the source is RTSP (pull) or push-rtp.
+     * RTMP and bare push (AnnexB-only) sources return false.
+     * Routing decisions in the WebRTC server (e.g. "use the H.265
+     * repacketizer") should consult this rather than string-comparing
+     * the source type.
+     */
+    isRtpSource(): boolean;
+    /**
+     * Subscribe to decoded frames. Phase 10 added `options.tag` — a short
+     * caller-identity string (`motion`, `detection`, `snapshot`,
+     * `webrtc:<sessionId>`, `benchmark`) used by `listClients` so
+     * operators can see who is holding the broker open. Omitted tag
+     * yields a `'unknown'` entry with a warn log — not silently accepted.
+     */
     onDecodedFrame(callback: (frame: DecodedFrame) => void, options?: DecodeOptions): Unsubscribe;
-    onDecodedAudioChunk(callback: (chunk: DecodedAudioChunk) => void): Unsubscribe;
+    /** Subscribe to decoded audio chunks. `options.tag` mirrors `onDecodedFrame`. */
+    onDecodedAudioChunk(callback: (chunk: DecodedAudioChunk) => void, options?: AudioSubscribeOptions): Unsubscribe;
     getStats(): BrokerStats;
     getLocalStreamUrl(): string;
+    /** Get the pre-buffer: recent encoded packets starting from last keyframe. */
+    getPreBuffer(): readonly EncodedPacket[];
+    /** Set the pre-buffer duration in seconds (0 to disable, max 30). */
+    setPreBufferDuration(seconds: number): void;
+    /** Get the current pre-buffer duration in seconds. */
+    getPreBufferDuration(): number;
+    setPreBufferEnabled(enabled: boolean): void;
 }
 /**
  * Manager for stream brokers — the server interacts with this interface,
  * while the concrete implementation lives in the addon-stream-broker package.
  */
-export interface IStreamBrokerManager {
-    createBroker(brokerId: string, source: StreamSource): Promise<IStreamBroker>;
-    getBroker(brokerId: string): IStreamBroker | undefined;
-    destroyBroker(brokerId: string): Promise<void>;
-    destroyBrokersForDevice(deviceId: string): Promise<void>;
-    listBrokers(): readonly IStreamBroker[];
-    destroyAll(): Promise<void>;
-    setRestreamers(restreamers: readonly unknown[]): void;
-    getRestreamers(): readonly unknown[];
+/** Per-broker RTSP restream entry (absorbed from the former rtsp-restream capability). */
+export interface RtspRestreamEntry {
+    readonly brokerId: string;
+    readonly url: string;
+    readonly mutedUrl: string;
+    readonly enabled: boolean;
 }
-export type CameraPriority = 'always-on' | 'default';
-export type CameraPhase = 'watching' | 'active';
+/** Flat cap-shaped broker record returned by `listBrokers()`. */
+export interface BrokerListEntry {
+    readonly brokerId: string;
+    readonly status: string;
+    readonly inputFps: number;
+    readonly decodeFps: number;
+    readonly encodedSubscribers: number;
+    readonly decodedSubscribers: number;
+    readonly uptimeMs: number;
+    readonly bitrateKbps: number;
+    readonly idrIntervalMs: number;
+    readonly codec?: string;
+    readonly totalBytes: number;
+    readonly packetCount: number;
+    readonly rtspClients: number;
+    readonly pipeClients: number;
+    readonly preBufferSec: number;
+    readonly preBufferMs: number;
+    readonly preBufferPackets: number;
+}
+/**
+ * Phase the runner's per-camera state machine occupies. `'idle'` is the
+ * `detectionMode === 'disabled'` resting state — runner registered the
+ * camera but never subscribed to detection frames. The other 4 are the
+ * historical motion-gated states; their transitions are now driven by
+ * `detectionMode` ('always-on' starts in 'active', 'on-motion' starts
+ * in 'watching').
+ */
+export type CameraPhase = 'idle' | 'watching' | 'active' | 'paused' | 'load-shed';
 export interface CameraDetectionConfig {
     readonly enabled: boolean;
-    readonly priority: CameraPriority;
-    readonly pipeline: import('../types/pipeline.js').PipelineConfig;
+    readonly pipelineEnabled: boolean;
+    /** Motion sources that activate this camera's pipeline. At least one. */
+    readonly motionSources: import('./pipeline-orchestrator-capability.js').OrchestrationMotionSources;
     readonly motionStreamId: string;
     readonly detectionStreamId: string;
     readonly motionFps: number;
     readonly detectionFps: number;
     readonly motionCooldownMs: number;
     readonly audioStreamId?: string;
+    /**
+     * Operator-facing scheduling modes. Forwarded to `RunnerCameraConfig`;
+     * the runner uses these to gate its substream subscribers + phase
+     * machine. See `PipelinePhaseMode` for the semantics.
+     */
+    readonly detectionMode: import('../device/device-profile.js').PipelinePhaseMode;
+    readonly audioMode: import('../device/device-profile.js').PipelinePhaseMode;
 }
 //# sourceMappingURL=stream-broker.d.ts.map

package/dist/interfaces/stream-broker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-broker.d.ts","sourceRoot":"","sources":["../../src/interfaces/stream-broker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stream-broker.d.ts","sourceRoot":"","sources":["../../src/interfaces/stream-broker.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/webrtc-provider.d.ts

@@ -1,4 +1,5 @@
 import type { EncodedPacket } from './stream-broker.js';
+import type { WebrtcClientHints } from '../capabilities/webrtc.cap.js';
 export interface IWebRtcProvider {
     readonly id: string;
     readonly name: string;
@@ -7,5 +8,28 @@ export interface IWebRtcProvider {
     registerStream(streamId: string, codec: string): Promise<void>;
     pushPacket(streamId: string, packet: EncodedPacket): void;
     unregisterStream(streamId: string): Promise<void>;
+    /**
+     * Server-offer signaling: create a session and return the server SDP
+     * offer. Single-object signature matches `InferProvider<>` so the
+     * generated cap-router can dispatch directly. `hints` is optional
+     * client metadata (viewport, downlink) the provider can use to pick
+     * the best native source.
+     */
+    createSession?(input: {
+        streamId: string;
+        hints?: WebrtcClientHints;
+    }): Promise<{
+        sessionId: string;
+        sdpOffer: string;
+    }>;
+    /** Server-offer signaling: accept the client SDP answer for a session. */
+    handleAnswer?(input: {
+        sessionId: string;
+        sdpAnswer: string;
+    }): Promise<void>;
+    /** Explicitly close a WebRTC session (called on client disconnect). */
+    closeSession?(input: {
+        sessionId: string;
+    }): Promise<void>;
 }
 //# sourceMappingURL=webrtc-provider.d.ts.map

package/dist/interfaces/webrtc-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webrtc-provider.d.ts","sourceRoot":"","sources":["../../src/interfaces/webrtc-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAChE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACzC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACzD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD"}
+{"version":3,"file":"webrtc-provider.d.ts","sourceRoot":"","sources":["../../src/interfaces/webrtc-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAEtE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAChE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACzC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9D,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACzD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxH,0EAA0E;IAC1E,YAAY,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7E,uEAAuE;IACvE,YAAY,CAAC,CAAC,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3D"}

package/dist/node.d.ts

@@ -0,0 +1,6 @@
+export { ensureBinary, downloadBinary, findInPath, getPlatformInfo, buildBinaryPath, } from './deps/binary-downloader.js';
+export type { PlatformInfo } from './deps/binary-downloader.js';
+export { ensureFfmpeg, getFfmpegDownloadUrl } from './deps/ffmpeg-downloader.js';
+export { ensurePython, installPythonPackages, installPythonRequirements, getPythonDownloadUrl, PYTHON_VERSION, } from './deps/python-downloader.js';
+export { FilesystemStorageProvider } from './storage/filesystem-storage-provider.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,eAAe,EACf,eAAe,GAChB,MAAM,6BAA6B,CAAA;AACpC,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAChF,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,GACf,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAA"}