@camstack/types 0.1.2 → 0.1.4

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

@@ -0,0 +1,278 @@
+/**
+ * Analysis Persistence Types — interfaces for event persistence, track trails,
+ * retention, session tracking, and known faces.
+ *
+ * These interfaces define the contracts used by the server; concrete
+ * implementations live in addon-pipeline and are received via CapabilityRegistry.
+ */
+import type { ServerTrackedDetection } from './server-analysis.js';
+export interface ObjectSnapshotResult {
+    readonly trackId: string;
+    readonly thumbnail?: Buffer;
+    readonly fullCrop?: Buffer;
+}
+export interface AnnotatedSnapshotResult {
+    readonly thumbnail: Buffer;
+    readonly full: Buffer;
+}
+export interface PersistableEvent {
+    readonly id: string;
+    readonly timestamp: number;
+    readonly deviceId: string;
+    readonly category: string;
+    readonly className: string;
+    readonly score: number;
+    readonly trackId: string;
+    readonly severity: string;
+    readonly description: string;
+    readonly data: Record<string, unknown>;
+    readonly mediaFiles: readonly string[];
+}
+export interface EventBufferStatus {
+    readonly eventCount: number;
+    readonly mediaCount: number;
+    readonly mediaSizeMB: number;
+}
+export type TrackMediaType = 'crop-thumb' | 'crop-full' | 'debug-annotated-thumb' | 'debug-annotated-full' | 'original' | 'original-thumb' | 'inline-crop' | 'unknown';
+export interface TrackMediaFile {
+    readonly path: string;
+    readonly type: TrackMediaType;
+    readonly data: Buffer;
+    readonly source: 'buffer' | 'storage';
+}
+export interface TrackCaptureConfig {
+    readonly enabled: boolean;
+    readonly snapshotIntervalMs: number;
+    readonly maxTrailLength: number;
+    readonly saveThumbnails: boolean;
+    readonly thumbnailSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+}
+export interface TrackPosition {
+    readonly x: number;
+    readonly y: number;
+    readonly timestamp: number;
+    readonly bbox: readonly [number, number, number, number];
+}
+export interface TrackSnapshot {
+    readonly timestamp: number;
+    readonly position: TrackPosition;
+    readonly thumbnailPath: string;
+}
+export interface TrackTrail {
+    readonly trackId: string;
+    readonly deviceId: string;
+    readonly className: string;
+    readonly label?: string;
+    readonly firstSeen: number;
+    readonly lastSeen: number;
+    readonly positions: readonly TrackPosition[];
+    readonly snapshots: readonly TrackSnapshot[];
+    readonly totalDistance: number;
+    readonly zonesVisited: readonly string[];
+    readonly active: boolean;
+}
+export interface RetentionConfig {
+    readonly cleanupIntervalMs: number;
+    readonly detectionEventsDays: number;
+    readonly audioLevelsDays: number;
+    /** @deprecated — snapshots are tied to events, use detectionEventsDays */
+    readonly snapshotsDays: number;
+    readonly deviceOverrides?: Readonly<Record<string, Partial<Pick<RetentionConfig, 'detectionEventsDays' | 'audioLevelsDays' | 'snapshotsDays'>>>>;
+}
+export declare const DEFAULT_RETENTION: RetentionConfig;
+export interface RetentionReport {
+    readonly deletedEvents: number;
+    readonly deletedAudioRecords: number;
+    readonly deletedSnapshots: number;
+}
+export interface SessionTrack {
+    readonly trackId: string;
+    readonly deviceId: string;
+    readonly className: string;
+    readonly label?: string;
+    readonly firstSeen: number;
+    readonly lastSeen: number;
+    readonly totalFrames: number;
+    readonly lastDetection: ServerTrackedDetection;
+    readonly state: string;
+    readonly positions: ReadonlyArray<{
+        readonly x: number;
+        readonly y: number;
+        readonly t: number;
+    }>;
+    readonly embedding?: Float32Array;
+    readonly globalId?: string;
+    readonly bestCrop?: Buffer;
+}
+export interface GlobalIdentity {
+    readonly globalId: string;
+    readonly embedding: Float32Array;
+    readonly label?: string;
+    readonly firstSeen: number;
+    readonly lastSeen: number;
+    readonly deviceIds: ReadonlyArray<string>;
+}
+export interface ClipRecognizer {
+    getEmbedding(imageBuffer: Buffer): Promise<Float32Array>;
+}
+export interface KnownFaceEntry {
+    readonly id: string;
+    readonly label: string;
+    readonly group?: string;
+    readonly embedding: readonly number[];
+    readonly cropBase64: string;
+    readonly createdAt: number;
+    readonly updatedAt: number;
+    readonly source?: string;
+    readonly metadata?: Readonly<Record<string, unknown>>;
+}
+/**
+ * Interface for the recording addon — the server uses this instead of
+ * importing PipelineAddon directly from addon-pipeline.
+ */
+export interface IRecordingAddon {
+    getCoordinator(): IRecordingCoordinator;
+    getRecordingDb(): IRecordingDb;
+}
+/**
+ * Minimal coordinator interface for the server's recording router.
+ */
+export interface IRecordingCoordinator {
+    enableRecording(deviceId: string, options: {
+        policy: unknown;
+        ffmpegOverrides?: unknown;
+    }): Promise<void>;
+    disableRecording(deviceId: string): Promise<void>;
+    isRecording(deviceId: string): boolean;
+    readonly playlistGenerator: {
+        generate(deviceId: string, streamId: string, startTime: number, endTime: number, options?: {
+            live?: boolean;
+        }): unknown;
+    };
+    readonly storageEstimator: {
+        estimateForDevice(deviceId: string, motionInput?: {
+            avgEventsPerDay: number;
+            avgDurationSec: number;
+        }): {
+            totalEstimatedGb: number;
+            [key: string]: unknown;
+        };
+    };
+}
+/**
+ * Minimal recording database interface for the server's recording router.
+ */
+export interface IRecordingDb {
+    upsertStorageConfig(config: {
+        deviceId: string;
+        dataCategory: string;
+        storageName: string;
+        subDirectory: string;
+        retentionDays: number | null;
+        retentionGb: number | null;
+    }): void;
+    getPolicy(deviceId: string): unknown;
+    getEnabledPolicies(): Array<{
+        deviceId: string;
+        [key: string]: unknown;
+    }>;
+    querySegments(deviceId: string, streamId: string, startTime: number, endTime: number): unknown;
+    getAvailability(deviceId: string, startTime: number, endTime: number): unknown;
+    getStorageUsage(deviceId: string, streamId: string): unknown;
+    upsertPolicy(policy: unknown): void;
+    findNearestThumbnail(deviceId: string, timestamp: number, category: string): unknown;
+    getMotionStats(deviceId: string, startTime: number, endTime: number): {
+        avgEventsPerDay: number;
+        avgDurationSec: number;
+        dutyCyclePercent: number;
+        totalEvents: number;
+    };
+    resolveStorageConfig(deviceId: string, dataCategory: string): unknown;
+}
+export interface IEventPersistence {
+    start(): void;
+    stop(): void;
+    saveDetectionCrops(eventId: string, crops: readonly ObjectSnapshotResult[]): void;
+    saveAnnotatedFrame(eventId: string, result: AnnotatedSnapshotResult): void;
+    saveOriginalFrame(eventId: string, frame: import('./camera-pipeline.js').VideoFrame): Promise<void>;
+    getEventMedia(eventId: string): Promise<unknown>;
+    getTrackMedia(trackId: string): Promise<unknown>;
+    getDeviceMedia(deviceId: string, since?: number, until?: number): Promise<unknown>;
+    getBufferStatus(): unknown;
+    flush(): Promise<void>;
+}
+export interface ITrackTrail {
+    setConfig(deviceId: string, config: Partial<TrackCaptureConfig>): void;
+    getConfig(deviceId: string): unknown;
+    recordFrame(ctx: unknown): Promise<void>;
+    getActiveTrail(trackId: string): unknown;
+    getActiveTrails(deviceId: string): unknown;
+    getPersistedTrail(trackId: string): Promise<unknown>;
+    getTrail(trackId: string): Promise<unknown>;
+    listTrails(deviceId: string, options?: {
+        since?: number;
+        until?: number;
+        limit?: number;
+        className?: string;
+    }): Promise<unknown>;
+}
+export interface IRetention {
+    start(): void;
+    stop(): void;
+    runCleanup(): Promise<unknown>;
+    setConfig(update: Partial<RetentionConfig>): void;
+    getConfig(): unknown;
+    forceCleanup(): Promise<unknown>;
+}
+export interface ISessionTracker {
+    updateFromAnalysis(deviceId: string, ctx: unknown): void;
+    getActiveTracks(deviceId: string): unknown;
+    getAllActiveTracks(): unknown;
+    getTrack(deviceId: string, trackId: string): unknown;
+    getTrackCounts(): unknown;
+    clearDevice(deviceId: string): void;
+    clearAll(): void;
+    getGlobalPool(): unknown;
+}
+export interface IKnownFaces {
+    register(entry: KnownFaceEntry): Promise<void>;
+    listAll(): Promise<unknown>;
+    delete(id: string): Promise<void>;
+    update(id: string, updates: Partial<Pick<KnownFaceEntry, 'label' | 'group'>>): Promise<void>;
+    recalculateEmbedding(id: string, clipRecognizer: ClipRecognizer): Promise<void>;
+    findMatch(embedding: Float32Array, threshold: number): Promise<unknown>;
+    batchRegister(entries: ReadonlyArray<{
+        readonly label: string;
+        readonly cropBase64: string;
+        readonly group?: string;
+    }>, clipRecognizer: ClipRecognizer): Promise<unknown>;
+}
+/**
+ * Composite interface exposed via CapabilityRegistry as the
+ * 'analysis-data-persistence' singleton. Each sub-service is wired
+ * individually to the corresponding NestJS wrapper service.
+ */
+export interface IAnalysisDataPersistence {
+    readonly eventPersistence: IEventPersistence;
+    readonly knownFaces: IKnownFaces;
+    readonly sessionTracker: ISessionTracker;
+    readonly retention: IRetention;
+    readonly trackTrail: ITrackTrail;
+}
+export interface TestConnectionResult {
+    readonly success: boolean;
+    readonly version?: string;
+    readonly cameraCount?: number;
+    readonly error?: string;
+}
+/**
+ * Generic interface for testing provider connections.
+ * Each provider addon can expose a connection tester.
+ */
+export interface IProviderConnectionTester {
+    testConnection(): Promise<TestConnectionResult>;
+}
+//# sourceMappingURL=analysis-persistence.d.ts.map

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

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

