@frontmcp/sdk 0.6.0 → 0.6.2

package/src/common/decorators/decorator-utils.js

@@ -1,195 +0,0 @@
-"use strict";
-/**
- * Decorator Utilities for Dual-Mode Support
- *
- * This module provides utilities for creating decorators that work with both:
- * - Legacy TypeScript decorators (experimentalDecorators: true)
- * - TC39 Stage 3 decorators (native JS, used by esbuild/tsx)
- *
- * The key difference between the two modes:
- *
- * LEGACY TypeScript Method Decorator:
- *   (target: prototype, propertyKey: string, descriptor: PropertyDescriptor) => void
- *   - target is the class prototype (for instance methods) or class (for static)
- *   - propertyKey is the method name
- *   - descriptor is the property descriptor
- *
- * TC39 Stage 3 Method Decorator:
- *   (target: method, context: ClassMethodDecoratorContext) => method
- *   - target is the actual method function being decorated
- *   - context is an object with { kind, name, static, private, addInitializer }
- *   - The class isn't available during decoration (only via addInitializer at instance creation)
- *
- * @example
- * ```typescript
- * // Using the factory to create a dual-mode decorator
- * const MyDecorator = createMethodDecorator<{ stage: string }>({
- *   createMetadata: (args, options) => ({
- *     methodName: args.methodName,
- *     stage: options.stage,
- *   }),
- *   onLegacyDecoration: (ctor, metadata) => {
- *     // Immediately register on class (legacy mode)
- *     registerOnClass(ctor, metadata);
- *   },
- * });
- *
- * // Usage (works in both modes):
- * class MyFlow {
- *   @MyDecorator({ stage: 'execute' })
- *   async execute() {}
- * }
- * ```
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PendingMetadataRegistry = void 0;
-exports.isTC39MethodContext = isTC39MethodContext;
-exports.isTC39ClassContext = isTC39ClassContext;
-exports.createDualModeMethodDecorator = createDualModeMethodDecorator;
-exports.createDualModeClassDecorator = createDualModeClassDecorator;
-/**
- * Check if decorator context is TC39 Stage 3 style
- */
-function isTC39MethodContext(arg) {
-    return typeof arg === 'object' && arg !== null && 'kind' in arg && arg.kind === 'method';
-}
-/**
- * Check if decorator context is TC39 Stage 3 class context
- */
-function isTC39ClassContext(arg) {
-    return typeof arg === 'object' && arg !== null && 'kind' in arg && arg.kind === 'class';
-}
-/**
- * Creates a method decorator that works with both legacy TypeScript and TC39 Stage 3 decorators.
- *
- * For legacy decorators: onLegacyDecoration is called immediately with class constructor
- * For TC39 decorators: storePendingMetadata is called, metadata resolved later via resolvePendingMetadataForClass
- */
-function createDualModeMethodDecorator(config) {
-    return (options) => {
-        return (target, keyOrContext, descriptor) => {
-            if (isTC39MethodContext(keyOrContext)) {
-                // TC39 Stage 3 decorator style
-                const context = keyOrContext;
-                const methodName = String(context.name);
-                const isStatic = context.static;
-                const method = target; // In TC39, target is the method function itself
-                const args = {
-                    method,
-                    methodName,
-                    isStatic,
-                    mode: 'tc39',
-                };
-                const metadata = config.createMetadata(args, options);
-                config.storePendingMetadata(method, metadata);
-                // Return the original method unchanged
-                return target;
-            }
-            else {
-                // Legacy TypeScript decorator style
-                const key = keyOrContext;
-                const methodName = String(key);
-                const isStatic = typeof target === 'function';
-                const method = descriptor?.value ?? target[key];
-                const ctor = isStatic ? target : target.constructor;
-                const args = {
-                    method,
-                    methodName,
-                    isStatic,
-                    mode: 'legacy',
-                };
-                const metadata = config.createMetadata(args, options);
-                // In legacy mode, we have immediate access to the class
-                if (config.onLegacyDecoration) {
-                    config.onLegacyDecoration(ctor, metadata);
-                }
-                // Return nothing to keep the original descriptor
-                return undefined;
-            }
-        };
-    };
-}
-/**
- * Storage for pending TC39 decorator metadata
- * Generic class that can be instantiated for different metadata types
- */
-class PendingMetadataRegistry {
-    pending = new WeakMap();
-    /**
-     * Store pending metadata for a method (TC39 mode)
-     */
-    store(method, metadata) {
-        const existing = this.pending.get(method) ?? [];
-        existing.push(metadata);
-        this.pending.set(method, existing);
-    }
-    /**
-     * Get and optionally clear pending metadata for a method
-     */
-    consume(method) {
-        const pending = this.pending.get(method) ?? [];
-        this.pending.delete(method);
-        return pending;
-    }
-    /**
-     * Resolve all pending metadata for a class by scanning its prototype and static members
-     */
-    resolveForClass(ctor, consume = true) {
-        const resolved = [];
-        // Scan instance methods on prototype
-        const proto = ctor.prototype;
-        if (proto) {
-            for (const name of Object.getOwnPropertyNames(proto)) {
-                if (name === 'constructor')
-                    continue;
-                try {
-                    const desc = Object.getOwnPropertyDescriptor(proto, name);
-                    const method = desc?.value;
-                    if (typeof method === 'function') {
-                        const pending = consume ? this.consume(method) : this.pending.get(method) ?? [];
-                        resolved.push(...pending);
-                    }
-                }
-                catch {
-                    // Ignore getter/setter errors
-                }
-            }
-        }
-        // Scan static methods on constructor
-        for (const name of Object.getOwnPropertyNames(ctor)) {
-            if (['prototype', 'length', 'name'].includes(name))
-                continue;
-            try {
-                const desc = Object.getOwnPropertyDescriptor(ctor, name);
-                const method = desc?.value;
-                if (typeof method === 'function') {
-                    const pending = consume ? this.consume(method) : this.pending.get(method) ?? [];
-                    resolved.push(...pending);
-                }
-            }
-            catch {
-                // Ignore getter/setter errors
-            }
-        }
-        return resolved;
-    }
-}
-exports.PendingMetadataRegistry = PendingMetadataRegistry;
-/**
- * Creates a class decorator that works with both legacy TypeScript and TC39 Stage 3 decorators.
- */
-function createDualModeClassDecorator(handler) {
-    return (options) => {
-        return (target, context) => {
-            if (isTC39ClassContext(context)) {
-                // TC39 Stage 3 class decorator
-                return handler(target, options, context) ?? target;
-            }
-            else {
-                // Legacy TypeScript class decorator
-                return handler(target, options) ?? target;
-            }
-        };
-    };
-}
-//# sourceMappingURL=decorator-utils.js.map

