@lunora/server 1.0.0-alpha.215 → 1.0.0-alpha.216

package/dist/index.d.mts

@@ -1966,9 +1966,10 @@ interface LivePublishOptions {
   stream: string;
 }
 /**
- * `ctx.live` — publish an arbitrary event to a named topic. The event fans out
- * to the SSE subscribers of `options.stream` on the shard. WebSocket whisper
- * members never receive it (see the live-stream docblock).
+ * `ctx.live` — publish an arbitrary event to a named topic. The event reaches
+ * the SSE subscribers of `options.stream` that followed the topic, and the
+ * WebSocket whisper members that hold a live grant for that stream and topic
+ * (see the live-stream docblock).
  *
  * Reachable from an HTTP-action ctx; an action (a scheduled job) publishes
  * through the same surface in-process (see the live-stream docblock).
@@ -1976,9 +1977,11 @@ interface LivePublishOptions {
 interface LivePublisher {
   /**
    * Publish `payload` to `topic` on `options.stream`. Best-effort — a topic
-   * with no subscribers is a no-op. Rejects when the shard refuses the publish
-   * (an oversized payload, or a room or route topic), so a silent drop is not
-   * possible.
+   * with no subscribers is a no-op. Rejects when the shard refuses the publish:
+   * a `room:` topic (403), a topic over the control-key bound (400), or a
+   * payload over the publish cap (413), so a refused publish is not silently
+   * dropped. On a target that does not serve live streams it rejects with
+   * `LIVE_STREAMS_UNSUPPORTED`.
    */
   publish: (topic: string, payload: unknown, options: LivePublishOptions) => Promise<void>;
 }

package/dist/index.d.ts

@@ -1966,9 +1966,10 @@ interface LivePublishOptions {
   stream: string;
 }
 /**
- * `ctx.live` — publish an arbitrary event to a named topic. The event fans out
- * to the SSE subscribers of `options.stream` on the shard. WebSocket whisper
- * members never receive it (see the live-stream docblock).
+ * `ctx.live` — publish an arbitrary event to a named topic. The event reaches
+ * the SSE subscribers of `options.stream` that followed the topic, and the
+ * WebSocket whisper members that hold a live grant for that stream and topic
+ * (see the live-stream docblock).
  *
  * Reachable from an HTTP-action ctx; an action (a scheduled job) publishes
  * through the same surface in-process (see the live-stream docblock).
@@ -1976,9 +1977,11 @@ interface LivePublishOptions {
 interface LivePublisher {
   /**
    * Publish `payload` to `topic` on `options.stream`. Best-effort — a topic
-   * with no subscribers is a no-op. Rejects when the shard refuses the publish
-   * (an oversized payload, or a room or route topic), so a silent drop is not
-   * possible.
+   * with no subscribers is a no-op. Rejects when the shard refuses the publish:
+   * a `room:` topic (403), a topic over the control-key bound (400), or a
+   * payload over the publish cap (413), so a refused publish is not silently
+   * dropped. On a target that does not serve live streams it rejects with
+   * `LIVE_STREAMS_UNSUPPORTED`.
    */
   publish: (topic: string, payload: unknown, options: LivePublishOptions) => Promise<void>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/server",
-  "version": "1.0.0-alpha.215",
+  "version": "1.0.0-alpha.216",
   "description": "Server primitives for Lunora: defineSchema, defineTable, query, mutation, and action",
   "keywords": [
     "backend",
@@ -71,9 +71,9 @@
   },
   "dependencies": {
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
-    "@lunora/scheduler": "1.0.0-alpha.135",
-    "@lunora/shard-engine": "1.0.0-alpha.138",
-    "@lunora/values": "1.0.0-alpha.70",
+    "@lunora/scheduler": "1.0.0-alpha.136",
+    "@lunora/shard-engine": "1.0.0-alpha.139",
+    "@lunora/values": "1.0.0-alpha.71",
     "@lunora/wire": "1.0.0-alpha.1",
     "drizzle-orm": "^0.45.3",
     "hono": "^4.13.13"