@fnd-platform/api 1.0.0-alpha.1

package/lib/middleware/index.js

@@ -0,0 +1,49 @@
+'use strict';
+/**
+ * Middleware exports for @fnd-platform/api.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.withLogging =
+  exports.withCors =
+  exports.withValidation =
+  exports.withAuth =
+  exports.withErrorHandler =
+    void 0;
+var error_handler_1 = require('./error-handler');
+Object.defineProperty(exports, 'withErrorHandler', {
+  enumerable: true,
+  get: function () {
+    return error_handler_1.withErrorHandler;
+  },
+});
+var auth_1 = require('./auth');
+Object.defineProperty(exports, 'withAuth', {
+  enumerable: true,
+  get: function () {
+    return auth_1.withAuth;
+  },
+});
+var validation_1 = require('./validation');
+Object.defineProperty(exports, 'withValidation', {
+  enumerable: true,
+  get: function () {
+    return validation_1.withValidation;
+  },
+});
+var cors_1 = require('./cors');
+Object.defineProperty(exports, 'withCors', {
+  enumerable: true,
+  get: function () {
+    return cors_1.withCors;
+  },
+});
+var logging_1 = require('./logging');
+Object.defineProperty(exports, 'withLogging', {
+  enumerable: true,
+  get: function () {
+    return logging_1.withLogging;
+  },
+});
+//# sourceMappingURL=index.js.map

package/lib/middleware/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iDAAmD;AAA1C,iHAAA,gBAAgB,OAAA;AAGzB,+BAAkC;AAAzB,gGAAA,QAAQ,OAAA;AAGjB,2CAA8C;AAArC,4GAAA,cAAc,OAAA;AAEvB,+BAAkC;AAAzB,gGAAA,QAAQ,OAAA;AAGjB,qCAAwC;AAA/B,sGAAA,WAAW,OAAA"}

package/lib/middleware/logging.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Logging middleware for Lambda handlers.
+ *
+ * @packageDocumentation
+ */
+import type { Middleware } from '../types/middleware';
+/**
+ * Logging configuration options.
+ */
+export interface LoggingOptions {
+  /**
+   * Whether to log request metadata.
+   * @default true
+   */
+  logRequest?: boolean;
+  /**
+   * Whether to log response metadata.
+   * @default true
+   */
+  logResponse?: boolean;
+  /**
+   * Paths to redact from logs (reserved for future use).
+   * @default []
+   */
+  redactPaths?: string[];
+}
+/**
+ * Middleware that logs request and response metadata.
+ *
+ * Logs are written to console in JSON format for CloudWatch integration.
+ *
+ * @param options - Logging configuration
+ * @returns Middleware that logs request/response data
+ *
+ * @example
+ * ```typescript
+ * const handler = compose(
+ *   withLogging({ logRequest: true, logResponse: true }),
+ *   withErrorHandler()
+ * )(async (event) => {
+ *   return success({ data: 'value' });
+ * });
+ * // Logs: {"type":"REQUEST","requestId":"...","method":"GET","path":"/users"}
+ * // Logs: {"type":"RESPONSE","requestId":"...","statusCode":200,"duration":45}
+ * ```
+ */
+export declare function withLogging(options?: LoggingOptions): Middleware;
+//# sourceMappingURL=logging.d.ts.map

package/lib/middleware/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,CAiCpE"}

package/lib/middleware/logging.js

