@fkn/lib 0.9.43 → 0.9.44

package/rooms.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api--LOXTOpv.cjs"),n=require("./busy-Dv8wzE5M.cjs"),r=require("./contract.cjs");var i=e.t({available:()=>m,create:()=>g,join:()=>_,open:()=>h}),a={wrongKey:`rooms: wrong room key`,inviteNoKey:`rooms: the invite carries no key`,badName:`rooms: the name is not one a room can have`,badKeyOption:`rooms: the key is not 32 bytes base64url`,noSuchMember:`rooms: no such member`,noSuchMessage:`rooms: no such message`,roomFull:`rooms: the room is full`,tooManyConnections:`rooms: too many connections`,tooManyBlocks:`rooms: too many blocks`,tooManyClaims:`rooms: too many claims`,mailboxFull:`rooms: the mailbox is full`,outOfStorage:`rooms: the owner is out of storage`,outOfQuota:`rooms: out of daily bandwidth`,blocked:`rooms: you are blocked from this room`,cannotSend:`rooms: you cannot send here`,permissionDenied:`rooms: permission denied`,notOwner:`rooms: not the room owner`,ownerNotRemovable:`rooms: the owner cannot be removed`,ownerKeepsEvery:`rooms: the owner keeps every permission`,removeYourself:`rooms: you cannot remove yourself`,needsAccount:`rooms: claiming needs an account`,needsPremium:`rooms: claiming needs premium`,nameClaimed:`rooms: the name is claimed`,notClaimed:`rooms: the room is not claimed`,noMailbox:`rooms: the room keeps no messages`,badLimit:`rooms: the limit is out of range`,badDescription:`rooms: the description is not one a claim can carry`,notClaimer:`rooms: only the app that claimed the room can describe it`,notReleaser:`rooms: only the app that claimed the room can release it`,badTemporary:`rooms: the temporary duration is not one a claim can carry`,notTemporaryClaimer:`rooms: only the app that claimed the room can set when it expires`,temporaryUnavailable:`rooms: temporary claims are not available`,tooFast:`rooms: sending too fast`,tooLarge:`rooms: the message is too large`,unavailable:`rooms: rooms are unavailable`,notEnabled:`rooms: rooms are not available`,alreadyJoined:`rooms: already joined`,notJoined:`rooms: not joined`,malformed:`rooms: malformed frame`,ended:`rooms: the room has ended`},o=(e,t)=>Object.assign(Error(t),{code:e}),s=e=>e instanceof Error&&typeof e.code==`string`,c={send:!0,receive:!0,maxMessageBytes:262144},l=async()=>{if(!t.l)return;let e=(await t.s(`a room`).catch(()=>void 0))?.rooms;return typeof e?.open==`function`?e:void 0},u=()=>{throw o(`unavailable`,a.unavailable)},d=e=>e===`blocked`?`blocked`:e===`not-found`?`ended`:`unavailable`,f=e=>{if(e!==void 0&&e!==!1)return e===!0?r.ROOM_TEMPORARY_MS.default:typeof e!=`number`||!Number.isInteger(e)?null:e>=r.ROOM_TEMPORARY_MS.min&&e<=r.ROOM_TEMPORARY_MS.max?e:null},p=async e=>{let r=e.invite,i=e,l=0,u=e.self,p=e.owner,m=e.claimed,h=e.mailbox,g=await e.defaults().catch(()=>c),_=!1,v=new Set,y=new Set,b=n.t(`room`),x=()=>{},S=()=>{},C=new Promise(e=>{S=e}),w=e=>{let t=[...y];y.clear();for(let n of t)try{n(e)}catch{}},T=e=>{_||(_=!0,x(),v.clear(),b(),w(o(`closed`,a.ended)),S({reason:e}))},E=e=>{if(!_){e.type===`defaults`&&(g=e.defaults),e.type===`permissions`&&e.id===u.id&&(u={id:u.id,permissions:e.permissions,maxMessageBytes:e.maxMessageBytes}),e.type===`claim`&&(m=e.claimed,p=e.owner,m||(h=null));for(let t of[...v])try{t(e)}catch{}}},D=(e,t)=>{Promise.resolve(e.on(E)).catch(()=>{}),Promise.resolve(e.closed).then(e=>{t===l&&T(e.reason)},()=>{})},O=async(e,t)=>{if(typeof e?.join!=`function`)return T(`unavailable`);let n=await e.join(r).catch(()=>void 0);if(_||t!==l)return;if(!n)return T(`unavailable`);if(`error`in n)return T(d(n.error));if(n.self.id!==u.id)return Promise.resolve(n.leave()).catch(()=>{}),T(`unavailable`);i=n,u=n.self,p=n.owner,m=n.claimed,h=n.mailbox,D(n,t);let a=await n.defaults().catch(()=>void 0);a&&!_&&t===l&&(g=a)};x=t.u((e,t)=>{let n=l;l=t,!(_||n===0||n===t)&&(w(o(`unavailable`,a.unavailable)),O(e.rooms,t))}),D(e,l);let k=async e=>{if(_)throw o(`closed`,a.ended);let t=()=>{},n=new Promise((e,n)=>{t=n});y.add(t);try{return await Promise.race([Promise.resolve(e(i)),n])}catch(e){throw s(e)?e:o(`unavailable`,a.unavailable)}finally{y.delete(t)}},A=async e=>{let t=await k(e);if(`error`in t)throw o(t.error,t.message)},j=async e=>{let t=await k(e);if(typeof t==`object`&&t&&`error`in t)throw o(t.error,t.message);return t};return{id:e.id,name:e.name,key:e.key,invite:r,get self(){return u},get owner(){return p},get claimed(){return m},get mailbox(){return h},defaults:()=>g,members:()=>k(e=>e.members()),send:e=>A(t=>t.send(e)),edit:(e,t)=>A(n=>n.edit(e,t)),delete:(e,t)=>A(n=>n.delete(e,t)),backlog:(e,t)=>j(n=>n.backlog(e,t)),setDefault:(e,t)=>A(n=>n.setDefault(e,t)),limit:(e,t)=>A(n=>n.limit(e,t)),grant:(e,t)=>A(n=>n.grant(e,t)),revoke:(e,t)=>A(n=>n.revoke(e,t)),remove:e=>A(t=>t.remove(e)),block:e=>A(t=>t.block(e)),unblock:e=>A(t=>t.unblock(e)),claim:async e=>{let t=e?.description;if(t!==void 0&&typeof t!=`string`)throw o(`invalid`,a.badDescription);let n=f(e?.temporary);if(n===null)throw o(`invalid`,a.badTemporary);let r={...t===void 0?{}:{description:t},...n===void 0?{}:{temporary:n}};return Object.keys(r).length===0?A(e=>e.claim()):A(e=>{if(n!==void 0&&e.temporaryClaims!==!0)throw o(`unavailable`,a.temporaryUnavailable);return e.claim(r)})},release:()=>A(e=>e.release()),usage:async()=>{let e=await j(e=>e.usage());return h=e,e},on:async e=>_?()=>{}:(v.add(e),()=>{v.delete(e)}),leave:async()=>{await Promise.resolve(i.leave()).catch(()=>{}),T(`left`)},closed:C}},m=async()=>{let e=await l();return e?e.available().catch(()=>!1):!1},h=async(e,t)=>{if(typeof e!=`string`||e.length===0||e.length>72)throw o(`invalid`,a.badName);let n=await l();if(!n)throw o(`unavailable`,a.unavailable);let r=await n.open(e,t).catch(u);if(`error`in r)throw o(r.error,r.message);return p(r)},g=async e=>{let t=await l();if(!t)throw o(`unavailable`,a.unavailable);let n=await t.create(e).catch(u);if(`error`in n)throw o(n.error,n.message);return p(n)},_=async(e,t)=>{let n=typeof e==`string`?e.indexOf(`.`):-1;if(n<=0||n===e.length-1)throw o(`invalid`,a.inviteNoKey);let r=await l();if(!r)throw o(`unavailable`,a.unavailable);let i=await r.join(e,t).catch(u);if(`error`in i)throw o(i.error,i.message);return p(i)};exports.available=m,exports.create=g,exports.join=_,exports.open=h,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api--LOXTOpv.cjs"),n=require("./busy-Dv8wzE5M.cjs"),r=require("./contract.cjs");var i=e.t({available:()=>h,create:()=>_,join:()=>v,open:()=>g}),a={wrongKey:`rooms: wrong room key`,inviteNoKey:`rooms: the invite carries no key`,badName:`rooms: the name is not one a room can have`,badKeyOption:`rooms: the key is not 32 bytes base64url`,noSuchMember:`rooms: no such member`,noSuchMessage:`rooms: no such message`,roomFull:`rooms: the room is full`,tooManyConnections:`rooms: too many connections`,tooManyBlocks:`rooms: too many blocks`,tooManyClaims:`rooms: too many claims`,mailboxFull:`rooms: the mailbox is full`,outOfStorage:`rooms: the owner is out of storage`,outOfQuota:`rooms: out of daily bandwidth`,blocked:`rooms: you are blocked from this room`,cannotSend:`rooms: you cannot send here`,permissionDenied:`rooms: permission denied`,notOwner:`rooms: not the room owner`,ownerNotRemovable:`rooms: the owner cannot be removed`,ownerKeepsEvery:`rooms: the owner keeps every permission`,removeYourself:`rooms: you cannot remove yourself`,needsAccount:`rooms: claiming needs an account`,needsPremium:`rooms: claiming needs premium`,nameClaimed:`rooms: the name is claimed`,notClaimed:`rooms: the room is not claimed`,noMailbox:`rooms: the room keeps no messages`,badLimit:`rooms: the limit is out of range`,badDescription:`rooms: the description is not one a claim can carry`,notClaimer:`rooms: only the app that claimed the room can describe it`,notReleaser:`rooms: only the app that claimed the room can release it`,notClaimingApp:`rooms: only the app that claimed the room can change it`,badTemporary:`rooms: the temporary duration is not one a claim can carry`,notTemporaryClaimer:`rooms: only the app that claimed the room can set when it expires`,temporaryUnavailable:`rooms: temporary claims are not available`,mailboxUnavailable:`rooms: the mailbox switch is not available`,tooFast:`rooms: sending too fast`,tooLarge:`rooms: the message is too large`,unavailable:`rooms: rooms are unavailable`,notEnabled:`rooms: rooms are not available`,alreadyJoined:`rooms: already joined`,notJoined:`rooms: not joined`,malformed:`rooms: malformed frame`,ended:`rooms: the room has ended`},o=(e,t)=>Object.assign(Error(t),{code:e}),s=e=>e instanceof Error&&typeof e.code==`string`,c={send:!0,receive:!0,maxMessageBytes:262144},l=()=>({messages:0,bytes:0,cap:5e8,archived:!1}),u=async()=>{if(!t.l)return;let e=(await t.s(`a room`).catch(()=>void 0))?.rooms;return typeof e?.open==`function`?e:void 0},d=()=>{throw o(`unavailable`,a.unavailable)},f=e=>e===`blocked`?`blocked`:e===`not-found`?`ended`:`unavailable`,p=e=>{if(e!==void 0&&e!==!1)return e===!0?r.ROOM_TEMPORARY_MS.default:typeof e!=`number`||!Number.isInteger(e)?null:e>=r.ROOM_TEMPORARY_MS.min&&e<=r.ROOM_TEMPORARY_MS.max?e:null},m=async e=>{let r=e.invite,i=e,u=0,d=e.self,m=e.owner,h=e.claimed,g=e.mailbox,_=0,v=await e.defaults().catch(()=>c),y=!1,b=new Set,x=new Set,S=n.t(`room`),C=()=>{},w=()=>{},T=new Promise(e=>{w=e}),E=e=>{let t=[...x];x.clear();for(let n of t)try{n(e)}catch{}},D=e=>{y||(y=!0,C(),b.clear(),S(),E(o(`closed`,a.ended)),w({reason:e}))},O=e=>{if(y)return;let t=e;if(t.type===`defaults`&&(v=t.defaults),t.type===`permissions`&&t.id===d.id&&(d={id:d.id,permissions:t.permissions,maxMessageBytes:t.maxMessageBytes}),t.type===`claim`){_+=1;let e=t.claimed&&t.mailbox!==!1;t={type:`claim`,claimed:t.claimed,owner:t.owner,mailbox:e},h=t.claimed,m=t.owner,g=e?l():null}for(let e of[...b])try{e(t)}catch{}},k=(e,t)=>{Promise.resolve(e.on(O)).catch(()=>{}),Promise.resolve(e.closed).then(e=>{t===u&&D(e.reason)},()=>{})},A=async(e,t)=>{if(typeof e?.join!=`function`)return D(`unavailable`);let n=await e.join(r).catch(()=>void 0);if(y||t!==u)return;if(!n)return D(`unavailable`);if(`error`in n)return D(f(n.error));if(n.self.id!==d.id)return Promise.resolve(n.leave()).catch(()=>{}),D(`unavailable`);i=n,d=n.self,m=n.owner,h=n.claimed,g=n.mailbox,k(n,t);let a=await n.defaults().catch(()=>void 0);a&&!y&&t===u&&(v=a)};C=t.u((e,t)=>{let n=u;u=t,!(y||n===0||n===t)&&(E(o(`unavailable`,a.unavailable)),A(e.rooms,t))}),k(e,u);let j=async e=>{if(y)throw o(`closed`,a.ended);let t=()=>{},n=new Promise((e,n)=>{t=n});x.add(t);try{return await Promise.race([Promise.resolve(e(i)),n])}catch(e){throw s(e)?e:o(`unavailable`,a.unavailable)}finally{x.delete(t)}},M=async e=>{let t=await j(e);if(`error`in t)throw o(t.error,t.message)},N=async e=>{let t=await j(e);if(typeof t==`object`&&t&&`error`in t)throw o(t.error,t.message);return t};return{id:e.id,name:e.name,key:e.key,invite:r,get self(){return d},get owner(){return m},get claimed(){return h},get mailbox(){return g},defaults:()=>v,members:()=>j(e=>e.members()),send:e=>M(t=>t.send(e)),edit:(e,t)=>M(n=>n.edit(e,t)),delete:(e,t)=>M(n=>n.delete(e,t)),backlog:(e,t)=>N(n=>n.backlog(e,t)),setDefault:(e,t)=>M(n=>n.setDefault(e,t)),limit:(e,t)=>M(n=>n.limit(e,t)),grant:(e,t)=>M(n=>n.grant(e,t)),revoke:(e,t)=>M(n=>n.revoke(e,t)),remove:e=>M(t=>t.remove(e)),block:e=>M(t=>t.block(e)),unblock:e=>M(t=>t.unblock(e)),claim:async e=>{let t=e?.description;if(t!==void 0&&typeof t!=`string`)throw o(`invalid`,a.badDescription);let n=p(e?.temporary);if(n===null)throw o(`invalid`,a.badTemporary);let r=e?.mailbox;if(r!==void 0&&typeof r!=`boolean`)throw o(`invalid`,a.malformed);let i={...t===void 0?{}:{description:t},...n===void 0?{}:{temporary:n},...r===void 0?{}:{mailbox:r}};return Object.keys(i).length===0?M(e=>e.claim()):M(e=>{if(n!==void 0&&e.temporaryClaims!==!0)throw o(`unavailable`,a.temporaryUnavailable);if(r===!1&&e.mailboxSwitch!==!0)throw o(`unavailable`,a.mailboxUnavailable);return e.claim(i)})},setMailbox:async e=>{if(typeof e!=`boolean`)throw o(`invalid`,a.malformed);let t=_;await M(t=>{if(t.mailboxSwitch!==!0)throw o(`unavailable`,a.mailboxUnavailable);return t.setMailbox(e)}),_===t&&(e?g===null&&(g=l()):g=null)},release:()=>M(e=>e.release()),usage:async()=>{let e=await N(e=>e.usage());return g=e,e},on:async e=>y?()=>{}:(b.add(e),()=>{b.delete(e)}),leave:async()=>{await Promise.resolve(i.leave()).catch(()=>{}),D(`left`)},closed:T}},h=async()=>{let e=await u();return e?e.available().catch(()=>!1):!1},g=async(e,t)=>{if(typeof e!=`string`||e.length===0||e.length>72)throw o(`invalid`,a.badName);let n=await u();if(!n)throw o(`unavailable`,a.unavailable);let r=await n.open(e,t).catch(d);if(`error`in r)throw o(r.error,r.message);return m(r)},_=async e=>{let t=await u();if(!t)throw o(`unavailable`,a.unavailable);let n=await t.create(e).catch(d);if(`error`in n)throw o(n.error,n.message);return m(n)},v=async(e,t)=>{let n=typeof e==`string`?e.indexOf(`.`):-1;if(n<=0||n===e.length-1)throw o(`invalid`,a.inviteNoKey);let r=await u();if(!r)throw o(`unavailable`,a.unavailable);let i=await r.join(e,t).catch(d);if(`error`in i)throw o(i.error,i.message);return m(i)};exports.available=h,exports.create=_,exports.join=v,exports.open=g,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}});

