@opensaas/stack-storage 0.1.1

package/dist/runtime/index.js

@@ -0,0 +1,157 @@
+import { LocalStorageProvider } from '../providers/local.js';
+import { validateFile, getMimeType } from '../utils/upload.js';
+import { getImageDimensions, processImageTransformations } from '../utils/image.js';
+/**
+ * Creates a storage provider instance from config
+ */
+export function createStorageProvider(config, providerName) {
+    if (!config.storage || !config.storage[providerName]) {
+        throw new Error(`Storage provider '${providerName}' not found in config`);
+    }
+    const providerConfig = config.storage[providerName];
+    switch (providerConfig.type) {
+        case 'local':
+            return new LocalStorageProvider(providerConfig);
+        default:
+            throw new Error(`Unknown storage provider type: ${providerConfig.type}`);
+    }
+}
+/**
+ * Uploads a file to the specified storage provider
+ *
+ * @example
+ * ```typescript
+ * const metadata = await uploadFile(config, 'documents', {
+ *   file,
+ *   buffer,
+ *   validation: {
+ *     maxFileSize: 10 * 1024 * 1024, // 10MB
+ *     acceptedMimeTypes: ['application/pdf']
+ *   }
+ * })
+ * ```
+ */
+export async function uploadFile(config, storageProviderName, data, options) {
+    const { file, buffer } = data;
+    // Validate file
+    if (options?.validation) {
+        const validation = validateFile({
+            size: file.size,
+            name: file.name,
+            type: file.type,
+        }, options.validation);
+        if (!validation.valid) {
+            throw new Error(validation.error);
+        }
+    }
+    // Get storage provider
+    const provider = createStorageProvider(config, storageProviderName);
+    // Determine content type
+    const contentType = file.type || getMimeType(file.name);
+    // Upload file
+    const result = await provider.upload(buffer, file.name, {
+        contentType,
+        metadata: options?.metadata,
+    });
+    // Return metadata
+    return {
+        filename: result.filename,
+        originalFilename: file.name,
+        url: result.url,
+        mimeType: contentType,
+        size: result.size,
+        uploadedAt: new Date().toISOString(),
+        storageProvider: storageProviderName,
+        metadata: result.metadata,
+    };
+}
+/**
+ * Uploads an image with optional transformations
+ *
+ * @example
+ * ```typescript
+ * const metadata = await uploadImage(config, 'avatars', {
+ *   file,
+ *   buffer,
+ *   validation: {
+ *     maxFileSize: 5 * 1024 * 1024, // 5MB
+ *     acceptedMimeTypes: ['image/jpeg', 'image/png', 'image/webp']
+ *   },
+ *   transformations: {
+ *     thumbnail: { width: 100, height: 100, fit: 'cover' },
+ *     profile: { width: 400, height: 400, fit: 'cover' }
+ *   }
+ * })
+ * ```
+ */
+export async function uploadImage(config, storageProviderName, data, options) {
+    const { file, buffer } = data;
+    // Validate file
+    if (options?.validation) {
+        const validation = validateFile({
+            size: file.size,
+            name: file.name,
+            type: file.type,
+        }, options.validation);
+        if (!validation.valid) {
+            throw new Error(validation.error);
+        }
+    }
+    // Get storage provider
+    const provider = createStorageProvider(config, storageProviderName);
+    // Determine content type
+    const contentType = file.type || getMimeType(file.name);
+    // Get original image dimensions
+    const { width, height } = await getImageDimensions(buffer);
+    // Upload original image
+    const result = await provider.upload(buffer, file.name, {
+        contentType,
+        metadata: options?.metadata,
+    });
+    // Process transformations if provided
+    let transformations;
+    if (options?.transformations) {
+        transformations = await processImageTransformations(buffer, file.name, options.transformations, provider, contentType);
+    }
+    // Return metadata
+    return {
+        filename: result.filename,
+        originalFilename: file.name,
+        url: result.url,
+        mimeType: contentType,
+        size: result.size,
+        width,
+        height,
+        uploadedAt: new Date().toISOString(),
+        storageProvider: storageProviderName,
+        metadata: result.metadata,
+        transformations,
+    };
+}
+/**
+ * Deletes a file from storage
+ */
+export async function deleteFile(config, storageProviderName, filename) {
+    const provider = createStorageProvider(config, storageProviderName);
+    await provider.delete(filename);
+}
+/**
+ * Deletes an image and all its transformations from storage
+ */
+export async function deleteImage(config, metadata) {
+    const provider = createStorageProvider(config, metadata.storageProvider);
+    // Delete original image
+    await provider.delete(metadata.filename);
+    // Delete all transformations
+    if (metadata.transformations) {
+        for (const transformationResult of Object.values(metadata.transformations)) {
+            // Extract filename from URL
+            const filename = transformationResult.url.split('/').pop();
+            if (filename) {
+                await provider.delete(filename);
+            }
+        }
+    }
+}
+export { parseFileFromFormData } from '../utils/upload.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

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

