@geekmidas/constructs 10.0.0-alpha.101 → 10.0.0-alpha.103

package/dist/adaptors/aws.d.cts

@@ -2,7 +2,7 @@ import { t as StandardSchemaV1 } from "../index-CeEtxDmK.cjs";
 import { i as FunctionHandler, n as Function$1 } from "../Function-Pu-1kKZz.cjs";
 import { t as Cron } from "../Cron-DI3nKoic.cjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.cjs";
-import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-aCvBMPoH.cjs";
+import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-BWyKCa2x.cjs";
 import { t as Telemetry } from "../lambdaTelemetry-8vnmVZQ5.cjs";
 import { t as Queue } from "../Queue-HPyi0e1i.cjs";
 import { t as Subscriber } from "../Subscriber-Bpp02cGr.cjs";
@@ -154,22 +154,35 @@ declare abstract class AmazonApiGatewayEndpoint<THandler extends AmazonApiGatewa
   protected envParser: EnvironmentParser<{}>;
   constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession, TAuditStorage, TAuditStorageServiceName, TAuditAction>, options?: AmazonApiGatewayEndpointOptions);
   private error;
-  abstract getInput(e: TEvent): GetInputResponse;
+  abstract getInput(e: TEvent): Promise<GetInputResponse>;
   /**
-   * Decodes the raw body from an API Gateway event.
-   * Uses Content-Type to decide parsing strategy (like Express/Fastify/Hono):
-   * - `application/json` (or missing) → JSON.parse the decoded string
-   * - Anything else → return decoded string as-is, let the schema handle it
+   * Decodes the raw body from an API Gateway event — base64 when API
+   * Gateway says so — and reads it by its Content-Type, as every adaptor
+   * does (see {@link readRequestBody}): JSON, an HTML form's fields, or text.
    *
-   * Defaults to JSON when no Content-Type is provided for backwards compatibility.
+   * A body with no Content-Type is read as JSON, as it always has been here.
    */
-  static decodeBody(body: string | undefined | null, isBase64Encoded: boolean | undefined, contentType: string | undefined): any;
+  static decodeBody(body: string | undefined | null, isBase64Encoded: boolean | undefined, contentType: string | undefined): Promise<unknown>;
+  /**
+   * The event's body, read only for an endpoint with a `.body()` schema —
+   * one without is handed no body, and is not refused a content type it
+   * never reads.
+   */
+  protected readBody(body: string | undefined | null, isBase64Encoded: boolean | undefined, contentType: string | undefined): Promise<unknown>;
   protected getCookies(e: TEvent): CookieFn;
   private input;
   abstract getLoggerContext(data: TEvent, context: Context): LoggerContext;
   private logger;
   private services;
   private authorize;
+  /**
+   * The endpoint's `.rateLimit()`, after authorization as on every adaptor:
+   * over the limit it throws a 429, which `error()` answers with its
+   * headers; under it, the `X-RateLimit-*` headers go on the response.
+   */
+  private rateLimit;
+  /** The path the request was made to, as the limiter keys a client by. */
+  private requestPath;
   private database;
   private session;
   private events;
@@ -211,7 +224,7 @@ type HandlerEvent<T extends Function> = T extends ((event: infer E, context: Con
 //#region src/endpoints/AmazonApiGatewayV1EndpointAdaptor.d.ts
 export declare class AmazonApiGatewayV1Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown> extends AmazonApiGatewayEndpoint<AmazonApiGatewayV1EndpointHandler, APIGatewayProxyEvent, TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession> {
   protected readonly endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>;
-  getInput(e: APIGatewayProxyEvent): GetInputResponse;
+  getInput(e: APIGatewayProxyEvent): Promise<GetInputResponse>;
   getLoggerContext(data: APIGatewayProxyEvent, context: Context): LoggerContext;
   constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>, options?: AmazonApiGatewayEndpointOptions);
 }
@@ -220,7 +233,7 @@ export declare class AmazonApiGatewayV1Endpoint<TRoute extends string, TMethod e
 export declare class AmazonApiGatewayV2Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown> extends AmazonApiGatewayEndpoint<AmazonApiGatewayV2EndpointHandler, APIGatewayProxyEventV2, TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession> {
   protected readonly endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>;
   getCookies(e: APIGatewayProxyEventV2): CookieFn;
-  getInput(e: APIGatewayProxyEventV2): GetInputResponse;
+  getInput(e: APIGatewayProxyEventV2): Promise<GetInputResponse>;
   getLoggerContext(event: APIGatewayProxyEventV2, context: Context): LoggerContext;
   constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>, options?: AmazonApiGatewayEndpointOptions);
 }

