@opensaas/stack-storage 0.1.1

package/dist/fields/index.d.ts

@@ -0,0 +1,111 @@
+import type { BaseFieldConfig } from '@opensaas/stack-core';
+import type { ComponentType } from 'react';
+import type { FileMetadata, ImageMetadata, ImageTransformationConfig } from '../config/types.js';
+import type { FileValidationOptions } from '../utils/upload.js';
+/**
+ * File field configuration
+ */
+export interface FileFieldConfig extends BaseFieldConfig<FileMetadata | null, FileMetadata | null> {
+    type: 'file';
+    /** Name of the storage provider from config.storage */
+    storage: string;
+    /** File validation options */
+    validation?: FileValidationOptions;
+    /** Automatically delete file from storage when record is deleted */
+    cleanupOnDelete?: boolean;
+    /** Automatically delete old file from storage when replaced with new file */
+    cleanupOnReplace?: boolean;
+    /** UI options */
+    ui?: {
+        /** Custom component to use for rendering this field */
+        component?: ComponentType<unknown>;
+        /** Custom field type name for component registry lookup */
+        fieldType?: string;
+        /** Label for the field */
+        label?: string;
+        /** Help text shown below the field */
+        helpText?: string;
+        /** Placeholder text */
+        placeholder?: string;
+        /** Additional UI options passed through to component */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Image field configuration
+ */
+export interface ImageFieldConfig extends BaseFieldConfig<ImageMetadata | null, ImageMetadata | null> {
+    type: 'image';
+    /** Name of the storage provider from config.storage */
+    storage: string;
+    /** Image transformations to generate on upload */
+    transformations?: Record<string, ImageTransformationConfig>;
+    /** File validation options */
+    validation?: FileValidationOptions;
+    /** Automatically delete file from storage when record is deleted */
+    cleanupOnDelete?: boolean;
+    /** Automatically delete old file from storage when replaced with new file */
+    cleanupOnReplace?: boolean;
+    /** UI options */
+    ui?: {
+        /** Custom component to use for rendering this field */
+        component?: ComponentType<unknown>;
+        /** Custom field type name for component registry lookup */
+        fieldType?: string;
+        /** Label for the field */
+        label?: string;
+        /** Help text shown below the field */
+        helpText?: string;
+        /** Placeholder text */
+        placeholder?: string;
+        /** Show image preview */
+        showPreview?: boolean;
+        /** Preview size (width in pixels) */
+        previewSize?: number;
+        /** Additional UI options passed through to component */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Creates a file upload field
+ *
+ * Uses JSON field backing to store file metadata including filename, URL, size, MIME type, etc.
+ *
+ * @example
+ * ```typescript
+ * fields: {
+ *   resume: file({
+ *     storage: 'documents',
+ *     validation: {
+ *       maxFileSize: 10 * 1024 * 1024, // 10MB
+ *       acceptedMimeTypes: ['application/pdf']
+ *     }
+ *   })
+ * }
+ * ```
+ */
+export declare function file(options: Omit<FileFieldConfig, 'type'>): FileFieldConfig;
+/**
+ * Creates an image upload field with optional transformations
+ *
+ * Uses JSON field backing to store image metadata including dimensions, transformations, etc.
+ *
+ * @example
+ * ```typescript
+ * fields: {
+ *   avatar: image({
+ *     storage: 'avatars',
+ *     transformations: {
+ *       thumbnail: { width: 100, height: 100, fit: 'cover' },
+ *       profile: { width: 400, height: 400, fit: 'cover' }
+ *     },
+ *     validation: {
+ *       maxFileSize: 5 * 1024 * 1024, // 5MB
+ *       acceptedMimeTypes: ['image/jpeg', 'image/png', 'image/webp']
+ *     }
+ *   })
+ * }
+ * ```
+ */
+export declare function image(options: Omit<ImageFieldConfig, 'type'>): ImageFieldConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fields/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE/D;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,eAAe,CAAC,YAAY,GAAG,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAChG,IAAI,EAAE,MAAM,CAAA;IACZ,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB;IACjB,EAAE,CAAC,EAAE;QACH,uDAAuD;QACvD,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;QAClC,2DAA2D;QAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,0BAA0B;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,sCAAsC;QACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,uBAAuB;QACvB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,wDAAwD;QACxD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBACf,SAAQ,eAAe,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IACnE,IAAI,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAA;IACf,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;IAC3D,8BAA8B;IAC9B,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,oEAAoE;IACpE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,iBAAiB;IACjB,EAAE,CAAC,EAAE;QACH,uDAAuD;QACvD,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;QAClC,2DAA2D;QAC3D,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,0BAA0B;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,sCAAsC;QACtC,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,uBAAuB;QACvB,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,yBAAyB;QACzB,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,qCAAqC;QACrC,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,wDAAwD;QACxD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KACvB,CAAA;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,eAAe,CAuG5E;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,gBAAgB,CAgI/E"}

package/dist/fields/index.js

@@ -0,0 +1,237 @@
+import { z } from 'zod';
+/**
+ * Creates a file upload field
+ *
+ * Uses JSON field backing to store file metadata including filename, URL, size, MIME type, etc.
+ *
+ * @example
+ * ```typescript
+ * fields: {
+ *   resume: file({
+ *     storage: 'documents',
+ *     validation: {
+ *       maxFileSize: 10 * 1024 * 1024, // 10MB
+ *       acceptedMimeTypes: ['application/pdf']
+ *     }
+ *   })
+ * }
+ * ```
+ */
+export function file(options) {
+    const fieldConfig = {
+        type: 'file',
+        ...options,
+        hooks: {
+            resolveInput: async ({ inputValue, context, item, fieldName }) => {
+                // If null/undefined, return as-is (deletion or no change)
+                if (inputValue === null || inputValue === undefined) {
+                    return inputValue;
+                }
+                // If already FileMetadata, keep existing (edit mode - no new file uploaded)
+                if (typeof inputValue === 'object' && 'filename' in inputValue && 'url' in inputValue) {
+                    return inputValue;
+                }
+                // If File object, upload it
+                // Check if it's a File-like object (has arrayBuffer method)
+                if (typeof inputValue === 'object' &&
+                    'arrayBuffer' in inputValue &&
+                    typeof inputValue.arrayBuffer === 'function') {
+                    // Convert File to buffer
+                    const fileObj = inputValue;
+                    const arrayBuffer = await fileObj.arrayBuffer();
+                    const buffer = Buffer.from(arrayBuffer);
+                    // Upload file using context.storage utilities
+                    const metadata = (await context.storage.uploadFile(fieldConfig.storage, fileObj, buffer, {
+                        validation: fieldConfig.validation,
+                    }));
+                    // If cleanupOnReplace is enabled and there was an old file, delete it
+                    if (fieldConfig.cleanupOnReplace && item && fieldName) {
+                        const oldMetadata = item[fieldName];
+                        if (oldMetadata && oldMetadata.filename) {
+                            try {
+                                await context.storage.deleteFile(oldMetadata.storageProvider, oldMetadata.filename);
+                            }
+                            catch (error) {
+                                // Log error but don't fail the operation
+                                console.error(`Failed to cleanup old file: ${oldMetadata.filename}`, error);
+                            }
+                        }
+                    }
+                    return metadata;
+                }
+                // Unknown type - return as-is and let validation catch it
+                return inputValue;
+            },
+            afterOperation: async ({ operation, item, fieldName, context }) => {
+                // Only cleanup on delete if enabled
+                if (operation === 'delete' && fieldConfig.cleanupOnDelete) {
+                    const fileMetadata = item[fieldName];
+                    if (fileMetadata && fileMetadata.filename) {
+                        try {
+                            await context.storage.deleteFile(fileMetadata.storageProvider, fileMetadata.filename);
+                        }
+                        catch (error) {
+                            // Log error but don't fail the operation
+                            console.error(`Failed to cleanup file on delete: ${fileMetadata.filename}`, error);
+                        }
+                    }
+                }
+            },
+        },
+        getZodSchema: (_fieldName, _operation) => {
+            // File metadata follows the FileMetadata schema
+            const fileMetadataSchema = z.object({
+                filename: z.string(),
+                originalFilename: z.string(),
+                url: z.string(), // Accept both absolute URLs and relative paths
+                mimeType: z.string(),
+                size: z.number(),
+                uploadedAt: z.string(),
+                storageProvider: z.string(),
+                metadata: z.record(z.string(), z.unknown()).optional(),
+            });
+            // Allow null or undefined values
+            return z.union([fileMetadataSchema, z.null(), z.undefined()]);
+        },
+        getPrismaType: (_fieldName) => {
+            // Store as JSON in database
+            return { type: 'Json', modifiers: '?' };
+        },
+        getTypeScriptType: () => {
+            // TypeScript type is FileMetadata | null
+            return {
+                type: 'import("@opensaas/stack-storage").FileMetadata | null',
+                optional: true,
+            };
+        },
+    };
+    return fieldConfig;
+}
+/**
+ * Creates an image upload field with optional transformations
+ *
+ * Uses JSON field backing to store image metadata including dimensions, transformations, etc.
+ *
+ * @example
+ * ```typescript
+ * fields: {
+ *   avatar: image({
+ *     storage: 'avatars',
+ *     transformations: {
+ *       thumbnail: { width: 100, height: 100, fit: 'cover' },
+ *       profile: { width: 400, height: 400, fit: 'cover' }
+ *     },
+ *     validation: {
+ *       maxFileSize: 5 * 1024 * 1024, // 5MB
+ *       acceptedMimeTypes: ['image/jpeg', 'image/png', 'image/webp']
+ *     }
+ *   })
+ * }
+ * ```
+ */
+export function image(options) {
+    const fieldConfig = {
+        type: 'image',
+        ...options,
+        hooks: {
+            resolveInput: async ({ inputValue, context, item, fieldName }) => {
+                // If null/undefined, return as-is (deletion or no change)
+                if (inputValue === null || inputValue === undefined) {
+                    return inputValue;
+                }
+                // If already ImageMetadata, keep existing (edit mode - no new file uploaded)
+                if (typeof inputValue === 'object' &&
+                    'filename' in inputValue &&
+                    'url' in inputValue &&
+                    'width' in inputValue &&
+                    'height' in inputValue) {
+                    return inputValue;
+                }
+                // If File object, upload it
+                // Check if it's a File-like object (has arrayBuffer method)
+                if (typeof inputValue === 'object' &&
+                    'arrayBuffer' in inputValue &&
+                    typeof inputValue.arrayBuffer === 'function') {
+                    // Convert File to buffer
+                    const fileObj = inputValue;
+                    const arrayBuffer = await fileObj.arrayBuffer();
+                    const buffer = Buffer.from(arrayBuffer);
+                    // Upload image using context.storage utilities
+                    const metadata = (await context.storage.uploadImage(fieldConfig.storage, fileObj, buffer, {
+                        validation: fieldConfig.validation,
+                        transformations: fieldConfig.transformations,
+                    }));
+                    // If cleanupOnReplace is enabled and there was an old file, delete it
+                    if (fieldConfig.cleanupOnReplace && item && fieldName) {
+                        const oldMetadata = item[fieldName];
+                        if (oldMetadata && oldMetadata.filename) {
+                            try {
+                                await context.storage.deleteImage(oldMetadata);
+                            }
+                            catch (error) {
+                                // Log error but don't fail the operation
+                                console.error(`Failed to cleanup old image: ${oldMetadata.filename}`, error);
+                            }
+                        }
+                    }
+                    return metadata;
+                }
+                // Unknown type - return as-is and let validation catch it
+                return inputValue;
+            },
+            afterOperation: async ({ operation, item, fieldName, context }) => {
+                // Only cleanup on delete if enabled
+                if (operation === 'delete' && fieldConfig.cleanupOnDelete) {
+                    const imageMetadata = item[fieldName];
+                    if (imageMetadata && imageMetadata.filename) {
+                        try {
+                            await context.storage.deleteImage(imageMetadata);
+                        }
+                        catch (error) {
+                            // Log error but don't fail the operation
+                            console.error(`Failed to cleanup image on delete: ${imageMetadata.filename}`, error);
+                        }
+                    }
+                }
+            },
+        },
+        getZodSchema: (_fieldName, _operation) => {
+            // Image metadata follows the ImageMetadata schema (extends FileMetadata)
+            const imageMetadataSchema = z.object({
+                filename: z.string(),
+                originalFilename: z.string(),
+                url: z.string(), // Accept both absolute URLs and relative paths
+                mimeType: z.string(),
+                size: z.number(),
+                width: z.number(),
+                height: z.number(),
+                uploadedAt: z.string(),
+                storageProvider: z.string(),
+                metadata: z.record(z.string(), z.unknown()).optional(),
+                transformations: z
+                    .record(z.string(), z.object({
+                    url: z.string(), // Accept both absolute URLs and relative paths
+                    width: z.number(),
+                    height: z.number(),
+                    size: z.number(),
+                }))
+                    .optional(),
+            });
+            // Allow null or undefined values
+            return z.union([imageMetadataSchema, z.null(), z.undefined()]);
+        },
+        getPrismaType: (_fieldName) => {
+            // Store as JSON in database
+            return { type: 'Json', modifiers: '?' };
+        },
+        getTypeScriptType: () => {
+            // TypeScript type is ImageMetadata | null
+            return {
+                type: 'import("@opensaas/stack-storage").ImageMetadata | null',
+                optional: true,
+            };
+        },
+    };
+    return fieldConfig;
+}
+//# sourceMappingURL=index.js.map

package/dist/fields/index.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './config/index.js';
+export * from './fields/index.js';
+export * from './providers/index.js';
+export * from './runtime/index.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,mBAAmB,CAAA;AAGjC,cAAc,mBAAmB,CAAA;AAGjC,cAAc,sBAAsB,CAAA;AAGpC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Config and types
+export * from './config/index.js';
+// Field builders
+export * from './fields/index.js';
+// Storage providers
+export * from './providers/index.js';
+// Runtime utilities
+export * from './runtime/index.js';
+// Upload utilities
+export * from './utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,cAAc,mBAAmB,CAAA;AAEjC,iBAAiB;AACjB,cAAc,mBAAmB,CAAA;AAEjC,oBAAoB;AACpB,cAAc,sBAAsB,CAAA;AAEpC,oBAAoB;AACpB,cAAc,oBAAoB,CAAA;AAElC,mBAAmB;AACnB,cAAc,kBAAkB,CAAA"}

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+export { LocalStorageProvider } from './local.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}

package/dist/providers/index.js

@@ -0,0 +1,2 @@
+export { LocalStorageProvider } from './local.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA"}

package/dist/providers/local.d.ts

@@ -0,0 +1,22 @@
+import type { StorageProvider, UploadOptions, UploadResult, LocalStorageConfig } from '../config/types.js';
+/**
+ * Local filesystem storage provider
+ * Stores files on the local filesystem
+ */
+export declare class LocalStorageProvider implements StorageProvider {
+    private config;
+    constructor(config: LocalStorageConfig);
+    /**
+     * Ensures the upload directory exists
+     */
+    private ensureUploadDir;
+    /**
+     * Generates a unique filename if configured
+     */
+    private generateFilename;
+    upload(file: Buffer | Uint8Array, filename: string, options?: UploadOptions): Promise<UploadResult>;
+    download(filename: string): Promise<Buffer>;
+    delete(filename: string): Promise<void>;
+    getUrl(filename: string): string;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/providers/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,kBAAkB,EACnB,MAAM,oBAAoB,CAAA;AAE3B;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,eAAe;IAC1D,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,kBAAkB;IAItC;;OAEG;YACW,eAAe;IAQ7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWlB,MAAM,CACV,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC;IAqBlB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGjC"}

package/dist/providers/local.js

@@ -0,0 +1,64 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { randomBytes } from 'node:crypto';
+/**
+ * Local filesystem storage provider
+ * Stores files on the local filesystem
+ */
+export class LocalStorageProvider {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Ensures the upload directory exists
+     */
+    async ensureUploadDir() {
+        try {
+            await fs.access(this.config.uploadDir);
+        }
+        catch {
+            await fs.mkdir(this.config.uploadDir, { recursive: true });
+        }
+    }
+    /**
+     * Generates a unique filename if configured
+     */
+    generateFilename(originalFilename) {
+        if (this.config.generateUniqueFilenames === false) {
+            return originalFilename;
+        }
+        const ext = path.extname(originalFilename);
+        const uniqueId = randomBytes(16).toString('hex');
+        const timestamp = Date.now();
+        return `${timestamp}-${uniqueId}${ext}`;
+    }
+    async upload(file, filename, options) {
+        await this.ensureUploadDir();
+        const generatedFilename = this.generateFilename(filename);
+        const filePath = path.join(this.config.uploadDir, generatedFilename);
+        // Write file to disk
+        await fs.writeFile(filePath, file);
+        // Get file stats for size
+        const stats = await fs.stat(filePath);
+        return {
+            filename: generatedFilename,
+            url: `${this.config.serveUrl}/${generatedFilename}`,
+            size: stats.size,
+            contentType: options?.contentType || 'application/octet-stream',
+            metadata: options?.metadata,
+        };
+    }
+    async download(filename) {
+        const filePath = path.join(this.config.uploadDir, filename);
+        return await fs.readFile(filePath);
+    }
+    async delete(filename) {
+        const filePath = path.join(this.config.uploadDir, filename);
+        await fs.unlink(filePath);
+    }
+    getUrl(filename) {
+        return `${this.config.serveUrl}/${filename}`;
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/providers/local.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.js","sourceRoot":"","sources":["../../src/providers/local.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAA;AACjC,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAQzC;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAoB;IAElC,YAAY,MAA0B;QACpC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,eAAe;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,gBAAwB;QAC/C,IAAI,IAAI,CAAC,MAAM,CAAC,uBAAuB,KAAK,KAAK,EAAE,CAAC;YAClD,OAAO,gBAAgB,CAAA;QACzB,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;QAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAChD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAC5B,OAAO,GAAG,SAAS,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAA;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CACV,IAAyB,EACzB,QAAgB,EAChB,OAAuB;QAEvB,MAAM,IAAI,CAAC,eAAe,EAAE,CAAA;QAE5B,MAAM,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAA;QAEpE,qBAAqB;QACrB,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAElC,0BAA0B;QAC1B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAErC,OAAO;YACL,QAAQ,EAAE,iBAAiB;YAC3B,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,iBAAiB,EAAE;YACnD,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,0BAA0B;YAC/D,QAAQ,EAAE,OAAO,EAAE,QAAQ;SAC5B,CAAA;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,QAAgB;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC3D,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,QAAgB;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAA;QAC3D,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC3B,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,QAAQ,EAAE,CAAA;IAC9C,CAAC;CACF"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,75 @@
+import type { OpenSaasConfig } from '@opensaas/stack-core';
+import type { StorageProvider, FileMetadata, ImageMetadata, ImageTransformationConfig } from '../config/types.js';
+import { type FileValidationOptions } from '../utils/upload.js';
+/**
+ * Creates a storage provider instance from config
+ */
+export declare function createStorageProvider(config: OpenSaasConfig, providerName: string): StorageProvider;
+/**
+ * Options for uploading a file
+ */
+export interface UploadFileOptions {
+    /** Validation options */
+    validation?: FileValidationOptions;
+    /** Custom metadata */
+    metadata?: Record<string, string>;
+}
+/**
+ * Options for uploading an image with transformations
+ */
+export interface UploadImageOptions extends UploadFileOptions {
+    /** Image transformations to apply */
+    transformations?: Record<string, ImageTransformationConfig>;
+}
+/**
+ * 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 declare function uploadFile(config: OpenSaasConfig, storageProviderName: string, data: {
+    file: File;
+    buffer: Buffer;
+}, options?: UploadFileOptions): Promise<FileMetadata>;
+/**
+ * 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 declare function uploadImage(config: OpenSaasConfig, storageProviderName: string, data: {
+    file: File;
+    buffer: Buffer;
+}, options?: UploadImageOptions): Promise<ImageMetadata>;
+/**
+ * Deletes a file from storage
+ */
+export declare function deleteFile(config: OpenSaasConfig, storageProviderName: string, filename: string): Promise<void>;
+/**
+ * Deletes an image and all its transformations from storage
+ */
+export declare function deleteImage(config: OpenSaasConfig, metadata: ImageMetadata): Promise<void>;
+export { parseFileFromFormData } from '../utils/upload.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,aAAa,EACb,yBAAyB,EAC1B,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAA6B,KAAK,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAG1F;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,MAAM,GACnB,eAAe,CAajB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,UAAU,CAAC,EAAE,qBAAqB,CAAA;IAClC,sBAAsB;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;CAC5D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,mBAAmB,EAAE,MAAM,EAC3B,IAAI,EAAE;IACJ,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf,EACD,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA0CvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,mBAAmB,EAAE,MAAM,EAC3B,IAAI,EAAE;IACJ,IAAI,EAAE,IAAI,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;CACf,EACD,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA8DxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhG;AAED,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA"}