@tomorrowos/sdk 0.4.7 → 0.5.0

package/dist/store/sqlite-store.js

@@ -0,0 +1,367 @@
+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 listPendingCodes() {
+        const rows = this.db.prepare(`
+      SELECT code, device_id, created_at
+      FROM pending_codes
+      ORDER BY created_at ASC
+    `).all();
+        return rows.map((row) => ({
+            code: row.code,
+            record: { deviceId: row.device_id, createdAt: row.created_at }
+        }));
+    }
+    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 listDeviceRegistry() {
+        const rows = this.db.prepare(`
+      SELECT *
+      FROM device_registry
+      ORDER BY code_created_at ASC
+    `).all();
+        return rows.map((row) => ({
+            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/dist/store/types.d.ts

@@ -29,6 +29,14 @@ export interface PairedDeviceEntry {
     deviceId: string;
     record: PairedDeviceRecord;
 }
+export interface PendingCodeEntry {
+    code: string;
+    record: PendingCodeRecord;
+}
+export interface DeviceRegistryEntry {
+    deviceId: string;
+    record: DeviceRegistryRecord;
+}
 export interface PlaylistItemRecord {
     url: string;
     type?: string;
@@ -93,4 +101,18 @@ export interface TomorrowOSStore {
     getDeviceAssignments(deviceId: string): Promise<DevicePlaylistAssignment[]>;
     setDeviceAssignments(deviceId: string, assignments: DevicePlaylistAssignment[]): Promise<void>;
 }
+export interface TomorrowOSDataSnapshot {
+    pendingCodes: PendingCodeEntry[];
+    deviceRegistry: DeviceRegistryEntry[];
+    pairedDevices: PairedDeviceEntry[];
+    playlists: StoredPlaylist[];
+    deviceAssignments: Array<{
+        deviceId: string;
+        assignments: DevicePlaylistAssignment[];
+    }>;
+}
+export interface TomorrowOSMigratableStore extends TomorrowOSStore {
+    listPendingCodes(): Promise<PendingCodeEntry[]>;
+    listDeviceRegistry(): Promise<DeviceRegistryEntry[]>;
+}
 //# sourceMappingURL=types.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "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,16 @@
     "node": ">=18"
   },
   "dependencies": {
+    "better-sqlite3": "^12.11.1",
+    "pg": "^8.22.0",
     "ws": "^8.18.0"
   },
   "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^20.19.41",
+    "@types/pg": "^8.20.0",
     "@types/ws": "^8.5.10",
     "typescript": "^5.5.0"
   },
   "license": "Apache-2.0"
 }
-

package/templates/cms-starter/.env.example

@@ -0,0 +1,10 @@
+# Default local database.
+TOMORROWOS_STORE=sqlite
+TOMORROWOS_DB_PATH=./data/tomorrowos.db
+
+# Supabase/Postgres option.
+# TOMORROWOS_STORE=supabase
+# DATABASE_URL=postgresql://postgres:[PASSWORD]@[HOST]:5432/postgres
+# DATABASE_SSL=true
+
+PORT=3000

package/templates/cms-starter/package.json

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

package/templates/cms-starter/server.ts

@@ -1,22 +1,26 @@
 /**
  * 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 "dotenv/config";
 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) => {

package/templates/cms-starter/template/databaseInterface/README.md

@@ -0,0 +1,14 @@
+# Database Interface Examples
+
+The starter server already switches databases from `.env`:
+
+- `TOMORROWOS_STORE=sqlite` uses `data/tomorrowos.db`.
+- `TOMORROWOS_STORE=supabase` plus `DATABASE_URL=...` uses Supabase/Postgres.
+- `TOMORROWOS_STORE=memory` is only for throwaway tests.
+
+These files are reference examples for customers who want to understand or build
+their own database interface. You do not need to import them for the starter to
+work.
+
+If you build a custom database backend, implement `TomorrowOSStore` and pass it
+to `new TomorrowOS({ brand, store })` in `server.ts`.

package/templates/cms-starter/template/databaseInterface/sqlite-interface.ts

@@ -0,0 +1,10 @@
+/**
+ * Reference only. The starter already uses this behavior by default.
+ */
+import { SQLiteStore } from "@tomorrowos/sdk";
+
+export function createSQLiteInterface() {
+  return new SQLiteStore({
+    databasePath: process.env.TOMORROWOS_DB_PATH || "./data/tomorrowos.db"
+  });
+}

package/templates/cms-starter/template/databaseInterface/supabase-interface.ts

@@ -0,0 +1,17 @@
+/**
+ * Reference only. Supabase exposes a Postgres connection string, so TomorrowOS
+ * uses PostgresStore for Supabase-backed persistence.
+ */
+import { PostgresStore } from "@tomorrowos/sdk";
+
+export function createSupabaseInterface() {
+  const connectionString = process.env.DATABASE_URL;
+  if (!connectionString) {
+    throw new Error("DATABASE_URL is required for Supabase/Postgres.");
+  }
+
+  return new PostgresStore({
+    connectionString,
+    ssl: { rejectUnauthorized: false }
+  });
+}