@seamapi/types 1.239.0 → 1.241.0

package/lib/seam/connect/schemas.d.ts

@@ -1 +1 @@
-export { access_code, acs_access_group, acs_credential, acs_entrance, acs_system, acs_user, action_attempt, client_session, climate_setting_schedule, connect_webview, connected_account, custom_metadata, device, device_provider, noise_threshold, seam_event, unmanaged_access_code, unmanaged_acs_access_group, unmanaged_acs_credential, unmanaged_acs_user, unmanaged_device, user_identity, webhook, workspace, } from './models/index.js';
+export { access_code, acs_access_group, acs_credential, acs_entrance, acs_system, acs_user, action_attempt, client_session, connect_webview, connected_account, custom_metadata, device, device_provider, noise_threshold, seam_event, thermostat_schedule, unmanaged_access_code, unmanaged_acs_access_group, unmanaged_acs_credential, unmanaged_acs_user, unmanaged_device, user_identity, webhook, workspace, } from './models/index.js';

package/lib/seam/connect/schemas.js

@@ -1,2 +1,2 @@
-export { access_code, acs_access_group, acs_credential, acs_entrance, acs_system, acs_user, action_attempt, client_session, climate_setting_schedule, connect_webview, connected_account, custom_metadata, device, device_provider, noise_threshold, seam_event, unmanaged_access_code, unmanaged_acs_access_group, unmanaged_acs_credential, unmanaged_acs_user, unmanaged_device, user_identity, webhook, workspace, } from './models/index.js';
+export { access_code, acs_access_group, acs_credential, acs_entrance, acs_system, acs_user, action_attempt, client_session, connect_webview, connected_account, custom_metadata, device, device_provider, noise_threshold, seam_event, thermostat_schedule, unmanaged_access_code, unmanaged_acs_access_group, unmanaged_acs_credential, unmanaged_acs_user, unmanaged_device, user_identity, webhook, workspace, } from './models/index.js';
 //# sourceMappingURL=schemas.js.map

package/lib/seam/connect/schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,eAAe,EACf,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,SAAS,GACV,MAAM,mBAAmB,CAAA"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/lib/seam/connect/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,MAAM,EACN,eAAe,EACf,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,SAAS,GACV,MAAM,mBAAmB,CAAA"}

package/lib/seam/devicedb/models/device-model.d.ts

