@felloh-org/lambda-wrapper 1.11.190 → 1.11.192

package/CLAUDE.md

@@ -0,0 +1,67 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Overview
+
+Lambda Wrapper is a shared library for Felloh serverless projects. It provides core functionality including dependency injection, logging, request handling, database entities, and response models for AWS Lambda functions.
+
+## Common Commands
+
+- **Build**: `yarn build` (webpack production build to `dist/`)
+- **Build for TypeORM**: `yarn build:orm` (babel build excluding migrations)
+- **Lint**: `yarn lint`
+- **Test**: `yarn test` (jest with coverage)
+- **Run migrations**: `yarn orm:migration:run`
+- **Generate migration**: `yarn orm:migration:generate <name>`
+- **Revert migration**: `yarn orm:revert`
+- **Create database schemas**: `yarn orm:schema:create`
+
+## Architecture
+
+### Lambda Wrapper Pattern
+The core pattern wraps Lambda handlers to provide dependency injection, logging, and error handling:
+
+```javascript
+import { LambdaWrapper, DEFINITIONS } from '@felloh-org/lambda-wrapper';
+
+export const handler = LambdaWrapper(configuration, async (di, request) => {
+  const warehouse = di.get(DEFINITIONS.WAREHOUSE);
+  // handler logic
+});
+```
+
+### Dependency Injection
+- `DependencyInjection` class manages service instances per request
+- `DependencyAwareClass` is the base class for services that need DI access
+- Built-in definitions in `src/config/dependencies.js`: LOGGER, REQUEST, WAREHOUSE, AUTHENTICATION, EVENT_BRIDGE, SECRETS, WEBHOOK, etc.
+- Custom dependencies can be added via `configuration.DEPENDENCIES`
+
+### Database (TypeORM)
+- Uses TypeORM with PostgreSQL (or Aurora Data API)
+- Entities organized by domain in `src/entity/` (payment, user, bank, agent-data, etc.)
+- Migrations in `src/migration/` organized by schema
+- Database schemas: user, payment, bank, agent_data, nuapay, trust_payments, total_processing, token, nuvei, reference, saltedge, acquirer, operations, basis_theory, aisp, go_cardless, planet, marketing, amex, crm, shield
+- `WarehouseService` handles connections and supports credentials from environment or AWS Secrets Manager
+
+### Response Model
+All Lambda responses use `ResponseModel` which generates:
+```javascript
+{
+  statusCode: number,
+  headers: { 'Content-Type': 'application/json', 'Access-Control-Allow-Origin': '*', ... },
+  body: JSON.stringify({ data, errors, meta: { code, reason, message, request_id } })
+}
+```
+
+### Module Aliasing
+Babel module-resolver maps `@` to the project root, allowing imports like `@/src/service/warehouse`.
+
+## Key Directories
+
+- `src/entity/` - TypeORM entities grouped by domain
+- `src/migration/` - Database migrations grouped by schema
+- `src/service/` - Core services (warehouse, logger, request, authentication, etc.)
+- `src/event/` - Event classes for EventBridge
+- `src/model/` - Response and data models
+- `src/wrapper/` - Lambda wrapper implementation

package/cli/seed/create-schema.js

@@ -34,6 +34,7 @@ const run = async () => {
     await queryRunner.createSchema('marketing', true);
     await queryRunner.createSchema('amex', true);
     await queryRunner.createSchema('crm', true);
+    await queryRunner.createSchema('shield', true);
 
     process.exit(0);
   } catch (error) {