@camstack/types 0.1.7 → 0.1.10

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"}

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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"}