@repost/client 0.2.0 → 0.4.0

package/dist/cjs/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../../../../src/testing/manual-clock.ts","../../../../src/testing/deterministic.ts","../../../../src/testing/recording-observer.ts","../../../../src/testing/stub-transport.ts","../../../../src/testing/index.ts"],"sourcesContent":["import type { Scheduler } from \"../types\";\n\ninterface ManualTimer {\n  readonly due: number;\n  readonly sequence: number;\n  resolve(): void;\n  reject(reason?: unknown): void;\n  cancelled: boolean;\n}\n\nexport class ManualClock {\n  private current = 0;\n  private sequence = 0;\n  private readonly timers: ManualTimer[] = [];\n\n  readonly monotonic = (): number => this.current;\n  readonly wall = (): number => this.current;\n  get nowMs(): number { return this.current; }\n\n  async advance(ms: number): Promise<void> {\n    if (!Number.isFinite(ms) || ms < 0) throw new RangeError(\"advance requires non-negative milliseconds\");\n    const target = this.current + ms;\n    while (true) {\n      this.timers.sort((left, right) => left.due - right.due || left.sequence - right.sequence);\n      const next = this.timers.find((timer) => !timer.cancelled && timer.due <= target);\n      if (!next) break;\n      this.timers.splice(this.timers.indexOf(next), 1);\n      this.current = next.due;\n      next.resolve();\n      await Promise.resolve();\n      await Promise.resolve();\n    }\n    this.current = target;\n    await Promise.resolve();\n  }\n\n  schedule(ms: number, signal?: AbortSignal): Promise<void> {\n    return new Promise((resolve, reject) => {\n      const timer: ManualTimer = {\n        due: this.current + ms,\n        sequence: ++this.sequence,\n        resolve,\n        reject,\n        cancelled: false,\n      };\n      if (signal?.aborted) {\n        timer.cancelled = true;\n        reject(signal.reason);\n        return;\n      }\n      signal?.addEventListener(\"abort\", () => {\n        if (timer.cancelled) return;\n        timer.cancelled = true;\n        reject(signal.reason);\n      }, { once: true });\n      this.timers.push(timer);\n    });\n  }\n}\n\nexport function manualScheduler(clock: ManualClock): Scheduler {\n  return { sleep: (ms, signal) => clock.schedule(ms, signal) };\n}\n","import type { Generators, RetryEntropy } from \"../types\";\n\nexport const TestDefaultValueGenerators = {\n  fixed(nowIso: string, uuid: string, cuid: string): Generators {\n    return { now: () => nowIso, uuid: () => uuid, cuid: () => cuid };\n  },\n  sequence(entries: Array<Partial<{ now: string; uuid: string; cuid: string }>>): Generators {\n    const indices = { now: 0, uuid: 0, cuid: 0 };\n    const next = (kind: keyof typeof indices): string => {\n      const value = entries[indices[kind]++]?.[kind];\n      if (value === undefined) throw new Error(`${kind} sequence exhausted`);\n      return value;\n    };\n    return { now: () => next(\"now\"), uuid: () => next(\"uuid\"), cuid: () => next(\"cuid\") };\n  },\n  failing(error = new Error(\"default generator failed\")): Generators {\n    const fail = (): never => { throw error; };\n    return { now: fail, uuid: fail, cuid: fail };\n  },\n};\n\nexport const TestIdempotencyKeyGenerator = {\n  fixed(key: string): () => string { return () => key; },\n  sequence(...keys: string[]): () => string {\n    let index = 0;\n    return () => {\n      const key = keys[index++];\n      if (key === undefined) throw new Error(\"idempotency key sequence exhausted\");\n      return key;\n    };\n  },\n  failing(error = new Error(\"idempotency key generator failed\")): () => string {\n    return () => { throw error; };\n  },\n};\n\nexport const DeterministicRetryEntropy = {\n  zero(): RetryEntropy { return { nextInt: () => 0 }; },\n  sequence(...values: number[]): RetryEntropy {\n    let index = 0;\n    return {\n      nextInt(exclusiveBound) {\n        const value = values[index++];\n        if (value === undefined) throw new Error(\"entropy sequence exhausted\");\n        if (!Number.isInteger(value) || value < 0 || value >= exclusiveBound) throw new RangeError(\"entropy value out of range\");\n        return value;\n      },\n    };\n  },\n};\n","import { observerFlush, type FlushableObserver, type ObserverEvent } from \"../observer\";\n\nexport class RecordingObserver {\n  private readonly recorded: ObserverEvent[] = [];\n  private readonly waiters: Array<(event: ObserverEvent) => void> = [];\n\n  readonly callback: FlushableObserver = Object.assign(\n    (event: ObserverEvent) => {\n      this.recorded.push(event);\n      this.waiters.shift()?.(event);\n    },\n    { [observerFlush]: async () => {} },\n  );\n\n  get events(): readonly ObserverEvent[] { return Object.freeze([...this.recorded]); }\n\n  awaitNext(options: { timeoutMs?: number } = {}): Promise<ObserverEvent> {\n    const timeoutMs = options.timeoutMs ?? 1_000;\n    return new Promise((resolve, reject) => {\n      const waiter = (event: ObserverEvent): void => { clearTimeout(timer); resolve(event); };\n      const timer = setTimeout(() => {\n        const index = this.waiters.indexOf(waiter);\n        if (index >= 0) this.waiters.splice(index, 1);\n        reject(new Error(\"observer event timeout\"));\n      }, timeoutMs);\n      this.waiters.push(waiter);\n    });\n  }\n\n  async awaitQuiescence(): Promise<void> {\n    await this.callback[observerFlush]?.();\n  }\n}\n","import type { AttemptOutcome, AttemptRequest, Transport } from \"../types\";\nimport type { RepostFailureReason } from \"../errors\";\n\ntype FailureCode = \"DNS\" | \"CONNECT\" | \"PROXY\" | \"TLS\" | \"IO\" | \"ATTEMPT_TIMEOUT\";\n\nexport interface RecordedRequest {\n  readonly url: string;\n  readonly headers: Readonly<Record<string, string>>;\n  readonly bodyText: string;\n  readonly bodyBytes: Uint8Array;\n  readonly attemptNumber: number;\n  readonly idempotencyKey: string;\n  readonly attemptTimeoutMs: number;\n  readonly captureSequence: number;\n}\n\nexport interface ControlledResponse {\n  respond(status: number, body: string, headers?: Record<string, string>): void;\n  fail(code: FailureCode, options?: { reason?: RepostFailureReason; committed?: boolean }): void;\n  readonly isDone: boolean;\n}\n\nexport class ScriptedStubTransport implements Transport {\n  private readonly script: Array<(request: AttemptRequest) => Promise<AttemptOutcome>> = [];\n  private readonly captured: RecordedRequest[] = [];\n  private sequence = 0;\n\n  get requests(): readonly RecordedRequest[] { return Object.freeze([...this.captured]); }\n\n  enqueueResponse(status: number, body: string, headers: Record<string, string> = {}): this {\n    this.script.push(async (request) => responseOutcome(request, status, body, headers));\n    return this;\n  }\n\n  enqueueFailure(\n    code: FailureCode,\n    options: { reason?: RepostFailureReason; committed?: boolean } = {},\n  ): this {\n    this.script.push(async (request) => {\n      if (options.committed) request.commitTracker.markCommitted();\n      return { kind: \"failure\", code, reason: options.reason ?? null, committed: options.committed ?? false };\n    });\n    return this;\n  }\n\n  enqueuePending(): ControlledResponse {\n    let settle: ((outcome: AttemptOutcome) => void) | undefined;\n    let pending: AttemptOutcome | undefined;\n    let done = false;\n    this.script.push((request) => {\n      if (pending) {\n        if (pending.kind === \"response\" || pending.committed) request.commitTracker.markCommitted();\n        return Promise.resolve(pending);\n      }\n      return new Promise((resolve) => {\n        settle = (outcome) => {\n          if (outcome.kind === \"response\" || outcome.committed) request.commitTracker.markCommitted();\n          resolve(outcome);\n        };\n        request.signal.addEventListener(\"abort\", () => {\n          if (!done) complete({ kind: \"failure\", code: \"ATTEMPT_TIMEOUT\", reason: null, committed: request.commitTracker.committed });\n        }, { once: true });\n      });\n    });\n    const complete = (outcome: AttemptOutcome): void => {\n      if (done) return;\n      done = true;\n      pending = outcome;\n      settle?.(outcome);\n    };\n    return {\n      respond(status, body, headers = {}) { complete(responseOutcome(undefined, status, body, headers)); },\n      fail(code, options = {}) { complete({ kind: \"failure\", code, reason: options.reason ?? null, committed: options.committed ?? false }); },\n      get isDone() { return done; },\n    };\n  }\n\n  async send(request: AttemptRequest): Promise<AttemptOutcome> {\n    const next = this.script.shift();\n    if (!next) throw new Error(\"script exhausted\");\n    this.sequence += 1;\n    const headers = Object.fromEntries(request.headers.map(([name, value]) => [name, name.toLowerCase() === \"authorization\" ? \"<redacted>\" : value]));\n    this.captured.push(Object.freeze({\n      url: request.url,\n      headers: Object.freeze(headers),\n      bodyText: new TextDecoder().decode(request.bodyBytes),\n      bodyBytes: request.bodyBytes.slice(),\n      attemptNumber: request.attemptNumber,\n      idempotencyKey: headers[\"idempotency-key\"] ?? \"\",\n      attemptTimeoutMs: request.attemptTimeoutMs,\n      captureSequence: this.sequence,\n    }));\n    return next(request);\n  }\n}\n\nfunction responseOutcome(\n  request: AttemptRequest | undefined,\n  status: number,\n  body: string,\n  headers: Record<string, string>,\n): AttemptOutcome {\n  request?.commitTracker.markCommitted();\n  const bodyBytes = new TextEncoder().encode(body);\n  return {\n    kind: \"response\",\n    status,\n    headers: Object.fromEntries(Object.entries(headers).map(([name, value]) => [name.toLowerCase(), [value]])),\n    bodyBytes,\n    compressedBytes: bodyBytes.length,\n    decompressedBytes: bodyBytes.length,\n    truncated: false,\n  };\n}\n","import type { RepostClientOptions } from \"../types\";\nimport { ManualClock, manualScheduler } from \"./manual-clock\";\nimport { DeterministicRetryEntropy, TestDefaultValueGenerators, TestIdempotencyKeyGenerator } from \"./deterministic\";\nimport { RecordingObserver } from \"./recording-observer\";\nimport { ScriptedStubTransport, type ControlledResponse, type RecordedRequest } from \"./stub-transport\";\n\nexport { ManualClock, manualScheduler };\nexport { DeterministicRetryEntropy, TestDefaultValueGenerators, TestIdempotencyKeyGenerator };\nexport { RecordingObserver };\nexport { ScriptedStubTransport };\nexport type { ControlledResponse, RecordedRequest };\n\nexport function deterministicClientOptions(overrides: Partial<RepostClientOptions> = {}): {\n  options: RepostClientOptions;\n  transport: ScriptedStubTransport;\n  observer: RecordingObserver;\n  clock: ManualClock;\n} {\n  const transport = new ScriptedStubTransport();\n  const observer = new RecordingObserver();\n  const clock = new ManualClock();\n  return {\n    transport,\n    observer,\n    clock,\n    options: {\n      apiKey: \"test-key\",\n      transport,\n      observer: observer.callback,\n      generators: TestDefaultValueGenerators.fixed(\n        \"2026-01-01T00:00:00.000Z\",\n        \"00000000-0000-4000-8000-000000000000\",\n        \"ck0nf0rm4nc3f1x3dcu1d000\",\n      ),\n      idempotencyKeyGenerator: TestIdempotencyKeyGenerator.fixed(\"idem_test\"),\n      retryEntropy: DeterministicRetryEntropy.zero(),\n      monotonicClock: clock.monotonic,\n      wallClock: clock.wall,\n      scheduler: manualScheduler(clock),\n      ...overrides,\n    },\n  };\n}\n"],"names":["observerFlush"],"mappings":"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"}

