@bazariodev/docket 0.0.0-stage → 1.0.0

package/dist/client/index.cjs

@@ -0,0 +1,167 @@
+'use strict';
+
+var hub = require('../chunk-ieB8yTEn.cjs');
+var history_index = require('../history/index.cjs');
+var upload_index = require('../upload/index.cjs');
+require('../chunk-CXZYNALm.cjs');
+require('../chunk-BLf-eCDO.cjs');
+require('../chunk-CEhpwtwJ.cjs');
+require('@bazariodev/coordination');
+
+const CLIENT_DEFAULTS = Object.freeze({
+  MAX_HISTORY_RECORDS: 1000,
+  MAX_BATCH_RECORDS: 100,
+  INTERVAL_MS: 5000,
+});
+
+const HISTORY_METHODS = Object.freeze({
+  REQUIRED: Object.freeze(['write', 'query', 'clear']),
+  OPTIONAL: Object.freeze(['flush', 'stop', 'getStatus']),
+});
+
+function resolveHistory(history) {
+  if (history === false) return undefined;
+  if (history === undefined)
+    return history_index.createMemoryHistory({
+      maxRecords: CLIENT_DEFAULTS.MAX_HISTORY_RECORDS,
+    });
+  if (!history || typeof history !== 'object')
+    throw new TypeError('Invalid history options');
+  if (
+    !HISTORY_METHODS.REQUIRED.some((method) => method in history) &&
+    !HISTORY_METHODS.OPTIONAL.some((method) => method in history)
+  )
+    return history_index.createMemoryHistory(history);
+  if (
+    HISTORY_METHODS.REQUIRED.some(
+      (method) => typeof history[method] !== 'function',
+    )
+  )
+    throw new TypeError('A history client requires write, query, and clear');
+  for (const method of HISTORY_METHODS.OPTIONAL)
+    if (history[method] !== undefined && typeof history[method] !== 'function')
+      throw new TypeError(`Invalid history ${method}`);
+  return history;
+}
+
+function createDocket(options) {
+  if (!options || typeof options !== 'object')
+    throw new TypeError('Docket options are required');
+  const {
+    areas,
+    redactor,
+    sinks: suppliedSinks,
+    context,
+    levelStorage,
+    maxOverrideMs,
+    stormLimit,
+    scheduler,
+    now,
+    monotonicNow,
+    createRunId,
+    onError,
+    history: historyOption,
+    upload: uploadOption,
+    isActive: isApplicationActive,
+  } = options;
+  const history = resolveHistory(historyOption);
+  let upload;
+  let uploadOptions;
+  let outbox;
+  if (uploadOption !== undefined && uploadOption !== false) {
+    if (!uploadOption || typeof uploadOption !== 'object')
+      throw new TypeError('Invalid upload options');
+    outbox = uploadOption.outbox;
+    if (
+      !outbox ||
+      outbox === history ||
+      typeof outbox.clear !== 'function' ||
+      typeof outbox.stop !== 'function'
+    )
+      throw new TypeError('Upload requires a separate outbox client');
+    const {
+      maxBatchRecords = CLIENT_DEFAULTS.MAX_BATCH_RECORDS,
+      intervalMs = CLIENT_DEFAULTS.INTERVAL_MS,
+      scheduler,
+      onError,
+      send,
+    } = uploadOption;
+    if (typeof send !== 'function')
+      throw new TypeError('An upload callback is required');
+    uploadOptions = {
+      maxBatchRecords,
+      intervalMs,
+      scheduler,
+      onError,
+      send: (records, signal, token) =>
+        send.call(uploadOption, records, signal, token),
+    };
+  }
+  const sinks = [...(suppliedSinks ?? [])];
+  if (history) sinks.push(history);
+  for (const sink of sinks)
+    if (!sink || typeof sink.write !== 'function')
+      throw new TypeError('A sink must have write');
+  let closed = false;
+  const logging = hub.createLogging({
+    areas,
+    redactor,
+    context,
+    levelStorage,
+    maxOverrideMs,
+    stormLimit,
+    scheduler,
+    now,
+    monotonicNow,
+    createRunId: createRunId ? () => createRunId.call(options) : createRunId,
+    onError,
+    isActive() {
+      if (closed) return false;
+      const active = isApplicationActive?.call(options);
+      return !closed && active !== false;
+    },
+    sinks: [],
+  });
+  const detachments = [];
+  try {
+    if (uploadOptions) upload = upload_index.createUploadSink(uploadOptions, outbox);
+    if (upload) sinks.push(upload);
+    for (const sink of sinks) detachments.push(logging.addSink(sink));
+  } catch (error) {
+    for (const detach of detachments) detach();
+    void upload?.stop();
+    void logging.stop().catch(() => {});
+    throw error;
+  }
+  let stopped;
+  return Object.freeze({
+    ...logging,
+    history,
+    upload,
+    outbox,
+    stop() {
+      if (stopped) return stopped;
+      closed = true;
+      stopped = Promise.resolve().then(async () => {
+        const failures = [];
+        try {
+          await logging.stop();
+        } catch (error) {
+          failures.push(error);
+        }
+        try {
+          await outbox?.stop();
+        } catch (error) {
+          failures.push(error);
+        }
+        if (failures.length)
+          throw new AggregateError(failures, 'Docket shutdown failed');
+      });
+      void upload?.stop();
+      return stopped;
+    },
+  });
+}
+
+exports.createDocket = createDocket;
+//# sourceMappingURL=index.cjs.map

