create-aws-project 1.2.1

package/templates/apps/api/lambdas.yml

@@ -0,0 +1,84 @@
+# Lambda Function Configurations
+# This file defines the Lambda functions and their API Gateway mappings
+
+lambdas:
+  user-lambdas:
+    - name: GetUsers
+      source: src/handlers/users/get-users.ts
+      handler: handler
+      method: GET
+      path: /api/users
+      description: Get all users
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info
+
+    # {{#if AUTH_COGNITO}}
+    - name: GetMe
+      source: src/handlers/users/get-me.ts
+      handler: handler
+      method: GET
+      path: /api/users/me
+      description: Get current authenticated user
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info
+    # {{/if AUTH_COGNITO}}
+    # {{#if AUTH_AUTH0}}
+    - name: GetMe
+      source: src/handlers/users/get-me.ts
+      handler: handler
+      method: GET
+      path: /api/users/me
+      description: Get current authenticated user
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info
+    # {{/if AUTH_AUTH0}}
+
+    - name: GetUser
+      source: src/handlers/users/get-user.ts
+      handler: handler
+      method: GET
+      path: /api/users/{id}
+      description: Get user by ID
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info
+
+    - name: CreateUser
+      source: src/handlers/users/create-user.ts
+      handler: handler
+      method: POST
+      path: /api/users
+      description: Create a new user
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info
+
+    - name: UpdateUser
+      source: src/handlers/users/update-user.ts
+      handler: handler
+      method: PUT
+      path: /api/users/{id}
+      description: Update an existing user
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info
+
+    - name: DeleteUser
+      source: src/handlers/users/delete-user.ts
+      handler: handler
+      method: DELETE
+      path: /api/users/{id}
+      description: Delete a user
+      memorySize: 256
+      timeout: 30
+      environment:
+        LOG_LEVEL: info

package/templates/apps/api/project.json.template

@@ -0,0 +1,58 @@
+{
+  "name": "api",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "apps/api/src",
+  "projectType": "application",
+  "tags": ["type:api"],
+  "targets": {
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": ["{options.outputFile}"],
+      "options": {
+        "lintFilePatterns": ["apps/api/**/*.ts"]
+      }
+    },
+    "build": {
+      "executor": "@nx/esbuild:esbuild",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/apps/api",
+        "main": "apps/api/src/handlers/users/get-users.ts",
+        "tsConfig": "apps/api/tsconfig.app.json",
+        "assets": [],
+        "bundle": true,
+        "platform": "node",
+        "target": "node20",
+        "format": ["cjs"],
+        "external": ["aws-sdk", "@aws-sdk/*"],
+        "additionalEntryPoints": [
+          "apps/api/src/handlers/users/get-user.ts",
+          "apps/api/src/handlers/users/create-user.ts",
+          "apps/api/src/handlers/users/update-user.ts",
+          "apps/api/src/handlers/users/delete-user.ts"
+        ],
+        "esbuildOptions": {
+          "sourcemap": true,
+          "minify": true,
+          "outExtension": {
+            ".js": ".js"
+          }
+        }
+      }
+    },
+    "serve": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "echo 'Use SAM CLI or CDK to test Lambda functions locally'"
+      }
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/apps/api"],
+      "options": {
+        "jestConfig": "apps/api/jest.config.ts",
+        "passWithNoTests": true
+      }
+    }
+  }
+}

package/templates/apps/api/src/__tests__/setup.ts

@@ -0,0 +1,10 @@
+/**
+ * Jest test setup file
+ * Runs before all tests
+ */
+
+// Set test environment variables
+process.env['NODE_ENV'] = 'test';
+process.env['AWS_REGION'] = 'us-east-1';
+process.env['DYNAMODB_TABLE'] = 'test-table';
+process.env['LOG_LEVEL'] = 'ERROR'; // Reduce log noise in tests

package/templates/apps/api/src/handlers/users/create-user.ts

