@frontmcp/sdk 0.4.0 → 0.5.0

package/src/common/common.schema.d.ts

@@ -3,26 +3,12 @@ import { z } from 'zod';
 export declare const RedirectSchema: z.ZodObject<{
     status: z.ZodLiteral<302>;
     location: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: 302;
-    location: string;
-}, {
-    status: 302;
-    location: string;
-}>;
+}, z.core.$strip>;
 export declare const NotFoundSchema: z.ZodObject<{
     status: z.ZodLiteral<404>;
     body: z.ZodAny;
     message: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    status: 404;
-    body?: any;
-}, {
-    message: string;
-    status: 404;
-    body?: any;
-}>;
+}, z.core.$strip>;
 type CommonResponseResult = z.infer<typeof RedirectSchema> | z.infer<typeof NotFoundSchema> | any;
 export declare const commonSuccessResponseHandler: (res: ServerResponse, result: CommonResponseResult) => void;
 export declare const commonFailResponseHandler: (res: ServerResponse, result: any) => void;

package/src/common/constants.d.ts

@@ -1,2 +1,5 @@
 export declare const MCP_SESSION_HOOKS = "mcp.plugin.sessionHooks";
 export declare const MCP_AUTH_HOOKS = "mcp.plugin.sessionHooks";
+export declare const META_ASYNC_WITH: unique symbol;
+export declare const META_ASYNC_WITH_TOKENS: unique symbol;
+export declare const DESIGN_PARAMTYPES = "design:paramtypes";

package/src/common/constants.js

@@ -1,8 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MCP_AUTH_HOOKS = exports.MCP_SESSION_HOOKS = void 0;
+exports.DESIGN_PARAMTYPES = exports.META_ASYNC_WITH_TOKENS = exports.META_ASYNC_WITH = exports.MCP_AUTH_HOOKS = exports.MCP_SESSION_HOOKS = void 0;
 // Plugin/global Tool hooks (method-level) metadata key
 // Stored on plugin classes by @ToolHook decorator
 exports.MCP_SESSION_HOOKS = 'mcp.plugin.sessionHooks';
 exports.MCP_AUTH_HOOKS = 'mcp.plugin.sessionHooks';
+// Metadata keys for async dependency injection
+exports.META_ASYNC_WITH = Symbol('mcp.asyncWith');
+exports.META_ASYNC_WITH_TOKENS = Symbol('mcp.asyncWithTokens');
+// Reflect metadata key for design:paramtypes
+exports.DESIGN_PARAMTYPES = 'design:paramtypes';
 //# sourceMappingURL=constants.js.map

package/src/common/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/common/constants.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,kDAAkD;AACrC,QAAA,iBAAiB,GAAG,yBAAyB,CAAC;AAC9C,QAAA,cAAc,GAAG,yBAAyB,CAAC","sourcesContent":["// Plugin/global Tool hooks (method-level) metadata key\n// Stored on plugin classes by @ToolHook decorator\nexport const MCP_SESSION_HOOKS = 'mcp.plugin.sessionHooks';\nexport const MCP_AUTH_HOOKS = 'mcp.plugin.sessionHooks';\n\n"]}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/common/constants.ts"],"names":[],"mappings":";;;AAAA,uDAAuD;AACvD,kDAAkD;AACrC,QAAA,iBAAiB,GAAG,yBAAyB,CAAC;AAC9C,QAAA,cAAc,GAAG,yBAAyB,CAAC;AAExD,+CAA+C;AAClC,QAAA,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAC1C,QAAA,sBAAsB,GAAG,MAAM,CAAC,qBAAqB,CAAC,CAAC;AAEpE,6CAA6C;AAChC,QAAA,iBAAiB,GAAG,mBAAmB,CAAC","sourcesContent":["// Plugin/global Tool hooks (method-level) metadata key\n// Stored on plugin classes by @ToolHook decorator\nexport const MCP_SESSION_HOOKS = 'mcp.plugin.sessionHooks';\nexport const MCP_AUTH_HOOKS = 'mcp.plugin.sessionHooks';\n\n// Metadata keys for async dependency injection\nexport const META_ASYNC_WITH = Symbol('mcp.asyncWith');\nexport const META_ASYNC_WITH_TOKENS = Symbol('mcp.asyncWithTokens');\n\n// Reflect metadata key for design:paramtypes\nexport const DESIGN_PARAMTYPES = 'design:paramtypes';\n"]}

