@cdk8s/awscdk-resolver 0.0.625 → 0.0.626

package/node_modules/@smithy/types/dist-types/ts3.4/externals-check/browser-externals-check.d.ts

@@ -0,0 +1,35 @@
+import { Exact } from "../transform/exact";
+/**
+ * A checked type that resolves to Blob if it is defined as more than a stub, otherwise
+ * resolves to 'never' so as not to widen the type of unions containing Blob
+ * excessively.
+ *
+ * @public
+ */
+export type BlobOptionalType = BlobDefined extends true ? Blob : Unavailable;
+/**
+ * A checked type that resolves to ReadableStream if it is defined as more than a stub, otherwise
+ * resolves to 'never' so as not to widen the type of unions containing ReadableStream
+ * excessively.
+ *
+ * @public
+ */
+export type ReadableStreamOptionalType = ReadableStreamDefined extends true ? ReadableStream : Unavailable;
+/**
+ * Indicates a type is unavailable if it resolves to this.
+ *
+ * @public
+ */
+export type Unavailable = never;
+/**
+ * Whether the global types define more than a stub for ReadableStream.
+ *
+ * @internal
+ */
+export type ReadableStreamDefined = Exact<ReadableStream, {}> extends true ? false : true;
+/**
+ * Whether the global types define more than a stub for Blob.
+ *
+ * @internal
+ */
+export type BlobDefined = Exact<Blob, {}> extends true ? false : true;

package/node_modules/@smithy/types/dist-types/ts3.4/feature-ids.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @internal
+ */
+export type SmithyFeatures = Partial<{
+    RESOURCE_MODEL: "A";
+    WAITER: "B";
+    PAGINATOR: "C";
+    RETRY_MODE_LEGACY: "D";
+    RETRY_MODE_STANDARD: "E";
+    RETRY_MODE_ADAPTIVE: "F";
+    GZIP_REQUEST_COMPRESSION: "L";
+    PROTOCOL_RPC_V2_CBOR: "M";
+    ENDPOINT_OVERRIDE: "N";
+    SIGV4A_SIGNING: "S";
+    CREDENTIALS_CODE: "e";
+}>;

package/node_modules/@smithy/types/dist-types/ts3.4/http/httpHandlerInitialization.d.ts