package/dist/client/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/client/constants.js","../../src/client/index.js"],"sourcesContent":["export const CLIENT_DEFAULTS = Object.freeze({\n  MAX_HISTORY_RECORDS: 1000,\n  MAX_BATCH_RECORDS: 100,\n  INTERVAL_MS: 5000,\n});\n\nexport const HISTORY_METHODS = Object.freeze({\n  REQUIRED: Object.freeze(['write', 'query', 'clear']),\n  OPTIONAL: Object.freeze(['flush', 'stop', 'getStatus']),\n});\n","import { createLogging } from '../core/hub.js';\nimport { createMemoryHistory } from '../history/index.js';\nimport { createUploadSink } from '../upload/index.js';\nimport { CLIENT_DEFAULTS, HISTORY_METHODS } from './constants.js';\n\nfunction resolveHistory(history) {\n  if (history === false) return undefined;\n  if (history === undefined)\n    return createMemoryHistory({\n      maxRecords: CLIENT_DEFAULTS.MAX_HISTORY_RECORDS,\n    });\n  if (!history || typeof history !== 'object')\n    throw new TypeError('Invalid history options');\n  if (\n    !HISTORY_METHODS.REQUIRED.some((method) => method in history) &&\n    !HISTORY_METHODS.OPTIONAL.some((method) => method in history)\n  )\n    return createMemoryHistory(history);\n  if (\n    HISTORY_METHODS.REQUIRED.some(\n      (method) => typeof history[method] !== 'function',\n    )\n  )\n    throw new TypeError('A history client requires write, query, and clear');\n  for (const method of HISTORY_METHODS.OPTIONAL)\n    if (history[method] !== undefined && typeof history[method] !== 'function')\n      throw new TypeError(`Invalid history ${method}`);\n  return history;\n}\n\nexport function createDocket(options) {\n  if (!options || typeof options !== 'object')\n    throw new TypeError('Docket options are required');\n  const {\n    areas,\n    redactor,\n    sinks: suppliedSinks,\n    context,\n    levelStorage,\n    maxOverrideMs,\n    stormLimit,\n    scheduler,\n    now,\n    monotonicNow,\n    createRunId,\n    onError,\n    history: historyOption,\n    upload: uploadOption,\n    isActive: isApplicationActive,\n  } = options;\n  const history = resolveHistory(historyOption);\n  let upload;\n  let uploadOptions;\n  let outbox;\n  if (uploadOption !== undefined && uploadOption !== false) {\n    if (!uploadOption || typeof uploadOption !== 'object')\n      throw new TypeError('Invalid upload options');\n    outbox = uploadOption.outbox;\n    if (\n      !outbox ||\n      outbox === history ||\n      typeof outbox.clear !== 'function' ||\n      typeof outbox.stop !== 'function'\n    )\n      throw new TypeError('Upload requires a separate outbox client');\n    const {\n      maxBatchRecords = CLIENT_DEFAULTS.MAX_BATCH_RECORDS,\n      intervalMs = CLIENT_DEFAULTS.INTERVAL_MS,\n      scheduler,\n      onError,\n      send,\n    } = uploadOption;\n    if (typeof send !== 'function')\n      throw new TypeError('An upload callback is required');\n    uploadOptions = {\n      maxBatchRecords,\n      intervalMs,\n      scheduler,\n      onError,\n      send: (records, signal, token) =>\n        send.call(uploadOption, records, signal, token),\n    };\n  }\n  const sinks = [...(suppliedSinks ?? [])];\n  if (history) sinks.push(history);\n  for (const sink of sinks)\n    if (!sink || typeof sink.write !== 'function')\n      throw new TypeError('A sink must have write');\n  let closed = false;\n  const logging = createLogging({\n    areas,\n    redactor,\n    context,\n    levelStorage,\n    maxOverrideMs,\n    stormLimit,\n    scheduler,\n    now,\n    monotonicNow,\n    createRunId: createRunId ? () => createRunId.call(options) : createRunId,\n    onError,\n    isActive() {\n      if (closed) return false;\n      const active = isApplicationActive?.call(options);\n      return !closed && active !== false;\n    },\n    sinks: [],\n  });\n  const detachments = [];\n  try {\n    if (uploadOptions) upload = createUploadSink(uploadOptions, outbox);\n    if (upload) sinks.push(upload);\n    for (const sink of sinks) detachments.push(logging.addSink(sink));\n  } catch (error) {\n    for (const detach of detachments) detach();\n    void upload?.stop();\n    void logging.stop().catch(() => {});\n    throw error;\n  }\n  let stopped;\n  return Object.freeze({\n    ...logging,\n    history,\n    upload,\n    outbox,\n    stop() {\n      if (stopped) return stopped;\n      closed = true;\n      stopped = Promise.resolve().then(async () => {\n        const failures = [];\n        try {\n          await logging.stop();\n        } catch (error) {\n          failures.push(error);\n        }\n        try {\n          await outbox?.stop();\n        } catch (error) {\n          failures.push(error);\n        }\n        if (failures.length)\n          throw new AggregateError(failures, 'Docket shutdown failed');\n      });\n      void upload?.stop();\n      return stopped;\n    },\n  });\n}\n"],"names":["createMemoryHistory","createLogging","createUploadSink"],"mappings":"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"}

package/dist/client/index.d.cts