package/src/common/decorators/decorator-utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"decorator-utils.js","sourceRoot":"","sources":["../../../../src/common/decorators/decorator-utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Decorator Utilities for Dual-Mode Support\n *\n * This module provides utilities for creating decorators that work with both:\n * - Legacy TypeScript decorators (experimentalDecorators: true)\n * - TC39 Stage 3 decorators (native JS, used by esbuild/tsx)\n *\n * The key difference between the two modes:\n *\n * LEGACY TypeScript Method Decorator:\n *   (target: prototype, propertyKey: string, descriptor: PropertyDescriptor) => void\n *   - target is the class prototype (for instance methods) or class (for static)\n *   - propertyKey is the method name\n *   - descriptor is the property descriptor\n *\n * TC39 Stage 3 Method Decorator:\n *   (target: method, context: ClassMethodDecoratorContext) => method\n *   - target is the actual method function being decorated\n *   - context is an object with { kind, name, static, private, addInitializer }\n *   - The class isn't available during decoration (only via addInitializer at instance creation)\n *\n * @example\n * ```typescript\n * // Using the factory to create a dual-mode decorator\n * const MyDecorator = createMethodDecorator<{ stage: string }>({\n *   createMetadata: (args, options) => ({\n *     methodName: args.methodName,\n *     stage: options.stage,\n *   }),\n *   onLegacyDecoration: (ctor, metadata) => {\n *     // Immediately register on class (legacy mode)\n *     registerOnClass(ctor, metadata);\n *   },\n * });\n *\n * // Usage (works in both modes):\n * class MyFlow {\n *   @MyDecorator({ stage: 'execute' })\n *   async execute() {}\n * }\n * ```\n */\n\n/**\n * TC39 Stage 3 Method Decorator Context\n * @see https://github.com/tc39/proposal-decorators\n */\nexport interface TC39MethodContext {\n  readonly kind: 'method';\n  readonly name: string | symbol;\n  readonly static: boolean;\n  readonly private: boolean;\n  addInitializer(initializer: () => void): void;\n}\n\n/**\n * TC39 Stage 3 Class Decorator Context\n */\nexport interface TC39ClassContext {\n  readonly kind: 'class';\n  readonly name: string | undefined;\n  addInitializer(initializer: () => void): void;\n}\n\n/**\n * Normalized arguments passed to method decorator handlers\n */\nexport interface MethodDecoratorArgs {\n  /** The method function being decorated */\n  method: Function;\n  /** Method name as string */\n  methodName: string;\n  /** Whether this is a static method */\n  isStatic: boolean;\n  /** Decorator mode */\n  mode: 'legacy' | 'tc39';\n}\n\n/**\n * Configuration for creating a dual-mode method decorator\n */\nexport interface MethodDecoratorConfig<TOptions, TMetadata> {\n  /**\n   * Create metadata from decorator arguments and options\n   */\n  createMetadata: (args: MethodDecoratorArgs, options: TOptions) => TMetadata;\n\n  /**\n   * Called immediately during legacy decoration with access to the class\n   * Use this to register metadata directly on the class\n   */\n  onLegacyDecoration?: (ctor: Function, metadata: TMetadata) => void;\n\n  /**\n   * Store pending metadata for TC39 mode (required)\n   * The metadata will be resolved later when the class is processed\n   */\n  storePendingMetadata: (method: Function, metadata: TMetadata) => void;\n}\n\n/**\n * Check if decorator context is TC39 Stage 3 style\n */\nexport function isTC39MethodContext(arg: unknown): arg is TC39MethodContext {\n  return typeof arg === 'object' && arg !== null && 'kind' in arg && (arg as TC39MethodContext).kind === 'method';\n}\n\n/**\n * Check if decorator context is TC39 Stage 3 class context\n */\nexport function isTC39ClassContext(arg: unknown): arg is TC39ClassContext {\n  return typeof arg === 'object' && arg !== null && 'kind' in arg && (arg as TC39ClassContext).kind === 'class';\n}\n\n/**\n * Creates a method decorator that works with both legacy TypeScript and TC39 Stage 3 decorators.\n *\n * For legacy decorators: onLegacyDecoration is called immediately with class constructor\n * For TC39 decorators: storePendingMetadata is called, metadata resolved later via resolvePendingMetadataForClass\n */\nexport function createDualModeMethodDecorator<TOptions, TMetadata>(\n  config: MethodDecoratorConfig<TOptions, TMetadata>,\n): (options: TOptions) => MethodDecorator {\n  return (options: TOptions): MethodDecorator => {\n    return (target: any, keyOrContext: any, descriptor?: PropertyDescriptor): any => {\n      if (isTC39MethodContext(keyOrContext)) {\n        // TC39 Stage 3 decorator style\n        const context = keyOrContext;\n        const methodName = String(context.name);\n        const isStatic = context.static;\n        const method = target; // In TC39, target is the method function itself\n\n        const args: MethodDecoratorArgs = {\n          method,\n          methodName,\n          isStatic,\n          mode: 'tc39',\n        };\n\n        const metadata = config.createMetadata(args, options);\n        config.storePendingMetadata(method, metadata);\n\n        // Return the original method unchanged\n        return target;\n      } else {\n        // Legacy TypeScript decorator style\n        const key = keyOrContext;\n        const methodName = String(key);\n        const isStatic = typeof target === 'function';\n        const method = descriptor?.value ?? target[key];\n        const ctor = isStatic ? target : target.constructor;\n\n        const args: MethodDecoratorArgs = {\n          method,\n          methodName,\n          isStatic,\n          mode: 'legacy',\n        };\n\n        const metadata = config.createMetadata(args, options);\n\n        // In legacy mode, we have immediate access to the class\n        if (config.onLegacyDecoration) {\n          config.onLegacyDecoration(ctor, metadata);\n        }\n\n        // Return nothing to keep the original descriptor\n        return undefined;\n      }\n    };\n  };\n}\n\n/**\n * Storage for pending TC39 decorator metadata\n * Generic class that can be instantiated for different metadata types\n */\nexport class PendingMetadataRegistry<T> {\n  private pending = new WeakMap<Function, T[]>();\n\n  /**\n   * Store pending metadata for a method (TC39 mode)\n   */\n  store(method: Function, metadata: T): void {\n    const existing = this.pending.get(method) ?? [];\n    existing.push(metadata);\n    this.pending.set(method, existing);\n  }\n\n  /**\n   * Get and optionally clear pending metadata for a method\n   */\n  consume(method: Function): T[] {\n    const pending = this.pending.get(method) ?? [];\n    this.pending.delete(method);\n    return pending;\n  }\n\n  /**\n   * Resolve all pending metadata for a class by scanning its prototype and static members\n   */\n  resolveForClass(ctor: Function, consume = true): T[] {\n    const resolved: T[] = [];\n\n    // Scan instance methods on prototype\n    const proto = ctor.prototype;\n    if (proto) {\n      for (const name of Object.getOwnPropertyNames(proto)) {\n        if (name === 'constructor') continue;\n        try {\n          const desc = Object.getOwnPropertyDescriptor(proto, name);\n          const method = desc?.value;\n          if (typeof method === 'function') {\n            const pending = consume ? this.consume(method) : this.pending.get(method) ?? [];\n            resolved.push(...pending);\n          }\n        } catch {\n          // Ignore getter/setter errors\n        }\n      }\n    }\n\n    // Scan static methods on constructor\n    for (const name of Object.getOwnPropertyNames(ctor)) {\n      if (['prototype', 'length', 'name'].includes(name)) continue;\n      try {\n        const desc = Object.getOwnPropertyDescriptor(ctor, name);\n        const method = desc?.value;\n        if (typeof method === 'function') {\n          const pending = consume ? this.consume(method) : this.pending.get(method) ?? [];\n          resolved.push(...pending);\n        }\n      } catch {\n        // Ignore getter/setter errors\n      }\n    }\n\n    return resolved;\n  }\n}\n\n/**\n * Creates a class decorator that works with both legacy TypeScript and TC39 Stage 3 decorators.\n */\nexport function createDualModeClassDecorator<TOptions>(\n  handler: (ctor: Function, options: TOptions, context?: TC39ClassContext) => Function | void,\n): (options: TOptions) => ClassDecorator {\n  return (options: TOptions): ClassDecorator => {\n    return (target: any, context?: any): any => {\n      if (isTC39ClassContext(context)) {\n        // TC39 Stage 3 class decorator\n        return handler(target, options, context) ?? target;\n      } else {\n        // Legacy TypeScript class decorator\n        return handler(target, options) ?? target;\n      }\n    };\n  };\n}\n"]}