package/dist/utils/image.d.ts

@@ -0,0 +1,18 @@
+import type { ImageTransformationConfig, ImageTransformationResult, StorageProvider } from '../config/types.js';
+/**
+ * Gets image dimensions from a buffer
+ */
+export declare function getImageDimensions(buffer: Buffer | Uint8Array): Promise<{
+    width: number;
+    height: number;
+}>;
+/**
+ * Applies a single transformation to an image
+ */
+export declare function transformImage(buffer: Buffer | Uint8Array, transformation: ImageTransformationConfig): Promise<Buffer>;
+/**
+ * Processes all transformations for an image
+ * Uploads the original and all transformed versions
+ */
+export declare function processImageTransformations(buffer: Buffer | Uint8Array, originalFilename: string, transformations: Record<string, ImageTransformationConfig>, storageProvider: StorageProvider, contentType: string): Promise<Record<string, ImageTransformationResult>>;
+//# sourceMappingURL=image.d.ts.map

package/dist/utils/image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/utils/image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,eAAe,EAChB,MAAM,oBAAoB,CAAA;AAE3B;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,GAAG,UAAU,GAC1B,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAM5C;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,GAAG,UAAU,EAC3B,cAAc,EAAE,yBAAyB,GACxC,OAAO,CAAC,MAAM,CAAC,CAmCjB;AAED;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,GAAG,UAAU,EAC3B,gBAAgB,EAAE,MAAM,EACxB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAC1D,eAAe,EAAE,eAAe,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC,CAqCpD"}

package/dist/utils/image.js

@@ -0,0 +1,82 @@
+import sharp from 'sharp';
+/**
+ * Gets image dimensions from a buffer
+ */
+export async function getImageDimensions(buffer) {
+    const metadata = await sharp(buffer).metadata();
+    return {
+        width: metadata.width || 0,
+        height: metadata.height || 0,
+    };
+}
+/**
+ * Applies a single transformation to an image
+ */
+export async function transformImage(buffer, transformation) {
+    let image = sharp(buffer);
+    // Apply resizing
+    if (transformation.width || transformation.height) {
+        image = image.resize({
+            width: transformation.width,
+            height: transformation.height,
+            fit: transformation.fit || 'cover',
+        });
+    }
+    // Apply format conversion
+    if (transformation.format) {
+        const options = {
+            quality: transformation.quality || 80,
+        };
+        switch (transformation.format) {
+            case 'jpeg':
+                image = image.jpeg(options);
+                break;
+            case 'png':
+                image = image.png(options);
+                break;
+            case 'webp':
+                image = image.webp(options);
+                break;
+            case 'avif':
+                image = image.avif(options);
+                break;
+        }
+    }
+    return await image.toBuffer();
+}
+/**
+ * Processes all transformations for an image
+ * Uploads the original and all transformed versions
+ */
+export async function processImageTransformations(buffer, originalFilename, transformations, storageProvider, contentType) {
+    const results = {};
+    for (const [name, config] of Object.entries(transformations)) {
+        // Transform the image
+        const transformedBuffer = await transformImage(buffer, config);
+        // Get dimensions of transformed image
+        const { width, height } = await getImageDimensions(transformedBuffer);
+        // Generate filename for transformation
+        const ext = config.format ? `.${config.format}` : '';
+        const transformedFilename = `${originalFilename}-${name}${ext}`;
+        // Upload transformed image
+        const uploadResult = await storageProvider.upload(transformedBuffer, transformedFilename, {
+            contentType: config.format === 'jpeg'
+                ? 'image/jpeg'
+                : config.format === 'png'
+                    ? 'image/png'
+                    : config.format === 'webp'
+                        ? 'image/webp'
+                        : config.format === 'avif'
+                            ? 'image/avif'
+                            : contentType,
+        });
+        results[name] = {
+            url: uploadResult.url,
+            width,
+            height,
+            size: uploadResult.size,
+        };
+    }
+    return results;
+}
+//# sourceMappingURL=image.js.map

package/dist/utils/image.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './image.js';
+export * from './upload.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+export * from './image.js';
+export * from './upload.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/utils/upload.d.ts

