@periskope/types 0.6.424 → 0.6.425

package/src/types.ts

@@ -1,1792 +1,1792 @@
-import {
-  Customer,
-  Estimate,
-  HostedPage,
-  ItemPrice,
-  Subscription,
-} from 'chargebee';
-
-import { Merge, OverrideProperties } from 'type-fest';
-import { Filter, Rule } from './rules.types';
-import { Tables, TablesInsert, TablesUpdate } from './supabase.types';
-
-/* ----------------------------- TYPE SHORTHANDS ---------------------------- */
-
-/* ------------------------------ PERISKOPE TYPES ------------------------------ */
-
-export enum AllPlans {
-  FREE_TRIAL = 'free-trial',
-  // MONTHLY_STARTER = 'monthly-starter',
-  // YEARLY_STARTER = 'yearly-starter',
-  // MONTHLY_PRO = 'monthly-pro',
-  // YEARLY_PRO = 'yearly-pro',
-  ENTERPRISE = 'enterprise',
-  MONTHLY_STARTER_SINGLE = 'monthly-starter-single',
-  YEARLY_STARTER_SINGLE = 'yearly-starter-single',
-  MONTHLY_PRO_SINGLE = 'monthly-pro-single',
-  YEARLY_PRO_SINGLE = 'yearly-pro-single',
-}
-
-export type Frequency = 'yearly' | 'monthly' | 'weekly' | 'custom';
-
-export type Enterprise = `${string}-enterprise`;
-
-export type OrgPlanEnterprise = {
-  subscription_id: string;
-  plan_id: Enterprise;
-  interval: number;
-  frequency: Frequency;
-  user_limit: number;
-  phone_limit: number;
-  current_period_start: number;
-  current_period_end: number | null;
-  additional_user_limit?: number;
-  additional_phone_limit?: number;
-  allocated_user_limit?: number;
-  allocated_phone_limit?: number;
-  currency: string;
-  cancelled_at?: number;
-  cancel_schedule_created_at?: number;
-  subscription_status?: string;
-  discount?: number;
-};
-
-export type OrgPlanNonEnterprise = {
-  subscription_id: string;
-  plan_id: AllPlans;
-  interval: number;
-  frequency: Frequency;
-  user_limit: number;
-  phone_limit: number;
-  current_period_end: number;
-  current_period_start: number;
-  additional_user_limit?: number;
-  additional_phone_limit?: number;
-  allocated_user_limit?: number;
-  allocated_phone_limit?: number;
-  currency: string;
-  cancelled_at?: number;
-  cancel_schedule_created_at?: number;
-  subscription_status?: string;
-  discount?: number;
-};
-
-export type OrgPlan<T extends AllPlans | Enterprise> = T extends Enterprise
-  ? OrgPlanEnterprise
-  : T extends AllPlans
-    ? OrgPlanNonEnterprise
-    : never;
-
-export type MicrosurveyData = {
-  key: string;
-  text: string;
-  checked: boolean;
-}[];
-
-export type OrgPreferences = {
-  disable_allow_exports?: boolean;
-  disable_view_deleted_messages?: boolean;
-  sync_phone_contacts?: boolean;
-  mask_phone_numbers?: boolean;
-  show_sender_names?: boolean;
-  closed_chats?: Record<string, number>;
-  auto_read_muted_chats?: boolean;
-  member_permissions?: Record<string, boolean>;
-  show_active_phone_only_messages_right?: boolean;
-};
-
-type OrgPreferenceKey = keyof OrgPreferences;
-
-export type OrgPreferencesValue = {
-  [K in OrgPreferenceKey]: { key: K; value: OrgPreferences[K] };
-}[OrgPreferenceKey];
-
-export type OrgAISettings = {
-  is_ai_agent_enabled?: boolean;
-  is_ai_training_enabled?: boolean;
-  is_ai_flagging_enabled?: boolean;
-  is_ai_agent_default_on?: boolean;
-  ai_agent_activation_prompt?: string;
-  ai_flag_prompt?: string;
-  ai_nickname?: string;
-  confidence_score?: string;
-  company_overview?: string;
-  ai_responder_roles?: string;
-  human_agent_roles?: string;
-  ticket_creation_rules?: string;
-  private_note_creation_rules?: string;
-  response_delay_value?: string;
-  snooze_delay_value?: string;
-  temperature?: string;
-  top_p?: string;
-  top_k?: string;
-  ai_maintain_flag_status?: boolean;
-  enable_shift_timing?: boolean;
-  shift_start_time?: string;
-  shift_end_time?: string;
-  // New Types
-  is_agent_ticketing_enabled?: boolean;
-  is_agent_private_notes_enabled?: boolean;
-  is_agent_response_enabled?: boolean;
-  ai_archetype?: AgentArchetype;
-  use_new_agent_base_prompt?: boolean;
-  ai_restrictions?: string;
-  agent_company_context?: string;
-  agent_custom_rules?: string;
-  allowed_org_phones?: string[];
-  self_learned_context_needs_approval?: boolean;
-};
-
-type OrgAISettingsKey = keyof OrgAISettings;
-
-export type OrgAISettingsValue = {
-  [K in OrgAISettingsKey]: { key: K; value: OrgAISettings[K] };
-}[OrgAISettingsKey];
-
-export enum AgentArchetype {
-  STRICT_GROUNDED = 'strict_grounded',
-  SPARTAN = 'spartan',
-  FRIENDLY = 'friendly',
-  SALES_FORWARD = 'sales_forward',
-}
-
-export type CustomPropertySectionType = {
-  id: string;
-  name: string;
-  order: number;
-  type: 'chat' | 'ticket';
-  properties_order?: {
-    [id: string]: number;
-  };
-};
-
-export enum CustomPropertyValueType {
-  DROPDOWN = 'dropdown',
-  TEXT = 'text',
-  DATE = 'date',
-  FILE = 'file',
-  PICKLIST = 'picklist',
-  DEPENDENT_DROPDOWN = 'dependent_dropdown',
-}
-
-export type CustomPropertyMetadataType = {
-  section_id?: string;
-};
-
-export type CustomPropertyTextPropertiesType = {
-  property_value_type: CustomPropertyValueType.TEXT;
-  property_value: null;
-  property_metadata: CustomPropertyMetadataType;
-};
-
-export type CustomPropertyDropdownPropertiesType = {
-  property_value_type: CustomPropertyValueType.DROPDOWN;
-  property_value: {
-    [key: string]: string;
-  };
-  property_metadata: CustomPropertyMetadataType;
-};
-
-export type CustomPropertyPicklistPropertiesType = {
-  property_value_type: CustomPropertyValueType.PICKLIST;
-  property_value: {
-    [key: string]: string;
-  };
-  property_metadata: CustomPropertyMetadataType;
-};
-
-export type CustomPropertyDependentDropdownPropertiesType = {
-  property_value_type: CustomPropertyValueType.DEPENDENT_DROPDOWN;
-  property_value: {
-    level_1: {
-      value: string;
-      label: string;
-      level_2: {
-        value: string;
-        label: string;
-        level_3: {
-          value: string;
-          label: string;
-        }[];
-      }[];
-    }[];
-  };
-  property_metadata: Merge<
-    CustomPropertyMetadataType,
-    {
-      level_names: {
-        level_1: string;
-        level_2: string;
-        level_3: string;
-      };
-    }
-  >;
-};
-
-export type CustomPropertyFilePropertiesType = {
-  property_value_type: CustomPropertyValueType.FILE;
-  property_value: null;
-  property_metadata: CustomPropertyMetadataType;
-};
-
-export type CustomPropertyDatePropertiesType = {
-  property_value_type: CustomPropertyValueType.DATE;
-  property_value: null;
-  property_metadata: CustomPropertyMetadataType;
-};
-
-export type CustomPropertyType = OverrideProperties<
-  Tables<'tbl_custom_properties'>,
-  | CustomPropertyDependentDropdownPropertiesType
-  | CustomPropertyTextPropertiesType
-  | CustomPropertyDropdownPropertiesType
-  | CustomPropertyPicklistPropertiesType
-  | CustomPropertyFilePropertiesType
-  | CustomPropertyDatePropertiesType
->;
-
-export type OrgMetadata = {
-  phone_number: string;
-  ticket_prefix: string;
-  referralSource?: string;
-  contact_name?: string;
-  surveyData?: MicrosurveyData;
-  preferences?: OrgPreferences;
-  partition?: boolean;
-  hubspot_company_id?: string;
-  tickets: {
-    prefix?: string;
-    emoji_ticketing: {
-      is_enabled?: boolean;
-      is_message_enabled?: boolean;
-      message_template?: string;
-    };
-    disable_auto_attach_message_to_ticket?: boolean;
-  };
-  attribution?: Object;
-  affiliate_id?: string;
-  custom_properties?: {
-    sections?: CustomPropertySectionType[];
-  };
-  rules?: {
-    limit?: number;
-  };
-  display_language?: string;
-  auto_translate_messages?: boolean;
-  custom_invite?: {
-    is_enabled: boolean;
-    template: string;
-  };
-};
-
-export type GroupTemplateType = OverrideProperties<
-  Tables<'tbl_group_templates'>,
-  {
-    group_metadata: {
-      messagesAdminsOnly?: boolean;
-      infoAdminsOnly?: boolean;
-      addMembersAdminsOnly?: boolean;
-      description?: string;
-      admins?: string[];
-    };
-  }
->;
-
-type AccessScopes = {
-  feature_flags: Record<string, boolean>;
-  integrations: boolean;
-  rules: boolean;
-  exports: boolean;
-};
-
-export type OrgMembersType = OverrideProperties<
-  Tables<'tbl_org_members'>,
-  {
-    member_metadata: {
-      shift_times: {
-        [day in
-          | 'monday'
-          | 'tuesday'
-          | 'wednesday'
-          | 'thursday'
-          | 'friday'
-          | 'saturday'
-          | 'sunday']?: [[string, string]];
-      };
-      override_status: boolean;
-      [key: string]: any;
-    };
-  }
->;
-
-export type OrgType = OverrideProperties<
-  Merge<
-    Tables<'tbl_org'>,
-    {
-      user: OrgMembersType;
-      members: OrgMembersType[];
-      phones: Tables<'tbl_org_phones'>[];
-      labels: Tables<'tbl_org_labels'>[];
-      quick_replies: Tables<'tbl_quick_replies'>[];
-      custom_properties: CustomPropertyType[];
-      subscription_status: 'active' | 'inactive' | 'unpaid';
-      is_enterprise: boolean;
-      is_free_trial: boolean;
-      is_hubspot_connected: boolean;
-      is_freshdesk_connected: boolean;
-      is_zohodesk_connected: boolean;
-      is_zohocrm_connected: boolean;
-      access_scopes: AccessScopes;
-      rules: Rule[];
-      phone_limit: number;
-      user_limit: number;
-      allocated_user_limit: number;
-      allocated_phone_limit: number;
-      additional_user_limit: number;
-      additional_phone_limit: number;
-      hubspot_tokens: Tables<'tbl_integration_tokens'> | null;
-    }
-  >,
-  {
-    org_plan: OrgPlan<AllPlans | Enterprise>;
-    stripe_customer_details: Customer | null;
-    stripe_subscription_details: Array<Subscription> | null;
-    stripe_customer_id: Customer['id'] | null;
-    org_metadata: OrgMetadata;
-    ai_settings: OrgAISettings;
-  }
->;
-
-export type ChatMemberType = Merge<
-  Tables<'tbl_chat_participants'>,
-  Tables<'tbl_contacts'>
->;
-
-export type ChatType = Merge<
-  Tables<'view_chats'>,
-  {
-    chat_id: string;
-    latest_message: MessageType | null;
-    latest_message_timestamp: number | null;
-    latest_message_timestamp_map?: Record<string, number | null>;
-    members: { [key: string]: ChatMemberType } | null;
-    chat_type: 'user' | 'group' | 'business' | 'unknown';
-    chat_access: { [key: string]: boolean };
-    label_ids: { [key: string]: boolean };
-    chat_org_phones?: string[];
-    message_unread_count: number | null;
-    hubspot_metadata: {
-      id: string;
-      type: string;
-      hubId: string;
-      object_data: HubspotObjectDataType;
-    } | null;
-    info_admins_only: boolean;
-    messages_admins_only: boolean;
-    unread_count?: { [key: string]: number };
-    active_phone: string | null;
-    flag_count_map?: { [key: string]: number };
-    is_archived?: boolean;
-    is_pinned?: boolean;
-    closed_at?: number | null;
-    common_chats?: string[];
-    freshdesk_metadata?: Record<string, any>;
-    zohodesk_metadata?: Record<string, any>;
-    zohocrm_metadata?: Record<string, any>;
-    pinned_messages?: {
-      message_id: string;
-      pinned_at: number;
-      expires_at: number;
-    }[];
-    group_metadata?: Record<string, any>;
-    snooze_metadata?: {
-      snooze_until: number;
-      snooze_message?: string;
-      snooze_by?: string;
-    };
-    member_unread_count?: {
-      [key: string]: number;
-    };
-    member_closed_at?: {
-      [key: string]: number;
-    };
-    ai_metadata: ChatAIMetadataType;
-    tickets?: TicketType[];
-    tasks?: TaskType[];
-  }
->;
-
-export type ChatPropertiesType = Merge<
-  Tables<'tbl_chat_properties'>,
-  { ai_metadata: ChatAIMetadataType }
->;
-
-export type ChatAIMetadataType = {
-  is_active: boolean;
-  snooze_until: string;
-  activation_state: 'active' | 'inactive' | 'snoozed' | 'thinking';
-  is_agent_allowed: boolean;
-  is_flagging_allowed: boolean;
-} | null;
-
-/* -------------------------------------------------------------------------- */
-/*                                   MESSAGE                                  */
-/* -------------------------------------------------------------------------- */
-
-export type MediaType = {
-  path?: string;
-  mimetype?: string;
-  filename?: string;
-  dimensions?: { width: number; height: number; ar: number };
-  size?: number;
-  thumbnail?: string;
-  filedata?: string;
-  compress?: boolean;
-};
-
-export type MessageType = Merge<
-  OverrideProperties<
-    TablesInsert<'tbl_chat_messages'>,
-    {
-      message_id: string;
-      org_id: string;
-      org_phone: string;
-      chat_id: string;
-      message_type: (typeof SUPPORTED_TYPES)[number];
-      media: MediaType | null;
-      flag_metadata?: MessageFlagType | null;
-      poll_info?: PollSendType | null;
-      poll_results?: PollResultType | null;
-      delivery_info?: DeliveryInfoType | null;
-      raw_data?: {
-        translations?: Record<string, string>;
-        [key: string]: unknown;
-      } | null;
-    }
-  >,
-  {
-    reactions?: ReactionType[];
-    message_payload?: SingleMessagePayload;
-    highlight?: number;
-    is_private_note?: boolean;
-  }
->;
-
-export type MessageFlagType = {
-  status: boolean;
-  response_type?: 'message' | 'reaction' | 'ticket' | 'manual';
-  response_id?: string;
-  response_timestamp?: string;
-  response_email?: string;
-  flagged_by?: string;
-  flagged_at?: string;
-  response_phone?: string;
-};
-
-export type MessageSendType = {
-  queue_id: string;
-  queue_position: string;
-};
-
-export type MessageBroadcastType = {
-  broadcast_id: string;
-};
-
-/* -------------------------------------------------------------------------- */
-
-export type TicketType = OverrideProperties<
-  Tables<'tbl_chat_tickets'>,
-  {
-    label_ids: { [key: string]: boolean };
-    hubspot_metadata: {
-      id?: string;
-      type?: string;
-      hubId?: string;
-      pipeline: {
-        id: string;
-        label: string;
-      };
-      object_data?: HubspotObjectDataType;
-    } | null;
-    freshdesk_metadata: Record<string, string>;
-    close_ticket_metadata?:
-      | {
-          closed_by: string;
-          closed_at: string;
-          closed_message?: string | null;
-          send_reply_message_id?: string | null;
-        }
-      | any;
-  }
-> & {
-  chat?: ChatType;
-  quoted_message?: MessageType;
-};
-
-export type ContactType = Merge<
-  Tables<'tbl_contacts'>,
-  {
-    chats: ChatType[] | null;
-    chat_ids?: string[];
-  }
->;
-export type ReactionType = Tables<'tbl_chat_reactions'>;
-
-export type NotificationType = Tables<'tbl_chat_notifications'>;
-
-export type ChatAccessType = Merge<
-  TablesUpdate<'tbl_org_members'>,
-  {
-    has_access?: boolean;
-    email: string | null;
-  }
->;
-
-export type QueueJobTypes = {
-  addedTimestamp: number;
-  attemptsMade: number;
-  attemptsStarted: number;
-  data: {
-    body: string;
-    chat_id: string;
-  };
-  finishedTimestamp: number;
-  id: string;
-  message_id: string;
-  processedTimestamp: number;
-  stacktrace: string[];
-  status: string;
-};
-
-export type PhoneQueueStatusType = {
-  active: number;
-  failed: number;
-  completed: number;
-  is_running: boolean;
-  pending: number;
-};
-
-export type PhoneType = OverrideProperties<
-  Tables<'tbl_org_phones'>,
-  {
-    queue_status: {
-      [key: string]: PhoneQueueStatusType;
-    };
-  }
->;
-
-export type PhoneInfoType = Merge<
-  Pick<
-    PhoneType,
-    | 'created_at'
-    | 'first_connected_at'
-    | 'is_ready'
-    | 'label_ids'
-    | 'org_id'
-    | 'org_phone'
-    | 'phone_id'
-    | 'phone_image'
-    | 'phone_name'
-    | 'qr_code'
-    | 'updated_at'
-    | 'wa_state'
-  >,
-  {
-    labels: string[];
-  }
->;
-
-/* -------------------------------- CONSTANTS ------------------------------- */
-
-export const labelColors = [
-  '#9333EA',
-  '#0D9488',
-  '#DB2777',
-  '#2563EB',
-  '#F97316',
-];
-
-export const enumChatColors = [
-  '#B4876E',
-  '#A5B337',
-  '#06CF9C',
-  '#25D366',
-  '#02A698',
-  '#7D9EF1',
-  '#007BFC',
-  '#5E47DE',
-  '#7F66FF',
-  '#9333EA',
-  '#FA6533',
-  '#C4532D',
-  '#DC2626',
-  '#FF2E74',
-  '#DB2777',
-] as const;
-
-export type RepeatDaysType =
-  | 'monday'
-  | 'tuesday'
-  | 'wednesday'
-  | 'thursday'
-  | 'friday'
-  | 'saturday'
-  | 'sunday';
-export type RepeatIntervalType = 'day' | 'week' | 'month';
-
-export enum WhatsappGroupActionEnum {
-  ADD = 'add',
-  REMOVE = 'remove',
-  PROMOTE = 'promote',
-  DEMOTE = 'demote',
-  INVITE = 'invite',
-  LEAVE = 'leave',
-  ANNOUNCE_TRUE = 'announce_true',
-  ANNOUNCE_FALSE = 'announce_false',
-  RESTRICT_TRUE = 'restrict_true',
-  RESTRICT_FALSE = 'restrict_false',
-  MEMBERADDMODE_TRUE = 'memberaddmode_true',
-  MEMBERADDMODE_FALSE = 'memberaddmode_false',
-  SUBJECT = 'subject',
-  DESC = 'desc',
-  CALL = 'call',
-}
-
-/* -------------------------- LISTING ENDPOINT -------------------------- */
-
-type ListingType = {
-  from?: number;
-  to?: number;
-  count?: number;
-};
-
-export type ListNotificationsType = Merge<
-  ListingType,
-  {
-    notifictions?: NotificationType[];
-  }
->;
-
-export type ListChatMessagesType = Merge<
-  ListingType,
-  {
-    messages?: MessageType[];
-  }
->;
-
-export type ListContactsType = Merge<
-  ListingType,
-  {
-    contacts?: ContactType[];
-  }
->;
-
-export type ListTicketsType = Merge<
-  ListingType,
-  {
-    tickets?: TicketType[];
-  }
->;
-
-export type ListChatsType = Merge<
-  ListingType,
-  {
-    chats?: ChatType[];
-  }
->;
-
-/* -------------------------- SEND MESSAGE PAYLOAD -------------------------- */
-
-export const SUPPORTED_TYPES = [
-  'chat',
-  'sticker',
-  'image',
-  'video',
-  'document',
-  'vcard',
-  'multi_vcard',
-  'audio',
-  'ptt',
-  'poll_creation',
-  'location',
-  'ciphertext',
-] as const;
-
-export type SendMessageContent = {
-  message_type?: (typeof SUPPORTED_TYPES)[number];
-  body?: string;
-  media?: MediaType;
-  contact_ids?: string[];
-  location?: {
-    latitude: string;
-    longitude: string;
-    options?: { name?: string; address?: string; url?: string };
-  };
-  poll?: PollSendType;
-  quoted_message_id?: string;
-  quoted_message_type?: 'reply' | 'forward' | 'reply_private';
-  broadcast_id?: string;
-  performed_by?: string;
-  options?: Record<string, any>;
-};
-
-export type QuickReplyContent = Omit<
-  SendMessageContent,
-  'broadcast_id' | 'variables'
->;
-
-export type ScheduleMessagePayload = {
-  scheduled_id?: string;
-  is_repeat?: boolean | null;
-  scheduled_at: string;
-  repeat_config?: {
-    timezone?: string;
-    repeat_ends?: string;
-    repeat_interval?: RepeatIntervalType;
-    repeat_value?: number;
-    repeat_days?: RepeatDaysType[];
-  };
-};
-
-export type BroadcastVariableType = {
-  chat_id: string;
-  values: { [key: string]: string };
-};
-
-export type BroadcastMessagePayload = SendMessageContent & {
-  chat_ids: string[];
-  broadcast_id?: string;
-  variables?: BroadcastVariableType[];
-  delay?: number;
-};
-
-export type SingleMessagePayload = SendMessageContent & {
-  chat_id: string;
-  job_id?: string;
-  priority?: number;
-  scheduled_id?: string;
-};
-
-export type MessageAttachmentFileTypes =
-  | 'image'
-  | 'audio'
-  | 'document'
-  | 'video';
-
-export type AttachmentFileType = {
-  result: string;
-  file: File | null;
-  type: MessageAttachmentFileTypes;
-  localFileURL?: string;
-};
-
-export type AttachmentLinkType = {
-  link: {
-    url: string;
-    type: MessageAttachmentFileTypes;
-    name: string;
-    mimetype?: string;
-  };
-};
-
-export type AttachmentTypeProps = AttachmentFileType | AttachmentLinkType;
-
-/* -------------------------------- BROADCAST ------------------------------- */
-
-export type BroadcastLogType = Tables<'view_broadcast_logs'> & {
-  logs: (Tables<'tbl_broadcast_logs'> & Partial<ChatType>)[];
-} & {
-  chats: ChatType[];
-};
-
-/* ----------------------- CHAT PARTICIPANT OPERATION ----------------------- */
-
-export type ChatLogType = {
-  log: Tables<'view_chat_logs'>;
-  operations: Tables<'tbl_chat_logs'>[];
-};
-export type ChatOperationsType = 'ADD' | 'REMOVE' | 'PROMOTE' | 'DEMOTE';
-
-export type ChatParticipantOperationPayload = {
-  participant_ids: string[];
-  chat_ids: string[];
-  performed_by: string;
-  force_add_participants?: boolean;
-};
-
-export type ChatOperationReturn = {
-  [participant_id: string]: {
-    is_success: boolean;
-    message?: string;
-    code?: number;
-    isInviteV4Sent?: boolean;
-  };
-};
-
-/* ----------------------- BILLING - STRIPE ----------------------- */
-
-export type ChargebeeSubscription = Subscription;
-export type ChargebeeCustomer = Customer;
-export type ChargebeePrice = ItemPrice;
-export type ChargebeeUpcomingInvoice =
-  Estimate.RenewalEstimateResponse['estimate'];
-export type ChargebeeLineItem =
-  HostedPage.CheckoutNewForItemsInputParam['subscription_items'];
-
-/* -------------------------------- REALTIME -------------------------------- */
-
-export type PhoneStateType = {
-  loading: boolean;
-  state: string;
-  sync: number;
-  percent: number | null;
-  message?: string;
-  error?: string;
-};
-
-/* ------------------------------- INTEGRATIONS ----------------------------- */
-
-export type ChatInfoType = Merge<
-  ChatType,
-  {
-    members: {
-      [key: string]: Merge<ChatMemberType, { contact_labels: string }>;
-    } | null;
-    chat_labels: string | null;
-    custom_properties: { [key: string]: string } | null;
-  }
->;
-
-export type TicketInfoType = {
-  chat: ChatInfoType;
-  message: {
-    body: string;
-    chat_id: string;
-    org_phone: string;
-    timestamp: string;
-    media_path: string;
-    message_id: string;
-    sender_name: string;
-    performed_by: string;
-    sender_phone: string;
-  };
-  ticket: {
-    org_id: string;
-    status: string;
-    subject: string;
-    assignee: string;
-    due_date: string;
-    priority: 0 | 1 | 2 | 3 | 4;
-    raised_by: string;
-    ticket_id: string;
-    created_at: string;
-    assigned_by: string;
-    ticket_labels: string;
-    quoted_message_id: string;
-    ticket_custom_properties: { [key: string]: string } | null;
-    closed_at: string;
-    closed_by: string;
-    closed_message: string;
-    first_assigned_at: string | null;
-    is_deleted: boolean;
-  };
-  attached_messages: {
-    body: string;
-    chat_id: string;
-    org_phone: string;
-    timestamp: string;
-    media_path: string;
-    message_id: string;
-    sender_name: string;
-    performed_by: string;
-    sender_phone: string;
-  }[];
-};
-
-export type IntegrationLogObjectType =
-  | 'chat'
-  | 'message'
-  | 'reaction'
-  | 'ticket'
-  | 'phone';
-export enum IntegrationLogType {
-  NEW_CHAT = 'chat.created',
-  NEW_CHAT_NOTIFICATION = 'chat.notification.created',
-  NEW_MESSAGE = 'message.created',
-  MESSAGE_UPDATED = 'message.updated',
-  MESSAGE_DELETED = 'message.deleted',
-  MESSAGE_ACK_UPDATED = 'message.ack.updated',
-  MESSAGE_FLAGGED = 'message.flagged',
-  MESSAGE_UNFLAGGED = 'message.unflagged',
-  MESSAGE_TICKET_ATTACHED = 'message.ticket.attached',
-  REACTION_CREATED = 'reaction.created',
-  REACTION_UPDATED = 'reaction.updated',
-  NEW_TICKET = 'ticket.created',
-  TICKET_UPDATED = 'ticket.updated',
-  TICKET_DELETED = 'ticket.deleted',
-  PHONE_DISCONNECTED = 'org.phone.disconnected',
-  PHONE_CONNECTED = 'org.phone.connected',
-  PHONE_UPDATED = 'org.phone.updated',
-  PHONE_QR_UPDATED = 'org.phone.qr',
-  NOTE_CREATED = 'note.created',
-  CHAT_CUSTOM_PROPERTIES_UPDATED = 'chat.custom_properties.updated',
-}
-
-export type IntegrationLogMetadataType<T extends IntegrationLogType> =
-  T extends IntegrationLogType.NEW_TICKET | IntegrationLogType.TICKET_UPDATED
-    ? TicketInfoType
-    : T extends IntegrationLogType.NEW_CHAT
-      ? Tables<'tbl_chats'>
-      : T extends
-            | IntegrationLogType.NEW_MESSAGE
-            | IntegrationLogType.MESSAGE_UPDATED
-            | IntegrationLogType.MESSAGE_DELETED
-            | IntegrationLogType.MESSAGE_ACK_UPDATED
-            | IntegrationLogType.MESSAGE_FLAGGED
-            | IntegrationLogType.MESSAGE_UNFLAGGED
-            | IntegrationLogType.MESSAGE_TICKET_ATTACHED
-        ? Tables<'tbl_chat_messages'>
-        : T extends
-              | IntegrationLogType.REACTION_CREATED
-              | IntegrationLogType.REACTION_UPDATED
-          ? Tables<'tbl_chat_reactions'>
-          : T extends
-                | IntegrationLogType.PHONE_DISCONNECTED
-                | IntegrationLogType.PHONE_CONNECTED
-                | IntegrationLogType.PHONE_UPDATED
-                | IntegrationLogType.PHONE_QR_UPDATED
-            ? Tables<'tbl_org_phones'>
-            : T extends IntegrationLogType.NOTE_CREATED
-              ? Tables<'tbl_chat_notes'>
-              : {
-                  [key: string]: unknown;
-                };
-
-export type IntegrationLogDetailsType<T extends IntegrationLogType> =
-  OverrideProperties<
-    Tables<'tbl_integration_logs'>,
-    {
-      integration_name: T;
-      metadata: {
-        event: IntegrationLogMetadataType<T> & {
-          event_type: string;
-          org_id: string;
-          previous_attributes: {
-            [key: string]: unknown;
-          };
-        };
-        hook_id: string;
-        name: string;
-      };
-    }
-  >;
-
-export type APIAuthDetails = {
-  org_details: Tables<'view_org'> | null;
-  phone_details: Tables<'tbl_org_phones'> | null;
-  token_details: Tables<'tbl_integration_tokens'> | null;
-};
-
-export type WebhookDataType = OverrideProperties<
-  Tables<'tbl_integration_hooks'>,
-  {
-    integration_name: string[];
-  }
->;
-
-export type HubspotObjectDataType = {
-  createdAt: string;
-  archived: boolean;
-  id: string;
-  type: 'contacts' | 'tickets' | 'companies';
-  properties: Record<
-    string,
-    {
-      groupLabel: string;
-      groupName: string;
-      propertyKeyName: string;
-      propertyKey: string;
-      propertyInternalValue: string;
-      propertyValue: string;
-      propertyType: string;
-      propertyFieldType: string;
-    }[]
-  >;
-};
-
-/* ---------------------------- USER PREFERENCES ---------------------------- */
-
-export type UserPreferences = {
-  theme: 'light' | 'dark';
-  language: 'en' | 'es';
-  left_sidebar_open: boolean;
-  right_sidepanel_open: boolean;
-  sync_wa_unread_count: boolean;
-  pinned_chats: string[];
-  periskope_chat_limit: number;
-  notifications: Record<string, boolean>;
-  mobile_notifications: Record<string, boolean>;
-};
-
-/* ---------------------------- GROUP ANALYTICS SIDEPANEL TYPES---------------------------- */
-
-export interface MostActiveMember {
-  sender_phone: string;
-  total_messages: number;
-}
-
-export interface GroupAnalyticsResult {
-  total_messages: number;
-  total_joins: number;
-  total_leaves: number;
-  total_removes: number;
-  total_reactions: number;
-}
-
-export interface TimeRange {
-  startDateTime: string; // Format: 'YYYY-MM-DD HH:MM:SS.ms+TZ' (e.g., '2025-04-21 06:30:21.24+00')
-  endDateTime: string;
-}
-
-/* ----------------------------- POLL VOTE INFO ----------------------------- */
-
-export type PollSendType = {
-  pollName: string;
-  pollOptions: string[];
-  options?: {
-    allowMultipleAnswers?: boolean;
-    messageSecret?: number[] | null;
-    pollId?: string;
-  };
-};
-
-export type PollResultType = {
-  [name: string]: Record<string, string>;
-};
-
-/* -------------------------- CREATE GROUP OPTIONS -------------------------- */
-
-export type CreateGroupOptions = {
-  messagesAdminsOnly?: boolean;
-  infoAdminsOnly?: boolean;
-  addMembersAdminsOnly?: boolean;
-  image?: string;
-  name?: string;
-  description?: string;
-  initiated_by?: string;
-  admins?: string[];
-  force_add_participants?: boolean;
-};
-
-/* ------------------------------ DELIVERY INFO ----------------------------- */
-
-export type DeliveryInfoType = {
-  delivered: Record<string, number | undefined>;
-  read: Record<string, number | undefined>;
-  pending: string[];
-  read_count: number;
-  delivered_count: number;
-};
-
-/* ---------------------------- CREDITS SYSTEM ---------------------------- */
-
-export type OrgCreditsType = {
-  org_id: string;
-  recurring_allowance: number; // recurring credits replenished every cycle
-  recurring_balance: number; // recurring credits remaining in current cycle
-  topup_balance: number; // topup credits remaining
-  total_credits_used: number; // total credits used in current cycle
-  next_renewal_date: string;
-  topup_credits_used: number; // topup credits used in current cycle
-  recurring_credits_used: number; // recurring credits used in current cycle
-};
-
-/* --------------------------------- RULE INFO TYPE -------------------------------- */
-
-export type ChatRuleInfoType = {
-  chat: Merge<
-    Pick<
-      Tables<'view_chats'>,
-      | 'assigned_to'
-      | 'chat_id'
-      | 'chat_name'
-      | 'chat_type'
-      | 'created_at'
-      | 'group_description'
-      | 'info_admins_only'
-      | 'org_id'
-      | 'org_phone'
-      | 'chat_org_phones'
-      | 'messages_admins_only'
-      | 'custom_properties'
-      | 'initiated_by'
-    >,
-    {
-      has_flagged_messages: boolean;
-      labels: string[];
-      members: string[];
-      custom_properties: { [key: string]: string } | null;
-      assignee_name: string | null;
-    }
-  >;
-};
-
-export type CallNotificationRuleInfoType = {
-  chat: ChatRuleInfoType['chat'];
-  call_notification: Merge<
-    Pick<
-      Tables<'tbl_chat_notifications'>,
-      'notification_id' | 'org_id' | 'chat_id' | 'author' | 'timestamp'
-    >,
-    {
-      isVideo: boolean;
-      isOutgoing: boolean;
-      call_result: 'MISSED' | 'CONNECTED' | 'REJECTED';
-    }
-  >;
-};
-
-export type MemberNotificationRuleInfoType = {
-  chat: ChatRuleInfoType['chat'];
-  member_notification: OverrideProperties<
-    Pick<
-      Tables<'tbl_chat_notifications'>,
-      | 'notification_id'
-      | 'chat_id'
-      | 'timestamp'
-      | 'org_id'
-      | 'org_phone'
-      | 'recipientids'
-      | 'type'
-    >,
-    {
-      recipientids: string;
-    }
-  >;
-};
-
-export type SenderRuleInfoType = Merge<
-  Omit<
-    Merge<Tables<'tbl_contacts'>, Tables<'tbl_chat_participants'>>,
-    | 'verified_name'
-    | 'verified_level'
-    | 'updated_at'
-    | 'short_name'
-    | 'pushname'
-    | 'periskope_name'
-    | 'org_phone'
-    | 'number'
-    | 'name'
-    | 'label_ids'
-    | 'is_wa_contact'
-    | 'is_user'
-    | 'is_my_contact'
-    | 'is_me'
-    | 'is_imported'
-    | 'is_group'
-    | 'is_blocked'
-    | 'contact_color'
-    | 'business_profile'
-    | 'id'
-    | 'contact_image'
-    | 'contact_type'
-    | 'chat_id'
-    | 'is_business'
-    | 'is_enterprise'
-    | 'is_super_admin'
-    | 'contact_lid'
-  >,
-  {
-    is_internal: boolean;
-    labels: string[] | null;
-  }
->;
-
-export type MessageRuleInfoType = {
-  chat: ChatRuleInfoType['chat'];
-  sender: SenderRuleInfoType;
-  message: Merge<
-    OverrideProperties<
-      Omit<
-        Tables<'tbl_chat_messages'>,
-        | 'vcards'
-        | 'updated_at'
-        | 'unique_id'
-        | 'token'
-        | 'to'
-        | 'sent_message_id'
-        | 'raw_data'
-        | 'delivery_info'
-        | 'poll_results'
-        | 'poll_info'
-        | 'order_id'
-        | 'mentioned_ids'
-        | 'media_key'
-        | 'location'
-        | 'links'
-        | 'is_status'
-        | 'is_starred'
-        | 'is_gif'
-        | 'is_forwarded'
-        | 'is_ephemeral'
-        | 'is_deleted'
-        | 'fts'
-        | 'quoted_message_id'
-        | 'invite_v4'
-        | 'id'
-        | 'has_reaction'
-        | 'has_media'
-        | 'duration'
-        | 'broadcast'
-        | 'broadcast_id'
-        | 'device_type'
-        | 'forwarding_score'
-        | 'from'
-        | 'from_me'
-        | 'prev_body'
-        | 'flag_response_time'
-        | 'flag_metadata'
-        | 'ack'
-        | 'interactive'
-        | 'translated_body'
-      >,
-      {
-        media: MediaType | null;
-      }
-    >,
-    {
-      is_last_message: boolean;
-    }
-  >;
-};
-
-export type ReactionRuleInfoType = {
-  chat: MessageRuleInfoType['chat'];
-  sender: MessageRuleInfoType['sender'];
-  message: MessageRuleInfoType['message'];
-  reaction: Pick<
-    Tables<'tbl_chat_reactions'>,
-    'reaction' | 'sender_id' | 'message_id' | 'chat_id' | 'reaction_id'
-  >;
-};
-
-export type TicketRuleInfoType = {
-  chat: MessageRuleInfoType['chat'];
-  sender: MessageRuleInfoType['sender'];
-  ticket: Merge<
-    Pick<
-      Tables<'tbl_chat_tickets'>,
-      | 'org_id'
-      | 'status'
-      | 'chat_id'
-      | 'subject'
-      | 'assignee'
-      | 'due_date'
-      | 'priority'
-      | 'raised_by'
-      | 'ticket_id'
-      | 'created_at'
-      | 'is_deleted'
-    >,
-    {
-      labels: string[] | null;
-      custom_properties: { [key: string]: string } | null;
-    }
-  >;
-  message: MessageRuleInfoType['message'];
-};
-
-export type TaskRuleInfoType<
-  T extends 'ticket' | 'chat' | 'message' | 'todo' = 'todo',
-> = {
-  associated_object_data: T extends 'message'
-    ? MessageRuleInfoType
-    : T extends 'ticket'
-      ? TicketRuleInfoType
-      : T extends 'chat'
-        ? ChatRuleInfoType
-        : null;
-  task: Pick<
-    TaskType,
-    | 'org_id'
-    | 'title'
-    | 'notes'
-    | 'status'
-    | 'assignee'
-    | 'due_date'
-    | 'priority'
-    | 'task_id'
-    | 'created_at'
-  >;
-};
-
-export type FeatureFlagReturnType = Record<string, boolean>;
-
-export type RuleLogsType = OverrideProperties<
-  Tables<'tbl_rules_logs'>,
-  {
-    actions_progress: {
-      action_id: string;
-      action_type: Rule['actions'][number]['type'];
-      action_delay: Rule['actions'][number]['delay'];
-      ran_at: string | null;
-      action_status: 'success' | 'failed' | 'pending';
-      action_response: {
-        success: boolean;
-        data: Record<string, unknown> | null;
-        error: {
-          message: string;
-          name: string;
-          stack?: string;
-          _error?: Error | Record<string, unknown>;
-        } | null;
-      };
-    }[];
-    metadata: {
-      conditions: Rule['conditions'];
-      actions: Rule['actions'];
-      rule_metadata: Pick<
-        Rule,
-        'rule_name' | 'last_updated_at' | 'last_updated_by'
-      >;
-      data: Record<string, unknown>;
-    };
-    conditions_progress: {
-      is_valid: boolean;
-      validation_progress: Record<
-        string,
-        {
-          res: boolean;
-          filter: Filter;
-          value: unknown;
-        }
-      >;
-      checked_at: string | null;
-    };
-  }
->;
-
-/************************** TASKS ***************************/
-
-export type ChatMetadataType = {
-  type: 'chat';
-  index: 'chat_id';
-  id: string;
-  object: Pick<ChatType, 'chat_id' | 'org_phone' | 'org_id'>;
-};
-
-export type MessageMetadataType = {
-  type: 'message';
-  index: 'message_id';
-  id: string;
-  object: Pick<
-    MessageType,
-    | 'message_id'
-    | 'org_phone'
-    | 'chat_id'
-    | 'sender_phone'
-    | 'org_id'
-    | 'is_private_note'
-  >;
-};
-
-export type TicketMetadataType = {
-  type: 'ticket';
-  index: 'ticket_id';
-  id: string;
-  object: Pick<
-    TicketType,
-    'ticket_id' | 'quoted_message_id' | 'chat_id' | 'org_id'
-  >;
-};
-
-export type AssociatedObjectMetadataType<
-  T extends 'chat' | 'message' | 'ticket' | 'todo' =
-    | 'chat'
-    | 'message'
-    | 'ticket'
-    | 'todo',
-> = T extends 'chat'
-  ? ChatMetadataType
-  : T extends 'message'
-    ? MessageMetadataType
-    : T extends 'ticket'
-      ? TicketMetadataType
-      : null;
-
-export const isChatTask = (task: TaskType): task is TaskType<'chat'> =>
-  task.associated_object_metadata?.type === 'chat';
-
-export const isMessageTask = (task: TaskType): task is TaskType<'message'> =>
-  task.associated_object_metadata?.type === 'message';
-
-export const isTicketTask = (task: TaskType): task is TaskType<'ticket'> =>
-  task.associated_object_metadata?.type === 'ticket';
-
-export const isTodoTask = (task: TaskType): task is TaskType<'todo'> =>
-  task.type === 'todo';
-
-export type TaskType<
-  T extends 'chat' | 'message' | 'ticket' | 'todo' =
-    | 'chat'
-    | 'message'
-    | 'ticket'
-    | 'todo',
-> = OverrideProperties<
-  Tables<'tbl_org_tasks'>,
-  {
-    reminder_setting: {
-      remind_in:
-        | `${number} ${'minutes' | 'hours' | 'days'} ${'before' | 'after'}`
-        | string
-        | null;
-      repeat?: {
-        frequency: number;
-        interval: 'days' | 'weeks' | 'months' | 'years';
-        end: 'never' | 'after' | 'on';
-        on?: string;
-      };
-    } | null;
-    associated_object_metadata: AssociatedObjectMetadataType<T>;
-    status: 'open' | 'inprogress' | 'closed';
-    priority: 1 | 2 | 3;
-    completed_metadata?: {
-      completed_at: string;
-      completed_by: string;
-    } | null;
-    type: T;
-  }
->;
-
-type Choice = {
-  id: number;
-  label: string;
-  value: string;
-  position: number;
-};
-
-export type FreshdeskFieldType = {
-  id: number;
-  name: string;
-  type: string;
-  label: string;
-  default: boolean;
-  archived: boolean;
-  position: number;
-  created_at: string;
-  updated_at: string;
-  customers_can_edit: boolean;
-  label_for_customers: string;
-  required_for_agents: boolean;
-  customers_can_filter: boolean;
-  required_for_closure: boolean;
-  displayed_to_customers: boolean;
-  required_for_customers: boolean;
-  choices?: Choice[];
-};
-
-export type OrgWarmup = OverrideProperties<
-  Tables<{ schema: 'internal' }, 'tbl_org_warmup'>,
-  {
-    warmup_chats: { [key: string]: string };
-  }
->;
-
-/** ----------------------------- INTEGRATION TOKENS TYPES ----------------------------- **/
-
-export type FreshdeskIntegrationTokenType = OverrideProperties<
-  Tables<'tbl_integration_tokens'>,
-  {
-    type: 'freshdesk';
-    token_metadata: {
-      url: string;
-      apiKey: string;
-      fields: {
-        ticket: FreshdeskFieldType[];
-        company: FreshdeskFieldType[];
-        contact: FreshdeskFieldType[];
-      };
-      automation: {
-        id: number | string;
-        meta: {
-          total_count: number;
-          total_active_count: 17;
-        };
-        name: string;
-        active: boolean;
-        events: Array<{
-          to?: string;
-          from?: string;
-          field_name: string;
-          value?: string;
-        }>;
-        actions: Array<{
-          url: string;
-          content: Record<string, string>;
-          field_name: string;
-          content_type: string;
-          request_type: string;
-          content_layout: string;
-        }>;
-        summary: {
-          events: Array<string>;
-          actions: Array<string>;
-          performer: string;
-          conditions: {
-            [key: string]: Array<string>;
-          };
-        };
-        outdated: boolean;
-        position: number;
-        performer: {
-          type: string;
-        };
-        conditions: Array<{
-          name: string;
-          match_type: string;
-          properties: Array<{
-            value: Array<string>;
-            operator: string;
-            field_name: string;
-            resource_type: string;
-            case_sensitive: boolean;
-          }>;
-        }>;
-        created_at: string;
-        updated_at: string;
-        description: string | null;
-        last_updated_by: string | number;
-        affected_tickets_count: number | null;
-      };
-      org_details: {
-        address: {
-          city: string;
-          state: string;
-          street: string;
-          country: string;
-          postalcode: string;
-        };
-        timezone: string;
-        bundle_id: string;
-        tier_type: string;
-        account_id: number;
-        cloud_type: string;
-        data_center: string;
-        account_name: string;
-        total_agents: {
-          full_time: number;
-          occasional: number;
-          collaborators: number;
-          field_service: number;
-        };
-        account_domain: string;
-        contact_person: {
-          email: string;
-          lastname: string;
-          firstname: string;
-        };
-        hipaa_compliant: boolean;
-        organisation_id: number;
-        organisation_name: string;
-      };
-      custom_fields: {
-        ticket: FreshdeskFieldType[];
-        company: FreshdeskFieldType[];
-        contact: FreshdeskFieldType[];
-      };
-      integration_org_id: string | number;
-      ticket_auto_creation?: boolean;
-    };
-  }
->;
-
-export type ZohodeskIntegrationTokenType = OverrideProperties<
-  Tables<'tbl_integration_tokens'>,
-  {
-    type: 'zohodesk';
-    token_metadata: {
-      scope: string;
-      domain: string;
-      fields: Array<{
-        id: string;
-        name: string;
-        type: string;
-        apiName: string;
-        toolTip: string;
-        i18NLabel: string;
-        maxLength: number;
-        isMandatory: boolean;
-        toolTipType: string;
-        displayLabel: string;
-        isCustomField: boolean;
-        isEncryptedField: boolean;
-        showToHelpCenter: boolean;
-      }>;
-      org_id: string;
-      webhooks: {
-        id: string;
-        url: string;
-        name: string;
-        type: string;
-        createdBy: string;
-        isEnabled: boolean;
-        createdTime: string;
-        description: string;
-        modifiedTime: string;
-        subscriptions: {
-          [key: string]: {
-            departmentIds: string[];
-            includePrevState: boolean;
-          };
-        };
-        ignoreSourceId: boolean | null;
-        includeEventsFrom: string[];
-      };
-      api_domain: string;
-      authDomain: string;
-      expires_in: number;
-      token_type: string;
-      departments: Array<{
-        id: string;
-        name: string;
-        hasLogo: boolean;
-        creatorId: string;
-        isDefault: boolean;
-        isEnabled: boolean;
-        chatStatus: string;
-        createdTime: string;
-        description: string | null;
-        sanitizedName: string;
-        nameInCustomerPortal: string;
-        isAssignToTeamEnabled: boolean;
-        isVisibleInCustomerPortal: boolean;
-      }>;
-      org_details: {
-        id: number;
-        fax: string;
-        zip: string;
-        city: string;
-        alias: string | null;
-        state: string;
-        mobile: string;
-        street: string;
-        country: string;
-        edition: string;
-        logoURL: string;
-        website: string;
-        isDefault: boolean;
-        portalURL: string;
-        faviconURL: string;
-        portalName: string;
-        companyName: string;
-        description: string | null;
-        phoneNumber: string | null;
-        currencyCode: string;
-        isAdminInOrg: boolean;
-        employeeCount: number;
-        currencyLocale: string;
-        currencySymbol: string;
-        primaryContact: string;
-        isSandboxPortal: boolean;
-        isPayloadEncryptionEnabled: boolean;
-      };
-      access_token: string;
-      refresh_token: string;
-      integration_org_id: string | number;
-      ticket_auto_creation?: boolean;
-    };
-  }
->;
-
-export type ZohoCrmIntegrationTokenType = OverrideProperties<
-  Tables<'tbl_integration_tokens'>,
-  {
-    type: 'zohocrm';
-    token_metadata: {
-      access_token: string;
-      refresh_token: string;
-      scope: string;
-      api_domain: string;
-      token_type: string;
-      expires_in: number;
-      domain_extension: string;
-      authDomain: string;
-      integration_org_id: string;
-      org_scope_id?: string; // zgid from Zoho CRM, used for building record URLs
-      chat_messages_auto_logging?: boolean;
-      auto_create_entity?: 'contact' | 'account' | 'lead' | 'none';
-      bypass_webhook_workflow_creation?: boolean;
-      open_in_crmplus?: boolean;
-      crmplus_portal_name?: string;
-      org_details: {
-        id: string;
-        name: string;
-        currency: string;
-        time_zone: string;
-        currency_symbol: string;
-        currency_locale: string;
-        website: string;
-        description: string | null;
-        phone: string | null;
-        mobile: string | null;
-        fax: string | null;
-        street: string;
-        city: string;
-        state: string;
-        zip: string;
-        country: string;
-        logo_url: string;
-        is_sandbox: boolean;
-        is_admin_in_org: boolean;
-        employee_count: number;
-        primary_contact: string;
-      };
-      fields?: Array<{
-        name: string;
-        label: string;
-        zoho_api_name: string;
-        fieldType: string;
-      }>;
-      modules: Array<{
-        id: string;
-        name: string;
-        api_name: string;
-        singular_label: string;
-        plural_label: string;
-        is_custom: boolean;
-        is_creatable: boolean;
-        is_editable: boolean;
-        is_deletable: boolean;
-        is_webform_supported: boolean;
-        sequence_number: number;
-        fields: Array<{
-          id: string;
-          name: string;
-          api_name: string;
-          data_type: string;
-          required: boolean;
-          is_custom: boolean;
-          is_editable: boolean;
-          is_creatable: boolean;
-          is_webform_supported: boolean;
-          length: number;
-          decimal_places: number | null;
-          default_value: string | null;
-          picklist_values: Array<{
-            display_value: string;
-            actual_value: string;
-          }> | null;
-        }>;
-      }>;
-      webhooks?: {
-        id: string;
-        url: string;
-        name: string;
-        events: string[];
-        is_active: boolean;
-        created_time: string;
-        modified_time: string;
-      };
-    };
-  }
->;
+import {
+  Customer,
+  Estimate,
+  HostedPage,
+  ItemPrice,
+  Subscription,
+} from 'chargebee';
+
+import { Merge, OverrideProperties } from 'type-fest';
+import { Filter, Rule } from './rules.types';
+import { Tables, TablesInsert, TablesUpdate } from './supabase.types';
+
+/* ----------------------------- TYPE SHORTHANDS ---------------------------- */
+
+/* ------------------------------ PERISKOPE TYPES ------------------------------ */
+
+export enum AllPlans {
+  FREE_TRIAL = 'free-trial',
+  // MONTHLY_STARTER = 'monthly-starter',
+  // YEARLY_STARTER = 'yearly-starter',
+  // MONTHLY_PRO = 'monthly-pro',
+  // YEARLY_PRO = 'yearly-pro',
+  ENTERPRISE = 'enterprise',
+  MONTHLY_STARTER_SINGLE = 'monthly-starter-single',
+  YEARLY_STARTER_SINGLE = 'yearly-starter-single',
+  MONTHLY_PRO_SINGLE = 'monthly-pro-single',
+  YEARLY_PRO_SINGLE = 'yearly-pro-single',
+}
+
+export type Frequency = 'yearly' | 'monthly' | 'weekly' | 'custom';
+
+export type Enterprise = `${string}-enterprise`;
+
+export type OrgPlanEnterprise = {
+  subscription_id: string;
+  plan_id: Enterprise;
+  interval: number;
+  frequency: Frequency;
+  user_limit: number;
+  phone_limit: number;
+  current_period_start: number;
+  current_period_end: number | null;
+  additional_user_limit?: number;
+  additional_phone_limit?: number;
+  allocated_user_limit?: number;
+  allocated_phone_limit?: number;
+  currency: string;
+  cancelled_at?: number;
+  cancel_schedule_created_at?: number;
+  subscription_status?: string;
+  discount?: number;
+};
+
+export type OrgPlanNonEnterprise = {
+  subscription_id: string;
+  plan_id: AllPlans;
+  interval: number;
+  frequency: Frequency;
+  user_limit: number;
+  phone_limit: number;
+  current_period_end: number;
+  current_period_start: number;
+  additional_user_limit?: number;
+  additional_phone_limit?: number;
+  allocated_user_limit?: number;
+  allocated_phone_limit?: number;
+  currency: string;
+  cancelled_at?: number;
+  cancel_schedule_created_at?: number;
+  subscription_status?: string;
+  discount?: number;
+};
+
+export type OrgPlan<T extends AllPlans | Enterprise> = T extends Enterprise
+  ? OrgPlanEnterprise
+  : T extends AllPlans
+    ? OrgPlanNonEnterprise
+    : never;
+
+export type MicrosurveyData = {
+  key: string;
+  text: string;
+  checked: boolean;
+}[];
+
+export type OrgPreferences = {
+  disable_allow_exports?: boolean;
+  disable_view_deleted_messages?: boolean;
+  sync_phone_contacts?: boolean;
+  mask_phone_numbers?: boolean;
+  show_sender_names?: boolean;
+  closed_chats?: Record<string, number>;
+  auto_read_muted_chats?: boolean;
+  member_permissions?: Record<string, boolean>;
+  show_active_phone_only_messages_right?: boolean;
+};
+
+type OrgPreferenceKey = keyof OrgPreferences;
+
+export type OrgPreferencesValue = {
+  [K in OrgPreferenceKey]: { key: K; value: OrgPreferences[K] };
+}[OrgPreferenceKey];
+
+export type OrgAISettings = {
+  is_ai_agent_enabled?: boolean;
+  is_ai_training_enabled?: boolean;
+  is_ai_flagging_enabled?: boolean;
+  is_ai_agent_default_on?: boolean;
+  ai_agent_activation_prompt?: string;
+  ai_flag_prompt?: string;
+  ai_nickname?: string;
+  confidence_score?: string;
+  company_overview?: string;
+  ai_responder_roles?: string;
+  human_agent_roles?: string;
+  ticket_creation_rules?: string;
+  private_note_creation_rules?: string;
+  response_delay_value?: string;
+  snooze_delay_value?: string;
+  temperature?: string;
+  top_p?: string;
+  top_k?: string;
+  ai_maintain_flag_status?: boolean;
+  enable_shift_timing?: boolean;
+  shift_start_time?: string;
+  shift_end_time?: string;
+  // New Types
+  is_agent_ticketing_enabled?: boolean;
+  is_agent_private_notes_enabled?: boolean;
+  is_agent_response_enabled?: boolean;
+  ai_archetype?: AgentArchetype;
+  use_new_agent_base_prompt?: boolean;
+  ai_restrictions?: string;
+  agent_company_context?: string;
+  agent_custom_rules?: string;
+  allowed_org_phones?: string[];
+  self_learned_context_needs_approval?: boolean;
+};
+
+type OrgAISettingsKey = keyof OrgAISettings;
+
+export type OrgAISettingsValue = {
+  [K in OrgAISettingsKey]: { key: K; value: OrgAISettings[K] };
+}[OrgAISettingsKey];
+
+export enum AgentArchetype {
+  STRICT_GROUNDED = 'strict_grounded',
+  SPARTAN = 'spartan',
+  FRIENDLY = 'friendly',
+  SALES_FORWARD = 'sales_forward',
+}
+
+export type CustomPropertySectionType = {
+  id: string;
+  name: string;
+  order: number;
+  type: 'chat' | 'ticket';
+  properties_order?: {
+    [id: string]: number;
+  };
+};
+
+export enum CustomPropertyValueType {
+  DROPDOWN = 'dropdown',
+  TEXT = 'text',
+  DATE = 'date',
+  FILE = 'file',
+  PICKLIST = 'picklist',
+  DEPENDENT_DROPDOWN = 'dependent_dropdown',
+}
+
+export type CustomPropertyMetadataType = {
+  section_id?: string;
+};
+
+export type CustomPropertyTextPropertiesType = {
+  property_value_type: CustomPropertyValueType.TEXT;
+  property_value: null;
+  property_metadata: CustomPropertyMetadataType;
+};
+
+export type CustomPropertyDropdownPropertiesType = {
+  property_value_type: CustomPropertyValueType.DROPDOWN;
+  property_value: {
+    [key: string]: string;
+  };
+  property_metadata: CustomPropertyMetadataType;
+};
+
+export type CustomPropertyPicklistPropertiesType = {
+  property_value_type: CustomPropertyValueType.PICKLIST;
+  property_value: {
+    [key: string]: string;
+  };
+  property_metadata: CustomPropertyMetadataType;
+};
+
+export type CustomPropertyDependentDropdownPropertiesType = {
+  property_value_type: CustomPropertyValueType.DEPENDENT_DROPDOWN;
+  property_value: {
+    level_1: {
+      value: string;
+      label: string;
+      level_2: {
+        value: string;
+        label: string;
+        level_3: {
+          value: string;
+          label: string;
+        }[];
+      }[];
+    }[];
+  };
+  property_metadata: Merge<
+    CustomPropertyMetadataType,
+    {
+      level_names: {
+        level_1: string;
+        level_2: string;
+        level_3: string;
+      };
+    }
+  >;
+};
+
+export type CustomPropertyFilePropertiesType = {
+  property_value_type: CustomPropertyValueType.FILE;
+  property_value: null;
+  property_metadata: CustomPropertyMetadataType;
+};
+
+export type CustomPropertyDatePropertiesType = {
+  property_value_type: CustomPropertyValueType.DATE;
+  property_value: null;
+  property_metadata: CustomPropertyMetadataType;
+};
+
+export type CustomPropertyType = OverrideProperties<
+  Tables<'tbl_custom_properties'>,
+  | CustomPropertyDependentDropdownPropertiesType
+  | CustomPropertyTextPropertiesType
+  | CustomPropertyDropdownPropertiesType
+  | CustomPropertyPicklistPropertiesType
+  | CustomPropertyFilePropertiesType
+  | CustomPropertyDatePropertiesType
+>;
+
+export type OrgMetadata = {
+  phone_number: string;
+  ticket_prefix: string;
+  referralSource?: string;
+  contact_name?: string;
+  surveyData?: MicrosurveyData;
+  preferences?: OrgPreferences;
+  partition?: boolean;
+  hubspot_company_id?: string;
+  tickets: {
+    prefix?: string;
+    emoji_ticketing: {
+      is_enabled?: boolean;
+      is_message_enabled?: boolean;
+      message_template?: string;
+    };
+    disable_auto_attach_message_to_ticket?: boolean;
+  };
+  attribution?: Object;
+  affiliate_id?: string;
+  custom_properties?: {
+    sections?: CustomPropertySectionType[];
+  };
+  rules?: {
+    limit?: number;
+  };
+  display_language?: string;
+  auto_translate_messages?: boolean;
+  custom_invite?: {
+    is_enabled: boolean;
+    template: string;
+  };
+};
+
+export type GroupTemplateType = OverrideProperties<
+  Tables<'tbl_group_templates'>,
+  {
+    group_metadata: {
+      messagesAdminsOnly?: boolean;
+      infoAdminsOnly?: boolean;
+      addMembersAdminsOnly?: boolean;
+      description?: string;
+      admins?: string[];
+    };
+  }
+>;
+
+type AccessScopes = {
+  feature_flags: Record<string, boolean>;
+  integrations: boolean;
+  rules: boolean;
+  exports: boolean;
+};
+
+export type OrgMembersType = OverrideProperties<
+  Tables<'tbl_org_members'>,
+  {
+    member_metadata: {
+      shift_times: {
+        [day in
+          | 'monday'
+          | 'tuesday'
+          | 'wednesday'
+          | 'thursday'
+          | 'friday'
+          | 'saturday'
+          | 'sunday']?: [[string, string]];
+      };
+      override_status: boolean;
+      [key: string]: any;
+    };
+  }
+>;
+
+export type OrgType = OverrideProperties<
+  Merge<
+    Tables<'tbl_org'>,
+    {
+      user: OrgMembersType;
+      members: OrgMembersType[];
+      phones: Tables<'tbl_org_phones'>[];
+      labels: Tables<'tbl_org_labels'>[];
+      quick_replies: Tables<'tbl_quick_replies'>[];
+      custom_properties: CustomPropertyType[];
+      subscription_status: 'active' | 'inactive' | 'unpaid';
+      is_enterprise: boolean;
+      is_free_trial: boolean;
+      is_hubspot_connected: boolean;
+      is_freshdesk_connected: boolean;
+      is_zohodesk_connected: boolean;
+      is_zohocrm_connected: boolean;
+      access_scopes: AccessScopes;
+      rules: Rule[];
+      phone_limit: number;
+      user_limit: number;
+      allocated_user_limit: number;
+      allocated_phone_limit: number;
+      additional_user_limit: number;
+      additional_phone_limit: number;
+      hubspot_tokens: Tables<'tbl_integration_tokens'> | null;
+    }
+  >,
+  {
+    org_plan: OrgPlan<AllPlans | Enterprise>;
+    stripe_customer_details: Customer | null;
+    stripe_subscription_details: Array<Subscription> | null;
+    stripe_customer_id: Customer['id'] | null;
+    org_metadata: OrgMetadata;
+    ai_settings: OrgAISettings;
+  }
+>;
+
+export type ChatMemberType = Merge<
+  Tables<'tbl_chat_participants'>,
+  Tables<'tbl_contacts'>
+>;
+
+export type ChatType = Merge<
+  Tables<'view_chats'>,
+  {
+    chat_id: string;
+    latest_message: MessageType | null;
+    latest_message_timestamp: number | null;
+    latest_message_timestamp_map?: Record<string, number | null>;
+    members: { [key: string]: ChatMemberType } | null;
+    chat_type: 'user' | 'group' | 'business' | 'unknown';
+    chat_access: { [key: string]: boolean };
+    label_ids: { [key: string]: boolean };
+    chat_org_phones?: string[];
+    message_unread_count: number | null;
+    hubspot_metadata: {
+      id: string;
+      type: string;
+      hubId: string;
+      object_data: HubspotObjectDataType;
+    } | null;
+    info_admins_only: boolean;
+    messages_admins_only: boolean;
+    unread_count?: { [key: string]: number };
+    active_phone: string | null;
+    flag_count_map?: { [key: string]: number };
+    is_archived?: boolean;
+    is_pinned?: boolean;
+    closed_at?: number | null;
+    common_chats?: string[];
+    freshdesk_metadata?: Record<string, any>;
+    zohodesk_metadata?: Record<string, any>;
+    zohocrm_metadata?: Record<string, any>;
+    pinned_messages?: {
+      message_id: string;
+      pinned_at: number;
+      expires_at: number;
+    }[];
+    group_metadata?: Record<string, any>;
+    snooze_metadata?: {
+      snooze_until: number;
+      snooze_message?: string;
+      snooze_by?: string;
+    };
+    member_unread_count?: {
+      [key: string]: number;
+    };
+    member_closed_at?: {
+      [key: string]: number;
+    };
+    ai_metadata: ChatAIMetadataType;
+    tickets?: TicketType[];
+    tasks?: TaskType[];
+  }
+>;
+
+export type ChatPropertiesType = Merge<
+  Tables<'tbl_chat_properties'>,
+  { ai_metadata: ChatAIMetadataType }
+>;
+
+export type ChatAIMetadataType = {
+  is_active: boolean;
+  snooze_until: string;
+  activation_state: 'active' | 'inactive' | 'snoozed' | 'thinking';
+  is_agent_allowed: boolean;
+  is_flagging_allowed: boolean;
+} | null;
+
+/* -------------------------------------------------------------------------- */
+/*                                   MESSAGE                                  */
+/* -------------------------------------------------------------------------- */
+
+export type MediaType = {
+  path?: string;
+  mimetype?: string;
+  filename?: string;
+  dimensions?: { width: number; height: number; ar: number };
+  size?: number;
+  thumbnail?: string;
+  filedata?: string;
+  compress?: boolean;
+};
+
+export type MessageType = Merge<
+  OverrideProperties<
+    TablesInsert<'tbl_chat_messages'>,
+    {
+      message_id: string;
+      org_id: string;
+      org_phone: string;
+      chat_id: string;
+      message_type: (typeof SUPPORTED_TYPES)[number];
+      media: MediaType | null;
+      flag_metadata?: MessageFlagType | null;
+      poll_info?: PollSendType | null;
+      poll_results?: PollResultType | null;
+      delivery_info?: DeliveryInfoType | null;
+      raw_data?: {
+        translations?: Record<string, string>;
+        [key: string]: unknown;
+      } | null;
+    }
+  >,
+  {
+    reactions?: ReactionType[];
+    message_payload?: SingleMessagePayload;
+    highlight?: number;
+    is_private_note?: boolean;
+  }
+>;
+
+export type MessageFlagType = {
+  status: boolean;
+  response_type?: 'message' | 'reaction' | 'ticket' | 'manual';
+  response_id?: string;
+  response_timestamp?: string;
+  response_email?: string;
+  flagged_by?: string;
+  flagged_at?: string;
+  response_phone?: string;
+};
+
+export type MessageSendType = {
+  queue_id: string;
+  queue_position: string;
+};
+
+export type MessageBroadcastType = {
+  broadcast_id: string;
+};
+
+/* -------------------------------------------------------------------------- */
+
+export type TicketType = OverrideProperties<
+  Tables<'tbl_chat_tickets'>,
+  {
+    label_ids: { [key: string]: boolean };
+    hubspot_metadata: {
+      id?: string;
+      type?: string;
+      hubId?: string;
+      pipeline: {
+        id: string;
+        label: string;
+      };
+      object_data?: HubspotObjectDataType;
+    } | null;
+    freshdesk_metadata: Record<string, string>;
+    close_ticket_metadata?:
+      | {
+          closed_by: string;
+          closed_at: string;
+          closed_message?: string | null;
+          send_reply_message_id?: string | null;
+        }
+      | any;
+  }
+> & {
+  chat?: ChatType;
+  quoted_message?: MessageType;
+};
+
+export type ContactType = Merge<
+  Tables<'tbl_contacts'>,
+  {
+    chats: ChatType[] | null;
+    chat_ids?: string[];
+  }
+>;
+export type ReactionType = Tables<'tbl_chat_reactions'>;
+
+export type NotificationType = Tables<'tbl_chat_notifications'>;
+
+export type ChatAccessType = Merge<
+  TablesUpdate<'tbl_org_members'>,
+  {
+    has_access?: boolean;
+    email: string | null;
+  }
+>;
+
+export type QueueJobTypes = {
+  addedTimestamp: number;
+  attemptsMade: number;
+  attemptsStarted: number;
+  data: {
+    body: string;
+    chat_id: string;
+  };
+  finishedTimestamp: number;
+  id: string;
+  message_id: string;
+  processedTimestamp: number;
+  stacktrace: string[];
+  status: string;
+};
+
+export type PhoneQueueStatusType = {
+  active: number;
+  failed: number;
+  completed: number;
+  is_running: boolean;
+  pending: number;
+};
+
+export type PhoneType = OverrideProperties<
+  Tables<'tbl_org_phones'>,
+  {
+    queue_status: {
+      [key: string]: PhoneQueueStatusType;
+    };
+  }
+>;
+
+export type PhoneInfoType = Merge<
+  Pick<
+    PhoneType,
+    | 'created_at'
+    | 'first_connected_at'
+    | 'is_ready'
+    | 'label_ids'
+    | 'org_id'
+    | 'org_phone'
+    | 'phone_id'
+    | 'phone_image'
+    | 'phone_name'
+    | 'qr_code'
+    | 'updated_at'
+    | 'wa_state'
+  >,
+  {
+    labels: string[];
+  }
+>;
+
+/* -------------------------------- CONSTANTS ------------------------------- */
+
+export const labelColors = [
+  '#9333EA',
+  '#0D9488',
+  '#DB2777',
+  '#2563EB',
+  '#F97316',
+];
+
+export const enumChatColors = [
+  '#B4876E',
+  '#A5B337',
+  '#06CF9C',
+  '#25D366',
+  '#02A698',
+  '#7D9EF1',
+  '#007BFC',
+  '#5E47DE',
+  '#7F66FF',
+  '#9333EA',
+  '#FA6533',
+  '#C4532D',
+  '#DC2626',
+  '#FF2E74',
+  '#DB2777',
+] as const;
+
+export type RepeatDaysType =
+  | 'monday'
+  | 'tuesday'
+  | 'wednesday'
+  | 'thursday'
+  | 'friday'
+  | 'saturday'
+  | 'sunday';
+export type RepeatIntervalType = 'day' | 'week' | 'month';
+
+export enum WhatsappGroupActionEnum {
+  ADD = 'add',
+  REMOVE = 'remove',
+  PROMOTE = 'promote',
+  DEMOTE = 'demote',
+  INVITE = 'invite',
+  LEAVE = 'leave',
+  ANNOUNCE_TRUE = 'announce_true',
+  ANNOUNCE_FALSE = 'announce_false',
+  RESTRICT_TRUE = 'restrict_true',
+  RESTRICT_FALSE = 'restrict_false',
+  MEMBERADDMODE_TRUE = 'memberaddmode_true',
+  MEMBERADDMODE_FALSE = 'memberaddmode_false',
+  SUBJECT = 'subject',
+  DESC = 'desc',
+  CALL = 'call',
+}
+
+/* -------------------------- LISTING ENDPOINT -------------------------- */
+
+type ListingType = {
+  from?: number;
+  to?: number;
+  count?: number;
+};
+
+export type ListNotificationsType = Merge<
+  ListingType,
+  {
+    notifictions?: NotificationType[];
+  }
+>;
+
+export type ListChatMessagesType = Merge<
+  ListingType,
+  {
+    messages?: MessageType[];
+  }
+>;
+
+export type ListContactsType = Merge<
+  ListingType,
+  {
+    contacts?: ContactType[];
+  }
+>;
+
+export type ListTicketsType = Merge<
+  ListingType,
+  {
+    tickets?: TicketType[];
+  }
+>;
+
+export type ListChatsType = Merge<
+  ListingType,
+  {
+    chats?: ChatType[];
+  }
+>;
+
+/* -------------------------- SEND MESSAGE PAYLOAD -------------------------- */
+
+export const SUPPORTED_TYPES = [
+  'chat',
+  'sticker',
+  'image',
+  'video',
+  'document',
+  'vcard',
+  'multi_vcard',
+  'audio',
+  'ptt',
+  'poll_creation',
+  'location',
+  'ciphertext',
+] as const;
+
+export type SendMessageContent = {
+  message_type?: (typeof SUPPORTED_TYPES)[number];
+  body?: string;
+  media?: MediaType;
+  contact_ids?: string[];
+  location?: {
+    latitude: string;
+    longitude: string;
+    options?: { name?: string; address?: string; url?: string };
+  };
+  poll?: PollSendType;
+  quoted_message_id?: string;
+  quoted_message_type?: 'reply' | 'forward' | 'reply_private';
+  broadcast_id?: string;
+  performed_by?: string;
+  options?: Record<string, any>;
+};
+
+export type QuickReplyContent = Omit<
+  SendMessageContent,
+  'broadcast_id' | 'variables'
+>;
+
+export type ScheduleMessagePayload = {
+  scheduled_id?: string;
+  is_repeat?: boolean | null;
+  scheduled_at: string;
+  repeat_config?: {
+    timezone?: string;
+    repeat_ends?: string;
+    repeat_interval?: RepeatIntervalType;
+    repeat_value?: number;
+    repeat_days?: RepeatDaysType[];
+  };
+};
+
+export type BroadcastVariableType = {
+  chat_id: string;
+  values: { [key: string]: string };
+};
+
+export type BroadcastMessagePayload = SendMessageContent & {
+  chat_ids: string[];
+  broadcast_id?: string;
+  variables?: BroadcastVariableType[];
+  delay?: number;
+};
+
+export type SingleMessagePayload = SendMessageContent & {
+  chat_id: string;
+  job_id?: string;
+  priority?: number;
+  scheduled_id?: string;
+};
+
+export type MessageAttachmentFileTypes =
+  | 'image'
+  | 'audio'
+  | 'document'
+  | 'video';
+
+export type AttachmentFileType = {
+  result: string;
+  file: File | null;
+  type: MessageAttachmentFileTypes;
+  localFileURL?: string;
+};
+
+export type AttachmentLinkType = {
+  link: {
+    url: string;
+    type: MessageAttachmentFileTypes;
+    name: string;
+    mimetype?: string;
+  };
+};
+
+export type AttachmentTypeProps = AttachmentFileType | AttachmentLinkType;
+
+/* -------------------------------- BROADCAST ------------------------------- */
+
+export type BroadcastLogType = Tables<'view_broadcast_logs'> & {
+  logs: (Tables<'tbl_broadcast_logs'> & Partial<ChatType>)[];
+} & {
+  chats: ChatType[];
+};
+
+/* ----------------------- CHAT PARTICIPANT OPERATION ----------------------- */
+
+export type ChatLogType = {
+  log: Tables<'view_chat_logs'>;
+  operations: Tables<'tbl_chat_logs'>[];
+};
+export type ChatOperationsType = 'ADD' | 'REMOVE' | 'PROMOTE' | 'DEMOTE';
+
+export type ChatParticipantOperationPayload = {
+  participant_ids: string[];
+  chat_ids: string[];
+  performed_by: string;
+  force_add_participants?: boolean;
+};
+
+export type ChatOperationReturn = {
+  [participant_id: string]: {
+    is_success: boolean;
+    message?: string;
+    code?: number;
+    isInviteV4Sent?: boolean;
+  };
+};
+
+/* ----------------------- BILLING - STRIPE ----------------------- */
+
+export type ChargebeeSubscription = Subscription;
+export type ChargebeeCustomer = Customer;
+export type ChargebeePrice = ItemPrice;
+export type ChargebeeUpcomingInvoice =
+  Estimate.RenewalEstimateResponse['estimate'];
+export type ChargebeeLineItem =
+  HostedPage.CheckoutNewForItemsInputParam['subscription_items'];
+
+/* -------------------------------- REALTIME -------------------------------- */
+
+export type PhoneStateType = {
+  loading: boolean;
+  state: string;
+  sync: number;
+  percent: number | null;
+  message?: string;
+  error?: string;
+};
+
+/* ------------------------------- INTEGRATIONS ----------------------------- */
+
+export type ChatInfoType = Merge<
+  ChatType,
+  {
+    members: {
+      [key: string]: Merge<ChatMemberType, { contact_labels: string }>;
+    } | null;
+    chat_labels: string | null;
+    custom_properties: { [key: string]: string } | null;
+  }
+>;
+
+export type TicketInfoType = {
+  chat: ChatInfoType;
+  message: {
+    body: string;
+    chat_id: string;
+    org_phone: string;
+    timestamp: string;
+    media_path: string;
+    message_id: string;
+    sender_name: string;
+    performed_by: string;
+    sender_phone: string;
+  };
+  ticket: {
+    org_id: string;
+    status: string;
+    subject: string;
+    assignee: string;
+    due_date: string;
+    priority: 0 | 1 | 2 | 3 | 4;
+    raised_by: string;
+    ticket_id: string;
+    created_at: string;
+    assigned_by: string;
+    ticket_labels: string;
+    quoted_message_id: string;
+    ticket_custom_properties: { [key: string]: string } | null;
+    closed_at: string;
+    closed_by: string;
+    closed_message: string;
+    first_assigned_at: string | null;
+    is_deleted: boolean;
+  };
+  attached_messages: {
+    body: string;
+    chat_id: string;
+    org_phone: string;
+    timestamp: string;
+    media_path: string;
+    message_id: string;
+    sender_name: string;
+    performed_by: string;
+    sender_phone: string;
+  }[];
+};
+
+export type IntegrationLogObjectType =
+  | 'chat'
+  | 'message'
+  | 'reaction'
+  | 'ticket'
+  | 'phone';
+export enum IntegrationLogType {
+  NEW_CHAT = 'chat.created',
+  NEW_CHAT_NOTIFICATION = 'chat.notification.created',
+  NEW_MESSAGE = 'message.created',
+  MESSAGE_UPDATED = 'message.updated',
+  MESSAGE_DELETED = 'message.deleted',
+  MESSAGE_ACK_UPDATED = 'message.ack.updated',
+  MESSAGE_FLAGGED = 'message.flagged',
+  MESSAGE_UNFLAGGED = 'message.unflagged',
+  MESSAGE_TICKET_ATTACHED = 'message.ticket.attached',
+  REACTION_CREATED = 'reaction.created',
+  REACTION_UPDATED = 'reaction.updated',
+  NEW_TICKET = 'ticket.created',
+  TICKET_UPDATED = 'ticket.updated',
+  TICKET_DELETED = 'ticket.deleted',
+  PHONE_DISCONNECTED = 'org.phone.disconnected',
+  PHONE_CONNECTED = 'org.phone.connected',
+  PHONE_UPDATED = 'org.phone.updated',
+  PHONE_QR_UPDATED = 'org.phone.qr',
+  NOTE_CREATED = 'note.created',
+  CHAT_CUSTOM_PROPERTIES_UPDATED = 'chat.custom_properties.updated',
+}
+
+export type IntegrationLogMetadataType<T extends IntegrationLogType> =
+  T extends IntegrationLogType.NEW_TICKET | IntegrationLogType.TICKET_UPDATED
+    ? TicketInfoType
+    : T extends IntegrationLogType.NEW_CHAT
+      ? Tables<'tbl_chats'>
+      : T extends
+            | IntegrationLogType.NEW_MESSAGE
+            | IntegrationLogType.MESSAGE_UPDATED
+            | IntegrationLogType.MESSAGE_DELETED
+            | IntegrationLogType.MESSAGE_ACK_UPDATED
+            | IntegrationLogType.MESSAGE_FLAGGED
+            | IntegrationLogType.MESSAGE_UNFLAGGED
+            | IntegrationLogType.MESSAGE_TICKET_ATTACHED
+        ? Tables<'tbl_chat_messages'>
+        : T extends
+              | IntegrationLogType.REACTION_CREATED
+              | IntegrationLogType.REACTION_UPDATED
+          ? Tables<'tbl_chat_reactions'>
+          : T extends
+                | IntegrationLogType.PHONE_DISCONNECTED
+                | IntegrationLogType.PHONE_CONNECTED
+                | IntegrationLogType.PHONE_UPDATED
+                | IntegrationLogType.PHONE_QR_UPDATED
+            ? Tables<'tbl_org_phones'>
+            : T extends IntegrationLogType.NOTE_CREATED
+              ? Tables<'tbl_chat_notes'>
+              : {
+                  [key: string]: unknown;
+                };
+
+export type IntegrationLogDetailsType<T extends IntegrationLogType> =
+  OverrideProperties<
+    Tables<'tbl_integration_logs'>,
+    {
+      integration_name: T;
+      metadata: {
+        event: IntegrationLogMetadataType<T> & {
+          event_type: string;
+          org_id: string;
+          previous_attributes: {
+            [key: string]: unknown;
+          };
+        };
+        hook_id: string;
+        name: string;
+      };
+    }
+  >;
+
+export type APIAuthDetails = {
+  org_details: Tables<'view_org'> | null;
+  phone_details: Tables<'tbl_org_phones'> | null;
+  token_details: Tables<'tbl_integration_tokens'> | null;
+};
+
+export type WebhookDataType = OverrideProperties<
+  Tables<'tbl_integration_hooks'>,
+  {
+    integration_name: string[];
+  }
+>;
+
+export type HubspotObjectDataType = {
+  createdAt: string;
+  archived: boolean;
+  id: string;
+  type: 'contacts' | 'tickets' | 'companies';
+  properties: Record<
+    string,
+    {
+      groupLabel: string;
+      groupName: string;
+      propertyKeyName: string;
+      propertyKey: string;
+      propertyInternalValue: string;
+      propertyValue: string;
+      propertyType: string;
+      propertyFieldType: string;
+    }[]
+  >;
+};
+
+/* ---------------------------- USER PREFERENCES ---------------------------- */
+
+export type UserPreferences = {
+  theme: 'light' | 'dark';
+  language: 'en' | 'es';
+  left_sidebar_open: boolean;
+  right_sidepanel_open: boolean;
+  sync_wa_unread_count: boolean;
+  pinned_chats: string[];
+  periskope_chat_limit: number;
+  notifications: Record<string, boolean>;
+  mobile_notifications: Record<string, boolean>;
+};
+
+/* ---------------------------- GROUP ANALYTICS SIDEPANEL TYPES---------------------------- */
+
+export interface MostActiveMember {
+  sender_phone: string;
+  total_messages: number;
+}
+
+export interface GroupAnalyticsResult {
+  total_messages: number;
+  total_joins: number;
+  total_leaves: number;
+  total_removes: number;
+  total_reactions: number;
+}
+
+export interface TimeRange {
+  startDateTime: string; // Format: 'YYYY-MM-DD HH:MM:SS.ms+TZ' (e.g., '2025-04-21 06:30:21.24+00')
+  endDateTime: string;
+}
+
+/* ----------------------------- POLL VOTE INFO ----------------------------- */
+
+export type PollSendType = {
+  pollName: string;
+  pollOptions: string[];
+  options?: {
+    allowMultipleAnswers?: boolean;
+    messageSecret?: number[] | null;
+    pollId?: string;
+  };
+};
+
+export type PollResultType = {
+  [name: string]: Record<string, string>;
+};
+
+/* -------------------------- CREATE GROUP OPTIONS -------------------------- */
+
+export type CreateGroupOptions = {
+  messagesAdminsOnly?: boolean;
+  infoAdminsOnly?: boolean;
+  addMembersAdminsOnly?: boolean;
+  image?: string;
+  name?: string;
+  description?: string;
+  initiated_by?: string;
+  admins?: string[];
+  force_add_participants?: boolean;
+};
+
+/* ------------------------------ DELIVERY INFO ----------------------------- */
+
+export type DeliveryInfoType = {
+  delivered: Record<string, number | undefined>;
+  read: Record<string, number | undefined>;
+  pending: string[];
+  read_count: number;
+  delivered_count: number;
+};
+
+/* ---------------------------- CREDITS SYSTEM ---------------------------- */
+
+export type OrgCreditsType = {
+  org_id: string;
+  recurring_allowance: number; // recurring credits replenished every cycle
+  recurring_balance: number; // recurring credits remaining in current cycle
+  topup_balance: number; // topup credits remaining
+  total_credits_used: number; // total credits used in current cycle
+  next_renewal_date: string;
+  topup_credits_used: number; // topup credits used in current cycle
+  recurring_credits_used: number; // recurring credits used in current cycle
+};
+
+/* --------------------------------- RULE INFO TYPE -------------------------------- */
+
+export type ChatRuleInfoType = {
+  chat: Merge<
+    Pick<
+      Tables<'view_chats'>,
+      | 'assigned_to'
+      | 'chat_id'
+      | 'chat_name'
+      | 'chat_type'
+      | 'created_at'
+      | 'group_description'
+      | 'info_admins_only'
+      | 'org_id'
+      | 'org_phone'
+      | 'chat_org_phones'
+      | 'messages_admins_only'
+      | 'custom_properties'
+      | 'initiated_by'
+    >,
+    {
+      has_flagged_messages: boolean;
+      labels: string[];
+      members: string[];
+      custom_properties: { [key: string]: string } | null;
+      assignee_name: string | null;
+    }
+  >;
+};
+
+export type CallNotificationRuleInfoType = {
+  chat: ChatRuleInfoType['chat'];
+  call_notification: Merge<
+    Pick<
+      Tables<'tbl_chat_notifications'>,
+      'notification_id' | 'org_id' | 'chat_id' | 'author' | 'timestamp'
+    >,
+    {
+      isVideo: boolean;
+      isOutgoing: boolean;
+      call_result: 'MISSED' | 'CONNECTED' | 'REJECTED';
+    }
+  >;
+};
+
+export type MemberNotificationRuleInfoType = {
+  chat: ChatRuleInfoType['chat'];
+  member_notification: OverrideProperties<
+    Pick<
+      Tables<'tbl_chat_notifications'>,
+      | 'notification_id'
+      | 'chat_id'
+      | 'timestamp'
+      | 'org_id'
+      | 'org_phone'
+      | 'recipientids'
+      | 'type'
+    >,
+    {
+      recipientids: string;
+    }
+  >;
+};
+
+export type SenderRuleInfoType = Merge<
+  Omit<
+    Merge<Tables<'tbl_contacts'>, Tables<'tbl_chat_participants'>>,
+    | 'verified_name'
+    | 'verified_level'
+    | 'updated_at'
+    | 'short_name'
+    | 'pushname'
+    | 'periskope_name'
+    | 'org_phone'
+    | 'number'
+    | 'name'
+    | 'label_ids'
+    | 'is_wa_contact'
+    | 'is_user'
+    | 'is_my_contact'
+    | 'is_me'
+    | 'is_imported'
+    | 'is_group'
+    | 'is_blocked'
+    | 'contact_color'
+    | 'business_profile'
+    | 'id'
+    | 'contact_image'
+    | 'contact_type'
+    | 'chat_id'
+    | 'is_business'
+    | 'is_enterprise'
+    | 'is_super_admin'
+    | 'contact_lid'
+  >,
+  {
+    is_internal: boolean;
+    labels: string[] | null;
+  }
+>;
+
+export type MessageRuleInfoType = {
+  chat: ChatRuleInfoType['chat'];
+  sender: SenderRuleInfoType;
+  message: Merge<
+    OverrideProperties<
+      Omit<
+        Tables<'tbl_chat_messages'>,
+        | 'vcards'
+        | 'updated_at'
+        | 'unique_id'
+        | 'token'
+        | 'to'
+        | 'sent_message_id'
+        | 'raw_data'
+        | 'delivery_info'
+        | 'poll_results'
+        | 'poll_info'
+        | 'order_id'
+        | 'mentioned_ids'
+        | 'media_key'
+        | 'location'
+        | 'links'
+        | 'is_status'
+        | 'is_starred'
+        | 'is_gif'
+        | 'is_forwarded'
+        | 'is_ephemeral'
+        | 'is_deleted'
+        | 'fts'
+        | 'quoted_message_id'
+        | 'invite_v4'
+        | 'id'
+        | 'has_reaction'
+        | 'has_media'
+        | 'duration'
+        | 'broadcast'
+        | 'broadcast_id'
+        | 'device_type'
+        | 'forwarding_score'
+        | 'from'
+        | 'from_me'
+        | 'prev_body'
+        | 'flag_response_time'
+        | 'flag_metadata'
+        | 'ack'
+        | 'interactive'
+        | 'translated_body'
+      >,
+      {
+        media: MediaType | null;
+      }
+    >,
+    {
+      is_last_message: boolean;
+    }
+  >;
+};
+
+export type ReactionRuleInfoType = {
+  chat: MessageRuleInfoType['chat'];
+  sender: MessageRuleInfoType['sender'];
+  message: MessageRuleInfoType['message'];
+  reaction: Pick<
+    Tables<'tbl_chat_reactions'>,
+    'reaction' | 'sender_id' | 'message_id' | 'chat_id' | 'reaction_id'
+  >;
+};
+
+export type TicketRuleInfoType = {
+  chat: MessageRuleInfoType['chat'];
+  sender: MessageRuleInfoType['sender'];
+  ticket: Merge<
+    Pick<
+      Tables<'tbl_chat_tickets'>,
+      | 'org_id'
+      | 'status'
+      | 'chat_id'
+      | 'subject'
+      | 'assignee'
+      | 'due_date'
+      | 'priority'
+      | 'raised_by'
+      | 'ticket_id'
+      | 'created_at'
+      | 'is_deleted'
+    >,
+    {
+      labels: string[] | null;
+      custom_properties: { [key: string]: string } | null;
+    }
+  >;
+  message: MessageRuleInfoType['message'];
+};
+
+export type TaskRuleInfoType<
+  T extends 'ticket' | 'chat' | 'message' | 'todo' = 'todo',
+> = {
+  associated_object_data: T extends 'message'
+    ? MessageRuleInfoType
+    : T extends 'ticket'
+      ? TicketRuleInfoType
+      : T extends 'chat'
+        ? ChatRuleInfoType
+        : null;
+  task: Pick<
+    TaskType,
+    | 'org_id'
+    | 'title'
+    | 'notes'
+    | 'status'
+    | 'assignee'
+    | 'due_date'
+    | 'priority'
+    | 'task_id'
+    | 'created_at'
+  >;
+};
+
+export type FeatureFlagReturnType = Record<string, boolean>;
+
+export type RuleLogsType = OverrideProperties<
+  Tables<'tbl_rules_logs'>,
+  {
+    actions_progress: {
+      action_id: string;
+      action_type: Rule['actions'][number]['type'];
+      action_delay: Rule['actions'][number]['delay'];
+      ran_at: string | null;
+      action_status: 'success' | 'failed' | 'pending';
+      action_response: {
+        success: boolean;
+        data: Record<string, unknown> | null;
+        error: {
+          message: string;
+          name: string;
+          stack?: string;
+          _error?: Error | Record<string, unknown>;
+        } | null;
+      };
+    }[];
+    metadata: {
+      conditions: Rule['conditions'];
+      actions: Rule['actions'];
+      rule_metadata: Pick<
+        Rule,
+        'rule_name' | 'last_updated_at' | 'last_updated_by'
+      >;
+      data: Record<string, unknown>;
+    };
+    conditions_progress: {
+      is_valid: boolean;
+      validation_progress: Record<
+        string,
+        {
+          res: boolean;
+          filter: Filter;
+          value: unknown;
+        }
+      >;
+      checked_at: string | null;
+    };
+  }
+>;
+
+/************************** TASKS ***************************/
+
+export type ChatMetadataType = {
+  type: 'chat';
+  index: 'chat_id';
+  id: string;
+  object: Pick<ChatType, 'chat_id' | 'org_phone' | 'org_id'>;
+};
+
+export type MessageMetadataType = {
+  type: 'message';
+  index: 'message_id';
+  id: string;
+  object: Pick<
+    MessageType,
+    | 'message_id'
+    | 'org_phone'
+    | 'chat_id'
+    | 'sender_phone'
+    | 'org_id'
+    | 'is_private_note'
+  >;
+};
+
+export type TicketMetadataType = {
+  type: 'ticket';
+  index: 'ticket_id';
+  id: string;
+  object: Pick<
+    TicketType,
+    'ticket_id' | 'quoted_message_id' | 'chat_id' | 'org_id'
+  >;
+};
+
+export type AssociatedObjectMetadataType<
+  T extends 'chat' | 'message' | 'ticket' | 'todo' =
+    | 'chat'
+    | 'message'
+    | 'ticket'
+    | 'todo',
+> = T extends 'chat'
+  ? ChatMetadataType
+  : T extends 'message'
+    ? MessageMetadataType
+    : T extends 'ticket'
+      ? TicketMetadataType
+      : null;
+
+export const isChatTask = (task: TaskType): task is TaskType<'chat'> =>
+  task.associated_object_metadata?.type === 'chat';
+
+export const isMessageTask = (task: TaskType): task is TaskType<'message'> =>
+  task.associated_object_metadata?.type === 'message';
+
+export const isTicketTask = (task: TaskType): task is TaskType<'ticket'> =>
+  task.associated_object_metadata?.type === 'ticket';
+
+export const isTodoTask = (task: TaskType): task is TaskType<'todo'> =>
+  task.type === 'todo';
+
+export type TaskType<
+  T extends 'chat' | 'message' | 'ticket' | 'todo' =
+    | 'chat'
+    | 'message'
+    | 'ticket'
+    | 'todo',
+> = OverrideProperties<
+  Tables<'tbl_org_tasks'>,
+  {
+    reminder_setting: {
+      remind_in:
+        | `${number} ${'minutes' | 'hours' | 'days'} ${'before' | 'after'}`
+        | string
+        | null;
+      repeat?: {
+        frequency: number;
+        interval: 'days' | 'weeks' | 'months' | 'years';
+        end: 'never' | 'after' | 'on';
+        on?: string;
+      };
+    } | null;
+    associated_object_metadata: AssociatedObjectMetadataType<T>;
+    status: 'open' | 'inprogress' | 'closed';
+    priority: 1 | 2 | 3;
+    completed_metadata?: {
+      completed_at: string;
+      completed_by: string;
+    } | null;
+    type: T;
+  }
+>;
+
+type Choice = {
+  id: number;
+  label: string;
+  value: string;
+  position: number;
+};
+
+export type FreshdeskFieldType = {
+  id: number;
+  name: string;
+  type: string;
+  label: string;
+  default: boolean;
+  archived: boolean;
+  position: number;
+  created_at: string;
+  updated_at: string;
+  customers_can_edit: boolean;
+  label_for_customers: string;
+  required_for_agents: boolean;
+  customers_can_filter: boolean;
+  required_for_closure: boolean;
+  displayed_to_customers: boolean;
+  required_for_customers: boolean;
+  choices?: Choice[];
+};
+
+export type OrgWarmup = OverrideProperties<
+  Tables<{ schema: 'internal' }, 'tbl_org_warmup'>,
+  {
+    warmup_chats: { [key: string]: string };
+  }
+>;
+
+/** ----------------------------- INTEGRATION TOKENS TYPES ----------------------------- **/
+
+export type FreshdeskIntegrationTokenType = OverrideProperties<
+  Tables<'tbl_integration_tokens'>,
+  {
+    type: 'freshdesk';
+    token_metadata: {
+      url: string;
+      apiKey: string;
+      fields: {
+        ticket: FreshdeskFieldType[];
+        company: FreshdeskFieldType[];
+        contact: FreshdeskFieldType[];
+      };
+      automation: {
+        id: number | string;
+        meta: {
+          total_count: number;
+          total_active_count: 17;
+        };
+        name: string;
+        active: boolean;
+        events: Array<{
+          to?: string;
+          from?: string;
+          field_name: string;
+          value?: string;
+        }>;
+        actions: Array<{
+          url: string;
+          content: Record<string, string>;
+          field_name: string;
+          content_type: string;
+          request_type: string;
+          content_layout: string;
+        }>;
+        summary: {
+          events: Array<string>;
+          actions: Array<string>;
+          performer: string;
+          conditions: {
+            [key: string]: Array<string>;
+          };
+        };
+        outdated: boolean;
+        position: number;
+        performer: {
+          type: string;
+        };
+        conditions: Array<{
+          name: string;
+          match_type: string;
+          properties: Array<{
+            value: Array<string>;
+            operator: string;
+            field_name: string;
+            resource_type: string;
+            case_sensitive: boolean;
+          }>;
+        }>;
+        created_at: string;
+        updated_at: string;
+        description: string | null;
+        last_updated_by: string | number;
+        affected_tickets_count: number | null;
+      };
+      org_details: {
+        address: {
+          city: string;
+          state: string;
+          street: string;
+          country: string;
+          postalcode: string;
+        };
+        timezone: string;
+        bundle_id: string;
+        tier_type: string;
+        account_id: number;
+        cloud_type: string;
+        data_center: string;
+        account_name: string;
+        total_agents: {
+          full_time: number;
+          occasional: number;
+          collaborators: number;
+          field_service: number;
+        };
+        account_domain: string;
+        contact_person: {
+          email: string;
+          lastname: string;
+          firstname: string;
+        };
+        hipaa_compliant: boolean;
+        organisation_id: number;
+        organisation_name: string;
+      };
+      custom_fields: {
+        ticket: FreshdeskFieldType[];
+        company: FreshdeskFieldType[];
+        contact: FreshdeskFieldType[];
+      };
+      integration_org_id: string | number;
+      ticket_auto_creation?: boolean;
+    };
+  }
+>;
+
+export type ZohodeskIntegrationTokenType = OverrideProperties<
+  Tables<'tbl_integration_tokens'>,
+  {
+    type: 'zohodesk';
+    token_metadata: {
+      scope: string;
+      domain: string;
+      fields: Array<{
+        id: string;
+        name: string;
+        type: string;
+        apiName: string;
+        toolTip: string;
+        i18NLabel: string;
+        maxLength: number;
+        isMandatory: boolean;
+        toolTipType: string;
+        displayLabel: string;
+        isCustomField: boolean;
+        isEncryptedField: boolean;
+        showToHelpCenter: boolean;
+      }>;
+      org_id: string;
+      webhooks: {
+        id: string;
+        url: string;
+        name: string;
+        type: string;
+        createdBy: string;
+        isEnabled: boolean;
+        createdTime: string;
+        description: string;
+        modifiedTime: string;
+        subscriptions: {
+          [key: string]: {
+            departmentIds: string[];
+            includePrevState: boolean;
+          };
+        };
+        ignoreSourceId: boolean | null;
+        includeEventsFrom: string[];
+      };
+      api_domain: string;
+      authDomain: string;
+      expires_in: number;
+      token_type: string;
+      departments: Array<{
+        id: string;
+        name: string;
+        hasLogo: boolean;
+        creatorId: string;
+        isDefault: boolean;
+        isEnabled: boolean;
+        chatStatus: string;
+        createdTime: string;
+        description: string | null;
+        sanitizedName: string;
+        nameInCustomerPortal: string;
+        isAssignToTeamEnabled: boolean;
+        isVisibleInCustomerPortal: boolean;
+      }>;
+      org_details: {
+        id: number;
+        fax: string;
+        zip: string;
+        city: string;
+        alias: string | null;
+        state: string;
+        mobile: string;
+        street: string;
+        country: string;
+        edition: string;
+        logoURL: string;
+        website: string;
+        isDefault: boolean;
+        portalURL: string;
+        faviconURL: string;
+        portalName: string;
+        companyName: string;
+        description: string | null;
+        phoneNumber: string | null;
+        currencyCode: string;
+        isAdminInOrg: boolean;
+        employeeCount: number;
+        currencyLocale: string;
+        currencySymbol: string;
+        primaryContact: string;
+        isSandboxPortal: boolean;
+        isPayloadEncryptionEnabled: boolean;
+      };
+      access_token: string;
+      refresh_token: string;
+      integration_org_id: string | number;
+      ticket_auto_creation?: boolean;
+    };
+  }
+>;
+
+export type ZohoCrmIntegrationTokenType = OverrideProperties<
+  Tables<'tbl_integration_tokens'>,
+  {
+    type: 'zohocrm';
+    token_metadata: {
+      access_token: string;
+      refresh_token: string;
+      scope: string;
+      api_domain: string;
+      token_type: string;
+      expires_in: number;
+      domain_extension: string;
+      authDomain: string;
+      integration_org_id: string;
+      org_scope_id?: string; // zgid from Zoho CRM, used for building record URLs
+      chat_messages_auto_logging?: boolean;
+      auto_create_entity?: 'contact' | 'account' | 'lead' | 'none';
+      bypass_webhook_workflow_creation?: boolean;
+      open_in_crmplus?: boolean;
+      crmplus_portal_name?: string;
+      org_details: {
+        id: string;
+        name: string;
+        currency: string;
+        time_zone: string;
+        currency_symbol: string;
+        currency_locale: string;
+        website: string;
+        description: string | null;
+        phone: string | null;
+        mobile: string | null;
+        fax: string | null;
+        street: string;
+        city: string;
+        state: string;
+        zip: string;
+        country: string;
+        logo_url: string;
+        is_sandbox: boolean;
+        is_admin_in_org: boolean;
+        employee_count: number;
+        primary_contact: string;
+      };
+      fields?: Array<{
+        name: string;
+        label: string;
+        zoho_api_name: string;
+        fieldType: string;
+      }>;
+      modules: Array<{
+        id: string;
+        name: string;
+        api_name: string;
+        singular_label: string;
+        plural_label: string;
+        is_custom: boolean;
+        is_creatable: boolean;
+        is_editable: boolean;
+        is_deletable: boolean;
+        is_webform_supported: boolean;
+        sequence_number: number;
+        fields: Array<{
+          id: string;
+          name: string;
+          api_name: string;
+          data_type: string;
+          required: boolean;
+          is_custom: boolean;
+          is_editable: boolean;
+          is_creatable: boolean;
+          is_webform_supported: boolean;
+          length: number;
+          decimal_places: number | null;
+          default_value: string | null;
+          picklist_values: Array<{
+            display_value: string;
+            actual_value: string;
+          }> | null;
+        }>;
+      }>;
+      webhooks?: {
+        id: string;
+        url: string;
+        name: string;
+        events: string[];
+        is_active: boolean;
+        created_time: string;
+        modified_time: string;
+      };
+    };
+  }
+>;