paygate-mcp 1.9.0 → 2.0.0

package/dist/redis-sync.js

@@ -0,0 +1,280 @@
+"use strict";
+/**
+ * RedisSync — Write-through cache adapter for distributed PayGate deployments.
+ *
+ * Keeps the existing in-memory KeyStore as the fast sync read path, while
+ * propagating all writes to Redis for cross-process shared state. On startup,
+ * loads existing state from Redis. Periodically refreshes local state from Redis
+ * to pick up changes made by other PayGate processes.
+ *
+ * Architecture:
+ *   Gate.evaluate() → reads from local KeyStore (sync, fast)
+ *   KeyStore.save() → writes to memory + triggers Redis write (async, fire-and-forget)
+ *   RedisPersistence.refresh() → pulls latest state from Redis → updates local KeyStore
+ *
+ * For credit deduction, uses a Redis Lua script to ensure atomicity across
+ * multiple PayGate instances (prevents double-spend race conditions).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisSync = void 0;
+const KEY_PREFIX = 'pg:key:';
+const KEY_SET = 'pg:keys';
+const META_KEY = 'pg:meta';
+/** Lua: atomic credit deduction — check + deduct + increment in one round trip */
+const DEDUCT_LUA = `
+local key = KEYS[1]
+local amount = tonumber(ARGV[1])
+local now = ARGV[2]
+
+local credits = tonumber(redis.call('HGET', key, 'credits') or '0')
+local active = redis.call('HGET', key, 'active')
+if active == '0' then return -1 end
+if credits < amount then return 0 end
+
+redis.call('HINCRBY', key, 'credits', -amount)
+redis.call('HINCRBY', key, 'totalSpent', amount)
+redis.call('HINCRBY', key, 'totalCalls', 1)
+redis.call('HSET', key, 'lastUsedAt', now)
+return 1
+`;
+/** Lua: atomic credit addition (top-up) */
+const TOPUP_LUA = `
+local key = KEYS[1]
+local amount = tonumber(ARGV[1])
+local active = redis.call('HGET', key, 'active')
+if active == '0' then return 0 end
+redis.call('HINCRBY', key, 'credits', amount)
+return 1
+`;
+class RedisSync {
+    redis;
+    store;
+    syncInterval = null;
+    syncMs;
+    constructor(redis, store, syncIntervalMs = 5000) {
+        this.redis = redis;
+        this.store = store;
+        this.syncMs = syncIntervalMs;
+    }
+    // ─── Lifecycle ─────────────────────────────────────────────────────────────
+    /**
+     * Initialize: connect to Redis and load existing state into local KeyStore.
+     */
+    async init() {
+        await this.redis.connect();
+        await this.redis.ping();
+        console.log('[paygate:redis] Connected to Redis');
+        await this.loadFromRedis();
+        // Start periodic refresh
+        this.syncInterval = setInterval(() => {
+            this.loadFromRedis().catch(err => {
+                console.error('[paygate:redis] Sync error:', err.message);
+            });
+        }, this.syncMs);
+    }
+    async destroy() {
+        if (this.syncInterval) {
+            clearInterval(this.syncInterval);
+            this.syncInterval = null;
+        }
+        await this.redis.disconnect();
+    }
+    // ─── Write-through operations ──────────────────────────────────────────────
+    /**
+     * Save a single key record to Redis. Called after local KeyStore mutations.
+     * Fire-and-forget (errors logged, not thrown).
+     */
+    async saveKey(record) {
+        try {
+            const redisKey = KEY_PREFIX + record.key;
+            await this.redis.hset(redisKey, ...this.recordToHash(record));
+            await this.redis.command('SADD', KEY_SET, record.key);
+        }
+        catch (err) {
+            console.error(`[paygate:redis] Save key error: ${err.message}`);
+        }
+    }
+    /**
+     * Save ALL keys to Redis. Called when local KeyStore.save() fires.
+     */
+    async saveAll() {
+        try {
+            const keys = this.store.listKeys();
+            // Use the internal key map via a dedicated export method
+            const data = this.store.keys;
+            if (!data)
+                return;
+            for (const [key, record] of data) {
+                const redisKey = KEY_PREFIX + key;
+                await this.redis.hset(redisKey, ...this.recordToHash(record));
+                await this.redis.command('SADD', KEY_SET, key);
+            }
+        }
+        catch (err) {
+            console.error(`[paygate:redis] SaveAll error: ${err.message}`);
+        }
+    }
+    /**
+     * Atomic credit deduction via Redis Lua. Returns true if deduction succeeded.
+     * Call this INSTEAD of store.deductCredits() in Redis mode.
+     */
+    async atomicDeduct(apiKey, amount) {
+        try {
+            const result = await this.redis.evalLua(DEDUCT_LUA, 1, KEY_PREFIX + apiKey, String(amount), new Date().toISOString());
+            if (result === 1) {
+                // Update local cache to reflect the deduction
+                const record = this.store.keys.get(apiKey);
+                if (record) {
+                    record.credits -= amount;
+                    record.totalSpent += amount;
+                    record.totalCalls++;
+                    record.lastUsedAt = new Date().toISOString();
+                }
+                return true;
+            }
+            return false;
+        }
+        catch (err) {
+            console.error(`[paygate:redis] Atomic deduct error: ${err.message}`);
+            // Fallback to local deduction if Redis is temporarily unavailable
+            return this.store.deductCredits(apiKey, amount);
+        }
+    }
+    /**
+     * Atomic credit top-up via Redis.
+     */
+    async atomicTopup(apiKey, amount) {
+        try {
+            const result = await this.redis.evalLua(TOPUP_LUA, 1, KEY_PREFIX + apiKey, String(amount));
+            if (result === 1) {
+                // Update local cache
+                const record = this.store.keys.get(apiKey);
+                if (record) {
+                    record.credits += amount;
+                }
+                return true;
+            }
+            return false;
+        }
+        catch (err) {
+            console.error(`[paygate:redis] Atomic topup error: ${err.message}`);
+            return this.store.addCredits(apiKey, amount);
+        }
+    }
+    /**
+     * Revoke a key in both local store and Redis.
+     */
+    async revokeKey(apiKey) {
+        const localResult = this.store.revokeKey(apiKey);
+        try {
+            await this.redis.hset(KEY_PREFIX + apiKey, 'active', '0');
+        }
+        catch (err) {
+            console.error(`[paygate:redis] Revoke error: ${err.message}`);
+        }
+        return localResult;
+    }
+    // ─── Load from Redis ───────────────────────────────────────────────────────
+    /**
+     * Load all keys from Redis into the local in-memory KeyStore.
+     * Merges with any locally-created keys (doesn't overwrite local-only keys).
+     */
+    async loadFromRedis() {
+        try {
+            const allKeyIds = await this.redis.command('SMEMBERS', KEY_SET);
+            if (!allKeyIds || allKeyIds.length === 0) {
+                // No keys in Redis — push local state up if we have any
+                await this.pushLocalToRedis();
+                return;
+            }
+            let loaded = 0;
+            for (const keyId of allKeyIds) {
+                const hash = await this.redis.hgetall(KEY_PREFIX + keyId);
+                if (!hash || !hash.key)
+                    continue;
+                const record = this.hashToRecord(hash);
+                if (!record)
+                    continue;
+                // Write directly into the local store's map
+                const localKeys = this.store.keys;
+                localKeys.set(record.key, record);
+                loaded++;
+            }
+            if (loaded > 0) {
+                console.log(`[paygate:redis] Synced ${loaded} key(s) from Redis`);
+            }
+        }
+        catch (err) {
+            console.error(`[paygate:redis] Load error: ${err.message}`);
+        }
+    }
+    /**
+     * Push local KeyStore state to Redis (used when Redis is empty on first connect).
+     */
+    async pushLocalToRedis() {
+        const localKeys = this.store.keys;
+        if (localKeys.size === 0)
+            return;
+        for (const [key, record] of localKeys) {
+            const redisKey = KEY_PREFIX + key;
+            await this.redis.hset(redisKey, ...this.recordToHash(record));
+            await this.redis.command('SADD', KEY_SET, key);
+        }
+        console.log(`[paygate:redis] Pushed ${localKeys.size} local key(s) to Redis`);
+    }
+    // ─── Serialization ─────────────────────────────────────────────────────────
+    recordToHash(record) {
+        const fields = [];
+        fields.push('key', record.key);
+        fields.push('name', record.name);
+        fields.push('credits', String(record.credits));
+        fields.push('totalSpent', String(record.totalSpent));
+        fields.push('totalCalls', String(record.totalCalls));
+        fields.push('createdAt', record.createdAt);
+        fields.push('lastUsedAt', record.lastUsedAt || '');
+        fields.push('active', record.active ? '1' : '0');
+        fields.push('spendingLimit', String(record.spendingLimit));
+        fields.push('allowedTools', JSON.stringify(record.allowedTools));
+        fields.push('deniedTools', JSON.stringify(record.deniedTools));
+        fields.push('expiresAt', record.expiresAt || '');
+        fields.push('quota', record.quota ? JSON.stringify(record.quota) : '');
+        fields.push('tags', JSON.stringify(record.tags));
+        fields.push('ipAllowlist', JSON.stringify(record.ipAllowlist));
+        fields.push('quotaDailyCalls', String(record.quotaDailyCalls));
+        fields.push('quotaMonthlyCalls', String(record.quotaMonthlyCalls));
+        fields.push('quotaDailyCredits', String(record.quotaDailyCredits));
+        fields.push('quotaMonthlyCredits', String(record.quotaMonthlyCredits));
+        fields.push('quotaLastResetDay', record.quotaLastResetDay);
+        fields.push('quotaLastResetMonth', record.quotaLastResetMonth);
+        return fields;
+    }
+    hashToRecord(hash) {
+        if (!hash.key)
+            return null;
+        return {
+            key: hash.key,
+            name: hash.name || '',
+            credits: parseInt(hash.credits, 10) || 0,
+            totalSpent: parseInt(hash.totalSpent, 10) || 0,
+            totalCalls: parseInt(hash.totalCalls, 10) || 0,
+            createdAt: hash.createdAt || new Date().toISOString(),
+            lastUsedAt: hash.lastUsedAt || null,
+            active: hash.active !== '0',
+            spendingLimit: parseInt(hash.spendingLimit, 10) || 0,
+            allowedTools: hash.allowedTools ? JSON.parse(hash.allowedTools) : [],
+            deniedTools: hash.deniedTools ? JSON.parse(hash.deniedTools) : [],
+            expiresAt: hash.expiresAt || null,
+            quota: hash.quota ? JSON.parse(hash.quota) : undefined,
+            tags: hash.tags ? JSON.parse(hash.tags) : {},
+            ipAllowlist: hash.ipAllowlist ? JSON.parse(hash.ipAllowlist) : [],
+            quotaDailyCalls: parseInt(hash.quotaDailyCalls, 10) || 0,
+            quotaMonthlyCalls: parseInt(hash.quotaMonthlyCalls, 10) || 0,
+            quotaDailyCredits: parseInt(hash.quotaDailyCredits, 10) || 0,
+            quotaMonthlyCredits: parseInt(hash.quotaMonthlyCredits, 10) || 0,
+            quotaLastResetDay: hash.quotaLastResetDay || new Date().toISOString().slice(0, 10),
+            quotaLastResetMonth: hash.quotaLastResetMonth || new Date().toISOString().slice(0, 7),
+        };
+    }
+}
+exports.RedisSync = RedisSync;
+//# sourceMappingURL=redis-sync.js.map

