@seamapi/types 1.323.0 → 1.325.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seamapi/types",
-  "version": "1.323.0",
+  "version": "1.325.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/access-codes.ts

@@ -3,38 +3,39 @@ import { z } from 'zod'
 import { common_event } from './common.js'
 
 const access_code_event = common_event.extend({
-  access_code_id: z.string().uuid().describe(`
-    ---
-    title: Access Code ID
-    ---
-    The ID of the access code.
-  `),
-  device_id: z.string().uuid().describe(`
-    ---
-    title: Device ID
-    ---
-    The ID of the device.
-  `),
-  connected_account_id: z.string().uuid().describe(`
-    ---
-    title: Connected Account ID
-    ---
-    The ID of the connected account.
-  `),
+  access_code_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).',
+    ),
+  device_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [device](https://docs.seam.co/latest/core-concepts/devices).',
+    ),
+  connected_account_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts).',
+    ),
 })
 
-const code = z.string().describe(`
-  ---
-  title: Access Code
-  ---
-  The code of the access code.
-`)
+const code = z
+  .string()
+  .describe(
+    'Code for the [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes).',
+  )
 
 export const access_code_created_event = access_code_event
   .extend({
     event_type: z.literal('access_code.created'),
   })
-  .describe('An access code was created.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was created.',
+  )
 
 export type AccessCodeCreatedEvent = z.infer<typeof access_code_created_event>
 
@@ -42,7 +43,9 @@ export const access_code_changed_event = access_code_event
   .extend({
     event_type: z.literal('access_code.changed'),
   })
-  .describe('An access code was changed.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was changed.',
+  )
 
 export type AccessCodeChangedEvent = z.infer<typeof access_code_changed_event>
 
@@ -51,7 +54,9 @@ export const access_code_scheduled_on_device_event = access_code_event
     event_type: z.literal('access_code.scheduled_on_device'),
     code,
   })
-  .describe('An access code was natively scheduled on a device.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was [scheduled natively](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes#native-scheduling) on a device.',
+  )
 
 export type AccessCodeScheduledOnDeviceEvent = z.infer<
   typeof access_code_scheduled_on_device_event
@@ -62,7 +67,9 @@ export const access_code_set_on_device_event = access_code_event
     event_type: z.literal('access_code.set_on_device'),
     code,
   })
-  .describe('An access code was set on a device.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was set on a device.',
+  )
 
 export type AccessCodeSetOnDeviceEvent = z.infer<
   typeof access_code_set_on_device_event
@@ -72,7 +79,9 @@ export const access_code_removed_from_device_event = access_code_event
   .extend({
     event_type: z.literal('access_code.removed_from_device'),
   })
-  .describe('An access code was removed from a device.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was removed from a device.',
+  )
 
 export type AccessCodeRemovedFromDeviceEvent = z.infer<
   typeof access_code_removed_from_device_event
@@ -83,7 +92,7 @@ export const access_code_delay_in_setting_on_device_event = access_code_event
     event_type: z.literal('access_code.delay_in_setting_on_device'),
   })
   .describe(
-    'There was an unusually long delay in setting an access code on a device.',
+    'There was an unusually long delay in setting an [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) on a device.',
   )
 
 export type AccessCodeDelayInSettingOnDeviceEvent = z.infer<
@@ -94,7 +103,9 @@ export const access_code_failed_to_set_on_device_event = access_code_event
   .extend({
     event_type: z.literal('access_code.failed_to_set_on_device'),
   })
-  .describe('An access code failed to be set on a device.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) failed to be set on a device.',
+  )
 
 export type AccessCodeFailedToSetOnDeviceEvent = z.infer<
   typeof access_code_failed_to_set_on_device_event
@@ -105,7 +116,9 @@ export const access_code_deleted_event = access_code_event
     event_type: z.literal('access_code.deleted'),
     code: code.nullable(),
   })
-  .describe('An access code was deleted.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was deleted.',
+  )
 
 export type AccessCodeDeletedEvent = z.infer<typeof access_code_deleted_event>
 
@@ -114,7 +127,7 @@ export const access_code_delay_in_removing_from_device_event = access_code_event
     event_type: z.literal('access_code.delay_in_removing_from_device'),
   })
   .describe(
-    'There was an unusually long delay in removing an access code from a device.',
+    'There was an unusually long delay in removing an [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) from a device.',
   )
 
 export type AccessCodeDelayInRemovingFromDeviceEvent = z.infer<
