@frontmcp/sdk 0.6.0 → 0.6.2

package/src/flows/flow.stages.js

@@ -1,113 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sortStageMap = sortStageMap;
-exports.cloneStageMap = cloneStageMap;
-exports.resolveStageKey = resolveStageKey;
-exports.collectFlowHookMap = collectFlowHookMap;
-exports.mergeHookMetasIntoStageMap = mergeHookMetasIntoStageMap;
-const common_1 = require("../common");
-const hook_decorator_1 = require("../common/decorators/hook.decorator");
-const cap = (s) => (s ? s[0].toUpperCase() + s.slice(1) : s);
-const CACHE = new WeakMap();
-function sortStageMap(table) {
-    for (const key of Object.keys(table)) {
-        table[key].sort((a, b) => a._priority - b._priority || a._order - b._order);
-    }
-}
-function cloneStageMap(table) {
-    const out = {};
-    for (const [k, v] of Object.entries(table))
-        out[k] = v.slice();
-    return out;
-}
-function resolveStageKey(type, stage) {
-    return type === 'will'
-        ? `will${cap(stage)}`
-        : type === 'did'
-            ? `did${cap(stage)}`
-            : type === 'around'
-                ? `around${cap(stage)}`
-                : stage;
-}
-function collectFlowHookMap(FlowClass) {
-    const cached = CACHE.get(FlowClass);
-    if (cached) {
-        return cached;
-    }
-    // Get existing metadata (from legacy decorators)
-    const existingMetas = (Reflect.getMetadata(common_1.FrontMcpFlowHookTokens.hooks, FlowClass) ?? []);
-    // Resolve any pending TC39 decorator hooks
-    const tc39Metas = (0, hook_decorator_1.resolvePendingTC39HooksForClass)(FlowClass);
-    // Combine both sources
-    const metas = [...existingMetas, ...tc39Metas];
-    const sorted = metas
-        .map((m, i) => ({ m, i }))
-        .sort((a, b) => (a.m.priority ?? 0) - (b.m.priority ?? 0) || a.i - b.i)
-        .map((x) => x.m);
-    const table = {};
-    let order = 0;
-    for (const m of sorted) {
-        const resolved = resolveStageKey(m.type, m.stage);
-        const entry = {
-            _priority: m.priority ?? 0,
-            _order: order++,
-            method: async (ctx) => {
-                const target = m.static ? FlowClass : ctx;
-                const impl = typeof m.method === 'function' ? m.method : target?.[m.method];
-                if (typeof impl !== 'function')
-                    return;
-                if (m.filter && !(await m.filter(ctx)))
-                    return;
-                if (m.type === 'around') {
-                    const next = async () => { };
-                    return m.static ? impl.call(FlowClass, ctx, next) : impl.call(ctx, ctx, next);
-                }
-                else {
-                    return m.static ? impl.call(FlowClass, ctx) : impl.call(ctx, ctx);
-                }
-            },
-        };
-        (table[resolved] ??= []).push(entry);
-    }
-    sortStageMap(table);
-    CACHE.set(FlowClass, table);
-    return table;
-}
-function mergeHookMetasIntoStageMap(FlowClass, table, metas, orderStart = 100_000) {
-    let order = orderStart;
-    const sorted = metas
-        .map((m, i) => ({ m, i }))
-        .sort((a, b) => (a.m.priority ?? 0) - (b.m.priority ?? 0) || a.i - b.i)
-        .map((x) => x.m);
-    for (const m of sorted) {
-        const resolved = resolveStageKey(m.type, m.stage);
-        const entry = {
-            _priority: m.priority ?? 0,
-            _order: order++,
-            method: async (ctx) => {
-                const target = m.target;
-                if (!target) {
-                    console.warn(`[flow] Hook target is missing for method ${m.method}`);
-                    return;
-                }
-                const impl = typeof m.method === 'function'
-                    ? m.method
-                    : target?.[m.method].bind(target);
-                if (typeof impl !== 'function')
-                    return;
-                if (m.filter && !(await m.filter(ctx)))
-                    return;
-                if (m.type === 'around') {
-                    const next = async () => { };
-                    return m.static ? impl.call(target, ctx, next) : impl.call(target, ctx, next);
-                }
-                else {
-                    return m.static ? impl.call(target, ctx) : impl.call(target, ctx);
-                }
-            },
-        };
-        (table[resolved] ??= []).push(entry);
-    }
-    sortStageMap(table);
-}
-//# sourceMappingURL=flow.stages.js.map