package/dist/interfaces/analysis.d.ts

@@ -0,0 +1,27 @@
+import type { ICamstackAddon } from './addon.js';
+import type { FrameInput } from '../types/io.js';
+import type { PipelineConfig, PipelineStatus } from '../types/pipeline.js';
+import type { DetectionEvent } from '../types/events.js';
+import type { KnownFace, KnownPlate } from '../types/entities.js';
+import type { CameraZone, MotionSource } from '../types/zones.js';
+import type { CameraLiveState, TrackedObjectSummary, ZoneLiveState } from '../types/live-state.js';
+import type { TrackDetail, TrackFilter, ZoneHistoryPoint, HeatmapData, HeatmapOptions, TimeRangeOptions } from '../types/analytics.js';
+export interface ICameraAnalyticsProvider {
+    getLiveState(deviceId: string): CameraLiveState | null;
+    getTracks(deviceId: string, filter?: TrackFilter): TrackedObjectSummary[];
+    getZoneState(deviceId: string, zoneId: string): ZoneLiveState | null;
+    getZoneHistory(deviceId: string, zoneId: string, options: TimeRangeOptions): Promise<ZoneHistoryPoint[]>;
+    getHeatmap(deviceId: string, options: HeatmapOptions): Promise<HeatmapData>;
+    getTrackDetail(deviceId: string, trackId: string): TrackDetail | null;
+    getCameraStatus(deviceId: string): PipelineStatus[];
+}
+export interface IAnalysisAddon extends ICamstackAddon, ICameraAnalyticsProvider {
+    processFrame(deviceId: string, frame: FrameInput): Promise<DetectionEvent[]>;
+    setCameraPipeline(deviceId: string, config: PipelineConfig): void;
+    setCameraZones(deviceId: string, zones: readonly CameraZone[]): void;
+    setCameraMotionConfig(deviceId: string, source: MotionSource): void;
+    setKnownFaces(faces: KnownFace[]): void;
+    setKnownPlates(plates: KnownPlate[]): void;
+    onLiveStateChange(deviceId: string, callback: (state: CameraLiveState) => void): () => void;
+}
+//# sourceMappingURL=analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../../src/interfaces/analysis.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEjE,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAEtI,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAAA;IACtD,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,oBAAoB,EAAE,CAAA;IACzE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAAA;IACpE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAA;IACxG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC3E,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAAA;IACrE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAAA;CACpD;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc,EAAE,wBAAwB;IAC9E,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAA;IAC5E,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,IAAI,CAAA;IACjE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAA;IACpE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IACnE,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAA;IACvC,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAA;IAC1C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CAC5F"}

