@tomorrowos/sdk 0.4.8 → 0.5.0

package/README.md

@@ -42,10 +42,31 @@ npm run dev
 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.
+To switch to Supabase/Postgres, edit `.env`:
+
+```bash
+TOMORROWOS_STORE=supabase
+DATABASE_URL=postgresql://...
+DATABASE_SSL=true
+```
+
+For throwaway demos/tests, set `TOMORROWOS_STORE=memory`. The generated starter
+also includes `template/databaseInterface/` with SQLite and Supabase examples
+for customers who want to build their own `TomorrowOSStore` implementation.
+
+Migrate database records between supported stores:
+
+```bash
+npx tomorrowos migrate \
+  --from sqlite \
+  --from-sqlite ./data/tomorrowos.db \
+  --to supabase \
+  --to-database-url "$DATABASE_URL"
+```
+
+The migrate command supports `sqlite`, `postgres`, and `supabase` in either
+direction. It migrates TomorrowOS database records only; copy `public/uploads`
+or object-storage media separately.
 
 Build a player (placeholder in current SDK — see `PLAYER_INSTALL.md` for platform tooling):
 

package/dist/cli.js

@@ -2,6 +2,8 @@
 import fs from "fs";
 import path from "path";
 import { fileURLToPath } from "url";
+import { migrateTomorrowOSData } from "./store/migration.js";
+import { PostgresStore } from "./store/postgres-store.js";
 import { SQLiteStore } from "./store/sqlite-store.js";
 function packageRoot() {
     const here = path.dirname(fileURLToPath(import.meta.url));
@@ -89,11 +91,93 @@ function cmdBuild(argv) {
     console.log("Use your TomorrowOS player repository (assemble Web app + config), then run the platform SDK (e.g. Tizen CLI tizen package) from the build output directory.");
     process.exitCode = 0;
 }
+function optionValue(argv, name) {
+    const withEquals = `${name}=`;
+    const found = argv.find((arg) => arg.startsWith(withEquals));
+    if (found)
+        return found.slice(withEquals.length);
+    const idx = argv.indexOf(name);
+    if (idx >= 0)
+        return argv[idx + 1];
+    return undefined;
+}
+function normalizeDriver(raw, side) {
+    const driver = String(raw || "").trim().toLowerCase();
+    if (driver === "sqlite" || driver === "postgres" || driver === "supabase") {
+        return driver;
+    }
+    throw new Error(`--${side} must be sqlite, postgres, or supabase.`);
+}
+function resolvePostgresSsl(raw, databaseUrl) {
+    const value = raw?.trim().toLowerCase();
+    if (value === "false" || value === "0" || value === "off")
+        return false;
+    if (value === "true" || value === "1" || value === "on") {
+        return { rejectUnauthorized: false };
+    }
+    if (/supabase\.(co|com)|sslmode=require/i.test(databaseUrl)) {
+        return { rejectUnauthorized: false };
+    }
+    return undefined;
+}
+function createMigrationStore(argv, side) {
+    const driver = normalizeDriver(optionValue(argv, `--${side}`), side);
+    if (driver === "sqlite") {
+        const dbPath = optionValue(argv, `--${side}-sqlite`) ??
+            optionValue(argv, `--${side}-sqlite-path`);
+        if (!dbPath) {
+            throw new Error(`--${side}=sqlite requires --${side}-sqlite ./data/tomorrowos.db`);
+        }
+        const store = new SQLiteStore(dbPath);
+        return {
+            label: `sqlite:${path.resolve(dbPath)}`,
+            store,
+            close: async () => store.close()
+        };
+    }
+    const databaseUrl = optionValue(argv, `--${side}-database-url`) ??
+        optionValue(argv, `--${side}-url`);
+    if (!databaseUrl) {
+        throw new Error(`--${side}=${driver} requires --${side}-database-url postgresql://...`);
+    }
+    const store = new PostgresStore({
+        connectionString: databaseUrl,
+        ssl: resolvePostgresSsl(optionValue(argv, `--${side}-database-ssl`), databaseUrl)
+    });
+    return {
+        label: `${driver}:DATABASE_URL`,
+        store,
+        close: async () => store.close()
+    };
+}
+async function cmdMigrate(argv) {
+    if (argv.includes("-h") || argv.includes("--help")) {
+        printMigrateHelp();
+        return;
+    }
+    const from = createMigrationStore(argv, "from");
+    const to = createMigrationStore(argv, "to");
+    try {
+        console.log(`[tomorrowos] Migrating data from ${from.label} to ${to.label}`);
+        const result = await migrateTomorrowOSData(from.store, to.store);
+        console.log("[tomorrowos] Migration complete:");
+        console.log(`  pending codes: ${result.pendingCodes}`);
+        console.log(`  device registry records: ${result.deviceRegistry}`);
+        console.log(`  paired devices: ${result.pairedDevices}`);
+        console.log(`  playlists: ${result.playlists}`);
+        console.log(`  device assignments: ${result.deviceAssignments}`);
+        console.log("[tomorrowos] Note: media files in public/uploads or object storage are not copied by database migration.");
+    }
+    finally {
+        await Promise.allSettled([from.close(), to.close()]);
+    }
+}
 function printHelp() {
     console.log(`tomorrowos — TomorrowOS SDK CLI
 
 Usage:
   tomorrowos init [directory]     Copy cms-starter template (default: my-tomorrowos-cms)
+  tomorrowos migrate [options]    Migrate TomorrowOS data between supported databases
   tomorrowos build --platform …   Placeholder; player packaging lives in the player repo
 
 Options:
@@ -102,9 +186,29 @@ Options:
 Examples:
   npx @tomorrowos/sdk init
   npx @tomorrowos/sdk init ./my-cms
+  npx @tomorrowos/sdk migrate --from sqlite --from-sqlite ./data/tomorrowos.db --to supabase --to-database-url "$DATABASE_URL"
 `);
 }
-function main() {
+function printMigrateHelp() {
+    console.log(`tomorrowos migrate — migrate TomorrowOS SDK data
+
+Supported stores:
+  sqlite
+  postgres
+  supabase
+
+Examples:
+  tomorrowos migrate --from sqlite --from-sqlite ./data/tomorrowos.db --to supabase --to-database-url "$DATABASE_URL"
+  tomorrowos migrate --from supabase --from-database-url "$DATABASE_URL" --to sqlite --to-sqlite ./data/tomorrowos.db
+  tomorrowos migrate --from postgres --from-database-url "$OLD_DATABASE_URL" --to postgres --to-database-url "$NEW_DATABASE_URL"
+
+Notes:
+  - Migrates pairing/device/playlist/assignment database records.
+  - Does not copy media files from public/uploads or object storage.
+  - Target records with the same primary keys are overwritten/updated.
+`);
+}
+async function main() {
     const argv = process.argv.slice(2);
     if (argv.length === 0 || argv[0] === "-h" || argv[0] === "--help") {
         printHelp();
@@ -123,8 +227,15 @@ function main() {
         cmdBuild(rest);
         return;
     }
+    if (cmd === "migrate") {
+        await cmdMigrate(rest);
+        return;
+    }
     console.error(`[tomorrowos] Unknown command: ${cmd}`);
     printHelp();
     process.exit(1);
 }
-main();
+main().catch((err) => {
+    console.error("[tomorrowos]", err instanceof Error ? err.message : err);
+    process.exit(1);
+});

package/dist/index.d.ts

@@ -1,11 +1,15 @@
 export { TomorrowOS } from "./tomorrowos.js";
 export type { DeviceListItem, ListenOptions, TomorrowOSBrand, TomorrowOSOptions } from "./tomorrowos.js";
-export type { DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceRecord, PendingCodeRecord, PlaylistItemRecord, PlaylistSchedule, PublishedPlaylistSnapshot, StoredPlaylist, TomorrowOSStore } from "./store/types.js";
+export type { DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, DeviceRegistryEntry, PlaylistItemRecord, PlaylistSchedule, PublishedPlaylistSnapshot, StoredPlaylist, TomorrowOSDataSnapshot, TomorrowOSMigratableStore, TomorrowOSStore } from "./store/types.js";
 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 { PostgresStore } from "./store/postgres-store.js";
+export type { PostgresStoreOptions } from "./store/postgres-store.js";
 export { SQLiteStore } from "./store/sqlite-store.js";
 export { createTomorrowOSStore, defaultSQLitePath } from "./store/factory.js";
 export type { CreateTomorrowOSStoreOptions, TomorrowOSStoreDriver } from "./store/factory.js";
+export { exportTomorrowOSData, importTomorrowOSData, migrateTomorrowOSData } from "./store/migration.js";
+export type { MigrationResult } from "./store/migration.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;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"}
+{"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,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,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,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,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;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -2,5 +2,7 @@ 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 { PostgresStore } from "./store/postgres-store.js";
 export { SQLiteStore } from "./store/sqlite-store.js";
 export { createTomorrowOSStore, defaultSQLitePath } from "./store/factory.js";
+export { exportTomorrowOSData, importTomorrowOSData, migrateTomorrowOSData } from "./store/migration.js";

package/dist/store/factory.d.ts

@@ -1,18 +1,18 @@
+import type { PoolConfig } from "pg";
 import type { TomorrowOSStore } from "./types.js";
-export type TomorrowOSStoreDriver = "sqlite" | "memory";
+export type TomorrowOSStoreDriver = "sqlite" | "postgres" | "supabase" | "memory";
 export interface CreateTomorrowOSStoreOptions {
     /**
-     * Defaults to TOMORROWOS_STORE, then sqlite.
-     * Use memory only for tests or throwaway demos.
+     * Defaults to TOMORROWOS_STORE, then postgres when DATABASE_URL is set,
+     * otherwise 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.
-     */
+    /** Supabase/Postgres connection string. Defaults to DATABASE_URL. */
     databaseUrl?: string;
+    /** Defaults from DATABASE_SSL / DATABASE_URL. */
+    postgresSsl?: PoolConfig["ssl"];
     env?: NodeJS.ProcessEnv;
 }
 export declare function defaultSQLitePath(cwd?: string): string;

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

@@ -1 +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"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/store/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAKrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElF,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAC/B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,WAAW,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,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,CAmCjB"}

package/dist/store/factory.js

@@ -1,23 +1,44 @@
 import path from "path";
 import { MemoryStore } from "./memory-store.js";
+import { PostgresStore } from "./postgres-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;
+    const driver = (options.driver ??
+        env.TOMORROWOS_STORE ??
+        (databaseUrl ? "postgres" : "sqlite")).toLowerCase();
     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 (driver === "postgres" || driver === "supabase") {
+        if (!databaseUrl) {
+            throw new Error(`TOMORROWOS_STORE=${driver} requires DATABASE_URL. Set DATABASE_URL in .env or unset TOMORROWOS_STORE to use SQLite.`);
+        }
+        return new PostgresStore({
+            connectionString: databaseUrl,
+            ssl: options.postgresSsl ?? resolvePostgresSsl(env, databaseUrl)
+        });
     }
-    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.");
+    if (driver === "sqlite") {
+        return new SQLiteStore({
+            databasePath: options.sqlitePath ?? env.TOMORROWOS_DB_PATH ?? defaultSQLitePath()
+        });
     }
-    return new SQLiteStore({
-        databasePath: options.sqlitePath ?? env.TOMORROWOS_DB_PATH ?? defaultSQLitePath()
-    });
+    throw new Error(`Unsupported TOMORROWOS_STORE "${driver}". Use "sqlite", "supabase", "postgres", "memory", or pass a custom TomorrowOSStore to new TomorrowOS({ store }).`);
+}
+function resolvePostgresSsl(env, databaseUrl) {
+    const raw = env.DATABASE_SSL?.trim().toLowerCase();
+    if (raw === "false" || raw === "0" || raw === "off")
+        return false;
+    if (raw === "true" || raw === "1" || raw === "on") {
+        return { rejectUnauthorized: false };
+    }
+    if (/supabase\.(co|com)|sslmode=require/i.test(databaseUrl)) {
+        return { rejectUnauthorized: false };
+    }
+    return undefined;
 }

package/dist/store/migration.d.ts

@@ -0,0 +1,12 @@
+import type { TomorrowOSDataSnapshot, TomorrowOSMigratableStore } from "./types.js";
+export interface MigrationResult {
+    pendingCodes: number;
+    deviceRegistry: number;
+    pairedDevices: number;
+    playlists: number;
+    deviceAssignments: number;
+}
+export declare function exportTomorrowOSData(store: TomorrowOSMigratableStore): Promise<TomorrowOSDataSnapshot>;
+export declare function importTomorrowOSData(store: TomorrowOSMigratableStore, snapshot: TomorrowOSDataSnapshot): Promise<MigrationResult>;
+export declare function migrateTomorrowOSData(from: TomorrowOSMigratableStore, to: TomorrowOSMigratableStore): Promise<MigrationResult>;
+//# sourceMappingURL=migration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/store/migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CA2BjC;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,yBAAyB,EAChC,QAAQ,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC,CA+B1B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,yBAAyB,EAC/B,EAAE,EAAE,yBAAyB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAG1B"}

package/dist/store/migration.js

@@ -0,0 +1,47 @@
+export async function exportTomorrowOSData(store) {
+    const [pendingCodes, deviceRegistry, pairedDevices, playlists] = await Promise.all([
+        store.listPendingCodes(),
+        store.listDeviceRegistry(),
+        store.listPairedDevices(),
+        store.listPlaylists()
+    ]);
+    const deviceAssignments = await Promise.all(pairedDevices.map(async ({ deviceId }) => ({
+        deviceId,
+        assignments: await store.getDeviceAssignments(deviceId)
+    })));
+    return {
+        pendingCodes,
+        deviceRegistry,
+        pairedDevices,
+        playlists,
+        deviceAssignments
+    };
+}
+export async function importTomorrowOSData(store, snapshot) {
+    for (const { deviceId, record } of snapshot.deviceRegistry) {
+        await store.setDeviceRegistry(deviceId, record);
+    }
+    for (const { deviceId, record } of snapshot.pairedDevices) {
+        await store.setPairedDevice(deviceId, record);
+    }
+    for (const playlist of snapshot.playlists) {
+        await store.setPlaylist(playlist);
+    }
+    for (const { deviceId, assignments } of snapshot.deviceAssignments) {
+        await store.setDeviceAssignments(deviceId, assignments);
+    }
+    for (const { code, record } of snapshot.pendingCodes) {
+        await store.setPendingCode(code, record);
+    }
+    return {
+        pendingCodes: snapshot.pendingCodes.length,
+        deviceRegistry: snapshot.deviceRegistry.length,
+        pairedDevices: snapshot.pairedDevices.length,
+        playlists: snapshot.playlists.length,
+        deviceAssignments: snapshot.deviceAssignments.reduce((total, entry) => total + entry.assignments.length, 0)
+    };
+}
+export async function migrateTomorrowOSData(from, to) {
+    const snapshot = await exportTomorrowOSData(from);
+    return importTomorrowOSData(to, snapshot);
+}

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

@@ -0,0 +1,43 @@
+import { type PoolConfig } from "pg";
+import type { DevicePlaylistAssignment, DeviceRegistryEntry, DeviceRegistryRecord, PairedDeviceEntry, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, StoredPlaylist, TomorrowOSMigratableStore } from "./types.js";
+export interface PostgresStoreOptions {
+    connectionString: string;
+    ssl?: PoolConfig["ssl"];
+}
+/**
+ * Durable store backed by Postgres. Supabase works through its Postgres
+ * connection string, usually provided as DATABASE_URL.
+ */
+export declare class PostgresStore implements TomorrowOSMigratableStore {
+    private readonly pool;
+    private ready?;
+    constructor(options: PostgresStoreOptions | string);
+    init(): Promise<void>;
+    close(): Promise<void>;
+    private ensureReady;
+    setPendingCode(code: string, record: PendingCodeRecord): Promise<void>;
+    getPendingCode(code: string): Promise<PendingCodeRecord | undefined>;
+    deletePendingCode(code: string): Promise<void>;
+    listPendingCodes(): Promise<PendingCodeEntry[]>;
+    getDeviceRegistry(deviceId: string): Promise<DeviceRegistryRecord | undefined>;
+    setDeviceRegistry(deviceId: string, record: DeviceRegistryRecord): Promise<void>;
+    getDeviceRegistryByCode(code: string): Promise<{
+        deviceId: string;
+        record: DeviceRegistryRecord;
+    } | undefined>;
+    listDeviceRegistry(): Promise<DeviceRegistryEntry[]>;
+    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;
+}
+//# sourceMappingURL=postgres-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-store.d.ts","sourceRoot":"","sources":["../../src/store/postgres-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,IAAI,CAAC;AAE3C,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAGjB,cAAc,EACd,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;CACzB;AAyDD;;;GAGG;AACH,qBAAa,aAAc,YAAW,yBAAyB;IAC7D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAgB;gBAElB,OAAO,EAAE,oBAAoB,GAAG,MAAM;IAY5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsErB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAId,WAAW;IAKnB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAWtE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAepE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAiB/C,iBAAiB,CACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAWtC,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IA4BV,uBAAuB,CAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,GAAG,SAAS,CAAC;IAepE,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAapD,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC;IAwCV,eAAe,CACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAWpC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAajD,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAU1C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAW5D,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAkClD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAevE,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAqBhC,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,wBAAwB,EAAE,GACtC,OAAO,CAAC,IAAI,CAAC;IAuChB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,cAAc;CAYvB"}

package/dist/store/postgres-store.js

@@ -0,0 +1,435 @@
+import { Pool } from "pg";
+function optionalString(value) {
+    return value ?? undefined;
+}
+function optionalNumber(value) {
+    if (value == null)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+function parseJson(raw, fallback) {
+    if (!raw)
+        return fallback;
+    return JSON.parse(raw);
+}
+/**
+ * Durable store backed by Postgres. Supabase works through its Postgres
+ * connection string, usually provided as DATABASE_URL.
+ */
+export class PostgresStore {
+    pool;
+    ready;
+    constructor(options) {
+        const connectionString = typeof options === "string" ? options : options.connectionString;
+        const ssl = typeof options === "string" ? undefined : options.ssl;
+        if (!connectionString.trim()) {
+            throw new Error("PostgresStore requires a connection string.");
+        }
+        this.pool = new Pool({ connectionString, ssl });
+    }
+    async init() {
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS schema_migrations (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL UNIQUE,
+        applied_at TIMESTAMPTZ NOT NULL DEFAULT now()
+      );
+
+      CREATE TABLE IF NOT EXISTS pending_codes (
+        code TEXT PRIMARY KEY,
+        device_id TEXT NOT NULL,
+        created_at BIGINT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS device_registry (
+        device_id TEXT PRIMARY KEY,
+        permanent_pairing_code TEXT NOT NULL UNIQUE,
+        code_created_at BIGINT NOT NULL,
+        serial_number TEXT,
+        first_seen_at BIGINT,
+        last_hello_at BIGINT
+      );
+
+      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 BOOLEAN NOT NULL DEFAULT false,
+        retired_at TEXT
+      );
+
+      CREATE UNIQUE INDEX IF NOT EXISTS playlists_active_name_unique
+        ON playlists (lower(trim(name)))
+        WHERE retired = false;
+
+      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 INTO schema_migrations (id, name)
+        VALUES (1, 'initial_tomorrowos_store')
+        ON CONFLICT (id) DO NOTHING;
+    `);
+    }
+    async close() {
+        await this.pool.end();
+    }
+    async ensureReady() {
+        this.ready ??= this.init();
+        await this.ready;
+    }
+    async setPendingCode(code, record) {
+        await this.ensureReady();
+        await this.pool.query(`
+      INSERT INTO pending_codes (code, device_id, created_at)
+      VALUES ($1, $2, $3)
+      ON CONFLICT (code) DO UPDATE SET
+        device_id = EXCLUDED.device_id,
+        created_at = EXCLUDED.created_at
+    `, [code, record.deviceId, record.createdAt]);
+    }
+    async getPendingCode(code) {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT device_id, created_at
+      FROM pending_codes
+      WHERE code = $1
+    `, [code]);
+        const row = result.rows[0];
+        if (!row)
+            return undefined;
+        return { deviceId: row.device_id, createdAt: Number(row.created_at) };
+    }
+    async deletePendingCode(code) {
+        await this.ensureReady();
+        await this.pool.query("DELETE FROM pending_codes WHERE code = $1", [code]);
+    }
+    async listPendingCodes() {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT code, device_id, created_at
+      FROM pending_codes
+      ORDER BY created_at ASC
+    `);
+        return result.rows.map((row) => ({
+            code: row.code,
+            record: { deviceId: row.device_id, createdAt: Number(row.created_at) }
+        }));
+    }
+    async getDeviceRegistry(deviceId) {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM device_registry
+      WHERE device_id = $1
+    `, [deviceId]);
+        const row = result.rows[0];
+        return row ? this.mapDeviceRegistryRow(row) : undefined;
+    }
+    async setDeviceRegistry(deviceId, record) {
+        await this.ensureReady();
+        await this.pool.query(`
+      INSERT INTO device_registry (
+        device_id,
+        permanent_pairing_code,
+        code_created_at,
+        serial_number,
+        first_seen_at,
+        last_hello_at
+      )
+      VALUES ($1, $2, $3, $4, $5, $6)
+      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
+    `, [
+            deviceId,
+            record.permanentPairingCode,
+            record.codeCreatedAt,
+            record.serialNumber ?? null,
+            record.firstSeenAt ?? null,
+            record.lastHelloAt ?? null
+        ]);
+    }
+    async getDeviceRegistryByCode(code) {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM device_registry
+      WHERE permanent_pairing_code = $1
+    `, [code]);
+        const row = result.rows[0];
+        if (!row)
+            return undefined;
+        return {
+            deviceId: row.device_id,
+            record: this.mapDeviceRegistryRow(row)
+        };
+    }
+    async listDeviceRegistry() {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM device_registry
+      ORDER BY code_created_at ASC
+    `);
+        return result.rows.map((row) => ({
+            deviceId: row.device_id,
+            record: this.mapDeviceRegistryRow(row)
+        }));
+    }
+    async setPairedDevice(deviceId, record) {
+        await this.ensureReady();
+        await this.pool.query(`
+      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 ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
+      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
+    `, [
+            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) {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM paired_devices
+      WHERE device_id = $1
+    `, [deviceId]);
+        const row = result.rows[0];
+        return row ? this.mapPairedDeviceRow(row) : undefined;
+    }
+    async deletePairedDevice(deviceId) {
+        await this.ensureReady();
+        await this.pool.query("DELETE FROM paired_devices WHERE device_id = $1", [
+            deviceId
+        ]);
+    }
+    async listPairedDevices() {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM paired_devices
+      ORDER BY paired_at ASC
+    `);
+        return result.rows.map((row) => ({
+            deviceId: row.device_id,
+            record: this.mapPairedDeviceRow(row)
+        }));
+    }
+    async listPlaylists() {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM playlists
+      ORDER BY updated_at DESC
+    `);
+        return result.rows.map((row) => this.mapPlaylistRow(row));
+    }
+    async getPlaylist(id) {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT *
+      FROM playlists
+      WHERE id = $1
+    `, [id]);
+        const row = result.rows[0];
+        return row ? this.mapPlaylistRow(row) : undefined;
+    }
+    async setPlaylist(record) {
+        await this.ensureReady();
+        await this.pool.query(`
+      INSERT INTO playlists (
+        id,
+        name,
+        schedule_json,
+        items_json,
+        version,
+        updated_at,
+        retired,
+        retired_at
+      )
+      VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
+      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
+    `, [
+            record.id,
+            record.name,
+            record.schedule ? JSON.stringify(record.schedule) : null,
+            JSON.stringify(record.items ?? []),
+            record.version,
+            record.updatedAt,
+            record.retired === true,
+            record.retiredAt ?? null
+        ]);
+    }
+    async isPlaylistNameTaken(name, excludeId) {
+        await this.ensureReady();
+        const target = name.trim().toLowerCase();
+        if (!target)
+            return false;
+        const result = await this.pool.query(`
+      SELECT id
+      FROM playlists
+      WHERE retired = false
+        AND lower(trim(name)) = $1
+        AND ($2::text IS NULL OR id != $2)
+      LIMIT 1
+    `, [target, excludeId ?? null]);
+        return result.rows.length > 0;
+    }
+    async getDeviceAssignments(deviceId) {
+        await this.ensureReady();
+        const result = await this.pool.query(`
+      SELECT playlist_id, published_version, published_at, snapshot_json
+      FROM device_assignments
+      WHERE device_id = $1
+      ORDER BY sort_order ASC
+    `, [deviceId]);
+        return result.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) {
+        await this.ensureReady();
+        const client = await this.pool.connect();
+        try {
+            await client.query("BEGIN");
+            await client.query("DELETE FROM device_assignments WHERE device_id = $1", [
+                deviceId
+            ]);
+            for (const [index, assignment] of assignments.entries()) {
+                await client.query(`
+          INSERT INTO device_assignments (
+            device_id,
+            playlist_id,
+            sort_order,
+            published_version,
+            published_at,
+            snapshot_json
+          )
+          VALUES ($1, $2, $3, $4, $5, $6)
+        `, [
+                    deviceId,
+                    assignment.playlistId,
+                    index,
+                    assignment.publishedVersion,
+                    assignment.publishedAt,
+                    JSON.stringify(assignment.snapshot)
+                ]);
+            }
+            await client.query("COMMIT");
+        }
+        catch (err) {
+            await client.query("ROLLBACK");
+            throw err;
+        }
+        finally {
+            client.release();
+        }
+    }
+    mapDeviceRegistryRow(row) {
+        return {
+            permanentPairingCode: row.permanent_pairing_code,
+            codeCreatedAt: Number(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,
+            retiredAt: optionalString(row.retired_at)
+        };
+    }
+}

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

