ts-procedures 5.5.0 → 5.6.0-beta.0

package/build/client/call.test.js

@@ -0,0 +1,124 @@
+import { describe, it, expect, vi } from 'vitest';
+import { executeCall } from './call.js';
+import { ClientRequestError } from './errors.js';
+// ── helpers ───────────────────────────────────────────────
+function makeDescriptor(overrides) {
+    return {
+        name: 'GetUser',
+        scope: 'users',
+        path: '/users',
+        method: 'GET',
+        kind: 'rpc',
+        params: { id: '42' },
+        ...overrides,
+    };
+}
+function makeAdapter(response) {
+    return {
+        request: vi.fn(async (_req) => ({
+            status: 200,
+            headers: {},
+            body: { id: '42', name: 'Alice' },
+            ...response,
+        })),
+        stream: vi.fn(async () => {
+            throw new Error('stream not expected in call tests');
+        }),
+    };
+}
+// ── executeCall ───────────────────────────────────────────
+describe('executeCall', () => {
+    it('calls adapter.request and returns body', async () => {
+        const adapter = makeAdapter({ body: { id: '1', name: 'Bob' } });
+        const result = await executeCall(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined);
+        expect(adapter.request).toHaveBeenCalledOnce();
+        expect(result).toEqual({ id: '1', name: 'Bob' });
+    });
+    it('throws ClientRequestError on 4xx response', async () => {
+        const adapter = makeAdapter({ status: 404, body: { message: 'Not Found' } });
+        await expect(executeCall(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined)).rejects.toThrow(ClientRequestError);
+    });
+    it('throws ClientRequestError on 5xx response', async () => {
+        const adapter = makeAdapter({ status: 500, body: { message: 'Server Error' } });
+        await expect(executeCall(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined)).rejects.toThrow(ClientRequestError);
+    });
+    it('throws ClientRequestError on 199 response (below 200)', async () => {
+        const adapter = makeAdapter({ status: 199, body: null });
+        await expect(executeCall(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined)).rejects.toThrow(ClientRequestError);
+    });
+    it('does not throw on 2xx boundary responses (200, 201, 299)', async () => {
+        for (const status of [200, 201, 204, 299]) {
+            const adapter = makeAdapter({ status, body: null });
+            await expect(executeCall(makeDescriptor(), 'https://api.example.com', adapter, {}, undefined)).resolves.not.toThrow();
+        }
+    });
+    it('runs onBeforeRequest before calling adapter (headers are modified)', async () => {
+        const capturedHeaders = [];
+        const adapter = {
+            request: vi.fn(async (req) => {
+                capturedHeaders.push(req.headers ?? {});
+                return { status: 200, headers: {}, body: {} };
+            }),
+            stream: vi.fn(async () => { throw new Error('not expected'); }),
+        };
+        const globalHooks = {
+            onBeforeRequest: (ctx) => ({
+                ...ctx,
+                request: {
+                    ...ctx.request,
+                    headers: { ...ctx.request.headers, 'x-auth': 'token-123' },
+                },
+            }),
+        };
+        await executeCall(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined);
+        expect(capturedHeaders[0]?.['x-auth']).toBe('token-123');
+    });
+    it('runs onAfterResponse after adapter returns', async () => {
+        const order = [];
+        const adapter = {
+            request: vi.fn(async () => {
+                order.push('adapter');
+                return { status: 200, headers: {}, body: {} };
+            }),
+            stream: vi.fn(async () => { throw new Error('not expected'); }),
+        };
+        const globalHooks = {
+            onAfterResponse: () => { order.push('afterResponse'); },
+        };
+        await executeCall(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined);
+        expect(order).toEqual(['adapter', 'afterResponse']);
+    });
+    it('does not throw when onAfterResponse swallows non-2xx by mutating status', async () => {
+        const adapter = makeAdapter({ status: 401, body: { message: 'Unauthorized' } });
+        const globalHooks = {
+            onAfterResponse: (ctx) => {
+                // Swallow the error by setting status to 200
+                ctx.response.status = 200;
+            },
+        };
+        await expect(executeCall(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined)).resolves.not.toThrow();
+    });
+    it('runs onError on adapter failure and re-throws', async () => {
+        const adapterError = new Error('Network failure');
+        const adapter = {
+            request: vi.fn(async () => { throw adapterError; }),
+            stream: vi.fn(async () => { throw new Error('not expected'); }),
+        };
+        const receivedErrors = [];
+        const globalHooks = {
+            onError: (ctx) => { receivedErrors.push(ctx.error); },
+        };
+        await expect(executeCall(makeDescriptor(), 'https://api.example.com', adapter, globalHooks, undefined)).rejects.toThrow('Network failure');
+        expect(receivedErrors[0]).toBe(adapterError);
+    });
+    it('passes per-procedure hooks as local hooks', async () => {
+        const adapter = makeAdapter();
+        const localOrder = [];
+        const localHooks = {
+            onBeforeRequest: (ctx) => { localOrder.push('local-before'); return ctx; },
+        };
+        await executeCall(makeDescriptor(), 'https://api.example.com', adapter, {}, localHooks);
+        expect(localOrder).toContain('local-before');
+    });
+});
+//# sourceMappingURL=call.test.js.map