package/src/common/decorators/flow.decorator.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpFlow = FrontMcpFlow;
-exports.Flow = FrontMcpFlow;
-const metadata_1 = require("../metadata");
-const tokens_1 = require("../tokens");
-/**
- * Decorator that marks a class as a FrontMcpFlow module and provides metadata
- */
-function FrontMcpFlow(providedMetadata) {
-    return (target) => {
-        const metadata = metadata_1.frontMcpFlowMetadataSchema.parse(providedMetadata);
-        Reflect.defineMetadata(tokens_1.FrontMcpFlowTokens.type, true, target);
-        for (const property in metadata) {
-            Reflect.defineMetadata(tokens_1.FrontMcpFlowTokens[property] ?? property, metadata[property], target);
-        }
-    };
-}
-//# sourceMappingURL=flow.decorator.js.map

package/src/common/decorators/flow.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/flow.decorator.ts"],"names":[],"mappings":";;AAsBE,oCAAY;AACI,4BAAI;AAvBtB,0CAAiF;AACjF,sCAA+C;AAI/C;;GAEG;AACH,SAAS,YAAY,CAAwB,gBAAoC;IAE/E,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,qCAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEpE,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAE9D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { FlowMetadata, FlowName, frontMcpFlowMetadataSchema } from '../metadata';\nimport { FrontMcpFlowTokens } from '../tokens';\n\n\n\n/**\n * Decorator that marks a class as a FrontMcpFlow module and provides metadata\n */\nfunction FrontMcpFlow<Name extends FlowName>(providedMetadata: FlowMetadata<Name>): ClassDecorator {\n\n  return (target: any) => {\n    const metadata = frontMcpFlowMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpFlowTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpFlowTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpFlow,\n  FrontMcpFlow as Flow,\n}"]}

package/src/common/decorators/front-mcp.decorator.js

@@ -1,67 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcp = FrontMcp;
-require("reflect-metadata");
-const tokens_1 = require("../tokens");
-const metadata_1 = require("../metadata");
-const migrate_1 = require("../migrate");
-/**
- * Decorator that marks a class as a FrontMcp Server and provides metadata
- */
-function FrontMcp(providedMetadata) {
-    return (target) => {
-        // Apply migration for deprecated auth.transport and session configs
-        const migratedMetadata = (0, migrate_1.applyMigration)(providedMetadata);
-        const { error, data: metadata } = metadata_1.frontMcpMetadataSchema.safeParse(migratedMetadata);
-        if (error) {
-            if (error.format().apps) {
-                throw new Error(`Invalid metadata provided to @FrontMcp { apps: [?] }: \n${JSON.stringify(error.format().apps, null, 2)}`);
-            }
-            if (error.format().providers) {
-                throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \n${JSON.stringify(error.format().providers, null, 2)}`);
-            }
-            const loggingFormat = error.format()['logging'];
-            if (loggingFormat?.['transports']) {
-                throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \n${JSON.stringify(loggingFormat['transports'], null, 2)}`);
-            }
-            throw error;
-        }
-        Reflect.defineMetadata(tokens_1.FrontMcpTokens.type, true, target);
-        for (const property in metadata) {
-            Reflect.defineMetadata(tokens_1.FrontMcpTokens[property] ?? property, metadata[property], target);
-        }
-        // Safe check for serverless mode - process.env may not exist in Cloudflare Workers
-        const isServerless = typeof process !== 'undefined' && process.env?.['FRONTMCP_SERVERLESS'] === '1';
-        if (isServerless) {
-            // Serverless mode: bootstrap, prepare (no listen), store handler globally
-            const sdk = '@frontmcp/sdk';
-            import(sdk)
-                .then(({ FrontMcpInstance, setServerlessHandler, setServerlessHandlerPromise, setServerlessHandlerError }) => {
-                if (!FrontMcpInstance) {
-                    throw new Error(`${sdk} version mismatch, make sure you have the same version for all @frontmcp/* packages`);
-                }
-                const handlerPromise = FrontMcpInstance.createHandler(metadata);
-                setServerlessHandlerPromise(handlerPromise);
-                handlerPromise.then(setServerlessHandler).catch((err) => {
-                    const e = err instanceof Error ? err : new Error(String(err));
-                    setServerlessHandlerError(e);
-                    console.error('[FrontMCP] Serverless initialization failed:', e);
-                });
-            })
-                .catch((err) => {
-                console.error('[FrontMCP] Failed to import @frontmcp/sdk for serverless init:', err);
-            });
-        }
-        else if (metadata.serve) {
-            // Normal mode: bootstrap and start server
-            const sdk = '@frontmcp/sdk';
-            import(sdk).then(({ FrontMcpInstance }) => {
-                if (!FrontMcpInstance) {
-                    throw new Error(`${sdk} version mismatch, make sure you have the same version for all @frontmcp/* packages`);
-                }
-                FrontMcpInstance.bootstrap(metadata);
-            });
-        }
-    };
-}
-//# sourceMappingURL=front-mcp.decorator.js.map

