nucleus-core-ts 0.9.976 → 0.9.977

package/dist/.build-ok

@@ -1 +1 @@
-0.9.976
+0.9.977

package/dist/src/Client/Proxy/wsProxy.js

@@ -244,6 +244,22 @@ export function createWsProxyHandler(config) {
                         rejectUnauthorized: state.rejectUnauthorized
                     }
                 });
+                /*
+         * Ask for ArrayBuffer, because the default is not one.
+         *
+         * Bun's client WebSocket defaults `binaryType` to `'nodebuffer'`, so a
+         * binary frame arrives as a Node `Buffer`. A Buffer is neither an
+         * `ArrayBuffer` nor a `Blob`, so it matched none of the branches below
+         * and was silently discarded — a proxy that relays text perfectly and
+         * drops every binary frame without a word.
+         *
+         * Measured against a Next 16 dev server, which sends its React debug
+         * chunks as binary on the HMR socket: 5 frames direct, 2 of them
+         * binary; 3 frames through the proxy, 0 binary. The consequence was a
+         * page that never hydrated at all — the client awaits those chunks
+         * before calling `hydrateRoot`, so the whole app stayed as the server
+         * had sent it, blank.
+         */ backendWs.binaryType = 'arraybuffer';
                 backendWs.onopen = ()=>{
                     logger.info(`Backend connected: ${state.path}`);
                     config.onOpen?.(state.path, state.target);
@@ -266,10 +282,22 @@ export function createWsProxyHandler(config) {
                         ws.send(event.data);
                     } else if (event.data instanceof ArrayBuffer) {
                         ws.send(new Uint8Array(event.data));
+                    } else if (ArrayBuffer.isView(event.data)) {
+                        // A Buffer, a Uint8Array, a DataView — anything with a backing
+                        // buffer. Kept even though `binaryType` is now set, because the
+                        // silent-drop is the failure mode to design against: a runtime
+                        // whose default differs would lose frames here with nothing in any
+                        // log to say so.
+                        const view = event.data;
+                        ws.send(new Uint8Array(view.buffer, view.byteOffset, view.byteLength));
                     } else if (event.data instanceof Blob) {
                         event.data.arrayBuffer().then((buffer)=>{
                             ws.send(new Uint8Array(buffer));
                         });
+                    } else {
+                        // Never silently. If a frame cannot be relayed, that is a fact
+                        // somebody has to be able to find.
+                        logger.warn(`Dropped an unrelayable frame on ${state.path}: ${Object.prototype.toString.call(event.data)}`);
                     }
                 };
                 backendWs.onerror = (event)=>{

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "nucleus-core-ts",
-	"version": "0.9.976",
+	"version": "0.9.977",
 	"description": "Production-ready, enterprise-grade TypeScript framework for building multi-tenant APIs",
 	"author": "Hidayet Can Özcan <hidayetcan@gmail.com>",
 	"license": "SEE LICENSE IN LICENSE",