@fedify/cfworkers 2.0.0-dev.1690 → 2.0.0-dev.170

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright 2024–2025 Hong Minhee
+Copyright 2024–2026 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

package/README.md

@@ -1,7 +1,7 @@
 <!-- deno-fmt-ignore-file -->
 
 @fedify/cfworkers: Adapt Fedify with Cloudflare Workers
-======================================================
+=======================================================
 
 [![JSR][JSR badge]][JSR]
 [![npm][npm badge]][npm]
@@ -47,6 +47,20 @@ export default {
 }>;
 ~~~~
 
+[JSR badge]: https://jsr.io/badges/@fedify/cfworkers
+[JSR]: https://jsr.io/@fedify/cfworkers
+[npm badge]: https://img.shields.io/npm/v/@fedify/cfworkers?logo=npm
+[npm]: https://www.npmjs.com/package/@fedify/cfworkers
+[@fedify@hollo.social badge]: https://fedi-badge.deno.dev/@fedify@hollo.social/followers.svg
+[@fedify@hollo.social]: https://hollo.social/@fedify
+[Fedify]: https://fedify.dev/
+[`KvStore`]: https://jsr.io/@fedify/fedify/doc/federation/~/KvStore
+[`MessageQueue`]: https://jsr.io/@fedify/fedify/doc/federation/~/MessageQueue
+[Cloudflare Workers]: https://workers.cloudflare.com/
+[`WorkersKvStore`]: https://jsr.io/@fedify/cfworkers/doc/~/WorkersKvStore
+[`WorkersMessageQueue`]: https://jsr.io/@fedify/cfworkers/doc/~/WorkersMessageQueue
+
+
 `WorkersKvStore`
 ----------------
 
@@ -55,6 +69,9 @@ that uses Cloudflare's built-in [Cloudflare Workers KV] API.  It provides
 persistent storage and good performance for Cloudflare Workers environments.
 It's suitable for production use in Cloudflare Workers applications.
 
+[Cloudflare Workers KV]: https://developers.cloudflare.com/kv/
+
+
 `WorkersMessageQueue`
 ---------------------
 
@@ -65,9 +82,10 @@ Cloudflare Workers environments.  It requires a Cloudflare Queues setup and
 management.
 
 > [!NOTE]
-> Since your `KVNamespace` and `Queue` are not bound to global variables, but rather
-> passed as arguments to the `fetch()` and `queue()` methods, you need to instantiate
-> your `Federation` object inside these methods, rather than at the top level.
+> Since your `KVNamespace` and `Queue` are not bound to global variables, but
+> rather passed as arguments to the `fetch()` and `queue()` methods, you need
+> to instantiate your `Federation` object inside these methods, rather than at
+> the top level.
 >
 > For better organization, you probably want to use a builder pattern to
 > register your dispatchers and listeners before instantiating the `Federation`
@@ -83,6 +101,9 @@ management.
 > process the messages.  The `queue()` method is the only way to consume
 > messages from the queue in Cloudflare Workers.
 
+[Cloudflare Queues]: https://developers.cloudflare.com/queues/
+
+
 Installation
 ------------
 
@@ -93,18 +114,3 @@ pnpm add     @fedify/cfworkers  # pnpm
 yarn add     @fedify/cfworkers  # Yarn
 bun  add     @fedify/cfworkers  # Bun
 ~~~~
-
-[JSR]: https://jsr.io/@fedify/cfworkers
-[JSR badge]: https://jsr.io/badges/@fedify/cfworkers
-[npm]: https://www.npmjs.com/package/@fedify/cfworkers
-[npm badge]: https://img.shields.io/npm/v/@fedify/cfworkers?logo=npm
-[@fedify@hollo.social badge]: https://fedi-badge.deno.dev/@fedify@hollo.social/followers.svg
-[@fedify@hollo.social]: https://hollo.social/@fedify
-[Fedify]: https://fedify.dev/
-[`KvStore`]: https://jsr.io/@fedify/fedify/doc/federation/~/KvStore
-[`MessageQueue`]: https://jsr.io/@fedify/fedify/doc/federation/~/MessageQueue
-[`WorkersKvStore`]: https://jsr.io/@fedify/cfworkers/doc/~/WorkersKvStore
-[`WorkersMessageQueue`]: https://jsr.io/@fedify/cfworkers/doc/~/WorkersMessageQueue
-[Cloudflare Workers]: https://workers.cloudflare.com/
-[Cloudflare Workers KV]: https://developers.cloudflare.com/kv/
-[Cloudflare Queues]: https://developers.cloudflare.com/queues/

