@warlock.js/core 4.0.48 → 4.0.59

package/esm/storage/drivers/local-driver.js

@@ -0,0 +1,448 @@
+import {ensureDirectoryAsync,fileExistsAsync,unlinkAsync,removeDirectoryAsync}from'@mongez/fs';import {ltrim}from'@mongez/reinforcements';import crypto from'crypto';import {createWriteStream,createReadStream}from'fs';import {writeFile,stat,readFile,copyFile,rename,readdir}from'fs/promises';import {dirname,join}from'path';import {pipeline}from'stream/promises';import {storagePath}from'../../utils/paths.js';import {url}from'../../utils/urls.js';import {storageDriverContext}from'../context/storage-driver-context.js';import {getMimeType}from'../utils/mime.js';/**
+ * Local filesystem storage driver
+ *
+ * Stores files on the local filesystem with support for:
+ * - File operations (put, get, delete, copy, move)
+ * - Stream operations for large files
+ * - Batch operations
+ * - Signed temporary URLs
+ */
+class LocalDriver {
+    options;
+    /**
+     * Driver name
+     */
+    name = "local";
+    /**
+     * Root path for storage
+     */
+    root;
+    /**
+     * URL prefix for file URLs
+     */
+    urlPrefix = "";
+    /**
+     * URL prefix for temporary file URLs
+     */
+    temporaryUrlPrefix;
+    /**
+     * Secret key for signing temporary URLs
+     */
+    signatureKey;
+    constructor(options = {}) {
+        this.options = options;
+        this.root = options.root || storagePath();
+        if (options.urlPrefix) {
+            this.urlPrefix = options.urlPrefix;
+        }
+        this.temporaryUrlPrefix = options.temporaryUrlPrefix || "/temp-files";
+        this.signatureKey = options.signatureKey;
+    }
+    // ============================================================
+    // Prefix Operations
+    // ============================================================
+    /**
+     * Apply prefix to location path
+     *
+     * Priority: context prefix > driver options prefix > no prefix
+     * This allows multi-tenant scenarios where context overrides driver config.
+     *
+     * @param location - Original location path
+     * @returns Location with prefix applied if one exists
+     */
+    applyPrefix(location) {
+        // Check context prefix first (highest priority)
+        const contextPrefix = storageDriverContext.getPrefix();
+        const prefix = contextPrefix || this.options.prefix;
+        if (!prefix) {
+            return location;
+        }
+        const cleanPrefix = prefix.replace(/\/+$/, "");
+        const cleanLocation = location.replace(/^\/+/, "");
+        // Avoid double-prefixing
+        if (cleanLocation.startsWith(cleanPrefix + "/") || cleanLocation === cleanPrefix) {
+            return cleanLocation;
+        }
+        return `${cleanPrefix}/${cleanLocation}`;
+    }
+    // ============================================================
+    // Core File Operations
+    // ============================================================
+    /**
+     * Put file to local storage
+     */
+    async put(file, location, options) {
+        const absolutePath = this.getAbsolutePath(location);
+        await ensureDirectoryAsync(dirname(absolutePath));
+        const fileBuffer = await this.toBuffer(file);
+        const hash = this.calculateHash(fileBuffer);
+        await writeFile(absolutePath, new Uint8Array(fileBuffer));
+        const stats = await stat(absolutePath);
+        const mimeType = options?.mimeType || this.guessMimeType(location);
+        return {
+            path: location,
+            url: this.url(location),
+            size: stats.size,
+            hash,
+            mimeType,
+            driver: this.name,
+        };
+    }
+    /**
+     * Put file from a readable stream (for large files)
+     */
+    async putStream(stream, location, options) {
+        const absolutePath = this.getAbsolutePath(location);
+        await ensureDirectoryAsync(dirname(absolutePath));
+        // Create write stream and pipe
+        const writeStream = createWriteStream(absolutePath);
+        await pipeline(stream, writeStream);
+        // Calculate hash and get stats
+        const fileBuffer = await readFile(absolutePath);
+        const hash = this.calculateHash(fileBuffer);
+        const stats = await stat(absolutePath);
+        const mimeType = options?.mimeType || this.guessMimeType(location);
+        return {
+            path: location,
+            url: this.url(location),
+            size: stats.size,
+            hash,
+            mimeType,
+            driver: this.name,
+        };
+    }
+    /**
+     * Get file contents as Buffer
+     */
+    async get(location) {
+        const absolutePath = this.getAbsolutePath(location);
+        if (!(await fileExistsAsync(absolutePath))) {
+            throw new Error(`File not found: ${location}`);
+        }
+        return readFile(absolutePath);
+    }
+    /**
+     * Get file as a readable stream (for large files)
+     */
+    async getStream(location) {
+        const absolutePath = this.getAbsolutePath(location);
+        if (!(await fileExistsAsync(absolutePath))) {
+            throw new Error(`File not found: ${location}`);
+        }
+        return createReadStream(absolutePath);
+    }
+    /**
+     * Delete a file
+     */
+    async delete(location) {
+        const absolutePath = this.getAbsolutePath(location);
+        if (!(await fileExistsAsync(absolutePath))) {
+            return false;
+        }
+        await unlinkAsync(absolutePath);
+        return true;
+    }
+    /**
+     * Delete multiple files at once
+     */
+    async deleteMany(locations) {
+        const results = [];
+        for (const location of locations) {
+            try {
+                const deleted = await this.delete(location);
+                results.push({ location, deleted });
+            }
+            catch (error) {
+                results.push({
+                    location,
+                    deleted: false,
+                    error: error instanceof Error ? error.message : "Unknown error",
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Delete directory
+     */
+    async deleteDirectory(directoryPath) {
+        await removeDirectoryAsync(directoryPath);
+        return true;
+    }
+    /**
+     * Check if file exists
+     */
+    async exists(location) {
+        const absolutePath = this.getAbsolutePath(location);
+        return Boolean(await fileExistsAsync(absolutePath));
+    }
+    // ============================================================
+    // URL Operations
+    // ============================================================
+    /**
+     * Get public URL for file
+     */
+    url(location) {
+        return url(this.urlPrefix + "/" + ltrim(location, "/"));
+    }
+    /**
+     * Get a temporary signed URL that expires
+     * Returns a clean URL with encoded token: {temporaryUrlPrefix}/{token}
+     *
+     * @param location - File path
+     * @param expiresIn - Seconds until expiration (default: 3600)
+     */
+    async temporaryUrl(location, expiresIn = 3600) {
+        if (!this.signatureKey) {
+            throw new Error("Temporary URLs require a signatureKey in LocalDriver options. " +
+                "Configure storage.drivers.local.signatureKey in your config.");
+        }
+        const token = this.encodeTemporaryToken(location, expiresIn);
+        return `${this.temporaryUrlPrefix}/${token}`;
+    }
+    /**
+     * Encode a temporary token containing path, expiry, and signature
+     *
+     * @param location - File path
+     * @param expiresIn - Seconds until expiration
+     */
+    encodeTemporaryToken(location, expiresIn) {
+        if (!this.signatureKey) {
+            throw new Error("Temporary tokens require a signatureKey");
+        }
+        const exp = Math.floor(Date.now() / 1000) + expiresIn;
+        const sig = crypto
+            .createHmac("sha256", this.signatureKey)
+            .update(`${location}:${exp}`)
+            .digest("hex");
+        const payload = { path: location, exp, sig };
+        const json = JSON.stringify(payload);
+        // Use base64url encoding (URL-safe base64)
+        return Buffer.from(json).toString("base64url");
+    }
+    /**
+     * Validate a temporary URL token
+     * Returns a result object with validation status, file info, and convenience methods
+     *
+     * @param token - The token from the URL
+     */
+    async validateTemporaryToken(token) {
+        // Check signature key
+        if (!this.signatureKey) {
+            return { valid: false, error: "missing_key" };
+        }
+        // Decode token
+        let payload;
+        try {
+            const json = Buffer.from(token, "base64url").toString("utf-8");
+            payload = JSON.parse(json);
+        }
+        catch {
+            return { valid: false, error: "invalid_token" };
+        }
+        // Validate payload structure
+        if (!payload.path || !payload.exp || !payload.sig) {
+            return { valid: false, error: "invalid_token" };
+        }
+        // Check expiration
+        const now = Math.floor(Date.now() / 1000);
+        if (payload.exp < now) {
+            return { valid: false, error: "expired" };
+        }
+        // Verify signature
+        const expectedSig = crypto
+            .createHmac("sha256", this.signatureKey)
+            .update(`${payload.path}:${payload.exp}`)
+            .digest("hex");
+        const sigBuffer = Buffer.from(payload.sig, "hex");
+        const expectedBuffer = Buffer.from(expectedSig, "hex");
+        if (sigBuffer.length !== expectedBuffer.length) {
+            return { valid: false, error: "invalid_signature" };
+        }
+        const isValidSig = crypto.timingSafeEqual(new Uint8Array(sigBuffer), new Uint8Array(expectedBuffer));
+        if (!isValidSig) {
+            return { valid: false, error: "invalid_signature" };
+        }
+        // Check file exists
+        const absolutePath = this.getAbsolutePath(payload.path);
+        if (!(await fileExistsAsync(absolutePath))) {
+            return { valid: false, error: "file_not_found" };
+        }
+        // Build successful result with convenience methods
+        const result = {
+            valid: true,
+            path: payload.path,
+            absolutePath,
+            expiresAt: new Date(payload.exp * 1000),
+            mimeType: this.guessMimeType(payload.path),
+            driver: this,
+            getFile: () => this.get(payload.path),
+            getStream: () => this.getStream(payload.path),
+        };
+        return result;
+    }
+    // ============================================================
+    // Metadata Operations
+    // ============================================================
+    /**
+     * Get file info/metadata without downloading
+     */
+    async getInfo(location) {
+        const absolutePath = this.getAbsolutePath(location);
+        if (!(await fileExistsAsync(absolutePath))) {
+            throw new Error(`File not found: ${location}`);
+        }
+        const stats = await stat(absolutePath);
+        const name = location.split("/").pop() || "";
+        return {
+            path: location,
+            name,
+            size: stats.size,
+            isDirectory: stats.isDirectory(),
+            lastModified: stats.mtime,
+            mimeType: this.guessMimeType(location),
+        };
+    }
+    /**
+     * Get file size in bytes (shortcut for getInfo().size)
+     */
+    async size(location) {
+        const absolutePath = this.getAbsolutePath(location);
+        if (!(await fileExistsAsync(absolutePath))) {
+            throw new Error(`File not found: ${location}`);
+        }
+        const stats = await stat(absolutePath);
+        return stats.size;
+    }
+    // ============================================================
+    // File Operations
+    // ============================================================
+    /**
+     * Copy file to a new location
+     */
+    async copy(from, to) {
+        const fromPath = this.getAbsolutePath(from);
+        const toPath = this.getAbsolutePath(to);
+        if (!(await fileExistsAsync(fromPath))) {
+            throw new Error(`Source file not found: ${from}`);
+        }
+        await ensureDirectoryAsync(dirname(toPath));
+        await copyFile(fromPath, toPath);
+        const fileBuffer = await readFile(toPath);
+        const hash = this.calculateHash(fileBuffer);
+        const stats = await stat(toPath);
+        return {
+            path: to,
+            url: this.url(to),
+            size: stats.size,
+            hash,
+            mimeType: this.guessMimeType(to),
+            driver: this.name,
+        };
+    }
+    /**
+     * Move file to a new location
+     */
+    async move(from, to) {
+        const fromPath = this.getAbsolutePath(from);
+        const toPath = this.getAbsolutePath(to);
+        if (!(await fileExistsAsync(fromPath))) {
+            throw new Error(`Source file not found: ${from}`);
+        }
+        await ensureDirectoryAsync(dirname(toPath));
+        await rename(fromPath, toPath);
+        const fileBuffer = await readFile(toPath);
+        const hash = this.calculateHash(fileBuffer);
+        const stats = await stat(toPath);
+        return {
+            path: to,
+            url: this.url(to),
+            size: stats.size,
+            hash,
+            mimeType: this.guessMimeType(to),
+            driver: this.name,
+        };
+    }
+    /**
+     * List files in a directory
+     */
+    async list(directory, options) {
+        const absolutePath = this.getAbsolutePath(directory);
+        const files = [];
+        if (!(await fileExistsAsync(absolutePath))) {
+            return files;
+        }
+        const entries = await readdir(absolutePath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = join(directory, entry.name);
+            const entryStats = await stat(this.getAbsolutePath(entryPath));
+            files.push({
+                path: entryPath,
+                name: entry.name,
+                size: entryStats.size,
+                isDirectory: entry.isDirectory(),
+                lastModified: entryStats.mtime,
+                mimeType: entry.isFile() ? this.guessMimeType(entry.name) : undefined,
+            });
+            // Recursively list subdirectories if requested
+            if (options?.recursive && entry.isDirectory()) {
+                const subFiles = await this.list(entryPath, options);
+                files.push(...subFiles);
+            }
+            // Respect limit
+            if (options?.limit && files.length >= options.limit) {
+                break;
+            }
+        }
+        return files;
+    }
+    // ============================================================
+    // Path Operations
+    // ============================================================
+    /**
+     * Get absolute filesystem path for a location
+     */
+    path(location) {
+        return this.getAbsolutePath(location);
+    }
+    /**
+     * Get the storage root directory
+     */
+    getRoot() {
+        return this.root;
+    }
+    // ============================================================
+    // Utilities
+    // ============================================================
+    /**
+     * Get absolute file path
+     */
+    getAbsolutePath(location) {
+        const prefixedLocation = this.applyPrefix(location);
+        return join(this.root, prefixedLocation);
+    }
+    /**
+     * Convert various input types to Buffer
+     */
+    async toBuffer(file) {
+        if (Buffer.isBuffer(file)) {
+            return file;
+        }
+        if (typeof file === "string") {
+            return readFile(file);
+        }
+        return file.buffer();
+    }
+    /**
+     * Calculate SHA-256 hash
+     */
+    calculateHash(buffer) {
+        return crypto.createHash("sha256").update(new Uint8Array(buffer)).digest("hex");
+    }
+    /**
+     * Guess MIME type from file extension
+     */
+    guessMimeType(location) {
+        return getMimeType(location);
+    }
+}export{LocalDriver};//# sourceMappingURL=local-driver.js.map

package/esm/storage/drivers/local-driver.js.map

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

package/esm/storage/drivers/r2-driver.d.ts

@@ -0,0 +1,47 @@
+import type { R2StorageDriverOptions } from "../types";
+import { CloudDriver } from "./cloud-driver";
+/**
+ * Cloudflare R2 Storage Driver
+ *
+ * R2 is S3-compatible but uses a different URL structure and doesn't require regions.
+ *
+ * URL Patterns:
+ * - With publicDomain: https://{publicDomain}/{key}
+ * - With urlPrefix: {urlPrefix}/{key}
+ * - Default public bucket: https://pub-{accountId}.r2.dev/{key}
+ *
+ * @example
+ * ```typescript
+ * const driver = new R2Driver({
+ *   bucket: "my-bucket",
+ *   region: "auto", // R2 doesn't use traditional regions
+ *   accessKeyId: process.env.R2_ACCESS_KEY_ID,
+ *   secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
+ *   accountId: process.env.R2_ACCOUNT_ID,
+ *   publicDomain: "assets.example.com", // Optional custom domain
+ * });
+ * ```
+ */
+export declare class R2Driver extends CloudDriver<R2StorageDriverOptions> {
+    /**
+     * Driver name
+     */
+    readonly name = "r2";
+    /**
+     * Get R2 endpoint URL
+     *
+     * R2 endpoint format: https://{accountId}.r2.cloudflarestorage.com
+     */
+    protected getEndpoint(): string;
+    /**
+     * Get public URL for file
+     *
+     * Priority: urlPrefix > publicDomain > default R2 URL
+     *
+     * Note: For R2 public access, you typically need to:
+     * - Enable public access on the bucket
+     * - Or use a custom domain through Cloudflare
+     */
+    url(location: string): string;
+}
+//# sourceMappingURL=r2-driver.d.ts.map

package/esm/storage/drivers/r2-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/r2-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,QAAS,SAAQ,WAAW,CAAC,sBAAsB,CAAC;IAC/D;;OAEG;IACH,SAAgB,IAAI,QAAQ;IAE5B;;;;OAIG;IACH,SAAS,CAAC,WAAW,IAAI,MAAM;IAI/B;;;;;;;;OAQG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAiBrC"}

package/esm/storage/drivers/r2-driver.js

@@ -0,0 +1,60 @@
+import {CloudDriver}from'./cloud-driver.js';/**
+ * Cloudflare R2 Storage Driver
+ *
+ * R2 is S3-compatible but uses a different URL structure and doesn't require regions.
+ *
+ * URL Patterns:
+ * - With publicDomain: https://{publicDomain}/{key}
+ * - With urlPrefix: {urlPrefix}/{key}
+ * - Default public bucket: https://pub-{accountId}.r2.dev/{key}
+ *
+ * @example
+ * ```typescript
+ * const driver = new R2Driver({
+ *   bucket: "my-bucket",
+ *   region: "auto", // R2 doesn't use traditional regions
+ *   accessKeyId: process.env.R2_ACCESS_KEY_ID,
+ *   secretAccessKey: process.env.R2_SECRET_ACCESS_KEY,
+ *   accountId: process.env.R2_ACCOUNT_ID,
+ *   publicDomain: "assets.example.com", // Optional custom domain
+ * });
+ * ```
+ */
+class R2Driver extends CloudDriver {
+    /**
+     * Driver name
+     */
+    name = "r2";
+    /**
+     * Get R2 endpoint URL
+     *
+     * R2 endpoint format: https://{accountId}.r2.cloudflarestorage.com
+     */
+    getEndpoint() {
+        return this.options.endpoint || `https://${this.options.accountId}.r2.cloudflarestorage.com`;
+    }
+    /**
+     * Get public URL for file
+     *
+     * Priority: urlPrefix > publicDomain > default R2 URL
+     *
+     * Note: For R2 public access, you typically need to:
+     * - Enable public access on the bucket
+     * - Or use a custom domain through Cloudflare
+     */
+    url(location) {
+        // 1. Use urlPrefix if configured
+        if (this.options.urlPrefix) {
+            const prefix = this.options.urlPrefix.replace(/\/+$/, "");
+            return `${prefix}/${location}`;
+        }
+        // 2. Use publicDomain if configured
+        if (this.options.publicDomain) {
+            const domain = this.options.publicDomain.replace(/\/+$/, "");
+            return `${domain}/${location}`;
+        }
+        // 3. Fallback to R2 public bucket URL
+        // Note: Public access must be enabled on the bucket for this to work
+        return `https://pub-${this.options.accountId}.r2.dev/${location}`;
+    }
+}export{R2Driver};//# sourceMappingURL=r2-driver.js.map

package/esm/storage/drivers/r2-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2-driver.js","sources":["../../../src/storage/drivers/r2-driver.ts"],"sourcesContent":[null],"names":[],"mappings":"4CAGA;;;;;;;;;;;;;;;;;;;;;AAqBG;AACG,MAAO,QAAS,SAAQ,WAAmC,CAAA;AAC/D;;AAEG;IACa,IAAI,GAAG,IAAI,CAAC;AAE5B;;;;AAIG;IACO,WAAW,GAAA;AACnB,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAW,QAAA,EAAA,IAAI,CAAC,OAAO,CAAC,SAAS,2BAA2B,CAAC;KAC9F;AAED;;;;;;;;AAQG;AACI,IAAA,GAAG,CAAC,QAAgB,EAAA;;AAEzB,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;AAC1B,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1D,YAAA,OAAO,CAAG,EAAA,MAAM,CAAI,CAAA,EAAA,QAAQ,EAAE,CAAC;AAChC,SAAA;;AAGD,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;AAC7B,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC7D,YAAA,OAAO,CAAG,EAAA,MAAM,CAAI,CAAA,EAAA,QAAQ,EAAE,CAAC;AAChC,SAAA;;;QAID,OAAO,CAAA,YAAA,EAAe,IAAI,CAAC,OAAO,CAAC,SAAS,CAAA,QAAA,EAAW,QAAQ,CAAA,CAAE,CAAC;KACnE;AACF"}

package/esm/storage/drivers/s3-driver.d.ts

@@ -0,0 +1,32 @@
+import type { CloudStorageDriverOptions } from "../types";
+import { CloudDriver } from "./cloud-driver";
+/**
+ * AWS S3 Storage Driver
+ *
+ * URL Pattern: https://{bucket}.s3.{region}.amazonaws.com/{key}
+ *
+ * @example
+ * ```typescript
+ * const driver = new S3Driver({
+ *   bucket: "my-bucket",
+ *   region: "us-east-1",
+ *   accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+ *   secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+ * });
+ * ```
+ */
+export declare class S3Driver extends CloudDriver<CloudStorageDriverOptions> {
+    /**
+     * Driver name
+     */
+    readonly name = "s3";
+    /**
+     * Get public URL for file
+     *
+     * URL formats:
+     * - With urlPrefix: {urlPrefix}/{key}
+     * - Default: https://{bucket}.s3.{region}.amazonaws.com/{key}
+     */
+    url(location: string): string;
+}
+//# sourceMappingURL=s3-driver.d.ts.map

package/esm/storage/drivers/s3-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-driver.d.ts","sourceRoot":"","sources":["../../../src/storage/drivers/s3-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE7C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAS,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAClE;;OAEG;IACH,SAAgB,IAAI,QAAQ;IAE5B;;;;;;OAMG;IACI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAUrC"}

package/esm/storage/drivers/s3-driver.js

@@ -0,0 +1,37 @@
+import {CloudDriver}from'./cloud-driver.js';/**
+ * AWS S3 Storage Driver
+ *
+ * URL Pattern: https://{bucket}.s3.{region}.amazonaws.com/{key}
+ *
+ * @example
+ * ```typescript
+ * const driver = new S3Driver({
+ *   bucket: "my-bucket",
+ *   region: "us-east-1",
+ *   accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+ *   secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+ * });
+ * ```
+ */
+class S3Driver extends CloudDriver {
+    /**
+     * Driver name
+     */
+    name = "s3";
+    /**
+     * Get public URL for file
+     *
+     * URL formats:
+     * - With urlPrefix: {urlPrefix}/{key}
+     * - Default: https://{bucket}.s3.{region}.amazonaws.com/{key}
+     */
+    url(location) {
+        // 1. Use urlPrefix if configured
+        if (this.options.urlPrefix) {
+            const prefix = this.options.urlPrefix.replace(/\/+$/, "");
+            return `${prefix}/${location}`;
+        }
+        // 2. Default S3 URL
+        return `https://${this.options.bucket}.s3.${this.options.region}.amazonaws.com/${location}`;
+    }
+}export{S3Driver};//# sourceMappingURL=s3-driver.js.map

package/esm/storage/drivers/s3-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-driver.js","sources":["../../../src/storage/drivers/s3-driver.ts"],"sourcesContent":[null],"names":[],"mappings":"4CAGA;;;;;;;;;;;;;;AAcG;AACG,MAAO,QAAS,SAAQ,WAAsC,CAAA;AAClE;;AAEG;IACa,IAAI,GAAG,IAAI,CAAC;AAE5B;;;;;;AAMG;AACI,IAAA,GAAG,CAAC,QAAgB,EAAA;;AAEzB,QAAA,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;AAC1B,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC1D,YAAA,OAAO,CAAG,EAAA,MAAM,CAAI,CAAA,EAAA,QAAQ,EAAE,CAAC;AAChC,SAAA;;AAGD,QAAA,OAAO,CAAW,QAAA,EAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA,IAAA,EAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAkB,eAAA,EAAA,QAAQ,EAAE,CAAC;KAC7F;AACF"}

package/esm/storage/index.d.ts

@@ -0,0 +1,13 @@
+export * from "./config";
+export * from "./scoped-storage";
+export * from "./storage";
+export * from "./storage-file";
+export * from "./context/storage-driver-context";
+export * from "./types";
+export * from "./utils/mime";
+export * from "./drivers/cloud-driver";
+export * from "./drivers/do-spaces-driver";
+export * from "./drivers/local-driver";
+export * from "./drivers/r2-driver";
+export * from "./drivers/s3-driver";
+//# sourceMappingURL=index.d.ts.map