spoonfeeder 0.1.0

package/templates/recipes/dead-letter-queue/tests/unit/infrastructure/queue/dlq.service.spec.ts

@@ -0,0 +1,46 @@
+import { DeadLetterQueueService } from '../../../../src/infrastructure/queue/dlq.service';
+
+describe('DeadLetterQueueService', () => {
+  let service: DeadLetterQueueService;
+
+  beforeEach(() => {
+    service = new DeadLetterQueueService();
+  });
+
+  it('should add a message and retrieve it via getAll', () => {
+    service.add({ queue: 'orders', payload: { id: 1 }, error: 'timeout', attempts: 3 });
+
+    const messages = service.getAll();
+
+    expect(messages).toHaveLength(1);
+    expect(messages[0]).toEqual(
+      expect.objectContaining({
+        queue: 'orders',
+        payload: { id: 1 },
+        error: 'timeout',
+        attempts: 3,
+      }),
+    );
+    expect(messages[0].id).toBeDefined();
+    expect(messages[0].failedAt).toBeInstanceOf(Date);
+  });
+
+  it('should filter messages by queue name', () => {
+    service.add({ queue: 'orders', payload: {}, error: 'fail', attempts: 1 });
+    service.add({ queue: 'emails', payload: {}, error: 'fail', attempts: 1 });
+    service.add({ queue: 'orders', payload: {}, error: 'retry', attempts: 2 });
+
+    expect(service.getByQueue('orders')).toHaveLength(2);
+    expect(service.getByQueue('emails')).toHaveLength(1);
+    expect(service.getByQueue('unknown')).toHaveLength(0);
+  });
+
+  it('should remove a message by id and return true, or false if not found', () => {
+    service.add({ queue: 'q', payload: {}, error: 'e', attempts: 1 });
+    const id = service.getAll()[0].id;
+
+    expect(service.remove(id)).toBe(true);
+    expect(service.getAll()).toHaveLength(0);
+    expect(service.remove('nonexistent-id')).toBe(false);
+  });
+});

package/templates/recipes/dependabot-renovate/.github/dependabot.yml

@@ -0,0 +1,52 @@
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+      time: '06:00'
+      timezone: Europe/Amsterdam
+    open-pull-requests-limit: 10
+    versioning-strategy: increase
+    labels:
+      - dependencies
+      - automated
+    commit-message:
+      prefix: 'chore(deps):'
+      include: scope
+    groups:
+      nestjs:
+        patterns:
+          - '@nestjs/*'
+      testing:
+        patterns:
+          - jest
+          - '@types/jest'
+          - ts-jest
+      linting:
+        patterns:
+          - eslint
+          - '@typescript-eslint/*'
+          - prettier
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+      day: monday
+    labels:
+      - ci
+      - automated
+    commit-message:
+      prefix: 'ci(deps):'
+
+  - package-ecosystem: docker
+    directory: /
+    schedule:
+      interval: monthly
+    labels:
+      - docker
+      - automated
+    commit-message:
+      prefix: 'build(docker):'

package/templates/recipes/dependabot-renovate/README.md