@@ -0,0 +1,40 @@
+import type { MemoryHistoryOptions } from "../history/index.cjs";
+import type { Logging, LoggingOptions, LogSink, LogSource } from "../index.cjs";
+import type {
+  UploadOutbox,
+  UploadSink,
+  UploadSinkOptions,
+} from "../upload/index.cjs";
+
+export type HistoryClient = LogSink &
+  LogSource &
+  Readonly<{
+    clear(): void | Promise<void>;
+  }>;
+export type OutboxClient = UploadOutbox &
+  Readonly<{
+    clear(): Promise<void>;
+    stop(): Promise<void>;
+  }>;
+export type DocketUploadOptions = Readonly<{
+  outbox: OutboxClient;
+  send: UploadSinkOptions['send'];
+  maxBatchRecords?: number;
+  intervalMs?: number;
+  scheduler?: UploadSinkOptions['scheduler'];
+  onError?: UploadSinkOptions['onError'];
+}>;
+export type DocketOptions<TArea extends string> = LoggingOptions<TArea> &
+  Readonly<{
+    history?: false | MemoryHistoryOptions | HistoryClient;
+    upload?: false | DocketUploadOptions;
+  }>;
+export type Docket<TArea extends string> = Logging<TArea> &
+  Readonly<{
+    history: HistoryClient | undefined;
+    upload: UploadSink | undefined;
+    outbox: OutboxClient | undefined;
+  }>;
+export declare function createDocket<TArea extends string>(
+  options: DocketOptions<TArea>,
+): Docket<TArea>;

package/dist/client/index.d.ts

@@ -0,0 +1,40 @@
+import type { MemoryHistoryOptions } from '../history/index.js';
+import type { Logging, LoggingOptions, LogSink, LogSource } from '../index.js';
+import type {
+  UploadOutbox,
+  UploadSink,
+  UploadSinkOptions,
+} from '../upload/index.js';
+
+export type HistoryClient = LogSink &
+  LogSource &
+  Readonly<{
+    clear(): void | Promise<void>;
+  }>;
+export type OutboxClient = UploadOutbox &
+  Readonly<{
+    clear(): Promise<void>;
+    stop(): Promise<void>;
+  }>;
+export type DocketUploadOptions = Readonly<{
+  outbox: OutboxClient;
+  send: UploadSinkOptions['send'];
+  maxBatchRecords?: number;
+  intervalMs?: number;
+  scheduler?: UploadSinkOptions['scheduler'];
+  onError?: UploadSinkOptions['onError'];
+}>;
+export type DocketOptions<TArea extends string> = LoggingOptions<TArea> &
+  Readonly<{
+    history?: false | MemoryHistoryOptions | HistoryClient;
+    upload?: false | DocketUploadOptions;
+  }>;
+export type Docket<TArea extends string> = Logging<TArea> &
+  Readonly<{
+    history: HistoryClient | undefined;
+    upload: UploadSink | undefined;
+    outbox: OutboxClient | undefined;
+  }>;
+export declare function createDocket<TArea extends string>(
+  options: DocketOptions<TArea>,
+): Docket<TArea>;

package/dist/client/index.js

