opencode-cursor-proxy 1.0.1

package/dist/lib/storage.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Credential Storage
+ *
+ * File-based credential storage for cross-platform compatibility.
+ * Stores authentication tokens in a JSON file.
+ */
+export interface StoredCredentials {
+    accessToken?: string;
+    refreshToken?: string;
+    apiKey?: string;
+}
+export interface CredentialManager {
+    getAccessToken(): Promise<string | undefined>;
+    getRefreshToken(): Promise<string | undefined>;
+    getApiKey(): Promise<string | undefined>;
+    getAllCredentials(): Promise<StoredCredentials>;
+    setAuthentication(accessToken: string, refreshToken: string, apiKey?: string): Promise<void>;
+    clearAuthentication(): Promise<void>;
+    getStoragePath(): string;
+}
+/**
+ * FileCredentialManager - File-based credential storage
+ *
+ * Storage Locations:
+ * - Windows: %APPDATA%\<TitleCase(domain)>\auth.json
+ * - macOS: ~/.<domain>/auth.json
+ * - Linux: $XDG_CONFIG_HOME/<domain>/auth.json or ~/.config/<domain>/auth.json
+ */
+export declare class FileCredentialManager implements CredentialManager {
+    private cachedAccessToken;
+    private cachedRefreshToken;
+    private cachedApiKey;
+    private authFilePath;
+    constructor(domain?: string);
+    private toWindowsTitleCase;
+    private getAuthFilePath;
+    getStoragePath(): string;
+    private ensureDirectoryExists;
+    private readAuthData;
+    private writeAuthData;
+    setAuthentication(accessToken: string, refreshToken: string, apiKey?: string): Promise<void>;
+    getAccessToken(): Promise<string | undefined>;
+    getRefreshToken(): Promise<string | undefined>;
+    getApiKey(): Promise<string | undefined>;
+    getAllCredentials(): Promise<StoredCredentials>;
+    clearAuthentication(): Promise<void>;
+    /**
+     * Clear cached values to force reload from disk
+     */
+    clearCache(): void;
+}
+/**
+ * Create a credential manager for the specified domain
+ */
+export declare function createCredentialManager(domain?: string): FileCredentialManager;

package/dist/lib/storage.js

