@xenterprises/fastify-ximagepipeline 1.1.0 → 1.2.0

package/README.md

@@ -1,488 +1,258 @@
-# xMedia Plugin for Fastify v5
+# @xenterprises/fastify-ximagepipeline
 
-Fastify plugin for handling image uploads with automatic EXIF stripping, content moderation, WebP variant generation, and Cloudflare R2 storage using a job queue pattern.
+Fastify plugin for image uploads with EXIF stripping, variant generation, blurhash placeholders, and R2/S3 storage — powered by a background job queue.
 
-## Features
-
-✨ **Core Capabilities**
-- 🖼️ **Image Upload** - Multipart file upload with validation
-- 🔍 **EXIF Stripping** - Remove metadata while preserving orientation
-- 🎨 **Variant Generation** - Automatic WebP variants at multiple sizes
-- 📦 **R2 Storage** - Direct integration with Cloudflare R2 (S3-compatible)
-- ⏳ **Job Queue** - Database-backed processing queue with retry logic
-- 🔒 **Content Moderation** - Pluggable moderation API support
-- 🎯 **Focal Points** - Smart cropping hints for UI
-- 📊 **Blurhash** - Loading placeholders for instant UI feedback
-- 🧹 **Cleanup** - Automatic staging cleanup and stale job recovery
-
-## Installation
+## Install
 
 ```bash
-npm install @xenterprises/fastify-xmedia @fastify/multipart
+npm install @xenterprises/fastify-ximagepipeline
 ```
 
-## Setup
-
-### 1. Add Prisma Models
-
-Add these models to your `schema.prisma`:
-
-```prisma
-enum MediaStatus {
-  PENDING
-  PROCESSING
-  COMPLETE
-  REJECTED
-  FAILED
-}
-
-model MediaQueue {
-  id String @id @default(cuid())
-  status MediaStatus @default(PENDING)
-  sourceType String
-  sourceId String
-  stagingKey String
-  originalFilename String
-  mimeType String
-  fileSize Int
-  mediaId String?
-  media Media? @relation(fields: [mediaId], references: [id], onDelete: SetNull)
-  attempts Int @default(0)
-  maxAttempts Int @default(3)
-  errorMsg String?
-  moderationResult String?
-  moderationDetails Json?
-  lockedAt DateTime?
-  lockedBy String?
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-
-  @@index([status, createdAt])
-  @@index([sourceType, sourceId])
-}
+**Peer dependencies:** `fastify ^5.0.0`, `@fastify/multipart` (register before this plugin)
 
-model Media {
-  id String @id @default(cuid())
-  urls Json @default("{}")
-  originalUrl String
-  width Int
-  height Int
-  format String
-  aspectRatio String
-  blurhash String
-  focalPoint Json @default("{\"x\": 0.5, \"y\": 0.5}")
-  sourceType String
-  sourceId String
-  originalFilename String
-  mimeType String
-  fileSize Int
-  exifStripped Boolean @default(true)
-  createdAt DateTime @default(now())
-  updatedAt DateTime @updatedAt
-  queue MediaQueue[]
-
-  @@index([sourceType, sourceId])
-}
-```
+## Quick Start
 
-### 2. Register Plugin
-
-```javascript
-import Fastify from 'fastify';
-import xMedia from '@xenterprises/fastify-xmedia';
-import multipart from '@fastify/multipart';
-import { PrismaClient } from '@prisma/client';
-
-const fastify = Fastify();
-const prisma = new PrismaClient();
+```js
+import Fastify from "fastify";
+import multipart from "@fastify/multipart";
+import xImagePipeline from "@xenterprises/fastify-ximagepipeline";
 
+const fastify = Fastify({ logger: true });
 await fastify.register(multipart);
