ts-procedures 5.14.0 → 5.16.0

package/src/codegen/bin/cli.ts

@@ -21,6 +21,7 @@ export interface CodegenConfig {
   namespaceTypes?: boolean
   selfContained?: boolean
   serviceName?: string
+  cleanOutDir?: boolean
 }
 
 export interface ParsedArgs {
@@ -35,6 +36,7 @@ export interface ParsedArgs {
   namespaceTypes: boolean
   selfContained: boolean
   serviceName?: string
+  cleanOutDir: boolean
 }
 
 // ---------------------------------------------------------------------------
@@ -85,6 +87,7 @@ export function parseArgs(argv: string[], config?: CodegenConfig): ParsedArgs {
   let namespaceTypes = config?.namespaceTypes ?? true
   let selfContained = config?.selfContained ?? true
   let serviceName: string | undefined = config?.serviceName
+  let cleanOutDir = config?.cleanOutDir ?? false
   let configPath: string | undefined
 
   for (let i = 0; i < argv.length; i++) {
@@ -130,6 +133,10 @@ export function parseArgs(argv: string[], config?: CodegenConfig): ParsedArgs {
       selfContained = false
     } else if (arg === '--service-name') {
       serviceName = argv[++i]
+    } else if (arg === '--clean-out-dir') {
+      cleanOutDir = true
+    } else if (arg === '--no-clean-out-dir') {
+      cleanOutDir = false
     } else if (arg === '--config') {
       configPath = argv[++i]
     }
@@ -158,6 +165,7 @@ export function parseArgs(argv: string[], config?: CodegenConfig): ParsedArgs {
     namespaceTypes,
     selfContained,
     ...(serviceName !== undefined ? { serviceName } : {}),
+    cleanOutDir,
   }
 }
 
@@ -190,6 +198,7 @@ async function runWithWatch(parsed: ParsedArgs): Promise<void> {
     namespaceTypes: parsed.namespaceTypes,
     selfContained: parsed.selfContained,
     serviceName: parsed.serviceName,
+    cleanOutDir: parsed.cleanOutDir,
   }
 
   let lastHash: string | undefined
@@ -216,6 +225,7 @@ async function runWithWatch(parsed: ParsedArgs): Promise<void> {
         namespaceTypes: parsed.namespaceTypes,
         selfContained: parsed.selfContained,
         serviceName: parsed.serviceName,
+        cleanOutDir: parsed.cleanOutDir,
       })
       console.log(`[ts-procedures-codegen] Generated client files → ${parsed.outDir}`)
     } catch (err) {
@@ -258,6 +268,7 @@ async function main(): Promise<void> {
       namespaceTypes: parsed.namespaceTypes,
       selfContained: parsed.selfContained,
       serviceName: parsed.serviceName,
+      cleanOutDir: parsed.cleanOutDir,
     })
     if (parsed.dryRun) {
       console.log(`[ts-procedures-codegen] Dry run complete — ${result.length} files would be generated`)

package/src/codegen/e2e.test.ts

@@ -481,6 +481,157 @@ describe('E2E: generateClient full pipeline', () => {
         execSync(`${tscPath} --noEmit --project ${join(tmpDir, 'tsconfig.json')}`, { stdio: 'pipe' })
       }).not.toThrow()
     })
