@caatinga/core 2.0.2 → 2.2.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
 };