donobu 2.18.5 → 2.19.1

package/dist/managers/FlowDependencyAnalyzer.js

@@ -0,0 +1,236 @@
+"use strict";
+// src/managers/FlowDependencyAnalyzer.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowDependencyAnalyzer = void 0;
+class FlowDependencyAnalyzer {
+    /**
+     * Analyzes a collection of flows and builds a dependency graph based on browser state references.
+     */
+    static analyzeDependencies(flows) {
+        const flowsMap = new Map(flows.map((flow) => [flow.id, flow]));
+        const nameToIdMap = new Map();
+        // Build name-to-ID mapping for flows that have names
+        // When multiple flows have the same name, prefer the one with the latest completedAt
+        flows.forEach((flow) => {
+            if (flow.name) {
+                const existingFlowId = nameToIdMap.get(flow.name);
+                if (!existingFlowId) {
+                    // First flow with this name
+                    nameToIdMap.set(flow.name, flow.id);
+                }
+                else {
+                    // Compare with existing flow to determine which one to keep
+                    const existingFlow = flowsMap.get(existingFlowId);
+                    const shouldReplace = this.shouldReplaceFlow(existingFlow, flow);
+                    if (shouldReplace) {
+                        nameToIdMap.set(flow.name, flow.id);
+                    }
+                }
+            }
+        });
+        const dependencies = new Map();
+        const dependents = new Map();
+        // Initialize maps
+        flows.forEach((flow) => {
+            dependencies.set(flow.id, []);
+            dependents.set(flow.id, []);
+        });
+        // Analyze each flow's browser.initialState to determine dependencies
+        flows.forEach((flow) => {
+            const deps = this.extractDependencies(flow, nameToIdMap, flowsMap);
+            dependencies.set(flow.id, deps);
+            // Update dependents map
+            deps.forEach((depId) => {
+                const currentDependents = dependents.get(depId) || [];
+                currentDependents.push(flow.id);
+                dependents.set(depId, currentDependents);
+            });
+        });
+        // Detect circular dependencies
+        this.detectCircularDependencies(dependencies);
+        // Find independent flows (no dependencies)
+        const independentFlows = flows
+            .filter((flow) => (dependencies.get(flow.id) || []).length === 0)
+            .map((flow) => flow.id);
+        // Calculate execution order using topological sort
+        const executionOrder = this.calculateExecutionOrder(dependencies);
+        return {
+            flows: flowsMap,
+            dependencies,
+            dependents,
+            independentFlows,
+            executionOrder,
+        };
+    }
+    /**
+     * Extracts dependencies for a single flow by analyzing its browser.initialState
+     */
+    static extractDependencies(flow, nameToIdMap, flowsMap) {
+        const initialState = flow.browser?.initialState;
+        if (!initialState) {
+            return [];
+        }
+        switch (initialState.type) {
+            case 'id':
+                // Direct flow ID reference
+                if (flowsMap.has(initialState.value)) {
+                    return [initialState.value];
+                }
+                throw new Error(`Flow dependency not found: flow with ID "${initialState.value}" does not exist`);
+            case 'name':
+                // Flow name reference - resolve to ID
+                const flowId = nameToIdMap.get(initialState.value);
+                if (flowId) {
+                    return [flowId];
+                }
+                throw new Error(`Flow dependency not found: flow with name "${initialState.value}" does not exist`);
+            case 'json':
+                // Direct JSON state - no dependencies
+                return [];
+            default:
+                throw new Error(`Unknown browser state reference type: ${initialState.type}`);
+        }
+    }
+    /**
+     * Determines if a new flow should replace an existing flow when they have the same name.
+     * Prefers flows with later completedAt times, treating null completedAt as "never completed".
+     */
+    static shouldReplaceFlow(existingFlow, newFlow) {
+        // If both flows have completedAt values, prefer the later one
+        if (existingFlow.completedAt !== null && newFlow.completedAt !== null) {
+            return newFlow.completedAt > existingFlow.completedAt;
+        }
+        // If only the new flow has a completedAt value, prefer it
+        if (existingFlow.completedAt === null && newFlow.completedAt !== null) {
+            return true;
+        }
+        // If only the existing flow has a completedAt value, keep it
+        if (existingFlow.completedAt !== null && newFlow.completedAt === null) {
+            return false;
+        }
+        // If neither has completedAt, prefer the one with the later startedAt
+        // (this handles flows that are still running or were interrupted)
+        if (existingFlow.startedAt !== null && newFlow.startedAt !== null) {
+            return newFlow.startedAt > existingFlow.startedAt;
+        }
+        // If only the new flow has startedAt, prefer it
+        if (existingFlow.startedAt === null && newFlow.startedAt !== null) {
+            return true;
+        }
+        // If only the existing flow has startedAt, keep it
+        if (existingFlow.startedAt !== null && newFlow.startedAt === null) {
+            return false;
+        }
+        // If we can't determine based on timestamps, keep the existing flow
+        return false;
+    }
+    /**
+     * Detects circular dependencies using DFS
+     */
+    static detectCircularDependencies(dependencies) {
+        const visiting = new Set();
+        const visited = new Set();
+        const visit = (flowId, path) => {
+            if (visiting.has(flowId)) {
+                const cycleStart = path.indexOf(flowId);
+                const cycle = [...path.slice(cycleStart), flowId];
+                throw new Error(`Circular dependency detected: ${cycle.join(' -> ')}`);
+            }
+            if (visited.has(flowId)) {
+                return;
+            }
+            visiting.add(flowId);
+            const deps = dependencies.get(flowId) || [];
+            deps.forEach((depId) => {
+                visit(depId, [...path, flowId]);
+            });
+            visiting.delete(flowId);
+            visited.add(flowId);
+        };
+        // Check each flow for cycles
+        dependencies.forEach((_, flowId) => {
+            if (!visited.has(flowId)) {
+                visit(flowId, []);
+            }
+        });
+    }
+    /**
+     * Calculates execution order using topological sort with parallel execution support
+     */
+    static calculateExecutionOrder(dependencies) {
+        const executionOrder = [];
+        const remainingFlows = new Set(dependencies.keys());
+        const completedFlows = new Set();
+        // Process flows in waves - each wave can execute in parallel
+        while (remainingFlows.size > 0) {
+            const currentWave = [];
+            // Find flows that can execute now (all dependencies completed)
+            for (const flowId of remainingFlows) {
+                const deps = dependencies.get(flowId) || [];
+                const canExecute = deps.every((depId) => completedFlows.has(depId));
+                if (canExecute) {
+                    currentWave.push(flowId);
+                }
+            }
+            if (currentWave.length === 0) {
+                // This should not happen if circular dependency detection worked correctly
+                const remaining = Array.from(remainingFlows);
+                throw new Error(`Unable to resolve execution order. Remaining flows: ${remaining.join(', ')}`);
+            }
+            // Add current wave to execution order
+            executionOrder.push(currentWave);
+            // Mark these flows as completed and remove from remaining
+            currentWave.forEach((flowId) => {
+                completedFlows.add(flowId);
+                remainingFlows.delete(flowId);
+            });
+        }
+        return executionOrder;
+    }
+    /**
+     * Validates that all flow dependencies can be resolved
+     */
+    static validateDependencies(flows) {
+        try {
+            this.analyzeDependencies(flows);
+        }
+        catch (error) {
+            throw new Error(`Flow dependency validation failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Gets a human-readable summary of the dependency graph
+     */
+    static getDependencySummary(graph) {
+        const lines = [];
+        lines.push(`Flow Dependency Analysis:`);
+        lines.push(`- Total flows: ${graph.flows.size}`);
+        lines.push(`- Independent flows: ${graph.independentFlows.length}`);
+        lines.push(`- Execution waves: ${graph.executionOrder.length}`);
+        lines.push('');
+        lines.push('Execution Order:');
+        graph.executionOrder.forEach((wave, index) => {
+            const waveNames = wave.map((flowId) => {
+                const flow = graph.flows.get(flowId);
+                return flow?.name || flowId;
+            });
+            lines.push(`  Wave ${index + 1}: ${waveNames.join(', ')}`);
+        });
+        lines.push('');
+        lines.push('Dependencies:');
+        graph.dependencies.forEach((deps, flowId) => {
+            if (deps.length > 0) {
+                const flow = graph.flows.get(flowId);
+                const flowName = flow?.name || flowId;
+                const depNames = deps.map((depId) => {
+                    const depFlow = graph.flows.get(depId);
+                    return depFlow?.name || depId;
+                });
+                lines.push(`  ${flowName} depends on: ${depNames.join(', ')}`);
+            }
+        });
+        return lines.join('\n');
+    }
+}
+exports.FlowDependencyAnalyzer = FlowDependencyAnalyzer;
+//# sourceMappingURL=FlowDependencyAnalyzer.js.map

package/dist/managers/FlowDependencyAnalyzer.js.map

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

package/dist/managers/ProjectStructureGenerator.d.ts

@@ -0,0 +1,62 @@
+import { FlowMetadata } from '../models/FlowMetadata';
+import { ProposedToolCall } from '../models/ProposedToolCall';
+export interface ProjectFile {
+    path: string;
+    content: string;
+}
+export interface GeneratedProject {
+    files: ProjectFile[];
+    summary: string;
+}
+export declare class ProjectStructureGenerator {
+    private readonly codeGenerator;
+    constructor();
+    /**
+     * Generates a complete Playwright project structure with dependency management
+     */
+    generateProject(flowsWithToolCalls: Array<{
+        metadata: FlowMetadata;
+        toolCalls: ProposedToolCall<any>[];
+    }>): Promise<GeneratedProject>;
+    /**
+     * Generates the playwright.config.ts file with project dependencies
+     */
+    private generatePlaywrightConfig;
+    /**
+     * Generates a single project configuration
+     */
+    private generateProjectConfig;
+    /**
+     * Gets project dependencies for a given flow
+     */
+    private getProjectDependencies;
+    /**
+     * Generates test files for all flows
+     */
+    private generateTestFiles;
+    /**
+     * Generates package.json
+     */
+    private generatePackageJson;
+    /**
+     * Generates README.md
+     */
+    private generateReadme;
+    /**
+     * Generates a summary of the generated project
+     */
+    private generateProjectSummary;
+    /**
+     * Gets a project name for a flow
+     */
+    private getProjectName;
+    /**
+     * Gets a test file name for a flow
+     */
+    private getTestFileName;
+    /**
+     * Prettifies generated code
+     */
+    private prettifyCode;
+}
+//# sourceMappingURL=ProjectStructureGenerator.d.ts.map

package/dist/managers/ProjectStructureGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectStructureGenerator.d.ts","sourceRoot":"","sources":["../../src/managers/ProjectStructureGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAQ9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;;IAM9C;;OAEG;IACU,eAAe,CAC1B,kBAAkB,EAAE,KAAK,CAAC;QACxB,QAAQ,EAAE,YAAY,CAAC;QACvB,SAAS,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;KACpC,CAAC,GACD,OAAO,CAAC,gBAAgB,CAAC;IAmC5B;;OAEG;YACW,wBAAwB;IAkCtC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;YACW,iBAAiB;IAwB/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA+CtB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;YACW,YAAY;CAe3B"}

package/dist/managers/ProjectStructureGenerator.js

@@ -0,0 +1,234 @@
+"use strict";
+// src/managers/ProjectStructureGenerator.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectStructureGenerator = void 0;
+const FlowDependencyAnalyzer_1 = require("./FlowDependencyAnalyzer");
+const CodeGenerator_1 = require("./CodeGenerator");
+const main_1 = require("../main");
+class ProjectStructureGenerator {
+    constructor() {
+        this.codeGenerator = new CodeGenerator_1.CodeGenerator();
+    }
+    /**
+     * Generates a complete Playwright project structure with dependency management
+     */
+    async generateProject(flowsWithToolCalls) {
+        // Analyze dependencies
+        const dependencyGraph = FlowDependencyAnalyzer_1.FlowDependencyAnalyzer.analyzeDependencies(flowsWithToolCalls.map((f) => f.metadata));
+        const files = [];
+        // Generate playwright.config.ts
+        files.push({
+            path: 'playwright.config.ts',
+            content: await this.generatePlaywrightConfig(dependencyGraph),
+        });
+        // Generate individual test files
+        const testFiles = await this.generateTestFiles(flowsWithToolCalls);
+        files.push(...testFiles);
+        // Generate package.json if needed
+        files.push({
+            path: 'package.json',
+            content: this.generatePackageJson(),
+        });
+        // Generate README
+        files.push({
+            path: 'README.md',
+            content: this.generateReadme(dependencyGraph),
+        });
+        const summary = this.generateProjectSummary(dependencyGraph);
+        return { files, summary };
+    }
+    /**
+     * Generates the playwright.config.ts file with project dependencies
+     */
+    async generatePlaywrightConfig(graph) {
+        const projects = [];
+        // Create a project for each flow (both single and multiple flows in waves get individual projects)
+        graph.executionOrder.forEach((wave) => {
+            wave.forEach((flowId) => {
+                const flow = graph.flows.get(flowId);
+                const projectName = this.getProjectName(flow);
+                const dependencies = this.getProjectDependencies(flowId, graph);
+                projects.push(this.generateProjectConfig(projectName, flow, dependencies));
+            });
+        });
+        const config = `import { defineConfig, devices } from 'donobu';
+
+export default defineConfig({
+  testDir: './tests',
+  projects: [
+${projects.map((p) => '    ' + p).join(',\n')}
+  ],
+  reporter: [
+    ["github"],
+    ["json", { outputFile: "test-results/playwright-report.json" }],
+  ],
+});`;
+        return this.prettifyCode(config);
+    }
+    /**
+     * Generates a single project configuration
+     */
+    generateProjectConfig(projectName, flow, dependencies) {
+        const testMatch = `tests/${this.getTestFileName(flow)}`;
+        const deps = dependencies.length > 0
+            ? `\n      dependencies: [${dependencies.map((d) => `'${d}'`).join(', ')}],`
+            : '';
+        // Get device name from flow config, default to 'Desktop Chromium'
+        const deviceName = flow.browser?.using?.type === 'device'
+            ? flow.browser.using.deviceName || 'Desktop Chromium'
+            : 'Desktop Chromium';
+        return `{
+      name: '${projectName}',
+      testMatch: '${testMatch}',${deps}
+      use: { ...devices['${deviceName}'] },
+    }`;
+    }
+    /**
+     * Gets project dependencies for a given flow
+     */
+    getProjectDependencies(flowId, graph) {
+        const dependencies = graph.dependencies.get(flowId) || [];
+        return dependencies.map((depId) => {
+            const depFlow = graph.flows.get(depId);
+            return this.getProjectName(depFlow);
+        });
+    }
+    /**
+     * Generates test files for all flows
+     */
+    async generateTestFiles(flowsWithToolCalls) {
+        const files = [];
+        for (const { metadata, toolCalls } of flowsWithToolCalls) {
+            const fileName = this.getTestFileName(metadata);
+            const content = await this.codeGenerator.getFlowAsPlaywrightScript(metadata, toolCalls);
+            files.push({
+                path: `tests/${fileName}`,
+                content,
+            });
+        }
+        return files;
+    }
+    /**
+     * Generates package.json
+     */
+    generatePackageJson() {
+        return JSON.stringify({
+            name: 'generated-playwright-tests',
+            version: '1.0.0',
+            description: 'Generated Playwright tests with flow dependencies',
+            scripts: {
+                test: 'playwright test',
+                'test:headed': 'playwright test --headed',
+                'test:debug': 'playwright test --debug',
+            },
+            devDependencies: {
+                '@playwright/test': '^1.40.0',
+                donobu: 'latest',
+            },
+        }, null, 2);
+    }
+    /**
+     * Generates README.md
+     */
+    generateReadme(graph) {
+        const dependencySummary = FlowDependencyAnalyzer_1.FlowDependencyAnalyzer.getDependencySummary(graph);
+        return `# Generated Playwright Tests
+
+This project contains automatically generated Playwright tests with proper dependency management.
+
+## Installation
+
+\`\`\`bash
+npm install
+npx playwright install
+\`\`\`
+
+## Running Tests
+
+\`\`\`bash
+# Run all tests respecting dependencies
+npm test
+
+# Run tests in headed mode
+npm run test:headed
+
+# Debug tests
+npm run test:debug
+\`\`\`
+
+## Test Dependencies
+
+${dependencySummary}
+
+## Notes
+
+- Tests are organized into Playwright projects to manage dependencies
+- Each flow runs in the correct order based on browser state dependencies
+- Independent flows can run in parallel within the same wave
+- Browser state is automatically managed between dependent flows
+
+## Generated Files
+
+- \`playwright.config.ts\` - Playwright configuration with project dependencies
+- \`tests/\` - Individual test files for each flow
+- \`package.json\` - Project dependencies and scripts
+`;
+    }
+    /**
+     * Generates a summary of the generated project
+     */
+    generateProjectSummary(graph) {
+        const lines = [];
+        lines.push('Generated Playwright Project Summary:');
+        lines.push(`- ${graph.flows.size} test files generated`);
+        lines.push(`- ${graph.executionOrder.length} execution waves configured`);
+        lines.push(`- ${graph.independentFlows.length} independent flows`);
+        const dependentFlows = graph.flows.size - graph.independentFlows.length;
+        if (dependentFlows > 0) {
+            lines.push(`- ${dependentFlows} flows with dependencies`);
+        }
+        lines.push('');
+        lines.push('To run the tests:');
+        lines.push('1. npm install');
+        lines.push('2. npx playwright install');
+        lines.push('3. npm test');
+        return lines.join('\n');
+    }
+    /**
+     * Gets a project name for a flow
+     */
+    getProjectName(flow) {
+        if (flow.name) {
+            return flow.name.replace(/[^a-zA-Z0-9-_]/g, '-');
+        }
+        return `flow-${flow.id.substring(0, 8)}`;
+    }
+    /**
+     * Gets a test file name for a flow
+     */
+    getTestFileName(flow) {
+        const projectName = this.getProjectName(flow);
+        return `${projectName}.spec.ts`;
+    }
+    /**
+     * Prettifies generated code
+     */
+    async prettifyCode(code) {
+        try {
+            const prettier = require('prettier');
+            return prettier.format(code, {
+                parser: 'typescript',
+                semi: true,
+                singleQuote: true,
+                trailingComma: 'es5',
+            });
+        }
+        catch (error) {
+            main_1.appLogger.error('Failed to format code with Prettier:', error);
+            // If prettier fails, return the original code
+            return code;
+        }
+    }
+}
+exports.ProjectStructureGenerator = ProjectStructureGenerator;
+//# sourceMappingURL=ProjectStructureGenerator.js.map

package/dist/managers/ProjectStructureGenerator.js.map

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

package/dist/tools/ExtractPaymentProviderKeyTool.d.ts

@@ -6,12 +6,58 @@ interface ExtractPaymentProviderToolCoreParameters {
 }
 interface ExtractPaymentProviderToolGptParameters extends BaseToolGptParameters, ExtractPaymentProviderToolCoreParameters {
 }
+/**
+ * This tool scans the current web page for publishable payment
+ * provider credentials the current page's inline `<script>` blocks.
+ *
+ * ### Supported providers
+ * | Provider | Regex                             | Example        |
+ * |----------|-----------------------------------|----------------|
+ * | Stripe   | `/pk_(test\|live)_[A-Za-z0-9]+/i` | `pk_test_51M…` |
+ * | PayPal   | `/A[A-Za-z0-9-_]{75,}/i`          | `AUGIH…`       |
+ *
+ * On **success** the tool returns a JSON object containing any discovered keys and the
+ * URL of the page that was scanned. If **no keys** are found, `isSuccessful` is set to
+ * `false` and a short error string is provided.
+ *
+ * ```json
+ * {
+ *   "stripe": ["pk_test_123", "pk_live_456"],
+ *   "paypal": ["AUGIH…"],
+ *   "checkoutPageUrl": "https://shop.example.com/checkout"
+ * }
+ * ```
+ */
 export declare class ExtractPaymentProviderKeyTool extends Tool<ExtractPaymentProviderToolCoreParameters, ExtractPaymentProviderToolGptParameters> {
     static readonly NAME = "extractPaymentProviderKey";
+    private static readonly EXCLUDED_PATTERNS;
+    private static readonly PAYPAL_CLIENT_ID_PATTERN;
+    private static readonly PAYPAL_CONTEXT_INDICATORS;
     constructor();
     call(context: ToolCallContext, _parameters: ExtractPaymentProviderToolCoreParameters): Promise<ToolCallResult>;
     callFromGpt(context: ToolCallContext, parameters: ExtractPaymentProviderToolGptParameters): Promise<ToolCallResult>;
-    private verifyPayPalPresence;
+    /**
+     * Extract potential PayPal client ID candidates from script content
+     */
+    private extractPayPalCandidates;
+    /**
+     * Enhanced validation for PayPal client IDs
+     */
+    private isValidPayPalClientId;
+    /**
+     * Check for strong PayPal contextual indicators near the candidate key
+     */
+    private hasStrongPayPalContext;
+    /**
+     * Check if the candidate appears in a structured context (assignments, objects, etc.)
+     */
+    private hasStructuredPayPalContext;
+    /**
+     * Collects text bodies for:
+     *   - all inline <script> blocks
+     *   - every <script src="…"> that is present in the DOM
+     */
+    private static getAllScriptSources;
 }
 export {};
 //# sourceMappingURL=ExtractPaymentProviderKeyTool.d.ts.map

package/dist/tools/ExtractPaymentProviderKeyTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExtractPaymentProviderKeyTool.d.ts","sourceRoot":"","sources":["../../src/tools/ExtractPaymentProviderKeyTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,UAAU,wCAAwC;CAAG;AACrD,UAAU,uCACR,SAAQ,qBAAqB,EAC3B,wCAAwC;CAAG;AAE/C,qBAAa,6BAA8B,SAAQ,IAAI,CACrD,wCAAwC,EACxC,uCAAuC,CACxC;IACC,gBAAuB,IAAI,+BAA+B;;IAWpC,IAAI,CACxB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,wCAAwC,GACpD,OAAO,CAAC,cAAc,CAAC;IA6EJ,WAAW,CAC/B,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,uCAAuC,GAClD,OAAO,CAAC,cAAc,CAAC;IAI1B,OAAO,CAAC,oBAAoB;CAQ7B"}
+{"version":3,"file":"ExtractPaymentProviderKeyTool.d.ts","sourceRoot":"","sources":["../../src/tools/ExtractPaymentProviderKeyTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,UAAU,wCAAwC;CAAG;AACrD,UAAU,uCACR,SAAQ,qBAAqB,EAC3B,wCAAwC;CAAG;AAE/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,6BAA8B,SAAQ,IAAI,CACrD,wCAAwC,EACxC,uCAAuC,CACxC;IACC,gBAAuB,IAAI,+BAA+B;IAG1D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAmBvC;IAGF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAA6B;IAG7E,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAW/C;;IAWoB,IAAI,CACxB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,wCAAwC,GACpD,OAAO,CAAC,cAAc,CAAC;IAyDJ,WAAW,CAC/B,OAAO,EAAE,eAAe,EACxB,UAAU,EAAE,uCAAuC,GAClD,OAAO,CAAC,cAAc,CAAC;IAI1B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgB/B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+B7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqB9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA8BlC;;;;OAIG;mBACkB,mBAAmB;CAkCzC"}