@tomorrowos/sdk 0.9.20 → 0.9.22

package/README.md

@@ -4,7 +4,7 @@
 
 **On Replit:** if the user asks to set up / configure a CMS interactively, follow **`REPLIT_SETUP.md`** instead (Q&A for store → media → `brand.json`).
 
-**On Vercel:** if the user asks to set up / configure a CMS interactively, follow **`VERCEL_SETUP.md`** (Session pooler Supabase URL, Fluid compute + WebSocket, Cloudinary, `cms.hostingTarget: "vercel"`).
+**On Vercel:** if the user asks to set up / configure a CMS interactively, follow **`VERCEL_SETUP.md`** (Supabase or Neon pooled Postgres, Cloudinary or Vercel Blob media, Fluid compute + WebSocket, `cms.hostingTarget: "vercel"`).
 
 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.
 
@@ -71,8 +71,9 @@ Follow @tomorrowos/sdk VERCEL_SETUP.md and set up my TomorrowOS CMS.
 IF any step contradicts Vercel, adapt to settings that Vercel can accept.
 ```
 
-That wizard requires the Supabase **Session pooler** URL, prefers Cloudinary,
-enables Fluid compute for WebSockets, and sets `cms.hostingTarget` to `"vercel"`.
+That wizard asks: database (**Supabase** → **Neon** → SQLite demo), media (**Cloudinary** → **Vercel Blob** → local),
+branding (manual fields or **infer from a website URL**), enables Fluid compute for WebSockets, and sets
+`cms.hostingTarget` to `"vercel"`.
 
 ### Replit upgrade (existing CMS)
 

package/VERCEL_SETUP.md

@@ -5,7 +5,7 @@
 >
 > **On Vercel, this file is the setup questionnaire** (not `REPLIT_SETUP.md`, not `LLM_PROMPT.md`).
 >
-> Protocol id: `vercel-setup/1.0` — pairs with `@tomorrowos/sdk` packages that ship `templates/cms-starter` and this file.
+> Protocol id: `vercel-setup/1.1` — pairs with `@tomorrowos/sdk` packages that ship `templates/cms-starter` and this file.
 
 ## User trigger (copy-paste)
 
@@ -15,7 +15,7 @@ When a human pastes a prompt like this, **read this file and start Question 1 im
 Follow @tomorrowos/sdk VERCEL_SETUP.md and set up my TomorrowOS CMS.
 Ask only the questions listed in VERCEL_SETUP.md, in order. Do not use LLM_PROMPT.md or REPLIT_SETUP.md.
 If any step contradicts Vercel, adapt to settings Vercel can accept (document the adaptation).
-After all setup questions are answered (including Cloudinary Env Vars if you chose Cloudinary), configure and deploy — minimal verification only (Control Panel at /). Prefer Supabase Session pooler URL. Do not treat sandbox ENETUNREACH / IPv6 :5432 errors as a hard setup failure when the pooler URL is configured for production.
+After all setup questions are answered (including Cloudinary or Vercel Blob Env Vars if you chose those), configure and deploy — minimal verification only (Control Panel at /). Prefer Supabase Session pooler URL or Neon pooled URL. Do not treat sandbox ENETUNREACH / IPv6 :5432 errors as a hard setup failure when a pooler URL is configured for production.
 Question 3 only updates brand.json. Do not skip steps.
 ```
 
@@ -41,9 +41,9 @@ TomorrowOS CMS is **one Node process** that serves:
 |----------|-----------|
 | Single **Node HTTP server** entry (`tsx server.ts` / exported `http.Server` from `listen()`) | Next.js / Remix / static-only site as the CMS |
 | **Fluid compute** enabled (needed for WebSockets on Vercel) | Classic short-lived serverless with no WebSocket / no Fluid |
-| Durable store = **Supabase Postgres** (pooler URL) | **SQLite / `data/*.db` as production store** on Vercel (ephemeral filesystem) |
-| Media = **Cloudinary** (recommended) or other durable HTTPS URLs | Relying on local `public/uploads` alone for production fleets |
-| Env vars in **Vercel Project → Settings → Environment Variables** | Committing passwords / Cloudinary secrets / `.env` with secrets |
+| Durable store = **Postgres** (Supabase or Neon, pooled URL) | **SQLite / `data/*.db` as production store** on Vercel (ephemeral filesystem) |
+| Media = **Cloudinary** or **Vercel Blob** (durable HTTPS URLs) | Relying on local `public/uploads` alone for production fleets |
+| Env vars in **Vercel Project → Settings → Environment Variables** | Committing passwords / API secrets / `.env` with secrets |
 | `cms.hostingTarget`: `"vercel"` in `brand.json` | Creating `.replit` / Replit artifact files |
 
 **Do not** scaffold a leftover Next.js app “and put TomorrowOS beside it.” Remove Next scaffolds so TomorrowOS `server.ts` is the sole app.
