@camstack/core 0.1.1 → 0.1.3

package/dist/sql-schema-CKz78rId.d.mts

@@ -0,0 +1,97 @@
+import { IFileStorage, StorageLocationName, IStorageLocation, ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
+
+declare class FileSystemStorage implements IFileStorage {
+    private readonly basePath;
+    constructor(basePath: string);
+    readFile(filePath: string): Promise<Buffer>;
+    writeFile(filePath: string, data: Buffer): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    listFiles(prefix?: string): Promise<readonly string[]>;
+    getFileUrl(_path: string): Promise<string>;
+    exists(filePath: string): Promise<boolean>;
+}
+/** @deprecated Use FilesystemStorageProvider + SqliteSettingsBackend instead */
+declare class SqliteStorageProvider {
+    private mainDb;
+    private sharedStructured;
+    private readonly locations;
+    initialize(): Promise<void>;
+    /**
+     * Configure all storage locations.
+     * ONE single SQLite database (camstack.db) is used for ALL structured storage.
+     * File-based locations use the filesystem at their configured path.
+     */
+    configure(config: {
+        locations: Record<string, string>;
+    }): Promise<void>;
+    getLocation(name: StorageLocationName): IStorageLocation;
+    shutdown(): Promise<void>;
+    export(_locationName: StorageLocationName): Promise<Buffer>;
+    import(_locationName: StorageLocationName, _data: Buffer): Promise<void>;
+}
+
+declare class SqliteStorageAddon implements ICamstackAddon, IConfigurable {
+    readonly manifest: AddonManifest;
+    private provider;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getProvider(): SqliteStorageProvider;
+    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+    getConfigSchema(): ConfigUISchema;
+    getConfig(): Record<string, unknown>;
+    onConfigChange(_config: Record<string, unknown>): Promise<void>;
+}
+
+/**
+ * Thin wrapper over better-sqlite3 that manages the four settings tables:
+ * system_settings, addon_settings, provider_settings, device_settings.
+ *
+ * All values are stored as JSON text and deserialized on read.
+ */
+declare class SettingsStore {
+    private readonly db;
+    constructor(dbPath: string);
+    getSystem(key: string): unknown;
+    setSystem(key: string, value: unknown): void;
+    getAllSystem(): Record<string, unknown>;
+    getAddon(addonId: string, key: string): unknown;
+    setAddon(addonId: string, key: string, value: unknown): void;
+    getAllAddon(addonId: string): Record<string, unknown>;
+    /** Bulk-replace all keys for an addon (within a transaction). */
+    setAllAddon(addonId: string, config: Record<string, unknown>): void;
+    getProvider(providerId: string, key: string): unknown;
+    setProvider(providerId: string, key: string, value: unknown): void;
+    getAllProvider(providerId: string): Record<string, unknown>;
+    getDevice(deviceId: string, key: string): unknown;
+    setDevice(deviceId: string, key: string, value: unknown): void;
+    getAllDevice(deviceId: string): Record<string, unknown>;
+    /** Close the SQLite connection (call on shutdown). */
+    close(): void;
+    /** Check if system_settings is empty (used for first-boot seeding). */
+    isSystemSettingsEmpty(): boolean;
+    /** Seed system_settings with RUNTIME_DEFAULTS (only on first boot). */
+    seedDefaults(): void;
+    private initTables;
+}
+
+/** Core table DDL statements -- executed on first boot */
+declare const CORE_TABLE_DDL: readonly string[];
+/** Addon table schema declaration */
+interface AddonTableSchema {
+    readonly name: string;
+    readonly columns: ReadonlyArray<{
+        readonly name: string;
+        readonly type: 'TEXT' | 'INTEGER' | 'REAL' | 'JSON';
+        readonly primaryKey?: boolean;
+        readonly notNull?: boolean;
+    }>;
+    readonly indexes?: ReadonlyArray<{
+        readonly name: string;
+        readonly columns: readonly string[];
+        readonly unique?: boolean;
+    }>;
+}
+/** Generate CREATE TABLE DDL from addon schema */
+declare function addonTableToDdl(schema: AddonTableSchema): string[];
+
+export { type AddonTableSchema as A, CORE_TABLE_DDL as C, FileSystemStorage as F, SettingsStore as S, SqliteStorageAddon as a, SqliteStorageProvider as b, addonTableToDdl as c };

package/dist/sql-schema-CKz78rId.d.ts

@@ -0,0 +1,97 @@
+import { IFileStorage, StorageLocationName, IStorageLocation, ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
+
+declare class FileSystemStorage implements IFileStorage {
+    private readonly basePath;
+    constructor(basePath: string);
+    readFile(filePath: string): Promise<Buffer>;
+    writeFile(filePath: string, data: Buffer): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+    listFiles(prefix?: string): Promise<readonly string[]>;
+    getFileUrl(_path: string): Promise<string>;
+    exists(filePath: string): Promise<boolean>;
+}
+/** @deprecated Use FilesystemStorageProvider + SqliteSettingsBackend instead */
+declare class SqliteStorageProvider {
+    private mainDb;
+    private sharedStructured;
+    private readonly locations;
+    initialize(): Promise<void>;
+    /**
+     * Configure all storage locations.
+     * ONE single SQLite database (camstack.db) is used for ALL structured storage.
+     * File-based locations use the filesystem at their configured path.
+     */
+    configure(config: {
+        locations: Record<string, string>;
+    }): Promise<void>;
+    getLocation(name: StorageLocationName): IStorageLocation;
+    shutdown(): Promise<void>;
+    export(_locationName: StorageLocationName): Promise<Buffer>;
+    import(_locationName: StorageLocationName, _data: Buffer): Promise<void>;
+}
+
+declare class SqliteStorageAddon implements ICamstackAddon, IConfigurable {
+    readonly manifest: AddonManifest;
+    private provider;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getProvider(): SqliteStorageProvider;
+    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+    getConfigSchema(): ConfigUISchema;
+    getConfig(): Record<string, unknown>;
+    onConfigChange(_config: Record<string, unknown>): Promise<void>;
+}
+
+/**
+ * Thin wrapper over better-sqlite3 that manages the four settings tables:
+ * system_settings, addon_settings, provider_settings, device_settings.
+ *
+ * All values are stored as JSON text and deserialized on read.
+ */
+declare class SettingsStore {
+    private readonly db;
+    constructor(dbPath: string);
+    getSystem(key: string): unknown;
+    setSystem(key: string, value: unknown): void;
+    getAllSystem(): Record<string, unknown>;
+    getAddon(addonId: string, key: string): unknown;
+    setAddon(addonId: string, key: string, value: unknown): void;
+    getAllAddon(addonId: string): Record<string, unknown>;
+    /** Bulk-replace all keys for an addon (within a transaction). */
+    setAllAddon(addonId: string, config: Record<string, unknown>): void;
+    getProvider(providerId: string, key: string): unknown;
+    setProvider(providerId: string, key: string, value: unknown): void;
+    getAllProvider(providerId: string): Record<string, unknown>;
+    getDevice(deviceId: string, key: string): unknown;
+    setDevice(deviceId: string, key: string, value: unknown): void;
+    getAllDevice(deviceId: string): Record<string, unknown>;
+    /** Close the SQLite connection (call on shutdown). */
+    close(): void;
+    /** Check if system_settings is empty (used for first-boot seeding). */
+    isSystemSettingsEmpty(): boolean;
+    /** Seed system_settings with RUNTIME_DEFAULTS (only on first boot). */
+    seedDefaults(): void;
+    private initTables;
+}
+
+/** Core table DDL statements -- executed on first boot */
+declare const CORE_TABLE_DDL: readonly string[];
+/** Addon table schema declaration */
+interface AddonTableSchema {
+    readonly name: string;
+    readonly columns: ReadonlyArray<{
+        readonly name: string;
+        readonly type: 'TEXT' | 'INTEGER' | 'REAL' | 'JSON';
+        readonly primaryKey?: boolean;
+        readonly notNull?: boolean;
+    }>;
+    readonly indexes?: ReadonlyArray<{
+        readonly name: string;
+        readonly columns: readonly string[];
+        readonly unique?: boolean;
+    }>;
+}
+/** Generate CREATE TABLE DDL from addon schema */
+declare function addonTableToDdl(schema: AddonTableSchema): string[];
+
+export { type AddonTableSchema as A, CORE_TABLE_DDL as C, FileSystemStorage as F, SettingsStore as S, SqliteStorageAddon as a, SqliteStorageProvider as b, addonTableToDdl as c };

package/dist/sqlite-settings.addon-DigoKwpZ.d.mts

@@ -0,0 +1,70 @@
+import { ISettingsBackend, SettingsCollection, QueryFilter, SettingsRecord, ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
+
+/**
+ * SQLite implementation of ISettingsBackend.
+ *
+ * One table per collection, auto-created on first access.
+ * All data stored as JSON in a TEXT column.
+ * WAL mode for concurrent reads.
+ */
+declare class SqliteSettingsBackend implements ISettingsBackend {
+    private readonly dbPath;
+    private db;
+    private readonly ensuredTables;
+    private readonly runtimeDefaults;
+    constructor(dbPath: string, runtimeDefaults?: Record<string, unknown>);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    get(collection: SettingsCollection, key: string): Promise<unknown>;
+    set(collection: SettingsCollection, key: string, value: unknown): Promise<void>;
+    query(collection: SettingsCollection, filter?: QueryFilter): Promise<readonly SettingsRecord[]>;
+    insert(collection: SettingsCollection, record: SettingsRecord): Promise<void>;
+    update(collection: SettingsCollection, id: string, data: Record<string, unknown>): Promise<void>;
+    delete(collection: SettingsCollection, key: string): Promise<void>;
+    count(collection: SettingsCollection, filter?: QueryFilter): Promise<number>;
+    isEmpty(collection: SettingsCollection): Promise<boolean>;
+    /** Get a system setting by dot-notation key */
+    getSystem(key: string): unknown;
+    /** Set a system setting */
+    setSystem(key: string, value: unknown): void;
+    /** Get all system settings as flat key-value */
+    getAllSystem(): Record<string, unknown>;
+    /** Get all settings for an addon */
+    getAllAddon(addonId: string): Record<string, unknown>;
+    /** Bulk-set all settings for an addon */
+    setAllAddon(addonId: string, config: Record<string, unknown>): void;
+    /** Get all settings for a provider */
+    getAllProvider(providerId: string): Record<string, unknown>;
+    /** Set a provider setting */
+    setProvider(providerId: string, key: string, value: unknown): void;
+    /** Get all settings for a device */
+    getAllDevice(deviceId: string): Record<string, unknown>;
+    /** Set a device setting */
+    setDevice(deviceId: string, key: string, value: unknown): void;
+    /** Seed system-settings with runtime defaults (first boot) */
+    private seedDefaults;
+    private getDb;
+    private ensureTable;
+    private getAllScoped;
+    private setScopedKey;
+}
+
+/**
+ * SQLite Settings addon — provides persistent settings storage.
+ * Capability: 'settings-store' (singleton)
+ *
+ * Depends on 'storage' capability for resolving the DB file path.
+ */
+declare class SqliteSettingsAddon implements ICamstackAddon, IConfigurable {
+    readonly manifest: AddonManifest;
+    private backend;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getBackend(): SqliteSettingsBackend | null;
+    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+    getConfigSchema(): ConfigUISchema;
+    getConfig(): Record<string, unknown>;
+    onConfigChange(_config: Record<string, unknown>): Promise<void>;
+}
+
+export { SqliteSettingsAddon as S, SqliteSettingsBackend as a };

package/dist/sqlite-settings.addon-DigoKwpZ.d.ts

@@ -0,0 +1,70 @@
+import { ISettingsBackend, SettingsCollection, QueryFilter, SettingsRecord, ICamstackAddon, IConfigurable, AddonManifest, AddonContext, CapabilityProviderMap, ConfigUISchema } from '@camstack/types';
+
+/**
+ * SQLite implementation of ISettingsBackend.
+ *
+ * One table per collection, auto-created on first access.
+ * All data stored as JSON in a TEXT column.
+ * WAL mode for concurrent reads.
+ */
+declare class SqliteSettingsBackend implements ISettingsBackend {
+    private readonly dbPath;
+    private db;
+    private readonly ensuredTables;
+    private readonly runtimeDefaults;
+    constructor(dbPath: string, runtimeDefaults?: Record<string, unknown>);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    get(collection: SettingsCollection, key: string): Promise<unknown>;
+    set(collection: SettingsCollection, key: string, value: unknown): Promise<void>;
+    query(collection: SettingsCollection, filter?: QueryFilter): Promise<readonly SettingsRecord[]>;
+    insert(collection: SettingsCollection, record: SettingsRecord): Promise<void>;
+    update(collection: SettingsCollection, id: string, data: Record<string, unknown>): Promise<void>;
+    delete(collection: SettingsCollection, key: string): Promise<void>;
+    count(collection: SettingsCollection, filter?: QueryFilter): Promise<number>;
+    isEmpty(collection: SettingsCollection): Promise<boolean>;
+    /** Get a system setting by dot-notation key */
+    getSystem(key: string): unknown;
+    /** Set a system setting */
+    setSystem(key: string, value: unknown): void;
+    /** Get all system settings as flat key-value */
+    getAllSystem(): Record<string, unknown>;
+    /** Get all settings for an addon */
+    getAllAddon(addonId: string): Record<string, unknown>;
+    /** Bulk-set all settings for an addon */
+    setAllAddon(addonId: string, config: Record<string, unknown>): void;
+    /** Get all settings for a provider */
+    getAllProvider(providerId: string): Record<string, unknown>;
+    /** Set a provider setting */
+    setProvider(providerId: string, key: string, value: unknown): void;
+    /** Get all settings for a device */
+    getAllDevice(deviceId: string): Record<string, unknown>;
+    /** Set a device setting */
+    setDevice(deviceId: string, key: string, value: unknown): void;
+    /** Seed system-settings with runtime defaults (first boot) */
+    private seedDefaults;
+    private getDb;
+    private ensureTable;
+    private getAllScoped;
+    private setScopedKey;
+}
+
+/**
+ * SQLite Settings addon — provides persistent settings storage.
+ * Capability: 'settings-store' (singleton)
+ *
+ * Depends on 'storage' capability for resolving the DB file path.
+ */
+declare class SqliteSettingsAddon implements ICamstackAddon, IConfigurable {
+    readonly manifest: AddonManifest;
+    private backend;
+    initialize(context: AddonContext): Promise<void>;
+    shutdown(): Promise<void>;
+    getBackend(): SqliteSettingsBackend | null;
+    getCapabilityProvider<K extends keyof CapabilityProviderMap>(name: K): CapabilityProviderMap[K] | null;
+    getConfigSchema(): ConfigUISchema;
+    getConfig(): Record<string, unknown>;
+    onConfigChange(_config: Record<string, unknown>): Promise<void>;
+}
+
+export { SqliteSettingsAddon as S, SqliteSettingsBackend as a };

package/dist/{storage-location-manager-F4YZMHGM.mjs → storage-location-manager-UQRGHTCA.mjs}

@@ -1,8 +1,8 @@
 import {
   StorageLocationManager
 } from "./chunk-2F3XZYRW.mjs";
-import "./chunk-LZOMFHX3.mjs";
+import "./chunk-QEMJH3KY.mjs";
 export {
   StorageLocationManager
 };
-//# sourceMappingURL=storage-location-manager-F4YZMHGM.mjs.map
+//# sourceMappingURL=storage-location-manager-UQRGHTCA.mjs.map

package/dist/storage-location-manager-UQRGHTCA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/{wrapper-NTBY5HOA.mjs → wrapper-Y55ADNM5.mjs}

@@ -2,7 +2,7 @@ import {
   __commonJS,
   __require,
   __toESM
-} from "./chunk-LZOMFHX3.mjs";
+} from "./chunk-QEMJH3KY.mjs";
 
 // ../../node_modules/ws/lib/constants.js
 var require_constants = __commonJS({
@@ -3649,4 +3649,4 @@ export {
   export_extension as extension,
   export_subprotocol as subprotocol
 };
-//# sourceMappingURL=wrapper-NTBY5HOA.mjs.map
+//# sourceMappingURL=wrapper-Y55ADNM5.mjs.map

package/package.json

@@ -1,8 +1,14 @@
 {
   "name": "@camstack/core",
-  "version": "0.1.1",
-  "description": "Core runtime infrastructure for CamStack — addon loader, model downloader, python env, event bus",
-  "keywords": ["camstack", "core", "addon-loader", "camera", "nvr"],
+  "version": "0.1.3",
+  "description": "Core addon for CamStack — builtins, pipeline, process management, auth, logging, events",
+  "keywords": [
+    "camstack",
+    "core",
+    "addon",
+    "camera",
+    "nvr"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,14 +18,60 @@
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": { "import": "./dist/index.mjs", "require": "./dist/index.js", "types": "./dist/index.d.ts" }
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
   },
   "camstack": {
     "addons": [
-      { "id": "core", "entry": "./dist/index.js", "slot": null }
+      {
+        "id": "filesystem-storage",
+        "entry": "./dist/builtins/sqlite-storage/filesystem-storage.addon.js",
+        "capabilities": [
+          {
+            "name": "storage",
+            "mode": "collection"
+          }
+        ]
+      },
+      {
+        "id": "sqlite-settings",
+        "entry": "./dist/builtins/sqlite-storage/sqlite-settings.addon.js",
+        "capabilities": [
+          {
+            "name": "settings-store",
+            "mode": "singleton"
+          }
+        ]
+      },
+      {
+        "id": "winston-logging",
+        "entry": "./dist/builtins/winston-logging/index.js",
+        "capabilities": [
+          {
+            "name": "log-destination",
+            "mode": "collection"
+          }
+        ]
+      },
+      {
+        "id": "local-backup",
+        "entry": "./dist/builtins/local-backup/index.js",
+        "capabilities": [
+          {
+            "name": "backup",
+            "mode": "collection"
+          }
+        ]
+      }
     ]
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
@@ -28,20 +80,20 @@
     "test:watch": "vitest"
   },
   "dependencies": {
+    "@camstack/kernel": "*",
     "bcryptjs": "^2.4.3",
     "better-sqlite3": "^12.8.0",
-    "js-yaml": "^4.1.0",
     "jsonwebtoken": "^9.0.0",
+    "systeminformation": "^5.31.5",
     "winston": "^3.19.0",
-    "winston-daily-rotate-file": "^5.0.0",
-    "zod": "^3.22.0"
+    "winston-daily-rotate-file": "^5.0.0"
+  },
+  "peerDependencies": {
+    "@camstack/types": "^0.1.0"
   },
-  "peerDependencies": { "@camstack/types": "^0.1.0" },
   "devDependencies": {
     "@camstack/types": "*",
     "@types/bcryptjs": "^2.4.6",
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/js-yaml": "^4.0.9",
     "@types/jsonwebtoken": "^9.0.0",
     "tsup": "^8.0.0",
     "typescript": "~5.9.0",