@kubun/plugin-p2p 0.10.1 → 0.12.0

package/lib/index.d.ts

@@ -1,22 +1,35 @@
 import type { DefaultAccessLevel, KubunPlugin, PluginFactoryParams } from '@kubun/engine';
-import type { CreateHubClient } from './hub/relay-manager.js';
+import { type CreateHubClient } from './hub/http-client.js';
 import { type BroadcastBatchConfig } from './sync/broadcast-queue.js';
 import { type PushSyncConfig } from './sync/broadcast-sender.js';
 import type { ForwardingConfig } from './sync/forwarder.js';
 import type { StoreUnreadableMode } from './types.js';
-export type { ContextDeps, PendingJoinRequest } from './context/types.js';
+export { GROUP_CONTROL_DENIED, LAST_GROUP_ADMIN, NOT_GROUP_ADMIN, type RequireGroupAdminParams, requireGroupAdmin, } from './context/require-admin.js';
+export type { ContextDeps } from './context/types.js';
+export { ADMIN_ROLE_ENTRY_TYPE, type AdminRoleValue, type AdminRosterState, foldAdminRoster, } from './groups/admin-roster.js';
 export { type AffectedRow, type GroupBroadcastMessage, type MutationApplyEntry, type ProcessBroadcastParams, type ProcessBroadcastResult, processBroadcast, } from './groups/broadcast.js';
 export { deserializeBroadcast, serializeBroadcast } from './groups/broadcast-codec.js';
-export { ApplyError, type BroadcastEvent, BroadcastService, type BroadcastServiceEvents, type BroadcastServiceParams, DecryptError, type ReceiveBroadcastParams, type ReceiveBroadcastResult, type SendBroadcastParams, } from './groups/broadcast-service.js';
 export { createFilteredGenerator, createP2PEventEmitter, type P2PEventEmitter, type P2PEventMap, } from './groups/events.js';
+export { buildKubunGroupAnchorExtension, type GroupAnchorApp, readRecoverySecret, } from './groups/group-anchor.js';
 export { GroupHandleRegistry, type GroupHandleRegistryParams, type SeedParams, } from './groups/group-handle-registry.js';
+export type { PeerAvailability } from './groups/group-protocols.js';
 export { decodeFullJoinRequest, decodeInvitePayload, decodeJoinRequest, encodeFullJoinRequest, encodeInvitePayload, encodeJoinRequest, type FullJoinRequestPayload, type InvitePayload, type JoinRequestPayload, type SuggestedHub, } from './groups/invite-payload.js';
-export { type AddCircleMemberParams, type AddCircleMemberResult, type CreateCircleParams, type CreateCircleResult, type CreateGroupParams, type CreateGroupResult, type DeleteCircleParams, type DeleteCircleResult, GroupManager, type GroupManagerParams, type InviteToGroupParams, type InviteToGroupResult, type JoinGroupParams, type JoinGroupResult, type LeaveGroupParams, type LeaveGroupResult, type RemoveCircleMemberParams, type RemoveCircleMemberResult, type RemoveGroupMemberParams, type RemoveGroupMemberResult, type RemoveMemberParams, type RemoveMemberResult, type UpdateCircleParams, type UpdateCircleResult, type UpdateGroupParams, type UpdateGroupResult, } from './groups/manager.js';
+export { resolveJoinRequestDID } from './groups/join-request-identity.js';
+export { entryOrd, type FoldInput, foldLedgerEntries, type LedgerEntry, type LedgerReducer, ledgerEntryDigest, type PositionedFoldInput, signLedgerEntry, type VerifiedLedgerEntry, verifyLedgerEntry, } from './groups/ledger.js';
+export type { CreateGroupParams, CreateGroupResult, GroupManagerParams, InviteToGroupParams, InviteToGroupResult, JoinGroupParams, JoinGroupResult, LeaveGroupParams, LeaveGroupResult, } from './groups/manager.js';
 export { MLSEncryptor, type MLSEncryptorParams } from './groups/mls-encryptor.js';
 export { type MLSGroupHandle, restoreMLSGroupHandle } from './groups/mls-group-handle.js';
 export { replacer as mlsJSONReplacer, reviver as mlsJSONReviver } from './groups/mls-json.js';
 export { deserializeMLSGroupState, type MLSGroupState, type SerializedMLSGroupState, serializeMLSGroupState, } from './groups/mls-state.js';
