ts-procedures 5.10.0 → 5.10.2

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

@@ -0,0 +1,160 @@
+import { describe, it, expect } from 'vitest';
+import { interpolatePath, buildAdapterRequest } from './request-builder.js';
+import { ClientPathParamError } from './errors.js';
+// ── interpolatePath ───────────────────────────────────────
+describe('interpolatePath', () => {
+    it('returns path unchanged when no params are present', () => {
+        expect(interpolatePath('/users', {}, 'GetUsers')).toBe('/users');
+    });
+    it('replaces a single :param with the provided value', () => {
+        expect(interpolatePath('/users/:id', { id: '42' }, 'GetUser')).toBe('/users/42');
+    });
+    it('replaces multiple :params in one path', () => {
+        expect(interpolatePath('/orgs/:orgId/users/:userId', { orgId: 'acme', userId: '7' }, 'GetUser')).toBe('/orgs/acme/users/7');
+    });
+    it('URI-encodes param values', () => {
+        expect(interpolatePath('/users/:name', { name: 'hello world' }, 'GetUser')).toBe('/users/hello%20world');
+    });
+    it('throws ClientPathParamError when a required param is missing', () => {
+        expect(() => interpolatePath('/users/:id', {}, 'GetUser')).toThrow(ClientPathParamError);
+    });
+    it('throws with descriptive message containing the param name and path', () => {
+        expect(() => interpolatePath('/users/:id', {}, 'GetUser')).toThrow(/id/);
+        expect(() => interpolatePath('/users/:id', {}, 'GetUser')).toThrow(/\/users\/:id/);
+    });
+    it('is a no-op when path has no :params', () => {
+        expect(interpolatePath('/static/path', {}, 'Foo')).toBe('/static/path');
+    });
+});
+// ── buildAdapterRequest ───────────────────────────────────
+describe('buildAdapterRequest', () => {
+    const base = {
+        name: 'GetUser',
+        scope: 'users',
+        path: '/users/:id',
+        method: 'GET',
+    };
+    it('RPC: sends flat params as JSON body', () => {
+        const descriptor = {
+            ...base,
+            path: '/rpc/GetUser',
+            kind: 'rpc',
+            params: { userId: '42', extra: true },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.url).toBe('https://api.example.com/rpc/GetUser');
+        expect(req.method).toBe('GET');
+        expect(req.body).toEqual({ userId: '42', extra: true });
+        expect(req.headers).toBeUndefined();
+    });
+    it('stream: sends flat params as JSON body (same as RPC)', () => {
+        const descriptor = {
+            ...base,
+            path: '/stream/Updates',
+            kind: 'stream',
+            params: { filter: 'active' },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.url).toBe('https://api.example.com/stream/Updates');
+        expect(req.body).toEqual({ filter: 'active' });
+    });
+    it('API: interpolates pathParams into URL', () => {
+        const descriptor = {
+            ...base,
+            path: '/users/:id',
+            kind: 'api',
+            params: { pathParams: { id: '99' } },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.url).toBe('https://api.example.com/users/99');
+        expect(req.body).toBeUndefined();
+    });
+    it('API: appends query params to the URL', () => {
+        const descriptor = {
+            ...base,
+            path: '/users',
+            kind: 'api',
+            params: { query: { role: 'admin', active: 'true' } },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.url).toContain('role=admin');
+        expect(req.url).toContain('active=true');
+    });
+    it('API: sets body from body channel', () => {
+        const descriptor = {
+            ...base,
+            path: '/users',
+            method: 'POST',
+            kind: 'api',
+            params: { body: { name: 'Alice', age: 30 } },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.body).toEqual({ name: 'Alice', age: 30 });
+    });
+    it('API: merges headers channel into request headers', () => {
+        const descriptor = {
+            ...base,
+            path: '/users',
+            kind: 'api',
+            params: { headers: { 'x-tenant-id': 'tenant-123' } },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.headers?.['x-tenant-id']).toBe('tenant-123');
+    });
+    it('API GET with query only — no body', () => {
+        const descriptor = {
+            ...base,
+            path: '/search',
+            method: 'GET',
+            kind: 'api',
+            params: { query: { q: 'typescript' } },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.url).toContain('q=typescript');
+        expect(req.body).toBeUndefined();
+    });
+    it('API: combines pathParams, query, body, and headers together', () => {
+        const descriptor = {
+            ...base,
+            path: '/orgs/:orgId/users/:userId',
+            method: 'PUT',
+            kind: 'api',
+            params: {
+                pathParams: { orgId: 'acme', userId: '7' },
+                query: { version: '2' },
+                body: { name: 'Bob' },
+                headers: { 'x-request-id': 'req-xyz' },
+            },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        expect(req.url).toContain('/orgs/acme/users/7');
+        expect(req.url).toContain('version=2');
+        expect(req.body).toEqual({ name: 'Bob' });
+        expect(req.headers?.['x-request-id']).toBe('req-xyz');
+    });
+    it('RPC with keys named "body" and "query" is treated as flat — NOT structured', () => {
+        const descriptor = {
+            ...base,
+            path: '/rpc/DoThing',
+            kind: 'rpc',
+            params: { body: 'literal-body-value', query: 'literal-query-value' },
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com');
+        // The entire params object goes to body — no query string appended
+        expect(req.body).toEqual({ body: 'literal-body-value', query: 'literal-query-value' });
+        expect(req.url).toBe('https://api.example.com/rpc/DoThing');
+        // Should NOT have a query string derived from params.query
+        expect(req.url).not.toContain('?');
+    });
+    it('prepends basePath to the URL', () => {
+        const descriptor = {
+            ...base,
+            path: '/users',
+            kind: 'rpc',
+            params: {},
+        };
+        const req = buildAdapterRequest(descriptor, 'https://api.example.com/v1');
+        expect(req.url).toBe('https://api.example.com/v1/users');
+    });
+});
+//# sourceMappingURL=request-builder.test.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { ClientAdapter, ClientHooks, StreamDescriptor, TypedStream } from './types.js';
+/**
+ * Wraps an AsyncIterable into a TypedStream.
+ *
+ * SSE mode: each item is `{ data, event?, id? }`.
+ *   - If `event === 'return'`, the data resolves `.result` and is NOT yielded.
+ *   - Otherwise, `data` is yielded.
+ *
+ * Text mode: each item is yielded as-is.
+ *   - `.result` resolves to `void` on completion.
+ *
+ * On error: `.result` rejects and the error is re-thrown from the async iterator.
+ */
+export declare function createTypedStream<TYield, TReturn = void>(source: AsyncIterable<unknown>, streamMode: 'sse' | 'text'): TypedStream<TYield, TReturn>;
+/**
+ * Executes a streaming procedure call through the adapter.
+ *
+ * Flow:
+ * 1. Build AdapterRequest from descriptor
+ * 2. Run onBeforeRequest hooks
+ * 3. Call adapter.stream()
+ * 4. On adapter error: run onError hooks, re-throw
+ * 5. Run onAfterResponse immediately (before iteration), body is null
+ * 6. If non-2xx: throw ClientRequestError
+ * 7. Return createTypedStream(streamResponse.body, descriptor.streamMode)
+ */
+export declare function executeStream<TYield, TReturn = void>(descriptor: StreamDescriptor, basePath: string, adapter: ClientAdapter, globalHooks: ClientHooks, localHooks: ClientHooks | undefined): Promise<TypedStream<TYield, TReturn>>;

package/build/src/client/stream.js

@@ -0,0 +1,118 @@
+import { buildAdapterRequest } from './request-builder.js';
+import { runBeforeRequest, runAfterResponse, runOnError } from './hooks.js';
+import { ClientRequestError } from './errors.js';
+// ── createTypedStream ─────────────────────────────────────
+/**
+ * Wraps an AsyncIterable into a TypedStream.
+ *
+ * SSE mode: each item is `{ data, event?, id? }`.
+ *   - If `event === 'return'`, the data resolves `.result` and is NOT yielded.
+ *   - Otherwise, `data` is yielded.
+ *
+ * Text mode: each item is yielded as-is.
+ *   - `.result` resolves to `void` on completion.
+ *
+ * On error: `.result` rejects and the error is re-thrown from the async iterator.
+ */
+export function createTypedStream(source, streamMode) {
+    let resolveResult;
+    let rejectResult;
+    const resultPromise = new Promise((resolve, reject) => {
+        resolveResult = resolve;
+        rejectResult = reject;
+    });
+    async function* generate() {
+        try {
+            if (streamMode === 'sse') {
+                let returnValue;
+                let hasReturn = false;
+                for await (const item of source) {
+                    const sseItem = item;
+                    if (sseItem.event === 'return') {
+                        returnValue = sseItem.data;
+                        hasReturn = true;
+                    }
+                    else {
+                        yield sseItem.data;
+                    }
+                }
+                // Resolve result after iteration completes
+                if (hasReturn) {
+                    resolveResult(returnValue);
+                }
+                else {
+                    resolveResult(undefined);
+                }
+            }
+            else {
+                // text mode: yield each item as-is
+                for await (const item of source) {
+                    yield item;
+                }
+                resolveResult(undefined);
+            }
+        }
+        catch (err) {
+            rejectResult(err);
+            throw err;
+        }
+    }
+    const iterator = generate();
+    return {
+        [Symbol.asyncIterator]() {
+            return iterator;
+        },
+        result: resultPromise,
+    };
+}
+// ── executeStream ─────────────────────────────────────────
+/**
+ * Executes a streaming procedure call through the adapter.
+ *
+ * Flow:
+ * 1. Build AdapterRequest from descriptor
+ * 2. Run onBeforeRequest hooks
+ * 3. Call adapter.stream()
+ * 4. On adapter error: run onError hooks, re-throw
+ * 5. Run onAfterResponse immediately (before iteration), body is null
+ * 6. If non-2xx: throw ClientRequestError
+ * 7. Return createTypedStream(streamResponse.body, descriptor.streamMode)
+ */
+export async function executeStream(descriptor, basePath, adapter, globalHooks, localHooks) {
+    // 1. Build the initial request
+    let request = buildAdapterRequest(descriptor, basePath);
+    // 2. Run before-request hooks
+    const beforeCtx = await runBeforeRequest({ procedureName: descriptor.name, scope: descriptor.scope, request }, globalHooks, localHooks);
+    request = beforeCtx.request;
+    // 3. Call the adapter
+    let streamResponse;
+    try {
+        streamResponse = await adapter.stream(request);
+    }
+    catch (err) {
+        // 4. On adapter error: run error hooks, re-throw
+        await runOnError({ procedureName: descriptor.name, scope: descriptor.scope, request, error: err }, globalHooks, localHooks);
+        throw err;
+    }
+    // Build an AdapterResponse shape for the hooks (body is null for streams at this point)
+    const responseForHooks = {
+        status: streamResponse.status,
+        headers: streamResponse.headers,
+        body: null,
+    };
+    // 5. Run after-response hooks immediately (before iteration)
+    await runAfterResponse({ procedureName: descriptor.name, scope: descriptor.scope, request, response: responseForHooks }, globalHooks, localHooks);
+    // 6. Check status after hooks (hooks may mutate responseForHooks.status)
+    if (responseForHooks.status < 200 || responseForHooks.status >= 300) {
+        throw new ClientRequestError({
+            status: responseForHooks.status,
+            headers: responseForHooks.headers,
+            body: responseForHooks.body,
+            procedureName: descriptor.name,
+            scope: descriptor.scope,
+        });
+    }
+    // 7. Return the typed stream
+    return createTypedStream(streamResponse.body, descriptor.streamMode);
+}
+//# sourceMappingURL=stream.js.map

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

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

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

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

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

@@ -0,0 +1,228 @@
+import { describe, it, expect, vi } from 'vitest';
+import { createTypedStream, executeStream } from './stream.js';
+import { ClientRequestError } from './errors.js';
+// ── helpers ───────────────────────────────────────────────
+function makeDescriptor(overrides) {
+    return {
+        name: 'WatchUpdates',
+        scope: 'updates',
+        path: '/stream/updates',
+        method: 'POST',
+        kind: 'stream',
+        streamMode: 'sse',
+        params: {},
+        ...overrides,
+    };
+}
+async function* makeAsyncIterable(items) {
+    for (const item of items) {
+        yield item;
+    }
+}
+function makeStreamAdapter(response, items) {
+    return {
+        request: vi.fn(async () => {
+            throw new Error('request not expected in stream tests');
+        }),
+        stream: vi.fn(async (_req) => ({
+            status: 200,
+            headers: {},
+            body: makeAsyncIterable(items ?? []),
+            ...response,
+        })),
+    };
+}
+// ── createTypedStream — SSE mode ──────────────────────────
+describe('createTypedStream — SSE mode', () => {
+    it('yields data payloads for normal events', async () => {
+        const sseItems = [
+            { data: { count: 1 }, event: 'update' },
+            { data: { count: 2 }, event: 'update' },
+        ];
+        const stream = createTypedStream(makeAsyncIterable(sseItems), 'sse');
+        const received = [];
+        for await (const item of stream) {
+            received.push(item);
+        }
+        expect(received).toEqual([{ count: 1 }, { count: 2 }]);
+    });
+    it('captures return event data in .result instead of yielding', async () => {
+        const sseItems = [
+            { data: { count: 1 }, event: 'update' },
+            { data: { total: 99 }, event: 'return' },
+        ];
+        const stream = createTypedStream(makeAsyncIterable(sseItems), 'sse');
+        const yielded = [];
+        for await (const item of stream) {
+            yielded.push(item);
+        }
+        // Only the 'update' event is yielded
+        expect(yielded).toEqual([{ count: 1 }]);
+        // The 'return' event resolves .result
+        const result = await stream.result;
+        expect(result).toEqual({ total: 99 });
+    });
+    it('resolves .result with undefined when no return event', async () => {
+        const sseItems = [
+            { data: 'hello', event: 'message' },
+        ];
+        const stream = createTypedStream(makeAsyncIterable(sseItems), 'sse');
+        for await (const _ of stream) { /* drain */ }
+        const result = await stream.result;
+        expect(result).toBeUndefined();
+    });
+    it('rejects .result and re-throws on error', async () => {
+        async function* errorIterable() {
+            yield { data: 'first', event: 'message' };
+            throw new Error('stream broke');
+        }
+        const stream = createTypedStream(errorIterable(), 'sse');
+        // Consuming the stream should throw
+        await expect(async () => {
+            for await (const _ of stream) { /* drain */ }
+        }).rejects.toThrow('stream broke');
+        // .result should also reject
+        await expect(stream.result).rejects.toThrow('stream broke');
+    });
+    it('handles SSE items without event field (defaults to yielding data)', async () => {
+        const sseItems = [
+            { data: 'a' },
+            { data: 'b' },
+        ];
+        const stream = createTypedStream(makeAsyncIterable(sseItems), 'sse');
+        const yielded = [];
+        for await (const item of stream) {
+            yielded.push(item);
+        }
+        expect(yielded).toEqual(['a', 'b']);
+    });
+});
+// ── createTypedStream — text mode ────────────────────────
+describe('createTypedStream — text mode', () => {
+    it('yields each chunk as-is', async () => {
+        const chunks = ['chunk1', 'chunk2', 'chunk3'];
+        const stream = createTypedStream(makeAsyncIterable(chunks), 'text');
+        const received = [];
+        for await (const chunk of stream) {
+            received.push(chunk);
+        }
+        expect(received).toEqual(chunks);
+    });
+    it('.result resolves to void on normal completion', async () => {
+        const stream = createTypedStream(makeAsyncIterable(['a', 'b']), 'text');
+        for await (const _ of stream) { /* drain */ }
+        const result = await stream.result;
+        expect(result).toBeUndefined();
+    });
+    it('rejects .result and re-throws on error', async () => {
+        async function* errorIterable() {
+            yield 'before error';
+            throw new Error('text stream error');
+        }
+        const stream = createTypedStream(errorIterable(), 'text');
+        await expect(async () => {
+            for await (const _ of stream) { /* drain */ }
+        }).rejects.toThrow('text stream error');
+        await expect(stream.result).rejects.toThrow('text stream error');
+    });
+});
+// ── executeStream ─────────────────────────────────────────
+describe('executeStream', () => {
+    it('calls adapter.stream and returns a TypedStream', async () => {
+        const items = [{ data: 'hello', event: 'msg' }];
+        const adapter = makeStreamAdapter({}, items);
+        const stream = await executeStream(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined);
+        expect(adapter.stream).toHaveBeenCalledOnce();
+        const received = [];
+        for await (const item of stream) {
+            received.push(item);
+        }
+        expect(received).toEqual(['hello']);
+    });
+    it('runs onBeforeRequest before calling adapter', 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-auth': 'stream-token' } },
+            }),
+        };
+        const stream = await executeStream(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined);
+        // Drain
+        for await (const _ of stream) { /* noop */ }
+        expect(capturedHeaders[0]?.['x-stream-auth']).toBe('stream-token');
+    });
+    it('runs onAfterResponse immediately (before iteration)', async () => {
+        const order = [];
+        const adapter = {
+            request: vi.fn(async () => { throw new Error('not expected'); }),
+            stream: vi.fn(async () => {
+                order.push('adapter');
+                return { status: 200, headers: {}, body: makeAsyncIterable([]) };
+            }),
+        };
+        const globalHooks = {
+            onAfterResponse: () => { order.push('afterResponse'); },
+        };
+        await executeStream(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined);
+        // After executeStream returns (before iteration), afterResponse should have fired
+        expect(order).toEqual(['adapter', 'afterResponse']);
+    });
+    it('throws ClientRequestError on non-2xx status', async () => {
+        const adapter = {
+            request: vi.fn(async () => { throw new Error('not expected'); }),
+            stream: vi.fn(async () => ({
+                status: 403,
+                headers: {},
+                body: makeAsyncIterable([]),
+            })),
+        };
+        await expect(executeStream(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined)).rejects.toThrow(ClientRequestError);
+    });
+    it('runs onError on adapter failure and re-throws', async () => {
+        const adapterError = new Error('stream connection failed');
+        const adapter = {
+            request: vi.fn(async () => { throw new Error('not expected'); }),
+            stream: vi.fn(async () => { throw adapterError; }),
+        };
+        const receivedErrors = [];
+        const globalHooks = {
+            onError: (ctx) => { receivedErrors.push(ctx.error); },
+        };
+        await expect(executeStream(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined)).rejects.toThrow('stream connection failed');
+        expect(receivedErrors[0]).toBe(adapterError);
+    });
+    it('returns TypedStream with working .result for SSE return event', async () => {
+        const sseItems = [
+            { data: { n: 1 }, event: 'tick' },
+            { data: { final: true }, event: 'return' },
+        ];
+        const adapter = makeStreamAdapter({}, sseItems);
+        const stream = await executeStream(makeDescriptor({ streamMode: 'sse' }), 'https://api.example.com', adapter, {}, undefined);
+        const yielded = [];
+        for await (const item of stream) {
+            yielded.push(item);
+        }
+        expect(yielded).toEqual([{ n: 1 }]);
+        await expect(stream.result).resolves.toEqual({ final: true });
+    });
+    it('returns TypedStream for text mode', async () => {
+        const chunks = ['line1', 'line2'];
+        const adapter = makeStreamAdapter({}, chunks);
+        const stream = await executeStream(makeDescriptor({ streamMode: 'text' }), 'https://api.example.com', adapter, {}, undefined);
+        const received = [];
+        for await (const chunk of stream) {
+            received.push(chunk);
+        }
+        expect(received).toEqual(chunks);
+        await expect(stream.result).resolves.toBeUndefined();
+    });
+});
+//# sourceMappingURL=stream.test.js.map

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

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

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

