@telemetryos/root-sdk 1.8.2 → 1.9.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @telemetryos/root-sdk
 
+## 1.9.0
+
+### Minor Changes
+
+- Upgrade weather SDK and weather development tools
+
+## 1.8.3
+
+### Patch Changes
+
+- Fix issue where uninitialized store hooks could set values
+
+  Store hooks could call setValue() before isLoading was true. Now this does nothing and logs an error.
+
 ## 1.8.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("./types-mYnxD5LM.cjs"),D="1.8.2",U={version:D};class P{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})}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 C{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,p)=>{n[p]=u}):Array.isArray(t.headers)?t.headers.forEach(([u,p])=>{n[u]=p}):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),p=new Uint8Array(u.length);for(let f=0;f<u.length;f++)p[f]=u.charCodeAt(f);d=p}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 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}}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 m=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 P(this)}get users(){return new k(this)}get store(){return new F(this)}get applications(){return new M(this)}get media(){return new A(this)}get proxy(){return new B(this)}get devices(){return new C(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 p of d)p(l.data);if(u){for(const p of u)p(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 p=new Error(`${e} message request with response name of ${s} timed out after ${m}`);setTimeout(()=>{n=!0,this.off(s,i),u(p)},m)}),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,p;const f=new Promise((S,g)=>{const _=new Error(`${e} subscribe request with subscription name of ${i} and response name of ${l} timed out after ${m}`);setTimeout(()=>{u=!0,this.off(l,p),g(_)},m)}),E=new Promise(S=>{p=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,p;const f=new Promise((g,_)=>{const j=new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${i} timed out after ${m}`);setTimeout(()=>{u=!0,this.off(i,p),_(j)},m)}),E=new Promise(g=>{p=_=>{u||g(_)},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 h(r),r.on(...a)}function K(...a){return h(r),r.once(...a)}function z(...a){return h(r),r.off(...a)}function Q(...a){return h(r),r.send(...a)}function X(...a){return h(r),r.request(...a)}function Y(...a){return h(r),r.subscribe(...a)}function Z(...a){return h(r),r.unsubscribe(...a)}function ee(){return h(r),r.store}function te(){return h(r),r.applications}function se(){return h(r),r.media}function ne(){return h(r),r.accounts}function ie(){return h(r),r.users}function re(){return h(r),r.devices}function oe(){return h(r),r.proxy}function ae(){return h(r),r.rootSettingsNavigation}function ce(){return h(r),r.weather}function le(){return h(r),r.currency}function ue(){return h(r),r.environment}function h(a){if(!a)throw new Error("SDK is not configured")}exports.Accounts=P;exports.Applications=M;exports.Client=x;exports.Currency=R;exports.Devices=C;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"),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;

package/dist/index.d.ts

@@ -7,9 +7,9 @@ export { Proxy } from './proxy.js';
 export { Store, StoreSlice } from './store.js';
 export { Users } from './users.js';
 export { Weather } from './weather.js';
