@periskope/types 0.6.12 → 0.6.13-7.2

package/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "compilerOptions": {
     /* Visit https://aka.ms/tsconfig to read more about this file */
-
     /* Projects */
     // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
     // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
@@ -9,9 +8,8 @@
     // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
     // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
     // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
-
     /* Language and Environment */
-    "target": "ES2016",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    "target": "ES2016", /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
     // "lib": [],                                        /* Specify a set of bundled library declaration files that describe the target runtime environment. */
     // "jsx": "preserve",                                /* Specify what JSX code is generated. */
     // "experimentalDecorators": true,                   /* Enable experimental support for legacy experimental decorators. */
@@ -23,9 +21,8 @@
     // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
     // "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
     // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
-
     /* Modules */
-    "module": "CommonJS",                                /* Specify what module code is generated. */
+    "module": "CommonJS", /* Specify what module code is generated. */
     // "rootDir": "./",                                  /* Specify the root folder within your source files. */
     // "moduleResolution": "Node",                     /* Specify how TypeScript looks up a file from a given module specifier. */
     // "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
@@ -42,20 +39,18 @@
     // "resolveJsonModule": true,                        /* Enable importing .json files. */
     // "allowArbitraryExtensions": true,                 /* Enable importing files with any extension, provided a declaration file is present. */
     // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
-
     /* JavaScript Support */
     // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
     // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
     // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
-
     /* Emit */
-    "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    "declaration": true, /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
     // "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
     // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
     // "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
     // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
     // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
-    "outDir": "dist/",                                   /* Specify an output folder for all emitted files. */
+    "outDir": "dist/", /* Specify an output folder for all emitted files. */
     // "removeComments": true,                           /* Disable emitting comments. */
     // "noEmit": true,                                   /* Disable emitting files from a compilation. */
     // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
@@ -72,17 +67,15 @@
     // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
     // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
     // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
-
     /* Interop Constraints */
     // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
     // "verbatimModuleSyntax": true,                     /* Do not transform or elide any imports or exports not marked as type-only, ensuring they are written in the output file's format based on the 'module' setting. */
     // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
-    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
+    "esModuleInterop": true, /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
     // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
-    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
-
+    "forceConsistentCasingInFileNames": true, /* Ensure that casing is correct in imports. */
     /* Type Checking */
-    "strict": true,                                      /* Enable all strict type-checking options. */
+    "strict": true, /* Enable all strict type-checking options. */
     // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
     // "strictNullChecks": true,                         /* When type checking, take into account 'null' and 'undefined'. */
     // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
@@ -101,9 +94,13 @@
     // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
     // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
     // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
-
     /* Completeness */
     // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
-    "skipLibCheck": true                                 /* Skip type checking all .d.ts files. */
-  }
-}
+    "skipLibCheck": true /* Skip type checking all .d.ts files. */
+  },
+  "exclude": [
+    "node_modules",
+    "dist",
+    "scripts"
+  ]
+}

package/types.ts

@@ -1,26 +1,123 @@
+import type { default as _Stripe } from 'stripe';
 import { Merge, OverrideProperties } from 'type-fest';
-import { Chat, MessageTypes } from 'whatsapp-web.js';
-import { Tables } from './supabase.types';
+import { Tables, TablesUpdate } from './supabase.types';
 
 /* ----------------------------- TYPE SHORTHANDS ---------------------------- */
 
-/* ------------------------------ WHATSAPP ------------------------------ */
+/* ------------------------------ 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 WhatsappChat = Chat & {
-  groupMetadata?: any;
-  pinned?: boolean;
-  invite_link?: string;
+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;
 };
 
-/* ------------------------------ PERISKOPE TYPES ------------------------------ */
+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;
+};
+
+export type OrgPlan<T extends AllPlans | Enterprise> = T extends Enterprise
+  ? OrgPlanEnterprise
+  : T extends AllPlans
+    ? OrgPlanNonEnterprise
+    : never;
 
