paygate-mcp 10.0.0 → 10.2.0

package/dist/config-profiles.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * ConfigProfileManager — Named configuration presets.
+ *
+ * Store and switch between named configuration profiles for different
+ * environments (dev, staging, production) or use cases:
+ *   - Save current config as a named profile
+ *   - Switch between profiles at runtime
+ *   - Compare profiles to see differences
+ *   - Import/export profiles as JSON
+ *   - Profile inheritance (extend a base profile)
+ *   - Rollback to previous profile
+ *
+ * Zero external dependencies.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigProfileManager = void 0;
+const crypto = __importStar(require("crypto"));
+// ─── Defaults ───────────────────────────────────────────────────────────────
+const DEFAULT_CONFIG = {
+    enabled: false,
+    maxProfiles: 50,
+    maxConfigSize: 1_000_000,
+};
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function computeChecksum(config) {
+    const json = JSON.stringify(config, Object.keys(config).sort());
+    return crypto.createHash('sha256').update(json).digest('hex').slice(0, 16);
+}
+function flattenKeys(obj, prefix = '') {
+    const result = new Map();
+    for (const [key, value] of Object.entries(obj)) {
+        const fullKey = prefix ? `${prefix}.${key}` : key;
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            const nested = flattenKeys(value, fullKey);
+            for (const [k, v] of nested) {
+                result.set(k, v);
+            }
+        }
+        else {
+            result.set(fullKey, value);
+        }
+    }
+    return result;
+}
+// ─── ConfigProfileManager Class ─────────────────────────────────────────────
+class ConfigProfileManager {
+    config;
+    profiles = new Map();
+    activeProfileId = null;
+    previousProfileId = null;
+    // Stats
+    _switchCount = 0;
+    _lastSwitchAt = null;
+    counter = 0;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    // ─── Profile CRUD ───────────────────────────────────────────────────────
+    /**
+     * Save a configuration as a named profile.
+     */
+    saveProfile(params) {
+        if (!params.name || params.name.length > 128) {
+            throw new Error('Profile name required (max 128 chars)');
+        }
+        const configJson = JSON.stringify(params.config);
+        if (configJson.length > this.config.maxConfigSize) {
+            throw new Error(`Config too large (${configJson.length} bytes, max ${this.config.maxConfigSize})`);
+        }
+        if (params.extendsProfile && !this.profiles.has(params.extendsProfile)) {
+            throw new Error(`Parent profile '${params.extendsProfile}' not found`);
+        }
+        // Check for existing profile with same name
+        let existing;
+        for (const p of this.profiles.values()) {
+            if (p.name === params.name) {
+                existing = p;
+                break;
+            }
+        }
+        if (existing) {
+            // Update existing
+            existing.config = JSON.parse(JSON.stringify(params.config));
+            existing.description = params.description ?? existing.description;
+            existing.extendsProfile = params.extendsProfile;
+            existing.checksum = computeChecksum(params.config);
+            existing.updatedAt = Date.now();
+            if (params.activate) {
+                this.activateProfile(existing.id);
+            }
+            return { ...existing, config: JSON.parse(JSON.stringify(existing.config)) };
+        }
+        // Create new
+        if (this.profiles.size >= this.config.maxProfiles) {
+            throw new Error(`Max profiles reached (${this.config.maxProfiles})`);
+        }
+        this.counter++;
+        const id = `prof_${this.counter}_${Date.now().toString(36)}`;
+        const profile = {
+            id,
+            name: params.name,
+            description: params.description,
+            config: JSON.parse(JSON.stringify(params.config)),
+            extendsProfile: params.extendsProfile,
+            checksum: computeChecksum(params.config),
+            active: false,
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        };
+        this.profiles.set(id, profile);
+        if (params.activate) {
+            this.activateProfile(id);
+        }
+        return { ...profile, config: JSON.parse(JSON.stringify(profile.config)) };
+    }
+    /**
+     * Get a profile by ID.
+     */
+    getProfile(id) {
+        const p = this.profiles.get(id);
+        if (!p)
+            return undefined;
+        return { ...p, config: JSON.parse(JSON.stringify(p.config)) };
+    }
+    /**
+     * Get a profile by name.
+     */
+    getProfileByName(name) {
+        for (const p of this.profiles.values()) {
+            if (p.name === name) {
+                return { ...p, config: JSON.parse(JSON.stringify(p.config)) };
+            }
+        }
+        return undefined;
+    }
+    /**
+     * List all profiles.
+     */
+    listProfiles() {
+        const results = [];
+        for (const p of this.profiles.values()) {
+            results.push({ ...p, config: JSON.parse(JSON.stringify(p.config)) });
+        }
+        return results;
+    }
+    /**
+     * Delete a profile.
+     */
+    deleteProfile(id) {
+        if (id === this.activeProfileId) {
+            this.activeProfileId = null;
+        }
+        // Remove from other profiles' extends references
+        for (const p of this.profiles.values()) {
+            if (p.extendsProfile === id) {
+                p.extendsProfile = undefined;
+            }
+        }
+        return this.profiles.delete(id);
+    }
+    // ─── Profile Switching ──────────────────────────────────────────────────
+    /**
+     * Activate a profile (makes it the current active profile).
+     * Returns the resolved configuration (with inheritance applied).
+     */
+    activateProfile(id) {
+        const profile = this.profiles.get(id);
+        if (!profile)
+            throw new Error(`Profile '${id}' not found`);
+        // Deactivate current
+        if (this.activeProfileId) {
+            const current = this.profiles.get(this.activeProfileId);
+            if (current)
+                current.active = false;
+            this.previousProfileId = this.activeProfileId;
+        }
+        profile.active = true;
+        this.activeProfileId = id;
+        this._switchCount++;
+        this._lastSwitchAt = Date.now();
+        return this.resolveConfig(id);
+    }
+    /**
+     * Rollback to the previously active profile.
+     */
+    rollback() {
+        if (!this.previousProfileId)
+            return null;
+        if (!this.profiles.has(this.previousProfileId))
+            return null;
+        return this.activateProfile(this.previousProfileId);
+    }
+    /**
+     * Get the currently active profile.
+     */
+    getActive() {
+        if (!this.activeProfileId)
+            return null;
+        return this.getProfile(this.activeProfileId) ?? null;
+    }
+    /**
+     * Resolve configuration for a profile, applying inheritance.
+     */
+    resolveConfig(id) {
+        const profile = this.profiles.get(id);
+        if (!profile)
+            throw new Error(`Profile '${id}' not found`);
+        // Build inheritance chain
+        const chain = [profile];
+        let current = profile;
+        const visited = new Set([id]);
+        while (current.extendsProfile) {
+            if (visited.has(current.extendsProfile)) {
+                break; // Circular inheritance, stop
+            }
+            visited.add(current.extendsProfile);
+            const parent = this.profiles.get(current.extendsProfile);
+            if (!parent)
+                break;
+            chain.unshift(parent);
+            current = parent;
+        }
+        // Merge configs from base to child
+        const resolved = {};
+        for (const p of chain) {
+            Object.assign(resolved, JSON.parse(JSON.stringify(p.config)));
+        }
+        return resolved;
+    }
+    // ─── Comparison ─────────────────────────────────────────────────────────
+    /**
+     * Compare two profiles and return the differences.
+     */
+    compare(idA, idB) {
+        const configA = this.resolveConfig(idA);
+        const configB = this.resolveConfig(idB);
+        const flatA = flattenKeys(configA);
+        const flatB = flattenKeys(configB);
+        const onlyInA = [];
+        const onlyInB = [];
+        const changed = [];
+        const unchanged = [];
+        for (const [key, valueA] of flatA) {
+            if (!flatB.has(key)) {
+                onlyInA.push(key);
+            }
+            else {
+                const valueB = flatB.get(key);
+                if (JSON.stringify(valueA) !== JSON.stringify(valueB)) {
+                    changed.push({ key, valueA, valueB });
+                }
+                else {
+                    unchanged.push(key);
+                }
+            }
+        }
+        for (const key of flatB.keys()) {
+            if (!flatA.has(key)) {
+                onlyInB.push(key);
+            }
+        }
+        return { onlyInA, onlyInB, changed, unchanged };
+    }
+    // ─── Import/Export ──────────────────────────────────────────────────────
+    /**
+     * Export all profiles as JSON.
+     */
+    exportProfiles() {
+        const profiles = this.listProfiles();
+        return JSON.stringify({
+            version: 1,
+            exportedAt: Date.now(),
+            activeProfileId: this.activeProfileId,
+            profiles,
+        }, null, 2);
+    }
+    /**
+     * Import profiles from JSON. Returns count imported.
+     */
+    importProfiles(json, mode = 'merge') {
+        const data = JSON.parse(json);
+        if (!data.profiles || !Array.isArray(data.profiles)) {
+            throw new Error('Invalid import format');
+        }
+        if (mode === 'replace') {
+            this.profiles.clear();
+            this.activeProfileId = null;
+        }
+        let imported = 0;
+        for (const p of data.profiles) {
+            if (!p.name || !p.config)
+                continue;
+            this.saveProfile({
+                name: p.name,
+                config: p.config,
+                description: p.description,
+                activate: p.active && data.activeProfileId === p.id,
+            });
+            imported++;
+        }
+        return imported;
+    }
+    // ─── Configuration ──────────────────────────────────────────────────────
+    configure(updates) {
+        if (updates.enabled !== undefined)
+            this.config.enabled = updates.enabled;
+        if (updates.maxProfiles !== undefined)
+            this.config.maxProfiles = Math.max(1, updates.maxProfiles);
+        if (updates.maxConfigSize !== undefined)
+            this.config.maxConfigSize = Math.max(1000, updates.maxConfigSize);
+        return { ...this.config };
+    }
+    stats() {
+        const active = this.activeProfileId ? this.profiles.get(this.activeProfileId) : null;
+        return {
+            totalProfiles: this.profiles.size,
+            activeProfile: active ? active.name : null,
+            switchCount: this._switchCount,
+            lastSwitchAt: this._lastSwitchAt,
+            rollbackAvailable: this.previousProfileId !== null && this.profiles.has(this.previousProfileId),
+        };
+    }
+    clear() {
+        this.profiles.clear();
+        this.activeProfileId = null;
+        this.previousProfileId = null;
+        this._switchCount = 0;
+        this._lastSwitchAt = null;
+    }
+}
+exports.ConfigProfileManager = ConfigProfileManager;
+//# sourceMappingURL=config-profiles.js.map

