@jaypie/express 1.2.33 → 1.2.35

package/dist/cjs/index.d.cts

@@ -178,6 +178,13 @@ declare class LambdaResponseBuffered extends Writable {
      */
     get headers(): Record<string, string | string[] | undefined>;
     writeHead(statusCode: number, statusMessageOrHeaders?: OutgoingHttpHeaders | string, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader(): void;
     get headersSent(): boolean;
     /**
      * Express-style alias for getHeader().
@@ -241,8 +248,16 @@ declare class LambdaResponseStreaming extends Writable {
      */
     get headers(): Record<string, string | string[] | undefined>;
     writeHead(statusCode: number, statusMessageOrHeaders?: OutgoingHttpHeaders | string, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader(): void;
     get headersSent(): boolean;
     flushHeaders(): void;
+    private _commitHeaders;
     /**
      * Express-style alias for getHeader().
      * Used by middleware like decorateResponse that use res.get().
@@ -322,8 +337,9 @@ declare const EXPRESS: {
     };
 };
 
+type CorsOrigin = string | RegExp | Array<string | RegExp>;
 interface CorsConfig {
-    origin?: string | string[];
+    origin?: CorsOrigin;
     overrides?: Record<string, unknown>;
 }
 /**
@@ -458,4 +474,4 @@ declare const notFoundRoute: (req: express.Request, res: express.Response) => Pr
 declare const notImplementedRoute: (req: express.Request, res: express.Response, ...params: unknown[]) => Promise<unknown>;
 
 export { EXPRESS, LambdaRequest, LambdaResponseBuffered, LambdaResponseStreaming, badRequestRoute, _default as cors, createLambdaHandler, createLambdaStreamHandler, echoRoute, expressHandler, httpHandler as expressHttpCodeHandler, expressStreamHandler, fabricApiResponse, forbiddenRoute, getCurrentInvoke, getCurrentInvokeUuid, goneRoute, methodNotAllowedRoute, noContentRoute, notFoundRoute, notImplementedRoute };
-export type { ApiGatewayV1Event, CorsConfig, CreateLambdaHandlerOptions, ExpressHandlerLocals, ExpressHandlerOptions, ExpressStreamHandler, ExpressStreamHandlerLocals, ExpressStreamHandlerOptions, FunctionUrlEvent, JaypieHandlerSetup, JaypieHandlerTeardown, JaypieHandlerValidate, JaypieStreamHandlerSetup, JaypieStreamHandlerTeardown, JaypieStreamHandlerValidate, LambdaContext, LambdaEvent, LambdaHandler, LambdaResponse, LambdaStreamHandler, ResponseStream };
+export type { ApiGatewayV1Event, CorsConfig, CorsOrigin, CreateLambdaHandlerOptions, ExpressHandlerLocals, ExpressHandlerOptions, ExpressStreamHandler, ExpressStreamHandlerLocals, ExpressStreamHandlerOptions, FunctionUrlEvent, JaypieHandlerSetup, JaypieHandlerTeardown, JaypieHandlerValidate, JaypieStreamHandlerSetup, JaypieStreamHandlerTeardown, JaypieStreamHandlerValidate, LambdaContext, LambdaEvent, LambdaHandler, LambdaResponse, LambdaStreamHandler, ResponseStream };

package/dist/cjs/index.d.ts

@@ -2,7 +2,7 @@ export { createLambdaHandler, createLambdaStreamHandler, getCurrentInvoke, Lambd
 export type { ApiGatewayV1Event, CreateLambdaHandlerOptions, FunctionUrlEvent, LambdaContext, LambdaEvent, LambdaHandler, LambdaResponse, LambdaStreamHandler, ResponseStream, } from "./adapter/index.js";
 export { EXPRESS } from "./constants.js";
 export { default as cors } from "./cors.helper.js";
-export type { CorsConfig } from "./cors.helper.js";
+export type { CorsConfig, CorsOrigin } from "./cors.helper.js";
 export { default as fabricApiResponse } from "./fabricApiResponse.js";
 export { default as expressHandler } from "./expressHandler.js";
 export type { ExpressHandlerLocals, ExpressHandlerOptions, JaypieHandlerSetup, JaypieHandlerTeardown, JaypieHandlerValidate, } from "./expressHandler.js";

package/dist/esm/adapter/LambdaResponseBuffered.d.ts

@@ -36,6 +36,13 @@ export declare class LambdaResponseBuffered extends Writable {
      */
     get headers(): Record<string, string | string[] | undefined>;
     writeHead(statusCode: number, statusMessageOrHeaders?: OutgoingHttpHeaders | string, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader(): void;
     get headersSent(): boolean;
     /**
      * Express-style alias for getHeader().

package/dist/esm/adapter/LambdaResponseStreaming.d.ts

@@ -36,8 +36,16 @@ export declare class LambdaResponseStreaming extends Writable {
      */
     get headers(): Record<string, string | string[] | undefined>;
     writeHead(statusCode: number, statusMessageOrHeaders?: OutgoingHttpHeaders | string, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader(): void;
     get headersSent(): boolean;
     flushHeaders(): void;
+    private _commitHeaders;
     /**
      * Express-style alias for getHeader().
      * Used by middleware like decorateResponse that use res.get().

package/dist/esm/cors.helper.d.ts

@@ -1,10 +1,11 @@
 import type { Request, Response, NextFunction } from "express";
+export type CorsOrigin = string | RegExp | Array<string | RegExp>;
 export interface CorsConfig {
-    origin?: string | string[];
+    origin?: CorsOrigin;
     overrides?: Record<string, unknown>;
 }
 type CorsCallback = (err: Error | null, allow?: boolean) => void;
-export declare const dynamicOriginCallbackHandler: (origin?: string | string[]) => ((requestOrigin: string | undefined, callback: CorsCallback) => void);
+export declare const dynamicOriginCallbackHandler: (origin?: CorsOrigin) => ((requestOrigin: string | undefined, callback: CorsCallback) => void);
 /**
  * CORS middleware with Lambda streaming support.
  *

package/dist/esm/index.d.ts

@@ -178,6 +178,13 @@ declare class LambdaResponseBuffered extends Writable {
      */
     get headers(): Record<string, string | string[] | undefined>;
     writeHead(statusCode: number, statusMessageOrHeaders?: OutgoingHttpHeaders | string, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader(): void;
     get headersSent(): boolean;
     /**
      * Express-style alias for getHeader().
@@ -241,8 +248,16 @@ declare class LambdaResponseStreaming extends Writable {
      */
     get headers(): Record<string, string | string[] | undefined>;
     writeHead(statusCode: number, statusMessageOrHeaders?: OutgoingHttpHeaders | string, headers?: OutgoingHttpHeaders): this;
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader(): void;
     get headersSent(): boolean;
     flushHeaders(): void;
+    private _commitHeaders;
     /**
      * Express-style alias for getHeader().
      * Used by middleware like decorateResponse that use res.get().
@@ -322,8 +337,9 @@ declare const EXPRESS: {
     };
 };
 
+type CorsOrigin = string | RegExp | Array<string | RegExp>;
 interface CorsConfig {
-    origin?: string | string[];
+    origin?: CorsOrigin;
     overrides?: Record<string, unknown>;
 }
 /**
@@ -458,4 +474,4 @@ declare const notFoundRoute: (req: express.Request, res: express.Response) => Pr
 declare const notImplementedRoute: (req: express.Request, res: express.Response, ...params: unknown[]) => Promise<unknown>;
 
 export { EXPRESS, LambdaRequest, LambdaResponseBuffered, LambdaResponseStreaming, badRequestRoute, _default as cors, createLambdaHandler, createLambdaStreamHandler, echoRoute, expressHandler, httpHandler as expressHttpCodeHandler, expressStreamHandler, fabricApiResponse, forbiddenRoute, getCurrentInvoke, getCurrentInvokeUuid, goneRoute, methodNotAllowedRoute, noContentRoute, notFoundRoute, notImplementedRoute };
-export type { ApiGatewayV1Event, CorsConfig, CreateLambdaHandlerOptions, ExpressHandlerLocals, ExpressHandlerOptions, ExpressStreamHandler, ExpressStreamHandlerLocals, ExpressStreamHandlerOptions, FunctionUrlEvent, JaypieHandlerSetup, JaypieHandlerTeardown, JaypieHandlerValidate, JaypieStreamHandlerSetup, JaypieStreamHandlerTeardown, JaypieStreamHandlerValidate, LambdaContext, LambdaEvent, LambdaHandler, LambdaResponse, LambdaStreamHandler, ResponseStream };
+export type { ApiGatewayV1Event, CorsConfig, CorsOrigin, CreateLambdaHandlerOptions, ExpressHandlerLocals, ExpressHandlerOptions, ExpressStreamHandler, ExpressStreamHandlerLocals, ExpressStreamHandlerOptions, FunctionUrlEvent, JaypieHandlerSetup, JaypieHandlerTeardown, JaypieHandlerValidate, JaypieStreamHandlerSetup, JaypieStreamHandlerTeardown, JaypieStreamHandlerValidate, LambdaContext, LambdaEvent, LambdaHandler, LambdaResponse, LambdaStreamHandler, ResponseStream };

package/dist/esm/index.js

@@ -2,7 +2,7 @@ import { flushLlmObs, hasDatadogEnv, submitMetric, DATADOG, loadDatadogApiKey }
 import { Readable, Writable } from 'node:stream';
 import { ServerResponse } from 'node:http';
 import { CorsError, BadRequestError, UnhandledError, GatewayTimeoutError, UnavailableError, BadGatewayError, InternalError, TeapotError, GoneError, MethodNotAllowedError, NotFoundError, ForbiddenError, UnauthorizedError, NotImplementedError } from '@jaypie/errors';
-import { force, envBoolean, JAYPIE, HTTP, getHeaderFrom, jaypieHandler } from '@jaypie/kit';
+import { force, isLocalEnv, envBoolean, JAYPIE, HTTP, getHeaderFrom, jaypieHandler } from '@jaypie/kit';
 import expressCors from 'cors';
 import { loadEnvVariables, loadEnvSecrets, getContentTypeForFormat, formatStreamError } from '@jaypie/aws';
 import { log, redactAuth } from '@jaypie/logger';
@@ -382,6 +382,7 @@ class LambdaResponseBuffered extends Writable {
         this.getHeaders = this.getHeaders.bind(this);
         this.getHeaderNames = this.getHeaderNames.bind(this);
         this.writeHead = this.writeHead.bind(this);
+        this._implicitHeader = this._implicitHeader.bind(this);
         this.get = this.get.bind(this);
         this.set = this.set.bind(this);
         this.status = this.status.bind(this);
@@ -538,6 +539,9 @@ class LambdaResponseBuffered extends Writable {
         });
     }
     writeHead(statusCode, statusMessageOrHeaders, headers) {
+        if (this._headersSent) {
+            return this;
+        }
         this.statusCode = statusCode;
         let headersToSet;
         if (typeof statusMessageOrHeaders === "string") {
@@ -559,6 +563,17 @@ class LambdaResponseBuffered extends Writable {
         this._headersSent = true;
         return this;
     }
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader() {
+        if (!this._headersSent) {
+            this.writeHead(this.statusCode);
+        }
+    }
     get headersSent() {
         return this._headersSent;
     }
@@ -630,11 +645,13 @@ class LambdaResponseBuffered extends Writable {
         const buffer = Buffer.isBuffer(chunk)
             ? chunk
             : Buffer.from(chunk, encoding);
+        this._implicitHeader();
         this._chunks.push(buffer);
         this._headersSent = true;
         callback();
     }
     _final(callback) {
+        this._implicitHeader();
         this._ended = true;
         if (this._resolve) {
             this._resolve(this.buildResult());
@@ -726,6 +743,8 @@ class LambdaResponseStreaming extends Writable {
         this.getHeaderNames = this.getHeaderNames.bind(this);
         this.writeHead = this.writeHead.bind(this);
         this.flushHeaders = this.flushHeaders.bind(this);
+        this._implicitHeader = this._implicitHeader.bind(this);
+        this._commitHeaders = this._commitHeaders.bind(this);
         this.get = this.get.bind(this);
         this.set = this.set.bind(this);
         this.status = this.status.bind(this);
@@ -890,13 +909,27 @@ class LambdaResponseStreaming extends Writable {
                 }
             }
         }
-        this.flushHeaders();
+        this._commitHeaders();
         return this;
     }
+    /**
+     * Node's implicit-header hook, called before the first body byte commits.
+     * Routes through this.writeHead resolved at call time so wrappers installed
+     * mid-request (on-headers, and through it express-session, morgan,
+     * compression, express-openid-connect) run their listeners.
+     */
+    _implicitHeader() {
+        if (!this._headersSent) {
+            this.writeHead(this.statusCode);
+        }
+    }
     get headersSent() {
         return this._headersSent;
     }
     flushHeaders() {
+        this._implicitHeader();
+    }
+    _commitHeaders() {
         if (this._headersSent) {
             return;
         }
@@ -1002,7 +1035,7 @@ class LambdaResponseStreaming extends Writable {
             // Buffer writes until headers are sent
             this._pendingWrites.push({ callback: () => callback(), chunk: buffer });
             // Auto-flush headers on first write
-            this.flushHeaders();
+            this._implicitHeader();
         }
         else {
             this._wrappedStream.write(buffer);
@@ -1010,9 +1043,7 @@ class LambdaResponseStreaming extends Writable {
         }
     }
     _final(callback) {
-        if (!this._headersSent) {
-            this.flushHeaders();
-        }
+        this._implicitHeader();
         // For converted 204 responses, write empty JSON body
         // Lambda streaming requires body content for metadata to be transmitted
         if (this._convertedFrom204 && this._wrappedStream) {
@@ -1268,8 +1299,9 @@ const dynamicOriginCallbackHandler = (origin) => {
             const additionalOrigins = force.array(origin);
             allowedOrigins.push(...additionalOrigins);
         }
-        // Add localhost origins in sandbox
-        if (process.env.PROJECT_ENV === SANDBOX_ENV ||
+        // Add localhost origins in local and sandbox environments
+        if (isLocalEnv() ||
+            process.env.PROJECT_ENV === SANDBOX_ENV ||
             envBoolean("PROJECT_SANDBOX_MODE")) {
             allowedOrigins.push("http://localhost");
             allowedOrigins.push(/^http:\/\/localhost:\d+$/);