@vailix/mask 0.1.2

package/dist/index.d.mts

@@ -0,0 +1,347 @@
+import { ExpoSQLiteDatabase } from 'drizzle-orm/expo-sqlite';
+import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
+import { EventEmitter } from 'eventemitter3';
+
+interface ReportMetadata {
+    [key: string]: string | number | boolean | (string | number | boolean)[] | undefined;
+}
+interface Match {
+    rpi: string;
+    timestamp: number;
+    metadata?: ReportMetadata;
+    reportedAt?: number;
+}
+interface KeyStorage {
+    getKey(): Promise<string | null>;
+    setKey(key: string): Promise<void>;
+}
+type MatchHandler = (matches: Match[]) => void;
+type VailixDB = ExpoSQLiteDatabase<Record<string, never>>;
+/**
+ * Represents a nearby user discovered via BLE.
+ *
+ * Design: Internal details (RPI, metadataKey) are hidden from the public API.
+ * The app only needs: something to display, something to pair with, and status flags.
+ * RPIs and keys are managed internally by the package for contact tracing.
+ */
+interface NearbyUser {
+    /** Opaque identifier for pairing (pass to pairWithUser) */
+    id: string;
+    /** Generated emoji + number for UI display */
+    displayName: string;
+    /** Signal strength (for proximity filtering) */
+    rssi: number;
+    /** Timestamp of last advertisement received */
+    discoveredAt: number;
+    /** true if we have securely stored their data */
+    paired: boolean;
+    /** true if they sent us data but we haven't accepted yet (explicit mode) */
+    hasIncomingRequest: boolean;
+    /** Timestamp when pairing occurred (optional, populated after successful pair) */
+    pairedAt?: number;
+}
+/** Result of a pairing attempt */
+interface PairResult {
+    success: boolean;
+    partnerRpi?: string;
+    partnerMetadataKey?: string;
+    error?: string;
+}
+/**
+ * Unified SDK Configuration Interface
+ */
+interface VailixConfig {
+    /** The live API endpoint for submitting reports */
+    reportUrl: string;
+    /** The endpoint for downloading keys (can be the same as reportUrl or a CDN) */
+    downloadUrl: string;
+    /** Application secret for API authentication */
+    appSecret: string;
+    /** Custom key storage adapter (default: expo-secure-store) */
+    keyStorage?: KeyStorage;
+    /** Number of days of history to include in reports (default: 14) */
+    reportDays?: number;
+    /** How long RPI persists in ms (default: 15min, can be 24h for STD apps) */
+    rpiDurationMs?: number;
+    /** Minimum time between scans of same RPI in ms (default: 0 = no limit) */
+    rescanIntervalMs?: number;
+    /** Timeout before removing a user from nearby list in ms (default: 15000) */
+    bleDiscoveryTimeoutMs?: number;
+    /** Minimum RSSI to consider a user "nearby" (default: -70) */
+    proximityThreshold?: number;
+    /** If true, automatically pair when receiving a write (default: true) */
+    autoAcceptIncomingPairs?: boolean;
+    /** Custom BLE Service UUID (default: a1b2c3d4-e5f6-7890-abcd-ef1234567890) */
+    serviceUUID?: string;
+}
+
+declare class IdentityManager {
+    private masterKey;
+    private epochMs;
+    private keyStorage;
+    constructor(config?: {
+        rpiDurationMs?: number;
+        keyStorage?: KeyStorage;
+    });
+    initialize(): Promise<void>;
+    getCurrentRPI(): string;
+    getHistory(days: number): string[];
+    private _generateRPI;
+    getMetadataKey(rpi: string): string;
+    getMasterKey(): string;
+    /**
+     * Get anonymous display name derived from current RPI.
+     * Used for showing user's identity in UI without revealing master key.
+     * Format: "Emoji Number" (e.g. "🐼 42")
+     */
+    getDisplayName(): string;
+}
+
+declare const scannedEvents: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
+    name: "scanned_events";
+    schema: undefined;
+    columns: {
+        id: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "id";
+            tableName: "scanned_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        rpi: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "rpi";
+            tableName: "scanned_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        metadataKey: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "metadata_key";
+            tableName: "scanned_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        timestamp: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "timestamp";
+            tableName: "scanned_events";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/** Type for a scanned event row */
+type ScannedEvent = typeof scannedEvents.$inferSelect;
+declare class StorageService {
+    private db;
+    private rescanIntervalMs;
+    private lastScanByRpi;
+    private static readonly MAX_SCAN_HISTORY_SIZE;
+    constructor(db: VailixDB, config?: {
+        rescanIntervalMs?: number;
+    });
+    initialize(): Promise<void>;
+    canScan(rpi: string): boolean;
+    logScan(rpi: string, metadataKey: string, timestamp: number): Promise<void>;
+    cleanupOldScans(): Promise<void>;
+    getMatchingScans(rpiList: string[]): Promise<ScannedEvent[]>;
+    getRecentPairs(withinHours?: number): Promise<ScannedEvent[]>;
+}
+
+declare class MatcherService extends EventEmitter {
+    private storage;
+    private downloadUrl;
+    private appSecret;
+    constructor(storage: StorageService, downloadUrl: string, appSecret: string);
+    fetchAndMatch(): Promise<Match[]>;
+    private _downloadAndProcessKeys;
+    private _parseBinaryResponse;
+    private _decrypt;
+    /**
+     * Retrieve a specific match by RPI with on-demand decryption.
+     * Used when app needs to display exposure details to user.
+     *
+     * PRIVACY: Decrypted metadata exists ONLY in-memory (return value).
+     * Never persisted to storage.
+     *
+     * @param rpi - The RPI (match ID) to retrieve
+     * @returns Match with decrypted metadata, or null if not found
+     */
+    getMatchById(rpi: string): Promise<Match | null>;
+}
+
+declare function formatQR(rpi: string, metadataKey: string): string;
+declare function parseQR(data: string): ParsedQR | null;
+interface ParsedQR {
+    rpi: string;
+    timestamp: number;
+    metadataKey: string;
+}
+
+declare class VailixSDK {
+    identity: IdentityManager;
+    storage: StorageService;
+    matcher: MatcherService;
+    private ble;
+    private reportUrl;
+    private appSecret;
+    private reportDays;
+    private rpiDurationMs;
+    private constructor();
+    /**
+     * Create and initialize the VailixSDK.
+     *
+     * @param config - Unified configuration object
+     */
+    static create(config: VailixConfig): Promise<VailixSDK>;
+    /** Get current QR code data */
+    getQRCode(): string;
+    /**
+     * Scan another user's QR code and log it.
+     * Returns false if: QR invalid, expired (>RPI duration), rescan blocked, or error
+     */
+    scanQR(qrData: string): Promise<boolean>;
+    /**
+     * Check if BLE is supported on this device.
+     */
+    static isBleSupported(): Promise<boolean>;
+    /**
+     * Start BLE discovery (call when pairing screen opens).
+     * Begins advertising our RPI and scanning for nearby users.
+     */
+    startDiscovery(): Promise<void>;
+    /**
+     * Stop BLE discovery (call when leaving pairing screen).
+     */
+    stopDiscovery(): Promise<void>;
+    /**
+     * Get current list of nearby users.
+     */
+    getNearbyUsers(): NearbyUser[];
+    /**
+     * Subscribe to nearby user updates.
+     * Returns cleanup function for React useEffect compatibility.
+     *
+     * @example
+     * useEffect(() => {
+     *   const cleanup = sdk.onNearbyUsersChanged(setNearbyUsers);
+     *   return cleanup;
+     * }, []);
+     */
+    onNearbyUsersChanged(callback: (users: NearbyUser[]) => void): () => void;
+    /**
+     * Pair with a specific user (one-tap action).
+     * In explicit consent mode, this also accepts pending incoming requests.
+     *
+     * @param userId - The user's ID from NearbyUser.id
+     */
+    pairWithUser(userId: string): Promise<PairResult>;
+    /**
+     * Unpair with a user (removes from storage and resets status).
+     * Useful for "undo" functionality or rejecting requests.
+     *
+     * @param userId - The user's ID from NearbyUser.id
+     */
+    unpairUser(userId: string): Promise<void>;
+    /**
+     * Get list of recent pairings from storage (for history/recap features).
+     * Returns pairs from the last N hours (default: 24h).
+     *
+     * @param withinHours - Look back window in hours (default: 24)
+     * @returns Array of NearbyUser objects representing recent pairs
+     */
+    getRecentPairs(withinHours?: number): Promise<NearbyUser[]>;
+    /**
+     * Report positive (upload configured days of history).
+     *
+     * @param attestToken - Optional attestation token (e.g., Firebase App Check)
+     * @param metadata - App-specific data (e.g., STD type, test date). If null, a generic positive is reported.
+     * @param overrideReportDays - Optional: Override reportDays for this specific report
+     *                             (e.g., for apps with per-condition exposure windows)
+     */
+    report(attestToken?: string, metadata?: ReportMetadata, overrideReportDays?: number): Promise<boolean>;
+    private static readonly MAX_METADATA_SIZE;
+    private _encrypt;
+    /**
+     * Subscribe to match events.
+     * Returns cleanup function for React useEffect compatibility.
+     */
+    onMatch(handler: MatchHandler): () => void;
+    /**
+     * Subscribe to error events.
+     * Returns cleanup function for React useEffect compatibility.
+     */
+    onError(handler: (error: Error) => void): () => void;
+    /** Explicit cleanup for match handler */
+    offMatch(handler: MatchHandler): void;
+    /** Explicit cleanup for error handler */
+    offError(handler: (error: Error) => void): void;
+    /**
+     * Get a specific match by ID with decrypted metadata.
+     * Used for on-demand decryption when user views exposure details.
+     *
+     * @param matchId - RPI of the match to retrieve
+     * @returns Match with decrypted metadata, or null if not found
+     *
+     * @example
+     * // App calls this when user taps on notification
+     * const match = await sdk.getMatchById('abc123');
+     * console.log(match.metadata.conditions); // ["HIV", "Syphilis"]
+     */
+    getMatchById(matchId: string): Promise<Match | null>;
+    /**
+     * Get own display name (emoji + number derived from current RPI).
+     * Used for showing user's anonymous identity in UI.
+     */
+    getOwnDisplayName(): string;
+}
+
+export { type KeyStorage, type Match, type MatchHandler, type NearbyUser, type PairResult, type ReportMetadata, type VailixConfig, VailixSDK, formatQR, parseQR };

package/dist/index.d.ts

@@ -0,0 +1,347 @@
+import { ExpoSQLiteDatabase } from 'drizzle-orm/expo-sqlite';
+import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
+import { EventEmitter } from 'eventemitter3';
+
+interface ReportMetadata {
+    [key: string]: string | number | boolean | (string | number | boolean)[] | undefined;
+}
+interface Match {
+    rpi: string;
+    timestamp: number;
+    metadata?: ReportMetadata;
+    reportedAt?: number;
+}
+interface KeyStorage {
+    getKey(): Promise<string | null>;
+    setKey(key: string): Promise<void>;
+}
+type MatchHandler = (matches: Match[]) => void;
+type VailixDB = ExpoSQLiteDatabase<Record<string, never>>;
+/**
+ * Represents a nearby user discovered via BLE.
+ *
+ * Design: Internal details (RPI, metadataKey) are hidden from the public API.
+ * The app only needs: something to display, something to pair with, and status flags.
+ * RPIs and keys are managed internally by the package for contact tracing.
+ */
+interface NearbyUser {
+    /** Opaque identifier for pairing (pass to pairWithUser) */
+    id: string;
+    /** Generated emoji + number for UI display */
+    displayName: string;
+    /** Signal strength (for proximity filtering) */
+    rssi: number;
+    /** Timestamp of last advertisement received */
+    discoveredAt: number;
+    /** true if we have securely stored their data */
+    paired: boolean;
+    /** true if they sent us data but we haven't accepted yet (explicit mode) */
+    hasIncomingRequest: boolean;
+    /** Timestamp when pairing occurred (optional, populated after successful pair) */
+    pairedAt?: number;
+}
+/** Result of a pairing attempt */
+interface PairResult {
+    success: boolean;
+    partnerRpi?: string;
+    partnerMetadataKey?: string;
+    error?: string;
+}
+/**
+ * Unified SDK Configuration Interface
+ */
+interface VailixConfig {
+    /** The live API endpoint for submitting reports */
+    reportUrl: string;
+    /** The endpoint for downloading keys (can be the same as reportUrl or a CDN) */
+    downloadUrl: string;
+    /** Application secret for API authentication */
+    appSecret: string;
+    /** Custom key storage adapter (default: expo-secure-store) */
+    keyStorage?: KeyStorage;
+    /** Number of days of history to include in reports (default: 14) */
+    reportDays?: number;
+    /** How long RPI persists in ms (default: 15min, can be 24h for STD apps) */
+    rpiDurationMs?: number;
+    /** Minimum time between scans of same RPI in ms (default: 0 = no limit) */
+    rescanIntervalMs?: number;
+    /** Timeout before removing a user from nearby list in ms (default: 15000) */
+    bleDiscoveryTimeoutMs?: number;
+    /** Minimum RSSI to consider a user "nearby" (default: -70) */
+    proximityThreshold?: number;
+    /** If true, automatically pair when receiving a write (default: true) */
+    autoAcceptIncomingPairs?: boolean;
+    /** Custom BLE Service UUID (default: a1b2c3d4-e5f6-7890-abcd-ef1234567890) */
+    serviceUUID?: string;
+}
+
+declare class IdentityManager {
+    private masterKey;
+    private epochMs;
+    private keyStorage;
+    constructor(config?: {
+        rpiDurationMs?: number;
+        keyStorage?: KeyStorage;
+    });
+    initialize(): Promise<void>;
+    getCurrentRPI(): string;
+    getHistory(days: number): string[];
+    private _generateRPI;
+    getMetadataKey(rpi: string): string;
+    getMasterKey(): string;
+    /**
+     * Get anonymous display name derived from current RPI.
+     * Used for showing user's identity in UI without revealing master key.
+     * Format: "Emoji Number" (e.g. "🐼 42")
+     */
+    getDisplayName(): string;
+}
+
+declare const scannedEvents: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
+    name: "scanned_events";
+    schema: undefined;
+    columns: {
+        id: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "id";
+            tableName: "scanned_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        rpi: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "rpi";
+            tableName: "scanned_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        metadataKey: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "metadata_key";
+            tableName: "scanned_events";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        timestamp: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "timestamp";
+            tableName: "scanned_events";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;
+/** Type for a scanned event row */
+type ScannedEvent = typeof scannedEvents.$inferSelect;
+declare class StorageService {
+    private db;
+    private rescanIntervalMs;
+    private lastScanByRpi;
+    private static readonly MAX_SCAN_HISTORY_SIZE;
+    constructor(db: VailixDB, config?: {
+        rescanIntervalMs?: number;
+    });
+    initialize(): Promise<void>;
+    canScan(rpi: string): boolean;
+    logScan(rpi: string, metadataKey: string, timestamp: number): Promise<void>;
+    cleanupOldScans(): Promise<void>;
+    getMatchingScans(rpiList: string[]): Promise<ScannedEvent[]>;
+    getRecentPairs(withinHours?: number): Promise<ScannedEvent[]>;
+}
+
+declare class MatcherService extends EventEmitter {
+    private storage;
+    private downloadUrl;
+    private appSecret;
+    constructor(storage: StorageService, downloadUrl: string, appSecret: string);
+    fetchAndMatch(): Promise<Match[]>;
+    private _downloadAndProcessKeys;
+    private _parseBinaryResponse;
+    private _decrypt;
+    /**
+     * Retrieve a specific match by RPI with on-demand decryption.
+     * Used when app needs to display exposure details to user.
+     *
+     * PRIVACY: Decrypted metadata exists ONLY in-memory (return value).
+     * Never persisted to storage.
+     *
+     * @param rpi - The RPI (match ID) to retrieve
+     * @returns Match with decrypted metadata, or null if not found
+     */
+    getMatchById(rpi: string): Promise<Match | null>;
+}
+
+declare function formatQR(rpi: string, metadataKey: string): string;
+declare function parseQR(data: string): ParsedQR | null;
+interface ParsedQR {
+    rpi: string;
+    timestamp: number;
+    metadataKey: string;
+}
+
+declare class VailixSDK {
+    identity: IdentityManager;
+    storage: StorageService;
+    matcher: MatcherService;
+    private ble;
+    private reportUrl;
+    private appSecret;
+    private reportDays;
+    private rpiDurationMs;
+    private constructor();
+    /**
+     * Create and initialize the VailixSDK.
+     *
+     * @param config - Unified configuration object
+     */
+    static create(config: VailixConfig): Promise<VailixSDK>;
+    /** Get current QR code data */
+    getQRCode(): string;
+    /**
+     * Scan another user's QR code and log it.
+     * Returns false if: QR invalid, expired (>RPI duration), rescan blocked, or error
+     */
+    scanQR(qrData: string): Promise<boolean>;
+    /**
+     * Check if BLE is supported on this device.
+     */
+    static isBleSupported(): Promise<boolean>;
+    /**
+     * Start BLE discovery (call when pairing screen opens).
+     * Begins advertising our RPI and scanning for nearby users.
+     */
+    startDiscovery(): Promise<void>;
+    /**
+     * Stop BLE discovery (call when leaving pairing screen).
+     */
+    stopDiscovery(): Promise<void>;
+    /**
+     * Get current list of nearby users.
+     */
+    getNearbyUsers(): NearbyUser[];
+    /**
+     * Subscribe to nearby user updates.
+     * Returns cleanup function for React useEffect compatibility.
+     *
+     * @example
+     * useEffect(() => {
+     *   const cleanup = sdk.onNearbyUsersChanged(setNearbyUsers);
+     *   return cleanup;
+     * }, []);
+     */
+    onNearbyUsersChanged(callback: (users: NearbyUser[]) => void): () => void;
+    /**
+     * Pair with a specific user (one-tap action).
+     * In explicit consent mode, this also accepts pending incoming requests.
+     *
+     * @param userId - The user's ID from NearbyUser.id
+     */
+    pairWithUser(userId: string): Promise<PairResult>;
+    /**
+     * Unpair with a user (removes from storage and resets status).
+     * Useful for "undo" functionality or rejecting requests.
+     *
+     * @param userId - The user's ID from NearbyUser.id
+     */
+    unpairUser(userId: string): Promise<void>;
+    /**
+     * Get list of recent pairings from storage (for history/recap features).
+     * Returns pairs from the last N hours (default: 24h).
+     *
+     * @param withinHours - Look back window in hours (default: 24)
+     * @returns Array of NearbyUser objects representing recent pairs
+     */
+    getRecentPairs(withinHours?: number): Promise<NearbyUser[]>;
+    /**
+     * Report positive (upload configured days of history).
+     *
+     * @param attestToken - Optional attestation token (e.g., Firebase App Check)
+     * @param metadata - App-specific data (e.g., STD type, test date). If null, a generic positive is reported.
+     * @param overrideReportDays - Optional: Override reportDays for this specific report
+     *                             (e.g., for apps with per-condition exposure windows)
+     */
+    report(attestToken?: string, metadata?: ReportMetadata, overrideReportDays?: number): Promise<boolean>;
+    private static readonly MAX_METADATA_SIZE;
+    private _encrypt;
+    /**
+     * Subscribe to match events.
+     * Returns cleanup function for React useEffect compatibility.
+     */
+    onMatch(handler: MatchHandler): () => void;
+    /**
+     * Subscribe to error events.
+     * Returns cleanup function for React useEffect compatibility.
+     */
+    onError(handler: (error: Error) => void): () => void;
+    /** Explicit cleanup for match handler */
+    offMatch(handler: MatchHandler): void;
+    /** Explicit cleanup for error handler */
+    offError(handler: (error: Error) => void): void;
+    /**
+     * Get a specific match by ID with decrypted metadata.
+     * Used for on-demand decryption when user views exposure details.
+     *
+     * @param matchId - RPI of the match to retrieve
+     * @returns Match with decrypted metadata, or null if not found
+     *
+     * @example
+     * // App calls this when user taps on notification
+     * const match = await sdk.getMatchById('abc123');
+     * console.log(match.metadata.conditions); // ["HIV", "Syphilis"]
+     */
+    getMatchById(matchId: string): Promise<Match | null>;
+    /**
+     * Get own display name (emoji + number derived from current RPI).
+     * Used for showing user's anonymous identity in UI.
+     */
+    getOwnDisplayName(): string;
+}
+
+export { type KeyStorage, type Match, type MatchHandler, type NearbyUser, type PairResult, type ReportMetadata, type VailixConfig, VailixSDK, formatQR, parseQR };