@telemetryos/root-sdk 1.13.0 → 1.13.1

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @telemetryos/root-sdk
 
+## 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.1",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 n;typeof e=="string"?n=e:e instanceof URL?n=e.toString():(n=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 i={};t!=null&&t.headers&&(t.headers instanceof Headers?t.headers.forEach((h,d)=>{i[d]=h}):Array.isArray(t.headers)?t.headers.forEach(([h,d])=>{i[h]=d}):i=t.headers);const a=await this._client.request("proxy.fetch",{url:n,method:(t==null?void 0:t.method)||"GET",headers:i,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 c=new Headers(a.headers),l={status:a.status,statusText:a.statusText,headers:c};let u=null;if(a.body!==null&&a.body!==void 0)if(a.bodyType==="binary"){const h=atob(a.body),d=new Uint8Array(h.length);for(let f=0;f<h.length;f++)d[f]=h.charCodeAt(f);u=d}else a.bodyType==="text"?u=a.body:a.bodyType==="json"&&(u=JSON.stringify(a.body));return new Response(u,l)}}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,n;const i=await this._client.request("currency.getRates",e);if(!i.success||!i.rates)throw((t=i.error)===null||t===void 0?void 0:t.code)===201?new Error(`Invalid base currency '${e.base}'`):((s=i.error)===null||s===void 0?void 0:s.code)===202?new Error(`Invalid target currency symbol '${e.symbols}'`):new Error(((n=i.error)===null||n===void 0?void 0:n.message)||"Failed to fetch currency rates");return i.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,n){if(!(await this._client.request("mqtt.publish",{clientId:e,topic:t,payload:s,...n})).success)throw new Error("Failed to publish MQTT message")}async subscribe(e,t,s,n){return(await this._client.subscribe("mqtt.subscribe",{clientId:e,topic:t,...n},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(o){return{...o,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"),n=(t=await s.get("navigation"))!==null&&t!==void 0?t:{},i=this._store._client._applicationSpecifier;n[i]={applicationSpecifier:i,entries:e.entries},s.set("navigation",n)}async getRootSettingsNavigation(){var e;const s=(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{},n=this._store._client._applicationSpecifier;return s[n]}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(o){C?self.postMessage(o):S.parent.postMessage(o,"*")}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),n=s.searchParams;this._applicationInstance=n.get("applicationInstance")||"single",this._deviceId=n.get("deviceId")||this._applicationInstance;const i=s.hostname.split("."),a=/^[a-f0-9]{40}$/i;if(this._applicationSpecifier=(e=n.get("applicationSpecifier"))!==null&&e!==void 0?e:"",(!this._applicationSpecifier||!a.test(this._applicationSpecifier))&&(this._applicationSpecifier=(t=i[0])!==null&&t!==void 0?t:""),!this._applicationSpecifier||!a.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=c=>{if(c.source===S||!c.data||typeof c.data!="object"||!("type"in c.data)||c.data.type!=="client"&&c.data.type!=="bridge")return;let l;if(c.data.type==="client"){const u=this._messageInterceptors.get(c.data.name);if(!u){m(c.data);return}l={...u(c.data.data),type:"bridge",...c.data.responseName?{name:c.data.responseName}:{}}}if(!l){const u=O.safeParse(c.data);if(!u.success)return;l=u.data;const h=this._onHandlers.get(l.name),d=this._onceHandlers.get(l.name);if(h)for(const f of h)f(l.data);if(d){for(const f of d)f(l.data);this._onceHandlers.delete(l.name)}}if(!C)for(let u=0;u<window.frames.length;u+=1)window.frames[u].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 n;const i=I(),a=N({telemetrySdkVersion:q,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t,responseName:i});m(a);const c=(n=s==null?void 0:s.timeout)!==null&&n!==void 0?n:y;let l=!1,u;const h=new Promise(f=>{u=g=>{l||f(g)},this.once(i,u)});if(c===0)return h;const d=new Promise((f,g)=>{const w=new Error(`${e} message request with response name of ${i} timed out after ${c}`);setTimeout(()=>{l=!0,this.off(i,u),g(w)},c)});return Promise.race([d,h])}async subscribe(e,t,s){let n,i;typeof t=="function"?i=t:(n=t,i=s);const a=I(),c=I();let l=this._subscriptionNamesBySubjectName.get(e);l||(l=[],this._subscriptionNamesBySubjectName.set(e,l)),l.push(a),this._subscriptionNamesByHandler.set(i,a),this.on(a,i);const u=N({telemetrySdkVersion:q,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:n,responseName:c,subscriptionName:a});m(u);let h=!1,d;const f=new Promise((w,_)=>{const b=new Error(`${e} subscribe request with subscription name of ${a} and response name of ${c} timed out after ${y}`);setTimeout(()=>{h=!0,this.off(c,d),_(b)},y)}),g=new Promise(w=>{d=_=>{h||w(_)},this.once(c,d)});return Promise.race([f,g])}async unsubscribe(e,t,s){let n,i;typeof t=="function"?i=t:(n=t,i=s);const a=I();let c=[];if(i){const l=this._subscriptionNamesByHandler.get(i);if(!l)return{success:!1};c=[l],this._subscriptionNamesByHandler.delete(i)}else if(!this._subscriptionNamesBySubjectName.get(e))return{success:!1};for await(const l of c){this.off(l,i);const u=N({telemetrySdkVersion:q,applicationInstance:this._applicationInstance,applicationSpecifier:this._applicationSpecifier,name:e,data:n,responseName:a,unsubscribeName:l});m(u);let h=!1,d;const f=new Promise((_,b)=>{const U=new Error(`${e} unsubscribe request with unsubscribe name of ${l} and response name of ${a} timed out after ${y}`);setTimeout(()=>{h=!0,this.off(a,d),b(U)},y)}),g=new Promise(_=>{d=b=>{h||_(b)},this.once(a,d)});if(!(await Promise.race([f,g])).success)return{success:!1}}return{success:!0}}on(e,t){var s;const n=(s=this._onHandlers.get(e))!==null&&s!==void 0?s:[];n.length===0&&this._onHandlers.set(e,n),n.push(t)}once(e,t){var s;const n=(s=this._onceHandlers.get(e))!==null&&s!==void 0?s:[];n.length===0&&this._onceHandlers.set(e,n),n.push(t)}off(e,t){const s=this._onHandlers.get(e),n=this._onceHandlers.get(e);if(!(!s&&!n)){if(s){for(let i=0;i<s.length;i+=1)t&&s[i]!==t||(s.splice(i,1),i-=1);s.length===0&&this._onHandlers.delete(e)}if(n){for(let i=0;i<n.length;i+=1)t&&n[i]!==t||(n.splice(i,1),i-=1);n.length===0&&this._onceHandlers.delete(e)}}}}function I(){return Math.random().toString(36).slice(2,9)}const q=V.version;let r=null;function G(){return r}function J(o){D(),r=new j,r.bind()}function D(){r==null||r.unbind(),r=null}function K(...o){return p(r),r.on(...o)}function z(...o){return p(r),r.once(...o)}function X(...o){return p(r),r.off(...o)}function Y(...o){return p(r),r.send(...o)}function Z(...o){return p(r),r.request(...o)}function ee(...o){return p(r),r.subscribe(...o)}function te(...o){return p(r),r.unsubscribe(...o)}function se(){return p(r),r.store}function ne(){return p(r),r.applications}function ie(){return p(r),r.media}function re(){return p(r),r.accounts}function oe(){return p(r),r.users}function ae(){return p(r),r.devices}function ce(){return p(r),r.proxy}function le(){return p(r),r.rootSettingsNavigation}function ue(){return p(r),r.weather}function he(){return p(r),r.currency}function de(){return p(r),r.environment}function pe(){return p(r),r.mqtt}function p(o){if(!o)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=J;exports.currency=he;exports.destroy=D;exports.devices=ae;exports.environment=de;exports.globalClient=G;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=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.1", 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;
   }