package/src/flows/flow.stages.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow.stages.js","sourceRoot":"","sources":["../../../src/flows/flow.stages.ts"],"names":[],"mappings":"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","sourcesContent":["import { HookMetadata, FrontMcpFlowHookTokens } from '../common';\nimport { resolvePendingTC39HooksForClass } from '../common/decorators/hook.decorator';\n\nexport type StageEntry<C> = {\n  method: (ctx: C) => Promise<void>;\n  _priority: number;\n  _order: number;\n};\n\nexport type StageMap<C> = Record<string, StageEntry<C>[]>;\n\nconst cap = (s: string) => (s ? s[0].toUpperCase() + s.slice(1) : s);\n\nconst CACHE: WeakMap<Function, StageMap<any>> = new WeakMap();\n\nexport function sortStageMap<C>(table: StageMap<C>) {\n  for (const key of Object.keys(table)) {\n    table[key].sort((a, b) => a._priority - b._priority || a._order - b._order);\n  }\n}\n\nexport function cloneStageMap<C>(table: StageMap<C>): StageMap<C> {\n  const out: StageMap<C> = {};\n  for (const [k, v] of Object.entries(table)) out[k] = v.slice();\n  return out;\n}\n\nexport function resolveStageKey(type: HookMetadata['type'], stage: string) {\n  return type === 'will'\n    ? `will${cap(stage)}`\n    : type === 'did'\n    ? `did${cap(stage)}`\n    : type === 'around'\n    ? `around${cap(stage)}`\n    : stage;\n}\n\nexport function collectFlowHookMap<C>(FlowClass: any): StageMap<C> {\n  const cached = CACHE.get(FlowClass as any);\n  if (cached) {\n    return cached;\n  }\n\n  // Get existing metadata (from legacy decorators)\n  const existingMetas = (Reflect.getMetadata(FrontMcpFlowHookTokens.hooks, FlowClass) ?? []) as HookMetadata[];\n\n  // Resolve any pending TC39 decorator hooks\n  const tc39Metas = resolvePendingTC39HooksForClass(FlowClass);\n\n  // Combine both sources\n  const metas = [...existingMetas, ...tc39Metas];\n\n  const sorted = metas\n    .map((m, i) => ({ m, i }))\n    .sort((a, b) => (a.m.priority ?? 0) - (b.m.priority ?? 0) || a.i - b.i)\n    .map((x) => x.m);\n\n  const table: StageMap<C> = {};\n  let order = 0;\n\n  for (const m of sorted) {\n    const resolved = resolveStageKey(m.type, m.stage);\n\n    const entry: StageEntry<C> = {\n      _priority: m.priority ?? 0,\n      _order: order++,\n      method: async (ctx: any) => {\n        const target = m.static ? (FlowClass as any) : ctx;\n        const impl =\n          typeof (m as any).method === 'function' ? (m as any).method : target?.[m.method as keyof typeof target];\n\n        if (typeof impl !== 'function') return;\n        if (m.filter && !(await m.filter(ctx))) return;\n\n        if (m.type === 'around') {\n          const next = async () => {};\n          return m.static ? impl.call(FlowClass, ctx, next) : impl.call(ctx, ctx, next);\n        } else {\n          return m.static ? impl.call(FlowClass, ctx) : impl.call(ctx, ctx);\n        }\n      },\n    };\n\n    (table[resolved] ??= []).push(entry);\n  }\n\n  sortStageMap(table);\n  CACHE.set(FlowClass as any, table);\n  return table;\n}\n\nexport function mergeHookMetasIntoStageMap<C>(\n  FlowClass: any,\n  table: StageMap<C>,\n  metas: HookMetadata[],\n  orderStart = 100_000,\n) {\n  let order = orderStart;\n\n  const sorted = metas\n    .map((m, i) => ({ m, i }))\n    .sort((a, b) => (a.m.priority ?? 0) - (b.m.priority ?? 0) || a.i - b.i)\n    .map((x) => x.m);\n\n  for (const m of sorted) {\n    const resolved = resolveStageKey(m.type, m.stage);\n\n    const entry: StageEntry<C> = {\n      _priority: m.priority ?? 0,\n      _order: order++,\n      method: async (ctx: any) => {\n        const target = m.target;\n        if (!target) {\n          console.warn(`[flow] Hook target is missing for method ${m.method}`);\n          return;\n        }\n        const impl =\n          typeof (m as any).method === 'function'\n            ? (m as any).method\n            : target?.[m.method as keyof typeof target].bind(target);\n\n        if (typeof impl !== 'function') return;\n        if (m.filter && !(await m.filter(ctx))) return;\n\n        if (m.type === 'around') {\n          const next = async () => {};\n          return m.static ? impl.call(target, ctx, next) : impl.call(target, ctx, next);\n        } else {\n          return m.static ? impl.call(target, ctx) : impl.call(target, ctx);\n        }\n      },\n    };\n\n    (table[resolved] ??= []).push(entry);\n  }\n\n  sortStageMap(table);\n}\n"]}

package/src/flows/flow.utils.js

@@ -1,36 +0,0 @@
-"use strict";
-// flows/flow.utils.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectFlowMetadata = collectFlowMetadata;
-exports.normalizeFlow = normalizeFlow;
-exports.flowDiscoveryDeps = flowDiscoveryDeps;
-const common_1 = require("../common");
-const token_utils_1 = require("../utils/token.utils");
-const metadata_utils_1 = require("../utils/metadata.utils");
-function collectFlowMetadata(cls) {
-    return Object.entries(common_1.FrontMcpFlowTokens).reduce((metadata, [key, token]) => {
-        return Object.assign(metadata, {
-            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
-        });
-    }, {});
-}
-function normalizeFlow(item) {
-    if ((0, token_utils_1.isClass)(item)) {
-        // read McpFlowMetadata from class
-        const metadata = collectFlowMetadata(item);
-        return { kind: common_1.FlowKind.CLASS_TOKEN, provide: item, metadata };
-    }
-    const name = item?.name ?? String(item);
-    throw new Error(`Invalid adapter '${name}'. Expected a class or a adapter object.`);
-}
-/**
- * For graph/cycle detection. Returns dependency tokens that should be graphed.
- * - CLASS_TOKEN: deps come from the class constructor
- */
-function flowDiscoveryDeps(rec) {
-    switch (rec.kind) {
-        case common_1.FlowKind.CLASS_TOKEN:
-            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
-    }
-}
-//# sourceMappingURL=flow.utils.js.map

package/src/flows/flow.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flow.utils.js","sourceRoot":"","sources":["../../../src/flows/flow.utils.ts"],"names":[],"mappings":";AAAA,sBAAsB;;AAMtB,kDAMC;AAGD,sCAUC;AAMD,8CAKC;AAlCD,sCAAoG;AACpG,sDAA4D;AAC5D,4DAAsD;AAEtD,SAAgB,mBAAmB,CAAC,GAAa;IAC/C,OAAO,MAAM,CAAC,OAAO,CAAC,2BAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC1E,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC7B,CAAC,GAAG,CAAC,EAAE,IAAA,4BAAW,EAAC,KAAK,EAAE,GAAG,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC,EAAE,EAAyB,CAAC,CAAC;AAChC,CAAC;AAGD,SAAgB,aAAa,CAAC,IAAc;IAC1C,IAAI,IAAA,qBAAO,EAAC,IAAI,CAAC,EAAE,CAAC;QAClB,kCAAkC;QAClC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,iBAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjE,CAAC;IACD,MAAM,IAAI,GAAI,IAAY,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,KAAK,CACb,oBAAoB,IAAI,0CAA0C,CACnE,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,GAAe;IAC/C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,iBAAQ,CAAC,WAAW;YACvB,OAAO,IAAA,yBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;AACH,CAAC","sourcesContent":["// flows/flow.utils.ts\n\nimport { FlowKind, FlowMetadata, FlowRecord, FlowType, FrontMcpFlowTokens, Token } from '../common';\nimport { depsOfClass, isClass } from '../utils/token.utils';\nimport { getMetadata } from '../utils/metadata.utils';\n\nexport function collectFlowMetadata(cls: FlowType): FlowMetadata<never> {\n  return Object.entries(FrontMcpFlowTokens).reduce((metadata, [key, token]) => {\n    return Object.assign(metadata, {\n      [key]: getMetadata(token, cls),\n    });\n  }, {} as FlowMetadata<never>);\n}\n\n\nexport function normalizeFlow(item: FlowType): FlowRecord {\n  if (isClass(item)) {\n    // read McpFlowMetadata from class\n    const metadata = collectFlowMetadata(item);\n    return { kind: FlowKind.CLASS_TOKEN, provide: item, metadata };\n  }\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(\n    `Invalid adapter '${name}'. Expected a class or a adapter object.`,\n  );\n}\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - CLASS_TOKEN: deps come from the class constructor\n */\nexport function flowDiscoveryDeps(rec: FlowRecord): Token[] {\n  switch (rec.kind) {\n    case FlowKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n\n"]}

package/src/front-mcp/front-mcp.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpInstance = void 0;
-const tslib_1 = require("tslib");
-const common_1 = require("../common");
-const scope_registry_1 = require("../scope/scope.registry");
-const provider_registry_1 = tslib_1.__importDefault(require("../provider/provider.registry"));
-const front_mcp_providers_1 = require("./front-mcp.providers");
-const logger_registry_1 = tslib_1.__importDefault(require("../logger/logger.registry"));
-class FrontMcpInstance {
-    config;
-    ready;
-    logger;
-    providers;
-    scopes;
-    constructor(config) {
-        this.config = config;
-        this.ready = this.initialize();
-    }
-    async initialize() {
-        this.providers = new provider_registry_1.default([...(0, front_mcp_providers_1.createMcpGlobalProviders)(this.config)]);
-        await this.providers.ready;
-        this.logger = new logger_registry_1.default(this.providers);
-        await this.logger.ready;
-        this.scopes = new scope_registry_1.ScopeRegistry(this.providers);
-        await this.scopes.ready;
-    }
-    start() {
-        const server = this.providers.get(common_1.FrontMcpServer);
-        if (!server) {
-            throw new Error('Server not found');
-        }
-        server.start();
-    }
-    static async bootstrap(options) {
-        const frontMcp = new FrontMcpInstance(options);
-        await frontMcp.ready;
-        frontMcp.start();
-    }
-    /**
-     * Creates and initializes a FrontMCP instance without starting the HTTP server.
-     * Returns the underlying HTTP handler for serverless deployments (Vercel, Lambda).
-     *
-     * @example
-     * // In index.ts for Vercel
-     * import { FrontMcpInstance } from '@frontmcp/sdk';
-     * import config from '../src/main';
-     *
-     * export default FrontMcpInstance.createHandler(config);
-     */
-    static async createHandler(options) {
-        const frontMcp = new FrontMcpInstance(options);
-        await frontMcp.ready;
-        const server = frontMcp.providers.get(common_1.FrontMcpServer);
-        if (!server) {
-            throw new Error('Server not found');
-        }
-        server.prepare();
-        return server.getHandler();
-    }
-}
-exports.FrontMcpInstance = FrontMcpInstance;
-//# sourceMappingURL=front-mcp.js.map

package/src/front-mcp/front-mcp.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"front-mcp.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.ts"],"names":[],"mappings":";;;;AAAA,sCAAkF;AAClF,4DAAwD;AACxD,8FAA6D;AAC7D,+DAAiE;AACjE,wFAAuD;AAEvD,MAAa,gBAAgB;IAC3B,MAAM,CAAqB;IAClB,KAAK,CAAgB;IAEtB,MAAM,CAAiB;IACvB,SAAS,CAAmB;IAC5B,MAAM,CAAgB;IAE9B,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,CAAC,SAAS,GAAG,IAAI,2BAAgB,CAAC,CAAC,GAAG,IAAA,8CAAwB,EAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAE3B,IAAI,CAAC,MAAM,GAAG,IAAI,yBAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAExB,IAAI,CAAC,MAAM,GAAG,IAAI,8BAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC1B,CAAC;IAED,KAAK;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAc,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QACD,MAAM,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAA2B;QACvD,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,KAAK,CAAC;QAErB,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IAED;;;;;;;;;;OAUG;IACI,MAAM,CAAC,KAAK,CAAC,aAAa,CAAC,OAA2B;QAC3D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,KAAK,CAAC;QAErB,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,uBAAc,CAAC,CAAC;QACtD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACtC,CAAC;QAED,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7B,CAAC;CACF;AA9DD,4CA8DC","sourcesContent":["import { FrontMcpConfigType, FrontMcpInterface, FrontMcpServer } from '../common';\nimport { ScopeRegistry } from '../scope/scope.registry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { createMcpGlobalProviders } from './front-mcp.providers';\nimport LoggerRegistry from '../logger/logger.registry';\n\nexport class FrontMcpInstance implements FrontMcpInterface {\n  config: FrontMcpConfigType;\n  readonly ready: Promise<void>;\n\n  private logger: LoggerRegistry;\n  private providers: ProviderRegistry;\n  private scopes: ScopeRegistry;\n\n  constructor(config: FrontMcpConfigType) {\n    this.config = config;\n    this.ready = this.initialize();\n  }\n\n  async initialize(): Promise<void> {\n    this.providers = new ProviderRegistry([...createMcpGlobalProviders(this.config)]);\n    await this.providers.ready;\n\n    this.logger = new LoggerRegistry(this.providers);\n    await this.logger.ready;\n\n    this.scopes = new ScopeRegistry(this.providers);\n    await this.scopes.ready;\n  }\n\n  start() {\n    const server = this.providers.get(FrontMcpServer);\n    if (!server) {\n      throw new Error('Server not found');\n    }\n    server.start();\n  }\n\n  public static async bootstrap(options: FrontMcpConfigType) {\n    const frontMcp = new FrontMcpInstance(options);\n    await frontMcp.ready;\n\n    frontMcp.start();\n  }\n\n  /**\n   * Creates and initializes a FrontMCP instance without starting the HTTP server.\n   * Returns the underlying HTTP handler for serverless deployments (Vercel, Lambda).\n   *\n   * @example\n   * // In index.ts for Vercel\n   * import { FrontMcpInstance } from '@frontmcp/sdk';\n   * import config from '../src/main';\n   *\n   * export default FrontMcpInstance.createHandler(config);\n   */\n  public static async createHandler(options: FrontMcpConfigType): Promise<unknown> {\n    const frontMcp = new FrontMcpInstance(options);\n    await frontMcp.ready;\n\n    const server = frontMcp.providers.get(FrontMcpServer);\n    if (!server) {\n      throw new Error('Server not found');\n    }\n\n    server.prepare();\n    return server.getHandler();\n  }\n}\n"]}