@@ -365,8 +365,8 @@ export declare const base_device_model_v1: z.ZodObject<{
         seam_api_guide: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, "device_model_count">, "strip", z.ZodTypeAny, {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -392,8 +392,8 @@ export declare const base_device_model_v1: z.ZodObject<{
         us_customer_support_contact_url?: string | undefined;
         seam_api_guide?: string | undefined;
     }, {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -522,8 +522,8 @@ export declare const base_device_model_v1: z.ZodObject<{
     display_name: string;
     device_model_id: string;
     manufacturer: {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -582,8 +582,8 @@ export declare const base_device_model_v1: z.ZodObject<{
     display_name: string;
     device_model_id: string;
     manufacturer: {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -684,8 +684,8 @@ export declare const device_model_v1: z.ZodIntersection<z.ZodObject<{
         seam_api_guide: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
     }, "device_model_count">, "strip", z.ZodTypeAny, {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -711,8 +711,8 @@ export declare const device_model_v1: z.ZodIntersection<z.ZodObject<{
         us_customer_support_contact_url?: string | undefined;
         seam_api_guide?: string | undefined;
     }, {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -841,8 +841,8 @@ export declare const device_model_v1: z.ZodIntersection<z.ZodObject<{
     display_name: string;
     device_model_id: string;
     manufacturer: {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;
@@ -901,8 +901,8 @@ export declare const device_model_v1: z.ZodIntersection<z.ZodObject<{
     display_name: string;
     device_model_id: string;
     manufacturer: {
-        manufacturer_id: string;
         display_name: string;
+        manufacturer_id: string;
         integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
         is_connect_webview_supported: boolean;

package/lib/seam/devicedb/models/manufacturer.d.ts

@@ -58,8 +58,8 @@ export declare const manufacturer: z.ZodObject<{
     seam_api_guide: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    manufacturer_id: string;
     display_name: string;
+    manufacturer_id: string;
     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
     is_connect_webview_supported: boolean;
@@ -86,8 +86,8 @@ export declare const manufacturer: z.ZodObject<{
     us_customer_support_contact_url?: string | undefined;
     seam_api_guide?: string | undefined;
 }, {
-    manufacturer_id: string;
     display_name: string;
+    manufacturer_id: string;
     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
     is_connect_webview_supported: boolean;

package/lib/seam/devicedb/route-specs.d.ts

@@ -57,8 +57,8 @@ export declare const routes: {
                     seam_api_guide: z.ZodOptional<z.ZodString>;
                     description: z.ZodOptional<z.ZodString>;
                 }, "device_model_count">, "strip", z.ZodTypeAny, {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -84,8 +84,8 @@ export declare const routes: {
                     us_customer_support_contact_url?: string | undefined;
                     seam_api_guide?: string | undefined;
                 }, {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -214,8 +214,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -274,8 +274,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -588,8 +588,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -711,8 +711,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -909,8 +909,8 @@ export declare const routes: {
                     seam_api_guide: z.ZodOptional<z.ZodString>;
                     description: z.ZodOptional<z.ZodString>;
                 }, "device_model_count">, "strip", z.ZodTypeAny, {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -936,8 +936,8 @@ export declare const routes: {
                     us_customer_support_contact_url?: string | undefined;
                     seam_api_guide?: string | undefined;
                 }, {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -1066,8 +1066,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -1126,8 +1126,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -1440,8 +1440,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -1563,8 +1563,8 @@ export declare const routes: {
                 display_name: string;
                 device_model_id: string;
                 manufacturer: {
-                    manufacturer_id: string;
                     display_name: string;
+                    manufacturer_id: string;
                     integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                     is_connect_webview_supported: boolean;
@@ -1737,8 +1737,8 @@ export declare const routes: {
                 seam_api_guide: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -1765,8 +1765,8 @@ export declare const routes: {
                 us_customer_support_contact_url?: string | undefined;
                 seam_api_guide?: string | undefined;
             }, {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -1795,8 +1795,8 @@ export declare const routes: {
             }>;
         }, "strip", z.ZodTypeAny, {
             manufacturer: {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -1825,8 +1825,8 @@ export declare const routes: {
             };
         }, {
             manufacturer: {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -1917,8 +1917,8 @@ export declare const routes: {
                 seam_api_guide: z.ZodOptional<z.ZodString>;
                 description: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -1945,8 +1945,8 @@ export declare const routes: {
                 us_customer_support_contact_url?: string | undefined;
                 seam_api_guide?: string | undefined;
             }, {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -1975,8 +1975,8 @@ export declare const routes: {
             }>, "many">;
         }, "strip", z.ZodTypeAny, {
             manufacturers: {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;
@@ -2005,8 +2005,8 @@ export declare const routes: {
             }[];
         }, {
             manufacturers: {
-                manufacturer_id: string;
                 display_name: string;
+                manufacturer_id: string;
                 integration: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 integration_support_level: "beta" | "stable" | "planned" | "unsupported" | "inquire";
                 is_connect_webview_supported: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/types",
-  "version": "1.239.0",
+  "version": "1.241.0",
   "description": "TypeScript types for the Seam API.",
   "type": "module",
   "main": "index.js",
@@ -92,7 +92,7 @@
     "zod": "^3.21.4"
   },
   "devDependencies": {
-    "@seamapi/blueprint": "^0.16.0",
+    "@seamapi/blueprint": "^0.19.0",
     "@types/node": "^20.8.10",
     "concurrently": "^8.2.0",
     "del-cli": "^5.0.0",

package/src/lib/seam/connect/internal/schemas.ts

@@ -17,8 +17,7 @@ export {
   any_device_type,
   battery_status,
   capabilities,
-  climate_setting,
-  climate_setting_schedule,
+  climate_preset,
   common_device_properties,
   connect_webview_device_selection_mode,
   connected_account,
@@ -38,6 +37,7 @@ export {
   phone_number,
   thermostat_capability_properties,
   thermostat_device_type,
+  thermostat_schedule,
   unmanaged_access_code,
   unmanaged_device,
   user_identity,

package/src/lib/seam/connect/model-types.ts

@@ -9,7 +9,6 @@ export type {
   AcsUser,
   ActionAttempt,
   ClientSession,
-  ClimateSettingSchedule,
   ConnectedAccount,
   ConnectedAccountError,
   ConnectedAccountWarning,
@@ -22,6 +21,7 @@ export type {
   NoiseThreshold,
   SeamEvent,
   SeamEventType,
+  ThermostatSchedule,
   UnmanagedAccessCode,
   UnmanagedDevice,
   UserIdentity,

package/src/lib/seam/connect/models/acs/acs-user.ts

@@ -13,18 +13,87 @@ export const acs_user_external_type = z.enum([
 
 export type AcsUserExternalType = z.infer<typeof acs_user_external_type>
 
+const common_acs_user_error = z.object({
+  created_at: z
+    .string()
+    .datetime()
+    .describe('Date and time at which Seam created the error.'),
+  message: z
+    .string()
+    .describe(
+      'Detailed description of the error. Provides insights into the issue and potentially how to rectify it.',
+    ),
+})
+
+const acs_users_user_deleted_externally = common_acs_user_error
+  .extend({
+    error_code: z.literal('user_deleted_externally'),
+  })
+  .describe(
+    `Indicates that the user was deleted from the ACS system outside of Seam.`,
+  )
+
+const acs_users_salto_ks_subscription_limit_exceeded = common_acs_user_error
+  .extend({
+    error_code: z.literal('salto_ks_subscription_limit_exceeded'),
+  })
+  .describe(
+    `Indicates that the user could not be subscribed on Salto KS because the subscription limit has been exceeded.`,
+  )
+
+const acs_users_salto_site_user_limit_reached = common_acs_user_error.extend({
+  error_code: z.literal('salto_site_user_limit_reached'),
+})
+
+const acs_user_errors = z
+  .union([
+    acs_users_user_deleted_externally,
+    acs_users_salto_ks_subscription_limit_exceeded,
+    acs_users_salto_site_user_limit_reached,
+  ])
+  .describe('Error associated with the `acs_user`.')
+
+export const acs_users_error_map = z.object({
+  user_deleted_externally: acs_users_user_deleted_externally
+    .optional()
+    .nullable(),
+  salto_ks_subscription_limit_exceeded:
+    acs_users_salto_ks_subscription_limit_exceeded.optional().nullable(),
+  salto_site_user_limit_reached: acs_users_salto_site_user_limit_reached
+    .optional()
+    .nullable(),
+})
+
+export type AcsUsersErrorMap = z.infer<typeof acs_users_error_map>
+
 const common_acs_users_warning = z.object({
   created_at: z.string().datetime(),
   message: z.string(),
 })
 
-const acs_users_being_deleted = common_acs_users_warning.extend({
-  warning_code: z.literal('being_deleted'),
-})
+const acs_users_being_deleted = common_acs_users_warning
+  .extend({
+    warning_code: z.literal('being_deleted'),
+  })
+  .describe(
+    `Indicates that the user is being deleted from the ACS system. This is a temporary state, and the user will be deleted shortly.`,
+  )
 
-const acs_users_salto_ks_user_not_subscribed = common_acs_users_warning.extend({
-  warning_code: z.literal('salto_ks_user_not_subscribed'),
-})
+const acs_users_salto_ks_user_not_subscribed = common_acs_users_warning
+  .extend({
+    warning_code: z.literal('salto_ks_user_not_subscribed'),
+  })
+  .describe(
+    `Indicates that the user is not subscribed on the Salto KS, so they cannot unlock doors or perform any actions. This occur when the their access schedule hasn’t started yet, or if their access schedule has ended, or if the site has reached its limit for active users (subscription slots), or if they have been manually unsubscribed.`,
+  )
+
+const acs_users_failed_to_update_on_acs_system = common_acs_users_warning
+  .extend({
+    warning_code: z.literal('failed_to_update_on_acs_system'),
+  })
+  .describe(
+    `Indicates that the user was not updated on the ACS system. This is likely due to an internal unexpected error. Please contact Seam's support if you encounter this.`,
+  )
 
 // TODO: Some acs_users already have this warning, so we need to keep it here until we migrate
 const acs_users_salto_site_user_suspended = common_acs_users_warning.extend({
@@ -33,6 +102,9 @@ const acs_users_salto_site_user_suspended = common_acs_users_warning.extend({
 
 export const acs_users_warning_map = z.object({
   being_deleted: acs_users_being_deleted.optional().nullable(),
+  failed_to_update_on_acs_system: acs_users_failed_to_update_on_acs_system
+    .optional()
+    .nullable(),
   salto_ks_user_not_subscribed: acs_users_salto_ks_user_not_subscribed
     .optional()
     .nullable(),
@@ -41,11 +113,14 @@ export const acs_users_warning_map = z.object({
     .nullable(),
 })
 
-export const acs_users_warning = z.union([
-  acs_users_being_deleted,
-  acs_users_salto_ks_user_not_subscribed,
-  acs_users_salto_site_user_suspended,
-])
+export const acs_users_warnings = z
+  .union([
+    acs_users_being_deleted,
+    acs_users_failed_to_update_on_acs_system,
+    acs_users_salto_ks_user_not_subscribed,
+    acs_users_salto_site_user_suspended,
+  ])
+  .describe('Warning associated with the `acs_user`.')
 
 export type AcsUsersWarningMap = z.infer<typeof acs_users_warning_map>
 
@@ -81,8 +156,8 @@ const common_acs_user = z
       .datetime()
       .optional(),
     is_latest_desired_state_synced_with_provider: z.boolean().optional(),
-    warnings: z.array(acs_users_warning),
-    errors: z.any(),
+    warnings: z.array(acs_users_warnings),
+    errors: z.array(acs_user_errors),
   })
   .merge(user_fields)
 

package/src/lib/seam/connect/models/action-attempts/action-attempt.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 
+import { activate_climate_preset_action_attempt } from './activate-climate-preset.js'
 import { deprecated_action_attempts } from './deprecated.js'
 import { lock_door_action_attempt } from './lock-door.js'
 import { reset_sandbox_workspace_action_attempt } from './reset-sandbox-workspace.js'
@@ -19,6 +20,7 @@ export const action_attempt = z.union([
   ...set_heat_cool_action_attempt.options,
   ...set_fan_mode_action_attempt.options,
   ...set_thermostat_off_action_attempt.options,
+  ...activate_climate_preset_action_attempt.options,
   ...deprecated_action_attempts,
 ])
 

package/src/lib/seam/connect/models/action-attempts/activate-climate-preset.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod'
+
+import {
+  common_failed_action_attempt,
+  common_pending_action_attempt,
+  common_succeeded_action_attempt,
+} from './common.js'
+
+const action_type = z.literal('ACTIVATE_CLIMATE_PRESET')
+
+const error = z.object({
+  type: z.string(),
+  message: z.string(),
+})
+
+const result = z.object({})
+
+export const activate_climate_preset_action_attempt = z.discriminatedUnion(
+  'status',
+  [
+    common_pending_action_attempt
+      .extend({
+        action_type,
+      })
+      .describe('Activating climate preset.'),
+    common_succeeded_action_attempt
+      .extend({
+        action_type,
+        result,
+      })
+      .describe('Activating climate preset succeeded.'),
+    common_failed_action_attempt
+      .extend({ action_type, error })
+      .describe('Activating climate preset failed.'),
+  ],
+)

package/src/lib/seam/connect/models/devices/capability-properties/thermostat.ts

@@ -1,10 +1,11 @@
 import { z } from 'zod'
 
 import {
+  climate_preset,
   climate_setting,
-  climate_setting_schedule,
   fan_mode_setting,
   hvac_mode_setting,
+  thermostat_schedule,
 } from '../../thermostats/index.js'
 
 export const thermostat_capability_properties = z
@@ -16,7 +17,11 @@ export const thermostat_capability_properties = z
     is_heating: z.boolean(),
     is_cooling: z.boolean(),
     is_fan_running: z.boolean(),
-    fan_mode_setting,
+    fan_mode_setting: fan_mode_setting.describe(`
+      ---
+      deprecated: use current_climate_setting.fan_mode_setting instead.
+      ---
+    `),
 
     /**
      * this is true if the current thermostat settings differ that what is on seam, and `current_climate_setting.manual_override_allowed: true`
@@ -24,12 +29,17 @@ export const thermostat_capability_properties = z
     is_temporary_manual_override_active: z.boolean(),
 
     /**
-     * can be derived from `default_climate_setting`, or `active_climate_setting_schedule` if one is active
+     * can be derived from `fallback_climate_preset_key`, or `active_thermostat_schedule` if one is active
      */
     current_climate_setting: climate_setting,
-    default_climate_setting: climate_setting,
-    is_climate_setting_schedule_active: z.boolean(),
-    active_climate_setting_schedule: climate_setting_schedule,
+    default_climate_setting: climate_setting.describe(`
+      ---
+      deprecated: use fallback_climate_preset_key to specify a fallback climate preset instead.
+      ---
+    `),
+    available_climate_presets: z.array(climate_preset),
+    fallback_climate_preset_key: z.string().min(1).nullable().default(null),
+    active_thermostat_schedule: thermostat_schedule.nullable().default(null),
     min_cooling_set_point_celsius: z.number(),
     min_cooling_set_point_fahrenheit: z.number(),
     max_cooling_set_point_celsius: z.number(),

package/src/lib/seam/connect/models/thermostats/climate-preset.ts

@@ -0,0 +1,24 @@
+import { z } from 'zod'
+
+import { fan_mode_setting, hvac_mode_setting } from './modes.js'
+
+export const climate_preset = z.object({
+  climate_preset_key: z.string(),
+  can_edit: z.boolean(),
+  can_delete: z.boolean(),
+  name: z.string().nullable(),
+  display_name: z.string(),
+  fan_mode_setting: fan_mode_setting.optional(),
+  hvac_mode_setting: hvac_mode_setting.optional(),
+  cooling_set_point_celsius: z.number().optional(),
+  heating_set_point_celsius: z.number().optional(),
+  cooling_set_point_fahrenheit: z.number().optional(),
+  heating_set_point_fahrenheit: z.number().optional(),
+  manual_override_allowed: z.boolean(),
+})
+
+export type ClimatePreset = z.infer<typeof climate_preset>
+
+export const climate_setting = climate_preset.partial()
+
+export type ClimateSetting = z.infer<typeof climate_setting>

package/src/lib/seam/connect/models/thermostats/climate-setting-schedule.ts

@@ -1,22 +1,19 @@
 import { z } from 'zod'
 
-import { climate_setting } from './climate-setting.js'
+export const thermostat_schedule = z.object({
+  thermostat_schedule_id: z.string().uuid(),
+  device_id: z.string().uuid(),
+  name: z.string().optional(),
+  climate_preset_key: z.string(),
+  max_override_period_minutes: z.number().int().nonnegative().default(0),
+  starts_at: z.string().datetime(),
+  ends_at: z.string().datetime(),
+  created_at: z.string().datetime(),
+  errors: z
+    .any()
+    .describe(
+      'Collection of errors associated with the thermostat schedule, structured in a dictionary format. A unique "error_code" keys each error. Each error entry is an object containing two fields: "message" and "created_at." "message" is a string that describes the error. "created_at" is a date that indicates when the error was generated. This structure enables detailed tracking and timely response to critical issues.',
+    ),
+})
 
-export const climate_setting_schedule = z
-  .object({
-    climate_setting_schedule_id: z.string().uuid(),
-    schedule_type: z.literal('time_bound'),
-    device_id: z.string().uuid(),
-    name: z.string().optional(),
-    schedule_starts_at: z.string(),
-    schedule_ends_at: z.string(),
-    created_at: z.string().datetime(),
-    errors: z
-      .any()
-      .describe(
-        'Collection of errors associated with the access code, structured in a dictionary format. A unique "error_code" keys each error. Each error entry is an object containing two fields: "message" and "created_at." "message" is a string that describes the error. "created_at" is a date that indicates when the error was generated. This structure enables detailed tracking and timely response to critical issues.',
-      ),
-  })
-  .merge(climate_setting.partial())
-
-export type ClimateSettingSchedule = z.infer<typeof climate_setting_schedule>
+export type ThermostatSchedule = z.infer<typeof thermostat_schedule>