@fluxmedia/s3 0.1.0-alpha.0 → 0.1.1

package/dist/index.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,30 +0,0 @@
-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

@@ -1,30 +0,0 @@
-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

@@ -1,29 +0,0 @@
-/**
- * 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

@@ -1,29 +0,0 @@
-/**
- * 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;
-}