-export type OrgType = Tables<'tbl_org'> & {
-  user: Tables<'tbl_org_members'>;
-  members: Tables<'tbl_org_members'>[];
-  phones: Tables<'tbl_org_phones'>[];
-  labels: Tables<'tbl_org_labels'>[];
+export type MicrosurveyData = {
+  key: string;
+  text: string;
+  checked: boolean;
+}[];
+
+export type OrgPreferences = {
+  disable_ai_flagging?: boolean;
+  disable_allow_exports?: boolean;
+  sync_phone_contacts?: boolean;
+  mask_phone_numbers?: boolean;
+  show_sender_names?: boolean;
+};
+
+type OrgPreferenceKey = keyof OrgPreferences;
+
+export type OrgPreferencesValue = {
+  [K in OrgPreferenceKey]: { key: K; value: OrgPreferences[K] };
+}[OrgPreferenceKey];
+
+export type OrgMetadata = {
+  phone_number: string;
+  ticket_prefix: string;
+  referralSource?: string;
+  surveyData?: MicrosurveyData;
+  preferences?: OrgPreferences;
+  hubspot_pipelines?: {
+    id: string;
+    label: string;
+    default_stage: { id: string; label: string };
+  }[];
+  partition?: boolean;
 };
 
+type AccessScopes = {
+  integrations: boolean;
+  exports: boolean;
+};
+
+export type OrgType = OverrideProperties<
+  Merge<
+    Tables<'tbl_org'>,
+    {
+      user: Tables<'tbl_org_members'>;
+      members: Tables<'tbl_org_members'>[];
+      phones: Tables<'tbl_org_phones'>[];
+      labels: Tables<'tbl_org_labels'>[];
+      quick_replies: Tables<'tbl_quick_replies'>[];
+      custom_properties: Tables<'tbl_custom_properties'>[];
+      subscription_status: 'active' | 'inactive' | 'unpaid';
+      is_enterprise: boolean;
+      is_free_trial: boolean;
+      is_hubspot_connected: boolean;
+      is_freshdesk_connected: boolean;
+      is_zohodesk_connected: boolean;
+      access_scopes: AccessScopes;
+    }
+  >,
+  {
+    org_plan: OrgPlan<AllPlans | Enterprise>;
+    stripe_customer_details: _Stripe.Customer | null;
+    stripe_subscription_details: Array<_Stripe.Subscription> | null;
+    stripe_customer_id: _Stripe.Customer['id'] | null;
+    org_metadata: OrgMetadata;
+  }
+>;
+
 export type ChatMemberType = Merge<
   Tables<'tbl_chat_participants'>,
   Tables<'tbl_contacts'>
@@ -31,26 +128,95 @@ export type ChatType = Merge<
   {
     chat_id: string;
     latest_message: MessageType | null;
-    members: Record<string, ChatMemberType> | null;
-    chat_type: 'user' | 'group' | 'business';
-    active_phone?: string;
-    chat_access: Record<string, boolean>;
-    label_ids: Record<string, boolean>;
+    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 };
   }
 >;
 
+/* -------------------------------------------------------------------------- */
+/*                                   MESSAGE                                  */
+/* -------------------------------------------------------------------------- */
+
 export type MediaType = {
   path: string;
-  mimetype: string | null;
-  filename: string | null;
+  mimetype?: string;
+  filename?: string;
+  dimensions?: { width: number; height: number; ar: number };
+  size?: number;
+  thumbnail?: string;
 };
 
-export type MessageType = OverrideProperties<
-  Tables<'tbl_chat_messages'>,
+export type MessageType = Merge<
+  OverrideProperties<
+    Tables<'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;
+    }
+  >,
   {
-    message_type: MessageTypes;
-    media: MediaType | null;
+    reactions?: ReactionType[];
+    message_payload?: SingleMessagePayload;
+    show_unread?: boolean;
+    highlight?: number;
+  }
+>;
+
+export type MessageFlagType = {
+  status: boolean;
+  response_type?: 'message' | 'reaction' | 'ticket';
+  response_id?: string;
+  response_timestamp?: string;
+  response_email?: 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;
   }
 >;
 
