@tomorrowos/sdk 0.2.4 → 0.2.5

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { TomorrowOS } from "./tomorrowos.js";
 export type { DeviceListItem, ListenOptions, TomorrowOSBrand, TomorrowOSOptions } from "./tomorrowos.js";
-export type { PairedDeviceRecord, PendingCodeRecord, TomorrowOSStore } from "./store/types.js";
+export type { DeviceRegistryRecord, PairedDeviceRecord, PendingCodeRecord, TomorrowOSStore } from "./store/types.js";
+export { generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.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,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,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,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,2 +1,3 @@
 export { TomorrowOS } from "./tomorrowos.js";
+export { generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.js";

package/dist/pairing-code.d.ts

@@ -0,0 +1,8 @@
+/** 0-9 and A-Z — 36 characters per digit position. */
+export declare const PAIRING_CODE_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+export declare const PAIRING_CODE_LENGTH = 6;
+export declare function normalizePairingCode(raw: string): string;
+export declare function isValidPairingCodeFormat(code: string): boolean;
+/** Random 6-character code; each position is digit or uppercase letter. */
+export declare function generateRandomPairingCode(): string;
+//# sourceMappingURL=pairing-code.d.ts.map

package/dist/pairing-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing-code.d.ts","sourceRoot":"","sources":["../src/pairing-code.ts"],"names":[],"mappings":"AAEA,sDAAsD;AACtD,eAAO,MAAM,qBAAqB,yCAAyC,CAAC;AAE5E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAK9D;AAED,2EAA2E;AAC3E,wBAAgB,yBAAyB,IAAI,MAAM,CAOlD"}

package/dist/pairing-code.js

@@ -0,0 +1,23 @@
+import { randomBytes } from "crypto";
+/** 0-9 and A-Z — 36 characters per digit position. */
+export const PAIRING_CODE_ALPHABET = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ";
+export const PAIRING_CODE_LENGTH = 6;
+export function normalizePairingCode(raw) {
+    return String(raw || "")
+        .trim()
+        .toUpperCase()
+        .replace(/[^0-9A-Z]/g, "");
+}
+export function isValidPairingCodeFormat(code) {
+    return (code.length === PAIRING_CODE_LENGTH &&
+        [...code].every((ch) => PAIRING_CODE_ALPHABET.includes(ch)));
+}
+/** Random 6-character code; each position is digit or uppercase letter. */
+export function generateRandomPairingCode() {
+    const bytes = randomBytes(PAIRING_CODE_LENGTH);
+    let out = "";
+    for (let i = 0; i < PAIRING_CODE_LENGTH; i += 1) {
+        out += PAIRING_CODE_ALPHABET[bytes[i] % PAIRING_CODE_ALPHABET.length];
+    }
+    return out;
+}

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

@@ -1,14 +1,22 @@
-import type { PairedDeviceEntry, PairedDeviceRecord, PendingCodeRecord, TomorrowOSStore } from "./types.js";
+import type { DeviceRegistryRecord, PairedDeviceEntry, PairedDeviceRecord, PendingCodeRecord, TomorrowOSStore } from "./types.js";
 /**
  * Default store for development / single-node demos.
  * Data is lost on process restart — not for multi-instance production.
  */
 export declare class MemoryStore implements TomorrowOSStore {
     private readonly pendingCodes;
+    private readonly deviceRegistry;
+    private readonly codeToDeviceId;
     private readonly pairedDevices;
     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>;

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

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/store/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IAEjE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIpE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC;IAIV,eAAe,CACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAIpC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAMxD"}
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/store/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,qBAAa,WAAY,YAAW,eAAe;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwC;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2C;IAC1E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;IAEjE,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC;IAIpE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,iBAAiB,CACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC;IAItC,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC;IASV,uBAAuB,CAC3B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,GAAG,SAAS,CAAC;IAQpE,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC;IAIV,eAAe,CACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IAIpC,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;CAMxD"}

package/dist/store/memory-store.js

@@ -4,6 +4,8 @@
  */
 export class MemoryStore {
     pendingCodes = new Map();
+    deviceRegistry = new Map();
+    codeToDeviceId = new Map();
     pairedDevices = new Map();
     async setPendingCode(code, record) {
         this.pendingCodes.set(code, record);
@@ -14,6 +16,26 @@ export class MemoryStore {
     async deletePendingCode(code) {
         this.pendingCodes.delete(code);
     }
+    async getDeviceRegistry(deviceId) {
+        return this.deviceRegistry.get(deviceId);
+    }
+    async setDeviceRegistry(deviceId, record) {
+        const existing = this.deviceRegistry.get(deviceId);
+        if (existing?.permanentPairingCode) {
+            this.codeToDeviceId.delete(existing.permanentPairingCode);
+        }
+        this.deviceRegistry.set(deviceId, record);
+        this.codeToDeviceId.set(record.permanentPairingCode, deviceId);
+    }
+    async getDeviceRegistryByCode(code) {
+        const deviceId = this.codeToDeviceId.get(code);
+        if (!deviceId)
+            return undefined;
+        const record = this.deviceRegistry.get(deviceId);
+        if (!record)
+            return undefined;
+        return { deviceId, record };
+    }
     async setPairedDevice(deviceId, record) {
         this.pairedDevices.set(deviceId, record);
     }

package/dist/store/types.d.ts

@@ -6,6 +6,14 @@ export interface PendingCodeRecord {
     deviceId: string;
     createdAt: number;
 }
+/** Permanent pairing code bound to a device (serial) on first hello — never rotated. */
+export interface DeviceRegistryRecord {
+    permanentPairingCode: string;
+    codeCreatedAt: number;
+    serialNumber?: string;
+    firstSeenAt?: number;
+    lastHelloAt?: number;
+}
 export interface PairedDeviceRecord {
     pairingToken: string;
     pairedAt: string;
@@ -29,6 +37,12 @@ export interface TomorrowOSStore {
     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>;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IACrE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC3E,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CACnD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/store/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wFAAwF;AACxF,MAAM,WAAW,oBAAoB;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAAC;IACrE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAC/E,iBAAiB,CACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,uBAAuB,CACrB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,GAAG,SAAS,CAAC,CAAC;IAC3E,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAAC;IAC3E,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CACnD"}

package/dist/tomorrowos.d.ts

@@ -29,10 +29,13 @@ export interface ListenOptions {
 }
 export interface DeviceListItem {
     deviceId: string;
+    /** Permanent 6-character alphanumeric pairing code (same after unpair). */
+    pairingCode: string | null;
     connected: boolean;
     deviceName: string | null;
     platform: string | null;
     system: string | null;
+    serialNumber: string | null;
     pairedAt: string;
     lastBootAt: string | null;
     lastOnlineAt: string | null;
@@ -53,7 +56,7 @@ export declare class TomorrowOS extends EventEmitter {
     private staticRoot;
     private staticIndexFile;
     constructor(options: TomorrowOSOptions);
-    /** Verify a 6-digit pairing code (same as POST /pairing/verify). */
+    /** Verify a 6-character alphanumeric pairing code (POST /pairing/verify). */
     pairingVerify(code: string): Promise<{
         deviceId: string;
     }>;
@@ -75,6 +78,7 @@ export declare class TomorrowOS extends EventEmitter {
     listDevices(): Promise<DeviceListItem[]>;
     private isDeviceConnected;
     private captureHelloMeta;
+    private getOrCreatePermanentPairingCode;
     private mergePairedRecord;
     private touchPairedOnline;
     private touchPairedOffline;

package/dist/tomorrowos.d.ts.map

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

package/dist/tomorrowos.js

@@ -4,6 +4,7 @@ import fs from "fs/promises";
 import http from "http";
 import path from "path";
 import { WebSocket, WebSocketServer } from "ws";
+import { generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode } from "./pairing-code.js";
 import { MemoryStore } from "./store/memory-store.js";
 function formatDurationMs(ms) {
     if (!Number.isFinite(ms) || ms < 0)
@@ -23,8 +24,16 @@ function formatDurationMs(ms) {
     parts.push(`${seconds}s`);
     return parts.join(" ");
 }
-function createSixDigitCode() {
-    return Math.floor(100000 + Math.random() * 900000).toString();
+function resolveHelloDeviceId(msg) {
+    const serial = typeof msg.serialNumber === "string" && msg.serialNumber.trim()
+        ? msg.serialNumber.trim()
+        : null;
+    if (serial)
+        return serial;
+    const deviceId = typeof msg.deviceId === "string" && msg.deviceId.trim()
+        ? msg.deviceId.trim()
+        : null;
+    return deviceId;
 }
 const MAX_MEDIA_UPLOAD_BYTES = 100 * 1024 * 1024;
 async function readJsonBody(req) {
@@ -82,41 +91,55 @@ export class TomorrowOS extends EventEmitter {
         this.brand = options.brand;
         this.store = options.store ?? new MemoryStore();
     }
-    /** Verify a 6-digit pairing code (same as POST /pairing/verify). */
+    /** Verify a 6-character alphanumeric pairing code (POST /pairing/verify). */
     async pairingVerify(code) {
-        const record = await this.store.getPendingCode(code);
-        if (!record) {
-            const err = new Error("Invalid or expired code");
+        const normalized = normalizePairingCode(code);
+        if (!isValidPairingCodeFormat(normalized)) {
+            const err = new Error("Invalid pairing code format");
+            err.code = "PAIRING_INVALID";
+            throw err;
+        }
+        let deviceId;
+        const registry = await this.store.getDeviceRegistryByCode(normalized);
+        if (registry) {
+            deviceId = registry.deviceId;
+        }
+        else {
+            const pending = await this.store.getPendingCode(normalized);
+            deviceId = pending?.deviceId;
+        }
+        if (!deviceId) {
+            const err = new Error("Invalid or unknown pairing code");
             err.code = "PAIRING_INVALID";
             throw err;
         }
         const pairingToken = randomBytes(32).toString("hex");
         const pairedAt = new Date().toISOString();
-        const meta = this.pendingDeviceMeta.get(record.deviceId);
+        const meta = this.pendingDeviceMeta.get(deviceId);
         const now = pairedAt;
-        await this.store.setPairedDevice(record.deviceId, {
+        await this.store.setPairedDevice(deviceId, {
             pairingToken,
             pairedAt,
             deviceName: meta?.deviceName,
             platform: meta?.platform,
             system: meta?.system,
             lastBootAt: meta?.bootedAt ?? now,
-            lastOnlineAt: this.isDeviceConnected(record.deviceId) ? now : undefined,
-            lastOfflineAt: this.isDeviceConnected(record.deviceId) ? undefined : now
+            lastOnlineAt: this.isDeviceConnected(deviceId) ? now : undefined,
+            lastOfflineAt: this.isDeviceConnected(deviceId) ? undefined : now
         });
-        await this.store.deletePendingCode(code);
-        const ws = this.devices.get(record.deviceId);
+        await this.store.deletePendingCode(normalized);
+        const ws = this.devices.get(deviceId);
         if (ws && ws.readyState === WebSocket.OPEN) {
             ws.send(JSON.stringify({
                 type: "pairing.verified",
                 method: "tomorrowos.pairing.verify",
-                deviceId: record.deviceId,
+                deviceId,
                 pairingToken
             }));
-            void this.refreshPairedDeviceInfo(record.deviceId);
+            void this.refreshPairedDeviceInfo(deviceId);
         }
-        this.emit("device.paired", { deviceId: record.deviceId });
-        return { deviceId: record.deviceId };
+        this.emit("device.paired", { deviceId });
+        return { deviceId };
     }
     /** Remove pairing for a device and notify it over WebSocket if connected. */
     async pairingUnpair(deviceId) {
@@ -149,8 +172,9 @@ export class TomorrowOS extends EventEmitter {
     async listDevices() {
         const entries = await this.store.listPairedDevices();
         const now = Date.now();
-        return entries.map(({ deviceId, record }) => {
+        return Promise.all(entries.map(async ({ deviceId, record }) => {
             const connected = this.isDeviceConnected(deviceId);
+            const reg = await this.store.getDeviceRegistry(deviceId);
             let screenOnlineActive = false;
             let screenOnlineLabel = "Not active";
             if (connected && record.lastBootAt) {
@@ -163,10 +187,12 @@ export class TomorrowOS extends EventEmitter {
             const screenOnlineSince = connected && record.lastBootAt ? record.lastBootAt : null;
             return {
                 deviceId,
+                pairingCode: reg?.permanentPairingCode ?? null,
                 connected,
                 deviceName: record.deviceName ?? null,
                 platform: record.platform ?? null,
                 system: record.system ?? null,
+                serialNumber: reg?.serialNumber ?? deviceId,
                 pairedAt: record.pairedAt,
                 lastBootAt: record.lastBootAt ?? null,
                 lastOnlineAt: record.lastOnlineAt ?? null,
@@ -176,7 +202,7 @@ export class TomorrowOS extends EventEmitter {
                 screenOnlineLabel,
                 screenOnlineSince
             };
-        });
+        }));
     }
     isDeviceConnected(deviceId) {
         const ws = this.devices.get(deviceId);
@@ -188,9 +214,37 @@ export class TomorrowOS extends EventEmitter {
             deviceName: typeof msg.deviceName === "string" ? msg.deviceName : undefined,
             system: typeof msg.system === "string" ? msg.system : undefined,
             bootedAt: typeof msg.bootedAt === "string" ? msg.bootedAt : undefined,
-            playerVersion: typeof msg.playerVersion === "string" ? msg.playerVersion : undefined
+            playerVersion: typeof msg.playerVersion === "string" ? msg.playerVersion : undefined,
+            serialNumber: typeof msg.serialNumber === "string" ? msg.serialNumber : deviceId
         });
     }
+    async getOrCreatePermanentPairingCode(deviceId, serialNumber) {
+        const existing = await this.store.getDeviceRegistry(deviceId);
+        if (existing?.permanentPairingCode) {
+            await this.store.setDeviceRegistry(deviceId, {
+                ...existing,
+                serialNumber: serialNumber ?? existing.serialNumber ?? deviceId,
+                lastHelloAt: Date.now()
+            });
+            return existing.permanentPairingCode;
+        }
+        for (let attempt = 0; attempt < 32; attempt += 1) {
+            const code = generateRandomPairingCode();
+            const collision = await this.store.getDeviceRegistryByCode(code);
+            if (collision && collision.deviceId !== deviceId)
+                continue;
+            const now = Date.now();
+            await this.store.setDeviceRegistry(deviceId, {
+                permanentPairingCode: code,
+                codeCreatedAt: now,
+                serialNumber: serialNumber ?? deviceId,
+                firstSeenAt: now,
+                lastHelloAt: now
+            });
+            return code;
+        }
+        throw new Error("Failed to allocate unique pairing code");
+    }
     async mergePairedRecord(deviceId, patch) {
         const existing = await this.store.getPairedDevice(deviceId);
         if (!existing)
@@ -593,25 +647,34 @@ export class TomorrowOS extends EventEmitter {
             }
             const type = msg.type;
             if (type === "device.hello") {
-                const deviceId = typeof msg.deviceId === "string" && msg.deviceId
-                    ? msg.deviceId
-                    : randomUUID();
-                const code = createSixDigitCode();
-                this.captureHelloMeta(deviceId, msg);
-                this.devices.set(deviceId, ws);
-                void this.store.setPendingCode(code, {
-                    deviceId,
-                    createdAt: Date.now()
-                });
-                ws.deviceId = deviceId;
-                ws.send(JSON.stringify({
-                    type: "pairing.code",
-                    method: "tomorrowos.pairing.createCode",
-                    code,
-                    deviceId
-                }));
-                this.sendBrandSnapshot(ws);
-                this.emit("device.online", { deviceId });
+                const deviceId = resolveHelloDeviceId(msg) ?? randomUUID();
+                const serialNumber = typeof msg.serialNumber === "string" && msg.serialNumber.trim()
+                    ? msg.serialNumber.trim()
+                    : deviceId;
+                void (async () => {
+                    try {
+                        const code = await this.getOrCreatePermanentPairingCode(deviceId, serialNumber);
+                        this.captureHelloMeta(deviceId, msg);
+                        this.devices.set(deviceId, ws);
+                        void this.store.setPendingCode(code, {
+                            deviceId,
+                            createdAt: Date.now()
+                        });
+                        ws.deviceId = deviceId;
+                        ws.send(JSON.stringify({
+                            type: "pairing.code",
+                            method: "tomorrowos.pairing.createCode",
+                            code,
+                            deviceId,
+                            serialNumber
+                        }));
+                        this.sendBrandSnapshot(ws);
+                        this.emit("device.online", { deviceId });
+                    }
+                    catch (err) {
+                        console.error("[TomorrowOS] device.hello failed:", err);
+                    }
+                })();
                 return;
             }
             if (type === "device.resume") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "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",

package/templates/cms-starter/policy.example.json

@@ -1,30 +1,30 @@
-{
-  "policy": {
-    "playlists": [
-      {
-        "id": "weekday-promo",
-        "name": "Weekday promo",
-        "schedule": {
-          "startDate": "2026-05-01",
-          "endDate": "2026-05-31",
-          "daysOfWeek": [1, 2, 3, 4, 5],
-          "start": "09:00",
-          "end": "17:00"
-        },
-        "items": [
-          {
-            "url": "https://example.com/hero.jpg",
-            "type": "image",
-            "durationMs": 10000
-          },
-          {
-            "url": "https://example.com/spot.mp4",
-            "type": "video",
-            "durationMs": 30000
-          }
-        ]
-      }
-    ],
-    "fallback": { "type": "brand" }
-  }
-}
+{
+  "policy": {
+    "playlists": [
+      {
+        "id": "weekday-promo",
+        "name": "Weekday promo",
+        "schedule": {
+          "startDate": "2026-05-01",
+          "endDate": "2026-05-31",
+          "daysOfWeek": [1, 2, 3, 4, 5],
+          "start": "09:00",
+          "end": "17:00"
+        },
+        "items": [
+          {
+            "url": "https://example.com/hero.jpg",
+            "type": "image",
+            "durationMs": 10000
+          },
+          {
+            "url": "https://example.com/spot.mp4",
+            "type": "video",
+            "durationMs": 30000
+          }
+        ]
+      }
+    ],
+    "fallback": { "type": "brand" }
+  }
+}

package/templates/cms-starter/public/index.html

@@ -16,9 +16,9 @@
       <main class="panel-main">
         <section class="card">
           <h2>Pair device</h2>
-          <p class="hint">Enter the 6-digit code shown on a screen. Each verified device gets its own card below.</p>
+          <p class="hint">Enter the 6-character code on the screen (A–Z or 0–9). Each device keeps the same code after unpair.</p>
           <div class="row">
-            <input id="code" maxlength="6" placeholder="6-digit code" />
+            <input id="code" maxlength="6" placeholder="e.g. A3K9Z1" autocapitalize="characters" />
             <button type="button" onclick="verify()">Verify</button>
           </div>
         </section>

package/templates/cms-starter/public/methods.js

@@ -486,7 +486,15 @@ function buildPolicyPayload() {
 }
 
 async function verify() {
-  const code = document.getElementById("code").value;
+  const code = String(document.getElementById("code").value || "")
+    .trim()
+    .toUpperCase()
+    .replace(/[^0-9A-Z]/g, "");
+
+  if (code.length !== 6) {
+    showResult({ status: "failed", error: "Enter the 6-character code from the screen." });
+    return;
+  }
 
   const res = await fetch("/pairing/verify", {
     method: "POST",
@@ -507,7 +515,7 @@ async function verify() {
 async function unpairDevice(deviceId) {
   if (
     !confirm(
-      "Unpair this device? Its card will be removed and the screen will show a new pairing code."
+      "Unpair this device? Its card will be removed; the screen keeps the same permanent pairing code."
     )
   ) {
     return;

package/templates/cms-starter/public/panel.css

@@ -1,329 +1,329 @@
-* {
-  box-sizing: border-box;
-}
-
-body {
-  margin: 0;
-  font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
-  background: #f4f3f0;
-  color: #0a0908;
-}
-
-.app-header {
-  padding: 1rem 1.5rem;
-  background: #0a0908;
-  color: #fafaf9;
-}
-
-.app-header h1 {
-  margin: 0;
-  font-size: 1.25rem;
-  font-weight: 600;
-}
-
-.app-header p {
-  margin: 0.35rem 0 0;
-  font-size: 0.875rem;
-  opacity: 0.8;
-}
-
-.layout {
-  display: flex;
-  gap: 0;
-  min-height: calc(100vh - 4.5rem);
-}
-
-.panel-main {
-  flex: 1;
-  padding: 1.25rem 1.5rem 2rem;
-  overflow: auto;
-}
-
-.panel-playlist {
-  width: 320px;
-  flex-shrink: 0;
-  background: #fff;
-  border-left: 1px solid #e4e1dc;
-  display: flex;
-  flex-direction: column;
-}
-
-.card {
-  background: #fff;
-  border: 1px solid #e4e1dc;
-  border-radius: 10px;
-  padding: 1rem 1.1rem;
-  margin-bottom: 1rem;
-}
-
-.card h2 {
-  margin: 0 0 0.75rem;
-  font-size: 0.95rem;
-  font-weight: 600;
-}
-
-.hint {
-  margin: 0 0 0.75rem;
-  font-size: 0.8rem;
-  color: #666;
-}
-
-.devices-grid {
-  display: grid;
-  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
-  gap: 0.85rem;
-}
-
-.devices-empty {
-  margin: 0;
-  color: #666;
-  font-size: 0.875rem;
-  grid-column: 1 / -1;
-}
-
-.device-card {
-  border: 1px solid #e4e1dc;
-  border-radius: 8px;
-  padding: 0.85rem 0.95rem;
-  background: #fafaf9;
-}
-
-.device-card-header {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  margin-bottom: 0.65rem;
-}
-
-.device-card-title {
-  margin: 0;
-  font-size: 0.95rem;
-  font-weight: 600;
-  line-height: 1.2;
-}
-
-.status-led {
-  width: 11px;
-  height: 11px;
-  border-radius: 50%;
-  flex-shrink: 0;
-  box-shadow: 0 0 0 2px rgba(0, 0, 0, 0.06);
-}
-
-.status-led--online {
-  background: #12b76a;
-  box-shadow: 0 0 8px rgba(18, 183, 106, 0.55);
-}
-
-.status-led--offline {
-  background: #f04438;
-  box-shadow: 0 0 8px rgba(240, 68, 56, 0.45);
-}
-
-.device-meta {
-  display: grid;
-  gap: 0.35rem;
-  font-size: 0.78rem;
-  color: #444;
-  margin-bottom: 0.75rem;
-}
-
-.device-meta dt {
-  font-weight: 600;
-  color: #666;
-  display: inline;
-}
-
-.device-meta dt::after {
-  content: ": ";
-}
-
-.device-meta dd {
-  display: inline;
-  margin: 0;
-  word-break: break-all;
-}
-
-.device-meta-row {
-  display: block;
-}
-
-.device-card-actions {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.4rem;
-}
-
-.device-card-actions button {
-  font-size: 0.78rem;
-  padding: 0.35rem 0.6rem;
-}
-
-.row {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.5rem;
-  align-items: center;
-}
-
-input[type="text"],
-input[type="date"],
-input[type="time"],
-select {
-  font: inherit;
-  padding: 0.45rem 0.6rem;
-  border: 1px solid #d6d2cb;
-  border-radius: 6px;
-  background: #fff;
-}
-
-button {
-  font: inherit;
-  padding: 0.45rem 0.85rem;
-  border-radius: 6px;
-  border: 1px solid #d6d2cb;
-  background: #fff;
-  cursor: pointer;
-}
-
-button:hover {
-  background: #f5f3ef;
-}
-
-button.primary {
-  background: #ff8a3d;
-  border-color: #e67320;
-  color: #0a0908;
-  font-weight: 600;
-}
-
-button.primary:hover {
-  background: #ff9a57;
-}
-
-button.danger {
-  color: #b42318;
-  border-color: #fecdca;
-}
-
-.schedule-grid {
-  display: grid;
-  grid-template-columns: 1fr 1fr;
-  gap: 0.65rem 1rem;
-}
-
-.schedule-grid label {
-  display: flex;
-  flex-direction: column;
-  gap: 0.25rem;
-  font-size: 0.8rem;
-  color: #444;
-}
-
-.days-row {
-  grid-column: 1 / -1;
-  display: flex;
-  flex-wrap: wrap;
-  gap: 0.5rem 0.75rem;
-  font-size: 0.8rem;
-}
-
-.days-row label {
-  flex-direction: row;
-  align-items: center;
-  gap: 0.35rem;
-  color: #0a0908;
-}
-
-.playlist-header {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  padding: 1rem 1rem 0.75rem;
-  border-bottom: 1px solid #e4e1dc;
-}
-
-.playlist-header h2 {
-  margin: 0;
-  font-size: 0.95rem;
-}
-
-.playlist-list {
-  list-style: none;
-  margin: 0;
-  padding: 0.5rem;
-  flex: 1;
-  overflow-y: auto;
-}
-
-.playlist-empty {
-  padding: 1.5rem 1rem;
-  text-align: center;
-  color: #888;
-  font-size: 0.875rem;
-}
-
-.playlist-item {
-  border: 1px solid #e4e1dc;
-  border-radius: 8px;
-  padding: 0.65rem;
-  margin-bottom: 0.5rem;
-  background: #fafaf9;
-}
-
-.playlist-item-thumb {
-  width: 100%;
-  aspect-ratio: 16 / 9;
-  object-fit: cover;
-  border-radius: 4px;
-  background: #e4e1dc;
-  display: block;
-  margin-bottom: 0.5rem;
-}
-
-.playlist-item-name {
-  font-size: 0.8rem;
-  font-weight: 600;
-  word-break: break-all;
-  margin-bottom: 0.35rem;
-}
-
-.playlist-item-meta {
-  font-size: 0.75rem;
-  color: #666;
-  margin-bottom: 0.45rem;
-}
-
-.playlist-item-actions {
-  display: flex;
-  gap: 0.35rem;
-  align-items: center;
-}
-
-.playlist-item-actions input[type="number"] {
-  width: 5rem;
-  font: inherit;
-  padding: 0.25rem 0.4rem;
-  border: 1px solid #d6d2cb;
-  border-radius: 4px;
-}
-
-.publish-bar {
-  padding: 1rem 0 0;
-}
-
-#result {
-  margin: 0;
-  padding: 0.75rem;
-  background: #0a0908;
-  color: #e8e6e3;
-  border-radius: 8px;
-  font-size: 0.75rem;
-  max-height: 10rem;
-  overflow: auto;
-  white-space: pre-wrap;
-}
-
-.hidden {
-  display: none !important;
-}
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: system-ui, -apple-system, Segoe UI, Roboto, sans-serif;
+  background: #f4f3f0;
+  color: #0a0908;
+}
+
+.app-header {
+  padding: 1rem 1.5rem;
+  background: #0a0908;
+  color: #fafaf9;
+}
+
+.app-header h1 {
+  margin: 0;
+  font-size: 1.25rem;
+  font-weight: 600;
+}
+
+.app-header p {
+  margin: 0.35rem 0 0;
+  font-size: 0.875rem;
+  opacity: 0.8;
+}
+
+.layout {
+  display: flex;
+  gap: 0;
+  min-height: calc(100vh - 4.5rem);
+}
+
+.panel-main {
+  flex: 1;
+  padding: 1.25rem 1.5rem 2rem;
+  overflow: auto;
+}
+
+.panel-playlist {
+  width: 320px;
+  flex-shrink: 0;
+  background: #fff;
+  border-left: 1px solid #e4e1dc;
+  display: flex;
+  flex-direction: column;
+}
+
+.card {
+  background: #fff;
+  border: 1px solid #e4e1dc;
+  border-radius: 10px;
+  padding: 1rem 1.1rem;
+  margin-bottom: 1rem;
+}
+
+.card h2 {
+  margin: 0 0 0.75rem;
+  font-size: 0.95rem;
+  font-weight: 600;
+}
+
+.hint {
+  margin: 0 0 0.75rem;
+  font-size: 0.8rem;
+  color: #666;
+}
+
+.devices-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: 0.85rem;
+}
+
+.devices-empty {
+  margin: 0;
+  color: #666;
+  font-size: 0.875rem;
+  grid-column: 1 / -1;
+}
+
+.device-card {
+  border: 1px solid #e4e1dc;
+  border-radius: 8px;
+  padding: 0.85rem 0.95rem;
+  background: #fafaf9;
+}
+
+.device-card-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.65rem;
+}
+
+.device-card-title {
+  margin: 0;
+  font-size: 0.95rem;
+  font-weight: 600;
+  line-height: 1.2;
+}
+
+.status-led {
+  width: 11px;
+  height: 11px;
+  border-radius: 50%;
+  flex-shrink: 0;
+  box-shadow: 0 0 0 2px rgba(0, 0, 0, 0.06);
+}
+
+.status-led--online {
+  background: #12b76a;
+  box-shadow: 0 0 8px rgba(18, 183, 106, 0.55);
+}
+
+.status-led--offline {
+  background: #f04438;
+  box-shadow: 0 0 8px rgba(240, 68, 56, 0.45);
+}
+
+.device-meta {
+  display: grid;
+  gap: 0.35rem;
+  font-size: 0.78rem;
+  color: #444;
+  margin-bottom: 0.75rem;
+}
+
+.device-meta dt {
+  font-weight: 600;
+  color: #666;
+  display: inline;
+}
+
+.device-meta dt::after {
+  content: ": ";
+}
+
+.device-meta dd {
+  display: inline;
+  margin: 0;
+  word-break: break-all;
+}
+
+.device-meta-row {
+  display: block;
+}
+
+.device-card-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+}
+
+.device-card-actions button {
+  font-size: 0.78rem;
+  padding: 0.35rem 0.6rem;
+}
+
+.row {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  align-items: center;
+}
+
+input[type="text"],
+input[type="date"],
+input[type="time"],
+select {
+  font: inherit;
+  padding: 0.45rem 0.6rem;
+  border: 1px solid #d6d2cb;
+  border-radius: 6px;
+  background: #fff;
+}
+
+button {
+  font: inherit;
+  padding: 0.45rem 0.85rem;
+  border-radius: 6px;
+  border: 1px solid #d6d2cb;
+  background: #fff;
+  cursor: pointer;
+}
+
+button:hover {
+  background: #f5f3ef;
+}
+
+button.primary {
+  background: #ff8a3d;
+  border-color: #e67320;
+  color: #0a0908;
+  font-weight: 600;
+}
+
+button.primary:hover {
+  background: #ff9a57;
+}
+
+button.danger {
+  color: #b42318;
+  border-color: #fecdca;
+}
+
+.schedule-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 0.65rem 1rem;
+}
+
+.schedule-grid label {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  font-size: 0.8rem;
+  color: #444;
+}
+
+.days-row {
+  grid-column: 1 / -1;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem 0.75rem;
+  font-size: 0.8rem;
+}
+
+.days-row label {
+  flex-direction: row;
+  align-items: center;
+  gap: 0.35rem;
+  color: #0a0908;
+}
+
+.playlist-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1rem 1rem 0.75rem;
+  border-bottom: 1px solid #e4e1dc;
+}
+
+.playlist-header h2 {
+  margin: 0;
+  font-size: 0.95rem;
+}
+
+.playlist-list {
+  list-style: none;
+  margin: 0;
+  padding: 0.5rem;
+  flex: 1;
+  overflow-y: auto;
+}
+
+.playlist-empty {
+  padding: 1.5rem 1rem;
+  text-align: center;
+  color: #888;
+  font-size: 0.875rem;
+}
+
+.playlist-item {
+  border: 1px solid #e4e1dc;
+  border-radius: 8px;
+  padding: 0.65rem;
+  margin-bottom: 0.5rem;
+  background: #fafaf9;
+}
+
+.playlist-item-thumb {
+  width: 100%;
+  aspect-ratio: 16 / 9;
+  object-fit: cover;
+  border-radius: 4px;
+  background: #e4e1dc;
+  display: block;
+  margin-bottom: 0.5rem;
+}
+
+.playlist-item-name {
+  font-size: 0.8rem;
+  font-weight: 600;
+  word-break: break-all;
+  margin-bottom: 0.35rem;
+}
+
+.playlist-item-meta {
+  font-size: 0.75rem;
+  color: #666;
+  margin-bottom: 0.45rem;
+}
+
+.playlist-item-actions {
+  display: flex;
+  gap: 0.35rem;
+  align-items: center;
+}
+
+.playlist-item-actions input[type="number"] {
+  width: 5rem;
+  font: inherit;
+  padding: 0.25rem 0.4rem;
+  border: 1px solid #d6d2cb;
+  border-radius: 4px;
+}
+
+.publish-bar {
+  padding: 1rem 0 0;
+}
+
+#result {
+  margin: 0;
+  padding: 0.75rem;
+  background: #0a0908;
+  color: #e8e6e3;
+  border-radius: 8px;
+  font-size: 0.75rem;
+  max-height: 10rem;
+  overflow: auto;
+  white-space: pre-wrap;
+}
+
+.hidden {
+  display: none !important;
+}

package/templates/cms-starter/public/uploads/.gitkeep

@@ -0,0 +1 @@
+