package/dist/mod.d.ts

@@ -1,5 +1,5 @@
 import { KVNamespace, Queue } from "@cloudflare/workers-types/experimental";
-import { KvKey, KvStore, KvStoreSetOptions, MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions } from "@fedify/fedify/federation";
+import { KvKey, KvStore, KvStoreListEntry, KvStoreSetOptions, MessageQueue, MessageQueueEnqueueOptions, MessageQueueListenOptions } from "@fedify/fedify/federation";
 
 //#region src/mod.d.ts
 
@@ -20,6 +20,11 @@ declare class WorkersKvStore implements KvStore {
   get<T = unknown>(key: KvKey): Promise<T | undefined>;
   set(key: KvKey, value: unknown, options?: KvStoreSetOptions): Promise<void>;
   delete(key: KvKey): Promise<void>;
+  /**
+   * {@inheritDoc KvStore.list}
+   * @since 1.10.0
+   */
+  list(prefix?: KvKey): AsyncIterable<KvStoreListEntry>;
 }
 /**
  * Implementation of the {@link MessageQueue} interface for Cloudflare
@@ -43,7 +48,7 @@ declare class WorkersMessageQueue implements MessageQueue {
   readonly nativeRetrial = true;
   constructor(queue: Queue);
   enqueue(message: any, options?: MessageQueueEnqueueOptions): Promise<void>;
-  enqueueMany(messages: any[], options?: MessageQueueEnqueueOptions): Promise<void>;
+  enqueueMany(messages: readonly any[], options?: MessageQueueEnqueueOptions): Promise<void>;
   listen(_handler: (message: any) => Promise<void> | void, _options?: MessageQueueListenOptions): Promise<void>;
 }
 //#endregion

package/dist/mod.js

@@ -34,6 +34,44 @@ var WorkersKvStore = class {
 	delete(key) {
 		return this.#namespace.delete(this.#encodeKey(key));
 	}
+	/**
+	* {@inheritDoc KvStore.list}
+	* @since 1.10.0
+	*/
+	async *list(prefix) {
+		let pattern;
+		let exactKey = null;
+		if (prefix == null || prefix.length === 0) pattern = "[";
+		else {
+			exactKey = this.#encodeKey(prefix);
+			pattern = JSON.stringify(prefix).slice(0, -1) + ",";
+		}
+		if (exactKey != null) {
+			const { value, metadata } = await this.#namespace.getWithMetadata(exactKey, "json");
+			if (value != null && (metadata == null || metadata.expires == null || metadata.expires >= Date.now())) yield {
+				key: prefix,
+				value
+			};
+		}
+		let cursor;
+		do {
+			const result = await this.#namespace.list({
+				prefix: pattern,
+				cursor
+			});
+			cursor = result.list_complete ? void 0 : result.cursor;
+			for (const keyInfo of result.keys) {
+				const metadata = keyInfo.metadata;
+				if (metadata?.expires != null && metadata.expires < Date.now()) continue;
+				const value = await this.#namespace.get(keyInfo.name, "json");
+				if (value == null) continue;
+				yield {
+					key: JSON.parse(keyInfo.name),
+					value
+				};
+			}
+		} while (cursor != null);
+	}
 };
 /**
 * Implementation of the {@link MessageQueue} interface for Cloudflare

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/cfworkers",
-  "version": "2.0.0-dev.1690+304896b8",
+  "version": "2.0.0-dev.170+a03fedcd",
   "description": "Adapt Fedify with Cloudflare Workers",
   "keywords": [
     "Fedify",
@@ -51,16 +51,19 @@
     "package.json"
   ],
   "peerDependencies": {
-    "@cloudflare/workers-types": "^4.20250529.0",
-    "@fedify/fedify": "^2.0.0-dev.1690+304896b8"
+    "@cloudflare/workers-types": "^4.20250906.0",
+    "@fedify/fedify": "^2.0.0-dev.170+a03fedcd"
   },
   "devDependencies": {
+    "@cloudflare/vitest-pool-workers": "^0.8.31",
     "tsdown": "^0.12.9",
-    "typescript": "^5.9.2"
+    "typescript": "^5.9.3",
+    "vitest": "~3.2.0",
+    "wrangler": "^4.21.1"
   },
   "scripts": {
     "build": "tsdown",
     "prepublish": "tsdown",
-    "test": "deno task codegen && tsdown && cd dist/ && node --test"
+    "test": "vitest run"
   }
 }