ts-procedures 5.10.0 → 5.12.0

package/build/src/client/fetch-adapter.test.js

@@ -0,0 +1,271 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createFetchAdapter } from './fetch-adapter.js';
+// ── helpers ───────────────────────────────────────────────
+function mockSSEResponse(sseText) {
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+        start(controller) {
+            controller.enqueue(encoder.encode(sseText));
+            controller.close();
+        },
+    });
+    return new Response(stream, {
+        status: 200,
+        headers: { 'content-type': 'text/event-stream' },
+    });
+}
+function mockSSEResponseChunked(chunks) {
+    const encoder = new TextEncoder();
+    const stream = new ReadableStream({
+        start(controller) {
+            for (const chunk of chunks) {
+                controller.enqueue(encoder.encode(chunk));
+            }
+            controller.close();
+        },
+    });
+    return new Response(stream, {
+        status: 200,
+        headers: { 'content-type': 'text/event-stream' },
+    });
+}
+async function collectStream(stream) {
+    const items = [];
+    for await (const item of stream) {
+        items.push(item);
+    }
+    return items;
+}
+// ── request() tests ───────────────────────────────────────
+describe('createFetchAdapter — request()', () => {
+    beforeEach(() => {
+        vi.stubGlobal('fetch', vi.fn());
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('makes fetch call with correct URL, method, body', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({ id: 1 }), { status: 200 }));
+        const adapter = createFetchAdapter();
+        await adapter.request({
+            url: 'https://api.example.com/users',
+            method: 'POST',
+            body: { name: 'Alice' },
+        });
+        expect(mockFetch).toHaveBeenCalledOnce();
+        const [url, init] = mockFetch.mock.calls[0];
+        expect(url).toBe('https://api.example.com/users');
+        expect(init.method).toBe('POST');
+        expect(init.body).toBe(JSON.stringify({ name: 'Alice' }));
+    });
+    it('merges config headers with request headers (request wins)', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({}), { status: 200 }));
+        const adapter = createFetchAdapter({
+            headers: {
+                'x-api-key': 'default-key',
+                'x-source': 'config',
+            },
+        });
+        await adapter.request({
+            url: 'https://api.example.com/data',
+            method: 'GET',
+            headers: {
+                'x-api-key': 'override-key', // should win
+                'x-request-id': 'abc123',
+            },
+        });
+        const [, init] = mockFetch.mock.calls[0];
+        const headers = init.headers;
+        expect(headers['x-api-key']).toBe('override-key');
+        expect(headers['x-source']).toBe('config');
+        expect(headers['x-request-id']).toBe('abc123');
+    });
+    it('parses JSON response body', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({ result: 'ok' }), { status: 200 }));
+        const adapter = createFetchAdapter();
+        const response = await adapter.request({
+            url: 'https://api.example.com/ping',
+            method: 'GET',
+        });
+        expect(response.status).toBe(200);
+        expect(response.body).toEqual({ result: 'ok' });
+    });
+    it('handles empty/non-JSON response body gracefully (e.g. 204 No Content)', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(null, { status: 204 }));
+        const adapter = createFetchAdapter();
+        const response = await adapter.request({
+            url: 'https://api.example.com/delete',
+            method: 'DELETE',
+        });
+        expect(response.status).toBe(204);
+        // body should be null (or empty string) — not throw
+        expect(response.body === null || response.body === '').toBe(true);
+    });
+    it('passes signal to fetch', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({}), { status: 200 }));
+        const controller = new AbortController();
+        const adapter = createFetchAdapter();
+        await adapter.request({
+            url: 'https://api.example.com/slow',
+            method: 'GET',
+            signal: controller.signal,
+        });
+        const [, init] = mockFetch.mock.calls[0];
+        expect(init.signal).toBe(controller.signal);
+    });
+    it('returns response headers as Record<string, string>', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({}), {
+            status: 200,
+            headers: { 'content-type': 'application/json', 'x-request-id': 'xyz' },
+        }));
+        const adapter = createFetchAdapter();
+        const response = await adapter.request({
+            url: 'https://api.example.com/data',
+            method: 'GET',
+        });
+        expect(response.headers['content-type']).toBe('application/json');
+        expect(response.headers['x-request-id']).toBe('xyz');
+    });
+    it('sends no body when body is undefined', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(new Response(JSON.stringify({}), { status: 200 }));
+        const adapter = createFetchAdapter();
+        await adapter.request({
+            url: 'https://api.example.com/items',
+            method: 'GET',
+        });
+        const [, init] = mockFetch.mock.calls[0];
+        expect(init.body).toBeUndefined();
+    });
+});
+// ── stream() tests ────────────────────────────────────────
+describe('createFetchAdapter — stream()', () => {
+    beforeEach(() => {
+        vi.stubGlobal('fetch', vi.fn());
+    });
+    afterEach(() => {
+        vi.unstubAllGlobals();
+    });
+    it('parses SSE events from stream', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        const sseText = 'event: message\ndata: {"count":1}\nid: 0\n\nevent: message\ndata: {"count":2}\nid: 1\n\n';
+        mockFetch.mockResolvedValueOnce(mockSSEResponse(sseText));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        expect(response.status).toBe(200);
+        const items = await collectStream(response.body);
+        expect(items).toEqual([
+            { data: { count: 1 }, event: 'message', id: '0' },
+            { data: { count: 2 }, event: 'message', id: '1' },
+        ]);
+    });
+    it('handles multi-line data fields (multiple data: lines joined with newline)', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        // Multi-line data: per SSE spec, multiple data: lines are joined with \n
+        const sseText = 'event: multi\ndata: {"line":\ndata: "hello"}\n\n';
+        mockFetch.mockResolvedValueOnce(mockSSEResponse(sseText));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        const items = await collectStream(response.body);
+        expect(items).toHaveLength(1);
+        const item = items[0];
+        expect(item.event).toBe('multi');
+        // data is parsed from joined lines: '{"line":\n"hello"}'
+        expect(item.data).toEqual({ line: 'hello' });
+    });
+    it('handles chunked SSE data (message split across multiple chunks)', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        // Split the SSE message across 3 chunks
+        const chunks = [
+            'event: tick\nda',
+            'ta: {"n":42}\n',
+            '\n',
+        ];
+        mockFetch.mockResolvedValueOnce(mockSSEResponseChunked(chunks));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        const items = await collectStream(response.body);
+        expect(items).toEqual([{ data: { n: 42 }, event: 'tick', id: undefined }]);
+    });
+    it('yields parsed objects with event and id', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        const sseText = 'event: update\ndata: {"value":7}\nid: evt-99\n\n';
+        mockFetch.mockResolvedValueOnce(mockSSEResponse(sseText));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        const items = await collectStream(response.body);
+        expect(items).toEqual([{ data: { value: 7 }, event: 'update', id: 'evt-99' }]);
+    });
+    it('handles event: return correctly (just another SSE event)', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        const sseText = 'event: message\ndata: {"n":1}\n\nevent: return\ndata: {"total":10}\n\n';
+        mockFetch.mockResolvedValueOnce(mockSSEResponse(sseText));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        // The adapter yields all SSE events as-is — createTypedStream handles 'return' semantics
+        const items = await collectStream(response.body);
+        expect(items).toEqual([
+            { data: { n: 1 }, event: 'message', id: undefined },
+            { data: { total: 10 }, event: 'return', id: undefined },
+        ]);
+    });
+    it('returns response headers from stream response', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(mockSSEResponse('event: ping\ndata: {}\n\n'));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        expect(response.headers['content-type']).toContain('text/event-stream');
+    });
+    it('passes signal to fetch for streams', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        mockFetch.mockResolvedValueOnce(mockSSEResponse('event: ping\ndata: {}\n\n'));
+        const controller = new AbortController();
+        const adapter = createFetchAdapter();
+        await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+            signal: controller.signal,
+        });
+        const [, init] = mockFetch.mock.calls[0];
+        expect(init.signal).toBe(controller.signal);
+    });
+    it('handles SSE events without data field gracefully (skips them)', async () => {
+        const mockFetch = vi.mocked(globalThis.fetch);
+        // Comment-only message (no data field) — should be skipped
+        const sseText = ': keep-alive\n\nevent: message\ndata: {"ok":true}\n\n';
+        mockFetch.mockResolvedValueOnce(mockSSEResponse(sseText));
+        const adapter = createFetchAdapter();
+        const response = await adapter.stream({
+            url: 'https://api.example.com/stream',
+            method: 'GET',
+        });
+        const items = await collectStream(response.body);
+        // Only the message with data is yielded; comment-only block is skipped
+        expect(items).toEqual([{ data: { ok: true }, event: 'message', id: undefined }]);
+    });
+});
+//# sourceMappingURL=fetch-adapter.test.js.map

