@ariaflowagents/messaging-meta 0.8.1

package/dist/graph-api/errors.js

@@ -0,0 +1,72 @@
+/**
+ * @module graph-api/errors
+ *
+ * Meta-specific error classification helper.
+ *
+ * Imports the canonical error hierarchy from `@ariaflowagents/messaging` and
+ * re-exports it alongside the {@link classifyMetaError} function. This ensures
+ * that `instanceof` checks work correctly across the entire SDK — there is only
+ * ONE `WindowClosedError` class, ONE `RateLimitError` class, etc.
+ */
+import { MessagingError, RateLimitError, AuthenticationError, PermissionError, RecipientError, WindowClosedError, TemplateError, MediaError, WebhookVerificationError, } from '@ariaflowagents/messaging';
+// Re-export so consumers of this module can access the error classes.
+export { MessagingError, RateLimitError, AuthenticationError, PermissionError, RecipientError, WindowClosedError, TemplateError, MediaError, WebhookVerificationError, };
+// ---------------------------------------------------------------------------
+// Classification
+// ---------------------------------------------------------------------------
+/**
+ * Classify a Meta Graph API error response into a typed {@link MessagingError}.
+ *
+ * The mapping follows Meta's documented error codes:
+ * - 429 / codes 4, 32, 613 -> {@link RateLimitError}
+ * - 401 / code 190 -> {@link AuthenticationError}
+ * - 403 / codes 10, 200 -> {@link PermissionError}
+ * - 404 -> {@link RecipientError}
+ * - code 131047 -> {@link WindowClosedError} (24-hour window expired)
+ * - code 131026 -> {@link RecipientError} (not on WhatsApp)
+ * - codes 132000-132999 -> {@link TemplateError}
+ *
+ * @param status  - HTTP status code from the response.
+ * @param body    - Parsed JSON body (may be `null` if parsing failed).
+ * @param platform - Platform identifier (e.g. `"whatsapp"`, `"messenger"`).
+ * @returns A typed {@link MessagingError} subclass.
+ */
+export function classifyMetaError(status, body, platform) {
+    const parsed = body;
+    const err = parsed?.error;
+    const metaCode = err?.code;
+    const metaSubcode = err?.error_subcode;
+    const _fbtraceId = err?.fbtrace_id;
+    const metaMessage = err?.message ?? `Meta API error (HTTP ${status})`;
+    // --- Rate limiting (HTTP 429 or Meta codes 4, 32, 613) ---
+    if (status === 429 || metaCode === 4 || metaCode === 32 || metaCode === 613) {
+        return new RateLimitError(`Rate limited — retry after 5000ms`, platform, 5_000);
+    }
+    // --- Authentication (HTTP 401 or Meta code 190) ---
+    if (status === 401 || metaCode === 190) {
+        return new AuthenticationError(metaMessage, platform);
+    }
+    // --- Permissions (HTTP 403 or Meta codes 10, 200) ---
+    if (status === 403 || metaCode === 10 || metaCode === 200) {
+        return new PermissionError(metaMessage, platform);
+    }
+    // --- 24-hour window closed (Meta code 131047) ---
+    if (metaCode === 131047) {
+        return new WindowClosedError(metaMessage, platform, new Date());
+    }
+    // --- Recipient not reachable (HTTP 404 or Meta code 131026) ---
+    if (status === 404 || metaCode === 131026) {
+        return new RecipientError(metaMessage, platform);
+    }
+    // --- Template errors (Meta codes 132000-132999) ---
+    if (metaCode !== undefined && metaCode >= 132000 && metaCode <= 132999) {
+        return new TemplateError(metaMessage, platform);
+    }
+    // --- Template sub-code errors (some come through subcode) ---
+    if (metaSubcode !== undefined && metaSubcode >= 132000 && metaSubcode <= 132999) {
+        return new TemplateError(metaMessage, platform);
+    }
+    // --- Fallback ---
+    return new MessagingError(metaMessage, `meta_error_${metaCode ?? status}`, platform);
+}
+//# sourceMappingURL=errors.js.map

