ts-procedures 5.4.1 → 5.6.0-beta.0

package/agent_config/copilot/copilot-instructions.md

@@ -38,6 +38,10 @@ import { HonoStreamAppBuilder, sse } from 'ts-procedures/hono-stream'
 // Hono API (REST-style)
 import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
 import type { APIConfig, APIInput } from 'ts-procedures/hono-api'
+
+// Doc Registry — compose route docs from multiple builders
+import { DocRegistry } from 'ts-procedures/http-docs'
+import type { DocEnvelope, HeaderDoc, ErrorDoc } from 'ts-procedures/http-docs'
 ```
 
 ## Architecture Rules
@@ -288,3 +292,83 @@ describe('GetUser', () => {
 - `scope` can be string or string[] (joined as path segments)
 - Procedure name auto-converted to kebab-case
 - Stream routes support both GET (query params) and POST (JSON body)
+
+## Client Code Generation
+
+Generate type-safe client SDKs from a running DocRegistry endpoint.
+
+### Imports
+
+```typescript
+// Client Runtime
+import { createClient, createFetchAdapter } from 'ts-procedures/client'
+import type { ClientAdapter, ClientHooks, TypedStream, ClientInstance } from 'ts-procedures/client'
+
+// Code Generation (build-time only)
+import { generateClient } from 'ts-procedures/codegen'
+```
+
+### CLI
+
+```bash
+npx ts-procedures-codegen --url http://localhost:3000/docs --out ./src/generated/api
+```
+
+Generates one `.ts` file per scope plus a root `index.ts` exporting `createScopeBindings`.
+
+### createClient Example
+
+```typescript
+import { createClient, createFetchAdapter } from 'ts-procedures/client'
+import { createScopeBindings } from './generated/api'
+
+const client = createClient({
+  adapter: createFetchAdapter(),
+  basePath: 'http://localhost:3000',
+  scopes: createScopeBindings,
+  hooks: {
+    onBeforeRequest(ctx) {
+      ctx.request.headers = { ...ctx.request.headers, Authorization: `Bearer ${getToken()}` }
+      return ctx
+    },
+    onAfterResponse(ctx) {
+      if (ctx.response.status === 401) redirect('/login')
+    },
+  },
+})
+
+// Fully typed — params and response inferred from server schemas
+const user = await client.users.GetUser({ pathParams: { id: '123' } })
+
+// Per-call hook override
+await client.users.GetUser({ pathParams: { id: '123' } }, {
+  onAfterResponse(ctx) {
+    console.log(ctx.response.headers['x-rate-limit-remaining'])
+  },
+})
+```
+
+### Hook Types
+
+```typescript
+interface ClientHooks {
+  onBeforeRequest?: (ctx: { request: ClientRequest }) => { request: ClientRequest } | void
+  onAfterResponse?: (ctx: { request: ClientRequest; response: ClientResponse }) => void
+}
+```
+
+### TypedStream Usage
+
+```typescript
+const stream = client.events.WatchNotifications({ filter: 'all' })
+
+for await (const event of stream) {
+  console.log(event) // Typed as WatchNotificationsYield
+}
+
+const result = await stream.result // Typed as WatchNotificationsReturn
+```
+
+- `TypedStream<TYield, TReturn>` extends `AsyncIterable<TYield>`
+- `stream.result` resolves with the final return value sent as `event: 'return'` SSE message
+- Stream procedures that return `void` have `result` resolve to `undefined`

package/agent_config/cursor/cursorrules

@@ -38,6 +38,10 @@ import { HonoStreamAppBuilder, sse } from 'ts-procedures/hono-stream'
 // Hono API (REST-style)
 import { HonoAPIAppBuilder } from 'ts-procedures/hono-api'
 import type { APIConfig, APIInput } from 'ts-procedures/hono-api'
+
+// Doc Registry — compose route docs from multiple builders
+import { DocRegistry } from 'ts-procedures/http-docs'
+import type { DocEnvelope, HeaderDoc, ErrorDoc } from 'ts-procedures/http-docs'
 ```
 
 ## Architecture Rules