package/dist/cjs/types/config.d.ts

@@ -0,0 +1,28 @@
+import type { Generators, RepostClientOptions, RetryEntropy, Scheduler, Transport } from "./types";
+export interface ResolvedClientOptions {
+    readonly apiKey?: string;
+    readonly apiKeyProvider?: () => string | Promise<string>;
+    readonly apiUrl: string;
+    readonly transport?: Transport;
+    readonly httpTransportOptions?: import("./transport").HttpTransportOptions;
+    readonly generators?: Generators;
+    readonly attemptTimeoutMs: number;
+    readonly operationTimeoutMs: number;
+    readonly connectTimeoutMs: number;
+    readonly maxAttempts: number;
+    readonly retryBaseDelayMs: number;
+    readonly retryMaxDelayMs: number;
+    readonly maxInFlightOperations: number;
+    readonly maxBufferedBytes: number;
+    readonly idempotencyKeyGenerator: (() => string) | false;
+    readonly retryEntropy: RetryEntropy;
+    readonly monotonicClock: () => number;
+    readonly wallClock: () => number;
+    readonly scheduler: Scheduler;
+    readonly userAgent: string;
+    readonly observer?: import("./observer").RepostObserver;
+    readonly telemetry?: import("./telemetry").RepostTelemetry;
+}
+export declare function snapshotOptions(options: RepostClientOptions): ResolvedClientOptions;
+export declare function canonicalizeBaseUrl(raw: string): string;
+export declare function endpointUrl(base: string): string;