@@ -239,8 +239,8 @@ class x {
   }
   async fetch(e, t) {
     var s;
-    let i;
-    typeof e == "string" ? i = e : e instanceof URL ? i = e.toString() : (i = e.url, t || (t = {
+    let n;
+    typeof e == "string" ? n = e : e instanceof URL ? n = e.toString() : (n = e.url, t || (t = {
       method: e.method,
       headers: e.headers,
       body: e.body,
@@ -250,36 +250,36 @@ class x {
       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,
+    let i = {};
+    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((h, d) => {
+      i[d] = h;
+    }) : Array.isArray(t.headers) ? t.headers.forEach(([h, d]) => {
+      i[h] = d;
+    }) : i = t.headers);
+    const o = await this._client.request("proxy.fetch", {
+      url: n,
       method: (t == null ? void 0 : t.method) || "GET",
-      headers: n,
+      headers: i,
       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
+    if (!o.success)
+      throw new TypeError(o.errorMessage, {
+        cause: o.errorCause ? Error(o.errorCause) : void 0
       });
-    const l = new Headers(a.headers), c = {
-      status: a.status,
-      statusText: a.statusText,
-      headers: l
+    const c = new Headers(o.headers), l = {
+      status: o.status,
+      statusText: o.statusText,
+      headers: c
     };
-    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);
+    let u = null;
+    if (o.body !== null && o.body !== void 0)
+      if (o.bodyType === "binary") {
+        const h = atob(o.body), d = 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);
+          d[f] = h.charCodeAt(f);
+        u = d;
+      } else o.bodyType === "text" ? u = o.body : o.bodyType === "json" && (u = JSON.stringify(o.body));
+    return new Response(u, l);
   }
 }
 class j {
@@ -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.
@@ -644,11 +642,11 @@ class U {
    * ```
    */
   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;
+    var t, s, n;
+    const i = await this._client.request("currency.getRates", e);
+    if (!i.success || !i.rates)
+      throw ((t = i.error) === null || t === void 0 ? void 0 : t.code) === 201 ? new Error(`Invalid base currency '${e.base}'`) : ((s = i.error) === null || s === void 0 ? void 0 : s.code) === 202 ? new Error(`Invalid target currency symbol '${e.symbols}'`) : new Error(((n = i.error) === null || n === void 0 ? void 0 : n.message) || "Failed to fetch currency rates");
+    return i.rates;
   }
 }
 class V {
@@ -674,20 +672,20 @@ class V {
     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) {
+  async publish(e, t, s, n) {
     if (!(await this._client.request("mqtt.publish", {
       clientId: e,
       topic: t,
       payload: s,
-      ...i
+      ...n
     })).success)
       throw new Error("Failed to publish MQTT message");
   }
-  async subscribe(e, t, s, i) {
+  async subscribe(e, t, s, n) {
     return (await this._client.subscribe("mqtt.subscribe", {
       clientId: e,
       topic: t,
-      ...i
+      ...n
     }, s)).success;
   }
   async unsubscribe(e, t, s) {
@@ -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;
   }
@@ -735,15 +733,15 @@ class W {
     });
   }
 }
-function q(o) {
-  return { ...o, type: "client" };
+function q(a) {
+  return { ...a, type: "client" };
 }
-const G = C({
+const W = C({
   type: k("bridge"),
   name: T(),
   data: P()
 });
-class J {
+class G {
   /**
    * Creates a new RootSettingsNavigation API instance.
    *
@@ -767,11 +765,11 @@ class J {
    */
   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,
+    const s = this._store.shared("root-settings-navigation"), n = (t = await s.get("navigation")) !== null && t !== void 0 ? t : {}, i = this._store._client._applicationSpecifier;
+    n[i] = {
+      applicationSpecifier: i,
       entries: e.entries
-    }, s.set("navigation", i);
+    }, s.set("navigation", n);
   }
   /**
    * Retrieves the current navigation entries for this root application.
@@ -783,8 +781,8 @@ class J {
    */
   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];
+    const s = (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {}, n = this._store._client._applicationSpecifier;
+    return s[n];
   }
   /**
    * Retrieves the navigation entries for all root applications.
@@ -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;
-function y(o) {
-  E ? self.postMessage(o) : v.parent.postMessage(o, "*");
+const m = 1e3 * 30, N = typeof window > "u" && typeof self < "u", v = N ? self : window;
+function y(a) {
+  N ? self.postMessage(a) : v.parent.postMessage(a, "*");
 }
-class K {
+class J {
   /**
    * 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 G(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,50 +1001,46 @@ 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 : "";
-    }
-    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 === v || !a.data || typeof a.data != "object" || !("type" in a.data) || a.data.type !== "client" && a.data.type !== "bridge")
+    var e, t;
+    const s = new URL(v.location.href), n = s.searchParams;
+    this._applicationInstance = n.get("applicationInstance") || "single", this._deviceId = n.get("deviceId") || this._applicationInstance;
+    const i = s.hostname.split("."), o = /^[a-f0-9]{40}$/i;
+    if (this._applicationSpecifier = (e = n.get("applicationSpecifier")) !== null && e !== void 0 ? e : "", (!this._applicationSpecifier || !o.test(this._applicationSpecifier)) && (this._applicationSpecifier = (t = i[0]) !== null && t !== void 0 ? t : ""), !this._applicationSpecifier || !o.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 = (c) => {
+      if (c.source === v || !c.data || typeof c.data != "object" || !("type" in c.data) || c.data.type !== "client" && c.data.type !== "bridge")
         return;
       let l;
-      if (a.data.type === "client") {
-        const c = this._messageInterceptors.get(a.data.name);
-        if (!c) {
-          y(a.data);
+      if (c.data.type === "client") {
+        const u = this._messageInterceptors.get(c.data.name);
+        if (!u) {
+          y(c.data);
           return;
         }
         l = {
-          ...c(a.data.data),
+          ...u(c.data.data),
           type: "bridge",
-          ...a.data.responseName ? { name: a.data.responseName } : {}
+          ...c.data.responseName ? { name: c.data.responseName } : {}
         };
       }
       if (!l) {
-        const c = G.safeParse(a.data);
-        if (!c.success)
+        const u = W.safeParse(c.data);
+        if (!u.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);
+        l = u.data;
+        const h = this._onHandlers.get(l.name), d = this._onceHandlers.get(l.name);
+        if (h)
+          for (const f of h)
+            f(l.data);
+        if (d) {
+          for (const f of d)
+            f(l.data);
           this._onceHandlers.delete(l.name);
         }
       }
-      if (!E)
-        for (let c = 0; c < window.frames.length; c += 1)
-          window.frames[c].postMessage(l, "*");
+      if (!N)
+        for (let u = 0; u < window.frames.length; u += 1)
+          window.frames[u].postMessage(l, "*");
     }, v.addEventListener("message", this._windowMessageHandler), this._navigation.bind();
   }
   /**
@@ -1083,8 +1074,7 @@ class K {
    */
   send(e, t) {
     const s = q({
-      telemetrySdkVersion: H,
-      applicationName: this._applicationName,
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
@@ -1112,101 +1102,98 @@ class K {
    * @throws {Error} If the request times out
    */
   request(e, t, s) {
-    var i;
-    const n = N(), a = q({
-      telemetrySdkVersion: H,
-      applicationName: this._applicationName,
+    var n;
+    const i = H(), o = q({
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
       data: t,
-      responseName: n
+      responseName: i
     });
-    y(a);
-    const l = (i = s == null ? void 0 : s.timeout) !== null && i !== void 0 ? i : b;
-    let c = !1, p;
+    y(o);
+    const c = (n = s == null ? void 0 : s.timeout) !== null && n !== void 0 ? n : m;
+    let l = !1, u;
     const h = new Promise((f) => {
-      p = (_) => {
-        c || f(_);
-      }, this.once(n, p);
+      u = (g) => {
+        l || f(g);
+      }, this.once(i, u);
     });
-    if (l === 0)
+    if (c === 0)
       return h;
-    const u = new Promise((f, _) => {
-      const w = new Error(`${e} message request with response name of ${n} timed out after ${l}`);
+    const d = new Promise((f, g) => {
+      const w = new Error(`${e} message request with response name of ${i} timed out after ${c}`);
       setTimeout(() => {
-        c = !0, this.off(n, p), _(w);
-      }, l);
+        l = !0, this.off(i, u), g(w);
+      }, c);
     });
-    return Promise.race([u, h]);
+    return Promise.race([d, h]);
   }
   async subscribe(e, t, s) {
-    let i, n;
-    typeof t == "function" ? n = t : (i = t, n = s);
-    const a = N(), l = N();
-    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,
+    let n, i;
+    typeof t == "function" ? i = t : (n = t, i = s);
+    const o = H(), c = H();
+    let l = this._subscriptionNamesBySubjectName.get(e);
+    l || (l = [], this._subscriptionNamesBySubjectName.set(e, l)), l.push(o), this._subscriptionNamesByHandler.set(i, o), this.on(o, i);
+    const u = q({
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
-      data: i,
-      responseName: l,
-      subscriptionName: a
+      data: n,
+      responseName: c,
+      subscriptionName: o
     });
-    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}`);
+    y(u);
+    let h = !1, d;
+    const f = new Promise((w, _) => {
+      const b = new Error(`${e} subscribe request with subscription name of ${o} and response name of ${c} timed out after ${m}`);
       setTimeout(() => {
-        h = !0, this.off(l, u), g(m);
-      }, b);
-    }), _ = new Promise((w) => {
-      u = (g) => {
-        h || w(g);
-      }, this.once(l, u);
+        h = !0, this.off(c, d), _(b);
+      }, m);
+    }), g = new Promise((w) => {
+      d = (_) => {
+        h || w(_);
+      }, this.once(c, d);
     });
-    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();
-    let l = [];
-    if (n) {
-      const c = this._subscriptionNamesByHandler.get(n);
-      if (!c)
+    let n, i;
+    typeof t == "function" ? i = t : (n = t, i = s);
+    const o = H();
+    let c = [];
+    if (i) {
+      const l = this._subscriptionNamesByHandler.get(i);
+      if (!l)
         return { success: !1 };
-      l = [c], this._subscriptionNamesByHandler.delete(n);
+      c = [l], this._subscriptionNamesByHandler.delete(i);
     } else if (!this._subscriptionNamesBySubjectName.get(e))
       return { success: !1 };
-    for await (const c of l) {
-      this.off(c, n);
-      const p = q({
-        telemetrySdkVersion: H,
+    for await (const l of c) {
+      this.off(l, i);
+      const u = q({
+        telemetrySdkVersion: I,
         applicationInstance: this._applicationInstance,
-        applicationName: this._applicationName,
         applicationSpecifier: this._applicationSpecifier,
         name: e,
-        data: i,
-        responseName: a,
-        unsubscribeName: c
+        data: n,
+        responseName: o,
+        unsubscribeName: l
       });
-      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}`);
+      y(u);
+      let h = !1, d;
+      const f = new Promise((_, b) => {
+        const E = new Error(`${e} unsubscribe request with unsubscribe name of ${l} and response name of ${o} timed out after ${m}`);
         setTimeout(() => {
-          h = !0, this.off(a, u), m(I);
-        }, b);
-      }), _ = new Promise((g) => {
-        u = (m) => {
-          h || g(m);
-        }, this.once(a, u);
+          h = !0, this.off(o, d), b(E);
+        }, m);
+      }), g = new Promise((_) => {
+        d = (b) => {
+          h || _(b);
+        }, this.once(o, d);
       });
-      if (!(await Promise.race([f, _])).success)
+      if (!(await Promise.race([f, g])).success)
         return { success: !1 };
     }
     return { success: !0 };
@@ -1230,8 +1217,8 @@ class K {
    */
   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);
+    const n = (s = this._onHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    n.length === 0 && this._onHandlers.set(e, n), n.push(t);
   }
   /**
    * Registers a one-time handler for a specific message type.
@@ -1249,8 +1236,8 @@ class K {
    */
   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);
+    const n = (s = this._onceHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    n.length === 0 && this._onceHandlers.set(e, n), n.push(t);
   }
   /**
    * Removes previously registered message handlers.
@@ -1268,106 +1255,106 @@ class K {
    *                all handlers for this message type will be removed.
    */
   off(e, t) {
-    const s = this._onHandlers.get(e), i = this._onceHandlers.get(e);
-    if (!(!s && !i)) {
+    const s = this._onHandlers.get(e), n = this._onceHandlers.get(e);
+    if (!(!s && !n)) {
       if (s) {
-        for (let n = 0; n < s.length; n += 1)
-          t && s[n] !== t || (s.splice(n, 1), n -= 1);
+        for (let i = 0; i < s.length; i += 1)
+          t && s[i] !== t || (s.splice(i, 1), i -= 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);
+      if (n) {
+        for (let i = 0; i < n.length; i += 1)
+          t && n[i] !== t || (n.splice(i, 1), i -= 1);
+        n.length === 0 && this._onceHandlers.delete(e);
       }
     }
   }
 }
-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(a) {
+  K(), r = new J(), r.bind();
 }
-function Y() {
+function K() {
   r == null || r.unbind(), r = null;
 }
-function Z(...o) {
-  return d(r), r.on(...o);
+function Z(...a) {
+  return p(r), r.on(...a);
 }
-function ee(...o) {
-  return d(r), r.once(...o);
+function ee(...a) {
+  return p(r), r.once(...a);
 }
-function te(...o) {
-  return d(r), r.off(...o);
+function te(...a) {
+  return p(r), r.off(...a);
 }
-function se(...o) {
-  return d(r), r.send(...o);
+function se(...a) {
+  return p(r), r.send(...a);
 }
-function ne(...o) {
-  return d(r), r.request(...o);
+function ne(...a) {
+  return p(r), r.request(...a);
 }
-function ie(...o) {
-  return d(r), r.subscribe(...o);
+function ie(...a) {
+  return p(r), r.subscribe(...a);
 }
-function re(...o) {
-  return d(r), r.unsubscribe(...o);
+function re(...a) {
+  return p(r), r.unsubscribe(...a);
 }
 function ae() {
-  return d(r), r.store;
+  return p(r), r.store;
 }
 function oe() {
-  return d(r), r.applications;
+  return p(r), r.applications;
 }
 function ce() {
-  return d(r), r.media;
+  return p(r), r.media;
 }
 function le() {
-  return d(r), r.accounts;
+  return p(r), r.accounts;
 }
 function ue() {
-  return d(r), r.users;
+  return p(r), r.users;
 }
 function he() {
-  return d(r), r.devices;
+  return p(r), r.devices;
 }
 function de() {
-  return d(r), r.proxy;
+  return p(r), r.proxy;
 }
 function pe() {
-  return d(r), r.rootSettingsNavigation;
+  return p(r), r.rootSettingsNavigation;
 }
 function fe() {
-  return d(r), r.weather;
-}
-function _e() {
-  return d(r), r.currency;
+  return p(r), r.weather;
 }
 function ge() {
-  return d(r), r.environment;
+  return p(r), r.currency;
+}
+function _e() {
+  return p(r), r.environment;
 }
 function we() {
-  return d(r), r.mqtt;
+  return p(r), r.mqtt;
 }
-function d(o) {
-  if (!o)
+function p(a) {
+  if (!a)
     throw new Error("SDK is not configured");
 }
 export {
-  A as Accounts,
-  R as Applications,
-  K as Client,
+  R as Accounts,
+  A as Applications,
+  J 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 +1362,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,
+  K 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 +1379,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.1",
   "description": "The official TelemetryOS root application sdk package. Provides types and apis for building root TelemetryOS applications.",
   "type": "module",
   "main": "dist/index.cjs",