@@ -0,0 +1,165 @@
+import { c as createLogging } from '../chunk-DkvWLziD.js';
+import { createMemoryHistory } from '../history/index.js';
+import { createUploadSink } from '../upload/index.js';
+import '../chunk-LRCHwVuE.js';
+import '../chunk-CSS3f4_M.js';
+import '../chunk-7ld72rnl.js';
+import '@bazariodev/coordination';
+
+const CLIENT_DEFAULTS = Object.freeze({
+  MAX_HISTORY_RECORDS: 1000,
+  MAX_BATCH_RECORDS: 100,
+  INTERVAL_MS: 5000,
+});
+
+const HISTORY_METHODS = Object.freeze({
+  REQUIRED: Object.freeze(['write', 'query', 'clear']),
+  OPTIONAL: Object.freeze(['flush', 'stop', 'getStatus']),
+});
+
+function resolveHistory(history) {
+  if (history === false) return undefined;
+  if (history === undefined)
+    return createMemoryHistory({
+      maxRecords: CLIENT_DEFAULTS.MAX_HISTORY_RECORDS,
+    });
+  if (!history || typeof history !== 'object')
+    throw new TypeError('Invalid history options');
+  if (
+    !HISTORY_METHODS.REQUIRED.some((method) => method in history) &&
+    !HISTORY_METHODS.OPTIONAL.some((method) => method in history)
+  )
+    return createMemoryHistory(history);
+  if (
+    HISTORY_METHODS.REQUIRED.some(
+      (method) => typeof history[method] !== 'function',
+    )
+  )
+    throw new TypeError('A history client requires write, query, and clear');
+  for (const method of HISTORY_METHODS.OPTIONAL)
+    if (history[method] !== undefined && typeof history[method] !== 'function')
+      throw new TypeError(`Invalid history ${method}`);
+  return history;
+}
+
+function createDocket(options) {
+  if (!options || typeof options !== 'object')
+    throw new TypeError('Docket options are required');
+  const {
+    areas,
+    redactor,
+    sinks: suppliedSinks,
+    context,
+    levelStorage,
+    maxOverrideMs,
+    stormLimit,
+    scheduler,
+    now,
+    monotonicNow,
+    createRunId,
+    onError,
+    history: historyOption,
+    upload: uploadOption,
+    isActive: isApplicationActive,
+  } = options;
+  const history = resolveHistory(historyOption);
+  let upload;
+  let uploadOptions;
+  let outbox;
+  if (uploadOption !== undefined && uploadOption !== false) {
+    if (!uploadOption || typeof uploadOption !== 'object')
+      throw new TypeError('Invalid upload options');
+    outbox = uploadOption.outbox;
+    if (
+      !outbox ||
+      outbox === history ||
+      typeof outbox.clear !== 'function' ||
+      typeof outbox.stop !== 'function'
+    )
+      throw new TypeError('Upload requires a separate outbox client');
+    const {
+      maxBatchRecords = CLIENT_DEFAULTS.MAX_BATCH_RECORDS,
+      intervalMs = CLIENT_DEFAULTS.INTERVAL_MS,
+      scheduler,
+      onError,
+      send,
+    } = uploadOption;
+    if (typeof send !== 'function')
+      throw new TypeError('An upload callback is required');
+    uploadOptions = {
+      maxBatchRecords,
+      intervalMs,
+      scheduler,
+      onError,
+      send: (records, signal, token) =>
+        send.call(uploadOption, records, signal, token),
+    };
+  }
+  const sinks = [...(suppliedSinks ?? [])];
+  if (history) sinks.push(history);
+  for (const sink of sinks)
+    if (!sink || typeof sink.write !== 'function')
+      throw new TypeError('A sink must have write');
+  let closed = false;
+  const logging = createLogging({
+    areas,
+    redactor,
+    context,
+    levelStorage,
+    maxOverrideMs,
+    stormLimit,
+    scheduler,
+    now,
+    monotonicNow,
+    createRunId: createRunId ? () => createRunId.call(options) : createRunId,
+    onError,
+    isActive() {
+      if (closed) return false;
+      const active = isApplicationActive?.call(options);
+      return !closed && active !== false;
+    },
+    sinks: [],
+  });
+  const detachments = [];
+  try {
+    if (uploadOptions) upload = createUploadSink(uploadOptions, outbox);
+    if (upload) sinks.push(upload);
+    for (const sink of sinks) detachments.push(logging.addSink(sink));
+  } catch (error) {
+    for (const detach of detachments) detach();
+    void upload?.stop();
+    void logging.stop().catch(() => {});
+    throw error;
+  }
+  let stopped;
+  return Object.freeze({
+    ...logging,
+    history,
+    upload,
+    outbox,
+    stop() {
+      if (stopped) return stopped;
+      closed = true;
+      stopped = Promise.resolve().then(async () => {
+        const failures = [];
+        try {
+          await logging.stop();
+        } catch (error) {
+          failures.push(error);
+        }
+        try {
+          await outbox?.stop();
+        } catch (error) {
+          failures.push(error);
+        }
+        if (failures.length)
+          throw new AggregateError(failures, 'Docket shutdown failed');
+      });
+      void upload?.stop();
+      return stopped;
+    },
+  });
+}
+
+export { createDocket };
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/client/constants.js","../../src/client/index.js"],"sourcesContent":["export const CLIENT_DEFAULTS = Object.freeze({\n  MAX_HISTORY_RECORDS: 1000,\n  MAX_BATCH_RECORDS: 100,\n  INTERVAL_MS: 5000,\n});\n\nexport const HISTORY_METHODS = Object.freeze({\n  REQUIRED: Object.freeze(['write', 'query', 'clear']),\n  OPTIONAL: Object.freeze(['flush', 'stop', 'getStatus']),\n});\n","import { createLogging } from '../core/hub.js';\nimport { createMemoryHistory } from '../history/index.js';\nimport { createUploadSink } from '../upload/index.js';\nimport { CLIENT_DEFAULTS, HISTORY_METHODS } from './constants.js';\n\nfunction resolveHistory(history) {\n  if (history === false) return undefined;\n  if (history === undefined)\n    return createMemoryHistory({\n      maxRecords: CLIENT_DEFAULTS.MAX_HISTORY_RECORDS,\n    });\n  if (!history || typeof history !== 'object')\n    throw new TypeError('Invalid history options');\n  if (\n    !HISTORY_METHODS.REQUIRED.some((method) => method in history) &&\n    !HISTORY_METHODS.OPTIONAL.some((method) => method in history)\n  )\n    return createMemoryHistory(history);\n  if (\n    HISTORY_METHODS.REQUIRED.some(\n      (method) => typeof history[method] !== 'function',\n    )\n  )\n    throw new TypeError('A history client requires write, query, and clear');\n  for (const method of HISTORY_METHODS.OPTIONAL)\n    if (history[method] !== undefined && typeof history[method] !== 'function')\n      throw new TypeError(`Invalid history ${method}`);\n  return history;\n}\n\nexport function createDocket(options) {\n  if (!options || typeof options !== 'object')\n    throw new TypeError('Docket options are required');\n  const {\n    areas,\n    redactor,\n    sinks: suppliedSinks,\n    context,\n    levelStorage,\n    maxOverrideMs,\n    stormLimit,\n    scheduler,\n    now,\n    monotonicNow,\n    createRunId,\n    onError,\n    history: historyOption,\n    upload: uploadOption,\n    isActive: isApplicationActive,\n  } = options;\n  const history = resolveHistory(historyOption);\n  let upload;\n  let uploadOptions;\n  let outbox;\n  if (uploadOption !== undefined && uploadOption !== false) {\n    if (!uploadOption || typeof uploadOption !== 'object')\n      throw new TypeError('Invalid upload options');\n    outbox = uploadOption.outbox;\n    if (\n      !outbox ||\n      outbox === history ||\n      typeof outbox.clear !== 'function' ||\n      typeof outbox.stop !== 'function'\n    )\n      throw new TypeError('Upload requires a separate outbox client');\n    const {\n      maxBatchRecords = CLIENT_DEFAULTS.MAX_BATCH_RECORDS,\n      intervalMs = CLIENT_DEFAULTS.INTERVAL_MS,\n      scheduler,\n      onError,\n      send,\n    } = uploadOption;\n    if (typeof send !== 'function')\n      throw new TypeError('An upload callback is required');\n    uploadOptions = {\n      maxBatchRecords,\n      intervalMs,\n      scheduler,\n      onError,\n      send: (records, signal, token) =>\n        send.call(uploadOption, records, signal, token),\n    };\n  }\n  const sinks = [...(suppliedSinks ?? [])];\n  if (history) sinks.push(history);\n  for (const sink of sinks)\n    if (!sink || typeof sink.write !== 'function')\n      throw new TypeError('A sink must have write');\n  let closed = false;\n  const logging = createLogging({\n    areas,\n    redactor,\n    context,\n    levelStorage,\n    maxOverrideMs,\n    stormLimit,\n    scheduler,\n    now,\n    monotonicNow,\n    createRunId: createRunId ? () => createRunId.call(options) : createRunId,\n    onError,\n    isActive() {\n      if (closed) return false;\n      const active = isApplicationActive?.call(options);\n      return !closed && active !== false;\n    },\n    sinks: [],\n  });\n  const detachments = [];\n  try {\n    if (uploadOptions) upload = createUploadSink(uploadOptions, outbox);\n    if (upload) sinks.push(upload);\n    for (const sink of sinks) detachments.push(logging.addSink(sink));\n  } catch (error) {\n    for (const detach of detachments) detach();\n    void upload?.stop();\n    void logging.stop().catch(() => {});\n    throw error;\n  }\n  let stopped;\n  return Object.freeze({\n    ...logging,\n    history,\n    upload,\n    outbox,\n    stop() {\n      if (stopped) return stopped;\n      closed = true;\n      stopped = Promise.resolve().then(async () => {\n        const failures = [];\n        try {\n          await logging.stop();\n        } catch (error) {\n          failures.push(error);\n        }\n        try {\n          await outbox?.stop();\n        } catch (error) {\n          failures.push(error);\n        }\n        if (failures.length)\n          throw new AggregateError(failures, 'Docket shutdown failed');\n      });\n      void upload?.stop();\n      return stopped;\n    },\n  });\n}\n"],"names":[],"mappings":";;;;;;;;AAAO,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7C,EAAE,mBAAmB,EAAE,IAAI;AAC3B,EAAE,iBAAiB,EAAE,GAAG;AACxB,EAAE,WAAW,EAAE,IAAI;AACnB,CAAC,CAAC;;AAEK,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;AAC7C,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACtD,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AACzD,CAAC,CAAC;;ACJF,SAAS,cAAc,CAAC,OAAO,EAAE;AACjC,EAAE,IAAI,OAAO,KAAK,KAAK,EAAE,OAAO,SAAS;AACzC,EAAE,IAAI,OAAO,KAAK,SAAS;AAC3B,IAAI,OAAO,mBAAmB,CAAC;AAC/B,MAAM,UAAU,EAAE,eAAe,CAAC,mBAAmB;AACrD,KAAK,CAAC;AACN,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;AAC7C,IAAI,MAAM,IAAI,SAAS,CAAC,yBAAyB,CAAC;AAClD,EAAE;AACF,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO,CAAC;AACjE,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,OAAO;AAChE;AACA,IAAI,OAAO,mBAAmB,CAAC,OAAO,CAAC;AACvC,EAAE;AACF,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI;AACjC,MAAM,CAAC,MAAM,KAAK,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,UAAU;AACvD;AACA;AACA,IAAI,MAAM,IAAI,SAAS,CAAC,mDAAmD,CAAC;AAC5E,EAAE,KAAK,MAAM,MAAM,IAAI,eAAe,CAAC,QAAQ;AAC/C,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,OAAO,OAAO,CAAC,MAAM,CAAC,KAAK,UAAU;AAC9E,MAAM,MAAM,IAAI,SAAS,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC;AACtD,EAAE,OAAO,OAAO;AAChB;;AAEO,SAAS,YAAY,CAAC,OAAO,EAAE;AACtC,EAAE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;AAC7C,IAAI,MAAM,IAAI,SAAS,CAAC,6BAA6B,CAAC;AACtD,EAAE,MAAM;AACR,IAAI,KAAK;AACT,IAAI,QAAQ;AACZ,IAAI,KAAK,EAAE,aAAa;AACxB,IAAI,OAAO;AACX,IAAI,YAAY;AAChB,IAAI,aAAa;AACjB,IAAI,UAAU;AACd,IAAI,SAAS;AACb,IAAI,GAAG;AACP,IAAI,YAAY;AAChB,IAAI,WAAW;AACf,IAAI,OAAO;AACX,IAAI,OAAO,EAAE,aAAa;AAC1B,IAAI,MAAM,EAAE,YAAY;AACxB,IAAI,QAAQ,EAAE,mBAAmB;AACjC,GAAG,GAAG,OAAO;AACb,EAAE,MAAM,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC;AAC/C,EAAE,IAAI,MAAM;AACZ,EAAE,IAAI,aAAa;AACnB,EAAE,IAAI,MAAM;AACZ,EAAE,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,KAAK,EAAE;AAC5D,IAAI,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ;AACzD,MAAM,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC;AACnD,IAAI,MAAM,GAAG,YAAY,CAAC,MAAM;AAChC,IAAI;AACJ,MAAM,CAAC,MAAM;AACb,MAAM,MAAM,KAAK,OAAO;AACxB,MAAM,OAAO,MAAM,CAAC,KAAK,KAAK,UAAU;AACxC,MAAM,OAAO,MAAM,CAAC,IAAI,KAAK;AAC7B;AACA,MAAM,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC;AACrE,IAAI,MAAM;AACV,MAAM,eAAe,GAAG,eAAe,CAAC,iBAAiB;AACzD,MAAM,UAAU,GAAG,eAAe,CAAC,WAAW;AAC9C,MAAM,SAAS;AACf,MAAM,OAAO;AACb,MAAM,IAAI;AACV,KAAK,GAAG,YAAY;AACpB,IAAI,IAAI,OAAO,IAAI,KAAK,UAAU;AAClC,MAAM,MAAM,IAAI,SAAS,CAAC,gCAAgC,CAAC;AAC3D,IAAI,aAAa,GAAG;AACpB,MAAM,eAAe;AACrB,MAAM,UAAU;AAChB,MAAM,SAAS;AACf,MAAM,OAAO;AACb,MAAM,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK;AACnC,QAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;AACvD,KAAK;AACL,EAAE;AACF,EAAE,MAAM,KAAK,GAAG,CAAC,IAAI,aAAa,IAAI,EAAE,CAAC,CAAC;AAC1C,EAAE,IAAI,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;AAClC,EAAE,KAAK,MAAM,IAAI,IAAI,KAAK;AAC1B,IAAI,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU;AACjD,MAAM,MAAM,IAAI,SAAS,CAAC,wBAAwB,CAAC;AACnD,EAAE,IAAI,MAAM,GAAG,KAAK;AACpB,EAAE,MAAM,OAAO,GAAG,aAAa,CAAC;AAChC,IAAI,KAAK;AACT,IAAI,QAAQ;AACZ,IAAI,OAAO;AACX,IAAI,YAAY;AAChB,IAAI,aAAa;AACjB,IAAI,UAAU;AACd,IAAI,SAAS;AACb,IAAI,GAAG;AACP,IAAI,YAAY;AAChB,IAAI,WAAW,EAAE,WAAW,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,WAAW;AAC5E,IAAI,OAAO;AACX,IAAI,QAAQ,GAAG;AACf,MAAM,IAAI,MAAM,EAAE,OAAO,KAAK;AAC9B,MAAM,MAAM,MAAM,GAAG,mBAAmB,EAAE,IAAI,CAAC,OAAO,CAAC;AACvD,MAAM,OAAO,CAAC,MAAM,IAAI,MAAM,KAAK,KAAK;AACxC,IAAI,CAAC;AACL,IAAI,KAAK,EAAE,EAAE;AACb,GAAG,CAAC;AACJ,EAAE,MAAM,WAAW,GAAG,EAAE;AACxB,EAAE,IAAI;AACN,IAAI,IAAI,aAAa,EAAE,MAAM,GAAG,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC;AACvE,IAAI,IAAI,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;AAClC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACrE,EAAE,CAAC,CAAC,OAAO,KAAK,EAAE;AAClB,IAAI,KAAK,MAAM,MAAM,IAAI,WAAW,EAAE,MAAM,EAAE;AAC9C,IAAI,KAAK,MAAM,EAAE,IAAI,EAAE;AACvB,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AACvC,IAAI,MAAM,KAAK;AACf,EAAE;AACF,EAAE,IAAI,OAAO;AACb,EAAE,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,IAAI,GAAG,OAAO;AACd,IAAI,OAAO;AACX,IAAI,MAAM;AACV,IAAI,MAAM;AACV,IAAI,IAAI,GAAG;AACX,MAAM,IAAI,OAAO,EAAE,OAAO,OAAO;AACjC,MAAM,MAAM,GAAG,IAAI;AACnB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,YAAY;AACnD,QAAQ,MAAM,QAAQ,GAAG,EAAE;AAC3B,QAAQ,IAAI;AACZ,UAAU,MAAM,OAAO,CAAC,IAAI,EAAE;AAC9B,QAAQ,CAAC,CAAC,OAAO,KAAK,EAAE;AACxB,UAAU,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;AAC9B,QAAQ;AACR,QAAQ,IAAI;AACZ,UAAU,MAAM,MAAM,EAAE,IAAI,EAAE;AAC9B,QAAQ,CAAC,CAAC,OAAO,KAAK,EAAE;AACxB,UAAU,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;AAC9B,QAAQ;AACR,QAAQ,IAAI,QAAQ,CAAC,MAAM;AAC3B,UAAU,MAAM,IAAI,cAAc,CAAC,QAAQ,EAAE,wBAAwB,CAAC;AACtE,MAAM,CAAC,CAAC;AACR,MAAM,KAAK,MAAM,EAAE,IAAI,EAAE;AACzB,MAAM,OAAO,OAAO;AACpB,IAAI,CAAC;AACL,GAAG,CAAC;AACJ;;"}

