@tomorrowos/sdk 0.4.7 → 0.5.0

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

@@ -0,0 +1,41 @@
+import type { DevicePlaylistAssignment, DeviceRegistryEntry, DeviceRegistryRecord, PairedDeviceEntry, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, StoredPlaylist, TomorrowOSMigratableStore } 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 TomorrowOSMigratableStore {
+    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>;
+    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;
+}
+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,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"}