package/src/front-mcp/front-mcp.providers.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMcpGlobalProviders = createMcpGlobalProviders;
-const common_1 = require("../common");
-const server_instance_1 = require("../server/server.instance");
-const front_mcp_tokens_1 = require("./front-mcp.tokens");
-const context_1 = require("../context");
-const frontMcpConfig = {
-    with: (metadata) => ({
-        name: 'frontmcp:config',
-        provide: front_mcp_tokens_1.FrontMcpConfig,
-        scope: common_1.ProviderScope.GLOBAL,
-        useValue: metadata,
-    }),
-};
-const DEFAULT_HTTP_OPTIONS = { port: 3000, entryPath: '/mcp' };
-const frontMcpServer = (0, common_1.AsyncProvider)({
-    name: 'frontmcp:server',
-    scope: common_1.ProviderScope.GLOBAL,
-    provide: common_1.FrontMcpServer,
-    inject: () => [front_mcp_tokens_1.FrontMcpConfig],
-    useFactory: (config) => {
-        return new server_instance_1.FrontMcpServerInstance(config.http ?? DEFAULT_HTTP_OPTIONS);
-    },
-});
-function createMcpGlobalProviders(metadata) {
-    return [frontMcpConfig.with(metadata), frontMcpServer, context_1.FrontMcpContextStorage];
-}
-//# sourceMappingURL=front-mcp.providers.js.map

