@ariaflowagents/messaging-meta 0.8.1

package/dist/messenger/client.js

@@ -0,0 +1,782 @@
+/**
+ * @module messenger/client
+ *
+ * Facebook Messenger Platform client implementing the {@link PlatformClient}
+ * interface from `@ariaflowagents/messaging`.
+ *
+ * Provides a complete, production-ready integration with Meta's Messenger
+ * Platform including:
+ *
+ * - Sending text, media, interactive (button/generic templates), and quick replies
+ * - Webhook handling with signature verification
+ * - Sender actions (typing indicators, mark-seen)
+ * - User profile retrieval
+ * - Persona management (create, delete)
+ * - Media upload and download
+ * - Messenger-specific format conversion (plain text)
+ *
+ * @example
+ * ```ts
+ * import { createMessengerClient } from '@ariaflowagents/messaging-meta/messenger';
+ *
+ * const client = createMessengerClient({
+ *   pageAccessToken: process.env.MESSENGER_PAGE_ACCESS_TOKEN!,
+ *   appSecret: process.env.META_APP_SECRET!,
+ *   pageId: process.env.MESSENGER_PAGE_ID!,
+ *   verifyToken: process.env.MESSENGER_VERIFY_TOKEN!,
+ * });
+ *
+ * client.onMessage(async (msg) => {
+ *   await client.sendText(msg.from.id, `Echo: ${msg.text}`);
+ * });
+ * ```
+ */
+import { MessagingError, } from '@ariaflowagents/messaging';
+import { GraphAPIClient } from '../graph-api/client.js';
+import { verifySignature } from '../webhook/verifier.js';
+import { normalizeWebhook } from '../webhook/normalizer.js';
+import { MessengerFormatConverter } from './format.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Maximum text message length for the Messenger Platform. */
+const MESSENGER_TEXT_LIMIT = 2000;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create a new {@link MessengerClient} instance.
+ *
+ * This is the recommended entry point. It constructs the client with all
+ * internal dependencies wired up (Graph API client, format converter).
+ *
+ * @param config - Messenger client configuration.
+ * @returns A fully configured {@link MessengerClient}.
+ *
+ * @example
+ * ```ts
+ * const messenger = createMessengerClient({
+ *   pageAccessToken: process.env.MESSENGER_PAGE_ACCESS_TOKEN!,
+ *   appSecret: process.env.META_APP_SECRET!,
+ *   pageId: process.env.MESSENGER_PAGE_ID!,
+ *   verifyToken: process.env.MESSENGER_VERIFY_TOKEN!,
+ * });
+ * ```
+ */
+export function createMessengerClient(config) {
+    return new MessengerClient(config);
+}
+// ---------------------------------------------------------------------------
+// MessengerClient
+// ---------------------------------------------------------------------------
+/**
+ * Full-featured Facebook Messenger Platform client.
+ *
+ * Implements the `PlatformClient` interface from `@ariaflowagents/messaging`
+ * so it can be plugged into the messaging adapter layer, while also exposing
+ * Messenger-specific capabilities (button templates, generic templates,
+ * quick replies, personas, user profiles).
+ *
+ * Use {@link createMessengerClient} to instantiate.
+ */
+export class MessengerClient {
+    /** @inheritdoc */
+    platform = 'messenger';
+    graphApi;
+    config;
+    messageHandlers = [];
+    statusHandlers = [];
+    reactionHandlers = [];
+    formatConverterInstance;
+    mediaCache;
+    constructor(config) {
+        this.config = config;
+        this.graphApi = new GraphAPIClient({
+            accessToken: config.pageAccessToken,
+            appSecret: config.appSecret,
+            apiVersion: config.apiVersion,
+            baseUrl: config.baseUrl,
+            retry: config.retry,
+            rateLimiter: config.rateLimiter,
+            logger: config.logger,
+        });
+        this.formatConverterInstance = new MessengerFormatConverter();
+        this.mediaCache = config.mediaCache;
+    }
+    /** Messenger-specific format converter. */
+    get formatConverter() {
+        return this.formatConverterInstance;
+    }
+    // =========================================================================
+    // Lifecycle — handler registration
+    // =========================================================================
+    /**
+     * Register a handler for inbound messages.
+     *
+     * Multiple handlers can be registered; they are called in order for
+     * each incoming message.
+     *
+     * @param handler - Callback invoked with the normalised message and raw payload.
+     */
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    /**
+     * Register a handler for delivery/read status updates.
+     *
+     * @param handler - Callback invoked with the normalised status update.
+     */
+    onStatus(handler) {
+        this.statusHandlers.push(handler);
+    }
+    /**
+     * Register a handler for reaction events.
+     *
+     * @param handler - Callback invoked with the normalised reaction data.
+     */
+    onReaction(handler) {
+        this.reactionHandlers.push(handler);
+    }
+    // =========================================================================
+    // Webhook handling
+    // =========================================================================
+    /**
+     * Handle an incoming webhook request from Meta.
+     *
+     * - **GET** requests are treated as subscription verification challenges.
+     * - **POST** requests are validated via HMAC-SHA256 signature, normalised,
+     *   and dispatched to registered handlers.
+     *
+     * @param request - The incoming HTTP request.
+     * @returns An HTTP response (200 OK, 401 Unauthorized, or 403 Forbidden).
+     */
+    async handleWebhook(request) {
+        if (request.method === 'GET') {
+            return this.handleVerification(request);
+        }
+        const rawBody = await request.text();
+        const signature = request.headers.get('x-hub-signature-256');
+        if (!signature ||
+            !verifySignature({
+                appSecret: this.config.appSecret,
+                rawBody,
+                signatureHeader: signature,
+            })) {
+            return new Response('Unauthorized', { status: 401 });
+        }
+        const payload = JSON.parse(rawBody);
+        const events = normalizeWebhook(payload);
+        // Dispatch messages
+        for (const msg of events.messages) {
+            const inbound = this.toInboundMessage(msg);
+            for (const handler of this.messageHandlers) {
+                await handler(inbound, msg);
+            }
+        }
+        // Dispatch statuses
+        for (const status of events.statuses) {
+            const update = this.toStatusUpdate(status);
+            for (const handler of this.statusHandlers) {
+                await handler(update);
+            }
+        }
+        // Dispatch reactions
+        for (const reaction of events.reactions) {
+            const data = this.toReactionData(reaction);
+            for (const handler of this.reactionHandlers) {
+                await handler(data);
+            }
+        }
+        return new Response('OK', { status: 200 });
+    }
+    /**
+     * Handle webhook verification (GET) from Meta.
+     *
+     * @param request - The GET request with `hub.mode`, `hub.verify_token`, and `hub.challenge`.
+     * @returns 200 with the challenge string, or 403 Forbidden.
+     */
+    handleVerification(request) {
+        const url = new URL(request.url);
+        const mode = url.searchParams.get('hub.mode');
+        const token = url.searchParams.get('hub.verify_token');
+        const challenge = url.searchParams.get('hub.challenge');
+        if (mode === 'subscribe' && token === this.config.verifyToken) {
+            return new Response(challenge ?? '', { status: 200 });
+        }
+        return new Response('Forbidden', { status: 403 });
+    }
+    // =========================================================================
+    // Outbound — core PlatformClient methods
+    // =========================================================================
+    /**
+     * Send a text message.
+     *
+     * Messages exceeding the 2000-character Messenger limit are truncated.
+     *
+     * @param to   - Recipient PSID.
+     * @param text - The text content to send.
+     * @returns The send result.
+     */
+    async sendText(to, text) {
+        const truncated = text.length > MESSENGER_TEXT_LIMIT
+            ? text.slice(0, MESSENGER_TEXT_LIMIT)
+            : text;
+        const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            messaging_type: 'RESPONSE',
+            message: { text: truncated },
+        });
+        return this.toSendResult(to, response);
+    }
+    /**
+     * Send a media message (image, video, audio, or file).
+     *
+     * Accepts URLs (string), Buffers (uploaded automatically), or ReadableStreams.
+     *
+     * @param to    - Recipient PSID.
+     * @param media - The media payload to send.
+     * @returns The send result.
+     */
+    async sendMedia(to, media) {
+        const attachmentType = this.resolveAttachmentType(media.mimeType);
+        if (typeof media.data === 'string') {
+            // Send via URL
+            const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+                recipient: { id: to },
+                messaging_type: 'RESPONSE',
+                message: {
+                    attachment: {
+                        type: attachmentType,
+                        payload: { url: media.data, is_reusable: true },
+                    },
+                },
+            });
+            return this.toSendResult(to, response);
+        }
+        // Buffer or ReadableStream — upload first
+        const buffer = Buffer.isBuffer(media.data)
+            ? media.data
+            : await streamToBuffer(media.data);
+        const handle = await this.uploadMedia(buffer, {
+            mimeType: media.mimeType,
+            filename: media.filename,
+        });
+        const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            messaging_type: 'RESPONSE',
+            message: {
+                attachment: {
+                    type: attachmentType,
+                    payload: { attachment_id: handle.mediaId },
+                },
+            },
+        });
+        return this.toSendResult(to, response);
+    }
+    /**
+     * Send an interactive message (buttons or list).
+     *
+     * Converts the platform-agnostic {@link InteractiveMessage} into
+     * Messenger's template format:
+     * - `action.type === 'buttons'` maps to a button template
+     * - `action.type === 'list'` maps to a generic template (carousel)
+     *
+     * @param to  - Recipient PSID.
+     * @param msg - The interactive message definition.
+     * @returns The send result.
+     * @throws {@link MessagingError} if the interactive type is unsupported.
+     */
+    async sendInteractive(to, msg) {
+        if (msg.action.type === 'buttons') {
+            return this.sendButtonTemplate(to, {
+                text: msg.body,
+                buttons: msg.action.buttons.map((b) => ({
+                    type: 'postback',
+                    title: b.title,
+                    payload: b.id,
+                })),
+            });
+        }
+        if (msg.action.type === 'list') {
+            // Map list sections to generic template elements
+            const elements = msg.action.sections.flatMap((section) => section.rows.map((row) => ({
+                title: row.title,
+                subtitle: row.description,
+                buttons: [
+                    {
+                        type: 'postback',
+                        title: row.title.slice(0, 20),
+                        payload: row.id,
+                    },
+                ],
+            })));
+            return this.sendGenericTemplate(to, { elements: elements.slice(0, 10) });
+        }
+        throw new MessagingError(`Unsupported interactive type: ${msg.action.type}`, 'UNSUPPORTED_TYPE', 'messenger');
+    }
+    /**
+     * Send a raw platform-specific payload.
+     *
+     * This is an escape hatch for features not covered by the normalised
+     * interface. The payload is merged with the standard messaging envelope.
+     *
+     * @param to      - Recipient PSID.
+     * @param payload - Raw Messenger API payload fields.
+     * @returns The send result.
+     */
+    async sendRaw(to, payload) {
+        const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            messaging_type: 'RESPONSE',
+            ...payload,
+        });
+        return this.toSendResult(to, response);
+    }
+    /**
+     * Mark a conversation as seen.
+     *
+     * Sends a `mark_seen` sender action to the recipient. Note that unlike
+     * WhatsApp, Messenger's mark-seen operates on the recipient (PSID) rather
+     * than a specific message ID.
+     *
+     * @param messageId - The message ID (used to identify the recipient via
+     *                    stored mapping; falls back to treating it as a PSID).
+     */
+    async markAsRead(messageId) {
+        // Messenger's mark_seen is a sender action that requires the recipient ID,
+        // not a message ID. We accept the recipient PSID here since the platform
+        // does not support marking individual messages.
+        await this.sendSenderAction(messageId, 'mark_seen');
+    }
+    /**
+     * Send a typing indicator to a recipient.
+     *
+     * Sends the `typing_on` sender action. The indicator is automatically
+     * dismissed after 20 seconds or when a message is sent.
+     *
+     * @param to - Recipient PSID.
+     */
+    async sendTypingIndicator(to) {
+        await this.sendSenderAction(to, 'typing_on');
+    }
+    // =========================================================================
+    // Messenger-specific — Templates
+    // =========================================================================
+    /**
+     * Send a button template message.
+     *
+     * Displays a text message with up to 3 buttons below it. Buttons can be
+     * postback (returns a payload to the webhook) or web URL (opens a browser).
+     *
+     * @param to       - Recipient PSID.
+     * @param template - The button template payload.
+     * @returns The send result.
+     */
+    async sendButtonTemplate(to, template) {
+        const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            messaging_type: 'RESPONSE',
+            message: {
+                attachment: {
+                    type: 'template',
+                    payload: {
+                        template_type: 'button',
+                        text: template.text,
+                        buttons: template.buttons.slice(0, 3),
+                    },
+                },
+            },
+        });
+        return this.toSendResult(to, response);
+    }
+    /**
+     * Send a generic template (carousel) message.
+     *
+     * Displays a horizontally scrollable set of cards, each with an image,
+     * title, subtitle, and optional buttons.
+     *
+     * @param to       - Recipient PSID.
+     * @param template - The generic template payload.
+     * @returns The send result.
+     */
+    async sendGenericTemplate(to, template) {
+        const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            messaging_type: 'RESPONSE',
+            message: {
+                attachment: {
+                    type: 'template',
+                    payload: {
+                        template_type: 'generic',
+                        elements: template.elements.slice(0, 10),
+                    },
+                },
+            },
+        });
+        return this.toSendResult(to, response);
+    }
+    /**
+     * Send quick reply options with a text message.
+     *
+     * Quick replies appear as pill-shaped buttons above the composer and
+     * disappear once the user taps one or types a message.
+     *
+     * @param to      - Recipient PSID.
+     * @param text    - The text message to display above the quick replies.
+     * @param replies - Array of quick reply options (max 13).
+     * @returns The send result.
+     */
+    async sendQuickReplies(to, text, replies) {
+        const response = await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            messaging_type: 'RESPONSE',
+            message: {
+                text,
+                quick_replies: replies.slice(0, 13),
+            },
+        });
+        return this.toSendResult(to, response);
+    }
+    // =========================================================================
+    // Messenger-specific — Sender Actions
+    // =========================================================================
+    /**
+     * Send a sender action (typing indicator or mark-seen).
+     *
+     * Sender actions cannot be combined with a `message` field — they must
+     * be sent as separate requests.
+     *
+     * @param to     - Recipient PSID.
+     * @param action - The sender action (`"typing_on"`, `"typing_off"`, or `"mark_seen"`).
+     */
+    async sendSenderAction(to, action) {
+        await this.graphApi.post(`${this.config.pageId}/messages`, {
+            recipient: { id: to },
+            sender_action: action,
+        });
+    }
+    // =========================================================================
+    // Messenger-specific — User Profile
+    // =========================================================================
+    /**
+     * Retrieve a user's public profile information.
+     *
+     * Returns the first name, last name, and profile picture URL for the
+     * given PSID.
+     *
+     * @param psid - The user's page-scoped ID.
+     * @returns The user's profile information.
+     */
+    async getUserProfile(psid) {
+        return this.graphApi.get(psid, {
+            fields: 'first_name,last_name,profile_pic',
+        });
+    }
+    // =========================================================================
+    // Messenger-specific — Persona API
+    // =========================================================================
+    /**
+     * Persona management operations.
+     *
+     * Personas allow the bot to respond as a named human agent with a
+     * custom profile picture. Useful for the HUMAN_AGENT message tag flow.
+     */
+    personas = {
+        /**
+         * Create a new persona for the page.
+         *
+         * @param config - The persona name and profile picture URL.
+         * @returns The created persona with its ID.
+         */
+        create: async (config) => {
+            return this.graphApi.post(`${this.config.pageId}/personas`, config);
+        },
+        /**
+         * Delete a persona.
+         *
+         * @param personaId - The persona ID to delete.
+         */
+        delete: async (personaId) => {
+            await this.graphApi.post(personaId, { _method: 'DELETE' });
+        },
+    };
+    // =========================================================================
+    // Media
+    // =========================================================================
+    /**
+     * Upload media to Messenger for later use in messages.
+     *
+     * Uses the Attachment Upload API to upload files and receive an
+     * `attachment_id` that can be reused across messages.
+     *
+     * @param file    - The file content as a Buffer or ReadableStream.
+     * @param options - Upload options including MIME type and optional filename.
+     * @returns A handle containing the platform-assigned media ID.
+     */
+    async uploadMedia(file, options) {
+        const buffer = Buffer.isBuffer(file) ? file : await streamToBuffer(file);
+        const blob = new Blob([buffer], { type: options.mimeType });
+        const attachmentType = this.resolveAttachmentType(options.mimeType);
+        const formData = new FormData();
+        formData.append('message', JSON.stringify({
+            attachment: {
+                type: attachmentType,
+                payload: { is_reusable: true },
+            },
+        }));
+        formData.append('filedata', blob, options.filename ?? 'file');
+        const response = await this.graphApi.postFormData(`${this.config.pageId}/message_attachments`, formData);
+        return { mediaId: response.attachment_id };
+    }
+    /**
+     * Download media from a URL.
+     *
+     * Messenger media URLs are typically publicly accessible (unlike WhatsApp
+     * which requires a two-step media-ID-to-URL lookup). This method fetches
+     * the binary content from the provided URL.
+     *
+     * @param mediaUrl - The media URL to download from.
+     * @returns The downloaded media content and MIME type.
+     */
+    async downloadMedia(mediaUrl) {
+        if (this.mediaCache) {
+            return this.mediaCache.getOrDownload(mediaUrl, async () => {
+                const data = await this.graphApi.fetchBinary(mediaUrl);
+                const mimeType = inferMimeType(mediaUrl);
+                return { data, mimeType };
+            });
+        }
+        const data = await this.graphApi.fetchBinary(mediaUrl);
+        // Attempt to infer MIME type from URL extension
+        const mimeType = inferMimeType(mediaUrl);
+        return { data, mimeType };
+    }
+    // =========================================================================
+    // Webhook router
+    // =========================================================================
+    /**
+     * Returns a Hono sub-application that handles webhook routes.
+     *
+     * Mounts GET (verification) and POST (event delivery) handlers at the
+     * root path. Use this to integrate the webhook into an existing Hono app.
+     *
+     * Requires `hono` to be installed as a peer dependency. The import is
+     * performed dynamically to avoid a hard compile-time dependency.
+     *
+     * @returns A Hono application with webhook routes.
+     *
+     * @example
+     * ```ts
+     * import { Hono } from 'hono';
+     *
+     * const app = new Hono();
+     * app.route('/webhooks/messenger', client.webhookRouter());
+     * ```
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    webhookRouter() {
+        // Dynamic import to avoid hard dependency on Hono at the module level.
+        // The caller must have Hono installed (it's a peer dependency via @ariaflowagents/messaging).
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const { Hono } = require('hono');
+        const router = new Hono();
+        const self = this;
+        router.all('/*', async (c) => {
+            return self.handleWebhook(c.req.raw);
+        });
+        return router;
+    }
+    // =========================================================================
+    // Private — conversion helpers
+    // =========================================================================
+    /**
+     * Convert a normalised webhook message to a platform-agnostic {@link InboundMessage}.
+     */
+    toInboundMessage(msg) {
+        const threadId = `messenger:${this.config.pageId}:${msg.from}`;
+        return {
+            id: msg.id,
+            platform: 'messenger',
+            threadId,
+            from: {
+                id: msg.from,
+                name: msg.contactName,
+            },
+            timestamp: new Date(parseInt(msg.timestamp, 10) * 1000),
+            type: this.mapMessageType(msg.type),
+            text: msg.text?.body ?? this.extractTextFallback(msg),
+            media: this.extractMedia(msg),
+            location: msg.location,
+            interactive: msg.interactive
+                ? {
+                    type: msg.interactive.type,
+                    id: msg.interactive.button_reply?.id ??
+                        msg.interactive.list_reply?.id ??
+                        '',
+                    title: msg.interactive.button_reply?.title ??
+                        msg.interactive.list_reply?.title,
+                    description: msg.interactive.list_reply?.description,
+                }
+                : undefined,
+            context: msg.context
+                ? { messageId: msg.context.message_id, from: msg.context.from }
+                : undefined,
+            raw: msg,
+        };
+    }
+    /**
+     * Convert a normalised webhook status to a platform-agnostic {@link StatusUpdate}.
+     */
+    toStatusUpdate(status) {
+        return {
+            messageId: status.id,
+            status: status.status,
+            timestamp: new Date(parseInt(status.timestamp, 10) * 1000),
+            recipientId: status.recipientId,
+            threadId: `messenger:${status.phoneNumberId}:${status.recipientId}`,
+            raw: status,
+        };
+    }
+    /**
+     * Convert a normalised webhook reaction to a platform-agnostic {@link ReactionData}.
+     */
+    toReactionData(reaction) {
+        return {
+            messageId: reaction.messageId,
+            emoji: reaction.emoji,
+            action: reaction.emoji ? 'react' : 'unreact',
+            userId: reaction.from,
+        };
+    }
+    /**
+     * Convert a {@link MessengerSendResponse} to a platform-agnostic {@link SendResult}.
+     */
+    toSendResult(to, response) {
+        return {
+            messageId: response.message_id ?? '',
+            threadId: `messenger:${this.config.pageId}:${to}`,
+            timestamp: new Date(),
+            raw: response,
+        };
+    }
+    /**
+     * Map a Messenger message type string to the normalised {@link InboundMessage} type union.
+     */
+    mapMessageType(type) {
+        const typeMap = {
+            text: 'text',
+            image: 'image',
+            video: 'video',
+            audio: 'audio',
+            file: 'document',
+            document: 'document',
+            sticker: 'sticker',
+            location: 'location',
+            postback: 'interactive',
+            interactive: 'interactive',
+            attachment: 'unknown',
+        };
+        return typeMap[type] ?? 'unknown';
+    }
+    /**
+     * Extract a text fallback from non-text message types.
+     */
+    extractTextFallback(msg) {
+        if (msg.image?.caption)
+            return msg.image.caption;
+        if (msg.video?.caption)
+            return msg.video.caption;
+        if (msg.document?.caption)
+            return msg.document.caption;
+        if (msg.button)
+            return msg.button.text;
+        if (msg.interactive?.button_reply)
+            return msg.interactive.button_reply.title;
+        if (msg.interactive?.list_reply)
+            return msg.interactive.list_reply.title;
+        if (msg.location) {
+            return msg.location.name ?? `${msg.location.latitude},${msg.location.longitude}`;
+        }
+        return undefined;
+    }
+    /**
+     * Extract a {@link MediaReference} from a normalised message if it contains media.
+     */
+    extractMedia(msg) {
+        const mediaTypes = ['image', 'video', 'audio', 'document', 'sticker'];
+        for (const type of mediaTypes) {
+            const media = msg[type];
+            if (media && ('id' in media || 'url' in media)) {
+                return {
+                    id: 'id' in media ? media.id : '',
+                    mimeType: 'mime_type' in media ? media.mime_type : undefined,
+                    url: 'url' in media ? media.url : undefined,
+                    caption: 'caption' in media ? media.caption : undefined,
+                    filename: 'filename' in media ? media.filename : undefined,
+                };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Resolve a MIME type to a Messenger attachment type string.
+     */
+    resolveAttachmentType(mimeType) {
+        if (mimeType.startsWith('image/'))
+            return 'image';
+        if (mimeType.startsWith('video/'))
+            return 'video';
+        if (mimeType.startsWith('audio/'))
+            return 'audio';
+        return 'file';
+    }
+}
+// ---------------------------------------------------------------------------
+// Utility
+// ---------------------------------------------------------------------------
+/**
+ * Convert a `ReadableStream` to a `Buffer`.
+ *
+ * @param stream - The readable stream to consume.
+ * @returns A Buffer containing all chunks from the stream.
+ */
+async function streamToBuffer(stream) {
+    const chunks = [];
+    const reader = stream.getReader();
+    for (;;) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        chunks.push(value);
+    }
+    return Buffer.concat(chunks);
+}
+/**
+ * Infer a MIME type from a URL based on file extension.
+ *
+ * @param url - The URL to infer from.
+ * @returns A best-guess MIME type, defaulting to `"application/octet-stream"`.
+ */
+function inferMimeType(url) {
+    const extMatch = url.match(/\.(\w+)(?:\?|$)/);
+    if (!extMatch)
+        return 'application/octet-stream';
+    const ext = extMatch[1].toLowerCase();
+    const mimeMap = {
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        png: 'image/png',
+        gif: 'image/gif',
+        webp: 'image/webp',
+        mp4: 'video/mp4',
+        mov: 'video/quicktime',
+        mp3: 'audio/mpeg',
+        ogg: 'audio/ogg',
+        wav: 'audio/wav',
+        pdf: 'application/pdf',
+        doc: 'application/msword',
+        docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+    };
+    return mimeMap[ext] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=client.js.map