@richardmcquiston01/error-log-adapter 0.8.0 → 0.10.0

package/dist/index.d.cts

@@ -127,6 +127,15 @@ declare class WebhookErrorAdapter<TCode extends string = string> implements Erro
     /** @throws {RangeError} if `url` is not a valid `https://` URL (see `allowInsecure`) or a timeout, retry or signing option is invalid. */
     constructor(url: string, options?: WebhookErrorOptions);
     log(entry: ErrorLogEntry<TCode>): Promise<ErrorLogResult>;
+    /**
+     * Sends several entries in one request, as a JSON array of the same records
+     * `log` sends one at a time (each with an `id`). `BatchingErrorAdapter` uses
+     * this when it wraps a webhook, so the receiver must accept an array. The
+     * whole request succeeds or fails together.
+     */
+    logBatch(entries: ErrorLogEntry<TCode>[]): Promise<ErrorLogResult>;
+    /** Sends one prepared body, trying again as `retries` allows. */
+    private deliver;
     /** Milliseconds to wait before retry number `retryNumber` (1 for the first). */
     private retryWaitMs;
     private send;
@@ -793,9 +802,16 @@ interface FirebaseErrorRecord {
  */
 interface FirestoreCollectionLike {
     doc(documentId: string): {
-        set(data: FirebaseErrorRecord): Promise<unknown>;
+        set(data: FirestoreErrorRecord): Promise<unknown>;
     };
 }
+/**
+ * What the Firestore adapter writes: the usual fields, plus the expiry field
+ * (a `Date`, which Firestore stores as a timestamp) when `expireAfterMs` is set.
+ */
+type FirestoreErrorRecord = FirebaseErrorRecord & {
+    [field: string]: unknown;
+};
 /**
  * The only thing the Realtime Database adapter needs from a reference:
  * `push(value)`, which resolves once the write is saved. A `firebase-admin`
@@ -834,6 +850,25 @@ interface FirebaseErrorOptions {
     /** Text printed before failure messages. Defaults to `[error-log-adapter]`. */
     prefix?: string;
 }
