@docknetwork/wallet-sdk-core 1.5.14 → 1.7.6

package/lib/qr-handlers/builtin/oid4vc-handler.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OID4VCHandler = void 0;
+exports.createOID4VCHandler = createOID4VCHandler;
+/**
+ * Built-in handler for OID4VC (OpenID for Verifiable Credentials) URIs
+ *
+ * This is a generic handler that can be configured with app-specific callbacks
+ * for importing credentials. The handler itself only handles protocol detection
+ * and delegates the actual import logic to the configured callback.
+ *
+ * ## Example Usage
+ *
+ * ```typescript
+ * import { OID4VCHandler } from '@docknetwork/wallet-sdk-core/lib/qr-handlers/builtin';
+ * import { getCredentialProvider } from '@docknetwork/wallet-sdk-react-native';
+ *
+ * const handler = new OID4VCHandler({
+ *   onImportCredential: async (uri, context) => {
+ *     try {
+ *       // Use SDK to import credential
+ *       await getCredentialProvider().importCredentialFromURI({
+ *         uri,
+ *         didProvider: getDIDProvider(),
+ *         getAuthCode: async (authUrl) => {
+ *           // App-specific auth handling
+ *           return await showAuthWebView(authUrl);
+ *         },
+ *       });
+ *
+ *       return { success: true };
+ *     } catch (error) {
+ *       return {
+ *         success: false,
+ *         error: error instanceof Error ? error : new Error(String(error)),
+ *       };
+ *     }
+ *   },
+ * });
+ *
+ * processor.registerHandler(handler);
+ * ```
+ *
+ * ## Handler Priority
+ *
+ * Default priority: 5 (very high)
+ * This ensures OID4VC URIs are checked before other credential handlers.
+ *
+ * @category Built-in Handlers
+ */
+class OID4VCHandler {
+    id = 'oid4vc';
+    priority;
+    uriPrefixes;
+    onImportCredential;
+    constructor(config) {
+        if (!config.onImportCredential) {
+            throw new Error('onImportCredential callback is required');
+        }
+        this.priority = config.priority ?? 5;
+        this.uriPrefixes = config.uriPrefixes ?? ['openid-credential-offer://'];
+        this.onImportCredential = config.onImportCredential;
+    }
+    /**
+     * Check if this is an OID4VC URI
+     *
+     * Matches URIs that start with any of the configured prefixes.
+     * By default, matches: openid-credential-offer://
+     *
+     * @param context - The QR code context
+     * @returns True if this handler can process the URI
+     */
+    canHandle(context) {
+        return this.uriPrefixes.some(prefix => context.data.startsWith(prefix));
+    }
+    /**
+     * Process the OID4VC credential offer URI
+     *
+     * Delegates to the configured onImportCredential callback for actual processing.
+     * This allows apps to implement their own navigation, UI, and error handling.
+     *
+     * @param context - The QR code context
+     * @returns Result of the processing
+     */
+    async handle(context) {
+        try {
+            const result = await this.onImportCredential(context.data, context);
+            return {
+                success: result.success,
+                data: result.credential,
+                error: result.error,
+                metadata: {
+                    type: 'oid4vc',
+                    uri: context.data,
+                    ...result.metadata,
+                },
+            };
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            return {
+                success: false,
+                error: err,
+                metadata: {
+                    type: 'oid4vc',
+                    uri: context.data,
+                },
+            };
+        }
+    }
+}
+exports.OID4VCHandler = OID4VCHandler;
+/**
+ * Create an OID4VC handler with custom configuration
+ *
+ * This is a convenience factory function for creating an OID4VC handler.
+ *
+ * @param config - Handler configuration
+ * @returns Configured OID4VC handler
+ *
+ * @example
+ * ```typescript
+ * const handler = createOID4VCHandler({
+ *   onImportCredential: async (uri) => {
+ *     // Your import logic
+ *     return { success: true };
+ *   },
+ * });
+ * ```
+ */
+function createOID4VCHandler(config) {
+    return new OID4VCHandler(config);
+}
+//# sourceMappingURL=oid4vc-handler.js.map

