@shadow-corp/nearconnect 1.0.0

package/build/helpers/session.js

@@ -0,0 +1,289 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionManager = void 0;
+const storage_1 = require("./storage");
+const DEFAULT_MAX_AGE = 7 * 24 * 60 * 60 * 1000; // 7 days
+const DEFAULT_STORAGE_KEY = "near-connect-session";
+const BROADCAST_CHANNEL_NAME = "near-connect-session-sync";
+class SessionManager {
+    storage;
+    storageKey;
+    maxAge;
+    idleTimeout;
+    autoReconnect;
+    enableMultiTabSync;
+    cachedSession = null;
+    broadcastChannel = null;
+    idleTimer = null;
+    activityHandler = null;
+    onSessionRestored;
+    onSessionExpired;
+    onSessionInvalid;
+    onSessionCleared;
+    onSessionSynced;
+    onIdleTimeout;
+    constructor(options = {}) {
+        this.storage = options.storage ?? new storage_1.LocalStorage();
+        this.storageKey = options.storageKey ?? DEFAULT_STORAGE_KEY;
+        this.maxAge = options.maxAge ?? DEFAULT_MAX_AGE;
+        this.idleTimeout = options.idleTimeout ?? null;
+        this.autoReconnect = options.autoReconnect ?? true;
+        this.enableMultiTabSync = options.enableMultiTabSync ?? true;
+        this.onSessionRestored = options.onSessionRestored;
+        this.onSessionExpired = options.onSessionExpired;
+        this.onSessionInvalid = options.onSessionInvalid;
+        this.onSessionCleared = options.onSessionCleared;
+        this.onSessionSynced = options.onSessionSynced;
+        this.onIdleTimeout = options.onIdleTimeout;
+        this.initMultiTabSync();
+    }
+    /**
+     * Initialize multi-tab synchronization via BroadcastChannel
+     */
+    initMultiTabSync() {
+        if (!this.enableMultiTabSync)
+            return;
+        if (typeof BroadcastChannel === "undefined")
+            return;
+        try {
+            this.broadcastChannel = new BroadcastChannel(BROADCAST_CHANNEL_NAME);
+            this.broadcastChannel.onmessage = (event) => {
+                this.handleSyncMessage(event.data);
+            };
+        }
+        catch {
+            // BroadcastChannel not supported
+        }
+    }
+    /**
+     * Handle incoming sync messages from other tabs
+     */
+    handleSyncMessage(message) {
+        switch (message.type) {
+            case "session:updated":
+                if (message.session) {
+                    this.cachedSession = message.session;
+                    this.onSessionSynced?.(message.session);
+                }
+                break;
+            case "session:cleared":
+            case "session:disconnected":
+                this.cachedSession = null;
+                this.onSessionCleared?.();
+                break;
+        }
+    }
+    /**
+     * Broadcast session change to other tabs
+     */
+    broadcast(message) {
+        this.broadcastChannel?.postMessage(message);
+    }
+    /**
+     * Start idle timeout tracking
+     */
+    startIdleTracking() {
+        if (!this.idleTimeout || typeof window === "undefined")
+            return;
+        this.stopIdleTracking();
+        const resetTimer = () => {
+            if (this.idleTimer)
+                clearTimeout(this.idleTimer);
+            this.idleTimer = setTimeout(async () => {
+                const session = await this.get();
+                if (session) {
+                    this.onIdleTimeout?.(session);
+                    await this.clear();
+                }
+            }, this.idleTimeout);
+            // Touch session on activity
+            this.touch().catch(() => { });
+        };
+        this.activityHandler = resetTimer;
+        const events = ["mousedown", "keydown", "touchstart", "scroll"];
+        events.forEach((event) => {
+            window.addEventListener(event, resetTimer, { passive: true });
+        });
+        resetTimer();
+    }
+    /**
+     * Stop idle timeout tracking
+     */
+    stopIdleTracking() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = null;
+        }
+        if (this.activityHandler && typeof window !== "undefined") {
+            const events = ["mousedown", "keydown", "touchstart", "scroll"];
+            events.forEach((event) => {
+                window.removeEventListener(event, this.activityHandler);
+            });
+            this.activityHandler = null;
+        }
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.stopIdleTracking();
+        this.broadcastChannel?.close();
+        this.broadcastChannel = null;
+    }
+    /**
+     * Save a new session
+     */
+    async save(session) {
+        const now = Date.now();
+        const fullSession = {
+            ...session,
+            connectedAt: now,
+            lastActiveAt: now,
+        };
+        await this.storage.set(this.storageKey, JSON.stringify(fullSession));
+        this.cachedSession = fullSession;
+        // Broadcast to other tabs
+        this.broadcast({ type: "session:updated", session: fullSession, timestamp: now });
+        // Start idle tracking if configured
+        this.startIdleTracking();
+        return fullSession;
+    }
+    /**
+     * Get the current session if valid
+     */
+    async get() {
+        if (this.cachedSession && this.isValid(this.cachedSession)) {
+            return this.cachedSession;
+        }
+        const raw = await this.storage.get(this.storageKey);
+        if (!raw)
+            return null;
+        try {
+            const session = JSON.parse(raw);
+            const validation = this.validate(session);
+            if (!validation.valid) {
+                if (validation.reason === "expired") {
+                    this.onSessionExpired?.(session);
+                }
+                else if (validation.reason === "invalid") {
+                    this.onSessionInvalid?.(session);
+                }
+                await this.clear();
+                return null;
+            }
+            this.cachedSession = session;
+            return session;
+        }
+        catch {
+            await this.clear();
+            return null;
+        }
+    }
+    /**
+     * Validate a session and return detailed result
+     */
+    validate(session) {
+        if (!session.walletId || !session.accounts?.length) {
+            return { valid: false, reason: "invalid" };
+        }
+        const age = Date.now() - session.connectedAt;
+        if (age > this.maxAge) {
+            return { valid: false, reason: "expired" };
+        }
+        return { valid: true, session };
+    }
+    /**
+     * Update the last active timestamp
+     */
+    async touch() {
+        const session = await this.get();
+        if (!session)
+            return;
+        session.lastActiveAt = Date.now();
+        await this.storage.set(this.storageKey, JSON.stringify(session));
+        this.cachedSession = session;
+    }
+    /**
+     * Update session data (e.g., accounts changed)
+     */
+    async update(updates) {
+        const session = await this.get();
+        if (!session)
+            return null;
+        const updatedSession = {
+            ...session,
+            ...updates,
+            lastActiveAt: Date.now(),
+        };
+        await this.storage.set(this.storageKey, JSON.stringify(updatedSession));
+        this.cachedSession = updatedSession;
+        return updatedSession;
+    }
+    /**
+     * Clear the session
+     */
+    async clear() {
+        await this.storage.remove(this.storageKey);
+        this.cachedSession = null;
+        // Stop idle tracking
+        this.stopIdleTracking();
+        // Broadcast to other tabs
+        this.broadcast({ type: "session:cleared", timestamp: Date.now() });
+        this.onSessionCleared?.();
+    }
+    /**
+     * Check if a session is still valid (simple boolean check)
+     */
+    isValid(session) {
+        return this.validate(session).valid;
+    }
+    /**
+     * Check if we should auto-reconnect
+     */
+    shouldAutoReconnect() {
+        return this.autoReconnect;
+    }
+    /**
+     * Try to restore a previous session
+     * Returns the session if valid and autoReconnect is enabled
+     */
+    async tryRestore() {
+        if (!this.autoReconnect)
+            return null;
+        const session = await this.get();
+        if (session) {
+            this.onSessionRestored?.(session);
+            // Start idle tracking for restored session
+            this.startIdleTracking();
+            return session;
+        }
+        return null;
+    }
+    /**
+     * Get session age in milliseconds
+     */
+    async getAge() {
+        const session = await this.get();
+        if (!session)
+            return null;
+        return Date.now() - session.connectedAt;
+    }
+    /**
+     * Get time since last activity
+     */
+    async getIdleTime() {
+        const session = await this.get();
+        if (!session)
+            return null;
+        return Date.now() - session.lastActiveAt;
+    }
+    /**
+     * Check if session exists (without full validation)
+     */
+    async exists() {
+        const raw = await this.storage.get(this.storageKey);
+        return raw !== null;
+    }
+}
+exports.SessionManager = SessionManager;
+//# sourceMappingURL=session.js.map

