@unified-api/typescript-sdk 2.86.4 → 2.86.6

package/src/funcs/unifiedPatchUnifiedWebhookResume.ts

@@ -0,0 +1,168 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { UnifiedToCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../sdk/models/errors/httpclienterrors.js";
+import { ResponseValidationError } from "../sdk/models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../sdk/models/errors/sdkvalidationerror.js";
+import { UnifiedToError } from "../sdk/models/errors/unifiedtoerror.js";
+import * as operations from "../sdk/models/operations/index.js";
+import * as shared from "../sdk/models/shared/index.js";
+import { APICall, APIPromise } from "../sdk/types/async.js";
+import { Result } from "../sdk/types/fp.js";
+
+/**
+ * Resume an unhealthy webhook subscription
+ *
+ * @remarks
+ * Sets is_healthy back to true and restarts the webhook. Fix the cause first (hook_url, connection auth); the connection must be healthy. Virtual: continues from where it stopped. A webhook that went unhealthy mid-initial-sync before resume was available restarts its initial sync, so deleting and recreating it is safer. Native: re-subscribes if the provider subscription is missing or expired. Events received while the webhook was unhealthy are not re-sent. Webhook sync (beta): continues from the stored sync token. Page cursors are not stored yet, so a resume can re-send some records. Virtual and initial-sync webhooks that have been unhealthy for more than 7 days cannot be resumed, because resuming would re-send every change since then; delete and recreate them instead. MCP Events subscriptions cannot be resumed; they are managed by their MCP client.
+ */
+export function unifiedPatchUnifiedWebhookResume(
+  client: UnifiedToCore,
+  request: operations.PatchUnifiedWebhookResumeRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    shared.Webhook,
+    | UnifiedToError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: UnifiedToCore,
+  request: operations.PatchUnifiedWebhookResumeRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      shared.Webhook,
+      | UnifiedToError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.PatchUnifiedWebhookResumeRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/unified/webhook/{id}/resume")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "patchUnifiedWebhookResume",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.security,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "PATCH",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    shared.Webhook,
+    | UnifiedToError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, shared.Webhook$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/unifiedUpdateUnifiedWebhookResume.ts

@@ -0,0 +1,168 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { UnifiedToCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../sdk/models/errors/httpclienterrors.js";
+import { ResponseValidationError } from "../sdk/models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../sdk/models/errors/sdkvalidationerror.js";
+import { UnifiedToError } from "../sdk/models/errors/unifiedtoerror.js";
+import * as operations from "../sdk/models/operations/index.js";
+import * as shared from "../sdk/models/shared/index.js";
+import { APICall, APIPromise } from "../sdk/types/async.js";
+import { Result } from "../sdk/types/fp.js";
+
+/**
+ * Resume an unhealthy webhook subscription
+ *
+ * @remarks
+ * Sets is_healthy back to true and restarts the webhook. Fix the cause first (hook_url, connection auth); the connection must be healthy. Virtual: continues from where it stopped. A webhook that went unhealthy mid-initial-sync before resume was available restarts its initial sync, so deleting and recreating it is safer. Native: re-subscribes if the provider subscription is missing or expired. Events received while the webhook was unhealthy are not re-sent. Webhook sync (beta): continues from the stored sync token. Page cursors are not stored yet, so a resume can re-send some records. Virtual and initial-sync webhooks that have been unhealthy for more than 7 days cannot be resumed, because resuming would re-send every change since then; delete and recreate them instead. MCP Events subscriptions cannot be resumed; they are managed by their MCP client.
+ */
+export function unifiedUpdateUnifiedWebhookResume(
+  client: UnifiedToCore,
+  request: operations.UpdateUnifiedWebhookResumeRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    shared.Webhook,
+    | UnifiedToError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: UnifiedToCore,
+  request: operations.UpdateUnifiedWebhookResumeRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      shared.Webhook,
+      | UnifiedToError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.UpdateUnifiedWebhookResumeRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    id: encodeSimple("id", payload.id, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/unified/webhook/{id}/resume")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "updateUnifiedWebhookResume",
+    oAuth2Scopes: null,
+
+    resolvedSecurity: requestSecurity,
+
+    securitySource: client._options.security,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    security: requestSecurity,
+    method: "PUT",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    userAgent: client._options.userAgent,
+    timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req = requestRes.value;
+
+  const doResult = await client._do(req, {
+    context,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "5XX"]),
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req }];
+  }
+  const response = doResult.value;
+
+  const [result] = await M.match<
+    shared.Webhook,
+    | UnifiedToError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, shared.Webhook$inboundSchema),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req);
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -73,8 +73,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0",
-  sdkVersion: "2.86.4",
-  genVersion: "2.950.13",
+  sdkVersion: "2.86.6",
+  genVersion: "2.952.5",
   userAgent:
