@seamapi/types 1.324.0 → 1.326.0

package/package.json

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

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

@@ -26,13 +26,128 @@ const common_device_error = z.object({
   is_device_error: z.literal(true),
 })
 
+const error_code_description =
+  'Unique identifier of the type of error. Enables quick recognition and categorization of the issue.'
+
 const common_device_warning = z.object({
   message: z.string(),
 })
 
-export const device_error = common_device_error.extend({
-  error_code: z.string(),
-})
+const device_offline = common_device_error
+  .extend({
+    error_code: z.literal('device_offline').describe(error_code_description),
+  })
+  .describe('Device is offline')
+
+const device_removed = common_device_error
+  .extend({
+    error_code: z.literal('device_removed').describe(error_code_description),
+  })
+  .describe('Device has been removed')
+
+const account_disconnected = common_device_error
+  .extend({
+    error_code: z
+      .literal('account_disconnected')
+      .describe(error_code_description),
+  })
+  .describe('Account is disconnected')
+
+const hub_disconnected = common_device_error
+  .extend({
+    error_code: z.literal('hub_disconnected').describe(error_code_description),
+  })
+  .describe('Hub is disconnected')
+
+const device_disconnected = common_device_error
+  .extend({
+    error_code: z
+      .literal('device_disconnected')
+      .describe(error_code_description),
+  })
+  .describe('Device is disconnected')
+
+const empty_backup_access_code_pool = common_device_error
+  .extend({
+    error_code: z
+      .literal('empty_backup_access_code_pool')
+      .describe(error_code_description),
+  })
+  .describe('The backup access code pool is empty.')
+
+const august_lock_not_authorized = common_device_error
+  .extend({
+    error_code: z
+      .literal('august_lock_not_authorized')
+      .describe(error_code_description),
+  })
+  .describe('User is not authorized to use the August Lock.')
+
+const august_lock_missing_bridge = common_device_error
+  .extend({
+    error_code: z
+      .literal('august_lock_missing_bridge')
+      .describe(error_code_description),
+  })
+  .describe('Lock is not connected to the Seam Bridge.')
+
+const salto_site_user_limit_reached = common_device_error
+  .extend({
+    error_code: z
+      .literal('salto_site_user_limit_reached')
+      .describe(error_code_description),
+  })
+  .describe('Salto site user limit reached.')
+
+const ttlock_lock_not_paired_to_gateway = common_device_error
+  .extend({
+    error_code: z
+      .literal('ttlock_lock_not_paired_to_gateway')
+      .describe(error_code_description),
+  })
+  .describe('Lock is not paired with a Gateway.')
+
+const missing_device_credentials = common_device_error
+  .extend({
+    error_code: z
+      .literal('missing_device_credentials')
+      .describe(error_code_description),
+  })
+  .describe('Missing device credentials.')
+
+const auxiliary_heat_running = common_device_error
+  .extend({
+    error_code: z
+      .literal('auxiliary_heat_running')
+      .describe(error_code_description),
+  })
+  .describe('The auxiliary heat is running.')
+
+const subscription_required = common_device_error
+  .extend({
+    error_code: z
+      .literal('subscription_required')
+      .describe(error_code_description),
+  })
+  .describe('Subscription required to connect.')
+
+export const device_error = z
+  .union([
+    device_offline,
+    device_removed,
+    account_disconnected,
+    hub_disconnected,
+    device_disconnected,
+    empty_backup_access_code_pool,
+    august_lock_not_authorized,
+    august_lock_missing_bridge,
+    salto_site_user_limit_reached,
+    ttlock_lock_not_paired_to_gateway,
+    missing_device_credentials,
+    auxiliary_heat_running,
+    subscription_required,
+  ])
+  .describe('Error associated with the `device`.')
 
 export type DeviceError = z.infer<typeof device_error>
 

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

@@ -561,6 +561,32 @@ export type TemperatureThresholdNoLongerExceededEvent = z.infer<
   typeof temperature_threshold_no_longer_exceeded_event
 >
 
+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.'),
+  temperature_fahrenheit: z
+    .number()
+    .describe('Temperature, in °F, reported by the thermostat.'),
+  desired_temperature_celsius: z
+    .number()
+    .optional()
+    .describe(
+      "Desired temperature, in °C, set by the thermostat's cooling or heating set point.",
+    ),
+  desired_temperature_fahrenheit: z
+    .number()
+    .optional()
+    .describe(
+      "Desired temperature, in °F, set by the thermostat's cooling or heating set point.",
+    ),
+})
+
+export type TemperatureReachedSetPointEvent = z.infer<
+  typeof temperature_reached_set_point_event
+>
+
 export const device_events = [
   device_connected_event,
   device_added_event,
@@ -592,4 +618,5 @@ export const device_events = [
   thermostat_manually_adjusted_event,
   temperature_threshold_exceeded_event,
   temperature_threshold_no_longer_exceeded_event,
+  temperature_reached_set_point_event,
 ] as const