@natchs/browser-mcp 2.0.0

package/dist/core/rate-limit.js

@@ -0,0 +1,89 @@
+export class TokenBucket {
+    capacity;
+    ratePerSec;
+    _tokens;
+    lastRefill;
+    constructor(capacity, ratePerSec) {
+        this.capacity = capacity;
+        this.ratePerSec = ratePerSec;
+        this._tokens = capacity;
+        this.lastRefill = Date.now();
+    }
+    get tokens() {
+        this.refill();
+        return this._tokens;
+    }
+    consume(count) {
+        if (count < 0)
+            return false;
+        if (count === 0)
+            return true;
+        this.refill();
+        if (this._tokens < count)
+            return false;
+        this._tokens -= count;
+        return true;
+    }
+    reset() {
+        this._tokens = this.capacity;
+        this.lastRefill = Date.now();
+    }
+    refill() {
+        const now = Date.now();
+        const elapsed = (now - this.lastRefill) / 1000;
+        if (elapsed <= 0)
+            return;
+        const added = elapsed * this.ratePerSec;
+        this._tokens = Math.min(this.capacity, this._tokens + added);
+        this.lastRefill = now;
+    }
+}
+export class RateLimiter {
+    globalBucket;
+    perToolBuckets = new Map();
+    config;
+    hits = 0;
+    denied = 0;
+    constructor(config) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            globalRpm: config.globalRpm,
+            perToolRpm: config.perToolRpm,
+            burstSize: config.burstSize,
+        };
+        this.globalBucket = new TokenBucket(config.burstSize, config.globalRpm / 60);
+    }
+    check(toolName) {
+        if (!this.config.enabled)
+            return true;
+        if (!this.globalBucket.consume(1)) {
+            this.denied++;
+            return false;
+        }
+        let toolBucket = this.perToolBuckets.get(toolName);
+        if (!toolBucket) {
+            toolBucket = new TokenBucket(this.config.perToolRpm, this.config.perToolRpm / 60);
+            this.perToolBuckets.set(toolName, toolBucket);
+        }
+        if (!toolBucket.consume(1)) {
+            this.denied++;
+            return false;
+        }
+        this.hits++;
+        return true;
+    }
+    stats() {
+        return {
+            hits: this.hits,
+            denied: this.denied,
+            total: this.hits + this.denied,
+        };
+    }
+    reset() {
+        this.globalBucket.reset();
+        this.perToolBuckets.clear();
+        this.hits = 0;
+        this.denied = 0;
+    }
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/core/rate-limit.js.map

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

package/dist/core/registry.d.ts