package/build/client/call.test.js.map

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

package/build/client/errors.d.ts

@@ -0,0 +1,25 @@
+export declare class ClientRequestError extends Error {
+    readonly name = "ClientRequestError";
+    readonly status: number;
+    readonly headers: Record<string, string>;
+    readonly body: unknown;
+    readonly procedureName: string;
+    readonly scope: string;
+    constructor(opts: {
+        status: number;
+        headers: Record<string, string>;
+        body: unknown;
+        procedureName: string;
+        scope: string;
+    });
+}
+export declare class ClientPathParamError extends Error {
+    readonly name = "ClientPathParamError";
+    constructor(param: string, path: string, procedureName: string);
+}
+export declare class ClientStreamError extends Error {
+    readonly name = "ClientStreamError";
+    readonly procedureName: string;
+    readonly scope: string;
+    constructor(message: string, procedureName: string, scope: string);
+}

package/build/client/errors.js

@@ -0,0 +1,33 @@
+export class ClientRequestError extends Error {
+    name = 'ClientRequestError';
+    status;
+    headers;
+    body;
+    procedureName;
+    scope;
+    constructor(opts) {
+        super(`${opts.procedureName} (${opts.scope}) failed with status ${opts.status}`);
+        this.status = opts.status;
+        this.headers = opts.headers;
+        this.body = opts.body;
+        this.procedureName = opts.procedureName;
+        this.scope = opts.scope;
+    }
+}
+export class ClientPathParamError extends Error {
+    name = 'ClientPathParamError';
+    constructor(param, path, procedureName) {
+        super(`Missing path parameter "${param}" in "${path}" for procedure ${procedureName}`);
+    }
+}
+export class ClientStreamError extends Error {
+    name = 'ClientStreamError';
+    procedureName;
+    scope;
+    constructor(message, procedureName, scope) {
+        super(message);
+        this.procedureName = procedureName;
+        this.scope = scope;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/build/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,GAAG,oBAAoB,CAAA;IAC3B,MAAM,CAAQ;IACd,OAAO,CAAwB;IAC/B,IAAI,CAAS;IACb,aAAa,CAAQ;IACrB,KAAK,CAAQ;IAEtB,YAAY,IAMX;QACC,KAAK,CAAC,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,KAAK,wBAAwB,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;QACrB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAA;IACzB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,sBAAsB,CAAA;IAEtC,YAAY,KAAa,EAAE,IAAY,EAAE,aAAqB;QAC5D,KAAK,CAAC,2BAA2B,KAAK,SAAS,IAAI,mBAAmB,aAAa,EAAE,CAAC,CAAA;IACxF,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,GAAG,mBAAmB,CAAA;IAC1B,aAAa,CAAQ;IACrB,KAAK,CAAQ;IAEtB,YAAY,OAAe,EAAE,aAAqB,EAAE,KAAa;QAC/D,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAA;IACpB,CAAC;CACF"}

package/build/client/errors.test.d.ts

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

package/build/client/errors.test.js

@@ -0,0 +1,41 @@
+import { describe, it, expect } from 'vitest';
+import { ClientRequestError, ClientPathParamError, ClientStreamError } from './errors.js';
+describe('ClientRequestError', () => {
+    it('includes status, headers, and body', () => {
+        const err = new ClientRequestError({
+            status: 401,
+            headers: { 'x-request-id': 'abc' },
+            body: { message: 'Unauthorized' },
+            procedureName: 'GetUser',
+            scope: 'users',
+        });
+        expect(err).toBeInstanceOf(Error);
+        expect(err.name).toBe('ClientRequestError');
+        expect(err.status).toBe(401);
+        expect(err.headers['x-request-id']).toBe('abc');
+        expect(err.body).toEqual({ message: 'Unauthorized' });
+        expect(err.procedureName).toBe('GetUser');
+        expect(err.scope).toBe('users');
+        expect(err.message).toBe('GetUser (users) failed with status 401');
+    });
+});
+describe('ClientPathParamError', () => {
+    it('reports missing param', () => {
+        const err = new ClientPathParamError('id', '/users/:id', 'GetUser');
+        expect(err).toBeInstanceOf(Error);
+        expect(err.name).toBe('ClientPathParamError');
+        expect(err.message).toContain('id');
+        expect(err.message).toContain('/users/:id');
+    });
+});
+describe('ClientStreamError', () => {
+    it('includes procedure context', () => {
+        const err = new ClientStreamError('stream interrupted', 'Watch', 'events');
+        expect(err).toBeInstanceOf(Error);
+        expect(err.name).toBe('ClientStreamError');
+        expect(err.procedureName).toBe('Watch');
+        expect(err.scope).toBe('events');
+        expect(err.message).toBe('stream interrupted');
+    });
+});
+//# sourceMappingURL=errors.test.js.map

package/build/client/errors.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/client/errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEzF,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,GAAG,GAAG,IAAI,kBAAkB,CAAC;YACjC,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE;YAClC,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE;YACjC,aAAa,EAAE,SAAS;YACxB,KAAK,EAAE,OAAO;SACf,CAAC,CAAA;QACF,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;QAC3C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC/C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAA;QACrD,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAA;IACpE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,CAAC,CAAA;QACnE,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAA;QAC7C,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;QACnC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;IAC7C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA;AAEF,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,oBAAoB,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAA;QAC1E,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QACjC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAA;QAC1C,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QACvC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAChC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAA;IAChD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/build/client/fetch-adapter.d.ts

@@ -0,0 +1,12 @@
+import type { ClientAdapter } from './types.js';
+export interface FetchAdapterConfig {
+    headers?: Record<string, string>;
+}
+/**
+ * Creates a fetch-based ClientAdapter.
+ *
+ * - `config.headers` are default headers applied to every request.
+ * - Per-request headers override config headers (spread order).
+ * - Works in Node.js 18+ and browsers (uses standard fetch + ReadableStream).
+ */
+export declare function createFetchAdapter(config?: FetchAdapterConfig): ClientAdapter;

package/build/client/fetch-adapter.js

@@ -0,0 +1,156 @@
+/**
+ * Parses an SSE message block (the text between double-newlines).
+ * Returns null if there is no data field (e.g., comment-only blocks).
+ */
+function parseSSEBlock(block) {
+    const lines = block.split('\n');
+    let event;
+    let id;
+    const dataParts = [];
+    for (const line of lines) {
+        if (line.startsWith('event:')) {
+            event = line.slice('event:'.length).trim();
+        }
+        else if (line.startsWith('data:')) {
+            dataParts.push(line.slice('data:'.length).trimStart());
+        }
+        else if (line.startsWith('id:')) {
+            id = line.slice('id:'.length).trim();
+        }
+        // Lines starting with ':' are comments — skip them
+    }
+    if (dataParts.length === 0) {
+        return null;
+    }
+    const dataStr = dataParts.join('\n');
+    let data;
+    try {
+        data = JSON.parse(dataStr);
+    }
+    catch {
+        data = dataStr;
+    }
+    return { data, event, id };
+}
+/**
+ * Async generator that reads a ReadableStream<Uint8Array>, buffers text,
+ * splits on double-newline SSE boundaries, and yields parsed SSE events.
+ */
+async function* parseSseStream(readableStream) {
+    const reader = readableStream.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (value) {
+                buffer += decoder.decode(value, { stream: !done });
+            }
+            // Process all complete SSE message blocks (split on \n\n)
+            let boundary;
+            while ((boundary = buffer.indexOf('\n\n')) !== -1) {
+                const block = buffer.slice(0, boundary).trim();
+                buffer = buffer.slice(boundary + 2);
+                if (block.length > 0) {
+                    const event = parseSSEBlock(block);
+                    if (event !== null) {
+                        yield event;
+                    }
+                }
+            }
+            if (done)
+                break;
+        }
+        // Handle any remaining buffer content (no trailing \n\n)
+        const remaining = buffer.trim();
+        if (remaining.length > 0) {
+            const event = parseSSEBlock(remaining);
+            if (event !== null) {
+                yield event;
+            }
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+// ── Adapter ───────────────────────────────────────────────
+/**
+ * Extracts response headers as a plain Record<string, string>.
+ */
+function extractHeaders(response) {
+    const headers = {};
+    response.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    return headers;
+}
+/**
+ * Attempts to parse the response body as JSON, then as text, then returns null.
+ */
+async function parseResponseBody(response) {
+    // Clone so we can attempt multiple reads
+    const clone = response.clone();
+    try {
+        return await clone.json();
+    }
+    catch {
+        try {
+            const text = await response.text();
+            return text || null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Creates a fetch-based ClientAdapter.
+ *
+ * - `config.headers` are default headers applied to every request.
+ * - Per-request headers override config headers (spread order).
+ * - Works in Node.js 18+ and browsers (uses standard fetch + ReadableStream).
+ */
+export function createFetchAdapter(config) {
+    const configHeaders = config?.headers ?? {};
+    return {
+        async request(req) {
+            const mergedHeaders = {
+                ...configHeaders,
+                ...(req.headers ?? {}),
+            };
+            const response = await fetch(req.url, {
+                method: req.method,
+                headers: mergedHeaders,
+                body: req.body !== undefined ? JSON.stringify(req.body) : undefined,
+                signal: req.signal,
+            });
+            const headers = extractHeaders(response);
+            const body = await parseResponseBody(response);
+            return { status: response.status, headers, body };
+        },
+        async stream(req) {
+            const mergedHeaders = {
+                ...configHeaders,
+                ...(req.headers ?? {}),
+            };
+            const response = await fetch(req.url, {
+                method: req.method,
+                headers: mergedHeaders,
+                body: req.body !== undefined ? JSON.stringify(req.body) : undefined,
+                signal: req.signal,
+            });
+            const headers = extractHeaders(response);
+            if (!response.body) {
+                // No body — return an empty async iterable
+                const emptyBody = {
+                    [Symbol.asyncIterator]: async function* () { },
+                };
+                return { status: response.status, headers, body: emptyBody };
+            }
+            const body = parseSseStream(response.body);
+            return { status: response.status, headers, body };
+        },
+    };
+}
+//# sourceMappingURL=fetch-adapter.js.map

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

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

package/build/client/fetch-adapter.test.d.ts

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