@fluxmedia/s3 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FluxMedia Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,76 @@
+# @fluxmedia/s3
+
+AWS S3 provider for FluxMedia.
+
+## Installation
+
+```bash
+pnpm add @fluxmedia/core @fluxmedia/s3 @aws-sdk/client-s3
+```
+
+## Usage
+
+```typescript
+import { MediaUploader } from '@fluxmedia/core';
+import { S3Provider } from '@fluxmedia/s3';
+
+const uploader = new MediaUploader(
+  new S3Provider({
+    region: 'us-east-1',
+    bucket: 'my-bucket',
+    accessKeyId: 'your-access-key',
+    secretAccessKey: 'your-secret-key'
+  }),
+);
+
+const result = await uploader.upload(file, {
+  folder: 'uploads',
+  filename: 'my-file.jpg'
+});
+
+console.log(result.url);
+```
+
+## Features
+
+S3 is a storage-only provider:
+
+- File upload/download
+- Multipart upload for large files
+- Signed upload URLs
+- No image transformations (use CloudFront + Lambda@Edge)
+- No video processing
+
+## Configuration
+
+```typescript
+interface S3Config {
+  region: string;        // AWS region
+  bucket: string;        // S3 bucket name
+  accessKeyId: string;   // AWS Access Key
+  secretAccessKey: string; // AWS Secret Key
+  endpoint?: string;     // Custom endpoint (for S3-compatible)
+  forcePathStyle?: boolean; // Force path style URLs
+}
+```
+
+## S3-Compatible Services
+
+Works with S3-compatible services like MinIO, DigitalOcean Spaces:
+
+```typescript
+const uploader = new MediaUploader(
+  new S3Provider({
+    region: 'nyc3',
+    bucket: 'my-space',
+    accessKeyId: 'your-key',
+    secretAccessKey: 'your-secret',
+    endpoint: 'https://nyc3.digitaloceanspaces.com',
+    forcePathStyle: false
+  })
+);
+```
+
+## License
+
+MIT

package/dist/features.d.cts

@@ -0,0 +1,6 @@
+import type { ProviderFeatures } from '@fluxmedia/core';
+/**
+ * Feature matrix for S3 provider.
+ * S3 is storage-only - no transformation support.
+ */
+export declare const S3Features: ProviderFeatures;

package/dist/features.d.ts

@@ -0,0 +1,6 @@
+import type { ProviderFeatures } from '@fluxmedia/core';
+/**
+ * Feature matrix for S3 provider.
+ * S3 is storage-only - no transformation support.
+ */
+export declare const S3Features: ProviderFeatures;

package/dist/index.cjs

