itty-sockets 0.6.1 → 0.7.1

package/README.md

@@ -18,32 +18,19 @@
 
 ---
 
-### The last WebSocket client you'll need : 512 bytes, all-in.
+### Say goodbye to WebSocket boilerplate.
+
+Your own wrapper is bigger, I promise.
+
+Or [optionally] go a step further and use the integrated [itty.ws](https://itty.ws) connection to send messages (zero-config, zero-tracking, 100% free).
 
 ## Features ✨
-1. **DX perks** - JSON-in/out, queued messages, easy-reconnect, chainable everything.
-1. **Works with any JSON-based WebSocket server**
-1. **Powerful Routing**
-   - Listen for all messages
-     ```ts
-     .on('message', data => console.log(data))
-     ```
-   - Only specific types
-     ```ts
-     // matches any data with { type: 'chat' }
-     .on('chat', ({ text }) => console.log(text))
-     ```
-   - or fully custom filters
-     ```ts
-     // matches only messages where data.value > 20
-     .on(
-       ({ value }) => value > 20), // filter function
-       ({ value }) => console.log(value),
-     )
-     ```
-1. **Type-safe message handling**
-1. **Tiny footprint** - 512 bytes, all-in.
-1. **Optional usage with free/public/zero-config [itty.ws](https://itty.ws) service**
+1. **DX perks** - JSON-in/out, queued messages, easy-reconnect, chainable everything
+1. **Works with *any* JSON-based WebSocket server** - it's just a raw WebSocket wrapper, after all
+1. **Powerful routing** - easily handle your own message formats
+1. **Type-safe message handling** - so your app knows what to expect
+1. **No socket server needed** - Use [itty.ws](https://itty.ws) public channels to get started even faster
+1. **Tiny** - under 500 bytes total
 
 ## Basic Example
 ```ts
@@ -85,7 +72,7 @@ import { connect } from 'itty-sockets'
 **Option 2: Just copy this snippet:**
 <!-- BEGIN SNIPPET -->
 ```ts
-let connect=(e,s={})=>{let p,a=0,n=[],t=[],o={},l=()=>(p||(p=new WebSocket((/^wss?:/.test(e)?e:"wss://itty.ws/c/"+e)+"?"+new URLSearchParams(s)),p.onmessage=(e,s=JSON.parse(e.data),p=s?.message,a={...null==p?.[0]&&p,...s})=>{o[s?.type??p?.type]?.map(e=>e(a)),s?.type||o.message?.map(e=>e(a)),t.map(([e,s])=>e(a)&&s(a))},p.onopen=()=>(n.splice(0).map(e=>p?.send(e)),o.open?.map(e=>e()),a&&p?.close()),p.onclose=()=>(a=0,p=null,o.close?.map(e=>e()))),m),m=new Proxy(l,{get:(e,s)=>({open:l,close:()=>(1==p?.readyState?p.close():a=1,m),push:(e,s)=>(a=1,m.send(e,s)),send:(e,s)=>(e=JSON.stringify(e),e=s?""+s+""+e:e,1==p?.readyState?(p.send(e),m):(n.push(e),l())),on:(e,s)=>(s&&(e?.[0]?(o[e]??=[]).push(s):t.push([e,s])),l()),remove:(e,s,p=o[e],a=p?.indexOf(s)??-1)=>(~a&&p?.splice(a,1),l())}[s])});return m};
+let connect=(e,s={})=>{let a,t,n=[],p={},o=()=>(a||(a=new WebSocket((/^wss?:/.test(e)?e:"wss://itty.ws/c/"+e)+"?"+new URLSearchParams(s)),a.onmessage=(e,s=JSON.parse(e.data),a=s?.message,t={...null==a?.[0]&&a,...s})=>[t.type,s.type?0:"message","*"].map(e=>p[e]?.map(e=>e(t))),a.onopen=()=>(n.splice(0).map(e=>a.send(e)),p.open?.map(e=>e(t)),t&&a?.close()),a.onclose=()=>(t=a=null,p.close?.map(e=>e(t)))),l),l={open:o,send:(e,s)=>(e=(s?`${s}`:"")+JSON.stringify(e),1&a?.readyState?a.send(e):n.push(e),o()),on:(e,s)=>((p[e?.[0]?e:"*"]??=[]).push(e?.[0]?s:a=>e?.(a)&&s(a)),o()),remove:(e,s)=>(p[e]=p[e]?.filter(e=>e!=s),l),close:()=>(1&a?.readyState?a.close():t=1,l),push:(e,s)=>(t=1,l.send(e,s))};return l};
 ```
 <!-- END SNIPPET -->
 *Note: This will lose TypeScript support.*
@@ -101,13 +88,14 @@ connect('wss://example.com')
   .on('message', console.log)
 
   // and just { type: 'chat' }
-  .on('chat', 
+  .on('chat',
     ({ user, text }) => console.log(`${user} says: ${text}`)
   )
 ```
 
 Now let's assume the following 2 messages are sent:
 ```json
+// message 1
 {
   "type": "chat",
   "user": "Kevin",
@@ -116,6 +104,7 @@ Now let's assume the following 2 messages are sent:
 ```
 
 ```json
+// message 2
 {
   "date": 1754659171196,
   "items": [1, 2, 3],
@@ -123,12 +112,13 @@ Now let's assume the following 2 messages are sent:
 ```
 
 This will output the following to the console:
-```
+```js
+// message 1
 { type: "chat", user: "Kevin", text: "Hey!" }
+"Kevin says: Hey!"
 
+// message 2
 { date: 1754659171196, items: [1, 2, 3] }
-
-"Kevin says: Hey!"
 ```
 
 ## Example 3 - Reconnection

package/connect.js

@@ -1 +1 @@
-"use strict";exports.connect=(e,s={})=>{let n,t=0,p=[],a=[],o={},c=()=>(n||(n=new WebSocket((/^wss?:/.test(e)?e:"wss://itty.ws/c/"+e)+"?"+new URLSearchParams(s)),n.onmessage=(e,s=JSON.parse(e.data),n=s?.message,t={...null==n?.[0]&&n,...s})=>{o[s?.type??n?.type]?.map(e=>e(t)),s?.type||o.message?.map(e=>e(t)),a.map(([e,s])=>e(t)&&s(t))},n.onopen=()=>(p.splice(0).map(e=>n?.send(e)),o.open?.map(e=>e()),t&&n?.close()),n.onclose=()=>(t=0,n=null,o.close?.map(e=>e()))),l),l=new Proxy(c,{get:(e,s)=>({open:c,close:()=>(1==n?.readyState?n.close():t=1,l),push:(e,s)=>(t=1,l.send(e,s)),send:(e,s)=>(e=JSON.stringify(e),e=s?""+s+""+e:e,1==n?.readyState?(n.send(e),l):(p.push(e),c())),on:(e,s)=>(s&&(e?.[0]?(o[e]??=[]).push(s):a.push([e,s])),c()),remove:(e,s,n=o[e],t=n?.indexOf(s)??-1)=>(~t&&n?.splice(t,1),c())}[s])});return l};
+"use strict";exports.connect=(e,s={})=>{let t,n,a=[],o={},p=()=>(t||(t=new WebSocket((/^wss?:/.test(e)?e:"wss://itty.ws/c/"+e)+"?"+new URLSearchParams(s)),t.onmessage=(e,s=JSON.parse(e.data),t=s?.message,n={...null==t?.[0]&&t,...s})=>[n.type,s.type?0:"message","*"].map(e=>o[e]?.map(e=>e(n))),t.onopen=()=>(a.splice(0).map(e=>t.send(e)),o.open?.map(e=>e(n)),n&&t?.close()),t.onclose=()=>(n=t=null,o.close?.map(e=>e(n)))),c),c={open:p,send:(e,s)=>(e=(s?`${s}`:"")+JSON.stringify(e),1&t?.readyState?t.send(e):a.push(e),p()),on:(e,s)=>((o[e?.[0]?e:"*"]??=[]).push(e?.[0]?s:t=>e?.(t)&&s(t)),p()),remove:(e,s)=>(o[e]=o[e]?.filter(e=>e!=s),c),close:()=>(1&t?.readyState?t.close():n=1,c),push:(e,s)=>(n=1,c.send(e,s))};return c};

package/connect.mjs

@@ -1 +1 @@
-let e=(e,s={})=>{let p,a=0,n=[],t=[],o={},l=()=>(p||(p=new WebSocket((/^wss?:/.test(e)?e:"wss://itty.ws/c/"+e)+"?"+new URLSearchParams(s)),p.onmessage=(e,s=JSON.parse(e.data),p=s?.message,a={...null==p?.[0]&&p,...s})=>{o[s?.type??p?.type]?.map(e=>e(a)),s?.type||o.message?.map(e=>e(a)),t.map(([e,s])=>e(a)&&s(a))},p.onopen=()=>(n.splice(0).map(e=>p?.send(e)),o.open?.map(e=>e()),a&&p?.close()),p.onclose=()=>(a=0,p=null,o.close?.map(e=>e()))),m),m=new Proxy(l,{get:(e,s)=>({open:l,close:()=>(1==p?.readyState?p.close():a=1,m),push:(e,s)=>(a=1,m.send(e,s)),send:(e,s)=>(e=JSON.stringify(e),e=s?""+s+""+e:e,1==p?.readyState?(p.send(e),m):(n.push(e),l())),on:(e,s)=>(s&&(e?.[0]?(o[e]??=[]).push(s):t.push([e,s])),l()),remove:(e,s,p=o[e],a=p?.indexOf(s)??-1)=>(~a&&p?.splice(a,1),l())}[s])});return m};export{e as connect};
+let e=(e,s={})=>{let a,t,n=[],p={},o=()=>(a||(a=new WebSocket((/^wss?:/.test(e)?e:"wss://itty.ws/c/"+e)+"?"+new URLSearchParams(s)),a.onmessage=(e,s=JSON.parse(e.data),a=s?.message,t={...null==a?.[0]&&a,...s})=>[t.type,s.type?0:"message","*"].map(e=>p[e]?.map(e=>e(t))),a.onopen=()=>(n.splice(0).map(e=>a.send(e)),p.open?.map(e=>e(t)),t&&a?.close()),a.onclose=()=>(t=a=null,p.close?.map(e=>e(t)))),l),l={open:o,send:(e,s)=>(e=(s?`${s}`:"")+JSON.stringify(e),1&a?.readyState?a.send(e):n.push(e),o()),on:(e,s)=>((p[e?.[0]?e:"*"]??=[]).push(e?.[0]?s:a=>e?.(a)&&s(a)),o()),remove:(e,s)=>(p[e]=p[e]?.filter(e=>e!=s),l),close:()=>(1&a?.readyState?a.close():t=1,l),push:(e,s)=>(t=1,l.send(e,s))};return l};export{e as connect};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "itty-sockets",
-  "version": "0.6.1",
+  "version": "0.7.1",
   "description": "WebSockets : simplified and minified.",
   "type": "module",
   "exports": {
@@ -15,8 +15,8 @@
     "test": "bun test --coverage",
     "lint": "itty lint",
     "build": "itty lint && itty build --snippet=connect --hybrid",
-    "release": "itty release --prepare --tag --push",
-    "release:next": "itty release --prepare --tag --push --type=next"
+    "release": "itty release --prepare --tag --push --otp",
+    "release:next": "itty release --prepare --tag --push --type=next --otp"
   },
   "keywords": [
     "websockets",
@@ -34,6 +34,6 @@
   },
   "devDependencies": {
     "@types/bun": "^1.2.3",
-    "itty-packager": "^1.6.10"
+    "itty-packager": "^1.7.0"
   }
 }