@@ -125,7 +138,9 @@ export const access_code_failed_to_remove_from_device_event = access_code_event
   .extend({
     event_type: z.literal('access_code.failed_to_remove_from_device'),
   })
-  .describe('An access code failed to be removed from a device.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) failed to be removed from a device.',
+  )
 
 export type AccessCodeFailedToRemoveFromDeviceEvent = z.infer<
   typeof access_code_failed_to_remove_from_device_event
@@ -135,7 +150,9 @@ export const access_code_modified_external_to_seam_event = access_code_event
   .extend({
     event_type: z.literal('access_code.modified_external_to_seam'),
   })
-  .describe('An access code was modified external to Seam.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was modified outside of Seam.',
+  )
 
 export type AccessCodeModifiedExternalToSeamEvent = z.infer<
   typeof access_code_modified_external_to_seam_event
@@ -145,7 +162,9 @@ export const access_code_deleted_external_to_seam_event = access_code_event
   .extend({
     event_type: z.literal('access_code.deleted_external_to_seam'),
   })
-  .describe('An access code was deleted external to Seam.')
+  .describe(
+    'An [access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes) was deleted outside of Seam.',
+  )
 
 export type AccessCodeDeletedExternalToSeamEvent = z.infer<
   typeof access_code_deleted_external_to_seam_event
@@ -157,7 +176,7 @@ export const access_code_backup_access_code_pulled_event = access_code_event
     backup_access_code_id: z.string(),
   })
   .describe(
-    'A backup access code was pulled from the backup access code pool and set on a device.',
+    'A [backup access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/backup-access-codes) was pulled from the backup access code pool and set on a device.',
   )
 
 export type AccessCodeBackupAccessCodePulledEvent = z.infer<
@@ -170,7 +189,7 @@ export const unmanaged_access_code_converted_to_managed_event =
       event_type: z.literal('access_code.unmanaged.converted_to_managed'),
     })
     .describe(
-      'An unmanaged access code was successfully converted to a managed access code.',
+      'An [unmanaged access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/migrating-existing-access-codes) was converted successfully to a managed access code.',
     )
 
 export type UnmanagedAccessCodeConvertedToManagedEvent = z.infer<
@@ -185,7 +204,7 @@ export const unmanaged_access_code_failed_to_convert_to_managed_event =
       ),
     })
     .describe(
-      'An unmanaged access code failed to be converted to a managed access code.',
+      'An [unmanaged access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/migrating-existing-access-codes) failed to be converted to a managed access code.',
     )
 
 export type UnmanagedAccessCodeFailedToConvertToManagedEvent = z.infer<
@@ -196,7 +215,9 @@ export const unmanaged_access_code_created_event = access_code_event
   .extend({
     event_type: z.literal('access_code.unmanaged.created'),
   })
-  .describe('An unmanaged access code was created on a device.')
+  .describe(
+    'An [unmanaged access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/migrating-existing-access-codes) was created on a device.',
+  )
 
 export type UnmanagedAccessCodeCreatedEvent = z.infer<
   typeof unmanaged_access_code_created_event
@@ -206,7 +227,9 @@ export const unmanaged_access_code_removed_event = access_code_event
   .extend({
     event_type: z.literal('access_code.unmanaged.removed'),
   })
-  .describe('An unmanaged access code was removed from a device.')
+  .describe(
+    'An [unmanaged access code](https://docs.seam.co/latest/capability-guides/smart-locks/access-codes/migrating-existing-access-codes) was removed from a device.',
+  )
 
 export type UnmanagedAccessCodeRemovedEvent = z.infer<
   typeof unmanaged_access_code_removed_event

package/src/lib/seam/connect/models/events/acs/common.ts