package/dist/config-profiles.js.map

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

package/dist/gateway-hooks.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Gateway Hooks — Pre/post request lifecycle hooks for custom logic.
+ *
+ * Register named hooks that execute at different stages of the
+ * request lifecycle: before gate evaluation (pre-gate), after gate
+ * but before backend call (pre-backend), and after backend response
+ * (post-backend). Hooks can modify requests, add metadata, or
+ * short-circuit processing.
+ *
+ * @example
+ * ```ts
+ * const hooks = new GatewayHookManager();
+ * hooks.configure({ enabled: true });
+ *
+ * hooks.registerHook({
+ *   name: 'log-all-calls',
+ *   stage: 'pre_gate',
+ *   type: 'log',
+ *   config: { message: 'Tool call received' },
+ * });
+ * ```
+ */
+export type HookStage = 'pre_gate' | 'pre_backend' | 'post_backend';
+export type HookType = 'log' | 'header_inject' | 'metadata_tag' | 'reject';
+export type HookAction = 'continue' | 'reject' | 'skip';
+export interface GatewayHook {
+    id: string;
+    name: string;
+    stage: HookStage;
+    type: HookType;
+    priority: number;
+    enabled: boolean;
+    config: HookConfig;
+    toolFilter?: string;
+    keyFilter?: string;
+    createdAt: string;
+    updatedAt: string;
+    executionCount: number;
+}
+export interface HookConfig {
+    /** For log type: the message template */
+    message?: string;
+    /** For header_inject type: headers to add */
+    headers?: Record<string, string>;
+    /** For metadata_tag type: tags to add */
+    tags?: Record<string, string>;
+    /** For reject type: error message */
+    rejectMessage?: string;
+    /** For reject type: JSON-RPC error code */
+    rejectCode?: number;
+}
+export interface HookCreateParams {
+    name: string;
+    stage: HookStage;
+    type: HookType;
+    priority?: number;
+    enabled?: boolean;
+    config: HookConfig;
+    toolFilter?: string;
+    keyFilter?: string;
+}
+export interface HookExecutionContext {
+    apiKey: string;
+    tool: string;
+    requestId?: string;
+    creditCost?: number;
+    timestamp: string;
+}
+export interface HookExecutionResult {
+    hookId: string;
+    hookName: string;
+    action: HookAction;
+    metadata?: Record<string, string>;
+    headers?: Record<string, string>;
+    rejectMessage?: string;
+    rejectCode?: number;
+    durationMs: number;
+}
+export interface HookStageResult {
+    stage: HookStage;
+    hookResults: HookExecutionResult[];
+    action: HookAction;
+    totalDurationMs: number;
+}
+export interface GatewayHookStats {
+    totalHooks: number;
+    enabledHooks: number;
+    totalExecutions: number;
+    byStage: Record<HookStage, number>;
+    byType: Record<HookType, number>;
+}
+export interface GatewayHookConfig {
+    enabled: boolean;
+    maxHooks: number;
+    maxExecutionMs: number;
+}
+export declare class GatewayHookManager {
+    private hooks;
+    private config;
+    registerHook(params: HookCreateParams): GatewayHook;
+    getHook(id: string): GatewayHook | undefined;
+    listHooks(filter?: {
+        stage?: HookStage;
+        type?: HookType;
+        enabled?: boolean;
+    }): GatewayHook[];
+    updateHook(id: string, updates: Partial<Pick<GatewayHook, 'name' | 'priority' | 'enabled' | 'config' | 'toolFilter' | 'keyFilter'>>): GatewayHook;
+    deleteHook(id: string): boolean;
+    executeStage(stage: HookStage, ctx: HookExecutionContext): HookStageResult;
+    private executeHook;
+    configure(updates: Partial<GatewayHookConfig>): GatewayHookConfig;
+    stats(): GatewayHookStats;
+    clear(): void;
+}
+//# sourceMappingURL=gateway-hooks.d.ts.map

package/dist/gateway-hooks.d.ts.map

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