package/lib/qr-handlers/builtin/oid4vc-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oid4vc-handler.js","sourceRoot":"","sources":["../../../src/qr-handlers/builtin/oid4vc-handler.ts"],"names":[],"mappings":";;;AAiMA,kDAIC;AA1ID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,MAAa,aAAa;IACxB,EAAE,GAAG,QAAQ,CAAC;IACd,QAAQ,CAAS;IAET,WAAW,CAAW;IACtB,kBAAkB,CAGO;IAEjC,YAAY,MAA2B;QACrC,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACxE,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;IACtD,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,OAAsB;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,OAAsB;QACjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAEpE,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,UAAU;gBACvB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,GAAG,EAAE,OAAO,CAAC,IAAI;oBACjB,GAAG,MAAM,CAAC,QAAQ;iBACnB;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,GAAG,EAAE,OAAO,CAAC,IAAI;iBAClB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AApED,sCAoEC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,mBAAmB,CACjC,MAA2B;IAE3B,OAAO,IAAI,aAAa,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC"}

package/lib/qr-handlers/index.d.ts

@@ -0,0 +1,76 @@
+/**
+ * QR Code Handler System
+ *
+ * This module provides a generic, extensible system for processing QR codes
+ * in decentralized identity wallet applications.
+ *
+ * ## Overview
+ *
+ * The QR handler system is built around these core concepts:
+ *
+ * - **QRCodeContext**: Contains parsed QR data (raw string, JSON, URLs)
+ * - **QRCodeHandler**: Interface for implementing specific QR code processors
+ * - **QRCodeProcessor**: Manages handler registration and execution
+ * - **ProcessOptions**: Configuration for how QR codes are processed
+ *
+ * ## Basic Usage
+ *
+ * ```typescript
+ * import { createQRCodeProcessor } from '@docknetwork/wallet-sdk-core';
+ *
+ * // Create processor
+ * const processor = createQRCodeProcessor();
+ *
+ * // Register handlers
+ * processor.registerHandler({
+ *   id: 'my-handler',
+ *   priority: 10,
+ *   canHandle: (context) => context.data.startsWith('myprotocol://'),
+ *   handle: async (context) => {
+ *     // Process the QR code
+ *     return { success: true };
+ *   }
+ * });
+ *
+ * // Process QR code
+ * const result = await processor.process(scannedData);
+ * ```
+ *
+ * ## Custom Handlers
+ *
+ * Handlers can be implemented as classes or objects:
+ *
+ * ```typescript
+ * class MyCustomHandler implements QRCodeHandler {
+ *   id = 'my-custom-handler';
+ *   priority = 20;
+ *
+ *   canHandle(context: QRCodeContext): boolean {
+ *     return context.jsonData?.type === 'my-type';
+ *   }
+ *
+ *   async handle(context: QRCodeContext): Promise<QRCodeHandlerResult> {
+ *     // Your processing logic
+ *     return { success: true, data: processedData };
+ *   }
+ * }
+ *
+ * processor.registerHandler(new MyCustomHandler());
+ * ```
+ *
+ * ## Built-in Handlers
+ *
+ * The SDK provides built-in handlers for common protocols:
+ * - OID4VC (OpenID for Verifiable Credentials)
+ * - OID4VP (OpenID for Verifiable Presentations)
+ * - DIDComm (Decentralized Identity Communication)
+ *
+ * These handlers are available in separate modules and can be imported
+ * and registered as needed.
+ *
+ * @module qr-handlers
+ */
+export * from './types';
+export * from './processor';
+export * from './builtin';
+//# sourceMappingURL=index.d.ts.map

