@forklaunch/core 1.5.1 → 1.5.3

package/lib/http/interfaces/expressLikeRouter.interface.d.ts

@@ -0,0 +1,25 @@
+import { IncomingMessage, ServerOptions, ServerResponse } from 'node:http';
+export interface PathBasedHandler<RouterHandler> {
+    (path: string, ...handlers: RouterHandler[]): unknown;
+}
+export interface PathOrMiddlewareBasedHandler<RouterHandler> extends PathBasedHandler<RouterHandler> {
+    (...args: RouterHandler[]): unknown;
+}
+export interface NestableRouterBasedHandler<RouterHandler, Router> extends PathOrMiddlewareBasedHandler<RouterHandler> {
+    (...args: (Router | RouterHandler)[]): unknown;
+    (path: string, ...handlers: (Router | RouterHandler)[]): unknown;
+}
+export interface ExpressLikeRouter<RouterHandler, Router> extends ServerOptions<typeof IncomingMessage, typeof ServerResponse> {
+    use: NestableRouterBasedHandler<RouterHandler, Router>;
+    all: PathOrMiddlewareBasedHandler<RouterHandler>;
+    connect: PathOrMiddlewareBasedHandler<RouterHandler>;
+    get: PathBasedHandler<RouterHandler>;
+    post: PathBasedHandler<RouterHandler>;
+    put: PathBasedHandler<RouterHandler>;
+    patch: PathBasedHandler<RouterHandler>;
+    delete: PathBasedHandler<RouterHandler>;
+    options: PathBasedHandler<RouterHandler>;
+    head: PathBasedHandler<RouterHandler>;
+    trace: PathBasedHandler<RouterHandler>;
+}
+//# sourceMappingURL=expressLikeRouter.interface.d.ts.map

package/lib/http/interfaces/expressLikeRouter.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expressLikeRouter.interface.d.ts","sourceRoot":"","sources":["../../../src/http/interfaces/expressLikeRouter.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3E,MAAM,WAAW,gBAAgB,CAAC,aAAa;IAC7C,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;CACvD;AAED,MAAM,WAAW,4BAA4B,CAC3C,aAAa,CACb,SAAQ,gBAAgB,CAAC,aAAa,CAAC;IACvC,CAAC,GAAG,IAAI,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,0BAA0B,CACzC,aAAa,EACb,MAAM,CACN,SAAQ,4BAA4B,CAAC,aAAa,CAAC;IACnD,CAAC,GAAG,IAAI,EAAE,CAAC,MAAM,GAAG,aAAa,CAAC,EAAE,GAAG,OAAO,CAAC;IAC/C,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC,MAAM,GAAG,aAAa,CAAC,EAAE,GAAG,OAAO,CAAC;CAClE;AAED,MAAM,WAAW,iBAAiB,CAAC,aAAa,EAAE,MAAM,CAAE,SAAQ,aAAa,CAC7E,OAAO,eAAe,EACtB,OAAO,cAAc,CACtB;IACC,GAAG,EAAE,0BAA0B,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvD,GAAG,EAAE,4BAA4B,CAAC,aAAa,CAAC,CAAC;IACjD,OAAO,EAAE,4BAA4B,CAAC,aAAa,CAAC,CAAC;IACrD,GAAG,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACrC,IAAI,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACtC,GAAG,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACrC,KAAK,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACxC,OAAO,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACzC,IAAI,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;IACtC,KAAK,EAAE,gBAAgB,CAAC,aAAa,CAAC,CAAC;CACxC"}

package/lib/http/mcpGenerator/mcpGenerator.d.ts

@@ -0,0 +1,17 @@
+import { ZodSchemaValidator } from '@forklaunch/validator/zod';
+import { FastMCP } from 'fastmcp';
+import http from 'http';
+import { SessionObject } from '../types/contractDetails.types';
+import { ExpressLikeApplicationOptions } from '../types/expressLikeOptions';
+import { ForklaunchRouter } from '../types/router.types';
+/**
+ * Generates a ModelContextProtocol server from given routers.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {SV} schemaValidator - The schema validator.
+ * @param {string | number} port - The port on which the server is running.
+ * @param {ForklaunchRouter<SV>[]} routers - The routers to include in the server.
+ * @returns {McpServer} - The generated ModelContextProtocol server.
+ */
+export declare function generateMcpServer<T extends Record<string, unknown> | undefined = Record<string, unknown> | undefined>(schemaValidator: ZodSchemaValidator, protocol: 'http' | 'https', host: string, port: number, version: `${number}.${number}.${number}`, application: ForklaunchRouter<ZodSchemaValidator>, appOptions?: ExpressLikeApplicationOptions<ZodSchemaValidator, SessionObject<ZodSchemaValidator>>['mcp'], options?: ConstructorParameters<typeof FastMCP<T>>[0], contentTypeMap?: Record<string, string>, authenticate?: (request: http.IncomingMessage) => Promise<Record<string, unknown> | undefined>): FastMCP<Record<string, unknown> | undefined>;
+//# sourceMappingURL=mcpGenerator.d.ts.map