-
-await fastify.register(xMedia, {
-  // R2 Configuration
+await fastify.register(xImagePipeline, {
   r2: {
     endpoint: process.env.R2_ENDPOINT,
-    region: 'auto',
     accessKeyId: process.env.R2_ACCESS_KEY_ID,
     secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
     bucket: process.env.R2_BUCKET,
   },
-
-  // Database connection
-  db: prisma,
-
-  // Optional: Content moderation
-  moderation: {
-    provider: 'rekognition', // or 'vision', 'sightengine', etc.
-    apiKey: process.env.MODERATION_API_KEY,
-    // provider-specific options...
-  },
-
-  // Optional: Customize variant specs
-  variants: {
-    xs: { width: 80, height: 80, fit: 'cover' },
-    sm: { width: 200, height: 200, fit: 'cover' },
-    md: { width: 600, height: null, fit: 'inside' },
-    lg: { width: 1200, height: null, fit: 'inside' },
-    xl: { width: 1920, height: null, fit: 'inside' },
-    '2xl': { width: 2560, height: null, fit: 'inside' },
-  },
-
-  // Optional: Worker configuration
-  worker: {
-    enabled: true,
-    pollInterval: 5000,        // 5 seconds
-    maxAttempts: 3,
-    lockTimeout: 300000,       // 5 minutes
-    failOnError: false,
-  },
-
-  // Optional: Storage paths
-  stagingPath: 'staging',
-  mediaPath: 'media',
-  originalsPath: 'originals',
-
-  // Optional: Limits
-  maxFileSize: 50 * 1024 * 1024, // 50MB
-  allowedMimeTypes: ['image/jpeg', 'image/png', 'image/webp', 'image/gif'],
+  db: prisma, // Prisma client with MediaQueue + Media models
 });
-```
 
-## API Endpoints
+await fastify.listen({ port: 3000 });
+```
 
-### Upload Image
+Upload an image:
 
-```http
-POST /media/upload HTTP/1.1
+```bash
+curl -F "file=@photo.jpg" \
+     -F "sourceType=avatar" \
+     -F "sourceId=user-123" \
+     http://localhost:3000/image-pipeline/upload
+```
 
-Content-Type: multipart/form-data; boundary=----WebKitFormBoundary
+## Plugin Options
+
+| Option | Type | Default | Required | Description |
+|--------|------|---------|----------|-------------|
+| `r2` | `Object` | — | Yes | R2/S3 connection config (see below) |
+| `db` | `Object` | — | Yes | Prisma client with `mediaQueue` and `media` models |
+| `moderation` | `Object` | `null` | No | Content moderation config with `handler` function |
+| `variants` | `Object` | 6 sizes | No | Variant dimension specs (xs/sm/md/lg/xl/2xl) |
+| `sourceTypes` | `Object` | 5 types | No | Per-source-type processing config |
+| `worker` | `Object` | enabled | No | Background worker settings |
+| `stagingPath` | `string` | `"staging"` | No | R2 prefix for staging uploads |
+| `mediaPath` | `string` | `"media"` | No | R2 prefix for processed media |
+| `originalsPath` | `string` | `"originals"` | No | R2 prefix for original files |
+| `maxFileSize` | `number` | `52428800` | No | Max upload size in bytes (50MB) |
+| `allowedMimeTypes` | `string[]` | jpeg/png/webp/gif | No | Accepted MIME types |
+
+### `r2` Config
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `endpoint` | `string` | Yes | R2 or S3-compatible endpoint URL |
+| `accessKeyId` | `string` | Yes | Access key |
+| `secretAccessKey` | `string` | Yes | Secret key |
+| `bucket` | `string` | Yes | Bucket name |
+| `region` | `string` | No | Region (default `"auto"` for R2) |
+
+### `worker` Config
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `enabled` | `boolean` | `true` | Enable/disable background processing |
+| `pollInterval` | `number` | `5000` | Poll interval in ms |
+| `maxAttempts` | `number` | `3` | Max retry attempts per job |
+| `lockTimeout` | `number` | `300000` | Lock timeout in ms (5 min) |
+| `failOnError` | `boolean` | `true` | Throw if worker fails to start |
+
+### `moderation` Config
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `handler` | `function` | No | `async (buffer, config) => { passed, flags, confidence }` |
+
+If no handler is provided, all images are approved. Provide a handler to call AWS Rekognition, Google Vision, or any moderation API.
+
+## Default Variants
+
+| Name | Width | Height | Fit | Use Case |
+|------|-------|--------|-----|----------|
+| `xs` | 80 | 80 | cover | Tiny thumbnails, avatars |
+| `sm` | 200 | 200 | cover | Thumbnails, lists |
+| `md` | 600 | auto | inside | Content images, cards |
+| `lg` | 1200 | auto | inside | Detail views |
+| `xl` | 1920 | auto | inside | Full-width banners |
+| `2xl` | 2560 | auto | inside | Retina/4K displays |
+
+## Default Source Types
+
+| Type | Variants | Quality | Store Original |
+|------|----------|---------|----------------|
+| `avatar` | xs, sm | 85 | Yes |
+| `member_photo` | xs, sm, md | 85 | Yes |
+| `gallery` | md, lg, xl | 85 | No |
+| `hero` | lg, xl, 2xl | 80 | No |
+| `content` | md, lg | 85 | Yes |
 
-------WebKitFormBoundary
-Content-Disposition: form-data; name="file"; filename="photo.jpg"
-Content-Type: image/jpeg
+## API Endpoints
 
-[binary image data]
-------WebKitFormBoundary
-Content-Disposition: form-data; name="sourceType"
+### `POST /image-pipeline/upload`
 
-avatar
-------WebKitFormBoundary
-Content-Disposition: form-data; name="sourceId"
+Upload an image for processing. Requires multipart form data.
 
-user123
-------WebKitFormBoundary--
-```
+**Fields:**
+- `file` (binary, required) — image file
+- `sourceType` (string, required) — one of the configured source types
+- `sourceId` (string, required) — identifier for the source entity
 
-**Response:** `202 Accepted`
+**Response (202 Accepted):**
 ```json
 {
-  "jobId": "clh7k9w1j0000nv8zk9k9k9k9",
+  "jobId": "clx1234...",
   "message": "File uploaded. Processing started.",
-  "statusUrl": "/media/status/clh7k9w1j0000nv8zk9k9k9k9"
+  "statusUrl": "/image-pipeline/status/clx1234..."
 }
 ```
 
-### Check Processing Status
+### `GET /image-pipeline/status/:jobId`
 
-```http
-GET /media/status/:jobId HTTP/1.1
-```
+Check job processing status.
 
-**Responses:**
+| Status | HTTP Code | Extra Fields |
+|--------|-----------|--------------|
+| PENDING | 202 | — |
+| PROCESSING | 202 | — |
+| COMPLETE | 200 | `media` object with urls, blurhash, dimensions |
+| REJECTED | 400 | `reason`, `moderationDetails` |
+| FAILED | 500 | `error`, `attempts` |
 
-While Processing (202):
+**Complete response example:**
 ```json
 {
-  "jobId": "clh7k9w1j0000nv8zk9k9k9k9",
-  "status": "PROCESSING",
-  "sourceType": "avatar",
-  "sourceId": "user123",
-  "createdAt": "2024-01-15T10:30:00Z",
-  "updatedAt": "2024-01-15T10:30:02Z"
-}
-```
-
-When Complete (200):
-```json
-{
-  "jobId": "clh7k9w1j0000nv8zk9k9k9k9",
+  "jobId": "clx1234...",
   "status": "COMPLETE",
-  "sourceType": "avatar",
-  "sourceId": "user123",
   "media": {
-    "id": "media-1705314600000-abc123",
-    "urls": {
-      "xs": "https://r2.example.com/media/avatar/user123/...-xs.webp",
-      "sm": "https://r2.example.com/media/avatar/user123/...-sm.webp",
-      "md": "https://r2.example.com/media/avatar/user123/...-md.webp"
-    },
-    "originalUrl": "https://r2.example.com/originals/avatar/user123/.../original.jpg",
-    "width": 2000,
-    "height": 2000,
-    "aspectRatio": "1:1",
-    "blurhash": "UeKUpMxua4t757oJodS3_3kCMd9F6p",
+    "id": "media-abc...",
+    "urls": { "xs": "https://cdn.../xs.webp", "sm": "https://cdn.../sm.webp" },
+    "originalUrl": "https://cdn.../original.jpg",
+    "width": 1920,
+    "height": 1080,
+    "aspectRatio": "16:9",
+    "blurhash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
     "focalPoint": { "x": 0.5, "y": 0.5 }
   }
 }
 ```
 
-When Rejected (400):
-```json
-{
-  "jobId": "clh7k9w1j0000nv8zk9k9k9k9",
-  "status": "REJECTED",
-  "reason": "REJECTED",
-  "moderationDetails": {
-    "flags": ["adult", "violence"],
-    "confidence": { "adult": 0.95 }
-  }
-}
-```
-
-When Failed (500):
-```json
-{
-  "jobId": "clh7k9w1j0000nv8zk9k9k9k9",
-  "status": "FAILED",
-  "error": "Failed to download from R2",
-  "attempts": 3
-}
-```
-
-## Source Types & Variant Presets
-
-The plugin comes with predefined source types and their variant presets:
-
-| Source Type | Variants | Use Case |
-|---|---|---|
-| `avatar` | xs, sm | User/band profile pictures |
-| `member_photo` | xs, sm, md | Member directory images |
-| `gallery` | md, lg, xl | Gallery display images |
-| `hero` | lg, xl, 2xl | Hero/banner backgrounds |
-| `content` | md, lg | Article/post images |
-
-Each source type generates only the specified variants. For example, `avatar` uploads will create `xs.webp` and `sm.webp` files.
-
-## Frontend Usage
-
-### React Example
-
-```jsx
-import { useEffect, useState } from 'react';
-
-function AvatarUpload({ userId }) {
-  const [jobId, setJobId] = useState(null);
-  const [status, setStatus] = useState(null);
-  const [loading, setLoading] = useState(false);
-
-  const handleUpload = async (file) => {
-    const formData = new FormData();
-    formData.append('file', file);
-    formData.append('sourceType', 'avatar');
-    formData.append('sourceId', userId);
-
-    const response = await fetch('/media/upload', {
-      method: 'POST',
-      body: formData,
-    });
-
-    const data = await response.json();
-    setJobId(data.jobId);
-  };
-
-  useEffect(() => {
-    if (!jobId) return;
-
-    const checkStatus = async () => {
-      const response = await fetch(`/media/status/${jobId}`);
-      const data = await response.json();
-      setStatus(data);
-
-      if (data.status === 'COMPLETE') {
-        setLoading(false);
-      }
-    };
-
-    const interval = setInterval(checkStatus, 2000);
-    return () => clearInterval(interval);
-  }, [jobId]);
-
-  return (
-    <div>
-      <input type="file" onChange={(e) => handleUpload(e.target.files[0])} />
-      {status?.media && (
-        <img src={status.media.urls.sm} alt="Avatar" />
-      )}
-      {status?.status === 'PROCESSING' && <p>Processing...</p>}
-      {status?.status === 'REJECTED' && <p>Image rejected: {status.reason}</p>}
-    </div>
-  );
-}
-```
-
-### Nuxt Example
-
-```vue
-<template>
-  <div>
-    <input type="file" @change="handleUpload" />
-
-    <div v-if="media">
-      <img :src="media.urls.sm" alt="Avatar" />
-      <div
-        v-if="media.blurhash"
-        :style="{ backgroundColor: blurhashColor }"
-        class="blur-placeholder"
-      />
-    </div>
-
-    <p v-if="status === 'PROCESSING'">Processing...</p>
-    <p v-if="status === 'REJECTED'">Image rejected</p>
-  </div>
-</template>
-
-<script setup>
-import { ref } from 'vue';
-
-const jobId = ref(null);
-const media = ref(null);
-const status = ref(null);
-
-const handleUpload = async (event) => {
-  const file = event.target.files[0];
-  const formData = new FormData();
-  formData.append('file', file);
-  formData.append('sourceType', 'avatar');
-  formData.append('sourceId', 'user123');
-
-  const response = await fetch('/media/upload', {
-    method: 'POST',
-    body: formData,
-  });
-
-  const { jobId: id } = await response.json();
-  jobId.value = id;
-  pollStatus();
-};
-
-const pollStatus = async () => {
-  const response = await fetch(`/media/status/${jobId.value}`);
-  const data = await response.json();
-  status.value = data.status;
-
-  if (data.status === 'COMPLETE') {
-    media.value = data.media;
-  } else if (data.status !== 'PROCESSING') {
-    setTimeout(pollStatus, 2000);
-  }
-};
-</script>
-```
-
-## Processing Pipeline
-
-1. **Upload** - File received at `/media/upload`
-2. **Queue** - Job created in database with `PENDING` status
-3. **Worker Polling** - Worker finds next job and locks it
-4. **Download** - File downloaded from staging bucket
-5. **EXIF Strip** - Metadata removed while preserving orientation
-6. **Moderation** - Content checked (if enabled)
-7. **Variants** - WebP variants generated at specified sizes
-8. **Blurhash** - Loading placeholder generated
-9. **Upload** - Variants and original uploaded to media bucket
-10. **Store** - Media record created with URLs and metadata
-11. **Cleanup** - Staging file deleted
-12. **Complete** - Job status updated to `COMPLETE`
-
-## Configuration
-
-### R2 Setup
-
-1. Create R2 bucket
-2. Generate API token
-3. Set CORS policy on bucket:
-   ```json
-   {
-     "CORSRules": [
-       {
-         "AllowedOrigins": ["https://yoursite.com"],
-         "AllowedMethods": ["GET"],
-         "AllowedHeaders": ["*"],
-         "MaxAgeSeconds": 3600
-       }
-     ]
-   }
-   ```
-
-4. Set lifecycle policy to clean staging:
-   ```
-   Delete objects in /staging/ older than 1 day
-   ```
-
-### Environment Variables
-
-```bash
-# R2
-R2_ENDPOINT=https://[account-id].r2.cloudflarestorage.com
-R2_ACCESS_KEY_ID=...
-R2_SECRET_ACCESS_KEY=...
-R2_BUCKET=my-media-bucket
-
-# Database (Prisma)
-DATABASE_URL=postgresql://...
-
-# Moderation (optional)
-MODERATION_PROVIDER=rekognition
-MODERATION_API_KEY=...
-```
-
-## Testing
-
-```bash
-npm test
-```
-
-## Performance Tips
-
-- 🚀 **Direct Upload**: Consider presigned URLs for large files to bypass server bandwidth
-- 🎯 **CDN**: Put R2 behind Cloudflare CDN for caching
-- ⚡ **Worker Pool**: Run multiple worker processes for faster processing
-- 📊 **Monitoring**: Monitor `MediaQueue` table for stuck jobs
-- 🧹 **Cleanup**: Run cleanup tasks regularly to remove orphaned files
-
-## Troubleshooting
-
-### Jobs stuck in PROCESSING
-
-Jobs are automatically recovered if locked > 5 minutes. To manually recover:
-
-```javascript
-import { recoverStaleLocks } from '@xenterprises/fastify-xmedia/workers/processor';
-
-await recoverStaleLocks(prisma, 5 * 60 * 1000);
-```
-
-### Missing variants
-
-Check that sourceType is in `getVariantPresets()`. Custom source types require variant config.
-
-### R2 upload failures
-
-- Verify credentials and bucket name
-- Check CORS policy
-- Ensure endpoint URL is correct
-
-## Future Enhancements
-
-- [ ] Direct browser-to-R2 uploads (presigned URLs)
-- [ ] Video support with thumbnails
-- [ ] Audio waveform generation
-- [ ] Batch uploads
-- [ ] AVIF format support
-- [ ] Face detection for smart cropping
-- [ ] Custom image filters/transforms
-- [ ] Analytics and usage tracking
+## Decorated Properties
+
+The plugin decorates `fastify.xImagePipeline` with:
+
+| Method | Signature | Description |
+|--------|-----------|-------------|
+| `getStatus` | `(jobId: string) => Promise<Object\|null>` | Get job with media relation |
+| `deleteMedia` | `(mediaId: string) => Promise<{ deleted, r2Deleted }>` | Delete media + R2 objects |
+| `listMedia` | `(sourceType, sourceId) => Promise<Object[]>` | List media by source |
+| `getVariantPresets` | `() => Object` | Get source type → variant name mapping |
+| `getSourceTypes` | `() => Object` | Get source type configurations |
+| `getVariants` | `() => Object` | Get variant dimension specs |
+
+## Exported Utilities
+
+### `@xenterprises/fastify-ximagepipeline/image`
+
+| Function | Description |
+|----------|-------------|
+| `stripExif(buffer)` | Remove EXIF metadata, preserve orientation |
+| `getImageMetadata(buffer)` | Extract width, height, format, colorspace, hasAlpha, density |
+| `compressToJpeg(buffer, quality?)` | Compress to JPEG (mozjpeg, default quality 85) |
+| `generateVariants(buffer, specs, sourceType, quality?)` | Generate WebP variants |
+| `generateBlurhash(buffer)` | Create 4x3 component blurhash |
+| `calculateFitDimensions(srcW, srcH, maxW, maxH)` | Aspect-ratio-preserving resize calc |
+| `getAspectRatio(width, height)` | Return ratio string like "16:9" |
+| `validateImage(buffer, options?)` | Validate dimensions and format |
+| `processImage(buffer, sourceType, config)` | Full pipeline: strip, metadata, variants, blurhash |
+
+### `@xenterprises/fastify-ximagepipeline/s3`
+
+| Function | Description |
+|----------|-------------|
+| `initializeS3Client(config)` | Create S3Client for R2/AWS |
+| `uploadToS3(client, bucket, key, buffer, options?)` | Upload with metadata + cache headers |
+| `downloadFromS3(client, bucket, key)` | Download buffer |
+| `deleteFromS3(client, bucket, key)` | Delete single object |
+| `listFromS3(client, bucket, prefix)` | List objects by prefix |
+| `getSignedUrlForS3(client, bucket, key, expiresIn?)` | Generate signed URL (default 1h) |
+| `getPublicUrl(r2Config, key)` | Generate public URL |
+| `batchDeleteFromS3(client, bucket, prefix)` | Delete up to 1000 objects by prefix |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `R2_ENDPOINT` | Yes | R2/S3-compatible endpoint URL |
+| `R2_ACCESS_KEY_ID` | Yes | Storage access key |
+| `R2_SECRET_ACCESS_KEY` | Yes | Storage secret key |
+| `R2_BUCKET` | Yes | Storage bucket name |
+| `DATABASE_URL` | Yes | Prisma database connection string |
+
+## Error Reference
+
+All errors are prefixed with `[xImagePipeline]`.
+
+| Error | When |
+|-------|------|
+| `R2 configuration is required` | Missing `r2` option |
+| `Database instance (Prisma client) is required` | Missing `db` option |
+| `R2 configuration must include: endpoint, accessKeyId, secretAccessKey, bucket` | Incomplete R2 config |
+| `No file provided` | Upload request has no file |
+| `File type {mime} not allowed` | Upload MIME type not in allowedMimeTypes |
+| `sourceType and sourceId are required` | Missing form fields on upload |
+| `Unknown sourceType: {type}` | sourceType not in variant presets |
+| `File too large. Maximum size: {n}MB` | File exceeds maxFileSize |
+| `Failed to upload file to storage` | R2 upload error |
+| `Failed to create processing job` | Database error during job creation |
+| `Media not found: {id}` | deleteMedia called with invalid ID |
+
+## Database Schema
+
+The plugin requires two Prisma models. See `SCHEMA.prisma` in the package for the full schema.
+
+**MediaQueue** — job queue for async processing (PENDING → PROCESSING → COMPLETE/REJECTED/FAILED)
+
+**Media** — processed media records with variant URLs, dimensions, blurhash, and metadata
+
+## How It Works
+
+1. **Upload**: Client sends multipart POST with image + sourceType + sourceId. The file is validated (type, size) and uploaded to R2 staging. A `MediaQueue` job is created with PENDING status.
+
+2. **Processing**: A background worker polls for PENDING jobs using pessimistic locking (prevents duplicate processing). For each job:
+   - Downloads from staging
+   - Strips EXIF metadata (preserves orientation)
+   - Extracts dimensions and format
+   - Runs content moderation (if configured)
+   - Generates WebP variants per sourceType config
+   - Generates blurhash placeholder
+   - Uploads variants (and optional original) to R2
+   - Creates `Media` record with URLs and metadata
+   - Marks job COMPLETE and cleans up staging
+
+3. **Retrieval**: Client polls the status endpoint. On COMPLETE, the response includes all variant URLs, blurhash, and dimensions for immediate frontend use.
+
+4. **Retry**: Failed jobs are retried up to `maxAttempts`. Stale locks (worker crashed) are automatically recovered after `lockTimeout`.
 
 ## License
 
-ISC
+UNLICENSED