package/dist/redis-sync.js.map

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

package/dist/server.d.ts

@@ -24,6 +24,7 @@ import { MetricsCollector } from './metrics';
 import { AnalyticsEngine } from './analytics';
 import { AlertEngine } from './alerts';
 import { TeamManager } from './teams';
+import { RedisSync } from './redis-sync';
 /** Union type for both proxy backends */
 type ProxyBackend = McpProxy | HttpMcpProxy;
 export declare class PayGateServer {
@@ -52,11 +53,13 @@ export declare class PayGateServer {
     readonly alerts: AlertEngine;
     /** Team/organization manager */
     readonly teams: TeamManager;
+    /** Redis sync adapter for distributed state (null if not using Redis) */
+    readonly redisSync: RedisSync | null;
     /** The active request handler — either proxy or router */
     private get handler();
     constructor(config: Partial<PayGateConfig> & {
         serverCommand: string;
-    }, adminKey?: string, statePath?: string, remoteUrl?: string, stripeWebhookSecret?: string, servers?: ServerBackendConfig[]);
+    }, adminKey?: string, statePath?: string, remoteUrl?: string, stripeWebhookSecret?: string, servers?: ServerBackendConfig[], redisUrl?: string);
     start(): Promise<{
         port: number;
         adminKey: string;

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -42,6 +42,8 @@ const dashboard_1 = require("./dashboard");
 const analytics_1 = require("./analytics");
 const alerts_1 = require("./alerts");
 const teams_1 = require("./teams");
+const redis_client_1 = require("./redis-client");
+const redis_sync_1 = require("./redis-sync");
 /** Max request body size: 1MB */
 const MAX_BODY_SIZE = 1_048_576;
 class PayGateServer {
@@ -70,11 +72,13 @@ class PayGateServer {
     alerts;
     /** Team/organization manager */
     teams;
+    /** Redis sync adapter for distributed state (null if not using Redis) */
+    redisSync = null;
     /** The active request handler — either proxy or router */
     get handler() {
         return (this.router || this.proxy);
     }
-    constructor(config, adminKey, statePath, remoteUrl, stripeWebhookSecret, servers) {
+    constructor(config, adminKey, statePath, remoteUrl, stripeWebhookSecret, servers, redisUrl) {
         this.config = { ...types_1.DEFAULT_CONFIG, ...config };
         this.adminKey = adminKey || `admin_${require('crypto').randomBytes(16).toString('hex')}`;
         this.gate = new gate_1.Gate(this.config, statePath);
@@ -147,8 +151,19 @@ class PayGateServer {
         this.gate.teamRecorder = (apiKey, credits) => {
             this.teams.recordUsage(apiKey, credits);
         };
+        // Redis distributed state (if configured)
+        if (redisUrl) {
+            const redisOpts = (0, redis_client_1.parseRedisUrl)(redisUrl);
+            const redisClient = new redis_client_1.RedisClient(redisOpts);
+            this.redisSync = new redis_sync_1.RedisSync(redisClient, this.gate.store);
+        }
     }
     async start() {
+        // Initialize Redis sync before starting (loads state from Redis)
+        if (this.redisSync) {
+            await this.redisSync.init();
+            console.log('[paygate] Redis distributed state enabled');
+        }
         await this.handler.start();
         return new Promise((resolve, reject) => {
             this.server = (0, http_1.createServer)(async (req, res) => {
@@ -567,6 +582,7 @@ class PayGateServer {
             },
             shadowMode: this.config.shadowMode,
             oauth: !!this.oauth,
+            redis: !!this.redisSync,
         }));
     }
     // ─── /status — Dashboard ────────────────────────────────────────────────────
@@ -1937,6 +1953,9 @@ class PayGateServer {
         this.oauth?.destroy();
         this.sessions.destroy();
         this.audit.destroy();
+        if (this.redisSync) {
+            await this.redisSync.destroy();
+        }
         if (this.server) {
             return new Promise((resolve) => {
                 this.server.close(() => resolve());