package/lib/qr-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/qr-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/lib/qr-handlers/index.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * QR Code Handler System
+ *
+ * This module provides a generic, extensible system for processing QR codes
+ * in decentralized identity wallet applications.
+ *
+ * ## Overview
+ *
+ * The QR handler system is built around these core concepts:
+ *
+ * - **QRCodeContext**: Contains parsed QR data (raw string, JSON, URLs)
+ * - **QRCodeHandler**: Interface for implementing specific QR code processors
+ * - **QRCodeProcessor**: Manages handler registration and execution
+ * - **ProcessOptions**: Configuration for how QR codes are processed
+ *
+ * ## Basic Usage
+ *
+ * ```typescript
+ * import { createQRCodeProcessor } from '@docknetwork/wallet-sdk-core';
+ *
+ * // Create processor
+ * const processor = createQRCodeProcessor();
+ *
+ * // Register handlers
+ * processor.registerHandler({
+ *   id: 'my-handler',
+ *   priority: 10,
+ *   canHandle: (context) => context.data.startsWith('myprotocol://'),
+ *   handle: async (context) => {
+ *     // Process the QR code
+ *     return { success: true };
+ *   }
+ * });
+ *
+ * // Process QR code
+ * const result = await processor.process(scannedData);
+ * ```
+ *
+ * ## Custom Handlers
+ *
+ * Handlers can be implemented as classes or objects:
+ *
+ * ```typescript
+ * class MyCustomHandler implements QRCodeHandler {
+ *   id = 'my-custom-handler';
+ *   priority = 20;
+ *
+ *   canHandle(context: QRCodeContext): boolean {
+ *     return context.jsonData?.type === 'my-type';
+ *   }
+ *
+ *   async handle(context: QRCodeContext): Promise<QRCodeHandlerResult> {
+ *     // Your processing logic
+ *     return { success: true, data: processedData };
+ *   }
+ * }
+ *
+ * processor.registerHandler(new MyCustomHandler());
+ * ```
+ *
+ * ## Built-in Handlers
+ *
+ * The SDK provides built-in handlers for common protocols:
+ * - OID4VC (OpenID for Verifiable Credentials)
+ * - OID4VP (OpenID for Verifiable Presentations)
+ * - DIDComm (Decentralized Identity Communication)
+ *
+ * These handlers are available in separate modules and can be imported
+ * and registered as needed.
+ *
+ * @module qr-handlers
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./processor"), exports);
+__exportStar(require("./builtin"), exports);
+//# sourceMappingURL=index.js.map

package/lib/qr-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/qr-handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,8CAA4B;AAC5B,4CAA0B"}

package/lib/qr-handlers/processor.d.ts

@@ -0,0 +1,110 @@
+import { QRCodeHandler, QRCodeHandlerResult, QRCodeProcessor, ProcessOptions } from './types';
+/**
+ * Default implementation of QRCodeProcessor
+ *
+ * This processor manages a registry of QR code handlers and executes them
+ * in priority order to process scanned QR codes. It provides a flexible,
+ * extensible system for handling various types of QR codes in a wallet application.
+ *
+ * @example
+ * ```typescript
+ * const processor = new DefaultQRCodeProcessor();
+ *
+ * // Register handlers
+ * processor.registerHandler(new OID4VCHandler());
+ * processor.registerHandler(new CredentialHandler());
+ *
+ * // Process QR code
+ * const result = await processor.process(scannedData);
+ * if (result.success) {
+ *   console.log('QR code processed:', result.data);
+ * } else {
+ *   console.error('Failed to process QR code:', result.error);
+ * }
+ * ```
+ */
+export declare class DefaultQRCodeProcessor implements QRCodeProcessor {
+    private handlers;
+    /**
+     * Register a new QR code handler
+     *
+     * @param handler - The handler to register
+     * @throws Error if a handler with the same ID is already registered
+     */
+    registerHandler(handler: QRCodeHandler): void;
+    /**
+     * Unregister a QR code handler by its ID
+     *
+     * @param id - The ID of the handler to unregister
+     * @returns True if the handler was found and removed, false otherwise
+     */
+    unregisterHandler(id: string): boolean;
+    /**
+     * Get all registered handlers sorted by priority
+     *
+     * @returns Array of registered handlers sorted by priority (lowest first)
+     */
+    getHandlers(): QRCodeHandler[];
+    /**
+     * Get a specific handler by its ID
+     *
+     * @param id - The ID of the handler to retrieve
+     * @returns The handler if found, undefined otherwise
+     */
+    getHandler(id: string): QRCodeHandler | undefined;
+    /**
+     * Clear all registered handlers
+     */
+    clearHandlers(): void;
+    /**
+     * Process QR code data through registered handlers
+     *
+     * This method:
+     * 1. Prepares the context from raw QR data
+     * 2. Executes handlers in priority order
+     * 3. Returns the first successful result (or continues if stopOnFirstSuccess is false)
+     * 4. Returns an error result if no handler can process the data
+     *
+     * @param data - Raw QR code data string
+     * @param options - Processing options
+     * @returns Result of the processing
+     */
+    process(data: string, options?: ProcessOptions): Promise<QRCodeHandlerResult>;
+    /**
+     * Default context preparation function
+     *
+     * This method attempts to parse the raw QR data as JSON or URL.
+     * Override this by providing a custom prepareContext function in ProcessOptions.
+     *
+     * @param data - Raw QR code data string
+     * @returns Prepared context object
+     */
+    private defaultPrepareContext;
+    /**
+     * Execute a promise with a timeout
+     *
+     * @param promise - Promise to execute
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Result of the promise
+     * @throws Error if the promise times out
+     */
+    private withTimeout;
+}
+/**
+ * Create a new QR code processor instance
+ *
+ * This is a convenience factory function for creating a processor.
+ *
+ * @param handlers - Optional array of handlers to register immediately
+ * @returns New processor instance with handlers registered
+ *
+ * @example
+ * ```typescript
+ * const processor = createQRCodeProcessor([
+ *   new OID4VCHandler(),
+ *   new CredentialHandler(),
+ * ]);
+ * ```
+ */
+export declare function createQRCodeProcessor(handlers?: QRCodeHandler[]): QRCodeProcessor;
+//# sourceMappingURL=processor.d.ts.map

