apcore-js 0.4.0 → 0.6.0

package/dist/executor.js

@@ -0,0 +1,372 @@
+/**
+ * Executor and related utilities for apcore.
+ *
+ * Async-only execution pipeline. Python's call() + call_async() merge into one async call().
+ * Timeout uses Promise.race instead of threading.
+ */
+import { Value } from '@sinclair/typebox/value';
+import { Context } from './context.js';
+import { ExecutionCancelledError } from './cancel.js';
+import { ACLDeniedError, CallDepthExceededError, CallFrequencyExceededError, CircularCallError, InvalidInputError, ModuleNotFoundError, ModuleTimeoutError, SchemaValidationError, } from './errors.js';
+import { AfterMiddleware, BeforeMiddleware } from './middleware/index.js';
+import { MiddlewareChainError, MiddlewareManager } from './middleware/manager.js';
+export const REDACTED_VALUE = '***REDACTED***';
+export function redactSensitive(data, schemaDict) {
+    const redacted = JSON.parse(JSON.stringify(data));
+    redactFields(redacted, schemaDict);
+    redactSecretPrefix(redacted);
+    return redacted;
+}
+function redactFields(data, schemaDict) {
+    const properties = schemaDict['properties'];
+    if (!properties)
+        return;
+    for (const [fieldName, fieldSchema] of Object.entries(properties)) {
+        if (!(fieldName in data))
+            continue;
+        const value = data[fieldName];
+        if (fieldSchema['x-sensitive'] === true) {
+            if (value !== null && value !== undefined) {
+                data[fieldName] = REDACTED_VALUE;
+            }
+            continue;
+        }
+        if (fieldSchema['type'] === 'object' && 'properties' in fieldSchema && typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            redactFields(value, fieldSchema);
+            continue;
+        }
+        if (fieldSchema['type'] === 'array' && 'items' in fieldSchema && Array.isArray(value)) {
+            const itemsSchema = fieldSchema['items'];
+            if (itemsSchema['x-sensitive'] === true) {
+                for (let i = 0; i < value.length; i++) {
+                    if (value[i] !== null && value[i] !== undefined) {
+                        value[i] = REDACTED_VALUE;
+                    }
+                }
+            }
+            else if (itemsSchema['type'] === 'object' && 'properties' in itemsSchema) {
+                for (const item of value) {
+                    if (typeof item === 'object' && item !== null) {
+                        redactFields(item, itemsSchema);
+                    }
+                }
+            }
+        }
+    }
+}
+function redactSecretPrefix(data) {
+    for (const key of Object.keys(data)) {
+        const value = data[key];
+        if (key.startsWith('_secret_') && value !== null && value !== undefined) {
+            data[key] = REDACTED_VALUE;
+        }
+        else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            redactSecretPrefix(value);
+        }
+    }
+}
+export class Executor {
+    _registry;
+    _middlewareManager;
+    _acl;
+    _config;
+    _defaultTimeout;
+    _maxCallDepth;
+    _maxModuleRepeat;
+    constructor(options) {
+        this._registry = options.registry;
+        this._middlewareManager = new MiddlewareManager();
+        this._acl = options.acl ?? null;
+        this._config = options.config ?? null;
+        if (options.middlewares) {
+            for (const mw of options.middlewares) {
+                this._middlewareManager.add(mw);
+            }
+        }
+        if (this._config !== null) {
+            this._defaultTimeout = this._config.get('executor.default_timeout') ?? 30000;
+            this._maxCallDepth = this._config.get('executor.max_call_depth') ?? 32;
+            this._maxModuleRepeat = this._config.get('executor.max_module_repeat') ?? 3;
+        }
+        else {
+            this._defaultTimeout = 30000;
+            this._maxCallDepth = 32;
+            this._maxModuleRepeat = 3;
+        }
+    }
+    get registry() {
+        return this._registry;
+    }
+    get middlewares() {
+        return this._middlewareManager.snapshot();
+    }
+    /** Set the access control provider. */
+    setAcl(acl) {
+        this._acl = acl;
+    }
+    use(middleware) {
+        this._middlewareManager.add(middleware);
+        return this;
+    }
+    useBefore(callback) {
+        this._middlewareManager.add(new BeforeMiddleware(callback));
+        return this;
+    }
+    useAfter(callback) {
+        this._middlewareManager.add(new AfterMiddleware(callback));
+        return this;
+    }
+    remove(middleware) {
+        return this._middlewareManager.remove(middleware);
+    }
+    async call(moduleId, inputs, context) {
+        let effectiveInputs = inputs ?? {};
+        const ctx = this._createContext(moduleId, context);
+        this._checkSafety(moduleId, ctx);
+        const mod = this._lookupModule(moduleId);
+        this._checkAcl(moduleId, ctx);
+        effectiveInputs = this._validateInputs(mod, effectiveInputs, ctx);
+        return this._executeWithMiddleware(mod, moduleId, effectiveInputs, ctx);
+    }
+    /**
+     * Alias for call(). Provided for compatibility with MCP bridge packages
+     * that may call callAsync() by convention.
+     */
+    async callAsync(moduleId, inputs, context) {
+        return this.call(moduleId, inputs, context);
+    }
+    /**
+     * Streaming execution pipeline. If the module exposes a stream() async generator,
+     * yields each chunk. Otherwise falls back to call() and yields a single chunk.
+     *
+     * Pipeline: context -> safety -> lookup -> ACL -> validate inputs -> before-middleware
+     *   -> stream (or fallback to execute) -> validate accumulated output -> after-middleware
+     *
+     * Note: In the streaming path, after-middleware runs on the accumulated output for
+     * validation/side-effects but its return value is not yielded since chunks were already
+     * emitted. In the non-streaming fallback, after-middleware can transform the output.
+     */
+    async *stream(moduleId, inputs, context) {
+        let effectiveInputs = inputs ?? {};
+        const ctx = this._createContext(moduleId, context);
+        this._checkSafety(moduleId, ctx);
+        const mod = this._lookupModule(moduleId);
+        this._checkAcl(moduleId, ctx);
+        effectiveInputs = this._validateInputs(mod, effectiveInputs, ctx);
+        yield* this._streamWithMiddleware(mod, moduleId, effectiveInputs, ctx);
+    }
+    async *_streamWithMiddleware(mod, moduleId, inputs, ctx) {
+        let effectiveInputs = inputs;
+        let executedMiddlewares = [];
+        try {
+            try {
+                [effectiveInputs, executedMiddlewares] = this._middlewareManager.executeBefore(moduleId, effectiveInputs, ctx);
+            }
+            catch (e) {
+                if (e instanceof MiddlewareChainError) {
+                    executedMiddlewares = e.executedMiddlewares;
+                    const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, e.original, ctx, executedMiddlewares);
+                    if (recovery !== null) {
+                        yield recovery;
+                        return;
+                    }
+                    executedMiddlewares = [];
+                    throw e.original;
+                }
+                throw e;
+            }
+            // Cancel check before execution
+            if (ctx.cancelToken !== null) {
+                ctx.cancelToken.check();
+            }
+            const streamFn = mod['stream'];
+            if (typeof streamFn === 'function') {
+                // Module has a stream() method: iterate and yield each chunk
+                let accumulated = {};
+                for await (const chunk of streamFn.call(mod, effectiveInputs, ctx)) {
+                    accumulated = { ...accumulated, ...chunk };
+                    yield chunk;
+                }
+                // Validate accumulated output against output schema
+                this._validateOutput(mod, accumulated);
+                // Run after-middleware on the accumulated result
+                this._middlewareManager.executeAfter(moduleId, effectiveInputs, accumulated, ctx);
+            }
+            else {
+                // Fallback: execute normally and yield single chunk
+                let output = await this._executeWithTimeout(mod, moduleId, effectiveInputs, ctx);
+                this._validateOutput(mod, output);
+                output = this._middlewareManager.executeAfter(moduleId, effectiveInputs, output, ctx);
+                yield output;
+            }
+        }
+        catch (exc) {
+            if (exc instanceof ExecutionCancelledError)
+                throw exc;
+            if (executedMiddlewares.length > 0) {
+                const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, exc, ctx, executedMiddlewares);
+                if (recovery !== null) {
+                    yield recovery;
+                    return;
+                }
+            }
+            throw exc;
+        }
+    }
+    _createContext(moduleId, context) {
+        if (context == null) {
+            return Context.create(this).child(moduleId);
+        }
+        return context.child(moduleId);
+    }
+    _lookupModule(moduleId) {
+        const module = this._registry.get(moduleId);
+        if (module === null) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        return module;
+    }
+    _checkAcl(moduleId, ctx) {
+        if (this._acl !== null) {
+            const allowed = this._acl.check(ctx.callerId, moduleId, ctx);
+            if (!allowed) {
+                throw new ACLDeniedError(ctx.callerId, moduleId);
+            }
+        }
+    }
+    _validateInputs(mod, inputs, ctx) {
+        const inputSchema = mod['inputSchema'];
+        if (inputSchema == null)
+            return inputs;
+        this._validateSchema(inputSchema, inputs, 'Input');
+        ctx.redactedInputs = redactSensitive(inputs, inputSchema);
+        return inputs;
+    }
+    _validateSchema(schema, data, direction) {
+        if (Value.Check(schema, data))
+            return;
+        const errors = [];
+        for (const error of Value.Errors(schema, data)) {
+            errors.push({
+                field: error.path || '/',
+                code: String(error.type),
+                message: error.message,
+            });
+        }
+        throw new SchemaValidationError(`${direction} validation failed`, errors);
+    }
+    async _executeWithMiddleware(mod, moduleId, inputs, ctx) {
+        let effectiveInputs = inputs;
+        let executedMiddlewares = [];
+        try {
+            try {
+                [effectiveInputs, executedMiddlewares] = this._middlewareManager.executeBefore(moduleId, effectiveInputs, ctx);
+            }
+            catch (e) {
+                if (e instanceof MiddlewareChainError) {
+                    executedMiddlewares = e.executedMiddlewares;
+                    const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, e.original, ctx, executedMiddlewares);
+                    if (recovery !== null)
+                        return recovery;
+                    executedMiddlewares = [];
+                    throw e.original;
+                }
+                throw e;
+            }
+            // Cancel check before execution
+            if (ctx.cancelToken !== null) {
+                ctx.cancelToken.check();
+            }
+            let output = await this._executeWithTimeout(mod, moduleId, effectiveInputs, ctx);
+            this._validateOutput(mod, output);
+            output = this._middlewareManager.executeAfter(moduleId, effectiveInputs, output, ctx);
+            return output;
+        }
+        catch (exc) {
+            if (exc instanceof ExecutionCancelledError)
+                throw exc;
+            if (executedMiddlewares.length > 0) {
+                const recovery = this._middlewareManager.executeOnError(moduleId, effectiveInputs, exc, ctx, executedMiddlewares);
+                if (recovery !== null)
+                    return recovery;
+            }
+            throw exc;
+        }
+    }
+    _validateOutput(mod, output) {
+        const outputSchema = mod['outputSchema'];
+        if (outputSchema != null) {
+            this._validateSchema(outputSchema, output, 'Output');
+        }
+    }
+    validate(moduleId, inputs) {
+        const module = this._registry.get(moduleId);
+        if (module === null) {
+            throw new ModuleNotFoundError(moduleId);
+        }
+        const mod = module;
+        const inputSchema = mod['inputSchema'];
+        if (inputSchema == null) {
+            return { valid: true, errors: [] };
+        }
+        if (Value.Check(inputSchema, inputs)) {
+            return { valid: true, errors: [] };
+        }
+        const errors = [];
+        for (const error of Value.Errors(inputSchema, inputs)) {
+            errors.push({
+                field: error.path || '/',
+                code: String(error.type),
+                message: error.message,
+            });
+        }
+        return { valid: false, errors };
+    }
+    _checkSafety(moduleId, ctx) {
+        const callChain = ctx.callChain;
+        // Depth check
+        if (callChain.length > this._maxCallDepth) {
+            throw new CallDepthExceededError(callChain.length, this._maxCallDepth, [...callChain]);
+        }
+        // Circular detection (strict cycles of length >= 2)
+        const priorChain = callChain.slice(0, -1);
+        const lastIdx = priorChain.lastIndexOf(moduleId);
+        if (lastIdx !== -1) {
+            const subsequence = priorChain.slice(lastIdx + 1);
+            if (subsequence.length > 0) {
+                throw new CircularCallError(moduleId, [...callChain]);
+            }
+        }
+        // Frequency check
+        const count = callChain.filter((id) => id === moduleId).length;
+        if (count > this._maxModuleRepeat) {
+            throw new CallFrequencyExceededError(moduleId, count, this._maxModuleRepeat, [...callChain]);
+        }
+    }
+    async _executeWithTimeout(mod, moduleId, inputs, ctx) {
+        const timeoutMs = this._defaultTimeout;
+        if (timeoutMs < 0) {
+            throw new InvalidInputError(`Negative timeout: ${timeoutMs}ms`);
+        }
+        const executeFn = mod['execute'];
+        if (typeof executeFn !== 'function') {
+            throw new InvalidInputError(`Module '${moduleId}' has no execute method`);
+        }
+        const executionPromise = Promise.resolve(executeFn
+            .call(mod, inputs, ctx));
+        if (timeoutMs === 0) {
+            console.warn('[apcore:executor] Timeout is 0, timeout limit disabled');
+            return executionPromise;
+        }
+        let timer;
+        const timeoutPromise = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(new ModuleTimeoutError(moduleId, timeoutMs));
+            }, timeoutMs);
+        });
+        return Promise.race([executionPromise, timeoutPromise]).finally(() => {
+            clearTimeout(timer);
+        });
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/extensions.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Extension point framework for apcore.
+ *
+ * Provides a centralized mechanism to register, query, and wire custom
+ * extensions (discoverers, middleware, ACL providers, span exporters, and
+ * module validators) into the apcore runtime.
+ */
+import type { Executor } from './executor.js';
+import type { Registry } from './registry/registry.js';
+/**
+ * Describes a named slot where extensions can be registered.
+ */
+export interface ExtensionPoint {
+    readonly name: string;
+    readonly description: string;
+    readonly multiple: boolean;
+}
+/**
+ * Manages extension points and their registered implementations.
+ *
+ * Pre-registers five built-in extension points: discoverer, middleware,
+ * acl, span_exporter, and module_validator.
+ */
+export declare class ExtensionManager {
+    private _points;
+    private _extensions;
+    constructor();
+    /**
+     * Register an extension for the given extension point.
+     *
+     * @throws Error if point_name is unknown.
+     * @throws Error if extension does not satisfy the type constraint.
+     */
+    register(pointName: string, extension: unknown): void;
+    /**
+     * Return the single extension for a non-multiple point, or null.
+     */
+    get(pointName: string): unknown | null;
+    /**
+     * Return all extensions for a multiple-type point.
+     */
+    getAll(pointName: string): unknown[];
+    /**
+     * Remove a specific extension from an extension point.
+     * Returns true if found and removed, false otherwise.
+     */
+    unregister(pointName: string, extension: unknown): boolean;
+    /**
+     * Return all registered extension points.
+     */
+    listPoints(): ExtensionPoint[];
+    /**
+     * Wire all registered extensions into the given registry and executor.
+     */
+    apply(registry: Registry, executor: Executor): void;
+    private _findTracingMiddleware;
+}
+//# sourceMappingURL=extensions.d.ts.map