@@ -0,0 +1,67 @@
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { ToolContext } from './context.js';
+import { PluginManager } from './plugin.js';
+export type ToolCategory = 'navigation' | 'interaction' | 'extraction' | 'network' | 'session' | 'browser' | 'admin' | 're' | 'stealth' | 'reverse-engineering' | 'cloudflare';
+export interface ToolConfig {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+    category: ToolCategory;
+    needsBrowser?: boolean;
+    requiresNetwork?: boolean;
+    schema?: z.ZodType<any>;
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+    version?: string;
+    deprecated?: boolean;
+    replacement?: string;
+}
+export type ToolHandler<T = unknown> = (args: Record<string, unknown>, context: ToolContext<T>) => Promise<{
+    content: [{
+        type: 'text';
+        text: string;
+    }];
+}>;
+export interface ToolAnnotations {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+export declare function resolveCacheable(annotations: ToolAnnotations): boolean;
+export declare function resolveAnnotations(config: ToolConfig): ToolAnnotations;
+export declare class ToolRegistry {
+    private entries;
+    private order;
+    private aliases;
+    private pluginManager;
+    constructor(pluginManager?: PluginManager);
+    getPluginManager(): PluginManager;
+    registerAlias(alias: string, targetName: string): void;
+    resolveAlias(name: string): string;
+    isAlias(name: string): boolean;
+    getAliases(): Record<string, string>;
+    register(config: ToolConfig, handler: ToolHandler<any>): void;
+    getTool(name: string): Tool | undefined;
+    getToolConfig(name: string): ToolConfig | undefined;
+    getToolAnnotations(name: string): ToolAnnotations | undefined;
+    getCacheable(name: string): boolean | undefined;
+    getAllTools(): Tool[];
+    getToolsByCategory(category: ToolCategory): Tool[];
+    getToolsByCategory(): Record<ToolCategory, Tool[]>;
+    getCategories(): ToolCategory[];
+    unregister(name: string): void;
+    toMCPTools(): Tool[];
+    private checkPreflight;
+    execute(name: string, args: Record<string, unknown>, context: ToolContext): Promise<{
+        content: [{
+            type: 'text';
+            text: string;
+        }];
+    }>;
+    private toToolDef;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/core/registry.d.ts.map

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

package/dist/core/registry.js

@@ -0,0 +1,270 @@
+import { zodToJsonSchema } from './schema-gen.js';
+import { ErrorCode } from './errors.js';
+import { PluginManager } from './plugin.js';
+export function resolveCacheable(annotations) {
+    return Boolean(annotations.readOnlyHint &&
+        annotations.idempotentHint &&
+        !annotations.destructiveHint &&
+        !annotations.openWorldHint);
+}
+const READ_ONLY_KEYWORDS = ['read', 'get', 'list', 'extract', 'discover', 'analyze', 'status', 'info', 'fingerprint', 'beautify', 'deobfuscate'];
+const DESTRUCTIVE_KEYWORDS = ['delete', 'remove', 'clear', 'close', 'destroy'];
+const WRITE_KEYWORDS = ['set', 'create', 'navigate', 'go', 'click', 'type', 'fill', 'select', 'hover', 'drag', 'scroll', 'press', 'upload', 'refresh', 'open', 'evaluate'];
+export function resolveAnnotations(config) {
+    // Explicit overrides
+    if (config.readOnlyHint !== undefined || config.destructiveHint !== undefined ||
+        config.idempotentHint !== undefined || config.openWorldHint !== undefined) {
+        return {
+            readOnlyHint: config.readOnlyHint ?? true,
+            destructiveHint: config.destructiveHint ?? false,
+            idempotentHint: config.idempotentHint ?? false,
+            openWorldHint: config.openWorldHint ?? false,
+        };
+    }
+    const name = config.name.toLowerCase();
+    const words = name.replace('browser_', '').split('_');
+    // Determine destructiveness
+    const isDestructive = DESTRUCTIVE_KEYWORDS.some(kw => words.includes(kw));
+    // Determine read-only
+    const isReadOnly = !isDestructive && (READ_ONLY_KEYWORDS.some(kw => words.includes(kw)) ||
+        config.category === 're' ||
+        config.category === 'stealth');
+    // Idempotent: read-only operations are generally idempotent
+    const isIdempotent = isReadOnly;
+    // Open world: tools that interact with web or browser generally are open-world
+    // Pure computation tools (re, stealth) are NOT open-world
+    const isOpenWorld = !['re', 'stealth'].includes(config.category);
+    return {
+        readOnlyHint: isReadOnly,
+        destructiveHint: isDestructive,
+        idempotentHint: isIdempotent,
+        openWorldHint: isOpenWorld,
+    };
+}
+function normalizeSchema(schema) {
+    if (schema.type !== 'object' || typeof schema.properties !== 'object' || schema.properties === null) {
+        return schema;
+    }
+    const result = { ...schema, additionalProperties: false };
+    const props = { ...result.properties };
+    result.properties = props;
+    const required = [...(result.required ?? [])];
+    result.required = required;
+    if (!('response_format' in props)) {
+        props.response_format = {
+            type: 'string',
+            enum: ['json', 'markdown'],
+            default: 'json',
+            description: 'Output format: json or markdown',
+        };
+    }
+    for (const [key, value] of Object.entries(props)) {
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            const propSchema = value;
+            if (propSchema.type === 'string') {
+                if (key === 'code' || key === 'source') {
+                    propSchema.maxLength = 1_000_000;
+                }
+                if (key === 'selector') {
+                    propSchema.maxLength = 500;
+                }
+                if (key.includes('rules_inline')) {
+                    propSchema.maxLength = 200_000;
+                }
+            }
+        }
+    }
+    return result;
+}
+export class ToolRegistry {
+    entries = new Map();
+    order = [];
+    aliases = new Map();
+    pluginManager;
+    constructor(pluginManager) {
+        this.pluginManager = pluginManager ?? new PluginManager();
+    }
+    getPluginManager() {
+        return this.pluginManager;
+    }
+    registerAlias(alias, targetName) {
+        if (this.entries.has(alias)) {
+            throw new Error(`Cannot register alias, tool already exists: ${alias}`);
+        }
+        if (!this.entries.has(targetName)) {
+            throw new Error(`Cannot register alias, target tool not found: ${targetName}`);
+        }
+        this.aliases.set(alias, targetName);
+    }
+    resolveAlias(name) {
+        return this.aliases.get(name) ?? name;
+    }
+    isAlias(name) {
+        return this.aliases.has(name);
+    }
+    getAliases() {
+        return Object.fromEntries(this.aliases);
+    }
+    register(config, handler) {
+        if (this.entries.has(config.name)) {
+            throw new Error(`Tool already registered: ${config.name}`);
+        }
+        // Pre-register hook
+        const preCtx = { toolName: config.name, config };
+        this.pluginManager.runPhase('pre-register', preCtx);
+        const resolvedSchema = config.schema
+            ? { ...zodToJsonSchema(config.schema), ...config.inputSchema }
+            : (config.inputSchema ?? {});
+        const normalizedSchema = normalizeSchema(resolvedSchema);
+        const annotations = resolveAnnotations(config);
+        const cacheable = resolveCacheable(annotations);
+        this.entries.set(config.name, { config: { ...config, inputSchema: normalizedSchema }, handler, annotations, cacheable });
+        this.order.push(config.name);
+        // Post-register hook
+        const postCtx = { toolName: config.name, config, annotations };
+        this.pluginManager.runPhase('post-register', postCtx);
+    }
+    getTool(name) {
+        const entry = this.entries.get(name);
+        if (!entry)
+            return undefined;
+        return this.toToolDef(entry);
+    }
+    getToolConfig(name) {
+        const entry = this.entries.get(name);
+        if (!entry)
+            return undefined;
+        return entry.config;
+    }
+    getToolAnnotations(name) {
+        const entry = this.entries.get(name);
+        return entry?.annotations;
+    }
+    getCacheable(name) {
+        const entry = this.entries.get(name);
+        return entry?.cacheable;
+    }
+    getAllTools() {
+        return this.order.map((name) => {
+            const entry = this.entries.get(name);
+            return this.toToolDef(entry);
+        });
+    }
+    getToolsByCategory(category) {
+        if (category) {
+            return this.getAllTools().filter((t) => {
+                const entry = this.entries.get(t.name);
+                return entry?.config.category === category;
+            });
+        }
+        const grouped = {};
+        for (const [name, entry] of this.entries) {
+            const cat = entry.config.category;
+            if (!grouped[cat])
+                grouped[cat] = [];
+            grouped[cat].push(this.toToolDef(entry));
+        }
+        return grouped;
+    }
+    getCategories() {
+        const cats = new Set();
+        for (const name of this.order) {
+            const entry = this.entries.get(name);
+            cats.add(entry.config.category);
+        }
+        return Array.from(cats).sort();
+    }
+    unregister(name) {
+        const idx = this.order.indexOf(name);
+        if (idx !== -1) {
+            this.order.splice(idx, 1);
+        }
+        this.entries.delete(name);
+    }
+    toMCPTools() {
+        return this.getAllTools();
+    }
+    checkPreflight(config, context) {
+        if (config.needsBrowser !== false) {
+            try {
+                if (!context.pageProvider) {
+                    return 'Browser session required but not available';
+                }
+            }
+            catch {
+                // silently handled
+                return 'Browser session required but not available';
+            }
+        }
+        if (config.requiresNetwork) {
+            if (!context.session?.getNetworkRequests) {
+                return 'Network interception required but not available';
+            }
+        }
+        return null;
+    }
+    async execute(name, args, context) {
+        const resolvedName = this.resolveAlias(name);
+        const entry = this.entries.get(resolvedName);
+        if (!entry) {
+            throw new Error(`Tool not found: ${name}`);
+        }
+        // Pre-execute hook
+        const preCtx = { toolName: resolvedName, config: entry.config, annotations: entry.annotations, args };
+        await this.pluginManager.runPhase('pre-execute', preCtx);
+        const preflightError = this.checkPreflight(entry.config, context);
+        if (preflightError) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ ok: false, error: { code: ErrorCode.PREFLIGHT_FAILED, message: preflightError } }) }],
+            };
+        }
+        const startTime = Date.now();
+        try {
+            let result = await entry.handler(args, context);
+            const durationMs = Date.now() - startTime;
+            // Post-execute hook
+            const postCtx = { toolName: resolvedName, config: entry.config, annotations: entry.annotations, args, durationMs };
+            await this.pluginManager.runPhase('post-execute', postCtx);
+            // Deprecation warning
+            if (entry.config.deprecated) {
+                const parsed = JSON.parse(result.content[0].text);
+                parsed._deprecated = {
+                    message: `Tool '${resolvedName}' is deprecated`,
+                    ...(entry.config.replacement ? { replacement: entry.config.replacement } : {}),
+                };
+                result = { content: [{ type: 'text', text: JSON.stringify(parsed) }] };
+            }
+            return result;
+        }
+        catch (err) {
+            const durationMs = Date.now() - startTime;
+            const error = err instanceof Error ? err : new Error(String(err));
+            // On-error hook
+            const errCtx = { toolName: resolvedName, config: entry.config, args, error, durationMs };
+            await this.pluginManager.runPhase('on-error', errCtx);
+            const msg = error.message;
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ ok: false, error: msg }) }],
+            };
+        }
+    }
+    toToolDef(entry) {
+        const def = {
+            name: entry.config.name,
+            description: entry.config.description,
+            inputSchema: entry.config.inputSchema,
+            annotations: entry.annotations,
+        };
+        if (entry.config.version) {
+            def._version = entry.config.version;
+        }
+        if (entry.config.deprecated) {
+            def.deprecated = true;
+            if (entry.config.replacement) {
+                def.replacement = entry.config.replacement;
+            }
+        }
+        return def;
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/registry.js.map

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

package/dist/core/sandbox.d.ts

@@ -0,0 +1,20 @@
+export declare function isInternalIP(hostname: string): boolean;
+export declare function validatePath(inputPath: string): {
+    valid: boolean;
+    normalized?: string;
+    error?: string;
+};
+export declare function validateUrl(url: string): {
+    valid: boolean;
+    error?: string;
+};
+export declare function validateUrlAsync(url: string): Promise<{
+    valid: boolean;
+    error?: string;
+}>;
+export declare function sanitizeInput(input: unknown): {
+    sanitized: string;
+    warnings: string[];
+    blocked: boolean;
+};
+//# sourceMappingURL=sandbox.d.ts.map

package/dist/core/sandbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.d.ts","sourceRoot":"","sources":["../../src/core/sandbox.ts"],"names":[],"mappings":"AAiDA,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQtD;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA8CvG;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAc3E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAyBzF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA0BzG"}

package/dist/core/sandbox.js

@@ -0,0 +1,168 @@
+import * as path from 'node:path';
+import * as dns from 'node:dns';
+import { getConfig } from './config.js';
+const MAX_PATH_LENGTH = 4096;
+const MAX_INPUT_LENGTH = 100000;
+const BLOCKED_PSEUDO_PATHS = ['/proc/', '/sys/', '/dev/'];
+const INTERNAL_IPS = [
+    '127.0.0.0/8',
+    '10.0.0.0/8',
+    '172.16.0.0/12',
+    '192.168.0.0/16',
+    '::1/128',
+    'fc00::/7',
+    'fe80::/10',
+];
+function normalizeIPv6(ip) {
+    const ipv4Mapped = /^::ffff:(\d+\.\d+\.\d+\.\d+)$/.exec(ip);
+    if (ipv4Mapped)
+        return ipv4Mapped[1];
+    const ipv4MappedLong = /^(?:0:){5}ffff:(\d+\.\d+\.\d+\.\d+)$/.exec(ip);
+    if (ipv4MappedLong)
+        return ipv4MappedLong[1];
+    return ip;
+}
+function ipv4ToNumber(ip) {
+    const parts = ip.split('.').map(Number);
+    return ((parts[0] << 24) | (parts[1] << 16) | (parts[2] << 8) | parts[3]) >>> 0;
+}
+function ipInCIDR(ip, cidr) {
+    if (ip.startsWith('::ffff:')) {
+        ip = normalizeIPv6(ip);
+    }
+    const [range, bitsStr] = cidr.split('/');
+    const bits = Number(bitsStr);
+    if (ip.includes(':')) {
+        return cidr.includes(':') && ip.startsWith(range.substring(0, range.indexOf(':') + 2));
+    }
+    if (range.includes(':'))
+        return false;
+    try {
+        const ipNum = ipv4ToNumber(ip);
+        const rangeNum = ipv4ToNumber(range);
+        const mask = ~(2 ** (32 - bits) - 1) >>> 0;
+        return (ipNum & mask) === (rangeNum & mask);
+    }
+    catch { /* silently handled */
+        return false;
+    }
+}
+export function isInternalIP(hostname) {
+    hostname = normalizeIPv6(hostname);
+    if (hostname === 'localhost' || hostname === '127.0.0.1' || hostname === '::1')
+        return true;
+    if (hostname.endsWith('.local') || hostname.endsWith('.internal'))
+        return true;
+    if (/^\d+\.\d+\.\d+\.\d+$/.test(hostname)) {
+        return INTERNAL_IPS.some(cidr => ipInCIDR(hostname, cidr));
+    }
+    return false;
+}
+export function validatePath(inputPath) {
+    const config = getConfig();
+    if (inputPath.length > MAX_PATH_LENGTH) {
+        return { valid: false, error: 'Path exceeds maximum length of 4096 characters' };
+    }
+    if (inputPath.includes('\0')) {
+        return { valid: false, error: 'Path contains null bytes' };
+    }
+    const normalizedForCheck = inputPath.replace(/\\/g, '/');
+    const isWindowsAbsolute = /^[A-Za-z]:\//.test(normalizedForCheck);
+    const isUnixAbsolute = normalizedForCheck.startsWith('/');
+    if (!isWindowsAbsolute && !isUnixAbsolute) {
+        return { valid: false, error: 'Path must be absolute' };
+    }
+    const lowerPath = normalizedForCheck.toLowerCase();
+    for (const pattern of BLOCKED_PSEUDO_PATHS) {
+        if (lowerPath.includes(pattern)) {
+            return { valid: false, error: 'Path to pseudo-filesystem is blocked' };
+        }
+    }
+    const resolved = path.resolve(inputPath);
+    const resolvedParts = resolved.split(path.sep);
+    if (resolvedParts.includes('..')) {
+        return { valid: false, error: 'Path traversal detected after resolution' };
+    }
+    const allowedDirs = config.security.allowedDirs.length > 0 ? config.security.allowedDirs : ['.'];
+    if (allowedDirs.length > 0) {
+        const isAllowed = allowedDirs.some((dir) => {
+            const resolvedDir = path.resolve(dir);
+            const relative = path.relative(resolvedDir, resolved);
+            const relativeParts = relative.split(path.sep);
+            return relativeParts[0] !== '..' && !path.isAbsolute(relative);
+        });
+        if (!isAllowed) {
+            return { valid: false, error: `Path not in allowed directories: ${resolved}` };
+        }
+    }
+    return { valid: true, normalized: resolved };
+}
+const SUSPICIOUS_PATTERNS = /[<>"';&|`$(){}\[\]!#~]|--|&&|\|\||\/\*|\*\//;
+export function validateUrl(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            return { valid: false, error: `Blocked protocol: ${parsed.protocol}` };
+        }
+        if (isInternalIP(parsed.hostname)) {
+            return { valid: false, error: 'URL points to internal/reserved IP' };
+        }
+        return { valid: true };
+    }
+    catch {
+        // silently handled
+        return { valid: false, error: 'Invalid URL format' };
+    }
+}
+export function validateUrlAsync(url) {
+    try {
+        const parsed = new URL(url);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            return Promise.resolve({ valid: false, error: `Blocked protocol: ${parsed.protocol}` });
+        }
+        return new Promise((resolve) => {
+            dns.lookup(parsed.hostname, { all: true }, (err, addresses) => {
+                if (err) {
+                    resolve({ valid: false, error: `DNS resolution failed: ${err.message}` });
+                    return;
+                }
+                for (const addr of addresses) {
+                    if (isInternalIP(addr.address)) {
+                        resolve({ valid: false, error: `URL resolves to internal IP: ${addr.address}` });
+                        return;
+                    }
+                }
+                resolve({ valid: true });
+            });
+        });
+    }
+    catch {
+        // silently handled
+        return Promise.resolve({ valid: false, error: 'Invalid URL format' });
+    }
+}
+export function sanitizeInput(input) {
+    const warnings = [];
+    let str = String(input ?? '');
+    const original = str;
+    let blocked = false;
+    if (str.length > MAX_INPUT_LENGTH) {
+        str = str.substring(0, MAX_INPUT_LENGTH);
+        warnings.push('Input truncated to 100000 characters');
+    }
+    if (SUSPICIOUS_PATTERNS.test(str)) {
+        warnings.push('Input contains special characters that may be unsafe in certain contexts');
+        blocked = true;
+    }
+    try {
+        JSON.parse(str);
+    }
+    catch {
+        // silently handled
+        if (str !== original && str.length < 200) {
+            warnings.push('Input is not valid JSON');
+        }
+    }
+    return { sanitized: str, warnings, blocked };
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/core/sandbox.js.map

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