@frontmcp/sdk 0.2.5 → 0.3.0

package/src/flows/flow.instance.js

@@ -0,0 +1,332 @@
+"use strict";
+// noinspection ExceptionCaughtLocallyJS
+// flows/flow.instance.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowInstance = void 0;
+require("reflect-metadata");
+const common_1 = require("../common");
+const flow_stages_1 = require("./flow.stages");
+const server_validation_1 = require("../server/server.validation");
+const CAP = (s) => (s ? s[0].toUpperCase() + s.slice(1) : s);
+const WILL = (s) => `will${CAP(s)}`;
+const DID = (s) => `did${CAP(s)}`;
+const AROUND = (s) => `around${CAP(s)}`;
+function parseTypedKey(k) {
+    const lc = k.toLowerCase();
+    if (lc.startsWith('will') && k.length > 4)
+        return { base: k.slice(4, 5).toLowerCase() + k.slice(5), type: 'will' };
+    if (lc.startsWith('did') && k.length > 3)
+        return { base: k.slice(3, 4).toLowerCase() + k.slice(4), type: 'did' };
+    if (lc.startsWith('around') && k.length > 6)
+        return { base: k.slice(6, 7).toLowerCase() + k.slice(7), type: 'around' };
+    return { base: k };
+}
+class FlowInstance extends common_1.FlowEntry {
+    deps;
+    globalProviders;
+    plan;
+    FlowClass;
+    stages;
+    hooks;
+    constructor(scope, record, deps, globalProviders) {
+        super(scope, record);
+        this.deps = [...deps];
+        this.globalProviders = globalProviders;
+        this.FlowClass = this.record.provide;
+        this.ready = this.initialize();
+        this.plan = this.record.metadata.plan;
+        this.hooks = scope.providers.getHooksRegistry();
+    }
+    async initialize() {
+        const server = this.globalProviders.getActiveServer();
+        this.stages = (0, flow_stages_1.collectFlowHookMap)(this.FlowClass);
+        const { middleware } = this.metadata;
+        if (middleware) {
+            const path = typeof middleware.path === 'string' ? middleware.path : '';
+            server.registerMiddleware(path, async (request, response, next) => {
+                const canActivate = await this.canActivate(request);
+                if (!canActivate)
+                    return next();
+                try {
+                    const result = await this.run({ request, response, next }, new Map());
+                    if (result)
+                        return (0, server_validation_1.writeHttpResponse)(response, result);
+                }
+                catch (e) {
+                    if (e instanceof common_1.FlowControl) {
+                        switch (e.type) {
+                            case 'abort':
+                                return (0, server_validation_1.writeHttpResponse)(response, { kind: 'text', status: 500, body: 'Aborted' });
+                            case 'fail':
+                                return (0, server_validation_1.writeHttpResponse)(response, { kind: 'text', status: 500, body: 'Internal Server Error' });
+                            case 'handled':
+                                return;
+                            case 'next':
+                                return next();
+                            case 'respond':
+                                return (0, server_validation_1.writeHttpResponse)(response, e.output);
+                        }
+                    }
+                    // eslint-disable-next-line no-console
+                    console.error(e);
+                    return (0, server_validation_1.writeHttpResponse)(response, {
+                        kind: 'text',
+                        status: 500,
+                        body: 'Internal Server Error',
+                    });
+                }
+                return next();
+            });
+        }
+        return Promise.resolve();
+    }
+    async canActivate(request) {
+        if (this.method && request.method !== this.method)
+            return false;
+        const canActivate = this.metadata.middleware?.canActivate ?? [];
+        if (this.FlowClass['canActivate']) {
+            canActivate.push(this.FlowClass['canActivate']);
+        }
+        if (canActivate.length === 0)
+            return true;
+        const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));
+        return results.every((r) => r);
+    }
+    async run(input, deps) {
+        const scope = this.globalProviders.getActiveScope();
+        const { FlowClass, plan, name } = this;
+        // Clone stages so we can merge injections safely per run.
+        const baseStages = this.stages;
+        let stages = (0, flow_stages_1.cloneStageMap)(baseStages);
+        // Compute next order base after any class-defined entries.
+        let orderBase = Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e) => e._order ?? 0))) + 1;
+        const initialInjectedHooks = this.hooks.getFlowHooks(name) ?? [];
+        let context;
+        let contextReady = false;
+        const materializeAndMerge = async (newHooks, opts) => {
+            if (!newHooks?.length || !contextReady)
+                return;
+            const metas = [];
+            for (const h of newHooks) {
+                try {
+                    metas.push(h.metadata);
+                }
+                catch (e) {
+                    // eslint-disable-next-line no-console
+                    console.warn('[flow] Ignoring injected hook that failed to materialize:', e);
+                }
+            }
+            if (metas.length) {
+                const start = opts?.orderStart ?? orderBase;
+                (0, flow_stages_1.mergeHookMetasIntoStageMap)(FlowClass, stages, metas, start);
+                if (opts?.orderStart === undefined)
+                    orderBase += metas.length;
+            }
+        };
+        const appendContextHooks = async (hooks) => {
+            await materializeAndMerge(hooks);
+        };
+        // Construct flow instance
+        context = new FlowClass(this.metadata, input, scope, appendContextHooks, deps);
+        // Now injections can materialize
+        contextReady = true;
+        // Initial registry hooks should not pre-empt stages; they just get registered
+        await materializeAndMerge(initialInjectedHooks, { orderStart: -1_000_000 });
+        // Refresh order base to be after everything currently present
+        orderBase =
+            Math.max(0, ...Object.values(stages).flatMap((list) => list.map((e) => e._order ?? 0))) + 1;
+        let responded;
+        // Robust list runner (doesn't skip mid-run insertions)
+        const runList = async (key, opts) => {
+            const getList = () => (stages[key] ?? []);
+            const seen = new Set();
+            while (true) {
+                const list = getList();
+                const item = list.find((e) => !seen.has(e));
+                if (!item)
+                    break;
+                seen.add(item);
+                try {
+                    await item.method(context);
+                }
+                catch (e) {
+                    if (e instanceof common_1.FlowControl) {
+                        if (e.type === 'respond') {
+                            if (!opts?.ignoreRespond) {
+                                responded = e.output;
+                                return { outcome: 'respond', control: e };
+                            }
+                            continue;
+                        }
+                        return { outcome: e.type, control: e };
+                    }
+                    return { outcome: 'unknown_error', control: e };
+                }
+            }
+            return { outcome: 'ok' };
+        };
+        // Run exactly one stage in order: will → around → stage → did (did runs once)
+        const runOneStage = async (stageName, stopOnRespond) => {
+            // 1) willStage
+            {
+                const res = await runList(WILL(stageName));
+                if (res.outcome === 'respond' && stopOnRespond)
+                    return res;
+                if (res.outcome !== 'ok' && res.outcome !== 'respond')
+                    return res;
+            }
+            // 2) aroundStage (acts as pre-handlers unless you later add true wrapping)
+            {
+                const res = await runList(AROUND(stageName));
+                if (res.outcome === 'respond' && stopOnRespond)
+                    return res;
+                if (res.outcome !== 'ok' && res.outcome !== 'respond')
+                    return res;
+            }
+            // 3) stage
+            let bodyOutcome = { outcome: 'ok' };
+            {
+                const res = await runList(stageName, { ignoreRespond: false });
+                bodyOutcome = res;
+                if (res.outcome !== 'ok' && res.outcome !== 'respond') {
+                    // fail/abort/next/handled/unknown → do NOT run did
+                    // return res;/
+                    throw res.control;
+                }
+            }
+            // 4) didStage (run once regardless of body respond)
+            {
+                const res = await runList(DID(stageName), { ignoreRespond: true });
+                if (res.outcome !== 'ok' && res.outcome !== 'respond')
+                    return res;
+            }
+            if (bodyOutcome.outcome === 'respond')
+                return bodyOutcome;
+            return { outcome: 'ok' };
+        };
+        // IMPORTANT: ignore typed stage names in plan arrays.
+        // Only base stage names in the plan drive execution; typed hooks run *with* their base.
+        const runStageGroup = async (group, stopOnRespond, opts) => {
+            if (!group || group.length === 0)
+                return { outcome: 'ok' };
+            const seenBase = new Set();
+            for (const rawKey of group) {
+                const { base, type } = parseTypedKey(rawKey);
+                if (type) {
+                    // Soft warning once per typed key occurrence (optional)
+                    // console.warn(`[flow] Ignoring typed stage "${rawKey}" in plan; hooks will run with base "${base}".`);
+                    continue; // Do not run typed keys as standalone stages
+                }
+                if (seenBase.has(base))
+                    continue;
+                seenBase.add(base);
+                const res = await runOneStage(base, stopOnRespond);
+                if (res.outcome === 'respond') {
+                    if (stopOnRespond)
+                        return res;
+                    // else keep going
+                }
+                else if (res.outcome !== 'ok') {
+                    return res.control?.['output'] ?? res.outcome;
+                }
+            }
+            return { outcome: 'ok' };
+        };
+        const runErrorStage = async () => {
+            await runStageGroup(plan.error, false, { ignoreRespond: true });
+        };
+        const runFinalizeStage = async () => {
+            await runStageGroup(plan.finalize, false);
+        };
+        try {
+            // ---------- PRE ----------
+            {
+                const pre = await runStageGroup(plan.pre, true);
+                if (pre.outcome === 'respond') {
+                    const post = await runStageGroup(plan.post, false);
+                    if (post.outcome === 'unknown_error' || post.outcome === 'fail') {
+                        try {
+                            await runErrorStage();
+                        }
+                        finally {
+                            await runFinalizeStage();
+                        }
+                        if (post.outcome === 'fail')
+                            throw post.control;
+                        throw post.control;
+                    }
+                    if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {
+                        await runFinalizeStage();
+                        throw post.control;
+                    }
+                    await runFinalizeStage();
+                    return responded;
+                }
+                if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {
+                    try {
+                        await runErrorStage();
+                    }
+                    finally {
+                        await runFinalizeStage();
+                    }
+                    if (pre.outcome === 'fail')
+                        throw pre.control;
+                    throw pre.control;
+                }
+                if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {
+                    await runFinalizeStage();
+                    throw pre.control;
+                }
+            }
+            // ---------- EXECUTE ----------
+            if (!responded) {
+                const exec = await runStageGroup(plan.execute, true);
+                if (exec.outcome === 'respond') {
+                    // continue to post + finalize
+                }
+                else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {
+                    try {
+                        await runErrorStage();
+                    }
+                    finally {
+                        await runFinalizeStage();
+                    }
+                    if (exec.outcome === 'fail')
+                        throw exec.control;
+                    throw exec.control;
+                }
+                else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {
+                    await runFinalizeStage();
+                    throw exec.control;
+                }
+            }
+            // ---------- POST ----------
+            {
+                const post = await runStageGroup(plan.post, false);
+                if (post.outcome === 'unknown_error' || post.outcome === 'fail') {
+                    try {
+                        await runErrorStage();
+                    }
+                    finally {
+                        await runFinalizeStage();
+                    }
+                    if (post.outcome === 'fail')
+                        throw post.control;
+                    throw post.control;
+                }
+                if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {
+                    await runFinalizeStage();
+                    throw post.control;
+                }
+            }
+            // ---------- FINALIZE ----------
+            await runFinalizeStage();
+            return responded;
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+}
+exports.FlowInstance = FlowInstance;
+//# sourceMappingURL=flow.instance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow.instance.js","sourceRoot":"","sources":["../../../src/flows/flow.instance.ts"],"names":[],"mappings":"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","sourcesContent":["// noinspection ExceptionCaughtLocallyJS\n// flows/flow.instance.ts\n\nimport 'reflect-metadata';\nimport {\n  FlowControl,\n  FlowCtxOf,\n  FlowEntry,\n  FlowInputOf,\n  FlowName,\n  FlowOutputOf,\n  FlowPlan,\n  FlowRecord,\n  FlowStagesOf,\n  FlowType,\n  HookEntry,\n  HookMetadata,\n  Reference,\n  ServerRequest,\n  Token,\n  Type,\n} from '../common';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  collectFlowHookMap,\n  StageMap,\n  cloneStageMap,\n  mergeHookMetasIntoStageMap,\n} from './flow.stages';\nimport {writeHttpResponse} from '../server/server.validation';\nimport {Scope} from '../scope';\nimport HookRegistry from '../hooks/hook.registry';\nimport {rpcError} from \"../transport/transport.error\";\n\ntype StageOutcome =\n  | 'ok'\n  | 'respond'\n  | 'next'\n  | 'handled'\n  | 'fail'\n  | 'abort'\n  | 'unknown_error';\n\ninterface StageResult {\n  outcome: StageOutcome;\n  control?: FlowControl | Error;\n}\n\nconst CAP = (s: string) => (s ? s[0].toUpperCase() + s.slice(1) : s);\nconst WILL = (s: string) => `will${CAP(s)}`;\nconst DID = (s: string) => `did${CAP(s)}`;\nconst AROUND = (s: string) => `around${CAP(s)}`;\n\nfunction parseTypedKey(k: string): { base: string; type?: 'will' | 'did' | 'around' } {\n  const lc = k.toLowerCase();\n  if (lc.startsWith('will') && k.length > 4) return {base: k.slice(4, 5).toLowerCase() + k.slice(5), type: 'will'};\n  if (lc.startsWith('did') && k.length > 3) return {base: k.slice(3, 4).toLowerCase() + k.slice(4), type: 'did'};\n  if (lc.startsWith('around') && k.length > 6) return {base: k.slice(6, 7).toLowerCase() + k.slice(7), type: 'around'};\n  return {base: k};\n}\n\nexport class FlowInstance<Name extends FlowName> extends FlowEntry<Name> {\n  readonly deps: Reference[];\n  readonly globalProviders: ProviderRegistry;\n  private plan: FlowPlan<never>;\n  private FlowClass: FlowType;\n  private stages: StageMap<FlowType>;\n  private hooks: HookRegistry;\n\n  constructor(\n    scope: Scope,\n    record: FlowRecord,\n    deps: Set<Reference>,\n    globalProviders: ProviderRegistry,\n  ) {\n    super(scope, record);\n    this.deps = [...deps];\n    this.globalProviders = globalProviders;\n    this.FlowClass = this.record.provide;\n    this.ready = this.initialize();\n    this.plan = this.record.metadata.plan;\n    this.hooks = scope.providers.getHooksRegistry();\n  }\n\n  protected async initialize() {\n    const server = this.globalProviders.getActiveServer();\n\n    this.stages = collectFlowHookMap(this.FlowClass);\n\n    const {middleware} = this.metadata;\n    if (middleware) {\n      const path = typeof middleware.path === 'string' ? middleware.path : '';\n      server.registerMiddleware(path, async (request, response, next) => {\n        const canActivate = await this.canActivate(request);\n        if (!canActivate) return next();\n\n        try {\n          const result = await this.run(\n            {request, response, next} as any,\n            new Map(),\n          );\n          if (result) return writeHttpResponse(response, result);\n        } catch (e) {\n          if (e instanceof FlowControl) {\n            switch (e.type) {\n              case 'abort':\n                return writeHttpResponse(response, {kind: 'text', status: 500, body: 'Aborted'});\n              case 'fail':\n                return writeHttpResponse(response, {kind: 'text', status: 500, body: 'Internal Server Error'});\n              case 'handled':\n                return;\n              case 'next':\n                return next();\n              case 'respond':\n                return writeHttpResponse(response, e.output as any);\n            }\n          }\n          // eslint-disable-next-line no-console\n          console.error(e);\n          return writeHttpResponse(response, {\n            kind: 'text',\n            status: 500,\n            body: 'Internal Server Error',\n          });\n        }\n\n        return next();\n      });\n    }\n\n    return Promise.resolve();\n  }\n\n  async canActivate(request: ServerRequest): Promise<boolean> {\n    if (this.method && request.method !== this.method) return false;\n\n    const canActivate = this.metadata.middleware?.canActivate ?? [];\n    if ((this.FlowClass as any)['canActivate']) {\n      canActivate.push((this.FlowClass as any)['canActivate']);\n    }\n    if (canActivate.length === 0) return true;\n\n    const results = await Promise.all(canActivate.map((m) => m(request, this.scope)));\n    return results.every((r) => r);\n  }\n\n  async run(\n    input: FlowInputOf<Name>,\n    deps: Map<Token, Type>,\n  ): Promise<FlowOutputOf<Name> | undefined> {\n    const scope = this.globalProviders.getActiveScope();\n    const {FlowClass, plan, name} = this;\n\n    // Clone stages so we can merge injections safely per run.\n    const baseStages = this.stages;\n    let stages: StageMap<any> = cloneStageMap(baseStages);\n\n    // Compute next order base after any class-defined entries.\n    let orderBase =\n      Math.max(\n        0,\n        ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0)),\n      ) + 1;\n\n    const initialInjectedHooks =\n      (this.hooks.getFlowHooks(name) as HookEntry<\n        FlowInputOf<Name>,\n        Name,\n        FlowStagesOf<Name>,\n        FlowCtxOf<Name>\n      >[]) ?? [];\n\n    let context: any;\n    let contextReady = false;\n\n    const materializeAndMerge = async (\n      newHooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n      opts?: { orderStart?: number },\n    ) => {\n      if (!newHooks?.length || !contextReady) return;\n\n      const metas: HookMetadata[] = [];\n      for (const h of newHooks) {\n        try {\n          metas.push(h.metadata);\n        } catch (e) {\n          // eslint-disable-next-line no-console\n          console.warn('[flow] Ignoring injected hook that failed to materialize:', e);\n        }\n      }\n\n      if (metas.length) {\n        const start = opts?.orderStart ?? orderBase;\n        mergeHookMetasIntoStageMap(FlowClass, stages, metas, start);\n        if (opts?.orderStart === undefined) orderBase += metas.length;\n      }\n    };\n\n    const appendContextHooks = async (\n      hooks: HookEntry<FlowInputOf<Name>, Name, FlowStagesOf<Name>, FlowCtxOf<Name>>[],\n    ) => {\n      await materializeAndMerge(hooks);\n    };\n\n    // Construct flow instance\n    context = new FlowClass(this.metadata, input, scope, appendContextHooks, deps);\n\n    // Now injections can materialize\n    contextReady = true;\n\n    // Initial registry hooks should not pre-empt stages; they just get registered\n    await materializeAndMerge(initialInjectedHooks, {orderStart: -1_000_000});\n\n    // Refresh order base to be after everything currently present\n    orderBase =\n      Math.max(\n        0,\n        ...Object.values(stages).flatMap((list) => list.map((e: any) => e._order ?? 0)),\n      ) + 1;\n\n    let responded: FlowOutputOf<Name> | undefined;\n\n    // Robust list runner (doesn't skip mid-run insertions)\n    const runList = async (\n      key: string,\n      opts?: { ignoreRespond?: boolean },\n    ): Promise<StageResult> => {\n      const getList = () => ((stages as any)[key] ?? []) as Array<{ method: (ctx: any) => Promise<void> }>;\n      const seen = new Set<any>();\n\n      while (true) {\n        const list = getList();\n        const item = list.find((e) => !seen.has(e));\n        if (!item) break;\n        seen.add(item);\n\n        try {\n          await item.method(context);\n        } catch (e: any) {\n          if (e instanceof FlowControl) {\n            if (e.type === 'respond') {\n              if (!opts?.ignoreRespond) {\n                responded = e.output as FlowOutputOf<Name>;\n                return {outcome: 'respond', control: e};\n              }\n              continue;\n            }\n            return {outcome: e.type, control: e};\n          }\n          return {outcome: 'unknown_error', control: e as Error};\n        }\n      }\n      return {outcome: 'ok'};\n    };\n\n    // Run exactly one stage in order: will → around → stage → did (did runs once)\n    const runOneStage = async (\n      stageName: string,\n      stopOnRespond: boolean,\n    ): Promise<StageResult> => {\n      // 1) willStage\n      {\n        const res = await runList(WILL(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 2) aroundStage (acts as pre-handlers unless you later add true wrapping)\n      {\n        const res = await runList(AROUND(stageName));\n        if (res.outcome === 'respond' && stopOnRespond) return res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      // 3) stage\n      let bodyOutcome: StageResult = {outcome: 'ok'};\n      {\n        const res = await runList(stageName, {ignoreRespond: false});\n        bodyOutcome = res;\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') {\n          // fail/abort/next/handled/unknown → do NOT run did\n          // return res;/\n          throw res.control\n        }\n      }\n\n      // 4) didStage (run once regardless of body respond)\n      {\n        const res = await runList(DID(stageName), {ignoreRespond: true});\n        if (res.outcome !== 'ok' && res.outcome !== 'respond') return res;\n      }\n\n      if (bodyOutcome.outcome === 'respond') return bodyOutcome;\n      return {outcome: 'ok'};\n    };\n\n    // IMPORTANT: ignore typed stage names in plan arrays.\n    // Only base stage names in the plan drive execution; typed hooks run *with* their base.\n    const runStageGroup = async (\n      group: Array<string> | undefined,\n      stopOnRespond: boolean,\n      opts?: { ignoreRespond?: boolean },\n    ): Promise<StageResult> => {\n      if (!group || group.length === 0) return {outcome: 'ok'};\n\n      const seenBase = new Set<string>();\n      for (const rawKey of group) {\n        const {base, type} = parseTypedKey(rawKey);\n        if (type) {\n          // Soft warning once per typed key occurrence (optional)\n          // console.warn(`[flow] Ignoring typed stage \"${rawKey}\" in plan; hooks will run with base \"${base}\".`);\n          continue; // Do not run typed keys as standalone stages\n        }\n        if (seenBase.has(base)) continue;\n        seenBase.add(base);\n\n        const res = await runOneStage(base, stopOnRespond);\n        if (res.outcome === 'respond') {\n          if (stopOnRespond) return res;\n          // else keep going\n        } else if (res.outcome !== 'ok') {\n          return res.control?.['output'] ?? res.outcome;\n        }\n      }\n      return {outcome: 'ok'};\n    };\n\n    const runErrorStage = async () => {\n      await runStageGroup((plan as any).error, false, {ignoreRespond: true});\n    };\n\n    const runFinalizeStage = async () => {\n      await runStageGroup((plan as any).finalize, false);\n    };\n\n    try {\n      // ---------- PRE ----------\n      {\n        const pre = await runStageGroup((plan as any).pre, true);\n        if (pre.outcome === 'respond') {\n          const post = await runStageGroup((plan as any).post, false);\n          if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n            try {\n              await runErrorStage();\n            } finally {\n              await runFinalizeStage();\n            }\n            if (post.outcome === 'fail') throw post.control!;\n            throw post.control!;\n          }\n          if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n            await runFinalizeStage();\n            throw post.control as FlowControl;\n          }\n          await runFinalizeStage();\n          return responded;\n        }\n        if (pre.outcome === 'unknown_error' || pre.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (pre.outcome === 'fail') throw pre.control!;\n          throw pre.control!;\n        }\n        if (pre.outcome === 'abort' || pre.outcome === 'next' || pre.outcome === 'handled') {\n          await runFinalizeStage();\n          throw pre.control as FlowControl;\n        }\n      }\n\n      // ---------- EXECUTE ----------\n      if (!responded) {\n        const exec = await runStageGroup((plan as any).execute, true);\n        if (exec.outcome === 'respond') {\n          // continue to post + finalize\n        } else if (exec.outcome === 'unknown_error' || exec.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (exec.outcome === 'fail') throw exec.control!;\n          throw exec.control!;\n        } else if (exec.outcome === 'abort' || exec.outcome === 'next' || exec.outcome === 'handled') {\n          await runFinalizeStage();\n          throw exec.control as FlowControl;\n        }\n      }\n\n      // ---------- POST ----------\n      {\n        const post = await runStageGroup((plan as any).post, false);\n        if (post.outcome === 'unknown_error' || post.outcome === 'fail') {\n          try {\n            await runErrorStage();\n          } finally {\n            await runFinalizeStage();\n          }\n          if (post.outcome === 'fail') throw post.control!;\n          throw post.control!;\n        }\n        if (post.outcome === 'abort' || post.outcome === 'next' || post.outcome === 'handled') {\n          await runFinalizeStage();\n          throw post.control as FlowControl;\n        }\n      }\n\n      // ---------- FINALIZE ----------\n      await runFinalizeStage();\n\n      return responded;\n    } catch (e) {\n      throw e;\n    }\n  }\n}\n"]}

