@ic-reactor/codegen 0.11.1 → 0.12.1

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/pipeline.ts
-import fs2 from "fs";
-import path3 from "path";
+import fs3 from "fs";
+import path4 from "path";
 
 // src/generators/declarations.ts
 import { didToJs, didToTs } from "@ic-reactor/parser";
@@ -76,6 +76,9 @@ function getReactorName(canisterName) {
 function getServiceTypeName(canisterName) {
   return `${toPascalCase(canisterName)}Service`;
 }
+function getHookPrefix(canisterName) {
+  return toPascalCase(canisterName);
+}
 
 // src/generators/reactor.ts
 function getReactorClassImportSource(reactorClass, runtimeTarget) {
@@ -87,6 +90,10 @@ function getReactorClassImportSource(reactorClass, runtimeTarget) {
     case "CandidDisplayReactor":
     case "MetadataDisplayReactor":
       return "@ic-reactor/candid";
+    default:
+      throw new Error(
+        `Unknown reactor class ${JSON.stringify(reactorClass)}. Expected one of: Reactor, DisplayReactor, CandidReactor, CandidDisplayReactor, MetadataDisplayReactor.`
+      );
   }
 }
 function generateReactorFile(options) {
@@ -120,9 +127,9 @@ export const {
   useActorMethod: use${pascalName}Method,
 } = createActorHooks(${reactorName})
 ` : "";
-  return `${runtimeTarget === "react" ? 'import { createActorHooks } from "@ic-reactor/react"\n' : ""}import { ${reactorClass} } from "${reactorImportSource}"
-import { clientManager } from "${clientManagerPath}"
-import { idlFactory, type _SERVICE } from "${declarationsPath}"
+  return `${runtimeTarget === "react" ? 'import { createActorHooks } from "@ic-reactor/react"\n' : ""}import { ${reactorClass} } from ${JSON.stringify(reactorImportSource)}
+import { clientManager } from ${JSON.stringify(clientManagerPath)}
+import { idlFactory, type _SERVICE } from ${JSON.stringify(declarationsPath)}
 
 export type ${serviceName} = _SERVICE
 
@@ -131,11 +138,14 @@ export type ${serviceName} = _SERVICE
  *
  * Auto-generated by @ic-reactor/codegen \u2014 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,
   idlFactory,
-${canisterIdLine}  name: "${canisterName}",
+${canisterIdLine}  name: ${JSON.stringify(canisterName)},
 })${hookExports || "\n"}`;
 }
 function generateReactorEntryFile() {
@@ -144,11 +154,176 @@ function generateReactorEntryFile() {
  *
  * 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"
 `;
 }
 
+// src/validate.ts
+import fs2 from "fs";
+import path3 from "path";
+var CodegenConfigError = class extends Error {
+  name = "CodegenConfigError";
+  constructor(message) {
+    super(message);
+  }
+};
+var CANISTER_NAME_PATTERN = /^[A-Za-z0-9_.-]+$/;
+var IDENTIFIER_PATTERN = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+var MAX_CANISTER_NAME_LENGTH = 64;
+var HAS_URI_SCHEME = /^(?:[A-Za-z][A-Za-z0-9+.-]*:|\/\/)/;
+var BREAKS_OUT_OF_LITERAL = /["'`\\\u0000-\u001f\u2028\u2029]/;
+function assertSafeCanisterName(name) {
+  if (typeof name !== "string" || name.length === 0) {
+    throw new CodegenConfigError(
+      `Invalid canister name: expected a non-empty string, received ${name === void 0 ? "undefined" : JSON.stringify(name)}. Check the "canisters" entries in your ic-reactor.json (or the plugin's "canisters" option).`
+    );
+  }
+  if (name.length > MAX_CANISTER_NAME_LENGTH) {
+    throw new CodegenConfigError(
+      `Invalid canister name ${JSON.stringify(name)}: must be at most ${MAX_CANISTER_NAME_LENGTH} characters.`
+    );
+  }
+  if (!CANISTER_NAME_PATTERN.test(name)) {
+    throw new CodegenConfigError(
+      `Invalid canister name ${JSON.stringify(name)}: may contain only letters, digits, "_", "." and "-" (${CANISTER_NAME_PATTERN.source}). Canister names become directory names, so path separators, quotes and whitespace are not allowed.`
+    );
+  }
+  if (name === "." || name === "..") {
+    throw new CodegenConfigError(
+      `Invalid canister name ${JSON.stringify(name)}: refers to a directory, not a canister.`
+    );
+  }
+  if (toPascalCase(name).length === 0) {
+    throw new CodegenConfigError(
+      `Invalid canister name ${JSON.stringify(name)}: contains no letters or digits, so it collapses to an empty identifier in generated code.`
+    );
+  }
+  const derived = [
+    ["reactor constant", getReactorName(name)],
+    ["service type", getServiceTypeName(name)],
+    ["hook name", `use${getHookPrefix(name)}Query`]
+  ];
+  for (const [what, identifier] of derived) {
+    if (!IDENTIFIER_PATTERN.test(identifier)) {
+      throw new CodegenConfigError(
+        `Invalid canister name ${JSON.stringify(name)}: it derives the ${what} ${JSON.stringify(identifier)}, which is not a valid TypeScript identifier. Rename the canister so it does not begin with a digit.`
+      );
+    }
+  }
+}
+function assertSafeModuleSpecifier(label, specifier) {
+  if (typeof specifier !== "string" || specifier.length === 0) {
+    throw new CodegenConfigError(
+      `Invalid ${label}: expected a non-empty string, received ${specifier === void 0 ? "undefined" : JSON.stringify(specifier)}.`
+    );
+  }
+  if (BREAKS_OUT_OF_LITERAL.test(specifier)) {
+    throw new CodegenConfigError(
+      `Invalid ${label} ${JSON.stringify(specifier)}: must not contain quotes, backslashes or control characters.`
+    );
+  }
+  if (/^\s|\s$/.test(specifier)) {
+    throw new CodegenConfigError(
+      `Invalid ${label} ${JSON.stringify(specifier)}: must not begin or end with whitespace.`
+    );
+  }
+  if (HAS_URI_SCHEME.test(specifier.trim())) {
+    throw new CodegenConfigError(
+      `Invalid ${label} ${JSON.stringify(specifier)}: must be a relative path ("./\u2026", "../\u2026") or a bare package name. URLs are not allowed \u2014 the generated file imports from this specifier.`
+    );
+  }
+}
+var REACTOR_CLASS_NAMES = [
+  "Reactor",
+  "DisplayReactor",
+  "CandidReactor",
+  "CandidDisplayReactor",
+  "MetadataDisplayReactor"
+];
+var CODEGEN_TARGETS = ["react", "core"];
+function assertOneOf(label, value, allowed) {
+  if (typeof value !== "string" || !allowed.includes(value)) {
+    throw new CodegenConfigError(
+      `Invalid ${label} ${JSON.stringify(value)}: must be one of ${allowed.map((a) => JSON.stringify(a)).join(", ")}.`
+    );
+  }
+}
+function realpathAllowingMissing(target) {
+  let current = path3.resolve(target);
+  const missing = [];
+  for (; ; ) {
+    try {
+      return path3.join(fs2.realpathSync(current), ...missing);
+    } catch {
+      const parent = path3.dirname(current);
+      if (parent === current) return path3.resolve(target);
+      missing.unshift(path3.basename(current));
+      current = parent;
+    }
+  }
+}
+function assertContainedPath(label, resolved, projectRoot, original = resolved) {
+  const relative = path3.relative(
+    realpathAllowingMissing(projectRoot),
+    realpathAllowingMissing(resolved)
+  );
+  const [firstSegment] = relative.split(/[\\/]/);
+  if (firstSegment === ".." || path3.isAbsolute(relative)) {
+    throw new CodegenConfigError(
+      `Invalid ${label} ${JSON.stringify(original)}: resolves to ${JSON.stringify(resolved)}, which is outside the project root ${JSON.stringify(path3.resolve(projectRoot))}. Generated output must stay inside the project \u2014 generated directories are deleted and rewritten on every run.`
+    );
+  }
+}
+function resolveContainedOutDir(label, outDir, projectRoot) {
+  if (typeof outDir !== "string" || outDir.length === 0) {
+    throw new CodegenConfigError(
+      `Invalid ${label}: expected a non-empty string, received ${outDir === void 0 ? "undefined" : JSON.stringify(outDir)}.`
+    );
+  }
+  const resolved = path3.isAbsolute(outDir) ? path3.resolve(outDir) : path3.resolve(projectRoot, outDir);
+  assertContainedPath(label, resolved, projectRoot, outDir);
+  return resolved;
+}
+function assertSafeCanisterConfig(options) {
+  const {
+    name,
+    canisterOutDir,
+    globalOutDir,
+    clientManagerPath,
+    projectRoot,
+    mode,
+    target
+  } = options;
+  assertSafeCanisterName(name);
+  assertSafeModuleSpecifier("clientManagerPath", clientManagerPath);
+  if (mode != null) assertOneOf("mode", mode, REACTOR_CLASS_NAMES);
+  if (target != null) assertOneOf("target", target, CODEGEN_TARGETS);
+  const outDir = canisterOutDir != null ? resolveContainedOutDir(
+    `outDir for canister ${JSON.stringify(name)}`,
+    canisterOutDir,
+    projectRoot
+  ) : path3.join(
+    resolveContainedOutDir("outDir", globalOutDir, projectRoot),
+    name
+  );
+  assertContainedPath(
+    `output directory for canister ${JSON.stringify(name)}`,
+    outDir,
+    projectRoot
+  );
+  return { name, outDir, clientManagerPath };
+}
+
 // src/pipeline.ts
 function resolveReactorClass(canisterConfig) {
   return canisterConfig.mode ?? "DisplayReactor";
@@ -174,8 +349,30 @@ async function runCanisterPipeline(options) {
   } = options;
   const { name, didFile, clientManagerPath } = canisterConfig;
   const files = [];
-  const resolvedDidFile = path3.isAbsolute(didFile) ? didFile : path3.resolve(projectRoot, didFile);
-  if (!fs2.existsSync(resolvedDidFile)) {
+  let validated;
+  try {
+    validated = assertSafeCanisterConfig({
+      name,
+      canisterOutDir: canisterConfig.outDir,
+      globalOutDir: globalConfig.outDir,
+      clientManagerPath: clientManagerPath ?? globalConfig.clientManagerPath ?? "../../clients",
+      projectRoot,
+      mode: canisterConfig.mode,
+      target: canisterConfig.target ?? globalConfig.target
+    });
+  } catch (err) {
+    if (err instanceof CodegenConfigError) {
+      return {
+        canisterName: typeof name === "string" ? name : String(name),
+        success: false,
+        files,
+        error: err.message
+      };
+    }
+    throw err;
+  }
+  const resolvedDidFile = path4.isAbsolute(didFile) ? didFile : path4.resolve(projectRoot, didFile);
+  if (!fs3.existsSync(resolvedDidFile)) {
     return {
       canisterName: name,
       success: false,
@@ -183,8 +380,8 @@ async function runCanisterPipeline(options) {
       error: `DID file not found: ${resolvedDidFile}`
     };
   }
-  const canisterOutDir = canisterConfig.outDir != null ? path3.isAbsolute(canisterConfig.outDir) ? canisterConfig.outDir : path3.resolve(projectRoot, canisterConfig.outDir) : path3.resolve(projectRoot, globalConfig.outDir, name);
-  const resolvedClientManagerPath = clientManagerPath ?? globalConfig.clientManagerPath ?? "../../clients";
+  const canisterOutDir = validated.outDir;
+  const resolvedClientManagerPath = validated.clientManagerPath;
   try {
     const declResult = await generateDeclarations({
       didFile: resolvedDidFile,
@@ -215,8 +412,8 @@ async function runCanisterPipeline(options) {
       files
     };
   }
-  const reactorPath = path3.join(canisterOutDir, "index.generated.ts");
-  const entryPath = path3.join(canisterOutDir, "index.ts");
+  const reactorPath = path4.join(canisterOutDir, "index.generated.ts");
+  const entryPath = path4.join(canisterOutDir, "index.ts");
   const reactorClass = resolveReactorClass(canisterConfig);
   const runtimeTarget = resolveRuntimeTarget(canisterConfig, globalConfig);
   try {
@@ -229,16 +426,16 @@ async function runCanisterPipeline(options) {
       reactorClass
     });
     const entryContent = generateReactorEntryFile();
-    fs2.mkdirSync(canisterOutDir, { recursive: true });
-    fs2.writeFileSync(reactorPath, reactorContent);
+    fs3.mkdirSync(canisterOutDir, { recursive: true });
+    fs3.writeFileSync(reactorPath, reactorContent);
     files.push({ success: true, filePath: reactorPath });
-    if (!fs2.existsSync(entryPath)) {
-      fs2.writeFileSync(entryPath, entryContent);
+    if (!fs3.existsSync(entryPath)) {
+      fs3.writeFileSync(entryPath, entryContent);
       files.push({ success: true, filePath: entryPath });
     } else {
-      const existingEntryContent = fs2.readFileSync(entryPath, "utf-8");
+      const existingEntryContent = fs3.readFileSync(entryPath, "utf-8");
       if (isLegacyGeneratedIndexFile(existingEntryContent) || isManagedEntryWrapper(existingEntryContent, entryContent)) {
-        fs2.writeFileSync(entryPath, entryContent);
+        fs3.writeFileSync(entryPath, entryContent);
         files.push({ success: true, filePath: entryPath });
       } else {
         files.push({ success: true, filePath: entryPath, skipped: true });
@@ -266,7 +463,7 @@ async function runCanisterPipeline(options) {
 
 // src/parser.ts
 import { didToJs as didToJs2 } from "@ic-reactor/parser";
-import fs3 from "fs";
+import fs4 from "fs";
 function extractMethods(didContent) {
   try {
     const jsContent = didToJs2(didContent);
@@ -291,10 +488,10 @@ function extractMethods(didContent) {
   }
 }
 function parseDIDFile(didFilePath) {
-  if (!fs3.existsSync(didFilePath)) {
+  if (!fs4.existsSync(didFilePath)) {
     throw new Error(`DID file not found: ${didFilePath}`);
   }
-  const content = fs3.readFileSync(didFilePath, "utf-8");
+  const content = fs4.readFileSync(didFilePath, "utf-8");
   return extractMethods(content);
 }
 
@@ -315,11 +512,19 @@ ${queryClientImport}
  */
 export const clientManager = new ClientManager({
   queryClient,
-  withCanisterEnv: true,
 })
 `;
 }
 export {
+  CANISTER_NAME_PATTERN,
+  CODEGEN_TARGETS,
+  CodegenConfigError,
+  REACTOR_CLASS_NAMES,
+  assertContainedPath,
+  assertOneOf,
+  assertSafeCanisterConfig,
+  assertSafeCanisterName,
+  assertSafeModuleSpecifier,
   declarationsExist,
   extractMethods,
   generateClientFile,
@@ -329,6 +534,7 @@ export {
   getReactorName,
   getServiceTypeName,
   parseDIDFile,
+  resolveContainedOutDir,
   runCanisterPipeline,
   toPascalCase
 };

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.1",
+  "version": "0.12.1",
   "description": "Shared code generation utilities for IC Reactor",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -8,14 +8,22 @@
   "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"
+      }
+    },
+    "./package.json": "./package.json"
   },
   "files": [
     "dist",
-    "src"
+    "src",
+    "README.md",
+    "llms.txt"
   ],
   "keywords": [
     "internet-computer",
@@ -32,21 +40,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",
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --tsconfig tsconfig.json",
     "dev": "tsup src/index.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

@@ -60,6 +60,14 @@ function getReactorClassImportSource(
     case "CandidDisplayReactor":
     case "MetadataDisplayReactor":
       return "@ic-reactor/candid"
+    default:
+      // The pipeline validates `mode` against a closed set before we are
+      // reached. Failing closed here means a caller that skips validation gets
+      // an error rather than an unknown class name interpolated into source.
+      throw new Error(
+        `Unknown reactor class ${JSON.stringify(reactorClass)}. Expected one of: ` +
+          `Reactor, DisplayReactor, CandidReactor, CandidDisplayReactor, MetadataDisplayReactor.`
+      )
   }
 }
 
@@ -105,9 +113,12 @@ export const {
 `
       : ""
 
-  return `${runtimeTarget === "react" ? 'import { createActorHooks } from "@ic-reactor/react"\n' : ""}import { ${reactorClass} } from "${reactorImportSource}"
-import { clientManager } from "${clientManagerPath}"
-import { idlFactory, type _SERVICE } from "${declarationsPath}"
+  // Every interpolation into emitted source is JSON.stringify'd. The pipeline
+  // validates these values before we are called; quoting them here as well
+  // means a future caller that skips validation cannot inject source text.
+  return `${runtimeTarget === "react" ? 'import { createActorHooks } from "@ic-reactor/react"\n' : ""}import { ${reactorClass} } from ${JSON.stringify(reactorImportSource)}
+import { clientManager } from ${JSON.stringify(clientManagerPath)}
+import { idlFactory, type _SERVICE } from ${JSON.stringify(declarationsPath)}
 
 export type ${serviceName} = _SERVICE
 
@@ -116,11 +127,14 @@ 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,
   idlFactory,
-${canisterIdLine}  name: "${canisterName}",
+${canisterIdLine}  name: ${JSON.stringify(canisterName)},
 })${hookExports || "\n"}`
 }
 
@@ -133,6 +147,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

@@ -21,6 +21,25 @@ export type { PipelineOptions, PipelineResult } from "./pipeline.js"
 // Utilities
 export { toPascalCase, getReactorName, getServiceTypeName } from "./naming.js"
 
+// Config validation (run by the pipeline; exported for callers that want to
+// validate a config before invoking generation)
+export {
+  assertSafeCanisterConfig,
+  assertSafeCanisterName,
+  assertSafeModuleSpecifier,
+  assertContainedPath,
+  assertOneOf,
+  resolveContainedOutDir,
+  CodegenConfigError,
+  CANISTER_NAME_PATTERN,
+  REACTOR_CLASS_NAMES,
+  CODEGEN_TARGETS,
+} from "./validate.js"
+export type {
+  ValidatedCanisterPaths,
+  ValidateCanisterConfigOptions,
+} from "./validate.js"
+
 export { parseDIDFile, extractMethods } from "./parser.js"
 export type { MethodInfo, MethodType } from "./parser.js"
 

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[] = []