@ic-reactor/codegen 0.11.0 → 0.12.0

package/dist/renderer.d.cts

@@ -0,0 +1,33 @@
+import { CandidSchema, CandidType, CandidTypeDeclaration } from '@ic-reactor/parser';
+
+type JSDocFormatDefinition = {
+    regex?: string;
+    errorMessage?: string;
+    jsonSchemaFormat?: string;
+    contentEncoding?: string;
+};
+type CustomJSDocFormatTypes = Record<string, string | JSDocFormatDefinition>;
+declare const BUILT_IN_JSDOC_FORMAT_TYPES: Readonly<Record<string, JSDocFormatDefinition>>;
+declare const BUILT_IN_FORMAT_HELPERS: Readonly<Record<string, string>>;
+
+interface GenerateCodecDeclarationsOptions {
+    /**
+     * Canister name used to derive the service export name.
+     * Converted to SCREAMING_SNAKE_CASE (e.g. `"my-backend"` → `MY_BACKEND`).
+     * Ignored when `serviceExportName` is set explicitly.
+     */
+    canisterName?: string;
+    /** Explicit service export name. Takes priority over `canisterName`. */
+    serviceExportName?: string;
+    customJSDocFormatTypes?: CustomJSDocFormatTypes;
+    includeCompatibilityExports?: boolean;
+}
+declare function sortDeclarations(declarations: CandidTypeDeclaration[]): CandidTypeDeclaration[];
+declare function renderType(type: CandidType, indent?: string, options?: GenerateCodecDeclarationsOptions): string;
+/**
+ * Converts a structured CandidSchema AST into readable `@ic-reactor/cod`
+ * codec declarations.
+ */
+declare function generateCodecDeclarations(schema: CandidSchema, optionsOrServiceExportName?: string | GenerateCodecDeclarationsOptions): string;
+
+export { BUILT_IN_FORMAT_HELPERS, BUILT_IN_JSDOC_FORMAT_TYPES, type CustomJSDocFormatTypes, type GenerateCodecDeclarationsOptions, type JSDocFormatDefinition, generateCodecDeclarations, renderType, sortDeclarations };

package/dist/renderer.d.ts

@@ -0,0 +1,33 @@
+import { CandidSchema, CandidType, CandidTypeDeclaration } from '@ic-reactor/parser';
+
+type JSDocFormatDefinition = {
+    regex?: string;
+    errorMessage?: string;
+    jsonSchemaFormat?: string;
+    contentEncoding?: string;
+};
+type CustomJSDocFormatTypes = Record<string, string | JSDocFormatDefinition>;
+declare const BUILT_IN_JSDOC_FORMAT_TYPES: Readonly<Record<string, JSDocFormatDefinition>>;
+declare const BUILT_IN_FORMAT_HELPERS: Readonly<Record<string, string>>;
+
+interface GenerateCodecDeclarationsOptions {
+    /**
+     * Canister name used to derive the service export name.
+     * Converted to SCREAMING_SNAKE_CASE (e.g. `"my-backend"` → `MY_BACKEND`).
+     * Ignored when `serviceExportName` is set explicitly.
+     */
+    canisterName?: string;
+    /** Explicit service export name. Takes priority over `canisterName`. */
+    serviceExportName?: string;
+    customJSDocFormatTypes?: CustomJSDocFormatTypes;
+    includeCompatibilityExports?: boolean;
+}
+declare function sortDeclarations(declarations: CandidTypeDeclaration[]): CandidTypeDeclaration[];
+declare function renderType(type: CandidType, indent?: string, options?: GenerateCodecDeclarationsOptions): string;
+/**
+ * Converts a structured CandidSchema AST into readable `@ic-reactor/cod`
+ * codec declarations.
+ */
+declare function generateCodecDeclarations(schema: CandidSchema, optionsOrServiceExportName?: string | GenerateCodecDeclarationsOptions): string;
+
+export { BUILT_IN_FORMAT_HELPERS, BUILT_IN_JSDOC_FORMAT_TYPES, type CustomJSDocFormatTypes, type GenerateCodecDeclarationsOptions, type JSDocFormatDefinition, generateCodecDeclarations, renderType, sortDeclarations };