package/dist/adaptors/aws.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"aws.d.cts","names":["Function","AWSLambdaHandler","Function","AWSLambdaHandler"],"sources":["../../src/functions/FunctionExecutionWrapper.ts","../../src/functions/AWSLambdaFunction.ts","../../src/crons/AWSScheduledFunction.ts","../../src/endpoints/AmazonApiGatewayEndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts","../../src/queue/AWSLambdaQueueAdaptor.ts","../../src/subscribers/AWSLambdaSubscriberAdaptor.ts"],"mappings":"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C,QACA,SACA,QACA,YACA,WACA,SACA;EA1DO,SAAS,GAAG,uBAAuB;EAgCnC,iBACR,MAAM,sBACN,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;qBC9EE,2BACZ,uBACA,gBAAgB,YAChB,eAAe,sBACf,mBAAmB,0CACnB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,4BACS,yBACT,mCACA,wBACA,QACA,SACA,QACA,YACA,WACA,SACA;qBAyC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA;EA9CO,WAAW,GAAG,yBAAyB;EAOvC,SAAS,GAAG,yBAAyB;EAarC,iBACR,OAAO,wBACP,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;KClECE,mBAAiB,cAAc,iBAAiB,QAC3D,QACA;;;;;;;;;;;;qBAcY,eACZ,+BACA,iBAAiB,mBAAmB,kBACpC,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,uBACA;mBAKkB;WACR,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;UAVM;EAER,YACkB,WAAW,uBACnB,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;MAIE,UAAU;UAIA;;UAkBA;UAaN;;;;;UAYA;UAQM;MAsEV,WAAWA,mBAAiB,UAAU;;;;KCnK/B,iBAAiB,cAAc,iBAAiB,QAC3D,QACA;qBAsBY,oBACZ,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,wBAAwB,6CACxB,sCACA,uBACA;UAKS;WACC,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;UAXM;EAER,YACS,WAAW,uBACV,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;MAME,UAAU;UAIN;UAYA;UAmBA;UAaA;UAkBM;MAWV,WAAW"}
+{"version":3,"file":"aws.d.cts","names":["Function","AWSLambdaHandler","Function","AWSLambdaHandler"],"sources":["../../src/functions/FunctionExecutionWrapper.ts","../../src/functions/AWSLambdaFunction.ts","../../src/crons/AWSScheduledFunction.ts","../../src/endpoints/AmazonApiGatewayEndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts","../../src/queue/AWSLambdaQueueAdaptor.ts","../../src/subscribers/AWSLambdaSubscriberAdaptor.ts"],"mappings":"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,mCACA,sBACA,QACA,SACA,QACA,YACA,WACA,SACA;qBAqD6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA;EA1Da,SAAS,GAAG,uBAAuB,QAAQ;EAgCjD,iBACR,MAAM,sBACN,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;qBC9EE,2BACZ,uBACA,gBAAgB,YAChB,eAAe,sBACf,mBAAmB,0CACnB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,4BACS,yBACT,mCACA,wBACA,QACA,SACA,QACA,YACA,WACA,SACA;qBA2C6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA;EAhDO,WAAW,GAAG,yBAAyB;EAOjC,SACd,GAAG,yBACD,QAAQ;EAaF,iBACR,OAAO,wBACP,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;KCpECE,mBAAiB,cAAc,iBAAiB,QAC3D,QACA;;;;;;;;;;;;qBAcY,eACZ,+BACA,iBAAiB,mBAAmB,kBACpC,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,uBACA;mBAKkB;WACR,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;UAVM;EAER,YACkB,WAAW,uBACnB,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;MAIE,UAAU;UAIA;;UAkBA;UAaN;;;;;UAYA;UAQM;MAsEV,WAAWA,mBAAiB,UAAU;;;;KCnK/B,iBAAiB,cAAc,iBAAiB,QAC3D,QACA;qBAsBY,oBACZ,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,wBAAwB,6CACxB,sCACA,uBACA;UAKS;WACC,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;UAXM;EAER,YACS,WAAW,uBACV,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;MAME,UAAU;UAIN;UAYA;UAmBA;UAaA;UAkBM;MAWV,WAAW"}