@@ -0,0 +1,128 @@
+import { Agent as hAgent, AgentOptions as hAgentOptions } from "node:http";
+import { Agent as hsAgent, AgentOptions as hsAgentOptions } from "node:https";
+import { HttpRequest as IHttpRequest } from "../http";
+import { Logger } from "../logger";
+/**
+ *
+ * This type represents an alternate client constructor option for the entry
+ * "requestHandler". Instead of providing an instance of a requestHandler, the user
+ * may provide the requestHandler's constructor options for either the
+ * NodeHttpHandler or FetchHttpHandler.
+ *
+ * For other RequestHandlers like HTTP2 or WebSocket,
+ * constructor parameter passthrough is not currently available.
+ *
+ * @public
+ */
+export type RequestHandlerParams = NodeHttpHandlerOptions | FetchHttpHandlerOptions;
+/**
+ * Represents the http options that can be passed to a node http client.
+ * @public
+ */
+export interface NodeHttpHandlerOptions {
+    /**
+     * The maximum time in milliseconds that the connection phase of a request
+     * may take before the connection attempt is abandoned.
+     * Defaults to 0, which disables the timeout.
+     */
+    connectionTimeout?: number;
+    /**
+     * The maximum number of milliseconds request & response should take.
+     * Defaults to 0, which disables the timeout.
+     *
+     * If exceeded, a warning will be emitted unless throwOnRequestTimeout=true,
+     * in which case a TimeoutError will be thrown.
+     */
+    requestTimeout?: number;
+    /**
+     * Because requestTimeout was for a long time incorrectly being set as a socket idle timeout,
+     * users must also opt-in for request timeout thrown errors.
+     * Without this setting, a breach of the request timeout will be logged as a warning.
+     */
+    throwOnRequestTimeout?: boolean;
+    /**
+     * The maximum time in milliseconds that a socket may remain idle before it
+     * is closed. Defaults to 0, which means no maximum.
+     *
+     * This does not affect the server, which may still close the connection due to an idle socket.
+     */
+    socketTimeout?: number;
+    /**
+     * Delay before the NodeHttpHandler checks for socket exhaustion,
+     * and emits a warning if the active sockets and enqueued request count is greater than
+     * 2x the maxSockets count.
+     *
+     * Defaults to connectionTimeout + requestTimeout or 3000ms if those are not set.
+     */
+    socketAcquisitionWarningTimeout?: number;
+    /**
+     * You can pass http.Agent or its constructor options.
+     */
+    httpAgent?: hAgent | hAgentOptions;
+    /**
+     * You can pass https.Agent or its constructor options.
+     */
+    httpsAgent?: hsAgent | hsAgentOptions;
+    /**
+     * Optional logger.
+     */
+    logger?: Logger;
+}
+/**
+ * Represents the http options that can be passed to a browser http client.
+ * @public
+ */
+export interface FetchHttpHandlerOptions {
+    /**
+     * The number of milliseconds a request can take before being automatically
+     * terminated.
+     */
+    requestTimeout?: number;
+    /**
+     * Whether to allow the request to outlive the page. Default value is false.
+     *
+     * There may be limitations to the payload size, number of concurrent requests,
+     * request duration etc. when using keepalive in browsers.
+     *
+     * These may change over time, so look for up to date information about
+     * these limitations before enabling keepalive.
+     */
+    keepAlive?: boolean;
+    /**
+     * A string indicating whether credentials will be sent with the request always, never, or
+     * only when sent to a same-origin URL.
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/credentials
+     */
+    credentials?: "include" | "omit" | "same-origin" | undefined | string;
+    /**
+     * Cache settings for fetch.
+     * @see https://developer.mozilla.org/en-US/docs/Web/API/Request/cache
+     */
+    cache?: "default" | "force-cache" | "no-cache" | "no-store" | "only-if-cached" | "reload";
+    /**
+     * An optional function that produces additional RequestInit
+     * parameters for each httpRequest.
+     *
+     * This is applied last via merging with Object.assign() and overwrites other values
+     * set from other sources.
+     *
+     * @example
+     * ```js
+     * new Client({
+     *   requestHandler: {
+     *     requestInit(httpRequest) {
+     *       return { cache: "no-store" };
+     *     }
+     *   }
+     * });
+     * ```
+     */
+    requestInit?: (httpRequest: IHttpRequest) => RequestInit;
+}
+declare global {
+    /**
+     * interface merging stub.
+     */
+    interface RequestInit {
+    }
+}

package/node_modules/@smithy/types/dist-types/ts3.4/http.d.ts

