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

package/dist/src/vitnode.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitnode.config.js","names":[],"sources":["../../src/vitnode.config.ts"],"sourcesContent":["import type { ProgressProvider } from \"@bprogress/next/app\";\nimport type { drizzle } from \"drizzle-orm/postgres-js\";\nimport type { RedisOptions } from \"ioredis\";\nimport type { IRateLimiterOptions } from \"rate-limiter-flexible\";\nimport type React from \"react\";\n\nimport type { CronAdapter } from \"./api/lib/cron\";\nimport type { BuildPluginApiReturn } from \"./api/lib/plugin\";\nimport type { EmailApiPlugin } from \"./api/models/email\";\nimport type { SSOApiPlugin } from \"./api/models/sso\";\nimport type { StorageApiPlugin } from \"./api/models/storage\";\nimport type { ThemeProviderProps } from \"./components/theme-provider\";\nimport type { DefaultTemplateEmailProps } from \"./emails/default-template\";\nimport type { BuildPluginReturn } from \"./lib/plugin\";\n\nexport interface LocaleConfig {\n  code: string;\n  name: string;\n}\n\nexport interface VitNodeConfig<\n  AppLocales extends LocaleConfig[] = LocaleConfig[],\n> {\n  debug?: boolean;\n  i18n: {\n    defaultLocale: AppLocales[number][\"code\"];\n    localePrefix?: \"always\" | \"as-needed\" | \"never\";\n    locales: AppLocales;\n    timeZone?: string;\n  };\n  metadata: VitNodeApiConfig[\"metadata\"];\n  plugins: BuildPluginReturn[];\n  progressBar?: React.ComponentProps<typeof ProgressProvider>;\n  theme?: Omit<\n    ThemeProviderProps,\n    \"attribute\" | \"children\" | \"disableTransitionOnChange\" | \"enableSystem\"\n  >;\n}\n\nexport interface VitNodeApiConfig {\n  authorization?: {\n    adminCookieExpires?: number;\n    adminCookieName?: string;\n    cookieExpires?: number;\n    cookieName?: string;\n    cookieSecure?: boolean;\n    deviceCookieExpires?: number;\n    deviceCookieName?: string;\n    ssoAdapters?: SSOApiPlugin[];\n  };\n  captcha?: {\n    secretKey: string | undefined;\n    siteKey: string | undefined;\n    type: \"cloudflare_turnstile\" | \"recaptcha_v3\";\n  };\n  cron?: CronAdapter;\n  dbProvider: ReturnType<typeof drizzle>;\n  email?: {\n    adapter?: EmailApiPlugin;\n    logo?: DefaultTemplateEmailProps[\"templateProps\"][\"logo\"];\n    tailwindConfig?: DefaultTemplateEmailProps[\"templateProps\"][\"tailwindConfig\"];\n  };\n  metadata: {\n    shortTitle?: string;\n    title: string;\n  };\n  pathToMessages: (path: string) => Promise<{ default: object }>;\n  plugins: BuildPluginApiReturn[];\n  rateLimiter?: Omit<IRateLimiterOptions, \"keyPrefix\">;\n  /**\n   * Redis connection used as a shared cache (via `c.get(\"cache\")`) and, when\n   * set, as the storage backend for the rate limiter. Leave undefined to run\n   * without Redis - the cache degrades to no-ops and the rate limiter falls\n   * back to in-memory storage.\n   */\n  redis?: RedisOptions & { url?: string };\n  /**\n   * Object storage backend used for file uploads, reached in route handlers via\n   * `c.get(\"storage\").upload(...)`. Ships a zero-config Local (disk) adapter;\n   * cloud adapters are available as `@vitnode/s3` (AWS S3 + Cloudflare R2) and\n   * `@vitnode/supabase-storage`. Leave undefined to disable uploads.\n   */\n  storage?: {\n    adapter?: StorageApiPlugin;\n    /**\n     * Re-encode uploaded images with `sharp` before storing them, to shrink file\n     * size. Set to enable; `quality` defaults to 85 (1–100). Applies to JPEG,\n     * PNG, WebP, AVIF and TIFF - other files (incl. SVG/GIF) are stored as-is.\n     *\n     * Processed images are also converted to WebP by default (smaller than JPEG\n     * or PNG at the same quality); set `webp: false` to keep each image in its\n     * original format. Their pixel dimensions are recorded in\n     * `core_files.metadata.dimensions` for display in the admin panel.\n     */\n    image?: {\n      quality?: number;\n      webp?: boolean;\n    };\n  };\n}\n\nlet registeredVitNodeConfig: undefined | VitNodeConfig;\n\nexport function buildConfig<AppLocales extends LocaleConfig[]>(\n  args: VitNodeConfig<AppLocales>,\n): VitNodeConfig<AppLocales> {\n  const config = {\n    ...args,\n    i18n: {\n      ...args.i18n,\n      localePrefix: args.i18n.localePrefix ?? \"as-needed\",\n    },\n  };\n\n  // Register the app config so framework-owned route files (e.g. the @breadcrumb\n  // slots copied into apps) can read it without prop-drilling.\n  registeredVitNodeConfig = config;\n\n  return config;\n}\n\n/**\n * Returns the app's VitNodeConfig registered by {@link buildConfig} (called once\n * in the app's `vitnode.config.ts`). Used by framework route files that need the\n * config but aren't passed it as a prop.\n */\nexport const getVitNodeConfig = (): VitNodeConfig => {\n  if (!registeredVitNodeConfig) {\n    throw new Error(\n      \"VitNode config not initialized - ensure `buildConfig` runs in your vitnode.config.ts.\",\n    );\n  }\n\n  return registeredVitNodeConfig;\n};\n\nexport function buildApiConfig(args: VitNodeApiConfig): VitNodeApiConfig {\n  return args;\n}\n\nexport const handleRequestConfig = async ({\n  requestLocale,\n  vitNodeConfig,\n  pathToMessages,\n}: {\n  pathToMessages: (path: string) => Promise<{ default: object }>;\n  requestLocale: Promise<string | undefined>;\n  vitNodeConfig: VitNodeConfig;\n}) => {\n  const reqLocale = await requestLocale;\n  const localeCodes = vitNodeConfig.i18n.locales.map(locale => locale.code);\n  const locale =\n    reqLocale && localeCodes.includes(reqLocale)\n      ? reqLocale\n      : vitNodeConfig.i18n.defaultLocale;\n\n  const pluginIds: string[] = [\n    \"@vitnode/core\",\n    ...vitNodeConfig.plugins.map(plugin => plugin.pluginId),\n  ];\n\n  // Import and merge messages from all plugins\n  const messagesPromises = pluginIds.map(async pluginId => {\n    try {\n      const path = `${pluginId}/${locale}.json`;\n      const messages = await pathToMessages(path);\n\n      return messages.default;\n    } catch {\n      return {};\n    }\n  });\n\n  const allMessages = await Promise.all(messagesPromises);\n  const messages = allMessages.reduce((acc, curr) => ({ ...acc, ...curr }), {});\n\n  return {\n    locale,\n    messages,\n    pluginIds,\n    timeZone: vitNodeConfig.i18n.timeZone,\n  };\n};\n"],"mappings":"AAqGA,IAAI,EAEJ,SAAgB,EACd,EAC2B,CAC3B,IAAM,EAAS,CACb,GAAG,EACH,KAAM,CACJ,GAAG,EAAK,KACR,aAAc,EAAK,KAAK,cAAgB,WAC1C,CACF,EAMA,MAFA,GAA0B,EAEnB,CACT,CAOA,MAAa,MAAwC,CACnD,GAAI,CAAC,EACH,MAAU,MACR,uFACF,EAGF,OAAO,CACT,EAEA,SAAgB,EAAe,EAA0C,CACvE,OAAO,CACT,CAEA,MAAa,EAAsB,MAAO,CACxC,gBACA,gBACA,oBAKI,CACJ,IAAM,EAAY,MAAM,EAClB,EAAc,EAAc,KAAK,QAAQ,IAAI,GAAU,EAAO,IAAI,EAClE,EACJ,GAAa,EAAY,SAAS,CAAS,EACvC,EACA,EAAc,KAAK,cAEnB,EAAsB,CAC1B,gBACA,GAAG,EAAc,QAAQ,IAAI,GAAU,EAAO,QAAQ,CACxD,EAGM,EAAmB,EAAU,IAAI,KAAM,IAAY,CACvD,GAAI,CAIF,OAAO,MAFgB,EAAe,GADtB,EAAS,GAAG,EAAO,MACO,EAAA,CAE1B,OAClB,MAAQ,CACN,MAAO,CAAC,CACV,CACF,CAAC,EAKD,MAAO,CACL,SACA,UAJe,MADS,QAAQ,IAAI,CAAgB,EAAA,CACzB,QAAQ,EAAK,KAAU,CAAE,GAAG,EAAK,GAAG,CAAK,GAAI,CAAC,CAIlE,EACP,YACA,SAAU,EAAc,KAAK,QAC/B,CACF"}

package/dist/src/ws/handle.d.ts

@@ -1,5 +1,8 @@
-import type { Context } from "hono";
-import type { WSEvents } from "hono/ws";
-import type { EnvVitNode } from "../api/middlewares/global.middleware";
-export declare function handleVitNodeWebSocket(createEvents?: (c: Context<EnvVitNode>) => Promise<WSEvents> | WSEvents): (c: Context<EnvVitNode>) => Promise<WSEvents>;
+import { EnvVitNode } from "../api/middlewares/global.middleware.js";
+import { Context } from "hono";
+import { WSEvents } from "hono/ws";
+//#region src/ws/handle.d.ts
+declare function handleVitNodeWebSocket(createEvents?: (c: Context<EnvVitNode>) => Promise<WSEvents> | WSEvents): (c: Context<EnvVitNode>) => Promise<WSEvents>;
+//#endregion
+export { handleVitNodeWebSocket };
 //# sourceMappingURL=handle.d.ts.map

package/dist/src/ws/handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../../src/ws/handle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAsDtE,wBAAgB,sBAAsB,CACpC,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,IAEzD,GAAG,OAAO,CAAC,UAAU,CAAC,KAAG,OAAO,CAAC,QAAQ,CAAC,CAwDzD"}
+{"version":3,"file":"handle.d.ts","names":[],"sources":["../../../src/ws/handle.ts"],"mappings":";;;;iBAyDgB,uBACd,gBAAgB,GAAG,QAAQ,gBAAgB,QAAQ,YAAY,YAMjD,GAAG,QAAQ,gBAAc,QAAQ"}

package/dist/src/ws/handle.js

