ts-procedures 5.9.1 → 5.10.2

package/agent_config/claude-code/skills/{scaffold → ts-procedures-scaffold}/SKILL.md

@@ -1,38 +1,28 @@
 ---
-name: scaffold
-description: "Scaffold ts-procedures code with correct patterns. Usage: /ts-procedures:scaffold <type> <Name>"
-invocable_by:
-  - user
-  - model
-user_instructions: |
-  Usage: /ts-procedures:scaffold <type> <Name>
-
-  Types: procedure, stream-procedure, express-rpc, hono-rpc, hono-stream, hono-api
-
-  Examples:
-    /ts-procedures:scaffold procedure GetUser
-    /ts-procedures:scaffold stream-procedure StreamActivity
-    /ts-procedures:scaffold express-rpc UserApi
-    /ts-procedures:scaffold hono-rpc OrderApi
-    /ts-procedures:scaffold hono-stream LiveFeed
-    /ts-procedures:scaffold hono-api ProductApi
+name: ts-procedures-scaffold
+description: "Generate ts-procedures implementations with correct patterns — procedures, streams, Express RPC, Hono RPC, Hono streaming, REST APIs, and client setup."
+argument-hint: "<type> <Name>"
+allowed-tools: Read Write
 ---
 
 # Scaffold ts-procedures Code
 
-Parse `$ARGUMENTS` as `<type> <Name>` (case-insensitive type, PascalCase Name).
+Scaffold a `$0` ts-procedures implementation named `$1`.
+
+If either argument is missing, ask the user for `<type>` and `<Name>`.
 
 ## Instructions
 
-1. Parse the arguments. If missing, ask the user for `<type>` and `<Name>`.
-2. Derive placeholder variants from the provided PascalCase Name:
+1. Validate `$0` is a recognized type (see table below). Case-insensitive.
+2. Validate `$1` is PascalCase (e.g., `UserProfile`).
+3. Derive placeholder variants from the provided PascalCase Name:
    - `{{Name}}` — PascalCase as given (e.g., `UserProfile`)
    - `{{name}}` — camelCase (e.g., `userProfile`)
    - For URL scopes and file paths, use kebab-case (e.g., `user-profile`)
-3. Read the template file from `templates/<type>.md` in this skill directory.
-4. Replace all `{{Name}}` and `{{name}}` placeholders with the appropriate variants.
-5. Generate the implementation file(s) following the template exactly.
-6. Also generate a colocated test file following ts-procedures test conventions.
+4. Read the template file from `templates/$0.md` (relative to this skill directory).
+5. Replace all `{{Name}}` and `{{name}}` placeholders with the appropriate variants.
+6. Generate the implementation file(s) following the template exactly.
+7. Also generate a colocated test file following ts-procedures test conventions.
 
 ## Valid Types
 
@@ -44,6 +34,7 @@ Parse `$ARGUMENTS` as `<type> <Name>` (case-insensitive type, PascalCase Name).
 | `hono-rpc` | `templates/hono-rpc.md` | `{{Name}}.rpc.ts`, `{{Name}}.rpc.test.ts` |
 | `hono-stream` | `templates/hono-stream.md` | `{{Name}}.stream-rpc.ts`, `{{Name}}.stream-rpc.test.ts` |
 | `hono-api` | `templates/hono-api.md` | `{{Name}}.api.ts`, `{{Name}}.api.test.ts` |
+| `client` | `templates/client.md` | `{{Name}}.client.ts`, `{{Name}}.client.test.ts` |
 
 ## Rules
 
@@ -54,3 +45,7 @@ Parse `$ARGUMENTS` as `<type> <Name>` (case-insensitive type, PascalCase Name).
 - Use TypeBox for schema definitions (`import { Type } from 'typebox'`).
 - AJV config: `allErrors: true`, `coerceTypes: true`, `removeAdditional: true`.
 - Test files use `describe`/`test` from vitest.
+
+## Workflow
+
+Use the **ts-procedures-architect** agent to plan your API structure first, then scaffold each procedure. After scaffolding, use `/ts-procedures:review <path>` to validate the implementation.

package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/client.md