package/dist/renderer.js

@@ -0,0 +1,14 @@
+import {
+  BUILT_IN_FORMAT_HELPERS,
+  BUILT_IN_JSDOC_FORMAT_TYPES,
+  generateCodecDeclarations,
+  renderType,
+  sortDeclarations
+} from "./chunk-VBCR5IVT.js";
+export {
+  BUILT_IN_FORMAT_HELPERS,
+  BUILT_IN_JSDOC_FORMAT_TYPES,
+  generateCodecDeclarations,
+  renderType,
+  sortDeclarations
+};

package/llms.txt

@@ -0,0 +1,28 @@
+# @ic-reactor/codegen — AI Quick Guide
+
+Shared generation pipeline used by `@ic-reactor/cli` and
+`@ic-reactor/vite-plugin`.
+
+## Install
+
+Most apps should install CLI or Vite plugin instead of this package directly.
+
+```bash
+pnpm add -D @ic-reactor/codegen
+```
+
+## Main Use Case
+
+Use `runCanisterPipeline(...)` when you need programmatic generation in custom
+tooling/automation.
+
+## Generated File Model
+
+- `index.generated.ts` is managed output
+- `index.ts` is a stable wrapper
+- app-specific logic should live in wrappers or adjacent modules
+
+## Full References
+
+- Full AI guide: https://ic-reactor.b3pay.net/llms-full.txt
+- Codegen docs: https://ic-reactor.b3pay.net/v3/packages/codegen

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ic-reactor/codegen",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Shared code generation utilities for IC Reactor",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -8,14 +8,32 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
-    }
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./renderer": {
+      "import": {
+        "types": "./dist/renderer.d.ts",
+        "default": "./dist/renderer.js"
+      },
+      "require": {
+        "types": "./dist/renderer.d.cts",
+        "default": "./dist/renderer.cjs"
+      }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "README.md",
+    "llms.txt"
   ],
   "keywords": [
     "internet-computer",
@@ -32,21 +50,22 @@
     "url": "git+https://github.com/B3Pay/ic-reactor.git",
     "directory": "packages/codegen"
   },
+  "homepage": "https://ic-reactor.b3pay.net/v3/packages/codegen",
   "dependencies": {
     "change-case": "^5.4.4",
-    "@ic-reactor/parser": "0.4.6"
+    "@ic-reactor/parser": "0.4.7"
   },
   "devDependencies": {
-    "@types/node": "^25.5.2",
+    "@types/node": "^26.1.1",
     "tsup": "^8.5.1",
-    "typescript": "^5.9.3",
-    "vitest": "^4.1.2"
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --tsconfig tsconfig.json",
-    "dev": "tsup src/index.ts --format esm,cjs --dts --watch --tsconfig tsconfig.json",
+    "build": "tsup src/index.ts src/renderer.ts --format esm,cjs --dts --tsconfig tsconfig.json",
+    "dev": "tsup src/index.ts src/renderer.ts --format esm,cjs --dts --watch --tsconfig tsconfig.json",
     "test": "vitest run",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json"
   }
 }

package/src/__snapshots__/reactor.test.ts.snap

@@ -13,6 +13,9 @@ export type BackendService = _SERVICE
  *
  * Auto-generated by @ic-reactor/codegen — do not edit.
  * This file is overwritten whenever generation runs.