package/dist/interfaces/api-shared.d.ts

@@ -0,0 +1,169 @@
+/**
+ * API-shared types — types that originated in @camstack/core, @camstack/kernel,
+ * or server internals and are now canonical here so the generated API type file
+ * has zero external dependencies beyond @camstack/types.
+ */
+import type { ProviderStatus } from './device-provider.js';
+import type { ElementStatus } from './lifecycle.js';
+import type { CameraPriority, CameraPhase } from './stream-broker.js';
+import type { AddonPageDeclaration } from './addon.js';
+export interface BackupManifest {
+    readonly id: string;
+    readonly timestamp: number;
+    readonly label?: string;
+    readonly locations: readonly string[];
+    readonly sizeMB: number;
+    readonly path: string;
+}
+export interface ProviderListItem {
+    id: string;
+    type: string;
+    name: string;
+    status: ProviderStatus;
+    started: boolean;
+    lifecycle: ElementStatus;
+}
+export interface InstalledPackage {
+    readonly name: string;
+    readonly version: string;
+    readonly dir: string;
+    readonly installSource?: 'npm' | 'workspace';
+}
+/** A page declaration enriched with its source addon ID */
+export interface AddonPageInfo {
+    readonly addonId: string;
+    readonly page: AddonPageDeclaration;
+    readonly bundleUrl: string;
+}
+export type BenchmarkPhase = 'init' | 'warmup' | 'running' | 'done';
+export interface BenchmarkProgress {
+    readonly addonId: string;
+    readonly phase: BenchmarkPhase;
+    readonly elapsedSec: number;
+    readonly totalSec: number;
+    readonly warmupFrame: number;
+    readonly warmupTotal: number;
+    readonly framesProcessed: number;
+    readonly totalDetections: number;
+    readonly objectsFound: number;
+    readonly errorCount: number;
+    readonly simulatedCameras: number;
+    readonly batchSize: number;
+    readonly currentDps: number;
+    readonly currentFps: number;
+    readonly recentAvgMs: number;
+    readonly inferenceMs: number;
+}
+export interface BenchmarkResult {
+    readonly addonId: string;
+    readonly addonName: string;
+    readonly referenceImage: string;
+    readonly runtime: string;
+    readonly iterations: number;
+    readonly durationSec: number;
+    readonly warmup: number;
+    readonly inputResolution: string;
+    readonly dps: number;
+    readonly totalDetections: number;
+    readonly objectsFound: number;
+    readonly avgDetectionsPerFrame: number;
+    readonly inferenceAvgMs: number;
+    readonly inferenceP50Ms: number;
+    readonly inferenceP95Ms: number;
+    readonly inferenceP99Ms: number;
+    readonly fps: number;
+    readonly avgMs: number;
+    readonly p50Ms: number;
+    readonly p95Ms: number;
+    readonly p99Ms: number;
+    readonly minMs: number;
+    readonly maxMs: number;
+    readonly peakMemoryMB: number;
+    readonly errorCount: number;
+    readonly successCount: number;
+    readonly modelId: string;
+    readonly simulatedCameras: number;
+    readonly batchSize: number;
+}
+export interface HistoryEntry {
+    readonly id: string;
+    readonly date: string;
+    readonly agentName: string;
+    readonly addonId: string;
+    readonly modelName: string;
+    readonly runtime: string;
+    readonly dps: number;
+    readonly inferenceAvgMs: number;
+    readonly totalDetections: number;
+    readonly fps: number;
+    readonly avgMs: number;
+    readonly p50Ms: number;
+    readonly p95Ms: number;
+    readonly p99Ms: number;
+    readonly minMs: number;
+    readonly maxMs: number;
+    readonly peakMemoryMB: number;
+    readonly iterations: number;
+    readonly warmup: number;
+    readonly inputResolution: string;
+    readonly simulatedCameras?: number;
+    readonly batchSize?: number;
+    readonly errorCount?: number;
+}
+export interface PipelineProgressEvent {
+    readonly step: 'loading-engine' | 'inferring' | 'complete';
+    readonly addonId: string;
+    readonly modelId: string;
+    readonly ms?: number;
+    readonly message?: string;
+}
+export interface OrchestratorMetrics {
+    readonly activeCameras: number;
+    readonly throttledCameras: number;
+    readonly avgInferenceTimeMs: number;
+    readonly queueDepth: number;
+}
+export interface CameraMetrics {
+    readonly priority: CameraPriority;
+    readonly configuredFps: number;
+    readonly actualFps: number;
+    readonly queueDepth: number;
+    readonly avgInferenceTimeMs: number;
+    readonly droppedFrames: number;
+    readonly phase: CameraPhase;
+}
+export interface PackageUpdate {
+    readonly name: string;
+    readonly currentVersion: string;
+    readonly latestVersion: string;
+    readonly category: 'addon' | 'core';
+    readonly requiresRestart: boolean;
+}
+export interface UpdateResult {
+    readonly success: boolean;
+    readonly version: string;
+    readonly requiresRestart: boolean;
+    readonly error?: string;
+}
+export interface DetectorDetails {
+    id: string;
+    name: string;
+    models: Array<{
+        id: string;
+        name: string;
+        inputSize?: {
+            width: number;
+            height: number;
+        };
+    }>;
+    runtimes: Array<{
+        value: string;
+        label: string;
+    }>;
+    backends: Array<{
+        value: string;
+        label: string;
+    }>;
+    defaultConfig: Record<string, unknown> | null;
+}
+//# sourceMappingURL=api-shared.d.ts.map

