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

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;AAqBF,eAAO,MAAM,wBAAwB,GAAI,eAEtC;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,sBAwEA,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()};const shouldConnectWebSocket=()=>CONFIG.api.pathname!==CONFIG.web.pathname||CONFIG.api.port!==CONFIG.web.port;export const VitNodeWebSocketProvider=({children})=>{const listenersRef=React.useRef(new Map);const managerRef=React.useRef(null);const pendingSendRef=React.useRef([]);const[readyState,setReadyState]=React.useState(()=>{if(typeof WebSocket==="undefined")return 0;return shouldConnectWebSocket()?WebSocket.CONNECTING:WebSocket.CLOSED});const dispatch=React.useCallback(message=>{listenersRef.current.get(message.id)?.forEach(listener=>listener(message.data))},[]);React.useEffect(()=>{if(!shouldConnectWebSocket())return;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,19 +1,22 @@
-import type { WSContext } from "hono/ws";
-import type { Redis } from "ioredis";
-import type { VitNodeWSChannel } from "./types";
-export declare const markWebSocketEnabled: () => void;
-export declare const isWebSocketEnabled: () => boolean;
-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 declare const isRealtimePubSubEnabled: () => boolean;
-export declare const initRealtimePubSub: (client: null | Redis) => 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;AACzC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,SAAS,CAAC;AAwBlE,eAAO,MAAM,oBAAoB,QAAO,IAEvC,CAAC;AAGF,eAAO,MAAM,kBAAkB,QAAO,OAA2B,CAAC;AAUlE,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;AAqBF,eAAO,MAAM,uBAAuB,QAAO,OAA6B,CAAC;AAyCzE,eAAO,MAAM,kBAAkB,GAAI,QAAQ,IAAI,GAAG,KAAK,KAAG,IA8BzD,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;AASD,eAAO,MAAM,QAAQ,EAAE,eAStB,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;let webSocketEnabled=false;export const markWebSocketEnabled=()=>{webSocketEnabled=true};export const isWebSocketEnabled=()=>webSocketEnabled;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)})}};const REALTIME_PUBSUB_CHANNEL="vitnode:ws";const instanceId=crypto.randomUUID();let publisher=null;export const isRealtimePubSubEnabled=()=>publisher!==null;const deliverLocally=message=>{if(message.type==="broadcast"){wsRegistry.broadcast(message.id,message.data)}else if(message.type==="sendToUser"&&typeof message.userId==="number"){wsRegistry.sendToUser(message.userId,message.id,message.data)}};const publish=message=>{if(!publisher)return;void publisher.publish(REALTIME_PUBSUB_CHANNEL,JSON.stringify({...message,origin:instanceId})).catch(()=>{})};export const initRealtimePubSub=client=>{if(!client||publisher)return;publisher=client;const subscriber=client.duplicate();subscriber.on("error",()=>{});subscriber.on("ready",()=>{void subscriber.subscribe(REALTIME_PUBSUB_CHANNEL).catch(()=>{})});subscriber.on("message",(channel,raw)=>{if(channel!==REALTIME_PUBSUB_CHANNEL)return;try{const message=JSON.parse(raw);if(message.origin===instanceId)return;deliverLocally(message)}catch{}})};export const realtime={broadcast:(channel,data)=>{wsRegistry.broadcast(channel.id,data);publish({data,id:channel.id,type:"broadcast"})},sendToUser:(userId,channel,data)=>{wsRegistry.sendToUser(userId,channel.id,data);publish({data,id:channel.id,type:"sendToUser",userId})}};
+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.75",
+  "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"
   },
@@ -41,8 +40,6 @@
     "@hono/zod-validator": "^0.8.0",
     "@hookform/resolvers": "^5.4.0",
     "@react-email/ui": "^6.6.6",
-    "@swc/cli": "^0.8.1",
-    "@swc/core": "^1.15.43",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@types/node": "^26.0.1",
@@ -67,7 +64,7 @@
     "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",
@@ -75,7 +72,7 @@
     "vite": "^8.1.0",
     "vitest": "^4.1.9",
     "zod": "^4.4.3",
