@medialane/ui 0.256.0 → 0.258.0

package/dist/utils/describe-error.cjs

@@ -19,7 +19,6 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var describe_error_exports = {};
 __export(describe_error_exports, {
   CONNECTION_FAILED: () => CONNECTION_FAILED,
-  GENERIC: () => GENERIC,
   NETWORK_BUSY: () => NETWORK_BUSY,
   NOT_SUBMITTED: () => NOT_SUBMITTED,
   UserFacingError: () => import_sdk.UserFacingError,
@@ -30,15 +29,21 @@ var import_sdk = require("@medialane/sdk");
 var import_wallet_error = require("./wallet-error.js");
 var import_wallet_failure = require("./wallet-failure.js");
 const NOT_SUBMITTED = "Request not completed. Nothing was submitted.";
-const GENERIC = "Something went wrong. Please try again.";
 const NETWORK_BUSY = "Our service is very busy right now. Please try again in a minute.";
 const CONNECTION_FAILED = "We couldn't connect. Check your internet connection and try again.";
-const notice = (title, message, description) => ({
+const notice = (title, message, description, retryable = true) => ({
   title,
   message,
   description,
-  isUserRejection: false
+  isUserRejection: false,
+  retryable
 });
+function unexplained(error) {
+  const id = error?.requestId;
+  const reference = (typeof id === "string" && id !== "" ? id : crypto.randomUUID()).slice(0, 8);
+  console.error("[medialane] unexplained failure", { reference, error });
+  return notice(void 0, `Share reference ${reference} with support.`);
+}
 function isBusy(error) {
   return /-32001|unable to complete request|rate.?limit|too many requests/i.test((0, import_wallet_error.collectErrorText)(error));
 }
@@ -53,14 +58,15 @@ function apiReason(error) {
   }
   return void 0;
 }
-function describeError(error, fallback) {
+function describeError(error) {
   if (error instanceof import_sdk.PasskeyCancelledError || (0, import_wallet_error.isUserRejectedRequest)(error)) {
     const unclear = (0, import_wallet_error.isBareExecuteFailure)(error) || error instanceof import_sdk.PasskeyCancelledError;
     return {
       title: "Request not completed",
       message: NOT_SUBMITTED,
       description: unclear ? "Your wallet didn't complete this request. You may have closed or declined it, it may need extra verification such as 2FA before it can sign, or it may have hit a temporary network hiccup. Try again in a moment." : "Your wallet didn't complete this request. You may have closed or declined it, or it may need extra verification before it can sign.",
-      isUserRejection: true
+      isUserRejection: true,
+      retryable: true
     };
   }
   if ((0, import_wallet_failure.passkeyUnsupportedReason)(error)) {
@@ -74,12 +80,12 @@ function describeError(error, fallback) {
     );
   }
   if (error instanceof import_sdk.UserFacingError) {
-    return notice("Something went wrong", error.message);
+    return notice(void 0, error.message, void 0, error.retryable);
   }
   if (error instanceof import_sdk.MedialaneApiError) {
     if (error.status === 429) return notice("Service busy", NETWORK_BUSY);
-    if (error.status >= 500) return notice("Something went wrong", fallback ?? GENERIC);
-    return notice("Something went wrong", apiReason(error) ?? fallback ?? GENERIC);
+    const reason = error.status >= 500 ? void 0 : apiReason(error);
+    return reason ? notice(void 0, reason) : unexplained(error);
   }
   if (isBusy(error)) {
     return notice("Service busy", NETWORK_BUSY);
@@ -95,12 +101,11 @@ function describeError(error, fallback) {
       "Add funds to your wallet, then try again."
     );
   }
-  return notice("Something went wrong", fallback ?? GENERIC);
+  return unexplained(error);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CONNECTION_FAILED,
-  GENERIC,
   NETWORK_BUSY,
   NOT_SUBMITTED,
   UserFacingError,

package/dist/utils/describe-error.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/describe-error.ts"],"sourcesContent":["import { MedialaneApiError, PasskeyCancelledError, UserFacingError } from \"@medialane/sdk\";\nimport { WrongNetworkError, isBareExecuteFailure, isUserRejectedRequest, collectErrorText } from \"./wallet-error.js\";\nimport { describeWalletFailure, passkeyUnsupportedReason } from \"./wallet-failure.js\";\n\nexport const NOT_SUBMITTED = \"Request not completed. Nothing was submitted.\";\nexport const GENERIC = \"Something went wrong. Please try again.\";\nexport const NETWORK_BUSY = \"Our service is very busy right now. Please try again in a minute.\";\nexport const CONNECTION_FAILED = \"We couldn't connect. Check your internet connection and try again.\";\n\nexport interface ErrorNotice {\n  title: string;\n  message: string;\n  description?: string;\n  isUserRejection: boolean;\n}\n\nconst notice = (title: string, message: string, description?: string): ErrorNotice => ({\n  title,\n  message,\n  description,\n  isUserRejection: false,\n});\n\nfunction isBusy(error: unknown): boolean {\n  return /-32001|unable to complete request|rate.?limit|too many requests/i.test(collectErrorText(error));\n}\n\nfunction isConnectionFailure(error: unknown): boolean {\n  return /failed to fetch|fetch failed|load failed|networkerror when attempting/i.test(collectErrorText(error));\n}\n\nfunction apiReason(error: MedialaneApiError): string | undefined {\n  const body = error.details;\n  if (body && typeof body === \"object\" && \"error\" in body) {\n    const reason = (body as { error?: unknown }).error;\n    if (typeof reason === \"string\" && reason.trim() !== \"\") return reason;\n  }\n  return undefined;\n}\n\nexport function describeError(error: unknown, fallback?: string): ErrorNotice {\n  if (error instanceof PasskeyCancelledError || isUserRejectedRequest(error)) {\n    const unclear = isBareExecuteFailure(error) || error instanceof PasskeyCancelledError;\n    return {\n      title: \"Request not completed\",\n      message: NOT_SUBMITTED,\n      description: unclear\n        ? \"Your wallet didn't complete this request. You may have closed or declined it, it may need extra verification such as 2FA before it can sign, or it may have hit a temporary network hiccup. Try again in a moment.\"\n        : \"Your wallet didn't complete this request. You may have closed or declined it, or it may need extra verification before it can sign.\",\n      isUserRejection: true,\n    };\n  }\n\n  if (passkeyUnsupportedReason(error)) {\n    return notice(\"Passkey not supported\", describeWalletFailure(error).message);\n  }\n\n  if (error instanceof WrongNetworkError) {\n    return notice(\n      \"Wrong network\",\n      \"Your wallet is connected to the wrong network. Nothing was submitted.\",\n      \"Switch your wallet to Starknet Mainnet, then try again.\",\n    );\n  }\n\n  if (error instanceof UserFacingError) {\n    return notice(\"Something went wrong\", error.message);\n  }\n\n  if (error instanceof MedialaneApiError) {\n    if (error.status === 429) return notice(\"Service busy\", NETWORK_BUSY);\n    if (error.status >= 500) return notice(\"Something went wrong\", fallback ?? GENERIC);\n    return notice(\"Something went wrong\", apiReason(error) ?? fallback ?? GENERIC);\n  }\n\n  if (isBusy(error)) {\n    return notice(\"Service busy\", NETWORK_BUSY);\n  }\n\n  if (isConnectionFailure(error)) {\n    return notice(\"Connection problem\", CONNECTION_FAILED);\n  }\n\n  const text = collectErrorText(error).toLowerCase();\n  if (text.includes(\"insufficient\") && /balance|allowance|funds/.test(text)) {\n    return notice(\n      \"Insufficient balance\",\n      \"You don't have enough balance to complete this transaction.\",\n      \"Add funds to your wallet, then try again.\",\n    );\n  }\n\n  return notice(\"Something went wrong\", fallback ?? GENERIC);\n}\n\nexport { UserFacingError };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAA0E;AAC1E,0BAAiG;AACjG,4BAAgE;AAEzD,MAAM,gBAAgB;AACtB,MAAM,UAAU;AAChB,MAAM,eAAe;AACrB,MAAM,oBAAoB;AASjC,MAAM,SAAS,CAAC,OAAe,SAAiB,iBAAuC;AAAA,EACrF;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AACnB;AAEA,SAAS,OAAO,OAAyB;AACvC,SAAO,mEAAmE,SAAK,sCAAiB,KAAK,CAAC;AACxG;AAEA,SAAS,oBAAoB,OAAyB;AACpD,SAAO,yEAAyE,SAAK,sCAAiB,KAAK,CAAC;AAC9G;AAEA,SAAS,UAAU,OAA8C;AAC/D,QAAM,OAAO,MAAM;AACnB,MAAI,QAAQ,OAAO,SAAS,YAAY,WAAW,MAAM;AACvD,UAAM,SAAU,KAA6B;AAC7C,QAAI,OAAO,WAAW,YAAY,OAAO,KAAK,MAAM,GAAI,QAAO;AAAA,EACjE;AACA,SAAO;AACT;AAEO,SAAS,cAAc,OAAgB,UAAgC;AAC5E,MAAI,iBAAiB,wCAAyB,2CAAsB,KAAK,GAAG;AAC1E,UAAM,cAAU,0CAAqB,KAAK,KAAK,iBAAiB;AAChE,WAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,MACT,aAAa,UACT,uNACA;AAAA,MACJ,iBAAiB;AAAA,IACnB;AAAA,EACF;AAEA,UAAI,gDAAyB,KAAK,GAAG;AACnC,WAAO,OAAO,6BAAyB,6CAAsB,KAAK,EAAE,OAAO;AAAA,EAC7E;AAEA,MAAI,iBAAiB,uCAAmB;AACtC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,iBAAiB,4BAAiB;AACpC,WAAO,OAAO,wBAAwB,MAAM,OAAO;AAAA,EACrD;AAEA,MAAI,iBAAiB,8BAAmB;AACtC,QAAI,MAAM,WAAW,IAAK,QAAO,OAAO,gBAAgB,YAAY;AACpE,QAAI,MAAM,UAAU,IAAK,QAAO,OAAO,wBAAwB,YAAY,OAAO;AAClF,WAAO,OAAO,wBAAwB,UAAU,KAAK,KAAK,YAAY,OAAO;AAAA,EAC/E;AAEA,MAAI,OAAO,KAAK,GAAG;AACjB,WAAO,OAAO,gBAAgB,YAAY;AAAA,EAC5C;AAEA,MAAI,oBAAoB,KAAK,GAAG;AAC9B,WAAO,OAAO,sBAAsB,iBAAiB;AAAA,EACvD;AAEA,QAAM,WAAO,sCAAiB,KAAK,EAAE,YAAY;AACjD,MAAI,KAAK,SAAS,cAAc,KAAK,0BAA0B,KAAK,IAAI,GAAG;AACzE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,OAAO,wBAAwB,YAAY,OAAO;AAC3D;","names":[]}
+{"version":3,"sources":["../../src/utils/describe-error.ts"],"sourcesContent":["import { MedialaneApiError, PasskeyCancelledError, UserFacingError } from \"@medialane/sdk\";\nimport { WrongNetworkError, isBareExecuteFailure, isUserRejectedRequest, collectErrorText } from \"./wallet-error.js\";\nimport { describeWalletFailure, passkeyUnsupportedReason } from \"./wallet-failure.js\";\n\nexport const NOT_SUBMITTED = \"Request not completed. Nothing was submitted.\";\nexport const NETWORK_BUSY = \"Our service is very busy right now. Please try again in a minute.\";\nexport const CONNECTION_FAILED = \"We couldn't connect. Check your internet connection and try again.\";\n\nexport interface ErrorNotice {\n  title?: string;\n  message: string;\n  description?: string;\n  isUserRejection: boolean;\n  retryable: boolean;\n}\n\nconst notice = (title: string | undefined, message: string, description?: string, retryable = true): ErrorNotice => ({\n  title,\n  message,\n  description,\n  isUserRejection: false,\n  retryable,\n});\n\nfunction unexplained(error: unknown): ErrorNotice {\n  const id = (error as { requestId?: unknown } | null)?.requestId;\n  const reference = (typeof id === \"string\" && id !== \"\" ? id : crypto.randomUUID()).slice(0, 8);\n  console.error(\"[medialane] unexplained failure\", { reference, error });\n  return notice(undefined, `Share reference ${reference} with support.`);\n}\n\nfunction isBusy(error: unknown): boolean {\n  return /-32001|unable to complete request|rate.?limit|too many requests/i.test(collectErrorText(error));\n}\n\nfunction isConnectionFailure(error: unknown): boolean {\n  return /failed to fetch|fetch failed|load failed|networkerror when attempting/i.test(collectErrorText(error));\n}\n\nfunction apiReason(error: MedialaneApiError): string | undefined {\n  const body = error.details;\n  if (body && typeof body === \"object\" && \"error\" in body) {\n    const reason = (body as { error?: unknown }).error;\n    if (typeof reason === \"string\" && reason.trim() !== \"\") return reason;\n  }\n  return undefined;\n}\n\nexport function describeError(error: unknown): ErrorNotice {\n  if (error instanceof PasskeyCancelledError || isUserRejectedRequest(error)) {\n    const unclear = isBareExecuteFailure(error) || error instanceof PasskeyCancelledError;\n    return {\n      title: \"Request not completed\",\n      message: NOT_SUBMITTED,\n      description: unclear\n        ? \"Your wallet didn't complete this request. You may have closed or declined it, it may need extra verification such as 2FA before it can sign, or it may have hit a temporary network hiccup. Try again in a moment.\"\n        : \"Your wallet didn't complete this request. You may have closed or declined it, or it may need extra verification before it can sign.\",\n      isUserRejection: true,\n      retryable: true,\n    };\n  }\n\n  if (passkeyUnsupportedReason(error)) {\n    return notice(\"Passkey not supported\", describeWalletFailure(error).message);\n  }\n\n  if (error instanceof WrongNetworkError) {\n    return notice(\n      \"Wrong network\",\n      \"Your wallet is connected to the wrong network. Nothing was submitted.\",\n      \"Switch your wallet to Starknet Mainnet, then try again.\",\n    );\n  }\n\n  if (error instanceof UserFacingError) {\n    return notice(undefined, error.message, undefined, error.retryable);\n  }\n\n  if (error instanceof MedialaneApiError) {\n    if (error.status === 429) return notice(\"Service busy\", NETWORK_BUSY);\n    const reason = error.status >= 500 ? undefined : apiReason(error);\n    return reason ? notice(undefined, reason) : unexplained(error);\n  }\n\n  if (isBusy(error)) {\n    return notice(\"Service busy\", NETWORK_BUSY);\n  }\n\n  if (isConnectionFailure(error)) {\n    return notice(\"Connection problem\", CONNECTION_FAILED);\n  }\n\n  const text = collectErrorText(error).toLowerCase();\n  if (text.includes(\"insufficient\") && /balance|allowance|funds/.test(text)) {\n    return notice(\n      \"Insufficient balance\",\n      \"You don't have enough balance to complete this transaction.\",\n      \"Add funds to your wallet, then try again.\",\n    );\n  }\n\n  return unexplained(error);\n}\n\nexport { UserFacingError };\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAA0E;AAC1E,0BAAiG;AACjG,4BAAgE;AAEzD,MAAM,gBAAgB;AACtB,MAAM,eAAe;AACrB,MAAM,oBAAoB;AAUjC,MAAM,SAAS,CAAC,OAA2B,SAAiB,aAAsB,YAAY,UAAuB;AAAA,EACnH;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AAAA,EACjB;AACF;AAEA,SAAS,YAAY,OAA6B;AAChD,QAAM,KAAM,OAA0C;AACtD,QAAM,aAAa,OAAO,OAAO,YAAY,OAAO,KAAK,KAAK,OAAO,WAAW,GAAG,MAAM,GAAG,CAAC;AAC7F,UAAQ,MAAM,mCAAmC,EAAE,WAAW,MAAM,CAAC;AACrE,SAAO,OAAO,QAAW,mBAAmB,SAAS,gBAAgB;AACvE;AAEA,SAAS,OAAO,OAAyB;AACvC,SAAO,mEAAmE,SAAK,sCAAiB,KAAK,CAAC;AACxG;AAEA,SAAS,oBAAoB,OAAyB;AACpD,SAAO,yEAAyE,SAAK,sCAAiB,KAAK,CAAC;AAC9G;AAEA,SAAS,UAAU,OAA8C;AAC/D,QAAM,OAAO,MAAM;AACnB,MAAI,QAAQ,OAAO,SAAS,YAAY,WAAW,MAAM;AACvD,UAAM,SAAU,KAA6B;AAC7C,QAAI,OAAO,WAAW,YAAY,OAAO,KAAK,MAAM,GAAI,QAAO;AAAA,EACjE;AACA,SAAO;AACT;AAEO,SAAS,cAAc,OAA6B;AACzD,MAAI,iBAAiB,wCAAyB,2CAAsB,KAAK,GAAG;AAC1E,UAAM,cAAU,0CAAqB,KAAK,KAAK,iBAAiB;AAChE,WAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,MACT,aAAa,UACT,uNACA;AAAA,MACJ,iBAAiB;AAAA,MACjB,WAAW;AAAA,IACb;AAAA,EACF;AAEA,UAAI,gDAAyB,KAAK,GAAG;AACnC,WAAO,OAAO,6BAAyB,6CAAsB,KAAK,EAAE,OAAO;AAAA,EAC7E;AAEA,MAAI,iBAAiB,uCAAmB;AACtC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,iBAAiB,4BAAiB;AACpC,WAAO,OAAO,QAAW,MAAM,SAAS,QAAW,MAAM,SAAS;AAAA,EACpE;AAEA,MAAI,iBAAiB,8BAAmB;AACtC,QAAI,MAAM,WAAW,IAAK,QAAO,OAAO,gBAAgB,YAAY;AACpE,UAAM,SAAS,MAAM,UAAU,MAAM,SAAY,UAAU,KAAK;AAChE,WAAO,SAAS,OAAO,QAAW,MAAM,IAAI,YAAY,KAAK;AAAA,EAC/D;AAEA,MAAI,OAAO,KAAK,GAAG;AACjB,WAAO,OAAO,gBAAgB,YAAY;AAAA,EAC5C;AAEA,MAAI,oBAAoB,KAAK,GAAG;AAC9B,WAAO,OAAO,sBAAsB,iBAAiB;AAAA,EACvD;AAEA,QAAM,WAAO,sCAAiB,KAAK,EAAE,YAAY;AACjD,MAAI,KAAK,SAAS,cAAc,KAAK,0BAA0B,KAAK,IAAI,GAAG;AACzE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,YAAY,KAAK;AAC1B;","names":[]}

package/dist/utils/describe-error.d.cts

@@ -1,15 +1,15 @@
 export { UserFacingError } from '@medialane/sdk';
 
 declare const NOT_SUBMITTED = "Request not completed. Nothing was submitted.";
-declare const GENERIC = "Something went wrong. Please try again.";
 declare const NETWORK_BUSY = "Our service is very busy right now. Please try again in a minute.";
 declare const CONNECTION_FAILED = "We couldn't connect. Check your internet connection and try again.";
 interface ErrorNotice {
-    title: string;
+    title?: string;
     message: string;
     description?: string;
     isUserRejection: boolean;
+    retryable: boolean;
 }
-declare function describeError(error: unknown, fallback?: string): ErrorNotice;
+declare function describeError(error: unknown): ErrorNotice;
 
-export { CONNECTION_FAILED, type ErrorNotice, GENERIC, NETWORK_BUSY, NOT_SUBMITTED, describeError };
+export { CONNECTION_FAILED, type ErrorNotice, NETWORK_BUSY, NOT_SUBMITTED, describeError };

package/dist/utils/describe-error.d.ts

@@ -1,15 +1,15 @@
 export { UserFacingError } from '@medialane/sdk';
 
 declare const NOT_SUBMITTED = "Request not completed. Nothing was submitted.";
-declare const GENERIC = "Something went wrong. Please try again.";
 declare const NETWORK_BUSY = "Our service is very busy right now. Please try again in a minute.";
 declare const CONNECTION_FAILED = "We couldn't connect. Check your internet connection and try again.";
 interface ErrorNotice {
-    title: string;
+    title?: string;
     message: string;
     description?: string;
     isUserRejection: boolean;
+    retryable: boolean;
 }
-declare function describeError(error: unknown, fallback?: string): ErrorNotice;
+declare function describeError(error: unknown): ErrorNotice;
 
-export { CONNECTION_FAILED, type ErrorNotice, GENERIC, NETWORK_BUSY, NOT_SUBMITTED, describeError };
+export { CONNECTION_FAILED, type ErrorNotice, NETWORK_BUSY, NOT_SUBMITTED, describeError };

package/dist/utils/describe-error.js

@@ -2,15 +2,21 @@ import { MedialaneApiError, PasskeyCancelledError, UserFacingError } from "@medi
 import { WrongNetworkError, isBareExecuteFailure, isUserRejectedRequest, collectErrorText } from "./wallet-error.js";
 import { describeWalletFailure, passkeyUnsupportedReason } from "./wallet-failure.js";
 const NOT_SUBMITTED = "Request not completed. Nothing was submitted.";
-const GENERIC = "Something went wrong. Please try again.";
 const NETWORK_BUSY = "Our service is very busy right now. Please try again in a minute.";
 const CONNECTION_FAILED = "We couldn't connect. Check your internet connection and try again.";
-const notice = (title, message, description) => ({
+const notice = (title, message, description, retryable = true) => ({
   title,
   message,
   description,
-  isUserRejection: false
+  isUserRejection: false,
+  retryable
 });
+function unexplained(error) {
+  const id = error?.requestId;
+  const reference = (typeof id === "string" && id !== "" ? id : crypto.randomUUID()).slice(0, 8);
+  console.error("[medialane] unexplained failure", { reference, error });
+  return notice(void 0, `Share reference ${reference} with support.`);
+}
 function isBusy(error) {
   return /-32001|unable to complete request|rate.?limit|too many requests/i.test(collectErrorText(error));
 }
@@ -25,14 +31,15 @@ function apiReason(error) {
   }
   return void 0;
 }
-function describeError(error, fallback) {
+function describeError(error) {
   if (error instanceof PasskeyCancelledError || isUserRejectedRequest(error)) {
     const unclear = isBareExecuteFailure(error) || error instanceof PasskeyCancelledError;
     return {
       title: "Request not completed",
       message: NOT_SUBMITTED,
       description: unclear ? "Your wallet didn't complete this request. You may have closed or declined it, it may need extra verification such as 2FA before it can sign, or it may have hit a temporary network hiccup. Try again in a moment." : "Your wallet didn't complete this request. You may have closed or declined it, or it may need extra verification before it can sign.",
-      isUserRejection: true
+      isUserRejection: true,
+      retryable: true
     };
   }
   if (passkeyUnsupportedReason(error)) {
@@ -46,12 +53,12 @@ function describeError(error, fallback) {
     );
   }
   if (error instanceof UserFacingError) {
-    return notice("Something went wrong", error.message);
+    return notice(void 0, error.message, void 0, error.retryable);
   }
   if (error instanceof MedialaneApiError) {
     if (error.status === 429) return notice("Service busy", NETWORK_BUSY);
-    if (error.status >= 500) return notice("Something went wrong", fallback ?? GENERIC);
-    return notice("Something went wrong", apiReason(error) ?? fallback ?? GENERIC);
+    const reason = error.status >= 500 ? void 0 : apiReason(error);
+    return reason ? notice(void 0, reason) : unexplained(error);
   }
   if (isBusy(error)) {
     return notice("Service busy", NETWORK_BUSY);
@@ -67,11 +74,10 @@ function describeError(error, fallback) {
       "Add funds to your wallet, then try again."
     );
   }
-  return notice("Something went wrong", fallback ?? GENERIC);
+  return unexplained(error);
 }
 export {
   CONNECTION_FAILED,
-  GENERIC,
   NETWORK_BUSY,
   NOT_SUBMITTED,
   UserFacingError,

package/dist/utils/describe-error.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/describe-error.ts"],"sourcesContent":["import { MedialaneApiError, PasskeyCancelledError, UserFacingError } from \"@medialane/sdk\";\nimport { WrongNetworkError, isBareExecuteFailure, isUserRejectedRequest, collectErrorText } from \"./wallet-error.js\";\nimport { describeWalletFailure, passkeyUnsupportedReason } from \"./wallet-failure.js\";\n\nexport const NOT_SUBMITTED = \"Request not completed. Nothing was submitted.\";\nexport const GENERIC = \"Something went wrong. Please try again.\";\nexport const NETWORK_BUSY = \"Our service is very busy right now. Please try again in a minute.\";\nexport const CONNECTION_FAILED = \"We couldn't connect. Check your internet connection and try again.\";\n\nexport interface ErrorNotice {\n  title: string;\n  message: string;\n  description?: string;\n  isUserRejection: boolean;\n}\n\nconst notice = (title: string, message: string, description?: string): ErrorNotice => ({\n  title,\n  message,\n  description,\n  isUserRejection: false,\n});\n\nfunction isBusy(error: unknown): boolean {\n  return /-32001|unable to complete request|rate.?limit|too many requests/i.test(collectErrorText(error));\n}\n\nfunction isConnectionFailure(error: unknown): boolean {\n  return /failed to fetch|fetch failed|load failed|networkerror when attempting/i.test(collectErrorText(error));\n}\n\nfunction apiReason(error: MedialaneApiError): string | undefined {\n  const body = error.details;\n  if (body && typeof body === \"object\" && \"error\" in body) {\n    const reason = (body as { error?: unknown }).error;\n    if (typeof reason === \"string\" && reason.trim() !== \"\") return reason;\n  }\n  return undefined;\n}\n\nexport function describeError(error: unknown, fallback?: string): ErrorNotice {\n  if (error instanceof PasskeyCancelledError || isUserRejectedRequest(error)) {\n    const unclear = isBareExecuteFailure(error) || error instanceof PasskeyCancelledError;\n    return {\n      title: \"Request not completed\",\n      message: NOT_SUBMITTED,\n      description: unclear\n        ? \"Your wallet didn't complete this request. You may have closed or declined it, it may need extra verification such as 2FA before it can sign, or it may have hit a temporary network hiccup. Try again in a moment.\"\n        : \"Your wallet didn't complete this request. You may have closed or declined it, or it may need extra verification before it can sign.\",\n      isUserRejection: true,\n    };\n  }\n\n  if (passkeyUnsupportedReason(error)) {\n    return notice(\"Passkey not supported\", describeWalletFailure(error).message);\n  }\n\n  if (error instanceof WrongNetworkError) {\n    return notice(\n      \"Wrong network\",\n      \"Your wallet is connected to the wrong network. Nothing was submitted.\",\n      \"Switch your wallet to Starknet Mainnet, then try again.\",\n    );\n  }\n\n  if (error instanceof UserFacingError) {\n    return notice(\"Something went wrong\", error.message);\n  }\n\n  if (error instanceof MedialaneApiError) {\n    if (error.status === 429) return notice(\"Service busy\", NETWORK_BUSY);\n    if (error.status >= 500) return notice(\"Something went wrong\", fallback ?? GENERIC);\n    return notice(\"Something went wrong\", apiReason(error) ?? fallback ?? GENERIC);\n  }\n\n  if (isBusy(error)) {\n    return notice(\"Service busy\", NETWORK_BUSY);\n  }\n\n  if (isConnectionFailure(error)) {\n    return notice(\"Connection problem\", CONNECTION_FAILED);\n  }\n\n  const text = collectErrorText(error).toLowerCase();\n  if (text.includes(\"insufficient\") && /balance|allowance|funds/.test(text)) {\n    return notice(\n      \"Insufficient balance\",\n      \"You don't have enough balance to complete this transaction.\",\n      \"Add funds to your wallet, then try again.\",\n    );\n  }\n\n  return notice(\"Something went wrong\", fallback ?? GENERIC);\n}\n\nexport { UserFacingError };\n"],"mappings":"AAAA,SAAS,mBAAmB,uBAAuB,uBAAuB;AAC1E,SAAS,mBAAmB,sBAAsB,uBAAuB,wBAAwB;AACjG,SAAS,uBAAuB,gCAAgC;AAEzD,MAAM,gBAAgB;AACtB,MAAM,UAAU;AAChB,MAAM,eAAe;AACrB,MAAM,oBAAoB;AASjC,MAAM,SAAS,CAAC,OAAe,SAAiB,iBAAuC;AAAA,EACrF;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AACnB;AAEA,SAAS,OAAO,OAAyB;AACvC,SAAO,mEAAmE,KAAK,iBAAiB,KAAK,CAAC;AACxG;AAEA,SAAS,oBAAoB,OAAyB;AACpD,SAAO,yEAAyE,KAAK,iBAAiB,KAAK,CAAC;AAC9G;AAEA,SAAS,UAAU,OAA8C;AAC/D,QAAM,OAAO,MAAM;AACnB,MAAI,QAAQ,OAAO,SAAS,YAAY,WAAW,MAAM;AACvD,UAAM,SAAU,KAA6B;AAC7C,QAAI,OAAO,WAAW,YAAY,OAAO,KAAK,MAAM,GAAI,QAAO;AAAA,EACjE;AACA,SAAO;AACT;AAEO,SAAS,cAAc,OAAgB,UAAgC;AAC5E,MAAI,iBAAiB,yBAAyB,sBAAsB,KAAK,GAAG;AAC1E,UAAM,UAAU,qBAAqB,KAAK,KAAK,iBAAiB;AAChE,WAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,MACT,aAAa,UACT,uNACA;AAAA,MACJ,iBAAiB;AAAA,IACnB;AAAA,EACF;AAEA,MAAI,yBAAyB,KAAK,GAAG;AACnC,WAAO,OAAO,yBAAyB,sBAAsB,KAAK,EAAE,OAAO;AAAA,EAC7E;AAEA,MAAI,iBAAiB,mBAAmB;AACtC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,iBAAiB,iBAAiB;AACpC,WAAO,OAAO,wBAAwB,MAAM,OAAO;AAAA,EACrD;AAEA,MAAI,iBAAiB,mBAAmB;AACtC,QAAI,MAAM,WAAW,IAAK,QAAO,OAAO,gBAAgB,YAAY;AACpE,QAAI,MAAM,UAAU,IAAK,QAAO,OAAO,wBAAwB,YAAY,OAAO;AAClF,WAAO,OAAO,wBAAwB,UAAU,KAAK,KAAK,YAAY,OAAO;AAAA,EAC/E;AAEA,MAAI,OAAO,KAAK,GAAG;AACjB,WAAO,OAAO,gBAAgB,YAAY;AAAA,EAC5C;AAEA,MAAI,oBAAoB,KAAK,GAAG;AAC9B,WAAO,OAAO,sBAAsB,iBAAiB;AAAA,EACvD;AAEA,QAAM,OAAO,iBAAiB,KAAK,EAAE,YAAY;AACjD,MAAI,KAAK,SAAS,cAAc,KAAK,0BAA0B,KAAK,IAAI,GAAG;AACzE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,OAAO,wBAAwB,YAAY,OAAO;AAC3D;","names":[]}
+{"version":3,"sources":["../../src/utils/describe-error.ts"],"sourcesContent":["import { MedialaneApiError, PasskeyCancelledError, UserFacingError } from \"@medialane/sdk\";\nimport { WrongNetworkError, isBareExecuteFailure, isUserRejectedRequest, collectErrorText } from \"./wallet-error.js\";\nimport { describeWalletFailure, passkeyUnsupportedReason } from \"./wallet-failure.js\";\n\nexport const NOT_SUBMITTED = \"Request not completed. Nothing was submitted.\";\nexport const NETWORK_BUSY = \"Our service is very busy right now. Please try again in a minute.\";\nexport const CONNECTION_FAILED = \"We couldn't connect. Check your internet connection and try again.\";\n\nexport interface ErrorNotice {\n  title?: string;\n  message: string;\n  description?: string;\n  isUserRejection: boolean;\n  retryable: boolean;\n}\n\nconst notice = (title: string | undefined, message: string, description?: string, retryable = true): ErrorNotice => ({\n  title,\n  message,\n  description,\n  isUserRejection: false,\n  retryable,\n});\n\nfunction unexplained(error: unknown): ErrorNotice {\n  const id = (error as { requestId?: unknown } | null)?.requestId;\n  const reference = (typeof id === \"string\" && id !== \"\" ? id : crypto.randomUUID()).slice(0, 8);\n  console.error(\"[medialane] unexplained failure\", { reference, error });\n  return notice(undefined, `Share reference ${reference} with support.`);\n}\n\nfunction isBusy(error: unknown): boolean {\n  return /-32001|unable to complete request|rate.?limit|too many requests/i.test(collectErrorText(error));\n}\n\nfunction isConnectionFailure(error: unknown): boolean {\n  return /failed to fetch|fetch failed|load failed|networkerror when attempting/i.test(collectErrorText(error));\n}\n\nfunction apiReason(error: MedialaneApiError): string | undefined {\n  const body = error.details;\n  if (body && typeof body === \"object\" && \"error\" in body) {\n    const reason = (body as { error?: unknown }).error;\n    if (typeof reason === \"string\" && reason.trim() !== \"\") return reason;\n  }\n  return undefined;\n}\n\nexport function describeError(error: unknown): ErrorNotice {\n  if (error instanceof PasskeyCancelledError || isUserRejectedRequest(error)) {\n    const unclear = isBareExecuteFailure(error) || error instanceof PasskeyCancelledError;\n    return {\n      title: \"Request not completed\",\n      message: NOT_SUBMITTED,\n      description: unclear\n        ? \"Your wallet didn't complete this request. You may have closed or declined it, it may need extra verification such as 2FA before it can sign, or it may have hit a temporary network hiccup. Try again in a moment.\"\n        : \"Your wallet didn't complete this request. You may have closed or declined it, or it may need extra verification before it can sign.\",\n      isUserRejection: true,\n      retryable: true,\n    };\n  }\n\n  if (passkeyUnsupportedReason(error)) {\n    return notice(\"Passkey not supported\", describeWalletFailure(error).message);\n  }\n\n  if (error instanceof WrongNetworkError) {\n    return notice(\n      \"Wrong network\",\n      \"Your wallet is connected to the wrong network. Nothing was submitted.\",\n      \"Switch your wallet to Starknet Mainnet, then try again.\",\n    );\n  }\n\n  if (error instanceof UserFacingError) {\n    return notice(undefined, error.message, undefined, error.retryable);\n  }\n\n  if (error instanceof MedialaneApiError) {\n    if (error.status === 429) return notice(\"Service busy\", NETWORK_BUSY);\n    const reason = error.status >= 500 ? undefined : apiReason(error);\n    return reason ? notice(undefined, reason) : unexplained(error);\n  }\n\n  if (isBusy(error)) {\n    return notice(\"Service busy\", NETWORK_BUSY);\n  }\n\n  if (isConnectionFailure(error)) {\n    return notice(\"Connection problem\", CONNECTION_FAILED);\n  }\n\n  const text = collectErrorText(error).toLowerCase();\n  if (text.includes(\"insufficient\") && /balance|allowance|funds/.test(text)) {\n    return notice(\n      \"Insufficient balance\",\n      \"You don't have enough balance to complete this transaction.\",\n      \"Add funds to your wallet, then try again.\",\n    );\n  }\n\n  return unexplained(error);\n}\n\nexport { UserFacingError };\n"],"mappings":"AAAA,SAAS,mBAAmB,uBAAuB,uBAAuB;AAC1E,SAAS,mBAAmB,sBAAsB,uBAAuB,wBAAwB;AACjG,SAAS,uBAAuB,gCAAgC;AAEzD,MAAM,gBAAgB;AACtB,MAAM,eAAe;AACrB,MAAM,oBAAoB;AAUjC,MAAM,SAAS,CAAC,OAA2B,SAAiB,aAAsB,YAAY,UAAuB;AAAA,EACnH;AAAA,EACA;AAAA,EACA;AAAA,EACA,iBAAiB;AAAA,EACjB;AACF;AAEA,SAAS,YAAY,OAA6B;AAChD,QAAM,KAAM,OAA0C;AACtD,QAAM,aAAa,OAAO,OAAO,YAAY,OAAO,KAAK,KAAK,OAAO,WAAW,GAAG,MAAM,GAAG,CAAC;AAC7F,UAAQ,MAAM,mCAAmC,EAAE,WAAW,MAAM,CAAC;AACrE,SAAO,OAAO,QAAW,mBAAmB,SAAS,gBAAgB;AACvE;AAEA,SAAS,OAAO,OAAyB;AACvC,SAAO,mEAAmE,KAAK,iBAAiB,KAAK,CAAC;AACxG;AAEA,SAAS,oBAAoB,OAAyB;AACpD,SAAO,yEAAyE,KAAK,iBAAiB,KAAK,CAAC;AAC9G;AAEA,SAAS,UAAU,OAA8C;AAC/D,QAAM,OAAO,MAAM;AACnB,MAAI,QAAQ,OAAO,SAAS,YAAY,WAAW,MAAM;AACvD,UAAM,SAAU,KAA6B;AAC7C,QAAI,OAAO,WAAW,YAAY,OAAO,KAAK,MAAM,GAAI,QAAO;AAAA,EACjE;AACA,SAAO;AACT;AAEO,SAAS,cAAc,OAA6B;AACzD,MAAI,iBAAiB,yBAAyB,sBAAsB,KAAK,GAAG;AAC1E,UAAM,UAAU,qBAAqB,KAAK,KAAK,iBAAiB;AAChE,WAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,MACT,aAAa,UACT,uNACA;AAAA,MACJ,iBAAiB;AAAA,MACjB,WAAW;AAAA,IACb;AAAA,EACF;AAEA,MAAI,yBAAyB,KAAK,GAAG;AACnC,WAAO,OAAO,yBAAyB,sBAAsB,KAAK,EAAE,OAAO;AAAA,EAC7E;AAEA,MAAI,iBAAiB,mBAAmB;AACtC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,iBAAiB,iBAAiB;AACpC,WAAO,OAAO,QAAW,MAAM,SAAS,QAAW,MAAM,SAAS;AAAA,EACpE;AAEA,MAAI,iBAAiB,mBAAmB;AACtC,QAAI,MAAM,WAAW,IAAK,QAAO,OAAO,gBAAgB,YAAY;AACpE,UAAM,SAAS,MAAM,UAAU,MAAM,SAAY,UAAU,KAAK;AAChE,WAAO,SAAS,OAAO,QAAW,MAAM,IAAI,YAAY,KAAK;AAAA,EAC/D;AAEA,MAAI,OAAO,KAAK,GAAG;AACjB,WAAO,OAAO,gBAAgB,YAAY;AAAA,EAC5C;AAEA,MAAI,oBAAoB,KAAK,GAAG;AAC9B,WAAO,OAAO,sBAAsB,iBAAiB;AAAA,EACvD;AAEA,QAAM,OAAO,iBAAiB,KAAK,EAAE,YAAY;AACjD,MAAI,KAAK,SAAS,cAAc,KAAK,0BAA0B,KAAK,IAAI,GAAG;AACzE,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,SAAO,YAAY,KAAK;AAC1B;","names":[]}

package/dist/utils/media-wallet/use-erc20-balance.d.cts

@@ -7,7 +7,7 @@ declare function useTokenBalance(symbol: string | null, holderAddress: string |
     rawBalance: bigint | null;
     isLoading: boolean;
     error: any;
-    decimals: 6 | 8 | 18;
+    decimals: 8 | 6 | 18;
 };
 declare function hasSufficientBalance(rawBalance: bigint | null, requiredHuman: string, decimals: number): boolean | null;
 

package/dist/utils/media-wallet/use-erc20-balance.d.ts

@@ -7,7 +7,7 @@ declare function useTokenBalance(symbol: string | null, holderAddress: string |
     rawBalance: bigint | null;
     isLoading: boolean;
     error: any;
-    decimals: 6 | 8 | 18;
+    decimals: 8 | 6 | 18;
 };
 declare function hasSufficientBalance(rawBalance: bigint | null, requiredHuman: string, decimals: number): boolean | null;
 

package/dist/utils/use-email-code.cjs

@@ -41,7 +41,7 @@ function useEmailCode(email, api) {
         dispatch({ type: "send-succeeded" });
         return true;
       } catch (err) {
-        dispatch({ type: "send-failed", message: (0, import_describe_error.describeError)(err, "Couldn't send the code. Please try again.").message });
+        dispatch({ type: "send-failed", message: (0, import_describe_error.describeError)(err).message });
         return false;
       }
     },
@@ -57,7 +57,7 @@ function useEmailCode(email, api) {
         await after?.();
         return true;
       } catch (err) {
-        dispatch({ type: "verify-failed", message: (0, import_describe_error.describeError)(err, "Incorrect code. Please try again.").message });
+        dispatch({ type: "verify-failed", message: (0, import_describe_error.describeError)(err).message });
         return false;
       }
     },

package/dist/utils/use-email-code.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/use-email-code.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useReducer } from \"react\";\nimport type { AccountApi } from \"@medialane/sdk\";\nimport { describeError } from \"./describe-error.js\";\nimport { emailCodeReducer, initialEmailCodeState, type EmailCodeState } from \"./email-code.js\";\n\nexport type EmailCodeApi = Pick<AccountApi, \"requestEmailCode\" | \"verifyEmailCode\">;\n\nexport interface EmailCode {\n  state: EmailCodeState;\n  setCode(code: string): void;\n  send(to?: string): Promise<boolean>;\n  fail(message: string): void;\n  verify(options?: { code?: string; after?: () => Promise<void> | void }): Promise<boolean>;\n  markReady(): void;\n}\n\nexport function useEmailCode(email: string | null, api: () => EmailCodeApi): EmailCode {\n  const [state, dispatch] = useReducer(emailCodeReducer, initialEmailCodeState);\n\n  useEffect(() => {\n    if (state.cooldown === 0) return;\n    const id = setTimeout(() => dispatch({ type: \"tick\" }), 1000);\n    return () => clearTimeout(id);\n  }, [state.cooldown]);\n\n  const send = useCallback(\n    async (to = email) => {\n      if (!to) return false;\n      dispatch({ type: \"send-started\" });\n      try {\n        await api().requestEmailCode(to);\n        dispatch({ type: \"send-succeeded\" });\n        return true;\n      } catch (err) {\n        dispatch({ type: \"send-failed\", message: describeError(err, \"Couldn't send the code. Please try again.\").message });\n        return false;\n      }\n    },\n    [email, api],\n  );\n\n  const verify = useCallback<EmailCode[\"verify\"]>(\n    async ({ code, after } = {}) => {\n      const toVerify = code ?? state.code;\n      if (!email || toVerify.length !== 6) return false;\n      dispatch({ type: \"verify-started\" });\n      try {\n        await api().verifyEmailCode(email, toVerify);\n        await after?.();\n        return true;\n      } catch (err) {\n        dispatch({ type: \"verify-failed\", message: describeError(err, \"Incorrect code. Please try again.\").message });\n        return false;\n      }\n    },\n    [email, state.code, api],\n  );\n\n  const setCode = useCallback((code: string) => dispatch({ type: \"code-changed\", code }), []);\n  const markReady = useCallback(() => dispatch({ type: \"send-succeeded\" }), []);\n  const fail = useCallback((message: string) => dispatch({ type: \"verify-failed\", message }), []);\n\n  return { state, setCode, send, verify, markReady, fail };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAmD;AAEnD,4BAA8B;AAC9B,wBAA6E;AAatE,SAAS,aAAa,OAAsB,KAAoC;AACrF,QAAM,CAAC,OAAO,QAAQ,QAAI,yBAAW,oCAAkB,uCAAqB;AAE5E,8BAAU,MAAM;AACd,QAAI,MAAM,aAAa,EAAG;AAC1B,UAAM,KAAK,WAAW,MAAM,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,GAAI;AAC5D,WAAO,MAAM,aAAa,EAAE;AAAA,EAC9B,GAAG,CAAC,MAAM,QAAQ,CAAC;AAEnB,QAAM,WAAO;AAAA,IACX,OAAO,KAAK,UAAU;AACpB,UAAI,CAAC,GAAI,QAAO;AAChB,eAAS,EAAE,MAAM,eAAe,CAAC;AACjC,UAAI;AACF,cAAM,IAAI,EAAE,iBAAiB,EAAE;AAC/B,iBAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,eAAe,aAAS,qCAAc,KAAK,2CAA2C,EAAE,QAAQ,CAAC;AAClH,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,GAAG;AAAA,EACb;AAEA,QAAM,aAAS;AAAA,IACb,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC,MAAM;AAC9B,YAAM,WAAW,QAAQ,MAAM;AAC/B,UAAI,CAAC,SAAS,SAAS,WAAW,EAAG,QAAO;AAC5C,eAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,UAAI;AACF,cAAM,IAAI,EAAE,gBAAgB,OAAO,QAAQ;AAC3C,cAAM,QAAQ;AACd,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,iBAAiB,aAAS,qCAAc,KAAK,mCAAmC,EAAE,QAAQ,CAAC;AAC5G,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,MAAM,MAAM,GAAG;AAAA,EACzB;AAEA,QAAM,cAAU,0BAAY,CAAC,SAAiB,SAAS,EAAE,MAAM,gBAAgB,KAAK,CAAC,GAAG,CAAC,CAAC;AAC1F,QAAM,gBAAY,0BAAY,MAAM,SAAS,EAAE,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC5E,QAAM,WAAO,0BAAY,CAAC,YAAoB,SAAS,EAAE,MAAM,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE9F,SAAO,EAAE,OAAO,SAAS,MAAM,QAAQ,WAAW,KAAK;AACzD;","names":[]}
+{"version":3,"sources":["../../src/utils/use-email-code.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useReducer } from \"react\";\nimport type { AccountApi } from \"@medialane/sdk\";\nimport { describeError } from \"./describe-error.js\";\nimport { emailCodeReducer, initialEmailCodeState, type EmailCodeState } from \"./email-code.js\";\n\nexport type EmailCodeApi = Pick<AccountApi, \"requestEmailCode\" | \"verifyEmailCode\">;\n\nexport interface EmailCode {\n  state: EmailCodeState;\n  setCode(code: string): void;\n  send(to?: string): Promise<boolean>;\n  fail(message: string): void;\n  verify(options?: { code?: string; after?: () => Promise<void> | void }): Promise<boolean>;\n  markReady(): void;\n}\n\nexport function useEmailCode(email: string | null, api: () => EmailCodeApi): EmailCode {\n  const [state, dispatch] = useReducer(emailCodeReducer, initialEmailCodeState);\n\n  useEffect(() => {\n    if (state.cooldown === 0) return;\n    const id = setTimeout(() => dispatch({ type: \"tick\" }), 1000);\n    return () => clearTimeout(id);\n  }, [state.cooldown]);\n\n  const send = useCallback(\n    async (to = email) => {\n      if (!to) return false;\n      dispatch({ type: \"send-started\" });\n      try {\n        await api().requestEmailCode(to);\n        dispatch({ type: \"send-succeeded\" });\n        return true;\n      } catch (err) {\n        dispatch({ type: \"send-failed\", message: describeError(err).message });\n        return false;\n      }\n    },\n    [email, api],\n  );\n\n  const verify = useCallback<EmailCode[\"verify\"]>(\n    async ({ code, after } = {}) => {\n      const toVerify = code ?? state.code;\n      if (!email || toVerify.length !== 6) return false;\n      dispatch({ type: \"verify-started\" });\n      try {\n        await api().verifyEmailCode(email, toVerify);\n        await after?.();\n        return true;\n      } catch (err) {\n        dispatch({ type: \"verify-failed\", message: describeError(err).message });\n        return false;\n      }\n    },\n    [email, state.code, api],\n  );\n\n  const setCode = useCallback((code: string) => dispatch({ type: \"code-changed\", code }), []);\n  const markReady = useCallback(() => dispatch({ type: \"send-succeeded\" }), []);\n  const fail = useCallback((message: string) => dispatch({ type: \"verify-failed\", message }), []);\n\n  return { state, setCode, send, verify, markReady, fail };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAmD;AAEnD,4BAA8B;AAC9B,wBAA6E;AAatE,SAAS,aAAa,OAAsB,KAAoC;AACrF,QAAM,CAAC,OAAO,QAAQ,QAAI,yBAAW,oCAAkB,uCAAqB;AAE5E,8BAAU,MAAM;AACd,QAAI,MAAM,aAAa,EAAG;AAC1B,UAAM,KAAK,WAAW,MAAM,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,GAAI;AAC5D,WAAO,MAAM,aAAa,EAAE;AAAA,EAC9B,GAAG,CAAC,MAAM,QAAQ,CAAC;AAEnB,QAAM,WAAO;AAAA,IACX,OAAO,KAAK,UAAU;AACpB,UAAI,CAAC,GAAI,QAAO;AAChB,eAAS,EAAE,MAAM,eAAe,CAAC;AACjC,UAAI;AACF,cAAM,IAAI,EAAE,iBAAiB,EAAE;AAC/B,iBAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,eAAe,aAAS,qCAAc,GAAG,EAAE,QAAQ,CAAC;AACrE,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,GAAG;AAAA,EACb;AAEA,QAAM,aAAS;AAAA,IACb,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC,MAAM;AAC9B,YAAM,WAAW,QAAQ,MAAM;AAC/B,UAAI,CAAC,SAAS,SAAS,WAAW,EAAG,QAAO;AAC5C,eAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,UAAI;AACF,cAAM,IAAI,EAAE,gBAAgB,OAAO,QAAQ;AAC3C,cAAM,QAAQ;AACd,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,iBAAiB,aAAS,qCAAc,GAAG,EAAE,QAAQ,CAAC;AACvE,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,MAAM,MAAM,GAAG;AAAA,EACzB;AAEA,QAAM,cAAU,0BAAY,CAAC,SAAiB,SAAS,EAAE,MAAM,gBAAgB,KAAK,CAAC,GAAG,CAAC,CAAC;AAC1F,QAAM,gBAAY,0BAAY,MAAM,SAAS,EAAE,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC5E,QAAM,WAAO,0BAAY,CAAC,YAAoB,SAAS,EAAE,MAAM,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE9F,SAAO,EAAE,OAAO,SAAS,MAAM,QAAQ,WAAW,KAAK;AACzD;","names":[]}

package/dist/utils/use-email-code.js

@@ -18,7 +18,7 @@ function useEmailCode(email, api) {
         dispatch({ type: "send-succeeded" });
         return true;
       } catch (err) {
-        dispatch({ type: "send-failed", message: describeError(err, "Couldn't send the code. Please try again.").message });
+        dispatch({ type: "send-failed", message: describeError(err).message });
         return false;
       }
     },
@@ -34,7 +34,7 @@ function useEmailCode(email, api) {
         await after?.();
         return true;
       } catch (err) {
-        dispatch({ type: "verify-failed", message: describeError(err, "Incorrect code. Please try again.").message });
+        dispatch({ type: "verify-failed", message: describeError(err).message });
         return false;
       }
     },

package/dist/utils/use-email-code.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/use-email-code.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useReducer } from \"react\";\nimport type { AccountApi } from \"@medialane/sdk\";\nimport { describeError } from \"./describe-error.js\";\nimport { emailCodeReducer, initialEmailCodeState, type EmailCodeState } from \"./email-code.js\";\n\nexport type EmailCodeApi = Pick<AccountApi, \"requestEmailCode\" | \"verifyEmailCode\">;\n\nexport interface EmailCode {\n  state: EmailCodeState;\n  setCode(code: string): void;\n  send(to?: string): Promise<boolean>;\n  fail(message: string): void;\n  verify(options?: { code?: string; after?: () => Promise<void> | void }): Promise<boolean>;\n  markReady(): void;\n}\n\nexport function useEmailCode(email: string | null, api: () => EmailCodeApi): EmailCode {\n  const [state, dispatch] = useReducer(emailCodeReducer, initialEmailCodeState);\n\n  useEffect(() => {\n    if (state.cooldown === 0) return;\n    const id = setTimeout(() => dispatch({ type: \"tick\" }), 1000);\n    return () => clearTimeout(id);\n  }, [state.cooldown]);\n\n  const send = useCallback(\n    async (to = email) => {\n      if (!to) return false;\n      dispatch({ type: \"send-started\" });\n      try {\n        await api().requestEmailCode(to);\n        dispatch({ type: \"send-succeeded\" });\n        return true;\n      } catch (err) {\n        dispatch({ type: \"send-failed\", message: describeError(err, \"Couldn't send the code. Please try again.\").message });\n        return false;\n      }\n    },\n    [email, api],\n  );\n\n  const verify = useCallback<EmailCode[\"verify\"]>(\n    async ({ code, after } = {}) => {\n      const toVerify = code ?? state.code;\n      if (!email || toVerify.length !== 6) return false;\n      dispatch({ type: \"verify-started\" });\n      try {\n        await api().verifyEmailCode(email, toVerify);\n        await after?.();\n        return true;\n      } catch (err) {\n        dispatch({ type: \"verify-failed\", message: describeError(err, \"Incorrect code. Please try again.\").message });\n        return false;\n      }\n    },\n    [email, state.code, api],\n  );\n\n  const setCode = useCallback((code: string) => dispatch({ type: \"code-changed\", code }), []);\n  const markReady = useCallback(() => dispatch({ type: \"send-succeeded\" }), []);\n  const fail = useCallback((message: string) => dispatch({ type: \"verify-failed\", message }), []);\n\n  return { state, setCode, send, verify, markReady, fail };\n}\n"],"mappings":";AAEA,SAAS,aAAa,WAAW,kBAAkB;AAEnD,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB,6BAAkD;AAatE,SAAS,aAAa,OAAsB,KAAoC;AACrF,QAAM,CAAC,OAAO,QAAQ,IAAI,WAAW,kBAAkB,qBAAqB;AAE5E,YAAU,MAAM;AACd,QAAI,MAAM,aAAa,EAAG;AAC1B,UAAM,KAAK,WAAW,MAAM,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,GAAI;AAC5D,WAAO,MAAM,aAAa,EAAE;AAAA,EAC9B,GAAG,CAAC,MAAM,QAAQ,CAAC;AAEnB,QAAM,OAAO;AAAA,IACX,OAAO,KAAK,UAAU;AACpB,UAAI,CAAC,GAAI,QAAO;AAChB,eAAS,EAAE,MAAM,eAAe,CAAC;AACjC,UAAI;AACF,cAAM,IAAI,EAAE,iBAAiB,EAAE;AAC/B,iBAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,eAAe,SAAS,cAAc,KAAK,2CAA2C,EAAE,QAAQ,CAAC;AAClH,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,GAAG;AAAA,EACb;AAEA,QAAM,SAAS;AAAA,IACb,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC,MAAM;AAC9B,YAAM,WAAW,QAAQ,MAAM;AAC/B,UAAI,CAAC,SAAS,SAAS,WAAW,EAAG,QAAO;AAC5C,eAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,UAAI;AACF,cAAM,IAAI,EAAE,gBAAgB,OAAO,QAAQ;AAC3C,cAAM,QAAQ;AACd,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,iBAAiB,SAAS,cAAc,KAAK,mCAAmC,EAAE,QAAQ,CAAC;AAC5G,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,MAAM,MAAM,GAAG;AAAA,EACzB;AAEA,QAAM,UAAU,YAAY,CAAC,SAAiB,SAAS,EAAE,MAAM,gBAAgB,KAAK,CAAC,GAAG,CAAC,CAAC;AAC1F,QAAM,YAAY,YAAY,MAAM,SAAS,EAAE,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC5E,QAAM,OAAO,YAAY,CAAC,YAAoB,SAAS,EAAE,MAAM,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE9F,SAAO,EAAE,OAAO,SAAS,MAAM,QAAQ,WAAW,KAAK;AACzD;","names":[]}
+{"version":3,"sources":["../../src/utils/use-email-code.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useReducer } from \"react\";\nimport type { AccountApi } from \"@medialane/sdk\";\nimport { describeError } from \"./describe-error.js\";\nimport { emailCodeReducer, initialEmailCodeState, type EmailCodeState } from \"./email-code.js\";\n\nexport type EmailCodeApi = Pick<AccountApi, \"requestEmailCode\" | \"verifyEmailCode\">;\n\nexport interface EmailCode {\n  state: EmailCodeState;\n  setCode(code: string): void;\n  send(to?: string): Promise<boolean>;\n  fail(message: string): void;\n  verify(options?: { code?: string; after?: () => Promise<void> | void }): Promise<boolean>;\n  markReady(): void;\n}\n\nexport function useEmailCode(email: string | null, api: () => EmailCodeApi): EmailCode {\n  const [state, dispatch] = useReducer(emailCodeReducer, initialEmailCodeState);\n\n  useEffect(() => {\n    if (state.cooldown === 0) return;\n    const id = setTimeout(() => dispatch({ type: \"tick\" }), 1000);\n    return () => clearTimeout(id);\n  }, [state.cooldown]);\n\n  const send = useCallback(\n    async (to = email) => {\n      if (!to) return false;\n      dispatch({ type: \"send-started\" });\n      try {\n        await api().requestEmailCode(to);\n        dispatch({ type: \"send-succeeded\" });\n        return true;\n      } catch (err) {\n        dispatch({ type: \"send-failed\", message: describeError(err).message });\n        return false;\n      }\n    },\n    [email, api],\n  );\n\n  const verify = useCallback<EmailCode[\"verify\"]>(\n    async ({ code, after } = {}) => {\n      const toVerify = code ?? state.code;\n      if (!email || toVerify.length !== 6) return false;\n      dispatch({ type: \"verify-started\" });\n      try {\n        await api().verifyEmailCode(email, toVerify);\n        await after?.();\n        return true;\n      } catch (err) {\n        dispatch({ type: \"verify-failed\", message: describeError(err).message });\n        return false;\n      }\n    },\n    [email, state.code, api],\n  );\n\n  const setCode = useCallback((code: string) => dispatch({ type: \"code-changed\", code }), []);\n  const markReady = useCallback(() => dispatch({ type: \"send-succeeded\" }), []);\n  const fail = useCallback((message: string) => dispatch({ type: \"verify-failed\", message }), []);\n\n  return { state, setCode, send, verify, markReady, fail };\n}\n"],"mappings":";AAEA,SAAS,aAAa,WAAW,kBAAkB;AAEnD,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB,6BAAkD;AAatE,SAAS,aAAa,OAAsB,KAAoC;AACrF,QAAM,CAAC,OAAO,QAAQ,IAAI,WAAW,kBAAkB,qBAAqB;AAE5E,YAAU,MAAM;AACd,QAAI,MAAM,aAAa,EAAG;AAC1B,UAAM,KAAK,WAAW,MAAM,SAAS,EAAE,MAAM,OAAO,CAAC,GAAG,GAAI;AAC5D,WAAO,MAAM,aAAa,EAAE;AAAA,EAC9B,GAAG,CAAC,MAAM,QAAQ,CAAC;AAEnB,QAAM,OAAO;AAAA,IACX,OAAO,KAAK,UAAU;AACpB,UAAI,CAAC,GAAI,QAAO;AAChB,eAAS,EAAE,MAAM,eAAe,CAAC;AACjC,UAAI;AACF,cAAM,IAAI,EAAE,iBAAiB,EAAE;AAC/B,iBAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,eAAe,SAAS,cAAc,GAAG,EAAE,QAAQ,CAAC;AACrE,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,GAAG;AAAA,EACb;AAEA,QAAM,SAAS;AAAA,IACb,OAAO,EAAE,MAAM,MAAM,IAAI,CAAC,MAAM;AAC9B,YAAM,WAAW,QAAQ,MAAM;AAC/B,UAAI,CAAC,SAAS,SAAS,WAAW,EAAG,QAAO;AAC5C,eAAS,EAAE,MAAM,iBAAiB,CAAC;AACnC,UAAI;AACF,cAAM,IAAI,EAAE,gBAAgB,OAAO,QAAQ;AAC3C,cAAM,QAAQ;AACd,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,EAAE,MAAM,iBAAiB,SAAS,cAAc,GAAG,EAAE,QAAQ,CAAC;AACvE,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IACA,CAAC,OAAO,MAAM,MAAM,GAAG;AAAA,EACzB;AAEA,QAAM,UAAU,YAAY,CAAC,SAAiB,SAAS,EAAE,MAAM,gBAAgB,KAAK,CAAC,GAAG,CAAC,CAAC;AAC1F,QAAM,YAAY,YAAY,MAAM,SAAS,EAAE,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC5E,QAAM,OAAO,YAAY,CAAC,YAAoB,SAAS,EAAE,MAAM,iBAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC;AAE9F,SAAO,EAAE,OAAO,SAAS,MAAM,QAAQ,WAAW,KAAK;AACzD;","names":[]}