package/src/front-mcp/front-mcp.providers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"front-mcp.providers.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.providers.ts"],"names":[],"mappings":";;AA0BA,4DAEC;AA5BD,sCAAgH;AAChH,+DAAmE;AACnE,yDAAoD;AACpD,wCAAoD;AAEpD,MAAM,cAAc,GAAG;IACrB,IAAI,EAAE,CAAC,QAA4B,EAAyC,EAAE,CAAC,CAAC;QAC9E,IAAI,EAAE,iBAAiB;QACvB,OAAO,EAAE,iCAAc;QACvB,KAAK,EAAE,sBAAa,CAAC,MAAM;QAC3B,QAAQ,EAAE,QAAQ;KACnB,CAAC;CACH,CAAC;AAEF,MAAM,oBAAoB,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAE/D,MAAM,cAAc,GAAG,IAAA,sBAAa,EAAC;IACnC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,sBAAa,CAAC,MAAM;IAC3B,OAAO,EAAE,uBAAc;IACvB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,iCAAc,CAAC;IAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;QACrB,OAAO,IAAI,wCAAsB,CAAC,MAAM,CAAC,IAAI,IAAI,oBAAoB,CAAC,CAAC;IACzE,CAAC;CACF,CAAC,CAAC;AAEH,SAAgB,wBAAwB,CAAC,QAA4B;IACnE,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,cAAc,EAAE,gCAAsB,CAAC,CAAC;AACjF,CAAC","sourcesContent":["import { FrontMcpConfigType, ProviderScope, FrontMcpServer, ProviderValueType, AsyncProvider } from '../common';\nimport { FrontMcpServerInstance } from '../server/server.instance';\nimport { FrontMcpConfig } from './front-mcp.tokens';\nimport { FrontMcpContextStorage } from '../context';\n\nconst frontMcpConfig = {\n  with: (metadata: FrontMcpConfigType): ProviderValueType<FrontMcpConfigType> => ({\n    name: 'frontmcp:config',\n    provide: FrontMcpConfig,\n    scope: ProviderScope.GLOBAL,\n    useValue: metadata,\n  }),\n};\n\nconst DEFAULT_HTTP_OPTIONS = { port: 3000, entryPath: '/mcp' };\n\nconst frontMcpServer = AsyncProvider({\n  name: 'frontmcp:server',\n  scope: ProviderScope.GLOBAL,\n  provide: FrontMcpServer,\n  inject: () => [FrontMcpConfig],\n  useFactory: (config) => {\n    return new FrontMcpServerInstance(config.http ?? DEFAULT_HTTP_OPTIONS);\n  },\n});\n\nexport function createMcpGlobalProviders(metadata: FrontMcpConfigType) {\n  return [frontMcpConfig.with(metadata), frontMcpServer, FrontMcpContextStorage];\n}\n"]}

package/src/front-mcp/front-mcp.tokens.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrontMcpConfig = void 0;
-exports.FrontMcpConfig = Symbol('FrontMcpConfig');
-//# sourceMappingURL=front-mcp.tokens.js.map

package/src/front-mcp/front-mcp.tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"front-mcp.tokens.js","sourceRoot":"","sources":["../../../src/front-mcp/front-mcp.tokens.ts"],"names":[],"mappings":";;;AAIa,QAAA,cAAc,GAA8B,MAAM,CAAC,gBAAgB,CAAC,CAAC","sourcesContent":["import { FrontMcpConfigType, FrontMcpScopeInterface, Token } from '../common';\nimport { FrontMcpServerInstance } from '../server/server.instance';\n\n\nexport const FrontMcpConfig: Token<FrontMcpConfigType> = Symbol('FrontMcpConfig');\n"]}

package/src/front-mcp/index.d.ts

@@ -1 +0,0 @@
-export * from './front-mcp';

package/src/front-mcp/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-tslib_1.__exportStar(require("./front-mcp"), exports);
-//# sourceMappingURL=index.js.map

package/src/front-mcp/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/front-mcp/index.ts"],"names":[],"mappings":";;;AAAA,sDAA2B","sourcesContent":["export * from './front-mcp'"]}