-export type { WeatherConditions, WeatherForecast, WeatherRequestParams, DailyForecastParams, HourlyForecastParams, } 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 type { CurrencySymbols, CurrencyRates, CurrencyRatesParams } from './currency.js';
 import { Client } from './client.js';
 export { Client, type SubscriptionResult, type MessageHandler } from './client.js';
 /**

package/dist/index.js

@@ -1,6 +1,6 @@
-import { o as P, a as M, s as T, l as C } from "./types-CCzf8sMT.js";
-const B = "1.8.2", A = {
-  version: B
+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
 };
 class F {
   constructor(e) {
@@ -220,10 +220,10 @@ class j {
       integrity: e.integrity
     }));
     let n = {};
-    t != null && t.headers && (t.headers instanceof Headers ? t.headers.forEach((u, p) => {
-      n[p] = u;
-    }) : Array.isArray(t.headers) ? t.headers.forEach(([u, p]) => {
-      n[u] = p;
+    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,
@@ -243,10 +243,10 @@ class j {
     let d = null;
     if (i.body !== null && i.body !== void 0)
       if (i.bodyType === "binary") {
-        const u = atob(i.body), p = new Uint8Array(u.length);
+        const u = atob(i.body), h = new Uint8Array(u.length);
         for (let f = 0; f < u.length; f++)
-          p[f] = u.charCodeAt(f);
-        d = p;
+          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);
   }
@@ -435,75 +435,142 @@ class U {
     this._client = e;
   }
   /**
-   * Retrieves current weather conditions for a specified location.
+   * Searches for cities by name or country
    *
-   * @param params - Weather request parameters including location and units
-   * @returns A promise that resolves to the current weather conditions
-   * @throws {Error} If the request fails or location is invalid
+   * @param params - Search parameters including optional country code and search query
+   * @returns A promise that resolves to an array of matching cities
+   * @throws {Error} If the request fails
+   *
+   * @example
+   * ```typescript
+   * // Search for cities named "New York"
+   * const cities = await weather.getCities({ search: 'New York' })
+   *
+   * // Search for cities in the United States
+   * const cities = await weather.getCities({ countryCode: 'US' })
+   *
+   * // Get a cityId for use in other methods
+   * const cities = await weather.getCities({ search: 'London' })
+   * const cityId = cities[0].cityId
+   * ```
+   */
+  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 || [];
+  }
+  /**
+   * Retrieves current weather conditions for a specified city
+   *
+   * @param params - Weather request parameters including cityId and optional language
+   * @returns A promise that resolves to the current weather conditions with dual units (C/F, kph/mph, etc.)
+   * @throws {Error} If the request fails or cityId is invalid
    *
    * @example
    * ```typescript
-   * // Get weather by city
-   * const weather = await weather.getConditions({ city: 'New York', units: 'imperial' })
+   * // Get current conditions for a city
+   * const conditions = await weather.getConditions({ cityId: 12345 })
    *
-   * // Get weather by postal code
-   * const weather = await weather.getConditions({ postalCode: '10001', units: 'metric' })
+   * // With localized language
+   * const conditions = await weather.getConditions({
+   *   cityId: 12345,
+   *   language: 'es'
+   * })
    *
-   * // Get weather by coordinates
-   * const weather = await weather.getConditions({ lat: '40.7128', lon: '-74.0060' })
+   * // Access both units
+   * console.log(`${conditions.temperatureC}°C / ${conditions.temperatureF}°F`)
+   * console.log(`${conditions.windSpeedKph} kph / ${conditions.windSpeedMph} mph`)
    * ```
    */
   async getConditions(e) {
     const t = await this._client.request("weather.getConditions", e);
-    if (!t.success || !t.conditions)
+    if (!t.success)
       throw new Error(t.error || "Failed to fetch weather conditions");
-    return t.conditions;
+    return t;
   }
   /**
-   * Retrieves daily weather forecast for a specified location.
+   * Retrieves daily weather forecast for a specified city
    *
-   * @param params - Forecast request parameters including location, units, and number of days
-   * @returns A promise that resolves to an array of daily forecast data
-   * @throws {Error} If the request fails or location is invalid
+   * @param params - Forecast request parameters including cityId, optional language and days
+   * @returns A promise that resolves to daily forecast data with location information
+   * @throws {Error} If the request fails or cityId is invalid
    *
    * @example
    * ```typescript
    * // Get 5-day forecast
-   * const forecast = await weather.getDailyForecast({
-   *   city: 'London',
-   *   units: 'metric',
-   *   days: 5
+   * const forecast = await weather.getDailyForecast({ cityId: 12345 })
+   *
+   * // Get 10-day forecast
+   * const forecast = await weather.getDailyForecast({ cityId: 12345, days: 10 })
+   *
+   * // Access forecast data
+   * forecast.data.forEach(day => {
+   *   console.log(`${day.forecastDate}: ${day.weatherDescription}`)
+   *   console.log(`High: ${day.maxTemperatureC}°C, Low: ${day.minTemperatureC}°C`)
    * })
    * ```
    */
   async getDailyForecast(e) {
     const t = await this._client.request("weather.getDailyForecast", e);
-    if (!t.success || !t.forecast)
+    if (!t.success)
       throw new Error(t.error || "Failed to fetch daily forecast");
-    return t.forecast;
+    return t;
   }
   /**
-   * Retrieves hourly weather forecast for a specified location.
+   * Retrieves hourly weather forecast for a specified city
    *
-   * @param params - Forecast request parameters including location, units, and number of hours
-   * @returns A promise that resolves to an array of hourly forecast data
-   * @throws {Error} If the request fails or location is invalid
+   * @param params - Forecast request parameters including cityId, optional language and hours
+   * @returns A promise that resolves to hourly forecast data with location information
+   * @throws {Error} If the request fails or cityId is invalid
    *
    * @example
    * ```typescript
    * // Get 24-hour forecast
-   * const forecast = await weather.getHourlyForecast({
-   *   city: 'Tokyo',
-   *   units: 'metric',
-   *   hours: 24
+   * const forecast = await weather.getHourlyForecast({ cityId: 12345, hours: 24 })
+   *
+   * // Get 48-hour forecast
+   * const forecast = await weather.getHourlyForecast({ cityId: 12345, hours: 48 })
+   *
+   * // Access forecast data
+   * forecast.data.forEach(hour => {
+   *   console.log(`${hour.forecastTimeLocal}: ${hour.weatherDescription}`)
+   *   console.log(`Temp: ${hour.temperatureC}°C`)
    * })
    * ```
    */
   async getHourlyForecast(e) {
     const t = await this._client.request("weather.getHourlyForecast", e);
-    if (!t.success || !t.forecast)
+    if (!t.success)
       throw new Error(t.error || "Failed to fetch hourly forecast");
-    return t.forecast;
+    return t;
+  }
+  /**
+   * Retrieves weather alerts and warnings for a specified city
+   *
+   * @param params - Alert request parameters including cityId and optional language
+   * @returns A promise that resolves to weather alerts with location information
+   * @throws {Error} If the request fails or cityId is invalid
+   *
+   * @example
+   * ```typescript
+   * // Get weather alerts for a city
+   * const alerts = await weather.getAlerts({ cityId: 12345 })
+   *
+   * // Check if there are any active alerts
+   * if (alerts.alerts.length > 0) {
+   *   alerts.alerts.forEach(alert => {
+   *     console.log(`${alert.severity}: ${alert.title}`)
+   *     console.log(alert.description)
+   *   })
+   * }
+   * ```
+   */
+  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 V {
@@ -557,9 +624,9 @@ function S(a) {
   return { ...a, type: "client" };
 }
 const W = P({
-  type: C("bridge"),
-  name: T(),
-  data: M()
+  type: T("bridge"),
+  name: M(),
+  data: C()
 });
 class G {
   /**
@@ -618,9 +685,9 @@ class G {
     return (e = await this._store.shared("root-settings-navigation").get("navigation")) !== null && e !== void 0 ? e : {};
   }
 }
-const _ = 1e3 * 30, E = typeof window > "u" && typeof self < "u", w = E ? self : window;
-function y(a) {
-  E ? self.postMessage(a) : w.parent.postMessage(a, "*");
+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, "*");
 }
 class J {
   /**
@@ -822,7 +889,7 @@ class J {
    */
   bind() {
     var e, t, s;
-    const o = new URL(w.location.href), n = o.searchParams;
+    const o = new URL(y.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) {
@@ -832,13 +899,13 @@ class J {
     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 === w || !i.data || typeof i.data != "object" || !("type" in i.data) || i.data.type !== "client" && i.data.type !== "bridge")
+      if (i.source === y || !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);
+          w(i.data);
           return;
         }
         l = { ...c(i.data.data), type: "bridge" };
@@ -850,18 +917,18 @@ class J {
         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);
+          for (const h of d)
+            h(l.data);
         if (u) {
-          for (const p of u)
-            p(l.data);
+          for (const h of u)
+            h(l.data);
           this._onceHandlers.delete(l.name);
         }
       }
-      if (!E)
+      if (!q)
         for (let c = 0; c < window.frames.length; c += 1)
           window.frames[c].postMessage(l, "*");
-    }, w.addEventListener("message", this._windowMessageHandler);
+    }, y.addEventListener("message", this._windowMessageHandler);
   }
   /**
    * Removes the message event listener and cleans up resources.
@@ -877,7 +944,7 @@ class J {
    * of managing their own Client instances.
    */
   unbind() {
-    this._windowMessageHandler && w.removeEventListener("message", this._windowMessageHandler);
+    this._windowMessageHandler && y.removeEventListener("message", this._windowMessageHandler);
   }
   /**
    * Sends a one-way message to the TelemetryOS platform.
@@ -901,7 +968,7 @@ class J {
       name: e,
       data: t
     });
-    y(s);
+    w(s);
   }
   /**
    * Sends a message to the TelemetryOS platform and waits for a response.
@@ -930,12 +997,12 @@ class J {
       data: t,
       responseName: s
     });
-    y(o);
+    w(o);
     let n = !1, i;
     const l = new Promise((d, u) => {
-      const p = new Error(`${e} message request with response name of ${s} timed out after ${_}`);
+      const h = new Error(`${e} message request with response name of ${s} timed out after ${_}`);
       setTimeout(() => {
-        n = !0, this.off(s, i), u(p);
+        n = !0, this.off(s, i), u(h);
       }, _);
     }), c = new Promise((d) => {
       i = (u) => {
@@ -960,19 +1027,19 @@ class J {
       responseName: l,
       subscriptionName: i
     });
-    y(d);
-    let u = !1, p;
+    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 ${_}`);
       setTimeout(() => {
-        u = !0, this.off(l, p), g(m);
+        u = !0, this.off(l, h), g(m);
       }, _);
-    }), H = new Promise((b) => {
-      p = (g) => {
+    }), E = new Promise((b) => {
+      h = (g) => {
         u || b(g);
       }, this.on(l, b);
     });
-    return Promise.race([f, H]);
+    return Promise.race([f, E]);
   }
   async unsubscribe(e, t, s) {
     let o, n;
@@ -998,19 +1065,19 @@ class J {
         responseName: i,
         unsubscribeName: c
       });
-      y(d);
-      let u = !1, p;
+      w(d);
+      let u = !1, h;
       const f = new Promise((g, m) => {
-        const q = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${i} timed out after ${_}`);
+        const H = new Error(`${e} unsubscribe request with unsubscribe name of ${c} and response name of ${i} timed out after ${_}`);
         setTimeout(() => {
-          u = !0, this.off(i, p), m(q);
+          u = !0, this.off(i, h), m(H);
         }, _);
-      }), H = new Promise((g) => {
-        p = (m) => {
+      }), E = new Promise((g) => {
+        h = (m) => {
           u || g(m);
         }, this.once(i, g);
       });
-      if (!(await Promise.race([f, H])).success)
+      if (!(await Promise.race([f, E])).success)
         return { success: !1 };
     }
     return { success: !0 };
@@ -1090,7 +1157,7 @@ class J {
 function N() {
   return Math.random().toString(36).slice(2, 9);
 }
-const I = A.version;
+const I = B.version;
 let r = null;
 function O() {
   return r;
@@ -1102,60 +1169,60 @@ function Q() {
   r == null || r.unbind(), r = null;
 }
 function X(...a) {
-  return h(r), r.on(...a);
+  return p(r), r.on(...a);
 }
 function Y(...a) {
-  return h(r), r.once(...a);
+  return p(r), r.once(...a);
 }
 function Z(...a) {
-  return h(r), r.off(...a);
+  return p(r), r.off(...a);
 }
 function ee(...a) {
-  return h(r), r.send(...a);
+  return p(r), r.send(...a);
 }
 function te(...a) {
-  return h(r), r.request(...a);
+  return p(r), r.request(...a);
 }
 function se(...a) {
-  return h(r), r.subscribe(...a);
+  return p(r), r.subscribe(...a);
 }
 function ne(...a) {
-  return h(r), r.unsubscribe(...a);
+  return p(r), r.unsubscribe(...a);
 }
 function ie() {
-  return h(r), r.store;
+  return p(r), r.store;
 }
 function re() {
-  return h(r), r.applications;
+  return p(r), r.applications;
 }
 function oe() {
-  return h(r), r.media;
+  return p(r), r.media;
 }
 function ae() {
-  return h(r), r.accounts;
+  return p(r), r.accounts;
 }
 function ce() {
-  return h(r), r.users;
+  return p(r), r.users;
 }
 function le() {
-  return h(r), r.devices;
+  return p(r), r.devices;
 }
 function ue() {
-  return h(r), r.proxy;
-}
-function pe() {
-  return h(r), r.rootSettingsNavigation;
+  return p(r), r.proxy;
 }
 function he() {
-  return h(r), r.weather;
+  return p(r), r.rootSettingsNavigation;
+}
+function pe() {
+  return p(r), r.weather;
 }
 function de() {
-  return h(r), r.currency;
+  return p(r), r.currency;
 }
 function fe() {
-  return h(r), r.environment;
+  return p(r), r.environment;
 }
-function h(a) {
+function p(a) {
   if (!a)
     throw new Error("SDK is not configured");
 }
@@ -1186,12 +1253,12 @@ export {
   Y as once,
   ue as proxy,
   te as request,
-  pe as rootSettingsNavigation,
+  he as rootSettingsNavigation,
   ee as send,
   ie as store,
   se as subscribe,
   I as telemetrySdkVersion,
   ne as unsubscribe,
   ce as users,
-  he as weather
+  pe as weather
 };

package/dist/weather.d.ts

@@ -1,165 +1,378 @@
 import type { Client } from './client.js';
 /**
- * Weather condition data with current conditions
+ * Weather location information shared across all weather endpoints
  */