@@ -0,0 +1,52 @@
+import type {
+  ApiGatewayProxyResult,
+  CreateUserRequest,
+} from '{{PACKAGE_SCOPE}}/common-types';
+import { HTTP_STATUS, ERROR_CODES } from '{{PACKAGE_SCOPE}}/common-types';
+import { successResponse } from '../../utils/response';
+import { validate, getValidationErrors } from '../../utils/validator';
+import { userService } from '../../services/user-service';
+import {
+  createLambdaHandler,
+  createErrorResult,
+  validateBodyPresent,
+  type ParsedRequest,
+} from '../../utils/lambda-handler';
+import { createUserSchema } from '../../schemas/user.schema';
+
+/**
+ * POST /users - Create a new user
+ */
+async function createUserHandler(
+  request: ParsedRequest<CreateUserRequest>
+): Promise<ApiGatewayProxyResult> {
+  // Validate body is present
+  const bodyValidation = validateBodyPresent(request.body, request.rawBody);
+  if (!bodyValidation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      bodyValidation.error || 'Request body is required',
+      HTTP_STATUS.BAD_REQUEST
+    );
+  }
+
+  // Validate request data with AJV schema
+  const validation = validate(createUserSchema, request.body);
+  if (!validation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      getValidationErrors(validation.errors),
+      HTTP_STATUS.BAD_REQUEST,
+      { errors: validation.errors }
+    );
+  }
+
+  const user = await userService.createUser(request.body as CreateUserRequest);
+
+  return successResponse(user, HTTP_STATUS.CREATED, 'User created successfully');
+}
+
+/**
+ * Lambda handler wrapper
+ */
+export const handler = createLambdaHandler(createUserHandler, 'CreateUser');

package/templates/apps/api/src/handlers/users/delete-user.ts

@@ -0,0 +1,45 @@
+import type { ApiGatewayProxyResult } from '{{PACKAGE_SCOPE}}/common-types';
+import { HTTP_STATUS, ERROR_CODES } from '{{PACKAGE_SCOPE}}/common-types';
+import { successResponse } from '../../utils/response';
+import { userService } from '../../services/user-service';
+import {
+  createLambdaHandler,
+  createErrorResult,
+  validatePathParameters,
+  type ParsedRequest,
+} from '../../utils/lambda-handler';
+
+/**
+ * DELETE /users/{id} - Delete user
+ */
+async function deleteUserHandler(
+  request: ParsedRequest
+): Promise<ApiGatewayProxyResult> {
+  // Validate required path parameters
+  const validation = validatePathParameters(request.pathParameters, ['id']);
+  if (!validation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      'User ID is required',
+      HTTP_STATUS.BAD_REQUEST
+    );
+  }
+
+  const userId = request.pathParameters['id'];
+  const deleted = await userService.deleteUser(userId);
+
+  if (!deleted) {
+    throw createErrorResult(
+      ERROR_CODES.NOT_FOUND,
+      'User not found',
+      HTTP_STATUS.NOT_FOUND
+    );
+  }
+
+  return successResponse(null, HTTP_STATUS.OK, 'User deleted successfully');
+}
+
+/**
+ * Lambda handler wrapper
+ */
+export const handler = createLambdaHandler(deleteUserHandler, 'DeleteUser');

package/templates/apps/api/src/handlers/users/get-me.ts

