actor-ts 0.9.0 → 0.10.0

package/dist/tracing/OtelAdapterOptions.d.ts

@@ -0,0 +1,42 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+import type { OtelApiLike, OtelTracerLike } from './OtelAdapter.js';
+/** Plain settings-object shape accepted by {@link otelTracer}. */
+export interface OtelAdapterOptionsType {
+    /** The `@opentelemetry/api` namespace (`import * as otel from '@opentelemetry/api'`). */
+    readonly api: OtelApiLike;
+    /** Optional pre-built tracer; defaults to `api.trace.getTracer(tracerName, tracerVersion)`. */
+    readonly tracer?: OtelTracerLike;
+    /** Tracer name passed to `getTracer`.  Default: `'actor-ts'`. */
+    readonly tracerName?: string;
+    /** Tracer version passed to `getTracer`. */
+    readonly tracerVersion?: string;
+}
+/**
+ * Fluent builder for {@link OtelAdapterOptionsType}:
+ *
+ *     otelTracer(OtelAdapterOptions.create().withApi(otel).withTracerName('my-svc'))
+ *
+ * `withApi` is mandatory — the adapter has nothing to delegate to without
+ * the `@opentelemetry/api` namespace.
+ */
+export declare class OtelAdapterOptionsBuilder extends OptionsBuilder<OtelAdapterOptionsType> {
+    /** Start a fresh builder.  Equivalent to `new OtelAdapterOptionsBuilder()`. */
+    static create(): OtelAdapterOptionsBuilder;
+    /** The `@opentelemetry/api` namespace (`import * as otel from '@opentelemetry/api'`). */
+    withApi(api: OtelApiLike): this;
+    /** Optional pre-built tracer; defaults to `api.trace.getTracer(tracerName, tracerVersion)`. */
+    withTracer(tracer: OtelTracerLike): this;
+    /** Tracer name passed to `getTracer`.  Default: `'actor-ts'`. */
+    withTracerName(tracerName: string): this;
+    /** Tracer version passed to `getTracer`. */
+    withTracerVersion(tracerVersion: string): this;
+}
+/**
+ * Accepted input for {@link otelTracer}: the fluent
+ * {@link OtelAdapterOptionsBuilder} OR a plain
+ * {@link OtelAdapterOptionsType} object.
+ */
+export type OtelAdapterOptions = OtelAdapterOptionsBuilder | Partial<OtelAdapterOptionsType>;
+/** Value alias so `OtelAdapterOptions.create()` / `new OtelAdapterOptions()` resolve to the builder. */
+export declare const OtelAdapterOptions: typeof OtelAdapterOptionsBuilder;
+//# sourceMappingURL=OtelAdapterOptions.d.ts.map

package/dist/tracing/OtelAdapterOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelAdapterOptions.d.ts","sourceRoot":"","sources":["../../src/tracing/OtelAdapterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEpE,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,yFAAyF;IACzF,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC;IAC1B,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,qBAAa,yBAA0B,SAAQ,cAAc,CAAC,sBAAsB,CAAC;IACnF,+EAA+E;IAC/E,MAAM,CAAC,MAAM,IAAI,yBAAyB;IAI1C,yFAAyF;IACzF,OAAO,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAI/B,+FAA+F;IAC/F,UAAU,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAIxC,iEAAiE;IACjE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAIxC,4CAA4C;IAC5C,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;CAG/C;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;AAC7F,wGAAwG;AACxG,eAAO,MAAM,kBAAkB,kCAA4B,CAAC"}

package/dist/tracing/OtelAdapterOptions.js

