@fedify/fedify 2.5.0-dev.2504 → 2.5.0-dev.2516

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/fedify",
-  "version": "2.5.0-dev.2504+fdeb138d",
+  "version": "2.5.0-dev.2516+42d3ed0b",
   "description": "An ActivityPub server framework",
   "keywords": [
     "ActivityPub",
@@ -151,14 +151,13 @@
     "structured-field-values": "^2.0.4",
     "temporal-polyfill": "^1.0.1",
     "urlpattern-polyfill": "^10.1.0",
-    "@fedify/uri-template": "2.5.0-dev.2504+fdeb138d",
-    "@fedify/vocab": "2.5.0-dev.2504+fdeb138d",
-    "@fedify/vocab-runtime": "2.5.0-dev.2504+fdeb138d",
-    "@fedify/webfinger": "2.5.0-dev.2504+fdeb138d"
+    "@fedify/uri-template": "2.5.0-dev.2516+42d3ed0b",
+    "@fedify/vocab-runtime": "2.5.0-dev.2516+42d3ed0b",
+    "@fedify/webfinger": "2.5.0-dev.2516+42d3ed0b",
+    "@fedify/vocab": "2.5.0-dev.2516+42d3ed0b"
   },
   "devDependencies": {
     "@std/assert": "npm:@jsr/std__assert@^0.226.0",
-    "@std/path": "npm:@jsr/std__path@^1.0.6",
     "@types/node": "^24.12.2",
     "fetch-mock": "^12.5.4",
     "miniflare": "^4.20250523.0",
@@ -167,7 +166,7 @@
     "typescript": "^6.0.0",
     "wrangler": "^4.17.0",
     "@fedify/fixture": "2.0.0",
-    "@fedify/vocab-tools": "^2.5.0-dev.2504+fdeb138d"
+    "@fedify/vocab-tools": "^2.5.0-dev.2516+42d3ed0b"
   },
   "scripts": {
     "build:self": "tsdown",

package/skills/fedify/SKILL.md

@@ -265,6 +265,18 @@ in-tree *src/webfinger*.
 
 `fromJsonLd()` and `toJsonLd()` are asynchronous; always `await` them.
 
+`clone()` is shallow: it copies property arrays but shares nested vocabulary
+objects and URLs.  In Fedify 2.5.0 and later, use synchronous `deepClone()` to
+resolve nested properties without hydrating the source's objects.  Replacement
+values are copied too.  Each copied node keeps its own default loaders and
+verifier; second-argument options override only the root.  The copy drops cached
+JSON-LD and retained signed representations, so retain the received document
+when its exact representation matters and sign copies again when needed.
+Keep property arrays stable during copying, including inside custom `clone()`
+overrides: `deepClone()` snapshots the existing indices of large sparse arrays.
+Entries added during copying are not visited, so their nested objects may
+remain shared.  Copying preserves array length and holes.
+
 > [!WARNING]
 > `crossOrigin: "trust"` on vocabulary deserialization trusts embedded
 > objects without re-fetching.  Treat it as you would
@@ -311,6 +323,12 @@ in development or tests.
 | *@fedify/denokv*    | yes       | yes            |
 | *@fedify/cfworkers* | yes       | yes            |
 
+For `PostgresKvStore`, existing populated tables and externally managed DDL
+(`initialized: true`) need the [expiry expression index] to accelerate cleanup.
+Run concurrent index creation outside a transaction, followed by `ANALYZE`.
+The migration can precede an application upgrade; old writers maintain the
+index too.  Keep the original TTL columns and calendar semantics.
+
 > [!WARNING]
 > `PostgresMessageQueue` and similar implementations require connection
 > pooling sized for parallel consumers; a single shared connection will
@@ -324,6 +342,8 @@ in development or tests.
 
 See <https://fedify.dev/manual/kv.md> and <https://fedify.dev/manual/mq.md>.
 
+[expiry expression index]: https://fedify.dev/manual/kv.md#postgresql-expiry-index
+
 
 Observability
 -------------