@tatchi-xyz/sdk 0.21.0 → 0.31.1

package/dist/cjs/react/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../../../../src/utils/errors.ts"],"sourcesContent":["/**\n * Centralized error handling utilities for the Passkey SDK\n */\n\n/**\n * Best-effort error message extractor without relying on `any`.\n * Always returns a string (may be empty when nothing usable can be derived).\n */\nexport function errorMessage(err: unknown): string {\n  try {\n    if (typeof err === 'string') return err;\n    if (err && typeof (err as { message?: unknown }).message === 'string') {\n      return (err as { message: string }).message;\n    }\n    return String(err ?? '');\n  } catch {\n    return '';\n  }\n}\n\n/**\n * Normalize any thrown value into an Error instance.\n * - preserves message/name/stack when available\n * - best-effort copies optional code/details properties if present\n */\nexport function toError(e: unknown): Error {\n  if (e instanceof Error) return e;\n  const err = new Error(errorMessage(e));\n  try {\n    const src = e as { name?: unknown; stack?: unknown; code?: unknown; details?: unknown };\n    if (typeof src?.name === 'string') err.name = src.name;\n    if (typeof src?.stack === 'string') (err as { stack?: string }).stack = src.stack;\n    if (src && typeof src.code !== 'undefined') (err as { code?: unknown }).code = src.code;\n    if (src && typeof src.details !== 'undefined') (err as { details?: unknown }).details = src.details;\n  } catch {}\n  return err;\n}\n\n/**\n * Check if an error is related to user cancellation of TouchID/FaceID prompt\n * @param error - The error object or error message string\n * @returns true if the error indicates user cancellation\n */\nexport function isTouchIdCancellationError(error: unknown): boolean {\n  const msg = errorMessage(error);\n\n  // Normalize for case-insensitive substring checks on user-facing phrases\n  const lower = msg.toLowerCase();\n\n  return msg.includes('The operation either timed out or was not allowed') ||\n         msg.includes('NotAllowedError') ||\n         msg.includes('AbortError') ||\n         lower.includes('user cancelled') ||\n         lower.includes('user canceled') ||\n         lower.includes('user aborted');\n}\n\n/**\n * Get a user-friendly error message for TouchID/FaceID cancellation\n * @param context - The context where the cancellation occurred (e.g., 'registration', 'login')\n * @returns A user-friendly error message\n */\nexport function getTouchIdCancellationMessage(context: 'registration' | 'login'): string {\n  switch (context) {\n    case 'registration':\n      return `Registration was cancelled. Please try again when you're ready to set up your passkey.`;\n    case 'login':\n      return `Login was cancelled. Please try again when you're ready to authenticate.`;\n    default:\n      return `Operation was cancelled. Please try again when you're ready.`;\n  }\n}\n\n/**\n * Transform an error message to be more user-friendly\n * @param error - The original error object or message\n * @param context - The context where the error occurred\n * @param nearAccountId - Optional NEAR account ID for context-specific messages\n * @returns A user-friendly error message\n */\nexport function getUserFriendlyErrorMessage(\n  error: unknown,\n  context: 'registration' | 'login' = 'registration',\n  nearAccountId?: string\n): string {\n  const msg = errorMessage(error);\n\n  // Handle TouchID/FaceID cancellation\n  if (isTouchIdCancellationError(error)) {\n    return getTouchIdCancellationMessage(context);\n  }\n\n  // Missing PRF outputs\n  if (msg.includes('PRF outputs missing')) {\n    const op = context === 'registration' ? 'Registration' : 'Login';\n    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.`;\n  }\n\n  // Handle other common errors\n  if (msg.includes('one of the credentials already registered')) {\n    return `A passkey for '${nearAccountId || 'this account'}' already exists. Please try logging in instead.`;\n  }\n\n  if (msg.includes('Cannot deserialize the contract state')) {\n    return `Contract state deserialization failed. This may be due to a contract upgrade. Please try again or contact support.`;\n  }\n\n  if (msg.includes('Web3Authn contract registration check failed')) {\n    return `Contract registration check failed: ${msg.replace('Web3Authn contract registration check failed: ', '')}`;\n  }\n\n  if (msg.includes('Unknown error occurred')) {\n    return `${context === 'registration' ? 'Registration' : 'Login'} failed due to an unknown error. Please check your connection and try again.`;\n  }\n\n  // Return the original error message if no specific handling is needed\n  return msg;\n}\n\n/**\n * Format a NEAR JSON-RPC error into a concise, human-friendly message while\n * preserving the original error payload on `details`.\n *\n * The function is defensive and only relies on structural checks. It does not\n * require concrete NEAR types to avoid tight coupling with providers.\n */\nexport function formatNearRpcError(\n  operationName: string,\n  rpc: { error?: { code?: number; name?: string; message?: string; data?: unknown } }\n): { message: string; code?: number; name?: string; details?: unknown } {\n  const err = rpc?.error || {};\n  const details = err.data as unknown;\n\n  const code = typeof err.code === 'number' ? err.code : undefined;\n  const name = typeof err.name === 'string' ? err.name : undefined;\n  const generic = typeof err.message === 'string'\n    ? err.message\n    : (details && typeof (details as { message?: unknown }).message === 'string'\n        ? (details as { message: string }).message\n        : 'RPC error');\n\n  // Helper: get first key of object\n  const firstKey = (o: unknown): string | undefined => {\n    if (!o || typeof o !== 'object') return undefined;\n    const keys = Object.keys(o as Record<string, unknown>);\n    return keys.length ? keys[0] : undefined;\n  };\n\n  // Helper: shallow object check\n  const isObj = (v: unknown): v is Record<string, unknown> => !!v && typeof v === 'object' && !Array.isArray(v);\n\n  // Extract structured NEAR error kinds if present (generic traversal)\n  const d = details as Record<string, unknown> | undefined;\n  const txExec = isObj(d) ? d.TxExecutionError : undefined;\n  if (isObj(txExec)) {\n    let node: Record<string, unknown> | undefined = txExec;\n    const path: string[] = ['TxExecutionError'];\n    let depth = 0;\n    while (node && depth < 5 && isObj(node)) {\n      const k = firstKey(node);\n      if (!k) break;\n      const nextNode: unknown = (node as Record<string, unknown>)[k as string];\n      path.push(k);\n      node = isObj(nextNode) ? (nextNode as Record<string, unknown>) : undefined;\n      depth++;\n    }\n\n    // Special-case action index when present for better UX\n    const actionError = (isObj(txExec) && isObj(txExec.ActionError)) ? txExec.ActionError as Record<string, unknown> : undefined;\n    const idx = (isObj(actionError) && typeof actionError.index === 'number') ? ` at action ${actionError.index}` : '';\n\n    const payload = isObj(node) ? node : undefined;\n    const suffix = payload && Object.keys(payload).length ? `: ${JSON.stringify(payload)}` : '';\n    const prefix = [name, typeof code === 'number' ? `code ${code}` : undefined].filter(Boolean).join(' ');\n    const kindPath = path.join('.');\n    const message = [prefix, `${operationName} failed${idx} (${kindPath}${suffix})`].filter(Boolean).join(' - ');\n    return { message, code, name, details };\n  }\n\n  // Fallback generic message including data when available\n  const prefix = [name, typeof code === 'number' ? `code ${code}` : undefined].filter(Boolean).join(' ');\n  const dataStr = isObj(details) ? ` Details: ${JSON.stringify(details)}` : '';\n  const message = [prefix, `${operationName} RPC error: ${generic}${dataStr}`].filter(Boolean).join(' - ');\n  return { message, code, name, details };\n}\n\n/**\n * Extract a short NEAR error label for UI display, e.g.:\n *   \"InvalidTxError: UnsuitableStakingKey\"\n * Falls back to undefined when structure is not recognized.\n */\nexport function getNearShortErrorMessage(error: unknown): string | undefined {\n  try {\n    const err = error as { details?: unknown; message?: string };\n    const details = err?.details as Record<string, unknown> | undefined;\n    const isObj = (v: unknown): v is Record<string, unknown> => !!v && typeof v === 'object' && !Array.isArray(v);\n    if (!isObj(details)) return undefined;\n\n    // Path 1: details.TxExecutionError (RPC top-level error)\n    const txExec = details.TxExecutionError as unknown;\n    if (isObj(txExec)) {\n      if (isObj(txExec.InvalidTxError)) {\n        const inv = txExec.InvalidTxError as Record<string, unknown>;\n        if (isObj(inv.ActionsValidation)) {\n          const kind = Object.keys(inv.ActionsValidation)[0];\n          if (kind) return `InvalidTxError: ${kind}`;\n        }\n        const first = Object.keys(inv)[0];\n        if (first) return `InvalidTxError: ${first}`;\n        return 'InvalidTxError';\n      }\n      if (isObj(txExec.ActionError)) {\n        const ae = txExec.ActionError as Record<string, unknown>;\n        const kindObj = isObj(ae.kind) ? (ae.kind as Record<string, unknown>) : undefined;\n        const kind = kindObj ? Object.keys(kindObj)[0] : undefined;\n        if (kind) return `ActionError: ${kind}`;\n        return 'ActionError';\n      }\n    }\n\n    // Path 2: details.Failure (sendTransaction resolved with Failure)\n    const failure = details.Failure as unknown;\n    if (isObj(failure)) {\n      if (isObj(failure.InvalidTxError)) {\n        const inv = failure.InvalidTxError as Record<string, unknown>;\n        if (isObj(inv.ActionsValidation)) {\n          const kind = Object.keys(inv.ActionsValidation)[0];\n          if (kind) return `InvalidTxError: ${kind}`;\n        }\n        const first = Object.keys(inv)[0];\n        if (first) return `InvalidTxError: ${first}`;\n        return 'InvalidTxError';\n      }\n      if (isObj(failure.ActionError)) {\n        const ae = failure.ActionError as Record<string, unknown>;\n        const kindObj = isObj(ae.kind) ? (ae.kind as Record<string, unknown>) : undefined;\n        const kind = kindObj ? Object.keys(kindObj)[0] : undefined;\n        if (kind) return `ActionError: ${kind}`;\n        return 'ActionError';\n      }\n    }\n\n    return undefined;\n  } catch {\n    return undefined;\n  }\n}\n"],"mappings":"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"}

package/dist/cjs/react/src/utils/qrScanner.js

@@ -0,0 +1,319 @@
+const require_linkDevice = require('../core/types/linkDevice.js');
+const require_scanDevice = require('../core/TatchiPasskey/scanDevice.js');
+
+//#region src/utils/qrScanner.ts
+let ScanQRCodeFlowState = /* @__PURE__ */ function(ScanQRCodeFlowState$1) {
+	ScanQRCodeFlowState$1["IDLE"] = "idle";
+	ScanQRCodeFlowState$1["INITIALIZING"] = "initializing";
+	ScanQRCodeFlowState$1["SCANNING"] = "scanning";
+	ScanQRCodeFlowState$1["SUCCESS"] = "success";
+	ScanQRCodeFlowState$1["ERROR"] = "error";
+	ScanQRCodeFlowState$1["CANCELLED"] = "cancelled";
+	return ScanQRCodeFlowState$1;
+}({});
+/**
+* ScanQRCodeFlow - Encapsulates QR code scanning lifecycle
+* Can be used in both React (useQRCamera) and non-React (TatchiPasskey) contexts
+*/
+var ScanQRCodeFlow = class {
+	state = ScanQRCodeFlowState.IDLE;
+	mediaStream = null;
+	video = null;
+	canvas;
+	ctx;
+	animationId = null;
+	timeoutId = null;
+	progressIntervalId = null;
+	scanStartTime = 0;
+	currentError = null;
+	detectedQRData = null;
+	constructor(options = {}, events = {}) {
+		this.options = options;
+		this.events = events;
+		this.canvas = document.createElement("canvas");
+		const ctx = this.canvas.getContext("2d");
+		if (!ctx) throw new Error("Unable to get canvas 2D context");
+		this.ctx = ctx;
+	}
+	/**
+	* Get current flow state
+	*/
+	getState() {
+		return {
+			state: this.state,
+			isScanning: this.state === ScanQRCodeFlowState.SCANNING,
+			scanDuration: this.scanStartTime ? Date.now() - this.scanStartTime : 0,
+			error: this.currentError,
+			qrData: this.detectedQRData
+		};
+	}
+	/**
+	* Start scanning for QR codes
+	*/
+	async startQRScanner() {
+		if (this.state !== ScanQRCodeFlowState.IDLE && this.state !== ScanQRCodeFlowState.ERROR && this.state !== ScanQRCodeFlowState.CANCELLED) return;
+		this.setState(ScanQRCodeFlowState.INITIALIZING);
+		this.currentError = null;
+		this.detectedQRData = null;
+		try {
+			const constraints = this.buildCameraConstraints();
+			this.mediaStream = await navigator.mediaDevices.getUserMedia(constraints);
+			if (!this.video) {
+				this.video = document.createElement("video");
+				this.video.playsInline = true;
+				this.video.muted = true;
+			}
+			this.video.srcObject = this.mediaStream;
+			await this.video.play();
+			this.events.onCameraReady?.(this.mediaStream);
+			this.setState(ScanQRCodeFlowState.SCANNING);
+			this.scanStartTime = Date.now();
+			this.startProgressTracking();
+			const timeout = this.options.timeout ?? 6e4;
+			if (timeout > 0) this.timeoutId = setTimeout(() => {
+				this.handleError(/* @__PURE__ */ new Error(`Camera scan timeout - no QR code detected within ${timeout}ms`));
+			}, timeout);
+			this.scanFrame();
+		} catch (error) {
+			this.handleError(/* @__PURE__ */ new Error(`Camera access failed: ${error.message}`));
+		}
+	}
+	/**
+	* Stop scanning and cleanup resources
+	*
+	* This method stops the scanning process and cleans up all internal resources.
+	* For React contexts with external video elements, use destroy() instead.
+	*/
+	stop() {
+		this.setState(ScanQRCodeFlowState.CANCELLED);
+		this.cleanup();
+	}
+	/**
+	* Attach an external video element (for React contexts)
+	*/
+	attachVideoElement(video) {
+		this.video = video;
+		if (this.mediaStream && this.state === ScanQRCodeFlowState.SCANNING) {
+			this.video.srcObject = this.mediaStream;
+			this.video.play();
+		}
+	}
+	/**
+	* Detach the video element
+	*/
+	detachVideoElement() {
+		if (this.video) this.video.srcObject = null;
+		this.video = null;
+	}
+	/**
+	* Switch to a different camera
+	*/
+	async switchCamera(cameraId) {
+		const wasScanning = this.state === ScanQRCodeFlowState.SCANNING;
+		if (wasScanning) this.stop();
+		this.options.cameraId = cameraId;
+		if (wasScanning) await this.startQRScanner();
+	}
+	/**
+	* Get available video devices
+	*/
+	async getAvailableCameras() {
+		try {
+			const devices = await navigator.mediaDevices.enumerateDevices();
+			return devices.filter((device) => device.kind === "videoinput");
+		} catch (error) {
+			console.error("Error enumerating cameras:", error);
+			throw new Error("Failed to access camera devices");
+		}
+	}
+	/**
+	* Get the current media stream (for external video elements)
+	*/
+	getMediaStream() {
+		return this.mediaStream;
+	}
+	setState(newState) {
+		this.state = newState;
+	}
+	buildCameraConstraints() {
+		const constraints = { video: {
+			deviceId: this.options.cameraId || void 0,
+			width: {
+				ideal: 720,
+				min: 480
+			},
+			height: {
+				ideal: 720,
+				min: 480
+			},
+			aspectRatio: { ideal: 1 },
+			facingMode: this.options.cameraId ? void 0 : this.options.cameraConfigs?.facingMode
+		} };
+		if (this.options.cameraConfigs?.width || this.options.cameraConfigs?.height) {
+			const videoConstraints = constraints.video;
+			if (this.options.cameraConfigs.width) videoConstraints.width = {
+				ideal: this.options.cameraConfigs.width,
+				min: 480
+			};
+			if (this.options.cameraConfigs.height) videoConstraints.height = {
+				ideal: this.options.cameraConfigs.height,
+				min: 480
+			};
+		}
+		return constraints;
+	}
+	startProgressTracking() {
+		this.progressIntervalId = setInterval(() => {
+			if (this.state === ScanQRCodeFlowState.SCANNING) {
+				const duration = Date.now() - this.scanStartTime;
+				this.events.onScanProgress?.(duration);
+			}
+		}, 100);
+	}
+	async scanFrame() {
+		if (this.state !== ScanQRCodeFlowState.SCANNING || !this.video || !this.mediaStream) return;
+		try {
+			if (this.video.readyState === this.video.HAVE_ENOUGH_DATA) {
+				this.canvas.width = this.video.videoWidth;
+				this.canvas.height = this.video.videoHeight;
+				this.ctx.drawImage(this.video, 0, 0, this.canvas.width, this.canvas.height);
+				const imageData = this.ctx.getImageData(0, 0, this.canvas.width, this.canvas.height);
+				const qrData = await this.scanQRFromImageData(imageData);
+				if (qrData) {
+					const parsedData = this.parseAndValidateQRData(qrData);
+					this.handleSuccess(parsedData);
+					return;
+				}
+			}
+		} catch (error) {
+			this.handleError(error instanceof Error ? error : new Error(String(error)));
+			return;
+		}
+		if (this.state === ScanQRCodeFlowState.SCANNING) this.animationId = requestAnimationFrame(() => this.scanFrame());
+	}
+	async scanQRFromImageData(imageData) {
+		const { default: jsQR } = await import("jsqr");
+		const code = jsQR(imageData.data, imageData.width, imageData.height, { inversionAttempts: "dontInvert" });
+		return code ? code.data : null;
+	}
+	parseAndValidateQRData(qrData) {
+		let parsedData;
+		try {
+			parsedData = JSON.parse(qrData);
+		} catch {
+			if (qrData.startsWith("http")) throw new Error("QR code contains a URL, not device linking data");
+			if (qrData.includes("ed25519:")) throw new Error("QR code contains a NEAR key, not device linking data");
+			throw new Error("Invalid QR code format - expected JSON device linking data");
+		}
+		require_scanDevice.validateDeviceLinkingQRData(parsedData);
+		return parsedData;
+	}
+	handleSuccess(qrData) {
+		this.setState(ScanQRCodeFlowState.SUCCESS);
+		this.detectedQRData = qrData;
+		this.cleanup();
+		this.events.onQRDetected?.(qrData);
+	}
+	handleError(error) {
+		this.setState(ScanQRCodeFlowState.ERROR);
+		this.currentError = error;
+		this.cleanup();
+		this.events.onError?.(error);
+	}
+	cleanup() {
+		if (this.animationId) {
+			cancelAnimationFrame(this.animationId);
+			this.animationId = null;
+		}
+		if (this.timeoutId) {
+			clearTimeout(this.timeoutId);
+			this.timeoutId = null;
+		}
+		if (this.progressIntervalId) {
+			clearInterval(this.progressIntervalId);
+			this.progressIntervalId = null;
+		}
+		if (this.mediaStream) {
+			this.mediaStream.getTracks().forEach((track) => track.stop());
+			this.mediaStream = null;
+		}
+		if (this.video) this.video.srcObject = null;
+	}
+};
+/**
+* Scan QR code from file with lazy loading
+*/
+async function scanQRCodeFromFile(file) {
+	const canvas = document.createElement("canvas");
+	const ctx = canvas.getContext("2d");
+	if (!ctx) throw createQRError("Unable to get canvas 2D context");
+	const dataUrl = await new Promise((resolve, reject) => {
+		const reader = new FileReader();
+		reader.onload = (e) => {
+			if (e.target?.result) resolve(e.target.result);
+			else reject(createQRError("Failed to read file"));
+		};
+		reader.onerror = () => reject(createQRError("Failed to read file"));
+		reader.readAsDataURL(file);
+	});
+	const img = await new Promise((resolve, reject) => {
+		const image = new Image();
+		image.onload = () => resolve(image);
+		image.onerror = () => reject(createQRError("Failed to load image file"));
+		image.src = dataUrl;
+	});
+	canvas.width = img.width;
+	canvas.height = img.height;
+	ctx.drawImage(img, 0, 0);
+	const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
+	const qrData = await scanQRFromImageData(imageData);
+	if (!qrData) throw createQRError("No QR code found in image");
+	return parseAndValidateQRData(qrData);
+}
+/**
+* Enumerate available video input devices
+*/
+async function enumerateVideoDevices() {
+	try {
+		const devices = await navigator.mediaDevices.enumerateDevices();
+		return devices.filter((device) => device.kind === "videoinput");
+	} catch (error) {
+		console.error("Error enumerating cameras:", error);
+		throw new Error("Failed to access camera devices");
+	}
+}
+/**
+* Detect if a camera is front-facing based on its label
+*/
+function detectFrontCamera(camera) {
+	const label = camera.label.toLowerCase();
+	return label.includes("front") || label.includes("user") || label.includes("selfie") || label.includes("facetime") || label.includes("facing front");
+}
+async function scanQRFromImageData(imageData) {
+	const { default: jsQR } = await import("jsqr");
+	const code = jsQR(imageData.data, imageData.width, imageData.height, { inversionAttempts: "dontInvert" });
+	return code ? code.data : null;
+}
+function parseAndValidateQRData(qrData) {
+	let parsedData;
+	try {
+		parsedData = JSON.parse(qrData);
+	} catch {
+		if (qrData.startsWith("http")) throw new Error("QR code contains a URL, not device linking data");
+		if (qrData.includes("ed25519:")) throw new Error("QR code contains a NEAR key, not device linking data");
+		throw new Error("Invalid QR code format - expected JSON device linking data");
+	}
+	require_scanDevice.validateDeviceLinkingQRData(parsedData);
+	return parsedData;
+}
+function createQRError(message) {
+	return new require_linkDevice.DeviceLinkingError(message, require_linkDevice.DeviceLinkingErrorCode.INVALID_QR_DATA, "authorization");
+}
+
+//#endregion
+exports.ScanQRCodeFlow = ScanQRCodeFlow;
+exports.ScanQRCodeFlowState = ScanQRCodeFlowState;
+exports.detectFrontCamera = detectFrontCamera;
+exports.enumerateVideoDevices = enumerateVideoDevices;
+exports.scanQRCodeFromFile = scanQRCodeFromFile;
+//# sourceMappingURL=qrScanner.js.map

package/dist/cjs/react/src/utils/qrScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qrScanner.js","names":["options: ScanQRCodeFlowOptions","events: ScanQRCodeFlowEvents","error: any","constraints: MediaStreamConstraints","parsedData: DeviceLinkingQRData","DeviceLinkingError","DeviceLinkingErrorCode"],"sources":["../../../../../src/utils/qrScanner.ts"],"sourcesContent":["import type { DeviceLinkingQRData } from '../core/types/linkDevice';\nimport { DeviceLinkingError, DeviceLinkingErrorCode } from '../core/types/linkDevice';\nimport { validateDeviceLinkingQRData } from '../core/TatchiPasskey/scanDevice';\nimport { DeviceLinkingSSEEvent } from '@/core/types/sdkSentEvents';\n\n// ===========================\n// TYPES AND INTERFACES\n// ===========================\n\nexport interface ScanQRCodeFlowOptions {\n  cameraId?: string;\n  cameraConfigs?: {\n    facingMode?: 'user' | 'environment';\n    width?: number;\n    height?: number;\n  };\n  timeout?: number; // in milliseconds, default 60000\n}\n\nexport interface ScanQRCodeFlowEvents {\n  onEvent?: (event: DeviceLinkingSSEEvent) => void;\n  onQRDetected?: (qrData: DeviceLinkingQRData) => void;\n  onError?: (error: Error) => void;\n  onCameraReady?: (stream: MediaStream) => void;\n  onScanProgress?: (duration: number) => void; // Called periodically during scanning\n}\n\nexport enum ScanQRCodeFlowState {\n  IDLE = 'idle',\n  INITIALIZING = 'initializing',\n  SCANNING = 'scanning',\n  SUCCESS = 'success',\n  ERROR = 'error',\n  CANCELLED = 'cancelled'\n}\n\n// ===========================\n// SCANQRCODEFLOW CLASS\n// ===========================\n\n/**\n * ScanQRCodeFlow - Encapsulates QR code scanning lifecycle\n * Can be used in both React (useQRCamera) and non-React (TatchiPasskey) contexts\n */\nexport class ScanQRCodeFlow {\n  private state: ScanQRCodeFlowState = ScanQRCodeFlowState.IDLE;\n  private mediaStream: MediaStream | null = null;\n  private video: HTMLVideoElement | null = null;\n  private canvas: HTMLCanvasElement;\n  private ctx: CanvasRenderingContext2D;\n  private animationId: number | null = null;\n  private timeoutId: NodeJS.Timeout | null = null;\n  private progressIntervalId: NodeJS.Timeout | null = null;\n  private scanStartTime: number = 0;\n  private currentError: Error | null = null;\n  private detectedQRData: DeviceLinkingQRData | null = null;\n\n  constructor(\n    private options: ScanQRCodeFlowOptions = {},\n    private events: ScanQRCodeFlowEvents = {}\n  ) {\n    this.canvas = document.createElement('canvas');\n    const ctx = this.canvas.getContext('2d');\n    if (!ctx) {\n      throw new Error('Unable to get canvas 2D context');\n    }\n    this.ctx = ctx;\n  }\n\n  /**\n   * Get current flow state\n   */\n  getState(): {\n    state: ScanQRCodeFlowState;\n    isScanning: boolean;\n    scanDuration: number;\n    error: Error | null;\n    qrData: DeviceLinkingQRData | null;\n  } {\n    return {\n      state: this.state,\n      isScanning: this.state === ScanQRCodeFlowState.SCANNING,\n      scanDuration: this.scanStartTime ? Date.now() - this.scanStartTime : 0,\n      error: this.currentError,\n      qrData: this.detectedQRData\n    };\n  }\n\n  /**\n   * Start scanning for QR codes\n   */\n  async startQRScanner(): Promise<void> {\n    if (\n      this.state !== ScanQRCodeFlowState.IDLE &&\n      this.state !== ScanQRCodeFlowState.ERROR &&\n      this.state !== ScanQRCodeFlowState.CANCELLED\n    ) {\n      return; // Already running\n    }\n\n    this.setState(ScanQRCodeFlowState.INITIALIZING);\n    this.currentError = null;\n    this.detectedQRData = null;\n\n    try {\n      // Build camera constraints\n      const constraints = this.buildCameraConstraints();\n\n      // Get camera stream\n      this.mediaStream = await navigator.mediaDevices.getUserMedia(constraints);\n\n      // Create video element if not provided externally\n      if (!this.video) {\n        this.video = document.createElement('video');\n        this.video.playsInline = true;\n        this.video.muted = true;\n      }\n\n      this.video.srcObject = this.mediaStream;\n      await this.video.play();\n\n      // Notify camera is ready\n      this.events.onCameraReady?.(this.mediaStream);\n\n      this.setState(ScanQRCodeFlowState.SCANNING);\n      this.scanStartTime = Date.now();\n\n      // Start progress tracking\n      this.startProgressTracking();\n\n      // Set timeout if specified\n      const timeout = this.options.timeout ?? 60000;\n      if (timeout > 0) {\n        this.timeoutId = setTimeout(() => {\n          this.handleError(new Error(`Camera scan timeout - no QR code detected within ${timeout}ms`));\n        }, timeout);\n      }\n\n      // Start scanning loop\n      this.scanFrame();\n\n    } catch (error: any) {\n      this.handleError(new Error(`Camera access failed: ${error.message}`));\n    }\n  }\n\n  /**\n   * Stop scanning and cleanup resources\n   *\n   * This method stops the scanning process and cleans up all internal resources.\n   * For React contexts with external video elements, use destroy() instead.\n   */\n  stop(): void {\n    this.setState(ScanQRCodeFlowState.CANCELLED);\n    this.cleanup();\n  }\n\n  /**\n   * Attach an external video element (for React contexts)\n   */\n  attachVideoElement(video: HTMLVideoElement): void {\n    this.video = video;\n    if (this.mediaStream && this.state === ScanQRCodeFlowState.SCANNING) {\n      this.video.srcObject = this.mediaStream;\n      this.video.play();\n    }\n  }\n\n  /**\n   * Detach the video element\n   */\n  detachVideoElement(): void {\n    if (this.video) {\n      this.video.srcObject = null;\n    }\n    this.video = null;\n  }\n\n  /**\n   * Switch to a different camera\n   */\n  async switchCamera(cameraId: string): Promise<void> {\n    const wasScanning = this.state === ScanQRCodeFlowState.SCANNING;\n    if (wasScanning) {\n      this.stop();\n    }\n\n    this.options.cameraId = cameraId;\n\n    if (wasScanning) {\n      await this.startQRScanner();\n    }\n  }\n\n  /**\n   * Get available video devices\n   */\n  async getAvailableCameras(): Promise<MediaDeviceInfo[]> {\n    try {\n      const devices = await navigator.mediaDevices.enumerateDevices();\n      return devices.filter(device => device.kind === 'videoinput');\n    } catch (error) {\n      console.error('Error enumerating cameras:', error);\n      throw new Error('Failed to access camera devices');\n    }\n  }\n\n  /**\n   * Get the current media stream (for external video elements)\n   */\n  getMediaStream(): MediaStream | null {\n    return this.mediaStream;\n  }\n\n  // Private methods\n\n  private setState(newState: ScanQRCodeFlowState): void {\n    this.state = newState;\n  }\n\n  private buildCameraConstraints(): MediaStreamConstraints {\n    const constraints: MediaStreamConstraints = {\n      video: {\n        deviceId: this.options.cameraId || undefined,\n        width: { ideal: 720, min: 480 },\n        height: { ideal: 720, min: 480 },\n        aspectRatio: { ideal: 1.0 },\n        facingMode: this.options.cameraId ? undefined : this.options.cameraConfigs?.facingMode\n      }\n    };\n\n    // Override with custom width/height if provided\n    if (this.options.cameraConfigs?.width || this.options.cameraConfigs?.height) {\n      const videoConstraints = constraints.video as MediaTrackConstraints;\n      if (this.options.cameraConfigs.width) {\n        videoConstraints.width = { ideal: this.options.cameraConfigs.width, min: 480 };\n      }\n      if (this.options.cameraConfigs.height) {\n        videoConstraints.height = { ideal: this.options.cameraConfigs.height, min: 480 };\n      }\n    }\n\n    return constraints;\n  }\n\n  private startProgressTracking(): void {\n    this.progressIntervalId = setInterval(() => {\n      if (this.state === ScanQRCodeFlowState.SCANNING) {\n        const duration = Date.now() - this.scanStartTime;\n        this.events.onScanProgress?.(duration);\n      }\n    }, 100); // Update every 100ms\n  }\n\n  private async scanFrame(): Promise<void> {\n    if (\n      this.state !== ScanQRCodeFlowState.SCANNING\n      || !this.video\n      || !this.mediaStream\n    ) {\n      return;\n    }\n\n    try {\n      // Check if video is ready\n      if (this.video.readyState === this.video.HAVE_ENOUGH_DATA) {\n        // Draw video frame to canvas\n        this.canvas.width = this.video.videoWidth;\n        this.canvas.height = this.video.videoHeight;\n        this.ctx.drawImage(this.video, 0, 0, this.canvas.width, this.canvas.height);\n\n        // Scan for QR code\n        const imageData = this.ctx.getImageData(0, 0, this.canvas.width, this.canvas.height);\n        const qrData = await this.scanQRFromImageData(imageData);\n\n        if (qrData) {\n          const parsedData = this.parseAndValidateQRData(qrData);\n          this.handleSuccess(parsedData);\n          return;\n        }\n      }\n    } catch (error: any) {\n      // Fail the scan on validation or frame errors\n      this.handleError(error instanceof Error ? error : new Error(String(error)));\n      return;\n    }\n\n    // Schedule next frame\n    if (this.state === ScanQRCodeFlowState.SCANNING) {\n      this.animationId = requestAnimationFrame(() => this.scanFrame());\n    }\n  }\n\n  private async scanQRFromImageData(imageData: ImageData): Promise<string | null> {\n    const { default: jsQR } = await import('jsqr');\n    const code = jsQR(imageData.data, imageData.width, imageData.height, {\n      inversionAttempts: \"dontInvert\"\n    });\n    return code ? code.data : null;\n  }\n\n  private parseAndValidateQRData(qrData: string): DeviceLinkingQRData {\n    let parsedData: DeviceLinkingQRData;\n    try {\n      parsedData = JSON.parse(qrData);\n    } catch {\n      if (qrData.startsWith('http')) {\n        throw new Error('QR code contains a URL, not device linking data');\n      }\n      if (qrData.includes('ed25519:')) {\n        throw new Error('QR code contains a NEAR key, not device linking data');\n      }\n      throw new Error('Invalid QR code format - expected JSON device linking data');\n    }\n\n    // Use the validation function from scanDevice.ts\n    validateDeviceLinkingQRData(parsedData);\n    return parsedData;\n  }\n\n  private handleSuccess(qrData: DeviceLinkingQRData): void {\n    this.setState(ScanQRCodeFlowState.SUCCESS);\n    this.detectedQRData = qrData;\n    this.cleanup();\n    this.events.onQRDetected?.(qrData);\n  }\n\n  private handleError(error: Error): void {\n    this.setState(ScanQRCodeFlowState.ERROR);\n    this.currentError = error;\n    this.cleanup();\n    this.events.onError?.(error);\n  }\n\n  private cleanup(): void {\n    // Stop animation frame\n    if (this.animationId) {\n      cancelAnimationFrame(this.animationId);\n      this.animationId = null;\n    }\n\n    // Clear timeout\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId);\n      this.timeoutId = null;\n    }\n\n    // Stop progress tracking\n    if (this.progressIntervalId) {\n      clearInterval(this.progressIntervalId);\n      this.progressIntervalId = null;\n    }\n\n    // MediaStream Cleanup: Stop all tracks and clear all video references\n    // This ensures camera light turns off regardless of how the video element is managed\n    if (this.mediaStream) {\n      this.mediaStream.getTracks().forEach(track => track.stop());\n      this.mediaStream = null;\n    }\n\n    // Clear all video sources to ensure no lingering MediaStream references\n    if (this.video) {\n      this.video.srcObject = null;\n    }\n  }\n}\n\n// ===========================\n// CONVENIENCE FUNCTIONS\n// ===========================\n\n/**\n * Scan QR code from file with lazy loading\n */\nexport async function scanQRCodeFromFile(file: File): Promise<DeviceLinkingQRData> {\n  // Setup canvas\n  const canvas = document.createElement('canvas');\n  const ctx = canvas.getContext('2d');\n  if (!ctx) throw createQRError('Unable to get canvas 2D context');\n\n  // Load and process image\n  const dataUrl = await new Promise<string>((resolve, reject) => {\n    const reader = new FileReader();\n    reader.onload = (e) => {\n      if (e.target?.result) {\n        resolve(e.target.result as string);\n      } else {\n        reject(createQRError('Failed to read file'));\n      }\n    };\n    reader.onerror = () => reject(createQRError('Failed to read file'));\n    reader.readAsDataURL(file);\n  });\n\n  // Process image\n  const img = await new Promise<HTMLImageElement>((resolve, reject) => {\n    const image = new Image();\n    image.onload = () => resolve(image);\n    image.onerror = () => reject(createQRError('Failed to load image file'));\n    image.src = dataUrl;\n  });\n\n  // Scan QR code using shared logic\n  canvas.width = img.width;\n  canvas.height = img.height;\n  ctx.drawImage(img, 0, 0);\n\n  const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);\n  const qrData = await scanQRFromImageData(imageData);\n\n  if (!qrData) {\n    throw createQRError('No QR code found in image');\n  }\n\n  return parseAndValidateQRData(qrData);\n}\n\n// ===========================\n// UTILITY FUNCTIONS\n// ===========================\n\n/**\n * Enumerate available video input devices\n */\nexport async function enumerateVideoDevices(): Promise<MediaDeviceInfo[]> {\n  try {\n    const devices = await navigator.mediaDevices.enumerateDevices();\n    return devices.filter(device => device.kind === 'videoinput');\n  } catch (error) {\n    console.error('Error enumerating cameras:', error);\n    throw new Error('Failed to access camera devices');\n  }\n}\n\n/**\n * Detect if a camera is front-facing based on its label\n */\nexport function detectFrontCamera(camera: MediaDeviceInfo): boolean {\n  const label = camera.label.toLowerCase();\n  return label.includes('front') ||\n         label.includes('user') ||\n         label.includes('selfie') ||\n         label.includes('facetime') ||\n         label.includes('facing front');\n}\n\n/**\n * Detect camera facing mode from media stream settings\n */\nexport function detectCameraFacingMode(stream: MediaStream): boolean {\n  const videoTrack = stream.getVideoTracks()[0];\n  if (videoTrack) {\n    const settings = videoTrack.getSettings();\n    return settings.facingMode === 'user';\n  }\n  return false;\n}\n\n// ===========================\n// PRIVATE HELPER FUNCTIONS\n// ===========================\n\nasync function scanQRFromImageData(imageData: ImageData): Promise<string | null> {\n  const { default: jsQR } = await import('jsqr');\n  const code = jsQR(imageData.data, imageData.width, imageData.height, {\n    inversionAttempts: \"dontInvert\"\n  });\n  return code ? code.data : null;\n}\n\nfunction parseAndValidateQRData(qrData: string): DeviceLinkingQRData {\n  let parsedData: DeviceLinkingQRData;\n  try {\n    parsedData = JSON.parse(qrData);\n  } catch {\n    if (qrData.startsWith('http')) {\n      throw new Error('QR code contains a URL, not device linking data');\n    }\n    if (qrData.includes('ed25519:')) {\n      throw new Error('QR code contains a NEAR key, not device linking data');\n    }\n    throw new Error('Invalid QR code format - expected JSON device linking data');\n  }\n\n  // Use the validation function from scanDevice.ts\n  validateDeviceLinkingQRData(parsedData);\n  return parsedData;\n}\n\nfunction createQRError(message: string): DeviceLinkingError {\n  return new DeviceLinkingError(message, DeviceLinkingErrorCode.INVALID_QR_DATA, 'authorization');\n}\n"],"mappings":";;;;AA2BA,IAAY,sEAAL;AACL;AACA;AACA;AACA;AACA;AACA;;;;;;;AAWF,IAAa,iBAAb,MAA4B;CAC1B,AAAQ,QAA6B,oBAAoB;CACzD,AAAQ,cAAkC;CAC1C,AAAQ,QAAiC;CACzC,AAAQ;CACR,AAAQ;CACR,AAAQ,cAA6B;CACrC,AAAQ,YAAmC;CAC3C,AAAQ,qBAA4C;CACpD,AAAQ,gBAAwB;CAChC,AAAQ,eAA6B;CACrC,AAAQ,iBAA6C;CAErD,YACE,AAAQA,UAAiC,IACzC,AAAQC,SAA+B,IACvC;EAFQ;EACA;AAER,OAAK,SAAS,SAAS,cAAc;EACrC,MAAM,MAAM,KAAK,OAAO,WAAW;AACnC,MAAI,CAAC,IACH,OAAM,IAAI,MAAM;AAElB,OAAK,MAAM;;;;;CAMb,WAME;AACA,SAAO;GACL,OAAO,KAAK;GACZ,YAAY,KAAK,UAAU,oBAAoB;GAC/C,cAAc,KAAK,gBAAgB,KAAK,QAAQ,KAAK,gBAAgB;GACrE,OAAO,KAAK;GACZ,QAAQ,KAAK;;;;;;CAOjB,MAAM,iBAAgC;AACpC,MACE,KAAK,UAAU,oBAAoB,QACnC,KAAK,UAAU,oBAAoB,SACnC,KAAK,UAAU,oBAAoB,UAEnC;AAGF,OAAK,SAAS,oBAAoB;AAClC,OAAK,eAAe;AACpB,OAAK,iBAAiB;AAEtB,MAAI;GAEF,MAAM,cAAc,KAAK;AAGzB,QAAK,cAAc,MAAM,UAAU,aAAa,aAAa;AAG7D,OAAI,CAAC,KAAK,OAAO;AACf,SAAK,QAAQ,SAAS,cAAc;AACpC,SAAK,MAAM,cAAc;AACzB,SAAK,MAAM,QAAQ;;AAGrB,QAAK,MAAM,YAAY,KAAK;AAC5B,SAAM,KAAK,MAAM;AAGjB,QAAK,OAAO,gBAAgB,KAAK;AAEjC,QAAK,SAAS,oBAAoB;AAClC,QAAK,gBAAgB,KAAK;AAG1B,QAAK;GAGL,MAAM,UAAU,KAAK,QAAQ,WAAW;AACxC,OAAI,UAAU,EACZ,MAAK,YAAY,iBAAiB;AAChC,SAAK,4BAAY,IAAI,MAAM,oDAAoD,QAAQ;MACtF;AAIL,QAAK;WAEEC,OAAY;AACnB,QAAK,4BAAY,IAAI,MAAM,yBAAyB,MAAM;;;;;;;;;CAU9D,OAAa;AACX,OAAK,SAAS,oBAAoB;AAClC,OAAK;;;;;CAMP,mBAAmB,OAA+B;AAChD,OAAK,QAAQ;AACb,MAAI,KAAK,eAAe,KAAK,UAAU,oBAAoB,UAAU;AACnE,QAAK,MAAM,YAAY,KAAK;AAC5B,QAAK,MAAM;;;;;;CAOf,qBAA2B;AACzB,MAAI,KAAK,MACP,MAAK,MAAM,YAAY;AAEzB,OAAK,QAAQ;;;;;CAMf,MAAM,aAAa,UAAiC;EAClD,MAAM,cAAc,KAAK,UAAU,oBAAoB;AACvD,MAAI,YACF,MAAK;AAGP,OAAK,QAAQ,WAAW;AAExB,MAAI,YACF,OAAM,KAAK;;;;;CAOf,MAAM,sBAAkD;AACtD,MAAI;GACF,MAAM,UAAU,MAAM,UAAU,aAAa;AAC7C,UAAO,QAAQ,QAAO,WAAU,OAAO,SAAS;WACzC,OAAO;AACd,WAAQ,MAAM,8BAA8B;AAC5C,SAAM,IAAI,MAAM;;;;;;CAOpB,iBAAqC;AACnC,SAAO,KAAK;;CAKd,AAAQ,SAAS,UAAqC;AACpD,OAAK,QAAQ;;CAGf,AAAQ,yBAAiD;EACvD,MAAMC,cAAsC,EAC1C,OAAO;GACL,UAAU,KAAK,QAAQ,YAAY;GACnC,OAAO;IAAE,OAAO;IAAK,KAAK;;GAC1B,QAAQ;IAAE,OAAO;IAAK,KAAK;;GAC3B,aAAa,EAAE,OAAO;GACtB,YAAY,KAAK,QAAQ,WAAW,SAAY,KAAK,QAAQ,eAAe;;AAKhF,MAAI,KAAK,QAAQ,eAAe,SAAS,KAAK,QAAQ,eAAe,QAAQ;GAC3E,MAAM,mBAAmB,YAAY;AACrC,OAAI,KAAK,QAAQ,cAAc,MAC7B,kBAAiB,QAAQ;IAAE,OAAO,KAAK,QAAQ,cAAc;IAAO,KAAK;;AAE3E,OAAI,KAAK,QAAQ,cAAc,OAC7B,kBAAiB,SAAS;IAAE,OAAO,KAAK,QAAQ,cAAc;IAAQ,KAAK;;;AAI/E,SAAO;;CAGT,AAAQ,wBAA8B;AACpC,OAAK,qBAAqB,kBAAkB;AAC1C,OAAI,KAAK,UAAU,oBAAoB,UAAU;IAC/C,MAAM,WAAW,KAAK,QAAQ,KAAK;AACnC,SAAK,OAAO,iBAAiB;;KAE9B;;CAGL,MAAc,YAA2B;AACvC,MACE,KAAK,UAAU,oBAAoB,YAChC,CAAC,KAAK,SACN,CAAC,KAAK,YAET;AAGF,MAAI;AAEF,OAAI,KAAK,MAAM,eAAe,KAAK,MAAM,kBAAkB;AAEzD,SAAK,OAAO,QAAQ,KAAK,MAAM;AAC/B,SAAK,OAAO,SAAS,KAAK,MAAM;AAChC,SAAK,IAAI,UAAU,KAAK,OAAO,GAAG,GAAG,KAAK,OAAO,OAAO,KAAK,OAAO;IAGpE,MAAM,YAAY,KAAK,IAAI,aAAa,GAAG,GAAG,KAAK,OAAO,OAAO,KAAK,OAAO;IAC7E,MAAM,SAAS,MAAM,KAAK,oBAAoB;AAE9C,QAAI,QAAQ;KACV,MAAM,aAAa,KAAK,uBAAuB;AAC/C,UAAK,cAAc;AACnB;;;WAGGD,OAAY;AAEnB,QAAK,YAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO;AACnE;;AAIF,MAAI,KAAK,UAAU,oBAAoB,SACrC,MAAK,cAAc,4BAA4B,KAAK;;CAIxD,MAAc,oBAAoB,WAA8C;EAC9E,MAAM,EAAE,SAAS,SAAS,MAAM,OAAO;EACvC,MAAM,OAAO,KAAK,UAAU,MAAM,UAAU,OAAO,UAAU,QAAQ,EACnE,mBAAmB;AAErB,SAAO,OAAO,KAAK,OAAO;;CAG5B,AAAQ,uBAAuB,QAAqC;EAClE,IAAIE;AACJ,MAAI;AACF,gBAAa,KAAK,MAAM;UAClB;AACN,OAAI,OAAO,WAAW,QACpB,OAAM,IAAI,MAAM;AAElB,OAAI,OAAO,SAAS,YAClB,OAAM,IAAI,MAAM;AAElB,SAAM,IAAI,MAAM;;AAIlB,iDAA4B;AAC5B,SAAO;;CAGT,AAAQ,cAAc,QAAmC;AACvD,OAAK,SAAS,oBAAoB;AAClC,OAAK,iBAAiB;AACtB,OAAK;AACL,OAAK,OAAO,eAAe;;CAG7B,AAAQ,YAAY,OAAoB;AACtC,OAAK,SAAS,oBAAoB;AAClC,OAAK,eAAe;AACpB,OAAK;AACL,OAAK,OAAO,UAAU;;CAGxB,AAAQ,UAAgB;AAEtB,MAAI,KAAK,aAAa;AACpB,wBAAqB,KAAK;AAC1B,QAAK,cAAc;;AAIrB,MAAI,KAAK,WAAW;AAClB,gBAAa,KAAK;AAClB,QAAK,YAAY;;AAInB,MAAI,KAAK,oBAAoB;AAC3B,iBAAc,KAAK;AACnB,QAAK,qBAAqB;;AAK5B,MAAI,KAAK,aAAa;AACpB,QAAK,YAAY,YAAY,SAAQ,UAAS,MAAM;AACpD,QAAK,cAAc;;AAIrB,MAAI,KAAK,MACP,MAAK,MAAM,YAAY;;;;;;AAY7B,eAAsB,mBAAmB,MAA0C;CAEjF,MAAM,SAAS,SAAS,cAAc;CACtC,MAAM,MAAM,OAAO,WAAW;AAC9B,KAAI,CAAC,IAAK,OAAM,cAAc;CAG9B,MAAM,UAAU,MAAM,IAAI,SAAiB,SAAS,WAAW;EAC7D,MAAM,SAAS,IAAI;AACnB,SAAO,UAAU,MAAM;AACrB,OAAI,EAAE,QAAQ,OACZ,SAAQ,EAAE,OAAO;OAEjB,QAAO,cAAc;;AAGzB,SAAO,gBAAgB,OAAO,cAAc;AAC5C,SAAO,cAAc;;CAIvB,MAAM,MAAM,MAAM,IAAI,SAA2B,SAAS,WAAW;EACnE,MAAM,QAAQ,IAAI;AAClB,QAAM,eAAe,QAAQ;AAC7B,QAAM,gBAAgB,OAAO,cAAc;AAC3C,QAAM,MAAM;;AAId,QAAO,QAAQ,IAAI;AACnB,QAAO,SAAS,IAAI;AACpB,KAAI,UAAU,KAAK,GAAG;CAEtB,MAAM,YAAY,IAAI,aAAa,GAAG,GAAG,OAAO,OAAO,OAAO;CAC9D,MAAM,SAAS,MAAM,oBAAoB;AAEzC,KAAI,CAAC,OACH,OAAM,cAAc;AAGtB,QAAO,uBAAuB;;;;;AAUhC,eAAsB,wBAAoD;AACxE,KAAI;EACF,MAAM,UAAU,MAAM,UAAU,aAAa;AAC7C,SAAO,QAAQ,QAAO,WAAU,OAAO,SAAS;UACzC,OAAO;AACd,UAAQ,MAAM,8BAA8B;AAC5C,QAAM,IAAI,MAAM;;;;;;AAOpB,SAAgB,kBAAkB,QAAkC;CAClE,MAAM,QAAQ,OAAO,MAAM;AAC3B,QAAO,MAAM,SAAS,YACf,MAAM,SAAS,WACf,MAAM,SAAS,aACf,MAAM,SAAS,eACf,MAAM,SAAS;;AAmBxB,eAAe,oBAAoB,WAA8C;CAC/E,MAAM,EAAE,SAAS,SAAS,MAAM,OAAO;CACvC,MAAM,OAAO,KAAK,UAAU,MAAM,UAAU,OAAO,UAAU,QAAQ,EACnE,mBAAmB;AAErB,QAAO,OAAO,KAAK,OAAO;;AAG5B,SAAS,uBAAuB,QAAqC;CACnE,IAAIA;AACJ,KAAI;AACF,eAAa,KAAK,MAAM;SAClB;AACN,MAAI,OAAO,WAAW,QACpB,OAAM,IAAI,MAAM;AAElB,MAAI,OAAO,SAAS,YAClB,OAAM,IAAI,MAAM;AAElB,QAAM,IAAI,MAAM;;AAIlB,gDAA4B;AAC5B,QAAO;;AAGT,SAAS,cAAc,SAAqC;AAC1D,QAAO,IAAIC,sCAAmB,SAASC,0CAAuB,iBAAiB"}

package/dist/cjs/react/src/utils/validation.js

@@ -0,0 +1,160 @@
+
+//#region src/utils/validation.ts
+/** Strict string coercion: returns the value only when it's already a string. */
+function toOptionalString(value) {
+	return typeof value === "string" ? value : "";
+}
+/** Strict string coercion + trimming. */
+function toOptionalTrimmedString(value) {
+	return toOptionalString(value).trim();
+}
+/** String coercion + trimming (useful at IO boundaries). */
+function toTrimmedString(value) {
+	return String(value ?? "").trim();
+}
+/** Remove trailing `/` characters (e.g. base URL normalization). */
+function stripTrailingSlashes(value) {
+	return String(value ?? "").replace(/\/+$/, "");
+}
+/** Ensure a non-empty string starts with `/` (path normalization). */
+function ensureLeadingSlash(value) {
+	const trimmed = String(value ?? "").trim();
+	if (!trimmed) return "";
+	return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+/** Normalize an app base path like `/sdk` (leading slash, no trailing slashes except `/`). */
+function toBasePath(value, fallback = "/sdk") {
+	const base = ensureLeadingSlash(typeof value === "string" ? value : fallback) || ensureLeadingSlash(fallback) || "/";
+	if (base === "/") return "/";
+	return base.replace(/\/+$/, "");
+}
+/**
+* Ensure a key string has the NEAR Ed25519 prefix (`ed25519:`).
+*
+* - Accepts either `ed25519:<base58>` or a bare `<base58>` string.
+* - Canonicalizes `ED25519:` → `ed25519:`.
+* - If a different prefix is present (e.g. `secp256k1:`), returns the input unchanged.
+*/
+function ensureEd25519Prefix(value) {
+	const raw = String(value ?? "").trim();
+	if (!raw) return "";
+	if (/^[a-z0-9_]+:/i.test(raw)) {
+		if (/^ed25519:/i.test(raw)) return `ed25519:${raw.replace(/^ed25519:/i, "")}`;
+		return raw;
+	}
+	return `ed25519:${raw}`;
+}
+/**
+* Validate NEAR account ID format with optional suffix restrictions
+* @param nearAccountId - The account ID to validate
+* @param options - Optional validation constraints
+*/
+function validateNearAccountId(nearAccountId, options = {
+	allowedSuffixes: ["testnet", "near"],
+	requireTopLevelDomain: false
+}) {
+	if (!nearAccountId || typeof nearAccountId !== "string") return {
+		valid: false,
+		error: "Account ID must be a non-empty string"
+	};
+	const parts = nearAccountId.split(".");
+	if (parts.length < 2) return {
+		valid: false,
+		error: "Account ID must contain at least one dot (e.g., username.testnet)"
+	};
+	if (options.requireTopLevelDomain && parts.length !== 2) {
+		const suffixList = options.allowedSuffixes?.join(", ") || "valid suffixes";
+		return {
+			valid: false,
+			error: `Invalid NEAR account ID format. Expected format: <username>.<suffix> where suffix is one of: ${suffixList}`
+		};
+	}
+	const username = parts[0];
+	const suffix = parts[parts.length - 1];
+	const domain = parts.slice(1).join(".");
+	if (!username || username.length === 0) return {
+		valid: false,
+		error: "Username part cannot be empty"
+	};
+	if (!/^[a-z0-9_\-]+$/.test(username)) return {
+		valid: false,
+		error: "Username can only contain lowercase letters, numbers, underscores, and hyphens"
+	};
+	if (!domain || domain.length === 0) return {
+		valid: false,
+		error: "Domain part cannot be empty"
+	};
+	if (options.allowedSuffixes && options.allowedSuffixes.length > 0) {
+		const matchesAnySuffix = options.allowedSuffixes.some((allowedSuffix) => {
+			if (!allowedSuffix.includes(".")) return suffix === allowedSuffix;
+			return nearAccountId.endsWith(`.${allowedSuffix}`);
+		});
+		if (!matchesAnySuffix) return {
+			valid: false,
+			error: `Invalid NEAR account ID suffix. Expected account to end with one of: ${options.allowedSuffixes.join(", ")}`
+		};
+	}
+	return { valid: true };
+}
+function isObject(x) {
+	return x !== null && typeof x === "object";
+}
+function isString(x) {
+	return typeof x === "string";
+}
+function isNumber(x) {
+	return typeof x === "number";
+}
+function isFunction(x) {
+	return typeof x === "function";
+}
+function isBoolean(x) {
+	return typeof x === "boolean";
+}
+function isArray(x) {
+	return Array.isArray(x);
+}
+function assertString(val, name = "value") {
+	if (typeof val !== "string") throw new Error(`Invalid ${name}: expected string`);
+	return val;
+}
+function stripFunctionsShallow(obj) {
+	if (!obj || !isObject(obj)) return void 0;
+	const out = {};
+	for (const [k, v] of Object.entries(obj)) if (!isFunction(v)) out[k] = v;
+	return out;
+}
+function isPlainSignedTransactionLike(x) {
+	if (!isObject(x)) return false;
+	const hasTx = "transaction" in x;
+	const hasSig = "signature" in x;
+	const bytes = x;
+	const hasBytes = Array.isArray(bytes.borsh_bytes) || bytes.borshBytes instanceof Uint8Array;
+	const hasMethod = typeof x.base64Encode === "function";
+	return hasTx && hasSig && hasBytes && !hasMethod;
+}
+function extractBorshBytesFromPlainSignedTx(x) {
+	const asArray = Array.isArray(x.borsh_bytes) ? x.borsh_bytes : void 0;
+	if (asArray) return asArray;
+	const asU8 = x.borshBytes instanceof Uint8Array ? x.borshBytes : void 0;
+	return Array.from(asU8 || new Uint8Array());
+}
+
+//#endregion
+exports.assertString = assertString;
+exports.ensureEd25519Prefix = ensureEd25519Prefix;
+exports.extractBorshBytesFromPlainSignedTx = extractBorshBytesFromPlainSignedTx;
+exports.isArray = isArray;
+exports.isBoolean = isBoolean;
+exports.isFunction = isFunction;
+exports.isNumber = isNumber;
+exports.isObject = isObject;
+exports.isPlainSignedTransactionLike = isPlainSignedTransactionLike;
+exports.isString = isString;
+exports.stripFunctionsShallow = stripFunctionsShallow;
+exports.stripTrailingSlashes = stripTrailingSlashes;
+exports.toBasePath = toBasePath;
+exports.toOptionalTrimmedString = toOptionalTrimmedString;
+exports.toTrimmedString = toTrimmedString;
+exports.validateNearAccountId = validateNearAccountId;
+//# sourceMappingURL=validation.js.map

package/dist/cjs/react/src/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","names":["out: Record<string, unknown>"],"sources":["../../../../../src/utils/validation.ts"],"sourcesContent":["\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\n}\n\n// ==============================\n// Normalization helpers (shared)\n// ==============================\n\n/** Strict string coercion: returns the value only when it's already a string. */\nexport function toOptionalString(value: unknown): string {\n  return typeof value === 'string' ? value : '';\n}\n\n/** Strict string coercion + trimming. */\nexport function toOptionalTrimmedString(value: unknown): string {\n  return toOptionalString(value).trim();\n}\n\n/** String coercion + trimming (useful at IO boundaries). */\nexport function toTrimmedString(value: unknown): string {\n  return String(value ?? '').trim();\n}\n\n/** Remove trailing `/` characters (e.g. base URL normalization). */\nexport function stripTrailingSlashes(value: string): string {\n  return String(value ?? '').replace(/\\/+$/, '');\n}\n\n/** Ensure a non-empty string starts with `/` (path normalization). */\nexport function ensureLeadingSlash(value: string): string {\n  const trimmed = String(value ?? '').trim();\n  if (!trimmed) return '';\n  return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;\n}\n\n/** Normalize an app base path like `/sdk` (leading slash, no trailing slashes except `/`). */\nexport function toBasePath(value?: string, fallback = '/sdk'): string {\n  const base = ensureLeadingSlash(typeof value === 'string' ? value : fallback) || ensureLeadingSlash(fallback) || '/';\n  if (base === '/') return '/';\n  return base.replace(/\\/+$/, '');\n}\n\n/** Best-effort origin normalization (used by CSP/Permissions-Policy helpers). */\nexport function toOriginOrUndefined(input?: string): string | undefined {\n  try {\n    const v = (input || '').trim();\n    if (!v) return undefined;\n    // Next/Caddy/etc. expect an origin, not a path\n    return new URL(v, 'http://dummy').origin === 'http://dummy' ? new URL(v).origin : v;\n  } catch {\n    return input?.trim() || undefined;\n  }\n}\n\n/**\n * Strict origin sanitizer for Related Origin Requests (ROR).\n * - Allows `https://<host>[:port]` and `http://localhost[:port]` only.\n * - Rejects paths (except `/`), queries, and hashes.\n * - Normalizes hostname casing.\n */\nexport function toRorOriginOrNull(value: unknown): string | null {\n  if (typeof value !== 'string') return null;\n  const raw = toTrimmedString(value);\n  if (!raw) return null;\n  try {\n    const u = new URL(raw);\n    const scheme = u.protocol;\n    const host = u.hostname.toLowerCase();\n    const port = u.port ? `:${u.port}` : '';\n    const isHttps = scheme === 'https:';\n    const isLocalhostHttp = scheme === 'http:' && host === 'localhost';\n    if (!isHttps && !isLocalhostHttp) return null;\n    if ((u.pathname && u.pathname !== '/') || u.search || u.hash) return null;\n    return `${scheme}//${host}${port}`;\n  } catch {\n    return null;\n  }\n}\n\n/** Collapse a string into a single line by normalizing whitespace. */\nexport function toSingleLine(value: unknown): string {\n  return String(value ?? '')\n    .replace(/[\\r\\n]+/g, ' ')\n    .replace(/\\s+/g, ' ')\n    .trim();\n}\n\n/**\n * Ensure a key string has the NEAR Ed25519 prefix (`ed25519:`).\n *\n * - Accepts either `ed25519:<base58>` or a bare `<base58>` string.\n * - Canonicalizes `ED25519:` → `ed25519:`.\n * - If a different prefix is present (e.g. `secp256k1:`), returns the input unchanged.\n */\nexport function ensureEd25519Prefix(value: string): string {\n  const raw = String(value ?? '').trim();\n  if (!raw) return '';\n\n  if (/^[a-z0-9_]+:/i.test(raw)) {\n    if (/^ed25519:/i.test(raw)) {\n      return `ed25519:${raw.replace(/^ed25519:/i, '')}`;\n    }\n    return raw;\n  }\n\n  return `ed25519:${raw}`;\n}\n\nexport interface NearAccountValidationOptions {\n  /** Restrict to specific suffixes (e.g., ['testnet', 'near']) */\n  allowedSuffixes?: string[];\n  /** Require Top-level domains with exactly 2 parts (username.suffix) instead of allowing subdomains */\n  requireTopLevelDomain?: boolean;\n}\n\n/**\n * Validate NEAR account ID format with optional suffix restrictions\n * @param nearAccountId - The account ID to validate\n * @param options - Optional validation constraints\n */\nexport function validateNearAccountId(\n  nearAccountId: string,\n  options: NearAccountValidationOptions = {\n    allowedSuffixes: ['testnet', 'near'],\n    requireTopLevelDomain: false\n  }\n): ValidationResult {\n  if (!nearAccountId || typeof nearAccountId !== 'string') {\n    return { valid: false, error: 'Account ID must be a non-empty string' };\n  }\n\n  const parts = nearAccountId.split('.');\n  if (parts.length < 2) {\n    return { valid: false, error: 'Account ID must contain at least one dot (e.g., username.testnet)' };\n  }\n\n  // Check for exact two parts requirement (e.g., server registration)\n  if (options.requireTopLevelDomain && parts.length !== 2) {\n    const suffixList = options.allowedSuffixes?.join(', ') || 'valid suffixes';\n    return {\n      valid: false,\n      error: `Invalid NEAR account ID format. Expected format: <username>.<suffix> where suffix is one of: ${suffixList}`\n    };\n  }\n\n  const username = parts[0];\n  const suffix = parts[parts.length - 1]; // Last part for suffix checking\n  const domain = parts.slice(1).join('.');\n\n  // Validate username part\n  if (!username || username.length === 0) {\n    return { valid: false, error: 'Username part cannot be empty' };\n  }\n\n  if (!/^[a-z0-9_\\-]+$/.test(username)) {\n    return { valid: false, error: 'Username can only contain lowercase letters, numbers, underscores, and hyphens' };\n  }\n\n  // Validate domain part\n  if (!domain || domain.length === 0) {\n    return { valid: false, error: 'Domain part cannot be empty' };\n  }\n\n  // Check allowed suffixes if specified\n  if (options.allowedSuffixes && options.allowedSuffixes.length > 0) {\n    // Check if the account ID ends with any of the allowed suffixes\n    const matchesAnySuffix = options.allowedSuffixes.some(allowedSuffix => {\n      // For single-part suffixes, check the last part\n      if (!allowedSuffix.includes('.')) {\n        return suffix === allowedSuffix;\n      }\n      // For multi-part suffixes, check if the account ID ends with the full suffix\n      return nearAccountId.endsWith(`.${allowedSuffix}`);\n    });\n\n    if (!matchesAnySuffix) {\n      return {\n        valid: false,\n        error: `Invalid NEAR account ID suffix. Expected account to end with one of: ${options.allowedSuffixes.join(', ')}`\n      };\n    }\n  }\n\n  return { valid: true };\n}\n\n/**\n * Lightweight NEAR account ID validation used by server-side helpers.\n * - length: 2..64\n * - chars: lowercase letters, digits, `_`, `.`, `-`\n */\nexport function isValidAccountId(accountId: unknown): accountId is string {\n  if (typeof accountId !== 'string') return false;\n  if (!accountId || accountId.length < 2 || accountId.length > 64) return false;\n  return /^[a-z0-9_.-]+$/.test(accountId);\n}\n\n// ===========================\n// Runtime validation helpers\n// ===========================\n\nexport function isObject(x: unknown): x is Record<string, unknown> {\n  return x !== null && typeof x === 'object';\n}\n\nexport function isString(x: unknown): x is string {\n  return typeof x === 'string';\n}\n\nexport function isNonEmptyString(x: unknown): x is string {\n  return typeof x === 'string' && x.length > 0;\n}\n\nexport function isNumber(x: unknown): x is number {\n  return typeof x === 'number';\n}\n\nexport function isFiniteNumber(x: unknown): x is number {\n  return typeof x === 'number' && Number.isFinite(x);\n}\n\nexport function isFunction(x: unknown): x is Function {\n  return typeof x === 'function';\n}\n\nexport function isBoolean(x: unknown): x is boolean {\n  return typeof x === 'boolean';\n}\n\nexport function isArray<T = unknown>(x: unknown): x is T[] {\n  return Array.isArray(x);\n}\n\nexport function assertString(val: unknown, name = 'value'): string {\n  if (typeof val !== 'string') throw new Error(`Invalid ${name}: expected string`);\n  return val;\n}\n\nexport function assertNumber(val: unknown, name = 'value'): number {\n  if (typeof val !== 'number' || !Number.isFinite(val)) throw new Error(`Invalid ${name}: expected finite number`);\n  return val;\n}\n\nexport function assertBoolean(val: unknown, name = 'value'): boolean {\n  if (typeof val !== 'boolean') throw new Error(`Invalid ${name}: expected boolean`);\n  return val;\n}\n\nexport function assertObject<T extends Record<string, unknown> = Record<string, unknown>>(val: unknown, name = 'value'): T {\n  if (!isObject(val)) throw new Error(`Invalid ${name}: expected object`);\n  return val as T;\n}\n\nexport function assertArray<T = unknown>(val: unknown, name = 'value'): T[] {\n  if (!Array.isArray(val)) throw new Error(`Invalid ${name}: expected array`);\n  return val as T[];\n}\n\nexport function stripFunctionsShallow<T extends Record<string, unknown>>(obj?: T): Partial<T> | undefined {\n  if (!obj || !isObject(obj)) return undefined;\n  const out: Record<string, unknown> = {};\n  for (const [k, v] of Object.entries(obj)) {\n    if (!isFunction(v)) out[k] = v as unknown;\n  }\n  return out as Partial<T>;\n}\n\nexport interface PlainSignedTransactionLike {\n  transaction: unknown;\n  signature: unknown;\n  borsh_bytes?: unknown;\n  borshBytes?: unknown;\n  base64Encode?: unknown;\n}\n\nexport function isPlainSignedTransactionLike(x: unknown): x is PlainSignedTransactionLike {\n  if (!isObject(x)) return false;\n  const hasTx = 'transaction' in x;\n  const hasSig = 'signature' in x;\n  const bytes = x as { borsh_bytes?: unknown; borshBytes?: unknown };\n  const hasBytes = Array.isArray(bytes.borsh_bytes) || bytes.borshBytes instanceof Uint8Array;\n  const hasMethod = typeof (x as { base64Encode?: unknown }).base64Encode === 'function';\n  return hasTx && hasSig && hasBytes && !hasMethod;\n}\n\nexport function extractBorshBytesFromPlainSignedTx(x: PlainSignedTransactionLike): number[] {\n  const asArray = Array.isArray(x.borsh_bytes) ? (x.borsh_bytes as number[]) : undefined;\n  if (asArray) return asArray;\n  const asU8 = (x.borshBytes instanceof Uint8Array) ? x.borshBytes : undefined;\n  return Array.from(asU8 || new Uint8Array());\n}\n"],"mappings":"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"}

package/dist/cjs/react/utils/walletIframe.js

@@ -1,4 +1,3 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.js');
 
 //#region src/react/utils/walletIframe.ts
 /**

package/dist/cjs/react/utils/walletIframe.js.map

@@ -1 +1 @@
-{"version":3,"file":"walletIframe.js","names":["offMgr: (() => void) | undefined","offCli: (() => void) | undefined"],"sources":["../../../../src/react/utils/walletIframe.ts"],"sourcesContent":["// Utilities for coordinating with the wallet iframe (TatchiPasskeyIframe)\nimport type { WalletIframeRouter } from '@/core/WalletIframe/client/router';\nimport type { TatchiPasskey } from '@/core/TatchiPasskey';\n\n// Minimal shape for a manager that can initialize and expose a wallet iframe client\n// Matches the surface provided by TatchiPasskey when iframe mode is configured\nexport interface WalletIframeCapableManagerLike {\n  initWalletIframe?: (nearAccountId?: string) => Promise<void>;\n  getWalletIframeClient?: () => WalletIframeRouter | null | undefined;\n  // Some managers (e.g., TatchiPasskeyIframe) expose readiness hooks directly\n  isReady?: () => boolean;\n  onReady?: (cb: () => void) => () => void;\n}\n\n/**\n * Await wallet iframe readiness when using TatchiPasskeyIframe.\n * - If the passed manager is not iframe-capable, resolves immediately (returns false).\n * - If iframe is already ready, resolves immediately (returns true).\n * - Otherwise waits for onReady/polling up to timeoutMs, then resolves (returns whether it became ready).\n */\nexport async function awaitWalletIframeReady(\n  manager: TatchiPasskey,\n  opts?: { timeoutMs?: number }\n): Promise<boolean> {\n  const timeoutMs = Math.max(500, Math.min(15_000, opts?.timeoutMs ?? 4000));\n\n  if (!manager || (typeof manager !== 'object' && typeof manager !== 'function')) return false;\n\n  const getClient = (): WalletIframeRouter | null => {\n    try {\n      const c = manager.getWalletIframeClient?.();\n      return c || null;\n    } catch {}\n    return null;\n  };\n\n  const isReadyNow = (): boolean => {\n    try {\n      const c = getClient();\n      if (c && typeof c.isReady === 'function' && c.isReady()) return true;\n    } catch {}\n    return false;\n  };\n\n  // Only wait if the manager looks iframe-capable\n  const iframeCapable = typeof manager.initWalletIframe === 'function' || typeof manager.getWalletIframeClient === 'function';\n  if (!iframeCapable) return false;\n\n  // Kick init (idempotent in implementations)\n  try { if (typeof manager.initWalletIframe === 'function') await manager.initWalletIframe(); } catch {}\n\n  if (isReadyNow()) return true;\n\n  return await new Promise<boolean>((resolve) => {\n    let done = false;\n    const finish = (ok: boolean) => {\n      if (done) return; done = true;\n      try { offMgr?.(); } catch {}\n      try { offCli?.(); } catch {}\n      try { clearTimeout(timer); } catch {}\n      resolve(ok);\n    };\n\n    // Subscribe to onReady hooks if available\n    let offMgr: (() => void) | undefined;\n    let offCli: (() => void) | undefined;\n    try {\n      const c = getClient();\n      if (c && typeof c.onReady === 'function') {\n        offCli = c.onReady(() => finish(true));\n      }\n    } catch {}\n\n    // Poll and keep nudging init as a backup\n    const start = Date.now();\n    const poll = async () => {\n      if (done) return;\n      if (isReadyNow()) { finish(true); return; }\n      if (Date.now() - start >= timeoutMs) { finish(false); return; }\n      // Nudge init (no-op if already initialized)\n      try { if (typeof manager.initWalletIframe === 'function') await manager.initWalletIframe(); } catch {}\n      setTimeout(poll, 100);\n    };\n    poll();\n\n    const timer = setTimeout(() => finish(false), timeoutMs + 50) as unknown as number;\n  });\n}\n"],"mappings":";;;;;;;;;AAoBA,eAAsB,uBACpB,SACA,MACkB;CAClB,MAAM,YAAY,KAAK,IAAI,KAAK,KAAK,IAAI,MAAQ,MAAM,aAAa;AAEpE,KAAI,CAAC,WAAY,OAAO,YAAY,YAAY,OAAO,YAAY,WAAa,QAAO;CAEvF,MAAM,kBAA6C;AACjD,MAAI;GACF,MAAM,IAAI,QAAQ;AAClB,UAAO,KAAK;UACN;AACR,SAAO;;CAGT,MAAM,mBAA4B;AAChC,MAAI;GACF,MAAM,IAAI;AACV,OAAI,KAAK,OAAO,EAAE,YAAY,cAAc,EAAE,UAAW,QAAO;UAC1D;AACR,SAAO;;CAIT,MAAM,gBAAgB,OAAO,QAAQ,qBAAqB,cAAc,OAAO,QAAQ,0BAA0B;AACjH,KAAI,CAAC,cAAe,QAAO;AAG3B,KAAI;AAAE,MAAI,OAAO,QAAQ,qBAAqB,WAAY,OAAM,QAAQ;SAA4B;AAEpG,KAAI,aAAc,QAAO;AAEzB,QAAO,MAAM,IAAI,SAAkB,YAAY;EAC7C,IAAI,OAAO;EACX,MAAM,UAAU,OAAgB;AAC9B,OAAI,KAAM;AAAQ,UAAO;AACzB,OAAI;AAAE;WAAoB;AAC1B,OAAI;AAAE;WAAoB;AAC1B,OAAI;AAAE,iBAAa;WAAgB;AACnC,WAAQ;;EAIV,IAAIA;EACJ,IAAIC;AACJ,MAAI;GACF,MAAM,IAAI;AACV,OAAI,KAAK,OAAO,EAAE,YAAY,WAC5B,UAAS,EAAE,cAAc,OAAO;UAE5B;EAGR,MAAM,QAAQ,KAAK;EACnB,MAAM,OAAO,YAAY;AACvB,OAAI,KAAM;AACV,OAAI,cAAc;AAAE,WAAO;AAAO;;AAClC,OAAI,KAAK,QAAQ,SAAS,WAAW;AAAE,WAAO;AAAQ;;AAEtD,OAAI;AAAE,QAAI,OAAO,QAAQ,qBAAqB,WAAY,OAAM,QAAQ;WAA4B;AACpG,cAAW,MAAM;;AAEnB;EAEA,MAAM,QAAQ,iBAAiB,OAAO,QAAQ,YAAY"}
+{"version":3,"file":"walletIframe.js","names":["offMgr: (() => void) | undefined","offCli: (() => void) | undefined"],"sources":["../../../../src/react/utils/walletIframe.ts"],"sourcesContent":["// Utilities for coordinating with the wallet iframe (TatchiPasskeyIframe)\nimport type { WalletIframeRouter } from '@/core/WalletIframe/client/router';\nimport type { TatchiPasskey } from '@/core/TatchiPasskey';\n\n// Minimal shape for a manager that can initialize and expose a wallet iframe client\n// Matches the surface provided by TatchiPasskey when iframe mode is configured\nexport interface WalletIframeCapableManagerLike {\n  initWalletIframe?: (nearAccountId?: string) => Promise<void>;\n  getWalletIframeClient?: () => WalletIframeRouter | null | undefined;\n  // Some managers (e.g., TatchiPasskeyIframe) expose readiness hooks directly\n  isReady?: () => boolean;\n  onReady?: (cb: () => void) => () => void;\n}\n\n/**\n * Await wallet iframe readiness when using TatchiPasskeyIframe.\n * - If the passed manager is not iframe-capable, resolves immediately (returns false).\n * - If iframe is already ready, resolves immediately (returns true).\n * - Otherwise waits for onReady/polling up to timeoutMs, then resolves (returns whether it became ready).\n */\nexport async function awaitWalletIframeReady(\n  manager: TatchiPasskey,\n  opts?: { timeoutMs?: number }\n): Promise<boolean> {\n  const timeoutMs = Math.max(500, Math.min(15_000, opts?.timeoutMs ?? 4000));\n\n  if (!manager || (typeof manager !== 'object' && typeof manager !== 'function')) return false;\n\n  const getClient = (): WalletIframeRouter | null => {\n    try {\n      const c = manager.getWalletIframeClient?.();\n      return c || null;\n    } catch {}\n    return null;\n  };\n\n  const isReadyNow = (): boolean => {\n    try {\n      const c = getClient();\n      if (c && typeof c.isReady === 'function' && c.isReady()) return true;\n    } catch {}\n    return false;\n  };\n\n  // Only wait if the manager looks iframe-capable\n  const iframeCapable = typeof manager.initWalletIframe === 'function' || typeof manager.getWalletIframeClient === 'function';\n  if (!iframeCapable) return false;\n\n  // Kick init (idempotent in implementations)\n  try { if (typeof manager.initWalletIframe === 'function') await manager.initWalletIframe(); } catch {}\n\n  if (isReadyNow()) return true;\n\n  return await new Promise<boolean>((resolve) => {\n    let done = false;\n    const finish = (ok: boolean) => {\n      if (done) return; done = true;\n      try { offMgr?.(); } catch {}\n      try { offCli?.(); } catch {}\n      try { clearTimeout(timer); } catch {}\n      resolve(ok);\n    };\n\n    // Subscribe to onReady hooks if available\n    let offMgr: (() => void) | undefined;\n    let offCli: (() => void) | undefined;\n    try {\n      const c = getClient();\n      if (c && typeof c.onReady === 'function') {\n        offCli = c.onReady(() => finish(true));\n      }\n    } catch {}\n\n    // Poll and keep nudging init as a backup\n    const start = Date.now();\n    const poll = async () => {\n      if (done) return;\n      if (isReadyNow()) { finish(true); return; }\n      if (Date.now() - start >= timeoutMs) { finish(false); return; }\n      // Nudge init (no-op if already initialized)\n      try { if (typeof manager.initWalletIframe === 'function') await manager.initWalletIframe(); } catch {}\n      setTimeout(poll, 100);\n    };\n    poll();\n\n    const timer = setTimeout(() => finish(false), timeoutMs + 50) as unknown as number;\n  });\n}\n"],"mappings":";;;;;;;;AAoBA,eAAsB,uBACpB,SACA,MACkB;CAClB,MAAM,YAAY,KAAK,IAAI,KAAK,KAAK,IAAI,MAAQ,MAAM,aAAa;AAEpE,KAAI,CAAC,WAAY,OAAO,YAAY,YAAY,OAAO,YAAY,WAAa,QAAO;CAEvF,MAAM,kBAA6C;AACjD,MAAI;GACF,MAAM,IAAI,QAAQ;AAClB,UAAO,KAAK;UACN;AACR,SAAO;;CAGT,MAAM,mBAA4B;AAChC,MAAI;GACF,MAAM,IAAI;AACV,OAAI,KAAK,OAAO,EAAE,YAAY,cAAc,EAAE,UAAW,QAAO;UAC1D;AACR,SAAO;;CAIT,MAAM,gBAAgB,OAAO,QAAQ,qBAAqB,cAAc,OAAO,QAAQ,0BAA0B;AACjH,KAAI,CAAC,cAAe,QAAO;AAG3B,KAAI;AAAE,MAAI,OAAO,QAAQ,qBAAqB,WAAY,OAAM,QAAQ;SAA4B;AAEpG,KAAI,aAAc,QAAO;AAEzB,QAAO,MAAM,IAAI,SAAkB,YAAY;EAC7C,IAAI,OAAO;EACX,MAAM,UAAU,OAAgB;AAC9B,OAAI,KAAM;AAAQ,UAAO;AACzB,OAAI;AAAE;WAAoB;AAC1B,OAAI;AAAE;WAAoB;AAC1B,OAAI;AAAE,iBAAa;WAAgB;AACnC,WAAQ;;EAIV,IAAIA;EACJ,IAAIC;AACJ,MAAI;GACF,MAAM,IAAI;AACV,OAAI,KAAK,OAAO,EAAE,YAAY,WAC5B,UAAS,EAAE,cAAc,OAAO;UAE5B;EAGR,MAAM,QAAQ,KAAK;EACnB,MAAM,OAAO,YAAY;AACvB,OAAI,KAAM;AACV,OAAI,cAAc;AAAE,WAAO;AAAO;;AAClC,OAAI,KAAK,QAAQ,SAAS,WAAW;AAAE,WAAO;AAAQ;;AAEtD,OAAI;AAAE,QAAI,OAAO,QAAQ,qBAAqB,WAAY,OAAM,QAAQ;WAA4B;AACpG,cAAW,MAAM;;AAEnB;EAEA,MAAM,QAAQ,iBAAiB,OAAO,QAAQ,YAAY"}