@tomorrowos/sdk 0.9.10 → 0.9.11

package/REPLIT_SETUP.md

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

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export { TomorrowOS } from "./tomorrowos.js";
 export type { DeviceListItem, DeviceScreenshotInfo, ListenOptions, TomorrowOSBrand, TomorrowOSOptions } from "./tomorrowos.js";
 export type { ConnectorState, ConnectorStatus, ServerStatusReport, StatusBlocker } from "./server-status.js";
 export { buildServerStatus } from "./server-status.js";
+export { getSdkPackageVersion } from "./sdk-version.js";
 export type { DevicePlaylistAssignment, DeviceRegistryRecord, PairedDeviceRecord, PendingCodeEntry, PendingCodeRecord, DeviceRegistryEntry, PlaylistItemRecord, PlaylistSchedule, PublishedPlaylistSnapshot, StoredPlaylist, TomorrowOSDataSnapshot, TomorrowOSMigratableStore, TomorrowOSStore } from "./store/types.js";
 export { PlaylistCatalog } from "./playlist-catalog.js";
 export type { BuiltDevicePolicy, SavePlaylistInput } from "./playlist-catalog.js";

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,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,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,oBAAoB,EACpB,aAAa,EACb,eAAe,EACf,iBAAiB,EAClB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,yBAAyB,EACzB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,YAAY,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,4BAA4B,EAC5B,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { TomorrowOS } from "./tomorrowos.js";
 export { buildServerStatus } from "./server-status.js";
+export { getSdkPackageVersion } from "./sdk-version.js";
 export { PlaylistCatalog } from "./playlist-catalog.js";
 export { DEFAULT_PAIRING_CODE_SECRET, generateDeterministicPairingCode, generateRandomPairingCode, isValidPairingCodeFormat, normalizePairingCode, PAIRING_CODE_ALPHABET, PAIRING_CODE_LENGTH, resolvePairingCodeSecret } from "./pairing-code.js";
 export { MemoryStore } from "./store/memory-store.js";

package/dist/sdk-version.d.ts

@@ -0,0 +1,3 @@
+/** Installed `@tomorrowos/sdk` package version (from this package's package.json). */
+export declare function getSdkPackageVersion(): string;
+//# sourceMappingURL=sdk-version.d.ts.map

package/dist/sdk-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-version.d.ts","sourceRoot":"","sources":["../src/sdk-version.ts"],"names":[],"mappings":"AAIA,sFAAsF;AACtF,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C"}

package/dist/sdk-version.js

