@lunora/queue 1.0.0-alpha.115 → 1.0.0-alpha.116

package/dist/index.d.mts

@@ -97,8 +97,8 @@ interface QueueRunContext {
   /** The worker `env` (bindings + vars). */
   readonly env: Record<string, unknown>;
   /**
-   * `ctx.live.publish` — push an event to the SSE subscribers of a
-   * `defineLiveStream` on the shard the publish names. Present only when the
+   * `ctx.live.publish(ref, payload)` — push an event to the SSE subscribers of the
+   * `defineLiveStream` that declares `ref`'s topic, on the shard the publish names. Present only when the
    * runtime hands the consumer a publisher (an app that declares a live stream on
    * a target that serves one); absent otherwise. A consumer runs in the Worker, so
    * the publish is forwarded to the shard rather than made in-process.
@@ -120,11 +120,20 @@ interface QueueRunContext {
  * builds it without importing this package. See {@link QueueRunContext.live}.
  */
 interface QueueLivePublisher {
-  publish: (topic: string, payload: unknown, options: {
+  publish: <Payload>(topic: QueueLiveTopicRef<Payload>, payload: NoInfer<Payload>, options?: {
     shardKey?: string;
-    stream: string;
   }) => Promise<void>;
 }
+/**
+ * A reference to one declared live topic, as `_generated/live.ts` hands it out.
+ * Structural, so this package needs neither the server nor the client: the phantom
+ * `Payload` is what types the event.
+ */
+interface QueueLiveTopicRef<Payload = unknown> {
+  readonly __lunoraLive: string;
+  readonly __payload?: Payload;
+  readonly topic: string;
+}
 /**
  * One delivered message as the push handler sees it: the Cloudflare `Message`
  * plus `run` — a {@link QueueRunContext.run} pinned to THIS message.

package/dist/index.d.ts

@@ -97,8 +97,8 @@ interface QueueRunContext {
   /** The worker `env` (bindings + vars). */
   readonly env: Record<string, unknown>;
   /**
-   * `ctx.live.publish` — push an event to the SSE subscribers of a
-   * `defineLiveStream` on the shard the publish names. Present only when the
+   * `ctx.live.publish(ref, payload)` — push an event to the SSE subscribers of the
+   * `defineLiveStream` that declares `ref`'s topic, on the shard the publish names. Present only when the
    * runtime hands the consumer a publisher (an app that declares a live stream on
    * a target that serves one); absent otherwise. A consumer runs in the Worker, so
    * the publish is forwarded to the shard rather than made in-process.
@@ -120,11 +120,20 @@ interface QueueRunContext {
  * builds it without importing this package. See {@link QueueRunContext.live}.
  */
 interface QueueLivePublisher {
-  publish: (topic: string, payload: unknown, options: {
+  publish: <Payload>(topic: QueueLiveTopicRef<Payload>, payload: NoInfer<Payload>, options?: {
     shardKey?: string;
-    stream: string;
   }) => Promise<void>;
 }
+/**
+ * A reference to one declared live topic, as `_generated/live.ts` hands it out.
+ * Structural, so this package needs neither the server nor the client: the phantom
+ * `Payload` is what types the event.
+ */
+interface QueueLiveTopicRef<Payload = unknown> {
+  readonly __lunoraLive: string;
+  readonly __payload?: Payload;
+  readonly topic: string;
+}
 /**
  * One delivered message as the push handler sees it: the Cloudflare `Message`
  * plus `run` — a {@link QueueRunContext.run} pinned to THIS message.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/queue",
-  "version": "1.0.0-alpha.115",
+  "version": "1.0.0-alpha.116",
   "description": "Cloudflare Queues for Lunora: defineQueue producers + consumers, the ctx.queues surface, and the generated queue() worker handler",
   "keywords": [
     "background-jobs",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@lunora/errors": ">=1.0.0-alpha.51 <2.0.0-0",
-    "@lunora/platform": "1.0.0-alpha.69",
+    "@lunora/platform": "1.0.0-alpha.70",
     "@lunora/wire": "1.0.0-alpha.1"
   },
   "engines": {