package/src/common/decorators/decorator-utils.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 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() {}
+ * }
+ * ```
+ */
+/**
+ * TC39 Stage 3 Method Decorator Context
+ * @see https://github.com/tc39/proposal-decorators
+ */
+export interface TC39MethodContext {
+    readonly kind: 'method';
+    readonly name: string | symbol;
+    readonly static: boolean;
+    readonly private: boolean;
+    addInitializer(initializer: () => void): void;
+}
+/**
+ * TC39 Stage 3 Class Decorator Context
+ */
+export interface TC39ClassContext {
+    readonly kind: 'class';
+    readonly name: string | undefined;
+    addInitializer(initializer: () => void): void;
+}
+/**
+ * Normalized arguments passed to method decorator handlers
+ */
+export interface MethodDecoratorArgs {
+    /** The method function being decorated */
+    method: Function;
+    /** Method name as string */
+    methodName: string;
+    /** Whether this is a static method */
+    isStatic: boolean;
+    /** Decorator mode */
+    mode: 'legacy' | 'tc39';
+}
+/**
+ * Configuration for creating a dual-mode method decorator
+ */
+export interface MethodDecoratorConfig<TOptions, TMetadata> {
+    /**
+     * Create metadata from decorator arguments and options
+     */
+    createMetadata: (args: MethodDecoratorArgs, options: TOptions) => TMetadata;
+    /**
+     * Called immediately during legacy decoration with access to the class
+     * Use this to register metadata directly on the class
+     */
+    onLegacyDecoration?: (ctor: Function, metadata: TMetadata) => void;
+    /**
+     * Store pending metadata for TC39 mode (required)
+     * The metadata will be resolved later when the class is processed
+     */
+    storePendingMetadata: (method: Function, metadata: TMetadata) => void;
+}
+/**
+ * Check if decorator context is TC39 Stage 3 style
+ */
+export declare function isTC39MethodContext(arg: unknown): arg is TC39MethodContext;
+/**
+ * Check if decorator context is TC39 Stage 3 class context
+ */
+export declare function isTC39ClassContext(arg: unknown): arg is TC39ClassContext;
+/**
+ * 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
+ */
+export declare function createDualModeMethodDecorator<TOptions, TMetadata>(config: MethodDecoratorConfig<TOptions, TMetadata>): (options: TOptions) => MethodDecorator;
+/**
+ * Storage for pending TC39 decorator metadata
+ * Generic class that can be instantiated for different metadata types
+ */
+export declare class PendingMetadataRegistry<T> {
+    private pending;
+    /**
+     * Store pending metadata for a method (TC39 mode)
+     */
+    store(method: Function, metadata: T): void;
+    /**
+     * Get and optionally clear pending metadata for a method
+     */
+    consume(method: Function): T[];
+    /**
+     * Resolve all pending metadata for a class by scanning its prototype and static members
+     */
+    resolveForClass(ctor: Function, consume?: boolean): T[];
+}
+/**
+ * Creates a class decorator that works with both legacy TypeScript and TC39 Stage 3 decorators.
+ */
+export declare function createDualModeClassDecorator<TOptions>(handler: (ctor: Function, options: TOptions, context?: TC39ClassContext) => Function | void): (options: TOptions) => ClassDecorator;

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

@@ -0,0 +1,195 @@
+"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

@@ -0,0 +1 @@
+{"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: boolean = 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/front-mcp.decorator.js

@@ -17,8 +17,9 @@ function FrontMcp(providedMetadata) {
             if (error.format().providers) {
                 throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \n${JSON.stringify(error.format().providers, null, 2)}`);
             }
