@seamapi/types 1.772.0 → 1.774.0

package/dist/connect.cjs

@@ -1817,9 +1817,15 @@ var device = zod.z.object({
   location: zod.z.object({
     location_name: zod.z.string().optional().describe(`Name of the device location.
           `),
-    timezone: zod.z.string().optional().describe(`Time zone of the device location.
+    time_zone: zod.z.string().optional().describe(`Time zone of the device location.
+          `),
+    timezone: zod.z.string().optional().describe(`
+          ---
+          deprecated: Use \`time_zone\` instead.
+          ---
+          Time zone of the device location.
           `)
-  }).nullable().describe(`
+  }).optional().describe(`
           ---
           property_group_key: hardware
           ---
@@ -17077,15 +17083,20 @@ var openapi_default = {
           },
           location: {
             description: "Location information for the device.",
-            nullable: true,
             properties: {
               location_name: {
                 description: "Name of the device location.\n          ",
                 type: "string"
               },
-              timezone: {
+              time_zone: {
                 description: "Time zone of the device location.\n          ",
                 type: "string"
+              },
+              timezone: {
+                deprecated: true,
+                description: "Time zone of the device location.",
+                type: "string",
+                "x-deprecated": "Use `time_zone` instead."
               }
             },
             type: "object",
@@ -20010,7 +20021,6 @@ var openapi_default = {
           "display_name",
           "capabilities_supported",
           "properties",
-          "location",
           "connected_account_id",
           "workspace_id",
           "errors",
@@ -33439,15 +33449,20 @@ var openapi_default = {
           is_managed: { enum: [false], type: "boolean" },
           location: {
             description: "Location information for the device.",
-            nullable: true,
             properties: {
               location_name: {
                 description: "Name of the device location.\n          ",
                 type: "string"
               },
-              timezone: {
+              time_zone: {
                 description: "Time zone of the device location.\n          ",
                 type: "string"
+              },
+              timezone: {
+                deprecated: true,
+                description: "Time zone of the device location.",
+                type: "string",
+                "x-deprecated": "Use `time_zone` instead."
               }
             },
             type: "object",
@@ -34138,7 +34153,6 @@ var openapi_default = {
           "device_id",
           "device_type",
           "connected_account_id",
-          "location",
           "capabilities_supported",
           "workspace_id",
           "errors",
@@ -65146,6 +65160,492 @@ var openapi_default = {
         "x-undocumented": "Internal endpoint for Console."
       }
     },
+    "/seam/customer/v1/connectors/ical/generate-config": {
+      post: {
+        description: "Fetches an iCal feed URL and uses AI to generate a parsing config\nbased on the feed's structure and content.",
+        operationId: "seamCustomerV1ConnectorsIcalGenerateConfigPost",
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                properties: {
+                  ical_url: {
+                    description: "iCal feed URL to analyze",
+                    format: "uri",
+                    type: "string"
+                  }
+                },
+                required: ["ical_url"],
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    generated_config: {
+                      properties: {
+                        ical_config: {
+                          properties: {
+                            default_check_in_time: {
+                              description: "Default check-in time (HH:MM) used when iCal gives date-only values",
+                              pattern: "^\\d{2}:\\d{2}$",
+                              type: "string"
+                            },
+                            default_check_out_time: {
+                              description: "Default check-out time (HH:MM) used when iCal gives date-only values",
+                              pattern: "^\\d{2}:\\d{2}$",
+                              type: "string"
+                            },
+                            fields: {
+                              properties: {
+                                ends_at: {
+                                  description: "How to extract check-out date",
+                                  properties: {
+                                    pattern: {
+                                      description: "Regex with capture group to extract value from the property",
+                                      type: "string"
+                                    },
+                                    source: {
+                                      description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      description: "Special type handling \u2014 'date' parses iCal date formats",
+                                      enum: ["date"],
+                                      type: "string"
+                                    }
+                                  },
+                                  required: ["source"],
+                                  type: "object"
+                                },
+                                guest_email: {
+                                  description: "How to extract guest email",
+                                  properties: {
+                                    pattern: {
+                                      description: "Regex with capture group to extract value from the property",
+                                      type: "string"
+                                    },
+                                    source: {
+                                      description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      description: "Special type handling \u2014 'date' parses iCal date formats",
+                                      enum: ["date"],
+                                      type: "string"
+                                    }
+                                  },
+                                  required: ["source"],
+                                  type: "object"
+                                },
+                                guest_name: {
+                                  description: "How to extract guest name",
+                                  properties: {
+                                    pattern: {
+                                      description: "Regex with capture group to extract value from the property",
+                                      type: "string"
+                                    },
+                                    source: {
+                                      description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      description: "Special type handling \u2014 'date' parses iCal date formats",
+                                      enum: ["date"],
+                                      type: "string"
+                                    }
+                                  },
+                                  required: ["source"],
+                                  type: "object"
+                                },
+                                guest_phone: {
+                                  description: "How to extract guest phone",
+                                  properties: {
+                                    pattern: {
+                                      description: "Regex with capture group to extract value from the property",
+                                      type: "string"
+                                    },
+                                    source: {
+                                      description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      description: "Special type handling \u2014 'date' parses iCal date formats",
+                                      enum: ["date"],
+                                      type: "string"
+                                    }
+                                  },
+                                  required: ["source"],
+                                  type: "object"
+                                },
+                                reservation_key: {
+                                  description: "How to extract the reservation key (falls back to UID)",
+                                  properties: {
+                                    pattern: {
+                                      description: "Regex with capture group to extract value from the property",
+                                      type: "string"
+                                    },
+                                    source: {
+                                      description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      description: "Special type handling \u2014 'date' parses iCal date formats",
+                                      enum: ["date"],
+                                      type: "string"
+                                    }
+                                  },
+                                  required: ["source"],
+                                  type: "object"
+                                },
+                                starts_at: {
+                                  description: "How to extract check-in date",
+                                  properties: {
+                                    pattern: {
+                                      description: "Regex with capture group to extract value from the property",
+                                      type: "string"
+                                    },
+                                    source: {
+                                      description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                      type: "string"
+                                    },
+                                    type: {
+                                      description: "Special type handling \u2014 'date' parses iCal date formats",
+                                      enum: ["date"],
+                                      type: "string"
+                                    }
+                                  },
+                                  required: ["source"],
+                                  type: "object"
+                                }
+                              },
+                              required: ["starts_at", "ends_at"],
+                              type: "object"
+                            },
+                            filter: {
+                              description: "Optional filter to skip non-matching events",
+                              properties: {
+                                pattern: {
+                                  description: "Regex pattern \u2014 events not matching are skipped",
+                                  type: "string"
+                                },
+                                source: {
+                                  description: "iCal property name to match against",
+                                  type: "string"
+                                }
+                              },
+                              required: ["source", "pattern"],
+                              type: "object"
+                            },
+                            time_zone: {
+                              description: "IANA time zone (e.g. America/New_York) applied when dates have no time/timezone",
+                              type: "string"
+                            }
+                          },
+                          required: ["fields"],
+                          type: "object"
+                        }
+                      },
+                      required: ["ical_config"],
+                      type: "object"
+                    },
+                    ok: { type: "boolean" }
+                  },
+                  required: ["generated_config", "ok"],
+                  type: "object"
+                }
+              }
+            },
+            description: "OK"
+          },
+          400: { description: "Bad Request" },
+          401: { description: "Unauthorized" }
+        },
+        security: [{ api_key: [] }, { console_session_with_workspace: [] }],
+        summary: "/seam/customer/v1/connectors/ical/generate-config",
+        tags: [],
+        "x-fern-sdk-group-name": [
+          "seam",
+          "customer",
+          "v1",
+          "connectors",
+          "ical"
+        ],
+        "x-fern-sdk-method-name": "generate-config",
+        "x-fern-sdk-return-value": "generated_config",
+        "x-response-key": "generated_config",
+        "x-title": "Generate iCal Config",
+        "x-undocumented": "Only used internally."
+      }
+    },
+    "/seam/customer/v1/connectors/ical/validate-config": {
+      post: {
+        description: "Fetches a sample iCal feed and validates the config against it,\nreturning the parsed reservations so the caller can verify\nextraction is correct.",
+        operationId: "seamCustomerV1ConnectorsIcalValidateConfigPost",
+        requestBody: {
+          content: {
+            "application/json": {
+              schema: {
+                properties: {
+                  ical_config: {
+                    description: "Config to validate",
+                    properties: {
+                      default_check_in_time: {
+                        description: "Default check-in time (HH:MM) used when iCal gives date-only values",
+                        pattern: "^\\d{2}:\\d{2}$",
+                        type: "string"
+                      },
+                      default_check_out_time: {
+                        description: "Default check-out time (HH:MM) used when iCal gives date-only values",
+                        pattern: "^\\d{2}:\\d{2}$",
+                        type: "string"
+                      },
+                      fields: {
+                        properties: {
+                          ends_at: {
+                            description: "How to extract check-out date",
+                            properties: {
+                              pattern: {
+                                description: "Regex with capture group to extract value from the property",
+                                type: "string"
+                              },
+                              source: {
+                                description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                type: "string"
+                              },
+                              type: {
+                                description: "Special type handling \u2014 'date' parses iCal date formats",
+                                enum: ["date"],
+                                type: "string"
+                              }
+                            },
+                            required: ["source"],
+                            type: "object"
+                          },
+                          guest_email: {
+                            description: "How to extract guest email",
+                            properties: {
+                              pattern: {
+                                description: "Regex with capture group to extract value from the property",
+                                type: "string"
+                              },
+                              source: {
+                                description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                type: "string"
+                              },
+                              type: {
+                                description: "Special type handling \u2014 'date' parses iCal date formats",
+                                enum: ["date"],
+                                type: "string"
+                              }
+                            },
+                            required: ["source"],
+                            type: "object"
+                          },
+                          guest_name: {
+                            description: "How to extract guest name",
+                            properties: {
+                              pattern: {
+                                description: "Regex with capture group to extract value from the property",
+                                type: "string"
+                              },
+                              source: {
+                                description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                type: "string"
+                              },
+                              type: {
+                                description: "Special type handling \u2014 'date' parses iCal date formats",
+                                enum: ["date"],
+                                type: "string"
+                              }
+                            },
+                            required: ["source"],
+                            type: "object"
+                          },
+                          guest_phone: {
+                            description: "How to extract guest phone",
+                            properties: {
+                              pattern: {
+                                description: "Regex with capture group to extract value from the property",
+                                type: "string"
+                              },
+                              source: {
+                                description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                type: "string"
+                              },
+                              type: {
+                                description: "Special type handling \u2014 'date' parses iCal date formats",
+                                enum: ["date"],
+                                type: "string"
+                              }
+                            },
+                            required: ["source"],
+                            type: "object"
+                          },
+                          reservation_key: {
+                            description: "How to extract the reservation key (falls back to UID)",
+                            properties: {
+                              pattern: {
+                                description: "Regex with capture group to extract value from the property",
+                                type: "string"
+                              },
+                              source: {
+                                description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                type: "string"
+                              },
+                              type: {
+                                description: "Special type handling \u2014 'date' parses iCal date formats",
+                                enum: ["date"],
+                                type: "string"
+                              }
+                            },
+                            required: ["source"],
+                            type: "object"
+                          },
+                          starts_at: {
+                            description: "How to extract check-in date",
+                            properties: {
+                              pattern: {
+                                description: "Regex with capture group to extract value from the property",
+                                type: "string"
+                              },
+                              source: {
+                                description: "iCal property name to read from: UID, SUMMARY, DESCRIPTION, DTSTART, DTEND, etc.",
+                                type: "string"
+                              },
+                              type: {
+                                description: "Special type handling \u2014 'date' parses iCal date formats",
+                                enum: ["date"],
+                                type: "string"
+                              }
+                            },
+                            required: ["source"],
+                            type: "object"
+                          }
+                        },
+                        required: ["starts_at", "ends_at"],
+                        type: "object"
+                      },
+                      filter: {
+                        description: "Optional filter to skip non-matching events",
+                        properties: {
+                          pattern: {
+                            description: "Regex pattern \u2014 events not matching are skipped",
+                            type: "string"
+                          },
+                          source: {
+                            description: "iCal property name to match against",
+                            type: "string"
+                          }
+                        },
+                        required: ["source", "pattern"],
+                        type: "object"
+                      },
+                      time_zone: {
+                        description: "IANA time zone (e.g. America/New_York) applied when dates have no time/timezone",
+                        type: "string"
+                      }
+                    },
+                    required: ["fields"],
+                    type: "object"
+                  },
+                  ical_url: {
+                    description: "iCal feed URL to validate against",
+                    format: "uri",
+                    type: "string"
+                  }
+                },
+                required: ["ical_url", "ical_config"],
+                type: "object"
+              }
+            }
+          }
+        },
+        responses: {
+          200: {
+            content: {
+              "application/json": {
+                schema: {
+                  properties: {
+                    ok: { type: "boolean" },
+                    validation_result: {
+                      properties: {
+                        errors: { items: { type: "string" }, type: "array" },
+                        filtered_events: { format: "float", type: "number" },
+                        is_valid: { type: "boolean" },
+                        matched_events: { format: "float", type: "number" },
+                        reservations: {
+                          items: {
+                            properties: {
+                              ends_at: { nullable: true, type: "string" },
+                              guest_email: { nullable: true, type: "string" },
+                              guest_name: { nullable: true, type: "string" },
+                              guest_phone: { nullable: true, type: "string" },
+                              reservation_key: {
+                                nullable: true,
+                                type: "string"
+                              },
+                              starts_at: { nullable: true, type: "string" },
+                              uid: { type: "string" }
+                            },
+                            required: [
+                              "uid",
+                              "reservation_key",
+                              "guest_name",
+                              "guest_email",
+                              "guest_phone",
+                              "starts_at",
+                              "ends_at"
+                            ],
+                            type: "object"
+                          },
+                          type: "array"
+                        },
+                        total_events: { format: "float", type: "number" }
+                      },
+                      required: [
+                        "is_valid",
+                        "total_events",
+                        "matched_events",
+                        "filtered_events",
+                        "reservations",
+                        "errors"
+                      ],
+                      type: "object"
+                    }
+                  },
+                  required: ["validation_result", "ok"],
+                  type: "object"
+                }
+              }
+            },
+            description: "OK"
+          },
+          400: { description: "Bad Request" },
+          401: { description: "Unauthorized" }
+        },
+        security: [{ api_key: [] }, { console_session_with_workspace: [] }],
+        summary: "/seam/customer/v1/connectors/ical/validate-config",
+        tags: [],
+        "x-fern-sdk-group-name": [
+          "seam",
+          "customer",
+          "v1",
+          "connectors",
+          "ical"
+        ],
+        "x-fern-sdk-method-name": "validate-config",
+        "x-fern-sdk-return-value": "validation_result",
+        "x-response-key": "validation_result",
+        "x-title": "Validate iCal Config",
+        "x-undocumented": "Only used internally."
+      }
+    },
     "/seam/customer/v1/connectors/list": {
       get: {
         description: "Lists connectors for a workspace (API key auth) or for a specific customer (customer client session auth).",