@telemetryos/root-sdk 1.13.0 → 1.13.2

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @telemetryos/root-sdk
 
+## 1.13.2
+
+### Patch Changes
+
+- Widen applicationSpecifier pattern to accept dev specifiers
+
+## 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.
+
 ## 1.13.0
 
 ### Minor Changes

package/README.md

@@ -340,6 +340,16 @@ alerts.alerts.forEach(alert => {
 
 All weather responses include dual units (Celsius/Fahrenheit, kph/mph, mb/inHg, km/mi) so you can display data in the user's preferred format. An optional `language` parameter is available on all methods for localized weather descriptions.
 
+### Navigation API
+
+The Navigation class provides browser-style navigation control for views embedded in iframes, used primarily by the web mount point. It intercepts `pushState`, `replaceState`, and `popstate` events and relays location changes to the host window via postMessage.
+
+```javascript
+import { Navigation } from '@telemetryos/root-sdk';
+```
+
+Application developers using SPA routing frameworks (React Router, Vue Router, etc.) get navigation support automatically — the SDK intercepts history changes transparently. The host window (dev server or web host) displays an address bar with back/forward controls that communicate with the embedded view. Manual instantiation of `Navigation` is only needed for advanced or custom embedding scenarios.
+
 ### Currency API
 
 Access currency exchange rates and symbols:

package/dist/bridge.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./types-mYnxD5LM.cjs");function r(n){return{...n,type:"bridge"}}const o=e.objectType({type:e.literalType("client"),telemetrySdkVersion:e.stringType(),applicationName:e.stringType(),applicationSpecifier:e.stringType(),applicationInstance:e.stringType(),name:e.stringType(),data:e.anyType(),responseName:e.stringType().optional(),subscriptionName:e.stringType().optional(),unsubscribeName:e.stringType().optional()});class d{bind(){this._windowMessageHandler=i=>{var s;if(i.source===window)return;const t=o.safeParse(i.data);if(!t.success)return;const a=t.data;(s=this.onMessage)===null||s===void 0||s.call(this,a)},window.addEventListener("message",this._windowMessageHandler)}unbind(){this._windowMessageHandler&&window.removeEventListener("message",this._windowMessageHandler)}send(i){for(let s=0;s<window.frames.length;s+=1)window.frames[s].postMessage(r(i),"*")}}exports.Bridge=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./types-mYnxD5LM.cjs");function r(n){return{...n,type:"bridge"}}const o=e.objectType({type:e.literalType("client"),telemetrySdkVersion:e.stringType(),applicationSpecifier:e.stringType(),applicationInstance:e.stringType(),name:e.stringType(),data:e.anyType(),responseName:e.stringType().optional(),subscriptionName:e.stringType().optional(),unsubscribeName:e.stringType().optional()});class d{bind(){this._windowMessageHandler=i=>{var s;if(i.source===window)return;const t=o.safeParse(i.data);if(!t.success)return;const a=t.data;(s=this.onMessage)===null||s===void 0||s.call(this,a)},window.addEventListener("message",this._windowMessageHandler)}unbind(){this._windowMessageHandler&&window.removeEventListener("message",this._windowMessageHandler)}send(i){for(let s=0;s<window.frames.length;s+=1)window.frames[s].postMessage(r(i),"*")}}exports.Bridge=d;

package/dist/bridge.js

@@ -1,18 +1,17 @@
-import { o, s as e, a as r, l as d } from "./types-CCzf8sMT.js";
+import { o, s, a as r, l as d } from "./types-CCzf8sMT.js";
 function l(i) {
   return { ...i, type: "bridge" };
 }
 const p = o({
   type: d("client"),
-  telemetrySdkVersion: e(),
-  applicationName: e(),
-  applicationSpecifier: e(),
-  applicationInstance: e(),
-  name: e(),
+  telemetrySdkVersion: s(),
+  applicationSpecifier: s(),
+  applicationInstance: s(),
+  name: s(),
   data: r(),
-  responseName: e().optional(),
-  subscriptionName: e().optional(),
-  unsubscribeName: e().optional()
+  responseName: s().optional(),
+  subscriptionName: s().optional(),
+  unsubscribeName: s().optional()
 });
 class w {
   /**
@@ -21,14 +20,14 @@ class w {
    */
   bind() {
     this._windowMessageHandler = (a) => {
-      var s;
+      var e;
       if (a.source === window)
         return;
       const n = p.safeParse(a.data);
       if (!n.success)
         return;
       const t = n.data;
-      (s = this.onMessage) === null || s === void 0 || s.call(this, t);
+      (e = this.onMessage) === null || e === void 0 || e.call(this, t);
     }, window.addEventListener("message", this._windowMessageHandler);
   }
   /**
@@ -43,8 +42,8 @@ class w {
    * @param message The message to send.
    */
   send(a) {
-    for (let s = 0; s < window.frames.length; s += 1)
-      window.frames[s].postMessage(l(a), "*");
+    for (let e = 0; e < window.frames.length; e += 1)
+      window.frames[e].postMessage(l(a), "*");
   }
 }
 export {

package/dist/client-message-validator.d.ts

@@ -2,7 +2,6 @@ import { z } from 'zod';
 export declare const clientMessageValidator: z.ZodObject<{
     type: z.ZodLiteral<"client">;
     telemetrySdkVersion: z.ZodString;
-    applicationName: z.ZodString;
     applicationSpecifier: z.ZodString;
     applicationInstance: z.ZodString;
     name: z.ZodString;
@@ -13,7 +12,6 @@ export declare const clientMessageValidator: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     type: "client";
     telemetrySdkVersion: string;
-    applicationName: string;
     applicationSpecifier: string;
     applicationInstance: string;
     name: string;
@@ -24,7 +22,6 @@ export declare const clientMessageValidator: z.ZodObject<{
 }, {
     type: "client";
     telemetrySdkVersion: string;
-    applicationName: string;
     applicationSpecifier: string;
     applicationInstance: string;
     name: string;

package/dist/client.d.ts

@@ -76,9 +76,9 @@ export type MessageInterceptor = (data: any) => BridgeMessage;
  * when an application needs to manage multiple independent communication channels.
  */
 export declare class Client {
-    _applicationName: string;
     _applicationInstance: string;
     _applicationSpecifier: string;
+    _deviceId: string;
     _navigation: Navigation;
     _messageInterceptors: Map<string, MessageInterceptor>;
     _onHandlers: Map<string, MessageHandler<any>[]>;
@@ -92,11 +92,8 @@ export declare class Client {
      * Note that creating a Client instance alone is not sufficient to begin communication.
      * You must also call the bind() method to initialize event listeners and extract
      * the application ID from the URL.
-     *
-     * @param applicationName The name of your application - must match the 'name' property
-     *                        in your application's telemetry.config.json file
      */
-    constructor(applicationName: string);
+    constructor();
     /**
      * Provides access to the accounts API for retrieving TelemetryOS account information.
      *
@@ -236,9 +233,9 @@ export declare class Client {
      */
     get environment(): Environment;
     get mqtt(): Mqtt;
-    get applicationName(): string;
     get applicationSpecifier(): string;
     get applicationInstance(): string;
+    get deviceId(): string;
     /**
      * Initializes the client by setting up message listeners and extracting the application ID.
      *

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("./types-mYnxD5LM.cjs"),Q="1.13.0",U={version:Q};class I{constructor(e){this._client=e}async getCurrent(){const e=await this._client.request("accounts.getCurrent",{});if(!e.success)throw new Error("Failed to fetch current account");return e.account}}class P{constructor(e){this._client=e}async getAllByMountPoint(e){return(await this._client.request("applications.getAllByMountPoint",{mountPoint:e})).applications}async getByName(e){return(await this._client.request("applications.getByName",{name:e})).application}async setDependencies(e){return await this._client.request("applications.setDependencies",{applicationSpecifiers:e},{timeout:0})}bind(e,t){if(this._client._messageInterceptors.has(e))throw new Error(`Interceptor already bound for message ${e}`);this._client._messageInterceptors.set(e,t)}}class T{constructor(e){this._client=e}async getInformation(){const e=await this._client.request("devices.getInformation",{});if(!e.success)throw new Error("Failed to get device information");return e.deviceInformation}async getCapabilities(){const e=await this._client.request("devices.getCapabilities",{});if(!e.success)throw new Error("Failed to get device capabilities");return e.capabilities}}class M{constructor(e){this._client=e}async getColorScheme(){return(await this._client.request("environment.getColorScheme",{})).colorScheme}async subscribeColorScheme(e){return(await this._client.subscribe("environment.subscribeColorScheme",{},e)).success}async unsubscribeColorScheme(e){return(await this._client.unsubscribe("environment.unsubscribeColorScheme",{},e)).success}}class k{constructor(e){this._client=e}async getAllFolders(){return(await this._client.request("mediaFolders.getAll",{})).folders}async getAllByFolderId(e){return(await this._client.request("media.getAllByFolderId",{folderId:e})).contents}async getAllByTag(e){return(await this._client.request("media.getAllByTag",{tagName:e})).contents}async getById(e){return(await this._client.request("media.getById",{id:e})).content}async openPicker(e){return(await this._client.request("media.openPicker",{accept:e==null?void 0:e.accept,currentValue:e==null?void 0:e.currentValue})).selection}}class F{constructor(e){this._client=e}async fetch(e,t){var s;let i;typeof e=="string"?i=e:e instanceof URL?i=e.toString():(i=e.url,t||(t={method:e.method,headers:e.headers,body:e.body,credentials:e.credentials,cache:e.cache,redirect:e.redirect,referrer:e.referrer,integrity:e.integrity}));let n={};t!=null&&t.headers&&(t.headers instanceof Headers?t.headers.forEach((h,u)=>{n[u]=h}):Array.isArray(t.headers)?t.headers.forEach(([h,u])=>{n[h]=u}):n=t.headers);const a=await this._client.request("proxy.fetch",{url:i,method:(t==null?void 0:t.method)||"GET",headers:n,body:(s=t==null?void 0:t.body)!==null&&s!==void 0?s:null});if(!a.success)throw new TypeError(a.errorMessage,{cause:a.errorCause?Error(a.errorCause):void 0});const l=new Headers(a.headers),c={status:a.status,statusText:a.statusText,headers:l};let p=null;if(a.body!==null&&a.body!==void 0)if(a.bodyType==="binary"){const h=atob(a.body),u=new Uint8Array(h.length);for(let f=0;f<h.length;f++)u[f]=h.charCodeAt(f);p=u}else a.bodyType==="text"?p=a.body:a.bodyType==="json"&&(p=JSON.stringify(a.body));return new Response(p,c)}}class A{constructor(e){this._client=e}get application(){return new v("application","",this._client)}get instance(){return new v("instance",this._client.applicationInstance,this._client)}get device(){return new v("device",this._client.applicationInstance,this._client)}shared(e){return new v("shared",e,this._client)}}class v{constructor(e,t,s){this._kind=e,this._namespace=t,this._client=s}async set(e,t){return(await this._client.request("store.set",{kind:this._kind,namespace:this._namespace,key:e,value:t})).success}async get(e){return(await this._client.request("store.get",{kind:this._kind,namespace:this._namespace,key:e})).value}async subscribe(e,t){return(await this._client.subscribe("store.subscribe",{kind:this._kind,namespace:this._namespace,key:e},t)).success}async unsubscribe(e,t){return(await this._client.unsubscribe("store.unsubscribe",{kind:this._kind,namespace:this._namespace,key:e},t)).success}async delete(e){return(await this._client.request("store.delete",{kind:this._kind,namespace:this._namespace,key:e})).success}}class R{constructor(e){this._client=e}async getCurrent(){const e=await this._client.request("users.getCurrent",{});if(!e.success)throw new Error("Failed to fetch current user");return e.user}}class B{constructor(e){this._client=e}async getCities(e){const t=await this._client.request("weather.getCities",e);if(!t.success)throw new Error(t.error||"Failed to fetch cities");return t.data||[]}async getConditions(e){const t=await this._client.request("weather.getConditions",e);if(!t.success)throw new Error(t.error||"Failed to fetch weather conditions");return t}async getDailyForecast(e){const t=await this._client.request("weather.getDailyForecast",e);if(!t.success)throw new Error(t.error||"Failed to fetch daily forecast");return t}async getHourlyForecast(e){const t=await this._client.request("weather.getHourlyForecast",e);if(!t.success)throw new Error(t.error||"Failed to fetch hourly forecast");return t}async getAlerts(e){const t=await this._client.request("weather.getAlerts",e);if(!t.success)throw new Error(t.error||"Failed to fetch weather alerts");return t}}class ${constructor(e){this._client=e}async getSymbols(){const e=await this._client.request("currency.getSymbols",{});if(!e.success||!e.symbols)throw new Error("Failed to fetch currency symbols");return e.symbols}async getRates(e){var t,s,i;const n=await this._client.request("currency.getRates",e);if(!n.success||!n.rates)throw((t=n.error)===null||t===void 0?void 0:t.code)===201?new Error(`Invalid base currency '${e.base}'`):((s=n.error)===null||s===void 0?void 0:s.code)===202?new Error(`Invalid target currency symbol '${e.symbols}'`):new Error(((i=n.error)===null||i===void 0?void 0:i.message)||"Failed to fetch currency rates");return n.rates}}class x{constructor(e){this._client=e}async discover(){const e=await this._client.request("mqtt.discover",{});if(!e.success)throw new Error("Failed to discover MQTT brokers");return e.brokers}async connect(e,t){const s=await this._client.request("mqtt.connect",{brokerUrl:e,...t});if(!s.success)throw new Error("Failed to connect to MQTT broker");return s.clientId}async disconnect(e){if(!(await this._client.request("mqtt.disconnect",{clientId:e})).success)throw new Error("Failed to disconnect from MQTT broker")}async publish(e,t,s,i){if(!(await this._client.request("mqtt.publish",{clientId:e,topic:t,payload:s,...i})).success)throw new Error("Failed to publish MQTT message")}async subscribe(e,t,s,i){return(await this._client.subscribe("mqtt.subscribe",{clientId:e,topic:t,...i},s)).success}async unsubscribe(e,t,s){return(await this._client.unsubscribe("mqtt.unsubscribe",{clientId:e,topic:t},s)).success}async getConnectionStatus(e){const t=await this._client.request("mqtt.getConnectionStatus",{clientId:e});if(!t.success)throw new Error("Failed to get MQTT connection status");return t.status}async subscribeConnectionStatus(e,t){return(await this._client.subscribe("mqtt.subscribeConnectionStatus",{clientId:e},t)).success}async unsubscribeConnectionStatus(e,t){return(await this._client.unsubscribe("mqtt.unsubscribeConnectionStatus",{clientId:e},t)).success}}class L{constructor(e){this._originalPushState=null,this._originalReplaceState=null,this._popstateHandler=null,this._backHandler=null,this._forwardHandler=null,this._client=e}bind(){typeof window>"u"||this._originalPushState||(this._originalPushState=history.pushState.bind(history),history.pushState=(...e)=>{this._originalPushState(...e),this._sendLocationChanged()},this._originalReplaceState=history.replaceState.bind(history),history.replaceState=(...e)=>{this._originalReplaceState(...e),this._sendLocationChanged()},this._popstateHandler=()=>this._sendLocationChanged(),window.addEventListener("popstate",this._popstateHandler),this._backHandler=()=>history.back(),this._forwardHandler=()=>history.forward(),this._client.on("navigation.back",this._backHandler),this._client.on("navigation.forward",this._forwardHandler),this._sendLocationChanged())}unbind(){typeof window>"u"||(this._originalPushState&&(history.pushState=this._originalPushState,this._originalPushState=null),this._originalReplaceState&&(history.replaceState=this._originalReplaceState,this._originalReplaceState=null),this._popstateHandler&&(window.removeEventListener("popstate",this._popstateHandler),this._popstateHandler=null),this._backHandler&&(this._client.off("navigation.back",this._backHandler),this._backHandler=null),this._forwardHandler&&(this._client.off("navigation.forward",this._forwardHandler),this._forwardHandler=null))}_sendLocationChanged(){this._client.send("navigation.locationChanged",{pathname:window.location.pathname})}}function H(o){return{...o,type:"client"}}const V=N.objectType({type:N.literalType("bridge"),name:N.stringType(),data:N.anyType()});class W{constructor(e){if(e._client._applicationSpecifier!=="rootSettingsNavigation")throw new Error("RootSettingsNavigation can only be used in the rootSettingsNavigation mount point");this._store=e}async setRootSettingsNavigation(e){var t;const s=this._store.shared("root-settings-navigation"),i=(t=await s.get("navigation"))!==null&&t!==void 0?t:{},n=this._store._client._applicationSpecifier;i[n]={applicationSpecifier:n,entries:e.entries},s.set("navigation",i)}async getRootSettingsNavigation(){var e;const s=(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{},i=this._store._client._applicationSpecifier;return s[i]}async getAllRootSettingsNavigation(){var e;return(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{}}}const m=1e3*30,C=typeof window>"u"&&typeof self<"u",S=C?self:window;function y(o){C?self.postMessage(o):S.parent.postMessage(o,"*")}class j{constructor(e){this._applicationName=e,this._applicationInstance="",this._applicationSpecifier="",this._navigation=new L(this),this._messageInterceptors=new Map,this._onHandlers=new Map,this._onceHandlers=new Map,this._subscriptionNamesByHandler=new Map,this._subscriptionNamesBySubjectName=new Map}get accounts(){return new I(this)}get users(){return new R(this)}get store(){return new A(this)}get applications(){return new P(this)}get media(){return new k(this)}get proxy(){return new F(this)}get devices(){return new T(this)}get rootSettingsNavigation(){return new W(this.store)}get weather(){return new B(this)}get currency(){return new $(this)}get environment(){return new M(this)}get mqtt(){return new x(this)}get applicationName(){return this._applicationName}get applicationSpecifier(){return this._applicationSpecifier}get applicationInstance(){return this._applicationInstance}bind(){var e,t,s;const i=new URL(S.location.href),n=i.searchParams;if(this._applicationInstance=(e=n.get("applicationInstance"))!==null&&e!==void 0?e:"",!this._applicationInstance)throw new Error("Missing applicationInstance query parameter");if(this._applicationSpecifier=(t=n.get("applicationSpecifier"))!==null&&t!==void 0?t:"",!this._applicationSpecifier){const a=i.hostname.split(".");this._applicationSpecifier=(s=a[0])!==null&&s!==void 0?s:""}if(!this._applicationSpecifier||this._applicationSpecifier.length!==40)throw new Error(`Invalid applicationSpecifier: expected 40-character hash, got "${this._applicationSpecifier}"`);this._windowMessageHandler=a=>{if(a.source===S||!a.data||typeof a.data!="object"||!("type"in a.data)||a.data.type!=="client"&&a.data.type!=="bridge")return;let l;if(a.data.type==="client"){const c=this._messageInterceptors.get(a.data.name);if(!c){y(a.data);return}l={...c(a.data.data),type:"bridge",...a.data.responseName?{name:a.data.responseName}:{}}}if(!l){const c=V.safeParse(a.data);if(!c.success)return;l=c.data;const p=this._onHandlers.get(l.name),h=this._onceHandlers.get(l.name);if(p)for(const u of p)u(l.data);if(h){for(const u of h)u(l.data);this._onceHandlers.delete(l.name)}}if(!C)for(let c=0;c<window.frames.length;c+=1)window.frames[c].postMessage(l,"*")},S.addEventListener("message",this._windowMessageHandler),this._navigation.bind()}unbind(){this._windowMessageHandler&&(this._navigation.unbind(),S.removeEventListener("message",this._windowMessageHandler))}send(e,t){const s=H({telemetrySdkVersion:q,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t});y(s)}request(e,t,s){var i;const n=E(),a=H({telemetrySdkVersion:q,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t,responseName:n});y(a);const l=(i=s==null?void 0:s.timeout)!==null&&i!==void 0?i:m;let c=!1,p;const h=new Promise(f=>{p=g=>{c||f(g)},this.once(n,p)});if(l===0)return h;const u=new Promise((f,g)=>{const w=new Error(`${e} message request with response name of ${n} timed out after ${l}`);setTimeout(()=>{c=!0,this.off(n,p),g(w)},l)});return Promise.race([u,h])}async subscribe(e,t,s){let i,n;typeof t=="function"?n=t:(i=t,n=s);const a=E(),l=E();let c=this._subscriptionNamesBySubjectName.get(e);c||(c=[],this._subscriptionNamesBySubjectName.set(e,c)),c.push(a),this._subscriptionNamesByHandler.set(n,a),this.on(a,n);const p=H({telemetrySdkVersion:q,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:i,responseName:l,subscriptionName:a});y(p);let h=!1,u;const f=new Promise((w,_)=>{const b=new Error(`${e} subscribe request with subscription name of ${a} and response name of ${l} timed out after ${m}`);setTimeout(()=>{h=!0,this.off(l,u),_(b)},m)}),g=new Promise(w=>{u=_=>{h||w(_)},this.once(l,u)});return Promise.race([f,g])}async unsubscribe(e,t,s){let i,n;typeof t=="function"?n=t:(i=t,n=s);const a=E();let l=[];if(n){const c=this._subscriptionNamesByHandler.get(n);if(!c)return{success:!1};l=[c],this._subscriptionNamesByHandler.delete(n)}else if(!this._subscriptionNamesBySubjectName.get(e))return{success:!1};for await(const c of l){this.off(c,n);const p=H({telemetrySdkVersion:q,applicationInstance:this._applicationInstance,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,name:e,data:i,responseName:a,unsubscribeName:c});y(p);let h=!1,u;const f=new Promise((_,b)=>{const D=new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${a} timed out after ${m}`);setTimeout(()=>{h=!0,this.off(a,u),b(D)},m)}),g=new Promise(_=>{u=b=>{h||_(b)},this.once(a,u)});if(!(await Promise.race([f,g])).success)return{success:!1}}return{success:!0}}on(e,t){var s;const i=(s=this._onHandlers.get(e))!==null&&s!==void 0?s:[];i.length===0&&this._onHandlers.set(e,i),i.push(t)}once(e,t){var s;const i=(s=this._onceHandlers.get(e))!==null&&s!==void 0?s:[];i.length===0&&this._onceHandlers.set(e,i),i.push(t)}off(e,t){const s=this._onHandlers.get(e),i=this._onceHandlers.get(e);if(!(!s&&!i)){if(s){for(let n=0;n<s.length;n+=1)t&&s[n]!==t||(s.splice(n,1),n-=1);s.length===0&&this._onHandlers.delete(e)}if(i){for(let n=0;n<i.length;n+=1)t&&i[n]!==t||(i.splice(n,1),n-=1);i.length===0&&this._onceHandlers.delete(e)}}}}function E(){return Math.random().toString(36).slice(2,9)}const q=U.version;let r=null;function O(){return r}function G(o){r=new j(o),r.bind()}function J(){r==null||r.unbind(),r=null}function K(...o){return d(r),r.on(...o)}function z(...o){return d(r),r.once(...o)}function X(...o){return d(r),r.off(...o)}function Y(...o){return d(r),r.send(...o)}function Z(...o){return d(r),r.request(...o)}function ee(...o){return d(r),r.subscribe(...o)}function te(...o){return d(r),r.unsubscribe(...o)}function se(){return d(r),r.store}function ne(){return d(r),r.applications}function ie(){return d(r),r.media}function re(){return d(r),r.accounts}function ae(){return d(r),r.users}function oe(){return d(r),r.devices}function ce(){return d(r),r.proxy}function le(){return d(r),r.rootSettingsNavigation}function ue(){return d(r),r.weather}function he(){return d(r),r.currency}function de(){return d(r),r.environment}function pe(){return d(r),r.mqtt}function d(o){if(!o)throw new Error("SDK is not configured")}exports.Accounts=I;exports.Applications=P;exports.Client=j;exports.Currency=$;exports.Devices=T;exports.Environment=M;exports.Media=k;exports.Mqtt=x;exports.Navigation=L;exports.Proxy=F;exports.Store=A;exports.StoreSlice=v;exports.Users=R;exports.Weather=B;exports.accounts=re;exports.applications=ne;exports.configure=G;exports.currency=he;exports.destroy=J;exports.devices=oe;exports.environment=de;exports.globalClient=O;exports.media=ie;exports.mqtt=pe;exports.off=X;exports.on=K;exports.once=z;exports.proxy=ce;exports.request=Z;exports.rootSettingsNavigation=le;exports.send=Y;exports.store=se;exports.subscribe=ee;exports.telemetrySdkVersion=q;exports.unsubscribe=te;exports.users=ae;exports.weather=ue;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const H=require("./types-mYnxD5LM.cjs"),Q="1.13.2",V={version:Q};class E{constructor(e){this._client=e}async getCurrent(){const e=await this._client.request("accounts.getCurrent",{});if(!e.success)throw new Error("Failed to fetch current account");return e.account}}class P{constructor(e){this._client=e}async getAllByMountPoint(e){return(await this._client.request("applications.getAllByMountPoint",{mountPoint:e})).applications}async getByName(e){return(await this._client.request("applications.getByName",{name:e})).application}async setDependencies(e){return await this._client.request("applications.setDependencies",{applicationSpecifiers:e},{timeout:0})}bind(e,t){if(this._client._messageInterceptors.has(e))throw new Error(`Interceptor already bound for message ${e}`);this._client._messageInterceptors.set(e,t)}}class T{constructor(e){this._client=e}async getInformation(){const e=await this._client.request("devices.getInformation",{});if(!e.success)throw new Error("Failed to get device information");return e.deviceInformation}async getCapabilities(){const e=await this._client.request("devices.getCapabilities",{});if(!e.success)throw new Error("Failed to get device capabilities");return e.capabilities}}class k{constructor(e){this._client=e}async getColorScheme(){return(await this._client.request("environment.getColorScheme",{})).colorScheme}async subscribeColorScheme(e){return(await this._client.subscribe("environment.subscribeColorScheme",{},e)).success}async unsubscribeColorScheme(e){return(await this._client.unsubscribe("environment.unsubscribeColorScheme",{},e)).success}}class M{constructor(e){this._client=e}async getAllFolders(){return(await this._client.request("mediaFolders.getAll",{})).folders}async getAllByFolderId(e){return(await this._client.request("media.getAllByFolderId",{folderId:e})).contents}async getAllByTag(e){return(await this._client.request("media.getAllByTag",{tagName:e})).contents}async getById(e){return(await this._client.request("media.getById",{id:e})).content}async openPicker(e){return(await this._client.request("media.openPicker",{accept:e==null?void 0:e.accept,currentValue:e==null?void 0:e.currentValue})).selection}}class F{constructor(e){this._client=e}async fetch(e,t){var s;let i;typeof e=="string"?i=e:e instanceof URL?i=e.toString():(i=e.url,t||(t={method:e.method,headers:e.headers,body:e.body,credentials:e.credentials,cache:e.cache,redirect:e.redirect,referrer:e.referrer,integrity:e.integrity}));let n={};t!=null&&t.headers&&(t.headers instanceof Headers?t.headers.forEach((h,u)=>{n[u]=h}):Array.isArray(t.headers)?t.headers.forEach(([h,u])=>{n[h]=u}):n=t.headers);const o=await this._client.request("proxy.fetch",{url:i,method:(t==null?void 0:t.method)||"GET",headers:n,body:(s=t==null?void 0:t.body)!==null&&s!==void 0?s:null});if(!o.success)throw new TypeError(o.errorMessage,{cause:o.errorCause?Error(o.errorCause):void 0});const l=new Headers(o.headers),c={status:o.status,statusText:o.statusText,headers:l};let p=null;if(o.body!==null&&o.body!==void 0)if(o.bodyType==="binary"){const h=atob(o.body),u=new Uint8Array(h.length);for(let f=0;f<h.length;f++)u[f]=h.charCodeAt(f);p=u}else o.bodyType==="text"?p=o.body:o.bodyType==="json"&&(p=JSON.stringify(o.body));return new Response(p,c)}}class A{constructor(e){this._client=e}get application(){return new v("application",void 0,this._client)}get instance(){return new v("instance",this._client.applicationInstance,this._client)}get device(){return new v("device",this._client.deviceId,this._client)}shared(e){return new v("shared",e,this._client)}}class v{constructor(e,t,s){this._kind=e,this._namespace=t,this._client=s}async set(e,t){return(await this._client.request("store.set",{kind:this._kind,namespace:this._namespace,key:e,value:t})).success}async get(e){return(await this._client.request("store.get",{kind:this._kind,namespace:this._namespace,key:e})).value}async subscribe(e,t){return(await this._client.subscribe("store.subscribe",{kind:this._kind,namespace:this._namespace,key:e},t)).success}async unsubscribe(e,t){return(await this._client.unsubscribe("store.unsubscribe",{kind:this._kind,namespace:this._namespace,key:e},t)).success}async delete(e){return(await this._client.request("store.delete",{kind:this._kind,namespace:this._namespace,key:e})).success}}class R{constructor(e){this._client=e}async getCurrent(){const e=await this._client.request("users.getCurrent",{});if(!e.success)throw new Error("Failed to fetch current user");return e.user}}class B{constructor(e){this._client=e}async getCities(e){const t=await this._client.request("weather.getCities",e);if(!t.success)throw new Error(t.error||"Failed to fetch cities");return t.data||[]}async getConditions(e){const t=await this._client.request("weather.getConditions",e);if(!t.success)throw new Error(t.error||"Failed to fetch weather conditions");return t}async getDailyForecast(e){const t=await this._client.request("weather.getDailyForecast",e);if(!t.success)throw new Error(t.error||"Failed to fetch daily forecast");return t}async getHourlyForecast(e){const t=await this._client.request("weather.getHourlyForecast",e);if(!t.success)throw new Error(t.error||"Failed to fetch hourly forecast");return t}async getAlerts(e){const t=await this._client.request("weather.getAlerts",e);if(!t.success)throw new Error(t.error||"Failed to fetch weather alerts");return t}}class ${constructor(e){this._client=e}async getSymbols(){const e=await this._client.request("currency.getSymbols",{});if(!e.success||!e.symbols)throw new Error("Failed to fetch currency symbols");return e.symbols}async getRates(e){var t,s,i;const n=await this._client.request("currency.getRates",e);if(!n.success||!n.rates)throw((t=n.error)===null||t===void 0?void 0:t.code)===201?new Error(`Invalid base currency '${e.base}'`):((s=n.error)===null||s===void 0?void 0:s.code)===202?new Error(`Invalid target currency symbol '${e.symbols}'`):new Error(((i=n.error)===null||i===void 0?void 0:i.message)||"Failed to fetch currency rates");return n.rates}}class L{constructor(e){this._client=e}async discover(){const e=await this._client.request("mqtt.discover",{});if(!e.success)throw new Error("Failed to discover MQTT brokers");return e.brokers}async connect(e,t){const s=await this._client.request("mqtt.connect",{brokerUrl:e,...t});if(!s.success)throw new Error("Failed to connect to MQTT broker");return s.clientId}async disconnect(e){if(!(await this._client.request("mqtt.disconnect",{clientId:e})).success)throw new Error("Failed to disconnect from MQTT broker")}async publish(e,t,s,i){if(!(await this._client.request("mqtt.publish",{clientId:e,topic:t,payload:s,...i})).success)throw new Error("Failed to publish MQTT message")}async subscribe(e,t,s,i){return(await this._client.subscribe("mqtt.subscribe",{clientId:e,topic:t,...i},s)).success}async unsubscribe(e,t,s){return(await this._client.unsubscribe("mqtt.unsubscribe",{clientId:e,topic:t},s)).success}async getConnectionStatus(e){const t=await this._client.request("mqtt.getConnectionStatus",{clientId:e});if(!t.success)throw new Error("Failed to get MQTT connection status");return t.status}async subscribeConnectionStatus(e,t){return(await this._client.subscribe("mqtt.subscribeConnectionStatus",{clientId:e},t)).success}async unsubscribeConnectionStatus(e,t){return(await this._client.unsubscribe("mqtt.unsubscribeConnectionStatus",{clientId:e},t)).success}}class x{constructor(e){this._originalPushState=null,this._originalReplaceState=null,this._popstateHandler=null,this._backHandler=null,this._forwardHandler=null,this._client=e}bind(){typeof window>"u"||this._originalPushState||(this._originalPushState=history.pushState.bind(history),history.pushState=(...e)=>{this._originalPushState(...e),this._sendLocationChanged()},this._originalReplaceState=history.replaceState.bind(history),history.replaceState=(...e)=>{this._originalReplaceState(...e),this._sendLocationChanged()},this._popstateHandler=()=>this._sendLocationChanged(),window.addEventListener("popstate",this._popstateHandler),this._backHandler=()=>history.back(),this._forwardHandler=()=>history.forward(),this._client.on("navigation.back",this._backHandler),this._client.on("navigation.forward",this._forwardHandler),this._sendLocationChanged())}unbind(){typeof window>"u"||(this._originalPushState&&(history.pushState=this._originalPushState,this._originalPushState=null),this._originalReplaceState&&(history.replaceState=this._originalReplaceState,this._originalReplaceState=null),this._popstateHandler&&(window.removeEventListener("popstate",this._popstateHandler),this._popstateHandler=null),this._backHandler&&(this._client.off("navigation.back",this._backHandler),this._backHandler=null),this._forwardHandler&&(this._client.off("navigation.forward",this._forwardHandler),this._forwardHandler=null))}_sendLocationChanged(){this._client.send("navigation.locationChanged",{pathname:window.location.pathname})}}function N(a){return{...a,type:"client"}}const O=H.objectType({type:H.literalType("bridge"),name:H.stringType(),data:H.anyType()});class W{constructor(e){if(e._client._applicationSpecifier!=="rootSettingsNavigation")throw new Error("RootSettingsNavigation can only be used in the rootSettingsNavigation mount point");this._store=e}async setRootSettingsNavigation(e){var t;const s=this._store.shared("root-settings-navigation"),i=(t=await s.get("navigation"))!==null&&t!==void 0?t:{},n=this._store._client._applicationSpecifier;i[n]={applicationSpecifier:n,entries:e.entries},s.set("navigation",i)}async getRootSettingsNavigation(){var e;const s=(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{},i=this._store._client._applicationSpecifier;return s[i]}async getAllRootSettingsNavigation(){var e;return(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{}}}const y=1e3*30,C=typeof window>"u"&&typeof self<"u",S=C?self:window;function m(a){C?self.postMessage(a):S.parent.postMessage(a,"*")}class j{constructor(){this._applicationInstance="",this._applicationSpecifier="",this._deviceId="",this._navigation=new x(this),this._messageInterceptors=new Map,this._onHandlers=new Map,this._onceHandlers=new Map,this._subscriptionNamesByHandler=new Map,this._subscriptionNamesBySubjectName=new Map}get accounts(){return new E(this)}get users(){return new R(this)}get store(){return new A(this)}get applications(){return new P(this)}get media(){return new M(this)}get proxy(){return new F(this)}get devices(){return new T(this)}get rootSettingsNavigation(){return new W(this.store)}get weather(){return new B(this)}get currency(){return new $(this)}get environment(){return new k(this)}get mqtt(){return new L(this)}get applicationSpecifier(){return this._applicationSpecifier}get applicationInstance(){return this._applicationInstance}get deviceId(){return this._deviceId}bind(){var e,t;const s=new URL(S.location.href),i=s.searchParams;this._applicationInstance=i.get("applicationInstance")||"single",this._deviceId=i.get("deviceId")||this._applicationInstance;const n=/^[a-z0-9-]{40}$/i;if(this._applicationSpecifier=(e=i.get("applicationSpecifier"))!==null&&e!==void 0?e:"",!this._applicationSpecifier||!n.test(this._applicationSpecifier)){const o=s.hostname.split(".");this._applicationSpecifier=(t=o[0])!==null&&t!==void 0?t:""}if(!this._applicationSpecifier||!n.test(this._applicationSpecifier))throw console.error("TelemetryOS apps require an applicationSpecifier in the URL query parameters or subdomain. Make sure your app is being served correctly through the TelemetryOS platform or development environment."),new Error(`Invalid applicationSpecifier: expected 40-character hash, got "${this._applicationSpecifier}"`);this._windowMessageHandler=o=>{if(o.source===S||!o.data||typeof o.data!="object"||!("type"in o.data)||o.data.type!=="client"&&o.data.type!=="bridge")return;let l;if(o.data.type==="client"){const c=this._messageInterceptors.get(o.data.name);if(!c){m(o.data);return}l={...c(o.data.data),type:"bridge",...o.data.responseName?{name:o.data.responseName}:{}}}if(!l){const c=O.safeParse(o.data);if(!c.success)return;l=c.data;const p=this._onHandlers.get(l.name),h=this._onceHandlers.get(l.name);if(p)for(const u of p)u(l.data);if(h){for(const u of h)u(l.data);this._onceHandlers.delete(l.name)}}if(!C)for(let c=0;c<window.frames.length;c+=1)window.frames[c].postMessage(l,"*")},S.addEventListener("message",this._windowMessageHandler),this._navigation.bind()}unbind(){this._windowMessageHandler&&(this._navigation.unbind(),S.removeEventListener("message",this._windowMessageHandler))}send(e,t){const s=N({telemetrySdkVersion:q,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t});m(s)}request(e,t,s){var i;const n=I(),o=N({telemetrySdkVersion:q,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t,responseName:n});m(o);const l=(i=s==null?void 0:s.timeout)!==null&&i!==void 0?i:y;let c=!1,p;const h=new Promise(f=>{p=g=>{c||f(g)},this.once(n,p)});if(l===0)return h;const u=new Promise((f,g)=>{const w=new Error(`${e} message request with response name of ${n} timed out after ${l}`);setTimeout(()=>{c=!0,this.off(n,p),g(w)},l)});return Promise.race([u,h])}async subscribe(e,t,s){let i,n;typeof t=="function"?n=t:(i=t,n=s);const o=I(),l=I();let c=this._subscriptionNamesBySubjectName.get(e);c||(c=[],this._subscriptionNamesBySubjectName.set(e,c)),c.push(o),this._subscriptionNamesByHandler.set(n,o),this.on(o,n);const p=N({telemetrySdkVersion:q,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:i,responseName:l,subscriptionName:o});m(p);let h=!1,u;const f=new Promise((w,_)=>{const b=new Error(`${e} subscribe request with subscription name of ${o} and response name of ${l} timed out after ${y}`);setTimeout(()=>{h=!0,this.off(l,u),_(b)},y)}),g=new Promise(w=>{u=_=>{h||w(_)},this.once(l,u)});return Promise.race([f,g])}async unsubscribe(e,t,s){let i,n;typeof t=="function"?n=t:(i=t,n=s);const o=I();let l=[];if(n){const c=this._subscriptionNamesByHandler.get(n);if(!c)return{success:!1};l=[c],this._subscriptionNamesByHandler.delete(n)}else if(!this._subscriptionNamesBySubjectName.get(e))return{success:!1};for await(const c of l){this.off(c,n);const p=N({telemetrySdkVersion:q,applicationInstance:this._applicationInstance,applicationSpecifier:this._applicationSpecifier,name:e,data:i,responseName:o,unsubscribeName:c});m(p);let h=!1,u;const f=new Promise((_,b)=>{const U=new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${o} timed out after ${y}`);setTimeout(()=>{h=!0,this.off(o,u),b(U)},y)}),g=new Promise(_=>{u=b=>{h||_(b)},this.once(o,u)});if(!(await Promise.race([f,g])).success)return{success:!1}}return{success:!0}}on(e,t){var s;const i=(s=this._onHandlers.get(e))!==null&&s!==void 0?s:[];i.length===0&&this._onHandlers.set(e,i),i.push(t)}once(e,t){var s;const i=(s=this._onceHandlers.get(e))!==null&&s!==void 0?s:[];i.length===0&&this._onceHandlers.set(e,i),i.push(t)}off(e,t){const s=this._onHandlers.get(e),i=this._onceHandlers.get(e);if(!(!s&&!i)){if(s){for(let n=0;n<s.length;n+=1)t&&s[n]!==t||(s.splice(n,1),n-=1);s.length===0&&this._onHandlers.delete(e)}if(i){for(let n=0;n<i.length;n+=1)t&&i[n]!==t||(i.splice(n,1),n-=1);i.length===0&&this._onceHandlers.delete(e)}}}}function I(){return Math.random().toString(36).slice(2,9)}const q=V.version;let r=null;function z(){return r}function G(a){D(),r=new j,r.bind()}function D(){r==null||r.unbind(),r=null}function J(...a){return d(r),r.on(...a)}function K(...a){return d(r),r.once(...a)}function X(...a){return d(r),r.off(...a)}function Y(...a){return d(r),r.send(...a)}function Z(...a){return d(r),r.request(...a)}function ee(...a){return d(r),r.subscribe(...a)}function te(...a){return d(r),r.unsubscribe(...a)}function se(){return d(r),r.store}function ne(){return d(r),r.applications}function ie(){return d(r),r.media}function re(){return d(r),r.accounts}function oe(){return d(r),r.users}function ae(){return d(r),r.devices}function ce(){return d(r),r.proxy}function le(){return d(r),r.rootSettingsNavigation}function ue(){return d(r),r.weather}function he(){return d(r),r.currency}function de(){return d(r),r.environment}function pe(){return d(r),r.mqtt}function d(a){if(!a)throw new Error("SDK is not configured")}exports.Accounts=E;exports.Applications=P;exports.Client=j;exports.Currency=$;exports.Devices=T;exports.Environment=k;exports.Media=M;exports.Mqtt=L;exports.Navigation=x;exports.Proxy=F;exports.Store=A;exports.StoreSlice=v;exports.Users=R;exports.Weather=B;exports.accounts=re;exports.applications=ne;exports.configure=G;exports.currency=he;exports.destroy=D;exports.devices=ae;exports.environment=de;exports.globalClient=z;exports.media=ie;exports.mqtt=pe;exports.off=X;exports.on=J;exports.once=K;exports.proxy=ce;exports.request=Z;exports.rootSettingsNavigation=le;exports.send=Y;exports.store=se;exports.subscribe=ee;exports.telemetrySdkVersion=q;exports.unsubscribe=te;exports.users=oe;exports.weather=ue;

package/dist/index.d.ts

@@ -42,10 +42,8 @@ export declare function globalClient(): Client | null;
  * This function must be called before using any other exported functions that depend on the global client.
  * The exported convenience functions (send, request, store, etc.) use this global instance internally,
  * simplifying integration for applications that don't require multiple client instances.
- *
- * @param applicationName The name of your application - must match the 'name' property in your application's telemetry.config.json file
  */
-export declare function configure(applicationName: string): void;
+export declare function configure(_applicationName?: string): void;
 /**
  * Destroys the SDK by unbinding event listeners and clearing the global client instance.
  *

package/dist/index.js

@@ -1,8 +1,8 @@
 import { o as C, a as P, s as T, l as k } from "./types-CCzf8sMT.js";
-const M = "1.13.0", F = {
+const M = "1.13.2", F = {
   version: M
 };
-class A {
+class R {
   constructor(e) {
     this._client = e;
   }
@@ -21,7 +21,7 @@ class A {
     return e.account;
   }
 }
-class R {
+class A {
   constructor(e) {
     this._client = e;
   }
@@ -296,7 +296,7 @@ class j {
    * @returns A StoreSlice instance for the application scope
    */
   get application() {
-    return new S("application", "", this._client);
+    return new S("application", void 0, this._client);
   }
   /**
    * Provides access to the instance store scope.
@@ -305,8 +305,6 @@ class j {
    * application. This is ideal for instance-specific settings, UI state, temporary data,
    * or any information that shouldn't be shared with other instances.
    *
-   * The namespace for instance data includes both the application name and the instance ID.
-   *
    * @returns A StoreSlice instance for the instance scope
    */
   get instance() {
@@ -325,7 +323,7 @@ class j {
    * @returns A StoreSlice instance for the device scope
    */
   get device() {
-    return new S("device", this._client.applicationInstance, this._client);
+    return new S("device", this._client.deviceId, this._client);
   }
   /**
    * Provides access to the shared store scope with a specified namespace.
@@ -715,7 +713,7 @@ class V {
     }, t)).success;
   }
 }
-class W {
+class O {
   constructor(e) {
     this._originalPushState = null, this._originalReplaceState = null, this._popstateHandler = null, this._backHandler = null, this._forwardHandler = null, this._client = e;
   }
@@ -738,12 +736,12 @@ class W {
 function q(o) {
   return { ...o, type: "client" };
 }
-const G = C({
+const W = C({
   type: k("bridge"),
   name: T(),
   data: P()
 });
-class J {
+class z {
   /**
    * Creates a new RootSettingsNavigation API instance.
    *
@@ -800,23 +798,20 @@ class J {
     return (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {};
   }
 }
-const b = 1e3 * 30, E = typeof window > "u" && typeof self < "u", v = E ? self : window;
+const m = 1e3 * 30, N = typeof window > "u" && typeof self < "u", v = N ? self : window;
 function y(o) {
-  E ? self.postMessage(o) : v.parent.postMessage(o, "*");
+  N ? self.postMessage(o) : v.parent.postMessage(o, "*");
 }
-class K {
+class G {
   /**
    * Creates a new Client instance for communicating with the TelemetryOS platform.
    *
    * Note that creating a Client instance alone is not sufficient to begin communication.
    * You must also call the bind() method to initialize event listeners and extract
    * the application ID from the URL.
-   *
-   * @param applicationName The name of your application - must match the 'name' property
-   *                        in your application's telemetry.config.json file
    */
-  constructor(e) {
-    this._applicationName = e, this._applicationInstance = "", this._applicationSpecifier = "", this._navigation = new W(this), this._messageInterceptors = /* @__PURE__ */ new Map(), this._onHandlers = /* @__PURE__ */ new Map(), this._onceHandlers = /* @__PURE__ */ new Map(), this._subscriptionNamesByHandler = /* @__PURE__ */ new Map(), this._subscriptionNamesBySubjectName = /* @__PURE__ */ new Map();
+  constructor() {
+    this._applicationInstance = "", this._applicationSpecifier = "", this._deviceId = "", this._navigation = new O(this), this._messageInterceptors = /* @__PURE__ */ new Map(), this._onHandlers = /* @__PURE__ */ new Map(), this._onceHandlers = /* @__PURE__ */ new Map(), this._subscriptionNamesByHandler = /* @__PURE__ */ new Map(), this._subscriptionNamesBySubjectName = /* @__PURE__ */ new Map();
   }
   /**
    * Provides access to the accounts API for retrieving TelemetryOS account information.
@@ -830,7 +825,7 @@ class K {
    * @returns An Accounts instance bound to this client
    */
   get accounts() {
-    return new A(this);
+    return new R(this);
   }
   /**
    * Provides access to the users API for retrieving TelemetryOS user information.
@@ -872,7 +867,7 @@ class K {
    * @returns An Applications instance bound to this client
    */
   get applications() {
-    return new R(this);
+    return new A(this);
   }
   /**
    * Provides access to the media API for working with content hosted on the TelemetryOS platform.
@@ -934,7 +929,7 @@ class K {
    * @throws {Error} If used by an application not mounted at the 'rootSettingsNavigation' mount point
    */
   get rootSettingsNavigation() {
-    return new J(this.store);
+    return new z(this.store);
   }
   /**
    * Provides access to the weather API for retrieving weather data.
@@ -981,15 +976,15 @@ class K {
   get mqtt() {
     return new V(this);
   }
-  get applicationName() {
-    return this._applicationName;
-  }
   get applicationSpecifier() {
     return this._applicationSpecifier;
   }
   get applicationInstance() {
     return this._applicationInstance;
   }
+  get deviceId() {
+    return this._deviceId;
+  }
   /**
    * Initializes the client by setting up message listeners and extracting the application ID.
    *
@@ -1006,16 +1001,16 @@ class K {
    * of creating and binding their own Client instances.
    */
   bind() {
-    var e, t, s;
-    const i = new URL(v.location.href), n = i.searchParams;
-    if (this._applicationInstance = (e = n.get("applicationInstance")) !== null && e !== void 0 ? e : "", !this._applicationInstance)
-      throw new Error("Missing applicationInstance query parameter");
-    if (this._applicationSpecifier = (t = n.get("applicationSpecifier")) !== null && t !== void 0 ? t : "", !this._applicationSpecifier) {
-      const a = i.hostname.split(".");
-      this._applicationSpecifier = (s = a[0]) !== null && s !== void 0 ? s : "";
+    var e, t;
+    const s = new URL(v.location.href), i = s.searchParams;
+    this._applicationInstance = i.get("applicationInstance") || "single", this._deviceId = i.get("deviceId") || this._applicationInstance;
+    const n = /^[a-z0-9-]{40}$/i;
+    if (this._applicationSpecifier = (e = i.get("applicationSpecifier")) !== null && e !== void 0 ? e : "", !this._applicationSpecifier || !n.test(this._applicationSpecifier)) {
+      const a = s.hostname.split(".");
+      this._applicationSpecifier = (t = a[0]) !== null && t !== void 0 ? t : "";
     }
-    if (!this._applicationSpecifier || this._applicationSpecifier.length !== 40)
-      throw new Error(`Invalid applicationSpecifier: expected 40-character hash, got "${this._applicationSpecifier}"`);
+    if (!this._applicationSpecifier || !n.test(this._applicationSpecifier))
+      throw console.error("TelemetryOS apps require an applicationSpecifier in the URL query parameters or subdomain. Make sure your app is being served correctly through the TelemetryOS platform or development environment."), new Error(`Invalid applicationSpecifier: expected 40-character hash, got "${this._applicationSpecifier}"`);
     this._windowMessageHandler = (a) => {
       if (a.source === v || !a.data || typeof a.data != "object" || !("type" in a.data) || a.data.type !== "client" && a.data.type !== "bridge")
         return;
@@ -1033,7 +1028,7 @@ class K {
         };
       }
       if (!l) {
-        const c = G.safeParse(a.data);
+        const c = W.safeParse(a.data);
         if (!c.success)
           return;
         l = c.data;
@@ -1047,7 +1042,7 @@ class K {
           this._onceHandlers.delete(l.name);
         }
       }
-      if (!E)
+      if (!N)
         for (let c = 0; c < window.frames.length; c += 1)
           window.frames[c].postMessage(l, "*");
     }, v.addEventListener("message", this._windowMessageHandler), this._navigation.bind();
@@ -1083,8 +1078,7 @@ class K {
    */
   send(e, t) {
     const s = q({
-      telemetrySdkVersion: H,
-      applicationName: this._applicationName,
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
@@ -1113,9 +1107,8 @@ class K {
    */
   request(e, t, s) {
     var i;
-    const n = N(), a = q({
-      telemetrySdkVersion: H,
-      applicationName: this._applicationName,
+    const n = H(), a = q({
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
@@ -1123,19 +1116,19 @@ class K {
       responseName: n
     });
     y(a);
-    const l = (i = s == null ? void 0 : s.timeout) !== null && i !== void 0 ? i : b;
+    const l = (i = s == null ? void 0 : s.timeout) !== null && i !== void 0 ? i : m;
     let c = !1, p;
     const h = new Promise((f) => {
-      p = (_) => {
-        c || f(_);
+      p = (g) => {
+        c || f(g);
       }, this.once(n, p);
     });
     if (l === 0)
       return h;
-    const u = new Promise((f, _) => {
+    const u = new Promise((f, g) => {
       const w = new Error(`${e} message request with response name of ${n} timed out after ${l}`);
       setTimeout(() => {
-        c = !0, this.off(n, p), _(w);
+        c = !0, this.off(n, p), g(w);
       }, l);
     });
     return Promise.race([u, h]);
@@ -1143,12 +1136,11 @@ class K {
   async subscribe(e, t, s) {
     let i, n;
     typeof t == "function" ? n = t : (i = t, n = s);
-    const a = N(), l = N();
+    const a = H(), l = H();
     let c = this._subscriptionNamesBySubjectName.get(e);
     c || (c = [], this._subscriptionNamesBySubjectName.set(e, c)), c.push(a), this._subscriptionNamesByHandler.set(n, a), this.on(a, n);
     const p = q({
-      telemetrySdkVersion: H,
-      applicationName: this._applicationName,
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
@@ -1158,22 +1150,22 @@ class K {
     });
     y(p);
     let h = !1, u;
-    const f = new Promise((w, g) => {
-      const m = new Error(`${e} subscribe request with subscription name of ${a} and response name of ${l} timed out after ${b}`);
+    const f = new Promise((w, _) => {
+      const b = new Error(`${e} subscribe request with subscription name of ${a} and response name of ${l} timed out after ${m}`);
       setTimeout(() => {
-        h = !0, this.off(l, u), g(m);
-      }, b);
-    }), _ = new Promise((w) => {
-      u = (g) => {
-        h || w(g);
+        h = !0, this.off(l, u), _(b);
+      }, m);
+    }), g = new Promise((w) => {
+      u = (_) => {
+        h || w(_);
       }, this.once(l, u);
     });
-    return Promise.race([f, _]);
+    return Promise.race([f, g]);
   }
   async unsubscribe(e, t, s) {
     let i, n;
     typeof t == "function" ? n = t : (i = t, n = s);
-    const a = N();
+    const a = H();
     let l = [];
     if (n) {
       const c = this._subscriptionNamesByHandler.get(n);
@@ -1185,9 +1177,8 @@ class K {
     for await (const c of l) {
       this.off(c, n);
       const p = q({
-        telemetrySdkVersion: H,
+        telemetrySdkVersion: I,
         applicationInstance: this._applicationInstance,
-        applicationName: this._applicationName,
         applicationSpecifier: this._applicationSpecifier,
         name: e,
         data: i,
@@ -1196,17 +1187,17 @@ class K {
       });
       y(p);
       let h = !1, u;
-      const f = new Promise((g, m) => {
-        const I = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${a} timed out after ${b}`);
+      const f = new Promise((_, b) => {
+        const E = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${a} timed out after ${m}`);
         setTimeout(() => {
-          h = !0, this.off(a, u), m(I);
-        }, b);
-      }), _ = new Promise((g) => {
-        u = (m) => {
-          h || g(m);
+          h = !0, this.off(a, u), b(E);
+        }, m);
+      }), g = new Promise((_) => {
+        u = (b) => {
+          h || _(b);
         }, this.once(a, u);
       });
-      if (!(await Promise.race([f, _])).success)
+      if (!(await Promise.race([f, g])).success)
         return { success: !1 };
     }
     return { success: !0 };
@@ -1283,18 +1274,18 @@ class K {
     }
   }
 }
-function N() {
+function H() {
   return Math.random().toString(36).slice(2, 9);
 }
-const H = F.version;
+const I = F.version;
 let r = null;
-function z() {
+function X() {
   return r;
 }
-function X(o) {
-  r = new K(o), r.bind();
+function Y(o) {
+  J(), r = new G(), r.bind();
 }
-function Y() {
+function J() {
   r == null || r.unbind(), r = null;
 }
 function Z(...o) {
@@ -1345,10 +1336,10 @@ function pe() {
 function fe() {
   return d(r), r.weather;
 }
-function _e() {
+function ge() {
   return d(r), r.currency;
 }
-function ge() {
+function _e() {
   return d(r), r.environment;
 }
 function we() {
@@ -1359,15 +1350,15 @@ function d(o) {
     throw new Error("SDK is not configured");
 }
 export {
-  A as Accounts,
-  R as Applications,
-  K as Client,
+  R as Accounts,
+  A as Applications,
+  G as Client,
   U as Currency,
   B as Devices,
   $ as Environment,
   L as Media,
   V as Mqtt,
-  W as Navigation,
+  O as Navigation,
   x as Proxy,
   j as Store,
   S as StoreSlice,
@@ -1375,12 +1366,12 @@ export {
   Q as Weather,
   le as accounts,
   oe as applications,
-  X as configure,
-  _e as currency,
-  Y as destroy,
+  Y as configure,
+  ge as currency,
+  J as destroy,
   he as devices,
-  ge as environment,
-  z as globalClient,
+  _e as environment,
+  X as globalClient,
   ce as media,
   we as mqtt,
   te as off,
@@ -1392,7 +1383,7 @@ export {
   se as send,
   ae as store,
   ie as subscribe,
-  H as telemetrySdkVersion,
+  I as telemetrySdkVersion,
   re as unsubscribe,
   ue as users,
   fe as weather

package/dist/store.d.ts

@@ -19,8 +19,6 @@ export declare class Store {
      * application. This is ideal for instance-specific settings, UI state, temporary data,
      * or any information that shouldn't be shared with other instances.
      *
-     * The namespace for instance data includes both the application name and the instance ID.
-     *
      * @returns A StoreSlice instance for the instance scope
      */
     get instance(): StoreSlice;
@@ -64,9 +62,9 @@ export declare class Store {
  */
 export declare class StoreSlice {
     _kind: string;
-    _namespace: string;
+    _namespace: string | undefined;
     _client: Client;
-    constructor(kind: string, namespace: string, client: Client);
+    constructor(kind: string, namespace: string | undefined, client: Client);
     /**
      * Saves a value in the store.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetryos/root-sdk",
-  "version": "1.13.0",
+  "version": "1.13.2",
   "description": "The official TelemetryOS root application sdk package. Provides types and apis for building root TelemetryOS applications.",
   "type": "module",
   "main": "dist/index.cjs",