@tomorrowos/sdk 0.3.1 → 0.3.3

package/dist/cli.js

@@ -11,6 +11,27 @@ function getSdkVersion() {
     const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
     return pkg.version ?? "0.0.0";
 }
+const STARTER_SKIP_DIRS = new Set(["node_modules"]);
+/** Never ship local install artifacts into a new CMS project. */
+function shouldCopyStarterEntry(starterRoot, source) {
+    const rel = path.relative(starterRoot, source);
+    if (!rel)
+        return true;
+    const parts = rel.split(path.sep).filter(Boolean);
+    if (parts.some((p) => STARTER_SKIP_DIRS.has(p)))
+        return false;
+    if (path.basename(source) === "package-lock.json")
+        return false;
+    return true;
+}
+function removeStarterArtifacts(destDir) {
+    const lockPath = path.join(destDir, "package-lock.json");
+    const modulesPath = path.join(destDir, "node_modules");
+    if (fs.existsSync(lockPath))
+        fs.rmSync(lockPath, { force: true });
+    if (fs.existsSync(modulesPath))
+        fs.rmSync(modulesPath, { recursive: true, force: true });
+}
 /** Align generated cms-starter package.json with the installed SDK version. */
 function patchStarterPackageJson(destDir) {
     const pkgPath = path.join(path.resolve(destDir), "package.json");
@@ -41,12 +62,16 @@ function copyStarter(destDir, force) {
     else {
         fs.mkdirSync(resolved, { recursive: true });
     }
-    fs.cpSync(src, resolved, { recursive: true });
+    fs.cpSync(src, resolved, {
+        recursive: true,
+        filter: (source) => shouldCopyStarterEntry(src, source),
+    });
     patchStarterPackageJson(resolved);
+    removeStarterArtifacts(resolved);
     const sdkVer = getSdkVersion();
     console.log(`[tomorrowos] Created CMS project at ${resolved}`);
     console.log(`[tomorrowos] @tomorrowos/sdk dependency: ^${sdkVer}`);
-    console.log("Next: cd there, run npm install, then npm run dev");
+    console.log("Next: cd there, run npm install, then npm start");
 }
 function cmdBuild(argv) {
     const platformIdx = argv.indexOf("--platform");

package/dist/playlist-catalog.d.ts

@@ -13,8 +13,15 @@ export interface BuiltDevicePolicy {
         };
         revision?: number;
         syncMode?: "latest" | "snapshot";
+        /** One-shot: player may start outside schedule right after publish. */
+        playNow?: boolean;
     };
 }