package/build/src/client/fetch-adapter.test.js.map

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

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

@@ -0,0 +1,17 @@
+import type { BeforeRequestContext, AfterResponseContext, ErrorContext, ClientHooks } from './types.js';
+/**
+ * Runs `onBeforeRequest` hooks: global first, then per-procedure.
+ * Each hook receives the (possibly mutated) context from the previous hook.
+ * Returns the final context.
+ */
+export declare function runBeforeRequest(ctx: BeforeRequestContext, globalHooks: ClientHooks, localHooks: ClientHooks | undefined): Promise<BeforeRequestContext>;
+/**
+ * Runs `onAfterResponse` hooks: global first, then per-procedure.
+ * Returns void.
+ */
+export declare function runAfterResponse(ctx: AfterResponseContext, globalHooks: ClientHooks, localHooks: ClientHooks | undefined): Promise<void>;
+/**
+ * Runs `onError` hooks: global first, then per-procedure.
+ * Returns void.
+ */
+export declare function runOnError(ctx: ErrorContext, globalHooks: ClientHooks, localHooks: ClientHooks | undefined): Promise<void>;

package/build/src/client/hooks.js

@@ -0,0 +1,40 @@
+/**
+ * Runs `onBeforeRequest` hooks: global first, then per-procedure.
+ * Each hook receives the (possibly mutated) context from the previous hook.
+ * Returns the final context.
+ */
+export async function runBeforeRequest(ctx, globalHooks, localHooks) {
+    let current = ctx;
+    if (globalHooks.onBeforeRequest) {
+        current = await globalHooks.onBeforeRequest(current);
+    }
+    if (localHooks?.onBeforeRequest) {
+        current = await localHooks.onBeforeRequest(current);
+    }
+    return current;
+}
+/**
+ * Runs `onAfterResponse` hooks: global first, then per-procedure.
+ * Returns void.
+ */
+export async function runAfterResponse(ctx, globalHooks, localHooks) {
+    if (globalHooks.onAfterResponse) {
+        await globalHooks.onAfterResponse(ctx);
+    }
+    if (localHooks?.onAfterResponse) {
+        await localHooks.onAfterResponse(ctx);
+    }
+}
+/**
+ * Runs `onError` hooks: global first, then per-procedure.
+ * Returns void.
+ */
+export async function runOnError(ctx, globalHooks, localHooks) {
+    if (globalHooks.onError) {
+        await globalHooks.onError(ctx);
+    }
+    if (localHooks?.onError) {
+        await localHooks.onError(ctx);
+    }
+}
+//# sourceMappingURL=hooks.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/client/hooks.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAyB,EACzB,WAAwB,EACxB,UAAmC;IAEnC,IAAI,OAAO,GAAG,GAAG,CAAA;IAEjB,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAChC,OAAO,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,UAAU,EAAE,eAAe,EAAE,CAAC;QAChC,OAAO,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,CAAA;IACrD,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAyB,EACzB,WAAwB,EACxB,UAAmC;IAEnC,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;QAChC,MAAM,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IACxC,CAAC;IAED,IAAI,UAAU,EAAE,eAAe,EAAE,CAAC;QAChC,MAAM,UAAU,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;IACvC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAiB,EACjB,WAAwB,EACxB,UAAmC;IAEnC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;QACxB,MAAM,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,CAAC;IAED,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;QACxB,MAAM,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/B,CAAC;AACH,CAAC"}

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

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

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 {};