@camstack/addon-provider-frigate 0.1.7 → 0.1.10

package/dist/addon.d.mts

@@ -0,0 +1,14 @@
+import { ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
+
+declare class FrigateProviderAddon implements ICamstackAddon, IConfigurable {
+    readonly manifest: AddonManifest;
+    private provider;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+    getConfigSchema(): ConfigUISchema;
+    getConfig(): Record<string, unknown>;
+    onConfigChange(_config: Record<string, unknown>): Promise<void>;
+}
+
+export { FrigateProviderAddon };

package/dist/addon.d.ts

@@ -0,0 +1,14 @@
+import { ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
+
+declare class FrigateProviderAddon implements ICamstackAddon, IConfigurable {
+    readonly manifest: AddonManifest;
+    private provider;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+    getConfigSchema(): ConfigUISchema;
+    getConfig(): Record<string, unknown>;
+    onConfigChange(_config: Record<string, unknown>): Promise<void>;
+}
+
+export { FrigateProviderAddon };

package/dist/index.d.mts

@@ -0,0 +1,250 @@
+export { FrigateProviderAddon } from './addon.mjs';
+import { IDeviceProvider, CamstackContext, ProviderStatus, DiscoveredDevice, IDevice, LiveEvent, DeviceType, DeviceCapabilityName, StreamOption, IDeviceCapability, DeviceState, DeviceMetadata } from '@camstack/types';
+
+interface FrigateProviderConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly url: string;
+    readonly username?: string;
+    readonly password?: string;
+    readonly mqtt?: {
+        readonly brokerUrl: string;
+        readonly username?: string;
+        readonly password?: string;
+        readonly topicPrefix?: string;
+    };
+}
+declare class FrigateProvider implements IDeviceProvider {
+    private readonly config;
+    readonly id: string;
+    readonly type = "frigate";
+    readonly name: string;
+    readonly discoveryMode: 'auto';
+    readonly ctx: CamstackContext;
+    private readonly api;
+    private mqtt;
+    private devices;
+    private readonly liveEventListeners;
+    private mqttUnsubscribe?;
+    /** Cached Frigate config, refreshed on start() and discoverDevices() */
+    private frigateConfig;
+    private go2rtcStreams;
+    private frigateHost;
+    constructor(config: FrigateProviderConfig, ctx: CamstackContext);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): ProviderStatus;
+    discoverDevices(): Promise<DiscoveredDevice[]>;
+    adoptDevice(externalId: string, _config?: Record<string, unknown>): Promise<IDevice>;
+    getDevices(): IDevice[];
+    subscribeLiveEvents(callback: (event: LiveEvent) => void): () => void;
+    private createDeviceFromCamera;
+    private getAdoptedDeviceIds;
+    private persistAdoptedDeviceId;
+}
+
+interface FrigateConfig {
+    cameras: Record<string, FrigateCameraConfig>;
+    version?: string;
+    mqtt?: {
+        enabled: boolean;
+        host?: string;
+        port?: number;
+        topic_prefix?: string;
+    };
+}
+interface FrigateCameraConfig {
+    enabled?: boolean;
+    detect?: {
+        width: number;
+        height: number;
+        fps?: number;
+        enabled?: boolean;
+    };
+    record?: {
+        enabled?: boolean;
+    };
+    snapshots?: {
+        enabled?: boolean;
+    };
+    audio?: {
+        enabled?: boolean;
+    };
+    live?: {
+        stream_name?: string;
+    };
+    onvif?: {
+        host?: string;
+    };
+    ffmpeg?: {
+        inputs?: Array<{
+            path: string;
+            roles: string[];
+        }>;
+    };
+}
+interface FrigateRawEvent {
+    id: string;
+    camera: string;
+    label: string;
+    sub_label?: string;
+    top_score: number;
+    start_time: number;
+    end_time: number | null;
+    has_snapshot: boolean;
+    has_clip: boolean;
+    data?: {
+        box?: [number, number, number, number];
+        region?: [number, number, number, number];
+        type?: 'new' | 'update' | 'end';
+    };
+    thumbnail?: string;
+}
+interface FrigateReviewItem {
+    id: string;
+    camera: string;
+    start_time: number;
+    end_time: number | null;
+    severity: 'alert' | 'detection';
+    data?: {
+        objects?: string[];
+        zones?: string[];
+        sub_labels?: string[];
+    };
+    thumb_path?: string;
+}
+interface FrigateRawRecording {
+    id?: string;
+    start_time: number;
+    end_time: number;
+    duration: number;
+    motion?: number;
+    objects?: number;
+}
+interface FrigateMotionData {
+    camera: string;
+    start_time: number;
+    end_time: number;
+}
+
+interface FrigateApiConfig {
+    baseUrl: string;
+    username?: string;
+    password?: string;
+}
+interface EventsQuery {
+    after?: number;
+    before?: number;
+    cameras?: string;
+    limit?: number;
+    labels?: string;
+}
+interface ReviewQuery {
+    after?: number;
+    before?: number;
+    cameras?: string;
+    limit?: number;
+}
+interface MotionQuery {
+    after: number;
+    before: number;
+    cameras?: string;
+}
+interface TestConnectionResult {
+    success: boolean;
+    version?: string;
+    cameraCount?: number;
+    error?: string;
+}
+declare class FrigateApiClient {
+    private readonly config;
+    private readonly baseUrl;
+    private authToken;
+    private authHeader;
+    constructor(config: FrigateApiConfig);
+    private authenticate;
+    private buildHeaders;
+    private request;
+    private requestBuffer;
+    private requestText;
+    getConfig(): Promise<FrigateConfig>;
+    getGo2rtcStreams(): Promise<Record<string, unknown>>;
+    getEvents(params: EventsQuery): Promise<FrigateRawEvent[]>;
+    getReviewItems(params: ReviewQuery): Promise<FrigateReviewItem[]>;
+    getRecordings(camera: string, after: number, before: number): Promise<FrigateRawRecording[]>;
+    getMotionActivity(params: MotionQuery): Promise<FrigateMotionData[]>;
+    getLatestSnapshot(camera: string): Promise<Buffer>;
+    getEventThumbnail(eventId: string): Promise<Buffer>;
+    getEventSnapshot(eventId: string): Promise<Buffer>;
+    getEventClip(eventId: string): Promise<Buffer>;
+    getRecordingThumbnail(camera: string, timestampSec: number): Promise<Buffer>;
+    proxyWhepSdp(streamName: string, sdpOffer: string): Promise<string>;
+    getPtzInfo(camera: string): Promise<{
+        features?: string[];
+        presets?: string[];
+    } | null>;
+    ptzCommand(camera: string, command: string, params?: Record<string, unknown>): Promise<void>;
+    testConnection(): Promise<TestConnectionResult>;
+}
+
+interface FrigateMqttConfig {
+    brokerUrl: string;
+    username?: string;
+    password?: string;
+    topicPrefix: string;
+}
+interface MqttStatus {
+    connected: boolean;
+    eventCount: number;
+}
+declare class FrigateMqttClient {
+    private readonly config;
+    private readonly cameraResolutions;
+    private client;
+    private readonly listeners;
+    private eventCount;
+    constructor(config: FrigateMqttConfig, cameraResolutions: Map<string, {
+        width: number;
+        height: number;
+    }>);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribe(callback: (event: LiveEvent) => void): () => void;
+    get status(): MqttStatus;
+}
+
+interface FrigateDeviceConfig {
+    readonly cameraName: string;
+    readonly providerId: string;
+    readonly detectWidth: number;
+    readonly detectHeight: number;
+    readonly audioEnabled: boolean;
+    readonly recordEnabled: boolean;
+    readonly ptzEnabled: boolean;
+    readonly streams: StreamOption[];
+    readonly frigateHost: string;
+}
+declare class FrigateDevice implements IDevice {
+    private readonly config;
+    private readonly api;
+    readonly id: string;
+    readonly name: string;
+    readonly providerId: string;
+    readonly type: DeviceType;
+    readonly capabilities: DeviceCapabilityName[];
+    private readonly capabilityMap;
+    readonly ctx: CamstackContext;
+    constructor(config: FrigateDeviceConfig, api: FrigateApiClient, ctx: CamstackContext);
+    getCapability<T extends IDeviceCapability>(cap: DeviceCapabilityName): T | null;
+    hasCapability(cap: DeviceCapabilityName): boolean;
+    getState(): DeviceState;
+    getMetadata(): DeviceMetadata;
+    private createCamera;
+    private createMotionSensor;
+    private createObjectDetector;
+    private createEvents;
+    private createRecording;
+    private createAudioDetector;
+}
+
+export { type EventsQuery, FrigateApiClient, type FrigateApiConfig, type FrigateCameraConfig, type FrigateConfig, FrigateDevice, type FrigateDeviceConfig, type FrigateMotionData, FrigateMqttClient, type FrigateMqttConfig, FrigateProvider, type FrigateProviderConfig, type FrigateRawEvent, type FrigateRawRecording, type FrigateReviewItem, type MotionQuery, type MqttStatus, type ReviewQuery, type TestConnectionResult };