package/dist/utils/use-transaction.cjs

@@ -32,12 +32,14 @@ function useTransaction() {
   const [txHash, setTxHash] = (0, import_react.useState)(null);
   const [receipt, setReceipt] = (0, import_react.useState)(null);
   const [error, setError] = (0, import_react.useState)(null);
+  const [retryable, setRetryable] = (0, import_react.useState)(true);
   const run = (0, import_react.useCallback)(
     async (work) => {
       setPhase("preparing");
       setTxHash(null);
       setReceipt(null);
       setError(null);
+      setRetryable(true);
       try {
         const signer = await app.getSigner();
         let hash = null;
@@ -62,7 +64,18 @@ function useTransaction() {
         setPhase("success");
         return true;
       } catch (err) {
-        setError((0, import_describe_error.describeError)(err, "We couldn't complete that. Please try again.").message);
+        if (err instanceof import_starknet.SponsoredCallRejectedError) {
+          console.error("[medialane] transaction refused", {
+            reference: err.requestId?.slice(0, 8),
+            stage: err.stage,
+            status: err.status,
+            code: err.code,
+            detail: err.detail
+          });
+        }
+        const notice = (0, import_describe_error.describeError)(err);
+        setError(notice.message);
+        setRetryable(notice.retryable);
         setPhase("error");
         return false;
       } finally {
@@ -76,8 +89,9 @@ function useTransaction() {
     setTxHash(null);
     setReceipt(null);
     setError(null);
+    setRetryable(true);
   }, []);
-  return { phase, txHash, receipt, error, run, reset };
+  return { phase, txHash, receipt, error, retryable, run, reset };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/utils/use-transaction.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/use-transaction.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useState } from \"react\";\nimport { assertTransactionSucceeded, syncTransactionBestEffort, type ReceiptLike } from \"@medialane/sdk/starknet\";\nimport { useMedialaneApp } from \"../components/medialane-app.js\";\nimport type { FastMintSigner } from \"../components/fast-mint/types.js\";\nimport { describeError } from \"./describe-error.js\";\n\nexport type TransactionPhase = \"idle\" | \"preparing\" | \"submitting\" | \"confirming\" | \"success\" | \"error\";\n\nexport function useTransaction() {\n  const app = useMedialaneApp();\n  const [phase, setPhase] = useState<TransactionPhase>(\"idle\");\n  const [txHash, setTxHash] = useState<string | null>(null);\n  const [receipt, setReceipt] = useState<ReceiptLike | null>(null);\n  const [error, setError] = useState<string | null>(null);\n\n  const run = useCallback(\n    async (work: (signer: FastMintSigner) => Promise<void>): Promise<boolean> => {\n      setPhase(\"preparing\");\n      setTxHash(null);\n      setReceipt(null);\n      setError(null);\n      try {\n        const signer = await app.getSigner();\n        let hash: string | null = null;\n        const tracked: FastMintSigner = {\n          address: signer.address,\n          signTypedData: (data) => signer.signTypedData(data),\n          execute: async (calls, opts) => {\n            setPhase(\"submitting\");\n            const result = await signer.execute(calls, opts);\n            hash = result.txHash;\n            setTxHash(result.txHash);\n            setPhase(\"confirming\");\n            return result;\n          },\n        };\n        await work(tracked);\n        if (hash) {\n          const client = app.getClient();\n          setReceipt(await assertTransactionSucceeded(client.provider, hash));\n          await syncTransactionBestEffort(client, hash);\n        }\n        setPhase(\"success\");\n        return true;\n      } catch (err) {\n        setError(describeError(err, \"We couldn't complete that. Please try again.\").message);\n        setPhase(\"error\");\n        return false;\n      } finally {\n        app.releaseSigner?.();\n      }\n    },\n    [app],\n  );\n\n  const reset = useCallback(() => {\n    setPhase(\"idle\");\n    setTxHash(null);\n    setReceipt(null);\n    setError(null);\n  }, []);\n\n  return { phase, txHash, receipt, error, run, reset };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAsC;AACtC,sBAAwF;AACxF,2BAAgC;AAEhC,4BAA8B;AAIvB,SAAS,iBAAiB;AAC/B,QAAM,UAAM,sCAAgB;AAC5B,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAA2B,MAAM;AAC3D,QAAM,CAAC,QAAQ,SAAS,QAAI,uBAAwB,IAAI;AACxD,QAAM,CAAC,SAAS,UAAU,QAAI,uBAA6B,IAAI;AAC/D,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAwB,IAAI;AAEtD,QAAM,UAAM;AAAA,IACV,OAAO,SAAsE;AAC3E,eAAS,WAAW;AACpB,gBAAU,IAAI;AACd,iBAAW,IAAI;AACf,eAAS,IAAI;AACb,UAAI;AACF,cAAM,SAAS,MAAM,IAAI,UAAU;AACnC,YAAI,OAAsB;AAC1B,cAAM,UAA0B;AAAA,UAC9B,SAAS,OAAO;AAAA,UAChB,eAAe,CAAC,SAAS,OAAO,cAAc,IAAI;AAAA,UAClD,SAAS,OAAO,OAAO,SAAS;AAC9B,qBAAS,YAAY;AACrB,kBAAM,SAAS,MAAM,OAAO,QAAQ,OAAO,IAAI;AAC/C,mBAAO,OAAO;AACd,sBAAU,OAAO,MAAM;AACvB,qBAAS,YAAY;AACrB,mBAAO;AAAA,UACT;AAAA,QACF;AACA,cAAM,KAAK,OAAO;AAClB,YAAI,MAAM;AACR,gBAAM,SAAS,IAAI,UAAU;AAC7B,qBAAW,UAAM,4CAA2B,OAAO,UAAU,IAAI,CAAC;AAClE,oBAAM,2CAA0B,QAAQ,IAAI;AAAA,QAC9C;AACA,iBAAS,SAAS;AAClB,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,qBAAS,qCAAc,KAAK,8CAA8C,EAAE,OAAO;AACnF,iBAAS,OAAO;AAChB,eAAO;AAAA,MACT,UAAE;AACA,YAAI,gBAAgB;AAAA,MACtB;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EACN;AAEA,QAAM,YAAQ,0BAAY,MAAM;AAC9B,aAAS,MAAM;AACf,cAAU,IAAI;AACd,eAAW,IAAI;AACf,aAAS,IAAI;AAAA,EACf,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,OAAO,QAAQ,SAAS,OAAO,KAAK,MAAM;AACrD;","names":[]}
+{"version":3,"sources":["../../src/utils/use-transaction.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useState } from \"react\";\nimport { SponsoredCallRejectedError, assertTransactionSucceeded, syncTransactionBestEffort, type ReceiptLike } from \"@medialane/sdk/starknet\";\nimport { useMedialaneApp } from \"../components/medialane-app.js\";\nimport type { FastMintSigner } from \"../components/fast-mint/types.js\";\nimport { describeError } from \"./describe-error.js\";\n\nexport type TransactionPhase = \"idle\" | \"preparing\" | \"submitting\" | \"confirming\" | \"success\" | \"error\";\n\nexport function useTransaction() {\n  const app = useMedialaneApp();\n  const [phase, setPhase] = useState<TransactionPhase>(\"idle\");\n  const [txHash, setTxHash] = useState<string | null>(null);\n  const [receipt, setReceipt] = useState<ReceiptLike | null>(null);\n  const [error, setError] = useState<string | null>(null);\n  const [retryable, setRetryable] = useState(true);\n\n  const run = useCallback(\n    async (work: (signer: FastMintSigner) => Promise<void>): Promise<boolean> => {\n      setPhase(\"preparing\");\n      setTxHash(null);\n      setReceipt(null);\n      setError(null);\n      setRetryable(true);\n      try {\n        const signer = await app.getSigner();\n        let hash: string | null = null;\n        const tracked: FastMintSigner = {\n          address: signer.address,\n          signTypedData: (data) => signer.signTypedData(data),\n          execute: async (calls, opts) => {\n            setPhase(\"submitting\");\n            const result = await signer.execute(calls, opts);\n            hash = result.txHash;\n            setTxHash(result.txHash);\n            setPhase(\"confirming\");\n            return result;\n          },\n        };\n        await work(tracked);\n        if (hash) {\n          const client = app.getClient();\n          setReceipt(await assertTransactionSucceeded(client.provider, hash));\n          await syncTransactionBestEffort(client, hash);\n        }\n        setPhase(\"success\");\n        return true;\n      } catch (err) {\n        if (err instanceof SponsoredCallRejectedError) {\n          console.error(\"[medialane] transaction refused\", {\n            reference: err.requestId?.slice(0, 8),\n            stage: err.stage,\n            status: err.status,\n            code: err.code,\n            detail: err.detail,\n          });\n        }\n        const notice = describeError(err);\n        setError(notice.message);\n        setRetryable(notice.retryable);\n        setPhase(\"error\");\n        return false;\n      } finally {\n        app.releaseSigner?.();\n      }\n    },\n    [app],\n  );\n\n  const reset = useCallback(() => {\n    setPhase(\"idle\");\n    setTxHash(null);\n    setReceipt(null);\n    setError(null);\n    setRetryable(true);\n  }, []);\n\n  return { phase, txHash, receipt, error, retryable, run, reset };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,mBAAsC;AACtC,sBAAoH;AACpH,2BAAgC;AAEhC,4BAA8B;AAIvB,SAAS,iBAAiB;AAC/B,QAAM,UAAM,sCAAgB;AAC5B,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAA2B,MAAM;AAC3D,QAAM,CAAC,QAAQ,SAAS,QAAI,uBAAwB,IAAI;AACxD,QAAM,CAAC,SAAS,UAAU,QAAI,uBAA6B,IAAI;AAC/D,QAAM,CAAC,OAAO,QAAQ,QAAI,uBAAwB,IAAI;AACtD,QAAM,CAAC,WAAW,YAAY,QAAI,uBAAS,IAAI;AAE/C,QAAM,UAAM;AAAA,IACV,OAAO,SAAsE;AAC3E,eAAS,WAAW;AACpB,gBAAU,IAAI;AACd,iBAAW,IAAI;AACf,eAAS,IAAI;AACb,mBAAa,IAAI;AACjB,UAAI;AACF,cAAM,SAAS,MAAM,IAAI,UAAU;AACnC,YAAI,OAAsB;AAC1B,cAAM,UAA0B;AAAA,UAC9B,SAAS,OAAO;AAAA,UAChB,eAAe,CAAC,SAAS,OAAO,cAAc,IAAI;AAAA,UAClD,SAAS,OAAO,OAAO,SAAS;AAC9B,qBAAS,YAAY;AACrB,kBAAM,SAAS,MAAM,OAAO,QAAQ,OAAO,IAAI;AAC/C,mBAAO,OAAO;AACd,sBAAU,OAAO,MAAM;AACvB,qBAAS,YAAY;AACrB,mBAAO;AAAA,UACT;AAAA,QACF;AACA,cAAM,KAAK,OAAO;AAClB,YAAI,MAAM;AACR,gBAAM,SAAS,IAAI,UAAU;AAC7B,qBAAW,UAAM,4CAA2B,OAAO,UAAU,IAAI,CAAC;AAClE,oBAAM,2CAA0B,QAAQ,IAAI;AAAA,QAC9C;AACA,iBAAS,SAAS;AAClB,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,YAAI,eAAe,4CAA4B;AAC7C,kBAAQ,MAAM,mCAAmC;AAAA,YAC/C,WAAW,IAAI,WAAW,MAAM,GAAG,CAAC;AAAA,YACpC,OAAO,IAAI;AAAA,YACX,QAAQ,IAAI;AAAA,YACZ,MAAM,IAAI;AAAA,YACV,QAAQ,IAAI;AAAA,UACd,CAAC;AAAA,QACH;AACA,cAAM,aAAS,qCAAc,GAAG;AAChC,iBAAS,OAAO,OAAO;AACvB,qBAAa,OAAO,SAAS;AAC7B,iBAAS,OAAO;AAChB,eAAO;AAAA,MACT,UAAE;AACA,YAAI,gBAAgB;AAAA,MACtB;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EACN;AAEA,QAAM,YAAQ,0BAAY,MAAM;AAC9B,aAAS,MAAM;AACf,cAAU,IAAI;AACd,eAAW,IAAI;AACf,aAAS,IAAI;AACb,iBAAa,IAAI;AAAA,EACnB,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,OAAO,QAAQ,SAAS,OAAO,WAAW,KAAK,MAAM;AAChE;","names":[]}

package/dist/utils/use-transaction.d.cts

@@ -10,6 +10,7 @@ declare function useTransaction(): {
     txHash: string | null;
     receipt: ReceiptLike | null;
     error: string | null;
+    retryable: boolean;
     run: (work: (signer: FastMintSigner) => Promise<void>) => Promise<boolean>;
     reset: () => void;
 };

package/dist/utils/use-transaction.d.ts

@@ -10,6 +10,7 @@ declare function useTransaction(): {
     txHash: string | null;
     receipt: ReceiptLike | null;
     error: string | null;
+    retryable: boolean;
     run: (work: (signer: FastMintSigner) => Promise<void>) => Promise<boolean>;
     reset: () => void;
 };

package/dist/utils/use-transaction.js

@@ -1,6 +1,6 @@
 "use client";
 import { useCallback, useState } from "react";
-import { assertTransactionSucceeded, syncTransactionBestEffort } from "@medialane/sdk/starknet";
+import { SponsoredCallRejectedError, assertTransactionSucceeded, syncTransactionBestEffort } from "@medialane/sdk/starknet";
 import { useMedialaneApp } from "../components/medialane-app.js";
 import { describeError } from "./describe-error.js";
 function useTransaction() {
@@ -9,12 +9,14 @@ function useTransaction() {
   const [txHash, setTxHash] = useState(null);
   const [receipt, setReceipt] = useState(null);
   const [error, setError] = useState(null);
+  const [retryable, setRetryable] = useState(true);
   const run = useCallback(
     async (work) => {
       setPhase("preparing");
       setTxHash(null);
       setReceipt(null);
       setError(null);
+      setRetryable(true);
       try {
         const signer = await app.getSigner();
         let hash = null;
@@ -39,7 +41,18 @@ function useTransaction() {
         setPhase("success");
         return true;
       } catch (err) {
-        setError(describeError(err, "We couldn't complete that. Please try again.").message);
+        if (err instanceof SponsoredCallRejectedError) {
+          console.error("[medialane] transaction refused", {
+            reference: err.requestId?.slice(0, 8),
+            stage: err.stage,
+            status: err.status,
+            code: err.code,
+            detail: err.detail
+          });
+        }
+        const notice = describeError(err);
+        setError(notice.message);
+        setRetryable(notice.retryable);
         setPhase("error");
         return false;
       } finally {
@@ -53,8 +66,9 @@ function useTransaction() {
     setTxHash(null);
     setReceipt(null);
     setError(null);
+    setRetryable(true);
   }, []);
-  return { phase, txHash, receipt, error, run, reset };
+  return { phase, txHash, receipt, error, retryable, run, reset };
 }
 export {
   useTransaction

package/dist/utils/use-transaction.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/use-transaction.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useState } from \"react\";\nimport { assertTransactionSucceeded, syncTransactionBestEffort, type ReceiptLike } from \"@medialane/sdk/starknet\";\nimport { useMedialaneApp } from \"../components/medialane-app.js\";\nimport type { FastMintSigner } from \"../components/fast-mint/types.js\";\nimport { describeError } from \"./describe-error.js\";\n\nexport type TransactionPhase = \"idle\" | \"preparing\" | \"submitting\" | \"confirming\" | \"success\" | \"error\";\n\nexport function useTransaction() {\n  const app = useMedialaneApp();\n  const [phase, setPhase] = useState<TransactionPhase>(\"idle\");\n  const [txHash, setTxHash] = useState<string | null>(null);\n  const [receipt, setReceipt] = useState<ReceiptLike | null>(null);\n  const [error, setError] = useState<string | null>(null);\n\n  const run = useCallback(\n    async (work: (signer: FastMintSigner) => Promise<void>): Promise<boolean> => {\n      setPhase(\"preparing\");\n      setTxHash(null);\n      setReceipt(null);\n      setError(null);\n      try {\n        const signer = await app.getSigner();\n        let hash: string | null = null;\n        const tracked: FastMintSigner = {\n          address: signer.address,\n          signTypedData: (data) => signer.signTypedData(data),\n          execute: async (calls, opts) => {\n            setPhase(\"submitting\");\n            const result = await signer.execute(calls, opts);\n            hash = result.txHash;\n            setTxHash(result.txHash);\n            setPhase(\"confirming\");\n            return result;\n          },\n        };\n        await work(tracked);\n        if (hash) {\n          const client = app.getClient();\n          setReceipt(await assertTransactionSucceeded(client.provider, hash));\n          await syncTransactionBestEffort(client, hash);\n        }\n        setPhase(\"success\");\n        return true;\n      } catch (err) {\n        setError(describeError(err, \"We couldn't complete that. Please try again.\").message);\n        setPhase(\"error\");\n        return false;\n      } finally {\n        app.releaseSigner?.();\n      }\n    },\n    [app],\n  );\n\n  const reset = useCallback(() => {\n    setPhase(\"idle\");\n    setTxHash(null);\n    setReceipt(null);\n    setError(null);\n  }, []);\n\n  return { phase, txHash, receipt, error, run, reset };\n}\n"],"mappings":";AAEA,SAAS,aAAa,gBAAgB;AACtC,SAAS,4BAA4B,iCAAmD;AACxF,SAAS,uBAAuB;AAEhC,SAAS,qBAAqB;AAIvB,SAAS,iBAAiB;AAC/B,QAAM,MAAM,gBAAgB;AAC5B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA2B,MAAM;AAC3D,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAwB,IAAI;AACxD,QAAM,CAAC,SAAS,UAAU,IAAI,SAA6B,IAAI;AAC/D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD,QAAM,MAAM;AAAA,IACV,OAAO,SAAsE;AAC3E,eAAS,WAAW;AACpB,gBAAU,IAAI;AACd,iBAAW,IAAI;AACf,eAAS,IAAI;AACb,UAAI;AACF,cAAM,SAAS,MAAM,IAAI,UAAU;AACnC,YAAI,OAAsB;AAC1B,cAAM,UAA0B;AAAA,UAC9B,SAAS,OAAO;AAAA,UAChB,eAAe,CAAC,SAAS,OAAO,cAAc,IAAI;AAAA,UAClD,SAAS,OAAO,OAAO,SAAS;AAC9B,qBAAS,YAAY;AACrB,kBAAM,SAAS,MAAM,OAAO,QAAQ,OAAO,IAAI;AAC/C,mBAAO,OAAO;AACd,sBAAU,OAAO,MAAM;AACvB,qBAAS,YAAY;AACrB,mBAAO;AAAA,UACT;AAAA,QACF;AACA,cAAM,KAAK,OAAO;AAClB,YAAI,MAAM;AACR,gBAAM,SAAS,IAAI,UAAU;AAC7B,qBAAW,MAAM,2BAA2B,OAAO,UAAU,IAAI,CAAC;AAClE,gBAAM,0BAA0B,QAAQ,IAAI;AAAA,QAC9C;AACA,iBAAS,SAAS;AAClB,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,iBAAS,cAAc,KAAK,8CAA8C,EAAE,OAAO;AACnF,iBAAS,OAAO;AAChB,eAAO;AAAA,MACT,UAAE;AACA,YAAI,gBAAgB;AAAA,MACtB;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EACN;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,aAAS,MAAM;AACf,cAAU,IAAI;AACd,eAAW,IAAI;AACf,aAAS,IAAI;AAAA,EACf,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,OAAO,QAAQ,SAAS,OAAO,KAAK,MAAM;AACrD;","names":[]}
+{"version":3,"sources":["../../src/utils/use-transaction.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useState } from \"react\";\nimport { SponsoredCallRejectedError, assertTransactionSucceeded, syncTransactionBestEffort, type ReceiptLike } from \"@medialane/sdk/starknet\";\nimport { useMedialaneApp } from \"../components/medialane-app.js\";\nimport type { FastMintSigner } from \"../components/fast-mint/types.js\";\nimport { describeError } from \"./describe-error.js\";\n\nexport type TransactionPhase = \"idle\" | \"preparing\" | \"submitting\" | \"confirming\" | \"success\" | \"error\";\n\nexport function useTransaction() {\n  const app = useMedialaneApp();\n  const [phase, setPhase] = useState<TransactionPhase>(\"idle\");\n  const [txHash, setTxHash] = useState<string | null>(null);\n  const [receipt, setReceipt] = useState<ReceiptLike | null>(null);\n  const [error, setError] = useState<string | null>(null);\n  const [retryable, setRetryable] = useState(true);\n\n  const run = useCallback(\n    async (work: (signer: FastMintSigner) => Promise<void>): Promise<boolean> => {\n      setPhase(\"preparing\");\n      setTxHash(null);\n      setReceipt(null);\n      setError(null);\n      setRetryable(true);\n      try {\n        const signer = await app.getSigner();\n        let hash: string | null = null;\n        const tracked: FastMintSigner = {\n          address: signer.address,\n          signTypedData: (data) => signer.signTypedData(data),\n          execute: async (calls, opts) => {\n            setPhase(\"submitting\");\n            const result = await signer.execute(calls, opts);\n            hash = result.txHash;\n            setTxHash(result.txHash);\n            setPhase(\"confirming\");\n            return result;\n          },\n        };\n        await work(tracked);\n        if (hash) {\n          const client = app.getClient();\n          setReceipt(await assertTransactionSucceeded(client.provider, hash));\n          await syncTransactionBestEffort(client, hash);\n        }\n        setPhase(\"success\");\n        return true;\n      } catch (err) {\n        if (err instanceof SponsoredCallRejectedError) {\n          console.error(\"[medialane] transaction refused\", {\n            reference: err.requestId?.slice(0, 8),\n            stage: err.stage,\n            status: err.status,\n            code: err.code,\n            detail: err.detail,\n          });\n        }\n        const notice = describeError(err);\n        setError(notice.message);\n        setRetryable(notice.retryable);\n        setPhase(\"error\");\n        return false;\n      } finally {\n        app.releaseSigner?.();\n      }\n    },\n    [app],\n  );\n\n  const reset = useCallback(() => {\n    setPhase(\"idle\");\n    setTxHash(null);\n    setReceipt(null);\n    setError(null);\n    setRetryable(true);\n  }, []);\n\n  return { phase, txHash, receipt, error, retryable, run, reset };\n}\n"],"mappings":";AAEA,SAAS,aAAa,gBAAgB;AACtC,SAAS,4BAA4B,4BAA4B,iCAAmD;AACpH,SAAS,uBAAuB;AAEhC,SAAS,qBAAqB;AAIvB,SAAS,iBAAiB;AAC/B,QAAM,MAAM,gBAAgB;AAC5B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAA2B,MAAM;AAC3D,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAwB,IAAI;AACxD,QAAM,CAAC,SAAS,UAAU,IAAI,SAA6B,IAAI;AAC/D,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AACtD,QAAM,CAAC,WAAW,YAAY,IAAI,SAAS,IAAI;AAE/C,QAAM,MAAM;AAAA,IACV,OAAO,SAAsE;AAC3E,eAAS,WAAW;AACpB,gBAAU,IAAI;AACd,iBAAW,IAAI;AACf,eAAS,IAAI;AACb,mBAAa,IAAI;AACjB,UAAI;AACF,cAAM,SAAS,MAAM,IAAI,UAAU;AACnC,YAAI,OAAsB;AAC1B,cAAM,UAA0B;AAAA,UAC9B,SAAS,OAAO;AAAA,UAChB,eAAe,CAAC,SAAS,OAAO,cAAc,IAAI;AAAA,UAClD,SAAS,OAAO,OAAO,SAAS;AAC9B,qBAAS,YAAY;AACrB,kBAAM,SAAS,MAAM,OAAO,QAAQ,OAAO,IAAI;AAC/C,mBAAO,OAAO;AACd,sBAAU,OAAO,MAAM;AACvB,qBAAS,YAAY;AACrB,mBAAO;AAAA,UACT;AAAA,QACF;AACA,cAAM,KAAK,OAAO;AAClB,YAAI,MAAM;AACR,gBAAM,SAAS,IAAI,UAAU;AAC7B,qBAAW,MAAM,2BAA2B,OAAO,UAAU,IAAI,CAAC;AAClE,gBAAM,0BAA0B,QAAQ,IAAI;AAAA,QAC9C;AACA,iBAAS,SAAS;AAClB,eAAO;AAAA,MACT,SAAS,KAAK;AACZ,YAAI,eAAe,4BAA4B;AAC7C,kBAAQ,MAAM,mCAAmC;AAAA,YAC/C,WAAW,IAAI,WAAW,MAAM,GAAG,CAAC;AAAA,YACpC,OAAO,IAAI;AAAA,YACX,QAAQ,IAAI;AAAA,YACZ,MAAM,IAAI;AAAA,YACV,QAAQ,IAAI;AAAA,UACd,CAAC;AAAA,QACH;AACA,cAAM,SAAS,cAAc,GAAG;AAChC,iBAAS,OAAO,OAAO;AACvB,qBAAa,OAAO,SAAS;AAC7B,iBAAS,OAAO;AAChB,eAAO;AAAA,MACT,UAAE;AACA,YAAI,gBAAgB;AAAA,MACtB;AAAA,IACF;AAAA,IACA,CAAC,GAAG;AAAA,EACN;AAEA,QAAM,QAAQ,YAAY,MAAM;AAC9B,aAAS,MAAM;AACf,cAAU,IAAI;AACd,eAAW,IAAI;AACf,aAAS,IAAI;AACb,iBAAa,IAAI;AAAA,EACnB,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,OAAO,QAAQ,SAAS,OAAO,WAAW,KAAK,MAAM;AAChE;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@medialane/ui",
-  "version": "0.256.0",
+  "version": "0.258.0",
   "description": "Shared UI components for Medialane apps",
   "type": "module",
   "sideEffects": false,
@@ -51,7 +51,7 @@
     "preview": "vite --config preview/vite.config.ts"
   },
   "peerDependencies": {
-    "@medialane/sdk": ">=0.205.0 <0.206.0",
+    "@medialane/sdk": ">=0.206.0 <0.207.0",
     "@radix-ui/react-checkbox": ">=1.1.0",
     "@radix-ui/react-collapsible": ">=1.1.0",
     "@radix-ui/react-dialog": ">=1.1.0",
@@ -85,7 +85,7 @@
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.14.5",
     "@hookform/resolvers": "^3.10.0",
-    "@medialane/sdk": "0.205.0",
+    "@medialane/sdk": "0.206.0",
     "@radix-ui/react-checkbox": "^1.3.8",
     "@radix-ui/react-collapsible": "^1.1.17",
     "@radix-ui/react-dialog": "^1.1.20",