package/src/common/decorators/front-mcp.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"front-mcp.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpTokens } from '../tokens';\nimport { FrontMcpMetadata, frontMcpMetadataSchema } from '../metadata';\nimport { FrontMcpInstance } from '../../front-mcp';\nimport { applyMigration } from '../migrate';\n\n/**\n * Decorator that marks a class as a FrontMcp Server and provides metadata\n */\nexport function FrontMcp(providedMetadata: FrontMcpMetadata): ClassDecorator {\n  return (target: Function) => {\n    // Apply migration for deprecated auth.transport and session configs\n    const migratedMetadata = applyMigration(providedMetadata);\n    const { error, data: metadata } = frontMcpMetadataSchema.safeParse(migratedMetadata);\n    if (error) {\n      if (error.format().apps) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcp { apps: [?] }: \\n${JSON.stringify(error.format().apps, null, 2)}`,\n        );\n      }\n      if (error.format().providers) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcp { providers: [?] }: \\n${JSON.stringify(\n            error.format().providers,\n            null,\n            2,\n          )}`,\n        );\n      }\n      const loggingFormat = error.format()['logging'] as Record<string, unknown> | undefined;\n      if (loggingFormat?.['transports']) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \\n${JSON.stringify(\n            loggingFormat['transports'],\n            null,\n            2,\n          )}`,\n        );\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpTokens[property] ?? property, metadata[property], target);\n    }\n\n    // Safe check for serverless mode - process.env may not exist in Cloudflare Workers\n    const isServerless = typeof process !== 'undefined' && process.env?.['FRONTMCP_SERVERLESS'] === '1';\n\n    if (isServerless) {\n      // Serverless mode: bootstrap, prepare (no listen), store handler globally\n      const sdk = '@frontmcp/sdk';\n      import(sdk)\n        .then(({ FrontMcpInstance, setServerlessHandler, setServerlessHandlerPromise, setServerlessHandlerError }) => {\n          if (!FrontMcpInstance) {\n            throw new Error(\n              `${sdk} version mismatch, make sure you have the same version for all @frontmcp/* packages`,\n            );\n          }\n\n          const handlerPromise = FrontMcpInstance.createHandler(metadata);\n          setServerlessHandlerPromise(handlerPromise);\n          handlerPromise.then(setServerlessHandler).catch((err: unknown) => {\n            const e = err instanceof Error ? err : new Error(String(err));\n            setServerlessHandlerError(e);\n            console.error('[FrontMCP] Serverless initialization failed:', e);\n          });\n        })\n        .catch((err: unknown) => {\n          console.error('[FrontMCP] Failed to import @frontmcp/sdk for serverless init:', err);\n        });\n    } else if (metadata.serve) {\n      // Normal mode: bootstrap and start server\n      const sdk = '@frontmcp/sdk';\n      import(sdk).then(({ FrontMcpInstance }) => {\n        if (!FrontMcpInstance) {\n          throw new Error(`${sdk} version mismatch, make sure you have the same version for all @frontmcp/* packages`);\n        }\n\n        FrontMcpInstance.bootstrap(metadata);\n      });\n    }\n  };\n}\n"]}

