@camstack/types 0.1.1 → 0.1.3

package/dist/interfaces/platform.d.ts

@@ -0,0 +1,55 @@
+/** Hardware information detected at boot */
+export interface HardwareInfo {
+    readonly platform: 'darwin' | 'linux' | 'win32';
+    readonly arch: 'arm64' | 'x64';
+    readonly cpuModel: string;
+    readonly cpuCores: number;
+    readonly totalRAM_MB: number;
+    readonly availableRAM_MB: number;
+    readonly gpu: GpuInfo | null;
+    readonly npu: NpuInfo | null;
+}
+export interface GpuInfo {
+    readonly type: 'nvidia' | 'amd' | 'intel' | 'apple';
+    readonly name: string;
+    readonly memoryMB?: number;
+}
+export interface NpuInfo {
+    readonly type: 'apple-ane' | 'intel-npu';
+}
+/** A probed backend with availability and score */
+export interface PlatformScore {
+    readonly runtime: 'node' | 'python';
+    readonly backend: string;
+    readonly format: 'onnx' | 'coreml' | 'openvino';
+    readonly score: number;
+    readonly reason: string;
+    readonly available: boolean;
+}
+/** Full platform capabilities — cached once per boot */
+export interface PlatformCapabilities {
+    readonly hardware: HardwareInfo;
+    readonly scores: readonly PlatformScore[];
+    readonly bestScore: PlatformScore;
+    readonly pythonPath: string | null;
+}
+/** Model requirement declared by an addon */
+export interface ModelRequirement {
+    readonly modelId: string;
+    readonly name: string;
+    /** Minimum RAM needed for inference (model + runtime overhead, in MB) */
+    readonly minRAM_MB: number;
+    /** Relative accuracy score 0-100 */
+    readonly accuracyScore: number;
+    /** Available formats in the model catalog */
+    readonly formats: readonly string[];
+}
+/** Resolved config — the tripletta chosen by the scorer for an addon */
+export interface ResolvedInferenceConfig {
+    readonly modelId: string;
+    readonly runtime: 'node' | 'python';
+    readonly backend: string;
+    readonly format: string;
+    readonly reason: string;
+}
+//# sourceMappingURL=platform.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/interfaces/platform.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;IAC/C,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAA;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAA;CACzC;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;CAC5B;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,oCAAoC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED,wEAAwE;AACxE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB"}

package/dist/interfaces/process.d.ts

@@ -0,0 +1,41 @@
+import type { ElementState } from './lifecycle.js';
+export interface ProcessStats {
+    pid: number;
+    cpu: number;
+    memory: number;
+    uptime: number;
+    restartCount: number;
+}
+export interface ProcessConfig {
+    id: string;
+    label: string;
+    command?: string;
+    modulePath?: string;
+    args?: string[];
+    env?: Record<string, string>;
+    autoRestart: boolean;
+    maxRestarts?: number;
+    healthCheck?: {
+        intervalMs: number;
+        timeoutMs: number;
+        failureThreshold: number;
+    };
+}
+export interface ManagedProcessStatus {
+    id: string;
+    label: string;
+    state: ElementState;
+    pid?: number;
+    stats?: ProcessStats;
+    lastCrashAt?: number;
+    lastCrashError?: string;
+    restartCount: number;
+    nextRestartAt?: number;
+}
+/** Minimal interface for ProcessManagerService used by addons */
+export interface IProcessManager {
+    register(config: ProcessConfig): unknown;
+    start(id: string): Promise<void>;
+    stop(id: string): Promise<void>;
+}
+//# sourceMappingURL=process.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../src/interfaces/process.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAElD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,WAAW,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE;QACZ,UAAU,EAAE,MAAM,CAAA;QAClB,SAAS,EAAE,MAAM,CAAA;QACjB,gBAAgB,EAAE,MAAM,CAAA;KACzB,CAAA;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,YAAY,CAAA;IACnB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAA;IACxC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC"}

