hotpipe 0.1.0 → 0.2.0

package/README.md

@@ -0,0 +1,390 @@
+# hotpipe
+
+Type-safe real-time events for React and Next.js. Define your events with Zod, subscribe with React hooks, publish from client or server. Clients connect directly to the hotpipe API over WebSocket — your Next.js server is never in the hot path.
+
+## Install
+
+```bash
+npm install hotpipe
+```
+
+Peer dependencies: `react` (>=18), `zod` (>=3).
+
+## Quick start
+
+### 1. Create the route handler
+
+Hotpipe uses your existing auth — check the session however you normally do. The `authorize` function runs on every connection attempt. Return `null` to deny access, or return the user's ID and pipe permissions to grant it. We'll cover pipe permissions in detail after the usage examples.
+
+```ts
+// app/api/realtime/[...all]/route.ts
+import { createPipeHandler } from 'hotpipe/server';
+
+export const { POST } = createPipeHandler({
+  secret: process.env.HOTPIPE_SECRET!,
+  authorize: async (req) => {
+    const { session } = await getAuth(req); // your auth
+    if (!session) return null;
+
+    return {
+      userId: session.userId,
+      pipes: {}, // we'll configure these in the permissions section
+    };
+  },
+});
+```
+
+### 2. Define your events
+
+This is your single source of truth for event types across client and server.
+
+```ts
+// lib/realtime-events.ts
+import { z } from 'zod';
+
+export const realtimeEvents = {
+  'message.created': z.object({
+    id: z.string(),
+    text: z.string(),
+    userId: z.string(),
+    createdAt: z.number(),
+  }),
+  'message.deleted': z.object({
+    id: z.string(),
+  }),
+  'typing.start': z.object({
+    userId: z.string(),
+  }),
+} as const;
+```
+
+### 3. Create the client
+
+```ts
+// lib/realtime-client.ts
+import { createPipeClient } from 'hotpipe/client';
+
+import { realtimeEvents } from './realtime-events';
+
+export const { PipeProvider, usePipe } = createPipeClient({
+  events: realtimeEvents,
+});
+```
+
+This assumes your auth uses cookies (the default for most frameworks like Better Auth, NextAuth, and Clerk). If you're using bearer tokens instead, pass an `authHeaders` function:
+
+```ts
+export const { PipeProvider, usePipe } = createPipeClient({
+  events: realtimeEvents,
+  authHeaders: async () => ({
+    Authorization: `Bearer ${getAccessToken()}`,
+  }),
+});
+```
+
+### 4. Add the provider
+
+Wrap your app with `PipeProvider`. This connects everything — your frontend, your backend, and the hotpipe API.
+
+```tsx
+// app/layout.tsx
+import { PipeProvider } from '@/lib/realtime-client';
+
+export default function Layout({ children }: { children: React.ReactNode }) {
+  return <PipeProvider>{children}</PipeProvider>;
+}
+```
+
+### 5. Create the server publisher
+
+You can also publish events from server actions, route handlers, and even background jobs. No limits.
+
+```ts
+// lib/realtime-server.ts
+import { createPipePublisher } from 'hotpipe/server';
+
+import { realtimeEvents } from './realtime-events';
+
+export const realtime = createPipePublisher({
+  secret: process.env.HOTPIPE_SECRET!,
+  events: realtimeEvents,
+});
+```
+
+## Usage
+
+Let's build a team chat. Users type messages, and everyone on the team sees them instantly.
+
+### Listening for new messages
+
+When someone sends a message, every connected user should see it appear. We exported a `usePipe` hook in step 3. This is where you'll use it.
+
+The first argument to `usePipe` is the pipe name — it's just a string, and you can name it anything you want. We're calling this one `"team-chat"` because it's a shared space where everyone on the team sees every message. The second argument is an object of event handlers. When a `message.created` event comes in, our handler runs. The data is fully typed based on the schema you defined in step 2.
+
+```tsx
+import { usePipe } from '@/lib/realtime-client';
+
+function Messages() {
+  const [messages, setMessages] = useState([]);
+
+  usePipe('team-chat', {
+    'message.created': (data) => {
+      setMessages((prev) => [...prev, data]);
+    },
+  });
+
+  return (
+    <ul>
+      {messages.map((msg) => (
+        <li key={msg.id}>{msg.text}</li>
+      ))}
+    </ul>
+  );
+}
+```
+
+A few other pipe names to get your wheels turning:
+
+- `"game-lobby-abc"` — real-time multiplayer game state
+- `"player-xyz"` — events targeting a specific player
+- `"org-acme"` — updates scoped to a whole organization
+- `"doc-789"` — collaborative editing on a shared document
+- `"auction-42"` — live bid updates on a specific item
+
+The name is up to you. Whatever makes sense for your app.
+
+### Sending a message from the browser
+
+The same `usePipe` hook also gives you a `publish` function. When a user hits send, the event goes out to everyone listening on that pipe.
+
+Hotpipe doesn't store anything — it's purely real-time delivery. You save data however you normally do (server actions, API calls, etc.) and publish the event alongside it.
+
+```tsx
+function MessageInput() {
+  const [text, setText] = useState('');
+  const { publish } = usePipe('team-chat');
+
+  async function send() {
+    // save to your database first
+    const message = await createMessage({ text, userId: currentUser.id });
+
+    // then broadcast it to everyone in real time
+    publish('message.created', {
+      id: message.id,
+      text: message.text,
+      userId: message.userId,
+      createdAt: message.createdAt,
+    });
+
+    setText('');
+  }
+
+  return (
+    <form
+      onSubmit={(e) => {
+        e.preventDefault();
+        send();
+      }}
+    >
+      <input value={text} onChange={(e) => setText(e.target.value)} />
+      <button type="submit">Send</button>
+    </form>
+  );
+}
+```
+
+### Sending events from the server
+
+Same idea on the server. Maybe you're already saving data in a server action or handling a webhook — just publish the event after. Everyone listening on that pipe gets it instantly.
+
+```ts
+import { realtime } from '@/lib/realtime-server';
+
+// save to your database
+const message = await db.messages.create({ text, userId });
+
+// broadcast to connected users
+const teamChat = realtime.pipe('team-chat');
+
+await teamChat.publish('message.created', {
+  id: message.id,
+  text: message.text,
+  userId: message.userId,
+  createdAt: message.createdAt,
+});
+```
+
+### Connection status
+
+You can check whether the user is connected to the hotpipe API at any time.
+
+```tsx
+const { status } = usePipe('team-chat');
+// 'connecting' | 'connected' | 'disconnected' | 'reconnecting'
+```
+
+Hotpipe automatically reconnects if the connection drops.
+
+## Pipes and permissions
+
+Now that you've seen how pipes work in practice, let's go back to the `authorize` function from step 1 and talk about access control.
+
+Every user who connects gets a set of pipe permissions. You define these in the object returned by `authorize`. Each pipe can grant two abilities: `subscribe` (receive events) and `publish` (send events).
+
+### Team chat — everyone can read and write
+
+In the chat example above, every team member should be able to send and receive messages. Give everyone both permissions on the `team-chat` pipe:
+
+```ts
+authorize: async (req) => {
+  const { session } = await getAuth(req);
+  if (!session) return null;
+
+  return {
+    userId: session.userId,
+    pipes: {
+      'team-chat': { subscribe: true, publish: true },
+    },
+  };
+},
+```
+
+### User-specific pipes — scoped to a single user
+
+Sometimes you need to send events to a specific user — a notification, a status update, something only they should see. Use a dynamic pipe name with their user ID:
+
+```ts
+return {
+  userId: session.userId,
+  pipes: {
+    [`user-${session.userId}`]: { subscribe: true },
+  },
+};
+```
+
+Now your server can publish to `user-abc123` and only that user receives it. Other users can't subscribe to someone else's pipe because it's not in their permissions.
+
+### Read-only pipes — broadcast without client publish
+
+For things like live dashboards, announcements, or system alerts, you might want users to receive events but not send them. Only grant `subscribe`:
+
+```ts
+return {
+  userId: session.userId,
+  pipes: {
+    announcements: { subscribe: true },
+  },
+};
+```
+
+The server can publish to `announcements` anytime. Clients can listen but can't push events to this pipe.
+
+### Combining pipes — a real-world example
+
+Most apps need a mix. Here's what a team collaboration app might look like:
+
+```ts
+authorize: async (req) => {
+  const { session } = await getAuth(req);
+  if (!session) return null;
+
+  const teamId = await getTeamId(session.userId);
+
+  return {
+    userId: session.userId,
+    pipes: {
+      [`team-${teamId}`]: { subscribe: true, publish: true },
+      [`user-${session.userId}`]: { subscribe: true },
+      'announcements': { subscribe: true },
+    },
+  };
+},
+```
+
+Three pipes, three different access patterns:
+
+- **`team-abc`** — everyone on the team can send and receive (chat, typing indicators, live cursors)
+- **`user-xyz`** — only this user receives (notifications, direct messages from the server)
+- **`announcements`** — all users receive, only the server publishes (maintenance alerts, feature launches)
+
+If a user tries to subscribe or publish to a pipe that isn't in their permissions, the API ignores the request.
+
+## Environment variables
+
+| Variable         | Where  | Description                                           |
+| ---------------- | ------ | ----------------------------------------------------- |
+| `HOTPIPE_SECRET` | Server | Shared secret for auth tokens and server-side publish |
+
+## How it works
+
+1. User loads your app
+2. `PipeProvider` calls your handler to get an auth token
+3. Your handler checks the session and signs a JWT with pipe permissions
+4. The client opens a WebSocket directly to the hotpipe API
+5. Events flow between clients and server through the hotpipe API
+6. Your Next.js server is out of the loop — no long-lived connections, no Vercel cost impact
+
+The hotpipe API is stateless. It handles connection management and event fan-out. Your database is the source of truth — the API doesn't persist anything.
+
+## API reference
+
+### `hotpipe/client`
+
+#### `createPipeClient(config)`
+
+Returns `{ PipeProvider, usePipe }`.
+
+| Option        | Type                                    | Required | Description                                                 |
+| ------------- | --------------------------------------- | -------- | ----------------------------------------------------------- |
+| `events`      | `Record<string, ZodType>`               | Yes      | Zod schemas for your events                                 |
+| `basePath`    | `string`                                | No       | Where your handler is mounted (defaults to `/api/realtime`) |
+| `authHeaders` | `() => Promise<Record<string, string>>` | No       | Custom headers for the auth request (e.g., bearer tokens)   |
+
+#### `PipeProvider`
+
+Wrap your app (or a subtree) to establish the WebSocket connection to the hotpipe API. Connects on mount, disconnects on unmount.
+
+#### `usePipe(pipe, handlers?)`
+
+Subscribe to events on a pipe.
+
+| Argument   | Type                                       | Description                                          |
+| ---------- | ------------------------------------------ | ---------------------------------------------------- |
+| `pipe`     | `string`                                   | The pipe name to subscribe to                        |
+| `handlers` | `{ [event]: (data) => void }` _(optional)_ | Event handlers, keyed by event name from your schema |
+
+Returns `{ status, publish }`:
+
+- **`status`** — Reactive connection state: `'connecting'`, `'connected'`, `'disconnected'`, or `'reconnecting'`. Updates automatically and triggers a re-render on change.
+- **`publish(event, data)`** — Send a typed event to everyone on this pipe. Data is validated against your Zod schema before sending. Returns `true` if the event was sent or queued for delivery, `false` if the queue is full. Throws if the data fails validation. If the connection is temporarily down, events are buffered and flushed automatically when the connection comes back (up to 100 events, within 30 seconds).
+
+The hook automatically subscribes when the component mounts and unsubscribes when it unmounts. If multiple components subscribe to the same pipe, hotpipe ref-counts them — the subscription stays active until the last component unmounts.
+
+### `hotpipe/server`
+
+#### `createPipeHandler(config)`
+
+Returns `{ POST }` for your catch-all route handler.
+
+| Option        | Type                                            | Required | Description                               |
+| ------------- | ----------------------------------------------- | -------- | ----------------------------------------- |
+| `secret`      | `string`                                        | Yes      | Shared signing secret                     |
+| `authorize`   | `(req: Request) => Promise<AuthResult \| null>` | Yes      | Your auth logic                           |
+| `tokenExpiry` | `number`                                        | No       | Token lifetime in seconds (default: 3600) |
+
+#### `createPipePublisher(config)`
+
+Returns `{ pipe }`.
+
+| Option   | Type                      | Required | Description                 |
+| -------- | ------------------------- | -------- | --------------------------- |
+| `secret` | `string`                  | Yes      | Your hotpipe secret         |
+| `events` | `Record<string, ZodType>` | Yes      | Zod schemas for your events |
+
+#### `publisher.pipe(name)`
+
+Returns `{ publish }` for server-side event publishing. Unlike the client-side `publish`, this is async — it makes an HTTP request to the hotpipe API and will throw if the request fails.
+
+## License
+
+MIT