package/src/common/decorators/hook.decorator.js

@@ -1,178 +0,0 @@
-"use strict";
-/**
- * Flow Hook Decorators
- *
- * This module provides decorators for defining flow stages and lifecycle hooks.
- * Supports both legacy TypeScript decorators and TC39 Stage 3 decorators.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolvePendingTC39HooksForClass = resolvePendingTC39HooksForClass;
-exports.registerPendingTC39Hook = registerPendingTC39Hook;
-exports.consumePendingTC39Hooks = consumePendingTC39Hooks;
-exports.StageHookOf = StageHookOf;
-exports.WillHookOf = WillHookOf;
-exports.DidHookOf = DidHookOf;
-exports.AroundHookOf = AroundHookOf;
-exports.FlowHooksOf = FlowHooksOf;
-const tokens_1 = require("../tokens");
-const decorator_utils_1 = require("./decorator-utils");
-/**
- * Pending metadata registry for TC39 decorators
- * Stores hook metadata keyed by method function until class is processed
- */
-const pendingHookRegistry = new decorator_utils_1.PendingMetadataRegistry();
-/**
- * Register hook metadata on a class constructor
- */
-function registerHookOnClass(ctor, meta) {
-    const arr = Reflect.getMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, ctor) ?? [];
-    arr.push(meta);
-    Reflect.defineMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, arr, ctor);
-}
-/**
- * Resolve all pending TC39 hooks for a class by scanning its prototype
- * This is called by collectFlowHookMap during flow registration
- */
-function resolvePendingTC39HooksForClass(ctor) {
-    return pendingHookRegistry.resolveForClass(ctor);
-}
-/**
- * Store a pending hook for TC39 mode
- * @internal
- */
-function registerPendingTC39Hook(method, meta) {
-    pendingHookRegistry.store(method, meta);
-}
-/**
- * Get and clear pending hooks for a method (TC39 mode)
- * @internal
- */
-function consumePendingTC39Hooks(method) {
-    return pendingHookRegistry.consume(method);
-}
-/**
- * Base factory for creating hook decorators
- * Works with both legacy TypeScript and TC39 Stage 3 decorators
- */
-function make(flow, type) {
-    return function (stage, opts = {}) {
-        return (target, keyOrContext, _desc) => {
-            const { priority = 0, filter, ...rest } = opts;
-            // Detect TC39 Stage 3 decorators vs legacy TypeScript decorators
-            if ((0, decorator_utils_1.isTC39MethodContext)(keyOrContext)) {
-                // TC39 Stage 3 decorator style
-                const context = keyOrContext;
-                const methodName = String(context.name);
-                const isStatic = context.static;
-                const method = target; // In TC39, target is the method function itself
-                const meta = {
-                    ...rest,
-                    [tokens_1.FrontMcpFlowHookTokens.type]: true,
-                    flow: flow,
-                    type: type,
-                    stage: stage,
-                    method: methodName,
-                    priority: priority,
-                    filter: filter,
-                    target: null, // Will be resolved at execution time
-                    static: isStatic,
-                };
-                // Store as pending - resolved when collectFlowHookMap processes the class
-                pendingHookRegistry.store(method, meta);
-                // Return the original method unchanged
-                return target;
-            }
-            else {
-                // Legacy TypeScript decorator style
-                const key = keyOrContext;
-                const methodName = String(key);
-                const isStatic = typeof target === 'function';
-                const ctor = isStatic ? target : target.constructor;
-                const meta = {
-                    ...rest,
-                    [tokens_1.FrontMcpFlowHookTokens.type]: true,
-                    flow: flow,
-                    type: type,
-                    stage: stage,
-                    method: methodName,
-                    priority: priority,
-                    filter: filter,
-                    target: target,
-                    static: isStatic,
-                };
-                // Register immediately on the class
-                registerHookOnClass(ctor, meta);
-                return undefined;
-            }
-        };
-    };
-}
-/**
- * Creates a typed Stage hook decorator for a specific flow
- * @example
- * ```typescript
- * const { Stage } = FlowHooksOf('http:request');
- *
- * class HttpRequestFlow {
- *   @Stage('checkAuthorization')
- *   async checkAuthorization() { ... }
- * }
- * ```
- */
-function StageHookOf(flow) {
-    const base = make(flow, 'stage');
-    return function (stage, opts = {}) {
-        return base(stage, opts);
-    };
-}
-/**
- * Creates a typed Will hook decorator (runs before stage)
- */
-function WillHookOf(flow) {
-    const base = make(flow, 'will');
-    return function (stage, opts = {}) {
-        return base(stage, opts);
-    };
-}
-/**
- * Creates a typed Did hook decorator (runs after stage)
- */
-function DidHookOf(flow) {
-    const base = make(flow, 'did');
-    return function (stage, opts = {}) {
-        return base(stage, opts);
-    };
-}
-/**
- * Creates a typed Around hook decorator (wraps stage execution)
- */
-function AroundHookOf(name) {
-    const base = make(name, 'around');
-    return function (stage, opts = {}) {
-        return base(stage, opts);
-    };
-}
-/**
- * Creates all hook decorators for a specific flow
- * @example
- * ```typescript
- * const { Stage, Will, Did, Around } = FlowHooksOf('http:request');
- *
- * class HttpRequestFlow {
- *   @Stage('checkAuthorization')
- *   async checkAuthorization() { ... }
- *
- *   @Will('execute', { priority: 10 })
- *   async beforeExecute() { ... }
- * }
- * ```
- */
-function FlowHooksOf(name) {
-    return {
-        Stage: StageHookOf(name),
-        Will: WillHookOf(name),
-        Did: DidHookOf(name),
-        Around: AroundHookOf(name),
-    };
-}
-//# sourceMappingURL=hook.decorator.js.map

