@simo777/fastify-storage 1.0.0

package/README.md

@@ -0,0 +1,193 @@
+# Fastify Storage Plugin
+
+A scalable storage plugin for Fastify that supports local file storage and Cloudflare R2 (or any S3-compatible provider).
+
+## Features
+
+- **Deduplication**: Uses SHA-256 hashing to prevent duplicate file uploads.
+- **Media Processing**: Automatically extracts dimensions (width/height) for images/videos and duration for audio/video.
+- **Multi-provider Support**: Switch between `local` and `r2` (S3-compatible) via typed options.
+- **Prisma Integration**: Automatically tracks file metadata in your database.
+- **Multipart Support**: Handles file uploads out of the box.
+- **Local Serving**: Automatically serves local uploads via `@fastify/static`.
+- **SDK Included**: Type-safe SDK for interacting with the storage API.
+- **Custom Paths**: Organize files into folders (e.g., `/avatars/user-1.jpg`) across all providers.
+
+## Database Setup
+
+Add the following model to your `prisma/schema.prisma` file:
+
+```prisma
+model StoredFile {
+  id           String   @id @default(cuid())
+  key          String   @unique
+  bucket       String
+  provider     String   // "local", "r2", etc.
+  originalName String
+  mimeType     String
+  size         Int
+  url          String
+  type         String   // image | audio | video | file
+  hash         String   @unique // SHA-256 dedup key 
+  width        Int?
+  height       Int?
+  duration     Int?
+  createdAt    DateTime @default(now())
+  updatedAt    DateTime @updatedAt
+}
+```
+
+Then run:
+```bash
+npx prisma migrate dev --name add_stored_file
+```
+
+## Configuration
+
+Add these variables to your `.env` file:
+
+```env
+# Storage Provider: 'local' or 'r2'
+STORAGE_PROVIDER=local
+
+# Local Storage Configuration
+LOCAL_STORAGE_PATH=uploads
+LOCAL_STORAGE_PUBLIC_URL=http://localhost:3000/uploads
+
+# Cloudflare R2 / S3 Configuration
+R2_ENDPOINT=https://<account-id>.r2.cloudflarestorage.com
+R2_ACCESS_KEY_ID=your_access_key
+R2_SECRET_ACCESS_KEY=your_secret_key
+R2_BUCKET_NAME=your_bucket_name
+R2_PUBLIC_URL=https://pub-<your-id>.r2.dev
+```
+
+## Usage
+
+### Server-side (Fastify)
+
+Register the plugin with your desired configuration:
+
+```typescript
+import fastifyStorage from '@simo777/fastify-storage';
+
+await app.register(fastifyStorage, {
+  provider: 'local', // or 'r2'
+  local: {
+    storagePath: 'uploads',
+    publicUrl: 'http://localhost:3000/uploads'
+  },
+  // r2: {
+  //   endpoint: process.env.R2_ENDPOINT,
+  //   accessKeyId: process.env.R2_ACCESS_KEY_ID,
+  //   secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
+  //   bucketName: process.env.R2_BUCKET_NAME,
+  //   publicUrl: process.env.R2_PUBLIC_URL
+  // }
+});
+```
+
+The plugin decorates the Fastify instance with `storage`. You can use it in your services or controllers.
+
+#### Uploading a File
+```typescript
+// Inside a route or service
+const buffer = await data.toBuffer();
+const key = 'avatar.jpg';
+
+await fastify.storage.upload(buffer, {
+  key,
+  contentType: 'image/jpeg',
+  path: 'profiles/users' // Optional: results in profiles/users/avatar.jpg
+});
+```
+
+#### Deleting a File
+```typescript
+await fastify.storage.delete('file-key.pdf');
+```
+
+#### Checking existence
+```typescript
+const exists = await fastify.storage.exists('file-key.pdf');
+```
+
+### API Endpoints
+
+The plugin provides a module with the following endpoints (prefixed by your `API_PREFIX`):
+
+- `POST /storage/upload`: Upload a file (Multipart form-data). Supports optional `path` field.
+- `GET /storage`: List all files in the database.
+- `GET /storage/:id`: Get metadata for a specific file.
+- `PUT /storage/:id`: Replace an existing file.
+- `DELETE /storage/:id`: Delete a file from storage and database.
+- `GET /storage/signed-url?key=...`: Get a signed upload URL (R2 only).
+
+### Using the SDK
+
+```typescript
+import { AppSDK } from './sdk';
+
+const sdk = new AppSDK({
+  baseUrl: 'http://localhost:3000/api/v1'
+});
+
+// Upload a file from the browser to a specific folder
+const file = fileInput.files[0];
+const storedFile = await sdk.storage.upload(file, 'profile.jpg', 'avatars');
+
+console.log(storedFile.url); // e.g., .../avatars/profile.jpg
+
+// List files
+const files = await sdk.storage.list();
+```
+
+## Testing with Postman
+
+### 1. Upload a File
+- **Method**: `POST`
+- **URL**: `http://localhost:3000/api/v1/storage/upload`
+- **Body**: Select `form-data`
+  - Key: `file`, Value: [Select File], Type: `File`
+  - Key: `path`, Value: `my-folder`, Type: `Text` (Optional)
+
+### 2. List All Files
+- **Method**: `GET`
+- **URL**: `http://localhost:3000/api/v1/storage`
+
+### 3. Replace a File
+- **Method**: `PUT`
+- **URL**: `http://localhost:3000/api/v1/storage/:id` (Replace `:id` with a file ID from the list)
+- **Body**: `form-data`
+  - Key: `file`
+  - Value: Select a new file
+
+### 4. Delete a File
+- **Method**: `DELETE`
+- **URL**: `http://localhost:3000/api/v1/storage/:id`
+
+## Recommendations for Testing
+
+1.  **Local vs Production**:
+    *   Use `STORAGE_PROVIDER=local` for development and CI to avoid costs and network latency.
+    *   Use `STORAGE_PROVIDER=r2` in a staging environment that mirrors production.
+2.  **MIME Type Validation**:
+    *   The current implementation accepts all file types. For production, consider adding a hook or validation logic in `src/modules/storage/index.ts` to restrict allowed MIME types (e.g., `image/jpeg`, `application/pdf`).
+3.  **File Size Limits**:
+    *   Configure `@fastify/multipart` limits in `src/app.ts` to prevent large file uploads from crashing your server or filling up disk space:
+        ```typescript
+        await app.register(import('@fastify/multipart'), {
+          limits: { fileSize: 10 * 1024 * 1024 } // 10MB
+        });
+        ```
+4.  **Error Handling**:
+    *   Test what happens when the storage provider is unreachable (e.g., wrong R2 credentials). The plugin will currently throw a 500 error, which is caught by the global error handler.
+5.  **Database Sync**:
+    *   Verify that if a file upload fails, no entry is created in the database.
+    *   Verify that if a database deletion fails, the file is not deleted from the storage provider (or handle the rollback logic).
+
+## Adding New Providers
+
+To add a new provider (e.g., Azure Blob Storage):
+1. Implement the `StorageProvider` interface in `src/lib/storage/`.
+2. Update the factory in `src/lib/storage/index.ts` to include your new provider.