package/dist/client/connection.d.ts

@@ -1,31 +1,34 @@
 export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'reconnecting';
-export type ChannelListener = (event: string, data: unknown) => void;
+export type PipeListener = (event: string, data: unknown) => void;
 interface ConnectionConfig {
     brokerUrl: string;
     authEndpoint: string;
+    authHeaders?: () => Promise<Record<string, string>>;
 }
 export declare class ConnectionManager {
     private config;
     private ws;
     private status;
     private statusListeners;
-    private channelListeners;
-    private channelRefs;
+    private pipeListeners;
+    private pipeRefs;
     private reconnectAttempts;
     private maxReconnectDelay;
     private pingInterval;
     private reconnectTimer;
     private intentionalClose;
+    private eventQueue;
     constructor(config: ConnectionConfig);
     connect(): Promise<void>;
     disconnect(): void;
-    subscribe(channel: string): void;
-    unsubscribe(channel: string): void;
-    publish(channel: string, event: string, data: unknown): void;
-    addChannelListener(channel: string, listener: ChannelListener): void;
-    removeChannelListener(channel: string, listener: ChannelListener): void;
+    subscribe(pipe: string): void;
+    unsubscribe(pipe: string): void;
+    publish(pipe: string, event: string, data: unknown): boolean;
+    addPipeListener(pipe: string, listener: PipeListener): void;
+    removePipeListener(pipe: string, listener: PipeListener): void;
     getStatus(): ConnectionStatus;
     onStatusChange(listener: (status: ConnectionStatus) => void): () => void;
+    private flushQueue;
     private dispatch;
     private setStatus;
     private wsSend;

package/dist/client/connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/client/connection.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE5F,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAErE,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,iBAAiB;IAYhB,OAAO,CAAC,MAAM;IAX1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,gBAAgB,CAA2C;IACnE,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAS;gBAEb,MAAM,EAAE,gBAAgB;IAEtC,OAAO;IAqEb,UAAU;IAcV,SAAS,CAAC,OAAO,EAAE,MAAM;IASzB,WAAW,CAAC,OAAO,EAAE,MAAM;IAc3B,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;IAMrD,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe;IAQ7D,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe;IAQhE,SAAS,IAAI,gBAAgB;IAI7B,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKxE,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,iBAAiB;CAW1B"}
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/client/connection.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,YAAY,GAAG,WAAW,GAAG,cAAc,CAAC;AAE5F,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAElE,UAAU,gBAAgB;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAYD,qBAAa,iBAAiB;IAahB,OAAO,CAAC,MAAM;IAZ1B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAoC;IAClD,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAU;IACnC,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,UAAU,CAAqB;gBAEnB,MAAM,EAAE,gBAAgB;IAEtC,OAAO;IA2Eb,UAAU;IAeV,SAAS,CAAC,IAAI,EAAE,MAAM;IAStB,WAAW,CAAC,IAAI,EAAE,MAAM;IAcxB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO;IAkB5D,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY;IAQpD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY;IAQvD,SAAS,IAAI,gBAAgB;IAI7B,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,MAAM,IAAI;IAKxE,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,OAAO;IAOf,OAAO,CAAC,iBAAiB;CAW1B"}

package/dist/client/connection.js

@@ -1,15 +1,19 @@
+import { SDK_VERSION } from '../version';
+const MAX_QUEUE_SIZE = 100;
+const QUEUE_TTL = 30_000;
 export class ConnectionManager {
     config;
     ws = null;
     status = 'disconnected';
     statusListeners = new Set();
-    channelListeners = new Map();
-    channelRefs = new Map();
+    pipeListeners = new Map();
+    pipeRefs = new Map();
     reconnectAttempts = 0;
     maxReconnectDelay = 30_000;
     pingInterval = null;
     reconnectTimer = null;
     intentionalClose = false;
+    eventQueue = [];
     constructor(config) {
         this.config = config;
     }
@@ -19,23 +23,27 @@ export class ConnectionManager {
         this.intentionalClose = false;
         this.setStatus(this.reconnectAttempts > 0 ? 'reconnecting' : 'connecting');
         try {
+            const headers = this.config.authHeaders ? await this.config.authHeaders() : undefined;
             const res = await fetch(this.config.authEndpoint, {
                 method: 'POST',
                 credentials: 'include',
+                headers,
             });
             if (!res.ok) {
                 throw new Error(`Auth failed: ${res.status}`);
             }
             const { token } = await res.json();
-            const wsUrl = `${this.config.brokerUrl}/ws?token=${encodeURIComponent(token)}`;
+            const wsUrl = `${this.config.brokerUrl}/ws?token=${encodeURIComponent(token)}&v=${SDK_VERSION}`;
             this.ws = new WebSocket(wsUrl);
             this.ws.onopen = () => {
                 this.setStatus('connected');
                 this.reconnectAttempts = 0;
-                // Resubscribe to all active channels
-                for (const channel of this.channelRefs.keys()) {
-                    this.wsSend({ type: 'subscribe', channel });
+                // Resubscribe to all active pipes
+                for (const pipe of this.pipeRefs.keys()) {
+                    this.wsSend({ type: 'subscribe', pipe });
                 }
+                // Flush queued events
+                this.flushQueue();
                 // Keepalive ping every 30s
                 this.pingInterval = setInterval(() => {
                     this.wsSend({ type: 'ping' });
@@ -45,7 +53,7 @@ export class ConnectionManager {
                 try {
                     const msg = JSON.parse(event.data);
                     if (msg.type === 'event') {
-                        this.dispatch(msg.channel, msg.event, msg.data);
+                        this.dispatch(msg.pipe, msg.event, msg.data);
                     }
                 }
                 catch {
@@ -79,42 +87,52 @@ export class ConnectionManager {
         }
         this.ws?.close();
         this.ws = null;
+        this.eventQueue = [];
         this.setStatus('disconnected');
     }
-    subscribe(channel) {
-        const count = this.channelRefs.get(channel) || 0;
-        this.channelRefs.set(channel, count + 1);
+    subscribe(pipe) {
+        const count = this.pipeRefs.get(pipe) || 0;
+        this.pipeRefs.set(pipe, count + 1);
         if (count === 0 && this.ws?.readyState === WebSocket.OPEN) {
-            this.wsSend({ type: 'subscribe', channel });
+            this.wsSend({ type: 'subscribe', pipe });
         }
     }
-    unsubscribe(channel) {
-        const count = this.channelRefs.get(channel) || 0;
+    unsubscribe(pipe) {
+        const count = this.pipeRefs.get(pipe) || 0;
         if (count <= 1) {
-            this.channelRefs.delete(channel);
+            this.pipeRefs.delete(pipe);
             if (this.ws?.readyState === WebSocket.OPEN) {
-                this.wsSend({ type: 'unsubscribe', channel });
+                this.wsSend({ type: 'unsubscribe', pipe });
             }
         }
         else {
-            this.channelRefs.set(channel, count - 1);
+            this.pipeRefs.set(pipe, count - 1);
         }
     }
-    publish(channel, event, data) {
+    publish(pipe, event, data) {
         if (this.ws?.readyState === WebSocket.OPEN) {
-            this.wsSend({ type: 'publish', channel, event, data });
+            this.wsSend({ type: 'publish', pipe, event, data });
+            return true;
         }
+        if (this.intentionalClose) {
+            return false;
+        }
+        if (this.eventQueue.length >= MAX_QUEUE_SIZE) {
+            return false;
+        }
+        this.eventQueue.push({ pipe, event, data, timestamp: Date.now() });
+        return true;
     }
-    addChannelListener(channel, listener) {
-        if (!this.channelListeners.has(channel)) {
-            this.channelListeners.set(channel, new Set());
+    addPipeListener(pipe, listener) {
+        if (!this.pipeListeners.has(pipe)) {
+            this.pipeListeners.set(pipe, new Set());
         }
-        this.channelListeners.get(channel).add(listener);
+        this.pipeListeners.get(pipe).add(listener);
     }
-    removeChannelListener(channel, listener) {
-        this.channelListeners.get(channel)?.delete(listener);
-        if (this.channelListeners.get(channel)?.size === 0) {
-            this.channelListeners.delete(channel);
+    removePipeListener(pipe, listener) {
+        this.pipeListeners.get(pipe)?.delete(listener);
+        if (this.pipeListeners.get(pipe)?.size === 0) {
+            this.pipeListeners.delete(pipe);
         }
     }
     getStatus() {
@@ -124,8 +142,16 @@ export class ConnectionManager {
         this.statusListeners.add(listener);
         return () => this.statusListeners.delete(listener);
     }
-    dispatch(channel, event, data) {
-        const listeners = this.channelListeners.get(channel);
+    flushQueue() {
+        const now = Date.now();
+        const pending = this.eventQueue.filter((e) => now - e.timestamp < QUEUE_TTL);
+        this.eventQueue = [];
+        for (const { pipe, event, data } of pending) {
+            this.wsSend({ type: 'publish', pipe, event, data });
+        }
+    }
+    dispatch(pipe, event, data) {
+        const listeners = this.pipeListeners.get(pipe);
         if (!listeners)
             return;
         for (const listener of listeners) {

package/dist/client/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/client/connection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/client/connection.ts"],"names":[],"mappings":"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"}

package/dist/client/index.d.ts

@@ -13,9 +13,9 @@ type EventName<T extends EventMap> = keyof T & string;
  */
 type EventData<T extends EventMap, E extends EventName<T>> = z.infer<T[E]>;
 /**
- * Handler map for useChannel — a partial record of event handlers.
+ * Handler map for usePipe — a partial record of event handlers.
  */
-type ChannelHandlers<T extends EventMap> = {
+type PipeHandlers<T extends EventMap> = {
     [E in EventName<T>]?: (data: EventData<T, E>) => void;
 };
 /**
@@ -23,29 +23,26 @@ type ChannelHandlers<T extends EventMap> = {
  *
  * Usage:
  * ```ts
- * const { RealtimeProvider, useChannel, useEvent } = createRealtimeClient({
+ * const { PipeProvider, usePipe } = createPipeClient({
  *   events: realtimeEvents,
- *   auth: { endpoint: '/api/realtime/auth' },
  * });
  * ```
  */
-export declare function createRealtimeClient<T extends EventMap>(config: {
+export declare function createPipeClient<T extends EventMap>(config: {
     events: T;
-    auth: {
-        endpoint: string;
-    };
-    /** Override the broker URL. Defaults to `wss://api.hotpipe.dev`. */
+    /** Override the base path where your handler is mounted. Defaults to `/api/realtime`. */
+    basePath?: string;
+    /** @internal Override the broker URL for local development. */
     brokerUrl?: string;
+    /** Provide custom headers for the auth request (e.g., a Bearer token). */
+    authHeaders?: () => Promise<Record<string, string>>;
 }): {
-    RealtimeProvider: ({ children }: {
+    PipeProvider: ({ children }: {
         children: React.ReactNode;
     }) => import("react/jsx-runtime").JSX.Element;
-    useChannel: (channel: string, handlers: Partial<ChannelHandlers<T>>) => {
-        status: ConnectionStatus;
-        publish: <E extends EventName<T>>(event: E, data: EventData<T, E>) => void;
-    };
-    useEvent: <E extends EventName<T>>(channel: string, event: E, handler: (data: EventData<T, E>) => void) => {
+    usePipe: (pipe: string, handlers?: Partial<PipeHandlers<T>>) => {
         status: ConnectionStatus;
+        publish: <E extends EventName<T>>(event: E, data: EventData<T, E>) => boolean;
     };
 };
 export type { ConnectionStatus, EventMap };

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAExE;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC;AAEtD;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E;;GAEG;AACH,KAAK,eAAe,CAAC,CAAC,SAAS,QAAQ,IAAI;KACxC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI;CACtD,CAAC;AAIF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE;IAC/D,MAAM,EAAE,CAAC,CAAC;IACV,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;qCAiByC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE;0BA+B1D,MAAM,YACL,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,KACpC;QACD,MAAM,EAAE,gBAAgB,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC5E;eA6DiB,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,WAC7B,MAAM,SACR,CAAC,WACC,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,KACvC;QAAE,MAAM,EAAE,gBAAgB,CAAA;KAAE;EA+BhC;AAED,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAExE;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC;AAEtD;;GAEG;AACH,KAAK,SAAS,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,QAAQ,IAAI;KACrC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI;CACtD,CAAC;AAKF;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE;IAC3D,MAAM,EAAE,CAAC,CAAC;IACV,yFAAyF;IACzF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;iCAiBqC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE;oBAgCzD,MAAM,aACD,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAClC;QACD,MAAM,EAAE,gBAAgB,CAAC;QACzB,OAAO,EAAE,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC;KAC/E;EAoDF;AAED,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC"}

package/dist/client/index.js

@@ -3,23 +3,23 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useCallback, useContext, useEffect, useRef, useState } from 'react';
 import { ConnectionManager } from './connection';
 const DEFAULT_BROKER_URL = 'wss://api.hotpipe.dev';
+const DEFAULT_BASE_PATH = '/api/realtime';
 /**
  * Creates a typed real-time client bound to your event schemas.
  *
  * Usage:
  * ```ts
- * const { RealtimeProvider, useChannel, useEvent } = createRealtimeClient({
+ * const { PipeProvider, usePipe } = createPipeClient({
  *   events: realtimeEvents,
- *   auth: { endpoint: '/api/realtime/auth' },
  * });
  * ```
  */
-export function createRealtimeClient(config) {
-    const RealtimeContext = createContext(null);
+export function createPipeClient(config) {
+    const PipeContext = createContext(null);
     function useManager() {
-        const manager = useContext(RealtimeContext);
+        const manager = useContext(PipeContext);
         if (!manager) {
-            throw new Error('hotpipe: useChannel/useEvent must be used within <RealtimeProvider>');
+            throw new Error('hotpipe: usePipe must be used within <PipeProvider>');
         }
         return manager;
     }
@@ -27,31 +27,32 @@ export function createRealtimeClient(config) {
      * Wrap your app (or a subtree) with this provider to establish the
      * WebSocket connection to the broker.
      */
-    function RealtimeProvider({ children }) {
+    function PipeProvider({ children }) {
         const managerRef = useRef(null);
         if (!managerRef.current) {
             managerRef.current = new ConnectionManager({
                 brokerUrl: config.brokerUrl ?? DEFAULT_BROKER_URL,
-                authEndpoint: config.auth.endpoint,
+                authEndpoint: `${config.basePath ?? DEFAULT_BASE_PATH}/auth`,
+                authHeaders: config.authHeaders,
             });
         }
         useEffect(() => {
             managerRef.current?.connect();
             return () => managerRef.current?.disconnect();
         }, []);
-        return (_jsx(RealtimeContext.Provider, { value: managerRef.current, children: children }));
+        return (_jsx(PipeContext.Provider, { value: managerRef.current, children: children }));
     }
     /**
-     * Subscribe to events on a channel. Returns connection status and a
+     * Subscribe to events on a pipe. Returns connection status and a
      * typed publish function.
      *
      * ```tsx
-     * const { status, publish } = useChannel('general', {
+     * const { status, publish } = usePipe('global', {
      *   'message.created': (data) => addMessage(data),
      * });
      * ```
      */
-    function useChannel(channel, handlers) {
+    function usePipe(pipe, handlers) {
         const manager = useManager();
         const handlersRef = useRef(handlers);
         handlersRef.current = handlers;
@@ -61,64 +62,30 @@ export function createRealtimeClient(config) {
         }, [manager]);
         useEffect(() => {
             const listener = (event, data) => {
-                const handler = handlersRef.current[event];
+                const handler = handlersRef.current?.[event];
                 if (handler) {
                     handler(data);
                 }
             };
-            manager.addChannelListener(channel, listener);
-            manager.subscribe(channel);
+            manager.addPipeListener(pipe, listener);
+            manager.subscribe(pipe);
             return () => {
-                manager.unsubscribe(channel);
-                manager.removeChannelListener(channel, listener);
+                manager.unsubscribe(pipe);
+                manager.removePipeListener(pipe, listener);
             };
-        }, [channel, manager]);
+        }, [pipe, manager]);
         const publish = useCallback((event, data) => {
-            // Validate against schema before sending
             const schema = config.events[event];
             if (schema) {
                 const result = schema.safeParse(data);
                 if (!result.success) {
-                    if (process.env.NODE_ENV !== 'production') {
-                        console.error(`[hotpipe] Invalid data for "${event}":`, result.error.format());
-                    }
-                    return;
+                    throw new Error(`[hotpipe] Invalid data for "${event}": ${JSON.stringify(result.error.format())}`);
                 }
             }
-            manager.publish(channel, event, data);
-        }, [channel, manager]);
+            return manager.publish(pipe, event, data);
+        }, [pipe, manager]);
         return { status, publish };
     }
-    /**
-     * Subscribe to a single event type on a channel.
-     *
-     * ```tsx
-     * useEvent('general', 'message.created', (data) => addMessage(data));
-     * ```
-     */
-    function useEvent(channel, event, handler) {
-        const manager = useManager();
-        const handlerRef = useRef(handler);
-        handlerRef.current = handler;
-        const [status, setStatus] = useState(manager.getStatus());
-        useEffect(() => {
-            return manager.onStatusChange(setStatus);
-        }, [manager]);
-        useEffect(() => {
-            const listener = (evt, data) => {
-                if (evt === event) {
-                    handlerRef.current(data);
-                }
-            };
-            manager.addChannelListener(channel, listener);
-            manager.subscribe(channel);
-            return () => {
-                manager.unsubscribe(channel);
-                manager.removeChannelListener(channel, listener);
-            };
-        }, [channel, event, manager]);
-        return { status };
-    }
-    return { RealtimeProvider, useChannel, useEvent };
+    return { PipeProvider, usePipe };
 }
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.tsx"],"names":[],"mappings":"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"}

package/dist/server/index.d.ts

@@ -1,71 +1,81 @@
 import type { z } from 'zod';
 type EventMap = Record<string, z.ZodType>;
+/**
+ * Pipe permissions — which operations a user can perform.
+ */
+interface PipePermissions {
+    subscribe?: boolean;
+    publish?: boolean;
+}
 /**
  * The shape returned by your authorize function.
  */
 interface AuthResult {
     userId: string;
-    channels: Record<string, ('subscribe' | 'publish')[]>;
+    pipes: Record<string, PipePermissions>;
 }
 /**
  * Creates a typed server-side publisher for emitting events to the broker
  * from API routes, server actions, webhooks, cron jobs, etc.
  *
  * ```ts
- * const realtime = createRealtimePublisher({
- *   apiKey: process.env.HOTPIPE_API_KEY!,
+ * const realtime = createPipePublisher({
+ *   secret: process.env.HOTPIPE_SECRET!,
  *   events: realtimeEvents,
  * });
  *
- * await realtime.publish('general', 'message.created', { ... });
+ * const teamChat = realtime.pipe('team-chat');
+ * await teamChat.publish('message.created', { ... });
  * ```
  */
-export declare function createRealtimePublisher<T extends EventMap>(config: {
-    apiKey: string;
+export declare function createPipePublisher<T extends EventMap>(config: {
+    secret: string;
     events: T;
-    /** Override the broker URL. Defaults to `https://api.hotpipe.dev`. */
+    /** @internal Override the broker URL for local development. */
     brokerUrl?: string;
 }): {
     /**
-     * Publish a single event to a channel.
+     * Get a reference to a pipe. Returns a `{ publish }` object with
+     * the same signature as the client-side `usePipe` publish function.
+     *
+     * ```ts
+     * const teamChat = realtime.pipe('team-chat');
+     * await teamChat.publish('message.created', { ... });
+     * ```
      */
-    publish<E extends keyof T & string>(channel: string, event: E, data: z.infer<T[E]>): Promise<void>;
-    /**
-     * Publish multiple events in a single HTTP request.
-     */
-    publishBatch(events: Array<{
-        channel: string;
-        event: keyof T & string;
-        data: unknown;
-    }>): Promise<void>;
+    pipe(pipe: string): {
+        publish<E extends keyof T & string>(event: E, data: z.infer<T[E]>): Promise<void>;
+    };
 };
 /**
- * Creates a Next.js-compatible route handler for client auth.
- * The client SDK calls this endpoint to get a signed token before
- * opening the WebSocket connection to the broker.
+ * Creates a Next.js-compatible catch-all route handler for hotpipe.
+ * Mount this at `app/api/realtime/[...all]/route.ts` and the SDK
+ * handles the rest.
  *
  * ```ts
- * // app/api/realtime/auth/route.ts
- * export const POST = createAuthHandler({
- *   secret: process.env.BROKER_SIGNING_SECRET!,
+ * // app/api/realtime/[...all]/route.ts
+ * export const { POST } = createPipeHandler({
+ *   secret: process.env.HOTPIPE_SECRET!,
  *   authorize: async (req) => {
- *     const session = await getServerSession();
+ *     const { session } = await getAuth(req);
  *     if (!session) return null;
  *     return {
- *       userId: session.user.id,
- *       channels: {
- *         general: ['subscribe', 'publish'],
- *         [`user-${session.user.id}`]: ['subscribe'],
+ *       userId: session.userId,
+ *       pipes: {
+ *         global: { subscribe: true, publish: true },
+ *         [`user-${session.userId}`]: { subscribe: true },
  *       },
  *     };
  *   },
  * });
  * ```
  */
-export declare function createAuthHandler(handlerConfig: {
+export declare function createPipeHandler(handlerConfig: {
     secret: string;
     authorize: (req: Request) => Promise<AuthResult | null>;
     tokenExpiry?: number;
-}): (req: Request) => Promise<Response>;
-export type { AuthResult, EventMap };
+}): {
+    POST: (req: Request) => Promise<Response>;
+};
+export type { AuthResult, EventMap, PipePermissions };
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;CACvD;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,CAAC;IACV,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;IASG;;OAEG;YACW,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,WAC7B,MAAM,SACR,CAAC,QACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;yBAEO,KAAK,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC;QACxB,IAAI,EAAE,OAAO,CAAC;KACf,CAAC,GACD,OAAO,CAAC,IAAI,CAAC;EAYnB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,IAIe,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAuB/C;AAED,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,KAAK,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,UAAU,eAAe;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACxC;AAwBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,CAAC;IACV,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;IAwCG;;;;;;;;OAQG;eACQ,MAAM;gBAEC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,SAC/B,CAAC,QACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,IAAI,CAAC;;EAMvB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;gBAuC6B,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;EAWxD;AAED,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC"}

package/dist/server/index.js

@@ -1,92 +1,125 @@
 import { SignJWT } from 'jose';
+import { SDK_VERSION } from '../version';
 const DEFAULT_BROKER_URL = 'https://api.hotpipe.dev';
+/**
+ * Derives a publish-specific auth token from the shared secret via HMAC.
+ * This ensures the raw secret is never sent over the wire as a Bearer token.
+ */
+async function derivePublishToken(secret) {
+    const encoder = new TextEncoder();
+    const key = await crypto.subtle.importKey('raw', encoder.encode(secret), { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+    const signature = await crypto.subtle.sign('HMAC', key, encoder.encode('hotpipe-publish-v1'));
+    return Array.from(new Uint8Array(signature))
+        .map((b) => b.toString(16).padStart(2, '0'))
+        .join('');
+}
 /**
  * Creates a typed server-side publisher for emitting events to the broker
  * from API routes, server actions, webhooks, cron jobs, etc.
  *
  * ```ts
- * const realtime = createRealtimePublisher({
- *   apiKey: process.env.HOTPIPE_API_KEY!,
+ * const realtime = createPipePublisher({
+ *   secret: process.env.HOTPIPE_SECRET!,
  *   events: realtimeEvents,
  * });
  *
- * await realtime.publish('general', 'message.created', { ... });
+ * const teamChat = realtime.pipe('team-chat');
+ * await teamChat.publish('message.created', { ... });
  * ```
  */
-export function createRealtimePublisher(config) {
+export function createPipePublisher(config) {
     const brokerUrl = config.brokerUrl ?? DEFAULT_BROKER_URL;
-    const headers = {
-        'Content-Type': 'application/json',
-        Authorization: `Bearer ${config.apiKey}`,
-    };
+    let cachedHeaders = null;
+    async function getHeaders() {
+        if (!cachedHeaders) {
+            const publishToken = await derivePublishToken(config.secret);
+            cachedHeaders = {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${publishToken}`,
+                'X-Hotpipe-SDK': SDK_VERSION,
+            };
+        }
+        return cachedHeaders;
+    }
+    async function publishToBroker(pipe, event, data) {
+        const schema = config.events[event];
+        if (schema) {
+            schema.parse(data);
+        }
+        const res = await fetch(`${brokerUrl}/publish`, {
+            method: 'POST',
+            headers: await getHeaders(),
+            body: JSON.stringify({ pipe, event, data }),
+        });
+        if (!res.ok) {
+            throw new Error(`hotpipe publish failed: ${res.status} ${await res.text()}`);
+        }
+    }
     return {
         /**
-         * Publish a single event to a channel.
-         */
-        async publish(channel, event, data) {
-            const schema = config.events[event];
-            if (schema) {
-                schema.parse(data);
-            }
-            const res = await fetch(`${brokerUrl}/publish`, {
-                method: 'POST',
-                headers,
-                body: JSON.stringify({ channel, event, data }),
-            });
-            if (!res.ok) {
-                throw new Error(`hotpipe publish failed: ${res.status} ${await res.text()}`);
-            }
-        },
-        /**
-         * Publish multiple events in a single HTTP request.
+         * Get a reference to a pipe. Returns a `{ publish }` object with
+         * the same signature as the client-side `usePipe` publish function.
+         *
+         * ```ts
+         * const teamChat = realtime.pipe('team-chat');
+         * await teamChat.publish('message.created', { ... });
+         * ```
          */
-        async publishBatch(events) {
-            const res = await fetch(`${brokerUrl}/publish/batch`, {
-                method: 'POST',
-                headers,
-                body: JSON.stringify({ events }),
-            });
-            if (!res.ok) {
-                throw new Error(`hotpipe batch publish failed: ${res.status} ${await res.text()}`);
-            }
+        pipe(pipe) {
+            return {
+                async publish(event, data) {
+                    return publishToBroker(pipe, event, data);
+                },
+            };
         },
     };
 }
 /**
- * Creates a Next.js-compatible route handler for client auth.
- * The client SDK calls this endpoint to get a signed token before
- * opening the WebSocket connection to the broker.
+ * Creates a Next.js-compatible catch-all route handler for hotpipe.
+ * Mount this at `app/api/realtime/[...all]/route.ts` and the SDK
+ * handles the rest.
  *
  * ```ts
- * // app/api/realtime/auth/route.ts
- * export const POST = createAuthHandler({
- *   secret: process.env.BROKER_SIGNING_SECRET!,
+ * // app/api/realtime/[...all]/route.ts
+ * export const { POST } = createPipeHandler({
+ *   secret: process.env.HOTPIPE_SECRET!,
  *   authorize: async (req) => {
- *     const session = await getServerSession();
+ *     const { session } = await getAuth(req);
  *     if (!session) return null;
  *     return {
- *       userId: session.user.id,
- *       channels: {
- *         general: ['subscribe', 'publish'],
- *         [`user-${session.user.id}`]: ['subscribe'],
+ *       userId: session.userId,
+ *       pipes: {
+ *         global: { subscribe: true, publish: true },
+ *         [`user-${session.userId}`]: { subscribe: true },
  *       },
  *     };
  *   },
  * });
  * ```
  */
-export function createAuthHandler(handlerConfig) {
+export function createPipeHandler(handlerConfig) {
     const encodedSecret = new TextEncoder().encode(handlerConfig.secret);
     const expiry = handlerConfig.tokenExpiry || 3600;
-    return async (req) => {
+    async function handleAuth(req) {
         try {
             const result = await handlerConfig.authorize(req);
             if (!result) {
                 return Response.json({ error: 'Unauthorized' }, { status: 401 });
             }
+            // Transform { subscribe?: boolean, publish?: boolean } to string arrays
+            // for the broker wire format
+            const permissions = {};
+            for (const [pipe, perms] of Object.entries(result.pipes)) {
+                const arr = [];
+                if (perms.subscribe)
+                    arr.push('subscribe');
+                if (perms.publish)
+                    arr.push('publish');
+                permissions[pipe] = arr;
+            }
             const token = await new SignJWT({
-                channels: Object.keys(result.channels),
-                permissions: result.channels,
+                pipes: Object.keys(result.pipes),
+                permissions,
             })
                 .setSubject(result.userId)
                 .setIssuedAt()
@@ -98,6 +131,14 @@ export function createAuthHandler(handlerConfig) {
         catch {
             return Response.json({ error: 'Internal error' }, { status: 500 });
         }
-    };
+    }
+    async function handler(req) {
+        const url = new URL(req.url);
+        if (url.pathname.endsWith('/auth')) {
+            return handleAuth(req);
+        }
+        return Response.json({ error: 'Not found' }, { status: 404 });
+    }
+    return { POST: handler };
 }
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const SDK_VERSION = "0.2.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const SDK_VERSION = '0.2.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hotpipe",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Type-safe real-time event broker SDK for React and Next.js",
   "license": "MIT",
   "type": "module",
@@ -40,7 +40,7 @@
     "reset": "npm run clean && rm -rf node_modules"
   },
   "dependencies": {
-    "jose": "^5.0.0"
+    "jose": "^6.1.3"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -48,7 +48,7 @@
   },
   "devDependencies": {
     "@pepper/tsconfig": "1.0.0",
-    "@types/react": ">=18",
-    "typescript": "^5.0.0"
+    "@types/react": ">=19",
+    "typescript": "^5.9.3"
   }
 }