@telemetryos/root-sdk 1.12.0 → 1.13.1

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # @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
+
+- ### New Features
+  - **Web mount point support** — Applications can now define a third UI surface (`/web`) alongside Render and Settings, enabling web-portal-style interfaces with full navigation control via a postMessage bridge.
+  - **`playlist.getDuration()`** — New async method returns the playlist-configured page duration in seconds.
+  - **Custom logo support** — Projects can specify a `logoPath` in `telemetry.config.json` for branding in the dev host.
+  - **`tos claude-code` command** — New CLI command to apply or update Claude Code skills and settings in existing projects.
+  - **Web project template** — New `vite-react-typescript-web` template scaffolds a project with all three mount points pre-configured.
+
+  ### Bug Fixes
+  - Fixed SDK client not properly validating bridge message responses.
+  - Fixed canvas not resizing when the sidebar toggles or window resizes after a manual drag-resize.
+  - Fixed `isLoading` usage and `useEffect` dependency arrays in Claude Code skill examples.
+  - Fixed stale active tab when the tabs array changes in the dev host.
+
+  ### Infrastructure
+  - Renamed `generate-application` to `create-project`; extracted shared template utilities.
+  - Added unit tests for Navigation, Currency, and Weather classes.
+
 ## 1.12.0
 
 ### Minor Changes

package/README.md