package/dist/interfaces/api-shared.d.ts.map

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

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

@@ -0,0 +1,39 @@
+/**
+ * Result returned by an auth provider after successful authentication.
+ */
+export interface AuthResult {
+    readonly externalId: string;
+    readonly username: string;
+    readonly email?: string;
+    readonly displayName?: string;
+    readonly avatarUrl?: string;
+    readonly groups?: string[];
+    readonly rawProfile?: unknown;
+}
+/**
+ * Pluggable authentication provider.
+ * Each addon can register one or more auth providers (collection capability).
+ */
+export interface IAuthProvider {
+    readonly id: string;
+    readonly name: string;
+    readonly icon: string;
+    /** Type of auth flow */
+    readonly flowType: 'credentials' | 'redirect' | 'token';
+    /**
+     * For 'credentials' flow: validate username/password, return user info.
+     */
+    validateCredentials?(username: string, password: string): Promise<AuthResult | null>;
+    /**
+     * For 'redirect' flow (OIDC, OAuth2):
+     * getLoginUrl() returns the URL to redirect the user to.
+     * handleCallback() processes the callback and returns user info.
+     */
+    getLoginUrl?(state: string): string;
+    handleCallback?(params: Record<string, string>): Promise<AuthResult>;
+    /**
+     * For 'token' flow: validate an external token (e.g., from mobile app).
+     */
+    validateToken?(token: string): Promise<AuthResult | null>;
+}
+//# sourceMappingURL=auth-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth-provider.d.ts","sourceRoot":"","sources":["../../src/interfaces/auth-provider.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,wBAAwB;IACxB,QAAQ,CAAC,QAAQ,EAAE,aAAa,GAAG,UAAU,GAAG,OAAO,CAAA;IAEvD;;OAEG;IACH,mBAAmB,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;IAEpF;;;;OAIG;IACH,WAAW,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACnC,cAAc,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAEpE;;OAEG;IACH,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAA;CAC1D"}