package/dist/cjs/types/errors.d.ts

@@ -0,0 +1,83 @@
+export type RepostErrorCode = "CONFIGURATION" | "CLOSED" | "VALIDATION" | "SERIALIZATION" | "REQUEST_TOO_LARGE" | "DNS" | "CONNECT" | "PROXY" | "TLS" | "IO" | "ATTEMPT_TIMEOUT" | "OPERATION_DEADLINE" | "CANCELLED" | "OVERLOADED" | "RATE_LIMITED" | "HTTP_REJECTED" | "SERVER_FAILURE" | "RESPONSE_TOO_LARGE" | "RESPONSE_PROTOCOL" | "DESCRIPTOR_VERSION";
+export type DeliveryState = "NOT_SENT" | "POSSIBLY_SENT" | "ACCEPTED" | "REJECTED" | "CANCELLED_UNKNOWN";
+export type HttpStatusClass = "INFORMATIONAL" | "SUCCESS" | "REDIRECT" | "CLIENT_ERROR" | "SERVER_ERROR";
+export type RepostFailureReason = "DNS_NOT_FOUND" | "DNS_TIMEOUT" | "CONNECT_REFUSED" | "CONNECT_TIMEOUT" | "CONNECTION_RESET" | "CONNECTION_CLOSED" | "TLS_UNTRUSTED" | "TLS_CERTIFICATE_EXPIRED" | "TLS_CERTIFICATE_NOT_YET_VALID" | "TLS_HOSTNAME_MISMATCH" | "TLS_NEGOTIATION" | "PROXY_AUTH_REQUIRED" | "PROXY_CONNECT_FAILED" | "UNKNOWN";
+export type RepostCauseCategory = "API_KEY_PROVIDER" | "DEFAULT_GENERATOR" | "IDEMPOTENCY_GENERATOR" | "RETRY_ENTROPY" | "DNS_RESOLVER" | "PROXY_CREDENTIAL_PROVIDER" | "TLS_PROVIDER" | "CUSTOM_TRANSPORT" | "RESPONSE_BODY" | "OBSERVER" | "HTTP_RUNTIME" | "TRANSPORT_CLOSE" | "SCHEDULER_CLOSE" | "OPERATION_EXECUTOR_CLOSE" | "DNS_EXECUTOR_CLOSE" | "PROXY_CREDENTIAL_EXECUTOR_CLOSE" | "TLS_EXECUTOR_CLOSE" | "TERMINAL_SETTLEMENT_CLOSE" | "OBSERVER_CLOSE" | "UNKNOWN";
+export type ValidationIssueCode = "REQUIRED" | "NULL_NOT_ALLOWED" | "TYPE_MISMATCH" | "OUT_OF_RANGE" | "NON_FINITE" | "INVALID_DATETIME" | "INVALID_ENUM" | "INVALID_JSON" | "INVALID_UNICODE" | "COLLECTION_LIMIT" | "CYCLE";
+export type ConfigurationIssueCode = "MISSING" | "CONFLICT" | "INVALID_VALUE" | "OUT_OF_RANGE" | "UNSUPPORTED" | "RESOURCE_MISMATCH";
+export type ClientOptionKey = "API_KEY" | "API_KEY_PROVIDER" | "BASE_URI" | "CONNECT_TIMEOUT" | "ATTEMPT_TIMEOUT" | "OPERATION_TIMEOUT" | "MAX_ATTEMPTS" | "MAX_IN_FLIGHT_OPERATIONS" | "MAX_BUFFERED_BYTES" | "RETRY_BASE_DELAY" | "RETRY_MAX_DELAY" | "HTTP_TRANSPORT_OPTIONS" | "TRANSPORT" | "EXECUTOR" | "SCHEDULER" | "OBSERVER" | "OBSERVER_EXECUTOR" | "TELEMETRY" | "DEFAULT_VALUE_GENERATORS" | "IDEMPOTENCY_KEY_GENERATOR" | "MONOTONIC_CLOCK" | "WALL_CLOCK" | "RETRY_ENTROPY" | "USER_AGENT_SUFFIX";
+export interface ValidationIssue {
+    readonly code: ValidationIssueCode;
+    readonly path: string;
+    readonly message: string;
+}
+export interface ConfigurationIssue {
+    readonly code: ConfigurationIssueCode;
+    readonly optionKeys: readonly ClientOptionKey[];
+}
+export declare const errorCatalog: Readonly<Record<RepostErrorCode, string>>;
+export interface RepostErrorDetails {
+    readonly errorCode: RepostErrorCode;
+    readonly deliveryState: DeliveryState;
+    readonly retryable?: boolean;
+    readonly operationId?: string | null;
+    readonly idempotencyKey?: string | null;
+    readonly attemptCount?: number;
+    readonly httpStatus?: number | null;
+    readonly failureReason?: RepostFailureReason | null;
+    readonly causeCategory?: RepostCauseCategory | null;
+    readonly compressedBytes?: number;
+    readonly decompressedBytes?: number;
+    readonly responseHeaderFields?: number;
+    readonly responseHeaderBytes?: number;
+    readonly truncated?: boolean;
+    readonly validationIssues?: readonly ValidationIssue[];
+    readonly configurationIssues?: readonly ConfigurationIssue[];
+    readonly body?: unknown;
+    readonly closeFailureCount?: number;
+    readonly closeFailureCategories?: readonly RepostCauseCategory[];
+    readonly issueCount?: number;
+    readonly issuesTruncated?: boolean;
+    readonly remediationKey?: string | null;
+}
+export declare class RepostError extends Error {
+    readonly errorCode: RepostErrorCode;
+    readonly deliveryState: DeliveryState;
+    readonly retryable: boolean;
+    readonly operationId: string | null;
+    readonly idempotencyKey: string | null;
+    readonly attemptCount: number;
+    readonly httpStatus: number | null;
+    readonly failureReason: RepostFailureReason | null;
+    readonly causeCategory: RepostCauseCategory | null;
+    readonly compressedBytes: number;
+    readonly decompressedBytes: number;
+    readonly responseHeaderFields: number;
+    readonly responseHeaderBytes: number;
+    readonly truncated: boolean;
+    readonly validationIssues: readonly ValidationIssue[];
+    readonly configurationIssues: readonly ConfigurationIssue[];
+    readonly closeFailureCount: number;
+    readonly closeFailureCategories: readonly RepostCauseCategory[];
+    readonly issueCount: number;
+    readonly issuesTruncated: boolean;
+    readonly remediationKey: string | null;
+    constructor(details: RepostErrorDetails);
+    isRetryable(): boolean;
+}
+export declare class RepostConfigurationError extends RepostError {
+}
+export declare class RepostValidationError extends RepostError {
+}
+export declare class RepostSerializationError extends RepostError {
+}
+export declare class RepostTransportError extends RepostError {
+}
+export declare class RepostPublishError extends RepostError {
+    readonly status?: number;
+    readonly body?: unknown;
+    constructor(details: RepostErrorDetails);
+    constructor(_legacyMessage: string, status?: number, body?: unknown);
+}
+export declare class RepostDescriptorVersionError extends RepostError {
+}

