@univerjs/rpc 1.0.0-insiders.20260809-70eefdd → 1.0.0-rc.0

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/README.md

@@ -27,9 +27,13 @@ Keep all `@univerjs/*` packages on the same version.
 ```ts
 import { UniverRPCMainThreadPlugin } from '@univerjs/rpc';
 
-univer.registerPlugin(UniverRPCMainThreadPlugin);
+const worker = new Worker(new URL('./worker.js', import.meta.url), { type: 'module' });
+univer.registerPlugin(UniverRPCMainThreadPlugin, { workerURL: worker });
+univer.onDispose(() => worker.terminate());
 ```
 
+The referenced worker module must create its own Univer instance and register `UniverRPCWorkerThreadPlugin`; see the [browser worker example](../../examples/src/sheets-mobile/worker.ts).
+
 Exported plugin classes:
 
 - `UniverRPCMainThreadPlugin`
@@ -40,4 +44,3 @@ Exported plugin classes:
 - [Documentation](https://docs.univer.ai)
 - [NPM package](https://npmjs.com/package/@univerjs/rpc)
 - [GitHub repository](https://github.com/dream-num/univer)
-

package/lib/cjs/index.js

@@ -75,13 +75,15 @@ const RemoteInstanceServiceName = "univer.remote-instance-service";
 */
 const IRemoteInstanceService = (0, _univerjs_core.createIdentifier)(RemoteInstanceServiceName);
 let WebWorkerRemoteInstanceService = class WebWorkerRemoteInstanceService {
-	constructor(_univerInstanceService, _commandService, _logService) {
+	constructor(_univerInstanceService, _commandService, _logService, _lifecycleService) {
 		this._univerInstanceService = _univerInstanceService;
 		this._commandService = _commandService;
 		this._logService = _logService;
+		this._lifecycleService = _lifecycleService;
 	}
 	whenReady() {
-		return Promise.resolve(true);
+		if (this._lifecycleService.stage >= _univerjs_core.LifecycleStages.Ready) return Promise.resolve(true);
+		return this._lifecycleService.onStage(_univerjs_core.LifecycleStages.Ready).then(() => true);
 	}
 	async syncMutation(params, options) {
 		return this._applyMutation(params.mutationInfo, options);
@@ -121,7 +123,8 @@ let WebWorkerRemoteInstanceService = class WebWorkerRemoteInstanceService {
 WebWorkerRemoteInstanceService = __decorate([
 	__decorateParam(0, _univerjs_core.IUniverInstanceService),
 	__decorateParam(1, _univerjs_core.ICommandService),
-	__decorateParam(2, _univerjs_core.ILogService)
+	__decorateParam(2, _univerjs_core.ILogService),
+	__decorateParam(3, (0, _univerjs_core.Inject)(_univerjs_core.LifecycleService))
 ], WebWorkerRemoteInstanceService);
 
 //#endregion
@@ -234,7 +237,12 @@ var ChannelClient = class extends _univerjs_core.RxDisposable {
 		this._protocol.onMessage.pipe((0, rxjs_operators.takeUntil)(this.dispose$)).subscribe((message) => this._onMessage(message));
 	}
 	dispose() {
+		if (this._disposed) return;
+		const error = /* @__PURE__ */ new Error("[ChannelClient]: client is disposed!");
+		this._initialized.error(error);
+		for (const responseHandler of this._pendingRequests.values()) responseHandler.dispose(error);
 		this._pendingRequests.clear();
+		super.dispose();
 	}
 	getChannel(channelName) {
 		return {
@@ -266,19 +274,24 @@ var ChannelClient = class extends _univerjs_core.RxDisposable {
 		};
 		const pendingRequests = this._pendingRequests;
 		return new Promise((resolve, reject) => {
-			this._pendingRequests.set(sequence, { handle(response) {
-				switch (response.type) {
-					case 201:
-						pendingRequests.delete(sequence);
-						resolve(response.data);
-						break;
-					case 202:
-						pendingRequests.delete(sequence);
-						reject(response.data);
-						break;
-					default: throw new Error("[ChannelClient]: unknown response type!");
+			this._pendingRequests.set(sequence, {
+				handle(response) {
+					switch (response.type) {
+						case 201:
+							pendingRequests.delete(sequence);
+							resolve(response.data);
+							break;
+						case 202:
+							pendingRequests.delete(sequence);
+							reject(response.data);
+							break;
+						default: throw new Error("[ChannelClient]: unknown response type!");
+					}
+				},
+				dispose(error) {
+					reject(error);
 				}
-			} });
+			});
 			this._sendRequest(request);
 		});
 	}
@@ -294,20 +307,25 @@ var ChannelClient = class extends _univerjs_core.RxDisposable {
 					method,
 					args
 				};
-				this._pendingRequests.set(sequence, { handle(response) {
-					switch (response.type) {
-						case 300:
-							subscriber.next(response.data);
-							break;
-						case 301:
-							subscriber.error(response.data);
-							break;
-						case 302:
-							subscriber.complete();
-							break;
-						default: throw new Error("[ChannelClient]: unknown response type!");
+				this._pendingRequests.set(sequence, {
+					handle(response) {
+						switch (response.type) {
+							case 300:
+								subscriber.next(response.data);
+								break;
+							case 301:
+								subscriber.error(response.data);
+								break;
+							case 302:
+								subscriber.complete();
+								break;
+							default: throw new Error("[ChannelClient]: unknown response type!");
+						}
+					},
+					dispose(error) {
+						subscriber.error(error);
 					}
-				} });
+				});
 				this._sendRequest(request);
 			};
 			if (this._initialized.getValue()) doSubscribe();
@@ -358,6 +376,7 @@ var ChannelServer = class extends _univerjs_core.RxDisposable {
 	}
 	dispose() {
 		super.dispose();
+		for (const subscription of this._subscriptions.values()) subscription.unsubscribe();
 		this._subscriptions.clear();
 		this._channels.clear();
 	}
@@ -512,6 +531,7 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends _univerj
 		_defineProperty(this, "_syncingUnits", /* @__PURE__ */ new Set());
 		_defineProperty(this, "_syncingMutations", /* @__PURE__ */ new Set());
 		_defineProperty(this, "_syncMutationQueue", Promise.resolve());
+		_defineProperty(this, "_remoteReady", Promise.resolve(true));
 		this._initRPCChannels();
 		this._init();
 	}
@@ -544,10 +564,20 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends _univerj
 			if (!alreadySyncing) this._syncingUnits.delete(unitId);
 		});
 	}
+	async syncMutation(commandInfo, options) {
+		const sync = () => this._remoteReady.then(() => this._remoteInstanceService.syncMutation({ mutationInfo: commandInfo }, options));
+		const result = this._syncMutationQueue.then(sync, sync);
+		this._syncMutationQueue = result.catch(() => false);
+		return result;
+	}
+	async waitForPendingMutations() {
+		await this._syncMutationQueue.catch(() => false);
+	}
 	_initRPCChannels() {
 		this._rpcChannelService.registerChannel(RemoteSyncServiceName, fromModule(this._remoteSyncService));
 		this._injector.add([IRemoteInstanceService, { useFactory: () => toModule(this._rpcChannelService.requestChannel(RemoteInstanceServiceName)) }]);
 		this._remoteInstanceService = this._injector.get(IRemoteInstanceService);
+		this._remoteReady = this._remoteInstanceService.whenReady();
 	}
 	_init() {
 		this._univerInstanceService.getTypeOfUnitAdded$(_univerjs_core.UniverInstanceType.UNIVER_SHEET).pipe((0, rxjs_operators.takeUntil)(this.dispose$)).subscribe((event) => {
@@ -566,10 +596,7 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends _univerj
 		this.disposeWithMe(this._commandService.onCommandExecuted((commandInfo, options) => {
 			const { type, params, id } = commandInfo;
 			const unitId = (params === null || params === void 0 ? void 0 : params.unitId) || "";
-			if (type === _univerjs_core.CommandType.MUTATION && (!unitId || this._syncingUnits.has(unitId)) && !(options === null || options === void 0 ? void 0 : options.fromSync) && this._syncingMutations.has(id)) {
-				const sync = () => this._remoteInstanceService.syncMutation({ mutationInfo: commandInfo }, options);
-				this._syncMutationQueue = this._syncMutationQueue.then(sync, sync).catch(() => false);
-			}
+			if (type === _univerjs_core.CommandType.MUTATION && (!unitId || this._syncingUnits.has(unitId)) && !(options === null || options === void 0 ? void 0 : options.fromSync) && this._syncingMutations.has(id)) this.syncMutation(commandInfo, options);
 		}));
 	}
 };
@@ -615,7 +642,7 @@ DataSyncReplicaController = __decorate([
 //#endregion
 //#region package.json
 var name = "@univerjs/rpc";
-var version = "1.0.0-insiders.20260809-70eefdd";
+var version = "1.0.0-rc.0";
 
 //#endregion
 //#region src/services/rpc/implementations/web-worker-rpc.service.ts

package/lib/es/index.js

@@ -1,4 +1,4 @@
-import { CommandType, Disposable, ICommandService, IConfigService, ILogService, IUniverInstanceService, Inject, Injector, Plugin, RxDisposable, UniverInstanceType, createIdentifier, merge, toDisposable } from "@univerjs/core";
+import { CommandType, Disposable, ICommandService, IConfigService, ILogService, IUniverInstanceService, Inject, Injector, LifecycleService, LifecycleStages, Plugin, RxDisposable, UniverInstanceType, createIdentifier, merge, toDisposable } from "@univerjs/core";
 import { filter, take, takeUntil } from "rxjs/operators";
 import { BehaviorSubject, Observable, firstValueFrom, isObservable, of, shareReplay } from "rxjs";
 
@@ -74,13 +74,15 @@ const RemoteInstanceServiceName = "univer.remote-instance-service";
 */
 const IRemoteInstanceService = createIdentifier(RemoteInstanceServiceName);
 let WebWorkerRemoteInstanceService = class WebWorkerRemoteInstanceService {
-	constructor(_univerInstanceService, _commandService, _logService) {
+	constructor(_univerInstanceService, _commandService, _logService, _lifecycleService) {
 		this._univerInstanceService = _univerInstanceService;
 		this._commandService = _commandService;
 		this._logService = _logService;
+		this._lifecycleService = _lifecycleService;
 	}
 	whenReady() {
-		return Promise.resolve(true);
+		if (this._lifecycleService.stage >= LifecycleStages.Ready) return Promise.resolve(true);
+		return this._lifecycleService.onStage(LifecycleStages.Ready).then(() => true);
 	}
 	async syncMutation(params, options) {
 		return this._applyMutation(params.mutationInfo, options);
@@ -120,7 +122,8 @@ let WebWorkerRemoteInstanceService = class WebWorkerRemoteInstanceService {
 WebWorkerRemoteInstanceService = __decorate([
 	__decorateParam(0, IUniverInstanceService),
 	__decorateParam(1, ICommandService),
-	__decorateParam(2, ILogService)
+	__decorateParam(2, ILogService),
+	__decorateParam(3, Inject(LifecycleService))
 ], WebWorkerRemoteInstanceService);
 
 //#endregion
@@ -233,7 +236,12 @@ var ChannelClient = class extends RxDisposable {
 		this._protocol.onMessage.pipe(takeUntil(this.dispose$)).subscribe((message) => this._onMessage(message));
 	}
 	dispose() {
+		if (this._disposed) return;
+		const error = /* @__PURE__ */ new Error("[ChannelClient]: client is disposed!");
+		this._initialized.error(error);
+		for (const responseHandler of this._pendingRequests.values()) responseHandler.dispose(error);
 		this._pendingRequests.clear();
+		super.dispose();
 	}
 	getChannel(channelName) {
 		return {
@@ -265,19 +273,24 @@ var ChannelClient = class extends RxDisposable {
 		};
 		const pendingRequests = this._pendingRequests;
 		return new Promise((resolve, reject) => {
-			this._pendingRequests.set(sequence, { handle(response) {
-				switch (response.type) {
-					case 201:
-						pendingRequests.delete(sequence);
-						resolve(response.data);
-						break;
-					case 202:
-						pendingRequests.delete(sequence);
-						reject(response.data);
-						break;
-					default: throw new Error("[ChannelClient]: unknown response type!");
+			this._pendingRequests.set(sequence, {
+				handle(response) {
+					switch (response.type) {
+						case 201:
+							pendingRequests.delete(sequence);
+							resolve(response.data);
+							break;
+						case 202:
+							pendingRequests.delete(sequence);
+							reject(response.data);
+							break;
+						default: throw new Error("[ChannelClient]: unknown response type!");
+					}
+				},
+				dispose(error) {
+					reject(error);
 				}
-			} });
+			});
 			this._sendRequest(request);
 		});
 	}
@@ -293,20 +306,25 @@ var ChannelClient = class extends RxDisposable {
 					method,
 					args
 				};
-				this._pendingRequests.set(sequence, { handle(response) {
-					switch (response.type) {
-						case 300:
-							subscriber.next(response.data);
-							break;
-						case 301:
-							subscriber.error(response.data);
-							break;
-						case 302:
-							subscriber.complete();
-							break;
-						default: throw new Error("[ChannelClient]: unknown response type!");
+				this._pendingRequests.set(sequence, {
+					handle(response) {
+						switch (response.type) {
+							case 300:
+								subscriber.next(response.data);
+								break;
+							case 301:
+								subscriber.error(response.data);
+								break;
+							case 302:
+								subscriber.complete();
+								break;
+							default: throw new Error("[ChannelClient]: unknown response type!");
+						}
+					},
+					dispose(error) {
+						subscriber.error(error);
 					}
-				} });
+				});
 				this._sendRequest(request);
 			};
 			if (this._initialized.getValue()) doSubscribe();
@@ -357,6 +375,7 @@ var ChannelServer = class extends RxDisposable {
 	}
 	dispose() {
 		super.dispose();
+		for (const subscription of this._subscriptions.values()) subscription.unsubscribe();
 		this._subscriptions.clear();
 		this._channels.clear();
 	}
@@ -511,6 +530,7 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends RxDispos
 		_defineProperty(this, "_syncingUnits", /* @__PURE__ */ new Set());
 		_defineProperty(this, "_syncingMutations", /* @__PURE__ */ new Set());
 		_defineProperty(this, "_syncMutationQueue", Promise.resolve());
+		_defineProperty(this, "_remoteReady", Promise.resolve(true));
 		this._initRPCChannels();
 		this._init();
 	}
@@ -543,10 +563,20 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends RxDispos
 			if (!alreadySyncing) this._syncingUnits.delete(unitId);
 		});
 	}
+	async syncMutation(commandInfo, options) {
+		const sync = () => this._remoteReady.then(() => this._remoteInstanceService.syncMutation({ mutationInfo: commandInfo }, options));
+		const result = this._syncMutationQueue.then(sync, sync);
+		this._syncMutationQueue = result.catch(() => false);
+		return result;
+	}
+	async waitForPendingMutations() {
+		await this._syncMutationQueue.catch(() => false);
+	}
 	_initRPCChannels() {
 		this._rpcChannelService.registerChannel(RemoteSyncServiceName, fromModule(this._remoteSyncService));
 		this._injector.add([IRemoteInstanceService, { useFactory: () => toModule(this._rpcChannelService.requestChannel(RemoteInstanceServiceName)) }]);
 		this._remoteInstanceService = this._injector.get(IRemoteInstanceService);
+		this._remoteReady = this._remoteInstanceService.whenReady();
 	}
 	_init() {
 		this._univerInstanceService.getTypeOfUnitAdded$(UniverInstanceType.UNIVER_SHEET).pipe(takeUntil(this.dispose$)).subscribe((event) => {
@@ -565,10 +595,7 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends RxDispos
 		this.disposeWithMe(this._commandService.onCommandExecuted((commandInfo, options) => {
 			const { type, params, id } = commandInfo;
 			const unitId = (params === null || params === void 0 ? void 0 : params.unitId) || "";
-			if (type === CommandType.MUTATION && (!unitId || this._syncingUnits.has(unitId)) && !(options === null || options === void 0 ? void 0 : options.fromSync) && this._syncingMutations.has(id)) {
-				const sync = () => this._remoteInstanceService.syncMutation({ mutationInfo: commandInfo }, options);
-				this._syncMutationQueue = this._syncMutationQueue.then(sync, sync).catch(() => false);
-			}
+			if (type === CommandType.MUTATION && (!unitId || this._syncingUnits.has(unitId)) && !(options === null || options === void 0 ? void 0 : options.fromSync) && this._syncingMutations.has(id)) this.syncMutation(commandInfo, options);
 		}));
 	}
 };
@@ -614,7 +641,7 @@ DataSyncReplicaController = __decorate([
 //#endregion
 //#region package.json
 var name = "@univerjs/rpc";
-var version = "1.0.0-insiders.20260809-70eefdd";
+var version = "1.0.0-rc.0";
 
 //#endregion
 //#region src/services/rpc/implementations/web-worker-rpc.service.ts

package/lib/index.js

@@ -1,4 +1,4 @@
-import { CommandType, Disposable, ICommandService, IConfigService, ILogService, IUniverInstanceService, Inject, Injector, Plugin, RxDisposable, UniverInstanceType, createIdentifier, merge, toDisposable } from "@univerjs/core";
+import { CommandType, Disposable, ICommandService, IConfigService, ILogService, IUniverInstanceService, Inject, Injector, LifecycleService, LifecycleStages, Plugin, RxDisposable, UniverInstanceType, createIdentifier, merge, toDisposable } from "@univerjs/core";
 import { filter, take, takeUntil } from "rxjs/operators";
 import { BehaviorSubject, Observable, firstValueFrom, isObservable, of, shareReplay } from "rxjs";
 
@@ -74,13 +74,15 @@ const RemoteInstanceServiceName = "univer.remote-instance-service";
 */
 const IRemoteInstanceService = createIdentifier(RemoteInstanceServiceName);
 let WebWorkerRemoteInstanceService = class WebWorkerRemoteInstanceService {
-	constructor(_univerInstanceService, _commandService, _logService) {
+	constructor(_univerInstanceService, _commandService, _logService, _lifecycleService) {
 		this._univerInstanceService = _univerInstanceService;
 		this._commandService = _commandService;
 		this._logService = _logService;
+		this._lifecycleService = _lifecycleService;
 	}
 	whenReady() {
-		return Promise.resolve(true);
+		if (this._lifecycleService.stage >= LifecycleStages.Ready) return Promise.resolve(true);
+		return this._lifecycleService.onStage(LifecycleStages.Ready).then(() => true);
 	}
 	async syncMutation(params, options) {
 		return this._applyMutation(params.mutationInfo, options);
@@ -120,7 +122,8 @@ let WebWorkerRemoteInstanceService = class WebWorkerRemoteInstanceService {
 WebWorkerRemoteInstanceService = __decorate([
 	__decorateParam(0, IUniverInstanceService),
 	__decorateParam(1, ICommandService),
-	__decorateParam(2, ILogService)
+	__decorateParam(2, ILogService),
+	__decorateParam(3, Inject(LifecycleService))
 ], WebWorkerRemoteInstanceService);
 
 //#endregion
@@ -233,7 +236,12 @@ var ChannelClient = class extends RxDisposable {
 		this._protocol.onMessage.pipe(takeUntil(this.dispose$)).subscribe((message) => this._onMessage(message));
 	}
 	dispose() {
+		if (this._disposed) return;
+		const error = /* @__PURE__ */ new Error("[ChannelClient]: client is disposed!");
+		this._initialized.error(error);
+		for (const responseHandler of this._pendingRequests.values()) responseHandler.dispose(error);
 		this._pendingRequests.clear();
+		super.dispose();
 	}
 	getChannel(channelName) {
 		return {
@@ -265,19 +273,24 @@ var ChannelClient = class extends RxDisposable {
 		};
 		const pendingRequests = this._pendingRequests;
 		return new Promise((resolve, reject) => {
-			this._pendingRequests.set(sequence, { handle(response) {
-				switch (response.type) {
-					case 201:
-						pendingRequests.delete(sequence);
-						resolve(response.data);
-						break;
-					case 202:
-						pendingRequests.delete(sequence);
-						reject(response.data);
-						break;
-					default: throw new Error("[ChannelClient]: unknown response type!");
+			this._pendingRequests.set(sequence, {
+				handle(response) {
+					switch (response.type) {
+						case 201:
+							pendingRequests.delete(sequence);
+							resolve(response.data);
+							break;
+						case 202:
+							pendingRequests.delete(sequence);
+							reject(response.data);
+							break;
+						default: throw new Error("[ChannelClient]: unknown response type!");
+					}
+				},
+				dispose(error) {
+					reject(error);
 				}
-			} });
+			});
 			this._sendRequest(request);
 		});
 	}
@@ -293,20 +306,25 @@ var ChannelClient = class extends RxDisposable {
 					method,
 					args
 				};
-				this._pendingRequests.set(sequence, { handle(response) {
-					switch (response.type) {
-						case 300:
-							subscriber.next(response.data);
-							break;
-						case 301:
-							subscriber.error(response.data);
-							break;
-						case 302:
-							subscriber.complete();
-							break;
-						default: throw new Error("[ChannelClient]: unknown response type!");
+				this._pendingRequests.set(sequence, {
+					handle(response) {
+						switch (response.type) {
+							case 300:
+								subscriber.next(response.data);
+								break;
+							case 301:
+								subscriber.error(response.data);
+								break;
+							case 302:
+								subscriber.complete();
+								break;
+							default: throw new Error("[ChannelClient]: unknown response type!");
+						}
+					},
+					dispose(error) {
+						subscriber.error(error);
 					}
-				} });
+				});
 				this._sendRequest(request);
 			};
 			if (this._initialized.getValue()) doSubscribe();
@@ -357,6 +375,7 @@ var ChannelServer = class extends RxDisposable {
 	}
 	dispose() {
 		super.dispose();
+		for (const subscription of this._subscriptions.values()) subscription.unsubscribe();
 		this._subscriptions.clear();
 		this._channels.clear();
 	}
@@ -511,6 +530,7 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends RxDispos
 		_defineProperty(this, "_syncingUnits", /* @__PURE__ */ new Set());
 		_defineProperty(this, "_syncingMutations", /* @__PURE__ */ new Set());
 		_defineProperty(this, "_syncMutationQueue", Promise.resolve());
+		_defineProperty(this, "_remoteReady", Promise.resolve(true));
 		this._initRPCChannels();
 		this._init();
 	}
@@ -543,10 +563,20 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends RxDispos
 			if (!alreadySyncing) this._syncingUnits.delete(unitId);
 		});
 	}
+	async syncMutation(commandInfo, options) {
+		const sync = () => this._remoteReady.then(() => this._remoteInstanceService.syncMutation({ mutationInfo: commandInfo }, options));
+		const result = this._syncMutationQueue.then(sync, sync);
+		this._syncMutationQueue = result.catch(() => false);
+		return result;
+	}
+	async waitForPendingMutations() {
+		await this._syncMutationQueue.catch(() => false);
+	}
 	_initRPCChannels() {
 		this._rpcChannelService.registerChannel(RemoteSyncServiceName, fromModule(this._remoteSyncService));
 		this._injector.add([IRemoteInstanceService, { useFactory: () => toModule(this._rpcChannelService.requestChannel(RemoteInstanceServiceName)) }]);
 		this._remoteInstanceService = this._injector.get(IRemoteInstanceService);
+		this._remoteReady = this._remoteInstanceService.whenReady();
 	}
 	_init() {
 		this._univerInstanceService.getTypeOfUnitAdded$(UniverInstanceType.UNIVER_SHEET).pipe(takeUntil(this.dispose$)).subscribe((event) => {
@@ -565,10 +595,7 @@ let DataSyncPrimaryController = class DataSyncPrimaryController extends RxDispos
 		this.disposeWithMe(this._commandService.onCommandExecuted((commandInfo, options) => {
 			const { type, params, id } = commandInfo;
 			const unitId = (params === null || params === void 0 ? void 0 : params.unitId) || "";
-			if (type === CommandType.MUTATION && (!unitId || this._syncingUnits.has(unitId)) && !(options === null || options === void 0 ? void 0 : options.fromSync) && this._syncingMutations.has(id)) {
-				const sync = () => this._remoteInstanceService.syncMutation({ mutationInfo: commandInfo }, options);
-				this._syncMutationQueue = this._syncMutationQueue.then(sync, sync).catch(() => false);
-			}
+			if (type === CommandType.MUTATION && (!unitId || this._syncingUnits.has(unitId)) && !(options === null || options === void 0 ? void 0 : options.fromSync) && this._syncingMutations.has(id)) this.syncMutation(commandInfo, options);
 		}));
 	}
 };
@@ -614,7 +641,7 @@ DataSyncReplicaController = __decorate([
 //#endregion
 //#region package.json
 var name = "@univerjs/rpc";
-var version = "1.0.0-insiders.20260809-70eefdd";
+var version = "1.0.0-rc.0";
 
 //#endregion
 //#region src/services/rpc/implementations/web-worker-rpc.service.ts

package/lib/types/controllers/data-sync/data-sync-primary.controller.d.ts

@@ -13,7 +13,8 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import type { IDisposable, IMutation } from '@univerjs/core';
+import type { IDisposable, IMutation, IMutationInfo } from '@univerjs/core';
+import type { IRemoteSyncMutationOptions } from '../../services/remote-instance/remote-instance.service';
 import { ICommandService, Injector, IUniverInstanceService, RxDisposable } from '@univerjs/core';
 import { IRemoteSyncService } from '../../services/remote-instance/remote-instance.service';
 import { IRPCChannelService } from '../../services/rpc/channel.service';
@@ -33,6 +34,7 @@ export declare class DataSyncPrimaryController extends RxDisposable {
     private readonly _syncingUnits;
     private readonly _syncingMutations;
     private _syncMutationQueue;
+    private _remoteReady;
     constructor(_injector: Injector, _commandService: ICommandService, _univerInstanceService: IUniverInstanceService, _rpcChannelService: IRPCChannelService, _remoteSyncService: IRemoteSyncService);
     registerSyncingMutations(mutation: IMutation<object>): void;
     /**
@@ -42,6 +44,8 @@ export declare class DataSyncPrimaryController extends RxDisposable {
     syncUnit(unitId: string): IDisposable;
     /** Sync registered mutations for a unit without creating a replica unit. */
     syncUnitMutations(unitId: string): IDisposable;
+    syncMutation(commandInfo: IMutationInfo, options?: IRemoteSyncMutationOptions): Promise<boolean>;
+    waitForPendingMutations(): Promise<void>;
     private _initRPCChannels;
     private _init;
 }

package/lib/types/services/remote-instance/remote-instance.service.d.ts

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import type { IBaseSnapshot, IExecutionOptions, IMutationInfo, IWorkbookData } from '@univerjs/core';
-import { ICommandService, ILogService, IUniverInstanceService, UniverInstanceType } from '@univerjs/core';
+import { ICommandService, ILogService, IUniverInstanceService, LifecycleService, UniverInstanceType } from '@univerjs/core';
 export interface IRemoteSyncMutationOptions extends IExecutionOptions {
     /** If this mutation is executed after it was sent from the peer univer instance (e.g. in a web worker). */
     fromSync?: boolean;
@@ -65,7 +65,8 @@ export declare class WebWorkerRemoteInstanceService implements IRemoteInstanceSe
     protected readonly _univerInstanceService: IUniverInstanceService;
     protected readonly _commandService: ICommandService;
     protected readonly _logService: ILogService;
-    constructor(_univerInstanceService: IUniverInstanceService, _commandService: ICommandService, _logService: ILogService);
+    protected readonly _lifecycleService: LifecycleService;
+    constructor(_univerInstanceService: IUniverInstanceService, _commandService: ICommandService, _logService: ILogService, _lifecycleService: LifecycleService);
     whenReady(): Promise<true>;
     syncMutation(params: {
         mutationInfo: IMutationInfo;

package/lib/umd/index.js

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@univerjs/core"),require("rxjs/operators"),require("rxjs")):typeof define==`function`&&define.amd?define([`exports`,`@univerjs/core`,`rxjs/operators`,`rxjs`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.UniverRpc={},e.UniverCore,e.rxjs.operators,e.rxjs))})(this,function(e,t,n,r){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});let i=`rpc.main-thread.config`,a={},o=`rpc.worker-thread.config`,s={};function c(e,t){return function(n,r){t(n,r,e)}}function l(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}let u=`rpc.remote-sync.service`,d=(0,t.createIdentifier)(u),f=class{constructor(e){this._commandService=e}async syncMutation(e,t){let{fromCollab:n,...r}=t||{};return this._commandService.syncExecuteCommand(e.mutationInfo.id,e.mutationInfo.params,{...r,onlyLocal:!0,fromSync:!0})}};f=l([c(0,t.ICommandService)],f);let p=`univer.remote-instance-service`,m=(0,t.createIdentifier)(p),h=class{constructor(e,t,n){this._univerInstanceService=e,this._commandService=t,this._logService=n}whenReady(){return Promise.resolve(!0)}async syncMutation(e,t){return this._applyMutation(e.mutationInfo,t)}async createInstance(e){this._logService.debug(`[WebWorkerRemoteInstanceService]: Creating instance with id ${e.unitID}`);let{type:n,snapshot:r}=e;try{switch(n){case t.UniverInstanceType.UNIVER_SHEET:return this._univerInstanceService.createUnit(t.UniverInstanceType.UNIVER_SHEET,r),!0;case t.UniverInstanceType.UNIVER_BASE:return this._univerInstanceService.createUnit(t.UniverInstanceType.UNIVER_BASE,r),!0;default:throw Error(`[WebWorkerRemoteInstanceService]: cannot create replica for document type: ${n}.`)}}catch(e){throw e instanceof Error?e:TypeError(`${e}`)}}async disposeInstance(e){return this._logService.debug(`[WebWorkerRemoteInstanceService]: Disposing instance with id ${e.unitID}`),this._univerInstanceService.disposeUnit(e.unitID)}_applyMutation(e,t){let{id:n,params:r}=e,{fromCollab:i,...a}=t||{};return this._commandService.syncExecuteCommand(n,r,{...a,onlyLocal:!0,fromSync:!0})}};h=l([c(0,t.IUniverInstanceService),c(1,t.ICommandService),c(2,t.ILogService)],h);function g(e){"@babel/helpers - typeof";return g=typeof Symbol==`function`&&typeof Symbol.iterator==`symbol`?function(e){return typeof e}:function(e){return e&&typeof Symbol==`function`&&e.constructor===Symbol&&e!==Symbol.prototype?`symbol`:typeof e},g(e)}function _(e,t){if(g(e)!=`object`||!e)return e;var n=e[Symbol.toPrimitive];if(n!==void 0){var r=n.call(e,t||`default`);if(g(r)!=`object`)return r;throw TypeError(`@@toPrimitive must return a primitive value.`)}return(t===`string`?String:Number)(e)}function v(e){var t=_(e,`string`);return g(t)==`symbol`?t:t+``}function y(e,t,n){return(t=v(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function b(e){let t=e;return new class{call(e,n){let r=t[e];if(typeof r==`function`){let e=n?r.apply(t,n):r.call(t);return e instanceof Promise||(e=Promise.resolve(e)),e}throw Error(`[RPC]: method not found for ${e}!`)}subscribe(e,n){let i=t[e];if(typeof i==`function`){let e=n?i.apply(t,n):i.call(t);return(0,r.isObservable)(e)?e:(0,r.of)(e)}throw Error(`[RPC]: observable method not found for ${e}!`)}}}function x(e){return new Proxy({},{get(t,n){if(n!==`dispose`)return function(...t){return S(n)?e.subscribe(n,t):e.call(n,t)}}})}function S(e){return e.endsWith(`$`)}var C=class extends t.RxDisposable{constructor(e){super(),this._protocol=e,y(this,`_initialized`,new r.BehaviorSubject(!1)),y(this,`_lastRequestCounter`,0),y(this,`_pendingRequests`,new Map),this._protocol.send({type:50}),this._protocol.onMessage.pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>this._onMessage(e))}dispose(){this._pendingRequests.clear()}getChannel(e){return{call:(t,n)=>this._disposed?Promise.reject(Error(`[ChannelClient]: client is disposed!`)):this._remoteCall(e,t,n),subscribe:(t,n)=>{if(this._disposed)throw Error(`[ChannelClient]: client is disposed!`);return this._remoteSubscribe(e,t,n)}}}_whenReady(){return(0,r.firstValueFrom)(this._initialized.pipe((0,n.filter)(e=>e),(0,n.take)(1)))}_remoteCall(e,t,n){return this._initialized.getValue()?this._doRemoteCall(e,t,n):this._whenReady().then(()=>this._doRemoteCall(e,t,n))}_doRemoteCall(e,t,n){let r=++this._lastRequestCounter,i={seq:r,type:100,channelName:e,method:t,args:n},a=this._pendingRequests;return new Promise((e,t)=>{this._pendingRequests.set(r,{handle(n){switch(n.type){case 201:a.delete(r),e(n.data);break;case 202:a.delete(r),t(n.data);break;default:throw Error(`[ChannelClient]: unknown response type!`)}}}),this._sendRequest(i)})}_remoteSubscribe(e,t,n){return new r.Observable(r=>{let i=-1,a=()=>{i=++this._lastRequestCounter;let a={seq:i,type:101,channelName:e,method:t,args:n};this._pendingRequests.set(i,{handle(e){switch(e.type){case 300:r.next(e.data);break;case 301:r.error(e.data);break;case 302:r.complete();break;default:throw Error(`[ChannelClient]: unknown response type!`)}}}),this._sendRequest(a)};return this._initialized.getValue()?a():this._whenReady().then(a),()=>{if(i===-1)return;let n={type:102,seq:i,channelName:e,method:t};this._sendRequest(n)}})}_sendRequest(e){this._protocol.send(e)}_onMessage(e){let{type:t,seq:n}=e;switch(t){case 0:this._initialized.next(!0);break;case 201:case 202:case 300:case 302:case 301:{var r;let{_pendingRequests:i}=this;(r=i.get(n))==null||r.handle(e),t!==300&&i.delete(n);break}}}},w=class extends t.RxDisposable{constructor(e){super(),this._protocol=e,y(this,`_channels`,new Map),y(this,`_subscriptions`,new Map),this._protocol.onMessage.pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>this._onRequest(e)),this._sendInitialize()}dispose(){super.dispose(),this._subscriptions.clear(),this._channels.clear()}registerChannel(e,t){this._channels.set(e,t)}_onRequest(e){switch(e.type){case 50:this._sendInitialize();break;case 100:this._onMethodCall(e);break;case 101:this._onSubscribe(e);break;case 102:this._onUnsubscribe(e);break;default:break}}_sendInitialize(){this._sendResponse({seq:-1,type:0})}_onMethodCall(e){let{channelName:t,method:n,args:r}=e,i=this._channels.get(t),a;try{if(!i)throw Error(`[ChannelServer]: Channel ${t} not found!`);a=r?i.call(n,r):i.call(n)}catch(e){a=Promise.reject(e instanceof Error?e:Error(String(e)))}a.then(t=>{this._sendResponse({seq:e.seq,type:201,data:t})}).catch(t=>{t instanceof Error?this._sendResponse({seq:e.seq,type:202,data:t.message}):this._sendResponse({seq:e.seq,type:202,data:String(t)})})}_onSubscribe(e){let{channelName:t,seq:n}=e,r=this._channels.get(t);try{if(!r)throw Error(`[ChannelServer]: Channel ${t} not found!`);let i=r.subscribe(e.method,e.args).subscribe({next:e=>{this._sendResponse({seq:n,type:300,data:e})},error:e=>{this._sendResponse({seq:n,type:301,data:e.message}),this._sendResponse({seq:n,type:302})},complete:()=>{this._sendResponse({seq:n,type:302})}});this._subscriptions.set(e.seq,i)}catch(t){t instanceof Error?this._sendResponse({seq:e.seq,type:301,data:t.message}):this._sendResponse({seq:e.seq,type:301,data:String(t)})}}_onUnsubscribe(e){let t=this._subscriptions.get(e.seq);t&&(t.unsubscribe(),this._subscriptions.delete(e.seq))}_sendResponse(e){this._protocol.send(e)}};let T=(0,t.createIdentifier)(`IRPCChannelService`);var E=class{constructor(e){y(this,`_client`,void 0),y(this,`_server`,void 0),this._client=new C(e),this._server=new w(e)}dispose(){this._client.dispose(),this._server.dispose()}requestChannel(e){return this._client.getChannel(e)}registerChannel(e,t){this._server.registerChannel(e,t)}};let D=class extends t.RxDisposable{constructor(e,t,n,r,i){super(),this._injector=e,this._commandService=t,this._univerInstanceService=n,this._rpcChannelService=r,this._remoteSyncService=i,y(this,`_remoteInstanceService`,void 0),y(this,`_syncingUnits`,new Set),y(this,`_syncingMutations`,new Set),y(this,`_syncMutationQueue`,Promise.resolve()),this._initRPCChannels(),this._init()}registerSyncingMutations(e){this._syncingMutations.add(e.id)}syncUnit(e){let n=this._syncingUnits.has(e);this._syncingUnits.add(e);let r=this._univerInstanceService.getUnit(e,t.UniverInstanceType.UNIVER_SHEET)??this._univerInstanceService.getUnit(e,t.UniverInstanceType.UNIVER_BASE);return!n&&r&&this._remoteInstanceService.createInstance({unitID:r.getUnitId(),type:r.type,snapshot:r.getSnapshot()}),(0,t.toDisposable)(()=>{n||this._syncingUnits.delete(e),!n&&r&&this._remoteInstanceService.disposeInstance({unitID:r.getUnitId()})})}syncUnitMutations(e){let n=this._syncingUnits.has(e);return this._syncingUnits.add(e),(0,t.toDisposable)(()=>{n||this._syncingUnits.delete(e)})}_initRPCChannels(){this._rpcChannelService.registerChannel(u,b(this._remoteSyncService)),this._injector.add([m,{useFactory:()=>x(this._rpcChannelService.requestChannel(p))}]),this._remoteInstanceService=this._injector.get(m)}_init(){this._univerInstanceService.getTypeOfUnitAdded$(t.UniverInstanceType.UNIVER_SHEET).pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>{let{unit:n}=e;this._syncingUnits.add(n.getUnitId()),this._remoteInstanceService.createInstance({unitID:n.getUnitId(),type:t.UniverInstanceType.UNIVER_SHEET,snapshot:n.getSnapshot()})}),this._univerInstanceService.getTypeOfUnitDisposed$(t.UniverInstanceType.UNIVER_SHEET).pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>{this._syncingUnits.delete(e.getUnitId()),this._remoteInstanceService.disposeInstance({unitID:e.getUnitId()})}),this.disposeWithMe(this._commandService.onCommandExecuted((e,n)=>{let{type:r,params:i,id:a}=e,o=(i==null?void 0:i.unitId)||``;if(r===t.CommandType.MUTATION&&(!o||this._syncingUnits.has(o))&&!(n!=null&&n.fromSync)&&this._syncingMutations.has(a)){let t=()=>this._remoteInstanceService.syncMutation({mutationInfo:e},n);this._syncMutationQueue=this._syncMutationQueue.then(t,t).catch(()=>!1)}}))}};D=l([c(0,(0,t.Inject)(t.Injector)),c(1,t.ICommandService),c(2,t.IUniverInstanceService),c(3,T),c(4,d)],D);let O=class extends t.Disposable{constructor(e,t,n,r){super(),this._injector=e,this._remoteInstanceService=t,this._commandService=n,this._rpcChannelService=r,y(this,`_remoteSyncService`,void 0),this._initRPCChannels(),this._init()}_initRPCChannels(){this._rpcChannelService.registerChannel(p,b(this._remoteInstanceService)),this._injector.add([d,{useFactory:()=>x(this._rpcChannelService.requestChannel(u))}]),this._remoteSyncService=this._injector.get(d)}_init(){this.disposeWithMe(this._commandService.onCommandExecuted((e,n)=>{e.type===t.CommandType.MUTATION&&!(n!=null&&n.fromSync)&&this._remoteSyncService.syncMutation({mutationInfo:e},n)}))}};O=l([c(0,(0,t.Inject)(t.Injector)),c(1,m),c(2,t.ICommandService),c(3,T)],O);var k=`@univerjs/rpc`,A=`1.0.0-insiders.20260809-70eefdd`;function j(){return{send(e){postMessage(e)},onMessage:new r.Observable(e=>{let t=t=>{e.next(t.data)};return addEventListener(`message`,t),()=>removeEventListener(`message`,t)}).pipe((0,r.shareReplay)({bufferSize:1,refCount:!0}))}}function M(e){return{send(t){e.postMessage(t)},onMessage:new r.Observable(t=>{let n=e=>{t.next(e.data)};return e.addEventListener(`message`,n),()=>e.removeEventListener(`message`,n)}).pipe((0,r.shareReplay)({bufferSize:1,refCount:!0}))}}let N=class extends t.Plugin{constructor(e=a,n,r){super(),this._config=e,this._injector=n,this._configService=r,y(this,`_internalWorker`,null);let{...o}=(0,t.merge)({},a,this._config);this._configService.setConfig(i,o)}dispose(){super.dispose(),this._internalWorker&&=(this._internalWorker.terminate(),null)}onStarting(){let{workerURL:e}=this._config;if(!e)throw Error(`[UniverRPCMainThreadPlugin]: The workerURL is required for the RPC main thread plugin.`);let t=e instanceof Worker?e:new Worker(e);this._internalWorker=e instanceof Worker?null:t;let n=M(t);[[T,{useFactory:()=>new E(n)}],[D],[d,{useClass:f}]].forEach(e=>this._injector.add(e)),this._injector.get(D)}};y(N,`pluginName`,`UNIVER_RPC_MAIN_THREAD_PLUGIN`),y(N,`packageName`,k),y(N,`version`,A),N=l([c(1,(0,t.Inject)(t.Injector)),c(2,t.IConfigService)],N);let P=class extends t.Plugin{constructor(e=s,n,r){super(),this._config=e,this._injector=n,this._configService=r;let{...i}=(0,t.merge)({},s,this._config);this._configService.setConfig(o,i)}onStarting(){[[O],[T,{useFactory:()=>new E(j())}],[m,{useClass:h}]].forEach(e=>this._injector.add(e)),this._injector.get(O)}};y(P,`pluginName`,`UNIVER_RPC_WORKER_THREAD_PLUGIN`),y(P,`packageName`,k),y(P,`version`,A),P=l([c(1,(0,t.Inject)(t.Injector)),c(2,t.IConfigService)],P),e.ChannelClient=C,e.ChannelServer=w,e.ChannelService=E,Object.defineProperty(e,"DataSyncPrimaryController",{enumerable:!0,get:function(){return D}}),Object.defineProperty(e,"DataSyncReplicaController",{enumerable:!0,get:function(){return O}}),e.IRPCChannelService=T,e.IRemoteInstanceService=m,e.IRemoteSyncService=d,e.PLUGIN_CONFIG_KEY_MAIN_THREAD=i,e.PLUGIN_CONFIG_KEY_WORKER_THREAD=o,e.RemoteInstanceServiceName=p,Object.defineProperty(e,"RemoteSyncPrimaryService",{enumerable:!0,get:function(){return f}}),e.RemoteSyncServiceName=u,Object.defineProperty(e,"UniverRPCMainThreadPlugin",{enumerable:!0,get:function(){return N}}),Object.defineProperty(e,"UniverRPCWorkerThreadPlugin",{enumerable:!0,get:function(){return P}}),Object.defineProperty(e,"WebWorkerRemoteInstanceService",{enumerable:!0,get:function(){return h}}),e.fromModule=b,e.toModule=x});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@univerjs/core"),require("rxjs/operators"),require("rxjs")):typeof define==`function`&&define.amd?define([`exports`,`@univerjs/core`,`rxjs/operators`,`rxjs`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.UniverRpc={},e.UniverCore,e.rxjs.operators,e.rxjs))})(this,function(e,t,n,r){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});let i=`rpc.main-thread.config`,a={},o=`rpc.worker-thread.config`,s={};function c(e,t){return function(n,r){t(n,r,e)}}function l(e,t,n,r){var i=arguments.length,a=i<3?t:r===null?r=Object.getOwnPropertyDescriptor(t,n):r,o;if(typeof Reflect==`object`&&typeof Reflect.decorate==`function`)a=Reflect.decorate(e,t,n,r);else for(var s=e.length-1;s>=0;s--)(o=e[s])&&(a=(i<3?o(a):i>3?o(t,n,a):o(t,n))||a);return i>3&&a&&Object.defineProperty(t,n,a),a}let u=`rpc.remote-sync.service`,d=(0,t.createIdentifier)(u),f=class{constructor(e){this._commandService=e}async syncMutation(e,t){let{fromCollab:n,...r}=t||{};return this._commandService.syncExecuteCommand(e.mutationInfo.id,e.mutationInfo.params,{...r,onlyLocal:!0,fromSync:!0})}};f=l([c(0,t.ICommandService)],f);let p=`univer.remote-instance-service`,m=(0,t.createIdentifier)(p),h=class{constructor(e,t,n,r){this._univerInstanceService=e,this._commandService=t,this._logService=n,this._lifecycleService=r}whenReady(){return this._lifecycleService.stage>=t.LifecycleStages.Ready?Promise.resolve(!0):this._lifecycleService.onStage(t.LifecycleStages.Ready).then(()=>!0)}async syncMutation(e,t){return this._applyMutation(e.mutationInfo,t)}async createInstance(e){this._logService.debug(`[WebWorkerRemoteInstanceService]: Creating instance with id ${e.unitID}`);let{type:n,snapshot:r}=e;try{switch(n){case t.UniverInstanceType.UNIVER_SHEET:return this._univerInstanceService.createUnit(t.UniverInstanceType.UNIVER_SHEET,r),!0;case t.UniverInstanceType.UNIVER_BASE:return this._univerInstanceService.createUnit(t.UniverInstanceType.UNIVER_BASE,r),!0;default:throw Error(`[WebWorkerRemoteInstanceService]: cannot create replica for document type: ${n}.`)}}catch(e){throw e instanceof Error?e:TypeError(`${e}`)}}async disposeInstance(e){return this._logService.debug(`[WebWorkerRemoteInstanceService]: Disposing instance with id ${e.unitID}`),this._univerInstanceService.disposeUnit(e.unitID)}_applyMutation(e,t){let{id:n,params:r}=e,{fromCollab:i,...a}=t||{};return this._commandService.syncExecuteCommand(n,r,{...a,onlyLocal:!0,fromSync:!0})}};h=l([c(0,t.IUniverInstanceService),c(1,t.ICommandService),c(2,t.ILogService),c(3,(0,t.Inject)(t.LifecycleService))],h);function g(e){"@babel/helpers - typeof";return g=typeof Symbol==`function`&&typeof Symbol.iterator==`symbol`?function(e){return typeof e}:function(e){return e&&typeof Symbol==`function`&&e.constructor===Symbol&&e!==Symbol.prototype?`symbol`:typeof e},g(e)}function _(e,t){if(g(e)!=`object`||!e)return e;var n=e[Symbol.toPrimitive];if(n!==void 0){var r=n.call(e,t||`default`);if(g(r)!=`object`)return r;throw TypeError(`@@toPrimitive must return a primitive value.`)}return(t===`string`?String:Number)(e)}function v(e){var t=_(e,`string`);return g(t)==`symbol`?t:t+``}function y(e,t,n){return(t=v(t))in e?Object.defineProperty(e,t,{value:n,enumerable:!0,configurable:!0,writable:!0}):e[t]=n,e}function b(e){let t=e;return new class{call(e,n){let r=t[e];if(typeof r==`function`){let e=n?r.apply(t,n):r.call(t);return e instanceof Promise||(e=Promise.resolve(e)),e}throw Error(`[RPC]: method not found for ${e}!`)}subscribe(e,n){let i=t[e];if(typeof i==`function`){let e=n?i.apply(t,n):i.call(t);return(0,r.isObservable)(e)?e:(0,r.of)(e)}throw Error(`[RPC]: observable method not found for ${e}!`)}}}function x(e){return new Proxy({},{get(t,n){if(n!==`dispose`)return function(...t){return S(n)?e.subscribe(n,t):e.call(n,t)}}})}function S(e){return e.endsWith(`$`)}var C=class extends t.RxDisposable{constructor(e){super(),this._protocol=e,y(this,`_initialized`,new r.BehaviorSubject(!1)),y(this,`_lastRequestCounter`,0),y(this,`_pendingRequests`,new Map),this._protocol.send({type:50}),this._protocol.onMessage.pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>this._onMessage(e))}dispose(){if(this._disposed)return;let e=Error(`[ChannelClient]: client is disposed!`);this._initialized.error(e);for(let t of this._pendingRequests.values())t.dispose(e);this._pendingRequests.clear(),super.dispose()}getChannel(e){return{call:(t,n)=>this._disposed?Promise.reject(Error(`[ChannelClient]: client is disposed!`)):this._remoteCall(e,t,n),subscribe:(t,n)=>{if(this._disposed)throw Error(`[ChannelClient]: client is disposed!`);return this._remoteSubscribe(e,t,n)}}}_whenReady(){return(0,r.firstValueFrom)(this._initialized.pipe((0,n.filter)(e=>e),(0,n.take)(1)))}_remoteCall(e,t,n){return this._initialized.getValue()?this._doRemoteCall(e,t,n):this._whenReady().then(()=>this._doRemoteCall(e,t,n))}_doRemoteCall(e,t,n){let r=++this._lastRequestCounter,i={seq:r,type:100,channelName:e,method:t,args:n},a=this._pendingRequests;return new Promise((e,t)=>{this._pendingRequests.set(r,{handle(n){switch(n.type){case 201:a.delete(r),e(n.data);break;case 202:a.delete(r),t(n.data);break;default:throw Error(`[ChannelClient]: unknown response type!`)}},dispose(e){t(e)}}),this._sendRequest(i)})}_remoteSubscribe(e,t,n){return new r.Observable(r=>{let i=-1,a=()=>{i=++this._lastRequestCounter;let a={seq:i,type:101,channelName:e,method:t,args:n};this._pendingRequests.set(i,{handle(e){switch(e.type){case 300:r.next(e.data);break;case 301:r.error(e.data);break;case 302:r.complete();break;default:throw Error(`[ChannelClient]: unknown response type!`)}},dispose(e){r.error(e)}}),this._sendRequest(a)};return this._initialized.getValue()?a():this._whenReady().then(a),()=>{if(i===-1)return;let n={type:102,seq:i,channelName:e,method:t};this._sendRequest(n)}})}_sendRequest(e){this._protocol.send(e)}_onMessage(e){let{type:t,seq:n}=e;switch(t){case 0:this._initialized.next(!0);break;case 201:case 202:case 300:case 302:case 301:{var r;let{_pendingRequests:i}=this;(r=i.get(n))==null||r.handle(e),t!==300&&i.delete(n);break}}}},w=class extends t.RxDisposable{constructor(e){super(),this._protocol=e,y(this,`_channels`,new Map),y(this,`_subscriptions`,new Map),this._protocol.onMessage.pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>this._onRequest(e)),this._sendInitialize()}dispose(){super.dispose();for(let e of this._subscriptions.values())e.unsubscribe();this._subscriptions.clear(),this._channels.clear()}registerChannel(e,t){this._channels.set(e,t)}_onRequest(e){switch(e.type){case 50:this._sendInitialize();break;case 100:this._onMethodCall(e);break;case 101:this._onSubscribe(e);break;case 102:this._onUnsubscribe(e);break;default:break}}_sendInitialize(){this._sendResponse({seq:-1,type:0})}_onMethodCall(e){let{channelName:t,method:n,args:r}=e,i=this._channels.get(t),a;try{if(!i)throw Error(`[ChannelServer]: Channel ${t} not found!`);a=r?i.call(n,r):i.call(n)}catch(e){a=Promise.reject(e instanceof Error?e:Error(String(e)))}a.then(t=>{this._sendResponse({seq:e.seq,type:201,data:t})}).catch(t=>{t instanceof Error?this._sendResponse({seq:e.seq,type:202,data:t.message}):this._sendResponse({seq:e.seq,type:202,data:String(t)})})}_onSubscribe(e){let{channelName:t,seq:n}=e,r=this._channels.get(t);try{if(!r)throw Error(`[ChannelServer]: Channel ${t} not found!`);let i=r.subscribe(e.method,e.args).subscribe({next:e=>{this._sendResponse({seq:n,type:300,data:e})},error:e=>{this._sendResponse({seq:n,type:301,data:e.message}),this._sendResponse({seq:n,type:302})},complete:()=>{this._sendResponse({seq:n,type:302})}});this._subscriptions.set(e.seq,i)}catch(t){t instanceof Error?this._sendResponse({seq:e.seq,type:301,data:t.message}):this._sendResponse({seq:e.seq,type:301,data:String(t)})}}_onUnsubscribe(e){let t=this._subscriptions.get(e.seq);t&&(t.unsubscribe(),this._subscriptions.delete(e.seq))}_sendResponse(e){this._protocol.send(e)}};let T=(0,t.createIdentifier)(`IRPCChannelService`);var E=class{constructor(e){y(this,`_client`,void 0),y(this,`_server`,void 0),this._client=new C(e),this._server=new w(e)}dispose(){this._client.dispose(),this._server.dispose()}requestChannel(e){return this._client.getChannel(e)}registerChannel(e,t){this._server.registerChannel(e,t)}};let D=class extends t.RxDisposable{constructor(e,t,n,r,i){super(),this._injector=e,this._commandService=t,this._univerInstanceService=n,this._rpcChannelService=r,this._remoteSyncService=i,y(this,`_remoteInstanceService`,void 0),y(this,`_syncingUnits`,new Set),y(this,`_syncingMutations`,new Set),y(this,`_syncMutationQueue`,Promise.resolve()),y(this,`_remoteReady`,Promise.resolve(!0)),this._initRPCChannels(),this._init()}registerSyncingMutations(e){this._syncingMutations.add(e.id)}syncUnit(e){let n=this._syncingUnits.has(e);this._syncingUnits.add(e);let r=this._univerInstanceService.getUnit(e,t.UniverInstanceType.UNIVER_SHEET)??this._univerInstanceService.getUnit(e,t.UniverInstanceType.UNIVER_BASE);return!n&&r&&this._remoteInstanceService.createInstance({unitID:r.getUnitId(),type:r.type,snapshot:r.getSnapshot()}),(0,t.toDisposable)(()=>{n||this._syncingUnits.delete(e),!n&&r&&this._remoteInstanceService.disposeInstance({unitID:r.getUnitId()})})}syncUnitMutations(e){let n=this._syncingUnits.has(e);return this._syncingUnits.add(e),(0,t.toDisposable)(()=>{n||this._syncingUnits.delete(e)})}async syncMutation(e,t){let n=()=>this._remoteReady.then(()=>this._remoteInstanceService.syncMutation({mutationInfo:e},t)),r=this._syncMutationQueue.then(n,n);return this._syncMutationQueue=r.catch(()=>!1),r}async waitForPendingMutations(){await this._syncMutationQueue.catch(()=>!1)}_initRPCChannels(){this._rpcChannelService.registerChannel(u,b(this._remoteSyncService)),this._injector.add([m,{useFactory:()=>x(this._rpcChannelService.requestChannel(p))}]),this._remoteInstanceService=this._injector.get(m),this._remoteReady=this._remoteInstanceService.whenReady()}_init(){this._univerInstanceService.getTypeOfUnitAdded$(t.UniverInstanceType.UNIVER_SHEET).pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>{let{unit:n}=e;this._syncingUnits.add(n.getUnitId()),this._remoteInstanceService.createInstance({unitID:n.getUnitId(),type:t.UniverInstanceType.UNIVER_SHEET,snapshot:n.getSnapshot()})}),this._univerInstanceService.getTypeOfUnitDisposed$(t.UniverInstanceType.UNIVER_SHEET).pipe((0,n.takeUntil)(this.dispose$)).subscribe(e=>{this._syncingUnits.delete(e.getUnitId()),this._remoteInstanceService.disposeInstance({unitID:e.getUnitId()})}),this.disposeWithMe(this._commandService.onCommandExecuted((e,n)=>{let{type:r,params:i,id:a}=e,o=(i==null?void 0:i.unitId)||``;r===t.CommandType.MUTATION&&(!o||this._syncingUnits.has(o))&&!(n!=null&&n.fromSync)&&this._syncingMutations.has(a)&&this.syncMutation(e,n)}))}};D=l([c(0,(0,t.Inject)(t.Injector)),c(1,t.ICommandService),c(2,t.IUniverInstanceService),c(3,T),c(4,d)],D);let O=class extends t.Disposable{constructor(e,t,n,r){super(),this._injector=e,this._remoteInstanceService=t,this._commandService=n,this._rpcChannelService=r,y(this,`_remoteSyncService`,void 0),this._initRPCChannels(),this._init()}_initRPCChannels(){this._rpcChannelService.registerChannel(p,b(this._remoteInstanceService)),this._injector.add([d,{useFactory:()=>x(this._rpcChannelService.requestChannel(u))}]),this._remoteSyncService=this._injector.get(d)}_init(){this.disposeWithMe(this._commandService.onCommandExecuted((e,n)=>{e.type===t.CommandType.MUTATION&&!(n!=null&&n.fromSync)&&this._remoteSyncService.syncMutation({mutationInfo:e},n)}))}};O=l([c(0,(0,t.Inject)(t.Injector)),c(1,m),c(2,t.ICommandService),c(3,T)],O);var k=`@univerjs/rpc`,A=`1.0.0-rc.0`;function j(){return{send(e){postMessage(e)},onMessage:new r.Observable(e=>{let t=t=>{e.next(t.data)};return addEventListener(`message`,t),()=>removeEventListener(`message`,t)}).pipe((0,r.shareReplay)({bufferSize:1,refCount:!0}))}}function M(e){return{send(t){e.postMessage(t)},onMessage:new r.Observable(t=>{let n=e=>{t.next(e.data)};return e.addEventListener(`message`,n),()=>e.removeEventListener(`message`,n)}).pipe((0,r.shareReplay)({bufferSize:1,refCount:!0}))}}let N=class extends t.Plugin{constructor(e=a,n,r){super(),this._config=e,this._injector=n,this._configService=r,y(this,`_internalWorker`,null);let{...o}=(0,t.merge)({},a,this._config);this._configService.setConfig(i,o)}dispose(){super.dispose(),this._internalWorker&&=(this._internalWorker.terminate(),null)}onStarting(){let{workerURL:e}=this._config;if(!e)throw Error(`[UniverRPCMainThreadPlugin]: The workerURL is required for the RPC main thread plugin.`);let t=e instanceof Worker?e:new Worker(e);this._internalWorker=e instanceof Worker?null:t;let n=M(t);[[T,{useFactory:()=>new E(n)}],[D],[d,{useClass:f}]].forEach(e=>this._injector.add(e)),this._injector.get(D)}};y(N,`pluginName`,`UNIVER_RPC_MAIN_THREAD_PLUGIN`),y(N,`packageName`,k),y(N,`version`,A),N=l([c(1,(0,t.Inject)(t.Injector)),c(2,t.IConfigService)],N);let P=class extends t.Plugin{constructor(e=s,n,r){super(),this._config=e,this._injector=n,this._configService=r;let{...i}=(0,t.merge)({},s,this._config);this._configService.setConfig(o,i)}onStarting(){[[O],[T,{useFactory:()=>new E(j())}],[m,{useClass:h}]].forEach(e=>this._injector.add(e)),this._injector.get(O)}};y(P,`pluginName`,`UNIVER_RPC_WORKER_THREAD_PLUGIN`),y(P,`packageName`,k),y(P,`version`,A),P=l([c(1,(0,t.Inject)(t.Injector)),c(2,t.IConfigService)],P),e.ChannelClient=C,e.ChannelServer=w,e.ChannelService=E,Object.defineProperty(e,"DataSyncPrimaryController",{enumerable:!0,get:function(){return D}}),Object.defineProperty(e,"DataSyncReplicaController",{enumerable:!0,get:function(){return O}}),e.IRPCChannelService=T,e.IRemoteInstanceService=m,e.IRemoteSyncService=d,e.PLUGIN_CONFIG_KEY_MAIN_THREAD=i,e.PLUGIN_CONFIG_KEY_WORKER_THREAD=o,e.RemoteInstanceServiceName=p,Object.defineProperty(e,"RemoteSyncPrimaryService",{enumerable:!0,get:function(){return f}}),e.RemoteSyncServiceName=u,Object.defineProperty(e,"UniverRPCMainThreadPlugin",{enumerable:!0,get:function(){return N}}),Object.defineProperty(e,"UniverRPCWorkerThreadPlugin",{enumerable:!0,get:function(){return P}}),Object.defineProperty(e,"WebWorkerRemoteInstanceService",{enumerable:!0,get:function(){return h}}),e.fromModule=b,e.toModule=x});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@univerjs/rpc",
-  "version": "1.0.0-insiders.20260809-70eefdd",
+  "version": "1.0.0-rc.0",
   "private": false,
   "description": "Browser RPC layer for Univer main-thread and worker communication.",
   "author": "DreamNum Co., Ltd. <developer@univer.ai>",
@@ -52,13 +52,13 @@
     "rxjs": ">=7.0.0"
   },
   "dependencies": {
-    "@univerjs/core": "1.0.0-insiders.20260809-70eefdd"
+    "@univerjs/core": "1.0.0-rc.0"
   },
   "devDependencies": {
     "rxjs": "^7.8.2",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.10",
-    "@univerjs-infra/shared": "1.0.0-beta.0"
+    "vitest": "^5.0.0",
+    "@univerjs-infra/shared": "1.0.0-rc.0"
   },
   "scripts": {
     "test": "vitest run",