@hocuspocus/extension-webhook 1.0.0-alpha.34

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.
Files changed (58) hide show
  1. package/CHANGELOG.md +272 -0
  2. package/LICENSE.md +21 -0
  3. package/dist/demos/backend/src/create-document.d.ts +1 -0
  4. package/dist/demos/backend/src/express.d.ts +1 -0
  5. package/dist/demos/backend/src/koa.d.ts +1 -0
  6. package/dist/demos/backend/src/minimal.d.ts +1 -0
  7. package/dist/demos/backend/src/monitor.d.ts +1 -0
  8. package/dist/demos/backend/src/redis.d.ts +1 -0
  9. package/dist/demos/backend/src/slow.d.ts +1 -0
  10. package/dist/demos/backend/src/webhook.d.ts +1 -0
  11. package/dist/hocuspocus-webhook.cjs +158 -0
  12. package/dist/hocuspocus-webhook.cjs.map +1 -0
  13. package/dist/hocuspocus-webhook.esm.js +150 -0
  14. package/dist/hocuspocus-webhook.esm.js.map +1 -0
  15. package/dist/packages/logger/src/index.d.ts +13 -0
  16. package/dist/packages/monitor/src/Collector.d.ts +62 -0
  17. package/dist/packages/monitor/src/Dashboard.d.ts +29 -0
  18. package/dist/packages/monitor/src/Storage.d.ts +35 -0
  19. package/dist/packages/monitor/src/index.d.ts +38 -0
  20. package/dist/packages/provider/src/EventEmitter.d.ts +9 -0
  21. package/dist/packages/provider/src/HocuspocusProvider.d.ts +158 -0
  22. package/dist/packages/provider/src/IncomingMessage.d.ts +14 -0
  23. package/dist/packages/provider/src/MessageReceiver.d.ts +13 -0
  24. package/dist/packages/provider/src/MessageSender.d.ts +10 -0
  25. package/dist/packages/provider/src/OutgoingMessage.d.ts +9 -0
  26. package/dist/packages/provider/src/OutgoingMessages/AuthenticationMessage.d.ts +7 -0
  27. package/dist/packages/provider/src/OutgoingMessages/AwarenessMessage.d.ts +8 -0
  28. package/dist/packages/provider/src/OutgoingMessages/QueryAwarenessMessage.d.ts +8 -0
  29. package/dist/packages/provider/src/OutgoingMessages/SyncStepOneMessage.d.ts +8 -0
  30. package/dist/packages/provider/src/OutgoingMessages/SyncStepTwoMessage.d.ts +8 -0
  31. package/dist/packages/provider/src/OutgoingMessages/UpdateMessage.d.ts +7 -0
  32. package/dist/packages/provider/src/index.d.ts +3 -0
  33. package/dist/packages/provider/src/types.d.ts +34 -0
  34. package/dist/packages/provider/src/utils/awarenessStatesToArray.d.ts +4 -0
  35. package/dist/packages/provider/src/utils/index.d.ts +1 -0
  36. package/dist/packages/redis/src/Redis.d.ts +16 -0
  37. package/dist/packages/redis/src/RedisCluster.d.ts +4 -0
  38. package/dist/packages/redis/src/index.d.ts +2 -0
  39. package/dist/packages/rocksdb/src/index.d.ts +22 -0
  40. package/dist/packages/server/src/CloseEvents.d.ts +4 -0
  41. package/dist/packages/server/src/Connection.d.ts +62 -0
  42. package/dist/packages/server/src/Debugger.d.ts +15 -0
  43. package/dist/packages/server/src/Document.d.ts +75 -0
  44. package/dist/packages/server/src/Hocuspocus.d.ts +86 -0
  45. package/dist/packages/server/src/IncomingMessage.d.ts +19 -0
  46. package/dist/packages/server/src/MessageReceiver.d.ts +10 -0
  47. package/dist/packages/server/src/OutgoingMessage.d.ts +16 -0
  48. package/dist/packages/server/src/index.d.ts +2 -0
  49. package/dist/packages/server/src/types.d.ts +133 -0
  50. package/dist/packages/throttle/src/index.d.ts +20 -0
  51. package/dist/packages/transformer/src/Prosemirror.d.ts +11 -0
  52. package/dist/packages/transformer/src/Tiptap.d.ts +10 -0
  53. package/dist/packages/transformer/src/index.d.ts +3 -0
  54. package/dist/packages/transformer/src/types.d.ts +5 -0
  55. package/dist/packages/webhook/src/index.d.ts +59 -0
  56. package/dist/shared/protocols/auth.d.ts +6 -0
  57. package/package.json +32 -0
  58. package/src/index.ts +197 -0