package/dist/cjs/types/index.d.ts

@@ -1,5 +1,10 @@
 export { serializeModel } from "./serialize";
-export type { DefaultSpec, Envelope, EventDescriptor, FieldDescriptor, ModelDescriptor, RepostClientOptions, SchemaDescriptor, SendRequest, SendResult, Transport, WebhookDescriptors, } from "./types";
-export { createHttpTransport, httpTransport, RepostPublishError } from "./transport";
+export type { DefaultSpec, Envelope, EnumDescriptors, EventDescriptor, FieldDescriptor, FieldDescriptorV2, Generators, ModelDescriptor, RepostClientOptions, SchemaDescriptor, ScalarKind, AttemptRequest, AttemptOutcome, BoundedHeaders, CommitTracker, SendResult, SendOperation, SendOperationOutcome, Transport, RetryEntropy, Scheduler, WebhookDescriptors, } from "./types";
+export { createFetchTransport, createHttpTransport, createNodeTransport, httpTransport, RepostPublishError } from "./transport";
 export type { HttpTransportOptions } from "./transport";
-export { buildWebhooks, stubTransport } from "./webhooks";
+export { RepostConfigurationError, RepostDescriptorVersionError, RepostError, RepostSerializationError, RepostTransportError, RepostValidationError, errorCatalog, } from "./errors";
+export type { ClientOptionKey, ConfigurationIssue, ConfigurationIssueCode, DeliveryState, HttpStatusClass, RepostCauseCategory, RepostErrorCode, RepostErrorDetails, RepostFailureReason, ValidationIssue, ValidationIssueCode, } from "./errors";
+export { DESCRIPTOR_FORMAT_VERSION, buildClient, buildWebhooks, stubTransport } from "./webhooks";
+export type { RuntimeDiagnostics } from "./runtime-state";
+export type { AttemptSummary, ObserverEvent, ObserverEventKind, ObserverOutcome, RepostObserver, } from "./observer";
+export type { CapturedTelemetryContext, RepostTelemetry, TelemetryAttempt, TelemetryAttemptEnd, TelemetryAttemptStart, TelemetryOperation, TelemetryOperationEnd, TelemetryOperationStart, } from "./telemetry";

