@fedify/cfworkers 1.9.0-pr.388.1454

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright 2024–2025 Hong Minhee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/dist/mod.d.ts

@@ -0,0 +1,50 @@
+import { KVNamespace, Queue } from "@cloudflare/workers-types/experimental";
+import { KvKey, KvStore, KvStoreSetOptions, MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions } from "@fedify/fedify/federation";
+
+//#region src/mod.d.ts
+
+/**
+ * Implementation of the {@link KvStore} interface for Cloudflare Workers KV
+ * binding.  This class provides a wrapper around Cloudflare's KV namespace to
+ * store and retrieve JSON-serializable values using structured keys.
+ *
+ * Note that this implementation does not support the {@link KvStore.cas}
+ * operation, as Cloudflare Workers KV does not support atomic compare-and-swap
+ * operations.  If you need this functionality, consider using a different
+ * key–value store that supports atomic operations.
+ * @since 1.6.0
+ */
+declare class WorkersKvStore implements KvStore {
+  #private;
+  constructor(namespace: KVNamespace<string>);
+  get<T = unknown>(key: KvKey): Promise<T | undefined>;
+  set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
+  delete(key: KvKey): Promise<void>;
+}
+/**
+ * Implementation of the {@link MessageQueue} interface for Cloudflare
+ * Workers Queues binding.  This class provides a wrapper around Cloudflare's
+ * Queues to send messages to a queue.
+ *
+ * Note that this implementation does not support the `listen()` method,
+ * as Cloudflare Workers Queues do not support message consumption in the same
+ * way as other message queue systems.  Instead, you should use
+ * the {@link Federation.processQueuedTask} method to process messages
+ * passed to the queue.
+ * @since 1.6.0
+ */
+declare class WorkersMessageQueue implements MessageQueue {
+  #private;
+  /**
+   * Cloudflare Queues provide automatic retry with exponential backoff
+   * and Dead Letter Queues.
+   * @since 1.7.0
+   */
+  readonly nativeRetrial = true;
+  constructor(queue: Queue);
+  enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
+  enqueueMany(messages: any[], options?: MessageQueueEnqueueOptions): Promise<void>;
+  listen(_handler: (message: any) => Promise<void> | void, _options?: MessageQueueListenOptions): Promise<void>;
+}
+//#endregion
+export { WorkersKvStore, WorkersMessageQueue };

package/dist/mod.js

@@ -0,0 +1,80 @@
+//#region src/mod.ts
+/**
+* Implementation of the {@link KvStore} interface for Cloudflare Workers KV
+* binding.  This class provides a wrapper around Cloudflare's KV namespace to
+* store and retrieve JSON-serializable values using structured keys.
+*
+* Note that this implementation does not support the {@link KvStore.cas}
+* operation, as Cloudflare Workers KV does not support atomic compare-and-swap
+* operations.  If you need this functionality, consider using a different
+* key–value store that supports atomic operations.
+* @since 1.6.0
+*/
+var WorkersKvStore = class {
+	#namespace;
+	constructor(namespace) {
+		this.#namespace = namespace;
+	}
+	#encodeKey(key) {
+		return JSON.stringify(key);
+	}
+	async get(key) {
+		const encodedKey = this.#encodeKey(key);
+		const { value, metadata } = await this.#namespace.getWithMetadata(encodedKey, "json");
+		return metadata == null || metadata.expires < Date.now() ? void 0 : value;
+	}
+	async set(key, value, options) {
+		const encodedKey = this.#encodeKey(key);
+		const metadata = options?.ttl == null ? {} : { expires: Date.now() + options.ttl.total("milliseconds") };
+		await this.#namespace.put(encodedKey, JSON.stringify(value), options?.ttl == null ? { metadata } : {
+			expirationTtl: Math.max(options.ttl.total("seconds"), 60),
+			metadata
+		});
+	}
+	delete(key) {
+		return this.#namespace.delete(this.#encodeKey(key));
+	}
+};
+/**
+* Implementation of the {@link MessageQueue} interface for Cloudflare
+* Workers Queues binding.  This class provides a wrapper around Cloudflare's
+* Queues to send messages to a queue.
+*
+* Note that this implementation does not support the `listen()` method,
+* as Cloudflare Workers Queues do not support message consumption in the same
+* way as other message queue systems.  Instead, you should use
+* the {@link Federation.processQueuedTask} method to process messages
+* passed to the queue.
+* @since 1.6.0
+*/
+var WorkersMessageQueue = class {
+	#queue;
+	/**
+	* Cloudflare Queues provide automatic retry with exponential backoff
+	* and Dead Letter Queues.
+	* @since 1.7.0
+	*/
+	nativeRetrial = true;
+	constructor(queue) {
+		this.#queue = queue;
+	}
+	enqueue(message, options) {
+		return this.#queue.send(message, {
+			contentType: "json",
+			delaySeconds: options?.delay?.total("seconds") ?? 0
+		});
+	}
+	enqueueMany(messages, options) {
+		const requests = messages.map((msg) => ({
+			body: msg,
+			contentType: "json"
+		}));
+		return this.#queue.sendBatch(requests, { delaySeconds: options?.delay?.total("seconds") ?? 0 });
+	}
+	listen(_handler, _options) {
+		throw new TypeError("WorkersMessageQueue does not support listen().  Use Federation.processQueuedTask() method instead.");
+	}
+};
+
+//#endregion
+export { WorkersKvStore, WorkersMessageQueue };

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@fedify/cfworkers",
+  "version": "1.9.0-pr.388.1454+d7cc8c70",
+  "description": "Adapt Fedify with Cloudflare Workers",
+  "keywords": [
+    "Fedify",
+    "ActivityPub",
+    "Fediverse",
+    "Cloudflare Workers"
+  ],
+  "author": {
+    "name": "Hong Minhee",
+    "email": "hong@minhee.org",
+    "url": "https://hongminhee.org/"
+  },
+  "homepage": "https://fedify.dev/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fedify-dev/fedify.git",
+    "directory": "packages/cfworkers"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/fedify-dev/fedify/issues"
+  },
+  "funding": [
+    "https://opencollective.com/fedify",
+    "https://github.com/sponsors/dahlia"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/",
+    "package.json"
+  ],
+  "peerDependencies": {
+    "@cloudflare/workers-types": "^4.20250529.0",
+    "@fedify/fedify": "1.9.0-pr.388.1454+d7cc8c70"
+  },
+  "devDependencies": {
+    "tsdown": "^0.12.9",
+    "typescript": "^5.9.2"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "prepublish": "tsdown",
+    "test": "deno task codegen && tsdown && cd dist/ && node --test"
+  }
+}