@contractkit/plugin-typescript 0.31.2 → 0.33.0

package/dist/index.js

@@ -77,6 +77,8 @@ function renderTsScalar(name, target) {
       return "number";
     case "bigint":
       return "bigint";
+    case "decimal":
+      return "Decimal";
     case "boolean":
       return "boolean";
     case "date":
@@ -161,6 +163,251 @@ function renderOutputTsType(type, modelsWithOutput, target = "client") {
 }
 __name(renderOutputTsType, "renderOutputTsType");
 
+// src/decimal-runtime.ts
+var DECIMAL_IMPORT = `import { Decimal } from 'decimal.js';`;
+var DECIMAL_CONFIG_LINE = `Decimal.set({ toExpNeg: -9e15, toExpPos: 9e15 });`;
+var DECIMAL_ZOD_SCHEMA_LINE = `const _ZodDecimal = z.preprocess((val) => { if (typeof val !== 'string') return val; try { return new Decimal(val); } catch { return val; } }, z.custom<Decimal>((val) => Decimal.isDecimal(val), { message: 'Must be an exact decimal sent as a quoted string, e.g. "1250.00"' }));`;
+var DECIMAL_PRELUDE_LINES = [
+  DECIMAL_CONFIG_LINE,
+  DECIMAL_ZOD_SCHEMA_LINE
+];
+
+// src/codegen-revive.ts
+var DECIMAL_COERCE_DECL = [
+  `const __dec = (v: unknown, path: string): Decimal => {`,
+  `    if (typeof v !== 'string') {`,
+  `        throw new TypeError(\`ContractKit: expected a decimal string at '\${path}', received \${typeof v} \u2014 decimals must be sent as quoted JSON strings.\`);`,
+  `    }`,
+  `    try {`,
+  `        return new Decimal(v);`,
+  `    } catch {`,
+  `        throw new TypeError(\`ContractKit: '\${v}' at '\${path}' is not a valid decimal.\`);`,
+  `    }`,
+  `};`
+];
+function reviveFnName(model, variant = "base") {
+  return `revive${model}${variant === "output" ? "Output" : ""}`;
+}
+__name(reviveFnName, "reviveFnName");
+function applyCase(name, caseTransform) {
+  if (!caseTransform || caseTransform === "camel") return name;
+  if (caseTransform === "snake") return name.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`);
+  return name.charAt(0).toUpperCase() + name.slice(1);
+}
+__name(applyCase, "applyCase");
+function typeReachesDecimal(type, opts) {
+  switch (type.kind) {
+    case "scalar":
+      return type.name === "decimal";
+    case "ref":
+      return opts.modelsWithDecimal.has(type.name);
+    case "array":
+      return typeReachesDecimal(type.item, opts);
+    case "lazy":
+      return typeReachesDecimal(type.inner, opts);
+    case "tuple":
+      return type.items.some((t) => typeReachesDecimal(t, opts));
+    case "record":
+      return typeReachesDecimal(type.value, opts);
+    case "union":
+    case "discriminatedUnion":
+    case "intersection":
+      return type.members.some((t) => typeReachesDecimal(t, opts));
+    case "inlineObject":
+      return type.fields.some((f) => typeReachesDecimal(f.type, opts));
+    default:
+      return false;
+  }
+}
+__name(typeReachesDecimal, "typeReachesDecimal");
+var Scope = class Scope2 {
+  static {
+    __name(this, "Scope");
+  }
+  n = 0;
+  next(prefix) {
+    return `__${prefix}${this.n++}`;
+  }
+};
+function emit(slot, type, path, opts, scope, variant) {
+  switch (type.kind) {
+    case "scalar":
+      return type.name === "decimal" ? [
+        `${slot} = __dec(${slot}, '${path}');`
+      ] : [];
+    case "ref":
+      return opts.modelsWithDecimal.has(type.name) ? [
+        `${reviveRefName(type.name, opts, variant)}(${slot} as never);`
+      ] : [];
+    case "lazy":
+      return emit(slot, type.inner, path, opts, scope, variant);
+    case "array": {
+      if (!typeReachesDecimal(type.item, opts)) return [];
+      const arr = scope.next("a");
+      const i = scope.next("i");
+      const inner = emit(`${arr}[${i}]`, type.item, `${path}[]`, opts, scope, variant);
+      return [
+        `{`,
+        `    const ${arr} = ${slot} as unknown[];`,
+        `    for (let ${i} = 0; ${i} < ${arr}.length; ${i}++) {`,
+        ...inner.map((l) => `        ${l}`),
+        `    }`,
+        `}`
+      ];
+    }
+    case "tuple": {
+      const items = type.items.flatMap((t, idx) => typeReachesDecimal(t, opts) ? emit(`(${slot} as unknown[])[${idx}]`, t, `${path}[${idx}]`, opts, scope, variant) : []);
+      return items;
+    }
+    case "record": {
+      if (!typeReachesDecimal(type.value, opts)) return [];
+      const rec = scope.next("r");
+      const k = scope.next("k");
+      const inner = emit(`${rec}[${k}]`, type.value, `${path}{}`, opts, scope, variant);
+      return [
+        `{`,
+        `    const ${rec} = ${slot} as Record<string, unknown>;`,
+        `    for (const ${k} of Object.keys(${rec})) {`,
+        ...inner.map((l) => `        ${l}`),
+        `    }`,
+        `}`
+      ];
+    }
+    case "inlineObject": {
+      const relevant = type.fields.filter((f) => typeReachesDecimal(f.type, opts));
+      if (relevant.length === 0) return [];
+      const obj = scope.next("o");
+      const body = relevant.flatMap((f) => fieldStatements(obj, f, path, opts, scope, variant, void 0));
+      return [
+        `{`,
+        `    const ${obj} = ${slot} as Record<string, unknown>;`,
+        ...body.map((l) => `    ${l}`),
+        `}`
+      ];
+    }
+    case "intersection":
+      return type.members.flatMap((m) => emit(slot, m, path, opts, scope, variant));
+    case "union": {
+      const real = type.members.filter((m) => !(m.kind === "scalar" && m.name === "null"));
+      const target = real.find((m) => typeReachesDecimal(m, opts));
+      if (!target) return [];
+      const inner = emit(slot, target, path, opts, scope, variant);
+      return [
+        `if (${slot} != null) {`,
+        ...inner.map((l) => `    ${l}`),
+        `}`
+      ];
+    }
+    case "discriminatedUnion": {
+      const branches = [];
+      const disc = scope.next("d");
+      for (const member of type.members) {
+        if (!typeReachesDecimal(member, opts)) continue;
+        const tag = discriminatorTag(member, type.discriminator, opts);
+        const inner = emit(slot, member, path, opts, scope, variant);
+        if (inner.length === 0) continue;
+        if (tag === void 0) {
+          continue;
+        }
+        branches.push(`    if (${disc} === ${JSON.stringify(tag)}) {`, ...inner.map((l) => `        ${l}`), `    }`);
+      }
+      if (branches.length === 0) return [];
+      return [
+        `{`,
+        `    const ${disc} = (${slot} as Record<string, unknown>)[${JSON.stringify(type.discriminator)}];`,
+        ...branches,
+        `}`
+      ];
+    }
+    default:
+      return [];
+  }
+}
+__name(emit, "emit");
+function discriminatorTag(member, discriminator, opts) {
+  const fields = member.kind === "inlineObject" ? member.fields : member.kind === "ref" ? opts.modelMap?.get(member.name)?.fields : void 0;
+  const field = fields?.find((f) => f.name === discriminator);
+  if (field?.type.kind === "literal") return field.type.value;
+  if (field?.type.kind === "enum" && field.type.values.length === 1) return field.type.values[0];
+  return void 0;
+}
+__name(discriminatorTag, "discriminatorTag");
+function fieldStatements(objVar, field, path, opts, scope, variant, outputCase) {
+  const key = variant === "output" ? applyCase(field.name, outputCase) : field.name;
+  const slot = `${objVar}[${JSON.stringify(key)}]`;
+  const inner = emit(slot, field.type, `${path}.${key}`, opts, scope, variant);
+  if (inner.length === 0) return [];
+  if (field.type.kind === "union") return inner;
+  if (field.optional || field.nullable) {
+    return [
+      `if (${slot} != null) {`,
+      ...inner.map((l) => `    ${l}`),
+      `}`
+    ];
+  }
+  return inner;
+}
+__name(fieldStatements, "fieldStatements");
+function reviveRefName(name, opts, variant) {
+  if (variant === "output" && opts.modelsWithOutput?.has(name)) return reviveFnName(name, "output");
+  return reviveFnName(name, "base");
+}
+__name(reviveRefName, "reviveRefName");
+function renderInlineReviver(fnName, tsType, type, opts, variant = "output") {
+  if (!typeReachesDecimal(type, opts)) return null;
+  const scope = new Scope();
+  const body = emit("__v[0]", type, fnName.replace(/^__revive/, ""), opts, scope, variant);
+  if (body.length === 0) return null;
+  return [
+    `/** Rehydrates the \`decimal\` fields of one response body. Mutates and returns \`raw\`. */`,
+    `function ${fnName}(raw: ${tsType}): ${tsType} {`,
+    `    const __v = [raw] as unknown[];`,
+    ...body.map((l) => `    ${l}`),
+    `    return __v[0] as ${tsType};`,
+    `}`
+  ];
+}
+__name(renderInlineReviver, "renderInlineReviver");
+function renderReviveFunctions(model, opts) {
+  if (!opts.modelsWithDecimal.has(model.name)) return [];
+  const lines = renderOne(model, opts, "base");
+  if (opts.modelsWithOutput?.has(model.name)) {
+    lines.push("");
+    lines.push(...renderOne(model, opts, "output"));
+  }
+  return lines;
+}
+__name(renderReviveFunctions, "renderReviveFunctions");
+function renderOne(model, opts, variant) {
+  const scope = new Scope();
+  const typeName = `${model.name}${variant === "output" ? "Output" : ""}`;
+  const fnName = reviveFnName(model.name, variant);
+  if (model.type) {
+    const body2 = emit("__v[0]", model.type, model.name, opts, scope, variant);
+    if (body2.length === 0) return [];
+    return [
+      `/** Rehydrates every \`decimal\` in a ${typeName} from its wire string. Mutates and returns \`raw\`. */`,
+      `export function ${fnName}(raw: ${typeName}): ${typeName} {`,
+      `    const __v = [raw] as unknown[];`,
+      ...body2.map((l) => `    ${l}`),
+      `    return __v[0] as ${typeName};`,
+      `}`
+    ];
+  }
+  const obj = scope.next("o");
+  const body = model.fields.flatMap((f) => typeReachesDecimal(f.type, opts) ? fieldStatements(obj, f, model.name, opts, scope, variant, model.outputCase) : []);
+  if (body.length === 0) return [];
+  return [
+    `/** Rehydrates every \`decimal\` in a ${typeName} from its wire string. Mutates and returns \`raw\`. */`,
+    `export function ${fnName}(raw: ${typeName}): ${typeName} {`,
+    `    const ${obj} = raw as unknown as Record<string, unknown>;`,
+    ...body.map((l) => `    ${l}`),
+    `    return raw;`,
+    `}`
+  ];
+}
+__name(renderOne, "renderOne");
+
 // src/codegen-contract.ts
 function modeToWrapper(mode) {
   switch (mode) {
@@ -225,6 +472,7 @@ function generateContract(root, context) {
   const needsBinary = rootNeedsScalar(root, "binary");
   const needsDatetime = rootNeedsScalar(root, "datetime");
   const needsJson = rootNeedsScalar(root, "json");
+  const needsDecimal = rootNeedsScalar(root, "decimal");
   const externalRefs = collectExternalRefs(root);
   const lines = [];
   const externalModelsWithInput = context?.modelsWithInput ?? /* @__PURE__ */ new Set();
@@ -254,9 +502,11 @@ function generateContract(root, context) {
   if (needsDuration) luxonImports.push("Duration");
   if (needsInterval) luxonImports.push("Interval");
   if (luxonImports.length > 0) lines.push(`import { ${luxonImports.join(", ")} } from 'luxon';`);
+  if (needsDecimal) lines.push(DECIMAL_IMPORT);
   for (const ref of allExternalRefs) {
     const importPath = resolveImportPath(ref, context);
-    lines.push(`import { ${ref} } from '${importPath}';`);
+    const names = context?.emitRevivers && context.modelsWithDecimal?.has(ref) ? `${ref}, ${reviveFnName(ref)}` : ref;
+    lines.push(`import { ${names} } from '${importPath}';`);
   }
   lines.push("");
   if (needsBinary) {
@@ -268,20 +518,41 @@ function generateContract(root, context) {
   if (needsInterval) {
     lines.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 (needsDecimal) {
+    lines.push(...DECIMAL_PRELUDE_LINES);
+  }
   if (needsJson) {
     lines.push(`type _JsonValue = string | number | boolean | null | _JsonValue[] | { [key: string]: _JsonValue };`);
     lines.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)]));`);
   }