package/dist/cjs/types/observer.d.ts

@@ -0,0 +1,44 @@
+import type { DeliveryState, HttpStatusClass, RepostErrorCode } from "./errors";
+import type { RuntimeState } from "./runtime-state";
+export type ObserverEventKind = "operation.start" | "attempt.start" | "attempt.end" | "retry.delay" | "operation.cancel" | "operation.end";
+export type ObserverOutcome = "ACCEPTED" | "RETRYABLE_FAILURE" | "REJECTED" | "FAILED" | "CANCELLED" | "CLOSED";
+export interface AttemptSummary {
+    readonly attemptNumber: number;
+    readonly outcome: ObserverOutcome;
+    readonly errorCode: RepostErrorCode | null;
+    readonly deliveryState: DeliveryState | null;
+    readonly httpStatusClass: HttpStatusClass | null;
+    readonly durationMs: number;
+}
+export interface ObserverEvent {
+    readonly schemaVersion: 1;
+    readonly kind: ObserverEventKind;
+    readonly operationId: string;
+    readonly timestampMs: number;
+    readonly attemptNumber: number | null;
+    readonly durationMs: number | null;
+    readonly outcome: ObserverOutcome | null;
+    readonly errorCode: RepostErrorCode | null;
+    readonly deliveryState: DeliveryState | null;
+    readonly httpStatusClass: HttpStatusClass | null;
+    readonly retryDelayMs: number | null;
+    readonly operationStartedAtMs: number | null;
+    readonly operationEndedAtMs: number | null;
+    readonly attemptSummaries: readonly AttemptSummary[];
+}
+export type RepostObserver = (event: ObserverEvent) => void | Promise<void>;
+export declare const observerFlush: unique symbol;
+export type FlushableObserver = RepostObserver & {
+    [observerFlush]?: () => Promise<void>;
+};
+export declare class ObserverDispatcher {
+    private readonly callback;
+    private readonly state;
+    private readonly queue;
+    private readonly flushWaiters;
+    private draining;
+    constructor(callback: RepostObserver | undefined, state: RuntimeState);
+    emit(event: ObserverEvent): void;
+    flush(): Promise<void>;
+    private drain;
+}

package/dist/cjs/types/operation-events.d.ts

@@ -0,0 +1,8 @@
+import type { RepostError } from "./errors";
+import type { AttemptSummary, ObserverEvent, ObserverOutcome } from "./observer";
+import type { TelemetryAttemptEnd } from "./telemetry";
+import type { AttemptOutcome } from "./types";
+export declare function observerEvent(kind: ObserverEvent["kind"], operationId: string, timestampMs: number, values?: Partial<ObserverEvent>): ObserverEvent;
+export declare function attemptSummary(attemptNumber: number, outcome: ObserverOutcome, error: RepostError | null, attempt: AttemptOutcome, durationMs: number): AttemptSummary;
+export declare function statusClass(status: number): AttemptSummary["httpStatusClass"];
+export declare function telemetryAttemptEnd(summary: AttemptSummary): TelemetryAttemptEnd;

package/dist/cjs/types/operation-input.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedClientOptions } from "./config";
+import type { EventDescriptor, SchemaDescriptor } from "./types";
+export declare function resolveCredential(config: ResolvedClientOptions, operationId: string): Promise<string>;
+export declare function resolveIdempotencyKey(config: ResolvedClientOptions, supplied: string | undefined, operationId: string): string;
+export declare function serializeForSend(schema: SchemaDescriptor, event: EventDescriptor, data: unknown, generators: Required<NonNullable<ResolvedClientOptions["generators"]>>, operationId: string, idempotencyKey: string): Record<string, unknown>;

package/dist/cjs/types/operation-policy.d.ts