-    "speakeasy-sdk/typescript 2.86.4 2.950.13 1.0 @unified-api/typescript-sdk",
+    "speakeasy-sdk/typescript 2.86.6 2.952.5 1.0 @unified-api/typescript-sdk",
 } as const;

package/src/sdk/models/operations/createcalendarevent.ts

@@ -33,8 +33,8 @@ export const CreateCalendarEventQueryParamFields = {
   SendNotifications: "send_notifications",
   MatterId: "matter_id",
   Metadata: "metadata",
-  Raw: "raw",
   RoomIds: "room_ids",
+  Raw: "raw",
 } as const;
 export type CreateCalendarEventQueryParamFields = ClosedEnum<
   typeof CreateCalendarEventQueryParamFields

package/src/sdk/models/operations/getcalendarevent.ts

@@ -32,8 +32,8 @@ export const GetCalendarEventQueryParamFields = {
   SendNotifications: "send_notifications",
   MatterId: "matter_id",
   Metadata: "metadata",
-  Raw: "raw",
   RoomIds: "room_ids",
+  Raw: "raw",
 } as const;
 export type GetCalendarEventQueryParamFields = ClosedEnum<
   typeof GetCalendarEventQueryParamFields

package/src/sdk/models/operations/getcalendarlocation.ts

@@ -8,15 +8,15 @@ import { ClosedEnum } from "../../types/enums.js";
 
 export const GetCalendarLocationQueryParamFields = {
   Id: "id",
+  CreatedAt: "created_at",
+  UpdatedAt: "updated_at",
   Name: "name",
   ParentId: "parent_id",
   Type: "type",
   Address: "address",
-  Raw: "raw",
-  CreatedAt: "created_at",
-  UpdatedAt: "updated_at",
   Timezone: "timezone",
   Metadata: "metadata",
+  Raw: "raw",
 } as const;
 export type GetCalendarLocationQueryParamFields = ClosedEnum<
   typeof GetCalendarLocationQueryParamFields

package/src/sdk/models/operations/getcalendarroom.ts

