@telemetryos/root-sdk 1.4.3 → 1.5.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @telemetryos/root-sdk
 
+## 1.5.0
+
+### Minor Changes
+
+- Add message interceptors for root applications.
+
+  This allows root applications to listen for messages from their descendant
+  applications, and implement custom functionality those applications
+  can use, or allow for interop.
+
+## 1.4.4
+
+### Patch Changes
+
+- Correctly pass on messages from deeply nested applications up to the parent page and in the reverse
+
 ## 1.4.3
 
 ### Patch Changes

package/README.md

@@ -182,6 +182,35 @@ iframe.src = url;
 document.body.appendChild(iframe);
 ```
 
+### Message Interceptors
+
+Root applications can intercept messages from embedded sub-applications using message interceptors. This allows you to handle client messages before they bubble up to the parent window, enabling custom communication patterns:
+
+```javascript
+import { applications } from '@telemetryos/root-sdk';
+
+// Register an interceptor to provide color scheme to sub-applications
+applications().bind('theme.getColorScheme', (data) => {
+  // Get the current color scheme from settings or state
+  const colors = getCurrentColorScheme();
+
+  // Return a bridge message that will be sent to handlers and child frames
+  return {
+    name: 'theme.colorScheme',
+    data: { primary: colors.primary, secondary: colors.secondary }
+  };
+});
+
+// The interceptor transforms client messages into bridge messages
+// that are handled locally and forwarded to child applications
+```
+
+Interceptors are useful for:
+- **Theme Coordination** - Provide consistent color schemes and styling across embedded applications
+- **State Synchronization** - Coordinate state changes across multiple embedded applications
+- **Custom Routing** - Implement application-specific message routing logic
+- **Data Transformation** - Normalize or transform message data before distribution
+
 ### Media Access
 
 Access media content uploaded to TelemetryOS:

package/dist/applications.d.ts

@@ -1,4 +1,4 @@
-import { Client } from './client.js';
+import { Client, MessageInterceptor } from './client.js';
 export type MountPoint = {
     [key: string]: any;
     path: string;
@@ -10,7 +10,7 @@ export type Application = {
 export type GetUrlResult = {
     url: string;
 };
-export type SetDependenciesResult = {
+export type ApplicationsState = {
     ready: string[];
     unavailable: string[];
 };
@@ -61,5 +61,36 @@ export declare class Applications {
      * // result.unavailable: ['app2-hash'] - these failed to load
      * ```
      */
-    setDependencies(applicationSpecifiers: string[]): Promise<SetDependenciesResult>;
+    setDependencies(applicationSpecifiers: string[]): Promise<ApplicationsState>;
+    /**
+     * Registers a message interceptor for client messages from sub-applications.
+     *
+     * Interceptors allow a root application to handle messages from embedded child applications
+     * before they bubble up to the parent window. When an interceptor is registered, client messages
+     * with the specified name will be transformed into bridge messages that are handled locally
+     * and forwarded to child frames.
+     *
+     * This is useful for implementing custom communication patterns between root applications
+     * and their embedded sub-applications, such as coordinating theme changes, state
+     * synchronization, or custom routing logic.
+     *
+     * @param name The message name to intercept
+     * @param interceptor A function that receives the message data and returns a BridgeMessage
+     * @throws Error if an interceptor is already bound for the specified message name
+     *
+     * @example
+     * ```typescript
+     * import { applications } from '@telemetryos/root-sdk'
+     *
+     * // Intercept color scheme requests from sub-applications
+     * applications().bind('theme.getColorScheme', (data) => {
+     *   const colors = getCurrentColorScheme()
+     *   return {
+     *     name: 'theme.colorScheme',
+     *     data: { primary: colors.primary, secondary: colors.secondary }
+     *   }
+     * })
+     * ```
+     */
+    bind(name: string, interceptor: MessageInterceptor): void;
 }

package/dist/bridge-message-formatter.d.ts

@@ -1,7 +1,5 @@
 import { z } from 'zod';
 import { bridgeMessageValidator } from './bridge-message-validator.js';
-export type Message = z.infer<typeof bridgeMessageValidator>;
-export declare function formatBridgeMessage(data: Message): {
-    name: string;
-    data?: any;
-};
+type Message = z.infer<typeof bridgeMessageValidator>;
+export declare function formatBridgeMessage(data: Omit<Message, 'type'>): Message;
+export {};

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

@@ -1,11 +1,14 @@
 import { z } from 'zod';
 export declare const bridgeMessageValidator: z.ZodObject<{
+    type: z.ZodLiteral<"bridge">;
     name: z.ZodString;
     data: z.ZodAny;
 }, "strip", z.ZodTypeAny, {
+    type: "bridge";
     name: string;
     data?: any;
 }, {
+    type: "bridge";
     name: string;
     data?: any;
 }>;

