[prc5]

Closes #148

Core

• client.setUrl(url, { abort?, invalidate? }) switches the base URL at runtime. Cache keys don't include the base URL, so:
  • abort cancels in-flight requests sent to the previous URL
  • invalidate invalidates the whole cache, plus the aborted requests, so mounted hooks refetch from the new URL
  • both default to false, and calling it with the current URL does nothing
• client.cache.invalidate() with no arguments now invalidates every entry.

Sockets

• socket.setUrl(url) applies to the next connection attempt, the same way setQueryParams does. Call reconnect() to apply it to a live connection. Listeners stay registered.
• WebsocketAdapter has two new flat options:
  • decode(event) => { topic, data } | null maps incoming frames; returning null ignores the frame
  • encode({ topic, payload }) => frame maps outgoing frames, including heartbeat messages
• ServerSentEventsAdapter gets the same flat decode option.
• Errors thrown inside encode or decode are reported through onError and don't break the connection. When the options are not set, frames keep the current { topic, data } shape.

new Socket({
  url,
  adapterOptions: {
    decode: (event) => {
      const msg = JSON.parse(event.data);
      return msg.type === "pong" ? null : { topic: msg.type, data: msg.payload };
    },
    encode: ({ topic, payload }) => JSON.stringify({ type: topic, payload }),
  },
});

Docs are updated for the client, cache, socket and adapter pages.

Tests

• core: client.set-url.spec.ts (new) and a cache.invalidate() no-argument case
• sockets: adapter.websocket.codec.spec.ts and adapter.sse.codec.spec.ts (new), plus setUrl tests in socket.methods.spec.ts, including reconnecting to a second server
• core and sockets: full test suites, typecheck, lint and build pass; react, axios and graphql typecheck

🤖 Generated with Claude Code

[github-actions]

🎉 This PR is included in version 9.2.0 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