@telemetryos/root-sdk 1.5.1 → 1.6.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @telemetryos/root-sdk
 
+## 1.6.1
+
+### Patch Changes
+
+- Add scripts for release process
+
+  Adds a few scripts to help make the release process for these packages
+  smoother. Fixes a few issues with undeployed changes from the last release.
+
+## 1.6.0
+
+### Minor Changes
+
+- Fixes the init command, improvements
+
+  - Fixes an issue where the init command would fail
+  - Changes the location of the config file when you store an API token
+  - Improves CLAUDE.md for Claude Code integration
+  - Exports the environment API for the SDK
+
 ## 1.5.1
 
 ### Patch Changes

package/dist/client.d.ts

@@ -7,6 +7,7 @@ import { Users } from './users.js';
 import { Proxy } from './proxy.js';
 import { Devices } from './devices.js';
 import { Weather } from './weather.js';
+import { Environment } from './environment.js';
 import { BridgeMessage } from './bridge.js';
 /**
  * The maximum time in milliseconds to wait for a response to a request call.
@@ -206,6 +207,18 @@ export declare class Client {
      * @returns A Weather instance bound to this client
      */
     get weather(): Weather;
+    /**
+     * Provides access to the environment API for accessing environment settings.
+     *
+     * This property returns a new Environment instance that allows applications to get
+     * and subscribe to environment settings such as the current color scheme.
+     *
+     * NOTE: Most application developers should use the global environment() function
+     * instead of accessing this property directly.
+     *
+     * @returns An Environment instance bound to this client
+     */
+    get environment(): Environment;
     get applicationName(): string;
     get applicationSpecifier(): string;
     get applicationInstance(): string;

package/dist/environment.d.ts

@@ -1,5 +1,5 @@
 import { Client } from './index.js';
