@rangedb/cloudflare 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export class RangeDBCloudflare extends RangeDB {
+    /**
+     * Initialize database by providing Cloudflare R2 bucket and file name.
+     *
+     * @param {R2Bucket} bucket Cloudflare R2 Bucket binding
+     * @param {string} key Name of the file in the bucket
+     * @param {import('@rangedb/js').RangeDBOptions} [options]
+     */
+    constructor(bucket: R2Bucket, key: string, options?: import("@rangedb/js").RangeDBOptions);
+    /** @private @type {R2Bucket} */
+    private bucket;
+    /** @private @type {string} */
+    private key;
+}
+import { RangeDB } from '@rangedb/js';

package/index.js

@@ -0,0 +1,55 @@
+// @ts-check
+
+import { RangeDB } from '@rangedb/js'
+
+export class RangeDBCloudflare extends RangeDB {
+  /**
+   * Initialize database by providing Cloudflare R2 bucket and file name.
+   *
+   * @param {R2Bucket} bucket Cloudflare R2 Bucket binding
+   * @param {string} key Name of the file in the bucket
+   * @param {import('@rangedb/js').RangeDBOptions} [options]
+   */
+  constructor(bucket, key, options = {}) {
+    super(key, options)
+    /** @private @type {R2Bucket} */
+    this.bucket = bucket
+    /** @private @type {string} */
+    this.key = key
+  }
+
+  /**
+   * Perform range read on file in Cloudflare R2 bucket.
+   *
+   * @protected
+   * @param {bigint} start
+   * @param {bigint} end
+   *
+   * @returns {Promise<ArrayBuffer>}
+   */
+  async readRange(start, end) {
+    const length = Number(end - start) + 1
+
+    const object = await this.bucket.get(this.key, {
+      range: {
+        offset: Number(start),
+        length: length,
+      },
+    })
+
+    if (object === null) {
+      throw new Error(
+        `Database file not found. Key ${this.key} not found in bucket.`,
+      )
+    }
+
+    const { etag } = object
+    if (this.etag && this.etag !== etag) {
+      this.invalidate()
+      throw new Error('Database file has changed based on ETag.')
+    }
+    this.etag = etag
+
+    return object.arrayBuffer()
+  }
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@rangedb/cloudflare",
+  "version": "1.0.0",
+  "type": "module",
+  "main": "./index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "scripts": {
+    "build:types": "npx -p typescript tsc",
+    "prepare": "npm run build:types",
+    "test": "node --experimental-test-coverage --test-coverage-include=*.js --test",
+    "test:watch": "node --test --watch"
+  },
+  "files": [
+    "index.js",
+    "dist/index.d.ts"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": false
+  },
+  "dependencies": {
+    "@rangedb/js": "*"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260307.1",
+    "@types/node": "^25.3.3"
+  }
+}