@bazariodev/docket 0.0.0 → 1.1.0

package/dist/sip/index.js

@@ -1,4 +1,4 @@
-import { M as MARKERS } from '../chunk-CSS3f4_M.js';
+import { M as MARKERS } from '../chunk-Da877R_E.js';
 
 const SIP_ERRORS = /* @__PURE__ */ Object.freeze({
   CALLBACK: 'SIP display-name callback must return a string without controls',

package/dist/storage/contracts.d.cts

@@ -29,7 +29,3 @@ export type MemoryLogStoreOptions = Readonly<{
   scheduler?: LoggingScheduler;
   onError?: (error: LogStoreError) => void;
 }>;
-export type CopyRecordsOptions = Readonly<{
-  maxChunkRecords?: number;
-  maxChunkSize?: number;
-}>;

package/dist/storage/contracts.d.ts

@@ -29,7 +29,3 @@ export type MemoryLogStoreOptions = Readonly<{
   scheduler?: LoggingScheduler;
   onError?: (error: LogStoreError) => void;
 }>;
-export type CopyRecordsOptions = Readonly<{
-  maxChunkRecords?: number;
-  maxChunkSize?: number;
-}>;

package/dist/upload/constants.d.cts

@@ -0,0 +1,17 @@
+export const UPLOAD_LIMITS: Readonly<{
+    MAX_INTERVAL_MS: 2147483647;
+}>;
+export const UPLOAD_OUTBOX_METHODS: Readonly<{
+    WRITE: "write";
+    CAPTURE: "capture";
+    FLUSH: "flush";
+    NEXT_BATCH: "nextBatch";
+    ACKNOWLEDGE: "acknowledge";
+    GET_STATUS: "getStatus";
+}>;
+export const UPLOAD_STORAGE_MODES: Readonly<{
+    MEMORY: "memory";
+    PERSISTENT: "persistent";
+    FAILED: "failed";
+    STOPPED: "stopped";
+}>;

package/dist/upload/constants.d.ts

@@ -0,0 +1,17 @@
+export const UPLOAD_LIMITS: Readonly<{
+    MAX_INTERVAL_MS: 2147483647;
+}>;
+export const UPLOAD_OUTBOX_METHODS: Readonly<{
+    WRITE: "write";
+    CAPTURE: "capture";
+    FLUSH: "flush";
+    NEXT_BATCH: "nextBatch";
+    ACKNOWLEDGE: "acknowledge";
+    GET_STATUS: "getStatus";
+}>;
+export const UPLOAD_STORAGE_MODES: Readonly<{
+    MEMORY: "memory";
+    PERSISTENT: "persistent";
+    FAILED: "failed";
+    STOPPED: "stopped";
+}>;

package/dist/upload/index.cjs

@@ -0,0 +1,246 @@
+'use strict';
+
+var common = require('../chunk-Dl2KJDqt.cjs');
+require('../chunk-DLnBMRjo.cjs');
+
+const UPLOAD_LIMITS = Object.freeze({ MAX_INTERVAL_MS: 2_147_483_647 });
+
+const UPLOAD_OUTBOX_METHODS = Object.freeze({
+  WRITE: 'write',
+  CAPTURE: 'capture',
+  FLUSH: 'flush',
+  NEXT_BATCH: 'nextBatch',
+  ACKNOWLEDGE: 'acknowledge',
+  GET_STATUS: 'getStatus',
+});
+
+const UPLOAD_STORAGE_MODES = Object.freeze({
+  MEMORY: 'memory',
+  PERSISTENT: 'persistent',
+  FAILED: 'failed',
+  STOPPED: 'stopped',
+});
+
+class UploadSink {
+  #outbox;
+  #options;
+  #scheduler;
+  #timer;
+  #operation;
+  #acceptedToken;
+  #paused = false;
+  #storageFailureReported = false;
+  #droppedRecords = 0;
+  #stopped = false;
+  #stopPromise;
+
+  constructor(options, outbox, scheduler) {
+    this.#options = options;
+    this.#outbox = outbox;
+    this.#scheduler = scheduler;
+    this.#schedule();
+  }
+
+  write(record) {
+    if (this.#stopped) return;
+    const status = this.#readStatus();
+    if (this.#stopped) return;
+    if (status.mode === UPLOAD_STORAGE_MODES.FAILED) {
+      this.#drop(status.error);
+      return;
+    }
+    try {
+      this.#outbox.write(record);
+    } catch (failure) {
+      if (this.#readStatus().mode !== UPLOAD_STORAGE_MODES.FAILED)
+        throw failure;
+      this.#drop(failure);
+      return;
+    }
+    this.#schedule();
+  }
+
+  #readStatus() {
+    const status = this.#outbox.getStatus();
+    if (status.mode !== UPLOAD_STORAGE_MODES.FAILED)
+      this.#storageFailureReported = false;
+    return status;
+  }
+
+  #drop(failure) {
+    this.#droppedRecords++;
+    if (this.#storageFailureReported) return;
+    this.#storageFailureReported = true;
+    common.report(this.#options.onError, failure);
+  }
+
+  #cancelTimer() {
+    if (!this.#timer) return;
+    this.#scheduler.clearTimeout(this.#timer.handle);
+    this.#timer = undefined;
+  }
+
+  #schedule() {
+    if (this.#stopped || this.#paused || this.#timer || this.#operation) return;
+    const status = this.#readStatus();
+    if (this.#stopped || this.#paused || this.#timer || this.#operation) return;
+    if (
+      status.mode === UPLOAD_STORAGE_MODES.FAILED ||
+      status.mode === UPLOAD_STORAGE_MODES.STOPPED
+    )
+      return;
+    if (!status.pendingRecords && !status.batchRecords) return;
+    this.#timer = {
+      handle: this.#scheduler.setTimeout(() => {
+        this.#timer = undefined;
+        void this.flush().catch(() => {});
+      }, this.#options.intervalMs),
+    };
+  }
+
+  flush() {
+    if (this.#stopped) return Promise.resolve();
+    this.#cancelTimer();
+    const current = this.#operation;
+    if (current) {
+      try {
+        current.boundary = this.#outbox.capture();
+      } catch (failure) {
+        return Promise.reject(failure);
+      }
+      return current.promise;
+    }
+    this.#paused = false;
+    let resolve;
+    let reject;
+    const promise = new Promise((accept, fail) => {
+      resolve = accept;
+      reject = fail;
+    });
+    const operation = {
+      promise,
+      resolve,
+      reject,
+      boundary: undefined,
+      controller: undefined,
+    };
+    this.#operation = operation;
+    try {
+      operation.boundary = this.#outbox.capture();
+    } catch (failure) {
+      this.#fail(operation, failure);
+      return promise;
+    }
+    void this.#drain(operation);
+    return promise;
+  }
+
+  async #drain(operation) {
+    try {
+      if (this.#stopped || this.#operation !== operation) return;
+      await this.#outbox.flush();
+      this.#readStatus();
+      while (!this.#stopped && this.#operation === operation) {
+        const boundary = operation.boundary;
+        const batch = await this.#outbox.nextBatch(
+          this.#options.maxBatchRecords,
+          boundary,
+        );
+        if (this.#stopped || this.#operation !== operation) return;
+        if (!batch) {
+          if (boundary !== operation.boundary) continue;
+          break;
+        }
+        if (this.#acceptedToken !== batch.token) {
+          operation.controller = new AbortController();
+          await this.#options.send(
+            batch.records,
+            operation.controller.signal,
+            batch.token,
+          );
+          if (this.#stopped || this.#operation !== operation) return;
+          this.#acceptedToken = batch.token;
+        }
+        await this.#outbox.acknowledge(batch.token);
+        this.#acceptedToken = undefined;
+      }
+      if (this.#stopped || this.#operation !== operation) return;
+      this.#operation = undefined;
+      this.#schedule();
+      operation.resolve();
+    } catch (failure) {
+      this.#fail(operation, failure);
+    }
+  }
+
+  #fail(operation, failure) {
+    operation.reject(failure);
+    if (this.#stopped) return;
+    this.#operation ??= operation;
+    if (this.#operation === operation) {
+      this.#paused = true;
+      this.#cancelTimer();
+    }
+    common.report(this.#options.onError, failure);
+    if (this.#operation === operation) this.#operation = undefined;
+  }
+
+  stop() {
+    if (this.#stopPromise) return this.#stopPromise;
+    this.#stopped = true;
+    this.#cancelTimer();
+    const operation = this.#operation;
+    this.#operation = undefined;
+    this.#stopPromise = Promise.resolve();
+    if (operation) {
+      const failure = new DOMException('Upload stopped', 'AbortError');
+      operation.reject(failure);
+      operation.controller?.abort(failure);
+    }
+    return this.#stopPromise;
+  }
+
+  getStatus() {
+    const { mode, pendingRecords, batchRecords, droppedRecords, error } =
+      this.#readStatus();
+    return Object.freeze({
+      mode,
+      pendingRecords,
+      batchRecords,
+      droppedRecords: droppedRecords + this.#droppedRecords,
+      ...(error === undefined ? {} : { error }),
+      paused: this.#paused,
+      stopped: this.#stopped,
+    });
+  }
+}
+
+function createUploadSink(options, outbox) {
+  common.positive(options?.maxBatchRecords, 'maxBatchRecords');
+  common.positive(options.intervalMs, 'intervalMs');
+  const scheduler =
+    options.scheduler === undefined ? common.scheduler : options.scheduler;
+  if (
+    options.intervalMs > UPLOAD_LIMITS.MAX_INTERVAL_MS ||
+    typeof options.send !== 'function' ||
+    (options.onError !== undefined && typeof options.onError !== 'function') ||
+    !scheduler ||
+    typeof scheduler.setTimeout !== 'function' ||
+    typeof scheduler.clearTimeout !== 'function' ||
+    !outbox ||
+    Object.values(UPLOAD_OUTBOX_METHODS).some(
+      (method) => typeof outbox[method] !== 'function',
+    )
+  )
+    throw new TypeError('Invalid upload options');
+  const sink = new UploadSink(options, outbox, scheduler);
+  return Object.freeze({
+    write: (record) => sink.write(record),
+    flush: () => sink.flush(),
+    stop: () => sink.stop(),
+    getStatus: () => sink.getStatus(),
+  });
+}
+
+exports.createUploadSink = createUploadSink;
+//# sourceMappingURL=index.cjs.map

package/dist/upload/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/upload/constants.js","../../src/upload/index.js"],"sourcesContent":["export const UPLOAD_LIMITS = Object.freeze({ MAX_INTERVAL_MS: 2_147_483_647 });\n\nexport const UPLOAD_OUTBOX_METHODS = Object.freeze({\n  WRITE: 'write',\n  CAPTURE: 'capture',\n  FLUSH: 'flush',\n  NEXT_BATCH: 'nextBatch',\n  ACKNOWLEDGE: 'acknowledge',\n  GET_STATUS: 'getStatus',\n});\n\nexport const UPLOAD_STORAGE_MODES = Object.freeze({\n  MEMORY: 'memory',\n  PERSISTENT: 'persistent',\n  FAILED: 'failed',\n  STOPPED: 'stopped',\n});\n","import {\n  scheduler as hostScheduler,\n  positive,\n  report,\n} from '../core/common.js';\nimport {\n  UPLOAD_LIMITS,\n  UPLOAD_OUTBOX_METHODS,\n  UPLOAD_STORAGE_MODES,\n} from './constants.js';\n\nclass UploadSink {\n  #outbox;\n  #options;\n  #scheduler;\n  #timer;\n  #operation;\n  #acceptedToken;\n  #paused = false;\n  #storageFailureReported = false;\n  #droppedRecords = 0;\n  #stopped = false;\n  #stopPromise;\n\n  constructor(options, outbox, scheduler) {\n    this.#options = options;\n    this.#outbox = outbox;\n    this.#scheduler = scheduler;\n    this.#schedule();\n  }\n\n  write(record) {\n    if (this.#stopped) return;\n    const status = this.#readStatus();\n    if (this.#stopped) return;\n    if (status.mode === UPLOAD_STORAGE_MODES.FAILED) {\n      this.#drop(status.error);\n      return;\n    }\n    try {\n      this.#outbox.write(record);\n    } catch (failure) {\n      if (this.#readStatus().mode !== UPLOAD_STORAGE_MODES.FAILED)\n        throw failure;\n      this.#drop(failure);\n      return;\n    }\n    this.#schedule();\n  }\n\n  #readStatus() {\n    const status = this.#outbox.getStatus();\n    if (status.mode !== UPLOAD_STORAGE_MODES.FAILED)\n      this.#storageFailureReported = false;\n    return status;\n  }\n\n  #drop(failure) {\n    this.#droppedRecords++;\n    if (this.#storageFailureReported) return;\n    this.#storageFailureReported = true;\n    report(this.#options.onError, failure);\n  }\n\n  #cancelTimer() {\n    if (!this.#timer) return;\n    this.#scheduler.clearTimeout(this.#timer.handle);\n    this.#timer = undefined;\n  }\n\n  #schedule() {\n    if (this.#stopped || this.#paused || this.#timer || this.#operation) return;\n    const status = this.#readStatus();\n    if (this.#stopped || this.#paused || this.#timer || this.#operation) return;\n    if (\n      status.mode === UPLOAD_STORAGE_MODES.FAILED ||\n      status.mode === UPLOAD_STORAGE_MODES.STOPPED\n    )\n      return;\n    if (!status.pendingRecords && !status.batchRecords) return;\n    this.#timer = {\n      handle: this.#scheduler.setTimeout(() => {\n        this.#timer = undefined;\n        void this.flush().catch(() => {});\n      }, this.#options.intervalMs),\n    };\n  }\n\n  flush() {\n    if (this.#stopped) return Promise.resolve();\n    this.#cancelTimer();\n    const current = this.#operation;\n    if (current) {\n      try {\n        current.boundary = this.#outbox.capture();\n      } catch (failure) {\n        return Promise.reject(failure);\n      }\n      return current.promise;\n    }\n    this.#paused = false;\n    let resolve;\n    let reject;\n    const promise = new Promise((accept, fail) => {\n      resolve = accept;\n      reject = fail;\n    });\n    const operation = {\n      promise,\n      resolve,\n      reject,\n      boundary: undefined,\n      controller: undefined,\n    };\n    this.#operation = operation;\n    try {\n      operation.boundary = this.#outbox.capture();\n    } catch (failure) {\n      this.#fail(operation, failure);\n      return promise;\n    }\n    void this.#drain(operation);\n    return promise;\n  }\n\n  async #drain(operation) {\n    try {\n      if (this.#stopped || this.#operation !== operation) return;\n      await this.#outbox.flush();\n      this.#readStatus();\n      while (!this.#stopped && this.#operation === operation) {\n        const boundary = operation.boundary;\n        const batch = await this.#outbox.nextBatch(\n          this.#options.maxBatchRecords,\n          boundary,\n        );\n        if (this.#stopped || this.#operation !== operation) return;\n        if (!batch) {\n          if (boundary !== operation.boundary) continue;\n          break;\n        }\n        if (this.#acceptedToken !== batch.token) {\n          operation.controller = new AbortController();\n          await this.#options.send(\n            batch.records,\n            operation.controller.signal,\n            batch.token,\n          );\n          if (this.#stopped || this.#operation !== operation) return;\n          this.#acceptedToken = batch.token;\n        }\n        await this.#outbox.acknowledge(batch.token);\n        this.#acceptedToken = undefined;\n      }\n      if (this.#stopped || this.#operation !== operation) return;\n      this.#operation = undefined;\n      this.#schedule();\n      operation.resolve();\n    } catch (failure) {\n      this.#fail(operation, failure);\n    }\n  }\n\n  #fail(operation, failure) {\n    operation.reject(failure);\n    if (this.#stopped) return;\n    this.#operation ??= operation;\n    if (this.#operation === operation) {\n      this.#paused = true;\n      this.#cancelTimer();\n    }\n    report(this.#options.onError, failure);\n    if (this.#operation === operation) this.#operation = undefined;\n  }\n\n  stop() {\n    if (this.#stopPromise) return this.#stopPromise;\n    this.#stopped = true;\n    this.#cancelTimer();\n    const operation = this.#operation;\n    this.#operation = undefined;\n    this.#stopPromise = Promise.resolve();\n    if (operation) {\n      const failure = new DOMException('Upload stopped', 'AbortError');\n      operation.reject(failure);\n      operation.controller?.abort(failure);\n    }\n    return this.#stopPromise;\n  }\n\n  getStatus() {\n    const { mode, pendingRecords, batchRecords, droppedRecords, error } =\n      this.#readStatus();\n    return Object.freeze({\n      mode,\n      pendingRecords,\n      batchRecords,\n      droppedRecords: droppedRecords + this.#droppedRecords,\n      ...(error === undefined ? {} : { error }),\n      paused: this.#paused,\n      stopped: this.#stopped,\n    });\n  }\n}\n\nexport function createUploadSink(options, outbox) {\n  positive(options?.maxBatchRecords, 'maxBatchRecords');\n  positive(options.intervalMs, 'intervalMs');\n  const scheduler =\n    options.scheduler === undefined ? hostScheduler : options.scheduler;\n  if (\n    options.intervalMs > UPLOAD_LIMITS.MAX_INTERVAL_MS ||\n    typeof options.send !== 'function' ||\n    (options.onError !== undefined && typeof options.onError !== 'function') ||\n    !scheduler ||\n    typeof scheduler.setTimeout !== 'function' ||\n    typeof scheduler.clearTimeout !== 'function' ||\n    !outbox ||\n    Object.values(UPLOAD_OUTBOX_METHODS).some(\n      (method) => typeof outbox[method] !== 'function',\n    )\n  )\n    throw new TypeError('Invalid upload options');\n  const sink = new UploadSink(options, outbox, scheduler);\n  return Object.freeze({\n    write: (record) => sink.write(record),\n    flush: () => sink.flush(),\n    stop: () => sink.stop(),\n    getStatus: () => sink.getStatus(),\n  });\n}\n"],"names":["report","positive","hostScheduler"],"mappings":";;;;;AAAO,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,aAAa,EAAE,CAAC;;AAEvE,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC;AACnD,EAAE,KAAK,EAAE,OAAO;AAChB,EAAE,OAAO,EAAE,SAAS;AACpB,EAAE,KAAK,EAAE,OAAO;AAChB,EAAE,UAAU,EAAE,WAAW;AACzB,EAAE,WAAW,EAAE,aAAa;AAC5B,EAAE,UAAU,EAAE,WAAW;AACzB,CAAC,CAAC;;AAEK,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAClD,EAAE,MAAM,EAAE,QAAQ;AAClB,EAAE,UAAU,EAAE,YAAY;AAC1B,EAAE,MAAM,EAAE,QAAQ;AAClB,EAAE,OAAO,EAAE,SAAS;AACpB,CAAC,CAAC;;ACLF,MAAM,UAAU,CAAC;AACjB,EAAE,OAAO;AACT,EAAE,QAAQ;AACV,EAAE,UAAU;AACZ,EAAE,MAAM;AACR,EAAE,UAAU;AACZ,EAAE,cAAc;AAChB,EAAE,OAAO,GAAG,KAAK;AACjB,EAAE,uBAAuB,GAAG,KAAK;AACjC,EAAE,eAAe,GAAG,CAAC;AACrB,EAAE,QAAQ,GAAG,KAAK;AAClB,EAAE,YAAY;;AAEd,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE;AAC1C,IAAI,IAAI,CAAC,QAAQ,GAAG,OAAO;AAC3B,IAAI,IAAI,CAAC,OAAO,GAAG,MAAM;AACzB,IAAI,IAAI,CAAC,UAAU,GAAG,SAAS;AAC/B,IAAI,IAAI,CAAC,SAAS,EAAE;AACpB,EAAE;;AAEF,EAAE,KAAK,CAAC,MAAM,EAAE;AAChB,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE;AACvB,IAAI,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE;AACrC,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE;AACvB,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,CAAC,MAAM,EAAE;AACrD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC;AAC9B,MAAM;AACN,IAAI;AACJ,IAAI,IAAI;AACR,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;AAChC,IAAI,CAAC,CAAC,OAAO,OAAO,EAAE;AACtB,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,oBAAoB,CAAC,MAAM;AACjE,QAAQ,MAAM,OAAO;AACrB,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;AACzB,MAAM;AACN,IAAI;AACJ,IAAI,IAAI,CAAC,SAAS,EAAE;AACpB,EAAE;;AAEF,EAAE,WAAW,GAAG;AAChB,IAAI,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;AAC3C,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,oBAAoB,CAAC,MAAM;AACnD,MAAM,IAAI,CAAC,uBAAuB,GAAG,KAAK;AAC1C,IAAI,OAAO,MAAM;AACjB,EAAE;;AAEF,EAAE,KAAK,CAAC,OAAO,EAAE;AACjB,IAAI,IAAI,CAAC,eAAe,EAAE;AAC1B,IAAI,IAAI,IAAI,CAAC,uBAAuB,EAAE;AACtC,IAAI,IAAI,CAAC,uBAAuB,GAAG,IAAI;AACvC,IAAIA,aAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;AAC1C,EAAE;;AAEF,EAAE,YAAY,GAAG;AACjB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AACtB,IAAI,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;AACpD,IAAI,IAAI,CAAC,MAAM,GAAG,SAAS;AAC3B,EAAE;;AAEF,EAAE,SAAS,GAAG;AACd,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE;AACzE,IAAI,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE;AACrC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,EAAE;AACzE,IAAI;AACJ,MAAM,MAAM,CAAC,IAAI,KAAK,oBAAoB,CAAC,MAAM;AACjD,MAAM,MAAM,CAAC,IAAI,KAAK,oBAAoB,CAAC;AAC3C;AACA,MAAM;AACN,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE;AACxD,IAAI,IAAI,CAAC,MAAM,GAAG;AAClB,MAAM,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM;AAC/C,QAAQ,IAAI,CAAC,MAAM,GAAG,SAAS;AAC/B,QAAQ,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACzC,MAAM,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;AAClC,KAAK;AACL,EAAE;;AAEF,EAAE,KAAK,GAAG;AACV,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,OAAO,OAAO,CAAC,OAAO,EAAE;AAC/C,IAAI,IAAI,CAAC,YAAY,EAAE;AACvB,IAAI,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU;AACnC,IAAI,IAAI,OAAO,EAAE;AACjB,MAAM,IAAI;AACV,QAAQ,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;AACjD,MAAM,CAAC,CAAC,OAAO,OAAO,EAAE;AACxB,QAAQ,OAAO,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AACtC,MAAM;AACN,MAAM,OAAO,OAAO,CAAC,OAAO;AAC5B,IAAI;AACJ,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK;AACxB,IAAI,IAAI,OAAO;AACf,IAAI,IAAI,MAAM;AACd,IAAI,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,MAAM,EAAE,IAAI,KAAK;AAClD,MAAM,OAAO,GAAG,MAAM;AACtB,MAAM,MAAM,GAAG,IAAI;AACnB,IAAI,CAAC,CAAC;AACN,IAAI,MAAM,SAAS,GAAG;AACtB,MAAM,OAAO;AACb,MAAM,OAAO;AACb,MAAM,MAAM;AACZ,MAAM,QAAQ,EAAE,SAAS;AACzB,MAAM,UAAU,EAAE,SAAS;AAC3B,KAAK;AACL,IAAI,IAAI,CAAC,UAAU,GAAG,SAAS;AAC/B,IAAI,IAAI;AACR,MAAM,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;AACjD,IAAI,CAAC,CAAC,OAAO,OAAO,EAAE;AACtB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;AACpC,MAAM,OAAO,OAAO;AACpB,IAAI;AACJ,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC;AAC/B,IAAI,OAAO,OAAO;AAClB,EAAE;;AAEF,EAAE,MAAM,MAAM,CAAC,SAAS,EAAE;AAC1B,IAAI,IAAI;AACR,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AAC1D,MAAM,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;AAChC,MAAM,IAAI,CAAC,WAAW,EAAE;AACxB,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AAC9D,QAAQ,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ;AAC3C,QAAQ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS;AAClD,UAAU,IAAI,CAAC,QAAQ,CAAC,eAAe;AACvC,UAAU,QAAQ;AAClB,SAAS;AACT,QAAQ,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AAC5D,QAAQ,IAAI,CAAC,KAAK,EAAE;AACpB,UAAU,IAAI,QAAQ,KAAK,SAAS,CAAC,QAAQ,EAAE;AAC/C,UAAU;AACV,QAAQ;AACR,QAAQ,IAAI,IAAI,CAAC,cAAc,KAAK,KAAK,CAAC,KAAK,EAAE;AACjD,UAAU,SAAS,CAAC,UAAU,GAAG,IAAI,eAAe,EAAE;AACtD,UAAU,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI;AAClC,YAAY,KAAK,CAAC,OAAO;AACzB,YAAY,SAAS,CAAC,UAAU,CAAC,MAAM;AACvC,YAAY,KAAK,CAAC,KAAK;AACvB,WAAW;AACX,UAAU,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AAC9D,UAAU,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,KAAK;AAC3C,QAAQ;AACR,QAAQ,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC;AACnD,QAAQ,IAAI,CAAC,cAAc,GAAG,SAAS;AACvC,MAAM;AACN,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AAC1D,MAAM,IAAI,CAAC,UAAU,GAAG,SAAS;AACjC,MAAM,IAAI,CAAC,SAAS,EAAE;AACtB,MAAM,SAAS,CAAC,OAAO,EAAE;AACzB,IAAI,CAAC,CAAC,OAAO,OAAO,EAAE;AACtB,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC;AACpC,IAAI;AACJ,EAAE;;AAEF,EAAE,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE;AAC5B,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;AAC7B,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE;AACvB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;AACjC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AACvC,MAAM,IAAI,CAAC,OAAO,GAAG,IAAI;AACzB,MAAM,IAAI,CAAC,YAAY,EAAE;AACzB,IAAI;AACJ,IAAIA,aAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;AAC1C,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,IAAI,CAAC,UAAU,GAAG,SAAS;AAClE,EAAE;;AAEF,EAAE,IAAI,GAAG;AACT,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,OAAO,IAAI,CAAC,YAAY;AACnD,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI;AACxB,IAAI,IAAI,CAAC,YAAY,EAAE;AACvB,IAAI,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU;AACrC,IAAI,IAAI,CAAC,UAAU,GAAG,SAAS;AAC/B,IAAI,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE;AACzC,IAAI,IAAI,SAAS,EAAE;AACnB,MAAM,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC,gBAAgB,EAAE,YAAY,CAAC;AACtE,MAAM,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;AAC/B,MAAM,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC;AAC1C,IAAI;AACJ,IAAI,OAAO,IAAI,CAAC,YAAY;AAC5B,EAAE;;AAEF,EAAE,SAAS,GAAG;AACd,IAAI,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE;AACvE,MAAM,IAAI,CAAC,WAAW,EAAE;AACxB,IAAI,OAAO,MAAM,CAAC,MAAM,CAAC;AACzB,MAAM,IAAI;AACV,MAAM,cAAc;AACpB,MAAM,YAAY;AAClB,MAAM,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC,eAAe;AAC3D,MAAM,IAAI,KAAK,KAAK,SAAS,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;AAC/C,MAAM,MAAM,EAAE,IAAI,CAAC,OAAO;AAC1B,MAAM,OAAO,EAAE,IAAI,CAAC,QAAQ;AAC5B,KAAK,CAAC;AACN,EAAE;AACF;;AAEO,SAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE;AAClD,EAAEC,eAAQ,CAAC,OAAO,EAAE,eAAe,EAAE,iBAAiB,CAAC;AACvD,EAAEA,eAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC;AAC5C,EAAE,MAAM,SAAS;AACjB,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,GAAGC,gBAAa,GAAG,OAAO,CAAC,SAAS;AACvE,EAAE;AACF,IAAI,OAAO,CAAC,UAAU,GAAG,aAAa,CAAC,eAAe;AACtD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU;AACtC,KAAK,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,OAAO,KAAK,UAAU,CAAC;AAC5E,IAAI,CAAC,SAAS;AACd,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU;AAC9C,IAAI,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU;AAChD,IAAI,CAAC,MAAM;AACX,IAAI,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,IAAI;AAC7C,MAAM,CAAC,MAAM,KAAK,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,UAAU;AACtD;AACA;AACA,IAAI,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC;AACjD,EAAE,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC;AACzD,EAAE,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,IAAI,KAAK,EAAE,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;AACzC,IAAI,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE;AAC7B,IAAI,IAAI,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE;AAC3B,IAAI,SAAS,EAAE,MAAM,IAAI,CAAC,SAAS,EAAE;AACrC,GAAG,CAAC;AACJ;;"}

package/dist/upload/index.d.cts

@@ -0,0 +1,51 @@
+import type { LoggingScheduler, LogRecord } from "../index.cjs";
+import type { UPLOAD_STORAGE_MODES } from "./constants.cjs";
+
+type ValueOf<Values> = Values[keyof Values];
+
+export type UploadBatch = Readonly<{
+  token: string;
+  records: readonly LogRecord[];
+}>;
+export type UploadStorageMode =
+  | ValueOf<typeof UPLOAD_STORAGE_MODES>
+  | (string & {});
+export type UploadOutboxStatus = Readonly<{
+  mode: UploadStorageMode;
+  error?: unknown;
+  pendingRecords: number;
+  batchRecords: number;
+  droppedRecords: number;
+}>;
+export type UploadOutbox = Readonly<{
+  write(record: LogRecord): void;
+  capture(): string;
+  flush(): Promise<void>;
+  nextBatch(limit: number, boundary: string): Promise<UploadBatch | null>;
+  acknowledge(token: string): Promise<void>;
+  getStatus(): UploadOutboxStatus;
+}>;
+
+export type UploadSinkOptions = Readonly<{
+  maxBatchRecords: number;
+  intervalMs: number;
+  send: (
+    records: readonly LogRecord[],
+    signal: AbortSignal,
+    token: string,
+  ) => Promise<void>;
+  onError?: (error: unknown) => void;
+  scheduler?: LoggingScheduler;
+}>;
+export type UploadSinkStatus = UploadOutboxStatus &
+  Readonly<{ paused: boolean; stopped: boolean }>;
+export type UploadSink = Readonly<{
+  write(record: LogRecord): void;
+  flush(): Promise<void>;
+  stop(): Promise<void>;
+  getStatus(): UploadSinkStatus;
+}>;
+export declare function createUploadSink(
+  options: UploadSinkOptions,
+  outbox: UploadOutbox,
+): UploadSink;

package/dist/upload/index.d.ts

@@ -0,0 +1,51 @@
+import type { LoggingScheduler, LogRecord } from '../index.js';
+import type { UPLOAD_STORAGE_MODES } from './constants.js';
+
+type ValueOf<Values> = Values[keyof Values];
+
+export type UploadBatch = Readonly<{
+  token: string;
+  records: readonly LogRecord[];
+}>;
+export type UploadStorageMode =
+  | ValueOf<typeof UPLOAD_STORAGE_MODES>
+  | (string & {});
+export type UploadOutboxStatus = Readonly<{
+  mode: UploadStorageMode;
+  error?: unknown;
+  pendingRecords: number;
+  batchRecords: number;
+  droppedRecords: number;
+}>;
+export type UploadOutbox = Readonly<{
+  write(record: LogRecord): void;
+  capture(): string;
+  flush(): Promise<void>;
+  nextBatch(limit: number, boundary: string): Promise<UploadBatch | null>;
+  acknowledge(token: string): Promise<void>;
+  getStatus(): UploadOutboxStatus;
+}>;
+
+export type UploadSinkOptions = Readonly<{
+  maxBatchRecords: number;
+  intervalMs: number;
+  send: (
+    records: readonly LogRecord[],
+    signal: AbortSignal,
+    token: string,
+  ) => Promise<void>;
+  onError?: (error: unknown) => void;
+  scheduler?: LoggingScheduler;
+}>;
+export type UploadSinkStatus = UploadOutboxStatus &
+  Readonly<{ paused: boolean; stopped: boolean }>;
+export type UploadSink = Readonly<{
+  write(record: LogRecord): void;
+  flush(): Promise<void>;
+  stop(): Promise<void>;
+  getStatus(): UploadSinkStatus;
+}>;
+export declare function createUploadSink(
+  options: UploadSinkOptions,
+  outbox: UploadOutbox,
+): UploadSink;

package/dist/upload/index.js

@@ -0,0 +1,244 @@
+import { p as positive, s as scheduler, b as report } from '../chunk---OIebMz.js';
+import '../chunk-Da877R_E.js';
+
+const UPLOAD_LIMITS = Object.freeze({ MAX_INTERVAL_MS: 2_147_483_647 });
+
+const UPLOAD_OUTBOX_METHODS = Object.freeze({
+  WRITE: 'write',
+  CAPTURE: 'capture',
+  FLUSH: 'flush',
+  NEXT_BATCH: 'nextBatch',
+  ACKNOWLEDGE: 'acknowledge',
+  GET_STATUS: 'getStatus',
+});
+
+const UPLOAD_STORAGE_MODES = Object.freeze({
+  MEMORY: 'memory',
+  PERSISTENT: 'persistent',
+  FAILED: 'failed',
+  STOPPED: 'stopped',
+});
+
+class UploadSink {
+  #outbox;
+  #options;
+  #scheduler;
+  #timer;
+  #operation;
+  #acceptedToken;
+  #paused = false;
+  #storageFailureReported = false;
+  #droppedRecords = 0;
+  #stopped = false;
+  #stopPromise;
+
+  constructor(options, outbox, scheduler) {
+    this.#options = options;
+    this.#outbox = outbox;
+    this.#scheduler = scheduler;
+    this.#schedule();
+  }
+
+  write(record) {
+    if (this.#stopped) return;
+    const status = this.#readStatus();
+    if (this.#stopped) return;
+    if (status.mode === UPLOAD_STORAGE_MODES.FAILED) {
+      this.#drop(status.error);
+      return;
+    }
+    try {
+      this.#outbox.write(record);
+    } catch (failure) {
+      if (this.#readStatus().mode !== UPLOAD_STORAGE_MODES.FAILED)
+        throw failure;
+      this.#drop(failure);
+      return;
+    }
+    this.#schedule();
+  }
+
+  #readStatus() {
+    const status = this.#outbox.getStatus();
+    if (status.mode !== UPLOAD_STORAGE_MODES.FAILED)
+      this.#storageFailureReported = false;
+    return status;
+  }
+
+  #drop(failure) {
+    this.#droppedRecords++;
+    if (this.#storageFailureReported) return;
+    this.#storageFailureReported = true;
+    report(this.#options.onError, failure);
+  }
+
+  #cancelTimer() {
+    if (!this.#timer) return;
+    this.#scheduler.clearTimeout(this.#timer.handle);
+    this.#timer = undefined;
+  }
+
+  #schedule() {
+    if (this.#stopped || this.#paused || this.#timer || this.#operation) return;
+    const status = this.#readStatus();
+    if (this.#stopped || this.#paused || this.#timer || this.#operation) return;
+    if (
+      status.mode === UPLOAD_STORAGE_MODES.FAILED ||
+      status.mode === UPLOAD_STORAGE_MODES.STOPPED
+    )
+      return;
+    if (!status.pendingRecords && !status.batchRecords) return;
+    this.#timer = {
+      handle: this.#scheduler.setTimeout(() => {
+        this.#timer = undefined;
+        void this.flush().catch(() => {});
+      }, this.#options.intervalMs),
+    };
+  }
+
+  flush() {
+    if (this.#stopped) return Promise.resolve();
+    this.#cancelTimer();
+    const current = this.#operation;
+    if (current) {
+      try {
+        current.boundary = this.#outbox.capture();
+      } catch (failure) {
+        return Promise.reject(failure);
+      }
+      return current.promise;
+    }
+    this.#paused = false;
+    let resolve;
+    let reject;
+    const promise = new Promise((accept, fail) => {
+      resolve = accept;
+      reject = fail;
+    });
+    const operation = {
+      promise,
+      resolve,
+      reject,
+      boundary: undefined,
+      controller: undefined,
+    };
+    this.#operation = operation;
+    try {
+      operation.boundary = this.#outbox.capture();
+    } catch (failure) {
+      this.#fail(operation, failure);
+      return promise;
+    }
+    void this.#drain(operation);
+    return promise;
+  }
+
+  async #drain(operation) {
+    try {
+      if (this.#stopped || this.#operation !== operation) return;
+      await this.#outbox.flush();
+      this.#readStatus();
+      while (!this.#stopped && this.#operation === operation) {
+        const boundary = operation.boundary;
+        const batch = await this.#outbox.nextBatch(
+          this.#options.maxBatchRecords,
+          boundary,
+        );
+        if (this.#stopped || this.#operation !== operation) return;
+        if (!batch) {
+          if (boundary !== operation.boundary) continue;
+          break;
+        }
+        if (this.#acceptedToken !== batch.token) {
+          operation.controller = new AbortController();
+          await this.#options.send(
+            batch.records,
+            operation.controller.signal,
+            batch.token,
+          );
+          if (this.#stopped || this.#operation !== operation) return;
+          this.#acceptedToken = batch.token;
+        }
+        await this.#outbox.acknowledge(batch.token);
+        this.#acceptedToken = undefined;
+      }
+      if (this.#stopped || this.#operation !== operation) return;
+      this.#operation = undefined;
+      this.#schedule();
+      operation.resolve();
+    } catch (failure) {
+      this.#fail(operation, failure);
+    }
+  }
+
+  #fail(operation, failure) {
+    operation.reject(failure);
+    if (this.#stopped) return;
+    this.#operation ??= operation;
+    if (this.#operation === operation) {
+      this.#paused = true;
+      this.#cancelTimer();
+    }
+    report(this.#options.onError, failure);
+    if (this.#operation === operation) this.#operation = undefined;
+  }
+
+  stop() {
+    if (this.#stopPromise) return this.#stopPromise;
+    this.#stopped = true;
+    this.#cancelTimer();
+    const operation = this.#operation;
+    this.#operation = undefined;
+    this.#stopPromise = Promise.resolve();
+    if (operation) {
+      const failure = new DOMException('Upload stopped', 'AbortError');
+      operation.reject(failure);
+      operation.controller?.abort(failure);
+    }
+    return this.#stopPromise;
+  }
+
+  getStatus() {
+    const { mode, pendingRecords, batchRecords, droppedRecords, error } =
+      this.#readStatus();
+    return Object.freeze({
+      mode,
+      pendingRecords,
+      batchRecords,
+      droppedRecords: droppedRecords + this.#droppedRecords,
+      ...(error === undefined ? {} : { error }),
+      paused: this.#paused,
+      stopped: this.#stopped,
+    });
+  }
+}
+
+function createUploadSink(options, outbox) {
+  positive(options?.maxBatchRecords, 'maxBatchRecords');
+  positive(options.intervalMs, 'intervalMs');
+  const scheduler$1 =
+    options.scheduler === undefined ? scheduler : options.scheduler;
+  if (
+    options.intervalMs > UPLOAD_LIMITS.MAX_INTERVAL_MS ||
+    typeof options.send !== 'function' ||
+    (options.onError !== undefined && typeof options.onError !== 'function') ||
+    !scheduler$1 ||
+    typeof scheduler$1.setTimeout !== 'function' ||
+    typeof scheduler$1.clearTimeout !== 'function' ||
+    !outbox ||
+    Object.values(UPLOAD_OUTBOX_METHODS).some(
+      (method) => typeof outbox[method] !== 'function',
+    )
+  )
+    throw new TypeError('Invalid upload options');
+  const sink = new UploadSink(options, outbox, scheduler$1);
+  return Object.freeze({
+    write: (record) => sink.write(record),
+    flush: () => sink.flush(),
+    stop: () => sink.stop(),
+    getStatus: () => sink.getStatus(),
+  });
+}
+
+export { createUploadSink };
+//# sourceMappingURL=index.js.map