@hocuspocus/extension-throttle 1.0.0-alpha.9 → 1.0.0-beta.2

package/dist/packages/server/src/index.d.ts

@@ -1,2 +1,8 @@
+export * from './Connection';
+export * from './Debugger';
+export * from './Document';
 export * from './Hocuspocus';
+export * from './IncomingMessage';
+export * from './MessageReceiver';
+export * from './OutgoingMessage';
 export * from './types';

package/dist/packages/server/src/types.d.ts

@@ -1,70 +1,223 @@
 /// <reference types="node" />
 import { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'http';
 import { URLSearchParams } from 'url';
-import { Socket } from 'net';
+import { Awareness } from 'y-protocols/awareness';
 import Document from './Document';
-export declare enum MessageTypes {
+import { Hocuspocus } from './Hocuspocus';
+export declare enum MessageType {
+    Unknown = -1,
     Sync = 0,
-    Awareness = 1
-}
-export declare enum WsReadyStates {
-    Closing = 2,
-    Closed = 3
+    Awareness = 1,
+    Auth = 2,
+    QueryAwareness = 3,
+    SyncReply = 4
 }
 export interface AwarenessUpdate {
     added: Array<any>;
     updated: Array<any>;
     removed: Array<any>;
 }
+export interface ConnectionConfiguration {
+    readOnly: boolean;
+    requiresAuthentication: boolean;
+    isAuthenticated: boolean;
+}
 export interface Extension {
-    onChange(data: onChangePayload): Promise<any>;
-    onConnect(data: onConnectPayload): Promise<any>;
-    onConfigure(data: onConfigurePayload): Promise<any>;
-    onCreateDocument(data: onCreateDocumentPayload): Promise<any>;
-    onDestroy(data: onDestroyPayload): Promise<any>;
-    onDisconnect(data: onDisconnectPayload): Promise<any>;
-    onListen(data: onListenPayload): Promise<any>;
-    onRequest(data: onRequestPayload): Promise<any>;
-    onUpgrade(data: onUpgradePayload): Promise<any>;
+    priority?: number;
+    onConfigure?(data: onConfigurePayload): Promise<any>;
+    onListen?(data: onListenPayload): Promise<any>;
+    onUpgrade?(data: onUpgradePayload): Promise<any>;
+    onConnect?(data: onConnectPayload): Promise<any>;
+    connected?(data: connectedPayload): Promise<any>;
+    onAuthenticate?(data: onAuthenticatePayload): Promise<any>;
+    /**
+     * @deprecated onCreateDocument is deprecated, use onLoadDocument instead
+     */
+    onCreateDocument?(data: onLoadDocumentPayload): Promise<any>;
+    onLoadDocument?(data: onLoadDocumentPayload): Promise<any>;
+    afterLoadDocument?(data: onLoadDocumentPayload): Promise<any>;
+    beforeHandleMessage?(data: beforeHandleMessagePayload): Promise<any>;
+    onChange?(data: onChangePayload): Promise<any>;
+    onStoreDocument?(data: onStoreDocumentPayload): Promise<any>;
+    afterStoreDocument?(data: afterStoreDocumentPayload): Promise<any>;
+    onAwarenessUpdate?(data: onAwarenessUpdatePayload): Promise<any>;
+    onRequest?(data: onRequestPayload): Promise<any>;
+    onDisconnect?(data: onDisconnectPayload): Promise<any>;
+    onDestroy?(data: onDestroyPayload): Promise<any>;
 }
+export declare type HookName = 'onConfigure' | 'onListen' | 'onUpgrade' | 'onConnect' | 'connected' | 'onAuthenticate' | 
+/**
+ * @deprecated onCreateDocument is deprecated, use onLoadDocument instead
+ */
+'onCreateDocument' | 'onLoadDocument' | 'afterLoadDocument' | 'beforeHandleMessage' | 'onChange' | 'onStoreDocument' | 'afterStoreDocument' | 'onAwarenessUpdate' | 'onRequest' | 'onDisconnect' | 'onDestroy';
+export declare type HookPayload = onConfigurePayload | onListenPayload | onUpgradePayload | onConnectPayload | connectedPayload | onAuthenticatePayload | onLoadDocumentPayload | onChangePayload | onStoreDocumentPayload | afterStoreDocumentPayload | onAwarenessUpdatePayload | onRequestPayload | onDisconnectPayload | onDestroyPayload;
 export interface Configuration extends Extension {
+    /**
+     * A name for the instance, used for logging.
+     */
+    name: string | null;
+    /**
+     * A list of hocuspocus extenions.
+     */
     extensions: Array<Extension>;
+    /**
+     * The port which the server listens on.
+     */
     port: number | null;
+    /**
+     * Defines in which interval the server sends a ping, and closes the connection when no pong is sent back.
+     */
     timeout: number;
+    /**
+     * Debounces the call of the `onStoreDocument` hook for the given amount of time in ms.
+     * Otherwise every single update would be persisted.
+     */
+    debounce: number;
+    /**
+     * Makes sure to call `onStoreDocument` at least in the given amount of time (ms).
+     */
+    maxDebounce: number;
+    /**
+     * By default, the servers show a start screen. If passed false, the server will start quietly.
+     */
+    quiet: boolean;
+    /**
+     * options to pass to the ydoc document
+     */
+    yDocOptions: {
+        gc: boolean;
+        gcFilter: () => boolean;
+    };
+    /**
+     * Function which returns the (customized) document name based on the request
+     */
+    getDocumentName?(data: getDocumentNamePayload): string | Promise<string>;
+}
+export interface getDocumentNamePayload {
+    documentName: string;
+    request: IncomingMessage;
+    requestParameters: URLSearchParams;
+}
+export interface onAuthenticatePayload {
+    documentName: string;
+    instance: Hocuspocus;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    socketId: string;
+    token: string;
+    connection: ConnectionConfiguration;
 }
 export interface onConnectPayload {
     documentName: string;
+    instance: Hocuspocus;
     request: IncomingMessage;
     requestHeaders: IncomingHttpHeaders;
     requestParameters: URLSearchParams;
     socketId: string;
-    connection: {
-        readOnly: boolean;
-    };
+    connection: ConnectionConfiguration;
+}
+export interface connectedPayload {
+    documentName: string;
+    instance: Hocuspocus;
+    request: IncomingMessage;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    socketId: string;
+    connection: ConnectionConfiguration;
+}
+export interface onLoadDocumentPayload {
+    context: any;
+    document: Document;
+    documentName: string;
+    instance: Hocuspocus;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    socketId: string;
+    connection: ConnectionConfiguration;
 }
-export interface onCreateDocumentPayload {
+export interface afterLoadDocumentPayload {
     context: any;
     document: Document;
     documentName: string;
+    instance: Hocuspocus;
     requestHeaders: IncomingHttpHeaders;
     requestParameters: URLSearchParams;
     socketId: string;
+    connection: ConnectionConfiguration;
 }
 export interface onChangePayload {
     clientsCount: number;
     context: any;
     document: Document;
     documentName: string;
+    instance: Hocuspocus;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    update: Uint8Array;
+    socketId: string;
+}
+export interface beforeHandleMessagePayload {
+    clientsCount: number;
+    context: any;
+    document: Document;
+    documentName: string;
+    instance: Hocuspocus;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    update: Uint8Array;
+    socketId: string;
+}
+export interface onStoreDocumentPayload {
+    clientsCount: number;
+    context: any;
+    document: Document;
+    documentName: string;
+    instance: Hocuspocus;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    socketId: string;
+}
+export interface afterStoreDocumentPayload extends onStoreDocumentPayload {
+}
+export interface onAwarenessUpdatePayload {
+    clientsCount: number;
+    context: any;
+    document: Document;
+    documentName: string;
+    instance: Hocuspocus;
     requestHeaders: IncomingHttpHeaders;
     requestParameters: URLSearchParams;
     update: Uint8Array;
     socketId: string;
+    added: number[];
+    updated: number[];
+    removed: number[];
+    awareness: Awareness;
+    states: StatesArray;
+}
+export declare type StatesArray = {
+    clientId: number;
+    [key: string | number]: any;
+}[];
+export interface fetchPayload {
+    context: any;
+    document: Document;
+    documentName: string;
+    instance: Hocuspocus;
+    requestHeaders: IncomingHttpHeaders;
+    requestParameters: URLSearchParams;
+    socketId: string;
+    connection: ConnectionConfiguration;
+}
+export interface storePayload extends onStoreDocumentPayload {
+    state: Buffer;
 }
 export interface onDisconnectPayload {
     clientsCount: number;
     context: any;
     document: Document;
     documentName: string;
+    instance: Hocuspocus;
     requestHeaders: IncomingHttpHeaders;
     requestParameters: URLSearchParams;
     socketId: string;
@@ -72,19 +225,24 @@ export interface onDisconnectPayload {
 export interface onRequestPayload {
     request: IncomingMessage;
     response: ServerResponse;
+    instance: Hocuspocus;
 }
 export interface onUpgradePayload {
-    head: any;
     request: IncomingMessage;
-    socket: Socket;
+    socket: any;
+    head: any;
+    instance: Hocuspocus;
 }
 export interface onListenPayload {
+    instance: Hocuspocus;
+    configuration: Configuration;
     port: number;
 }
 export interface onDestroyPayload {
+    instance: Hocuspocus;
 }
 export interface onConfigurePayload {
+    instance: Hocuspocus;
     configuration: Configuration;
     version: string;
-    yjsVersion: string;
 }

package/dist/playground/backend/src/redis.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/playground/backend/src/slow.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/playground/backend/src/webhook.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-database/fetch.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-logger/onListen.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-redis/closeConnections.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-redis/getConnectionCount.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-redis/getDocumentsCount.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-redis/onAwarenessChange.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-redis/onChange.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-redis/onStoreDocument.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/extension-throttle/configuration.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/configuration.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/observe.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/observeDeep.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onAuthenticated.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onAuthenticationFailed.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onAwarenessChange.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onAwarenessUpdate.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onClose.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onConnect.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onDisconnect.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onMessage.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onOpen.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/provider/onSynced.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/address.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/afterStoreDocument.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/beforeHandleMessage.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/closeConnections.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/getConnectionsCount.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/getDocumentName.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/getDocumentsCount.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/getMessageLogs.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/listen.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onAuthenticate.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onAwarenessUpdate.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onChange.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onConfigure.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onConnect.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onDestroy.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onDisconnect.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onListen.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onLoadDocument.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onRequest.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onStoreDocument.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/onUpgrade.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/requiresAuthentication.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/server/websocketError.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/transformer/TiptapTransformer.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/utils/createDirectory.d.ts

@@ -0,0 +1 @@
+export declare const createDirectory: (dir: string) => void;

package/dist/tests/utils/flushRedis.d.ts

@@ -0,0 +1 @@
+export declare const flushRedis: () => Promise<string>;

package/dist/tests/utils/index.d.ts

@@ -0,0 +1,8 @@
+export * from './createDirectory';
+export * from './flushRedis';
+export * from './newHocuspocus';
+export * from './newHocuspocusProvider';
+export * from './randomInteger';
+export * from './redisConnectionSettings';
+export * from './removeDirectory';
+export * from './sleep';

package/dist/tests/utils/newHocuspocus.d.ts

@@ -0,0 +1,2 @@
+import { Hocuspocus, Configuration } from '@hocuspocus/server';
+export declare const newHocuspocus: (options?: Partial<Configuration> | undefined) => Hocuspocus;

package/dist/tests/utils/newHocuspocusProvider.d.ts

@@ -0,0 +1,3 @@
+import { HocuspocusProvider, HocuspocusProviderConfiguration } from '@hocuspocus/provider';
+import { Hocuspocus } from '@hocuspocus/server';
+export declare const newHocuspocusProvider: (server: Hocuspocus, options?: Partial<Omit<HocuspocusProviderConfiguration, 'url'>>) => HocuspocusProvider;

package/dist/tests/utils/randomInteger.d.ts

@@ -0,0 +1 @@
+export declare const randomInteger: (min: number, max: number) => number;

package/dist/tests/utils/redisConnectionSettings.d.ts

@@ -0,0 +1,4 @@
+export declare const redisConnectionSettings: {
+    host: string;
+    port: number;
+};

package/dist/tests/utils/removeDirectory.d.ts

@@ -0,0 +1 @@
+export declare const removeDirectory: (dir: string) => void;

package/dist/tests/utils/retryableAssertion.d.ts

@@ -0,0 +1,2 @@
+import { ExecutionContext } from 'ava';
+export declare const retryableAssertion: (t: ExecutionContext, recoverableTry: (tt: ExecutionContext) => void) => Promise<void>;

package/dist/tests/utils/sleep.d.ts

@@ -0,0 +1 @@
+export declare const sleep: (time: number) => Promise<unknown>;

package/package.json

@@ -1,28 +1,33 @@
 {
   "name": "@hocuspocus/extension-throttle",
-  "version": "1.0.0-alpha.9",
+  "version": "1.0.0-beta.2",
   "description": "hocuspocus throttle extension",
   "homepage": "https://hocuspocus.dev",
   "keywords": [
     "hocuspocus",
-    "tiptap",
     "throttle",
     "yjs"
   ],
+  "license": "MIT",
   "type": "module",
-  "main": "dist/hocuspocus-throttle.esm.js",
+  "main": "dist/hocuspocus-throttle.cjs",
   "module": "dist/hocuspocus-throttle.esm.js",
-  "types": "dist/packages/throttle/src/index.d.ts",
+  "types": "dist/packages/extension-throttle/src/index.d.ts",
   "exports": {
-    "import": "./dist/hocuspocus-throttle.esm.js",
-    "require": "./dist/hocuspocus-throttle.js"
+    "source": {
+      "import": "./src"
+    },
+    "default": {
+      "import": "./dist/hocuspocus-throttle.esm.js",
+      "require": "./dist/hocuspocus-throttle.cjs"
+    }
   },
   "files": [
     "src",
     "dist"
   ],
   "dependencies": {
-    "@hocuspocus/server": "^1.0.0-alpha.52"
+    "@hocuspocus/server": "^1.0.0-beta.2"
   },
-  "gitHead": "adc1bacce508102d08fcbe412931192f7ccd1956"
+  "gitHead": "b3454a4ca289a84ddfb7fa5607a2d4b8d5c37e9d"
 }

package/src/index.ts

@@ -1,24 +1,16 @@
 import {
   Extension,
-  onChangePayload,
-  onConfigurePayload,
   onConnectPayload,
-  onCreateDocumentPayload,
-  onDestroyPayload,
-  onDisconnectPayload,
-  onListenPayload,
-  onRequestPayload,
-  onUpgradePayload,
 } from '@hocuspocus/server'
 
-export interface Configuration {
+export interface ThrottleConfiguration {
   throttle: number | null | false,
   banTime: number,
 }
 
 export class Throttle implements Extension {
 
-  configuration: Configuration = {
+  configuration: ThrottleConfiguration = {
     throttle: 15,
     banTime: 5,
   }
@@ -27,6 +19,16 @@ export class Throttle implements Extension {
 
   bannedIps: Map<string, number> = new Map()
 
+  /**
+   * Constructor
+   */
+  constructor(configuration?: Partial<ThrottleConfiguration>) {
+    this.configuration = {
+      ...this.configuration,
+      ...configuration,
+    }
+  }
+
   /**
    * Throttle requests
    * @private
@@ -79,27 +81,4 @@ export class Throttle implements Extension {
     return this.throttle(<string> ip) ? Promise.reject() : Promise.resolve()
   }
 
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onCreateDocument(data: onCreateDocumentPayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onChange(data: onChangePayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onDisconnect(data: onDisconnectPayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onUpgrade(data: onUpgradePayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onRequest(data: onRequestPayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onListen(data: onListenPayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onDestroy(data: onDestroyPayload) {}
-
-  // eslint-disable-next-line no-empty-function,@typescript-eslint/no-empty-function
-  async onConfigure(data: onConfigurePayload) {}
 }