@telemetryos/cli 1.13.0 → 1.13.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @telemetryos/cli
 
+## 1.13.2
+
+### Patch Changes
+
+- Widen applicationSpecifier pattern to accept dev specifiers
+- Updated dependencies
+  - @telemetryos/development-application-host-ui@1.13.2
+
+## 1.13.1
+
+### Patch Changes
+
+- - **SDK client refactor:** Removed `applicationName` from the client and `configure()` API (still accepted for backwards compatibility). The SDK now resolves `applicationSpecifier` from URL search params first with subdomain fallback, validates it as a 40-char hex hash, and adds `deviceId` from URL params. Store scoping updated accordingly. Fixed a listener leak when calling `configure()` multiple times.
+  - **Template assets moved to `public/`:** SDK template assets (logo, thumbnail) moved from `assets/` to `public/assets/` so Vite includes them in the build output automatically. Dev server updated to resolve from `public/` first.
+  - **Documentation updates for v1.13.0:** Added docs for web mount point, Navigation API, `tos claude-code` command, `vite-react-typescript-web` template, `playlist.getDuration()`, `SettingsMediaSelect` component, and custom logo support. Fixed scope availability, store scope guidance for web mount points, and various inconsistencies.
+
+- Updated dependencies
+  - @telemetryos/development-application-host-ui@1.13.1
+
 ## 1.13.0
 
 ### Minor Changes

package/dist/services/run-server.js

@@ -1,5 +1,5 @@
 import { spawn } from 'child_process';
-import { readFile } from 'fs/promises';
+import { access, readFile } from 'fs/promises';
 import { fileURLToPath } from 'url';
 import http from 'http';
 import path from 'path';
@@ -188,16 +188,30 @@ async function serveImageFile(res, projectPath, filePath, label) {
         res.end(`No ${label} configured`);
         return;
     }