package/lib/http/mcpGenerator/mcpGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpGenerator.d.ts","sourceRoot":"","sources":["../../../src/http/mcpGenerator/mcpGenerator.ts"],"names":[],"mappings":"AACA,OAAO,EAAU,kBAAkB,EAAW,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AAMxB,OAAO,EAOL,aAAa,EAEd,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAyDzD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAErC,eAAe,EAAE,kBAAkB,EACnC,QAAQ,EAAE,MAAM,GAAG,OAAO,EAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,EACxC,WAAW,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,EACjD,UAAU,CAAC,EAAE,6BAA6B,CACxC,kBAAkB,EAClB,aAAa,CAAC,kBAAkB,CAAC,CAClC,CAAC,KAAK,CAAC,EACR,OAAO,CAAC,EAAE,qBAAqB,CAAC,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EACrD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,YAAY,CAAC,EAAE,CACb,OAAO,EAAE,IAAI,CAAC,eAAe,KAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,gDAuQlD"}

package/lib/http/middleware/request/auth.middleware.d.ts

@@ -0,0 +1,16 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ForklaunchNextFunction, ForklaunchRequest, ForklaunchResponse, MapParamsSchema, MapReqBodySchema, MapReqHeadersSchema, MapReqQuerySchema, MapResBodyMapSchema, MapResHeadersSchema, MapSessionSchema, MapVersionedReqsSchema } from '../../types/apiDefinition.types';
+import { Body, HeadersObject, Method, ParamsObject, QueryObject, ResponsesObject, SessionObject, VersionSchema } from '../../types/contractDetails.types';
+/**
+ * Middleware to parse request authorization.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template Request - A type that extends ForklaunchRequest.
+ * @template Response - A type that extends ForklaunchResponse.
+ * @template NextFunction - A type that extends ForklaunchNextFunction.
+ * @param {Request} req - The request object.
+ * @param {Response} res - The response object.
+ * @param {NextFunction} [next] - The next middleware function.
+ */
+export declare function parseRequestAuth<SV extends AnySchemaValidator, ContractMethod extends Method, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>, VersionedApi extends VersionSchema<SV, ContractMethod>, SessionSchema extends SessionObject<SV>>(req: ForklaunchRequest<SV, MapParamsSchema<SV, P>, MapReqBodySchema<SV, ReqBody>, MapReqQuerySchema<SV, ReqQuery>, MapReqHeadersSchema<SV, ReqHeaders>, Extract<keyof MapVersionedReqsSchema<SV, VersionedApi>, string>, MapSessionSchema<SV, SessionSchema>>, res: ForklaunchResponse<unknown, MapResBodyMapSchema<SV, ResBodyMap>, MapResHeadersSchema<SV, ResHeaders>, LocalsObj, Extract<keyof MapVersionedReqsSchema<SV, VersionedApi>, string>>, next?: ForklaunchNextFunction): Promise<void>;
+//# sourceMappingURL=auth.middleware.d.ts.map

package/lib/http/middleware/request/auth.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/request/auth.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAGnB,MAAM,uBAAuB,CAAC;AAW/B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EAGvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,IAAI,EACJ,aAAa,EACb,MAAM,EAEN,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,mCAAmC,CAAC;AAqe3C;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,SAAS,kBAAkB,EAC7B,cAAc,SAAS,MAAM,EAC7B,CAAC,SAAS,YAAY,CAAC,EAAE,CAAC,EAC1B,UAAU,SAAS,eAAe,CAAC,EAAE,CAAC,EACtC,OAAO,SAAS,IAAI,CAAC,EAAE,CAAC,EACxB,QAAQ,SAAS,WAAW,CAAC,EAAE,CAAC,EAChC,UAAU,SAAS,aAAa,CAAC,EAAE,CAAC,EACpC,UAAU,SAAS,aAAa,CAAC,EAAE,CAAC,EACpC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,YAAY,SAAS,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC,EACtD,aAAa,SAAS,aAAa,CAAC,EAAE,CAAC,EAEvC,GAAG,EAAE,iBAAiB,CACpB,EAAE,EACF,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,EACtB,gBAAgB,CAAC,EAAE,EAAE,OAAO,CAAC,EAC7B,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,EAC/B,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,EACnC,OAAO,CAAC,MAAM,sBAAsB,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,EAC/D,gBAAgB,CAAC,EAAE,EAAE,aAAa,CAAC,CACpC,EACD,GAAG,EAAE,kBAAkB,CACrB,OAAO,EACP,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,EACnC,mBAAmB,CAAC,EAAE,EAAE,UAAU,CAAC,EACnC,SAAS,EACT,OAAO,CAAC,MAAM,sBAAsB,CAAC,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAChE,EACD,IAAI,CAAC,EAAE,sBAAsB,iBAsD9B"}

