@seamapi/types 1.928.0 → 1.930.0

package/package.json

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

package/src/lib/seam/connect/models/access-codes/managed-access-code.ts

@@ -268,14 +268,14 @@ const code_modified_external_to_seam_warning = common_access_code_warning
     'Code was modified or removed externally after Seam successfully set it on the device.',
   )
 
-const provider_issue_warning = common_access_code_warning
+const code_rotates_periodically = common_access_code_warning
   .extend({
     warning_code: z
-      .literal('provider_issue')
+      .literal('code_rotates_periodically')
       .describe(warning_code_description),
   })
   .describe(
-    'Indicates a provider-specific issue that may affect the access code. Check the warning message for details.',
+    "The access code's PIN rotates periodically when the code is renewed. Retrieve the latest code before each use.",
   )
 
 const schlage_access_code_ambiguous_timezone_dst_risk =
@@ -349,7 +349,7 @@ const being_deleted = common_access_code_warning
 
 const access_code_warning = z
   .discriminatedUnion('warning_code', [
-    provider_issue_warning,
+    code_rotates_periodically,
     schlage_access_code_ambiguous_timezone_dst_risk,
     code_modified_external_to_seam_warning,
     delay_in_setting_on_device,
@@ -367,7 +367,7 @@ const access_code_warning = z
 export type AccessCodeWarning = z.infer<typeof access_code_warning>
 
 const _access_code_warning_map = z.object({
-  provider_issue: provider_issue_warning.optional().nullable(),
+  code_rotates_periodically: code_rotates_periodically.optional().nullable(),
   schlage_access_code_ambiguous_timezone_dst_risk:
     schlage_access_code_ambiguous_timezone_dst_risk.optional().nullable(),
   code_modified_external_to_seam_warning: code_modified_external_to_seam_warning

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

@@ -41,6 +41,82 @@ export const access_code_constraint = z
 
 export type AccessCodeConstraint = z.infer<typeof access_code_constraint>
 
+const time_frame_option_time_pair = z
+  .object({
+    display_name: z
+      .string()
+      .describe('Label for the check-in/check-out time pairing.'),
+    check_in_time: z
+      .string()
+      .describe(
+        "Check-in time of day as a 24-hour `HH:MM` value, interpreted in the option's `time_zone`.",
+      ),
+    check_out_time: z
+      .string()
+      .describe(
+        "Check-out time of day as a 24-hour `HH:MM` value, interpreted in the option's `time_zone`. A `check_out_time` earlier on the clock than `check_in_time` means check-out falls on a later date.",
+      ),
+  })
+  .describe(
+    'Fixed check-in/check-out time pairing. The caller picks one whole pairing; the two times cannot be mixed across pairs.',
+  )
+
+export const time_frame_option = z
+  .object({
+    display_name: z
+      .string()
+      .describe(
+        'Label for this option. For a single-option device, the product name (for example, `algoPIN` or `SmartPIN`); for a multi-option device, a label that distinguishes it (for example, `Hourly` or `Fixed check-in times`).',
+      ),
+    min_duration: z
+      .string()
+      .optional()
+      .describe(
+        'Minimum duration this option covers, as an ISO 8601 duration (for example, `PT1H` or `P29D`). Omitted when there is no minimum.',
+      ),
+    max_duration: z
+      .string()
+      .optional()
+      .describe(
+        'Maximum duration this option covers, as an ISO 8601 duration (for example, `PT672H` or `P367D`). Omitted when there is no maximum.',
+      ),
+    matching_start_end_time: z
+      .literal(true)
+      .optional()
+      .describe(
+        'When `true`, the check-in and check-out must fall at the same time of day (the caller picks which). Mutually exclusive with `time_pairs`.',
+      ),
+    time_pairs: z
+      .array(time_frame_option_time_pair)
+      .optional()
+      .describe(
+        'Fixed check-in/check-out time pairings the caller chooses from. Mutually exclusive with `matching_start_end_time`.',
+      ),
+    start_date_recurrence_rule: z
+      .string()
+      .optional()
+      .describe(
+        'iCalendar recurrence rule (RRULE) that the check-in date must fall on (for example, `FREQ=MONTHLY;BYDAY=1MO,3MO`). Constrains which calendar dates are selectable, independent of the time-of-day rules.',
+      ),
+    end_date_recurrence_rule: z
+      .string()
+      .optional()
+      .describe(
+        'iCalendar recurrence rule (RRULE) that the check-out date must fall on. Constrains which calendar dates are selectable, independent of the time-of-day rules.',
+      ),
+    time_zone: z
+      .string()
+      .optional()
+      .describe(
+        'IANA time zone for interpreting `time_pairs` and the date recurrence rules. Present only when the option fixes times or dates.',
+      ),
+  })
+  .describe(
+    'One way to make a code: a duration band plus the time-of-day and date rules that apply within it. Absence of a rule means unrestricted on that axis.',
+  )
+
+export type TimeFrameOption = z.infer<typeof time_frame_option>
+
 export const access_code_capability_properties = z.object({
   _experimental_supported_code_from_access_codes_lengths: z
     .array(z.number())
@@ -59,6 +135,16 @@ export const access_code_capability_properties = z.object({
           property_group_key: access_codes
           ---
           Supported code lengths for access codes.`),
+  offline_time_frame_options: z.array(time_frame_option).optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Time frames that may be requested when creating an offline access code, expressed as a list of options. The caller picks one option (by matching the requested duration when the options' duration ranges do not overlap, or by \`display_name\` when they do) and satisfies that one option's rules. When \`undefined\`, any time frame works.`),
+  online_time_frame_options: z.array(time_frame_option).optional().describe(`
+          ---
+          property_group_key: access_codes
+          ---
+          Time frames that may be requested when creating an online access code, expressed as a list of options. The caller picks one option (by matching the requested duration when the options' duration ranges do not overlap, or by \`display_name\` when they do) and satisfies that one option's rules. When \`undefined\`, any time frame works.`),
   max_active_codes_supported: z.number().optional().describe(`
           ---
           property_group_key: access_codes

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

@@ -22,4 +22,4 @@ export const capability_properties = z.intersection(
   thermostat_capability_properties,
 )
 
-export type { AccessCodeConstraint } from './access-code.js'
+export type { AccessCodeConstraint, TimeFrameOption } from './access-code.js'

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

@@ -1482,7 +1482,7 @@ const openapi: OpenAPISpec = {
               oneOf: [
                 {
                   description:
-                    'Indicates a provider-specific issue that may affect the access code. Check the warning message for details.',
+                    "The access code's PIN rotates periodically when the code is renewed. Retrieve the latest code before each use.",
                   properties: {
                     created_at: {
                       description:
@@ -1498,7 +1498,7 @@ const openapi: OpenAPISpec = {
                     warning_code: {
                       description:
                         'Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.',
-                      enum: ['provider_issue'],
+                      enum: ['code_rotates_periodically'],
                       type: 'string',
                     },
                   },
@@ -15507,6 +15507,170 @@ const openapi: OpenAPISpec = {
                         type: 'number',
                         'x-property-group-key': 'access_codes',
                       },
+                      offline_time_frame_options: {
+                        description:
+                          "Time frames that may be requested when creating an offline access code, expressed as a list of options. The caller picks one option (by matching the requested duration when the options' duration ranges do not overlap, or by `display_name` when they do) and satisfies that one option's rules. When `undefined`, any time frame works.",
+                        items: {
+                          description:
+                            'One way to make a code: a duration band plus the time-of-day and date rules that apply within it. Absence of a rule means unrestricted on that axis.',
+                          properties: {
+                            display_name: {
+                              description:
+                                'Label for this option. For a single-option device, the product name (for example, `algoPIN` or `SmartPIN`); for a multi-option device, a label that distinguishes it (for example, `Hourly` or `Fixed check-in times`).',
+                              type: 'string',
+                            },
+                            end_date_recurrence_rule: {
+                              description:
+                                'iCalendar recurrence rule (RRULE) that the check-out date must fall on. Constrains which calendar dates are selectable, independent of the time-of-day rules.',
+                              type: 'string',
+                            },
+                            matching_start_end_time: {
+                              description:
+                                'When `true`, the check-in and check-out must fall at the same time of day (the caller picks which). Mutually exclusive with `time_pairs`.',
+                              enum: [true],
+                              type: 'boolean',
+                            },
+                            max_duration: {
+                              description:
+                                'Maximum duration this option covers, as an ISO 8601 duration (for example, `PT672H` or `P367D`). Omitted when there is no maximum.',
+                              type: 'string',
+                            },
+                            min_duration: {
+                              description:
+                                'Minimum duration this option covers, as an ISO 8601 duration (for example, `PT1H` or `P29D`). Omitted when there is no minimum.',
+                              type: 'string',
+                            },
+                            start_date_recurrence_rule: {
+                              description:
+                                'iCalendar recurrence rule (RRULE) that the check-in date must fall on (for example, `FREQ=MONTHLY;BYDAY=1MO,3MO`). Constrains which calendar dates are selectable, independent of the time-of-day rules.',
+                              type: 'string',
+                            },
+                            time_pairs: {
+                              description:
+                                'Fixed check-in/check-out time pairings the caller chooses from. Mutually exclusive with `matching_start_end_time`.',
+                              items: {
+                                description:
+                                  'Fixed check-in/check-out time pairing. The caller picks one whole pairing; the two times cannot be mixed across pairs.',
+                                properties: {
+                                  check_in_time: {
+                                    description:
+                                      "Check-in time of day as a 24-hour `HH:MM` value, interpreted in the option's `time_zone`.",
+                                    type: 'string',
+                                  },
+                                  check_out_time: {
+                                    description:
+                                      "Check-out time of day as a 24-hour `HH:MM` value, interpreted in the option's `time_zone`. A `check_out_time` earlier on the clock than `check_in_time` means check-out falls on a later date.",
+                                    type: 'string',
+                                  },
+                                  display_name: {
+                                    description:
+                                      'Label for the check-in/check-out time pairing.',
+                                    type: 'string',
+                                  },
+                                },
+                                required: [
+                                  'display_name',
+                                  'check_in_time',
+                                  'check_out_time',
+                                ],
+                                type: 'object',
+                              },
+                              type: 'array',
+                            },
+                            time_zone: {
+                              description:
+                                'IANA time zone for interpreting `time_pairs` and the date recurrence rules. Present only when the option fixes times or dates.',
+                              type: 'string',
+                            },
+                          },
+                          required: ['display_name'],
+                          type: 'object',
+                        },
+                        type: 'array',
+                        'x-property-group-key': 'access_codes',
+                      },
+                      online_time_frame_options: {
+                        description:
+                          "Time frames that may be requested when creating an online access code, expressed as a list of options. The caller picks one option (by matching the requested duration when the options' duration ranges do not overlap, or by `display_name` when they do) and satisfies that one option's rules. When `undefined`, any time frame works.",
+                        items: {
+                          description:
+                            'One way to make a code: a duration band plus the time-of-day and date rules that apply within it. Absence of a rule means unrestricted on that axis.',
+                          properties: {
+                            display_name: {
+                              description:
+                                'Label for this option. For a single-option device, the product name (for example, `algoPIN` or `SmartPIN`); for a multi-option device, a label that distinguishes it (for example, `Hourly` or `Fixed check-in times`).',
+                              type: 'string',
+                            },
+                            end_date_recurrence_rule: {
+                              description:
+                                'iCalendar recurrence rule (RRULE) that the check-out date must fall on. Constrains which calendar dates are selectable, independent of the time-of-day rules.',
+                              type: 'string',
+                            },
+                            matching_start_end_time: {
+                              description:
+                                'When `true`, the check-in and check-out must fall at the same time of day (the caller picks which). Mutually exclusive with `time_pairs`.',
+                              enum: [true],
+                              type: 'boolean',
+                            },
+                            max_duration: {
+                              description:
+                                'Maximum duration this option covers, as an ISO 8601 duration (for example, `PT672H` or `P367D`). Omitted when there is no maximum.',
+                              type: 'string',
+                            },
+                            min_duration: {
+                              description:
+                                'Minimum duration this option covers, as an ISO 8601 duration (for example, `PT1H` or `P29D`). Omitted when there is no minimum.',
+                              type: 'string',
+                            },
+                            start_date_recurrence_rule: {
+                              description:
+                                'iCalendar recurrence rule (RRULE) that the check-in date must fall on (for example, `FREQ=MONTHLY;BYDAY=1MO,3MO`). Constrains which calendar dates are selectable, independent of the time-of-day rules.',
+                              type: 'string',
+                            },
+                            time_pairs: {
+                              description:
+                                'Fixed check-in/check-out time pairings the caller chooses from. Mutually exclusive with `matching_start_end_time`.',
+                              items: {
+                                description:
+                                  'Fixed check-in/check-out time pairing. The caller picks one whole pairing; the two times cannot be mixed across pairs.',
+                                properties: {
+                                  check_in_time: {
+                                    description:
+                                      "Check-in time of day as a 24-hour `HH:MM` value, interpreted in the option's `time_zone`.",
+                                    type: 'string',
+                                  },
+                                  check_out_time: {
+                                    description:
+                                      "Check-out time of day as a 24-hour `HH:MM` value, interpreted in the option's `time_zone`. A `check_out_time` earlier on the clock than `check_in_time` means check-out falls on a later date.",
+                                    type: 'string',
+                                  },
+                                  display_name: {
+                                    description:
+                                      'Label for the check-in/check-out time pairing.',
+                                    type: 'string',
+                                  },
+                                },
+                                required: [
+                                  'display_name',
+                                  'check_in_time',
+                                  'check_out_time',
+                                ],
+                                type: 'object',
+                              },
+                              type: 'array',
+                            },
+                            time_zone: {
+                              description:
+                                'IANA time zone for interpreting `time_pairs` and the date recurrence rules. Present only when the option fixes times or dates.',
+                              type: 'string',
+                            },
+                          },
+                          required: ['display_name'],
+                          type: 'object',
+                        },
+                        type: 'array',
+                        'x-property-group-key': 'access_codes',
+                      },
                       supported_code_lengths: {
                         description: 'Supported code lengths for access codes.',
                         items: { format: 'float', type: 'number' },
@@ -29841,7 +30005,7 @@ const openapi: OpenAPISpec = {
               oneOf: [
                 {
                   description:
-                    'Indicates a provider-specific issue that may affect the access code. Check the warning message for details.',
+                    "The access code's PIN rotates periodically when the code is renewed. Retrieve the latest code before each use.",
                   properties: {
                     created_at: {
                       description:
@@ -29857,7 +30021,7 @@ const openapi: OpenAPISpec = {
                     warning_code: {
                       description:
                         'Unique identifier of the type of warning. Enables quick recognition and categorization of the issue.',
-                      enum: ['provider_issue'],
+                      enum: ['code_rotates_periodically'],
                       type: 'string',
                     },
                   },