@@ -0,0 +1,195 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const __fluxmedia_core = __toESM(require("@fluxmedia/core"));
+
+//#region src/features.ts
+/**
+* Feature matrix for S3 provider.
+* S3 is storage-only - no transformation support.
+*/
+const S3Features = {
+	transformations: {
+		resize: false,
+		crop: false,
+		format: false,
+		quality: false,
+		blur: false,
+		rotate: false,
+		effects: false
+	},
+	capabilities: {
+		signedUploads: true,
+		directUpload: true,
+		multipartUpload: true,
+		videoProcessing: false,
+		aiTagging: false,
+		facialDetection: false
+	},
+	storage: {
+		maxFileSize: 5 * 1024 * 1024 * 1024,
+		supportedFormats: ["*"]
+	}
+};
+
+//#endregion
+//#region src/s3-provider.ts
+/**
+* AWS S3 provider implementation.
+* Storage-focused provider without transformation support.
+*/
+var S3Provider = class {
+	name = "s3";
+	features = S3Features;
+	client = null;
+	config;
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Lazy-loads the AWS S3 SDK to minimize bundle size.
+	*/
+	async ensureClient() {
+		if (!this.client) {
+			const { S3Client } = await import("@aws-sdk/client-s3");
+			this.client = new S3Client({
+				region: this.config.region,
+				credentials: {
+					accessKeyId: this.config.accessKeyId,
+					secretAccessKey: this.config.secretAccessKey
+				},
+				endpoint: this.config.endpoint,
+				forcePathStyle: this.config.forcePathStyle
+			});
+		}
+		return this.client;
+	}
+	async upload(file, options) {
+		const client = await this.ensureClient();
+		try {
+			const { PutObjectCommand } = await import("@aws-sdk/client-s3");
+			const key = this.generateKey(options);
+			const body = file instanceof Buffer ? file : await this.fileToBuffer(file);
+			if (options?.onProgress) options.onProgress(0);
+			const command = new PutObjectCommand({
+				Bucket: this.config.bucket,
+				Key: key,
+				Body: body,
+				ContentType: this.getContentType(file)
+			});
+			await client.send(command);
+			if (options?.onProgress) options.onProgress(100);
+			return this.createResult(key, body.length);
+		} catch (error) {
+			throw (0, __fluxmedia_core.createMediaError)(__fluxmedia_core.MediaErrorCode.UPLOAD_FAILED, this.name, error);
+		}
+	}
+	async delete(id) {
+		const client = await this.ensureClient();
+		try {
+			const { DeleteObjectCommand } = await import("@aws-sdk/client-s3");
+			const command = new DeleteObjectCommand({
+				Bucket: this.config.bucket,
+				Key: id
+			});
+			await client.send(command);
+		} catch (error) {
+			throw (0, __fluxmedia_core.createMediaError)(__fluxmedia_core.MediaErrorCode.DELETE_FAILED, this.name, error);
+		}
+	}
+	async get(id) {
+		const client = await this.ensureClient();
+		try {
+			const { HeadObjectCommand } = await import("@aws-sdk/client-s3");
+			const command = new HeadObjectCommand({
+				Bucket: this.config.bucket,
+				Key: id
+			});
+			const response = await client.send(command);
+			return {
+				id,
+				url: this.getUrl(id),
+				publicUrl: this.getUrl(id),
+				size: response.ContentLength ?? 0,
+				format: this.extractFormat(id),
+				provider: this.name,
+				metadata: { contentType: response.ContentType },
+				createdAt: response.LastModified ?? /* @__PURE__ */ new Date()
+			};
+		} catch (error) {
+			throw (0, __fluxmedia_core.createMediaError)(__fluxmedia_core.MediaErrorCode.FILE_NOT_FOUND, this.name, error);
+		}
+	}
+	getUrl(id, _transform) {
+		if (this.config.endpoint) return `${this.config.endpoint}/${this.config.bucket}/${id}`;
+		return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${id}`;
+	}
+	async uploadMultiple(files, options) {
+		const uploadPromises = files.map((file) => this.upload(file, options));
+		return Promise.all(uploadPromises);
+	}
+	async deleteMultiple(ids) {
+		const deletePromises = ids.map((id) => this.delete(id));
+		await Promise.all(deletePromises);
+	}
+	get native() {
+		return this.client;
+	}
+	generateKey(options) {
+		const filename = options?.filename ?? this.generateRandomId();
+		const folder = options?.folder ? `${options.folder}/` : "";
+		return `${folder}${filename}`;
+	}
+	generateRandomId() {
+		return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	}
+	getContentType(file) {
+		if (file instanceof Buffer) return "application/octet-stream";
+		return file.type || "application/octet-stream";
+	}
+	extractFormat(key) {
+		const parts = key.split(".");
+		return parts.length > 1 ? parts[parts.length - 1] ?? "" : "";
+	}
+	async fileToBuffer(file) {
+		const arrayBuffer = await file.arrayBuffer();
+		return Buffer.from(arrayBuffer);
+	}
+	createResult(key, size) {
+		return {
+			id: key,
+			url: this.getUrl(key),
+			publicUrl: this.getUrl(key),
+			size,
+			format: this.extractFormat(key),
+			provider: this.name,
+			metadata: {},
+			createdAt: /* @__PURE__ */ new Date()
+		};
+	}
+};
+
+//#endregion
+exports.S3Features = S3Features;
+exports.S3Provider = S3Provider;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["S3Features: ProviderFeatures","config: S3Config","file: File | Buffer","options?: UploadOptions","MediaErrorCode","id: string","_transform?: TransformationOptions","files: File[] | Buffer[]","ids: string[]","key: string","file: File","size: number"],"sources":["../src/features.ts","../src/s3-provider.ts"],"sourcesContent":["import type { ProviderFeatures } from '@fluxmedia/core';\n\n/**\n * Feature matrix for S3 provider.\n * S3 is storage-only - no transformation support.\n */\nexport const S3Features: ProviderFeatures = {\n    transformations: {\n        resize: false,\n        crop: false,\n        format: false,\n        quality: false,\n        blur: false,\n        rotate: false,\n        effects: false,\n    },\n    capabilities: {\n        signedUploads: true,\n        directUpload: true,\n        multipartUpload: true,\n        videoProcessing: false,\n        aiTagging: false,\n        facialDetection: false,\n    },\n    storage: {\n        maxFileSize: 5 * 1024 * 1024 * 1024, // 5GB\n        supportedFormats: ['*'], // All formats\n    },\n};\n","import type {\n    MediaProvider,\n    UploadOptions,\n    UploadResult,\n    TransformationOptions,\n    ProviderFeatures,\n} from '@fluxmedia/core';\nimport { MediaErrorCode, createMediaError } from '@fluxmedia/core';\nimport { S3Features } from './features';\nimport type { S3Config } from './types';\n\n// Type for S3 client\ninterface S3ClientType {\n    send: (command: unknown) => Promise<unknown>;\n}\n\n/**\n * AWS S3 provider implementation.\n * Storage-focused provider without transformation support.\n */\nexport class S3Provider implements MediaProvider {\n    readonly name: string = 's3';\n    readonly features: ProviderFeatures = S3Features;\n\n    private client: S3ClientType | null = null;\n    private config: S3Config;\n\n    constructor(config: S3Config) {\n        this.config = config;\n    }\n\n    /**\n     * Lazy-loads the AWS S3 SDK to minimize bundle size.\n     */\n    private async ensureClient(): Promise<S3ClientType> {\n        if (!this.client) {\n            const { S3Client } = await import('@aws-sdk/client-s3');\n            this.client = new S3Client({\n                region: this.config.region,\n                credentials: {\n                    accessKeyId: this.config.accessKeyId,\n                    secretAccessKey: this.config.secretAccessKey,\n                },\n                endpoint: this.config.endpoint,\n                forcePathStyle: this.config.forcePathStyle,\n            });\n        }\n        return this.client;\n    }\n\n    async upload(file: File | Buffer, options?: UploadOptions): Promise<UploadResult> {\n        const client = await this.ensureClient();\n\n        try {\n            const { PutObjectCommand } = await import('@aws-sdk/client-s3');\n\n            const key = this.generateKey(options);\n            const body = file instanceof Buffer ? file : await this.fileToBuffer(file);\n\n            if (options?.onProgress) {\n                options.onProgress(0);\n            }\n\n            const command = new PutObjectCommand({\n                Bucket: this.config.bucket,\n                Key: key,\n                Body: body,\n                ContentType: this.getContentType(file),\n            });\n\n            await client.send(command);\n\n            if (options?.onProgress) {\n                options.onProgress(100);\n            }\n\n            return this.createResult(key, body.length);\n        } catch (error) {\n            throw createMediaError(MediaErrorCode.UPLOAD_FAILED, this.name, error);\n        }\n    }\n\n    async delete(id: string): Promise<void> {\n        const client = await this.ensureClient();\n\n        try {\n            const { DeleteObjectCommand } = await import('@aws-sdk/client-s3');\n\n            const command = new DeleteObjectCommand({\n                Bucket: this.config.bucket,\n                Key: id,\n            });\n\n            await client.send(command);\n        } catch (error) {\n            throw createMediaError(MediaErrorCode.DELETE_FAILED, this.name, error);\n        }\n    }\n\n    async get(id: string): Promise<UploadResult> {\n        const client = await this.ensureClient();\n\n        try {\n            const { HeadObjectCommand } = await import('@aws-sdk/client-s3');\n\n            const command = new HeadObjectCommand({\n                Bucket: this.config.bucket,\n                Key: id,\n            });\n\n            const response = (await client.send(command)) as {\n                ContentLength?: number;\n                ContentType?: string;\n                LastModified?: Date;\n            };\n\n            return {\n                id,\n                url: this.getUrl(id),\n                publicUrl: this.getUrl(id),\n                size: response.ContentLength ?? 0,\n                format: this.extractFormat(id),\n                provider: this.name,\n                metadata: {\n                    contentType: response.ContentType,\n                },\n                createdAt: response.LastModified ?? new Date(),\n            };\n        } catch (error) {\n            throw createMediaError(MediaErrorCode.FILE_NOT_FOUND, this.name, error);\n        }\n    }\n\n    getUrl(id: string, _transform?: TransformationOptions): string {\n        // S3 doesn't support transformations, ignore transform parameter\n        if (this.config.endpoint) {\n            return `${this.config.endpoint}/${this.config.bucket}/${id}`;\n        }\n        return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${id}`;\n    }\n\n    async uploadMultiple(files: File[] | Buffer[], options?: UploadOptions): Promise<UploadResult[]> {\n        const uploadPromises = files.map((file) => this.upload(file, options));\n        return Promise.all(uploadPromises);\n    }\n\n    async deleteMultiple(ids: string[]): Promise<void> {\n        const deletePromises = ids.map((id) => this.delete(id));\n        await Promise.all(deletePromises);\n    }\n\n    get native(): unknown {\n        return this.client;\n    }\n\n    private generateKey(options?: UploadOptions): string {\n        const filename = options?.filename ?? this.generateRandomId();\n        const folder = options?.folder ? `${options.folder}/` : '';\n        return `${folder}${filename}`;\n    }\n\n    private generateRandomId(): string {\n        return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;\n    }\n\n    private getContentType(file: File | Buffer): string {\n        if (file instanceof Buffer) {\n            return 'application/octet-stream';\n        }\n        return file.type || 'application/octet-stream';\n    }\n\n    private extractFormat(key: string): string {\n        const parts = key.split('.');\n        return parts.length > 1 ? parts[parts.length - 1] ?? '' : '';\n    }\n\n    private async fileToBuffer(file: File): Promise<Buffer> {\n        const arrayBuffer = await file.arrayBuffer();\n        return Buffer.from(arrayBuffer);\n    }\n\n    private createResult(key: string, size: number): UploadResult {\n        return {\n            id: key,\n            url: this.getUrl(key),\n            publicUrl: this.getUrl(key),\n            size,\n            format: this.extractFormat(key),\n            provider: this.name,\n            metadata: {},\n            createdAt: new Date(),\n        };\n    }\n}\n"],"mappings":"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"}

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+export { S3Provider } from './s3-provider';
+export { S3Features } from './features';
+export type { S3Config } from './types';

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { S3Provider } from './s3-provider';
+export { S3Features } from './features';
+export type { S3Config } from './types';