package/lib/http/middleware/request/cors.middleware.d.ts

@@ -0,0 +1,13 @@
+import { CorsOptions } from 'cors';
+import { ParsedQs } from 'qs';
+import { ForklaunchBaseRequest, ForklaunchNextFunction, ForklaunchResHeaders, ForklaunchResponse } from '../../types/apiDefinition.types';
+import { ParamsDictionary } from '../../types/contractDetails.types';
+/**
+ * Cors middleware handler
+ *
+ * @param req - Express-like request object
+ * @param res - Express-like response object
+ * @param next - Express-like next function
+ */
+export declare function cors<P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, unknown>, LocalsObj extends Record<string, unknown>>(corsOptions: CorsOptions): (req: ForklaunchBaseRequest<P, ReqBody, ReqQuery, ReqHeaders>, res: ForklaunchResponse<unknown, ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj, never>, next?: ForklaunchNextFunction) => void;
+//# sourceMappingURL=cors.middleware.d.ts.map

package/lib/http/middleware/request/cors.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/request/cors.middleware.ts"],"names":[],"mappings":"AAAA,OAAuB,EAAE,WAAW,EAAE,MAAM,MAAM,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE;;;;;;GAMG;AACH,wBAAgB,IAAI,CAClB,CAAC,SAAS,gBAAgB,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,SAAS,QAAQ,EACzB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,WAAW,EAAE,WAAW,SAEjB,qBAAqB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC,OACvD,kBAAkB,CACrB,OAAO,EACP,UAAU,EACV,oBAAoB,GAAG,UAAU,EACjC,SAAS,EACT,KAAK,CACN,SACM,sBAAsB,UAgBhC"}

package/lib/http/middleware/request/createContext.middleware.d.ts

@@ -0,0 +1,15 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ExpressLikeSchemaHandler, ForklaunchNextFunction } from '../../types/apiDefinition.types';
+import { Body, HeadersObject, ParamsObject, QueryObject, ResponsesObject, SessionObject, VersionSchema } from '../../types/contractDetails.types';
+/**
+ * Middleware to create and add a request context.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template Request - A type that extends ForklaunchRequest.
+ * @template Response - A type that extends ForklaunchResponse.
+ * @template NextFunction - A type that extends ForklaunchNextFunction.
+ * @param {SV} schemaValidator - The schema validator.
+ * @returns {Function} - Middleware function to create request context.
+ */
+export declare function createContext<SV extends AnySchemaValidator, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>, VersionedApi extends VersionSchema<SV, 'middleware'>, SessionSchema extends SessionObject<SV>>(schemaValidator: SV): ExpressLikeSchemaHandler<SV, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, VersionedApi, SessionSchema, unknown, unknown, ForklaunchNextFunction>;
+//# sourceMappingURL=createContext.middleware.d.ts.map

package/lib/http/middleware/request/createContext.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContext.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/request/createContext.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAS3D,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EAGvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,mCAAmC,CAAC;AAE3C;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,YAAY,CAAC,EAAE,CAAC,EAC1B,UAAU,SAAS,eAAe,CAAC,EAAE,CAAC,EACtC,OAAO,SAAS,IAAI,CAAC,EAAE,CAAC,EACxB,QAAQ,SAAS,WAAW,CAAC,EAAE,CAAC,EAChC,UAAU,SAAS,aAAa,CAAC,EAAE,CAAC,EACpC,UAAU,SAAS,aAAa,CAAC,EAAE,CAAC,EACpC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,YAAY,SAAS,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,EACpD,aAAa,SAAS,aAAa,CAAC,EAAE,CAAC,EAEvC,eAAe,EAAE,EAAE,GAClB,wBAAwB,CACzB,EAAE,EACF,CAAC,EACD,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,EACb,OAAO,EACP,OAAO,EACP,sBAAsB,CACvB,CAsDA"}

package/lib/http/middleware/request/enrichDetails.middleware.d.ts