@@ -0,0 +1,14 @@
1
+ import { Decoder } from 'lib0/decoding';
2
+ import { Encoder } from 'lib0/encoding';
3
+ import { MessageType } from './types';
4
+ export declare class IncomingMessage {
5
+ data: any;
6
+ encoder: Encoder;
7
+ decoder: Decoder;
8
+ constructor(data: any);
9
+ readVarUint(): MessageType;
10
+ readVarUint8Array(): Uint8Array;
11
+ writeVarUint(type: MessageType): void;
12
+ writeVarUint8Array(data: Uint8Array): void;
13
+ length(): number;
14
+ }
@@ -0,0 +1,13 @@
1
+ import { HocuspocusProvider } from './HocuspocusProvider';
2
+ import { IncomingMessage } from './IncomingMessage';
3
+ export declare class MessageReceiver {
4
+ message: IncomingMessage;
5
+ broadcasted: boolean;
6
+ constructor(message: IncomingMessage);
7
+ setBroadcasted(value: boolean): this;
8
+ apply(provider: HocuspocusProvider, emitSynced?: boolean): void;
9
+ private applySyncMessage;
10
+ private applyAwarenessMessage;
11
+ private applyAuthMessage;
12
+ private applyQueryAwarenessMessage;
13
+ }
@@ -0,0 +1,10 @@
1
+ import { Encoder } from 'lib0/encoding';
2
+ import { ConstructableOutgoingMessage } from './types';
3
+ export declare class MessageSender {
4
+ encoder: Encoder;
5
+ message: any;
6
+ constructor(Message: ConstructableOutgoingMessage, args?: any);
7
+ create(): Uint8Array;
8
+ send(webSocket: any): void;
9
+ broadcast(channel: string): void;
10
+ }
@@ -0,0 +1,9 @@
1
+ import { Encoder } from 'lib0/encoding';
2
+ import { MessageType, OutgoingMessageArguments, OutgoingMessageInterface } from './types';
3
+ export declare class OutgoingMessage implements OutgoingMessageInterface {
4
+ encoder: Encoder;
5
+ type?: MessageType;
6
+ constructor();
7
+ get(args: Partial<OutgoingMessageArguments>): Encoder | undefined;
8
+ toUint8Array(): Uint8Array;
9
+ }
@@ -0,0 +1,7 @@
1
+ import { MessageType, OutgoingMessageArguments } from '../types';
2
+ import { OutgoingMessage } from '../OutgoingMessage';
3
+ export declare class AuthenticationMessage extends OutgoingMessage {
4
+ type: MessageType;
5
+ description: string;
6
+ get(args: Partial<OutgoingMessageArguments>): import("lib0/encoding").Encoder;
7
+ }
@@ -0,0 +1,8 @@
1
+ import * as encoding from 'lib0/encoding';
2
+ import { MessageType, OutgoingMessageArguments } from '../types';
3
+ import { OutgoingMessage } from '../OutgoingMessage';
4
+ export declare class AwarenessMessage extends OutgoingMessage {
5
+ type: MessageType;
6
+ description: string;
7
+ get(args: Partial<OutgoingMessageArguments>): encoding.Encoder;
8
+ }
@@ -0,0 +1,8 @@
1
+ import * as encoding from 'lib0/encoding';
2
+ import { MessageType, OutgoingMessageArguments } from '../types';
3
+ import { OutgoingMessage } from '../OutgoingMessage';
4
+ export declare class QueryAwarenessMessage extends OutgoingMessage {
5
+ type: MessageType;
6
+ description: string;
7
+ get(args: Partial<OutgoingMessageArguments>): encoding.Encoder;
8
+ }
@@ -0,0 +1,8 @@
1
+ import * as encoding from 'lib0/encoding';
2
+ import { MessageType, OutgoingMessageArguments } from '../types';
3
+ import { OutgoingMessage } from '../OutgoingMessage';
4
+ export declare class SyncStepOneMessage extends OutgoingMessage {
5
+ type: MessageType;
6
+ description: string;
7
+ get(args: Partial<OutgoingMessageArguments>): encoding.Encoder;
8
+ }
@@ -0,0 +1,8 @@
1
+ import * as encoding from 'lib0/encoding';
2
+ import { MessageType, OutgoingMessageArguments } from '../types';
3
+ import { OutgoingMessage } from '../OutgoingMessage';
4
+ export declare class SyncStepTwoMessage extends OutgoingMessage {
5
+ type: MessageType;
6
+ description: string;
7
+ get(args: Partial<OutgoingMessageArguments>): encoding.Encoder;
8
+ }
@@ -0,0 +1,7 @@
1
+ import { MessageType, OutgoingMessageArguments } from '../types';
2
+ import { OutgoingMessage } from '../OutgoingMessage';
3
+ export declare class UpdateMessage extends OutgoingMessage {
4
+ type: MessageType;
5
+ description: string;
6
+ get(args: Partial<OutgoingMessageArguments>): import("lib0/encoding").Encoder;
7
+ }
@@ -0,0 +1,3 @@
1
+ export * from './HocuspocusProvider';
2
+ export * from './types';
3
+ export * from './utils';
@@ -0,0 +1,34 @@
1
+ import { Awareness } from 'y-protocols/awareness';
2
+ import * as Y from 'yjs';
3
+ import { Encoder } from 'lib0/encoding';
4
+ import { AuthenticationMessage } from './OutgoingMessages/AuthenticationMessage';
5
+ import { AwarenessMessage } from './OutgoingMessages/AwarenessMessage';
6
+ import { QueryAwarenessMessage } from './OutgoingMessages/QueryAwarenessMessage';
7
+ import { SyncStepOneMessage } from './OutgoingMessages/SyncStepOneMessage';
8
+ import { SyncStepTwoMessage } from './OutgoingMessages/SyncStepTwoMessage';
9
+ import { UpdateMessage } from './OutgoingMessages/UpdateMessage';
10
+ export declare enum MessageType {
11
+ Sync = 0,
12
+ Awareness = 1,
13
+ Auth = 2,
14
+ QueryAwareness = 3
15
+ }
16
+ export interface OutgoingMessageInterface {
17
+ encoder: Encoder;
18
+ type?: MessageType;
19
+ }
20
+ export interface OutgoingMessageArguments {
21
+ token: string;
22
+ document: Y.Doc;
23
+ awareness: Awareness;
24
+ clients: number[];
25
+ states: Map<number, {
26
+ [key: string]: any;
27
+ }>;
28
+ update: any;
29
+ encoder: Encoder;
30
+ }
31
+ export interface Constructable<T> {
32
+ new (...args: any): T;
33
+ }
34
+ export declare type ConstructableOutgoingMessage = Constructable<AuthenticationMessage> | Constructable<AwarenessMessage> | Constructable<QueryAwarenessMessage> | Constructable<SyncStepOneMessage> | Constructable<SyncStepTwoMessage> | Constructable<UpdateMessage>;
@@ -0,0 +1,4 @@
1
+ declare const _default: (states: Map<number, Record<string, any>>) => {
2
+ clientId: number;
3
+ }[];
4
+ export default _default;
@@ -0,0 +1 @@
1
+ export { default as awarenessStatesToArray } from './awarenessStatesToArray';
@@ -0,0 +1,16 @@
1
+ import { RedisPersistence } from 'y-redis';
2
+ import { Extension, onConnectPayload, onCreateDocumentPayload, onDisconnectPayload } from '@hocuspocus/server';
3
+ export interface Configuration {
4
+ }
5
+ export declare class Redis implements Extension {
6
+ configuration: Configuration;
7
+ cluster: boolean;
8
+ persistence: RedisPersistence | undefined;
9
+ /**
10
+ * Constructor
11
+ */
12
+ constructor(configuration?: Partial<Configuration>);
13
+ onCreateDocument(data: onCreateDocumentPayload): Promise<import("yjs").Doc | undefined>;
14
+ onConnect(data: onConnectPayload): Promise<void>;
15
+ onDisconnect(data: onDisconnectPayload): Promise<void>;
16
+ }
@@ -0,0 +1,4 @@
1
+ import { Redis } from './Redis';
2
+ export declare class RedisCluster extends Redis {
3
+ cluster: boolean;
4
+ }
@@ -0,0 +1,2 @@
1
+ export * from './Redis';
2
+ export * from './RedisCluster';
@@ -0,0 +1,22 @@
1
+ import { Extension, onCreateDocumentPayload } from '@hocuspocus/server';
2
+ import { LeveldbPersistence } from 'y-leveldb';
3
+ export interface Configuration {
4
+ options: object | undefined;
5
+ path: string;
6
+ }
7
+ export declare class RocksDB implements Extension {
8
+ configuration: Configuration;
9
+ provider: LeveldbPersistence;
10
+ /**
11
+ * Constructor
12
+ */
13
+ constructor(configuration?: Partial<Configuration>);
14
+ /**
15
+ * onCreateDocument hook
16
+ */
17
+ onCreateDocument(data: onCreateDocumentPayload): Promise<any>;
18
+ /**
19
+ * store updates in y-leveldb persistence
20
+ */
21
+ store(documentName: string, update: Uint8Array): Promise<any>;
22
+ }
@@ -0,0 +1,4 @@
1
+ import { CloseEvent } from './types';
2
+ export declare const Forbidden: CloseEvent;
3
+ export declare const ResetConnection: CloseEvent;
4
+ export declare const CloseEvents: CloseEvent[];
@@ -0,0 +1,62 @@
1
+ /// <reference types="node" />
2
+ import AsyncLock from 'async-lock';
3
+ import WebSocket from 'ws';
4
+ import { IncomingMessage as HTTPIncomingMessage } from 'http';
5
+ import Document from './Document';
6
+ import { CloseEvent } from './types';
7
+ import { MessageLogger } from './Debugger';
8
+ declare class Connection {
9
+ webSocket: WebSocket;
10
+ context: any;
11
+ document: Document;
12
+ pingInterval: NodeJS.Timeout;
13
+ pongReceived: boolean;
14
+ request: HTTPIncomingMessage;
15
+ timeout: number;
16
+ callbacks: any;
17
+ socketId: string;
18
+ lock: AsyncLock;
19
+ readOnly: Boolean;
20
+ debugger: MessageLogger;
21
+ /**
22
+ * Constructor.
23
+ */
24
+ constructor(connection: WebSocket, request: HTTPIncomingMessage, document: Document, timeout: number, socketId: string, context: any, readOnly?: boolean);
25
+ /**
26
+ * Set a callback that will be triggered when the connection is closed
27
+ */
28
+ onClose(callback: (document: Document) => void): Connection;
29
+ /**
30
+ * Send the given message
31
+ */
32
+ send(message: any): void;
33
+ /**
34
+ * Graceful wrapper around the WebSocket close method.
35
+ */
36
+ close(event?: CloseEvent): void;
37
+ /**
38
+ * Check if pong was received and close the connection otherwise
39
+ * @private
40
+ */
41
+ private check;
42
+ /**
43
+ * Send first sync step
44
+ * @private
45
+ */
46
+ /**
47
+ * Handle an incoming message
48
+ * @private
49
+ */
50
+ private handleMessage;
51
+ /**
52
+ * Get the underlying connection instance
53
+ * @deprecated
54
+ */
55
+ get instance(): WebSocket;
56
+ /**
57
+ * Get the underlying connection instance
58
+ * @deprecated
59
+ */
60
+ get connection(): WebSocket;
61
+ }
62
+ export default Connection;
@@ -0,0 +1,15 @@
1
+ export declare class MessageLogger {
2
+ logs: any[];
3
+ listen: boolean;
4
+ output: boolean;
5
+ enable(): void;
6
+ disable(): void;
7
+ verbose(): void;
8
+ quiet(): void;
9
+ log(message: any): this;
10
+ flush(): this;
11
+ get(): {
12
+ logs: any[];
13
+ };
14
+ }
15
+ export declare const Debugger: MessageLogger;
@@ -0,0 +1,75 @@
1
+ import WebSocket from 'ws';
2
+ import { Awareness } from 'y-protocols/awareness';
3
+ import { Doc } from 'yjs';
4
+ import { mutex } from 'lib0/mutex.js';
5
+ import Connection from './Connection';
6
+ import { MessageLogger } from './Debugger';
7
+ declare class Document extends Doc {
8
+ awareness: Awareness;
9
+ callbacks: {
10
+ onUpdate: (document: Document, connection: Connection, update: Uint8Array) => void;
11
+ };
12
+ connections: Map<any, any>;
13
+ name: string;
14
+ mux: mutex;
15
+ debugger: MessageLogger;
16
+ /**
17
+ * Constructor.
18
+ */
19
+ constructor(name: string);
20
+ /**
21
+ * Check if the Document is empty
22
+ */
23
+ isEmpty(fieldName: string): boolean;
24
+ /**
25
+ * Merge the given document(s) into this one
26
+ */
27
+ merge(documents: Doc | Array<Doc>): Document;
28
+ /**
29
+ * Set a callback that will be triggered when the document is updated
30
+ */
31
+ onUpdate(callback: (document: Document, connection: Connection, update: Uint8Array) => void): Document;
32
+ /**
33
+ * Register a connection and a set of clients on this document keyed by the
34
+ * underlying websocket connection
35
+ */
36
+ addConnection(connection: Connection): Document;
37
+ /**
38
+ * Is the given connection registered on this document
39
+ */
40
+ hasConnection(connection: Connection): boolean;
41
+ /**
42
+ * Remove the given connection from this document
43
+ */
44
+ removeConnection(connection: Connection): Document;
45
+ /**
46
+ * Get the number of active connections for this document
47
+ */
48
+ getConnectionsCount(): number;
49
+ /**
50
+ * Get an array of registered connections
51
+ */
52
+ getConnections(): Array<Connection>;
53
+ /**
54
+ * Get the client ids for the given connection instance
55
+ */
56
+ getClients(connectionInstance: WebSocket): Set<any>;
57
+ /**
58
+ * Has the document awareness states
59
+ */
60
+ hasAwarenessStates(): boolean;
61
+ /**
62
+ * Apply the given awareness update
63
+ */
64
+ applyAwarenessUpdate(connection: Connection, update: Uint8Array): Document;
65
+ /**
66
+ * Handle an awareness update and sync changes to clients
67
+ * @private
68
+ */
69
+ private handleAwarenessUpdate;
70
+ /**
71
+ * Handle an updated document and sync changes to clients
72
+ */
73
+ private handleUpdate;
74
+ }
75
+ export default Document;
@@ -0,0 +1,86 @@
1
+ /// <reference types="node" />
2
+ import WebSocket from 'ws';
3
+ import { IncomingMessage, Server as HTTPServer } from 'http';
4
+ import { Configuration } from './types';
5
+ import { MessageLogger } from './Debugger';
6
+ export declare const defaultConfiguration: {
7
+ port: number;
8
+ timeout: number;
9
+ };
10
+ /**
11
+ * Hocuspocus server
12
+ */
13
+ export declare class Hocuspocus {
14
+ configuration: Configuration;
15
+ documents: Map<any, any>;
16
+ httpServer?: HTTPServer;
17
+ webSocketServer?: WebSocket.Server;
18
+ debugger: MessageLogger;
19
+ /**
20
+ * Configure the server
21
+ */
22
+ configure(configuration: Partial<Configuration>): Hocuspocus;
23
+ get authenticationRequired(): boolean;
24
+ /**
25
+ * Start the server
26
+ */
27
+ listen(): Promise<void>;
28
+ /**
29
+ * Get the total number of active documents
30
+ */
31
+ getDocumentsCount(): number;
32
+ /**
33
+ * Get the total number of active connections
34
+ */
35
+ getConnectionsCount(): number;
36
+ /**
37
+ * Force close one or more connections
38
+ */
39
+ closeConnections(documentName?: string): void;
40
+ /**
41
+ * Destroy the server
42
+ */
43
+ destroy(): Promise<any>;
44
+ /**
45
+ * Handle the incoming WebSocket connection
46
+ */
47
+ handleConnection(incoming: WebSocket, request: IncomingMessage, documentName: string, context?: any): void;
48
+ /**
49
+ * Handle update of the given document
50
+ * @private
51
+ */
52
+ private handleDocumentUpdate;
53
+ /**
54
+ * Create a new document by the given request
55
+ * @private
56
+ */
57
+ private createDocument;
58
+ /**
59
+ * Create a new connection by the given request and document
60
+ * @private
61
+ */
62
+ private createConnection;
63
+ /**
64
+ * Run the given hook on all configured extensions
65
+ * Runs the given callback after each hook
66
+ * @private
67
+ */
68
+ private hooks;
69
+ /**
70
+ * Get parameters by the given request
71
+ * @private
72
+ */
73
+ private static getParameters;
74
+ /**
75
+ * Get document name by the given request
76
+ * @private
77
+ */
78
+ private static getDocumentName;
79
+ enableDebugging(): void;
80
+ enableMessageLogging(): void;
81
+ disableLogging(): void;
82
+ disableDebugging(): void;
83
+ flushMessageLogs(): this;
84
+ getMessageLogs(): any[];
85
+ }
86
+ export declare const Server: Hocuspocus;