@@ -56,15 +56,15 @@ Ask **only** these questions, in **this exact order**:
 
 | Step | Section | When |
 |------|---------|------|
-| 1 | **Question 1** — Supabase **Session pooler** connection string | Always |
-| 2 | **Question 2** — Media storage (+ Cloudinary Env Vars if chosen) | Always (after Q1) |
+| 1 | **Question 1** — Database (Supabase → Neon → SQLite) | Always |
+| 2 | **Question 2** — Media storage (Cloudinary → Vercel Blob → local) | Always (after Q1) |
 | 3 | **Question 3** — Brand / TomorrowOS look (`brand.json` only) | Always last |
 
-**That is the complete list.** Do **not** ask how many screens / devices. There is **no** “Question 2b” — Cloudinary credentials stay **inside Question 2**.
+**That is the complete list.** Do **not** ask how many screens / devices. There is **no** “Question 2b” — Cloudinary / Vercel Blob credentials stay **inside Question 2**.
 
 If the user says “just set it up, don’t ask questions,” respond:
 
-> I need a few quick answers from VERCEL_SETUP.md (Supabase Session pooler URL, media storage — plus Cloudinary credentials if you choose Cloudinary — and branding). It takes about a minute and ensures the CMS works on Vercel.
+> I need a few quick answers from VERCEL_SETUP.md (database — Supabase or Neon preferred — media storage, and branding). It takes about a minute and ensures the CMS works on Vercel.
 
 Then ask **Question 1**.
 
@@ -73,14 +73,14 @@ Then ask **Question 1**.
 ## Hard rules
 
 1. **Ask only VERCEL_SETUP.md questions 1–3.** Never use `LLM_PROMPT.md` or `REPLIT_SETUP.md` as the questionnaire.
-2. **One question at a time** (exception: after Cloudinary choice, immediately collect the three Cloudinary env vars in the same Question 2).
-3. **Do not invent** Cloudinary credentials, Supabase URLs, or brand colours.
-4. **Prefer `SUPABASE_URL`** for Supabase (same as Replit). `DATABASE_URL` may be used as fallback on Vercel, but document one canonical name — prefer **`SUPABASE_URL`**.
-5. **Always prefer the Supabase Session pooler URL** (port **6543**, host like `*.pooler.supabase.com`). Direct `db.*.supabase.co:5432` URLs commonly fail on Vercel/sandbox with **`ENETUNREACH`** (often IPv6).
+2. **One question at a time** (exception: after Cloudinary or Vercel Blob choice, immediately collect the required env vars in the same Question 2).
+3. **Do not invent** Cloudinary credentials, database URLs, Vercel Blob tokens, or brand colours.
+4. **Postgres env naming:** prefer **`SUPABASE_URL`** when using Supabase; prefer **`DATABASE_URL`** (or `NEON_DATABASE_URL`) when using Neon. `createTomorrowOSStore` accepts `SUPABASE_URL` then `DATABASE_URL`.
+5. **Always prefer pooled connection strings** (Supabase Session pooler port **6543**; Neon pooled host). Direct `:5432` URLs commonly fail on Vercel/sandbox with **`ENETUNREACH`** (often IPv6).
 6. **Prefer `npx @tomorrowos/sdk init`** (or `templates/cms-starter`) as the seed. Do not rebuild pairing / WebSocket / playlist APIs.
 7. **Never commit secrets.** Use Vercel Environment Variables (+ optional non-secret flags in committed `.env.example`).
 8. **Skip Replit-only files:** do **not** create `.replit`, `.replit-artifact`, or Replit `deploymentTarget`.
-9. **SQLite is not a production store on Vercel.** Configure Supabase for pairing/playlists. Keep `sqlitePath` only as a local-dev fallback in `createTomorrowOSStore`.
+9. **SQLite is not a production store on Vercel.** Offer it only as option **3** after explicit warning. Keep `sqlitePath` as local-dev fallback in `createTomorrowOSStore`.
 10. **Enable Fluid compute** for WebSockets. Confirm Project settings after scaffold.
 11. **Export the HTTP server** Vercel can capture: `const server = tomorrowos.listen(...); export default server;` (or equivalent). Do not export only the `TomorrowOS` class instance unless the platform documents another capture path.
 12. After Q&A: **configure → install → run/deploy → minimal verify** (Control Panel at `/`). Do not run a long test suite.
@@ -137,6 +137,8 @@ Then ask **Question 1**.
 
 Use the latest published `@tomorrowos/sdk` when scaffolding (do not invent versions).
 
