@univerjs-pro/collaboration-database-memory 1.0.0-insiders.20260808-70eefdd → 1.0.0-rc.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +35 -0
- package/README.zh-CN.md +37 -0
- package/dist/index.cjs +1 -1
- package/dist/index.d.ts +7 -4
- package/dist/index.mjs +1 -1
- package/package.json +4 -7
package/README.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# @univerjs-pro/collaboration-database-memory
|
|
2
|
+
|
|
3
|
+
English | [简体中文](./README.zh-CN.md)
|
|
4
|
+
|
|
5
|
+
An in-process `IDatabaseAdapter` for tests, local development, and temporary collaboration services.
|
|
6
|
+
|
|
7
|
+
## Create the Adapter
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pnpm add \
|
|
11
|
+
@univerjs-pro/collaboration-service \
|
|
12
|
+
@univerjs-pro/collaboration-database-memory
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import { MemoryDatabaseAdapter } from '@univerjs-pro/collaboration-database-memory';
|
|
17
|
+
import { UniverCollabService } from '@univerjs-pro/collaboration-service';
|
|
18
|
+
|
|
19
|
+
const database = new MemoryDatabaseAdapter();
|
|
20
|
+
const service = new UniverCollabService({ dbAdapter: database });
|
|
21
|
+
|
|
22
|
+
await service.dispose();
|
|
23
|
+
await database.dispose();
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Pass the Adapter to `UniverCollabService` as `dbAdapter`.
|
|
27
|
+
|
|
28
|
+
It follows the same collaboration persistence contract as the SQLite Adapter, including revision CAS, revisioned snapshots, Sheet blocks, and atomic Unit lifecycle batches. Submission idempotency is resolved by the Service from continuous changeset history, not by the Adapter.
|
|
29
|
+
|
|
30
|
+
## Limitations
|
|
31
|
+
|
|
32
|
+
- All data is lost when the process exits.
|
|
33
|
+
- State is not shared between Node.js processes.
|
|
34
|
+
- It is intended only for tests and temporary environments, not persistent production data.
|
|
35
|
+
- Hard delete removes core Unit data from the current process and retains a permanent deletion marker that prevents ID reuse.
|
package/README.zh-CN.md
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
# @univerjs-pro/collaboration-database-memory
|
|
2
|
+
|
|
3
|
+
[English](./README.md) | [简体中文](./README.zh-CN.md)
|
|
4
|
+
|
|
5
|
+
进程内 `IDatabaseAdapter`,适合测试、本地开发和临时协同服务。
|
|
6
|
+
|
|
7
|
+
## 创建 Adapter
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
pnpm add \
|
|
11
|
+
@univerjs-pro/collaboration-service \
|
|
12
|
+
@univerjs-pro/collaboration-database-memory
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
```ts
|
|
16
|
+
import { MemoryDatabaseAdapter } from '@univerjs-pro/collaboration-database-memory';
|
|
17
|
+
import { UniverCollabService } from '@univerjs-pro/collaboration-service';
|
|
18
|
+
|
|
19
|
+
const database = new MemoryDatabaseAdapter();
|
|
20
|
+
const service = new UniverCollabService({ dbAdapter: database });
|
|
21
|
+
|
|
22
|
+
await service.dispose();
|
|
23
|
+
await database.dispose();
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
将 Adapter 作为 `dbAdapter` 传给 `UniverCollabService`。
|
|
27
|
+
|
|
28
|
+
它与 SQLite Adapter 遵守相同的协同持久化契约,包括 revision CAS、revisioned
|
|
29
|
+
snapshot、Sheet blocks 和原子 Unit 生命周期批次。提交幂等由 Service 从连续
|
|
30
|
+
changeset history 中判断,不由 Adapter 维护 submission 索引。
|
|
31
|
+
|
|
32
|
+
## 限制
|
|
33
|
+
|
|
34
|
+
- 进程退出后全部数据丢失。
|
|
35
|
+
- 多个 Node.js 进程之间不共享状态。
|
|
36
|
+
- 只适合测试和临时环境,不适合持久化生产数据。
|
|
37
|
+
- hard delete 会清理当前进程中的核心 Unit 数据,并保留永久删除标记以禁止 ID 复用。
|
package/dist/index.cjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
Object['defineProperty'](exports,Symbol['toStringTag'],{'value':'Module'});let e=require('@univerjs-pro/collaboration-service');var t=class{['_units']=new Map();['_tombstones']=new Set();['_disposed']=!0x1;async['getUnit'](
|
|
1
|
+
Object['defineProperty'](exports,Symbol['toStringTag'],{'value':'Module'});let e=require('@univerjs-pro/collaboration-service');var t=class{['_units']=new Map();['_tombstones']=new Set();['_disposed']=!0x1;async['getUnit'](_0x52fcd8,_0x2a331c){this['_assertOpen']();let _0x146d26=this['_activeUnit'](_0x2a331c);return _0x146d26?c(_0x146d26['record']):null;}async['getSnapshot'](_0x3ffc37,_0x31f0eb,_0x53838c){let _0x347835=this['_getSnapshot'](_0x31f0eb,_0x53838c);return _0x347835?c(_0x347835):null;}async['getSnapshotInfo'](_0x9c57c7,_0x1b1f51,_0x502463){let _0x2c42ba=this['_getSnapshot'](_0x1b1f51,_0x502463);return _0x2c42ba?{'unitID':_0x2c42ba['unitID'],'type':_0x2c42ba['type'],'rev':_0x2c42ba['rev']}:null;}['_getSnapshot'](_0x24c74d,_0x345925){this['_assertOpen']();let _0x55547d=this['_activeUnit'](_0x24c74d);if(!_0x55547d)return null;let _0xcd7615=_0x345925?.['revision'],_0xda4b2e=_0xcd7615===void 0x0?_0x55547d['record']['headRevision']:Math['min'](_0xcd7615,_0x55547d['record']['headRevision']),_0x24da2f=-0x1;for(let _0x334cd1 of _0x55547d['snapshots']['keys']())_0x334cd1<=_0xda4b2e&&_0x334cd1>_0x24da2f&&(_0x24da2f=_0x334cd1);return _0x55547d['snapshots']['get'](_0x24da2f)??null;}async['getChangesets'](_0x31c180,_0x5f40b3,_0x9ea548){if(this['_assertOpen'](),_0x9ea548['from']<0x0||_0x9ea548['to']!==void 0x0&&_0x9ea548['to']<0x0)throw a('Changeset\x20range\x20revisions\x20cannot\x20be\x20negative');let _0x55a8d2=this['_activeUnit'](_0x5f40b3);return _0x55a8d2?[..._0x55a8d2['changesets']['entries']()]['filter'](([_0x47c38e])=>_0x47c38e>_0x9ea548['from']&&(_0x9ea548['to']===void 0x0||_0x47c38e<=_0x9ea548['to']))['sort'](([_0x242875],[_0x2c316e])=>_0x242875-_0x2c316e)['map'](([,_0x3613c5])=>c(_0x3613c5)):null;}async['createUnit'](_0x30cec2,_0x1c8b0c){this['_assertOpen'](),n(_0x1c8b0c);let _0x2931ef=this['_units']['get'](_0x1c8b0c['record']['unitID']);if(_0x2931ef){if(_0x2931ef['lifecycle']==='soft-deleted')throw a('A\x20soft-deleted\x20unit\x20ID\x20cannot\x20be\x20reused');return{'status':'already-exists','record':c(_0x2931ef['record'])};}if(this['_tombstones']['has'](_0x1c8b0c['record']['unitID']))throw a('A\x20purged\x20unit\x20ID\x20cannot\x20be\x20reused');let _0x3b6fce=r(_0x1c8b0c['sheetBlocks']),_0x5b088c={'record':c(_0x1c8b0c['record']),'lifecycle':'active','snapshots':new Map([[0x1,c(_0x1c8b0c['snapshot'])]]),'changesets':new Map(),'sheetBlocks':_0x3b6fce};return this['_units']['set'](_0x1c8b0c['record']['unitID'],_0x5b088c),{'status':'created','record':c(_0x5b088c['record'])};}async['deleteUnits'](_0x15333d,_0x3f63f8){this['_assertOpen']();let _0x5e38c7=s(_0x3f63f8['unitIDs'])['map'](_0xb3f64e=>{let _0x3bbd41=this['_units']['get'](_0xb3f64e);if(_0x3f63f8['hardDelete']){if(_0x3bbd41)return{'unitID':_0xb3f64e,'stored':_0x3bbd41,'status':'hard-deleted'};if(this['_tombstones']['has'](_0xb3f64e))return{'unitID':_0xb3f64e,'status':'already-hard-deleted'};throw o('Cannot\x20hard-delete\x20a\x20missing\x20unit');}if(!_0x3bbd41||this['_tombstones']['has'](_0xb3f64e))throw o('Cannot\x20soft-delete\x20a\x20missing\x20unit');return{'unitID':_0xb3f64e,'stored':_0x3bbd41,'status':_0x3bbd41['lifecycle']==='active'?'soft-deleted':'already-soft-deleted'};});for(let _0x226636 of _0x5e38c7)_0x3f63f8['hardDelete']&&_0x226636['status']==='hard-deleted'?(this['_units']['delete'](_0x226636['unitID']),this['_tombstones']['add'](_0x226636['unitID'])):!_0x3f63f8['hardDelete']&&_0x226636['stored']&&(_0x226636['stored']['lifecycle']='soft-deleted');return{'units':_0x5e38c7['map'](({unitID:_0x1564a7,status:_0x1a7d0a})=>({'unitID':_0x1564a7,'status':_0x1a7d0a}))};}async['recoverUnits'](_0x165427,_0x2a20a0){this['_assertOpen']();let _0x510f43=s(_0x2a20a0['unitIDs'])['map'](_0x13daf0=>{if(this['_tombstones']['has'](_0x13daf0))throw a('A\x20purged\x20unit\x20cannot\x20be\x20recovered');let _0x4d4888=this['_units']['get'](_0x13daf0);if(!_0x4d4888)throw o('Cannot\x20recover\x20a\x20missing\x20unit');return{'unitID':_0x13daf0,'stored':_0x4d4888,'status':_0x4d4888['lifecycle']==='active'?'already-active':'recovered'};});for(let _0x480680 of _0x510f43)_0x480680['stored']['lifecycle']='active';return{'units':_0x510f43['map'](({unitID:_0x4dded5,status:_0x125db1})=>({'unitID':_0x4dded5,'status':_0x125db1}))};}async['commitChangeset'](_0x57d66b,_0x580b69){this['_assertOpen']();let {changeset:_0x271db0}=_0x580b69,_0x24ea82=this['_activeUnit'](_0x271db0['unitID']);if(!_0x24ea82)throw o('Cannot\x20commit\x20to\x20a\x20missing\x20unit');if(_0x24ea82['record']['headRevision']!==_0x271db0['revision']-0x1)return{'status':'revision-mismatch','actualHeadRevision':_0x24ea82['record']['headRevision']};let _0x15b537=c(_0x271db0);return _0x24ea82['changesets']['set'](_0x15b537['revision'],_0x15b537),_0x24ea82['record']={..._0x24ea82['record'],'headRevision':_0x15b537['revision']},{'status':'committed','changeset':c(_0x15b537),'headRevision':_0x24ea82['record']['headRevision']};}async['saveSnapshot'](_0x67b2c2,_0x444aaa){this['_assertOpen']();let _0x3c4837=this['_activeUnit'](_0x444aaa['snapshot']['unitID']);if(!_0x3c4837)throw o('Cannot\x20snapshot\x20a\x20missing\x20unit');if(_0x444aaa['snapshot']['type']!==_0x3c4837['record']['type']||_0x444aaa['snapshot']['rev']<0x1||_0x444aaa['snapshot']['rev']>_0x3c4837['record']['headRevision'])throw a('Snapshot\x20does\x20not\x20match\x20the\x20stored\x20unit\x20head');let _0x251855=c(_0x444aaa['snapshot']);i(_0x3c4837,r(_0x444aaa['sheetBlocks'])),_0x3c4837['snapshots']['set'](_0x251855['rev'],_0x251855);}async['getSheetBlock'](_0x53d2e3,_0x521256,_0x305fd6){this['_assertOpen']();let _0x558030=this['_activeUnit'](_0x521256)?.['sheetBlocks']['get'](_0x305fd6);return _0x558030?c(_0x558030):null;}async['dispose'](){this['_disposed']||(this['_disposed']=!0x0,this['_units']['clear'](),this['_tombstones']['clear']());}['_activeUnit'](_0x42d75b){let _0x9e399a=this['_units']['get'](_0x42d75b);return _0x9e399a?.['lifecycle']==='active'?_0x9e399a:void 0x0;}['_assertOpen'](){if(this['_disposed'])throw new e['CollabError']('INTERNAL_ERROR','Memory\x20Database\x20Adapter\x20is\x20disposed');}};function n(_0x3832bc){let {record:_0x501b50,snapshot:_0x3f3815}=_0x3832bc;if(_0x501b50['headRevision']!==0x1||_0x3f3815['rev']!==0x1||_0x3f3815['unitID']!==_0x501b50['unitID']||_0x3f3815['type']!==_0x501b50['type'])throw a('Initial\x20unit\x20record\x20and\x20snapshot\x20must\x20match\x20at\x20revision\x201');}function r(_0x22183e){let _0x570799=new Map();for(let _0x37975a of _0x22183e??[])_0x570799['set'](_0x37975a['id'],c(_0x37975a));return _0x570799;}function i(_0x3c63e3,_0x1510e0){for(let [_0x4f6073,_0x1f0cea]of _0x1510e0)_0x3c63e3['sheetBlocks']['set'](_0x4f6073,_0x1f0cea);}function a(_0xb559a8){return new e['CollabError']('INVALID_REQUEST',_0xb559a8);}function o(_0x251f8e){return new e['CollabError']('UNIT_NOT_FOUND',_0x251f8e);}function s(_0x8b1e78){return[...new Set(_0x8b1e78)];}function c(_0x16b7fb){return structuredClone(_0x16b7fb);}exports['MemoryDatabaseAdapter']=t;
|
package/dist/index.d.ts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { CommitChangesetInput, CommitChangesetResult, CreateUnitDatabaseInput, CreateUnitDatabaseResult, DatabaseContext, DeleteUnitsDatabaseInput, DeleteUnitsDatabaseResult, IDatabaseAdapter, RecoverUnitsDatabaseInput, RecoverUnitsDatabaseResult, SaveSnapshotInput, SnapshotInfo, UnitRecord } from "@univerjs-pro/collaboration-service";
|
|
2
2
|
import { IChangeset, ISheetBlock, ISnapshot } from "@univerjs/protocol";
|
|
3
3
|
|
|
4
4
|
//#region src/memory-database-adapter.d.ts
|
|
@@ -10,11 +10,14 @@ declare class MemoryDatabaseAdapter implements IDatabaseAdapter {
|
|
|
10
10
|
getSnapshot(_context: DatabaseContext, unitID: string, options?: {
|
|
11
11
|
readonly revision?: number;
|
|
12
12
|
}): Promise<ISnapshot | null>;
|
|
13
|
+
getSnapshotInfo(_context: DatabaseContext, unitID: string, options?: {
|
|
14
|
+
readonly revision?: number;
|
|
15
|
+
}): Promise<SnapshotInfo | null>;
|
|
16
|
+
private _getSnapshot;
|
|
13
17
|
getChangesets(_context: DatabaseContext, unitID: string, range: {
|
|
14
18
|
readonly from: number;
|
|
15
|
-
readonly to
|
|
16
|
-
}): Promise<
|
|
17
|
-
getSubmission(_context: DatabaseContext, unitID: string, sid: string, reqId: number): Promise<IChangeset | null>;
|
|
19
|
+
readonly to?: number;
|
|
20
|
+
}): Promise<readonly IChangeset[] | null>;
|
|
18
21
|
createUnit(_context: DatabaseContext, input: CreateUnitDatabaseInput): Promise<CreateUnitDatabaseResult>;
|
|
19
22
|
deleteUnits(_context: DatabaseContext, input: DeleteUnitsDatabaseInput): Promise<DeleteUnitsDatabaseResult>;
|
|
20
23
|
recoverUnits(_context: DatabaseContext, input: RecoverUnitsDatabaseInput): Promise<RecoverUnitsDatabaseResult>;
|
package/dist/index.mjs
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
|
|
1
|
+
const _0x4615ee=_0x4705;(function(_0x2ca01c,_0x1ea91f){const _0x99e431=_0x4705,_0x10b85e=_0x2ca01c();while(!![]){try{const _0x58d75a=parseInt(_0x99e431(0xce))/0x1+parseInt(_0x99e431(0xcd))/0x2*(-parseInt(_0x99e431(0xc8))/0x3)+-parseInt(_0x99e431(0xcf))/0x4+parseInt(_0x99e431(0xc9))/0x5+-parseInt(_0x99e431(0xcb))/0x6+-parseInt(_0x99e431(0xca))/0x7*(-parseInt(_0x99e431(0xc6))/0x8)+parseInt(_0x99e431(0xc7))/0x9;if(_0x58d75a===_0x1ea91f)break;else _0x10b85e['push'](_0x10b85e['shift']());}catch(_0x586293){_0x10b85e['push'](_0x10b85e['shift']());}}}(_0x2b37,0xd2b30));function _0x2b37(){const _0x11d9a9=['10839690IHzyAf','137625XgBhKM','2679560AAXGdz','91ALmpTJ','87324rGZMaG','MemoryDatabaseAdapter','70oxDNXx','672806xtxXlN','2937148HjbFIB','494992HSskwM'];_0x2b37=function(){return _0x11d9a9;};return _0x2b37();}function _0x4705(_0x14c905,_0x24e93b){_0x14c905=_0x14c905-0xc6;const _0x2b3754=_0x2b37();let _0x470566=_0x2b3754[_0x14c905];return _0x470566;}import _0x2517e8 from'./index.cjs';const facadeExport0=_0x2517e8[_0x4615ee(0xcc)];export{facadeExport0 as MemoryDatabaseAdapter};
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@univerjs-pro/collaboration-database-memory",
|
|
3
3
|
"type": "module",
|
|
4
|
-
"version": "1.0.0-
|
|
4
|
+
"version": "1.0.0-rc.0",
|
|
5
5
|
"main": "./dist/index.cjs",
|
|
6
6
|
"module": "./dist/index.mjs",
|
|
7
7
|
"types": "./dist/index.d.ts",
|
|
@@ -16,10 +16,7 @@
|
|
|
16
16
|
"dist"
|
|
17
17
|
],
|
|
18
18
|
"dependencies": {
|
|
19
|
-
"@univerjs-pro/collaboration-service": "1.0.0-
|
|
20
|
-
"@univerjs/protocol": "1.0.0-
|
|
21
|
-
},
|
|
22
|
-
"publishConfig": {
|
|
23
|
-
"access": "public"
|
|
19
|
+
"@univerjs-pro/collaboration-service": "1.0.0-rc.0",
|
|
20
|
+
"@univerjs/protocol": "1.0.0-rc.0"
|
|
24
21
|
}
|
|
25
|
-
}
|
|
22
|
+
}
|