@tomorrowos/sdk 0.4.1 → 0.4.2

package/dist/tomorrowos.d.ts

@@ -52,6 +52,15 @@ export interface DeviceListItem {
         version: number;
         publishedAt: string;
     }>;
+    latestErrorAt: string | null;
+    latestErrorMessage: string | null;
+}
+export interface DeviceLogEntry {
+    timestamp: string;
+    level: "info" | "warn" | "error";
+    message: string;
+    source?: string;
+    details?: unknown;
 }
 export declare class TomorrowOS extends EventEmitter {
     readonly brand: TomorrowOSBrand;
@@ -59,6 +68,7 @@ export declare class TomorrowOS extends EventEmitter {
     readonly playlists: PlaylistCatalog;
     private readonly devices;
     private readonly pendingDeviceMeta;
+    private readonly deviceLogs;
     private httpServer;
     private wss;
     private staticRoot;
@@ -90,6 +100,8 @@ export declare class TomorrowOS extends EventEmitter {
     };
     /** List paired devices with live connection + timing fields for the CMS panel. */
     listDevices(): Promise<DeviceListItem[]>;
+    private pushDeviceLog;
+    private getDeviceLogs;
     private isDeviceConnected;
     private captureHelloMeta;
     private getOrCreatePermanentPairingCode;

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

@@ -132,6 +132,7 @@ export class TomorrowOS extends EventEmitter {
     playlists;
     devices = new Map();
     pendingDeviceMeta = new Map();
+    deviceLogs = new Map();
     httpServer = null;
     wss = null;
     staticRoot = null;
@@ -267,6 +268,8 @@ export class TomorrowOS extends EventEmitter {
                 }
             }
             const screenOnlineSince = connected && record.lastBootAt ? record.lastBootAt : null;
+            const logs = this.deviceLogs.get(deviceId) ?? [];
+            const latestError = [...logs].reverse().find((entry) => entry.level === "error");
             return {
                 deviceId,
                 pairingCode: reg?.permanentPairingCode ?? null,
@@ -288,10 +291,28 @@ export class TomorrowOS extends EventEmitter {
                 lastPolicyPushAt: record.lastPolicyPushAt ?? null,
                 screenOnlineActive,
                 screenOnlineLabel,
-                screenOnlineSince
+                screenOnlineSince,
+                latestErrorAt: latestError?.timestamp ?? null,
+                latestErrorMessage: latestError?.message ?? null
             };
         }));
     }
+    pushDeviceLog(deviceId, entry) {
+        const key = String(deviceId || "").trim();
+        if (!key)
+            return;
+        const existing = this.deviceLogs.get(key) ?? [];
+        existing.push(entry);
+        if (existing.length > 80)
+            existing.splice(0, existing.length - 80);
+        this.deviceLogs.set(key, existing);
+    }
+    getDeviceLogs(deviceId) {
+        const key = String(deviceId || "").trim();
+        if (!key)
+            return [];
+        return [...(this.deviceLogs.get(key) ?? [])].reverse();
+    }
     isDeviceConnected(deviceId) {
         const ws = this.devices.get(deviceId);
         return !!ws && ws.readyState === WebSocket.OPEN;
@@ -710,6 +731,12 @@ export class TomorrowOS extends EventEmitter {
                 sendJson(res, 200, { status: "success", assignments });
                 return;
             }
+            const deviceLogsGet = /^\/device\/([^/]+)\/logs$/.exec(pathname);
+            if (req.method === "GET" && deviceLogsGet) {
+                const deviceId = decodeURIComponent(deviceLogsGet[1]);
+                sendJson(res, 200, { status: "success", logs: this.getDeviceLogs(deviceId) });
+                return;
+            }
             if (req.method === "DELETE" && deviceAssignmentsGet) {
                 const deviceId = decodeURIComponent(deviceAssignmentsGet[1]);
                 try {
@@ -971,6 +998,26 @@ export class TomorrowOS extends EventEmitter {
                         console.error("[TomorrowOS] pushLatestPolicy on resume failed:", err);
                     });
                 })();
+                return;
+            }
+            if (type === "device.log") {
+                const deviceId = ws.deviceId;
+                if (!deviceId)
+                    return;
+                const rawLevel = String(msg.level ?? "info").toLowerCase();
+                const level = rawLevel === "error" || rawLevel === "warn" ? rawLevel : "info";
+                const message = String(msg.message ?? "").trim();
+                if (!message)
+                    return;
+                const source = typeof msg.source === "string" ? msg.source : undefined;
+                const details = msg.details;
+                const timestamp = typeof msg.timestamp === "string" && msg.timestamp.trim()
+                    ? msg.timestamp
+                    : new Date().toISOString();
+                this.pushDeviceLog(deviceId, { timestamp, level, message, source, details });
+                if (level === "error") {
+                    console.error(`[TomorrowOS][device-log][${deviceId}] ${message}`);
+                }
             }
         });
         ws.on("close", () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "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.4.1",
+  "version": "0.4.2",
   "description": "CMS server on @tomorrowos/sdk. Add your UI (React, static files, etc.) alongside this server.",
   "private": true,
   "type": "module",
@@ -10,7 +10,7 @@
     "build-player": "tomorrowos build --platform tizen"
   },
   "dependencies": {
-    "@tomorrowos/sdk": "^0.4.1"
+    "@tomorrowos/sdk": "^0.4.2"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

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

@@ -657,7 +657,9 @@ function renderDeviceCards() {
       ["System", device.system || device.platform || "—"],
       ["Device online", formatDeviceOnlineLabel(device)],
       ["Last boot", formatDateTimeSeconds(device.lastBootAt)],
-      ["Latest push", formatDateTimeSeconds(device.lastPolicyPushAt)]
+      ["Latest push", formatDateTimeSeconds(device.lastPolicyPushAt)],
+      ["Latest error", device.latestErrorMessage || "—"],
+      ["Error at", formatDateTimeSeconds(device.latestErrorAt)]
     ];
     for (const [label, value] of rows) {
       const row = document.createElement("div");
@@ -702,6 +704,11 @@ function renderDeviceCards() {
     clearBtn.textContent = "Clear";
     clearBtn.addEventListener("click", () => deviceAction(device.deviceId, "content/clear"));
 
+    const logsBtn = document.createElement("button");
+    logsBtn.type = "button";
+    logsBtn.textContent = "Logs";
+    logsBtn.addEventListener("click", () => viewDeviceLogs(device.deviceId));
+
     const unpairBtn = document.createElement("button");
     unpairBtn.type = "button";
     unpairBtn.className = "danger";
@@ -713,6 +720,7 @@ function renderDeviceCards() {
     actions.appendChild(capBtn);
     actions.appendChild(rebootBtn);
     actions.appendChild(clearBtn);
+    actions.appendChild(logsBtn);
     actions.appendChild(unpairBtn);
 
     card.appendChild(header);
@@ -933,6 +941,17 @@ async function deviceAction(deviceId, action) {
   if (action === "reboot" || action === "content/clear") await fetchDevices();
 }
 
+async function viewDeviceLogs(deviceId) {
+  if (!deviceId) return;
+  const res = await fetch(`/device/${encodeURIComponent(deviceId)}/logs`);
+  const data = await res.json();
+  showResult({ deviceId, logs: data.logs || [] });
+  if (!res.ok) {
+    alert(data.error || "Failed to load logs");
+    return;
+  }
+}
+
 function startDevicePolling() {
   if (devicePollTimer) clearInterval(devicePollTimer);
   void fetchDevices();