@@ -0,0 +1,23 @@
+import { RepostError, RepostTransportError, type DeliveryState, type RepostErrorCode, type RepostErrorDetails, type RepostFailureReason } from "./errors";
+import type { AttemptOutcome, BoundedHeaders, SendResult } from "./types";
+interface ClassifiedFailure {
+    code: RepostErrorCode;
+    retryable: boolean;
+    deliveryState: DeliveryState;
+    reason: RepostFailureReason | null;
+    acceptancePossible: boolean;
+}
+export declare function classifyOutcome(outcome: AttemptOutcome, priorPossible: boolean): ClassifiedFailure;
+export declare function validateAcceptedResponse(outcome: Extract<AttemptOutcome, {
+    kind: "response";
+}>, envelope: {
+    type: string;
+    timestamp: string;
+}, customerId: string): SendResult | "LIMIT_EXCEEDED" | null;
+export declare function parseRetryAfter(headers: BoundedHeaders, wallNow: number): number | null;
+export declare function publicError(code: RepostErrorCode, deliveryState: DeliveryState, retryable: boolean, operationId: string, idempotencyKey: string, attemptCount: number, outcome: AttemptOutcome, failureReason: RepostFailureReason | null): RepostError;
+export declare function cancelled(operationId: string, idempotencyKey: string | null, attemptCount: number, committed: boolean, outcome?: AttemptOutcome | null): RepostTransportError;
+export declare function closed(operationId: string | null, idempotencyKey: string | null, attemptCount: number, committed: boolean, outcome?: AttemptOutcome | null): RepostTransportError;
+export declare function deadlineError(operationId: string, idempotencyKey: string | null, attemptCount: number, committed: boolean, outcome?: AttemptOutcome | null): RepostTransportError;
+export declare function responseDetails(outcome: AttemptOutcome | null): Pick<RepostErrorDetails, "httpStatus" | "compressedBytes" | "decompressedBytes" | "truncated" | "responseHeaderFields" | "responseHeaderBytes">;
+export {};

package/dist/cjs/types/operation.d.ts

@@ -0,0 +1,14 @@
+import { type ResolvedClientOptions } from "./config";
+import type { EventDescriptor, SchemaDescriptor, SendOperation, SendResult } from "./types";
+import { RuntimeState } from "./runtime-state";
+export interface SendInput {
+    readonly customerId: string;
+    readonly data: unknown;
+    readonly idempotencyKey?: string;
+    readonly signal?: AbortSignal;
+}
+export interface SendOperationRuntime {
+    send(event: EventDescriptor, input: SendInput): SendOperation<SendResult>;
+    close(): void;
+}
+export declare function createSendOperation(config: ResolvedClientOptions, schema: SchemaDescriptor, state: RuntimeState): SendOperationRuntime;

package/dist/cjs/types/otel/index.d.ts

@@ -0,0 +1,2 @@
+export { openTelemetryRepostMetrics } from "./metrics";
+export { openTelemetryRepostTelemetry } from "./telemetry";

package/dist/cjs/types/otel/metrics.d.ts

@@ -0,0 +1,5 @@
+import { type MeterProvider } from "@opentelemetry/api";
+import type { RepostObserver } from "../observer";
+export declare function openTelemetryRepostMetrics(options?: {
+    meterProvider?: MeterProvider;
+}): RepostObserver;

package/dist/cjs/types/otel/telemetry.d.ts

@@ -0,0 +1,5 @@
+import { type TracerProvider } from "@opentelemetry/api";
+import type { RepostTelemetry } from "../telemetry";
+export declare function openTelemetryRepostTelemetry(options?: {
+    tracerProvider?: TracerProvider;
+}): RepostTelemetry;

package/dist/cjs/types/runtime-state.d.ts

@@ -0,0 +1,45 @@
+export declare const PORTABLE_OPERATION_WORKSPACE_BYTES = 2359296;
+export interface RuntimeDiagnostics {
+    readonly inFlightOperations: number;
+    readonly bufferedBytes: number;
+    readonly concurrencyOverloadRejections: number;
+    readonly requestByteOverloadRejections: number;
+    readonly responseByteOverloadRejections: number;
+    readonly responseHeaderLimitFailures: number;
+    readonly executorOverloadRejections: number;
+    readonly schedulerOverloadRejections: number;
+    readonly responseCloseFailures: number;
+    readonly droppedObserverEvents: number;
+    readonly observerFailures: number;
+    readonly closed: boolean;
+}
+export declare class RuntimeState {
+    private readonly maxInFlightOperations;
+    private readonly maxBufferedBytes;
+    private inFlightOperations;
+    private bufferedBytes;
+    private concurrencyOverloadRejections;
+    private requestByteOverloadRejections;
+    private responseHeaderLimitFailures;
+    private responseCloseFailures;
+    private droppedObserverEvents;
+    private observerFailures;
+    private closing;
+    private closed;
+    private readonly active;
+    constructor(maxInFlightOperations: number, maxBufferedBytes: number);
+    admit(): Admission | null;
+    isClosing(): boolean;
+    close(): void;
+    diagnostics(): RuntimeDiagnostics;
+    observerDropped(): void;
+    observerFailed(): void;
+    responseHeaderLimitFailed(): void;
+    responseCloseFailed(): void;
+    seedDiagnosticCounter(counter: "concurrencyOverloadRejections", value: number): void;
+}
+export interface Admission {
+    readonly signal: AbortSignal;
+    retainSerializedRequest(bodyBytes: number): void;
+    release(): void;
+}

package/dist/cjs/types/serialize.d.ts

@@ -1,10 +1,16 @@
-import type { ModelDescriptor } from "./types";
+import type { EnumDescriptors, Generators, ModelDescriptor } from "./types";
+/** Fill the runtime's injectable clock and ID generators with real defaults. */
+export declare function resolveGenerators(generators?: Generators): Required<Generators>;
 /**
  * Serialize a send input into its wire payload, driven by the generated model
  * descriptors: fields are emitted in declaration order under their `@map`'d
  * wire names, absent fields with an `@default` are injected (literals
  * verbatim, `now()`/`uuid()`/`cuid()` generated at send time), absent optional
  * fields are omitted, nested models recurse, and enum members serialize to
- * their (possibly `@map`'d) wire values.
+ * their (possibly `@map`'d) wire values. `generators` overrides the clock and
+ * id sources for deterministic tests (the conformance suite's seam).
  */