package/dist/interfaces/python-env.d.ts

@@ -0,0 +1,20 @@
+import type { ChildProcess } from 'node:child_process';
+export interface PythonProbeResult {
+    readonly available: boolean;
+    readonly version?: string;
+    readonly path?: string;
+    readonly installedPackages?: readonly string[];
+}
+export interface PythonEnvReady {
+    readonly pythonPath: string;
+    readonly venvPath: string;
+    spawn(script: string, args: readonly string[]): ChildProcess;
+}
+export interface IPythonEnvironment {
+    probe(): Promise<PythonProbeResult>;
+    ensure(options: {
+        readonly packages: readonly string[];
+    }): Promise<PythonEnvReady>;
+    spawn(script: string, args: readonly string[]): ChildProcess;
+}
+//# sourceMappingURL=python-env.d.ts.map

package/dist/interfaces/python-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-env.d.ts","sourceRoot":"","sources":["../../src/interfaces/python-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC/C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAAA;CAC7D;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;IACnC,MAAM,CAAC,OAAO,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAClF,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAAA;CAC7D"}

package/dist/interfaces/refiner.d.ts

@@ -0,0 +1,8 @@
+import type { IPipelineSlotProvider } from './pipeline-slot.js';
+import type { CropInput } from '../types/detection.js';
+import type { RefinerOutput } from '../types/detection.js';
+export interface IRefinerProvider extends IPipelineSlotProvider {
+    readonly slot: 'refiner';
+    refine(input: CropInput): Promise<RefinerOutput>;
+}
+//# sourceMappingURL=refiner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refiner.d.ts","sourceRoot":"","sources":["../../src/interfaces/refiner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAE1D,MAAM,WAAW,gBAAiB,SAAQ,qBAAqB;IAC7D,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CACjD"}

package/dist/interfaces/repl.d.ts

@@ -0,0 +1,26 @@
+export interface ReplContext {
+    scope: ReplScope;
+    variables: Record<string, unknown>;
+}
+export type ReplScope = {
+    type: 'system';
+} | {
+    type: 'provider';
+    providerId: string;
+} | {
+    type: 'device';
+    deviceId: string;
+} | {
+    type: 'addon';
+    addonId: string;
+};
+export interface ReplResult {
+    output: string;
+    type: 'value' | 'error' | 'void';
+    duration: number;
+}
+export interface IReplEngine {
+    execute(code: string, context: ReplContext): Promise<ReplResult>;
+    getCompletions(partial: string, context: ReplContext): Promise<string[]>;
+}
+//# sourceMappingURL=repl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/interfaces/repl.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,CAAA;IAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IAChC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAChE,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;CACzE"}

package/dist/interfaces/repositories.d.ts

@@ -0,0 +1,20 @@
+import type { ZoneDefinition, KnownFace, KnownPlate } from '../types/entities.js';
+export interface IZoneRepository {
+    getByCamera(cameraId: string): Promise<ZoneDefinition[]>;
+    save(zone: ZoneDefinition): Promise<void>;
+    delete(zoneId: string): Promise<void>;
+}
+export interface IKnownFaceRepository {
+    getAll(): Promise<KnownFace[]>;
+    findByEmbedding(embedding: Float32Array, threshold: number): Promise<KnownFace | null>;
+    save(face: KnownFace): Promise<void>;
+    addEmbedding(faceId: string, embedding: Float32Array): Promise<void>;
+    delete(faceId: string): Promise<void>;
+}
+export interface IKnownPlateRepository {
+    getAll(): Promise<KnownPlate[]>;
+    findByText(text: string): Promise<KnownPlate | null>;
+    save(plate: KnownPlate): Promise<void>;
+    delete(plateId: string): Promise<void>;
+}
+//# sourceMappingURL=repositories.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../src/interfaces/repositories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjF,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IACxD,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAA;IAC9B,eAAe,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IACtF,IAAI,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC,CAAA;IAC/B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IACpD,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvC"}