package/rooms.d.ts

@@ -1,4 +1,4 @@
-import { J as RoomClaimOptions, Q as RoomEvent, X as RoomDefaults, Y as RoomCreateOptions, Z as RoomEnd, at as RoomPermission, et as RoomJoinOptions, it as RoomOpenOptions, nt as RoomMember, ot as RoomPermissions, q as RoomBacklog, rt as RoomMessage, st as RoomsErrorCode, tt as RoomMailbox } from "./contract-DJxGa8lb.js";
+import { J as RoomClaimOptions, Q as RoomEvent, X as RoomDefaults, Y as RoomCreateOptions, Z as RoomEnd, at as RoomPermission, et as RoomJoinOptions, it as RoomOpenOptions, nt as RoomMember, ot as RoomPermissions, q as RoomBacklog, rt as RoomMessage, st as RoomsErrorCode, tt as RoomMailbox } from "./contract-6Xfd_qel.js";
 declare namespace rooms_d_exports {
   export { RoomClaimOptions as ClaimOptions, RoomCreateOptions as CreateOptions, RoomJoinOptions as JoinOptions, RoomOpenOptions as OpenOptions, Room, RoomBacklog, RoomDefaults, RoomEnd, RoomEvent, RoomMailbox, RoomMember, RoomMessage, RoomPermission, RoomPermissions, RoomsError, RoomsErrorCode, available, create, join, open };
 }
