@tatchi-xyz/sdk 0.20.0 → 0.31.0

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

@@ -1,320 +0,0 @@
-const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
-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/sdk/src/utils/qrScanner.js.map

@@ -1 +0,0 @@
-{"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":"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"}

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

@@ -1,67 +0,0 @@
-const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.js');
-
-//#region src/utils/validation.ts
-/**
-* 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 };
-}
-var init_validation = require_rolldown_runtime.__esm({ "src/utils/validation.ts": (() => {}) });
-
-//#endregion
-init_validation();
-Object.defineProperty(exports, 'init_validation', {
-  enumerable: true,
-  get: function () {
-    return init_validation;
-  }
-});
-exports.validateNearAccountId = validateNearAccountId;
-//# sourceMappingURL=validation.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../../../../../src/utils/validation.ts"],"sourcesContent":["\nexport interface ValidationResult {\n  valid: boolean;\n  error?: string;\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"],"mappings":";;;;;;;;AAkBA,SAAgB,sBACd,eACA,UAAwC;CACtC,iBAAiB,CAAC,WAAW;CAC7B,uBAAuB;GAEP;AAClB,KAAI,CAAC,iBAAiB,OAAO,kBAAkB,SAC7C,QAAO;EAAE,OAAO;EAAO,OAAO;;CAGhC,MAAM,QAAQ,cAAc,MAAM;AAClC,KAAI,MAAM,SAAS,EACjB,QAAO;EAAE,OAAO;EAAO,OAAO;;AAIhC,KAAI,QAAQ,yBAAyB,MAAM,WAAW,GAAG;EACvD,MAAM,aAAa,QAAQ,iBAAiB,KAAK,SAAS;AAC1D,SAAO;GACL,OAAO;GACP,OAAO,gGAAgG;;;CAI3G,MAAM,WAAW,MAAM;CACvB,MAAM,SAAS,MAAM,MAAM,SAAS;CACpC,MAAM,SAAS,MAAM,MAAM,GAAG,KAAK;AAGnC,KAAI,CAAC,YAAY,SAAS,WAAW,EACnC,QAAO;EAAE,OAAO;EAAO,OAAO;;AAGhC,KAAI,CAAC,iBAAiB,KAAK,UACzB,QAAO;EAAE,OAAO;EAAO,OAAO;;AAIhC,KAAI,CAAC,UAAU,OAAO,WAAW,EAC/B,QAAO;EAAE,OAAO;EAAO,OAAO;;AAIhC,KAAI,QAAQ,mBAAmB,QAAQ,gBAAgB,SAAS,GAAG;EAEjE,MAAM,mBAAmB,QAAQ,gBAAgB,MAAK,kBAAiB;AAErE,OAAI,CAAC,cAAc,SAAS,KAC1B,QAAO,WAAW;AAGpB,UAAO,cAAc,SAAS,IAAI;;AAGpC,MAAI,CAAC,iBACH,QAAO;GACL,OAAO;GACP,OAAO,wEAAwE,QAAQ,gBAAgB,KAAK;;;AAKlH,QAAO,EAAE,OAAO"}

package/dist/cjs/server/sdk/src/core/WalletIframe/validation.js

@@ -1,17 +0,0 @@
-
-//#region src/core/WalletIframe/validation.ts
-function isObject(x) {
-	return x !== null && typeof x === "object";
-}
-function isString(x) {
-	return typeof x === "string";
-}
-function isFunction(x) {
-	return typeof x === "function";
-}
-
-//#endregion
-exports.isFunction = isFunction;
-exports.isObject = isObject;
-exports.isString = isString;
-//# sourceMappingURL=validation.js.map

package/dist/cjs/server/sdk/src/core/WalletIframe/validation.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.js","names":[],"sources":["../../../../../../../src/core/WalletIframe/validation.ts"],"sourcesContent":["// Shared runtime validation helpers for Wallet Iframe code.\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\n// ========= Assertions (throw on mismatch) =========\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\n// Shallowly remove function-valued properties (postMessage/clone safety)\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\n// ===============================\n// SignedTransaction shape helpers\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":";;AAEA,SAAgB,SAAS,GAA0C;AACjE,QAAO,MAAM,QAAQ,OAAO,MAAM;;AAGpC,SAAgB,SAAS,GAAyB;AAChD,QAAO,OAAO,MAAM;;AAetB,SAAgB,WAAW,GAA2B;AACpD,QAAO,OAAO,MAAM"}

package/dist/cjs/utils/encoders.js

@@ -1,18 +0,0 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.js');
-const require_base64 = require('./base64.js');
-const require_base58 = require('./base58.js');
-
-//#region src/utils/encoders.ts
-var init_encoders = require_rolldown_runtime.__esm({ "src/utils/encoders.ts": (() => {
-	require_base64.init_base64();
-}) });
-
-//#endregion
-init_encoders();
-Object.defineProperty(exports, 'init_encoders', {
-  enumerable: true,
-  get: function () {
-    return init_encoders;
-  }
-});
-//# sourceMappingURL=encoders.js.map

package/dist/cjs/utils/encoders.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"encoders.js","names":[],"sources":["../../../src/utils/encoders.ts"],"sourcesContent":["export {\n  base64Encode,\n  base64Decode,\n  base64UrlEncode,\n  base64UrlDecode\n} from './base64';\n\nexport {\n  base58Decode,\n  base58Encode\n} from './base58'\n"],"mappings":""}

package/dist/cjs/utils/index.js

@@ -1,25 +0,0 @@
-const require_rolldown_runtime = require('../_virtual/rolldown_runtime.js');
-const require_validation = require('./validation.js');
-const require_base64 = require('./base64.js');
-const require_base58 = require('./base58.js');
-const require_encoders = require('./encoders.js');
-const require_errors = require('./errors.js');
-const require_deviceDetection = require('../react/deviceDetection.js');
-
-//#region src/utils/index.ts
-var init_utils = require_rolldown_runtime.__esm({ "src/utils/index.ts": (() => {
-	init_encoders();
-	init_validation();
-	init_errors();
-	init_deviceDetection();
-}) });
-
-//#endregion
-init_utils();
-Object.defineProperty(exports, 'init_utils', {
-  enumerable: true,
-  get: function () {
-    return init_utils;
-  }
-});
-//# sourceMappingURL=index.js.map

package/dist/cjs/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/utils/index.ts"],"sourcesContent":["export * from './encoders';\nexport * from './validation';\nexport * from './errors';\nexport * from '../react/deviceDetection';\n\n\n\n"],"mappings":""}

package/dist/esm/_virtual/rolldown_runtime.js

@@ -1,28 +0,0 @@
-//#region rolldown:runtime
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __esm = (fn, res) => function() {
-	return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
-};
-var __export = (target, all) => {
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-//#endregion
-export { __esm, __export, __toCommonJS };