@kubun/plugin-p2p 0.8.1 → 0.8.2

package/lib/context/group.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutionContext } from '@kubun/engine';
+import type { GroupRequestContext } from '../types.js';
+import type { ContextDeps } from './types.js';
+export declare function createGroupContext(ctx: ExecutionContext, deps: ContextDeps): GroupRequestContext;

package/lib/context/group.js

@@ -0,0 +1 @@
+import{HLC as e}from"@kubun/hlc";import{getGraphStore as t}from"@kubun/store-graph";import{getP2PStore as r}from"@kubun/store-p2p";import{decodeFullJoinRequest as a,decodeInvitePayload as i,decodeJoinRequest as o,encodeInvitePayload as c}from"../groups/invite-payload.js";import{createGroupFromJoin as n}from"../groups/join-utils.js";import{restoreMLSGroupHandle as d}from"../groups/mls-group-handle.js";import{checkPeerAccess as l,normalizeCredential as p,toISO as s}from"./types.js";export function createGroupContext(m,u){let g=null,w=null,D=()=>g??=r(u.stores),I=()=>w??=t(u.stores);return{p2pCreateGroup:async e=>{let t=await u.groupManager.createGroup({stores:u.stores,identity:u.identity,name:e.name,description:e.description,createdBy:m.viewerDID}),r=await D(),a=await r.getGroup(t.groupID);if(null==a)throw Error("Failed to create group");let i={id:a.id,name:a.name,description:a.description,createdBy:a.created_by,createdAt:s(a.created_at)};return await u.emitter.emit("groupJoined",i),i},p2pGetGroups:async()=>{let e=await D();return(await e.listGroups()).map(e=>({id:e.id,name:e.name,description:e.description,createdBy:e.created_by,createdAt:s(e.created_at)}))},p2pGetGroup:async e=>{let t=await D(),r=await t.getGroup(e);return null==r?null:{id:r.id,name:r.name,description:r.description,createdBy:r.created_by,createdAt:s(r.created_at)}},p2pAddGroupMember:async(e,t,r)=>{let a=await D();await a.addGroupMember({group_id:e,member_did:t,role:r});let i=await a.getGroupMember(e,t);if(null==i)throw Error("Failed to add group member");let o={groupID:i.group_id,memberDID:i.member_did,role:i.role,createdAt:s(i.created_at)};return await u.emitter.emit("groupMemberJoined",{...o,groupID:o.groupID}),o},p2pGetGroupMembers:async e=>{let t=await D();return(await t.listGroupMembers(e)).map(e=>({groupID:e.group_id,memberDID:e.member_did,role:e.role,createdAt:s(e.created_at)}))},p2pCreateCircle:async e=>{let t=await u.groupManager.createCircle({stores:u.stores,groupID:e.groupID,name:e.name,description:e.description}),r=await D(),a=await r.getCircle(t.circleID);if(null==a)throw Error("Failed to create circle");let i={id:a.id,groupID:a.group_id,name:a.name,description:a.description,createdAt:s(a.created_at)};return await u.emitter.emit("circleCreated",{...i,groupID:i.groupID}),i},p2pGetCircles:async e=>{let t=await D();return(await t.listCirclesByGroup(e)).map(e=>({id:e.id,groupID:e.group_id,name:e.name,description:e.description,createdAt:s(e.created_at)}))},p2pAddCircleMember:async(t,r,a)=>{let i=await D(),o=e.serialize(u.hlc.now());await i.addCircleMember({circle_id:t,member_did:r,role:a,hlc:o});let c=(await i.listCircleMembers(t)).find(e=>e.member_did===r);if(null==c)throw Error("Failed to add circle member");let n={circleID:c.circle_id,memberDID:c.member_did,role:c.role,createdAt:s(c.created_at)};return await u.emitter.emit("circleMemberAdded",{...n,circleID:n.circleID}),n},p2pCreateCatalog:async t=>{let r=await I(),a=u.runtime.getRandomID(),i=e.serialize(u.hlc.now());await r.createCatalog({id:a,owner_did:m.viewerDID,name:t.name,description:t.description??"",filter_criteria:JSON.parse(t.filterCriteria),hlc:i});let o=await r.getCatalog(a);if(null==o)throw Error("Failed to create catalog");return{id:o.id,ownerDID:o.owner_did,name:o.name,description:o.description,filterCriteria:JSON.stringify(o.filter_criteria),createdAt:s(o.created_at)}},p2pGetCatalogs:async e=>{let t=await I();if(null!=e)return(await t.listCatalogs(e)).map(e=>({id:e.id,ownerDID:e.owner_did,name:e.name,description:e.description,filterCriteria:JSON.stringify(e.filter_criteria),createdAt:s(e.created_at)}));let r=await D(),a=new Set((await r.listGroups()).map(e=>e.created_by));return(await Promise.all(Array.from(a).map(e=>t.listCatalogs(e)))).flat().map(e=>({id:e.id,ownerDID:e.owner_did,name:e.name,description:e.description,filterCriteria:JSON.stringify(e.filter_criteria),createdAt:s(e.created_at)}))},p2pInviteToGroup:async(e,t)=>{l(m.viewerDID,u.identity.id,u.autoAcceptPeers);let r=await D(),a=u.identity,i=await r.getMLSState(e,a.id);if(null==i)throw Error(`No MLS state for group ${e}`);let n=await d({mlsState:i.mls_state,credential:p(i.credential),epoch:i.epoch,rootCapability:i.root_capability}),s=o(t),g=await u.groupManager.inviteToGroup({stores:u.stores,groupID:e,identity:a,groupHandle:n,recipientDID:s.did,recipientKeyPackage:s.publicPackage,permission:"member"}),w=await r.getGroup(e),I=c({groupID:e,groupName:w?.name??"",hubURLs:w?.hub_urls??[],invite:g.invite,welcomeMessage:g.welcomeMessage,ratchetTree:g.updatedGroupHandle.state.ratchetTree});return await u.emitter.emit("groupMemberJoined",{groupID:e,memberDID:s.did,role:"member",createdAt:new Date().toISOString()}),{invitePayload:I,groupID:e,groupName:w?.name??""}},p2pJoinGroup:async(e,t)=>{let r=u.identity,o=i(e),c=a(t),d={publicPackage:c.publicPackage,privatePackage:c.privatePackage,ownerDID:c.did};return await u.groupManager.joinGroup({stores:u.stores,identity:r,groupID:o.groupID,groupName:o.groupName,hubURLs:o.hubURLs,invite:o.invite,keyPackageBundle:d,welcomeMessage:o.welcomeMessage,ratchetTree:o.ratchetTree}),await n({stores:u.stores,hlc:u.hlc,emitter:u.emitter,identity:r,invite:o})},p2pLeaveGroup:async e=>{let t=await D(),r=await t.getGroup(e),a=u.identity;return await u.groupManager.leaveGroup({stores:u.stores,groupID:e,identity:a}),null!=r&&await u.emitter.emit("groupLeft",{id:r.id,name:r.name,description:r.description,createdBy:r.created_by,createdAt:s(r.created_at),groupID:e}),{groupID:e}},p2pRemoveGroupMember:async(e,t)=>{let r=await D(),a=u.identity,i=await r.getMLSState(e,a.id);if(null==i)throw Error(`No MLS state for group ${e}`);let o=await d({mlsState:i.mls_state,credential:p(i.credential),epoch:i.epoch,rootCapability:i.root_capability});return await u.groupManager.removeGroupMember({stores:u.stores,groupID:e,groupHandle:o,memberDID:t}),await u.emitter.emit("groupMemberLeft",{groupID:e,memberDID:t,role:"",createdAt:new Date().toISOString()}),{groupID:e}},p2pUpdateGroup:async e=>{await u.groupManager.updateGroup({stores:u.stores,groupID:e.groupID,update:{name:e.name,description:e.description}});let t=await D(),r=await t.getGroup(e.groupID);if(null==r)throw Error(`Group ${e.groupID} not found`);let a={id:r.id,name:r.name,description:r.description,createdBy:r.created_by,createdAt:s(r.created_at)};return await u.emitter.emit("groupDataChanged",{...a,groupID:e.groupID}),a},p2pUpdateCircle:async e=>{await u.groupManager.updateCircle({stores:u.stores,circleID:e.circleID,update:{name:e.name,description:e.description,catalogIDs:e.catalogIDs}});let t=await D(),r=await t.getCircle(e.circleID);if(null==r)throw Error(`Circle ${e.circleID} not found`);let a={id:r.id,groupID:r.group_id,name:r.name,description:r.description,createdAt:s(r.created_at)};return null!=e.catalogIDs?await u.emitter.emit("circleCatalogsChanged",{...a,circleID:e.circleID}):await u.emitter.emit("circleDataChanged",{...a,circleID:e.circleID}),a},p2pUpdateCatalog:async t=>{let r=await I(),a={hlc:e.serialize(u.hlc.now())};null!=t.name&&(a.name=t.name),null!=t.filterCriteria&&(a.filter_criteria=JSON.parse(t.filterCriteria)),await r.updateCatalog(t.catalogID,a);let i=await r.getCatalog(t.catalogID);if(null==i)throw Error(`Catalog ${t.catalogID} not found`);return{id:i.id,ownerDID:i.owner_did,name:i.name,description:i.description,filterCriteria:JSON.stringify(i.filter_criteria),createdAt:s(i.created_at)}},p2pDeleteCatalog:async e=>{let t=await I();return await t.deleteCatalog(e),{deletedID:e}},p2pDeleteCircle:async e=>{let t=await D(),r=await t.getCircle(e);return await u.groupManager.deleteCircle({stores:u.stores,circleID:e}),null!=r&&await u.emitter.emit("circleDeleted",{id:r.id,groupID:r.group_id,name:r.name,description:r.description,createdAt:s(r.created_at)}),{deletedID:e}},p2pRemoveCircleMember:async(e,t)=>(await u.groupManager.removeCircleMember({stores:u.stores,circleID:e,memberDID:t}),await u.emitter.emit("circleMemberRemoved",{circleID:e,memberDID:t,role:"",createdAt:new Date().toISOString()}),{circleID:e,memberDID:t})}}