@@ -22,44 +22,87 @@ export type Room = {
   readonly self: RoomMember;
   /** the owner's member id, or '' while a claimed room's owner has never joined */
   readonly owner: string;
-  /** whether a premium account keeps this name and its messages */
+  /** whether a premium account keeps this name. Whether it keeps the messages too is `mailbox`. */
   readonly claimed: boolean;
   /**
-   * what the mailbox holds, as the room last said. Null for a room nobody has claimed. The account can
-   * clear the room, unclaim it or set a lower `cap` from its fkn.app settings, which the app hears as a
-   * `deleted` or a `claim` event; `usage()` reads the figures again.
+   * what the mailbox holds, as the room last said. Null while the room keeps no messages: nobody has
+   * claimed it, or its claim keeps none. The account can clear the room, unclaim it, turn its messages
+   * off or on, or set a lower `cap` from its fkn.app settings, which the app hears as a `deleted` or a
+   * `claim` event; `usage()` reads the figures again.
    */
   readonly mailbox: RoomMailbox | null;
   defaults: () => RoomDefaults;
   members: () => Promise<RoomMember[]>;
   /** sealed before it leaves the browser. Rejects `too-large` past `self.maxMessageBytes` on the wire, never truncates. */
   send: (text: string) => Promise<void>;
-  /** replaces a stored message's text: one of your own, or any as the owner */
+  /**
+   * replaces a stored message's text: one of your own, or any as the owner. On a room claimed under an
+   * app's scope, from another app of the claim's account, it is refused `denied` (`rooms: only the app
+   * that claimed the room can change it`), the account's own messages included, as `claim` says.
+   */
   edit: (seq: number, text: string) => Promise<void>;
-  /** drops stored messages: one of your own, or any range as the owner */
+  /**
+   * drops stored messages: one of your own, or any range as the owner. On a room claimed under an app's
+   * scope, from another app of the claim's account, it is refused `denied` (`rooms: only the app that
+   * claimed the room can change it`), the account's own messages included, as `claim` says.
+   */
   delete: (from: number, to?: number) => Promise<void>;
   /** replays stored messages above `after` as `message` events marked `replayed`, one page at a time */
   backlog: (after: number, limit?: number) => Promise<RoomBacklog>;
+  /**
+   * whether a member with no override may send or receive, from the owner only (`denied`, `rooms: not
+   * the room owner`). On a room claimed under an app's scope, from another app of the claim's account,
+   * it is refused `denied` (`rooms: only the app that claimed the room can change it`), as `claim` says.
+   */
   setDefault: (permission: 'send' | 'receive', value: boolean) => Promise<void>;
   /**
    * the message size cap, from 1 to 33,554,432. With no id it sets the room default, which is always
-   * a number. With an id it sets that member's override, and null clears the override.
+   * a number. With an id it sets that member's override, and null clears the override. From the owner
+   * only (`denied`, `rooms: not the room owner`); on a room claimed under an app's scope, from another
+   * app of the claim's account, it is refused `denied` (`rooms: only the app that claimed the room can
+   * change it`), as `claim` says.
    */
   limit: {
     (maxMessageBytes: number, id?: string): Promise<void>;
     (maxMessageBytes: number | null, id: string): Promise<void>;
   };
+  /**
+   * gives a member a permission over the room default, from the owner only (`denied`, `rooms: not the
+   * room owner`). On a room claimed under an app's scope, from another app of the claim's account, it is
+   * refused `denied` (`rooms: only the app that claimed the room can change it`), as `claim` says.
+   */
   grant: (id: string, permission: RoomPermission) => Promise<void>;
+  /**
+   * takes a permission from a member over the room default, from the owner only (`denied`, `rooms: not
+   * the room owner`). On a room claimed under an app's scope, from another app of the claim's account, it
+   * is refused `denied` (`rooms: only the app that claimed the room can change it`), as `claim` says.
+   */
   revoke: (id: string, permission: RoomPermission) => Promise<void>;
+  /**
+   * sends a member out of the room, which they may join again, with the `remove` permission (`denied`,
+   * `rooms: permission denied`). On a room claimed under an app's scope, from another app of the claim's
+   * account, it is refused `denied` (`rooms: only the app that claimed the room can change it`), as
+   * `claim` says.
+   */
   remove: (id: string) => Promise<void>;
+  /**
+   * sends a member out of the room and keeps them out, with the `block` permission (`denied`, `rooms:
+   * permission denied`). On a room claimed under an app's scope, from another app of the claim's account,
+   * it is refused `denied` (`rooms: only the app that claimed the room can change it`), as `claim` says.
+   */
   block: (id: string) => Promise<void>;
+  /**
+   * lets a blocked member join again, with the `block` permission (`denied`, `rooms: permission denied`).
+   * On a room claimed under an app's scope, from another app of the claim's account, it is refused
+   * `denied` (`rooms: only the app that claimed the room can change it`), as `claim` says.
+   */
   unblock: (id: string) => Promise<void>;
   /**
-   * keeps the name and a mailbox for the signed-in premium account. The only thing in rooms that premium
-   * buys. `description` says what the room is for, shown to the account in its fkn.app settings; a
-   * permanent claim with an unchanged one on every open is free. Claiming on every open also claims the
-   * room again after the account unclaims it from fkn.app, so claim when the person wants the room kept,
-   * or make it `temporary`.
+   * keeps the name for the signed-in premium account, and a mailbox unless asked not to. The only thing
+   * in rooms that premium buys. `description` says what the room is for, shown to the account in its
+   * fkn.app settings; a permanent claim with an unchanged one on every open is free. Claiming on every
+   * open also claims the room again after the account unclaims it from fkn.app, so claim when the person
+   * wants the room kept, or make it `temporary`.
    *
    * `temporary` makes the claim end by itself, in milliseconds (`true` is 7 days), that long after its
    * last claim: a temporary claim goes to the account's ledger every time, which is what restarts its
@@ -67,6 +110,22 @@ export type Room = {
    * from fkn.app, and the stored messages are gone. A broker too old to carry it refuses the call
    * `unavailable` (`rooms: temporary claims are not available`) rather than make the claim permanent.
    *
+   * `mailbox: false` keeps the name and stores nothing: the room relays as an unclaimed one does. It is
+   * read only when the call starts the claim and ignored on a room the account already holds, so claiming
+   * on every open never undoes the owner's choice.
+   *
+   * Who changes a claimed room depends on its scope. A room under an app's scope, which is every room
+   * but a `global` one, is changed by the claim's account only through the app that claimed it (the
+   * same app once it is verified): from another app of the account `setDefault`, `limit`, `grant`,
+   * `revoke`, `remove`, `block`, `unblock`, `setMailbox`, `edit` and `delete` are refused `denied`
+   * (`rooms: only the app that claimed the room can change it`), the account's own messages included,
+   * and nothing changes. That other app, which reaches the room through its invite, still joins, reads
+   * and sends. A claimed `global` room is changed by any app of the account, which also describes it,
+   * sets its `temporary` and releases it. The account changes every room it claimed
+   * from its fkn.app settings, whichever app claimed it, and members of other accounts are answered as
+   * in any room. While the room cannot tell whether two apps are one, such a change is refused
+   * `unavailable` (`rooms: rooms are unavailable`) and can be sent again.
+   *
    * Past the account's room limit the call waits while fkn.app shows the person their claimed rooms over
    * your app, with Unclaim on each: it resolves once one is unclaimed and this claim is made, and rejects
    * `full` (`rooms: too many claims`) when they close the card or when fkn.app cannot show it. Nothing
@@ -74,8 +133,28 @@ export type Room = {
    */
   claim: (options?: RoomClaimOptions) => Promise<void>;
   /**
-   * gives the claim back: the mailbox is deleted and whoever is present stays in an ordinary room. The app
-   * that claimed the room only; the account can also unclaim it from its fkn.app settings.
+   * turns a claimed room's mailbox off or on, from the room's owner only, which in a claimed room is the
+   * claim's account. Off deletes every stored message at once, the archive included, and the room then
+   * relays as an unclaimed one does while keeping its claim; whoever is present hears a `claim` event
+   * with `mailbox: false` and no `deleted`, so what an app shows stays. On starts an empty mailbox that
+   * keeps messages from the next `seq`, and nothing deleted comes back. Turning it on needs premium, as a
+   * claim does (`denied`, `rooms: claiming needs premium`); turning it off never does. Setting what it
+   * already is changes nothing. Resolves once the room answered, with `mailbox` reading the new state,
+   * or a newer one when a release or the account's own switch landed before the answer.
+   *
+   * Refused `invalid` (`rooms: the room is not claimed`) on an unclaimed room, `denied` (`rooms: not the
+   * room owner`) from anyone else, `denied` (`rooms: only the app that claimed the room can change it`)
+   * from another app of the claim's account on a room claimed under an app's scope, as `claim` says, and
+   * `invalid` (`rooms: malformed frame`) for anything but a boolean. A broker too old to carry it refuses
+   * `unavailable` (`rooms: the mailbox switch is not available`). The account can do the same from its
+   * fkn.app settings, whichever app claimed the room.
+   */
+  setMailbox: (on: boolean) => Promise<void>;
+  /**
+   * gives the claim back: the mailbox is deleted and whoever is present stays in an ordinary room. On a
+   * room under an app's scope, the app that claimed it only (the same app once it is verified), and from
+   * another app it is refused `denied` (`rooms: only the app that claimed the room can release it`); on a
+   * `global` room, any app of the account. The account can also unclaim it from its fkn.app settings.
    */
   release: () => Promise<void>;
   usage: () => Promise<RoomMailbox | null>;

package/rooms.js

@@ -4,10 +4,10 @@ import { t as i } from "./busy-B189uX--.js";
 import { ROOM_TEMPORARY_MS as a } from "./contract.js";
 //#region src/rooms.ts
 var o = /* @__PURE__ */ e({
-	available: () => g,
-	create: () => v,
-	join: () => y,
-	open: () => _
+	available: () => _,
+	create: () => y,
+	join: () => b,
+	open: () => v
 }), s = {
 	wrongKey: "rooms: wrong room key",
 	inviteNoKey: "rooms: the invite carries no key",
@@ -38,9 +38,11 @@ var o = /* @__PURE__ */ e({
 	badDescription: "rooms: the description is not one a claim can carry",
 	notClaimer: "rooms: only the app that claimed the room can describe it",
 	notReleaser: "rooms: only the app that claimed the room can release it",
+	notClaimingApp: "rooms: only the app that claimed the room can change it",
 	badTemporary: "rooms: the temporary duration is not one a claim can carry",
 	notTemporaryClaimer: "rooms: only the app that claimed the room can set when it expires",
 	temporaryUnavailable: "rooms: temporary claims are not available",
+	mailboxUnavailable: "rooms: the mailbox switch is not available",
 	tooFast: "rooms: sending too fast",
 	tooLarge: "rooms: the message is too large",
 	unavailable: "rooms: rooms are unavailable",
@@ -53,73 +55,87 @@ var o = /* @__PURE__ */ e({
 	send: !0,
 	receive: !0,
 	maxMessageBytes: 262144
-}, d = async () => {
+}, d = () => ({
+	messages: 0,
+	bytes: 0,
+	cap: 5e8,
+	archived: !1
+}), f = async () => {
 	if (!t) return;
 	let e = (await n("a room").catch(() => void 0))?.rooms;
 	return typeof e?.open == "function" ? e : void 0;
-}, f = () => {
+}, p = () => {
 	throw c("unavailable", s.unavailable);
-}, p = (e) => e === "blocked" ? "blocked" : e === "not-found" ? "ended" : "unavailable", m = (e) => {
+}, m = (e) => e === "blocked" ? "blocked" : e === "not-found" ? "ended" : "unavailable", h = (e) => {
 	if (e !== void 0 && e !== !1) return e === !0 ? a.default : typeof e != "number" || !Number.isInteger(e) ? null : e >= a.min && e <= a.max ? e : null;
-}, h = async (e) => {
-	let t = e.invite, n = e, a = 0, o = e.self, d = e.owner, f = e.claimed, h = e.mailbox, g = await e.defaults().catch(() => u), _ = !1, v = /* @__PURE__ */ new Set(), y = /* @__PURE__ */ new Set(), b = i("room"), x = () => {}, S = () => {}, C = new Promise((e) => {
-		S = e;
-	}), w = (e) => {
-		let t = [...y];
-		y.clear();
+}, g = async (e) => {
+	let t = e.invite, n = e, a = 0, o = e.self, f = e.owner, p = e.claimed, g = e.mailbox, _ = 0, v = await e.defaults().catch(() => u), y = !1, b = /* @__PURE__ */ new Set(), x = /* @__PURE__ */ new Set(), S = i("room"), C = () => {}, w = () => {}, T = new Promise((e) => {
+		w = e;
+	}), E = (e) => {
+		let t = [...x];
+		x.clear();
 		for (let n of t) try {
 			n(e);
 		} catch {}
-	}, T = (e) => {
-		_ || (_ = !0, x(), v.clear(), b(), w(c("closed", s.ended)), S({ reason: e }));
-	}, E = (e) => {
-		if (!_) {
-			e.type === "defaults" && (g = e.defaults), e.type === "permissions" && e.id === o.id && (o = {
-				id: o.id,
-				permissions: e.permissions,
-				maxMessageBytes: e.maxMessageBytes
-			}), e.type === "claim" && (f = e.claimed, d = e.owner, f || (h = null));
-			for (let t of [...v]) try {
-				t(e);
-			} catch {}
+	}, D = (e) => {
+		y || (y = !0, C(), b.clear(), S(), E(c("closed", s.ended)), w({ reason: e }));
+	}, O = (e) => {
+		if (y) return;
+		let t = e;
+		if (t.type === "defaults" && (v = t.defaults), t.type === "permissions" && t.id === o.id && (o = {
+			id: o.id,
+			permissions: t.permissions,
+			maxMessageBytes: t.maxMessageBytes
+		}), t.type === "claim") {
+			_ += 1;
+			let e = t.claimed && t.mailbox !== !1;
+			t = {
+				type: "claim",
+				claimed: t.claimed,
+				owner: t.owner,
+				mailbox: e
+			}, p = t.claimed, f = t.owner, g = e ? d() : null;
 		}
-	}, D = (e, t) => {
-		Promise.resolve(e.on(E)).catch(() => {}), Promise.resolve(e.closed).then((e) => {
-			t === a && T(e.reason);
+		for (let e of [...b]) try {
+			e(t);
+		} catch {}
+	}, k = (e, t) => {
+		Promise.resolve(e.on(O)).catch(() => {}), Promise.resolve(e.closed).then((e) => {
+			t === a && D(e.reason);
 		}, () => {});
-	}, O = async (e, r) => {
-		if (typeof e?.join != "function") return T("unavailable");
+	}, A = async (e, r) => {
+		if (typeof e?.join != "function") return D("unavailable");
 		let i = await e.join(t).catch(() => void 0);
-		if (_ || r !== a) return;
-		if (!i) return T("unavailable");
-		if ("error" in i) return T(p(i.error));
-		if (i.self.id !== o.id) return Promise.resolve(i.leave()).catch(() => {}), T("unavailable");
-		n = i, o = i.self, d = i.owner, f = i.claimed, h = i.mailbox, D(i, r);
+		if (y || r !== a) return;
+		if (!i) return D("unavailable");
+		if ("error" in i) return D(m(i.error));
+		if (i.self.id !== o.id) return Promise.resolve(i.leave()).catch(() => {}), D("unavailable");
+		n = i, o = i.self, f = i.owner, p = i.claimed, g = i.mailbox, k(i, r);
 		let s = await i.defaults().catch(() => void 0);
-		s && !_ && r === a && (g = s);
+		s && !y && r === a && (v = s);
 	};
-	x = r((e, t) => {
+	C = r((e, t) => {
 		let n = a;
-		a = t, !(_ || n === 0 || n === t) && (w(c("unavailable", s.unavailable)), O(e.rooms, t));
-	}), D(e, a);
-	let k = async (e) => {
-		if (_) throw c("closed", s.ended);
+		a = t, !(y || n === 0 || n === t) && (E(c("unavailable", s.unavailable)), A(e.rooms, t));
+	}), k(e, a);
+	let j = async (e) => {
+		if (y) throw c("closed", s.ended);
 		let t = () => {}, r = new Promise((e, n) => {
 			t = n;
 		});
-		y.add(t);
+		x.add(t);
 		try {
 			return await Promise.race([Promise.resolve(e(n)), r]);
 		} catch (e) {
 			throw l(e) ? e : c("unavailable", s.unavailable);
 		} finally {
-			y.delete(t);
+			x.delete(t);
 		}
-	}, A = async (e) => {
-		let t = await k(e);
+	}, M = async (e) => {
+		let t = await j(e);
 		if ("error" in t) throw c(t.error, t.message);
-	}, j = async (e) => {
-		let t = await k(e);
+	}, N = async (e) => {
+		let t = await j(e);
 		if (typeof t == "object" && t && "error" in t) throw c(t.error, t.message);
 		return t;
 	};
@@ -132,78 +148,90 @@ var o = /* @__PURE__ */ e({
 			return o;
 		},
 		get owner() {
-			return d;
+			return f;
 		},
 		get claimed() {
-			return f;
+			return p;
 		},
 		get mailbox() {
-			return h;
+			return g;
 		},
-		defaults: () => g,
-		members: () => k((e) => e.members()),
-		send: (e) => A((t) => t.send(e)),
-		edit: (e, t) => A((n) => n.edit(e, t)),
-		delete: (e, t) => A((n) => n.delete(e, t)),
-		backlog: (e, t) => j((n) => n.backlog(e, t)),
-		setDefault: (e, t) => A((n) => n.setDefault(e, t)),
-		limit: (e, t) => A((n) => n.limit(e, t)),
-		grant: (e, t) => A((n) => n.grant(e, t)),
-		revoke: (e, t) => A((n) => n.revoke(e, t)),
-		remove: (e) => A((t) => t.remove(e)),
-		block: (e) => A((t) => t.block(e)),
-		unblock: (e) => A((t) => t.unblock(e)),
+		defaults: () => v,
+		members: () => j((e) => e.members()),
+		send: (e) => M((t) => t.send(e)),
+		edit: (e, t) => M((n) => n.edit(e, t)),
+		delete: (e, t) => M((n) => n.delete(e, t)),
+		backlog: (e, t) => N((n) => n.backlog(e, t)),
+		setDefault: (e, t) => M((n) => n.setDefault(e, t)),
+		limit: (e, t) => M((n) => n.limit(e, t)),
+		grant: (e, t) => M((n) => n.grant(e, t)),
+		revoke: (e, t) => M((n) => n.revoke(e, t)),
+		remove: (e) => M((t) => t.remove(e)),
+		block: (e) => M((t) => t.block(e)),
+		unblock: (e) => M((t) => t.unblock(e)),
 		claim: async (e) => {
 			let t = e?.description;
 			if (t !== void 0 && typeof t != "string") throw c("invalid", s.badDescription);
-			let n = m(e?.temporary);
+			let n = h(e?.temporary);
 			if (n === null) throw c("invalid", s.badTemporary);
-			let r = {
+			let r = e?.mailbox;
+			if (r !== void 0 && typeof r != "boolean") throw c("invalid", s.malformed);
+			let i = {
 				...t === void 0 ? {} : { description: t },
-				...n === void 0 ? {} : { temporary: n }
+				...n === void 0 ? {} : { temporary: n },
+				...r === void 0 ? {} : { mailbox: r }
 			};
-			return Object.keys(r).length === 0 ? A((e) => e.claim()) : A((e) => {
+			return Object.keys(i).length === 0 ? M((e) => e.claim()) : M((e) => {
 				if (n !== void 0 && e.temporaryClaims !== !0) throw c("unavailable", s.temporaryUnavailable);
-				return e.claim(r);
+				if (r === !1 && e.mailboxSwitch !== !0) throw c("unavailable", s.mailboxUnavailable);
+				return e.claim(i);
 			});
 		},
-		release: () => A((e) => e.release()),
+		setMailbox: async (e) => {
+			if (typeof e != "boolean") throw c("invalid", s.malformed);
+			let t = _;
+			await M((t) => {
+				if (t.mailboxSwitch !== !0) throw c("unavailable", s.mailboxUnavailable);
+				return t.setMailbox(e);
+			}), _ === t && (e ? g === null && (g = d()) : g = null);
+		},
+		release: () => M((e) => e.release()),
 		usage: async () => {
-			let e = await j((e) => e.usage());
-			return h = e, e;
+			let e = await N((e) => e.usage());
+			return g = e, e;
 		},
-		on: async (e) => _ ? () => {} : (v.add(e), () => {
-			v.delete(e);
+		on: async (e) => y ? () => {} : (b.add(e), () => {
+			b.delete(e);
 		}),
 		leave: async () => {
-			await Promise.resolve(n.leave()).catch(() => {}), T("left");
+			await Promise.resolve(n.leave()).catch(() => {}), D("left");
 		},
-		closed: C
+		closed: T
 	};
-}, g = async () => {
-	let e = await d();
+}, _ = async () => {
+	let e = await f();
 	return e ? e.available().catch(() => !1) : !1;
-}, _ = async (e, t) => {
+}, v = async (e, t) => {
 	if (typeof e != "string" || e.length === 0 || e.length > 72) throw c("invalid", s.badName);
-	let n = await d();
+	let n = await f();
 	if (!n) throw c("unavailable", s.unavailable);
-	let r = await n.open(e, t).catch(f);
+	let r = await n.open(e, t).catch(p);
 	if ("error" in r) throw c(r.error, r.message);
-	return h(r);
-}, v = async (e) => {
-	let t = await d();
+	return g(r);
+}, y = async (e) => {
+	let t = await f();
 	if (!t) throw c("unavailable", s.unavailable);
-	let n = await t.create(e).catch(f);
+	let n = await t.create(e).catch(p);
 	if ("error" in n) throw c(n.error, n.message);
-	return h(n);
-}, y = async (e, t) => {
+	return g(n);
+}, b = async (e, t) => {
 	let n = typeof e == "string" ? e.indexOf(".") : -1;
 	if (n <= 0 || n === e.length - 1) throw c("invalid", s.inviteNoKey);
-	let r = await d();
+	let r = await f();
 	if (!r) throw c("unavailable", s.unavailable);
-	let i = await r.join(e, t).catch(f);
+	let i = await r.join(e, t).catch(p);
 	if ("error" in i) throw c(i.error, i.message);
-	return h(i);
+	return g(i);
 };
 //#endregion
-export { g as available, v as create, y as join, _ as open, o as t };
+export { _ as available, y as create, b as join, v as open, o as t };

package/{storage-BVr2Rb-d.d.ts → storage-BLBsmkmp.d.ts}

@@ -7,12 +7,10 @@ type FileEntry$1 = {
 };
 type WriteData$1 = Blob | ArrayBuffer | Uint8Array | string;
 /**
- * Which account a cloud call belongs to. Library plumbing that app code never passes: an operation of
- * several calls (a rename, a mount, a queue drain) captures one when it starts, so none of its calls
- * can land in an account the realm switched to meanwhile.
- *
- * `{ generation }` is a ticket from `captureAccount()`: its calls carry that generation's pin. `{ pin }`
- * is a pin a queued entry was stamped with, sent as is.
+ * Which account a cloud call belongs to; library plumbing app code never passes. A multi-call
+ * operation (a rename, a mount, a queue drain) captures one at its start so no call lands in an
+ * account the realm switched to meanwhile. `{ generation }` is a ticket from `captureAccount()`;
+ * `{ pin }` is the pin a queued entry was stamped with, sent as is.
  */
 type PinFrom = {
   readonly generation: number;
@@ -61,18 +59,12 @@ declare class StorageLockedError extends Error {
   constructor();
 }
 /**
- * There is no object at this path. Test `err.code === STORAGE_NOT_FOUND`, never the message.
- *
- * Absence arrives from two places that word it completely differently: the api refusing to presign
- * a path with no committed row says "Not found", and a presign that succeeded followed by an object
- * fetch that 404s says "storage: read failed (404)". Neither is a fault, both mean the same thing,
- * and matching either by hand means matching both. Ripple matched only the first, so a missing
- * backup read as a transient failure, retried forever, and a library went un-backed-up for a day
- * without a single error anywhere.
+ * There is no object at this path. Test `err.code === STORAGE_NOT_FOUND`, never the message: absence
+ * is worded differently by the presign ("Not found") and by the object fetch ("storage: read failed
+ * (404)").
  *
- * The distinction matters more than it sounds. "There is nothing here" is safe to overwrite;
- * "I could not tell you" is not, and a caller that confuses them either never writes a first
- * backup or destroys a real one.
+ * "There is nothing here" is safe to overwrite; "I could not tell you" is not, and a caller that
+ * confuses them either never writes a first backup or destroys a real one.
  */
 declare class StorageNotFoundError extends Error {
   code: string;
@@ -114,7 +106,6 @@ declare class StorageAccountPinUnsupportedError extends Error {
 declare const isAccountChanged: (error: unknown) => boolean;
 /** Whether the api could not read a pin at all (a queued entry's record damaged on the device). */
 declare const isInvalidPin: (error: unknown) => boolean;
-/** One account generation of this realm, captured when an operation started. */
 type AccountTicket = {
   readonly generation: number;
 };
@@ -145,16 +136,11 @@ type SealedRead = {
 /**
  * A cloud read that also reports when the copy was sealed.
  *
- * `sealedAt` is an ISO string, or null when the envelope carries no such field (one written before
- * the seal time existed) or when the data plane is older than this call. The value is
- * AUTHENTICATED, so the server can neither forge nor alter it, and it is the WRITER's own claim
- * about when it sealed, so on its own it does not prove this copy is the newest one: an older but
- * perfectly authentic copy of the same path is still authentic. An app that needs that answer keeps
- * a high-water mark per path and compares. Do not confuse it with the `updatedAt` on a listing,
- * which is the server's hint and is fine for display and nothing else.
- *
- * The bytes and the stamp come from ONE read of ONE envelope, which is what makes the stamp
- * describe the bytes returned beside it. `readFile` is unchanged and unaffected.
+ * `sealedAt` is an ISO string, or null for an envelope written before the seal time existed or a
+ * data plane older than this call. It is authenticated, so the server can neither forge nor alter
+ * it, but it is the WRITER's claim: it does not prove this copy is the newest, so an app that needs
+ * that keeps a high-water mark per path. The listing's `updatedAt` is a server hint, for display only.
+ * The bytes and the stamp come from one read of one envelope.
  */
 declare const readFileSealed: (path: string, opts?: PinOptions) => Promise<SealedRead>;
 declare const writeFile: (path: string, data: WriteData, opts?: {

package/{wire-Gbo-D74t.d.ts → wire-BwA4JjZH.d.ts}

@@ -2,19 +2,13 @@
 /**
  * Socket option codes as they appear on the WebVPN wire, and the option shapes built from them.
  *
- * These live in the library rather than beside the packet codecs because BOTH sides need them and
- * only one side may own them. `@fkn/lib` already imported these constants at value level (see
- * `webvpn/net.ts` and `webvpn/dgram.ts`), so the previous arrangement had the published package
- * reaching into `src/api/webvpn/packets/*` for its own vocabulary, which dragged those modules and
- * their imports into the library's type program.
+ * Owned by the library so both sides share one source: the packet codecs in
+ * `src/api/webvpn/packets/` import from this file, and the library needs nothing from the app.
  *
- * Owning them here inverts that: the codecs in `src/api/webvpn/packets/` import from this file, and
- * the library needs nothing from the app to describe a socket option.
- *
- * The VALUES are protocol. They are the u8 discriminant of a tagged union nested inside a
- * TcpSetOption or UdpSetOption client packet (metadata-stream tag 8), and a relay built against
- * these numbers is deployed independently of any browser holding this file. Renumbering one is a
- * wire break, not a refactor. Booleans go on the wire as u8, 0 for false and anything else true.
+ * The VALUES are protocol: the u8 discriminant of a tagged union inside a TcpSetOption or
+ * UdpSetOption client packet (metadata-stream tag 8). A relay built against these numbers deploys
+ * independently of any browser holding this file, so renumbering one is a wire break. Booleans go
+ * on the wire as u8, 0 for false and anything else true.
  */
 declare const TCP_OPTION_NODELAY: 0;
 declare const TCP_OPTION_TTL: 1;

package/wire.d.ts

@@ -1,2 +1,2 @@
-import { _ as UDP_OPTION_TTL, a as TCP_OPTION_TTL, c as UDP_OPTION_ADD_MEMBERSHIP_V6, d as UDP_OPTION_DROP_MEMBERSHIP_V6, f as UDP_OPTION_MULTICAST_LOOP_V4, g as UDP_OPTION_SEND_BUFFER_SIZE, h as UDP_OPTION_RECV_BUFFER_SIZE, i as TCP_OPTION_SEND_BUFFER_SIZE, l as UDP_OPTION_BROADCAST, m as UDP_OPTION_MULTICAST_TTL_V4, n as TCP_OPTION_NODELAY, o as TcpSocketOption, p as UDP_OPTION_MULTICAST_LOOP_V6, r as TCP_OPTION_RECV_BUFFER_SIZE, s as UDP_OPTION_ADD_MEMBERSHIP_V4, t as TCP_OPTION_KEEPALIVE, u as UDP_OPTION_DROP_MEMBERSHIP_V4, v as UdpSocketOption } from "./wire-Gbo-D74t.js";
+import { _ as UDP_OPTION_TTL, a as TCP_OPTION_TTL, c as UDP_OPTION_ADD_MEMBERSHIP_V6, d as UDP_OPTION_DROP_MEMBERSHIP_V6, f as UDP_OPTION_MULTICAST_LOOP_V4, g as UDP_OPTION_SEND_BUFFER_SIZE, h as UDP_OPTION_RECV_BUFFER_SIZE, i as TCP_OPTION_SEND_BUFFER_SIZE, l as UDP_OPTION_BROADCAST, m as UDP_OPTION_MULTICAST_TTL_V4, n as TCP_OPTION_NODELAY, o as TcpSocketOption, p as UDP_OPTION_MULTICAST_LOOP_V6, r as TCP_OPTION_RECV_BUFFER_SIZE, s as UDP_OPTION_ADD_MEMBERSHIP_V4, t as TCP_OPTION_KEEPALIVE, u as UDP_OPTION_DROP_MEMBERSHIP_V4, v as UdpSocketOption } from "./wire-BwA4JjZH.js";
 export { TCP_OPTION_KEEPALIVE, TCP_OPTION_NODELAY, TCP_OPTION_RECV_BUFFER_SIZE, TCP_OPTION_SEND_BUFFER_SIZE, TCP_OPTION_TTL, TcpSocketOption, UDP_OPTION_ADD_MEMBERSHIP_V4, UDP_OPTION_ADD_MEMBERSHIP_V6, UDP_OPTION_BROADCAST, UDP_OPTION_DROP_MEMBERSHIP_V4, UDP_OPTION_DROP_MEMBERSHIP_V6, UDP_OPTION_MULTICAST_LOOP_V4, UDP_OPTION_MULTICAST_LOOP_V6, UDP_OPTION_MULTICAST_TTL_V4, UDP_OPTION_RECV_BUFFER_SIZE, UDP_OPTION_SEND_BUFFER_SIZE, UDP_OPTION_TTL, UdpSocketOption };