-type ColorScheme = 'light' | 'dark' | 'system';
+export type ColorScheme = 'light' | 'dark' | 'system';
 export declare class Environment {
     _client: Client;
     constructor(client: Client);
@@ -7,4 +7,3 @@ export declare class Environment {
     subscribeColorScheme(handler: (colorScheme: ColorScheme) => void): void;
     unsubscribeColorScheme(handler: (colorScheme: ColorScheme) => void): void;
 }
-export {};

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./index-JDXm3DEz.cjs"),F="1.5.1",$={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;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("./index-JDXm3DEz.cjs"),$="1.6.1",x={version:$};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 R(a,e=console.error){a().catch(e)}class M{constructor(e){this._client=e}async getColorScheme(){return(await this._client.request("environment.getColorScheme",{})).colorScheme}subscribeColorScheme(e){R(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 C{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 d=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);d=p}else n.bodyType==="text"?d=n.body:n.bodyType==="json"&&(d=JSON.stringify(n.body));return new Response(d,c)}}class A{constructor(e){this._client=e}get application(){return new v("application","",this._client)}get instance(){return new v("instance",this._client.applicationInstance,this._client)}get device(){return new v("device",this._client.applicationInstance,this._client)}shared(e){return new v("shared",e,this._client)}}class v{constructor(e,t,s){this._kind=e,this._namespace=t,this._client=s}async set(e,t){return(await this._client.request("store.set",{kind:this._kind,namespace:this._namespace,key:e,value:t})).success}async get(e){return(await this._client.request("store.get",{kind:this._kind,namespace:this._namespace,key:e})).value}async subscribe(e,t){return(await this._client.subscribe("store.subscribe",{kind:this._kind,namespace:this._namespace,key:e},t)).success}async unsubscribe(e,t){return(await this._client.unsubscribe("store.unsubscribe",{kind:this._kind,namespace:this._namespace,key:e},t)).success}async delete(e){return(await this._client.request("store.delete",{kind:this._kind,namespace:this._namespace,key:e})).success}}class 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 T{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 S(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 m=1e3*30;class k{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 B(this)}get store(){return new A(this)}get applications(){return new q(this)}get media(){return new P(this)}get proxy(){return new C(this)}get devices(){return new E(this)}get rootSettingsNavigation(){return new D(this.store)}get weather(){return new T(this)}get environment(){return new M(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 d=this._onHandlers.get(l.name),u=this._onceHandlers.get(l.name);if(d)for(const p of d)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=S({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=S({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((d,u)=>{const p=new Error(`${e} message request with response name of ${s} timed out after ${m}`);setTimeout(()=>{r=!0,this.off(s,n),u(p)},m)}),c=new Promise(d=>{n=u=>{r||d(u)},this.once(s,d)});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 d=S({telemetrySdkVersion:w,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,applicationInstance:this._applicationInstance,name:e,data:o,responseName:l,subscriptionName:n});window.parent.postMessage(d,"*");let u=!1,p;const f=new Promise((y,g)=>{const _=new Error(`${e} subscribe request with subscription name of ${n} and response name of ${l} timed out after ${m}`);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 d=S({telemetrySdkVersion:w,applicationInstance:this._applicationInstance,applicationName:this._applicationName,applicationSpecifier:this._applicationSpecifier,name:e,data:o,responseName:n,unsubscribeName:c});window.parent.postMessage(d,"*");let u=!1,p;const f=new Promise((g,_)=>{const F=new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${n} timed out after ${m}`);setTimeout(()=>{u=!0,this.off(n,p),_(F)},m)}),I=new Promise(g=>{p=_=>{u||g(_)},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=x.version;let i=null;function U(){return i}function z(a){i=new k(a),i.bind()}function L(){i==null||i.unbind(),i=null}function V(...a){return h(i),i.on(...a)}function O(...a){return h(i),i.once(...a)}function W(...a){return h(i),i.off(...a)}function G(...a){return h(i),i.send(...a)}function J(...a){return h(i),i.request(...a)}function K(...a){return h(i),i.subscribe(...a)}function Q(...a){return h(i),i.unsubscribe(...a)}function X(){return h(i),i.store}function Y(){return h(i),i.applications}function Z(){return h(i),i.media}function ee(){return h(i),i.accounts}function te(){return h(i),i.users}function se(){return h(i),i.devices}function ne(){return h(i),i.proxy}function ie(){return h(i),i.rootSettingsNavigation}function re(){return h(i),i.weather}function oe(){return h(i),i.environment}function h(a){if(!a)throw new Error("SDK is not configured")}exports.Accounts=H;exports.Applications=q;exports.Client=k;exports.Devices=E;exports.Environment=M;exports.Media=P;exports.Proxy=C;exports.Store=A;exports.Users=B;exports.Weather=T;exports.accounts=ee;exports.applications=Y;exports.configure=z;exports.destroy=L;exports.devices=se;exports.environment=oe;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,7 +1,7 @@
 export { Accounts } from './accounts.js';
 export { Applications } from './applications.js';
 export { Devices } from './devices.js';
-export { Environment } from './environment.js';
+export { Environment, type ColorScheme } from './environment.js';
 export { Media } from './media.js';
 export { Proxy } from './proxy.js';
 export { Store } from './store.js';
@@ -267,3 +267,21 @@ export declare function rootSettingsNavigation(): import("./root-settings-naviga
  * const forecast = await weather().getDailyForecast({ city: 'London', units: 'metric', days: 5 });
  */
 export declare function weather(): import("./weather.js").Weather;
+/**
+ * Provides access to the environment API for accessing environment settings.
+ *
+ * This API allows applications to get and subscribe to environment settings
+ * such as the current color scheme (light/dark/system).
+ *
+ * @returns The Environment API object
+ * @throws {Error} If called before configure() or after destroy()
+ * @example
+ * // Get current color scheme
+ * const scheme = await environment().getColorScheme();
+ *
+ * // Subscribe to color scheme changes
+ * environment().subscribeColorScheme((newScheme) => {
+ *   applyTheme(newScheme);
+ * });
+ */
+export declare function environment(): import("./environment.js").Environment;

package/dist/index.js

@@ -1,5 +1,5 @@
 import { z as y } from "./index-B98VDFRY.js";
-const q = "1.5.1", E = {
+const q = "1.6.1", E = {
   version: q
 };
 class M {
@@ -145,7 +145,7 @@ class C {
 function A(a, e = console.error) {
   a().catch(e);
 }
-class L {
+class B {
   constructor(e) {
     this._client = e;
   }
@@ -161,7 +161,7 @@ class L {
     this._client.off("environment.colorSchemeChanged", e);
   }
 }
-class B {
+class T {
   constructor(e) {
     this._client = e;
   }
@@ -207,7 +207,7 @@ class B {
     })).content;
   }
 }
-class T {
+class F {
   constructor(e) {
     this._client = e;
   }
@@ -245,18 +245,18 @@ class T {
       statusText: n.statusText,
       headers: l
     };
-    let h = null;
+    let d = 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);
+        d = p;
+      } else n.bodyType === "text" ? d = n.body : n.bodyType === "json" && (d = JSON.stringify(n.body));
+    return new Response(d, c);
   }
 }
-class F {
+class k {
   constructor(e) {
     this._client = e;
   }
@@ -412,7 +412,7 @@ class b {
     })).success;
   }
 }
