@telemetryos/root-sdk 1.12.0 → 1.13.0

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @telemetryos/root-sdk
 
+## 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,64 @@ 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.
+
+### 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/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.
@@ -78,6 +79,7 @@ export declare class Client {
     _applicationName: string;
     _applicationInstance: string;
     _applicationSpecifier: string;
+    _navigation: Navigation;
     _messageInterceptors: Map<string, MessageInterceptor>;
     _onHandlers: Map<string, MessageHandler<any>[]>;
     _onceHandlers: Map<string, MessageHandler<any>[]>;

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 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;

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';

package/dist/index.js

@@ -1,6 +1,6 @@
-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.0", F = {
+  version: M
 };
 class A {
   constructor(e) {
@@ -21,7 +21,7 @@ class A {
     return e.account;
   }
 }
-class B {
+class R {
   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 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,
@@ -251,38 +251,38 @@ class j {
       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;
+    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((h, u) => {
+      n[u] = h;
+    }) : Array.isArray(t.headers) ? t.headers.forEach(([h, u]) => {
+      n[h] = u;
     }) : n = t.headers);
-    const o = await this._client.request("proxy.fetch", {
-      url: r,
+    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 (!o.success)
-      throw new TypeError(o.errorMessage, {
-        cause: o.errorCause ? Error(o.errorCause) : void 0
+    if (!a.success)
+      throw new TypeError(a.errorMessage, {
+        cause: a.errorCause ? Error(a.errorCause) : void 0
       });
-    const u = new Headers(o.headers), a = {
-      status: o.status,
-      statusText: o.statusText,
-      headers: u
+    const l = new Headers(a.headers), c = {
+      status: a.status,
+      statusText: a.statusText,
+      headers: l
     };
     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);
+    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++)
-          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);
+          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 D {
+class j {
   constructor(e) {
     this._client = e;
   }
@@ -438,7 +438,7 @@ class S {
     })).success;
   }
 }
-class Q {
+class D {
   constructor(e) {
     this._client = e;
   }
@@ -461,7 +461,7 @@ class Q {
     return e.user;
   }
 }
-class L {
+class Q {
   constructor(e) {
     this._client = e;
   }
@@ -644,10 +644,10 @@ class U {
    * ```
    */
   async getRates(e) {
-    var t, s, r;
+    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(((r = n.error) === null || r === void 0 ? void 0 : r.message) || "Failed to fetch currency 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;
   }
 }
@@ -674,20 +674,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, i) {
     if (!(await this._client.request("mqtt.publish", {
       clientId: e,
       topic: t,
       payload: s,
-      ...r
+      ...i
     })).success)
       throw new Error("Failed to publish MQTT message");
   }
-  async subscribe(e, t, s, r) {
+  async subscribe(e, t, s, i) {
     return (await this._client.subscribe("mqtt.subscribe", {
       clientId: e,
       topic: t,
-      ...r
+      ...i
     }, s)).success;
   }
   async unsubscribe(e, t, s) {
@@ -715,15 +715,35 @@ class V {
     }, t)).success;
   }
 }
-function q(c) {
-  return { ...c, type: "client" };
+class W {
+  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(o) {
+  return { ...o, type: "client" };
 }
-const W = C({
-  type: P("bridge"),
-  name: M(),
-  data: H()
+const G = C({
+  type: k("bridge"),
+  name: T(),
+  data: P()
 });
-class G {
+class J {
   /**
    * Creates a new RootSettingsNavigation API instance.
    *
@@ -747,11 +767,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] = {
+    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", r);
+    }, s.set("navigation", i);
   }
   /**
    * Retrieves the current navigation entries for this root application.
@@ -763,8 +783,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 : {}, i = this._store._client._applicationSpecifier;
+    return s[i];
   }
   /**
    * Retrieves the navigation entries for all root applications.
@@ -780,11 +800,11 @@ 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 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, "*");
 }
-class J {
+class K {
   /**
    * Creates a new Client instance for communicating with the TelemetryOS platform.
    *
@@ -796,7 +816,7 @@ class J {
    *                        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();
+    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();
   }
   /**
    * Provides access to the accounts API for retrieving TelemetryOS account information.
@@ -824,7 +844,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 +858,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 +872,7 @@ class J {
    * @returns An Applications instance bound to this client
    */
   get applications() {
-    return new B(this);
+    return new R(this);
   }
   /**
    * Provides access to the media API for working with content hosted on the TelemetryOS platform.
@@ -867,7 +887,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 +901,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 +916,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.
@@ -914,7 +934,7 @@ class J {
    * @throws {Error} If used by an application not mounted at the 'rootSettingsNavigation' mount point
    */
   get rootSettingsNavigation() {
-    return new G(this.store);
+    return new J(this.store);
   }
   /**
    * Provides access to the weather API for retrieving weather data.
@@ -928,7 +948,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,7 +976,7 @@ 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);
@@ -987,46 +1007,50 @@ class J {
    */
   bind() {
     var e, t, s;
-    const r = new URL(v.location.href), n = r.searchParams;
+    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 o = r.hostname.split(".");
-      this._applicationSpecifier = (s = o[0]) !== null && s !== void 0 ? s : "";
+      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 = (o) => {
-      if (o.source === v || !o.data || typeof o.data != "object" || !("type" in o.data) || o.data.type !== "client" && o.data.type !== "bridge")
+    this._windowMessageHandler = (a) => {
+      if (a.source === v || !a.data || typeof a.data != "object" || !("type" in a.data) || a.data.type !== "client" && a.data.type !== "bridge")
         return;
-      let u;
-      if (o.data.type === "client") {
-        const a = this._messageInterceptors.get(o.data.name);
-        if (!a) {
-          y(o.data);
+      let l;
+      if (a.data.type === "client") {
+        const c = this._messageInterceptors.get(a.data.name);
+        if (!c) {
+          y(a.data);
           return;
         }
-        u = { ...a(o.data.data), type: "bridge" };
+        l = {
+          ...c(a.data.data),
+          type: "bridge",
+          ...a.data.responseName ? { name: a.data.responseName } : {}
+        };
       }
-      if (!u) {
-        const a = W.safeParse(o.data);
-        if (!a.success)
+      if (!l) {
+        const c = G.safeParse(a.data);
+        if (!c.success)
           return;
-        u = a.data;
-        const p = this._onHandlers.get(u.name), h = this._onceHandlers.get(u.name);
+        l = c.data;
+        const p = this._onHandlers.get(l.name), h = this._onceHandlers.get(l.name);
         if (p)
-          for (const l of p)
-            l(u.data);
+          for (const u of p)
+            u(l.data);
         if (h) {
-          for (const l of h)
-            l(u.data);
-          this._onceHandlers.delete(u.name);
+          for (const u of h)
+            u(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 (!E)
+        for (let c = 0; c < window.frames.length; c += 1)
+          window.frames[c].postMessage(l, "*");
+    }, v.addEventListener("message", this._windowMessageHandler), this._navigation.bind();
   }
   /**
    * Removes the message event listener and cleans up resources.
@@ -1042,7 +1066,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,7 +1083,7 @@ class J {
    */
   send(e, t) {
     const s = q({
-      telemetrySdkVersion: E,
+      telemetrySdkVersion: H,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
@@ -1088,9 +1112,9 @@ class J {
    * @throws {Error} If the request times out
    */
   request(e, t, s) {
-    var r;
-    const n = N(), o = q({
-      telemetrySdkVersion: E,
+    var i;
+    const n = N(), a = q({
+      telemetrySdkVersion: H,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
@@ -1098,91 +1122,91 @@ class J {
       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;
+    y(a);
+    const l = (i = s == null ? void 0 : s.timeout) !== null && i !== void 0 ? i : b;
+    let c = !1, p;
     const h = new Promise((f) => {
-      p = (g) => {
-        a || f(g);
+      p = (_) => {
+        c || f(_);
       }, this.once(n, p);
     });
-    if (u === 0)
+    if (l === 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 u = new Promise((f, _) => {
+      const w = new Error(`${e} message request with response name of ${n} timed out after ${l}`);
       setTimeout(() => {
-        a = !0, this.off(n, p), g(m);
-      }, u);
+        c = !0, this.off(n, p), _(w);
+      }, l);
     });
-    return Promise.race([l, h]);
+    return Promise.race([u, 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);
+    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: E,
+      telemetrySdkVersion: H,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
-      data: r,
-      responseName: u,
-      subscriptionName: o
+      data: i,
+      responseName: l,
+      subscriptionName: a
     });
     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}`);
+    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}`);
       setTimeout(() => {
-        h = !0, this.off(u, l), w(_);
+        h = !0, this.off(l, u), g(m);
       }, b);
-    }), g = new Promise((m) => {
-      l = (w) => {
-        h || m(w);
-      }, this.once(u, l);
+    }), _ = new Promise((w) => {
+      u = (g) => {
+        h || w(g);
+      }, this.once(l, u);
     });
-    return Promise.race([f, g]);
+    return Promise.race([f, _]);
   }
   async unsubscribe(e, t, s) {
-    let r, n;
-    typeof t == "function" ? n = t : (r = t, n = s);
-    const o = N();
-    let u = [];
+    let i, n;
+    typeof t == "function" ? n = t : (i = t, n = s);
+    const a = N();
+    let l = [];
     if (n) {
-      const a = this._subscriptionNamesByHandler.get(n);
-      if (!a)
+      const c = this._subscriptionNamesByHandler.get(n);
+      if (!c)
         return { success: !1 };
-      u = [a], this._subscriptionNamesByHandler.delete(n);
+      l = [c], this._subscriptionNamesByHandler.delete(n);
     } else if (!this._subscriptionNamesBySubjectName.get(e))
       return { success: !1 };
-    for await (const a of u) {
-      this.off(a, n);
+    for await (const c of l) {
+      this.off(c, n);
       const p = q({
-        telemetrySdkVersion: E,
+        telemetrySdkVersion: H,
         applicationInstance: this._applicationInstance,
         applicationName: this._applicationName,
         applicationSpecifier: this._applicationSpecifier,
         name: e,
-        data: r,
-        responseName: o,
-        unsubscribeName: a
+        data: i,
+        responseName: a,
+        unsubscribeName: c
       });
       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}`);
+      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}`);
         setTimeout(() => {
-          h = !0, this.off(o, l), _(T);
+          h = !0, this.off(a, u), m(I);
         }, b);
-      }), g = new Promise((w) => {
-        l = (_) => {
-          h || w(_);
-        }, this.once(o, l);
+      }), _ = new Promise((g) => {
+        u = (m) => {
+          h || g(m);
+        }, this.once(a, u);
       });
-      if (!(await Promise.race([f, g])).success)
+      if (!(await Promise.race([f, _])).success)
         return { success: !1 };
     }
     return { success: !0 };
@@ -1206,8 +1230,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 i = (s = this._onHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    i.length === 0 && this._onHandlers.set(e, i), i.push(t);
   }
   /**
    * Registers a one-time handler for a specific message type.
@@ -1225,8 +1249,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 i = (s = this._onceHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    i.length === 0 && this._onceHandlers.set(e, i), i.push(t);
   }
   /**
    * Removes previously registered message handlers.
@@ -1244,17 +1268,17 @@ 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), 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 (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 (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);
       }
     }
   }
@@ -1262,113 +1286,114 @@ class J {
 function N() {
   return Math.random().toString(36).slice(2, 9);
 }
-const E = k.version;
-let i = null;
-function O() {
-  return i;
+const H = F.version;
+let r = null;
+function z() {
+  return r;
 }
-function z(c) {
-  i = new J(c), i.bind();
+function X(o) {
+  r = new K(o), r.bind();
 }
-function X() {
-  i == null || i.unbind(), i = null;
+function Y() {
+  r == null || r.unbind(), r = null;
 }
-function Y(...c) {
-  return d(i), i.on(...c);
+function Z(...o) {
+  return d(r), r.on(...o);
 }
-function Z(...c) {
-  return d(i), i.once(...c);
+function ee(...o) {
+  return d(r), r.once(...o);
 }
-function ee(...c) {
-  return d(i), i.off(...c);
+function te(...o) {
+  return d(r), r.off(...o);
 }
-function te(...c) {
-  return d(i), i.send(...c);
+function se(...o) {
+  return d(r), r.send(...o);
 }
-function se(...c) {
-  return d(i), i.request(...c);
+function ne(...o) {
+  return d(r), r.request(...o);
 }
-function ne(...c) {
-  return d(i), i.subscribe(...c);
+function ie(...o) {
+  return d(r), r.subscribe(...o);
 }
-function re(...c) {
-  return d(i), i.unsubscribe(...c);
+function re(...o) {
+  return d(r), r.unsubscribe(...o);
 }
-function ie() {
-  return d(i), i.store;
+function ae() {
+  return d(r), r.store;
 }
 function oe() {
-  return d(i), i.applications;
+  return d(r), r.applications;
 }
 function ce() {
-  return d(i), i.media;
+  return d(r), r.media;
 }
-function ae() {
-  return d(i), i.accounts;
+function le() {
+  return d(r), r.accounts;
 }
 function ue() {
-  return d(i), i.users;
-}
-function le() {
-  return d(i), i.devices;
+  return d(r), r.users;
 }
 function he() {
-  return d(i), i.proxy;
+  return d(r), r.devices;
 }
 function de() {
-  return d(i), i.rootSettingsNavigation;
+  return d(r), r.proxy;
 }
 function pe() {
-  return d(i), i.weather;
+  return d(r), r.rootSettingsNavigation;
 }
 function fe() {
-  return d(i), i.currency;
+  return d(r), r.weather;
+}
+function _e() {
+  return d(r), r.currency;
 }
 function ge() {
-  return d(i), i.environment;
+  return d(r), r.environment;
 }
 function we() {
-  return d(i), i.mqtt;
+  return d(r), r.mqtt;
 }
-function d(c) {
-  if (!c)
+function d(o) {
+  if (!o)
     throw new Error("SDK is not configured");
 }
 export {
   A as Accounts,
-  B as Applications,
-  J as Client,
+  R as Applications,
+  K 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,
+  W 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,
+  X as configure,
+  _e as currency,
+  Y as destroy,
+  he as devices,
   ge as environment,
-  O as globalClient,
+  z 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,
+  H 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/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.0",
   "description": "The official TelemetryOS root application sdk package. Provides types and apis for building root TelemetryOS applications.",
   "type": "module",
   "main": "dist/index.cjs",