Merge remote-tracking branch 'fedify-dev/next' into next

Author: dahlia

.github/workflows/build.yaml

@@ -342,9 +342,6 @@ jobs:
     - run: |
         pnpm install
         pnpm pack --recursive --filter='!./examples/**'
-        if [[ "$GITHUB_REF_TYPE" != tag ]]; then
-          rm fedify-cli-*.tgz
-        fi
     - run: deno task pack
       working-directory: ${{ github.workspace }}/packages/cli/
     - id: extract-changelog
@@ -428,7 +425,7 @@ jobs:
           | Package           | Version                                 | JSR                          | npm                          |
           | ----------------- | --------------------------------------- | ---------------------------- | ---------------------------- |
           | @fedify/fedify    | ${{ steps.versioning.outputs.version }} | [JSR][jsr:@fedify/fedify]    | [npm][npm:@fedify/fedify]    |
-          | @fedify/cli       | ${{ steps.versioning.outputs.version }} | [JSR][jsr:@fedify/cli]       |                              |
+          | @fedify/cli       | ${{ steps.versioning.outputs.version }} | [JSR][jsr:@fedify/cli]       | [npm][npm:@fedify/cli]       |
           | @fedify/amqp      | ${{ steps.versioning.outputs.version }} | [JSR][jsr:@fedify/amqp]      | [npm][npm:@fedify/amqp]      |
           | @fedify/cfworkers | ${{ steps.versioning.outputs.version }} | [JSR][jsr:@fedify/cfworkers] | [npm][npm:@fedify/cfworkers] |
           | @fedify/denokv    | ${{ steps.versioning.outputs.version }} | [JSR][jsr:@fedify/denokv]    |                              |
@@ -448,6 +445,7 @@ jobs:
           [jsr:@fedify/fedify]: https://jsr.io/@fedify/fedify@${{ steps.versioning.outputs.version }}
           [npm:@fedify/fedify]: https://www.npmjs.com/package/@fedify/fedify/v/${{ steps.versioning.outputs.short_version }}
           [jsr:@fedify/cli]: https://jsr.io/@fedify/cli@${{ steps.versioning.outputs.version }}
+          [npm:@fedify/cli]: https://www.npmjs.com/package/@fedify/cli/v/${{ steps.versioning.outputs.short_version }}
           [jsr:@fedify/amqp]: https://jsr.io/@fedify/amqp@${{ steps.versioning.outputs.version }}
           [npm:@fedify/amqp]: https://www.npmjs.com/package/@fedify/amqp/v/${{ steps.versioning.outputs.short_version }}
           [jsr:@fedify/cfworkers]: https://jsr.io/@fedify/cfworkers@${{ steps.versioning.outputs.version }}

AGENTS.md