+ *
+ * Keep app-specific logic in the stable \`index.ts\` wrapper (or adjacent
+ * factory modules). Avoid editing this managed file directly.
  */
 export const backendReactor = new DisplayReactor<BackendService>({
   clientManager,
@@ -44,6 +47,9 @@ export type WorkflowEngineService = _SERVICE
  *
  * Auto-generated by @ic-reactor/codegen — do not edit.
  * This file is overwritten whenever generation runs.
+ *
+ * Keep app-specific logic in the stable \`index.ts\` wrapper (or adjacent
+ * factory modules). Avoid editing this managed file directly.
  */
 export const workflowEngineReactor = new Reactor<WorkflowEngineService>({
   clientManager,
@@ -75,6 +81,9 @@ export type LedgerService = _SERVICE
  *
  * Auto-generated by @ic-reactor/codegen — do not edit.
  * This file is overwritten whenever generation runs.
+ *
+ * Keep app-specific logic in the stable \`index.ts\` wrapper (or adjacent
+ * factory modules). Avoid editing this managed file directly.
  */
 export const ledgerReactor = new MetadataDisplayReactor<LedgerService>({
   clientManager,
@@ -105,6 +114,9 @@ export type BackendService = _SERVICE
  *
  * Auto-generated by @ic-reactor/codegen — do not edit.
  * This file is overwritten whenever generation runs.
+ *
+ * Keep app-specific logic in the stable \`index.ts\` wrapper (or adjacent
+ * factory modules). Avoid editing this managed file directly.
  */
 export const backendReactor = new DisplayReactor<BackendService>({
   clientManager,

package/src/bindgen.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest"
 import fs from "node:fs"
 import path from "node:path"
-import { generateDeclarations } from "./generators"
+import { generateDeclarations } from "./generators/index.js"
 
 describe("Bindgen", () => {
   const mockDidFile = "mock/test.did"

package/src/generators/client.ts

@@ -43,7 +43,6 @@ ${queryClientImport}
  */
 export const clientManager = new ClientManager({
   queryClient,
-  withCanisterEnv: true,
 })
 `
 }

package/src/generators/reactor.ts

@@ -116,6 +116,9 @@ export type ${serviceName} = _SERVICE
  *
  * Auto-generated by @ic-reactor/codegen — do not edit.
  * This file is overwritten whenever generation runs.
+ *
+ * Keep app-specific logic in the stable \`index.ts\` wrapper (or adjacent
+ * factory modules). Avoid editing this managed file directly.
  */
 export const ${reactorName} = new ${reactorClass}<${serviceName}>({
   clientManager,
@@ -133,6 +136,15 @@ export function generateReactorEntryFile(): string {
  *
  * Created once by @ic-reactor/codegen and safe to customize.
  * Keep the re-export below if you want generated exports and types to stay in sync.
+ *
+ * Recommended customization points:
+ * - define reusable query/mutation factories
+ * - add app-specific hooks and cache invalidation wiring
+ * - compose generated APIs into route loaders/actions
+ *
+ * Do not edit \`index.generated.ts\`; it is regenerated on each codegen run.
+ * AI guide: https://ic-reactor.b3pay.net/llms-full.txt
+ * Skill install: npx skills add B3Pay/ic-reactor-skills --full-depth --skill ic-reactor-hooks
  */
 export * from "./index.generated"
 `

package/src/index.ts

@@ -26,3 +26,6 @@ export type { MethodInfo, MethodType } from "./parser.js"
 
 // Individual Generators (Advanced Usage)
 export * from "./generators/index.js"
+
+// Renderer (Candid Codec)
+export { generateCodecDeclarations } from "./renderer.js"

package/src/metadata-rules.json

