@camstack/sdk 0.1.35 → 0.1.37

package/dist/backend-client.d.ts

@@ -1,315 +0,0 @@
-/**
- * Backend client — connects directly to the CamStack NestJS backend via tRPC.
- *
- * Use this when the client needs to talk to the backend server directly
- * (admin UI, local agent, embedded mode) rather than going through the proxy.
- *
- * Features: full typed access to all backend tRPC routes (auth, devices, providers,
- * pipeline, agents, addons, bridge pipeline, recording, events, live subscriptions).
- */
-import { createTRPCClient } from "@trpc/client";
-import type { BackendAppRouter } from "./backend-router.js";
-export type SettingsSection = 'server' | 'auth' | 'features' | 'storage' | 'logging' | 'addons' | 'recording' | 'streaming' | 'ffmpeg' | 'detection' | 'backup' | 'retention';
-export interface BackendClientConfig {
-    /** Backend server URL (e.g. "http://localhost:4443") */
-    readonly serverUrl: string;
-    /** JWT token for authentication */
-    readonly token?: string;
-    /** Connection timeout in ms (default: 10000) */
-    readonly connectTimeoutMs?: number;
-    /** Use WebSocket for all queries/mutations (default: true in browser, false in Node) */
-    readonly useWebSocket?: boolean;
-}
-export declare class BackendClient {
-    /** Raw tRPC client — for advanced usage / direct path access */
-    readonly trpc: ReturnType<typeof createTRPCClient<BackendAppRouter>>;
-    readonly serverUrl: string;
-    private token;
-    private wsClient;
-    constructor(config: BackendClientConfig);
-    /** Update the auth token (e.g. after login) */
-    setToken(token: string): void;
-    /** Close the WebSocket connection (if using WS transport) */
-    close(): void;
-    login(username: string, password: string): Promise<{
-        token: string;
-        user: {
-            id: string;
-            username: string;
-            role: import("@camstack/types").UserRole;
-        };
-    }>;
-    getMe(): Promise<import("@camstack/types").AuthenticatedUser>;
-    logout(): Promise<{
-        success: boolean;
-    }>;
-    getSystemInfo(): Promise<{
-        version: string;
-        uptime: number;
-        nodeVersion: string;
-        platform: NodeJS.Platform;
-        features: import("@camstack/types").FeatureManifest;
-    }>;
-    getFeatureFlags(): Promise<import("@camstack/types").FeatureManifest>;
-    listProviders(): Promise<readonly import("@camstack/types").ProviderListItem[]>;
-    getProvider(providerId: string): Promise<{
-        id: string;
-        type: string;
-        name: string;
-        discoveryMode: "auto" | "manual" | "both";
-        status: import("@camstack/types").ProviderStatus;
-        deviceCount: number;
-    }>;
-    startProvider(providerId: string): Promise<{
-        success: boolean;
-    }>;
-    stopProvider(providerId: string): Promise<{
-        success: boolean;
-    }>;
-    listProviderTypes(): Promise<{
-        addonId: string;
-        name: string;
-        description: string;
-        iconUrl: string | null;
-        color: string;
-        instanceMode: "unique" | "multiple";
-        discoveryMode: "auto" | "manual" | "both";
-        existingInstances: {
-            id: string;
-            name: string;
-        }[];
-        canAdd: boolean;
-    }[]>;
-    listDevices(): Promise<{
-        id: string;
-        name: string;
-        providerId: string;
-        type: import("@camstack/types").DeviceType;
-        capabilities: import("@camstack/types").DeviceCapabilityName[];
-        state: import("@camstack/types").DeviceState;
-    }[]>;
-    getDevice(deviceId: string): Promise<{
-        id: string;
-        name: string;
-        providerId: string;
-        type: import("@camstack/types").DeviceType;
-        capabilities: import("@camstack/types").DeviceCapabilityName[];
-        state: import("@camstack/types").DeviceState;
-        metadata: import("@camstack/types").DeviceMetadata;
-    }>;
-    discoverDevices(providerId: string): Promise<import("@camstack/types").DiscoveredDevice[]>;
-    adoptDevice(providerId: string, externalId: string): Promise<import("@camstack/types").IDevice>;
-    createDevice(providerId: string, config: Record<string, unknown>): Promise<import("@camstack/types").IDevice>;
-    /** Returns the URL path for a static asset served by an addon. */
-    getAddonAssetUrl(addonId: string, assetPath: string): string;
-    listAddons(): Promise<{
-        manifest: import("@camstack/types").AddonManifest & {
-            packageName: string;
-            packageVersion: string;
-            packageDisplayName?: string;
-            protected?: boolean;
-            removable?: boolean;
-        };
-        declaration?: import("@camstack/types").AddonDeclaration;
-        hasConfigSchema: boolean;
-        source: "core" | "installed" | "workspace";
-        installSource?: "npm" | "workspace";
-    }[]>;
-    getAddonConfigSchema(addonId: string): Promise<import("@camstack/types").ConfigUISchema | null>;
-    getAddonConfig(addonId: string): Promise<Record<string, unknown>>;
-    updateAddonConfig(addonId: string, config: Record<string, unknown>): Promise<{
-        success: boolean;
-    }>;
-    getAddonLogs(addonId: string, options?: {
-        limit?: number;
-        level?: 'debug' | 'info' | 'warn' | 'error';
-    }): Promise<import("@camstack/types").LogEntry[]>;
-    listKnownFaces(): Promise<{
-        id: string;
-        label: string;
-        group?: string;
-        cropBase64: string;
-        createdAt: number;
-        updatedAt: number;
-        source?: string;
-        metadata?: Readonly<Record<string, unknown>>;
-    }[]>;
-    registerFace(label: string, cropBase64: string, group?: string): Promise<never>;
-    listPipelines(): Promise<{
-        id: string;
-        packageName: string;
-        slot: import("@camstack/types").PipelineSlot | null;
-    }[]>;
-    getPipelineStatus(deviceId: string): Promise<import("@camstack/types").PipelineConfig | null>;
-    listAgents(): Promise<readonly import("@camstack/types").AgentListItem[]>;
-    dispatchTask(agentId: string, task: Record<string, unknown>): Promise<import("@camstack/types").AgentTaskResult>;
-    getProcessTree(): Promise<{
-        id: string;
-        name: string;
-        pid: number;
-        state: "running";
-        cpuPercent: number;
-        memoryPercent: number;
-        memoryMB: number;
-        isHub: boolean;
-        platform: string;
-        arch: string;
-        host: string;
-        capabilities: string[];
-        installedAddons: string[];
-        pythonRuntimes: string[];
-        connectedSince: number;
-        subProcesses: unknown[];
-    }[]>;
-    bridgeListAddons(): Promise<{
-        id: string;
-        packageName: string;
-        slot: import("@camstack/types").PipelineSlot | null;
-    }[]>;
-    bridgeGetPipeline(deviceId: string): Promise<import("@camstack/types").PipelineConfig | null>;
-    bridgeSetPipeline(deviceId: string, config: {
-        video: unknown[];
-        audio?: unknown;
-    }): Promise<{
-        success: boolean;
-    }>;
-    bridgeValidatePipeline(config: {
-        video: unknown[];
-        audio?: unknown;
-    }): Promise<import("@camstack/types").ValidationResult>;
-    bridgeGetAddonConfig(addonId: string): Promise<Record<string, unknown>>;
-    bridgeSetAddonConfig(addonId: string, config: Record<string, unknown>): Promise<{
-        success: boolean;
-    }>;
-    bridgeListPackages(): Promise<import("@camstack/types").InstalledPackage[]>;
-    bridgeListAddonsPackages(): Promise<{
-        manifest: import("@camstack/types").AddonManifest & {
-            packageName: string;
-            packageVersion: string;
-            packageDisplayName?: string;
-            protected?: boolean;
-            removable?: boolean;
-        };
-        declaration?: import("@camstack/types").AddonDeclaration;
-        hasConfigSchema: boolean;
-        source: "core" | "installed" | "workspace";
-        installSource?: "npm" | "workspace";
-    }[]>;
-    bridgeInstallPackage(packageName: string, version?: string): Promise<{
-        success: boolean;
-        loaded: string[];
-        failed: string[];
-    }>;
-    bridgeUninstallPackage(packageName: string): Promise<{
-        success: boolean;
-    }>;
-    getRecordingConfig(deviceId: string): Promise<unknown>;
-    getRecordingPolicy(deviceId: string): Promise<unknown>;
-    getRecordingPolicyStatus(deviceId: string): Promise<{
-        deviceId: string;
-        policyExists: boolean;
-        enabled: any;
-        mode: any;
-        isRecording: boolean;
-    }>;
-    getRecordingSegments(deviceId: string, streamId: string, startTime: number, endTime: number): Promise<unknown>;
-    getEvents(deviceId: string, options?: {
-        limit?: number;
-        offset?: number;
-    }): Promise<import("@camstack/types").EventQueryResult>;
-    getLogs(options?: {
-        level?: 'debug' | 'info' | 'warn' | 'error';
-        limit?: number;
-        since?: number;
-        until?: number;
-        scope?: string[];
-    }): Promise<import("@camstack/types").LogEntry[]>;
-    replEval(code: string, scope?: {
-        type: 'system';
-    } | {
-        type: 'device';
-        deviceId: string;
-    } | {
-        type: 'provider';
-        providerId: string;
-    } | {
-        type: 'addon';
-        addonId: string;
-    }): Promise<import("@camstack/types").ReplResult>;
-    listUsers(): Promise<Omit<import("@camstack/types").UserRecord, "passwordHash">[]>;
-    createUser(username: string, password: string, role: 'super_admin' | 'admin' | 'viewer'): Promise<{
-        id: string;
-        username: string;
-        role: import("@camstack/types").UserRole;
-        allowedProviders: string[] | "*";
-        allowedDevices: Record<string, string[] | "*">;
-        createdAt: number;
-        updatedAt: number;
-    }>;
-    getTrackingSessions(deviceId?: string): Promise<{
-        trackId: string;
-        deviceId: string;
-        className: string;
-        label: string | undefined;
-        firstSeen: number;
-        lastSeen: number;
-        totalFrames: number;
-        state: string;
-        globalId: string | undefined;
-        positions: readonly {
-            readonly x: number;
-            readonly y: number;
-            readonly t: number;
-        }[];
-        hasEmbedding: boolean;
-        hasCrop: boolean;
-    }[]>;
-    listProcesses(): Promise<(import("@camstack/types").ManagedProcessStatus | {
-        id: string;
-        label: string;
-        state: "running" | "stopped" | "crashed" | "starting";
-        pid?: number;
-        stats?: {
-            pid: number;
-            cpu: number;
-            memory: number;
-            uptime: number;
-            restartCount: number;
-        };
-        restartCount: number;
-        mode: "forked" | "in-process";
-    })[]>;
-    enableProvider(providerId: string): Promise<{
-        success: boolean;
-    }>;
-    disableProvider(providerId: string): Promise<{
-        success: boolean;
-    }>;
-    /** Fetch the UI schema for a single section, or all sections if omitted. */
-    getSettingsSchema(section?: SettingsSection): Promise<{
-        section: "auth" | "features" | "server" | "storage" | "logging" | "addons" | "recording" | "streaming" | "ffmpeg" | "detection" | "backup" | "retention";
-        schema: import("@camstack/types").ConfigUISchema | null;
-        readOnly: boolean;
-        tabs?: undefined;
-        schemas?: undefined;
-    } | {
-        tabs: readonly import("@camstack/types").SettingsTabDef[];
-        schemas: Record<string, unknown>;
-        section?: undefined;
-        schema?: undefined;
-        readOnly?: undefined;
-    }>;
-    getSettings(section: SettingsSection): Promise<{
-        section: "auth" | "features" | "server" | "storage" | "logging" | "addons" | "recording" | "streaming" | "ffmpeg" | "detection" | "backup" | "retention";
-        data: Record<string, unknown>;
-    }>;
-    updateSettings(section: SettingsSection, data: Record<string, unknown>): Promise<{
-        success: boolean;
-        section: "auth" | "features" | "server" | "storage" | "logging" | "addons" | "recording" | "streaming" | "ffmpeg" | "detection" | "backup" | "retention";
-    }>;
-}
-/**
- * Create a BackendClient instance with the given config.
- * Convenience factory function.
- */
-export declare function createBackendClient(config: BackendClientConfig): BackendClient;