@@ -0,0 +1,56 @@
+/**
+ * File validation options
+ */
+export interface FileValidationOptions {
+    /** Maximum file size in bytes */
+    maxFileSize?: number;
+    /** Accepted MIME types (e.g., ['image/jpeg', 'image/png']) */
+    acceptedMimeTypes?: string[];
+    /** Accepted file extensions (e.g., ['.jpg', '.png']) */
+    acceptedExtensions?: string[];
+}
+/**
+ * File validation result
+ */
+export interface FileValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validates a file against the provided options
+ */
+export declare function validateFile(file: {
+    size: number;
+    name: string;
+    type: string;
+}, options?: FileValidationOptions): FileValidationResult;
+/**
+ * Formats file size in human-readable format
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Gets MIME type from filename
+ */
+export declare function getMimeType(filename: string): string;
+/**
+ * Extracts file metadata from a File or Blob
+ */
+export interface FileInfo {
+    name: string;
+    size: number;
+    type: string;
+    lastModified?: number;
+}
+/**
+ * Converts a File/Blob to Buffer for Node.js processing
+ */
+export declare function fileToBuffer(file: Blob | File): Promise<Buffer>;
+/**
+ * Parses FormData and extracts file information
+ * This is a utility for developers to use in their upload routes
+ */
+export declare function parseFileFromFormData(formData: FormData, fieldName?: string): Promise<{
+    file: File;
+    buffer: Buffer;
+} | null>;
+//# sourceMappingURL=upload.d.ts.map

package/dist/utils/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/utils/upload.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8DAA8D;IAC9D,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAClD,OAAO,CAAC,EAAE,qBAAqB,GAC9B,oBAAoB,CAoCtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAGrE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,QAAQ,EAClB,SAAS,GAAE,MAAe,GACzB,OAAO,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAUhD"}

package/dist/utils/upload.js

