@tomorrowos/sdk 0.8.9 → 0.9.1

package/REPLIT_SETUP.md

@@ -232,7 +232,7 @@ Allowed extras (optional): `"build-player": "tomorrowos build --platform tizen"`
     "node": ">=20"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.8.8",
+    "@tomorrowos/sdk": "^0.9.1",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/dist/tomorrowos.d.ts

@@ -129,6 +129,8 @@ export declare class TomorrowOS extends EventEmitter {
     /** Prefer CMS-saved display name; fall back to handshake hardware model on first pair. */
     private resolveDeviceNameForPairing;
     private persistRegistryDisplayName;
+    /** First pair only — seed registry display name from device handshake when unset. */
+    private seedRegistryDisplayNameIfEmpty;
     private pushDeviceLog;
     private getDeviceLogs;
     private isDeviceConnected;

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

@@ -267,6 +267,9 @@ export class TomorrowOS extends EventEmitter {
             lastOnlineAt: this.isDeviceConnected(deviceId) ? now : undefined,
             lastOfflineAt: this.isDeviceConnected(deviceId) ? undefined : now
         });
+        if (deviceName) {
+            await this.seedRegistryDisplayNameIfEmpty(deviceId, deviceName);
+        }
         await this.store.deletePendingCode(normalized);
         const ws = this.devices.get(deviceId);
         if (ws && ws.readyState === WebSocket.OPEN) {
@@ -422,6 +425,16 @@ export class TomorrowOS extends EventEmitter {
             displayName: displayName.trim()
         });
     }
+    /** First pair only — seed registry display name from device handshake when unset. */
+    async seedRegistryDisplayNameIfEmpty(deviceId, displayName) {
+        const reg = await this.store.getDeviceRegistry(deviceId);
+        if (!reg || reg.displayName?.trim())
+            return;
+        await this.store.setDeviceRegistry(deviceId, {
+            ...reg,
+            displayName: displayName.trim()
+        });
+    }
     pushDeviceLog(deviceId, entry) {
         const key = String(deviceId || "").trim();
         if (!key)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.8.9",
+  "version": "0.9.1",
   "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.8.9",
+  "version": "0.9.1",
   "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.8.9",
+    "@tomorrowos/sdk": "^0.9.1",
     "dotenv": "^17.2.3",
     "tsx": "^4.19.0"
   },

package/templates/cms-starter/public/assets/player-download/android.svg

@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48" role="img" aria-label="Android">
+  <path fill="#3DDC84" d="M12 20c-2.2 0-4 1.8-4 4v8c0 2.2 1.8 4 4 4h24c2.2 0 4-1.8 4-4v-8c0-2.2-1.8-4-4-4H12z"/>
+  <path fill="#3DDC84" d="M16 14l-3-5M32 14l3-5M18 10h12"/>
+  <circle cx="18" cy="24" r="2" fill="#fff"/>
+  <circle cx="30" cy="24" r="2" fill="#fff"/>
+  <path fill="#3DDC84" d="M8 22H6v6h2v-6zm34 0h-2v6h2v-6z"/>
+</svg>

package/templates/cms-starter/public/assets/player-download/brightsign.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 40" role="img" aria-label="BrightSign">
+  <rect x="0" y="8" width="24" height="24" rx="4" fill="#E85D04"/>
+  <path d="M10 16 L18 20 L10 24 Z" fill="#fff"/>
+  <text x="32" y="27" font-family="Segoe UI, Arial, sans-serif" font-size="22" font-weight="700" fill="#1a1a1a">BrightSign</text>
+</svg>

package/templates/cms-starter/public/assets/player-download/lg-webos.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 48" role="img" aria-label="LG webOS">
+  <circle cx="24" cy="24" r="20" fill="#A50034"/>
+  <text x="24" y="30" text-anchor="middle" font-family="Segoe UI, Arial, sans-serif" font-size="18" font-weight="700" fill="#fff">LG</text>
+  <text x="56" y="32" font-family="Segoe UI, Arial, sans-serif" font-size="24" font-weight="600" fill="#555">webOS</text>
+</svg>

package/templates/cms-starter/public/assets/player-download/samsung.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 40" role="img" aria-label="Samsung">
+  <text x="0" y="30" font-family="Segoe UI, Arial, sans-serif" font-size="26" font-weight="700" letter-spacing="0.12em" fill="#1428A0">SAMSUNG</text>
+</svg>