package/src/front-mcp/serverless-handler.js

@@ -1,61 +0,0 @@
-"use strict";
-/**
- * Global handler registry for serverless deployments.
- * The @FrontMcp decorator stores the handler here when running in serverless mode.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.setServerlessHandler = setServerlessHandler;
-exports.setServerlessHandlerPromise = setServerlessHandlerPromise;
-exports.setServerlessHandlerError = setServerlessHandlerError;
-exports.getServerlessHandler = getServerlessHandler;
-exports.getServerlessHandlerAsync = getServerlessHandlerAsync;
-let globalHandler = null;
-let globalHandlerPromise = null;
-let globalHandlerError = null;
-/**
- * Store the serverless handler (called by decorator after handler is ready)
- */
-function setServerlessHandler(handler) {
-    globalHandler = handler;
-}
-/**
- * Store the promise that resolves to the handler (called by decorator immediately)
- */
-function setServerlessHandlerPromise(promise) {
-    globalHandlerPromise = promise;
-}
-/**
- * Store an error that occurred during handler initialization
- */
-function setServerlessHandlerError(error) {
-    globalHandlerError = error;
-}
-/**
- * Get the serverless handler synchronously.
- * Returns null if handler is not ready yet.
- * @throws Error if handler initialization failed
- */
-function getServerlessHandler() {
-    if (globalHandlerError) {
-        throw globalHandlerError;
-    }
-    return globalHandler;
-}
-/**
- * Get the serverless handler asynchronously.
- * Waits for the handler to be ready if needed.
- * @throws Error if handler initialization failed or not initialized
- */
-async function getServerlessHandlerAsync() {
-    if (globalHandlerError) {
-        throw globalHandlerError;
-    }
-    if (globalHandlerPromise) {
-        return globalHandlerPromise;
-    }
-    if (!globalHandler) {
-        throw new Error('Serverless handler not initialized. Ensure @FrontMcp decorator ran and FRONTMCP_SERVERLESS=1 is set.');
-    }
-    return globalHandler;
-}
-//# sourceMappingURL=serverless-handler.js.map

package/src/front-mcp/serverless-handler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serverless-handler.js","sourceRoot":"","sources":["../../../src/front-mcp/serverless-handler.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AASH,oDAEC;AAKD,kEAEC;AAKD,8DAEC;AAOD,oDAKC;AAOD,8DAaC;AAvDD,IAAI,aAAa,GAAY,IAAI,CAAC;AAClC,IAAI,oBAAoB,GAA4B,IAAI,CAAC;AACzD,IAAI,kBAAkB,GAAiB,IAAI,CAAC;AAE5C;;GAEG;AACH,SAAgB,oBAAoB,CAAC,OAAgB;IACnD,aAAa,GAAG,OAAO,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAgB,2BAA2B,CAAC,OAAyB;IACnE,oBAAoB,GAAG,OAAO,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,yBAAyB,CAAC,KAAY;IACpD,kBAAkB,GAAG,KAAK,CAAC;AAC7B,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAClC,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,kBAAkB,CAAC;IAC3B,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACI,KAAK,UAAU,yBAAyB;IAC7C,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,kBAAkB,CAAC;IAC3B,CAAC;IACD,IAAI,oBAAoB,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IACD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,sGAAsG,CACvG,CAAC;IACJ,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC","sourcesContent":["/**\n * Global handler registry for serverless deployments.\n * The @FrontMcp decorator stores the handler here when running in serverless mode.\n */\n\nlet globalHandler: unknown = null;\nlet globalHandlerPromise: Promise<unknown> | null = null;\nlet globalHandlerError: Error | null = null;\n\n/**\n * Store the serverless handler (called by decorator after handler is ready)\n */\nexport function setServerlessHandler(handler: unknown): void {\n  globalHandler = handler;\n}\n\n/**\n * Store the promise that resolves to the handler (called by decorator immediately)\n */\nexport function setServerlessHandlerPromise(promise: Promise<unknown>): void {\n  globalHandlerPromise = promise;\n}\n\n/**\n * Store an error that occurred during handler initialization\n */\nexport function setServerlessHandlerError(error: Error): void {\n  globalHandlerError = error;\n}\n\n/**\n * Get the serverless handler synchronously.\n * Returns null if handler is not ready yet.\n * @throws Error if handler initialization failed\n */\nexport function getServerlessHandler(): unknown {\n  if (globalHandlerError) {\n    throw globalHandlerError;\n  }\n  return globalHandler;\n}\n\n/**\n * Get the serverless handler asynchronously.\n * Waits for the handler to be ready if needed.\n * @throws Error if handler initialization failed or not initialized\n */\nexport async function getServerlessHandlerAsync(): Promise<unknown> {\n  if (globalHandlerError) {\n    throw globalHandlerError;\n  }\n  if (globalHandlerPromise) {\n    return globalHandlerPromise;\n  }\n  if (!globalHandler) {\n    throw new Error(\n      'Serverless handler not initialized. Ensure @FrontMcp decorator ran and FRONTMCP_SERVERLESS=1 is set.',\n    );\n  }\n  return globalHandler;\n}\n"]}

package/src/hooks/hook.instance.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HookInstance = void 0;
-const common_1 = require("../common");
-class HookInstance extends common_1.HookEntry {
-    logger;
-    constructor(scope, providers, record, token) {
-        super(scope, providers, record, token, record.metadata);
-        const { flow, method, stage } = this.metadata;
-        this.logger = scope.logger.child(`${flow}:hook:${stage}(${method})`);
-    }
-    initialize() {
-        return Promise.resolve(undefined);
-    }
-    async run(input, ctx) {
-        const { target, method } = this.metadata;
-        if (!target) {
-            throw new Error(`Hook target is not defined for method "${method}". This is a bug in hook configuration.`);
-        }
-        this.logger.verbose('start');
-        await target[method](input, ctx);
-        this.logger.verbose('done');
-    }
-}
-exports.HookInstance = HookInstance;
-//# sourceMappingURL=hook.instance.js.map