@@ -288,3 +292,83 @@ describe('GetUser', () => {
 - `scope` can be string or string[] (joined as path segments)
 - Procedure name auto-converted to kebab-case
 - Stream routes support both GET (query params) and POST (JSON body)
+
+## Client Code Generation
+
+Generate type-safe client SDKs from a running DocRegistry endpoint.
+
+### Imports
+
+```typescript
+// Client Runtime
+import { createClient, createFetchAdapter } from 'ts-procedures/client'
+import type { ClientAdapter, ClientHooks, TypedStream, ClientInstance } from 'ts-procedures/client'
+
+// Code Generation (build-time only)
+import { generateClient } from 'ts-procedures/codegen'
+```
+
+### CLI
+
+```bash
+npx ts-procedures-codegen --url http://localhost:3000/docs --out ./src/generated/api
+```
+
+Generates one `.ts` file per scope plus a root `index.ts` exporting `createScopeBindings`.
+
+### createClient Example
+
+```typescript
+import { createClient, createFetchAdapter } from 'ts-procedures/client'
+import { createScopeBindings } from './generated/api'
+
+const client = createClient({
+  adapter: createFetchAdapter(),
+  basePath: 'http://localhost:3000',
+  scopes: createScopeBindings,
+  hooks: {
+    onBeforeRequest(ctx) {
+      ctx.request.headers = { ...ctx.request.headers, Authorization: `Bearer ${getToken()}` }
+      return ctx
+    },
+    onAfterResponse(ctx) {
+      if (ctx.response.status === 401) redirect('/login')
+    },
+  },
+})
+
+// Fully typed — params and response inferred from server schemas
+const user = await client.users.GetUser({ pathParams: { id: '123' } })
+
+// Per-call hook override
+await client.users.GetUser({ pathParams: { id: '123' } }, {
+  onAfterResponse(ctx) {
+    console.log(ctx.response.headers['x-rate-limit-remaining'])
+  },
+})
+```
+
+### Hook Types
+
+```typescript
+interface ClientHooks {
+  onBeforeRequest?: (ctx: { request: ClientRequest }) => { request: ClientRequest } | void
+  onAfterResponse?: (ctx: { request: ClientRequest; response: ClientResponse }) => void
+}
+```
+
+### TypedStream Usage
+
+```typescript
+const stream = client.events.WatchNotifications({ filter: 'all' })
+
+for await (const event of stream) {
+  console.log(event) // Typed as WatchNotificationsYield
+}
+
+const result = await stream.result // Typed as WatchNotificationsReturn
+```
+
+- `TypedStream<TYield, TReturn>` extends `AsyncIterable<TYield>`
+- `stream.result` resolves with the final return value sent as `event: 'return'` SSE message
+- Stream procedures that return `void` have `result` resolve to `undefined`

package/build/client/call.d.ts

@@ -0,0 +1,14 @@
+import type { ClientAdapter, ClientHooks, CallDescriptor } from './types.js';
+/**
+ * Executes a single procedure call through the adapter.
+ *
+ * Flow:
+ * 1. Build AdapterRequest from descriptor
+ * 2. Run onBeforeRequest hooks (global then local)
+ * 3. Call adapter.request()
+ * 4. On adapter error: run onError hooks, re-throw
+ * 5. Run onAfterResponse hooks (hooks may mutate response.status)
+ * 6. If response status is non-2xx: throw ClientRequestError
+ * 7. Return response.body as TResponse
+ */
+export declare function executeCall<TResponse>(descriptor: CallDescriptor, basePath: string, adapter: ClientAdapter, globalHooks: ClientHooks, localHooks: ClientHooks | undefined): Promise<TResponse>;

package/build/client/call.js

@@ -0,0 +1,47 @@
+import { buildAdapterRequest } from './request-builder.js';
+import { runBeforeRequest, runAfterResponse, runOnError } from './hooks.js';
+import { ClientRequestError } from './errors.js';
+/**
+ * Executes a single procedure call through the adapter.
+ *
+ * Flow:
+ * 1. Build AdapterRequest from descriptor
+ * 2. Run onBeforeRequest hooks (global then local)
+ * 3. Call adapter.request()
+ * 4. On adapter error: run onError hooks, re-throw
+ * 5. Run onAfterResponse hooks (hooks may mutate response.status)
+ * 6. If response status is non-2xx: throw ClientRequestError
+ * 7. Return response.body as TResponse
+ */
+export async function executeCall(descriptor, basePath, adapter, globalHooks, localHooks) {
+    // 1. Build the initial request
+    let request = buildAdapterRequest(descriptor, basePath);
+    // 2. Run before-request hooks — they may mutate the request
+    const beforeCtx = await runBeforeRequest({ procedureName: descriptor.name, scope: descriptor.scope, request }, globalHooks, localHooks);
+    request = beforeCtx.request;
+    // 3. Call the adapter
+    let response;
+    try {
+        response = await adapter.request(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;
+    }
+    // 5. Run after-response hooks — they may mutate response.status to swallow errors
+    await runAfterResponse({ procedureName: descriptor.name, scope: descriptor.scope, request, response }, globalHooks, localHooks);
+    // 6. Check status AFTER hooks (hooks may have swallowed the error by mutating status)
+    if (response.status < 200 || response.status >= 300) {
+        throw new ClientRequestError({
+            status: response.status,
+            headers: response.headers,
+            body: response.body,
+            procedureName: descriptor.name,
+            scope: descriptor.scope,
+        });
+    }
+    // 7. Return the body
+    return response.body;
+}
+//# sourceMappingURL=call.js.map

package/build/client/call.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"call.js","sourceRoot":"","sources":["../../src/client/call.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAOhD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAA0B,EAC1B,QAAgB,EAChB,OAAsB,EACtB,WAAwB,EACxB,UAAmC;IAEnC,+BAA+B;IAC/B,IAAI,OAAO,GAAG,mBAAmB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAA;IAEvD,4DAA4D;IAC5D,MAAM,SAAS,GAAG,MAAM,gBAAgB,CACtC,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EACpE,WAAW,EACX,UAAU,CACX,CAAA;IACD,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;IAE3B,sBAAsB;IACtB,IAAI,QAAQ,CAAA;IACZ,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iDAAiD;QACjD,MAAM,UAAU,CACd,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAChF,WAAW,EACX,UAAU,CACX,CAAA;QACD,MAAM,GAAG,CAAA;IACX,CAAC;IAED,kFAAkF;IAClF,MAAM,gBAAgB,CACpB,EAAE,aAAa,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,EAC9E,WAAW,EACX,UAAU,CACX,CAAA;IAED,sFAAsF;IACtF,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACpD,MAAM,IAAI,kBAAkB,CAAC;YAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,aAAa,EAAE,UAAU,CAAC,IAAI;YAC9B,KAAK,EAAE,UAAU,CAAC,KAAK;SACxB,CAAC,CAAA;IACJ,CAAC;IAED,qBAAqB;IACrB,OAAO,QAAQ,CAAC,IAAiB,CAAA;AACnC,CAAC"}

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

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

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":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAShD,6DAA6D;AAE7D,SAAS,cAAc,CAAC,SAAmC;IACzD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;QACpB,GAAG,SAAS;KACb,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,QAAmC;IACtD,OAAO;QACL,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,IAAoB,EAA4B,EAAE,CAAC,CAAC;YACxE,MAAM,EAAE,GAAG;YACX,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE;YACjC,GAAG,QAAQ;SACZ,CAAC,CAAC;QACH,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE;YACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QACtD,CAAC,CAAC;KACH,CAAA;AACH,CAAC;AAED,6DAA6D;AAE7D,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;QAC/D,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CAAA;QACrG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,oBAAoB,EAAE,CAAA;QAC9C,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IAClD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,CAAC,CAAA;QAC5E,MAAM,MAAM,CACV,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CACjF,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,CAAA;QAC/E,MAAM,MAAM,CACV,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CACjF,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;QACxD,MAAM,MAAM,CACV,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CACjF,CAAC,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAA;IACvC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,0DAA0D,EAAE,KAAK,IAAI,EAAE;QACxE,KAAK,MAAM,MAAM,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;YAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACnD,MAAM,MAAM,CACV,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,EAAE,SAAS,CAAC,CACjF,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;QAC1B,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oEAAoE,EAAE,KAAK,IAAI,EAAE;QAClF,MAAM,eAAe,GAA6B,EAAE,CAAA;QACpD,MAAM,OAAO,GAAkB;YAC7B,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,GAAmB,EAA4B,EAAE;gBACrE,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;gBACvC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;YAC/C,CAAC,CAAC;YACF,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA,CAAC,CAAC,CAAC;SAC/D,CAAA;QAED,MAAM,WAAW,GAAgB;YAC/B,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACzB,GAAG,GAAG;gBACN,OAAO,EAAE;oBACP,GAAG,GAAG,CAAC,OAAO;oBACd,OAAO,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE;iBAC3D;aACF,CAAC;SACH,CAAA;QAED,MAAM,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;QAC/F,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;IAC1D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,KAAK,GAAa,EAAE,CAAA;QAC1B,MAAM,OAAO,GAAkB;YAC7B,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAA8B,EAAE;gBAClD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;gBACrB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;YAC/C,CAAC,CAAC;YACF,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA,CAAC,CAAC,CAAC;SAC/D,CAAA;QACD,MAAM,WAAW,GAAgB;YAC/B,eAAe,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAA,CAAC,CAAC;SACvD,CAAA;QAED,MAAM,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;QAC/F,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACvF,MAAM,OAAO,GAAG,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,CAAA;QAC/E,MAAM,WAAW,GAAgB;YAC/B,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE;gBACvB,6CAA6C;gBAC7C,GAAG,CAAC,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAA;YAC3B,CAAC;SACF,CAAA;QAED,MAAM,MAAM,CACV,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAC1F,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;QACjD,MAAM,OAAO,GAAkB;YAC7B,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,YAAY,CAAA,CAAC,CAAC,CAAC;YAClD,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAA,CAAC,CAAC,CAAC;SAC/D,CAAA;QACD,MAAM,cAAc,GAAc,EAAE,CAAA;QACpC,MAAM,WAAW,GAAgB;YAC/B,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA,CAAC,CAAC;SACrD,CAAA;QAED,MAAM,MAAM,CACV,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAC1F,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACpC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,OAAO,GAAG,WAAW,EAAE,CAAA;QAC7B,MAAM,UAAU,GAAa,EAAE,CAAA;QAC/B,MAAM,UAAU,GAAgB;YAC9B,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,GAAG,CAAA,CAAC,CAAC;SAC1E,CAAA;QAED,MAAM,WAAW,CAAC,cAAc,EAAE,EAAE,yBAAyB,EAAE,OAAO,EAAE,EAAE,EAAE,UAAU,CAAC,CAAA;QACvF,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;IAC9C,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

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;