@@ -0,0 +1,58 @@
+'use strict';
+/**
+ * Logging middleware for Lambda handlers.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.withLogging = withLogging;
+/**
+ * Middleware that logs request and response metadata.
+ *
+ * Logs are written to console in JSON format for CloudWatch integration.
+ *
+ * @param options - Logging configuration
+ * @returns Middleware that logs request/response data
+ *
+ * @example
+ * ```typescript
+ * const handler = compose(
+ *   withLogging({ logRequest: true, logResponse: true }),
+ *   withErrorHandler()
+ * )(async (event) => {
+ *   return success({ data: 'value' });
+ * });
+ * // Logs: {"type":"REQUEST","requestId":"...","method":"GET","path":"/users"}
+ * // Logs: {"type":"RESPONSE","requestId":"...","statusCode":200,"duration":45}
+ * ```
+ */
+function withLogging(options = {}) {
+  const { logRequest = true, logResponse = true } = options;
+  return (handler) => async (event, context) => {
+    const startTime = Date.now();
+    const requestId = context.awsRequestId;
+    if (logRequest) {
+      console.log(
+        JSON.stringify({
+          type: 'REQUEST',
+          requestId,
+          method: event.httpMethod,
+          path: event.path,
+        })
+      );
+    }
+    const response = await handler(event, context);
+    if (logResponse) {
+      console.log(
+        JSON.stringify({
+          type: 'RESPONSE',
+          requestId,
+          statusCode: response.statusCode,
+          duration: Date.now() - startTime,
+        })
+      );
+    }
+    return response;
+  };
+}
+//# sourceMappingURL=logging.js.map

package/lib/middleware/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../src/middleware/logging.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AA+CH,kCAiCC;AArDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,WAAW,CAAC,UAA0B,EAAE;IACtD,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAE1D,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC;QAEvC,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,SAAS;gBACf,SAAS;gBACT,MAAM,EAAE,KAAK,CAAC,UAAU;gBACxB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAE/C,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC;gBACb,IAAI,EAAE,UAAU;gBAChB,SAAS;gBACT,UAAU,EAAE,QAAQ,CAAC,UAAU;gBAC/B,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACjC,CAAC,CACH,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/lib/middleware/validation.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Request validation middleware for Lambda handlers.
+ *
+ * @packageDocumentation
+ */
+import type { APIGatewayProxyEvent } from 'aws-lambda';
+import type { ZodSchema } from 'zod';
+import type { Middleware, ValidatedEvent } from '../types/middleware';
+/**
+ * Middleware that validates request body against a Zod schema.
+ *
+ * Parses the JSON body and validates it against the provided schema.
+ * On success, adds the validated and typed body to `event.validatedBody`.
+ *
+ * @typeParam T - The type of the validated body (inferred from schema)
+ * @param schema - Zod schema to validate against
+ * @returns Middleware that validates the request body
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const CreateUserSchema = z.object({
+ *   name: z.string().min(1, 'Name is required'),
+ *   email: z.string().email('Invalid email format'),
+ * });
+ *
+ * const handler = compose(
+ *   withErrorHandler(),
+ *   withValidation(CreateUserSchema)
+ * )(async (event) => {
+ *   // event.validatedBody is typed as { name: string; email: string }
+ *   const { name, email } = event.validatedBody;
+ *   return success({ name, email });
+ * });
+ * ```
+ */
+export declare function withValidation<T>(
+  schema: ZodSchema<T>
+): Middleware<APIGatewayProxyEvent, ValidatedEvent<T>>;
+//# sourceMappingURL=validation.d.ts.map

package/lib/middleware/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/middleware/validation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAY,MAAM,KAAK,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GACnB,UAAU,CAAC,oBAAoB,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,CA0BrD"}

package/lib/middleware/validation.js