-    "@vitnode/config": "1.2.0-canary.75"
+    "@vitnode/config": "1.2.0-canary.76"
   },
   "bin": {
     "vitnode": "./dist/scripts/scripts.js"
@@ -125,6 +122,7 @@
     "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",
     "vaul": "^1.1.2"
@@ -132,8 +130,8 @@
   "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",

package/src/locales/en.json

@@ -15,6 +15,11 @@
   "@vitnode/core:system": "System",
   "@vitnode/core:system:can_view": "View integrations",
   "@vitnode/core:system:can_send_test_email": "Send test email",
+  "@vitnode/core:system:can_test_storage": "Test storage",
+  "@vitnode/core:files": "Files",
+  "@vitnode/core:files:can_view": "View uploaded files",
+  "@vitnode/core:files:can_download": "Download files",
+  "@vitnode/core:files:can_delete": "Delete files",
   "@vitnode/core:queue": "Queue Tasks",
   "@vitnode/core:queue:can_view": "View queue tasks",
   "@vitnode/core:staff_moderators": "Staff: Moderators",
@@ -131,7 +136,42 @@
         "log_out": "Log out",
         "mod_cp": "Moderator CP",
         "admin_cp": "Admin CP",
-        "settings": "Settings"
+        "settings": "Settings",
+        "files": "My Files"
+      }
+    },
+    "files": {
+      "title": "My Files",
+      "desc": "Files you've uploaded to your account.",
+      "list": {
+        "preview": "Preview",
+        "name": "Name",
+        "folder": "Folder",
+        "size": "Size",
+        "dimensions": "Dimensions",
+        "metadata": "Metadata",
+        "createdAt": "Uploaded"
+      },
+      "metadata": {
+        "title": "Metadata",
+        "empty": "—"
+      },
+      "actions": {
+        "download": "Download",
+        "delete": "Delete"
+      },
+      "download": {
+        "error": "Failed to download the file."
+      },
+      "delete": {
+        "title": "Delete file",
+        "desc": "Are you sure you want to delete this file? This permanently removes it and cannot be undone.",
+        "confirm": "Delete",
+        "success": "File deleted."
+      },
+      "noResults": {
+        "title": "No files yet",
+        "description": "Files you upload will appear here."
       }
     },
     "auth": {
@@ -272,7 +312,8 @@
         },
         "system": {
           "title": "System",
-          "integrations": "Integrations"
+          "integrations": "Integrations",
+          "files": "Files"
         },
         "advanced": {
           "title": "Advanced",
@@ -524,7 +565,7 @@
         "redis": {
           "title": "Redis",
           "desc": "Shared cache and rate-limiter storage. Falls back to in-memory when off.",
-          "down": "Configured but unreachable — check your Redis connection."
+          "down": "Configured but unreachable - check your Redis connection."
         },
         "email": {
           "title": "Email",
@@ -553,6 +594,27 @@
             "success": "Test email sent. Check the recipient's inbox to confirm your configuration."
           }
         },
