node-server-engine 1.12.3 → 1.13.0

package/dist/entities/PubSub/PubSub.d.ts

@@ -1,24 +1,38 @@
 import { Attributes } from '@google-cloud/pubsub';
 import { PubSubAddSubscriberOptions, PubSubMessageHandler, PubSubPublisherOptions } from './PubSub.types';
+/**
+ * This is a singleton service who's role is to manage pub/sub connections
+ * It is the preferred way to interact with Pub/Sub as it manages the underlying subscription and handler objects
+ * It avoids potential subscription splitting on an instance
+ */
 export declare const PubSub: {
     /**
-     * ✅ FAST + NON-BLOCKING INIT
+     * Initialize the registered publishers and subscribers
      */
     init(): Promise<void>;
     /**
-     * Shutdown
+     * Shutdown the registered publishers and subscribers
      */
     shutdown(): Promise<void>;
     /**
-     * Publisher registration
+     * Creates a publisher if it does not exist yet
+     * @param topic - Topic name or array of topic names
+     * @param options - Publisher configuration options
      */
     addPublisher(topic: string | Array<string>, options?: PubSubPublisherOptions): void;
     /**
-     * Subscriber registration
+     * Add message handlers to a subscription
+     * @param subscription - Name of the Pub/Sub subscription
+     * @param handler - Function or list of functions to set as message handlers
+     * @param options - Indicates that the additional options need to handle on Subscriber
      */
-    addSubscriber<T>(subscriptionName: string, handler: PubSubMessageHandler<T> | Array<PubSubMessageHandler<T>>, options?: PubSubAddSubscriberOptions): void;
+    addSubscriber<T>(subscription: string, handler: PubSubMessageHandler<T> | Array<PubSubMessageHandler<T>>, options?: PubSubAddSubscriberOptions): void;
     /**
-     * ✅ SAFE PUBLISH (with retry)
+     * Send a message to a Pub/Sub topic
+     * @param topic - Name of the topic
+     * @param message - Content of the message, must be an object that can be JSON stringified
+     * @param attributes - Attributes for this message, can be used to filter messages on the subscription
+     * @param orderingKey - Enforce order guarantee of messages sent with the same key
      */
     publish(topic: string, message: unknown, attributes?: Attributes, orderingKey?: string): Promise<void>;
 };

package/dist/entities/PubSub/PubSub.js

@@ -10,108 +10,151 @@ var _EngineError = require("../EngineError");
 var _LifecycleController = require("../LifecycleController");
 var _utils = require("../../utils");
 const namespace = 'engine:PubSub';
-const subscriptions = {};
-const topics = {};
-
-/**
- * Add basic retry wrapper
- */
-const withRetry = async (fn, retries = 3, delay = 500) => {
+const RETRYABLE_ERROR_CODES = new Set([4, 8, 10, 13, 14]); // DEADLINE_EXCEEDED, RESOURCE_EXHAUSTED, ABORTED, INTERNAL, UNAVAILABLE
+const resolvedProjectId = process.env.GOOGLE_CLOUD_PROJECT || process.env.GCLOUD_PROJECT || process.env.GCP_PROJECT_ID;
+function isRetryableInitError(error) {
+  const err = error;
+  const message = (err?.message ?? '').toLowerCase();
+  const code = typeof err?.code === 'string' ? Number.parseInt(err.code, 10) : err?.code;
+  return typeof code === 'number' && RETRYABLE_ERROR_CODES.has(code) || message.includes('deadline exceeded') || message.includes('timed out') || message.includes('timeout') || message.includes('unavailable') || message.includes('resource exhausted');
+}
+async function withRetry(operationName, fn) {
+  const maxAttempts = Math.max(1, Number.parseInt(process.env.PUBSUB_INIT_MAX_ATTEMPTS ?? '4', 10));
+  const baseDelayMs = Math.max(100, Number.parseInt(process.env.PUBSUB_INIT_RETRY_BASE_DELAY_MS ?? '1000', 10));
+  const maxDelayMs = Math.max(baseDelayMs, Number.parseInt(process.env.PUBSUB_INIT_RETRY_MAX_DELAY_MS ?? '10000', 10));
   let lastError;
-  for (let i = 0; i < retries; i++) {
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
     try {
       return await fn();
-    } catch (err) {
-      lastError = err;
-      await new Promise(res => setTimeout(res, delay * (i + 1)));
+    } catch (error) {
+      lastError = error;
+      if (!isRetryableInitError(error) || attempt === maxAttempts) {
+        throw error;
+      }
+      const delayMs = Math.min(baseDelayMs * 2 ** (attempt - 1), maxDelayMs);
+      (0, _utils.reportError)({
+        namespace,
+        message: `Retrying Pub/Sub init operation '${operationName}'`,
+        error: {
+          attempt,
+          maxAttempts,
+          delayMs,
+          reason: error instanceof Error ? error.message : String(error)
+        }
+      });
+      await new Promise(resolve => setTimeout(resolve, delayMs));
     }
   }
-  throw lastError;
-};
+  throw lastError instanceof Error ? lastError : new Error(`Pub/Sub init operation '${operationName}' failed after retries`);
+}
 
 /**
- * PubSub client with safer defaults
+ * Associative containing all the subscriptions sorted by topic registered for publishing
  */
-const pubSubClient = new _pubsub.PubSub({
-  apiEndpoint: 'pubsub.googleapis.com'
-});
+const subscriptions = {};
 