package/dist/adaptors/aws.d.mts

@@ -2,7 +2,7 @@ import { t as StandardSchemaV1 } from "../index-CeEtxDmK.mjs";
 import { i as FunctionHandler, n as Function$1 } from "../Function-DuqGcbOI.mjs";
 import { t as Cron } from "../Cron-uYAHPnp7.mjs";
 import { t as HttpMethod } from "../types-DMuSQeLL.mjs";
-import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-Du-NwPX2.mjs";
+import { c as EndpointSchemas, i as Endpoint, r as CookieFn } from "../Endpoint-C3r2OzOD.mjs";
 import { t as Telemetry } from "../lambdaTelemetry-8vnmVZQ5.mjs";
 import { t as Queue } from "../Queue-DlsHRzUp.mjs";
 import { t as Subscriber } from "../Subscriber-CtN9R48-.mjs";
@@ -154,22 +154,35 @@ declare abstract class AmazonApiGatewayEndpoint<THandler extends AmazonApiGatewa
   protected envParser: EnvironmentParser<{}>;
   constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession, TAuditStorage, TAuditStorageServiceName, TAuditAction>, options?: AmazonApiGatewayEndpointOptions);
   private error;
-  abstract getInput(e: TEvent): GetInputResponse;
+  abstract getInput(e: TEvent): Promise<GetInputResponse>;
   /**
-   * Decodes the raw body from an API Gateway event.
-   * Uses Content-Type to decide parsing strategy (like Express/Fastify/Hono):
-   * - `application/json` (or missing) → JSON.parse the decoded string
-   * - Anything else → return decoded string as-is, let the schema handle it
+   * Decodes the raw body from an API Gateway event — base64 when API
+   * Gateway says so — and reads it by its Content-Type, as every adaptor
+   * does (see {@link readRequestBody}): JSON, an HTML form's fields, or text.
    *
-   * Defaults to JSON when no Content-Type is provided for backwards compatibility.
+   * A body with no Content-Type is read as JSON, as it always has been here.
    */
-  static decodeBody(body: string | undefined | null, isBase64Encoded: boolean | undefined, contentType: string | undefined): any;
+  static decodeBody(body: string | undefined | null, isBase64Encoded: boolean | undefined, contentType: string | undefined): Promise<unknown>;
+  /**
+   * The event's body, read only for an endpoint with a `.body()` schema —
+   * one without is handed no body, and is not refused a content type it
+   * never reads.
+   */
+  protected readBody(body: string | undefined | null, isBase64Encoded: boolean | undefined, contentType: string | undefined): Promise<unknown>;
   protected getCookies(e: TEvent): CookieFn;
   private input;
   abstract getLoggerContext(data: TEvent, context: Context): LoggerContext;
   private logger;
   private services;
   private authorize;
+  /**
+   * The endpoint's `.rateLimit()`, after authorization as on every adaptor:
+   * over the limit it throws a 429, which `error()` answers with its
+   * headers; under it, the `X-RateLimit-*` headers go on the response.
+   */
+  private rateLimit;
+  /** The path the request was made to, as the limiter keys a client by. */
+  private requestPath;
   private database;
   private session;
   private events;
