@seamapi/types 1.772.0 → 1.774.0

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

@@ -11738,14 +11738,17 @@ export type Routes = {
                         max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                     });
                     /** Location information for the device. */
-                    location: {
+                    location?: {
                         /** Name of the device location.
                          */
                         location_name?: string | undefined;
                         /** Time zone of the device location.
                          */
+                        time_zone?: string | undefined;
+                        /** Time zone of the device location.
+                         * @deprecated Use `time_zone` instead.*/
                         timezone?: string | undefined;
-                    } | null;
+                    } | undefined;
                     /** Unique identifier for the account associated with the device. */
                     connected_account_id: string;
                     /** Unique identifier for the Seam workspace associated with the device. */
@@ -16042,14 +16045,17 @@ export type Routes = {
                         max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                     });
                     /** Location information for the device. */
-                    location: {
+                    location?: {
                         /** Name of the device location.
                          */
                         location_name?: string | undefined;
                         /** Time zone of the device location.
                          */
+                        time_zone?: string | undefined;
+                        /** Time zone of the device location.
+                         * @deprecated Use `time_zone` instead.*/
                         timezone?: string | undefined;
-                    } | null;
+                    } | undefined;
                     /** Unique identifier for the account associated with the device. */
                     connected_account_id: string;
                     /** Unique identifier for the Seam workspace associated with the device. */