-export type { SyncClientMessage, SyncProtocol, SyncServerMessage } from './protocol.js';
+export { MERKLE_SYNC_PROTOCOL } from './groups/peer-selection.js';
+export { type CreateHTTPHubClientParams, type CreateHubClient, type CreateHubClientOptions, createHTTPHubClient, } from './hub/http-client.js';
+export { type BindHubToGroupParams, bindHubToGroup, type CreateHubParams, createHub, type DeleteHubParams, type DeleteHubResult, deleteHub, type GetHubParams, getHub, type Hub, type ListGroupsByHubParams, type ListHubsByGroupParams, type ListHubsParams, listGroupsByHub, listHubs, listHubsByGroup, type UnbindHubFromGroupParams, type UpdateHubParams, type UpsertHubParams, unbindHubFromGroup, updateHub, upsertHub, } from './hub/manager.js';
+export { type CreateHubServerDIDResolverParams, createHubServerDIDResolver, type FetchHubInfoParams, fetchHubInfo, type HubInfo, type HubServerDIDResolver, } from './hub/server-did.js';
+export { type HubWiring, type SetupHubRelayParams, setupHubRelay, } from './hub/wiring.js';
+export { type PeerConnection, PeerConnectionRegistry, } from './peer/connection-registry.js';
+export { type CreatePeerHandlersParams, createPeerHandlers } from './peer/handlers.js';
+export type { PeerClientMessage, PeerGroupsResult, PeerProtocol, PeerServerMessage, SyncClientMessage, SyncProtocol, SyncServerMessage, } from './protocol.js';
+export { peerProtocol } from './protocol.js';
 export { createP2PSchemaExtension } from './schema.js';
 export { type BroadcastBatchConfig, type BroadcastQueue, type BroadcastQueueParams, createBroadcastQueue, DEFAULT_BROADCAST_BATCH_CONFIG, } from './sync/broadcast-queue.js';
 export { type BroadcastSenderParams, DEFAULT_PUSH_SYNC_CONFIG, type PushSyncConfig, wireBroadcastSender, } from './sync/broadcast-sender.js';
@@ -27,18 +40,9 @@ export { checkSyncDelegation } from './sync/handlers.js';
 export { HubTunnelSyncListener, type HubTunnelSyncListenerParams, } from './sync/hub-tunnel-sync-listener.js';
 export { HubTunnelSyncProvider, type HubTunnelSyncProviderParams, } from './sync/hub-tunnel-sync-provider.js';
 export { negotiateDirection, type PeerConfig, type PeerConfigWithID, PeerRegistry, } from './sync/peer-registry.js';
-export { SyncClient, type SyncClientParams, type SyncScope, type SyncTransportProvider, } from './sync/sync-client.js';
+export { SyncClient, type SyncClientParams, type SyncRoute, type SyncScope, type SyncServerResolver, type SyncTransportProvider, } from './sync/sync-client.js';
 export { type SyncEvent, SyncManager, type SyncManagerParams, type SyncSessionInfo, type SyncStatus, } from './sync/sync-manager.js';
