@zmdb/client 1.0.0-beta.1

package/dist/testing/index.js

@@ -0,0 +1,53 @@
+export function createFakeClientTransport() {
+    const observed = [];
+    const held = [];
+    const waiters = [];
+    const transport = request => new Promise((resolve, reject) => {
+        observed.push(request);
+        let settled = false;
+        const onAbort = () => {
+            if (settled)
+                return;
+            settled = true;
+            reject(request.signal?.reason);
+        };
+        request.signal?.addEventListener('abort', onAbort, { once: true });
+        const pending = Object.freeze({
+            request,
+            respond(response) {
+                if (settled)
+                    return;
+                settled = true;
+                request.signal?.removeEventListener('abort', onAbort);
+                resolve(response);
+            },
+            fail(error) {
+                if (settled)
+                    return;
+                settled = true;
+                request.signal?.removeEventListener('abort', onAbort);
+                reject(error);
+            },
+        });
+        const waiter = waiters.shift();
+        if (waiter === undefined)
+            held.push(pending);
+        else
+            waiter.resolve(pending);
+    });
+    return Object.freeze({
+        transport,
+        get requests() {
+            return Object.freeze([...observed]);
+        },
+        nextRequest() {
+            const pending = held.shift();
+            if (pending !== undefined)
+                return Promise.resolve(pending);
+            return new Promise(resolve => {
+                waiters.push({ resolve });
+            });
+        },
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,yBAAyB;IACvC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,IAAI,GAAwB,EAAE,CAAC;IACrC,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,MAAM,SAAS,GAAoB,OAAO,CAAC,EAAE,CAC3C,IAAI,OAAO,CAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC;QACF,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,OAAO,GAAsB,MAAM,CAAC,MAAM,CAAC;YAC/C,OAAO;YACP,OAAO,CAAC,QAAwB;gBAC9B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACtD,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;YACD,IAAI,CAAC,KAAc;gBACjB,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,CAAC,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACtD,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;SACF,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;;YACxC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEL,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS;QACT,IAAI,QAAQ;YACV,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;QACtC,CAAC;QACD,WAAW;YACT,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC3D,OAAO,IAAI,OAAO,CAAoB,OAAO,CAAC,EAAE;gBAC9C,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/transport/index.d.ts

@@ -0,0 +1,4 @@
+import type { ClientTransport } from '../types.js';
+export type FetchLike = typeof globalThis.fetch;
+export declare function createFetchTransport(injected?: FetchLike): ClientTransport;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAiC,eAAe,EAAE,MAAM,aAAa,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,KAAK,CAAC;AAchD,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,SAAS,GAAG,eAAe,CAqC1E"}

package/dist/transport/index.js

@@ -0,0 +1,47 @@
+import { ClientRequestError, TransportError } from '../errors/index.js';
+import { normalizeClientHeaders } from '../headers/index.js';
+function fetchFunction(injected) {
+    const candidate = injected ?? globalThis.fetch;
+    if (typeof candidate !== 'function') {
+        throw new ClientRequestError('Fetch is unavailable; inject a ClientTransport or Fetch implementation');
+    }
+    return candidate;
+}
+export function createFetchTransport(injected) {
+    const fetch = fetchFunction(injected);
+    return async (request) => {
+        if (request.headers.cookie !== undefined) {
+            throw new ClientRequestError('Fetch cannot guarantee an explicit cookie request header');
+        }
+        const init = {
+            method: request.method,
+            headers: request.headers,
+            redirect: 'manual',
+            ...(request.body === undefined ? {} : { body: request.body }),
+            ...(request.signal === undefined ? {} : { signal: request.signal }),
+            ...(request.body instanceof ReadableStream ? { duplex: 'half' } : {}),
+        };
+        let response;
+        try {
+            response = await fetch(request.url, init);
+        }
+        catch (error) {
+            if (request.signal?.aborted === true)
+                throw request.signal.reason;
+            throw new TransportError(undefined, error);
+        }
+        if (response.status <= 0 || response.type === 'opaqueredirect') {
+            throw new TransportError(undefined, new Error('Fetch returned an opaque redirect or unusable status'));
+        }
+        const headers = {};
+        response.headers.forEach((value, name) => {
+            headers[name.toLowerCase()] = value;
+        });
+        return Object.freeze({
+            status: response.status,
+            headers: normalizeClientHeaders(headers),
+            body: response.body,
+        });
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAS7D,SAAS,aAAa,CAAC,QAA+B;IACpD,MAAM,SAAS,GAAG,QAAQ,IAAI,UAAU,CAAC,KAAK,CAAC;IAC/C,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAAC,wEAAwE,CAAC,CAAC;IACzG,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAoB;IACvD,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAEtC,OAAO,KAAK,EAAE,OAAsB,EAA2B,EAAE;QAC/D,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,IAAI,kBAAkB,CAAC,0DAA0D,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,IAAI,GAAyB;YACjC,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,QAAQ,EAAE,QAAQ;YAClB,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7D,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;YACnE,GAAG,CAAC,OAAO,CAAC,IAAI,YAAY,cAAc,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtE,CAAC;QAEF,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI;gBAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAClE,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;YAC/D,MAAM,IAAI,cAAc,CAAC,SAAS,EAAE,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC,CAAC;QACzG,CAAC;QAED,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACvC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,GAAG,KAAK,CAAC;QACtC,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,sBAAsB,CAAC,OAAO,CAAC;YACxC,IAAI,EAAE,QAAQ,CAAC,IAAI;SACpB,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,116 @@
+export type ClientHeaders = Readonly<Record<string, string>>;
+export type ClientBytes = Uint8Array<ArrayBuffer>;
+export type ClientBody = string | ClientBytes | ReadableStream<ClientBytes>;
+export interface ClientRequest {
+    readonly method: string;
+    readonly url: string;
+    readonly headers: ClientHeaders;
+    readonly body?: ClientBody;
+    readonly signal?: AbortSignal;
+}
+export interface ClientResponse {
+    readonly status: number;
+    readonly headers: ClientHeaders;
+    readonly body: ReadableStream<ClientBytes> | null;
+}
+export type ClientTransport = (request: ClientRequest) => Promise<ClientResponse>;
+export type ClientSecurityRequirement = Readonly<Record<string, readonly string[]>>;
+export type ClientSecurityScheme = {
+    readonly type: 'http';
+    readonly scheme: 'bearer' | 'basic';
+} | {
+    readonly type: 'apiKey';
+    readonly in: 'header' | 'query' | 'cookie';
+    readonly name: string;
+} | {
+    readonly type: 'mutualTLS';
+} | {
+    readonly type: 'oauth2';
+} | {
+    readonly type: 'openIdConnect';
+};
+export interface AuthenticationContext {
+    readonly operationId: string;
+    readonly requirements: readonly ClientSecurityRequirement[];
+    readonly schemes: Readonly<Record<string, ClientSecurityScheme>>;
+    readonly version?: string;
+    readonly signal?: AbortSignal;
+}
+export interface AuthenticationPatch {
+    readonly requirement: number;
+    readonly headers?: ClientHeaders;
+    readonly query?: Readonly<Record<string, string | readonly string[]>>;
+    readonly cookies?: Readonly<Record<string, string>>;
+}
+export type AuthenticationProvider = (context: AuthenticationContext) => AuthenticationPatch | Promise<AuthenticationPatch>;
+export interface ClientOptions {
+    readonly baseUrl: string | URL;
+    readonly transport?: ClientTransport;
+    readonly authentication?: AuthenticationProvider;
+    readonly headers?: ClientHeaders;
+    readonly maxResponseBytes?: number;
+    readonly maxErrorBodyBytes?: number;
+}
+export interface CallOptions {
+    readonly signal?: AbortSignal;
+    readonly timeoutMs?: number;
+    readonly authentication?: AuthenticationProvider;
+}
+export interface ClientQueryPair {
+    readonly name: string;
+    readonly value: string;
+}
+export interface PreparedClientRequest {
+    readonly path: string;
+    readonly query: readonly ClientQueryPair[];
+    readonly headers: ClientHeaders;
+    readonly cookies: readonly ClientQueryPair[];
+    readonly body?: ClientBody;
+}
+export type ClientVersionPlan = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'header' | 'media-type';
+    readonly values: readonly string[];
+    readonly default: string;
+};
+export interface ValidationIssue {
+    readonly path: string;
+    readonly message: string;
+}
+export type DecodeResult<T> = {
+    readonly ok: true;
+    readonly value: T;
+} | {
+    readonly ok: false;
+    readonly issues: readonly ValidationIssue[];
+};
+export interface ClientResponseBody {
+    empty(): Promise<void>;
+    json<T>(mediaType: string, decode: (wire: unknown) => DecodeResult<T>): Promise<T>;
+    text(mediaType: string): Promise<string>;
+    bytes(mediaType: string): Promise<ClientBytes>;
+    stream(mediaType: string): ReadableStream<ClientBytes>;
+}
+export interface ClientOperationResponse {
+    readonly status: number;
+    readonly headers: ClientHeaders;
+    readonly body: ClientResponseBody;
+    unexpectedStatus(): Promise<never>;
+}
+export interface GeneratedOperation<Input, Result> {
+    readonly abi: 1;
+    readonly operationId: string;
+    readonly method: string;
+    readonly security: readonly ClientSecurityRequirement[];
+    readonly schemes: Readonly<Record<string, ClientSecurityScheme>>;
+    readonly version: ClientVersionPlan;
+    prepare(input: Input, version: string | undefined): PreparedClientRequest;
+    read(response: ClientOperationResponse, version: string | undefined): Promise<Result>;
+}
+export interface ClientRuntime {
+    call<Input, Result>(operation: GeneratedOperation<Input, Result>, input: Input, options?: CallOptions & {
+        readonly version?: string;
+    }): Promise<Result>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/url/index.d.ts

@@ -0,0 +1,17 @@
+import type { ClientQueryPair } from '../types.js';
+export type ClientScalar = string | number | bigint | boolean | Date;
+export type ClientBaseUrl = {
+    readonly kind: 'absolute';
+    readonly origin: string;
+    readonly pathname: string;
+} | {
+    readonly kind: 'relative';
+    readonly pathname: string;
+};
+export declare function normalizeClientBaseUrl(input: string | URL): ClientBaseUrl;
+export declare function stringifyClientScalar(value: ClientScalar): string;
+export declare function encodeClientComponent(value: string): string;
+export declare function substituteClientPath(path: string, name: string, value: ClientScalar): string;
+export declare function serializeClientQuery(query: readonly ClientQueryPair[]): string;
+export declare function resolveClientUrl(baseUrl: string | URL | ClientBaseUrl, path: string, query?: readonly ClientQueryPair[]): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/url/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAErE,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAa7D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,aAAa,CA+BzE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CASjE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK3D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAc5F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAS9E;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,aAAa,EACrC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,SAAS,eAAe,EAAO,GACrC,MAAM,CAUR"}

package/dist/url/index.js

@@ -0,0 +1,98 @@
+import { ClientRequestError } from '../errors/index.js';
+const CONTROL = /[\0\r\n]/;
+function requestError(message, cause) {
+    return new ClientRequestError(message, cause === undefined ? {} : { cause });
+}
+function prefixPath(pathname) {
+    const withoutTrailing = pathname.replace(/\/+$/u, '');
+    return withoutTrailing.length === 0 ? '/' : withoutTrailing;
+}
+export function normalizeClientBaseUrl(input) {
+    if (input instanceof URL) {
+        if (input.protocol !== 'http:' && input.protocol !== 'https:') {
+            throw requestError(`Client base URL protocol must be http: or https:, received ${input.protocol}`);
+        }
+        if (input.username.length > 0 || input.password.length > 0) {
+            throw requestError('Client base URL must not contain credentials');
+        }
+        if (input.search.length > 0 || input.hash.length > 0) {
+            throw requestError('Client base URL must not contain a query or fragment');
+        }
+        return Object.freeze({ kind: 'absolute', origin: input.origin, pathname: prefixPath(input.pathname) });
+    }
+    if (typeof input !== 'string' || input.length === 0 || CONTROL.test(input)) {
+        throw requestError('Client base URL must be a non-empty absolute or origin-relative URL');
+    }
+    if (input.startsWith('/') && !input.startsWith('//')) {
+        if (input.includes('?') || input.includes('#')) {
+            throw requestError('Client base URL must not contain a query or fragment');
+        }
+        return Object.freeze({ kind: 'relative', pathname: prefixPath(input) });
+    }
+    let absolute;
+    try {
+        absolute = new URL(input);
+    }
+    catch (error) {
+        throw requestError('Client base URL must be absolute or begin with /', error);
+    }
+    return normalizeClientBaseUrl(absolute);
+}
+export function stringifyClientScalar(value) {
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw requestError('Client URL scalar number must be finite');
+        return String(value);
+    }
+    if (typeof value === 'bigint' || typeof value === 'boolean')
+        return String(value);
+    if (Number.isNaN(value.getTime()))
+        throw requestError('Client URL scalar Date must be valid');
+    return value.toISOString();
+}
+export function encodeClientComponent(value) {
+    return encodeURIComponent(value).replace(/[!'()*]/gu, character => {
+        const code = character.codePointAt(0);
+        return code === undefined ? '' : `%${code.toString(16).toUpperCase()}`;
+    });
+}
+export function substituteClientPath(path, name, value) {
+    if (!path.startsWith('/') || path.includes('?') || path.includes('#') || CONTROL.test(path)) {
+        throw requestError('Client operation path must begin with / and contain no query, fragment, or controls');
+    }
+    const slot = `:${name}`;
+    const segments = path.split('/');
+    const indexes = segments.flatMap((segment, index) => (segment === slot ? [index] : []));
+    if (indexes.length !== 1) {
+        throw requestError(`Client operation path must contain exactly one ${slot} segment`);
+    }
+    const index = indexes[0];
+    if (index === undefined)
+        throw requestError(`Client operation path is missing ${slot}`);
+    segments[index] = encodeClientComponent(stringifyClientScalar(value));
+    return segments.join('/');
+}
+export function serializeClientQuery(query) {
+    return query
+        .map(pair => {
+        if (typeof pair.name !== 'string' || typeof pair.value !== 'string') {
+            throw requestError('Client query pairs must contain string names and values');
+        }
+        return `${encodeClientComponent(pair.name)}=${encodeClientComponent(pair.value)}`;
+    })
+        .join('&');
+}
+export function resolveClientUrl(baseUrl, path, query = []) {
+    if (!path.startsWith('/') || path.includes('?') || path.includes('#') || CONTROL.test(path)) {
+        throw requestError('Prepared client path must begin with / and contain no query, fragment, or controls');
+    }
+    const base = typeof baseUrl === 'string' || baseUrl instanceof URL ? normalizeClientBaseUrl(baseUrl) : baseUrl;
+    const prefix = base.pathname === '/' ? '' : base.pathname;
+    const pathname = `${prefix}${path}` || '/';
+    const serialized = serializeClientQuery(query);
+    const result = serialized.length === 0 ? pathname : `${pathname}?${serialized}`;
+    return base.kind === 'absolute' ? `${base.origin}${result}` : result;
+}
+//# sourceMappingURL=index.js.map

package/dist/url/index.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@zmdb/client",
+  "version": "1.0.0-beta.1",
+  "description": "Dependency-free HTTP client runtime for generated and manually declared zmdb operations.",
+  "keywords": [
+    "client",
+    "fetch",
+    "http",
+    "typescript",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/client"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./body": {
+      "types": "./dist/body/index.d.ts",
+      "import": "./dist/body/index.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js"
+    },
+    "./headers": {
+      "types": "./dist/headers/index.d.ts",
+      "import": "./dist/headers/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    },
+    "./transport": {
+      "types": "./dist/transport/index.d.ts",
+      "import": "./dist/transport/index.js"
+    },
+    "./url": {
+      "types": "./dist/url/index.d.ts",
+      "import": "./dist/url/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/src/body/index.ts

@@ -0,0 +1,58 @@
+import { ClientRequestError } from '../errors/index.js';
+import type { ClientBody, ClientBytes } from '../types.js';
+
+export const DEFAULT_MAX_RESPONSE_BYTES = 8 * 1024 * 1024;
+export const DEFAULT_MAX_ERROR_BODY_BYTES = 8 * 1024;
+
+export type ClientBodyKind = 'json' | 'text' | 'bytes' | 'stream' | 'empty';
+
+const TEXT_BODY_KIND: ClientBodyKind = 'text';
+
+function isClientBytes(value: unknown): value is ClientBytes {
+  return value instanceof Uint8Array && value.buffer instanceof ArrayBuffer;
+}
+
+export function prepareClientBody(kind: ClientBodyKind, value: unknown): ClientBody | undefined {
+  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: number, option: string): number {
+  if (!Number.isSafeInteger(value) || value <= 0) {
+    throw new ClientRequestError(`${option} must be a positive safe integer`);
+  }
+  return value;
+}