@@ -3,16 +3,17 @@ import { z } from 'zod'
 import { common_event } from '../common.js'
 
 export const common_acs_event = common_event.extend({
-  connected_account_id: z.string().uuid().optional().describe(`
-    ---
-    title: Connected Account ID
-    ---
-    ID of the connected account.
-  `),
-  acs_system_id: z.string().uuid().describe(`
-    ---
-    title: ACS System ID
-    ---
-    ID of the ACS system.
-  `),
+  connected_account_id: z
+    .string()
+    .uuid()
+    .optional()
+    .describe(
+      'ID of the [connected account](https://docs.seam.co/latest/core-concepts/connected-accounts).',
+    ),
+  acs_system_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [ACS system](https://docs.seam.co/latest/capability-guides/access-systems).',
+    ),
 })

package/src/lib/seam/connect/models/events/acs/credentials.ts

@@ -10,7 +10,9 @@ export const acs_credential_deleted_event = acs_credential_event
   .extend({
     event_type: z.literal('acs_credential.deleted'),
   })
-  .describe('An ACS credential was deleted.')
+  .describe(
+    'An [ACS credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was deleted.',
+  )
 
 export type AcsCredentialDeletedEvent = z.infer<
   typeof acs_credential_deleted_event
@@ -20,7 +22,9 @@ export const acs_credential_issued = acs_credential_event
   .extend({
     event_type: z.literal('acs_credential.issued'),
   })
-  .describe('An ACS credential was issued.')
+  .describe(
+    'An [ACS credential](https://docs.seam.co/latest/capability-guides/access-systems/managing-credentials) was issued.',
+  )
 
 export const acs_credential_events = [
   acs_credential_deleted_event,

package/src/lib/seam/connect/models/events/acs/encoders.ts

@@ -3,14 +3,21 @@ import { z } from 'zod'
 import { common_acs_event } from './common.js'
 
 const acs_encoder_event = common_acs_event.extend({
-  acs_encoder_id: z.string().uuid().describe('ID of the ACS encoder.'),
+  acs_encoder_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [ACS encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners).',
+    ),
 })
 
 export const acs_encoder_added_event = acs_encoder_event
   .extend({
     event_type: z.literal('acs_encoder.added'),
   })
-  .describe('An ACS encoder was added.')
+  .describe(
+    'An [ACS encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners) was added.',
+  )
 
 export type AcsEncoderAddedEvent = z.infer<typeof acs_encoder_added_event>
 
@@ -18,7 +25,9 @@ export const acs_encoder_removed_event = acs_encoder_event
   .extend({
     event_type: z.literal('acs_encoder.removed'),
   })
-  .describe('An ACS encoder was removed.')
+  .describe(
+    'An [ACS encoder](https://docs.seam.co/latest/capability-guides/access-systems/working-with-card-encoders-and-scanners) was removed.',
+  )
 
 export type AcsEncoderRemovedEvent = z.infer<typeof acs_encoder_removed_event>
 

package/src/lib/seam/connect/models/events/acs/systems.ts

@@ -8,7 +8,9 @@ export const acs_system_connected_event = acs_system_event
   .extend({
     event_type: z.literal('acs_system.connected'),
   })
-  .describe('An ACS system was connected.')
+  .describe(
+    'An [ACS system](https://docs.seam.co/latest/capability-guides/access-systems) was connected.',
+  )
 
 export type AcsSystemConnectedEvent = z.infer<typeof acs_system_connected_event>
 
@@ -16,7 +18,9 @@ export const acs_system_disconnected_event = acs_system_event
   .extend({
     event_type: z.literal('acs_system.disconnected'),
   })
-  .describe('An ACS system was disconnected.')
+  .describe(
+    'An [ACS system](https://docs.seam.co/latest/capability-guides/access-systems) was disconnected.',
+  )
 
 export type AcsSystemDisconnectedEvent = z.infer<
   typeof acs_system_disconnected_event
@@ -26,7 +30,9 @@ export const acs_system_added_event = acs_system_event
   .extend({
     event_type: z.literal('acs_system.added'),
   })
-  .describe('An ACS system was added.')
+  .describe(
+    'An [ACS system](https://docs.seam.co/latest/capability-guides/access-systems) was added.',
+  )
 
 export type AcsSystemAddedEvent = z.infer<typeof acs_system_added_event>
 

package/src/lib/seam/connect/models/events/acs/users.ts

@@ -2,15 +2,21 @@ import { z } from 'zod'
 
 import { common_acs_event } from './common.js'
 
