ts-procedures 5.10.0 → 5.12.0

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

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