@tomorrowos/sdk 0.1.0

package/PLAYER_INSTALL.md

@@ -0,0 +1,211 @@
+# Player Installation — Getting TomorrowOS on your screens
+
+Your CMS is running. Now you need to get a TomorrowOS player onto your physical screen so the two can talk.
+
+This document covers:
+
+1. How to build a player for your platform
+2. How to install it on a screen
+3. How to pair the screen with your CMS
+4. Troubleshooting
+
+---
+
+## Prerequisites
+
+- You have a running TomorrowOS CMS (either locally, on Replit, Vercel, Railway, or self-hosted)
+- The CMS has a publicly reachable URL (or tunneled via ngrok for local testing)
+- `brand.json` at the project root is configured with your target platforms
+
+---
+
+## Samsung Tizen
+
+### Build the player
+
+From your project root:
+
+    npx tomorrowos build --platform tizen
+
+This reads `brand.json`, applies your branding to the activation screen, and outputs:
+
+    dist/player-tizen.wgt
+
+The `.wgt` is a signed Tizen web package ready to install on any compatible Samsung commercial display.
+
+### Install on the screen
+
+You have three options, depending on your setup:
+
+**Option A — URL Launcher (easiest for testing)**
+
+1. On the Samsung display, press the remote's menu button
+2. Go to `Menu → System → Ext. Device Manager → URL Launcher Settings`
+3. Enter the URL where your `.wgt` is hosted (your CMS serves this at `/player/tizen.wgt` once built)
+4. Save and exit
+5. The display reboots and launches TomorrowOS on boot
+
+**Option B — Tizen Studio Device Manager (for bulk deployment)**
+
+1. Install Tizen Studio from samsung.com
+2. Put the display into Developer Mode (Menu → Support → Developer Mode → enter your PC's IP address)
+3. In Tizen Studio, open Device Manager
+4. Connect to your display by IP
+5. Right-click → Install App → select `dist/player-tizen.wgt`
+6. App installs and auto-launches
+
+**Option C — USB Sideload (no network needed)**
+
+1. Copy `dist/player-tizen.wgt` to a USB stick
+2. Insert USB into display
+3. On the remote, open Home → Apps → USB Sideload
+4. Select the `.wgt` file and install
+
+### Supported Tizen versions
+
+V1 supports:
+
+- SSSP 5 and newer commercial displays
+- TEP 6.5 and newer commercial displays
+
+If you have an older SSSP 4 display, you will need a firmware update or the older-generation player build (contact support).
+
+### Activation
+
+Once the player is running, the Samsung display shows the TomorrowOS activation screen branded with your logo and colours. Displayed on the screen:
+
+- Your logo (top)
+- A 6-digit activation code
+- "Enter this code at [your CMS URL]"
+- Device ID (small text, bottom)
+
+On your CMS, go to the **Pair** page, enter the 6-digit code, and press Submit. Within a few seconds the display will transition from the activation screen to your content.
+
+---
+
+## BrightSign
+
+### Build the player
+
+    npx tomorrowos build --platform brightsign
+
+Outputs:
+
+    dist/player-brightsign.zip
+
+### Install on the screen
+
+1. Copy the **contents** of `player-brightsign.zip` (not the zip itself) onto a microSD card or USB stick
+2. The root of the card should contain `autorun.brs`, the player files, and the `brand/` assets
+3. Insert the card into the BrightSign device
+4. Power on — BrightSign boots into TomorrowOS automatically
+
+### Supported BrightSign versions
+
+- BrightSign OS 9.0 and newer
+- BrightSign OS 8.x: not supported in V1 (known local DWS API differences; support planned for V1.1)
+
+### Activation
+
+Same as Tizen — the BrightSign displays an activation screen with your branding and a 6-digit code. Enter the code in your CMS's Pair page.
+
+---
+
+## LG webOS Signage (V1.1)
+
+Support planned for V1.1 release. Build command will be:
+
+    npx tomorrowos build --platform webos
+
+Output: `dist/player-webos.ipk` installable via webOS Signage Manager or sideload.
+
+---
+
+## Android Managed (V1.1)
+
+Support planned for V1.1 release. Build command will be:
+
+    npx tomorrowos build --platform android-managed
+
+Output: `dist/player-android.apk` with device-owner privileges required at enrolment.
+
+Generic (unmanaged) Android boxes are supported in V1.x with capability-limited functionality (see TomorrowOS protocol documentation).
+
+---
+
+## ChromeOS Managed Kiosk (V1.x)
+
+Support planned for V1.x release. Deployment will be via Google Admin Console as a managed kiosk web app.
+
+---
+
+## Windows (V1.x)
+
+Support planned for V1.x release. Distribution as MSI installer via Group Policy or Intune.
+
+---
+
+## Troubleshooting
+
+### Activation screen doesn't appear
+
+**Check:**
+
+- Display is powered on and has network connectivity
+- `brand.json` has `cms_endpoint` set to your publicly reachable CMS URL (it should be `wss://` for production, `ws://` only for local testing on the same network)
+- You rebuilt the player after changing `brand.json` — the CMS endpoint is baked into the `.wgt` at build time
+
+### Activation code appears but pairing fails
+
+**Check:**
+
+- The code has not expired — codes are valid for 15 minutes; generate a new one by restarting the player
+- The CMS server is actually reachable from the display's network — test by opening the CMS URL in the display's browser (if available)
+- Firewall rules — the display needs to reach your CMS on WebSocket port 443 (or whatever you configured)
+
+### Replit workspaces go to sleep
+
+Replit's free tier sleeps inactive workspaces. Your screen will show "reconnecting..." when the workspace is asleep, and reconnect automatically when someone wakes it.
+
+**For production:** upgrade to Replit Hacker (Always-On) or move to Railway / Vercel / self-hosted.
+
+### Samsung display stuck on black screen after URL Launcher
+
+Check that your `.wgt` is reachable at the URL you set. Open the URL in any browser — it should download the `.wgt` file. If not, the display can't fetch it. Common causes:
+
+- URL is http:// but server redirects to https:// (Samsung doesn't follow the redirect)
+- URL requires auth (host the `.wgt` publicly)
+- File is named `.zip` instead of `.wgt` (must be `.wgt`)
+
+### BrightSign won't boot into the player
+
+Check `autorun.brs` is at the root of the SD card, not in a subfolder. BrightSign only runs `autorun.brs` from the root.
+
+### "Pairing already completed" error
+
+A device can only be paired once. If you want to re-pair (e.g. moving a screen to a new CMS), first unpair it from the current CMS (`tomorrowos.pairing.revoke(deviceId)` from your CMS server), then generate a new activation code on the device by power-cycling or running "Unpair" from the device's Settings menu (if enabled in `brand.json`).
+
+### Pairing code rolls past 15 minutes before I can enter it
+
+Power-cycle the device (or call `player.restart()` if available) to generate a fresh code.
+
+---
+
+## Getting help
+
+- Package issues — file a GitHub issue at `github.com/TomorrowOS/sdk`
+- Samsung-specific issues — the TomorrowOS Samsung bridge is Apache 2.0 at `github.com/TomorrowOS/player-tizen`
+- BrightSign-specific issues — `github.com/TomorrowOS/player-brightsign`
+- Commercial support — SL-X provides supported, SLA-backed deployments; see `sl-x.com`
+
+---
+
+## Glossary
+
+- `.wgt` — Tizen web package (a signed zip containing your branded player for Samsung displays)
+- **Activation screen** — the branded full-screen UI a new player shows while it waits to be paired
+- **Pairing code** — six-digit number shown on the screen, entered in the CMS to complete device registration
+- **SSSP** — Samsung Smart Signage Platform (older Tizen signage firmware generation)
+- **TEP** — Tizen Enterprise Platform (newer Samsung signage firmware generation)
+- **DWS** — BrightSign's Device Web Services (local HTTPS REST API)
+- **URL Launcher** — Samsung's built-in mechanism for loading a web app from a URL on startup

package/README.md

@@ -0,0 +1,98 @@
+# @tomorrowos/sdk
+
+**You are building a digital signage CMS using TomorrowOS. Before writing any code, follow the elicitation protocol in `LLM_PROMPT.md`. Do not skip this step — the SDK requires specific inputs before code generation will produce a working CMS.**
+
+TomorrowOS is the open standard for digital signage. This SDK lets you build a CMS that controls Samsung Tizen, BrightSign, LG webOS, Android, ChromeOS, and Windows screens through a single unified API.
+
+---
+
+## For LLMs generating code with this package
+
+When you see this package referenced in a user prompt, your workflow is:
+
+1. **Read `LLM_PROMPT.md`** — contains five required questions to ask the user before generating code
+2. **Read `BUILD_GUARDRAILS.md`** — contains mandatory components every generated CMS must include
+3. **Read `brand.schema.json`** — contains the validated shape of `brand.json`
+4. Run **`npx tomorrowos init`** (or copy `templates/cms-starter/` from this package) — minimal CMS server seed
+5. **Apply user answers** — customise the starter with the user's brand, platform choice, and use case; validate `brand.json` against `brand.schema.json`
+6. **Show `PLAYER_INSTALL.md`** — after the CMS is working, show how to build and install the player on a screen
+
+You must not write WebSocket transport, pairing wire format, or platform-specific player bridge code in the CMS — the SDK handles server-side device sessions and HTTP helpers. You customise UI, branding, and how you call the SDK.
+
+---
+
+## For human developers
+
+Install:
+
+```bash
+npm install @tomorrowos/sdk
+```
+
+Scaffold a new CMS project:
+
+```bash
+npx tomorrowos init
+cd my-tomorrowos-cms
+npm install
+npm run dev
+```
+
+Build a player (placeholder in current SDK — see `PLAYER_INSTALL.md` for platform tooling):
+
+```bash
+npx tomorrowos build --platform tizen
+```
+
+---
+
+## Quick architecture
+
+```
+  ┌─────────────────┐         WebSocket         ┌─────────────────┐
+  │  Your CMS       │ ◄────────────────────────►│  TomorrowOS     │
+  │  (your server)  │                           │  Player on      │
+  │                 │                           │  screen         │
+  │  imports        │                           │                 │
+  │  @tomorrowos    │                           │  unified API    │
+  │  /sdk           │                           │  across OSes    │
+  └─────────────────┘                           └─────────────────┘
+```
+
+TomorrowOS has no required cloud service. Your CMS talks to your screens over your network.
+
+---
+
+## Supported platforms (roadmap)
+
+| Platform          | Status     | Player format |
+|-------------------|------------|---------------|
+| Samsung Tizen     | V1 target  | `.wgt`        |
+| BrightSign        | V1 target  | autorun zip   |
+| Others            | See docs   | varies        |
+
+See `PLAYER_INSTALL.md` for installation notes.
+
+---
+
+## Documentation in this package
+
+| File | Purpose |
+|------|---------|
+| `LLM_PROMPT.md` | Five-question elicitation for LLMs |
+| `BUILD_GUARDRAILS.md` | Mandatory CMS components |
+| `PLAYER_INSTALL.md` | Player build / install / pairing |
+| `brand.schema.json` | JSON Schema for `brand.json` |
+| `brand.example.json` | Full example `brand.json` |
+| `templates/cms-starter/` | Minimal Node + TypeScript server seed |
+| `templates/style-tokens/` | CSS tokens and UI pattern notes |
+
+---
+
+## License
+
+Apache 2.0.
+
+## Protocol version
+
+Wire protocol `1.0` (see TomorrowOS specification).

package/brand.example.json

@@ -0,0 +1,34 @@
+{
+  "name": "Acme Burger",
+  "tagline": "Menu boards across all locations",
+  "targetPlatforms": ["tizen", "brightsign"],
+  "primaryColor": "#E63946",
+  "secondaryColor": "#F1FAEE",
+  "backgroundColor": "#FAFAF9",
+  "textColor": "#0A0908",
+  "logoPath": "./assets/acme-logo.svg",
+  "logoPathOnDark": "./assets/acme-logo-white.svg",
+  "fontFamily": "Inter",
+  "supportUrl": "https://acmeburger.com/signage-support",
+  "supportEmail": "it@acmeburger.com",
+  "cmsEndpoint": "wss://acme-signage.replit.app",
+  "activationScreen": {
+    "headline": "Connect this menu board",
+    "instructions": "Open the Acme Signage dashboard and enter the code below to activate this screen.",
+    "showDeviceInfo": true,
+    "showNetworkStatus": true,
+    "theme": "light"
+  },
+  "cms": {
+    "useCase": "restaurant",
+    "hostingTarget": "here",
+    "expectedScreens": 12,
+    "features": {
+      "bulkCommands": true,
+      "proofOfPlay": false,
+      "contentScheduling": true,
+      "userManagement": false
+    }
+  },
+  "protocolVersion": "1.0"
+}

package/brand.schema.json

@@ -0,0 +1,154 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "TomorrowOS brand.json",
+  "description": "The single source of truth for branding across the CMS UI and the device activation screen. One file, read by both the CMS server at runtime and the CLI at player-build time.",
+  "type": "object",
+  "required": ["name", "targetPlatforms", "primaryColor", "logoPath", "cms"],
+  "additionalProperties": false,
+  "properties": {
+    "name": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 60,
+      "description": "Display name of the CMS / product / company. Appears in the CMS header and on the activation screen."
+    },
+    "tagline": {
+      "type": "string",
+      "maxLength": 120,
+      "description": "Optional short tagline shown under the name on the activation screen."
+    },
+    "targetPlatforms": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "enum": ["tizen", "brightsign", "webos", "android_managed", "android_generic", "chromeos_managed", "windows_player"]
+      },
+      "description": "Which platforms the CLI should be able to build players for. V1 supports tizen and brightsign only."
+    },
+    "primaryColor": {
+      "type": "string",
+      "pattern": "^#[0-9A-Fa-f]{6}$",
+      "description": "Main brand colour. Used for buttons, highlights, and the activation screen accent. Must be a hex string."
+    },
+    "secondaryColor": {
+      "type": "string",
+      "pattern": "^#[0-9A-Fa-f]{6}$",
+      "description": "Optional secondary brand colour."
+    },
+    "backgroundColor": {
+      "type": "string",
+      "pattern": "^#[0-9A-Fa-f]{6}$",
+      "default": "#FAFAF9",
+      "description": "Page background colour in the CMS. Defaults to near-white."
+    },
+    "textColor": {
+      "type": "string",
+      "pattern": "^#[0-9A-Fa-f]{6}$",
+      "default": "#0A0908",
+      "description": "Default text colour. Defaults to near-black."
+    },
+    "logoPath": {
+      "type": "string",
+      "description": "Relative path from project root to the primary logo file. SVG preferred; PNG accepted. Used in the CMS header and baked into the activation screen at build time."
+    },
+    "logoPathOnDark": {
+      "type": "string",
+      "description": "Optional alternate logo for use on dark backgrounds (e.g. the activation screen when backgroundColor is dark)."
+    },
+    "fontFamily": {
+      "type": "string",
+      "default": "Inter",
+      "description": "Font family name. The CMS will attempt to load this from Google Fonts unless overridden by fontUrl."
+    },
+    "fontUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "Optional full URL to a self-hosted font file or stylesheet. Overrides fontFamily default."
+    },
+    "supportUrl": {
+      "type": "string",
+      "format": "uri",
+      "description": "URL shown on the activation screen and in the CMS footer for support contact."
+    },
+    "supportEmail": {
+      "type": "string",
+      "format": "email",
+      "description": "Support email address shown on the activation screen."
+    },
+    "cmsEndpoint": {
+      "type": "string",
+      "description": "WebSocket URL the player will connect to. Should be wss:// in production, ws:// only for local testing. Baked into the player at build time. If omitted, the CLI will prompt during build."
+    },
+    "activationScreen": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "headline": {
+          "type": "string",
+          "default": "Connect this screen",
+          "description": "Large headline text on the activation screen."
+        },
+        "instructions": {
+          "type": "string",
+          "default": "Enter the code below in your dashboard to activate this screen.",
+          "description": "Supporting instructions shown under the headline."
+        },
+        "showDeviceInfo": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether to show device model, serial, and installation ID in small text at the bottom of the activation screen. Useful for support."
+        },
+        "showNetworkStatus": {
+          "type": "boolean",
+          "default": true,
+          "description": "Whether to show a small network-connected indicator (green dot) on the activation screen."
+        },
+        "backgroundImagePath": {
+          "type": "string",
+          "description": "Optional path to a background image for the activation screen. Replaces the solid backgroundColor if set."
+        },
+        "theme": {
+          "enum": ["light", "dark", "auto"],
+          "default": "light",
+          "description": "Activation screen theme. Affects which logo (logoPath vs logoPathOnDark) is used."
+        }
+      }
+    },
+    "cms": {
+      "type": "object",
+      "required": ["useCase", "hostingTarget", "expectedScreens"],
+      "additionalProperties": false,
+      "properties": {
+        "useCase": {
+          "enum": ["restaurant", "retail", "corporate", "wayfinding", "transit", "education", "healthcare", "other"],
+          "description": "Primary deployment context. Affects example content and default copy in the generated CMS."
+        },
+        "hostingTarget": {
+          "enum": ["here", "vercel", "railway", "self-hosted"],
+          "description": "Where the CMS server is deployed. Affects configuration in the starter template."
+        },
+        "expectedScreens": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Approximate number of screens at launch. Affects whether pagination, grouping, and fleet features are included in the generated CMS."
+        },
+        "features": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "bulkCommands": { "type": "boolean", "default": false, "description": "Include fleet.broadcast UI for bulk operations." },
+            "proofOfPlay": { "type": "boolean", "default": false, "description": "Include proof-of-play reporting page." },
+            "contentScheduling": { "type": "boolean", "default": true, "description": "Include scheduling UI for time-based content." },
+            "userManagement": { "type": "boolean", "default": false, "description": "Include multi-user / role management." }
+          }
+        }
+      }
+    },
+    "protocolVersion": {
+      "type": "string",
+      "const": "1.0",
+      "description": "TomorrowOS wire protocol version this brand.json targets. Set automatically by npx tomorrowos init; do not edit."
+    }
+  }
+}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+function packageRoot() {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..");
+}
+function copyStarter(destDir, force) {
+    const src = path.join(packageRoot(), "templates", "cms-starter");
+    if (!fs.existsSync(src)) {
+        console.error("[tomorrowos] Starter template not found. Re-install @tomorrowos/sdk (templates should ship with the package).");
+        process.exit(1);
+    }
+    const resolved = path.resolve(destDir);
+    if (fs.existsSync(resolved)) {
+        const entries = fs.readdirSync(resolved);
+        if (entries.length > 0 && !force) {
+            console.error(`[tomorrowos] Target directory is not empty: ${resolved}\nUse --force to copy anyway.`);
+            process.exit(1);
+        }
+    }
+    else {
+        fs.mkdirSync(resolved, { recursive: true });
+    }
+    fs.cpSync(src, resolved, { recursive: true });
+    console.log(`[tomorrowos] Created CMS project at ${resolved}`);
+    console.log("Next: cd there, run npm install, then npm run dev");
+}
+function cmdBuild(argv) {
+    const platformIdx = argv.indexOf("--platform");
+    const platform = platformIdx >= 0 && argv[platformIdx + 1] ? argv[platformIdx + 1] : "tizen";
+    console.log(`[tomorrowos] Player packaging for "${platform}" is not bundled in @tomorrowos/sdk yet.`);
+    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 printHelp() {
+    console.log(`tomorrowos — TomorrowOS SDK CLI
+
+Usage:
+  tomorrowos init [directory]     Copy cms-starter template (default: my-tomorrowos-cms)
+  tomorrowos build --platform …   Placeholder; player packaging lives in the player repo
+
+Options:
+  --force                         With init: copy into a non-empty directory
+
+Examples:
+  npx @tomorrowos/sdk init
+  npx @tomorrowos/sdk init ./my-cms
+`);
+}
+function main() {
+    const argv = process.argv.slice(2);
+    if (argv.length === 0 || argv[0] === "-h" || argv[0] === "--help") {
+        printHelp();
+        return;
+    }
+    const cmd = argv[0];
+    const rest = argv.slice(1);
+    if (cmd === "init") {
+        const force = rest.includes("--force");
+        const pos = rest.filter((a) => !a.startsWith("-"));
+        const target = pos[0] ?? "my-tomorrowos-cms";
+        copyStarter(target, force);
+        return;
+    }
+    if (cmd === "build") {
+        cmdBuild(rest);
+        return;
+    }
+    console.error(`[tomorrowos] Unknown command: ${cmd}`);
+    printHelp();
+    process.exit(1);
+}
+main();

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { TomorrowOS } from "./tomorrowos.js";
+export type { ListenOptions, TomorrowOSBrand, TomorrowOSOptions } from "./tomorrowos.js";
+export type { PairedDeviceRecord, PendingCodeRecord, TomorrowOSStore } from "./store/types.js";
+export { MemoryStore } from "./store/memory-store.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzF,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { TomorrowOS } from "./tomorrowos.js";
+export { MemoryStore } from "./store/memory-store.js";

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

@@ -0,0 +1,15 @@
+import type { 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 pairedDevices;
+    setPendingCode(code: string, record: PendingCodeRecord): Promise<void>;
+    getPendingCode(code: string): Promise<PendingCodeRecord | undefined>;
+    deletePendingCode(code: string): Promise<void>;
+    setPairedDevice(deviceId: string, record: PairedDeviceRecord): Promise<void>;
+    getPairedDevice(deviceId: string): Promise<PairedDeviceRecord | undefined>;
+}
+//# sourceMappingURL=memory-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/store/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,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;CAG3C"}

package/dist/store/memory-store.js

@@ -0,0 +1,23 @@
+/**
+ * Default store for development / single-node demos.
+ * Data is lost on process restart — not for multi-instance production.
+ */
+export class MemoryStore {
+    pendingCodes = new Map();
+    pairedDevices = new Map();
+    async setPendingCode(code, record) {
+        this.pendingCodes.set(code, record);
+    }
+    async getPendingCode(code) {
+        return this.pendingCodes.get(code);
+    }
+    async deletePendingCode(code) {
+        this.pendingCodes.delete(code);
+    }
+    async setPairedDevice(deviceId, record) {
+        this.pairedDevices.set(deviceId, record);
+    }
+    async getPairedDevice(deviceId) {
+        return this.pairedDevices.get(deviceId);
+    }
+}

package/dist/store/types.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Persistent (or replaceable) data for pairing — scheme C.
+ * Live WebSocket handles stay in-memory on the TomorrowOS instance.
+ */
+export interface PendingCodeRecord {
+    deviceId: string;
+    createdAt: number;
+}
+export interface PairedDeviceRecord {
+    pairingToken: string;
+    pairedAt: string;
+}
+/**
+ * Implement with Postgres, Redis, etc. Defaults to MemoryStore (Map).
+ * All methods async so DB backends do not need sync adapters.
+ */
+export interface TomorrowOSStore {
+    setPendingCode(code: string, record: PendingCodeRecord): Promise<void>;
+    getPendingCode(code: string): Promise<PendingCodeRecord | undefined>;
+    deletePendingCode(code: string): Promise<void>;
+    setPairedDevice(deviceId: string, record: PairedDeviceRecord): Promise<void>;
+    getPairedDevice(deviceId: string): Promise<PairedDeviceRecord | undefined>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +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;CAClB;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;CAC5E"}