-  if (needsBinary || needsDatetime || needsInterval || needsJson) lines.push("");
+  if (needsBinary || needsDatetime || needsInterval || needsDecimal || needsJson) lines.push("");
   const modelsWithWriteonly = new Set(root.models.filter((m) => m.fields.some((f) => f.visibility === "writeonly")).map((m) => m.name));
   const modelMap = new Map(root.models.map((m) => [
     m.name,
     m
   ]));
+  const reviveOpts = context?.emitRevivers && context.modelsWithDecimal ? {
+    modelsWithDecimal: context.modelsWithDecimal,
+    modelsWithOutput: allModelsWithOutput,
+    modelMap
+  } : void 0;
+  const bodyLines = [];
   for (const model of topoSortModels(root.models)) {
-    lines.push(...generateModel(model, context?.currentOutPath, allModelsWithInput, modelsWithWriteonly, modelMap, allModelsWithOutput));
+    bodyLines.push(...generateModel(model, context?.currentOutPath, allModelsWithInput, modelsWithWriteonly, modelMap, allModelsWithOutput));
+    if (reviveOpts) {
+      const revivers = renderReviveFunctions(model, reviveOpts);
+      if (revivers.length > 0) {
+        bodyLines.push("");
+        bodyLines.push(...revivers);
+      }
+    }
+    bodyLines.push("");
+  }
+  if (bodyLines.some((l) => l.includes("__dec("))) {
+    lines.push(...DECIMAL_COERCE_DECL);
     lines.push("");
   }