+interface FirestoreErrorOptions extends FirebaseErrorOptions {
+    /**
+     * Add an expiry time to every document: the entry's `timestamp` plus this
+     * many milliseconds, stored as a Firestore timestamp in `expireField`. This
+     * only writes the field. Firestore deletes nothing until you turn on a TTL
+     * policy for that field, for example:
+     *
+     * ```sh
+     * gcloud firestore fields ttls update expire_at \
+     *   --collection-group=error_log --enable-ttl
+     * ```
+     *
+     * Firestore then removes documents some time after they expire (typically
+     * within a day), and the deletes are billed like any other. Off by default.
+     */
+    expireAfterMs?: number;
+    /** Name of the expiry field. Defaults to `expire_at`. Only used with `expireAfterMs`. */
+    expireField?: string;
+}
 /**
  * Writes each entry as a document in a Firestore collection. The document id is
  * the entry's UUID, so the SDK finishing one queued write twice cannot create two
@@ -846,8 +881,10 @@ declare class FirestoreErrorAdapter<TCode extends string = string> implements Er
     private readonly collection;
     private readonly prefix;
     private readonly timeoutMs;
-    /** @throws {RangeError} if `options.timeoutMs` is not a positive number or `Infinity`. */
-    constructor(collection: FirestoreCollectionLike, options?: FirebaseErrorOptions);
+    private readonly expireAfterMs;
+    private readonly expireField;
+    /** @throws {RangeError} if `options.timeoutMs` is not a positive number or `Infinity`, or the expiry options are invalid. */
+    constructor(collection: FirestoreCollectionLike, options?: FirestoreErrorOptions);
     log(entry: ErrorLogEntry<TCode>): Promise<ErrorLogResult>;
 }
 /**
@@ -1175,4 +1212,123 @@ declare class CloudWatchLogsErrorAdapter<TCode extends string = string> implemen
     private fail;
 }
 
-export { type CloudWatchBatchOptions, type CloudWatchLogEvent, type CloudWatchLogsClientLike, CloudWatchLogsErrorAdapter, type CloudWatchLogsErrorOptions, type CloudWatchPutLogEventsInput, type CollectionLike, CompositeErrorAdapter, type CompositeErrorOptions, ConsoleErrorAdapter, type ConsoleErrorOptions, type EmitterLike, type ErrorLogAdapter, type ErrorLogEntry, type ErrorLogResult, EventEmitterErrorAdapter, type EventEmitterErrorOptions, type EventEmitterErrorRecord, type FileSystemLike, type FirebaseErrorOptions, type FirebaseErrorRecord, type FirestoreCollectionLike, FirestoreErrorAdapter, FlatFileErrorAdapter, type FlatFileErrorOptions, type IdbDatabaseLike, type IdbObjectStoreLike, type IdbRequestLike, type IdbTransactionLike, type IdbUpgradeDatabaseLike, IndexedDbErrorAdapter, type IndexedDbErrorOptions, type IndexedDbErrorRecord, JsonFileErrorAdapter, type JsonFileErrorOptions, type JsonFileErrorRecord, type LockManagerLike, MongoDbErrorAdapter, type MongoDbErrorOptions, MySqlErrorAdapter, PostgresErrorAdapter, type ReadWriteFileSystemLike, RealtimeDatabaseErrorAdapter, type RealtimeDatabaseRefLike, type RedisClientLike, RedisErrorAdapter, type RedisErrorOptions, type S3BatchOptions, type S3ClientLike, S3ErrorAdapter, type S3ErrorOptions, type S3PutObjectInput, type SerializedErrorLogEntry, type SqlClientLike, type SqlDialect, type SqlErrorOptions, type SqliteClientLike, SqliteErrorAdapter, type SqliteErrorOptions, type StorageLike, type SupabaseClientLike, SupabaseErrorAdapter, type SupabaseErrorLike, type SupabaseErrorOptions, type SupabaseErrorRow, type SupabaseInsertResult, type SupabaseSetupOptions, WebSocketErrorAdapter, type WebSocketErrorOptions, type WebSocketLike, WebStorageErrorAdapter, type WebStorageErrorOptions, type WebStorageErrorRecord, WebhookErrorAdapter, type WebhookErrorOptions, buildCreateErrorLogTableSql, buildErrorLogTableDdl, buildMySqlWidenColumnsSql, buildSupabaseSetupSql, createErrorLogStore, formatErrorLogLine, serializeCause, serializeEntry };
+/**
+ * An adapter that can send several entries in one go, such as
+ * `WebhookErrorAdapter` (one request carrying a JSON array).
+ * `BatchingErrorAdapter` uses it when it is there. The whole batch succeeds or
+ * fails together.
+ */
+interface BatchCapableAdapter<TCode extends string = string> extends ErrorLogAdapter<TCode> {
+    logBatch(entries: ErrorLogEntry<TCode>[]): Promise<ErrorLogResult>;
+}
+interface BatchingErrorOptions<TCode extends string = string> {
+    /** Deliver once this many entries are waiting. Defaults to 20. */
+    batchSize?: number;
+    /**
+     * Also deliver once the oldest waiting entry has waited this long (ms).
+     * Defaults to 5000. Pass `Infinity` to deliver only when `batchSize` is
+     * reached or `flush()` is called. The timer does not keep the process alive,
+     * so call `flush()` before exiting.
+     */
+    maxWaitMs?: number;
+    /**
+     * How many times to try an entry again after a failed delivery before giving
+     * up on it. Defaults to 3 (four attempts in all).
+     */
+    retries?: number;
+    /** Wait before the first retry, in milliseconds; it doubles after that. Defaults to 500. */
+    retryDelayMs?: number;
+    /** Longest wait between attempts, in milliseconds. Defaults to 30000. */
+    maxRetryDelayMs?: number;
+    /**
+     * Most entries kept while the sink is slow or down. Past this, the oldest
+     * are dropped. Defaults to 1000. Must be at least `batchSize`.
+     */
+    maxBuffered?: number;
+    /**
+     * Use the wrapped adapter's `logBatch` when it has one. Defaults to `true`.
+     * Pass `false` to deliver one entry at a time even then (a wrapped
+     * `WebhookErrorAdapter` then sends one request per entry, not an array).
+     */
+    useBatchMethod?: boolean;
+    /**
+     * Called when entries are given up on, either because they failed every
+     * attempt or because the buffer was full. Errors it throws are ignored.
+     */
+    onDrop?: (entries: ErrorLogEntry<TCode>[], reason: string) => void;
+    /** Text printed before failure messages. Defaults to `[error-log-adapter]`. */
+    prefix?: string;
+}
+/**
+ * Puts a queue in front of any other adapter. `log()` returns `ok: true` as
+ * soon as the entry is queued, so a slow or failing sink never holds up the
+ * application; entries are then delivered in order, in batches, and a failed
+ * delivery is tried again with exponential backoff before the entry is given up
+ * on (see `onDrop`).
+ *
+ * Delivery uses the wrapped adapter's `logBatch` when it has one (the webhook
+ * sends one request for the whole batch); otherwise the entries go one at a
+ * time through `log`, stopping at the first failure so a sink that is down is
+ * not hammered. Because of that, `ok: true` from `log()` means "queued", not
+ * "stored": call `flush()` before the process exits, and watch `onDrop` or the
+ * console for entries that could not be delivered. The queue is in memory, so
+ * entries still waiting when the process dies are lost; put a durable adapter
+ * beside it in a `CompositeErrorAdapter` when that matters.
+ *
+ * ```ts
+ * const errorLog = new BatchingErrorAdapter(
+ *   new WebhookErrorAdapter('https://example.com/errors'),
+ *   { batchSize: 50, maxWaitMs: 2000 }
+ * );
+ * process.on('beforeExit', () => void errorLog.flush());
+ * ```
+ *
+ * Do not also turn on the wrapped adapter's own retries (for example the
+ * webhook's `retries`): the two multiply.
+ */
+declare class BatchingErrorAdapter<TCode extends string = string> implements ErrorLogAdapter<TCode> {
+    private readonly inner;
+    private readonly batchSize;
+    private readonly maxWaitMs;
+    private readonly retries;
+    private readonly retryDelayMs;
+    private readonly maxRetryDelayMs;
+    private readonly maxBuffered;
+    private readonly useBatchMethod;
+    private readonly onDrop;
+    private readonly logPrefix;
+    private queue;
+    private waitTimer;
+    private backoffTimer;
+    private draining;
+    private flushers;
+    private droppedSinceFlush;
+    private lastDropReason;
+    /** @throws {RangeError} if an option is out of range. */
+    constructor(inner: ErrorLogAdapter<TCode>, options?: BatchingErrorOptions<TCode>);
+    /** Queues the entry. Resolves ok straight away; delivery happens in the background. */
+    log(entry: ErrorLogEntry<TCode>): Promise<ErrorLogResult>;
+    /**
+     * Delivers everything queued, retrying as configured, and resolves once the
+     * queue is empty. Resolves `ok: false` if any entries were given up on since
+     * the last flush. With retries on and the sink down this can take a while
+     * (the waits add up to well over a minute with the defaults).
+     */
+    flush(): Promise<ErrorLogResult>;
+    private scheduleDrain;
+    private startDraining;
+    /** Delivers batches until the queue is empty, waiting out a backoff after each failure. */
+    private drain;
+    /**
+     * Tries to deliver `batch` (the front of the queue). Delivered entries leave
+     * the queue; an entry that failed has its failure count raised and stays.
+     * Resolves to the failure message, or undefined when everything went through.
+     */
+    private deliver;
+    /** The wrapped adapter should not throw, but a bug in one must not stop the queue. */
+    private safely;
+    private backoff;
+    private drop;
+}
+
+export { type BatchCapableAdapter, BatchingErrorAdapter, type BatchingErrorOptions, type CloudWatchBatchOptions, type CloudWatchLogEvent, type CloudWatchLogsClientLike, CloudWatchLogsErrorAdapter, type CloudWatchLogsErrorOptions, type CloudWatchPutLogEventsInput, type CollectionLike, CompositeErrorAdapter, type CompositeErrorOptions, ConsoleErrorAdapter, type ConsoleErrorOptions, type EmitterLike, type ErrorLogAdapter, type ErrorLogEntry, type ErrorLogResult, EventEmitterErrorAdapter, type EventEmitterErrorOptions, type EventEmitterErrorRecord, type FileSystemLike, type FirebaseErrorOptions, type FirebaseErrorRecord, type FirestoreCollectionLike, FirestoreErrorAdapter, type FirestoreErrorOptions, type FirestoreErrorRecord, FlatFileErrorAdapter, type FlatFileErrorOptions, type IdbDatabaseLike, type IdbObjectStoreLike, type IdbRequestLike, type IdbTransactionLike, type IdbUpgradeDatabaseLike, IndexedDbErrorAdapter, type IndexedDbErrorOptions, type IndexedDbErrorRecord, JsonFileErrorAdapter, type JsonFileErrorOptions, type JsonFileErrorRecord, type LockManagerLike, MongoDbErrorAdapter, type MongoDbErrorOptions, MySqlErrorAdapter, PostgresErrorAdapter, type ReadWriteFileSystemLike, RealtimeDatabaseErrorAdapter, type RealtimeDatabaseRefLike, type RedisClientLike, RedisErrorAdapter, type RedisErrorOptions, type S3BatchOptions, type S3ClientLike, S3ErrorAdapter, type S3ErrorOptions, type S3PutObjectInput, type SerializedErrorLogEntry, type SqlClientLike, type SqlDialect, type SqlErrorOptions, type SqliteClientLike, SqliteErrorAdapter, type SqliteErrorOptions, type StorageLike, type SupabaseClientLike, SupabaseErrorAdapter, type SupabaseErrorLike, type SupabaseErrorOptions, type SupabaseErrorRow, type SupabaseInsertResult, type SupabaseSetupOptions, WebSocketErrorAdapter, type WebSocketErrorOptions, type WebSocketLike, WebStorageErrorAdapter, type WebStorageErrorOptions, type WebStorageErrorRecord, WebhookErrorAdapter, type WebhookErrorOptions, buildCreateErrorLogTableSql, buildErrorLogTableDdl, buildMySqlWidenColumnsSql, buildSupabaseSetupSql, createErrorLogStore, formatErrorLogLine, serializeCause, serializeEntry };