-    try {
-        const fullPath = path.resolve(projectPath, filePath);
-        if (!fullPath.startsWith(path.resolve(projectPath) + path.sep) &&
-            fullPath !== path.resolve(projectPath)) {
-            res.statusCode = 403;
-            res.setHeader('Content-Type', 'text/plain; charset=utf-8');
-            res.end('Forbidden: path escapes project root');
-            return;
+    const projectRoot = path.resolve(projectPath);
+    const validatePath = (fullPath) => fullPath.startsWith(projectRoot + path.sep) || fullPath === projectRoot;
+    // Try public/ first (Vite convention), then project root (backward compat)
+    const publicPath = path.resolve(projectPath, 'public', filePath);
+    const rootPath = path.resolve(projectPath, filePath);
+    let resolvedPath;
+    if (validatePath(publicPath)) {
+        try {
+            await access(publicPath);
+            resolvedPath = publicPath;
         }
-        const imageData = await readFile(fullPath);
+        catch { }
+    }
+    if (!resolvedPath && validatePath(rootPath)) {
+        resolvedPath = rootPath;
+    }
+    if (!resolvedPath) {
+        res.statusCode = 403;
+        res.setHeader('Content-Type', 'text/plain; charset=utf-8');
+        res.end('Forbidden: path escapes project root');
+        return;
+    }
+    try {
+        const imageData = await readFile(resolvedPath);
         const ext = path.extname(filePath).toLowerCase();
         const contentType = IMAGE_MIME_TYPES[ext] || 'application/octet-stream';
         res.setHeader('Content-Type', contentType);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetryos/cli",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "description": "The official TelemetryOS application CLI package. Use it to build applications that run on the TelemetryOS platform",
   "type": "module",
   "bin": {
@@ -25,13 +25,13 @@
   "license": "",
   "repository": "github:TelemetryTV/Application-API",
   "dependencies": {
-    "@telemetryos/development-application-host-ui": "^1.13.0",
+    "@telemetryos/development-application-host-ui": "^1.13.2",
     "@types/serve-handler": "^6.1.4",
     "commander": "^14.0.0",
     "ignore": "^6.0.2",
     "inquirer": "^12.9.6",
     "serve-handler": "^6.1.6",
-    "tar": "^7.4.3",
+    "tar": "^7.5.9",
     "zod": "^4.1.12"
   },
   "devDependencies": {

package/templates/claude-code/CLAUDE.md

@@ -35,6 +35,9 @@ Instance store hooks sync Settings ↔ Render. Application store hooks are acces
 ## Project Structure
 
 ```
+public/
+└── assets/          # Static assets copied to dist/ during build
+    └── tos-app.svg  # App logo (referenced by telemetry.config.json logoPath)
 src/
 ├── index.tsx        # Entry point (configure SDK here)
 ├── App.tsx          # Mount point routing
@@ -48,6 +51,8 @@ src/
     └── store.ts     # Store state hooks
 ```
 
+> **Note:** Files in `public/` are copied as-is to `dist/` by Vite (without the `public/` prefix). The `logoPath` and `thumbnailPath` in `telemetry.config.json` must reference the output path (e.g., `"assets/tos-app.svg"`, not `"public/assets/tos-app.svg"`).
+
 ## Core Pattern
 
 ### Store Hooks (Settings ↔ Render sync)

package/templates/claude-code/_claude/skills/tos-architecture/SKILL.md

@@ -353,8 +353,8 @@ return <WeatherDisplay city={city} />
 ### Verify SDK Configuration
 
 ```typescript
-// In index.tsx - name must match telemetry.config.json
-configure('my-app')
+// In index.tsx
+configure()
 ```
 
 ### Check Store Values

package/templates/claude-code/_claude/skills/tos-debugging/SKILL.md

@@ -18,7 +18,7 @@ Common errors, their causes, and solutions.
 // index.tsx - MUST call configure before React renders
 import { configure } from '@telemetryos/sdk'
 
-configure('my-app')  // Name must match telemetry.config.json
+configure()
 
 ReactDOM.createRoot(document.getElementById('root')!).render(<App />)
 ```
@@ -26,7 +26,6 @@ ReactDOM.createRoot(document.getElementById('root')!).render(<App />)
 **Check:**
 - Is `configure()` called in index.tsx?
 - Is it called BEFORE ReactDOM.createRoot()?
-- Does the name match `telemetry.config.json`?
 
 ---
 
@@ -188,13 +187,13 @@ useEffect(() => {
 4. **SDK configured**
    ```typescript
    // index.tsx
-   configure('app-name')  // Before React renders
+   configure()  // Before React renders
    ```
 
-5. **telemetry.config.json matches**
+5. **telemetry.config.json has correct app name and mount points**
    ```json
    {
-     "name": "app-name",  // Must match configure()
+     "name": "app-name",
      "mountPoints": {
        "render": "/render",
        "settings": "/settings"

package/templates/vite-react-typescript/src/index.tsx

@@ -6,6 +6,6 @@ import { createRoot } from 'react-dom/client'
 import { App } from './App'
 import { configure } from '@telemetryos/sdk'
 
-configure('{{name}}')
+configure()
 
 createRoot(document.querySelector('#app')!).render(<App />)

package/templates/vite-react-typescript/src/views/Render.tsx

@@ -1,5 +1,4 @@
 import { useUiScaleToSetRem } from '@telemetryos/sdk/react'
-import wordMarkPath from '../../assets/telemetryos-wordmark.svg'
 import { useSubtitleStoreState, useUiScaleStoreState } from '../hooks/store'
 import './Render.css'
 
@@ -10,7 +9,7 @@ export function Render() {
 
   return (
     <div className="render">
-      <img src={wordMarkPath} alt="TelemetryOS" className="render__logo" />
+      <img src="/assets/telemetryos-wordmark.svg" alt="TelemetryOS" className="render__logo" />
       <div className="render__hero">
         {uiScale < 1.5 && (
           <div className="render__hero-title">Welcome to TelemetryOS SDK</div>