+  lines.push(...bodyLines);
   return lines.join("\n");
 }
 __name(generateContract, "generateContract");
@@ -349,8 +620,8 @@ function generateSimpleModel(model, outPath) {
     lines.push(...inputBody.map((l) => `    ${l}`));
     lines.push(`}).transform(data => ({`);
     for (const field of model.fields) {
-      const inputKey = applyCase(field.name, inputCase);
-      const outputKey = applyCase(field.name, outputCase);
+      const inputKey = applyCase2(field.name, inputCase);
+      const outputKey = applyCase2(field.name, outputCase);
       if (field.optional) {
         const guard = hasInputTransform ? `data.${inputKey} != null` : `data.${inputKey} !== undefined`;
         lines.push(`    ...(${guard} ? { ${quoteKey2(outputKey)}: data.${inputKey} } : {}),`);
@@ -473,12 +744,12 @@ function camelToPascal(s) {
   return s.charAt(0).toUpperCase() + s.slice(1);
 }
 __name(camelToPascal, "camelToPascal");
-function applyCase(name, caseTransform) {
+function applyCase2(name, caseTransform) {
   if (!caseTransform || caseTransform === "camel") return name;
   if (caseTransform === "snake") return camelToSnake(name);
   return camelToPascal(name);
 }
-__name(applyCase, "applyCase");
+__name(applyCase2, "applyCase");
 function renderFields(fields, defaultMode) {
   return fields.flatMap((f) => renderField(f, defaultMode));
 }
@@ -613,6 +884,18 @@ function renderScalar(s) {
       if (s.max !== void 0) inner += `.max(${s.max}n)`;
       return `z.preprocess((val) => typeof val === 'string' ? BigInt(val.replace(/n$/, '')) : val, ${inner})`;
     }
+    case "decimal": {
+      const checks = [];
+      if (s.scale !== void 0) checks.push(`v.decimalPlaces() <= ${s.scale}`);
+      if (s.min !== void 0) checks.push(`v.gte('${escapeString(String(s.min))}')`);
+      if (s.max !== void 0) checks.push(`v.lte('${escapeString(String(s.max))}')`);
+      if (checks.length === 0) return "_ZodDecimal";
+      const messageParts = [];
+      if (s.scale !== void 0) messageParts.push(`at most ${s.scale} decimal place${s.scale === 1 ? "" : "s"}`);
+      if (s.min !== void 0) messageParts.push(`at least ${s.min}`);
+      if (s.max !== void 0) messageParts.push(`at most ${s.max}`);
+      return `_ZodDecimal.refine((v) => ${checks.join(" && ")}, { message: 'Must be ${escapeString(messageParts.join(", "))}' })`;
+    }
     case "boolean":
       return `z.preprocess((v) => v === 'true' ? true : v === 'false' ? false : v, z.boolean())`;
     case "date": {
@@ -1127,7 +1410,7 @@ function bodyTypesStructurallyEqual(a, b) {
   switch (a.kind) {
     case "scalar": {
       const bb = b;
-      return a.name === bb.name && a.min === bb.min && a.max === bb.max && a.len === bb.len && a.regex === bb.regex && a.format === bb.format;
+      return a.name === bb.name && a.min === bb.min && a.max === bb.max && a.len === bb.len && a.scale === bb.scale && a.regex === bb.regex && a.format === bb.format;
     }
     case "array": {
       const bb = b;
@@ -1207,6 +1490,9 @@ function generateOp(root, options = {}) {
   if (references("_ZodDatetime")) {
     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 (references("_ZodDecimal")) {
+    helpers.push(...DECIMAL_PRELUDE_LINES);
+  }
   if (references("_ZodInterval")) {
     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()!);`);
   }
@@ -1235,12 +1521,13 @@ function generateOp(root, options = {}) {
   if (koaImports.length > 0) {
     body.push(`import { ${koaImports.join(", ")} } from '@maroonedsoftware/koa';`);
   }
-  for (const svc of services) {
+  for (const svc of services.filter(uses)) {
     const modulePath = root.services?.[svc] ?? root.meta[svc] ?? deriveModulePath(svc, options.servicePathTemplate);
     body.push(`import { ${svc} } from '${modulePath}';`);
   }
-  if (types.length > 0) {
-    body.push(...generateTypeImports(types, root.file, options));
+  const usedTypes = types.filter(uses);
+  if (usedTypes.length > 0) {
+    body.push(...generateTypeImports(usedTypes, root.file, options));
   }
   const luxonImports = [
     "DateTime",
@@ -1250,6 +1537,9 @@ function generateOp(root, options = {}) {
   if (luxonImports.length > 0) {
     body.push(`import { ${luxonImports.join(", ")} } from 'luxon';`);
   }
+  if (uses("Decimal")) {
+    body.push(DECIMAL_IMPORT);
+  }
   if (uses("parseAndValidate")) {
     body.push(`import { parseAndValidate } from '@maroonedsoftware/zod';`);
   }
@@ -1359,9 +1649,11 @@ function generateSingleStatusResult(resp, op, className, call, options) {
   const respHeaders = resp?.headers ?? [];
   const hasRespHeaders = respHeaders.length > 0;
   const headersAnnotation = hasRespHeaders ? renderHeadersAnnotation(respHeaders, options.modelsWithOutput) : "";
+  let bodySchema;
   if (bodies.length === 1) {
     const { annotation, prelude } = formatTypeAnnotation(bodies[0].bodyType, options.modelsWithOutput);
     if (prelude) lines.push(`    ${prelude}`);
+    bodySchema = responseBodySchema(bodies[0].bodyType, options, prelude ? "resultType" : void 0);
     lines.push(`    const service = ctx.container.get(${className});`);
     if (hasRespHeaders) {
       lines.push(`    const result: { body: ${annotation}; headers: ${headersAnnotation} } = ${call};`);
@@ -1369,10 +1661,12 @@ function generateSingleStatusResult(resp, op, className, call, options) {
       lines.push(`    const result: ${annotation} = ${call};`);
     }
   } else if (bodies.length > 1) {
-    const { members, preludes } = renderResponseMembers(resp, options, {
+    const rendered = renderResponseMembers(resp, options, {
       includeStatus: false,
       varPrefix: "result"
     });
+    const { members, preludes } = rendered;
+    bodySchema = rendered.bodySchema;
     for (const prelude of preludes) lines.push(`    ${prelude}`);
     lines.push(`    const service = ctx.container.get(${className});`);
     lines.push(`    const result: ${members.join(" | ")} = ${call};`);
@@ -1389,10 +1683,10 @@ function generateSingleStatusResult(resp, op, className, call, options) {
   lines.push(...headerSetLines(respHeaders, "    "));
   if (bodies.length === 1) {
     lines.push(`    ctx.type = '${bodies[0].contentType}';`);
-    lines.push(`    ctx.body = ${hasRespHeaders ? "result.body" : "result"};`);
+    lines.push(`    ctx.body = ${responseBodyExpr(hasRespHeaders ? "result.body" : "result", bodySchema)};`);
   } else if (bodies.length > 1) {
     lines.push(`    ctx.type = result.contentType;`);
-    lines.push(`    ctx.body = result.body;`);
+    lines.push(`    ctx.body = ${responseBodyExpr("result.body", bodySchema)};`);
   }
   return lines;
 }
@@ -1401,6 +1695,7 @@ function generateMultiStatusResult(emitted, className, call, options) {
   const lines = [];
   const members = [];
   const preludes = [];
+  const bodySchemas = /* @__PURE__ */ new Map();
   for (const resp of emitted) {
     const rendered = renderResponseMembers(resp, options, {
       includeStatus: true,
@@ -1408,6 +1703,7 @@ function generateMultiStatusResult(emitted, className, call, options) {
     });
     members.push(...rendered.members);
     preludes.push(...rendered.preludes);
+    bodySchemas.set(resp.statusCode, rendered.bodySchema);
   }
   for (const prelude of preludes) lines.push(`    ${prelude}`);
   lines.push(`    const service = ctx.container.get(${className});`);
@@ -1422,7 +1718,7 @@ function generateMultiStatusResult(emitted, className, call, options) {
     lines.push(...headerSetLines(resp.headers ?? [], "            "));
     if (resp.bodies.length > 0) {
       lines.push(`            ctx.type = result.contentType;`);
-      lines.push(`            ctx.body = result.body;`);
+      lines.push(`            ctx.body = ${responseBodyExpr("result.body", bodySchemas.get(resp.statusCode))};`);
     }
     lines.push(`            break;`);
   }
@@ -1455,6 +1751,7 @@ function renderResponseMembers(resp, options, opts) {
   if (uniform) {
     const { annotation, prelude } = formatTypeAnnotation(bodies[0].bodyType, options.modelsWithOutput, `${opts.varPrefix}Type`);
     if (prelude) preludes.push(prelude);
+    const bodySchema = responseBodySchema(bodies[0].bodyType, options, prelude ? `${opts.varPrefix}Type` : void 0);
     const contentType = bodies.map((b) => `'${b.contentType}'`).join(" | ");
     return {
       members: [
@@ -1465,7 +1762,8 @@ function renderResponseMembers(resp, options, opts) {
           ...trailing
         ].join("; ")} }`
       ],
-      preludes
+      preludes,
+      bodySchema
     };
   }
   const members = bodies.map((b, i) => {
@@ -1562,6 +1860,8 @@ function serverTsScalar(name) {
       return "number";
     case "bigint":
       return "bigint";
+    case "decimal":
+      return "Decimal";
     case "boolean":
       return "boolean";
     case "date":
@@ -1613,6 +1913,46 @@ function formatTypeAnnotation(bodyType, modelsWithOutput, varName = "resultType"
   };
 }
 __name(formatTypeAnnotation, "formatTypeAnnotation");
+function isRevalidatable(type, modelsWithOutput, modelsWithTransform) {
+  const rec = /* @__PURE__ */ __name((t) => isRevalidatable(t, modelsWithOutput, modelsWithTransform), "rec");
+  switch (type.kind) {
+    case "ref":
+      return !modelsWithOutput?.has(type.name) && !modelsWithTransform?.has(type.name);
+    case "array":
+      return rec(type.item);
+    case "tuple":
+      return type.items.every(rec);
+    case "record":
+      return rec(type.key) && rec(type.value);
+    case "intersection": {
+      const [first, ...rest] = type.members;
+      if (!first) return true;
+      if (rest.length === 0) return rec(first);
+      const usesExtendChain = first.kind === "ref" && rest.every((m) => m.kind === "ref" || m.kind === "inlineObject");
+      return usesExtendChain && type.members.every(rec);
+    }
+    case "union":
+    case "discriminatedUnion":
+      return type.members.every(rec);
+    case "inlineObject":
+      return type.fields.every((f) => rec(f.type));
+    case "lazy":
+      return rec(type.inner);
+    default:
+      return true;
+  }
+}
+__name(isRevalidatable, "isRevalidatable");
+function responseBodySchema(bodyType, options, preludeVar) {
+  if (!options.validateResponses) return void 0;
+  if (!isRevalidatable(bodyType, options.modelsWithOutput, options.modelsWithTransform)) return void 0;
+  return preludeVar ?? renderType(bodyType);
+}
+__name(responseBodySchema, "responseBodySchema");
+function responseBodyExpr(value, schema) {
+  return schema ? `await parseAndValidate(${value}, ${schema}, 500)` : value;
+}
+__name(responseBodyExpr, "responseBodyExpr");
 function generateParamValidation(source, ctxExpr, varName, mode, suffix = "", modelsWithInput) {
   if (!source) return [];
   const lines = [];
@@ -1890,7 +2230,7 @@ function deriveTypeImportPath(file, template) {
 __name(deriveTypeImportPath, "deriveTypeImportPath");
 
 // src/index.ts
-import { runIncrementalCodegen, parseIncrementalManifest, emptyIncrementalManifest, serializeIncrementalManifest, hashFingerprint, collectTransitiveModelRefs } from "@contractkit/core";
+import { runIncrementalCodegen, parseIncrementalManifest, emptyIncrementalManifest, serializeIncrementalManifest, hashFingerprint, collectTransitiveModelRefs, computeModelsWithCaseTransform, computeModelsWithDecimal } from "@contractkit/core";
 
 // src/codegen-sdk.ts
 import { resolveModifiers as resolveModifiers2, isJsonMime, classifyContentType as classifyContentType2, observableResponses, thrownResponses } from "@contractkit/core";
@@ -1957,9 +2297,25 @@ function generateSdk(root, options = {}) {
   const includeInternal = options.includeInternal ?? false;
   const types = collectTypes2(root, options.modelsWithInput, options.modelsWithOutput, includeInternal);
   const clientClassName = options.clientClassName ?? deriveClientClassName(root.file);
+  const inlineRevivers = /* @__PURE__ */ new Map();
+  const classBody = [];
+  for (const route of root.routes) {
+    for (const op of route.operations) {
+      const mods = resolveModifiers2(route, op);
+      if (!includeInternal && mods.includes("internal")) continue;
+      classBody.push("");
+      if (mods.includes("deprecated")) classBody.push("    /** @deprecated */");
+      classBody.push(...generateMethod(route, op, root.file, options, inlineRevivers));
+    }
+  }
+  const inlineReviverDecls = [
+    ...inlineRevivers.values()
+  ].flat();
+  const decimalPrelude = decimalPreludeFor(inlineReviverDecls);
   if (types.length > 0) {
-    lines.push(...generateTypeImports2(types, root.file, options));
+    lines.push(...generateTypeImports2(types, root.file, options, usedRevivers(classBody)));
   }
+  lines.push(...decimalPrelude.imports);
   if (options.sdkOptionsPath && options.outPath) {
     let rel = relative3(dirname3(options.outPath), options.sdkOptionsPath);
     rel = rel.replace(/\.ts$/, ".js");
@@ -2057,21 +2413,21 @@ function generateSdk(root, options = {}) {
     lines.push(...errorAliases);
     lines.push("");
   }
+  if (decimalPrelude.decls.length > 0) {
+    lines.push("");
+    lines.push(...decimalPrelude.decls);
+  }
+  for (const decl of inlineRevivers.values()) {
+    lines.push("");
+    lines.push(...decl);
+  }
   lines.push("/**");
   const relFile = options.outPath ? relative3(dirname3(options.outPath), root.file) : root.file;
   lines.push(` * generated from [${basename2(root.file)}](file://./${relFile})`);
   lines.push(" */");
   lines.push(`export class ${clientClassName} {`);
   lines.push("    constructor(private fetch: SdkFetch) {}");
-  for (const route of root.routes) {
-    for (const op of route.operations) {
-      const mods = resolveModifiers2(route, op);
-      if (!includeInternal && mods.includes("internal")) continue;
-      lines.push("");
-      if (mods.includes("deprecated")) lines.push("    /** @deprecated */");
-      lines.push(...generateMethod(route, op, root.file, options));
-    }
-  }
+  lines.push(...classBody);
   lines.push("}");
   lines.push("");
   return lines.join("\n");
@@ -2081,25 +2437,77 @@ function generateClientMethods(root, options) {
   const lines = [];
   const methodNames = [];
   const includeInternal = options.includeInternal ?? false;
+  const inlineRevivers = /* @__PURE__ */ new Map();
   for (const route of root.routes) {
     for (const op of route.operations) {
       const mods = resolveModifiers2(route, op);
       if (!includeInternal && mods.includes("internal")) continue;
       lines.push("");
       if (mods.includes("deprecated")) lines.push("    /** @deprecated */");
-      lines.push(...generateMethod(route, op, root.file, options));
+      lines.push(...generateMethod(route, op, root.file, options, inlineRevivers));
       methodNames.push(deriveMethodName(op, route));
     }
   }
+  const declLines = [
+    ...inlineRevivers.values()
+  ].flat();
+  const { decls } = decimalPreludeFor(declLines);
+  const preludeLines = [
+    ...decls.length > 0 ? [
+      "",
+      ...decls
+    ] : [],
+    ...[
+      ...inlineRevivers.values()
+    ].flatMap((decl) => [
+      "",
+      ...decl
+    ])
+  ];
   return {
     lines,
-    methodNames
+    methodNames,
+    preludeLines,
+    needsDecimalImport: decls.length > 0
   };
 }
 __name(generateClientMethods, "generateClientMethods");
-function generateMethod(route, op, file, options) {
+function decimalPreludeFor(declLines) {
+  if (!declLines.some((l) => l.includes("__dec("))) return {
+    imports: [],
+    decls: []
+  };
+  return {
+    imports: [
+      DECIMAL_IMPORT
+    ],
+    decls: [
+      DECIMAL_CONFIG_LINE,
+      "",
+      ...DECIMAL_COERCE_DECL
+    ]
+  };
+}
+__name(decimalPreludeFor, "decimalPreludeFor");
+function usedRevivers(lines) {
+  const found = /* @__PURE__ */ new Set();
+  for (const m of lines.join("\n").matchAll(/\brevive[A-Z]\w*/g)) found.add(m[0]);
+  return [
+    ...found
+  ].sort();
+}
+__name(usedRevivers, "usedRevivers");
+function generateMethod(route, op, file, options, inlineRevivers) {
+  const revive = options.modelsWithDecimal && options.modelsWithDecimal.size > 0 && inlineRevivers ? {
+    modelsWithDecimal: options.modelsWithDecimal,
+    modelsWithOutput: options.modelsWithOutput,
+    modelMap: options.modelMap,
+    inlineRevivers,
+    nameHint: ""
+  } : void 0;
   const lines = [];
   const methodName = deriveMethodName(op, route);
+  const mRevive = hint(revive, `${methodName.charAt(0).toUpperCase()}${methodName.slice(1)}`);
   const httpMethod = op.method.toUpperCase();
   const { modelsWithInput, modelsWithOutput } = options;
   const params = buildMethodParams(route, op, modelsWithInput);
@@ -2227,23 +2635,23 @@ function generateMethod(route, op, file, options) {
     lines.push(`        switch (result.status) {`);
     for (const resp of rest) {
       lines.push(`            case ${resp.statusCode}:`);
-      lines.push(...sdkReturnLines(resp, modelsWithOutput, "                ", true));
+      lines.push(...sdkReturnLines(resp, modelsWithOutput, "                ", true, mRevive));
     }
     lines.push(`            default:`);
-    lines.push(...sdkReturnLines(fallback, modelsWithOutput, "                ", true));
+    lines.push(...sdkReturnLines(fallback, modelsWithOutput, "                ", true, mRevive));
     lines.push(`        }`);
   } else if (primaryBodies.length > 1) {
-    lines.push(...sdkReturnLines(primaryResponse, modelsWithOutput, "        ", false));
+    lines.push(...sdkReturnLines(primaryResponse, modelsWithOutput, "        ", false, mRevive));
   } else if (hasRespHeaders) {
     const headerEntries = sdkHeaderEntries(respHeaders);
     if (isVoid) {
       lines.push(`        return { headers: { ${headerEntries} } };`);
     } else {
-      lines.push(`        const data = ${sdkReadExpr(primaryBodies[0], modelsWithOutput)};`);
+      lines.push(`        const data = ${sdkReadExpr(primaryBodies[0], modelsWithOutput, hint(mRevive, primaryResponse.statusCode))};`);
       lines.push(`        return { data, headers: { ${headerEntries} } };`);
     }
   } else if (!isVoid) {
-    lines.push(`        return ${sdkReadExpr(primaryBodies[0], modelsWithOutput)};`);
+    lines.push(`        return ${sdkReadExpr(primaryBodies[0], modelsWithOutput, hint(mRevive, primaryResponse.statusCode))};`);
   }
   lines.push("    }");
   return lines;
@@ -2256,13 +2664,59 @@ function sdkDataType(body, modelsWithOutput) {
   return renderOutputTsType(body.bodyType, modelsWithOutput);
 }
 __name(sdkDataType, "sdkDataType");
-function sdkReadExpr(body, modelsWithOutput) {
+function sdkReadExpr(body, modelsWithOutput, revive) {
   const category = classifyContentType2(body.contentType);
   if (category === "text") return "await result.text()";
   if (category === "binary") return "await result.blob()";
-  return `await parseJson<${renderOutputTsType(body.bodyType, modelsWithOutput)}>(result)`;
+  const tsType = renderOutputTsType(body.bodyType, modelsWithOutput);
+  const read = `await parseJson<${tsType}>(result)`;
+  const reviver = reviveExprFor(body.bodyType, revive);
+  if (!reviver) return read;
+  return reviver.kind === "array" ? `(${read}).map(${reviver.name})` : `${reviver.name}(${read})`;
 }
 __name(sdkReadExpr, "sdkReadExpr");
+function hint(revive, segment) {
+  if (!revive) return void 0;
+  return {
+    ...revive,
+    nameHint: `${revive.nameHint}${segment}`
+  };
+}
+__name(hint, "hint");
+function reviveExprFor(bodyType, ctx) {
+  if (!ctx || ctx.modelsWithDecimal.size === 0) return null;
+  const opts = {
+    modelsWithDecimal: ctx.modelsWithDecimal,
+    modelsWithOutput: ctx.modelsWithOutput,
+    modelMap: ctx.modelMap
+  };
+  if (!typeReachesDecimal(bodyType, opts)) return null;
+  const refName = /* @__PURE__ */ __name((t) => t.kind === "ref" ? t.name : t.kind === "lazy" ? refName(t.inner) : null, "refName");
+  const pick = /* @__PURE__ */ __name((name) => reviveFnName(name, ctx.modelsWithOutput?.has(name) ? "output" : "base"), "pick");
+  const direct = refName(bodyType);
+  if (direct && ctx.modelsWithDecimal.has(direct)) return {
+    name: pick(direct),
+    kind: "value"
+  };
+  if (bodyType.kind === "array") {
+    const item = refName(bodyType.item);
+    if (item && ctx.modelsWithDecimal.has(item)) return {
+      name: pick(item),
+      kind: "array"
+    };
+  }
+  const fnName = `__revive${ctx.nameHint}`;
+  if (!ctx.inlineRevivers.has(fnName)) {
+    const decl = renderInlineReviver(fnName, renderOutputTsType(bodyType, ctx.modelsWithOutput), bodyType, opts);
+    if (!decl) return null;
+    ctx.inlineRevivers.set(fnName, decl);
+  }
+  return {
+    name: fnName,
+    kind: "value"
+  };
+}
+__name(reviveExprFor, "reviveExprFor");
 function renderSdkHeadersShape(headers, modelsWithOutput) {
   const fields = headers.map((h) => `${quoteKey(headerNameToProperty(h.name))}${h.optional ? "?" : ""}: ${renderOutputTsType(h.type, modelsWithOutput)}`);
   return `{ ${fields.join("; ")} }`;
@@ -2309,7 +2763,7 @@ function sdkResponseMembers(resp, modelsWithOutput, includeStatus) {
   ].join("; ")} }`);
 }
 __name(sdkResponseMembers, "sdkResponseMembers");
-function sdkReturnLines(resp, modelsWithOutput, indent, includeStatus) {
+function sdkReturnLines(resp, modelsWithOutput, indent, includeStatus, revive) {
   const bodies = resp.bodies;
   const headers = resp.headers ?? [];
   const leading = includeStatus ? [
@@ -2330,7 +2784,7 @@ function sdkReturnLines(resp, modelsWithOutput, indent, includeStatus) {
     const fields = [
       ...leading,
       `contentType: '${bodies[0].contentType}'`,
-      `data: ${sdkReadExpr(bodies[0], modelsWithOutput)}`,
+      `data: ${sdkReadExpr(bodies[0], modelsWithOutput, hint(revive, resp.statusCode))}`,
       ...trailing
     ];
     return [
@@ -2343,7 +2797,7 @@ function sdkReturnLines(resp, modelsWithOutput, indent, includeStatus) {
     const fields = [
       ...leading,
       `contentType: readContentType(result) as ${cast}`,
-      `data: ${sdkReadExpr(bodies[0], modelsWithOutput)}`,
+      `data: ${sdkReadExpr(bodies[0], modelsWithOutput, hint(revive, resp.statusCode))}`,
       ...trailing
     ];
     return [
@@ -2353,11 +2807,11 @@ function sdkReturnLines(resp, modelsWithOutput, indent, includeStatus) {
   const lines = [
     `${indent}switch (readContentType(result)) {`
   ];
-  for (const body of bodies.slice(1)) {
+  for (const [i, body] of bodies.slice(1).entries()) {
     const fields = [
       ...leading,
       `contentType: '${body.contentType}'`,
-      `data: ${sdkReadExpr(body, modelsWithOutput)}`,
+      `data: ${sdkReadExpr(body, modelsWithOutput, hint(revive, `${resp.statusCode}_${i + 1}`))}`,
       ...trailing
     ];
     lines.push(`${indent}    case '${body.contentType}':`);
@@ -2367,7 +2821,7 @@ function sdkReturnLines(resp, modelsWithOutput, indent, includeStatus) {
   const fallbackFields = [
     ...leading,
     `contentType: '${first.contentType}'`,
-    `data: ${sdkReadExpr(first, modelsWithOutput)}`,
+    `data: ${sdkReadExpr(first, modelsWithOutput, hint(revive, `${resp.statusCode}_0`))}`,
     ...trailing
   ];
   lines.push(`${indent}    default:`);
@@ -2821,7 +3275,7 @@ function collectTypeNodeRefs2(type, out) {
   }
 }
 __name(collectTypeNodeRefs2, "collectTypeNodeRefs");
-function generateTypeImports2(types, opFile, options) {
+function generateTypeImports2(types, opFile, options, revivers = []) {
   const lines = [];
   const { modelOutPaths, outPath } = options;
   if (modelOutPaths && outPath) {
@@ -2843,6 +3297,8 @@ function generateTypeImports2(types, opFile, options) {
       rel = rel.replace(/\.ts$/, ".js");
       if (!rel.startsWith(".")) rel = "./" + rel;
       lines.push(`import type { ${names.sort().join(", ")} } from '${rel}';`);
+      const fromHere = revivers.filter((r) => modelOutPaths.get(reviverModelName(r, names)) === typeOutPath);
+      if (fromHere.length > 0) lines.push(`import { ${fromHere.sort().join(", ")} } from '${rel}';`);
     }
     for (const type of unresolved) {
       const moduleName = pascalToDotCase(type);
@@ -2855,6 +3311,13 @@ function generateTypeImports2(types, opFile, options) {
   return lines;
 }
 __name(generateTypeImports2, "generateTypeImports");
+function reviverModelName(reviver, namesInModule) {
+  const stem = reviver.replace(/^revive/, "");
+  if (namesInModule.includes(stem)) return stem;
+  const base = stem.replace(/Output$/, "");
+  return namesInModule.includes(base) ? base : stem;
+}
+__name(reviverModelName, "reviverModelName");
 function deriveTypeImportPath2(file, template) {
   const base = file.split("/").pop()?.replace(/\.(op|ck)$/, "") ?? "resource";
   const module = base.split(".")[0] ?? base;
@@ -2960,6 +3423,7 @@ __name(generateSdkOptions, "generateSdkOptions");
 var SCAFFOLD_DEP_VERSIONS = {
   zod: "^4.3.6",
   luxon: "^3.5.0",
+  decimalJs: "^10.4.3",
   typesLuxon: "^3.4.2",
   typescript: "^6.0.3"
 };
@@ -2967,6 +3431,7 @@ function generateSdkPackageJson(input) {
   const dependencies = {};
   if (input.deps.zod) dependencies.zod = SCAFFOLD_DEP_VERSIONS.zod;
   if (input.deps.luxon) dependencies.luxon = SCAFFOLD_DEP_VERSIONS.luxon;
+  if (input.deps.decimal) dependencies["decimal.js"] = SCAFFOLD_DEP_VERSIONS.decimalJs;
   const devDependencies = {
     typescript: SCAFFOLD_DEP_VERSIONS.typescript
   };
@@ -3026,6 +3491,9 @@ function generateAreaClient(input) {
   const { area, outPath, inlineFiles, subareaClients, sdkOptionsPath } = input;
   const className = deriveAreaClientClassName(area);
   const collectedMethodLines = [];
+  const collectedRevivePrelude = [];
+  let areaNeedsDecimalImport = false;
+  const reviversByImportPath = /* @__PURE__ */ new Map();
   const collectedErrorAliases = /* @__PURE__ */ new Set();
   const seenMethods = /* @__PURE__ */ new Set();
   const typesByImportPath = /* @__PURE__ */ new Map();
@@ -3037,7 +3505,9 @@ function generateAreaClient(input) {
   let needsReadContentType = false;
   for (const inline of inlineFiles) {
     const includeInternal = inline.codegenOptions.includeInternal ?? false;
-    const { lines: methodLines, methodNames } = generateClientMethods(inline.root, inline.codegenOptions);
+    const { lines: methodLines, methodNames, preludeLines, needsDecimalImport } = generateClientMethods(inline.root, inline.codegenOptions);
+    collectedRevivePrelude.push(...preludeLines);
+    if (needsDecimalImport) areaNeedsDecimalImport = true;
     for (const name of methodNames) {
       if (seenMethods.has(name)) {
         throw new Error(`[sdk] duplicate method '${name}' in area '${area}': two area-level files contribute the same method. Disambiguate via 'sdk:' or move one into a subarea.`);
@@ -3051,6 +3521,16 @@ function generateAreaClient(input) {
     if (sdkNeedsBigIntReviver(inline.root, includeInternal)) needsBigIntReviver = true;
     if (sdkNeedsQueryString(inline.root, includeInternal)) needsQueryString = true;
     if (sdkNeedsReadContentType(inline.root, includeInternal)) needsReadContentType = true;
+    for (const reviver of usedRevivers(methodLines)) {
+      const stem = reviver.replace(/^revive/, "");
+      const modelOut = inline.codegenOptions.modelOutPaths?.get(stem) ?? inline.codegenOptions.modelOutPaths?.get(stem.replace(/Output$/, ""));
+      if (!modelOut) continue;
+      let rel = relative3(dirname3(outPath), modelOut).replace(/\.ts$/, ".js");
+      if (!rel.startsWith(".")) rel = "./" + rel;
+      const set = reviversByImportPath.get(rel) ?? /* @__PURE__ */ new Set();
+      set.add(reviver);
+      reviversByImportPath.set(rel, set);
+    }
     const typesForFile = collectTypes2(inline.root, inline.codegenOptions.modelsWithInput, inline.codegenOptions.modelsWithOutput, includeInternal);
     const { modelOutPaths } = inline.codegenOptions;
     if (modelOutPaths) {
@@ -3089,12 +3569,17 @@ function generateAreaClient(input) {
       ...typesByImportPath.get(path)
     ].sort();
     lines.push(`import type { ${names.join(", ")} } from '${path}';`);
+    const revivers = reviversByImportPath.get(path);
+    if (revivers && revivers.size > 0) lines.push(`import { ${[
+      ...revivers
+    ].sort().join(", ")} } from '${path}';`);
   }
   for (const t of [
     ...unresolvedTypes
   ].sort()) {
     lines.push(`import type { ${t} } from './${pascalToDotCase(t)}.js';`);
   }
+  if (areaNeedsDecimalImport) lines.push(DECIMAL_IMPORT);
   const importedClients = /* @__PURE__ */ new Set();
   for (const sc of subareaClients) {
     const key = `${sc.client.className}|${sc.client.importPath}`;
@@ -3107,6 +3592,10 @@ function generateAreaClient(input) {
     lines.push(...collectedErrorAliases);
     lines.push("");
   }
+  if (collectedRevivePrelude.length > 0) {
+    lines.push(...collectedRevivePrelude);
+    lines.push("");
+  }
   lines.push(`export class ${className} {`);
   for (const sc of subareaClients) {
     lines.push(`    readonly ${sc.propertyName}: ${sc.client.className};`);
@@ -3193,9 +3682,14 @@ function generatePlainTypes(root, context) {
       ...externalOutputRefs
     ])
   ].sort();
+  const needsDecimal = rootNeedsScalar(root, "decimal") || (context?.emitRevivers && context.modelsWithDecimal ? root.models.some((m) => context.modelsWithDecimal.has(m.name)) : false);
+  if (needsDecimal) lines.push(DECIMAL_IMPORT);
   for (const ref of allExternalRefs) {
     const importPath = resolveImportPath(ref, context);
     lines.push(`import type { ${ref} } from '${importPath}';`);
+    if (context?.emitRevivers && context.modelsWithDecimal?.has(ref)) {
+      lines.push(`import { ${reviveFnName(ref)} } from '${importPath}';`);
+    }
   }
   if (allExternalRefs.length > 0) lines.push("");
   if (rootNeedsScalar(root, "json")) {
@@ -3210,10 +3704,32 @@ function generatePlainTypes(root, context) {
     m.name,
     m
   ]));
+  const reviveOpts = context?.emitRevivers && context.modelsWithDecimal ? {
+    modelsWithDecimal: context.modelsWithDecimal,
+    modelsWithOutput: allModelsWithOutput,
+    modelMap
+  } : void 0;
+  const bodyLines = [];
   for (const model of topoSortModels(root.models)) {
-    lines.push(...generateModel2(model, target, context?.currentOutPath, allModelsWithInput, allModelsWithOutput, modelMap));
+    bodyLines.push(...generateModel2(model, target, context?.currentOutPath, allModelsWithInput, allModelsWithOutput, modelMap));
+    if (reviveOpts) {
+      const revivers = renderReviveFunctions(model, reviveOpts);
+      if (revivers.length > 0) {
+        bodyLines.push("");
+        bodyLines.push(...revivers);
+      }
+    }
+    bodyLines.push("");
+  }
+  if (needsDecimal) {
+    lines.push("");
+    lines.push(DECIMAL_CONFIG_LINE);
+  }
+  if (bodyLines.some((l) => l.includes("__dec("))) {
+    lines.push(...DECIMAL_COERCE_DECL);
     lines.push("");
   }
+  lines.push(...bodyLines);
   return lines.join("\n");
 }
 __name(generatePlainTypes, "generatePlainTypes");
@@ -3652,6 +4168,9 @@ function scalarHelperLines(body) {
   if (body.includes("_ZodDatetime")) {
     lines.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 (body.includes("_ZodDecimal")) {
+    lines.push(...DECIMAL_PRELUDE_LINES);
+  }
   if (body.includes("_ZodInterval")) {
     lines.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()!);`);
   }
@@ -3765,6 +4284,7 @@ function generateMcpFile(root, options = {}) {
   if (/\bInterval\b/.test(bodyWithHelpers)) luxon.push("Interval");
   if (/\bDuration\b/.test(bodyWithHelpers)) luxon.push("Duration");
   if (luxon.length > 0) imports.push(`import { ${luxon.join(", ")} } from 'luxon';`);
+  if (/\bDecimal\b/.test(bodyWithHelpers)) imports.push(DECIMAL_IMPORT);
   imports.push(`import type { CallToolResult, Tool } from '@modelcontextprotocol/sdk/types.js';`);
   imports.push(`import type { McpToolHandler, McpToolHandlerMap, McpToolContext } from '@maroonedsoftware/mcp';`);
   if (needsParseAndValidate) imports.push(`import { parseAndValidate } from '@maroonedsoftware/zod';`);
@@ -4061,7 +4581,14 @@ function createTypescriptPlugin(config, rootDir) {
   };
 }
 __name(createTypescriptPlugin, "createTypescriptPlugin");
+function assertValidConfig(config) {
+  if (config.server?.validateResponses && !config.server.zod) {
+    throw new Error("plugin-typescript: server.validateResponses requires server.zod: true \u2014 without it output.types emits plain TypeScript interfaces, which are types with no runtime schema value for the router to validate against.");
+  }
+}
+__name(assertValidConfig, "assertValidConfig");
 async function runTypescriptCodegen(inputs, ctx, config, rootDir) {
+  assertValidConfig(config);
   const manifestPath = resolve2(ctx.cacheDir, CACHE_MANIFEST_FILENAME);
   const prevManifest = ctx.cacheEnabled ? readManifest(manifestPath) : emptyIncrementalManifest(TYPESCRIPT_CODEGEN_VERSION);
   const units = [];
@@ -4178,6 +4705,7 @@ function collectServerOutput(config, rootDir, inputs, units) {
   const serverBase = resolve2(rootDir, config.baseDir ?? ".");
   const modelsWithInput = inputs.modelsWithInput;
   const modelsWithOutput = inputs.modelsWithOutput;
+  const modelsWithTransform = computeModelsWithCaseTransform(inputs.contractRoots.flatMap((r) => r.models));
   const modelMap = buildModelMap(inputs.contractRoots);
   const allFiles = [
     ...inputs.contractRoots.map((r) => r.file),
@@ -4250,6 +4778,10 @@ function collectServerOutput(config, rootDir, inputs, units) {
       modelsWithOutput: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithOutput),
       servicePathTemplate: config.servicePathTemplate ?? null,
       includeInternal: config.includeInternal ?? true,
+      // Not covered by `sub`: adding `format(input=snake)` to a *different* .ck file changes
+      // this router's output with no change to `root` or the config.
+      modelsWithTransform: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithTransform),
+      validateResponses: config.validateResponses ?? false,
       sub: subConfigKey
     });
     units.push({
@@ -4264,7 +4796,9 @@ function collectServerOutput(config, rootDir, inputs, units) {
             modelOutPaths: serverModelOutPaths,
             modelsWithInput,
             modelsWithOutput,
-            includeInternal: config.includeInternal
+            modelsWithTransform,
+            includeInternal: config.includeInternal,
+            validateResponses: config.validateResponses
           })
         }
       ], "render")
@@ -4283,6 +4817,7 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
   const subConfigKey = stableSubConfig(config);
   const modelsWithInput = inputs.modelsWithInput;
   const modelsWithOutput = inputs.modelsWithOutput;
+  const modelsWithDecimal = computeModelsWithDecimal(inputs.contractRoots.flatMap((r) => r.models));
   const modelMap = buildModelMap(inputs.contractRoots);
   const allFiles = [
     ...inputs.contractRoots.map((r) => r.file),
@@ -4322,6 +4857,9 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
       outPathSlice: sliceOutPathMap(refs, sdkModelOutPaths, modelsWithInput, modelsWithOutput),
       modelsWithInput: sliceModelSet(refs, ownNames, modelsWithInput),
       modelsWithOutput: sliceModelSet(refs, ownNames, modelsWithOutput),
+      // Not covered by `root`: adding a decimal to a model in a *different* .ck file changes
+      // this file's revivers with no change to `root` or the config.
+      modelsWithDecimal: sliceModelSet(refs, ownNames, modelsWithDecimal),
       sdkOptionsPath,
       sub: subConfigKey
     });
@@ -4335,7 +4873,9 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
             modelOutPaths: sdkModelOutPaths,
             currentOutPath: typeOutPath,
             modelsWithInput,
-            modelsWithOutput
+            modelsWithOutput,
+            modelsWithDecimal,
+            emitRevivers: true
           });
         } else {
           let rel = relative7(dirname7(typeOutPath), sdkOptionsPath).replace(/\.ts$/, ".js");
@@ -4345,6 +4885,8 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
             currentOutPath: typeOutPath,
             modelsWithInput,
             modelsWithOutput,
+            modelsWithDecimal,
+            emitRevivers: true,
             jsonValueImportPath: rel
           });
         }
@@ -4406,6 +4948,7 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
           outPathSlice: sliceOutPathMap(refs, sdkModelOutPaths, modelsWithInput, modelsWithOutput),
           modelsWithInput: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithInput),
           modelsWithOutput: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithOutput),
+          modelsWithDecimal: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithDecimal),
           sdkOptionsPath,
           className,
           includeInternal: config.includeInternal ?? false,
@@ -4424,6 +4967,8 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
                 sdkOptionsPath,
                 modelsWithInput,
                 modelsWithOutput,
+                modelsWithDecimal,
+                modelMap,
                 includeInternal: config.includeInternal,
                 clientClassName: className
               })
@@ -4448,6 +4993,7 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
         outPathSlice: sliceOutPathMap(refs, sdkModelOutPaths, modelsWithInput, modelsWithOutput),
         modelsWithInput: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithInput),
         modelsWithOutput: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithOutput),
