@tatchi-xyz/sdk 0.21.0 → 0.31.1

package/dist/esm/sdk/errors-DevlT39D.js

@@ -0,0 +1,135 @@
+//#region src/utils/errors.ts
+/**
+* Centralized error handling utilities for the Passkey SDK
+*/
+/**
+* Best-effort error message extractor without relying on `any`.
+* Always returns a string (may be empty when nothing usable can be derived).
+*/
+function errorMessage(err) {
+	try {
+		if (typeof err === "string") return err;
+		if (err && typeof err.message === "string") return err.message;
+		return String(err ?? "");
+	} catch {
+		return "";
+	}
+}
+/**
+* Normalize any thrown value into an Error instance.
+* - preserves message/name/stack when available
+* - best-effort copies optional code/details properties if present
+*/
+function toError(e) {
+	if (e instanceof Error) return e;
+	const err = new Error(errorMessage(e));
+	try {
+		const src = e;
+		if (typeof src?.name === "string") err.name = src.name;
+		if (typeof src?.stack === "string") err.stack = src.stack;
+		if (src && typeof src.code !== "undefined") err.code = src.code;
+		if (src && typeof src.details !== "undefined") err.details = src.details;
+	} catch {}
+	return err;
+}
+/**
+* Check if an error is related to user cancellation of TouchID/FaceID prompt
+* @param error - The error object or error message string
+* @returns true if the error indicates user cancellation
+*/
+function isTouchIdCancellationError(error) {
+	const msg = errorMessage(error);
+	const lower = msg.toLowerCase();
+	return msg.includes("The operation either timed out or was not allowed") || msg.includes("NotAllowedError") || msg.includes("AbortError") || lower.includes("user cancelled") || lower.includes("user canceled") || lower.includes("user aborted");
+}
+/**
+* Get a user-friendly error message for TouchID/FaceID cancellation
+* @param context - The context where the cancellation occurred (e.g., 'registration', 'login')
+* @returns A user-friendly error message
+*/
+function getTouchIdCancellationMessage(context) {
+	switch (context) {
+		case "registration": return `Registration was cancelled. Please try again when you're ready to set up your passkey.`;
+		case "login": return `Login was cancelled. Please try again when you're ready to authenticate.`;
+		default: return `Operation was cancelled. Please try again when you're ready.`;
+	}
+}
+/**
+* Transform an error message to be more user-friendly
+* @param error - The original error object or message
+* @param context - The context where the error occurred
+* @param nearAccountId - Optional NEAR account ID for context-specific messages
+* @returns A user-friendly error message
+*/
+function getUserFriendlyErrorMessage(error, context = "registration", nearAccountId) {
+	const msg = errorMessage(error);
+	if (isTouchIdCancellationError(error)) return getTouchIdCancellationMessage(context);
+	if (msg.includes("PRF outputs missing")) {
+		const op = context === "registration" ? "Registration" : "Login";
+		return `${op} failed because your browser did not return the required passkey PRF results. On some mobile browsers this is not available for create(); try updating your browser or use a desktop browser. We’re working on an alternate path for broader device support.`;
+	}
+	if (msg.includes("one of the credentials already registered")) return `A passkey for '${nearAccountId || "this account"}' already exists. Please try logging in instead.`;
+	if (msg.includes("Cannot deserialize the contract state")) return `Contract state deserialization failed. This may be due to a contract upgrade. Please try again or contact support.`;
+	if (msg.includes("Web3Authn contract registration check failed")) return `Contract registration check failed: ${msg.replace("Web3Authn contract registration check failed: ", "")}`;
+	if (msg.includes("Unknown error occurred")) return `${context === "registration" ? "Registration" : "Login"} failed due to an unknown error. Please check your connection and try again.`;
+	return msg;
+}
+/**
+* Extract a short NEAR error label for UI display, e.g.:
+*   "InvalidTxError: UnsuitableStakingKey"
+* Falls back to undefined when structure is not recognized.
+*/
+function getNearShortErrorMessage(error) {
+	try {
+		const err = error;
+		const details = err?.details;
+		const isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+		if (!isObj(details)) return void 0;
+		const txExec = details.TxExecutionError;
+		if (isObj(txExec)) {
+			if (isObj(txExec.InvalidTxError)) {
+				const inv = txExec.InvalidTxError;
+				if (isObj(inv.ActionsValidation)) {
+					const kind = Object.keys(inv.ActionsValidation)[0];
+					if (kind) return `InvalidTxError: ${kind}`;
+				}
+				const first = Object.keys(inv)[0];
+				if (first) return `InvalidTxError: ${first}`;
+				return "InvalidTxError";
+			}
+			if (isObj(txExec.ActionError)) {
+				const ae = txExec.ActionError;
+				const kindObj = isObj(ae.kind) ? ae.kind : void 0;
+				const kind = kindObj ? Object.keys(kindObj)[0] : void 0;
+				if (kind) return `ActionError: ${kind}`;
+				return "ActionError";
+			}
+		}
+		const failure = details.Failure;
+		if (isObj(failure)) {
+			if (isObj(failure.InvalidTxError)) {
+				const inv = failure.InvalidTxError;
+				if (isObj(inv.ActionsValidation)) {
+					const kind = Object.keys(inv.ActionsValidation)[0];
+					if (kind) return `InvalidTxError: ${kind}`;
+				}
+				const first = Object.keys(inv)[0];
+				if (first) return `InvalidTxError: ${first}`;
+				return "InvalidTxError";
+			}
+			if (isObj(failure.ActionError)) {
+				const ae = failure.ActionError;
+				const kindObj = isObj(ae.kind) ? ae.kind : void 0;
+				const kind = kindObj ? Object.keys(kindObj)[0] : void 0;
+				if (kind) return `ActionError: ${kind}`;
+				return "ActionError";
+			}
+		}
+		return void 0;
+	} catch {
+		return void 0;
+	}
+}
+
+//#endregion
+export { errorMessage, getNearShortErrorMessage, getUserFriendlyErrorMessage, isTouchIdCancellationError, toError };