@@ -0,0 +1,76 @@
+'use strict';
+/**
+ * Request validation middleware for Lambda handlers.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.withValidation = withValidation;
+const response_1 = require('../lib/response');
+/**
+ * Format Zod validation errors into a human-readable string.
+ *
+ * @param error - Zod validation error
+ * @returns Formatted error message
+ */
+function formatZodError(error) {
+  return error.errors
+    .map((e) => {
+      const path = e.path.length > 0 ? e.path.join('.') : 'body';
+      return `${path}: ${e.message}`;
+    })
+    .join(', ');
+}
+/**
+ * Middleware that validates request body against a Zod schema.
+ *
+ * Parses the JSON body and validates it against the provided schema.
+ * On success, adds the validated and typed body to `event.validatedBody`.
+ *
+ * @typeParam T - The type of the validated body (inferred from schema)
+ * @param schema - Zod schema to validate against
+ * @returns Middleware that validates the request body
+ *
+ * @example
+ * ```typescript
+ * import { z } from 'zod';
+ *
+ * const CreateUserSchema = z.object({
+ *   name: z.string().min(1, 'Name is required'),
+ *   email: z.string().email('Invalid email format'),
+ * });
+ *
+ * const handler = compose(
+ *   withErrorHandler(),
+ *   withValidation(CreateUserSchema)
+ * )(async (event) => {
+ *   // event.validatedBody is typed as { name: string; email: string }
+ *   const { name, email } = event.validatedBody;
+ *   return success({ name, email });
+ * });
+ * ```
+ */
+function withValidation(schema) {
+  return (handler) => async (event, context) => {
+    // Parse body
+    let body;
+    try {
+      body = event.body ? JSON.parse(event.body) : {};
+    } catch {
+      return (0, response_1.badRequest)('Invalid JSON in request body');
+    }
+    // Validate against schema
+    const result = schema.safeParse(body);
+    if (!result.success) {
+      const details = formatZodError(result.error);
+      return (0, response_1.badRequest)(`Validation failed: ${details}`);
+    }
+    // Add validated body to event
+    const validatedEvent = {
+      ...event,
+      validatedBody: result.data,
+    };
+    return handler(validatedEvent, context);
+  };
+}
+//# sourceMappingURL=validation.js.map

package/lib/middleware/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/middleware/validation.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAmDH,wCA4BC;AA1ED,8CAA6C;AAE7C;;;;;GAKG;AACH,SAAS,cAAc,CAAC,KAAe;IACrC,OAAO,KAAK,CAAC,MAAM;SAChB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC3D,OAAO,GAAG,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,cAAc,CAC5B,MAAoB;IAEpB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAC3C,aAAa;QACb,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAA,qBAAU,EAAC,8BAA8B,CAAC,CAAC;QACpD,CAAC;QAED,0BAA0B;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC7C,OAAO,IAAA,qBAAU,EAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;QAED,8BAA8B;QAC9B,MAAM,cAAc,GAAsB;YACxC,GAAG,KAAK;YACR,aAAa,EAAE,MAAM,CAAC,IAAI;SAC3B,CAAC;QAEF,OAAO,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC"}

package/lib/options.d.ts

@@ -0,0 +1,48 @@
+import type { FndMonorepoProject } from '@fnd-platform/core';
+/**
+ * Configuration options for FndApiProject.
+ */
+export interface FndApiProjectOptions {
+  /**
+   * Parent monorepo project.
+   * The API project will be added as a subproject of this monorepo.
+   */
+  readonly parent: FndMonorepoProject;
+  /**
+   * Package name for the API project.
+   * This will be prefixed with the parent project name to create the full
+   * package name (e.g., '@my-app/api').
+   *
+   * @example 'api'
+   */
+  readonly name: string;
+  /**
+   * Output directory relative to monorepo root.
+   *
+   * @default 'packages/{name}'
+   */
+  readonly outdir?: string;
+  /**
+   * Enable DynamoDB integration.
+   * When true, adds AWS SDK DynamoDB dependencies and generates
+   * DynamoDB utility files.
+   *
+   * @default true
+   */
+  readonly dynamodb?: boolean;
+  /**
+   * Enable Cognito authentication integration.
+   * When true, includes authentication middleware and types.
+   *
+   * @default true
+   */
+  readonly cognito?: boolean;
+  /**
+   * Enable CORS headers in responses.
+   * When true, the response helpers will include CORS headers.
+   *
+   * @default true
+   */
+  readonly cors?: boolean;
+}
+//# sourceMappingURL=options.d.ts.map

package/lib/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IAEpC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/lib/options.js