@@ -0,0 +1,72 @@
+import type { ApiGatewayProxyResult } from '{{PACKAGE_SCOPE}}/common-types';
+import { HTTP_STATUS } from '{{PACKAGE_SCOPE}}/common-types';
+import { successResponse } from '../../utils/response';
+import {
+  createLambdaHandler,
+  type ParsedRequest,
+} from '../../utils/lambda-handler';
+// {{#if AUTH_COGNITO}}
+import { requireAuth, type AuthUser } from '../../middleware/cognito-auth';
+// {{/if AUTH_COGNITO}}
+// {{#if AUTH_AUTH0}}
+import { requireAuth, type AuthUser } from '../../middleware/auth0-auth';
+// {{/if AUTH_AUTH0}}
+
+/**
+ * Extended request type that includes authenticated user
+ */
+// {{#if AUTH_COGNITO}}
+interface AuthenticatedRequest extends ParsedRequest {
+  user: AuthUser;
+}
+// {{/if AUTH_COGNITO}}
+// {{#if AUTH_AUTH0}}
+interface AuthenticatedRequest extends ParsedRequest {
+  user: AuthUser;
+}
+// {{/if AUTH_AUTH0}}
+
+/**
+ * GET /users/me - Get current authenticated user
+ * This endpoint requires authentication
+ */
+async function getMeHandler(
+  request: ParsedRequest
+): Promise<ApiGatewayProxyResult> {
+  // {{#if AUTH_COGNITO}}
+  const authRequest = request as AuthenticatedRequest;
+  const user = authRequest.user;
+
+  return successResponse({
+    id: user.sub,
+    email: user.email,
+    emailVerified: user.tokenPayload.email_verified,
+    groups: user.groups || [],
+  }, HTTP_STATUS.OK);
+  // {{/if AUTH_COGNITO}}
+  // {{#if AUTH_AUTH0}}
+  const authRequest = request as AuthenticatedRequest;
+  const user = authRequest.user;
+
+  return successResponse({
+    id: user.sub,
+    email: user.email,
+    emailVerified: user.tokenPayload.email_verified,
+    permissions: user.permissions || [],
+  }, HTTP_STATUS.OK);
+  // {{/if AUTH_AUTH0}}
+}
+
+/**
+ * Lambda handler with authentication middleware
+ */
+// {{#if AUTH_COGNITO}}
+export const handler = requireAuth(
+  createLambdaHandler(getMeHandler, 'GetMe')
+);
+// {{/if AUTH_COGNITO}}
+// {{#if AUTH_AUTH0}}
+export const handler = requireAuth(
+  createLambdaHandler(getMeHandler, 'GetMe')
+);
+// {{/if AUTH_AUTH0}}

package/templates/apps/api/src/handlers/users/get-user.ts

@@ -0,0 +1,45 @@
+import type { ApiGatewayProxyResult } from '{{PACKAGE_SCOPE}}/common-types';
+import { HTTP_STATUS, ERROR_CODES } from '{{PACKAGE_SCOPE}}/common-types';
+import { successResponse } from '../../utils/response';
+import { userService } from '../../services/user-service';
+import {
+  createLambdaHandler,
+  createErrorResult,
+  validatePathParameters,
+  type ParsedRequest,
+} from '../../utils/lambda-handler';
+
+/**
+ * GET /users/{id} - Get user by ID
+ */
+async function getUserHandler(
+  request: ParsedRequest
+): Promise<ApiGatewayProxyResult> {
+  // Validate required path parameters
+  const validation = validatePathParameters(request.pathParameters, ['id']);
+  if (!validation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      'User ID is required',
+      HTTP_STATUS.BAD_REQUEST
+    );
+  }
+
+  const userId = request.pathParameters['id'];
+  const user = await userService.getUserById(userId);
+
+  if (!user) {
+    throw createErrorResult(
+      ERROR_CODES.NOT_FOUND,
+      'User not found',
+      HTTP_STATUS.NOT_FOUND
+    );
+  }
+
+  return successResponse(user, HTTP_STATUS.OK);
+}
+
+/**
+ * Lambda handler wrapper
+ */
+export const handler = createLambdaHandler(getUserHandler, 'GetUser');

package/templates/apps/api/src/handlers/users/get-users.ts