package/dist/extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../src/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAI9C,OAAO,KAAK,EAA+B,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAuBpF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AA4ED;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAsC;IACrD,OAAO,CAAC,WAAW,CAAyB;;IAU5C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAqBrD;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAQtC;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,EAAE;IAOpC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO;IAW1D;;OAEG;IACH,UAAU,IAAI,cAAc,EAAE;IAQ9B;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI;IA0CnD,OAAO,CAAC,sBAAsB;CAQ/B"}

package/dist/extensions.js

@@ -0,0 +1,220 @@
+/**
+ * Extension point framework for apcore.
+ *
+ * Provides a centralized mechanism to register, query, and wire custom
+ * extensions (discoverers, middleware, ACL providers, span exporters, and
+ * module validators) into the apcore runtime.
+ */
+import { TracingMiddleware } from './observability/tracing.js';
+/**
+ * Delegates span export to multiple underlying exporters.
+ */
+class CompositeExporter {
+    _exporters;
+    constructor(exporters) {
+        this._exporters = exporters;
+    }
+    export(span) {
+        for (const exp of this._exporters) {
+            try {
+                exp.export(span);
+            }
+            catch (e) {
+                console.warn('[apcore:extensions] Span exporter failed:', e);
+            }
+        }
+    }
+}
+/** Type guard: checks if value has a `discover` method. */
+function isDiscoverer(value) {
+    return typeof value === 'object' && value !== null && typeof value['discover'] === 'function';
+}
+/** Type guard: checks if value has a `validate` method. */
+function isModuleValidator(value) {
+    return typeof value === 'object' && value !== null && typeof value['validate'] === 'function';
+}
+/** Type guard: checks if value has at least one middleware method (before, after, onError). */
+function isMiddleware(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return typeof obj['before'] === 'function' || typeof obj['after'] === 'function' || typeof obj['onError'] === 'function';
+}
+/** Type guard: checks if value has a `check` method (ACL). */
+function isACL(value) {
+    return typeof value === 'object' && value !== null && typeof value['check'] === 'function';
+}
+/** Type guard: checks if value has an `export` method (SpanExporter). */
+function isSpanExporter(value) {
+    return typeof value === 'object' && value !== null && typeof value['export'] === 'function';
+}
+function builtInPoints() {
+    return new Map([
+        ['discoverer', {
+                name: 'discoverer',
+                description: 'Custom module discovery strategy',
+                multiple: false,
+                typeCheck: isDiscoverer,
+                typeName: 'Discoverer',
+            }],
+        ['middleware', {
+                name: 'middleware',
+                description: 'Execution middleware',
+                multiple: true,
+                typeCheck: isMiddleware,
+                typeName: 'Middleware',
+            }],
+        ['acl', {
+                name: 'acl',
+                description: 'Access control provider',
+                multiple: false,
+                typeCheck: isACL,
+                typeName: 'ACL',
+            }],
+        ['span_exporter', {
+                name: 'span_exporter',
+                description: 'Tracing span exporter',
+                multiple: true,
+                typeCheck: isSpanExporter,
+                typeName: 'SpanExporter',
+            }],
+        ['module_validator', {
+                name: 'module_validator',
+                description: 'Custom module validation',
+                multiple: false,
+                typeCheck: isModuleValidator,
+                typeName: 'ModuleValidator',
+            }],
+    ]);
+}
+/**
+ * Manages extension points and their registered implementations.
+ *
+ * Pre-registers five built-in extension points: discoverer, middleware,
+ * acl, span_exporter, and module_validator.
+ */
+export class ExtensionManager {
+    _points;
+    _extensions;
+    constructor() {
+        this._points = builtInPoints();
+        this._extensions = new Map();
+        for (const name of this._points.keys()) {
+            this._extensions.set(name, []);
+        }
+    }
+    /**
+     * Register an extension for the given extension point.
+     *
+     * @throws Error if point_name is unknown.
+     * @throws Error if extension does not satisfy the type constraint.
+     */
+    register(pointName, extension) {
+        const point = this._points.get(pointName);
+        if (point === undefined) {
+            throw new Error(`Unknown extension point: '${pointName}'. Available: ${[...this._points.keys()].sort().join(', ')}`);
+        }
+        if (!point.typeCheck(extension)) {
+            throw new TypeError(`Extension for '${pointName}' must satisfy the ${point.typeName} interface`);
+        }
+        if (point.multiple) {
+            this._extensions.get(pointName).push(extension);
+        }
+        else {
+            this._extensions.set(pointName, [extension]);
+        }
+    }
+    /**
+     * Return the single extension for a non-multiple point, or null.
+     */
+    get(pointName) {
+        if (!this._points.has(pointName)) {
+            throw new Error(`Unknown extension point: '${pointName}'`);
+        }
+        const exts = this._extensions.get(pointName);
+        return exts.length > 0 ? exts[0] : null;
+    }
+    /**
+     * Return all extensions for a multiple-type point.
+     */
+    getAll(pointName) {
+        if (!this._points.has(pointName)) {
+            throw new Error(`Unknown extension point: '${pointName}'`);
+        }
+        return [...this._extensions.get(pointName)];
+    }
+    /**
+     * Remove a specific extension from an extension point.
+     * Returns true if found and removed, false otherwise.
+     */
+    unregister(pointName, extension) {
+        if (!this._points.has(pointName)) {
+            throw new Error(`Unknown extension point: '${pointName}'`);
+        }
+        const exts = this._extensions.get(pointName);
+        const idx = exts.indexOf(extension);
+        if (idx === -1)
+            return false;
+        exts.splice(idx, 1);
+        return true;
+    }
+    /**
+     * Return all registered extension points.
+     */
+    listPoints() {
+        return [...this._points.values()].map(({ name, description, multiple }) => ({
+            name,
+            description,
+            multiple,
+        }));
+    }
+    /**
+     * Wire all registered extensions into the given registry and executor.
+     */
+    apply(registry, executor) {
+        // Discoverer
+        const discoverer = this.get('discoverer');
+        if (discoverer !== null) {
+            registry.setDiscoverer(discoverer);
+        }
+        // Module validator
+        const validator = this.get('module_validator');
+        if (validator !== null) {
+            registry.setValidator(validator);
+        }
+        // ACL
+        const acl = this.get('acl');
+        if (acl !== null) {
+            executor.setAcl(acl);
+        }
+        // Middleware
+        for (const mw of this.getAll('middleware')) {
+            executor.use(mw);
+        }
+        // Span exporters: find existing TracingMiddleware and set exporter(s)
+        const exporters = this.getAll('span_exporter');
+        if (exporters.length > 0) {
+            const tracingMw = this._findTracingMiddleware(executor);
+            if (tracingMw !== null) {
+                if (exporters.length === 1) {
+                    tracingMw.setExporter(exporters[0]);
+                }
+                else {
+                    tracingMw.setExporter(new CompositeExporter(exporters));
+                }
+            }
+            else {
+                console.warn('[apcore:extensions] span_exporter extensions registered but no TracingMiddleware found in executor middleware chain');
+            }
+        }
+    }
+    _findTracingMiddleware(executor) {
+        for (const mw of executor.middlewares) {
+            if (mw instanceof TracingMiddleware) {
+                return mw;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=extensions.js.map