package/src/flows/flow.registry.d.ts

@@ -0,0 +1,14 @@
+import ProviderRegistry from '../provider/provider.registry';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import { FlowInputOf, FlowName, FlowOutputOf, FlowRecord, FlowType, Token, Type } from '../common';
+import { FlowInstance } from './flow.instance';
+export default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName>, FlowRecord, FlowType[]> {
+    constructor(providers: ProviderRegistry, list: FlowType[]);
+    protected buildMap(list: FlowType[]): RegistryBuildMapResult<FlowRecord>;
+    protected buildGraph(): void;
+    /** Instantiate adapters, run fetch/transform, and populate registries. */
+    protected initialize(): Promise<void>;
+    private initializeOne;
+    registryFlows(rawFlows: FlowType[]): Promise<void>;
+    runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
+}

package/src/flows/flow.registry.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const regsitry_1 = require("../regsitry");
+const common_1 = require("../common");
+const flow_utils_1 = require("./flow.utils");
+const token_utils_1 = require("../utils/token.utils");
+const flow_instance_1 = require("./flow.instance");
+class FlowRegistry extends regsitry_1.RegistryAbstract {
+    constructor(providers, list) {
+        super('FlowRegistry', providers, list);
+    }
+    buildMap(list) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        for (const raw of list) {
+            const rec = (0, flow_utils_1.normalizeFlow)(raw);
+            const provide = rec.provide;
+            tokens.add(provide);
+            defs.set(provide, rec);
+            graph.set(provide, new Set());
+        }
+        return { tokens, defs, graph };
+    }
+    buildGraph() {
+        for (const token of this.tokens) {
+            const rec = this.defs.get(token);
+            const deps = rec.metadata.dependsOn ?? [];
+            for (const d of deps) {
+                if (d == common_1.ScopeEntry) {
+                    this.graph.get(token).add(common_1.ScopeEntry);
+                }
+                else {
+                    if (!this.providers.get(d)) {
+                        throw new Error(`Adapter ${(0, token_utils_1.tokenName)(token)} depends on ${(0, token_utils_1.tokenName)(d)}, which is not registered.`);
+                    }
+                    this.graph.get(token).add(d);
+                }
+            }
+        }
+    }
+    /** Instantiate adapters, run fetch/transform, and populate registries. */
+    async initialize() {
+        const readyArr = [];
+        for (const token of this.tokens) {
+            const instance = this.initializeOne(token);
+            readyArr.push(instance.ready);
+        }
+        await Promise.all(readyArr);
+    }
+    initializeOne(token) {
+        const rec = this.defs.get(token);
+        const deps = this.graph.get(token);
+        const instance = new flow_instance_1.FlowInstance(this.providers.getActiveScope(), rec, deps, this.providers);
+        this.instances.set(rec.metadata.name, instance);
+        return instance;
+    }
+    async registryFlows(rawFlows) {
+        const readyArr = [];
+        for (const raw of rawFlows) {
+            const rec = (0, flow_utils_1.normalizeFlow)(raw);
+            const provide = rec.provide;
+            this.tokens.add(provide);
+            this.defs.set(provide, rec);
+            this.graph.set(provide, new Set());
+            readyArr.push(this.initializeOne(provide).ready);
+        }
+        await Promise.all(readyArr);
+    }
+    runFlow(name, input, deps) {
+        const flow = this.instances.get(name);
+        if (!flow) {
+            throw new Error(`Flow ${name} is not registered`);
+        }
+        return flow.run(input, deps ?? new Map());
+    }
+}
+exports.default = FlowRegistry;
+//# sourceMappingURL=flow.registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow.registry.js","sourceRoot":"","sources":["../../../src/flows/flow.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { FlowInputOf, FlowName, FlowOutputOf, FlowRecord, FlowType, ScopeEntry, Token, Type } from '../common';\nimport { normalizeFlow } from './flow.utils';\nimport { tokenName } from '../utils/token.utils';\nimport { FlowInstance } from './flow.instance';\n\nexport default class FlowRegistry extends RegistryAbstract<FlowInstance<FlowName>, FlowRecord, FlowType[]> {\n  constructor(providers: ProviderRegistry, list: FlowType[]) {\n    super('FlowRegistry', providers, list);\n  }\n\n  protected override buildMap(list: FlowType[]): RegistryBuildMapResult<FlowRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, FlowRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n\n    return { tokens, defs, graph };\n  }\n\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = rec.metadata.dependsOn ?? [];\n\n      for (const d of deps) {\n        if (d == ScopeEntry) {\n          this.graph.get(token)!.add(ScopeEntry);\n        } else {\n          if (!this.providers.get(d)) {\n            throw new Error(`Adapter ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n          }\n          this.graph.get(token)!.add(d);\n        }\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const instance = this.initializeOne(token);\n      readyArr.push(instance.ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n  private initializeOne(token: Token) {\n    const rec = this.defs.get(token)!;\n    const deps = this.graph.get(token)!;\n\n    const instance = new FlowInstance(this.providers.getActiveScope(), rec, deps, this.providers);\n    this.instances.set(rec.metadata.name, instance);\n    return instance;\n  }\n\n\n  async registryFlows(rawFlows: FlowType[]): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const raw of rawFlows) {\n      const rec = normalizeFlow(raw);\n      const provide = rec.provide;\n      this.tokens.add(provide);\n      this.defs.set(provide, rec);\n      this.graph.set(provide, new Set());\n      readyArr.push(this.initializeOne(provide).ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n\n  runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, deps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined> {\n    const flow = this.instances.get(name);\n    if (!flow) {\n      throw new Error(`Flow ${name} is not registered`);\n    }\n    return flow.run(input, deps ?? new Map());\n  }\n}\n"]}

