@pluv/client 5.0.1 → 5.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.mts +355 -0
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +1770 -0
- package/dist/index.mjs.map +1 -0
- package/package.json +8 -5
- package/CHANGELOG.md +0 -2415
- package/eslint.config.mjs +0 -4
- package/src/AbstractStorageStore.ts +0 -19
- package/src/CrdtManager.ts +0 -119
- package/src/CrdtNotifier.ts +0 -46
- package/src/EventNotifier.ts +0 -39
- package/src/ListenerManager.ts +0 -21
- package/src/MockedRoom.ts +0 -457
- package/src/PluvClient.ts +0 -204
- package/src/PluvProcedure.ts +0 -87
- package/src/PluvRoom.ts +0 -1610
- package/src/PluvRouter.ts +0 -71
- package/src/StateNotifier.ts +0 -41
- package/src/StorageStore.ts +0 -31
- package/src/UsersManager.ts +0 -341
- package/src/UsersNotifier.ts +0 -66
- package/src/constants.ts +0 -2
- package/src/createClient.ts +0 -14
- package/src/index.ts +0 -36
- package/src/infer.ts +0 -12
- package/src/register.ts +0 -20
- package/src/types.ts +0 -78
- package/src/utils/debounce.ts +0 -27
- package/src/utils/identity.ts +0 -1
- package/src/utils/index.ts +0 -3
- package/src/utils/pickBy.ts +0 -16
- package/tsconfig.json +0 -5
- package/tsdown.config.ts +0 -14
package/dist/index.d.mts
ADDED
|
@@ -0,0 +1,355 @@
|
|
|
1
|
+
import { BaseUser, BaseUser as BaseUser$1, BroadcastProxy, ConnectionState, CrdtDocLike, EventMessage, EventNotifierSubscriptionCallback, EventRecord, EventRecord as EventRecord$1, IOEventMessage, IOLike, IORouterLike, Id, InferIOAuthorize, InferIOAuthorizeUser, InferIOCrdt, InferIOCrdtKind, InferIOEvents, InferIOInput, InferIOOutput, InputZodLike, JsonObject, MaybePromise, MergeEvents, MergeEvents as MergeEvents$1, ProcedureLike, RoomEventListenerMap, RoomLike, RoomLike as RoomLike$1, SubscribeProxy, UpdateMyPresenceAction, UserInfo, UserInfo as UserInfo$1, WebSocketConnection, WebSocketConnection as WebSocketConnection$1, WebSocketState } from "@pluv/types";
|
|
2
|
+
import { AbstractCrdtDocFactory, CrdtType, InferCrdtJson, InferCrdtJson as InferCrdtJson$1, InferDoc, InferDocLike, InferStorage, NoopCrdtDocFactory } from "@pluv/crdt";
|
|
3
|
+
//#region src/AbstractStorageStore.d.ts
|
|
4
|
+
declare abstract class AbstractStorageStore {
|
|
5
|
+
room: string;
|
|
6
|
+
constructor(room: string);
|
|
7
|
+
abstract addUpdate(update: string): Promise<void>;
|
|
8
|
+
abstract destroy(): Promise<void>;
|
|
9
|
+
abstract flatten(encodedState: string): Promise<void>;
|
|
10
|
+
abstract getShouldFlatten(): Promise<boolean>;
|
|
11
|
+
abstract getUpdates(start?: number): Promise<readonly string[]>;
|
|
12
|
+
abstract initialize(): Promise<void>;
|
|
13
|
+
}
|
|
14
|
+
//#endregion
|
|
15
|
+
//#region src/utils/identity.d.ts
|
|
16
|
+
declare const identity: <T extends unknown>(x: T) => T;
|
|
17
|
+
//#endregion
|
|
18
|
+
//#region src/infer.d.ts
|
|
19
|
+
type InferCallback<TIO extends IOLike<any, any, any>> = (i: typeof identity) => {
|
|
20
|
+
io: (io: TIO) => TIO;
|
|
21
|
+
};
|
|
22
|
+
declare const infer: <TIO extends IOLike<any, any, any>>(callback: InferCallback<TIO>) => InferCallback<IOLike<InferIOAuthorize<TIO>, InferIOCrdt<TIO>, InferIOEvents<TIO>>>;
|
|
23
|
+
//#endregion
|
|
24
|
+
//#region src/types.d.ts
|
|
25
|
+
type EventResolver<TIO extends IOLike, TInput extends JsonObject, TOutput extends EventRecord$1<string, any>, TPresence extends Record<string, any>, TDocLike extends CrdtDocLike<any, any>> = (data: TInput, context: EventResolverContext<TIO, TPresence, TDocLike>) => MaybePromise<TOutput | void>;
|
|
26
|
+
interface EventResolverContext<TIO extends IOLike, TPresence extends Record<string, any>, TDocLike extends CrdtDocLike<any, any>> {
|
|
27
|
+
doc: TDocLike;
|
|
28
|
+
others: readonly UserInfo$1<TIO, TPresence>[];
|
|
29
|
+
room: string;
|
|
30
|
+
user: UserInfo$1<TIO, TPresence>;
|
|
31
|
+
}
|
|
32
|
+
type InferMetadata<TClient extends PluvClient<any, any, any, any>> = TClient extends PluvClient<any, any, any, infer IMetadata> ? IMetadata : never;
|
|
33
|
+
type MergeEventRecords<TEventRecords extends EventRecord$1<string, any>[], TRoot extends EventRecord$1<string, any> = {}> = TEventRecords extends [infer IHead extends EventRecord$1<string, any>, ...infer ITail extends EventRecord$1<string, any>[]] ? MergeEventRecords<ITail, Omit<TRoot, keyof IHead> & { [P in keyof IHead]: TRoot extends Record<P, any> ? TRoot[P] | IHead[P] : IHead[P]; }> : Id<TRoot>;
|
|
34
|
+
interface PluvClientLimits {
|
|
35
|
+
/**
|
|
36
|
+
* @description Maximum size of presence object in bytes
|
|
37
|
+
*/
|
|
38
|
+
presenceMaxSize?: number | null;
|
|
39
|
+
}
|
|
40
|
+
interface PublicKeyParams<TMetadata extends JsonObject> {
|
|
41
|
+
metadata: TMetadata;
|
|
42
|
+
}
|
|
43
|
+
type PublicKey<TMetadata extends JsonObject> = string | ((params: PublicKeyParams<TMetadata>) => string);
|
|
44
|
+
type WithMetadata<TMetadata extends JsonObject = {}> = keyof TMetadata extends never ? {
|
|
45
|
+
metadata?: undefined;
|
|
46
|
+
} : {
|
|
47
|
+
metadata: TMetadata;
|
|
48
|
+
};
|
|
49
|
+
//#endregion
|
|
50
|
+
//#region src/PluvProcedure.d.ts
|
|
51
|
+
interface PluvProcedureConfig<TIO extends IOLike, TInput extends JsonObject, TOutput extends EventRecord$1<string, any>, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>> {
|
|
52
|
+
broadcast?: EventResolver<TIO, TInput, TOutput, TPresence, InferDocLike<TCrdt>> | null;
|
|
53
|
+
input?: InputZodLike<TInput>;
|
|
54
|
+
}
|
|
55
|
+
declare class PluvProcedure<TIO extends IOLike, TInput extends JsonObject, TOutput extends EventRecord$1<string, any>, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TFilled extends "input" | "broadcast" | ""> implements ProcedureLike<TInput, TOutput> {
|
|
56
|
+
private _broadcast;
|
|
57
|
+
private _input;
|
|
58
|
+
get config(): ProcedureLike<TInput, TOutput>["config"];
|
|
59
|
+
constructor(config?: PluvProcedureConfig<TIO, TInput, TOutput, TPresence, TCrdt>);
|
|
60
|
+
broadcast<TResult extends EventRecord$1<string, any> = {}>(resolver: EventResolver<TIO, TInput, TResult, TPresence, InferDocLike<TCrdt>>): Omit<PluvProcedure<TIO, TInput, MergeEventRecords<[TOutput, TResult]>, TPresence, TCrdt, TFilled | "input" | "broadcast">, TFilled | "input" | "broadcast">;
|
|
61
|
+
input<TData extends JsonObject>(input: InputZodLike<TData>): Omit<PluvProcedure<TIO, TData, {}, TPresence, TCrdt, TFilled | "input">, TFilled | "input">;
|
|
62
|
+
private _resolver;
|
|
63
|
+
}
|
|
64
|
+
//#endregion
|
|
65
|
+
//#region src/CrdtManager.d.ts
|
|
66
|
+
type CrdtManagerOptions<TCrdt extends AbstractCrdtDocFactory<any, any>> = {
|
|
67
|
+
initialStorage?: TCrdt;
|
|
68
|
+
};
|
|
69
|
+
//#endregion
|
|
70
|
+
//#region src/PluvRouter.d.ts
|
|
71
|
+
type PluvRouterEventConfig<TIO extends IOLike, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>> = {
|
|
72
|
+
[P: string]: Pick<PluvProcedure<TIO, any, any, TPresence, TCrdt, "">, "config">;
|
|
73
|
+
};
|
|
74
|
+
type MergedRouter<TRouters extends PluvRouter<TIO, TPresence, TCrdt, any>[], TIO extends IOLike, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TRoot extends TRouters[0]["_defs"]["events"]> = TRouters extends [infer IHead extends PluvRouter<TIO, TPresence, TCrdt, any>, ...infer ITail extends PluvRouter<TIO, TPresence, TCrdt, any>[]] ? MergedRouter<ITail, TIO, TPresence, TCrdt, TRoot & IHead["_defs"]["events"]> : PluvRouter<TIO, TPresence, TCrdt, TRoot>;
|
|
75
|
+
declare class PluvRouter<TIO extends IOLike, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TEvents extends PluvRouterEventConfig<TIO, TPresence, TCrdt> = {}> implements IORouterLike<TEvents> {
|
|
76
|
+
readonly _defs: {
|
|
77
|
+
events: TEvents;
|
|
78
|
+
};
|
|
79
|
+
constructor(events: TEvents);
|
|
80
|
+
static merge<TRouters extends PluvRouter<TIO, TPresence, TCrdt, any>[], TIO extends IOLike, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>>(...routers: TRouters): MergedRouter<TRouters, TIO, TPresence, TCrdt, {}>;
|
|
81
|
+
private _isValidEventName;
|
|
82
|
+
}
|
|
83
|
+
//#endregion
|
|
84
|
+
//#region src/UsersManager.d.ts
|
|
85
|
+
type UsersManagerConfig<TPresence extends Record<string, any> = {}> = {
|
|
86
|
+
initialPresence?: TPresence;
|
|
87
|
+
limits: PluvClientLimits;
|
|
88
|
+
presence?: InputZodLike<TPresence>;
|
|
89
|
+
};
|
|
90
|
+
//#endregion
|
|
91
|
+
//#region src/PluvRoom.d.ts
|
|
92
|
+
declare global {
|
|
93
|
+
var process: {
|
|
94
|
+
env: {
|
|
95
|
+
[key: string]: string | undefined;
|
|
96
|
+
};
|
|
97
|
+
};
|
|
98
|
+
}
|
|
99
|
+
interface EndpointParams<TMetadata extends JsonObject> {
|
|
100
|
+
metadata: TMetadata;
|
|
101
|
+
room: string;
|
|
102
|
+
}
|
|
103
|
+
type AuthEndpoint<TMetadata extends JsonObject> = string | ((params: EndpointParams<TMetadata>) => string | FetchOptions) | true;
|
|
104
|
+
type WsEndpoint<TMetadata extends JsonObject> = string | ((params: EndpointParams<TMetadata>) => string);
|
|
105
|
+
type FetchOptions = {
|
|
106
|
+
url: string;
|
|
107
|
+
options?: RequestInit;
|
|
108
|
+
};
|
|
109
|
+
type RoomEndpoints<TIO extends IOLike<any, any, any>, TMetadata extends JsonObject> = {
|
|
110
|
+
wsEndpoint?: WsEndpoint<TMetadata>;
|
|
111
|
+
} & (InferIOAuthorizeUser<InferIOAuthorize<TIO>> extends BaseUser$1 ? {
|
|
112
|
+
authEndpoint: AuthEndpoint<TMetadata>;
|
|
113
|
+
} : {
|
|
114
|
+
authEndpoint?: undefined;
|
|
115
|
+
});
|
|
116
|
+
type PluvRoomAddon<TIO extends IOLike, TMetadata extends JsonObject, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>> = (input: PluvRoomAddonInput<TIO, TMetadata, TPresence, TCrdt>) => Partial<PluvRoomAddonResult>;
|
|
117
|
+
interface PluvRoomAddonInput<TIO extends IOLike, TMetadata extends JsonObject, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>> {
|
|
118
|
+
room: PluvRoom<TIO, TMetadata, TPresence, TCrdt>;
|
|
119
|
+
}
|
|
120
|
+
interface PluvRoomAddonResult {
|
|
121
|
+
storage: AbstractStorageStore;
|
|
122
|
+
}
|
|
123
|
+
type PluvRoomDebug<TIO extends IOLike> = Id<{
|
|
124
|
+
output: readonly (keyof InferIOOutput<TIO>)[];
|
|
125
|
+
input: readonly (keyof InferIOInput<TIO>)[];
|
|
126
|
+
}>;
|
|
127
|
+
type RoomConnectParams<TMetadata extends JsonObject = {}> = keyof TMetadata extends never ? [] : [WithMetadata<TMetadata>];
|
|
128
|
+
interface ReconnectTimeoutMsParams {
|
|
129
|
+
attempts: number;
|
|
130
|
+
}
|
|
131
|
+
type ReconnectTimeoutMs = number | ((params: ReconnectTimeoutMsParams) => number);
|
|
132
|
+
type RoomConfig<TIO extends IOLike, TMetadata extends JsonObject, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>>> = Id<{
|
|
133
|
+
addons?: readonly PluvRoomAddon<TIO, TMetadata, TPresence, TCrdt>[];
|
|
134
|
+
debug?: boolean | PluvRoomDebug<TIO>;
|
|
135
|
+
limits: PluvClientLimits;
|
|
136
|
+
onAuthorizationFail?: (error: Error) => void;
|
|
137
|
+
metadata?: InputZodLike<TMetadata>;
|
|
138
|
+
publicKey?: PublicKey<TMetadata>;
|
|
139
|
+
reconnectTimeoutMs?: ReconnectTimeoutMs;
|
|
140
|
+
router?: PluvRouter<TIO, TPresence, InferStorage<TCrdt>, TEvents>;
|
|
141
|
+
} & RoomEndpoints<TIO, TMetadata> & Pick<CrdtManagerOptions<TCrdt>, "initialStorage"> & UsersManagerConfig<TPresence>>;
|
|
142
|
+
declare class PluvRoom<TIO extends IOLike<any, any, any>, TMetadata extends JsonObject = {}, TPresence extends Record<string, any> = {}, TCrdt extends AbstractCrdtDocFactory<any, any> = NoopCrdtDocFactory, TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>> = {}> implements RoomLike$1<TIO, InferDoc<TCrdt>, TPresence, InferStorage<TCrdt>> {
|
|
143
|
+
#private;
|
|
144
|
+
readonly _endpoints: RoomEndpoints<TIO, TMetadata>;
|
|
145
|
+
readonly id: string;
|
|
146
|
+
readonly metadata?: InputZodLike<TMetadata>;
|
|
147
|
+
private readonly _crdtManager;
|
|
148
|
+
private readonly _crdtNotifier;
|
|
149
|
+
private readonly _debug;
|
|
150
|
+
private readonly _eventNotifier;
|
|
151
|
+
private readonly _intervals;
|
|
152
|
+
private readonly _limits;
|
|
153
|
+
private readonly _listenerManager;
|
|
154
|
+
private readonly _listeners;
|
|
155
|
+
private readonly _publicKey;
|
|
156
|
+
private readonly _reconnectTimeoutMs;
|
|
157
|
+
private readonly _router;
|
|
158
|
+
private readonly _stateNotifier;
|
|
159
|
+
private readonly _storageStore;
|
|
160
|
+
private readonly _subscriptions;
|
|
161
|
+
private readonly _timeouts;
|
|
162
|
+
private readonly _usersManager;
|
|
163
|
+
private readonly _usersNotifier;
|
|
164
|
+
private _lastMetadata;
|
|
165
|
+
private _state;
|
|
166
|
+
private _windowListeners;
|
|
167
|
+
private _wsListeners;
|
|
168
|
+
constructor(room: string, options: RoomConfig<TIO, TMetadata, TPresence, TCrdt, TEvents>);
|
|
169
|
+
get webSocket(): WebSocket | null;
|
|
170
|
+
addEventListener<TKind extends keyof RoomEventListenerMap>(kind: TKind, handler: RoomEventListenerMap[TKind]): () => void;
|
|
171
|
+
broadcast: BroadcastProxy<TIO, TEvents>;
|
|
172
|
+
canRedo: () => boolean;
|
|
173
|
+
canUndo: () => boolean;
|
|
174
|
+
connect(...args: RoomConnectParams<TMetadata>): Promise<void>;
|
|
175
|
+
disconnect(): Promise<void>;
|
|
176
|
+
getConnection: () => WebSocketConnection$1;
|
|
177
|
+
getDoc: () => CrdtDocLike<InferDoc<TCrdt>, InferStorage<TCrdt>>;
|
|
178
|
+
getMyPresence: () => TPresence;
|
|
179
|
+
getMyself: () => Id<UserInfo$1<TIO, TPresence>> | null;
|
|
180
|
+
getOther: (connectionId: string) => Id<UserInfo$1<TIO, TPresence>> | null;
|
|
181
|
+
getOthers: () => readonly Id<UserInfo$1<TIO, TPresence>>[];
|
|
182
|
+
getStorage: <TKey extends keyof InferStorage<TCrdt>>(type: TKey) => InferStorage<TCrdt>[TKey] | null;
|
|
183
|
+
getStorageJson(): InferCrdtJson$1<InferStorage<TCrdt>> | null;
|
|
184
|
+
getStorageJson<TKey extends keyof InferStorage<TCrdt>>(type: TKey): InferCrdtJson$1<InferStorage<TCrdt>[TKey]> | null;
|
|
185
|
+
getStorageLoaded: () => boolean;
|
|
186
|
+
redo: () => void;
|
|
187
|
+
subscribe: SubscribeProxy<TIO, TPresence, InferStorage<TCrdt>, TEvents>;
|
|
188
|
+
transact: (fn: (storage: InferStorage<TCrdt>) => void, origin?: string) => void;
|
|
189
|
+
undo: () => void;
|
|
190
|
+
updateMyPresence: (presence: UpdateMyPresenceAction<TPresence>) => void;
|
|
191
|
+
private _addToStorageStore;
|
|
192
|
+
private _attachWindowListeners;
|
|
193
|
+
private _attachWsListeners;
|
|
194
|
+
private _clearInterval;
|
|
195
|
+
private _clearTimeout;
|
|
196
|
+
private _closeWs;
|
|
197
|
+
private _detachWindowListeners;
|
|
198
|
+
private _detachWsListeners;
|
|
199
|
+
private _emitSharedTypes;
|
|
200
|
+
private _event;
|
|
201
|
+
private _flattenStorageStore;
|
|
202
|
+
private _getAddon;
|
|
203
|
+
private _getAuthFetchOptions;
|
|
204
|
+
private _getAuthorization;
|
|
205
|
+
private _getPublicKey;
|
|
206
|
+
private _getWsEndpoint;
|
|
207
|
+
private _handleExit;
|
|
208
|
+
private _handlePresenceUpdatedMessage;
|
|
209
|
+
private _handleReceiveOthers;
|
|
210
|
+
private _handleRegisteredMessage;
|
|
211
|
+
private _handleStorageReceivedMessage;
|
|
212
|
+
private _handleStorageUpdatedMessage;
|
|
213
|
+
private _handleSyncStateReceived;
|
|
214
|
+
private _handleUserJoinedMessage;
|
|
215
|
+
private _heartbeat;
|
|
216
|
+
private _logDebug;
|
|
217
|
+
private _observeCrdt;
|
|
218
|
+
private _onAuthorizationFail;
|
|
219
|
+
private _onClose;
|
|
220
|
+
/**
|
|
221
|
+
* TODO
|
|
222
|
+
* @description Handle websocket errors in a meaningful way, should they occur
|
|
223
|
+
* @date August 19, 2022
|
|
224
|
+
*/
|
|
225
|
+
private _onError;
|
|
226
|
+
private _onMessage;
|
|
227
|
+
private _onOpen;
|
|
228
|
+
private _onNavigatorOffline;
|
|
229
|
+
private _onNavigatorOnline;
|
|
230
|
+
private _onVisibilityChange;
|
|
231
|
+
private _onWindowFocus;
|
|
232
|
+
private _other;
|
|
233
|
+
private _parseMessage;
|
|
234
|
+
private _pollReconnect;
|
|
235
|
+
private _reconnect;
|
|
236
|
+
private _sendMessage;
|
|
237
|
+
private _setMetadata;
|
|
238
|
+
private _updateState;
|
|
239
|
+
}
|
|
240
|
+
//#endregion
|
|
241
|
+
//#region src/PluvClient.d.ts
|
|
242
|
+
type PluvClientOptions<TIO extends IOLike<any, any, any>, TPresence extends Record<string, any>, TCrdt extends InferIOCrdtKind<TIO>, TMetadata extends JsonObject> = RoomEndpoints<TIO, TMetadata> & {
|
|
243
|
+
debug?: boolean;
|
|
244
|
+
/**
|
|
245
|
+
* @description Configurable limits defined for client-side validation. You should only set
|
|
246
|
+
* this if you control the server and have changed the limits there.
|
|
247
|
+
*/
|
|
248
|
+
limits?: PluvClientLimits;
|
|
249
|
+
metadata?: InputZodLike<TMetadata>;
|
|
250
|
+
presence?: InputZodLike<TPresence>;
|
|
251
|
+
publicKey?: PublicKey<TMetadata>;
|
|
252
|
+
types: InferCallback<TIO>;
|
|
253
|
+
} & (InferIOCrdtKind<TIO> extends NoopCrdtDocFactory ? {
|
|
254
|
+
initialStorage?: "[ERROR]: Must provide crdt to createIO to use storage";
|
|
255
|
+
} : {
|
|
256
|
+
initialStorage?: TCrdt;
|
|
257
|
+
});
|
|
258
|
+
type CreateRoomOptions<TIO extends IOLike<any, any, any>, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TMetadata extends JsonObject, TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>> = {}> = {
|
|
259
|
+
addons?: readonly PluvRoomAddon<TIO, TMetadata, TPresence, InferStorage<TCrdt>>[];
|
|
260
|
+
debug?: boolean | PluvRoomDebug<TIO>;
|
|
261
|
+
initialPresence?: TPresence;
|
|
262
|
+
initialStorage?: TCrdt;
|
|
263
|
+
onAuthorizationFail?: (error: Error) => void;
|
|
264
|
+
reconnectTimeoutMs?: ReconnectTimeoutMs;
|
|
265
|
+
router?: PluvRouter<TIO, TPresence, InferStorage<TCrdt>, TEvents>;
|
|
266
|
+
};
|
|
267
|
+
type EnterRoomParams<TMetadata extends JsonObject = {}> = keyof TMetadata extends never ? [] : [WithMetadata<TMetadata>];
|
|
268
|
+
declare class PluvClient<TIO extends IOLike<any, any, any>, TPresence extends Record<string, any> = {}, TCrdt extends InferIOCrdtKind<TIO> = InferIOCrdtKind<TIO>, TMetadata extends JsonObject = {}> {
|
|
269
|
+
readonly metadata?: InputZodLike<TMetadata>;
|
|
270
|
+
private readonly _authEndpoint;
|
|
271
|
+
private readonly _debug;
|
|
272
|
+
private readonly _initialStorage?;
|
|
273
|
+
private readonly _limits;
|
|
274
|
+
private readonly _presence?;
|
|
275
|
+
private readonly _publicKey;
|
|
276
|
+
private readonly _rooms;
|
|
277
|
+
private readonly _wsEndpoint;
|
|
278
|
+
get _defs(): {
|
|
279
|
+
initialStorage: TCrdt | undefined;
|
|
280
|
+
};
|
|
281
|
+
get procedure(): PluvProcedure<TIO, {}, {}, TPresence, TCrdt, "">;
|
|
282
|
+
constructor(options: PluvClientOptions<TIO, TPresence, TCrdt, TMetadata>);
|
|
283
|
+
createRoom: <TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>> = {}>(room: string, options?: CreateRoomOptions<TIO, TPresence, TCrdt, TMetadata, TEvents>) => PluvRoom<TIO, TMetadata, TPresence, TCrdt, TEvents>;
|
|
284
|
+
enter: (room: string | PluvRoom<TIO, TMetadata, any, any, any>, ...args: EnterRoomParams<TMetadata>) => Promise<PluvRoom<TIO, TMetadata, TPresence, TCrdt, any>>;
|
|
285
|
+
getRoom: (room: string) => PluvRoom<TIO, TMetadata, TPresence, TCrdt, any> | null;
|
|
286
|
+
getRooms: () => readonly PluvRoom<TIO, TMetadata, TPresence, TCrdt, any>[];
|
|
287
|
+
leave: (room: string | PluvRoom<TIO, any, any, any>) => Promise<void>;
|
|
288
|
+
router<TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>> = {}>(events: TEvents): PluvRouter<TIO, TPresence, InferStorage<TCrdt>, TEvents>;
|
|
289
|
+
private _logDebug;
|
|
290
|
+
}
|
|
291
|
+
//#endregion
|
|
292
|
+
//#region src/createClient.d.ts
|
|
293
|
+
declare const createClient: <TIO extends IOLike<any, any, any>, TPresence extends Record<string, any> = {}, TCrdt extends InferIOCrdtKind<TIO> = InferIOCrdtKind<TIO>, TMetadata extends JsonObject = {}>(options: PluvClientOptions<TIO, TPresence, TCrdt, TMetadata>) => PluvClient<TIO, TPresence, TCrdt, TMetadata>;
|
|
294
|
+
//#endregion
|
|
295
|
+
//#region src/MockedRoom.d.ts
|
|
296
|
+
type MockedRoomEvents<TIO extends IOLike> = Partial<{ [P in keyof InferIOInput<TIO>]: (data: Id<InferIOInput<TIO>[P]>) => Partial<InferIOOutput<TIO>>; }>;
|
|
297
|
+
type MockedRoomConfig<TIO extends IOLike, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>>> = {
|
|
298
|
+
events?: MockedRoomEvents<MergeEvents$1<TEvents, TIO>>;
|
|
299
|
+
limits?: PluvClientLimits;
|
|
300
|
+
router?: PluvRouter<TIO, TPresence, InferStorage<TCrdt>, TEvents>;
|
|
301
|
+
} & Pick<CrdtManagerOptions<TCrdt>, "initialStorage"> & Omit<UsersManagerConfig<TPresence>, "limits">;
|
|
302
|
+
declare class MockedRoom<TIO extends IOLike, TPresence extends Record<string, any>, TCrdt extends AbstractCrdtDocFactory<any, any>, TEvents extends PluvRouterEventConfig<TIO, TPresence, InferStorage<TCrdt>>> implements RoomLike$1<TIO, InferDoc<TCrdt>, TPresence, InferStorage<TCrdt>> {
|
|
303
|
+
#private;
|
|
304
|
+
readonly id: string;
|
|
305
|
+
private readonly _crdtManager;
|
|
306
|
+
private readonly _crdtNotifier;
|
|
307
|
+
private readonly _eventNotifier;
|
|
308
|
+
private readonly _events?;
|
|
309
|
+
private readonly _limits;
|
|
310
|
+
private readonly _usersNotifier;
|
|
311
|
+
private readonly _router;
|
|
312
|
+
private _state;
|
|
313
|
+
private readonly _stateNotifier;
|
|
314
|
+
private readonly _subscriptions;
|
|
315
|
+
private readonly _usersManager;
|
|
316
|
+
constructor(room: string, options: MockedRoomConfig<TIO, TPresence, TCrdt, TEvents>);
|
|
317
|
+
addEventListener<TKind extends keyof RoomEventListenerMap>(kind: TKind, handler: RoomEventListenerMap[TKind]): () => void;
|
|
318
|
+
broadcast: BroadcastProxy<TIO, TEvents>;
|
|
319
|
+
canRedo: () => boolean;
|
|
320
|
+
canUndo: () => boolean;
|
|
321
|
+
getConnection: () => WebSocketConnection$1;
|
|
322
|
+
getDoc(): CrdtDocLike<InferDoc<TCrdt>, InferStorage<TCrdt>>;
|
|
323
|
+
getMyPresence: () => TPresence;
|
|
324
|
+
getMyself: () => Id<UserInfo$1<TIO, TPresence>> | null;
|
|
325
|
+
getOther: (connectionId: string) => Id<UserInfo$1<TIO, TPresence>> | null;
|
|
326
|
+
getOthers: () => readonly Id<UserInfo$1<TIO, TPresence>>[];
|
|
327
|
+
getStorage: <TKey extends keyof InferStorage<TCrdt>>(type: TKey) => InferStorage<TCrdt>[TKey] | null;
|
|
328
|
+
getStorageJson(): InferCrdtJson$1<InferStorage<TCrdt>> | null;
|
|
329
|
+
getStorageJson<TKey extends keyof InferStorage<TCrdt>>(type: TKey): InferCrdtJson$1<InferStorage<TCrdt>[TKey]> | null;
|
|
330
|
+
getStorageLoaded(): boolean;
|
|
331
|
+
redo: () => void;
|
|
332
|
+
storageRoot: (fn: (value: { [P in keyof InferStorage<TCrdt>]: InferCrdtJson$1<InferStorage<TCrdt>[P]>; }) => void) => (() => void);
|
|
333
|
+
subscribe: SubscribeProxy<TIO, TPresence, InferStorage<TCrdt>, TEvents>;
|
|
334
|
+
transact: (fn: (storage: InferStorage<TCrdt>) => void, origin?: string) => void;
|
|
335
|
+
undo: () => void;
|
|
336
|
+
updateMyPresence: (presence: UpdateMyPresenceAction<TPresence>) => void;
|
|
337
|
+
private _event;
|
|
338
|
+
private _observeCrdt;
|
|
339
|
+
private _other;
|
|
340
|
+
private _simulateEvent;
|
|
341
|
+
}
|
|
342
|
+
//#endregion
|
|
343
|
+
//#region src/register.d.ts
|
|
344
|
+
interface RegisterParams<TMetadata extends JsonObject> {
|
|
345
|
+
authEndpoint: AuthEndpoint<TMetadata>;
|
|
346
|
+
publicKey: string;
|
|
347
|
+
}
|
|
348
|
+
declare const register: <TMetadata extends JsonObject>(params: RegisterParams<TMetadata>) => {
|
|
349
|
+
authEndpoint: AuthEndpoint<TMetadata>;
|
|
350
|
+
publicKey: string;
|
|
351
|
+
wsEndpoint: (params: EndpointParams<TMetadata>) => string;
|
|
352
|
+
};
|
|
353
|
+
//#endregion
|
|
354
|
+
export { AbstractStorageStore, type BaseUser, ConnectionState, type CrdtType, type CreateRoomOptions, type EnterRoomParams, type EventMessage, type EventNotifierSubscriptionCallback, type EventRecord, type IOEventMessage, type InferCallback, type InferCrdtJson, type InferMetadata, type MergeEvents, MockedRoom, type MockedRoomConfig, type MockedRoomEvents, PluvClient, type PluvClientOptions, type PluvProcedureConfig, PluvRoom, type PluvRoomAddon, type PluvRoomAddonInput, type PluvRoomAddonResult, type PluvRoomDebug, type PluvRouter, type PluvRouterEventConfig, type PublicKey, type PublicKeyParams, type RegisterParams, type RoomConnectParams, type RoomEndpoints, type RoomLike, type UserInfo, type WebSocketConnection, type WebSocketState, createClient, infer, register };
|
|
355
|
+
//# sourceMappingURL=index.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/AbstractStorageStore.ts","../src/utils/identity.ts","../src/infer.ts","../src/types.ts","../src/PluvProcedure.ts","../src/CrdtManager.ts","../src/PluvRouter.ts","../src/UsersManager.ts","../src/PluvRoom.ts","../src/PluvClient.ts","../src/createClient.ts","../src/MockedRoom.ts","../src/register.ts"],"mappings":"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"}
|