-            if (error.format().logging?.transports) {
-                throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \n${JSON.stringify(error.format().logging?.transports, 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;
         }

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

@@ -1 +1 @@
-{"version":3,"file":"front-mcp.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":";;AAQA,4BAkCC;AA1CD,4BAA0B;AAC1B,sCAAyC;AACzC,0CAAqE;AAGrE;;GAEG;AACH,SAAgB,QAAQ,CAAC,gBAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAC,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAC,GAAG,iCAAsB,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACnF,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7H,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,8EAA8E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/J,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,eAAe,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAC,gBAAgB,EAAC,EAAE,EAAE;gBACtC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,qFAAqF,CAAC,CAAC;gBAC/G,CAAC;gBAED,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IAEH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport {FrontMcpTokens} from '../tokens';\nimport {FrontMcpMetadata, frontMcpMetadataSchema} from '../metadata';\nimport {FrontMcpInstance} from \"../../front-mcp\";\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\n    const {error, data: metadata} = frontMcpMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().apps) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { apps: [?] }: \\n${JSON.stringify(error.format().apps, null, 2)}`);\n      }\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \\n${JSON.stringify(error.format().providers, null, 2)}`);\n      }\n      if (error.format().logging?.transports) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \\n${JSON.stringify(error.format().logging?.transports, null, 2)}`);\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    if (metadata.serve) {\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}\n"]}
+{"version":3,"file":"front-mcp.decorator.js","sourceRoot":"","sources":["../../../../src/common/decorators/front-mcp.decorator.ts"],"names":[],"mappings":";;AAQA,4BA+CC;AAvDD,4BAA0B;AAC1B,sCAA2C;AAC3C,0CAAuE;AAGvE;;GAEG;AACH,SAAgB,QAAQ,CAAC,gBAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,iCAAsB,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACrF,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CACb,2DAA2D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAC1G,CAAC;YACJ,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CACb,gEAAgE,IAAI,CAAC,SAAS,CAC5E,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EACxB,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;YACJ,CAAC;YACD,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,CAAwC,CAAC;YACvF,IAAI,aAAa,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,KAAK,CACb,8EAA8E,IAAI,CAAC,SAAS,CAC1F,aAAa,CAAC,YAAY,CAAC,EAC3B,IAAI,EACJ,CAAC,CACF,EAAE,CACJ,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,eAAe,CAAC;YAC5B,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE;gBACxC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,qFAAqF,CAAC,CAAC;gBAC/G,CAAC;gBAED,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpTokens } from '../tokens';\nimport { FrontMcpMetadata, frontMcpMetadataSchema } from '../metadata';\nimport { FrontMcpInstance } from '../../front-mcp';\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    const { error, data: metadata } = frontMcpMetadataSchema.safeParse(providedMetadata);\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    if (metadata.serve) {\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.d.ts

@@ -1,9 +1,65 @@
-import { HookOptions, FlowName } from '../metadata';
-/** NEW: typed variants */
+/**
+ * Flow Hook Decorators
+ *
+ * This module provides decorators for defining flow stages and lifecycle hooks.
+ * Supports both legacy TypeScript decorators and TC39 Stage 3 decorators.
+ */
+import { HookOptions, FlowName, HookMetadata } from '../metadata';
+/**
+ * Resolve all pending TC39 hooks for a class by scanning its prototype
+ * This is called by collectFlowHookMap during flow registration
+ */
+export declare function resolvePendingTC39HooksForClass(ctor: Function): HookMetadata[];
+/**
+ * Store a pending hook for TC39 mode
+ * @internal
+ */
+export declare function registerPendingTC39Hook(method: Function, meta: HookMetadata): void;
+/**
+ * Get and clear pending hooks for a method (TC39 mode)
+ * @internal
+ */
+export declare function consumePendingTC39Hooks(method: Function): HookMetadata[];
+/**
+ * Creates a typed Stage hook decorator for a specific flow
+ * @example
+ * ```typescript
+ * const { Stage } = FlowHooksOf('http:request');
+ *
+ * class HttpRequestFlow {
+ *   @Stage('checkAuthorization')
+ *   async checkAuthorization() { ... }
+ * }
+ * ```
+ */
 export declare function StageHookOf<Name extends FlowName>(flow: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+/**
+ * Creates a typed Will hook decorator (runs before stage)
+ */
 export declare function WillHookOf<Name extends FlowName>(flow: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+/**
+ * Creates a typed Did hook decorator (runs after stage)
+ */
 export declare function DidHookOf<Name extends FlowName>(flow: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+/**
+ * Creates a typed Around hook decorator (wraps stage execution)
+ */
 export declare function AroundHookOf<Name extends FlowName>(name: Name): (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+/**
+ * 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() { ... }
+ * }
+ * ```
+ */
 export declare function FlowHooksOf<Name extends FlowName>(name: Name): {
     Stage: (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
     Will: (stage: ExtendFlows[Name]["stage"], opts?: HookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;