package/dist/src/app.d.ts

@@ -0,0 +1,3 @@
+import { TypeBoxTypeProvider } from '@fastify/type-provider-typebox';
+import Fastify from 'fastify';
+export declare function buildApp(): Promise<Fastify.FastifyInstance<import("node:http").Server<typeof import("node:http").IncomingMessage, typeof import("node:http").ServerResponse>, import("node:http").IncomingMessage, import("node:http").ServerResponse<import("node:http").IncomingMessage>, Fastify.FastifyBaseLogger, TypeBoxTypeProvider>>;

package/dist/src/app.js

@@ -0,0 +1,93 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import autoload from '@fastify/autoload';
+import cors from '@fastify/cors';
+import fastifyEnv from '@fastify/env';
+import Fastify from 'fastify';
+import { envSchema } from './config/env.js';
+import prismaPlugin from './plugins/prisma.js';
+import queuesPlugin from './plugins/queues.js';
+import redisPlugin from './plugins/redis.js';
+import storagePlugin from './plugins/storage.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function parseCorsOrigin(origin) {
+    if (origin === '*') {
+        return true;
+    }
+    return origin
+        .split(',')
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+export async function buildApp() {
+    const app = Fastify({
+        logger: {
+            level: process.env.LOG_LEVEL ?? 'info'
+        }
+    }).withTypeProvider();
+    await app.register(fastifyEnv, {
+        schema: envSchema,
+        dotenv: true
+    });
+    await app.register(cors, {
+        origin: parseCorsOrigin(app.config.CORS_ORIGIN),
+        credentials: true
+    });
+    await app.register(import('@fastify/multipart'), {
+        limits: { fileSize: 10 * 1024 * 1024 } // 10MB
+    });
+    if (app.config.STORAGE_PROVIDER === 'local') {
+        const { promises: fs } = await import('node:fs');
+        const storagePath = join(process.cwd(), app.config.LOCAL_STORAGE_PATH);
+        await fs.mkdir(storagePath, { recursive: true });
+        await app.register(import('@fastify/static'), {
+            root: storagePath,
+            prefix: '/uploads/',
+            decorateReply: false
+        });
+    }
+    await app.register(prismaPlugin);
+    await app.register(redisPlugin);
+    await app.register(queuesPlugin);
+    await app.register(storagePlugin, {
+        provider: app.config.STORAGE_PROVIDER,
+        defaultPath: app.config.STORAGE_DEFAULT_PATH,
+        local: {
+            storagePath: app.config.LOCAL_STORAGE_PATH,
+            publicUrl: app.config.LOCAL_STORAGE_PUBLIC_URL
+        },
+        r2: app.config.STORAGE_PROVIDER === 'r2' ? {
+            endpoint: app.config.R2_ENDPOINT,
+            accessKeyId: app.config.R2_ACCESS_KEY_ID,
+            secretAccessKey: app.config.R2_SECRET_ACCESS_KEY,
+            bucketName: app.config.R2_BUCKET_NAME,
+            publicUrl: app.config.R2_PUBLIC_URL
+        } : undefined
+    });
+    app.get('/', async () => ({
+        name: 'fastify-template',
+        status: 'ok',
+        docs: `${app.config.API_PREFIX}/health`
+    }));
+    await app.register(autoload, {
+        dir: join(__dirname, 'modules'),
+        forceESM: true,
+        options: {
+            prefix: app.config.API_PREFIX
+        }
+    });
+    app.setErrorHandler((error, request, reply) => {
+        request.log.error(error);
+        const errorWithStatus = error;
+        const statusCode = typeof errorWithStatus.statusCode === 'number' && errorWithStatus.statusCode >= 400
+            ? errorWithStatus.statusCode
+            : 500;
+        const message = error instanceof Error ? error.message : 'Unexpected error';
+        return reply.status(statusCode).send({
+            error: statusCode === 500 ? 'Internal Server Error' : message,
+            statusCode
+        });
+    });
+    return app;
+}
+//# sourceMappingURL=app.js.map