@@ -0,0 +1,159 @@
+/**
+ * Credential Storage
+ *
+ * File-based credential storage for cross-platform compatibility.
+ * Stores authentication tokens in a JSON file.
+ */
+import { platform, homedir } from "node:os";
+import { join, dirname } from "node:path";
+import { promises as fs } from "node:fs";
+/**
+ * FileCredentialManager - File-based credential storage
+ *
+ * Storage Locations:
+ * - Windows: %APPDATA%\<TitleCase(domain)>\auth.json
+ * - macOS: ~/.<domain>/auth.json
+ * - Linux: $XDG_CONFIG_HOME/<domain>/auth.json or ~/.config/<domain>/auth.json
+ */
+export class FileCredentialManager {
+    cachedAccessToken = null;
+    cachedRefreshToken = null;
+    cachedApiKey = null;
+    authFilePath;
+    constructor(domain = "cursor") {
+        this.authFilePath = this.getAuthFilePath(domain);
+    }
+    toWindowsTitleCase(domain) {
+        if (domain.length === 0)
+            return domain;
+        return domain.charAt(0).toUpperCase() + domain.slice(1).toLowerCase();
+    }
+    getAuthFilePath(domain) {
+        const currentPlatform = platform();
+        switch (currentPlatform) {
+            case "win32": {
+                const appData = process.env.APPDATA || join(homedir(), "AppData", "Roaming");
+                const folder = this.toWindowsTitleCase(domain);
+                return join(appData, folder, "auth.json");
+            }
+            case "darwin":
+                return join(homedir(), `.${domain}`, "auth.json");
+            default: {
+                const configDir = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+                return join(configDir, domain, "auth.json");
+            }
+        }
+    }
+    getStoragePath() {
+        return this.authFilePath;
+    }
+    async ensureDirectoryExists() {
+        const dir = dirname(this.authFilePath);
+        try {
+            await fs.mkdir(dir, { recursive: true });
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
+    }
+    async readAuthData() {
+        try {
+            const data = await fs.readFile(this.authFilePath, "utf-8");
+            return JSON.parse(data);
+        }
+        catch (error) {
+            if (error.code === "ENOENT")
+                return null;
+            return null;
+        }
+    }
+    async writeAuthData(data) {
+        await this.ensureDirectoryExists();
+        await fs.writeFile(this.authFilePath, JSON.stringify(data, null, 2), "utf-8");
+    }
+    async setAuthentication(accessToken, refreshToken, apiKey) {
+        await this.writeAuthData({ accessToken, refreshToken, apiKey });
+        this.cachedAccessToken = accessToken;
+        this.cachedRefreshToken = refreshToken;
+        this.cachedApiKey = apiKey ?? null;
+    }
+    async getAccessToken() {
+        if (this.cachedAccessToken)
+            return this.cachedAccessToken;
+        const authData = await this.readAuthData();
+        if (authData?.accessToken) {
+            this.cachedAccessToken = authData.accessToken;
+            this.cachedRefreshToken = authData.refreshToken ?? null;
+            this.cachedApiKey = authData.apiKey ?? null;
+            return authData.accessToken;
+        }
+        return undefined;
+    }
+    async getRefreshToken() {
+        if (this.cachedRefreshToken)
+            return this.cachedRefreshToken;
+        const authData = await this.readAuthData();
+        if (authData?.refreshToken) {
+            this.cachedAccessToken = authData.accessToken ?? null;
+            this.cachedRefreshToken = authData.refreshToken;
+            this.cachedApiKey = authData.apiKey ?? null;
+            return authData.refreshToken;
+        }
+        return undefined;
+    }
+    async getApiKey() {
+        if (this.cachedApiKey)
+            return this.cachedApiKey;
+        const authData = await this.readAuthData();
+        if (authData?.apiKey) {
+            this.cachedApiKey = authData.apiKey;
+            return authData.apiKey;
+        }
+        return undefined;
+    }
+    async getAllCredentials() {
+        if (this.cachedAccessToken !== null && this.cachedRefreshToken !== null) {
+            return {
+                accessToken: this.cachedAccessToken || undefined,
+                refreshToken: this.cachedRefreshToken || undefined,
+                apiKey: this.cachedApiKey || undefined,
+            };
+        }
+        const authData = await this.readAuthData();
+        if (authData) {
+            this.cachedAccessToken = authData.accessToken || null;
+            this.cachedRefreshToken = authData.refreshToken || null;
+            this.cachedApiKey = authData.apiKey || null;
+            return authData;
+        }
+        return {};
+    }
+    async clearAuthentication() {
+        try {
+            await fs.unlink(this.authFilePath);
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        this.cachedAccessToken = null;
+        this.cachedRefreshToken = null;
+        this.cachedApiKey = null;
+    }
+    /**
+     * Clear cached values to force reload from disk
+     */
+    clearCache() {
+        this.cachedAccessToken = null;
+        this.cachedRefreshToken = null;
+        this.cachedApiKey = null;
+    }
+}
+/**
+ * Create a credential manager for the specified domain
+ */
+export function createCredentialManager(domain = "cursor") {
+    return new FileCredentialManager(domain);
+}
+//# sourceMappingURL=storage.js.map

package/dist/lib/storage.js.map

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

package/dist/lib/utils/cache.d.ts

@@ -0,0 +1,131 @@
+/**
+ * LRU Cache Utilities
+ *
+ * Provides memory-efficient caching with:
+ * - Least Recently Used eviction
+ * - Time-based expiration (TTL)
+ * - Size limits
+ * - Optional dispose callbacks
+ */
+export interface LRUCacheOptions<V> {
+    /** Maximum number of items in cache */
+    max: number;
+    /** Time-to-live in milliseconds (0 = no expiration) */
+    ttl?: number;
+    /** Callback when an item is evicted */
+    onEvict?: (key: string, value: V) => void;
+}
+/**
+ * Simple LRU Cache with TTL support
+ *
+ * @example
+ * ```ts
+ * const cache = new LRUCache<User>({ max: 100, ttl: 60000 });
+ *
+ * cache.set("user:1", { id: 1, name: "Alice" });
+ * const user = cache.get("user:1");
+ *
+ * // With dispose callback
+ * const sessions = new LRUCache<Session>({
+ *   max: 50,
+ *   ttl: 15 * 60 * 1000,
+ *   onEvict: (key, session) => session.close(),
+ * });
+ * ```
+ */
+export declare class LRUCache<V> {
+    private cache;
+    private max;
+    private ttl;
+    private onEvict?;
+    constructor(options: LRUCacheOptions<V>);
+    /**
+     * Get an item from the cache
+     * Returns undefined if not found or expired
+     */
+    get(key: string): V | undefined;
+    /**
+     * Set an item in the cache
+     */
+    set(key: string, value: V, ttl?: number): this;
+    /**
+     * Check if a key exists and is not expired
+     */
+    has(key: string): boolean;
+    /**
+     * Delete an item from the cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Clear all items from the cache
+     */
+    clear(): void;
+    /**
+     * Get the number of items in the cache
+     */
+    get size(): number;
+    /**
+     * Get all keys in the cache
+     */
+    keys(): IterableIterator<string>;
+    /**
+     * Get all values in the cache (excluding expired)
+     */
+    values(): IterableIterator<V>;
+    /**
+     * Get all entries in the cache (excluding expired)
+     */
+    entries(): IterableIterator<[string, V]>;
+    /**
+     * Remove expired entries
+     */
+    prune(): number;
+    /**
+     * Get cache statistics
+     */
+    stats(): {
+        size: number;
+        max: number;
+        ttl: number;
+    };
+}
+/**
+ * A Map that automatically evicts oldest entries when max size is reached
+ *
+ * @example
+ * ```ts
+ * const blobs = new BoundedMap<Uint8Array>(1000);
+ * blobs.set("key", new Uint8Array([1, 2, 3]));
+ * ```
+ */
+export declare class BoundedMap<V> {
+    private map;
+    private max;
+    private onEvict?;
+    constructor(max: number, onEvict?: (key: string, value: V) => void);
+    get(key: string): V | undefined;
+    set(key: string, value: V): this;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+    keys(): IterableIterator<string>;
+    values(): IterableIterator<V>;
+    entries(): IterableIterator<[string, V]>;
+    forEach(callback: (value: V, key: string, map: BoundedMap<V>) => void): void;
+}
+/**
+ * Memoize an async function with cache
+ *
+ * @example
+ * ```ts
+ * const fetchUser = memoizeAsync(
+ *   async (id: string) => await api.getUser(id),
+ *   { max: 100, ttl: 60000 }
+ * );
+ *
+ * const user = await fetchUser("user:1"); // Fetches from API
+ * const cached = await fetchUser("user:1"); // Returns cached value
+ * ```
+ */
+export declare function memoizeAsync<T>(fn: (key: string) => Promise<T>, options: LRUCacheOptions<T>): (key: string) => Promise<T>;

package/dist/lib/utils/cache.js

@@ -0,0 +1,297 @@
+/**
+ * LRU Cache Utilities
+ *
+ * Provides memory-efficient caching with:
+ * - Least Recently Used eviction
+ * - Time-based expiration (TTL)
+ * - Size limits
+ * - Optional dispose callbacks
+ */
+// --- LRU Cache Implementation ---
+/**
+ * Simple LRU Cache with TTL support
+ *
+ * @example
+ * ```ts
+ * const cache = new LRUCache<User>({ max: 100, ttl: 60000 });
+ *
+ * cache.set("user:1", { id: 1, name: "Alice" });
+ * const user = cache.get("user:1");
+ *
+ * // With dispose callback
+ * const sessions = new LRUCache<Session>({
+ *   max: 50,
+ *   ttl: 15 * 60 * 1000,
+ *   onEvict: (key, session) => session.close(),
+ * });
+ * ```
+ */
+export class LRUCache {
+    cache;
+    max;
+    ttl;
+    onEvict;
+    constructor(options) {
+        this.cache = new Map();
+        this.max = options.max;
+        this.ttl = options.ttl ?? 0;
+        this.onEvict = options.onEvict;
+    }
+    /**
+     * Get an item from the cache
+     * Returns undefined if not found or expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return undefined;
+        }
+        // Check expiration
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            this.delete(key);
+            return undefined;
+        }
+        // Move to end (most recently used)
+        this.cache.delete(key);
+        this.cache.set(key, entry);
+        return entry.value;
+    }
+    /**
+     * Set an item in the cache
+     */
+    set(key, value, ttl) {
+        // Delete existing entry if present
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        // Evict oldest entries if at capacity
+        while (this.cache.size >= this.max) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.delete(oldestKey);
+            }
+        }
+        // Calculate expiration
+        const effectiveTtl = ttl ?? this.ttl;
+        const expiresAt = effectiveTtl > 0 ? Date.now() + effectiveTtl : null;
+        // Add new entry
+        this.cache.set(key, { value, expiresAt });
+        return this;
+    }
+    /**
+     * Check if a key exists and is not expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            this.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Delete an item from the cache
+     */
+    delete(key) {
+        const entry = this.cache.get(key);
+        if (entry && this.onEvict) {
+            this.onEvict(key, entry.value);
+        }
+        return this.cache.delete(key);
+    }
+    /**
+     * Clear all items from the cache
+     */
+    clear() {
+        if (this.onEvict) {
+            for (const [key, entry] of this.cache) {
+                this.onEvict(key, entry.value);
+            }
+        }
+        this.cache.clear();
+    }
+    /**
+     * Get the number of items in the cache
+     */
+    get size() {
+        return this.cache.size;
+    }
+    /**
+     * Get all keys in the cache
+     */
+    keys() {
+        return this.cache.keys();
+    }
+    /**
+     * Get all values in the cache (excluding expired)
+     */
+    *values() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache) {
+            if (entry.expiresAt !== null && now > entry.expiresAt) {
+                this.delete(key);
+                continue;
+            }
+            yield entry.value;
+        }
+    }
+    /**
+     * Get all entries in the cache (excluding expired)
+     */
+    *entries() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache) {
+            if (entry.expiresAt !== null && now > entry.expiresAt) {
+                this.delete(key);
+                continue;
+            }
+            yield [key, entry.value];
+        }
+    }
+    /**
+     * Remove expired entries
+     */
+    prune() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [key, entry] of this.cache) {
+            if (entry.expiresAt !== null && now > entry.expiresAt) {
+                this.delete(key);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /**
+     * Get cache statistics
+     */
+    stats() {
+        return {
+            size: this.cache.size,
+            max: this.max,
+            ttl: this.ttl,
+        };
+    }
+}
+// --- Bounded Map (Size-Limited) ---
+/**
+ * A Map that automatically evicts oldest entries when max size is reached
+ *
+ * @example
+ * ```ts
+ * const blobs = new BoundedMap<Uint8Array>(1000);
+ * blobs.set("key", new Uint8Array([1, 2, 3]));
+ * ```
+ */
+export class BoundedMap {
+    map;
+    max;
+    onEvict;
+    constructor(max, onEvict) {
+        this.map = new Map();
+        this.max = max;
+        this.onEvict = onEvict;
+    }
+    get(key) {
+        return this.map.get(key);
+    }
+    set(key, value) {
+        // Delete existing if present
+        if (this.map.has(key)) {
+            this.map.delete(key);
+        }
+        // Evict oldest if at capacity
+        while (this.map.size >= this.max) {
+            const oldestKey = this.map.keys().next().value;
+            if (oldestKey !== undefined) {
+                const oldValue = this.map.get(oldestKey);
+                if (oldValue !== undefined && this.onEvict) {
+                    this.onEvict(oldestKey, oldValue);
+                }
+                this.map.delete(oldestKey);
+            }
+        }
+        this.map.set(key, value);
+        return this;
+    }
+    has(key) {
+        return this.map.has(key);
+    }
+    delete(key) {
+        const value = this.map.get(key);
+        if (value !== undefined && this.onEvict) {
+            this.onEvict(key, value);
+        }
+        return this.map.delete(key);
+    }
+    clear() {
+        if (this.onEvict) {
+            for (const [key, value] of this.map) {
+                this.onEvict(key, value);
+            }
+        }
+        this.map.clear();
+    }
+    get size() {
+        return this.map.size;
+    }
+    keys() {
+        return this.map.keys();
+    }
+    values() {
+        return this.map.values();
+    }
+    entries() {
+        return this.map.entries();
+    }
+    forEach(callback) {
+        this.map.forEach((value, key) => callback(value, key, this));
+    }
+}
+// --- Async Memoization ---
+/**
+ * Memoize an async function with cache
+ *
+ * @example
+ * ```ts
+ * const fetchUser = memoizeAsync(
+ *   async (id: string) => await api.getUser(id),
+ *   { max: 100, ttl: 60000 }
+ * );
+ *
+ * const user = await fetchUser("user:1"); // Fetches from API
+ * const cached = await fetchUser("user:1"); // Returns cached value
+ * ```
+ */
+export function memoizeAsync(fn, options) {
+    const cache = new LRUCache(options);
+    const pending = new Map();
+    return async (key) => {
+        // Return cached value if available
+        const cached = cache.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        // Return pending promise if already fetching
+        const pendingPromise = pending.get(key);
+        if (pendingPromise) {
+            return pendingPromise;
+        }
+        // Fetch and cache
+        const promise = fn(key)
+            .then((value) => {
+            cache.set(key, value);
+            pending.delete(key);
+            return value;
+        })
+            .catch((error) => {
+            pending.delete(key);
+            throw error;
+        });
+        pending.set(key, promise);
+        return promise;
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/lib/utils/cache.js.map

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