ts-procedures 5.9.1 → 5.10.2

package/build/src/client/hooks.test.js

@@ -0,0 +1,163 @@
+import { describe, it, expect } from 'vitest';
+import { runBeforeRequest, runAfterResponse, runOnError } from './hooks.js';
+// ── helpers ───────────────────────────────────────────────
+function makeBeforeCtx(overrides) {
+    return {
+        procedureName: 'TestProcedure',
+        scope: 'test',
+        request: { url: 'https://example.com', method: 'GET' },
+        ...overrides,
+    };
+}
+function makeAfterCtx(overrides) {
+    return {
+        procedureName: 'TestProcedure',
+        scope: 'test',
+        request: { url: 'https://example.com', method: 'GET' },
+        response: { status: 200, headers: {}, body: null },
+        ...overrides,
+    };
+}
+function makeErrorCtx(overrides) {
+    return {
+        procedureName: 'TestProcedure',
+        scope: 'test',
+        request: { url: 'https://example.com', method: 'GET' },
+        error: new Error('something went wrong'),
+        ...overrides,
+    };
+}
+// ── runBeforeRequest ──────────────────────────────────────
+describe('runBeforeRequest', () => {
+    it('runs global hook then local hook in order', async () => {
+        const order = [];
+        const globalHooks = {
+            onBeforeRequest: (ctx) => { order.push('global'); return ctx; },
+        };
+        const localHooks = {
+            onBeforeRequest: (ctx) => { order.push('local'); return ctx; },
+        };
+        const ctx = makeBeforeCtx();
+        await runBeforeRequest(ctx, globalHooks, localHooks);
+        expect(order).toEqual(['global', 'local']);
+    });
+    it('passes the (possibly mutated) context from global to local', async () => {
+        const globalHooks = {
+            onBeforeRequest: (ctx) => ({
+                ...ctx,
+                request: { ...ctx.request, url: 'https://mutated.example.com' },
+            }),
+        };
+        let receivedUrl = '';
+        const localHooks = {
+            onBeforeRequest: (ctx) => { receivedUrl = ctx.request.url; return ctx; },
+        };
+        const ctx = makeBeforeCtx();
+        await runBeforeRequest(ctx, globalHooks, localHooks);
+        expect(receivedUrl).toBe('https://mutated.example.com');
+    });
+    it('returns the final mutated context', async () => {
+        const globalHooks = {
+            onBeforeRequest: (ctx) => ({ ...ctx, scope: 'mutated-by-global' }),
+        };
+        const localHooks = {
+            onBeforeRequest: (ctx) => ({ ...ctx, scope: ctx.scope + '-then-local' }),
+        };
+        const ctx = makeBeforeCtx();
+        const result = await runBeforeRequest(ctx, globalHooks, localHooks);
+        expect(result.scope).toBe('mutated-by-global-then-local');
+    });
+    it('handles async hooks', async () => {
+        const order = [];
+        const globalHooks = {
+            onBeforeRequest: async (ctx) => { order.push('global'); return ctx; },
+        };
+        const localHooks = {
+            onBeforeRequest: async (ctx) => { order.push('local'); return ctx; },
+        };
+        await runBeforeRequest(makeBeforeCtx(), globalHooks, localHooks);
+        expect(order).toEqual(['global', 'local']);
+    });
+    it('skips undefined global hook gracefully', async () => {
+        const localHooks = {
+            onBeforeRequest: (ctx) => ({ ...ctx, scope: 'local-only' }),
+        };
+        const result = await runBeforeRequest(makeBeforeCtx(), {}, localHooks);
+        expect(result.scope).toBe('local-only');
+    });
+    it('skips undefined local hook gracefully', async () => {
+        const globalHooks = {
+            onBeforeRequest: (ctx) => ({ ...ctx, scope: 'global-only' }),
+        };
+        const result = await runBeforeRequest(makeBeforeCtx(), globalHooks, undefined);
+        expect(result.scope).toBe('global-only');
+    });
+    it('skips both hooks gracefully when neither defined', async () => {
+        const ctx = makeBeforeCtx();
+        const result = await runBeforeRequest(ctx, {}, undefined);
+        expect(result).toEqual(ctx);
+    });
+});
+// ── runAfterResponse ──────────────────────────────────────
+describe('runAfterResponse', () => {
+    it('runs global then local hook', async () => {
+        const order = [];
+        const globalHooks = { onAfterResponse: () => { order.push('global'); } };
+        const localHooks = { onAfterResponse: () => { order.push('local'); } };
+        await runAfterResponse(makeAfterCtx(), globalHooks, localHooks);
+        expect(order).toEqual(['global', 'local']);
+    });
+    it('handles async hooks', async () => {
+        const order = [];
+        const globalHooks = {
+            onAfterResponse: async () => { order.push('global'); },
+        };
+        const localHooks = {
+            onAfterResponse: async () => { order.push('local'); },
+        };
+        await runAfterResponse(makeAfterCtx(), globalHooks, localHooks);
+        expect(order).toEqual(['global', 'local']);
+    });
+    it('skips undefined hooks gracefully', async () => {
+        // Should not throw
+        await runAfterResponse(makeAfterCtx(), {}, undefined);
+    });
+    it('returns void', async () => {
+        const result = await runAfterResponse(makeAfterCtx(), {}, undefined);
+        expect(result).toBeUndefined();
+    });
+});
+// ── runOnError ────────────────────────────────────────────
+describe('runOnError', () => {
+    it('runs global then local hook', async () => {
+        const order = [];
+        const globalHooks = { onError: () => { order.push('global'); } };
+        const localHooks = { onError: () => { order.push('local'); } };
+        await runOnError(makeErrorCtx(), globalHooks, localHooks);
+        expect(order).toEqual(['global', 'local']);
+    });
+    it('handles async hooks', async () => {
+        const order = [];
+        const globalHooks = { onError: async () => { order.push('global'); } };
+        const localHooks = { onError: async () => { order.push('local'); } };
+        await runOnError(makeErrorCtx(), globalHooks, localHooks);
+        expect(order).toEqual(['global', 'local']);
+    });
+    it('skips undefined hooks gracefully', async () => {
+        await runOnError(makeErrorCtx(), {}, undefined);
+    });
+    it('returns void', async () => {
+        const result = await runOnError(makeErrorCtx(), {}, undefined);
+        expect(result).toBeUndefined();
+    });
+    it('receives the error in context', async () => {
+        const receivedErrors = [];
+        const globalHooks = {
+            onError: (ctx) => { receivedErrors.push(ctx.error); },
+        };
+        const err = new Error('boom');
+        await runOnError(makeErrorCtx({ error: err }), globalHooks, undefined);
+        expect(receivedErrors[0]).toBe(err);
+    });
+});
+//# sourceMappingURL=hooks.test.js.map

