@camstack/types 0.1.1 → 0.1.3

package/dist/interfaces/storage.d.ts

@@ -0,0 +1,174 @@
+/**
+ * All location types that storage providers can serve.
+ * Each type maps to a logical category of files.
+ * A storage provider declares which location types it supports.
+ */
+export type StorageLocationType = 'recordings-high' | 'recordings-low' | 'recordings-clips' | 'event-images' | 'models' | 'addons-data' | 'cache' | 'logs';
+/** All location types as an array (for iteration) */
+export declare const STORAGE_LOCATION_TYPES: readonly StorageLocationType[];
+/** Default subdirectory names for filesystem storage */
+export declare const DEFAULT_LOCATION_SUBDIRS: Readonly<Record<StorageLocationType, string>>;
+/**
+ * A storage provider serves file-based storage for one or more location types.
+ * Multiple providers can coexist (local filesystem, NAS, S3, etc.).
+ * Each addon/system setting selects which provider to use per location type.
+ */
+export interface IStorageProvider {
+    /** Unique provider ID (e.g., 'local', 'nas-synology', 's3-aws') */
+    readonly id: string;
+    /** Human-readable name (e.g., 'Local Filesystem', 'Synology NAS') */
+    readonly name: string;
+    /** Which location types this provider serves */
+    readonly supportedLocations: readonly StorageLocationType[];
+    /** Resolve an absolute path/URL for a file within a location */
+    resolve(location: StorageLocationType, relativePath: string): string;
+    /** Write file data */
+    write(location: StorageLocationType, relativePath: string, data: Buffer | NodeJS.ReadableStream): Promise<void>;
+    /** Read file data */
+    read(location: StorageLocationType, relativePath: string): Promise<Buffer>;
+    /** Check if a file exists */
+    exists(location: StorageLocationType, relativePath: string): Promise<boolean>;
+    /** List files/directories under a prefix within a location */
+    list(location: StorageLocationType, prefix?: string): Promise<readonly string[]>;
+    /** Delete a file */
+    delete(location: StorageLocationType, relativePath: string): Promise<void>;
+    /** Get available space in bytes, null if unknown (e.g., S3) */
+    getAvailableSpace(location: StorageLocationType): Promise<number | null>;
+    /** Lifecycle */
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+/**
+ * All named collections that the settings backend manages.
+ * Each collection maps to a logical table/bucket in the backend.
+ */
+export type SettingsCollection = 'system-settings' | 'addon-settings' | 'provider-settings' | 'device-settings' | 'detection-events' | 'audio-levels' | 'track-trails' | 'recording-segments' | 'recording-thumbnails' | 'recording-policies' | 'recording-storage-config' | 'recording-cleanup-queue' | 'known-faces';
+/**
+ * Settings backend — persistent key-value and document storage.
+ * Default implementation: SQLite. Can be replaced by Postgres, etc.
+ */
+export interface ISettingsBackend {
+    /** Get a single value by key from a collection */
+    get(collection: SettingsCollection, key: string): Promise<unknown>;
+    /** Set a value by key in a collection (upsert) */
+    set(collection: SettingsCollection, key: string, value: unknown): Promise<void>;
+    /** Get all entries matching an optional filter */
+    query(collection: SettingsCollection, filter?: QueryFilter): Promise<readonly SettingsRecord[]>;
+    /** Insert a new record */
+    insert(collection: SettingsCollection, record: SettingsRecord): Promise<void>;
+    /** Update an existing record by ID */
+    update(collection: SettingsCollection, id: string, data: Record<string, unknown>): Promise<void>;
+    /** Delete a record by key/ID */
+    delete(collection: SettingsCollection, key: string): Promise<void>;
+    /** Count entries in a collection */
+    count(collection: SettingsCollection, filter?: QueryFilter): Promise<number>;
+    /** Check if a collection is empty (used for first-boot detection) */
+    isEmpty(collection: SettingsCollection): Promise<boolean>;
+    /** Lifecycle */
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface SettingsRecord {
+    readonly id: string;
+    readonly data: Record<string, unknown>;
+}
+export interface QueryFilter {
+    where?: Record<string, unknown>;
+    whereIn?: Record<string, unknown[]>;
+    whereBetween?: Record<string, [unknown, unknown]>;
+    orderBy?: {
+        field: string;
+        direction: 'asc' | 'desc';
+    };
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Embeddings backend — vector storage with approximate nearest neighbor search.
+ * Used for CLIP frame search, face recognition, plate matching.
+ * Default implementation: HNSW (usearch/hnswlib). Can be replaced by Qdrant, etc.
+ */
+export interface IEmbeddingsBackend {
+    /** Create or open a named vector index */
+    openIndex(name: string, dimensions: number): Promise<IVectorIndex>;
+    /** List all index names */
+    listIndexes(): Promise<readonly string[]>;
+    /** Delete an index and its data */
+    deleteIndex(name: string): Promise<void>;
+    /** Lifecycle */
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+}
+export interface IVectorIndex {
+    /** Index name */
+    readonly name: string;
+    /** Vector dimensions */
+    readonly dimensions: number;
+    /** Insert a vector with ID and optional metadata */
+    insert(id: string, vector: Float32Array, metadata?: Record<string, unknown>): Promise<void>;
+    /** Batch insert for performance */
+    insertBatch(items: readonly VectorEntry[]): Promise<void>;
+    /** Search for nearest neighbors */
+    search(query: Float32Array, topK: number, filter?: EmbeddingFilter): Promise<readonly VectorSearchResult[]>;
+    /** Delete by ID */
+    delete(id: string): Promise<void>;
+    /** Count entries in the index */
+    count(): Promise<number>;
+    /** Flush pending writes to disk */
+    flush(): Promise<void>;
+}
+export interface VectorEntry {
+    readonly id: string;
+    readonly vector: Float32Array;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface VectorSearchResult {
+    readonly id: string;
+    /** Similarity score (0-1, higher is more similar) */
+    readonly score: number;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface EmbeddingFilter {
+    /** Filter by metadata key-value before vector search */
+    readonly where?: Record<string, unknown>;
+    /** Filter by timestamp range */
+    readonly timestampAfter?: number;
+    readonly timestampBefore?: number;
+    /** Filter by device */
+    readonly deviceId?: string;
+}
+/** @deprecated Use StorageLocationType instead */
+export type StorageLocationName = StorageLocationType | 'data' | 'media' | 'recordings' | 'config' | 'events' | 'addon';
+/** @deprecated Use IStorageProvider instead */
+export interface StorageConfig {
+    locations: Record<string, string>;
+}
+/** @deprecated Use SettingsRecord instead */
+export interface StorageRecord {
+    collection: string;
+    id: string;
+    data: Record<string, unknown>;
+}
+/** @deprecated Use ISettingsBackend instead */
+export interface IStructuredStorage {
+    query(collection: string, filter?: QueryFilter): Promise<readonly StorageRecord[]>;
+    insert(record: StorageRecord): Promise<StorageRecord>;
+    update(collection: string, id: string, data: Record<string, unknown>): Promise<StorageRecord>;
+    delete(collection: string, id: string): Promise<void>;
+    count(collection: string, filter?: QueryFilter): Promise<number>;
+}
+/** @deprecated Use IStorageProvider.read/write instead */
+export interface IFileStorage {
+    readFile(path: string): Promise<Buffer>;
+    writeFile(path: string, data: Buffer): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    listFiles(prefix?: string): Promise<readonly string[]>;
+    getFileUrl(path: string): Promise<string>;
+    exists(path: string): Promise<boolean>;
+}
+/** @deprecated Use IStorageProvider instead */
+export interface IStorageLocation {
+    structured?: IStructuredStorage;
+    files?: IFileStorage;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/interfaces/storage.d.ts.map

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

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

@@ -0,0 +1,92 @@
+export type Unsubscribe = () => void;
+export interface StreamSource {
+    readonly type: string;
+    readonly url: string;
+    readonly videoCodec?: string;
+    readonly audioCodec?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface StreamSourceOption {
+    readonly id: string;
+    readonly label: string;
+    readonly source: StreamSource;
+    readonly resolution?: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly primary?: boolean;
+}
+export interface EncodedPacket {
+    readonly type: 'video' | 'audio';
+    readonly data: Buffer;
+    readonly pts: number;
+    readonly dts: number;
+    readonly keyframe: boolean;
+    readonly codec: string;
+}
+export interface DecodedFrame {
+    readonly data: Buffer;
+    readonly width: number;
+    readonly height: number;
+    readonly format: 'jpeg' | 'rgb' | 'yuv420';
+    readonly timestamp: number;
+}
+export interface DecodedAudioChunk {
+    readonly data: Buffer;
+    readonly sampleRate: number;
+    readonly channels: number;
+    readonly timestamp: number;
+}
+export interface DecodeOptions {
+    readonly maxFps?: number;
+    readonly format?: 'jpeg' | 'rgb' | 'yuv420';
+    readonly scale?: number;
+}
+export type BrokerStatus = 'idle' | 'connecting' | 'streaming' | 'error' | 'stopped';
+export interface BrokerStats {
+    readonly status: BrokerStatus;
+    readonly inputFps: number;
+    readonly decodeFps: number;
+    readonly encodedSubscribers: number;
+    readonly decodedSubscribers: number;
+    readonly uptimeMs: number;
+}
+export interface IStreamBroker {
+    readonly deviceId: string;
+    readonly status: BrokerStatus;
+    start(source: StreamSource): Promise<void>;
+    stop(): Promise<void>;
+    onEncodedData(callback: (packet: EncodedPacket) => void): Unsubscribe;
+    onDecodedFrame(callback: (frame: DecodedFrame) => void, options?: DecodeOptions): Unsubscribe;
+    onDecodedAudioChunk(callback: (chunk: DecodedAudioChunk) => void): Unsubscribe;
+    getStats(): BrokerStats;
+    getLocalStreamUrl(): string;
+}
+/**
+ * Manager for stream brokers — the server interacts with this interface,
+ * while the concrete implementation lives in the addon-pipeline 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[];
+}
+export type CameraPriority = 'always-on' | 'default';
+export type CameraPhase = 'watching' | 'active';
+export interface CameraDetectionConfig {
+    readonly enabled: boolean;
+    readonly priority: CameraPriority;
+    readonly pipeline: import('../types/pipeline.js').PipelineConfig;
+    readonly motionStreamId: string;
+    readonly detectionStreamId: string;
+    readonly motionFps: number;
+    readonly detectionFps: number;
+    readonly motionCooldownMs: number;
+    readonly audioStreamId?: string;
+}
+//# sourceMappingURL=stream-broker.d.ts.map

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

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

package/dist/interfaces/streaming.d.ts

@@ -0,0 +1,29 @@
+export type StreamFormat = 'webrtc' | 'hls' | 'mjpeg' | 'rtsp';
+export interface StreamingSource {
+    readonly url: string;
+    readonly protocol: 'rtsp' | 'http' | 'rtmp';
+    readonly deviceId: string;
+    readonly providerId: string;
+    readonly label?: string;
+}
+export interface StreamInfo {
+    readonly streamId: string;
+    readonly source: StreamingSource;
+    readonly formats: StreamFormat[];
+}
+export interface StreamStatus {
+    readonly active: boolean;
+    readonly viewers: number;
+    readonly startedAt?: number;
+}
+export interface IStreamingEngine {
+    initialize(config: Record<string, unknown>): Promise<void>;
+    shutdown(): Promise<void>;
+    registerStream(streamId: string, source: StreamingSource): Promise<void>;
+    unregisterStream(streamId: string): Promise<void>;
+    getStreamUrl(streamId: string, format: StreamFormat): string | null;
+    proxyWhepOffer(streamId: string, sdpOffer: string): Promise<string>;
+    listStreams(): StreamInfo[];
+    getStreamStatus(streamId: string): StreamStatus | null;
+}
+//# sourceMappingURL=streaming.d.ts.map

package/dist/interfaces/streaming.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/interfaces/streaming.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,CAAA;AAE9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;IAChC,QAAQ,CAAC,OAAO,EAAE,YAAY,EAAE,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACxE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAAA;IACnE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnE,WAAW,IAAI,UAAU,EAAE,CAAA;IAC3B,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAAA;CACvD"}

package/dist/interfaces/task-handler.d.ts

@@ -0,0 +1,46 @@
+import type { IScopedLogger } from './logging.js';
+/**
+ * Progress update sent from a task handler back to the hub.
+ */
+export interface TaskProgress {
+    readonly percent?: number;
+    readonly message?: string;
+    readonly data?: unknown;
+}
+/**
+ * Context provided to a task handler when executing a task.
+ */
+export interface TaskContext {
+    /** ID of the agent executing this task */
+    readonly taskId: string;
+    /** ID of the agent executing this task */
+    readonly agentId: string;
+    /** Pre-scoped logger for the task */
+    readonly logger: IScopedLogger;
+    /** Send progress updates back to hub */
+    reportProgress(progress: TaskProgress): void;
+    /** Check if the task has been cancelled */
+    isCancelled(): boolean;
+}
+/**
+ * Security level for a task handler. Dangerous tasks (e.g., terminal.exec)
+ * require explicit admin approval per agent.
+ */
+export type TaskHandlerSecurity = 'safe' | 'dangerous';
+/**
+ * Pluggable task handler interface. Any addon can register task handlers
+ * that the hub can dispatch to agents.
+ */
+export interface ITaskHandler {
+    /** Unique task type identifier (e.g., 'pipeline.decode', 'system.info') */
+    readonly taskType: string;
+    /** Human-readable description */
+    readonly description: string;
+    /** Security level — dangerous tasks need explicit admin approval */
+    readonly security?: TaskHandlerSecurity;
+    /** Execute the task and return a result */
+    handle(payload: unknown, context: TaskContext): Promise<unknown>;
+    /** Optional cleanup when a running task is cancelled */
+    cancel?(): Promise<void>;
+}
+//# sourceMappingURL=task-handler.d.ts.map

package/dist/interfaces/task-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-handler.d.ts","sourceRoot":"","sources":["../../src/interfaces/task-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,wCAAwC;IACxC,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAA;IAC5C,2CAA2C;IAC3C,WAAW,IAAI,OAAO,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,CAAA;AAEtD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,iCAAiC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAA;IACvC,2CAA2C;IAC3C,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAChE,wDAAwD;IACxD,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB"}

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

@@ -0,0 +1,11 @@
+import type { EncodedPacket } from './stream-broker.js';
+export interface IWebRtcProvider {
+    readonly id: string;
+    readonly name: string;
+    handleOffer(streamId: string, sdpOffer: string): Promise<string>;
+    supportsStream(streamId: string): boolean;
+    registerStream(streamId: string, codec: string): Promise<void>;
+    pushPacket(streamId: string, packet: EncodedPacket): void;
+    unregisterStream(streamId: string): Promise<void>;
+}
+//# sourceMappingURL=webrtc-provider.d.ts.map

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

@@ -0,0 +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"}

package/dist/interfaces/worker-protocol.d.ts

@@ -0,0 +1,110 @@
+/** Messages sent from main process to worker */
+export type MainToWorkerMessage = {
+    type: 'INIT';
+    addonId: string;
+    addonDir: string;
+    config: Record<string, unknown>;
+    storagePaths: Record<string, string>;
+    /** Private data directory for this addon */
+    dataDir: string;
+    /** Legacy location paths (deprecated — use storageProvider proxy instead) */
+    locationPaths: Record<string, string>;
+} | {
+    type: 'CONFIG_CHANGE';
+    config: Record<string, unknown>;
+} | {
+    type: 'CAPABILITY_RESPONSE';
+    requestId: string;
+    result: unknown;
+    error?: string;
+} | {
+    type: 'SHUTDOWN';
+} | {
+    type: 'PING';
+};
+/** Messages sent from worker to main process */
+export type WorkerToMainMessage = {
+    type: 'READY';
+    capabilities: ReadonlyArray<{
+        name: string;
+        mode: 'singleton' | 'collection';
+    }>;
+} | {
+    type: 'CAPABILITY_REGISTER';
+    name: string;
+    mode: 'singleton' | 'collection';
+} | {
+    type: 'CAPABILITY_CALL';
+    requestId: string;
+    capability: string;
+    method: string;
+    args: readonly unknown[];
+} | {
+    type: 'LOG';
+    level: string;
+    message: string;
+    context?: Record<string, unknown>;
+} | {
+    type: 'EVENT';
+    category: string;
+    data: Record<string, unknown>;
+} | {
+    type: 'STATS';
+    cpu: number;
+    memory: number;
+    uptime: number;
+} | {
+    type: 'PONG';
+} | {
+    type: 'ERROR';
+    message: string;
+    stack?: string;
+} | {
+    type: 'SUB_PROCESS_SPAWNED';
+    pid: number;
+    name: string;
+    command: string;
+} | {
+    type: 'SUB_PROCESS_EXITED';
+    pid: number;
+    code: number | null;
+} | {
+    type: 'TASK_HANDLER_REGISTER';
+    taskType: string;
+    description: string;
+    security?: 'safe' | 'dangerous';
+};
+/** Worker process state */
+export type WorkerState = 'starting' | 'running' | 'stopping' | 'stopped' | 'crashed';
+/** Worker process info exposed to main process */
+export interface WorkerInfo {
+    readonly addonId: string;
+    readonly pid: number;
+    readonly state: WorkerState;
+    readonly cpuPercent: number;
+    readonly memoryRss: number;
+    readonly uptimeSeconds: number;
+    readonly restartCount: number;
+    readonly subProcesses: readonly SubProcessInfo[];
+}
+/** Sub-process info */
+export interface SubProcessInfo {
+    readonly pid: number;
+    readonly name: string;
+    readonly command: string;
+    readonly state: 'running' | 'stopped' | 'crashed';
+    readonly cpuPercent: number;
+    readonly memoryRss: number;
+    readonly uptimeSeconds: number;
+}
+/** Worker process stats (distinct from the existing ProcessStats in process.ts) */
+export interface WorkerProcessStats {
+    readonly pid: number;
+    readonly cpuPercent: number;
+    readonly memoryRss: number;
+    readonly heapUsed?: number;
+    readonly uptimeSeconds: number;
+    readonly restartCount: number;
+    readonly state: WorkerState;
+}
+//# sourceMappingURL=worker-protocol.d.ts.map

package/dist/interfaces/worker-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.d.ts","sourceRoot":"","sources":["../../src/interfaces/worker-protocol.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC/B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,6EAA6E;IAC7E,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC,GACD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB,gDAAgD;AAChD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAAA;KAAE,CAAC,CAAA;CAAE,GAClG;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,YAAY,CAAA;CAAE,GAC/E;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAC5G;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;CAAE,CAAA;AAE7G,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAA;AAErF,kDAAkD;AAClD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAA;CACjD;AAED,uBAAuB;AACvB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;CAC/B;AAED,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAC5B"}

package/dist/schemas/system-settings-schemas.d.ts

@@ -0,0 +1,27 @@
+/**
+ * System settings UI schemas — the single source of truth for all settings sections.
+ *
+ * These are defined in @camstack/types so that:
+ *   - The backend can serve them via API
+ *   - Addons can reference/extend them
+ *   - The frontend fetches them at runtime (no hardcoded duplication)
+ *
+ * Values are stored in the SQL system_settings table, not config.yaml.
+ * Only `server` is read-only (loaded from config.yaml at bootstrap).
+ */
+import type { ConfigUISchema } from '../interfaces/config-ui.js';
+export type SystemSettingsSection = 'server' | 'auth' | 'features' | 'storage' | 'logging' | 'addons' | 'recording' | 'streaming' | 'ffmpeg' | 'detection' | 'backup' | 'retention';
+/** Sections where fields are read-only (bootstrap from config.yaml). */
+export declare const READ_ONLY_SECTIONS: ReadonlySet<SystemSettingsSection>;
+export interface SettingsTabDef {
+    readonly id: SystemSettingsSection;
+    readonly label: string;
+}
+export declare const SETTINGS_TABS: readonly SettingsTabDef[];
+export declare const SYSTEM_SETTINGS_SCHEMAS: Readonly<Record<SystemSettingsSection, ConfigUISchema>>;
+/**
+ * Get the UI schema for a settings section.
+ * Returns undefined for unknown sections.
+ */
+export declare function getSystemSettingsSchema(section: string): ConfigUISchema | undefined;
+//# sourceMappingURL=system-settings-schemas.d.ts.map

package/dist/schemas/system-settings-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-settings-schemas.d.ts","sourceRoot":"","sources":["../../src/schemas/system-settings-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAMhE,MAAM,MAAM,qBAAqB,GAC7B,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GACjE,WAAW,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE/E,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,qBAAqB,CAEhE,CAAA;AAMF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,qBAAqB,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAQzC,CAAA;AA2TV,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,qBAAqB,EAAE,cAAc,CAAC,CAc3F,CAAA;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAEnF"}

package/dist/types/analytics.d.ts

@@ -0,0 +1,75 @@
+import type { BoundingBox } from './io.js';
+import type { ObjectState } from './tracked.js';
+import type { DetectionEvent, EventSnapshot } from './events.js';
+export interface TrackFilter {
+    readonly class?: readonly string[];
+    readonly state?: readonly ObjectState[];
+    readonly inZone?: string;
+    readonly minDwellMs?: number;
+}
+export interface TimeRangeOptions {
+    readonly from: number;
+    readonly to: number;
+    readonly resolution: 'minute' | '5min' | 'hour';
+}
+export interface ZoneHistoryPoint {
+    readonly timestamp: number;
+    readonly objectCount: number;
+    readonly objectsByClass: Readonly<Record<string, number>>;
+    readonly entrances: number;
+    readonly exits: number;
+}
+export interface HeatmapOptions {
+    readonly from: number;
+    readonly to: number;
+    readonly class?: string;
+    readonly resolution: number;
+}
+export interface HeatmapData {
+    readonly width: number;
+    readonly height: number;
+    readonly gridSize: number;
+    readonly cells: Float32Array;
+    readonly maxCount: number;
+}
+export interface TrackDetail {
+    readonly trackId: string;
+    readonly class: string;
+    readonly originalClass: string;
+    readonly state: ObjectState;
+    readonly firstSeen: number;
+    readonly lastSeen: number;
+    readonly totalDwellMs: number;
+    readonly path: ReadonlyArray<{
+        readonly timestamp: number;
+        readonly bbox: BoundingBox;
+        readonly velocity: {
+            readonly dx: number;
+            readonly dy: number;
+        };
+    }>;
+    readonly identity?: {
+        readonly name: string;
+        readonly confidence: number;
+        readonly matchedAt: number;
+    };
+    readonly plateText?: {
+        readonly text: string;
+        readonly confidence: number;
+        readonly readAt: number;
+    };
+    readonly subClass?: {
+        readonly class: string;
+        readonly confidence: number;
+    };
+    readonly zoneTransitions: ReadonlyArray<{
+        readonly zoneId: string;
+        readonly zoneName: string;
+        readonly entered: number;
+        readonly exited?: number;
+        readonly dwellMs: number;
+    }>;
+    readonly bestSnapshot?: EventSnapshot;
+    readonly events: readonly DetectionEvent[];
+}
+//# sourceMappingURL=analytics.d.ts.map

package/dist/types/analytics.d.ts.map

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