+Add `@vercel/blob` to `dependencies` only when the user chooses **Vercel Blob** in Question 2.
+
 ### `server.ts` pattern (Vercel-adapted)
 
 ```ts
@@ -150,8 +152,11 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const brand = JSON.parse(readFileSync(join(__dirname, "brand.json"), "utf8"));
 
 const store = createTomorrowOSStore({
-  // Prefer SUPABASE_URL. On Vercel use the Session pooler connection string.
-  databaseUrl: process.env.SUPABASE_URL || process.env.DATABASE_URL,
+  // Supabase: SUPABASE_URL (pooler). Neon: DATABASE_URL (pooled).
+  databaseUrl:
+    process.env.SUPABASE_URL ||
+    process.env.NEON_DATABASE_URL ||
+    process.env.DATABASE_URL,
   sqlitePath: join(__dirname, "data", "tomorrowos.db") // local/dev fallback only
 });
 
@@ -192,24 +197,40 @@ If Vercel’s UI and this file disagree on bundling, **prefer whatever keeps a s
 
 - Device sockets are pinned to **one** function/instance. TomorrowOS device maps are **in-memory**.
 - For large fleets on multi-instance Vercel, prefer **one stable instance / region**, or accept that reconnects may land on another instance until the product adds shared presence (out of scope for this setup).
-- Always use **Supabase** so pairings/playlists survive cold starts and deploys.
+- Always use **Postgres** (Supabase or Neon) so pairings/playlists survive cold starts and deploys.
 
 ### What not to create
 
 - ❌ `.replit`, `.replit-artifact`
 - ❌ Next.js `app/` / `pages/` CMS
 - ❌ Separate “API project” without the Control Panel
-- ❌ Committing `SUPABASE_URL` passwords or Cloudinary secrets
+- ❌ Committing database passwords, Cloudinary secrets, or Blob tokens
 
 ---
 
-## Question 1 — Supabase Session pooler (always)
+## Question 1 — Database (always)
+
+> **Do not** ask screen counts. Present all three options; recommend **Supabase** for Vercel fleets.
 
-> Always configure Supabase for Vercel. Do **not** ask screen counts.
+### Step A — Ask storage choice
 
 **Ask exactly:**
 
-> Paste your Supabase Postgres **Session pooler** connection string. I will store it as the Vercel Environment Variable **`SUPABASE_URL`**.
+> Which database should TomorrowOS use on Vercel?
+>
+> **1. Supabase Postgres (recommended)** — durable pairing/playlists; use the **Session pooler** URL (`*.pooler.supabase.com:6543`).
+>
+> **2. Neon Postgres** — serverless Postgres native to Vercel; use Neon’s **pooled** connection string from the Neon dashboard (not the direct un-pooled host for serverless).
+>
+> **3. SQLite (`data/tomorrowos.db`)** — **demo / local only on Vercel.** The filesystem is ephemeral; pairings and playlists will not survive redeploys. Only choose this if you understand the limitation.
+>
+> Reply with **1**, **2**, or **3** (or “Supabase” / “Neon” / “SQLite”).
+
+### Step B — If **1 / Supabase**
+
+**Ask exactly:**
+
+> Paste your Supabase Postgres connection string. I will store it as the Vercel Environment Variable **`SUPABASE_URL`**.
 >
 > In Supabase: **Project Settings → Database → Connection string → Connection pooling** (Session mode).  
 > Preferred shape:  
@@ -230,9 +251,45 @@ If Vercel’s UI and this file disagree on bundling, **prefer whatever keeps a s
 4. **Do not** commit the real connection string.
 5. **Configuration over probing:** if local/`vercel dev` still shows `ENETUNREACH` / IPv6 errors, verify the string is the **pooler** (`pooler.supabase.com` + `:6543`). Treat remaining sandbox DNS issues as non-fatal when Production deploy Env Vars are correct — but **do** fix an obvious direct `:5432` URL before finishing.
 
-If the user refuses Supabase, warn that Vercel cannot use durable SQLite for fleets, then only continue with SQLite after explicit confirmation (local/demo only).
+### Step C — If **2 / Neon**
 
-**Later in Question 3:** set `cms.hostingTarget` to **`"vercel"`**.
+**Ask exactly:**
+
+> Paste your **Neon pooled** Postgres connection string. I will store it as **`DATABASE_URL`** (or `NEON_DATABASE_URL` if you prefer — wire whichever you set in `server.ts`).
+>
+> In Neon: **Dashboard → Connection details → Pooled connection** (enable pooling).  
+> Typical shape:  
+> `postgresql://[user]:[password]@[endpoint].pooler.[region].aws.neon.tech/[dbname]?sslmode=require`
+>
+> **Do not** use the direct (non-pooled) connection string for Vercel serverless unless Neon docs explicitly say otherwise for your plan.
+>
+> Confirm SSL (`sslmode=require`) is on (usually **yes**).
+
+**You must then:**
+
+1. Set Vercel Env Vars:
+   - `DATABASE_URL=<pooled Neon string>` (or `NEON_DATABASE_URL` + read it in `server.ts`)
+   - `TOMORROWOS_STORE=postgres`
+   - `DATABASE_SSL=true` (unless user explicitly disables SSL)
+2. Wire `server.ts` — `createTomorrowOSStore` uses `PostgresStore` for `postgres` / `supabase` drivers.
+3. **Do not** commit the real connection string.
+4. Same pooler guidance as Supabase: if you see `ENETUNREACH` on `:5432`, switch to Neon’s **pooled** URL.
+
+### Step D — If **3 / SQLite**
+
+**Warn exactly before continuing:**
+
+> SQLite on Vercel is **not** suitable for production fleets — data in `data/tomorrowos.db` is lost when the instance is recycled or redeployed. Continue only for a quick demo.
+
+Only proceed after the user explicitly confirms.
+
+**You must then:**
+
+1. Set `TOMORROWOS_STORE=sqlite` (or omit `DATABASE_URL` / `SUPABASE_URL` so the factory defaults to SQLite).
+2. Keep `sqlitePath` in `server.ts` for `data/tomorrowos.db`.
+3. Warn again in the final summary that they should move to Supabase or Neon for real devices.
+
+**Later in Question 3:** set `cms.hostingTarget` to **`"vercel"`** (all Q1 branches).
 
 ---
 
@@ -244,14 +301,15 @@ If the user refuses Supabase, warn that Vercel cannot use durable SQLite for fle
 
 > How should playlist media (images/videos) be stored?
 >
-> **Recommended on Vercel: Cloudinary** — durable public HTTPS URLs (`https://res.cloudinary.com/...`). Local `public/uploads` is ephemeral on serverless/filesystem deploys and is a poor fleet default.
+> **1. Cloudinary (recommended)** — durable public HTTPS URLs (`https://res.cloudinary.com/...`). Works out of the box with `@tomorrowos/sdk` auto-detection.
 >
-> Alternatives:
-> - **Local disk only** — `public/uploads` (OK for quick local tests; **not** for production Vercel fleets).
+> **2. Vercel Blob** — Vercel-native object storage; durable `https://*.public.blob.vercel-storage.com/...` URLs. Good when you want media on the same Vercel project without a Cloudinary account.
 >
-> Do you want me to set up **Cloudinary**? (yes / no)
+> **3. Local disk only** — `public/uploads` (OK for quick local tests; **not** for production Vercel fleets — files are ephemeral).
+>
+> Reply with **1**, **2**, or **3** (or “Cloudinary” / “Vercel Blob” / “local”).
 
-### Step B — If YES / Cloudinary (same Question 2)
+### Step B — If **1 / Cloudinary** (same Question 2)
 
 Immediately collect and store as **Vercel Environment Variables**:
 
@@ -264,10 +322,39 @@ Do **not** invent placeholders. Do **not** proceed to Question 3 until the three
 
 The SDK auto-detects these env vars.
 
-### If NO — local uploads
+### Step C — If **2 / Vercel Blob** (same Question 2)
+
+**Ask exactly:**
+
+> I will enable **Vercel Blob** for media uploads.
+>
+> 1. In the Vercel project: **Storage → Create → Blob** (or link an existing Blob store to this project).
+> 2. Confirm **`BLOB_READ_WRITE_TOKEN`** is available (Vercel usually injects it when Blob is linked).
+>
+> Paste the token only if it is not already set in your project Env Vars. Do you already have Blob linked on this Vercel project? (yes / no)
+
+**You must then:**
+
+1. Set Vercel Env Var: `BLOB_READ_WRITE_TOKEN=<token>` (if not auto-injected).
+2. `npm install @vercel/blob` (add to `dependencies`).
+3. Wire uploads so media returns **absolute HTTPS Blob URLs** stored in `uploaded_assets` (players need stable public URLs).
+   - The SDK **natively auto-detects Cloudinary** today. For Vercel Blob, add a thin upload bridge in the CMS project (e.g. custom route or middleware that calls `put()` from `@vercel/blob` and persists the returned `url` the same way Cloudinary URLs are stored).
+   - Minimum pattern:
+
+```ts
+import { put } from "@vercel/blob";
+
+// On upload: const blob = await put(filename, body, { access: "public", token: process.env.BLOB_READ_WRITE_TOKEN });
+// Store blob.url in uploaded_assets — same shape as Cloudinary secure URLs.
+```
+
+4. Warn: until the project’s Blob bridge is wired, Control Panel **Media** status may show local/ephemeral — verify uploads return `https://*.blob.vercel-storage.com/...` before calling setup complete.
+5. Do **not** proceed to Question 3 until `BLOB_READ_WRITE_TOKEN` exists (or Blob is linked and token is confirmed in the Vercel dashboard).
+
+### Step D — If **3 / local uploads**
 
 1. `mkdir -p public/uploads`