package/build/src/client/hooks.test.js.map

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

package/build/src/client/index.d.ts

@@ -0,0 +1,22 @@
+import type { CreateClientConfig } from './types.js';
+/**
+ * Creates a typed client from a config object.
+ *
+ * The `scopes` callback receives a `ClientInstance` and returns the typed
+ * scope bindings (e.g., `{ users: { getUser, createUser }, posts: { ... } }`).
+ * The return value of `createClient` is the scopes object.
+ *
+ * `client.stream()` must return `TypedStream` synchronously even though
+ * `executeStream` is async. We achieve this by creating a deferred TypedStream:
+ * - A deferred async generator awaits `executeStream` internally, then forwards
+ *   yields from the inner stream.
+ * - The outer `.result` is wired up to the inner stream's `.result`.
+ */
+export declare function createClient<TScopes>(config: CreateClientConfig<TScopes>): TScopes;
+export type { ClientAdapter, AdapterRequest, AdapterResponse, AdapterStreamResponse, ClientHooks, BeforeRequestContext, AfterResponseContext, ErrorContext, CallDescriptor, StreamDescriptor, TypedStream, ClientInstance, ProcedureCallOptions, CreateClientConfig, } from './types.js';
+export { ClientRequestError, ClientPathParamError, ClientStreamError } from './errors.js';
+export { createTypedStream } from './stream.js';
+export { executeCall } from './call.js';
+export { executeStream } from './stream.js';
+export { createFetchAdapter } from './fetch-adapter.js';
+export type { FetchAdapterConfig } from './fetch-adapter.js';

