@automate.ax/integration-contracts 0.139.1 → 0.141.0

package/src/closebot/api.ts

@@ -0,0 +1,157 @@
+import { isEncodable, type Encodable } from "@automate.ax/codec"
+import * as z from "zod"
+
+const CLOSEBOT_API_ORIGIN = "https://api.closebot.com/"
+
+const CLOSEBOT_SECRET_SCHEMA = z.object({
+  apiKey: z.string().trim().min(1),
+})
+
+export const CLOSEBOT_VALUE_SCHEMA = z.custom<Encodable>(isEncodable, {
+  message: "Expected a codec-safe CloseBot value.",
+})
+
+export const CLOSEBOT_RESPONSE_SCHEMA = z.union([
+  CLOSEBOT_VALUE_SCHEMA,
+  z.undefined().transform(() => null),
+])
+
+interface CloseBotRequestOptions<TSchema extends z.ZodType> {
+  body?: Encodable | FormData
+  method?: "DELETE" | "GET" | "PATCH" | "POST" | "PUT"
+  query?: Record<
+    string,
+    | boolean
+    | Date
+    | number
+    | string
+    | (boolean | Date | number | string)[]
+    | null
+    | undefined
+  >
+  responseSchema: TSchema
+}
+
+/** Error returned by a rejected CloseBot API request. */
+export class CloseBotApiError extends Error {
+  readonly details: Encodable
+  readonly retryAfter?: string
+  readonly status: number
+
+  /**
+   * Creates an error from a rejected CloseBot response.
+   *
+   * @param status - HTTP response status.
+   * @param details - Codec-safe response details.
+   * @param retryAfter - Raw provider retry timing, when present.
+   */
+  constructor(status: number, details: Encodable, retryAfter?: string) {
+    super(`CloseBot API request failed (${status}).`)
+    this.name = "CloseBotApiError"
+    this.details = details
+    this.retryAfter = retryAfter
+    this.status = status
+  }
+}
+
+/**
+ * Creates an authenticated CloseBot REST API client.
+ *
+ * @param secret - Stored CloseBot API key.
+ */
+export function getCloseBotApi(secret: unknown) {
+  const { apiKey } = CLOSEBOT_SECRET_SCHEMA.parse(secret)
+  const root = new URL(CLOSEBOT_API_ORIGIN)
+
+  return {
+    /**
+     * Sends one JSON request to a CloseBot API path.
+     *
+     * @param path - Relative path below the CloseBot API origin.
+     * @param options - Request method, query, body, and response schema.
+     */
+    async request<TSchema extends z.ZodType>(
+      path: string,
+      options: CloseBotRequestOptions<TSchema>,
+    ): Promise<z.output<TSchema>> {
+      const normalizedPath = path.replace(/^\/+/, "")
+      if (
+        !normalizedPath ||
+        normalizedPath.includes("://") ||
+        normalizedPath.includes("\\")
+      ) {
+        throw new TypeError("CloseBot API paths must be relative.")
+      }
+
+      const url = new URL(normalizedPath, root)
+      if (url.origin !== root.origin) {
+        throw new TypeError(
+          "CloseBot API paths must remain on api.closebot.com.",
+        )
+      }
+      for (const [key, value] of Object.entries(options.query ?? {})) {
+        if (value == null) continue
+        if (Array.isArray(value)) {
+          for (const item of value)
+            url.searchParams.append(key, queryValue(item))
+        } else {
+          url.searchParams.set(key, queryValue(value))
+        }
+      }
+
+      const headers = new Headers({
+        Accept: "application/json",
+        "X-CB-KEY": apiKey,
+      })
+      if (options.body !== undefined && !(options.body instanceof FormData)) {
+        headers.set("Content-Type", "application/json")
+      }
+
+      const response = await fetch(url, {
+        body:
+          options.body === undefined
+            ? undefined
+            : options.body instanceof FormData
+              ? options.body
+              : JSON.stringify(options.body),
+        headers,
+        method: options.method ?? "GET",
+        redirect: "error",
+      })
+      const text = await response.text()
+      const parsed = CLOSEBOT_RESPONSE_SCHEMA.safeParse(
+        text ? parseJson(text) : null,
+      )
+      if (!response.ok || !parsed.success) {
+        throw new CloseBotApiError(
+          response.status,
+          parsed.success ? parsed.data : { response: text },
+          response.headers.get("Retry-After") ?? undefined,
+        )
+      }
+      return options.responseSchema.parse(parsed.data)
+    },
+  }
+}
+
+/**
+ * Parses a response while retaining non-JSON provider diagnostics.
+ *
+ * @param value - Raw response body.
+ */
+function parseJson(value: string): unknown {
+  try {
+    return JSON.parse(value)
+  } catch {
+    return value
+  }
+}
+
+/**
+ * Serializes one supported query value.
+ *
+ * @param value - Public query value.
+ */
+function queryValue(value: boolean | Date | number | string) {
+  return value instanceof Date ? value.toISOString() : String(value)
+}

