paygate-mcp 1.9.0 → 2.1.0

package/dist/redis-client.js

@@ -0,0 +1,341 @@
+"use strict";
+/**
+ * RedisClient — Minimal zero-dependency Redis client using raw RESP protocol.
+ *
+ * Implements just enough of the Redis protocol for PayGate's needs:
+ * SET, GET, DEL, INCR, INCRBY, DECRBY, EXPIRE, PEXPIRE, EXISTS,
+ * HSET, HGET, HGETALL, HDEL, EVALSHA/script execution (Lua),
+ * ZADD, ZRANGEBYSCORE, ZREMRANGEBYSCORE, ZCARD,
+ * SCAN, KEYS, INFO, PING, AUTH, SELECT.
+ *
+ * Uses Node.js net.Socket (built-in, zero deps). Supports auth and db selection.
+ * Connection is lazy — established on first command.
+ *
+ * NOTE: The `evalLua` method uses Redis EVAL command to execute server-side
+ * Lua scripts for atomic operations. These scripts are hardcoded within
+ * PayGate (not user-provided) and are essential for atomic credit deduction
+ * and rate limiting in distributed deployments.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisClient = void 0;
+exports.parseRedisUrl = parseRedisUrl;
+const net_1 = require("net");
+/**
+ * Parse a redis:// URL into connection options.
+ * Format: redis://[:password@]host[:port][/db]
+ */
+function parseRedisUrl(url) {
+    const parsed = new URL(url);
+    return {
+        host: parsed.hostname || '127.0.0.1',
+        port: parseInt(parsed.port, 10) || 6379,
+        password: parsed.password || undefined,
+        db: parsed.pathname && parsed.pathname.length > 1
+            ? parseInt(parsed.pathname.slice(1), 10) || 0
+            : 0,
+    };
+}
+class RedisClient {
+    socket = null;
+    connected = false;
+    connecting = false;
+    queue = [];
+    buffer = Buffer.alloc(0);
+    opts;
+    closed = false;
+    constructor(opts) {
+        this.opts = {
+            host: opts.host,
+            port: opts.port,
+            password: opts.password || '',
+            db: opts.db || 0,
+            connectTimeout: opts.connectTimeout || 5000,
+            commandTimeout: opts.commandTimeout || 10000,
+        };
+    }
+    // ─── Public API ────────────────────────────────────────────────────────────
+    async ping() {
+        return (await this.command('PING'));
+    }
+    async set(key, value, exSeconds) {
+        if (exSeconds && exSeconds > 0) {
+            return (await this.command('SET', key, value, 'EX', String(exSeconds)));
+        }
+        return (await this.command('SET', key, value));
+    }
+    async get(key) {
+        return (await this.command('GET', key));
+    }
+    async del(...keys) {
+        return (await this.command('DEL', ...keys));
+    }
+    async incr(key) {
+        return (await this.command('INCR', key));
+    }
+    async incrby(key, amount) {
+        return (await this.command('INCRBY', key, String(amount)));
+    }
+    async decrby(key, amount) {
+        return (await this.command('DECRBY', key, String(amount)));
+    }
+    async exists(key) {
+        return (await this.command('EXISTS', key));
+    }
+    async expire(key, seconds) {
+        return (await this.command('EXPIRE', key, String(seconds)));
+    }
+    async pexpire(key, ms) {
+        return (await this.command('PEXPIRE', key, String(ms)));
+    }
+    // ─── Hash commands ─────────────────────────────────────────────────────────
+    async hset(key, ...fieldValues) {
+        return (await this.command('HSET', key, ...fieldValues));
+    }
+    async hget(key, field) {
+        return (await this.command('HGET', key, field));
+    }
+    async hgetall(key) {
+        const reply = (await this.command('HGETALL', key));
+        const result = {};
+        if (Array.isArray(reply)) {
+            for (let i = 0; i < reply.length; i += 2) {
+                result[reply[i]] = reply[i + 1];
+            }
+        }
+        return result;
+    }
+    async hdel(key, ...fields) {
+        return (await this.command('HDEL', key, ...fields));
+    }
+    // ─── Sorted set commands ───────────────────────────────────────────────────
+    async zadd(key, score, member) {
+        return (await this.command('ZADD', key, String(score), member));
+    }
+    async zrangebyscore(key, min, max) {
+        return (await this.command('ZRANGEBYSCORE', key, String(min), String(max)));
+    }
+    async zremrangebyscore(key, min, max) {
+        return (await this.command('ZREMRANGEBYSCORE', key, String(min), String(max)));
+    }
+    async zcard(key) {
+        return (await this.command('ZCARD', key));
+    }
+    // ─── Lua scripting (for atomic operations) ─────────────────────────────────
+    /**
+     * Execute a server-side Lua script atomically. Used internally by PayGate
+     * for atomic credit deduction and rate limiting. Scripts are hardcoded
+     * constants, never user-provided input.
+     */
+    async evalLua(script, numkeys, ...keysAndArgs) {
+        return this.command('EVAL', script, String(numkeys), ...keysAndArgs);
+    }
+    // ─── Scan ──────────────────────────────────────────────────────────────────
+    async scan(cursor, pattern, count = 100) {
+        const reply = (await this.command('SCAN', cursor, 'MATCH', pattern, 'COUNT', String(count)));
+        return reply;
+    }
+    /**
+     * Scan all keys matching a pattern. Iterates until cursor returns "0".
+     */
+    async scanAll(pattern, count = 100) {
+        const keys = [];
+        let cursor = '0';
+        do {
+            const [next, batch] = await this.scan(cursor, pattern, count);
+            cursor = next;
+            keys.push(...batch);
+        } while (cursor !== '0');
+        return keys;
+    }
+    // ─── Connection management ─────────────────────────────────────────────────
+    async connect() {
+        if (this.connected)
+            return;
+        if (this.connecting) {
+            return new Promise((resolve, reject) => {
+                const check = setInterval(() => {
+                    if (this.connected) {
+                        clearInterval(check);
+                        resolve();
+                    }
+                    if (this.closed) {
+                        clearInterval(check);
+                        reject(new Error('Connection closed'));
+                    }
+                }, 50);
+            });
+        }
+        this.connecting = true;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Redis connect timeout (${this.opts.connectTimeout}ms)`));
+                this.connecting = false;
+            }, this.opts.connectTimeout);
+            this.socket = new net_1.Socket();
+            this.socket.setNoDelay(true);
+            this.socket.on('data', (chunk) => {
+                this.buffer = Buffer.concat([this.buffer, chunk]);
+                this.processBuffer();
+            });
+            this.socket.on('error', (err) => {
+                clearTimeout(timer);
+                if (!this.connected) {
+                    this.connecting = false;
+                    reject(err);
+                }
+                // Reject all pending commands
+                for (const cmd of this.queue) {
+                    cmd.reject(err);
+                    if (cmd.timer)
+                        clearTimeout(cmd.timer);
+                }
+                this.queue = [];
+            });
+            this.socket.on('close', () => {
+                this.connected = false;
+                this.connecting = false;
+            });
+            this.socket.connect(this.opts.port, this.opts.host, async () => {
+                clearTimeout(timer);
+                this.connected = true;
+                this.connecting = false;
+                try {
+                    // AUTH if password provided
+                    if (this.opts.password) {
+                        await this.command('AUTH', this.opts.password);
+                    }
+                    // SELECT db if non-zero
+                    if (this.opts.db > 0) {
+                        await this.command('SELECT', String(this.opts.db));
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    reject(err);
+                }
+            });
+        });
+    }
+    async disconnect() {
+        this.closed = true;
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+        }
+        this.connected = false;
+        this.connecting = false;
+        // Reject pending commands
+        for (const cmd of this.queue) {
+            cmd.reject(new Error('Disconnected'));
+            if (cmd.timer)
+                clearTimeout(cmd.timer);
+        }
+        this.queue = [];
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    // ─── Core command execution ────────────────────────────────────────────────
+    async command(...args) {
+        if (!this.connected && !this.connecting) {
+            await this.connect();
+        }
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new Error(`Redis command timeout: ${args[0]}`));
+            }, this.opts.commandTimeout);
+            this.queue.push({ resolve, reject, timer });
+            // Encode RESP array
+            const encoded = this.encodeCommand(args);
+            this.socket.write(encoded);
+        });
+    }
+    // ─── RESP protocol encoding ────────────────────────────────────────────────
+    encodeCommand(args) {
+        let resp = `*${args.length}\r\n`;
+        for (const arg of args) {
+            const buf = Buffer.from(arg);
+            resp += `$${buf.length}\r\n${arg}\r\n`;
+        }
+        return resp;
+    }
+    // ─── RESP protocol decoding ────────────────────────────────────────────────
+    processBuffer() {
+        while (this.buffer.length > 0 && this.queue.length > 0) {
+            const result = this.parseReply(this.buffer, 0);
+            if (result === null)
+                break; // Incomplete data, wait for more
+            const [reply, consumed] = result;
+            this.buffer = this.buffer.subarray(consumed);
+            const cmd = this.queue.shift();
+            if (cmd.timer)
+                clearTimeout(cmd.timer);
+            if (reply instanceof Error) {
+                cmd.reject(reply);
+            }
+            else {
+                cmd.resolve(reply);
+            }
+        }
+    }
+    /**
+     * Parse a RESP reply from the buffer starting at offset.
+     * Returns [parsed_value, bytes_consumed] or null if incomplete.
+     */
+    parseReply(buf, offset) {
+        if (offset >= buf.length)
+            return null;
+        const type = String.fromCharCode(buf[offset]);
+        const lineEnd = this.findCRLF(buf, offset);
+        if (lineEnd === -1)
+            return null;
+        const line = buf.subarray(offset + 1, lineEnd).toString();
+        const consumed = lineEnd + 2; // past \r\n
+        switch (type) {
+            case '+': // Simple string
+                return [line, consumed];
+            case '-': // Error
+                return [new Error(line), consumed];
+            case ':': // Integer
+                return [parseInt(line, 10), consumed];
+            case '$': { // Bulk string
+                const len = parseInt(line, 10);
+                if (len === -1)
+                    return [null, consumed];
+                if (consumed + len + 2 > buf.length)
+                    return null; // Incomplete
+                const data = buf.subarray(consumed, consumed + len).toString();
+                return [data, consumed + len + 2]; // +2 for trailing \r\n
+            }
+            case '*': { // Array
+                const count = parseInt(line, 10);
+                if (count === -1)
+                    return [null, consumed];
+                const items = [];
+                let pos = consumed;
+                for (let i = 0; i < count; i++) {
+                    const item = this.parseReply(buf, pos);
+                    if (item === null)
+                        return null; // Incomplete
+                    const [val, itemConsumed] = item;
+                    if (val instanceof Error)
+                        return [val, itemConsumed];
+                    items.push(val);
+                    pos = itemConsumed;
+                }
+                return [items, pos];
+            }
+            default:
+                return [new Error(`Unknown RESP type: ${type}`), consumed];
+        }
+    }
+    findCRLF(buf, start) {
+        for (let i = start; i < buf.length - 1; i++) {
+            if (buf[i] === 0x0d && buf[i + 1] === 0x0a)
+                return i;
+        }
+        return -1;
+    }
+}
+exports.RedisClient = RedisClient;
+//# sourceMappingURL=redis-client.js.map

package/dist/redis-client.js.map

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

package/dist/redis-sync.d.ts

@@ -0,0 +1,92 @@
+/**
+ * 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).
+ */
+import { RedisClient } from './redis-client';
+import { KeyStore } from './store';
+import { ApiKeyRecord, UsageEvent } from './types';
+export declare class RedisSync {
+    private readonly redis;
+    private readonly store;
+    private syncInterval;
+    private readonly syncMs;
+    constructor(redis: RedisClient, store: KeyStore, syncIntervalMs?: number);
+    /**
+     * Initialize: connect to Redis and load existing state into local KeyStore.
+     */
+    init(): Promise<void>;
+    destroy(): Promise<void>;
+    /**
+     * Save a single key record to Redis. Called after local KeyStore mutations.
+     * Fire-and-forget (errors logged, not thrown).
+     */
+    saveKey(record: ApiKeyRecord): Promise<void>;
+    /**
+     * Save ALL keys to Redis. Called when local KeyStore.save() fires.
+     */
+    saveAll(): Promise<void>;
+    /**
+     * Atomic credit deduction via Redis Lua. Returns true if deduction succeeded.
+     * Call this INSTEAD of store.deductCredits() in Redis mode.
+     */
+    atomicDeduct(apiKey: string, amount: number): Promise<boolean>;
+    /**
+     * Atomic credit top-up via Redis.
+     */
+    atomicTopup(apiKey: string, amount: number): Promise<boolean>;
+    /**
+     * Revoke a key in both local store and Redis.
+     */
+    revokeKey(apiKey: string): Promise<boolean>;
+    /**
+     * Record a usage event to Redis (append to list). Fire-and-forget.
+     * Events are stored as JSON strings in a Redis list with max 100k entries.
+     */
+    recordUsage(event: UsageEvent): Promise<void>;
+    /**
+     * Get usage events from Redis. Returns events after `since` timestamp if provided.
+     */
+    getUsageEvents(since?: string): Promise<UsageEvent[]>;
+    /**
+     * Get the count of usage events in Redis.
+     */
+    getUsageCount(): Promise<number>;
+    /**
+     * Atomic rate limit check + record via Redis. Returns a result compatible with
+     * the local RateLimiter interface. Uses a sorted set per rate-limit key with
+     * timestamps as scores for O(log N) sliding window.
+     *
+     * @param key Composite key (e.g. "pg_abc" or "pg_abc:tool:search")
+     * @param maxCalls Maximum calls per window
+     * @param windowMs Window size in milliseconds (default: 60000)
+     */
+    checkRateLimit(key: string, maxCalls: number, windowMs?: number): Promise<{
+        allowed: boolean;
+        remaining: number;
+        resetInMs: number;
+    }>;
+    /**
+     * Load all keys from Redis into the local in-memory KeyStore.
+     * Merges with any locally-created keys (doesn't overwrite local-only keys).
+     */
+    private loadFromRedis;
+    /**
+     * Push local KeyStore state to Redis (used when Redis is empty on first connect).
+     */
+    private pushLocalToRedis;
+    private recordToHash;
+    private hashToRecord;
+}
+//# sourceMappingURL=redis-sync.d.ts.map

package/dist/redis-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redis-sync.d.ts","sourceRoot":"","sources":["../src/redis-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,YAAY,EAAe,UAAU,EAAE,MAAM,SAAS,CAAC;AA8DhE,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,SAAO;IAQtE;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAerB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;;OAGG;IACG,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;;OAGG;IACG,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BpE;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBnE;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYjD;;;OAGG;IACG,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAUnD;;OAEG;IACG,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAa3D;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAWtC;;;;;;;;OAQG;IACG,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,SAAS,GAAG,OAAO,CAAC;QAC9E,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IA8CF;;;OAGG;YACW,aAAa;IA+B3B;;OAEG;YACW,gBAAgB;IAc9B,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,YAAY;CA0BrB"}