package/src/common/decorators/hook.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/hook.decorator.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Flow Hook Decorators\n *\n * This module provides decorators for defining flow stages and lifecycle hooks.\n * Supports both legacy TypeScript decorators and TC39 Stage 3 decorators.\n */\n\nimport { HookStageType, HookOptions, FlowName, HookMetadata } from '../metadata';\nimport { FrontMcpFlowHookTokens } from '../tokens';\nimport { isTC39MethodContext, PendingMetadataRegistry, type TC39MethodContext } from './decorator-utils';\n\n/**\n * Pending metadata registry for TC39 decorators\n * Stores hook metadata keyed by method function until class is processed\n */\nconst pendingHookRegistry = new PendingMetadataRegistry<HookMetadata>();\n\n/**\n * Register hook metadata on a class constructor\n */\nfunction registerHookOnClass(ctor: Function, meta: HookMetadata): void {\n  const arr = Reflect.getMetadata(FrontMcpFlowHookTokens.hooks, ctor) ?? [];\n  arr.push(meta);\n  Reflect.defineMetadata(FrontMcpFlowHookTokens.hooks, arr, ctor);\n}\n\n/**\n * Resolve all pending TC39 hooks for a class by scanning its prototype\n * This is called by collectFlowHookMap during flow registration\n */\nexport function resolvePendingTC39HooksForClass(ctor: Function): HookMetadata[] {\n  return pendingHookRegistry.resolveForClass(ctor);\n}\n\n/**\n * Store a pending hook for TC39 mode\n * @internal\n */\nexport function registerPendingTC39Hook(method: Function, meta: HookMetadata): void {\n  pendingHookRegistry.store(method, meta);\n}\n\n/**\n * Get and clear pending hooks for a method (TC39 mode)\n * @internal\n */\nexport function consumePendingTC39Hooks(method: Function): HookMetadata[] {\n  return pendingHookRegistry.consume(method);\n}\n\n/**\n * Base factory for creating hook decorators\n * Works with both legacy TypeScript and TC39 Stage 3 decorators\n */\nfunction make(flow: FlowName, type: HookStageType) {\n  return function <Ctx = unknown, T extends string = string>(stage: T, opts: HookOptions<Ctx> = {}): MethodDecorator {\n    return (target: any, keyOrContext: any, _desc?: PropertyDescriptor): any => {\n      const { priority = 0, filter, ...rest } = opts;\n\n      // Detect TC39 Stage 3 decorators vs legacy TypeScript decorators\n      if (isTC39MethodContext(keyOrContext)) {\n        // TC39 Stage 3 decorator style\n        const context = keyOrContext as TC39MethodContext;\n        const methodName = String(context.name);\n        const isStatic = context.static;\n        const method = target; // In TC39, target is the method function itself\n\n        const meta: HookMetadata = {\n          ...rest,\n          [FrontMcpFlowHookTokens.type]: true,\n          flow: flow,\n          type: type,\n          stage: stage,\n          method: methodName,\n          priority: priority,\n          filter: filter,\n          target: null, // Will be resolved at execution time\n          static: isStatic,\n        };\n\n        // Store as pending - resolved when collectFlowHookMap processes the class\n        pendingHookRegistry.store(method, meta);\n\n        // Return the original method unchanged\n        return target;\n      } else {\n        // Legacy TypeScript decorator style\n        const key = keyOrContext;\n        const methodName = String(key);\n        const isStatic = typeof target === 'function';\n        const ctor = isStatic ? target : target.constructor;\n\n        const meta: HookMetadata = {\n          ...rest,\n          [FrontMcpFlowHookTokens.type]: true,\n          flow: flow,\n          type: type,\n          stage: stage,\n          method: methodName,\n          priority: priority,\n          filter: filter,\n          target: target,\n          static: isStatic,\n        };\n\n        // Register immediately on the class\n        registerHookOnClass(ctor, meta);\n\n        return undefined;\n      }\n    };\n  };\n}\n\n/**\n * Creates a typed Stage hook decorator for a specific flow\n * @example\n * ```typescript\n * const { Stage } = FlowHooksOf('http:request');\n *\n * class HttpRequestFlow {\n *   @Stage('checkAuthorization')\n *   async checkAuthorization() { ... }\n * }\n * ```\n */\nexport function StageHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(flow, 'stage');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates a typed Will hook decorator (runs before stage)\n */\nexport function WillHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(flow, 'will');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates a typed Did hook decorator (runs after stage)\n */\nexport function DidHookOf<Name extends FlowName>(flow: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(flow, 'did');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates a typed Around hook decorator (wraps stage execution)\n */\nexport function AroundHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage'];\n  type Ctx = ExtendFlows[Name]['ctx'];\n  const base = make(name, 'around');\n  return function (stage: T, opts: HookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\n/**\n * Creates all hook decorators for a specific flow\n * @example\n * ```typescript\n * const { Stage, Will, Did, Around } = FlowHooksOf('http:request');\n *\n * class HttpRequestFlow {\n *   @Stage('checkAuthorization')\n *   async checkAuthorization() { ... }\n *\n *   @Will('execute', { priority: 10 })\n *   async beforeExecute() { ... }\n * }\n * ```\n */\nexport function FlowHooksOf<Name extends FlowName>(name: Name) {\n  return {\n    Stage: StageHookOf(name),\n    Will: WillHookOf(name),\n    Did: DidHookOf(name),\n    Around: AroundHookOf(name),\n  };\n}\n"]}

package/src/common/decorators/index.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./front-mcp.decorator"), exports);
-tslib_1.__exportStar(require("./flow.decorator"), exports);
-tslib_1.__exportStar(require("./hook.decorator"), exports);
-tslib_1.__exportStar(require("./app.decorator"), exports);
-tslib_1.__exportStar(require("./provider.decorator"), exports);
-tslib_1.__exportStar(require("./auth-provider.decorator"), exports);
-tslib_1.__exportStar(require("./adapter.decorator"), exports);
-tslib_1.__exportStar(require("./plugin.decorator"), exports);
-tslib_1.__exportStar(require("./tool.decorator"), exports);
-tslib_1.__exportStar(require("./resource.decorator"), exports);
-tslib_1.__exportStar(require("./prompt.decorator"), exports);
-tslib_1.__exportStar(require("./logger.decorator"), exports);
-//# sourceMappingURL=index.js.map

package/src/common/decorators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/common/decorators/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,2DAAiC;AACjC,2DAAiC;AACjC,0DAAgC;AAChC,+DAAqC;AACrC,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,2DAAiC;AACjC,+DAAqC;AACrC,6DAAmC;AACnC,6DAAmC","sourcesContent":["export * from './front-mcp.decorator';\nexport * from './flow.decorator';\nexport * from './hook.decorator';\nexport * from './app.decorator';\nexport * from './provider.decorator';\nexport * from './auth-provider.decorator';\nexport * from './adapter.decorator';\nexport * from './plugin.decorator';\nexport * from './tool.decorator';\nexport * from './resource.decorator';\nexport * from './prompt.decorator';\nexport * from './logger.decorator';\n"]}

package/src/common/decorators/logger.decorator.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpLogTransport = FrontMcpLogTransport;
-exports.LogTransport = FrontMcpLogTransport;
-require("reflect-metadata");
-const tokens_1 = require("../tokens");
-const metadata_1 = require("../metadata");
-/**
- * Decorator that marks a class as a FrontMcpLogger module and provides metadata
- */
-function FrontMcpLogTransport(providedMetadata) {
-    return (target) => {
-        const { error, data: metadata } = metadata_1.frontMcpLogTransportMetadataSchema.safeParse(providedMetadata);
-        Reflect.defineMetadata(tokens_1.FrontMcpLogTransportTokens.type, true, target);
-        for (const property in metadata) {
-            Reflect.defineMetadata(tokens_1.FrontMcpLogTransportTokens[property] ?? property, metadata[property], target);
-        }
-    };
-}
-//# sourceMappingURL=logger.decorator.js.map

package/src/common/decorators/logger.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"logger.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/logger.decorator.ts"],"names":[],"mappings":";;AAsBE,oDAAoB;AACI,4CAAY;AAvBtC,4BAA0B;AAC1B,sCAAuD;AACvD,0CAGqB;AAErB;;GAEG;AACH,SAAS,oBAAoB,CAAC,gBAAsC;IAClE,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,6CAAkC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAEjG,OAAO,CAAC,cAAc,CAAC,mCAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACtE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,mCAA0B,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACvG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpLogTransportTokens } from '../tokens';\nimport {\n  LogTransportMetadata,\n  frontMcpLogTransportMetadataSchema,\n} from '../metadata';\n\n/**\n * Decorator that marks a class as a FrontMcpLogger module and provides metadata\n */\nfunction FrontMcpLogTransport(providedMetadata: LogTransportMetadata): ClassDecorator {\n  return (target: Function) => {\n    const { error, data: metadata } = frontMcpLogTransportMetadataSchema.safeParse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpLogTransportTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpLogTransportTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpLogTransport,\n  FrontMcpLogTransport as LogTransport,\n};"]}

