hotpipe 0.1.0 → 0.10.0

package/dist/client/index.js

@@ -1,124 +1,136 @@
 'use client';
 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';
+import { ConnectionManager, } from './connection';
+const DEFAULT_API_URL = 'wss://api.hotpipe.dev';
+const DEFAULT_BASE_PATH = '/api/realtime';
+const globalCache = globalThis;
 /**
  * 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 apiUrl = config.apiUrl ?? DEFAULT_API_URL;
+    const authEndpoint = `${config.basePath ?? DEFAULT_BASE_PATH}/auth`;
+    const connectionConfig = {
+        apiUrl,
+        authEndpoint,
+        authHeaders: config.authHeaders,
+        onPipeRevoked: config.onPipeRevoked,
+        onAllPipesRevoked: config.onAllPipesRevoked,
+    };
+    // Reuse existing manager in dev to survive HMR module re-evaluation
+    const cacheKey = `__hotpipe_${apiUrl}_${authEndpoint}`;
+    let manager;
+    if (globalCache[cacheKey]) {
+        manager = globalCache[cacheKey];
+        manager.updateConfig(connectionConfig);
+    }
+    else {
+        manager = new ConnectionManager(connectionConfig);
+    }
+    if (process.env.NODE_ENV !== 'production') {
+        globalCache[cacheKey] = manager;
+    }
+    const PipeContext = createContext(null);
     function useManager() {
-        const manager = useContext(RealtimeContext);
-        if (!manager) {
-            throw new Error('hotpipe: useChannel/useEvent must be used within <RealtimeProvider>');
+        const ctx = useContext(PipeContext);
+        if (!ctx) {
+            throw new Error('hotpipe: usePipe must be used within <PipeProvider>');
         }
-        return manager;
+        return ctx;
     }
     /**
      * Wrap your app (or a subtree) with this provider to establish the
-     * WebSocket connection to the broker.
+     * WebSocket connection to the hotpipe API.
      */