package/src/hooks/hook.instance.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook.instance.js","sourceRoot":"","sources":["../../../src/hooks/hook.instance.ts"],"names":[],"mappings":";;;AAAA,sCAYmB;AAEnB,MAAa,YAKX,SAAQ,kBAA+B;IACvC,MAAM,CAAiB;IAEvB,YAAY,KAAiB,EAAE,SAAoC,EAAE,MAAkB,EAAE,KAAY;QACnG,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAA0C,CAAC,CAAC;QAE1F,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9C,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,SAAS,KAAK,IAAI,MAAM,GAAG,CAAC,CAAC;IACvE,CAAC;IAES,UAAU;QAClB,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAAS,EAAE,GAAQ;QAC3B,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,0CAA0C,MAAM,yCAAyC,CAAC,CAAC;QAC7G,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;CACF;AA5BD,oCA4BC","sourcesContent":["import {\n  FlowCtxOf,\n  FlowInputOf,\n  FlowName,\n  FlowStagesOf,\n  FrontMcpLogger,\n  HookEntry,\n  HookMetadata,\n  HookRecord,\n  ProviderRegistryInterface,\n  ScopeEntry,\n  Token,\n} from '../common';\n\nexport class HookInstance<\n  Name extends FlowName,\n  In = FlowInputOf<Name>,\n  Stage = FlowStagesOf<Name>,\n  Ctx = FlowCtxOf<Name>,\n> extends HookEntry<In, Name, Stage, Ctx> {\n  logger: FrontMcpLogger;\n\n  constructor(scope: ScopeEntry, providers: ProviderRegistryInterface, record: HookRecord, token: Token) {\n    super(scope, providers, record, token, record.metadata as HookMetadata<Name, Stage, Ctx>);\n\n    const { flow, method, stage } = this.metadata;\n    this.logger = scope.logger.child(`${flow}:hook:${stage}(${method})`);\n  }\n\n  protected initialize(): Promise<void> {\n    return Promise.resolve(undefined);\n  }\n\n  async run(input: In, ctx: Ctx): Promise<void> {\n    const { target, method } = this.metadata;\n    if (!target) {\n      throw new Error(`Hook target is not defined for method \"${method}\". This is a bug in hook configuration.`);\n    }\n    this.logger.verbose('start');\n    await target[method](input, ctx);\n    this.logger.verbose('done');\n  }\n}\n"]}

package/src/hooks/hook.registry.js

@@ -1,152 +0,0 @@
-"use strict";
-// src/hooks/hook.registry.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-const regsitry_1 = require("../regsitry");
-const hook_instance_1 = require("./hook.instance");
-class HookRegistry extends regsitry_1.RegistryAbstract {
-    scope;
-    /** Historical records by class (kept if you still want access to raw records) */
-    recordsByCls = new Map();
-    /** Fast O(1) indexes of *instances*, sorted by priority (desc) */
-    entriesByCls = new Map();
-    hooksByFlow = new Map();
-    hooksByFlowStage = new Map();
-    constructor(providers, list) {
-        super('HookRegistry', providers, list);
-        this.scope = this.providers.getActiveScope();
-    }
-    buildMap() {
-        const tokens = new Set();
-        const defs = new Map();
-        const graph = new Map();
-        /**
-         * No need to build graph for hooks,
-         * hooks are injected by other tokens
-         */
-        return { tokens, defs, graph };
-    }
-    buildGraph() {
-        /**
-         * Currently, hooks cannot be depended on other tokens,
-         * in the future we can add this feature, so hooks can depends on:
-         * - other hooks completions
-         * - specific injected providers
-         */
-    }
-    async initialize() {
-        /**
-         * No need to initialize hooks,
-         * hooks are injected by other tokens
-         */
-    }
-    /** Priority helper (default 0) */
-    getPriority(entry) {
-        return entry.metadata?.priority ?? 0;
-    }
-    /** Binary insert by priority (desc). Stable for equal priorities. */
-    insertSorted(arr, item) {
-        const p = this.getPriority(item);
-        let lo = 0;
-        let hi = arr.length;
-        // Insert AFTER existing equal-priority items to keep stable order.
-        while (lo < hi) {
-            const mid = (lo + hi) >>> 1;
-            const mp = this.getPriority(arr[mid]);
-            if (mp < p) {
-                hi = mid;
-            }
-            else {
-                lo = mid + 1;
-            }
-        }
-        arr.splice(lo, 0, item);
-    }
-    upsert(map, key, init) {
-        let v = map.get(key);
-        if (!v) {
-            v = init();
-            map.set(key, v);
-        }
-        return v;
-    }
-    indexByClass(cls, entry) {
-        const list = this.upsert(this.entriesByCls, cls, () => []);
-        this.insertSorted(list, entry);
-    }
-    indexByFlow(flow, entry) {
-        const list = this.upsert(this.hooksByFlow, flow, () => []);
-        this.insertSorted(list, entry);
-    }
-    indexByFlowStage(flow, stage, entry) {
-        const stages = this.upsert(this.hooksByFlowStage, flow, () => new Map());
-        const list = this.upsert(stages, String(stage), () => []);
-        this.insertSorted(list, entry);
-    }
-    initializeOne(embedded, token) {
-        const rec = this.defs.get(token);
-        const providers = this.providers; // nearest token provider registry
-        const instance = new hook_instance_1.HookInstance(this.scope, providers, rec, token);
-        this.instances.set(token, instance);
-        // Keep raw records grouped by class (if needed elsewhere)
-        const cls = rec.metadata.target;
-        if (cls) {
-            const recs = this.recordsByCls.get(cls) ?? [];
-            recs.push(rec);
-            this.recordsByCls.set(cls, recs);
-        }
-        // Build fast indexes of *instances*, sorted by priority
-        const entry = this.instances.get(token);
-        const { flow, stage, target } = rec.metadata;
-        if (embedded && target) {
-            this.indexByClass(target.constructor ?? target, entry);
-        }
-        else if (!embedded) {
-            this.indexByFlowStage(flow, String(stage), entry);
-            this.indexByFlow(flow, entry);
-        }
-        return instance.ready;
-    }
-    registerHooks(embedded, ...records) {
-        const readyArr = [];
-        for (const record of records) {
-            this.defs.set(record.provide, record);
-            this.tokens.add(record.provide);
-            this.graph.set(record.provide, new Set());
-            readyArr.push(this.initializeOne(embedded, record.provide));
-        }
-        return Promise.all(readyArr);
-    }
-    /** Hooks for a given *flow*, filtered by owner if provided, sorted by priority (desc). */
-    getFlowHooksForOwner(flow, ownerId) {
-        const allHooks = this.getFlowHooks(flow);
-        if (!ownerId) {
-            return allHooks;
-        }
-        // Filter hooks to only include those that belong to the same owner or have no owner (global hooks)
-        return allHooks.filter((hook) => {
-            const hookOwner = hook.metadata.owner;
-            return !hookOwner || hookOwner.id === ownerId;
-        });
-    }
-    /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */
-    getClsHooks(token) {
-        return this.entriesByCls.get(token) ?? [];
-    }
-    /** All hooks (instances, unordered) */
-    getHooks() {
-        return [...this.instances.values()];
-    }
-    /** Hooks for a given *flow*, sorted by priority (desc). */
-    getFlowHooks(flow) {
-        const list = this.hooksByFlow.get(flow) ?? [];
-        return list;
-    }
-    /** Hooks for a specific *flow + stage*, sorted by priority (desc). */
-    getFlowStageHooks(flow, stage) {
-        const byStage = this.hooksByFlowStage.get(flow);
-        const list = byStage?.get(String(stage)) ?? [];
-        return list;
-    }
-}
-exports.default = HookRegistry;
-//# sourceMappingURL=hook.registry.js.map