package/dist/src/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"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"}

package/dist/src/config/env.d.ts

@@ -0,0 +1,26 @@
+import { type Static } from '@sinclair/typebox';
+export declare const envSchema: import("@sinclair/typebox").TObject<{
+    NODE_ENV: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"development">, import("@sinclair/typebox").TLiteral<"test">, import("@sinclair/typebox").TLiteral<"production">]>;
+    HOST: import("@sinclair/typebox").TString;
+    PORT: import("@sinclair/typebox").TNumber;
+    LOG_LEVEL: import("@sinclair/typebox").TString;
+    API_PREFIX: import("@sinclair/typebox").TString;
+    CORS_ORIGIN: import("@sinclair/typebox").TString;
+    DATABASE_URL: import("@sinclair/typebox").TString;
+    REDIS_URL: import("@sinclair/typebox").TString;
+    STORAGE_PROVIDER: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"local">, import("@sinclair/typebox").TLiteral<"r2">]>;
+    LOCAL_STORAGE_PATH: import("@sinclair/typebox").TString;
+    LOCAL_STORAGE_PUBLIC_URL: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    R2_ENDPOINT: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    R2_ACCESS_KEY_ID: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    R2_SECRET_ACCESS_KEY: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    R2_BUCKET_NAME: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    R2_PUBLIC_URL: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    STORAGE_DEFAULT_PATH: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export type Env = Static<typeof envSchema>;
+declare module 'fastify' {
+    interface FastifyInstance {
+        config: Env;
+    }
+}