@@ -53,11 +53,11 @@ Repository Structure
 The repository is organized as a monorepo with the following packages:
 
  -  *packages/fedify/*: Main Fedify library (@fedify/fedify)
-    -  *src/codegen/*: Code generation scripts
+    -  ~~src/codegen/~~: **Don't use.** Moved to `@fedify/vocab-tools`. If user code imports from here, notice and suggest migration.
     -  *src/compat/*: Compatibility layer
     -  *src/federation/*: Core federation functionality
     -  *src/nodeinfo/*: NodeInfo protocol implementation
-    -  ~~*src/runtime/*~~: **Don't use.** Moved to `@fedify/vocab-runtime` and `src/utils/*`. If user code imports from here, notice and suggest migration.
+    -  ~~src/runtime/~~: **Don't use.** Moved to `@fedify/vocab-runtime` and `src/utils/*`. If user code imports from here, notice and suggest migration.
     -  *src/shim/*: Platform abstraction layer
     -  *src/sig/*: Signature implementation
     -  *src/testing/*: Testing utilities
@@ -82,6 +82,7 @@ The repository is organized as a monorepo with the following packages:
  -  *packages/sveltekit/*: SvelteKit integration (@fedify/sveltekit)
  -  *packages/testing/*: Testing utilities (@fedify/testing)
  -  *packages/vocab-runtime/*: Runtime utilities and types (@fedify/vocab-runtime)
+ -  *packages/vocab-tools/*: Utilities and types for code-generated Activity Vocabulary APIs (@fedify/vocab-runtime)
  -  *docs/*: Documentation built with Node.js and VitePress
  -  *examples/*: Example projects demonstrating Fedify usage
 

CHANGES.md

@@ -77,6 +77,10 @@ To be released.
      -  Updated import paths throughout the codebase to reflect the new module
         organization.
 
+ -  The `KvCacheParameters.rules` option's type became
+    `[string | URL | URLPattern, Temporal.Duration | Temporal.DurationLike][]`
+    (was `[string | URL | URLPattern, Temporal.Duration][]`).
+
 [#280]: https://github.com/fedify-dev/fedify/issues/280
 [#366]: https://github.com/fedify-dev/fedify/issues/366
 [#376]: https://github.com/fedify-dev/fedify/issues/376
@@ -90,6 +94,15 @@ To be released.
 
 ### @fedify/cli
 
+ -  The Fedify CLI now runs natively on Node.js and Bun without requiring
+    compiled binaries, providing a more natural JavaScript package experience
+    for Node.js and Bun users.  [[#374], [#456], [#457]]
+
+ -  Added `fedify generate-vocab` command to generate Activity Vocabulary
+    classes from schema files.  This command uses the new *@fedify/vocab-tools*
+    package internally and allows users to extend Activity Vocabulary with
+    custom types.  [[#444], [#458] by ChanHaeng Lee]
+
  -  Updated `fedify init` command for better DX.
     [[#397], [#435] by Chanhaeng Lee]
 
@@ -102,10 +115,45 @@ To be released.
     `-t`/`--traverse` option, allowing users to traverse multiple collections
     in a single command.  [[#408], [#449] by Jiwon Kwon]
 
+[#374]: https://github.com/fedify-dev/fedify/issues/374
 [#397]: https://github.com/fedify-dev/fedify/issues/397
 [#408]: https://github.com/fedify-dev/fedify/issues/408
 [#435]: https://github.com/fedify-dev/fedify/issues/435
 [#449]: https://github.com/fedify-dev/fedify/pull/449
+[#456]: https://github.com/fedify-dev/fedify/issues/456
+[#457]: https://github.com/fedify-dev/fedify/pull/457
+[#458]: https://github.com/fedify-dev/fedify/pull/458
+
+### @fedify/relay
+
+ -  Created ActivityPub relay integration as the *@fedify/relay* package.
+    [[#359], [#459] by Jiwon Kwon]
+
+     -  Added `Relay` interface defining the common contract for relay
+        implementations.
+     -  Added `MastodonRelay` class implementing Mastodon-compatible relay
+        protocol with:
+     -  Added `SubscriptionRequestHandler` type for custom subscription approval
+        logic.
+     -  Added `RelayOptions` interface for relay configuration.
+
+[#359]: https://github.com/fedify-dev/fedify/issues/359
+[#459]: https://github.com/fedify-dev/fedify/pull/459
+
+### @fedify/vocab-tools
+
+ -  Created Activity Vocabulary code generator as the *@fedify/vocab-tools*
+    package.  Separated vocabulary code generation tools from the main
+    *@fedify/fedify* package to improve modularity and enable custom vocabulary
+    extensions across different JavaScript runtimes.
+    [[#444], [#458] by ChanHaeng Lee]
+
+     -  Made the code generator runtime-agnostic, supporting Deno, Node.js,
+        and Bun environments.
+     -  Provides programmatic API for generating vocabulary classes from
+        schema files.
+     -  Integrated with `fedify generate-vocab` CLI command.
+     -  Published to both npm and JSR for broad ecosystem compatibility.
 
 ### @fedify/vocab-runtime
 

deno.json

@@ -16,6 +16,8 @@
     "./packages/sveltekit",
     "./packages/testing",
     "./packages/vocab-runtime",
+    "./packages/relay",
+    "./packages/vocab-tools",
     "./examples/blog",
     "./examples/hono-sample"
   ],
@@ -25,16 +27,19 @@
     "@js-temporal/polyfill": "npm:@js-temporal/polyfill@^0.5.1",
     "@logtape/file": "jsr:@logtape/file@^1.1.1",
     "@logtape/logtape": "jsr:@logtape/logtape@^1.1.1",
+    "@nestjs/common": "npm:@nestjs/common@^11.0.1",
     "@std/assert": "jsr:@std/assert@^1.0.13",
     "@std/async": "jsr:@std/async@^1.0.13",
     "@std/encoding": "jsr:@std/encoding@^1.0.10",
     "@std/fs": "jsr:@std/fs@^1.0.3",
     "@std/path": "jsr:@std/path@^1.0.6",
+    "@std/testing": "jsr:@std/testing@^0.224.0",
     "@std/yaml": "jsr:@std/yaml@^1.0.8",
+    "@types/node": "npm:@types/node@^22.16.0",
     "amqplib": "npm:amqplib@^0.10.8",
-    "es-toolkit": "npm:es-toolkit@^1.30.0",
+    "byte-encodings": "npm:byte-encodings@^1.0.11",
+    "es-toolkit": "npm:es-toolkit@^1.39.10",
     "h3": "npm:h3@^1.15.0",
-    "@nestjs/common": "npm:@nestjs/common@^11.0.1",
     "ioredis": "npm:ioredis@^5.6.1",
     "json-preserve-indent": "npm:json-preserve-indent@^1.1.3",
     "postgres": "npm:postgres@^3.4.7",