@@ -8,15 +8,15 @@ import { ClosedEnum } from "../../types/enums.js";
 
 export const GetCalendarRoomQueryParamFields = {
   Id: "id",
+  CreatedAt: "created_at",
+  UpdatedAt: "updated_at",
   Name: "name",
+  Type: "type",
   Capacity: "capacity",
   LocationId: "location_id",
-  Raw: "raw",
-  CreatedAt: "created_at",
-  UpdatedAt: "updated_at",
   Description: "description",
-  Type: "type",
   Email: "email",
+  Raw: "raw",
   CalendarId: "calendar_id",
   Floor: "floor",
   Timezone: "timezone",

package/src/sdk/models/operations/getunifiedintegrationauth.ts

@@ -46,7 +46,7 @@ export type GetUnifiedIntegrationAuthRequest = {
    */
   subdomain?: string | undefined;
   /**
-   * The URL where you want the user to be redirect to after a successful authorization.  The connection ID will be appended with (id=<connectionId>) to this URL, as will the state that was provided.
+   * The URL where you want the user to be redirect to after a successful authorization.  The connection ID will be appended with (id=<connectionId>) to this URL, as will the state that was provided. When the workspace has trusted_domains configured, this host must be on that list.
    */
   successRedirect?: string | undefined;
   /**

package/src/sdk/models/operations/getunifiedintegrationlogin.ts

@@ -21,7 +21,7 @@ export type GetUnifiedIntegrationLoginRequest = {
    */
   state?: string | undefined;
   /**
-   * The URL where you want the user to be redirect to after a successful authentication/sign-in.  A "jwt" parameter will be appended to the URL which will contain a name and email of the user who just signed-in.
+   * The URL where you want the user to be redirect to after a successful authentication/sign-in.  A "jwt" parameter will be appended to the URL which will contain a name and email of the user who just signed-in (and a redirect claim matching this URL). When the workspace has trusted_domains configured, this host must be on that list.
    */
   successRedirect?: string | undefined;
   /**

package/src/sdk/models/operations/getunifiedintegrationsaml.ts

@@ -21,7 +21,7 @@ export type GetUnifiedIntegrationSamlRequest = {
    */
   state?: string | undefined;
   /**
-   * The URL where you want the user to be redirect to after a successful authentication/sign-in.  A "jwt" parameter will be appended to the URL which will contain a name and email of the user who just signed-in.
+   * The URL where you want the user to be redirect to after a successful authentication/sign-in.  A "jwt" parameter will be appended to the URL which will contain a name and email of the user who just signed-in (and a redirect claim matching this URL). When the workspace has trusted_domains configured, this host must be on that list.
    */
   successRedirect?: string | undefined;
   /**

package/src/sdk/models/operations/index.ts

@@ -746,6 +746,7 @@ export * from "./patchuccontact.js";
 export * from "./patchucrecording.js";
 export * from "./patchunifiedconnection.js";
 export * from "./patchunifiedwebhook.js";
+export * from "./patchunifiedwebhookresume.js";
 export * from "./patchunifiedwebhooktrigger.js";
 export * from "./patchverificationrequest.js";
 export * from "./removeaccountingaccount.js";
@@ -1043,5 +1044,6 @@ export * from "./updateuccontact.js";
 export * from "./updateucrecording.js";
 export * from "./updateunifiedconnection.js";
 export * from "./updateunifiedwebhook.js";
+export * from "./updateunifiedwebhookresume.js";
 export * from "./updateunifiedwebhooktrigger.js";
 export * from "./updateverificationrequest.js";

package/src/sdk/models/operations/listcalendarevents.ts

@@ -32,8 +32,8 @@ export const ListCalendarEventsQueryParamFields = {
   SendNotifications: "send_notifications",
   MatterId: "matter_id",
   Metadata: "metadata",
-  Raw: "raw",
   RoomIds: "room_ids",
+  Raw: "raw",
 } as const;
 export type ListCalendarEventsQueryParamFields = ClosedEnum<
   typeof ListCalendarEventsQueryParamFields

package/src/sdk/models/operations/listcalendarlocations.ts

@@ -8,15 +8,15 @@ import { ClosedEnum } from "../../types/enums.js";
 
 export const ListCalendarLocationsQueryParamFields = {
   Id: "id",
+  CreatedAt: "created_at",
+  UpdatedAt: "updated_at",
   Name: "name",
   ParentId: "parent_id",
   Type: "type",
   Address: "address",
-  Raw: "raw",
-  CreatedAt: "created_at",
-  UpdatedAt: "updated_at",
   Timezone: "timezone",
   Metadata: "metadata",
+  Raw: "raw",
 } as const;
 export type ListCalendarLocationsQueryParamFields = ClosedEnum<
   typeof ListCalendarLocationsQueryParamFields

package/src/sdk/models/operations/listcalendarrooms.ts

@@ -8,15 +8,15 @@ import { ClosedEnum } from "../../types/enums.js";
 
 export const ListCalendarRoomsQueryParamFields = {
   Id: "id",
+  CreatedAt: "created_at",
+  UpdatedAt: "updated_at",
   Name: "name",
+  Type: "type",
   Capacity: "capacity",
   LocationId: "location_id",
-  Raw: "raw",
-  CreatedAt: "created_at",
-  UpdatedAt: "updated_at",
   Description: "description",
-  Type: "type",
   Email: "email",
+  Raw: "raw",
   CalendarId: "calendar_id",
   Floor: "floor",
   Timezone: "timezone",

package/src/sdk/models/operations/patchcalendarevent.ts

@@ -33,8 +33,8 @@ export const PatchCalendarEventQueryParamFields = {
   SendNotifications: "send_notifications",
   MatterId: "matter_id",
   Metadata: "metadata",
-  Raw: "raw",
   RoomIds: "room_ids",
+  Raw: "raw",
 } as const;
 export type PatchCalendarEventQueryParamFields = ClosedEnum<
   typeof PatchCalendarEventQueryParamFields

package/src/sdk/models/operations/patchunifiedwebhookresume.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type PatchUnifiedWebhookResumeRequest = {
+  /**
+   * ID of the Webhook
+   */
+  id: string;
+};
+
+/** @internal */
+export type PatchUnifiedWebhookResumeRequest$Outbound = {
+  id: string;
+};
+
+/** @internal */
+export const PatchUnifiedWebhookResumeRequest$outboundSchema: z.ZodType<
+  PatchUnifiedWebhookResumeRequest$Outbound,
+  z.ZodTypeDef,
+  PatchUnifiedWebhookResumeRequest
+> = z.object({
+  id: z.string(),
+});
+
+export function patchUnifiedWebhookResumeRequestToJSON(
+  patchUnifiedWebhookResumeRequest: PatchUnifiedWebhookResumeRequest,
+): string {
+  return JSON.stringify(
+    PatchUnifiedWebhookResumeRequest$outboundSchema.parse(
+      patchUnifiedWebhookResumeRequest,
+    ),
+  );
+}

package/src/sdk/models/operations/updatecalendarevent.ts

@@ -33,8 +33,8 @@ export const UpdateCalendarEventQueryParamFields = {
   SendNotifications: "send_notifications",
   MatterId: "matter_id",
   Metadata: "metadata",
-  Raw: "raw",
   RoomIds: "room_ids",
+  Raw: "raw",
 } as const;
 export type UpdateCalendarEventQueryParamFields = ClosedEnum<
   typeof UpdateCalendarEventQueryParamFields

package/src/sdk/models/operations/updateunifiedwebhookresume.ts

@@ -0,0 +1,36 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+
+export type UpdateUnifiedWebhookResumeRequest = {
+  /**
+   * ID of the Webhook
+   */
+  id: string;
+};
+
+/** @internal */
+export type UpdateUnifiedWebhookResumeRequest$Outbound = {
+  id: string;
+};
+
+/** @internal */
+export const UpdateUnifiedWebhookResumeRequest$outboundSchema: z.ZodType<
+  UpdateUnifiedWebhookResumeRequest$Outbound,
+  z.ZodTypeDef,
+  UpdateUnifiedWebhookResumeRequest
+> = z.object({
+  id: z.string(),
+});
+
+export function updateUnifiedWebhookResumeRequestToJSON(
+  updateUnifiedWebhookResumeRequest: UpdateUnifiedWebhookResumeRequest,
+): string {
+  return JSON.stringify(
+    UpdateUnifiedWebhookResumeRequest$outboundSchema.parse(
+      updateUnifiedWebhookResumeRequest,
+    ),
+  );
+}

package/src/sdk/models/shared/crmcontact.ts

@@ -38,7 +38,7 @@ import {
 export type CrmContact = {
   address?: PropertyCrmContactAddress | undefined;
   /**
-   * The companyorganization name  of the contact
+   * The company/organization name  of the contact
    */
   company?: string | undefined;
   /**
@@ -58,12 +58,18 @@ export type CrmContact = {
    * An array of email addresses for this contact
    */
   emails?: Array<CrmEmail> | undefined;
+  /**
+   * The contact's first (given) name
+   */
   firstName?: string | undefined;
   /**
    * Unique identifier for this contact object
    */
   id?: string | undefined;
   imageUrl?: string | undefined;
+  /**
+   * The contact's last (family) name
+   */
   lastName?: string | undefined;
   /**
    * Additional URLs associated with the contact e.g., LinkedIn, website, etc

package/src/sdk/models/shared/enrichperson.ts

@@ -52,7 +52,7 @@ export type EnrichPerson = {
    */
   birthdate?: string | undefined;
   /**
-   * The companyorganization name  of the person
+   * The company/organization name  of the person
    */
   company?: string | undefined;
   /**