@@ -211,7 +224,7 @@ type HandlerEvent<T extends Function> = T extends ((event: infer E, context: Con
 //#region src/endpoints/AmazonApiGatewayV1EndpointAdaptor.d.ts
 export declare class AmazonApiGatewayV1Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown> extends AmazonApiGatewayEndpoint<AmazonApiGatewayV1EndpointHandler, APIGatewayProxyEvent, TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession> {
   protected readonly endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>;
-  getInput(e: APIGatewayProxyEvent): GetInputResponse;
+  getInput(e: APIGatewayProxyEvent): Promise<GetInputResponse>;
   getLoggerContext(data: APIGatewayProxyEvent, context: Context): LoggerContext;
   constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>, options?: AmazonApiGatewayEndpointOptions);
 }
@@ -220,7 +233,7 @@ export declare class AmazonApiGatewayV1Endpoint<TRoute extends string, TMethod e
 export declare class AmazonApiGatewayV2Endpoint<TRoute extends string, TMethod extends HttpMethod, TInput extends EndpointSchemas = {}, TOutSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TSession = unknown> extends AmazonApiGatewayEndpoint<AmazonApiGatewayV2EndpointHandler, APIGatewayProxyEventV2, TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession> {
   protected readonly endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>;
   getCookies(e: APIGatewayProxyEventV2): CookieFn;
-  getInput(e: APIGatewayProxyEventV2): GetInputResponse;
+  getInput(e: APIGatewayProxyEventV2): Promise<GetInputResponse>;
   getLoggerContext(event: APIGatewayProxyEventV2, context: Context): LoggerContext;
   constructor(endpoint: Endpoint<TRoute, TMethod, TInput, TOutSchema, TServices, TLogger, TSession>, options?: AmazonApiGatewayEndpointOptions);
 }

package/dist/adaptors/aws.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"aws.d.mts","names":["Function","AWSLambdaHandler","Function","AWSLambdaHandler"],"sources":["../../src/functions/FunctionExecutionWrapper.ts","../../src/functions/AWSLambdaFunction.ts","../../src/crons/AWSScheduledFunction.ts","../../src/endpoints/AmazonApiGatewayEndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts","../../src/queue/AWSLambdaQueueAdaptor.ts","../../src/subscribers/AWSLambdaSubscriberAdaptor.ts"],"mappings":"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C,QACA,SACA,QACA,YACA,WACA,SACA;EA1DO,SAAS,GAAG,uBAAuB;EAgCnC,iBACR,MAAM,sBACN,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;qBC9EE,2BACZ,uBACA,gBAAgB,YAChB,eAAe,sBACf,mBAAmB,0CACnB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,4BACS,yBACT,mCACA,wBACA,QACA,SACA,QACA,YACA,WACA,SACA;qBAyC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA;EA9CO,WAAW,GAAG,yBAAyB;EAOvC,SAAS,GAAG,yBAAyB;EAarC,iBACR,OAAO,wBACP,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;KClECE,mBAAiB,cAAc,iBAAiB,QAC3D,QACA;;;;;;;;;;;;qBAcY,eACZ,+BACA,iBAAiB,mBAAmB,kBACpC,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,uBACA;mBAKkB;WACR,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;UAVM;EAER,YACkB,WAAW,uBACnB,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;MAIE,UAAU;UAIA;;UAkBA;UAaN;;;;;UAYA;UAQM;MAsEV,WAAWA,mBAAiB,UAAU;;;;KCnK/B,iBAAiB,cAAc,iBAAiB,QAC3D,QACA;qBAsBY,oBACZ,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,wBAAwB,6CACxB,sCACA,uBACA;UAKS;WACC,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;UAXM;EAER,YACS,WAAW,uBACV,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;MAME,UAAU;UAIN;UAYA;UAmBA;UAaA;UAkBM;MAWV,WAAW"}
+{"version":3,"file":"aws.d.mts","names":["Function","AWSLambdaHandler","Function","AWSLambdaHandler"],"sources":["../../src/functions/FunctionExecutionWrapper.ts","../../src/functions/AWSLambdaFunction.ts","../../src/crons/AWSScheduledFunction.ts","../../src/endpoints/AmazonApiGatewayEndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts","../../src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts","../../src/queue/AWSLambdaQueueAdaptor.ts","../../src/subscribers/AWSLambdaSubscriberAdaptor.ts"],"mappings":"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,mCACA,sBACA,QACA,SACA,QACA,YACA,WACA,SACA;qBAqD6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA;EA1Da,SAAS,GAAG,uBAAuB,QAAQ;EAgCjD,iBACR,MAAM,sBACN,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;qBC9EE,2BACZ,uBACA,gBAAgB,YAChB,eAAe,sBACf,mBAAmB,0CACnB,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,4BACS,yBACT,mCACA,wBACA,QACA,SACA,QACA,YACA,WACA,SACA;qBA2C6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA;EAhDO,WAAW,GAAG,yBAAyB;EAOjC,SACd,GAAG,yBACD,QAAQ;EAaF,iBACR,OAAO,wBACP,SAAS,UACP;EAeH,YAC6B,UAAU,SACrC,QACA,SACA,QACA,YACA,WACA,SACA,WAED,UAAS;;;;KCpECE,mBAAiB,cAAc,iBAAiB,QAC3D,QACA;;;;;;;;;;;;qBAcY,eACZ,+BACA,iBAAiB,mBAAmB,kBACpC,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,uBACA;mBAKkB;WACR,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;UAVM;EAER,YACkB,WAAW,uBACnB,OAAO,MACf,OACA,UACA,WACA,SACA,WACA;MAIE,UAAU;UAIA;;UAkBA;UAaN;;;;;UAYA;UAQM;MAsEV,WAAWA,mBAAiB,UAAU;;;;KCnK/B,iBAAiB,cAAc,iBAAiB,QAC3D,QACA;qBAsBY,oBACZ,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,wBAAwB,6CACxB,sCACA,uBACA;UAKS;WACC,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;UAXM;EAER,YACS,WAAW,uBACV,YAAY,WACpB,WACA,SACA,WACA,iBACA,mBACA,WACA;MAME,UAAU;UAIN;UAYA;UAmBA;UAaA;UAkBM;MAWV,WAAW"}