+        "storage": {
+          "title": "Storage",
+          "desc": "File uploads such as avatars and attachments, stored via your storage adapter.",
+          "test": {
+            "label": "Test storage",
+            "title": "Test file storage",
+            "desc": "Upload a file and run a round-trip check to confirm your storage adapter is working.",
+            "info": {
+              "title": "How to verify your configuration",
+              "desc": "Upload a test image. If it succeeds, your storage adapter is configured correctly. If it fails, double-check your adapter settings and the system logs."
+            },
+            "upload": {
+              "label": "Upload a test image",
+              "desc": "Click to choose an image",
+              "pending": "Uploading…",
+              "done": "Uploaded",
+              "error": "Upload failed - try again",
+              "success": "Image uploaded - it's stored in your adapter."
+            }
+          }
+        },
         "captcha": {
           "title": "Captcha",
           "desc": "Bot protection on public forms like sign-up and password reset.",
@@ -564,15 +626,54 @@
         "cron": {
           "title": "Cron Jobs",
           "desc": "Scheduled background tasks such as clearing expired sessions and tokens.",
-          "insecure": "Using the default CRON_SECRET — set a secure one in production.",
-          "not_configured": "No cron adapter configured — jobs won't run automatically.",
+          "insecure": "Using the default CRON_SECRET - set a secure one in production.",
+          "not_configured": "No cron adapter configured - jobs won't run automatically.",
+          "stale": "No job has run in over 6 hours - cron may be misconfigured or stopped. Check your cron setup.",
           "jobs": "{count, plural, =0 {No jobs scheduled} one {# job scheduled} other {# jobs scheduled}}"
         },
         "queue": {
           "title": "Queue Tasks",
           "desc": "Background jobs enqueued in the database and drained by the cron worker.",
           "tasks": "{count, plural, =0 {No tasks registered} one {# task registered} other {# tasks registered}}",
-          "queued": "{pending} pending · {processing} running"
+          "queued": "{pending} pending · {processing} running",
+          "cron_stale": "Offline - the cron worker that drains the queue isn't running. Fix cron jobs to resume processing."
+        }
+      },
+      "files": {
+        "title": "Files",
+        "desc": "Browse, download, and delete files uploaded to this instance.",
+        "list": {
+          "preview": "Preview",
+          "name": "Name",
+          "folder": "Folder",
+          "size": "Size",
+          "dimensions": "Dimensions",
+          "uploadedBy": "Uploaded by",
+          "metadata": "Metadata",
+          "createdAt": "Uploaded",
+          "no_preview": "No preview"
+        },
+        "anonymous": "—",
+        "metadata": {
+          "empty": "—",
+          "title": "Metadata"
+        },
+        "actions": {
+          "download": "Download",
+          "delete": "Delete"
+        },
+        "download": {
+          "error": "Failed to download the file."
+        },
+        "delete": {
+          "title": "Delete file",
+          "desc": "Are you sure you want to delete this file? This permanently removes it from storage and cannot be undone.",
+          "confirm": "Delete",
+          "success": "File deleted."
+        },
+        "noResults": {
+          "title": "No files uploaded",
+          "description": "Files uploaded across the site will appear here."
         }
       }
     },

package/src/routes/admin/core/system/files/page.tsx

@@ -0,0 +1,51 @@
+import { getTranslations } from "next-intl/server";
+import dynamic from "next/dynamic";
+import { notFound } from "next/navigation";
+import React from "react";
+
+import { I18nProvider } from "@/components/i18n-provider";
+import { DataTableSkeleton } from "@/components/table/data-table";
+import { HeaderContent } from "@/components/ui/header-content";
+import { checkAdminPermissionApi } from "@/lib/api/get-session-admin-api";
+
+const FilesTableView = dynamic(async () =>
+  import("@/views/admin/views/core/system/files/files-table-view").then(
+    module => ({
+      default: module.FilesTableView,
+    }),
+  ),
+);
+
+export const generateMetadata = async () => {
+  const t = await getTranslations("admin.system.files");
+
+  return {
+    title: t("title"),
+    description: t("desc"),
+  };
+};
+
+export default async function Page(
+  props: React.ComponentProps<typeof FilesTableView>,
+) {
+  const [t, canView] = await Promise.all([
+    getTranslations("admin.system.files"),
+    checkAdminPermissionApi({ module: "files", permission: "can_view" }),
+  ]);
+
+  if (!canView) {
+    notFound();
+  }
+
+  return (
+    <I18nProvider namespaces={["admin.system.files"]}>
+      <div className="p-4">
+        <HeaderContent desc={t("desc")} h1={t("title")} />
+
+        <React.Suspense fallback={<DataTableSkeleton columns={8} />}>
+          <FilesTableView {...props} />
+        </React.Suspense>
+      </div>
+    </I18nProvider>
+  );
+}

package/src/routes/blank/test/page.tsx

@@ -3,7 +3,7 @@ export default function Page() {
     <div className="flex min-h-screen flex-col items-center justify-center gap-2 text-center">
       <h1 className="text-2xl font-bold">Blank test page</h1>
       <p className="text-muted-foreground">
-        This page renders without the main layout — no header or footer, just
+        This page renders without the main layout - no header or footer, just
         the root providers.
       </p>
     </div>

package/src/routes/breadcrumb/main/page.tsx

@@ -1,6 +1,6 @@
 // Home page (/) has no breadcrumb. An explicit slot page (not just default.tsx)
 // is required so client-side navigation back to "/" clears a previously-rendered
-// breadcrumb — otherwise Next.js keeps the slot's stale active state on soft nav.
+// breadcrumb - otherwise Next.js keeps the slot's stale active state on soft nav.
 export default function BreadcrumbSlot() {
   return null;
 }