-export type WeatherConditions = {
-    /** City name (localized) */
-    CityLocalized: string;
-    /** City name (English) */
-    CityEnglish: string;
-    /** Wind abbreviation */
-    WindAbbr: string;
-    /** ISO country code */
-    CountryCode: string;
-    /** Timezone */
-    Timezone: string;
-    /** Weather description text */
-    WeatherText: string;
-    /** State/Province */
-    State: string;
-    /** Part of day (day/night indicator) */
-    Pod: string;
-    /** Weather code (internal mapping) */
-    WeatherCode: string;
-    /** Wind direction in degrees */
-    WindDirectionDegrees: string;
-    /** Wind direction (cardinal direction in English) */
-    WindDirectionEnglish: string;
-    /** Wind direction (localized) */
-    WindDirectionLocalized: string;
-    /** Relative humidity percentage */
-    RelativeHumidity: number;
-    /** Unix timestamp */
-    Timestamp: number;
-    /** Longitude */
-    Longitude: number;
-    /** Latitude */
-    Latitude: number;
-    /** Temperature */
-    Temp: number;
-    /** Atmospheric pressure */
-    Pressure: number;
-    /** Wind speed */
-    WindSpeed: number;
-    /** Visibility distance */
-    Visibility: number;
-    /** Precipitation amount */
-    Precip: number;
+type WeatherLocation = {
+    latitude: number;
+    longitude: number;
+    cityName: string;
+    stateName?: string;
+    stateCode?: string;
+    countryName: string;
+    countryCode: string;
+    timezone: string;
 };
 /**
- * Weather forecast data point
+ * Current weather conditions
  */
-export type WeatherForecast = {
-    /** ISO datetime string */
-    Datetime: string;
-    /** Part of day (day/night indicator) */
-    Pod: string;
-    /** Weather description label */
-    Label: string;
-    /** Weather code */
-    WeatherCode: string;
-    /** Unix timestamp */
-    Timestamp: number;
-    /** Temperature */
-    Temp: number;
-    /** Minimum temperature */
-    MinTemp: number;
-    /** Maximum temperature */
-    MaxTemp: number;
+export type WeatherPartOfDay = 'day' | 'night';
+export type WeatherConditions = WeatherLocation & {
+    observedAtSec: number;
+    observedAtLocal: string;
+    sunrise: string;
+    sunset: string;
+    partOfDay: WeatherPartOfDay;
+    weatherCode: number;
+    weatherDescription: string;
+    weatherIcon: string;
+    temperatureC: number;
+    temperatureF: number;
+    temperatureFeelsLikeC: number;
+    temperatureFeelsLikeF: number;
+    dewPointC: number;
+    dewPointF: number;
+    windSpeedKph: number;
+    windSpeedMph: number;
+    gustSpeedKph: number;
+    gustSpeedMph: number;
+    windDirectionDeg: number;
+    windDirectionFull: string;
+    windDirectionShort: string;
+    pressureMb: number;
+    pressureInHg: number;
+    seaLevelPressureMb: number;
+    seaLevelPressureInHg: number;
+    visibilityKm: number;
+    visibilityMi: number;
+    humidity: number;
+    clouds: number;
+    precipitationRateMmph: number;
+    precipitationRateInph: number;
+    snowfallRateMmph: number;
+    snowfallRateInph: number;
+    uvIndex: number;
+    airQualityIndex: number;
 };
 /**
- * Parameters for weather requests
+ * Single day of forecast data
  */
-export type WeatherRequestParams = {
-    /** City name (can include state/country: "city, state, country") */
-    city?: string;
-    /** Postal/ZIP code (alternative to city) */
-    postalCode?: string;
-    /** Latitude (if city not provided) */
-    lat?: string;
-    /** Longitude (if city not provided) */
-    lon?: string;
-    /** Units system: "imperial" or "metric" */
-    units?: 'imperial' | 'metric';
-    /** Language code for localized responses */
+export type DailyForecastData = {
+    forecastDate: string;
+    forecastDateSec: number;
+    weatherCode: number;
+    weatherDescription: string;
+    weatherIcon: string;
+    precipitationProbability: number;
+    temperatureC: number;
+    temperatureF: number;
+    maxTemperatureC: number;
+    maxTemperatureF: number;
+    minTemperatureC: number;
+    minTemperatureF: number;
+    highTemperatureC: number;
+    highTemperatureF: number;
+    lowTemperatureC: number;
+    lowTemperatureF: number;
+    maxTemperatureFeelsLikeC: number;
+    maxTemperatureFeelsLikeF: number;
+    minTemperatureFeelsLikeC: number;
+    minTemperatureFeelsLikeF: number;
+    dewPointC: number;
+    dewPointF: number;
+    windSpeedKph: number;
+    windSpeedMph: number;
+    gustSpeedKph: number;
+    gustSpeedMph: number;
+    windDirectionDeg: number;
+    windDirectionFull: string;
+    windDirectionShort: string;
+    pressureMb: number;
+    pressureInHg: number;
+    seaLevelPressureMb: number;
+    seaLevelPressureInHg: number;
+    visibilityKm: number;
+    visibilityMi: number;
+    humidity: number;
+    clouds: number;
+    precipitationMm: number;
+    precipitationIn: number;
+    snowfallMm: number;
+    snowfallIn: number;
+    snowDepthMm: number;
+    snowDepthIn: number;
+    uvIndex: number;
+    sunrise: string;
+    sunset: string;
+    moonrise: string;
+    moonset: string;
+    moonIllumination: number;
+    moonLunationPhase: number;
+};
+/**
+ * Daily weather forecast with location
+ */
+export type DailyForecast = WeatherLocation & {
+    data: DailyForecastData[];
+};
+/**
+ * Single hour of forecast data
+ */
+export type HourlyForecastData = {
+    forecastTimeSec: number;
+    forecastTimeLocal: string;
+    forecastTimeUtc: string;
+    partOfDay: WeatherPartOfDay;
+    weatherCode: number;
+    weatherDescription: string;
+    weatherIcon: string;
+    precipitationProbability: number;
+    temperatureC: number;
+    temperatureF: number;
+    temperatureFeelsLikeC: number;
+    temperatureFeelsLikeF: number;
+    dewPointC: number;
+    dewPointF: number;
+    windSpeedKph: number;
+    windSpeedMph: number;
+    gustSpeedKph: number;
+    gustSpeedMph: number;
+    windDirectionDeg: number;
+    windDirectionFull: string;
+    windDirectionShort: string;
+    pressureMb: number;
+    pressureInHg: number;
+    seaLevelPressureMb: number;
+    seaLevelPressureInHg: number;
+    visibilityKm: number;
+    visibilityMi: number;
+    humidity: number;
+    clouds: number;
+    precipitationMm: number;
+    precipitationIn: number;
+    snowfallMm: number;
+    snowfallIn: number;
+    snowDepthMm: number;
+    snowDepthIn: number;
+    uvIndex: number;
+};
+/**
+ * Hourly weather forecast with location
+ */
+export type HourlyForecast = WeatherLocation & {
+    data: HourlyForecastData[];
+};
+/**
+ * Single weather alert/warning
+ */
+export type WeatherAlertSeverity = 'Advisory' | 'Watch' | 'Warning';
+export type WeatherAlert = {
+    title: string;
+    description: string;
+    severity: WeatherAlertSeverity;
+    effectiveSec: number;
+    effectiveUtc: string;
+    effectiveLocal: string;
+    expiresSec: number;
+    expiresUtc: string;
+    expiresLocal: string;
+    onsetSec?: number;
+    onsetUtc?: string;
+    onsetLocal?: string;
+    endsSec?: number;
+    endsUtc?: string;
+    endsLocal?: string;
+    uri: string;
+    regions: string[];
+};
+/**
+ * Weather alerts with location
+ */
+export type WeatherAlerts = WeatherLocation & {
+    alerts: WeatherAlert[];
+};
+/**
+ * City information for location search
+ */
+export type WeatherCity = {
+    cityId: number;
+    cityName: string;
+    stateName?: string;
+    stateCode?: string;
+    countryName: string;
+    countryCode: string;
+    latitude: number;
+    longitude: number;
+};
+/**
+ * Parameters for getting current weather conditions
+ */
+export type WeatherConditionsParams = {
+    /** WeatherBit city ID (required) */
+    cityId: number;
+    /** Language code for localized responses (optional) */
     language?: string;
 };
 /**
- * Parameters for daily forecast requests
+ * Parameters for getting daily forecast
  */
-export type DailyForecastParams = WeatherRequestParams & {
-    /** Number of days to forecast */
+export type DailyForecastParams = {
+    /** WeatherBit city ID (required) */
+    cityId: number;
+    /** Language code for localized responses (optional) */
+    language?: string;
+    /** Number of days to forecast, max 16 (optional, default 5) */
     days?: number;
 };
 /**
- * Parameters for hourly forecast requests
+ * Parameters for getting hourly forecast
  */
-export type HourlyForecastParams = WeatherRequestParams & {
-    /** Number of hours to forecast */
+export type HourlyForecastParams = {
+    /** WeatherBit city ID (required) */
+    cityId: number;
+    /** Language code for localized responses (optional) */
+    language?: string;
+    /** Number of hours to forecast, max 120 (optional, default 12) */
     hours?: number;
 };
+/**
+ * Parameters for getting weather alerts
+ */
+export type WeatherAlertsParams = {
+    /** WeatherBit city ID (required) */
+    cityId: number;
+    /** Language code for localized responses (optional) */
+    language?: string;
+};
+/**
+ * Parameters for searching cities
+ */
+export type CitiesSearchParams = {
+    /** ISO country code filter (optional) */
+    countryCode?: string;
+    /** City name search query (optional) */
+    search?: string;
+};
 /**
  * Weather API for retrieving weather data
  *
- * Provides access to current conditions and forecasts through the TelemetryOS API.
+ * Provides access to current conditions, forecasts, alerts, and city search
+ * through the TelemetryOS weather API v2.
  */
 export declare class Weather {
     _client: Client;
     constructor(client: Client);
     /**
-     * Retrieves current weather conditions for a specified location.
+     * Searches for cities by name or country
+     *
+     * @param params - Search parameters including optional country code and search query
+     * @returns A promise that resolves to an array of matching cities
+     * @throws {Error} If the request fails
+     *
+     * @example
+     * ```typescript
+     * // Search for cities named "New York"
+     * const cities = await weather.getCities({ search: 'New York' })
+     *
+     * // Search for cities in the United States
+     * const cities = await weather.getCities({ countryCode: 'US' })
+     *
+     * // Get a cityId for use in other methods
+     * const cities = await weather.getCities({ search: 'London' })
+     * const cityId = cities[0].cityId
+     * ```
+     */
+    getCities(params: CitiesSearchParams): Promise<WeatherCity[]>;
+    /**
+     * Retrieves current weather conditions for a specified city
      *
-     * @param params - Weather request parameters including location and units
-     * @returns A promise that resolves to the current weather conditions
-     * @throws {Error} If the request fails or location is invalid
+     * @param params - Weather request parameters including cityId and optional language
+     * @returns A promise that resolves to the current weather conditions with dual units (C/F, kph/mph, etc.)
+     * @throws {Error} If the request fails or cityId is invalid
      *
      * @example
      * ```typescript
-     * // Get weather by city
-     * const weather = await weather.getConditions({ city: 'New York', units: 'imperial' })
+     * // Get current conditions for a city
+     * const conditions = await weather.getConditions({ cityId: 12345 })
      *
-     * // Get weather by postal code
-     * const weather = await weather.getConditions({ postalCode: '10001', units: 'metric' })
+     * // With localized language
+     * const conditions = await weather.getConditions({
+     *   cityId: 12345,
+     *   language: 'es'
+     * })
      *
-     * // Get weather by coordinates
-     * const weather = await weather.getConditions({ lat: '40.7128', lon: '-74.0060' })
+     * // Access both units
+     * console.log(`${conditions.temperatureC}°C / ${conditions.temperatureF}°F`)
+     * console.log(`${conditions.windSpeedKph} kph / ${conditions.windSpeedMph} mph`)
      * ```
      */
-    getConditions(params: WeatherRequestParams): Promise<WeatherConditions>;
+    getConditions(params: WeatherConditionsParams): Promise<WeatherConditions>;
     /**
-     * Retrieves daily weather forecast for a specified location.
+     * Retrieves daily weather forecast for a specified city
      *
-     * @param params - Forecast request parameters including location, units, and number of days
-     * @returns A promise that resolves to an array of daily forecast data
-     * @throws {Error} If the request fails or location is invalid
+     * @param params - Forecast request parameters including cityId, optional language and days
+     * @returns A promise that resolves to daily forecast data with location information
+     * @throws {Error} If the request fails or cityId is invalid
      *
      * @example
      * ```typescript
      * // Get 5-day forecast
-     * const forecast = await weather.getDailyForecast({
-     *   city: 'London',
-     *   units: 'metric',
-     *   days: 5
+     * const forecast = await weather.getDailyForecast({ cityId: 12345 })
+     *
+     * // Get 10-day forecast
+     * const forecast = await weather.getDailyForecast({ cityId: 12345, days: 10 })
+     *
+     * // Access forecast data
+     * forecast.data.forEach(day => {
+     *   console.log(`${day.forecastDate}: ${day.weatherDescription}`)
+     *   console.log(`High: ${day.maxTemperatureC}°C, Low: ${day.minTemperatureC}°C`)
      * })
      * ```
      */
-    getDailyForecast(params: DailyForecastParams): Promise<WeatherForecast[]>;
+    getDailyForecast(params: DailyForecastParams): Promise<DailyForecast>;
     /**
-     * Retrieves hourly weather forecast for a specified location.
+     * Retrieves hourly weather forecast for a specified city
      *
-     * @param params - Forecast request parameters including location, units, and number of hours
-     * @returns A promise that resolves to an array of hourly forecast data
-     * @throws {Error} If the request fails or location is invalid
+     * @param params - Forecast request parameters including cityId, optional language and hours
+     * @returns A promise that resolves to hourly forecast data with location information
+     * @throws {Error} If the request fails or cityId is invalid
      *
      * @example
      * ```typescript
      * // Get 24-hour forecast
-     * const forecast = await weather.getHourlyForecast({
-     *   city: 'Tokyo',
-     *   units: 'metric',
-     *   hours: 24
+     * const forecast = await weather.getHourlyForecast({ cityId: 12345, hours: 24 })
+     *
+     * // Get 48-hour forecast
+     * const forecast = await weather.getHourlyForecast({ cityId: 12345, hours: 48 })
+     *
+     * // Access forecast data
+     * forecast.data.forEach(hour => {
+     *   console.log(`${hour.forecastTimeLocal}: ${hour.weatherDescription}`)
+     *   console.log(`Temp: ${hour.temperatureC}°C`)
      * })
      * ```
      */
-    getHourlyForecast(params: HourlyForecastParams): Promise<WeatherForecast[]>;
+    getHourlyForecast(params: HourlyForecastParams): Promise<HourlyForecast>;
+    /**
+     * Retrieves weather alerts and warnings for a specified city
+     *
+     * @param params - Alert request parameters including cityId and optional language
+     * @returns A promise that resolves to weather alerts with location information
+     * @throws {Error} If the request fails or cityId is invalid
+     *
+     * @example
+     * ```typescript
+     * // Get weather alerts for a city
+     * const alerts = await weather.getAlerts({ cityId: 12345 })
+     *
+     * // Check if there are any active alerts
+     * if (alerts.alerts.length > 0) {
+     *   alerts.alerts.forEach(alert => {
+     *     console.log(`${alert.severity}: ${alert.title}`)
+     *     console.log(alert.description)
+     *   })
+     * }
+     * ```
+     */
+    getAlerts(params: WeatherAlertsParams): Promise<WeatherAlerts>;
 }
+export {};

package/package.json

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