@frontmcp/sdk 0.4.1 → 0.5.0

package/src/common/dynamic/dynamic.plugin.d.ts

@@ -1,20 +1,21 @@
 import { Reference, PluginType, ProviderType } from '../interfaces';
-type InitOptions<T> = ((T & {
+type InitOptions<TInput> = ((TInput & {
     useFactory?: never;
     inject?: never;
 }) & {
     providers?: readonly ProviderType[];
 }) | {
     inject: () => readonly Reference<any>[];
-    useFactory: (...args: any[]) => T;
+    useFactory: (...args: any[]) => TInput;
     providers?: readonly ProviderType[];
 };
-type PluginClassWithOptions<T> = {
+type PluginClassWithOptions<TInput, TOptions> = {
     new (...args: any[]): any;
     prototype: {
-        __options_brand?: T;
+        __options_brand?: TOptions;
+        __options_input_brand?: TInput;
     };
-    dynamicProviders?: (options: T) => readonly ProviderType[];
+    dynamicProviders?: (options: TInput) => readonly ProviderType[];
 };
 type ValueMcpPlugin<T> = {
     provide: any;
@@ -29,11 +30,21 @@ type FactoryMcpPlugin<T> = {
 type PluginReturn<T> = (ValueMcpPlugin<T> | FactoryMcpPlugin<T>) & PluginType & {
     providers?: readonly ProviderType[];
 };
-export declare abstract class DynamicPlugin<TOptions extends object> {
+/**
+ * Base class for plugins that support dynamic configuration.
+ *
+ * @template TOptions - The resolved options type (after parsing with defaults applied)
+ * @template TInput - The input options type (what users provide to init()). Defaults to TOptions for backwards compatibility.
+ */
+export declare abstract class DynamicPlugin<TOptions extends object, TInput extends object = TOptions> {
     /**
-     * Private property to ensure options are typed correctly.
+     * Brand for resolved options type (used internally).
      */
     __options_brand: TOptions;
+    /**
+     * Brand for input options type (used by init()).
+     */
+    __options_input_brand: TInput;
     /**
      * Optional hook to contribute providers to the plugin.
      * @param options
@@ -42,11 +53,11 @@ export declare abstract class DynamicPlugin<TOptions extends object> {
     get<T>(token: Reference<T>): T;
     /**
      * Static init() method to create a plugin provider.
-     * @param options
+     * @param options - Input options (with optional fields for defaults)
      */
-    static init<TThis extends PluginClassWithOptions<any>>(this: TThis, options: InitOptions<TThis['prototype'] extends {
-        __options_brand?: infer O;
-    } ? O : never>): PluginReturn<TThis['prototype'] extends {
+    static init<TThis extends PluginClassWithOptions<any, any>>(this: TThis, options: InitOptions<TThis['prototype'] extends {
+        __options_input_brand?: infer I;
+    } ? I : never>): PluginReturn<TThis['prototype'] extends {
         __options_brand?: infer O;
     } ? O : never>;
 }

package/src/common/dynamic/dynamic.plugin.js

@@ -2,13 +2,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DynamicPlugin = void 0;
 const dynamic_utils_1 = require("./dynamic.utils");
+/**
+ * Base class for plugins that support dynamic configuration.
+ *
+ * @template TOptions - The resolved options type (after parsing with defaults applied)
+ * @template TInput - The input options type (what users provide to init()). Defaults to TOptions for backwards compatibility.
+ */
 class DynamicPlugin {
     get(token) {
         throw new Error('Method not implemented.');
     }
     /**
      * Static init() method to create a plugin provider.
-     * @param options
+     * @param options - Input options (with optional fields for defaults)
      */
     static init(options) {
         const extraProviders = options.providers;

package/src/common/dynamic/dynamic.plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic.plugin.js","sourceRoot":"","sources":["../../../../src/common/dynamic/dynamic.plugin.ts"],"names":[],"mappings":";;;AAEA,mDAA+E;AA0B/E,MAAsB,aAAa;IAYjC,GAAG,CAAI,KAAmB;QACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,CAET,OAA0F;QAE1F,MAAM,cAAc,GAAI,OAAe,CAAC,SAAgD,CAAC;QACzF,MAAM,YAAY,GAAG,OAAc,CAAC;QAEpC,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,YAAY;gBACf,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,MAAgC;gBAChD,UAAU,EAAE,OAAO,CAAC,UAAiB;gBACrC,SAAS,EAAE,IAAA,qCAAqB,EAAC,cAAc,IAAI,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAA,uCAAuB,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,IAAA,qCAAqB,EAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,OAAO;YACL,GAAG,YAAY;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC;YAC3B,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;CACF;AA9CD,sCA8CC","sourcesContent":["// dynamic-plugin.ts\nimport {Reference, PluginType, ProviderType, ProviderRegistryInterface} from '../interfaces';\nimport {collectDynamicProviders, dedupePluginProviders} from './dynamic.utils';\n\n// keep your original options union; just add optional `providers`\ntype InitOptions<T> =\n  | ((T & { useFactory?: never; inject?: never }) & { providers?: readonly ProviderType[] })\n  | {\n  inject: () => readonly Reference<any>[];\n  useFactory: (...args: any[]) => T;\n  providers?: readonly ProviderType[];\n};\n\ntype PluginClassWithOptions<T> = {\n  new(...args: any[]): any;\n  prototype: { __options_brand?: T };\n  // optional hook contributed by plugin authors\n  dynamicProviders?: (options: T) => readonly ProviderType[];\n};\n\ntype ValueMcpPlugin<T> = { provide: any; useValue: T; providers?: ProviderType[] };\ntype FactoryMcpPlugin<T> = { provide: any; inject: () => readonly Reference<any>[]; useFactory: (...args: any[]) => T };\n\ntype PluginReturn<T> = (ValueMcpPlugin<T> | FactoryMcpPlugin<T>) &\n  PluginType & {\n  providers?: readonly ProviderType[];\n};\n\nexport abstract class DynamicPlugin<TOptions extends object> {\n  /**\n   * Private property to ensure options are typed correctly.\n   */\n  declare __options_brand: TOptions;\n\n  /**\n   * Optional hook to contribute providers to the plugin.\n   * @param options\n   */\n  static dynamicProviders?(options: any): readonly ProviderType[];\n\n  get<T>(token: Reference<T>): T {\n    throw new Error('Method not implemented.');\n  }\n\n  /**\n   * Static init() method to create a plugin provider.\n   * @param options\n   */\n  static init<TThis extends PluginClassWithOptions<any>>(\n    this: TThis,\n    options: InitOptions<TThis['prototype'] extends { __options_brand?: infer O } ? O : never>,\n  ): PluginReturn<TThis['prototype'] extends { __options_brand?: infer O } ? O : never> {\n    const extraProviders = (options as any).providers as readonly ProviderType[] | undefined;\n    const typedOptions = options as any;\n\n    if ('useFactory' in options) {\n      return {\n        ...typedOptions,\n        provide: this,\n        inject: options.inject as () => Reference<any>[],\n        useFactory: options.useFactory as any,\n        providers: dedupePluginProviders(extraProviders ?? []),\n      };\n    }\n\n    const dyn = collectDynamicProviders(this, typedOptions);\n    const mergedProviders = dedupePluginProviders([...(dyn ?? []), ...(extraProviders ?? [])]);\n    return {\n      ...typedOptions,\n      provide: this,\n      useValue: new this(options),\n      providers: mergedProviders,\n    };\n  }\n}"]}
+{"version":3,"file":"dynamic.plugin.js","sourceRoot":"","sources":["../../../../src/common/dynamic/dynamic.plugin.ts"],"names":[],"mappings":";;;AAEA,mDAAiF;AA0BjF;;;;;GAKG;AACH,MAAsB,aAAa;IAiBjC,GAAG,CAAI,KAAmB;QACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC7C,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAAI,CAET,OAAgG;QAEhG,MAAM,cAAc,GAAI,OAAe,CAAC,SAAgD,CAAC;QACzF,MAAM,YAAY,GAAG,OAAc,CAAC;QAEpC,IAAI,YAAY,IAAI,OAAO,EAAE,CAAC;YAC5B,OAAO;gBACL,GAAG,YAAY;gBACf,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,OAAO,CAAC,MAAgC;gBAChD,UAAU,EAAE,OAAO,CAAC,UAAiB;gBACrC,SAAS,EAAE,IAAA,qCAAqB,EAAC,cAAc,IAAI,EAAE,CAAC;aACvD,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,IAAA,uCAAuB,EAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACxD,MAAM,eAAe,GAAG,IAAA,qCAAqB,EAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,OAAO;YACL,GAAG,YAAY;YACf,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC;YAC3B,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;CACF;AAnDD,sCAmDC","sourcesContent":["// dynamic-plugin.ts\nimport { Reference, PluginType, ProviderType, ProviderRegistryInterface } from '../interfaces';\nimport { collectDynamicProviders, dedupePluginProviders } from './dynamic.utils';\n\n// InitOptions accepts input type (what users provide to init())\ntype InitOptions<TInput> =\n  | ((TInput & { useFactory?: never; inject?: never }) & { providers?: readonly ProviderType[] })\n  | {\n      inject: () => readonly Reference<any>[];\n      useFactory: (...args: any[]) => TInput;\n      providers?: readonly ProviderType[];\n    };\n\ntype PluginClassWithOptions<TInput, TOptions> = {\n  new (...args: any[]): any;\n  prototype: { __options_brand?: TOptions; __options_input_brand?: TInput };\n  // optional hook contributed by plugin authors\n  dynamicProviders?: (options: TInput) => readonly ProviderType[];\n};\n\ntype ValueMcpPlugin<T> = { provide: any; useValue: T; providers?: ProviderType[] };\ntype FactoryMcpPlugin<T> = { provide: any; inject: () => readonly Reference<any>[]; useFactory: (...args: any[]) => T };\n\ntype PluginReturn<T> = (ValueMcpPlugin<T> | FactoryMcpPlugin<T>) &\n  PluginType & {\n    providers?: readonly ProviderType[];\n  };\n\n/**\n * Base class for plugins that support dynamic configuration.\n *\n * @template TOptions - The resolved options type (after parsing with defaults applied)\n * @template TInput - The input options type (what users provide to init()). Defaults to TOptions for backwards compatibility.\n */\nexport abstract class DynamicPlugin<TOptions extends object, TInput extends object = TOptions> {\n  /**\n   * Brand for resolved options type (used internally).\n   */\n  declare __options_brand: TOptions;\n\n  /**\n   * Brand for input options type (used by init()).\n   */\n  declare __options_input_brand: TInput;\n\n  /**\n   * Optional hook to contribute providers to the plugin.\n   * @param options\n   */\n  static dynamicProviders?(options: any): readonly ProviderType[];\n\n  get<T>(token: Reference<T>): T {\n    throw new Error('Method not implemented.');\n  }\n\n  /**\n   * Static init() method to create a plugin provider.\n   * @param options - Input options (with optional fields for defaults)\n   */\n  static init<TThis extends PluginClassWithOptions<any, any>>(\n    this: TThis,\n    options: InitOptions<TThis['prototype'] extends { __options_input_brand?: infer I } ? I : never>,\n  ): PluginReturn<TThis['prototype'] extends { __options_brand?: infer O } ? O : never> {\n    const extraProviders = (options as any).providers as readonly ProviderType[] | undefined;\n    const typedOptions = options as any;\n\n    if ('useFactory' in options) {\n      return {\n        ...typedOptions,\n        provide: this,\n        inject: options.inject as () => Reference<any>[],\n        useFactory: options.useFactory as any,\n        providers: dedupePluginProviders(extraProviders ?? []),\n      };\n    }\n\n    const dyn = collectDynamicProviders(this, typedOptions);\n    const mergedProviders = dedupePluginProviders([...(dyn ?? []), ...(extraProviders ?? [])]);\n    return {\n      ...typedOptions,\n      provide: this,\n      useValue: new this(options),\n      providers: mergedProviders,\n    };\n  }\n}\n"]}

package/src/common/entries/prompt.entry.d.ts

@@ -1,6 +1,50 @@
-import { BaseEntry } from './base.entry';
+import { BaseEntry, EntryOwnerRef } from './base.entry';
 import { PromptRecord } from '../records';
-import { PromptInterface } from '../interfaces';
+import { PromptContext, PromptInterface } from '../interfaces';
 import { PromptMetadata } from '../metadata';
+import { GetPromptResult, Request, Notification } from '@modelcontextprotocol/sdk/types.js';
+import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+export type PromptGetExtra = RequestHandlerExtra<Request, Notification> & {
+    authInfo: AuthInfo;
+};
+export type ParsedPromptResult = GetPromptResult;
+export type PromptSafeTransformResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: Error;
+};
 export declare abstract class PromptEntry extends BaseEntry<PromptRecord, PromptInterface, PromptMetadata> {
+    owner: EntryOwnerRef;
+    /**
+     * The name of the prompt, as declared in the metadata.
+     */
+    name: string;
+    /**
+     * The full name of the prompt, including the owner name as prefix.
+     */
+    fullName: string;
+    /**
+     * Create a prompt context (class or function wrapper).
+     * @param args Arguments passed to the prompt
+     * @param ctx Request context with auth info
+     */
+    abstract create(args: Record<string, string>, ctx: PromptGetExtra): PromptContext;
+    /**
+     * Parse and validate arguments against the prompt's argument definitions.
+     * @param args Arguments from the MCP request
+     * @returns Validated arguments
+     */
+    abstract parseArguments(args?: Record<string, string>): Record<string, string>;
+    /**
+     * Convert the raw prompt return value into an MCP GetPromptResult.
+     * Accepts any raw output from the prompt execute method and normalizes it.
+     */
+    abstract parseOutput(raw: unknown): ParsedPromptResult;
+    /**
+     * Safe version of parseOutput that returns success/error instead of throwing.
+     */
+    abstract safeParseOutput(raw: unknown): PromptSafeTransformResult<ParsedPromptResult>;
 }

package/src/common/entries/prompt.entry.js

@@ -1,8 +1,18 @@
 "use strict";
+// file: libs/sdk/src/common/entries/prompt.entry.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PromptEntry = void 0;
 const base_entry_1 = require("./base.entry");
 class PromptEntry extends base_entry_1.BaseEntry {
+    owner;
+    /**
+     * The name of the prompt, as declared in the metadata.
+     */
+    name;
+    /**
+     * The full name of the prompt, including the owner name as prefix.
+     */
+    fullName;
 }
 exports.PromptEntry = PromptEntry;
 //# sourceMappingURL=prompt.entry.js.map

package/src/common/entries/prompt.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.entry.js","sourceRoot":"","sources":["../../../../src/common/entries/prompt.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAMzC,MAAsB,WAAY,SAAQ,sBAAwD;CAGjG;AAHD,kCAGC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { PromptRecord } from '../records';\nimport { PromptInterface } from '../interfaces';\nimport { PromptMetadata } from '../metadata';\n\n\nexport abstract class PromptEntry extends BaseEntry<PromptRecord, PromptInterface, PromptMetadata> {\n\n\n}\n\n"]}
+{"version":3,"file":"prompt.entry.js","sourceRoot":"","sources":["../../../../src/common/entries/prompt.entry.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,6CAAwD;AAexD,MAAsB,WAAY,SAAQ,sBAAwD;IAChG,KAAK,CAAgB;IAErB;;OAEG;IACH,IAAI,CAAS;IAEb;;OAEG;IACH,QAAQ,CAAS;CA0BlB;AArCD,kCAqCC","sourcesContent":["// file: libs/sdk/src/common/entries/prompt.entry.ts\n\nimport { BaseEntry, EntryOwnerRef } from './base.entry';\nimport { PromptRecord } from '../records';\nimport { PromptContext, PromptInterface } from '../interfaces';\nimport { PromptMetadata } from '../metadata';\nimport { GetPromptResult, Request, Notification } from '@modelcontextprotocol/sdk/types.js';\nimport { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\n\nexport type PromptGetExtra = RequestHandlerExtra<Request, Notification> & {\n  authInfo: AuthInfo;\n};\n\nexport type ParsedPromptResult = GetPromptResult;\nexport type PromptSafeTransformResult<T> = { success: true; data: T } | { success: false; error: Error };\n\nexport abstract class PromptEntry extends BaseEntry<PromptRecord, PromptInterface, PromptMetadata> {\n  owner: EntryOwnerRef;\n\n  /**\n   * The name of the prompt, as declared in the metadata.\n   */\n  name: string;\n\n  /**\n   * The full name of the prompt, including the owner name as prefix.\n   */\n  fullName: string;\n\n  /**\n   * Create a prompt context (class or function wrapper).\n   * @param args Arguments passed to the prompt\n   * @param ctx Request context with auth info\n   */\n  abstract create(args: Record<string, string>, ctx: PromptGetExtra): PromptContext;\n\n  /**\n   * Parse and validate arguments against the prompt's argument definitions.\n   * @param args Arguments from the MCP request\n   * @returns Validated arguments\n   */\n  abstract parseArguments(args?: Record<string, string>): Record<string, string>;\n\n  /**\n   * Convert the raw prompt return value into an MCP GetPromptResult.\n   * Accepts any raw output from the prompt execute method and normalizes it.\n   */\n  abstract parseOutput(raw: unknown): ParsedPromptResult;\n\n  /**\n   * Safe version of parseOutput that returns success/error instead of throwing.\n   */\n  abstract safeParseOutput(raw: unknown): PromptSafeTransformResult<ParsedPromptResult>;\n}\n"]}

package/src/common/entries/resource.entry.d.ts

@@ -1,7 +1,70 @@
-import { z } from 'zod';
-import { BaseEntry } from './base.entry';
-import { ResourceRecord } from '../records';
-import { ResourceInterface } from '../interfaces';
-import { ResourceMetadata } from '../metadata';
-export declare abstract class ResourceEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ResourceRecord, ResourceInterface<In, Out>, ResourceMetadata> {
+import { BaseEntry, EntryOwnerRef } from './base.entry';
+import { AnyResourceRecord } from '../records';
+import { ResourceContext, ResourceInterface } from '../interfaces';
+import { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';
+import { ReadResourceResult, Request, Notification } from '@modelcontextprotocol/sdk/types.js';
+import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';
+export type ResourceReadExtra = RequestHandlerExtra<Request, Notification> & {
+    authInfo: AuthInfo;
+};
+export type ParsedResourceResult = ReadResourceResult;
+export type ResourceSafeTransformResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: Error;
+};
+/**
+ * Base class for resource entries.
+ * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)
+ * @template Out - Type for the resource output
+ */
+export declare abstract class ResourceEntry<Params extends Record<string, string> = Record<string, string>, Out = unknown> extends BaseEntry<AnyResourceRecord, ResourceInterface<Params, Out>, ResourceMetadata | ResourceTemplateMetadata> {
+    owner: EntryOwnerRef;
+    /**
+     * The name of the resource, as declared in the metadata.
+     */
+    name: string;
+    /**
+     * The full name of the resource, including the owner name as prefix.
+     */
+    fullName: string;
+    /**
+     * URI for static resources (from ResourceMetadata)
+     */
+    uri?: string;
+    /**
+     * URI template for template resources (from ResourceTemplateMetadata)
+     */
+    uriTemplate?: string;
+    /**
+     * Whether this resource is a template (has uriTemplate instead of uri)
+     */
+    isTemplate: boolean;
+    /**
+     * Create a resource context (class or function wrapper).
+     * @param uri The actual URI being read (for templates, this includes resolved params)
+     * @param params Extracted URI template parameters (empty for static resources)
+     * @param ctx Request context with auth info
+     */
+    abstract create(uri: string, params: Params, ctx: ResourceReadExtra): ResourceContext<Params, Out>;
+    /**
+     * Convert the raw resource return value (Out) into an MCP ReadResourceResult.
+     */
+    abstract parseOutput(result: Out): ParsedResourceResult;
+    /**
+     * Safe version of parseOutput that returns success/error instead of throwing.
+     */
+    abstract safeParseOutput(raw: Out): ResourceSafeTransformResult<ParsedResourceResult>;
+    /**
+     * Match a URI against this resource.
+     * For static resources: exact match against uri
+     * For templates: pattern match and extract parameters
+     */
+    abstract matchUri(uri: string): {
+        matches: boolean;
+        params: Params;
+    };
 }

package/src/common/entries/resource.entry.js

@@ -1,11 +1,35 @@
 "use strict";
+// file: libs/sdk/src/common/entries/resource.entry.ts
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ResourceEntry = void 0;
 const base_entry_1 = require("./base.entry");
+/**
+ * Base class for resource entries.
+ * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)
+ * @template Out - Type for the resource output
+ */
 class ResourceEntry extends base_entry_1.BaseEntry {
+    owner;
+    /**
+     * The name of the resource, as declared in the metadata.
+     */
+    name;
+    /**
+     * The full name of the resource, including the owner name as prefix.
+     */
+    fullName;
+    /**
+     * URI for static resources (from ResourceMetadata)
+     */
+    uri;
+    /**
+     * URI template for template resources (from ResourceTemplateMetadata)
+     */
+    uriTemplate;
+    /**
+     * Whether this resource is a template (has uriTemplate instead of uri)
+     */
+    isTemplate;
 }
 exports.ResourceEntry = ResourceEntry;
-// TODO: support resource templates
-// abstract class ResourceTemplateEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ResourceTemplateRecord, ResourceTemplateInterface<In, Out>, ResourceTemplateType> {
-// }
 //# sourceMappingURL=resource.entry.js.map

package/src/common/entries/resource.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource.entry.js","sourceRoot":"","sources":["../../../../src/common/entries/resource.entry.ts"],"names":[],"mappings":";;;AACA,6CAAyC;AAMzC,MAAsB,aAAuD,SAAQ,sBACtB;CAG9D;AAJD,sCAIC;AAGD,mCAAmC;AACnC,sLAAsL;AACtL,IAAI","sourcesContent":["import { z } from 'zod';\nimport { BaseEntry } from './base.entry';\nimport { ResourceRecord } from '../records';\nimport { ResourceInterface } from '../interfaces';\nimport { ResourceMetadata } from '../metadata';\n\n\nexport abstract class ResourceEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<\n  ResourceRecord, ResourceInterface<In, Out>, ResourceMetadata> {\n\n\n}\n\n\n// TODO: support resource templates\n// abstract class ResourceTemplateEntry<In = z.ZodRawShape, Out = z.ZodRawShape> extends BaseEntry<ResourceTemplateRecord, ResourceTemplateInterface<In, Out>, ResourceTemplateType> {\n// }"]}
+{"version":3,"file":"resource.entry.js","sourceRoot":"","sources":["../../../../src/common/entries/resource.entry.ts"],"names":[],"mappings":";AAAA,sDAAsD;;;AAEtD,6CAAwD;AAexD;;;;GAIG;AACH,MAAsB,aAGpB,SAAQ,sBAAyG;IACjH,KAAK,CAAgB;IAErB;;OAEG;IACH,IAAI,CAAS;IAEb;;OAEG;IACH,QAAQ,CAAS;IAEjB;;OAEG;IACH,GAAG,CAAU;IAEb;;OAEG;IACH,WAAW,CAAU;IAErB;;OAEG;IACH,UAAU,CAAU;CA0BrB;AAvDD,sCAuDC","sourcesContent":["// file: libs/sdk/src/common/entries/resource.entry.ts\n\nimport { BaseEntry, EntryOwnerRef } from './base.entry';\nimport { AnyResourceRecord } from '../records';\nimport { ResourceContext, ResourceInterface } from '../interfaces';\nimport { ResourceMetadata, ResourceTemplateMetadata } from '../metadata';\nimport { ReadResourceResult, Request, Notification } from '@modelcontextprotocol/sdk/types.js';\nimport { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';\nimport { AuthInfo } from '@modelcontextprotocol/sdk/server/auth/types.js';\n\nexport type ResourceReadExtra = RequestHandlerExtra<Request, Notification> & {\n  authInfo: AuthInfo;\n};\n\nexport type ParsedResourceResult = ReadResourceResult;\nexport type ResourceSafeTransformResult<T> = { success: true; data: T } | { success: false; error: Error };\n\n/**\n * Base class for resource entries.\n * @template Params - Type for URI template parameters (e.g., `{ userId: string }`)\n * @template Out - Type for the resource output\n */\nexport abstract class ResourceEntry<\n  Params extends Record<string, string> = Record<string, string>,\n  Out = unknown,\n> extends BaseEntry<AnyResourceRecord, ResourceInterface<Params, Out>, ResourceMetadata | ResourceTemplateMetadata> {\n  owner: EntryOwnerRef;\n\n  /**\n   * The name of the resource, as declared in the metadata.\n   */\n  name: string;\n\n  /**\n   * The full name of the resource, including the owner name as prefix.\n   */\n  fullName: string;\n\n  /**\n   * URI for static resources (from ResourceMetadata)\n   */\n  uri?: string;\n\n  /**\n   * URI template for template resources (from ResourceTemplateMetadata)\n   */\n  uriTemplate?: string;\n\n  /**\n   * Whether this resource is a template (has uriTemplate instead of uri)\n   */\n  isTemplate: boolean;\n\n  /**\n   * Create a resource context (class or function wrapper).\n   * @param uri The actual URI being read (for templates, this includes resolved params)\n   * @param params Extracted URI template parameters (empty for static resources)\n   * @param ctx Request context with auth info\n   */\n  abstract create(uri: string, params: Params, ctx: ResourceReadExtra): ResourceContext<Params, Out>;\n\n  /**\n   * Convert the raw resource return value (Out) into an MCP ReadResourceResult.\n   */\n  abstract parseOutput(result: Out): ParsedResourceResult;\n\n  /**\n   * Safe version of parseOutput that returns success/error instead of throwing.\n   */\n  abstract safeParseOutput(raw: Out): ResourceSafeTransformResult<ParsedResourceResult>;\n\n  /**\n   * Match a URI against this resource.\n   * For static resources: exact match against uri\n   * For templates: pattern match and extract parameters\n   */\n  abstract matchUri(uri: string): { matches: boolean; params: Params };\n}\n"]}

package/src/common/entries/scope.entry.d.ts

@@ -1,7 +1,8 @@
 import { BaseEntry } from './base.entry';
 import { ScopeRecord } from '../records';
-import { ScopeInterface, ProviderRegistryInterface, AppRegistryInterface, AuthRegistryInterface, FrontMcpAuth, Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface, HookRegistryInterface } from '../interfaces';
+import { ScopeInterface, ProviderRegistryInterface, AppRegistryInterface, AuthRegistryInterface, FrontMcpAuth, Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface, HookRegistryInterface, ResourceRegistryInterface, PromptRegistryInterface } from '../interfaces';
 import { FlowName, ScopeMetadata } from '../metadata';
+import type { NotificationService } from '../../notification';
 export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {
     abstract readonly id: string;
     abstract readonly entryPath: string;
@@ -14,6 +15,9 @@ export declare abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInt
     abstract get providers(): ProviderRegistryInterface;
     abstract get apps(): AppRegistryInterface;
     abstract get tools(): ToolRegistryInterface;
+    abstract get resources(): ResourceRegistryInterface;
+    abstract get prompts(): PromptRegistryInterface;
+    abstract get notifications(): NotificationService;
     abstract registryFlows(...flows: FlowType[]): Promise<void>;
     abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;
 }

package/src/common/entries/scope.entry.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScopeEntry = void 0;
 const base_entry_1 = require("./base.entry");
-const path_utils_1 = require("../../auth/path.utils");
+const utils_1 = require("../utils");
 class ScopeEntry extends base_entry_1.BaseEntry {
     get fullPath() {
-        const prefix = (0, path_utils_1.normalizeEntryPrefix)(this.entryPath ?? '');
-        const scope = (0, path_utils_1.normalizeScopeBase)(this.routeBase ?? '');
+        const prefix = (0, utils_1.normalizeEntryPrefix)(this.entryPath ?? '');
+        const scope = (0, utils_1.normalizeScopeBase)(this.routeBase ?? '');
         return `${prefix}${scope}`;
     }
 }

package/src/common/entries/scope.entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"scope.entry.js","sourceRoot":"","sources":["../../../../src/common/entries/scope.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAuC;AAWvC,sDAA+E;AAE/E,MAAsB,UAAW,SAAQ,sBAAqD;IAM5F,IAAI,QAAQ;QACV,MAAM,MAAM,GAAG,IAAA,iCAAoB,EAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAA,+BAAkB,EAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;IAC7B,CAAC;CAiBF;AA3BD,gCA2BC","sourcesContent":["import {BaseEntry} from './base.entry';\nimport {ScopeRecord} from '../records';\nimport {\n  ScopeInterface,\n  ProviderRegistryInterface,\n  AppRegistryInterface,\n  AuthRegistryInterface,\n  FrontMcpAuth,\n  Token, FlowInputOf, FlowOutputOf, Type, FlowType, FrontMcpLogger, ToolRegistryInterface, HookRegistryInterface,\n} from '../interfaces';\nimport {FlowName, ScopeMetadata} from '../metadata';\nimport {normalizeEntryPrefix, normalizeScopeBase} from \"../../auth/path.utils\";\n\nexport abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {\n  abstract readonly id: string;\n  abstract readonly entryPath: string;\n  abstract readonly routeBase: string;\n  abstract readonly logger: FrontMcpLogger;\n\n  get fullPath(): string {\n    const prefix = normalizeEntryPrefix(this.entryPath ?? '');\n    const scope = normalizeScopeBase(this.routeBase ?? '');\n    return `${prefix}${scope}`;\n  }\n\n  abstract get auth(): FrontMcpAuth;\n\n  abstract get hooks(): HookRegistryInterface;\n\n  abstract get authProviders(): AuthRegistryInterface;\n\n  abstract get providers(): ProviderRegistryInterface;\n\n  abstract get apps(): AppRegistryInterface;\n\n  abstract get tools(): ToolRegistryInterface;\n\n  abstract registryFlows(...flows: FlowType[]): Promise<void>;\n\n  abstract runFlow<Name extends FlowName>(name: Name, input: FlowInputOf<Name>, additionalDeps?: Map<Token, Type>): Promise<FlowOutputOf<Name> | undefined>;\n}\n"]}
+{"version":3,"file":"scope.entry.js","sourceRoot":"","sources":["../../../../src/common/entries/scope.entry.ts"],"names":[],"mappings":";;;AAAA,6CAAyC;AAoBzC,oCAAoE;AAGpE,MAAsB,UAAW,SAAQ,sBAAqD;IAM5F,IAAI,QAAQ;QACV,MAAM,MAAM,GAAG,IAAA,4BAAoB,EAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAA,0BAAkB,EAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,GAAG,MAAM,GAAG,KAAK,EAAE,CAAC;IAC7B,CAAC;CA2BF;AArCD,gCAqCC","sourcesContent":["import { BaseEntry } from './base.entry';\nimport { ScopeRecord } from '../records';\nimport {\n  ScopeInterface,\n  ProviderRegistryInterface,\n  AppRegistryInterface,\n  AuthRegistryInterface,\n  FrontMcpAuth,\n  Token,\n  FlowInputOf,\n  FlowOutputOf,\n  Type,\n  FlowType,\n  FrontMcpLogger,\n  ToolRegistryInterface,\n  HookRegistryInterface,\n  ResourceRegistryInterface,\n  PromptRegistryInterface,\n} from '../interfaces';\nimport { FlowName, ScopeMetadata } from '../metadata';\nimport { normalizeEntryPrefix, normalizeScopeBase } from '../utils';\nimport type { NotificationService } from '../../notification';\n\nexport abstract class ScopeEntry extends BaseEntry<ScopeRecord, ScopeInterface, ScopeMetadata> {\n  abstract readonly id: string;\n  abstract readonly entryPath: string;\n  abstract readonly routeBase: string;\n  abstract readonly logger: FrontMcpLogger;\n\n  get fullPath(): string {\n    const prefix = normalizeEntryPrefix(this.entryPath ?? '');\n    const scope = normalizeScopeBase(this.routeBase ?? '');\n    return `${prefix}${scope}`;\n  }\n\n  abstract get auth(): FrontMcpAuth;\n\n  abstract get hooks(): HookRegistryInterface;\n\n  abstract get authProviders(): AuthRegistryInterface;\n\n  abstract get providers(): ProviderRegistryInterface;\n\n  abstract get apps(): AppRegistryInterface;\n\n  abstract get tools(): ToolRegistryInterface;\n\n  abstract get resources(): ResourceRegistryInterface;\n\n  abstract get prompts(): PromptRegistryInterface;\n\n  abstract get notifications(): NotificationService;\n\n  abstract registryFlows(...flows: FlowType[]): Promise<void>;\n\n  abstract runFlow<Name extends FlowName>(\n    name: Name,\n    input: FlowInputOf<Name>,\n    additionalDeps?: Map<Token, Type>,\n  ): Promise<FlowOutputOf<Name> | undefined>;\n}\n"]}

package/src/common/flow/flow.utils.d.ts

@@ -0,0 +1,56 @@
+import { ZodType } from 'zod';
+/**
+ * Parse list request input and validate method.
+ * Common pattern used in tools/list, resources/list, etc.
+ *
+ * @param rawInput - Raw input from the flow
+ * @param schema - Zod schema for the input
+ * @param expectedMethod - Expected MCP method (e.g., 'tools/list', 'resources/list')
+ * @returns Parsed params including cursor
+ */
+export declare function parseListInput<T extends ZodType>(rawInput: unknown, schema: T, expectedMethod: string): {
+    cursor?: string;
+    params: Record<string, unknown>;
+};
+/**
+ * Entry with owner information for conflict resolution
+ */
+export interface OwnedEntry<T> {
+    ownerName: string;
+    entry: T;
+}
+/**
+ * Resolved entry with final name after conflict resolution
+ */
+export interface ResolvedEntry<T> extends OwnedEntry<T> {
+    finalName: string;
+}
+/**
+ * Resolve name conflicts by prefixing with owner name.
+ * Used for tools, resources, prompts, etc.
+ *
+ * @param entries - Array of entries with owner names
+ * @param getBaseName - Function to extract base name from entry
+ * @returns Resolved entries with final names
+ */
+export declare function resolveNameConflicts<T>(entries: OwnedEntry<T>[], getBaseName: (entry: T) => string): ResolvedEntry<T>[];
+/**
+ * Get a preview of items for logging (first N items).
+ *
+ * @param items - Array of items
+ * @param getName - Function to extract display name from item
+ * @param n - Number of items to preview (default: 5)
+ * @returns Formatted preview string
+ */
+export declare function previewItems<T>(items: T[], getName: (item: T) => string, n?: number): string;
+/**
+ * Get the count of conflicts from entries.
+ *
+ * @param entries - Array of entries
+ * @param getBaseName - Function to extract base name from entry
+ * @returns Object with conflict count and conflict names
+ */
+export declare function detectConflicts<T>(entries: T[], getBaseName: (entry: T) => string): {
+    count: number;
+    names: string[];
+};

package/src/common/flow/flow.utils.js

@@ -0,0 +1,96 @@
+"use strict";
+// file: libs/sdk/src/common/flow/flow.utils.ts
+// Shared utilities for list flows (tools/list, resources/list, etc.)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseListInput = parseListInput;
+exports.resolveNameConflicts = resolveNameConflicts;
+exports.previewItems = previewItems;
+exports.detectConflicts = detectConflicts;
+const zod_1 = require("zod");
+const errors_1 = require("../../errors");
+/**
+ * Parse list request input and validate method.
+ * Common pattern used in tools/list, resources/list, etc.
+ *
+ * @param rawInput - Raw input from the flow
+ * @param schema - Zod schema for the input
+ * @param expectedMethod - Expected MCP method (e.g., 'tools/list', 'resources/list')
+ * @returns Parsed params including cursor
+ */
+function parseListInput(rawInput, schema, expectedMethod) {
+    let method;
+    let params;
+    try {
+        const inputData = schema.parse(rawInput);
+        method = inputData.request.method;
+        params = inputData.request.params ?? {};
+    }
+    catch (e) {
+        throw new errors_1.InvalidInputError('Invalid request format', e instanceof zod_1.z.ZodError ? e.issues : undefined);
+    }
+    if (method !== expectedMethod) {
+        throw new errors_1.InvalidMethodError(method, expectedMethod);
+    }
+    return {
+        cursor: params?.['cursor'],
+        params,
+    };
+}
+/**
+ * Resolve name conflicts by prefixing with owner name.
+ * Used for tools, resources, prompts, etc.
+ *
+ * @param entries - Array of entries with owner names
+ * @param getBaseName - Function to extract base name from entry
+ * @returns Resolved entries with final names
+ */
+function resolveNameConflicts(entries, getBaseName) {
+    // Count occurrences of each base name
+    const counts = new Map();
+    for (const { entry } of entries) {
+        const baseName = getBaseName(entry);
+        counts.set(baseName, (counts.get(baseName) ?? 0) + 1);
+    }
+    // Find which names have conflicts (appear more than once)
+    const conflicts = new Set([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));
+    // Resolve by prefixing conflicting names with owner
+    return entries.map(({ ownerName, entry }) => {
+        const baseName = getBaseName(entry);
+        const finalName = conflicts.has(baseName) ? `${ownerName}:${baseName}` : baseName;
+        return { ownerName, entry, finalName };
+    });
+}
+/**
+ * Get a preview of items for logging (first N items).
+ *
+ * @param items - Array of items
+ * @param getName - Function to extract display name from item
+ * @param n - Number of items to preview (default: 5)
+ * @returns Formatted preview string
+ */
+function previewItems(items, getName, n = 5) {
+    const names = items.slice(0, n).map(getName);
+    const preview = names.join(', ');
+    const extra = items.length > n ? `, +${items.length - n} more` : '';
+    return `${preview}${extra}`;
+}
+/**
+ * Get the count of conflicts from entries.
+ *
+ * @param entries - Array of entries
+ * @param getBaseName - Function to extract base name from entry
+ * @returns Object with conflict count and conflict names
+ */
+function detectConflicts(entries, getBaseName) {
+    const counts = new Map();
+    for (const entry of entries) {
+        const baseName = getBaseName(entry);
+        counts.set(baseName, (counts.get(baseName) ?? 0) + 1);
+    }
+    const conflictNames = [...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k);
+    return {
+        count: conflictNames.length,
+        names: conflictNames,
+    };
+}
+//# sourceMappingURL=flow.utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"flow.utils.js","sourceRoot":"","sources":["../../../../src/common/flow/flow.utils.ts"],"names":[],"mappings":"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","sourcesContent":["// file: libs/sdk/src/common/flow/flow.utils.ts\n// Shared utilities for list flows (tools/list, resources/list, etc.)\n\nimport { z, ZodType } from 'zod';\nimport { InvalidInputError, InvalidMethodError } from '../../errors';\n\n/**\n * Parse list request input and validate method.\n * Common pattern used in tools/list, resources/list, etc.\n *\n * @param rawInput - Raw input from the flow\n * @param schema - Zod schema for the input\n * @param expectedMethod - Expected MCP method (e.g., 'tools/list', 'resources/list')\n * @returns Parsed params including cursor\n */\nexport function parseListInput<T extends ZodType>(\n  rawInput: unknown,\n  schema: T,\n  expectedMethod: string,\n): { cursor?: string; params: Record<string, unknown> } {\n  let method: string;\n  let params: Record<string, unknown>;\n\n  try {\n    const inputData = schema.parse(rawInput) as { request: { method: string; params: Record<string, unknown> } };\n    method = inputData.request.method;\n    params = inputData.request.params ?? {};\n  } catch (e) {\n    throw new InvalidInputError('Invalid request format', e instanceof z.ZodError ? e.issues : undefined);\n  }\n\n  if (method !== expectedMethod) {\n    throw new InvalidMethodError(method, expectedMethod);\n  }\n\n  return {\n    cursor: params?.['cursor'] as string | undefined,\n    params,\n  };\n}\n\n/**\n * Entry with owner information for conflict resolution\n */\nexport interface OwnedEntry<T> {\n  ownerName: string;\n  entry: T;\n}\n\n/**\n * Resolved entry with final name after conflict resolution\n */\nexport interface ResolvedEntry<T> extends OwnedEntry<T> {\n  finalName: string;\n}\n\n/**\n * Resolve name conflicts by prefixing with owner name.\n * Used for tools, resources, prompts, etc.\n *\n * @param entries - Array of entries with owner names\n * @param getBaseName - Function to extract base name from entry\n * @returns Resolved entries with final names\n */\nexport function resolveNameConflicts<T>(\n  entries: OwnedEntry<T>[],\n  getBaseName: (entry: T) => string,\n): ResolvedEntry<T>[] {\n  // Count occurrences of each base name\n  const counts = new Map<string, number>();\n  for (const { entry } of entries) {\n    const baseName = getBaseName(entry);\n    counts.set(baseName, (counts.get(baseName) ?? 0) + 1);\n  }\n\n  // Find which names have conflicts (appear more than once)\n  const conflicts = new Set<string>([...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k));\n\n  // Resolve by prefixing conflicting names with owner\n  return entries.map(({ ownerName, entry }) => {\n    const baseName = getBaseName(entry);\n    const finalName = conflicts.has(baseName) ? `${ownerName}:${baseName}` : baseName;\n    return { ownerName, entry, finalName };\n  });\n}\n\n/**\n * Get a preview of items for logging (first N items).\n *\n * @param items - Array of items\n * @param getName - Function to extract display name from item\n * @param n - Number of items to preview (default: 5)\n * @returns Formatted preview string\n */\nexport function previewItems<T>(items: T[], getName: (item: T) => string, n = 5): string {\n  const names = items.slice(0, n).map(getName);\n  const preview = names.join(', ');\n  const extra = items.length > n ? `, +${items.length - n} more` : '';\n  return `${preview}${extra}`;\n}\n\n/**\n * Get the count of conflicts from entries.\n *\n * @param entries - Array of entries\n * @param getBaseName - Function to extract base name from entry\n * @returns Object with conflict count and conflict names\n */\nexport function detectConflicts<T>(\n  entries: T[],\n  getBaseName: (entry: T) => string,\n): { count: number; names: string[] } {\n  const counts = new Map<string, number>();\n  for (const entry of entries) {\n    const baseName = getBaseName(entry);\n    counts.set(baseName, (counts.get(baseName) ?? 0) + 1);\n  }\n\n  const conflictNames = [...counts.entries()].filter(([, n]) => n > 1).map(([k]) => k);\n\n  return {\n    count: conflictNames.length,\n    names: conflictNames,\n  };\n}\n"]}

package/src/common/index.d.ts

@@ -9,9 +9,9 @@ export * from './records';
 export * from './entries';
 export * from './utils';
 export * from './schemas';
-export * from './decorators-old/async-with.decorator';
-export * from './decorators-old/session-hook.decorator';
+export * from './flow/flow.utils';
 export * from './interfaces/tool-hook.interface';
 export * from './interfaces/session-hook.interface';
 export * from './interfaces/auth-hook.interface';
 export * from './providers/session.provider';
+export * from './providers/base-config.provider';

package/src/common/index.js

@@ -12,10 +12,10 @@ tslib_1.__exportStar(require("./records"), exports);
 tslib_1.__exportStar(require("./entries"), exports);
 tslib_1.__exportStar(require("./utils"), exports);
 tslib_1.__exportStar(require("./schemas"), exports);
-tslib_1.__exportStar(require("./decorators-old/async-with.decorator"), exports);
-tslib_1.__exportStar(require("./decorators-old/session-hook.decorator"), exports);
+tslib_1.__exportStar(require("./flow/flow.utils"), exports);
 tslib_1.__exportStar(require("./interfaces/tool-hook.interface"), exports);
 tslib_1.__exportStar(require("./interfaces/session-hook.interface"), exports);
 tslib_1.__exportStar(require("./interfaces/auth-hook.interface"), exports);
 tslib_1.__exportStar(require("./providers/session.provider"), exports);
+tslib_1.__exportStar(require("./providers/base-config.provider"), exports);
 //# sourceMappingURL=index.js.map

package/src/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,uDAA6B;AAC7B,mDAAyB;AACzB,oDAA0B;AAC1B,oDAA0B;AAC1B,oDAA0B;AAC1B,kDAAwB;AACxB,oDAA0B;AAE1B,gFAAsD;AACtD,kFAAwD;AAExD,2EAAiD;AACjD,8EAAoD;AACpD,2EAAiD;AAGjD,uEAA6C","sourcesContent":["export * from './constants';\nexport * from './decorators';\nexport * from './types';\nexport * from './metadata';\nexport * from './interfaces';\nexport * from './tokens';\nexport * from './dynamic';\nexport * from './records';\nexport * from './entries';\nexport * from './utils';\nexport * from './schemas';\n\nexport * from './decorators-old/async-with.decorator';\nexport * from './decorators-old/session-hook.decorator';\n\nexport * from './interfaces/tool-hook.interface';\nexport * from './interfaces/session-hook.interface';\nexport * from './interfaces/auth-hook.interface';\n\n\nexport * from './providers/session.provider';\n\n\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/index.ts"],"names":[],"mappings":";;;AAAA,sDAA4B;AAC5B,uDAA6B;AAC7B,kDAAwB;AACxB,qDAA2B;AAC3B,uDAA6B;AAC7B,mDAAyB;AACzB,oDAA0B;AAC1B,oDAA0B;AAC1B,oDAA0B;AAC1B,kDAAwB;AACxB,oDAA0B;AAC1B,4DAAkC;AAElC,2EAAiD;AACjD,8EAAoD;AACpD,2EAAiD;AAEjD,uEAA6C;AAC7C,2EAAiD","sourcesContent":["export * from './constants';\nexport * from './decorators';\nexport * from './types';\nexport * from './metadata';\nexport * from './interfaces';\nexport * from './tokens';\nexport * from './dynamic';\nexport * from './records';\nexport * from './entries';\nexport * from './utils';\nexport * from './schemas';\nexport * from './flow/flow.utils';\n\nexport * from './interfaces/tool-hook.interface';\nexport * from './interfaces/session-hook.interface';\nexport * from './interfaces/auth-hook.interface';\n\nexport * from './providers/session.provider';\nexport * from './providers/base-config.provider';\n"]}