@@ -0,0 +1,18 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { OpenTelemetryCollector } from '../../telemetry/openTelemetryCollector';
+import { ExpressLikeSchemaHandler, ForklaunchNextFunction } from '../../types/apiDefinition.types';
+import { Body, HeadersObject, HttpContractDetails, Method, ParamsObject, PathParamHttpContractDetails, QueryObject, ResponseCompiledSchema, ResponsesObject, SessionObject, VersionSchema } from '../../types/contractDetails.types';
+import { ExpressLikeRouterOptions } from '../../types/expressLikeOptions';
+import { MetricsDefinition } from '../../types/openTelemetryCollector.types';
+/**
+ * Middleware to enrich the request details with contract details.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template Request - A type that extends ForklaunchRequest.
+ * @template Response - A type that extends ForklaunchResponse.
+ * @template NextFunction - A type that extends ForklaunchNextFunction.
+ * @param {PathParamHttpContractDetails<SV> | HttpContractDetails<SV>} contractDetails - The contract details.
+ * @returns {Function} - Middleware function to enrich request details.
+ */
+export declare function enrichDetails<SV extends AnySchemaValidator, ContractMethod extends Method, P extends ParamsObject<SV>, ResBodyMap extends ResponsesObject<SV>, ReqBody extends Body<SV>, ReqQuery extends QueryObject<SV>, ReqHeaders extends HeadersObject<SV>, ResHeaders extends HeadersObject<SV>, LocalsObj extends Record<string, unknown>, VersionedApi extends VersionSchema<SV, ContractMethod>, SessionSchema extends SessionObject<SV>>(path: string, contractDetails: HttpContractDetails<SV> | PathParamHttpContractDetails<SV>, requestSchema: unknown | Record<string, unknown>, responseSchemas: ResponseCompiledSchema | Record<string, ResponseCompiledSchema>, openTelemetryCollector?: OpenTelemetryCollector<MetricsDefinition>, globalOptions?: () => ExpressLikeRouterOptions<SV, SessionSchema> | undefined): ExpressLikeSchemaHandler<SV, P, ResBodyMap, ReqBody, ReqQuery, ReqHeaders, ResHeaders, LocalsObj, VersionedApi, SessionSchema, unknown, unknown, ForklaunchNextFunction>;
+//# sourceMappingURL=enrichDetails.middleware.d.ts.map

package/lib/http/middleware/request/enrichDetails.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichDetails.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/request/enrichDetails.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAS3D,OAAO,EAEL,sBAAsB,EACvB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EACJ,aAAa,EACb,mBAAmB,EACnB,MAAM,EACN,YAAY,EACZ,4BAA4B,EAC5B,WAAW,EACX,sBAAsB,EACtB,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0CAA0C,CAAC;AAE7E;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,EAAE,SAAS,kBAAkB,EAC7B,cAAc,SAAS,MAAM,EAC7B,CAAC,SAAS,YAAY,CAAC,EAAE,CAAC,EAC1B,UAAU,SAAS,eAAe,CAAC,EAAE,CAAC,EACtC,OAAO,SAAS,IAAI,CAAC,EAAE,CAAC,EACxB,QAAQ,SAAS,WAAW,CAAC,EAAE,CAAC,EAChC,UAAU,SAAS,aAAa,CAAC,EAAE,CAAC,EACpC,UAAU,SAAS,aAAa,CAAC,EAAE,CAAC,EACpC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,YAAY,SAAS,aAAa,CAAC,EAAE,EAAE,cAAc,CAAC,EACtD,aAAa,SAAS,aAAa,CAAC,EAAE,CAAC,EAEvC,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,mBAAmB,CAAC,EAAE,CAAC,GAAG,4BAA4B,CAAC,EAAE,CAAC,EAC3E,aAAa,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChD,eAAe,EACb,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,EACjE,sBAAsB,CAAC,EAAE,sBAAsB,CAAC,iBAAiB,CAAC,EAClE,aAAa,CAAC,EAAE,MAAM,wBAAwB,CAAC,EAAE,EAAE,aAAa,CAAC,GAAG,SAAS,GAC5E,wBAAwB,CACzB,EAAE,EACF,CAAC,EACD,UAAU,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,UAAU,EACV,SAAS,EACT,YAAY,EACZ,aAAa,EACb,OAAO,EACP,OAAO,EACP,sBAAsB,CACvB,CA4BA"}

package/lib/http/middleware/request/parse.middleware.d.ts

@@ -0,0 +1,17 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ParsedQs } from 'qs';
+import { ForklaunchNextFunction, ForklaunchRequest, ForklaunchResponse, VersionedRequests } from '../../types/apiDefinition.types';
+import { ParamsDictionary } from '../../types/contractDetails.types';
+/**
+ * Pre-handler function to parse and validate input.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @template Request - A type that extends ForklaunchRequest.
+ * @template Response - A type that extends ForklaunchResponse.
+ * @template NextFunction - A type that extends ForklaunchNextFunction.
+ * @param {Request} req - The request object.
+ * @param {Response} res - The response object.
+ * @param {NextFunction} [next] - The next middleware function.
+ */
+export declare function parse<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, unknown>, LocalsObj extends Record<string, unknown>, VersionedReqs extends VersionedRequests, SessionSchema extends Record<string, unknown>>(req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders, Extract<keyof VersionedReqs, string>, SessionSchema>, res: ForklaunchResponse<unknown, ResBodyMap, ResHeaders, LocalsObj, Extract<keyof VersionedReqs, string>>, next?: ForklaunchNextFunction): void;
+//# sourceMappingURL=parse.middleware.d.ts.map