+
+    it('_types.ts exports RequestMeta (empty interface ready for augmentation)', async () => {
+      tmpDir = makeTmpDir()
+      await generateClient({ envelope, outDir: tmpDir, selfContained: true })
+
+      const content = readFileSync(join(tmpDir, '_types.ts'), 'utf-8')
+      expect(content).toContain('export interface RequestMeta')
+      // meta on AdapterRequest and ProcedureCallDefaults should be typed as RequestMeta
+      expect(content).toContain('meta?: RequestMeta')
+    })
+
+    it('developers can augment RequestMeta for typed per-call meta + typed hook/adapter access', async () => {
+      tmpDir = makeTmpDir()
+      await generateClient({ envelope, outDir: tmpDir, selfContained: true })
+
+      // Write a consumer file that augments RequestMeta, then uses typed meta
+      // end-to-end: per-call options, createClient defaults, onBeforeRequest, and adapter.
+      const consumer = `
+import { createClient } from './_client'
+import type { ClientAdapter } from './_types'
+import { createApiBindings } from './index'
+
+declare module './_types' {
+  interface RequestMeta {
+    traceId: string
+    priority?: 'high' | 'low'
+  }
+}
+
+const typedAdapter: ClientAdapter = {
+  async request(req) {
+    // req.meta is now typed
+    const trace: string | undefined = req.meta?.traceId
+    const pri: 'high' | 'low' | undefined = req.meta?.priority
+    void trace; void pri
+    return { status: 200, headers: {}, body: {} }
+  },
+  async stream(req) {
+    const trace: string | undefined = req.meta?.traceId
+    void trace
+    return { status: 200, headers: {}, body: (async function*() {})() }
+  },
+}
+
+const client = createClient({
+  adapter: typedAdapter,
+  basePath: 'https://api.example.com',
+  scopes: createApiBindings,
+  defaults: {
+    meta: { traceId: 'default-trace' }, // typed
+  },
+  hooks: {
+    onBeforeRequest(ctx) {
+      // ctx.request.meta is typed via declaration merging
+      const trace: string | undefined = ctx.request.meta?.traceId
+      void trace
+      return ctx
+    },
+  },
+})
+
+async function run(): Promise<void> {
+  // Per-call meta is typed — traceId is required, priority is optional
+  await client.users.GetUser(
+    { id: '1' },
+    { meta: { traceId: 'per-call-trace', priority: 'high' } },
+  )
+  // Timeout + signal + headers typecheck
+  await client.users.GetUser(
+    { id: '2' },
+    { timeout: 5000, headers: { 'X-Request-Id': 'abc' }, basePath: 'https://other' },
+  )
+}
+void run
+`
+      const { writeFileSync } = await import('node:fs')
+      writeFileSync(join(tmpDir, 'consumer.ts'), consumer)
+
+      const tsconfig = {
+        compilerOptions: {
+          strict: true,
+          target: 'ES2022',
+          module: 'ES2022',
+          moduleResolution: 'bundler',
+          noEmit: true,
+          skipLibCheck: true,
+        },
+        include: ['_types.ts', '_client.ts', 'index.ts', 'users.ts', 'events.ts', '_errors.ts', 'consumer.ts'],
+      }
+      writeFileSync(join(tmpDir, 'tsconfig.json'), JSON.stringify(tsconfig))
+
+      const { execSync } = await import('node:child_process')
+      const tscPath = join(process.cwd(), 'node_modules', '.bin', 'tsc')
+      expect(() => {
+        execSync(`${tscPath} --noEmit --project ${join(tmpDir, 'tsconfig.json')}`, { stdio: 'pipe' })
+      }).not.toThrow()
+    })
+
+    it('augmented RequestMeta rejects wrong types (compile error)', async () => {
+      tmpDir = makeTmpDir()
+      await generateClient({ envelope, outDir: tmpDir, selfContained: true })
+
+      // Passing a number for `traceId` (declared as string) should fail tsc
+      const consumer = `
+import { createClient, createFetchAdapter } from './_client'
+import { createApiBindings } from './index'
+// RequestMeta is imported only for augmentation below
+import type {} from './_types'
+
+declare module './_types' {
+  interface RequestMeta {
+    traceId: string
+  }
+}
+
+const client = createClient({
+  adapter: createFetchAdapter(),
+  basePath: 'https://api.example.com',
+  scopes: createApiBindings,
+})
+
+async function run(): Promise<void> {
+  // @ts-expect-error traceId must be string, not number
+  await client.users.GetUser({ id: '1' }, { meta: { traceId: 42 } })
+}
+void run
+`
+      const { writeFileSync } = await import('node:fs')
+      writeFileSync(join(tmpDir, 'consumer.ts'), consumer)
+
+      const tsconfig = {
+        compilerOptions: {
+          strict: true,
+          target: 'ES2022',
+          module: 'ES2022',
+          moduleResolution: 'bundler',
+          noEmit: true,
+          skipLibCheck: true,
+        },
+        include: ['_types.ts', '_client.ts', 'index.ts', 'users.ts', 'events.ts', '_errors.ts', 'consumer.ts'],
+      }
+      writeFileSync(join(tmpDir, 'tsconfig.json'), JSON.stringify(tsconfig))
+
+      const { execSync } = await import('node:child_process')
+      const tscPath = join(process.cwd(), 'node_modules', '.bin', 'tsc')
+      // With @ts-expect-error in place, tsc should pass; if RequestMeta wasn't
+      // enforcing the type, @ts-expect-error would fail because there'd be no error.
+      expect(() => {
+        execSync(`${tscPath} --noEmit --project ${join(tmpDir, 'tsconfig.json')}`, { stdio: 'pipe' })
+      }).not.toThrow()
+    })
   })
 
   // ── namespaceTypes mode ───────────────────────────────────────────────────

