@jupitermetalabs/face-zk-sdk 0.1.0

package/dist/react-native/utils/resolveModelUri.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { ModelSource } from "../../config/types";
+/** Directory where URL-downloaded models are stored persistently. */
+export declare const MODEL_STORE_DIR: string;
+/**
+ * Resolve a ModelSource to a local file URI.
+ *
+ * @param source         The model source to resolve.
+ * @param onProgress     Optional callback receiving download fraction (0–1).
+ *                       Only fires for `url` sources during active download;
+ *                       silent on cache hits.
+ * @param allowedDomains Optional hostname allowlist. When provided and non-empty,
+ *                       any `url` source whose hostname is not in this list is
+ *                       rejected before any network request is made.
+ *                       Pass `FaceZkConfig.allowedDomains` here in production.
+ * @throws if the source has none of: module, url, localUri
+ * @throws if the download fails (url path)
+ */
+export declare function resolveModelUri(source: ModelSource, onProgress?: (fraction: number) => void, allowedDomains?: string[]): Promise<string>;
+/**
+ * Derive the local store path for a given URL.
+ *
+ * Guards against path traversal in two passes:
+ *  1. URL-decode the last path segment so encoded separators like `%2F` or
+ *     `%2E%2E` are normalised before any checks run.
+ *  2. Re-extract the basename from the decoded string (a decoded `%2F`
+ *     becomes `/`, so a second `.split("/")` is needed).
+ *  3. Reject the reserved names `.` and `..` outright.
+ *  4. Allowlist `[A-Za-z0-9._-]` — the only characters that can appear in a
+ *     legitimate model filename.  Anything outside this set throws so the
+ *     caller can surface the problem rather than silently storing a bad file.
+ *
+ * @throws if the derived filename is empty, a traversal component, or contains
+ *         characters outside the safe allowlist.
+ */
+export declare function deriveStorePath(url: string): string;
+/**
+ * Clear all URL-downloaded model files from the persistent store.
+ * Useful for forcing a re-download after a model version update.
+ */
+export declare function clearModelCache(): Promise<void>;

package/dist/react-native/utils/resolveModelUri.js