package/lib/http/middleware/request/parse.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/request/parse.middleware.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAInB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CACnB,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,gBAAgB,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,SAAS,QAAQ,EACzB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,aAAa,SAAS,iBAAiB,EACvC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE7C,GAAG,EAAE,iBAAiB,CACpB,EAAE,EACF,CAAC,EACD,OAAO,EACP,QAAQ,EACR,UAAU,EACV,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,EACpC,aAAa,CACd,EACD,GAAG,EAAE,kBAAkB,CACrB,OAAO,EACP,UAAU,EACV,UAAU,EACV,SAAS,EACT,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,CACrC,EACD,IAAI,CAAC,EAAE,sBAAsB,QAuI9B"}

package/lib/http/middleware/request/tenantContext.middleware.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Structural request type for tenant context middleware.
+ * Accepts any object with the properties the middleware actually reads.
+ */
+export interface TenantContextRequest {
+    contractDetails: Record<string, unknown>;
+    session?: Record<string, unknown>;
+    headers: Record<string, unknown>;
+    em?: TenantFilterable;
+    schemaValidator?: unknown;
+}
+/**
+ * Structural response type for tenant context middleware.
+ * Only `status` and `send` are used (for 403 responses).
+ */
+export interface TenantContextResponse {
+    status(code: number): TenantContextResponse;
+    send(body?: unknown): TenantContextResponse;
+}
+/**
+ * Middleware that establishes tenant context on the request-scoped
+ * EntityManager. Runs after auth middleware.
+ *
+ * - For `'protected'`/`'authenticated'` routes: reads tenant ID from
+ *   `req.session.organizationId` or `req.session.activeOrganizationId`.
+ *   Returns 403 if missing.
+ * - For `'internal'` routes: reads tenant ID from `X-Tenant-Id` header
+ *   or from the session if available.
+ * - For `'public'` routes: skips tenant context — filter remains unset.
+ *
+ * The middleware:
+ * 1. Sets the tenant filter params on the EM: `em.setFilterParams('tenant', { tenantId })`
+ * 2. Wraps the EM with native query blocking for compliance entities
+ */
+export declare function setTenantContext(req: TenantContextRequest, res: TenantContextResponse, next?: (() => void) | undefined): Promise<void>;
+/** Minimal interface for setting filter params — avoids importing full EntityManager. */
+interface TenantFilterable {
+    setFilterParams(name: string, params: Record<string, unknown>): void;
+}
+export {};
+//# sourceMappingURL=tenantContext.middleware.d.ts.map

package/lib/http/middleware/request/tenantContext.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenantContext.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/request/tenantContext.middleware.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,EAAE,CAAC,EAAE,gBAAgB,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,qBAAqB,CAAC;IAC5C,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,qBAAqB,CAAC;CAC7C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,oBAAoB,EACzB,GAAG,EAAE,qBAAqB,EAC1B,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED,yFAAyF;AACzF,UAAU,gBAAgB;IACxB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACtE"}

package/lib/http/middleware/response/enrichExpressLikeSend.middleware.d.ts

@@ -0,0 +1,32 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ParsedQs } from 'qs';
+import { ForklaunchRequest, ForklaunchResHeaders, ForklaunchResponse, ForklaunchSendableData, ForklaunchStatusResponse, VersionedRequests } from '../../types/apiDefinition.types';
+import { ParamsDictionary } from '../../types/contractDetails.types';
+/**
+ * Enhances the Express-like `send` method with additional logic for response handling and validation.
+ *
+ * This function intercepts the `send` method to provide custom behavior, including response validation
+ * through the `parseResponse` middleware. If the response status is 404, it sends a "Not Found" message.
+ * If the response validation fails, it sends a parsing error message. Otherwise, it calls the original `send`
+ * method with the provided data.
+ *
+ * @template SV - The type of the schema validator used in the request.
+ * @template P - The type of the parameters dictionary used in the request.
+ * @template ResBodyMap - A record type mapping status codes to response body types.
+ * @template ReqBody - The type of the request body.
+ * @template ReqQuery - The type of the parsed query string.
+ * @template ReqHeaders - The type of the request headers.
+ * @template ResHeaders - The type of the response headers, extended from `ForklaunchResHeaders`.
+ * @template LocalsObj - The type of the locals object in the response.
+ *
+ * @param {unknown} instance - The context (typically `this`) in which the original `send` method is called.
+ * @param {ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>} req - The request object, containing the schema validator and other request data.
+ * @param {ForklaunchResponse<ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj>} res - The response object, including headers and body data.
+ * @param {Function} originalSend - The original `send` method from the response object, to be called after custom logic.
+ * @param {string | ArrayBuffer | ArrayBufferView | NodeJS.ReadableStream | null | undefined} data - The data to be sent as the response body.
+ * @param {boolean} shouldEnrich - A flag indicating whether the response should be sent immediately.
+ *
+ * @returns {unknown} The return value of the original `send` method, typically the response itself.
+ */
+export declare function enrichExpressLikeSend<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, unknown>, LocalsObj extends Record<string, unknown>, VersionedReqs extends VersionedRequests, SessionSchema extends Record<string, unknown>>(instance: unknown, req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders, Extract<keyof VersionedReqs, string>, SessionSchema>, res: ForklaunchResponse<unknown, ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj, Extract<keyof VersionedReqs, string>>, originalOperation: ForklaunchStatusResponse<ForklaunchSendableData>['json'] | ForklaunchStatusResponse<ForklaunchSendableData>['jsonp'], originalSend: ForklaunchStatusResponse<ForklaunchSendableData>['send'], data: ForklaunchSendableData | File | Blob | AsyncGenerator<Record<string, unknown>> | null | undefined, shouldEnrich: boolean): void;
+//# sourceMappingURL=enrichExpressLikeSend.middleware.d.ts.map

