@parsrun/storage 0.1.0

package/dist/adapters/r2.d.ts

@@ -0,0 +1,180 @@
+import { a as StorageAdapter, R as R2Config, U as UploadOptions, F as FileMetadata, D as DownloadOptions, d as DeleteResult, B as BatchDeleteResult, L as ListOptions, c as ListResult, C as CopyOptions, P as PresignedUrlOptions } from '../types-CCTK5LsZ.js';
+
+/**
+ * @parsrun/storage - R2 Adapter
+ * Cloudflare R2 storage adapter (edge-native)
+ *
+ * This adapter works in two modes:
+ * 1. Worker binding (native R2 API) - fastest, edge-native
+ * 2. S3-compatible API - for non-Worker environments
+ */
+
+/**
+ * Cloudflare R2 Bucket binding type
+ */
+interface R2Bucket {
+    head(key: string): Promise<R2Object | null>;
+    get(key: string, options?: R2GetOptions): Promise<R2ObjectBody | null>;
+    put(key: string, value: ArrayBuffer | ArrayBufferView | ReadableStream | string | null | Blob, options?: R2PutOptions): Promise<R2Object>;
+    delete(keys: string | string[]): Promise<void>;
+    list(options?: R2ListOptions): Promise<R2Objects>;
+    createMultipartUpload(key: string, options?: R2MultipartOptions): Promise<R2MultipartUpload>;
+}
+interface R2Object {
+    key: string;
+    version: string;
+    size: number;
+    etag: string;
+    httpEtag: string;
+    checksums: R2Checksums;
+    uploaded: Date;
+    httpMetadata?: R2HTTPMetadata;
+    customMetadata?: Record<string, string>;
+    range?: R2Range;
+}
+interface R2ObjectBody extends R2Object {
+    body: ReadableStream;
+    bodyUsed: boolean;
+    arrayBuffer(): Promise<ArrayBuffer>;
+    text(): Promise<string>;
+    json<T>(): Promise<T>;
+    blob(): Promise<Blob>;
+}
+interface R2Checksums {
+    md5?: ArrayBuffer;
+    sha1?: ArrayBuffer;
+    sha256?: ArrayBuffer;
+    sha384?: ArrayBuffer;
+    sha512?: ArrayBuffer;
+}
+interface R2HTTPMetadata {
+    contentType?: string;
+    contentLanguage?: string;
+    contentDisposition?: string;
+    contentEncoding?: string;
+    cacheControl?: string;
+    cacheExpiry?: Date;
+}
+interface R2Range {
+    offset: number;
+    length: number;
+}
+interface R2GetOptions {
+    onlyIf?: R2Conditional;
+    range?: R2Range | {
+        offset?: number;
+        length?: number;
+        suffix?: number;
+    };
+}
+interface R2PutOptions {
+    httpMetadata?: R2HTTPMetadata;
+    customMetadata?: Record<string, string>;
+    md5?: ArrayBuffer | string;
+    sha1?: ArrayBuffer | string;
+    sha256?: ArrayBuffer | string;
+    sha384?: ArrayBuffer | string;
+    sha512?: ArrayBuffer | string;
+}
+interface R2Conditional {
+    etagMatches?: string;
+    etagDoesNotMatch?: string;
+    uploadedBefore?: Date;
+    uploadedAfter?: Date;
+}
+interface R2ListOptions {
+    prefix?: string;
+    cursor?: string;
+    delimiter?: string;
+    limit?: number;
+    include?: ("httpMetadata" | "customMetadata")[];
+}
+interface R2Objects {
+    objects: R2Object[];
+    truncated: boolean;
+    cursor?: string;
+    delimitedPrefixes: string[];
+}
+interface R2MultipartOptions {
+    httpMetadata?: R2HTTPMetadata;
+    customMetadata?: Record<string, string>;
+}
+interface R2MultipartUpload {
+    key: string;
+    uploadId: string;
+    uploadPart(partNumber: number, value: ArrayBuffer | ArrayBufferView | ReadableStream | string | Blob): Promise<R2UploadedPart>;
+    abort(): Promise<void>;
+    complete(uploadedParts: R2UploadedPart[]): Promise<R2Object>;
+}
+interface R2UploadedPart {
+    partNumber: number;
+    etag: string;
+}
+/**
+ * R2 Storage Adapter
+ * Native Cloudflare R2 adapter optimized for Workers/Edge
+ *
+ * @example
+ * ```typescript
+ * // In Cloudflare Worker with binding
+ * const r2 = new R2Adapter({
+ *   type: 'r2',
+ *   bucket: 'my-bucket',
+ *   accountId: env.CF_ACCOUNT_ID,
+ *   accessKeyId: env.R2_ACCESS_KEY,
+ *   secretAccessKey: env.R2_SECRET_KEY,
+ *   binding: env.MY_BUCKET, // R2 binding
+ * });
+ *
+ * // Using S3-compatible API (non-Worker)
+ * const r2 = new R2Adapter({
+ *   type: 'r2',
+ *   bucket: 'my-bucket',
+ *   accountId: env.CF_ACCOUNT_ID,
+ *   accessKeyId: env.R2_ACCESS_KEY,
+ *   secretAccessKey: env.R2_SECRET_KEY,
+ * });
+ * ```
+ */
+declare class R2Adapter implements StorageAdapter {
+    readonly type: "r2";
+    readonly bucket: string;
+    private binding;
+    private s3Adapter;
+    private config;
+    private basePath;
+    constructor(config: R2Config & {
+        binding?: R2Bucket;
+    });
+    /**
+     * Get S3 adapter for fallback
+     */
+    private getS3Adapter;
+    private getFullKey;
+    private validateKey;
+    private dataToBody;
+    upload(key: string, data: Uint8Array | ReadableStream<Uint8Array> | Blob | string, options?: UploadOptions): Promise<FileMetadata>;
+    download(key: string, options?: DownloadOptions): Promise<Uint8Array>;
+    downloadStream(key: string, options?: DownloadOptions): Promise<ReadableStream<Uint8Array>>;
+    head(key: string): Promise<FileMetadata | null>;
+    exists(key: string): Promise<boolean>;
+    delete(key: string): Promise<DeleteResult>;
+    deleteMany(keys: string[]): Promise<BatchDeleteResult>;
+    list(options?: ListOptions): Promise<ListResult>;
+    copy(sourceKey: string, destKey: string, options?: CopyOptions): Promise<FileMetadata>;
+    move(sourceKey: string, destKey: string): Promise<FileMetadata>;
+    getPresignedUrl(key: string, options?: PresignedUrlOptions): Promise<string>;
+    getUploadUrl(key: string, options?: PresignedUrlOptions): Promise<string>;
+    /**
+     * Get public URL for a file (if custom domain is configured)
+     */
+    getPublicUrl(key: string): string | null;
+}
+/**
+ * Create an R2 storage adapter
+ */
+declare function createR2Adapter(config: R2Config & {
+    binding?: R2Bucket;
+}): R2Adapter;
+
+export { R2Adapter, type R2Bucket, createR2Adapter };