@seamapi/types 1.249.0 → 1.252.0

package/package.json

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

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

@@ -3,6 +3,7 @@ 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 { read_card_action_attempt } from './read-card.js'
 import { reset_sandbox_workspace_action_attempt } from './reset-sandbox-workspace.js'
 import { set_cool_action_attempt } from './set-cool.js'
 import { set_fan_mode_action_attempt } from './set-fan-mode.js'
@@ -14,6 +15,7 @@ import { unlock_door_action_attempt } from './unlock-door.js'
 export const action_attempt = z.union([
   ...lock_door_action_attempt.options,
   ...unlock_door_action_attempt.options,
+  ...read_card_action_attempt.options,
   ...reset_sandbox_workspace_action_attempt.options,
   ...set_cool_action_attempt.options,
   ...set_heat_action_attempt.options,

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

@@ -0,0 +1,46 @@
+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('READ_CARD')
+
+const error = z.object({
+  type: z.string(), // TODO This should be typed properly with the possible errors
+  message: z.string(),
+})
+
+const result = z.object({
+  acs_credential_id: z
+    .string()
+    .uuid()
+    .nullable()
+    .describe('Matching acs_credential currently encoded on this card.'),
+  card_number: z
+    .string()
+    .nullable()
+    .describe('A number or sting that physically identifies this card.'),
+  // TODO visionline_metadata: visionline_credential_metadata,
+})
+
+export const read_card_action_attempt = z.discriminatedUnion('status', [
+  common_pending_action_attempt
+    .extend({
+      action_type,
+    })
+    .describe('Reading card data from physical encoder.'),
+  common_succeeded_action_attempt
+    .extend({
+      action_type,
+      result,
+    })
+    .describe('Reading card data from physical encoder succeeded.'),
+  common_failed_action_attempt
+    .extend({ action_type, error })
+    .describe('Reading card data from physical encoder failed.'),
+])
+
+export type ReadCardActionAttempt = z.infer<typeof read_card_action_attempt>

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

@@ -3,9 +3,10 @@ import { z } from 'zod'
 import { common_event } from '../common.js'
 
 export const common_acs_event = common_event.extend({
-  connected_account_id: z.string().uuid().describe(`
+  connected_account_id: z.string().uuid().optional().describe(`
     ---
     title: Connected Account ID
+    deprecated: Will be removed.
     ---
     ID of the connected account.
   `),

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

@@ -12,4 +12,15 @@ export const acs_system_connected_event = acs_system_event
 
 export type AcsSystemConnectedEvent = z.infer<typeof acs_system_connected_event>
 
-export const acs_system_events = [acs_system_connected_event] as const
+export const acs_system_added_event = acs_system_event
+  .extend({
+    event_type: z.literal('acs_system.added'),
+  })
+  .describe('An ACS system was added.')
+
+export type AcsSystemAddedEvent = z.infer<typeof acs_system_added_event>
+
+export const acs_system_events = [
+  acs_system_connected_event,
+  acs_system_added_event,
+] as const

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

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 
+import { climate_setting } from '../thermostats/climate-preset.js'
 import { common_event } from './common.js'
 
 const device_event = common_event.extend({
@@ -341,6 +342,36 @@ export const lock_access_denied_event = device_event
 
 export type LockAccessDeniedEvent = z.infer<typeof lock_access_denied_event>
 
+export const thermostat_climate_preset_activated_event = device_event
+  .extend({
+    event_type: z.literal('thermostat.climate_preset_activated'),
+    thermostat_schedule_id: z.string().uuid().nullable(),
+    climate_preset_key: z.string(),
+    is_fallback_climate_preset: z.boolean(),
+  })
+  .describe('A thermostat climate preset was activated.')
+
+export type ThermostatClimatePresetActivatedEvent = z.infer<
+  typeof thermostat_climate_preset_activated_event
+>
+
+export const thermostat_manually_adjusted_event = device_event
+  .merge(
+    climate_setting.pick({
+      fan_mode_setting: true,
+      hvac_mode_setting: true,
+      cooling_set_point_celsius: true,
+      heating_set_point_celsius: true,
+      cooling_set_point_fahrenheit: true,
+      heating_set_point_fahrenheit: true,
+    }),
+  )
+  .describe('A thermostat was manually adjusted.')
+
+export type ThermostatManuallyAdjustedEvent = z.infer<
+  typeof thermostat_manually_adjusted_event
+>
+
 export const device_events = [
   device_connected_event,
   device_converted_to_unmanaged_event,
@@ -367,4 +398,6 @@ export const device_events = [
   lock_locked_event,
   lock_unlocked_event,
   lock_access_denied_event,
+  // thermostat_climate_preset_activated_event,
+  // thermostat_manually_adjusted_event,
 ] as const

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

@@ -1174,6 +1174,100 @@ export default {
             ],
             type: 'object',
           },
+          {
+            description: 'Reading card data from physical encoder.',
+            properties: {
+              action_attempt_id: {
+                description: 'The ID of the action attempt.',
+                format: 'uuid',
+                type: 'string',
+                'x-title': 'Action Attempt ID',
+              },
+              action_type: { enum: ['READ_CARD'], type: 'string' },
+              error: { nullable: true },
+              result: { nullable: true },
+              status: { enum: ['pending'], type: 'string' },
+            },
+            required: [
+              'action_attempt_id',
+              'status',
+              'result',
+              'error',
+              'action_type',
+            ],
+            type: 'object',
+          },
+          {
+            description: 'Reading card data from physical encoder succeeded.',
+            properties: {
+              action_attempt_id: {
+                description: 'The ID of the action attempt.',
+                format: 'uuid',
+                type: 'string',
+                'x-title': 'Action Attempt ID',
+              },
+              action_type: { enum: ['READ_CARD'], type: 'string' },
+              error: { nullable: true },
+              result: {
+                properties: {
+                  acs_credential_id: {
+                    description:
+                      'Matching acs_credential currently encoded on this card.',
+                    format: 'uuid',
+                    nullable: true,
+                    type: 'string',
+                  },
+                  card_number: {
+                    description:
+                      'A number or sting that physically identifies this card.',
+                    nullable: true,
+                    type: 'string',
+                  },
+                },
+                required: ['acs_credential_id', 'card_number'],
+                type: 'object',
+              },
+              status: { enum: ['success'], type: 'string' },
+            },
+            required: [
+              'action_attempt_id',
+              'status',
+              'error',
+              'action_type',
+              'result',
+            ],
+            type: 'object',
+          },
+          {
+            description: 'Reading card data from physical encoder failed.',
+            properties: {
+              action_attempt_id: {
+                description: 'The ID of the action attempt.',
+                format: 'uuid',
+                type: 'string',
+                'x-title': 'Action Attempt ID',
+              },
+              action_type: { enum: ['READ_CARD'], type: 'string' },
+              error: {
+                properties: {
+                  message: { type: 'string' },
+                  type: { type: 'string' },
+                },
+                required: ['type', 'message'],
+                type: 'object',
+              },
+              result: { nullable: true },
+              status: { enum: ['error'], type: 'string' },
+            },
+            required: [
+              'action_attempt_id',
+              'status',
+              'result',
+              'action_type',
+              'error',
+            ],
+            type: 'object',
+          },
           {
             description: 'Resetting sandbox workspace.',
             properties: {
@@ -6716,6 +6810,68 @@ export default {
         'x-fern-sdk-return-value': 'acs_entrances',
       },
     },
+    '/acs/credentials/read_card': {
+      post: {
+        operationId: 'acsCredentialsReadCardPost',
+        requestBody: {
+          content: {
+            'application/json': {
+              schema: {
+                oneOf: [
+                  {
+                    properties: {
+                      acs_system_id: { format: 'uuid', type: 'string' },
+                      device_name: { type: 'string' },
+                    },
+                    required: ['acs_system_id', 'device_name'],
+                    type: 'object',
+                  },
+                  {
+                    properties: {
+                      device_id: { format: 'uuid', type: 'string' },
+                    },
+                    required: ['device_id'],
+                    type: 'object',
+                  },
+                ],
+              },
+            },
+          },
+        },
+        responses: {
+          200: {
+            content: {
+              'application/json': {
+                schema: {
+                  properties: {
+                    action_attempt: {
+                      $ref: '#/components/schemas/action_attempt',
+                    },
+                    ok: { type: 'boolean' },
+                  },
+                  required: ['action_attempt', 'ok'],
+                  type: 'object',
+                },
+              },
+            },
+            description: 'OK',
+          },
+          400: { description: 'Bad Request' },
+          401: { description: 'Unauthorized' },
+        },
+        security: [
+          { pat_with_workspace: [] },
+          { console_session: [] },
+          { api_key: [] },
+        ],
+        summary: '/acs/credentials/read_card',
+        tags: ['/acs'],
+        'x-fern-sdk-group-name': ['acs', 'credentials'],
+        'x-fern-sdk-method-name': 'read_card',
+        'x-fern-sdk-return-value': 'action_attempt',
+        'x-undocumented': 'Reading a card is currently unimplemented.',
+      },
+    },
     '/acs/credentials/unassign': {
       patch: {
         operationId: 'acsCredentialsUnassignPatch',
@@ -11490,6 +11646,7 @@ export default {
                       'connect_webview.login_failed',
                       'noise_sensor.noise_threshold_triggered',
                       'access_code.backup_access_code_pulled',
+                      'acs_system.added',
                       'acs_system.connected',
                       'acs_user.deleted',
                       'acs_credential.deleted',
@@ -11557,6 +11714,7 @@ export default {
                         'connect_webview.login_failed',
                         'noise_sensor.noise_threshold_triggered',
                         'access_code.backup_access_code_pulled',
+                        'acs_system.added',
                         'acs_system.connected',
                         'acs_user.deleted',
                         'acs_credential.deleted',