@kaiz11/stack-client 0.0.14

package/dist/storage/bucket-ref.js

@@ -0,0 +1,529 @@
+import { storagePath } from "../lib/paths.js";
+import { createTusUpload } from "./tus-upload.js";
+import { normalizeObject, } from "./types.js";
+/**
+ * Build query string from transform options
+ */
+function buildTransformParams(transform) {
+    if (!transform)
+        return "";
+    const params = new URLSearchParams();
+    if (transform.width)
+        params.set("width", String(transform.width));
+    if (transform.height)
+        params.set("height", String(transform.height));
+    if (transform.resize)
+        params.set("resize", transform.resize);
+    if (transform.format)
+        params.set("format", transform.format);
+    if (transform.quality)
+        params.set("quality", String(transform.quality));
+    const str = params.toString();
+    return str ? `?${str}` : "";
+}
+/**
+ * Convert FileBody to Blob
+ */
+async function toBlob(file) {
+    if (file instanceof Blob) {
+        return file;
+    }
+    if (file instanceof ArrayBuffer) {
+        return new Blob([file]);
+    }
+    if (typeof file === "string") {
+        return new Blob([file], { type: "text/plain" });
+    }
+    // ReadableStream - convert to blob
+    const response = new Response(file);
+    return response.blob();
+}
+/**
+ * Bucket reference for fluent object operations
+ */
+export class BucketRef {
+    http;
+    tenantId;
+    bucketId;
+    constructor(http, tenantId, bucketId) {
+        this.http = http;
+        this.tenantId = tenantId;
+        this.bucketId = bucketId;
+    }
+    path(endpoint) {
+        return storagePath(this.tenantId, endpoint);
+    }
+    /**
+     * Upload a file to the bucket
+     *
+     * Accepts string, Blob, ArrayBuffer, or ReadableStream.
+     * By default, throws if file already exists. Use `upsert: true` to overwrite.
+     *
+     * @example
+     * await client.storage.from("docs").upload("report.pdf", file);
+     * await client.storage.from("docs").upload("report.pdf", file, { upsert: true });
+     */
+    async upload(path, file, options = {}) {
+        const blob = await toBlob(file);
+        const headers = {};
+        if (options.cacheControl) {
+            headers["cache-control"] = options.cacheControl;
+        }
+        if (options.contentType) {
+            headers["content-type"] = options.contentType;
+        }
+        if (options.upsert) {
+            headers["x-upsert"] = "true";
+        }
+        if (options.metadata) {
+            headers["x-metadata"] = JSON.stringify(options.metadata);
+        }
+        // For file uploads, we need to use the correct content type
+        // If not specified, use the blob's type or default to octet-stream
+        if (!headers["content-type"]) {
+            headers["content-type"] = blob.type || "application/octet-stream";
+        }
+        const response = await this.http.rawRequest(this.path(`/object/${this.bucketId}/${path}`), {
+            method: "POST",
+            headers,
+            body: blob,
+        });
+        const data = (await response.json());
+        return {
+            id: data.Id,
+            path: path,
+            fullPath: `${this.bucketId}/${path}`,
+        };
+    }
+    /**
+     * Download a file from the bucket
+     *
+     * Returns the file as a Blob. Supports image transforms for on-the-fly resizing.
+     *
+     * @example
+     * const blob = await client.storage.from("docs").download("report.pdf");
+     * const thumbnail = await client.storage.from("images").download("photo.jpg", {
+     *   transform: { width: 200, height: 200 }
+     * });
+     */
+    async download(path, options = {}) {
+        const transformParams = buildTransformParams(options.transform);
+        const endpoint = options.transform
+            ? `/render/image/authenticated/${this.bucketId}/${path}${transformParams}`
+            : `/object/authenticated/${this.bucketId}/${path}`;
+        const response = await this.http.rawRequest(this.path(endpoint), {
+            method: "GET",
+        });
+        return response.blob();
+    }
+    /**
+     * Get the public URL for an object
+     *
+     * Constructs the URL locally (no API call). The URL only works if
+     * the bucket is set to `public: true`. Does not validate if the
+     * file exists.
+     *
+     * @example
+     * const url = client.storage.from("avatars").getPublicUrl("user123.jpg");
+     */
+    getPublicUrl(path, options = {}) {
+        const baseUrl = this.http.getBaseUrl();
+        const transformParams = buildTransformParams(options.transform);
+        let endpoint;
+        if (options.transform) {
+            endpoint = `/render/image/public/${this.bucketId}/${path}${transformParams}`;
+        }
+        else {
+            endpoint = `/object/public/${this.bucketId}/${path}`;
+        }
+        let url = `${baseUrl}${this.path(endpoint)}`;
+        // Add download parameter if specified
+        if (options.download) {
+            const separator = url.includes("?") ? "&" : "?";
+            const downloadValue = typeof options.download === "string" ? options.download : "";
+            url += `${separator}download=${encodeURIComponent(downloadValue)}`;
+        }
+        return url;
+    }
+    /**
+     * Create a signed URL for temporary access to a private file
+     *
+     * The URL expires after the specified time. Use for private buckets
+     * when you need to share a file temporarily.
+     *
+     * @example
+     * const { signedUrl } = await client.storage.from("private").createSignedUrl("doc.pdf", {
+     *   expiresIn: 3600 // 1 hour
+     * });
+     */
+    async createSignedUrl(path, options) {
+        const response = await this.http.rawRequest(this.path(`/object/sign/${this.bucketId}/${path}`), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                expiresIn: options.expiresIn,
+                transform: options.transform,
+            }),
+        });
+        const data = (await response.json());
+        const baseUrl = this.http.getBaseUrl();
+        // Storage returns relative URL like /object/sign/... - we need to add tenant path prefix
+        let signedUrl = data.signedURL.startsWith("http")
+            ? data.signedURL
+            : `${baseUrl}${this.path(data.signedURL)}`;
+        // Add download parameter if specified
+        if (options.download) {
+            const separator = signedUrl.includes("?") ? "&" : "?";
+            const downloadValue = typeof options.download === "string" ? options.download : "";
+            signedUrl += `${separator}download=${encodeURIComponent(downloadValue)}`;
+        }
+        return {
+            signedUrl,
+            path: `${this.bucketId}/${path}`,
+        };
+    }
+    /**
+     * Create signed URLs for multiple files in a single request
+     *
+     * More efficient than calling createSignedUrl multiple times.
+     *
+     * @example
+     * const urls = await client.storage.from("private").createSignedUrls(
+     *   ["doc1.pdf", "doc2.pdf"],
+     *   { expiresIn: 3600 }
+     * );
+     */
+    async createSignedUrls(paths, options) {
+        const response = await this.http.rawRequest(this.path(`/object/sign/${this.bucketId}`), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                expiresIn: options.expiresIn,
+                paths,
+            }),
+        });
+        const data = (await response.json());
+        const baseUrl = this.http.getBaseUrl();
+        return data.map((item) => {
+            // Storage returns relative URL like /object/sign/... - we need to add tenant path prefix
+            let signedUrl = item.signedURL.startsWith("http")
+                ? item.signedURL
+                : `${baseUrl}${this.path(item.signedURL)}`;
+            if (options.download) {
+                const separator = signedUrl.includes("?") ? "&" : "?";
+                const downloadValue = typeof options.download === "string" ? options.download : "";
+                signedUrl += `${separator}download=${encodeURIComponent(downloadValue)}`;
+            }
+            return {
+                signedUrl,
+                path: item.path,
+            };
+        });
+    }
+    /**
+     * Create a signed URL for uploading a file
+     *
+     * Useful for client-side uploads without exposing credentials.
+     * The returned token is used with uploadToSignedUrl.
+     *
+     * @example
+     * const { signedUrl, token } = await client.storage.from("uploads").createSignedUploadUrl("file.pdf");
+     * await client.storage.from("uploads").uploadToSignedUrl(signedUrl, token, file);
+     */
+    async createSignedUploadUrl(path, options = {}) {
+        const headers = {};
+        if (options.upsert) {
+            headers["x-upsert"] = "true";
+        }
+        const response = await this.http.rawRequest(this.path(`/object/upload/sign/${this.bucketId}/${path}`), {
+            method: "POST",
+            headers,
+        });
+        const data = (await response.json());
+        const baseUrl = this.http.getBaseUrl();
+        return {
+            // Storage returns relative URL like /object/upload/sign/... - we need to add tenant path prefix
+            signedUrl: data.url.startsWith("http")
+                ? data.url
+                : `${baseUrl}${this.path(data.url)}`,
+            token: data.token,
+            path: `${this.bucketId}/${path}`,
+        };
+    }
+    /**
+     * Upload a file using a signed upload URL
+     *
+     * Use with createSignedUploadUrl for client-side uploads.
+     * The signedUrl may point to a different domain (e.g., R2/S3).
+     *
+     * @example
+     * const { signedUrl, token } = await client.storage.from("uploads").createSignedUploadUrl("file.pdf");
+     * await client.storage.from("uploads").uploadToSignedUrl(signedUrl, token, file);
+     */
+    async uploadToSignedUrl(signedUrl, token, file, options = {}) {
+        const blob = await toBlob(file);
+        const headers = {
+            Authorization: `Bearer ${token}`,
+        };
+        if (options.cacheControl) {
+            headers["cache-control"] = options.cacheControl;
+        }
+        if (options.contentType) {
+            headers["content-type"] = options.contentType;
+        }
+        else {
+            headers["content-type"] = blob.type || "application/octet-stream";
+        }
+        if (options.onProgress && typeof XMLHttpRequest !== "undefined") {
+            return this.uploadWithXhr(signedUrl, headers, blob, options.onProgress);
+        }
+        const response = await fetch(signedUrl, {
+            method: "PUT",
+            headers,
+            body: blob,
+        });
+        if (!response.ok) {
+            throw new Error(`Upload failed: ${response.statusText}`);
+        }
+        const data = (await response.json());
+        return {
+            id: data.Id,
+            path: data.Key.split("/").slice(1).join("/"),
+            fullPath: data.Key,
+        };
+    }
+    uploadWithXhr(url, headers, blob, onProgress) {
+        return new Promise((resolve, reject) => {
+            const xhr = new XMLHttpRequest();
+            xhr.upload.addEventListener("progress", (event) => {
+                if (event.lengthComputable) {
+                    onProgress({
+                        bytesUploaded: event.loaded,
+                        bytesTotal: event.total,
+                        percentage: Math.round((event.loaded / event.total) * 100),
+                    });
+                }
+            });
+            xhr.addEventListener("load", () => {
+                if (xhr.status >= 200 && xhr.status < 300) {
+                    try {
+                        const data = JSON.parse(xhr.responseText);
+                        resolve({
+                            id: data.Id,
+                            path: data.Key.split("/").slice(1).join("/"),
+                            fullPath: data.Key,
+                        });
+                    }
+                    catch {
+                        reject(new Error("Failed to parse upload response"));
+                    }
+                }
+                else {
+                    reject(new Error(`Upload failed: ${xhr.statusText}`));
+                }
+            });
+            xhr.addEventListener("error", () => {
+                reject(new Error("Upload failed"));
+            });
+            xhr.open("PUT", url);
+            for (const [key, value] of Object.entries(headers)) {
+                xhr.setRequestHeader(key, value);
+            }
+            xhr.send(blob);
+        });
+    }
+    /**
+     * Create a resumable upload using the TUS protocol
+     *
+     * For large files that may need to resume after interruption.
+     * Returns a TusUpload object with start(), abort(), and progress callbacks.
+     *
+     * @example
+     * const upload = client.storage.from("videos").createResumableUpload("large.mp4", file, {
+     *   onProgress: ({ percentage }) => console.log(`${percentage}%`)
+     * });
+     * await upload.start();
+     */
+    createResumableUpload(path, file, options) {
+        return createTusUpload(this.http, this.tenantId, this.bucketId, path, file, options);
+    }
+    /**
+     * List objects in the bucket
+     *
+     * Supports prefix filtering, pagination, and search.
+     *
+     * @example
+     * const files = await client.storage.from("docs").list();
+     * const pdfs = await client.storage.from("docs").list({ prefix: "reports/", search: ".pdf" });
+     */
+    async list(options = {}) {
+        const response = await this.http.rawRequest(this.path(`/object/list/${this.bucketId}`), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                prefix: options.prefix ?? "",
+                limit: options.limit,
+                offset: options.offset,
+                sortBy: options.sortBy,
+                search: options.search,
+            }),
+        });
+        const data = (await response.json());
+        return data.map(normalizeObject);
+    }
+    /**
+     * List objects with cursor-based pagination
+     *
+     * Better for large buckets. Returns prefixes (folders) separately
+     * and provides a cursor for fetching the next page.
+     *
+     * @example
+     * let cursor: string | null = null;
+     * do {
+     *   const result = await client.storage.from("docs").listV2({ cursor, limit: 100 });
+     *   console.log(result.objects);
+     *   cursor = result.nextCursor;
+     * } while (cursor);
+     */
+    async listV2(options = {}) {
+        const response = await this.http.rawRequest(this.path(`/object/list-v2/${this.bucketId}`), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                prefix: options.prefix,
+                limit: options.limit,
+                cursor: options.cursor,
+                with_delimiter: options.delimiter,
+                sortBy: options.sortBy,
+            }),
+        });
+        const data = (await response.json());
+        return {
+            objects: data.objects.map(normalizeObject),
+            prefixes: data.prefixes ?? [],
+            nextCursor: data.next_cursor,
+        };
+    }
+    /**
+     * Delete objects from the bucket
+     *
+     * Accepts an array of paths. Returns the deleted objects.
+     *
+     * @example
+     * await client.storage.from("docs").remove(["old.pdf", "draft.pdf"]);
+     */
+    async remove(paths) {
+        const response = await this.http.rawRequest(this.path(`/object/${this.bucketId}`), {
+            method: "DELETE",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ prefixes: paths }),
+        });
+        const data = (await response.json());
+        return data.map(normalizeObject);
+    }
+    /**
+     * Move or rename an object
+     *
+     * Can move to a different bucket using destinationBucket option.
+     *
+     * @example
+     * await client.storage.from("docs").move("draft.pdf", "final.pdf");
+     * await client.storage.from("docs").move("file.pdf", "file.pdf", { destinationBucket: "archive" });
+     */
+    async move(fromPath, toPath, options = {}) {
+        await this.http.rawRequest(this.path("/object/move"), {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                bucketId: this.bucketId,
+                sourceKey: fromPath,
+                destinationBucket: options.destinationBucket ?? this.bucketId,
+                destinationKey: toPath,
+            }),
+        });
+    }
+    /**
+     * Copy an object to a new location
+     *
+     * By default copies metadata. Can copy to a different bucket.
+     *
+     * @example
+     * await client.storage.from("docs").copy("template.pdf", "copy.pdf");
+     * await client.storage.from("docs").copy("file.pdf", "file.pdf", { destinationBucket: "backup" });
+     */
+    async copy(fromPath, toPath, options = {}) {
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        if (options.upsert) {
+            headers["x-upsert"] = "true";
+        }
+        const response = await this.http.rawRequest(this.path("/object/copy"), {
+            method: "POST",
+            headers,
+            body: JSON.stringify({
+                bucketId: this.bucketId,
+                sourceKey: fromPath,
+                destinationBucket: options.destinationBucket ?? this.bucketId,
+                destinationKey: toPath,
+                copyMetadata: options.copyMetadata ?? true,
+                metadata: options.metadata,
+            }),
+        });
+        const data = (await response.json());
+        return {
+            id: data.Id,
+            path: data.Key,
+        };
+    }
+    /**
+     * Get metadata for an object
+     *
+     * Returns size, content type, last modified, and custom metadata.
+     *
+     * @example
+     * const info = await client.storage.from("docs").getInfo("report.pdf");
+     * console.log(info.metadata.size, info.metadata.mimetype);
+     */
+    async getInfo(path) {
+        const response = await this.http.rawRequest(this.path(`/object/info/authenticated/${this.bucketId}/${path}`), {
+            method: "GET",
+        });
+        const data = (await response.json());
+        return normalizeObject(data);
+    }
+    /**
+     * Check if an object exists in the bucket
+     *
+     * Uses a HEAD request to check existence without downloading content.
+     *
+     * @example
+     * if (await client.storage.from("docs").exists("report.pdf")) {
+     *   console.log("File exists");
+     * }
+     */
+    async exists(path) {
+        try {
+            await this.http.rawRequest(this.path(`/object/${this.bucketId}/${path}`), {
+                method: "HEAD",
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=bucket-ref.js.map

package/dist/storage/bucket-ref.js.map

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

package/dist/storage/errors.d.ts

@@ -0,0 +1,27 @@
+import { StackError } from "../lib/errors.js";
+/**
+ * Storage-specific errors
+ */
+export declare class StorageError extends StackError {
+    readonly context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, statusCode?: number, context?: Record<string, unknown> | undefined);
+    static bucketNotFound(bucketId: string): StorageError;
+    static bucketAlreadyExists(bucketId: string): StorageError;
+    static bucketNotEmpty(bucketId: string): StorageError;
+    static invalidBucketName(name: string, reason: string): StorageError;
+    static objectNotFound(path: string): StorageError;
+    static objectAlreadyExists(path: string): StorageError;
+    static invalidPath(path: string, reason: string): StorageError;
+    static fileSizeLimitExceeded(size: number, limit: number): StorageError;
+    static invalidMimeType(mimeType: string, allowed: string[]): StorageError;
+    static uploadFailed(reason: string): StorageError;
+    static uploadAborted(): StorageError;
+    static tusUploadNotFound(uploadId: string): StorageError;
+    static tusUploadExpired(): StorageError;
+    static tusOffsetMismatch(expected: number, received: number): StorageError;
+    static signedUrlExpired(): StorageError;
+    static invalidSignedUrl(reason?: string): StorageError;
+    static unauthorized(): StorageError;
+    static forbidden(action: string): StorageError;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/storage/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/storage/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;GAEG;AACH,qBAAa,YAAa,SAAQ,UAAU;aAKxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAHjD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,EACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,YAAA;IAUnD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IASrD,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAS1D,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IASrD,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAapE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IASjD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAStD,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY;IAa9D,MAAM,CAAC,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY;IASvE,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,YAAY;IASzE,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;IAMjD,MAAM,CAAC,aAAa,IAAI,YAAY;IAQpC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IASxD,MAAM,CAAC,gBAAgB,IAAI,YAAY;IAQvC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY;IAa1E,MAAM,CAAC,gBAAgB,IAAI,YAAY;IAQvC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY;IAatD,MAAM,CAAC,YAAY,IAAI,YAAY;IAQnC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY;CAK/C"}

package/dist/storage/errors.js

@@ -0,0 +1,89 @@
+import { StackError } from "../lib/errors.js";
+/**
+ * Storage-specific errors
+ */
+export class StorageError extends StackError {
+    context;
+    constructor(message, code, statusCode, context) {
+        super(message, code, statusCode);
+        this.context = context;
+        this.name = "StorageError";
+    }
+    // ============================================
+    // Bucket Errors
+    // ============================================
+    static bucketNotFound(bucketId) {
+        return new StorageError(`Bucket not found: ${bucketId}`, "bucket_not_found", 404, { bucketId });
+    }
+    static bucketAlreadyExists(bucketId) {
+        return new StorageError(`Bucket already exists: ${bucketId}`, "bucket_already_exists", 409, { bucketId });
+    }
+    static bucketNotEmpty(bucketId) {
+        return new StorageError(`Bucket is not empty: ${bucketId}`, "bucket_not_empty", 409, { bucketId });
+    }
+    static invalidBucketName(name, reason) {
+        return new StorageError(`Invalid bucket name "${name}": ${reason}`, "invalid_bucket_name", 400, { name, reason });
+    }
+    // ============================================
+    // Object Errors
+    // ============================================
+    static objectNotFound(path) {
+        return new StorageError(`Object not found: ${path}`, "object_not_found", 404, { path });
+    }
+    static objectAlreadyExists(path) {
+        return new StorageError(`Object already exists: ${path}`, "object_already_exists", 409, { path });
+    }
+    static invalidPath(path, reason) {
+        return new StorageError(`Invalid path "${path}": ${reason}`, "invalid_path", 400, { path, reason });
+    }
+    // ============================================
+    // Upload Errors
+    // ============================================
+    static fileSizeLimitExceeded(size, limit) {
+        return new StorageError(`File size ${size} bytes exceeds limit of ${limit} bytes`, "file_size_limit_exceeded", 413, { size, limit });
+    }
+    static invalidMimeType(mimeType, allowed) {
+        return new StorageError(`Invalid MIME type: ${mimeType}. Allowed: ${allowed.join(", ")}`, "invalid_mime_type", 415, { mimeType, allowed });
+    }
+    static uploadFailed(reason) {
+        return new StorageError(`Upload failed: ${reason}`, "upload_failed", 500, {
+            reason,
+        });
+    }
+    static uploadAborted() {
+        return new StorageError("Upload was aborted", "upload_aborted", 499);
+    }
+    // ============================================
+    // TUS Resumable Upload Errors
+    // ============================================
+    static tusUploadNotFound(uploadId) {
+        return new StorageError(`Resumable upload not found: ${uploadId}`, "tus_upload_not_found", 404, { uploadId });
+    }
+    static tusUploadExpired() {
+        return new StorageError("Resumable upload has expired", "tus_upload_expired", 410);
+    }
+    static tusOffsetMismatch(expected, received) {
+        return new StorageError(`Upload offset mismatch: expected ${expected}, received ${received}`, "tus_offset_mismatch", 409, { expected, received });
+    }
+    // ============================================
+    // Signed URL Errors
+    // ============================================
+    static signedUrlExpired() {
+        return new StorageError("Signed URL has expired", "signed_url_expired", 401);
+    }
+    static invalidSignedUrl(reason) {
+        return new StorageError(`Invalid signed URL${reason ? `: ${reason}` : ""}`, "invalid_signed_url", 400, reason ? { reason } : undefined);
+    }
+    // ============================================
+    // Authorization Errors
+    // ============================================
+    static unauthorized() {
+        return new StorageError("Unauthorized access to storage", "unauthorized", 401);
+    }
+    static forbidden(action) {
+        return new StorageError(`Forbidden: ${action}`, "forbidden", 403, {
+            action,
+        });
+    }
+}
+//# sourceMappingURL=errors.js.map