@rakun-kit/core 1.7.1 → 1.7.2

package/README.md

@@ -90,16 +90,16 @@ rakunBootstrap({
 })
 ```
 
-The default image processor is native `Bun.Image` when available and `sharp`
-otherwise. Node.js image optimization therefore requires the optional `sharp`
-peer. Bun also falls back to it when an OS-dependent codec cannot handle the
-requested format. Custom `ImageProcessor` implementations provide
-`metadata`, `transform`, and `placeholder`; the latter returns an inline
-`{ dataUrl, mime }` LQIP. Bun uses native `Bun.Image.placeholder()`, while
-Sharp produces the placeholder through its normal reduced transform and serves
-as the fallback when the Bun method is unavailable. The
-platform resolves crypto, filesystem, compression,
-workers, and realtime capabilities. Polling is the safe realtime default when
+The default image processor is native `Bun.Image` when available and `sharp`
+otherwise. Node.js image optimization therefore requires the optional `sharp`
+peer. Bun also falls back to it when an OS-dependent codec cannot handle the
+requested format. Custom `ImageProcessor` implementations provide
+`metadata`, `transform`, and `placeholder`; the latter returns an inline
+`{ dataUrl, mime }` LQIP. Bun uses native `Bun.Image.placeholder()`, while
+Sharp produces the placeholder through its normal reduced transform and serves
+as the fallback when the Bun method is unavailable. The
+platform resolves crypto, filesystem, compression,
+workers, and realtime capabilities. Polling is the safe realtime default when
 the host cannot keep persistent connections open. The Next and Express
 adapters automatically serve configured SSE streams.
 Calling `sseRealtime()` uses the API-relative `/realtime` endpoint; pass an
@@ -127,12 +127,12 @@ keyed by its content type and `_id`. Editor updates synchronize through the
 authenticated `manager.contentCollaboration.sync` operation without changing
 the MongoDB content snapshot or triggering revalidation. Save calls
 `manager.contentCollaboration.save`, which materializes and validates the
-server-side CRDT state before using the normal update and revalidation flow.
-Draft promotion remains separate and promotes only a saved draft snapshot.
-`manager.contentCollaboration.discard` restores the room from that persisted
-snapshot, publishes the reset to connected editors, and marks the restored Yjs
-state as saved without creating a new content revision. Shared templates expose
-the equivalent `manager.templateCollaboration.discard` operation.
+server-side CRDT state before using the normal update and revalidation flow.
+Draft promotion remains separate and promotes only a saved draft snapshot.
+`manager.contentCollaboration.discard` restores the room from that persisted
+snapshot, publishes the reset to connected editors, and marks the restored Yjs
+state as saved without creating a new content revision. Shared templates expose
+the equivalent `manager.templateCollaboration.discard` operation.
 
 The default adapter keeps working documents in process memory. Configure a
 shared, durable implementation for replicated or restart-durable deployments:
@@ -142,33 +142,33 @@ rakunBootstrap({
   // ...
   collaboration: {
     adapter: {
-      load: async (roomId) => loadRoom(roomId),
-      save: async (roomId, state) => saveRoom(roomId, state),
-      loadPresence: async (roomId) => loadRoomPresence(roomId),
-      savePresence: async (roomId, presence) => saveRoomPresence(roomId, presence),
-      delete: async (roomId) => deleteRoom(roomId),
+      load: async (roomId) => loadRoom(roomId),
+      save: async (roomId, state) => saveRoom(roomId, state),
+      loadPresence: async (roomId) => loadRoomPresence(roomId),
+      savePresence: async (roomId, presence) => saveRoomPresence(roomId, presence),
+      delete: async (roomId) => deleteRoom(roomId),
     },
   },
 })
 ```
 
 `state.update` and `state.savedStateVector` are opaque `Uint8Array` values.
-Store them outside the public content record. The built-in manager applies this
+Store them outside the public content record. The built-in manager applies this
 to saved content edit screens and to each content type's shared Template.
 Templates use their own `template:<contentType>` room rather than an individual
 document room. Settings, route-layout overrides, and other administrative forms
 remain local. Translation changes join the working document and are persisted