package/dist/adaptors/aws.mjs

@@ -1,11 +1,11 @@
 import { o as __toESM } from "../Construct-B1vGBPme.mjs";
 import { n as recordCarrier } from "../tracing-CxaZ98IB.mjs";
 import { a as publishEvents, i as publishConstructEvents, t as FunctionBuilder } from "../functions-BFizikJU.mjs";
-import { i as require_lodash_set, n as ResponseBuilder, t as Endpoint } from "../Endpoint-BG4UJ9oA.mjs";
+import { o as require_lodash_set, r as ResponseBuilder, t as Endpoint } from "../Endpoint-BW-nFdL_.mjs";
 import { n as envParserFor } from "../surfaceEnv-wMT5QzgZ.mjs";
-import { t as createApiGatewayCookies } from "../lazyAccessors-CFanua0O.mjs";
+import { a as createApiGatewayCookies, i as readRequestBody } from "../readRequestBody-BTIl3k-D.mjs";
 import { n as subscribedEvents, r as subscriberContext, t as runSubscriber } from "../runSubscriber-BHvJ8POr.mjs";
-import { n as executeWithAuditTransaction, t as createAuditContext } from "../processAudits-BRRVVHUB.mjs";
+import { n as createAuditContext, r as executeWithAuditTransaction, t as enforceRateLimit } from "../rateLimit-DbOTsP01.mjs";
 import { consumeBatchTraced } from "@geekmidas/events";
 import { ForbiddenError, UnprocessableEntityError, wrapError } from "@geekmidas/errors";
 import { ServiceDiscovery, runWithRequestContext } from "@geekmidas/services";