package/templates/cms-starter/public/assets/player-download/toolbox.svg

@@ -0,0 +1,12 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 120 96" role="img" aria-hidden="true">
+  <rect x="8" y="36" width="104" height="48" rx="6" fill="#f4f3f0" stroke="#8a8782" stroke-width="2"/>
+  <rect x="8" y="28" width="104" height="12" rx="4" fill="#e4e1dc" stroke="#8a8782" stroke-width="2"/>
+  <rect x="48" y="18" width="24" height="14" rx="3" fill="none" stroke="#8a8782" stroke-width="2"/>
+  <rect x="20" y="52" width="18" height="14" rx="2" fill="#fff" stroke="#c9c5bf" stroke-width="1.5"/>
+  <rect x="51" y="52" width="18" height="14" rx="2" fill="#fff" stroke="#c9c5bf" stroke-width="1.5"/>
+  <rect x="82" y="52" width="18" height="14" rx="2" fill="#fff" stroke="#c9c5bf" stroke-width="1.5"/>
+  <path d="M62 8 L78 28 L46 28 Z" fill="#ff8a3d" stroke="#e67320" stroke-width="1.5" stroke-linejoin="round"/>
+  <rect x="58" y="28" width="8" height="18" fill="#6e6b67"/>
+  <path d="M88 12 L96 20 L92 24 L84 16 Z" fill="#6e6b67"/>
+  <rect x="84" y="20" width="14" height="4" rx="1" transform="rotate(-45 91 22)" fill="#8a8782"/>
+</svg>

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

@@ -172,6 +172,58 @@
       </div>
     </div>
 
+    <button type="button" id="downloadPlayersBtn" class="download-players-trigger">
+      Download Players
+    </button>
+
+    <div id="downloadPlayersModal" class="modal hidden" role="dialog" aria-modal="true" aria-labelledby="downloadPlayersModalTitle">
+      <div class="modal-backdrop" data-close-download-players-modal="1"></div>
+      <div class="modal-card download-players-modal-card">
+        <h2 id="downloadPlayersModalTitle" class="visually-hidden">Download Players</h2>
+        <div class="player-platform-grid">
+          <div class="player-platform-cell">
+            <a
+              href="#download-brightsign"
+              class="player-platform-link"
+              data-player-download="brightsign"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              <img src="./assets/player-download/brightsign.svg" alt="BrightSign" class="player-platform-logo player-platform-logo--wide" />
+            </a>
+            <p class="player-platform-caption">Supported Series 5 / 6</p>
+          </div>
+          <div class="player-platform-cell player-platform-cell--align-end">
+            <a
+              href="#download-samsung"
+              class="player-platform-link"
+              data-player-download="samsung"
+              target="_blank"
+              rel="noopener noreferrer"
+            >
+              <img src="./assets/player-download/samsung.svg" alt="Samsung" class="player-platform-logo player-platform-logo--wide" />
+            </a>
+            <p class="player-platform-caption">Supported Tizen 6.5+</p>
+          </div>
+          <div class="player-platform-cell">
+            <img src="./assets/player-download/android.svg" alt="Android" class="player-platform-logo player-platform-logo--icon" />
+            <p class="player-platform-caption player-platform-caption--muted">Launching Q4 2026</p>
+          </div>
+          <div class="player-platform-cell player-platform-cell--align-end">
+            <img src="./assets/player-download/lg-webos.svg" alt="LG webOS" class="player-platform-logo player-platform-logo--wide" />
+            <p class="player-platform-caption player-platform-caption--muted">Launching Q4 2026</p>
+          </div>
+        </div>
+        <div class="player-platform-diy">
+          <img src="./assets/player-download/toolbox.svg" alt="" class="player-platform-toolbox" />
+          <p class="player-platform-caption">Build your own player support</p>
+        </div>
+        <div class="modal-actions download-players-modal-actions">
+          <button type="button" data-close-download-players-modal="1">Close</button>
+        </div>
+      </div>
+    </div>
+
     <script src="./methods.js" defer></script>
   </body>
 </html>

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

@@ -1767,6 +1767,20 @@ function closeDownloadFailedModal() {
   document.getElementById("downloadFailedModal")?.classList.add("hidden");
 }
 