package/src/hooks/hook.registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hook.registry.js","sourceRoot":"","sources":["../../../src/hooks/hook.registry.ts"],"names":[],"mappings":"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","sourcesContent":["// src/hooks/hook.registry.ts\n\nimport {\n  FlowCtxOf,\n  FlowInputOf,\n  FlowName,\n  FlowStagesOf,\n  HookEntry,\n  HookRecord,\n  HookRegistryInterface,\n  HookType,\n  ScopeEntry,\n  Token,\n} from '../common';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { HookInstance } from './hook.instance';\n\nexport default class HookRegistry\n  extends RegistryAbstract<HookEntry, HookRecord, HookType[]>\n  implements HookRegistryInterface\n{\n  scope: ScopeEntry;\n\n  /** Historical records by class (kept if you still want access to raw records) */\n  recordsByCls: Map<Token, HookRecord[]> = new Map();\n\n  /** Fast O(1) indexes of *instances*, sorted by priority (desc) */\n  private entriesByCls: Map<Token, HookEntry[]> = new Map();\n  private hooksByFlow: Map<FlowName, HookEntry[]> = new Map();\n  private hooksByFlowStage: Map<FlowName, Map<string, HookEntry[]>> = new Map();\n\n  constructor(providers: ProviderRegistry, list: HookType[]) {\n    super('HookRegistry', providers, list);\n    this.scope = this.providers.getActiveScope();\n  }\n\n  protected override buildMap(): RegistryBuildMapResult<HookRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, HookRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    /**\n     * No need to build graph for hooks,\n     * hooks are injected by other tokens\n     */\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    /**\n     * Currently, hooks cannot be depended on other tokens,\n     * in the future we can add this feature, so hooks can depends on:\n     * - other hooks completions\n     * - specific injected providers\n     */\n  }\n\n  async initialize() {\n    /**\n     * No need to initialize hooks,\n     * hooks are injected by other tokens\n     */\n  }\n\n  /** Priority helper (default 0) */\n  private getPriority(entry: Pick<HookEntry, 'metadata'> | Pick<HookRecord, 'metadata'>): number {\n    return entry.metadata?.priority ?? 0;\n  }\n\n  /** Binary insert by priority (desc). Stable for equal priorities. */\n  private insertSorted(arr: HookEntry[], item: HookEntry) {\n    const p = this.getPriority(item);\n    let lo = 0;\n    let hi = arr.length;\n    // Insert AFTER existing equal-priority items to keep stable order.\n    while (lo < hi) {\n      const mid = (lo + hi) >>> 1;\n      const mp = this.getPriority(arr[mid]);\n      if (mp < p) {\n        hi = mid;\n      } else {\n        lo = mid + 1;\n      }\n    }\n    arr.splice(lo, 0, item);\n  }\n\n  private upsert<K, V>(map: Map<K, V>, key: K, init: () => V): V {\n    let v = map.get(key);\n    if (!v) {\n      v = init();\n      map.set(key, v);\n    }\n    return v;\n  }\n\n  private indexByClass(cls: Token, entry: HookEntry) {\n    const list = this.upsert(this.entriesByCls, cls, () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private indexByFlow(flow: FlowName, entry: HookEntry) {\n    const list = this.upsert(this.hooksByFlow, flow, () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private indexByFlowStage(flow: FlowName, stage: string, entry: HookEntry) {\n    const stages = this.upsert(this.hooksByFlowStage, flow, () => new Map<string, HookEntry[]>());\n    const list = this.upsert(stages, String(stage), () => []);\n    this.insertSorted(list, entry);\n  }\n\n  private initializeOne(embedded: boolean, token: Token) {\n    const rec = this.defs.get(token)!;\n    const providers = this.providers; // nearest token provider registry\n    const instance = new HookInstance(this.scope, providers, rec, token);\n    this.instances.set(token, instance);\n\n    // Keep raw records grouped by class (if needed elsewhere)\n    const cls = rec.metadata.target;\n    if (cls) {\n      const recs = this.recordsByCls.get(cls) ?? [];\n      recs.push(rec);\n      this.recordsByCls.set(cls, recs);\n    }\n\n    // Build fast indexes of *instances*, sorted by priority\n    const entry = this.instances.get(token)!;\n    const { flow, stage, target } = rec.metadata;\n\n    if (embedded && target) {\n      this.indexByClass(target.constructor ?? target, entry);\n    } else if (!embedded) {\n      this.indexByFlowStage(flow, String(stage), entry);\n      this.indexByFlow(flow, entry);\n    }\n\n    return instance.ready;\n  }\n\n  registerHooks(embedded: boolean, ...records: HookRecord[]) {\n    const readyArr: Promise<void>[] = [];\n    for (const record of records) {\n      this.defs.set(record.provide, record);\n      this.tokens.add(record.provide);\n      this.graph.set(record.provide, new Set());\n      readyArr.push(this.initializeOne(embedded, record.provide));\n    }\n    return Promise.all(readyArr);\n  }\n\n  /** Hooks for a given *flow*, filtered by owner if provided, sorted by priority (desc). */\n  getFlowHooksForOwner<Name extends FlowName>(\n    flow: Name,\n    ownerId?: string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const allHooks = this.getFlowHooks(flow);\n    if (!ownerId) {\n      return allHooks;\n    }\n    // Filter hooks to only include those that belong to the same owner or have no owner (global hooks)\n    return allHooks.filter((hook) => {\n      const hookOwner = hook.metadata.owner;\n      return !hookOwner || hookOwner.id === ownerId;\n    });\n  }\n\n  /** Hooks defined on a given *class* (metadata.target), sorted by priority (desc). */\n  getClsHooks(token: Token): HookEntry[] {\n    return this.entriesByCls.get(token) ?? [];\n  }\n\n  /** All hooks (instances, unordered) */\n  getHooks(): HookEntry[] {\n    return [...this.instances.values()];\n  }\n\n  /** Hooks for a given *flow*, sorted by priority (desc). */\n  getFlowHooks<Name extends FlowName>(\n    flow: Name,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const list = this.hooksByFlow.get(flow) ?? [];\n    return list as HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n  }\n\n  /** Hooks for a specific *flow + stage*, sorted by priority (desc). */\n  getFlowStageHooks<Name extends FlowName>(\n    flow: Name,\n    stage: FlowStagesOf<Name> | string,\n  ): HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[] {\n    const byStage = this.hooksByFlowStage.get(flow);\n    const list = byStage?.get(String(stage)) ?? [];\n    return list as HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[];\n  }\n}\n"]}

