@tinycloudlabs/node-sdk 1.0.0

package/dist/storage/FileSessionStorage.js

@@ -0,0 +1,148 @@
+import { validatePersistedSessionData } from "@tinycloudlabs/sdk-core";
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from "fs";
+import { join } from "path";
+/**
+ * File-based session storage for Node.js.
+ *
+ * Sessions are persisted to the file system and survive process restarts.
+ * Suitable for:
+ * - CLI applications
+ * - Long-running server processes
+ * - Development environments
+ *
+ * @example
+ * ```typescript
+ * const storage = new FileSessionStorage("/tmp/tinycloud-sessions");
+ * await storage.save("0x123...", sessionData);
+ * // Session persists across process restarts
+ * ```
+ */
+export class FileSessionStorage {
+    /**
+     * Create a new FileSessionStorage.
+     *
+     * @param baseDir - Directory to store session files (default: ~/.tinycloud/sessions)
+     */
+    constructor(baseDir) {
+        this.baseDir = baseDir || this.getDefaultDir();
+        this.ensureDirectoryExists();
+    }
+    /**
+     * Get the default session storage directory.
+     */
+    getDefaultDir() {
+        const home = process.env.HOME || process.env.USERPROFILE || "/tmp";
+        return join(home, ".tinycloud", "sessions");
+    }
+    /**
+     * Ensure the storage directory exists.
+     */
+    ensureDirectoryExists() {
+        if (!existsSync(this.baseDir)) {
+            mkdirSync(this.baseDir, { recursive: true });
+        }
+    }
+    /**
+     * Get the file path for an address.
+     */
+    getFilePath(address) {
+        const normalizedAddress = address.toLowerCase();
+        // Use a hash of the address to avoid filesystem issues
+        const filename = `${normalizedAddress.replace("0x", "")}.json`;
+        return join(this.baseDir, filename);
+    }
+    /**
+     * Save a session for an address.
+     */
+    async save(address, session) {
+        const filePath = this.getFilePath(address);
+        const data = JSON.stringify(session, null, 2);
+        writeFileSync(filePath, data, "utf-8");
+    }
+    /**
+     * Load a session for an address.
+     */
+    async load(address) {
+        const filePath = this.getFilePath(address);
+        if (!existsSync(filePath)) {
+            return null;
+        }
+        try {
+            const data = readFileSync(filePath, "utf-8");
+            const parsed = JSON.parse(data);
+            // Validate loaded data against schema
+            const validation = validatePersistedSessionData(parsed);
+            if (!validation.ok) {
+                console.warn(`Invalid session data for ${address}:`, validation.error.message);
+                // Clean up invalid session
+                unlinkSync(filePath);
+                return null;
+            }
+            const session = validation.data;
+            // Check if session is expired
+            const expiresAt = new Date(session.expiresAt);
+            if (expiresAt < new Date()) {
+                // Clean up expired session
+                unlinkSync(filePath);
+                return null;
+            }
+            return session;
+        }
+        catch (error) {
+            // Invalid JSON or read error - remove the file
+            try {
+                unlinkSync(filePath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return null;
+        }
+    }
+    /**
+     * Clear a session for an address.
+     */
+    async clear(address) {
+        const filePath = this.getFilePath(address);
+        if (existsSync(filePath)) {
+            unlinkSync(filePath);
+        }
+    }
+    /**
+     * Check if a session exists for an address.
+     */
+    exists(address) {
+        const filePath = this.getFilePath(address);
+        if (!existsSync(filePath)) {
+            return false;
+        }
+        try {
+            const data = readFileSync(filePath, "utf-8");
+            const session = JSON.parse(data);
+            // Check if session is expired
+            const expiresAt = new Date(session.expiresAt);
+            if (expiresAt < new Date()) {
+                // Clean up expired session
+                unlinkSync(filePath);
+                return false;
+            }
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Check if file system storage is available.
+     */
+    isAvailable() {
+        try {
+            this.ensureDirectoryExists();
+            return existsSync(this.baseDir);
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=FileSessionStorage.js.map

package/dist/storage/FileSessionStorage.js.map

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

package/dist/storage/MemorySessionStorage.d.ts

@@ -0,0 +1,49 @@
+import { ISessionStorage, PersistedSessionData } from "@tinycloudlabs/sdk-core";
+/**
+ * In-memory session storage for Node.js.
+ *
+ * Sessions are stored in memory and lost when the process exits.
+ * Suitable for:
+ * - Development and testing
+ * - Stateless server deployments
+ * - Short-lived processes
+ *
+ * @example
+ * ```typescript
+ * const storage = new MemorySessionStorage();
+ * await storage.save("0x123...", sessionData);
+ * const session = await storage.load("0x123...");
+ * ```
+ */
+export declare class MemorySessionStorage implements ISessionStorage {
+    private sessions;
+    /**
+     * Save a session for an address.
+     */
+    save(address: string, session: PersistedSessionData): Promise<void>;
+    /**
+     * Load a session for an address.
+     */
+    load(address: string): Promise<PersistedSessionData | null>;
+    /**
+     * Clear a session for an address.
+     */
+    clear(address: string): Promise<void>;
+    /**
+     * Check if a session exists for an address.
+     */
+    exists(address: string): boolean;
+    /**
+     * Memory storage is always available.
+     */
+    isAvailable(): boolean;
+    /**
+     * Clear all sessions.
+     */
+    clearAll(): void;
+    /**
+     * Get the number of stored sessions.
+     */
+    size(): number;
+}
+//# sourceMappingURL=MemorySessionStorage.d.ts.map

package/dist/storage/MemorySessionStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemorySessionStorage.d.ts","sourceRoot":"","sources":["../../src/storage/MemorySessionStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,OAAO,CAAC,QAAQ,CAAgD;IAEhE;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAkBjE;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAkBhC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,IAAI,IAAI,MAAM;CAGf"}

package/dist/storage/MemorySessionStorage.js

@@ -0,0 +1,88 @@
+/**
+ * In-memory session storage for Node.js.
+ *
+ * Sessions are stored in memory and lost when the process exits.
+ * Suitable for:
+ * - Development and testing
+ * - Stateless server deployments
+ * - Short-lived processes
+ *
+ * @example
+ * ```typescript
+ * const storage = new MemorySessionStorage();
+ * await storage.save("0x123...", sessionData);
+ * const session = await storage.load("0x123...");
+ * ```
+ */
+export class MemorySessionStorage {
+    constructor() {
+        this.sessions = new Map();
+    }
+    /**
+     * Save a session for an address.
+     */
+    async save(address, session) {
+        const normalizedAddress = address.toLowerCase();
+        this.sessions.set(normalizedAddress, session);
+    }
+    /**
+     * Load a session for an address.
+     */
+    async load(address) {
+        const normalizedAddress = address.toLowerCase();
+        const session = this.sessions.get(normalizedAddress);
+        if (!session) {
+            return null;
+        }
+        // Check if session is expired
+        const expiresAt = new Date(session.expiresAt);
+        if (expiresAt < new Date()) {
+            this.sessions.delete(normalizedAddress);
+            return null;
+        }
+        return session;
+    }
+    /**
+     * Clear a session for an address.
+     */
+    async clear(address) {
+        const normalizedAddress = address.toLowerCase();
+        this.sessions.delete(normalizedAddress);
+    }
+    /**
+     * Check if a session exists for an address.
+     */
+    exists(address) {
+        const normalizedAddress = address.toLowerCase();
+        const session = this.sessions.get(normalizedAddress);
+        if (!session) {
+            return false;
+        }
+        // Check if session is expired
+        const expiresAt = new Date(session.expiresAt);
+        if (expiresAt < new Date()) {
+            this.sessions.delete(normalizedAddress);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Memory storage is always available.
+     */
+    isAvailable() {
+        return true;
+    }
+    /**
+     * Clear all sessions.
+     */
+    clearAll() {
+        this.sessions.clear();
+    }
+    /**
+     * Get the number of stored sessions.
+     */
+    size() {
+        return this.sessions.size;
+    }
+}
+//# sourceMappingURL=MemorySessionStorage.js.map

package/dist/storage/MemorySessionStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemorySessionStorage.js","sourceRoot":"","sources":["../../src/storage/MemorySessionStorage.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QACU,aAAQ,GAAsC,IAAI,GAAG,EAAE,CAAC;IAgFlE,CAAC;IA9EC;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,OAA6B;QACvD,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe;QACxB,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAED,8BAA8B;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,SAAS,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe;QACzB,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAe;QACpB,MAAM,iBAAiB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAErD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QAED,8BAA8B;QAC9B,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,SAAS,GAAG,IAAI,IAAI,EAAE,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;YACxC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@tinycloudlabs/node-sdk",
+  "version": "1.0.0",
+  "description": "TinyCloud SDK for Node.js with configurable authorization strategies",
+  "author": "TinyCloud, Inc.",
+  "license": "EGPL",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@tinycloudlabs/sdk-core": "^1.0.0",
+    "@tinycloudlabs/node-sdk-wasm": "^1.0.0",
+    "@tinycloudlabs/web-core": "^1.0.0",
+    "siwe": "^2.3.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "typescript": "^5.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tinycloudlabs/web-sdk"
+  }
+}