@@ -0,0 +1,34 @@
+import { OptionsBuilder } from '../util/OptionsBuilder.js';
+/**
+ * Fluent builder for {@link OtelAdapterOptionsType}:
+ *
+ *     otelTracer(OtelAdapterOptions.create().withApi(otel).withTracerName('my-svc'))
+ *
+ * `withApi` is mandatory — the adapter has nothing to delegate to without
+ * the `@opentelemetry/api` namespace.
+ */
+export class OtelAdapterOptionsBuilder extends OptionsBuilder {
+    /** Start a fresh builder.  Equivalent to `new OtelAdapterOptionsBuilder()`. */
+    static create() {
+        return new OtelAdapterOptionsBuilder();
+    }
+    /** The `@opentelemetry/api` namespace (`import * as otel from '@opentelemetry/api'`). */
+    withApi(api) {
+        return this.set('api', api);
+    }
+    /** Optional pre-built tracer; defaults to `api.trace.getTracer(tracerName, tracerVersion)`. */
+    withTracer(tracer) {
+        return this.set('tracer', tracer);
+    }
+    /** Tracer name passed to `getTracer`.  Default: `'actor-ts'`. */
+    withTracerName(tracerName) {
+        return this.set('tracerName', tracerName);
+    }
+    /** Tracer version passed to `getTracer`. */
+    withTracerVersion(tracerVersion) {
+        return this.set('tracerVersion', tracerVersion);
+    }
+}
+/** Value alias so `OtelAdapterOptions.create()` / `new OtelAdapterOptions()` resolve to the builder. */
+export const OtelAdapterOptions = OtelAdapterOptionsBuilder;
+//# sourceMappingURL=OtelAdapterOptions.js.map

package/dist/tracing/OtelAdapterOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelAdapterOptions.js","sourceRoot":"","sources":["../../src/tracing/OtelAdapterOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAe3D;;;;;;;GAOG;AACH,MAAM,OAAO,yBAA0B,SAAQ,cAAsC;IACnF,+EAA+E;IAC/E,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,yBAAyB,EAAE,CAAC;IACzC,CAAC;IAED,yFAAyF;IACzF,OAAO,CAAC,GAAgB;QACtB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,+FAA+F;IAC/F,UAAU,CAAC,MAAsB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,iEAAiE;IACjE,cAAc,CAAC,UAAkB;QAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC5C,CAAC;IAED,4CAA4C;IAC5C,iBAAiB,CAAC,aAAqB;QACrC,OAAO,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,CAAC;CACF;AAQD,wGAAwG;AACxG,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAAC"}