package/dist/constants.d.cts

@@ -0,0 +1,4 @@
+export { ENVIRONMENT_FIELDS } from "./browser/constants.cjs";
+export { UPLOAD_STORAGE_MODES } from "./upload/constants.cjs";
+export { LEVELS, LIMITS, LOGGING_ERROR_CODES, LOGGING_ERROR_SOURCES, MARKERS } from "./core/constants.cjs";
+export { OVERFLOW_STRATEGIES, STORE_MODES } from "./storage/constants.cjs";

package/dist/constants.d.ts

@@ -0,0 +1,4 @@
+export { ENVIRONMENT_FIELDS } from "./browser/constants.js";
+export { UPLOAD_STORAGE_MODES } from "./upload/constants.js";
+export { LEVELS, LIMITS, LOGGING_ERROR_CODES, LOGGING_ERROR_SOURCES, MARKERS } from "./core/constants.js";
+export { OVERFLOW_STRATEGIES, STORE_MODES } from "./storage/constants.js";

package/dist/core/constants.d.cts

@@ -0,0 +1,43 @@
+export const LEVELS: Readonly<{
+    DEBUG: "debug";
+    INFO: "info";
+    WARN: "warn";
+    ERROR: "error";
+}>;
+export const LOGGING_LIMITS: Readonly<{
+    ROOT_LOGGER_CACHE_PAIRS: 1000;
+    STORM_SCOPE_PAIRS: 1000;
+    STORM_WINDOW_MS: 1000;
+    STORM_SUMMARY_DELAY_MS: 1000;
+    DEFAULT_LEVEL_OVERRIDE_MS: 86400000;
+    MAX_TIMER_DELAY_MS: 2147483647;
+    DEFAULT_STORM_LIMIT: 100;
+}>;
+export const LOGGING_ERROR_CODES: Readonly<{
+    RECURSIVE_LOGGING: "recursive-logging";
+    ROOT_LOGGER_CACHE_LIMIT: "root-logger-cache-limit";
+    STOPPED: "stopped";
+}>;
+export const LOGGING_ERROR_SOURCES: Readonly<{
+    DATA: "data";
+    REDACTOR: "redactor";
+    SINK: "sink";
+    STORAGE: "storage";
+    SCOPE: "scope";
+    REENTRY: "reentry";
+}>;
+export const LIMITS: Readonly<{
+    maxDepth: 6;
+    maxStringLength: 16384;
+    maxArrayLength: 100;
+    maxKeys: 100;
+    maxNodes: 1000;
+    maxRecordSize: 65536;
+}>;
+export const MARKERS: Readonly<{
+    LIMIT: "[truncated]";
+    CYCLE: "[circular]";
+    ACCESSOR: "[accessor]";
+    UNSUPPORTED: "[unsupported]";
+    MASK: "[redacted]";
+}>;