-export declare function serializeModel(models: Record<string, ModelDescriptor>, modelName: string, data: unknown): Record<string, unknown>;
+export declare function serializeModel(models: Record<string, ModelDescriptor>, modelName: string, data: unknown, generators?: Generators, enums?: EnumDescriptors): Record<string, unknown>;
+export declare function compareUnicodeScalarValues(left: string, right: string): number;
+export declare function validateModelDescriptors(models: Record<string, ModelDescriptor>, enums: EnumDescriptors): void;
+export declare function appendPath(path: string, key: string): string;

package/dist/cjs/types/telemetry.d.ts

@@ -0,0 +1,43 @@
+import type { HttpStatusClass, RepostErrorCode } from "./errors";
+import type { ObserverOutcome } from "./observer";
+export type CapturedTelemetryContext = unknown;
+export interface TelemetryOperationStart {
+    readonly startedAtMs: number;
+}
+export interface TelemetryOperationEnd {
+    readonly outcome: ObserverOutcome;
+    readonly errorCode: RepostErrorCode | null;
+    readonly durationMs: number;
+}
+export interface TelemetryAttemptStart {
+    readonly startedAtMs: number;
+    readonly attemptNumber: number;
+}
+export interface TelemetryAttemptEnd {
+    readonly httpStatusClass: HttpStatusClass | null;
+    readonly outcome: ObserverOutcome;
+    readonly errorCode: RepostErrorCode | null;
+    readonly durationMs: number;
+}
+export interface TelemetryAttempt {
+    propagationHeaders(): Record<string, string> | null;
+    end(end: TelemetryAttemptEnd): void;
+}
+export interface TelemetryOperation {
+    startAttempt(start: TelemetryAttemptStart): TelemetryAttempt;
+    end(end: TelemetryOperationEnd): void;
+}
+export interface RepostTelemetry {
+    captureContext(): CapturedTelemetryContext;
+    startOperation(parent: CapturedTelemetryContext, start: TelemetryOperationStart): TelemetryOperation;
+}
+export declare class TelemetryInvoker {
+    private readonly telemetry;
+    constructor(telemetry: RepostTelemetry | undefined);
+    capture(): CapturedTelemetryContext | null;
+    startOperation(parent: CapturedTelemetryContext | null, start: TelemetryOperationStart): TelemetryOperation | null;
+    startAttempt(operation: TelemetryOperation | null, start: TelemetryAttemptStart): TelemetryAttempt | null;
+    headers(attempt: TelemetryAttempt | null): readonly (readonly [string, string])[];
+    endAttempt(attempt: TelemetryAttempt | null, end: TelemetryAttemptEnd): void;
+    endOperation(operation: TelemetryOperation | null, end: TelemetryOperationEnd): void;
+}

package/dist/cjs/types/testing/deterministic.d.ts

@@ -0,0 +1,19 @@
+import type { Generators, RetryEntropy } from "../types";
+export declare const TestDefaultValueGenerators: {
+    fixed(nowIso: string, uuid: string, cuid: string): Generators;
+    sequence(entries: Array<Partial<{
+        now: string;
+        uuid: string;
+        cuid: string;
+    }>>): Generators;
+    failing(error?: Error): Generators;
+};
+export declare const TestIdempotencyKeyGenerator: {
+    fixed(key: string): () => string;
+    sequence(...keys: string[]): () => string;
+    failing(error?: Error): () => string;
+};
+export declare const DeterministicRetryEntropy: {
+    zero(): RetryEntropy;
+    sequence(...values: number[]): RetryEntropy;
+};

package/dist/cjs/types/testing/index.d.ts

@@ -0,0 +1,16 @@
+import type { RepostClientOptions } from "../types";
+import { ManualClock, manualScheduler } from "./manual-clock";
+import { DeterministicRetryEntropy, TestDefaultValueGenerators, TestIdempotencyKeyGenerator } from "./deterministic";
+import { RecordingObserver } from "./recording-observer";
+import { ScriptedStubTransport, type ControlledResponse, type RecordedRequest } from "./stub-transport";
+export { ManualClock, manualScheduler };
+export { DeterministicRetryEntropy, TestDefaultValueGenerators, TestIdempotencyKeyGenerator };
+export { RecordingObserver };
+export { ScriptedStubTransport };
+export type { ControlledResponse, RecordedRequest };
+export declare function deterministicClientOptions(overrides?: Partial<RepostClientOptions>): {
+    options: RepostClientOptions;
+    transport: ScriptedStubTransport;
+    observer: RecordingObserver;
+    clock: ManualClock;
+};

package/dist/cjs/types/testing/manual-clock.d.ts

@@ -0,0 +1,12 @@
+import type { Scheduler } from "../types";
+export declare class ManualClock {
+    private current;
+    private sequence;
+    private readonly timers;
+    readonly monotonic: () => number;
+    readonly wall: () => number;
+    get nowMs(): number;
+    advance(ms: number): Promise<void>;
+    schedule(ms: number, signal?: AbortSignal): Promise<void>;
+}
+export declare function manualScheduler(clock: ManualClock): Scheduler;

package/dist/cjs/types/testing/recording-observer.d.ts

@@ -0,0 +1,11 @@
+import { type FlushableObserver, type ObserverEvent } from "../observer";
+export declare class RecordingObserver {
+    private readonly recorded;
+    private readonly waiters;
+    readonly callback: FlushableObserver;
+    get events(): readonly ObserverEvent[];
+    awaitNext(options?: {
+        timeoutMs?: number;
+    }): Promise<ObserverEvent>;
+    awaitQuiescence(): Promise<void>;
+}

package/dist/cjs/types/testing/stub-transport.d.ts

