@frontmcp/sdk 0.1.0

package/README.md

@@ -0,0 +1,11 @@
+# sdk
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build common` to build the library.
+
+## Running unit tests
+
+Run `nx test common` to execute the unit tests via [Jest](https://jestjs.io).

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@frontmcp/sdk",
+  "version": "0.1.0",
+  "type": "commonjs",
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    }
+  },
+  "dependencies": {
+    "typescript": "^5.9.3",
+    "@modelcontextprotocol/sdk": "^1.19.1",
+    "axios": "^1.6.0",
+    "ioredis": "^5.8.0",
+    "jose": "^6.1.0",
+    "openapi-mcp-generator": "^3.2.0",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.0",
+    "zod-from-json-schema": "^0.5.1",
+    "zod-to-json-schema": "^3.24.6",
+    "tslib": "^2.3.0"
+  }
+}

package/src/constants.d.ts

@@ -0,0 +1,30 @@
+export declare const MCP_BASE_METADATA: {
+    NAME: string;
+    DESCRIPTION: string;
+};
+export declare const MCP_APP_METADATA: {
+    PROVIDERS: string;
+    ADAPTERS: string;
+    PLUGINS: string;
+    TOOLS: string;
+    NAME: string;
+    DESCRIPTION: string;
+};
+export declare const MCP_PROVIDER_METADATA: {
+    SCOPE: string;
+    NAME: string;
+    DESCRIPTION: string;
+};
+export declare const MCP_TOOL_METADATA: {
+    ID: string;
+    NAME: string;
+    DESCRIPTION: string;
+    INPUT_SCHEMA: string;
+    OUTPUT_SCHEMA: string;
+};
+export declare const MCP_TOOL_HOOKS = "mcp.plugin.toolHooks";
+export declare const MCP_SESSION_HOOKS = "mcp.plugin.sessionHooks";
+export declare const MCP_AUTH_HOOKS = "mcp.plugin.sessionHooks";
+export declare const DESIGN_PARAMTYPES = "design:paramtypes";
+export declare const META_PROVIDERS: string;
+export declare const META_ADAPTERS: string;

package/src/constants.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.META_ADAPTERS = exports.META_PROVIDERS = exports.DESIGN_PARAMTYPES = exports.MCP_AUTH_HOOKS = exports.MCP_SESSION_HOOKS = exports.MCP_TOOL_HOOKS = exports.MCP_TOOL_METADATA = exports.MCP_PROVIDER_METADATA = exports.MCP_APP_METADATA = exports.MCP_BASE_METADATA = void 0;
+exports.MCP_BASE_METADATA = {
+    NAME: 'name',
+    DESCRIPTION: 'description',
+};
+exports.MCP_APP_METADATA = {
+    ...exports.MCP_BASE_METADATA,
+    PROVIDERS: 'providers',
+    ADAPTERS: 'adapters',
+    PLUGINS: 'plugins',
+    TOOLS: 'tools',
+};
+exports.MCP_PROVIDER_METADATA = {
+    ...exports.MCP_BASE_METADATA,
+    SCOPE: 'scope',
+};
+exports.MCP_TOOL_METADATA = {
+    ID: 'id',
+    NAME: 'name',
+    DESCRIPTION: 'description',
+    INPUT_SCHEMA: 'inputSchema',
+    OUTPUT_SCHEMA: 'outputSchema',
+};
+// Plugin/global Tool hooks (method-level) metadata key
+// Stored on plugin classes by @ToolHook decorator
+exports.MCP_TOOL_HOOKS = 'mcp.plugin.toolHooks';
+exports.MCP_SESSION_HOOKS = 'mcp.plugin.sessionHooks';
+exports.MCP_AUTH_HOOKS = 'mcp.plugin.sessionHooks';
+// Common metadata keys used across the project
+exports.DESIGN_PARAMTYPES = 'design:paramtypes';
+// Alias for app metadata providers key to standardize usage in core/common
+exports.META_PROVIDERS = exports.MCP_APP_METADATA.PROVIDERS;
+exports.META_ADAPTERS = exports.MCP_APP_METADATA.ADAPTERS;
+//# sourceMappingURL=constants.js.map

package/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG;IAC/B,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;CAC3B,CAAC;AAEW,QAAA,gBAAgB,GAAG;IAC9B,GAAG,yBAAiB;IACpB,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACf,CAAC;AAEW,QAAA,qBAAqB,GAAG;IACnC,GAAG,yBAAiB;IACpB,KAAK,EAAE,OAAO;CACf,CAAC;AAGW,QAAA,iBAAiB,GAAG;IAC/B,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,aAAa;IAC1B,YAAY,EAAE,aAAa;IAC3B,aAAa,EAAE,cAAc;CAC9B,CAAC;AAEF,uDAAuD;AACvD,kDAAkD;AACrC,QAAA,cAAc,GAAG,sBAAsB,CAAC;AACxC,QAAA,iBAAiB,GAAG,yBAAyB,CAAC;AAC9C,QAAA,cAAc,GAAG,yBAAyB,CAAC;AAGxD,+CAA+C;AAClC,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AACrD,2EAA2E;AAC9D,QAAA,cAAc,GAAG,wBAAgB,CAAC,SAAS,CAAC;AAC5C,QAAA,aAAa,GAAG,wBAAgB,CAAC,QAAQ,CAAC","sourcesContent":["export const MCP_BASE_METADATA = {\n  NAME: 'name',\n  DESCRIPTION: 'description',\n};\n\nexport const MCP_APP_METADATA = {\n  ...MCP_BASE_METADATA,\n  PROVIDERS: 'providers',\n  ADAPTERS: 'adapters',\n  PLUGINS: 'plugins',\n  TOOLS: 'tools',\n};\n\nexport const MCP_PROVIDER_METADATA = {\n  ...MCP_BASE_METADATA,\n  SCOPE: 'scope',\n};\n\n\nexport const MCP_TOOL_METADATA = {\n  ID: 'id',\n  NAME: 'name',\n  DESCRIPTION: 'description',\n  INPUT_SCHEMA: 'inputSchema',\n  OUTPUT_SCHEMA: 'outputSchema',\n};\n\n// Plugin/global Tool hooks (method-level) metadata key\n// Stored on plugin classes by @ToolHook decorator\nexport const MCP_TOOL_HOOKS = 'mcp.plugin.toolHooks';\nexport const MCP_SESSION_HOOKS = 'mcp.plugin.sessionHooks';\nexport const MCP_AUTH_HOOKS = 'mcp.plugin.sessionHooks';\n\n\n// Common metadata keys used across the project\nexport const DESIGN_PARAMTYPES = 'design:paramtypes';\n// Alias for app metadata providers key to standardize usage in core/common\nexport const META_PROVIDERS = MCP_APP_METADATA.PROVIDERS;\nexport const META_ADAPTERS = MCP_APP_METADATA.ADAPTERS;\n"]}

package/src/decorators/adapter.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+import { AdapterMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as a McpAdapter module and provides metadata
+ */
+declare function FrontMcpAdapter(providedMetadata: AdapterMetadata): ClassDecorator;
+export { FrontMcpAdapter, FrontMcpAdapter as Adapter, };

package/src/decorators/adapter.decorator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpAdapter = FrontMcpAdapter;
+exports.Adapter = FrontMcpAdapter;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpAdapter module and provides metadata
+ */
+function FrontMcpAdapter(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpAdapterMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpAdapterTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpAdapterTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=adapter.decorator.js.map

package/src/decorators/adapter.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.decorator.js","sourceRoot":"","sources":["../../../src/decorators/adapter.decorator.ts"],"names":[],"mappings":";;AAoBE,0CAAe;AACI,kCAAO;AArB5B,4BAA0B;AAC1B,sCAAkD;AAClD,0CAA6E;AAE7E;;GAEG;AACH,SAAS,eAAe,CAAC,gBAAiC;IACxD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,wCAA6B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEvE,OAAO,CAAC,cAAc,CAAC,8BAAqB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEjE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,8BAAqB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAClG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpAdapterTokens } from '../tokens';\nimport { AdapterMetadata, frontMcpAdapterMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpAdapter module and provides metadata\n */\nfunction FrontMcpAdapter(providedMetadata: AdapterMetadata): ClassDecorator {\n  return (target: Function) => {\n    const metadata = frontMcpAdapterMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpAdapterTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpAdapterTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpAdapter,\n  FrontMcpAdapter as Adapter,\n};"]}

package/src/decorators/app.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+import { LocalAppMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as a McpApp module and provides metadata
+ */
+declare function FrontMcpApp(providedMetadata: LocalAppMetadata): ClassDecorator;
+export { FrontMcpApp, FrontMcpApp as App, };

package/src/decorators/app.decorator.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpApp = FrontMcpApp;
+exports.App = FrontMcpApp;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpApp module and provides metadata
+ */
+function FrontMcpApp(providedMetadata) {
+    return (target) => {
+        const { error, data: metadata } = metadata_1.frontMcpLocalAppMetadataSchema.safeParse(providedMetadata);
+        if (error) {
+            if (error.format().plugins) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { plugins: [?] }: \n${JSON.stringify(error.format().plugins, null, 2)}`);
+            }
+            if (error.format().providers) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \n${JSON.stringify(error.format().providers, null, 2)}`);
+            }
+            if (error.format().authProviders) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { authProviders: [?] }: \n${JSON.stringify(error.format().authProviders, null, 2)}`);
+            }
+            if (error.format().adapters) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { adapters: [?] }: \n${JSON.stringify(error.format().adapters, null, 2)}`);
+            }
+            if (error.format().tools) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { tools: [?] }: \n${JSON.stringify(error.format().tools, null, 2)}`);
+            }
+            if (error.format().resources) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { resources: [?] }: \n${JSON.stringify(error.format().resources, null, 2)}`);
+            }
+            if (error.format().prompts) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { prompts: [?] }: \n${JSON.stringify(error.format().prompts, null, 2)}`);
+            }
+            throw error;
+        }
+        Reflect.defineMetadata(tokens_1.FrontMcpLocalAppTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpLocalAppTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=app.decorator.js.map

package/src/decorators/app.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.decorator.js","sourceRoot":"","sources":["../../../src/decorators/app.decorator.ts"],"names":[],"mappings":";;AA4CE,kCAAW;AACI,0BAAG;AA7CpB,4BAA0B;AAC1B,sCAAmD;AACnD,0CAA+E;AAE/E;;GAEG;AACH,SAAS,WAAW,CAAC,gBAAkC;IACrD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,yCAA8B,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC7F,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,8DAA8D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACnI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,CAAC;gBACjC,MAAM,IAAI,KAAK,CAAC,oEAAoE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/I,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,+DAA+D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACrI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,4DAA4D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/H,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,8DAA8D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACnI,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAClE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACnG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpLocalAppTokens } from '../tokens';\nimport { LocalAppMetadata, frontMcpLocalAppMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpApp module and provides metadata\n */\nfunction FrontMcpApp(providedMetadata: LocalAppMetadata): ClassDecorator {\n  return (target: Function) => {\n\n    const { error, data: metadata } = frontMcpLocalAppMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().plugins) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { plugins: [?] }: \\n${JSON.stringify(error.format().plugins, null, 2)}`);\n      }\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \\n${JSON.stringify(error.format().providers, null, 2)}`);\n      }\n      if (error.format().authProviders) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { authProviders: [?] }: \\n${JSON.stringify(error.format().authProviders, null, 2)}`);\n      }\n      if (error.format().adapters) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { adapters: [?] }: \\n${JSON.stringify(error.format().adapters, null, 2)}`);\n      }\n      if (error.format().tools) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { tools: [?] }: \\n${JSON.stringify(error.format().tools, null, 2)}`);\n      }\n      if (error.format().resources) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { resources: [?] }: \\n${JSON.stringify(error.format().resources, null, 2)}`);\n      }\n      if (error.format().prompts) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { prompts: [?] }: \\n${JSON.stringify(error.format().prompts, null, 2)}`);\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpLocalAppTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpLocalAppTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpApp,\n  FrontMcpApp as App,\n};"]}

package/src/decorators/auth-provider.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+import { AuthProviderMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as an AuthProvider module and provides metadata
+ */
+declare function FrontMcpAuthProvider(providedMetadata: AuthProviderMetadata): ClassDecorator;
+export { FrontMcpAuthProvider, FrontMcpAuthProvider as AuthProvider, };

package/src/decorators/auth-provider.decorator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpAuthProvider = FrontMcpAuthProvider;
+exports.AuthProvider = FrontMcpAuthProvider;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as an AuthProvider module and provides metadata
+ */
+function FrontMcpAuthProvider(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpAuthProviderMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpAuthProviderTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpAuthProviderTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=auth-provider.decorator.js.map

package/src/decorators/auth-provider.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-provider.decorator.js","sourceRoot":"","sources":["../../../src/decorators/auth-provider.decorator.ts"],"names":[],"mappings":";;AAoBE,oDAAoB;AACI,4CAAY;AArBtC,4BAA0B;AAC1B,sCAAuD;AACvD,0CAAuF;AAEvF;;GAEG;AACH,SAAS,oBAAoB,CAAC,gBAAsC;IAClE,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,6CAAkC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAE5E,OAAO,CAAC,cAAc,CAAC,mCAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEtE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,mCAA0B,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACvG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpAuthProviderTokens } from '../tokens';\nimport { AuthProviderMetadata, frontMcpAuthProviderMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as an AuthProvider module and provides metadata\n */\nfunction FrontMcpAuthProvider(providedMetadata: AuthProviderMetadata): ClassDecorator {\n  return (target: Function) => {\n    const metadata = frontMcpAuthProviderMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpAuthProviderTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpAuthProviderTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpAuthProvider,\n  FrontMcpAuthProvider as AuthProvider,\n};"]}

package/src/decorators/flow-hooks.decorator.d.ts

@@ -0,0 +1,12 @@
+import { FlowHookOptions, FlowName } from '../metadata';
+/** NEW: typed variants */
+export declare function StageHookOf<Name extends FlowName>(name: Name): (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function WillHookOf<Name extends FlowName>(name: Name): (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function DidHookOf<Name extends FlowName>(name: Name): (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function AroundHookOf<Name extends FlowName>(name: Name): (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+export declare function FlowHooksOf<Name extends FlowName>(name: Name): {
+    Stage: (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+    Will: (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+    Did: (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+    Around: (stage: ExtendFlows[Name]["stage"], opts?: FlowHookOptions<ExtendFlows[Name]["ctx"]>) => MethodDecorator;
+};

package/src/decorators/flow-hooks.decorator.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StageHookOf = StageHookOf;
+exports.WillHookOf = WillHookOf;
+exports.DidHookOf = DidHookOf;
+exports.AroundHookOf = AroundHookOf;
+exports.FlowHooksOf = FlowHooksOf;
+const tokens_1 = require("../tokens");
+function registerFlowHook(target, meta) {
+    const ctor = target.constructor;
+    const arr = Reflect.getMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, ctor) ?? [];
+    arr.push(meta);
+    Reflect.defineMetadata(tokens_1.FrontMcpFlowHookTokens.hooks, arr, ctor);
+}
+/** Base factory (kept internal) */
+function make(kind) {
+    return function (stage, opts = {}) {
+        return (target, key, _desc) => {
+            registerFlowHook(target, {
+                kind,
+                stage: String(stage),
+                method: String(key),
+                priority: opts.priority ?? 0,
+                filter: opts.filter,
+                static: Boolean(target.constructor[key]),
+            });
+        };
+    };
+}
+/** NEW: typed variants */
+function StageHookOf(name) {
+    const base = make('stage');
+    return function (stage, opts = {}) {
+        return base(stage, opts);
+    };
+}
+function WillHookOf(name) {
+    const base = make('will');
+    return function (stage, opts = {}) {
+        return base(stage, opts);
+    };
+}
+function DidHookOf(name) {
+    const base = make('did');
+    return function (stage, opts = {}) {
+        return base(stage, opts);
+    };
+}
+function AroundHookOf(name) {
+    const base = make('around');
+    return function (stage, opts = {}) {
+        return base(stage, opts);
+    };
+}
+function FlowHooksOf(name) {
+    return {
+        Stage: StageHookOf(name),
+        Will: WillHookOf(name),
+        Did: DidHookOf(name),
+        Around: AroundHookOf(name),
+    };
+}
+//# sourceMappingURL=flow-hooks.decorator.js.map

package/src/decorators/flow-hooks.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-hooks.decorator.js","sourceRoot":"","sources":["../../../src/decorators/flow-hooks.decorator.ts"],"names":[],"mappings":";;AA4BA,kCAOC;AAED,gCAOC;AAED,8BAOC;AAED,oCAOC;AAED,kCAOC;AAtED,sCAAmD;AAGnD,SAAS,gBAAgB,CAAC,MAAW,EAAE,IAAkB;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC;IAChC,MAAM,GAAG,GAAmB,OAAO,CAAC,WAAW,CAAC,+BAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1F,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,CAAC,cAAc,CAAC,+BAAsB,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,mCAAmC;AACnC,SAAS,IAAI,CAAC,IAAkB;IAC9B,OAAO,UAAoD,KAAQ,EAAE,OAA6B,EAAE;QAClG,OAAO,CAAC,MAAW,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;YACjC,gBAAgB,CAAC,MAAM,EAAE;gBACvB,IAAI;gBACJ,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;gBACpB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC;gBAC5B,MAAM,EAAE,IAAI,CAAC,MAAa;gBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;aACzC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,0BAA0B;AAC1B,SAAgB,WAAW,CAAwB,IAAU;IAG3D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,UAAS,KAAQ,EAAE,OAA6B,EAAE;QACvD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,UAAU,CAAwB,IAAU;IAG1D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,UAAS,KAAQ,EAAE,OAA6B,EAAE;QACvD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,SAAS,CAAwB,IAAU;IAGzD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,OAAO,UAAS,KAAQ,EAAE,OAA6B,EAAE;QACvD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,YAAY,CAAwB,IAAU;IAG5D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,OAAO,UAAS,KAAQ,EAAE,OAA6B,EAAE;QACvD,OAAO,IAAI,CAAS,KAAK,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAwB,IAAU;IAC3D,OAAO;QACL,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC;QACxB,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;QACtB,GAAG,EAAE,SAAS,CAAC,IAAI,CAAC;QACpB,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC;KAC3B,CAAC;AACJ,CAAC","sourcesContent":["import { FlowHookKind, FlowHookOptions, FlowHookMeta, FlowName } from '../metadata';\nimport { FrontMcpFlowHookTokens } from '../tokens';\n\n\nfunction registerFlowHook(target: any, meta: FlowHookMeta) {\n  const ctor = target.constructor;\n  const arr: FlowHookMeta[] = Reflect.getMetadata(FrontMcpFlowHookTokens.hooks, ctor) ?? [];\n  arr.push(meta);\n  Reflect.defineMetadata(FrontMcpFlowHookTokens.hooks, arr, ctor);\n}\n\n/** Base factory (kept internal) */\nfunction make(kind: FlowHookKind) {\n  return function <Ctx = unknown, T extends string = string>(stage: T, opts: FlowHookOptions<Ctx> = {}): MethodDecorator {\n    return (target: any, key, _desc) => {\n      registerFlowHook(target, {\n        kind,\n        stage: String(stage),\n        method: String(key),\n        priority: opts.priority ?? 0,\n        filter: opts.filter as any,\n        static: Boolean(target.constructor[key]),\n      });\n    };\n  };\n}\n\n/** NEW: typed variants */\nexport function StageHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make('stage');\n  return function(stage: T, opts: FlowHookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function WillHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make('will');\n  return function(stage: T, opts: FlowHookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function DidHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make('did');\n  return function(stage: T, opts: FlowHookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function AroundHookOf<Name extends FlowName>(name: Name) {\n  type T = ExtendFlows[Name]['stage']\n  type Ctx = ExtendFlows[Name]['ctx']\n  const base = make('around');\n  return function(stage: T, opts: FlowHookOptions<Ctx> = {}) {\n    return base<Ctx, T>(stage, opts);\n  };\n}\n\nexport function FlowHooksOf<Name extends FlowName>(name: Name) {\n  return {\n    Stage: StageHookOf(name),\n    Will: WillHookOf(name),\n    Did: DidHookOf(name),\n    Around: AroundHookOf(name),\n  };\n}\n\n"]}

package/src/decorators/flow.decorator.d.ts

@@ -0,0 +1,6 @@
+import { FlowMetadata, FlowName } from '../metadata';
+/**
+ * Decorator that marks a class as a FrontMcpFlow module and provides metadata
+ */
+declare function FrontMcpFlow<Name extends FlowName>(providedMetadata: FlowMetadata<Name>): ClassDecorator;
+export { FrontMcpFlow, FrontMcpFlow as Flow, };

package/src/decorators/flow.decorator.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpFlow = FrontMcpFlow;
+exports.Flow = FrontMcpFlow;
+const metadata_1 = require("../metadata");
+const tokens_1 = require("../tokens");
+/**
+ * Decorator that marks a class as a FrontMcpFlow module and provides metadata
+ */
+function FrontMcpFlow(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpFlowMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpFlowTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpFlowTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=flow.decorator.js.map

package/src/decorators/flow.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow.decorator.js","sourceRoot":"","sources":["../../../src/decorators/flow.decorator.ts"],"names":[],"mappings":";;AAsBE,oCAAY;AACI,4BAAI;AAvBtB,0CAAiF;AACjF,sCAA+C;AAI/C;;GAEG;AACH,SAAS,YAAY,CAAwB,gBAAoC;IAE/E,OAAO,CAAC,MAAW,EAAE,EAAE;QACrB,MAAM,QAAQ,GAAG,qCAA0B,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAEpE,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAE9D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,2BAAkB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { FlowMetadata, FlowName, frontMcpFlowMetadataSchema } from '../metadata';\nimport { FrontMcpFlowTokens } from '../tokens';\n\n\n\n/**\n * Decorator that marks a class as a FrontMcpFlow module and provides metadata\n */\nfunction FrontMcpFlow<Name extends FlowName>(providedMetadata: FlowMetadata<Name>): ClassDecorator {\n\n  return (target: any) => {\n    const metadata = frontMcpFlowMetadataSchema.parse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpFlowTokens.type, true, target);\n\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpFlowTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpFlow,\n  FrontMcpFlow as Flow,\n}"]}

package/src/decorators/front-mcp.decorator.d.ts

@@ -0,0 +1,6 @@
+import 'reflect-metadata';
+import { FrontMcpMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as a FrontMcp Server and provides metadata
+ */
+export declare function FrontMcp(providedMetadata: FrontMcpMetadata): ClassDecorator;

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcp = FrontMcp;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a FrontMcp Server and provides metadata
+ */
+function FrontMcp(providedMetadata) {
+    return (target) => {
+        const { error, data: metadata } = metadata_1.frontMcpMetadataSchema.safeParse(providedMetadata);
+        if (error) {
+            if (error.format().apps) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { apps: [?] }: \n${JSON.stringify(error.format().apps, null, 2)}`);
+            }
+            if (error.format().providers) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \n${JSON.stringify(error.format().providers, null, 2)}`);
+            }
+            if (error.format().logging?.transports) {
+                throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \n${JSON.stringify(error.format().logging?.transports, null, 2)}`);
+            }
+            throw error;
+        }
+        Reflect.defineMetadata(tokens_1.FrontMcpTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpTokens[property] ?? property, metadata[property], target);
+        }
+        if (metadata.serve) {
+            const core = '@frontmcp/core';
+            import(core).then(({ FrontMcpInstance }) => {
+                if (!FrontMcpInstance) {
+                    throw new Error(`${core} version mismatch, make sure you have the same version for all @frontmcp/* packages`);
+                }
+                FrontMcpInstance.bootstrap(metadata);
+            });
+        }
+    };
+}
+//# sourceMappingURL=front-mcp.decorator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"front-mcp.decorator.js","sourceRoot":"","sources":["../../../src/decorators/front-mcp.decorator.ts"],"names":[],"mappings":";;AAOA,4BAiCC;AAxCD,4BAA0B;AAC1B,sCAA2C;AAC3C,0CAAuE;AAEvE;;GAEG;AACH,SAAgB,QAAQ,CAAC,gBAAkC;IACzD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,iCAAsB,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACrF,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,2DAA2D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7H,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACvI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,8EAA8E,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/J,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1D,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,uBAAc,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,MAAM,IAAI,GAAG,gBAAgB,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE;gBACzC,IAAI,CAAC,gBAAgB,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,qFAAqF,CAAC,CAAC;gBAChH,CAAC;gBACD,gBAAgB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC;IAEH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpTokens } from '../tokens';\nimport { FrontMcpMetadata, frontMcpMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a FrontMcp Server and provides metadata\n */\nexport function FrontMcp(providedMetadata: FrontMcpMetadata): ClassDecorator {\n  return (target: Function) => {\n\n    const { error, data: metadata } = frontMcpMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().apps) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { apps: [?] }: \\n${JSON.stringify(error.format().apps, null, 2)}`);\n      }\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { providers: [?] }: \\n${JSON.stringify(error.format().providers, null, 2)}`);\n      }\n      if (error.format().logging?.transports) {\n        throw new Error(`Invalid metadata provided to @FrontMcp { logging: { transports: [?] } }: \\n${JSON.stringify(error.format().logging?.transports, null, 2)}`);\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpTokens[property] ?? property, metadata[property], target);\n    }\n\n    if (metadata.serve) {\n      const core = '@frontmcp/core';\n      import(core).then(({ FrontMcpInstance }) => {\n        if (!FrontMcpInstance) {\n          throw new Error(`${core} version mismatch, make sure you have the same version for all @frontmcp/* packages`);\n        }\n        FrontMcpInstance.bootstrap(metadata);\n      });\n    }\n\n  };\n}\n"]}

