@contractkit/plugin-typescript 0.28.1 → 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     154.70 KB
-ESM dist/index.js.map 339.99 KB
-ESM ⚡️ Build success in 416ms
+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 6768ms
-DTS dist/index.d.ts 2.35 KB
+DTS ⚡️ Build success in 6065ms
+DTS dist/index.d.ts 4.55 KB

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

@@ -3,32 +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) 235ms
- ✓ tests/codegen-operation.test.ts (89 tests) 196ms
- ✓ tests/codegen-sdk.test.ts (140 tests) 329ms
- ✓ tests/codegen-plain-types.test.ts (61 tests) 40ms
- ✓ tests/pipeline.test.ts (25 tests) 222ms
- ✓ tests/codegen-server.test.ts (22 tests) 62ms
- ✓ tests/escaping-security.test.ts (18 tests) 28ms
+ ✓ 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  7 passed (7)
-      Tests  483 passed (483)
-   Start at  17:06:40
-   Duration  9.04s (transform 4.19s, setup 0ms, import 16.95s, tests 1.11s, environment 1ms)
+ Test Files  8 passed (8)
+      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          |   83.19 |    77.74 |   85.99 |   85.77 |                   
- src               |   83.04 |    77.47 |   85.75 |    85.6 |                   
-  ...n-contract.ts |    88.1 |    82.91 |   90.08 |   89.26 | ...1088,1093-1094 
-  ...-operation.ts |   78.46 |     74.7 |   78.94 |    79.9 | ...80-691,696-697 
-  ...lain-types.ts |   91.52 |    81.65 |   96.87 |    94.4 | ...23,143,249,255 
+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 |   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         |   70.05 |    60.38 |      75 |   74.74 | ...45-848,864-883 
-  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,21 @@
 # @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
+
+- ca9309a: Generated Koa route handlers now use `async ctx => {` instead of `async (ctx, next) => {`. The `next` argument was never referenced in the emitted body and tripped no-unused-vars lint rules in consuming projects.
+
 ## 0.28.1
 
 ### 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-mcp.d.ts

@@ -0,0 +1,38 @@
+import type { OpRootNode } from '@contractkit/core';
+export interface McpCodegenOptions {
+    /** Absolute path of the file being generated. Used to compute relative imports. */
+    outPath?: string;
+    /** Map from schema identifier (model name / `${name}Input`) → absolute output file. */
+    modelOutPaths?: Map<string, string>;
+    /** Model names that have an Input variant schema. */
+    modelsWithInput?: Set<string>;
+    /** Model names that have an Output variant schema. */
+    modelsWithOutput?: Set<string>;
+    /** Import-path template for service implementations (same semantics as ServerConfig). */
+    servicePathTemplate?: string;
+    /** Emit tools for `internal` operations. Default false. */
+    includeInternal?: boolean;
+}
+/**
+ * True if the root has at least one MCP-exposed operation. With `includeInternal: false`
+ * (default) `internal` operations don't count. Mirrors `hasPublicOperations`.
+ */
+export declare function hasMcpOperations(root: OpRootNode, includeInternal?: boolean): boolean;
+/** The exported register-fn name for an op-root file, e.g. `payments.op` → `registerPaymentsMcpTools`. */
+export declare function deriveMcpRegisterFnName(file: string): string;
+/** Generate one `<filename>.mcp.ts` for an op-root: tool handler classes + a per-file register fn. */
+export declare function generateMcpFile(root: OpRootNode, options?: McpCodegenOptions): string;
+/** One entry per emitted `<filename>.mcp.ts` for the aggregator to import. */
+export interface McpAggregatorEntry {
+    /** The file's exported register fn name, e.g. `registerPaymentsMcpTools`. */
+    registerFn: string;
+    /** Module specifier for the file, relative to the aggregator and `.js`-suffixed. */
+    importPath: string;
+}
+/** Generate the aggregator `mcp.tools.ts` that assembles the single McpToolHandlerMap. */
+export declare function generateMcpAggregator(entries: McpAggregatorEntry[]): string;
+/** Generate the optional `mcp.router.ts` — the standard ServerKit route wiring for the dispatcher. */
+export declare function generateMcpRouter(options?: {
+    path?: string;
+}): string;
+//# sourceMappingURL=codegen-mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"codegen-mcp.d.ts","sourceRoot":"","sources":["../src/codegen-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA8E,MAAM,mBAAmB,CAAC;AAShI,MAAM,WAAW,iBAAiB;IAC9B,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,qDAAqD;IACrD,eAAe,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC9B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,yFAAyF;IACzF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;CAC7B;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,eAAe,UAAQ,GAAG,OAAO,CASnF;AAoVD,0GAA0G;AAC1G,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,sGAAsG;AACtG,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CA0DzF;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IAC/B,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAe3E;AAED,sGAAsG;AACtG,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,CAuBzE"}