+        modelsWithDecimal: sliceModelSet(refs, /* @__PURE__ */ new Set(), modelsWithDecimal),
         sdkOptionsPath,
         includeInternal: config.includeInternal ?? false,
         sub: subConfigKey
@@ -4465,6 +5011,8 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
               sdkOptionsPath,
               modelsWithInput,
               modelsWithOutput,
+              modelsWithDecimal,
+              modelMap,
               includeInternal: config.includeInternal
             })
           }
@@ -4533,6 +5081,7 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
         outPathSlice: sliceOutPathMap(allInlineRefs, sdkModelOutPaths, modelsWithInput, modelsWithOutput),
         modelsWithInput: sliceModelSet(allInlineRefs, /* @__PURE__ */ new Set(), modelsWithInput),
         modelsWithOutput: sliceModelSet(allInlineRefs, /* @__PURE__ */ new Set(), modelsWithOutput),
+        modelsWithDecimal: sliceModelSet(allInlineRefs, /* @__PURE__ */ new Set(), modelsWithDecimal),
         sdkOptionsPath,
         includeInternal: config.includeInternal ?? false,
         sub: subConfigKey
@@ -4546,6 +5095,8 @@ function collectSdkOutput(config, rootDir, inputs, units, globalFiles) {
           sdkOptionsPath,
           modelsWithInput,
           modelsWithOutput,
+          modelsWithDecimal,
+          modelMap,
           includeInternal: config.includeInternal
         }
       }));
@@ -4614,7 +5165,17 @@ ${rootExports.sort().join("\n")}
     const coveredRoots = sdkContractEntries.map((e) => e.ast);
     const deps = {
       zod: !!config.zod,
-      luxon: coveredRoots.some((r) => rootNeedsScalar(r, "datetime") || rootNeedsScalar(r, "date") || rootNeedsScalar(r, "time") || rootNeedsScalar(r, "interval"))
+      // `duration` belongs here too: `generateContract` imports `Duration` from luxon for it,
+      // so a contract whose only temporal scalar is a duration used to scaffold a package.json
+      // with no luxon dependency and fail to compile.
+      luxon: coveredRoots.some((r) => [
+        "datetime",
+        "date",
+        "time",
+        "duration",
+        "interval"
+      ].some((name) => rootNeedsScalar(r, name))),
+      decimal: coveredRoots.some((r) => rootNeedsScalar(r, "decimal"))
     };
     globalFiles.push({
       relativePath: join2(sdkBase, "package.json"),