package/lib/context/join.js

@@ -1 +1 @@
-import{createKeyPackageBundle as e}from"@enkaku/group";import{decodeInvitePayload as t,encodeJoinRequest as i}from"../spaces/invite-payload.js";import{createSpaceFromJoin as a}from"../spaces/join-utils.js";import{checkPeerAccess as r}from"./types.js";export function createJoinContext(n,s){return{p2pPrepareJoinRequest:async()=>{r(n.viewerDID,s.identity.id,s.autoAcceptPeers);let t=s.identity,a=await e(t);return s.pendingJoinRequests.set(n.viewerDID,{publicPackage:a.publicPackage,privatePackage:a.privatePackage,did:t.id}),{joinRequest:i({did:t.id,publicPackage:a.publicPackage})}},p2pCompleteJoin:async e=>{r(n.viewerDID,s.identity.id,s.autoAcceptPeers);let i=s.pendingJoinRequests.get(n.viewerDID);if(null==i)throw Error("No pending join request found — call prepareJoinRequest first");let o=s.identity,p=t(e),c={publicPackage:i.publicPackage,privatePackage:i.privatePackage,ownerDID:o.id};await s.spaceManager.joinSpace({stores:s.stores,identity:o,spaceID:p.spaceID,invite:p.invite,keyPackageBundle:c,welcomeMessage:p.welcomeMessage,ratchetTree:p.ratchetTree});let u=await a({stores:s.stores,hlc:s.hlc,emitter:s.emitter,identity:o,invite:p});return s.pendingJoinRequests.delete(n.viewerDID),u}}}
+import{createKeyPackageBundle as e}from"@enkaku/group";import{decodeInvitePayload as t,encodeJoinRequest as i}from"../groups/invite-payload.js";import{createGroupFromJoin as r}from"../groups/join-utils.js";import{checkPeerAccess as a}from"./types.js";export function createJoinContext(o,n){return{p2pPrepareJoinRequest:async()=>{a(o.viewerDID,n.identity.id,n.autoAcceptPeers);let t=n.identity,r=await e(t);return n.pendingJoinRequests.set(o.viewerDID,{publicPackage:r.publicPackage,privatePackage:r.privatePackage,did:t.id}),{joinRequest:i({did:t.id,publicPackage:r.publicPackage})}},p2pCompleteJoin:async e=>{a(o.viewerDID,n.identity.id,n.autoAcceptPeers);let i=n.pendingJoinRequests.get(o.viewerDID);if(null==i)throw Error("No pending join request found — call prepareJoinRequest first");let p=n.identity,s=t(e),u={publicPackage:i.publicPackage,privatePackage:i.privatePackage,ownerDID:p.id};await n.groupManager.joinGroup({stores:n.stores,identity:p,groupID:s.groupID,groupName:s.groupName,hubURLs:s.hubURLs,invite:s.invite,keyPackageBundle:u,welcomeMessage:s.welcomeMessage,ratchetTree:s.ratchetTree});let c=await r({stores:n.stores,hlc:n.hlc,emitter:n.emitter,identity:p,invite:s});return n.pendingJoinRequests.delete(o.viewerDID),c}}}

package/lib/context/types.d.ts

@@ -4,8 +4,8 @@ import type { OwnIdentity } from '@enkaku/token';
 import type { StoreProvider } from '@kubun/db';
 import type { Adapter } from '@kubun/db-adapter';
 import type { HLC } from '@kubun/hlc';
