@lssm/lib.files 0.0.0-canary-20251217083314 → 1.41.1

package/dist/storage/index.d.ts

@@ -1,200 +0,0 @@
-//#region src/storage/index.d.ts
-/**
- * File storage adapters for different backends.
- */
-type StorageProvider = 'LOCAL' | 'S3' | 'GCS' | 'AZURE' | 'CLOUDFLARE';
-interface StorageFile {
-  path: string;
-  size: number;
-  mimeType: string;
-  checksum?: string;
-  etag?: string;
-  metadata?: Record<string, string>;
-}
-interface UploadOptions {
-  /** Target path in storage */
-  path: string;
-  /** File content */
-  content: Buffer | string;
-  /** MIME type */
-  mimeType: string;
-  /** Additional metadata */
-  metadata?: Record<string, string>;
-  /** Whether file should be publicly accessible */
-  isPublic?: boolean;
-}
-interface PresignedUploadOptions {
-  /** Target path in storage */
-  path: string;
-  /** MIME type */
-  mimeType: string;
-  /** File size in bytes */
-  size: number;
-  /** Expiration time in seconds */
-  expiresIn?: number;
-  /** Additional conditions */
-  conditions?: Record<string, unknown>[];
-}
-interface PresignedDownloadOptions {
-  /** File path in storage */
-  path: string;
-  /** Expiration time in seconds */
-  expiresIn?: number;
-  /** Response content disposition */
-  contentDisposition?: string;
-}
-interface PresignedUrl {
-  url: string;
-  fields?: Record<string, string>;
-  expiresAt: Date;
-}
-interface ListOptions {
-  /** Path prefix */
-  prefix?: string;
-  /** Maximum results */
-  limit?: number;
-  /** Continuation token */
-  cursor?: string;
-}
-interface ListResult {
-  files: StorageFile[];
-  cursor?: string;
-  hasMore: boolean;
-}
-interface StorageAdapter {
-  /** Storage provider type */
-  readonly provider: StorageProvider;
-  /**
-   * Upload a file to storage.
-   */
-  upload(options: UploadOptions): Promise<StorageFile>;
-  /**
-   * Download a file from storage.
-   */
-  download(path: string): Promise<Buffer>;
-  /**
-   * Delete a file from storage.
-   */
-  delete(path: string): Promise<void>;
-  /**
-   * Check if a file exists.
-   */
-  exists(path: string): Promise<boolean>;
-  /**
-   * Get file metadata.
-   */
-  getMetadata(path: string): Promise<StorageFile | null>;
-  /**
-   * List files in a directory.
-   */
-  list(options?: ListOptions): Promise<ListResult>;
-  /**
-   * Generate a presigned URL for uploading.
-   */
-  createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;
-  /**
-   * Generate a presigned URL for downloading.
-   */
-  createPresignedDownload(options: PresignedDownloadOptions): Promise<PresignedUrl>;
-  /**
-   * Get public URL for a file (if applicable).
-   */
-  getPublicUrl(path: string): string | null;
-  /**
-   * Copy a file within storage.
-   */
-  copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;
-}
-interface LocalStorageOptions {
-  /** Base directory for file storage */
-  basePath: string;
-  /** Base URL for serving files (optional) */
-  baseUrl?: string;
-}
-/**
- * Local filesystem storage adapter.
- * For development and testing purposes.
- */
-declare class LocalStorageAdapter implements StorageAdapter {
-  readonly provider: StorageProvider;
-  private basePath;
-  private baseUrl?;
-  constructor(options: LocalStorageOptions);
-  upload(options: UploadOptions): Promise<StorageFile>;
-  download(filePath: string): Promise<Buffer>;
-  delete(filePath: string): Promise<void>;
-  exists(filePath: string): Promise<boolean>;
-  getMetadata(filePath: string): Promise<StorageFile | null>;
-  list(options?: ListOptions): Promise<ListResult>;
-  createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;
-  createPresignedDownload(options: PresignedDownloadOptions): Promise<PresignedUrl>;
-  getPublicUrl(filePath: string): string | null;
-  copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;
-}
-interface S3StorageOptions {
-  /** S3 bucket name */
-  bucket: string;
-  /** AWS region */
-  region: string;
-  /** AWS access key ID */
-  accessKeyId?: string;
-  /** AWS secret access key */
-  secretAccessKey?: string;
-  /** Endpoint URL (for S3-compatible services) */
-  endpoint?: string;
-  /** Force path style (for S3-compatible services) */
-  forcePathStyle?: boolean;
-  /** Default ACL for uploads */
-  defaultAcl?: 'private' | 'public-read';
-}
-/**
- * S3 storage adapter interface.
- * Implementation would use AWS SDK or compatible client.
- *
- * This is a placeholder that defines the interface.
- * Actual implementation would require @aws-sdk/client-s3 dependency.
- */
-declare class S3StorageAdapter implements StorageAdapter {
-  readonly provider: StorageProvider;
-  private config;
-  constructor(options: S3StorageOptions);
-  upload(options: UploadOptions): Promise<StorageFile>;
-  download(filePath: string): Promise<Buffer>;
-  delete(filePath: string): Promise<void>;
-  exists(filePath: string): Promise<boolean>;
-  getMetadata(filePath: string): Promise<StorageFile | null>;
-  list(options?: ListOptions): Promise<ListResult>;
-  createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;
-  createPresignedDownload(options: PresignedDownloadOptions): Promise<PresignedUrl>;
-  getPublicUrl(filePath: string): string | null;
-  copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;
-}
-/**
- * In-memory storage adapter for testing.
- */
-declare class InMemoryStorageAdapter implements StorageAdapter {
-  readonly provider: StorageProvider;
-  private files;
-  upload(options: UploadOptions): Promise<StorageFile>;
-  download(filePath: string): Promise<Buffer>;
-  delete(filePath: string): Promise<void>;
-  exists(filePath: string): Promise<boolean>;
-  getMetadata(filePath: string): Promise<StorageFile | null>;
-  list(options?: ListOptions): Promise<ListResult>;
-  createPresignedUpload(options: PresignedUploadOptions): Promise<PresignedUrl>;
-  createPresignedDownload(options: PresignedDownloadOptions): Promise<PresignedUrl>;
-  getPublicUrl(filePath: string): string | null;
-  copy(sourcePath: string, destinationPath: string): Promise<StorageFile>;
-  clear(): void;
-}
-interface StorageConfig {
-  provider: StorageProvider;
-  local?: LocalStorageOptions;
-  s3?: S3StorageOptions;
-}
-/**
- * Create a storage adapter based on configuration.
- */
-declare function createStorageAdapter(config: StorageConfig): StorageAdapter;
-//#endregion
-export { InMemoryStorageAdapter, ListOptions, ListResult, LocalStorageAdapter, LocalStorageOptions, PresignedDownloadOptions, PresignedUploadOptions, PresignedUrl, S3StorageAdapter, S3StorageOptions, StorageAdapter, StorageConfig, StorageFile, StorageProvider, UploadOptions, createStorageAdapter };