@frontmcp/sdk 0.5.1 → 0.6.1

package/src/common/interfaces/server.interface.d.ts

@@ -39,6 +39,15 @@ export declare abstract class FrontMcpServer {
      * with the gateway's request/response processing.
      */
     abstract enhancedHandler(handler: ServerRequestHandler): (req: any, res: any, next: () => any) => Promise<void> | void;
+    /**
+     * Prepares the server routes without starting the HTTP listener.
+     * Used for serverless deployments (Vercel, AWS Lambda, etc.)
+     */
+    abstract prepare(): void;
+    /**
+     * Returns the underlying HTTP handler for serverless exports.
+     */
+    abstract getHandler(): unknown;
     /**
      *  Start the server on the specified port
      */

package/src/common/interfaces/server.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/server.interface.ts"],"names":[],"mappings":";;;AAAA,+BAA6E;AAK7E,MAAa,aAAc,SAAQ,sBAAe;IAEhD,IAAI,CAAS;IAGb,KAAK,CAAoC;IACzC,IAAI,CAAO;IACX,WAAW,CAAiB;CAC7B;AARD,sCAQC;AAED,MAAsB,cAAe,SAAQ,qBAAkB;CAU9D;AAVD,wCAUC;AAMD,MAAsB,cAAc;CA+BnC;AA/BD,wCA+BC","sourcesContent":["import { IncomingMessage, ServerResponse as HttpServerResponse } from 'http';\nimport { Authorization } from '../types'; // TODO: move to internal\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';\n\nexport class ServerRequest extends IncomingMessage {\n  declare method: HttpMethod;\n  path: string;\n  declare url: string;\n  declare headers: Record<string, string>;\n  query: Record<string, string | string[]>;\n  body?: any;\n  authSession?: Authorization;\n}\n\nexport abstract class ServerResponse extends HttpServerResponse {\n  abstract status(code: number): ServerResponse;\n\n  abstract json(payload: any): void;\n\n  abstract send(payload: any): void;\n\n  abstract redirect(url: string): void;\n\n  abstract redirect(status: number, url: string): void;\n}\n\nexport type NextFn = () => Promise<void> | void;\n\nexport type ServerRequestHandler = (req: ServerRequest, res: ServerResponse, next: NextFn) => Promise<void> | void;\n\nexport abstract class FrontMcpServer {\n\n  /**\n   * Register a middleware handler for a specific entry path.\n   * @param entryPath - e.g. '' or '/mcp'\n   * @param handler - (req, res, next) => {// middleware // next()}\n   */\n  abstract registerMiddleware(entryPath: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Register a route handler for a specific path.\n   * @param method - e.g. 'GET' or 'POST'\n   * @param path - e.g. '/mcp/invoke'\n   * @param handler - (req, res) => {// route handler // res.end() }\n   */\n  abstract registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Enhance a request handler with request/response processing and error handling.\n   * This handle will be stored as the first middleware in the chain to align adapter handler\n   * with the gateway's request/response processing.\n   */\n  abstract enhancedHandler(\n    handler: ServerRequestHandler,\n  ): (req: any, res: any, next: () => any) => Promise<void> | void;\n\n\n  /**\n   *  Start the server on the specified port\n   */\n  abstract start(port?: number): Promise<void> | void;\n}"]}
+{"version":3,"file":"server.interface.js","sourceRoot":"","sources":["../../../../src/common/interfaces/server.interface.ts"],"names":[],"mappings":";;;AAAA,+BAA6E;AAK7E,MAAa,aAAc,SAAQ,sBAAe;IAEhD,IAAI,CAAS;IAGb,KAAK,CAAoC;IACzC,IAAI,CAAO;IACX,WAAW,CAAiB;CAC7B;AARD,sCAQC;AAED,MAAsB,cAAe,SAAQ,qBAAkB;CAU9D;AAVD,wCAUC;AAMD,MAAsB,cAAc;CAwCnC;AAxCD,wCAwCC","sourcesContent":["import { IncomingMessage, ServerResponse as HttpServerResponse } from 'http';\nimport { Authorization } from '../types'; // TODO: move to internal\n\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';\n\nexport class ServerRequest extends IncomingMessage {\n  declare method: HttpMethod;\n  path: string;\n  declare url: string;\n  declare headers: Record<string, string>;\n  query: Record<string, string | string[]>;\n  body?: any;\n  authSession?: Authorization;\n}\n\nexport abstract class ServerResponse extends HttpServerResponse {\n  abstract status(code: number): ServerResponse;\n\n  abstract json(payload: any): void;\n\n  abstract send(payload: any): void;\n\n  abstract redirect(url: string): void;\n\n  abstract redirect(status: number, url: string): void;\n}\n\nexport type NextFn = () => Promise<void> | void;\n\nexport type ServerRequestHandler = (req: ServerRequest, res: ServerResponse, next: NextFn) => Promise<void> | void;\n\nexport abstract class FrontMcpServer {\n  /**\n   * Register a middleware handler for a specific entry path.\n   * @param entryPath - e.g. '' or '/mcp'\n   * @param handler - (req, res, next) => {// middleware // next()}\n   */\n  abstract registerMiddleware(entryPath: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Register a route handler for a specific path.\n   * @param method - e.g. 'GET' or 'POST'\n   * @param path - e.g. '/mcp/invoke'\n   * @param handler - (req, res) => {// route handler // res.end() }\n   */\n  abstract registerRoute(method: HttpMethod, path: string, handler: ServerRequestHandler): Promise<void> | void;\n\n  /**\n   * Enhance a request handler with request/response processing and error handling.\n   * This handle will be stored as the first middleware in the chain to align adapter handler\n   * with the gateway's request/response processing.\n   */\n  abstract enhancedHandler(\n    handler: ServerRequestHandler,\n  ): (req: any, res: any, next: () => any) => Promise<void> | void;\n\n  /**\n   * Prepares the server routes without starting the HTTP listener.\n   * Used for serverless deployments (Vercel, AWS Lambda, etc.)\n   */\n  abstract prepare(): void;\n\n  /**\n   * Returns the underlying HTTP handler for serverless exports.\n   */\n  abstract getHandler(): unknown;\n\n  /**\n   *  Start the server on the specified port\n   */\n  abstract start(port?: number): Promise<void> | void;\n}\n"]}

package/src/common/metadata/app.metadata.d.ts

@@ -110,6 +110,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"transparent">;
@@ -146,6 +159,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -168,6 +194,7 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -213,6 +240,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -252,6 +292,7 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -297,6 +338,19 @@ export declare const frontMcpLocalAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
     standalone: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"includeInParent">, z.ZodBoolean]>>>;
@@ -373,6 +427,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"transparent">;
@@ -409,6 +476,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -431,6 +511,7 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -476,6 +557,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>, z.ZodObject<{
         mode: z.ZodLiteral<"orchestrated">;
@@ -515,6 +609,7 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
                 db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
                 tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
                 keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             }, z.core.$strip>;
         }, z.core.$strip>], "type">>;
         sessionMode: z.ZodDefault<z.ZodEnum<{
@@ -560,6 +655,19 @@ export declare const frontMcpRemoteAppMetadataSchema: z.ZodObject<{
             enableStatelessHttp: z.ZodDefault<z.ZodBoolean>;
             enableStatefulHttp: z.ZodDefault<z.ZodBoolean>;
             requireSessionForStreamable: z.ZodDefault<z.ZodBoolean>;
+            recreation: z.ZodOptional<z.ZodLazy<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                redis: z.ZodOptional<z.ZodObject<{
+                    host: z.ZodString;
+                    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    password: z.ZodOptional<z.ZodString>;
+                    db: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                    tls: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                    keyPrefix: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+                    defaultTtlMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                }, z.core.$strip>>;
+                defaultTtlMs: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strip>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>]>>;
     standalone: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"includeInParent">, z.ZodBoolean]>>>;