@@ -0,0 +1,37 @@
+# Dependabot and Renovate
+
+Automated dependency update configurations for GitHub Dependabot and Renovate Bot.
+
+## Links
+
+- [GitHub Dependabot Documentation](https://docs.github.com/en/code-security/dependabot)
+- [Renovate Documentation](https://docs.renovatebot.com)
+- [Dependabot Configuration Options](https://docs.github.com/en/code-security/dependabot/dependabot-version-updates/configuration-options-for-the-dependabot.yml-file)
+- [Renovate on GitHub](https://github.com/renovatebot/renovate)
+
+## Dependencies
+
+No npm dependencies required. Both tools run as GitHub Apps or bots.
+
+| Package | Version | Purpose                  |
+| ------- | ------- | ------------------------ |
+| (none)  | -       | Configuration files only |
+
+## Usage
+
+### Dependabot
+
+Place `.github/dependabot.yml` in your repository root. Dependabot is built into GitHub and activates automatically.
+
+### Renovate
+
+Place `renovate.json` in your repository root and install the [Renovate GitHub App](https://github.com/apps/renovate).
+
+Choose one tool per project to avoid conflicting PRs.
+
+## Generated Files
+
+| File                     | Description                             |
+| ------------------------ | --------------------------------------- |
+| `.github/dependabot.yml` | Dependabot version update configuration |
+| `renovate.json`          | Renovate Bot configuration              |

package/templates/recipes/dependabot-renovate/renovate.json

@@ -0,0 +1,46 @@
+{
+  "$schema": "https://docs.renovatebot.com/renovate-schema.json",
+  "extends": [
+    "config:recommended",
+    ":pinAllExceptPeerDependencies",
+    ":semanticCommits",
+    ":separateMultipleMajorReleases",
+    "group:monorepos",
+    "group:recommended"
+  ],
+  "schedule": ["before 7am on Monday"],
+  "timezone": "Europe/Amsterdam",
+  "labels": ["dependencies", "automated"],
+  "rangeStrategy": "pin",
+  "lockFileMaintenance": {
+    "enabled": true,
+    "schedule": ["before 5am on the first day of the month"]
+  },
+  "packageRules": [
+    {
+      "groupName": "NestJS",
+      "matchPackagePatterns": ["^@nestjs/"],
+      "automerge": false
+    },
+    {
+      "groupName": "Testing",
+      "matchPackageNames": ["jest", "ts-jest"],
+      "matchPackagePatterns": ["^@types/jest"],
+      "automerge": true,
+      "automergeType": "branch"
+    },
+    {
+      "groupName": "Linting",
+      "matchPackageNames": ["eslint", "prettier"],
+      "matchPackagePatterns": ["^@typescript-eslint/"],
+      "automerge": true,
+      "automergeType": "branch"
+    },
+    {
+      "matchDepTypes": ["devDependencies"],
+      "matchUpdateTypes": ["patch"],
+      "automerge": true,
+      "automergeType": "branch"
+    }
+  ]
+}

package/templates/recipes/deploy/README.md

@@ -0,0 +1,13 @@
+# Deploy
+
+Container and orchestration templates for deploying NestJS applications.
+
+## Options
+
+| Option                                          | Description                                                     |
+| ----------------------------------------------- | --------------------------------------------------------------- |
+| [Dockerfile](./dockerfile/)                     | Multi-stage production Docker image                             |
+| [Docker Compose](./docker-compose/)             | Full-stack local/production setup with Postgres and Redis       |
+| [Kubernetes](./kubernetes/)                     | Kubernetes manifests with Deployment, Service, Ingress, and HPA |
+| [Serverless Framework](./serverless-framework/) | AWS Lambda deployment using Serverless Framework                |
+| [Terraform](./terraform/)                       | Modular Terraform setup with AWS ECS Fargate module             |

package/templates/recipes/deploy/docker-compose/README.md

@@ -0,0 +1,38 @@
+# Docker Compose
+
+Full-stack Docker Compose setup with the NestJS application, Postgres, and Redis.
+
+## Documentation
+
+- [Docker Compose](https://docs.docker.com/compose/)
+- [Compose file reference](https://docs.docker.com/compose/compose-file/)
+
+## Generated Files
+
+| File                 | Description                                      |
+| -------------------- | ------------------------------------------------ |
+| `docker-compose.yml` | Service definitions for app, Postgres, and Redis |
+
+## Services
+
+| Service    | Image                 | Port | Description                           |
+| ---------- | --------------------- | ---- | ------------------------------------- |
+| `app`      | Built from Dockerfile | 3000 | NestJS application                    |
+| `postgres` | `postgres:16-alpine`  | 5432 | PostgreSQL database with health check |
+| `redis`    | `redis:7-alpine`      | 6379 | Redis cache with health check         |
+
+## Usage
+
+```bash
+# Start all services
+docker compose up -d
+
+# View logs
+docker compose logs -f app
+
+# Stop all services
+docker compose down
+
+# Stop and remove volumes
+docker compose down -v
+```

package/templates/recipes/deploy/docker-compose/docker-compose.yml

@@ -0,0 +1,43 @@
+version: '3.8'
+
+services:
+  app:
+    build: .
+    ports:
+      - '${PORT:-3000}:3000'
+    env_file:
+      - .env
+    depends_on:
+      postgres:
+        condition: service_healthy
+      redis:
+        condition: service_healthy
+
+  postgres:
+    image: postgres:16-alpine
+    ports:
+      - '5432:5432'
+    environment:
+      POSTGRES_USER: ${DB_USER:-app}
+      POSTGRES_PASSWORD: ${DB_PASSWORD:-password}
+      POSTGRES_DB: ${DB_NAME:-app}
+    volumes:
+      - postgres_data:/var/lib/postgresql/data
+    healthcheck:
+      test: ['CMD-SHELL', 'pg_isready -U ${DB_USER:-app}']
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+  redis:
+    image: redis:7-alpine
+    ports:
+      - '6379:6379'
+    healthcheck:
+      test: ['CMD', 'redis-cli', 'ping']
+      interval: 5s
+      timeout: 5s
+      retries: 5
+
+volumes:
+  postgres_data:

package/templates/recipes/deploy/dockerfile/Dockerfile

@@ -0,0 +1,30 @@
+# Build stage
+FROM node:22-alpine AS builder
+
+RUN corepack enable && corepack prepare pnpm@10 --activate
+
+WORKDIR /app
+
+COPY package.json pnpm-lock.yaml ./
+RUN pnpm install --frozen-lockfile
+
+COPY . .
+RUN pnpm build
+RUN pnpm prune --prod
+
+# Production stage
+FROM node:22-alpine
+
+RUN apk add --no-cache dumb-init
+
+WORKDIR /app
+
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+COPY --from=builder /app/package.json ./
+
+USER node
+
+EXPOSE 3000
+
+CMD ["dumb-init", "node", "dist/main.js"]

package/templates/recipes/deploy/dockerfile/README.md

@@ -0,0 +1,30 @@
+# Dockerfile
+
+Multi-stage production Docker image for NestJS applications.
+
+## Documentation
+
+- [Dockerfile reference](https://docs.docker.com/reference/dockerfile/)
+- [Docker multi-stage builds](https://docs.docker.com/build/building/multi-stage/)
+
+## Generated Files
+
+| File            | Description                                       |
+| --------------- | ------------------------------------------------- |
+| `Dockerfile`    | Multi-stage build (builder + production)          |
+| `.dockerignore` | Excludes unnecessary files from the build context |
+
+## Build Stages
+
+1. **builder** -- installs dependencies with `pnpm install --frozen-lockfile`, copies source, runs `pnpm build`, then prunes dev dependencies
+2. **production** -- minimal `node:22-alpine` image with `dumb-init`, copies `dist/`, production `node_modules/`, and `package.json`; runs as the `node` user on port 3000
+
+## Usage
+
+```bash
+# Build the image
+docker build -t my-app .
+
+# Run the container
+docker run -p 3000:3000 --env-file .env my-app
+```

package/templates/recipes/deploy/dockerfile/dot-dockerignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+coverage
+.env
+.env.*
+.git
+.gitignore
+*.md
+tests

package/templates/recipes/deploy/kubernetes/README.md

@@ -0,0 +1,43 @@
+# Kubernetes Deployment
+
+Kubernetes manifests for deploying the NestJS application.
+
+## Links
+
+- [Kubernetes Documentation](https://kubernetes.io/docs/)
+- [kubectl Reference](https://kubernetes.io/docs/reference/kubectl/)
+
+## Manifests
+
+| File                  | Description                                |
+| --------------------- | ------------------------------------------ |
+| `k8s/deployment.yaml` | App Deployment (2 replicas, health probes) |
+| `k8s/service.yaml`    | ClusterIP Service (port 80 -> 3000)        |
+| `k8s/configmap.yaml`  | Environment configuration                  |
+| `k8s/ingress.yaml`    | Ingress with TLS                           |
+| `k8s/hpa.yaml`        | HorizontalPodAutoscaler (2-10 replicas)    |
+
+## Usage
+
+```bash
+# Apply all manifests
+kubectl apply -f k8s/
+
+# Check status
+kubectl get pods -l app=app
+kubectl get svc app
+kubectl get ingress app
+
+# View logs
+kubectl logs -l app=app -f
+
+# Scale manually
+kubectl scale deployment app --replicas=3
+```
+
+## Configuration
+
+1. Replace `REGISTRY/IMAGE:TAG` in deployment.yaml with your container registry
+2. Create the `app-secrets` Secret with sensitive env vars
+3. Update `app.example.com` in ingress.yaml with your domain
+4. Update TLS secret name if using cert-manager

package/templates/recipes/deploy/kubernetes/k8s/configmap.yaml

@@ -0,0 +1,7 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: app-config
+data:
+  NODE_ENV: 'production'
+  PORT: '3000'

package/templates/recipes/deploy/kubernetes/k8s/deployment.yaml

@@ -0,0 +1,45 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: app
+  labels:
+    app: app
+spec:
+  replicas: 2
+  selector:
+    matchLabels:
+      app: app
+  template:
+    metadata:
+      labels:
+        app: app
+    spec:
+      containers:
+        - name: app
+          image: REGISTRY/IMAGE:TAG
+          ports:
+            - containerPort: 3000
+          envFrom:
+            - configMapRef:
+                name: app-config
+            - secretRef:
+                name: app-secrets
+          resources:
+            requests:
+              memory: '128Mi'
+              cpu: '100m'
+            limits:
+              memory: '256Mi'
+              cpu: '250m'
+          livenessProbe:
+            httpGet:
+              path: /health
+              port: 3000
+            initialDelaySeconds: 15
+            periodSeconds: 10
+          readinessProbe:
+            httpGet:
+              path: /health
+              port: 3000
+            initialDelaySeconds: 5
+            periodSeconds: 5

package/templates/recipes/deploy/kubernetes/k8s/hpa.yaml

@@ -0,0 +1,18 @@
+apiVersion: autoscaling/v2
+kind: HorizontalPodAutoscaler
+metadata:
+  name: app
+spec:
+  scaleTargetRef:
+    apiVersion: apps/v1
+    kind: Deployment
+    name: app
+  minReplicas: 2
+  maxReplicas: 10
+  metrics:
+    - type: Resource
+      resource:
+        name: cpu
+        target:
+          type: Utilization
+          averageUtilization: 80

package/templates/recipes/deploy/kubernetes/k8s/ingress.yaml

@@ -0,0 +1,23 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: app
+  annotations:
+    nginx.ingress.kubernetes.io/rewrite-target: /
+spec:
+  ingressClassName: nginx
+  tls:
+    - hosts:
+        - app.example.com
+      secretName: app-tls
+  rules:
+    - host: app.example.com
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: app
+                port:
+                  number: 80

package/templates/recipes/deploy/kubernetes/k8s/service.yaml

@@ -0,0 +1,12 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: app
+spec:
+  type: ClusterIP
+  selector:
+    app: app
+  ports:
+    - port: 80
+      targetPort: 3000
+      protocol: TCP

package/templates/recipes/deploy/serverless-framework/README.md

@@ -0,0 +1,39 @@
+# Serverless Framework
+
+Deploy the NestJS application as an AWS Lambda function using Serverless Framework.
+
+## Links
+
+- [Serverless Framework Docs](https://www.serverless.com/framework/docs/)
+- [serverless-offline Plugin](https://www.npmjs.com/package/serverless-offline)
+
+## Dependencies
+
+| Package              | Version | Purpose                |
+| -------------------- | ------- | ---------------------- |
+| `serverless`         | CLI     | Deployment framework   |
+| `serverless-offline` | dev     | Local Lambda emulation |
+
+## Usage
+
+```bash
+# Install Serverless CLI
+npm install -g serverless
+
+# Local development
+pnpm add -D -E serverless-offline
+serverless offline
+
+# Deploy to AWS
+serverless deploy --stage dev
+serverless deploy --stage production
+
+# Remove deployment
+serverless remove --stage dev
+```
+
+## Generated Files
+
+| File             | Description                        |
+| ---------------- | ---------------------------------- |
+| `serverless.yml` | Serverless Framework configuration |

package/templates/recipes/deploy/serverless-framework/serverless.yml.ejs

@@ -0,0 +1,22 @@
+service: <%= name %>
+
+frameworkVersion: '4'
+
+provider:
+  name: aws
+  runtime: nodejs22.x
+  stage: ${opt:stage, 'dev'}
+  region: ${opt:region, 'eu-west-1'}
+  memorySize: 256
+  timeout: 30
+  environment:
+    NODE_ENV: ${self:provider.stage}
+
+functions:
+  api:
+    handler: dist/main.handler
+    events:
+      - httpApi: '*'
+
+plugins:
+  - serverless-offline

package/templates/recipes/deploy/terraform/README.md

@@ -0,0 +1,99 @@
+# Terraform
+
+Modular Terraform setup for deploying a NestJS application to AWS using ECS Fargate.
+
+## Architecture
+
+The root configuration is provider-agnostic and delegates to provider-specific modules:
+
+```
+terraform/
+├── main.tf.ejs          # Root config with S3 backend (templated)
+├── variables.tf         # Root-level variables
+├── outputs.tf           # Root-level outputs
+└── modules/
+    └── app/             # AWS ECS Fargate module
+        ├── main.tf      # ECS cluster, task definition, service
+        ├── variables.tf # Module variables
+        ├── outputs.tf   # Module outputs
+        ├── iam.tf       # IAM roles for ECS execution and task
+        ├── alb.tf       # Application Load Balancer
+        └── security.tf  # Security groups
+```
+
+## Prerequisites
+
+- [Terraform](https://developer.hashicorp.com/terraform/install) >= 1.5
+- AWS credentials configured (`aws configure` or environment variables)
+- An S3 bucket for Terraform state storage
+- A VPC with private subnets
+
+## Usage
+
+### Initialize
+
+```bash
+terraform init \
+  -backend-config="bucket=my-terraform-state" \
+  -backend-config="key=my-app/terraform.tfstate" \
+  -backend-config="region=eu-west-1"
+```
+
+### Plan
+
+```bash
+terraform plan -var="environment=dev"
+```
+
+### Apply
+
+```bash
+terraform apply -var="environment=dev"
+```
+
+### Destroy
+
+```bash
+terraform destroy -var="environment=dev"
+```
+
+## Variables
+
+| Variable      | Type   | Default     | Description                                       |
+| ------------- | ------ | ----------- | ------------------------------------------------- |
+| `environment` | string | `dev`       | Deployment environment (dev, staging, production) |
+| `region`      | string | `eu-west-1` | AWS region                                        |
+
+### Module Variables (`modules/app`)
+
+| Variable             | Type         | Default                 | Description                |
+| -------------------- | ------------ | ----------------------- | -------------------------- |
+| `app_name`           | string       | -                       | Application name           |
+| `environment`        | string       | -                       | Deployment environment     |
+| `region`             | string       | `eu-west-1`             | AWS region                 |
+| `container_image`    | string       | `REGISTRY/IMAGE:latest` | Docker image URI           |
+| `cpu`                | number       | `256`                   | Fargate task CPU units     |
+| `memory`             | number       | `512`                   | Fargate task memory (MB)   |
+| `desired_count`      | number       | `2`                     | Number of running tasks    |
+| `private_subnet_ids` | list(string) | `[]`                    | Subnet IDs for ECS tasks   |
+| `vpc_id`             | string       | `""`                    | VPC ID for security groups |
+
+## Modules
+
+### `modules/app`
+
+Deploys the NestJS application on AWS ECS Fargate with:
+
+- **ECS Cluster** with Container Insights enabled
+- **Fargate Task Definition** with health checks and CloudWatch logging
+- **ECS Service** behind an Application Load Balancer
+- **ALB** with HTTPS listener and health-check-based target group
+- **IAM Roles** for ECS task execution and runtime permissions
+- **Security Groups** restricting traffic between ALB and containers
+
+## References
+
+- [Terraform Documentation](https://developer.hashicorp.com/terraform/docs)
+- [AWS Provider Documentation](https://registry.terraform.io/providers/hashicorp/aws/latest/docs)
+- [ECS Fargate](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/ecs_service)
+- [Application Load Balancer](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/lb)

package/templates/recipes/deploy/terraform/main.tf.ejs

@@ -0,0 +1,13 @@
+terraform {
+  required_version = ">= 1.5"
+
+  backend "s3" {}
+}
+
+module "app" {
+  source = "./modules/app"
+
+  app_name    = "<%= name %>"
+  environment = var.environment
+  region      = var.region
+}