@contractkit/plugin-typescript 0.28.2 → 0.29.0

package/.turbo/turbo-build$colon$ci.log

@@ -5,9 +5,9 @@ $ tsup src/index.ts --format esm --sourcemap --dts && tsc --emitDeclarationOnly
 CLI tsup v8.5.1
 CLI Target: esnext
 ESM Build start
-ESM dist/index.js     176.01 KB
-ESM dist/index.js.map 388.17 KB
-ESM ⚡️ Build success in 473ms
+ESM dist/index.js     178.19 KB
+ESM dist/index.js.map 395.78 KB
+ESM ⚡️ Build success in 396ms
 DTS Build start
-DTS ⚡️ Build success in 5954ms
-DTS dist/index.d.ts 3.71 KB
+DTS ⚡️ Build success in 6065ms
+DTS dist/index.d.ts 4.55 KB

package/.turbo/turbo-test$colon$ci.log

@@ -3,34 +3,34 @@ $ vitest run --coverage
  RUN  v4.1.5 /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
       Coverage enabled with v8
 
- ✓ tests/codegen-contract.test.ts (128 tests) 233ms
- ✓ tests/codegen-operation.test.ts (91 tests) 103ms
- ✓ tests/codegen-sdk.test.ts (140 tests) 276ms
- ✓ tests/codegen-plain-types.test.ts (61 tests) 42ms
- ✓ tests/codegen-server.test.ts (22 tests) 91ms
- ✓ tests/pipeline.test.ts (28 tests) 224ms
- ✓ tests/codegen-mcp.test.ts (24 tests) 98ms
- ✓ tests/escaping-security.test.ts (18 tests) 51ms
+ ✓ tests/codegen-contract.test.ts (128 tests) 221ms
+ ✓ tests/codegen-sdk.test.ts (140 tests) 252ms
+ ✓ tests/codegen-operation.test.ts (113 tests) 255ms
+ ✓ tests/codegen-server.test.ts (25 tests) 110ms
+ ✓ tests/codegen-plain-types.test.ts (66 tests) 35ms
+ ✓ tests/pipeline.test.ts (28 tests) 217ms
+ ✓ tests/escaping-security.test.ts (18 tests) 27ms
+ ✓ tests/codegen-mcp.test.ts (24 tests) 67ms
 
  Test Files  8 passed (8)
-      Tests  512 passed (512)
-   Start at  16:29:52
-   Duration  9.09s (transform 4.13s, setup 0ms, import 16.79s, tests 1.12s, environment 1ms)
+      Tests  542 passed (542)
+   Start at  12:07:42
+   Duration  9.60s (transform 5.83s, setup 0ms, import 18.92s, tests 1.18s, environment 1ms)
 
  % Coverage report from v8
 -------------------|---------|----------|---------|---------|-------------------
 File               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
 -------------------|---------|----------|---------|---------|-------------------
-All files          |   81.49 |    76.01 |   84.56 |   84.05 |                   
- src               |   81.33 |    75.75 |   84.25 |   83.87 |                   
-  ...n-contract.ts |    88.1 |    82.91 |   90.08 |   89.26 | ...1088,1093-1094 
+All files          |   82.66 |    77.13 |   85.59 |   85.15 |                   
+ src               |   82.52 |    76.89 |   85.35 |      85 |                   
+  ...n-contract.ts |    88.1 |    82.91 |   90.08 |   89.26 | ...1095,1100-1101 
   codegen-mcp.ts   |   82.67 |    75.47 |   84.61 |    85.9 | ...85,290-291,374 
-  ...-operation.ts |   78.46 |     74.7 |   78.94 |    79.9 | ...99-710,715-716 
-  ...lain-types.ts |   91.52 |    81.65 |   96.87 |    94.4 | ...23,143,249,255 
+  ...-operation.ts |   80.12 |    77.35 |   79.22 |   81.36 | ...59-770,775-776 
+  ...lain-types.ts |   91.57 |    81.98 |   96.87 |   94.44 | ...31,157,269,275 
   codegen-sdk.ts   |   88.37 |     83.2 |   87.83 |   91.48 | ...1187-1188,1191 
-  index.ts         |   60.04 |    48.95 |   65.45 |   63.82 | ...1002,1018-1037 
-  path-utils.ts    |   69.56 |       50 |     100 |    73.5 | ...65-168,216-231 
-  ts-render.ts     |   84.21 |    86.66 |      75 |   89.23 | 68,141,172-180    
+  index.ts         |   66.25 |    53.64 |   72.72 |   70.29 | ...1022,1038-1057 
+  path-utils.ts    |   70.28 |    51.13 |     100 |    73.5 | ...65-168,216-231 
+  ts-render.ts     |      85 |    87.36 |   79.16 |   89.23 | 83,159,192-200    
  tests             |   90.38 |     90.9 |   89.28 |   93.47 |                   
   helpers.ts       |   90.38 |     90.9 |   89.28 |   93.47 | 110-118           
 -------------------|---------|----------|---------|---------|-------------------

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @contractkit/contractkit-plugin-typescript
 
