@wildix/xbees-conversations-utils 4.0.3 → 4.1.0

package/README.md

@@ -4,8 +4,8 @@ Utility helpers for working with x-bees conversations data.
 
 ## Included modules
 
-- `email`
-  Helpers for generating and validating synthetic user emails (anonymous `anonymous-{streamId}@anonymous.wildix.com` and phone `{e164}@phone.wildix.com`).
+- `anonymousEmail`
+  Helpers for generating and validating anonymous user emails.
 - `normalization`
   Helpers for normalizing and localizing Stream payloads into `@wildix/xbees-conversations-client` models.
 - `stream`

package/dist-cjs/anonymousEmail/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAnonymousUserEmail = exports.generateAnonymousUserEmailOrThrowError = exports.ANONYMOUS_EMAIL_DOMAIN = void 0;
-exports.ANONYMOUS_EMAIL_DOMAIN = 'anonymous.wildix.com';
+exports.isAnonymousUserEmail = exports.generateAnonymousUserEmailOrThrowError = void 0;
+const ANONYMOUS_EMAIL_DOMAIN = 'anonymous.wildix.com';
 const ANONYMOUS_EMAIL_PREFIX = 'anonymous-';
 const ANONYMOUS_STREAM_ID_REGEXP = /^[0-9A-Za-z]{12}$/;
 const ANONYMOUS_USER_EMAIL_REGEXP = /^anonymous-[0-9A-Za-z]{12}@anonymous\.wildix\.com$/;