@@ -32504,14 +32510,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -33874,14 +33883,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -34418,14 +34430,17 @@ export type Routes = {
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /**
                         Collection of capabilities that the device supports when connected to Seam. Values are `access_code`, which indicates that the device can manage and utilize digital PIN codes for secure access; `lock`, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; `noise_detection`, which indicates that the device supports monitoring and responding to ambient noise levels; `thermostat`, which indicates that the device can regulate and adjust indoor temperatures; `battery`, which indicates that the device can manage battery life and health; and `phone`, which indicates that the device is a mobile device, such as a smartphone. **Important:** Superseded by [capability flags](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).
                          */
@@ -34899,14 +34914,17 @@ export type Routes = {
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /**
                         Collection of capabilities that the device supports when connected to Seam. Values are `access_code`, which indicates that the device can manage and utilize digital PIN codes for secure access; `lock`, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; `noise_detection`, which indicates that the device supports monitoring and responding to ambient noise levels; `thermostat`, which indicates that the device can regulate and adjust indoor temperatures; `battery`, which indicates that the device can manage battery life and health; and `phone`, which indicates that the device is a mobile device, such as a smartphone. **Important:** Superseded by [capability flags](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).
                          */
@@ -43386,14 +43404,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -44706,14 +44727,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -46076,14 +46100,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -47395,14 +47422,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -54111,14 +54141,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -55430,14 +55463,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -62589,6 +62625,195 @@ export type Routes = {
         };
         maxDuration: undefined;
     };
+    '/seam/customer/v1/connectors/ical/generate-config': {
+        route: '/seam/customer/v1/connectors/ical/generate-config';
+        method: 'POST';
+        queryParams: {};
+        jsonBody: {
+            /** iCal feed URL to analyze */
+            ical_url: string;
+        };
+        commonParams: {};
+        formData: {};
+        jsonResponse: {
+            generated_config: {
+                ical_config: {
+                    /** Optional filter to skip non-matching events */
+                    filter?: {
+                        /** iCal property name to match against */
+                        source: string;
+                        /** Regex pattern — events not matching are skipped */
+                        pattern: string;
+                    } | undefined;
+                    fields: {
+                        /** How to extract the reservation key (falls back to UID) */
+                        reservation_key?: {
+                            /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                            source: string;
+                            /** Regex with capture group to extract value from the property */
+                            pattern?: string | undefined;
+                            /** Special type handling — 'date' parses iCal date formats */
+                            type?: 'date' | undefined;
+                        } | undefined;
+                        /** How to extract guest name */
+                        guest_name?: {
+                            /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                            source: string;
+                            /** Regex with capture group to extract value from the property */
+                            pattern?: string | undefined;
+                            /** Special type handling — 'date' parses iCal date formats */
+                            type?: 'date' | undefined;
+                        } | undefined;
+                        /** How to extract guest email */
+                        guest_email?: {
+                            /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                            source: string;
+                            /** Regex with capture group to extract value from the property */
+                            pattern?: string | undefined;
+                            /** Special type handling — 'date' parses iCal date formats */
+                            type?: 'date' | undefined;
+                        } | undefined;
+                        /** How to extract guest phone */
+                        guest_phone?: {
+                            /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                            source: string;
+                            /** Regex with capture group to extract value from the property */
+                            pattern?: string | undefined;
+                            /** Special type handling — 'date' parses iCal date formats */
+                            type?: 'date' | undefined;
+                        } | undefined;
+                        /** How to extract check-in date */
+                        starts_at: {
+                            /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                            source: string;
+                            /** Regex with capture group to extract value from the property */
+                            pattern?: string | undefined;
+                            /** Special type handling — 'date' parses iCal date formats */
+                            type?: 'date' | undefined;
+                        };
+                        /** How to extract check-out date */
+                        ends_at: {
+                            /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                            source: string;
+                            /** Regex with capture group to extract value from the property */
+                            pattern?: string | undefined;
+                            /** Special type handling — 'date' parses iCal date formats */
+                            type?: 'date' | undefined;
+                        };
+                    };
+                    /** IANA time zone (e.g. America/New_York) applied when dates have no time/timezone */
+                    time_zone?: string | undefined;
+                    /** Default check-in time (HH:MM) used when iCal gives date-only values */
+                    default_check_in_time?: string | undefined;
+                    /** Default check-out time (HH:MM) used when iCal gives date-only values */
+                    default_check_out_time?: string | undefined;
+                };
+            };
+        };
+        maxDuration: undefined;
+    };
+    '/seam/customer/v1/connectors/ical/validate-config': {
+        route: '/seam/customer/v1/connectors/ical/validate-config';
+        method: 'POST';
+        queryParams: {};
+        jsonBody: {
+            /** iCal feed URL to validate against */
+            ical_url: string;
+            /** Config to validate */
+            ical_config: {
+                /** Optional filter to skip non-matching events */
+                filter?: {
+                    /** iCal property name to match against */
+                    source: string;
+                    /** Regex pattern — events not matching are skipped */
+                    pattern: string;
+                } | undefined;
+                fields: {
+                    /** How to extract the reservation key (falls back to UID) */
+                    reservation_key?: {
+                        /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                        source: string;
+                        /** Regex with capture group to extract value from the property */
+                        pattern?: string | undefined;
+                        /** Special type handling — 'date' parses iCal date formats */
+                        type?: 'date' | undefined;
+                    } | undefined;
+                    /** How to extract guest name */
+                    guest_name?: {
+                        /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                        source: string;
+                        /** Regex with capture group to extract value from the property */
+                        pattern?: string | undefined;
+                        /** Special type handling — 'date' parses iCal date formats */
+                        type?: 'date' | undefined;
+                    } | undefined;
+                    /** How to extract guest email */
+                    guest_email?: {
+                        /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                        source: string;
+                        /** Regex with capture group to extract value from the property */
+                        pattern?: string | undefined;
+                        /** Special type handling — 'date' parses iCal date formats */
+                        type?: 'date' | undefined;
+                    } | undefined;
+                    /** How to extract guest phone */
+                    guest_phone?: {
+                        /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                        source: string;
+                        /** Regex with capture group to extract value from the property */
+                        pattern?: string | undefined;
+                        /** Special type handling — 'date' parses iCal date formats */
+                        type?: 'date' | undefined;
+                    } | undefined;
+                    /** How to extract check-in date */
+                    starts_at: {
+                        /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                        source: string;
+                        /** Regex with capture group to extract value from the property */
+                        pattern?: string | undefined;
+                        /** Special type handling — 'date' parses iCal date formats */
+                        type?: 'date' | undefined;
+                    };
+                    /** How to extract check-out date */
+                    ends_at: {
+                        /** iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc. */
+                        source: string;
+                        /** Regex with capture group to extract value from the property */
+                        pattern?: string | undefined;
+                        /** Special type handling — 'date' parses iCal date formats */
+                        type?: 'date' | undefined;
+                    };
+                };
+                /** IANA time zone (e.g. America/New_York) applied when dates have no time/timezone */
+                time_zone?: string | undefined;
+                /** Default check-in time (HH:MM) used when iCal gives date-only values */
+                default_check_in_time?: string | undefined;
+                /** Default check-out time (HH:MM) used when iCal gives date-only values */
+                default_check_out_time?: string | undefined;
+            };
+        };
+        commonParams: {};
+        formData: {};
+        jsonResponse: {
+            validation_result: {
+                is_valid: boolean;
+                total_events: number;
+                matched_events: number;
+                filtered_events: number;
+                reservations: {
+                    uid: string;
+                    reservation_key: string | null;
+                    guest_name: string | null;
+                    guest_email: string | null;
+                    guest_phone: string | null;
+                    starts_at: string | null;
+                    ends_at: string | null;
+                }[];
+                errors: string[];
+            };
+        };
+        maxDuration: undefined;
+    };
     '/seam/customer/v1/connectors/list': {
         route: '/seam/customer/v1/connectors/list';
         method: 'GET' | 'POST';
@@ -68548,14 +68773,17 @@ export type Routes = {
                         max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                     });
                     /** Location information for the device. */
-                    location: {
+                    location?: {
                         /** Name of the device location.
                          */
                         location_name?: string | undefined;
                         /** Time zone of the device location.
                          */
+                        time_zone?: string | undefined;
+                        /** Time zone of the device location.
+                         * @deprecated Use `time_zone` instead.*/
                         timezone?: string | undefined;
-                    } | null;
+                    } | undefined;
                     /** Unique identifier for the account associated with the device. */
                     connected_account_id: string;
                     /** Unique identifier for the Seam workspace associated with the device. */
@@ -74641,14 +74869,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -78697,14 +78928,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -80016,14 +80250,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -87621,14 +87858,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -88942,14 +89182,17 @@ export type Routes = {
                     max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                 });
                 /** Location information for the device. */