@@ -0,0 +1,110 @@
+import { AbortSignal as DeprecatedAbortSignal } from "./abort";
+import { URI } from "./uri";
+/**
+ * @public
+ *
+ * @deprecated use {@link EndpointV2} from `@smithy/types`.
+ */
+export interface Endpoint {
+    protocol: string;
+    hostname: string;
+    port?: number;
+    path: string;
+    query?: QueryParameterBag;
+    headers?: HeaderBag;
+}
+/**
+ * Interface an HTTP request class. Contains
+ * addressing information in addition to standard message properties.
+ *
+ * @public
+ */
+export interface HttpRequest extends HttpMessage, URI {
+    method: string;
+}
+/**
+ * Represents an HTTP message as received in reply to a request. Contains a
+ * numeric status code in addition to standard message properties.
+ *
+ * @public
+ */
+export interface HttpResponse extends HttpMessage {
+    statusCode: number;
+    reason?: string;
+}
+/**
+ * Represents an HTTP message with headers and an optional static or streaming
+ * body. body: ArrayBuffer | ArrayBufferView | string | Uint8Array | Readable | ReadableStream;
+ *
+ * @public
+ */
+export interface HttpMessage {
+    headers: HeaderBag;
+    body?: any;
+}
+/**
+ * A mapping of query parameter names to strings or arrays of strings, with the
+ * second being used when a parameter contains a list of values. Value can be set
+ * to null when query is not in key-value pairs shape
+ *
+ * @public
+ */
+export type QueryParameterBag = Record<string, string | Array<string> | null>;
+/**
+ * @public
+ */
+export type FieldOptions = {
+    name: string;
+    kind?: FieldPosition;
+    values?: string[];
+};
+/**
+ * @public
+ */
+export declare enum FieldPosition {
+    HEADER = 0,
+    TRAILER = 1
+}
+/**
+ * A mapping of header names to string values. Multiple values for the same
+ * header should be represented as a single string with values separated by
+ * `, `.
+ * Keys should be considered case insensitive, even if this is not enforced by a
+ * particular implementation. For example, given the following HeaderBag, where
+ * keys differ only in case:
+ * ```json
+ * {
+ * 'x-request-date': '2000-01-01T00:00:00Z',
+ * 'X-Request-Date': '2001-01-01T00:00:00Z'
+ * }
+ * ```
+ * The SDK may at any point during processing remove one of the object
+ * properties in favor of the other. The headers may or may not be combined, and
+ * the SDK will not deterministically select which header candidate to use.
+ *
+ * @public
+ */
+export type HeaderBag = Record<string, string>;
+/**
+ * Represents an HTTP message with headers and an optional static or streaming
+ * body. bode: ArrayBuffer | ArrayBufferView | string | Uint8Array | Readable | ReadableStream;
+ *
+ * @public
+ */
+export interface HttpMessage {
+    headers: HeaderBag;
+    body?: any;
+}
+/**
+ * Represents the options that may be passed to an Http Handler.
+ *
+ * @public
+ */
+export interface HttpHandlerOptions {
+    abortSignal?: AbortSignal | DeprecatedAbortSignal;
+    /**
+     * The maximum time in milliseconds that the connection phase of a request
+     * may take before the connection attempt is abandoned.
+     */
+    requestTimeout?: number;
+}

package/node_modules/@smithy/types/dist-types/ts3.4/identity/apiKeyIdentity.d.ts

@@ -0,0 +1,14 @@
+import { Identity, IdentityProvider } from "../identity/identity";
+/**
+ * @public
+ */
+export interface ApiKeyIdentity extends Identity {
+    /**
+     * The literal API Key
+     */
+    readonly apiKey: string;
+}
+/**
+ * @public
+ */
+export type ApiKeyIdentityProvider = IdentityProvider<ApiKeyIdentity>;

package/node_modules/@smithy/types/dist-types/ts3.4/identity/awsCredentialIdentity.d.ts

@@ -0,0 +1,31 @@
+import { Identity, IdentityProvider } from "./identity";
+/**
+ * @public
+ */
+export interface AwsCredentialIdentity extends Identity {
+    /**
+     * AWS access key ID
+     */
+    readonly accessKeyId: string;
+    /**
+     * AWS secret access key
+     */
+    readonly secretAccessKey: string;
+    /**
+     * A security or session token to use with these credentials. Usually
+     * present for temporary credentials.
+     */
+    readonly sessionToken?: string;
+    /**
+     * AWS credential scope for this set of credentials.
+     */
+    readonly credentialScope?: string;
+    /**
+     * AWS accountId.
+     */
+    readonly accountId?: string;
+}
+/**
+ * @public
+ */
+export type AwsCredentialIdentityProvider = IdentityProvider<AwsCredentialIdentity>;

package/node_modules/@smithy/types/dist-types/ts3.4/identity/identity.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @public
+ */
+export interface Identity {
+    /**
+     * A `Date` when the identity or credential will no longer be accepted.
+     */
+    readonly expiration?: Date;
+}
+/**
+ * @public
+ */
+export interface IdentityProvider<IdentityT extends Identity> {
+    (identityProperties?: Record<string, any>): Promise<IdentityT>;
+}

