@porulle/adapter-r2 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# @porulle/adapter-r2
+
+`StorageAdapter` for [Cloudflare R2](https://developers.cloudflare.com/r2/), specifically when running on **Cloudflare Workers**. The adapter receives the R2 binding directly — no AWS SDK, no credentials in env.
+
+## Usage (Workers)
+
+```ts
+import { r2StorageAdapter } from "@porulle/adapter-r2";
+
+// In a Workers fetch handler:
+export default {
+  async fetch(request: Request, env: Env) {
+    const config = defineConfig({
+      storage: r2StorageAdapter({
+        bucket: env.MEDIA_BUCKET,         // R2 binding
+        publicBaseUrl: "https://media.acme.com",
+      }),
+      // …
+    });
+    const { app } = await createServer(config);
+    return app.fetch(request, env);
+  },
+};
+```
+
+## Why a separate adapter from S3
+
+R2 is API-compatible with S3, but on Workers you bypass the SDK entirely — the binding is a native object with `put`, `get`, `delete`, `list`. Using `@porulle/adapter-s3` on Workers would bundle the AWS SDK (~500KB), eat CPU on cold start, and force you to handle credentials. `@porulle/adapter-r2` is a few hundred lines and zero deps.
+
+## Outside Workers
+
+If you're consuming R2 from Node, use `@porulle/adapter-s3` with R2's S3 endpoint:
+
+```ts
+s3StorageAdapter({
+  bucket: "acme-media",
+  region: "auto",
+  endpoint: "https://<account>.r2.cloudflarestorage.com",
+  // …
+});
+```
+
+## What it implements
+
+`upload`, `getUrl`, `delete`, `list`. Signed URLs aren't supported by the binding directly — generate via `R2Bucket.createPresignedUrl()` outside the adapter if needed.
+
+## See also
+
+- [Cloudflare R2 docs](https://developers.cloudflare.com/r2/)
+- `@porulle/adapter-s3` — for non-Workers consumption

package/dist/src/index.d.ts

@@ -0,0 +1,35 @@
+import { type StorageAdapter } from "@porulle/core";
+export interface R2ObjectEntry {
+    key: string;
+    size: number;
+    httpMetadata?: {
+        contentType?: string;
+    };
+}
+export interface R2BucketLike {
+    put(key: string, value: ArrayBuffer | ArrayBufferView, options?: {
+        httpMetadata?: {
+            contentType?: string;
+        };
+    }): Promise<unknown>;
+    get(key: string): Promise<{
+        arrayBuffer(): Promise<ArrayBuffer>;
+        httpMetadata?: {
+            contentType?: string;
+        };
+    } | null>;
+    delete(key: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+    }): Promise<{
+        objects: R2ObjectEntry[];
+    }>;
+}
+export interface R2StorageAdapterOptions {
+    bucket: R2BucketLike;
+    bucketName: string;
+    publicBaseUrl?: string;
+    signedUrl?: (key: string, expiresIn: number) => Promise<string>;
+}
+export declare function r2StorageAdapter(options: R2StorageAdapterOptions): StorageAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,GAAG,eAAe,EACpC,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,GACA,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QACxB,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC;QACpC,YAAY,CAAC,EAAE;YACb,WAAW,CAAC,EAAE,MAAM,CAAC;SACtB,CAAC;KACH,GAAG,IAAI,CAAC,CAAC;IACV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACjE;AAcD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,cAAc,CA+EjF"}

package/dist/src/index.js

@@ -0,0 +1,87 @@
+import { Err, Ok } from "@porulle/core";
+async function toArrayBuffer(data) {
+    if (data instanceof ArrayBuffer)
+        return data;
+    return new Response(data).arrayBuffer();
+}
+function urlFor(options, key) {
+    if (options.publicBaseUrl) {
+        return `${options.publicBaseUrl.replace(/\/$/, "")}/${key}`;
+    }
+    return `r2://${options.bucketName}/${key}`;
+}
+export function r2StorageAdapter(options) {
+    return {
+        providerId: "r2",
+        async upload(key, data, contentType) {
+            try {
+                const body = await toArrayBuffer(data);
+                await options.bucket.put(key, body, {
+                    httpMetadata: {
+                        contentType,
+                    },
+                });
+                return Ok({
+                    key,
+                    url: urlFor(options, key),
+                    contentType,
+                    size: body.byteLength,
+                });
+            }
+            catch (error) {
+                return Err({
+                    code: "R2_UPLOAD_FAILED",
+                    message: error instanceof Error ? error.message : "Failed to upload object to R2.",
+                });
+            }
+        },
+        async getUrl(key) {
+            return Ok(urlFor(options, key));
+        },
+        async getSignedUrl(key, expiresIn) {
+            try {
+                if (options.signedUrl) {
+                    const url = await options.signedUrl(key, expiresIn);
+                    return Ok(url);
+                }
+                const base = urlFor(options, key);
+                return Ok(`${base}?expiresIn=${expiresIn}`);
+            }
+            catch (error) {
+                return Err({
+                    code: "R2_SIGNED_URL_FAILED",
+                    message: error instanceof Error ? error.message : "Failed to create R2 signed URL.",
+                });
+            }
+        },
+        async delete(key) {
+            try {
+                await options.bucket.delete(key);
+                return Ok(undefined);
+            }
+            catch (error) {
+                return Err({
+                    code: "R2_DELETE_FAILED",
+                    message: error instanceof Error ? error.message : "Failed to delete R2 object.",
+                });
+            }
+        },
+        async list(prefix) {
+            try {
+                const listed = await options.bucket.list({ prefix });
+                return Ok(listed.objects.map((item) => ({
+                    key: item.key,
+                    url: urlFor(options, item.key),
+                    contentType: item.httpMetadata?.contentType ?? "application/octet-stream",
+                    size: item.size,
+                })));
+            }
+            catch (error) {
+                return Err({
+                    code: "R2_LIST_FAILED",
+                    message: error instanceof Error ? error.message : "Failed to list R2 objects.",
+                });
+            }
+        },
+    };
+}