@@ -0,0 +1,115 @@
+# Client Template: {{Name}}
+
+## Implementation — `{{Name}}.client.ts`
+
+```typescript
+import { createClient, createFetchAdapter } from 'ts-procedures/client'
+import { createScopeBindings } from './generated/api'
+// With --service-name: import { create{{Name}}Bindings } from './generated/api'
+
+// Create the typed client
+export const {{name}}Client = createClient({
+  adapter: createFetchAdapter(),
+  basePath: 'http://localhost:3000', // TODO: configure base URL
+  scopes: createScopeBindings,
+  // With --service-name: scopes: create{{Name}}Bindings,
+  hooks: {
+    onBeforeRequest(ctx) {
+      // TODO: add auth headers, request IDs, etc.
+      ctx.request.headers = {
+        ...ctx.request.headers,
+        // Authorization: `Bearer ${getToken()}`,
+      }
+      return ctx
+    },
+    onAfterResponse(ctx) {
+      // TODO: handle global response concerns (401 redirect, rate limiting, etc.)
+      // if (ctx.response.status === 401) { redirect('/login') }
+    },
+  },
+})
+
+// --- RPC call example ---
+// const user = await {{name}}Client.users.GetUser({ userId: '123' })
+
+// --- API call example (with schema.input channels) ---
+// const user = await {{name}}Client.users.GetUser({ pathParams: { id: '123' } })
+
+// --- Streaming call example ---
+// const stream = {{name}}Client.events.WatchNotifications({ filter: 'all' })
+// for await (const event of stream) {
+//   console.log(event) // Typed from server yieldType schema
+// }
+// const result = await stream.result // Typed from server returnType schema
+
+// --- Per-procedure hook override ---
+// const user = await {{name}}Client.users.GetUser({ id: '123' }, {
+//   onAfterResponse(ctx) {
+//     console.log('Rate limit:', ctx.response.headers['x-rate-limit-remaining'])
+//   },
+// })
+```
+
+## Test — `{{Name}}.client.test.ts`
+
+```typescript
+import { describe, test, expect, beforeAll, afterAll } from 'vitest'
+import { {{name}}Client } from './{{Name}}.client'
+
+// TODO: start your server before tests, or mock the adapter
+// import { createServer } from './server'
+// let server: ReturnType<typeof createServer>
+
+describe('{{Name}} Client', () => {
+  // beforeAll(async () => {
+  //   server = createServer()
+  //   await server.listen(3000)
+  // })
+  //
+  // afterAll(async () => {
+  //   await server.close()
+  // })
+
+  test('makes RPC calls with typed params and response', async () => {
+    // TODO: replace with an actual procedure call
+    // const result = await {{name}}Client.users.GetUser({ userId: 'test-id' })
+    // expect(result).toBeDefined()
+    // expect(result.id).toBe('test-id')
+  })
+
+  test('handles validation errors from the server', async () => {
+    // TODO: call with invalid params and verify error handling
+    // await expect(
+    //   {{name}}Client.users.GetUser({} as any)
+    // ).rejects.toThrow()
+  })
+
+  test('streams data with typed yields', async () => {
+    // TODO: replace with an actual stream procedure call
+    // const stream = {{name}}Client.events.WatchNotifications({ filter: 'all' })
+    // const values = []
+    // for await (const event of stream) {
+    //   values.push(event)
+    //   if (values.length >= 3) break
+    // }
+    // expect(values).toHaveLength(3)
+    // const result = await stream.result
+    // expect(result).toBeDefined()
+  })
+})
+```
+
+## Code Generation Setup
+
+Generate the typed client bindings from your running server:
+
+```bash
+# Default (self-contained, namespaced types, JSDoc)
+npx ts-procedures-codegen --url http://localhost:3000/docs --out ./src/generated/api
+
+# With service name for multi-service apps
+npx ts-procedures-codegen --url http://localhost:3000/docs --out ./src/generated/api --service-name {{Name}}
+
+# Watch mode for development
+npx ts-procedures-codegen --url http://localhost:3000/docs --out ./src/generated/api --watch
+```

package/agent_config/lib/install-claude.mjs

