@fade_networker/vono 0.1.0

package/dist/server/storage/drivers/cloudinary.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { StorageDriver, UploadOptions, UploadResult } from '../types.js';
+export interface CloudinaryConfig {
+    cloudName: string;
+    apiKey: string;
+    apiSecret: string;
+    /** Upload preset (optional) */
+    uploadPreset?: string;
+}
+/**
+ * Cloudinary image CDN driver.
+ * Uses the Cloudinary Upload API (no SDK — pure fetch).
+ */
+export declare class CloudinaryDriver implements StorageDriver {
+    private readonly config;
+    constructor(config: CloudinaryConfig);
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
+    delete(key: string): Promise<void>;
+    url(key: string): string;
+    private _sign;
+}
+//# sourceMappingURL=cloudinary.d.ts.map

package/dist/server/storage/drivers/cloudinary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudinary.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/drivers/cloudinary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,+BAA+B;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAID;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,gBAAgB;IAE/C,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IA0ClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;YAIV,KAAK;CAYpB"}

package/dist/server/storage/drivers/cloudinary.js

@@ -0,0 +1,86 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { Logger } from '../../../shared/utils/logger.js';
+// ─── CloudinaryDriver ─────────────────────────────────────────────────────────
+/**
+ * Cloudinary image CDN driver.
+ * Uses the Cloudinary Upload API (no SDK — pure fetch).
+ */
+export class CloudinaryDriver {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async upload(file, options) {
+        const url = `https://api.cloudinary.com/v1_1/${this.config.cloudName}/auto/upload`;
+        const formData = new FormData();
+        formData.append('file', file);
+        formData.append('api_key', this.config.apiKey);
+        if (options?.key) {
+            formData.append('public_id', options.key.replace(/\.[^.]+$/, ''));
+        }
+        if (this.config.uploadPreset) {
+            formData.append('upload_preset', this.config.uploadPreset);
+        }
+        // Generate signature for authenticated upload
+        const timestamp = Math.floor(Date.now() / 1000).toString();
+        formData.append('timestamp', timestamp);
+        const signature = await this._sign({ timestamp, public_id: options?.key });
+        formData.append('signature', signature);
+        const res = await fetch(url, { method: 'POST', body: formData });
+        if (!res.ok) {
+            const body = await res.text();
+            Logger.error('[storage:cloudinary] Upload failed', { status: res.status, body });
+            throw new Error(`Cloudinary upload error: ${res.status}`);
+        }
+        const data = await res.json();
+        Logger.info('[storage:cloudinary] File uploaded', { publicId: data.public_id });
+        return {
+            key: data.public_id,
+            url: data.secure_url,
+            size: data.bytes,
+            contentType: options?.contentType ?? `image/${data.format}`,
+        };
+    }
+    async delete(key) {
+        const timestamp = Math.floor(Date.now() / 1000).toString();
+        const signature = await this._sign({ public_id: key, timestamp });
+        const res = await fetch(`https://api.cloudinary.com/v1_1/${this.config.cloudName}/image/destroy`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                public_id: key,
+                api_key: this.config.apiKey,
+                timestamp,
+                signature,
+            }),
+        });
+        if (!res.ok) {
+            Logger.error('[storage:cloudinary] Delete failed', { key, status: res.status });
+            throw new Error(`Cloudinary delete error: ${res.status}`);
+        }
+        Logger.info('[storage:cloudinary] File deleted', { key });
+    }
+    url(key) {
+        return `https://res.cloudinary.com/${this.config.cloudName}/image/upload/${key}`;
+    }
+    async _sign(params) {
+        // Build sorted param string (exclude api_key, file, resource_type, cloud_name)
+        const sorted = Object.entries(params)
+            .filter(([, v]) => v !== undefined)
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${k}=${v}`)
+            .join('&');
+        const toSign = `${sorted}${this.config.apiSecret}`;
+        const buffer = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(toSign));
+        return Array.from(new Uint8Array(buffer)).map((b) => b.toString(16).padStart(2, '0')).join('');
+    }
+}
+//# sourceMappingURL=cloudinary.js.map

package/dist/server/storage/drivers/cloudinary.js.map

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

package/dist/server/storage/drivers/local.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { StorageDriver, UploadOptions, UploadResult } from '../types.js';
+/**
+ * Local storage driver — saves files to `./storage/uploads/`.
+ * Files are served at `/uploads/<key>`.
+ *
+ * For development and single-server deployments only.
+ */
+export declare class LocalDriver implements StorageDriver {
+    private readonly uploadDir;
+    private readonly baseUrl;
+    constructor(options?: {
+        uploadDir?: string;
+        baseUrl?: string;
+    });
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
+    delete(key: string): Promise<void>;
+    url(key: string): string;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/server/storage/drivers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/drivers/local.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI7E;;;;;GAKG;AACH,qBAAa,WAAY,YAAW,aAAa;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAQ;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;gBAEpB,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE;IAKxD,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAsBlE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAIzB"}

package/dist/server/storage/drivers/local.js

@@ -0,0 +1,57 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { join } from 'node:path';
+import { mkdirSync, writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { generateId } from '../../../shared/utils/id.js';
+import { Logger } from '../../../shared/utils/logger.js';
+// ─── LocalDriver ─────────────────────────────────────────────────────────────
+/**
+ * Local storage driver — saves files to `./storage/uploads/`.
+ * Files are served at `/uploads/<key>`.
+ *
+ * For development and single-server deployments only.
+ */
+export class LocalDriver {
+    uploadDir;
+    baseUrl;
+    constructor(options) {
+        this.uploadDir = options?.uploadDir ?? join(process.cwd(), 'storage', 'uploads');
+        this.baseUrl = options?.baseUrl ?? '/uploads';
+    }
+    async upload(file, options) {
+        const ext = file.name.split('.').pop() ?? 'bin';
+        const key = options?.key ?? `${generateId()}.${ext}`;
+        const filePath = join(this.uploadDir, key);
+        // Ensure directory exists
+        const dir = filePath.substring(0, filePath.lastIndexOf('/'));
+        mkdirSync(dir, { recursive: true });
+        const buffer = await file.arrayBuffer();
+        writeFileSync(filePath, Buffer.from(buffer));
+        Logger.info('[storage:local] File uploaded', { key, size: file.size });
+        return {
+            key,
+            url: this.url(key),
+            size: file.size,
+            contentType: options?.contentType ?? file.type,
+        };
+    }
+    async delete(key) {
+        const filePath = join(this.uploadDir, key);
+        if (existsSync(filePath)) {
+            unlinkSync(filePath);
+            Logger.info('[storage:local] File deleted', { key });
+        }
+    }
+    url(key) {
+        const normalised = key.startsWith('/') ? key.slice(1) : key;
+        return `${this.baseUrl}/${normalised}`;
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/server/storage/drivers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../../../src/server/storage/drivers/local.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAA;AAGxD,gFAAgF;AAEhF;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IACL,SAAS,CAAQ;IACjB,OAAO,CAAQ;IAEhC,YAAY,OAAkD;QAC5D,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAA;QAChF,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,UAAU,CAAA;IAC/C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAU,EAAE,OAAuB;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,CAAA;QAC/C,MAAM,GAAG,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,UAAU,EAAE,IAAI,GAAG,EAAE,CAAA;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QAE1C,0BAA0B;QAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;QAC5D,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAEnC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAA;QACvC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;QAE5C,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAEtE,OAAO;YACL,GAAG;YACH,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAClB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,IAAI,CAAC,IAAI;SAC/C,CAAA;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;QAC1C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,QAAQ,CAAC,CAAA;YACpB,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE,EAAE,GAAG,EAAE,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED,GAAG,CAAC,GAAW;QACb,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;QAC3D,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE,CAAA;IACxC,CAAC;CACF"}

package/dist/server/storage/drivers/r2.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { StorageDriver, UploadOptions, UploadResult } from '../types.js';
+export interface R2Config {
+    accountId: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucketName: string;
+    /** Public CDN base URL (e.g. https://pub-xxx.r2.dev) */
+    baseUrl: string;
+}
+/**
+ * Cloudflare R2 storage driver — uses the S3-compatible API.
+ *
+ * Requires `@aws-sdk/client-s3` for the S3-compatible upload.
+ * R2 endpoint: `https://<accountId>.r2.cloudflarestorage.com`
+ */
+export declare class R2Driver implements StorageDriver {
+    private readonly config;
+    constructor(config: R2Config);
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
+    delete(key: string): Promise<void>;
+    url(key: string): string;
+}
+//# sourceMappingURL=r2.d.ts.map

package/dist/server/storage/drivers/r2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/drivers/r2.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE7E,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;CAChB;AAID;;;;;GAKG;AACH,qBAAa,QAAS,YAAW,aAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAEvC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAkClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAKzB"}

package/dist/server/storage/drivers/r2.js

@@ -0,0 +1,70 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { generateId } from '../../../shared/utils/id.js';
+import { Logger } from '../../../shared/utils/logger.js';
+// ─── R2Driver ────────────────────────────────────────────────────────────────
+/**
+ * Cloudflare R2 storage driver — uses the S3-compatible API.
+ *
+ * Requires `@aws-sdk/client-s3` for the S3-compatible upload.
+ * R2 endpoint: `https://<accountId>.r2.cloudflarestorage.com`
+ */
+export class R2Driver {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async upload(file, options) {
+        const { S3Client, PutObjectCommand } = await import('@aws-sdk/client-s3').catch(() => {
+            throw new Error('[storage:r2] @aws-sdk/client-s3 is not installed. Run: bun add @aws-sdk/client-s3');
+        });
+        const ext = file.name.split('.').pop() ?? 'bin';
+        const key = options?.key ?? `${generateId()}.${ext}`;
+        const contentType = options?.contentType ?? file.type;
+        const client = new S3Client({
+            region: 'auto',
+            endpoint: `https://${this.config.accountId}.r2.cloudflarestorage.com`,
+            credentials: {
+                accessKeyId: this.config.accessKeyId,
+                secretAccessKey: this.config.secretAccessKey,
+            },
+        });
+        const buffer = await file.arrayBuffer();
+        await client.send(new PutObjectCommand({
+            Bucket: this.config.bucketName,
+            Key: key,
+            Body: Buffer.from(buffer),
+            ContentType: contentType,
+        }));
+        Logger.info('[storage:r2] File uploaded', { key, size: file.size });
+        return { key, url: this.url(key), size: file.size, contentType };
+    }
+    async delete(key) {
+        const { S3Client, DeleteObjectCommand } = await import('@aws-sdk/client-s3').catch(() => {
+            throw new Error('[storage:r2] @aws-sdk/client-s3 is not installed.');
+        });
+        const client = new S3Client({
+            region: 'auto',
+            endpoint: `https://${this.config.accountId}.r2.cloudflarestorage.com`,
+            credentials: {
+                accessKeyId: this.config.accessKeyId,
+                secretAccessKey: this.config.secretAccessKey,
+            },
+        });
+        await client.send(new DeleteObjectCommand({ Bucket: this.config.bucketName, Key: key }));
+        Logger.info('[storage:r2] File deleted', { key });
+    }
+    url(key) {
+        const base = this.config.baseUrl.endsWith('/') ? this.config.baseUrl.slice(0, -1) : this.config.baseUrl;
+        const normalised = key.startsWith('/') ? key.slice(1) : key;
+        return `${base}/${normalised}`;
+    }
+}
+//# sourceMappingURL=r2.js.map

package/dist/server/storage/drivers/r2.js.map

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

package/dist/server/storage/drivers/s3.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import type { StorageDriver, UploadOptions, UploadResult } from '../types.js';
+export interface S3Config {
+    bucket: string;
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    /** Public base URL (e.g. https://my-bucket.s3.amazonaws.com) */
+    baseUrl?: string;
+}
+/**
+ * AWS S3 storage driver using `@aws-sdk/client-s3`.
+ */
+export declare class S3Driver implements StorageDriver {
+    private readonly config;
+    constructor(config: S3Config);
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
+    delete(key: string): Promise<void>;
+    url(key: string): string;
+}
+//# sourceMappingURL=s3.d.ts.map

package/dist/server/storage/drivers/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../../src/server/storage/drivers/s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE7E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAID;;GAEG;AACH,qBAAa,QAAS,YAAW,aAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAEvC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAiClE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBxC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;CAOzB"}

package/dist/server/storage/drivers/s3.js

@@ -0,0 +1,68 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+import { generateId } from '../../../shared/utils/id.js';
+import { Logger } from '../../../shared/utils/logger.js';
+// ─── S3Driver ────────────────────────────────────────────────────────────────
+/**
+ * AWS S3 storage driver using `@aws-sdk/client-s3`.
+ */
+export class S3Driver {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async upload(file, options) {
+        const { S3Client, PutObjectCommand } = await import('@aws-sdk/client-s3').catch(() => {
+            throw new Error('[storage:s3] @aws-sdk/client-s3 is not installed. Run: bun add @aws-sdk/client-s3');
+        });
+        const ext = file.name.split('.').pop() ?? 'bin';
+        const key = options?.key ?? `${generateId()}.${ext}`;
+        const contentType = options?.contentType ?? file.type;
+        const client = new S3Client({
+            region: this.config.region,
+            credentials: {
+                accessKeyId: this.config.accessKeyId,
+                secretAccessKey: this.config.secretAccessKey,
+            },
+        });
+        const buffer = await file.arrayBuffer();
+        await client.send(new PutObjectCommand({
+            Bucket: this.config.bucket,
+            Key: key,
+            Body: Buffer.from(buffer),
+            ContentType: contentType,
+            ACL: options?.public !== false ? 'public-read' : 'private',
+        }));
+        Logger.info('[storage:s3] File uploaded', { key, size: file.size });
+        return { key, url: this.url(key), size: file.size, contentType };
+    }
+    async delete(key) {
+        const { S3Client, DeleteObjectCommand } = await import('@aws-sdk/client-s3').catch(() => {
+            throw new Error('[storage:s3] @aws-sdk/client-s3 is not installed.');
+        });
+        const client = new S3Client({
+            region: this.config.region,
+            credentials: {
+                accessKeyId: this.config.accessKeyId,
+                secretAccessKey: this.config.secretAccessKey,
+            },
+        });
+        await client.send(new DeleteObjectCommand({ Bucket: this.config.bucket, Key: key }));
+        Logger.info('[storage:s3] File deleted', { key });
+    }
+    url(key) {
+        const base = this.config.baseUrl
+            ? (this.config.baseUrl.endsWith('/') ? this.config.baseUrl.slice(0, -1) : this.config.baseUrl)
+            : `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com`;
+        const normalised = key.startsWith('/') ? key.slice(1) : key;
+        return `${base}/${normalised}`;
+    }
+}
+//# sourceMappingURL=s3.js.map

package/dist/server/storage/drivers/s3.js.map

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

package/dist/server/storage/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { useStorage } from './use-storage.js';
+export type { StorageDriver, StorageConfig, UploadOptions, UploadResult } from './types.js';
+export { LocalDriver } from './drivers/local.js';
+export { R2Driver } from './drivers/r2.js';
+export { S3Driver } from './drivers/s3.js';
+export { CloudinaryDriver } from './drivers/cloudinary.js';
+export { BunnyDriver } from './drivers/bunny.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/server/storage/index.js

@@ -0,0 +1,16 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export { useStorage } from './use-storage.js';
+export { LocalDriver } from './drivers/local.js';
+export { R2Driver } from './drivers/r2.js';
+export { S3Driver } from './drivers/s3.js';
+export { CloudinaryDriver } from './drivers/cloudinary.js';
+export { BunnyDriver } from './drivers/bunny.js';
+//# sourceMappingURL=index.js.map

package/dist/server/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/storage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE7C,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/server/storage/types.d.ts

@@ -0,0 +1,70 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export interface UploadOptions {
+    /** Target key / path in the storage bucket */
+    key?: string;
+    /** MIME type override */
+    contentType?: string;
+    /** Whether the file should be publicly accessible */
+    public?: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, string>;
+}
+export interface UploadResult {
+    /** Storage key (path) of the uploaded file */
+    key: string;
+    /** Public URL of the uploaded file */
+    url: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    contentType: string;
+}
+/**
+ * StorageDriver — interface that all storage drivers must implement.
+ *
+ * @example
+ * ```ts
+ * const storage = useStorage(c)
+ * const result = await storage.upload(file, { key: 'avatars/user-123.jpg' })
+ * const url = storage.url('avatars/user-123.jpg')
+ * await storage.delete('avatars/user-123.jpg')
+ * ```
+ */
+export interface StorageDriver {
+    /**
+     * Upload a file to storage.
+     * @param file - File object from multipart form data
+     * @param options - Optional upload configuration
+     */
+    upload(file: File, options?: UploadOptions): Promise<UploadResult>;
+    /**
+     * Delete a file from storage by key.
+     * @param key - Storage key / path
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Get the public URL for a stored file.
+     * @param key - Storage key / path
+     */
+    url(key: string): string;
+}
+export interface StorageConfig {
+    driver: 'local' | 'r2' | 's3' | 'cloudinary' | 'bunny';
+    /** Max file size in bytes (default: 10MB) */
+    maxSize?: number;
+    /** Allowed MIME types (default: all) */
+    allowedMimeTypes?: string[];
+    /** Base URL for CDN drivers */
+    baseUrl?: string;
+    /** Local upload directory (default: ./storage/uploads) */
+    uploadDir?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/server/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAA;IACX,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAA;IACX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAA;CACpB;AAID;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAElE;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CACzB;AAID,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,YAAY,GAAG,OAAO,CAAA;IACtD,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC3B,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/server/storage/types.js

@@ -0,0 +1,11 @@
+/**
+ * ──────────────────────────────────────────────────────────────────
+ * 🏢 Company Name: Bonifade Technologies
+ * 👨‍💻 Developer: Bowofade Oyerinde
+ * 🐙 GitHub: oyenet1
+ * 📅 Created Date: 2026-04-05
+ * 🔄 Updated Date: 2026-04-05
+ * ──────────────────────────────────────────────────────────────────
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/server/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/server/storage/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}