package/dist/tracing/OtelLogsAdapter.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Bridge from the framework's {@link Logger} to OpenTelemetry Logs
+ * (#311).
+ *
+ * `JsonLogger` is the right shape when log records ship to a
+ * stdout-attached log pipeline (Loki, Fluent-Bit, the Docker driver,
+ * Datadog Agent in tail mode).  For OTLP-Logs pipelines —
+ * `@opentelemetry/sdk-logs` with an OTLPLogExporter wiring up to a
+ * collector — the records have to flow through the OTel
+ * `LogRecord` API instead.  This file ships that bridge.
+ *
+ * The adapter delegates every `info`/`warn`/`error`/`debug` call to
+ * an OTel `LoggerProvider`-issued `Logger.emit({...})`.  Severity
+ * is mapped to OTel's standard severity-number range; the active
+ * span's `traceId` + `spanId` are attached automatically when
+ * tracing is enabled in the same process; the framework's static
+ * `withFields` + dynamic `LogContext.get()` MDC flow through as
+ * record attributes.
+ *
+ * **Optional peer dep**: `@opentelemetry/api-logs` is not a hard
+ * dep.  Users pass their existing import
+ * (`import * as logsApi from '@opentelemetry/api-logs'`) as the
+ * `{ api }` config — same passthrough pattern as `otelTracer`
+ * (#63) and the prom-client metrics adapter (#64).  Structural
+ * typing on the OTel surface means we never `import` the package
+ * ourselves.
+ */
+import { type Logger as FrameworkLogger, LogLevel } from '../Logger.js';
+/**
+ * Standard OTel severity numbers.  See
+ * https://opentelemetry.io/docs/specs/otel/logs/data-model/#field-severitynumber
+ * — we never call these constants directly; the namespace exposes them
+ * via `api.SeverityNumber.INFO` etc.
+ */
+export interface OtelSeverityNumber {
+    readonly TRACE: number;
+    readonly DEBUG: number;
+    readonly INFO: number;
+    readonly WARN: number;
+    readonly ERROR: number;
+    readonly FATAL: number;
+}
+export interface OtelLogRecord {
+    readonly timestamp?: number;
+    readonly observedTimestamp?: number;
+    readonly severityNumber?: number;
+    readonly severityText?: string;
+    readonly body?: unknown;
+    readonly attributes?: Record<string, unknown>;
+    readonly context?: unknown;
+}
+export interface OtelLoggerLike {
+    emit(record: OtelLogRecord): void;
+}
+export interface OtelLoggerProviderLike {
+    getLogger(name: string, version?: string): OtelLoggerLike;
+}
+export interface OtelLogsApiLike {
+    /** Top-level severity-number constants (`api.SeverityNumber.INFO` etc.). */
+    readonly SeverityNumber: OtelSeverityNumber;
+    /** Returns the globally-registered LoggerProvider — what the SDK setup calls. */
+    logs: {
+        getLoggerProvider(): OtelLoggerProviderLike;
+    };
+}
+export interface OtelLoggerAdapterOptions {
+    /** The `@opentelemetry/api-logs` namespace
+     *  (`import * as logsApi from '@opentelemetry/api-logs'`). */
+    readonly api: OtelLogsApiLike;
+    /**
+     * Optional pre-built OTel logger; defaults to
+     * `api.logs.getLoggerProvider().getLogger(loggerName, loggerVersion)`.
+     * Override when you've already created a named logger you want
+     * actor-ts records to flow into.
+     */
+    readonly logger?: OtelLoggerLike;
+    /** Logger name passed to `getLogger`.  Default: `'actor-ts'`. */
+    readonly loggerName?: string;
+    /** Logger version passed to `getLogger`. */
+    readonly loggerVersion?: string;
+    /**
+     * Initial level filter.  Records below this level skip the OTel
+     * round-trip entirely.  Default: `LogLevel.Info`.
+     */
+    readonly level?: LogLevel;
+}
+/**
+ * Build a `Logger` whose calls translate to OTel `LogRecord.emit({...})`.
+ *
+ *     import * as logsApi from '@opentelemetry/api-logs';
+ *     const system = ActorSystem.create('my-app',
+ *       ActorSystemOptions.create().withLogger(otelLogger({ api: logsApi })));
+ *
+ * After SDK wire-up (`LoggerProvider` + an OTLP-Logs exporter), every
+ * `this.log.info(...)` inside an actor lands as a `LogRecord` with the
+ * actor's path on `source`, the merged MDC on `attributes`, and the
+ * active span's traceId/spanId automatically linked.
+ */
+export declare function otelLogger(opts: OtelLoggerAdapterOptions): FrameworkLogger;
+//# sourceMappingURL=OtelLogsAdapter.d.ts.map

package/dist/tracing/OtelLogsAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelLogsAdapter.d.ts","sourceRoot":"","sources":["../../src/tracing/OtelLogsAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EACL,KAAK,MAAM,IAAI,eAAe,EAC9B,QAAQ,EACT,MAAM,cAAc,CAAC;AAOtB;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,cAAc,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC;IAC5C,iFAAiF;IACjF,IAAI,EAAE;QAAE,iBAAiB,IAAI,sBAAsB,CAAA;KAAE,CAAC;CACvD;AAID,MAAM,WAAW,wBAAwB;IACvC;kEAC8D;IAC9D,QAAQ,CAAC,GAAG,EAAE,eAAe,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,iEAAiE;IACjE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,wBAAwB,GAAG,eAAe,CAM1E"}

package/dist/tracing/OtelLogsAdapter.js

@@ -0,0 +1,130 @@
+/**
+ * Bridge from the framework's {@link Logger} to OpenTelemetry Logs
+ * (#311).
+ *
+ * `JsonLogger` is the right shape when log records ship to a
+ * stdout-attached log pipeline (Loki, Fluent-Bit, the Docker driver,
+ * Datadog Agent in tail mode).  For OTLP-Logs pipelines —
+ * `@opentelemetry/sdk-logs` with an OTLPLogExporter wiring up to a
+ * collector — the records have to flow through the OTel
+ * `LogRecord` API instead.  This file ships that bridge.
+ *
+ * The adapter delegates every `info`/`warn`/`error`/`debug` call to
+ * an OTel `LoggerProvider`-issued `Logger.emit({...})`.  Severity
+ * is mapped to OTel's standard severity-number range; the active
+ * span's `traceId` + `spanId` are attached automatically when
+ * tracing is enabled in the same process; the framework's static
+ * `withFields` + dynamic `LogContext.get()` MDC flow through as
+ * record attributes.
+ *
+ * **Optional peer dep**: `@opentelemetry/api-logs` is not a hard
+ * dep.  Users pass their existing import
+ * (`import * as logsApi from '@opentelemetry/api-logs'`) as the
+ * `{ api }` config — same passthrough pattern as `otelTracer`
+ * (#63) and the prom-client metrics adapter (#64).  Structural
+ * typing on the OTel surface means we never `import` the package
+ * ourselves.
+ */
+import { LogLevel, } from '../Logger.js';
+import { LogContext } from '../LogContext.js';
+/**
+ * Build a `Logger` whose calls translate to OTel `LogRecord.emit({...})`.
+ *
+ *     import * as logsApi from '@opentelemetry/api-logs';
+ *     const system = ActorSystem.create('my-app',
+ *       ActorSystemOptions.create().withLogger(otelLogger({ api: logsApi })));
+ *
+ * After SDK wire-up (`LoggerProvider` + an OTLP-Logs exporter), every
+ * `this.log.info(...)` inside an actor lands as a `LogRecord` with the
+ * actor's path on `source`, the merged MDC on `attributes`, and the
+ * active span's traceId/spanId automatically linked.
+ */
+export function otelLogger(opts) {
+    const provider = opts.api.logs.getLoggerProvider();
+    const otelLog = opts.logger
+        ?? provider.getLogger(opts.loggerName ?? 'actor-ts', opts.loggerVersion);
+    const level = opts.level ?? LogLevel.Info;
+    return new OtelLoggerImpl(otelLog, opts.api.SeverityNumber, level, '', {});
+}
+/* ------------------------------- internals ------------------------------ */
+/**
+ * Implementation class — kept module-private so the public surface is
+ * the factory function only.  `withSource` / `withFields` return a
+ * new instance with the same underlying OTel logger but a different
+ * source / merged static fields.
+ */
+class OtelLoggerImpl {
+    otel;
+    severityNumber;
+    level;
+    source;
+    staticFields;
+    constructor(otel, severityNumber, level, source, staticFields) {
+        this.otel = otel;
+        this.severityNumber = severityNumber;
+        this.level = level;
+        this.source = source;
+        this.staticFields = staticFields;
+    }
+    enabled(target) {
+        return target >= this.level;
+    }
+    severityFor(level) {
+        switch (level) {
+            case LogLevel.Debug: return { number: this.severityNumber.DEBUG, text: 'DEBUG' };
+            case LogLevel.Info: return { number: this.severityNumber.INFO, text: 'INFO' };
+            case LogLevel.Warn: return { number: this.severityNumber.WARN, text: 'WARN' };
+            case LogLevel.Error: return { number: this.severityNumber.ERROR, text: 'ERROR' };
+            default: return { number: this.severityNumber.INFO, text: 'INFO' };
+        }
+    }
+    /** Merge static + dynamic fields, with the actor source as
+     *  a reserved attribute and extra positional args under `args.N`. */
+    buildAttributes(args) {
+        const attrs = {
+            ...this.staticFields,
+            ...LogContext.get(),
+        };
+        if (this.source)
+            attrs['source'] = this.source;
+        // Errors deserve special handling so the stack trace flows
+        // through as a real attribute, not a {}-serialised blob.
+        args.forEach((a, i) => {
+            if (a instanceof Error) {
+                attrs[`args.${i}.name`] = a.name;
+                attrs[`args.${i}.message`] = a.message;
+                if (a.stack)
+                    attrs[`args.${i}.stack`] = a.stack;
+            }
+            else if (a !== undefined) {
+                attrs[`args.${i}`] = a;
+            }
+        });
+        return attrs;
+    }
+    emit(level, msg, args) {
+        if (!this.enabled(level))
+            return;
+        const severity = this.severityFor(level);
+        // OTel SDKs accept either ms or nanos for `timestamp`; we pass ms
+        // here for parity with the JsonLogger and let the SDK normalise.
+        this.otel.emit({
+            timestamp: Date.now(),
+            severityNumber: severity.number,
+            severityText: severity.text,
+            body: msg,
+            attributes: this.buildAttributes(args),
+        });
+    }
+    debug(msg, ...args) { this.emit(LogLevel.Debug, msg, args); }
+    info(msg, ...args) { this.emit(LogLevel.Info, msg, args); }
+    warn(msg, ...args) { this.emit(LogLevel.Warn, msg, args); }
+    error(msg, ...args) { this.emit(LogLevel.Error, msg, args); }
+    withSource(source) {
+        return new OtelLoggerImpl(this.otel, this.severityNumber, this.level, source, this.staticFields);
+    }
+    withFields(fields) {
+        return new OtelLoggerImpl(this.otel, this.severityNumber, this.level, this.source, { ...this.staticFields, ...fields });
+    }
+}
+//# sourceMappingURL=OtelLogsAdapter.js.map

package/dist/tracing/OtelLogsAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelLogsAdapter.js","sourceRoot":"","sources":["../../src/tracing/OtelLogsAdapter.ts"],"names":[],"mappings":"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"}

package/dist/tracing/index.d.ts

@@ -5,5 +5,9 @@ export { RecordingTracer } from './RecordingTracer.js';
 export type { RecordedSpan, RecordingTracerOptions, } from './RecordingTracer.js';
 export { TracingExtension, TracingExtensionId, tracerOf, } from './TracingExtension.js';
 export { otelTracer } from './OtelAdapter.js';
-export type { OtelAdapterOptions, OtelApiLike, OtelContextApi, OtelContextLike, OtelPropagationApi, OtelSpanContextLike, OtelSpanLike, OtelTraceApi, OtelTracerLike, } from './OtelAdapter.js';
+export { OtelAdapterOptions, OtelAdapterOptionsBuilder } from './OtelAdapterOptions.js';
+export type { OtelAdapterOptionsType } from './OtelAdapterOptions.js';
+export type { OtelApiLike, OtelContextApi, OtelContextLike, OtelPropagationApi, OtelSpanContextLike, OtelSpanLike, OtelTraceApi, OtelTracerLike, } from './OtelAdapter.js';
+export { otelLogger } from './OtelLogsAdapter.js';
+export type { OtelLoggerAdapterOptions, OtelLogsApiLike, OtelLoggerProviderLike, OtelLoggerLike, OtelLogRecord, OtelSeverityNumber, } from './OtelLogsAdapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/tracing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,MAAM,EACN,IAAI,EACJ,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,YAAY,EACZ,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,MAAM,EACN,IAAI,EACJ,WAAW,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,YAAY,EACZ,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACxF,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,YAAY,EACV,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,YAAY,EACV,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,cAAc,EACd,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAC"}

package/dist/tracing/index.js

@@ -3,4 +3,6 @@ export { NoopTracer, NOOP_TRACER } from './NoopTracer.js';
 export { RecordingTracer } from './RecordingTracer.js';
 export { TracingExtension, TracingExtensionId, tracerOf, } from './TracingExtension.js';
 export { otelTracer } from './OtelAdapter.js';
+export { OtelAdapterOptions, OtelAdapterOptionsBuilder } from './OtelAdapterOptions.js';
+export { otelLogger } from './OtelLogsAdapter.js';
 //# sourceMappingURL=index.js.map

package/dist/tracing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,GACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAYxF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/util/Constants.d.ts

@@ -63,4 +63,27 @@ export declare const DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS: number;
  * stale data forever.
  */
 export declare const DEFAULT_SNAPSHOT_CACHE_TTL_MS: number;
+/**
+ * Default mailbox capacity for every actor that doesn't pin its own
+ * via `Props.withMailbox(...)`.  10 000 is high enough that a
+ * well-tuned actor never hits it on a normal traffic spike, low
+ * enough that a runaway producer is bounded before the heap explodes.
+ *
+ * Pre-#310 the default was unbounded — operationally an OOM-or-bust
+ * proposition.  The current default trades the worst-case loss-of-
+ * messages for a guaranteed memory ceiling.  Opt out per-actor via
+ * `Props.withMailbox(() => new Mailbox())` for the unbounded shape.
+ */
+export declare const DEFAULT_MAILBOX_CAPACITY = 10000;
+/**
+ * Default overflow policy for the bounded default mailbox.  `drop-
+ * head` discards the oldest queued message when a new one arrives
+ * on a full mailbox — the right shape for telemetry-style workloads
+ * where stale messages are worthless and the freshest snapshot is
+ * the only thing that matters.
+ *
+ * Pick `drop-new` or `reject` per-actor (see `BoundedMailbox`
+ * documentation) when the trade-off is different.
+ */
+export declare const DEFAULT_MAILBOX_OVERFLOW: "drop-head";
 //# sourceMappingURL=Constants.d.ts.map

package/dist/util/Constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../src/util/Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,QAAuB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,mCAAmC,QAAiB,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,QAAiB,CAAC"}
+{"version":3,"file":"Constants.d.ts","sourceRoot":"","sources":["../../src/util/Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,OAAQ,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,QAAuB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,mCAAmC,QAAiB,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,QAAiB,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAE/C;;;;;;;;;GASG;AACH,eAAO,MAAM,wBAAwB,EAAG,WAAoB,CAAC"}

package/dist/util/Constants.js

@@ -63,4 +63,27 @@ export const DEFAULT_TOMBSTONE_PRUNE_INTERVAL_MS = 5 * 60 * 1_000;
  * stale data forever.
  */
 export const DEFAULT_SNAPSHOT_CACHE_TTL_MS = 5 * 60 * 1_000;
+/**
+ * Default mailbox capacity for every actor that doesn't pin its own
+ * via `Props.withMailbox(...)`.  10 000 is high enough that a
+ * well-tuned actor never hits it on a normal traffic spike, low
+ * enough that a runaway producer is bounded before the heap explodes.
+ *
+ * Pre-#310 the default was unbounded — operationally an OOM-or-bust
+ * proposition.  The current default trades the worst-case loss-of-
+ * messages for a guaranteed memory ceiling.  Opt out per-actor via
+ * `Props.withMailbox(() => new Mailbox())` for the unbounded shape.
+ */
+export const DEFAULT_MAILBOX_CAPACITY = 10_000;
+/**
+ * Default overflow policy for the bounded default mailbox.  `drop-
+ * head` discards the oldest queued message when a new one arrives
+ * on a full mailbox — the right shape for telemetry-style workloads
+ * where stale messages are worthless and the freshest snapshot is
+ * the only thing that matters.
+ *
+ * Pick `drop-new` or `reject` per-actor (see `BoundedMailbox`
+ * documentation) when the trade-off is different.
+ */
+export const DEFAULT_MAILBOX_OVERFLOW = 'drop-head';
 //# sourceMappingURL=Constants.js.map

package/dist/util/Constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/util/Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC"}
+{"version":3,"file":"Constants.js","sourceRoot":"","sources":["../../src/util/Constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,KAAK,CAAC;AAEhD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,CAAC;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAElE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;AAE5D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAoB,CAAC"}

package/dist/util/Lazy.d.ts

@@ -28,6 +28,13 @@ export declare class Lazy<T> {
     private readonly compute;
     private state;
     private overrideValue;
+    /**
+     * Set after the cached value (a Promise) resolves — `getSync()`
+     * reads this when the lazy was async-initialised.  Unset before
+     * settlement; unset on rejection (rejection is surfaced through
+     * the Promise itself, not via getSync).
+     */
+    private resolvedAsyncValue;
     private constructor();
     /** Build a lazy cell from a thunk.  Preferred entry point. */
     static of<T>(compute: () => T): Lazy<T>;
@@ -39,6 +46,30 @@ export declare class Lazy<T> {
      * is re-thrown on every subsequent access.
      */
     get(): T;
+    /**
+     * Synchronous variant of {@link get}.  Returns the cached value if
+     * already evaluated; throws otherwise.
+     *
+     * For `Lazy<Promise<U>>` (i.e. async-initialised lazy), `getSync`
+     * returns the **resolved** value of type `U` once the underlying
+     * Promise has settled successfully — meaning callers no longer
+     * have to `await` after they know the lazy has been forced.
+     *
+     *   const sdk = Lazy.of(async () => await import('@aws-sdk/client-s3'));
+     *   await sdk.get();                  // force + await once
+     *   const mod = sdk.getSync<SdkType>(); // type-safe sync access after
+     *
+     * Throws when:
+     *   - the lazy has not been forced at all (`get()` was never called);
+     *   - the lazy is forced but the underlying Promise hasn't resolved yet;
+     *   - the underlying Promise rejected (the rejection error is re-thrown);
+     *   - the thunk itself threw (the original error is re-thrown).
+     *
+     * The generic parameter `U` lets callers narrow the return type for
+     * the async case — `Lazy<Promise<X>>.getSync<X>()` returns `X` while
+     * `Lazy<X>.getSync()` still returns `X` (the cached non-Promise value).
+     */
+    getSync<U = T>(): U;
     /**
      * `true` once `.get()` can return without running the thunk — either
      * the thunk has already been executed (success or failure both count),

package/dist/util/Lazy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Lazy.d.ts","sourceRoot":"","sources":["../../src/util/Lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,qBAAa,IAAI,CAAC,CAAC;IAIG,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH5C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO;IAEP,8DAA8D;IAC9D,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAEvC,6EAA6E;IAC7E,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAMtC;;;;OAIG;IACH,GAAG,IAAI,CAAC;IAcR;;;;;OAKG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,sEAAsE;IACtE,IAAI,IAAI,CAAC,GAAG,SAAS;IAKrB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAInC;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI7C;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAEpC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CAGnC;AAED,mDAAmD;AACnD,eAAO,MAAM,IAAI,gBAAU,CAAC"}
+{"version":3,"file":"Lazy.d.ts","sourceRoot":"","sources":["../../src/util/Lazy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAOH,qBAAa,IAAI,CAAC,CAAC;IAWG,OAAO,CAAC,QAAQ,CAAC,OAAO;IAV5C,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,aAAa,CAA6B;IAClD;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAA6C;IAEvE,OAAO;IAEP,8DAA8D;IAC9D,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAEvC,6EAA6E;IAC7E,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAMtC;;;;OAIG;IACH,GAAG,IAAI,CAAC;IA0BR;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IAqBnB;;;;;OAKG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,sEAAsE;IACtE,IAAI,IAAI,CAAC,GAAG,SAAS;IAKrB;;;OAGG;IACH,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAInC;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAI7C;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI;IAEpC;;;;;OAKG;IACH,KAAK,IAAI,IAAI;IAMb;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;CAGnC;AAED,mDAAmD;AACnD,eAAO,MAAM,IAAI,gBAAU,CAAC"}

package/dist/util/Lazy.js

@@ -28,6 +28,13 @@ export class Lazy {
     compute;
     state = { kind: 'pending' };
     overrideValue = null;
+    /**
+     * Set after the cached value (a Promise) resolves — `getSync()`
+     * reads this when the lazy was async-initialised.  Unset before
+     * settlement; unset on rejection (rejection is surfaced through
+     * the Promise itself, not via getSync).
+     */
+    resolvedAsyncValue = undefined;
     constructor(compute) {
         this.compute = compute;
     }
@@ -54,6 +61,15 @@ export class Lazy {
         try {
             const value = this.compute();
             this.state = { kind: 'value', value };
+            // For `Lazy.of(async () => …)`, the cached value IS the
+            // Promise.  Wire up a then-handler that stashes the eventual
+            // settled value so `getSync()` can read it later without
+            // awaiting again.  We allow the unhandled-rejection because
+            // a downstream `.get()` caller is expected to await + throw.
+            if (isThenable(value)) {
+                const thenable = value;
+                thenable.then((resolved) => { this.resolvedAsyncValue = { value: resolved }; }, () => { });
+            }
             return value;
         }
         catch (e) {
@@ -61,6 +77,48 @@ export class Lazy {
             throw e;
         }
     }
+    /**
+     * Synchronous variant of {@link get}.  Returns the cached value if
+     * already evaluated; throws otherwise.
+     *
+     * For `Lazy<Promise<U>>` (i.e. async-initialised lazy), `getSync`
+     * returns the **resolved** value of type `U` once the underlying
+     * Promise has settled successfully — meaning callers no longer
+     * have to `await` after they know the lazy has been forced.
+     *
+     *   const sdk = Lazy.of(async () => await import('@aws-sdk/client-s3'));
+     *   await sdk.get();                  // force + await once
+     *   const mod = sdk.getSync<SdkType>(); // type-safe sync access after
+     *
+     * Throws when:
+     *   - the lazy has not been forced at all (`get()` was never called);
+     *   - the lazy is forced but the underlying Promise hasn't resolved yet;
+     *   - the underlying Promise rejected (the rejection error is re-thrown);
+     *   - the thunk itself threw (the original error is re-thrown).
+     *
+     * The generic parameter `U` lets callers narrow the return type for
+     * the async case — `Lazy<Promise<X>>.getSync<X>()` returns `X` while
+     * `Lazy<X>.getSync()` still returns `X` (the cached non-Promise value).
+     */
+    getSync() {
+        if (this.overrideValue !== null) {
+            return this.overrideValue.value;
+        }
+        if (this.state.kind === 'error')
+            throw this.state.error;
+        if (this.state.kind === 'pending') {
+            throw new Error('Lazy.getSync(): value has not been evaluated yet — call get() first');
+        }
+        // state.kind === 'value'.  If the cached value is a Promise we
+        // need its resolved form; otherwise return as-is.
+        if (isThenable(this.state.value)) {
+            if (this.resolvedAsyncValue === undefined) {
+                throw new Error('Lazy.getSync(): underlying Promise has not resolved yet — await get() first');
+            }
+            return this.resolvedAsyncValue.value;
+        }
+        return this.state.value;
+    }
     /**
      * `true` once `.get()` can return without running the thunk — either
      * the thunk has already been executed (success or failure both count),
@@ -104,6 +162,7 @@ export class Lazy {
     reset() {
         this.state = { kind: 'pending' };
         this.overrideValue = null;
+        this.resolvedAsyncValue = undefined;
     }
     /**
      * Test hook: force `.get()` to return `value` without touching the
@@ -116,4 +175,15 @@ export class Lazy {
 }
 /** Shorthand alias matching Scala's `lazy val`. */
 export const lazy = Lazy.of;
+/**
+ * Duck-typed thenable check — Promise instances and any object
+ * exposing `.then(...)`.  Used by `Lazy` to detect when the
+ * cached value is an async result whose resolved form
+ * `getSync` should expose post-settlement.
+ */
+function isThenable(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        typeof value.then === 'function');
+}
 //# sourceMappingURL=Lazy.js.map

package/dist/util/Lazy.js.map

@@ -1 +1 @@
-{"version":3,"file":"Lazy.js","sourceRoot":"","sources":["../../src/util/Lazy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Lazy.js","sourceRoot":"","sources":["../../src/util/Lazy.ts"],"names":[],"mappings":"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"}