@shadow-corp/nearconnect 1.0.0

package/build/helpers/manifest.js

@@ -0,0 +1,329 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FederatedManifestManager = exports.DEFAULT_MANIFEST_SOURCES = void 0;
+exports.validateManifest = validateManifest;
+exports.mergeManifests = mergeManifests;
+/**
+ * Default manifest sources
+ */
+exports.DEFAULT_MANIFEST_SOURCES = [
+    {
+        id: "hot-dao-official",
+        name: "HOT DAO Official",
+        url: "https://raw.githubusercontent.com/hot-dao/near-selector/refs/heads/main/repository/manifest.json",
+        priority: 1,
+        trusted: true,
+        enabled: true,
+        networks: ["mainnet", "testnet"],
+    },
+    {
+        id: "hot-connector-cdn",
+        name: "HOT Connector CDN",
+        url: "https://cdn.jsdelivr.net/gh/azbang/hot-connector/repository/manifest.json",
+        priority: 2,
+        trusted: true,
+        enabled: true,
+        networks: ["mainnet", "testnet"],
+    },
+];
+/**
+ * Federated Manifest Manager
+ *
+ * Aggregates wallet manifests from multiple sources with:
+ * - Priority-based merging (higher priority sources override lower)
+ * - Caching with TTL
+ * - Automatic retries
+ * - Health tracking per source
+ */
+class FederatedManifestManager {
+    sources;
+    cache = new Map();
+    cacheDuration;
+    timeout;
+    maxRetries;
+    retryDelay;
+    network;
+    onUpdate;
+    onError;
+    constructor(options = {}) {
+        const defaultSources = options.useDefaults !== false ? exports.DEFAULT_MANIFEST_SOURCES : [];
+        this.sources = [...defaultSources, ...(options.sources ?? [])];
+        this.cacheDuration = options.cacheDuration ?? 5 * 60 * 1000; // 5 minutes
+        this.timeout = options.timeout ?? 10000; // 10 seconds
+        this.maxRetries = options.maxRetries ?? 2;
+        this.retryDelay = options.retryDelay ?? 1000;
+        this.network = options.network ?? "mainnet";
+        this.onUpdate = options.onUpdate;
+        this.onError = options.onError;
+        // Sort by priority
+        this.sources.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Add a new manifest source
+     */
+    addSource(source) {
+        // Remove existing source with same ID
+        this.sources = this.sources.filter((s) => s.id !== source.id);
+        this.sources.push(source);
+        this.sources.sort((a, b) => a.priority - b.priority);
+    }
+    /**
+     * Remove a manifest source
+     */
+    removeSource(sourceId) {
+        this.sources = this.sources.filter((s) => s.id !== sourceId);
+        this.cache.delete(sourceId);
+    }
+    /**
+     * Enable/disable a source
+     */
+    setSourceEnabled(sourceId, enabled) {
+        const source = this.sources.find((s) => s.id === sourceId);
+        if (source) {
+            source.enabled = enabled;
+        }
+    }
+    /**
+     * Get all sources
+     */
+    getSources() {
+        return [...this.sources];
+    }
+    /**
+     * Fetch manifest from a single source
+     */
+    async fetchFromSource(source) {
+        // Check cache first
+        const cached = this.cache.get(source.id);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.manifest;
+        }
+        // Fetch with retries
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+                const response = await fetch(source.url, {
+                    signal: controller.signal,
+                    headers: {
+                        Accept: "application/json",
+                    },
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const data = await response.json();
+                // Validate manifest structure
+                if (!data.wallets || !Array.isArray(data.wallets)) {
+                    throw new Error("Invalid manifest: missing wallets array");
+                }
+                const manifest = {
+                    source,
+                    wallets: data.wallets,
+                    version: data.version ?? "1.0.0",
+                    fetchedAt: Date.now(),
+                };
+                // Update source metadata
+                source.lastFetched = Date.now();
+                // Cache the result
+                this.cache.set(source.id, {
+                    manifest,
+                    expiresAt: Date.now() + this.cacheDuration,
+                });
+                return manifest;
+            }
+            catch (e) {
+                lastError = e instanceof Error ? e : new Error(String(e));
+                if (attempt < this.maxRetries) {
+                    await new Promise((resolve) => setTimeout(resolve, this.retryDelay));
+                }
+            }
+        }
+        // All retries failed
+        if (lastError) {
+            this.onError?.(source, lastError);
+        }
+        return null;
+    }
+    /**
+     * Fetch and combine manifests from all enabled sources
+     */
+    async fetchAll() {
+        const enabledSources = this.sources.filter((s) => s.enabled);
+        // Fetch from all sources in parallel
+        const results = await Promise.all(enabledSources.map((source) => this.fetchFromSource(source)));
+        // Combine wallets (higher priority sources win on conflicts)
+        const walletMap = new Map();
+        const successfulSources = [];
+        let latestVersion = "1.0.0";
+        // Process in reverse priority order so higher priority overwrites
+        for (let i = results.length - 1; i >= 0; i--) {
+            const result = results[i];
+            if (!result)
+                continue;
+            successfulSources.push(result.source);
+            if (result.version > latestVersion) {
+                latestVersion = result.version;
+            }
+            for (const wallet of result.wallets) {
+                // Filter by network if applicable
+                if (this.network === "testnet" && !wallet.features?.testnet) {
+                    continue;
+                }
+                // Add source metadata to wallet
+                const enrichedWallet = {
+                    ...wallet,
+                    _source: result.source.id,
+                    _trusted: result.source.trusted,
+                };
+                walletMap.set(wallet.id, enrichedWallet);
+            }
+        }
+        const combined = {
+            wallets: Array.from(walletMap.values()),
+            version: latestVersion,
+            sources: successfulSources,
+            lastUpdated: Date.now(),
+        };
+        this.onUpdate?.(combined);
+        return combined;
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Clear cache for a specific source
+     */
+    clearSourceCache(sourceId) {
+        this.cache.delete(sourceId);
+    }
+    /**
+     * Set the network filter
+     */
+    setNetwork(network) {
+        this.network = network;
+    }
+    /**
+     * Get cache status for all sources
+     */
+    getCacheStatus() {
+        const status = {};
+        for (const source of this.sources) {
+            const cached = this.cache.get(source.id);
+            status[source.id] = {
+                cached: !!cached && cached.expiresAt > Date.now(),
+                expiresAt: cached?.expiresAt,
+            };
+        }
+        return status;
+    }
+    /**
+     * Register a custom wallet manifest (for debug/development)
+     */
+    registerCustomWallet(wallet) {
+        // Create a virtual "custom" source if not exists
+        let customSource = this.sources.find((s) => s.id === "custom");
+        if (!customSource) {
+            customSource = {
+                id: "custom",
+                name: "Custom Wallets",
+                url: "",
+                priority: 0, // Highest priority
+                trusted: false,
+                enabled: true,
+            };
+            this.sources.unshift(customSource);
+        }
+        // Add to cache
+        const cached = this.cache.get("custom");
+        const existingWallets = cached?.manifest.wallets ?? [];
+        // Remove existing wallet with same ID
+        const wallets = existingWallets.filter((w) => w.id !== wallet.id);
+        wallets.push({ ...wallet, debug: true });
+        this.cache.set("custom", {
+            manifest: {
+                source: customSource,
+                wallets,
+                version: "custom",
+                fetchedAt: Date.now(),
+            },
+            expiresAt: Date.now() + 365 * 24 * 60 * 60 * 1000, // 1 year
+        });
+    }
+    /**
+     * Remove a custom wallet
+     */
+    removeCustomWallet(walletId) {
+        const cached = this.cache.get("custom");
+        if (!cached)
+            return;
+        cached.manifest.wallets = cached.manifest.wallets.filter((w) => w.id !== walletId);
+    }
+}
+exports.FederatedManifestManager = FederatedManifestManager;
+/**
+ * Validate a wallet manifest
+ */
+function validateManifest(manifest) {
+    if (!manifest || typeof manifest !== "object")
+        return false;
+    const m = manifest;
+    // Required fields
+    if (typeof m.id !== "string" || !m.id)
+        return false;
+    if (typeof m.name !== "string" || !m.name)
+        return false;
+    if (typeof m.icon !== "string" || !m.icon)
+        return false;
+    if (typeof m.website !== "string" || !m.website)
+        return false;
+    if (typeof m.version !== "string" || !m.version)
+        return false;
+    if (typeof m.type !== "string")
+        return false;
+    // Type must be valid
+    if (!["sandbox", "injected", "privileged"].includes(m.type))
+        return false;
+    // Sandbox wallets need executor
+    if (m.type === "sandbox" && typeof m.executor !== "string")
+        return false;
+    return true;
+}
+/**
+ * Merge wallet manifests with conflict resolution
+ */
+function mergeManifests(base, override, strategy = "override") {
+    const walletMap = new Map();
+    // Add base wallets
+    for (const wallet of base) {
+        walletMap.set(wallet.id, wallet);
+    }
+    // Apply override wallets
+    for (const wallet of override) {
+        if (strategy === "override") {
+            walletMap.set(wallet.id, wallet);
+        }
+        else {
+            const existing = walletMap.get(wallet.id);
+            if (existing) {
+                // Merge features and permissions
+                walletMap.set(wallet.id, {
+                    ...existing,
+                    ...wallet,
+                    features: { ...existing.features, ...wallet.features },
+                    permissions: { ...existing.permissions, ...wallet.permissions },
+                });
+            }
+            else {
+                walletMap.set(wallet.id, wallet);
+            }
+        }
+    }
+    return Array.from(walletMap.values());
+}
+//# sourceMappingURL=manifest.js.map

package/build/helpers/manifest.js.map

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

package/build/helpers/queue.d.ts

@@ -0,0 +1,11 @@
+export declare class Queue {
+    _items: any[];
+    enqueue(item: any): void;
+    dequeue(): any;
+    get size(): number;
+}
+export declare class AutoQueue extends Queue {
+    _pendingPromise: boolean;
+    enqueue<T>(action: () => Promise<T>): Promise<T>;
+    dequeue(): Promise<boolean>;
+}

package/build/helpers/queue.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoQueue = exports.Queue = void 0;
+class Queue {
+    _items = [];
+    enqueue(item) {
+        this._items.push(item);
+    }
+    dequeue() {
+        return this._items.shift();
+    }
+    get size() {
+        return this._items.length;
+    }
+}
+exports.Queue = Queue;
+class AutoQueue extends Queue {
+    _pendingPromise = false;
+    enqueue(action) {
+        return new Promise((resolve, reject) => {
+            super.enqueue({ action, resolve, reject });
+            this.dequeue();
+        });
+    }
+    async dequeue() {
+        if (this._pendingPromise)
+            return false;
+        const item = super.dequeue();
+        if (!item)
+            return false;
+        try {
+            this._pendingPromise = true;
+            const payload = await item.action(this);
+            this._pendingPromise = false;
+            item.resolve(payload);
+        }
+        catch (e) {
+            this._pendingPromise = false;
+            item.reject(e);
+        }
+        finally {
+            void this.dequeue();
+        }
+        return true;
+    }
+}
+exports.AutoQueue = AutoQueue;
+//# sourceMappingURL=queue.js.map

package/build/helpers/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../src/helpers/queue.ts"],"names":[],"mappings":";;;AAAA,MAAa,KAAK;IAChB,MAAM,GAAU,EAAE,CAAC;IACnB,OAAO,CAAC,IAAS;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;CACF;AAbD,sBAaC;AAED,MAAa,SAAU,SAAQ,KAAK;IAClC,eAAe,GAAG,KAAK,CAAC;IACxB,OAAO,CAAI,MAAwB;QACjC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,KAAK,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,KAAK,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QAExB,IAAI,CAAC;YACH,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;gBAAS,CAAC;YACT,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AA5BD,8BA4BC"}

package/build/helpers/session.d.ts

@@ -0,0 +1,119 @@
+import { DataStorage } from "./storage";
+import { Session } from "../types";
+export type { Session };
+/**
+ * Session validation result
+ */
+export type SessionValidationResult = {
+    valid: true;
+    session: Session;
+} | {
+    valid: false;
+    reason: "expired" | "invalid" | "missing";
+};
+export interface SessionManagerOptions {
+    storage?: DataStorage;
+    storageKey?: string;
+    maxAge?: number;
+    idleTimeout?: number;
+    autoReconnect?: boolean;
+    enableMultiTabSync?: boolean;
+    onSessionRestored?: (session: Session) => void;
+    onSessionExpired?: (session: Session) => void;
+    onSessionInvalid?: (session: Session) => void;
+    onSessionCleared?: () => void;
+    onSessionSynced?: (session: Session) => void;
+    onIdleTimeout?: (session: Session) => void;
+}
+export declare class SessionManager {
+    private storage;
+    private storageKey;
+    private maxAge;
+    private idleTimeout;
+    private autoReconnect;
+    private enableMultiTabSync;
+    private cachedSession;
+    private broadcastChannel;
+    private idleTimer;
+    private activityHandler;
+    private onSessionRestored?;
+    private onSessionExpired?;
+    private onSessionInvalid?;
+    private onSessionCleared?;
+    private onSessionSynced?;
+    private onIdleTimeout?;
+    constructor(options?: SessionManagerOptions);
+    /**
+     * Initialize multi-tab synchronization via BroadcastChannel
+     */
+    private initMultiTabSync;
+    /**
+     * Handle incoming sync messages from other tabs
+     */
+    private handleSyncMessage;
+    /**
+     * Broadcast session change to other tabs
+     */
+    private broadcast;
+    /**
+     * Start idle timeout tracking
+     */
+    private startIdleTracking;
+    /**
+     * Stop idle timeout tracking
+     */
+    private stopIdleTracking;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+    /**
+     * Save a new session
+     */
+    save(session: Omit<Session, "connectedAt" | "lastActiveAt">): Promise<Session>;
+    /**
+     * Get the current session if valid
+     */
+    get(): Promise<Session | null>;
+    /**
+     * Validate a session and return detailed result
+     */
+    validate(session: Session): SessionValidationResult;
+    /**
+     * Update the last active timestamp
+     */
+    touch(): Promise<void>;
+    /**
+     * Update session data (e.g., accounts changed)
+     */
+    update(updates: Partial<Pick<Session, "accounts" | "network" | "metadata">>): Promise<Session | null>;
+    /**
+     * Clear the session
+     */
+    clear(): Promise<void>;
+    /**
+     * Check if a session is still valid (simple boolean check)
+     */
+    isValid(session: Session): boolean;
+    /**
+     * Check if we should auto-reconnect
+     */
+    shouldAutoReconnect(): boolean;
+    /**
+     * Try to restore a previous session
+     * Returns the session if valid and autoReconnect is enabled
+     */
+    tryRestore(): Promise<Session | null>;
+    /**
+     * Get session age in milliseconds
+     */
+    getAge(): Promise<number | null>;
+    /**
+     * Get time since last activity
+     */
+    getIdleTime(): Promise<number | null>;
+    /**
+     * Check if session exists (without full validation)
+     */
+    exists(): Promise<boolean>;
+}