package/dist/core/constants.d.ts

@@ -0,0 +1,43 @@
+export const LEVELS: Readonly<{
+    DEBUG: "debug";
+    INFO: "info";
+    WARN: "warn";
+    ERROR: "error";
+}>;
+export const LOGGING_LIMITS: Readonly<{
+    ROOT_LOGGER_CACHE_PAIRS: 1000;
+    STORM_SCOPE_PAIRS: 1000;
+    STORM_WINDOW_MS: 1000;
+    STORM_SUMMARY_DELAY_MS: 1000;
+    DEFAULT_LEVEL_OVERRIDE_MS: 86400000;
+    MAX_TIMER_DELAY_MS: 2147483647;
+    DEFAULT_STORM_LIMIT: 100;
+}>;
+export const LOGGING_ERROR_CODES: Readonly<{
+    RECURSIVE_LOGGING: "recursive-logging";
+    ROOT_LOGGER_CACHE_LIMIT: "root-logger-cache-limit";
+    STOPPED: "stopped";
+}>;
+export const LOGGING_ERROR_SOURCES: Readonly<{
+    DATA: "data";
+    REDACTOR: "redactor";
+    SINK: "sink";
+    STORAGE: "storage";
+    SCOPE: "scope";
+    REENTRY: "reentry";
+}>;
+export const LIMITS: Readonly<{
+    maxDepth: 6;
+    maxStringLength: 16384;
+    maxArrayLength: 100;
+    maxKeys: 100;
+    maxNodes: 1000;
+    maxRecordSize: 65536;
+}>;
+export const MARKERS: Readonly<{
+    LIMIT: "[truncated]";
+    CYCLE: "[circular]";
+    ACCESSOR: "[accessor]";
+    UNSUPPORTED: "[unsupported]";
+    MASK: "[redacted]";
+}>;

