@semboja/connect 0.1.1 → 0.2.0

package/README.md

@@ -143,6 +143,54 @@ await client.messages.sendInteractive({
     },
   },
 });
+
+// Sticker message
+await client.messages.sendSticker({
+  phoneNumberId: '123456789',
+  to: '+6281234567890',
+  sticker: {
+    link: 'https://example.com/sticker.webp',
+  },
+});
+
+// Location message
+await client.messages.sendLocation({
+  phoneNumberId: '123456789',
+  to: '+6281234567890',
+  location: {
+    latitude: -6.2088,
+    longitude: 106.8456,
+    name: 'Monas',
+    address: 'Gambir, Central Jakarta, Indonesia',
+  },
+});
+
+// Contact card
+await client.messages.sendContacts({
+  phoneNumberId: '123456789',
+  to: '+6281234567890',
+  contacts: [
+    {
+      name: {
+        formatted_name: 'John Doe',
+        first_name: 'John',
+        last_name: 'Doe',
+      },
+      phones: [
+        { phone: '+6281234567890', type: 'CELL' },
+      ],
+      emails: [
+        { email: 'john@example.com', type: 'WORK' },
+      ],
+    },
+  ],
+});
+
+// Mark message as read
+await client.messages.markAsRead({
+  phoneNumberId: '123456789',
+  messageId: 'wamid.xxx',
+});
 ```
 
 ### Templates
@@ -274,8 +322,12 @@ try {
 | `sendVideo(options)` | Send a video |
 | `sendAudio(options)` | Send an audio file |
 | `sendDocument(options)` | Send a document |
+| `sendSticker(options)` | Send a sticker (WebP) |
+| `sendLocation(options)` | Send a location |
+| `sendContacts(options)` | Send contact cards |
 | `sendReaction(options)` | Send a reaction |
 | `sendInteractive(options)` | Send interactive message |
+| `markAsRead(options)` | Mark a message as read |
 
 ### Error Classes
 

package/dist/index.d.mts

@@ -35,6 +35,18 @@ declare class HttpClient {
      * POST request
      */
     post<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * PUT request
+     */
+    put<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * PATCH request
+     */
+    patch<T>(path: string, body?: unknown): Promise<T>;
+    /**
+     * DELETE request
+     */
+    delete<T>(path: string): Promise<T>;
 }
 
 /**
@@ -74,7 +86,7 @@ interface ApiErrorResponse {
         request_id: string;
     };
 }
-type MessageType = 'text' | 'template' | 'image' | 'video' | 'audio' | 'document' | 'interactive' | 'reaction';
+type MessageType = 'text' | 'template' | 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'location' | 'contacts' | 'interactive' | 'reaction';
 interface SendMessageOptions {
     /** Meta Phone Number ID */
     phoneNumberId: string;
@@ -165,6 +177,123 @@ interface SendReactionOptions extends SendMessageOptions {
         emoji: string;
     };
 }
+interface StickerObject {
+    /** URL of the sticker file (WebP format) */
+    link?: string;
+    /** Media ID (if uploaded to WhatsApp) */
+    id?: string;
+}
+interface SendStickerOptions extends SendMessageOptions {
+    /** Sticker configuration */
+    sticker: StickerObject;
+    /** Message ID to reply to */
+    replyTo?: string;
+}
+interface LocationObject {
+    /** Longitude of the location */
+    longitude: number;
+    /** Latitude of the location */
+    latitude: number;
+    /** Name of the location */
+    name?: string;
+    /** Address of the location */
+    address?: string;
+}
+interface SendLocationOptions extends SendMessageOptions {
+    /** Location configuration */
+    location: LocationObject;
+    /** Message ID to reply to */
+    replyTo?: string;
+}
+interface ContactName {
+    /** Full formatted name */
+    formatted_name: string;
+    /** First name */
+    first_name?: string;
+    /** Last name */
+    last_name?: string;
+    /** Middle name */
+    middle_name?: string;
+    /** Suffix (e.g., Jr., Sr.) */
+    suffix?: string;
+    /** Prefix (e.g., Mr., Mrs., Dr.) */
+    prefix?: string;
+}
+interface ContactPhone {
+    /** Phone number */
+    phone: string;
+    /** Type of phone number */
+    type?: 'CELL' | 'MAIN' | 'IPHONE' | 'HOME' | 'WORK';
+    /** WhatsApp ID (optional) */
+    wa_id?: string;
+}
+interface ContactEmail {
+    /** Email address */
+    email: string;
+    /** Type of email */
+    type?: 'HOME' | 'WORK';
+}
+interface ContactAddress {
+    /** Street address */
+    street?: string;
+    /** City */
+    city?: string;
+    /** State or province */
+    state?: string;
+    /** ZIP or postal code */
+    zip?: string;
+    /** Country */
+    country?: string;
+    /** Country code (ISO 3166-1 alpha-2) */
+    country_code?: string;
+    /** Type of address */
+    type?: 'HOME' | 'WORK';
+}
+interface ContactUrl {
+    /** URL */
+    url: string;
+    /** Type of URL */
+    type?: 'HOME' | 'WORK';
+}
+interface ContactOrg {
+    /** Company name */
+    company?: string;
+    /** Department */
+    department?: string;
+    /** Job title */
+    title?: string;
+}
+interface Contact {
+    /** Contact's name (required) */
+    name: ContactName;
+    /** Phone numbers */
+    phones?: ContactPhone[];
+    /** Email addresses */
+    emails?: ContactEmail[];
+    /** Addresses */
+    addresses?: ContactAddress[];
+    /** URLs */
+    urls?: ContactUrl[];
+    /** Organization information */
+    org?: ContactOrg;
+    /** Birthday in YYYY-MM-DD format */
+    birthday?: string;
+}
+interface SendContactsOptions extends SendMessageOptions {
+    /** Array of contacts to send */
+    contacts: Contact[];
+    /** Message ID to reply to */
+    replyTo?: string;
+}
+interface MarkAsReadOptions {
+    /** Meta Phone Number ID */
+    phoneNumberId: string;
+    /** Message ID to mark as read */
+    messageId: string;
+}
+interface MarkAsReadResponseData {
+    success: boolean;
+}
 interface InteractiveButton {
     type: 'reply';
     reply: {
@@ -236,6 +365,40 @@ interface PhoneNumber {
     verified_name: string;
     quality_rating?: string;
 }
+/** Phone number profile from Meta Graph API */
+interface MetaPhoneNumberInfo {
+    id: string;
+    verified_name: string;
+    display_phone_number: string;
+    quality_rating: "GREEN" | "YELLOW" | "RED" | "UNKNOWN";
+    code_verification_status: "VERIFIED" | "NOT_VERIFIED" | "EXPIRED";
+    is_official_business_account: boolean;
+    is_pin_enabled: boolean;
+    name_status: "APPROVED" | "PENDING" | "DECLINED" | "NONE";
+    new_name_status?: "APPROVED" | "PENDING" | "DECLINED" | "NONE";
+    messaging_limit_tier?: string;
+    platform_type?: string;
+    throughput?: {
+        level: string;
+    };
+    account_mode?: "LIVE" | "SANDBOX";
+}
+/** Business profile from Meta Graph API */
+interface MetaBusinessProfile {
+    about?: string;
+    address?: string;
+    description?: string;
+    email?: string;
+    messaging_product: string;
+    profile_picture_url?: string;
+    vertical?: string;
+    websites?: string[];
+}
+/** Combined phone number profile response */
+interface PhoneNumberProfile {
+    phone_number: MetaPhoneNumberInfo;
+    business_profile: MetaBusinessProfile;
+}
 interface UsagePeriod {
     start: string;
     end: string;
@@ -431,6 +594,100 @@ declare class Messages {
      * ```
      */
     sendInteractive(options: SendInteractiveOptions): Promise<ApiResponse<MessageResponseData>>;