package/src/hooks/hooks.utils.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.collectHook = collectHook;
-exports.normalizeHooksFromCls = normalizeHooksFromCls;
-const common_1 = require("../common");
-const hook_decorator_1 = require("../common/decorators/hook.decorator");
-const metadata_utils_1 = require("../utils/metadata.utils");
-const token_utils_1 = require("../utils/token.utils");
-function collectHook(cls) {
-    return ((0, metadata_utils_1.getMetadata)(common_1.FrontMcpFlowHookTokens.hooks, cls) ?? []);
-}
-function normalizeHooksFromCls(instance) {
-    const item = instance.constructor;
-    if ((0, token_utils_1.isClass)(item)) {
-        // Get hooks from legacy decorators (Reflect.metadata)
-        const legacyHooks = collectHook(item);
-        // Get hooks from TC39 decorators (pending registry)
-        // This is needed when running with tsx/esbuild which uses TC39 decorators
-        const tc39Hooks = (0, hook_decorator_1.resolvePendingTC39HooksForClass)(item);
-        // Combine both sources
-        const allHooks = [...legacyHooks, ...tc39Hooks];
-        return allHooks.map((hook) => ({
-            kind: common_1.HookKind.METHOD_TOKEN,
-            provide: hook.static ? item[hook.method] : instance[hook.method],
-            metadata: {
-                ...hook,
-                target: hook.static ? item : instance,
-            },
-        }));
-    }
-    // ignore hooks from non-class items
-    return [];
-}
-//# sourceMappingURL=hooks.utils.js.map

package/src/hooks/hooks.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.utils.js","sourceRoot":"","sources":["../../../src/hooks/hooks.utils.ts"],"names":[],"mappings":";;AAKA,kCAEC;AAED,sDAwBC;AAjCD,sCAA8F;AAC9F,wEAAsF;AACtF,4DAAsD;AACtD,sDAA+C;AAE/C,SAAgB,WAAW,CAAC,GAAU;IACpC,OAAO,CAAC,IAAA,4BAAW,EAAC,+BAAsB,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,CAAmB,CAAC;AAClF,CAAC;AAED,SAAgB,qBAAqB,CAAC,QAAa;IACjD,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,CAAC;IAClC,IAAI,IAAA,qBAAO,EAAC,IAAI,CAAC,EAAE,CAAC;QAClB,sDAAsD;QACtD,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAEtC,oDAAoD;QACpD,0EAA0E;QAC1E,MAAM,SAAS,GAAG,IAAA,gDAA+B,EAAC,IAAI,CAAC,CAAC;QAExD,uBAAuB;QACvB,MAAM,QAAQ,GAAG,CAAC,GAAG,WAAW,EAAE,GAAG,SAAS,CAAC,CAAC;QAEhD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7B,IAAI,EAAE,iBAAQ,CAAC,YAAY;YAC3B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;YAChE,QAAQ,EAAE;gBACR,GAAG,IAAI;gBACP,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ;aACtC;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IACD,oCAAoC;IACpC,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import { FrontMcpFlowHookTokens, HookKind, HookMetadata, HookRecord, Token } from '../common';\nimport { resolvePendingTC39HooksForClass } from '../common/decorators/hook.decorator';\nimport { getMetadata } from '../utils/metadata.utils';\nimport { isClass } from '../utils/token.utils';\n\nexport function collectHook(cls: Token): HookMetadata[] {\n  return (getMetadata(FrontMcpFlowHookTokens.hooks, cls) ?? []) as HookMetadata[];\n}\n\nexport function normalizeHooksFromCls(instance: any): HookRecord[] {\n  const item = instance.constructor;\n  if (isClass(item)) {\n    // Get hooks from legacy decorators (Reflect.metadata)\n    const legacyHooks = collectHook(item);\n\n    // Get hooks from TC39 decorators (pending registry)\n    // This is needed when running with tsx/esbuild which uses TC39 decorators\n    const tc39Hooks = resolvePendingTC39HooksForClass(item);\n\n    // Combine both sources\n    const allHooks = [...legacyHooks, ...tc39Hooks];\n\n    return allHooks.map((hook) => ({\n      kind: HookKind.METHOD_TOKEN,\n      provide: hook.static ? item[hook.method] : instance[hook.method],\n      metadata: {\n        ...hook,\n        target: hook.static ? item : instance,\n      },\n    }));\n  }\n  // ignore hooks from non-class items\n  return [];\n}\n"]}