@@ -0,0 +1,23 @@
+import type { ApiGatewayProxyResult } from '{{PACKAGE_SCOPE}}/common-types';
+import { HTTP_STATUS } from '{{PACKAGE_SCOPE}}/common-types';
+import { successResponse } from '../../utils/response';
+import { userService } from '../../services/user-service';
+import {
+  createLambdaHandler,
+  type ParsedRequest,
+} from '../../utils/lambda-handler';
+
+/**
+ * GET /users - Get all users
+ */
+async function getUsersHandler(
+  request: ParsedRequest
+): Promise<ApiGatewayProxyResult> {
+  const userList = await userService.getAllUsers();
+  return successResponse(userList, HTTP_STATUS.OK);
+}
+
+/**
+ * Lambda handler wrapper
+ */
+export const handler = createLambdaHandler(getUsersHandler, 'GetUsers');

package/templates/apps/api/src/handlers/users/index.ts

@@ -0,0 +1,17 @@
+/**
+ * User Handlers
+ *
+ * Individual Lambda handlers for user operations
+ */
+
+export { handler as getUsersHandler } from './get-users';
+export { handler as getUserHandler } from './get-user';
+export { handler as createUserHandler } from './create-user';
+export { handler as updateUserHandler } from './update-user';
+export { handler as deleteUserHandler } from './delete-user';
+// {{#if AUTH_COGNITO}}
+export { handler as getMeHandler } from './get-me';
+// {{/if AUTH_COGNITO}}
+// {{#if AUTH_AUTH0}}
+export { handler as getMeHandler } from './get-me';
+// {{/if AUTH_AUTH0}}

package/templates/apps/api/src/handlers/users/update-user.ts

@@ -0,0 +1,72 @@
+import type {
+  ApiGatewayProxyResult,
+  UpdateUserRequest,
+} from '{{PACKAGE_SCOPE}}/common-types';
+import { HTTP_STATUS, ERROR_CODES } from '{{PACKAGE_SCOPE}}/common-types';
+import { successResponse } from '../../utils/response';
+import { validate, getValidationErrors } from '../../utils/validator';
+import { userService } from '../../services/user-service';
+import {
+  createLambdaHandler,
+  createErrorResult,
+  validatePathParameters,
+  validateBodyPresent,
+  type ParsedRequest,
+} from '../../utils/lambda-handler';
+import { updateUserSchema } from '../../schemas/user.schema';
+
+/**
+ * PUT /users/{id} - Update user
+ */
+async function updateUserHandler(
+  request: ParsedRequest<UpdateUserRequest>
+): Promise<ApiGatewayProxyResult> {
+  // Validate required path parameters
+  const pathValidation = validatePathParameters(request.pathParameters, ['id']);
+  if (!pathValidation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      'User ID is required',
+      HTTP_STATUS.BAD_REQUEST
+    );
+  }
+
+  // Validate body is present
+  const bodyValidation = validateBodyPresent(request.body, request.rawBody);
+  if (!bodyValidation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      bodyValidation.error || 'Request body is required',
+      HTTP_STATUS.BAD_REQUEST
+    );
+  }
+
+  // Validate request data with AJV schema
+  const validation = validate(updateUserSchema, request.body);
+  if (!validation.valid) {
+    throw createErrorResult(
+      ERROR_CODES.VALIDATION_ERROR,
+      getValidationErrors(validation.errors),
+      HTTP_STATUS.BAD_REQUEST,
+      { errors: validation.errors }
+    );
+  }
+
+  const userId = request.pathParameters['id'];
+  const updatedUser = await userService.updateUser(userId, request.body as UpdateUserRequest);
+
+  if (!updatedUser) {
+    throw createErrorResult(
+      ERROR_CODES.NOT_FOUND,
+      'User not found',
+      HTTP_STATUS.NOT_FOUND
+    );
+  }
+
+  return successResponse(updatedUser, HTTP_STATUS.OK, 'User updated successfully');
+}
+
+/**
+ * Lambda handler wrapper
+ */
+export const handler = createLambdaHandler(updateUserHandler, 'UpdateUser');