@contractkit/plugin-typescript 0.33.2 → 0.34.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     210.74 KB
-ESM dist/index.js.map 480.07 KB
-ESM ⚡️ Build success in 537ms
+ESM dist/index.js     220.70 KB
+ESM dist/index.js.map 514.14 KB
+ESM ⚡️ Build success in 310ms
 DTS Build start
-DTS ⚡️ Build success in 4711ms
+DTS ⚡️ Build success in 3538ms
 DTS dist/index.d.ts 5.14 KB

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

@@ -3,36 +3,37 @@ $ vitest run --coverage
  RUN  v4.1.5 /home/runner/work/ContractKit/ContractKit/packages/plugin-typescript
       Coverage enabled with v8
 
- ✓ tests/codegen-contract.test.ts (140 tests) 291ms
- ✓ tests/codegen-operation.test.ts (155 tests) 339ms
- ✓ tests/codegen-sdk.test.ts (159 tests) 336ms
- ✓ tests/codegen-server.test.ts (30 tests) 106ms
- ✓ tests/codegen-plain-types.test.ts (66 tests) 90ms
- ✓ tests/pipeline.test.ts (30 tests) 458ms
- ✓ tests/codegen-mcp.test.ts (24 tests) 81ms
- ✓ tests/escaping-security.test.ts (18 tests) 35ms
+ ✓ tests/codegen-sdk.test.ts (173 tests) 434ms
+ ✓ tests/codegen-contract.test.ts (147 tests) 165ms
+ ✓ tests/codegen-operation.test.ts (159 tests) 297ms
+ ✓ tests/pipeline.test.ts (34 tests) 276ms
+ ✓ tests/codegen-server.test.ts (33 tests) 59ms
+ ✓ tests/codegen-plain-types.test.ts (67 tests) 78ms
+ ✓ tests/ts-render.test.ts (5 tests) 20ms
+ ✓ tests/codegen-mcp.test.ts (28 tests) 53ms
+ ✓ tests/escaping-security.test.ts (18 tests) 18ms
 
- Test Files  8 passed (8)
-      Tests  622 passed (622)
-   Start at  19:19:25
-   Duration  10.45s (transform 4.58s, setup 0ms, import 19.71s, tests 1.74s, environment 1ms)
+ Test Files  9 passed (9)
+      Tests  664 passed (664)
+   Start at  14:41:57
+   Duration  7.07s (transform 3.29s, setup 0ms, import 12.86s, tests 1.40s, environment 1ms)
 
  % Coverage report from v8
 -------------------|---------|----------|---------|---------|-------------------
 File               | % Stmts | % Branch | % Funcs | % Lines | Uncovered Line #s 
 -------------------|---------|----------|---------|---------|-------------------
-All files          |   83.01 |    77.14 |   86.06 |   85.64 |                   
- src               |   82.87 |    76.85 |    85.8 |   85.49 |                   
-  ...n-contract.ts |   89.24 |    83.92 |   90.16 |   90.42 | ...1150,1155-1156 
-  codegen-mcp.ts   |   82.33 |    74.84 |   84.21 |   85.77 | ...97,302-303,386 
-  ...-operation.ts |   83.02 |    80.71 |   79.71 |   85.18 | ...1032,1037-1038 
-  ...lain-types.ts |   88.44 |    80.74 |   97.05 |   90.74 | ...71,197,309,315 
-  ...gen-revive.ts |   57.77 |    52.04 |      75 |   62.74 | ...65-196,278-284 
-  codegen-sdk.ts   |   88.96 |    82.01 |   90.56 |   91.78 | ...1632,1636-1637 
+All files          |   83.33 |    77.36 |   86.64 |   85.95 |                   
+ src               |   83.14 |    77.04 |   86.23 |   85.78 |                   
+  ...n-contract.ts |   90.13 |    85.89 |   90.51 |    90.9 | ...1166,1171-1172 
+  codegen-mcp.ts   |    82.2 |    74.21 |   84.21 |   85.65 | ...99,304-305,387 
+  ...-operation.ts |   83.06 |    80.46 |   80.28 |   85.15 | ...1045,1050-1051 
+  ...lain-types.ts |    91.7 |     83.8 |   96.96 |   94.57 | ...79,204,316,322 
+  ...gen-revive.ts |   59.23 |    52.54 |   78.37 |   65.28 | ...85-316,398-404 
+  codegen-sdk.ts   |   88.46 |    80.47 |   90.55 |   91.36 | ...1891,1895-1896 
   ...al-runtime.ts |     100 |      100 |     100 |     100 |                   
-  index.ts         |   67.96 |    54.68 |      75 |   71.09 | ...1079,1095-1114 
-  path-utils.ts    |   70.28 |    51.13 |     100 |    73.5 | ...65-168,216-231 
-  ts-render.ts     |   85.18 |     87.5 |   79.16 |   89.39 | 83,165,198-206    
- tests             |   91.22 |    92.68 |   90.32 |      94 |                   
-  helpers.ts       |   91.22 |    92.68 |   90.32 |      94 | 115-123           
+  index.ts         |   68.64 |     55.2 |    75.4 |   71.67 | ...1121,1137-1156 
+  path-utils.ts    |    70.5 |    52.27 |     100 |   73.72 | ...75-178,226-241 
+  ts-render.ts     |   86.04 |    88.23 |      80 |   90.14 | 103,191,224-232   
+ tests             |   94.73 |    95.12 |   93.54 |      96 |                   
+  helpers.ts       |   94.73 |    95.12 |   93.54 |      96 | 120,128           
 -------------------|---------|----------|---------|---------|-------------------