-import type { SpaceEventEmitter } from '../spaces/events.js';
-import type { SpaceManager } from '../spaces/manager.js';
+import type { GroupEventEmitter } from '../groups/events.js';
+import type { GroupManager } from '../groups/manager.js';
 import type { SyncManager } from '../sync/sync-manager.js';
 export type PendingJoinRequest = {
     publicPackage: KeyPackageBundle['publicPackage'];
@@ -14,12 +14,12 @@ export type PendingJoinRequest = {
 };
 export type ContextDeps = {
     identity: OwnIdentity;
-    spaceManager: SpaceManager;
+    groupManager: GroupManager;
     syncManager: SyncManager;
     stores: StoreProvider;
     adapter: Adapter;
     hlc: HLC;
-    emitter: SpaceEventEmitter;
+    emitter: GroupEventEmitter;
     pendingJoinRequests: Map<string, PendingJoinRequest>;
     runtime: Runtime;
     autoAcceptPeers?: Array<string>;
@@ -28,7 +28,7 @@ export declare function toISO(timestamp: unknown): string;
 /**
  * Normalize a credential value from the DB.
  * Kysely's ParseJSONResultsPlugin may have already parsed the JSON string
- * into an object. SerializedGroupState expects a JSON string.
+ * into an object. SerializedMLSGroupState expects a JSON string.
  */
 export declare function normalizeCredential(value: unknown): string;
 export declare function checkPeerAccess(viewerDID: string, identityID: string, autoAcceptPeers?: Array<string>): void;

package/lib/groups/broadcast-codec.d.ts

@@ -0,0 +1,3 @@
+import type { GroupBroadcastMessage } from './broadcast.js';
+export declare function serializeBroadcast(message: GroupBroadcastMessage): Uint8Array;
+export declare function deserializeBroadcast(bytes: Uint8Array): GroupBroadcastMessage;

package/lib/{spaces → groups}/broadcast-service.d.ts

@@ -1,37 +1,55 @@
 import { EventEmitter } from '@enkaku/event';
 import type { GraphStoreAPI } from '@kubun/store-graph';
-import type { SpaceStoreAPI } from '@kubun/store-space';
-import { type SpaceBroadcastMessage } from './broadcast.js';
-import { type SerializedGroupState } from './mls-state.js';
+import type { P2PStoreAPI } from '@kubun/store-p2p';
+import { type GroupBroadcastMessage } from './broadcast.js';
+import { type SerializedMLSGroupState } from './mls-state.js';
+/**
+ * Thrown when a received broadcast fails to decrypt (MLS restore, decrypt,
+ * or deserialize). Callers should typically ack-and-skip these, since the
+ * message is unrecoverable and redelivery will not help.
+ */
+export declare class DecryptError extends Error {
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
+/**
+ * Thrown when a successfully decrypted broadcast fails to apply to the local
+ * DB. Callers should typically NOT ack these, so the message can be
+ * redelivered after the transient failure clears.
+ */
+export declare class ApplyError extends Error {
+    readonly cause: unknown;
+    constructor(message: string, cause: unknown);
+}
 export type BroadcastEvent = {
-    spaceID: string;
-    message: SpaceBroadcastMessage;
+    groupID: string;
+    message: GroupBroadcastMessage;
     applied: boolean;
 };
 export type BroadcastServiceEvents = {
     broadcast: BroadcastEvent;
 };
 export type SendBroadcastParams = {
-    spaceID: string;
-    message: SpaceBroadcastMessage;
-    groupState: SerializedGroupState;
+    groupID: string;
+    message: GroupBroadcastMessage;
+    groupState: SerializedMLSGroupState;
 };
 export type SendBroadcastResult = {
     encrypted: Uint8Array;
-    updatedGroupState: SerializedGroupState;
+    updatedGroupState: SerializedMLSGroupState;
 };
 export type ReceiveBroadcastParams = {
-    spaceID: string;
+    groupID: string;
     encrypted: Uint8Array;
-    groupState: SerializedGroupState;
+    groupState: SerializedMLSGroupState;
 };
 export type ReceiveBroadcastResult = {
-    message: SpaceBroadcastMessage;
+    message: GroupBroadcastMessage;
     applied: boolean;
-    updatedGroupState: SerializedGroupState;
+    updatedGroupState: SerializedMLSGroupState;
 };
 /**
- * BroadcastService handles MLS encrypt/decrypt for space broadcasts
+ * BroadcastService handles MLS encrypt/decrypt for group broadcasts
  * and applies received messages to the local DB.
  *
  * It does NOT manage hub transport directly -- callers are responsible
@@ -39,7 +57,7 @@ export type ReceiveBroadcastResult = {
  * from hub. This keeps the service testable without hub infrastructure.
  */
 export type BroadcastServiceParams = {
-    spaceStore: SpaceStoreAPI;
+    p2pStore: P2PStoreAPI;
     graphStore: GraphStoreAPI;
 };
 export declare class BroadcastService extends EventEmitter<BroadcastServiceEvents> {

package/lib/groups/broadcast-service.js

@@ -0,0 +1 @@
+import{EventEmitter as r}from"@enkaku/event";import{processBroadcast as e}from"./broadcast.js";import{deserializeBroadcast as t,serializeBroadcast as a}from"./broadcast-codec.js";import{restoreMLSGroupHandle as o}from"./mls-group-handle.js";import{replacer as s,reviver as c}from"./mls-json.js";import{serializeMLSGroupState as p}from"./mls-state.js";export class DecryptError extends Error{cause;constructor(r,e){super(r),this.name="DecryptError",this.cause=e}}export class ApplyError extends Error{cause;constructor(r,e){super(r),this.name="ApplyError",this.cause=e}}export class BroadcastService extends r{#r;constructor(r){super(),this.#r={p2pStore:r.p2pStore,graphStore:r.graphStore}}async prepareSend(r){let{message:e,groupState:t}=r,c=a(e),d=await o(t),{message:i}=await d.encrypt(c),n=p(d);return{encrypted:new TextEncoder().encode(JSON.stringify(i,s)),updatedGroupState:n}}async processReceived(r){let a,s,d,{groupID:i,encrypted:n,groupState:m}=r;try{a=await o(m);let r=JSON.parse(new TextDecoder().decode(n),c),e=await a.decrypt(r);s=t(e)}catch(r){throw new DecryptError("Failed to decrypt broadcast",r)}try{d=await e(this.#r,s)}catch(r){throw new ApplyError("Failed to apply broadcast",r)}let l=p(a);return await this.emit("broadcast",{groupID:i,message:s,applied:d}),{message:s,applied:d,updatedGroupState:l}}}

package/lib/{spaces → groups}/broadcast.d.ts

@@ -1,7 +1,7 @@
 import type { CatalogRecord, CircleMemberRecord, CircleRecord } from '@kubun/protocol';
 import type { GraphStoreAPI } from '@kubun/store-graph';
-import type { SpaceStoreAPI } from '@kubun/store-space';
-export type SpaceBroadcastMessage = {
+import type { P2PStoreAPI } from '@kubun/store-p2p';
+export type GroupBroadcastMessage = {
     type: 'circle:create';
     circle: CircleRecord;
 } | {
@@ -42,8 +42,8 @@ export type SpaceBroadcastMessage = {
     catalogID: string;
     hlc: string;
 } | {
-    type: 'space:update';
-    spaceID: string;
+    type: 'group:update';
+    groupID: string;
     update: {
         name?: string;
         description?: string;
@@ -52,7 +52,7 @@ export type SpaceBroadcastMessage = {
     };
 };
 export type ProcessBroadcastParams = {
-    spaceStore: SpaceStoreAPI;
+    p2pStore: P2PStoreAPI;
     graphStore: GraphStoreAPI;
 };
 /**
@@ -61,4 +61,4 @@ export type ProcessBroadcastParams = {
  *
  * Returns true if the message was applied, false if it was skipped (stale HLC or missing target).
  */
-export declare function processBroadcast(params: ProcessBroadcastParams, message: SpaceBroadcastMessage): Promise<boolean>;
+export declare function processBroadcast(params: ProcessBroadcastParams, message: GroupBroadcastMessage): Promise<boolean>;

package/lib/groups/broadcast.js

@@ -0,0 +1 @@
+import{HLC as e}from"@kubun/hlc";function a(a,c){return e.compare(e.parse(a),e.parse(c))>0}export async function processBroadcast(e,c){let{p2pStore:t,graphStore:r}=e;switch(c.type){case"circle:create":{let e=await t.getCircle(c.circle.id);if(null!=e){if(!a(c.circle.hlc,e.hlc))return!1;return await t.updateCircle(c.circle.id,{name:c.circle.name,description:c.circle.description,catalog_ids:c.circle.catalogIDs,hlc:c.circle.hlc}),!0}return await t.createCircle({id:c.circle.id,group_id:c.circle.groupID,name:c.circle.name,description:c.circle.description,catalog_ids:c.circle.catalogIDs,hlc:c.circle.hlc}),!0}case"circle:update":{let e=await t.getCircle(c.circleID);if(null==e||!a(c.update.hlc,e.hlc))return!1;return await t.updateCircle(c.circleID,{name:c.update.name,description:c.update.description,catalog_ids:c.update.catalogIDs,hlc:c.update.hlc}),!0}case"circle:delete":{let e=await t.getCircle(c.circleID);if(null==e||!a(c.hlc,e.hlc))return!1;return await t.deleteCircle(c.circleID),!0}case"member:add":return await t.addCircleMember({circle_id:c.member.circleID,member_did:c.member.memberDID,role:c.member.role,hlc:c.member.hlc}),!0;case"member:remove":return await t.removeCircleMember(c.circleID,c.memberDID),!0;case"catalog:create":{let e=await r.getCatalog(c.catalog.id);if(null!=e){if(!a(c.catalog.hlc,e.hlc))return!1;return await r.updateCatalog(c.catalog.id,{name:c.catalog.name,description:c.catalog.description,filter_criteria:c.catalog.filterCriteria,hlc:c.catalog.hlc}),!0}return await r.createCatalog({id:c.catalog.id,owner_did:c.catalog.ownerDID,name:c.catalog.name,description:c.catalog.description,filter_criteria:c.catalog.filterCriteria,hlc:c.catalog.hlc}),!0}case"catalog:update":{let e=await r.getCatalog(c.catalogID);if(null==e||!a(c.update.hlc,e.hlc))return!1;return await r.updateCatalog(c.catalogID,{name:c.update.name,description:c.update.description,filter_criteria:c.update.filterCriteria,hlc:c.update.hlc}),!0}case"catalog:delete":{let e=await r.getCatalog(c.catalogID);if(null==e||!a(c.hlc,e.hlc))return!1;return await r.deleteCatalog(c.catalogID),!0}case"group:update":{let e=await t.getGroup(c.groupID);if(null==e||!a(c.update.hlc,e.hlc))return!1;return await t.updateGroup(c.groupID,{name:c.update.name,description:c.update.description,hub_urls:c.update.hubURLs,hlc:c.update.hlc}),!0}}}

package/lib/groups/events.d.ts

@@ -0,0 +1,38 @@
+import { EventEmitter } from '@enkaku/event';
+import type { CircleData, CircleMemberData, GroupData, GroupMemberData } from '../index.js';
+export type GroupEventMap = {
+    groupJoined: GroupData;
+    groupLeft: GroupData & {
+        groupID: string;
+    };
+    groupDataChanged: GroupData & {
+        groupID: string;
+    };
+    groupMemberJoined: GroupMemberData & {
+        groupID: string;
+    };
+    groupMemberLeft: GroupMemberData & {
+        groupID: string;
+    };
+    circleCreated: CircleData & {
+        groupID: string;
+    };
+    circleDeleted: CircleData & {
+        groupID: string;
+    };
+    circleDataChanged: CircleData & {
+        circleID: string;
+    };
+    circleMemberAdded: CircleMemberData & {
+        circleID: string;
+    };
+    circleMemberRemoved: CircleMemberData & {
+        circleID: string;
+    };
+    circleCatalogsChanged: CircleData & {
+        circleID: string;
+    };
+};
+export type GroupEventEmitter = EventEmitter<GroupEventMap>;
+export declare function createGroupEventEmitter(): GroupEventEmitter;
+export declare function createFilteredGenerator<K extends keyof GroupEventMap>(emitter: GroupEventEmitter, eventName: K, filter?: (data: GroupEventMap[K]) => boolean): AsyncGenerator<GroupEventMap[K], void, void>;

package/lib/{spaces → groups}/events.js

@@ -1 +1 @@
-import{EventEmitter as e}from"@enkaku/event";import{fromEmitter as r}from"@enkaku/generator";export function createSpaceEventEmitter(){return new e}export function createFilteredGenerator(e,t,n){return r(e,t,{filter:n})}
+import{EventEmitter as e}from"@enkaku/event";import{fromEmitter as r}from"@enkaku/generator";export function createGroupEventEmitter(){return new e}export function createFilteredGenerator(e,t,n){return r(e,t,{filter:n})}

package/lib/{spaces → groups}/invite-payload.d.ts

@@ -9,8 +9,8 @@ export type FullJoinRequestPayload = {
     privatePackage: KeyPackageBundle['privatePackage'];
 };
 export type InvitePayload = {
-    spaceID: string;
-    spaceName: string;
+    groupID: string;
+    groupName: string;
     hubURLs: Array<string>;
     invite: Invite;
     welcomeMessage: unknown;

package/lib/groups/join-utils.d.ts

@@ -0,0 +1,19 @@
+import type { OwnIdentity } from '@enkaku/token';
+import type { StoreProvider } from '@kubun/db';
+import { HLC } from '@kubun/hlc';
+import type { GroupData } from '../types.js';
+import type { GroupEventEmitter } from './events.js';
+export type CreateGroupFromJoinParams = {
+    stores: StoreProvider;
+    hlc: HLC;
+    emitter: GroupEventEmitter;
+    identity: OwnIdentity;
+    invite: {
+        groupID: string;
+        groupName: string;
+        hubURLs: Array<string>;
+    };
+};
+export declare function createGroupFromJoin(params: CreateGroupFromJoinParams): Promise<{
+    group: GroupData | null;
+}>;

package/lib/groups/join-utils.js

@@ -0,0 +1 @@
+import{HLC as e}from"@kubun/hlc";import{getP2PStore as r}from"@kubun/store-p2p";import{toISO as t}from"../context/types.js";export async function createGroupFromJoin(o){let{stores:a,hlc:i,emitter:u,identity:n,invite:p}=o,c=await r(a);null==await c.getGroup(p.groupID)&&await c.createGroup({id:p.groupID,name:p.groupName,description:"",created_by:n.id,hub_urls:p.hubURLs,hlc:e.serialize(i.now())});let l=await c.getGroup(p.groupID),d=null!=l?{id:l.id,name:l.name,description:l.description,createdBy:l.created_by,createdAt:t(l.created_at)}:null;return null!=d&&await u.emit("groupJoined",d),{group:d}}

package/lib/{spaces → groups}/manager.d.ts

@@ -1,12 +1,12 @@
 import { type GroupHandle, type GroupPermission, type Invite, type KeyPackageBundle } from '@enkaku/group';
 import type { Identity, OwnIdentity } from '@enkaku/token';
 import type { StoreProvider } from '@kubun/db';
-import type { SpaceBroadcastMessage } from './broadcast.js';
-export type SpaceManagerParams = {
+import type { GroupBroadcastMessage } from './broadcast.js';
+export type GroupManagerParams = {
     identity: Identity;
     getRandomID: () => string;
 };
-export type CreateSpaceParams = {
+export type CreateGroupParams = {
     stores: StoreProvider;
     identity: OwnIdentity;
     name: string;
@@ -14,52 +14,54 @@ export type CreateSpaceParams = {
     hubURLs?: Array<string>;
     createdBy?: string;
 };
-export type CreateSpaceResult = {
-    spaceID: string;
+export type CreateGroupResult = {
+    groupID: string;
     groupHandle: GroupHandle;
 };
-export type UpdateSpaceParams = {
+export type UpdateGroupParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     update: {
         name?: string;
         description?: string;
         hubURLs?: Array<string>;
     };
 };
-export type UpdateSpaceResult = {
-    broadcast: SpaceBroadcastMessage;
+export type UpdateGroupResult = {
+    broadcast: GroupBroadcastMessage;
 };
-export type InviteToSpaceParams = {
+export type InviteToGroupParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     identity: OwnIdentity;
     groupHandle: GroupHandle;
     recipientDID: string;
     recipientKeyPackage: KeyPackageBundle['publicPackage'];
     permission: GroupPermission;
 };
-export type InviteToSpaceResult = {
+export type InviteToGroupResult = {
     invite: Invite;
     welcomeMessage: unknown;
     commitMessage: unknown;
     updatedGroupHandle: GroupHandle;
 };
-export type JoinSpaceParams = {
+export type JoinGroupParams = {
     stores: StoreProvider;
     identity: OwnIdentity;
-    spaceID: string;
+    groupID: string;
+    groupName: string;
+    hubURLs: Array<string>;
     invite: Invite;
     keyPackageBundle: KeyPackageBundle;
     welcomeMessage: unknown;
     ratchetTree: unknown;
 };
-export type JoinSpaceResult = {
+export type JoinGroupResult = {
     groupHandle: GroupHandle;
 };
 export type RemoveMemberParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     groupHandle: GroupHandle;
     leafIndex: number;
     memberDID: string;
@@ -68,32 +70,32 @@ export type RemoveMemberResult = {
     commitMessage: unknown;
     updatedGroupHandle: GroupHandle;
 };
-export type RemoveSpaceMemberParams = {
+export type RemoveGroupMemberParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     groupHandle: GroupHandle;
     memberDID: string;
 };
-export type RemoveSpaceMemberResult = {
+export type RemoveGroupMemberResult = {
     commitMessage: unknown;
     updatedGroupHandle: GroupHandle;
 };
-export type LeaveSpaceParams = {
+export type LeaveGroupParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     identity: OwnIdentity;
 };
-export type LeaveSpaceResult = undefined;
+export type LeaveGroupResult = undefined;
 export type CreateCircleParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     name: string;
     description?: string;
     catalogIDs?: Array<string>;
 };
 export type CreateCircleResult = {
     circleID: string;
-    broadcast: SpaceBroadcastMessage;
+    broadcast: GroupBroadcastMessage;
 };
 export type UpdateCircleParams = {
     stores: StoreProvider;
@@ -105,25 +107,25 @@ export type UpdateCircleParams = {
     };
 };
 export type UpdateCircleResult = {
-    broadcast: SpaceBroadcastMessage;
-    broadcasts: Array<SpaceBroadcastMessage>;
+    broadcast: GroupBroadcastMessage;
+    broadcasts: Array<GroupBroadcastMessage>;
 };
 export type DeleteCircleParams = {
     stores: StoreProvider;
     circleID: string;
 };
 export type DeleteCircleResult = {
-    broadcast: SpaceBroadcastMessage;
+    broadcast: GroupBroadcastMessage;
 };
 export type AddCircleMemberParams = {
     stores: StoreProvider;
-    spaceID: string;
+    groupID: string;
     circleID: string;
     memberDID: string;
     role: 'admin' | 'member';
 };
 export type AddCircleMemberResult = {
-    broadcast: SpaceBroadcastMessage;
+    broadcast: GroupBroadcastMessage;
 };
 export type RemoveCircleMemberParams = {
     stores: StoreProvider;
@@ -131,19 +133,19 @@ export type RemoveCircleMemberParams = {
     memberDID: string;
 };
 export type RemoveCircleMemberResult = {
-    broadcast: SpaceBroadcastMessage;
+    broadcast: GroupBroadcastMessage;
 };
-export declare class SpaceManager {
+export declare class GroupManager {
     #private;
-    constructor(params: SpaceManagerParams);
-    createSpace(params: CreateSpaceParams): Promise<CreateSpaceResult>;
-    updateSpace(params: UpdateSpaceParams): Promise<UpdateSpaceResult>;
-    inviteToSpace(params: InviteToSpaceParams): Promise<InviteToSpaceResult>;
-    joinSpace(params: JoinSpaceParams): Promise<JoinSpaceResult>;
+    constructor(params: GroupManagerParams);
+    createGroup(params: CreateGroupParams): Promise<CreateGroupResult>;
+    updateGroup(params: UpdateGroupParams): Promise<UpdateGroupResult>;
+    inviteToGroup(params: InviteToGroupParams): Promise<InviteToGroupResult>;
+    joinGroup(params: JoinGroupParams): Promise<JoinGroupResult>;
     removeMember(params: RemoveMemberParams): Promise<RemoveMemberResult>;
-    removeSpaceMember(params: RemoveSpaceMemberParams): Promise<RemoveSpaceMemberResult>;
-    leaveSpace(params: LeaveSpaceParams): Promise<LeaveSpaceResult>;
-    loadSpace(stores: StoreProvider, spaceID: string): Promise<{
+    removeGroupMember(params: RemoveGroupMemberParams): Promise<RemoveGroupMemberResult>;
+    leaveGroup(params: LeaveGroupParams): Promise<LeaveGroupResult>;
+    loadGroup(stores: StoreProvider, groupID: string): Promise<{
         epoch: number;
         credential: string;
     } | undefined>;

package/lib/groups/manager.js

@@ -0,0 +1 @@
+import{commitInvite as e,createGroup as t,createInvite as r,processWelcome as a,removeMember as i}from"@enkaku/group";import{HLC as o}from"@kubun/hlc";import{getGraphStore as s}from"@kubun/store-graph";import{getP2PStore as c}from"@kubun/store-p2p";import{serializeMLSGroupState as d}from"./mls-state.js";export class GroupManager{#e;#t;#r;constructor(e){this.#e=e.identity.id,this.#t=e.getRandomID,this.#r=new o({nodeID:e.identity.id})}async #a(e,t,r){let a=d(r),i=await c(e);await i.saveMLSState({group_id:t,device_id:this.#e,mls_state:a.mlsState,credential:a.credential,epoch:a.epoch,root_capability:a.rootCapability})}async createGroup(e){let r=this.#t(),{group:a}=await t(e.identity,r),i=await c(e.stores);return await i.createGroup({id:r,name:e.name,description:e.description??"",created_by:e.createdBy??e.identity.id,hub_urls:e.hubURLs??[],hlc:o.serialize(this.#r.now())}),await this.#a(e.stores,r,a),await i.addGroupMember({group_id:r,member_did:e.identity.id,role:"admin"}),{groupID:r,groupHandle:a}}async updateGroup(e){let t=o.serialize(this.#r.now()),r=await c(e.stores);return await r.updateGroup(e.groupID,{name:e.update.name,description:e.update.description,hub_urls:e.update.hubURLs,hlc:t}),{broadcast:{type:"group:update",groupID:e.groupID,update:{...e.update,hlc:t}}}}async inviteToGroup(t){let{invite:a}=await r({group:t.groupHandle,identity:t.identity,recipientDID:t.recipientDID,permission:t.permission}),{commitMessage:i,welcomeMessage:o,newGroup:s}=await e(t.groupHandle,t.recipientKeyPackage);await this.#a(t.stores,t.groupID,s);let d=await c(t.stores);return await d.addGroupMember({group_id:t.groupID,member_did:t.recipientDID,role:"admin"===t.permission?"admin":"member"}),{invite:a,welcomeMessage:o,commitMessage:i,updatedGroupHandle:s}}async joinGroup(e){let{group:t}=await a({identity:e.identity,invite:e.invite,welcome:e.welcomeMessage,keyPackageBundle:e.keyPackageBundle,ratchetTree:e.ratchetTree});await this.#a(e.stores,e.groupID,t);let r=await c(e.stores);return null==await r.getGroup(e.groupID)&&await r.createGroup({id:e.groupID,name:e.groupName,description:"",created_by:e.identity.id,hub_urls:e.hubURLs,hlc:o.serialize(this.#r.now())}),await r.addGroupMember({group_id:e.groupID,member_did:e.identity.id,role:"member"}),{groupHandle:t}}async removeMember(e){let{commitMessage:t,newGroup:r}=await i(e.groupHandle,e.leafIndex);await this.#a(e.stores,e.groupID,r);let a=await c(e.stores);return await a.removeGroupMember(e.groupID,e.memberDID),{commitMessage:t,updatedGroupHandle:r}}async removeGroupMember(e){let t=e.groupHandle.findMemberLeafIndex(e.memberDID);if(null==t)throw Error(`Member ${e.memberDID} not found in MLS group`);let{commitMessage:r,newGroup:a}=await i(e.groupHandle,t);await this.#a(e.stores,e.groupID,a);let o=await c(e.stores);return await o.removeGroupMember(e.groupID,e.memberDID),{commitMessage:r,updatedGroupHandle:a}}async leaveGroup(e){let t=await c(e.stores);await t.deleteMLSState(e.groupID,this.#e),await t.removeGroupMember(e.groupID,e.identity.id)}async loadGroup(e,t){let r=await c(e),a=await r.getMLSState(t,this.#e);if(null!=a)return{epoch:a.epoch,credential:a.credential}}async createCircle(e){let t=this.#t(),r=o.serialize(this.#r.now()),a=e.catalogIDs??[],i=await c(e.stores);return await i.createCircle({id:t,group_id:e.groupID,name:e.name,description:e.description??"",catalog_ids:a,hlc:r}),{circleID:t,broadcast:{type:"circle:create",circle:{id:t,groupID:e.groupID,name:e.name,description:e.description??"",catalogIDs:a,hlc:r}}}}async updateCircle(e){let t=o.serialize(this.#r.now()),r=[],a=await c(e.stores);if(null!=e.update.catalogIDs){let t=await a.getCircle(e.circleID),i=new Set(null!=t?t.catalog_ids:[]),o=e.update.catalogIDs.filter(e=>!i.has(e)),c=await s(e.stores);for(let e of(await Promise.all(o.map(e=>c.getCatalog(e)))))null!=e&&r.push({type:"catalog:create",catalog:{id:e.id,ownerDID:e.owner_did,name:e.name,description:e.description,filterCriteria:e.filter_criteria,hlc:e.hlc}})}await a.updateCircle(e.circleID,{name:e.update.name,description:e.update.description,catalog_ids:e.update.catalogIDs,hlc:t});let i={type:"circle:update",circleID:e.circleID,update:{...e.update,hlc:t}};return{broadcast:i,broadcasts:[i,...r]}}async deleteCircle(e){let t=o.serialize(this.#r.now()),r=await c(e.stores);return await r.deleteCircle(e.circleID),{broadcast:{type:"circle:delete",circleID:e.circleID,hlc:t}}}async addCircleMember(e){let t=await c(e.stores);if(!await t.isGroupMember(e.groupID,e.memberDID))throw Error(`${e.memberDID} is not a member of group ${e.groupID}`);let r=o.serialize(this.#r.now());return await t.addCircleMember({circle_id:e.circleID,member_did:e.memberDID,role:e.role,hlc:r}),{broadcast:{type:"member:add",member:{circleID:e.circleID,memberDID:e.memberDID,role:e.role,hlc:r}}}}async removeCircleMember(e){let t=o.serialize(this.#r.now()),r=await c(e.stores);return await r.removeCircleMember(e.circleID,e.memberDID),{broadcast:{type:"member:remove",circleID:e.circleID,memberDID:e.memberDID,hlc:t}}}}

package/lib/groups/mls-group-handle.d.ts

@@ -0,0 +1,4 @@
+import { type GroupHandle } from '@enkaku/group';
+import { type SerializedMLSGroupState } from './mls-state.js';
+export type MLSGroupHandle = GroupHandle;
+export declare function restoreMLSGroupHandle(serialized: SerializedMLSGroupState): Promise<MLSGroupHandle>;

package/lib/groups/mls-group-handle.js

@@ -0,0 +1 @@
+import{restoreGroup as r}from"@enkaku/group";import{deserializeMLSGroupState as o}from"./mls-state.js";export async function restoreMLSGroupHandle(t){let{state:e,credential:n,rootCapability:m}=o(t);return r({state:e,credential:n,rootCapability:m})}

package/lib/groups/mls-state.d.ts

@@ -0,0 +1,42 @@
+import { type ClientState, type GroupHandle, type MemberCredential } from '@enkaku/group';
+import type { GroupMLSState, InsertGroupMLSState } from '@kubun/store-p2p';
+/**
+ * Serialized form of a GroupHandle for DB persistence.
+ * The MLS ClientState is opaque binary; the credential is JSON.
+ */
+export type SerializedMLSGroupState = {
+    mlsState: Uint8Array;
+    credential: string;
+    epoch: number;
+    rootCapability: string;
+};
+/**
+ * Serialize a GroupHandle's state for persistence.
+ * The implementer must verify the serialization approach works
+ * with the installed version of ts-mls.
+ */
+export declare function serializeMLSGroupState(group: GroupHandle): SerializedMLSGroupState;
+export type MLSGroupState = {
+    state: ClientState;
+    credential: MemberCredential;
+    rootCapability: string;
+};
+/**
+ * Deserialize persisted state back into GroupHandle constructor params.
+ * Returns the params needed to reconstruct a GroupHandle.
+ */
+export declare function deserializeMLSGroupState(serialized: SerializedMLSGroupState): MLSGroupState;
+/**
+ * Map a persisted `GroupMLSState` DB row to the `SerializedMLSGroupState` shape
+ * expected by `BroadcastService.prepareSend` / `processReceived`.
+ *
+ * Credential is stored as TEXT but Kysely's `ParseJSONResultsPlugin` may have
+ * already parsed it into an object on read. `SerializedMLSGroupState.credential`
+ * is a JSON string, so re-stringify when needed.
+ */
+export declare function fromMLSStateRow(row: GroupMLSState): SerializedMLSGroupState;
+/**
+ * Map a `SerializedMLSGroupState` plus scope (group + device) to an
+ * `InsertGroupMLSState` row suitable for `P2PStoreAPI.saveMLSState`.
+ */
+export declare function toMLSStateInsert(serialized: SerializedMLSGroupState, groupID: string, deviceID: string): InsertGroupMLSState;

package/lib/groups/mls-state.js

@@ -0,0 +1 @@
+import{decodeClientState as t,encodeClientState as e}from"@enkaku/group";import{normalizeCredential as o}from"../context/types.js";export function serializeMLSGroupState(t){return{mlsState:e(t.state),credential:JSON.stringify(t.credential),epoch:Number(t.epoch),rootCapability:t.rootCapability}}export function deserializeMLSGroupState(e){let o=t(e.mlsState);if(null==o)throw Error("Could not decode ClientState");return{state:o,credential:JSON.parse(e.credential),rootCapability:e.rootCapability}}export function fromMLSStateRow(t){return{mlsState:t.mls_state,credential:o(t.credential),epoch:t.epoch,rootCapability:t.root_capability}}export function toMLSStateInsert(t,e,o){return{group_id:e,device_id:o,mls_state:t.mlsState,credential:t.credential,epoch:t.epoch,root_capability:t.rootCapability}}

package/lib/hub/connection-pool.d.ts

@@ -0,0 +1,19 @@
+import type { Client } from '@enkaku/client';
+import type { HubProtocol } from '@enkaku/hub-protocol';
+import type { Logger } from '@kubun/logger';
+import type { CreateHubClient } from './relay-manager.js';
+export type HubClientRef = {
+    client: Client<HubProtocol>;
+    refID: string;
+};
+export type HubConnectionPoolParams = {
+    createHubClient: CreateHubClient;
+    logger?: Logger;
+};
+export declare class HubConnectionPool {
+    #private;
+    constructor(params: HubConnectionPoolParams);
+    acquire(hubURL: string): Promise<HubClientRef>;
+    release(hubURL: string, refID: string): Promise<void>;
+    disposeAll(): Promise<void>;
+}

package/lib/hub/connection-pool.js

@@ -0,0 +1 @@
+export class HubConnectionPool{#e;#t;#i=new Map;#s=0;constructor(e){this.#e=e.createHubClient,this.#t=e.logger}async acquire(e){let t=this.#i.get(e);if(null!=t&&null!=t.disposing&&(await t.disposing,this.#i.get(e)===t&&this.#i.delete(e),t=void 0),null==t){let i=await this.#e(e),s={client:i,refs:new Set};t=s,this.#i.set(e,s),i.disposed.then(()=>{this.#i.get(e)===s&&(this.#t?.debug("hub client disposed externally, evicting pool entry",{hubURL:e,outstandingRefs:[...s.refs]}),this.#i.delete(e))}).catch(()=>{})}let i=String(++this.#s);return t.refs.add(i),{client:t.client,refID:i}}async release(e,t){let i=this.#i.get(e);if(null==i)return void this.#t?.debug("HubConnectionPool.release: unknown hubURL",{hubURL:e,refID:t});if(!i.refs.has(t))return void this.#t?.debug("HubConnectionPool.release: unknown refID",{hubURL:e,refID:t});if(i.refs.delete(t),i.refs.size>0)return;let s=i.client.dispose();i.disposing=s;try{await s}finally{this.#i.get(e)===i&&this.#i.delete(e)}}async disposeAll(){let e=Array.from(this.#i.entries());await Promise.all(e.map(async([e,t])=>{t.refs.size>0&&this.#t?.warn("Disposing hub client with outstanding refs",{hubURL:e,refs:Array.from(t.refs)}),await t.client.dispose()})),this.#i.clear()}}

package/lib/hub/group-channel.d.ts

@@ -0,0 +1,51 @@
+import type { Logger } from '@kubun/logger';
+import type { P2PStoreAPI } from '@kubun/store-p2p';
+import type { GroupBroadcastMessage } from '../groups/broadcast.js';
+import type { BroadcastService } from '../groups/broadcast-service.js';
+import type { HubConnectionPool } from './connection-pool.js';
+export type GroupChannelParams = {
+    groupID: string;
+    hubURL: string;
+    deviceID: string;
+    pool: HubConnectionPool;
+    broadcastService: BroadcastService;
+    p2pStore: P2PStoreAPI;
+    logger?: Logger;
+    ackFlushMs: number;
+    ackFlushMax: number;
+    backoffBaseMs: number;
+    backoffMaxMs: number;
+    backoffJitter: number;
+};
+export type Mutex = {
+    run<T>(fn: () => Promise<T>): Promise<T>;
+};
+export declare function createMutex(): Mutex;
+export type AckBatchParams = {
+    flushMs: number;
+    flushMax: number;
+    send: (ids: Array<string>) => Promise<void>;
+    logger?: Logger;
+};
+export declare class AckBatch {
+    #private;
+    constructor(params: AckBatchParams);
+    add(id: string): void;
+    /**
+     * Drain the pending id set and send it via the configured sender. Never
+     * rejects: send errors are logged and the ids are dropped silently (the hub
+     * will redeliver unacknowledged messages, so the next receive will produce a
+     * fresh ack).
+     */
+    flush(): Promise<void>;
+    dispose(): void;
+}
+export declare function computeBackoff(attempt: number, base: number, max: number, jitter: number): number;
+export declare function abortableSleep(ms: number, signal: AbortSignal): Promise<void>;
+export declare class GroupChannel {
+    #private;
+    constructor(params: GroupChannelParams);
+    open(): Promise<void>;
+    close(): Promise<void>;
+    broadcast(message: GroupBroadcastMessage): Promise<void>;
+}

package/lib/hub/group-channel.js

@@ -0,0 +1 @@
+import{handleReceivedMessage as e}from"./receive-handler.js";import{handleSendBroadcast as t}from"./send-handler.js";export function createMutex(){let e=Promise.resolve();return{run(t){let r=e.then(()=>t());return e=r.catch(()=>{}),r}}}export class AckBatch{#e;#t;#r;#i;#s=new Set;#o=null;constructor(e){this.#e=e.flushMs,this.#t=e.flushMax,this.#r=e.send,this.#i=e.logger}add(e){let t=0===this.#s.size;if(this.#s.add(e),this.#s.size>=this.#t){null!==this.#o&&(clearTimeout(this.#o),this.#o=null),this.flush();return}t&&null===this.#o&&(this.#o=setTimeout(()=>{this.#o=null,this.flush()},this.#e))}async flush(){if(null!==this.#o&&(clearTimeout(this.#o),this.#o=null),0===this.#s.size)return;let e=Array.from(this.#s);this.#s.clear();try{await this.#r(e)}catch(t){this.#i?.error("ack batch send failed",{error:t,count:e.length})}}dispose(){null!==this.#o&&(clearTimeout(this.#o),this.#o=null),this.#s.clear()}}export function computeBackoff(e,t,r,i){let s=Math.min(t*2**e*(1+i*(2*Math.random()-1)),r);return s<0?0:s}export function abortableSleep(e,t){return new Promise((r,i)=>{if(t.aborted)return void i(t.reason??Error("aborted"));let s=setTimeout(()=>{t.removeEventListener("abort",o),r()},e),o=()=>{clearTimeout(s),t.removeEventListener("abort",o),i(t.reason??Error("aborted"))};t.addEventListener("abort",o)})}let r=Symbol("disposed");export class GroupChannel{#a;#h;#l;#n;#c;#u;#i;#p;#g;#d;#f;#b;#I;#D=new AbortController;#m=null;#k=null;#v=null;#M=null;#y=null;#w=0;#x=!1;#C=!1;constructor(e){this.#a=e.groupID,this.#h=e.hubURL,this.#l=e.deviceID,this.#n=e.pool,this.#c=e.broadcastService,this.#u=e.p2pStore,this.#i=e.logger,this.#p=e.ackFlushMs,this.#g=e.ackFlushMax,this.#d=e.backoffBaseMs,this.#f=e.backoffMaxMs,this.#b=e.backoffJitter,this.#I=createMutex()}async open(){if(this.#x)throw Error("GroupChannel already opened");try{await this.#S(),this.#x=!0}catch(e){if(null!=this.#k){try{await this.#n.release(this.#h,this.#k)}catch(e){this.#i?.debug("pool release after open failure failed",{groupID:this.#a,error:e})}this.#k=null}throw this.#m=null,e}}async #S(){if(null!=this.#k){let e=this.#k;this.#k=null,this.#m=null;try{await this.#n.release(this.#h,e)}catch(e){this.#i?.debug("pool release before reconnect failed",{groupID:this.#a,error:e})}}let{client:e,refID:t}=await this.#n.acquire(this.#h);this.#m=e,this.#k=t;let r=await this.#u.getMLSState(this.#a,this.#l);if(null==r)throw Error(`MLS state missing for group ${this.#a}; cannot join hub group`);await e.request("hub/group/join",{param:{groupID:this.#a,credential:r.credential}});let i=e.createChannel("hub/receive",{param:{groupIDs:[this.#a]},signal:this.#D.signal});this.#v=i,i.catch(()=>{}),this.#M=new AckBatch({flushMs:this.#p,flushMax:this.#g,send:async e=>{await i.send({ack:e})},logger:this.#i}),this.#y=this.#L(e).catch(e=>{this.#i?.debug("receive task tail error",{groupID:this.#a,error:e})}),this.#C=!0}async #L(t){let i=this.#v;if(null==i)return;let s=i.readable.getReader();try{for(;!this.#D.signal.aborted;){let i=s.read(),o=t.disposed.then(()=>r),a=await Promise.race([i,o]);if("symbol"==typeof a){this.#i?.debug("receive loop observed hub client disposal",{groupID:this.#a});break}let{done:h,value:l}=a;if(h)break;(await this.#I.run(()=>e({groupID:this.#a,deviceID:this.#l,message:l,p2pStore:this.#u,broadcastService:this.#c,logger:this.#i}))).ack&&this.#M?.add(l.sequenceID),this.#w=0}}catch(e){this.#i?.warn("hub receive loop error",{groupID:this.#a,error:e})}finally{try{s.releaseLock()}catch{}}this.#C=!1,this.#D.signal.aborted||this.#B()}#B(){this.#C=!1,this.#y=this.#R().catch(e=>{this.#i?.debug("reconnect task tail error",{groupID:this.#a,error:e})})}async #R(){for(;!this.#D.signal.aborted;){this.#C=!1;let e=computeBackoff(this.#w++,this.#d,this.#f,this.#b);this.#i?.debug("reconnect scheduled",{groupID:this.#a,delay:e,attempt:this.#w});try{await abortableSleep(e,this.#D.signal)}catch{return}try{this.#M?.dispose(),this.#M=null,this.#v=null,await this.#S(),this.#w=0;return}catch(e){this.#i?.warn("reconnect attempt failed",{groupID:this.#a,attempt:this.#w,error:e})}}}async close(){if(!this.#x)return;this.#C=!1;let e=this.#M;this.#M=null;try{await e?.flush()}catch(e){this.#i?.debug("ack flush during close failed",{groupID:this.#a,error:e})}e?.dispose();try{await this.#m?.request("hub/group/leave",{param:{groupID:this.#a}})}catch(e){this.#i?.warn("hub/group/leave failed",{groupID:this.#a,error:e})}try{this.#v?.close()}catch{}if(!this.#D.signal.aborted)try{this.#D.abort()}catch{}try{await this.#y}catch{}if(null!=this.#k){try{await this.#n.release(this.#h,this.#k)}catch(e){this.#i?.debug("pool release during close failed",{groupID:this.#a,error:e})}this.#k=null}this.#m=null,this.#v=null,this.#y=null,this.#x=!1}broadcast(e){return this.#x&&this.#C&&null!=this.#m?this.#I.run(async()=>{if(!this.#x||!this.#C||null==this.#m)throw Error(`GroupChannel for ${this.#a} is not ready for broadcast`);let r=this.#m;return t({groupID:this.#a,deviceID:this.#l,message:e,p2pStore:this.#u,broadcastService:this.#c,hubClient:r,logger:this.#i})}):Promise.reject(Error(`GroupChannel for ${this.#a} is not ready for broadcast`))}}