package/dist/index.d.ts

@@ -0,0 +1,250 @@
+export { FrigateProviderAddon } from './addon.js';
+import { IDeviceProvider, CamstackContext, ProviderStatus, DiscoveredDevice, IDevice, LiveEvent, DeviceType, DeviceCapabilityName, StreamOption, IDeviceCapability, DeviceState, DeviceMetadata } from '@camstack/types';
+
+interface FrigateProviderConfig {
+    readonly id: string;
+    readonly name: string;
+    readonly url: string;
+    readonly username?: string;
+    readonly password?: string;
+    readonly mqtt?: {
+        readonly brokerUrl: string;
+        readonly username?: string;
+        readonly password?: string;
+        readonly topicPrefix?: string;
+    };
+}
+declare class FrigateProvider implements IDeviceProvider {
+    private readonly config;
+    readonly id: string;
+    readonly type = "frigate";
+    readonly name: string;
+    readonly discoveryMode: 'auto';
+    readonly ctx: CamstackContext;
+    private readonly api;
+    private mqtt;
+    private devices;
+    private readonly liveEventListeners;
+    private mqttUnsubscribe?;
+    /** Cached Frigate config, refreshed on start() and discoverDevices() */
+    private frigateConfig;
+    private go2rtcStreams;
+    private frigateHost;
+    constructor(config: FrigateProviderConfig, ctx: CamstackContext);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): ProviderStatus;
+    discoverDevices(): Promise<DiscoveredDevice[]>;
+    adoptDevice(externalId: string, _config?: Record<string, unknown>): Promise<IDevice>;
+    getDevices(): IDevice[];
+    subscribeLiveEvents(callback: (event: LiveEvent) => void): () => void;
+    private createDeviceFromCamera;
+    private getAdoptedDeviceIds;
+    private persistAdoptedDeviceId;
+}
+
+interface FrigateConfig {
+    cameras: Record<string, FrigateCameraConfig>;
+    version?: string;
+    mqtt?: {
+        enabled: boolean;
+        host?: string;
+        port?: number;
+        topic_prefix?: string;
+    };
+}
+interface FrigateCameraConfig {
+    enabled?: boolean;
+    detect?: {
+        width: number;
+        height: number;
+        fps?: number;
+        enabled?: boolean;
+    };
+    record?: {
+        enabled?: boolean;
+    };
+    snapshots?: {
+        enabled?: boolean;
+    };
+    audio?: {
+        enabled?: boolean;
+    };
+    live?: {
+        stream_name?: string;
+    };
+    onvif?: {
+        host?: string;
+    };
+    ffmpeg?: {
+        inputs?: Array<{
+            path: string;
+            roles: string[];
+        }>;
+    };
+}
+interface FrigateRawEvent {
+    id: string;
+    camera: string;
+    label: string;
+    sub_label?: string;
+    top_score: number;
+    start_time: number;
+    end_time: number | null;
+    has_snapshot: boolean;
+    has_clip: boolean;
+    data?: {
+        box?: [number, number, number, number];
+        region?: [number, number, number, number];
+        type?: 'new' | 'update' | 'end';
+    };
+    thumbnail?: string;
+}
+interface FrigateReviewItem {
+    id: string;
+    camera: string;
+    start_time: number;
+    end_time: number | null;
+    severity: 'alert' | 'detection';
+    data?: {
+        objects?: string[];
+        zones?: string[];
+        sub_labels?: string[];
+    };
+    thumb_path?: string;
+}
+interface FrigateRawRecording {
+    id?: string;
+    start_time: number;
+    end_time: number;
+    duration: number;
+    motion?: number;
+    objects?: number;
+}
+interface FrigateMotionData {
+    camera: string;
+    start_time: number;
+    end_time: number;
+}
+
+interface FrigateApiConfig {
+    baseUrl: string;
+    username?: string;
+    password?: string;
+}
+interface EventsQuery {
+    after?: number;
+    before?: number;
+    cameras?: string;
+    limit?: number;
+    labels?: string;
+}
+interface ReviewQuery {
+    after?: number;
+    before?: number;
+    cameras?: string;
+    limit?: number;
+}
+interface MotionQuery {
+    after: number;
+    before: number;
+    cameras?: string;
+}
+interface TestConnectionResult {
+    success: boolean;
+    version?: string;
+    cameraCount?: number;
+    error?: string;
+}
+declare class FrigateApiClient {
+    private readonly config;
+    private readonly baseUrl;
+    private authToken;
+    private authHeader;
+    constructor(config: FrigateApiConfig);
+    private authenticate;
+    private buildHeaders;
+    private request;
+    private requestBuffer;
+    private requestText;
+    getConfig(): Promise<FrigateConfig>;
+    getGo2rtcStreams(): Promise<Record<string, unknown>>;
+    getEvents(params: EventsQuery): Promise<FrigateRawEvent[]>;
+    getReviewItems(params: ReviewQuery): Promise<FrigateReviewItem[]>;
+    getRecordings(camera: string, after: number, before: number): Promise<FrigateRawRecording[]>;
+    getMotionActivity(params: MotionQuery): Promise<FrigateMotionData[]>;
+    getLatestSnapshot(camera: string): Promise<Buffer>;
+    getEventThumbnail(eventId: string): Promise<Buffer>;
+    getEventSnapshot(eventId: string): Promise<Buffer>;
+    getEventClip(eventId: string): Promise<Buffer>;
+    getRecordingThumbnail(camera: string, timestampSec: number): Promise<Buffer>;
+    proxyWhepSdp(streamName: string, sdpOffer: string): Promise<string>;
+    getPtzInfo(camera: string): Promise<{
+        features?: string[];
+        presets?: string[];
+    } | null>;
+    ptzCommand(camera: string, command: string, params?: Record<string, unknown>): Promise<void>;
+    testConnection(): Promise<TestConnectionResult>;
+}
+
+interface FrigateMqttConfig {
+    brokerUrl: string;
+    username?: string;
+    password?: string;
+    topicPrefix: string;
+}
+interface MqttStatus {
+    connected: boolean;
+    eventCount: number;
+}
+declare class FrigateMqttClient {
+    private readonly config;
+    private readonly cameraResolutions;
+    private client;
+    private readonly listeners;
+    private eventCount;
+    constructor(config: FrigateMqttConfig, cameraResolutions: Map<string, {
+        width: number;
+        height: number;
+    }>);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    subscribe(callback: (event: LiveEvent) => void): () => void;
+    get status(): MqttStatus;
+}
+
+interface FrigateDeviceConfig {
+    readonly cameraName: string;
+    readonly providerId: string;
+    readonly detectWidth: number;
+    readonly detectHeight: number;
+    readonly audioEnabled: boolean;
+    readonly recordEnabled: boolean;
+    readonly ptzEnabled: boolean;
+    readonly streams: StreamOption[];
+    readonly frigateHost: string;
+}
+declare class FrigateDevice implements IDevice {
+    private readonly config;
+    private readonly api;
+    readonly id: string;
+    readonly name: string;
+    readonly providerId: string;
+    readonly type: DeviceType;
+    readonly capabilities: DeviceCapabilityName[];
+    private readonly capabilityMap;
+    readonly ctx: CamstackContext;
+    constructor(config: FrigateDeviceConfig, api: FrigateApiClient, ctx: CamstackContext);
+    getCapability<T extends IDeviceCapability>(cap: DeviceCapabilityName): T | null;
+    hasCapability(cap: DeviceCapabilityName): boolean;
+    getState(): DeviceState;
+    getMetadata(): DeviceMetadata;
+    private createCamera;
+    private createMotionSensor;
+    private createObjectDetector;
+    private createEvents;
+    private createRecording;
+    private createAudioDetector;
+}
+
+export { type EventsQuery, FrigateApiClient, type FrigateApiConfig, type FrigateCameraConfig, type FrigateConfig, FrigateDevice, type FrigateDeviceConfig, type FrigateMotionData, FrigateMqttClient, type FrigateMqttConfig, FrigateProvider, type FrigateProviderConfig, type FrigateRawEvent, type FrigateRawRecording, type FrigateReviewItem, type MotionQuery, type MqttStatus, type ReviewQuery, type TestConnectionResult };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-provider-frigate",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "description": "Frigate NVR device provider addon for CamStack",
   "keywords": [
     "camstack",
@@ -21,9 +21,9 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "types": "./dist/index.d.ts",
       "import": "./dist/index.mjs",
-      "require": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },