@tomorrowos/sdk 0.9.31 → 0.9.33

package/package.json

@@ -1,51 +1,51 @@
-{
-  "name": "@tomorrowos/sdk",
-  "version": "0.9.31",
-  "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",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "bin": {
-    "tomorrowos": "./dist/cli.js"
-  },
-  "files": [
-    "dist",
-    "templates",
-    "README.md",
-    "LLM_PROMPT.md",
-    "REPLIT_SETUP.md",
-    "VERCEL_SETUP.md",
-    "REPLIT_UPGRADE.md",
-    "BUILD_GUARDRAILS.md",
-    "PLAYER_INSTALL.md",
-    "brand.schema.json",
-    "brand.example.json"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "dependencies": {
-    "better-sqlite3": "^12.11.1",
-    "cloudinary": "^2.10.0",
-    "pg": "^8.22.0",
-    "ws": "^8.21.0"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^20.19.41",
-    "@types/pg": "^8.20.0",
-    "@types/ws": "^8.5.10",
-    "typescript": "^5.5.0"
-  },
-  "license": "Apache-2.0"
-}
+{
+  "name": "@tomorrowos/sdk",
+  "version": "0.9.33",
+  "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",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "tomorrowos": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LLM_PROMPT.md",
+    "REPLIT_SETUP.md",
+    "VERCEL_SETUP.md",
+    "REPLIT_UPGRADE.md",
+    "BUILD_GUARDRAILS.md",
+    "PLAYER_INSTALL.md",
+    "brand.schema.json",
+    "brand.example.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "better-sqlite3": "^12.11.1",
+    "cloudinary": "^2.10.0",
+    "pg": "^8.22.0",
+    "ws": "^8.21.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^20.19.41",
+    "@types/pg": "^8.20.0",
+    "@types/ws": "^8.5.10",
+    "typescript": "^5.5.0"
+  },
+  "license": "Apache-2.0"
+}

package/templates/cms-starter/package.json

@@ -1,25 +1,25 @@
-{
-  "name": "my-cms",
-  "version": "0.9.31",
-  "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
-  "private": true,
-  "type": "module",
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "dev": "tsx watch server.ts",
-    "start": "tsx server.ts",
-    "build-player": "tomorrowos build --platform tizen"
-  },
-  "dependencies": {
-    "@tomorrowos/sdk": "^0.9.31",
-    "dotenv": "^17.2.3",
-    "tsx": "^4.19.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.5.0"
-  }
-}
-
+{
+  "name": "my-cms",
+  "version": "0.9.33",
+  "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx watch server.ts",
+    "start": "tsx server.ts",
+    "build-player": "tomorrowos build --platform tizen"
+  },
+  "dependencies": {
+    "@tomorrowos/sdk": "^0.9.33",
+    "dotenv": "^17.2.3",
+    "tsx": "^4.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  }
+}
+

package/templates/cms-starter-v0/README.md

@@ -1,8 +1,14 @@
 # TomorrowOS CMS Starter (Vercel / v0)
 
-- **Publish:** Fluid Function `api/index.ts` → `export default server` (WebSockets)
-- **Preview (v0):** root Next.js shell proxies HTTP → TomorrowOS on `:3001`
-- **`cms-panel/`** Control Panel static files (not `public/`)
+This starter is for **Vercel Publish** and **v0**. It follows
+[Vercel Functions WebSockets](https://vercel.com/docs/functions/websockets):
+
+- **`cms-app.ts`** — shared `TomorrowOS.listen` + `export const server`
+- **`api/index.ts`** — Production Function: `export default server` (Fluid)
+- **`server.ts`** — local / Preview: same server (`npm start`)
+- **`cms-panel/`** — Control Panel static files (not `public/`)
+- **`preview/`** — Next.js shell for v0 Preview only
+- **`vercel.json`** — `fluid`, rewrites → `/api`, `maxDuration`
 
 ## Scaffold
 
@@ -10,26 +16,35 @@
 npx @tomorrowos/sdk init my-cms --hosting v0
 ```
 
-## Local / v0 Preview
+## Local development
 
 ```bash
 npm install
 npm run dev
 ```
 
-`npm run dev` starts **both**:
+Open `http://localhost:3000`. Pairing uses `ws://localhost:3000/` (root path).
+
+### v0-style Preview
+
+```bash
+npm run dev:preview
+```
 
-1. TomorrowOS on `http://127.0.0.1:3001`
-2. Next on `http://localhost:3000` → proxies `/` to TomorrowOS
+Pair devices against the **Publish URL**, not Preview.
 
-Open Preview at `http://localhost:3000` — you should see the Control Panel, **not** “Your v0 generation will show here”.
+## Production acceptance
 
-## Production
+1. `GET /status` → JSON  
+2. `GET /` → Control Panel  
+3. WebSocket upgrade on `/` or `/api` → **101** (not 200 HTML)
 
-Unchanged: `vercel.json` + `api/index.ts`. Acceptance: `/status` JSON + WebSocket **101**.
+TV endpoint: `https://YOUR.vercel.app/` (players also try `/api` on `*.vercel.app`).
 
 ## Replit / Railway
 
+Use the default starter (unchanged Node listen, no `api/` Function):
+
 ```bash
 npx @tomorrowos/sdk init my-cms --hosting replit
 ```

package/templates/cms-starter-v0/package.json

@@ -1,35 +1,35 @@
-{
-  "name": "my-cms",
-  "version": "0.9.31",
-  "description": "TomorrowOS CMS for Vercel / v0 (Fluid Function Publish + Next Preview proxy).",
-  "private": true,
-  "type": "module",
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "dev": "npm run dev:preview",
-    "dev:tomorrowos": "cross-env TOMORROWOS_INTERNAL_PORT=3001 tsx watch server.ts",
-    "dev:next": "next dev -p 3000",
-    "dev:preview": "concurrently -k -n cms,next -c cyan,magenta \"npm:dev:tomorrowos\" \"npm:dev:next\"",
-    "start": "tsx server.ts",
-    "build": "node -e \"process.exit(0)\"",
-    "build-player": "tomorrowos build --platform tizen"
-  },
-  "dependencies": {
-    "@tomorrowos/sdk": "^0.9.31",
-    "concurrently": "^9.1.2",
-    "cross-env": "^7.0.3",
-    "dotenv": "^17.2.3",
-    "next": "^15.1.0",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "tsx": "^4.19.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/react": "^19.0.0",
-    "@types/react-dom": "^19.0.0",
-    "typescript": "^5.5.0"
-  }
-}
+{
+  "name": "my-cms",
+  "version": "0.9.33",
+  "description": "TomorrowOS CMS for Vercel / v0 Publish (Fluid Function + WebSockets + optional Next Preview).",
+  "private": true,
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "dev": "tsx watch server.ts",
+    "dev:tomorrowos": "cross-env TOMORROWOS_INTERNAL_PORT=3001 tsx watch server.ts",
+    "dev:next": "cd preview && next dev -p 3000",
+    "dev:preview": "concurrently -k \"npm:dev:tomorrowos\" \"npm:dev:next\"",
+    "start": "tsx server.ts",
+    "build": "node -e \"process.exit(0)\"",
+    "build-player": "tomorrowos build --platform tizen"
+  },
+  "dependencies": {
+    "@tomorrowos/sdk": "^0.9.33",
+    "dotenv": "^17.2.3",
+    "tsx": "^4.19.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "concurrently": "^9.1.2",
+    "cross-env": "^7.0.3",
+    "next": "^15.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/templates/cms-starter-v0/preview/app/layout.tsx

@@ -0,0 +1,11 @@
+export default function RootLayout({
+  children
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  );
+}

package/templates/cms-starter-v0/preview/app/page.tsx

@@ -0,0 +1,3 @@
+export default function PreviewShellPage() {
+  return null;
+}

package/templates/cms-starter-v0/preview/next-env.d.ts

@@ -0,0 +1,2 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />

package/templates/cms-starter-v0/preview/next.config.mjs

@@ -0,0 +1,18 @@
+const internalUrl =
+  process.env.TOMORROWOS_INTERNAL_URL || "http://127.0.0.1:3001";
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  async rewrites() {
+    return {
+      fallback: [
+        {
+          source: "/:path*",
+          destination: `${internalUrl}/:path*`
+        }
+      ]
+    };
+  }
+};
+
+export default nextConfig;

package/templates/cms-starter-v0/preview/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "preserve",
+    "incremental": true,
+    "plugins": [{ "name": "next" }]
+  },
+  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
+  "exclude": ["node_modules"]
+}

package/templates/cms-starter-v0/tsconfig.json

@@ -9,6 +9,5 @@
     "noEmit": true,
     "types": ["node"]
   },
-  "include": ["server.ts", "cms-app.ts", "api/**/*.ts"],
-  "exclude": ["app", "node_modules", ".next"]
+  "include": ["server.ts"]
 }

package/templates/cms-starter-v0/app/[[...slug]]/route.ts

@@ -1,89 +0,0 @@
-/**
- * v0 / local Preview shell — proxies all HTTP to TomorrowOS on :3001.
- * Production Publish does NOT use this file; traffic goes to api/index.ts (Fluid).
- */
-
-const INTERNAL =
-  process.env.TOMORROWOS_INTERNAL_URL || "http://127.0.0.1:3001";
-
-const HOP_BY_HOP = new Set([
-  "connection",
-  "keep-alive",
-  "proxy-authenticate",
-  "proxy-authorization",
-  "te",
-  "trailers",
-  "transfer-encoding",
-  "upgrade",
-  "host",
-  "content-length"
-]);
-
-async function proxyToTomorrowOS(req: Request): Promise<Response> {
-  const incoming = new URL(req.url);
-  const target = new URL(incoming.pathname + incoming.search, INTERNAL);
-
-  const headers = new Headers();
-  req.headers.forEach((value, key) => {
-    if (!HOP_BY_HOP.has(key.toLowerCase())) headers.set(key, value);
-  });
-
-  const init: RequestInit = {
-    method: req.method,
-    headers,
-    redirect: "manual"
-  };
-
-  if (req.method !== "GET" && req.method !== "HEAD") {
-    init.body = req.body;
-    // @ts-expect-error Node fetch duplex for streaming bodies
-    init.duplex = "half";
-  }
-
-  try {
-    const upstream = await fetch(target, init);
-    const outHeaders = new Headers();
-    upstream.headers.forEach((value, key) => {
-      if (!HOP_BY_HOP.has(key.toLowerCase())) outHeaders.set(key, value);
-    });
-    return new Response(upstream.body, {
-      status: upstream.status,
-      statusText: upstream.statusText,
-      headers: outHeaders
-    });
-  } catch {
-    const html = `<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <title>TomorrowOS Preview</title>
-  <style>
-    body { font-family: system-ui, sans-serif; max-width: 40rem; margin: 3rem auto; padding: 0 1rem; line-height: 1.5; }
-    code { background: #f4f4f5; padding: 0.1em 0.35em; border-radius: 4px; }
-  </style>
-</head>
-<body>
-  <h1>TomorrowOS Preview</h1>
-  <p>The Next.js shell is running, but TomorrowOS is not reachable at <code>${INTERNAL}</code>.</p>
-  <p>Start both processes:</p>
-  <pre><code>npm run dev</code></pre>
-  <p>(runs TomorrowOS on :3001 and Next on :3000). Publish / Production does not use this shell.</p>
-</body>
-</html>`;
-    return new Response(html, {
-      status: 502,
-      headers: { "content-type": "text/html; charset=utf-8" }
-    });
-  }
-}
-
-export const dynamic = "force-dynamic";
-export const runtime = "nodejs";
-
-export const GET = proxyToTomorrowOS;
-export const POST = proxyToTomorrowOS;
-export const PUT = proxyToTomorrowOS;
-export const PATCH = proxyToTomorrowOS;
-export const DELETE = proxyToTomorrowOS;
-export const HEAD = proxyToTomorrowOS;
-export const OPTIONS = proxyToTomorrowOS;

package/templates/cms-starter-v0/app/layout.tsx

@@ -1,15 +0,0 @@
-/**
- * Minimal layout so the App Router can boot for v0 Preview.
- * All real UI is proxied from TomorrowOS via app/[[...slug]]/route.ts.
- */
-export default function RootLayout({
-  children
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="en">
-      <body style={{ margin: 0 }}>{children}</body>
-    </html>
-  );
-}

package/templates/cms-starter-v0/next-env.d.ts

@@ -1,4 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-
-// NOTE: This file should not be edited — see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/templates/cms-starter-v0/next.config.mjs

@@ -1,15 +0,0 @@
-/**
- * Preview-only Next config. Production Publish ignores this
- * (`vercel.json` → framework: null + api/index.ts Fluid Function).
- *
- * HTTP proxy lives in `app/[[...slug]]/route.ts` (not rewrites) so POST
- * uploads and custom 502 pages work when TomorrowOS is down.
- *
- * @type {import('next').NextConfig}
- */
-const nextConfig = {
-  // Do not add a root page.tsx that returns null — v0 shows
-  // "Your v0 generation will show here" instead of the Control Panel.
-};
-
-export default nextConfig;