@fjall/payload

AWS Lambda adapters for Payload CMS. This package provides drop-in replacements for Payload's database and storage adapters, optimized for serverless deployments on AWS.

Installation

pnpm add @fjall/payload @payloadcms/storage-s3

Features

• fjallPostgresAdapter - PostgreSQL adapter with AWS Secrets Manager integration
• awsS3Storage - S3 storage plugin for media uploads
• fjallDefaults - Sensible CORS/CSRF defaults for Lambda
• isProduction / isLambda - Environment detection helpers

Usage

Database Adapter

// payload.config.ts
import { buildConfig } from "payload";
import { fjallPostgresAdapter, fjallDefaults } from "@fjall/payload";
import { migrations } from "./migrations";

export default buildConfig({
  ...fjallDefaults(),
  db: await fjallPostgresAdapter({
    migrationDir: "./src/migrations",
    prodMigrations: migrations,
  }),
  // ... rest of config
});

The adapter automatically:

• Fetches database credentials from AWS Secrets Manager in Lambda
• Falls back to DATABASE_URL for local development
• Configures SSL for Aurora PostgreSQL

S3 Storage Plugin

// plugins/index.ts
import { awsS3Storage } from "@fjall/payload";
import { Plugin } from "payload";

export const plugins: Plugin[] = [awsS3Storage()];

The plugin automatically:

• Uses MEDIA_BUCKET_NAME environment variable set by Fjall infrastructure
• Handles presigned URLs for uploads
• Falls back to local filesystem in development

Environment Detection

import { isProduction, isLambda } from "@fjall/payload";

// Conditional logic based on environment
if (isProduction()) {
  // Running in AWS with Fjall infrastructure
}

if (isLambda()) {
  // Running in AWS Lambda runtime
}

Conditional Static Directory

For Media collections that need local uploads in dev but S3 in production:

import { isProduction } from "@fjall/payload";
import path from "path";

export const Media: CollectionConfig = {
  slug: "media",
  upload: {
    ...(isProduction()
      ? {}
      : {
          staticDir: path.resolve(__dirname, "../../public/media"),
        }),
  },
};

Environment Variables

Production (Lambda)

Set automatically by Fjall infrastructure:

| Variable | Description | | ------------------- | ----------------------------- | | DATABASE_HOST | Aurora PostgreSQL endpoint | | DATABASE_PORT | Database port (default: 5432) | | DATABASE_NAME | Database name | | DATABASE_SSL | Enable SSL (true) | | MEDIA_BUCKET_NAME | S3 bucket for uploads |

Credentials fetched from Secrets Manager:

• DATABASE_USERNAME
• DATABASE_PASSWORD

Development

| Variable | Description | | -------------- | --------------------------------- | | DATABASE_URL | Full PostgreSQL connection string |

Auto-Configuration

When you run fjall deploy on a Payload project, the CLI automatically:

1. Detects the Payload pattern
2. Installs @fjall/payload and @payloadcms/storage-s3
3. Patches payload.config.ts to use fjallPostgresAdapter
4. Patches or creates plugins/index.ts with S3 storage
5. Configures next.config.js for Lambda (standalone output)
6. Generates open-next.config.ts for OpenNext

No manual configuration required - just run fjall deploy.

Licence

Proprietary — see LICENSE.