@warlock.js/core 4.0.174 → 4.1.3

package/esm/storage/storage-file.js.map

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

package/esm/storage/storage.d.ts

@@ -1,576 +0,0 @@
-/// <reference types="node" />
-/// <reference types="node" />
-import { type EventSubscription } from "@mongez/events";
-import type { Readable } from "stream";
-import type { UploadedFile } from "../http";
-import { ScopedStorage } from "./scoped-storage";
-import { StorageFile } from "./storage-file";
-import type { CloudStorageDriverContract, CloudStorageDriverOptions, DeleteManyResult, FileVisibility, ListOptions, LocalStorageDriverOptions, PresignedOptions, PresignedUploadOptions, PutOptions, R2StorageDriverOptions, ScopedStorageContract, StorageDriverConfig, StorageDriverContract, StorageDriverName, StorageEventHandler, StorageEventPayload, StorageEventType, StorageFileInfo, StorageManagerContract, TemporaryTokenValidation } from "./types";
-/**
- * Storage Manager
- *
- * Provides a unified interface for file storage operations across multiple
- * drivers (local, S3, R2, DigitalOcean Spaces). Extends `ScopedStorage` to
- * inherit all base operations while adding driver management and events.
- *
- * All operations return `StorageFile` instances for a consistent, rich DX.
- *
- * @example
- * ```typescript
- * // Basic usage (uses default driver)
- * const file = await storage.put(buffer, "uploads/image.jpg");
- *
- * // With options
- * const file = await storage.put(buffer, "uploads/image.jpg", {
- *   mimeType: "image/jpeg",
- *   cacheControl: "max-age=31536000"
- * });
- *
- * // Using specific driver (also returns StorageFile)
- * const file = await storage.use("s3").put(buffer, "path/to/file");
- *
- * // Get raw driver for advanced use
- * const driver = storage.driver("s3");
- * const data = await driver.put(buffer, "path/to/file"); // Returns StorageFileData
- *
- * // Stream operations for large files
- * const stream = await storage.getStream("large-file.zip");
- * await storage.putStream(readableStream, "output/file.zip");
- *
- * // Batch operations
- * const results = await storage.deleteMany(["file1.txt", "file2.txt"]);
- *
- * // Event hooks
- * storage.on("afterPut", ({ location, file }) => {
- *   console.log(`Uploaded ${location}`);
- * });
- * ```
- */
-export declare class Storage extends ScopedStorage implements StorageManagerContract {
-    /**
-     * Registered drivers (cached instances)
-     * @internal
-     */
-    protected drivers: Map<string, StorageDriverContract>;
-    /**
-     * Driver configurations
-     * @internal
-     */
-    protected configs: Map<string, StorageDriverConfig>;
-    /**
-     * Default driver name
-     * @internal
-     */
-    protected defaultDriverName: StorageDriverName;
-    /**
-     * Whether the storage has been initialized
-     * @internal
-     */
-    private initialized;
-    /**
-     * Create a new Storage manager instance
-     *
-     * Uses lazy initialization - driver is resolved on first access.
-     */
-    constructor();
-    /**
-     * Ensure storage is initialized (lazy initialization)
-     *
-     * Called automatically on first driver access.
-     */
-    init(): Promise<void>;
-    /**
-     * Reset storage defaults
-     */
-    reset(): void;
-    /**
-     * Get the currently active driver (context-aware in future)
-     *
-     * Currently returns the default driver.
-     * Will be enhanced to check AsyncLocalStorage context for multi-tenant support.
-     *
-     * @returns The active storage driver
-     */
-    get activeDriver(): StorageDriverContract;
-    /**
-     * Load drivers from configuration
-     * @internal
-     */
-    protected loadDriversFromConfig(): void;
-    /**
-     * Get a scoped storage for a specific driver
-     *
-     * Returns a `ScopedStorage` instance that wraps the specified driver.
-     * Operations on the returned instance also return `StorageFile` objects.
-     *
-     * @param name - Driver name as defined in configuration
-     * @returns ScopedStorage instance for the specified driver
-     *
-     * @example
-     * ```typescript
-     * // Upload to S3
-     * const s3File = await storage.use("s3").put(buffer, "images/photo.jpg");
-     *
-     * // Upload to local
-     * const localFile = await storage.use("local").put(buffer, "temp/file.txt");
-     *
-     * // Both return StorageFile with identical API
-     * console.log(s3File.url);
-     * console.log(localFile.url);
-     * ```
-     */
-    use(name: StorageDriverName): ScopedStorageContract;
-    /**
-     * Get a raw driver instance
-     *
-     * Returns the underlying driver directly for advanced use cases.
-     * Unlike `use()`, calling methods on the raw driver returns
-     * `StorageFileData` instead of `StorageFile`.
-     *
-     * @param name - Driver name as defined in configuration
-     * @returns Raw driver instance implementing StorageDriverContract
-     *
-     * @example
-     * ```typescript
-     * const driver = storage.getDriver("s3");
-     * const data = await driver.put(buffer, "path/to/file");
-     * // data is StorageFileData, not StorageFile
-     * ```
-     */
-    getDriver(name: StorageDriverName): StorageDriverContract;
-    /**
-     * Get root directory of current driver
-     */
-    root(apepndedPath?: string): string;
-    /**
-     * Use a cloud storage driver with extended cloud capabilities
-     *
-     * @param name - Cloud driver name (s3, r2, spaces)
-     * @returns Driver instance implementing CloudStorageDriverContract
-     * @throws Error if driver doesn't support cloud operations
-     *
-     * @example
-     * ```typescript
-     * const cloudDriver = storage.useCloud("s3");
-     * const presignedUrl = await cloudDriver.getPresignedUrl("private/doc.pdf");
-     * ```
-     */
-    useCloud(name: StorageDriverName): CloudStorageDriverContract;
-    /**
-     * Register a new driver configuration at runtime
-     *
-     * Allows dynamic driver registration for multi-tenancy or
-     * runtime configuration scenarios.
-     *
-     * @param name - Unique driver name
-     * @param config - Driver configuration
-     * @returns This instance for chaining
-     *
-     * @example
-     * ```typescript
-     * storage.register("tenant-s3", {
-     *   driver: "s3",
-     *   bucket: "tenant-bucket",
-     *   region: "us-east-1",
-     *   accessKeyId: process.env.TENANT_AWS_KEY,
-     *   secretAccessKey: process.env.TENANT_AWS_SECRET
-     * });
-     *
-     * await storage.use("tenant-s3").put(buffer, "file.txt");
-     * ```
-     */
-    register(name: StorageDriverName, config: StorageDriverConfig): this;
-    /**
-     * Set the default driver name
-     *
-     * @param name - Driver name to use as default
-     * @returns This instance for chaining
-     *
-     * @example
-     * ```typescript
-     * storage.setDefault("s3");
-     * await storage.put(buffer, "file.txt"); // Now uses S3
-     * ```
-     */
-    setDefault(name: StorageDriverName): this;
-    /**
-     * Check if current driver is a cloud driver
-     *
-     * @returns Promise resolving to true if the current driver supports cloud operations
-     */
-    isCloud(): Promise<boolean>;
-    /**
-     * Check if a driver instance supports cloud operations
-     * @internal
-     */
-    protected isCloudDriver(driver: StorageDriverContract): driver is CloudStorageDriverContract;
-    /**
-     * Register an event handler
-     *
-     * Subscribe to storage events for logging, analytics, or side effects.
-     *
-     * @param event - Event type to listen for
-     * @param handler - Handler function
-     * @returns Event subscription for unsubscribing
-     *
-     * @example
-     * ```typescript
-     * // Log all uploads
-     * storage.on("afterPut", ({ location, file }) => {
-     *   console.log(`Uploaded ${file?.size} bytes to ${location}`);
-     * });
-     *
-     * // Track deletions
-     * storage.on("afterDelete", ({ location }) => {
-     *   analytics.track("file_deleted", { path: location });
-     * });
-     * ```
-     */
-    on<T extends StorageEventPayload = StorageEventPayload>(event: StorageEventType, handler: StorageEventHandler<T>): EventSubscription;
-    /**
-     * Remove all handlers for an event type
-     *
-     * @param event - Event type to remove handlers for
-     * @returns This instance for chaining
-     *
-     * @example
-     * ```typescript
-     * storage.off("afterPut"); // Remove all afterPut handlers
-     * ```
-     */
-    off(event: StorageEventType): this;
-    /**
-     * Emit an event to all registered handlers
-     * @internal
-     */
-    protected emit<T extends StorageEventPayload>(event: StorageEventType, payload: T): Promise<void>;
-    /**
-     * Store a file in storage
-     *
-     * Extends base `put()` with event emission for beforePut/afterPut hooks.
-     *
-     * @param file - File content as Buffer, string, UploadedFile, or Readable stream
-     * @param location - Destination path
-     * @param options - Storage options (mimeType, cacheControl, etc.)
-     * @returns StorageFile instance with cached metadata
-     */
-    put(file: UploadedFile | Buffer | string | Readable, location: string, options?: PutOptions): Promise<StorageFile>;
-    /**
-     * Store a file from a readable stream (for large files)
-     *
-     * Extends base `putStream()` with event emission.
-     *
-     * @param stream - Readable stream
-     * @param location - Destination path
-     * @param options - Storage options
-     * @returns StorageFile instance with cached metadata
-     */
-    putStream(stream: Readable | string, location: string, options?: PutOptions): Promise<StorageFile>;
-    /**
-     * Store a file from a URL
-     *
-     * Downloads content from the URL and stores it at the specified location.
-     *
-     * @param url - Source URL to download from
-     * @param location - Destination path
-     * @param options - Storage options
-     * @returns StorageFile instance with cached metadata
-     *
-     * @example
-     * ```typescript
-     * const file = await storage.putFromUrl(
-     *   "https://example.com/image.jpg",
-     *   "downloads/image.jpg"
-     * );
-     * ```
-     */
-    putFromUrl(url: string, location: string, options?: PutOptions): Promise<StorageFile>;
-    /**
-     * Store a file from base64 encoded string
-     *
-     * Decodes base64 content (with optional data URL prefix) and stores it.
-     *
-     * @param base64 - Base64 encoded file content (or data URL)
-     * @param location - Destination path
-     * @param options - Storage options
-     * @returns StorageFile instance with cached metadata
-     *
-     * @example
-     * ```typescript
-     * // From plain base64
-     * const file = await storage.putFromBase64(base64String, "images/photo.jpg");
-     *
-     * // From data URL (auto-extracts MIME type)
-     * const file = await storage.putFromBase64(
-     *   "data:image/png;base64,iVBORw0KGgo...",
-     *   "images/photo.png"
-     * );
-     * ```
-     */
-    putFromBase64(base64: string, location: string, options?: PutOptions): Promise<StorageFile>;
-    /**
-     * Retrieve file contents as Buffer
-     *
-     * Uses the current driver (with async resolution).
-     *
-     * @param location - File path
-     * @returns Buffer containing file contents
-     */
-    get(location: string): Promise<Buffer>;
-    /**
-     * Get JSON content from a file
-     *
-     * Downloads and parses JSON file content.
-     *
-     * @param location - File path
-     * @returns Parsed JSON content
-     *
-     * @example
-     * ```typescript
-     * const config = await storage.getJson("config/settings.json");
-     * console.log(config.apiKey);
-     * ```
-     */
-    getJson(location: string): Promise<any>;
-    /**
-     * Retrieve a file as a readable stream (for large files)
-     *
-     * @param location - File path
-     * @returns Readable stream of file contents
-     */
-    getStream(location: string): Promise<Readable>;
-    /**
-     * Delete a file
-     *
-     * Extends base `delete()` with event emission.
-     *
-     * @param location - File path or StorageFile
-     * @returns true if deleted, false if not found
-     */
-    delete(location: string | StorageFile): Promise<boolean>;
-    /**
-     * Delete multiple files at once
-     *
-     * @param locations - Array of file paths
-     * @returns Array of delete results with status for each file
-     */
-    deleteMany(locations: string[]): Promise<DeleteManyResult[]>;
-    /**
-     * Check if a file exists
-     *
-     * @param location - File path
-     * @returns true if file exists
-     */
-    exists(location: string): Promise<boolean>;
-    /**
-     * Copy a file to a new location
-     *
-     * Extends base `copy()` with event emission.
-     *
-     * @param from - Source path or StorageFile
-     * @param to - Destination path
-     * @returns StorageFile instance at destination
-     */
-    copy(from: string | StorageFile, to: string): Promise<StorageFile>;
-    /**
-     * Move a file to a new location
-     *
-     * Extends base `move()` with event emission.
-     *
-     * @param from - Source path or StorageFile
-     * @param to - Destination path
-     * @returns StorageFile instance at destination
-     */
-    move(from: string | StorageFile, to: string): Promise<StorageFile>;
-    /**
-     * List files in a directory
-     *
-     * @param directory - Directory path (defaults to root)
-     * @param options - List options (recursive, limit, etc.)
-     * @returns Array of file information objects
-     */
-    list(directory?: string, options?: ListOptions): Promise<StorageFileInfo[]>;
-    /**
-     * Get file metadata without downloading
-     *
-     * @param location - File path
-     * @returns File information object
-     */
-    metadata(location: string): Promise<StorageFileInfo>;
-    /**
-     * Get file size in bytes
-     *
-     * @param location - File path
-     * @returns File size in bytes
-     */
-    size(location: string): Promise<number>;
-    /**
-     * Get the absolute filesystem path for a location
-     *
-     * Only available for local driver.
-     *
-     * @param location - File path
-     * @throws Error if current driver is not a local driver
-     * @returns Absolute filesystem path
-     */
-    path(location: string): Promise<string>;
-    /**
-     * Get a presigned URL for downloading a file
-     *
-     * Only available for cloud drivers.
-     *
-     * @param location - File path
-     * @param options - Presigned URL options (expiresIn)
-     * @throws Error if current driver is not a cloud driver
-     * @returns Presigned download URL
-     *
-     * @example
-     * ```typescript
-     * const url = await storage.getPresignedUrl("private/document.pdf", {
-     *   expiresIn: 3600 // 1 hour
-     * });
-     * ```
-     */
-    getPresignedUrl(location: string, options?: PresignedOptions): Promise<string>;
-    /**
-     * Get a presigned URL for uploading a file directly to cloud storage
-     *
-     * Only available for cloud drivers.
-     *
-     * @param location - Destination path
-     * @param options - Upload options (expiresIn, contentType, maxSize)
-     * @throws Error if current driver is not a cloud driver
-     * @returns Presigned upload URL
-     *
-     * @example
-     * ```typescript
-     * const uploadUrl = await storage.getPresignedUploadUrl("uploads/file.pdf", {
-     *   expiresIn: 3600,
-     *   contentType: "application/pdf"
-     * });
-     *
-     * // Client can PUT directly to this URL
-     * ```
-     */
-    getPresignedUploadUrl(location: string, options?: PresignedUploadOptions): Promise<string>;
-    /**
-     * Get the bucket name for cloud storage
-     *
-     * Only available for cloud drivers.
-     *
-     * @throws Error if current driver is not a cloud driver
-     * @returns Bucket name
-     */
-    getBucket(): Promise<string>;
-    /**
-     * Get the region for cloud storage
-     *
-     * Only available for cloud drivers.
-     *
-     * @throws Error if current driver is not a cloud driver
-     * @returns Region name
-     */
-    getRegion(): Promise<string>;
-    /**
-     * Set storage class for a file (e.g., STANDARD, GLACIER, etc.)
-     *
-     * Only available for cloud drivers.
-     *
-     * @param location - File path
-     * @param storageClass - Target storage class
-     * @throws Error if current driver is not a cloud driver
-     */
-    setStorageClass(location: string, storageClass: string): Promise<void>;
-    /**
-     * Set file visibility (public or private)
-     *
-     * Only available for cloud drivers.
-     *
-     * @param location - File path
-     * @param visibility - "public" or "private"
-     * @throws Error if current driver is not a cloud driver
-     */
-    setVisibility(location: string, visibility: FileVisibility): Promise<void>;
-    /**
-     * Get file visibility
-     *
-     * Only available for cloud drivers.
-     *
-     * @param location - File path
-     * @throws Error if current driver is not a cloud driver
-     * @returns Current visibility setting
-     */
-    getVisibility(location: string): Promise<FileVisibility>;
-    /**
-     * Get a temporary signed URL
-     *
-     * Creates a URL that provides temporary access to the file.
-     *
-     * @param location - File path
-     * @param expiresIn - Seconds until expiration (default: 3600)
-     * @returns Signed URL string
-     */
-    temporaryUrl(location: string, expiresIn?: number): Promise<string>;
-    /**
-     * Validate a temporary URL token
-     *
-     * For local driver: validates HMAC-signed tokens
-     * For cloud drivers: returns invalid (cloud validates via presigned URL)
-     *
-     * @param token - The token from the temporary URL
-     * @returns Validation result with file info and convenience methods
-     *
-     * @example
-     * ```typescript
-     * const result = await storage.validateTemporaryToken(token);
-     *
-     * if (!result.valid) {
-     *   return response.status(403).send(result.error);
-     * }
-     *
-     * // For local driver - use sendFile for efficiency
-     * if (result.absolutePath) {
-     *   return response.sendFile(result.absolutePath);
-     * }
-     *
-     * // For cloud driver - stream the file
-     * const stream = await result.getStream!();
-     * stream.pipe(response.raw);
-     * ```
-     */
-    validateTemporaryToken(token: string): Promise<TemporaryTokenValidation>;
-    /**
-     * Parse config into driver-specific options
-     * @internal
-     */
-    protected parseOptions(config: StorageDriverConfig): LocalStorageDriverOptions | CloudStorageDriverOptions | R2StorageDriverOptions;
-    /**
-     * Validate cloud driver configuration has required fields
-     * @internal
-     */
-    protected validateCloudConfig(config: StorageDriverConfig, driverName: string): void;
-    /**
-     * Get or create driver instance from cache
-     * @internal
-     */
-    protected resolveDriver(name: string): StorageDriverContract;
-    /**
-     * Resolve the default driver name (supports async resolver for multi-tenancy)
-     * @internal
-     */
-    protected resolveDefaultDriver(): Promise<StorageDriverName>;
-}
-/**
- * Singleton storage instance
- *
- * Pre-configured storage manager ready for use throughout the application.
- *
- * @example
- * ```typescript
- * import { storage } from "@warlock.js/core";
- *
- * const file = await storage.put(buffer, "uploads/file.txt");
- * ```
- */
-export declare const storage: Storage;
-//# sourceMappingURL=storage.d.ts.map

package/esm/storage/storage.d.ts.map

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