package/dist/src/config/env.js

@@ -0,0 +1,28 @@
+import { Type } from '@sinclair/typebox';
+export const envSchema = Type.Object({
+    NODE_ENV: Type.Union([
+        Type.Literal('development'),
+        Type.Literal('test'),
+        Type.Literal('production')
+    ], { default: 'development' }),
+    HOST: Type.String({ default: '0.0.0.0' }),
+    PORT: Type.Number({ default: 3000 }),
+    LOG_LEVEL: Type.String({ default: 'info' }),
+    API_PREFIX: Type.String({ default: '/api/v1' }),
+    CORS_ORIGIN: Type.String({ default: '*' }),
+    DATABASE_URL: Type.String(),
+    REDIS_URL: Type.String(),
+    STORAGE_PROVIDER: Type.Union([
+        Type.Literal('local'),
+        Type.Literal('r2')
+    ], { default: 'local' }),
+    LOCAL_STORAGE_PATH: Type.String({ default: 'uploads' }),
+    LOCAL_STORAGE_PUBLIC_URL: Type.Optional(Type.String()),
+    R2_ENDPOINT: Type.Optional(Type.String()),
+    R2_ACCESS_KEY_ID: Type.Optional(Type.String()),
+    R2_SECRET_ACCESS_KEY: Type.Optional(Type.String()),
+    R2_BUCKET_NAME: Type.Optional(Type.String()),
+    R2_PUBLIC_URL: Type.Optional(Type.String()),
+    STORAGE_DEFAULT_PATH: Type.Optional(Type.String()),
+});
+//# sourceMappingURL=env.js.map

package/dist/src/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,mBAAmB,CAAC;AAEtD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC;QACnB,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;QACpB,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;KAC3B,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;IAC9B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACzC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3C,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IAC/C,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC1C,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE;IAC3B,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE;IACxB,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;KACnB,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACxB,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;IACvD,wBAAwB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACtD,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACzC,gBAAgB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9C,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAClD,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5C,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IAC3C,oBAAoB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;CACnD,CAAC,CAAC"}

package/dist/src/lib/storage/index.d.ts

@@ -0,0 +1,20 @@
+import { StorageProvider } from './provider.js';
+export * from './provider.js';
+export * from './local.js';
+export * from './r2.js';
+export interface StoragePluginOptions {
+    provider: 'local' | 'r2';
+    defaultPath?: string | undefined;
+    local?: {
+        storagePath: string;
+        publicUrl?: string | undefined;
+    } | undefined;
+    r2?: {
+        endpoint: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+        bucketName: string;
+        publicUrl?: string | undefined;
+    } | undefined;
+}
+export declare function createStorageProvider(options: StoragePluginOptions): StorageProvider;

package/dist/src/lib/storage/index.js

@@ -0,0 +1,28 @@
+import { LocalStorageProvider } from './local.js';
+import { R2StorageProvider } from './r2.js';
+export * from './provider.js';
+export * from './local.js';
+export * from './r2.js';
+export function createStorageProvider(options) {
+    if (options.provider === 'r2') {
+        const config = options.r2;
+        if (!config || !config.endpoint || !config.accessKeyId || !config.secretAccessKey || !config.bucketName) {
+            throw new Error('R2 storage configuration is missing');
+        }
+        return new R2StorageProvider({
+            endpoint: config.endpoint,
+            accessKeyId: config.accessKeyId,
+            secretAccessKey: config.secretAccessKey,
+            bucket: config.bucketName,
+            publicUrl: config.publicUrl,
+        });
+    }
+    // Default to local
+    const config = options.local;
+    if (!config || !config.storagePath) {
+        throw new Error('Local storage configuration is missing');
+    }
+    return new LocalStorageProvider(config.storagePath, config.publicUrl || '/uploads' // Fallback
+    );
+}
+//# sourceMappingURL=index.js.map