package/build/src/client/index.js

@@ -0,0 +1,67 @@
+import { executeCall } from './call.js';
+import { executeStream } from './stream.js';
+// ── createClient ──────────────────────────────────────────
+/**
+ * Creates a typed client from a config object.
+ *
+ * The `scopes` callback receives a `ClientInstance` and returns the typed
+ * scope bindings (e.g., `{ users: { getUser, createUser }, posts: { ... } }`).
+ * The return value of `createClient` is the scopes object.
+ *
+ * `client.stream()` must return `TypedStream` synchronously even though
+ * `executeStream` is async. We achieve this by creating a deferred TypedStream:
+ * - A deferred async generator awaits `executeStream` internally, then forwards
+ *   yields from the inner stream.
+ * - The outer `.result` is wired up to the inner stream's `.result`.
+ */
+export function createClient(config) {
+    const { adapter, basePath, hooks: globalHooks = {}, scopes } = config;
+    const instance = {
+        basePath,
+        adapter,
+        hooks: globalHooks,
+        call(descriptor, options) {
+            return executeCall(descriptor, basePath, adapter, globalHooks, options);
+        },
+        stream(descriptor, options) {
+            // executeStream is async but stream() must be synchronous.
+            // Create a deferred TypedStream that wraps the async executeStream call.
+            let resolveResult;
+            let rejectResult;
+            const resultPromise = new Promise((resolve, reject) => {
+                resolveResult = resolve;
+                rejectResult = reject;
+            });
+            // The deferred async generator: awaits executeStream, then forwards
+            async function* deferredGenerator() {
+                let innerStream;
+                try {
+                    innerStream = await executeStream(descriptor, basePath, adapter, globalHooks, options);
+                }
+                catch (err) {
+                    rejectResult(err);
+                    throw err;
+                }
+                // Wire up .result from the inner stream
+                innerStream.result.then(resolveResult, rejectResult);
+                for await (const item of innerStream) {
+                    yield item;
+                }
+            }
+            const iterator = deferredGenerator();
+            return {
+                [Symbol.asyncIterator]() {
+                    return iterator;
+                },
+                result: resultPromise,
+            };
+        },
+    };
+    return scopes(instance);
+}
+export { ClientRequestError, ClientPathParamError, ClientStreamError } from './errors.js';
+export { createTypedStream } from './stream.js';
+export { executeCall } from './call.js';
+export { executeStream } from './stream.js';
+export { createFetchAdapter } from './fetch-adapter.js';
+//# sourceMappingURL=index.js.map

package/build/src/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAA;AAU9D,6DAA6D;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAU,MAAmC;IACvE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAErE,MAAM,QAAQ,GAAmB;QAC/B,QAAQ;QACR,OAAO;QACP,KAAK,EAAE,WAAW;QAElB,IAAI,CACF,UAA0B,EAC1B,OAA8B;YAE9B,OAAO,WAAW,CAAY,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;QACpF,CAAC;QAED,MAAM,CACJ,UAA4B,EAC5B,OAA8B;YAE9B,2DAA2D;YAC3D,yEAAyE;YAEzE,IAAI,aAAuC,CAAA;YAC3C,IAAI,YAAuC,CAAA;YAE3C,MAAM,aAAa,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC7D,aAAa,GAAG,OAAO,CAAA;gBACvB,YAAY,GAAG,MAAM,CAAA;YACvB,CAAC,CAAC,CAAA;YAEF,oEAAoE;YACpE,KAAK,SAAS,CAAC,CAAC,iBAAiB;gBAC/B,IAAI,WAAyC,CAAA;gBAC7C,IAAI,CAAC;oBACH,WAAW,GAAG,MAAM,aAAa,CAC/B,UAAU,EACV,QAAQ,EACR,OAAO,EACP,WAAW,EACX,OAAO,CACR,CAAA;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,YAAY,CAAC,GAAG,CAAC,CAAA;oBACjB,MAAM,GAAG,CAAA;gBACX,CAAC;gBAED,wCAAwC;gBACxC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;gBAEpD,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;oBACrC,MAAM,IAAI,CAAA;gBACZ,CAAC;YACH,CAAC;YAED,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAA;YAEpC,OAAO;gBACL,CAAC,MAAM,CAAC,aAAa,CAAC;oBACpB,OAAO,QAAQ,CAAA;gBACjB,CAAC;gBACD,MAAM,EAAE,aAAa;aACtB,CAAA;QACH,CAAC;KACF,CAAA;IAED,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;AACzB,CAAC;AAqBD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA"}