package/lib/http/middleware/response/enrichExpressLikeSend.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichExpressLikeSend.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/response/enrichExpressLikeSend.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAc9B,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,gBAAgB,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,SAAS,QAAQ,EACzB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,aAAa,SAAS,iBAAiB,EACvC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE7C,QAAQ,EAAE,OAAO,EACjB,GAAG,EAAE,iBAAiB,CACpB,EAAE,EACF,CAAC,EACD,OAAO,EACP,QAAQ,EACR,UAAU,EACV,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,EACpC,aAAa,CACd,EACD,GAAG,EAAE,kBAAkB,CACrB,OAAO,EACP,UAAU,EACV,oBAAoB,GAAG,UAAU,EACjC,SAAS,EACT,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,CACrC,EACD,iBAAiB,EACb,wBAAwB,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,GACxD,wBAAwB,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,EAC7D,YAAY,EAAE,wBAAwB,CAAC,sBAAsB,CAAC,CAAC,MAAM,CAAC,EACtE,IAAI,EACA,sBAAsB,GACtB,IAAI,GACJ,IAAI,GACJ,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,IAAI,GACJ,SAAS,EACb,YAAY,EAAE,OAAO,QA8KtB"}

package/lib/http/middleware/response/parse.middleware.d.ts

@@ -0,0 +1,31 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { ParsedQs } from 'qs';
+import { ForklaunchNextFunction, ForklaunchRequest, ForklaunchResHeaders, ForklaunchResponse, VersionedRequests } from '../../types/apiDefinition.types';
+import { ParamsDictionary } from '../../types/contractDetails.types';
+/**
+ * Middleware to parse and validate the response according to the provided schema.
+ *
+ * This function validates the response against a schema provided by the request's schema validator.
+ * If the response does not conform to the schema, the behavior is determined by the `responseValidation`
+ * option in `req.contractDetails.options`:
+ * - `'error'` (default): Calls `next` with an error.
+ * - `'warning'`: Logs a warning to the console.
+ * - `'none'`: Silently continues without action.
+ *
+ * @template SV - The type of the schema validator used in the request.
+ * @template P - The type of the parameters dictionary used in the request.
+ * @template ResBodyMap - A record type mapping status codes to response body types.
+ * @template ReqBody - The type of the request body.
+ * @template ReqQuery - The type of the parsed query string.
+ * @template ReqHeaders - The type of the request headers.
+ * @template ResHeaders - The type of the response headers, extended from `ForklaunchResHeaders`.
+ * @template LocalsObj - The type of the locals object in the response.
+ *
+ * @param {ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders>} req - The request object, containing the schema validator and other request data.
+ * @param {ForklaunchResponse<ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj>} res - The response object, including headers and body data.
+ * @param {ForklaunchNextFunction} [next] - The next middleware function to be called. If not provided, the function will return after processing.
+ *
+ * @returns {void} This function does not return a value.
+ */
+export declare function parse<SV extends AnySchemaValidator, P extends ParamsDictionary, ResBodyMap extends Record<number, unknown>, ReqBody extends Record<string, unknown>, ReqQuery extends ParsedQs, ReqHeaders extends Record<string, string>, ResHeaders extends Record<string, unknown>, LocalsObj extends Record<string, unknown>, VersionedReqs extends VersionedRequests, SessionSchema extends Record<string, unknown>>(req: ForklaunchRequest<SV, P, ReqBody, ReqQuery, ReqHeaders, Extract<keyof VersionedReqs, string>, SessionSchema>, res: ForklaunchResponse<unknown, ResBodyMap, ForklaunchResHeaders & ResHeaders, LocalsObj, Extract<keyof VersionedReqs, string>>, next?: ForklaunchNextFunction): void;
+//# sourceMappingURL=parse.middleware.d.ts.map