@@ -0,0 +1,3 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+//# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":""}

package/lib/types/api.d.ts

@@ -0,0 +1,108 @@
+/**
+ * TypeScript type definitions for API handlers.
+ *
+ * Provides type-safe handler definitions and Cognito-authenticated
+ * event types for Lambda handlers.
+ *
+ * @packageDocumentation
+ */
+import type { APIGatewayProxyEvent, APIGatewayProxyResult, Context } from 'aws-lambda';
+/**
+ * Standard Lambda handler type.
+ *
+ * @example
+ * ```typescript
+ * const handler: Handler = async (event, context) => {
+ *   return success({ message: 'Hello' });
+ * };
+ * ```
+ */
+export type Handler = (
+  event: APIGatewayProxyEvent,
+  context: Context
+) => Promise<APIGatewayProxyResult>;
+/**
+ * Cognito JWT claims structure.
+ */
+export interface CognitoClaims {
+  /** User's unique identifier (Cognito sub) */
+  sub: string;
+  /** User's email address */
+  email: string;
+  /** User's Cognito groups (roles) */
+  'cognito:groups'?: string[];
+}
+/**
+ * API Gateway event with Cognito authorizer claims.
+ *
+ * Use this type when your handler expects authenticated requests
+ * from API Gateway with a Cognito authorizer.
+ *
+ * @example
+ * ```typescript
+ * const handler: AuthenticatedHandler = async (event) => {
+ *   const userId = event.requestContext.authorizer.claims.sub;
+ *   const email = event.requestContext.authorizer.claims.email;
+ *   // ...
+ * };
+ * ```
+ */
+export interface AuthenticatedEvent extends APIGatewayProxyEvent {
+  requestContext: APIGatewayProxyEvent['requestContext'] & {
+    authorizer: {
+      claims: CognitoClaims;
+    };
+  };
+}
+/**
+ * Lambda handler type for authenticated requests.
+ *
+ * @example
+ * ```typescript
+ * const getProfile: AuthenticatedHandler = async (event, context) => {
+ *   const userId = event.requestContext.authorizer.claims.sub;
+ *   return success({ userId });
+ * };
+ * ```
+ */
+export type AuthenticatedHandler = (
+  event: AuthenticatedEvent,
+  context: Context
+) => Promise<APIGatewayProxyResult>;
+/**
+ * Pagination parameters for list endpoints.
+ *
+ * @example
+ * ```typescript
+ * interface ListUsersRequest extends PaginatedRequest {
+ *   status?: 'active' | 'inactive';
+ * }
+ * ```
+ */
+export interface PaginatedRequest {
+  /** Maximum number of items to return (default varies by endpoint) */
+  limit?: number;
+  /** Cursor for pagination (typically the last item's ID or encoded key) */
+  cursor?: string;
+}
+/**
+ * Paginated response structure for list endpoints.
+ *
+ * @example
+ * ```typescript
+ * const response: PaginatedResponse<User> = {
+ *   items: users,
+ *   nextCursor: lastUser?.id,
+ *   total: totalCount,
+ * };
+ * ```
+ */
+export interface PaginatedResponse<T> {
+  /** Array of items for the current page */
+  items: T[];
+  /** Cursor for the next page, undefined if no more pages */
+  nextCursor?: string;
+  /** Total count of items (optional, may be expensive to compute) */
+  total?: number;
+}
+//# sourceMappingURL=api.d.ts.map

package/lib/types/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;;;;;GASG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,cAAc,EAAE,oBAAoB,CAAC,gBAAgB,CAAC,GAAG;QACvD,UAAU,EAAE;YACV,MAAM,EAAE,aAAa,CAAC;SACvB,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,0CAA0C;IAC1C,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/lib/types/api.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * TypeScript type definitions for API handlers.
+ *
+ * Provides type-safe handler definitions and Cognito-authenticated
+ * event types for Lambda handlers.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=api.js.map