package/src/flows/flow.stages.d.ts

@@ -0,0 +1,12 @@
+import { HookMetadata } from '../common';
+export type StageEntry<C> = {
+    method: (ctx: C) => Promise<void>;
+    _priority: number;
+    _order: number;
+};
+export type StageMap<C> = Record<string, StageEntry<C>[]>;
+export declare function sortStageMap<C>(table: StageMap<C>): void;
+export declare function cloneStageMap<C>(table: StageMap<C>): StageMap<C>;
+export declare function resolveStageKey(type: HookMetadata['type'], stage: string): string;
+export declare function collectFlowHookMap<C>(FlowClass: any): StageMap<C>;
+export declare function mergeHookMetasIntoStageMap<C>(FlowClass: any, table: StageMap<C>, metas: HookMetadata[], orderStart?: number): void;

package/src/flows/flow.stages.js

@@ -0,0 +1,110 @@
+"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 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;
+    const metas = (Reflect.getMetadata(common_1.FrontMcpFlowHookTokens.hooks, FlowClass) ?? []);
+    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

@@ -0,0 +1 @@
+{"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';\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) return cached;\n\n  const metas = (Reflect.getMetadata(FrontMcpFlowHookTokens.hooks, FlowClass) ?? []) as HookMetadata[];\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'\n            ? (m as any).method\n            : 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          };\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          };\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.d.ts

@@ -0,0 +1,8 @@
+import { FlowMetadata, FlowRecord, FlowType, Token } from '../common';
+export declare function collectFlowMetadata(cls: FlowType): FlowMetadata<never>;
+export declare function normalizeFlow(item: FlowType): FlowRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - CLASS_TOKEN: deps come from the class constructor
+ */
+export declare function flowDiscoveryDeps(rec: FlowRecord): Token[];