@frontmcp/sdk 0.2.5 → 0.3.0

package/src/app/app.registry.d.ts

@@ -0,0 +1,12 @@
+import 'reflect-metadata';
+import { AppType, AppEntry, AppRecord } from '../common';
+import ProviderRegistry from '../provider/provider.registry';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+export default class AppRegistry extends RegistryAbstract<AppEntry, AppRecord, AppType[]> {
+    constructor(globalProviders: ProviderRegistry, list: AppType[]);
+    protected buildMap(list: AppType[]): RegistryBuildMapResult<AppRecord>;
+    protected buildGraph(): void;
+    /** Instantiate adapters, run fetch/transform, and populate registries. */
+    protected initialize(): Promise<void>;
+    getApps(): AppEntry[];
+}

package/src/app/app.registry.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const common_1 = require("../common");
+const app_utils_1 = require("./app.utils");
+const regsitry_1 = require("../regsitry");
+const token_utils_1 = require("../utils/token.utils");
+const instances_1 = require("./instances");
+class AppRegistry extends regsitry_1.RegistryAbstract {
+    constructor(globalProviders, list) {
+        super('AppRegistry', globalProviders, list);
+    }
+    buildMap(list) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        for (const raw of list) {
+            const rec = (0, app_utils_1.normalizeApp)(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 = (0, app_utils_1.appDiscoveryDeps)(rec);
+            for (const d of deps) {
+                if (!this.providers.get(d)) {
+                    throw new Error(`App ${(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 rec = this.defs.get(token);
+            let app;
+            if (rec.kind === common_1.AppKind.LOCAL_CLASS) {
+                app = new instances_1.AppLocalInstance(rec, this.providers);
+            }
+            else if (rec.kind === common_1.AppKind.REMOTE_VALUE) {
+                app = new instances_1.AppRemoteInstance(rec, this.providers);
+            }
+            else {
+                // TODO: use specific error class
+                throw Error('Invalid adapter kind');
+            }
+            this.instances.set(token, app);
+            readyArr.push(app.ready);
+        }
+        await Promise.all(readyArr);
+    }
+    getApps() {
+        return [...this.instances.values()];
+    }
+}
+exports.default = AppRegistry;
+//# sourceMappingURL=app.registry.js.map

package/src/app/app.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.registry.js","sourceRoot":"","sources":["../../../src/app/app.registry.ts"],"names":[],"mappings":"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","sourcesContent":["import 'reflect-metadata';\nimport { AppType, Token, AppEntry, AppKind, AppRecord } from '../common';\nimport { appDiscoveryDeps, normalizeApp } from './app.utils';\nimport ProviderRegistry from '../provider/provider.registry';\nimport { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';\nimport { tokenName } from '../utils/token.utils';\nimport { AppLocalInstance, AppRemoteInstance } from './instances';\n\nexport default class AppRegistry extends RegistryAbstract<AppEntry, AppRecord, AppType[]> {\n\n  constructor(\n    globalProviders: ProviderRegistry,\n    list: AppType[],\n  ) {\n    super('AppRegistry', globalProviders, list);\n  }\n\n\n  protected buildMap(list: AppType[]): RegistryBuildMapResult<AppRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, AppRecord>();\n    const graph = new Map<Token, Set<Token>>();\n    for (const raw of list) {\n      const rec = normalizeApp(raw);\n      const provide = rec.provide;\n      tokens.add(provide);\n      defs.set(provide, rec);\n      graph.set(provide, new Set());\n    }\n    return { tokens, defs, graph };\n  }\n\n  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = appDiscoveryDeps(rec);\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`App ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  /** Instantiate adapters, run fetch/transform, and populate registries. */\n  protected async initialize(): Promise<void> {\n    const readyArr: Promise<void>[] = [];\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n\n      let app: AppEntry;\n      if (rec.kind === AppKind.LOCAL_CLASS) {\n        app = new AppLocalInstance(rec, this.providers);\n      } else if (rec.kind === AppKind.REMOTE_VALUE) {\n        app = new AppRemoteInstance(rec, this.providers);\n      } else {\n        // TODO: use specific error class\n        throw Error('Invalid adapter kind');\n      }\n\n      this.instances.set(token, app);\n      readyArr.push(app.ready);\n    }\n    await Promise.all(readyArr);\n  }\n\n\n  getApps(): AppEntry[] {\n    return [...this.instances.values()];\n  }\n}\n"]}

package/src/app/app.utils.d.ts

@@ -0,0 +1,15 @@
+import { LocalAppMetadata, AppType, Token, AppRecord } from '../common';
+export declare function collectAppMetadata(cls: AppType): LocalAppMetadata;
+/**
+ * Normalize a raw app metadata list into useful maps/sets.
+ * - tokens: all provided tokens
+ * - defs: AppRecord by token
+ * - graph: initialized adjacency map (empty sets)
+ */
+export declare function normalizeApp(item: AppType): AppRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - REMOTE_VALUE: no deps
+ * - LOCAL_CLASS: deps come from the class constructor
+ */
+export declare function appDiscoveryDeps(rec: AppRecord): Token[];

package/src/app/app.utils.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectAppMetadata = collectAppMetadata;
+exports.normalizeApp = normalizeApp;
+exports.appDiscoveryDeps = appDiscoveryDeps;
+const common_1 = require("../common");
+const metadata_utils_1 = require("../utils/metadata.utils");
+const token_utils_1 = require("../utils/token.utils");
+function collectAppMetadata(cls) {
+    return Object.entries(common_1.FrontMcpLocalAppTokens).reduce((metadata, [key, token]) => {
+        return Object.assign(metadata, {
+            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
+        });
+    }, {});
+}
+/**
+ * Normalize a raw app metadata list into useful maps/sets.
+ * - tokens: all provided tokens
+ * - defs: AppRecord by token
+ * - graph: initialized adjacency map (empty sets)
+ */
+function normalizeApp(item) {
+    if ((0, token_utils_1.isClass)(item)) {
+        const metadata = collectAppMetadata(item);
+        return { kind: common_1.AppKind.LOCAL_CLASS, provide: item, metadata };
+    }
+    if (item && typeof item === 'object') {
+        const { provide, useValue, ...metadata } = item;
+        if (!provide) {
+            const name = item?.name ?? JSON.stringify(item) ?? '[object]';
+            throw new Error(`App '${name}' is missing 'provide'.`);
+        }
+        if (useValue) {
+            return {
+                kind: common_1.AppKind.REMOTE_VALUE,
+                provide,
+                useValue,
+                metadata,
+            };
+        }
+    }
+    const name = item?.name ?? String(item);
+    throw new Error(`Invalid app '${name}'. Expected a class or remote app config object.`);
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - REMOTE_VALUE: no deps
+ * - LOCAL_CLASS: deps come from the class constructor
+ */
+function appDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        case common_1.AppKind.REMOTE_VALUE:
+            return [];
+        case common_1.AppKind.LOCAL_CLASS:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
+    }
+}
+//# sourceMappingURL=app.utils.js.map

package/src/app/app.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.utils.js","sourceRoot":"","sources":["../../../src/app/app.utils.ts"],"names":[],"mappings":";;AAaA,gDAOC;AAQD,oCAuBC;AAQD,4CAOC;AAlED,sCAQmB;AACnB,4DAAsD;AACtD,sDAA4D;AAG5D,SAAgB,kBAAkB,CAAC,GAAY;IAE7C,OAAO,MAAM,CAAC,OAAO,CAAC,+BAAsB,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9E,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,EAAsB,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,IAAa;IACxC,IAAI,IAAA,qBAAO,EAAC,IAAI,CAAC,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,gBAAO,CAAC,WAAW,EAAE,OAAO,EAAE,IAA8B,EAAE,QAAQ,EAAE,CAAC;IAC1F,CAAC;IACD,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAW,CAAC;QACvD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,GAAI,IAAY,EAAE,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,yBAAyB,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,IAAI,EAAE,gBAAO,CAAC,YAAY;gBAC1B,OAAO;gBACP,QAAQ;gBACR,QAAQ;aACT,CAAC;QACJ,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAI,IAAY,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,kDAAkD,CAAC,CAAC;AAC1F,CAAC;AAGD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,GAAc;IAC7C,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,gBAAO,CAAC,YAAY;YACvB,OAAO,EAAE,CAAC;QACZ,KAAK,gBAAO,CAAC,WAAW;YACtB,OAAO,IAAA,yBAAW,EAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACjD,CAAC;AACH,CAAC","sourcesContent":["import {\n  LocalAppMetadata,\n  FrontMcpLocalAppTokens,\n  AppType,\n  Type,\n  Token,\n  AppRecord,\n  AppKind,\n} from '../common';\nimport { getMetadata } from '../utils/metadata.utils';\nimport { depsOfClass, isClass } from '../utils/token.utils';\nimport { AppLocalInstance } from './instances';\n\nexport function collectAppMetadata(cls: AppType): LocalAppMetadata {\n\n  return Object.entries(FrontMcpLocalAppTokens).reduce((metadata, [key, token]) => {\n    return Object.assign(metadata, {\n      [key]: getMetadata(token, cls),\n    });\n  }, {} as LocalAppMetadata);\n}\n\n/**\n * Normalize a raw app metadata list into useful maps/sets.\n * - tokens: all provided tokens\n * - defs: AppRecord by token\n * - graph: initialized adjacency map (empty sets)\n */\nexport function normalizeApp(item: AppType): AppRecord {\n  if (isClass(item)) {\n    const metadata = collectAppMetadata(item);\n    return { kind: AppKind.LOCAL_CLASS, provide: item as Type<AppLocalInstance>, metadata };\n  }\n  if (item && typeof item === 'object') {\n    const { provide, useValue, ...metadata } = item as any;\n    if (!provide) {\n      const name = (item as any)?.name ?? JSON.stringify(item) ?? '[object]';\n      throw new Error(`App '${name}' is missing 'provide'.`);\n    }\n\n    if (useValue) {\n      return {\n        kind: AppKind.REMOTE_VALUE,\n        provide,\n        useValue,\n        metadata,\n      };\n    }\n  }\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(`Invalid app '${name}'. Expected a class or remote app config object.`);\n}\n\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - REMOTE_VALUE: no deps\n * - LOCAL_CLASS: deps come from the class constructor\n */\nexport function appDiscoveryDeps(rec: AppRecord): Token[] {\n  switch (rec.kind) {\n    case AppKind.REMOTE_VALUE:\n      return [];\n    case AppKind.LOCAL_CLASS:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}"]}

package/src/app/instances/app.local.instance.d.ts

@@ -0,0 +1,25 @@
+import { AppEntry, AppRecord, LocalAppMetadata } from '../../common';
+import ProviderRegistry from '../../provider/provider.registry';
+import ToolRegistry from '../../tool/tool.registry';
+import ResourceRegistry from '../../resource/resource.registry';
+import PromptRegistry from '../../prompt/prompt.registry';
+import AdapterRegistry from '../../adapter/adapter.regsitry';
+import PluginRegistry from '../../plugin/plugin.registry';
+export declare class AppLocalInstance extends AppEntry<LocalAppMetadata> {
+    readonly id: string;
+    private scopeProviders;
+    private appProviders;
+    private appPlugins;
+    private appAdapters;
+    private appTools;
+    private appResources;
+    private appPrompts;
+    constructor(record: AppRecord, scopeProviders: ProviderRegistry);
+    protected initialize(): Promise<void>;
+    get providers(): Readonly<ProviderRegistry>;
+    get adapters(): Readonly<AdapterRegistry>;
+    get plugins(): Readonly<PluginRegistry>;
+    get tools(): Readonly<ToolRegistry>;
+    get resources(): Readonly<ResourceRegistry>;
+    get prompts(): Readonly<PromptRegistry>;
+}

package/src/app/instances/app.local.instance.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppLocalInstance = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("../../common");
+const string_utils_1 = require("../../utils/string.utils");
+const provider_registry_1 = tslib_1.__importDefault(require("../../provider/provider.registry"));
+const tool_registry_1 = tslib_1.__importDefault(require("../../tool/tool.registry"));
+const resource_registry_1 = tslib_1.__importDefault(require("../../resource/resource.registry"));
+const prompt_registry_1 = tslib_1.__importDefault(require("../../prompt/prompt.registry"));
+const adapter_regsitry_1 = tslib_1.__importDefault(require("../../adapter/adapter.regsitry"));
+const plugin_registry_1 = tslib_1.__importDefault(require("../../plugin/plugin.registry"));
+class AppLocalInstance extends common_1.AppEntry {
+    id;
+    scopeProviders;
+    appProviders;
+    appPlugins;
+    appAdapters;
+    appTools;
+    appResources;
+    appPrompts;
+    constructor(record, scopeProviders) {
+        super(record);
+        this.scopeProviders = scopeProviders;
+        this.id = this.metadata.id ?? (0, string_utils_1.idFromString)(this.metadata.name);
+        this.ready = this.initialize();
+    }
+    async initialize() {
+        this.appProviders = new provider_registry_1.default(this.metadata.providers ?? [], this.scopeProviders);
+        await this.appProviders.ready; // wait for providers to be ready
+        // this.authProviders = new AuthRegistry(this.providers, this.metadata.authProviders ?? []);
+        // await this.authProviders.ready; // wait for providers to be ready
+        this.appPlugins = new plugin_registry_1.default(this.appProviders, this.metadata.plugins ?? []);
+        await this.appPlugins.ready; // wait for plugins and it's providers/adapters/tools/resource/prompts to be ready
+        this.appAdapters = new adapter_regsitry_1.default(this.appProviders, this.metadata.adapters ?? []);
+        await this.appAdapters.ready;
+        this.appTools = new tool_registry_1.default(this.appProviders, this.metadata.tools ?? [], {
+            kind: 'app',
+            id: this.id,
+            ref: this.token,
+        });
+        this.appResources = new resource_registry_1.default(this.appProviders, this.metadata.resources ?? []);
+        this.appPrompts = new prompt_registry_1.default(this.appProviders, this.metadata.prompts ?? []);
+        await Promise.all([
+            this.appTools.ready,
+            this.appResources.ready,
+            this.appPrompts.ready,
+        ]);
+    }
+    get providers() {
+        return this.appProviders;
+    }
+    get adapters() {
+        return this.appAdapters;
+    }
+    get plugins() {
+        return this.appPlugins;
+    }
+    get tools() {
+        return this.appTools;
+    }
+    get resources() {
+        return this.appResources;
+    }
+    get prompts() {
+        return this.appPrompts;
+    }
+}
+exports.AppLocalInstance = AppLocalInstance;
+//# sourceMappingURL=app.local.instance.js.map

package/src/app/instances/app.local.instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.local.instance.js","sourceRoot":"","sources":["../../../../src/app/instances/app.local.instance.ts"],"names":[],"mappings":";;;;AAAA,yCAAmE;AACnE,2DAAsD;AACtD,iGAAgE;AAChE,qFAAoD;AACpD,iGAAgE;AAChE,2FAA0D;AAC1D,8FAA6D;AAC7D,2FAA0D;AAE1D,MAAa,gBAAiB,SAAQ,iBAA0B;IAC5C,EAAE,CAAS;IAErB,cAAc,CAAmB;IACjC,YAAY,CAAmB;IAC/B,UAAU,CAAiB;IAC3B,WAAW,CAAkB;IAC7B,QAAQ,CAAe;IACvB,YAAY,CAAmB;IAC/B,UAAU,CAAiB;IAGnC,YAAY,MAAiB,EAAE,cAAgC;QAC7D,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;QACrC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAA,2BAAY,EAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAGS,KAAK,CAAC,UAAU;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7F,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,iCAAiC;QAChE,4FAA4F;QAC5F,oEAAoE;QAEpE,IAAI,CAAC,UAAU,GAAG,IAAI,yBAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACrF,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,kFAAkF;QAE/G,IAAI,CAAC,WAAW,GAAG,IAAI,0BAAe,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;QACxF,MAAM,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAE7B,IAAI,CAAC,QAAQ,GAAG,IAAI,uBAAY,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,EAAE;YAC7E,IAAI,EAAE,KAAK;YACX,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,GAAG,EAAE,IAAI,CAAC,KAAK;SAChB,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAgB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,UAAU,GAAG,IAAI,yBAAc,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAErF,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,KAAK;YACnB,IAAI,CAAC,YAAY,CAAC,KAAK;YACvB,IAAI,CAAC,UAAU,CAAC,KAAK;SACtB,CAAC,CAAC;IAEL,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAGD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;CAEF;AAzED,4CAyEC","sourcesContent":["import {AppEntry, AppRecord, LocalAppMetadata} from '../../common';\nimport {idFromString} from '../../utils/string.utils';\nimport ProviderRegistry from '../../provider/provider.registry';\nimport ToolRegistry from '../../tool/tool.registry';\nimport ResourceRegistry from '../../resource/resource.registry';\nimport PromptRegistry from '../../prompt/prompt.registry';\nimport AdapterRegistry from '../../adapter/adapter.regsitry';\nimport PluginRegistry from '../../plugin/plugin.registry';\n\nexport class AppLocalInstance extends AppEntry<LocalAppMetadata> {\n  override readonly id: string;\n\n  private scopeProviders: ProviderRegistry;\n  private appProviders: ProviderRegistry;\n  private appPlugins: PluginRegistry;\n  private appAdapters: AdapterRegistry;\n  private appTools: ToolRegistry;\n  private appResources: ResourceRegistry;\n  private appPrompts: PromptRegistry;\n\n\n  constructor(record: AppRecord, scopeProviders: ProviderRegistry) {\n    super(record);\n    this.scopeProviders = scopeProviders;\n    this.id = this.metadata.id ?? idFromString(this.metadata.name);\n    this.ready = this.initialize();\n  }\n\n\n  protected async initialize() {\n    this.appProviders = new ProviderRegistry(this.metadata.providers ?? [], this.scopeProviders);\n    await this.appProviders.ready; // wait for providers to be ready\n    // this.authProviders = new AuthRegistry(this.providers, this.metadata.authProviders ?? []);\n    // await this.authProviders.ready; // wait for providers to be ready\n\n    this.appPlugins = new PluginRegistry(this.appProviders, this.metadata.plugins ?? []);\n    await this.appPlugins.ready; // wait for plugins and it's providers/adapters/tools/resource/prompts to be ready\n\n    this.appAdapters = new AdapterRegistry(this.appProviders, this.metadata.adapters ?? []);\n    await this.appAdapters.ready;\n\n    this.appTools = new ToolRegistry(this.appProviders, this.metadata.tools ?? [], {\n      kind: 'app',\n      id: this.id,\n      ref: this.token,\n    });\n    this.appResources = new ResourceRegistry(this.appProviders, this.metadata.resources ?? []);\n    this.appPrompts = new PromptRegistry(this.appProviders, this.metadata.prompts ?? []);\n\n    await Promise.all([\n      this.appTools.ready,\n      this.appResources.ready,\n      this.appPrompts.ready,\n    ]);\n\n  }\n\n  get providers(): Readonly<ProviderRegistry> {\n    return this.appProviders;\n  }\n\n  get adapters(): Readonly<AdapterRegistry> {\n    return this.appAdapters;\n  }\n\n  get plugins(): Readonly<PluginRegistry> {\n    return this.appPlugins;\n  }\n\n\n  get tools(): Readonly<ToolRegistry> {\n    return this.appTools;\n  }\n\n  get resources(): Readonly<ResourceRegistry> {\n    return this.appResources;\n  }\n\n  get prompts(): Readonly<PromptRegistry> {\n    return this.appPrompts;\n  }\n\n}"]}

package/src/app/instances/app.remote.instance.d.ts

@@ -0,0 +1,13 @@
+import { AdapterRegistryInterface, AppEntry, AppRecord, PluginRegistryInterface, PromptRegistryInterface, ProviderRegistryInterface, RemoteAppMetadata, ResourceRegistryInterface, ToolRegistryInterface } from '../../common';
+import ProviderRegistry from '../../provider/provider.registry';
+export declare class AppRemoteInstance extends AppEntry<RemoteAppMetadata> {
+    readonly id: string;
+    constructor(record: AppRecord, scopeProviders: ProviderRegistry);
+    protected initialize(): Promise<void>;
+    get providers(): ProviderRegistryInterface;
+    get adapters(): AdapterRegistryInterface;
+    get plugins(): PluginRegistryInterface;
+    get tools(): ToolRegistryInterface;
+    get resources(): ResourceRegistryInterface;
+    get prompts(): PromptRegistryInterface;
+}

package/src/app/instances/app.remote.instance.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppRemoteInstance = void 0;
+const common_1 = require("../../common");
+const string_utils_1 = require("../../utils/string.utils");
+class AppRemoteInstance extends common_1.AppEntry {
+    id;
+    constructor(record, scopeProviders) {
+        super(record);
+        this.id = this.metadata.id ?? (0, string_utils_1.idFromString)(this.metadata.name);
+        this.ready = this.initialize();
+    }
+    async initialize() {
+        console.log('FrontMcpAppRemoteInstance.ready', this.id);
+    }
+    get providers() {
+        throw new Error('Method not implemented.');
+    }
+    get adapters() {
+        throw new Error('Method not implemented.');
+    }
+    get plugins() {
+        throw new Error('Method not implemented.');
+    }
+    get tools() {
+        throw new Error('Method not implemented.');
+    }
+    get resources() {
+        throw new Error('Method not implemented.');
+    }
+    get prompts() {
+        throw new Error('Method not implemented.');
+    }
+}
+exports.AppRemoteInstance = AppRemoteInstance;
+//# sourceMappingURL=app.remote.instance.js.map

package/src/app/instances/app.remote.instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.remote.instance.js","sourceRoot":"","sources":["../../../../src/app/instances/app.remote.instance.ts"],"names":[],"mappings":";;;AAAA,yCAUsB;AACtB,2DAAsD;AAGtD,MAAa,iBAAkB,SAAQ,iBAA2B;IAC9C,EAAE,CAAS;IAE7B,YAAY,MAAiB,EAAE,cAAgC;QAC7D,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAA,2BAAY,EAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAGS,KAAK,CAAC,UAAU;QAExB,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,IAAa,SAAS;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAa,QAAQ;QACnB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAa,OAAO;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAa,KAAK;QAChB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAa,SAAS;QACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED,IAAa,OAAO;QAClB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;CAEF;AAxCD,8CAwCC","sourcesContent":["import {\n  AdapterRegistryInterface,\n  AppEntry,\n  AppRecord,\n  PluginRegistryInterface,\n  PromptRegistryInterface,\n  ProviderRegistryInterface,\n  RemoteAppMetadata,\n  ResourceRegistryInterface,\n  ToolRegistryInterface,\n} from '../../common';\nimport {idFromString} from '../../utils/string.utils';\nimport ProviderRegistry from '../../provider/provider.registry';\n\nexport class AppRemoteInstance extends AppEntry<RemoteAppMetadata> {\n  override readonly id: string;\n\n  constructor(record: AppRecord, scopeProviders: ProviderRegistry) {\n    super(record);\n    this.id = this.metadata.id ?? idFromString(this.metadata.name);\n\n    this.ready = this.initialize();\n  }\n\n\n  protected async initialize() {\n\n    console.log('FrontMcpAppRemoteInstance.ready', this.id);\n  }\n\n  override get providers(): ProviderRegistryInterface {\n    throw new Error('Method not implemented.');\n  }\n\n  override get adapters(): AdapterRegistryInterface {\n    throw new Error('Method not implemented.');\n  }\n\n  override get plugins(): PluginRegistryInterface {\n    throw new Error('Method not implemented.');\n  }\n\n  override get tools(): ToolRegistryInterface {\n    throw new Error('Method not implemented.');\n  }\n\n  override get resources(): ResourceRegistryInterface {\n    throw new Error('Method not implemented.');\n  }\n\n  override get prompts(): PromptRegistryInterface {\n    throw new Error('Method not implemented.');\n  }\n\n}"]}

package/src/app/instances/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app.local.instance';
+export * from './app.remote.instance';

package/src/app/instances/index.js

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

package/src/app/instances/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/app/instances/index.ts"],"names":[],"mappings":";;;AACA,+DAAoC;AACpC,gEAAqC","sourcesContent":["\nexport * from './app.local.instance'\nexport * from './app.remote.instance'"]}

package/src/auth/auth.registry.d.ts

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+import { RegistryAbstract, RegistryBuildMapResult } from '../regsitry';
+import ProviderRegistry from '../provider/provider.registry';
+import { AuthOptions, FrontMcpAuth, AuthProviderType, AuthProviderEntry, AuthRegistryInterface, AuthProviderRecord, EntryOwnerRef } from '../common';
+export declare class AuthRegistry extends RegistryAbstract<AuthProviderEntry, AuthProviderRecord, AuthProviderType[]> implements AuthRegistryInterface {
+    private readonly primary?;
+    constructor(providers: ProviderRegistry, metadata: AuthProviderType[], owner: EntryOwnerRef, primary?: AuthOptions);
+    protected buildMap(list: AuthProviderType[]): RegistryBuildMapResult<AuthProviderRecord>;
+    protected buildGraph(): void;
+    protected initialize(): Promise<void>;
+    getPrimary(): FrontMcpAuth;
+    getAuthProviders(): AuthProviderEntry[];
+}

package/src/auth/auth.registry.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthRegistry = void 0;
+// auth/auth.registry.ts
+require("reflect-metadata");
+const regsitry_1 = require("../regsitry");
+const common_1 = require("../common");
+const auth_utils_1 = require("./auth.utils");
+const token_utils_1 = require("../utils/token.utils");
+const instance_remote_primary_auth_1 = require("./instances/instance.remote-primary-auth");
+const instance_local_primary_auth_1 = require("./instances/instance.local-primary-auth");
+class AuthRegistry extends regsitry_1.RegistryAbstract {
+    primary;
+    constructor(providers, metadata, owner, primary) {
+        super('AuthRegistry', providers, metadata, false);
+        let primaryRecord;
+        if (primary) {
+            this.primary = primary.type === 'remote' ? new instance_remote_primary_auth_1.RemotePrimaryAuth(providers, primary) : new instance_local_primary_auth_1.LocalPrimaryAuth(providers, primary);
+            primaryRecord = {
+                kind: common_1.AuthProviderKind.PRIMARY,
+                provide: common_1.FrontMcpAuth,
+                useValue: this.primary,
+                metadata: primary,
+            };
+        }
+        else {
+            const defaultMetadata = { type: 'local', id: 'local', name: 'default-auth', allowAnonymous: true };
+            this.primary = new instance_local_primary_auth_1.LocalPrimaryAuth(providers, defaultMetadata);
+            primaryRecord = {
+                kind: common_1.AuthProviderKind.PRIMARY,
+                provide: common_1.FrontMcpAuth,
+                useValue: this.primary,
+                metadata: defaultMetadata,
+            };
+        }
+        this.tokens.add(common_1.FrontMcpAuth);
+        this.defs.set(common_1.FrontMcpAuth, primaryRecord);
+        this.graph.set(common_1.FrontMcpAuth, new Set());
+        this.buildGraph();
+        this.ready = this.initialize();
+    }
+    buildMap(list) {
+        const tokens = new Set();
+        const defs = new Map();
+        const graph = new Map();
+        for (const raw of list) {
+            const rec = (0, auth_utils_1.normalizeAuth)(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 = (0, auth_utils_1.authDiscoveryDeps)(rec);
+            for (const d of deps) {
+                if (!this.providers.get(d)) {
+                    throw new Error(`AuthProvider ${(0, token_utils_1.tokenName)(token)} depends on ${(0, token_utils_1.tokenName)(d)}, which is not registered.`);
+                }
+                this.graph.get(token).add(d);
+            }
+        }
+    }
+    async initialize() {
+        if (this.primary) {
+            await this.primary.ready;
+        }
+        return Promise.resolve();
+    }
+    getPrimary() {
+        return this.primary;
+    }
+    getAuthProviders() {
+        return [...this.instances.values()];
+    }
+}
+exports.AuthRegistry = AuthRegistry;
+//# sourceMappingURL=auth.registry.js.map

package/src/auth/auth.registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.registry.js","sourceRoot":"","sources":["../../../src/auth/auth.registry.ts"],"names":[],"mappings":"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","sourcesContent":["// auth/auth.registry.ts\nimport 'reflect-metadata';\nimport {RegistryAbstract, RegistryBuildMapResult} from '../regsitry';\nimport ProviderRegistry from '../provider/provider.registry';\nimport {\n  AuthOptions,\n  FrontMcpAuth,\n  AuthProviderType,\n  Token, AuthProviderEntry, AuthRegistryInterface, AuthProviderRecord, AuthProviderKind, EntryOwnerRef,\n  PrimaryAuthRecord,\n} from '../common';\nimport {authDiscoveryDeps, normalizeAuth} from './auth.utils';\nimport {tokenName} from '../utils/token.utils';\nimport {RemotePrimaryAuth} from './instances/instance.remote-primary-auth';\nimport {LocalPrimaryAuth} from './instances/instance.local-primary-auth';\n\nexport class AuthRegistry extends RegistryAbstract<AuthProviderEntry, AuthProviderRecord, AuthProviderType[]> implements AuthRegistryInterface {\n  private readonly primary?: FrontMcpAuth;\n\n  constructor(providers: ProviderRegistry, metadata: AuthProviderType[], owner: EntryOwnerRef, primary?: AuthOptions) {\n    super('AuthRegistry', providers, metadata, false);\n\n    let primaryRecord: PrimaryAuthRecord;\n    if (primary) {\n      this.primary = primary.type === 'remote' ? new RemotePrimaryAuth(providers, primary) : new LocalPrimaryAuth(providers, primary);\n      primaryRecord = {\n        kind: AuthProviderKind.PRIMARY,\n        provide: FrontMcpAuth,\n        useValue: this.primary,\n        metadata: primary,\n      }\n    } else {\n      const defaultMetadata: AuthOptions = {type: 'local', id: 'local', name: 'default-auth', allowAnonymous: true}\n      this.primary = new LocalPrimaryAuth(providers, defaultMetadata);\n      primaryRecord = {\n        kind: AuthProviderKind.PRIMARY,\n        provide: FrontMcpAuth,\n        useValue: this.primary,\n        metadata: defaultMetadata,\n      }\n    }\n    this.tokens.add(FrontMcpAuth);\n    this.defs.set(FrontMcpAuth, primaryRecord)\n    this.graph.set(FrontMcpAuth, new Set())\n\n    this.buildGraph();\n    this.ready = this.initialize();\n  }\n\n  protected override buildMap(list: AuthProviderType[]): RegistryBuildMapResult<AuthProviderRecord> {\n    const tokens = new Set<Token>();\n    const defs = new Map<Token, AuthProviderRecord>();\n    const graph = new Map<Token, Set<Token>>();\n\n    for (const raw of list) {\n      const rec = normalizeAuth(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  protected buildGraph() {\n    for (const token of this.tokens) {\n      const rec = this.defs.get(token)!;\n      const deps = authDiscoveryDeps(rec);\n\n      for (const d of deps) {\n        if (!this.providers.get(d)) {\n          throw new Error(`AuthProvider ${tokenName(token)} depends on ${tokenName(d)}, which is not registered.`);\n        }\n        this.graph.get(token)!.add(d);\n      }\n    }\n  }\n\n  protected async initialize(): Promise<void> {\n    if (this.primary) {\n      await this.primary.ready;\n    }\n    return Promise.resolve();\n  }\n\n\n  getPrimary(): FrontMcpAuth {\n    return this.primary!;\n  }\n\n  getAuthProviders(): AuthProviderEntry[] {\n    return [...this.instances.values()];\n  }\n}\n"]}

package/src/auth/auth.utils.d.ts

@@ -0,0 +1,10 @@
+import { AuthProviderMetadata, AuthProviderType, Token, AuthProviderRecord } from '../common';
+export declare function collectAuthMetadata(cls: AuthProviderType): AuthProviderMetadata;
+export declare function normalizeAuth(item: AuthProviderType): AuthProviderRecord;
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - VALUE: no deps
+ * - FACTORY: only includes deps that are registered (others will be resolved)
+ * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)
+ */
+export declare function authDiscoveryDeps(rec: AuthProviderRecord): Token[];

package/src/auth/auth.utils.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.collectAuthMetadata = collectAuthMetadata;
+exports.normalizeAuth = normalizeAuth;
+exports.authDiscoveryDeps = authDiscoveryDeps;
+// auth/auth.utils.ts
+const token_utils_1 = require("../utils/token.utils");
+const common_1 = require("../common");
+const metadata_utils_1 = require("../utils/metadata.utils");
+function collectAuthMetadata(cls) {
+    return Object.entries(common_1.FrontMcpAuthProviderTokens).reduce((metadata, [key, token]) => {
+        return Object.assign(metadata, {
+            [key]: (0, metadata_utils_1.getMetadata)(token, cls),
+        });
+    }, {});
+}
+function normalizeAuth(item) {
+    if ((0, token_utils_1.isClass)(item)) {
+        // read McpAuthMetadata from class
+        const metadata = collectAuthMetadata(item);
+        return { kind: common_1.AuthProviderKind.CLASS_TOKEN, provide: item, metadata };
+    }
+    if (item && typeof item === 'object') {
+        const { provide, useClass, useValue, useFactory, inject, ...metadata } = item;
+        if (!provide) {
+            const name = item?.name ?? '[object]';
+            throw new Error(`Auth '${name}' is missing 'provide'.`);
+        }
+        if (useClass) {
+            if (!(0, token_utils_1.isClass)(useClass)) {
+                throw new Error(`'useClass' on auth '${(0, token_utils_1.tokenName)(provide)}' must be a class.`);
+            }
+            return {
+                kind: common_1.AuthProviderKind.CLASS,
+                provide,
+                useClass,
+                metadata,
+            };
+        }
+        if (useFactory) {
+            if (typeof useFactory !== 'function') {
+                throw new Error(`'useFactory' on auth '${(0, token_utils_1.tokenName)(provide)}' must be a function.`);
+            }
+            const inj = typeof inject === 'function' ? inject : () => [];
+            return {
+                kind: common_1.AuthProviderKind.FACTORY,
+                provide,
+                inject: inj,
+                useFactory,
+                metadata,
+            };
+        }
+        if ('useValue' in item) {
+            return {
+                kind: common_1.AuthProviderKind.VALUE,
+                provide,
+                useValue,
+                metadata,
+            };
+        }
+    }
+    const name = item?.name ?? String(item);
+    throw new Error(`Invalid auth '${name}'. Expected a class or a auth object.`);
+}
+/**
+ * For graph/cycle detection. Returns dependency tokens that should be graphed.
+ * - VALUE: no deps
+ * - FACTORY: only includes deps that are registered (others will be resolved)
+ * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)
+ */
+function authDiscoveryDeps(rec) {
+    switch (rec.kind) {
+        case common_1.AuthProviderKind.VALUE:
+        case common_1.AuthProviderKind.PRIMARY:
+            return [];
+        case common_1.AuthProviderKind.FACTORY: {
+            return [...rec.inject()];
+        }
+        case common_1.AuthProviderKind.CLASS:
+            return (0, token_utils_1.depsOfClass)(rec.useClass, 'discovery');
+        case common_1.AuthProviderKind.CLASS_TOKEN:
+            return (0, token_utils_1.depsOfClass)(rec.provide, 'discovery');
+    }
+}
+//# sourceMappingURL=auth.utils.js.map

package/src/auth/auth.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.utils.js","sourceRoot":"","sources":["../../../src/auth/auth.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// auth/auth.utils.ts\nimport { depsOfClass, isClass, tokenName } from '../utils/token.utils';\nimport {\n  AuthProviderMetadata,\n  FrontMcpAuthProviderTokens,\n  AuthProviderType,\n  Token,\n  AuthProviderRecord, AuthProviderKind,\n} from '../common';\nimport { getMetadata } from '../utils/metadata.utils';\n\nexport function collectAuthMetadata(cls: AuthProviderType): AuthProviderMetadata {\n  return Object.entries(FrontMcpAuthProviderTokens).reduce((metadata, [key, token]) => {\n    return Object.assign(metadata, {\n      [key]: getMetadata(token, cls),\n    });\n  }, {} as AuthProviderMetadata);\n}\n\nexport function normalizeAuth(item: AuthProviderType): AuthProviderRecord {\n  if (isClass(item)) {\n    // read McpAuthMetadata from class\n    const metadata = collectAuthMetadata(item);\n    return { kind: AuthProviderKind.CLASS_TOKEN, provide: item, metadata };\n  }\n  if (item && typeof item === 'object') {\n    const { provide, useClass, useValue, useFactory, inject, ...metadata } = item as any;\n\n    if (!provide) {\n      const name = (item as any)?.name ?? '[object]';\n      throw new Error(`Auth '${name}' is missing 'provide'.`);\n    }\n\n    if (useClass) {\n      if (!isClass(useClass)) {\n        throw new Error(\n          `'useClass' on auth '${tokenName(provide)}' must be a class.`,\n        );\n      }\n      return {\n        kind: AuthProviderKind.CLASS,\n        provide,\n        useClass,\n        metadata,\n      };\n    }\n\n    if (useFactory) {\n      if (typeof useFactory !== 'function') {\n        throw new Error(\n          `'useFactory' on auth '${tokenName(provide)}' must be a function.`,\n        );\n      }\n      const inj = typeof inject === 'function' ? inject : () => [] as const;\n      return {\n        kind: AuthProviderKind.FACTORY,\n        provide,\n        inject: inj,\n        useFactory,\n        metadata,\n      };\n    }\n\n    if ('useValue' in item) {\n      return {\n        kind: AuthProviderKind.VALUE,\n        provide,\n        useValue,\n        metadata,\n      };\n    }\n  }\n\n  const name = (item as any)?.name ?? String(item);\n  throw new Error(\n    `Invalid auth '${name}'. Expected a class or a auth object.`,\n  );\n}\n\n\n/**\n * For graph/cycle detection. Returns dependency tokens that should be graphed.\n * - VALUE: no deps\n * - FACTORY: only includes deps that are registered (others will be resolved)\n * - CLASS / CLASS_TOKEN: deps come from the class constructor or static with(...)\n */\nexport function authDiscoveryDeps(rec: AuthProviderRecord): Token[] {\n  switch (rec.kind) {\n    case AuthProviderKind.VALUE:\n    case AuthProviderKind.PRIMARY:\n      return [];\n\n    case AuthProviderKind.FACTORY: {\n      return [...rec.inject()];\n    }\n    case AuthProviderKind.CLASS:\n      return depsOfClass(rec.useClass, 'discovery');\n\n    case AuthProviderKind.CLASS_TOKEN:\n      return depsOfClass(rec.provide, 'discovery');\n  }\n}\n"]}