@tomorrowos/sdk 0.4.7 → 0.4.8

package/README.md

@@ -38,6 +38,15 @@ npm install
 npm run dev
 ```
 
+`tomorrowos init` creates `data/tomorrowos.db` with the TomorrowOS SQLite
+schema. The starter server uses that SQLite database by default, so pairings,
+playlists, and device assignments survive normal server restarts.
+
+For throwaway demos/tests, set `TOMORROWOS_STORE=memory`. For production cloud
+databases such as Supabase/Postgres, implement `TomorrowOSStore` and pass it to
+`new TomorrowOS({ brand, store })`; the SDK keeps persistence behind that
+interface.
+
 Build a player (placeholder in current SDK — see `PLAYER_INSTALL.md` for platform tooling):
 
 ```bash

package/dist/cli.js

@@ -2,6 +2,7 @@
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
+import { SQLiteStore } from "./store/sqlite-store.js";
 function packageRoot() {
     const here = path.dirname(fileURLToPath(import.meta.url));
     return path.resolve(here, "..");
@@ -32,6 +33,12 @@ function removeStarterArtifacts(destDir) {
     if (fs.existsSync(modulesPath))
         fs.rmSync(modulesPath, { recursive: true, force: true });
 }
+function initializeStarterSQLite(destDir) {
+    const dbPath = path.join(path.resolve(destDir), "data", "tomorrowos.db");
+    const store = new SQLiteStore(dbPath);
+    store.close();
+    return dbPath;
+}
 /** Align generated cms-starter package.json with the installed SDK version. */
 function patchStarterPackageJson(destDir) {
     const pkgPath = path.join(path.resolve(destDir), "package.json");
@@ -68,9 +75,11 @@ function copyStarter(destDir, force) {
     });
     patchStarterPackageJson(resolved);
     removeStarterArtifacts(resolved);
+    const dbPath = initializeStarterSQLite(resolved);
     const sdkVer = getSdkVersion();
     console.log(`[tomorrowos] Created CMS project at ${resolved}`);
     console.log(`[tomorrowos] @tomorrowos/sdk dependency: ^${sdkVer}`);
+    console.log(`[tomorrowos] Initialized SQLite database: ${dbPath}`);
     console.log("Next: cd there, run npm install, then npm start");
 }
 function cmdBuild(argv) {

package/dist/index.d.ts

@@ -5,4 +5,7 @@ export { PlaylistCatalog } from "./playlist-catalog.js";
 export type { BuiltDevicePolicy, SavePlaylistInput } from "./playlist-catalog.js";
 export { generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.js";
+export { SQLiteStore } from "./store/sqlite-store.js";
+export { createTomorrowOSStore, defaultSQLitePath } from "./store/factory.js";
+export type { CreateTomorrowOSStoreOptions, TomorrowOSStoreDriver } from "./store/factory.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -2,3 +2,5 @@ export { TomorrowOS } from "./tomorrowos.js";
 export { PlaylistCatalog } from "./playlist-catalog.js";
 export { generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.js";
+export { SQLiteStore } from "./store/sqlite-store.js";
+export { createTomorrowOSStore, defaultSQLitePath } from "./store/factory.js";

package/dist/store/factory.d.ts

@@ -0,0 +1,20 @@
+import type { TomorrowOSStore } from "./types.js";
+export type TomorrowOSStoreDriver = "sqlite" | "memory";
+export interface CreateTomorrowOSStoreOptions {
+    /**
+     * Defaults to TOMORROWOS_STORE, then sqlite.
+     * Use memory only for tests or throwaway demos.
+     */
+    driver?: TomorrowOSStoreDriver;
+    /** Defaults to TOMORROWOS_DB_PATH, then ./data/tomorrowos.db. */
+    sqlitePath?: string;
+    /**
+     * Reserved for external database adapters. Supabase exposes Postgres URLs,
+     * which should be handled by a Postgres TomorrowOSStore implementation.
+     */
+    databaseUrl?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function defaultSQLitePath(cwd?: string): string;
+export declare function createTomorrowOSStore(options?: CreateTomorrowOSStoreOptions): TomorrowOSStore;
+//# sourceMappingURL=factory.d.ts.map

package/dist/store/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/store/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExD,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,SAAgB,GAAG,MAAM,CAE7D;AAED,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,eAAe,CAwBjB"}

package/dist/store/factory.js

@@ -0,0 +1,23 @@
+import path from "path";
+import { MemoryStore } from "./memory-store.js";
+import { SQLiteStore } from "./sqlite-store.js";
+export function defaultSQLitePath(cwd = process.cwd()) {
+    return path.join(cwd, "data", "tomorrowos.db");
+}
+export function createTomorrowOSStore(options = {}) {
+    const env = options.env ?? process.env;
+    const driver = (options.driver ?? env.TOMORROWOS_STORE ?? "sqlite").toLowerCase();
+    const databaseUrl = options.databaseUrl ?? env.DATABASE_URL;
+    if (driver === "memory") {
+        return new MemoryStore();
+    }
+    if (driver !== "sqlite") {
+        throw new Error(`Unsupported TOMORROWOS_STORE "${driver}". Use "sqlite", "memory", or pass a custom TomorrowOSStore to new TomorrowOS({ store }).`);
+    }
+    if (databaseUrl) {
+        throw new Error("DATABASE_URL is set, but @tomorrowos/sdk does not include a Postgres/Supabase adapter yet. Pass a custom TomorrowOSStore to new TomorrowOS({ store }) or unset DATABASE_URL to use SQLite.");
+    }
+    return new SQLiteStore({
+        databasePath: options.sqlitePath ?? env.TOMORROWOS_DB_PATH ?? defaultSQLitePath()
+    });
+}

package/dist/store/sqlite-store.d.ts

@@ -0,0 +1,39 @@
+import type { DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceEntry, PairedDeviceRecord, PendingCodeRecord, StoredPlaylist, TomorrowOSStore } from "./types.js";
+interface SQLiteStoreOptions {
+    databasePath?: string;
+}
+/**
+ * Durable single-node store backed by a local SQLite database.
+ * For multi-instance production, inject a Postgres/Supabase-backed TomorrowOSStore instead.
+ */
+export declare class SQLiteStore implements TomorrowOSStore {
+    readonly databasePath: string;
+    private readonly db;
+    constructor(options?: SQLiteStoreOptions | string);
+    init(): void;
+    close(): void;
+    setPendingCode(code: string, record: PendingCodeRecord): Promise<void>;
+    getPendingCode(code: string): Promise<PendingCodeRecord | undefined>;
+    deletePendingCode(code: string): Promise<void>;
+    getDeviceRegistry(deviceId: string): Promise<DeviceRegistryRecord | undefined>;
+    setDeviceRegistry(deviceId: string, record: DeviceRegistryRecord): Promise<void>;
+    getDeviceRegistryByCode(code: string): Promise<{
+        deviceId: string;
+        record: DeviceRegistryRecord;
+    } | undefined>;
+    setPairedDevice(deviceId: string, record: PairedDeviceRecord): Promise<void>;
+    getPairedDevice(deviceId: string): Promise<PairedDeviceRecord | undefined>;
+    deletePairedDevice(deviceId: string): Promise<void>;
+    listPairedDevices(): Promise<PairedDeviceEntry[]>;
+    listPlaylists(): Promise<StoredPlaylist[]>;
+    getPlaylist(id: string): Promise<StoredPlaylist | undefined>;
+    setPlaylist(record: StoredPlaylist): Promise<void>;
+    isPlaylistNameTaken(name: string, excludeId?: string): Promise<boolean>;
+    getDeviceAssignments(deviceId: string): Promise<DevicePlaylistAssignment[]>;
+    setDeviceAssignments(deviceId: string, assignments: DevicePlaylistAssignment[]): Promise<void>;
+    private mapDeviceRegistryRow;
+    private mapPairedDeviceRow;
+    private mapPlaylistRow;
+}
+export {};
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/store/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/store/sqlite-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAGjB,cAAc,EACd,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,UAAU,kBAAkB;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA8DD;;;GAGG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAoB;gBAE3B,OAAO,GAAE,kBAAkB,GAAG,MAAW;IAerD,IAAI,IAAI,IAAI;IAwEZ,KAAK,IAAI,IAAI;IAIP,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAUpE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,iBAAiB,CACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAStC,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA2BV,uBAAuB,CAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,GAAG,SAAS,CAAC;IAapE,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC;IAuCV,eAAe,CACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IASpC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAYjD,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAS1C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAS5D,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAiClD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAcvE,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAoBhC,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,wBAAwB,EAAE,GACtC,OAAO,CAAC,IAAI,CAAC;IA8BhB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,cAAc;CAYvB"}

package/dist/store/sqlite-store.js

@@ -0,0 +1,345 @@
+import fs from "fs";
+import path from "path";
+import Database from "better-sqlite3";
+const DEFAULT_SQLITE_PATH = path.join(process.cwd(), "data", "tomorrowos.db");
+function optionalString(value) {
+    return value ?? undefined;
+}
+function optionalNumber(value) {
+    return value ?? undefined;
+}
+function parseJson(raw, fallback) {
+    if (!raw)
+        return fallback;
+    return JSON.parse(raw);
+}
+/**
+ * Durable single-node store backed by a local SQLite database.
+ * For multi-instance production, inject a Postgres/Supabase-backed TomorrowOSStore instead.
+ */
+export class SQLiteStore {
+    databasePath;
+    db;
+    constructor(options = {}) {
+        const databasePath = typeof options === "string"
+            ? options
+            : options.databasePath ?? DEFAULT_SQLITE_PATH;
+        this.databasePath = databasePath === ":memory:" ? databasePath : path.resolve(databasePath);
+        if (this.databasePath !== ":memory:") {
+            fs.mkdirSync(path.dirname(this.databasePath), { recursive: true });
+        }
+        this.db = new Database(this.databasePath);
+        this.init();
+    }
+    init() {
+        this.db.pragma("foreign_keys = ON");
+        this.db.pragma("journal_mode = WAL");
+        this.db.pragma("busy_timeout = 5000");
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS schema_migrations (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL UNIQUE,
+        applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+      );
+
+      CREATE TABLE IF NOT EXISTS pending_codes (
+        code TEXT PRIMARY KEY,
+        device_id TEXT NOT NULL,
+        created_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS device_registry (
+        device_id TEXT PRIMARY KEY,
+        permanent_pairing_code TEXT NOT NULL UNIQUE,
+        code_created_at INTEGER NOT NULL,
+        serial_number TEXT,
+        first_seen_at INTEGER,
+        last_hello_at INTEGER
+      );
+
+      CREATE TABLE IF NOT EXISTS paired_devices (
+        device_id TEXT PRIMARY KEY,
+        pairing_token TEXT NOT NULL,
+        paired_at TEXT NOT NULL,
+        device_name TEXT,
+        platform TEXT,
+        system TEXT,
+        last_boot_at TEXT,
+        last_online_at TEXT,
+        last_offline_at TEXT,
+        last_policy_push_at TEXT
+      );
+
+      CREATE TABLE IF NOT EXISTS playlists (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        schedule_json TEXT,
+        items_json TEXT NOT NULL DEFAULT '[]',
+        version INTEGER NOT NULL,
+        updated_at TEXT NOT NULL,
+        retired INTEGER NOT NULL DEFAULT 0,
+        retired_at TEXT
+      );
+
+      CREATE UNIQUE INDEX IF NOT EXISTS playlists_active_name_unique
+        ON playlists (lower(trim(name)))
+        WHERE retired = 0;
+
+      CREATE TABLE IF NOT EXISTS device_assignments (
+        device_id TEXT NOT NULL,
+        playlist_id TEXT NOT NULL,
+        sort_order INTEGER NOT NULL,
+        published_version INTEGER NOT NULL,
+        published_at TEXT NOT NULL,
+        snapshot_json TEXT NOT NULL,
+        PRIMARY KEY (device_id, playlist_id)
+      );
+
+      CREATE INDEX IF NOT EXISTS device_assignments_device_order_idx
+        ON device_assignments (device_id, sort_order);
+
+      INSERT OR IGNORE INTO schema_migrations (id, name)
+        VALUES (1, 'initial_tomorrowos_store');
+    `);
+    }
+    close() {
+        this.db.close();
+    }
+    async setPendingCode(code, record) {
+        this.db.prepare(`
+      INSERT INTO pending_codes (code, device_id, created_at)
+      VALUES (?, ?, ?)
+      ON CONFLICT(code) DO UPDATE SET
+        device_id = excluded.device_id,
+        created_at = excluded.created_at
+    `).run(code, record.deviceId, record.createdAt);
+    }
+    async getPendingCode(code) {
+        const row = this.db.prepare(`
+      SELECT device_id, created_at
+      FROM pending_codes
+      WHERE code = ?
+    `).get(code);
+        if (!row)
+            return undefined;
+        return { deviceId: row.device_id, createdAt: row.created_at };
+    }
+    async deletePendingCode(code) {
+        this.db.prepare("DELETE FROM pending_codes WHERE code = ?").run(code);
+    }
+    async getDeviceRegistry(deviceId) {
+        const row = this.db.prepare(`
+      SELECT *
+      FROM device_registry
+      WHERE device_id = ?
+    `).get(deviceId);
+        return row ? this.mapDeviceRegistryRow(row) : undefined;
+    }
+    async setDeviceRegistry(deviceId, record) {
+        this.db.prepare(`
+      INSERT INTO device_registry (
+        device_id,
+        permanent_pairing_code,
+        code_created_at,
+        serial_number,
+        first_seen_at,
+        last_hello_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?)
+      ON CONFLICT(device_id) DO UPDATE SET
+        permanent_pairing_code = excluded.permanent_pairing_code,
+        code_created_at = excluded.code_created_at,
+        serial_number = excluded.serial_number,
+        first_seen_at = excluded.first_seen_at,
+        last_hello_at = excluded.last_hello_at
+    `).run(deviceId, record.permanentPairingCode, record.codeCreatedAt, record.serialNumber ?? null, record.firstSeenAt ?? null, record.lastHelloAt ?? null);
+    }
+    async getDeviceRegistryByCode(code) {
+        const row = this.db.prepare(`
+      SELECT *
+      FROM device_registry
+      WHERE permanent_pairing_code = ?
+    `).get(code);
+        if (!row)
+            return undefined;
+        return {
+            deviceId: row.device_id,
+            record: this.mapDeviceRegistryRow(row)
+        };
+    }
+    async setPairedDevice(deviceId, record) {
+        this.db.prepare(`
+      INSERT INTO paired_devices (
+        device_id,
+        pairing_token,
+        paired_at,
+        device_name,
+        platform,
+        system,
+        last_boot_at,
+        last_online_at,
+        last_offline_at,
+        last_policy_push_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(device_id) DO UPDATE SET
+        pairing_token = excluded.pairing_token,
+        paired_at = excluded.paired_at,
+        device_name = excluded.device_name,
+        platform = excluded.platform,
+        system = excluded.system,
+        last_boot_at = excluded.last_boot_at,
+        last_online_at = excluded.last_online_at,
+        last_offline_at = excluded.last_offline_at,
+        last_policy_push_at = excluded.last_policy_push_at
+    `).run(deviceId, record.pairingToken, record.pairedAt, record.deviceName ?? null, record.platform ?? null, record.system ?? null, record.lastBootAt ?? null, record.lastOnlineAt ?? null, record.lastOfflineAt ?? null, record.lastPolicyPushAt ?? null);
+    }
+    async getPairedDevice(deviceId) {
+        const row = this.db.prepare(`
+      SELECT *
+      FROM paired_devices
+      WHERE device_id = ?
+    `).get(deviceId);
+        return row ? this.mapPairedDeviceRow(row) : undefined;
+    }
+    async deletePairedDevice(deviceId) {
+        this.db.prepare("DELETE FROM paired_devices WHERE device_id = ?").run(deviceId);
+    }
+    async listPairedDevices() {
+        const rows = this.db.prepare(`
+      SELECT *
+      FROM paired_devices
+      ORDER BY paired_at ASC
+    `).all();
+        return rows.map((row) => ({
+            deviceId: row.device_id,
+            record: this.mapPairedDeviceRow(row)
+        }));
+    }
+    async listPlaylists() {
+        const rows = this.db.prepare(`
+      SELECT *
+      FROM playlists
+      ORDER BY updated_at DESC
+    `).all();
+        return rows.map((row) => this.mapPlaylistRow(row));
+    }
+    async getPlaylist(id) {
+        const row = this.db.prepare(`
+      SELECT *
+      FROM playlists
+      WHERE id = ?
+    `).get(id);
+        return row ? this.mapPlaylistRow(row) : undefined;
+    }
+    async setPlaylist(record) {
+        this.db.prepare(`
+      INSERT INTO playlists (
+        id,
+        name,
+        schedule_json,
+        items_json,
+        version,
+        updated_at,
+        retired,
+        retired_at
+      )
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(id) DO UPDATE SET
+        name = excluded.name,
+        schedule_json = excluded.schedule_json,
+        items_json = excluded.items_json,
+        version = excluded.version,
+        updated_at = excluded.updated_at,
+        retired = excluded.retired,
+        retired_at = excluded.retired_at
+    `).run(record.id, record.name, record.schedule ? JSON.stringify(record.schedule) : null, JSON.stringify(record.items ?? []), record.version, record.updatedAt, record.retired ? 1 : 0, record.retiredAt ?? null);
+    }
+    async isPlaylistNameTaken(name, excludeId) {
+        const target = name.trim().toLowerCase();
+        if (!target)
+            return false;
+        const row = this.db.prepare(`
+      SELECT id
+      FROM playlists
+      WHERE retired = 0
+        AND lower(trim(name)) = ?
+        AND (? IS NULL OR id != ?)
+      LIMIT 1
+    `).get(target, excludeId ?? null, excludeId ?? null);
+        return !!row;
+    }
+    async getDeviceAssignments(deviceId) {
+        const rows = this.db.prepare(`
+      SELECT playlist_id, published_version, published_at, snapshot_json
+      FROM device_assignments
+      WHERE device_id = ?
+      ORDER BY sort_order ASC
+    `).all(deviceId);
+        return rows.map((row) => ({
+            playlistId: row.playlist_id,
+            publishedVersion: row.published_version,
+            publishedAt: row.published_at,
+            snapshot: parseJson(row.snapshot_json, {
+                id: row.playlist_id,
+                name: row.playlist_id,
+                version: row.published_version,
+                items: []
+            })
+        }));
+    }
+    async setDeviceAssignments(deviceId, assignments) {
+        const replaceAssignments = this.db.transaction(() => {
+            this.db.prepare("DELETE FROM device_assignments WHERE device_id = ?").run(deviceId);
+            const insert = this.db.prepare(`
+        INSERT INTO device_assignments (
+          device_id,
+          playlist_id,
+          sort_order,
+          published_version,
+          published_at,
+          snapshot_json
+        )
+        VALUES (?, ?, ?, ?, ?, ?)
+      `);
+            assignments.forEach((assignment, index) => {
+                insert.run(deviceId, assignment.playlistId, index, assignment.publishedVersion, assignment.publishedAt, JSON.stringify(assignment.snapshot));
+            });
+        });
+        replaceAssignments();
+    }
+    mapDeviceRegistryRow(row) {
+        return {
+            permanentPairingCode: row.permanent_pairing_code,
+            codeCreatedAt: row.code_created_at,
+            serialNumber: optionalString(row.serial_number),
+            firstSeenAt: optionalNumber(row.first_seen_at),
+            lastHelloAt: optionalNumber(row.last_hello_at)
+        };
+    }
+    mapPairedDeviceRow(row) {
+        return {
+            pairingToken: row.pairing_token,
+            pairedAt: row.paired_at,
+            deviceName: optionalString(row.device_name),
+            platform: optionalString(row.platform),
+            system: optionalString(row.system),
+            lastBootAt: optionalString(row.last_boot_at),
+            lastOnlineAt: optionalString(row.last_online_at),
+            lastOfflineAt: optionalString(row.last_offline_at),
+            lastPolicyPushAt: optionalString(row.last_policy_push_at)
+        };
+    }
+    mapPlaylistRow(row) {
+        return {
+            id: row.id,
+            name: row.name,
+            schedule: parseJson(row.schedule_json, undefined),
+            items: parseJson(row.items_json, []),
+            version: row.version,
+            updatedAt: row.updated_at,
+            retired: row.retired === 1,
+            retiredAt: optionalString(row.retired_at)
+        };
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "TomorrowOS CMS server SDK - WebSocket transport, pairing, device commands, optional static CMS UI. Includes CLI (tomorrowos init / build) and starter templates.",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,13 +32,14 @@
     "node": ">=18"
   },
   "dependencies": {
+    "better-sqlite3": "^12.11.1",
     "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.19.41",
     "@types/ws": "^8.5.10",
     "typescript": "^5.5.0"
   },
   "license": "Apache-2.0"
 }
-

package/templates/cms-starter/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
   "private": true,
   "type": "module",
@@ -10,7 +10,7 @@
     "build-player": "tomorrowos build --platform tizen"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.4.7"
+    "@tomorrowos/sdk": "^0.4.8"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/templates/cms-starter/server.ts

@@ -1,22 +1,25 @@
 /**
  * TomorrowOS CMS server — minimal starter.
- * Add routes, database, or serve a React build via listen({ staticRoot }).
+ * Uses SQLite by default so pairings/playlists survive server restarts.
  */
 
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, join } from "path";
-import { TomorrowOS } from "@tomorrowos/sdk";
+import { createTomorrowOSStore, TomorrowOS } from "@tomorrowos/sdk";
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const brand = JSON.parse(readFileSync(join(__dirname, "brand.json"), "utf8"));
+const store = createTomorrowOSStore({
+  sqlitePath: join(__dirname, "data", "tomorrowos.db")
+});
 
-const tomorrowos = new TomorrowOS({ brand });
+const tomorrowos = new TomorrowOS({ brand, store });
 
 tomorrowos.listen({
   port: Number(process.env.PORT) || 3000,
   host: "0.0.0.0",
-  staticRoot: join(__dirname,"public"),
+  staticRoot: join(__dirname, "public"),
 });
 
 tomorrowos.on("device.paired", (event) => {