@contractspec/lib.files 1.57.0 → 1.58.0

package/dist/node/storage/index.js

@@ -0,0 +1,268 @@
+// src/storage/index.ts
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import * as crypto from "node:crypto";
+
+class LocalStorageAdapter {
+  provider = "LOCAL";
+  basePath;
+  baseUrl;
+  constructor(options) {
+    this.basePath = options.basePath;
+    this.baseUrl = options.baseUrl;
+  }
+  async upload(options) {
+    const fullPath = path.join(this.basePath, options.path);
+    const dir = path.dirname(fullPath);
+    await fs.mkdir(dir, { recursive: true });
+    const content = typeof options.content === "string" ? Buffer.from(options.content, "base64") : options.content;
+    await fs.writeFile(fullPath, content);
+    const checksum = crypto.createHash("sha256").update(content).digest("hex");
+    return {
+      path: options.path,
+      size: content.length,
+      mimeType: options.mimeType,
+      checksum,
+      metadata: options.metadata
+    };
+  }
+  async download(filePath) {
+    const fullPath = path.join(this.basePath, filePath);
+    return fs.readFile(fullPath);
+  }
+  async delete(filePath) {
+    const fullPath = path.join(this.basePath, filePath);
+    await fs.unlink(fullPath);
+  }
+  async exists(filePath) {
+    const fullPath = path.join(this.basePath, filePath);
+    try {
+      await fs.access(fullPath);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  async getMetadata(filePath) {
+    const fullPath = path.join(this.basePath, filePath);
+    try {
+      const stat2 = await fs.stat(fullPath);
+      return {
+        path: filePath,
+        size: stat2.size,
+        mimeType: "application/octet-stream"
+      };
+    } catch {
+      return null;
+    }
+  }
+  async list(options) {
+    const dir = options?.prefix ? path.join(this.basePath, options.prefix) : this.basePath;
+    try {
+      const entries = await fs.readdir(dir, { withFileTypes: true });
+      const files = [];
+      for (const entry of entries) {
+        if (entry.isFile()) {
+          const filePath = options?.prefix ? path.join(options.prefix, entry.name) : entry.name;
+          const stat2 = await fs.stat(path.join(dir, entry.name));
+          files.push({
+            path: filePath,
+            size: stat2.size,
+            mimeType: "application/octet-stream"
+          });
+        }
+      }
+      const limit = options?.limit || files.length;
+      return {
+        files: files.slice(0, limit),
+        hasMore: files.length > limit
+      };
+    } catch {
+      return { files: [], hasMore: false };
+    }
+  }
+  async createPresignedUpload(options) {
+    const expiresIn = options.expiresIn || 3600;
+    const expiresAt = new Date(Date.now() + expiresIn * 1000);
+    return {
+      url: this.baseUrl ? `${this.baseUrl}/upload?path=${encodeURIComponent(options.path)}` : `/upload?path=${encodeURIComponent(options.path)}`,
+      fields: {
+        path: options.path,
+        mimeType: options.mimeType
+      },
+      expiresAt
+    };
+  }
+  async createPresignedDownload(options) {
+    const expiresIn = options.expiresIn || 3600;
+    const expiresAt = new Date(Date.now() + expiresIn * 1000);
+    return {
+      url: this.baseUrl ? `${this.baseUrl}/download/${options.path}` : `/download/${options.path}`,
+      expiresAt
+    };
+  }
+  getPublicUrl(filePath) {
+    if (!this.baseUrl)
+      return null;
+    return `${this.baseUrl}/${filePath}`;
+  }
+  async copy(sourcePath, destinationPath) {
+    const sourceFullPath = path.join(this.basePath, sourcePath);
+    const destFullPath = path.join(this.basePath, destinationPath);
+    const destDir = path.dirname(destFullPath);
+    await fs.mkdir(destDir, { recursive: true });
+    await fs.copyFile(sourceFullPath, destFullPath);
+    const stat2 = await fs.stat(destFullPath);
+    return {
+      path: destinationPath,
+      size: stat2.size,
+      mimeType: "application/octet-stream"
+    };
+  }
+}
+
+class S3StorageAdapter {
+  provider = "S3";
+  config;
+  constructor(options) {
+    this.config = options;
+  }
+  async upload(_options) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the upload method.");
+  }
+  async download(_filePath) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the download method.");
+  }
+  async delete(_filePath) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the delete method.");
+  }
+  async exists(_filePath) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the exists method.");
+  }
+  async getMetadata(_filePath) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the getMetadata method.");
+  }
+  async list(_options) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the list method.");
+  }
+  async createPresignedUpload(_options) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedUpload method.");
+  }
+  async createPresignedDownload(_options) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the createPresignedDownload method.");
+  }
+  getPublicUrl(filePath) {
+    const { bucket, region, endpoint } = this.config;
+    if (endpoint) {
+      return `${endpoint}/${bucket}/${filePath}`;
+    }
+    return `https://${bucket}.s3.${region}.amazonaws.com/${filePath}`;
+  }
+  async copy(_sourcePath, _destinationPath) {
+    throw new Error("S3 adapter requires @aws-sdk/client-s3. Install it and implement the copy method.");
+  }
+}
+
+class InMemoryStorageAdapter {
+  provider = "LOCAL";
+  files = new Map;
+  async upload(options) {
+    const content = typeof options.content === "string" ? Buffer.from(options.content, "base64") : options.content;
+    const checksum = crypto.createHash("sha256").update(content).digest("hex");
+    const metadata = {
+      path: options.path,
+      size: content.length,
+      mimeType: options.mimeType,
+      checksum,
+      metadata: options.metadata
+    };
+    this.files.set(options.path, { content, metadata });
+    return metadata;
+  }
+  async download(filePath) {
+    const file = this.files.get(filePath);
+    if (!file) {
+      throw new Error(`File not found: ${filePath}`);
+    }
+    return file.content;
+  }
+  async delete(filePath) {
+    this.files.delete(filePath);
+  }
+  async exists(filePath) {
+    return this.files.has(filePath);
+  }
+  async getMetadata(filePath) {
+    const file = this.files.get(filePath);
+    return file?.metadata || null;
+  }
+  async list(options) {
+    const prefix = options?.prefix || "";
+    const files = [];
+    for (const [path2, file] of this.files) {
+      if (path2.startsWith(prefix)) {
+        files.push(file.metadata);
+      }
+    }
+    const limit = options?.limit || files.length;
+    return {
+      files: files.slice(0, limit),
+      hasMore: files.length > limit
+    };
+  }
+  async createPresignedUpload(options) {
+    const expiresAt = new Date(Date.now() + (options.expiresIn || 3600) * 1000);
+    return {
+      url: `/upload?path=${encodeURIComponent(options.path)}`,
+      fields: { path: options.path },
+      expiresAt
+    };
+  }
+  async createPresignedDownload(options) {
+    const expiresAt = new Date(Date.now() + (options.expiresIn || 3600) * 1000);
+    return {
+      url: `/download/${options.path}`,
+      expiresAt
+    };
+  }
+  getPublicUrl(filePath) {
+    return `/files/${filePath}`;
+  }
+  async copy(sourcePath, destinationPath) {
+    const source = this.files.get(sourcePath);
+    if (!source) {
+      throw new Error(`Source file not found: ${sourcePath}`);
+    }
+    const metadata = {
+      ...source.metadata,
+      path: destinationPath
+    };
+    this.files.set(destinationPath, { content: source.content, metadata });
+    return metadata;
+  }
+  clear() {
+    this.files.clear();
+  }
+}
+function createStorageAdapter(config) {
+  switch (config.provider) {
+    case "LOCAL":
+      if (!config.local) {
+        throw new Error("Local storage configuration required");
+      }
+      return new LocalStorageAdapter(config.local);
+    case "S3":
+      if (!config.s3) {
+        throw new Error("S3 storage configuration required");
+      }
+      return new S3StorageAdapter(config.s3);
+    default:
+      throw new Error(`Unsupported storage provider: ${config.provider}`);
+  }
+}
+export {
+  createStorageAdapter,
+  S3StorageAdapter,
+  LocalStorageAdapter,
+  InMemoryStorageAdapter
+};

package/dist/storage/index.d.ts

@@ -1,151 +1,150 @@
-//#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>;
+export type StorageProvider = 'LOCAL' | 'S3' | 'GCS' | 'AZURE' | 'CLOUDFLARE';
+export 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;
+export 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>[];
+export 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;
+export 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;
+export interface PresignedUrl {
+    url: string;
+    fields?: Record<string, string>;
+    expiresAt: Date;
 }
-interface ListOptions {
-  /** Path prefix */
-  prefix?: string;
-  /** Maximum results */
-  limit?: number;
-  /** Continuation token */
-  cursor?: string;
+export interface ListOptions {
+    /** Path prefix */
+    prefix?: string;
+    /** Maximum results */
+    limit?: number;
+    /** Continuation token */
+    cursor?: string;
 }
-interface ListResult {
-  files: StorageFile[];
-  cursor?: string;
-  hasMore: boolean;
+export 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>;
+export 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;
+export 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>;
+export 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';
+export 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.
@@ -154,48 +153,46 @@ interface S3StorageOptions {
  * 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>;
+export 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;
+export 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;
+export 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 };
+export declare function createStorageAdapter(config: StorageConfig): StorageAdapter;
 //# sourceMappingURL=index.d.ts.map