package/dist/devtools/index.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+function installConsoleApi({
+  logging,
+  clear,
+  exportBundle,
+  name = '__LOGGING__',
+  target = globalThis,
+}) {
+  if (typeof name !== 'string' || !name || name in target)
+    throw new TypeError('Console API name is unavailable');
+  const api = Object.freeze({
+    levels: () => logging.getLevels(),
+    setLevel: (...args) => logging.setLevel(...args),
+    resetLevel: (area) => logging.resetLevel(area),
+    export: async () =>
+      exportBundle
+        ? exportBundle()
+        : Promise.reject(new Error('Export is not configured')),
+    clear: async () =>
+      clear ? clear() : Promise.reject(new Error('Clear is not configured')),
+    help: () =>
+      'levels(), setLevel(area, level, { durationMs }), resetLevel(area?), export(), clear()',
+  });
+  Object.defineProperty(target, name, {
+    value: api,
+    configurable: true,
+    writable: true,
+  });
+  return () => {
+    if (Object.getOwnPropertyDescriptor(target, name)?.value === api)
+      delete target[name];
+  };
+}
+
+exports.installConsoleApi = installConsoleApi;
+//# sourceMappingURL=index.cjs.map

package/dist/devtools/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../src/devtools/index.js"],"sourcesContent":["export function installConsoleApi({\n  logging,\n  clear,\n  exportBundle,\n  name = '__LOGGING__',\n  target = globalThis,\n}) {\n  if (typeof name !== 'string' || !name || name in target)\n    throw new TypeError('Console API name is unavailable');\n  const api = Object.freeze({\n    levels: () => logging.getLevels(),\n    setLevel: (...args) => logging.setLevel(...args),\n    resetLevel: (area) => logging.resetLevel(area),\n    export: async () =>\n      exportBundle\n        ? exportBundle()\n        : Promise.reject(new Error('Export is not configured')),\n    clear: async () =>\n      clear ? clear() : Promise.reject(new Error('Clear is not configured')),\n    help: () =>\n      'levels(), setLevel(area, level, { durationMs }), resetLevel(area?), export(), clear()',\n  });\n  Object.defineProperty(target, name, {\n    value: api,\n    configurable: true,\n    writable: true,\n  });\n  return () => {\n    if (Object.getOwnPropertyDescriptor(target, name)?.value === api)\n      delete target[name];\n  };\n}\n"],"names":[],"mappings":";;AAAO,SAAS,iBAAiB,CAAC;AAClC,EAAE,OAAO;AACT,EAAE,KAAK;AACP,EAAE,YAAY;AACd,EAAE,IAAI,GAAG,aAAa;AACtB,EAAE,MAAM,GAAG,UAAU;AACrB,CAAC,EAAE;AACH,EAAE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,MAAM;AACzD,IAAI,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC;AAC1D,EAAE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;AAC5B,IAAI,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE;AACrC,IAAI,QAAQ,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;AACpD,IAAI,UAAU,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AAClD,IAAI,MAAM,EAAE;AACZ,MAAM;AACN,UAAU,YAAY;AACtB,UAAU,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC/D,IAAI,KAAK,EAAE;AACX,MAAM,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC5E,IAAI,IAAI,EAAE;AACV,MAAM,uFAAuF;AAC7F,GAAG,CAAC;AACJ,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE;AACtC,IAAI,KAAK,EAAE,GAAG;AACd,IAAI,YAAY,EAAE,IAAI;AACtB,IAAI,QAAQ,EAAE,IAAI;AAClB,GAAG,CAAC;AACJ,EAAE,OAAO,MAAM;AACf,IAAI,IAAI,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,KAAK,GAAG;AACpE,MAAM,OAAO,MAAM,CAAC,IAAI,CAAC;AACzB,EAAE,CAAC;AACH;;"}