package/CHANGELOG.md

@@ -1,5 +1,278 @@
 # @contractkit/contractkit-plugin-typescript
 
+## 0.34.0
+
+### Minor Changes
+
+- f453bf5: Honour the optionality an inline `query:` or `headers:` block declares, in the router, the SDK and the OpenAPI document.
+
+    All three read the same `OpParamNode.optional`, and all three ignored it. The router validated every inline param as required, the SDK typed every one optional, and OpenAPI marked every non-path parameter `required: false`. So for a contract saying
+
+    ```
+    query: { limit?: int = 20, cursor: string }
+    headers: { api-key?: string, x-tenant: string }
+    ```
+
+    the SDK let you omit a `cursor` the router would then reject, while typing `limit` as something you had to think about even though it has a default; and the published spec disagreed with both.
+
+    Now:
+    - **Router** — the param schema carries the same modifier chain a model field does, via the shared `applyFieldModifiers`. `limit` becomes `.default(20)`, `api-key` becomes `.optional()`. The hand-rolled query-array preprocess is gone too, delegating to `renderQueryType`, which already had that rule.
+    - **SDK** — a field is optional only when the contract says so, either with `?` or by carrying a default. The whole argument is optional only when every field is, since a caller cannot omit an object that must supply something.
+    - **OpenAPI** — `required` follows the contract for query and header parameters, matching what the `inlineObject` branch already did. The two `$ref` branches are unchanged: a whole-model param source has no per-field optionality to read.
+
+    **Python is deliberately excluded.** It hardcodes `optional: true` on query and headers, and has the same ordering constraint as a `SyntaxError` rather than a type error. Permissive is safe; changing it belongs with the work that gives inline query params a `TypedDict`.
+
+    ### What this breaks
+
+    **SDK call sites stop compiling when an argument becomes required.** The old signature was wrong in both directions at once, so this surfaces two different latent bugs: calls that omitted a value the router demanded, and required fields typed as optional so nothing made you pass them.
+
+    **Requests omitting a non-optional inline param now get a 400.** They were already being rejected by the router; what changes is that the SDK and the spec now say so. To find the affected surface, grep your contracts for inline `query:` and `headers:` blocks whose fields lack a `?` — that set is exactly the delta.
+
+    One case only becomes reachable now: parameter order is path, body, query, then customHeaders, so an all-optional `query:` in front of an all-required `headers:` would emit `async m(query?: Q, customHeaders: H)`, which is `TS1016`. A normalisation pass clears `optional` on every argument before the last required one, which is the only fix that keeps the positional order call sites depend on.
+
+- c93b5c4: Return 204 when an operation emits no response, instead of an error status.
+
+    The generated router picked its status as `emitted ?? first declared ?? 200`. For an operation whose response block is documentation only, the first declared status is an error code, so the router answered a _successful_ request with it:
+
+    ```
+    delete: {
+        response: {
+            400:
+        }
+    }
+    ```
+
+    emitted `ctx.status = 400` on the success path. A bare status means "documented, produced by something else" — middleware, a proxy, the framework — so it is precisely the status the service does not produce, and the worst possible choice of fallback.
+
+    204 is the status that aligns the three generators. `observableResponses` excludes a bare `400:` for the same reason `emittedResponses` does, so the SDK already types such a method `Promise<void>` and `thrownResponses` already puts the 400 in `@throws`. A bodyless 204 success is exactly what `Promise<void>` means; the router was the only one disagreeing.
+
+    ### What this breaks
+
+    **Operations declaring only non-2xx statuses now return 204 rather than that status.** The old behaviour was an error code returned on success, so any client treating it as an error was correct to and now gets a success it can act on. If you genuinely want that status written, give it a block — `400: { … }` — which makes it service-produced and restores it.
+
+    An operation with no `response:` block at all also moves from 200 to 204, on the same reasoning: it emits nothing, and 204 says so precisely. Both are 2xx, so nothing that checks for success changes behaviour; a client asserting `status === 200` would need updating.
+
+- 0e10409: Apply the bigint JSON reviver only to contracts that actually declare a `bigint`.
+
+    `parseJson` ran every response through `bigIntReviver`, which tests `/^-?\d+n$/` against every string anywhere in the document. A contract with no `bigint` field still had a legitimate value like `"123n"` — a product code, a hash fragment, a user's own text — silently turned into a `BigInt`, at any depth, in any field.
+
+    The shared runtime now exports two functions. Clients whose responses carry a `bigint` import `parseJsonWithBigInt` aliased to `parseJson`, so the method bodies are identical either way and the import line is where the choice is legible.
+
+    The predicate is transitive and cross-file, because a `bigint` reached through a referenced model still arrives on the wire as `123n`. It comes from a `modelsWithBigInt` taint set computed the same way `modelsWithDecimal` is, and sliced into the same per-file fingerprints — so a model gaining a `bigint` in another `.ck` file invalidates the clients that read it, rather than leaving a cached client with the wrong import.
+
+    A full schema-driven revival was considered and rejected: `bigIntReplacer` serialises bigints at any depth on the way out, so a path-aware reviver would have to cover exactly the same paths to stay symmetric. Gating the whole reviver on a contract-level predicate takes almost all of the benefit for a fraction of the machinery.
+
+    Renamed `sdkNeedsBigIntReviver` to `sdkParsesJsonResponse` along the way. It tests whether an operation reads a JSON response body at all, which is now the gate for importing `parseJson` in either form — and is a different question from whether the reviver is needed.
+
+    ### What this breaks
+
+    A response field holding the string `"123n"` now stays a string, unless the contract declares that field as `bigint`. If you were relying on the conversion, declare the field `bigint` and it comes back.
+
+- a3c2598: Reject non-string JSON values for numeric scalars, instead of silently turning them into numbers.
+
+    `number` and `int` compiled to `z.coerce.number()`, which is `Number(v)`. That accepts far more than a number: `[]` and `""` become `0`, `null` becomes `0`, `true` becomes `1`. So `{"quantity": []}` validated cleanly and the handler ran on a value the client never sent.
+
+    The coercion is now narrowed to the case that motivates it:
+
+    ```ts
+    z.preprocess(v => (typeof v === 'string' && v.trim() !== '' ? Number(v) : v), z.number());
+    ```
+
+    A non-empty string still converts, because query strings and headers arrive as text and a JSON body carrying `"42"` is common enough that rejecting it would break working callers. Everything else is handed to `z.number()`, which judges it.
+
+    This is the shape the `boolean` scalar already had: its preprocess maps only the two literal strings and passes everything else through to `z.boolean()`. It needed no change.
+
+    Constraints move inside the preprocess — `z.preprocess(…, z.number().min(1))` rather than `.min(1)` on the outside — because `z.preprocess` returns a `ZodPipe`, which has no `.min()`. The `bigint` scalar already did it this way.
+
+    ### What this breaks
+
+    `{"petId": []}`, `{"n": null}` and `{"n": true}` now get a 400 where they previously validated as `0`, `0` and `1`. Frame this as the fix it is: those requests were being accepted and acted on with a value the caller did not send. String-shaped numbers still coerce, so query parameters and headers are unaffected.
+
+    Not addressed here: the JSON-versus-string wire split. `XInput` is a single exported `const` reused for both `query: X` and `request: { application/json: X }`, so a truly strict body schema needs a second emitted variant plus import plumbing. `renderInputScalar` remains the documented seam for that, with its docstring corrected — it claimed to coerce from string input while being a pure passthrough.
+
+- cb06aec: Derive valid identifiers from path parameter names, so a hyphenated path param generates code that works.
+
+    `operation /invoices/{invoice-id}` is a legal contract — the grammar's `identPart` admits `-` and `.` — but it is not a valid TypeScript identifier, and every TypeScript generator used the contract's spelling directly:
+
+    ```ts
+    HyphenatedRouter.get('/invoices/{invoice-id}', requirePolicy(), async ctx => {
+        const { invoice-id } = await parseAndValidate(ctx.params, ...);
+    ```
+
+    Three separate failures in those two lines. The route pattern kept the braces, so Koa registered a literal path no request could match. The destructuring did not parse. And the SDK emitted `async getInvoice(invoice-id: string)`, which did not parse either.
+
+    Names the generated code has to _bind_ are now mapped through `toIdentifier`, so `invoice-id` becomes `invoiceId`:
+    - **Router** — the Koa pattern becomes `/invoices/:invoiceId`, the params schema is keyed to match (that is what `ctx.params` carries), and the service call passes the bound name.
+    - **SDK** — the method parameter and the URL interpolation use the identifier.
+    - **MCP** — the tool's input schema and the handler's destructuring use it.
+
+    **Nothing on the wire changes.** A path placeholder's name never reaches the client: Koa matches by position, so `GET /invoices/abc123` behaves exactly as before. That is what makes the rename safe, and it is the reason query parameters, headers and OpenAPI parameters are deliberately _not_ renamed — those names are what the client actually sends, or must match a path template the same document declares.
+
+    `toIdentifier` returns its input unchanged whenever it is already an identifier, so no existing generated output moves. It lives in core next to the path-parameter pattern, because the Bruno plugin needs the same mapping for its own `:variable` syntax.
+
+- 12040d1: Revive temporal scalars in generated SDK clients, so a `datetime` field really is a Luxon `DateTime`.
+
+    In `sdk: { zod: true }` mode a `datetime` field's type comes from `z.infer` over `z.custom<DateTime>`, so the SDK has always _claimed_ to return a `DateTime`. The client reads its response with `JSON.parse` and a cast, and never runs the schema — so at runtime the field held a string, and `order.shipDate.toISO()` threw. The same held for `date`, `time` and `duration`.
+
+    The generated `reviveX` functions now rehydrate those scalars alongside `decimal`, using helpers that mirror what the schema validates against:
+    - `datetime` → `DateTime.fromISO`
+    - `duration` → `Duration.fromISO`
+    - `date` and `time` → `DateTime.fromFormat` with the format from the contract, defaulting to `yyyy-MM-dd` and `HH:mm:ss`
+
+    Each throws a `TypeError` naming the field path rather than returning something invalid, since a silently wrong `DateTime` surfaces much further from its cause than a throw at the boundary does. A file gets only the helpers its revivers call, decided by scanning the emitted text — the idiom the reviver and type imports already use, for the same reason: a separately computed predicate can drift and leave an unused local behind.
+
+    `interval` is deliberately excluded. `_ZodInterval` ends in `.transform(v => v.toISO()!)`, so its inferred output type is already `string` and there is nothing to revive it to. Covering it means making that round-trip idempotent first, which the router's `isRevalidatable` also depends on.
+
+    Two things ride along:
+
+    **Plain types now say `DateTime` too.** `renderTsScalar` mapped every temporal to `string` for both targets, so `types:` output disagreed with what the router and the SDK actually hand you. It now renders the Luxon classes, and the emitted file imports them.
+
+    **`_ZodBinary` follows the render target.** It was `z.custom<Buffer>` unconditionally, and SDK type files reach it through the same `generateContract`, so a browser client got `Buffer.isBuffer` with no `@types/node` in its scaffold — the type did not resolve and the check could not run. The SDK's schemas are now client-shaped (`Blob`), matching what `renderTsScalar` has always said for that target; the server and standalone `zod:` outputs are unchanged.
+
+    No bump to `TYPESCRIPT_CODEGEN_VERSION` is needed; it was already raised to `2` earlier in this batch. Cache invalidation for the wider taint set comes for free: every `hashFingerprint` that slices it already exists, so a model gaining a `datetime` in another `.ck` file invalidates dependent output as it should.
+
+### Patch Changes
+
+- 27af3f2: Generalise the decimal taint-set helpers over an arbitrary set of scalars.
+
+    `typeHasDecimal` and `computeModelsWithDecimal` hardcoded `decimal`, but the question they answer is not specific to it: any scalar whose runtime type differs from what `JSON.parse` produces taints a model the same way, and needs the same transitive answer through referenced models.
+
+    Core now exports `typeHasScalar(type, scalars)` and `computeModelsWithScalar(models, scalars, external)`. `computeModelsWithDecimal` stays as a thin wrapper over a one-member set, so every existing caller is untouched. The TypeScript plugin's `ReviveCodegenOptions` gains an optional `revivableScalars`, defaulting to the same one-member set.
+
+    Decimal remains the only member and no generated output changes.
+
+    One thing settled in passing: core's predicate checks a `record`'s key _and_ value while the reviver's checks only the value, and that divergence is correct rather than an oversight. Core answers "is this scalar mentioned", which decides imports, and a `record(decimal, string)` schema does reference the `Decimal` type. The reviver answers "is there a value to rehydrate", and a JSON object key is always a string, so there is nothing at a key position to convert. Both are now documented in place.
+
+- fb39996: Fix `@deprecated` being dropped from generated SDK methods that also have a description.
+
+    The SDK emitted the deprecation as its own block, immediately above the block carrying `@name`, `@description` and `@throws`:
+
+    ```ts
+    /** @deprecated */
+    /** @description look up a refund by its originating payment */
+    async getRefund(params: PaymentRef): Promise<Payment> {
+    ```
+
+    TypeScript associates only the JSDoc comment _adjacent_ to a declaration, so the deprecation was invisible to editors and to `tsc` whenever the operation also had a description or an error contract, which is the common case. It survived only on operations that had nothing else to document.
+
+    `@deprecated` is now a tag inside the one block, in the same position the Koa router already puts it:
+
+    ```ts
+    /**
+     * @description look up a refund by its originating payment
+     * @deprecated
+     */
+    ```
+
+    No bump to `TYPESCRIPT_CODEGEN_VERSION` is needed; it was already raised to `2` earlier in this batch.
+
+- 78462d7: Stop emitting the `ModelBase` Zod schema, which nothing has ever read.
+
+    A model with writeonly fields emitted three schemas: `ModelBase` with every field, `Model` (read, no writeonly) and `ModelInput` (write, no readonly). Only the last two were exported. `ModelBase` was a plain `const`, and the sole place a `XBase` name was ever _referenced_ was inside the block that declares `YBase` for a child model — so `XBase` was read only by `YBase`, and no `YBase` was read by anything reachable. The read schema extends the parent's read schema directly, and the input schema extends the parent's input schema; neither goes through a Base. The construct was a closed island, and under `noUnusedLocals` it is a compile error in the generated file.
+
+    Nothing is lost with it. Writeonly inheritance was the thing Base was meant to deliver, and it already rides on the Input chain: a child's `ModelInput` extends its parent's `ModelInput`, which carries the parent's writeonly fields. That is why removing Base changes no exported schema, no inferred type, and no runtime validation.
+
+    This supersedes the narrower change of emitting `XBase` only when some writeonly model extends `X`. That predicate turns out to be unsatisfiable in practice: gating the child's Base on having a reader of its own removes the only reference to the parent's Base, so the correct set is always empty.
+
+    Visible in diffs but not breaking: an unexported `const` disappears from generated schema files.
+
+- 383d26f: Stop importing model types into SDK clients that never mention them.
+
+    `collectTypes` walks the AST and reports every model a request body names, regardless of its content type. `buildMethodParams` types a `multipart/form-data` body as `FormData`, so that model is never mentioned in the emitted method and its import is left unused, which is a compile error under `noUnusedLocals`. The same happened to a model's read variant when only its `Input` variant was actually referenced.
+
+    The collected list is now filtered against the emitted text before imports are generated: the method bodies, the error-body aliases and the inline reviver declarations. This is the idiom the reviver imports in the same function already use, and it errs toward keeping — a name appearing only inside a doc string counts as a reference, because a surplus import is untidy while a missing one does not compile.
+
+    Multipart is deliberately not special-cased inside `collectTypes`. Validating multipart bodies against their declared contract is work still to come, and it would have to undo that special case; with a text-derived filter the model becomes referenced on its own the moment the body is checked, and the import comes back automatically.
+
+    The aggregator path, which calls `collectTypes` separately when several op files merge into one area client, gets the same filter.
+
+    Visible in diffs but not breaking: an `import type` shrinks or disappears. Nothing exported changes.
+
+- b239519: Coerce SDK response headers to the types the return shape declares.
+
+    `renderSdkHeadersShape` types the `headers` object from the contract, while `sdkHeaderEntries` assigned `result.headers.get(name) ?? undefined` regardless. That produced `TS2322` in both directions at once: a header declared `int` was typed `number` and given a `string | undefined`, and a _required_ header was typed `T` and given `T | undefined`. Neither compiled.
+
+    The value expression now follows the resolved scalar, and this table is shared with the Python SDK:
+
+    | Declared type                                                    | Expression                                                 |
+    | ---------------------------------------------------------------- | ---------------------------------------------------------- |
+    | `string`, `email`, `url`, `uuid`, the date/time types, `unknown` | the raw value, asserted or defaulted per optionality       |
+    | `int`, `number`                                                  | `Number(...)`, guarded on `null` when optional             |
+    | `boolean`                                                        | compared against `'true'`, guarded on `null` when optional |
+    | `bigint`                                                         | `BigInt(...)`, guarded on `null` when optional             |
+    | anything else                                                    | rejected at codegen                                        |
+
+    Optionality drives the null handling: `Headers.get` returns `null` for an absent header, so an optional header maps that onto `undefined`, which is what its `?` in the shape means, while a required one is asserted because the contract says the service always sends it.
+
+    A header declared as a `decimal`, a `json`, a `binary`, a model reference, an array or an object is now a build error naming the header and the operation, which the CLI reports scoped to this plugin. Header values arrive as strings and there is no meaningful reading of those types from one; emitting code that does not compile is worse than refusing.
+
+    The Python SDK reuses this table, with one asymmetry worth stating: temporals _do_ need coercion there, because `renderPyType` maps them to `datetime`/`date`/`time` objects while `renderOutputTsType` maps them to `string`.
+
+    No bump to `TYPESCRIPT_CODEGEN_VERSION` is needed; it was already raised to `2` earlier in this batch.
+
+- 2597e3e: Fix generated SDK methods failing to compile when a route declares its path params as a model.
+
+    `buildUrlExpression` accepted a `ParamSource` and discarded it, always interpolating the placeholder by bare name. That is right for a `params { … }` block, whose fields `buildMethodParams` spreads across the signature — but for `params: PaymentRef` the signature has a single argument called `params`, so the emitted URL named something that does not exist:
+
+    ```ts
+    async getRefund(params: PaymentRef): Promise<Payment> {
+        const result = await this.fetch(`/refunds/${encodeURIComponent(paymentId)}`, { method: 'GET' });
+    ```
+
+    `TS2304`, plus `TS6133` for the now-unread `params`. This is the same root cause as the Python `NameError`: the name in the path and the name in the signature come from different places and were never reconciled.
+
+    The value is now read off the argument, as `params.paymentId`. A placeholder that is not a valid property accessor uses bracket notation, and the expression is wrapped in `String(...)` because a model's field may be typed something `encodeURIComponent` does not accept.
+
+    The spread-param branch is deliberately unchanged, including for a placeholder that is not a valid identifier. There the expression has to name a signature parameter, and `buildMethodParams` uses the contract's spelling verbatim — so when that spelling is not an identifier the method is already unsalvageable, and emitting an expression that parses as arithmetic would be no improvement over leaving the placeholder alone.
+
+    No bump to `TYPESCRIPT_CODEGEN_VERSION` is needed; it was already raised to `2` earlier in this batch.
+
+- 1c36107: Fix the source links in generated TypeScript, which were malformed and did not resolve.
+
+    Every generated schema, router, SDK client and MCP tool carries a markdown link back to the `.ck` declaration it came from. Those links were written as `[User](file://./../contracts/user.ck#L5)`. The `file://` prefix opens a URL authority component, so the `.` that follows parses as the _host_ rather than as a path segment, and the link resolves to nothing in an editor or a rendered doc. The correct form for a path relative to the emitted file is simply `[User](../contracts/user.ck#L5)`, which is what is now emitted.
+
+    The seven sites that built this link each recomputed `relative(dirname(outPath), sourceFile)` by hand and concatenated the pieces inline. They now share one `sourceLink(label, outPath, sourceFile, line?)` helper in `ts-render.ts`, alongside `quoteKey`, `escapeJsDocLines` and `headerNameToProperty`. The helper returns just the link, since some callers wrap it in a JSDoc block and one emits it in a `//` comment. A path that does not already begin with `.` gains a `./` prefix so it reads unambiguously as relative.
+
+    `TYPESCRIPT_CODEGEN_VERSION` is bumped to `2`. `runIncrementalCodegen` honours a cached manifest whenever its recorded `codegenVersion` matches, so without the bump anyone with a warm `.contractkit/cache` would keep the old files after upgrading.
+
+    Visible in diffs but not breaking: the doc links change form. Nothing imports or depends on their text.
+
+- fe9ea0b: Coerce temporal response headers to Luxon objects, completing the header table.
+
+    When response headers first learned to follow their declared types, temporals mapped to `string` and passed the raw value straight through. Reviving temporal scalars later changed `renderOutputTsType` to produce `DateTime` and `Duration` — so the header _shape_ said `DateTime` while the entry still assigned a raw string, and the client file had no `luxon` import at all. A `datetime` response header therefore produced a client that did not compile.
+
+    Temporal headers now convert, using the same functions the body reviver does and taking `date` and `time` formats from the contract. This also makes the TypeScript and Python SDKs symmetric: Python has coerced these since its own header types landed.
+
+    Two details:
+
+    The `luxon` import is decided from the emitted method bodies, like every other import in these files, and is added by both client paths — `generateSdk` for a top-level client and `generateAreaClient` for an area one. Only the first had the reviver's import logic, so an area client needed it separately.
+
+    Optional headers assert non-null inside the conversion. TypeScript does not carry the narrowing from `get(x) === null` across a _second_ `get(x)` call, so without the assertion the optional form is a `TS2345` even though the ternary has already excluded null. The `bigint` case had the same latent error and is fixed with it — it was invisible because no fixture declared an optional `bigint` header.
+
+    Found by running the real CLI over the reference contracts rather than the test harness, which is what that acceptance pass exists for: the fixture had no temporal response header, so nothing in the suite covered the interaction. It does now.
+
+- e06d2e7: Warn when an output path template variable has no value.
+
+    `resolveTemplate` leaves an unknown `{key}` in place, and the result joins straight into the output path — so a config using `{area}` against a `.ck` file that declares no `options { keys { area: … } }` quietly wrote its files into a directory literally named `{area}`. `assertWithinBase` did not catch it: the path is inside the base directory, just wrong.
+
+    The build now says so, naming both the variable and the file it affected, and pointing at the two ways to fix it.
+
+    The file is still emitted. Throwing would be a worse trade here — the CLI catches a `generateTargets` throw and continues to the next plugin, so refusing over one misconfigured file would cost you that plugin's entire output. This adds visibility, not a new failure mode.
+
+    The check sits at the plugin's single `emitFile` funnel rather than being threaded down through the five path-computing helpers and their nine call sites. Every output path passes through that one point whichever helper built it, so one check covers all of them, and it catches a case a per-helper callback would miss.
+
+- Updated dependencies [27af3f2]
+- Updated dependencies [227c224]
+- Updated dependencies [135947f]
+- Updated dependencies [cb06aec]
+    - @contractkit/core@0.29.0
+
+## 0.33.3
+
+### Patch Changes
+
+- 637e13b: Fix four defects in the emitted `mcp.router.ts` that left the generated MCP endpoint non-functional. It now emits `bodyParserMiddleware(['json'])` ahead of `requireSignature`, which is what populates the `ctx.rawBody` the signature HMAC is computed over; answers notifications with `else ctx.status = 202` instead of leaving `ctx.body` unset and 404ing the `notifications/initialized` that follows every handshake; wraps the body as `JSON.parse(String(ctx.rawBody))`, since `ctx.rawBody` is `BinaryLike` and `JSON.parse` takes a `string`; and hands the stateful transport `ctx.parsedBody` rather than `ctx.request.body`, which ServerKit never populates and which the new body parser's stream read would otherwise leave empty.
+
 ## 0.33.2
 
 ### Patch Changes