@@ -0,0 +1,15 @@
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+/** Installed `@tomorrowos/sdk` package version (from this package's package.json). */
+export function getSdkPackageVersion() {
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        const pkgPath = path.join(here, "..", "package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+        return String(pkg.version || "").trim() || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}

package/dist/server-status.d.ts

@@ -17,6 +17,8 @@ export interface ServerStatusReport {
     status: "success";
     overall: "ok" | "degraded" | "blocked";
     checkedAt: string;
+    /** Installed `@tomorrowos/sdk` version. */
+    sdkVersion: string;
     connectors: ConnectorStatus[];
     blockers: StatusBlocker[];
 }

package/dist/server-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-status.d.ts","sourceRoot":"","sources":["../src/server-status.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoSD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}
+{"version":3,"file":"server-status.d.ts","sourceRoot":"","sources":["../src/server-status.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,eAAe,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAoSD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CA6B7B"}

package/dist/server-status.js

@@ -1,6 +1,7 @@
 import fs from "fs/promises";
 import path from "path";
 import { pingCloudinary, resolveCloudinaryConfig } from "./cloudinary-storage.js";
+import { getSdkPackageVersion } from "./sdk-version.js";
 function isReplitHost(env) {
     return !!(env.REPL_ID ||
         env.REPLIT_DEV_DOMAIN ||
@@ -259,6 +260,7 @@ export async function buildServerStatus(options) {
         status: "success",
         overall,
         checkedAt: new Date().toISOString(),
+        sdkVersion: getSdkPackageVersion(),
         connectors,
         blockers
     };

package/package.json

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

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

@@ -23,6 +23,9 @@
           <button type="button" id="downloadPlayersBtn" class="download-players-trigger">
             Download Players
           </button>
+          <button type="button" id="updateSdkBtn" class="download-players-trigger">
+            Update SDK
+          </button>
         </div>
       </aside>
 
@@ -194,6 +197,23 @@
       </div>
     </div>
 
+    <div id="updateSdkModal" class="modal hidden" role="dialog" aria-modal="true" aria-labelledby="updateSdkModalTitle">
+      <div class="modal-backdrop" data-close-update-sdk-modal="1"></div>
+      <div class="modal-card update-sdk-modal-card">
+        <h2 id="updateSdkModalTitle">Update SDK</h2>
+        <p class="hint">Current installed SDK version:</p>
+        <p class="update-sdk-version" id="updateSdkVersionLabel">Loading…</p>
+        <p class="hint">
+          To upgrade on Replit (or another Agent platform), paste this prompt into the Agent chat:
+        </p>
+        <pre class="update-sdk-prompt" id="updateSdkPromptText">Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.</pre>
+        <div class="modal-actions update-sdk-modal-actions">
+          <button type="button" id="copyUpdateSdkPromptBtn" class="primary">Copy prompt</button>
+          <button type="button" data-close-update-sdk-modal="1">Close</button>
+        </div>
+      </div>
+    </div>
+
     <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">

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

@@ -28,8 +28,13 @@ let editingDeviceNameValue = "";
 
 let devicePollTimer = null;
 let serverStatusTimer = null;
+/** @type {string} Latest known `@tomorrowos/sdk` version from GET /status. */
+let cachedSdkVersion = "";
 /** @type {number|null} CMS server boot time (ms) from GET /devices. */
 let serverStartedAtMs = null;
+
+const UPDATE_SDK_PROMPT =
+  "Follow @tomorrowos/sdk REPLIT_UPGRADE.md to upgrade my CMS with the latest SDK.";
 /** @type {ReturnType<typeof setTimeout>|null} */
 let reconnectGraceTimer = null;
 let uploadQueue = [];
@@ -1804,6 +1809,48 @@ function closeDownloadPlayersModal() {
   document.getElementById("downloadPlayersModal")?.classList.add("hidden");
 }
 
+function setUpdateSdkVersionLabel(version) {
+  const label = document.getElementById("updateSdkVersionLabel");
+  if (!label) return;
+  label.textContent = version || "unknown";
+}
+
+async function openUpdateSdkModal() {
+  const modal = document.getElementById("updateSdkModal");
+  const promptEl = document.getElementById("updateSdkPromptText");
+  if (promptEl) promptEl.textContent = UPDATE_SDK_PROMPT;
+  setUpdateSdkVersionLabel(cachedSdkVersion || "Loading…");
+  modal?.classList.remove("hidden");
+
+  if (!cachedSdkVersion) {
+    await fetchServerStatus();
+    setUpdateSdkVersionLabel(cachedSdkVersion || "unknown");
+  }
+}
+
+function closeUpdateSdkModal() {
+  document.getElementById("updateSdkModal")?.classList.add("hidden");
+}
+
+async function copyUpdateSdkPrompt() {
+  const text =
+    document.getElementById("updateSdkPromptText")?.textContent?.trim() ||
+    UPDATE_SDK_PROMPT;
+  try {
+    await navigator.clipboard.writeText(text);
+    const btn = document.getElementById("copyUpdateSdkPromptBtn");
+    if (btn) {
+      const prev = btn.textContent;
+      btn.textContent = "Copied";
+      setTimeout(() => {
+        btn.textContent = prev || "Copy prompt";
+      }, 1200);
+    }
+  } catch {
+    alert("Could not copy automatically. Select the prompt text and copy it manually.");
+  }
+}
+
 function handlePlayerDownloadLinkClick(ev) {
   ev.preventDefault();
   const platform = ev.currentTarget?.dataset?.playerDownload || "unknown";
@@ -1985,6 +2032,9 @@ async function fetchServerStatus() {
       });
       return;
     }
+    if (typeof data.sdkVersion === "string" && data.sdkVersion.trim()) {
+      cachedSdkVersion = data.sdkVersion.trim();
+    }
     renderServerStatus(data);
   } catch (err) {
     renderServerStatus({
@@ -2063,6 +2113,14 @@ document.addEventListener("DOMContentLoaded", () => {
     el.addEventListener("click", handlePlayerDownloadLinkClick);
   });
 
+  document.getElementById("updateSdkBtn")?.addEventListener("click", () => void openUpdateSdkModal());
+  document.querySelectorAll("[data-close-update-sdk-modal]").forEach((el) => {
+    el.addEventListener("click", closeUpdateSdkModal);
+  });
+  document
+    .getElementById("copyUpdateSdkPromptBtn")
+    ?.addEventListener("click", () => void copyUpdateSdkPrompt());
+
   document.getElementById("addAssetBtn")?.addEventListener("click", () => {
     if (uploadInProgress) return;
     if (!isPlaylistEditorOpen()) {

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

@@ -908,7 +908,9 @@ button.danger {
 .download-players-nav-slot {
   margin-top: auto;
   display: flex;
-  justify-content: center;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 0.45rem;
   padding-top: 0.75rem;
 }
 
@@ -922,12 +924,43 @@ button.danger {
   background: #fff;
   color: #0a0908;
   cursor: pointer;
+  width: 100%;
+  text-align: center;
 }
 
 .download-players-trigger:hover {
   background: #f5f3ef;
 }
 
+.update-sdk-modal-card {
+  width: min(92vw, 480px);
+}
+
+.update-sdk-version {
+  margin: 0 0 1rem;
+  font-size: 1.35rem;
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  color: #0a0908;
+}
+
+.update-sdk-prompt {
+  margin: 0;
+  padding: 0.75rem 0.85rem;
+  border: 1px solid #e4e1dc;
+  border-radius: 8px;
+  background: #fafaf9;
+  font-size: 0.8rem;
+  line-height: 1.45;
+  white-space: pre-wrap;
+  word-break: break-word;
+  color: #0a0908;
+}
+
+.update-sdk-modal-actions {
+  justify-content: flex-end;
+}
+
 .download-players-modal-card {
   width: min(92vw, 560px);
   padding: 1.5rem 1.75rem 1.25rem;