@@ -301,6 +301,74 @@ const blob = await response.blob();
 const imageUrl = URL.createObjectURL(blob);
 ```
 
+### Weather API
+
+Access weather data including current conditions, forecasts, and alerts. Weather data is sourced from WeatherBit and uses city IDs for location lookup.
+
+```javascript
+import { weather } from '@telemetryos/root-sdk';
+
+// Search for cities to get a cityId
+const cities = await weather().getCities({ search: 'New York', countryCode: 'US' });
+const cityId = cities[0].cityId;
+
+// Get current weather conditions
+const conditions = await weather().getConditions({ cityId });
+console.log(`${conditions.temperatureC}°C / ${conditions.temperatureF}°F`);
+console.log(`Wind: ${conditions.windSpeedKph} kph`);
+console.log(`Humidity: ${conditions.humidity}%`);
+
+// Get daily forecast (up to 16 days)
+const daily = await weather().getDailyForecast({ cityId, days: 7 });
+daily.data.forEach(day => {
+  console.log(`${day.forecastDate}: ${day.weatherDescription}`);
+  console.log(`High: ${day.maxTemperatureC}°C, Low: ${day.minTemperatureC}°C`);
+});
+
+// Get hourly forecast (up to 120 hours)
+const hourly = await weather().getHourlyForecast({ cityId, hours: 24 });
+hourly.data.forEach(hour => {
+  console.log(`${hour.forecastTimeLocal}: ${hour.temperatureC}°C`);
+});
+
+// Get weather alerts
+const alerts = await weather().getAlerts({ cityId });
+alerts.alerts.forEach(alert => {
+  console.log(`${alert.severity}: ${alert.title}`);
+});
+```
+
+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:
+
+```javascript
+import { currency } from '@telemetryos/root-sdk';
+
+// Get all available currency symbols
+const symbols = await currency().getSymbols();
+// { "USD": "United States Dollar", "EUR": "Euro", ... }
+
+// Get exchange rates for a base currency
+const rates = await currency().getRates({
+  base: 'USD',
+  symbols: 'EUR,GBP,JPY'
+});
+// { "EUR": 0.92, "GBP": 0.79, "JPY": 149.50 }
+```
+
 ## Communication Patterns
 
 The SDK uses a request-response pattern for most operations. All requests have a 30-second timeout by default to prevent hanging promises:

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

@@ -10,6 +10,7 @@ import { Weather } from './weather.js';
 import { Currency } from './currency.js';
 import { Environment } from './environment.js';
 import { Mqtt } from './mqtt.js';
+import { Navigation } from './navigation.js';
 import { BridgeMessage } from './bridge.js';
 /**
  * The maximum time in milliseconds to wait for a response to a request call.
@@ -75,9 +76,10 @@ 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>[]>;
     _onceHandlers: Map<string, MessageHandler<any>[]>;
@@ -90,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.
      *
@@ -234,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/currency.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("./types-mYnxD5LM.cjs"),Q="1.12.0",U={version:Q};class T{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 M{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 H{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 P{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 F{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 k{constructor(e){this._client=e}async fetch(e,t){var s;let r;typeof e=="string"?r=e:e instanceof URL?r=e.toString():(r=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,l)=>{n[l]=h}):Array.isArray(t.headers)?t.headers.forEach(([h,l])=>{n[h]=l}):n=t.headers);const o=await this._client.request("proxy.fetch",{url:r,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 u=new Headers(o.headers),a={status:o.status,statusText:o.statusText,headers:u};let p=null;if(o.body!==null&&o.body!==void 0)if(o.bodyType==="binary"){const h=atob(o.body),l=new Uint8Array(h.length);for(let f=0;f<h.length;f++)l[f]=h.charCodeAt(f);p=l}else o.bodyType==="text"?p=o.body:o.bodyType==="json"&&(p=JSON.stringify(o.body));return new Response(p,a)}}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 B{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 ${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 R{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,r;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(((r=n.error)===null||r===void 0?void 0:r.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,r){if(!(await this._client.request("mqtt.publish",{clientId:e,topic:t,payload:s,...r})).success)throw new Error("Failed to publish MQTT message")}async subscribe(e,t,s,r){return(await this._client.subscribe("mqtt.subscribe",{clientId:e,topic:t,...r},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}}function E(c){return{...c,type:"client"}}const V=N.objectType({type:N.literalType("bridge"),name:N.stringType(),data:N.anyType()});class L{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"),r=(t=await s.get("navigation"))!==null&&t!==void 0?t:{},n=this._store._client._applicationSpecifier;r[n]={applicationSpecifier:n,entries:e.entries},s.set("navigation",r)}async getRootSettingsNavigation(){var e;const s=(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{},r=this._store._client._applicationSpecifier;return s[r]}async getAllRootSettingsNavigation(){var e;return(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{}}}const b=1e3*30,C=typeof window>"u"&&typeof self<"u",S=C?self:window;function y(c){C?self.postMessage(c):S.parent.postMessage(c,"*")}class j{constructor(e){this._applicationName=e,this._applicationInstance="",this._applicationSpecifier="",this._messageInterceptors=new Map,this._onHandlers=new Map,this._onceHandlers=new Map,this._subscriptionNamesByHandler=new Map,this._subscriptionNamesBySubjectName=new Map}get accounts(){return new T(this)}get users(){return new B(this)}get store(){return new A(this)}get applications(){return new M(this)}get media(){return new F(this)}get proxy(){return new k(this)}get devices(){return new H(this)}get rootSettingsNavigation(){return new L(this.store)}get weather(){return new $(this)}get currency(){return new R(this)}get environment(){return new P(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 r=new URL(S.location.href),n=r.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 o=r.hostname.split(".");this._applicationSpecifier=(s=o[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=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 u;if(o.data.type==="client"){const a=this._messageInterceptors.get(o.data.name);if(!a){y(o.data);return}u={...a(o.data.data),type:"bridge"}}if(!u){const a=V.safeParse(o.data);if(!a.success)return;u=a.data;const p=this._onHandlers.get(u.name),h=this._onceHandlers.get(u.name);if(p)for(const l of p)l(u.data);if(h){for(const l of h)l(u.data);this._onceHandlers.delete(u.name)}}if(!C)for(let a=0;a<window.frames.length;a+=1)window.frames[a].postMessage(u,"*")},S.addEventListener("message",this._windowMessageHandler)}unbind(){this._windowMessageHandler&&S.removeEventListener("message",this._windowMessageHandler)}send(e,t){const s=E({telemetrySdkVersion:q,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t});y(s)}request(e,t,s){var r;const n=I(),o=E({telemetrySdkVersion:q,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t,responseName:n});y(o);const u=(r=s==null?void 0:s.timeout)!==null&&r!==void 0?r:b;let a=!1,p;const h=new Promise(f=>{p=g=>{a||f(g)},this.once(n,p)});if(u===0)return h;const l=new Promise((f,g)=>{const w=new Error(`${e} message request with response name of ${n} timed out after ${u}`);setTimeout(()=>{a=!0,this.off(n,p),g(w)},u)});return Promise.race([l,h])}async subscribe(e,t,s){let r,n;typeof t=="function"?n=t:(r=t,n=s);const o=I(),u=I();let a=this._subscriptionNamesBySubjectName.get(e);a||(a=[],this._subscriptionNamesBySubjectName.set(e,a)),a.push(o),this._subscriptionNamesByHandler.set(n,o),this.on(o,n);const p=E({telemetrySdkVersion:q,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:r,responseName:u,subscriptionName:o});y(p);let h=!1,l;const f=new Promise((w,m)=>{const _=new Error(`${e} subscribe request with subscription name of ${o} and response name of ${u} timed out after ${b}`);setTimeout(()=>{h=!0,this.off(u,l),m(_)},b)}),g=new Promise(w=>{l=m=>{h||w(m)},this.once(u,l)});return Promise.race([f,g])}async unsubscribe(e,t,s){let r,n;typeof t=="function"?n=t:(r=t,n=s);const o=I();let u=[];if(n){const a=this._subscriptionNamesByHandler.get(n);if(!a)return{success:!1};u=[a],this._subscriptionNamesByHandler.delete(n)}else if(!this._subscriptionNamesBySubjectName.get(e))return{success:!1};for await(const a of u){this.off(a,n);const p=E({telemetrySdkVersion:q,applicationInstance:this._applicationInstance,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,name:e,data:r,responseName:o,unsubscribeName:a});y(p);let h=!1,l;const f=new Promise((m,_)=>{const D=new Error(`${e} unsubscribe request with unsubscribe name of ${a} and response name of ${o} timed out after ${b}`);setTimeout(()=>{h=!0,this.off(o,l),_(D)},b)}),g=new Promise(m=>{l=_=>{h||m(_)},this.once(o,l)});if(!(await Promise.race([f,g])).success)return{success:!1}}return{success:!0}}on(e,t){var s;const r=(s=this._onHandlers.get(e))!==null&&s!==void 0?s:[];r.length===0&&this._onHandlers.set(e,r),r.push(t)}once(e,t){var s;const r=(s=this._onceHandlers.get(e))!==null&&s!==void 0?s:[];r.length===0&&this._onceHandlers.set(e,r),r.push(t)}off(e,t){const s=this._onHandlers.get(e),r=this._onceHandlers.get(e);if(!(!s&&!r)){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(r){for(let n=0;n<r.length;n+=1)t&&r[n]!==t||(r.splice(n,1),n-=1);r.length===0&&this._onceHandlers.delete(e)}}}}function I(){return Math.random().toString(36).slice(2,9)}const q=U.version;let i=null;function W(){return i}function O(c){i=new j(c),i.bind()}function G(){i==null||i.unbind(),i=null}function J(...c){return d(i),i.on(...c)}function K(...c){return d(i),i.once(...c)}function z(...c){return d(i),i.off(...c)}function X(...c){return d(i),i.send(...c)}function Y(...c){return d(i),i.request(...c)}function Z(...c){return d(i),i.subscribe(...c)}function ee(...c){return d(i),i.unsubscribe(...c)}function te(){return d(i),i.store}function se(){return d(i),i.applications}function ne(){return d(i),i.media}function re(){return d(i),i.accounts}function ie(){return d(i),i.users}function oe(){return d(i),i.devices}function ce(){return d(i),i.proxy}function ae(){return d(i),i.rootSettingsNavigation}function ue(){return d(i),i.weather}function le(){return d(i),i.currency}function he(){return d(i),i.environment}function de(){return d(i),i.mqtt}function d(c){if(!c)throw new Error("SDK is not configured")}exports.Accounts=T;exports.Applications=M;exports.Client=j;exports.Currency=R;exports.Devices=H;exports.Environment=P;exports.Media=F;exports.Mqtt=x;exports.Proxy=k;exports.Store=A;exports.StoreSlice=v;exports.Users=B;exports.Weather=$;exports.accounts=re;exports.applications=se;exports.configure=O;exports.currency=le;exports.destroy=G;exports.devices=oe;exports.environment=he;exports.globalClient=W;exports.media=ne;exports.mqtt=de;exports.off=z;exports.on=J;exports.once=K;exports.proxy=ce;exports.request=Y;exports.rootSettingsNavigation=ae;exports.send=X;exports.store=te;exports.subscribe=Z;exports.telemetrySdkVersion=q;exports.unsubscribe=ee;exports.users=ie;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

@@ -12,6 +12,7 @@ export type { CitiesSearchParams, DailyForecast, DailyForecastData, DailyForecas
 export { Currency } from './currency.js';
 export type { CurrencySymbols, CurrencyRates, CurrencyRatesParams } from './currency.js';
 export { Mqtt } from './mqtt.js';
+export { Navigation } from './navigation.js';
 export type { MqttBrokerInfo, MqttConnectOptions, MqttPublishOptions, MqttSubscribeOptions, MqttConnectionStatus, MqttMessage, } from './mqtt.js';
 import { Client } from './client.js';
 export { Client, type SubscriptionResult, type MessageHandler } from './client.js';
@@ -41,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 H, s as M, l as P } from "./types-CCzf8sMT.js";
-const F = "1.12.0", k = {
-  version: F
+import { o as C, a as P, s as T, l as k } from "./types-CCzf8sMT.js";
+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 B {
+class A {
   constructor(e) {
     this._client = e;
   }
@@ -116,7 +116,7 @@ class B {
     this._client._messageInterceptors.set(e, t);
   }
 }
-class $ {
+class B {
   constructor(e) {
     this._client = e;
   }
@@ -160,7 +160,7 @@ class $ {
     return e.capabilities;
   }
 }
-class R {
+class $ {
   constructor(e) {
     this._client = e;
   }
@@ -174,7 +174,7 @@ class R {
     return (await this._client.unsubscribe("environment.unsubscribeColorScheme", {}, e)).success;
   }
 }
-class x {
+class L {
   constructor(e) {
     this._client = e;
   }
@@ -233,14 +233,14 @@ class x {
     })).selection;
   }
 }
-class j {
+class x {
   constructor(e) {
     this._client = e;
   }
   async fetch(e, t) {
     var s;
-    let r;
-    typeof e == "string" ? r = e : e instanceof URL ? r = e.toString() : (r = 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,39 +250,39 @@ class j {
       referrer: e.referrer,
       integrity: e.integrity
     }));
-    let n = {};
-    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((h, l) => {
-      n[l] = h;
-    }) : Array.isArray(t.headers) ? t.headers.forEach(([h, l]) => {
-      n[h] = l;
-    }) : n = t.headers);
+    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: r,
+      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 (!o.success)
       throw new TypeError(o.errorMessage, {
         cause: o.errorCause ? Error(o.errorCause) : void 0
       });
-    const u = new Headers(o.headers), a = {
+    const c = new Headers(o.headers), l = {
       status: o.status,
       statusText: o.statusText,
-      headers: u
+      headers: c
     };
-    let p = null;
+    let u = null;
     if (o.body !== null && o.body !== void 0)
       if (o.bodyType === "binary") {
-        const h = atob(o.body), l = new Uint8Array(h.length);
+        const h = atob(o.body), d = new Uint8Array(h.length);
         for (let f = 0; f < h.length; f++)
-          l[f] = h.charCodeAt(f);
-        p = l;
-      } else o.bodyType === "text" ? p = o.body : o.bodyType === "json" && (p = JSON.stringify(o.body));
-    return new Response(p, a);
+          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 D {
+class j {
   constructor(e) {
     this._client = e;
   }
@@ -296,7 +296,7 @@ class D {
    * @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 D {
    * 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 D {
    * @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.
@@ -438,7 +436,7 @@ class S {
     })).success;
   }
 }
-class Q {
+class D {
   constructor(e) {
     this._client = e;
   }
@@ -461,7 +459,7 @@ class Q {
     return e.user;
   }
 }
-class L {
+class Q {
   constructor(e) {
     this._client = e;
   }
@@ -644,11 +642,11 @@ class U {
    * ```
    */
   async getRates(e) {
-    var t, s, r;
-    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(((r = n.error) === null || r === void 0 ? void 0 : r.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, r) {
+  async publish(e, t, s, n) {
     if (!(await this._client.request("mqtt.publish", {
       clientId: e,
       topic: t,
       payload: s,
-      ...r
+      ...n
     })).success)
       throw new Error("Failed to publish MQTT message");
   }
-  async subscribe(e, t, s, r) {
+  async subscribe(e, t, s, n) {
     return (await this._client.subscribe("mqtt.subscribe", {
       clientId: e,
       topic: t,
-      ...r
+      ...n
     }, s)).success;
   }
   async unsubscribe(e, t, s) {
@@ -715,13 +713,33 @@ class V {
     }, t)).success;
   }
 }
-function q(c) {
-  return { ...c, type: "client" };
+class O {
+  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 q(a) {
+  return { ...a, type: "client" };
 }
 const W = C({
-  type: P("bridge"),
-  name: M(),
-  data: H()
+  type: k("bridge"),
+  name: T(),
+  data: P()
 });
 class G {
   /**
@@ -747,11 +765,11 @@ class G {
    */
   async setRootSettingsNavigation(e) {
     var t;
-    const s = this._store.shared("root-settings-navigation"), r = (t = await s.get("navigation")) !== null && t !== void 0 ? t : {}, n = this._store._client._applicationSpecifier;
-    r[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", r);
+    }, s.set("navigation", n);
   }
   /**
    * Retrieves the current navigation entries for this root application.
@@ -763,8 +781,8 @@ class G {
    */
   async getRootSettingsNavigation() {
     var e;
-    const s = (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {}, r = this._store._client._applicationSpecifier;
-    return s[r];
+    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.
@@ -780,9 +798,9 @@ class G {
     return (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {};
   }
 }
-const b = 1e3 * 30, I = typeof window > "u" && typeof self < "u", v = I ? self : window;
-function y(c) {
-  I ? self.postMessage(c) : v.parent.postMessage(c, "*");
+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 J {
   /**
@@ -791,12 +809,9 @@ class J {
    * 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._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.
@@ -810,7 +825,7 @@ class J {
    * @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.
@@ -824,7 +839,7 @@ class J {
    * @returns A Users instance bound to this client
    */
   get users() {
-    return new Q(this);
+    return new D(this);
   }
   /**
    * Provides access to the store API for data persistence with multiple storage scopes.
@@ -838,7 +853,7 @@ class J {
    * @returns A Store instance bound to this client
    */
   get store() {
-    return new D(this);
+    return new j(this);
   }
   /**
    * Provides access to the applications API for discovering other TelemetryOS applications.
@@ -852,7 +867,7 @@ class J {
    * @returns An Applications instance bound to this client
    */
   get applications() {
-    return new B(this);
+    return new A(this);
   }
   /**
    * Provides access to the media API for working with content hosted on the TelemetryOS platform.
@@ -867,7 +882,7 @@ class J {
    * @returns A Media instance bound to this client
    */
   get media() {
-    return new x(this);
+    return new L(this);
   }
   /**
    * Provides access to the proxy API for fetching third-party content through the TelemetryOS API.
@@ -881,7 +896,7 @@ class J {
    * @returns A Proxy instance bound to this client
    */
   get proxy() {
-    return new j(this);
+    return new x(this);
   }
   /**
    * Provides access to the devices API for interacting with the current device.
@@ -896,7 +911,7 @@ class J {
    * @returns A Devices instance bound to this client
    */
   get devices() {
-    return new $(this);
+    return new B(this);
   }
   /**
    * Provides access to the root settings navigation API for TelemetryOS administration UI integration.
@@ -928,7 +943,7 @@ class J {
    * @returns A Weather instance bound to this client
    */
   get weather() {
-    return new L(this);
+    return new Q(this);
   }
   /**
    * Provides access to the currency API for retrieving currency exchange rates.
@@ -956,20 +971,20 @@ class J {
    * @returns An Environment instance bound to this client
    */
   get environment() {
-    return new R(this);
+    return new $(this);
   }
   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.
    *
@@ -986,47 +1001,47 @@ class J {
    * of creating and binding their own Client instances.
    */
   bind() {
-    var e, t, s;
-    const r = new URL(v.location.href), n = r.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 o = r.hostname.split(".");
-      this._applicationSpecifier = (s = o[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 = (o) => {
-      if (o.source === v || !o.data || typeof o.data != "object" || !("type" in o.data) || o.data.type !== "client" && o.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 u;
-      if (o.data.type === "client") {
-        const a = this._messageInterceptors.get(o.data.name);
-        if (!a) {
-          y(o.data);
+      let l;
+      if (c.data.type === "client") {
+        const u = this._messageInterceptors.get(c.data.name);
+        if (!u) {
+          y(c.data);
           return;
         }
-        u = { ...a(o.data.data), type: "bridge" };
+        l = {
+          ...u(c.data.data),
+          type: "bridge",
+          ...c.data.responseName ? { name: c.data.responseName } : {}
+        };
       }
-      if (!u) {
-        const a = W.safeParse(o.data);
-        if (!a.success)
+      if (!l) {
+        const u = W.safeParse(c.data);
+        if (!u.success)
           return;
-        u = a.data;
-        const p = this._onHandlers.get(u.name), h = this._onceHandlers.get(u.name);
-        if (p)
-          for (const l of p)
-            l(u.data);
-        if (h) {
-          for (const l of h)
-            l(u.data);
-          this._onceHandlers.delete(u.name);
+        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 (!I)
-        for (let a = 0; a < window.frames.length; a += 1)
-          window.frames[a].postMessage(u, "*");
-    }, v.addEventListener("message", this._windowMessageHandler);
+      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();
   }
   /**
    * Removes the message event listener and cleans up resources.
@@ -1042,7 +1057,7 @@ class J {
    * of managing their own Client instances.
    */
   unbind() {
-    this._windowMessageHandler && v.removeEventListener("message", this._windowMessageHandler);
+    this._windowMessageHandler && (this._navigation.unbind(), v.removeEventListener("message", this._windowMessageHandler));
   }
   /**
    * Sends a one-way message to the TelemetryOS platform.
@@ -1059,8 +1074,7 @@ class J {
    */
   send(e, t) {
     const s = q({
-      telemetrySdkVersion: E,
-      applicationName: this._applicationName,
+      telemetrySdkVersion: I,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
@@ -1088,99 +1102,96 @@ class J {
    * @throws {Error} If the request times out
    */
   request(e, t, s) {
-    var r;
-    const n = N(), o = q({
-      telemetrySdkVersion: E,
-      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(o);
-    const u = (r = s == null ? void 0 : s.timeout) !== null && r !== void 0 ? r : b;
-    let a = !1, p;
+    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 = (g) => {
-        a || f(g);
-      }, this.once(n, p);
+      u = (g) => {
+        l || f(g);
+      }, this.once(i, u);
     });
-    if (u === 0)
+    if (c === 0)
       return h;
-    const l = new Promise((f, g) => {
-      const m = new Error(`${e} message request with response name of ${n} timed out after ${u}`);
+    const d = new Promise((f, g) => {
+      const w = new Error(`${e} message request with response name of ${i} timed out after ${c}`);
       setTimeout(() => {
-        a = !0, this.off(n, p), g(m);
-      }, u);
+        l = !0, this.off(i, u), g(w);
+      }, c);
     });
-    return Promise.race([l, h]);
+    return Promise.race([d, h]);
   }
   async subscribe(e, t, s) {
-    let r, n;
-    typeof t == "function" ? n = t : (r = t, n = s);
-    const o = N(), u = N();
-    let a = this._subscriptionNamesBySubjectName.get(e);
-    a || (a = [], this._subscriptionNamesBySubjectName.set(e, a)), a.push(o), this._subscriptionNamesByHandler.set(n, o), this.on(o, n);
-    const p = q({
-      telemetrySdkVersion: E,
-      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: r,
-      responseName: u,
+      data: n,
+      responseName: c,
       subscriptionName: o
     });
-    y(p);
-    let h = !1, l;
-    const f = new Promise((m, w) => {
-      const _ = new Error(`${e} subscribe request with subscription name of ${o} and response name of ${u} 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(u, l), w(_);
-      }, b);
-    }), g = new Promise((m) => {
-      l = (w) => {
-        h || m(w);
-      }, this.once(u, l);
+        h = !0, this.off(c, d), _(b);
+      }, m);
+    }), g = new Promise((w) => {
+      d = (_) => {
+        h || w(_);
+      }, this.once(c, d);
     });
     return Promise.race([f, g]);
   }
   async unsubscribe(e, t, s) {
-    let r, n;
-    typeof t == "function" ? n = t : (r = t, n = s);
-    const o = N();
-    let u = [];
-    if (n) {
-      const a = this._subscriptionNamesByHandler.get(n);
-      if (!a)
+    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 };
-      u = [a], this._subscriptionNamesByHandler.delete(n);
+      c = [l], this._subscriptionNamesByHandler.delete(i);
     } else if (!this._subscriptionNamesBySubjectName.get(e))
       return { success: !1 };
-    for await (const a of u) {
-      this.off(a, n);
-      const p = q({
-        telemetrySdkVersion: E,
+    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: r,
+        data: n,
         responseName: o,
-        unsubscribeName: a
+        unsubscribeName: l
       });
-      y(p);
-      let h = !1, l;
-      const f = new Promise((w, _) => {
-        const T = new Error(`${e} unsubscribe request with unsubscribe name of ${a} and response name of ${o} 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(o, l), _(T);
-        }, b);
-      }), g = new Promise((w) => {
-        l = (_) => {
-          h || w(_);
-        }, this.once(o, l);
+          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, g])).success)
         return { success: !1 };
@@ -1206,8 +1217,8 @@ class J {
    */
   on(e, t) {
     var s;
-    const r = (s = this._onHandlers.get(e)) !== null && s !== void 0 ? s : [];
-    r.length === 0 && this._onHandlers.set(e, r), r.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.
@@ -1225,8 +1236,8 @@ class J {
    */
   once(e, t) {
     var s;
-    const r = (s = this._onceHandlers.get(e)) !== null && s !== void 0 ? s : [];
-    r.length === 0 && this._onceHandlers.set(e, r), r.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.
@@ -1244,131 +1255,132 @@ class J {
    *                all handlers for this message type will be removed.
    */
   off(e, t) {
-    const s = this._onHandlers.get(e), r = this._onceHandlers.get(e);
-    if (!(!s && !r)) {
+    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 (r) {
-        for (let n = 0; n < r.length; n += 1)
-          t && r[n] !== t || (r.splice(n, 1), n -= 1);
-        r.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 E = k.version;
-let i = null;
-function O() {
-  return i;
+const I = F.version;
+let r = null;
+function X() {
+  return r;
 }
-function z(c) {
-  i = new J(c), i.bind();
+function Y(a) {
+  K(), r = new J(), r.bind();
 }
-function X() {
-  i == null || i.unbind(), i = null;
+function K() {
+  r == null || r.unbind(), r = null;
 }
-function Y(...c) {
-  return d(i), i.on(...c);
+function Z(...a) {
+  return p(r), r.on(...a);
 }
-function Z(...c) {
-  return d(i), i.once(...c);
+function ee(...a) {
+  return p(r), r.once(...a);
 }
-function ee(...c) {
-  return d(i), i.off(...c);
+function te(...a) {
+  return p(r), r.off(...a);
 }
-function te(...c) {
-  return d(i), i.send(...c);
+function se(...a) {
+  return p(r), r.send(...a);
 }
-function se(...c) {
-  return d(i), i.request(...c);
+function ne(...a) {
+  return p(r), r.request(...a);
 }
-function ne(...c) {
-  return d(i), i.subscribe(...c);
+function ie(...a) {
+  return p(r), r.subscribe(...a);
 }
-function re(...c) {
-  return d(i), i.unsubscribe(...c);
+function re(...a) {
+  return p(r), r.unsubscribe(...a);
 }
-function ie() {
-  return d(i), i.store;
+function ae() {
+  return p(r), r.store;
 }
 function oe() {
-  return d(i), i.applications;
+  return p(r), r.applications;
 }
 function ce() {
-  return d(i), i.media;
+  return p(r), r.media;
 }
-function ae() {
-  return d(i), i.accounts;
+function le() {
+  return p(r), r.accounts;
 }
 function ue() {
-  return d(i), i.users;
-}
-function le() {
-  return d(i), i.devices;
+  return p(r), r.users;
 }
 function he() {
-  return d(i), i.proxy;
+  return p(r), r.devices;
 }
 function de() {
-  return d(i), i.rootSettingsNavigation;
+  return p(r), r.proxy;
 }
 function pe() {
-  return d(i), i.weather;
+  return p(r), r.rootSettingsNavigation;
 }
 function fe() {
-  return d(i), i.currency;
+  return p(r), r.weather;
 }
 function ge() {
-  return d(i), i.environment;
+  return p(r), r.currency;
+}
+function _e() {
+  return p(r), r.environment;
 }
 function we() {
-  return d(i), i.mqtt;
+  return p(r), r.mqtt;
 }
-function d(c) {
-  if (!c)
+function p(a) {
+  if (!a)
     throw new Error("SDK is not configured");
 }
 export {
-  A as Accounts,
-  B as Applications,
+  R as Accounts,
+  A as Applications,
   J as Client,
   U as Currency,
-  $ as Devices,
-  R as Environment,
-  x as Media,
+  B as Devices,
+  $ as Environment,
+  L as Media,
   V as Mqtt,
-  j as Proxy,
-  D as Store,
+  O as Navigation,
+  x as Proxy,
+  j as Store,
   S as StoreSlice,
-  Q as Users,
-  L as Weather,
-  ae as accounts,
+  D as Users,
+  Q as Weather,
+  le as accounts,
   oe as applications,
-  z as configure,
-  fe as currency,
-  X as destroy,
-  le as devices,
-  ge as environment,
-  O as globalClient,
+  Y as configure,
+  ge as currency,
+  K as destroy,
+  he as devices,
+  _e as environment,
+  X as globalClient,
   ce as media,
   we as mqtt,
-  ee as off,
-  Y as on,
-  Z as once,
-  he as proxy,
-  se as request,
-  de as rootSettingsNavigation,
-  te as send,
-  ie as store,
-  ne as subscribe,
-  E as telemetrySdkVersion,
+  te as off,
+  Z as on,
+  ee as once,
+  de as proxy,
+  ne as request,
+  pe as rootSettingsNavigation,
+  se as send,
+  ae as store,
+  ie as subscribe,
+  I as telemetrySdkVersion,
   re as unsubscribe,
   ue as users,
-  pe as weather
+  fe as weather
 };

package/dist/navigation.d.ts

@@ -0,0 +1,13 @@
+import { Client } from './client.js';
+export declare class Navigation {
+    private _client;
+    private _originalPushState;
+    private _originalReplaceState;
+    private _popstateHandler;
+    private _backHandler;
+    private _forwardHandler;
+    constructor(client: Client);
+    bind(): void;
+    unbind(): void;
+    private _sendLocationChanged;
+}

package/dist/navigation.spec.d.ts

@@ -0,0 +1 @@
+export {};

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/dist/weather.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telemetryos/root-sdk",
-  "version": "1.12.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",