package/lib/http/middleware/response/parse.middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.middleware.d.ts","sourceRoot":"","sources":["../../../../src/http/middleware/response/parse.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAGnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAG9B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,KAAK,CACnB,EAAE,SAAS,kBAAkB,EAC7B,CAAC,SAAS,gBAAgB,EAC1B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,QAAQ,SAAS,QAAQ,EACzB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACzC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1C,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,aAAa,SAAS,iBAAiB,EACvC,aAAa,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAE7C,GAAG,EAAE,iBAAiB,CACpB,EAAE,EACF,CAAC,EACD,OAAO,EACP,QAAQ,EACR,UAAU,EACV,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,EACpC,aAAa,CACd,EACD,GAAG,EAAE,kBAAkB,CACrB,OAAO,EACP,UAAU,EACV,oBAAoB,GAAG,UAAU,EACjC,SAAS,EACT,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,CACrC,EACD,IAAI,CAAC,EAAE,sBAAsB,QAoH9B"}

package/lib/http/openApiV3Generator/openApiV3Generator.d.ts

@@ -0,0 +1,17 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { OpenAPIObject } from 'openapi3-ts/oas31';
+import { SessionObject } from '../types/contractDetails.types';
+import { ExpressLikeApplicationOptions } from '../types/expressLikeOptions';
+import { ForklaunchRouter } from '../types/router.types';
+export declare const OPENAPI_DEFAULT_VERSION: unique symbol;
+/**
+ * Generates a Swagger document from given routers.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {SV} schemaValidator - The schema validator.
+ * @param {string | number} port - The port on which the server is running.
+ * @param {ForklaunchRouter<SV>[]} routers - The routers to include in the Swagger document.
+ * @returns {OpenAPIObject} - The generated Swagger document.
+ */
+export declare function generateOpenApiSpecs<SV extends AnySchemaValidator>(schemaValidator: SV, serverUrls: string[], serverDescriptions: string[], application: ForklaunchRouter<SV>, appOptions?: ExpressLikeApplicationOptions<SV, SessionObject<SV>>['openapi']): Record<string | symbol, OpenAPIObject>;
+//# sourceMappingURL=openApiV3Generator.d.ts.map

package/lib/http/openApiV3Generator/openApiV3Generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openApiV3Generator.d.ts","sourceRoot":"","sources":["../../../src/http/openApiV3Generator/openApiV3Generator.ts"],"names":[],"mappings":"AACA,OAAO,EACL,kBAAkB,EAGnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,aAAa,EAOd,MAAM,mBAAmB,CAAC;AAO3B,OAAO,EAQL,aAAa,EAEd,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,6BAA6B,EAAE,MAAM,6BAA6B,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,eAAoB,CAAC;AAiTzD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,SAAS,kBAAkB,EAChE,eAAe,EAAE,EAAE,EACnB,UAAU,EAAE,MAAM,EAAE,EACpB,kBAAkB,EAAE,MAAM,EAAE,EAC5B,WAAW,EAAE,gBAAgB,CAAC,EAAE,CAAC,EACjC,UAAU,CAAC,EAAE,6BAA6B,CAAC,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,GAC3E,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,aAAa,CAAC,CAsJxC"}

package/lib/http/rateLimit/index.d.ts

@@ -0,0 +1,2 @@
+export { RateLimiter, type RateLimitConfig, type RateLimitResult } from './rateLimiter';
+//# sourceMappingURL=index.d.ts.map

package/lib/http/rateLimit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/http/rateLimit/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,eAAe,EACrB,MAAM,eAAe,CAAC"}

package/lib/http/rateLimit/rateLimiter.d.ts