+function openDownloadPlayersModal() {
+  document.getElementById("downloadPlayersModal")?.classList.remove("hidden");
+}
+
+function closeDownloadPlayersModal() {
+  document.getElementById("downloadPlayersModal")?.classList.add("hidden");
+}
+
+function handlePlayerDownloadLinkClick(ev) {
+  ev.preventDefault();
+  const platform = ev.currentTarget?.dataset?.playerDownload || "unknown";
+  console.info(`[CMS] Player download link placeholder (${platform}) — URL not configured yet.`);
+}
+
 function sanitizeDownloadFilename(name) {
   const base = String(name || "asset").trim() || "asset";
   return base.replace(/[<>:"/\\|?*\x00-\x1f]/g, "_");
@@ -1850,6 +1864,14 @@ document.addEventListener("DOMContentLoaded", () => {
     el.addEventListener("click", closeDownloadFailedModal);
   });
 
+  document.getElementById("downloadPlayersBtn")?.addEventListener("click", openDownloadPlayersModal);
+  document.querySelectorAll("[data-close-download-players-modal]").forEach((el) => {
+    el.addEventListener("click", closeDownloadPlayersModal);
+  });
+  document.querySelectorAll("[data-player-download]").forEach((el) => {
+    el.addEventListener("click", handlePlayerDownloadLinkClick);
+  });
+
   document.getElementById("addAssetBtn")?.addEventListener("click", () => {
     if (uploadInProgress) return;
     if (!isPlaylistEditorOpen()) {

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

@@ -716,3 +716,127 @@ button.danger {
   gap: 0.5rem;
   margin-top: 1rem;
 }
+
+.visually-hidden {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
+}
+
+.download-players-trigger {
+  position: fixed;
+  left: 1rem;
+  bottom: 1rem;
+  z-index: 900;
+  font: inherit;
+  font-size: 0.85rem;
+  font-weight: 600;
+  padding: 0.55rem 0.95rem;
+  border-radius: 8px;
+  border: 1px solid #d6d2cb;
+  background: #fff;
+  color: #0a0908;
+  cursor: pointer;
+  box-shadow: 0 4px 16px rgba(0, 0, 0, 0.08);
+}
+
+.download-players-trigger:hover {
+  background: #f5f3ef;
+}
+
+.download-players-modal-card {
+  width: min(92vw, 560px);
+  padding: 1.5rem 1.75rem 1.25rem;
+}
+
+.player-platform-grid {
+  display: grid;
+  grid-template-columns: 1fr 1fr;
+  gap: 1.75rem 2rem;
+  align-items: start;
+}
+
+.player-platform-cell {
+  display: flex;
+  flex-direction: column;
+  gap: 0.45rem;
+  min-height: 5.5rem;
+}
+
+.player-platform-cell--align-end {
+  align-items: flex-end;
+  text-align: right;
+}
+
+.player-platform-link {
+  display: inline-flex;
+  align-items: center;
+  text-decoration: none;
+  border-radius: 6px;
+  transition: opacity 120ms ease, transform 120ms ease;
+}
+
+.player-platform-link:hover {
+  opacity: 0.82;
+  transform: translateY(-1px);
+}
+
+.player-platform-link:focus-visible {
+  outline: 2px solid #ff8a3d;
+  outline-offset: 3px;
+}
+
+.player-platform-logo {
+  display: block;
+  object-fit: contain;
+}
+
+.player-platform-logo--wide {
+  height: 2.25rem;
+  width: auto;
+  max-width: 100%;
+}
+
+.player-platform-logo--icon {
+  height: 2.75rem;
+  width: 2.75rem;
+}
+
+.player-platform-caption {
+  margin: 0;
+  font-size: 0.78rem;
+  line-height: 1.35;
+  color: #444;
+}
+
+.player-platform-caption--muted {
+  color: #888;
+}
+
+.player-platform-diy {
+  margin-top: 1.35rem;
+  padding-top: 1.35rem;
+  border-top: 1px solid #e4e1dc;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 0.55rem;
+  text-align: center;
+}
+
+.player-platform-toolbox {
+  width: 5.5rem;
+  height: auto;
+  display: block;
+}
+
+.download-players-modal-actions {
+  justify-content: center;
+  margin-top: 1.15rem;
+}