package/build/src/client/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/src/client/index.test.js

@@ -0,0 +1,231 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createClient } from './index.js';
+import { ClientRequestError } from './errors.js';
+// ── helpers ───────────────────────────────────────────────
+async function* makeAsyncIterable(items) {
+    for (const item of items) {
+        yield item;
+    }
+}
+function makeAdapter(responseBody = { ok: true }, streamItems = []) {
+    return {
+        request: vi.fn(async (_req) => ({
+            status: 200,
+            headers: {},
+            body: responseBody,
+        })),
+        stream: vi.fn(async (_req) => ({
+            status: 200,
+            headers: {},
+            body: makeAsyncIterable(streamItems),
+        })),
+    };
+}
+function makeCallDescriptor(overrides) {
+    return {
+        name: 'GetUser',
+        scope: 'users',
+        path: '/users',
+        method: 'GET',
+        kind: 'rpc',
+        params: { id: '1' },
+        ...overrides,
+    };
+}
+function makeStreamDescriptor(overrides) {
+    return {
+        name: 'WatchUsers',
+        scope: 'users',
+        path: '/stream/users',
+        method: 'POST',
+        kind: 'stream',
+        streamMode: 'sse',
+        params: {},
+        ...overrides,
+    };
+}
+// ── createClient ──────────────────────────────────────────
+describe('createClient', () => {
+    it('creates a client with typed scope callables', () => {
+        const adapter = makeAdapter();
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            scopes: (instance) => ({
+                users: {
+                    getUser: (id) => instance.call(makeCallDescriptor({ params: { id } })),
+                },
+            }),
+        });
+        expect(client).toHaveProperty('users');
+        expect(client.users).toHaveProperty('getUser');
+        expect(typeof client.users.getUser).toBe('function');
+    });
+    it('executes procedure calls through the adapter', async () => {
+        const adapter = makeAdapter({ id: '1', name: 'Alice' });
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            scopes: (instance) => ({
+                users: {
+                    getUser: (id) => instance.call(makeCallDescriptor({ params: { id } })),
+                },
+            }),
+        });
+        const result = await client.users.getUser('1');
+        expect(adapter.request).toHaveBeenCalledOnce();
+        expect(result).toEqual({ id: '1', name: 'Alice' });
+    });
+    it('throws ClientRequestError on non-2xx from scope callable', async () => {
+        const adapter = {
+            request: vi.fn(async () => ({
+                status: 404,
+                headers: {},
+                body: { message: 'Not Found' },
+            })),
+            stream: vi.fn(async () => ({
+                status: 200,
+                headers: {},
+                body: makeAsyncIterable([]),
+            })),
+        };
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            scopes: (instance) => ({
+                users: {
+                    getUser: (id) => instance.call(makeCallDescriptor({ params: { id } })),
+                },
+            }),
+        });
+        await expect(client.users.getUser('99')).rejects.toThrow(ClientRequestError);
+    });
+    it('applies global hooks to all calls', async () => {
+        const capturedHeaders = [];
+        const adapter = {
+            request: vi.fn(async (req) => {
+                capturedHeaders.push(req.headers ?? {});
+                return { status: 200, headers: {}, body: {} };
+            }),
+            stream: vi.fn(async () => ({
+                status: 200,
+                headers: {},
+                body: makeAsyncIterable([]),
+            })),
+        };
+        const globalHooks = {
+            onBeforeRequest: (ctx) => ({
+                ...ctx,
+                request: { ...ctx.request, headers: { 'x-api-key': 'secret' } },
+            }),
+        };
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            hooks: globalHooks,
+            scopes: (instance) => ({
+                users: {
+                    getUser: () => instance.call(makeCallDescriptor()),
+                },
+            }),
+        });
+        await client.users.getUser();
+        expect(capturedHeaders[0]?.['x-api-key']).toBe('secret');
+    });
+    it('streaming works — SSE yield and return via client.stream()', async () => {
+        const sseItems = [
+            { data: { n: 1 }, event: 'tick' },
+            { data: { n: 2 }, event: 'tick' },
+            { data: { total: 2 }, event: 'return' },
+        ];
+        const adapter = makeAdapter({}, sseItems);
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            scopes: (instance) => ({
+                updates: {
+                    watch: () => instance.stream(makeStreamDescriptor({ streamMode: 'sse' })),
+                },
+            }),
+        });
+        const stream = client.updates.watch();
+        const yielded = [];
+        for await (const item of stream) {
+            yielded.push(item);
+        }
+        expect(yielded).toEqual([{ n: 1 }, { n: 2 }]);
+        await expect(stream.result).resolves.toEqual({ total: 2 });
+    });
+    it('streaming works — text mode yields raw chunks', async () => {
+        const chunks = ['line1\n', 'line2\n'];
+        const adapter = makeAdapter({}, chunks);
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            scopes: (instance) => ({
+                logs: {
+                    tail: () => instance.stream(makeStreamDescriptor({ streamMode: 'text', name: 'TailLogs', scope: 'logs' })),
+                },
+            }),
+        });
+        const stream = client.logs.tail();
+        const received = [];
+        for await (const chunk of stream) {
+            received.push(chunk);
+        }
+        expect(received).toEqual(chunks);
+        await expect(stream.result).resolves.toBeUndefined();
+    });
+    it('stream() is synchronous — returns TypedStream immediately (no await needed)', () => {
+        const adapter = makeAdapter({}, []);
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            scopes: (instance) => ({
+                updates: {
+                    watch: () => instance.stream(makeStreamDescriptor()),
+                },
+            }),
+        });
+        // Must be synchronous — no await
+        const stream = client.updates.watch();
+        expect(typeof stream[Symbol.asyncIterator]).toBe('function');
+        expect(stream).toHaveProperty('result');
+        expect(stream.result).toBeInstanceOf(Promise);
+    });
+    it('applies global hooks to streams', async () => {
+        const capturedHeaders = [];
+        const adapter = {
+            request: vi.fn(async () => { throw new Error('not expected'); }),
+            stream: vi.fn(async (req) => {
+                capturedHeaders.push(req.headers ?? {});
+                return { status: 200, headers: {}, body: makeAsyncIterable([]) };
+            }),
+        };
+        const globalHooks = {
+            onBeforeRequest: (ctx) => ({
+                ...ctx,
+                request: { ...ctx.request, headers: { 'x-stream-key': 'stream-secret' } },
+            }),
+        };
+        const client = createClient({
+            adapter,
+            basePath: 'https://api.example.com',
+            hooks: globalHooks,
+            scopes: (instance) => ({
+                updates: {
+                    watch: () => instance.stream(makeStreamDescriptor()),
+                },
+            }),
+        });
+        const stream = client.updates.watch();
+        for await (const _ of stream) { /* drain */ }
+        expect(capturedHeaders[0]?.['x-stream-key']).toBe('stream-secret');
+    });
+    it('barrel exports: re-exports ClientRequestError', async () => {
+        // This verifies the exports are accessible — the import at the top covers this
+        const { ClientRequestError: CRE } = await import('./index.js');
+        expect(CRE).toBeDefined();
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/src/client/index.test.js.map

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

package/build/src/client/request-builder.d.ts

@@ -0,0 +1,13 @@
+import type { AdapterRequest, CallDescriptor } from './types.js';
+/**
+ * Replaces `:paramName` segments in `path` with URI-encoded values from `params`.
+ * Throws `ClientPathParamError` if a required segment is missing from `params`.
+ */
+export declare function interpolatePath(path: string, params: Record<string, unknown>, procedureName: string): string;
+/**
+ * Builds an `AdapterRequest` from a `CallDescriptor` and a base URL.
+ *
+ * - `kind === 'rpc'` or `kind === 'stream'`: params are flat — sent as the JSON body.
+ * - `kind === 'api'`: params are structured channels — `pathParams`, `query`, `body`, `headers`.
+ */
+export declare function buildAdapterRequest(descriptor: CallDescriptor, basePath: string): AdapterRequest;

package/build/src/client/request-builder.js

@@ -0,0 +1,53 @@
+import { ClientPathParamError } from './errors.js';
+/**
+ * Replaces `:paramName` segments in `path` with URI-encoded values from `params`.
+ * Throws `ClientPathParamError` if a required segment is missing from `params`.
+ */
+export function interpolatePath(path, params, procedureName) {
+    return path.replace(/:([A-Za-z_][A-Za-z0-9_]*)/g, (_match, key) => {
+        const value = params[key];
+        if (value === undefined || value === null) {
+            throw new ClientPathParamError(key, path, procedureName);
+        }
+        return encodeURIComponent(String(value));
+    });
+}
+/**
+ * Builds an `AdapterRequest` from a `CallDescriptor` and a base URL.
+ *
+ * - `kind === 'rpc'` or `kind === 'stream'`: params are flat — sent as the JSON body.
+ * - `kind === 'api'`: params are structured channels — `pathParams`, `query`, `body`, `headers`.
+ */
+export function buildAdapterRequest(descriptor, basePath) {
+    const { name, path, method, kind, params } = descriptor;
+    if (kind === 'rpc' || kind === 'stream') {
+        return {
+            url: `${basePath}${path}`,
+            method,
+            body: params,
+        };
+    }
+    // kind === 'api' — params are structured channels
+    const structured = (params ?? {});
+    // Interpolate path params
+    const interpolatedPath = structured.pathParams
+        ? interpolatePath(path, structured.pathParams, name)
+        : path;
+    // Build query string
+    let url = `${basePath}${interpolatedPath}`;
+    if (structured.query && Object.keys(structured.query).length > 0) {
+        const searchParams = new URLSearchParams(Object.entries(structured.query).map(([k, v]) => [k, String(v)]));
+        url = `${url}?${searchParams.toString()}`;
+    }
+    // Build headers
+    const headers = structured.headers && Object.keys(structured.headers).length > 0
+        ? structured.headers
+        : undefined;
+    return {
+        url,
+        method,
+        headers,
+        body: structured.body,
+    };
+}
+//# sourceMappingURL=request-builder.js.map

package/build/src/client/request-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-builder.js","sourceRoot":"","sources":["../../../src/client/request-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAGlD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,MAA+B,EAC/B,aAAqB;IAErB,OAAO,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC,MAAM,EAAE,GAAW,EAAE,EAAE;QACxE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAC1C,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;QAC1D,CAAC;QACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;IAC1C,CAAC,CAAC,CAAA;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAA0B,EAAE,QAAgB;IAC9E,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAAA;IAEvD,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO;YACL,GAAG,EAAE,GAAG,QAAQ,GAAG,IAAI,EAAE;YACzB,MAAM;YACN,IAAI,EAAE,MAAM;SACb,CAAA;IACH,CAAC;IAED,kDAAkD;IAClD,MAAM,UAAU,GAAG,CAAC,MAAM,IAAI,EAAE,CAK/B,CAAA;IAED,0BAA0B;IAC1B,MAAM,gBAAgB,GAAG,UAAU,CAAC,UAAU;QAC5C,CAAC,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC;QACpD,CAAC,CAAC,IAAI,CAAA;IAER,qBAAqB;IACrB,IAAI,GAAG,GAAG,GAAG,QAAQ,GAAG,gBAAgB,EAAE,CAAA;IAC1C,IAAI,UAAU,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjE,MAAM,YAAY,GAAG,IAAI,eAAe,CACtC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CACjE,CAAA;QACD,GAAG,GAAG,GAAG,GAAG,IAAI,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAA;IAC3C,CAAC;IAED,gBAAgB;IAChB,MAAM,OAAO,GACX,UAAU,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;QAC9D,CAAC,CAAC,UAAU,CAAC,OAAO;QACpB,CAAC,CAAC,SAAS,CAAA;IAEf,OAAO;QACL,GAAG;QACH,MAAM;QACN,OAAO;QACP,IAAI,EAAE,UAAU,CAAC,IAAI;KACtB,CAAA;AACH,CAAC"}

package/build/src/client/request-builder.test.d.ts

@@ -0,0 +1 @@
+export {};