@fedify/fedify 1.6.1-pr.242.861 → 1.6.1-pr.242.863

package/dist/x/cfworkers.d.ts

@@ -1,19 +1,21 @@
 import { Temporal } from "@js-temporal/polyfill";
 import { URLPattern } from "urlpattern-polyfill";
 import { KvKey, KvStore, KvStoreSetOptions } from "../federation/kv.js";
-import { KVNamespace } from "@cloudflare/workers-types/experimental";
+import { MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions } from "../federation/mq.js";
+import { KVNamespace, Queue } from "@cloudflare/workers-types/experimental";
 
 //#region x/cfworkers.d.ts
 /**
-* Implementation of the 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.
+* 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.
 * @since 1.6.0
 */
+
 /**
- * Implementation of the 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.
+ * 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.
  * @since 1.6.0
  */
 declare class WorkersKvStore implements KvStore {
@@ -23,6 +25,25 @@ declare class WorkersKvStore implements KvStore {
   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;
+  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 };
+export { WorkersKvStore, WorkersMessageQueue };

package/dist/x/cfworkers.js

@@ -4,9 +4,9 @@
     
 //#region x/cfworkers.ts
 /**
-* Implementation of the 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.
+* 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.
 * @since 1.6.0
 */
 var WorkersKvStore = class {
@@ -34,6 +34,40 @@ var WorkersKvStore = class {
 		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;
+	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 };
+export { WorkersKvStore, WorkersMessageQueue };

package/dist/x/cfworkers.test.js

@@ -4,7 +4,8 @@
     
 import { assertEquals } from "../node_modules/.pnpm/@jsr_std__assert@0.226.0/node_modules/@jsr/std__assert/assert_equals.js";
 import { test } from "../testing/mod.js";
-import { WorkersKvStore } from "./cfworkers.js";
+import { WorkersKvStore, WorkersMessageQueue } from "./cfworkers.js";
+import { delay } from "@es-toolkit/es-toolkit";
 
 //#region x/cfworkers.test.ts
 test({
@@ -32,5 +33,46 @@ test({
 		});
 	}
 });
+test({
+	name: "WorkersMessageQueue",
+	ignore: !("navigator" in globalThis && navigator.userAgent === "Cloudflare-Workers"),
+	async fn(t) {
+		const { env, messageBatches } = t;
+		const queue = new WorkersMessageQueue(env.Q1);
+		await queue.enqueue({
+			foo: 1,
+			bar: 2
+		});
+		await waitFor(() => messageBatches.length > 0, 5e3);
+		assertEquals(messageBatches.length, 1);
+		assertEquals(messageBatches[0].queue, "Q1");
+		assertEquals(messageBatches[0].messages.length, 1);
+		assertEquals(messageBatches[0].messages[0].body, {
+			foo: 1,
+			bar: 2
+		});
+		await queue.enqueue({
+			baz: 3,
+			qux: 4
+		}, { delay: Temporal.Duration.from({ seconds: 3 }) });
+		await delay(2e3);
+		assertEquals(messageBatches.length, 1);
+		await waitFor(() => messageBatches.length > 1, 6e3);
+		assertEquals(messageBatches[1].queue, "Q1");
+		assertEquals(messageBatches[1].messages.length, 1);
+		assertEquals(messageBatches[1].messages[0].body, {
+			baz: 3,
+			qux: 4
+		});
+	}
+});
+async function waitFor(predicate, timeoutMs) {
+	let delayed = 0;
+	while (!predicate()) {
+		await delay(500);
+		delayed += 500;
+		if (delayed > timeoutMs) throw new Error("Timeout");
+	}
+}
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "1.6.1-pr.242.861+0aad6d7f",
+  "version": "1.6.1-pr.242.863+a0e491e3",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",