@@ -1,109 +1,57 @@
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { cpSync, mkdirSync, readdirSync, statSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const SKILLS_DIR = join(__dirname, '..', 'claude-code', 'skills');
-const AGENTS_DIR = join(__dirname, '..', 'claude-code', 'agents');
-
-function getPackageVersion() {
-  try {
-    const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
-    return pkg.version || 'unknown';
-  } catch {
-    return 'unknown';
-  }
-}
-
-function makeAutoHeader() {
-  const version = getPackageVersion();
-  return `<!-- Auto-generated by ts-procedures@${version}. Updated on npm install/update. Do not edit. -->\n\n`;
-}
-
-function stripFrontmatter(content) {
-  const match = content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
-  return match ? match[1].trim() : content.trim();
-}
-
-function ensureDir(dir) {
-  if (!existsSync(dir)) {
-    mkdirSync(dir, { recursive: true });
+const SOURCE_DIR = join(__dirname, '..', 'claude-code');
+
+const SKILL_NAMES = ['ts-procedures', 'ts-procedures-review', 'ts-procedures-scaffold'];
+const AGENT_FILES = ['ts-procedures-architect.md'];
+
+function listFilesRecursive(dir) {
+  const out = [];
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) {
+      for (const nested of listFilesRecursive(full)) out.push(join(entry, nested));
+    } else {
+      out.push(entry);
+    }
   }
+  return out;
 }
 
 /**
  * Install Claude Code integration files into a project's .claude/ directory.
  *
  * Creates:
- *   .claude/rules/ts-procedures.md            — Framework reference (always loaded in context)
- *   .claude/commands/ts-procedures-scaffold.md — Scaffold command (/project:ts-procedures-scaffold)
- *   .claude/commands/ts-procedures-review.md   — Review command (/project:ts-procedures-review)
- *   .claude/agents/ts-procedures-architect.md  — Architecture planning agent
+ *   .claude/skills/ts-procedures/            — Framework reference skill
+ *   .claude/skills/ts-procedures-scaffold/   — Scaffold skill (templates included)
+ *   .claude/skills/ts-procedures-review/     — Review skill
+ *   .claude/agents/ts-procedures-architect.md — Architecture planning agent
  *
  * @param {string} projectRoot — Absolute path to the consuming project's root
  * @returns {{ files: string[] }} — List of created/updated file paths (relative to projectRoot)
  */
 export function installClaude(projectRoot) {
   const claudeDir = join(projectRoot, '.claude');
-  const rulesDir = join(claudeDir, 'rules');
-  const commandsDir = join(claudeDir, 'commands');
-  const agentsDir = join(claudeDir, 'agents');
-
-  ensureDir(rulesDir);
-  ensureDir(commandsDir);
-  ensureDir(agentsDir);
+  const skillsDest = join(claudeDir, 'skills');
+  const agentsDest = join(claudeDir, 'agents');
+  mkdirSync(skillsDest, { recursive: true });
+  mkdirSync(agentsDest, { recursive: true });
 
-  const autoHeader = makeAutoHeader();
   const files = [];
-
-  // 1. Rules file — framework reference (always loaded in context)
-  const guideSkill = readFileSync(join(SKILLS_DIR, 'guide', 'SKILL.md'), 'utf-8');
-  const guideBody = stripFrontmatter(guideSkill)
-    // Remove the "Supporting Files" section — replaced by "Detailed Reference" below
-    .replace(/\n## Supporting Files[\s\S]*$/, '');
-
-  const rulesContent = autoHeader + guideBody + `
-
-## Detailed Reference
-
-For complete API details, patterns, and anti-patterns, read the files in:
-\`node_modules/ts-procedures/agent_config/claude-code/skills/guide/\`
-
-- \`api-reference.md\` — Full API reference for Procedures, Create, CreateStream, errors, schema, HTTP implementations
-- \`patterns.md\` — Prescribed patterns with code examples
-- \`anti-patterns.md\` — Common mistakes to avoid with fixes
-`;
-
-  writeFileSync(join(rulesDir, 'ts-procedures.md'), rulesContent, 'utf-8');
-  files.push('.claude/rules/ts-procedures.md');
-
-  // 2. Scaffold command
-  const scaffoldSkill = readFileSync(join(SKILLS_DIR, 'scaffold', 'SKILL.md'), 'utf-8');
-  const scaffoldBody = stripFrontmatter(scaffoldSkill)
-    .replace(
-      'Read the template file from `templates/<type>.md` in this skill directory.',
-      'Read the template file from `node_modules/ts-procedures/agent_config/claude-code/skills/scaffold/templates/<type>.md`.'
-    );
-
-  writeFileSync(join(commandsDir, 'ts-procedures-scaffold.md'), autoHeader + scaffoldBody, 'utf-8');
-  files.push('.claude/commands/ts-procedures-scaffold.md');
-
-  // 3. Review command
-  const reviewSkill = readFileSync(join(SKILLS_DIR, 'review', 'SKILL.md'), 'utf-8');
-  const reviewBody = stripFrontmatter(reviewSkill)
-    .replaceAll(
-      '`checklist.md`',
-      '`node_modules/ts-procedures/agent_config/claude-code/skills/review/checklist.md`'
-    );
-
-  writeFileSync(join(commandsDir, 'ts-procedures-review.md'), autoHeader + reviewBody, 'utf-8');
-  files.push('.claude/commands/ts-procedures-review.md');
-
-  // 4. Architect agent
-  const architectAgent = readFileSync(join(AGENTS_DIR, 'ts-procedures-architect.md'), 'utf-8');
-  writeFileSync(join(agentsDir, 'ts-procedures-architect.md'), autoHeader + architectAgent, 'utf-8');
-  files.push('.claude/agents/ts-procedures-architect.md');
-
+  for (const skill of SKILL_NAMES) {
+    const src = join(SOURCE_DIR, 'skills', skill);
+    cpSync(src, join(skillsDest, skill), { recursive: true, force: true });
+    for (const rel of listFilesRecursive(src)) {
+      files.push(`.claude/skills/${skill}/${rel}`);
+    }
+  }
+  for (const agent of AGENT_FILES) {
+    cpSync(join(SOURCE_DIR, 'agents', agent), join(agentsDest, agent), { force: true });
+    files.push(`.claude/agents/${agent}`);
+  }
   return { files };
 }

package/build/src/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/src/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/src/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/src/client/call.test.d.ts

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

package/build/src/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/src/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/src/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/src/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/src/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/src/client/errors.test.d.ts

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

package/build/src/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