package/dist/interfaces/auth.d.ts

@@ -0,0 +1,47 @@
+export type UserRole = 'super_admin' | 'admin' | 'viewer' | 'agent';
+export interface UserPermissions {
+    role: UserRole;
+    allowedProviders: string[] | '*';
+    allowedDevices: Record<string, string[] | '*'>;
+}
+export interface UserRecord {
+    id: string;
+    username: string;
+    passwordHash: string;
+    role: UserRole;
+    allowedProviders: string[] | '*';
+    allowedDevices: Record<string, string[] | '*'>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ApiKeyRecord {
+    id: string;
+    label: string;
+    role: UserRole;
+    allowedProviders: string[] | '*';
+    allowedDevices: Record<string, string[] | '*'>;
+    tokenHash: string;
+    tokenPrefix: string;
+    createdAt: number;
+    lastUsedAt?: number;
+}
+export interface TokenPayload {
+    type?: 'api_key' | 'service';
+    keyId?: string;
+    userId?: string;
+    username?: string;
+    role: UserRole;
+    agentId?: string;
+    allowedProviders: string[] | '*';
+    allowedDevices: Record<string, string[] | '*'>;
+    iat?: number;
+    exp?: number;
+}
+export interface AuthenticatedUser {
+    id: string;
+    username: string;
+    role: UserRole;
+    permissions: UserPermissions;
+    isApiKey: boolean;
+}
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/interfaces/auth.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAA;AAEnE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,CAAA;IACd,gBAAgB,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;CAC/C;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,QAAQ,CAAA;IACd,gBAAgB,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,QAAQ,CAAA;IACd,gBAAgB,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,SAAS,GAAG,SAAS,CAAA;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,MAAM,EAAE,GAAG,GAAG,CAAA;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,QAAQ,CAAA;IACd,WAAW,EAAE,eAAe,CAAA;IAC5B,QAAQ,EAAE,OAAO,CAAA;CAClB"}