@seamapi/types 1.329.0 → 1.330.0

package/lib/seam/connect/route-types.d.ts

@@ -4807,6 +4807,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{
@@ -8733,6 +8737,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{
@@ -8849,6 +8857,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{
@@ -8960,6 +8972,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{
@@ -9167,6 +9183,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{
@@ -9273,6 +9293,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{
@@ -14293,13 +14317,13 @@ export interface Routes {
                 /** ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts). */
                 connected_account_id: string;
                 event_type: 'thermostat.temperature_reached_set_point';
-                /** Temperature, in °C, reported by the thermostat. */
+                /** Temperature, in °C, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
                 temperature_celsius: number;
-                /** Temperature, in °F, reported by the thermostat. */
+                /** Temperature, in °F, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
                 temperature_fahrenheit: number;
-                /** Desired temperature, in °C, set by the thermostat's cooling or heating set point. */
+                /** Desired temperature, in °C, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
                 desired_temperature_celsius?: number | undefined;
-                /** Desired temperature, in °F, set by the thermostat's cooling or heating set point. */
+                /** Desired temperature, in °F, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
                 desired_temperature_fahrenheit?: number | undefined;
             } | {
                 /** ID of the event. */
@@ -15486,13 +15510,13 @@ export interface Routes {
                 /** ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts). */
                 connected_account_id: string;
                 event_type: 'thermostat.temperature_reached_set_point';
-                /** Temperature, in °C, reported by the thermostat. */
+                /** Temperature, in °C, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
                 temperature_celsius: number;
-                /** Temperature, in °F, reported by the thermostat. */
+                /** Temperature, in °F, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
                 temperature_fahrenheit: number;
-                /** Desired temperature, in °C, set by the thermostat's cooling or heating set point. */
+                /** Desired temperature, in °C, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
                 desired_temperature_celsius?: number | undefined;
-                /** Desired temperature, in °F, set by the thermostat's cooling or heating set point. */
+                /** Desired temperature, in °F, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
                 desired_temperature_fahrenheit?: number | undefined;
             } | {
                 /** ID of the event. */
@@ -33232,6 +33256,10 @@ export interface Routes {
                     created_at: string;
                     message: string;
                     warning_code: 'salto_ks_user_not_subscribed';
+                } | {
+                    created_at: string;
+                    message: string;
+                    warning_code: 'unknown_issue_with_acs_user';
                 }>;
                 /** Errors associated with the `acs_user`. */
                 errors: Array<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/types",
-  "version": "1.329.0",
+  "version": "1.330.0",
   "description": "TypeScript types for the Seam API.",
   "type": "module",
   "main": "index.js",

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

@@ -114,15 +114,31 @@ const acs_users_salto_ks_user_not_subscribed = common_acs_user_warning
     `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.`,
   )
 
+export const unknown_issue_with_acs_user = common_acs_user_warning
+  .extend({
+    warning_code: z.literal('unknown_issue_with_acs_user'),
+  })
+  .describe(
+    'An unknown issue occurred while syncing the state of this user with the provider. ' +
+      'This issue may affect the proper functioning of this user.',
+  )
+
 export const acs_users_warning_map = z.object({
   being_deleted: acs_users_being_deleted.optional().nullable(),
   salto_ks_user_not_subscribed: acs_users_salto_ks_user_not_subscribed
     .optional()
     .nullable(),
+  unknown_issue_with_acs_user: unknown_issue_with_acs_user
+    .optional()
+    .nullable(),
 })
 
 export const acs_users_warnings = z
-  .union([acs_users_being_deleted, acs_users_salto_ks_user_not_subscribed])
+  .union([
+    acs_users_being_deleted,
+    acs_users_salto_ks_user_not_subscribed,
+    unknown_issue_with_acs_user,
+  ])
   .describe('Warning associated with the `acs_user`.')
 
 export type AcsUsersWarningMap = z.infer<typeof acs_users_warning_map>

package/src/lib/seam/connect/models/events/devices.ts

@@ -599,26 +599,31 @@ export const temperature_reached_set_point_event = device_event.extend({
   event_type: z.literal('thermostat.temperature_reached_set_point'),
   temperature_celsius: z
     .number()
-    .describe('Temperature, in °C, reported by the thermostat.'),
+    .describe(
+      'Temperature, in °C, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
+    ),
   temperature_fahrenheit: z
     .number()
-    .describe('Temperature, in °F, reported by the thermostat.'),
+    .describe(
+      'Temperature, in °F, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
+    ),
   desired_temperature_celsius: z
     .number()
     .optional()
     .describe(
-      "Desired temperature, in °C, set by the thermostat's cooling or heating set point.",
+      "Desired temperature, in °C, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
     ),
   desired_temperature_fahrenheit: z
     .number()
     .optional()
     .describe(
-      "Desired temperature, in °F, set by the thermostat's cooling or heating set point.",
+      "Desired temperature, in °F, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
     ),
 }).describe(`
   ---
   route_path: /thermostats
   ---
+  A [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) temperature reading is within 1 °C of the configured cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).
 `)
 
 export type TemperatureReachedSetPointEvent = z.infer<

package/src/lib/seam/connect/openapi.ts

@@ -1660,6 +1660,20 @@ export default {
                   required: ['created_at', 'message', 'warning_code'],
                   type: 'object',
                 },
+                {
+                  description:
+                    'An unknown issue occurred while syncing the state of this user with the provider. This issue may affect the proper functioning of this user.',
+                  properties: {
+                    created_at: { format: 'date-time', type: 'string' },
+                    message: { type: 'string' },
+                    warning_code: {
+                      enum: ['unknown_issue_with_acs_user'],
+                      type: 'string',
+                    },
+                  },
+                  required: ['created_at', 'message', 'warning_code'],
+                  type: 'object',
+                },
               ],
             },
             type: 'array',
@@ -10553,6 +10567,8 @@ export default {
             'x-route-path': '/thermostats',
           },
           {
+            description:
+              "A [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) temperature reading is within 1 °C of the configured cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
             properties: {
               connected_account_id: {
                 description:
@@ -10567,13 +10583,13 @@ export default {
               },
               desired_temperature_celsius: {
                 description:
-                  "Desired temperature, in °C, set by the thermostat's cooling or heating set point.",
+                  "Desired temperature, in °C, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                 format: 'float',
                 type: 'number',
               },
               desired_temperature_fahrenheit: {
                 description:
-                  "Desired temperature, in °F, set by the thermostat's cooling or heating set point.",
+                  "Desired temperature, in °F, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points).",
                 format: 'float',
                 type: 'number',
               },
@@ -10597,12 +10613,14 @@ export default {
                 type: 'string',
               },
               temperature_celsius: {
-                description: 'Temperature, in °C, reported by the thermostat.',
+                description:
+                  'Temperature, in °C, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
                 format: 'float',
                 type: 'number',
               },
               temperature_fahrenheit: {
-                description: 'Temperature, in °F, reported by the thermostat.',
+                description:
+                  'Temperature, in °F, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats).',
                 format: 'float',
                 type: 'number',
               },
@@ -18051,6 +18069,27 @@ export default {
                                 ],
                                 type: 'object',
                               },
+                              {
+                                description:
+                                  'An unknown issue occurred while syncing the state of this user with the provider. This issue may affect the proper functioning of this user.',
+                                properties: {
+                                  created_at: {
+                                    format: 'date-time',
+                                    type: 'string',
+                                  },
+                                  message: { type: 'string' },
+                                  warning_code: {
+                                    enum: ['unknown_issue_with_acs_user'],
+                                    type: 'string',
+                                  },
+                                },
+                                required: [
+                                  'created_at',
+                                  'message',
+                                  'warning_code',
+                                ],
+                                type: 'object',
+                              },
                             ],
                           },
                           type: 'array',
@@ -18448,6 +18487,27 @@ export default {
                                   ],
                                   type: 'object',
                                 },
+                                {
+                                  description:
+                                    'An unknown issue occurred while syncing the state of this user with the provider. This issue may affect the proper functioning of this user.',
+                                  properties: {
+                                    created_at: {
+                                      format: 'date-time',
+                                      type: 'string',
+                                    },
+                                    message: { type: 'string' },
+                                    warning_code: {
+                                      enum: ['unknown_issue_with_acs_user'],
+                                      type: 'string',
+                                    },
+                                  },
+                                  required: [
+                                    'created_at',
+                                    'message',
+                                    'warning_code',
+                                  ],
+                                  type: 'object',
+                                },
                               ],
                             },
                             type: 'array',

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

@@ -5622,6 +5622,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<
@@ -10332,6 +10337,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<
@@ -10472,6 +10482,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<
@@ -10607,6 +10622,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<
@@ -10861,6 +10881,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<
@@ -10991,6 +11016,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<
@@ -17371,13 +17401,13 @@ export interface Routes {
                 /** ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts). */
                 connected_account_id: string
                 event_type: 'thermostat.temperature_reached_set_point'
-                /** Temperature, in °C, reported by the thermostat. */
+                /** Temperature, in °C, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
                 temperature_celsius: number
-                /** Temperature, in °F, reported by the thermostat. */
+                /** Temperature, in °F, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
                 temperature_fahrenheit: number
-                /** Desired temperature, in °C, set by the thermostat's cooling or heating set point. */
+                /** Desired temperature, in °C, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
                 desired_temperature_celsius?: number | undefined
-                /** Desired temperature, in °F, set by the thermostat's cooling or heating set point. */
+                /** Desired temperature, in °F, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
                 desired_temperature_fahrenheit?: number | undefined
               }
             | {
@@ -18804,13 +18834,13 @@ export interface Routes {
             /** ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts). */
             connected_account_id: string
             event_type: 'thermostat.temperature_reached_set_point'
-            /** Temperature, in °C, reported by the thermostat. */
+            /** Temperature, in °C, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
             temperature_celsius: number
-            /** Temperature, in °F, reported by the thermostat. */
+            /** Temperature, in °F, reported by the [thermostat](https://docs.seam.co/latest/capability-guides/thermostats). */
             temperature_fahrenheit: number
-            /** Desired temperature, in °C, set by the thermostat's cooling or heating set point. */
+            /** Desired temperature, in °C, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
             desired_temperature_celsius?: number | undefined
-            /** Desired temperature, in °F, set by the thermostat's cooling or heating set point. */
+            /** Desired temperature, in °F, defined by the [thermostat's](https://docs.seam.co/latest/capability-guides/thermostats) cooling or heating [set point](https://docs.seam.co/latest/capability-guides/thermostats/understanding-thermostat-concepts/set-points). */
             desired_temperature_fahrenheit?: number | undefined
           }
         | {
@@ -41067,6 +41097,11 @@ export interface Routes {
               message: string
               warning_code: 'salto_ks_user_not_subscribed'
             }
+          | {
+              created_at: string
+              message: string
+              warning_code: 'unknown_issue_with_acs_user'
+            }
         >
         /** Errors associated with the `acs_user`. */
         errors: Array<