package/dist/esm/sdk/events-D2g80q67.js

@@ -0,0 +1,8 @@
+//#region src/core/WalletIframe/events.ts
+const WalletIframeDomEvents = {
+	TX_CONFIRMER_CONFIRM: "w3a:tx-confirmer-confirm",
+	TX_CONFIRMER_CANCEL: "w3a:tx-confirmer-cancel"
+};
+
+//#endregion
+export { WalletIframeDomEvents };

package/dist/esm/sdk/export-private-key-viewer.js

@@ -576,13 +576,15 @@ o?.({ LitElement: i });
 (s.litElementVersions ??= []).push("4.2.1");
 
 //#endregion
-//#region src/core/WalletIframe/validation.ts
+//#region src/utils/validation.ts
 function isObject(x$1) {
 	return x$1 !== null && typeof x$1 === "object";
 }
 
 //#endregion
 //#region src/core/WebAuthnManager/LitComponents/LitElementWithProps.ts
+const hasAdoptedStyleSheets = (node) => !!node && typeof node === "object" && "adoptedStyleSheets" in node;
+const supportsConstructableStylesheets = () => typeof CSSStyleSheet !== "undefined" && "replaceSync" in CSSStyleSheet.prototype;
 /**
 * Drop-in replacement for LitElement that automatically handles the custom element upgrade race.
 * See lit-element-with-props.md for more details.
@@ -606,7 +608,7 @@ var LitElementWithProps = class extends i {
 	* Optional: Tag names that should be defined before this component renders.
 	* When missing, a console.warn is emitted to remind developers to import/keep the child.
 	* Example:
-	*   static requiredChildTags = ['w3a-tx-button'];
+	*   static requiredChildTags = ['w3a-tx-tree'];
 	*/
 	static requiredChildTags;
 	/**
@@ -656,17 +658,18 @@ var LitElementWithProps = class extends i {
 		if (this.styles) this.applyStyles(this.styles, this.getComponentPrefix());
 		try {
 			const ctor = this.constructor;
-			const defs = ctor.keepDefinitions;
+			const { keepDefinitions, requiredChildTags, strictChildDefinitions } = ctor;
+			const defs = keepDefinitions;
 			if (defs && defs.length) for (const d$2 of defs);
-			const req = ctor.requiredChildTags;
+			const req = requiredChildTags;
 			if (req && Array.isArray(req)) for (const tag of req) try {
 				if (typeof tag === "string" && tag.includes("-") && !customElements.get(tag)) {
 					const msg = `[W3A] Required child custom element not defined: <${tag}>. Import the module that defines it and keep a reference via \`static keepDefinitions\` or a private field to avoid tree-shaking. See LitComponents/README.md (tree-shake checklist).`;
-					if (ctor.strictChildDefinitions) throw new Error(msg);
+					if (strictChildDefinitions) throw new Error(msg);
 					else console.error(msg);
 				}
 			} catch (err) {
-				if (ctor.strictChildDefinitions) throw err;
+				if (strictChildDefinitions) throw err;
 			}
 		} catch {}
 	}
@@ -712,8 +715,9 @@ var LitElementWithProps = class extends i {
 		const transformViewportUnits = (val) => {
 			if (!val || typeof val !== "string") return val;
 			try {
-				const supportsDvh = typeof CSS !== "undefined" && !!CSS.supports && CSS.supports("height", "1dvh");
-				const supportsDvw = typeof CSS !== "undefined" && !!CSS.supports && CSS.supports("width", "1dvw");
+				const canUseCssSupports = typeof CSS !== "undefined" && typeof CSS.supports === "function";
+				const supportsDvh = canUseCssSupports && CSS.supports("height", "1dvh");
+				const supportsDvw = canUseCssSupports && CSS.supports("width", "1dvw");
 				let out = val;
 				if (supportsDvh && out.includes("vh")) out = out.replace(/([0-9]+(?:\.[0-9]+)?)vh\b/g, "$1dvh");
 				if (supportsDvw && out.includes("vw")) out = out.replace(/([0-9]+(?:\.[0-9]+)?)vw\b/g, "$1dvw");
@@ -785,17 +789,18 @@ var LitElementWithProps = class extends i {
 			}
 			const decls = Object.entries(this._varsMap).map(([k$1, v$1]) => `${k$1}: ${v$1};`).join(" ");
 			const cssTextShadow = `:host{ ${decls} }`;
-			if (this.renderRoot instanceof ShadowRoot && "adoptedStyleSheets" in this.renderRoot && "replaceSync" in CSSStyleSheet.prototype) {
+			const canUseConstructable = supportsConstructableStylesheets();
+			if (this.renderRoot instanceof ShadowRoot && canUseConstructable && hasAdoptedStyleSheets(this.renderRoot)) {
 				if (!this._varsSheet) this._varsSheet = new CSSStyleSheet();
 				try {
 					this._varsSheet.replaceSync(cssTextShadow);
 				} catch {}
-				const sheets = this.renderRoot.adoptedStyleSheets || [];
-				const without = sheets.filter((s$3) => s$3 !== this._varsSheet);
+				const sheets = this.renderRoot.adoptedStyleSheets ?? [];
+				const without = sheets.filter((sheet) => sheet !== this._varsSheet);
 				this.renderRoot.adoptedStyleSheets = [...without, this._varsSheet];
 				return;
 			}
-			const rootNode = this.getRootNode && this.getRootNode();
+			const rootNode = this.getRootNode?.();
 			const doc = rootNode instanceof Document ? rootNode : document;
 			const cssTextScoped = () => {
 				if (!this._varsClassName) {
@@ -806,22 +811,22 @@ var LitElementWithProps = class extends i {
 				}
 				return `.${this._varsClassName}{ ${decls} }`;
 			};
-			if (rootNode && rootNode.adoptedStyleSheets && "replaceSync" in CSSStyleSheet.prototype) {
+			if (rootNode && canUseConstructable && hasAdoptedStyleSheets(rootNode)) {
 				if (!this._varsDocSheet) this._varsDocSheet = new CSSStyleSheet();
 				try {
 					this._varsDocSheet.replaceSync(cssTextScoped());
 				} catch {}
-				const srSheets = rootNode.adoptedStyleSheets || [];
+				const srSheets = rootNode.adoptedStyleSheets ?? [];
 				if (!srSheets.includes(this._varsDocSheet)) rootNode.adoptedStyleSheets = [...srSheets, this._varsDocSheet];
 				return;
 			}
-			const docSupportsConstructable = !!doc && "adoptedStyleSheets" in doc && "replaceSync" in CSSStyleSheet.prototype;
-			if (docSupportsConstructable && doc) {
+			const docSupportsConstructable = canUseConstructable && hasAdoptedStyleSheets(doc);
+			if (docSupportsConstructable) {
 				if (!this._varsDocSheet) this._varsDocSheet = new CSSStyleSheet();
 				try {
 					this._varsDocSheet.replaceSync(cssTextScoped());
 				} catch {}
-				const current = doc.adoptedStyleSheets || [];
+				const current = doc.adoptedStyleSheets ?? [];
 				if (!current.includes(this._varsDocSheet)) doc.adoptedStyleSheets = [...current, this._varsDocSheet];
 				return;
 			}