package/dist/index.d.ts

@@ -127,6 +127,15 @@ declare class WebhookErrorAdapter<TCode extends string = string> implements Erro
     /** @throws {RangeError} if `url` is not a valid `https://` URL (see `allowInsecure`) or a timeout, retry or signing option is invalid. */
     constructor(url: string, options?: WebhookErrorOptions);
     log(entry: ErrorLogEntry<TCode>): Promise<ErrorLogResult>;
+    /**
+     * Sends several entries in one request, as a JSON array of the same records
+     * `log` sends one at a time (each with an `id`). `BatchingErrorAdapter` uses
+     * this when it wraps a webhook, so the receiver must accept an array. The
+     * whole request succeeds or fails together.
+     */
+    logBatch(entries: ErrorLogEntry<TCode>[]): Promise<ErrorLogResult>;
+    /** Sends one prepared body, trying again as `retries` allows. */
+    private deliver;
     /** Milliseconds to wait before retry number `retryNumber` (1 for the first). */
     private retryWaitMs;
     private send;
@@ -793,9 +802,16 @@ interface FirebaseErrorRecord {
  */
 interface FirestoreCollectionLike {
     doc(documentId: string): {
-        set(data: FirebaseErrorRecord): Promise<unknown>;
+        set(data: FirestoreErrorRecord): Promise<unknown>;
     };
 }
+/**
+ * What the Firestore adapter writes: the usual fields, plus the expiry field
+ * (a `Date`, which Firestore stores as a timestamp) when `expireAfterMs` is set.
+ */
+type FirestoreErrorRecord = FirebaseErrorRecord & {
+    [field: string]: unknown;
+};
 /**
  * The only thing the Realtime Database adapter needs from a reference:
  * `push(value)`, which resolves once the write is saved. A `firebase-admin`
@@ -834,6 +850,25 @@ interface FirebaseErrorOptions {
     /** Text printed before failure messages. Defaults to `[error-log-adapter]`. */
     prefix?: string;
 }