package/dist/interfaces/restreamer.d.ts

@@ -0,0 +1,24 @@
+import type { EncodedPacket } from './stream-broker.js';
+export interface RegisteredStream {
+    readonly streamId: string;
+    readonly label: string;
+    readonly codec: string;
+    readonly type: 'video' | 'audio';
+    readonly sourceUrl?: string;
+}
+export interface RestreamerExposedResource {
+    readonly type: string;
+    readonly format: string;
+    readonly value: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface IRestreamer {
+    readonly id: string;
+    readonly name: string;
+    registerDevice(deviceId: string, streams: readonly RegisteredStream[]): Promise<void>;
+    pushPacket(streamId: string, packet: EncodedPacket): void;
+    unregisterDevice(deviceId: string): Promise<void>;
+    getExposedResources(deviceId: string): readonly RestreamerExposedResource[];
+    proxyWhepOffer?(streamId: string, sdpOffer: string): Promise<string>;
+}
+//# sourceMappingURL=restreamer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"restreamer.d.ts","sourceRoot":"","sources":["../../src/interfaces/restreamer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACrF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;IACzD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjD,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,yBAAyB,EAAE,CAAA;IAC3E,cAAc,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACrE"}

package/dist/interfaces/router.d.ts

@@ -0,0 +1,30 @@
+export interface RouteRequest {
+    readonly params: Readonly<Record<string, string>>;
+    readonly query: Readonly<Record<string, string | string[]>>;
+    readonly headers: Readonly<Record<string, string | undefined>>;
+    readonly body?: unknown;
+}
+export interface RouteResponse {
+    status(code: number): RouteResponse;
+    json(data: unknown): void;
+    send(data: string | Buffer): void;
+    sendFile(path: string): void;
+    header(name: string, value: string): RouteResponse;
+}
+export type RouteHandler = (req: RouteRequest, res: RouteResponse) => void | Promise<void>;
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+export interface IAddonRouter {
+    /** Public route — no auth required */
+    public(method: HttpMethod, path: string, handler: RouteHandler): void;
+    /** Protected route — requires valid JWT or API key */
+    protected(method: HttpMethod, path: string, handler: RouteHandler): void;
+    /** Admin route — requires admin role */
+    admin(method: HttpMethod, path: string, handler: RouteHandler): void;
+    /** Serve static directory */
+    static(urlPath: string, directory: string, options?: {
+        auth?: boolean;
+    }): void;
+    /** Get the base URL prefix for this addon's routes */
+    getBaseUrl(): string;
+}
+//# sourceMappingURL=router.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/interfaces/router.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC9D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAAA;IACnC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,CAAA;CACnD;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAC1F,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEpE,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACrE,sDAAsD;IACtD,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACxE,wCAAwC;IACxC,KAAK,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACpE,6BAA6B;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAA;IAC9E,sDAAsD;IACtD,UAAU,IAAI,MAAM,CAAA;CACrB"}

package/dist/interfaces/scene-intelligence.d.ts

@@ -0,0 +1,21 @@
+import type { LabelData } from '../types/detection.js';
+import type { EmbeddingFilter, VectorSearchResult } from './storage.js';
+export interface EmbeddingMetadata {
+    readonly timestamp: number;
+    readonly className: string;
+    readonly deviceId: string;
+    readonly zoneId?: string;
+    readonly labelsData?: readonly LabelData[];
+}
+export interface SceneStateResult {
+    readonly previousState: string;
+    readonly currentState: string;
+    readonly confidence: number;
+}
+export interface ISceneIntelligence {
+    embed(deviceId: string, crop: Buffer, metadata: EmbeddingMetadata): Promise<string>;
+    search(query: string, topK: number, filter?: EmbeddingFilter): Promise<VectorSearchResult[]>;
+    searchByImage(image: Buffer, topK: number, filter?: EmbeddingFilter): Promise<VectorSearchResult[]>;
+    evaluateSceneState(deviceId: string, crop: Buffer): Promise<SceneStateResult | null>;
+}
+//# sourceMappingURL=scene-intelligence.d.ts.map

package/dist/interfaces/scene-intelligence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-intelligence.d.ts","sourceRoot":"","sources":["../../src/interfaces/scene-intelligence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEvE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,SAAS,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACnF,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;IAC5F,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAA;IACnG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAA;CACrF"}

package/dist/interfaces/scoped-token.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Scope restriction for a scoped token.
+ */
+export interface TokenScope {
+    readonly type: 'addon' | 'route-prefix' | 'capability';
+    readonly target: string;
+}
+/**
+ * A per-user API token with restricted scopes.
+ */
+export interface ScopedToken {
+    readonly id: string;
+    readonly userId: string;
+    readonly name: string;
+    readonly tokenHash: string;
+    readonly tokenPrefix: string;
+    readonly scopes: TokenScope[];
+    readonly expiresAt?: number;
+    readonly lastUsedAt?: number;
+    readonly createdAt: number;
+}
+//# sourceMappingURL=scoped-token.d.ts.map

package/dist/interfaces/scoped-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoped-token.d.ts","sourceRoot":"","sources":["../../src/interfaces/scoped-token.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,cAAc,GAAG,YAAY,CAAA;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B"}

package/dist/interfaces/server-analysis.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Detection Analysis Pipeline -- processes raw detections through
+ * configurable stages to produce tracked, enriched, actionable events.
+ */
+import type { Detection } from './device-capabilities/object-detector.js';
+import type { VideoFrame } from './camera-pipeline.js';
+export declare const DETECTION_TYPES: readonly ["person", "vehicle", "animal", "package"];
+export type DetectionType = typeof DETECTION_TYPES[number];
+export declare const SUB_DETECTION_TYPES: readonly ["face", "plate"];
+export type SubDetectionType = typeof SUB_DETECTION_TYPES[number];
+export declare const RECOGNITION_TYPES: readonly ["face", "plate", "clip", "custom"];
+export type RecognitionType = typeof RECOGNITION_TYPES[number];
+export interface AnalysisContext {
+    readonly deviceId: string;
+    readonly frame: VideoFrame;
+    readonly timestamp: number;
+    readonly rawDetections: readonly Detection[];
+    readonly trackedDetections: readonly ServerTrackedDetection[];
+    readonly events: readonly AnalysisEvent[];
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+export interface ServerTrackedDetection {
+    readonly trackId: string;
+    readonly detection: Detection;
+    readonly crop?: Buffer;
+    readonly tracking: TrackingInfo;
+    readonly subDetections: readonly SubDetection[];
+    readonly recognitions: readonly RecognitionResult[];
+    readonly zones: readonly string[];
+    readonly previousZones: readonly string[];
+}
+export interface TrackingInfo {
+    readonly age: number;
+    readonly state: 'moving' | 'stationary' | 'new' | 'lost';
+    readonly stationaryDuration: number;
+    readonly velocity: {
+        readonly dx: number;
+        readonly dy: number;
+    };
+    readonly positionHistory: ReadonlyArray<{
+        readonly x: number;
+        readonly y: number;
+        readonly t: number;
+    }>;
+}
+export interface SubDetection {
+    readonly detectionType: SubDetectionType;
+    readonly boundingBox: readonly [number, number, number, number];
+    readonly score: number;
+    readonly crop?: Buffer;
+}
+export interface RecognitionResult {
+    readonly recognitionType: RecognitionType;
+    readonly label: string;
+    readonly score: number;
+    readonly embedding?: readonly number[];
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+export interface AnalysisEvent {
+    readonly category: string;
+    readonly severity: 'info' | 'warning' | 'alert';
+    readonly detection: ServerTrackedDetection;
+    readonly description: string;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+export interface IAnalysisStage {
+    readonly id: string;
+    readonly name: string;
+    readonly priority: number;
+    enabled: boolean;
+    process(ctx: AnalysisContext): Promise<AnalysisContext>;
+}
+export interface ISubDetector {
+    readonly detectionType: SubDetectionType;
+    readonly targetClasses: readonly string[];
+    detect(crop: Buffer, cropWidth: number, cropHeight: number): Promise<SubDetection[]>;
+}
+export interface IFaceDetector extends ISubDetector {
+    readonly detectionType: 'face';
+}
+export interface IPlateDetector extends ISubDetector {
+    readonly detectionType: 'plate';
+}
+export interface IRecognizer {
+    readonly recognitionType: RecognitionType;
+    recognize(crop: Buffer, width: number, height: number): Promise<RecognitionResult | null>;
+}
+export interface IFaceRecognizer extends IRecognizer {
+    getEmbedding(crop: Buffer): Promise<Float32Array>;
+    registerKnown(label: string, embedding: Float32Array): void;
+}
+export interface IPlateRecognizer extends IRecognizer {
+    readonly recognitionType: 'plate';
+}
+export interface IAudioClassifier {
+    readonly ready: boolean;
+    initialize(): Promise<void>;
+    classify(audioSamples: Float32Array, sampleRate: number, topN?: number): Promise<readonly AudioClassification[]>;
+    release(): Promise<void>;
+}
+export interface AudioClassification {
+    readonly classIndex: number;
+    readonly className: string;
+    readonly score: number;
+    readonly isSurveillanceRelevant: boolean;
+}
+export interface IClassFilterStage extends IAnalysisStage {
+    readonly id: 'class-filter';
+    setConfig(deviceId: string, config: Record<string, unknown>): void;
+    getConfig(deviceId: string): Record<string, unknown>;
+}
+export interface ITrackerStage extends IAnalysisStage {
+    readonly id: 'tracker';
+    setConfig(deviceId: string, config: Record<string, unknown>): void;
+    getConfig(deviceId: string): Record<string, unknown>;
+    resetDevice(deviceId: string): void;
+}
+export interface ISubDetectionStage extends IAnalysisStage {
+    readonly id: 'sub-detection';
+    registerDetector(detector: ISubDetector): void;
+}
+export interface IRecognitionStage extends IAnalysisStage {
+    readonly id: 'recognition';
+    registerRecognizer(recognizer: IRecognizer): void;
+}
+export interface IZoneAnalysisStage extends IAnalysisStage {
+    readonly id: 'zone-analysis';
+    setConfig(deviceId: string, config: Record<string, unknown>): void;
+}
+export interface IEventGenerationStage extends IAnalysisStage {
+    readonly id: 'event-generation';
+    setConfig(deviceId: string, config: Record<string, unknown>): void;
+}
+export interface IObjectSnapshotStage extends IAnalysisStage {
+    readonly id: 'object-snapshot';
+    setConfig(deviceId: string, config: Record<string, unknown>): void;
+}
+export interface IAnalysisPipeline {
+    addStage(stage: IAnalysisStage): void;
+    removeStage(stageId: string): void;
+    getStages(): readonly IAnalysisStage[];
+    analyze(deviceId: string, frame: VideoFrame, rawDetections: Detection[]): Promise<AnalysisContext>;
+}
+export declare function createAnalysisContext(deviceId: string, frame: VideoFrame, rawDetections: Detection[]): AnalysisContext;
+export declare function enrichContext(ctx: AnalysisContext, updates: Partial<Pick<AnalysisContext, 'trackedDetections' | 'events' | 'metadata'>>): AnalysisContext;
+//# sourceMappingURL=server-analysis.d.ts.map

package/dist/interfaces/server-analysis.d.ts.map

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

package/dist/interfaces/server-network.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Server-side network access interfaces.
+ * These cover tunnel/VPN/endpoint management, NOT the addon-facing INetworkProvider.
+ */
+export interface INetworkEndpoint {
+    id: string;
+    type: 'lan' | 'mdns' | 'domain' | 'tunnel' | 'vpn' | 'custom';
+    provider: string;
+    url: string;
+    internal: boolean;
+    capabilities: EndpointCapabilities;
+    priority: number;
+    status: 'online' | 'offline' | 'unknown';
+    metadata?: Record<string, unknown>;
+}
+export interface EndpointCapabilities {
+    supportsWebRTC: boolean;
+    supportsWebSocket: boolean;
+    supportsSSE: boolean;
+    maxBandwidthMbps?: number;
+}
+export interface INetworkAccessProvider {
+    id: string;
+    type: string;
+    start(): Promise<INetworkEndpoint>;
+    stop(): Promise<void>;
+    getEndpoint(): INetworkEndpoint | null;
+    getStatus(): NetworkAccessStatus;
+}
+export interface NetworkAccessStatus {
+    connected: boolean;
+    publicUrl?: string;
+    error?: string;
+    connectedSince?: number;
+}
+export interface IExposedResource {
+    id: string;
+    providerId: string;
+    deviceId?: string;
+    type: ExposedResourceType;
+    path: string;
+    auth: ResourceAuthMode;
+    description: string;
+    contentType?: string;
+    enabled: boolean;
+}
+export type ExposedResourceType = 'snapshot' | 'stream' | 'webhook' | 'api' | 'media' | 'custom';
+export type ResourceAuthMode = {
+    mode: 'public';
+} | {
+    mode: 'token';
+    token: string;
+} | {
+    mode: 'api-key';
+} | {
+    mode: 'jwt';
+} | {
+    mode: 'ip-whitelist';
+    ips: string[];
+};
+export interface IResourceExposer {
+    getExposedResources(): IExposedResource[];
+    handleResourceRequest(resourceId: string, request: ExposedResourceRequest): Promise<ExposedResourceResponse>;
+}
+export interface ExposedResourceRequest {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    headers: Record<string, string>;
+    query: Record<string, string>;
+    body?: Buffer | string;
+    remoteIp: string;
+}
+export interface ExposedResourceResponse {
+    status: number;
+    headers?: Record<string, string>;
+    body?: Buffer | string | NodeJS.ReadableStream;
+}
+//# sourceMappingURL=server-network.d.ts.map

package/dist/interfaces/server-network.d.ts.map

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

package/dist/interfaces/storage-backend.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @deprecated — This file contains legacy storage backend interfaces.
+ * Use the new interfaces from './storage.ts' instead:
+ *   - IStorageProvider (capability: 'storage')
+ *   - ISettingsBackend (capability: 'settings-store')
+ *   - IEmbeddingsBackend (capability: 'embeddings')
+ */
+import type { StorageLocationType } from './storage.js';
+/** @deprecated Use IStorageProvider from storage.ts */
+export interface IStorageBackend {
+    readonly type: string;
+    readonly basePath: string;
+    resolve(subpath: string): string;
+    resolve(location: StorageLocationType, ...segments: string[]): string;
+    isAvailable(location?: StorageLocationType): boolean;
+    initialize(): Promise<void>;
+    getLocationPath?(location: StorageLocationType): string;
+}
+/** @deprecated */
+export interface StorageLocationConfig {
+    readonly name: string;
+    readonly basePath: string;
+    readonly backendType?: string;
+}
+/** @deprecated Use DEFAULT_LOCATION_SUBDIRS from storage.ts */
+export declare const DEFAULT_LOCATION_SUBPATHS: Record<string, string>;
+//# sourceMappingURL=storage-backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-backend.d.ts","sourceRoot":"","sources":["../../src/interfaces/storage-backend.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAEvD,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAChC,OAAO,CAAC,QAAQ,EAAE,mBAAmB,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IACrE,WAAW,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAA;IACpD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,eAAe,CAAC,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,CAAA;CACxD;AAED,kBAAkB;AAClB,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAS5D,CAAA"}