-/** Re-open a subscription's message stream after a transient error */
-function reattachSubscription(subscriptionName, delayMs = 5000) {
-  setTimeout(() => {
-    const entry = subscriptions[subscriptionName];
-    if (!entry) return;
-    const {
-      subscription,
-      handlers,
-      isDebezium
-    } = entry;
-    (0, _utils.reportDebug)({
-      namespace,
-      message: `Reattaching subscription '${subscriptionName}'`
-    });
+/**
+ * Associative containing all the topics registered for publishing
+ */
+const topics = {};
+const pubSubClient = new _pubsub.PubSub(resolvedProjectId ? {
+  projectId: resolvedProjectId
+} : undefined);
 
-    // Remove all existing listeners before re-adding to avoid duplicates
-    subscription.removeAllListeners('message');
-    subscription.removeAllListeners('error');
-    subscription.on('message', message => {
-      (0, _handleMessage.handleMessage)(message, subscription, handlers, isDebezium).catch(_utils.reportError);
-    });
-    subscription.on('error', error => {
-      (0, _utils.reportError)(error);
-      // Reconnect on transient errors (DEADLINE_EXCEEDED, UNAVAILABLE, INTERNAL)
-      const code = error?.code;
-      if (code === 4 || code === 14 || code === 13) {
-        reattachSubscription(subscriptionName, Math.min(delayMs * 2, 60000));
-      }
-    });
-  }, delayMs);
-}
+/**
+ * This is a singleton service who's role is to manage pub/sub connections
+ * It is the preferred way to interact with Pub/Sub as it manages the underlying subscription and handler objects
+ * It avoids potential subscription splitting on an instance
+ */
 const PubSub = exports.PubSub = {
   /**
-   * ✅ FAST + NON-BLOCKING INIT
+   * Initialize the registered publishers and subscribers
    */
   async init() {
     (0, _utils.reportDebug)({
       namespace,
-      message: `Initializing Pub/Sub (safe mode)`
+      message: `Initializing Pub/Sub`
     });
-    for (const [subscriptionName, {
+    if (!resolvedProjectId) {
+      (0, _utils.reportDebug)({
+        namespace,
+        message: 'Pub/Sub projectId not set in env, relying on ADC auto-detection'
+      });
+    }
+    const skipValidation = process.env.PUBSUB_SKIP_VALIDATION?.toLowerCase() === 'true';
+    // Check that all topics/permissions exist, and that we have permission on them
+    if (!skipValidation) {
+      await Promise.all([
+      // Test that all topics actually exist and that we have permissions
+      ...Object.values(topics).map(async topic => {
+        const [exists] = await withRetry(`topic.exists:${topic.name}`, async () => topic.exists());
+        if (!exists) throw new _EngineError.EngineError(`Topic ${topic.name} does not exist`);
+        // Test permission ton publish to topic
+        const [permissions] = await withRetry(`topic.permissions:${topic.name}`, async () => topic.iam.testPermissions(['pubsub.topics.publish']));
+        const hasPermissions = Object.values(permissions).every(success => success);
+        if (!hasPermissions) throw new _EngineError.EngineError(`Instance does not have appropriate permissions to publish to topic ${topic.name}`);
+      }),
+      // Test that all subscriptions actually exist and that we have permissions
+      ...Object.values(subscriptions).map(async ({
+        subscription
+      }) => {
+        const [exists] = await withRetry(`subscription.exists:${subscription.name}`, async () => subscription.exists());
+        if (!exists) throw new _EngineError.EngineError(`Subscription ${subscription.name} does not exist`);
+        // Test permission ton consume subscription
+        const [permissions] = await withRetry(`subscription.permissions:${subscription.name}`, async () => subscription.iam.testPermissions(['pubsub.subscriptions.consume']));
+        const hasPermissions = Object.values(permissions).every(success => success);
+        if (!hasPermissions) throw new _EngineError.EngineError(`Instance does not have appropriate permissions to subscribe to subscription ${subscription.name}`);
+      })]);
+    } else {
+      (0, _utils.reportDebug)({
+        namespace,
+        message: 'Skipping Pub/Sub existence and permission validation (PUBSUB_SKIP_VALIDATION=true)'
+      });
+    }
+
+    // Register handlers on the subscriptions to activate them
+    for (const {
       subscription,
       handlers,
       isDebezium
-    }] of Object.entries(subscriptions)) {
+    } of Object.values(subscriptions)) {
       subscription.on('message', message => {
-        (0, _handleMessage.handleMessage)(message, subscription, handlers, isDebezium).catch(_utils.reportError);
+        (0, _handleMessage.handleMessage)(message, subscription, handlers, isDebezium).catch(error => {
+          (0, _utils.reportError)(error);
+        });
       });
       subscription.on('error', error => {
-        (0, _utils.reportError)(error);
-        // Auto-reconnect on transient gRPC errors (DEADLINE_EXCEEDED=4, UNAVAILABLE=14, INTERNAL=13)
-        const code = error?.code;
-        if (code === 4 || code === 14 || code === 13) {
-          reattachSubscription(subscriptionName, 5000);
-        }
+        (0, _utils.reportError)({
+          namespace,
+          message: `Pub/Sub subscription stream error on '${subscription.name}'`,
+          error
+        });
       });
     }
     _LifecycleController.LifecycleController.register(PubSub);
   },
   /**
-   * Shutdown
+   * Shutdown the registered publishers and subscribers
    */
   async shutdown() {
     (0, _utils.reportDebug)({
       namespace,
       message: `Shutting down Pub/Sub`
     });
+    // Flush all pending messages and shut down connections
     await Promise.all([...Object.values(topics).map(async topic => topic.flush()), ...Object.values(subscriptions).map(async ({
       subscription
     }) => subscription.close())]);
+    // Delete the stored topics/subscriptions
     Object.keys(topics).forEach(topic => delete topics[topic]);
     Object.keys(subscriptions).forEach(subscription => delete subscriptions[subscription]);
+    // Close the client
     await pubSubClient.close();
   },
   /**
-   * Publisher registration
+   * Creates a publisher if it does not exist yet
+   * @param topic - Topic name or array of topic names
+   * @param options - Publisher configuration options
    */
   addPublisher(topic, options) {
     const topicArray = topic instanceof Array ? topic : [topic];
@@ -120,68 +163,104 @@ const PubSub = exports.PubSub = {
       message: `Registering publisher for topics '${topicArray.join("', '")}'`,
       data: options
     });
+    // Register a new topic if it does not exist yet
     for (const topic of topicArray) {
-      if (!topics[topic]) {
+      if (!Object.keys(topics).includes(topic)) {
         topics[topic] = pubSubClient.topic(topic, {
           enableOpenTelemetryTracing: true,
           messageOrdering: options?.enableMessageOrdering ?? false,
           batching: options?.batching ? {
             maxMessages: options.batching.maxMessages ?? 100,
             maxBytes: options.batching.maxBytes ?? 1024 * 1024,
+            // 1MB
             maxMilliseconds: options.batching.maxMilliseconds ?? 100
+          } : undefined,
+          gaxOpts: options?.retry ? {
+            retry: {
+              retryCodes: [10, 14],
+              // ABORTED, UNAVAILABLE
+              backoffSettings: {
+                initialRetryDelayMillis: options.retry.initialDelayMillis ?? 100,
+                maxRetryDelayMillis: options.retry.maxDelayMillis ?? 60000,
+                retryDelayMultiplier: options.retry.delayMultiplier ?? 1.3,
+                initialRpcTimeoutMillis: 60000,
+                maxRpcTimeoutMillis: 600000,
+                rpcTimeoutMultiplier: 1.0,
+                totalTimeoutMillis: 600000
+              }
+            }
           } : undefined
         });
       }
     }
   },
   /**
-   * Subscriber registration
+   * Add message handlers to a subscription
+   * @param subscription - Name of the Pub/Sub subscription
+   * @param handler - Function or list of functions to set as message handlers
+   * @param options - Indicates that the additional options need to handle on Subscriber
    */
-  addSubscriber(subscriptionName, handler, options = {}) {
+  addSubscriber(subscription, handler, options = {}) {
     const handlers = handler instanceof Array ? handler : [handler];
+    const isDebezium = options?.isDebezium ?? false;
+    const first = options?.first ?? false;
+    const flowControl = options?.flowControl;
+    const ackDeadline = options?.ackDeadline;
     (0, _utils.reportDebug)({
       namespace,
-      message: `Registering subscriber '${subscriptionName}'`,
-      data: options
+      message: `Registering subscriber for subscription '${subscription}'`,
+      data: {
+        first,
+        handlersCount: handlers.length,
+        isDebezium,
+        flowControl
+      }
     });
-    if (!subscriptions[subscriptionName]) {
-      subscriptions[subscriptionName] = {
-        subscription: pubSubClient.subscription(subscriptionName, {
+    if (!Object.keys(subscriptions).includes(subscription)) {
+      subscriptions[subscription] = {
+        subscription: pubSubClient.subscription(subscription, {
           enableOpenTelemetryTracing: true,
-          flowControl: options.flowControl ?? {
+          flowControl: flowControl ? {
+            maxMessages: flowControl.maxMessages ?? 1000,
+            maxBytes: flowControl.maxBytes ?? 100 * 1024 * 1024,
+            // 100MB
+            allowExcessMessages: flowControl.allowExcessMessages ?? true
+          } : {
             maxMessages: 1000,
             maxBytes: 100 * 1024 * 1024,
             allowExcessMessages: true
           },
-          ackDeadline: options.ackDeadline ?? 60
+          ackDeadline: ackDeadline ?? 60
         }),
-        handlers: [],
-        isDebezium: options?.isDebezium ?? false
+        handlers: []
       };
     }
-    if (options.first) subscriptions[subscriptionName].handlers.push(...handlers);else subscriptions[subscriptionName].handlers.unshift(...handlers);
+    if (isDebezium) subscriptions[subscription].isDebezium = true;
+    if (first) subscriptions[subscription].handlers.push(...handlers);else subscriptions[subscription].handlers.unshift(...handlers);
   },
   /**
-   * ✅ SAFE PUBLISH (with retry)
+   * Send a message to a Pub/Sub topic
+   * @param topic - Name of the topic
+   * @param message - Content of the message, must be an object that can be JSON stringified
+   * @param attributes - Attributes for this message, can be used to filter messages on the subscription
+   * @param orderingKey - Enforce order guarantee of messages sent with the same key
    */
   async publish(topic, message, attributes, orderingKey) {
-    if (!topics[topic]) {
-      throw new _EngineError.EngineError(`No publisher registered for topic '${topic}'`);
-    }
+    if (!topics[topic]) throw new _EngineError.EngineError(`No publisher was registered for topic '${topic}'`);
     (0, _utils.reportDebug)({
       namespace,
-      message: `Publishing to '${topic}'`,
+      message: `Sending message to topic '${topic}'`,
       data: {
         message,
         attributes,
         orderingKey
       }
     });
-    await withRetry(() => topics[topic].publishMessage({
+    await topics[topic].publishMessage({
       json: message,
       attributes,
       orderingKey
-    }));
+    });
   }
 };
 //# sourceMappingURL=PubSub.js.map

package/dist/entities/PubSub/PubSub.js.map

@@ -1 +1 @@
-{"version":3,"file":"PubSub.js","names":["_pubsub","require","_handleMessage","_EngineError","_LifecycleController","_utils","namespace","subscriptions","topics","withRetry","fn","retries","delay","lastError","i","err","Promise","res","setTimeout","pubSubClient","PubsubClient","apiEndpoint","reattachSubscription","subscriptionName","delayMs","entry","subscription","handlers","isDebezium","reportDebug","message","removeAllListeners","on","handleMessage","catch","reportError","error","code","Math","min","PubSub","exports","init","Object","entries","LifecycleController","register","shutdown","all","values","map","topic","flush","close","keys","forEach","addPublisher","options","topicArray","Array","join","data","enableOpenTelemetryTracing","messageOrdering","enableMessageOrdering","batching","maxMessages","maxBytes","maxMilliseconds","undefined","addSubscriber","handler","flowControl","allowExcessMessages","ackDeadline","first","push","unshift","publish","attributes","orderingKey","EngineError","publishMessage","json"],"sources":["../../../src/entities/PubSub/PubSub.ts"],"sourcesContent":["import {\n  Attributes,\n  PubSub as PubsubClient,\n  Message\n} from '@google-cloud/pubsub';\nimport { handleMessage } from './handleMessage';\nimport {\n  PubSubTopicsMap,\n  PubSubSubscriptionsMap,\n  PubSubAddSubscriberOptions,\n  PubSubMessageHandler,\n  PubSubPublisherOptions\n} from './PubSub.types';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { reportDebug, reportError } from 'utils';\n\nconst namespace = 'engine:PubSub';\n\nconst subscriptions: PubSubSubscriptionsMap = {};\nconst topics: PubSubTopicsMap = {};\n\n/**\n * Add basic retry wrapper\n */\nconst withRetry = async <T>(\n  fn: () => Promise<T>,\n  retries = 3,\n  delay = 500\n): Promise<T> => {\n  let lastError: any;\n  for (let i = 0; i < retries; i++) {\n    try {\n      return await fn();\n    } catch (err) {\n      lastError = err;\n      await new Promise((res) => setTimeout(res, delay * (i + 1)));\n    }\n  }\n  throw lastError;\n};\n\n/**\n * PubSub client with safer defaults\n */\nconst pubSubClient = new PubsubClient({\n  apiEndpoint: 'pubsub.googleapis.com'\n});\n\n/** Re-open a subscription's message stream after a transient error */\nfunction reattachSubscription(subscriptionName: string, delayMs = 5000): void {\n  setTimeout(() => {\n    const entry = subscriptions[subscriptionName];\n    if (!entry) return;\n    const { subscription, handlers, isDebezium } = entry;\n\n    reportDebug({ namespace, message: `Reattaching subscription '${subscriptionName}'` });\n\n    // Remove all existing listeners before re-adding to avoid duplicates\n    subscription.removeAllListeners('message');\n    subscription.removeAllListeners('error');\n\n    subscription.on('message', (message) => {\n      handleMessage(message as Message, subscription, handlers, isDebezium).catch(reportError);\n    });\n\n    subscription.on('error', (error) => {\n      reportError(error);\n      // Reconnect on transient errors (DEADLINE_EXCEEDED, UNAVAILABLE, INTERNAL)\n      const code = (error as any)?.code;\n      if (code === 4 || code === 14 || code === 13) {\n        reattachSubscription(subscriptionName, Math.min(delayMs * 2, 60000));\n      }\n    });\n  }, delayMs);\n}\n\nexport const PubSub = {\n  /**\n   * ✅ FAST + NON-BLOCKING INIT\n   */\n  async init(): Promise<void> {\n    reportDebug({ namespace, message: `Initializing Pub/Sub (safe mode)` });\n\n    for (const [subscriptionName, { subscription, handlers, isDebezium }] of Object.entries(\n      subscriptions\n    )) {\n      subscription.on('message', (message) => {\n        handleMessage(\n          message as Message,\n          subscription,\n          handlers,\n          isDebezium\n        ).catch(reportError);\n      });\n\n      subscription.on('error', (error) => {\n        reportError(error);\n        // Auto-reconnect on transient gRPC errors (DEADLINE_EXCEEDED=4, UNAVAILABLE=14, INTERNAL=13)\n        const code = (error as any)?.code;\n        if (code === 4 || code === 14 || code === 13) {\n          reattachSubscription(subscriptionName, 5000);\n        }\n      });\n    }\n\n    LifecycleController.register(PubSub);\n  },\n\n  /**\n   * Shutdown\n   */\n  async shutdown(): Promise<void> {\n    reportDebug({ namespace, message: `Shutting down Pub/Sub` });\n\n    await Promise.all([\n      ...Object.values(topics).map(async (topic) => topic.flush()),\n      ...Object.values(subscriptions).map(async ({ subscription }) =>\n        subscription.close()\n      )\n    ]);\n\n    Object.keys(topics).forEach((topic) => delete topics[topic]);\n    Object.keys(subscriptions).forEach(\n      (subscription) => delete subscriptions[subscription]\n    );\n\n    await pubSubClient.close();\n  },\n\n  /**\n   * Publisher registration\n   */\n  addPublisher(\n    topic: string | Array<string>,\n    options?: PubSubPublisherOptions\n  ): void {\n    const topicArray = topic instanceof Array ? topic : [topic];\n\n    reportDebug({\n      namespace,\n      message: `Registering publisher for topics '${topicArray.join(\"', '\")}'`,\n      data: options\n    });\n\n    for (const topic of topicArray) {\n      if (!topics[topic]) {\n        topics[topic] = pubSubClient.topic(topic, {\n          enableOpenTelemetryTracing: true,\n          messageOrdering: options?.enableMessageOrdering ?? false,\n          batching: options?.batching\n            ? {\n                maxMessages: options.batching.maxMessages ?? 100,\n                maxBytes: options.batching.maxBytes ?? 1024 * 1024,\n                maxMilliseconds: options.batching.maxMilliseconds ?? 100\n              }\n            : undefined\n        });\n      }\n    }\n  },\n\n  /**\n   * Subscriber registration\n   */\n  addSubscriber<T>(\n    subscriptionName: string,\n    handler: PubSubMessageHandler<T> | Array<PubSubMessageHandler<T>>,\n    options: PubSubAddSubscriberOptions = {}\n  ): void {\n    const handlers = handler instanceof Array ? handler : [handler];\n\n    reportDebug({\n      namespace,\n      message: `Registering subscriber '${subscriptionName}'`,\n      data: options\n    });\n\n    if (!subscriptions[subscriptionName]) {\n      subscriptions[subscriptionName] = {\n        subscription: pubSubClient.subscription(subscriptionName, {\n          enableOpenTelemetryTracing: true,\n          flowControl: options.flowControl ?? {\n            maxMessages: 1000,\n            maxBytes: 100 * 1024 * 1024,\n            allowExcessMessages: true\n          },\n          ackDeadline: options.ackDeadline ?? 60\n        }),\n        handlers: [],\n        isDebezium: options?.isDebezium ?? false\n      };\n    }\n\n    if (options.first)\n      subscriptions[subscriptionName].handlers.push(...handlers);\n    else subscriptions[subscriptionName].handlers.unshift(...handlers);\n  },\n\n  /**\n   * ✅ SAFE PUBLISH (with retry)\n   */\n  async publish(\n    topic: string,\n    message: unknown,\n    attributes?: Attributes,\n    orderingKey?: string\n  ): Promise<void> {\n    if (!topics[topic]) {\n      throw new EngineError(`No publisher registered for topic '${topic}'`);\n    }\n\n    reportDebug({\n      namespace,\n      message: `Publishing to '${topic}'`,\n      data: { message, attributes, orderingKey }\n    });\n\n    await withRetry(() =>\n      topics[topic].publishMessage({\n        json: message,\n        attributes,\n        orderingKey\n      })\n    );\n  }\n};"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"PubSub.js","names":["_pubsub","require","_handleMessage","_EngineError","_LifecycleController","_utils","namespace","RETRYABLE_ERROR_CODES","Set","resolvedProjectId","process","env","GOOGLE_CLOUD_PROJECT","GCLOUD_PROJECT","GCP_PROJECT_ID","isRetryableInitError","error","err","message","toLowerCase","code","Number","parseInt","has","includes","withRetry","operationName","fn","maxAttempts","Math","max","PUBSUB_INIT_MAX_ATTEMPTS","baseDelayMs","PUBSUB_INIT_RETRY_BASE_DELAY_MS","maxDelayMs","PUBSUB_INIT_RETRY_MAX_DELAY_MS","lastError","attempt","delayMs","min","reportError","reason","Error","String","Promise","resolve","setTimeout","subscriptions","topics","pubSubClient","PubsubClient","projectId","undefined","PubSub","exports","init","reportDebug","skipValidation","PUBSUB_SKIP_VALIDATION","all","Object","values","map","topic","exists","name","EngineError","permissions","iam","testPermissions","hasPermissions","every","success","subscription","handlers","isDebezium","on","handleMessage","catch","LifecycleController","register","shutdown","flush","close","keys","forEach","addPublisher","options","topicArray","Array","join","data","enableOpenTelemetryTracing","messageOrdering","enableMessageOrdering","batching","maxMessages","maxBytes","maxMilliseconds","gaxOpts","retry","retryCodes","backoffSettings","initialRetryDelayMillis","initialDelayMillis","maxRetryDelayMillis","maxDelayMillis","retryDelayMultiplier","delayMultiplier","initialRpcTimeoutMillis","maxRpcTimeoutMillis","rpcTimeoutMultiplier","totalTimeoutMillis","addSubscriber","handler","first","flowControl","ackDeadline","handlersCount","length","allowExcessMessages","push","unshift","publish","attributes","orderingKey","publishMessage","json"],"sources":["../../../src/entities/PubSub/PubSub.ts"],"sourcesContent":["import {\n  Attributes,\n  PubSub as PubsubClient,\n  Message\n} from '@google-cloud/pubsub';\nimport { handleMessage } from './handleMessage';\nimport {\n  PubSubTopicsMap,\n  PubSubSubscriptionsMap,\n  PubSubAddSubscriberOptions,\n  PubSubMessageHandler,\n  PubSubPublisherOptions\n} from './PubSub.types';\nimport { EngineError } from 'entities/EngineError';\nimport { LifecycleController } from 'entities/LifecycleController';\nimport { reportDebug, reportError } from 'utils';\n\nconst namespace = 'engine:PubSub';\nconst RETRYABLE_ERROR_CODES = new Set([4, 8, 10, 13, 14]); // DEADLINE_EXCEEDED, RESOURCE_EXHAUSTED, ABORTED, INTERNAL, UNAVAILABLE\nconst resolvedProjectId =\n  process.env.GOOGLE_CLOUD_PROJECT ||\n  process.env.GCLOUD_PROJECT ||\n  process.env.GCP_PROJECT_ID;\n\nfunction isRetryableInitError(error: unknown): boolean {\n  const err = error as { code?: number | string; message?: string } | undefined;\n  const message = (err?.message ?? '').toLowerCase();\n  const code =\n    typeof err?.code === 'string' ? Number.parseInt(err.code, 10) : err?.code;\n  return (\n    (typeof code === 'number' && RETRYABLE_ERROR_CODES.has(code)) ||\n    message.includes('deadline exceeded') ||\n    message.includes('timed out') ||\n    message.includes('timeout') ||\n    message.includes('unavailable') ||\n    message.includes('resource exhausted')\n  );\n}\n\nasync function withRetry<T>(\n  operationName: string,\n  fn: () => Promise<T>\n): Promise<T> {\n  const maxAttempts = Math.max(\n    1,\n    Number.parseInt(process.env.PUBSUB_INIT_MAX_ATTEMPTS ?? '4', 10)\n  );\n  const baseDelayMs = Math.max(\n    100,\n    Number.parseInt(process.env.PUBSUB_INIT_RETRY_BASE_DELAY_MS ?? '1000', 10)\n  );\n  const maxDelayMs = Math.max(\n    baseDelayMs,\n    Number.parseInt(process.env.PUBSUB_INIT_RETRY_MAX_DELAY_MS ?? '10000', 10)\n  );\n  let lastError: unknown;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      lastError = error;\n      if (!isRetryableInitError(error) || attempt === maxAttempts) {\n        throw error;\n      }\n      const delayMs = Math.min(baseDelayMs * 2 ** (attempt - 1), maxDelayMs);\n      reportError({\n        namespace,\n        message: `Retrying Pub/Sub init operation '${operationName}'`,\n        error: {\n          attempt,\n          maxAttempts,\n          delayMs,\n          reason: error instanceof Error ? error.message : String(error)\n        }\n      });\n      await new Promise((resolve) => setTimeout(resolve, delayMs));\n    }\n  }\n\n  throw lastError instanceof Error\n    ? lastError\n    : new Error(\n        `Pub/Sub init operation '${operationName}' failed after retries`\n      );\n}\n\n/**\n * Associative containing all the subscriptions sorted by topic registered for publishing\n */\nconst subscriptions: PubSubSubscriptionsMap = {};\n\n/**\n * Associative containing all the topics registered for publishing\n */\nconst topics: PubSubTopicsMap = {};\n\nconst pubSubClient = new PubsubClient(\n  resolvedProjectId ? { projectId: resolvedProjectId } : undefined\n);\n\n/**\n * This is a singleton service who's role is to manage pub/sub connections\n * It is the preferred way to interact with Pub/Sub as it manages the underlying subscription and handler objects\n * It avoids potential subscription splitting on an instance\n */\nexport const PubSub = {\n  /**\n   * Initialize the registered publishers and subscribers\n   */\n  async init(): Promise<void> {\n    reportDebug({ namespace, message: `Initializing Pub/Sub` });\n    if (!resolvedProjectId) {\n      reportDebug({\n        namespace,\n        message:\n          'Pub/Sub projectId not set in env, relying on ADC auto-detection'\n      });\n    }\n    const skipValidation =\n      process.env.PUBSUB_SKIP_VALIDATION?.toLowerCase() === 'true';\n    // Check that all topics/permissions exist, and that we have permission on them\n    if (!skipValidation) {\n      await Promise.all([\n      // Test that all topics actually exist and that we have permissions\n      ...Object.values(topics).map(async (topic) => {\n        const [exists] = await withRetry(\n          `topic.exists:${topic.name}`,\n          async () => topic.exists()\n        );\n        if (!exists)\n          throw new EngineError(`Topic ${topic.name} does not exist`);\n        // Test permission ton publish to topic\n        const [permissions] = await withRetry(\n          `topic.permissions:${topic.name}`,\n          async () => topic.iam.testPermissions(['pubsub.topics.publish'])\n        );\n        const hasPermissions = Object.values(permissions).every(\n          (success) => success\n        );\n        if (!hasPermissions)\n          throw new EngineError(\n            `Instance does not have appropriate permissions to publish to topic ${topic.name}`\n          );\n      }),\n      // Test that all subscriptions actually exist and that we have permissions\n      ...Object.values(subscriptions).map(async ({ subscription }) => {\n        const [exists] = await withRetry(\n          `subscription.exists:${subscription.name}`,\n          async () => subscription.exists()\n        );\n        if (!exists)\n          throw new EngineError(\n            `Subscription ${subscription.name} does not exist`\n          );\n        // Test permission ton consume subscription\n        const [permissions] = await withRetry(\n          `subscription.permissions:${subscription.name}`,\n          async () =>\n            subscription.iam.testPermissions(['pubsub.subscriptions.consume'])\n        );\n        const hasPermissions = Object.values(permissions).every(\n          (success) => success\n        );\n        if (!hasPermissions)\n          throw new EngineError(\n            `Instance does not have appropriate permissions to subscribe to subscription ${subscription.name}`\n          );\n      })\n    ]);\n    } else {\n      reportDebug({\n        namespace,\n        message:\n          'Skipping Pub/Sub existence and permission validation (PUBSUB_SKIP_VALIDATION=true)'\n      });\n    }\n\n    // Register handlers on the subscriptions to activate them\n    for (const { subscription, handlers, isDebezium } of Object.values(\n      subscriptions\n    )) {\n      subscription.on('message', (message) => {\n        handleMessage(\n          message as Message,\n          subscription,\n          handlers,\n          isDebezium\n        ).catch((error) => {\n          reportError(error);\n        });\n      });\n      subscription.on('error', (error) => {\n        reportError({\n          namespace,\n          message: `Pub/Sub subscription stream error on '${subscription.name}'`,\n          error\n        });\n      });\n    }\n\n    LifecycleController.register(PubSub);\n  },\n\n  /**\n   * Shutdown the registered publishers and subscribers\n   */\n  async shutdown(): Promise<void> {\n    reportDebug({ namespace, message: `Shutting down Pub/Sub` });\n    // Flush all pending messages and shut down connections\n    await Promise.all([\n      ...Object.values(topics).map(async (topic) => topic.flush()),\n      ...Object.values(subscriptions).map(async ({ subscription }) =>\n        subscription.close()\n      )\n    ]);\n    // Delete the stored topics/subscriptions\n    Object.keys(topics).forEach((topic) => delete topics[topic]);\n    Object.keys(subscriptions).forEach(\n      (subscription) => delete subscriptions[subscription]\n    );\n    // Close the client\n    await pubSubClient.close();\n  },\n\n  /**\n   * Creates a publisher if it does not exist yet\n   * @param topic - Topic name or array of topic names\n   * @param options - Publisher configuration options\n   */\n  addPublisher(\n    topic: string | Array<string>,\n    options?: PubSubPublisherOptions\n  ): void {\n    const topicArray = topic instanceof Array ? topic : [topic];\n    reportDebug({\n      namespace,\n      message: `Registering publisher for topics '${topicArray.join(\"', '\")}'`,\n      data: options\n    });\n    // Register a new topic if it does not exist yet\n    for (const topic of topicArray) {\n      if (!Object.keys(topics).includes(topic)) {\n        topics[topic] = pubSubClient.topic(topic, {\n          enableOpenTelemetryTracing: true,\n          messageOrdering: options?.enableMessageOrdering ?? false,\n          batching: options?.batching\n            ? {\n                maxMessages: options.batching.maxMessages ?? 100,\n                maxBytes: options.batching.maxBytes ?? 1024 * 1024, // 1MB\n                maxMilliseconds: options.batching.maxMilliseconds ?? 100\n              }\n            : undefined,\n          gaxOpts: options?.retry\n            ? {\n                retry: {\n                  retryCodes: [10, 14], // ABORTED, UNAVAILABLE\n                  backoffSettings: {\n                    initialRetryDelayMillis:\n                      options.retry.initialDelayMillis ?? 100,\n                    maxRetryDelayMillis: options.retry.maxDelayMillis ?? 60000,\n                    retryDelayMultiplier: options.retry.delayMultiplier ?? 1.3,\n                    initialRpcTimeoutMillis: 60000,\n                    maxRpcTimeoutMillis: 600000,\n                    rpcTimeoutMultiplier: 1.0,\n                    totalTimeoutMillis: 600000\n                  }\n                }\n              }\n            : undefined\n        });\n      }\n    }\n  },\n\n  /**\n   * Add message handlers to a subscription\n   * @param subscription - Name of the Pub/Sub subscription\n   * @param handler - Function or list of functions to set as message handlers\n   * @param options - Indicates that the additional options need to handle on Subscriber\n   */\n  addSubscriber<T>(\n    subscription: string,\n    handler: PubSubMessageHandler<T> | Array<PubSubMessageHandler<T>>,\n    options: PubSubAddSubscriberOptions = {}\n  ): void {\n    const handlers = handler instanceof Array ? handler : [handler];\n    const isDebezium = options?.isDebezium ?? false;\n    const first = options?.first ?? false;\n    const flowControl = options?.flowControl;\n    const ackDeadline = options?.ackDeadline;\n\n    reportDebug({\n      namespace,\n      message: `Registering subscriber for subscription '${subscription}'`,\n      data: {\n        first,\n        handlersCount: handlers.length,\n        isDebezium,\n        flowControl\n      }\n    });\n    if (!Object.keys(subscriptions).includes(subscription)) {\n      subscriptions[subscription] = {\n        subscription: pubSubClient.subscription(subscription, {\n          enableOpenTelemetryTracing: true,\n          flowControl: flowControl\n            ? {\n                maxMessages: flowControl.maxMessages ?? 1000,\n                maxBytes: flowControl.maxBytes ?? 100 * 1024 * 1024, // 100MB\n                allowExcessMessages: flowControl.allowExcessMessages ?? true\n              }\n            : {\n                maxMessages: 1000,\n                maxBytes: 100 * 1024 * 1024,\n                allowExcessMessages: true\n              },\n          ackDeadline: ackDeadline ?? 60\n        }),\n        handlers: []\n      };\n    }\n\n    if (isDebezium) subscriptions[subscription].isDebezium = true;\n\n    if (first) subscriptions[subscription].handlers.push(...handlers);\n    else subscriptions[subscription].handlers.unshift(...handlers);\n  },\n\n  /**\n   * Send a message to a Pub/Sub topic\n   * @param topic - Name of the topic\n   * @param message - Content of the message, must be an object that can be JSON stringified\n   * @param attributes - Attributes for this message, can be used to filter messages on the subscription\n   * @param orderingKey - Enforce order guarantee of messages sent with the same key\n   */\n  async publish(\n    topic: string,\n    message: unknown,\n    attributes?: Attributes,\n    orderingKey?: string\n  ): Promise<void> {\n    if (!topics[topic])\n      throw new EngineError(`No publisher was registered for topic '${topic}'`);\n    reportDebug({\n      namespace,\n      message: `Sending message to topic '${topic}'`,\n      data: { message, attributes, orderingKey }\n    });\n    await topics[topic].publishMessage({\n      json: message,\n      attributes,\n      orderingKey\n    });\n  }\n};\n"],"mappings":";;;;;;AAAA,IAAAA,OAAA,GAAAC,OAAA;AAKA,IAAAC,cAAA,GAAAD,OAAA;AAQA,IAAAE,YAAA,GAAAF,OAAA;AACA,IAAAG,oBAAA,GAAAH,OAAA;AACA,IAAAI,MAAA,GAAAJ,OAAA;AAEA,MAAMK,SAAS,GAAG,eAAe;AACjC,MAAMC,qBAAqB,GAAG,IAAIC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3D,MAAMC,iBAAiB,GACrBC,OAAO,CAACC,GAAG,CAACC,oBAAoB,IAChCF,OAAO,CAACC,GAAG,CAACE,cAAc,IAC1BH,OAAO,CAACC,GAAG,CAACG,cAAc;AAE5B,SAASC,oBAAoBA,CAACC,KAAc,EAAW;EACrD,MAAMC,GAAG,GAAGD,KAAiE;EAC7E,MAAME,OAAO,GAAG,CAACD,GAAG,EAAEC,OAAO,IAAI,EAAE,EAAEC,WAAW,CAAC,CAAC;EAClD,MAAMC,IAAI,GACR,OAAOH,GAAG,EAAEG,IAAI,KAAK,QAAQ,GAAGC,MAAM,CAACC,QAAQ,CAACL,GAAG,CAACG,IAAI,EAAE,EAAE,CAAC,GAAGH,GAAG,EAAEG,IAAI;EAC3E,OACG,OAAOA,IAAI,KAAK,QAAQ,IAAIb,qBAAqB,CAACgB,GAAG,CAACH,IAAI,CAAC,IAC5DF,OAAO,CAACM,QAAQ,CAAC,mBAAmB,CAAC,IACrCN,OAAO,CAACM,QAAQ,CAAC,WAAW,CAAC,IAC7BN,OAAO,CAACM,QAAQ,CAAC,SAAS,CAAC,IAC3BN,OAAO,CAACM,QAAQ,CAAC,aAAa,CAAC,IAC/BN,OAAO,CAACM,QAAQ,CAAC,oBAAoB,CAAC;AAE1C;AAEA,eAAeC,SAASA,CACtBC,aAAqB,EACrBC,EAAoB,EACR;EACZ,MAAMC,WAAW,GAAGC,IAAI,CAACC,GAAG,CAC1B,CAAC,EACDT,MAAM,CAACC,QAAQ,CAACZ,OAAO,CAACC,GAAG,CAACoB,wBAAwB,IAAI,GAAG,EAAE,EAAE,CACjE,CAAC;EACD,MAAMC,WAAW,GAAGH,IAAI,CAACC,GAAG,CAC1B,GAAG,EACHT,MAAM,CAACC,QAAQ,CAACZ,OAAO,CAACC,GAAG,CAACsB,+BAA+B,IAAI,MAAM,EAAE,EAAE,CAC3E,CAAC;EACD,MAAMC,UAAU,GAAGL,IAAI,CAACC,GAAG,CACzBE,WAAW,EACXX,MAAM,CAACC,QAAQ,CAACZ,OAAO,CAACC,GAAG,CAACwB,8BAA8B,IAAI,OAAO,EAAE,EAAE,CAC3E,CAAC;EACD,IAAIC,SAAkB;EAEtB,KAAK,IAAIC,OAAO,GAAG,CAAC,EAAEA,OAAO,IAAIT,WAAW,EAAES,OAAO,EAAE,EAAE;IACvD,IAAI;MACF,OAAO,MAAMV,EAAE,CAAC,CAAC;IACnB,CAAC,CAAC,OAAOX,KAAK,EAAE;MACdoB,SAAS,GAAGpB,KAAK;MACjB,IAAI,CAACD,oBAAoB,CAACC,KAAK,CAAC,IAAIqB,OAAO,KAAKT,WAAW,EAAE;QAC3D,MAAMZ,KAAK;MACb;MACA,MAAMsB,OAAO,GAAGT,IAAI,CAACU,GAAG,CAACP,WAAW,GAAG,CAAC,KAAKK,OAAO,GAAG,CAAC,CAAC,EAAEH,UAAU,CAAC;MACtE,IAAAM,kBAAW,EAAC;QACVlC,SAAS;QACTY,OAAO,EAAE,oCAAoCQ,aAAa,GAAG;QAC7DV,KAAK,EAAE;UACLqB,OAAO;UACPT,WAAW;UACXU,OAAO;UACPG,MAAM,EAAEzB,KAAK,YAAY0B,KAAK,GAAG1B,KAAK,CAACE,OAAO,GAAGyB,MAAM,CAAC3B,KAAK;QAC/D;MACF,CAAC,CAAC;MACF,MAAM,IAAI4B,OAAO,CAAEC,OAAO,IAAKC,UAAU,CAACD,OAAO,EAAEP,OAAO,CAAC,CAAC;IAC9D;EACF;EAEA,MAAMF,SAAS,YAAYM,KAAK,GAC5BN,SAAS,GACT,IAAIM,KAAK,CACP,2BAA2BhB,aAAa,wBAC1C,CAAC;AACP;;AAEA;AACA;AACA;AACA,MAAMqB,aAAqC,GAAG,CAAC,CAAC;;AAEhD;AACA;AACA;AACA,MAAMC,MAAuB,GAAG,CAAC,CAAC;AAElC,MAAMC,YAAY,GAAG,IAAIC,cAAY,CACnCzC,iBAAiB,GAAG;EAAE0C,SAAS,EAAE1C;AAAkB,CAAC,GAAG2C,SACzD,CAAC;;AAED;AACA;AACA;AACA;AACA;AACO,MAAMC,MAAM,GAAAC,OAAA,CAAAD,MAAA,GAAG;EACpB;AACF;AACA;EACE,MAAME,IAAIA,CAAA,EAAkB;IAC1B,IAAAC,kBAAW,EAAC;MAAElD,SAAS;MAAEY,OAAO,EAAE;IAAuB,CAAC,CAAC;IAC3D,IAAI,CAACT,iBAAiB,EAAE;MACtB,IAAA+C,kBAAW,EAAC;QACVlD,SAAS;QACTY,OAAO,EACL;MACJ,CAAC,CAAC;IACJ;IACA,MAAMuC,cAAc,GAClB/C,OAAO,CAACC,GAAG,CAAC+C,sBAAsB,EAAEvC,WAAW,CAAC,CAAC,KAAK,MAAM;IAC9D;IACA,IAAI,CAACsC,cAAc,EAAE;MACnB,MAAMb,OAAO,CAACe,GAAG,CAAC;MAClB;MACA,GAAGC,MAAM,CAACC,MAAM,CAACb,MAAM,CAAC,CAACc,GAAG,CAAC,MAAOC,KAAK,IAAK;QAC5C,MAAM,CAACC,MAAM,CAAC,GAAG,MAAMvC,SAAS,CAC9B,gBAAgBsC,KAAK,CAACE,IAAI,EAAE,EAC5B,YAAYF,KAAK,CAACC,MAAM,CAAC,CAC3B,CAAC;QACD,IAAI,CAACA,MAAM,EACT,MAAM,IAAIE,wBAAW,CAAC,SAASH,KAAK,CAACE,IAAI,iBAAiB,CAAC;QAC7D;QACA,MAAM,CAACE,WAAW,CAAC,GAAG,MAAM1C,SAAS,CACnC,qBAAqBsC,KAAK,CAACE,IAAI,EAAE,EACjC,YAAYF,KAAK,CAACK,GAAG,CAACC,eAAe,CAAC,CAAC,uBAAuB,CAAC,CACjE,CAAC;QACD,MAAMC,cAAc,GAAGV,MAAM,CAACC,MAAM,CAACM,WAAW,CAAC,CAACI,KAAK,CACpDC,OAAO,IAAKA,OACf,CAAC;QACD,IAAI,CAACF,cAAc,EACjB,MAAM,IAAIJ,wBAAW,CACnB,sEAAsEH,KAAK,CAACE,IAAI,EAClF,CAAC;MACL,CAAC,CAAC;MACF;MACA,GAAGL,MAAM,CAACC,MAAM,CAACd,aAAa,CAAC,CAACe,GAAG,CAAC,OAAO;QAAEW;MAAa,CAAC,KAAK;QAC9D,MAAM,CAACT,MAAM,CAAC,GAAG,MAAMvC,SAAS,CAC9B,uBAAuBgD,YAAY,CAACR,IAAI,EAAE,EAC1C,YAAYQ,YAAY,CAACT,MAAM,CAAC,CAClC,CAAC;QACD,IAAI,CAACA,MAAM,EACT,MAAM,IAAIE,wBAAW,CACnB,gBAAgBO,YAAY,CAACR,IAAI,iBACnC,CAAC;QACH;QACA,MAAM,CAACE,WAAW,CAAC,GAAG,MAAM1C,SAAS,CACnC,4BAA4BgD,YAAY,CAACR,IAAI,EAAE,EAC/C,YACEQ,YAAY,CAACL,GAAG,CAACC,eAAe,CAAC,CAAC,8BAA8B,CAAC,CACrE,CAAC;QACD,MAAMC,cAAc,GAAGV,MAAM,CAACC,MAAM,CAACM,WAAW,CAAC,CAACI,KAAK,CACpDC,OAAO,IAAKA,OACf,CAAC;QACD,IAAI,CAACF,cAAc,EACjB,MAAM,IAAIJ,wBAAW,CACnB,+EAA+EO,YAAY,CAACR,IAAI,EAClG,CAAC;MACL,CAAC,CAAC,CACH,CAAC;IACF,CAAC,MAAM;MACL,IAAAT,kBAAW,EAAC;QACVlD,SAAS;QACTY,OAAO,EACL;MACJ,CAAC,CAAC;IACJ;;IAEA;IACA,KAAK,MAAM;MAAEuD,YAAY;MAAEC,QAAQ;MAAEC;IAAW,CAAC,IAAIf,MAAM,CAACC,MAAM,CAChEd,aACF,CAAC,EAAE;MACD0B,YAAY,CAACG,EAAE,CAAC,SAAS,EAAG1D,OAAO,IAAK;QACtC,IAAA2D,4BAAa,EACX3D,OAAO,EACPuD,YAAY,EACZC,QAAQ,EACRC,UACF,CAAC,CAACG,KAAK,CAAE9D,KAAK,IAAK;UACjB,IAAAwB,kBAAW,EAACxB,KAAK,CAAC;QACpB,CAAC,CAAC;MACJ,CAAC,CAAC;MACFyD,YAAY,CAACG,EAAE,CAAC,OAAO,EAAG5D,KAAK,IAAK;QAClC,IAAAwB,kBAAW,EAAC;UACVlC,SAAS;UACTY,OAAO,EAAE,yCAAyCuD,YAAY,CAACR,IAAI,GAAG;UACtEjD;QACF,CAAC,CAAC;MACJ,CAAC,CAAC;IACJ;IAEA+D,wCAAmB,CAACC,QAAQ,CAAC3B,MAAM,CAAC;EACtC,CAAC;EAED;AACF;AACA;EACE,MAAM4B,QAAQA,CAAA,EAAkB;IAC9B,IAAAzB,kBAAW,EAAC;MAAElD,SAAS;MAAEY,OAAO,EAAE;IAAwB,CAAC,CAAC;IAC5D;IACA,MAAM0B,OAAO,CAACe,GAAG,CAAC,CAChB,GAAGC,MAAM,CAACC,MAAM,CAACb,MAAM,CAAC,CAACc,GAAG,CAAC,MAAOC,KAAK,IAAKA,KAAK,CAACmB,KAAK,CAAC,CAAC,CAAC,EAC5D,GAAGtB,MAAM,CAACC,MAAM,CAACd,aAAa,CAAC,CAACe,GAAG,CAAC,OAAO;MAAEW;IAAa,CAAC,KACzDA,YAAY,CAACU,KAAK,CAAC,CACrB,CAAC,CACF,CAAC;IACF;IACAvB,MAAM,CAACwB,IAAI,CAACpC,MAAM,CAAC,CAACqC,OAAO,CAAEtB,KAAK,IAAK,OAAOf,MAAM,CAACe,KAAK,CAAC,CAAC;IAC5DH,MAAM,CAACwB,IAAI,CAACrC,aAAa,CAAC,CAACsC,OAAO,CAC/BZ,YAAY,IAAK,OAAO1B,aAAa,CAAC0B,YAAY,CACrD,CAAC;IACD;IACA,MAAMxB,YAAY,CAACkC,KAAK,CAAC,CAAC;EAC5B,CAAC;EAED;AACF;AACA;AACA;AACA;EACEG,YAAYA,CACVvB,KAA6B,EAC7BwB,OAAgC,EAC1B;IACN,MAAMC,UAAU,GAAGzB,KAAK,YAAY0B,KAAK,GAAG1B,KAAK,GAAG,CAACA,KAAK,CAAC;IAC3D,IAAAP,kBAAW,EAAC;MACVlD,SAAS;MACTY,OAAO,EAAE,qCAAqCsE,UAAU,CAACE,IAAI,CAAC,MAAM,CAAC,GAAG;MACxEC,IAAI,EAAEJ;IACR,CAAC,CAAC;IACF;IACA,KAAK,MAAMxB,KAAK,IAAIyB,UAAU,EAAE;MAC9B,IAAI,CAAC5B,MAAM,CAACwB,IAAI,CAACpC,MAAM,CAAC,CAACxB,QAAQ,CAACuC,KAAK,CAAC,EAAE;QACxCf,MAAM,CAACe,KAAK,CAAC,GAAGd,YAAY,CAACc,KAAK,CAACA,KAAK,EAAE;UACxC6B,0BAA0B,EAAE,IAAI;UAChCC,eAAe,EAAEN,OAAO,EAAEO,qBAAqB,IAAI,KAAK;UACxDC,QAAQ,EAAER,OAAO,EAAEQ,QAAQ,GACvB;YACEC,WAAW,EAAET,OAAO,CAACQ,QAAQ,CAACC,WAAW,IAAI,GAAG;YAChDC,QAAQ,EAAEV,OAAO,CAACQ,QAAQ,CAACE,QAAQ,IAAI,IAAI,GAAG,IAAI;YAAE;YACpDC,eAAe,EAAEX,OAAO,CAACQ,QAAQ,CAACG,eAAe,IAAI;UACvD,CAAC,GACD9C,SAAS;UACb+C,OAAO,EAAEZ,OAAO,EAAEa,KAAK,GACnB;YACEA,KAAK,EAAE;cACLC,UAAU,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;cAAE;cACtBC,eAAe,EAAE;gBACfC,uBAAuB,EACrBhB,OAAO,CAACa,KAAK,CAACI,kBAAkB,IAAI,GAAG;gBACzCC,mBAAmB,EAAElB,OAAO,CAACa,KAAK,CAACM,cAAc,IAAI,KAAK;gBAC1DC,oBAAoB,EAAEpB,OAAO,CAACa,KAAK,CAACQ,eAAe,IAAI,GAAG;gBAC1DC,uBAAuB,EAAE,KAAK;gBAC9BC,mBAAmB,EAAE,MAAM;gBAC3BC,oBAAoB,EAAE,GAAG;gBACzBC,kBAAkB,EAAE;cACtB;YACF;UACF,CAAC,GACD5D;QACN,CAAC,CAAC;MACJ;IACF;EACF,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;EACE6D,aAAaA,CACXxC,YAAoB,EACpByC,OAAiE,EACjE3B,OAAmC,GAAG,CAAC,CAAC,EAClC;IACN,MAAMb,QAAQ,GAAGwC,OAAO,YAAYzB,KAAK,GAAGyB,OAAO,GAAG,CAACA,OAAO,CAAC;IAC/D,MAAMvC,UAAU,GAAGY,OAAO,EAAEZ,UAAU,IAAI,KAAK;IAC/C,MAAMwC,KAAK,GAAG5B,OAAO,EAAE4B,KAAK,IAAI,KAAK;IACrC,MAAMC,WAAW,GAAG7B,OAAO,EAAE6B,WAAW;IACxC,MAAMC,WAAW,GAAG9B,OAAO,EAAE8B,WAAW;IAExC,IAAA7D,kBAAW,EAAC;MACVlD,SAAS;MACTY,OAAO,EAAE,4CAA4CuD,YAAY,GAAG;MACpEkB,IAAI,EAAE;QACJwB,KAAK;QACLG,aAAa,EAAE5C,QAAQ,CAAC6C,MAAM;QAC9B5C,UAAU;QACVyC;MACF;IACF,CAAC,CAAC;IACF,IAAI,CAACxD,MAAM,CAACwB,IAAI,CAACrC,aAAa,CAAC,CAACvB,QAAQ,CAACiD,YAAY,CAAC,EAAE;MACtD1B,aAAa,CAAC0B,YAAY,CAAC,GAAG;QAC5BA,YAAY,EAAExB,YAAY,CAACwB,YAAY,CAACA,YAAY,EAAE;UACpDmB,0BAA0B,EAAE,IAAI;UAChCwB,WAAW,EAAEA,WAAW,GACpB;YACEpB,WAAW,EAAEoB,WAAW,CAACpB,WAAW,IAAI,IAAI;YAC5CC,QAAQ,EAAEmB,WAAW,CAACnB,QAAQ,IAAI,GAAG,GAAG,IAAI,GAAG,IAAI;YAAE;YACrDuB,mBAAmB,EAAEJ,WAAW,CAACI,mBAAmB,IAAI;UAC1D,CAAC,GACD;YACExB,WAAW,EAAE,IAAI;YACjBC,QAAQ,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;YAC3BuB,mBAAmB,EAAE;UACvB,CAAC;UACLH,WAAW,EAAEA,WAAW,IAAI;QAC9B,CAAC,CAAC;QACF3C,QAAQ,EAAE;MACZ,CAAC;IACH;IAEA,IAAIC,UAAU,EAAE5B,aAAa,CAAC0B,YAAY,CAAC,CAACE,UAAU,GAAG,IAAI;IAE7D,IAAIwC,KAAK,EAAEpE,aAAa,CAAC0B,YAAY,CAAC,CAACC,QAAQ,CAAC+C,IAAI,CAAC,GAAG/C,QAAQ,CAAC,CAAC,KAC7D3B,aAAa,CAAC0B,YAAY,CAAC,CAACC,QAAQ,CAACgD,OAAO,CAAC,GAAGhD,QAAQ,CAAC;EAChE,CAAC;EAED;AACF;AACA;AACA;AACA;AACA;AACA;EACE,MAAMiD,OAAOA,CACX5D,KAAa,EACb7C,OAAgB,EAChB0G,UAAuB,EACvBC,WAAoB,EACL;IACf,IAAI,CAAC7E,MAAM,CAACe,KAAK,CAAC,EAChB,MAAM,IAAIG,wBAAW,CAAC,0CAA0CH,KAAK,GAAG,CAAC;IAC3E,IAAAP,kBAAW,EAAC;MACVlD,SAAS;MACTY,OAAO,EAAE,6BAA6B6C,KAAK,GAAG;MAC9C4B,IAAI,EAAE;QAAEzE,OAAO;QAAE0G,UAAU;QAAEC;MAAY;IAC3C,CAAC,CAAC;IACF,MAAM7E,MAAM,CAACe,KAAK,CAAC,CAAC+D,cAAc,CAAC;MACjCC,IAAI,EAAE7G,OAAO;MACb0G,UAAU;MACVC;IACF,CAAC,CAAC;EACJ;AACF,CAAC","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "node-server-engine",
-  "version": "1.12.3",
+  "version": "1.13.0",
   "description": "Framework used to develop backend services. This package ships with a lot of features to standardize the creation of services, letting you focus on the business logic.",
   "main": "dist/index.js",
   "scripts": {