+interface FirestoreErrorOptions extends FirebaseErrorOptions {
+    /**
+     * Add an expiry time to every document: the entry's `timestamp` plus this
+     * many milliseconds, stored as a Firestore timestamp in `expireField`. This
+     * only writes the field. Firestore deletes nothing until you turn on a TTL
+     * policy for that field, for example:
+     *
+     * ```sh
+     * gcloud firestore fields ttls update expire_at \
+     *   --collection-group=error_log --enable-ttl
+     * ```
+     *
+     * Firestore then removes documents some time after they expire (typically
+     * within a day), and the deletes are billed like any other. Off by default.
+     */
+    expireAfterMs?: number;
+    /** Name of the expiry field. Defaults to `expire_at`. Only used with `expireAfterMs`. */
+    expireField?: string;
+}
 /**
  * Writes each entry as a document in a Firestore collection. The document id is
  * the entry's UUID, so the SDK finishing one queued write twice cannot create two
@@ -846,8 +881,10 @@ declare class FirestoreErrorAdapter<TCode extends string = string> implements Er
     private readonly collection;
     private readonly prefix;
     private readonly timeoutMs;
-    /** @throws {RangeError} if `options.timeoutMs` is not a positive number or `Infinity`. */
-    constructor(collection: FirestoreCollectionLike, options?: FirebaseErrorOptions);
+    private readonly expireAfterMs;
+    private readonly expireField;
+    /** @throws {RangeError} if `options.timeoutMs` is not a positive number or `Infinity`, or the expiry options are invalid. */
+    constructor(collection: FirestoreCollectionLike, options?: FirestoreErrorOptions);
     log(entry: ErrorLogEntry<TCode>): Promise<ErrorLogResult>;
 }
 /**
@@ -1175,4 +1212,123 @@ declare class CloudWatchLogsErrorAdapter<TCode extends string = string> implemen
     private fail;
 }
 
-export { type CloudWatchBatchOptions, type CloudWatchLogEvent, type CloudWatchLogsClientLike, CloudWatchLogsErrorAdapter, type CloudWatchLogsErrorOptions, type CloudWatchPutLogEventsInput, type CollectionLike, CompositeErrorAdapter, type CompositeErrorOptions, ConsoleErrorAdapter, type ConsoleErrorOptions, type EmitterLike, type ErrorLogAdapter, type ErrorLogEntry, type ErrorLogResult, EventEmitterErrorAdapter, type EventEmitterErrorOptions, type EventEmitterErrorRecord, type FileSystemLike, type FirebaseErrorOptions, type FirebaseErrorRecord, type FirestoreCollectionLike, FirestoreErrorAdapter, FlatFileErrorAdapter, type FlatFileErrorOptions, type IdbDatabaseLike, type IdbObjectStoreLike, type IdbRequestLike, type IdbTransactionLike, type IdbUpgradeDatabaseLike, IndexedDbErrorAdapter, type IndexedDbErrorOptions, type IndexedDbErrorRecord, JsonFileErrorAdapter, type JsonFileErrorOptions, type JsonFileErrorRecord, type LockManagerLike, MongoDbErrorAdapter, type MongoDbErrorOptions, MySqlErrorAdapter, PostgresErrorAdapter, type ReadWriteFileSystemLike, RealtimeDatabaseErrorAdapter, type RealtimeDatabaseRefLike, type RedisClientLike, RedisErrorAdapter, type RedisErrorOptions, type S3BatchOptions, type S3ClientLike, S3ErrorAdapter, type S3ErrorOptions, type S3PutObjectInput, type SerializedErrorLogEntry, type SqlClientLike, type SqlDialect, type SqlErrorOptions, type SqliteClientLike, SqliteErrorAdapter, type SqliteErrorOptions, type StorageLike, type SupabaseClientLike, SupabaseErrorAdapter, type SupabaseErrorLike, type SupabaseErrorOptions, type SupabaseErrorRow, type SupabaseInsertResult, type SupabaseSetupOptions, WebSocketErrorAdapter, type WebSocketErrorOptions, type WebSocketLike, WebStorageErrorAdapter, type WebStorageErrorOptions, type WebStorageErrorRecord, WebhookErrorAdapter, type WebhookErrorOptions, buildCreateErrorLogTableSql, buildErrorLogTableDdl, buildMySqlWidenColumnsSql, buildSupabaseSetupSql, createErrorLogStore, formatErrorLogLine, serializeCause, serializeEntry };
+/**
+ * An adapter that can send several entries in one go, such as
+ * `WebhookErrorAdapter` (one request carrying a JSON array).
+ * `BatchingErrorAdapter` uses it when it is there. The whole batch succeeds or
+ * fails together.
+ */
+interface BatchCapableAdapter<TCode extends string = string> extends ErrorLogAdapter<TCode> {
+    logBatch(entries: ErrorLogEntry<TCode>[]): Promise<ErrorLogResult>;
+}
+interface BatchingErrorOptions<TCode extends string = string> {
+    /** Deliver once this many entries are waiting. Defaults to 20. */
+    batchSize?: number;
+    /**
+     * Also deliver once the oldest waiting entry has waited this long (ms).
+     * Defaults to 5000. Pass `Infinity` to deliver only when `batchSize` is
+     * reached or `flush()` is called. The timer does not keep the process alive,
+     * so call `flush()` before exiting.
+     */
+    maxWaitMs?: number;
+    /**
+     * How many times to try an entry again after a failed delivery before giving
+     * up on it. Defaults to 3 (four attempts in all).
+     */
+    retries?: number;
+    /** Wait before the first retry, in milliseconds; it doubles after that. Defaults to 500. */
+    retryDelayMs?: number;
+    /** Longest wait between attempts, in milliseconds. Defaults to 30000. */
+    maxRetryDelayMs?: number;
+    /**
+     * Most entries kept while the sink is slow or down. Past this, the oldest
+     * are dropped. Defaults to 1000. Must be at least `batchSize`.
+     */
+    maxBuffered?: number;
+    /**
+     * Use the wrapped adapter's `logBatch` when it has one. Defaults to `true`.
+     * Pass `false` to deliver one entry at a time even then (a wrapped
+     * `WebhookErrorAdapter` then sends one request per entry, not an array).
+     */
+    useBatchMethod?: boolean;
+    /**
+     * Called when entries are given up on, either because they failed every
+     * attempt or because the buffer was full. Errors it throws are ignored.
+     */
+    onDrop?: (entries: ErrorLogEntry<TCode>[], reason: string) => void;
+    /** Text printed before failure messages. Defaults to `[error-log-adapter]`. */
+    prefix?: string;
+}
+/**
+ * Puts a queue in front of any other adapter. `log()` returns `ok: true` as
+ * soon as the entry is queued, so a slow or failing sink never holds up the
+ * application; entries are then delivered in order, in batches, and a failed
+ * delivery is tried again with exponential backoff before the entry is given up
+ * on (see `onDrop`).
+ *
+ * Delivery uses the wrapped adapter's `logBatch` when it has one (the webhook
+ * sends one request for the whole batch); otherwise the entries go one at a
+ * time through `log`, stopping at the first failure so a sink that is down is
+ * not hammered. Because of that, `ok: true` from `log()` means "queued", not
+ * "stored": call `flush()` before the process exits, and watch `onDrop` or the
+ * console for entries that could not be delivered. The queue is in memory, so
+ * entries still waiting when the process dies are lost; put a durable adapter
+ * beside it in a `CompositeErrorAdapter` when that matters.
+ *
+ * ```ts
+ * const errorLog = new BatchingErrorAdapter(
+ *   new WebhookErrorAdapter('https://example.com/errors'),
+ *   { batchSize: 50, maxWaitMs: 2000 }
+ * );
+ * process.on('beforeExit', () => void errorLog.flush());
+ * ```
+ *
+ * Do not also turn on the wrapped adapter's own retries (for example the
+ * webhook's `retries`): the two multiply.
+ */
+declare class BatchingErrorAdapter<TCode extends string = string> implements ErrorLogAdapter<TCode> {
+    private readonly inner;
+    private readonly batchSize;
+    private readonly maxWaitMs;
+    private readonly retries;
+    private readonly retryDelayMs;
+    private readonly maxRetryDelayMs;
+    private readonly maxBuffered;
+    private readonly useBatchMethod;
+    private readonly onDrop;
+    private readonly logPrefix;
+    private queue;
+    private waitTimer;
+    private backoffTimer;
+    private draining;
+    private flushers;
+    private droppedSinceFlush;
+    private lastDropReason;
+    /** @throws {RangeError} if an option is out of range. */
+    constructor(inner: ErrorLogAdapter<TCode>, options?: BatchingErrorOptions<TCode>);
+    /** Queues the entry. Resolves ok straight away; delivery happens in the background. */
+    log(entry: ErrorLogEntry<TCode>): Promise<ErrorLogResult>;
+    /**
+     * Delivers everything queued, retrying as configured, and resolves once the
+     * queue is empty. Resolves `ok: false` if any entries were given up on since
+     * the last flush. With retries on and the sink down this can take a while
+     * (the waits add up to well over a minute with the defaults).
+     */
+    flush(): Promise<ErrorLogResult>;
+    private scheduleDrain;
+    private startDraining;
+    /** Delivers batches until the queue is empty, waiting out a backoff after each failure. */
+    private drain;
+    /**
+     * Tries to deliver `batch` (the front of the queue). Delivered entries leave
+     * the queue; an entry that failed has its failure count raised and stays.
+     * Resolves to the failure message, or undefined when everything went through.
+     */
+    private deliver;
+    /** The wrapped adapter should not throw, but a bug in one must not stop the queue. */
+    private safely;
+    private backoff;
+    private drop;
+}
+
+export { type BatchCapableAdapter, BatchingErrorAdapter, type BatchingErrorOptions, type CloudWatchBatchOptions, type CloudWatchLogEvent, type CloudWatchLogsClientLike, CloudWatchLogsErrorAdapter, type CloudWatchLogsErrorOptions, type CloudWatchPutLogEventsInput, type CollectionLike, CompositeErrorAdapter, type CompositeErrorOptions, ConsoleErrorAdapter, type ConsoleErrorOptions, type EmitterLike, type ErrorLogAdapter, type ErrorLogEntry, type ErrorLogResult, EventEmitterErrorAdapter, type EventEmitterErrorOptions, type EventEmitterErrorRecord, type FileSystemLike, type FirebaseErrorOptions, type FirebaseErrorRecord, type FirestoreCollectionLike, FirestoreErrorAdapter, type FirestoreErrorOptions, type FirestoreErrorRecord, FlatFileErrorAdapter, type FlatFileErrorOptions, type IdbDatabaseLike, type IdbObjectStoreLike, type IdbRequestLike, type IdbTransactionLike, type IdbUpgradeDatabaseLike, IndexedDbErrorAdapter, type IndexedDbErrorOptions, type IndexedDbErrorRecord, JsonFileErrorAdapter, type JsonFileErrorOptions, type JsonFileErrorRecord, type LockManagerLike, MongoDbErrorAdapter, type MongoDbErrorOptions, MySqlErrorAdapter, PostgresErrorAdapter, type ReadWriteFileSystemLike, RealtimeDatabaseErrorAdapter, type RealtimeDatabaseRefLike, type RedisClientLike, RedisErrorAdapter, type RedisErrorOptions, type S3BatchOptions, type S3ClientLike, S3ErrorAdapter, type S3ErrorOptions, type S3PutObjectInput, type SerializedErrorLogEntry, type SqlClientLike, type SqlDialect, type SqlErrorOptions, type SqliteClientLike, SqliteErrorAdapter, type SqliteErrorOptions, type StorageLike, type SupabaseClientLike, SupabaseErrorAdapter, type SupabaseErrorLike, type SupabaseErrorOptions, type SupabaseErrorRow, type SupabaseInsertResult, type SupabaseSetupOptions, WebSocketErrorAdapter, type WebSocketErrorOptions, type WebSocketLike, WebStorageErrorAdapter, type WebStorageErrorOptions, type WebStorageErrorRecord, WebhookErrorAdapter, type WebhookErrorOptions, buildCreateErrorLogTableSql, buildErrorLogTableDdl, buildMySqlWidenColumnsSql, buildSupabaseSetupSql, createErrorLogStore, formatErrorLogLine, serializeCause, serializeEntry };