-export type { OnServerDIDObserved } from './hub/connection-pool.js';
-export { DIDObservingTransport, type DIDObservingTransportParams, type ServerDIDObserver, } from './hub/did-observing-transport.js';
-export { ReconnectingError } from './hub/errors.js';
-export type { GroupChannel, GroupChannelParams } from './hub/group-channel.js';
-export { type CreateHTTPHubClientParams, createHTTPHubClient } from './hub/http-client.js';
-export type { ConnectionLifecycleEvent } from './hub/hub-connection.js';
-export { type BindHubToGroupParams, bindHubToGroup, type CaptureServerDIDParams, type CreateHubParams, captureServerDID, createHub, type DeleteHubParams, type DeleteHubResult, deleteHub, type GetHubParams, getHub, type Hub, HubServerDIDConflictError, type ListGroupsByHubParams, type ListHubsByGroupParams, type ListHubsParams, listGroupsByHub, listHubs, listHubsByGroup, type UnbindHubFromGroupParams, type UpdateHubParams, type UpsertHubParams, unbindHubFromGroup, updateHub, upsertHub, } from './hub/manager.js';
-export { type CreateGroupChannel, type CreateHubClient, type CreateHubClientOptions, type CreateHubConnection, HubRelayManager, type HubRelayManagerParams, type RelayEvent, } from './hub/relay-manager.js';
-export { DISABLED_HUB, type HubWiring, type SetupHubRelayParams, setupHubRelay, } from './hub/wiring.js';
-export type { CatalogData, CircleData, CircleMemberData, DeleteCatalogData, DeleteCircleData, GroupData, GroupMemberData, GroupRequestContext, InviteToGroupData, JoinGroupData, LeaveGroupData, P2PContext, P2PJoinRequestContext, RemoveCircleMemberData, RemoveGroupMemberData, StoreUnreadableMode, SyncPluginAPI, SyncRequestContext, SyncSessionResult, UpdateCircleInput, UpdateGroupInput, } from './types.js';
+export type { AddCircleMemberInput, CatalogData, CircleData, CircleMemberData, CreateCircleInput, DeleteCatalogData, DeleteCircleInput, GatheredPeer, GroupData, GroupMemberData, GroupRequestContext, HubServerDIDChangedData, InviteToGroupData, InviteToGroupInput, JoinGroupData, LeaveGroupData, LocalPeerAnnouncement, P2PContext, P2PJoinRequestContext, PeerCatchUpData, PeerGatherOptions, PresenceReason, RemoveCircleMemberInput, RemoveGroupMemberInput, StoreUnreadableMode, SyncPluginAPI, SyncRequestContext, SyncSessionResult, UpdateCircleInput, UpdateGroupInput, } from './types.js';
 export type ReceiveConfig = {
     /**
      * Receiver storage mode for incoming peer mutations.
@@ -58,20 +62,32 @@ export type ReceiveConfig = {
 export declare const DEFAULT_RECEIVE_CONFIG: ReceiveConfig;
 export type P2PPluginOptions = {
     autoAcceptPeers?: Array<string>;
+    /**
+     * How long `requestInviteToGroup` waits for its own Add commit to settle
+     * before returning the truthful pending shape (`invitePayload: null`,
+     * `request.status: PENDING`) instead of blocking further — the parked case,
+     * inviter offline. Test-only escape hatch — production omits it and runs on
+     * the 30s default; lets a headless test drive the park-then-pending path
+     * without waiting out the full production timeout.
+     */
+    inviteCommitTimeoutMs?: number;
     /**
      * Expose the sync protocol over the HTTP plugin transport.
-     * - `true` / `{}` — enable at the default protocol path `'sync'` with CORS
-     *   open to all origins (`['*']`).
+     * - `true` / `{}` — enable at the default protocol path `'sync'`. CORS
+     *   defaults to deny cross-origin browser requests.
      * - `'name'` / `'/name'` — enable at the given protocol path.
-     * - `{ path?, allowedOrigin? }` — `path` is the protocol path (default
-     *   `'sync'`); `allowedOrigin` restricts CORS origins (default `['*']`).
-     *   The default is open because the sync server authenticates every request,
-     *   so CORS is not the security boundary; operators may still restrict it.
+     * - `{ path?, allowedOrigin?, bodyLimit? }` — `path` is the protocol path
+     *   (default `'sync'`); `allowedOrigin` opts into cross-origin (default deny).
+     *   The sync server authenticates every request, so CORS is defense-in-depth
+     *   rather than the security boundary; non-browser clients are unaffected.
+     *   `bodyLimit` is the maximum request body size in bytes (default 1 MiB),
+     *   enforced by the transport.
      * - absent / `false` — HTTP sync transport disabled.
      */
     http?: boolean | string | {
         path?: string;
         allowedOrigin?: string | Array<string>;
+        bodyLimit?: number;
     };
     /**
      * Enable hub-mediated group broadcasts.
@@ -83,6 +99,17 @@ export type P2PPluginOptions = {
      */
     hub?: boolean | {
         createHubClient?: CreateHubClient;
+        /**
+         * Reconnect-backoff overrides for every hub adapter this device spawns.
+         * Test-only escape hatch — production omits it and runs on the adapter's
+         * defaults. Lets a headless multi-device test drive an offline/reconnect
+         * cycle without waiting out the ~1 s production base delay.
+         */
+        reconnectBackoff?: {
+            baseMs?: number;
+            maxMs?: number;
+            jitter?: number;
+        };
     };
     /**
      * Batch broadcast queue config. Sender-side mutation:apply broadcasts are
@@ -132,5 +159,14 @@ export type P2PPluginOptions = {
      * regardless of whether locally-authored mutations are broadcast.
      */
     forwarding?: ForwardingConfig;
+    /**
+     * How long a directed tunnel sync session waits with nothing arriving before
+     * giving up — how fast an unreachable peer is reported as one. Idle, not
+     * total: a session that keeps receiving frames never trips it.
+     *
+     * Test-only escape hatch; production omits it and runs on the 30s default,
+     * which a headless test would otherwise have to wait out per offline peer.
+     */
+    tunnelIdleTimeoutMs?: number;
 };
 export declare function createP2PPlugin(options?: P2PPluginOptions): (params: PluginFactoryParams) => KubunPlugin;