-    function RealtimeProvider({ children }) {
-        const managerRef = useRef(null);
-        if (!managerRef.current) {
-            managerRef.current = new ConnectionManager({
-                brokerUrl: config.brokerUrl ?? DEFAULT_BROKER_URL,
-                authEndpoint: config.auth.endpoint,
-            });
-        }
+    function PipeProvider({ children }) {
         useEffect(() => {
-            managerRef.current?.connect();
-            return () => managerRef.current?.disconnect();
+            manager.retain();
+            if (process.env.NODE_ENV !== 'production' && manager.getProviderRefCount() > 1) {
+                console.warn('[hotpipe] Multiple <PipeProvider> instances detected. ' +
+                    'Use a single provider at the root of your app to avoid redundant connections.');
+            }
+            return () => manager.release();
         }, []);
-        return (_jsx(RealtimeContext.Provider, { value: managerRef.current, children: children }));
+        return _jsx(PipeContext.Provider, { value: manager, 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, options) {
         const manager = useManager();
         const handlersRef = useRef(handlers);
         handlersRef.current = handlers;
+        const serverMsgRef = useRef(options?.onServerMessage);
+        serverMsgRef.current = options?.onServerMessage;
         const [status, setStatus] = useState(manager.getStatus());
         useEffect(() => {
             return manager.onStatusChange(setStatus);
         }, [manager]);
         useEffect(() => {
-            const listener = (event, data) => {
-                const handler = handlersRef.current[event];
-                if (handler) {
-                    handler(data);
+            if (!serverMsgRef.current)
+                return;
+            return manager.onServerMessage((msg) => {
+                serverMsgRef.current?.(msg);
+            });
+        }, [manager]);
+        useEffect(() => {
+            const listener = (event, data, metadata) => {
+                const handler = handlersRef.current?.[event];
+                if (!handler)
+                    return;
+                const schema = config.events[event];
+                if (schema) {
+                    const result = schema.safeParse(data);
+                    if (!result.success)
+                        return;
                 }
+                handler(data, metadata);
             };
-            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.
+     * Trigger a mid-session token refresh. Call this when a user's permissions
+     * change (e.g., they join a new chat room) and the connection should update
+     * in place without disconnecting.
      *
-     * ```tsx
-     * useEvent('general', 'message.created', (data) => addMessage(data));
-     * ```
+     * Callable from anywhere — event handlers, server action callbacks, etc.
+     * Does not require React context.
      */
-    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 };
+    function refreshPipeAuth() {
+        return manager.refreshToken();
     }
-    return { RealtimeProvider, useChannel, useEvent };
+    return { PipeProvider, usePipe, refreshPipeAuth };
 }
 //# 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/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default JWT token expiry in seconds. Used by createPipeHandler for token
+ * generation and by createPipeAdmin for revocation TTL defaults.
+ *
+ * Must stay in sync with the API-side constant (apps/hotpipe-api/src/constants.ts).
+ */
+export declare const DEFAULT_TOKEN_EXPIRY_SECONDS = 3600;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,OAAO,CAAC"}

package/dist/constants.js

@@ -0,0 +1,8 @@
+/**
+ * Default JWT token expiry in seconds. Used by createPipeHandler for token
+ * generation and by createPipeAdmin for revocation TTL defaults.
+ *
+ * Must stay in sync with the API-side constant (apps/hotpipe-api/src/constants.ts).
+ */
+export const DEFAULT_TOKEN_EXPIRY_SECONDS = 3600;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC"}

package/dist/server/index.d.ts

@@ -1,71 +1,152 @@
 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
+ * Options for server-side publish calls.
+ */
+interface PublishOptions {
+    /**
+     * An optional sender identity to attach to this event. Receiving clients
+     * see this in `metadata.sender`. When omitted, `sender` is `null`,
+     * indicating the event originated from the server with no specific user.
+     */
+    sender?: string;
+}
+/**
+ * Creates a typed server-side publisher for emitting events to the hotpipe API
  * 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`. */
-    brokerUrl?: string;
+    /** @internal Override the API URL for local development. */
+    apiUrl?: 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]>, options?: PublishOptions): 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>;
+};
+/**
+ * Options for revocation methods.
+ */
+interface RevokeOptions {
+    /** TTL in seconds for the revocation entry. Defaults to the API's token expiry. */
+    ttl?: number;
+}
+/**
+ * A single revocation target for batch operations.
+ */
+interface RevocationEntry {
+    userId: string;
+    pipe: string;
+}
+/**
+ * Creates a server-side admin client for revoking pipe access.
+ *
+ * ```ts
+ * const pipeAdmin = createPipeAdmin({
+ *   secret: process.env.HOTPIPE_SECRET!,
+ * });
+ *
+ * await pipeAdmin.revoke('user-123', 'room-xyz');
+ * await pipeAdmin.revokeAll('user-123');
+ * ```
+ */
+export declare function createPipeAdmin(config: {
+    secret: string;
+    /** @internal Override the API URL for local development. */
+    apiUrl?: string;
+}): {
+    /**
+     * Revoke access to one or more pipes for a user.
+     *
+     * ```ts
+     * await pipeAdmin.revoke('user-123', 'room-xyz');
+     * await pipeAdmin.revoke('user-123', ['room-xyz', 'room-abc']);
+     * ```
+     */
+    revoke(userId: string, pipe: string | string[], options?: RevokeOptions): Promise<void>;
+    /**
+     * Revoke all pipe access for a user (e.g., account suspension).
+     *
+     * ```ts
+     * await pipeAdmin.revokeAll('user-123');
+     * ```
+     */
+    revokeAll(userId: string, options?: RevokeOptions): Promise<void>;
+    /**
+     * Batch-revoke access for multiple user/pipe combinations.
+     *
+     * ```ts
+     * await pipeAdmin.revokeBatch([
+     *   { userId: 'user-123', pipe: 'room-xyz' },
+     *   { userId: 'user-456', pipe: 'room-xyz' },
+     * ]);
+     * ```
+     */
+    revokeBatch(revocations: RevocationEntry[], options?: RevokeOptions): Promise<void>;
+};
+export type { AuthResult, EventMap, PipePermissions, PublishOptions, RevokeOptions };
 //# 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":"AACA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAM7B,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;AAED;;GAEG;AACH,UAAU,cAAc;IACtB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAwBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,QAAQ,EAAE,MAAM,EAAE;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,CAAC;IACV,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;IAgDG;;;;;;;;OAQG;eACQ,MAAM;gBAEC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,SAC/B,CAAC,QACF,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,YACT,cAAc,GACvB,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;gBAyC6B,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;EAWxD;AAED;;GAEG;AACH,UAAU,aAAa;IACrB,mFAAmF;IACnF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,UAAU,eAAe;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;IA2CG;;;;;;;OAOG;mBACkB,MAAM,QAAQ,MAAM,GAAG,MAAM,EAAE,YAAY,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7F;;;;;;OAMG;sBACqB,MAAM,YAAY,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE;;;;;;;;;OASG;6BAC4B,eAAe,EAAE,YAAY,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;EAI5F;AAED,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC"}