@@ -12,7 +12,7 @@ function generateAnonymousUserEmailOrThrowError(streamId) {
     if (!ANONYMOUS_STREAM_ID_REGEXP.test(streamId)) {
         throw new Error('Anonymous stream id must contain only uppercase letters, lowercase letters, digits, and have 12 symbols length');
     }
-    return `${ANONYMOUS_EMAIL_PREFIX}${streamId}@${exports.ANONYMOUS_EMAIL_DOMAIN}`;
+    return `${ANONYMOUS_EMAIL_PREFIX}${streamId}@${ANONYMOUS_EMAIL_DOMAIN}`;
 }
 exports.generateAnonymousUserEmailOrThrowError = generateAnonymousUserEmailOrThrowError;
 function isAnonymousUserEmail(value) {

package/dist-cjs/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./email"), exports);
+tslib_1.__exportStar(require("./anonymousEmail"), exports);
 tslib_1.__exportStar(require("./normalization"), exports);
 tslib_1.__exportStar(require("./stream"), exports);
 tslib_1.__exportStar(require("./types"), exports);

package/dist-cjs/normalization.js

@@ -71,6 +71,8 @@ function normalizeStreamMessage(streamMessage, channelId) {
         smsStatus: streamMessage.sms_status,
         whatsapp: streamMessage.whatsapp,
         whatsappStatus: streamMessage.whatsapp_status,
+        messenger: streamMessage.messenger,
+        messengerStatus: streamMessage.messenger_status,
         markdown: streamMessage.markdown,
         silent,
         event,
@@ -167,6 +169,10 @@ function normalizeStreamChannel(channel) {
         updatedAt: data.updated_at,
         whatsapp: data.whatsapp,
         whatsappStatus: data.whatsapp_status,
+        messenger: data.messenger,
+        messengerStatus: data.messenger_status,
+        messengerPageId: data.messenger_page_id,
+        messengerReplyUntil: data.messenger_reply_until,
         autoRecord: data.is_auto_record,
         transcriptionLanguage: data.transcription_language,
         wizyGuestViewOnly: data.is_wizy_guest_view_only,

package/dist-es/anonymousEmail/index.js

@@ -1,4 +1,4 @@
-export const ANONYMOUS_EMAIL_DOMAIN = 'anonymous.wildix.com';
+const ANONYMOUS_EMAIL_DOMAIN = 'anonymous.wildix.com';
 const ANONYMOUS_EMAIL_PREFIX = 'anonymous-';
 const ANONYMOUS_STREAM_ID_REGEXP = /^[0-9A-Za-z]{12}$/;
 const ANONYMOUS_USER_EMAIL_REGEXP = /^anonymous-[0-9A-Za-z]{12}@anonymous\.wildix\.com$/;

package/dist-es/index.js

@@ -1,4 +1,4 @@
-export * from './email';
+export * from './anonymousEmail';
 export * from './normalization';
 export * from './stream';
 export * from './types';

package/dist-es/normalization.js

@@ -65,6 +65,8 @@ export function normalizeStreamMessage(streamMessage, channelId) {
         smsStatus: streamMessage.sms_status,
         whatsapp: streamMessage.whatsapp,
         whatsappStatus: streamMessage.whatsapp_status,
+        messenger: streamMessage.messenger,
+        messengerStatus: streamMessage.messenger_status,
         markdown: streamMessage.markdown,
         silent,
         event,
@@ -159,6 +161,10 @@ export function normalizeStreamChannel(channel) {
         updatedAt: data.updated_at,
         whatsapp: data.whatsapp,
         whatsappStatus: data.whatsapp_status,
+        messenger: data.messenger,
+        messengerStatus: data.messenger_status,
+        messengerPageId: data.messenger_page_id,
+        messengerReplyUntil: data.messenger_reply_until,
         autoRecord: data.is_auto_record,
         transcriptionLanguage: data.transcription_language,
         wizyGuestViewOnly: data.is_wizy_guest_view_only,

package/dist-types/anonymousEmail/index.d.ts

@@ -1,3 +1,2 @@
-export declare const ANONYMOUS_EMAIL_DOMAIN = "anonymous.wildix.com";
 export declare function generateAnonymousUserEmailOrThrowError(streamId: string): string;
 export declare function isAnonymousUserEmail(value: string): boolean;

package/dist-types/index.d.ts

@@ -1,4 +1,4 @@
-export * from './email';
+export * from './anonymousEmail';
 export * from './normalization';
 export * from './stream';
 export * from './types';

package/dist-types/normalization.d.ts

@@ -6,6 +6,31 @@ export declare function localizeStreamUser(streamUser: StreamUserResponse): Loca
 export declare function normalizeStreamReaction(streamReaction: StreamReactionResponse): Reaction;
 export declare function normalizeStreamMessage(streamMessage: StreamMessageResponse, channelId: string): Message;
 export declare function localizeStreamMessage(streamMessage: StreamMessageResponse, channelId: string, userId: string): LocalizedMessage;
+/**
+ * The hand written field list a channel reaches a consumer through. A flag not named here is
+ * dropped on the way out, which is why `messenger` and the three fields beside it were added
+ * (WMS-26043).
+ *
+ * What publishing that addition unblocks, because the commit that made it framed the consequence
+ * as workaround removal and it is not only that. Two live reads are hard dependencies rather than
+ * workarounds, and both are dead until this package ships and is pinned:
+ *
+ * - `rnc-api src/features/webhooks/handlers/processStreamEventForWebhook.ts` computes `isKiteEvent`
+ *   from `webhookChannel?.messenger` off a channel it normalized through this package, and the
+ *   event reaches the kite queue only when that is true.
+ * - `xbees-kite src/handlers/sqs/handleSqsEvent.ts` then dispatches on
+ *   `payload.data.channel.messenger`.
+ *
+ * So with the published package an agent's reply in a Messenger channel is filtered out at rnc-api
+ * and never reaches kite: the whole slice 2 reply path is inert, not merely paying for a
+ * workaround.
+ *
+ * One claim in that commit message is stale and is corrected here rather than in history: kite's
+ * `handleMessengerInboundEvent` no longer guards its channel update with `if (!channel.messenger)`.
+ * That guard existed at 6f18e46; 3f347ef and 8dc6df2 restructured the handler and the update is now
+ * unconditional and needed for `messengerPageId`, `messengerReplyUntil` and the `messengerStatus`
+ * unset, so publishing this does not remove it.
+ */
 export declare function normalizeStreamChannel(channel: StreamChannel | StreamChannelResponse): Channel;
 export declare function normalizeStreamMember(member: StreamChannelMemberResponse): ChannelMember;
 export declare function localizeStreamMember(member: Partial<StreamChannelMemberResponse>): LocalizedChannelMember;

package/dist-types/stream.d.ts

@@ -1,4 +1,4 @@
-import type { ChannelAccess, ChannelContext, ChannelWhatsAppStatus, Element, MessageAttachment, MessageForward, MessageGiphy, MessageQuote, MessageSmsStatus, MessageWhatsAppStatus, User as NormalizedUser } from '@wildix/xbees-conversations-client';
+import type { ChannelAccess, ChannelContext, ChannelMessengerStatus, ChannelWhatsAppStatus, Element, MessageAttachment, MessageForward, MessageGiphy, MessageMessengerStatus, MessageQuote, MessageSmsStatus, MessageWhatsAppStatus, User as NormalizedUser } from '@wildix/xbees-conversations-client';
 import type { Channel, ChannelAPIResponse, ChannelData, ChannelFilters, ChannelMemberResponse, ChannelMembership, ChannelResponse, ChannelSort, ChannelState, Event, ExtendableGenerics, GetReactionsAPIResponse, GetRepliesAPIResponse, LiteralStringForUnion, Message, MessageResponse, OwnUserResponse, PartialMessageUpdate, PartialUpdateChannel, Reaction, ReactionResponse, SearchAPIResponse, SyncResponse, UpdatedMessage, UR, User, UserResponse } from 'stream-chat';
 export interface StreamChannelFields extends UR {
     subject?: string;
@@ -23,6 +23,10 @@ export interface StreamChannelFields extends UR {
     mms?: boolean;
     whatsapp?: boolean;
     whatsapp_status?: ChannelWhatsAppStatus | string;
+    messenger?: boolean;
+    messenger_status?: ChannelMessengerStatus | string;
+    messenger_page_id?: string;
+    messenger_reply_until?: number;
     broadcast?: boolean;
     is_broadcast?: boolean;
     external?: boolean;
@@ -55,6 +59,8 @@ export interface StreamMessageFields extends UR {
     sms_status?: MessageSmsStatus | string;
     whatsapp?: boolean;
     whatsapp_status?: MessageWhatsAppStatus | string;
+    messenger?: boolean;
+    messenger_status?: MessageMessengerStatus | string;
     markdown?: boolean;
     created_at: string;
     updated_at: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wildix/xbees-conversations-utils",
-  "version": "4.0.3",
+  "version": "4.1.0",
   "description": "",
   "main": "./dist-cjs/index.js",
   "module": "./dist-es/index.js",
@@ -35,7 +35,7 @@
     "downlevel-dts": "0.10.1",
     "rimraf": "^3.0.0",
     "typescript": "~5.2.2",
-    "@wildix/xbees-conversations-client": "^4.0.1"
+    "@wildix/xbees-conversations-client": "^4.0.5"
   },
   "typesVersions": {
     "<4.0": {
@@ -48,6 +48,6 @@
     "dist-*/**"
   ],
   "peerDependencies": {
-    "@wildix/xbees-conversations-client": "^4.0.1"
+    "@wildix/xbees-conversations-client": "^4.0.5"
   }
 }

package/dist-cjs/email.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPhoneUserEmail = exports.generatePhoneUserEmail = exports.isAnonymousUserEmail = exports.generateAnonymousUserEmailOrThrowError = exports.PHONE_USER_EMAIL_DOMAIN = exports.ANONYMOUS_EMAIL_DOMAIN = void 0;
-exports.ANONYMOUS_EMAIL_DOMAIN = 'anonymous.wildix.com';
-exports.PHONE_USER_EMAIL_DOMAIN = 'phone.wildix.com';
-const ANONYMOUS_EMAIL_PREFIX = 'anonymous-';
-const ANONYMOUS_STREAM_ID_REGEXP = /^[0-9A-Za-z]{12}$/;
-const ANONYMOUS_USER_EMAIL_REGEXP = /^anonymous-[0-9A-Za-z]{12}@anonymous\.wildix\.com$/;
-const PHONE_DIGITS_REGEXP = /^[0-9]{8,15}$/;
-const PHONE_USER_EMAIL_REGEXP = /^[0-9]{8,15}@phone\.wildix\.com$/;
-function generateAnonymousUserEmailOrThrowError(streamId) {
-    if (!streamId.trim()) {
-        throw new Error('Anonymous stream id must not be empty');
-    }
-    if (!ANONYMOUS_STREAM_ID_REGEXP.test(streamId)) {
-        throw new Error('Anonymous stream id must contain only uppercase letters, lowercase letters, digits, and have 12 symbols length');
-    }
-    return `${ANONYMOUS_EMAIL_PREFIX}${streamId}@${exports.ANONYMOUS_EMAIL_DOMAIN}`;
-}
-exports.generateAnonymousUserEmailOrThrowError = generateAnonymousUserEmailOrThrowError;
-function isAnonymousUserEmail(value) {
-    return ANONYMOUS_USER_EMAIL_REGEXP.test(value);
-}
-exports.isAnonymousUserEmail = isAnonymousUserEmail;
-function extractPhoneDigits(value) {
-    let normalized = value.trim();
-    if (normalized.startsWith('00')) {
-        normalized = `+${normalized.slice(2)}`;
-    }
-    return normalized.replace(/[+\s\-()]/g, '');
-}
-function generatePhoneUserEmail(e164) {
-    if (!e164.trim()) {
-        throw new Error('Phone number must not be empty');
-    }
-    const digits = extractPhoneDigits(e164);
-    if (!PHONE_DIGITS_REGEXP.test(digits)) {
-        throw new Error('Phone number must be E.164 with 8 to 15 digits');
-    }
-    return `${digits}@${exports.PHONE_USER_EMAIL_DOMAIN}`;
-}
-exports.generatePhoneUserEmail = generatePhoneUserEmail;
-function isPhoneUserEmail(value) {
-    return PHONE_USER_EMAIL_REGEXP.test(value);
-}
-exports.isPhoneUserEmail = isPhoneUserEmail;

package/dist-cjs/rateLimits/RedisCooldown.js

@@ -1,66 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', {value: true});
-exports.RedisCooldown = void 0;
-const constants_1 = require('./constants');
-
-class RedisCooldown {
-  static async getRemainingMs(cooldownKey, context) {
-    const {redis, logger} = context;
-
-    try {
-      const ttlMs = await redis.pttl(`${constants_1.STREAM_RATE_LIMIT_COOLDOWN_KEY_PREFIX}${cooldownKey}`);
-
-      if (ttlMs > 0) {
-        return ttlMs;
-      }
-    } catch (error) {
-      logger.warn('Failed to read stream rate-limit cooldown from Redis', {
-        cooldownKey,
-        error,
-      });
-    }
-
-    return 0;
-  }
-
-  static async setRemainingMs(cooldownKey, cooldownMs, context) {
-    if (cooldownMs <= 0) {
-      return;
-    }
-
-    const {redis, logger} = context;
-    const redisKey = `${constants_1.STREAM_RATE_LIMIT_COOLDOWN_KEY_PREFIX}${cooldownKey}`;
-
-    try {
-      await redis.eval(
-        `
-        local key = KEYS[1]
-        local new_ttl = tonumber(ARGV[1])
-        local current_ttl = redis.call('PTTL', key)
-
-        if current_ttl == -2 then
-          redis.call('SET', key, '1', 'PX', new_ttl)
-          return 1
-        end
-
-        if current_ttl == -1 or current_ttl < new_ttl then
-          redis.call('PEXPIRE', key, new_ttl)
-          return 2
-        end
-
-        return 0
-      `,
-        1,
-        redisKey,
-        cooldownMs.toString(),
-      );
-    } catch (error) {
-      logger.warn('Failed to write stream rate-limit cooldown to Redis', {
-        cooldownKey,
-        cooldownMs,
-        error,
-      });
-    }
-  }
-}
-exports.RedisCooldown = RedisCooldown;

package/dist-cjs/rateLimits/constants.js

@@ -1,43 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_OPTIONS = exports.SOFT_THROTTLE_DELAY_HIGH_MS = exports.SOFT_THROTTLE_DELAY_MEDIUM_MS = exports.SOFT_THROTTLE_DELAY_LOW_MS = exports.SOFT_THROTTLE_USAGE_HIGH = exports.SOFT_THROTTLE_USAGE_MEDIUM = exports.SOFT_THROTTLE_USAGE_LOW = exports.BUDGET_COOLDOWN_SLEEP_CHUNK_MS = exports.BUDGET_MINIMAL_DELAY_MAX_MS = exports.BUDGET_MINIMAL_DELAY_MIN_MS = exports.BUDGET_RELAXED_DELAY_MAX_MS = exports.BUDGET_RELAXED_DELAY_MIN_MS = exports.BUDGET_RELAXED_USAGE_THRESHOLD = exports.BUDGET_CLEAR_USAGE_THRESHOLD = exports.BUDGET_DELAY_MAX_MS = exports.BUDGET_DELAY_MIN_MS = exports.BUDGET_THRESHOLD = exports.STREAM_BUDGET_COOLDOWN_KEY = exports.STREAM_RATE_LIMIT_METADATA_KEY_SUFFIX = exports.STREAM_RATE_LIMIT_SOFT_COOLDOWN_KEY = exports.STREAM_RATE_LIMIT_OPTIONS_MARKER = exports.STREAM_BUDGET_COOLDOWN_KEY_PREFIX = exports.STREAM_RATE_LIMIT_COOLDOWN_KEY_PREFIX = exports.RETRY_AFTER_BUFFER_MS = exports.DEFAULT_JITTER_MS = exports.DEFAULT_RETRY_AFTER_MS = exports.DEFAULT_MAX_DELAY_MS = exports.STREAM_SYNC_METHOD_NAMES = exports.STREAM_SYNC_CHANNEL_RESULT_METHOD_NAMES = exports.STREAM_METHOD_NAMES = exports.STREAM_CHANNEL_RESULT_METHOD_NAMES = exports.CHANNEL_SYNC_PROXY_RESULT_METHOD_NAMES = exports.CHANNEL_SYNC_METHOD_NAMES = exports.CHANNEL_METHOD_NAMES = void 0;
-var generatedMethodNames_1 = require("./generatedMethodNames");
-Object.defineProperty(exports, "CHANNEL_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.CHANNEL_METHOD_NAMES; } });
-Object.defineProperty(exports, "CHANNEL_SYNC_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.CHANNEL_SYNC_METHOD_NAMES; } });
-Object.defineProperty(exports, "CHANNEL_SYNC_PROXY_RESULT_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.CHANNEL_SYNC_PROXY_RESULT_METHOD_NAMES; } });
-Object.defineProperty(exports, "STREAM_CHANNEL_RESULT_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.STREAM_CHANNEL_RESULT_METHOD_NAMES; } });
-Object.defineProperty(exports, "STREAM_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.STREAM_METHOD_NAMES; } });
-Object.defineProperty(exports, "STREAM_SYNC_CHANNEL_RESULT_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.STREAM_SYNC_CHANNEL_RESULT_METHOD_NAMES; } });
-Object.defineProperty(exports, "STREAM_SYNC_METHOD_NAMES", { enumerable: true, get: function () { return generatedMethodNames_1.STREAM_SYNC_METHOD_NAMES; } });
-exports.DEFAULT_MAX_DELAY_MS = 5000;
-exports.DEFAULT_RETRY_AFTER_MS = 10000;
-exports.DEFAULT_JITTER_MS = 150;
-exports.RETRY_AFTER_BUFFER_MS = 1000;
-exports.STREAM_RATE_LIMIT_COOLDOWN_KEY_PREFIX = 'stream-rate-limit-cooldown:';
-exports.STREAM_BUDGET_COOLDOWN_KEY_PREFIX = 'stream-budget-cooldown:';
-exports.STREAM_RATE_LIMIT_OPTIONS_MARKER = '__xbsRateLimitOptions';
-exports.STREAM_RATE_LIMIT_SOFT_COOLDOWN_KEY = 'stream-rate-limit-soft-global';
-exports.STREAM_RATE_LIMIT_METADATA_KEY_SUFFIX = ':meta';
-exports.STREAM_BUDGET_COOLDOWN_KEY = 'stream-budget-global';
-exports.BUDGET_THRESHOLD = 0.8;
-exports.BUDGET_DELAY_MIN_MS = 30000;
-exports.BUDGET_DELAY_MAX_MS = 60000;
-exports.BUDGET_CLEAR_USAGE_THRESHOLD = 0.6;
-exports.BUDGET_RELAXED_USAGE_THRESHOLD = 0.7;
-exports.BUDGET_RELAXED_DELAY_MIN_MS = 5000;
-exports.BUDGET_RELAXED_DELAY_MAX_MS = 10000;
-exports.BUDGET_MINIMAL_DELAY_MIN_MS = 1000;
-exports.BUDGET_MINIMAL_DELAY_MAX_MS = 2000;
-exports.BUDGET_COOLDOWN_SLEEP_CHUNK_MS = 3000;
-exports.SOFT_THROTTLE_USAGE_LOW = 0.7;
-exports.SOFT_THROTTLE_USAGE_MEDIUM = 0.85;
-exports.SOFT_THROTTLE_USAGE_HIGH = 0.95;
-exports.SOFT_THROTTLE_DELAY_LOW_MS = 500;
-exports.SOFT_THROTTLE_DELAY_MEDIUM_MS = 1500;
-exports.SOFT_THROTTLE_DELAY_HIGH_MS = 3000;
-exports.DEFAULT_OPTIONS = {
-    maxAttempts: 3,
-    enableCooldown: true,
-    maxDelayMs: 5000,
-    maxRetryableDelayMs: 10000,
-};

package/dist-cjs/rateLimits/createRateLimitedStreamProxy.js

@@ -1,92 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createRateLimitedStreamProxy = void 0;
-const constants_1 = require("./constants");
-const executeWithRateLimitHandling_1 = require("./helpers/executeWithRateLimitHandling");
-const isStreamChannelLike_1 = require("./helpers/isStreamChannelLike");
-const registerStreamInterceptors_1 = require("./helpers/registerStreamInterceptors");
-const splitCallArgsAndOptions_1 = require("./helpers/splitCallArgsAndOptions");
-const STREAM_SYNC_METHODS = new Set(constants_1.STREAM_SYNC_METHOD_NAMES);
-const STREAM_CHANNEL_RESULT_METHODS = new Set(constants_1.STREAM_CHANNEL_RESULT_METHOD_NAMES);
-const STREAM_SYNC_CHANNEL_RESULT_METHODS = new Set(constants_1.STREAM_SYNC_CHANNEL_RESULT_METHOD_NAMES);
-const CHANNEL_SYNC_METHODS = new Set(constants_1.CHANNEL_SYNC_METHOD_NAMES);
-const CHANNEL_SYNC_PROXY_RESULT_METHODS = new Set(constants_1.CHANNEL_SYNC_PROXY_RESULT_METHOD_NAMES);
-function wrapKnownChannelResult(result, dependencies) {
-    if (Array.isArray(result)) {
-        return result.map((item) => wrapKnownChannelResult(item, dependencies));
-    }
-    if (typeof result !== 'object' || result === null) {
-        return result;
-    }
-    return wrapTarget(result, dependencies);
-}
-function normalizeStreamCallResult(result, dependencies, wrapAsChannelResult = false) {
-    if (wrapAsChannelResult) {
-        return wrapKnownChannelResult(result, dependencies);
-    }
-    if (Array.isArray(result)) {
-        return result.map((item) => normalizeStreamCallResult(item, dependencies));
-    }
-    if (!(0, isStreamChannelLike_1.isStreamChannelLike)(result)) {
-        return result;
-    }
-    return wrapTarget(result, dependencies);
-}
-function createRateLimitedMethodWrapper(target, value, operation, dependencies, wrapAsChannelResult) {
-    return async (...args) => {
-        const { callArgs, callOptions } = (0, splitCallArgsAndOptions_1.splitCallArgsAndOptions)(args);
-        const result = await (0, executeWithRateLimitHandling_1.executeWithRateLimitHandling)(() => Reflect.apply(value, target, callArgs), operation, dependencies.context, {
-            ...constants_1.DEFAULT_OPTIONS,
-            ...callOptions,
-        });
-        return normalizeStreamCallResult(result, dependencies, wrapAsChannelResult);
-    };
-}
-function wrapTarget(target, dependencies) {
-    const cachedObject = dependencies.cache.get(target);
-    if (cachedObject) {
-        return cachedObject;
-    }
-    const proxy = new Proxy(target, {
-        get: (originalTarget, property, receiver) => {
-            const value = Reflect.get(originalTarget, property, receiver);
-            if (typeof property !== 'string' || typeof value !== 'function') {
-                return value;
-            }
-            if (STREAM_SYNC_CHANNEL_RESULT_METHODS.has(property)) {
-                return (...args) => {
-                    const { callArgs } = (0, splitCallArgsAndOptions_1.splitCallArgsAndOptions)(args);
-                    const result = Reflect.apply(value, originalTarget, callArgs);
-                    return normalizeStreamCallResult(result, dependencies, true);
-                };
-            }
-            if (CHANNEL_SYNC_PROXY_RESULT_METHODS.has(property)) {
-                return (...args) => {
-                    const { callArgs } = (0, splitCallArgsAndOptions_1.splitCallArgsAndOptions)(args);
-                    const result = Reflect.apply(value, originalTarget, callArgs);
-                    if (typeof result === 'object' && result !== null) {
-                        return wrapTarget(result, dependencies);
-                    }
-                    return result;
-                };
-            }
-            if (STREAM_SYNC_METHODS.has(property) || CHANNEL_SYNC_METHODS.has(property)) {
-                return (...args) => {
-                    const { callArgs } = (0, splitCallArgsAndOptions_1.splitCallArgsAndOptions)(args);
-                    return Reflect.apply(value, originalTarget, callArgs);
-                };
-            }
-            return createRateLimitedMethodWrapper(originalTarget, value, property, dependencies, STREAM_CHANNEL_RESULT_METHODS.has(property));
-        },
-    });
-    dependencies.cache.set(target, proxy);
-    return proxy;
-}
-function createRateLimitedStreamProxy(stream, context) {
-    (0, registerStreamInterceptors_1.registerStreamInterceptors)(stream, context);
-    return wrapTarget(stream, {
-        context,
-        cache: new WeakMap(),
-    });
-}
-exports.createRateLimitedStreamProxy = createRateLimitedStreamProxy;

package/dist-cjs/rateLimits/exception/createRateLimitExceededException.js

@@ -1,21 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', {value: true});
-exports.createRateLimitExceededException = void 0;
-const xbees_conversations_client_1 = require('@wildix/xbees-conversations-client');
-const constants_1 = require('../constants');
-
-function createRateLimitExceededException(options = {}) {
-  const {rateLimit, message, operation, retryAfterMs = constants_1.DEFAULT_RETRY_AFTER_MS} = options;
-  const defaultMessage = operation ? `Rate limit exceeded for ${operation}` : 'Rate limit exceeded';
-
-  return new xbees_conversations_client_1.RateLimitExceededException({
-    $metadata: {},
-    message: message || defaultMessage,
-    rateLimitRemaining: rateLimit?.remaining || 0,
-    retryAfter: rateLimit?.reset ? rateLimit.reset - Date.now() : retryAfterMs,
-    rateLimit: rateLimit?.limit?.toString() || 'unknown',
-    rateLimitReset: rateLimit?.reset || Date.now() + retryAfterMs,
-  });
-}
-
-exports.createRateLimitExceededException = createRateLimitExceededException;

package/dist-cjs/rateLimits/exception/processStreamRateLimitException.js

@@ -1,47 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', {value: true});
-exports.processStreamRateLimitException = void 0;
-const createRateLimitExceededException_1 = require('./createRateLimitExceededException');
-
-function isStreamException(error) {
-  return (
-    typeof error === 'object' &&
-    error !== null &&
-    'metadata' in error &&
-    typeof error.metadata === 'object' &&
-    error.metadata !== null &&
-    'responseCode' in error.metadata
-  );
-}
-
-function isStreamAPIException(error) {
-  return typeof error === 'object' && !!error.code;
-}
-
-function processStreamRateLimitException(error, logger) {
-  if (isStreamException(error) && error.metadata?.responseCode === 429) {
-    const rateLimit = error.metadata?.rateLimit;
-    logger.warn('Stream rate limit exceeded [StreamException]', {rateLimit});
-
-    return (0, createRateLimitExceededException_1.createRateLimitExceededException)({
-      rateLimit,
-      message: error.message || 'Rate limit exceeded',
-    });
-  }
-
-  if (isStreamAPIException(error) && (error.code === 429 || error.StatusCode === 429)) {
-    logger.warn('Stream rate limit exceeded [StreamAPIException]', {code: error.code, StatusCode: error.StatusCode});
-
-    return (0, createRateLimitExceededException_1.createRateLimitExceededException)({
-      message: error.message || 'Rate limit exceeded',
-    });
-  }
-
-  if (typeof error === 'object' && error !== null && 'status' in error && error.status === 429) {
-    logger.warn('Stream rate limit exceeded [error.status === 429]');
-
-    return (0, createRateLimitExceededException_1.createRateLimitExceededException)({message: 'Rate limit exceeded'});
-  }
-}
-
-exports.processStreamRateLimitException = processStreamRateLimitException;

package/dist-cjs/rateLimits/executeStreamRequestWithRateLimitHandling.js

@@ -1,94 +0,0 @@
-'use strict';
-Object.defineProperty(exports, '__esModule', {value: true});
-exports.executeStreamRequestWithRateLimitHandling = void 0;
-const promises_1 = require('node:timers/promises');
-const constants_1 = require('./constants');
-const createRateLimitExceededException_1 = require('./exception/createRateLimitExceededException');
-const processStreamRateLimitException_1 = require('./exception/processStreamRateLimitException');
-const RedisCooldown_1 = require('./RedisCooldown');
-
-function calculateRateLimitDelayMs(error, maxDelayMs) {
-  const retryAfterMs =
-    typeof error.retryAfter === 'number'
-      ? error.retryAfter + constants_1.RETRY_AFTER_BUFFER_MS
-      : constants_1.DEFAULT_RETRY_AFTER_MS;
-
-  if (retryAfterMs > 0) {
-    const jitterMs = Math.floor(Math.random() * constants_1.DEFAULT_JITTER_MS);
-
-    return Math.min(maxDelayMs, retryAfterMs + jitterMs);
-  }
-
-  return Math.min(maxDelayMs, constants_1.DEFAULT_FIXED_RATE_LIMIT_DELAY_MS);
-}
-
-async function executeStreamRequestWithRateLimitHandling(execute, operation, context, options = {}) {
-  const {logger, redis} = context;
-  const {enableCooldown, maxAttempts, maxDelayMs, maxRetryableDelayMs} = {
-    ...constants_1.DEFAULT_OPTS_1_ATTEMPT_NO_COOLDOWN,
-    ...options,
-  };
-  let attempt = 1;
-
-  if (enableCooldown) {
-    const cooldownMs = await RedisCooldown_1.RedisCooldown.getRemainingMs(operation, {redis, logger});
-
-    if (cooldownMs > 0) {
-      logger.warn('Skipping stream request due to active rate-limit cooldown', {
-        operation,
-        cooldown: cooldownMs,
-      });
-      throw (0, createRateLimitExceededException_1.createRateLimitExceededException)({
-        operation,
-        retryAfterMs: cooldownMs,
-      });
-    }
-  }
-
-  for (;;) {
-    try {
-      return await execute();
-    } catch (error) {
-      const rateLimitError = (0, processStreamRateLimitException_1.processStreamRateLimitException)(error, logger);
-
-      if (!rateLimitError) {
-        throw error;
-      }
-
-      const retryAfterMs = calculateRateLimitDelayMs(rateLimitError, maxDelayMs);
-
-      if (enableCooldown) {
-        await RedisCooldown_1.RedisCooldown.setRemainingMs(operation, retryAfterMs, {redis, logger});
-      }
-
-      if (attempt < maxAttempts && retryAfterMs <= maxRetryableDelayMs) {
-        logger.warn('Retrying stream request after rate limit', {
-          operation,
-          attempt,
-          maxAttempts,
-          retryAfterMs,
-          rateLimit: rateLimitError.rateLimit,
-          rateLimitRemaining: rateLimitError.rateLimitRemaining,
-          rateLimitReset: rateLimitError.rateLimitReset,
-        });
-        await (0, promises_1.setTimeout)(retryAfterMs);
-        attempt++;
-        continue;
-      }
-
-      logger.warn('Propagating stream rate limit w/o retry', {
-        operation,
-        attempt,
-        maxAttempts,
-        retryAfterMs,
-        maxRetryableDelayMs,
-        rateLimit: rateLimitError.rateLimit,
-        rateLimitRemaining: rateLimitError.rateLimitRemaining,
-        rateLimitReset: rateLimitError.rateLimitReset,
-      });
-      throw rateLimitError;
-    }
-  }
-}
-
-exports.executeStreamRequestWithRateLimitHandling = executeStreamRequestWithRateLimitHandling;