package/build/helpers/session.js.map

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

package/build/helpers/simulation.d.ts

@@ -0,0 +1,128 @@
+import { Transaction, Network, Account } from "../types";
+/**
+ * Gas estimation result
+ */
+export interface GasEstimate {
+    /** Estimated gas in gas units */
+    gas: string;
+    /** Estimated gas in TGas for display */
+    tgas: number;
+    /** Estimated gas cost in NEAR */
+    gasCostNear: string;
+    /** Whether the account has enough balance */
+    canAfford: boolean;
+    /** Breakdown by action */
+    breakdown: ActionGasEstimate[];
+}
+/**
+ * Per-action gas estimate
+ */
+export interface ActionGasEstimate {
+    type: string;
+    methodName?: string;
+    gas: string;
+    tgas: number;
+}
+/**
+ * Simulation result for a transaction
+ */
+export interface SimulationResult {
+    /** Whether the simulation succeeded */
+    success: boolean;
+    /** Gas estimation */
+    gasEstimate: GasEstimate;
+    /** Total deposit required in yoctoNEAR */
+    totalDeposit: string;
+    /** Total deposit in NEAR for display */
+    totalDepositNear: string;
+    /** Storage deposit required */
+    storageDeposit?: string;
+    /** Logs from the simulation */
+    logs: string[];
+    /** Return value if any */
+    returnValue?: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** Warnings about the transaction */
+    warnings: SimulationWarning[];
+}
+/**
+ * Warning types for transaction simulation
+ */
+export type SimulationWarningType = "high_gas" | "high_deposit" | "low_balance" | "contract_not_found" | "method_not_found" | "access_key_limited" | "storage_staking" | "dangerous_action";
+/**
+ * Simulation warning
+ */
+export interface SimulationWarning {
+    type: SimulationWarningType;
+    message: string;
+    severity: "info" | "warning" | "error";
+}
+/**
+ * RPC provider for simulation
+ */
+export interface SimulationRpcProvider {
+    query<T>(params: {
+        request_type: string;
+        finality?: string;
+        account_id?: string;
+        method_name?: string;
+        args_base64?: string;
+    }): Promise<T>;
+    sendTransaction(signedTx: string): Promise<unknown>;
+}
+/**
+ * Transaction simulator
+ */
+export declare class TransactionSimulator {
+    private network;
+    private rpcEndpoint;
+    constructor(options?: {
+        network?: Network;
+        rpcEndpoint?: string;
+    });
+    /**
+     * Simulate a transaction and get gas estimates
+     */
+    simulate(transaction: Transaction, signerAccount: Account): Promise<SimulationResult>;
+    /**
+     * Estimate gas for a transaction
+     */
+    estimateGas(transaction: Transaction, signerAccount: Account): Promise<GasEstimate>;
+    /**
+     * Estimate gas for a single action
+     */
+    private estimateActionGas;
+    /**
+     * Calculate total deposit required
+     */
+    private calculateTotalDeposit;
+    /**
+     * Check for dangerous actions
+     */
+    private checkDangerousActions;
+    /**
+     * Simulate a function call via RPC view call
+     */
+    private simulateFunctionCall;
+    /**
+     * Get account balance
+     */
+    private getAccountBalance;
+    /**
+     * Format yoctoNEAR to NEAR
+     */
+    private formatNear;
+    /**
+     * Set network
+     */
+    setNetwork(network: Network): void;
+    /**
+     * Set custom RPC endpoint
+     */
+    setRpcEndpoint(endpoint: string): void;
+}
+/**
+ * Quick gas estimate without full simulation
+ */
+export declare function quickGasEstimate(transaction: Transaction): GasEstimate;