package/dist/codegen-contract.d.ts

@@ -1,4 +1,4 @@
-import type { ContractRootNode, ModelNode, ContractTypeNode, ObjectMode } from '@contractkit/core';
+import type { ContractRootNode, ModelNode, FieldNode, ContractTypeNode, ObjectMode } from '@contractkit/core';
 import type { TsRenderTarget } from './ts-render.js';
 /**
  * Maps a ContractKit object mode to its Zod constructor name.
@@ -19,9 +19,9 @@ export interface ContractCodegenContext {
     /** 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'`.
+     * Runtime the emitted types describe. Only affects scalars whose TypeScript type differs per
+     * runtime: `binary` is a `Buffer` on a Node server and a `Blob` in a fetch client, and
+     * `_ZodBinary` is generated to match. Default `'client'`.
      */
     target?: TsRenderTarget;
     /** Model names that carry a `decimal`, directly or transitively. */
@@ -41,14 +41,30 @@ export declare function computeModelsWithInput(models: ModelNode[], externalMode
 /**
  * Generate a TypeScript module containing Zod schemas for every model in `root`.
  *
- * Emits up to three schemas per model when visibility modifiers are present:
- * `ModelBase` (all fields), `Model` (read — no writeonly), `ModelInput` (write — no readonly).
+ * Emits two schemas per model when visibility modifiers are present: `Model` (read — no
+ * writeonly fields) and `ModelInput` (write — no readonly fields). Writeonly inheritance rides
+ * on the Input chain, since a child's `Input` extends its parent's `Input`, which already carries
+ * the parent's writeonly fields.
  *
  * @param root - The parsed contract root node.
  * @param context - Optional cross-file context for import resolution and Input/Output variant tracking.
  * @returns The full TypeScript source as a string.
  */
 export declare function generateContract(root: ContractRootNode, context?: ContractCodegenContext): string;
+/**
+ * Append the modifier chain a declared field carries: nullability, then a default or optionality,
+ * then the description.
+ *
+ * Takes a structural subset of `FieldNode` rather than the node itself, so an `OpParamNode` — which
+ * is a `FieldNode` minus `visibility`, `deprecated` and `override` — can be rendered through the
+ * same path. That is what lets the router, the SDK and OpenAPI agree on what an inline `query:` or
+ * `headers:` field means.
+ *
+ * A default and `optional` are mutually exclusive on purpose: `.default()` already makes the input
+ * side optional, and adding `.optional()` on top would widen the *output* type to include
+ * `undefined`, which is exactly what a default exists to prevent.
+ */
+export declare function applyFieldModifiers(expr: string, field: Pick<FieldNode, 'nullable' | 'default' | 'optional' | 'description'>): string;
 /**
  * Render a ContractKit AST type node as a Zod schema expression string.
  *

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;AAO3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAIrD;;;;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;IACxB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CAC1B;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,CAgGjG;AAgVD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,kBAAkB,CAAC,EAAE,OAAO,GAAG,QAAQ,EAAE,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CA6B5H;AAkPD;;;;;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":"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"}

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

@@ -1 +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;AAUhI,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;AA+VD,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,CA2DzF;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"}
+{"version":3,"file":"codegen-mcp.d.ts","sourceRoot":"","sources":["../src/codegen-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA8E,MAAM,mBAAmB,CAAC;AAUhI,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;AAgWD,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,CAwBzE"}

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,EACR,UAAU,EACV,WAAW,EACX,eAAe,EAGf,gBAAgB,EAInB,MAAM,mBAAmB,CAAC;AAkC3B;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CA0E5F;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;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAgHnF;AAwSD;;;;;;;;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;AA0aD;;;;;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,EACR,UAAU,EACV,WAAW,EACX,eAAe,EAGf,gBAAgB,EAInB,MAAM,mBAAmB,CAAC;AAmC3B;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,OAAO,CA0E5F;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;IAC1B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CA+GnF;AA6SD;;;;;;;;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;AAkbD;;;;;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.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;AAgBpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAkFnG"}
+{"version":3,"file":"codegen-plain-types.d.ts","sourceRoot":"","sources":["../src/codegen-plain-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,mBAAmB,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAgBpE;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CA2FnG"}

package/dist/codegen-revive.d.ts

@@ -1,4 +1,4 @@
-import type { ContractTypeNode, ModelNode } from '@contractkit/core';
+import type { ContractTypeNode, ModelNode, ScalarTypeNode } from '@contractkit/core';
 /**
  * Emitters for the `reviveX` functions that rehydrate `decimal` fields in an SDK response.
  *
@@ -17,18 +17,52 @@ import type { ContractTypeNode, ModelNode } from '@contractkit/core';
  * Emitted from the AST, so zod mode and plain-types mode produce identical runtime behaviour.
  */
 export interface ReviveCodegenOptions {
-    /** Models that carry a decimal, directly or transitively. Only these get a reviver. */
+    /** Models that carry a revivable scalar, directly or transitively. Only these get a reviver. */
     modelsWithDecimal: Set<string>;
+    /**
+     * Which scalars need rehydrating from their wire form. Defaults to `decimal`, the only scalar
+     * whose runtime type currently differs from what `JSON.parse` produces.
+     *
+     * A set rather than a boolean because the question a reviver asks is not "does this reach a
+     * decimal" but "which conversion does this leaf need" — and the answer becomes plural as soon
+     * as a second scalar joins.
+     */
+    revivableScalars?: ReadonlySet<ScalarTypeNode['name']>;
     /** Models with an `Output` variant, which need a second reviver keyed by the output casing. */
     modelsWithOutput?: Set<string>;
     /** Every model in scope, for resolving discriminated-union members to their literal tag. */
     modelMap?: Map<string, ModelNode>;
 }
-/** The per-file coercion helper. Emitted once in any file that declares a reviver. */
+/**
+ * The per-file coercion helpers, keyed by the call prefix that identifies them in emitted text.
+ *
+ * A file gets only the helpers its revivers actually call, decided by scanning the emitted lines
+ * — the same text-derived idiom the reviver and type imports use, and for the same reason: a
+ * predicate computed separately can drift and leave an unused local behind.
+ *
+ * Each one takes the raw JSON value and throws a `TypeError` naming the path rather than
+ * returning something invalid, because a silently wrong `DateTime` surfaces much further from
+ * the cause than a throw at the boundary does.
+ */
+export declare const COERCE_DECLS: Record<string, string[]>;
+/** Back-compat alias: the decimal helper alone, which several call sites still name directly. */
 export declare const DECIMAL_COERCE_DECL: string[];
+/** The helper declarations `lines` actually calls, in a stable order. */
+export declare function coerceDeclsFor(lines: string[]): string[];
+/** Luxon classes referenced by the helpers `lines` calls, for the importing file to bring in. */
+export declare function coerceLuxonImports(lines: string[]): string[];
 /** `reviveInvoice` / `reviveInvoiceOutput`. */
 export declare function reviveFnName(model: string, variant?: 'base' | 'output'): string;
-/** Whether a type reaches a decimal, following refs through `modelsWithDecimal`. */
+/**
+ * Scalars whose runtime type differs from what `JSON.parse` produces, and which a reviver
+ * therefore has to rehydrate. The default of {@link ReviveCodegenOptions.revivableScalars}.
+ *
+ * `interval` is excluded: `_ZodInterval` ends in `.transform(v => v.toISO()!)`, so its inferred
+ * output type is already `string` and there is nothing to revive it to. Covering it means making
+ * that round-trip idempotent first, which the router's `isRevalidatable` also depends on.
+ */
+export declare const DEFAULT_REVIVABLE_SCALARS: ReadonlySet<ScalarTypeNode['name']>;
+/** Whether a type reaches a revivable scalar, following refs through `modelsWithDecimal`. */
 export declare function typeReachesDecimal(type: ContractTypeNode, opts: ReviveCodegenOptions): boolean;
 /**
  * A standalone reviver for an arbitrary type node — used for a response body that is not a plain

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

@@ -1 +1 @@
-{"version":3,"file":"codegen-revive.d.ts","sourceRoot":"","sources":["../src/codegen-revive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAa,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEhF;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,oBAAoB;IACjC,uFAAuF;IACvF,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED,sFAAsF;AACtF,eAAO,MAAM,mBAAmB,UAW/B,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,QAAiB,GAAG,MAAM,CAEvF;AAQD,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAuB9F;AA0JD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,MAAM,GAAG,QAAmB,GACtC,MAAM,EAAE,GAAG,IAAI,CAajB;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAQ5F"}
+{"version":3,"file":"codegen-revive.d.ts","sourceRoot":"","sources":["../src/codegen-revive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAa,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEhG;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,oBAAoB;IACjC,gGAAgG;IAChG,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IACvD,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACrC;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CA2CjD,CAAC;AAEF,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,UAA0B,CAAC;AAE3D,yEAAyE;AACzE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKxD;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAM5D;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,GAAG,QAAiB,GAAG,MAAM,CAEvF;AAQD;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,EAAE,WAAW,CAAC,cAAc,CAAC,MAAM,CAAC,CAMxE,CAAC;AAEH,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,oBAAoB,GAAG,OAAO,CA2B9F;AAuLD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,oBAAoB,EAC1B,OAAO,GAAE,MAAM,GAAG,QAAmB,GACtC,MAAM,EAAE,GAAG,IAAI,CAajB;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,oBAAoB,GAAG,MAAM,EAAE,CAQ5F"}

package/dist/codegen-sdk.d.ts

@@ -15,6 +15,8 @@ export interface SdkCodegenOptions {
     modelsWithOutput?: Set<string>;
     /** Model names carrying a `decimal`, whose response bodies need rehydrating client-side. */
     modelsWithDecimal?: Set<string>;
+    /** Model names carrying a `bigint`, directly or transitively. Selects the JSON reviver. */
+    modelsWithBigInt?: Set<string>;
     /** Every model in scope, for resolving discriminated-union members inside an inline reviver. */
     modelMap?: Map<string, ModelNode>;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"codegen-sdk.d.ts","sourceRoot":"","sources":["../src/codegen-sdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"codegen-sdk.d.ts","sourceRoot":"","sources":["../src/codegen-sdk.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -99,7 +99,7 @@ export interface TypescriptPluginConfig {
     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";
+export declare const TYPESCRIPT_CODEGEN_VERSION = "2";
 declare const plugin: ContractKitPlugin;
 export default plugin;
 /** Build a `@contractkit/plugin-typescript` instance with explicit configuration, for programmatic use. */

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;AAgD3B,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;IAC1B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;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;;;;;;;;OAQG;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,iBAAiB,EASpB,MAAM,mBAAmB,CAAC;AAqD3B,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;IAC1B;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;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;;;;;;;;OAQG;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;AAY9C,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"}