@@ -1 +1,2 @@
-import{wsRegistry}from"./registry.js";import{getWebSocketId}from"./types.js";const parseMessage=raw=>{if(typeof raw!=="string")return undefined;try{const parsed=JSON.parse(raw);if(typeof parsed==="object"&&parsed!==null&&"id"in parsed&&typeof parsed.id==="string"){return parsed}}catch{}return undefined};export function handleVitNodeWebSocket(createEvents){return async c=>{const inline=await createEvents?.(c);const registered=c.get("core")?.webSockets??[];const userId=c.get("user")?.id??null;return{onOpen:(event,ws)=>{wsRegistry.add(ws,userId);inline?.onOpen?.(event,ws)},onClose:(event,ws)=>{wsRegistry.remove(ws);inline?.onClose?.(event,ws)},onError:inline?.onError,onMessage:(event,ws)=>{const message=parseMessage(event.data);const target=message?registered.find(webSocket=>getWebSocketId(webSocket)===message.id):undefined;if(message&&target){const send=data=>{ws.send(JSON.stringify({id:message.id,data}))};try{Promise.resolve(target.onMessage({c,data:message.data,send,ws})).catch(error=>{console.error("WebSocket handler error:",error)})}catch(error){console.error("WebSocket handler error:",error)}return}inline?.onMessage?.(event,ws)}}}}
+import{markWebSocketEnabled as e,wsRegistry as t}from"./registry.js";import{getWebSocketId as n}from"./types.js";const r=e=>{if(typeof e==`string`)try{let t=JSON.parse(e);if(typeof t==`object`&&t&&`id`in t&&typeof t.id==`string`)return t}catch{}};function i(i){return e(),async e=>{let a=await i?.(e),o=e.get(`core`)?.webSockets??[],s=e.get(`user`)?.id??null;return{onOpen:(e,n)=>{t.add(n,s),a?.onOpen?.(e,n)},onClose:(e,n)=>{t.remove(n),a?.onClose?.(e,n)},onError:a?.onError,onMessage:(t,i)=>{let s=r(t.data),c=s?o.find(e=>n(e)===s.id):void 0;if(s&&c){let t=e=>{i.send(JSON.stringify({id:s.id,data:e}))};try{Promise.resolve(c.onMessage({c:e,data:s.data,send:t,ws:i})).catch(e=>{console.error(`WebSocket handler error:`,e)})}catch(e){console.error(`WebSocket handler error:`,e)}return}a?.onMessage?.(t,i)}}}}export{i as handleVitNodeWebSocket};
+//# sourceMappingURL=handle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","names":[],"sources":["../../../src/ws/handle.ts"],"sourcesContent":["import type { Context } from \"hono\";\nimport type { WSEvents } from \"hono/ws\";\n\nimport type { EnvVitNode } from \"@/api/middlewares/global.middleware\";\nimport type { VitNodeWSMessage } from \"@/ws/types\";\n\nimport { markWebSocketEnabled, wsRegistry } from \"@/ws/registry\";\nimport { getWebSocketId } from \"@/ws/types\";\n\n/**\n * Parse an incoming raw WebSocket message into a {@link VitNodeWSMessage}\n * envelope. Returns `undefined` for anything that is not a JSON object\n * carrying a string `id` (e.g. plain text or binary frames).\n */\nconst parseMessage = (raw: unknown): undefined | VitNodeWSMessage => {\n  if (typeof raw !== \"string\") return undefined;\n\n  try {\n    const parsed: unknown = JSON.parse(raw);\n\n    if (\n      typeof parsed === \"object\" &&\n      parsed !== null &&\n      \"id\" in parsed &&\n      typeof (parsed as Record<string, unknown>).id === \"string\"\n    ) {\n      return parsed as VitNodeWSMessage;\n    }\n  } catch {\n    /* ignore non-JSON messages */\n  }\n\n  return undefined;\n};\n\n/**\n * Handle VitNode WebSockets for any Hono runtime that exposes\n * `upgradeWebSocket` (node.js `@hono/node-server`, Bun, ...).\n *\n * A single `/ws` connection is multiplexed across every registered socket.\n * Each message is an envelope `{ id, data }` where `id` is\n * `{pluginId}_{module}_{id}`. On every message this handler looks up the\n * registered WebSocket whose composed id matches and calls its `onMessage`\n * handler with the parsed `data` (and a `send` helper that wraps the reply in\n * the same envelope). The registered handlers receive the request\n * `Context<EnvVitNode>`, so they can reach the database, the authenticated\n * user, the logger, etc.\n *\n * The optional `createEvents` callback lets you add connection-level behavior\n * (`onOpen`, `onClose`, `onError`, or a fallback `onMessage` for messages that\n * do not match any registered socket) with access to the typed context.\n *\n * @example\n * ```ts\n * app.get(\"/ws\", upgradeWebSocket(handleVitNodeWebSocket()));\n * ```\n */\nexport function handleVitNodeWebSocket(\n  createEvents?: (c: Context<EnvVitNode>) => Promise<WSEvents> | WSEvents,\n) {\n  // Called once at boot when the app mounts `/ws`, so the admin integrations\n  // panel can report the WebSocket endpoint as active.\n  markWebSocketEnabled();\n\n  return async (c: Context<EnvVitNode>): Promise<WSEvents> => {\n    const inline = await createEvents?.(c);\n    const registered = c.get(\"core\")?.webSockets ?? [];\n    // Authenticated from the session cookie sent with the upgrade request, so\n    // the server can target this connection's user (e.g. for notifications).\n    const userId = c.get(\"user\")?.id ?? null;\n\n    return {\n      onOpen: (event, ws) => {\n        // Track the connection so the server can push messages to it.\n        wsRegistry.add(ws, userId);\n        inline?.onOpen?.(event, ws);\n      },\n      onClose: (event, ws) => {\n        wsRegistry.remove(ws);\n        inline?.onClose?.(event, ws);\n      },\n      onError: inline?.onError,\n      onMessage: (event, ws) => {\n        const message = parseMessage(event.data);\n        const target = message\n          ? registered.find(\n              webSocket => getWebSocketId(webSocket) === message.id,\n            )\n          : undefined;\n\n        if (message && target) {\n          const send = (data: unknown) => {\n            ws.send(\n              JSON.stringify({\n                id: message.id,\n                data,\n              } satisfies VitNodeWSMessage),\n            );\n          };\n\n          try {\n            Promise.resolve(\n              target.onMessage({ c, data: message.data, send, ws }),\n            ).catch((error: unknown) => {\n              // eslint-disable-next-line no-console\n              console.error(\"WebSocket handler error:\", error);\n            });\n          } catch (error) {\n            // eslint-disable-next-line no-console\n            console.error(\"WebSocket handler error:\", error);\n          }\n\n          return;\n        }\n\n        // Fall back to the connection-level handler for unmatched messages.\n        inline?.onMessage?.(event, ws);\n      },\n    };\n  };\n}\n"],"mappings":"iHAcA,MAAM,EAAgB,GAA+C,CAC/D,UAAO,GAAQ,SAEnB,GAAI,CACF,IAAM,EAAkB,KAAK,MAAM,CAAG,EAEtC,GACE,OAAO,GAAW,UAClB,GACA,OAAQ,GACR,OAAQ,EAAmC,IAAO,SAElD,OAAO,CAEX,MAAQ,CAER,CAGF,EAwBA,SAAgB,EACd,EACA,CAKA,OAFA,EAAqB,EAEd,KAAO,IAA8C,CAC1D,IAAM,EAAS,MAAM,IAAe,CAAC,EAC/B,EAAa,EAAE,IAAI,MAAM,CAAC,EAAE,YAAc,CAAC,EAG3C,EAAS,EAAE,IAAI,MAAM,CAAC,EAAE,IAAM,KAEpC,MAAO,CACL,QAAS,EAAO,IAAO,CAErB,EAAW,IAAI,EAAI,CAAM,EACzB,GAAQ,SAAS,EAAO,CAAE,CAC5B,EACA,SAAU,EAAO,IAAO,CACtB,EAAW,OAAO,CAAE,EACpB,GAAQ,UAAU,EAAO,CAAE,CAC7B,EACA,QAAS,GAAQ,QACjB,WAAY,EAAO,IAAO,CACxB,IAAM,EAAU,EAAa,EAAM,IAAI,EACjC,EAAS,EACX,EAAW,KACT,GAAa,EAAe,CAAS,IAAM,EAAQ,EACrD,EACA,IAAA,GAEJ,GAAI,GAAW,EAAQ,CACrB,IAAM,EAAQ,GAAkB,CAC9B,EAAG,KACD,KAAK,UAAU,CACb,GAAI,EAAQ,GACZ,MACF,CAA4B,CAC9B,CACF,EAEA,GAAI,CACF,QAAQ,QACN,EAAO,UAAU,CAAE,IAAG,KAAM,EAAQ,KAAM,OAAM,IAAG,CAAC,CACtD,CAAC,CAAC,MAAO,GAAmB,CAE1B,QAAQ,MAAM,2BAA4B,CAAK,CACjD,CAAC,CACH,OAAS,EAAO,CAEd,QAAQ,MAAM,2BAA4B,CAAK,CACjD,CAEA,MACF,CAGA,GAAQ,YAAY,EAAO,CAAE,CAC/B,CACF,CACF,CACF"}

package/dist/src/ws/manager.d.ts