package/src/codegen/emit-client-runtime.ts

@@ -16,8 +16,10 @@ const TYPES_IMPORT = `import type {
   StreamDescriptor,
   TypedStream,
   ClientInstance,
+  ProcedureCallDefaults,
   ProcedureCallOptions,
   CreateClientConfig,
+  RequestMeta,
 } from './_types'`
 
 /**
@@ -27,6 +29,7 @@ const TYPES_IMPORT = `import type {
 const SOURCE_FILES = [
   'errors.ts',
   'request-builder.ts',
+  'resolve-options.ts',
   'hooks.ts',
   'call.ts',
   'stream.ts',

package/src/codegen/index.ts

@@ -10,6 +10,7 @@ export interface GenerateClientOptions extends ResolveInput {
   namespaceTypes?: boolean
   selfContained?: boolean
   serviceName?: string
+  cleanOutDir?: boolean
 }
 
 export async function generateClient(options: GenerateClientOptions): Promise<GeneratedFile[]> {
@@ -23,6 +24,7 @@ export async function generateClient(options: GenerateClientOptions): Promise<Ge
     namespaceTypes: options.namespaceTypes,
     selfContained: options.selfContained,
     serviceName: options.serviceName,
+    cleanOutDir: options.cleanOutDir,
   })
 }
 

package/src/codegen/pipeline.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect, afterEach, vi } from 'vitest'
 import { generateClient } from './index.js'
 import { runPipeline } from './pipeline.js'
-import { mkdirSync, rmSync, readFileSync, existsSync } from 'node:fs'
+import { mkdirSync, rmSync, readFileSync, existsSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { tmpdir } from 'node:os'
 import type { DocEnvelope } from '../implementations/types.js'
@@ -288,6 +288,51 @@ describe('generateClient pipeline', () => {
     expect(content).not.toContain('createScopeBindings')
   })
 
+  it('cleanOutDir: true removes stale files before writing', async () => {
+    tmpDir = makeTmpDir()
+    const stale = join(tmpDir, 'stale.ts')
+    writeFileSync(stale, '// stale', 'utf-8')
+    expect(existsSync(stale)).toBe(true)
+
+    await generateClient({ envelope, outDir: tmpDir, cleanOutDir: true })
+
+    expect(existsSync(stale)).toBe(false)
+    expect(existsSync(join(tmpDir, 'index.ts'))).toBe(true)
+    expect(existsSync(join(tmpDir, 'users.ts'))).toBe(true)
+  })
+
+  it('cleanOutDir: false (default) leaves unrelated files in place', async () => {
+    tmpDir = makeTmpDir()
+    const keep = join(tmpDir, 'keep.ts')
+    writeFileSync(keep, '// keep', 'utf-8')
+
+    await generateClient({ envelope, outDir: tmpDir })
+
+    expect(existsSync(keep)).toBe(true)
+    expect(existsSync(join(tmpDir, 'index.ts'))).toBe(true)
+  })
+
+  it('cleanOutDir works when outDir does not exist', async () => {
+    tmpDir = makeTmpDir()
+    const nested = join(tmpDir, 'nested', 'missing')
+    expect(existsSync(nested)).toBe(false)
+
+    await generateClient({ envelope, outDir: nested, cleanOutDir: true })
+
+    expect(existsSync(join(nested, 'index.ts'))).toBe(true)
+  })
+
+  it('cleanOutDir is a no-op in dryRun mode', async () => {
+    tmpDir = makeTmpDir()
+    const keep = join(tmpDir, 'keep.ts')
+    writeFileSync(keep, '// keep', 'utf-8')
+
+    await runPipeline({ envelope, outDir: tmpDir, cleanOutDir: true, dryRun: true })
+
+    expect(existsSync(keep)).toBe(true)
+    expect(existsSync(join(tmpDir, 'index.ts'))).toBe(false)
+  })
+
   it('throws when a scope key collides with _types in selfContained mode', async () => {
     tmpDir = makeTmpDir()
     const collisionEnvelope: DocEnvelope = {

package/src/codegen/pipeline.ts

@@ -1,4 +1,4 @@
-import { mkdir, writeFile } from 'node:fs/promises'
+import { mkdir, rm, writeFile } from 'node:fs/promises'
 import { join } from 'node:path'
 import { createHash } from 'node:crypto'
 import type { DocEnvelope } from '../implementations/types.js'
@@ -20,6 +20,7 @@ export interface PipelineOptions {
   namespaceTypes?: boolean
   selfContained?: boolean
   serviceName?: string
+  cleanOutDir?: boolean
 }
 
 export interface GeneratedFile {
@@ -28,7 +29,7 @@ export interface GeneratedFile {
 }
 
 export async function runPipeline(options: PipelineOptions): Promise<GeneratedFile[]> {
-  const { envelope, outDir, ajsc: ajscOpts, dryRun = false, namespaceTypes = false, selfContained = false } = options
+  const { envelope, outDir, ajsc: ajscOpts, dryRun = false, namespaceTypes = false, selfContained = false, cleanOutDir = false } = options
   const serviceName = options.serviceName ?? 'Api'
   validateServiceName(serviceName)
   const clientImportPath = selfContained ? './_types' : options.clientImportPath
@@ -92,11 +93,17 @@ export async function runPipeline(options: PipelineOptions): Promise<GeneratedFi
   }
 
   if (dryRun) {
+    if (cleanOutDir) {
+      console.log(`[dry-run] Would clean outDir: ${outDir}`)
+    }
     for (const file of files) {
       const bytes = Buffer.byteLength(file.code, 'utf-8')
       console.log(`[dry-run] Would write: ${file.path} (${bytes} bytes)`)
     }
   } else {
+    if (cleanOutDir) {
+      await rm(outDir, { recursive: true, force: true })
+    }
     await mkdir(outDir, { recursive: true })
     for (const file of files) {
       await writeFile(file.path, file.code, 'utf-8')

package/src/implementations/http/README.md

@@ -298,6 +298,8 @@ apiBuilder.register(factory, (c) => ctx, {
 
 **Self-contained mode:** Use `--self-contained` to emit `_types.ts` (all client type definitions) and `_client.ts` (runtime: `createClient`, `createFetchAdapter`, hooks, errors) into the output directory. All scope files and `index.ts` will import from `./_types` instead of `ts-procedures/client`, so consumers have no runtime dependency on `ts-procedures`. With this flag, `ts-procedures` can be a devDependency only.
 
+**Clean output directory:** Use `--clean-out-dir` (or `cleanOutDir: true` in the programmatic API) to recursively remove the output directory before writing, so scope files left over from deleted or renamed scopes are pruned. Skipped under `--dry-run`.
+
 ## Framework Comparison
 
 | Aspect | Express | Hono |
@@ -317,7 +319,15 @@ import type { APIConfig, APIHttpRouteDoc, APIInput, HttpMethod } from 'ts-proced
 
 // Client Runtime
 import { createClient, createFetchAdapter } from 'ts-procedures/client'
-import type { ClientAdapter, ClientHooks, TypedStream, ClientInstance } from 'ts-procedures/client'
+import type {
+  ClientAdapter,
+  ClientHooks,
+  TypedStream,
+  ClientInstance,
+  ProcedureCallDefaults,
+  ProcedureCallOptions,
+  RequestMeta,
+} from 'ts-procedures/client'
 
 // Code Generation (build-time only)
 import { generateClient } from 'ts-procedures/codegen'

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

@@ -1,14 +0,0 @@
-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

@@ -1,47 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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.js

@@ -1,124 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,25 +0,0 @@
-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

@@ -1,33 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

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