+## 0.29.0
+
+### Minor Changes
+
+- 79e3049: Fix scalar response bodies in generated Koa routers, which emitted the `.ck` scalar name verbatim as a TypeScript type (`const result: binary`). Only `string`, `number`, `boolean`, `bigint`, `null` and `unknown` compiled by coincidence; `binary`, `int`, `uuid`, `datetime` and friends produced invalid code. Scalars now render as the type the handler actually receives: `binary` → `Buffer`, `int` → `number`, `datetime` → luxon `DateTime`, `interval` → `string`, `json` → `_JsonValue`.
+
+    Generated routers now also import `Duration` and `Interval` from luxon and emit the `_ZodInterval` helper when an operation uses those scalars, instead of referencing undefined names.
+
+    Plain type files emitted for the server render `binary` as `Buffer` rather than `Blob`. SDK output is unchanged. The standalone `types` sub-generator gained a `target` option (`"client" | "server"`, default `"client"`) to select between the two.
+
 ## 0.28.2
 
 ### Patch Changes

package/README.md

@@ -94,6 +94,10 @@ Generates plain TypeScript interface/type files from `contract` declarations. No
 |---|---|---|---|
 | `baseDir` | `string` | `rootDir` | Base directory for output files |
 | `output` | `string` | `"{filename}.types.ts"` | Path template for type files |
+| `target` | `"client" \| "server"` | `"client"` | Runtime the types describe. Affects scalars whose TypeScript type is runtime-specific: `binary` renders as `Buffer` for `server` and `Blob` for `client` |
+
+The `server` and `sdk` sub-generators set `target` themselves (`server` and `client` respectively), so
+their plain-type output already matches the runtime that consumes it.
 
 ## Path templates
 

package/dist/codegen-contract.d.ts

@@ -1,4 +1,5 @@
 import type { ContractRootNode, ModelNode, ContractTypeNode, ObjectMode } from '@contractkit/core';
+import type { TsRenderTarget } from './ts-render.js';
 /**
  * Maps a ContractKit object mode to its Zod constructor name.
  *
@@ -17,6 +18,12 @@ export interface ContractCodegenContext {
     modelsWithOutput?: Set<string>;
     /** If set, import JsonValue from this path instead of re-declaring it (avoids barrel re-export conflicts) */
     jsonValueImportPath?: string;
+    /**
+     * Runtime the emitted plain types describe. Only affects scalars whose TypeScript type differs
+     * per runtime (`binary` → `Buffer` on the server, `Blob` in the client). Ignored by
+     * `generateContract`, whose Zod schemas are server-shaped by construction. Default `'client'`.
+     */
+    target?: TsRenderTarget;
 }
 /**
  * Compute which models need Input variants, including transitive dependencies.

package/dist/codegen-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-contract.d.ts","sourceRoot":"","sources":["../src/codegen-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EAET,gBAAgB,EAWhB,UAAU,EACb,MAAM,mBAAmB,CAAC;AAQ3B;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAStD;AAID,4GAA4G;AAC5G,MAAM,WAAW,sBAAsB;IACnC,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,uBAAuB,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAsCzH;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAkEjG;AAgVD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CA6B5H;AAkOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAuDvH;AA2BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAsCvH;AA0CD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuB7E;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAiBjE;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAcpE;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CA4BvG;AAmCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CA6D/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAgB3F;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}
+{"version":3,"file":"codegen-contract.d.ts","sourceRoot":"","sources":["../src/codegen-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EAET,gBAAgB,EAWhB,UAAU,EACb,MAAM,mBAAmB,CAAC;AAO3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAStD;AAID,4GAA4G;AAC5G,MAAM,WAAW,sBAAsB;IACnC,sDAAsD;IACtD,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,8DAA8D;IAC9D,cAAc,EAAE,MAAM,CAAC;IACvB,qFAAqF;IACrF,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,6GAA6G;IAC7G,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CAC3B;AAID;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,uBAAuB,GAAE,GAAG,CAAC,MAAM,CAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAsCzH;AAkBD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAkEjG;AAgVD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CA6B5H;AAkOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAuDvH;AA2BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAsCvH;AA0CD,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAuB7E;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7E;AAED,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAiBjE;AAED,mGAAmG;AACnG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAcpE;AAED,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,EAAE,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CA4BvG;AAmCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CA6D/D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAgB3F;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/dist/codegen-operation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-operation.d.ts","sourceRoot":"","sources":["../src/codegen-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAA2B,MAAM,mBAAmB,CAAC;AAmC7H;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAkE5F;AAID,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,qFAAqF;IACrF,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,yHAAyH;AACzH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CA4EnF;AAsKD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAY7H;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,CAqBzE;AAmXD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/E"}
+{"version":3,"file":"codegen-operation.d.ts","sourceRoot":"","sources":["../src/codegen-operation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,gBAAgB,EAA2C,MAAM,mBAAmB,CAAC;AAmC7I;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAkE5F;AAID,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC7B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sFAAsF;IACtF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,qFAAqF;IACrF,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,yHAAyH;AACzH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAuFnF;AAyKD;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAY7H;AAoBD;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,eAAe,GAAG,MAAM,CAqBzE;AAiaD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/E"}

package/dist/codegen-plain-types.d.ts

@@ -5,6 +5,9 @@ import type { ContractCodegenContext } from './codegen-contract.js';
  * Unlike `generateContract()` which produces Zod schemas, this emits
  * vanilla TypeScript `interface` and `type` declarations suitable
  * for SDK consumers that don't need runtime validation.
+ *
+ * @param context Import resolution and Input/Output variant sets. `context.target` selects the
+ * runtime the types describe (`'server'` renders `binary` as `Buffer`, `'client'` as `Blob`).
  */
 export declare function generatePlainTypes(root: ContractRootNode, context?: ContractCodegenContext): string;
 //# sourceMappingURL=codegen-plain-types.d.ts.map

