rhine-var 0.6.2 → 0.8.3

package/README.md

@@ -96,9 +96,12 @@ Email: [RhineAILab@gmail.com](rhineailab@gmail.com) & [RhineAI@163.com](RhineAI@
 
 ## Install
 ```bash
+npm i rhine-var
+```
+Or using Yarn:
+```bash
 yarn add rhine-var
 ```
-If you don't have `yarn`, you can install it via `npm i rhine-var`, or install `yarn` first using `npm i -g yarn` and then use the command above to install.
 
 <br/>
 
@@ -150,42 +153,50 @@ Note: The returned snapshot is read-only. Please do not perform any operations o
 
 <br/>
 
-## Server
 
 ## Server
 
-We provide a public server on the internet for testing and trying out RHINE-VAR. You can connect to it via `wss://rvp.rhineai.com/<room-id>`.
+We provide a `free public server` for `RHINE-VAR`, which can be used for trial and testing. You can connect to it via [wss://rvp.rhineai.com/<room-id>](wss://rvp.rhineai.com/<room-id>).
 
-Note that this server does not guarantee security or performance and will impose certain restrictions on users and IPs with large-scale usage.
+Note that this server cannot guarantee security and stability and will limit users and IPs in a large-scale manner.
 
 <br/>
 
-We also provide a basic server example that you can deploy yourself. For more details, see: https://github.com/RhineAI-Lab/rhine-var-server
+RHINE-VAR supports custom servers and connection agreements. The server currently fully supports all Yjs and WebSocket servers.
 
-```
-git clone https://github.com/RhineAI-Lab/rhine-var-server.git
-yarn install
-yarn start
-```
-It will run on `Port 6600`, and you can connect to it via `ws://localhost:6600/<room-id>`. `<room-id>` can be any text, with each room ID corresponding to a `RhineVariable`.
+We use Tiptap to set up [Hocuspocus](https://tiptap.dev/docs/hocuspocus/introduction) server.
 
-<br/>
+He has other servers, but it requires a high-quality Yjs WebSocket server. Based on the broadcasting and performance, you can support up to 1 million users' experience.
 
-The server is currently fully compatible with all Yjs WebSocket servers.
+```bash
+npm i @hocuspocus/server @hocuspocus/extension-logger @hocuspocus/extension-sqlite y-protocols yjs
+```
+```typescript
+import { Hocuspocus } from '@hocuspocus/server'
+import { Logger } from '@hocuspocus/extension-logger'
+import { SQLite } from '@hocuspocus/extension-sqlite'
+
+const server = new Hocuspocus({
+  name: 'rhine-var-server',
+  port: 11600,
+  extensions: [
+    new Logger(),
+    new SQLite({database: 'db.sqlite'}),
+  ],
+})
+server.listen()
+```
 
-In the future, more communication protocols will be supported. You can also develop your own `Connector` object to adapt to your custom communication protocol.
+We also provide a more complete [Hocuspocus](https://tiptap.dev/docs/hocuspocus/introduction) server (link below), which supports pre-authorization for connections and the ability to store data in a database.
 
-For more information on server development, refer to: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
+Best Implementation: [https://github.com/RhineAI-Lab/rhine-var-hocuspocus-server](https://github.com/RhineAI-Lab/rhine-var-hocuspocus-server)
 
-When using your own server, disable RhineVar's default handshake verification unless your server supports it.
+<br/>
 
-```typescript
-import {enableRhineVarSyncHandshakeCheck} from 'rhine-var'
+Original server-side development reference: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
 
-enableRhineVarSyncHandshakeCheck(false)
-```
+And we also provide the original Yjs WebSocket server example: [https://github.com/RhineAI-Lab/rhine-var-server](https://github.com/RhineAI-Lab/rhine-var-server)
 
-<br/>
 
 ## Develop
 
@@ -206,7 +217,7 @@ yarn run watch
 # Start the temporary local server, default port is 6600
 yarn run server
 # Start the NextJs environment debugging project, default port is 6700
-yarn run next
+yarn run playground
 # The browser will navigate to http://localhost:6700
 ```
 

package/README_zh.md

@@ -107,10 +107,14 @@ RHINE-VAR 提供完好的Yjs原生对象操作支持，更底层更丰富的API
 <br/>
 
 ## Install
+
+```bash
+npm i rhine-var
+```
+或者使用 Yarn:
 ```bash
 yarn add rhine-var
 ```
-如果你的电脑未安装`yarn`, 也可通过 `npm i rhine-var` 安装。或先用 `npm i -g yarn` 安装`yarn`，然后再用上方命令进行安装。
 
 <br/>
 
@@ -136,7 +140,7 @@ function Counter() {
 
 ### Room ID
 
-一个房间号对应一个状态变量, 加入到一个房间中的用户会参与到多人协同中。支持使用自己的服务端，甚至其他链接协议。
+一个房间号对应一个状态变量（即一个yjs文档）, 加入到一个房间中的用户会参与到多人协同中。支持使用自己的服务端，甚至其他链接协议。
 
 ### Default Value
 
@@ -167,42 +171,50 @@ function Counter() {
 
 ## Server
 
-我们提供了一个位于公网的公共服务器，可以用于试用和测试 RHINE-VAR。你可以通过 `wss://rvp.rhineai.com/<room-id>` 连接它。
+我们提供了一个位于公网的`免费公共服务器`，可以用于试用和测试`RHINE-VAR`。你可以通过 [wss://rvp.rhineai.com/<room-id>](wss://rvp.rhineai.com/<room-id>) 连接它。
 
 注意，该服务器无法保证安全和性能，并会对大规模使用的用户和IP做出一定限制。
 
 <br/>
 
-我们提供了一个基本的服务器例子，您可以自己部署，详情请见: https://github.com/RhineAI-Lab/rhine-var-server 
+RHINE-VAR 支持自定义服务器，以及连接协议。服务端目前完全兼容所有的 Yjs 的 Websocket 服务器。
+
+我们推荐使用由 Tiptap 开源的 [Hocuspocus](https://tiptap.dev/docs/hocuspocus/introduction) 搭建服务器。
 
+他仅需如下几行，就可以构建出一个强大的 Yjs Websocket 服务器。 基于他的插件和高性能，你可以将服务端扩充到100万用户的体量。
+
+```bash
+npm i @hocuspocus/server @hocuspocus/extension-logger @hocuspocus/extension-sqlite y-protocols yjs
 ```
-git clone https://github.com/RhineAI-Lab/rhine-var-server.git
-yarn install
-yarn start
+```typescript
+import { Hocuspocus } from '@hocuspocus/server'
+import { Logger } from '@hocuspocus/extension-logger'
+import { SQLite } from '@hocuspocus/extension-sqlite'
+
+const server = new Hocuspocus({
+  name: 'rhine-var-server',
+  port: 11600,
+  extensions: [
+    new Logger(),
+    new SQLite({database: 'db.sqlite'}),
+  ],
+})
+server.listen()
 ```
+我们还提供了一个更完整的 [Hocuspocus](https://tiptap.dev/docs/hocuspocus/introduction) 服务器 (下方链接)，支持连接前鉴权，以及将数据持久化到数据库中。
 
-默认运行在 `端口 6600`, 你可以通过连接 `ws://localhost:6600/<room-id>` 连接它，`<room-id>` 可以是任意文本，一个房间号对应一个 `RhineVar 对象`。
+Best Implementation: [https://github.com/RhineAI-Lab/rhine-var-hocuspocus-server](https://github.com/RhineAI-Lab/rhine-var-hocuspocus-server)
 
 <br/>
 
-服务端目前完全兼容所有的 Yjs 的 Websocket 服务器。
+原生服务端开发信息请参考: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
 
-将来会支持更多通信协议，现在您也可以自己开发 `Connector` 对象，以适配自己的通信协议。
-
-更多服务端开发信息请参考: [https://docs.yjs.dev/ecosystem/connection-provider/y-websocket](https://docs.yjs.dev/ecosystem/connection-provider/y-websocket)
-
-当你使用自己开发的服务器时，请关闭 RhineVar 默认的二次握手校验连接，除非你的服务器支持了他。
-
-```typescript
-import {enableRhineVarSyncHandshakeCheck} from 'rhine-var'
-
-enableRhineVarSyncHandshakeCheck(false)
-```
+以及我们提供的原生 Yjs  Websocket 服务器的示例: [https://github.com/RhineAI-Lab/rhine-var-server](https://github.com/RhineAI-Lab/rhine-var-server)
 
 <br/>
 
 ## Develop
-
+                                                                                                                                                                                                                                                                               
 欢迎参与 RHINE-VAR 库的共同开发。本库内有基本的服务端，和调试用 NextJS 项目，可以满足大部分开发过程基本需求。
 
 
@@ -223,7 +235,7 @@ yarn run watch
 # 启用临时本地服务端 默认端口6600 
 yarn run server
 # 启动 NextJs 环境调试项目 默认端口6700
-yarn run next
+yarn run playground
 # 浏览器将跳转至 http://localhost:6700
 ```
 

package/dist/config/config.d.ts

@@ -1,5 +1,6 @@
 export default class RhineVarConfig {
     static ENABLE_LOG: boolean;
+    static ENABLE_ERROR: boolean;
     static ENABLE_SYNC_HANDSHAKE_CHECK: boolean;
 }
 export declare function enableRhineVarLog(value: boolean): void;

package/dist/config/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,OAAO,OAAO,cAAc;IAEjC,MAAM,CAAC,UAAU,UAAQ;IACzB,MAAM,CAAC,2BAA2B,UAAO;CAE1C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,QAE/C;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,QAE9D;AAED,wBAAgB,iBAAiB,0BAEhC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config/config.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,OAAO,OAAO,cAAc;IAEjC,MAAM,CAAC,UAAU,UAAQ;IACzB,MAAM,CAAC,YAAY,UAAO;IAC1B,MAAM,CAAC,2BAA2B,UAAQ;CAE3C;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,QAE/C;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,QAE9D;AAED,wBAAgB,iBAAiB,0BAEhC"}

package/dist/config/config.js

@@ -6,7 +6,8 @@ exports.getRhineVarConfig = getRhineVarConfig;
 class RhineVarConfig {
 }
 RhineVarConfig.ENABLE_LOG = false;
-RhineVarConfig.ENABLE_SYNC_HANDSHAKE_CHECK = true;
+RhineVarConfig.ENABLE_ERROR = true;
+RhineVarConfig.ENABLE_SYNC_HANDSHAKE_CHECK = false;
 exports.default = RhineVarConfig;
 function enableRhineVarLog(value) {
     RhineVarConfig.ENABLE_LOG = Boolean(value);

package/dist/core/connector/{ConnectorStatus.d.ts → connector-status.enum.d.ts}

@@ -3,4 +3,4 @@ export declare enum ConnectorStatus {
     CONNECTED = "connected",
     DISCONNECTED = "disconnected"
 }
-//# sourceMappingURL=ConnectorStatus.d.ts.map
+//# sourceMappingURL=connector-status.enum.d.ts.map

package/dist/core/connector/connector-status.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-status.enum.d.ts","sourceRoot":"","sources":["../../../src/core/connector/connector-status.enum.ts"],"names":[],"mappings":"AACA,oBAAY,eAAe;IACzB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,YAAY,iBAAiB;CAC9B"}

package/dist/core/connector/connector.abstract.d.ts

@@ -0,0 +1,27 @@
+import { YMap, YDoc } from "../../index";
+import { ConnectorStatus } from "./connector-status.enum";
+import { Native } from "../native/native.type";
+import { SyncedCallback } from "../event/callback";
+export default abstract class Connector {
+    static STATE_KEY: string;
+    yDoc: YDoc | null;
+    yBaseMap: YMap<any> | null;
+    clientId: number;
+    synced: boolean;
+    status: ConnectorStatus;
+    protected syncedSubscribers: SyncedCallback[];
+    subscribeSynced(callback: SyncedCallback): () => void;
+    unsubscribeSynced(callback: SyncedCallback): void;
+    unsubscribeAllSynced(): void;
+    protected emitSynced(synced: boolean): void;
+    afterSynced(callback: () => void): void;
+    waitSynced(): Promise<void>;
+    constructor(text?: string);
+    hasState(): boolean;
+    getState(): Native;
+    setState(state: Native): void;
+    abstract connect(text: string): Promise<void>;
+    abstract disconnect(): Promise<void>;
+}
+export declare function websocketRhineConnect(url: string): void;
+//# sourceMappingURL=connector.abstract.d.ts.map

package/dist/core/connector/connector.abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector.abstract.d.ts","sourceRoot":"","sources":["../../../src/core/connector/connector.abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,oBAAe;AACpC,OAAO,EAAC,eAAe,EAAC,gCAA+C;AACvE,OAAO,EAAC,MAAM,EAAC,8BAAkC;AACjD,OAAO,EAAC,cAAc,EAAC,0BAA8B;AAErD,MAAM,CAAC,OAAO,CAAC,QAAQ,OAAO,SAAS;IAErC,MAAM,CAAC,SAAS,SAAU;IAE1B,IAAI,EAAE,IAAI,GAAG,IAAI,CAAO;IACxB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAO;IAEjC,QAAQ,SAAK;IACb,MAAM,UAAQ;IAEd,MAAM,EAAE,eAAe,CAA+B;IAGtD,SAAS,CAAC,iBAAiB,EAAE,cAAc,EAAE,CAAK;IAClD,eAAe,CAAC,QAAQ,EAAE,cAAc;IAIxC,iBAAiB,CAAC,QAAQ,EAAE,cAAc;IAG1C,oBAAoB;IAGpB,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO;IAIpC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI;IAahC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;gBAMf,IAAI,GAAE,MAAW;IAG7B,QAAQ,IAAI,OAAO;IAInB,QAAQ,IAAI,MAAM;IAIlB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAItB,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7C,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAErC;AAGD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,QAChD"}

package/dist/core/connector/connector.abstract.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.websocketRhineConnect = websocketRhineConnect;
+const connector_status_enum_1 = require("./connector-status.enum");
+class Connector {
+    subscribeSynced(callback) {
+        this.syncedSubscribers.push(callback);
+        return () => this.unsubscribeSynced(callback);
+    }
+    unsubscribeSynced(callback) {
+        this.syncedSubscribers = this.syncedSubscribers.filter(subscriber => subscriber !== callback);
+    }
+    unsubscribeAllSynced() {
+        this.syncedSubscribers = [];
+    }
+    emitSynced(synced) {
+        this.syncedSubscribers.forEach(subscriber => subscriber(synced));
+    }
+    afterSynced(callback) {
+        if (this.synced) {
+            callback();
+        }
+        else {
+            const subscriber = (synced) => {
+                if (synced) {
+                    this.unsubscribeSynced(subscriber);
+                    callback();
+                }
+            };
+            this.subscribeSynced(subscriber);
+        }
+    }
+    waitSynced() {
+        return new Promise((resolve) => {
+            this.afterSynced(resolve);
+        });
+    }
+    constructor(text = '') {
+        this.yDoc = null;
+        this.yBaseMap = null;
+        this.clientId = -1;
+        this.synced = false;
+        this.status = connector_status_enum_1.ConnectorStatus.DISCONNECTED;
+        this.syncedSubscribers = [];
+    }
+    hasState() {
+        var _a, _b;
+        return (_b = (_a = this.yBaseMap) === null || _a === void 0 ? void 0 : _a.has(Connector.STATE_KEY)) !== null && _b !== void 0 ? _b : false;
+    }
+    getState() {
+        var _a;
+        return (_a = this.yBaseMap) === null || _a === void 0 ? void 0 : _a.get(Connector.STATE_KEY);
+    }
+    setState(state) {
+        var _a;
+        (_a = this.yBaseMap) === null || _a === void 0 ? void 0 : _a.set(Connector.STATE_KEY, state);
+    }
+}
+Connector.STATE_KEY = 'state';
+exports.default = Connector;
+function websocketRhineConnect(url) {
+}

package/dist/core/connector/create-connector.d.ts

@@ -0,0 +1,5 @@
+import HocuspocusConnector from "./hocuspocus/hocuspocus-connector.class";
+export declare const PROTOCOL_LIST: string[];
+export declare const DEFAULT_PUBLIC_URL = "wss://rvp.rhineai.com/";
+export declare function createConnector(connectorText: string | number): HocuspocusConnector;
+//# sourceMappingURL=create-connector.d.ts.map

package/dist/core/connector/create-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-connector.d.ts","sourceRoot":"","sources":["../../../src/core/connector/create-connector.ts"],"names":[],"mappings":"AAAA,OAAO,mBAAmB,gDAA+D;AAGzF,eAAO,MAAM,aAAa,UAAsB,CAAA;AAChD,eAAO,MAAM,kBAAkB,2BAA2B,CAAA;AAE1D,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,uBAkB7D"}

package/dist/core/connector/create-connector.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_PUBLIC_URL = exports.PROTOCOL_LIST = void 0;
+exports.createConnector = createConnector;
+const hocuspocus_connector_class_1 = __importDefault(require("./hocuspocus/hocuspocus-connector.class"));
+exports.PROTOCOL_LIST = ['ws://', "wss://"];
+exports.DEFAULT_PUBLIC_URL = 'wss://rvp.rhineai.com/';
+function createConnector(connectorText) {
+    let text = String(connectorText);
+    // Connector is String but not start with protocol
+    if (exports.PROTOCOL_LIST.every(protocol => !text.startsWith(protocol))) {
+        // Default to use public url
+        text = exports.DEFAULT_PUBLIC_URL + text;
+    }
+    // Use HocuspocusConnector by default
+    const connector = new hocuspocus_connector_class_1.default(text);
+    // const connector = new WebsocketConnector(text)
+    if (typeof window !== 'undefined') {
+        connector.connect(String(text));
+    }
+    return connector;
+}

package/dist/core/connector/hocuspocus/hocuspocus-connector.class.d.ts

@@ -0,0 +1,10 @@
+import Connector from "../connector.abstract";
+import { HocuspocusProvider } from "@hocuspocus/provider";
+export default class HocuspocusConnector extends Connector {
+    url: string;
+    name: string;
+    provider: HocuspocusProvider | null;
+    connect(text: string): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=hocuspocus-connector.class.d.ts.map

package/dist/core/connector/hocuspocus/hocuspocus-connector.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hocuspocus-connector.class.d.ts","sourceRoot":"","sources":["../../../../src/core/connector/hocuspocus/hocuspocus-connector.class.ts"],"names":[],"mappings":"AAQA,OAAO,SAAS,8BAA4C;AAC5D,OAAO,EAAC,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAExD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,SAAS;IAExD,GAAG,EAAE,MAAM,CAAK;IAChB,IAAI,EAAE,MAAM,CAAK;IAEjB,QAAQ,EAAE,kBAAkB,GAAG,IAAI,CAAO;IAEpC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDpC,UAAU;CAYjB"}

package/dist/core/connector/hocuspocus/hocuspocus-connector.class.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../../../index");
+const connector_status_enum_1 = require("../connector-status.enum");
+const logger_1 = require("../../../utils/logger");
+const config_1 = __importDefault(require("../../../config/config"));
+const sync_handshake_check_class_1 = __importDefault(require("../websocket/sync-handshake-check.class"));
+const connector_abstract_1 = __importDefault(require("../connector.abstract"));
+const provider_1 = require("@hocuspocus/provider");
+class HocuspocusConnector extends connector_abstract_1.default {
+    constructor() {
+        super(...arguments);
+        this.url = '';
+        this.name = '';
+        this.provider = null;
+    }
+    async connect(text) {
+        let li = text.lastIndexOf('/');
+        if (li == -1 || li == text.length - 1 || !text.startsWith('ws')) {
+            (0, logger_1.error)('HocuspocusConnector: UnSupport URL to connect room');
+            return;
+        }
+        this.name = text.substring(li + 1);
+        this.url = text.substring(0, li);
+        this.yDoc = new index_1.YDoc();
+        this.yBaseMap = this.yDoc.getMap();
+        return new Promise((resolve, reject) => {
+            this.provider = new provider_1.HocuspocusProvider({
+                url: this.url,
+                name: this.name,
+                document: this.yDoc,
+            });
+            this.provider.on('status', (event) => {
+                this.status = event.status;
+                (0, logger_1.log)('HocuspocusProvider.event status:', event.status);
+            });
+            this.provider.on('sync', async (synced) => {
+                (0, logger_1.log)('HocuspocusProvider.event sync:', synced);
+                if (synced) {
+                    if (config_1.default.ENABLE_SYNC_HANDSHAKE_CHECK) {
+                        await sync_handshake_check_class_1.default.wait(this.yBaseMap);
+                    }
+                    (0, logger_1.log)('HocuspocusProvider.event base map:', this.yBaseMap.toJSON());
+                    this.synced = true;
+                    this.clientId = this.yDoc.clientID;
+                    this.emitSynced(synced);
+                    resolve();
+                }
+                else {
+                    (0, logger_1.log)('HocuspocusProvider.event sync:', false);
+                }
+            });
+            this.provider.on('connection-close', (e) => {
+                this.status = connector_status_enum_1.ConnectorStatus.DISCONNECTED;
+                (0, logger_1.log)('HocuspocusProvider.event connection-close:', e);
+            });
+            this.provider.on('connection-error', (error) => {
+                this.status = connector_status_enum_1.ConnectorStatus.DISCONNECTED;
+                (0, logger_1.log)('HocuspocusProvider.event connection-error:', error);
+            });
+        });
+    }
+    async disconnect() {
+        throw new Error('Disconnecting and switching connections are not supported at the moment.');
+        /*
+        if (this.provider) {
+          this.provider.disconnect()
+        }
+        this.provider = null
+        this.synced = false
+        this.websocketStatus = ConnectorStatus.DISCONNECTED
+        */
+    }
+}
+exports.default = HocuspocusConnector;

package/dist/core/connector/{SyncHandshakeCheck.d.ts → websocket/sync-handshake-check.class.d.ts}

@@ -1,5 +1,5 @@
-import { Map as YMap } from "yjs";
+import { YMap } from "../../../index";
 export default class SyncHandshakeCheck {
     static wait(baseMap: YMap<any>): Promise<void>;
 }
-//# sourceMappingURL=SyncHandshakeCheck.d.ts.map
+//# sourceMappingURL=sync-handshake-check.class.d.ts.map

package/dist/core/connector/websocket/sync-handshake-check.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-handshake-check.class.d.ts","sourceRoot":"","sources":["../../../../src/core/connector/websocket/sync-handshake-check.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,uBAAe;AAG9B,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAErC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC;CAkC/B"}

package/dist/core/connector/{SyncHandshakeCheck.js → websocket/sync-handshake-check.class.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const logger_1 = require("../../utils/logger");
+const logger_1 = require("../../../utils/logger");
 class SyncHandshakeCheck {
     static wait(baseMap) {
         return new Promise((resolve) => {
@@ -10,11 +10,9 @@ class SyncHandshakeCheck {
                 (0, logger_1.log)('Sync handshake start', syncMap.toJSON());
                 setTimeout(() => {
                     const syncObserver = () => {
-                        var _a;
                         if (syncMap.get('role') === 'server') {
                             (0, logger_1.log)('Sync handshake successfully', syncMap.toJSON());
                             syncMap.unobserve(syncObserver);
-                            (0, logger_1.log)('Sync State:', (_a = baseMap.get('state')) === null || _a === void 0 ? void 0 : _a.toJSON());
                             resolve();
                         }
                     };
@@ -28,7 +26,6 @@ class SyncHandshakeCheck {
             else {
                 (0, logger_1.log)('Sync handshake waiting...');
                 const mapObserver = () => {
-                    console.log(baseMap.toJSON());
                     if (baseMap.has('sync')) {
                         baseMap.unobserve(mapObserver);
                         waitSync(baseMap.get('sync'));

package/dist/core/connector/websocket/websocket-connector.class.d.ts

@@ -0,0 +1,10 @@
+import { WebsocketProvider } from "y-websocket";
+import Connector from "../connector.abstract";
+export default class WebsocketConnector extends Connector {
+    name: string;
+    url: string;
+    provider: WebsocketProvider | null;
+    connect(text: string): Promise<void>;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=websocket-connector.class.d.ts.map

package/dist/core/connector/websocket/websocket-connector.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-connector.class.d.ts","sourceRoot":"","sources":["../../../../src/core/connector/websocket/websocket-connector.class.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAK9C,OAAO,SAAS,8BAA4C;AAE5D,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,SAAS;IAEvD,IAAI,EAAE,MAAM,CAAK;IACjB,GAAG,EAAE,MAAM,CAAK;IAEhB,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAO;IAEnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDpC,UAAU;CAYjB"}

package/dist/core/connector/websocket/websocket-connector.class.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("../../../index");
+const y_websocket_1 = require("y-websocket");
+const connector_status_enum_1 = require("../connector-status.enum");
+const logger_1 = require("../../../utils/logger");
+const config_1 = __importDefault(require("../../../config/config"));
+const sync_handshake_check_class_1 = __importDefault(require("./sync-handshake-check.class"));
+const connector_abstract_1 = __importDefault(require("../connector.abstract"));
+class WebsocketConnector extends connector_abstract_1.default {
+    constructor() {
+        super(...arguments);
+        this.name = '';
+        this.url = '';
+        this.provider = null;
+    }
+    async connect(text) {
+        let li = this.url.lastIndexOf('/');
+        if (li == -1 || li == this.url.length - 1 || !this.url.startsWith('ws')) {
+            (0, logger_1.error)('WebsocketConnector: UnSupport URL to connect room');
+            return;
+        }
+        this.name = text.substring(li + 1);
+        this.url = text.substring(0, li);
+        this.yDoc = new index_1.YDoc();
+        this.yBaseMap = this.yDoc.getMap();
+        return new Promise((resolve, reject) => {
+            this.provider = new y_websocket_1.WebsocketProvider(this.url, this.name, this.yDoc);
+            this.provider.shouldConnect = true;
+            this.provider.on('status', (event) => {
+                this.status = event.status;
+                (0, logger_1.log)('WebsocketConnector.event status:', event.status);
+            });
+            this.provider.on('sync', async (synced) => {
+                if (synced) {
+                    if (config_1.default.ENABLE_SYNC_HANDSHAKE_CHECK) {
+                        await sync_handshake_check_class_1.default.wait(this.yBaseMap);
+                    }
+                    (0, logger_1.log)('WebsocketConnector.event sync:', this.yBaseMap.toJSON());
+                    this.synced = true;
+                    this.clientId = this.yDoc.clientID;
+                    this.emitSynced(synced);
+                    resolve();
+                }
+                else {
+                    (0, logger_1.log)('WebsocketConnector.event sync:', false);
+                }
+            });
+            this.provider.on('connection-close', (e) => {
+                this.status = connector_status_enum_1.ConnectorStatus.DISCONNECTED;
+                (0, logger_1.log)('WebsocketConnector.event connection-close:', e);
+            });
+            this.provider.on('connection-error', (error) => {
+                this.status = connector_status_enum_1.ConnectorStatus.DISCONNECTED;
+                (0, logger_1.log)('WebsocketConnector.event connection-error:', error);
+            });
+        });
+    }
+    async disconnect() {
+        throw new Error('Disconnecting and switching connections are not supported at the moment.');
+        /*
+        if (this.provider) {
+          this.provider.disconnect()
+        }
+        this.provider = null
+        this.synced = false
+        this.websocketStatus = ConnectorStatus.DISCONNECTED
+        */
+    }
+}
+exports.default = WebsocketConnector;

package/dist/core/event/callback.d.ts

@@ -0,0 +1,8 @@
+import { ChangeType } from "./change-type.enum";
+import { Transaction, YArrayEvent, YMapEvent, YTextEvent } from "yjs";
+import { YPath } from "../native/native.type";
+import { ProxiedRhineVar } from "../var/rhine-var.type";
+export type Callback<T> = (key: keyof T, value: T[keyof T] extends object ? T[keyof T] | ProxiedRhineVar<T[keyof T]> : T[keyof T], oldValue: T[keyof T], type: ChangeType, nativeEvent: YMapEvent<any> | YArrayEvent<any> | YTextEvent, nativeTransaction: Transaction) => void;
+export type DeepCallback<T> = (path: YPath, value: any | ProxiedRhineVar<any>, oldValue: any, type: ChangeType, nativeEvent: YMapEvent<any> | YArrayEvent<any> | YTextEvent, nativeTransaction: Transaction) => void;
+export type SyncedCallback = (synced: boolean) => void;
+//# sourceMappingURL=callback.d.ts.map

package/dist/core/event/callback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.d.ts","sourceRoot":"","sources":["../../../src/core/event/callback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,2BAAsC;AACzD,OAAO,EAAgB,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAC,MAAM,KAAK,CAAC;AACnF,OAAO,EAAC,KAAK,EAAC,8BAAkC;AAChD,OAAO,EAAC,eAAe,EAAC,8BAAkC;AAG1D,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CACxB,GAAG,EAAE,MAAM,CAAC,EACZ,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,EACxF,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EACpB,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,EAC3D,iBAAiB,EAAE,WAAW,KAC3B,IAAI,CAAA;AAET,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAC5B,IAAI,EAAE,KAAK,EACX,KAAK,EAAE,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,EACjC,QAAQ,EAAE,GAAG,EACb,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,SAAS,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,EAC3D,iBAAiB,EAAE,WAAW,KAC3B,IAAI,CAAA;AAET,MAAM,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAA"}

package/dist/core/event/{ChangeType.d.ts → change-type.enum.d.ts}

@@ -4,4 +4,4 @@ export declare enum ChangeType {
     Delete = "delete",// For YMap / YArray
     Sync = "sync"
 }
-//# sourceMappingURL=ChangeType.d.ts.map
+//# sourceMappingURL=change-type.enum.d.ts.map

package/dist/core/event/change-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-type.enum.d.ts","sourceRoot":"","sources":["../../../src/core/event/change-type.enum.ts"],"names":[],"mappings":"AACA,oBAAY,UAAU;IACpB,GAAG,QAAQ,CAAG,oBAAoB;IAClC,MAAM,WAAW,CAAG,WAAW;IAC/B,MAAM,WAAW,CAAG,oBAAoB;IACxC,IAAI,SAAS;CACd"}

package/dist/core/native/native-type.enum.d.ts

@@ -0,0 +1,10 @@
+export declare enum NativeType {
+    Object = "object",
+    Map = "map",
+    Array = "array",
+    Text = "text",
+    XmlFragment = "xml-fragment",
+    XmlElement = "xml-element",
+    XmlText = "xml-text"
+}
+//# sourceMappingURL=native-type.enum.d.ts.map

package/dist/core/native/native-type.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-type.enum.d.ts","sourceRoot":"","sources":["../../../src/core/native/native-type.enum.ts"],"names":[],"mappings":"AACA,oBAAY,UAAU;IACpB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,KAAK,UAAU;IACf,IAAI,SAAS;IACb,WAAW,iBAAiB;IAC5B,UAAU,gBAAgB;IAC1B,OAAO,aAAa;CACrB"}