package/dist/codegen-operation.d.ts

@@ -1,9 +1,10 @@
-import type { OpRootNode, ContractTypeNode } from '@contractkit/core';
+import type { OpRootNode, OpRouteNode, OpOperationNode, ContractTypeNode } from '@contractkit/core';
 /**
  * Deep structural equality on ContractTypeNode, ignoring source locations on inline fields.
  * Used to decide whether multiple declared request MIMEs can share a single validate path.
  */
 export declare function bodyTypesStructurallyEqual(a: ContractTypeNode, b: ContractTypeNode): boolean;
+/** Options controlling how {@link generateOp} renders a Koa router module. */
 export interface OpCodegenOptions {
     servicePathTemplate?: string;
     typeImportPathTemplate?: string;
@@ -23,4 +24,44 @@ export interface OpCodegenOptions {
 }
 /** Generate a Koa router module for every operation in `root`, including the imports, type aliases, and handler list. */
 export declare function generateOp(root: OpRootNode, options?: OpCodegenOptions): string;
+/**
+ * Resolve the service class and method a handler should delegate to.
+ *
+ * Uses the operation's explicit `service: Class.method` declaration when present; otherwise derives
+ * the class from the contract file name (`ledger.categories.ck` → `LedgerCategoriesService`) and the
+ * method from the HTTP verb and whether the path carries a parameter (`get` → `list` / `getById`).
+ *
+ * @param file Path of the `.ck` file the operation came from.
+ */
+export declare function inferService(op: OpOperationNode, route: OpRouteNode, file: string): {
+    className: string;
+    methodName: string;
+};
+/**
+ * Build the comma-separated argument list passed to the service method in a generated handler.
+ *
+ * Order is params, body, query, headers. Inline path params are spread as individual identifiers;
+ * a referenced/compound params type is passed as a single `params` object. A lone
+ * `multipart/form-data` request body is passed as `multipartBody` rather than `body`.
+ *
+ * @returns The rendered argument list, or an empty string when the method takes no arguments.
+ */
+export declare function buildArgs(route: OpRouteNode, op: OpOperationNode): string;
+/**
+ * Derive the PascalCase base name used for router, service, and type names from a contract file path.
+ *
+ * Strips directories and the `.op`/`.ck` extension, then PascalCases each dot-separated segment
+ * (`contracts/ledger.categories.ck` → `LedgerCategories`). Falls back to `Resource` for an empty path.
+ */
+export declare function deriveBaseName(file: string): string;
+/**
+ * Resolve the import specifier for a service class.
+ *
+ * Drops the trailing `Service` suffix and kebab-cases the remainder, then applies `template` if given
+ * (`{name}` → `Ledger`, `{kebab}` → `ledger`). Without a template, defaults to
+ * `#modules/<kebab>/<kebab>.service.js`.
+ *
+ * @param template Optional `servicePathTemplate` from the plugin config.
+ */
+export declare function deriveModulePath(serviceName: string, template?: string): string;
 //# sourceMappingURL=codegen-operation.d.ts.map

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,EAAgC,gBAAgB,EAA2B,MAAM,mBAAmB,CAAC;AAmC7H;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAkE5F;AAID,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"}
+{"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,19 +37,56 @@ 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;
+    output?: {
+        /** Path template for per-op-file tool handlers. Supports {filename}, {dir}, {area}. Default `{filename}.mcp.ts`. */
+        tools?: string;
+        /** Path (or template) for the aggregator that assembles the McpToolHandlerMap. Default `mcp.tools.ts`. */
+        index?: string;
+        /** Path (or template) for the optional POST /mcp route file. Default `mcp.router.ts`. */
+        router?: string;
+        /**
+         * Path template for the model **Zod schema** files the tools import (for arg validation and
+         * `z.toJSONSchema`). When omitted, falls back to the `server` sub-config's `output.types`
+         * (if `server.zod`) or the `zod` sub-config's output. Tools require Zod schemas, not plain types.
+         */
+        types?: string;
+    };
+    /** Emit the `mcp.router.ts` route boilerplate. Default true. */
+    emitRouter?: boolean;
+    /** Mount path used in the emitted router. Default `/mcp`. */
+    path?: string;
+    /** Import path template for service implementations (same semantics as ServerConfig). */
+    servicePathTemplate?: string;
+    /** 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;
     zod?: ZodConfig;
     types?: TypesConfig;
+    mcp?: McpConfig;
 }
 /** Bumped when the codegen output shape changes in a way that should bust every per-file fingerprint. */
 export declare const TYPESCRIPT_CODEGEN_VERSION = "1";

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;AA6C3B,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,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;CACvB;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"}