package/dist/src/lib/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAG5C,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AAoBxB,MAAM,UAAU,qBAAqB,CAAC,OAA6B;IACjE,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACxG,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,IAAI,iBAAiB,CAAC;YAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,MAAM,EAAE,MAAM,CAAC,UAAU;YACzB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,mBAAmB;IACnB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,IAAI,oBAAoB,CAC7B,MAAM,CAAC,WAAW,EAClB,MAAM,CAAC,SAAS,IAAI,UAAU,CAAC,WAAW;KAC3C,CAAC;AACJ,CAAC"}

package/dist/src/lib/storage/local.d.ts

@@ -0,0 +1,15 @@
+import { StorageProvider, UploadOptions } from './provider.js';
+export declare class LocalStorageProvider implements StorageProvider {
+    private baseDir;
+    private baseUrl;
+    constructor(baseDir: string, baseUrl: string);
+    upload(file: Buffer, options: UploadOptions): Promise<string>;
+    delete(key: string): Promise<void>;
+    getPublicUrl(key: string): string;
+    exists(key: string): Promise<boolean>;
+    getMetadata(key: string): Promise<{
+        contentType?: string;
+        contentLength?: number;
+        lastModified?: Date;
+    } | null>;
+}

package/dist/src/lib/storage/local.js

