@jaypie/express 1.2.3 → 1.2.4-rc0

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

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1 @@
+export {};

package/dist/esm/adapter/__tests__/integration.spec.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,50 @@
+import type { Application } from "express";
+import type { CreateLambdaHandlerOptions, FunctionUrlEvent, LambdaContext, LambdaHandler, LambdaStreamHandler } from "./types.js";
+/**
+ * Get the current Lambda invoke context.
+ * Used by getCurrentInvokeUuid adapter to get the request ID.
+ */
+export declare function getCurrentInvoke(): {
+    context: LambdaContext;
+    event: FunctionUrlEvent;
+} | null;
+/**
+ * Create a Lambda handler that buffers the Express response.
+ * Returns the complete response as a Lambda response object.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { createLambdaHandler } from "@jaypie/express";
+ *
+ * const app = express();
+ * app.get("/", (req, res) => res.json({ message: "Hello" }));
+ *
+ * export const handler = createLambdaHandler(app);
+ * ```
+ */
+export declare function createLambdaHandler(app: Application, _options?: CreateLambdaHandlerOptions): LambdaHandler;
+/**
+ * Create a Lambda handler that streams the Express response.
+ * Uses awslambda.streamifyResponse() for Lambda response streaming.
+ *
+ * @example
+ * ```typescript
+ * import express from "express";
+ * import { createLambdaStreamHandler } from "@jaypie/express";
+ *
+ * const app = express();
+ * app.get("/stream", (req, res) => {
+ *   res.setHeader("Content-Type", "text/event-stream");
+ *   res.write("data: Hello\n\n");
+ *   res.end();
+ * });
+ *
+ * export const handler = createLambdaStreamHandler(app);
+ * ```
+ */
+export declare function createLambdaStreamHandler(app: Application, _options?: CreateLambdaHandlerOptions): LambdaStreamHandler;
+export { LambdaRequest, createLambdaRequest } from "./LambdaRequest.js";
+export { LambdaResponseBuffered } from "./LambdaResponseBuffered.js";
+export { LambdaResponseStreaming } from "./LambdaResponseStreaming.js";
+export type { AwsLambdaGlobal, CreateLambdaHandlerOptions, FunctionUrlEvent, HttpResponseStreamMetadata, LambdaContext, LambdaHandler, LambdaHandlerFactory, LambdaResponse, LambdaStreamHandler, LambdaStreamHandlerFactory, ResponseStream, } from "./types.js";

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

@@ -0,0 +1,75 @@
+import type { Application } from "express";
+export interface LambdaContext {
+    awsRequestId: string;
+    callbackWaitsForEmptyEventLoop?: boolean;
+    functionName?: string;
+    functionVersion?: string;
+    invokedFunctionArn?: string;
+    logGroupName?: string;
+    logStreamName?: string;
+    memoryLimitInMB?: string;
+    [key: string]: unknown;
+}
+export interface FunctionUrlEvent {
+    body?: string;
+    cookies?: string[];
+    headers: Record<string, string>;
+    isBase64Encoded: boolean;
+    rawPath: string;
+    rawQueryString: string;
+    requestContext: {
+        accountId: string;
+        apiId: string;
+        domainName: string;
+        domainPrefix: string;
+        http: {
+            method: string;
+            path: string;
+            protocol: string;
+            sourceIp: string;
+            userAgent: string;
+        };
+        requestId: string;
+        routeKey: string;
+        stage: string;
+        time: string;
+        timeEpoch: number;
+    };
+    routeKey: string;
+    version: "2.0";
+}
+export interface LambdaResponse {
+    body: string;
+    cookies?: string[];
+    headers: Record<string, string>;
+    isBase64Encoded: boolean;
+    statusCode: number;
+}
+export interface ResponseStream {
+    end(): void;
+    write(chunk: string | Uint8Array): void;
+}
+export interface HttpResponseStreamMetadata {
+    headers: Record<string, string>;
+    statusCode: number;
+}
+/**
+ * Global awslambda object provided by Lambda runtime.
+ * This is only available when running in AWS Lambda.
+ */
+export interface AwsLambdaGlobal {
+    HttpResponseStream: {
+        from(stream: ResponseStream, metadata: HttpResponseStreamMetadata): ResponseStream;
+    };
+    streamifyResponse<TEvent = unknown>(handler: (event: TEvent, responseStream: ResponseStream, context: LambdaContext) => Promise<void>): (event: TEvent, context: LambdaContext) => Promise<void>;
+}
+export type LambdaHandler = (event: FunctionUrlEvent, context: LambdaContext) => Promise<LambdaResponse>;
+export type LambdaStreamHandler = (event: FunctionUrlEvent, context: LambdaContext) => Promise<void>;
+export type CreateLambdaHandlerOptions = {
+    /**
+     * Optional name for logging and debugging
+     */
+    name?: string;
+};
+export type LambdaHandlerFactory = (app: Application, options?: CreateLambdaHandlerOptions) => LambdaHandler;
+export type LambdaStreamHandlerFactory = (app: Application, options?: CreateLambdaHandlerOptions) => LambdaStreamHandler;

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

@@ -1,10 +1,10 @@
 import type { Request } from "express";
 /**
  * Get the current invoke UUID from Lambda context.
- * Works in both serverless-express mode and Lambda Web Adapter mode.
+ * Works with Jaypie Lambda adapter and Lambda Web Adapter mode.
  *
- * @param req - Optional Express request object. Required for Web Adapter mode
- *              to extract the x-amzn-request-id header.
+ * @param req - Optional Express request object. Used to extract context
+ *              from Web Adapter headers or Jaypie adapter's _lambdaContext.
  * @returns The AWS request ID or undefined if not in Lambda context
  */
 declare function getCurrentInvokeUuid(req?: Request): string | undefined;

package/dist/esm/index.d.ts

@@ -1,12 +1,14 @@
+export { createLambdaHandler, createLambdaStreamHandler, getCurrentInvoke, LambdaRequest, LambdaResponseBuffered, LambdaResponseStreaming, } from "./adapter/index.js";
+export type { CreateLambdaHandlerOptions, FunctionUrlEvent, LambdaHandler, LambdaResponse, LambdaStreamHandler, } 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 { default as createServer } from "./createServer.js";
 export type { CreateServerOptions, ServerResult } from "./createServer.js";
 export { default as expressHandler } from "./expressHandler.js";
 export type { ExpressHandlerLocals, ExpressHandlerOptions, JaypieHandlerSetup, JaypieHandlerTeardown, JaypieHandlerValidate, } from "./expressHandler.js";
+export { default as expressHttpCodeHandler } from "./http.handler.js";
 export { default as expressStreamHandler } from "./expressStreamHandler.js";
 export type { ExpressStreamHandler, ExpressStreamHandlerLocals, ExpressStreamHandlerOptions, JaypieStreamHandlerSetup, JaypieStreamHandlerTeardown, JaypieStreamHandlerValidate, } from "./expressStreamHandler.js";
-export type { CorsConfig } from "./cors.helper.js";
 export { default as getCurrentInvokeUuid } from "./getCurrentInvokeUuid.adapter.js";
-export { default as expressHttpCodeHandler } from "./http.handler.js";
 export * from "./routes.js";