package/src/decorators/index.d.ts

@@ -0,0 +1,12 @@
+export * from './front-mcp.decorator';
+export * from './flow.decorator';
+export * from './flow-hooks.decorator';
+export * from './app.decorator';
+export * from './provider.decorator';
+export * from './auth-provider.decorator';
+export * from './adapter.decorator';
+export * from './plugin.decorator';
+export * from './tool.decorator';
+export * from './resource.decorator';
+export * from './prompt.decorator';
+export * from './logger.decorator';

package/src/decorators/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./front-mcp.decorator"), exports);
+tslib_1.__exportStar(require("./flow.decorator"), exports);
+tslib_1.__exportStar(require("./flow-hooks.decorator"), exports);
+tslib_1.__exportStar(require("./app.decorator"), exports);
+tslib_1.__exportStar(require("./provider.decorator"), exports);
+tslib_1.__exportStar(require("./auth-provider.decorator"), exports);
+tslib_1.__exportStar(require("./adapter.decorator"), exports);
+tslib_1.__exportStar(require("./plugin.decorator"), exports);
+tslib_1.__exportStar(require("./tool.decorator"), exports);
+tslib_1.__exportStar(require("./resource.decorator"), exports);
+tslib_1.__exportStar(require("./prompt.decorator"), exports);
+tslib_1.__exportStar(require("./logger.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/src/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,2DAAiC;AACjC,iEAAuC;AACvC,0DAAgC;AAChC,+DAAqC;AACrC,oEAA0C;AAC1C,8DAAoC;AACpC,6DAAmC;AACnC,2DAAiC;AACjC,+DAAqC;AACrC,6DAAmC;AACnC,6DAAmC","sourcesContent":["export * from './front-mcp.decorator';\nexport * from './flow.decorator';\nexport * from './flow-hooks.decorator';\nexport * from './app.decorator';\nexport * from './provider.decorator';\nexport * from './auth-provider.decorator';\nexport * from './adapter.decorator';\nexport * from './plugin.decorator';\nexport * from './tool.decorator';\nexport * from './resource.decorator';\nexport * from './prompt.decorator';\nexport * from './logger.decorator';\n"]}

package/src/decorators/logger.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+import { LogTransportMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as a FrontMcpLogger module and provides metadata
+ */
+declare function FrontMcpLogTransport(providedMetadata: LogTransportMetadata): ClassDecorator;
+export { FrontMcpLogTransport, FrontMcpLogTransport as LogTransport, };

package/src/decorators/logger.decorator.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpLogTransport = FrontMcpLogTransport;
+exports.LogTransport = FrontMcpLogTransport;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a FrontMcpLogger module and provides metadata
+ */
+function FrontMcpLogTransport(providedMetadata) {
+    return (target) => {
+        const { error, data: metadata } = metadata_1.frontMcpLogTransportMetadataSchema.safeParse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpLogTransportTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpLogTransportTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=logger.decorator.js.map

package/src/decorators/logger.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.decorator.js","sourceRoot":"","sources":["../../../src/decorators/logger.decorator.ts"],"names":[],"mappings":";;AAsBE,oDAAoB;AACI,4CAAY;AAvBtC,4BAA0B;AAC1B,sCAAuD;AACvD,0CAGqB;AAErB;;GAEG;AACH,SAAS,oBAAoB,CAAC,gBAAsC;IAClE,OAAO,CAAC,MAAgB,EAAE,EAAE;QAC1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,6CAAkC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAEjG,OAAO,CAAC,cAAc,CAAC,mCAA0B,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACtE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,mCAA0B,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACvG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpLogTransportTokens } from '../tokens';\nimport {\n  LogTransportMetadata,\n  frontMcpLogTransportMetadataSchema,\n} from '../metadata';\n\n/**\n * Decorator that marks a class as a FrontMcpLogger module and provides metadata\n */\nfunction FrontMcpLogTransport(providedMetadata: LogTransportMetadata): ClassDecorator {\n  return (target: Function) => {\n    const { error, data: metadata } = frontMcpLogTransportMetadataSchema.safeParse(providedMetadata);\n\n    Reflect.defineMetadata(FrontMcpLogTransportTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpLogTransportTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpLogTransport,\n  FrontMcpLogTransport as LogTransport,\n};"]}

package/src/decorators/plugin.decorator.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+import { PluginMetadata } from '../metadata';
+/**
+ * Decorator that marks a class as a McpPlugin and provides metadata
+ */
+declare function FrontMcpPlugin(providedMetadata: PluginMetadata): ClassDecorator;
+export { FrontMcpPlugin, FrontMcpPlugin as Plugin, };

package/src/decorators/plugin.decorator.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpPlugin = FrontMcpPlugin;
+exports.Plugin = FrontMcpPlugin;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpPlugin and provides metadata
+ */
+function FrontMcpPlugin(providedMetadata) {
+    return (target) => {
+        const { error, data: metadata } = metadata_1.frontMcpPluginMetadataSchema.safeParse(providedMetadata);
+        if (error) {
+            if (error.format().providers) {
+                throw new Error(`Invalid metadata provided to @FrontMcpProvider or @Provider: \n${JSON.stringify(error.formErrors.fieldErrors['providers'], null, 2)}`);
+            }
+            if (error.format().adapters) {
+                throw new Error(`Invalid metadata provided to @FrontMcpAdapter or @Adapter: \n${JSON.stringify(error.format().adapters, null, 2)}`);
+            }
+            if (error.format().tools) {
+                throw new Error(`Invalid metadata provided to @FrontMcpTool or @Tool: \n${JSON.stringify(error.format().tools, null, 2)}`);
+            }
+            if (error.format().resources) {
+                throw new Error(`Invalid metadata provided to @FrontMcpResource or @Resource: \n${JSON.stringify(error.format().resources, null, 2)}`);
+            }
+            if (error.format().prompts) {
+                throw new Error(`Invalid metadata provided to @FrontMcpPrompt or @Prompt: \n${JSON.stringify(error.format().prompts, null, 2)}`);
+            }
+            throw error;
+        }
+        Reflect.defineMetadata(tokens_1.FrontMcpPluginTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpPluginTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+//# sourceMappingURL=plugin.decorator.js.map

package/src/decorators/plugin.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.decorator.js","sourceRoot":"","sources":["../../../src/decorators/plugin.decorator.ts"],"names":[],"mappings":";;AAsCE,wCAAc;AACI,gCAAM;AAvC1B,4BAA0B;AAC1B,sCAAiD;AACjD,0CAA2E;AAE3E;;GAEG;AACH,SAAS,cAAc,CAAC,gBAAgC;IACtD,OAAO,CAAC,MAAgB,EAAE,EAAE;QAE1B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,uCAA4B,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3F,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,kEAAkE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1J,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;gBAC5B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACtI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,0DAA0D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC7H,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,kEAAkE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACzI,CAAC;YACD,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,8DAA8D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACnI,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAChE,KAAK,MAAM,QAAQ,IAAI,QAAQ,EAAE,CAAC;YAChC,OAAO,CAAC,cAAc,CAAC,6BAAoB,CAAC,QAAQ,CAAC,IAAI,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;QACjG,CAAC;IACH,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import 'reflect-metadata';\nimport { FrontMcpPluginTokens } from '../tokens';\nimport { PluginMetadata, frontMcpPluginMetadataSchema } from '../metadata';\n\n/**\n * Decorator that marks a class as a McpPlugin and provides metadata\n */\nfunction FrontMcpPlugin(providedMetadata: PluginMetadata): ClassDecorator {\n  return (target: Function) => {\n\n    const { error, data: metadata } = frontMcpPluginMetadataSchema.safeParse(providedMetadata);\n    if (error) {\n      if (error.format().providers) {\n        throw new Error(`Invalid metadata provided to @FrontMcpProvider or @Provider: \\n${JSON.stringify(error.formErrors.fieldErrors['providers'], null, 2)}`);\n      }\n      if (error.format().adapters) {\n        throw new Error(`Invalid metadata provided to @FrontMcpAdapter or @Adapter: \\n${JSON.stringify(error.format().adapters, null, 2)}`);\n      }\n      if (error.format().tools) {\n        throw new Error(`Invalid metadata provided to @FrontMcpTool or @Tool: \\n${JSON.stringify(error.format().tools, null, 2)}`);\n      }\n      if (error.format().resources) {\n        throw new Error(`Invalid metadata provided to @FrontMcpResource or @Resource: \\n${JSON.stringify(error.format().resources, null, 2)}`);\n      }\n      if (error.format().prompts) {\n        throw new Error(`Invalid metadata provided to @FrontMcpPrompt or @Prompt: \\n${JSON.stringify(error.format().prompts, null, 2)}`);\n      }\n      throw error;\n    }\n\n    Reflect.defineMetadata(FrontMcpPluginTokens.type, true, target);\n    for (const property in metadata) {\n      Reflect.defineMetadata(FrontMcpPluginTokens[property] ?? property, metadata[property], target);\n    }\n  };\n}\n\nexport {\n  FrontMcpPlugin,\n  FrontMcpPlugin as Plugin,\n};"]}

package/src/decorators/prompt.decorator.d.ts

@@ -0,0 +1,13 @@
+import 'reflect-metadata';
+import { PromptMetadata } from '../metadata';
+import { GetPromptResult, GetPromptRequest } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Decorator that marks a class as a McpPrompt module and provides metadata
+ */
+declare function FrontMcpPrompt(providedMetadata: PromptMetadata): ClassDecorator;
+export type FrontMcpPromptExecuteHandler = (args: GetPromptRequest['params']['arguments'], ...tokens: any[]) => GetPromptResult | Promise<GetPromptResult>;
+/**
+ * Decorator that marks a class as a McpTool module and provides metadata
+ */
+declare function frontMcpPrompt<T extends PromptMetadata>(providedMetadata: T): (handler: FrontMcpPromptExecuteHandler) => (() => void);
+export { FrontMcpPrompt, FrontMcpPrompt as Prompt, frontMcpPrompt, frontMcpPrompt as prompt, };

package/src/decorators/prompt.decorator.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FrontMcpPrompt = FrontMcpPrompt;
+exports.Prompt = FrontMcpPrompt;
+exports.frontMcpPrompt = frontMcpPrompt;
+exports.prompt = frontMcpPrompt;
+require("reflect-metadata");
+const tokens_1 = require("../tokens");
+const metadata_1 = require("../metadata");
+/**
+ * Decorator that marks a class as a McpPrompt module and provides metadata
+ */
+function FrontMcpPrompt(providedMetadata) {
+    return (target) => {
+        const metadata = metadata_1.frontMcpPromptMetadataSchema.parse(providedMetadata);
+        Reflect.defineMetadata(tokens_1.FrontMcpPromptTokens.type, true, target);
+        for (const property in metadata) {
+            Reflect.defineMetadata(tokens_1.FrontMcpPromptTokens[property] ?? property, metadata[property], target);
+        }
+    };
+}
+/**
+ * Decorator that marks a class as a McpTool module and provides metadata
+ */
+function frontMcpPrompt(providedMetadata) {
+    return (execute) => {
+        const metadata = metadata_1.frontMcpPromptMetadataSchema.parse(providedMetadata);
+        const toolFunction = function () {
+            return execute;
+        };
+        Object.assign(toolFunction, {
+            [tokens_1.FrontMcpPromptTokens.type]: 'function-prompt',
+            [tokens_1.FrontMcpPromptTokens.metadata]: metadata,
+        });
+        return toolFunction;
+    };
+}
+//# sourceMappingURL=prompt.decorator.js.map