@@ -0,0 +1,74 @@
+import mime from 'mime-types';
+/**
+ * Validates a file against the provided options
+ */
+export function validateFile(file, options) {
+    if (!options) {
+        return { valid: true };
+    }
+    // Check file size
+    if (options.maxFileSize && file.size > options.maxFileSize) {
+        return {
+            valid: false,
+            error: `File size exceeds maximum allowed size of ${formatFileSize(options.maxFileSize)}`,
+        };
+    }
+    // Check MIME type
+    if (options.acceptedMimeTypes && options.acceptedMimeTypes.length > 0) {
+        const fileMimeType = file.type || mime.lookup(file.name) || '';
+        if (!options.acceptedMimeTypes.includes(fileMimeType)) {
+            return {
+                valid: false,
+                error: `File type '${fileMimeType}' is not allowed. Accepted types: ${options.acceptedMimeTypes.join(', ')}`,
+            };
+        }
+    }
+    // Check file extension
+    if (options.acceptedExtensions && options.acceptedExtensions.length > 0) {
+        const ext = file.name.substring(file.name.lastIndexOf('.')).toLowerCase();
+        if (!options.acceptedExtensions.includes(ext)) {
+            return {
+                valid: false,
+                error: `File extension '${ext}' is not allowed. Accepted extensions: ${options.acceptedExtensions.join(', ')}`,
+            };
+        }
+    }
+    return { valid: true };
+}
+/**
+ * Formats file size in human-readable format
+ */
+export function formatFileSize(bytes) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${Math.round((bytes / Math.pow(k, i)) * 100) / 100} ${sizes[i]}`;
+}
+/**
+ * Gets MIME type from filename
+ */
+export function getMimeType(filename) {
+    return mime.lookup(filename) || 'application/octet-stream';
+}
+/**
+ * Converts a File/Blob to Buffer for Node.js processing
+ */
+export async function fileToBuffer(file) {
+    const arrayBuffer = await file.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}
+/**
+ * Parses FormData and extracts file information
+ * This is a utility for developers to use in their upload routes
+ */
+export async function parseFileFromFormData(formData, fieldName = 'file') {
+    const file = formData.get(fieldName);
+    if (!file || !(file instanceof File)) {
+        return null;
+    }
+    const buffer = await fileToBuffer(file);
+    return { file, buffer };
+}
+//# sourceMappingURL=upload.js.map

package/dist/utils/upload.js.map

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

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@opensaas/stack-storage",
+  "version": "0.1.1",
+  "description": "File and image upload field types with pluggable storage providers for OpenSaas Stack",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./fields": {
+      "types": "./dist/fields/index.d.ts",
+      "default": "./dist/fields/index.js"
+    },
+    "./providers": {
+      "types": "./dist/providers/index.d.ts",
+      "default": "./dist/providers/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "default": "./dist/runtime/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "mime-types": "^3.0.1",
+    "sharp": "^0.34.4",
+    "zod": "^4.1.12",
+    "@opensaas/stack-core": "0.1.1"
+  },
+  "devDependencies": {
+    "@types/mime-types": "^3.0.1",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.2.2",
+    "@vitest/coverage-v8": "^4.0.5",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.5"
+  },
+  "peerDependencies": {
+    "@opensaas/stack-core": "0.1.1"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest --coverage"
+  }
+}

package/src/config/index.ts

@@ -0,0 +1,30 @@
+import type { LocalStorageConfig } from './types.js'
+
+export * from './types.js'
+
+/**
+ * Creates a local filesystem storage configuration
+ *
+ * @example
+ * ```typescript
+ * const config = config({
+ *   storage: {
+ *     documents: localStorage({
+ *       uploadDir: './uploads/documents',
+ *       serveUrl: '/api/files',
+ *     }),
+ *   },
+ * })
+ * ```
+ */
+export function localStorage(
+  config: Pick<LocalStorageConfig, 'uploadDir' | 'serveUrl'> &
+    Partial<Pick<LocalStorageConfig, 'generateUniqueFilenames'>>,
+): LocalStorageConfig {
+  return {
+    type: 'local',
+    uploadDir: config.uploadDir,
+    serveUrl: config.serveUrl,
+    generateUniqueFilenames: config.generateUniqueFilenames ?? true,
+  }
+}

package/src/config/types.ts

@@ -0,0 +1,127 @@
+/**
+ * Storage provider interface that all storage backends must implement.
+ * This allows pluggable storage solutions (local, S3, Vercel Blob, etc.)
+ */
+export interface StorageProvider {
+  /**
+   * Uploads a file to the storage provider
+   * @param file - File data as Buffer or Uint8Array
+   * @param filename - Desired filename (may be transformed by provider)
+   * @param options - Additional upload options (contentType, metadata, etc.)
+   * @returns Upload result with URL and metadata
+   */
+  upload(
+    file: Buffer | Uint8Array,
+    filename: string,
+    options?: UploadOptions,
+  ): Promise<UploadResult>
+
+  /**
+   * Downloads a file from the storage provider
+   * @param filename - Filename to download
+   * @returns File data as Buffer
+   */
+  download(filename: string): Promise<Buffer>
+
+  /**
+   * Deletes a file from the storage provider
+   * @param filename - Filename to delete
+   */
+  delete(filename: string): Promise<void>
+
+  /**
+   * Gets the public URL for a file
+   * @param filename - Filename to get URL for
+   * @returns Public URL string
+   */
+  getUrl(filename: string): string
+
+  /**
+   * Optional: Gets a signed URL for private files
+   * @param filename - Filename to get signed URL for
+   * @param expiresIn - Expiration time in seconds
+   * @returns Signed URL string
+   */
+  getSignedUrl?(filename: string, expiresIn?: number): Promise<string>
+}
+
+/**
+ * Options for uploading a file
+ */
+export interface UploadOptions {
+  /** MIME type of the file */
+  contentType?: string
+  /** Custom metadata to store with the file */
+  metadata?: Record<string, string>
+  /** Whether the file should be publicly accessible */
+  public?: boolean
+  /** Cache control header */
+  cacheControl?: string
+}
+
+/**
+ * Result from uploading a file
+ */
+export interface UploadResult {
+  /** Generated filename (may differ from input) */
+  filename: string
+  /** Public URL to access the file */
+  url: string
+  /** File size in bytes */
+  size: number
+  /** MIME type */
+  contentType: string
+  /** Additional provider-specific metadata */
+  metadata?: Record<string, unknown>
+}
+
+/**
+ * Configuration for local filesystem storage
+ */
+export interface LocalStorageConfig {
+  type: 'local'
+  /** Directory to store uploaded files */
+  uploadDir: string
+  /** Base URL for serving files (e.g., '/api/files' or 'https://cdn.example.com') */
+  serveUrl: string
+  /** Whether to generate unique filenames (default: true) */
+  generateUniqueFilenames?: boolean
+  /** Allow additional properties */
+  [key: string]: unknown
+}
+
+/**
+ * Base configuration shared by all storage providers
+ */
+export interface BaseStorageConfig {
+  type: string
+  [key: string]: unknown
+}
+
+/**
+ * Storage configuration - maps names to storage provider configs
+ * Example: { avatars: s3Config, documents: localConfig }
+ */
+export type StorageConfig = Record<string, BaseStorageConfig | LocalStorageConfig>
+
+/**
+ * Re-export metadata types from core package
+ * These types are now defined in @opensaas/stack-core to avoid circular dependencies
+ */
+export type { FileMetadata, ImageMetadata, ImageTransformationResult } from '@opensaas/stack-core'
+
+/**
+ * Configuration for image transformations
+ */
+export interface ImageTransformationConfig {
+  /** Target width in pixels */
+  width?: number
+  /** Target height in pixels */
+  height?: number
+  /** Fit mode: cover (crop), contain (letterbox), fill (stretch) */
+  fit?: 'cover' | 'contain' | 'fill' | 'inside' | 'outside'
+  /** Output format (default: original format) */
+  format?: 'jpeg' | 'png' | 'webp' | 'avif'
+  /** Quality 1-100 (default: 80) */
+  quality?: number
+}