@@ -0,0 +1,144 @@
+{
+  "defaultValidationMessages": {
+    "minimum": {
+      "template": "Must be at least {value}"
+    },
+    "maximum": {
+      "template": "Must be at most {value}"
+    },
+    "minLength": {
+      "template": "Must be at least {value} character{plural}"
+    },
+    "maxLength": {
+      "template": "Must be at most {value} character{plural}"
+    }
+  },
+  "email": {
+    "helper": "email",
+    "regex": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
+    "jsonSchemaFormat": "email",
+    "errorMessage": "Must be a valid email address"
+  },
+  "date-time": {
+    "helper": "dateTime",
+    "regex": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d))$",
+    "jsonSchemaFormat": "date-time",
+    "errorMessage": "Must be a valid ISO datetime"
+  },
+  "datetime": {
+    "helper": "datetime",
+    "regex": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|[+-](?:[01]\\d|2[0-3]):[0-5]\\d))$",
+    "jsonSchemaFormat": "date-time",
+    "errorMessage": "Must be a valid ISO datetime"
+  },
+  "date": {
+    "helper": "date",
+    "regex": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+    "jsonSchemaFormat": "date",
+    "errorMessage": "Must be a valid ISO date"
+  },
+  "time": {
+    "helper": "time",
+    "regex": "^(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?$",
+    "errorMessage": "Must be a valid ISO time"
+  },
+  "duration": {
+    "helper": "duration",
+    "regex": "^P(?:(\\d+W)|(?!.*W)(?=\\d|T\\d)(\\d+Y)?(\\d+M)?(\\d+D)?(T(?=\\d)(\\d+H)?(\\d+M)?(\\d+([.,]\\d+)?S)?)?)$",
+    "jsonSchemaFormat": "duration",
+    "errorMessage": "Must be a valid ISO duration"
+  },
+  "url": {
+    "helper": "url",
+    "regex": "^[a-zA-Z][a-zA-Z\\d+.-]*:.+",
+    "jsonSchemaFormat": "uri",
+    "errorMessage": "Must be a valid URL"
+  },
+  "uri": {
+    "helper": "uri",
+    "regex": "^[a-zA-Z][a-zA-Z\\d+.-]*:.+",
+    "jsonSchemaFormat": "uri",
+    "errorMessage": "Must be a valid URI"
+  },
+  "httpsUrl": {
+    "helper": "httpsUrl",
+    "regex": "^https://.+",
+    "jsonSchemaFormat": "uri",
+    "errorMessage": "Must be a valid HTTPS URL"
+  },
+  "ipv4": {
+    "helper": "ipv4",
+    "regex": "^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)(?:\\.|$)){4}$",
+    "jsonSchemaFormat": "ipv4",
+    "errorMessage": "Must be a valid IPv4 address"
+  },
+  "ipv6": {
+    "helper": "ipv6",
+    "regex": "^((?:[0-9A-Fa-f]{1,4}:){7}[0-9A-Fa-f]{1,4}|::1|::|(?:[0-9A-Fa-f]{1,4}:){1,7}:|(?:[0-9A-Fa-f]{1,4}:){1,6}:[0-9A-Fa-f]{1,4}|(?:[0-9A-Fa-f]{1,4}:){1,5}(?::[0-9A-Fa-f]{1,4}){1,2}|(?:[0-9A-Fa-f]{1,4}:){1,4}(?::[0-9A-Fa-f]{1,4}){1,3}|(?:[0-9A-Fa-f]{1,4}:){1,3}(?::[0-9A-Fa-f]{1,4}){1,4}|(?:[0-9A-Fa-f]{1,4}:){1,2}(?::[0-9A-Fa-f]{1,4}){1,5}|[0-9A-Fa-f]{1,4}:(?:(?::[0-9A-Fa-f]{1,4}){1,6}))$",
+    "jsonSchemaFormat": "ipv6",
+    "errorMessage": "Must be a valid IPv6 address"
+  },
+  "uuid": {
+    "helper": "uuid",
+    "regex": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
+    "jsonSchemaFormat": "uuid",
+    "errorMessage": "Must be a valid UUID"
+  },
+  "guid": {
+    "helper": "guid",
+    "regex": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-5][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$",
+    "jsonSchemaFormat": "uuid",
+    "errorMessage": "Must be a valid GUID"
+  },
+  "base64": {
+    "helper": "base64",
+    "regex": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$",
+    "contentEncoding": "base64",
+    "errorMessage": "Must be valid base64"
+  },
+  "base64url": {
+    "helper": "base64url",
+    "regex": "^[A-Za-z0-9_-]+$",
+    "errorMessage": "Must be valid base64url"
+  },
+  "cuid": {
+    "helper": "cuid",
+    "regex": "^c[a-z0-9]{24}$",
+    "errorMessage": "Must be a valid CUID"
+  },
+  "cuid2": {
+    "helper": "cuid2",
+    "regex": "^[a-z][a-z0-9]*$",
+    "errorMessage": "Must be a valid CUID2"
+  },
+  "ulid": {
+    "helper": "ulid",
+    "regex": "^[0-9A-HJKMNP-TV-Z]{26}$",
+    "errorMessage": "Must be a valid ULID"
+  },
+  "nanoid": {
+    "helper": "nanoid",
+    "regex": "^[A-Za-z0-9_-]{21}$",
+    "errorMessage": "Must be a valid nanoid"
+  },
+  "emoji": {
+    "helper": "emoji",
+    "regex": "^\\p{Extended_Pictographic}+$",
+    "errorMessage": "Must contain only emoji characters"
+  },
+  "cidrv4": {
+    "helper": "cidrv4",
+    "regex": "^(?:(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)\\.){3}(?:25[0-5]|2[0-4]\\d|1\\d\\d|[1-9]?\\d)/(?:3[0-2]|[12]?\\d)$",
+    "errorMessage": "Must be a valid IPv4 CIDR range"
+  },
+  "cidrv6": {
+    "helper": "cidrv6",
+    "regex": "^[0-9A-Fa-f:]+/(?:12[0-8]|1[01]\\d|\\d?\\d)$",
+    "errorMessage": "Must be a valid IPv6 CIDR range"
+  },
+  "mac": {
+    "helper": "mac",
+    "regex": "^(?:[0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$",
+    "errorMessage": "Must be a valid MAC address"
+  }
+}