package/dist/graph-api/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/graph-api/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,wBAAwB,GACzB,MAAM,2BAA2B,CAAC;AAEnC,sEAAsE;AACtE,OAAO,EACL,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,wBAAwB,GACzB,CAAC;AAiBF,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAc,EACd,IAAa,EACb,QAAgB;IAEhB,MAAM,MAAM,GAAG,IAAgC,CAAC;IAChD,MAAM,GAAG,GAAG,MAAM,EAAE,KAAK,CAAC;IAC1B,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,CAAC;IAC3B,MAAM,WAAW,GAAG,GAAG,EAAE,aAAa,CAAC;IACvC,MAAM,UAAU,GAAG,GAAG,EAAE,UAAU,CAAC;IACnC,MAAM,WAAW,GAAG,GAAG,EAAE,OAAO,IAAI,wBAAwB,MAAM,GAAG,CAAC;IAEtE,4DAA4D;IAC5D,IAAI,MAAM,KAAK,GAAG,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAC5E,OAAO,IAAI,cAAc,CAAC,mCAAmC,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClF,CAAC;IAED,qDAAqD;IACrD,IAAI,MAAM,KAAK,GAAG,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACvC,OAAO,IAAI,mBAAmB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACxD,CAAC;IAED,uDAAuD;IACvD,IAAI,MAAM,KAAK,GAAG,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAC1D,OAAO,IAAI,eAAe,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC;IAED,mDAAmD;IACnD,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACxB,OAAO,IAAI,iBAAiB,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,iEAAiE;IACjE,IAAI,MAAM,KAAK,GAAG,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,IAAI,cAAc,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,qDAAqD;IACrD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,IAAI,MAAM,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;QACvE,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,+DAA+D;IAC/D,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,MAAM,IAAI,WAAW,IAAI,MAAM,EAAE,CAAC;QAChF,OAAO,IAAI,aAAa,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,mBAAmB;IACnB,OAAO,IAAI,cAAc,CAAC,WAAW,EAAE,cAAc,QAAQ,IAAI,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAC;AACvF,CAAC"}

package/dist/graph-api/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module graph-api
+ *
+ * Graph API sub-module — typed HTTP client, retry queue, rate limiter,
+ * and Meta-specific error classification.
+ */
+export { GraphAPIClient } from './client.js';
+export type { GraphAPIClientConfig, Logger } from './client.js';
+export { RetryQueue, DEFAULT_RETRY_CONFIG } from './retry.js';
+export type { RetryConfig } from './retry.js';
+export { RateLimiter, DEFAULT_RATE_LIMITER_CONFIG } from './rate-limiter.js';
+export type { RateLimiterConfig } from './rate-limiter.js';
+export { classifyMetaError, MessagingError, RateLimitError, AuthenticationError, PermissionError, RecipientError, WindowClosedError, TemplateError, MediaError, WebhookVerificationError, } from './errors.js';
+export type { MetaErrorResponse } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/graph-api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph-api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEhE,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,wBAAwB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/graph-api/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module graph-api
+ *
+ * Graph API sub-module — typed HTTP client, retry queue, rate limiter,
+ * and Meta-specific error classification.
+ */
+export { GraphAPIClient } from './client.js';
+export { RetryQueue, DEFAULT_RETRY_CONFIG } from './retry.js';
+export { RateLimiter, DEFAULT_RATE_LIMITER_CONFIG } from './rate-limiter.js';
+export { classifyMetaError, MessagingError, RateLimitError, AuthenticationError, PermissionError, RecipientError, WindowClosedError, TemplateError, MediaError, WebhookVerificationError, } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/graph-api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph-api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,wBAAwB,GACzB,MAAM,aAAa,CAAC"}

package/dist/graph-api/rate-limiter.d.ts