package/src/common/decorators/plugin.decorator.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpPlugin = FrontMcpPlugin;
-exports.Plugin = FrontMcpPlugin;
-require("reflect-metadata");
-const tokens_1 = require("../tokens");
-const metadata_1 = require("../metadata");
-/**
- * Decorator that marks a class as a McpPlugin and provides metadata
- */
-function FrontMcpPlugin(providedMetadata) {
-    return (target) => {
-        const { error, data: metadata } = metadata_1.frontMcpPluginMetadataSchema.safeParse(providedMetadata);
-        if (error) {
-            const formatted = error.format();
-            if (formatted.providers) {
-                throw new Error(`Invalid metadata provided to @FrontMcpProvider or @Provider: \n${JSON.stringify(formatted.providers, null, 2)}`);
-            }
-            if (formatted.adapters) {
-                throw new Error(`Invalid metadata provided to @FrontMcpAdapter or @Adapter: \n${JSON.stringify(formatted.adapters, null, 2)}`);
-            }
-            if (formatted.tools) {
-                throw new Error(`Invalid metadata provided to @FrontMcpTool or @Tool: \n${JSON.stringify(formatted.tools, null, 2)}`);
-            }
-            if (formatted.resources) {
-                throw new Error(`Invalid metadata provided to @FrontMcpResource or @Resource: \n${JSON.stringify(formatted.resources, null, 2)}`);
-            }
-            if (formatted.prompts) {
-                throw new Error(`Invalid metadata provided to @FrontMcpPrompt or @Prompt: \n${JSON.stringify(formatted.prompts, null, 2)}`);
-            }
-            throw error;
-        }
-        Reflect.defineMetadata(tokens_1.FrontMcpPluginTokens.type, true, target);
-        for (const property in metadata) {
-            Reflect.defineMetadata(tokens_1.FrontMcpPluginTokens[property] ?? property, metadata[property], target);
-        }
-    };
-}
-//# sourceMappingURL=plugin.decorator.js.map