@@ -0,0 +1,55 @@
+import { promises as fs } from 'node:fs';
+import { join, dirname } from 'node:path';
+export class LocalStorageProvider {
+    baseDir;
+    baseUrl;
+    constructor(baseDir, baseUrl) {
+        this.baseDir = baseDir;
+        this.baseUrl = baseUrl;
+    }
+    async upload(file, options) {
+        const fullKey = options.path ? join(options.path, options.key) : options.key;
+        const filePath = join(this.baseDir, fullKey);
+        await fs.mkdir(dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, file);
+        return fullKey;
+    }
+    async delete(key) {
+        const filePath = join(this.baseDir, key);
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
+    getPublicUrl(key) {
+        return `${this.baseUrl}/${key}`;
+    }
+    async exists(key) {
+        const filePath = join(this.baseDir, key);
+        try {
+            await fs.access(filePath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getMetadata(key) {
+        const filePath = join(this.baseDir, key);
+        try {
+            const stats = await fs.stat(filePath);
+            return {
+                contentLength: stats.size,
+                lastModified: stats.mtime,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/src/lib/storage/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../src/lib/storage/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,OAAO,oBAAoB;IACX,OAAO;IAAkB,OAAO;IAApD,YAAoB,OAAe,EAAU,OAAe;uBAAxC,OAAO;uBAAkB,OAAO;IAAW,CAAC;IAEhE,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,OAAsB;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC7C,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY,CAAC,GAAW;QACtB,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,EAAE,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,OAAO;gBACL,aAAa,EAAE,KAAK,CAAC,IAAI;gBACzB,YAAY,EAAE,KAAK,CAAC,KAAK;aAC1B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/src/lib/storage/provider.d.ts

@@ -0,0 +1,23 @@
+export interface UploadOptions {
+    key: string;
+    contentType?: string | undefined;
+    path?: string | undefined;
+}
+export interface FileMetadata {
+    contentType?: string | undefined;
+    contentLength?: number | undefined;
+    lastModified?: Date | undefined;
+    etag?: string | undefined;
+    metadata?: Record<string, string> | undefined;
+}
+export interface StorageProvider {
+    upload(file: Buffer, options: UploadOptions): Promise<string>;
+    delete(key: string): Promise<void>;
+    getPublicUrl(key: string): string;
+    exists(key: string): Promise<boolean>;
+    getMetadata(key: string): Promise<FileMetadata | null>;
+    generateSignedUploadUrl?(key: string, options: {
+        expiresIn?: number | undefined;
+        contentType?: string | undefined;
+    }): Promise<string>;
+}

package/dist/src/lib/storage/provider.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.js.map

package/dist/src/lib/storage/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../../src/lib/storage/provider.ts"],"names":[],"mappings":""}

package/dist/src/lib/storage/r2.d.ts

@@ -0,0 +1,28 @@
+import { StorageProvider, UploadOptions } from './provider.js';
+export declare class R2StorageProvider implements StorageProvider {
+    private client;
+    private bucket;
+    private publicUrl;
+    constructor(config: {
+        endpoint: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+        bucket: string;
+        publicUrl?: string | undefined;
+    });
+    upload(file: Buffer, options: UploadOptions): Promise<string>;
+    delete(key: string): Promise<void>;
+    getPublicUrl(key: string): string;
+    exists(key: string): Promise<boolean>;
+    getMetadata(key: string): Promise<{
+        contentType: string | undefined;
+        contentLength: number | undefined;
+        lastModified: Date | undefined;
+        etag: string | undefined;
+        metadata: Record<string, string> | undefined;
+    } | null>;
+    generateSignedUploadUrl(key: string, options?: {
+        expiresIn?: number | undefined;
+        contentType?: string | undefined;
+    }): Promise<string>;
+}

package/dist/src/lib/storage/r2.js

@@ -0,0 +1,85 @@
+import { S3Client, PutObjectCommand, DeleteObjectCommand, HeadObjectCommand } from '@aws-sdk/client-s3';
+export class R2StorageProvider {
+    client;
+    bucket;
+    publicUrl;
+    constructor(config) {
+        this.client = new S3Client({
+            region: 'auto',
+            endpoint: config.endpoint,
+            credentials: {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            },
+        });
+        this.bucket = config.bucket;
+        this.publicUrl = config.publicUrl || `${config.endpoint}/${config.bucket}`;
+    }
+    async upload(file, options) {
+        const fullKey = options.path ? `${options.path.replace(/\/$/, '')}/${options.key}` : options.key;
+        await this.client.send(new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: fullKey,
+            Body: file,
+            ContentType: options.contentType,
+        }));
+        return fullKey;
+    }
+    async delete(key) {
+        await this.client.send(new DeleteObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+        }));
+    }
+    getPublicUrl(key) {
+        return `${this.publicUrl}/${key}`;
+    }
+    async exists(key) {
+        try {
+            await this.client.send(new HeadObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            }));
+            return true;
+        }
+        catch (error) {
+            if (error.name === 'NotFound' || error.$metadata?.httpStatusCode === 404) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async getMetadata(key) {
+        try {
+            const response = await this.client.send(new HeadObjectCommand({
+                Bucket: this.bucket,
+                Key: key,
+            }));
+            return {
+                contentType: response.ContentType,
+                contentLength: response.ContentLength,
+                lastModified: response.LastModified,
+                etag: response.ETag,
+                metadata: response.Metadata,
+            };
+        }
+        catch (error) {
+            if (error.name === 'NotFound' || error.$metadata?.httpStatusCode === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    async generateSignedUploadUrl(key, options = {}) {
+        const { getSignedUrl } = await import('@aws-sdk/s3-request-presigner');
+        const command = new PutObjectCommand({
+            Bucket: this.bucket,
+            Key: key,
+            ContentType: options.contentType,
+        });
+        return getSignedUrl(this.client, command, {
+            expiresIn: options.expiresIn ?? 3600,
+        });
+    }
+}
+//# sourceMappingURL=r2.js.map

package/dist/src/lib/storage/r2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.js","sourceRoot":"","sources":["../../../../src/lib/storage/r2.ts"],"names":[],"mappings":"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"}

package/dist/src/modules/health/index.d.ts

@@ -0,0 +1,2 @@
+import type { FastifyInstance } from 'fastify';
+export default function (fastify: FastifyInstance): Promise<void>;