@@ -239,7 +239,7 @@ var AWSScheduledFunction = class extends AWSLambdaFunction {
 //#endregion
 //#region src/endpoints/AmazonApiGatewayEndpointAdaptor.ts
 var import_lodash_set = /* @__PURE__ */ __toESM(require_lodash_set(), 1);
-var AmazonApiGatewayEndpoint = class {
+var AmazonApiGatewayEndpoint = class AmazonApiGatewayEndpoint {
 	endpoint;
 	options;
 	/**
@@ -263,23 +263,36 @@ var AmazonApiGatewayEndpoint = class {
 			const wrappedError = wrapError(req.error);
 			req.response = {
 				statusCode: wrappedError.statusCode,
-				body: wrappedError.body
+				body: wrappedError.body,
+				...wrappedError.headers ? { headers: { ...wrappedError.headers } } : {}
 			};
 		} };
 	}
 	/**
-	* Decodes the raw body from an API Gateway event.
-	* Uses Content-Type to decide parsing strategy (like Express/Fastify/Hono):
-	* - `application/json` (or missing) → JSON.parse the decoded string
-	* - Anything else → return decoded string as-is, let the schema handle it
+	* Decodes the raw body from an API Gateway event — base64 when API
+	* Gateway says so — and reads it by its Content-Type, as every adaptor
+	* does (see {@link readRequestBody}): JSON, an HTML form's fields, or text.
 	*
-	* Defaults to JSON when no Content-Type is provided for backwards compatibility.
+	* A body with no Content-Type is read as JSON, as it always has been here.
 	*/
-	static decodeBody(body, isBase64Encoded, contentType) {
+	static async decodeBody(body, isBase64Encoded, contentType) {
 		if (!body) return void 0;
-		const raw = isBase64Encoded ? Buffer.from(body, "base64").toString("utf-8") : body;
-		if (!contentType || contentType.toLowerCase().includes("application/json")) return JSON.parse(raw);
-		return raw;
+		const bytes = Buffer.from(body, isBase64Encoded ? "base64" : "utf-8");
+		const request = new Request("http://api-gateway.invalid/", {
+			method: "POST",
+			headers: contentType ? { "content-type": contentType } : {},
+			body: bytes
+		});
+		return readRequestBody(request, contentType, { untyped: "json" });
+	}
+	/**
+	* The event's body, read only for an endpoint with a `.body()` schema —
+	* one without is handed no body, and is not refused a content type it
+	* never reads.
+	*/
+	readBody(body, isBase64Encoded, contentType) {
+		if (!this.endpoint.input?.body) return Promise.resolve(void 0);
+		return AmazonApiGatewayEndpoint.decodeBody(body, isBase64Encoded, contentType);
 	}
 	getCookies(e) {
 		const headers = e.headers;
@@ -288,7 +301,7 @@ var AmazonApiGatewayEndpoint = class {
 	input() {
 		return { before: async (req) => {
 			try {
-				const { body, query, params } = this.getInput(req.event);
+				const { body, query, params } = await this.getInput(req.event);
 				const headers = req.event.headers;
 				const header = Endpoint.createHeaders(headers);
 				const cookie = this.getCookies(req.event);
@@ -343,6 +356,28 @@ var AmazonApiGatewayEndpoint = class {
 			}
 		} };
 	}
+	/**
+	* The endpoint's `.rateLimit()`, after authorization as on every adaptor:
+	* over the limit it throws a 429, which `error()` answers with its
+	* headers; under it, the `X-RateLimit-*` headers go on the response.
+	*/
+	rateLimit() {
+		return { before: async (req) => {
+			if (!this.endpoint.rateLimit) return;
+			req.event.rateLimitHeaders = await enforceRateLimit(this.endpoint.rateLimit, {
+				header: req.event.header,
+				services: req.event.services,
+				logger: req.event.logger,
+				session: req.event.session,
+				path: this.requestPath(req.event),
+				method: this.endpoint.method
+			});
+		} };
+	}
+	/** The path the request was made to, as the limiter keys a client by. */
+	requestPath(event) {
+		return event.path ?? event.rawPath ?? this.endpoint.route;
+	}
 	database() {
 		return { before: async (req) => {
 			if (!this.endpoint.databaseService) return;
@@ -418,16 +453,18 @@ var AmazonApiGatewayEndpoint = class {
 					data = response.data;
 					metadata = response.metadata;
 				}
+				const redirect = Endpoint.isRedirectStatus(metadata.status ?? this.endpoint.status);
 				return {
-					output: this.endpoint.outputSchema ? await this.endpoint.parseOutput(data) : void 0,
+					output: this.endpoint.outputSchema && !redirect ? await this.endpoint.parseOutput(data) : void 0,
 					metadata,
-					responseBuilder
+					responseBuilder,
+					redirect
 				};
 			};
 			if (rlsActive && rlsContext && baseDb) return withRlsContext(baseDb, rlsContext, async (trx) => executeHandler(trx), { prefix: this.endpoint.rlsConfig?.prefix });
 			return executeHandler(baseDb);
 		}, async (result, auditor) => {
-			if (!audits?.length) return;
+			if (!audits?.length || result.redirect) return;
 			for (const audit of audits) {
 				if (audit.when && !audit.when(result.output)) continue;
 				const payload = audit.payload(result.output);
@@ -446,8 +483,10 @@ var AmazonApiGatewayEndpoint = class {
 			body
 		};
 		const baseHeaders = isJsonResponse ? void 0 : { "content-type": this.endpoint.responseType };
-		if (baseHeaders || metadata.headers && Object.keys(metadata.headers).length > 0) lambdaResponse.headers = {
+		const rateLimitHeaders = event.rateLimitHeaders;
+		if (baseHeaders || rateLimitHeaders || metadata.headers && Object.keys(metadata.headers).length > 0) lambdaResponse.headers = {
 			...baseHeaders ?? {},
+			...rateLimitHeaders ?? {},
 			...metadata.headers ?? {}
 		};
 		if (metadata.cookies && metadata.cookies.size > 0) {
@@ -488,7 +527,7 @@ var AmazonApiGatewayEndpoint = class {
 	}
 	get handler() {
 		const handler = this._handler.bind(this);
-		let chain = middy(handler).use(this.logger()).use(this.error()).use(this.services()).use(this.input()).use(this.database()).use(this.session()).use(this.authorize()).use(this.events());
+		let chain = middy(handler).use(this.logger()).use(this.error()).use(this.services()).use(this.input()).use(this.database()).use(this.session()).use(this.authorize()).use(this.rateLimit()).use(this.events());
 		const telemetryMiddleware = this.telemetry();
 		if (telemetryMiddleware) chain = chain.use(telemetryMiddleware);
 		if (this.options.telescope?.middleware) chain = chain.use(this.options.telescope.middleware);
@@ -531,14 +570,14 @@ function parseQueryParams(queryParams) {
 //#region src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts
 var AmazonApiGatewayV1Endpoint = class extends AmazonApiGatewayEndpoint {
 	endpoint;
-	getInput(e) {
+	async getInput(e) {
 		const multiValueParams = e.multiValueQueryStringParameters || {};
 		const singleValueParams = e.queryStringParameters || {};
 		const mergedParams = {};
 		for (const [key, value] of Object.entries(singleValueParams)) if (value !== void 0) mergedParams[key] = value;
 		for (const [key, values] of Object.entries(multiValueParams)) if (values && values.length > 1) mergedParams[key] = values;
 		return {
-			body: AmazonApiGatewayEndpoint.decodeBody(e.body, e.isBase64Encoded, e.headers?.["Content-Type"] ?? e.headers?.["content-type"]),
+			body: await this.readBody(e.body, e.isBase64Encoded, e.headers?.["Content-Type"] ?? e.headers?.["content-type"]),
 			query: parseQueryParams(mergedParams),
 			params: e.pathParameters || {}
 		};
@@ -570,9 +609,9 @@ var AmazonApiGatewayV2Endpoint = class extends AmazonApiGatewayEndpoint {
 	getCookies(e) {
 		return createApiGatewayCookies(e.cookies, e.headers?.cookie);
 	}
-	getInput(e) {
+	async getInput(e) {
 		return {
-			body: AmazonApiGatewayEndpoint.decodeBody(e.body, e.isBase64Encoded, e.headers?.["content-type"]),
+			body: await this.readBody(e.body, e.isBase64Encoded, e.headers?.["content-type"]),
 			query: qs.parse(e.rawQueryString),
 			params: e.pathParameters || {}
 		};