package/node_modules/@smithy/types/dist-types/ts3.4/identity/index.d.ts

@@ -0,0 +1,4 @@
+export { ApiKeyIdentity, ApiKeyIdentityProvider } from "./apiKeyIdentity";
+export { AwsCredentialIdentity, AwsCredentialIdentityProvider } from "./awsCredentialIdentity";
+export { Identity, IdentityProvider } from "./identity";
+export { TokenIdentity, TokenIdentityProvider } from "./tokenIdentity";

package/node_modules/@smithy/types/dist-types/ts3.4/identity/tokenIdentity.d.ts

@@ -0,0 +1,14 @@
+import { Identity, IdentityProvider } from "../identity/identity";
+/**
+ * @internal
+ */
+export interface TokenIdentity extends Identity {
+    /**
+     * The literal token string
+     */
+    readonly token: string;
+}
+/**
+ * @internal
+ */
+export type TokenIdentityProvider = IdentityProvider<TokenIdentity>;

package/node_modules/@smithy/types/dist-types/ts3.4/index.d.ts

@@ -0,0 +1,52 @@
+export { AbortController, AbortHandler, AbortSignal } from "./abort";
+export { HttpApiKeyAuthLocation, HttpAuthLocation } from "./auth";
+export { AuthScheme, ErrorHandler, HttpAuthDefinition, HttpAuthOption, HttpAuthScheme, HttpAuthSchemeId, HttpAuthSchemeParameters, HttpAuthSchemeParametersProvider, HttpAuthSchemeProvider, HttpSigner, IdentityProviderConfig, SelectedHttpAuthScheme, SuccessHandler, } from "./auth";
+export { BlobPayloadInputTypes, BlobTypes, BrowserRuntimeBlobTypes, NodeJsRuntimeBlobTypes, } from "./blob/blob-payload-input-types";
+export { Checksum, ChecksumConstructor } from "./checksum";
+export { CheckOptionalClientConfig, Client, InvokeFunction, InvokeMethod, InvokeMethodOptionalArgs, } from "./client";
+export { Command, CommandIO, GetOutputType } from "./command";
+export { CacheKey, ConnectConfiguration, ConnectionManager, ConnectionManagerConfiguration, ConnectionPool, } from "./connection";
+export { Hash, HashConstructor, SourceData, StreamHasher, randomValues } from "./crypto";
+export { AvailableMessage, AvailableMessages, MessageDecoder, MessageEncoder } from "./encode";
+export { EndpointURLScheme } from "./endpoint";
+export { EndpointARN, EndpointObjectProperty, EndpointParameters, EndpointPartition, EndpointURL, EndpointV2, } from "./endpoint";
+export { ConditionObject, DeprecatedObject, EndpointObject, EndpointObjectHeaders, EndpointObjectProperties, EndpointParams, EndpointResolverOptions, EndpointRuleObject, ErrorRuleObject, EvaluateOptions, Expression, FunctionArgv, FunctionObject, FunctionReturn, ParameterObject, ReferenceObject, ReferenceRecord, RuleSetObject, RuleSetRules, TreeRuleObject, } from "./endpoints";
+export { EndpointParameterInstructions, BuiltInParamInstruction, ClientContextParamInstruction, StaticContextParamInstruction, ContextParamInstruction, OperationContextParamInstruction, } from "./endpoints/EndpointParameterInstructions";
+export { BinaryHeaderValue, BooleanHeaderValue, ByteHeaderValue, EventStreamMarshaller, EventStreamMarshallerDeserFn, EventStreamMarshallerSerFn, EventStreamPayloadHandler, EventStreamPayloadHandlerProvider, EventStreamRequestSigner, EventStreamSerdeContext, EventStreamSerdeProvider, EventStreamSignerProvider, HeaderValue, Int64, IntegerHeaderValue, LongHeaderValue, Message, MessageHeaderValue, MessageHeaders, ShortHeaderValue, StringHeaderValue, TimestampHeaderValue, UuidHeaderValue, } from "./eventStream";
+export { AlgorithmId, getDefaultClientConfiguration, resolveDefaultRuntimeConfig } from "./extensions";
+export { ChecksumAlgorithm, ChecksumConfiguration, DefaultClientConfiguration, DefaultExtensionConfiguration, RetryStrategyConfiguration, } from "./extensions";
+export { SmithyFeatures } from "./feature-ids";
+export { FieldPosition } from "./http";
+export { Endpoint, FieldOptions, HeaderBag, HttpHandlerOptions, HttpMessage, HttpRequest, HttpResponse, QueryParameterBag, } from "./http";
+export { FetchHttpHandlerOptions, NodeHttpHandlerOptions, RequestHandlerParams, } from "./http/httpHandlerInitialization";
+export { ApiKeyIdentity, ApiKeyIdentityProvider, AwsCredentialIdentity, AwsCredentialIdentityProvider, Identity, IdentityProvider, TokenIdentity, TokenIdentityProvider, } from "./identity";
+export { Logger } from "./logger";
+export { SMITHY_CONTEXT_KEY } from "./middleware";
+export { AbsoluteLocation, BuildHandler, BuildHandlerArguments, BuildHandlerOptions, BuildHandlerOutput, BuildMiddleware, DeserializeHandler, DeserializeHandlerArguments, DeserializeHandlerOptions, DeserializeHandlerOutput, DeserializeMiddleware, FinalizeHandler, FinalizeHandlerArguments, FinalizeHandlerOutput, FinalizeRequestHandlerOptions, FinalizeRequestMiddleware, Handler, HandlerExecutionContext, HandlerOptions, InitializeHandler, InitializeHandlerArguments, InitializeHandlerOptions, InitializeHandlerOutput, InitializeMiddleware, MiddlewareStack, MiddlewareType, Pluggable, Priority, Relation, RelativeLocation, RelativeMiddlewareOptions, SerializeHandler, SerializeHandlerArguments, SerializeHandlerOptions, SerializeHandlerOutput, SerializeMiddleware, Step, Terminalware, } from "./middleware";
+export { PaginationConfiguration, Paginator } from "./pagination";
+export { IniSectionType } from "./profile";
+export { IniSection, ParsedIniData, Profile, SharedConfigFiles } from "./profile";
+export { MetadataBearer, ResponseMetadata } from "./response";
+export { ExponentialBackoffJitterType, ExponentialBackoffStrategyOptions, RetryBackoffStrategy, RetryErrorInfo, RetryErrorType, RetryStrategyOptions, RetryStrategyV2, RetryToken, StandardRetryBackoffStrategy, StandardRetryToken, } from "./retry";
+export { $ClientProtocol, $ClientProtocolCtor, $Codec, $MemberSchema, $OperationSchema, $Schema, $SchemaRef, $ShapeDeserializer, $ShapeSerializer, BlobSchemas, CodecSettings, ConfigurableSerdeContext, NormalizedSchema, SchemaTraits, SchemaTraitsObject, SimpleSchema, TimestampSchemas, UnitSchema, } from "./schema/schema";
+export { HttpLabelBitMask, HttpPayloadBitMask, HttpQueryParamsBitMask, HttpResponseCodeBitMask, IdempotencyTokenBitMask, IdempotentBitMask, SensitiveBitMask, TraitBitVector, } from "./schema/traits";
+export { ClientProtocol, ClientProtocolCtor, Codec, ListSchema, MapSchema, MemberSchema, OperationSchema, Schema, SchemaRef, ShapeDeserializer, ShapeSerializer, StructureSchema, TraitsSchema, } from "./schema/schema-deprecated";
+export { BigDecimalSchema, BigIntegerSchema, BlobSchema, BooleanSchema, DocumentSchema, ListSchemaModifier, MapSchemaModifier, NumericSchema, StreamingBlobSchema, StringSchema, TimestampDateTimeSchema, TimestampDefaultSchema, TimestampEpochSecondsSchema, TimestampHttpDateSchema, } from "./schema/sentinels";
+export { ShapeName, ShapeNamespace, StaticErrorSchema, StaticListSchema, StaticMapSchema, StaticOperationSchema, StaticSchema, StaticSchemaIdError, StaticSchemaIdList, StaticSchemaIdMap, StaticSchemaIdOperation, StaticSchemaIdSimple, StaticSchemaIdStruct, StaticSchemaIdUnion, StaticSimpleSchema, StaticStructureSchema, StaticUnionSchema, } from "./schema/static-schemas";
+export { EndpointBearer, RequestSerializer, ResponseDeserializer, SdkStream, SdkStreamMixin, SdkStreamMixinInjector, SdkStreamSerdeContext, SerdeContext, SerdeFunctions, StreamCollector, WithSdkStreamMixin, } from "./serde";
+export { DocumentType, RetryableTrait, SdkError, SmithyException } from "./shapes";
+export { DateInput, EventSigner, EventSigningArguments, EventStreamRequestScopedCredentials, FormattedEvent, MessageSigner, MessageSigningArguments, RequestPresigner, RequestPresigningArguments, RequestSigner, RequestSigningArguments, SignableMessage, SignedMessage, SigningArguments, StringSigner, } from "./signature";
+export { GetAwsChunkedEncodingStream, GetAwsChunkedEncodingStreamOptions } from "./stream";
+export { BrowserRuntimeStreamingBlobTypes, NodeJsRuntimeStreamingBlobTypes, StreamingBlobTypes, } from "./streaming-payload/streaming-blob-common-types";
+export { BrowserRuntimeStreamingBlobPayloadInputTypes, NodeJsRuntimeStreamingBlobPayloadInputTypes, StreamingBlobPayloadInputTypes, } from "./streaming-payload/streaming-blob-payload-input-types";
+export { BrowserRuntimeStreamingBlobPayloadOutputTypes, NodeJsRuntimeStreamingBlobPayloadOutputTypes, StreamingBlobPayloadOutputTypes, } from "./streaming-payload/streaming-blob-payload-output-types";
+export { RequestHandlerProtocol } from "./transfer";
+export { RequestContext, RequestHandler, RequestHandlerMetadata, RequestHandlerOutput } from "./transfer";
+export { BrowserClient, BrowserXhrClient, NarrowPayloadBlobOutputType, NarrowPayloadBlobTypes, NodeJsClient, NodeJsHttp2Client, } from "./transform/client-payload-blob-type-narrow";
+export { Mutable } from "./transform/mutable";
+export { AssertiveClient, NoUndefined, RecursiveRequired, UncheckedClient } from "./transform/no-undefined";
+export { Transform } from "./transform/type-transform";
+export { URI } from "./uri";
+export { BodyLengthCalculator, Decoder, Encoder, Exact, MemoizedProvider, OptionalParameter, Provider, RegionInfo, RegionInfoProvider, RegionInfoProviderOptions, RetryStrategy, UrlParser, UserAgent, UserAgentPair, } from "./util";
+export { WaiterConfiguration } from "./waiter";
+export { MetricsRecorder, MetricsRecorderFactory, MetricUnit, RequestOutcome } from "./metrics";