@@ -0,0 +1,78 @@
+export interface ClientAdapter {
+    request(config: AdapterRequest): Promise<AdapterResponse>;
+    stream(config: AdapterRequest): Promise<AdapterStreamResponse>;
+}
+export interface AdapterRequest {
+    url: string;
+    method: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    signal?: AbortSignal;
+}
+export interface AdapterResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: unknown;
+}
+export interface AdapterStreamResponse {
+    status: number;
+    headers: Record<string, string>;
+    body: AsyncIterable<unknown>;
+}
+export interface ClientHooks {
+    onBeforeRequest?(context: BeforeRequestContext): BeforeRequestContext | Promise<BeforeRequestContext>;
+    onAfterResponse?(context: AfterResponseContext): void | Promise<void>;
+    onError?(context: ErrorContext): void | Promise<void>;
+}
+export interface BeforeRequestContext {
+    procedureName: string;
+    scope: string;
+    request: AdapterRequest;
+}
+export interface AfterResponseContext {
+    procedureName: string;
+    scope: string;
+    request: AdapterRequest;
+    response: AdapterResponse;
+}
+export interface ErrorContext {
+    procedureName: string;
+    scope: string;
+    request: AdapterRequest;
+    error: unknown;
+}
+export interface CallDescriptor {
+    name: string;
+    scope: string;
+    path: string;
+    method: string;
+    kind: 'rpc' | 'api' | 'stream';
+    params: unknown;
+}
+export interface StreamDescriptor extends CallDescriptor {
+    kind: 'stream';
+    streamMode: 'sse' | 'text';
+}
+export interface TypedStream<TYield, TReturn = void> extends AsyncIterable<TYield> {
+    /**
+     * Resolves when the stream completes with the final return value.
+     * Rejects if the stream errors before completing.
+     * Note: iteration must begin (via for-await) for this promise to settle,
+     * since resolution depends on the async generator running to completion.
+     */
+    result: Promise<TReturn>;
+}
+export type ProcedureCallOptions = ClientHooks;
+export interface ClientInstance {
+    basePath: string;
+    adapter: ClientAdapter;
+    hooks: ClientHooks;
+    call<TResponse>(descriptor: CallDescriptor, options?: ProcedureCallOptions): Promise<TResponse>;
+    stream<TYield, TReturn>(descriptor: StreamDescriptor, options?: ProcedureCallOptions): TypedStream<TYield, TReturn>;
+}
+export interface CreateClientConfig<TScopes> {
+    adapter: ClientAdapter;
+    basePath: string;
+    scopes: (client: ClientInstance) => TScopes;
+    hooks?: ClientHooks;
+}

package/build/src/client/types.js

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