@zmdb/client 1.0.0-beta.1

package/README.md

@@ -0,0 +1,57 @@
+# @zmdb/client
+
+`@zmdb/client` is the dependency-free HTTP execution runtime for generated zmdb clients and manually declared operations. It owns transport injection, deterministic URL assembly, bounded response
+decoding, cancellation, authentication patches, and stable protocol errors without importing the web framework, reflection, OpenAPI, or Node built-ins.
+
+## Install
+
+```bash
+yarn add @zmdb/client@1.0.0-beta.1
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+** and is **ESM-only**. The runtime uses web-platform APIs and works with either an injected transport or Fetch.
+
+## Entry points
+
+- `@zmdb/client` — generated-operation ABI, runtime, and the body/URL primitives used by generated modules.
+- `@zmdb/client/body` — request-body preparation helpers and response limits.
+- `@zmdb/client/errors` — stable client error classes.
+- `@zmdb/client/headers` — header normalisation and conflict-safe merging.
+- `@zmdb/client/transport` — structural transport types and the Fetch adapter.
+- `@zmdb/client/url` — RFC 3986 component, path, query, and base-URL helpers.
+- `@zmdb/client/testing` — deterministic held-request transport.
+
+## Generated clients
+
+`zmdb client generate` loads configured `@zmdb/web` contract exports once and writes both OpenAPI JSON and a typed TypeScript client. Commit both outputs and use `zmdb client generate --check` in CI
+to reject stale output. OpenAPI is a sibling output, not the input to generation.
+
+The generated module imports only `@zmdb/client`, so the same source can be bundled for a browser or run under Node:
+
+```ts
+import { createApiClient } from './generated/http-client.generated.js';
+
+const api = createApiClient({
+  baseUrl: 'https://api.example.com',
+  authentication: () => ({
+    requirement: 0,
+    headers: { authorization: 'Bearer token' },
+  }),
+});
+```
+
+The repository's packed-consumer fixture installs only the packed `@zmdb/client` package and exercises the same generated client in browser and Node bundles against a real `@zmdb/web` service,
+including alternate success status, response validation, and authentication injection.
+
+## Manual operations
+
+The package can also execute a hand-authored `GeneratedOperation` directly. That path is intentionally low level: the caller supplies the request plan and response reader, and `@zmdb/client` supplies
+URL assembly, transport injection, authentication patches, limits, cancellation, and stable errors. It does not inspect controllers, infer types, or parse an OpenAPI document.
+
+## Documentation
+
+The complete generated and manual journey is at **https://ambasta.github.io/zmdb/docs/generated-client.html**.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later).

package/dist/body/index.d.ts

@@ -0,0 +1,7 @@
+import type { ClientBody } from '../types.js';
+export declare const DEFAULT_MAX_RESPONSE_BYTES: number;
+export declare const DEFAULT_MAX_ERROR_BODY_BYTES: number;
+export type ClientBodyKind = 'json' | 'text' | 'bytes' | 'stream' | 'empty';
+export declare function prepareClientBody(kind: ClientBodyKind, value: unknown): ClientBody | undefined;
+export declare function assertPositiveByteLimit(value: number, option: string): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/body/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,aAAa,CAAC;AAE3D,eAAO,MAAM,0BAA0B,QAAkB,CAAC;AAC1D,eAAO,MAAM,4BAA4B,QAAW,CAAC;AAErD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAQ5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAoC9F;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAK7E"}

package/dist/body/index.js

@@ -0,0 +1,55 @@
+import { ClientRequestError } from '../errors/index.js';
+export const DEFAULT_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
+export const DEFAULT_MAX_ERROR_BODY_BYTES = 8 * 1024;
+const TEXT_BODY_KIND = 'text';
+function isClientBytes(value) {
+    return value instanceof Uint8Array && value.buffer instanceof ArrayBuffer;
+}
+export function prepareClientBody(kind, value) {
+    if (kind === 'empty') {
+        if (value !== undefined)
+            throw new ClientRequestError('An empty request body must be undefined');
+        return undefined;
+    }
+    if (kind === TEXT_BODY_KIND) {
+        if (typeof value !== 'string')
+            throw new ClientRequestError('A text request body must be a string');
+        return value;
+    }
+    if (kind === 'bytes') {
+        if (!isClientBytes(value)) {
+            throw new ClientRequestError('A bytes request body must be a Uint8Array');
+        }
+        return value;
+    }
+    if (kind === 'stream') {
+        if (!(value instanceof ReadableStream)) {
+            throw new ClientRequestError('A stream request body must be a ReadableStream');
+        }
+        return value;
+    }
+    try {
+        const serialized = JSON.stringify(value, (_key, item) => {
+            if (typeof item === 'number' && !Number.isFinite(item)) {
+                throw new ClientRequestError('A JSON request body must not contain a non-finite number');
+            }
+            return item;
+        });
+        if (serialized === undefined) {
+            throw new ClientRequestError('A JSON request body must have a serialisable top-level value');
+        }
+        return serialized;
+    }
+    catch (error) {
+        if (error instanceof ClientRequestError)
+            throw error;
+        throw new ClientRequestError('A JSON request body could not be serialised', { cause: error });
+    }
+}
+export function assertPositiveByteLimit(value, option) {
+    if (!Number.isSafeInteger(value) || value <= 0) {
+        throw new ClientRequestError(`${option} must be a positive safe integer`);
+    }
+    return value;
+}
+//# sourceMappingURL=index.js.map

package/dist/body/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/body/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,GAAG,IAAI,CAAC;AAIrD,MAAM,cAAc,GAAmB,MAAM,CAAC;AAE9C,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,YAAY,UAAU,IAAI,KAAK,CAAC,MAAM,YAAY,WAAW,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAoB,EAAE,KAAc;IACpE,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,IAAI,kBAAkB,CAAC,yCAAyC,CAAC,CAAC;QACjG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ;YAAE,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,CAAC,CAAC;QACpG,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,kBAAkB,CAAC,2CAA2C,CAAC,CAAC;QAC5E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,CAAC,CAAC,KAAK,YAAY,cAAc,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,kBAAkB,CAAC,gDAAgD,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;YACtD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvD,MAAM,IAAI,kBAAkB,CAAC,0DAA0D,CAAC,CAAC;YAC3F,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,MAAM,IAAI,kBAAkB,CAAC,8DAA8D,CAAC,CAAC;QAC/F,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB;YAAE,MAAM,KAAK,CAAC;QACrD,MAAM,IAAI,kBAAkB,CAAC,6CAA6C,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa,EAAE,MAAc;IACnE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,kBAAkB,CAAC,GAAG,MAAM,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,59 @@
+import type { ClientHeaders, ValidationIssue } from '../types.js';
+export interface ClientErrorInit {
+    readonly operationId?: string;
+    readonly cause?: unknown;
+}
+export declare class ClientError extends Error {
+    readonly operationId: string | undefined;
+    constructor(message: string, init?: ClientErrorInit);
+}
+export declare class ClientRequestError extends ClientError {
+    constructor(message: string, init?: ClientErrorInit);
+}
+export declare class AuthenticationError extends ClientError {
+    constructor(operationId: string, cause?: unknown);
+}
+export declare class MissingAuthenticationError extends AuthenticationError {
+    constructor(operationId: string);
+}
+export declare class TransportError extends ClientError {
+    constructor(operationId: string | undefined, cause: unknown);
+}
+export declare class ClientTimeoutError extends ClientError {
+    readonly timeoutMs: number;
+    constructor(operationId: string, timeoutMs: number);
+}
+export declare class ResponseTooLargeError extends ClientError {
+    readonly status: number;
+    readonly limit: number;
+    constructor(operationId: string, status: number, limit: number);
+}
+export declare class UnexpectedStatusError extends ClientError {
+    readonly status: number;
+    readonly headers: ClientHeaders;
+    readonly bodySnippet: string;
+    constructor(operationId: string, status: number, headers: ClientHeaders, bodySnippet: string);
+}
+export declare class UnexpectedContentTypeError extends ClientError {
+    readonly status: number;
+    readonly expected: readonly string[];
+    readonly received: string | undefined;
+    constructor(operationId: string, status: number, expected: readonly string[], received: string | undefined);
+}
+export declare class ResponseDecodeError extends ClientError {
+    readonly status: number;
+    readonly bodySnippet: string;
+    constructor(operationId: string, status: number, bodySnippet: string, cause?: unknown);
+}
+export declare class ResponseValidationError extends ClientError {
+    readonly status: number;
+    readonly issues: readonly ValidationIssue[];
+    constructor(operationId: string, status: number, issues: readonly ValidationIssue[]);
+}
+export declare class ClientResponseError<Status extends number, Body, Headers = ClientHeaders> extends ClientError {
+    readonly status: Status;
+    readonly body: Body;
+    readonly headers: Headers;
+    constructor(operationId: string, status: Status, body: Body, headers: Headers);
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/errors/index.js

@@ -0,0 +1,117 @@
+function operation(operationId) {
+    return operationId === undefined ? 'Client request' : `Operation ${operationId}`;
+}
+export class ClientError extends Error {
+    operationId;
+    constructor(message, init = {}) {
+        super(message, init.cause === undefined ? undefined : { cause: init.cause });
+        this.name = 'ClientError';
+        this.operationId = init.operationId;
+    }
+}
+export class ClientRequestError extends ClientError {
+    constructor(message, init = {}) {
+        super(message, init);
+        this.name = 'ClientRequestError';
+    }
+}
+export class AuthenticationError extends ClientError {
+    constructor(operationId, cause) {
+        super(`Authentication failed for operation ${operationId}`, { operationId, cause });
+        this.name = 'AuthenticationError';
+    }
+}
+export class MissingAuthenticationError extends AuthenticationError {
+    constructor(operationId) {
+        super(operationId);
+        this.name = 'MissingAuthenticationError';
+        this.message = `Operation ${operationId} requires an authentication provider`;
+    }
+}
+export class TransportError extends ClientError {
+    constructor(operationId, cause) {
+        super(`${operation(operationId)} failed in the transport`, operationId === undefined ? { cause } : { operationId, cause });
+        this.name = 'TransportError';
+    }
+}
+export class ClientTimeoutError extends ClientError {
+    timeoutMs;
+    constructor(operationId, timeoutMs) {
+        super(`Operation ${operationId} timed out after ${String(timeoutMs)}ms`, { operationId });
+        this.name = 'ClientTimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+export class ResponseTooLargeError extends ClientError {
+    status;
+    limit;
+    constructor(operationId, status, limit) {
+        super(`Operation ${operationId} response status ${String(status)} exceeds the ${String(limit)} byte limit`, {
+            operationId,
+        });
+        this.name = 'ResponseTooLargeError';
+        this.status = status;
+        this.limit = limit;
+    }
+}
+export class UnexpectedStatusError extends ClientError {
+    status;
+    headers;
+    bodySnippet;
+    constructor(operationId, status, headers, bodySnippet) {
+        const detail = bodySnippet.length === 0 ? '' : `: ${bodySnippet}`;
+        super(`Operation ${operationId} returned undocumented status ${String(status)}${detail}`, { operationId });
+        this.name = 'UnexpectedStatusError';
+        this.status = status;
+        this.headers = Object.freeze({ ...headers });
+        this.bodySnippet = bodySnippet;
+    }
+}
+export class UnexpectedContentTypeError extends ClientError {
+    status;
+    expected;
+    received;
+    constructor(operationId, status, expected, received) {
+        super(`Operation ${operationId} status ${String(status)} expected content type ${expected.join(' or ')}, ` +
+            `received ${received ?? 'none'}`, { operationId });
+        this.name = 'UnexpectedContentTypeError';
+        this.status = status;
+        this.expected = Object.freeze([...expected]);
+        this.received = received;
+    }
+}
+export class ResponseDecodeError extends ClientError {
+    status;
+    bodySnippet;
+    constructor(operationId, status, bodySnippet, cause) {
+        const detail = bodySnippet.length === 0 ? '' : `: ${bodySnippet}`;
+        super(`Operation ${operationId} could not decode status ${String(status)}${detail}`, { operationId, cause });
+        this.name = 'ResponseDecodeError';
+        this.status = status;
+        this.bodySnippet = bodySnippet;
+    }
+}
+export class ResponseValidationError extends ClientError {
+    status;
+    issues;
+    constructor(operationId, status, issues) {
+        super(`Operation ${operationId} status ${String(status)} failed response validation with ` +
+            `${String(issues.length)} issue(s)`, { operationId });
+        this.name = 'ResponseValidationError';
+        this.status = status;
+        this.issues = Object.freeze(issues.map(issue => Object.freeze({ ...issue })));
+    }
+}
+export class ClientResponseError extends ClientError {
+    status;
+    body;
+    headers;
+    constructor(operationId, status, body, headers) {
+        super(`Operation ${operationId} returned documented error status ${String(status)}`, { operationId });
+        this.name = 'ClientResponseError';
+        this.status = status;
+        this.body = body;
+        this.headers = headers;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

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

package/dist/headers/index.d.ts

@@ -0,0 +1,6 @@
+import type { ClientHeaders } from '../types.js';
+export declare const TRANSPORT_OWNED_HEADERS: ReadonlySet<string>;
+export declare function normalizeClientHeaders(headers?: ClientHeaders): ClientHeaders;
+export declare function mergeClientHeaders(...sources: readonly ClientHeaders[]): ClientHeaders;
+export declare function assertNoTransportOwnedHeaders(headers: ClientHeaders): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/headers/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,MAAM,CAStD,CAAC;AAEH,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,aAAkB,GAAG,aAAa,CAiBjF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,aAAa,CAYtF;AAED,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAM1E"}

package/dist/headers/index.js

@@ -0,0 +1,52 @@
+import { ClientRequestError } from '../errors/index.js';
+const HEADER_NAME = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+const INVALID_VALUE = /[\0\r\n]/;
+export const TRANSPORT_OWNED_HEADERS = new Set([
+    'connection',
+    'content-length',
+    'host',
+    'proxy-connection',
+    'te',
+    'trailer',
+    'transfer-encoding',
+    'upgrade',
+]);
+export function normalizeClientHeaders(headers = {}) {
+    const normalized = {};
+    for (const [sourceName, value] of Object.entries(headers)) {
+        if (!HEADER_NAME.test(sourceName)) {
+            throw new ClientRequestError(`Invalid HTTP header name ${JSON.stringify(sourceName)}`);
+        }
+        if (typeof value !== 'string' || INVALID_VALUE.test(value)) {
+            throw new ClientRequestError(`Invalid value for HTTP header ${sourceName.toLowerCase()}`);
+        }
+        const name = sourceName.toLowerCase();
+        const present = normalized[name];
+        if (present !== undefined && present !== value) {
+            throw new ClientRequestError(`Conflicting values for HTTP header ${name}`);
+        }
+        normalized[name] = value;
+    }
+    return Object.freeze(normalized);
+}
+export function mergeClientHeaders(...sources) {
+    const merged = {};
+    for (const source of sources) {
+        for (const [name, value] of Object.entries(normalizeClientHeaders(source))) {
+            const present = merged[name];
+            if (present !== undefined && present !== value) {
+                throw new ClientRequestError(`Conflicting values for HTTP header ${name}`);
+            }
+            merged[name] = value;
+        }
+    }
+    return Object.freeze(merged);
+}
+export function assertNoTransportOwnedHeaders(headers) {
+    for (const name of Object.keys(headers)) {
+        if (TRANSPORT_OWNED_HEADERS.has(name.toLowerCase())) {
+            throw new ClientRequestError(`HTTP header ${name.toLowerCase()} is owned by the transport`);
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/headers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/headers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,MAAM,WAAW,GAAG,gCAAgC,CAAC;AACrD,MAAM,aAAa,GAAG,UAAU,CAAC;AAEjC,MAAM,CAAC,MAAM,uBAAuB,GAAwB,IAAI,GAAG,CAAC;IAClE,YAAY;IACZ,gBAAgB;IAChB,MAAM;IACN,kBAAkB;IAClB,IAAI;IACJ,SAAS;IACT,mBAAmB;IACnB,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,sBAAsB,CAAC,OAAO,GAAkB,EAAE;IAChE,MAAM,UAAU,GAA2B,EAAE,CAAC;IAC9C,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,kBAAkB,CAAC,4BAA4B,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,kBAAkB,CAAC,iCAAiC,UAAU,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAG,OAAiC;IACrE,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7B,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;gBAC/C,MAAM,IAAI,kBAAkB,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,OAAsB;IAClE,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,IAAI,uBAAuB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,kBAAkB,CAAC,eAAe,IAAI,CAAC,WAAW,EAAE,4BAA4B,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { DEFAULT_MAX_ERROR_BODY_BYTES, DEFAULT_MAX_RESPONSE_BYTES, prepareClientBody } from './body/index.js';
+export { AuthenticationError, ClientError, ClientRequestError, ClientResponseError, ClientTimeoutError, MissingAuthenticationError, ResponseDecodeError, ResponseTooLargeError, ResponseValidationError, TransportError, UnexpectedContentTypeError, UnexpectedStatusError, } from './errors/index.js';
+export { CLIENT_RUNTIME_ABI, createClientRuntime } from './runtime.js';
+export { createFetchTransport } from './transport/index.js';
+export { stringifyClientScalar, substituteClientPath } from './url/index.js';
+export type { AuthenticationContext, AuthenticationPatch, AuthenticationProvider, CallOptions, ClientBody, ClientBytes, ClientHeaders, ClientOperationResponse, ClientOptions, ClientQueryPair, ClientRequest, ClientResponse, ClientResponseBody, ClientRuntime, ClientSecurityRequirement, ClientSecurityScheme, ClientTransport, ClientVersionPlan, DecodeResult, GeneratedOperation, PreparedClientRequest, ValidationIssue, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,YAAY,EACV,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,eAAe,EACf,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,yBAAyB,EACzB,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EACrB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { DEFAULT_MAX_ERROR_BODY_BYTES, DEFAULT_MAX_RESPONSE_BYTES, prepareClientBody } from './body/index.js';
+export { AuthenticationError, ClientError, ClientRequestError, ClientResponseError, ClientTimeoutError, MissingAuthenticationError, ResponseDecodeError, ResponseTooLargeError, ResponseValidationError, TransportError, UnexpectedContentTypeError, UnexpectedStatusError, } from './errors/index.js';
+export { CLIENT_RUNTIME_ABI, createClientRuntime } from './runtime.js';
+export { createFetchTransport } from './transport/index.js';
+export { stringifyClientScalar, substituteClientPath } from './url/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAC9G,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { ClientOptions, ClientRuntime } from './types.js';
+export declare const CLIENT_RUNTIME_ABI = 1;
+export declare function createClientRuntime(options: ClientOptions): ClientRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAOV,aAAa,EAKb,aAAa,EAMd,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,kBAAkB,IAAI,CAAC;AA6rBpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAEzE"}