-2. Warn clearly: files may vanish on redeploy; players need stable HTTPS URLs — Cloudinary is strongly preferred for Vercel.
+2. Warn clearly: files may vanish on redeploy; players need stable HTTPS URLs — Cloudinary or Vercel Blob is strongly preferred for Vercel.
 
 ---
 
@@ -275,10 +362,17 @@ The SDK auto-detects these env vars.
 
 > Updates **only** `brand.json`. Does **not** change Vercel project settings, Env Vars, or `server.ts` store wiring beyond what Q1–Q2 already required.
 
+### Step A — Ask branding input
+
 **Ask exactly:**
 
-> Let’s brand your TomorrowOS experience. Please provide:
+> Let’s brand your TomorrowOS experience. You can answer in either way:
+>
+> **Option A — Website URL only**  
+> Paste **one public website URL** (your company / venue site). I will infer colours, fonts, name, tagline, and logo from that page and write `brand.json` to match its look.
 >
+> **Option B — Manual fields**  
+> Provide:
 > 1. **Product / venue name**
 > 2. **Tagline** (optional)
 > 3. **Primary colour** (hex, e.g. `#FF8A3D`)
@@ -287,12 +381,33 @@ The SDK auto-detects these env vars.
 > 6. **Secondary / accent colour** (hex, optional)
 > 7. **Logo** — upload SVG/PNG into the project, or a URL I can fetch into `./assets/`
 