@@ -0,0 +1,35 @@
+import type { AttemptOutcome, AttemptRequest, Transport } from "../types";
+import type { RepostFailureReason } from "../errors";
+type FailureCode = "DNS" | "CONNECT" | "PROXY" | "TLS" | "IO" | "ATTEMPT_TIMEOUT";
+export interface RecordedRequest {
+    readonly url: string;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly bodyText: string;
+    readonly bodyBytes: Uint8Array;
+    readonly attemptNumber: number;
+    readonly idempotencyKey: string;
+    readonly attemptTimeoutMs: number;
+    readonly captureSequence: number;
+}
+export interface ControlledResponse {
+    respond(status: number, body: string, headers?: Record<string, string>): void;
+    fail(code: FailureCode, options?: {
+        reason?: RepostFailureReason;
+        committed?: boolean;
+    }): void;
+    readonly isDone: boolean;
+}
+export declare class ScriptedStubTransport implements Transport {
+    private readonly script;
+    private readonly captured;
+    private sequence;
+    get requests(): readonly RecordedRequest[];
+    enqueueResponse(status: number, body: string, headers?: Record<string, string>): this;
+    enqueueFailure(code: FailureCode, options?: {
+        reason?: RepostFailureReason;
+        committed?: boolean;
+    }): this;
+    enqueuePending(): ControlledResponse;
+    send(request: AttemptRequest): Promise<AttemptOutcome>;
+}
+export {};

package/dist/cjs/types/transport/connect-proxy.d.ts

@@ -0,0 +1,30 @@
+import { type Socket } from "node:net";
+import { type TLSSocket } from "node:tls";
+export interface ProxyOptions {
+    readonly url: string;
+    readonly credentialsProvider?: () => {
+        username: string;
+        password: string;
+    } | Promise<{
+        username: string;
+        password: string;
+    }>;
+}
+export interface ProxyTarget {
+    readonly hostname: string;
+    readonly port: string;
+    readonly protocol: string;
+    readonly servername?: string;
+}
+export interface ProxyTlsOptions {
+    readonly caCertificates?: readonly string[];
+    readonly minVersion?: "TLSv1.2" | "TLSv1.3";
+    readonly maxVersion?: "TLSv1.2" | "TLSv1.3";
+    readonly ciphers?: readonly string[];
+    readonly clientCertificate?: {
+        readonly certificate: string;
+        readonly key: string;
+        readonly passphrase?: string;
+    };
+}
+export declare function connectThroughProxy(proxy: ProxyOptions, target: ProxyTarget, tls: ProxyTlsOptions | undefined, allowH2: boolean, timeoutMs: number): Promise<Socket | TLSSocket>;

package/dist/cjs/types/transport/failure.d.ts

@@ -0,0 +1,7 @@
+import type { AttemptOutcome } from "../types";
+type FailureOutcome = Extract<AttemptOutcome, {
+    kind: "failure";
+}>;
+export declare function classifyNetworkFailure(error: unknown, committed?: boolean): FailureOutcome | null;
+export declare function errorCode(error: unknown): string;
+export {};

package/dist/cjs/types/transport/framing.d.ts

@@ -0,0 +1,8 @@
+import type { AttemptRequest } from "../types";
+export interface FramedRequest {
+    readonly origin: string;
+    readonly path: string;
+    readonly headers: string[];
+}
+/** Builds the exact ordered fields used by the Node H1/H2 dispatcher. */
+export declare function frameRequest(request: AttemptRequest): FramedRequest;

package/dist/cjs/types/transport/h2.d.ts

@@ -0,0 +1,3 @@
+import type { TLSSocket } from "node:tls";
+import type { UndiciPool } from "./undici-compat";
+export declare function createH2Pool(origin: string, firstSocket: TLSSocket, socketFactory: () => Promise<TLSSocket>): UndiciPool;

package/dist/cjs/types/transport/node.d.ts

@@ -0,0 +1,3 @@
+import type { HttpTransportOptions } from "../transport";
+import type { Transport } from "../types";
+export declare function createNodeTransport(options?: HttpTransportOptions): Transport;

package/dist/cjs/types/transport/response-reader.d.ts

@@ -0,0 +1,6 @@
+import type { AttemptOutcome } from "../types";
+type ResponseOutcome = Extract<AttemptOutcome, {
+    kind: "response";
+}>;
+export declare function readResponse(status: number, rawHeaders: readonly Uint8Array[], chunks: readonly Uint8Array[], compressedBytes: number, transportTruncated: boolean, compressedLimit?: number): Promise<ResponseOutcome>;
+export {};

package/dist/cjs/types/transport/strict-json.d.ts

@@ -0,0 +1,5 @@
+export declare class StrictJsonSyntaxError extends Error {
+}
+export declare class StrictJsonLimitError extends Error {
+}
+export declare function parseStrictJson(bytes: Uint8Array): unknown;

package/dist/cjs/types/transport/tls.d.ts

@@ -0,0 +1,14 @@
+import { type Socket } from "node:net";
+import { type TLSSocket } from "node:tls";
+import { type ProxyOptions, type ProxyTlsOptions } from "./connect-proxy";
+export interface OriginSocketOptions {
+    readonly allowH2: boolean;
+    readonly connectTimeout: number;
+    readonly tls?: ProxyTlsOptions;
+    readonly proxy?: ProxyOptions;
+    readonly dnsResolver?: (host: string) => Promise<{
+        address: string;
+        family: 4 | 6;
+    }[]>;
+}
+export declare function openOriginSocket(origin: string, options: OriginSocketOptions): Promise<Socket | TLSSocket>;