@rawnodes/logger 2.11.0 → 2.12.0

package/dist/index.mjs

@@ -4,7 +4,7 @@ import { AsyncLocalStorage } from 'async_hooks';
 import { Transform, Writable } from 'stream';
 import { mkdir } from 'fs/promises';
 import { createStream } from 'rotating-file-stream';
-import { CloudWatchLogsClient, PutLogEventsCommand, CreateLogGroupCommand, CreateLogStreamCommand, DescribeLogStreamsCommand } from '@aws-sdk/client-cloudwatch-logs';
+import { CloudWatchLogsClient, PutLogEventsCommand, CreateLogGroupCommand, CreateLogStreamCommand } from '@aws-sdk/client-cloudwatch-logs';
 import { randomUUID } from 'crypto';
 import { z } from 'zod';
 import { relative, basename } from 'path';
@@ -645,14 +645,21 @@ function resolveLogStreamName(config, configHostname) {
   }
   return hostname$1;
 }
-var CloudWatchTransport = class extends BaseHttpTransport {
+var CloudWatchTransport = class _CloudWatchTransport extends BaseHttpTransport {
   config;
   client;
-  sequenceToken;
   initialized = false;
   initPromise = null;
+  initFailures = 0;
+  nextInitAttempt = 0;
   resolvedLogStreamName;
   maskReplacer;
+  // Backoff bounds for repeated init failures (e.g. IAM not yet propagated,
+  // throttling). Without this, a sustained outage makes every flush re-run
+  // initialize() back-to-back and hammer the CloudWatch control-plane APIs,
+  // which only deepens the throttling.
+  static INIT_BACKOFF_BASE_MS = 1e3;
+  static INIT_BACKOFF_MAX_MS = 3e4;
   constructor(config, configHostname, maskReplacerFn) {
     super({
       batchSize: config.batchSize ?? 100,
@@ -688,36 +695,46 @@ var CloudWatchTransport = class extends BaseHttpTransport {
       }, replacer)
     }));
     logEvents.sort((a, b) => (a.timestamp ?? 0) - (b.timestamp ?? 0));
-    const command = new PutLogEventsCommand({
-      logGroupName: this.config.logGroupName,
-      logStreamName: this.resolvedLogStreamName,
-      logEvents,
-      sequenceToken: this.sequenceToken
-    });
     try {
-      const response = await this.client.send(command);
-      this.sequenceToken = response.nextSequenceToken;
+      await this.putLogEvents(logEvents);
     } catch (error) {
-      if (this.isInvalidSequenceTokenError(error)) {
-        await this.fetchSequenceToken();
-        const retryCommand = new PutLogEventsCommand({
-          logGroupName: this.config.logGroupName,
-          logStreamName: this.resolvedLogStreamName,
-          logEvents,
-          sequenceToken: this.sequenceToken
-        });
-        const response = await this.client.send(retryCommand);
-        this.sequenceToken = response.nextSequenceToken;
+      if (this.isResourceNotFoundError(error)) {
+        this.initialized = false;
+        this.initPromise = null;
+        await this.ensureInitialized();
+        await this.putLogEvents(logEvents);
       } else {
         throw error;
       }
     }
   }
+  // PutLogEvents no longer requires a sequence token: since 2023 CloudWatch
+  // Logs ignores the `sequenceToken` field for sequential writes, so we omit it
+  // entirely. This also removes the need for DescribeLogStreams (and the
+  // logs:DescribeLogStreams IAM permission) on the hot path.
+  async putLogEvents(logEvents) {
+    await this.client.send(
+      new PutLogEventsCommand({
+        logGroupName: this.config.logGroupName,
+        logStreamName: this.resolvedLogStreamName,
+        logEvents
+      })
+    );
+  }
   async ensureInitialized() {
     if (this.initialized) return;
+    if (!this.initPromise && Date.now() < this.nextInitAttempt) {
+      throw new Error("CloudWatch transport initialization is backing off");
+    }
     if (!this.initPromise) {
       this.initPromise = this.initialize().catch((err) => {
         this.initPromise = null;
+        this.initFailures += 1;
+        const delay = Math.min(
+          _CloudWatchTransport.INIT_BACKOFF_MAX_MS,
+          _CloudWatchTransport.INIT_BACKOFF_BASE_MS * 2 ** (this.initFailures - 1)
+        );
+        this.nextInitAttempt = Date.now() + delay;
         throw err;
       });
     }
@@ -730,8 +747,9 @@ var CloudWatchTransport = class extends BaseHttpTransport {
     if (this.config.createLogStream !== false) {
       await this.createLogStreamIfNotExists();
     }
-    await this.fetchSequenceToken();
     this.initialized = true;
+    this.initFailures = 0;
+    this.nextInitAttempt = 0;
   }
   async createLogGroupIfNotExists() {
     try {
@@ -760,22 +778,14 @@ var CloudWatchTransport = class extends BaseHttpTransport {
       }
     }
   }
-  async fetchSequenceToken() {
-    const response = await this.client.send(
-      new DescribeLogStreamsCommand({
-        logGroupName: this.config.logGroupName,
-        logStreamNamePrefix: this.resolvedLogStreamName,
-        limit: 1
-      })
-    );
-    const stream = response.logStreams?.find((s) => s.logStreamName === this.resolvedLogStreamName);
-    this.sequenceToken = stream?.uploadSequenceToken;
-  }
   isResourceAlreadyExistsError(error) {
-    return typeof error === "object" && error !== null && "name" in error && error.name === "ResourceAlreadyExistsException";
+    return this.isAwsErrorNamed(error, "ResourceAlreadyExistsException");
+  }
+  isResourceNotFoundError(error) {
+    return this.isAwsErrorNamed(error, "ResourceNotFoundException");
   }
-  isInvalidSequenceTokenError(error) {
-    return typeof error === "object" && error !== null && "name" in error && error.name === "InvalidSequenceTokenException";
+  isAwsErrorNamed(error, name) {
+    return typeof error === "object" && error !== null && "name" in error && error.name === name;
   }
 };