-                location: {
+                location?: {
                     /** Name of the device location.
                      */
                     location_name?: string | undefined;
                     /** Time zone of the device location.
                      */
+                    time_zone?: string | undefined;
+                    /** Time zone of the device location.
+                     * @deprecated Use `time_zone` instead.*/
                     timezone?: string | undefined;
-                } | null;
+                } | undefined;
                 /** Unique identifier for the account associated with the device. */
                 connected_account_id: string;
                 /** Unique identifier for the Seam workspace associated with the device. */
@@ -91241,14 +91484,17 @@ export type Routes = {
                         max_thermostat_daily_program_periods_per_day?: (number | undefined) | undefined;
                     });
                     /** Location information for the device. */
-                    location: {
+                    location?: {
                         /** Name of the device location.
                          */
                         location_name?: string | undefined;
                         /** Time zone of the device location.
                          */
+                        time_zone?: string | undefined;
+                        /** Time zone of the device location.
+                         * @deprecated Use `time_zone` instead.*/
                         timezone?: string | undefined;
-                    } | null;
+                    } | undefined;
                     /** Unique identifier for the account associated with the device. */
                     connected_account_id: string;
                     /** Unique identifier for the Seam workspace associated with the device. */
@@ -94015,14 +94261,17 @@ export type Routes = {
                     /** Unique identifier for the account associated with the device. */
                     connected_account_id: string;
                     /** Location information for the device. */
-                    location: {
+                    location?: {
                         /** Name of the device location.
                          */
                         location_name?: string | undefined;
                         /** Time zone of the device location.
                          */
+                        time_zone?: string | undefined;
+                        /** Time zone of the device location.
+                         * @deprecated Use `time_zone` instead.*/
                         timezone?: string | undefined;
-                    } | null;
+                    } | undefined;
                     /**
                           Collection of capabilities that the device supports when connected to Seam. Values are `access_code`, which indicates that the device can manage and utilize digital PIN codes for secure access; `lock`, which indicates that the device controls a door locking mechanism, enabling the remote opening and closing of doors and other entry points; `noise_detection`, which indicates that the device supports monitoring and responding to ambient noise levels; `thermostat`, which indicates that the device can regulate and adjust indoor temperatures; `battery`, which indicates that the device can manage battery life and health; and `phone`, which indicates that the device is a mobile device, such as a smartphone. **Important:** Superseded by [capability flags](https://docs.seam.co/latest/capability-guides/device-and-system-capabilities#capability-flags).
                            */

package/package.json

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

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

@@ -879,16 +879,21 @@ export const device = z
     Properties of the device.
   `),
     location: z
-      // todo: optional instead of nullable
       .object({
         location_name: z.string().optional()
           .describe(`Name of the device location.
           `),
-        timezone: z.string().optional()
+        time_zone: z.string().optional()
           .describe(`Time zone of the device location.
           `),
+        timezone: z.string().optional().describe(`
+          ---
+          deprecated: Use \`time_zone\` instead.
+          ---
+          Time zone of the device location.
+          `),
       })
-      .nullable().describe(`
+      .optional().describe(`
           ---
           property_group_key: hardware
           ---