@@ -1,4 +1,4 @@
-import type { DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceEntry, PairedDeviceRecord, PendingCodeRecord, StoredPlaylist, TomorrowOSStore } from "./types.js";
+import type { DevicePlaylistAssignment, DeviceRegistryEntry, DeviceRegistryRecord, PairedDeviceEntry, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, StoredPlaylist, TomorrowOSMigratableStore } from "./types.js";
 interface SQLiteStoreOptions {
     databasePath?: string;
 }
@@ -6,7 +6,7 @@ interface SQLiteStoreOptions {
  * 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 {
+export declare class SQLiteStore implements TomorrowOSMigratableStore {
     readonly databasePath: string;
     private readonly db;
     constructor(options?: SQLiteStoreOptions | string);
@@ -15,12 +15,14 @@ export declare class SQLiteStore implements TomorrowOSStore {
     setPendingCode(code: string, record: PendingCodeRecord): Promise<void>;
     getPendingCode(code: string): Promise<PendingCodeRecord | undefined>;
     deletePendingCode(code: string): Promise<void>;
+    listPendingCodes(): Promise<PendingCodeEntry[]>;
     getDeviceRegistry(deviceId: string): Promise<DeviceRegistryRecord | undefined>;
     setDeviceRegistry(deviceId: string, record: DeviceRegistryRecord): Promise<void>;
     getDeviceRegistryByCode(code: string): Promise<{
         deviceId: string;
         record: DeviceRegistryRecord;
     } | undefined>;
+    listDeviceRegistry(): Promise<DeviceRegistryEntry[]>;
     setPairedDevice(deviceId: string, record: PairedDeviceRecord): Promise<void>;
     getPairedDevice(deviceId: string): Promise<PairedDeviceRecord | undefined>;
     deletePairedDevice(deviceId: string): Promise<void>;

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

@@ -1 +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"}
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../../src/store/sqlite-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EAGjB,cAAc,EACd,yBAAyB,EAC1B,MAAM,YAAY,CAAC;AAEpB,UAAU,kBAAkB;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+DD;;;GAGG;AACH,qBAAa,WAAY,YAAW,yBAAyB;IAC3D,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,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAY/C,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,kBAAkB,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAYpD,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

@@ -127,6 +127,17 @@ export class SQLiteStore {
     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 *
@@ -167,6 +178,17 @@ export class SQLiteStore {
             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 (

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.8",
+  "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",
@@ -33,11 +33,13 @@
   },
   "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"
   },

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.8",
+  "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.8"
+    "@tomorrowos/sdk": "^0.5.0",
+    "dotenv": "^17.2.3"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

package/templates/cms-starter/server.ts

@@ -3,6 +3,7 @@
  * 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";

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 }
+  });
+}