@telemetryos/root-sdk 1.9.0 → 1.11.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @telemetryos/root-sdk
 
+## 1.11.0
+
+### Minor Changes
+
+- Added media select component, improved tos init tos publish and tos auth commands, add new store hook
+
+## 1.10.0
+
+### Minor Changes
+
+- Added MQTT, publish command, and other improvements
+  - Added MQTT support to the SDK
+  - Added a command `tos publish` that sends the project to be built on the platform (requires user token, so wont work right away)
+  - Added mock data for the currency service
+
 ## 1.9.0
 
 ### Minor Changes

package/dist/client.d.ts

@@ -9,6 +9,7 @@ import { Devices } from './devices.js';
 import { Weather } from './weather.js';
 import { Currency } from './currency.js';
 import { Environment } from './environment.js';
+import { Mqtt } from './mqtt.js';
 import { BridgeMessage } from './bridge.js';
 /**
  * The maximum time in milliseconds to wait for a response to a request call.
@@ -232,6 +233,7 @@ export declare class Client {
      * @returns An Environment instance bound to this client
      */
     get environment(): Environment;
+    get mqtt(): Mqtt;
     get applicationName(): string;
     get applicationSpecifier(): string;
     get applicationInstance(): string;
@@ -293,10 +295,14 @@ export declare class Client {
      * @template D The expected type of the response data
      * @param name The name of the message type (endpoint) to request
      * @param data The data payload to include with the request
+     * @param options Optional configuration for this request
+     * @param options.timeout Override the default timeout in milliseconds. Set to 0 to disable timeout.
      * @returns A promise that resolves with the response data when received
      * @throws {Error} If the request times out
      */
-    request<D>(name: string, data: any): Promise<Awaited<D>>;
+    request<D>(name: string, data: any, options?: {
+        timeout?: number;
+    }): Promise<D>;
     /**
      * Sets up a persistent subscription to messages from the TelemetryOS platform.
      *

package/dist/devices.d.ts

@@ -5,6 +5,7 @@ type DeviceInformation = {
     deviceManufacturer: string;
     devicePlatform: string;
 };
+export type DeviceCapability = 'configurableDisplays' | 'configurableAudio' | 'applicationContainers' | 'applicationManagement' | 'resourceCaching' | 'bluetooth' | 'wiFi' | 'ethernet' | 'usbProvisioning' | 'videoStreaming' | 'screenCaptureStreaming' | 'mqtt';
 export declare class Devices {
     _client: Client;
     constructor(client: Client);
@@ -22,5 +23,20 @@ export declare class Devices {
      * console.log(`Device: ${info.deviceManufacturer} ${info.deviceModel}`);
      */
     getInformation(): Promise<DeviceInformation>;
+    /**
+     * Retrieves the capabilities of the current device.
+     *
+     * Capabilities indicate what hardware and software features are available on
+     * the device running the application. This can be used to conditionally enable
+     * features based on what the device supports (e.g., MQTT, Bluetooth, WiFi).
+     *
+     * @returns A promise that resolves to an array of device capability strings
+     * @example
+     * const capabilities = await devices.getCapabilities();
+     * if (capabilities.includes('mqtt')) {
+     *   // Enable MQTT features
+     * }
+     */
+    getCapabilities(): Promise<DeviceCapability[]>;
 }
 export {};

package/dist/index.cjs

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

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 export { Accounts } from './accounts.js';
 export { Applications } from './applications.js';
-export { Devices } from './devices.js';
+export { Devices, type DeviceCapability } from './devices.js';
 export { Environment, type ColorScheme } from './environment.js';
 export { Media } from './media.js';
+export type { MediaContent, MediaFolder, MediaSelection, MediaPickerOptions, } from './media.js';
 export { Proxy } from './proxy.js';
 export { Store, StoreSlice } from './store.js';
 export { Users } from './users.js';