-only by Save.
-
-The sync response also includes ephemeral viewers keyed by browser-tab client
-id, including the focused field. Presence expires automatically and is not
-part of `state.update`, `state.savedStateVector`, or the persistent event log.
-With SSE, the authenticated subscription owns the tab presence: server
-heartbeats renew it and closing the last stream for that tab removes it, so the
-manager does not send a periodic collaboration sync request just to stay
-visible. Polling refreshes presence through its normal sync cycle.
-`loadPresence` and `savePresence` are optional; implement both in replicated
-deployments that need presence shared across processes.
+only by Save.
+
+The sync response also includes ephemeral viewers keyed by browser-tab client
+id, including the focused field. Presence expires automatically and is not
+part of `state.update`, `state.savedStateVector`, or the persistent event log.
+With SSE, the authenticated subscription owns the tab presence: server
+heartbeats renew it and closing the last stream for that tab removes it, so the
+manager does not send a periodic collaboration sync request just to stay
+visible. Polling refreshes presence through its normal sync cycle.
+`loadPresence` and `savePresence` are optional; implement both in replicated
+deployments that need presence shared across processes.
 
 `@rakun-kit/manager-react` additionally stores these Yjs rooms per user in
 IndexedDB, allowing cached content and Template fields to remain editable during
@@ -1153,15 +1153,15 @@ APIs:
 - `getMediaService()`: returns the singleton or creates it from config.
 - `handleMediaBinaryUpload`: processes manager binary uploads.
 
-The service supports prepare/finalize upload, URL generation, folders, and media optimization depending on adapter/configuration. Manager uploads encode original file names for transport, so Unicode names (including accents, non-Latin scripts, and emoji) are preserved without placing invalid characters in HTTP headers.
-
-Adapters can implement `getPublicObject` to let every Rakun server adapter proxy
-public media at its normal `/media/public/<key>` API route. This keeps browser
-URLs stable even when the object store is private or only supports expiring
-presigned URLs. The core handler validates the key under `public/`, forwards
-byte ranges, preserves object metadata, and applies long-lived caching by
-default. The storage adapter receives server-side credentials; never expose its
-presigned storage URL as the public media URL.
+The service supports prepare/finalize upload, URL generation, folders, and media optimization depending on adapter/configuration. Manager uploads encode original file names for transport, so Unicode names (including accents, non-Latin scripts, and emoji) are preserved without placing invalid characters in HTTP headers.
+
+Adapters can implement `getPublicObject` to let every Rakun server adapter proxy
+public media at its normal `/media/<key>` API route. This keeps browser
+URLs stable even when the object store is private or only supports expiring
+presigned URLs. The core handler validates the key under `public/`, forwards
+byte ranges, preserves object metadata, and applies long-lived caching by
+default. The storage adapter receives server-side credentials; never expose its
+presigned storage URL as the public media URL.
 
 Optimized video uploads use the `ffmpeg-static` peer dependency and produce an MP4 primary object plus MP4 and WebM entries in `sources`. Existing image-only optimize options remain compatible; use `video: { quality: 80 }` to configure video quality explicitly.
 

package/dist/docs/index.md

@@ -475,12 +475,12 @@ blocking. Account recovery requires both a mail service and
 
 Core defines service contracts; concrete integrations are separate:
 
-- Media: use `@rakun-kit/s3`, or local media from the selected framework
-  adapter. Configure the result as `media` in bootstrap.
-- Storage adapters may expose `getPublicObject`; Next.js, Express and Bun then
-  serve public media through their normal `/media/public/<key>` API route. This
-  gives public Rakun media a stable application URL while the backing object
-  store remains private or uses expiring storage URLs.
+- Media: use `@rakun-kit/s3`, or local media from the selected framework
+  adapter. Configure the result as `media` in bootstrap.
+- Storage adapters may expose `getPublicObject`; Next.js, Express and Bun then
+  serve public media through their normal `/media/<key>` API route. This
+  gives public Rakun media a stable application URL while the backing object
+  store remains private or uses expiring storage URLs.
 - Mail: use `@rakun-kit/smtp` or `@rakun-kit/resend`; optionally render typed
   templates with `@rakun-kit/jsx-email`. Configure delivery as `mail`.
 - Translation: use `@rakun-kit/openai` or implement the core translation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rakun-kit/core",
-  "version": "1.7.1",
+  "version": "1.7.2",
   "description": "Core Rakun content, routing, media, mail, auth, and manager APIs.",
   "license": "MIT",
   "author": {