package/node_modules/@smithy/types/dist-types/ts3.4/logger.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Represents a logger object that is available in HandlerExecutionContext
+ * throughout the middleware stack.
+ *
+ * @public
+ */
+export interface Logger {
+    trace?: (...content: any[]) => void;
+    debug: (...content: any[]) => void;
+    info: (...content: any[]) => void;
+    warn: (...content: any[]) => void;
+    error: (...content: any[]) => void;
+}

package/node_modules/@smithy/types/dist-types/ts3.4/metrics.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Outcome of a request, recorded by the framework via {@link MetricsRecorder.recordRequestOutcome}.
+ *
+ * @public
+ */
+export type RequestOutcome = "Success" | "Fault";
+/**
+ * Unit attached to a recorded metric value. The vocabulary follows the
+ * CloudWatch unit names so backends that emit to CloudWatch can pass it
+ * through, but it carries no backend-specific semantics — a recorder is free
+ * to map or ignore it.
+ *
+ * @public
+ */
+export type MetricUnit = "Seconds" | "Microseconds" | "Milliseconds" | "Bytes" | "Kilobytes" | "Megabytes" | "Gigabytes" | "Terabytes" | "Bits" | "Kilobits" | "Megabits" | "Gigabits" | "Terabits" | "Percent" | "Count" | "None" | "Bytes/Second" | "Kilobytes/Second" | "Megabytes/Second" | "Gigabytes/Second" | "Terabytes/Second" | "Bits/Second" | "Kilobits/Second" | "Megabits/Second" | "Gigabits/Second" | "Terabits/Second" | "Count/Second";
+/**
+ * Backend-agnostic recorder for per-request metrics. The framework drives the
+ * lifecycle and records request-level metrics through this interface; user
+ * handlers record their own business metrics through the same methods. Concrete
+ * recorders (e.g. an EMF recorder, or a future OpenTelemetry recorder) translate
+ * these abstract calls into their own primitives.
+ *
+ * @typeParam Native - the concrete backend handle returned by
+ *   {@link MetricsRecorder.getMetrics}, e.g. an OpenTelemetry `Meter`. The
+ *   parameter is required so that native access is always typed rather than
+ *   erased to `unknown`.
+ *
+ * @public
+ */
+export interface MetricsRecorder<Native> {
+    /**
+     * Open the recorder for the current request. Called by the framework once at
+     * the start of request handling.
+     */
+    begin(): void;
+    /**
+     * Close the recorder for the current request. Called by the framework once at
+     * the end of request handling; this is where an implementation typically
+     * flushes its event.
+     */
+    end(): void;
+    /**
+     * Records the outcome and duration of a request. The concrete backend decides
+     * how to express this.
+     */
+    recordRequestOutcome(outcome: RequestOutcome, durationMs: number): void;
+    /**
+     * Records a count. Values should be non-negative for cross-backend portability.
+     */
+    addCount(name: string, value: number): void;
+    /**
+     * Records a duration in milliseconds.
+     */
+    addTime(name: string, value: number): void;
+    /**
+     * Records a level — a sampled value that should average meaningfully across
+     * calls (e.g. queue depth, batch size).
+     */
+    addLevel(name: string, value: number, unit?: MetricUnit): void;
+    /**
+     * Records a discrete data point where percentiles matter (e.g. per-call
+     * latency, item size).
+     */
+    addMetric(name: string, value: number, unit?: MetricUnit): void;
+    /**
+     * Records a unitless ratio (e.g. cache hit rate, throttle rate).
+     */
+    addRatio(name: string, value: number): void;
+    /**
+     * Attaches a property to the request's metrics. A nullish or empty value
+     * removes the property.
+     */
+    setProperty(name: string, value: string | null | undefined): void;
+    /**
+     * Returns the recorder's native backend handle, so callers can reach
+     * library-specific features the abstract methods do not expose (e.g. an
+     * OpenTelemetry `Meter`).
+     */
+    getMetrics(): Native;
+}
+/**
+ * Creates a per-request {@link MetricsRecorder}. Created once at startup and
+ * passed to the service handler; the framework calls {@link MetricsRecorderFactory.create}
+ * once per request to obtain a scoped recorder.
+ *
+ * @typeParam Native - the native backend handle exposed by recorders this
+ *   factory produces. See {@link MetricsRecorder}.
+ *
+ * @public
+ */
+export interface MetricsRecorderFactory<Native> {
+    create(): MetricsRecorder<Native>;
+}