-const acs_user_event = common_acs_event.extend({
-  acs_user_id: z.string().uuid(),
-})
+const acs_user_event = common_acs_event
+  .extend({
+    acs_user_id: z.string().uuid(),
+  })
+  .describe(
+    'ID of the [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management).',
+  )
 
 export const acs_user_deleted_event = acs_user_event
   .extend({
     event_type: z.literal('acs_user.deleted'),
   })
-  .describe('An ACS user was deleted.')
+  .describe(
+    'An [ACS user](https://docs.seam.co/latest/capability-guides/access-systems/user-management) was deleted.',
+  )
 
 export type AcsUserDeletedEvent = z.infer<typeof acs_user_deleted_event>
 

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

@@ -3,49 +3,47 @@ import { z } from 'zod'
 import { common_event } from './common.js'
 
 const action_attempt_event = common_event.extend({
-  action_attempt_id: z.string().uuid().describe(`
-    ---
-    title: Action Attempt ID
-    ---
-    The ID of the action attempt.
-  `),
-  action_type: z.string().describe(`
-    ---
-    title: Action Type
-    ---
-    The type of action.
-  `),
-  status: z.string().describe(`
-    ---
-    title: Status
-    ---
-    The status of the action.
-  `),
+  action_attempt_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [action attempt](https://docs.seam.co/latest/core-concepts/action-attempts).',
+    ),
+  action_type: z.string().describe('Type of action.'),
+  status: z.string().describe('Status of the action.'),
 })
 
 export const action_attempt_lock_door_succeeded_event = action_attempt_event
   .extend({
     event_type: z.literal('action_attempt.lock_door.succeeded'),
   })
-  .describe('A lock door action attempt succeeded.')
+  .describe(
+    'A lock door [action attempt](https://docs.seam.co/latest/core-concepts/action-attempts) succeeded.',
+  )
 
 export const action_attempt_lock_door_failed_event = action_attempt_event
   .extend({
     event_type: z.literal('action_attempt.lock_door.failed'),
   })
-  .describe('A lock door action attempt failed.')
+  .describe(
+    'A lock door [action attempt](https://docs.seam.co/latest/core-concepts/action-attempts) failed.',
+  )
 
 export const action_attempt_unlock_door_succeeded_event = action_attempt_event
   .extend({
     event_type: z.literal('action_attempt.unlock_door.succeeded'),
   })
-  .describe('An unlock door action attempt succeeded.')
+  .describe(
+    'An unlock door [action attempt](https://docs.seam.co/latest/core-concepts/action-attempts) succeeded.',
+  )
 
 export const action_attempt_unlock_door_failed_event = action_attempt_event
   .extend({
     event_type: z.literal('action_attempt.unlock_door.failed'),
   })
-  .describe('An unlock door action attempt failed.')
+  .describe(
+    'An unlock door [action attempt](https://docs.seam.co/latest/core-concepts/action-attempts) failed.',
+  )
 
 export const action_attempt_events = [
   action_attempt_lock_door_succeeded_event,

package/src/lib/seam/connect/models/events/client-sessions.ts

@@ -3,19 +3,21 @@ import { z } from 'zod'
 import { common_event } from './common.js'
 
 const client_session_event = common_event.extend({
-  client_session_id: z.string().uuid().describe(`
-    ---
-    title: Client Session ID
-    ---
-    ID of the client session.
-  `),
+  client_session_id: z
+    .string()
+    .uuid()
+    .describe(
+      'ID of the [client session](https://docs.seam.co/latest/core-concepts/authentication/client-session-tokens).',
+    ),
 })
 
 export const client_session_deleted_event = client_session_event
   .extend({
     event_type: z.literal('client_session.deleted'),
   })
-  .describe('A client session was deleted.')
+  .describe(
+    'A [client session](https://docs.seam.co/latest/core-concepts/authentication/client-session-tokens) was deleted.',
+  )
 
 export type ClientSessionDeletedEvent = z.infer<
   typeof client_session_deleted_event

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

@@ -11,6 +11,9 @@ export const common_event = z.object({
   created_at: z
     .string()
     .datetime()
-    .describe('Time at which the event was created.'),
-  occurred_at: z.string().datetime().describe('Time when the event occurred.'),
+    .describe('Date and time at which the event was created.'),
+  occurred_at: z
+    .string()
+    .datetime()
+    .describe('Date and time at which the event occurred.'),
 })