@caatinga/core 3.1.0 → 3.1.2

package/dist/index.cjs

@@ -1608,8 +1608,101 @@ async function deployContractGraph(options) {
 }
 
 // src/contracts/generate-bindings.ts
+var import_promises8 = require("fs/promises");
+var import_node_path11 = __toESM(require("path"), 1);
+
+// src/bindings/patch-generated-binding-package.ts
 var import_promises7 = require("fs/promises");
 var import_node_path10 = __toESM(require("path"), 1);
+var BUNDLER_ENTRY = "./src/index.ts";
+var ROOT_BINDING_INDEX_CONTENT = 'export * from "./src/index.js";\n';
+function resolveExportEntry(exportsField) {
+  if (!exportsField) {
+    return void 0;
+  }
+  const rootExport = exportsField["."];
+  if (typeof rootExport === "string") {
+    return rootExport;
+  }
+  if (rootExport && typeof rootExport === "object" && !Array.isArray(rootExport)) {
+    const conditions = rootExport;
+    for (const key of ["import", "default", "types"]) {
+      const value = conditions[key];
+      if (typeof value === "string") {
+        return value;
+      }
+    }
+  }
+  return void 0;
+}
+function pointsToDist(main) {
+  return typeof main === "string" && main.replace(/^\.\//, "").startsWith("dist/");
+}
+function pointsToBundlerSource(entry) {
+  return entry === BUNDLER_ENTRY || entry === "./src/index.js";
+}
+function shouldPatchPackageJson(packageJson) {
+  const exportEntry = resolveExportEntry(
+    typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : void 0
+  );
+  return pointsToDist(packageJson.main) || pointsToDist(packageJson.types) || !pointsToBundlerSource(exportEntry);
+}
+async function ensureRootBindingIndex(outputDir) {
+  const rootIndexPath = import_node_path10.default.join(outputDir, "index.ts");
+  try {
+    const existing = await (0, import_promises7.readFile)(rootIndexPath, "utf8");
+    if (existing === ROOT_BINDING_INDEX_CONTENT) {
+      return;
+    }
+    return;
+  } catch {
+    await (0, import_promises7.writeFile)(rootIndexPath, ROOT_BINDING_INDEX_CONTENT, "utf8");
+  }
+}
+async function patchGeneratedBindingPackage(outputDir) {
+  const packageJsonPath = import_node_path10.default.join(outputDir, "package.json");
+  const entryPath = import_node_path10.default.join(outputDir, "src", "index.ts");
+  try {
+    await (0, import_promises7.access)(entryPath);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing src/index.ts.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let raw;
+  try {
+    raw = await (0, import_promises7.readFile)(packageJsonPath, "utf8");
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing package.json.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(raw);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package.json is not valid JSON.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  if (shouldPatchPackageJson(packageJson)) {
+    packageJson.main = BUNDLER_ENTRY;
+    packageJson.types = BUNDLER_ENTRY;
+    packageJson.exports = {
+      ...typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : {},
+      ".": BUNDLER_ENTRY
+    };
+    await (0, import_promises7.writeFile)(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf8");
+  }
+  await ensureRootBindingIndex(outputDir);
+}
 
 // src/contracts/build-generate-network-args.ts
 function buildGenerateNetworkArgs(network) {
@@ -1621,14 +1714,14 @@ function buildGenerateNetworkArgs(network) {
 
 // src/contracts/generate-bindings.ts
 function toBindingImportPath(bindingsOutput, contractName) {
-  const normalized = bindingsOutput.replace(/^\.\//, "").split(import_node_path10.default.sep).join("/");
-  return `./${import_node_path10.default.posix.join(normalized, contractName)}`;
+  const normalized = bindingsOutput.replace(/^\.\//, "").split(import_node_path11.default.sep).join("/");
+  return `./${import_node_path11.default.posix.join(normalized, contractName)}`;
 }
 async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
-  const legacyPath = import_node_path10.default.resolve(cwd, bindingsOutput, `${contractName}.ts`);
+  const legacyPath = import_node_path11.default.resolve(cwd, bindingsOutput, `${contractName}.ts`);
   try {
-    await (0, import_promises7.access)(legacyPath);
-    await (0, import_promises7.unlink)(legacyPath);
+    await (0, import_promises8.access)(legacyPath);
+    await (0, import_promises8.unlink)(legacyPath);
     return true;
   } catch {
     return false;
@@ -1653,8 +1746,8 @@ async function generateBindings(options) {
       "Run caatinga deploy for this contract and network before generating bindings."
     );
   }
-  const outputDir = import_node_path10.default.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
-  await (0, import_promises7.mkdir)(outputDir, { recursive: true });
+  const outputDir = import_node_path11.default.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
+  await (0, import_promises8.mkdir)(outputDir, { recursive: true });
   const result = await runCommand(
     "npx",
     [
@@ -1680,6 +1773,7 @@ async function generateBindings(options) {
     options.config.frontend.bindingsOutput,
     options.contractName
   );
+  await patchGeneratedBindingPackage(outputDir);
   const marker = {
     version: 1,
     contractId: contractArtifact.contractId,
@@ -1879,8 +1973,8 @@ async function readContract(options) {
 }
 
 // src/templates/create-project-from-template.ts
-var import_promises8 = require("fs/promises");
-var import_node_path11 = __toESM(require("path"), 1);
+var import_promises9 = require("fs/promises");
+var import_node_path12 = __toESM(require("path"), 1);
 var import_zod7 = require("zod");
 
 // src/templates/template-manifest.schema.ts
@@ -1951,10 +2045,10 @@ function formatTemplateCompatibilityHint(issue) {
 // src/templates/create-project-from-template.ts
 var TEMPLATE_COPY_EXCLUDED_DIRS = /* @__PURE__ */ new Set(["target", "test_snapshots", "node_modules", ".git"]);
 async function createProjectFromTemplate(options) {
-  const targetDir = import_node_path11.default.resolve(options.targetDir);
-  const templateDir = import_node_path11.default.resolve(options.templateDir);
+  const targetDir = import_node_path12.default.resolve(options.targetDir);
+  const templateDir = import_node_path12.default.resolve(options.templateDir);
   try {
-    await (0, import_promises8.stat)(templateDir);
+    await (0, import_promises9.stat)(templateDir);
   } catch {
     throw new CaatingaError(
       `Template directory was not found: ${templateDir}`,
@@ -1964,8 +2058,8 @@ async function createProjectFromTemplate(options) {
   }
   const manifest = await readTemplateManifest(templateDir);
   const mergeIntoExisting = Boolean(options.filter);
-  await (0, import_promises8.mkdir)(targetDir, { recursive: true });
-  await (0, import_promises8.cp)(templateDir, targetDir, {
+  await (0, import_promises9.mkdir)(targetDir, { recursive: true });
+  await (0, import_promises9.cp)(templateDir, targetDir, {
     recursive: true,
     force: true,
     errorOnExist: false,
@@ -1993,9 +2087,9 @@ async function ensureArtifacts(targetDir, projectName) {
   }
 }
 async function readTemplateManifest(templateDir) {
-  const manifestPath = import_node_path11.default.join(templateDir, "caatinga.template.json");
+  const manifestPath = import_node_path12.default.join(templateDir, "caatinga.template.json");
   try {
-    const rawManifest = await (0, import_promises8.readFile)(manifestPath, "utf8");
+    const rawManifest = await (0, import_promises9.readFile)(manifestPath, "utf8");
     const manifest = TemplateManifestSchema.parse(JSON.parse(rawManifest));
     const compatibilityIssue = getTemplateCompatibilityIssue(manifest);
     if (compatibilityIssue) {
@@ -2028,11 +2122,11 @@ async function readTemplateManifest(templateDir) {
   }
 }
 async function replaceTemplateVariables(dir, projectName) {
-  const entries = await (0, import_promises8.readdir)(dir);
+  const entries = await (0, import_promises9.readdir)(dir);
   await Promise.all(
     entries.map(async (entry) => {
-      const entryPath = import_node_path11.default.join(dir, entry);
-      const entryStat = await (0, import_promises8.stat)(entryPath);
+      const entryPath = import_node_path12.default.join(dir, entry);
+      const entryStat = await (0, import_promises9.stat)(entryPath);
       if (entryStat.isDirectory()) {
         await replaceTemplateVariables(entryPath, projectName);
         return;
@@ -2040,39 +2134,39 @@ async function replaceTemplateVariables(dir, projectName) {
       if (!isTextTemplateFile(entryPath)) {
         return;
       }
-      const content = await (0, import_promises8.readFile)(entryPath, "utf8");
-      await (0, import_promises8.writeFile)(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
+      const content = await (0, import_promises9.readFile)(entryPath, "utf8");
+      await (0, import_promises9.writeFile)(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
     })
   );
 }
 function shouldCopyTemplateEntry(templateDir, source, userFilter) {
-  const relativePath = import_node_path11.default.relative(templateDir, source);
+  const relativePath = import_node_path12.default.relative(templateDir, source);
   if (!relativePath || relativePath === ".") {
     return true;
   }
-  const normalizedPath = relativePath.split(import_node_path11.default.sep).join("/");
+  const normalizedPath = relativePath.split(import_node_path12.default.sep).join("/");
   if (userFilter && !userFilter(normalizedPath)) {
     return false;
   }
-  return !relativePath.split(import_node_path11.default.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
+  return !relativePath.split(import_node_path12.default.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
 }
 function isTextTemplateFile(filePath) {
   return [".json", ".md", ".rs", ".toml", ".ts", ".tsx", ".css", ".html"].includes(
-    import_node_path11.default.extname(filePath)
+    import_node_path12.default.extname(filePath)
   );
 }
 
 // src/scaffold/create-zk-project.ts
-var import_promises9 = require("fs/promises");
+var import_promises10 = require("fs/promises");
 var import_node_fs2 = require("fs");
-var import_node_path12 = __toESM(require("path"), 1);
+var import_node_path13 = __toESM(require("path"), 1);
 var import_node_url = require("url");
 var import_meta3 = {};
-var moduleDir = typeof __dirname === "string" ? __dirname : import_node_path12.default.dirname((0, import_node_url.fileURLToPath)(import_meta3.url));
+var moduleDir = typeof __dirname === "string" ? __dirname : import_node_path13.default.dirname((0, import_node_url.fileURLToPath)(import_meta3.url));
 function scaffoldRoot() {
   const candidates = [
-    import_node_path12.default.resolve(moduleDir, "../../scaffolds"),
-    import_node_path12.default.resolve(moduleDir, "../scaffolds")
+    import_node_path13.default.resolve(moduleDir, "../../scaffolds"),
+    import_node_path13.default.resolve(moduleDir, "../scaffolds")
   ];
   const found = candidates.find((candidate) => (0, import_node_fs2.existsSync)(candidate));
   return found ?? candidates[0];
@@ -2163,39 +2257,39 @@ Replace \`circuits/main.circom\` with your circuit. Keep the entry point named \
 `;
 }
 async function createZkProject(options) {
-  const targetDir = import_node_path12.default.resolve(options.targetDir);
+  const targetDir = import_node_path13.default.resolve(options.targetDir);
   const force = options.force ?? false;
   const projectFiles = options.projectFiles ?? true;
-  await (0, import_promises9.mkdir)(targetDir, { recursive: true });
+  await (0, import_promises10.mkdir)(targetDir, { recursive: true });
   if (projectFiles) {
     await Promise.all([
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
+      (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
+      (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+      (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      (0, import_promises9.writeFile)(import_node_path12.default.join(targetDir, "README.md"), readmeSource(options.projectName), {
+      (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "README.md"), readmeSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       })
     ]);
   }
-  await (0, import_promises9.mkdir)(import_node_path12.default.join(targetDir, "contracts"), { recursive: true });
-  await (0, import_promises9.cp)(import_node_path12.default.join(scaffoldRoot(), "zk-circuit-stub"), import_node_path12.default.join(targetDir, "circuits"), {
+  await (0, import_promises10.mkdir)(import_node_path13.default.join(targetDir, "contracts"), { recursive: true });
+  await (0, import_promises10.cp)(import_node_path13.default.join(scaffoldRoot(), "zk-circuit-stub"), import_node_path13.default.join(targetDir, "circuits"), {
     recursive: true,
     force,
     errorOnExist: !force
   });
-  await (0, import_promises9.cp)(
-    import_node_path12.default.join(scaffoldRoot(), "zk-verifier"),
-    import_node_path12.default.join(targetDir, "contracts", "verifier"),
+  await (0, import_promises10.cp)(
+    import_node_path13.default.join(scaffoldRoot(), "zk-verifier"),
+    import_node_path13.default.join(targetDir, "contracts", "verifier"),
     {
       recursive: true,
       force,
@@ -2212,16 +2306,16 @@ async function createZkProject(options) {
 }
 
 // src/scaffold/create-minimal-project.ts
-var import_promises10 = require("fs/promises");
+var import_promises11 = require("fs/promises");
 var import_node_fs3 = require("fs");
-var import_node_path13 = __toESM(require("path"), 1);
+var import_node_path14 = __toESM(require("path"), 1);
 var import_node_url2 = require("url");
 var import_meta4 = {};
-var moduleDir2 = typeof __dirname === "string" ? __dirname : import_node_path13.default.dirname((0, import_node_url2.fileURLToPath)(import_meta4.url));
+var moduleDir2 = typeof __dirname === "string" ? __dirname : import_node_path14.default.dirname((0, import_node_url2.fileURLToPath)(import_meta4.url));
 function scaffoldRoot2() {
   const candidates = [
-    import_node_path13.default.resolve(moduleDir2, "../../scaffolds"),
-    import_node_path13.default.resolve(moduleDir2, "../scaffolds")
+    import_node_path14.default.resolve(moduleDir2, "../../scaffolds"),
+    import_node_path14.default.resolve(moduleDir2, "../scaffolds")
   ];
   const found = candidates.find((candidate) => (0, import_node_fs3.existsSync)(candidate));
   return found ?? candidates[0];
@@ -2312,31 +2406,31 @@ Edit \`contracts/app/src/lib.rs\` to customize the contract. Add a frontend late
 `;
 }
 async function createMinimalProject(options) {
-  const targetDir = import_node_path13.default.resolve(options.targetDir);
+  const targetDir = import_node_path14.default.resolve(options.targetDir);
   const force = options.force ?? false;
-  await (0, import_promises10.mkdir)(targetDir, { recursive: true });
+  await (0, import_promises11.mkdir)(targetDir, { recursive: true });
   await Promise.all([
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
+    (0, import_promises11.writeFile)(import_node_path14.default.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
+    (0, import_promises11.writeFile)(import_node_path14.default.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+    (0, import_promises11.writeFile)(import_node_path14.default.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    (0, import_promises10.writeFile)(import_node_path13.default.join(targetDir, "README.md"), readmeSource2(options.projectName), {
+    (0, import_promises11.writeFile)(import_node_path14.default.join(targetDir, "README.md"), readmeSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     })
   ]);
-  await (0, import_promises10.mkdir)(import_node_path13.default.join(targetDir, "contracts"), { recursive: true });
-  await (0, import_promises10.cp)(
-    import_node_path13.default.join(scaffoldRoot2(), "soroban-contract-stub"),
-    import_node_path13.default.join(targetDir, "contracts", "app"),
+  await (0, import_promises11.mkdir)(import_node_path14.default.join(targetDir, "contracts"), { recursive: true });
+  await (0, import_promises11.cp)(
+    import_node_path14.default.join(scaffoldRoot2(), "soroban-contract-stub"),
+    import_node_path14.default.join(targetDir, "contracts", "app"),
     {
       recursive: true,
       force,

package/dist/index.js

@@ -1517,8 +1517,101 @@ async function deployContractGraph(options) {
 }
 
 // src/contracts/generate-bindings.ts
-import { access as access3, mkdir as mkdir2, unlink } from "fs/promises";
+import { access as access4, mkdir as mkdir2, unlink } from "fs/promises";
+import path11 from "path";
+
+// src/bindings/patch-generated-binding-package.ts
+import { access as access3, readFile as readFile4, writeFile as writeFile3 } from "fs/promises";
 import path10 from "path";
+var BUNDLER_ENTRY = "./src/index.ts";
+var ROOT_BINDING_INDEX_CONTENT = 'export * from "./src/index.js";\n';
+function resolveExportEntry(exportsField) {
+  if (!exportsField) {
+    return void 0;
+  }
+  const rootExport = exportsField["."];
+  if (typeof rootExport === "string") {
+    return rootExport;
+  }
+  if (rootExport && typeof rootExport === "object" && !Array.isArray(rootExport)) {
+    const conditions = rootExport;
+    for (const key of ["import", "default", "types"]) {
+      const value = conditions[key];
+      if (typeof value === "string") {
+        return value;
+      }
+    }
+  }
+  return void 0;
+}
+function pointsToDist(main) {
+  return typeof main === "string" && main.replace(/^\.\//, "").startsWith("dist/");
+}
+function pointsToBundlerSource(entry) {
+  return entry === BUNDLER_ENTRY || entry === "./src/index.js";
+}
+function shouldPatchPackageJson(packageJson) {
+  const exportEntry = resolveExportEntry(
+    typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : void 0
+  );
+  return pointsToDist(packageJson.main) || pointsToDist(packageJson.types) || !pointsToBundlerSource(exportEntry);
+}
+async function ensureRootBindingIndex(outputDir) {
+  const rootIndexPath = path10.join(outputDir, "index.ts");
+  try {
+    const existing = await readFile4(rootIndexPath, "utf8");
+    if (existing === ROOT_BINDING_INDEX_CONTENT) {
+      return;
+    }
+    return;
+  } catch {
+    await writeFile3(rootIndexPath, ROOT_BINDING_INDEX_CONTENT, "utf8");
+  }
+}
+async function patchGeneratedBindingPackage(outputDir) {
+  const packageJsonPath = path10.join(outputDir, "package.json");
+  const entryPath = path10.join(outputDir, "src", "index.ts");
+  try {
+    await access3(entryPath);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing src/index.ts.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let raw;
+  try {
+    raw = await readFile4(packageJsonPath, "utf8");
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package is missing package.json.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  let packageJson;
+  try {
+    packageJson = JSON.parse(raw);
+  } catch {
+    throw new CaatingaError(
+      "Generated binding package.json is not valid JSON.",
+      CaatingaErrorCode.BINDINGS_FAILED,
+      "Re-run caatinga generate or check @stellar/stellar-sdk generate output."
+    );
+  }
+  if (shouldPatchPackageJson(packageJson)) {
+    packageJson.main = BUNDLER_ENTRY;
+    packageJson.types = BUNDLER_ENTRY;
+    packageJson.exports = {
+      ...typeof packageJson.exports === "object" && packageJson.exports !== null && !Array.isArray(packageJson.exports) ? packageJson.exports : {},
+      ".": BUNDLER_ENTRY
+    };
+    await writeFile3(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}
+`, "utf8");
+  }
+  await ensureRootBindingIndex(outputDir);
+}
 
 // src/contracts/build-generate-network-args.ts
 function buildGenerateNetworkArgs(network) {
@@ -1530,13 +1623,13 @@ function buildGenerateNetworkArgs(network) {
 
 // src/contracts/generate-bindings.ts
 function toBindingImportPath(bindingsOutput, contractName) {
-  const normalized = bindingsOutput.replace(/^\.\//, "").split(path10.sep).join("/");
-  return `./${path10.posix.join(normalized, contractName)}`;
+  const normalized = bindingsOutput.replace(/^\.\//, "").split(path11.sep).join("/");
+  return `./${path11.posix.join(normalized, contractName)}`;
 }
 async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
-  const legacyPath = path10.resolve(cwd, bindingsOutput, `${contractName}.ts`);
+  const legacyPath = path11.resolve(cwd, bindingsOutput, `${contractName}.ts`);
   try {
-    await access3(legacyPath);
+    await access4(legacyPath);
     await unlink(legacyPath);
     return true;
   } catch {
@@ -1562,7 +1655,7 @@ async function generateBindings(options) {
       "Run caatinga deploy for this contract and network before generating bindings."
     );
   }
-  const outputDir = path10.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
+  const outputDir = path11.resolve(cwd, options.config.frontend.bindingsOutput, options.contractName);
   await mkdir2(outputDir, { recursive: true });
   const result = await runCommand(
     "npx",
@@ -1589,6 +1682,7 @@ async function generateBindings(options) {
     options.config.frontend.bindingsOutput,
     options.contractName
   );
+  await patchGeneratedBindingPackage(outputDir);
   const marker = {
     version: 1,
     contractId: contractArtifact.contractId,
@@ -1788,8 +1882,8 @@ async function readContract(options) {
 }
 
 // src/templates/create-project-from-template.ts
-import { cp, mkdir as mkdir3, readFile as readFile4, readdir as readdir3, stat as stat2, writeFile as writeFile3 } from "fs/promises";
-import path11 from "path";
+import { cp, mkdir as mkdir3, readFile as readFile5, readdir as readdir3, stat as stat2, writeFile as writeFile4 } from "fs/promises";
+import path12 from "path";
 import { z as z7 } from "zod";
 
 // src/templates/template-manifest.schema.ts
@@ -1860,8 +1954,8 @@ function formatTemplateCompatibilityHint(issue) {
 // src/templates/create-project-from-template.ts
 var TEMPLATE_COPY_EXCLUDED_DIRS = /* @__PURE__ */ new Set(["target", "test_snapshots", "node_modules", ".git"]);
 async function createProjectFromTemplate(options) {
-  const targetDir = path11.resolve(options.targetDir);
-  const templateDir = path11.resolve(options.templateDir);
+  const targetDir = path12.resolve(options.targetDir);
+  const templateDir = path12.resolve(options.templateDir);
   try {
     await stat2(templateDir);
   } catch {
@@ -1902,9 +1996,9 @@ async function ensureArtifacts(targetDir, projectName) {
   }
 }
 async function readTemplateManifest(templateDir) {
-  const manifestPath = path11.join(templateDir, "caatinga.template.json");
+  const manifestPath = path12.join(templateDir, "caatinga.template.json");
   try {
-    const rawManifest = await readFile4(manifestPath, "utf8");
+    const rawManifest = await readFile5(manifestPath, "utf8");
     const manifest = TemplateManifestSchema.parse(JSON.parse(rawManifest));
     const compatibilityIssue = getTemplateCompatibilityIssue(manifest);
     if (compatibilityIssue) {
@@ -1940,7 +2034,7 @@ async function replaceTemplateVariables(dir, projectName) {
   const entries = await readdir3(dir);
   await Promise.all(
     entries.map(async (entry) => {
-      const entryPath = path11.join(dir, entry);
+      const entryPath = path12.join(dir, entry);
       const entryStat = await stat2(entryPath);
       if (entryStat.isDirectory()) {
         await replaceTemplateVariables(entryPath, projectName);
@@ -1949,38 +2043,38 @@ async function replaceTemplateVariables(dir, projectName) {
       if (!isTextTemplateFile(entryPath)) {
         return;
       }
-      const content = await readFile4(entryPath, "utf8");
-      await writeFile3(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
+      const content = await readFile5(entryPath, "utf8");
+      await writeFile4(entryPath, content.replaceAll("__PROJECT_NAME__", projectName), "utf8");
     })
   );
 }
 function shouldCopyTemplateEntry(templateDir, source, userFilter) {
-  const relativePath = path11.relative(templateDir, source);
+  const relativePath = path12.relative(templateDir, source);
   if (!relativePath || relativePath === ".") {
     return true;
   }
-  const normalizedPath = relativePath.split(path11.sep).join("/");
+  const normalizedPath = relativePath.split(path12.sep).join("/");
   if (userFilter && !userFilter(normalizedPath)) {
     return false;
   }
-  return !relativePath.split(path11.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
+  return !relativePath.split(path12.sep).some((segment) => TEMPLATE_COPY_EXCLUDED_DIRS.has(segment));
 }
 function isTextTemplateFile(filePath) {
   return [".json", ".md", ".rs", ".toml", ".ts", ".tsx", ".css", ".html"].includes(
-    path11.extname(filePath)
+    path12.extname(filePath)
   );
 }
 
 // src/scaffold/create-zk-project.ts
-import { cp as cp2, mkdir as mkdir4, writeFile as writeFile4 } from "fs/promises";
+import { cp as cp2, mkdir as mkdir4, writeFile as writeFile5 } from "fs/promises";
 import { existsSync as existsSync2 } from "fs";
-import path12 from "path";
+import path13 from "path";
 import { fileURLToPath } from "url";
-var moduleDir = typeof __dirname === "string" ? __dirname : path12.dirname(fileURLToPath(import.meta.url));
+var moduleDir = typeof __dirname === "string" ? __dirname : path13.dirname(fileURLToPath(import.meta.url));
 function scaffoldRoot() {
   const candidates = [
-    path12.resolve(moduleDir, "../../scaffolds"),
-    path12.resolve(moduleDir, "../scaffolds")
+    path13.resolve(moduleDir, "../../scaffolds"),
+    path13.resolve(moduleDir, "../scaffolds")
   ];
   const found = candidates.find((candidate) => existsSync2(candidate));
   return found ?? candidates[0];
@@ -2071,39 +2165,39 @@ Replace \`circuits/main.circom\` with your circuit. Keep the entry point named \
 `;
 }
 async function createZkProject(options) {
-  const targetDir = path12.resolve(options.targetDir);
+  const targetDir = path13.resolve(options.targetDir);
   const force = options.force ?? false;
   const projectFiles = options.projectFiles ?? true;
   await mkdir4(targetDir, { recursive: true });
   if (projectFiles) {
     await Promise.all([
-      writeFile4(path12.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
+      writeFile5(path13.join(targetDir, "caatinga.config.ts"), configSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      writeFile4(path12.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
+      writeFile5(path13.join(targetDir, "package.json"), packageJsonSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      writeFile4(path12.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+      writeFile5(path13.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       }),
-      writeFile4(path12.join(targetDir, "README.md"), readmeSource(options.projectName), {
+      writeFile5(path13.join(targetDir, "README.md"), readmeSource(options.projectName), {
         encoding: "utf8",
         flag: force ? "w" : "wx"
       })
     ]);
   }
-  await mkdir4(path12.join(targetDir, "contracts"), { recursive: true });
-  await cp2(path12.join(scaffoldRoot(), "zk-circuit-stub"), path12.join(targetDir, "circuits"), {
+  await mkdir4(path13.join(targetDir, "contracts"), { recursive: true });
+  await cp2(path13.join(scaffoldRoot(), "zk-circuit-stub"), path13.join(targetDir, "circuits"), {
     recursive: true,
     force,
     errorOnExist: !force
   });
   await cp2(
-    path12.join(scaffoldRoot(), "zk-verifier"),
-    path12.join(targetDir, "contracts", "verifier"),
+    path13.join(scaffoldRoot(), "zk-verifier"),
+    path13.join(targetDir, "contracts", "verifier"),
     {
       recursive: true,
       force,
@@ -2120,15 +2214,15 @@ async function createZkProject(options) {
 }
 
 // src/scaffold/create-minimal-project.ts
-import { cp as cp3, mkdir as mkdir5, writeFile as writeFile5 } from "fs/promises";
+import { cp as cp3, mkdir as mkdir5, writeFile as writeFile6 } from "fs/promises";
 import { existsSync as existsSync3 } from "fs";
-import path13 from "path";
+import path14 from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-var moduleDir2 = typeof __dirname === "string" ? __dirname : path13.dirname(fileURLToPath2(import.meta.url));
+var moduleDir2 = typeof __dirname === "string" ? __dirname : path14.dirname(fileURLToPath2(import.meta.url));
 function scaffoldRoot2() {
   const candidates = [
-    path13.resolve(moduleDir2, "../../scaffolds"),
-    path13.resolve(moduleDir2, "../scaffolds")
+    path14.resolve(moduleDir2, "../../scaffolds"),
+    path14.resolve(moduleDir2, "../scaffolds")
   ];
   const found = candidates.find((candidate) => existsSync3(candidate));
   return found ?? candidates[0];
@@ -2219,31 +2313,31 @@ Edit \`contracts/app/src/lib.rs\` to customize the contract. Add a frontend late
 `;
 }
 async function createMinimalProject(options) {
-  const targetDir = path13.resolve(options.targetDir);
+  const targetDir = path14.resolve(options.targetDir);
   const force = options.force ?? false;
   await mkdir5(targetDir, { recursive: true });
   await Promise.all([
-    writeFile5(path13.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
+    writeFile6(path14.join(targetDir, "caatinga.config.ts"), configSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    writeFile5(path13.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
+    writeFile6(path14.join(targetDir, "package.json"), packageJsonSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    writeFile5(path13.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
+    writeFile6(path14.join(targetDir, ".gitignore"), "node_modules\n.artifacts\ntarget\n", {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     }),
-    writeFile5(path13.join(targetDir, "README.md"), readmeSource2(options.projectName), {
+    writeFile6(path14.join(targetDir, "README.md"), readmeSource2(options.projectName), {
       encoding: "utf8",
       flag: force ? "w" : "wx"
     })
   ]);
-  await mkdir5(path13.join(targetDir, "contracts"), { recursive: true });
+  await mkdir5(path14.join(targetDir, "contracts"), { recursive: true });
   await cp3(
-    path13.join(scaffoldRoot2(), "soroban-contract-stub"),
-    path13.join(targetDir, "contracts", "app"),
+    path14.join(scaffoldRoot2(), "soroban-contract-stub"),
+    path14.join(targetDir, "contracts", "app"),
     {
       recursive: true,
       force,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caatinga/core",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "Core config, artifacts, command orchestration, and error primitives for Caatinga/Soroban toolkit",
   "keywords": [
     "stellar",