package/dist/index.js

@@ -0,0 +1,171 @@
+import { MediaErrorCode, createMediaError } from "@fluxmedia/core";
+
+//#region src/features.ts
+/**
+* Feature matrix for S3 provider.
+* S3 is storage-only - no transformation support.
+*/
+const S3Features = {
+	transformations: {
+		resize: false,
+		crop: false,
+		format: false,
+		quality: false,
+		blur: false,
+		rotate: false,
+		effects: false
+	},
+	capabilities: {
+		signedUploads: true,
+		directUpload: true,
+		multipartUpload: true,
+		videoProcessing: false,
+		aiTagging: false,
+		facialDetection: false
+	},
+	storage: {
+		maxFileSize: 5 * 1024 * 1024 * 1024,
+		supportedFormats: ["*"]
+	}
+};
+
+//#endregion
+//#region src/s3-provider.ts
+/**
+* AWS S3 provider implementation.
+* Storage-focused provider without transformation support.
+*/
+var S3Provider = class {
+	name = "s3";
+	features = S3Features;
+	client = null;
+	config;
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Lazy-loads the AWS S3 SDK to minimize bundle size.
+	*/
+	async ensureClient() {
+		if (!this.client) {
+			const { S3Client } = await import("@aws-sdk/client-s3");
+			this.client = new S3Client({
+				region: this.config.region,
+				credentials: {
+					accessKeyId: this.config.accessKeyId,
+					secretAccessKey: this.config.secretAccessKey
+				},
+				endpoint: this.config.endpoint,
+				forcePathStyle: this.config.forcePathStyle
+			});
+		}
+		return this.client;
+	}
+	async upload(file, options) {
+		const client = await this.ensureClient();
+		try {
+			const { PutObjectCommand } = await import("@aws-sdk/client-s3");
+			const key = this.generateKey(options);
+			const body = file instanceof Buffer ? file : await this.fileToBuffer(file);
+			if (options?.onProgress) options.onProgress(0);
+			const command = new PutObjectCommand({
+				Bucket: this.config.bucket,
+				Key: key,
+				Body: body,
+				ContentType: this.getContentType(file)
+			});
+			await client.send(command);
+			if (options?.onProgress) options.onProgress(100);
+			return this.createResult(key, body.length);
+		} catch (error) {
+			throw createMediaError(MediaErrorCode.UPLOAD_FAILED, this.name, error);
+		}
+	}
+	async delete(id) {
+		const client = await this.ensureClient();
+		try {
+			const { DeleteObjectCommand } = await import("@aws-sdk/client-s3");
+			const command = new DeleteObjectCommand({
+				Bucket: this.config.bucket,
+				Key: id
+			});
+			await client.send(command);
+		} catch (error) {
+			throw createMediaError(MediaErrorCode.DELETE_FAILED, this.name, error);
+		}
+	}
+	async get(id) {
+		const client = await this.ensureClient();
+		try {
+			const { HeadObjectCommand } = await import("@aws-sdk/client-s3");
+			const command = new HeadObjectCommand({
+				Bucket: this.config.bucket,
+				Key: id
+			});
+			const response = await client.send(command);
+			return {
+				id,
+				url: this.getUrl(id),
+				publicUrl: this.getUrl(id),
+				size: response.ContentLength ?? 0,
+				format: this.extractFormat(id),
+				provider: this.name,
+				metadata: { contentType: response.ContentType },
+				createdAt: response.LastModified ?? /* @__PURE__ */ new Date()
+			};
+		} catch (error) {
+			throw createMediaError(MediaErrorCode.FILE_NOT_FOUND, this.name, error);
+		}
+	}
+	getUrl(id, _transform) {
+		if (this.config.endpoint) return `${this.config.endpoint}/${this.config.bucket}/${id}`;
+		return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${id}`;
+	}
+	async uploadMultiple(files, options) {
+		const uploadPromises = files.map((file) => this.upload(file, options));
+		return Promise.all(uploadPromises);
+	}
+	async deleteMultiple(ids) {
+		const deletePromises = ids.map((id) => this.delete(id));
+		await Promise.all(deletePromises);
+	}
+	get native() {
+		return this.client;
+	}
+	generateKey(options) {
+		const filename = options?.filename ?? this.generateRandomId();
+		const folder = options?.folder ? `${options.folder}/` : "";
+		return `${folder}${filename}`;
+	}
+	generateRandomId() {
+		return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;
+	}
+	getContentType(file) {
+		if (file instanceof Buffer) return "application/octet-stream";
+		return file.type || "application/octet-stream";
+	}
+	extractFormat(key) {
+		const parts = key.split(".");
+		return parts.length > 1 ? parts[parts.length - 1] ?? "" : "";
+	}
+	async fileToBuffer(file) {
+		const arrayBuffer = await file.arrayBuffer();
+		return Buffer.from(arrayBuffer);
+	}
+	createResult(key, size) {
+		return {
+			id: key,
+			url: this.getUrl(key),
+			publicUrl: this.getUrl(key),
+			size,
+			format: this.extractFormat(key),
+			provider: this.name,
+			metadata: {},
+			createdAt: /* @__PURE__ */ new Date()
+		};
+	}
+};
+
+//#endregion
+export { S3Features, S3Provider };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["S3Features: ProviderFeatures","config: S3Config","file: File | Buffer","options?: UploadOptions","id: string","_transform?: TransformationOptions","files: File[] | Buffer[]","ids: string[]","key: string","file: File","size: number"],"sources":["../src/features.ts","../src/s3-provider.ts"],"sourcesContent":["import type { ProviderFeatures } from '@fluxmedia/core';\n\n/**\n * Feature matrix for S3 provider.\n * S3 is storage-only - no transformation support.\n */\nexport const S3Features: ProviderFeatures = {\n    transformations: {\n        resize: false,\n        crop: false,\n        format: false,\n        quality: false,\n        blur: false,\n        rotate: false,\n        effects: false,\n    },\n    capabilities: {\n        signedUploads: true,\n        directUpload: true,\n        multipartUpload: true,\n        videoProcessing: false,\n        aiTagging: false,\n        facialDetection: false,\n    },\n    storage: {\n        maxFileSize: 5 * 1024 * 1024 * 1024, // 5GB\n        supportedFormats: ['*'], // All formats\n    },\n};\n","import type {\n    MediaProvider,\n    UploadOptions,\n    UploadResult,\n    TransformationOptions,\n    ProviderFeatures,\n} from '@fluxmedia/core';\nimport { MediaErrorCode, createMediaError } from '@fluxmedia/core';\nimport { S3Features } from './features';\nimport type { S3Config } from './types';\n\n// Type for S3 client\ninterface S3ClientType {\n    send: (command: unknown) => Promise<unknown>;\n}\n\n/**\n * AWS S3 provider implementation.\n * Storage-focused provider without transformation support.\n */\nexport class S3Provider implements MediaProvider {\n    readonly name: string = 's3';\n    readonly features: ProviderFeatures = S3Features;\n\n    private client: S3ClientType | null = null;\n    private config: S3Config;\n\n    constructor(config: S3Config) {\n        this.config = config;\n    }\n\n    /**\n     * Lazy-loads the AWS S3 SDK to minimize bundle size.\n     */\n    private async ensureClient(): Promise<S3ClientType> {\n        if (!this.client) {\n            const { S3Client } = await import('@aws-sdk/client-s3');\n            this.client = new S3Client({\n                region: this.config.region,\n                credentials: {\n                    accessKeyId: this.config.accessKeyId,\n                    secretAccessKey: this.config.secretAccessKey,\n                },\n                endpoint: this.config.endpoint,\n                forcePathStyle: this.config.forcePathStyle,\n            });\n        }\n        return this.client;\n    }\n\n    async upload(file: File | Buffer, options?: UploadOptions): Promise<UploadResult> {\n        const client = await this.ensureClient();\n\n        try {\n            const { PutObjectCommand } = await import('@aws-sdk/client-s3');\n\n            const key = this.generateKey(options);\n            const body = file instanceof Buffer ? file : await this.fileToBuffer(file);\n\n            if (options?.onProgress) {\n                options.onProgress(0);\n            }\n\n            const command = new PutObjectCommand({\n                Bucket: this.config.bucket,\n                Key: key,\n                Body: body,\n                ContentType: this.getContentType(file),\n            });\n\n            await client.send(command);\n\n            if (options?.onProgress) {\n                options.onProgress(100);\n            }\n\n            return this.createResult(key, body.length);\n        } catch (error) {\n            throw createMediaError(MediaErrorCode.UPLOAD_FAILED, this.name, error);\n        }\n    }\n\n    async delete(id: string): Promise<void> {\n        const client = await this.ensureClient();\n\n        try {\n            const { DeleteObjectCommand } = await import('@aws-sdk/client-s3');\n\n            const command = new DeleteObjectCommand({\n                Bucket: this.config.bucket,\n                Key: id,\n            });\n\n            await client.send(command);\n        } catch (error) {\n            throw createMediaError(MediaErrorCode.DELETE_FAILED, this.name, error);\n        }\n    }\n\n    async get(id: string): Promise<UploadResult> {\n        const client = await this.ensureClient();\n\n        try {\n            const { HeadObjectCommand } = await import('@aws-sdk/client-s3');\n\n            const command = new HeadObjectCommand({\n                Bucket: this.config.bucket,\n                Key: id,\n            });\n\n            const response = (await client.send(command)) as {\n                ContentLength?: number;\n                ContentType?: string;\n                LastModified?: Date;\n            };\n\n            return {\n                id,\n                url: this.getUrl(id),\n                publicUrl: this.getUrl(id),\n                size: response.ContentLength ?? 0,\n                format: this.extractFormat(id),\n                provider: this.name,\n                metadata: {\n                    contentType: response.ContentType,\n                },\n                createdAt: response.LastModified ?? new Date(),\n            };\n        } catch (error) {\n            throw createMediaError(MediaErrorCode.FILE_NOT_FOUND, this.name, error);\n        }\n    }\n\n    getUrl(id: string, _transform?: TransformationOptions): string {\n        // S3 doesn't support transformations, ignore transform parameter\n        if (this.config.endpoint) {\n            return `${this.config.endpoint}/${this.config.bucket}/${id}`;\n        }\n        return `https://${this.config.bucket}.s3.${this.config.region}.amazonaws.com/${id}`;\n    }\n\n    async uploadMultiple(files: File[] | Buffer[], options?: UploadOptions): Promise<UploadResult[]> {\n        const uploadPromises = files.map((file) => this.upload(file, options));\n        return Promise.all(uploadPromises);\n    }\n\n    async deleteMultiple(ids: string[]): Promise<void> {\n        const deletePromises = ids.map((id) => this.delete(id));\n        await Promise.all(deletePromises);\n    }\n\n    get native(): unknown {\n        return this.client;\n    }\n\n    private generateKey(options?: UploadOptions): string {\n        const filename = options?.filename ?? this.generateRandomId();\n        const folder = options?.folder ? `${options.folder}/` : '';\n        return `${folder}${filename}`;\n    }\n\n    private generateRandomId(): string {\n        return `${Date.now()}-${Math.random().toString(36).substring(2, 15)}`;\n    }\n\n    private getContentType(file: File | Buffer): string {\n        if (file instanceof Buffer) {\n            return 'application/octet-stream';\n        }\n        return file.type || 'application/octet-stream';\n    }\n\n    private extractFormat(key: string): string {\n        const parts = key.split('.');\n        return parts.length > 1 ? parts[parts.length - 1] ?? '' : '';\n    }\n\n    private async fileToBuffer(file: File): Promise<Buffer> {\n        const arrayBuffer = await file.arrayBuffer();\n        return Buffer.from(arrayBuffer);\n    }\n\n    private createResult(key: string, size: number): UploadResult {\n        return {\n            id: key,\n            url: this.getUrl(key),\n            publicUrl: this.getUrl(key),\n            size,\n            format: this.extractFormat(key),\n            provider: this.name,\n            metadata: {},\n            createdAt: new Date(),\n        };\n    }\n}\n"],"mappings":"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"}

package/dist/s3-provider.d.cts

@@ -0,0 +1,30 @@
+import type { MediaProvider, UploadOptions, UploadResult, TransformationOptions, ProviderFeatures } from '@fluxmedia/core';
+import type { S3Config } from './types';
+/**
+ * AWS S3 provider implementation.
+ * Storage-focused provider without transformation support.
+ */
+export declare class S3Provider implements MediaProvider {
+    readonly name: string;
+    readonly features: ProviderFeatures;
+    private client;
+    private config;
+    constructor(config: S3Config);
+    /**
+     * Lazy-loads the AWS S3 SDK to minimize bundle size.
+     */
+    private ensureClient;
+    upload(file: File | Buffer, options?: UploadOptions): Promise<UploadResult>;
+    delete(id: string): Promise<void>;
+    get(id: string): Promise<UploadResult>;
+    getUrl(id: string, _transform?: TransformationOptions): string;
+    uploadMultiple(files: File[] | Buffer[], options?: UploadOptions): Promise<UploadResult[]>;
+    deleteMultiple(ids: string[]): Promise<void>;
+    get native(): unknown;
+    private generateKey;
+    private generateRandomId;
+    private getContentType;
+    private extractFormat;
+    private fileToBuffer;
+    private createResult;
+}

package/dist/s3-provider.d.ts

@@ -0,0 +1,30 @@
+import type { MediaProvider, UploadOptions, UploadResult, TransformationOptions, ProviderFeatures } from '@fluxmedia/core';
+import type { S3Config } from './types';
+/**
+ * AWS S3 provider implementation.
+ * Storage-focused provider without transformation support.
+ */
+export declare class S3Provider implements MediaProvider {
+    readonly name: string;
+    readonly features: ProviderFeatures;
+    private client;
+    private config;
+    constructor(config: S3Config);
+    /**
+     * Lazy-loads the AWS S3 SDK to minimize bundle size.
+     */
+    private ensureClient;
+    upload(file: File | Buffer, options?: UploadOptions): Promise<UploadResult>;
+    delete(id: string): Promise<void>;
+    get(id: string): Promise<UploadResult>;
+    getUrl(id: string, _transform?: TransformationOptions): string;
+    uploadMultiple(files: File[] | Buffer[], options?: UploadOptions): Promise<UploadResult[]>;
+    deleteMultiple(ids: string[]): Promise<void>;
+    get native(): unknown;
+    private generateKey;
+    private generateRandomId;
+    private getContentType;
+    private extractFormat;
+    private fileToBuffer;
+    private createResult;
+}

package/dist/types.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Configuration options for S3 provider
+ */
+export interface S3Config {
+    /**
+     * AWS region
+     */
+    region: string;
+    /**
+     * S3 bucket name
+     */
+    bucket: string;
+    /**
+     * AWS Access Key ID
+     */
+    accessKeyId: string;
+    /**
+     * AWS Secret Access Key
+     */
+    secretAccessKey: string;
+    /**
+     * Custom endpoint URL (for S3-compatible services)
+     */
+    endpoint?: string;
+    /**
+     * Whether to force path style (required for some S3-compatible services)
+     */
+    forcePathStyle?: boolean;
+}

package/dist/types.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration options for S3 provider
+ */
+export interface S3Config {
+    /**
+     * AWS region
+     */
+    region: string;
+    /**
+     * S3 bucket name
+     */
+    bucket: string;
+    /**
+     * AWS Access Key ID
+     */
+    accessKeyId: string;
+    /**
+     * AWS Secret Access Key
+     */
+    secretAccessKey: string;
+    /**
+     * Custom endpoint URL (for S3-compatible services)
+     */
+    endpoint?: string;
+    /**
+     * Whether to force path style (required for some S3-compatible services)
+     */
+    forcePathStyle?: boolean;
+}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@fluxmedia/s3",
+  "version": "0.1.0-alpha.0",
+  "description": "AWS S3 provider for FluxMedia",
+  "keywords": [
+    "fluxmedia",
+    "s3",
+    "aws",
+    "media",
+    "upload",
+    "cloud"
+  ],
+  "homepage": "https://fluxmedia.dev",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fluxmediajs/fluxmedia.git",
+    "directory": "packages/s3"
+  },
+  "license": "MIT",
+  "author": "FluxMedia Contributors",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@fluxmedia/core": "0.1.0-alpha.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.5",
+    "tsdown": "^0.2.1",
+    "typescript": "^5.3.3"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rm -rf dist",
+    "dev": "tsdown --watch"
+  }
+}