@@ -10,6 +11,8 @@ export { Weather } from './weather.js';
 export type { CitiesSearchParams, DailyForecast, DailyForecastData, DailyForecastParams, HourlyForecast, HourlyForecastData, HourlyForecastParams, WeatherAlert, WeatherAlerts, WeatherAlertSeverity, WeatherAlertsParams, WeatherCity, WeatherConditions, WeatherConditionsParams, WeatherPartOfDay, } from './weather.js';
 export { Currency } from './currency.js';
 export type { CurrencySymbols, CurrencyRates, CurrencyRatesParams } from './currency.js';
+export { Mqtt } from './mqtt.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';
 /**
@@ -303,3 +306,14 @@ export declare function currency(): import("./currency.js").Currency;
  * });
  */
 export declare function environment(): import("./environment.js").Environment;
+/**
+ * Provides access to the MQTT API for connecting to MQTT brokers.
+ *
+ * This API allows applications to discover, connect to, publish/subscribe on,
+ * and disconnect from MQTT brokers. MQTT is only available on dedicated player
+ * devices.
+ *
+ * @returns The Mqtt API object
+ * @throws {Error} If called before configure() or after destroy()
+ */
+export declare function mqtt(): import("./mqtt.js").Mqtt;

package/dist/index.js

@@ -1,8 +1,8 @@
-import { o as P, a as C, s as M, l as T } from "./types-CCzf8sMT.js";
-const A = "1.9.0", B = {
-  version: A
+import { o as C, a as H, s as M, l as P } from "./types-CCzf8sMT.js";
+const F = "1.11.0", k = {
+  version: F
 };
-class F {
+class A {
   constructor(e) {
     this._client = e;
   }
@@ -21,7 +21,7 @@ class F {
     return e.account;
   }
 }
-class $ {
+class B {
   constructor(e) {
     this._client = e;
   }
@@ -78,9 +78,7 @@ class $ {
    * ```
    */
   async setDependencies(e) {
-    return await this._client.request("applications.setDependencies", {
-      applicationSpecifiers: e
-    });
+    return await this._client.request("applications.setDependencies", { applicationSpecifiers: e }, { timeout: 0 });
   }
   /**
    * Registers a message interceptor for client messages from sub-applications.
@@ -118,7 +116,7 @@ class $ {
     this._client._messageInterceptors.set(e, t);
   }
 }
-class k {
+class $ {
   constructor(e) {
     this._client = e;
   }
@@ -141,6 +139,26 @@ class k {
       throw new Error("Failed to get device information");
     return e.deviceInformation;
   }
+  /**
+   * Retrieves the capabilities of the current device.
+   *
+   * Capabilities indicate what hardware and software features are available on
+   * the device running the application. This can be used to conditionally enable
+   * features based on what the device supports (e.g., MQTT, Bluetooth, WiFi).
+   *
+   * @returns A promise that resolves to an array of device capability strings
+   * @example
+   * const capabilities = await devices.getCapabilities();
+   * if (capabilities.includes('mqtt')) {
+   *   // Enable MQTT features
+   * }
+   */
+  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 R {
   constructor(e) {
@@ -201,6 +219,19 @@ class x {
       id: e
     })).content;
   }
+  /**
+   * Opens a full-screen media picker dialog in the host window.
+   * This allows users to browse folders, view media, and select an item.
+   *
+   * @param options Optional picker options including content type filter and current value
+   * @returns A promise that resolves to the selected media, or null if cancelled
+   */
+  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 j {
   constructor(e) {
@@ -208,8 +239,8 @@ class j {
   }
   async fetch(e, t) {
     var s;
-    let o;
-    typeof e == "string" ? o = e : e instanceof URL ? o = e.toString() : (o = e.url, t || (t = {
+    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,
@@ -220,35 +251,35 @@ class j {
       integrity: e.integrity
     }));
     let n = {};
-    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((u, h) => {
-      n[h] = u;
-    }) : Array.isArray(t.headers) ? t.headers.forEach(([u, h]) => {
-      n[u] = h;
+    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((l, d) => {
+      n[d] = l;
+    }) : Array.isArray(t.headers) ? t.headers.forEach(([l, d]) => {
+      n[l] = d;
     }) : n = t.headers);
-    const i = await this._client.request("proxy.fetch", {
-      url: o,
+    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 (!i.success)
-      throw new TypeError(i.errorMessage, {
-        cause: i.errorCause ? Error(i.errorCause) : void 0
+    if (!o.success)
+      throw new TypeError(o.errorMessage, {
+        cause: o.errorCause ? Error(o.errorCause) : void 0
       });
-    const l = new Headers(i.headers), c = {
-      status: i.status,
-      statusText: i.statusText,
-      headers: l
+    const u = new Headers(o.headers), a = {
+      status: o.status,
+      statusText: o.statusText,
+      headers: u
     };
-    let d = null;
-    if (i.body !== null && i.body !== void 0)
-      if (i.bodyType === "binary") {
-        const u = atob(i.body), h = new Uint8Array(u.length);
-        for (let f = 0; f < u.length; f++)
-          h[f] = u.charCodeAt(f);
-        d = h;
-      } else i.bodyType === "text" ? d = i.body : i.bodyType === "json" && (d = JSON.stringify(i.body));
-    return new Response(d, c);
+    let p = null;
+    if (o.body !== null && o.body !== void 0)
+      if (o.bodyType === "binary") {
+        const l = atob(o.body), d = new Uint8Array(l.length);
+        for (let f = 0; f < l.length; f++)
+          d[f] = l.charCodeAt(f);
+        p = d;
+      } else o.bodyType === "text" ? p = o.body : o.bodyType === "json" && (p = JSON.stringify(o.body));
+    return new Response(p, a);
   }
 }
 class D {
@@ -265,7 +296,7 @@ class D {
    * @returns A StoreSlice instance for the application scope
    */
   get application() {
-    return new v("application", "", this._client);
+    return new S("application", "", this._client);
   }
   /**
    * Provides access to the instance store scope.
@@ -279,7 +310,7 @@ class D {
    * @returns A StoreSlice instance for the instance scope
    */
   get instance() {
-    return new v("instance", this._client.applicationInstance, this._client);
+    return new S("instance", this._client.applicationInstance, this._client);
   }
   /**
    * Provides access to the device store scope.
@@ -294,7 +325,7 @@ class D {
    * @returns A StoreSlice instance for the device scope
    */
   get device() {
-    return new v("device", this._client.applicationInstance, this._client);
+    return new S("device", this._client.applicationInstance, this._client);
   }
   /**
    * Provides access to the shared store scope with a specified namespace.
@@ -310,10 +341,10 @@ class D {
    * @returns A StoreSlice instance for the specified shared namespace
    */
   shared(e) {
-    return new v("shared", e, this._client);
+    return new S("shared", e, this._client);
   }
 }
-class v {
+class S {
   constructor(e, t, s) {
     this._kind = e, this._namespace = t, this._client = s;
   }
@@ -407,7 +438,7 @@ class v {
     })).success;
   }
 }
-class L {
+class Q {
   constructor(e) {
     this._client = e;
   }
@@ -430,7 +461,7 @@ class L {
     return e.user;
   }
 }
-class U {
+class L {
   constructor(e) {
     this._client = e;
   }
@@ -573,7 +604,7 @@ class U {
     return t;
   }
 }
-class V {
+class U {
   constructor(e) {
     this._client = e;
   }
@@ -613,20 +644,84 @@ class V {
    * ```
    */
   async getRates(e) {
-    var t, s, o;
+    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(((o = n.error) === null || o === void 0 ? void 0 : o.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(((r = n.error) === null || r === void 0 ? void 0 : r.message) || "Failed to fetch currency rates");
     return n.rates;
   }
 }
-function S(a) {
-  return { ...a, type: "client" };
+class V {
+  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 q(c) {
+  return { ...c, type: "client" };
 }
-const W = P({
-  type: T("bridge"),
+const W = C({
+  type: P("bridge"),
   name: M(),
-  data: C()
+  data: H()
 });
 class G {
   /**
@@ -652,11 +747,11 @@ class G {
    */
   async setRootSettingsNavigation(e) {
     var t;
-    const s = this._store.shared("root-settings-navigation"), o = (t = await s.get("navigation")) !== null && t !== void 0 ? t : {}, n = this._store._client._applicationSpecifier;
-    o[n] = {
+    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", o);
+    }, s.set("navigation", r);
   }
   /**
    * Retrieves the current navigation entries for this root application.
@@ -668,8 +763,8 @@ class G {
    */
   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];
+    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];
   }
   /**
    * Retrieves the navigation entries for all root applications.
@@ -685,9 +780,9 @@ class G {
     return (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {};
   }
 }
-const _ = 1e3 * 30, q = typeof window > "u" && typeof self < "u", y = q ? self : window;
-function w(a) {
-  q ? self.postMessage(a) : y.parent.postMessage(a, "*");
+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, "*");
 }
 class J {
   /**
@@ -715,7 +810,7 @@ class J {
    * @returns An Accounts instance bound to this client
    */
   get accounts() {
-    return new F(this);
+    return new A(this);
   }
   /**
    * Provides access to the users API for retrieving TelemetryOS user information.
@@ -729,7 +824,7 @@ class J {
    * @returns A Users instance bound to this client
    */
   get users() {
-    return new L(this);
+    return new Q(this);
   }
   /**
    * Provides access to the store API for data persistence with multiple storage scopes.
@@ -757,7 +852,7 @@ class J {
    * @returns An Applications instance bound to this client
    */
   get applications() {
-    return new $(this);
+    return new B(this);
   }
   /**
    * Provides access to the media API for working with content hosted on the TelemetryOS platform.
@@ -801,7 +896,7 @@ class J {
    * @returns A Devices instance bound to this client
    */
   get devices() {
-    return new k(this);
+    return new $(this);
   }
   /**
    * Provides access to the root settings navigation API for TelemetryOS administration UI integration.
@@ -833,7 +928,7 @@ class J {
    * @returns A Weather instance bound to this client
    */
   get weather() {
-    return new U(this);
+    return new L(this);
   }
   /**
    * Provides access to the currency API for retrieving currency exchange rates.
@@ -847,7 +942,7 @@ class J {
    * @returns A Currency instance bound to this client
    */
   get currency() {
-    return new V(this);
+    return new U(this);
   }
   /**
    * Provides access to the environment API for accessing environment settings.
@@ -863,6 +958,9 @@ class J {
   get environment() {
     return new R(this);
   }
+  get mqtt() {
+    return new V(this);
+  }
   get applicationName() {
     return this._applicationName;
   }
@@ -889,46 +987,46 @@ class J {
    */
   bind() {
     var e, t, s;
-    const o = new URL(y.location.href), n = o.searchParams;
+    const r = new URL(v.location.href), n = r.searchParams;
     if (this._applicationInstance = (e = n.get("applicationInstance")) !== null && e !== void 0 ? e : "", !this._applicationInstance)
       throw new Error("Missing applicationInstance query parameter");
     if (this._applicationSpecifier = (t = n.get("applicationSpecifier")) !== null && t !== void 0 ? t : "", !this._applicationSpecifier) {
-      const i = o.hostname.split(".");
-      this._applicationSpecifier = (s = i[0]) !== null && s !== void 0 ? s : "";
+      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 = (i) => {
-      if (i.source === y || !i.data || typeof i.data != "object" || !("type" in i.data) || i.data.type !== "client" && i.data.type !== "bridge")
+    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")
         return;
-      let l;
-      if (i.data.type === "client") {
-        const c = this._messageInterceptors.get(i.data.name);
-        if (!c) {
-          w(i.data);
+      let u;
+      if (o.data.type === "client") {
+        const a = this._messageInterceptors.get(o.data.name);
+        if (!a) {
+          y(o.data);
           return;
         }
-        l = { ...c(i.data.data), type: "bridge" };
+        u = { ...a(o.data.data), type: "bridge" };
       }
-      if (!l) {
-        const c = W.safeParse(i.data);
-        if (!c.success)
+      if (!u) {
+        const a = W.safeParse(o.data);
+        if (!a.success)
           return;
-        l = c.data;
-        const d = this._onHandlers.get(l.name), u = this._onceHandlers.get(l.name);
-        if (d)
-          for (const h of d)
-            h(l.data);
-        if (u) {
-          for (const h of u)
-            h(l.data);
-          this._onceHandlers.delete(l.name);
+        u = a.data;
+        const p = this._onHandlers.get(u.name), l = this._onceHandlers.get(u.name);
+        if (p)
+          for (const d of p)
+            d(u.data);
+        if (l) {
+          for (const d of l)
+            d(u.data);
+          this._onceHandlers.delete(u.name);
         }
       }
-      if (!q)
-        for (let c = 0; c < window.frames.length; c += 1)
-          window.frames[c].postMessage(l, "*");
-    }, y.addEventListener("message", this._windowMessageHandler);
+      if (!I)
+        for (let a = 0; a < window.frames.length; a += 1)
+          window.frames[a].postMessage(u, "*");
+    }, v.addEventListener("message", this._windowMessageHandler);
   }
   /**
    * Removes the message event listener and cleans up resources.
@@ -944,7 +1042,7 @@ class J {
    * of managing their own Client instances.
    */
   unbind() {
-    this._windowMessageHandler && y.removeEventListener("message", this._windowMessageHandler);
+    this._windowMessageHandler && v.removeEventListener("message", this._windowMessageHandler);
   }
   /**
    * Sends a one-way message to the TelemetryOS platform.
@@ -960,15 +1058,15 @@ class J {
    * @param data The data payload to include with the message
    */
   send(e, t) {
-    const s = S({
-      telemetrySdkVersion: I,
+    const s = q({
+      telemetrySdkVersion: E,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
       data: t
     });
-    w(s);
+    y(s);
   }
   /**
    * Sends a message to the TelemetryOS platform and waits for a response.
@@ -984,100 +1082,107 @@ class J {
    * @template D The expected type of the response data
    * @param name The name of the message type (endpoint) to request
    * @param data The data payload to include with the request
+   * @param options Optional configuration for this request
+   * @param options.timeout Override the default timeout in milliseconds. Set to 0 to disable timeout.
    * @returns A promise that resolves with the response data when received
    * @throws {Error} If the request times out
    */
-  request(e, t) {
-    const s = N(), o = S({
-      telemetrySdkVersion: I,
+  request(e, t, s) {
+    var r;
+    const n = N(), o = q({
+      telemetrySdkVersion: E,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
       data: t,
-      responseName: s
+      responseName: n
+    });
+    y(o);
+    const u = (r = s == null ? void 0 : s.timeout) !== null && r !== void 0 ? r : b;
+    let a = !1, p;
+    const l = new Promise((f) => {
+      p = (g) => {
+        a || f(g);
+      }, this.once(n, p);
     });
-    w(o);
-    let n = !1, i;
-    const l = new Promise((d, u) => {
-      const h = new Error(`${e} message request with response name of ${s} timed out after ${_}`);
+    if (u === 0)
+      return l;
+    const d = new Promise((f, g) => {
+      const m = new Error(`${e} message request with response name of ${n} timed out after ${u}`);
       setTimeout(() => {
-        n = !0, this.off(s, i), u(h);
-      }, _);
-    }), c = new Promise((d) => {
-      i = (u) => {
-        n || d(u);
-      }, this.once(s, d);
+        a = !0, this.off(n, p), g(m);
+      }, u);
     });
-    return Promise.race([l, c]);
+    return Promise.race([d, l]);
   }
   async subscribe(e, t, s) {
-    let o, n;
-    typeof t == "function" ? n = t : (o = t, n = s);
-    const i = N(), l = N();
-    let c = this._subscriptionNamesBySubjectName.get(e);
-    c || (c = [], this._subscriptionNamesBySubjectName.set(e, c)), c.push(i), this._subscriptionNamesByHandler.set(n, i), this.on(i, n);
-    const d = S({
-      telemetrySdkVersion: I,
+    let r, n;
+    typeof t == "function" ? n = t : (r = t, n = s);
+    const o = N(), u = N();
+    let a = this._subscriptionNamesBySubjectName.get(e);
+    a || (a = [], this._subscriptionNamesBySubjectName.set(e, a)), a.push(o), this._subscriptionNamesByHandler.set(n, o), this.on(o, n);
+    const p = q({
+      telemetrySdkVersion: E,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
       applicationInstance: this._applicationInstance,
       name: e,
-      data: o,
-      responseName: l,
-      subscriptionName: i
+      data: r,
+      responseName: u,
+      subscriptionName: o
     });
-    w(d);
-    let u = !1, h;
-    const f = new Promise((b, g) => {
-      const m = new Error(`${e} subscribe request with subscription name of ${i} and response name of ${l} timed out after ${_}`);
+    y(p);
+    let l = !1, d;
+    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}`);
       setTimeout(() => {
-        u = !0, this.off(l, h), g(m);
-      }, _);
-    }), E = new Promise((b) => {
-      h = (g) => {
-        u || b(g);
-      }, this.on(l, b);
+        l = !0, this.off(u, d), w(_);
+      }, b);
+    }), g = new Promise((m) => {
+      d = (w) => {
+        l || m(w);
+      }, this.on(u, m);
     });
-    return Promise.race([f, E]);
+    return Promise.race([f, g]);
   }
   async unsubscribe(e, t, s) {
-    let o, n;
-    typeof t == "function" ? n = t : (o = t, n = s);
-    const i = N();
-    let l = [];
+    let r, n;
+    typeof t == "function" ? n = t : (r = t, n = s);
+    const o = N();
+    let u = [];
     if (n) {
-      const c = this._subscriptionNamesByHandler.get(n);
-      if (!c)
+      const a = this._subscriptionNamesByHandler.get(n);
+      if (!a)
         return { success: !1 };
-      l = [c], this._subscriptionNamesByHandler.delete(n);
+      u = [a], this._subscriptionNamesByHandler.delete(n);
     } else if (!this._subscriptionNamesBySubjectName.get(e))
       return { success: !1 };
-    for await (const c of l) {
-      this.off(c, n);
-      const d = S({
-        telemetrySdkVersion: I,
+    for await (const a of u) {
+      this.off(a, n);
+      const p = q({
+        telemetrySdkVersion: E,
         applicationInstance: this._applicationInstance,
         applicationName: this._applicationName,
         applicationSpecifier: this._applicationSpecifier,
         name: e,
-        data: o,
-        responseName: i,
-        unsubscribeName: c
+        data: r,
+        responseName: o,
+        unsubscribeName: a
       });
-      w(d);
-      let u = !1, h;
-      const f = new Promise((g, m) => {
-        const H = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${i} timed out after ${_}`);
+      y(p);
+      let l = !1, d;
+      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}`);
         setTimeout(() => {
-          u = !0, this.off(i, h), m(H);
-        }, _);
-      }), E = new Promise((g) => {
-        h = (m) => {
-          u || g(m);
-        }, this.once(i, g);
+          l = !0, this.off(o, d), _(T);
+        }, b);
+      }), g = new Promise((w) => {
+        d = (_) => {
+          l || w(_);
+        }, this.once(o, w);
       });
-      if (!(await Promise.race([f, E])).success)
+      if (!(await Promise.race([f, g])).success)
         return { success: !1 };
     }
     return { success: !0 };
@@ -1101,8 +1206,8 @@ class J {
    */
   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);
+    const r = (s = this._onHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    r.length === 0 && this._onHandlers.set(e, r), r.push(t);
   }
   /**
    * Registers a one-time handler for a specific message type.
@@ -1120,8 +1225,8 @@ class J {
    */
   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);
+    const r = (s = this._onceHandlers.get(e)) !== null && s !== void 0 ? s : [];
+    r.length === 0 && this._onceHandlers.set(e, r), r.push(t);
   }
   /**
    * Removes previously registered message handlers.
@@ -1139,17 +1244,17 @@ class J {
    *                all handlers for this message type will be removed.
    */
   off(e, t) {
-    const s = this._onHandlers.get(e), o = this._onceHandlers.get(e);
-    if (!(!s && !o)) {
+    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 (o) {
-        for (let n = 0; n < o.length; n += 1)
-          t && o[n] !== t || (o.splice(n, 1), n -= 1);
-        o.length === 0 && this._onceHandlers.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);
       }
     }
   }
@@ -1157,108 +1262,113 @@ class J {
 function N() {
   return Math.random().toString(36).slice(2, 9);
 }
-const I = B.version;
-let r = null;
+const E = k.version;
+let i = null;
 function O() {
-  return r;
+  return i;
 }
-function z(a) {
-  r = new J(a), r.bind();
+function z(c) {
+  i = new J(c), i.bind();
 }
-function Q() {
-  r == null || r.unbind(), r = null;
+function X() {
+  i == null || i.unbind(), i = null;
 }
-function X(...a) {
-  return p(r), r.on(...a);
+function Y(...c) {
+  return h(i), i.on(...c);
 }
-function Y(...a) {
-  return p(r), r.once(...a);
+function Z(...c) {
+  return h(i), i.once(...c);
 }
-function Z(...a) {
-  return p(r), r.off(...a);
+function ee(...c) {
+  return h(i), i.off(...c);
 }
-function ee(...a) {
-  return p(r), r.send(...a);
+function te(...c) {
+  return h(i), i.send(...c);
 }
-function te(...a) {
-  return p(r), r.request(...a);
+function se(...c) {
+  return h(i), i.request(...c);
 }
-function se(...a) {
-  return p(r), r.subscribe(...a);
+function ne(...c) {
+  return h(i), i.subscribe(...c);
 }
-function ne(...a) {
-  return p(r), r.unsubscribe(...a);
+function re(...c) {
+  return h(i), i.unsubscribe(...c);
 }
 function ie() {
-  return p(r), r.store;
-}
-function re() {
-  return p(r), r.applications;
+  return h(i), i.store;
 }
 function oe() {
-  return p(r), r.media;
-}
-function ae() {
-  return p(r), r.accounts;
+  return h(i), i.applications;
 }
 function ce() {
-  return p(r), r.users;
+  return h(i), i.media;
 }
-function le() {
-  return p(r), r.devices;
+function ae() {
+  return h(i), i.accounts;
 }
 function ue() {
-  return p(r), r.proxy;
+  return h(i), i.users;
 }
-function he() {
-  return p(r), r.rootSettingsNavigation;
+function le() {
+  return h(i), i.devices;
 }
-function pe() {
-  return p(r), r.weather;
+function he() {
+  return h(i), i.proxy;
 }
 function de() {
-  return p(r), r.currency;
+  return h(i), i.rootSettingsNavigation;
+}
+function pe() {
+  return h(i), i.weather;
 }
 function fe() {
-  return p(r), r.environment;
+  return h(i), i.currency;
+}
+function ge() {
+  return h(i), i.environment;
+}
+function we() {
+  return h(i), i.mqtt;
 }
-function p(a) {
-  if (!a)
+function h(c) {
+  if (!c)
     throw new Error("SDK is not configured");
 }
 export {
-  F as Accounts,
-  $ as Applications,
+  A as Accounts,
+  B as Applications,
   J as Client,
-  V as Currency,
-  k as Devices,
+  U as Currency,
+  $ as Devices,
   R as Environment,
   x as Media,
+  V as Mqtt,
   j as Proxy,
   D as Store,
-  v as StoreSlice,
-  L as Users,
-  U as Weather,
+  S as StoreSlice,
+  Q as Users,
+  L as Weather,
   ae as accounts,
-  re as applications,
+  oe as applications,
   z as configure,
-  de as currency,
-  Q as destroy,
+  fe as currency,
+  X as destroy,
   le as devices,
-  fe as environment,
+  ge as environment,
   O as globalClient,
-  oe as media,
-  Z as off,
-  X as on,
-  Y as once,
-  ue as proxy,
-  te as request,
-  he as rootSettingsNavigation,
-  ee as send,
+  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,
-  se as subscribe,
-  I as telemetrySdkVersion,
-  ne as unsubscribe,
-  ce as users,
+  ne as subscribe,
+  E as telemetrySdkVersion,
+  re as unsubscribe,
+  ue as users,
   pe as weather
 };

package/dist/media.d.ts

@@ -1,6 +1,6 @@
 import { Client } from './client.js';
 type MediaContentUser = {};
-type MediaContent = {
+export type MediaContent = {
     id: string;
     contentFolderId: string;
     contentType: string;
@@ -17,7 +17,7 @@ type MediaContent = {
     createdAt: Date;
     updatedAt: Date;
 };
-type MediaFolder = {
+export type MediaFolder = {
     id: string;
     parentId: string;
     name: string;
@@ -26,6 +26,25 @@ type MediaFolder = {
     updatedAt: Date;
     createdAt: Date;
 };
+/**
+ * Represents a selected media item with essential display properties.
+ */
+export type MediaSelection = {
+    id: string;
+    name: string;
+    thumbnailUrl: string;
+    url: string;
+    contentType: string;
+};
+/**
+ * Options for the media picker dialog.
+ */
+export type MediaPickerOptions = {
+    /** Filter by content type patterns: ['image/*', 'video/*'] */
+    accept?: string[];
+    /** Pre-select the current value in the picker */
+    currentValue?: MediaSelection;
+};
 export declare class Media {
     _client: Client;
     constructor(client: Client);
@@ -56,5 +75,13 @@ export declare class Media {
      * @returns A promise that resolves to the media content with the specified ID
      */
     getById(id: string): Promise<MediaContent>;
+    /**
+     * Opens a full-screen media picker dialog in the host window.
+     * This allows users to browse folders, view media, and select an item.
+     *
+     * @param options Optional picker options including content type filter and current value
+     * @returns A promise that resolves to the selected media, or null if cancelled
+     */
+    openPicker(options?: MediaPickerOptions): Promise<MediaSelection | null>;
 }
 export {};

package/dist/mqtt.d.ts

@@ -0,0 +1,43 @@
+import { Client, type MessageHandler } from './client.js';
+export type MqttBrokerInfo = {
+    name: string;
+    address: string;
+    port: number;
+    protocol: 'mqtt' | 'mqtts' | 'ws' | 'wss';
+};
+export type MqttConnectOptions = {
+    username?: string;
+    password?: string;
+    clientId?: string;
+    keepalive?: number;
+    clean?: boolean;
+    reconnectPeriod?: number;
+    connectTimeout?: number;
+};
+export type MqttPublishOptions = {
+    qos?: 0 | 1 | 2;
+    retain?: boolean;
+};
+export type MqttSubscribeOptions = {
+    qos?: 0 | 1 | 2;
+};
+export type MqttConnectionStatus = 'connected' | 'disconnected' | 'connecting' | 'reconnecting' | 'error';
+export type MqttMessage = {
+    topic: string;
+    payload: string;
+    qos: 0 | 1 | 2;
+    retain: boolean;
+};
+export declare class Mqtt {
+    _client: Client;
+    constructor(client: Client);
+    discover(): Promise<MqttBrokerInfo[]>;
+    connect(brokerUrl: string, options?: MqttConnectOptions): Promise<string>;
+    disconnect(clientId: string): Promise<void>;
+    publish(clientId: string, topic: string, payload: string, options?: MqttPublishOptions): Promise<void>;
+    subscribe(clientId: string, topic: string, handler: MessageHandler<MqttMessage>, options?: MqttSubscribeOptions): Promise<boolean>;
+    unsubscribe(clientId: string, topic: string, handler?: MessageHandler<MqttMessage>): Promise<boolean>;
+    getConnectionStatus(clientId: string): Promise<MqttConnectionStatus>;
+    subscribeConnectionStatus(clientId: string, handler: MessageHandler<MqttConnectionStatus>): Promise<boolean>;
+    unsubscribeConnectionStatus(clientId: string, handler?: MessageHandler<MqttConnectionStatus>): Promise<boolean>;
+}

package/package.json

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