-Then write `brand.json` (validate mentally against `brand.schema.json`). Minimum:
+### Step B — If the user gives **only a website URL** (Option A)
+
+**You must:**
+
+1. **Fetch and inspect** the page (HTTP GET the URL; follow one redirect if needed). Do not invent colours.
+2. **Derive branding** using this priority order:
+   - **Name:** `<title>`, `og:site_name`, or prominent header / logo `alt` text (trim to ≤ 60 chars).
+   - **Tagline:** `meta[name="description"]`, `og:description`, or first hero subtitle (≤ 120 chars).
+   - **Primary colour:** `meta[name="theme-color"]`, CSS `--primary` / `--brand` variables, or dominant accent from linked stylesheets / inline styles (convert to `#RRGGBB`).
+   - **Background colour:** `body` / `:root` background (default `#FAFAF9` if light site).
+   - **Text colour:** main body text colour (default `#0A0908` if light site).
+   - **Secondary colour:** muted border / secondary button colour, or a tint of the primary.
+   - **Font:** first `font-family` on `body` (strip quotes; default `Inter` if generic system stack).
+   - **Logo:** prefer `og:image`, then `link[rel="icon"]` / apple-touch-icon, then header `<img>` logo. Download into `./assets/logo.png` or `./assets/logo.svg` and set `logoPath` accordingly. If only favicon exists, use it and note size in the summary.
+3. **Contrast check:** if background is dark, set `activationScreen.theme` to `"dark"` and add `logoPathOnDark` when a light logo variant exists.
+4. **Infer `cms.useCase`** from page content when obvious (restaurant / retail / corporate / etc.); otherwise `"other"`.
+5. **Show a one-line summary** to the user (name + primary hex + logo path) before or while writing the file — do not ask a second branding question unless fetch failed.
+6. If the URL is unreachable, blocked, or has no usable styles, say so and fall back to **Option B** manual questions for missing fields only.
+
+### Step C — Write `brand.json`
+
+Validate mentally against `brand.schema.json`. Minimum:
 
 ```json
 {
-  "name": "<user name>",
-  "tagline": "<user tagline or Digital signage>",
+  "name": "<user name or site-derived name>",
+  "tagline": "<tagline or Digital signage>",
   "targetPlatforms": ["tizen"],
   "primaryColor": "#FF8A3D",
   "secondaryColor": "#F5F3EF",
@@ -335,15 +450,18 @@ Then:
 2. Apply Vercel-adapted `server.ts` (**export `listen()` HTTP server**).
 3. Add/adjust `vercel.json` with **`fluid: true`** (or enable Fluid in the dashboard).
 4. Do **not** add `.replit*`.
+5. If Q2 = Vercel Blob: install `@vercel/blob` and wire the upload bridge.
 
 ### B. Environment Variables (Vercel dashboard + local)
 
 | Name | Required | Notes |
 |------|----------|--------|
-| `SUPABASE_URL` | Yes (production) | **Session pooler** `:6543` |
-| `TOMORROWOS_STORE` | Yes | `supabase` |
+| `SUPABASE_URL` | If Q1 = Supabase | **Session pooler** `:6543` |
+| `DATABASE_URL` | If Q1 = Neon | **Pooled** Neon string |
+| `TOMORROWOS_STORE` | Yes | `supabase`, `postgres`, or `sqlite` |
 | `DATABASE_SSL` | Yes (typical) | `true` |
 | `CLOUDINARY_*` | If Q2 = Cloudinary | Three keys |
+| `BLOB_READ_WRITE_TOKEN` | If Q2 = Vercel Blob | From Vercel Blob store |
 | `PORT` | Optional | Vercel injects as needed |
 
 Mirror non-secrets in `.env` for local `npm run dev` if helpful; never commit secrets.
@@ -376,8 +494,8 @@ Tell the user:
 **Do:**
 
 1. Control Panel HTML at `/`
-2. Server status: Media OK when Cloudinary configured
-3. Database: if ERROR shows **`ENETUNREACH` … IPv6 … `:5432`**, switch `SUPABASE_URL` to **pooler `:6543`** and redeploy — call this out explicitly to the user
+2. Server status: Media OK when Cloudinary or Blob configured
+3. Database: if ERROR shows **`ENETUNREACH` … IPv6 … `:5432`**, switch to **pooled** URL (Supabase `:6543` or Neon pooler) and redeploy — call this out explicitly to the user
 4. Fluid compute on
 
 **Do not block** on long WebSocket/device pairing tests unless the user asks.
@@ -388,13 +506,15 @@ Tell the user:
 
 | Symptom | Likely cause | Fix |
 |---------|--------------|-----|
-| `ENETUNREACH` / IPv6 / `:5432` | Direct Supabase DB URL | Use **Session pooler** `*.pooler.supabase.com:6543` |
-| Control Panel OK, devices never stay paired after restart | SQLite / ephemeral disk | Must use Supabase |
-| Uploads break / broken thumbs in prod | Local `public/uploads` | Cloudinary |
+| `ENETUNREACH` / IPv6 / `:5432` | Direct Postgres URL | Use **pooled** URL (Supabase `:6543` or Neon pooler) |
+| Control Panel OK, devices never stay paired after restart | SQLite / ephemeral disk | Use Supabase or Neon |
+| Uploads break / broken thumbs in prod | Local `public/uploads` | Cloudinary or Vercel Blob |
+| Blob uploads 401 / missing token | Blob not linked | Vercel Storage → Blob + `BLOB_READ_WRITE_TOKEN` |
 | WebSocket fails / devices drop immediately | Fluid off / static-only / Next wrapper | Enable Fluid; sole Node `listen()` server |
 | Agent created Next.js + TomorrowOS | Wrong scaffold | Remove Next; keep cms-starter |
 | Secrets in git | Mistake | Rotate keys; move to Vercel Env Vars |
 | Replit files present | Copied wrong protocol | Delete `.replit*`; use this file |
+| Brand colours wrong from URL | SPA / blocked fetch | Manual Option B for colours + logo |
 
 ---
 
@@ -405,10 +525,10 @@ Tell the user:
 | Secrets | Replit Secrets | Vercel Environment Variables |
 | Deploy config | `.replit`, artifact `kind=web` | `vercel.json` + Fluid; **no** `.replit` |
 | `hostingTarget` | `"here"` | `"vercel"` |
-| Supabase URL | Prefer pooler; Preview DNS may fail | **Require pooler**; direct `:5432` often `ENETUNREACH` |
-| SQLite | Demo OK on persistent Repl disk | **Not** production on Vercel |
-| Object Storage option | Replit Object Storage | N/A — prefer Cloudinary |
+| Database | Supabase (primary) | Supabase **or Neon** (pooled); SQLite demo only |
+| Media | Cloudinary or Replit Object Storage | Cloudinary **or Vercel Blob** |
 | WebSocket | Long-lived Node (Autoscale) | Fluid compute + Node server export |
+| Brand from URL | Not in Replit protocol | **Option A** in Question 3 — infer from website |
 
 ---
 
@@ -418,10 +538,10 @@ After setup, report:
 
 1. **Live URL** (Production)
 2. **Env Vars set** (names only — never values)
-3. **Store:** Supabase pooler / SSL flags
-4. **Media:** Cloudinary or local (with warning)
-5. **Brand:** name + `hostingTarget: vercel`
-6. **Adaptations from Replit protocol:** list (e.g. skipped `.replit`, exported HTTP server, Fluid, pooler URL)
+3. **Store:** Supabase pooler / Neon pooled / SQLite (with warning)
+4. **Media:** Cloudinary, Vercel Blob, or local (with warning)
+5. **Brand:** name + `hostingTarget: vercel` (+ note if derived from website URL)
+6. **Adaptations from Replit protocol:** list (e.g. skipped `.replit`, exported HTTP server, Fluid, pooler URL, Blob bridge)
 7. **Open action:** if Database still ERROR, paste the pooler instruction again
 
-Protocol complete when the Control Panel renders at `/` on the deployed (or local) server and Q1–Q3 configuration is saved — even if a sandbox DB probe still flakes **after** the pooler URL is correctly set for Production.
+Protocol complete when the Control Panel renders at `/` on the deployed (or local) server and Q1–Q3 configuration is saved — even if a sandbox DB probe still flakes **after** the pooled URL is correctly set for Production.

package/dist/tomorrowos.d.ts

@@ -136,6 +136,15 @@ export declare class TomorrowOS extends EventEmitter {
         onOffTimer: DeviceOnOffTimer;
         pushed: boolean;
     }>;
+    /**
+     * Clear the daily on/off timer. The player keeps its current mute / power-save
+     * state until a new timer is set.
+     */
+    clearDeviceOnOffTimer(deviceId: string): Promise<{
+        deviceId: string;
+        onOffTimer: null;
+        pushed: boolean;
+    }>;
     private pushOnOffTimerToDevice;
     setDeviceName(deviceId: string, deviceName: string): Promise<{
         deviceId: string;

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

@@ -441,15 +441,33 @@ export class TomorrowOS extends EventEmitter {
         const pushed = await this.pushOnOffTimerToDevice(id);
         return { deviceId: id, onOffTimer, pushed };
     }
+    /**
+     * Clear the daily on/off timer. The player keeps its current mute / power-save
+     * state until a new timer is set.
+     */
+    async clearDeviceOnOffTimer(deviceId) {
+        const id = String(deviceId || "").trim();
+        if (!id) {
+            throw new Error("deviceId is required");
+        }
+        const existing = await this.store.getPairedDevice(id);
+        if (!existing) {
+            throw new Error("Device is not paired");
+        }
+        const { onOffTimer: _removed, ...rest } = existing;
+        await this.store.setPairedDevice(id, rest);
+        const pushed = await this.pushOnOffTimerToDevice(id);
+        return { deviceId: id, onOffTimer: null, pushed };
+    }
     async pushOnOffTimerToDevice(deviceId) {
         const existing = await this.store.getPairedDevice(deviceId);
-        if (!existing?.onOffTimer)
+        if (!existing)
             return false;
         const ws = this.devices.get(deviceId);
         if (!ws || ws.readyState !== WebSocket.OPEN)
             return false;
         try {
-            const result = await this.sendCommandToSocket(ws, deviceId, "device.display.setOnOffTimer", { onOffTimer: existing.onOffTimer }, 15_000);
+            const result = await this.sendCommandToSocket(ws, deviceId, "device.display.setOnOffTimer", { onOffTimer: existing.onOffTimer ?? null }, 15_000);
             return result.status === "success" || result.status === "accepted";
         }
         catch (err) {
@@ -1178,8 +1196,14 @@ export class TomorrowOS extends EventEmitter {
                 const deviceId = decodeURIComponent(deviceOnOffTimer[1]);
                 const body = (await readJsonBody(req));
                 try {
-                    const result = await this.setDeviceOnOffTimer(deviceId, body.onOffTimer ?? body);
-                    sendJson(res, 200, { status: "success", ...result });
+                    if (body.clear === true || body.onOffTimer === null) {
+                        const result = await this.clearDeviceOnOffTimer(deviceId);
+                        sendJson(res, 200, { status: "success", ...result });
+                    }
+                    else {
+                        const result = await this.setDeviceOnOffTimer(deviceId, body.onOffTimer ?? body);
+                        sendJson(res, 200, { status: "success", ...result });
+                    }
                 }
                 catch (e) {
                     const msg = e instanceof Error ? e.message : "On/off timer failed";
@@ -1187,6 +1211,18 @@ export class TomorrowOS extends EventEmitter {
                 }
                 return;
             }
+            if (req.method === "DELETE" && deviceOnOffTimer) {
+                const deviceId = decodeURIComponent(deviceOnOffTimer[1]);
+                try {
+                    const result = await this.clearDeviceOnOffTimer(deviceId);
+                    sendJson(res, 200, { status: "success", ...result });
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : "On/off timer clear failed";
+                    sendJson(res, 400, { status: "failed", error: msg });
+                }
+                return;
+            }
             if (req.method === "GET" && pathname === "/playlists") {
                 const playlists = await this.playlists.listPlaylists();
                 sendJson(res, 200, { status: "success", playlists });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.9.20",
+  "version": "0.9.22",
   "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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "my-cms",
-  "version": "0.9.20",
+  "version": "0.9.22",
   "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
   "private": true,
   "type": "module",
@@ -13,7 +13,7 @@
     "build-player": "tomorrowos build --platform tizen"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.9.20",
+    "@tomorrowos/sdk": "^0.9.22",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

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

@@ -187,6 +187,7 @@
         <h2>On / off timer</h2>
         <p class="hint" id="onOffTimerModalHint">
           Daily on/off times follow the device clock. Off blacks the screen; the player stays powered and connected to the CMS.
+          Removing the timer stops the schedule and leaves the screen in its current on or off state until you set a timer again.
         </p>
         <div class="on-off-timer-grid">
           <label class="field-label">
@@ -200,6 +201,7 @@
         </div>
         <div class="modal-actions">
           <button type="button" id="onOffTimerSaveBtn" class="primary">Save</button>
+          <button type="button" id="onOffTimerRemoveBtn" class="danger hidden">Remove timer</button>
           <button type="button" data-close-on-off-timer-modal="1">Cancel</button>
         </div>
       </div>

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

@@ -1102,7 +1102,7 @@ function appendHardwareTimerStatusRow(meta, device) {
   row.className = "device-meta-row device-meta-row--timer-status";
 
   const dt = document.createElement("dt");
-  dt.textContent = "Hardware Timer Status";
+  dt.textContent = "Hardware timer status";
 
   const dd = document.createElement("dd");
   const statusWrap = document.createElement("span");
@@ -1895,11 +1895,17 @@ function openOnOffTimerModal(deviceId) {
   const modal = document.getElementById("onOffTimerModal");
   const onEl = document.getElementById("onOffTimerTurnOnAt");
   const offEl = document.getElementById("onOffTimerTurnOffAt");
+  const removeBtn = document.getElementById("onOffTimerRemoveBtn");
   if (!modal || !onEl || !offEl) return;
 
   const timer = device.onOffTimer || {};
+  const configured = hasConfiguredOnOffTimer(device.onOffTimer);
   onEl.value = normalizeTimeInputValue(timer.turnOnAt, "06:00");
   offEl.value = normalizeTimeInputValue(timer.turnOffAt, "18:00");
+  if (removeBtn) {
+    removeBtn.classList.toggle("hidden", !configured);
+    removeBtn.disabled = false;
+  }
   modal.classList.remove("hidden");
 }
 
@@ -1916,6 +1922,7 @@ async function saveOnOffTimerModal() {
   const onEl = document.getElementById("onOffTimerTurnOnAt");
   const offEl = document.getElementById("onOffTimerTurnOffAt");
   const saveBtn = document.getElementById("onOffTimerSaveBtn");
+  const removeBtn = document.getElementById("onOffTimerRemoveBtn");
   if (!onEl || !offEl) return;
 
   const onOffTimer = {
@@ -1929,6 +1936,7 @@ async function saveOnOffTimerModal() {
   }
 
   if (saveBtn) saveBtn.disabled = true;
+  if (removeBtn) removeBtn.disabled = true;
   try {
     const res = await fetch(`/device/${encodeURIComponent(deviceId)}/on-off-timer`, {
       method: "POST",
@@ -1947,6 +1955,43 @@ async function saveOnOffTimerModal() {
     alert(err?.message || "Could not save on/off timer");
   } finally {
     if (saveBtn) saveBtn.disabled = false;
+    if (removeBtn) removeBtn.disabled = false;
+  }
+}
+
+async function removeOnOffTimerModal() {
+  const deviceId = onOffTimerModalDeviceId;
+  if (!deviceId) return;
+
+  if (
+    !confirm(
+      "Remove the on/off timer? The screen will stay in its current on or off state until you set a timer again."
+    )
+  ) {
+    return;
+  }
+
+  const saveBtn = document.getElementById("onOffTimerSaveBtn");
+  const removeBtn = document.getElementById("onOffTimerRemoveBtn");
+  if (saveBtn) saveBtn.disabled = true;
+  if (removeBtn) removeBtn.disabled = true;
+  try {
+    const res = await fetch(`/device/${encodeURIComponent(deviceId)}/on-off-timer`, {
+      method: "DELETE"
+    });
+    const data = await res.json();
+    if (!res.ok || data.status === "failed") {
+      alert(data.error || "Could not remove on/off timer");
+      return;
+    }
+    showResult({ deviceId, onOffTimer: null, pushed: data.pushed });
+    closeOnOffTimerModal();
+    await fetchDevices();
+  } catch (err) {
+    alert(err?.message || "Could not remove on/off timer");
+  } finally {
+    if (saveBtn) saveBtn.disabled = false;
+    if (removeBtn) removeBtn.disabled = false;
   }
 }
 
@@ -2275,6 +2320,9 @@ document.addEventListener("DOMContentLoaded", () => {
   document
     .getElementById("onOffTimerSaveBtn")
     ?.addEventListener("click", () => void saveOnOffTimerModal());
+  document
+    .getElementById("onOffTimerRemoveBtn")
+    ?.addEventListener("click", () => void removeOnOffTimerModal());
   document.querySelectorAll("[data-close-download-failed-modal]").forEach((el) => {
     el.addEventListener("click", closeDownloadFailedModal);
   });