-class k {
+class $ {
   constructor(e) {
     this._client = e;
   }
@@ -435,7 +435,7 @@ class k {
     return e.user;
   }
 }
-class $ {
+class x {
   constructor(e) {
     this._client = e;
   }
@@ -511,15 +511,15 @@ class $ {
     return t.forecast;
   }
 }
-function S(a) {
+function v(a) {
   return { ...a, type: "client" };
 }
-const x = y.object({
+const R = y.object({
   type: y.literal("bridge"),
   name: y.string(),
   data: y.any()
 });
-class R {
+class j {
   /**
    * Creates a new RootSettingsNavigation API instance.
    *
@@ -576,8 +576,8 @@ class R {
     return (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {};
   }
 }
-const _ = 1e3 * 30;
-class j {
+const m = 1e3 * 30;
+class D {
   /**
    * Creates a new Client instance for communicating with the TelemetryOS platform.
    *
@@ -617,7 +617,7 @@ class j {
    * @returns A Users instance bound to this client
    */
   get users() {
-    return new k(this);
+    return new $(this);
   }
   /**
    * Provides access to the store API for data persistence with multiple storage scopes.
@@ -631,7 +631,7 @@ class j {
    * @returns A Store instance bound to this client
    */
   get store() {
-    return new F(this);
+    return new k(this);
   }
   /**
    * Provides access to the applications API for discovering other TelemetryOS applications.
@@ -660,7 +660,7 @@ class j {
    * @returns A Media instance bound to this client
    */
   get media() {
-    return new B(this);
+    return new T(this);
   }
   /**
    * Provides access to the proxy API for fetching third-party content through the TelemetryOS API.
@@ -674,7 +674,7 @@ class j {
    * @returns A Proxy instance bound to this client
    */
   get proxy() {
-    return new T(this);
+    return new F(this);
   }
   /**
    * Provides access to the devices API for interacting with the current device.
@@ -707,7 +707,7 @@ class j {
    * @throws {Error} If used by an application not mounted at the 'rootSettingsNavigation' mount point
    */
   get rootSettingsNavigation() {
-    return new R(this.store);
+    return new j(this.store);
   }
   /**
    * Provides access to the weather API for retrieving weather data.
@@ -721,7 +721,21 @@ class j {
    * @returns A Weather instance bound to this client
    */
   get weather() {
-    return new $(this);
+    return new x(this);
+  }
+  /**
+   * Provides access to the environment API for accessing environment settings.
+   *
+   * This property returns a new Environment instance that allows applications to get
+   * and subscribe to environment settings such as the current color scheme.
+   *
+   * NOTE: Most application developers should use the global environment() function
+   * instead of accessing this property directly.
+   *
+   * @returns An Environment instance bound to this client
+   */
+  get environment() {
+    return new B(this);
   }
   get applicationName() {
     return this._applicationName;
@@ -771,13 +785,13 @@ class j {
         l = { ...c(n.data.data), type: "bridge" };
       }
       if (!l) {
-        const c = x.safeParse(n.data);
+        const c = R.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)
+        const d = this._onHandlers.get(l.name), u = this._onceHandlers.get(l.name);
+        if (d)
+          for (const p of d)
             p(l.data);
         if (u) {
           for (const p of u)
@@ -819,7 +833,7 @@ class j {
    * @param data The data payload to include with the message
    */
   send(e, t) {
-    const s = S({
+    const s = v({
       telemetrySdkVersion: N,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
@@ -847,7 +861,7 @@ class j {
    * @throws {Error} If the request times out
    */
   request(e, t) {
-    const s = v(), o = S({
+    const s = S(), o = v({
       telemetrySdkVersion: N,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
@@ -858,25 +872,25 @@ class j {
     });
     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 ${_}`);
+    const l = new Promise((d, u) => {
+      const p = new Error(`${e} message request with response name of ${s} timed out after ${m}`);
       setTimeout(() => {
         r = !0, this.off(s, n), u(p);
-      }, _);
-    }), c = new Promise((h) => {
+      }, m);
+    }), c = new Promise((d) => {
       n = (u) => {
-        r || h(u);
-      }, this.once(s, h);
+        r || d(u);
+      }, this.once(s, d);
     });
     return Promise.race([l, c]);
   }
   async subscribe(e, t, s) {
     let o, r;
     typeof t == "function" ? r = t : (o = t, r = s);
-    const n = v(), l = v();
+    const n = S(), l = S();
     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({
+    const d = v({
       telemetrySdkVersion: N,
       applicationName: this._applicationName,
       applicationSpecifier: this._applicationSpecifier,
@@ -886,13 +900,13 @@ class j {
       responseName: l,
       subscriptionName: n
     });
-    window.parent.postMessage(h, "*");
+    window.parent.postMessage(d, "*");
     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 ${_}`);
+      const _ = new Error(`${e} subscribe request with subscription name of ${n} and response name of ${l} timed out after ${m}`);
       setTimeout(() => {
-        u = !0, this.off(l, p), g(m);
-      }, _);
+        u = !0, this.off(l, p), g(_);
+      }, m);
     }), I = new Promise((w) => {
       p = (g) => {
         u || w(g);
@@ -903,7 +917,7 @@ class j {
   async unsubscribe(e, t, s) {
     let o, r;
     typeof t == "function" ? r = t : (o = t, r = s);
-    const n = v();
+    const n = S();
     let l = [];
     if (r) {
       const c = this._subscriptionNamesByHandler.get(r);
@@ -914,7 +928,7 @@ class j {
       return { success: !1 };
     for await (const c of l) {
       this.off(c, r);
-      const h = S({
+      const d = v({
         telemetrySdkVersion: N,
         applicationInstance: this._applicationInstance,
         applicationName: this._applicationName,
@@ -924,16 +938,16 @@ class j {
         responseName: n,
         unsubscribeName: c
       });
-      window.parent.postMessage(h, "*");
+      window.parent.postMessage(d, "*");
       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 ${_}`);
+      const f = new Promise((g, _) => {
+        const H = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${n} timed out after ${m}`);
         setTimeout(() => {
-          u = !0, this.off(n, p), m(H);
-        }, _);
+          u = !0, this.off(n, p), _(H);
+        }, m);
       }), I = new Promise((g) => {
-        p = (m) => {
-          u || g(m);
+        p = (_) => {
+          u || g(_);
         }, this.once(n, g);
       });
       if (!(await Promise.race([f, I])).success)
@@ -1013,7 +1027,7 @@ class j {
     }
   }
 }
-function v() {
+function S() {
   return Math.random().toString(36).slice(2, 9);
 }
 const N = E.version;
@@ -1022,79 +1036,83 @@ function U() {
   return i;
 }
 function V(a) {
-  i = new j(a), i.bind();
+  i = new D(a), i.bind();
 }
 function z() {
   i == null || i.unbind(), i = null;
 }
 function G(...a) {
-  return d(i), i.on(...a);
+  return h(i), i.on(...a);
 }
 function J(...a) {
-  return d(i), i.once(...a);
+  return h(i), i.once(...a);
 }
 function K(...a) {
-  return d(i), i.off(...a);
+  return h(i), i.off(...a);
 }
 function O(...a) {
-  return d(i), i.send(...a);
+  return h(i), i.send(...a);
 }
 function W(...a) {
-  return d(i), i.request(...a);
+  return h(i), i.request(...a);
 }
 function Q(...a) {
-  return d(i), i.subscribe(...a);
+  return h(i), i.subscribe(...a);
 }
 function X(...a) {
-  return d(i), i.unsubscribe(...a);
+  return h(i), i.unsubscribe(...a);
 }
 function Y() {
-  return d(i), i.store;
+  return h(i), i.store;
 }
 function Z() {
-  return d(i), i.applications;
+  return h(i), i.applications;
 }
 function ee() {
-  return d(i), i.media;
+  return h(i), i.media;
 }
 function te() {
-  return d(i), i.accounts;
+  return h(i), i.accounts;
 }
 function se() {
-  return d(i), i.users;
+  return h(i), i.users;
 }
 function ne() {
-  return d(i), i.devices;
+  return h(i), i.devices;
 }
 function ie() {
-  return d(i), i.proxy;
+  return h(i), i.proxy;
 }
 function re() {
-  return d(i), i.rootSettingsNavigation;
+  return h(i), i.rootSettingsNavigation;
 }
 function oe() {
-  return d(i), i.weather;
+  return h(i), i.weather;
+}
+function ae() {
+  return h(i), i.environment;
 }
-function d(a) {
+function h(a) {
   if (!a)
     throw new Error("SDK is not configured");
 }
 export {
   M as Accounts,
   P as Applications,
-  j as Client,
+  D as Client,
   C as Devices,
-  L as Environment,
-  B as Media,
-  T as Proxy,
-  F as Store,
-  k as Users,
-  $ as Weather,
+  B as Environment,
+  T as Media,
+  F as Proxy,
+  k as Store,
+  $ as Users,
+  x as Weather,
   te as accounts,
   Z as applications,
   V as configure,
   z as destroy,
   ne as devices,
+  ae as environment,
   U as globalClient,
   ee as media,
   K as off,

package/package.json

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