package/dist/bridge.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-JDXm3DEz.cjs");const a=e.z.object({telemetrySdkVersion:e.z.string(),applicationName:e.z.string(),applicationSpecifier:e.z.string(),applicationInstance:e.z.string(),name:e.z.string(),data:e.z.any(),responseName:e.z.string().optional(),subscriptionName:e.z.string().optional(),unsubscribeName:e.z.string().optional()});class r{bind(){this._windowMessageHandler=i=>{var s;if(i.source===window)return;const n=a.safeParse(i.data);if(!n.success)return;const t=n.data;(s=this.onMessage)===null||s===void 0||s.call(this,t)},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(i,"*")}}exports.Bridge=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-JDXm3DEz.cjs");function r(n){return{...n,type:"bridge"}}const o=e.z.object({type:e.z.literal("client"),telemetrySdkVersion:e.z.string(),applicationName:e.z.string(),applicationSpecifier:e.z.string(),applicationInstance:e.z.string(),name:e.z.string(),data:e.z.any(),responseName:e.z.string().optional(),subscriptionName:e.z.string().optional(),unsubscribeName:e.z.string().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.d.ts

@@ -5,12 +5,12 @@ import { bridgeMessageValidator } from './bridge-message-validator.js';
  * Defines the structure of a client message as defined in the
  * clientMessageValidator.
  */
-export type ClientMessage = z.infer<typeof clientMessageValidator>;
+export type ClientMessage = Omit<z.infer<typeof clientMessageValidator>, 'type'>;
 /**
  * Defines the structure of a bridge message as defined in the
  * bridgeMessageValidator.
  */
-export type BridgeMessage = z.infer<typeof bridgeMessageValidator>;
+export type BridgeMessage = Omit<z.infer<typeof bridgeMessageValidator>, 'type'>;
 /**
  * The Bridge class is provides a way for host applications to communicate with
  * TelemetryOS applications. It listens for window message events and sends

package/dist/bridge.js

@@ -1,5 +1,9 @@
 import { z as e } from "./index-B98VDFRY.js";
-const t = e.object({
+function r(n) {
+  return { ...n, type: "bridge" };
+}
+const o = e.object({
+  type: e.literal("client"),
   telemetrySdkVersion: e.string(),
   applicationName: e.string(),
   applicationSpecifier: e.string(),
@@ -10,20 +14,20 @@ const t = e.object({
   subscriptionName: e.string().optional(),
   unsubscribeName: e.string().optional()
 });
-class d {
+class l {
   /**
    * Binds the Bridge to the window message event. This will allow the Bridge
    * to listen for messages from the host application.
    */
   bind() {
-    this._windowMessageHandler = (n) => {
+    this._windowMessageHandler = (i) => {
       var s;
-      if (n.source === window)
+      if (i.source === window)
         return;
-      const i = t.safeParse(n.data);
-      if (!i.success)
+      const t = o.safeParse(i.data);
+      if (!t.success)
         return;
-      const a = i.data;
+      const a = t.data;
       (s = this.onMessage) === null || s === void 0 || s.call(this, a);
     }, window.addEventListener("message", this._windowMessageHandler);
   }
@@ -38,11 +42,11 @@ class d {
    * Sends a message to SDK clients.
    * @param message The message to send.
    */
-  send(n) {
+  send(i) {
     for (let s = 0; s < window.frames.length; s += 1)
-      window.frames[s].postMessage(n, "*");
+      window.frames[s].postMessage(r(i), "*");
   }
 }
 export {
-  d as Bridge
+  l as Bridge
 };

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

@@ -1,14 +1,5 @@
 import { z } from 'zod';
 import { clientMessageValidator } from './client-message-validator.js';
-export type Message = z.infer<typeof clientMessageValidator>;
-export declare function formatClientMessage(data: Message): {
-    telemetrySdkVersion: string;
-    applicationName: string;
-    applicationSpecifier: string;
-    applicationInstance: string;
-    name: string;
-    data?: any;
-    responseName?: string | undefined;
-    subscriptionName?: string | undefined;
-    unsubscribeName?: string | undefined;
-};
+type Message = z.infer<typeof clientMessageValidator>;
+export declare function formatClientMessage(data: Omit<Message, 'type'>): Message;
+export {};

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

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 export declare const clientMessageValidator: z.ZodObject<{
+    type: z.ZodLiteral<"client">;
     telemetrySdkVersion: z.ZodString;
     applicationName: z.ZodString;
     applicationSpecifier: z.ZodString;
@@ -10,6 +11,7 @@ export declare const clientMessageValidator: z.ZodObject<{
     subscriptionName: z.ZodOptional<z.ZodString>;
     unsubscribeName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    type: "client";
     telemetrySdkVersion: string;
     applicationName: string;
     applicationSpecifier: string;
@@ -20,6 +22,7 @@ export declare const clientMessageValidator: z.ZodObject<{
     subscriptionName?: string | undefined;
     unsubscribeName?: string | undefined;
 }, {
+    type: "client";
     telemetrySdkVersion: string;
     applicationName: string;
     applicationSpecifier: string;

package/dist/client.d.ts

@@ -5,8 +5,9 @@ import { RootSettingsNavigation } from './root-settings-navigation.js';
 import { Accounts } from './accounts.js';
 import { Users } from './users.js';
 import { Proxy } from './proxy.js';
-import { Devices } from './device.js';
+import { Devices } from './devices.js';
 import { Weather } from './weather.js';
+import { BridgeMessage } from './bridge.js';
 /**
  * The maximum time in milliseconds to wait for a response to a request call.
  *
@@ -33,6 +34,30 @@ export type SubscriptionResult<D = void> = {
     success: boolean;
     data: D;
 };
+/**
+ * A function that intercepts client messages from sub-applications and transforms them
+ * into bridge messages.
+ *
+ * Message interceptors are registered using applications().bind() and allow root applications
+ * to handle messages from embedded child applications before they bubble up to the parent window.
+ * The interceptor receives the message data payload and must return a BridgeMessage object
+ * containing a name and data that will be forwarded to message handlers and child frames.
+ *
+ * @param data The data payload from the intercepted client message
+ * @returns A BridgeMessage object with name and data properties
+ *
+ * @example
+ * ```typescript
+ * const interceptor: MessageInterceptor = (data) => {
+ *   const colors = getCurrentColorScheme()
+ *   return {
+ *     name: 'theme.colorScheme',
+ *     data: { primary: colors.primary, secondary: colors.secondary }
+ *   }
+ * }
+ * ```
+ */
+export type MessageInterceptor = (data: any) => BridgeMessage;
 /**
  * Client is the core class that powers communication with the TelemetryOS platform.
  *
@@ -50,6 +75,7 @@ export declare class Client {
     _applicationName: string;
     _applicationInstance: string;
     _applicationSpecifier: string;
+    _messageInterceptors: Map<string, MessageInterceptor>;
     _onHandlers: Map<string, MessageHandler<any>[]>;
     _onceHandlers: Map<string, MessageHandler<any>[]>;
     _subscriptionNamesByHandler: Map<MessageHandler<any>, string>;

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("./index-JDXm3DEz.cjs"),k="1.4.3",F={version:k};class H{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 q{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})}}class I{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}}function T(o,e=console.error){o().catch(e)}class ${constructor(e){this._client=e}async getColorScheme(){return(await this._client.request("environment.getColorScheme",{})).colorScheme}subscribeColorScheme(e){T(async()=>{this._client.on("environment.colorSchemeChanged",e),e(await this.getColorScheme())})}unsubscribeColorScheme(e){this._client.off("environment.colorSchemeChanged",e)}}class P{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}}class E{constructor(e){this._client=e}get application(){return new y("application","",this._client)}get instance(){return new y("instance",this._client.applicationSpecifier,this._client)}get device(){return new y("device",this._client.applicationSpecifier,this._client)}shared(e){return new y("shared",e,this._client)}}class y{constructor(e,t,n){this._kind=e,this._namespace=t,this._client=n}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 M{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 A{constructor(e){this._client=e}async getConditions(e){const t=await this._client.request("weather.getConditions",e);if(!t.success||!t.conditions)throw new Error(t.error||"Failed to fetch weather conditions");return t.conditions}async getDailyForecast(e){const t=await this._client.request("weather.getDailyForecast",e);if(!t.success||!t.forecast)throw new Error(t.error||"Failed to fetch daily forecast");return t.forecast}async getHourlyForecast(e){const t=await this._client.request("weather.getHourlyForecast",e);if(!t.success||!t.forecast)throw new Error(t.error||"Failed to fetch hourly forecast");return t.forecast}}const x=N.z.object({name:N.z.string(),data:N.z.any()});class R{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){const t=this._store.shared("root-settings-navigation"),n=await t.get("navigation"),r=this._store._client._applicationSpecifier;n[r]={applicationSpecifier:r,entries:e.entries},t.set("navigation",n)}async getRootSettingsNavigation(){const t=await this._store.shared("root-settings-navigation").get("navigation"),n=this._store._client._applicationSpecifier;return t[n]}async getAllRootSettingsNavigation(){return this._store.shared("root-settings-navigation").get("navigation")}}class j{constructor(e){this._client=e}async fetch(e,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,credentials:e.credentials,cache:e.cache,redirect:e.redirect,referrer:e.referrer,integrity:e.integrity}));let r={};t!=null&&t.headers&&(t.headers instanceof Headers?t.headers.forEach((h,c)=>{r[c]=h}):Array.isArray(t.headers)?t.headers.forEach(([h,c])=>{r[h]=c}):r=t.headers);const s=await this._client.request("proxy.fetch",{url:n,method:(t==null?void 0:t.method)||"GET",headers:r,body:(t==null?void 0:t.body)||null});if(!s.success)throw new Error(`Proxy fetch failed: ${s.statusText}`);const l=new Headers(s.headers),u={status:s.status,statusText:s.statusText,headers:l};let a=null;return s.body!==null&&s.body!==void 0&&(typeof s.body=="string"||s.body instanceof ArrayBuffer?a=s.body:typeof s.body=="object"&&(a=JSON.stringify(s.body))),new Response(a,u)}}const g=1e3*30;class B{constructor(e){this._applicationName=e,this._applicationInstance="",this._applicationSpecifier="",this._onHandlers=new Map,this._onceHandlers=new Map,this._subscriptionNamesByHandler=new Map,this._subscriptionNamesBySubjectName=new Map}get accounts(){return new H(this)}get users(){return new M(this)}get store(){return new E(this)}get applications(){return new q(this)}get media(){return new P(this)}get proxy(){return new j(this)}get devices(){return new I(this)}get rootSettingsNavigation(){return new R(this.store)}get weather(){return new A(this)}get applicationName(){return this._applicationName}get applicationSpecifier(){return this._applicationSpecifier}get applicationInstance(){return this._applicationInstance}bind(){var e;const t=new URL(window.location.href),n=t.searchParams;this._applicationInstance=(e=n.get("telemetryApplicationId"))!==null&&e!==void 0?e:"";const r=n.get("applicationSpecifier");if(r)this._applicationSpecifier=r;else{const s=t.hostname.split(".");this._applicationSpecifier=s[0]||""}if(!this._applicationSpecifier||this._applicationSpecifier.length!==40)throw new Error(`Invalid applicationSpecifier: expected 40-character hash, got "${this._applicationSpecifier}"`);if(!this._applicationInstance)throw new Error("Missing telemetryApplicationId query parameter");this._windowMessageHandler=s=>{if(s.source===window)return;for(let c=0;c<window.frames.length;c+=1)window.frames[c].postMessage(s.data,"*");const l=x.safeParse(s.data);if(!l.success)return;const u=l.data,a=this._onHandlers.get(u.name),h=this._onceHandlers.get(u.name);if(a)for(const c of a)c(u.data);if(h){for(const c of h)c(u.data);this._onceHandlers.delete(u.name)}},window.addEventListener("message",this._windowMessageHandler)}unbind(){this._windowMessageHandler&&window.removeEventListener("message",this._windowMessageHandler)}send(e,t){const n={telemetrySdkVersion:_,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t};window.parent.postMessage(n,"*")}request(e,t){const n=b(),r={telemetrySdkVersion:_,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t,responseName:n};window.parent.postMessage(r,"*");let s=!1,l;const u=new Promise((h,c)=>{const d=new Error(`${e} message request with response name of ${n} timed out after ${g}`);setTimeout(()=>{s=!0,this.off(n,l),c(d)},g)}),a=new Promise(h=>{l=c=>{s||h(c)},this.once(n,h)});return Promise.race([u,a])}async subscribe(e,t,n){let r,s;typeof t=="function"?s=t:(r=t,s=n);const l=b(),u=b();let a=this._subscriptionNamesBySubjectName.get(e);a||(a=[],this._subscriptionNamesBySubjectName.set(e,a)),a.push(l),this._subscriptionNamesByHandler.set(s,l),this.on(l,s);const h={telemetrySdkVersion:_,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:r,responseName:u,subscriptionName:l};window.parent.postMessage(h,"*");let c=!1,d;const S=new Promise((w,f)=>{const m=new Error(`${e} subscribe request with subscription name of ${l} and response name of ${u} timed out after ${g}`);setTimeout(()=>{c=!0,this.off(u,d),f(m)},g)}),v=new Promise(w=>{d=f=>{c||w(f)},this.on(u,w)});return Promise.race([S,v])}async unsubscribe(e,t,n){let r,s;typeof t=="function"?s=t:(r=t,s=n);const l=b();let u=[];if(s){const a=this._subscriptionNamesByHandler.get(s);if(!a)return{success:!1};u=[a],this._subscriptionNamesByHandler.delete(s)}else if(!this._subscriptionNamesBySubjectName.get(e))return{success:!1};for await(const a of u){this.off(a,s);const h={telemetrySdkVersion:_,applicationInstance:this._applicationInstance,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,name:e,data:r,responseName:l,unsubscribeName:a};window.parent.postMessage(h,"*");let c=!1,d;const S=new Promise((f,m)=>{const C=new Error(`${e} unsubscribe request with unsubscribe name of ${a} and response name of ${l} timed out after ${g}`);setTimeout(()=>{c=!0,this.off(l,d),m(C)},g)}),v=new Promise(f=>{d=m=>{c||f(m)},this.once(l,f)});if(!(await Promise.race([S,v])).success)return{success:!1}}return{success:!0}}on(e,t){var n;const r=(n=this._onHandlers.get(e))!==null&&n!==void 0?n:[];r.length===0&&this._onHandlers.set(e,r),r.push(t)}once(e,t){var n;const r=(n=this._onceHandlers.get(e))!==null&&n!==void 0?n:[];r.length===0&&this._onceHandlers.set(e,r),r.push(t)}off(e,t){const n=this._onHandlers.get(e),r=this._onceHandlers.get(e);if(!(!n&&!r)){if(n){for(let s=0;s<n.length;s+=1)t&&n[s]!==t||(n.splice(s,1),s-=1);n.length===0&&this._onHandlers.delete(e)}if(r){for(let s=0;s<r.length;s+=1)t&&r[s]!==t||(r.splice(s,1),s-=1);r.length===0&&this._onceHandlers.delete(e)}}}}function b(){return Math.random().toString(36).slice(2,9)}const _=F.version;let i=null;function D(){return i}function L(o){i=new B(o),i.bind()}function U(){i==null||i.unbind(),i=null}function z(...o){return p(i),i.on(...o)}function V(...o){return p(i),i.once(...o)}function O(...o){return p(i),i.off(...o)}function W(...o){return p(i),i.send(...o)}function G(...o){return p(i),i.request(...o)}function J(...o){return p(i),i.subscribe(...o)}function K(...o){return p(i),i.unsubscribe(...o)}function Q(){return p(i),i.store}function X(){return p(i),i.applications}function Y(){return p(i),i.media}function Z(){return p(i),i.accounts}function ee(){return p(i),i.users}function te(){return p(i),i.devices}function se(){return p(i),i.proxy}function ne(){return p(i),i.rootSettingsNavigation}function ie(){return p(i),i.weather}function p(o){if(!o)throw new Error("SDK is not configured")}exports.Accounts=H;exports.Applications=q;exports.Client=B;exports.Devices=I;exports.Environment=$;exports.Media=P;exports.Store=E;exports.Users=M;exports.Weather=A;exports.accounts=Z;exports.applications=X;exports.configure=L;exports.destroy=U;exports.devices=te;exports.globalClient=D;exports.media=Y;exports.off=O;exports.on=z;exports.once=V;exports.proxy=se;exports.request=G;exports.rootSettingsNavigation=ne;exports.send=W;exports.store=Q;exports.subscribe=J;exports.telemetrySdkVersion=_;exports.unsubscribe=K;exports.users=ee;exports.weather=ie;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./index-JDXm3DEz.cjs"),F="1.5.0",$={version:F};class H{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 q{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})}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 E{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}}function x(a,e=console.error){a().catch(e)}class R{constructor(e){this._client=e}async getColorScheme(){return(await this._client.request("environment.getColorScheme",{})).colorScheme}subscribeColorScheme(e){x(async()=>{this._client.on("environment.colorSchemeChanged",e),e(await this.getColorScheme())})}unsubscribeColorScheme(e){this._client.off("environment.colorSchemeChanged",e)}}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}}class P{constructor(e){this._client=e}async fetch(e,t){var s;let o;typeof e=="string"?o=e:e instanceof URL?o=e.toString():(o=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 r={};t!=null&&t.headers&&(t.headers instanceof Headers?t.headers.forEach((u,p)=>{r[p]=u}):Array.isArray(t.headers)?t.headers.forEach(([u,p])=>{r[u]=p}):r=t.headers);const n=await this._client.request("proxy.fetch",{url:o,method:(t==null?void 0:t.method)||"GET",headers:r,body:(s=t==null?void 0:t.body)!==null&&s!==void 0?s:null});if(!n.success)throw new TypeError(n.errorMessage,{cause:n.errorCause?Error(n.errorCause):void 0});const l=new Headers(n.headers),c={status:n.status,statusText:n.statusText,headers:l};let h=null;if(n.body!==null&&n.body!==void 0)if(n.bodyType==="binary"){const u=atob(n.body),p=new Uint8Array(u.length);for(let f=0;f<u.length;f++)p[f]=u.charCodeAt(f);h=p}else n.bodyType==="text"?h=n.body:n.bodyType==="json"&&(h=JSON.stringify(n.body));return new Response(h,c)}}class C{constructor(e){this._client=e}get application(){return new S("application","",this._client)}get instance(){return new S("instance",this._client.applicationInstance,this._client)}get device(){return new S("device",this._client.applicationInstance,this._client)}shared(e){return new S("shared",e,this._client)}}class S{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 A{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 getConditions(e){const t=await this._client.request("weather.getConditions",e);if(!t.success||!t.conditions)throw new Error(t.error||"Failed to fetch weather conditions");return t.conditions}async getDailyForecast(e){const t=await this._client.request("weather.getDailyForecast",e);if(!t.success||!t.forecast)throw new Error(t.error||"Failed to fetch daily forecast");return t.forecast}async getHourlyForecast(e){const t=await this._client.request("weather.getHourlyForecast",e);if(!t.success||!t.forecast)throw new Error(t.error||"Failed to fetch hourly forecast");return t.forecast}}function v(a){return{...a,type:"client"}}const j=b.z.object({type:b.z.literal("bridge"),name:b.z.string(),data:b.z.any()});class D{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"),o=(t=await s.get("navigation"))!==null&&t!==void 0?t:{},r=this._store._client._applicationSpecifier;o[r]={applicationSpecifier:r,entries:e.entries},s.set("navigation",o)}async getRootSettingsNavigation(){var e;const s=(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{},o=this._store._client._applicationSpecifier;return s[o]}async getAllRootSettingsNavigation(){var e;return(e=await this._store.shared("root-settings-navigation").get("navigation"))!==null&&e!==void 0?e:{}}}const _=1e3*30;class T{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 H(this)}get users(){return new A(this)}get store(){return new C(this)}get applications(){return new q(this)}get media(){return new M(this)}get proxy(){return new P(this)}get devices(){return new E(this)}get rootSettingsNavigation(){return new D(this.store)}get weather(){return new B(this)}get applicationName(){return this._applicationName}get applicationSpecifier(){return this._applicationSpecifier}get applicationInstance(){return this._applicationInstance}bind(){var e,t,s;const o=new URL(window.location.href),r=o.searchParams;if(this._applicationInstance=(e=r.get("applicationInstance"))!==null&&e!==void 0?e:"",!this._applicationInstance)throw new Error("Missing applicationInstance query parameter");if(this._applicationSpecifier=(t=r.get("applicationSpecifier"))!==null&&t!==void 0?t:"",!this._applicationSpecifier){const n=o.hostname.split(".");this._applicationSpecifier=(s=n[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=n=>{if(n.source===window||!n.data||!("type"in n.data)||n.data.type!=="client"&&n.data.type!=="bridge")return;let l;if(n.data.type==="client"){const c=this._messageInterceptors.get(n.data.name);if(!c){window.parent.postMessage(n.data,"*");return}l={...c(n.data.data),type:"bridge"}}if(!l){const c=j.safeParse(n.data);if(!c.success)return;l=c.data;const h=this._onHandlers.get(l.name),u=this._onceHandlers.get(l.name);if(h)for(const p of h)p(l.data);if(u){for(const p of u)p(l.data);this._onceHandlers.delete(l.name)}}for(let c=0;c<window.frames.length;c+=1)window.frames[c].postMessage(l,"*")},window.addEventListener("message",this._windowMessageHandler)}unbind(){this._windowMessageHandler&&window.removeEventListener("message",this._windowMessageHandler)}send(e,t){const s=v({telemetrySdkVersion:w,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t});window.parent.postMessage(s,"*")}request(e,t){const s=N(),o=v({telemetrySdkVersion:w,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:t,responseName:s});window.parent.postMessage(o,"*");let r=!1,n;const l=new Promise((h,u)=>{const p=new Error(`${e} message request with response name of ${s} timed out after ${_}`);setTimeout(()=>{r=!0,this.off(s,n),u(p)},_)}),c=new Promise(h=>{n=u=>{r||h(u)},this.once(s,h)});return Promise.race([l,c])}async subscribe(e,t,s){let o,r;typeof t=="function"?r=t:(o=t,r=s);const n=N(),l=N();let c=this._subscriptionNamesBySubjectName.get(e);c||(c=[],this._subscriptionNamesBySubjectName.set(e,c)),c.push(n),this._subscriptionNamesByHandler.set(r,n),this.on(n,r);const h=v({telemetrySdkVersion:w,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:o,responseName:l,subscriptionName:n});window.parent.postMessage(h,"*");let u=!1,p;const f=new Promise((y,g)=>{const m=new Error(`${e} subscribe request with subscription name of ${n} and response name of ${l} timed out after ${_}`);setTimeout(()=>{u=!0,this.off(l,p),g(m)},_)}),I=new Promise(y=>{p=g=>{u||y(g)},this.on(l,y)});return Promise.race([f,I])}async unsubscribe(e,t,s){let o,r;typeof t=="function"?r=t:(o=t,r=s);const n=N();let l=[];if(r){const c=this._subscriptionNamesByHandler.get(r);if(!c)return{success:!1};l=[c],this._subscriptionNamesByHandler.delete(r)}else if(!this._subscriptionNamesBySubjectName.get(e))return{success:!1};for await(const c of l){this.off(c,r);const h=v({telemetrySdkVersion:w,applicationInstance:this._applicationInstance,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,name:e,data:o,responseName:n,unsubscribeName:c});window.parent.postMessage(h,"*");let u=!1,p;const f=new Promise((g,m)=>{const k=new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${n} timed out after ${_}`);setTimeout(()=>{u=!0,this.off(n,p),m(k)},_)}),I=new Promise(g=>{p=m=>{u||g(m)},this.once(n,g)});if(!(await Promise.race([f,I])).success)return{success:!1}}return{success:!0}}on(e,t){var s;const o=(s=this._onHandlers.get(e))!==null&&s!==void 0?s:[];o.length===0&&this._onHandlers.set(e,o),o.push(t)}once(e,t){var s;const o=(s=this._onceHandlers.get(e))!==null&&s!==void 0?s:[];o.length===0&&this._onceHandlers.set(e,o),o.push(t)}off(e,t){const s=this._onHandlers.get(e),o=this._onceHandlers.get(e);if(!(!s&&!o)){if(s){for(let r=0;r<s.length;r+=1)t&&s[r]!==t||(s.splice(r,1),r-=1);s.length===0&&this._onHandlers.delete(e)}if(o){for(let r=0;r<o.length;r+=1)t&&o[r]!==t||(o.splice(r,1),r-=1);o.length===0&&this._onceHandlers.delete(e)}}}}function N(){return Math.random().toString(36).slice(2,9)}const w=$.version;let i=null;function U(){return i}function z(a){i=new T(a),i.bind()}function L(){i==null||i.unbind(),i=null}function V(...a){return d(i),i.on(...a)}function O(...a){return d(i),i.once(...a)}function W(...a){return d(i),i.off(...a)}function G(...a){return d(i),i.send(...a)}function J(...a){return d(i),i.request(...a)}function K(...a){return d(i),i.subscribe(...a)}function Q(...a){return d(i),i.unsubscribe(...a)}function X(){return d(i),i.store}function Y(){return d(i),i.applications}function Z(){return d(i),i.media}function ee(){return d(i),i.accounts}function te(){return d(i),i.users}function se(){return d(i),i.devices}function ne(){return d(i),i.proxy}function ie(){return d(i),i.rootSettingsNavigation}function re(){return d(i),i.weather}function d(a){if(!a)throw new Error("SDK is not configured")}exports.Accounts=H;exports.Applications=q;exports.Client=T;exports.Devices=E;exports.Environment=R;exports.Media=M;exports.Proxy=P;exports.Store=C;exports.Users=A;exports.Weather=B;exports.accounts=ee;exports.applications=Y;exports.configure=z;exports.destroy=L;exports.devices=se;exports.globalClient=U;exports.media=Z;exports.off=W;exports.on=V;exports.once=O;exports.proxy=ne;exports.request=J;exports.rootSettingsNavigation=ie;exports.send=G;exports.store=X;exports.subscribe=K;exports.telemetrySdkVersion=w;exports.unsubscribe=Q;exports.users=te;exports.weather=re;

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export { Accounts } from './accounts.js';
 export { Applications } from './applications.js';
-export { Devices } from './device.js';
+export { Devices } from './devices.js';
 export { Environment } from './environment.js';
 export { Media } from './media.js';
+export { Proxy } from './proxy.js';
 export { Store } from './store.js';
 export { Users } from './users.js';
 export { Weather } from './weather.js';
@@ -219,7 +220,7 @@ export declare function users(): import("./users.js").Users;
  * @returns The Devices API object
  * @throws {Error} If called before configure() or after destroy()
  */
-export declare function devices(): import("./device.js").Devices;
+export declare function devices(): import("./devices.js").Devices;
 /**
  * Provides access to the proxy API for fetching third-party content through the TelemetryOS API.
  *

package/dist/index.js

@@ -1,8 +1,8 @@
-import { z as N } from "./index-B98VDFRY.js";
-const q = "1.4.3", I = {
+import { z as y } from "./index-B98VDFRY.js";
+const q = "1.5.0", E = {
   version: q
 };
-class P {
+class M {
   constructor(e) {
     this._client = e;
   }
@@ -21,7 +21,7 @@ class P {
     return e.account;
   }
 }
-class E {
+class P {
   constructor(e) {
     this._client = e;
   }
@@ -82,8 +82,43 @@ class E {
       applicationSpecifiers: e
     });
   }
+  /**
+   * Registers a message interceptor for client messages from sub-applications.
+   *
+   * Interceptors allow a root application to handle messages from embedded child applications
+   * before they bubble up to the parent window. When an interceptor is registered, client messages
+   * with the specified name will be transformed into bridge messages that are handled locally
+   * and forwarded to child frames.
+   *
+   * This is useful for implementing custom communication patterns between root applications
+   * and their embedded sub-applications, such as coordinating theme changes, state
+   * synchronization, or custom routing logic.
+   *
+   * @param name The message name to intercept
+   * @param interceptor A function that receives the message data and returns a BridgeMessage
+   * @throws Error if an interceptor is already bound for the specified message name
+   *
+   * @example
+   * ```typescript
+   * import { applications } from '@telemetryos/root-sdk'
+   *
+   * // Intercept color scheme requests from sub-applications
+   * applications().bind('theme.getColorScheme', (data) => {
+   *   const colors = getCurrentColorScheme()
+   *   return {
+   *     name: 'theme.colorScheme',
+   *     data: { primary: colors.primary, secondary: colors.secondary }
+   *   }
+   * })
+   * ```
+   */
+  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 M {
+class C {
   constructor(e) {
     this._client = e;
   }
@@ -107,10 +142,10 @@ class M {
     return e.deviceInformation;
   }
 }
-function A(o, e = console.error) {
-  o().catch(e);
+function A(a, e = console.error) {
+  a().catch(e);
 }
-class D {
+class L {
   constructor(e) {
     this._client = e;
   }
@@ -172,7 +207,56 @@ class B {
     })).content;
   }
 }
-class C {
+class T {
+  constructor(e) {
+    this._client = e;
+  }
+  async fetch(e, t) {
+    var s;
+    let o;
+    typeof e == "string" ? o = e : e instanceof URL ? o = e.toString() : (o = 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 r = {};
+    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((u, p) => {
+      r[p] = u;
+    }) : Array.isArray(t.headers) ? t.headers.forEach(([u, p]) => {
+      r[u] = p;
+    }) : r = t.headers);
+    const n = await this._client.request("proxy.fetch", {
+      url: o,
+      method: (t == null ? void 0 : t.method) || "GET",
+      headers: r,
+      body: (s = t == null ? void 0 : t.body) !== null && s !== void 0 ? s : null
+    });
+    if (!n.success)
+      throw new TypeError(n.errorMessage, {
+        cause: n.errorCause ? Error(n.errorCause) : void 0
+      });
+    const l = new Headers(n.headers), c = {
+      status: n.status,
+      statusText: n.statusText,
+      headers: l
+    };
+    let h = null;
+    if (n.body !== null && n.body !== void 0)
+      if (n.bodyType === "binary") {
+        const u = atob(n.body), p = new Uint8Array(u.length);
+        for (let f = 0; f < u.length; f++)
+          p[f] = u.charCodeAt(f);
+        h = p;
+      } else n.bodyType === "text" ? h = n.body : n.bodyType === "json" && (h = JSON.stringify(n.body));
+    return new Response(h, c);
+  }
+}
+class F {
   constructor(e) {
     this._client = e;
   }
@@ -186,7 +270,7 @@ class C {
    * @returns A StoreSlice instance for the application scope
    */
   get application() {
-    return new w("application", "", this._client);
+    return new b("application", "", this._client);
   }
   /**
    * Provides access to the instance store scope.
@@ -200,7 +284,7 @@ class C {
    * @returns A StoreSlice instance for the instance scope
    */
   get instance() {
-    return new w("instance", this._client.applicationSpecifier, this._client);
+    return new b("instance", this._client.applicationInstance, this._client);
   }
   /**
    * Provides access to the device store scope.
@@ -215,7 +299,7 @@ class C {
    * @returns A StoreSlice instance for the device scope
    */
   get device() {
-    return new w("device", this._client.applicationSpecifier, this._client);
+    return new b("device", this._client.applicationInstance, this._client);
   }
   /**
    * Provides access to the shared store scope with a specified namespace.
@@ -231,12 +315,12 @@ class C {
    * @returns A StoreSlice instance for the specified shared namespace
    */
   shared(e) {
-    return new w("shared", e, this._client);
+    return new b("shared", e, this._client);
   }
 }
-class w {
-  constructor(e, t, n) {
-    this._kind = e, this._namespace = t, this._client = n;
+class b {
+  constructor(e, t, s) {
+    this._kind = e, this._namespace = t, this._client = s;
   }
   /**
    * Saves a value in the store.
@@ -302,7 +386,7 @@ class w {
    *
    * @param key The key to unsubscribe from
    * @param handler Optional. The specific handler to remove. If not provided, all handlers for this key will be removed.
-   * @returns A promise that resolves to true if the unsubscription was successful
+   * @returns A promise that resolves to true if the unsubscribe was successful
    */
   async unsubscribe(e, t) {
     return (await this._client.unsubscribe("store.unsubscribe", {
@@ -328,7 +412,7 @@ class w {
     })).success;
   }
 }
-class F {
+class k {
   constructor(e) {
     this._client = e;
   }
@@ -351,7 +435,7 @@ class F {
     return e.user;
   }
 }
-class k {
+class $ {
   constructor(e) {
     this._client = e;
   }
@@ -427,11 +511,15 @@ class k {
     return t.forecast;
   }
 }
-const T = N.object({
-  name: N.string(),
-  data: N.any()
+function S(a) {
+  return { ...a, type: "client" };
+}
+const x = y.object({
+  type: y.literal("bridge"),
+  name: y.string(),
+  data: y.any()
 });
-class $ {
+class R {
   /**
    * Creates a new RootSettingsNavigation API instance.
    *
@@ -454,11 +542,12 @@ class $ {
    * @returns A promise that resolves when the navigation has been registered
    */
   async setRootSettingsNavigation(e) {
-    const t = this._store.shared("root-settings-navigation"), n = await t.get("navigation"), r = this._store._client._applicationSpecifier;
-    n[r] = {
+    var t;
+    const s = this._store.shared("root-settings-navigation"), o = (t = await s.get("navigation")) !== null && t !== void 0 ? t : {}, r = this._store._client._applicationSpecifier;
+    o[r] = {
       applicationSpecifier: r,
       entries: e.entries
-    }, t.set("navigation", n);
+    }, s.set("navigation", o);
   }
   /**
    * Retrieves the current navigation entries for this root application.
@@ -469,8 +558,9 @@ class $ {
    * @returns A promise that resolves to the navigation state for this application
    */
   async getRootSettingsNavigation() {
-    const t = await this._store.shared("root-settings-navigation").get("navigation"), n = this._store._client._applicationSpecifier;
-    return t[n];
+    var e;
+    const s = (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {}, o = this._store._client._applicationSpecifier;
+    return s[o];
   }
   /**
    * Retrieves the navigation entries for all root applications.
@@ -482,50 +572,12 @@ class $ {
    * @returns A promise that resolves to the navigation state for all applications
    */
   async getAllRootSettingsNavigation() {
-    return this._store.shared("root-settings-navigation").get("navigation");
-  }
-}
-class x {
-  constructor(e) {
-    this._client = e;
-  }
-  async fetch(e, 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,
-      credentials: e.credentials,
-      cache: e.cache,
-      redirect: e.redirect,
-      referrer: e.referrer,
-      integrity: e.integrity
-    }));
-    let r = {};
-    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((h, c) => {
-      r[c] = h;
-    }) : Array.isArray(t.headers) ? t.headers.forEach(([h, c]) => {
-      r[h] = c;
-    }) : r = t.headers);
-    const s = await this._client.request("proxy.fetch", {
-      url: n,
-      method: (t == null ? void 0 : t.method) || "GET",
-      headers: r,
-      body: (t == null ? void 0 : t.body) || null
-    });
-    if (!s.success)
-      throw new Error(`Proxy fetch failed: ${s.statusText}`);
-    const l = new Headers(s.headers), u = {
-      status: s.status,
-      statusText: s.statusText,
-      headers: l
-    };
-    let a = null;
-    return s.body !== null && s.body !== void 0 && (typeof s.body == "string" || s.body instanceof ArrayBuffer ? a = s.body : typeof s.body == "object" && (a = JSON.stringify(s.body))), new Response(a, u);
+    var e;
+    return (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {};
   }
 }
-const g = 1e3 * 30;
-class R {
+const _ = 1e3 * 30;
+class j {
   /**
    * Creates a new Client instance for communicating with the TelemetryOS platform.
    *
@@ -537,7 +589,7 @@ class R {
    *                        in your application's telemetry.config.json file
    */
   constructor(e) {
-    this._applicationName = e, this._applicationInstance = "", this._applicationSpecifier = "", 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._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.
@@ -551,7 +603,7 @@ class R {
    * @returns An Accounts instance bound to this client
    */
   get accounts() {
-    return new P(this);
+    return new M(this);
   }
   /**
    * Provides access to the users API for retrieving TelemetryOS user information.
@@ -565,7 +617,7 @@ class R {
    * @returns A Users instance bound to this client
    */
   get users() {
-    return new F(this);
+    return new k(this);
   }
   /**
    * Provides access to the store API for data persistence with multiple storage scopes.
@@ -579,7 +631,7 @@ class R {
    * @returns A Store instance bound to this client
    */
   get store() {
-    return new C(this);
+    return new F(this);
   }
   /**
    * Provides access to the applications API for discovering other TelemetryOS applications.
@@ -593,7 +645,7 @@ class R {
    * @returns An Applications instance bound to this client
    */
   get applications() {
-    return new E(this);
+    return new P(this);
   }
   /**
    * Provides access to the media API for working with content hosted on the TelemetryOS platform.
@@ -622,7 +674,7 @@ class R {
    * @returns A Proxy instance bound to this client
    */
   get proxy() {
-    return new x(this);
+    return new T(this);
   }
   /**
    * Provides access to the devices API for interacting with the current device.
@@ -637,7 +689,7 @@ class R {
    * @returns A Devices instance bound to this client
    */
   get devices() {
-    return new M(this);
+    return new C(this);
   }
   /**
    * Provides access to the root settings navigation API for TelemetryOS administration UI integration.
@@ -655,7 +707,7 @@ class R {
    * @throws {Error} If used by an application not mounted at the 'rootSettingsNavigation' mount point
    */
   get rootSettingsNavigation() {
-    return new $(this.store);
+    return new R(this.store);
   }
   /**
    * Provides access to the weather API for retrieving weather data.
@@ -669,7 +721,7 @@ class R {
    * @returns A Weather instance bound to this client
    */
   get weather() {
-    return new k(this);
+    return new $(this);
   }
   get applicationName() {
     return this._applicationName;
@@ -696,37 +748,45 @@ class R {
    * of creating and binding their own Client instances.
    */
   bind() {
-    var e;
-    const t = new URL(window.location.href), n = t.searchParams;
-    this._applicationInstance = (e = n.get("telemetryApplicationId")) !== null && e !== void 0 ? e : "";
-    const r = n.get("applicationSpecifier");
-    if (r)
-      this._applicationSpecifier = r;
-    else {
-      const s = t.hostname.split(".");
-      this._applicationSpecifier = s[0] || "";
+    var e, t, s;
+    const o = new URL(window.location.href), r = o.searchParams;
+    if (this._applicationInstance = (e = r.get("applicationInstance")) !== null && e !== void 0 ? e : "", !this._applicationInstance)
+      throw new Error("Missing applicationInstance query parameter");
+    if (this._applicationSpecifier = (t = r.get("applicationSpecifier")) !== null && t !== void 0 ? t : "", !this._applicationSpecifier) {
+      const n = o.hostname.split(".");
+      this._applicationSpecifier = (s = n[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}"`);
-    if (!this._applicationInstance)
-      throw new Error("Missing telemetryApplicationId query parameter");
-    this._windowMessageHandler = (s) => {
-      if (s.source === window)
-        return;
-      for (let c = 0; c < window.frames.length; c += 1)
-        window.frames[c].postMessage(s.data, "*");
-      const l = T.safeParse(s.data);
-      if (!l.success)
+    this._windowMessageHandler = (n) => {
+      if (n.source === window || !n.data || !("type" in n.data) || n.data.type !== "client" && n.data.type !== "bridge")
         return;
-      const u = l.data, a = this._onHandlers.get(u.name), h = this._onceHandlers.get(u.name);
-      if (a)
-        for (const c of a)
-          c(u.data);
-      if (h) {
-        for (const c of h)
-          c(u.data);
-        this._onceHandlers.delete(u.name);
+      let l;
+      if (n.data.type === "client") {
+        const c = this._messageInterceptors.get(n.data.name);
+        if (!c) {
+          window.parent.postMessage(n.data, "*");
+          return;
+        }
+        l = { ...c(n.data.data), type: "bridge" };
+      }
+      if (!l) {
+        const c = x.safeParse(n.data);
+        if (!c.success)
+          return;
+        l = c.data;
+        const h = this._onHandlers.get(l.name), u = this._onceHandlers.get(l.name);
+        if (h)
+          for (const p of h)
+            p(l.data);
+        if (u) {
+          for (const p of u)
+            p(l.data);
+          this._onceHandlers.delete(l.name);
+        }
       }
+      for (let c = 0; c < window.frames.length; c += 1)
+        window.frames[c].postMessage(l, "*");
     }, window.addEventListener("message", this._windowMessageHandler);
   }
   /**
@@ -759,15 +819,15 @@ class R {
    * @param data The data payload to include with the message
    */
   send(e, t) {
-    const n = {
-      telemetrySdkVersion: b,
+    const s = S({
+      telemetrySdkVersion: N,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
       data: t
-    };
-    window.parent.postMessage(n, "*");
+    });
+    window.parent.postMessage(s, "*");
   }
   /**
    * Sends a message to the TelemetryOS platform and waits for a response.
@@ -787,96 +847,96 @@ class R {
    * @throws {Error} If the request times out
    */
   request(e, t) {
-    const n = y(), r = {
-      telemetrySdkVersion: b,
+    const s = v(), o = S({
+      telemetrySdkVersion: N,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
       data: t,
-      responseName: n
-    };
-    window.parent.postMessage(r, "*");
-    let s = !1, l;
-    const u = new Promise((h, c) => {
-      const d = new Error(`${e} message request with response name of ${n} timed out after ${g}`);
+      responseName: s
+    });
+    window.parent.postMessage(o, "*");
+    let r = !1, n;
+    const l = new Promise((h, u) => {
+      const p = new Error(`${e} message request with response name of ${s} timed out after ${_}`);
       setTimeout(() => {
-        s = !0, this.off(n, l), c(d);
-      }, g);
-    }), a = new Promise((h) => {
-      l = (c) => {
-        s || h(c);
-      }, this.once(n, h);
+        r = !0, this.off(s, n), u(p);
+      }, _);
+    }), c = new Promise((h) => {
+      n = (u) => {
+        r || h(u);
+      }, this.once(s, h);
     });
-    return Promise.race([u, a]);
+    return Promise.race([l, c]);
   }
-  async subscribe(e, t, n) {
-    let r, s;
-    typeof t == "function" ? s = t : (r = t, s = n);
-    const l = y(), u = y();
-    let a = this._subscriptionNamesBySubjectName.get(e);
-    a || (a = [], this._subscriptionNamesBySubjectName.set(e, a)), a.push(l), this._subscriptionNamesByHandler.set(s, l), this.on(l, s);
-    const h = {
-      telemetrySdkVersion: b,
+  async subscribe(e, t, s) {
+    let o, r;
+    typeof t == "function" ? r = t : (o = t, r = s);
+    const n = v(), l = v();
+    let c = this._subscriptionNamesBySubjectName.get(e);
+    c || (c = [], this._subscriptionNamesBySubjectName.set(e, c)), c.push(n), this._subscriptionNamesByHandler.set(r, n), this.on(n, r);
+    const h = S({
+      telemetrySdkVersion: N,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
-      data: r,
-      responseName: u,
-      subscriptionName: l
-    };
+      data: o,
+      responseName: l,
+      subscriptionName: n
+    });
     window.parent.postMessage(h, "*");
-    let c = !1, d;
-    const S = new Promise((_, f) => {
-      const m = new Error(`${e} subscribe request with subscription name of ${l} and response name of ${u} timed out after ${g}`);
+    let u = !1, p;
+    const f = new Promise((w, g) => {
+      const m = new Error(`${e} subscribe request with subscription name of ${n} and response name of ${l} timed out after ${_}`);
       setTimeout(() => {
-        c = !0, this.off(u, d), f(m);
-      }, g);
-    }), v = new Promise((_) => {
-      d = (f) => {
-        c || _(f);
-      }, this.on(u, _);
+        u = !0, this.off(l, p), g(m);
+      }, _);
+    }), I = new Promise((w) => {
+      p = (g) => {
+        u || w(g);
+      }, this.on(l, w);
     });
-    return Promise.race([S, v]);
+    return Promise.race([f, I]);
   }
-  async unsubscribe(e, t, n) {
-    let r, s;
-    typeof t == "function" ? s = t : (r = t, s = n);
-    const l = y();
-    let u = [];
-    if (s) {
-      const a = this._subscriptionNamesByHandler.get(s);
-      if (!a)
+  async unsubscribe(e, t, s) {
+    let o, r;
+    typeof t == "function" ? r = t : (o = t, r = s);
+    const n = v();
+    let l = [];
+    if (r) {
+      const c = this._subscriptionNamesByHandler.get(r);
+      if (!c)
         return { success: !1 };
-      u = [a], this._subscriptionNamesByHandler.delete(s);
+      l = [c], this._subscriptionNamesByHandler.delete(r);
     } else if (!this._subscriptionNamesBySubjectName.get(e))
       return { success: !1 };
-    for await (const a of u) {
-      this.off(a, s);
-      const h = {
-        telemetrySdkVersion: b,
+    for await (const c of l) {
+      this.off(c, r);
+      const h = S({
+        telemetrySdkVersion: N,
         applicationInstance: this._applicationInstance,
         applicationName: this._applicationName,
         applicationSpecifier: this._applicationSpecifier,
         name: e,
-        data: r,
-        responseName: l,
-        unsubscribeName: a
-      };
+        data: o,
+        responseName: n,
+        unsubscribeName: c
+      });
       window.parent.postMessage(h, "*");
-      let c = !1, d;
-      const S = new Promise((f, m) => {
-        const H = new Error(`${e} unsubscribe request with unsubscribe name of ${a} and response name of ${l} timed out after ${g}`);
+      let u = !1, p;
+      const f = new Promise((g, m) => {
+        const H = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${n} timed out after ${_}`);
         setTimeout(() => {
-          c = !0, this.off(l, d), m(H);
-        }, g);
-      }), v = new Promise((f) => {
-        d = (m) => {
-          c || f(m);
-        }, this.once(l, f);
+          u = !0, this.off(n, p), m(H);
+        }, _);
+      }), I = new Promise((g) => {
+        p = (m) => {
+          u || g(m);
+        }, this.once(n, g);
       });
-      if (!(await Promise.race([S, v])).success)
+      if (!(await Promise.race([f, I])).success)
         return { success: !1 };
     }
     return { success: !0 };
@@ -899,9 +959,9 @@ class R {
    * @param handler The callback function to execute when messages are received
    */
   on(e, t) {
-    var n;
-    const r = (n = this._onHandlers.get(e)) !== null && n !== void 0 ? n : [];
-    r.length === 0 && this._onHandlers.set(e, r), r.push(t);
+    var s;
+    const o = (s = this._onHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    o.length === 0 && this._onHandlers.set(e, o), o.push(t);
   }
   /**
    * Registers a one-time handler for a specific message type.
@@ -918,9 +978,9 @@ class R {
    * @param handler The callback function to execute when the message is received
    */
   once(e, t) {
-    var n;
-    const r = (n = this._onceHandlers.get(e)) !== null && n !== void 0 ? n : [];
-    r.length === 0 && this._onceHandlers.set(e, r), r.push(t);
+    var s;
+    const o = (s = this._onceHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    o.length === 0 && this._onceHandlers.set(e, o), o.push(t);
   }
   /**
    * Removes previously registered message handlers.
@@ -938,115 +998,116 @@ class R {
    *                all handlers for this message type will be removed.
    */
   off(e, t) {
-    const n = this._onHandlers.get(e), r = this._onceHandlers.get(e);
-    if (!(!n && !r)) {
-      if (n) {
-        for (let s = 0; s < n.length; s += 1)
-          t && n[s] !== t || (n.splice(s, 1), s -= 1);
-        n.length === 0 && this._onHandlers.delete(e);
+    const s = this._onHandlers.get(e), o = this._onceHandlers.get(e);
+    if (!(!s && !o)) {
+      if (s) {
+        for (let r = 0; r < s.length; r += 1)
+          t && s[r] !== t || (s.splice(r, 1), r -= 1);
+        s.length === 0 && this._onHandlers.delete(e);
       }
-      if (r) {
-        for (let s = 0; s < r.length; s += 1)
-          t && r[s] !== t || (r.splice(s, 1), s -= 1);
-        r.length === 0 && this._onceHandlers.delete(e);
+      if (o) {
+        for (let r = 0; r < o.length; r += 1)
+          t && o[r] !== t || (o.splice(r, 1), r -= 1);
+        o.length === 0 && this._onceHandlers.delete(e);
       }
     }
   }
 }
-function y() {
+function v() {
   return Math.random().toString(36).slice(2, 9);
 }
-const b = I.version;
+const N = E.version;
 let i = null;
-function L() {
+function U() {
   return i;
 }
-function U(o) {
-  i = new R(o), i.bind();
+function V(a) {
+  i = new j(a), i.bind();
 }
-function V() {
+function z() {
   i == null || i.unbind(), i = null;
 }
-function z(...o) {
-  return p(i), i.on(...o);
-}
-function G(...o) {
-  return p(i), i.once(...o);
+function G(...a) {
+  return d(i), i.on(...a);
 }
-function J(...o) {
-  return p(i), i.off(...o);
+function J(...a) {
+  return d(i), i.once(...a);
 }
-function K(...o) {
-  return p(i), i.send(...o);
+function K(...a) {
+  return d(i), i.off(...a);
 }
-function O(...o) {
-  return p(i), i.request(...o);
+function O(...a) {
+  return d(i), i.send(...a);
 }
-function W(...o) {
-  return p(i), i.subscribe(...o);
+function W(...a) {
+  return d(i), i.request(...a);
 }
-function Q(...o) {
-  return p(i), i.unsubscribe(...o);
+function Q(...a) {
+  return d(i), i.subscribe(...a);
 }
-function X() {
-  return p(i), i.store;
+function X(...a) {
+  return d(i), i.unsubscribe(...a);
 }
 function Y() {
-  return p(i), i.applications;
+  return d(i), i.store;
 }
 function Z() {
-  return p(i), i.media;
+  return d(i), i.applications;
 }
 function ee() {
-  return p(i), i.accounts;
+  return d(i), i.media;
 }
 function te() {
-  return p(i), i.users;
+  return d(i), i.accounts;
 }
 function se() {
-  return p(i), i.devices;
+  return d(i), i.users;
 }
 function ne() {
-  return p(i), i.proxy;
+  return d(i), i.devices;
 }
 function ie() {
-  return p(i), i.rootSettingsNavigation;
+  return d(i), i.proxy;
 }
 function re() {
-  return p(i), i.weather;
+  return d(i), i.rootSettingsNavigation;
+}
+function oe() {
+  return d(i), i.weather;
 }
-function p(o) {
-  if (!o)
+function d(a) {
+  if (!a)
     throw new Error("SDK is not configured");
 }
 export {
-  P as Accounts,
-  E as Applications,
-  R as Client,
-  M as Devices,
-  D as Environment,
+  M as Accounts,
+  P as Applications,
+  j as Client,
+  C as Devices,
+  L as Environment,
   B as Media,
-  C as Store,
-  F as Users,
-  k as Weather,
-  ee as accounts,
-  Y as applications,
-  U as configure,
-  V as destroy,
-  se as devices,
-  L as globalClient,
-  Z as media,
-  J as off,
-  z as on,
-  G as once,
-  ne as proxy,
-  O as request,
-  ie as rootSettingsNavigation,
-  K as send,
-  X as store,
-  W as subscribe,
-  b as telemetrySdkVersion,
-  Q as unsubscribe,
-  te as users,
-  re as weather
+  T as Proxy,
+  F as Store,
+  k as Users,
+  $ as Weather,
+  te as accounts,
+  Z as applications,
+  V as configure,
+  z as destroy,
+  ne as devices,
+  U as globalClient,
+  ee as media,
+  K as off,
+  G as on,
+  J as once,
+  ie as proxy,
+  W as request,
+  re as rootSettingsNavigation,
+  O as send,
+  Y as store,
+  Q as subscribe,
+  N as telemetrySdkVersion,
+  X as unsubscribe,
+  se as users,
+  oe as weather
 };

package/dist/proxy.d.ts

@@ -12,15 +12,12 @@ export declare class Proxy {
     /**
      * Fetches content from an external URL through the TelemetryOS API.
      *
-     * This method has the same interface as the native `fetch()` API but routes the request through
-     * the platform. This is useful for:
-     * - Accessing external APIs that have CORS restrictions
-     * - Fetching content with platform authentication
-     * - Benefiting from platform caching and bandwidth management
-     * - Proxying content from external sources
+     * This method is a subset of the native `fetch()` API that routes requests through
+     * the platform. Only `method`, `headers`, and `body` options are supported.
+     * AbortSignal and other fetch options are not supported.
      *
-     * @param input The URL to fetch from (as a string or URL object)
-     * @param init Optional fetch options (method, headers, body, signal, etc.)
+     * @param input The URL to fetch from (as a string, URL, or Request object)
+     * @param init Optional fetch options (method, headers, body)
      * @returns A promise that resolves to a standard Response object
      *
      * @example

package/dist/store.d.ts

@@ -78,7 +78,7 @@ declare class StoreSlice {
      * @param value The value to store - must be JSON serializable
      * @returns A promise that resolves to true if the value was saved successfully
      */
-    set(key: string, value: any): Promise<boolean>;
+    set<T>(key: string, value: T): Promise<boolean>;
     /**
      * Retrieves a value from the store.
      *
@@ -90,7 +90,7 @@ declare class StoreSlice {
      * @param key The key to retrieve the value for
      * @returns A promise that resolves to the stored value, or undefined if the key does not exist
      */
-    get<T>(key: string): Promise<T>;
+    get<T>(key: string): Promise<T | undefined>;
     /**
      * Subscribes to changes in the store for a specific key.
      *
@@ -103,7 +103,7 @@ declare class StoreSlice {
      * @param handler The callback function to call when the value changes
      * @returns A promise that resolves to true if the subscription was successful
      */
-    subscribe(key: string, handler: MessageHandler<any>): Promise<boolean>;
+    subscribe<T>(key: string, handler: MessageHandler<T | undefined>): Promise<boolean>;
     /**
      * Unsubscribes from changes in the store for a specific key.
      *
@@ -112,9 +112,9 @@ declare class StoreSlice {
      *
      * @param key The key to unsubscribe from
      * @param handler Optional. The specific handler to remove. If not provided, all handlers for this key will be removed.
-     * @returns A promise that resolves to true if the unsubscription was successful
+     * @returns A promise that resolves to true if the unsubscribe was successful
      */
-    unsubscribe(key: string, handler?: MessageHandler<any>): Promise<boolean>;
+    unsubscribe<T>(key: string, handler?: MessageHandler<T | undefined>): Promise<boolean>;
     /**
      * Deletes a value from the store.
      *

package/package.json

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