@@ -0,0 +1,90 @@
+/**
+ * @module graph-api/rate-limiter
+ *
+ * Token-bucket rate limiter with concurrency control for the Meta Graph API.
+ *
+ * The limiter enforces two constraints simultaneously:
+ * 1. **Per-second throughput** — a token bucket that refills at `perSecondLimit` tokens/s.
+ * 2. **Concurrent requests** — at most `maxConcurrent` in-flight requests.
+ *
+ * It also parses Meta's `x-business-use-case-usage` and `x-app-usage` response
+ * headers to dynamically throttle when the account is approaching platform limits.
+ */
+/** Rate limiter configuration. */
+export interface RateLimiterConfig {
+    /** Maximum number of concurrent in-flight requests. Default `40`. */
+    maxConcurrent: number;
+    /** Maximum number of requests per second (token refill rate). Default `80`. */
+    perSecondLimit: number;
+}
+/** Sensible defaults for Meta's Cloud API (Business tier). */
+export declare const DEFAULT_RATE_LIMITER_CONFIG: RateLimiterConfig;
+/**
+ * Token-bucket rate limiter with concurrency gating.
+ *
+ * Call {@link acquire} before making a request and {@link release} when the
+ * response has been fully consumed. The limiter will block callers with a
+ * promise when either the token bucket is empty or the concurrency cap is hit.
+ *
+ * @example
+ * ```ts
+ * const limiter = new RateLimiter();
+ * await limiter.acquire();
+ * try {
+ *   const res = await fetch(url);
+ *   limiter.updateFromHeaders(res.headers);
+ *   return await res.json();
+ * } finally {
+ *   limiter.release();
+ * }
+ * ```
+ */
+export declare class RateLimiter {
+    private readonly config;
+    /** Number of requests currently in-flight. */
+    private concurrent;
+    /** Available tokens in the bucket. */
+    private tokens;
+    /** Timestamp (ms) of the last token refill. */
+    private lastRefill;
+    /** FIFO queue of callers waiting for capacity. */
+    private waitQueue;
+    /**
+     * When Meta headers indicate high usage (>80 %), we temporarily halve
+     * the effective per-second limit to back off gracefully.
+     */
+    private throttled;
+    constructor(config?: Partial<RateLimiterConfig>);
+    /**
+     * Wait until a request slot is available.
+     *
+     * Resolves immediately if both a token and a concurrency slot are free.
+     * Otherwise the caller is queued and the returned promise settles when
+     * capacity becomes available.
+     */
+    acquire(): Promise<void>;
+    /**
+     * Release a concurrency slot after a request completes.
+     *
+     * Must be called exactly once for every successful {@link acquire}.
+     */
+    release(): void;
+    /**
+     * Parse Meta usage headers and enable throttling when approaching limits.
+     *
+     * Meta returns usage information in two headers:
+     * - `x-app-usage` — app-level call/CPU/memory percentages.
+     * - `x-business-use-case-usage` — per-WABA usage buckets (WhatsApp).
+     *
+     * If any reported percentage exceeds 80 %, the limiter enters a throttled
+     * state that halves the effective token refill rate.
+     *
+     * @param headers - Response headers from a Graph API call.
+     */
+    updateFromHeaders(headers: Headers): void;
+    /** Refill tokens based on elapsed wall-clock time. */
+    private refillTokens;
+    /** Attempt to wake queued callers if capacity has become available. */
+    private drain;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/graph-api/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/graph-api/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,kCAAkC;AAClC,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,8DAA8D;AAC9D,eAAO,MAAM,2BAA2B,EAAE,iBAGzC,CAAC;AAcF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAE3C,8CAA8C;IAC9C,OAAO,CAAC,UAAU,CAAK;IAEvB,sCAAsC;IACtC,OAAO,CAAC,MAAM,CAAS;IAEvB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAAS;IAE3B,kDAAkD;IAClD,OAAO,CAAC,SAAS,CAAuB;IAExC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAUnD;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB9B;;;;OAIG;IACH,OAAO,IAAI,IAAI;IAKf;;;;;;;;;;;OAWG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAyCzC,sDAAsD;IACtD,OAAO,CAAC,YAAY;IAWpB,uEAAuE;IACvE,OAAO,CAAC,KAAK;CAcd"}

package/dist/graph-api/rate-limiter.js

@@ -0,0 +1,172 @@
+/**
+ * @module graph-api/rate-limiter
+ *
+ * Token-bucket rate limiter with concurrency control for the Meta Graph API.
+ *
+ * The limiter enforces two constraints simultaneously:
+ * 1. **Per-second throughput** — a token bucket that refills at `perSecondLimit` tokens/s.
+ * 2. **Concurrent requests** — at most `maxConcurrent` in-flight requests.
+ *
+ * It also parses Meta's `x-business-use-case-usage` and `x-app-usage` response
+ * headers to dynamically throttle when the account is approaching platform limits.
+ */
+/** Sensible defaults for Meta's Cloud API (Business tier). */
+export const DEFAULT_RATE_LIMITER_CONFIG = {
+    maxConcurrent: 40,
+    perSecondLimit: 80,
+};
+// ---------------------------------------------------------------------------
+// RateLimiter
+// ---------------------------------------------------------------------------
+/**
+ * Token-bucket rate limiter with concurrency gating.
+ *
+ * Call {@link acquire} before making a request and {@link release} when the
+ * response has been fully consumed. The limiter will block callers with a
+ * promise when either the token bucket is empty or the concurrency cap is hit.
+ *
+ * @example
+ * ```ts
+ * const limiter = new RateLimiter();
+ * await limiter.acquire();
+ * try {
+ *   const res = await fetch(url);
+ *   limiter.updateFromHeaders(res.headers);
+ *   return await res.json();
+ * } finally {
+ *   limiter.release();
+ * }
+ * ```
+ */
+export class RateLimiter {
+    config;
+    /** Number of requests currently in-flight. */
+    concurrent = 0;
+    /** Available tokens in the bucket. */
+    tokens;
+    /** Timestamp (ms) of the last token refill. */
+    lastRefill;
+    /** FIFO queue of callers waiting for capacity. */
+    waitQueue = [];
+    /**
+     * When Meta headers indicate high usage (>80 %), we temporarily halve
+     * the effective per-second limit to back off gracefully.
+     */
+    throttled = false;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_RATE_LIMITER_CONFIG, ...config };
+        this.tokens = this.config.perSecondLimit;
+        this.lastRefill = Date.now();
+    }
+    // -----------------------------------------------------------------------
+    // Public API
+    // -----------------------------------------------------------------------
+    /**
+     * Wait until a request slot is available.
+     *
+     * Resolves immediately if both a token and a concurrency slot are free.
+     * Otherwise the caller is queued and the returned promise settles when
+     * capacity becomes available.
+     */
+    async acquire() {
+        this.refillTokens();
+        const effectiveLimit = this.throttled
+            ? Math.ceil(this.config.perSecondLimit / 2)
+            : this.config.perSecondLimit;
+        if (this.tokens > 0 && this.concurrent < this.config.maxConcurrent) {
+            this.tokens = Math.min(this.tokens, effectiveLimit);
+            this.tokens--;
+            this.concurrent++;
+            return;
+        }
+        // No capacity — enqueue and wait.
+        return new Promise((resolve) => {
+            this.waitQueue.push({ resolve });
+            // Schedule a wake-up check so queued requests don't starve when no
+            // release() calls arrive (e.g. all slots are token-limited, not
+            // concurrency-limited).
+            setTimeout(() => this.drain(), 1_000 / this.config.perSecondLimit);
+        });
+    }
+    /**
+     * Release a concurrency slot after a request completes.
+     *
+     * Must be called exactly once for every successful {@link acquire}.
+     */
+    release() {
+        this.concurrent = Math.max(0, this.concurrent - 1);
+        this.drain();
+    }
+    /**
+     * Parse Meta usage headers and enable throttling when approaching limits.
+     *
+     * Meta returns usage information in two headers:
+     * - `x-app-usage` — app-level call/CPU/memory percentages.
+     * - `x-business-use-case-usage` — per-WABA usage buckets (WhatsApp).
+     *
+     * If any reported percentage exceeds 80 %, the limiter enters a throttled
+     * state that halves the effective token refill rate.
+     *
+     * @param headers - Response headers from a Graph API call.
+     */
+    updateFromHeaders(headers) {
+        // --- x-app-usage ---
+        const appUsage = headers.get('x-app-usage');
+        if (appUsage) {
+            try {
+                const parsed = JSON.parse(appUsage);
+                const maxPct = Math.max(parsed.call_count ?? 0, parsed.total_cputime ?? 0, parsed.total_time ?? 0);
+                this.throttled = maxPct > 80;
+                return;
+            }
+            catch {
+                // Malformed header — ignore.
+            }
+        }
+        // --- x-business-use-case-usage ---
+        const bizUsage = headers.get('x-business-use-case-usage');
+        if (bizUsage) {
+            try {
+                const parsed = JSON.parse(bizUsage);
+                let maxPct = 0;
+                for (const buckets of Object.values(parsed)) {
+                    for (const bucket of buckets) {
+                        const rate = typeof bucket.rate_limit_usage === 'number' ? bucket.rate_limit_usage : 0;
+                        if (rate > maxPct)
+                            maxPct = rate;
+                    }
+                }
+                this.throttled = maxPct > 80;
+            }
+            catch {
+                // Malformed header — ignore.
+            }
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /** Refill tokens based on elapsed wall-clock time. */
+    refillTokens() {
+        const now = Date.now();
+        const elapsedMs = now - this.lastRefill;
+        if (elapsedMs <= 0)
+            return;
+        const tokensToAdd = (elapsedMs / 1_000) * this.config.perSecondLimit;
+        this.tokens = Math.min(this.tokens + tokensToAdd, this.config.perSecondLimit);
+        this.lastRefill = now;
+    }
+    /** Attempt to wake queued callers if capacity has become available. */
+    drain() {
+        this.refillTokens();
+        while (this.waitQueue.length > 0 &&
+            this.tokens > 0 &&
+            this.concurrent < this.config.maxConcurrent) {
+            this.tokens--;
+            this.concurrent++;
+            const next = this.waitQueue.shift();
+            next.resolve();
+        }
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/graph-api/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/graph-api/rate-limiter.ts"],"names":[],"mappings":"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"}

package/dist/graph-api/retry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @module graph-api/retry
+ *
+ * Exponential-backoff retry queue for Graph API requests.
+ *
+ * The queue wraps an async function and re-executes it on transient failures
+ * using exponential backoff with jitter. It integrates with the error hierarchy
+ * so that {@link RateLimitError}s are always retried while permanent errors
+ * (auth, permission, recipient) propagate immediately.
+ */
+/** Retry behaviour configuration. */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (does not count the initial attempt). Default `3`. */
+    maxRetries: number;
+    /** Base delay in milliseconds before the first retry. Default `1000`. */
+    baseDelayMs: number;
+    /** Upper bound on computed delay in milliseconds. Default `30000`. */
+    maxDelayMs: number;
+    /** HTTP status codes that should trigger a retry. Default `[429, 500, 502, 503, 504]`. */
+    retryableStatuses: number[];
+}
+/** Sensible defaults matching Meta's Cloud API guidance. */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+/**
+ * Retry queue that wraps an async function with exponential backoff + jitter.
+ *
+ * @example
+ * ```ts
+ * const queue = new RetryQueue({ maxRetries: 2 });
+ * const data = await queue.execute(() => fetch(url).then(r => r.json()));
+ * ```
+ */
+export declare class RetryQueue {
+    private readonly config;
+    constructor(config?: Partial<RetryConfig>);
+    /**
+     * Execute `fn` with automatic retries on transient failures.
+     *
+     * @param fn - The async operation to execute.
+     * @returns The resolved value of `fn`.
+     * @throws The last error if all retries are exhausted or the error is non-retryable.
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Determine whether an error is transient and safe to retry.
+     *
+     * - {@link RateLimitError} is always retryable.
+     * - {@link MessagingError} with a code matching `meta_error_{status}` where
+     *   status is in the `retryableStatuses` list is retryable.
+     * - Plain network errors (`TypeError` from `fetch`) are retryable.
+     * - Everything else is treated as permanent (auth, permission, recipient, template).
+     */
+    private isRetryable;
+}
+//# sourceMappingURL=retry.d.ts.map

package/dist/graph-api/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/graph-api/retry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,qCAAqC;AACrC,MAAM,WAAW,WAAW;IAC1B,0FAA0F;IAC1F,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,0FAA0F;IAC1F,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC;AAMF;;;;;;;;GAQG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM;IAI7C;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAoClD;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;CAwBpB"}

package/dist/graph-api/retry.js

@@ -0,0 +1,103 @@
+/**
+ * @module graph-api/retry
+ *
+ * Exponential-backoff retry queue for Graph API requests.
+ *
+ * The queue wraps an async function and re-executes it on transient failures
+ * using exponential backoff with jitter. It integrates with the error hierarchy
+ * so that {@link RateLimitError}s are always retried while permanent errors
+ * (auth, permission, recipient) propagate immediately.
+ */
+import { RateLimitError, MessagingError } from './errors.js';
+/** Sensible defaults matching Meta's Cloud API guidance. */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 1_000,
+    maxDelayMs: 30_000,
+    retryableStatuses: [429, 500, 502, 503, 504],
+};
+// ---------------------------------------------------------------------------
+// RetryQueue
+// ---------------------------------------------------------------------------
+/**
+ * Retry queue that wraps an async function with exponential backoff + jitter.
+ *
+ * @example
+ * ```ts
+ * const queue = new RetryQueue({ maxRetries: 2 });
+ * const data = await queue.execute(() => fetch(url).then(r => r.json()));
+ * ```
+ */
+export class RetryQueue {
+    config;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_RETRY_CONFIG, ...config };
+    }
+    /**
+     * Execute `fn` with automatic retries on transient failures.
+     *
+     * @param fn - The async operation to execute.
+     * @returns The resolved value of `fn`.
+     * @throws The last error if all retries are exhausted or the error is non-retryable.
+     */
+    async execute(fn) {
+        let lastError;
+        for (let attempt = 0; attempt <= this.config.maxRetries; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                lastError = error;
+                // If the error is not retryable or we've exhausted attempts, throw immediately.
+                if (!this.isRetryable(error) || attempt === this.config.maxRetries) {
+                    throw lastError;
+                }
+                // Compute delay with exponential backoff + random jitter (0-1 s).
+                const exponentialDelay = this.config.baseDelayMs * Math.pow(2, attempt);
+                const jitter = Math.random() * 1_000;
+                let delay = Math.min(exponentialDelay + jitter, this.config.maxDelayMs);
+                // If the error carries a specific retryAfter, honour it.
+                if (error instanceof RateLimitError && error.retryAfterMs > delay) {
+                    delay = Math.min(error.retryAfterMs, this.config.maxDelayMs);
+                }
+                await new Promise((resolve) => setTimeout(resolve, delay));
+            }
+        }
+        // TypeScript needs this even though the loop always either returns or throws.
+        throw lastError;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Determine whether an error is transient and safe to retry.
+     *
+     * - {@link RateLimitError} is always retryable.
+     * - {@link MessagingError} with a code matching `meta_error_{status}` where
+     *   status is in the `retryableStatuses` list is retryable.
+     * - Plain network errors (`TypeError` from `fetch`) are retryable.
+     * - Everything else is treated as permanent (auth, permission, recipient, template).
+     */
+    isRetryable(error) {
+        if (error instanceof RateLimitError) {
+            return true;
+        }
+        if (error instanceof MessagingError) {
+            // The classifyMetaError fallback sets code to `meta_error_{statusCode}`.
+            // Extract the status code from the error code and check if it's retryable.
+            const match = error.code.match(/^meta_error_(\d+)$/);
+            if (match) {
+                const statusCode = parseInt(match[1], 10);
+                return this.config.retryableStatuses.includes(statusCode);
+            }
+            // Known typed errors (auth, permission, recipient, template, window) are NOT retryable.
+            return false;
+        }
+        // Network-level failures thrown by `fetch` (e.g. DNS resolution, TCP reset).
+        if (error instanceof TypeError) {
+            return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/graph-api/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/graph-api/retry.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @module @ariaflowagents/messaging-meta
+ *
+ * Meta platform clients (WhatsApp, Messenger, Instagram) for AriaFlow messaging.
+ *
+ * This is the main entry point for the package. It re-exports the shared
+ * Graph API foundation (client, retry, rate limiter, errors) and the webhook
+ * utilities (signature verification, payload normalization).
+ *
+ * Platform-specific clients are available via subpath imports:
+ * - `@ariaflowagents/messaging-meta/whatsapp`
+ * - `@ariaflowagents/messaging-meta/messenger`
+ * - `@ariaflowagents/messaging-meta/instagram`
+ *
+ * Server-only utilities (verifier + normalizer without the Graph API client):
+ * - `@ariaflowagents/messaging-meta/server`
+ *
+ * @packageDocumentation
+ */
+export { GraphAPIClient } from './graph-api/client.js';
+export type { GraphAPIClientConfig, Logger } from './graph-api/client.js';
+export { RetryQueue, DEFAULT_RETRY_CONFIG } from './graph-api/retry.js';
+export type { RetryConfig } from './graph-api/retry.js';
+export { RateLimiter, DEFAULT_RATE_LIMITER_CONFIG } from './graph-api/rate-limiter.js';
+export type { RateLimiterConfig } from './graph-api/rate-limiter.js';
+export { classifyMetaError, MessagingError, RateLimitError, AuthenticationError, PermissionError, RecipientError, WindowClosedError, TemplateError, MediaError, WebhookVerificationError, } from './graph-api/errors.js';
+export type { MetaErrorResponse } from './graph-api/errors.js';
+export { verifySignature } from './webhook/verifier.js';
+export type { VerifySignatureOptions } from './webhook/verifier.js';
+export { normalizeWebhook } from './webhook/normalizer.js';
+export type { NormalizedWebhookEvents, NormalizedMessage, NormalizedStatus, NormalizedReaction, } from './webhook/normalizer.js';
+export { MessengerClient, createMessengerClient } from './messenger/index.js';
+export type { MessengerClientConfig } from './messenger/index.js';
+export { InstagramClient, createInstagramClient } from './instagram/index.js';
+export type { InstagramClientConfig } from './instagram/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AACvF,YAAY,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9E,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,38 @@
+/**
+ * @module @ariaflowagents/messaging-meta
+ *
+ * Meta platform clients (WhatsApp, Messenger, Instagram) for AriaFlow messaging.
+ *
+ * This is the main entry point for the package. It re-exports the shared
+ * Graph API foundation (client, retry, rate limiter, errors) and the webhook
+ * utilities (signature verification, payload normalization).
+ *
+ * Platform-specific clients are available via subpath imports:
+ * - `@ariaflowagents/messaging-meta/whatsapp`
+ * - `@ariaflowagents/messaging-meta/messenger`
+ * - `@ariaflowagents/messaging-meta/instagram`
+ *
+ * Server-only utilities (verifier + normalizer without the Graph API client):
+ * - `@ariaflowagents/messaging-meta/server`
+ *
+ * @packageDocumentation
+ */
+// ---------------------------------------------------------------------------
+// Graph API foundation
+// ---------------------------------------------------------------------------
+export { GraphAPIClient } from './graph-api/client.js';
+export { RetryQueue, DEFAULT_RETRY_CONFIG } from './graph-api/retry.js';
+export { RateLimiter, DEFAULT_RATE_LIMITER_CONFIG } from './graph-api/rate-limiter.js';
+export { classifyMetaError, MessagingError, RateLimitError, AuthenticationError, PermissionError, RecipientError, WindowClosedError, TemplateError, MediaError, WebhookVerificationError, } from './graph-api/errors.js';
+// ---------------------------------------------------------------------------
+// Webhook utilities
+// ---------------------------------------------------------------------------
+export { verifySignature } from './webhook/verifier.js';
+export { normalizeWebhook } from './webhook/normalizer.js';
+// ---------------------------------------------------------------------------
+// Platform clients (placeholder — will be populated as clients are built)
+// ---------------------------------------------------------------------------
+// export { WhatsAppClient } from './whatsapp/index.js';
+export { MessengerClient, createMessengerClient } from './messenger/index.js';
+export { InstagramClient, createInstagramClient } from './instagram/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAGvF,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAQ3D,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAE9E,wDAAwD;AACxD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC"}