+    /**
+     * Send a sticker message
+     *
+     * @param options - Sticker message options
+     * @returns Message response with message ID
+     *
+     * @example
+     * ```typescript
+     * // Send sticker by URL
+     * const result = await client.messages.sendSticker({
+     *   phoneNumberId: '123456789',
+     *   to: '+6281234567890',
+     *   sticker: {
+     *     link: 'https://example.com/sticker.webp',
+     *   },
+     * });
+     *
+     * // Send sticker by media ID
+     * await client.messages.sendSticker({
+     *   phoneNumberId: '123456789',
+     *   to: '+6281234567890',
+     *   sticker: {
+     *     id: 'media_id_here',
+     *   },
+     * });
+     * ```
+     */
+    sendSticker(options: SendStickerOptions): Promise<ApiResponse<MessageResponseData>>;
+    /**
+     * Send a location message
+     *
+     * @param options - Location message options
+     * @returns Message response with message ID
+     *
+     * @example
+     * ```typescript
+     * const result = await client.messages.sendLocation({
+     *   phoneNumberId: '123456789',
+     *   to: '+6281234567890',
+     *   location: {
+     *     latitude: -6.2088,
+     *     longitude: 106.8456,
+     *     name: 'Monas',
+     *     address: 'Gambir, Central Jakarta, Indonesia',
+     *   },
+     * });
+     * ```
+     */
+    sendLocation(options: SendLocationOptions): Promise<ApiResponse<MessageResponseData>>;
+    /**
+     * Send contact cards
+     *
+     * @param options - Contact message options
+     * @returns Message response with message ID
+     *
+     * @example
+     * ```typescript
+     * const result = await client.messages.sendContacts({
+     *   phoneNumberId: '123456789',
+     *   to: '+6281234567890',
+     *   contacts: [
+     *     {
+     *       name: {
+     *         formatted_name: 'John Doe',
+     *         first_name: 'John',
+     *         last_name: 'Doe',
+     *       },
+     *       phones: [
+     *         { phone: '+6281234567890', type: 'CELL' },
+     *       ],
+     *       emails: [
+     *         { email: 'john@example.com', type: 'WORK' },
+     *       ],
+     *     },
+     *   ],
+     * });
+     * ```
+     */
+    sendContacts(options: SendContactsOptions): Promise<ApiResponse<MessageResponseData>>;
+    /**
+     * Mark a message as read
+     *
+     * @param options - Mark as read options
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await client.messages.markAsRead({
+     *   phoneNumberId: '123456789',
+     *   messageId: 'wamid.xxx',
+     * });
+     * ```
+     */
+    markAsRead(options: MarkAsReadOptions): Promise<ApiResponse<MarkAsReadResponseData>>;
 }
 
 /**
@@ -469,6 +726,7 @@ declare class Templates {
  * @example
  * ```typescript
  * const phoneNumbers = await client.phoneNumbers.list();
+ * const profile = await client.phoneNumbers.getProfile('123456');
  * ```
  */
 declare class PhoneNumbers {
@@ -488,6 +746,60 @@ declare class PhoneNumbers {
      * ```
      */
     list(): Promise<ApiResponse<PhoneNumber[]>>;
+    /**
+     * Get a specific phone number by ID
+     *
+     * @param id - The phone number ID (from list response)
+     * @returns Phone number details
+     *
+     * @example
+     * ```typescript
+     * const phone = await client.phoneNumbers.get('phone-number-uuid');
+     * console.log(phone.data.display_phone_number);
+     * ```
+     */
+    get(id: string): Promise<ApiResponse<PhoneNumber>>;
+    /**
+     * Get phone number profile from Meta Graph API
+     *
+     * Returns detailed information including quality rating, verification status,
+     * messaging limits, and business profile.
+     *
+     * @param id - The phone number ID
+     * @returns Phone number profile with Meta API details
+     *
+     * @example
+     * ```typescript
+     * const profile = await client.phoneNumbers.getProfile('phone-number-uuid');
+     * console.log('Quality:', profile.data.phone_number.quality_rating);
+     * console.log('Name:', profile.data.business_profile.about);
+     * ```
+     */
+    getProfile(id: string): Promise<ApiResponse<PhoneNumberProfile>>;
+    /**
+     * Update business profile for a phone number
+     *
+     * @param id - The phone number ID
+     * @param profile - Profile fields to update
+     * @returns Updated business profile
+     *
+     * @example
+     * ```typescript
+     * const updated = await client.phoneNumbers.updateProfile('phone-number-uuid', {
+     *   about: 'We help businesses grow',
+     *   description: 'Customer support',
+     *   email: 'support@example.com',
+     * });
+     * ```
+     */
+    updateProfile(id: string, profile: {
+        about?: string;
+        address?: string;
+        description?: string;
+        email?: string;
+        vertical?: string;
+        websites?: string[];
+    }): Promise<ApiResponse<PhoneNumberProfile['business_profile']>>;
 }
 
 /**
@@ -768,4 +1080,4 @@ declare class NetworkError extends SembojaError {
  * @packageDocumentation
  */
 
-export { type ApiErrorResponse, type ApiResponse, AuthenticationError, type ClientOptions, type InteractiveButton, type InteractiveListSection, type InteractiveMessage, type ListTemplatesOptions, type MediaObject, type MessageContact, type MessageResponseData, type MessageResult, type MessageType, NetworkError, NotFoundError, type PhoneNumber, RateLimitError, SembojaClient, SembojaError, type SendAudioOptions, type SendDocumentOptions, type SendImageOptions, type SendInteractiveOptions, type SendMessageOptions, type SendReactionOptions, type SendTemplateOptions, type SendTextOptions, type SendVideoOptions, ServerError, type Template, type TemplateComponent, type TemplateInfo, type TemplateLanguage, type TemplateParameter, type TemplateStatus, type TriggerWebhookOptions, type UsageData, type UsageMessages, type UsagePeriod, ValidationError, type VerifyWebhookOptions, SembojaClient as default, parseWebhookPayload, verifyWebhookSignature };
+export { type ApiErrorResponse, type ApiResponse, AuthenticationError, type ClientOptions, type Contact, type ContactAddress, type ContactEmail, type ContactName, type ContactOrg, type ContactPhone, type ContactUrl, type InteractiveButton, type InteractiveListSection, type InteractiveMessage, type ListTemplatesOptions, type LocationObject, type MarkAsReadOptions, type MarkAsReadResponseData, type MediaObject, type MessageContact, type MessageResponseData, type MessageResult, type MessageType, type MetaBusinessProfile, type MetaPhoneNumberInfo, NetworkError, NotFoundError, type PhoneNumber, type PhoneNumberProfile, RateLimitError, SembojaClient, SembojaError, type SendAudioOptions, type SendContactsOptions, type SendDocumentOptions, type SendImageOptions, type SendInteractiveOptions, type SendLocationOptions, type SendMessageOptions, type SendReactionOptions, type SendStickerOptions, type SendTemplateOptions, type SendTextOptions, type SendVideoOptions, ServerError, type StickerObject, type Template, type TemplateComponent, type TemplateInfo, type TemplateLanguage, type TemplateParameter, type TemplateStatus, type TriggerWebhookOptions, type UsageData, type UsageMessages, type UsagePeriod, ValidationError, type VerifyWebhookOptions, SembojaClient as default, parseWebhookPayload, verifyWebhookSignature };