package/src/common/decorators/plugin.decorator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/plugin.decorator.ts"],"names":[],"mappings":";;AAuDS,wCAAc;AAAoB,gCAAM;AAvDjD,4BAA0B;AAC1B,sCAAiD;AACjD,0CAA2E;AAE3E;;GAEG;AACH,SAAS,cAAc,CAAC,gBAAgC;IACtD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,uCAA4B,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3F,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,kEAAkE,IAAI,CAAC,SAAS,CAC9E,SAAS,CAAC,SAAS,EACnB,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CACb,gEAAgE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC9G,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,KAAK,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,0DAA0D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CACrG,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,kEAAkE,IAAI,CAAC,SAAS,CAC9E,SAAS,CAAC,SAAS,EACnB,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;YACJ,CAAC;YACD,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;gBACtB,MAAM,IAAI,KAAK,CACb,8DAA8D,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC3G,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACjG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpPluginTokens } from '../tokens';\nimport { PluginMetadata, frontMcpPluginMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpPlugin and provides metadata\n */\nfunction FrontMcpPlugin(providedMetadata: PluginMetadata): ClassDecorator {\n  return (target: Function) => {\n    const { error, data: metadata } = frontMcpPluginMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      const formatted = error.format();\n      if (formatted.providers) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpProvider or @Provider: \\n${JSON.stringify(\n            formatted.providers,\n            null,\n            2,\n          )}`,\n        );\n      }\n      if (formatted.adapters) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpAdapter or @Adapter: \\n${JSON.stringify(formatted.adapters, null, 2)}`,\n        );\n      }\n      if (formatted.tools) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpTool or @Tool: \\n${JSON.stringify(formatted.tools, null, 2)}`,\n        );\n      }\n      if (formatted.resources) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpResource or @Resource: \\n${JSON.stringify(\n            formatted.resources,\n            null,\n            2,\n          )}`,\n        );\n      }\n      if (formatted.prompts) {\n        throw new Error(\n          `Invalid metadata provided to @FrontMcpPrompt or @Prompt: \\n${JSON.stringify(formatted.prompts, null, 2)}`,\n        );\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpPluginTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpPluginTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport { FrontMcpPlugin, FrontMcpPlugin as Plugin };\n"]}