package/src/metadata.ts

@@ -0,0 +1,157 @@
+import type { CandidMetadata } from "@ic-reactor/parser"
+import metadataRules from "./metadata-rules.json"
+
+export type JSDocFormatDefinition = {
+  regex?: string
+  errorMessage?: string
+  jsonSchemaFormat?: string
+  contentEncoding?: string
+}
+
+export type CustomJSDocFormatTypes = Record<
+  string,
+  string | JSDocFormatDefinition
+>
+
+type ValidationBoundRule = {
+  template?: string
+}
+
+type MetadataRulesFile = {
+  defaultValidationMessages?: Record<string, ValidationBoundRule>
+}
+
+const metadataRulesFile = metadataRules as MetadataRulesFile
+const defaultValidationMessages =
+  metadataRulesFile.defaultValidationMessages ?? {}
+
+const rawRuleEntries = Object.entries(metadataRules).filter(
+  ([type]) => type !== "defaultValidationMessages"
+) as Array<
+  [
+    string,
+    {
+      helper?: string
+      regex?: string
+      jsonSchemaFormat?: string
+      contentEncoding?: string
+      errorMessage?: string
+    },
+  ]
+>
+
+export const BUILT_IN_JSDOC_FORMAT_TYPES: Readonly<
+  Record<string, JSDocFormatDefinition>
+> = Object.fromEntries(
+  rawRuleEntries.map(([type, rule]) => [
+    type,
+    {
+      regex: rule.regex,
+      jsonSchemaFormat: rule.jsonSchemaFormat,
+      contentEncoding: rule.contentEncoding,
+      errorMessage: rule.errorMessage,
+    },
+  ])
+) as Record<string, JSDocFormatDefinition>
+
+export const BUILT_IN_FORMAT_HELPERS: Readonly<Record<string, string>> =
+  Object.fromEntries(
+    rawRuleEntries
+      .filter(([, rule]) => rule.helper)
+      .map(([type, rule]) => [type, rule.helper as string])
+  )
+
+export interface FormatResolutionOptions {
+  customJSDocFormatTypes?: CustomJSDocFormatTypes
+}
+
+export function normalizeFormatDefinition(
+  definition: CustomJSDocFormatTypes[string] | undefined
+): JSDocFormatDefinition | undefined {
+  if (!definition) return undefined
+  return typeof definition === "string" ? { regex: definition } : definition
+}
+
+export function formatDefinitionFor(
+  type: string,
+  options: FormatResolutionOptions
+): JSDocFormatDefinition | undefined {
+  const builtIn = BUILT_IN_JSDOC_FORMAT_TYPES[type]
+  const custom = normalizeFormatDefinition(
+    options.customJSDocFormatTypes?.[type]
+  )
+
+  if (!custom) return builtIn
+  return {
+    ...builtIn,
+    ...custom,
+    errorMessage: custom.errorMessage ?? builtIn?.errorMessage,
+  }
+}
+
+function stripUndefined<T extends Record<string, unknown>>(value: T): T {
+  return Object.fromEntries(
+    Object.entries(value).filter(([, entry]) => entry !== undefined)
+  ) as T
+}
+
+function defaultBoundMessage(
+  kind: "minimum" | "maximum" | "minLength" | "maxLength",
+  value: string
+): string {
+  const template =
+    defaultValidationMessages[kind]?.template ??
+    (kind === "minimum"
+      ? "Must be at least {value}"
+      : kind === "maximum"
+        ? "Must be at most {value}"
+        : kind === "minLength"
+          ? "Must be at least {value} character{plural}"
+          : "Must be at most {value} character{plural}")
+
+  return template
+    .replace("{value}", value)
+    .replace("{plural}", value === "1" ? "" : "s")
+}
+
+function withDefaultBoundMessage<
+  T extends { value: string; message?: string } | undefined,
+>(bound: T, kind: "minimum" | "maximum" | "minLength" | "maxLength"): T {
+  if (!bound || bound.message !== undefined) return bound
+  return {
+    ...bound,
+    message: defaultBoundMessage(kind, bound.value),
+  } as T
+}
+
+export function normalizeValidationMetadata(
+  validation: NonNullable<CandidMetadata["validation"]>,
+  options: FormatResolutionOptions
+): NonNullable<CandidMetadata["validation"]> {
+  const normalized = {
+    ...validation,
+    minimum: withDefaultBoundMessage(validation.minimum, "minimum"),
+    maximum: withDefaultBoundMessage(validation.maximum, "maximum"),
+    minLength: withDefaultBoundMessage(validation.minLength, "minLength"),
+    maxLength: withDefaultBoundMessage(validation.maxLength, "maxLength"),
+  }
+
+  const format = validation.format
+  const formatDefinition = format
+    ? formatDefinitionFor(format.type, options)
+    : undefined
+
+  if (format && formatDefinition) {
+    normalized.format = stripUndefined({
+      ...format,
+      regex: formatDefinition.regex,
+      jsonSchemaFormat: formatDefinition.jsonSchemaFormat,
+      contentEncoding: formatDefinition.contentEncoding,
+      errorMessage: format.message ?? formatDefinition.errorMessage,
+    })
+  } else if (format) {
+    normalized.format = format
+  }
+
+  return normalized
+}

package/src/naming.test.ts

@@ -4,7 +4,7 @@ import {
   toCamelCase,
   getReactorName,
   getServiceTypeName,
-} from "./naming"
+} from "./naming.js"
 
 describe("Naming Utilities", () => {
   describe("Base Conversions", () => {

package/src/pipeline.test.ts

@@ -2,7 +2,7 @@ import fs from "node:fs"
 import os from "node:os"
 import path from "node:path"
 import { afterEach, describe, expect, it } from "vitest"
-import { runCanisterPipeline } from "./pipeline"
+import { runCanisterPipeline } from "./pipeline.js"
 
 describe("Codegen pipeline", () => {
   const tempDirs: string[] = []

package/src/reactor.test.ts

@@ -1,5 +1,8 @@
 import { describe, expect, it } from "vitest"
-import { generateReactorEntryFile, generateReactorFile } from "./generators"
+import {
+  generateReactorEntryFile,
+  generateReactorFile,
+} from "./generators/index.js"
 
 describe("Reactor generator", () => {
   it("keeps default behavior as DisplayReactor", () => {