package/src/closebot/index.ts

@@ -0,0 +1,2 @@
+export * from "./api"
+export * from "./schemas"

package/src/closebot/schemas.ts

@@ -0,0 +1,517 @@
+import * as z from "zod"
+
+export const CLOSEBOT_ID_SCHEMA = z.string().trim().min(1)
+
+export const CLOSEBOT_DATE_SCHEMA = z
+  .union([z.date(), z.iso.datetime({ offset: true })])
+  .transform((value) => (value instanceof Date ? value : new Date(value)))
+
+const OPTIONAL_STRING = z.string().nullable().optional()
+const OPTIONAL_BOOLEAN = z.boolean().optional()
+const OPTIONAL_INTEGER = z.number().int().optional()
+const OPTIONAL_DATE = CLOSEBOT_DATE_SCHEMA.nullable().optional()
+
+export const CLOSEBOT_AGENCY_MEMBER_SCHEMA = z.object({
+  accountId: OPTIONAL_STRING,
+  authId: OPTIONAL_STRING,
+  email: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  role: OPTIONAL_STRING,
+  status: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_AGENCY_SCHEMA = z.object({
+  betaTester: OPTIONAL_BOOLEAN,
+  id: OPTIONAL_STRING,
+  members: CLOSEBOT_AGENCY_MEMBER_SCHEMA.array().nullable().optional(),
+  name: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_FOLLOW_UP_SEQUENCE_SCHEMA = z.object({
+  duration: OPTIONAL_INTEGER,
+  order: OPTIONAL_INTEGER,
+  unit: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_FOLLOW_UP_STATE_SCHEMA = z.object({
+  extraPrompt: OPTIONAL_STRING,
+  id: OPTIONAL_INTEGER,
+  isDefault: OPTIONAL_BOOLEAN,
+  name: OPTIONAL_STRING,
+  order: OPTIONAL_INTEGER,
+  repeatFinal: OPTIONAL_BOOLEAN,
+  sequences: CLOSEBOT_FOLLOW_UP_SEQUENCE_SCHEMA.array().nullable().optional(),
+})
+
+export const CLOSEBOT_TAG_SCHEMA = z.object({
+  approveDeny: OPTIONAL_BOOLEAN,
+  id: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_TAG_FILTER_SCHEMA = z.object({
+  groups: z
+    .object({
+      operator: OPTIONAL_STRING,
+      rules: z
+        .object({
+          condition: OPTIONAL_STRING,
+          tagId: OPTIONAL_STRING,
+          tagName: OPTIONAL_STRING,
+        })
+        .array()
+        .nullable()
+        .optional(),
+    })
+    .array()
+    .nullable()
+    .optional(),
+  operator: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_CHANNEL_RULES_SCHEMA = z.object({
+  channels: z
+    .object({
+      channel: OPTIONAL_STRING,
+      rules: z
+        .object({ operator: OPTIONAL_STRING, value: OPTIONAL_STRING })
+        .array()
+        .nullable()
+        .optional(),
+      type: OPTIONAL_STRING,
+    })
+    .array()
+    .nullable()
+    .optional(),
+})
+
+export const CLOSEBOT_BOT_SOURCE_SCHEMA = z.object({
+  category: OPTIONAL_STRING,
+  channelList: z.string().array().nullable().optional(),
+  channelRules: CLOSEBOT_CHANNEL_RULES_SCHEMA.optional(),
+  enabled: OPTIONAL_BOOLEAN,
+  flowVariableValues: z.record(z.string(), z.string()).nullable().optional(),
+  id: OPTIONAL_STRING,
+  key: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  personaNameOverride: OPTIONAL_STRING,
+  tagFilterConfig: CLOSEBOT_TAG_FILTER_SCHEMA.optional(),
+  tags: CLOSEBOT_TAG_SCHEMA.array().nullable().optional(),
+})
+
+export const CLOSEBOT_BOT_VERSION_SCHEMA = z.object({
+  modifiedAt: CLOSEBOT_DATE_SCHEMA.optional(),
+  modifiedBy: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  published: OPTIONAL_BOOLEAN,
+  version: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_PERSONA_SPLIT_TEST_SOURCE_RESULT_SCHEMA = z.object({
+  averageLeadScore: z.number().optional(),
+  responseCount: OPTIONAL_INTEGER,
+  sourceId: OPTIONAL_STRING,
+  sourceName: OPTIONAL_STRING,
+  totalInstances: OPTIONAL_INTEGER,
+})
+
+export const CLOSEBOT_PERSONA_SPLIT_TEST_RESULTS_SCHEMA = z.object({
+  averageLeadScore: z.number().optional(),
+  computedAt: CLOSEBOT_DATE_SCHEMA.optional(),
+  personaId: OPTIONAL_STRING,
+  personaName: OPTIONAL_STRING,
+  responseCount: OPTIONAL_INTEGER,
+  sources: CLOSEBOT_PERSONA_SPLIT_TEST_SOURCE_RESULT_SCHEMA.array()
+    .nullable()
+    .optional(),
+  splitWeight: OPTIONAL_INTEGER,
+  totalInstances: OPTIONAL_INTEGER,
+})
+
+export const CLOSEBOT_PERSONA_SPLIT_TEST_SCHEMA = z.object({
+  endedAt: OPTIONAL_DATE,
+  id: OPTIONAL_STRING,
+  isActive: OPTIONAL_BOOLEAN,
+  personas: z
+    .object({
+      order: OPTIONAL_INTEGER,
+      personaId: OPTIONAL_STRING,
+      results: CLOSEBOT_PERSONA_SPLIT_TEST_RESULTS_SCHEMA.optional(),
+      weight: OPTIONAL_INTEGER,
+    })
+    .array()
+    .nullable()
+    .optional(),
+  startedAt: OPTIONAL_DATE,
+})
+
+export const CLOSEBOT_BOT_TEMPLATE_SCHEMA = z.object({
+  description: OPTIONAL_STRING,
+  id: OPTIONAL_STRING,
+  industry: OPTIONAL_STRING,
+  level: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  previewUrl: OPTIONAL_STRING,
+  tags: z.string().array().nullable().optional(),
+  tier: OPTIONAL_STRING,
+  videoUrl: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_FOLDER_SCHEMA = z.object({
+  bots: z.string().array().nullable(),
+  children: z.string().array().nullable(),
+  id: z.string().nullable(),
+  name: z.string().nullable(),
+  personas: z.string().array().nullable(),
+})
+
+export const CLOSEBOT_FOLDER_CREATED_SCHEMA = z.object({
+  id: z.string().nullable(),
+})
+
+export const CLOSEBOT_BOT_SCHEMA = z.object({
+  category: OPTIONAL_STRING,
+  favorited: OPTIONAL_BOOLEAN,
+  folderId: OPTIONAL_STRING,
+  followUpActive: OPTIONAL_BOOLEAN,
+  followUpExtraPrompt: OPTIONAL_STRING,
+  followUpRepeat: OPTIONAL_BOOLEAN,
+  followUpSequences: CLOSEBOT_FOLLOW_UP_SEQUENCE_SCHEMA.array()
+    .nullable()
+    .optional(),
+  followUpStates: CLOSEBOT_FOLLOW_UP_STATE_SCHEMA.array().nullable().optional(),
+  followUpVarianceMinutes: OPTIONAL_INTEGER,
+  id: OPTIONAL_STRING,
+  locked: OPTIONAL_BOOLEAN,
+  modifiedAt: OPTIONAL_STRING,
+  modifiedBy: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  personaIds: z.string().array().nullable().optional(),
+  personaSplitTest: CLOSEBOT_PERSONA_SPLIT_TEST_SCHEMA.optional(),
+  personaWeights: z.record(z.string(), z.number().int()).nullable().optional(),
+  reschedulingEnabled: OPTIONAL_BOOLEAN,
+  smartFollowUp: OPTIONAL_BOOLEAN,
+  sources: CLOSEBOT_BOT_SOURCE_SCHEMA.array().nullable().optional(),
+  tools: z
+    .object({
+      enabled: OPTIONAL_BOOLEAN,
+      id: OPTIONAL_STRING,
+      options: z.object({}).optional(),
+      type: OPTIONAL_STRING,
+    })
+    .array()
+    .nullable()
+    .optional(),
+  versions: CLOSEBOT_BOT_VERSION_SCHEMA.array().nullable().optional(),
+})
+
+export const CLOSEBOT_PUBLISH_BOT_RESULT_SCHEMA = z.object({
+  message: z.json().optional(),
+  version: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_LEAD_FIELD_SCHEMA = z.object({
+  aiProduced: OPTIONAL_BOOLEAN,
+  field: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  value: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_BOT_INSTANCE_SCHEMA = z.object({
+  botId: OPTIONAL_STRING,
+  botVersion: OPTIONAL_STRING,
+  followUpTime: OPTIONAL_DATE,
+  followUpTimezone: OPTIONAL_STRING,
+  followUpTimezoneKind: OPTIONAL_STRING,
+  isSmartFollowUpTime: OPTIONAL_BOOLEAN,
+  scheduleRespondTime: OPTIONAL_DATE,
+})
+
+export const CLOSEBOT_LEAD_SCHEMA = z.object({
+  contactId: OPTIONAL_STRING,
+  fields: CLOSEBOT_LEAD_FIELD_SCHEMA.array().nullable().optional(),
+  id: OPTIONAL_STRING,
+  instances: CLOSEBOT_BOT_INSTANCE_SCHEMA.array().nullable().optional(),
+  lastMessage: OPTIONAL_STRING,
+  lastMessageBotId: OPTIONAL_STRING,
+  lastMessageDirection: OPTIONAL_STRING,
+  lastMessageIsNote: OPTIONAL_BOOLEAN,
+  lastMessageTime: OPTIONAL_DATE,
+  mentionedMe: OPTIONAL_BOOLEAN,
+  mimicSourceId: OPTIONAL_STRING,
+  mostRecentFailureReason: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  score: z.number().int().nullable().optional(),
+  source: z.object({ id: OPTIONAL_STRING, name: OPTIONAL_STRING }).optional(),
+  starred: OPTIONAL_BOOLEAN,
+  tags: z.string().array().nullable().optional(),
+  unread: OPTIONAL_BOOLEAN,
+  wontRespondUntil: OPTIONAL_DATE,
+})
+
+export const CLOSEBOT_LEAD_PAGE_SCHEMA = z.object({
+  mentionsTotal: z.number().int().nullable().optional(),
+  page: z.number().int(),
+  pageSize: z.number().int(),
+  results: CLOSEBOT_LEAD_SCHEMA.array().nullable(),
+  starredTotal: z.number().int().nullable().optional(),
+  total: z.number().int(),
+})
+
+export const CLOSEBOT_LEAD_SEARCH_RESULT_SCHEMA = z.object({
+  leads: CLOSEBOT_LEAD_SCHEMA.array().nullable(),
+  mentionsTotal: z.number().int().nullable().optional(),
+  starredTotal: z.number().int().nullable().optional(),
+  total: z.number().int(),
+})
+
+export const CLOSEBOT_LEAD_AI_STATUS_SCHEMA = z.object({
+  applicable: OPTIONAL_BOOLEAN,
+  enabled: OPTIONAL_BOOLEAN,
+  reason: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_LEAD_HISTORY_EVENT_SCHEMA = z.object({
+  actionKey: OPTIONAL_STRING,
+  domain: OPTIONAL_STRING,
+  eventType: OPTIONAL_STRING,
+  id: OPTIONAL_STRING,
+  path: OPTIONAL_STRING,
+  points: z.number().int().nullable().optional(),
+  title: OPTIONAL_STRING,
+  triggerType: OPTIONAL_STRING,
+  url: OPTIONAL_STRING,
+  visitedAt: CLOSEBOT_DATE_SCHEMA.optional(),
+})
+
+export const CLOSEBOT_NOTE_RESULT_SCHEMA = z.object({
+  aiVisible: z.boolean(),
+  noteId: z.string().nullable(),
+})
+
+export const CLOSEBOT_SCHEDULED_MESSAGE_SCHEMA = z.object({
+  body: OPTIONAL_STRING,
+  botId: OPTIONAL_STRING,
+  cancelOnReply: z.boolean(),
+  channel: OPTIONAL_STRING,
+  createdAt: CLOSEBOT_DATE_SCHEMA,
+  createdByAccountId: z.string().nullable(),
+  createdByIconUrl: OPTIONAL_STRING,
+  createdByName: OPTIONAL_STRING,
+  id: z.string().nullable(),
+  kind: z.string().nullable(),
+  leadId: z.string().nullable(),
+  sendAt: CLOSEBOT_DATE_SCHEMA,
+  sentMessageId: OPTIONAL_STRING,
+  sourceId: OPTIONAL_STRING,
+  status: z.string().nullable(),
+  statusReason: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SEND_MESSAGE_RESULT_SCHEMA = z.object({
+  messageId: z.string().nullable(),
+})
+
+export const CLOSEBOT_SOURCE_AVAILABILITY_SCHEMA = z.object({
+  dayOfWeekUtc: OPTIONAL_STRING,
+  duration: OPTIONAL_STRING,
+  startTimeUtc: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_BOT_SOURCE_AVAILABILITY_SCHEMA =
+  CLOSEBOT_SOURCE_AVAILABILITY_SCHEMA.extend({ channel: OPTIONAL_STRING })
+
+export const CLOSEBOT_DO_NOT_RESPOND_WINDOW_SCHEMA = z.object({
+  end: CLOSEBOT_DATE_SCHEMA.optional(),
+  start: CLOSEBOT_DATE_SCHEMA.optional(),
+})
+
+export const CLOSEBOT_SOURCE_SCHEMA = z.object({
+  accountsWithAccess: z.string().array().nullable().optional(),
+  address: OPTIONAL_STRING,
+  agencyId: OPTIONAL_STRING,
+  autoShutoff: OPTIONAL_BOOLEAN,
+  botRespondWindows: CLOSEBOT_BOT_SOURCE_AVAILABILITY_SCHEMA.array()
+    .nullable()
+    .optional(),
+  bots: z
+    .object({
+      botName: OPTIONAL_STRING,
+      channelRules: CLOSEBOT_CHANNEL_RULES_SCHEMA.optional(),
+      channels: z.string().array().nullable().optional(),
+      enabled: OPTIONAL_BOOLEAN,
+      id: OPTIONAL_STRING,
+      personaNameOverride: OPTIONAL_STRING,
+      tagFilterConfig: CLOSEBOT_TAG_FILTER_SCHEMA.optional(),
+      tags: CLOSEBOT_TAG_SCHEMA.array().nullable().optional(),
+    })
+    .array()
+    .nullable()
+    .optional(),
+  category: OPTIONAL_STRING,
+  connected: OPTIONAL_BOOLEAN,
+  doNotRespondWindows: CLOSEBOT_DO_NOT_RESPOND_WINDOW_SCHEMA.array()
+    .nullable()
+    .optional(),
+  gracefulGoodbye: OPTIONAL_BOOLEAN,
+  hubSpotOwnerId: OPTIONAL_STRING,
+  isAvailabilityContactTimezone: OPTIONAL_BOOLEAN,
+  isBotRespondWindowsQuietHours: OPTIONAL_BOOLEAN,
+  key: OPTIONAL_STRING,
+  markConversationAsUnread: OPTIONAL_BOOLEAN,
+  name: OPTIONAL_STRING,
+  respondToReactions: OPTIONAL_BOOLEAN,
+  respondWindows: CLOSEBOT_SOURCE_AVAILABILITY_SCHEMA.array()
+    .nullable()
+    .optional(),
+  scriptDomainAllowList: z.string().array().nullable().optional(),
+  scriptInstalled: OPTIONAL_BOOLEAN,
+  scriptLastSeenAt: OPTIONAL_DATE,
+  scriptLastSeenDomain: OPTIONAL_STRING,
+  scriptLastSeenEndpoint: OPTIONAL_STRING,
+  sourceId: OPTIONAL_STRING,
+  summarizeAttachments: OPTIONAL_BOOLEAN,
+  timezone: OPTIONAL_STRING,
+  webhookCallback: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SOURCE_PAGE_SCHEMA = z.object({
+  page: z.number().int(),
+  pageSize: z.number().int(),
+  results: CLOSEBOT_SOURCE_SCHEMA.array().nullable(),
+  total: z.number().int(),
+})
+
+export const CLOSEBOT_SOURCE_CALENDAR_SCHEMA = z.object({
+  id: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SOURCE_CHANNEL_SCHEMA = z.object({
+  filterType: OPTIONAL_STRING,
+  id: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+  source: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SOURCE_FIELD_SCHEMA = z.object({
+  dataType: OPTIONAL_STRING,
+  fieldKey: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SOURCE_FIELDS_SCHEMA = z.object({
+  contact: CLOSEBOT_SOURCE_FIELD_SCHEMA.array().nullable().optional(),
+  customValue: CLOSEBOT_SOURCE_FIELD_SCHEMA.array().nullable().optional(),
+  location: CLOSEBOT_SOURCE_FIELD_SCHEMA.array().nullable().optional(),
+})
+
+export const CLOSEBOT_SOURCE_TAG_SCHEMA = z.object({
+  id: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SOURCE_OWNER_SCHEMA = z.object({
+  email: OPTIONAL_STRING,
+  firstName: OPTIONAL_STRING,
+  lastName: OPTIONAL_STRING,
+  ownerId: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_LIBRARY_FILE_SOURCE_SCHEMA = z.object({
+  category: OPTIONAL_STRING,
+  id: OPTIONAL_STRING,
+  name: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_LIBRARY_FILE_SCHEMA = z.object({
+  accountId: OPTIONAL_STRING,
+  estimatedFileSize: z.number().int().optional(),
+  externalItemId: OPTIONAL_STRING,
+  externalLibraryResourceSyncId: OPTIONAL_STRING,
+  externalProvider: OPTIONAL_STRING,
+  externalResourceId: OPTIONAL_STRING,
+  externalResourceName: OPTIONAL_STRING,
+  externalResourceType: OPTIONAL_STRING,
+  faviconUrl: OPTIONAL_STRING,
+  fileId: OPTIONAL_STRING,
+  fileName: OPTIONAL_STRING,
+  fileSize: z.number().int().optional(),
+  fileStatus: OPTIONAL_STRING,
+  fileType: OPTIONAL_STRING,
+  lastModified: CLOSEBOT_DATE_SCHEMA.optional(),
+  lastUse: OPTIONAL_DATE,
+  sources: CLOSEBOT_LIBRARY_FILE_SOURCE_SCHEMA.array().nullable().optional(),
+  uri: OPTIONAL_STRING,
+  uses: z.number().int().nullable().optional(),
+})
+
+export const CLOSEBOT_LIBRARY_FILE_PREVIEW_SCHEMA = z.object({
+  chunks: z
+    .object({ chunkIndex: OPTIONAL_INTEGER, content: OPTIONAL_STRING })
+    .array()
+    .nullable()
+    .optional(),
+  content: OPTIONAL_STRING,
+  errorMessage: OPTIONAL_STRING,
+  fileId: OPTIONAL_STRING,
+  fileName: OPTIONAL_STRING,
+  fileSize: z.number().int().optional(),
+  fileStatus: OPTIONAL_STRING,
+  fileType: OPTIONAL_STRING,
+  lastModified: CLOSEBOT_DATE_SCHEMA.optional(),
+  previewSource: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_WEB_SCRAPE_PAGE_SCHEMA = z.object({
+  enabled: OPTIONAL_BOOLEAN,
+  url: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_BOT_VARIABLE_SCHEMA = z.object({
+  id: z.string().nullable(),
+  name: z.string().nullable(),
+  value: z.string().nullable(),
+})
+
+export const CLOSEBOT_PERSONA_SCHEMA = z.object({
+  agencyId: OPTIONAL_STRING,
+  aiProviderPreferences: z.string().array().nullable().optional(),
+  botIds: z.string().array().nullable().optional(),
+  bots: z
+    .object({ id: OPTIONAL_STRING, name: OPTIONAL_STRING })
+    .array()
+    .nullable()
+    .optional(),
+  breakupLargeMessagePercent: OPTIONAL_INTEGER,
+  color: OPTIONAL_STRING,
+  default: OPTIONAL_BOOLEAN,
+  description: OPTIONAL_STRING,
+  favorited: OPTIONAL_BOOLEAN,
+  folderId: OPTIONAL_STRING,
+  howToRespond: OPTIONAL_STRING,
+  id: OPTIONAL_STRING,
+  imageUri: OPTIONAL_STRING,
+  modifiedAt: OPTIONAL_STRING,
+  modifiedBy: OPTIONAL_STRING,
+  personaName: OPTIONAL_STRING,
+  responseDelay: OPTIONAL_INTEGER,
+  responseTime: OPTIONAL_STRING,
+  typoPercent: OPTIONAL_INTEGER,
+  voiceStyles: OPTIONAL_STRING,
+})
+
+export const CLOSEBOT_SMART_FAQ_STATE_SCHEMA = z.union([
+  z.literal(0),
+  z.literal(1),
+])
+
+export const CLOSEBOT_SMART_FAQ_SCHEMA = z.object({
+  agencyId: OPTIONAL_STRING,
+  answer: OPTIONAL_STRING,
+  id: OPTIONAL_STRING,
+  leadIds: z.string().array().nullable().optional(),
+  question: OPTIONAL_STRING,
+  sourceId: OPTIONAL_STRING,
+  state: CLOSEBOT_SMART_FAQ_STATE_SCHEMA.optional(),
+})