@caatinga/core 2.0.1 → 2.1.0

package/dist/{browser-djYObNl8.d.cts → browser-Cq4ZofIq.d.cts}

@@ -28,6 +28,7 @@ declare const CaatingaErrorCode: {
     readonly DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED";
     readonly BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND";
     readonly BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND";
+    readonly PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING";
     readonly XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED";
     readonly XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED";
     readonly XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED";
@@ -58,6 +59,14 @@ declare class CaatingaError extends Error {
 }
 declare function toCaatingaError(error: unknown): CaatingaError;
 
+/**
+ * Render an error for display. For a {@link CaatingaError} this surfaces the
+ * code, message, and hint, plus the underlying `cause` (when present) so the
+ * real reason — e.g. a wallet rejection or an XDR parse error — is never hidden
+ * behind a generic hint. Falls back to the plain message for other errors.
+ */
+declare function formatCaatingaError(error: unknown): string;
+
 declare const ContractArtifactSchema: z.ZodObject<{
     contractId: z.ZodString;
     wasmHash: z.ZodString;
@@ -170,4 +179,4 @@ declare const CaatingaArtifactsSchema: z.ZodObject<{
 type ContractArtifact = z.infer<typeof ContractArtifactSchema>;
 type CaatingaArtifacts = z.infer<typeof CaatingaArtifactsSchema>;
 
-export { type CaatingaArtifacts as C, type ContractArtifact as a, type CaatingaErrorCodeValue as b, CaatingaError as c, CaatingaArtifactsSchema as d, CaatingaErrorCode as e, toCaatingaError as t };
+export { type CaatingaArtifacts as C, type ContractArtifact as a, type CaatingaErrorCodeValue as b, CaatingaError as c, CaatingaArtifactsSchema as d, CaatingaErrorCode as e, formatCaatingaError as f, toCaatingaError as t };

package/dist/{browser-djYObNl8.d.ts → browser-Cq4ZofIq.d.ts}

@@ -28,6 +28,7 @@ declare const CaatingaErrorCode: {
     readonly DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED";
     readonly BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND";
     readonly BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND";
+    readonly PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING";
     readonly XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED";
     readonly XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED";
     readonly XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED";
@@ -58,6 +59,14 @@ declare class CaatingaError extends Error {
 }
 declare function toCaatingaError(error: unknown): CaatingaError;
 
+/**
+ * Render an error for display. For a {@link CaatingaError} this surfaces the
+ * code, message, and hint, plus the underlying `cause` (when present) so the
+ * real reason — e.g. a wallet rejection or an XDR parse error — is never hidden
+ * behind a generic hint. Falls back to the plain message for other errors.
+ */
+declare function formatCaatingaError(error: unknown): string;
+
 declare const ContractArtifactSchema: z.ZodObject<{
     contractId: z.ZodString;
     wasmHash: z.ZodString;
@@ -170,4 +179,4 @@ declare const CaatingaArtifactsSchema: z.ZodObject<{
 type ContractArtifact = z.infer<typeof ContractArtifactSchema>;
 type CaatingaArtifacts = z.infer<typeof CaatingaArtifactsSchema>;
 
-export { type CaatingaArtifacts as C, type ContractArtifact as a, type CaatingaErrorCodeValue as b, CaatingaError as c, CaatingaArtifactsSchema as d, CaatingaErrorCode as e, toCaatingaError as t };
+export { type CaatingaArtifacts as C, type ContractArtifact as a, type CaatingaErrorCodeValue as b, CaatingaError as c, CaatingaArtifactsSchema as d, CaatingaErrorCode as e, formatCaatingaError as f, toCaatingaError as t };

package/dist/browser.cjs

@@ -22,6 +22,7 @@ var browser_exports = {};
 __export(browser_exports, {
   CaatingaError: () => CaatingaError,
   CaatingaErrorCode: () => CaatingaErrorCode,
+  formatCaatingaError: () => formatCaatingaError,
   toCaatingaError: () => toCaatingaError
 });
 module.exports = __toCommonJS(browser_exports);
@@ -55,6 +56,7 @@ var CaatingaErrorCode = {
   DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED",
   BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND",
   BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND",
+  PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING",
   XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED",
   XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED",
   XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED",
@@ -98,9 +100,42 @@ function toCaatingaError(error) {
   }
   return new CaatingaError("An unexpected error occurred.", CaatingaErrorCode.UNEXPECTED_ERROR);
 }
+
+// src/errors/format-caatinga-error.ts
+function formatCaatingaError(error) {
+  if (error instanceof CaatingaError) {
+    const lines = [`[${error.code}] ${error.message}`];
+    if (error.hint) {
+      lines.push("", error.hint);
+    }
+    const detail = formatCause(error.cause);
+    if (detail) {
+      lines.push("", `Details: ${detail}`);
+    }
+    return lines.join("\n");
+  }
+  return error instanceof Error ? error.message : String(error);
+}
+function formatCause(cause) {
+  if (cause === void 0 || cause === null) {
+    return "";
+  }
+  if (cause instanceof Error) {
+    return cause.message;
+  }
+  if (typeof cause === "string") {
+    return cause;
+  }
+  try {
+    return JSON.stringify(cause);
+  } catch {
+    return String(cause);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CaatingaError,
   CaatingaErrorCode,
+  formatCaatingaError,
   toCaatingaError
 });

package/dist/browser.d.cts

@@ -1,2 +1,2 @@
-export { C as CaatingaArtifacts, c as CaatingaError, e as CaatingaErrorCode, a as ContractArtifact, t as toCaatingaError } from './browser-djYObNl8.cjs';
+export { C as CaatingaArtifacts, c as CaatingaError, e as CaatingaErrorCode, a as ContractArtifact, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.cjs';
 import 'zod';

package/dist/browser.d.ts

@@ -1,2 +1,2 @@
-export { C as CaatingaArtifacts, c as CaatingaError, e as CaatingaErrorCode, a as ContractArtifact, t as toCaatingaError } from './browser-djYObNl8.js';
+export { C as CaatingaArtifacts, c as CaatingaError, e as CaatingaErrorCode, a as ContractArtifact, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.js';
 import 'zod';

package/dist/browser.js

@@ -27,6 +27,7 @@ var CaatingaErrorCode = {
   DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED",
   BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND",
   BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND",
+  PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING",
   XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED",
   XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED",
   XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED",
@@ -70,8 +71,41 @@ function toCaatingaError(error) {
   }
   return new CaatingaError("An unexpected error occurred.", CaatingaErrorCode.UNEXPECTED_ERROR);
 }
+
+// src/errors/format-caatinga-error.ts
+function formatCaatingaError(error) {
+  if (error instanceof CaatingaError) {
+    const lines = [`[${error.code}] ${error.message}`];
+    if (error.hint) {
+      lines.push("", error.hint);
+    }
+    const detail = formatCause(error.cause);
+    if (detail) {
+      lines.push("", `Details: ${detail}`);
+    }
+    return lines.join("\n");
+  }
+  return error instanceof Error ? error.message : String(error);
+}
+function formatCause(cause) {
+  if (cause === void 0 || cause === null) {
+    return "";
+  }
+  if (cause instanceof Error) {
+    return cause.message;
+  }
+  if (typeof cause === "string") {
+    return cause;
+  }
+  try {
+    return JSON.stringify(cause);
+  } catch {
+    return String(cause);
+  }
+}
 export {
   CaatingaError,
   CaatingaErrorCode,
+  formatCaatingaError,
   toCaatingaError
 };

package/dist/index.cjs

@@ -49,7 +49,9 @@ __export(index_exports, {
   deployContract: () => deployContract,
   deployContractGraph: () => deployContractGraph,
   evaluateStellarCliCompatibility: () => evaluateStellarCliCompatibility,
+  formatCaatingaError: () => formatCaatingaError,
   generateBindings: () => generateBindings,
+  generateBindingsGraph: () => generateBindingsGraph,
   invokeContract: () => invokeContract,
   isTransientTestnetSmokeFailure: () => isTransientTestnetSmokeFailure,
   loadConfig: () => loadConfig,
@@ -98,6 +100,7 @@ var CaatingaErrorCode = {
   DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED",
   BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND",
   BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND",
+  PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING",
   XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED",
   XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED",
   XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED",
@@ -142,8 +145,40 @@ function toCaatingaError(error) {
   return new CaatingaError("An unexpected error occurred.", CaatingaErrorCode.UNEXPECTED_ERROR);
 }
 
+// src/errors/format-caatinga-error.ts
+function formatCaatingaError(error) {
+  if (error instanceof CaatingaError) {
+    const lines = [`[${error.code}] ${error.message}`];
+    if (error.hint) {
+      lines.push("", error.hint);
+    }
+    const detail = formatCause(error.cause);
+    if (detail) {
+      lines.push("", `Details: ${detail}`);
+    }
+    return lines.join("\n");
+  }
+  return error instanceof Error ? error.message : String(error);
+}
+function formatCause(cause) {
+  if (cause === void 0 || cause === null) {
+    return "";
+  }
+  if (cause instanceof Error) {
+    return cause.message;
+  }
+  if (typeof cause === "string") {
+    return cause;
+  }
+  try {
+    return JSON.stringify(cause);
+  } catch {
+    return String(cause);
+  }
+}
+
 // src/version.ts
-var CAATINGA_CORE_VERSION = "2.0.1";
+var CAATINGA_CORE_VERSION = "2.1.0";
 
 // src/config/config.schema.ts
 var import_zod = require("zod");
@@ -1202,6 +1237,20 @@ async function deployContractGraph(options) {
 // src/contracts/generate-bindings.ts
 var import_promises5 = require("fs/promises");
 var import_node_path7 = __toESM(require("path"), 1);
+function toBindingImportPath(bindingsOutput, contractName) {
+  const normalized = bindingsOutput.replace(/^\.\//, "").split(import_node_path7.default.sep).join("/");
+  return `./${import_node_path7.default.posix.join(normalized, contractName, "src", "index.js")}`;
+}
+async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
+  const legacyPath = import_node_path7.default.resolve(cwd, bindingsOutput, `${contractName}.ts`);
+  try {
+    await (0, import_promises5.access)(legacyPath);
+    await (0, import_promises5.unlink)(legacyPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function generateBindings(options) {
   const cwd = options.cwd ?? process.cwd();
   const network = resolveNetwork(options.config, options.networkName);
@@ -1231,14 +1280,53 @@ async function generateBindings(options) {
     cwd,
     failureCode: CaatingaErrorCode.BINDINGS_FAILED
   });
+  const legacyStubRemoved = await removeLegacyBindingStub(
+    cwd,
+    options.config.frontend.bindingsOutput,
+    options.contractName
+  );
   return {
     contractName: options.contractName,
     network,
     outputDir,
+    importPath: toBindingImportPath(options.config.frontend.bindingsOutput, options.contractName),
+    legacyStubRemoved,
     output: result.all || result.stdout
   };
 }
 
+// src/contracts/generate-bindings-graph.ts
+async function generateBindingsGraph(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const network = resolveNetwork(options.config, options.networkName);
+  let targets;
+  if (options.contractName) {
+    targets = [options.contractName];
+  } else {
+    const artifacts = await readArtifacts(cwd);
+    targets = Object.keys(artifacts.networks[network.name]?.contracts ?? {});
+    if (targets.length === 0) {
+      throw new CaatingaError(
+        `No deployed contracts found on "${network.name}".`,
+        CaatingaErrorCode.ARTIFACT_NOT_FOUND,
+        "Run caatinga deploy before generating bindings, or pass a contract name."
+      );
+    }
+  }
+  const results = [];
+  for (const contractName of targets) {
+    results.push(
+      await generateBindings({
+        config: options.config,
+        contractName,
+        networkName: network.name,
+        cwd
+      })
+    );
+  }
+  return { network, results };
+}
+
 // src/contracts/invoke-contract.ts
 var INVOKE_SIGNING_FAILURE_REGEX = /xdr processing error: xdr value invalid/i;
 function parseInvokeTarget(target) {
@@ -1535,7 +1623,9 @@ function isTransientTestnetSmokeFailure(logText) {
   deployContract,
   deployContractGraph,
   evaluateStellarCliCompatibility,
+  formatCaatingaError,
   generateBindings,
+  generateBindingsGraph,
   invokeContract,
   isTransientTestnetSmokeFailure,
   loadConfig,

package/dist/index.d.cts

@@ -1,8 +1,8 @@
-import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-djYObNl8.cjs';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-djYObNl8.cjs';
+import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-Cq4ZofIq.cjs';
+export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.cjs';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.0.1";
+declare const CAATINGA_CORE_VERSION = "2.1.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -325,9 +325,22 @@ declare function generateBindings(options: GenerateBindingsOptions): Promise<{
     contractName: string;
     network: ResolvedNetwork;
     outputDir: string;
+    importPath: string;
+    legacyStubRemoved: boolean;
     output: string;
 }>;
 
+type GenerateBindingsGraphResult = {
+    network: ResolvedNetwork;
+    results: Array<Awaited<ReturnType<typeof generateBindings>>>;
+};
+declare function generateBindingsGraph(options: {
+    config: CaatingaConfig;
+    contractName?: string;
+    networkName?: string;
+    cwd?: string;
+}): Promise<GenerateBindingsGraphResult>;
+
 type InvokeTarget = {
     contractName: string;
     method: string;
@@ -466,4 +479,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateStellarCliCompatibility, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };
+export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-djYObNl8.js';
-export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, t as toCaatingaError } from './browser-djYObNl8.js';
+import { C as CaatingaArtifacts, a as ContractArtifact, b as CaatingaErrorCodeValue, c as CaatingaError } from './browser-Cq4ZofIq.js';
+export { d as CaatingaArtifactsSchema, e as CaatingaErrorCode, f as formatCaatingaError, t as toCaatingaError } from './browser-Cq4ZofIq.js';
 import { z } from 'zod';
 
-declare const CAATINGA_CORE_VERSION = "2.0.1";
+declare const CAATINGA_CORE_VERSION = "2.1.0";
 
 declare const ContractConfigSchema: z.ZodObject<{
     path: z.ZodString;
@@ -325,9 +325,22 @@ declare function generateBindings(options: GenerateBindingsOptions): Promise<{
     contractName: string;
     network: ResolvedNetwork;
     outputDir: string;
+    importPath: string;
+    legacyStubRemoved: boolean;
     output: string;
 }>;
 
+type GenerateBindingsGraphResult = {
+    network: ResolvedNetwork;
+    results: Array<Awaited<ReturnType<typeof generateBindings>>>;
+};
+declare function generateBindingsGraph(options: {
+    config: CaatingaConfig;
+    contractName?: string;
+    networkName?: string;
+    cwd?: string;
+}): Promise<GenerateBindingsGraphResult>;
+
 type InvokeTarget = {
     contractName: string;
     method: string;
@@ -466,4 +479,4 @@ type TemplateManifest = z.infer<typeof TemplateManifestSchema>;
 
 declare function isTransientTestnetSmokeFailure(logText: string): boolean;
 
-export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateStellarCliCompatibility, generateBindings, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };
+export { type BuildContractOptions, CAATINGA_CORE_VERSION, CaatingaArtifacts, type CaatingaConfig, CaatingaConfigSchema, CaatingaError, type CheckStellarCliVersionOptions, type CompatibilityReport, type CompatibilityStatus, type CompatibilityWarning, type CompatibilityWarningCode, ContractArtifact, type ContractConfig, type CreateInitialArtifactsOptions, type CreateProjectFromTemplateOptions, type DeployArgValue, type DeployContractGraphResult, type DeployContractOptions, type EvaluateStellarCliCompatibilityInput, type GenerateBindingsGraphResult, type GenerateBindingsOptions, type InvokeContractOptions, type InvokeTarget, type LoadConfigOptions, type NetworkConfig, type ResolvedContract, type ResolvedNetwork, type RunCommandResult, STELLAR_CLI_LAST_TESTED_VERSION, STELLAR_CLI_MIN_VERSION, type SkippedContract, type TemplateManifest, TemplateManifestSchema, WELL_KNOWN_NETWORKS, buildContract, buildDependencyGraph, checkBinary, checkStellarCliVersion, createInitialArtifacts, createProjectFromTemplate, defineConfig, deployContract, deployContractGraph, evaluateStellarCliCompatibility, generateBindings, generateBindingsGraph, invokeContract, isTransientTestnetSmokeFailure, loadConfig, parseContractId, parseInvokeTarget, parseStellarCliVersion, readArtifacts, resolveContract, resolveDeployArgs, resolveDeployOrder, resolveNetwork, runCommand, updateArtifact, validateSourceShape, writeArtifacts };

package/dist/index.js

@@ -27,6 +27,7 @@ var CaatingaErrorCode = {
   DEPLOY_ARG_PLACEHOLDER_UNRESOLVED: "CAATINGA_DEPLOY_ARG_PLACEHOLDER_UNRESOLVED",
   BINDING_CLIENT_NOT_FOUND: "CAATINGA_BINDING_CLIENT_NOT_FOUND",
   BINDING_METHOD_NOT_FOUND: "CAATINGA_BINDING_METHOD_NOT_FOUND",
+  PLACEHOLDER_BINDING: "CAATINGA_PLACEHOLDER_BINDING",
   XDR_BUILD_FAILED: "CAATINGA_XDR_BUILD_FAILED",
   XDR_PREPARE_FAILED: "CAATINGA_XDR_PREPARE_FAILED",
   XDR_SIGN_FAILED: "CAATINGA_XDR_SIGN_FAILED",
@@ -71,8 +72,40 @@ function toCaatingaError(error) {
   return new CaatingaError("An unexpected error occurred.", CaatingaErrorCode.UNEXPECTED_ERROR);
 }
 
+// src/errors/format-caatinga-error.ts
+function formatCaatingaError(error) {
+  if (error instanceof CaatingaError) {
+    const lines = [`[${error.code}] ${error.message}`];
+    if (error.hint) {
+      lines.push("", error.hint);
+    }
+    const detail = formatCause(error.cause);
+    if (detail) {
+      lines.push("", `Details: ${detail}`);
+    }
+    return lines.join("\n");
+  }
+  return error instanceof Error ? error.message : String(error);
+}
+function formatCause(cause) {
+  if (cause === void 0 || cause === null) {
+    return "";
+  }
+  if (cause instanceof Error) {
+    return cause.message;
+  }
+  if (typeof cause === "string") {
+    return cause;
+  }
+  try {
+    return JSON.stringify(cause);
+  } catch {
+    return String(cause);
+  }
+}
+
 // src/version.ts
-var CAATINGA_CORE_VERSION = "2.0.1";
+var CAATINGA_CORE_VERSION = "2.1.0";
 
 // src/config/config.schema.ts
 import { z } from "zod";
@@ -1128,8 +1161,22 @@ async function deployContractGraph(options) {
 }
 
 // src/contracts/generate-bindings.ts
-import { mkdir as mkdir2 } from "fs/promises";
+import { access as access3, mkdir as mkdir2, unlink } from "fs/promises";
 import path7 from "path";
+function toBindingImportPath(bindingsOutput, contractName) {
+  const normalized = bindingsOutput.replace(/^\.\//, "").split(path7.sep).join("/");
+  return `./${path7.posix.join(normalized, contractName, "src", "index.js")}`;
+}
+async function removeLegacyBindingStub(cwd, bindingsOutput, contractName) {
+  const legacyPath = path7.resolve(cwd, bindingsOutput, `${contractName}.ts`);
+  try {
+    await access3(legacyPath);
+    await unlink(legacyPath);
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function generateBindings(options) {
   const cwd = options.cwd ?? process.cwd();
   const network = resolveNetwork(options.config, options.networkName);
@@ -1159,14 +1206,53 @@ async function generateBindings(options) {
     cwd,
     failureCode: CaatingaErrorCode.BINDINGS_FAILED
   });
+  const legacyStubRemoved = await removeLegacyBindingStub(
+    cwd,
+    options.config.frontend.bindingsOutput,
+    options.contractName
+  );
   return {
     contractName: options.contractName,
     network,
     outputDir,
+    importPath: toBindingImportPath(options.config.frontend.bindingsOutput, options.contractName),
+    legacyStubRemoved,
     output: result.all || result.stdout
   };
 }
 
+// src/contracts/generate-bindings-graph.ts
+async function generateBindingsGraph(options) {
+  const cwd = options.cwd ?? process.cwd();
+  const network = resolveNetwork(options.config, options.networkName);
+  let targets;
+  if (options.contractName) {
+    targets = [options.contractName];
+  } else {
+    const artifacts = await readArtifacts(cwd);
+    targets = Object.keys(artifacts.networks[network.name]?.contracts ?? {});
+    if (targets.length === 0) {
+      throw new CaatingaError(
+        `No deployed contracts found on "${network.name}".`,
+        CaatingaErrorCode.ARTIFACT_NOT_FOUND,
+        "Run caatinga deploy before generating bindings, or pass a contract name."
+      );
+    }
+  }
+  const results = [];
+  for (const contractName of targets) {
+    results.push(
+      await generateBindings({
+        config: options.config,
+        contractName,
+        networkName: network.name,
+        cwd
+      })
+    );
+  }
+  return { network, results };
+}
+
 // src/contracts/invoke-contract.ts
 var INVOKE_SIGNING_FAILURE_REGEX = /xdr processing error: xdr value invalid/i;
 function parseInvokeTarget(target) {
@@ -1462,7 +1548,9 @@ export {
   deployContract,
   deployContractGraph,
   evaluateStellarCliCompatibility,
+  formatCaatingaError,
   generateBindings,
+  generateBindingsGraph,
   invokeContract,
   isTransientTestnetSmokeFailure,
   loadConfig,

package/package.json

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