package/lib/types/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/types/api.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/lib/types/middleware.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Middleware type definitions for Lambda handlers.
+ *
+ * Provides type-safe middleware composition for cross-cutting concerns
+ * like authentication, validation, error handling, and logging.
+ *
+ * @packageDocumentation
+ */
+import type { APIGatewayProxyEvent, APIGatewayProxyResult, Context } from 'aws-lambda';
+/**
+ * Generic Lambda handler type.
+ *
+ * Allows handlers to receive transformed events (e.g., with validatedBody).
+ *
+ * @typeParam TEvent - The event type this handler receives
+ *
+ * @example
+ * ```typescript
+ * const handler: MiddlewareHandler<ValidatedEvent<UserInput>> = async (event, context) => {
+ *   const { name, email } = event.validatedBody;
+ *   return success({ name, email });
+ * };
+ * ```
+ */
+export type MiddlewareHandler<TEvent = APIGatewayProxyEvent> = (
+  event: TEvent,
+  context: Context
+) => Promise<APIGatewayProxyResult>;
+/**
+ * Middleware function type.
+ *
+ * Middleware wraps a handler, optionally transforming the event type.
+ * The transformation flows from TEventIn to TEventOut.
+ *
+ * @typeParam TEventIn - The event type this middleware receives
+ * @typeParam TEventOut - The event type passed to the inner handler
+ *
+ * @example
+ * ```typescript
+ * // Middleware that adds validatedBody to the event
+ * const withValidation: Middleware<APIGatewayProxyEvent, ValidatedEvent<T>> = ...
+ * ```
+ */
+export type Middleware<TEventIn = APIGatewayProxyEvent, TEventOut = TEventIn> = (
+  handler: MiddlewareHandler<TEventOut>
+) => MiddlewareHandler<TEventIn>;
+/**
+ * Event with validated request body.
+ *
+ * Used by withValidation middleware to provide type-safe access
+ * to the validated request body.
+ *
+ * @typeParam T - The validated body type (from Zod schema)
+ */
+export interface ValidatedEvent<T> extends APIGatewayProxyEvent {
+  /** The validated and typed request body */
+  validatedBody: T;
+}
+//# sourceMappingURL=middleware.d.ts.map

package/lib/types/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEvF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,iBAAiB,CAAC,MAAM,GAAG,oBAAoB,IAAI,CAC7D,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,UAAU,CAAC,QAAQ,GAAG,oBAAoB,EAAE,SAAS,GAAG,QAAQ,IAAI,CAC9E,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAClC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AAEjC;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,oBAAoB;IAC7D,2CAA2C;IAC3C,aAAa,EAAE,CAAC,CAAC;CAClB"}

package/lib/types/middleware.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Middleware type definitions for Lambda handlers.
+ *
+ * Provides type-safe middleware composition for cross-cutting concerns
+ * like authentication, validation, error handling, and logging.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=middleware.js.map

package/lib/types/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../src/types/middleware.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@fnd-platform/api",
+  "version": "1.0.0-alpha.1",
+  "description": "Projen project class for generating Lambda API packages in fnd-platform",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib/"
+  ],
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.500.0",
+    "@aws-sdk/s3-request-presigner": "^3.500.0",
+    "projen": "^0.91.0",
+    "zod": "^3.22.0",
+    "@fnd-platform/core": "1.0.0-alpha.1"
+  },
+  "peerDependencies": {
+    "projen": "^0.91.0"
+  },
+  "devDependencies": {
+    "@types/aws-lambda": "^8.10.159",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.18.0",
+    "@typescript-eslint/parser": "^7.18.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "eslint": "^8.57.0",
+    "typescript": "^5.6.3",
+    "vitest": "^1.6.0"
+  },
+  "keywords": [
+    "projen",
+    "lambda",
+    "api",
+    "aws",
+    "typescript",
+    "scaffolding"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-org/fnd-platform",
+    "directory": "packages/api"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/ test/"
+  }
+}