@vitnode/core 1.2.0-canary.76 → 1.2.0-canary.78

package/dist/src/ws/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/ws/types.ts"],"sourcesContent":["/**\n * Shared WebSocket types used by both the server (`@vitnode/core/ws/handle`,\n * `@vitnode/core/api/lib/websocket`) and the client (`@vitnode/core/ws/provider`,\n * `@vitnode/core/ws/use-websocket`). This module must stay free of any\n * server-only imports so it is safe to bundle on the client.\n */\n\n/**\n * Envelope for every message exchanged over the VitNode WebSocket.\n *\n * The single `/ws` connection is multiplexed: each message carries the `id` of\n * the socket it targets (`{pluginId}_{module}_{id}`), so the server can\n * dispatch it to the right handler and the client can route it to the right\n * subscriber.\n */\nexport interface VitNodeWSMessage<TData = unknown> {\n  data: TData;\n  id: string;\n}\n\n/**\n * A typed contract for a WebSocket channel, shared between the server handler\n * and the client hook so both sides agree on the id and the message shapes.\n *\n * - `Send` - what the client sends to the server.\n * - `Receive` - what the client receives from the server.\n */\nexport interface VitNodeWSChannel<Send = unknown, Receive = unknown> {\n  /**\n   * Phantom field - never present at runtime. It only exists to carry the\n   * `Send`/`Receive` types so they can be inferred from a channel value.\n   */\n  __types?: {\n    receive: Receive;\n    send: Send;\n  };\n  id: string;\n}\n\n/**\n * Compose the public id a client uses to target a WebSocket:\n * `{pluginId}_{module}_{id}`.\n */\nexport const getWebSocketId = (parts: {\n  id: string;\n  module: string;\n  pluginId: string;\n}): string => `${parts.pluginId}_${parts.module}_${parts.id}`;\n\n/**\n * Define a typed {@link VitNodeWSChannel} that both the server and the client\n * can import as the single source of truth for a socket's id and message\n * shapes.\n *\n * @example\n * ```ts\n * export const echoChannel = createWebSocketChannel<ClientMsg, ServerMsg>({\n *   pluginId: \"@vitnode/blog\",\n *   module: \"posts\",\n *   id: \"echo\",\n * });\n * ```\n */\nexport const createWebSocketChannel = <\n  Send = unknown,\n  Receive = unknown,\n>(parts: {\n  id: string;\n  module: string;\n  pluginId: string;\n}): VitNodeWSChannel<Send, Receive> => ({\n  id: getWebSocketId(parts),\n});\n"],"mappings":"AA2CA,MAAa,EAAkB,GAIjB,GAAG,EAAM,SAAS,GAAG,EAAM,OAAO,GAAG,EAAM,KAgB5C,EAGX,IAIsC,CACtC,GAAI,EAAe,CAAK,CAC1B"}

package/dist/src/ws/use-websocket.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"use-websocket.js","names":[],"sources":["../../../src/ws/use-websocket.ts"],"sourcesContent":["\"use client\";\n\nimport React from \"react\";\n\nimport type { VitNodeWSChannel } from \"./types\";\n\nimport { useVitNodeWebSocketContext } from \"./provider\";\n\nexport interface UseVitNodeWebSocketReturn<Send> {\n  /**\n   * The current `readyState` of the shared connection (`0` CONNECTING, `1`\n   * OPEN, `2` CLOSING, `3` CLOSED).\n   */\n  readyState: number;\n  /** Send a typed payload to this socket. */\n  send: (data: Send) => void;\n}\n\n/**\n * Subscribe to a VitNode WebSocket over the shared `/ws` connection.\n *\n * Pass a {@link VitNodeWSChannel} (recommended - it carries the id and the\n * message types) or a raw id string. Messages are routed by id, so only the\n * payloads addressed to this channel reach `options.onMessage`.\n *\n * @example\n * ```tsx\n * const { send, readyState } = useVitNodeWebSocket(echoChannel, {\n *   onMessage: data => setMessages(prev => [...prev, data]),\n * });\n * ```\n */\nexport function useVitNodeWebSocket<Send = unknown, Receive = unknown>(\n  channel: string | VitNodeWSChannel<Send, Receive>,\n  options?: {\n    onMessage?: (data: Receive) => void;\n  },\n): UseVitNodeWebSocketReturn<Send> {\n  const {\n    readyState,\n    send: contextSend,\n    subscribe,\n  } = useVitNodeWebSocketContext();\n  const id = typeof channel === \"string\" ? channel : channel.id;\n\n  // Keep the latest handler in a ref so subscribing does not depend on it.\n  const onMessageRef = React.useRef(options?.onMessage);\n  React.useEffect(() => {\n    onMessageRef.current = options?.onMessage;\n  });\n\n  React.useEffect(\n    () => subscribe(id, data => onMessageRef.current?.(data as Receive)),\n    [id, subscribe],\n  );\n\n  const send = React.useCallback(\n    (data: Send) => contextSend(id, data),\n    [contextSend, id],\n  );\n\n  return { readyState, send };\n}\n"],"mappings":"6FAgCA,SAAgB,EACd,EACA,EAGiC,CACjC,GAAM,CACJ,aACA,KAAM,EACN,aACE,EAA2B,EACzB,EAAK,OAAO,GAAY,SAAW,EAAU,EAAQ,GAGrD,EAAe,EAAM,OAAO,GAAS,SAAS,EAepD,OAdA,EAAM,cAAgB,CACpB,EAAa,QAAU,GAAS,SAClC,CAAC,EAED,EAAM,cACE,EAAU,EAAI,GAAQ,EAAa,UAAU,CAAe,CAAC,EACnE,CAAC,EAAI,CAAS,CAChB,EAOO,CAAE,aAAY,KALR,EAAM,YAChB,GAAe,EAAY,EAAI,CAAI,EACpC,CAAC,EAAa,CAAE,CAGM,CAAE,CAC5B"}