@@ -1,14 +1,17 @@
-import type { VitNodeWSMessage } from "./types";
-export interface WebSocketManagerOptions {
-    onMessage: (message: VitNodeWSMessage) => void;
-    onReadyStateChange: (state: number) => void;
-    url: string;
+import { VitNodeWSMessage } from "./types.js";
+//#region src/ws/manager.d.ts
+interface WebSocketManagerOptions {
+  onMessage: (message: VitNodeWSMessage) => void;
+  onReadyStateChange: (state: number) => void;
+  url: string;
 }
-export interface WebSocketManager {
-    destroy: () => void;
-    getReadyState: () => number;
-    reconnect: () => void;
-    send: (message: VitNodeWSMessage) => void;
+interface WebSocketManager {
+  destroy: () => void;
+  getReadyState: () => number;
+  reconnect: () => void;
+  send: (message: VitNodeWSMessage) => void;
 }
-export declare const createWebSocketManager: ({ url, onMessage, onReadyStateChange, }: WebSocketManagerOptions) => WebSocketManager;
+declare const createWebSocketManager: ({ url, onMessage, onReadyStateChange }: WebSocketManagerOptions) => WebSocketManager;
+//#endregion
+export { WebSocketManager, WebSocketManagerOptions, createWebSocketManager };
 //# sourceMappingURL=manager.d.ts.map

package/dist/src/ws/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/ws/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAiBhD,MAAM,WAAW,uBAAuB;IAEtC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAE/C,kBAAkB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,EAAE,MAAM,MAAM,CAAC;IAM5B,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAC3C;AAkBD,eAAO,MAAM,sBAAsB,GAAI,yCAIpC,uBAAuB,KAAG,gBAmL5B,CAAC"}
+{"version":3,"file":"manager.d.ts","names":[],"sources":["../../../src/ws/manager.ts"],"mappings":";;UAiBiB;EAEf,YAAY,SAAS;EAErB,qBAAqB;EACrB;;UAGe;EACf;EACA;EAMA;EACA,OAAO,SAAS;;cAmBL,2BAA0B,KAAA,WAAA,sBAIpC,4BAA0B"}

package/dist/src/ws/manager.js

@@ -1 +1,2 @@
-const LEADER_LOCK="vitnode-ws-leader";const CHANNEL_NAME="vitnode-ws";const RECONNECT_DELAY=2e3;export const createWebSocketManager=({url,onMessage,onReadyStateChange})=>{let socket=null;let isLeader=false;let isDestroyed=false;let readyState=0;let releaseLeadership;let reconnectTimeout;const outgoingQueue=[];const channel=typeof BroadcastChannel==="undefined"?null:new BroadcastChannel(CHANNEL_NAME);const post=message=>channel?.postMessage(message);const setReadyState=state=>{readyState=state;onReadyStateChange(state)};const sendOverSocket=message=>{if(socket?.readyState===WebSocket.OPEN){socket.send(JSON.stringify(message))}else{outgoingQueue.push(message)}};const openSocket=()=>{if(isDestroyed)return;const ws=new WebSocket(url);socket=ws;ws.onopen=()=>{setReadyState(ws.readyState);post({payload:ws.readyState,type:"ready-state"});outgoingQueue.splice(0).forEach(message=>ws.send(JSON.stringify(message)))};ws.onmessage=event=>{if(typeof event.data!=="string")return;let message;try{message=JSON.parse(event.data)}catch{return}onMessage(message);post({payload:message,type:"message"})};ws.onclose=()=>{setReadyState(ws.readyState);post({payload:ws.readyState,type:"ready-state"});socket=null;if(!isDestroyed&&isLeader){reconnectTimeout=setTimeout(openSocket,RECONNECT_DELAY)}}};const becomeLeader=()=>{if(isDestroyed)return;isLeader=true;openSocket()};const reconnectLeader=()=>{if(!isLeader||isDestroyed)return;if(reconnectTimeout)clearTimeout(reconnectTimeout);if(socket){socket.onclose=null;socket.onerror=null;socket.onmessage=null;socket.onopen=null;socket.close();socket=null}openSocket()};const requestLeadership=()=>{if(typeof navigator==="undefined"||!navigator.locks||!channel){becomeLeader();return}void navigator.locks.request(LEADER_LOCK,{mode:"exclusive"},async()=>{becomeLeader();await new Promise(resolve=>{releaseLeadership=resolve})}).catch(()=>{becomeLeader()})};if(channel){channel.onmessage=event=>{const message=event.data;switch(message.type){case"message":onMessage(message.payload);break;case"ready-state":if(!isLeader)setReadyState(message.payload);break;case"reconnect":if(isLeader)reconnectLeader();break;case"request-state":if(isLeader)post({payload:readyState,type:"ready-state"});break;case"send":if(isLeader)sendOverSocket(message.payload);break}}}const send=message=>{if(isLeader||!channel){sendOverSocket(message)}else{post({payload:message,type:"send"})}};const reconnect=()=>{if(isLeader||!channel){reconnectLeader()}else{post({type:"reconnect"})}};requestLeadership();post({type:"request-state"});const destroy=()=>{isDestroyed=true;if(reconnectTimeout)clearTimeout(reconnectTimeout);socket?.close();socket=null;releaseLeadership?.();channel?.close()};return{destroy,getReadyState:()=>readyState,reconnect,send}};
+const e=({url:e,onMessage:t,onReadyStateChange:n})=>{let r=null,i=!1,a=!1,o=0,s,c,l=[],u=typeof BroadcastChannel>`u`?null:new BroadcastChannel(`vitnode-ws`),d=e=>u?.postMessage(e),f=e=>{o=e,n(e)},p=e=>{r?.readyState===WebSocket.OPEN?r.send(JSON.stringify(e)):l.push(e)},m=()=>{let n=new WebSocket(e);r=n,n.onopen=()=>{f(n.readyState),d({payload:n.readyState,type:`ready-state`}),l.splice(0).forEach(e=>n.send(JSON.stringify(e)))},n.onmessage=e=>{if(typeof e.data!=`string`)return;let n;try{n=JSON.parse(e.data)}catch{return}t(n),d({payload:n,type:`message`})},n.onclose=()=>{f(n.readyState),d({payload:n.readyState,type:`ready-state`}),r=null,!a&&i&&(c=setTimeout(m,2e3))}},h=()=>{a||(i=!0,m())},g=()=>{!i||a||(c&&clearTimeout(c),r&&=(r.onclose=null,r.onerror=null,r.onmessage=null,r.onopen=null,r.close(),null),m())};return u&&(u.onmessage=e=>{let n=e.data;switch(n.type){case`message`:t(n.payload);break;case`ready-state`:i||f(n.payload);break;case`reconnect`:i&&g();break;case`request-state`:i&&d({payload:o,type:`ready-state`});break;case`send`:i&&p(n.payload);break}}),(()=>{if(typeof navigator>`u`||!navigator.locks||!u){h();return}navigator.locks.request(`vitnode-ws-leader`,{mode:`exclusive`},async()=>{if(a)return;let e=new Promise(e=>{s=e});h(),await e}).catch(()=>{h()})})(),d({type:`request-state`}),{destroy:()=>{a=!0,c&&clearTimeout(c),r?.close(),r=null,s?.(),u?.close()},getReadyState:()=>o,reconnect:()=>{i||!u?g():d({type:`reconnect`})},send:e=>{i||!u?p(e):d({payload:e,type:`send`})}}};export{e as createWebSocketManager};
+//# sourceMappingURL=manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","names":[],"sources":["../../../src/ws/manager.ts"],"sourcesContent":["import type { VitNodeWSMessage } from \"./types\";\n\n/**\n * Messages exchanged between tabs of the same origin over the\n * {@link BroadcastChannel}.\n */\ntype CrossTabMessage =\n  | { payload: number; type: \"ready-state\" }\n  | { payload: VitNodeWSMessage; type: \"message\" }\n  | { payload: VitNodeWSMessage; type: \"send\" }\n  | { type: \"reconnect\" }\n  | { type: \"request-state\" };\n\nconst LEADER_LOCK = \"vitnode-ws-leader\";\nconst CHANNEL_NAME = \"vitnode-ws\";\nconst RECONNECT_DELAY = 2000;\n\nexport interface WebSocketManagerOptions {\n  /** Called once per logical server message, in every tab. */\n  onMessage: (message: VitNodeWSMessage) => void;\n  /** Called whenever the shared connection's `readyState` changes. */\n  onReadyStateChange: (state: number) => void;\n  url: string;\n}\n\nexport interface WebSocketManager {\n  destroy: () => void;\n  getReadyState: () => number;\n  /**\n   * Drop the shared connection and open a fresh one. The new socket\n   * re-runs the handshake, so the server re-reads the session cookie - use\n   * this after sign-in/sign-out so the connection's user changes.\n   */\n  reconnect: () => void;\n  send: (message: VitNodeWSMessage) => void;\n}\n\n/**\n * Manages a single WebSocket connection shared across every tab of the same\n * origin.\n *\n * One tab is elected \"leader\" via the Web Locks API and owns the actual socket;\n * the other tabs are \"followers\". Outgoing messages from followers are relayed\n * to the leader, and every incoming server message is fanned out to all tabs\n * over a {@link BroadcastChannel}. This means data is shared across tabs with\n * exactly one connection and no duplicated messages.\n *\n * When the leader tab closes, its Web Lock is released and a follower is\n * automatically promoted, re-opening the socket.\n *\n * If the browser lacks the Web Locks API or `BroadcastChannel`, the manager\n * gracefully falls back to a per-tab connection.\n */\nexport const createWebSocketManager = ({\n  url,\n  onMessage,\n  onReadyStateChange,\n}: WebSocketManagerOptions): WebSocketManager => {\n  let socket: null | WebSocket = null;\n  let isLeader = false;\n  let isDestroyed = false;\n  let readyState = 0; // WebSocket.CONNECTING\n  let releaseLeadership: (() => void) | undefined;\n  let reconnectTimeout: ReturnType<typeof setTimeout> | undefined;\n  const outgoingQueue: VitNodeWSMessage[] = [];\n\n  const channel =\n    typeof BroadcastChannel === \"undefined\"\n      ? null\n      : new BroadcastChannel(CHANNEL_NAME);\n\n  const post = (message: CrossTabMessage) => channel?.postMessage(message);\n\n  const setReadyState = (state: number) => {\n    readyState = state;\n    onReadyStateChange(state);\n  };\n\n  const sendOverSocket = (message: VitNodeWSMessage) => {\n    if (socket?.readyState === WebSocket.OPEN) {\n      socket.send(JSON.stringify(message));\n    } else {\n      // Buffer until the leader's socket is open.\n      outgoingQueue.push(message);\n    }\n  };\n\n  // --- Leader: owns the real socket ---------------------------------------\n  const openSocket = () => {\n    const ws = new WebSocket(url);\n    socket = ws;\n\n    ws.onopen = () => {\n      setReadyState(ws.readyState);\n      post({ payload: ws.readyState, type: \"ready-state\" });\n      outgoingQueue\n        .splice(0)\n        .forEach(message => ws.send(JSON.stringify(message)));\n    };\n\n    ws.onmessage = (event: MessageEvent) => {\n      if (typeof event.data !== \"string\") return;\n\n      let message: VitNodeWSMessage;\n      try {\n        message = JSON.parse(event.data) as VitNodeWSMessage;\n      } catch {\n        return;\n      }\n\n      onMessage(message); // this (leader) tab\n      post({ payload: message, type: \"message\" }); // every other tab\n    };\n\n    ws.onclose = () => {\n      setReadyState(ws.readyState);\n      post({ payload: ws.readyState, type: \"ready-state\" });\n      socket = null;\n      if (!isDestroyed && isLeader) {\n        reconnectTimeout = setTimeout(openSocket, RECONNECT_DELAY);\n      }\n    };\n  };\n\n  const becomeLeader = () => {\n    if (isDestroyed) return;\n    isLeader = true;\n    openSocket();\n  };\n\n  // Drop the current socket (without triggering its auto-reconnect) and open a\n  // fresh one immediately, so the handshake re-authenticates with the latest\n  // cookies. Only the leader owns a socket.\n  const reconnectLeader = () => {\n    if (!isLeader || isDestroyed) return;\n    if (reconnectTimeout) clearTimeout(reconnectTimeout);\n\n    if (socket) {\n      socket.onclose = null;\n      socket.onerror = null;\n      socket.onmessage = null;\n      socket.onopen = null;\n      socket.close();\n      socket = null;\n    }\n\n    openSocket();\n  };\n\n  // --- Leadership election via Web Locks ----------------------------------\n  const requestLeadership = () => {\n    if (typeof navigator === \"undefined\" || !navigator.locks || !channel) {\n      // No cross-tab primitives available: run a standalone connection.\n      becomeLeader();\n\n      return;\n    }\n\n    void navigator.locks\n      .request(LEADER_LOCK, { mode: \"exclusive\" }, async () => {\n        if (isDestroyed) return;\n\n        const held = new Promise<void>(resolve => {\n          releaseLeadership = resolve;\n        });\n        becomeLeader();\n        await held;\n      })\n      .catch(() => {\n        becomeLeader();\n      });\n  };\n\n  // --- Cross-tab message handling (leader + followers) --------------------\n  if (channel) {\n    channel.onmessage = (event: MessageEvent<CrossTabMessage>) => {\n      const message = event.data;\n\n      switch (message.type) {\n        case \"message\":\n          onMessage(message.payload);\n          break;\n        case \"ready-state\":\n          if (!isLeader) setReadyState(message.payload);\n          break;\n        case \"reconnect\":\n          if (isLeader) reconnectLeader();\n          break;\n        case \"request-state\":\n          if (isLeader) post({ payload: readyState, type: \"ready-state\" });\n          break;\n        case \"send\":\n          if (isLeader) sendOverSocket(message.payload);\n          break;\n      }\n    };\n  }\n\n  const send = (message: VitNodeWSMessage) => {\n    if (isLeader || !channel) {\n      sendOverSocket(message);\n    } else {\n      // Ask the leader tab to send on our behalf.\n      post({ payload: message, type: \"send\" });\n    }\n  };\n\n  const reconnect = () => {\n    if (isLeader || !channel) {\n      reconnectLeader();\n    } else {\n      // Ask the leader tab (which owns the socket) to reconnect.\n      post({ type: \"reconnect\" });\n    }\n  };\n\n  requestLeadership();\n  // In case we joined while another tab already owns an open connection.\n  post({ type: \"request-state\" });\n\n  const destroy = () => {\n    isDestroyed = true;\n    if (reconnectTimeout) clearTimeout(reconnectTimeout);\n    socket?.close();\n    socket = null;\n    releaseLeadership?.();\n    channel?.close();\n  };\n\n  return {\n    destroy,\n    getReadyState: () => readyState,\n    reconnect,\n    send,\n  };\n};\n"],"mappings":"AAaA,MAwCa,GAA0B,CACrC,MACA,YACA,wBAC+C,CAC/C,IAAI,EAA2B,KAC3B,EAAW,GACX,EAAc,GACd,EAAa,EACb,EACA,EACE,EAAoC,CAAC,EAErC,EACJ,OAAO,iBAAqB,IACxB,KACA,IAAI,iBAAiB,YAAY,EAEjC,EAAQ,GAA6B,GAAS,YAAY,CAAO,EAEjE,EAAiB,GAAkB,CACvC,EAAa,EACb,EAAmB,CAAK,CAC1B,EAEM,EAAkB,GAA8B,CAChD,GAAQ,aAAe,UAAU,KACnC,EAAO,KAAK,KAAK,UAAU,CAAO,CAAC,EAGnC,EAAc,KAAK,CAAO,CAE9B,EAGM,MAAmB,CACvB,IAAM,EAAK,IAAI,UAAU,CAAG,EAC5B,EAAS,EAET,EAAG,WAAe,CAChB,EAAc,EAAG,UAAU,EAC3B,EAAK,CAAE,QAAS,EAAG,WAAY,KAAM,aAAc,CAAC,EACpD,EACG,OAAO,CAAC,CAAC,CACT,QAAQ,GAAW,EAAG,KAAK,KAAK,UAAU,CAAO,CAAC,CAAC,CACxD,EAEA,EAAG,UAAa,GAAwB,CACtC,GAAI,OAAO,EAAM,MAAS,SAAU,OAEpC,IAAI,EACJ,GAAI,CACF,EAAU,KAAK,MAAM,EAAM,IAAI,CACjC,MAAQ,CACN,MACF,CAEA,EAAU,CAAO,EACjB,EAAK,CAAE,QAAS,EAAS,KAAM,SAAU,CAAC,CAC5C,EAEA,EAAG,YAAgB,CACjB,EAAc,EAAG,UAAU,EAC3B,EAAK,CAAE,QAAS,EAAG,WAAY,KAAM,aAAc,CAAC,EACpD,EAAS,KACL,CAAC,GAAe,IAClB,EAAmB,WAAW,EAAY,GAAe,EAE7D,CACF,EAEM,MAAqB,CACrB,IACJ,EAAW,GACX,EAAW,EACb,EAKM,MAAwB,CACxB,CAAC,GAAY,IACb,GAAkB,aAAa,CAAgB,EAEnD,AAME,KALA,EAAO,QAAU,KACjB,EAAO,QAAU,KACjB,EAAO,UAAY,KACnB,EAAO,OAAS,KAChB,EAAO,MAAM,EACJ,MAGX,EAAW,EACb,EAkFA,OAvDI,IACF,EAAQ,UAAa,GAAyC,CAC5D,IAAM,EAAU,EAAM,KAEtB,OAAQ,EAAQ,KAAhB,CACE,IAAK,UACH,EAAU,EAAQ,OAAO,EACzB,MACF,IAAK,cACE,GAAU,EAAc,EAAQ,OAAO,EAC5C,MACF,IAAK,YACC,GAAU,EAAgB,EAC9B,MACF,IAAK,gBACC,GAAU,EAAK,CAAE,QAAS,EAAY,KAAM,aAAc,CAAC,EAC/D,MACF,IAAK,OACC,GAAU,EAAe,EAAQ,OAAO,EAC5C,KACJ,CACF,QA7C8B,CAC9B,GAAI,OAAO,UAAc,KAAe,CAAC,UAAU,OAAS,CAAC,EAAS,CAEpE,EAAa,EAEb,MACF,CAEA,UAAe,MACZ,QAAQ,oBAAa,CAAE,KAAM,WAAY,EAAG,SAAY,CACvD,GAAI,EAAa,OAEjB,IAAM,EAAO,IAAI,QAAc,GAAW,CACxC,EAAoB,CACtB,CAAC,EACD,EAAa,EACb,MAAM,CACR,CAAC,CAAC,CACD,UAAY,CACX,EAAa,CACf,CAAC,CACL,EA6CA,CAAkB,EAElB,EAAK,CAAE,KAAM,eAAgB,CAAC,EAWvB,CACL,YAVoB,CACpB,EAAc,GACV,GAAkB,aAAa,CAAgB,EACnD,GAAQ,MAAM,EACd,EAAS,KACT,IAAoB,EACpB,GAAS,MAAM,CACjB,EAIE,kBAAqB,EACrB,cAzBsB,CAClB,GAAY,CAAC,EACf,EAAgB,EAGhB,EAAK,CAAE,KAAM,WAAY,CAAC,CAE9B,EAmBE,KAnCY,GAA8B,CACtC,GAAY,CAAC,EACf,EAAe,CAAO,EAGtB,EAAK,CAAE,QAAS,EAAS,KAAM,MAAO,CAAC,CAE3C,CA6BA,CACF"}

package/dist/src/ws/notifications.d.ts

@@ -1,8 +1,12 @@
-export type VitNodeNotificationType = "error" | "info" | "success" | "warning";
-export interface VitNodeNotification {
-    description?: string;
-    title: string;
-    type?: VitNodeNotificationType;
+import { VitNodeWSChannel } from "./types.js";
+//#region src/ws/notifications.d.ts
+type VitNodeNotificationType = "error" | "info" | "success" | "warning";
+interface VitNodeNotification {
+  description?: string;
+  title: string;
+  type?: VitNodeNotificationType;
 }
-export declare const notificationsChannel: import("./types").VitNodeWSChannel<never, VitNodeNotification>;
+declare const notificationsChannel: VitNodeWSChannel<never, VitNodeNotification>;
+//#endregion
+export { VitNodeNotification, VitNodeNotificationType, notificationsChannel };
 //# sourceMappingURL=notifications.d.ts.map

package/dist/src/ws/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../src/ws/notifications.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,uBAAuB,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;AAG/E,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,uBAAuB,CAAC;CAChC;AASD,eAAO,MAAM,oBAAoB,gEAO/B,CAAC"}
+{"version":3,"file":"notifications.d.ts","names":[],"sources":["../../../src/ws/notifications.ts"],"mappings":";;KAIY;UAGK;EACf;EACA;EACA,OAAO;;cAUI,sBAAoB,wBAAA"}

package/dist/src/ws/notifications.js

@@ -1 +1,2 @@
-import{CONFIG_PLUGIN}from"../config.js";import{createWebSocketChannel}from"./types.js";export const notificationsChannel=createWebSocketChannel({id:"inbox",module:"notifications",pluginId:CONFIG_PLUGIN.pluginId});
+import{CONFIG_PLUGIN as e}from"../config.js";import{createWebSocketChannel as t}from"./types.js";const n=t({id:`inbox`,module:`notifications`,pluginId:e.pluginId});export{n as notificationsChannel};
+//# sourceMappingURL=notifications.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","names":[],"sources":["../../../src/ws/notifications.ts"],"sourcesContent":["import { CONFIG_PLUGIN } from \"@/config\";\n\nimport { createWebSocketChannel } from \"./types\";\n\nexport type VitNodeNotificationType = \"error\" | \"info\" | \"success\" | \"warning\";\n\n/** A notification pushed to a single user over the WebSocket. */\nexport interface VitNodeNotification {\n  description?: string;\n  title: string;\n  type?: VitNodeNotificationType;\n}\n\n/**\n * Per-user notification channel. Every user subscribes to the same id, but the\n * server delivers each notification only to the target user's connections (see\n * `realtime.sendToUser`), so notifications never leak to other users.\n *\n * Public id: `@vitnode/core_notifications_inbox`.\n */\nexport const notificationsChannel = createWebSocketChannel<\n  never,\n  VitNodeNotification\n>({\n  id: \"inbox\",\n  module: \"notifications\",\n  pluginId: CONFIG_PLUGIN.pluginId,\n});\n"],"mappings":"iGAoBA,MAAa,EAAuB,EAGlC,CACA,GAAI,QACJ,OAAQ,gBACR,SAAU,EAAc,QAC1B,CAAC"}

package/dist/src/ws/provider.d.ts

@@ -1,14 +1,16 @@
 import React from "react";
+//#region src/ws/provider.d.ts
 type Listener = (data: unknown) => void;
 interface VitNodeWebSocketContextValue {
-    readyState: number;
-    reconnect: () => void;
-    send: (id: string, data: unknown) => void;
-    subscribe: (id: string, listener: Listener) => () => void;
+  readyState: number;
+  reconnect: () => void;
+  send: (id: string, data: unknown) => void;
+  subscribe: (id: string, listener: Listener) => () => void;
 }
-export declare const useVitNodeWebSocketContext: () => VitNodeWebSocketContextValue;
-export declare const VitNodeWebSocketProvider: ({ children, }: {
-    children: React.ReactNode;
+declare const useVitNodeWebSocketContext: () => VitNodeWebSocketContextValue;
+declare const VitNodeWebSocketProvider: ({ children }: {
+  children: React.ReactNode;
 }) => React.JSX.Element;
-export {};
+//#endregion
+export { VitNodeWebSocketProvider, useVitNodeWebSocketContext };
 //# sourceMappingURL=provider.d.ts.map

package/dist/src/ws/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/ws/provider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,KAAK,QAAQ,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAExC,UAAU,4BAA4B;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC1C,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,MAAM,IAAI,CAAC;CAC3D;AAKD,eAAO,MAAM,0BAA0B,QAAO,4BAS7C,CAAC;AAiBF,eAAO,MAAM,wBAAwB,GAAI,eAEtC;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,sBAoEA,CAAC"}
+{"version":3,"file":"provider.d.ts","names":[],"sources":["../../../src/ws/provider.tsx"],"mappings":";;KAWK,YAAY;UAEP;EACR;EACA;EACA,OAAO,YAAY;EACnB,YAAY,YAAY,UAAU;;cAMvB,kCAAiC;cA8BjC,6BAA4B;EAGvC,UAAU,MAAM;MACjB,MAAA,IAAA"}

package/dist/src/ws/provider.js

@@ -1 +1,2 @@
-"use client";import{jsx as _jsx}from"react/jsx-runtime";import React from"react";import{CONFIG}from"../lib/config.js";import{createWebSocketManager}from"./manager.js";const VitNodeWebSocketContext=React.createContext(null);export const useVitNodeWebSocketContext=()=>{const context=React.use(VitNodeWebSocketContext);if(!context){throw new Error("useVitNodeWebSocket must be used within a <VitNodeWebSocketProvider>.")}return context};const getWebSocketUrl=()=>{const url=new URL("/api/ws",CONFIG.api);url.protocol=url.protocol==="https:"?"wss:":"ws:";return url.toString()};export const VitNodeWebSocketProvider=({children})=>{const listenersRef=React.useRef(new Map);const managerRef=React.useRef(null);const pendingSendRef=React.useRef([]);const[readyState,setReadyState]=React.useState(typeof WebSocket!=="undefined"?WebSocket.CONNECTING:0);const dispatch=React.useCallback(message=>{listenersRef.current.get(message.id)?.forEach(listener=>listener(message.data))},[]);React.useEffect(()=>{const manager=createWebSocketManager({url:getWebSocketUrl(),onMessage:dispatch,onReadyStateChange:setReadyState});managerRef.current=manager;pendingSendRef.current.splice(0).forEach(message=>manager.send(message));return()=>{manager.destroy();managerRef.current=null}},[dispatch]);const subscribe=React.useCallback((id,listener)=>{const listeners=listenersRef.current.get(id)??new Set;listeners.add(listener);listenersRef.current.set(id,listeners);return()=>{listeners.delete(listener);if(listeners.size===0){listenersRef.current.delete(id)}}},[]);const send=React.useCallback((id,data)=>{const message={data,id};const manager=managerRef.current;if(manager){manager.send(message)}else{pendingSendRef.current.push(message)}},[]);const reconnect=React.useCallback(()=>{managerRef.current?.reconnect()},[]);const value=React.useMemo(()=>({readyState,reconnect,send,subscribe}),[readyState,reconnect,send,subscribe]);return _jsx(VitNodeWebSocketContext.Provider,{value:value,children:children})};
+"use client";import{CONFIG as e}from"../lib/config.js";import{createWebSocketManager as t}from"./manager.js";import{jsx as n}from"react/jsx-runtime";import r from"react";const i=r.createContext(null),a=()=>{let e=r.use(i);if(!e)throw Error(`useVitNodeWebSocket must be used within a <VitNodeWebSocketProvider>.`);return e},o=()=>{let t=new URL(`/api/ws`,e.api);return t.protocol=t.protocol===`https:`?`wss:`:`ws:`,t.toString()},s=()=>e.api.pathname!==e.web.pathname||e.api.port!==e.web.port,c=({children:e})=>{let a=r.useRef(new Map),c=r.useRef(null),l=r.useRef([]),[u,d]=r.useState(()=>typeof WebSocket>`u`?0:s()?WebSocket.CONNECTING:WebSocket.CLOSED),f=r.useCallback(e=>{a.current.get(e.id)?.forEach(t=>t(e.data))},[]);r.useEffect(()=>{if(!s())return;let e=t({url:o(),onMessage:f,onReadyStateChange:d});return c.current=e,l.current.splice(0).forEach(t=>e.send(t)),()=>{e.destroy(),c.current=null}},[f]);let p=r.useCallback((e,t)=>{let n=a.current.get(e)??new Set;return n.add(t),a.current.set(e,n),()=>{n.delete(t),n.size===0&&a.current.delete(e)}},[]),m=r.useCallback((e,t)=>{let n={data:t,id:e},r=c.current;r?r.send(n):l.current.push(n)},[]),h=r.useCallback(()=>{c.current?.reconnect()},[]),g=r.useMemo(()=>({readyState:u,reconnect:h,send:m,subscribe:p}),[u,h,m,p]);return n(i.Provider,{value:g,children:e})};export{c as VitNodeWebSocketProvider,a as useVitNodeWebSocketContext};
+//# sourceMappingURL=provider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","names":[],"sources":["../../../src/ws/provider.tsx"],"sourcesContent":["\"use client\";\n\nimport React from \"react\";\n\nimport { CONFIG } from \"@/lib/config\";\n\nimport type { WebSocketManager } from \"./manager\";\nimport type { VitNodeWSMessage } from \"./types\";\n\nimport { createWebSocketManager } from \"./manager\";\n\ntype Listener = (data: unknown) => void;\n\ninterface VitNodeWebSocketContextValue {\n  readyState: number;\n  reconnect: () => void;\n  send: (id: string, data: unknown) => void;\n  subscribe: (id: string, listener: Listener) => () => void;\n}\n\nconst VitNodeWebSocketContext =\n  React.createContext<null | VitNodeWebSocketContextValue>(null);\n\nexport const useVitNodeWebSocketContext = (): VitNodeWebSocketContextValue => {\n  const context = React.use(VitNodeWebSocketContext);\n  if (!context) {\n    throw new Error(\n      \"useVitNodeWebSocket must be used within a <VitNodeWebSocketProvider>.\",\n    );\n  }\n\n  return context;\n};\n\nconst getWebSocketUrl = (): string => {\n  const url = new URL(\"/api/ws\", CONFIG.api);\n  url.protocol = url.protocol === \"https:\" ? \"wss:\" : \"ws:\";\n\n  return url.toString();\n};\n\nconst shouldConnectWebSocket = (): boolean =>\n  CONFIG.api.pathname !== CONFIG.web.pathname ||\n  CONFIG.api.port !== CONFIG.web.port;\n\n/**\n * Opens a single, always-on WebSocket connection to `/api/ws` and multiplexes\n * it across every {@link useVitNodeWebSocket} subscriber by message id.\n *\n * The connection is shared across all tabs of the same origin (one leader tab\n * owns the socket, the rest relay through it), so messages are delivered to\n * every tab. See {@link createWebSocketManager}.\n */\nexport const VitNodeWebSocketProvider = ({\n  children,\n}: {\n  children: React.ReactNode;\n}) => {\n  const listenersRef = React.useRef<Map<string, Set<Listener>>>(new Map());\n  const managerRef = React.useRef<null | WebSocketManager>(null);\n  const pendingSendRef = React.useRef<VitNodeWSMessage[]>([]);\n  const [readyState, setReadyState] = React.useState<number>(() => {\n    if (typeof WebSocket === \"undefined\") return 0;\n\n    return shouldConnectWebSocket() ? WebSocket.CONNECTING : WebSocket.CLOSED;\n  });\n\n  const dispatch = React.useCallback((message: VitNodeWSMessage) => {\n    listenersRef.current\n      .get(message.id)\n      ?.forEach(listener => listener(message.data));\n  }, []);\n\n  React.useEffect(() => {\n    if (!shouldConnectWebSocket()) return;\n\n    const manager = createWebSocketManager({\n      url: getWebSocketUrl(),\n      onMessage: dispatch,\n      onReadyStateChange: setReadyState,\n    });\n    managerRef.current = manager;\n    // Flush anything sent before the manager was ready.\n    pendingSendRef.current.splice(0).forEach(message => manager.send(message));\n\n    return () => {\n      manager.destroy();\n      managerRef.current = null;\n    };\n  }, [dispatch]);\n\n  const subscribe = React.useCallback((id: string, listener: Listener) => {\n    const listeners = listenersRef.current.get(id) ?? new Set<Listener>();\n    listeners.add(listener);\n    listenersRef.current.set(id, listeners);\n\n    return () => {\n      listeners.delete(listener);\n      if (listeners.size === 0) {\n        listenersRef.current.delete(id);\n      }\n    };\n  }, []);\n\n  const send = React.useCallback((id: string, data: unknown) => {\n    const message: VitNodeWSMessage = { data, id };\n    const manager = managerRef.current;\n\n    if (manager) {\n      manager.send(message);\n    } else {\n      pendingSendRef.current.push(message);\n    }\n  }, []);\n\n  const reconnect = React.useCallback(() => {\n    managerRef.current?.reconnect();\n  }, []);\n\n  const value = React.useMemo<VitNodeWebSocketContextValue>(\n    () => ({ readyState, reconnect, send, subscribe }),\n    [readyState, reconnect, send, subscribe],\n  );\n\n  return (\n    <VitNodeWebSocketContext.Provider value={value}>\n      {children}\n    </VitNodeWebSocketContext.Provider>\n  );\n};\n"],"mappings":"0KAoBA,MAAM,EACJ,EAAM,cAAmD,IAAI,EAElD,MAAiE,CAC5E,IAAM,EAAU,EAAM,IAAI,CAAuB,EACjD,GAAI,CAAC,EACH,MAAU,MACR,uEACF,EAGF,OAAO,CACT,EAEM,MAAgC,CACpC,IAAM,EAAM,IAAI,IAAI,UAAW,EAAO,GAAG,EAGzC,MAFA,GAAI,SAAW,EAAI,WAAa,SAAW,OAAS,MAE7C,EAAI,SAAS,CACtB,EAEM,MACJ,EAAO,IAAI,WAAa,EAAO,IAAI,UACnC,EAAO,IAAI,OAAS,EAAO,IAAI,KAUpB,GAA4B,CACvC,cAGI,CACJ,IAAM,EAAe,EAAM,OAAmC,IAAI,GAAK,EACjE,EAAa,EAAM,OAAgC,IAAI,EACvD,EAAiB,EAAM,OAA2B,CAAC,CAAC,EACpD,CAAC,EAAY,GAAiB,EAAM,aACpC,OAAO,UAAc,IAAoB,EAEtC,EAAuB,EAAI,UAAU,WAAa,UAAU,MACpE,EAEK,EAAW,EAAM,YAAa,GAA8B,CAChE,EAAa,QACV,IAAI,EAAQ,EAAE,CAAC,EACd,QAAQ,GAAY,EAAS,EAAQ,IAAI,CAAC,CAChD,EAAG,CAAC,CAAC,EAEL,EAAM,cAAgB,CACpB,GAAI,CAAC,EAAuB,EAAG,OAE/B,IAAM,EAAU,EAAuB,CACrC,IAAK,EAAgB,EACrB,UAAW,EACX,mBAAoB,CACtB,CAAC,EAKD,MAJA,GAAW,QAAU,EAErB,EAAe,QAAQ,OAAO,CAAC,CAAC,CAAC,QAAQ,GAAW,EAAQ,KAAK,CAAO,CAAC,MAE5D,CACX,EAAQ,QAAQ,EAChB,EAAW,QAAU,IACvB,CACF,EAAG,CAAC,CAAQ,CAAC,EAEb,IAAM,EAAY,EAAM,aAAa,EAAY,IAAuB,CACtE,IAAM,EAAY,EAAa,QAAQ,IAAI,CAAE,GAAK,IAAI,IAItD,OAHA,EAAU,IAAI,CAAQ,EACtB,EAAa,QAAQ,IAAI,EAAI,CAAS,MAEzB,CACX,EAAU,OAAO,CAAQ,EACrB,EAAU,OAAS,GACrB,EAAa,QAAQ,OAAO,CAAE,CAElC,CACF,EAAG,CAAC,CAAC,EAEC,EAAO,EAAM,aAAa,EAAY,IAAkB,CAC5D,IAAM,EAA4B,CAAE,OAAM,IAAG,EACvC,EAAU,EAAW,QAEvB,EACF,EAAQ,KAAK,CAAO,EAEpB,EAAe,QAAQ,KAAK,CAAO,CAEvC,EAAG,CAAC,CAAC,EAEC,EAAY,EAAM,gBAAkB,CACxC,EAAW,SAAS,UAAU,CAChC,EAAG,CAAC,CAAC,EAEC,EAAQ,EAAM,aACX,CAAE,aAAY,YAAW,OAAM,WAAU,GAChD,CAAC,EAAY,EAAW,EAAM,CAAS,CACzC,EAEA,OACE,EAAC,EAAwB,SAAzB,CAAyC,QACtC,UAC+B,CAAA,CAEtC"}

package/dist/src/ws/registry.d.ts

@@ -1,14 +1,22 @@
-import type { WSContext } from "hono/ws";
-import type { VitNodeWSChannel } from "./types";
-export declare const wsRegistry: {
-    add: (ws: WSContext, userId: null | number) => void;
-    broadcast: (id: string, data: unknown) => void;
-    remove: (ws: WSContext) => void;
-    sendToUser: (userId: number, id: string, data: unknown) => void;
+import { VitNodeWSChannel } from "./types.js";
+import { Redis } from "ioredis";
+import { WSContext } from "hono/ws";
+//#region src/ws/registry.d.ts
+declare const markWebSocketEnabled: () => void;
+declare const isWebSocketEnabled: () => boolean;
+declare const wsRegistry: {
+  add: (ws: WSContext, userId: null | number) => void;
+  broadcast: (id: string, data: unknown) => void;
+  remove: (ws: WSContext) => void;
+  sendToUser: (userId: number, id: string, data: unknown) => void;
 };
-export interface VitNodeRealtime {
-    broadcast: <Receive>(channel: VitNodeWSChannel<unknown, Receive>, data: Receive) => void;
-    sendToUser: <Receive>(userId: number, channel: VitNodeWSChannel<unknown, Receive>, data: Receive) => void;
+declare const isRealtimePubSubEnabled: () => boolean;
+declare const initRealtimePubSub: (client: null | Redis) => void;
+interface VitNodeRealtime {
+  broadcast: <Receive>(channel: VitNodeWSChannel<unknown, Receive>, data: Receive) => void;
+  sendToUser: <Receive>(userId: number, channel: VitNodeWSChannel<unknown, Receive>, data: Receive) => void;
 }
-export declare const realtime: VitNodeRealtime;
+declare const realtime: VitNodeRealtime;
+//#endregion
+export { VitNodeRealtime, initRealtimePubSub, isRealtimePubSubEnabled, isWebSocketEnabled, markWebSocketEnabled, realtime, wsRegistry };
 //# sourceMappingURL=registry.d.ts.map

package/dist/src/ws/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/ws/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,SAAS,CAAC;AAsBlE,eAAO,MAAM,UAAU;cACX,SAAS,UAAU,IAAI,GAAG,MAAM,KAAG,IAAI;oBAIjC,MAAM,QAAQ,OAAO,KAAG,IAAI;iBAG/B,SAAS,KAAG,IAAI;yBAIR,MAAM,MAAM,MAAM,QAAQ,OAAO,KAAG,IAAI;CAK9D,CAAC;AAEF,MAAM,WAAW,eAAe;IAM9B,SAAS,EAAE,CAAC,OAAO,EACjB,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC3C,IAAI,EAAE,OAAO,KACV,IAAI,CAAC;IAKV,UAAU,EAAE,CAAC,OAAO,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,EAC3C,IAAI,EAAE,OAAO,KACV,IAAI,CAAC;CACX;AAKD,eAAO,MAAM,QAAQ,EAAE,eAOtB,CAAC"}
+{"version":3,"file":"registry.d.ts","names":[],"sources":["../../../src/ws/registry.ts"],"mappings":";;;;cA2Ba;cAKA;cAUA;YACD,WAAS;0BAIG;eAGT;+BAIc,YAAY;;cA0B5B;cAyCA,qBAAsB,eAAe;UAgCjC;EAMf,YAAY,SACV,SAAS,0BAA0B,UACnC,MAAM;EAMR,aAAa,SACX,gBACA,SAAS,0BAA0B,UACnC,MAAM;;cAWG,UAAU"}

package/dist/src/ws/registry.js

@@ -1 +1,2 @@
-const connections=new Map;const sendTo=(ws,id,data)=>{try{ws.send(JSON.stringify({data,id}))}catch(_error){wsRegistry.remove(ws)}};export const wsRegistry={add:(ws,userId)=>{connections.set(ws,userId)},broadcast:(id,data)=>{connections.forEach((_userId,ws)=>sendTo(ws,id,data))},remove:ws=>{connections.delete(ws)},sendToUser:(userId,id,data)=>{connections.forEach((connectionUserId,ws)=>{if(connectionUserId===userId)sendTo(ws,id,data)})}};export const realtime={broadcast:(channel,data)=>{wsRegistry.broadcast(channel.id,data)},sendToUser:(userId,channel,data)=>{wsRegistry.sendToUser(userId,channel.id,data)}};
+const e=new Map;let t=!1;const n=()=>{t=!0},r=()=>t,i=(e,t,n)=>{try{e.send(JSON.stringify({data:n,id:t}))}catch{a.remove(e)}},a={add:(t,n)=>{e.set(t,n)},broadcast:(t,n)=>{e.forEach((e,r)=>i(r,t,n))},remove:t=>{e.delete(t)},sendToUser:(t,n,r)=>{e.forEach((e,a)=>{e===t&&i(a,n,r)})}},o=`vitnode:ws`,s=crypto.randomUUID();let c=null;const l=()=>c!==null,u=e=>{e.type===`broadcast`?a.broadcast(e.id,e.data):e.type===`sendToUser`&&typeof e.userId==`number`&&a.sendToUser(e.userId,e.id,e.data)},d=e=>{c&&c.publish(o,JSON.stringify({...e,origin:s})).catch(()=>{})},f=e=>{if(!e||c)return;c=e;let t=e.duplicate();t.on(`error`,()=>{}),t.on(`ready`,()=>{t.subscribe(o).catch(()=>{})}),t.on(`message`,(e,t)=>{if(e===o)try{let e=JSON.parse(t);if(e.origin===s)return;u(e)}catch{}})},p={broadcast:(e,t)=>{a.broadcast(e.id,t),d({data:t,id:e.id,type:`broadcast`})},sendToUser:(e,t,n)=>{a.sendToUser(e,t.id,n),d({data:n,id:t.id,type:`sendToUser`,userId:e})}};export{f as initRealtimePubSub,l as isRealtimePubSubEnabled,r as isWebSocketEnabled,n as markWebSocketEnabled,p as realtime,a as wsRegistry};
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../../src/ws/registry.ts"],"sourcesContent":["import type { WSContext } from \"hono/ws\";\nimport type { Redis } from \"ioredis\";\n\nimport type { VitNodeWSChannel, VitNodeWSMessage } from \"./types\";\n\n/**\n * In-memory registry of the WebSocket connections open on the current server\n * process, used to push messages to clients. Each connection is tagged with the\n * id of the authenticated user it belongs to (or `null` when anonymous), so a\n * payload can be delivered to a single user across all of their browsers.\n *\n * This map is per-process. When several instances run behind a load balancer,\n * {@link initRealtimePubSub} bridges them with Redis pub/sub so `broadcast` and\n * `sendToUser` also reach clients connected to the other instances.\n */\nconst connections = new Map<WSContext, null | number>();\n\n/**\n * Flipped to `true` the first time the app mounts the WebSocket handler (see\n * {@link markWebSocketEnabled}). WebSockets are wired up outside `VitNodeAPI`\n * (the app calls `upgradeWebSocket(handleVitNodeWebSocket())`), so this is the\n * only reliable signal of whether the `/ws` endpoint exists in a given\n * deployment. Read by the admin integrations panel.\n */\nlet webSocketEnabled = false;\n\n/** Called once when the app mounts the `/ws` handler. */\nexport const markWebSocketEnabled = (): void => {\n  webSocketEnabled = true;\n};\n\n/** Whether the app mounted the WebSocket `/ws` handler. */\nexport const isWebSocketEnabled = (): boolean => webSocketEnabled;\n\nconst sendTo = (ws: WSContext, id: string, data: unknown): void => {\n  try {\n    ws.send(JSON.stringify({ data, id } satisfies VitNodeWSMessage));\n  } catch (_error) {\n    wsRegistry.remove(ws);\n  }\n};\n\nexport const wsRegistry = {\n  add: (ws: WSContext, userId: null | number): void => {\n    connections.set(ws, userId);\n  },\n  /** Send `{ id, data }` to every open connection. */\n  broadcast: (id: string, data: unknown): void => {\n    connections.forEach((_userId, ws) => sendTo(ws, id, data));\n  },\n  remove: (ws: WSContext): void => {\n    connections.delete(ws);\n  },\n  /** Send `{ id, data }` only to the connections owned by `userId`. */\n  sendToUser: (userId: number, id: string, data: unknown): void => {\n    connections.forEach((connectionUserId, ws) => {\n      if (connectionUserId === userId) sendTo(ws, id, data);\n    });\n  },\n};\n\n/**\n * Redis pub/sub channel every instance publishes realtime messages to and\n * subscribes for, so a `broadcast`/`sendToUser` reaches clients connected to\n * other instances behind a load balancer.\n */\nconst REALTIME_PUBSUB_CHANNEL = \"vitnode:ws\";\n\n/**\n * Unique per process. Tagged onto every published message so the instance that\n * sent it can ignore its own echo (it already delivered to its local clients).\n */\nconst instanceId = crypto.randomUUID();\n\nlet publisher: null | Redis = null;\n\n/**\n * Whether the Redis pub/sub bridge for cross-instance realtime is active. When\n * `false`, `broadcast`/`sendToUser` only reach clients on the current instance.\n */\nexport const isRealtimePubSubEnabled = (): boolean => publisher !== null;\n\ninterface RealtimePubSubMessage {\n  data: unknown;\n  id: string;\n  origin: string;\n  type: \"broadcast\" | \"sendToUser\";\n  userId?: number;\n}\n\nconst deliverLocally = (message: RealtimePubSubMessage): void => {\n  if (message.type === \"broadcast\") {\n    wsRegistry.broadcast(message.id, message.data);\n  } else if (\n    message.type === \"sendToUser\" &&\n    typeof message.userId === \"number\"\n  ) {\n    wsRegistry.sendToUser(message.userId, message.id, message.data);\n  }\n};\n\nconst publish = (message: Omit<RealtimePubSubMessage, \"origin\">): void => {\n  if (!publisher) return;\n\n  void publisher\n    .publish(\n      REALTIME_PUBSUB_CHANNEL,\n      JSON.stringify({ ...message, origin: instanceId }),\n    )\n    .catch(() => {\n      // Other instances miss this message, but the local clients were already\n      // served directly, so realtime keeps working on this instance.\n    });\n};\n\n/**\n * Enable cross-instance realtime delivery using Redis pub/sub. Call once at\n * boot with the shared cache client (see `VitNodeAPI`). Passing `null` (Redis\n * not configured) keeps realtime in single-process mode - messages then only\n * reach clients connected to the current instance.\n */\nexport const initRealtimePubSub = (client: null | Redis): void => {\n  // No-op without Redis, or if already initialized.\n  if (!client || publisher) return;\n\n  publisher = client;\n\n  // A connection in subscribe mode can't run other commands, so use a\n  // dedicated duplicate for receiving. Subscribing on \"ready\" (re)subscribes on\n  // the first connect and after every reconnect.\n  const subscriber = client.duplicate();\n  subscriber.on(\"error\", () => {\n    // Connection errors are non-fatal; local delivery still works.\n  });\n  subscriber.on(\"ready\", () => {\n    void subscriber.subscribe(REALTIME_PUBSUB_CHANNEL).catch(() => {\n      // Will retry on the next reconnect.\n    });\n  });\n  subscriber.on(\"message\", (channel, raw) => {\n    if (channel !== REALTIME_PUBSUB_CHANNEL) return;\n\n    try {\n      const message = JSON.parse(raw) as RealtimePubSubMessage;\n      // Skip our own echo - the publishing instance already delivered locally.\n      if (message.origin === instanceId) return;\n      deliverLocally(message);\n    } catch {\n      // Ignore malformed payloads.\n    }\n  });\n};\n\nexport interface VitNodeRealtime {\n  /**\n   * Push a payload to **every** client subscribed to `channel`. Delivered to\n   * the matching {@link useVitNodeWebSocket} subscribers (only views currently\n   * on screen react). Use for non-sensitive \"data changed\" signals.\n   */\n  broadcast: <Receive>(\n    channel: VitNodeWSChannel<unknown, Receive>,\n    data: Receive,\n  ) => void;\n  /**\n   * Push a payload only to the connections of a single user, across all of\n   * their browsers/devices. Use for per-user data such as notifications.\n   */\n  sendToUser: <Receive>(\n    userId: number,\n    channel: VitNodeWSChannel<unknown, Receive>,\n    data: Receive,\n  ) => void;\n}\n\n/**\n * The realtime helper exposed on the request context as `c.get(\"realtime\")`.\n *\n * Each call delivers to this instance's clients immediately, then (when Redis\n * pub/sub is enabled via {@link initRealtimePubSub}) fans the message out to the\n * other instances so their clients receive it too.\n */\nexport const realtime: VitNodeRealtime = {\n  broadcast: (channel, data) => {\n    wsRegistry.broadcast(channel.id, data);\n    publish({ data, id: channel.id, type: \"broadcast\" });\n  },\n  sendToUser: (userId, channel, data) => {\n    wsRegistry.sendToUser(userId, channel.id, data);\n    publish({ data, id: channel.id, type: \"sendToUser\", userId });\n  },\n};\n"],"mappings":"AAeA,MAAM,EAAc,IAAI,IASxB,IAAI,EAAmB,GAGvB,MAAa,MAAmC,CAC9C,EAAmB,EACrB,EAGa,MAAoC,EAE3C,GAAU,EAAe,EAAY,IAAwB,CACjE,GAAI,CACF,EAAG,KAAK,KAAK,UAAU,CAAE,OAAM,IAAG,CAA4B,CAAC,CACjE,MAAiB,CACf,EAAW,OAAO,CAAE,CACtB,CACF,EAEa,EAAa,CACxB,KAAM,EAAe,IAAgC,CACnD,EAAY,IAAI,EAAI,CAAM,CAC5B,EAEA,WAAY,EAAY,IAAwB,CAC9C,EAAY,SAAS,EAAS,IAAO,EAAO,EAAI,EAAI,CAAI,CAAC,CAC3D,EACA,OAAS,GAAwB,CAC/B,EAAY,OAAO,CAAE,CACvB,EAEA,YAAa,EAAgB,EAAY,IAAwB,CAC/D,EAAY,SAAS,EAAkB,IAAO,CACxC,IAAqB,GAAQ,EAAO,EAAI,EAAI,CAAI,CACtD,CAAC,CACH,CACF,EAOM,EAA0B,aAM1B,EAAa,OAAO,WAAW,EAErC,IAAI,EAA0B,KAM9B,MAAa,MAAyC,IAAc,KAU9D,EAAkB,GAAyC,CAC3D,EAAQ,OAAS,YACnB,EAAW,UAAU,EAAQ,GAAI,EAAQ,IAAI,EAE7C,EAAQ,OAAS,cACjB,OAAO,EAAQ,QAAW,UAE1B,EAAW,WAAW,EAAQ,OAAQ,EAAQ,GAAI,EAAQ,IAAI,CAElE,EAEM,EAAW,GAAyD,CACnE,GAEL,EACG,QACC,EACA,KAAK,UAAU,CAAE,GAAG,EAAS,OAAQ,CAAW,CAAC,CACnD,CAAC,CACA,UAAY,CAGb,CAAC,CACL,EAQa,EAAsB,GAA+B,CAEhE,GAAI,CAAC,GAAU,EAAW,OAE1B,EAAY,EAKZ,IAAM,EAAa,EAAO,UAAU,EACpC,EAAW,GAAG,YAAe,CAE7B,CAAC,EACD,EAAW,GAAG,YAAe,CAC3B,EAAgB,UAAU,CAAuB,CAAC,CAAC,UAAY,CAE/D,CAAC,CACH,CAAC,EACD,EAAW,GAAG,WAAY,EAAS,IAAQ,CACrC,OAAY,EAEhB,GAAI,CACF,IAAM,EAAU,KAAK,MAAM,CAAG,EAE9B,GAAI,EAAQ,SAAW,EAAY,OACnC,EAAe,CAAO,CACxB,MAAQ,CAER,CACF,CAAC,CACH,EA8Ba,EAA4B,CACvC,WAAY,EAAS,IAAS,CAC5B,EAAW,UAAU,EAAQ,GAAI,CAAI,EACrC,EAAQ,CAAE,OAAM,GAAI,EAAQ,GAAI,KAAM,WAAY,CAAC,CACrD,EACA,YAAa,EAAQ,EAAS,IAAS,CACrC,EAAW,WAAW,EAAQ,EAAQ,GAAI,CAAI,EAC9C,EAAQ,CAAE,OAAM,GAAI,EAAQ,GAAI,KAAM,aAAc,QAAO,CAAC,CAC9D,CACF"}

package/dist/src/ws/types.d.ts

@@ -1,22 +1,25 @@
-export interface VitNodeWSMessage<TData = unknown> {
-    data: TData;
-    id: string;
+//#region src/ws/types.d.ts
+interface VitNodeWSMessage<TData = unknown> {
+  data: TData;
+  id: string;
 }
-export interface VitNodeWSChannel<Send = unknown, Receive = unknown> {
-    __types?: {
-        receive: Receive;
-        send: Send;
-    };
-    id: string;
+interface VitNodeWSChannel<Send = unknown, Receive = unknown> {
+  __types?: {
+    receive: Receive;
+    send: Send;
+  };
+  id: string;
 }
-export declare const getWebSocketId: (parts: {
-    id: string;
-    module: string;
-    pluginId: string;
+declare const getWebSocketId: (parts: {
+  id: string;
+  module: string;
+  pluginId: string;
 }) => string;
-export declare const createWebSocketChannel: <Send = unknown, Receive = unknown>(parts: {
-    id: string;
-    module: string;
-    pluginId: string;
+declare const createWebSocketChannel: <Send = unknown, Receive = unknown>(parts: {
+  id: string;
+  module: string;
+  pluginId: string;
 }) => VitNodeWSChannel<Send, Receive>;
+//#endregion
+export { VitNodeWSChannel, VitNodeWSMessage, createWebSocketChannel, getWebSocketId };
 //# sourceMappingURL=types.d.ts.map

package/dist/src/ws/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ws/types.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,OAAO;IAC/C,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AASD,MAAM,WAAW,gBAAgB,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO;IAKjE,OAAO,CAAC,EAAE;QACR,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,EAAE,IAAI,CAAC;KACZ,CAAC;IACF,EAAE,EAAE,MAAM,CAAC;CACZ;AAMD,eAAO,MAAM,cAAc,GAAI,OAAO;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAG,MAAyD,CAAC;AAgB9D,eAAO,MAAM,sBAAsB,GACjC,IAAI,GAAG,OAAO,EACd,OAAO,GAAG,OAAO,EACjB,OAAO;IACP,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,KAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAEhC,CAAC"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../../src/ws/types.ts"],"mappings":";UAeiB,iBAAiB;EAChC,MAAM;EACN;;UAUe,iBAAiB,gBAAgB;EAKhD;IACE,SAAS;IACT,MAAM;;EAER;;cAOW,iBAAkB;EAC7B;EACA;EACA;;cAiBW,yBACX,gBACA,mBACA;EACA;EACA;EACA;MACE,iBAAiB,MAAM"}

package/dist/src/ws/types.js

@@ -1 +1,2 @@
-export const getWebSocketId=parts=>`${parts.pluginId}_${parts.module}_${parts.id}`;export const createWebSocketChannel=parts=>({id:getWebSocketId(parts)});
+const e=e=>`${e.pluginId}_${e.module}_${e.id}`,t=t=>({id:e(t)});export{t as createWebSocketChannel,e as getWebSocketId};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"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.d.ts

@@ -1,9 +1,12 @@
-import type { VitNodeWSChannel } from "./types";
-export interface UseVitNodeWebSocketReturn<Send> {
-    readyState: number;
-    send: (data: Send) => void;
+import { VitNodeWSChannel } from "./types.js";
+//#region src/ws/use-websocket.d.ts
+interface UseVitNodeWebSocketReturn<Send> {
+  readyState: number;
+  send: (data: Send) => void;
 }
-export declare function useVitNodeWebSocket<Send = unknown, Receive = unknown>(channel: string | VitNodeWSChannel<Send, Receive>, options?: {
-    onMessage?: (data: Receive) => void;
+declare function useVitNodeWebSocket<Send = unknown, Receive = unknown>(channel: string | VitNodeWSChannel<Send, Receive>, options?: {
+  onMessage?: (data: Receive) => void;
 }): UseVitNodeWebSocketReturn<Send>;
+//#endregion
+export { UseVitNodeWebSocketReturn, useVitNodeWebSocket };
 //# sourceMappingURL=use-websocket.d.ts.map

package/dist/src/ws/use-websocket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-websocket.d.ts","sourceRoot":"","sources":["../../../src/ws/use-websocket.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD,MAAM,WAAW,yBAAyB,CAAC,IAAI;IAK7C,UAAU,EAAE,MAAM,CAAC;IAEnB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;CAC5B;AAgBD,wBAAgB,mBAAmB,CAAC,IAAI,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACnE,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,EACjD,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,GACA,yBAAyB,CAAC,IAAI,CAAC,CAyBjC"}
+{"version":3,"file":"use-websocket.d.ts","names":[],"sources":["../../../src/ws/use-websocket.ts"],"mappings":";;UAQiB,0BAA0B;EAKzC;EAEA,OAAO,MAAM;;iBAiBC,oBAAoB,gBAAgB,mBAClD,kBAAkB,iBAAiB,MAAM,UACzC;EACE,aAAa,MAAM;IAEpB,0BAA0B"}

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

@@ -1 +1,2 @@
-"use client";import React from"react";import{useVitNodeWebSocketContext}from"./provider.js";export function useVitNodeWebSocket(channel,options){const{readyState,send:contextSend,subscribe}=useVitNodeWebSocketContext();const id=typeof channel==="string"?channel:channel.id;const onMessageRef=React.useRef(options?.onMessage);React.useEffect(()=>{onMessageRef.current=options?.onMessage});React.useEffect(()=>subscribe(id,data=>onMessageRef.current?.(data)),[id,subscribe]);const send=React.useCallback(data=>contextSend(id,data),[contextSend,id]);return{readyState,send}}
+"use client";import{useVitNodeWebSocketContext as e}from"./provider.js";import t from"react";function n(n,r){let{readyState:i,send:a,subscribe:o}=e(),s=typeof n==`string`?n:n.id,c=t.useRef(r?.onMessage);return t.useEffect(()=>{c.current=r?.onMessage}),t.useEffect(()=>o(s,e=>c.current?.(e)),[s,o]),{readyState:i,send:t.useCallback(e=>a(s,e),[a,s])}}export{n as useVitNodeWebSocket};
+//# sourceMappingURL=use-websocket.js.map

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

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vitnode/core",
-  "version": "1.2.0-canary.74",
+  "version": "1.2.0-canary.76",
   "description": "Core package for VitNode, providing essential functionalities and configurations.",
   "author": "VitNode Team",
   "license": "MIT",
@@ -20,8 +20,6 @@
   ],
   "peerDependencies": {
     "@hono/zod-openapi": "^1.0.x",
-    "@swc/cli": "0.7.x",
-    "@swc/core": "1.x.x",
     "@types/react": "^19.1.x",
     "@types/react-dom": "^19.1.x",
     "drizzle-kit": "^0.31.x",
@@ -33,6 +31,7 @@
     "react": "^19.2.x",
     "react-dom": "^19.2.x",
     "react-hook-form": "^7.x.x",
+    "tsdown": "^0.22.4",
     "typescript": "^5.9.x",
     "zod": "^4.x.x"
   },
@@ -40,42 +39,40 @@
     "@hono/zod-openapi": "^1.4.0",
     "@hono/zod-validator": "^0.8.0",
     "@hookform/resolvers": "^5.4.0",
-    "@react-email/components": "^1.0.12",
-    "@swc/cli": "^0.8.1",
-    "@swc/core": "^1.15.41",
+    "@react-email/ui": "^6.6.6",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.0.1",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^6.0.2",
-    "@vitest/coverage-v8": "^4.1.8",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@vitest/coverage-v8": "^4.1.9",
     "chokidar": "^5.0.0",
     "concurrently": "^10.0.3",
     "drizzle-kit": "^0.31.10",
     "drizzle-orm": "^0.45.2",
     "eslint": "^10.5.0",
-    "hono": "^4.12.25",
+    "hono": "^4.12.27",
     "jiti": "^2.7.0",
     "jsdom": "^29.1.1",
-    "lucide-react": "^1.18.0",
-    "next": "^16.2.9",
+    "lucide-react": "^1.21.0",
+    "next": "16.3.0-preview.5",
     "next-intl": "^4.13.0",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
-    "react-email": "^6.6.0",
-    "react-hook-form": "^7.79.0",
+    "react-email": "^6.6.6",
+    "react-hook-form": "^7.80.0",
     "sonner": "^2.0.7",
     "tailwindcss": "^4.3.1",
-    "tsc-alias": "^1.8.17",
+    "tsdown": "^0.22.4",
     "tsup": "^8.5.1",
     "tsx": "^4.22.4",
     "tw-animate-css": "^1.4.0",
     "typescript": "^6.0.3",
-    "vite": "^8.0.16",
-    "vitest": "^4.1.8",
+    "vite": "^8.1.0",
+    "vitest": "^4.1.9",
     "zod": "^4.4.3",
-    "@vitnode/config": "1.2.0-canary.74"
+    "@vitnode/config": "1.2.0-canary.76"
   },
   "bin": {
     "vitnode": "./dist/scripts/scripts.js"
@@ -97,45 +94,44 @@
   },
   "type": "module",
   "dependencies": {
-    "@base-ui/react": "^1.5.0",
+    "@base-ui/react": "^1.6.0",
     "@bprogress/next": "^3.2.12",
     "@dnd-kit/core": "^6.3.1",
     "@hono/swagger-ui": "^0.6.1",
-    "@react-email/preview-server": "^5.2.10",
-    "@tanstack/react-query": "^5.101.0",
-    "@tiptap/extension-text-align": "^3.26.1",
-    "@tiptap/pm": "^3.26.1",
-    "@tiptap/react": "^3.26.1",
-    "@tiptap/starter-kit": "^3.26.1",
+    "@tanstack/react-query": "^5.101.1",
+    "@tiptap/extension-text-align": "^3.27.1",
+    "@tiptap/pm": "^3.27.1",
+    "@tiptap/react": "^3.27.1",
+    "@tiptap/starter-kit": "^3.27.1",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "cron-parser": "^5.5.0",
+    "cron-parser": "^5.6.1",
     "date-fns": "^4.4.0",
     "dotenv": "^17.4.2",
     "embla-carousel-react": "^8.6.0",
     "input-otp": "^1.4.2",
-    "motion": "^12.40.0",
+    "ioredis": "^5.11.1",
+    "motion": "^12.41.0",
     "next-themes": "^0.4.6",
     "postgres": "^3.4.9",
-    "radix-ui": "^1.5.0",
     "rate-limiter-flexible": "^11.2.0",
     "react-day-picker": "^10.0.1",
     "react-resizable-panels": "^4.11.2",
     "react-scan": "^0.5.7",
-    "recharts": "3.8.1",
+    "recharts": "3.9.0",
     "server-only": "^0.0.1",
     "shadcn": "^4.11.0",
+    "sharp": "^0.35.3",
     "tailwind-merge": "^3.6.0",
     "use-debounce": "^10.1.1",
-    "use-intl": "^4.13.0",
     "vaul": "^1.1.2"
   },
   "scripts": {
     "build:scripts": "tsup",
     "start:scripts": "node dist/scripts/scripts.js init",
-    "build:plugins": "tsc && swc src -d dist --config-file .swcrc && tsc-alias -p tsconfig.json",
-    "dev": "concurrently \"tsc -w --preserveWatchOutput\" \"swc src -d dist --config-file .swcrc -w\" \"tsc-alias -w\" \"node dist/scripts/scripts.js plugin --w\"",
+    "build:plugins": "tsdown",
+    "dev": "concurrently \"tsdown --watch\" \"node dist/scripts/scripts.js plugin --w\"",
     "dev:email": "email dev --dir src/emails",
     "test": "vitest run",
     "test:watch": "vitest",