package/dist/codegen-plain-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codegen-plain-types.d.ts","sourceRoot":"","sources":["../src/codegen-plain-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAapE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CA2CnG"}
+{"version":3,"file":"codegen-plain-types.d.ts","sourceRoot":"","sources":["../src/codegen-plain-types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAcpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CA4CnG"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import type { ContractKitPlugin } from '@contractkit/core';
+/** Koa server output: routers, and the type or Zod schema files they import. */
 export interface ServerConfig {
     /** Directory (relative to rootDir) where server files are written. Default: rootDir. */
     baseDir?: string;
@@ -15,6 +16,7 @@ export interface ServerConfig {
     /** Whether to emit handlers for `internal` operations. Default true. */
     includeInternal?: boolean;
 }
+/** TypeScript SDK client output: the client class, per-area operation clients, and their types. */
 export interface SdkConfig {
     baseDir?: string;
     name?: string;
@@ -35,14 +37,23 @@ export interface SdkConfig {
      */
     scaffold?: boolean;
 }
+/** Standalone Zod schema output, independent of the server and SDK sub-generators. */
 export interface ZodConfig {
     baseDir?: string;
     output?: string;
 }
+/** Standalone plain TypeScript type output, independent of the server and SDK sub-generators. */
 export interface TypesConfig {
     baseDir?: string;
     output?: string;
+    /**
+     * Runtime the emitted types describe. Affects scalars whose TypeScript type is runtime-specific:
+     * `binary` renders as `Buffer` for `'server'` and `Blob` for `'client'`. Default `'client'`.
+     * The `server` and `sdk` sub-generators set this themselves.
+     */
+    target?: 'client' | 'server';
 }
+/** MCP tool output: per-op-file handlers, the aggregator, and the optional POST route. */
 export interface McpConfig {
     /** Directory (relative to rootDir) where MCP files are written. Default: rootDir. */
     baseDir?: string;
@@ -69,6 +80,7 @@ export interface McpConfig {
     /** Whether to expose operations marked `internal` as MCP tools. Default false. */
     includeInternal?: boolean;
 }
+/** Top-level plugin config. Each sub-config that is present enables its sub-generator. */
 export interface TypescriptPluginConfig {
     server?: ServerConfig;
     sdk?: SdkConfig;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,iBAAiB,EAQpB,MAAM,mBAAmB,CAAC;AA8C3B,MAAM,WAAW,YAAY;IACzB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6HAA6H;IAC7H,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,8EAA8E;QAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,+EAA+E;QAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACL,oHAAoH;QACpH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,0GAA0G;QAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,yFAAyF;QACzF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,SAAS,CAAC;CACnB;AAID,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAO9C,QAAA,MAAM,MAAM,EAAE,iBAMb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,2GAA2G;AAC3G,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAOzG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,iBAAiB,EAQpB,MAAM,mBAAmB,CAAC;AA8C3B,gFAAgF;AAChF,MAAM,WAAW,YAAY;IACzB,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6HAA6H;IAC7H,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,8EAA8E;QAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,+EAA+E;QAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,wDAAwD;IACxD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,mGAAmG;AACnG,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE;QACL,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,sFAAsF;AACtF,MAAM,WAAW,SAAS;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iGAAiG;AACjG,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAChC;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAS;IACtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE;QACL,oHAAoH;QACpH,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,0GAA0G;QAC1G,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,yFAAyF;QACzF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kFAAkF;IAClF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,0FAA0F;AAC1F,MAAM,WAAW,sBAAsB;IACnC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,SAAS,CAAC;CACnB;AAID,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAO9C,QAAA,MAAM,MAAM,EAAE,iBAMb,CAAC;AAEF,eAAe,MAAM,CAAC;AAEtB,2GAA2G;AAC3G,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,GAAG,iBAAiB,CAOzG"}

package/dist/index.js

@@ -31,41 +31,41 @@ function headerNameToProperty(name) {
   }).join("");
 }
 __name(headerNameToProperty, "headerNameToProperty");
-function renderTsType(type) {
+function renderTsType(type, target = "client") {
   switch (type.kind) {
     case "scalar":
-      return renderTsScalar(type.name);
+      return renderTsScalar(type.name, target);
     case "array": {
-      const inner = renderTsType(type.item);
+      const inner = renderTsType(type.item, target);
       const needsParens = type.item.kind === "union" || type.item.kind === "discriminatedUnion" || type.item.kind === "intersection" || type.item.kind === "enum";
       return needsParens ? `(${inner})[]` : `${inner}[]`;
     }
     case "tuple":
-      return `[${type.items.map(renderTsType).join(", ")}]`;
+      return `[${type.items.map((i) => renderTsType(i, target)).join(", ")}]`;
     case "record":
-      return `Record<${renderTsType(type.key)}, ${renderTsType(type.value)}>`;
+      return `Record<${renderTsType(type.key, target)}, ${renderTsType(type.value, target)}>`;
     case "enum":
       return type.values.map((v) => `'${escapeSingleQuoted(v)}'`).join(" | ");
     case "literal":
       return typeof type.value === "string" ? `'${escapeSingleQuoted(type.value)}'` : String(type.value);
     case "union":
-      return type.members.map(renderTsType).join(" | ");
+      return type.members.map((m) => renderTsType(m, target)).join(" | ");
     case "discriminatedUnion":
-      return type.members.map(renderTsType).join(" | ");
+      return type.members.map((m) => renderTsType(m, target)).join(" | ");
     case "intersection":
-      return type.members.map(renderTsType).join(" & ");
+      return type.members.map((m) => renderTsType(m, target)).join(" & ");
     case "ref":
       return type.name;
     case "lazy":
-      return renderTsType(type.inner);
+      return renderTsType(type.inner, target);
     case "inlineObject":
-      return renderTsInlineObject(type.fields);
+      return renderTsInlineObject(type.fields, target);
     default:
       return "unknown";
   }
 }
 __name(renderTsType, "renderTsType");
-function renderTsScalar(name) {
+function renderTsScalar(name, target) {
   switch (name) {
     case "string":
     case "email":
@@ -92,7 +92,7 @@ function renderTsScalar(name) {
     case "object":
       return "Record<string, unknown>";
     case "binary":
-      return "Blob";
+      return target === "server" ? "Buffer" : "Blob";
     case "json":
       return "JsonValue";
     default: {
@@ -102,61 +102,61 @@ function renderTsScalar(name) {
   }
 }
 __name(renderTsScalar, "renderTsScalar");
-function renderTsInlineObject(fields) {
+function renderTsInlineObject(fields, target) {
   const entries = fields.map((f) => {
     const opt = f.optional ? "?" : "";
-    return `${quoteKey(f.name)}${opt}: ${renderTsType(f.type)}`;
+    return `${quoteKey(f.name)}${opt}: ${renderTsType(f.type, target)}`;
   });
   return `{ ${entries.join("; ")} }`;
 }
 __name(renderTsInlineObject, "renderTsInlineObject");
-function renderInputTsType(type, modelsWithInput) {
-  if (!modelsWithInput || modelsWithInput.size === 0) return renderTsType(type);
+function renderInputTsType(type, modelsWithInput, target = "client") {
+  if (!modelsWithInput || modelsWithInput.size === 0) return renderTsType(type, target);
   switch (type.kind) {
     case "ref":
       return modelsWithInput.has(type.name) ? `${type.name}Input` : type.name;
     case "array": {
-      const inner = renderInputTsType(type.item, modelsWithInput);
+      const inner = renderInputTsType(type.item, modelsWithInput, target);
       const needsParens = type.item.kind === "union" || type.item.kind === "discriminatedUnion" || type.item.kind === "intersection" || type.item.kind === "enum";
       return needsParens ? `(${inner})[]` : `${inner}[]`;
     }
     case "intersection":
-      return type.members.map((m) => renderInputTsType(m, modelsWithInput)).join(" & ");
+      return type.members.map((m) => renderInputTsType(m, modelsWithInput, target)).join(" & ");
     case "union":
-      return type.members.map((m) => renderInputTsType(m, modelsWithInput)).join(" | ");
+      return type.members.map((m) => renderInputTsType(m, modelsWithInput, target)).join(" | ");
     case "discriminatedUnion":
-      return type.members.map((m) => renderInputTsType(m, modelsWithInput)).join(" | ");
+      return type.members.map((m) => renderInputTsType(m, modelsWithInput, target)).join(" | ");
     case "inlineObject":
-      return `{ ${type.fields.map((f) => `${quoteKey(f.name)}${f.optional ? "?" : ""}: ${renderInputTsType(f.type, modelsWithInput)}`).join("; ")} }`;
+      return `{ ${type.fields.map((f) => `${quoteKey(f.name)}${f.optional ? "?" : ""}: ${renderInputTsType(f.type, modelsWithInput, target)}`).join("; ")} }`;
     case "lazy":
-      return renderInputTsType(type.inner, modelsWithInput);
+      return renderInputTsType(type.inner, modelsWithInput, target);
     default:
-      return renderTsType(type);
+      return renderTsType(type, target);
   }
 }
 __name(renderInputTsType, "renderInputTsType");
-function renderOutputTsType(type, modelsWithOutput) {
-  if (!modelsWithOutput || modelsWithOutput.size === 0) return renderTsType(type);
+function renderOutputTsType(type, modelsWithOutput, target = "client") {
+  if (!modelsWithOutput || modelsWithOutput.size === 0) return renderTsType(type, target);
   switch (type.kind) {
     case "ref":
       return modelsWithOutput.has(type.name) ? `${type.name}Output` : type.name;
     case "array": {
-      const inner = renderOutputTsType(type.item, modelsWithOutput);
+      const inner = renderOutputTsType(type.item, modelsWithOutput, target);
       const needsParens = type.item.kind === "union" || type.item.kind === "discriminatedUnion" || type.item.kind === "intersection" || type.item.kind === "enum";
       return needsParens ? `(${inner})[]` : `${inner}[]`;
     }
     case "intersection":
-      return type.members.map((m) => renderOutputTsType(m, modelsWithOutput)).join(" & ");
+      return type.members.map((m) => renderOutputTsType(m, modelsWithOutput, target)).join(" & ");
     case "union":
-      return type.members.map((m) => renderOutputTsType(m, modelsWithOutput)).join(" | ");
+      return type.members.map((m) => renderOutputTsType(m, modelsWithOutput, target)).join(" | ");
     case "discriminatedUnion":
-      return type.members.map((m) => renderOutputTsType(m, modelsWithOutput)).join(" | ");
+      return type.members.map((m) => renderOutputTsType(m, modelsWithOutput, target)).join(" | ");
     case "inlineObject":
-      return `{ ${type.fields.map((f) => `${quoteKey(f.name)}${f.optional ? "?" : ""}: ${renderOutputTsType(f.type, modelsWithOutput)}`).join("; ")} }`;
+      return `{ ${type.fields.map((f) => `${quoteKey(f.name)}${f.optional ? "?" : ""}: ${renderOutputTsType(f.type, modelsWithOutput, target)}`).join("; ")} }`;
     case "lazy":
-      return renderOutputTsType(type.inner, modelsWithOutput);
+      return renderOutputTsType(type.inner, modelsWithOutput, target);
     default:
-      return renderTsType(type);
+      return renderTsType(type, target);
   }
 }
 __name(renderOutputTsType, "renderOutputTsType");
@@ -1200,8 +1200,12 @@ function generateOp(root, options = {}) {
   if (types.length > 0) {
     body.push(...generateTypeImports(types, root.file, options));
   }
-  if (opNeedsDateTime(root)) {
-    body.push(`import { DateTime } from 'luxon';`);
+  const luxonImports = [];
+  if (opNeedsDateTime(root)) luxonImports.push("DateTime");
+  if (opNeedsScalar(root, "duration")) luxonImports.push("Duration");
+  if (opNeedsScalar(root, "interval")) luxonImports.push("Interval");
+  if (luxonImports.length > 0) {
+    body.push(`import { ${luxonImports.join(", ")} } from 'luxon';`);
   }
   if (needsParseAndValidate) {
     body.push(`import { parseAndValidate } from '@maroonedsoftware/zod';`);
@@ -1216,6 +1220,9 @@ function generateOp(root, options = {}) {
   if (opNeedsScalar(root, "datetime")) {
     helpers.push(`const _ZodDatetime = z.preprocess((val) => typeof val === 'string' ? DateTime.fromISO(val) : val, z.custom<DateTime>((val) => val instanceof DateTime && val.isValid, { message: 'Must be in ISO 8601 format' }));`);
   }
+  if (opNeedsScalar(root, "interval")) {
+    helpers.push(`const _ZodInterval = z.preprocess((val) => typeof val === 'string' ? Interval.fromISO(val) : val, z.custom<Interval>((val) => val instanceof Interval && val.isValid, { message: 'Must be an ISO 8601 interval' })).transform(val => val.toISO()!);`);
+  }
   if (opNeedsScalar(root, "json")) {
     helpers.push(`type _JsonValue = string | number | boolean | null | _JsonValue[] | { [key: string]: _JsonValue };`);
     helpers.push(`const _ZodJson: z.ZodType<_JsonValue> = z.lazy(() => z.union([z.string(), z.number(), z.boolean(), z.null(), z.array(_ZodJson), z.record(z.string(), _ZodJson)]));`);
@@ -1325,7 +1332,7 @@ function generateHandler(route, op, root, options) {
   const serviceParts = inferService(op, route, file);
   const respHeaders = primaryResponse2?.headers ?? [];
   const hasRespHeaders = respHeaders.length > 0;
-  const headersAnnotation = hasRespHeaders ? `{ ${respHeaders.map((h) => `${quoteKey(headerNameToProperty(h.name))}${h.optional ? "?" : ""}: ${renderOutputTsType(h.type, options.modelsWithOutput)}`).join("; ")} }` : "";
+  const headersAnnotation = hasRespHeaders ? `{ ${respHeaders.map((h) => `${quoteKey(headerNameToProperty(h.name))}${h.optional ? "?" : ""}: ${renderOutputTsType(h.type, options.modelsWithOutput, "server")}`).join("; ")} }` : "";
   if (primaryResponse2?.bodyType) {
     const { annotation, prelude } = formatTypeAnnotation(primaryResponse2.bodyType, options.modelsWithOutput);
     if (prelude) {
@@ -1419,6 +1426,45 @@ function buildArgs(route, op) {
   return args.join(", ");
 }
 __name(buildArgs, "buildArgs");
+function serverTsScalar(name) {
+  switch (name) {
+    case "string":
+    case "email":
+    case "url":
+    case "uuid":
+      return "string";
+    case "number":
+    case "int":
+      return "number";
+    case "bigint":
+      return "bigint";
+    case "boolean":
+      return "boolean";
+    case "date":
+    case "time":
+    case "datetime":
+      return "DateTime";
+    case "duration":
+      return "Duration";
+    case "interval":
+      return "string";
+    case "binary":
+      return "Buffer";
+    case "json":
+      return "_JsonValue";
+    case "object":
+      return "Record<string, unknown>";
+    case "null":
+      return "null";
+    case "unknown":
+      return "unknown";
+    default: {
+      const _exhaustive = name;
+      throw new Error(`plugin-typescript: unmapped scalar '${String(_exhaustive)}' \u2014 add a case`);
+    }
+  }
+}
+__name(serverTsScalar, "serverTsScalar");
 function formatTypeAnnotation(bodyType, modelsWithOutput) {
   if (bodyType.kind === "array") {
     const inner = formatTypeAnnotation(bodyType.item, modelsWithOutput);
@@ -1434,7 +1480,7 @@ function formatTypeAnnotation(bodyType, modelsWithOutput) {
     };
   }
   if (bodyType.kind === "scalar") return {
-    annotation: bodyType.name
+    annotation: serverTsScalar(bodyType.name)
   };
   const schema = renderType(bodyType);
   return {
@@ -2807,6 +2853,7 @@ __name(generateSdkAggregator, "generateSdkAggregator");
 import { relative as relative4, dirname as dirname4 } from "path";
 import { computeModelsWithOutput, collectExternalOutputRefs } from "@contractkit/core";
 function generatePlainTypes(root, context) {
+  const target = context?.target ?? "client";
   const externalRefs = collectExternalRefs(root);
   const lines = [];
   const externalModelsWithInput = context?.modelsWithInput ?? /* @__PURE__ */ new Set();
@@ -2848,21 +2895,21 @@ function generatePlainTypes(root, context) {
     m
   ]));
   for (const model of topoSortModels(root.models)) {
-    lines.push(...generateModel2(model, context?.currentOutPath, allModelsWithInput, allModelsWithOutput, modelMap));
+    lines.push(...generateModel2(model, target, context?.currentOutPath, allModelsWithInput, allModelsWithOutput, modelMap));
     lines.push("");
   }
   return lines.join("\n");
 }
 __name(generatePlainTypes, "generatePlainTypes");
-function generateModel2(model, outPath, modelsWithInput, modelsWithOutput, modelMap) {
+function generateModel2(model, target, outPath, modelsWithInput, modelsWithOutput, modelMap) {
   if (model.type) {
-    return generateTypeAlias2(model, outPath, modelsWithInput, modelsWithOutput);
+    return generateTypeAlias2(model, target, outPath, modelsWithInput, modelsWithOutput);
   }
   const needsInputSplit = model.fields.some((f) => f.visibility !== "normal") || (modelsWithInput?.has(model.name) ?? false);
-  const lines = needsInputSplit ? generateVisibilityModel(model, outPath, modelsWithInput, modelMap) : generateSimpleModel2(model, outPath, modelMap);
+  const lines = needsInputSplit ? generateVisibilityModel(model, target, outPath, modelsWithInput, modelMap) : generateSimpleModel2(model, target, outPath, modelMap);
   if (modelsWithOutput?.has(model.name)) {
     lines.push("");
-    lines.push(...generateOutputModel(model, modelsWithOutput));
+    lines.push(...generateOutputModel(model, target, modelsWithOutput));
   }
   return lines;
 }
@@ -2899,15 +2946,15 @@ function generateComments2(model, outPath) {
   return lines;
 }
 __name(generateComments2, "generateComments");
-function generateTypeAlias2(model, outPath, modelsWithInput, modelsWithOutput) {
+function generateTypeAlias2(model, target, outPath, modelsWithInput, modelsWithOutput) {
   const lines = [];
   lines.push(...generateComments2(model, outPath));
-  lines.push(`export type ${model.name} = ${renderTsType(model.type)};`);
+  lines.push(`export type ${model.name} = ${renderTsType(model.type, target)};`);
   if (modelsWithInput?.has(model.name)) {
-    lines.push(`export type ${model.name}Input = ${renderInputTsType(model.type, modelsWithInput)};`);
+    lines.push(`export type ${model.name}Input = ${renderInputTsType(model.type, modelsWithInput, target)};`);
   }
   if (modelsWithOutput?.has(model.name)) {
-    lines.push(`export type ${model.name}Output = ${renderOutputTsType(model.type, modelsWithOutput)};`);
+    lines.push(`export type ${model.name}Output = ${renderOutputTsType(model.type, modelsWithOutput, target)};`);
   }
   return lines;
 }
@@ -2920,20 +2967,20 @@ function buildExtendsClause(bases, overrideNames, baseNameResolver) {
   return ` extends ${wrapped.join(", ")}`;
 }
 __name(buildExtendsClause, "buildExtendsClause");
-function generateSimpleModel2(model, outPath, modelMap) {
+function generateSimpleModel2(model, target, outPath, modelMap) {
   const lines = [];
   lines.push(...generateComments2(model, outPath));
   const bases = model.bases ?? [];
   const overrideNames = computeOverrideNames(model, modelMap);
   lines.push(`export interface ${model.name}${buildExtendsClause(bases, overrideNames, (b) => b)} {`);
   for (const field of model.fields) {
-    lines.push(`    ${renderField2(field)}`);
+    lines.push(`    ${renderField2(field, target)}`);
   }
   lines.push("}");
   return lines;
 }
 __name(generateSimpleModel2, "generateSimpleModel");
-function generateVisibilityModel(model, outPath, modelsWithInput, modelMap) {
+function generateVisibilityModel(model, target, outPath, modelsWithInput, modelMap) {
   const lines = [];
   lines.push(...generateComments2(model, outPath));
   const bases = model.bases ?? [];
@@ -2941,7 +2988,7 @@ function generateVisibilityModel(model, outPath, modelsWithInput, modelMap) {
   const readFields = model.fields.filter((f) => f.visibility !== "writeonly");
   lines.push(`export interface ${model.name}${buildExtendsClause(bases, overrideNames, (b) => b)} {`);
   for (const field of readFields) {
-    lines.push(`    ${renderField2(field)}`);
+    lines.push(`    ${renderField2(field, target)}`);
   }
   lines.push("}");
   lines.push("");
@@ -2949,7 +2996,7 @@ function generateVisibilityModel(model, outPath, modelsWithInput, modelMap) {
   const inputResolver = /* @__PURE__ */ __name((b) => modelsWithInput?.has(b) ? `${b}Input` : b, "inputResolver");
   lines.push(`export interface ${model.name}Input${buildExtendsClause(bases, overrideNames, inputResolver)} {`);
   for (const field of writeFields) {
-    lines.push(`    ${modelsWithInput ? renderInputField2(field, modelsWithInput) : renderField2(field)}`);
+    lines.push(`    ${modelsWithInput ? renderInputField2(field, modelsWithInput, target) : renderField2(field, target)}`);
   }
   lines.push("}");
   return lines;
@@ -2969,9 +3016,9 @@ ${body}
     ${line}`;
 }
 __name(withFieldJsDoc, "withFieldJsDoc");
-function renderField2(field) {
+function renderField2(field, target) {
   const opt = field.optional || field.default !== void 0 ? "?" : "";
-  let typeStr = renderTsType(field.type);
+  let typeStr = renderTsType(field.type, target);
   if (field.nullable) typeStr += " | null";
   const line = `${quoteKey(field.name)}${opt}: ${typeStr};`;
   const jsdocParts = [];
@@ -2980,9 +3027,9 @@ function renderField2(field) {
   return withFieldJsDoc(jsdocParts, line);
 }
 __name(renderField2, "renderField");
-function renderInputField2(field, modelsWithInput) {
+function renderInputField2(field, modelsWithInput, target) {
   const opt = field.optional || field.default !== void 0 ? "?" : "";
-  let typeStr = renderInputTsType(field.type, modelsWithInput);
+  let typeStr = renderInputTsType(field.type, modelsWithInput, target);
   if (field.nullable) typeStr += " | null";
   const line = `${quoteKey(field.name)}${opt}: ${typeStr};`;
   const jsdocParts = [];
@@ -3005,7 +3052,7 @@ function applyOutputCase(name, c) {
   return camelToPascal2(name);
 }
 __name(applyOutputCase, "applyOutputCase");
-function generateOutputModel(model, modelsWithOutput) {
+function generateOutputModel(model, target, modelsWithOutput) {
   const lines = [];
   const outputCase = model.outputCase && model.outputCase !== "camel" ? model.outputCase : void 0;
   const readFields = model.fields.filter((f) => f.visibility !== "writeonly");
@@ -3013,23 +3060,23 @@ function generateOutputModel(model, modelsWithOutput) {
     const baseExt = model.bases?.[0] && modelsWithOutput.has(model.bases?.[0]) ? ` extends ${model.bases?.[0]}Output` : model.bases?.[0] ? ` extends ${model.bases?.[0]}` : "";
     lines.push(`export interface ${model.name}Output${baseExt} {`);
     for (const field of readFields) {
-      lines.push(`    ${renderOutputField(field, model.outputCase, modelsWithOutput)}`);
+      lines.push(`    ${renderOutputField(field, model.outputCase, modelsWithOutput, target)}`);
     }
     lines.push("}");
     return lines;
   }
   lines.push(`export interface ${model.name}Output {`);
   for (const field of readFields) {
-    lines.push(`    ${renderOutputField(field, outputCase, modelsWithOutput)}`);
+    lines.push(`    ${renderOutputField(field, outputCase, modelsWithOutput, target)}`);
   }
   lines.push("}");
   return lines;
 }
 __name(generateOutputModel, "generateOutputModel");
-function renderOutputField(field, outputCase, modelsWithOutput) {
+function renderOutputField(field, outputCase, modelsWithOutput, target) {
   const opt = field.optional || field.default !== void 0 ? "?" : "";
   const key = applyOutputCase(field.name, outputCase);
-  let typeStr = renderOutputTsType(field.type, modelsWithOutput);
+  let typeStr = renderOutputTsType(field.type, modelsWithOutput, target);
   if (field.nullable) typeStr += " | null";
   const line = `${quoteKey(key)}${opt}: ${typeStr};`;
   const jsdocParts = [];
@@ -3856,7 +3903,9 @@ function collectServerOutput(config, rootDir, inputs, units) {
           modelOutPaths: serverModelOutPaths,
           currentOutPath: typeOutPath,
           modelsWithInput,
-          modelsWithOutput
+          modelsWithOutput,
+          // These types are consumed by Koa handlers, so `binary` is a Buffer, not a Blob.
+          target: "server"
         };
         const content = config.zod ? generateContract(ast, renderCtx) : generatePlainTypes(ast, renderCtx);
         return [
@@ -4368,7 +4417,8 @@ function collectTypesOutput(config, rootDir, inputs, units) {
             modelOutPaths,
             currentOutPath: outPath,
             modelsWithInput,
-            modelsWithOutput
+            modelsWithOutput,
+            target: config.target
           })
         }
       ], "render")