package/dist/devtools/index.d.cts

@@ -0,0 +1,11 @@
+import type { Logging } from "../index.cjs";
+
+export declare function installConsoleApi<TArea extends string>(
+  options: Readonly<{
+    logging: Pick<Logging<TArea>, 'getLevels' | 'setLevel' | 'resetLevel'>;
+    clear?: () => Promise<unknown>;
+    exportBundle?: () => Promise<void>;
+    name?: string;
+    target?: object;
+  }>,
+): () => void;

package/dist/devtools/index.d.ts

@@ -0,0 +1,11 @@
+import type { Logging } from '../index.js';
+
+export declare function installConsoleApi<TArea extends string>(
+  options: Readonly<{
+    logging: Pick<Logging<TArea>, 'getLevels' | 'setLevel' | 'resetLevel'>;
+    clear?: () => Promise<unknown>;
+    exportBundle?: () => Promise<void>;
+    name?: string;
+    target?: object;
+  }>,
+): () => void;

package/dist/devtools/index.js

@@ -0,0 +1,35 @@
+function installConsoleApi({
+  logging,
+  clear,
+  exportBundle,
+  name = '__LOGGING__',
+  target = globalThis,
+}) {
+  if (typeof name !== 'string' || !name || name in target)
+    throw new TypeError('Console API name is unavailable');
+  const api = Object.freeze({
+    levels: () => logging.getLevels(),
+    setLevel: (...args) => logging.setLevel(...args),
+    resetLevel: (area) => logging.resetLevel(area),
+    export: async () =>
+      exportBundle
+        ? exportBundle()
+        : Promise.reject(new Error('Export is not configured')),
+    clear: async () =>
+      clear ? clear() : Promise.reject(new Error('Clear is not configured')),
+    help: () =>
+      'levels(), setLevel(area, level, { durationMs }), resetLevel(area?), export(), clear()',
+  });
+  Object.defineProperty(target, name, {
+    value: api,
+    configurable: true,
+    writable: true,
+  });
+  return () => {
+    if (Object.getOwnPropertyDescriptor(target, name)?.value === api)
+      delete target[name];
+  };
+}
+
+export { installConsoleApi };
+//# sourceMappingURL=index.js.map

package/dist/devtools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/devtools/index.js"],"sourcesContent":["export function installConsoleApi({\n  logging,\n  clear,\n  exportBundle,\n  name = '__LOGGING__',\n  target = globalThis,\n}) {\n  if (typeof name !== 'string' || !name || name in target)\n    throw new TypeError('Console API name is unavailable');\n  const api = Object.freeze({\n    levels: () => logging.getLevels(),\n    setLevel: (...args) => logging.setLevel(...args),\n    resetLevel: (area) => logging.resetLevel(area),\n    export: async () =>\n      exportBundle\n        ? exportBundle()\n        : Promise.reject(new Error('Export is not configured')),\n    clear: async () =>\n      clear ? clear() : Promise.reject(new Error('Clear is not configured')),\n    help: () =>\n      'levels(), setLevel(area, level, { durationMs }), resetLevel(area?), export(), clear()',\n  });\n  Object.defineProperty(target, name, {\n    value: api,\n    configurable: true,\n    writable: true,\n  });\n  return () => {\n    if (Object.getOwnPropertyDescriptor(target, name)?.value === api)\n      delete target[name];\n  };\n}\n"],"names":[],"mappings":"AAAO,SAAS,iBAAiB,CAAC;AAClC,EAAE,OAAO;AACT,EAAE,KAAK;AACP,EAAE,YAAY;AACd,EAAE,IAAI,GAAG,aAAa;AACtB,EAAE,MAAM,GAAG,UAAU;AACrB,CAAC,EAAE;AACH,EAAE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,MAAM;AACzD,IAAI,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC;AAC1D,EAAE,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC;AAC5B,IAAI,MAAM,EAAE,MAAM,OAAO,CAAC,SAAS,EAAE;AACrC,IAAI,QAAQ,EAAE,CAAC,GAAG,IAAI,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;AACpD,IAAI,UAAU,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AAClD,IAAI,MAAM,EAAE;AACZ,MAAM;AACN,UAAU,YAAY;AACtB,UAAU,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;AAC/D,IAAI,KAAK,EAAE;AACX,MAAM,KAAK,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;AAC5E,IAAI,IAAI,EAAE;AACV,MAAM,uFAAuF;AAC7F,GAAG,CAAC;AACJ,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE;AACtC,IAAI,KAAK,EAAE,GAAG;AACd,IAAI,YAAY,EAAE,IAAI;AACtB,IAAI,QAAQ,EAAE,IAAI;AAClB,GAAG,CAAC;AACJ,EAAE,OAAO,MAAM;AACf,IAAI,IAAI,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,KAAK,GAAG;AACpE,MAAM,OAAO,MAAM,CAAC,IAAI,CAAC;AACzB,EAAE,CAAC;AACH;;"}