@@ -0,0 +1,66 @@
+import { TtlCache } from '../../cache/interfaces/ttlCache.interface';
+/**
+ * Configuration for rate limiting with separate read/write limits.
+ */
+export type RateLimitConfig = {
+    /** Max requests per window for GET/HEAD/OPTIONS */
+    read: number;
+    /** Max requests per window for POST/PUT/PATCH/DELETE */
+    write: number;
+    /** Window duration in milliseconds */
+    windowMs: number;
+};
+/**
+ * Result of a rate limit check.
+ */
+export type RateLimitResult = {
+    /** Whether the request is allowed */
+    allowed: boolean;
+    /** Number of remaining requests in the current window */
+    remaining: number;
+    /** Unix timestamp (ms) when the current window resets */
+    resetAt: number;
+};
+/**
+ * Rate limiter backed by a TtlCache.
+ *
+ * Uses a sliding-window counter pattern: each unique key maps to a
+ * {@link RateLimitCounter} stored in the cache with a TTL equal to the
+ * configured window duration.
+ */
+export declare class RateLimiter {
+    private cache;
+    constructor(cache: TtlCache);
+    /**
+     * Check whether the given key is within its rate limit.
+     *
+     * The counter is read from the cache, incremented, and written back.
+     * If the cache is unreachable the limiter **fails open** (allows the
+     * request) so that a cache outage does not take down the service.
+     *
+     * @param key - The rate limit key (see {@link RateLimiter.buildKey}).
+     * @param limit - Maximum number of requests allowed in the window.
+     * @param windowMs - Window duration in milliseconds.
+     */
+    check(key: string, limit: number, windowMs: number): Promise<RateLimitResult>;
+    /**
+     * Build a rate limit key from request context parts.
+     *
+     * Format: `ratelimit:{tenantId}:{route}:{userId}:{operationType}`
+     *
+     * When `tenantId` or `userId` is `null`, the placeholder `"anon"` is used.
+     */
+    static buildKey(parts: {
+        tenantId: string | null;
+        route: string;
+        userId: string | null;
+        operationType: 'read' | 'write';
+    }): string;
+    /**
+     * Determine whether an HTTP method is a read or write operation.
+     *
+     * GET, HEAD, and OPTIONS are reads; everything else is a write.
+     */
+    static operationType(method: string): 'read' | 'write';
+}
+//# sourceMappingURL=rateLimiter.d.ts.map

package/lib/http/rateLimit/rateLimiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../../src/http/rateLimit/rateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2CAA2C,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AASF;;;;;;GAMG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,KAAK;IAAzB,YAAoB,KAAK,EAAE,QAAQ,EAAI;IAEvC;;;;;;;;;;OAUG;IACG,KAAK,CACT,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CAqC1B;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;KACjC,GAAG,MAAM,CAIT;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAErD;CACF"}

package/lib/http/router/discriminateBody.d.ts

@@ -0,0 +1,43 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { Body, ResponsesObject } from '../types/contractDetails.types';
+/**
+ * Discriminates the body type from the given contract details and returns information
+ * necessary for parsing and validation.
+ *
+ * @template SV - Schema validator type.
+ * @template Path - Route path type.
+ * @template P - Params schema type.
+ * @template ResBodyMap - Response body map type.
+ * @template ReqBody - Request body type.
+ * @template ReqQuery - Request query object type.
+ * @template ReqHeaders - Request headers object type.
+ * @template ResHeaders - Response headers object type.
+ * @param contractDetails - The HTTP contract details.
+ * @returns An object containing the content type, parser type, and schema.
+ * @throws If no body-related information is found in the contract details.
+ */
+export declare function discriminateBody<SV extends AnySchemaValidator>(schemaValidator: SV, body: Body<SV> | undefined): {
+    contentType: string;
+    parserType: 'json' | 'text' | 'multipart' | 'urlEncoded' | 'file';
+    schema: SV['_ValidSchemaObject'];
+} | undefined;
+/**
+ * Discriminates all response body types from the given contract details and returns
+ * information necessary for parsing and validation for each status code.
+ *
+ * @template SV - Schema validator type.
+ * @template Path - Route path type.
+ * @template P - Params schema type.
+ * @template ResBodyMap - Response body map type.
+ * @template ReqQuery - Request query object type.
+ * @template ReqHeaders - Request headers object type.
+ * @template ResHeaders - Response headers object type.
+ * @param contractDetails - The contract details containing response schemas.
+ * @returns A record mapping status codes to content type, parser type, and schema info.
+ */
+export declare function discriminateResponseBodies<SV extends AnySchemaValidator>(schemaValidator: SV, responses: ResponsesObject<SV>): Record<number, {
+    contentType: string;
+    parserType: 'json' | 'text' | 'serverSentEvent' | 'file' | 'multipart';
+    schema: SV['_ValidSchemaObject'];
+}>;
+//# sourceMappingURL=discriminateBody.d.ts.map

package/lib/http/router/discriminateBody.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discriminateBody.d.ts","sourceRoot":"","sources":["../../../src/http/router/discriminateBody.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAmB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EACL,IAAI,EACJ,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AAExC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,SAAS,kBAAkB,EAC5D,eAAe,EAAE,EAAE,EACnB,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,SAAS,GAExB;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,MAAM,CAAC;IAClE,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,CAAC;CAClC,GACD,SAAS,CA6EZ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,SAAS,kBAAkB,EACtE,eAAe,EAAE,EAAE,EACnB,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC;iBAKb,MAAM;gBACP,MAAM,GAAG,MAAM,GAAG,iBAAiB,GAAG,MAAM,GAAG,WAAW;YAC9D,EAAE,CAAC,oBAAoB,CAAC;GA2FrC"}