@@ -58,22 +224,21 @@ export type ContactType = Merge<
   Tables<'tbl_contacts'>,
   {
     chats: ChatType[] | null;
-    chat_count: number | null;
-    chat_ids: string[] | null;
+    chat_ids?: string[];
   }
 >;
+export type ReactionType = Tables<'tbl_chat_reactions'>;
+
+export type NotificationType = Tables<'tbl_chat_notifications'>;
 
 export type ChatAccessType = Merge<
-  Partial<Tables<'tbl_chat_access'>>,
-  Tables<'tbl_org_members'>
+  TablesUpdate<'tbl_org_members'>,
+  {
+    has_access?: boolean;
+    email: string | null;
+  }
 >;
 
-export type ServerStateType = {
-  loading: boolean;
-  percent: number | null;
-  ready: boolean;
-};
-
 /* -------------------------------- CONSTANTS ------------------------------- */
 
 export const labelColors = [
@@ -101,3 +266,294 @@ export const enumChatColors = [
   '#FF2E74',
   '#DB2777',
 ] as const;
+
+/* -------------------------- 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;
+};
+
+export type QuickReplyContent = Omit<
+  SendMessageContent,
+  'broadcast_id' | 'variables'
+>;
+
+export type BroadcastVariableType = {
+  chat_id: string;
+  values: { [key: string]: string };
+};
+
+export type BroadcastMessagePayload = SendMessageContent & {
+  chat_ids: string[];
+  broadcast_id?: string;
+  variables?: BroadcastVariableType[];
+};
+
+export type SingleMessagePayload = SendMessageContent & {
+  chat_id: string;
+  job_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;
+};
+
+export type ChatOperationReturn = {
+  [participant_id: string]: {
+    is_success: boolean;
+    message?: string;
+    code?: number;
+    isInviteV4Sent?: boolean;
+  };
+};
+
+/* ----------------------- BILLING - STRIPE ----------------------- */
+
+export type StripeSubscription = _Stripe.Subscription;
+export type StripeCustomer = _Stripe.Customer;
+export type StripeCoupon = _Stripe.Coupon;
+export type StripePrice = _Stripe.Price;
+export type Stripe = _Stripe;
+export type StripeUpcomingInvoice = _Stripe.UpcomingInvoice;
+export type StripeLineItem = _Stripe.Checkout.SessionCreateParams.LineItem;
+
+/* -------------------------------- 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;
+  };
+};
+
+export type IntegrationLogObjectType =
+  | 'chat'
+  | 'message'
+  | 'reaction'
+  | 'ticket';
+
+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',
+  REACTION_CREATED = 'reaction.created',
+  REACTION_UPDATED = 'reaction.updated',
+  NEW_TICKET = 'ticket.created',
+  TICKET_UPDATED = 'ticket.updated',
+  TICKET_DELETED = 'ticket.deleted',
+}
+
+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
+        ? Tables<'tbl_chat_messages'>
+        : T extends
+              | IntegrationLogType.REACTION_CREATED
+              | IntegrationLogType.REACTION_UPDATED
+          ? Tables<'tbl_chat_reactions'>
+          : {
+              [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;
+};
+
+/* ----------------------------- 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>;
+};

package/update_package.ps1

@@ -0,0 +1,21 @@
+# Define the path to your package.json file
+$packageJsonPath = "./package.json"
+
+# Read the package.json file
+$packageJson = Get-Content $packageJsonPath -Raw | ConvertFrom-Json
+
+# Increment the patch version
+$versionParts = $packageJson.version -split '\.'
+$versionParts[2] = [int]$versionParts[2] + 1
+$newVersion = $versionParts -join '.'
+
+Write-Host "Updating package version to $newVersion"
+
+# Update the version in the object
+$packageJson.version = $newVersion
+
+# Convert the object back to JSON and save
+$packageJson | ConvertTo-Json -Depth 100 | Set-Content $packageJsonPath
+
+# Run npm command
+npm run update-package