+export interface PolicyBuildOptions {
+    useLatest?: boolean;
+    playNow?: boolean;
+    mediaBaseUrl?: string;
+}
 export declare class PlaylistCatalog {
     private readonly store;
     constructor(store: TomorrowOSStore);
@@ -24,11 +31,9 @@ export declare class PlaylistCatalog {
     savePlaylist(input: SavePlaylistInput): Promise<StoredPlaylist>;
     retirePlaylist(id: string): Promise<StoredPlaylist>;
     getDeviceAssignments(deviceId: string): Promise<DevicePlaylistAssignment[]>;
-    publishPlaylistsToDevice(deviceId: string, playlistIds: string[]): Promise<BuiltDevicePolicy>;
+    publishPlaylistsToDevice(deviceId: string, playlistIds: string[], options?: PolicyBuildOptions): Promise<BuiltDevicePolicy>;
     removePlaylistFromDevice(deviceId: string, playlistId: string): Promise<BuiltDevicePolicy>;
-    buildPolicyForDevice(deviceId: string, options?: {
-        useLatest?: boolean;
-    }): Promise<BuiltDevicePolicy>;
+    buildPolicyForDevice(deviceId: string, options?: PolicyBuildOptions): Promise<BuiltDevicePolicy>;
     private buildPolicyFromAssignments;
     canPublishPlaylistToNewDevice(playlistId: string): Promise<boolean>;
 }

package/dist/playlist-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,EAAE;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;KAClC,CAAC;CACH;AAYD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgC/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,iBAAiB,CAAC;IA8BvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAOvB,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAO,GACpC,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IA+BxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}
+{"version":3,"file":"playlist-catalog.d.ts","sourceRoot":"","sources":["../src/playlist-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,cAAc,EACd,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,kBAAkB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE;QACN,SAAS,EAAE,yBAAyB,EAAE,CAAC;QACvC,QAAQ,EAAE;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAC;QAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;QACjC,uEAAuE;QACvE,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+CD,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAK1C,6BAA6B,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI1D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC;IAI5D,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,cAAc,CAAC;IAgC/D,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAcnD,oBAAoB,CACxB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAIhC,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAkCvB,wBAAwB,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAOvB,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;YAKf,0BAA0B;IAmCxC,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGpE"}

package/dist/playlist-catalog.js

@@ -1,11 +1,44 @@
 import { randomUUID } from "crypto";
-function cloneSnapshot(playlist) {
+function normalizeMediaBaseUrl(raw) {
+    let s = String(raw || "").trim();
+    if (!s)
+        return "";
+    if (!/^https?:\/\//i.test(s))
+        s = `http://${s}`;
+    try {
+        return new URL(s).origin;
+    }
+    catch {
+        return "";
+    }
+}
+function absolutizeMediaUrl(url, mediaBaseUrl) {
+    const trimmed = String(url || "").trim();
+    if (!trimmed)
+        return trimmed;
+    if (/^https?:\/\//i.test(trimmed))
+        return trimmed;
+    const base = normalizeMediaBaseUrl(mediaBaseUrl);
+    if (!base)
+        return trimmed;
+    return `${base}${trimmed.startsWith("/") ? trimmed : `/${trimmed}`}`;
+}
+function absolutizePlaylistItems(items, mediaBaseUrl) {
+    const base = normalizeMediaBaseUrl(mediaBaseUrl);
+    if (!base)
+        return items.map((item) => ({ ...item }));
+    return items.map((item) => ({
+        ...item,
+        url: absolutizeMediaUrl(item.url, base)
+    }));
+}
+function cloneSnapshot(playlist, mediaBaseUrl) {
     return {
         id: playlist.id,
         name: playlist.name,
         version: playlist.version,
         schedule: playlist.schedule ? { ...playlist.schedule } : undefined,
-        items: playlist.items.map((item) => ({ ...item }))
+        items: absolutizePlaylistItems(playlist.items, mediaBaseUrl)
     };
 }
 export class PlaylistCatalog {
@@ -67,7 +100,7 @@ export class PlaylistCatalog {
     async getDeviceAssignments(deviceId) {
         return this.store.getDeviceAssignments(deviceId);
     }
-    async publishPlaylistsToDevice(deviceId, playlistIds) {
+    async publishPlaylistsToDevice(deviceId, playlistIds, options = {}) {
         const ids = [...new Set(playlistIds.map((x) => String(x).trim()).filter(Boolean))];
         if (ids.length === 0) {
             throw Object.assign(new Error("Select at least one playlist"), {
@@ -86,11 +119,15 @@ export class PlaylistCatalog {
                 playlistId,
                 publishedVersion: playlist.version,
                 publishedAt: new Date().toISOString(),
-                snapshot: cloneSnapshot(playlist)
+                snapshot: cloneSnapshot(playlist, options.mediaBaseUrl)
             });
         }
         await this.store.setDeviceAssignments(deviceId, assignments);
-        return this.buildPolicyFromAssignments(assignments, { useLatest: false });
+        return this.buildPolicyFromAssignments(assignments, {
+            useLatest: false,
+            playNow: true,
+            mediaBaseUrl: options.mediaBaseUrl
+        });
     }
     async removePlaylistFromDevice(deviceId, playlistId) {
         const assignments = await this.store.getDeviceAssignments(deviceId);
@@ -104,28 +141,31 @@ export class PlaylistCatalog {
     }
     async buildPolicyFromAssignments(assignments, options) {
         const useLatest = options.useLatest === true;
+        const mediaBaseUrl = options.mediaBaseUrl;
         const playlists = [];
         for (const assignment of assignments) {
             if (useLatest) {
                 const current = await this.store.getPlaylist(assignment.playlistId);
                 if (current && !current.retired) {
-                    playlists.push(cloneSnapshot(current));
+                    playlists.push(cloneSnapshot(current, mediaBaseUrl));
                     continue;
                 }
             }
             playlists.push({
                 ...assignment.snapshot,
-                items: assignment.snapshot.items.map((item) => ({ ...item }))
+                items: absolutizePlaylistItems(assignment.snapshot.items, mediaBaseUrl)
             });
         }
-        return {
-            policy: {
-                playlists,
-                fallback: { type: "brand" },
-                revision: Date.now(),
-                syncMode: useLatest ? "latest" : "snapshot"
-            }
+        const policy = {
+            playlists,
+            fallback: { type: "brand" },
+            revision: Date.now(),
+            syncMode: useLatest ? "latest" : "snapshot"
         };
+        if (options.playNow === true) {
+            policy.playNow = true;
+        }
+        return { policy };
     }
     canPublishPlaylistToNewDevice(playlistId) {
         return this.store.getPlaylist(playlistId).then((p) => !!p && !p?.retired);

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

@@ -639,14 +639,18 @@ export class TomorrowOS extends EventEmitter {
                 }
                 try {
                     let built;
+                    const mediaBaseUrl = typeof body.mediaBaseUrl === "string" ? body.mediaBaseUrl : undefined;
                     if (body.useLatest === true) {
                         built = await this.playlists.buildPolicyForDevice(deviceId, {
-                            useLatest: true
+                            useLatest: true,
+                            mediaBaseUrl
                         });
                     }
                     else {
                         const ids = Array.isArray(body.playlistIds) ? body.playlistIds : [];
-                        built = await this.playlists.publishPlaylistsToDevice(deviceId, ids);
+                        built = await this.playlists.publishPlaylistsToDevice(deviceId, ids, {
+                            mediaBaseUrl
+                        });
                     }
                     const result = await this.sendDeviceCommand(deviceId, "device.content.setPolicy", {
                         policy: built.policy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tomorrowos/sdk",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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.3.1",
+  "version": "0.3.3",
   "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": "file:../.."
+    "@tomorrowos/sdk": "^0.3.3"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",

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

@@ -41,7 +41,8 @@
         <section class="card" id="cmsUrlSection">
           <h2>CMS URL for screens</h2>
           <p class="hint">
-            <strong>Local development only.</strong> LAN URL for TVs (not localhost).
+            <strong>Local development only.</strong> Optional LAN override so TVs reach your PC (not localhost).
+            Hosted CMS (e.g. Replit) uses its public URL automatically — leave this empty there.
           </p>
           <div class="row">
             <input

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

@@ -79,15 +79,44 @@ function normalizeMediaBaseUrl(raw) {
   }
 }
 
+/** User-saved LAN override (local dev only). Not used on hosted CMS unless explicitly set. */
+function getExplicitLanMediaBase() {
+  return normalizeMediaBaseUrl(localStorage.getItem(PANEL_MEDIA_BASE_KEY) || "");
+}
+
+function playlistHasRelativeMediaUrls(playlist) {
+  return (playlist?.items || []).some((item) => {
+    const url = String(item?.url || "").trim();
+    return url && !/^https?:\/\//i.test(url);
+  });
+}
+
+/**
+ * Base URL sent on publish only when needed.
+ * - Hosted (e.g. Replit): use public origin only if items are still relative (/uploads/...).
+ * - Local: use saved LAN override only when set; never default to rewriting otherwise.
+ * - Returns null to omit mediaBaseUrl (playlist already has absolute https URLs).
+ */
+function getPublishMediaBaseUrl(selectedPlaylists) {
+  const explicitLan = getExplicitLanMediaBase();
+  if (explicitLan) return explicitLan;
+
+  const needsRewrite = selectedPlaylists.some(playlistHasRelativeMediaUrls);
+  if (!needsRewrite) return null;
+
+  if (!isLocalPanelHost(window.location.hostname)) {
+    return window.location.origin;
+  }
+  return "";
+}
+
+/** Resolve media URLs in the editor (save / thumbnails). */
 function getMediaBaseOrigin() {
-  const fromInput = normalizeMediaBaseUrl(
-    document.getElementById("cmsDeviceBaseUrl")?.value ||
-      localStorage.getItem(PANEL_MEDIA_BASE_KEY) ||
-      ""
-  );
-  if (fromInput) return fromInput;
+  const explicitLan = getExplicitLanMediaBase();
+  if (explicitLan) return explicitLan;
   if (!isLocalPanelHost(window.location.hostname)) return window.location.origin;
-  return "";
+  const draft = normalizeMediaBaseUrl(document.getElementById("cmsDeviceBaseUrl")?.value);
+  return draft;
 }
 
 function saveCmsDeviceBaseUrl() {
@@ -188,7 +217,7 @@ async function fetchPlaylists() {
         showResult({
           status: "failed",
           error:
-            "CMS server is missing /playlists. Restart CMS with @tomorrowos/sdk 0.3.1 or newer."
+            "CMS server is missing /playlists. Restart CMS with @tomorrowos/sdk 0.3.3 or newer."
         });
       }
       return;
@@ -547,6 +576,13 @@ function renderDeviceCards() {
     infoBtn.textContent = "Info";
     infoBtn.addEventListener("click", () => deviceAction(device.deviceId, "get-info"));
 
+    const capBtn = document.createElement("button");
+    capBtn.type = "button";
+    capBtn.textContent = "Get capabilities";
+    capBtn.addEventListener("click", () =>
+      deviceAction(device.deviceId, "get-capabilities")
+    );
+
     const rebootBtn = document.createElement("button");
     rebootBtn.type = "button";
     rebootBtn.textContent = "Reboot";
@@ -565,6 +601,7 @@ function renderDeviceCards() {
 
     actions.appendChild(publishBtn);
     actions.appendChild(infoBtn);
+    actions.appendChild(capBtn);
     actions.appendChild(rebootBtn);
     actions.appendChild(clearBtn);
     actions.appendChild(unpairBtn);
@@ -624,12 +661,34 @@ async function confirmPublishModal() {
     return;
   }
 
+  const selectedPlaylists = ids
+    .map((id) => playlistsCatalog.find((p) => p.id === id))
+    .filter(Boolean);
+
+  for (const pl of selectedPlaylists) {
+    if (!(pl.items || []).length) {
+      alert(`Playlist "${pl.name || pl.id}" has no assets. Save the playlist first.`);
+      return;
+    }
+  }
+
+  const mediaBaseUrl = getPublishMediaBaseUrl(selectedPlaylists);
+  if (mediaBaseUrl === "") {
+    alert(
+      "Local CMS: save a LAN URL under “CMS URL for screens” (e.g. http://192.168.1.105:3000) so TVs can load /uploads paths. On Replit/hosted CMS this field is not required."
+    );
+    return;
+  }
+
+  const publishBody = { playlistIds: ids };
+  if (mediaBaseUrl) publishBody.mediaBaseUrl = mediaBaseUrl;
+
   const res = await fetch(
     `/device/${encodeURIComponent(publishModalDeviceId)}/assignments`,
     {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ playlistIds: ids })
+      body: JSON.stringify(publishBody)
     }
   );
   const data = await res.json();
@@ -743,12 +802,14 @@ function startDevicePolling() {
 }
 
 document.addEventListener("DOMContentLoaded", () => {
+  const cmsUrlSection = document.getElementById("cmsUrlSection");
+  if (cmsUrlSection && !isLocalPanelHost(window.location.hostname)) {
+    cmsUrlSection.classList.add("hidden");
+  }
+
   const savedMediaBase = localStorage.getItem(PANEL_MEDIA_BASE_KEY);
   const cmsBaseInput = document.getElementById("cmsDeviceBaseUrl");
   if (savedMediaBase && cmsBaseInput) cmsBaseInput.value = savedMediaBase;
-  else if (cmsBaseInput && !isLocalPanelHost(window.location.hostname)) {
-    cmsBaseInput.value = window.location.origin;
-  }
 
   void fetchPlaylists();
   startDevicePolling();

package/templates/cms-starter/node_modules/.bin/esbuild

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../esbuild/bin/esbuild" "$@"
-else 
-  exec node  "$basedir/../esbuild/bin/esbuild" "$@"
-fi

package/templates/cms-starter/node_modules/.bin/esbuild.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\esbuild\bin\esbuild" %*

package/templates/cms-starter/node_modules/.bin/esbuild.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  } else {
-    & "node$exe"  "$basedir/../esbuild/bin/esbuild" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/templates/cms-starter/node_modules/.bin/tomorrowos

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../@tomorrowos/sdk/dist/cli.js" "$@"
-else 
-  exec node  "$basedir/../@tomorrowos/sdk/dist/cli.js" "$@"
-fi

package/templates/cms-starter/node_modules/.bin/tomorrowos.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\@tomorrowos\sdk\dist\cli.js" %*

package/templates/cms-starter/node_modules/.bin/tomorrowos.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../@tomorrowos/sdk/dist/cli.js" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../@tomorrowos/sdk/dist/cli.js" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../@tomorrowos/sdk/dist/cli.js" $args
-  } else {
-    & "node$exe"  "$basedir/../@tomorrowos/sdk/dist/cli.js" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/templates/cms-starter/node_modules/.bin/tsc

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsc" "$@"
-else 
-  exec node  "$basedir/../typescript/bin/tsc" "$@"
-fi

package/templates/cms-starter/node_modules/.bin/tsc.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\typescript\bin\tsc" %*

package/templates/cms-starter/node_modules/.bin/tsc.ps1

@@ -1,28 +0,0 @@
-#!/usr/bin/env pwsh
-$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent
-
-$exe=""
-if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {
-  # Fix case when both the Windows and Linux builds of Node
-  # are installed in the same directory
-  $exe=".exe"
-}
-$ret=0
-if (Test-Path "$basedir/node$exe") {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "$basedir/node$exe"  "$basedir/../typescript/bin/tsc" $args
-  } else {
-    & "$basedir/node$exe"  "$basedir/../typescript/bin/tsc" $args
-  }
-  $ret=$LASTEXITCODE
-} else {
-  # Support pipeline input
-  if ($MyInvocation.ExpectingInput) {
-    $input | & "node$exe"  "$basedir/../typescript/bin/tsc" $args
-  } else {
-    & "node$exe"  "$basedir/../typescript/bin/tsc" $args
-  }
-  $ret=$LASTEXITCODE
-}
-exit $ret

package/templates/cms-starter/node_modules/.bin/tsserver

@@ -1,16 +0,0 @@
-#!/bin/sh
-basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')")
-
-case `uname` in
-    *CYGWIN*|*MINGW*|*MSYS*)
-        if command -v cygpath > /dev/null 2>&1; then
-            basedir=`cygpath -w "$basedir"`
-        fi
-    ;;
-esac
-
-if [ -x "$basedir/node" ]; then
-  exec "$basedir/node"  "$basedir/../typescript/bin/tsserver" "$@"
-else 
-  exec node  "$basedir/../typescript/bin/tsserver" "$@"
-fi

package/templates/cms-starter/node_modules/.bin/tsserver.cmd

@@ -1,17 +0,0 @@
-@ECHO off
-GOTO start
-:find_dp0
-SET dp0=%~dp0
-EXIT /b
-:start
-SETLOCAL
-CALL :find_dp0
-
-IF EXIST "%dp0%\node.exe" (
-  SET "_prog=%dp0%\node.exe"
-) ELSE (
-  SET "_prog=node"
-  SET PATHEXT=%PATHEXT:;.JS;=;%
-)
-
-endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & "%_prog%"  "%dp0%\..\typescript\bin\tsserver" %*