package/lib/qr-handlers/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../src/qr-handlers/processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,sBAAuB,YAAW,eAAe;IAC5D,OAAO,CAAC,QAAQ,CAAyC;IAEzD;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAU7C;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAItC;;;;OAIG;IACH,WAAW,IAAI,aAAa,EAAE;IAM9B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIjD;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;;;;;;;;;;;OAYG;IACG,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,mBAAmB,CAAC;IAsH/B;;;;;;;;OAQG;YACW,qBAAqB;IA0BnC;;;;;;;OAOG;YACW,WAAW;CAc1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,aAAa,EAAE,GACzB,eAAe,CAUjB"}

package/lib/qr-handlers/processor.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultQRCodeProcessor = void 0;
+exports.createQRCodeProcessor = createQRCodeProcessor;
+/**
+ * Default implementation of QRCodeProcessor
+ *
+ * This processor manages a registry of QR code handlers and executes them
+ * in priority order to process scanned QR codes. It provides a flexible,
+ * extensible system for handling various types of QR codes in a wallet application.
+ *
+ * @example
+ * ```typescript
+ * const processor = new DefaultQRCodeProcessor();
+ *
+ * // Register handlers
+ * processor.registerHandler(new OID4VCHandler());
+ * processor.registerHandler(new CredentialHandler());
+ *
+ * // Process QR code
+ * const result = await processor.process(scannedData);
+ * if (result.success) {
+ *   console.log('QR code processed:', result.data);
+ * } else {
+ *   console.error('Failed to process QR code:', result.error);
+ * }
+ * ```
+ */
+class DefaultQRCodeProcessor {
+    handlers = new Map();
+    /**
+     * Register a new QR code handler
+     *
+     * @param handler - The handler to register
+     * @throws Error if a handler with the same ID is already registered
+     */
+    registerHandler(handler) {
+        if (this.handlers.has(handler.id)) {
+            throw new Error(`Handler with id "${handler.id}" is already registered. ` +
+                `Please use a unique ID or unregister the existing handler first.`);
+        }
+        this.handlers.set(handler.id, handler);
+    }
+    /**
+     * Unregister a QR code handler by its ID
+     *
+     * @param id - The ID of the handler to unregister
+     * @returns True if the handler was found and removed, false otherwise
+     */
+    unregisterHandler(id) {
+        return this.handlers.delete(id);
+    }
+    /**
+     * Get all registered handlers sorted by priority
+     *
+     * @returns Array of registered handlers sorted by priority (lowest first)
+     */
+    getHandlers() {
+        return Array.from(this.handlers.values()).sort((a, b) => (a.priority ?? 100) - (b.priority ?? 100));
+    }
+    /**
+     * Get a specific handler by its ID
+     *
+     * @param id - The ID of the handler to retrieve
+     * @returns The handler if found, undefined otherwise
+     */
+    getHandler(id) {
+        return this.handlers.get(id);
+    }
+    /**
+     * Clear all registered handlers
+     */
+    clearHandlers() {
+        this.handlers.clear();
+    }
+    /**
+     * Process QR code data through registered handlers
+     *
+     * This method:
+     * 1. Prepares the context from raw QR data
+     * 2. Executes handlers in priority order
+     * 3. Returns the first successful result (or continues if stopOnFirstSuccess is false)
+     * 4. Returns an error result if no handler can process the data
+     *
+     * @param data - Raw QR code data string
+     * @param options - Processing options
+     * @returns Result of the processing
+     */
+    async process(data, options = {}) {
+        const { timeout = 30000, stopOnFirstSuccess = true, prepareContext = this.defaultPrepareContext.bind(this), onError, onSuccess, } = options;
+        // Prepare context from raw data
+        let context;
+        try {
+            context = await this.withTimeout(prepareContext(data), timeout);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error : new Error(String(error)),
+                metadata: { phase: 'context-preparation' },
+            };
+        }
+        // Get sorted handlers
+        const handlers = this.getHandlers();
+        if (handlers.length === 0) {
+            return {
+                success: false,
+                error: new Error('No handlers registered'),
+                metadata: { phase: 'handler-execution' },
+            };
+        }
+        let lastError;
+        const attemptedHandlers = [];
+        // Execute handlers in priority order
+        for (const handler of handlers) {
+            try {
+                // Check if handler can process this data
+                const canHandle = await this.withTimeout(Promise.resolve(handler.canHandle(context)), timeout);
+                if (!canHandle) {
+                    continue;
+                }
+                attemptedHandlers.push(handler.id);
+                // Execute handler
+                const result = await this.withTimeout(handler.handle(context), timeout);
+                // Call success callback if provided
+                if (result.success && onSuccess) {
+                    try {
+                        onSuccess(result, handler);
+                    }
+                    catch (callbackError) {
+                        console.error(`Success callback error for handler ${handler.id}:`, callbackError);
+                    }
+                }
+                // Stop on first success if configured
+                if (result.success && stopOnFirstSuccess) {
+                    return {
+                        ...result,
+                        metadata: {
+                            ...result.metadata,
+                            handlerId: handler.id,
+                            attemptedHandlers,
+                        },
+                    };
+                }
+                // Store error if handler failed
+                if (!result.success && result.error) {
+                    lastError = result.error;
+                }
+            }
+            catch (error) {
+                const handlerError = error instanceof Error ? error : new Error(String(error));
+                lastError = handlerError;
+                // Call error callback if provided
+                if (onError) {
+                    try {
+                        onError(handlerError, handler);
+                    }
+                    catch (callbackError) {
+                        console.error(`Error callback error for handler ${handler.id}:`, callbackError);
+                    }
+                }
+                // Continue to next handler
+                continue;
+            }
+        }
+        // No handler could process the data
+        return {
+            success: false,
+            error: lastError ||
+                new Error(`No handler could process the QR code. Attempted handlers: ${attemptedHandlers.join(', ') || 'none'}`),
+            metadata: {
+                phase: 'handler-execution',
+                attemptedHandlers,
+            },
+        };
+    }
+    /**
+     * Default context preparation function
+     *
+     * This method attempts to parse the raw QR data as JSON or URL.
+     * Override this by providing a custom prepareContext function in ProcessOptions.
+     *
+     * @param data - Raw QR code data string
+     * @returns Prepared context object
+     */
+    async defaultPrepareContext(data) {
+        const context = { data };
+        // Try to parse as URL
+        try {
+            // Basic URL validation
+            if (data.startsWith('http://') || data.startsWith('https://')) {
+                const url = new URL(data);
+                context.url = data;
+                context.parsedUrl = data;
+            }
+        }
+        catch {
+            // Not a valid URL, continue
+        }
+        // Try to parse as JSON
+        try {
+            const parsed = JSON.parse(data);
+            context.jsonData = parsed;
+        }
+        catch {
+            // Not valid JSON, continue
+        }
+        return context;
+    }
+    /**
+     * Execute a promise with a timeout
+     *
+     * @param promise - Promise to execute
+     * @param timeoutMs - Timeout in milliseconds
+     * @returns Result of the promise
+     * @throws Error if the promise times out
+     */
+    async withTimeout(promise, timeoutMs) {
+        return Promise.race([
+            promise,
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Operation timed out after ${timeoutMs}ms`)), timeoutMs)),
+        ]);
+    }
+}
+exports.DefaultQRCodeProcessor = DefaultQRCodeProcessor;
+/**
+ * Create a new QR code processor instance
+ *
+ * This is a convenience factory function for creating a processor.
+ *
+ * @param handlers - Optional array of handlers to register immediately
+ * @returns New processor instance with handlers registered
+ *
+ * @example
+ * ```typescript
+ * const processor = createQRCodeProcessor([
+ *   new OID4VCHandler(),
+ *   new CredentialHandler(),
+ * ]);
+ * ```
+ */
+function createQRCodeProcessor(handlers) {
+    const processor = new DefaultQRCodeProcessor();
+    if (handlers) {
+        for (const handler of handlers) {
+            processor.registerHandler(handler);
+        }
+    }
+    return processor;
+}
+//# sourceMappingURL=processor.js.map

package/lib/qr-handlers/processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.js","sourceRoot":"","sources":["../../src/qr-handlers/processor.ts"],"names":[],"mappings":"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"}