@@ -0,0 +1,172 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Face+ZK SDK – Model URI Resolution
+ *
+ * Resolves a `ModelSource` to a local file URI that can be passed to
+ * FileSystem.readAsStringAsync() or similar APIs.
+ *
+ * Resolution order:
+ *   1. localUri  – returned as-is (already resolved)
+ *   2. module    – resolved via expo-asset (Metro-bundled)
+ *   3. url       – downloaded to documentDirectory on first use, path returned
+ *
+ * Models are stored in documentDirectory (not cacheDirectory) so they
+ * survive cache clears and never need re-downloading.
+ */
+import { Asset } from "expo-asset";
+import * as FileSystem from "expo-file-system/legacy";
+/** Directory where URL-downloaded models are stored persistently. */
+export const MODEL_STORE_DIR = `${FileSystem.documentDirectory}face-zk-models/`;
+/**
+ * Resolve a ModelSource to a local file URI.
+ *
+ * @param source         The model source to resolve.
+ * @param onProgress     Optional callback receiving download fraction (0–1).
+ *                       Only fires for `url` sources during active download;
+ *                       silent on cache hits.
+ * @param allowedDomains Optional hostname allowlist. When provided and non-empty,
+ *                       any `url` source whose hostname is not in this list is
+ *                       rejected before any network request is made.
+ *                       Pass `FaceZkConfig.allowedDomains` here in production.
+ * @throws if the source has none of: module, url, localUri
+ * @throws if the download fails (url path)
+ */
+export async function resolveModelUri(source, onProgress, allowedDomains) {
+    // ── 1. Already a local URI ──────────────────────────────────────────────
+    if (source.localUri) {
+        return source.localUri;
+    }
+    // ── 2. Metro-bundled module ─────────────────────────────────────────────
+    if (source.module != null) {
+        const asset = Asset.fromModule(source.module);
+        await asset.downloadAsync();
+        const uri = asset.localUri ?? asset.uri;
+        if (!uri) {
+            throw new Error("[FaceZkSdk] Failed to resolve bundled asset URI.");
+        }
+        return uri;
+    }
+    // ── 3. Remote URL – download and store persistently ─────────────────────
+    if (source.url) {
+        return downloadAndStore(source.url, onProgress, allowedDomains);
+    }
+    throw new Error("[FaceZkSdk] ModelSource must have at least one of: module, url, localUri.");
+}
+/**
+ * Derive the local store path for a given URL.
+ *
+ * Guards against path traversal in two passes:
+ *  1. URL-decode the last path segment so encoded separators like `%2F` or
+ *     `%2E%2E` are normalised before any checks run.
+ *  2. Re-extract the basename from the decoded string (a decoded `%2F`
+ *     becomes `/`, so a second `.split("/")` is needed).
+ *  3. Reject the reserved names `.` and `..` outright.
+ *  4. Allowlist `[A-Za-z0-9._-]` — the only characters that can appear in a
+ *     legitimate model filename.  Anything outside this set throws so the
+ *     caller can surface the problem rather than silently storing a bad file.
+ *
+ * @throws if the derived filename is empty, a traversal component, or contains
+ *         characters outside the safe allowlist.
+ */
+export function deriveStorePath(url) {
+    // Step 1 – take the last slash-delimited segment and drop any query string
+    const raw = url.split("/").pop()?.split("?")[0] ?? "";
+    // Step 2 – URL-decode so encoded traversal sequences are normalised
+    let decoded;
+    try {
+        decoded = decodeURIComponent(raw);
+    }
+    catch {
+        decoded = raw;
+    }
+    // Step 3 – re-extract basename in case decoding introduced new separators
+    const basename = decoded.replace(/\\/g, "/").split("/").pop() ?? "";
+    // Step 4 – reject empty names and dot-traversal components
+    if (!basename || basename === "." || basename === "..") {
+        throw new Error(`[FaceZkSdk] Unsafe or empty model filename derived from URL: "${url}"`);
+    }
+    // Step 5 – allowlist: only alphanumeric, dot, hyphen, underscore
+    if (!/^[A-Za-z0-9._-]+$/.test(basename)) {
+        throw new Error(`[FaceZkSdk] Model filename contains unsafe characters: "${basename}"`);
+    }
+    return `${MODEL_STORE_DIR}${basename}`;
+}
+/**
+ * Download a remote model URL to documentDirectory.
+ * Skips download if the file already exists (store hit).
+ *
+ * Security layers (in order):
+ *  1. HTTPS-only — rejects http://, file://, data: etc.
+ *  2. Domain allowlist — rejects hostnames not in allowedDomains (if provided).
+ *  3. Path containment — asserts the derived local path stays inside MODEL_STORE_DIR.
+ */
+async function downloadAndStore(url, onProgress, allowedDomains) {
+    // ── Layer 1: HTTPS-only ────────────────────────────────────────────────
+    if (!url.startsWith("https://")) {
+        throw new Error(`[FaceZkSdk] Only HTTPS model URLs are permitted. Received: "${url.split("?")[0]}"`);
+    }
+    // ── Layer 2: Domain allowlist ──────────────────────────────────────────
+    if (allowedDomains && allowedDomains.length > 0) {
+        const hostnameMatch = url.match(/^https:\/\/([^/?#]+)/);
+        const hostname = hostnameMatch ? hostnameMatch[1] : null;
+        if (!hostname || !allowedDomains.includes(hostname)) {
+            throw new Error(`[FaceZkSdk] Model download blocked: hostname "${hostname ?? "unknown"}" is not in allowedDomains. ` +
+                `Allowed: [${allowedDomains.join(", ")}]`);
+        }
+    }
+    const localPath = deriveStorePath(url);
+    // ── Layer 3: Path containment ──────────────────────────────────────────
+    if (!localPath.startsWith(MODEL_STORE_DIR)) {
+        throw new Error(`[FaceZkSdk] Security: derived path escapes model store. This is a bug — please report it.`);
+    }
+    // Ensure store directory exists
+    const dirInfo = await FileSystem.getInfoAsync(MODEL_STORE_DIR);
+    if (!dirInfo.exists) {
+        await FileSystem.makeDirectoryAsync(MODEL_STORE_DIR, {
+            intermediates: true,
+        });
+    }
+    // Return stored file if already present
+    const fileInfo = await FileSystem.getInfoAsync(localPath);
+    if (fileInfo.exists) {
+        return localPath;
+    }
+    // Download with optional progress reporting
+    const downloadResumable = FileSystem.createDownloadResumable(url, localPath, {}, onProgress
+        ? (progress) => {
+            if (progress.totalBytesExpectedToWrite > 0) {
+                onProgress(progress.totalBytesWritten / progress.totalBytesExpectedToWrite);
+            }
+        }
+        : undefined);
+    const result = await downloadResumable.downloadAsync();
+    if (!result || result.status < 200 || result.status >= 300) {
+        await FileSystem.deleteAsync(localPath, { idempotent: true });
+        throw new Error(`[FaceZkSdk] Failed to download model from ${url} (HTTP ${result?.status ?? "unknown"}).`);
+    }
+    return localPath;
+}
+/**
+ * Clear all URL-downloaded model files from the persistent store.
+ * Useful for forcing a re-download after a model version update.
+ */
+export async function clearModelCache() {
+    const info = await FileSystem.getInfoAsync(MODEL_STORE_DIR);
+    if (info.exists) {
+        await FileSystem.deleteAsync(MODEL_STORE_DIR, { idempotent: true });
+    }
+}

package/dist/react-native/utils/resolveUiConfig.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Face+ZK SDK – UI Config Resolver
+ *
+ * Merges user-supplied UiConfig with SDK defaults so flow components
+ * always have a complete, resolved theme and string set.
+ */
+import type { UiConfig, FaceZkTheme, FaceZkStrings } from "../../core/types";
+export declare const DEFAULT_THEME: FaceZkTheme;
+export declare const DEFAULT_STRINGS: Required<FaceZkStrings>;
+export interface ResolvedTheme extends FaceZkTheme {
+    colors: Required<FaceZkTheme["colors"]>;
+    borderRadius: number;
+}
+export interface ResolvedUiConfig {
+    theme: ResolvedTheme;
+    strings: Required<FaceZkStrings>;
+    renderLoading?: UiConfig["renderLoading"];
+    renderSuccess?: UiConfig["renderSuccess"];
+    renderError?: UiConfig["renderError"];
+    renderOverlay?: UiConfig["renderOverlay"];
+}
+export declare function resolveUiConfig(uiConfig?: UiConfig): ResolvedUiConfig;
+/**
+ * Replace `{score}` placeholder in a string template.
+ */
+export declare function interpolate(template: string, vars: Record<string, string | number>): string;

package/dist/react-native/utils/resolveUiConfig.js

@@ -0,0 +1,76 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+// ============================================================================
+// Defaults
+// ============================================================================
+export const DEFAULT_THEME = {
+    colors: {
+        primary: "#4CAF50",
+        background: "#000000",
+        surface: "rgba(255,255,255,0.1)",
+        text: "#ffffff",
+        textMuted: "#aaaaaa",
+        error: "#F44336",
+    },
+    borderRadius: 8,
+};
+export const DEFAULT_STRINGS = {
+    loadingInitializing: "Initializing...",
+    loadingModels: "Loading face recognition models...",
+    loadingCapturing: "Capturing image...",
+    loadingProcessing: "Processing reference image...",
+    loadingEmbedding: "Processing face...",
+    loadingMatching: "Matching face...",
+    loadingZkProof: "Generating cryptographic proof...",
+    verificationSuccessTitle: "Verified!",
+    verificationSuccessSubtitle: "Match: {score}%",
+    enrollmentSuccessTitle: "Reference Enrolled",
+    enrollmentSuccessSubtitle: "Your reference has been successfully enrolled.",
+    verificationErrorTitle: "Verification Failed",
+    enrollmentErrorTitle: "Enrollment Failed",
+    cancelButton: "Cancel",
+    retryButton: "Try Again",
+};
+// ============================================================================
+// Resolver
+// ============================================================================
+export function resolveUiConfig(uiConfig = {}) {
+    const userColors = uiConfig.theme?.colors ?? {};
+    const userTheme = uiConfig.theme ?? {};
+    return {
+        theme: {
+            colors: {
+                ...DEFAULT_THEME.colors,
+                ...userColors,
+            },
+            borderRadius: userTheme.borderRadius ?? DEFAULT_THEME.borderRadius,
+        },
+        strings: {
+            ...DEFAULT_STRINGS,
+            ...(uiConfig.strings ?? {}),
+        },
+        renderLoading: uiConfig.renderLoading,
+        renderSuccess: uiConfig.renderSuccess,
+        renderError: uiConfig.renderError,
+        renderOverlay: uiConfig.renderOverlay,
+    };
+}
+/**
+ * Replace `{score}` placeholder in a string template.
+ */
+export function interpolate(template, vars) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => key in vars ? String(vars[key]) : `{${key}}`);
+}

package/dist/storage/defaultStorageAdapter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import type { StorageAdapter, ReferenceId } from "../core/types";
+/**
+ * Create a default storage adapter using AsyncStorage and FileSystem.
+ *
+ * This implementation:
+ * - Stores reference templates in AsyncStorage (small, fast access)
+ * - Stores ZK proofs in FileSystem (large, persistent)
+ * - Maintains indices for listing all stored items
+ *
+ * @returns StorageAdapter implementation
+ */
+export declare function createDefaultStorageAdapter(): StorageAdapter;
+/**
+ * Get all reference IDs from the index
+ */
+export declare function getAllReferenceIds(): Promise<ReferenceId[]>;
+/**
+ * Get all proof IDs from the index
+ */
+export declare function getAllProofIds(): Promise<string[]>;
+/**
+ * Clear all stored references and proofs (for testing/debugging)
+ */
+export declare function clearAllStorage(): Promise<void>;
+/**
+ * Singleton instance for convenience.
+ * Use this if you don't need custom configuration.
+ */
+export declare const defaultStorageAdapter: StorageAdapter;

package/dist/storage/defaultStorageAdapter.js

@@ -0,0 +1,299 @@
+/**
+ * Copyright 2026 JupiterMeta Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+/**
+ * Default Storage Adapter for React Native
+ *
+ * Implements the StorageAdapter interface using AsyncStorage for metadata
+ * and FileSystem for larger data (embeddings, proofs).
+ *
+ * Storage strategy:
+ * - Reference templates: AsyncStorage (embeddings are ~2KB, well under 2MB limit)
+ * - ZK proofs: FileSystem (proofs can be large)
+ */
+import AsyncStorage from "@react-native-async-storage/async-storage";
+import * as FileSystem from "expo-file-system/legacy";
+/**
+ * Storage keys
+ */
+const STORAGE_KEYS = {
+    REFERENCE_PREFIX: "@face-zk-sdk/reference/",
+    PROOF_PREFIX: "@face-zk-sdk/proof/",
+    REFERENCE_INDEX: "@face-zk-sdk/reference-index",
+    PROOF_INDEX: "@face-zk-sdk/proof-index",
+};
+/**
+ * File paths for FileSystem storage
+ */
+const getFilePaths = () => {
+    const baseDir = `${FileSystem.documentDirectory}face-zk-sdk/`;
+    return {
+        baseDir,
+        proofsDir: `${baseDir}proofs/`,
+    };
+};
+/**
+ * Ensure storage directories exist
+ */
+async function ensureDirectoriesExist() {
+    const { baseDir, proofsDir } = getFilePaths();
+    try {
+        // Check if base directory exists
+        const baseDirInfo = await FileSystem.getInfoAsync(baseDir);
+        if (!baseDirInfo.exists) {
+            await FileSystem.makeDirectoryAsync(baseDir, { intermediates: true });
+        }
+        // Check if proofs directory exists
+        const proofsDirInfo = await FileSystem.getInfoAsync(proofsDir);
+        if (!proofsDirInfo.exists) {
+            await FileSystem.makeDirectoryAsync(proofsDir, { intermediates: true });
+        }
+    }
+    catch (error) {
+        console.error("[DefaultStorageAdapter] Error creating directories:", error);
+        throw error;
+    }
+}
+/**
+ * Create a default storage adapter using AsyncStorage and FileSystem.
+ *
+ * This implementation:
+ * - Stores reference templates in AsyncStorage (small, fast access)
+ * - Stores ZK proofs in FileSystem (large, persistent)
+ * - Maintains indices for listing all stored items
+ *
+ * @returns StorageAdapter implementation
+ */
+export function createDefaultStorageAdapter() {
+    return {
+        // ========================================================================
+        // Reference Template Storage
+        // ========================================================================
+        async saveReference(template) {
+            const key = `${STORAGE_KEYS.REFERENCE_PREFIX}${template.referenceId}`;
+            try {
+                // Serialize template to JSON
+                const json = JSON.stringify(template);
+                // Store in AsyncStorage
+                await AsyncStorage.setItem(key, json);
+                // Update index
+                await updateReferenceIndex(template.referenceId, "add");
+                console.log(`[DefaultStorageAdapter] Saved reference: ${template.referenceId}`);
+                return template.referenceId;
+            }
+            catch (error) {
+                console.error("[DefaultStorageAdapter] Error saving reference:", error);
+                throw new Error(`Failed to save reference: ${error instanceof Error ? error.message : "Unknown error"}`);
+            }
+        },
+        async loadReference(referenceId) {
+            const key = `${STORAGE_KEYS.REFERENCE_PREFIX}${referenceId}`;
+            try {
+                const json = await AsyncStorage.getItem(key);
+                if (!json) {
+                    console.log(`[DefaultStorageAdapter] Reference not found: ${referenceId}`);
+                    return null;
+                }
+                const template = JSON.parse(json);
+                console.log(`[DefaultStorageAdapter] Loaded reference: ${referenceId}`);
+                return template;
+            }
+            catch (error) {
+                console.error("[DefaultStorageAdapter] Error loading reference:", error);
+                return null;
+            }
+        },
+        async deleteReference(referenceId) {
+            const key = `${STORAGE_KEYS.REFERENCE_PREFIX}${referenceId}`;
+            try {
+                await AsyncStorage.removeItem(key);
+                // Update index
+                await updateReferenceIndex(referenceId, "remove");
+                console.log(`[DefaultStorageAdapter] Deleted reference: ${referenceId}`);
+            }
+            catch (error) {
+                console.error("[DefaultStorageAdapter] Error deleting reference:", error);
+                throw new Error(`Failed to delete reference: ${error instanceof Error ? error.message : "Unknown error"}`);
+            }
+        },
+        // ========================================================================
+        // ZK Proof Storage (FileSystem)
+        // ========================================================================
+        async saveProof(record) {
+            const proofId = `proof_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+            const { proofsDir } = getFilePaths();
+            const filePath = `${proofsDir}${proofId}.json`;
+            try {
+                // Ensure directories exist
+                await ensureDirectoriesExist();
+                // Serialize proof record to JSON
+                const json = JSON.stringify(record);
+                // Write to file
+                await FileSystem.writeAsStringAsync(filePath, json, {
+                    encoding: FileSystem.EncodingType.UTF8,
+                });
+                // Update index
+                await updateProofIndex(proofId, "add");
+                console.log(`[DefaultStorageAdapter] Saved proof: ${proofId}`);
+                return proofId;
+            }
+            catch (error) {
+                console.error("[DefaultStorageAdapter] Error saving proof:", error);
+                throw new Error(`Failed to save proof: ${error instanceof Error ? error.message : "Unknown error"}`);
+            }
+        },
+        async loadProof(proofId) {
+            const { proofsDir } = getFilePaths();
+            const filePath = `${proofsDir}${proofId}.json`;
+            try {
+                // Check if file exists
+                const fileInfo = await FileSystem.getInfoAsync(filePath);
+                if (!fileInfo.exists) {
+                    console.log(`[DefaultStorageAdapter] Proof not found: ${proofId}`);
+                    return null;
+                }
+                // Read file
+                const json = await FileSystem.readAsStringAsync(filePath, {
+                    encoding: FileSystem.EncodingType.UTF8,
+                });
+                const record = JSON.parse(json);
+                console.log(`[DefaultStorageAdapter] Loaded proof: ${proofId}`);
+                return record;
+            }
+            catch (error) {
+                console.error("[DefaultStorageAdapter] Error loading proof:", error);
+                return null;
+            }
+        },
+    };
+}
+// ============================================================================
+// Helper Functions for Index Management
+// ============================================================================
+/**
+ * Update the reference index (list of all reference IDs)
+ */
+async function updateReferenceIndex(referenceId, action) {
+    try {
+        const indexJson = await AsyncStorage.getItem(STORAGE_KEYS.REFERENCE_INDEX);
+        const index = indexJson ? JSON.parse(indexJson) : [];
+        if (action === "add") {
+            if (!index.includes(referenceId)) {
+                index.push(referenceId);
+            }
+        }
+        else {
+            const idx = index.indexOf(referenceId);
+            if (idx !== -1) {
+                index.splice(idx, 1);
+            }
+        }
+        await AsyncStorage.setItem(STORAGE_KEYS.REFERENCE_INDEX, JSON.stringify(index));
+    }
+    catch (error) {
+        console.error("[DefaultStorageAdapter] Error updating reference index:", error);
+    }
+}
+/**
+ * Update the proof index (list of all proof IDs)
+ */
+async function updateProofIndex(proofId, action) {
+    try {
+        const indexJson = await AsyncStorage.getItem(STORAGE_KEYS.PROOF_INDEX);
+        const index = indexJson ? JSON.parse(indexJson) : [];
+        if (action === "add") {
+            if (!index.includes(proofId)) {
+                index.push(proofId);
+            }
+        }
+        else {
+            const idx = index.indexOf(proofId);
+            if (idx !== -1) {
+                index.splice(idx, 1);
+            }
+        }
+        await AsyncStorage.setItem(STORAGE_KEYS.PROOF_INDEX, JSON.stringify(index));
+    }
+    catch (error) {
+        console.error("[DefaultStorageAdapter] Error updating proof index:", error);
+    }
+}
+/**
+ * Get all reference IDs from the index
+ */
+export async function getAllReferenceIds() {
+    try {
+        const indexJson = await AsyncStorage.getItem(STORAGE_KEYS.REFERENCE_INDEX);
+        return indexJson ? JSON.parse(indexJson) : [];
+    }
+    catch (error) {
+        console.error("[DefaultStorageAdapter] Error getting reference index:", error);
+        return [];
+    }
+}
+/**
+ * Get all proof IDs from the index
+ */
+export async function getAllProofIds() {
+    try {
+        const indexJson = await AsyncStorage.getItem(STORAGE_KEYS.PROOF_INDEX);
+        return indexJson ? JSON.parse(indexJson) : [];
+    }
+    catch (error) {
+        console.error("[DefaultStorageAdapter] Error getting proof index:", error);
+        return [];
+    }
+}
+/**
+ * Clear all stored references and proofs (for testing/debugging)
+ */
+export async function clearAllStorage() {
+    try {
+        // Get all reference IDs
+        const referenceIds = await getAllReferenceIds();
+        // Delete all references
+        for (const refId of referenceIds) {
+            const key = `${STORAGE_KEYS.REFERENCE_PREFIX}${refId}`;
+            await AsyncStorage.removeItem(key);
+        }
+        // Clear reference index
+        await AsyncStorage.removeItem(STORAGE_KEYS.REFERENCE_INDEX);
+        // Get all proof IDs
+        const proofIds = await getAllProofIds();
+        // Delete all proof files
+        const { proofsDir } = getFilePaths();
+        for (const proofId of proofIds) {
+            const filePath = `${proofsDir}${proofId}.json`;
+            try {
+                await FileSystem.deleteAsync(filePath, { idempotent: true });
+            }
+            catch (error) {
+                console.warn(`[DefaultStorageAdapter] Error deleting proof file: ${proofId}`, error);
+            }
+        }
+        // Clear proof index
+        await AsyncStorage.removeItem(STORAGE_KEYS.PROOF_INDEX);
+        console.log("[DefaultStorageAdapter] All storage cleared");
+    }
+    catch (error) {
+        console.error("[DefaultStorageAdapter] Error clearing storage:", error);
+        throw error;
+    }
+}
+/**
+ * Singleton instance for convenience.
+ * Use this if you don't need custom configuration.
+ */
+export const defaultStorageAdapter = createDefaultStorageAdapter();