@adobe/data 0.6.3 → 0.7.2
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/dist/ecs/database/applied/applied-database.d.ts +47 -0
- package/dist/ecs/database/applied/applied-database.js +22 -0
- package/dist/ecs/database/applied/applied-database.js.map +1 -0
- package/dist/ecs/database/applied/applied-entry.d.ts +30 -0
- package/dist/ecs/database/applied/applied-entry.js +84 -0
- package/dist/ecs/database/applied/applied-entry.js.map +1 -0
- package/dist/ecs/database/applied/create-applied-database.d.ts +8 -0
- package/dist/ecs/database/applied/create-applied-database.js +266 -0
- package/dist/ecs/database/applied/create-applied-database.js.map +1 -0
- package/dist/ecs/database/applied/create-applied-database.test.d.ts +1 -0
- package/dist/ecs/database/applied/create-applied-database.test.js +94 -0
- package/dist/ecs/database/applied/create-applied-database.test.js.map +1 -0
- package/dist/ecs/database/create-applied-database.d.ts +49 -0
- package/dist/ecs/database/create-applied-database.js +275 -0
- package/dist/ecs/database/create-applied-database.js.map +1 -0
- package/dist/ecs/database/create-database.d.ts +1 -1
- package/dist/ecs/database/create-database.js +123 -198
- package/dist/ecs/database/create-database.js.map +1 -1
- package/dist/ecs/database/create-database.test.js +155 -684
- package/dist/ecs/database/create-database.test.js.map +1 -1
- package/dist/ecs/database/database.d.ts +1 -0
- package/dist/ecs/database/index.d.ts +6 -0
- package/dist/ecs/database/index.js +6 -0
- package/dist/ecs/database/index.js.map +1 -1
- package/dist/ecs/database/observe-select-entities.performance.test.js +6 -5
- package/dist/ecs/database/observe-select-entities.performance.test.js.map +1 -1
- package/dist/ecs/database/observed/create-observed-database.d.ts +7 -0
- package/dist/ecs/database/observed/create-observed-database.js +154 -0
- package/dist/ecs/database/observed/create-observed-database.js.map +1 -0
- package/dist/ecs/database/observed/create-observed-database.test.d.ts +1 -0
- package/dist/ecs/database/observed/create-observed-database.test.js +557 -0
- package/dist/ecs/database/observed/create-observed-database.test.js.map +1 -0
- package/dist/ecs/database/observed/observed-database.d.ts +36 -0
- package/dist/ecs/database/observed/observed-database.js +19 -0
- package/dist/ecs/database/observed/observed-database.js.map +1 -0
- package/dist/ecs/database/reconciling/applied-database.d.ts +47 -0
- package/dist/ecs/database/reconciling/applied-database.js +22 -0
- package/dist/ecs/database/reconciling/applied-database.js.map +1 -0
- package/dist/ecs/database/reconciling/applied-entry.d.ts +30 -0
- package/dist/ecs/database/reconciling/applied-entry.js +84 -0
- package/dist/ecs/database/reconciling/applied-entry.js.map +1 -0
- package/dist/ecs/database/reconciling/create-applied-database.d.ts +8 -0
- package/dist/ecs/database/reconciling/create-applied-database.js +266 -0
- package/dist/ecs/database/reconciling/create-applied-database.js.map +1 -0
- package/dist/ecs/database/reconciling/create-applied-database.test.d.ts +1 -0
- package/dist/ecs/database/reconciling/create-applied-database.test.js +94 -0
- package/dist/ecs/database/reconciling/create-applied-database.test.js.map +1 -0
- package/dist/ecs/database/reconciling/create-reconciling-database.d.ts +8 -0
- package/dist/ecs/database/reconciling/create-reconciling-database.js +146 -0
- package/dist/ecs/database/reconciling/create-reconciling-database.js.map +1 -0
- package/dist/ecs/database/reconciling/create-reconciling-database.test.d.ts +1 -0
- package/dist/ecs/database/reconciling/create-reconciling-database.test.js +94 -0
- package/dist/ecs/database/reconciling/create-reconciling-database.test.js.map +1 -0
- package/dist/ecs/database/reconciling/reconciling-database.d.ts +21 -0
- package/dist/ecs/database/reconciling/reconciling-database.js +22 -0
- package/dist/ecs/database/reconciling/reconciling-database.js.map +1 -0
- package/dist/ecs/database/reconciling/reconciling-entry.d.ts +30 -0
- package/dist/ecs/database/reconciling/reconciling-entry.js +88 -0
- package/dist/ecs/database/reconciling/reconciling-entry.js.map +1 -0
- package/dist/ecs/database/replicate.d.ts +9 -0
- package/dist/ecs/database/replicate.js +66 -0
- package/dist/ecs/database/replicate.js.map +1 -0
- package/dist/ecs/database/replicate.test.d.ts +1 -0
- package/dist/ecs/database/replicate.test.js +235 -0
- package/dist/ecs/database/replicate.test.js.map +1 -0
- package/dist/ecs/database/transactional-store/create-transactional-store.test.js +20 -0
- package/dist/ecs/database/transactional-store/create-transactional-store.test.js.map +1 -1
- package/dist/ecs/database/transactional-store/patch-entity-values.js +4 -1
- package/dist/ecs/database/transactional-store/patch-entity-values.js.map +1 -1
- package/dist/ecs/store/core/core.d.ts +2 -2
- package/dist/ecs/store/core/create-core.js +5 -2
- package/dist/ecs/store/core/create-core.js.map +1 -1
- package/dist/functions/serialization/index.d.ts +1 -0
- package/dist/functions/serialization/index.js +1 -0
- package/dist/functions/serialization/index.js.map +1 -1
- package/dist/functions/serialization/serialize-to-json.d.ts +9 -0
- package/dist/functions/serialization/serialize-to-json.js +161 -0
- package/dist/functions/serialization/serialize-to-json.js.map +1 -0
- package/dist/functions/serialization/serialize-to-json.test.d.ts +1 -0
- package/dist/functions/serialization/serialize-to-json.test.js +244 -0
- package/dist/functions/serialization/serialize-to-json.test.js.map +1 -0
- package/dist/tsconfig.tsbuildinfo +1 -1
- package/package.json +1 -1
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
/*MIT License
|
|
2
|
+
|
|
3
|
+
© Copyright 2025 Adobe. All rights reserved.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to do so, subject to the following conditions:
|
|
10
|
+
|
|
11
|
+
The above copyright notice and this permission notice shall be included in all
|
|
12
|
+
copies or substantial portions of the Software.
|
|
13
|
+
|
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
15
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
16
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
17
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
18
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
19
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
20
|
+
SOFTWARE.*/
|
|
21
|
+
import { applyOperations } from "../transactional-store/apply-operations.js";
|
|
22
|
+
import { ReconcilingEntryOps, serializeReconcilingEntry, deserializeReconcilingEntry, } from "./reconciling-entry.js";
|
|
23
|
+
import { createObservedDatabase } from "../observed/create-observed-database.js";
|
|
24
|
+
export function createReconcilingDatabase(store, transactionDeclarations) {
|
|
25
|
+
const observedDatabase = createObservedDatabase(store);
|
|
26
|
+
const { execute, observe, resources, toData: observedToData, fromData: observedFromData, ...storeMethods } = observedDatabase;
|
|
27
|
+
const reconcilingEntries = [];
|
|
28
|
+
const rollbackRange = (startIndex) => {
|
|
29
|
+
for (let i = reconcilingEntries.length - 1; i >= startIndex; i--) {
|
|
30
|
+
const entry = reconcilingEntries[i];
|
|
31
|
+
if (entry.result) {
|
|
32
|
+
execute(t => applyOperations(t, entry.result.undo), { transient: true });
|
|
33
|
+
entry.result = undefined;
|
|
34
|
+
}
|
|
35
|
+
}
|
|
36
|
+
};
|
|
37
|
+
const replayRange = (startIndex) => {
|
|
38
|
+
let lastResult;
|
|
39
|
+
for (let i = startIndex; i < reconcilingEntries.length; i++) {
|
|
40
|
+
const entry = reconcilingEntries[i];
|
|
41
|
+
const result = execute(t => entry.transaction(t, entry.args), { transient: ReconcilingEntryOps.isTransient(entry) });
|
|
42
|
+
entry.result = result;
|
|
43
|
+
lastResult = result;
|
|
44
|
+
}
|
|
45
|
+
return lastResult;
|
|
46
|
+
};
|
|
47
|
+
const applyEnvelope = (envelope) => {
|
|
48
|
+
const transaction = transactionDeclarations[envelope.name];
|
|
49
|
+
if (!transaction) {
|
|
50
|
+
throw new Error(`Unknown transaction: ${envelope.name}`);
|
|
51
|
+
}
|
|
52
|
+
const isCancellation = envelope.time === 0;
|
|
53
|
+
let startIndex = reconcilingEntries.length;
|
|
54
|
+
const existingIndex = reconcilingEntries.findIndex(entry => entry.id === envelope.id);
|
|
55
|
+
if (existingIndex >= 0) {
|
|
56
|
+
startIndex = existingIndex;
|
|
57
|
+
const existingEntry = reconcilingEntries[existingIndex];
|
|
58
|
+
if (existingEntry.result) {
|
|
59
|
+
execute(t => applyOperations(t, existingEntry.result.undo), { transient: true });
|
|
60
|
+
existingEntry.result = undefined;
|
|
61
|
+
}
|
|
62
|
+
reconcilingEntries.splice(existingIndex, 1);
|
|
63
|
+
}
|
|
64
|
+
if (isCancellation) {
|
|
65
|
+
if (startIndex < reconcilingEntries.length) {
|
|
66
|
+
rollbackRange(startIndex);
|
|
67
|
+
replayRange(startIndex);
|
|
68
|
+
}
|
|
69
|
+
return undefined;
|
|
70
|
+
}
|
|
71
|
+
const entry = {
|
|
72
|
+
id: envelope.id,
|
|
73
|
+
name: envelope.name,
|
|
74
|
+
transaction: transaction,
|
|
75
|
+
args: envelope.args,
|
|
76
|
+
time: envelope.time,
|
|
77
|
+
result: undefined,
|
|
78
|
+
};
|
|
79
|
+
const insertIndex = ReconcilingEntryOps.findInsertIndex(reconcilingEntries, entry);
|
|
80
|
+
reconcilingEntries.splice(insertIndex, 0, entry);
|
|
81
|
+
const rebuildIndex = Math.min(startIndex, insertIndex);
|
|
82
|
+
rollbackRange(rebuildIndex);
|
|
83
|
+
replayRange(rebuildIndex);
|
|
84
|
+
const insertedEntry = reconcilingEntries.find(e => e.id === envelope.id);
|
|
85
|
+
const latestResult = insertedEntry?.result;
|
|
86
|
+
return latestResult;
|
|
87
|
+
};
|
|
88
|
+
const removeEntryAtIndex = (index, { rollback }) => {
|
|
89
|
+
if (index < 0 || index >= reconcilingEntries.length) {
|
|
90
|
+
return;
|
|
91
|
+
}
|
|
92
|
+
if (rollback) {
|
|
93
|
+
rollbackRange(index);
|
|
94
|
+
}
|
|
95
|
+
reconcilingEntries.splice(index, 1);
|
|
96
|
+
if (rollback) {
|
|
97
|
+
replayRange(index);
|
|
98
|
+
}
|
|
99
|
+
};
|
|
100
|
+
const cancelEntry = (id) => {
|
|
101
|
+
const index = reconcilingEntries.findIndex(entry => entry.id === id);
|
|
102
|
+
if (index === -1) {
|
|
103
|
+
return;
|
|
104
|
+
}
|
|
105
|
+
removeEntryAtIndex(index, { rollback: true });
|
|
106
|
+
};
|
|
107
|
+
const serializeReconcilingEntries = () => reconcilingEntries
|
|
108
|
+
.filter(entry => ReconcilingEntryOps.isTransient(entry))
|
|
109
|
+
.map(entry => serializeReconcilingEntry(entry));
|
|
110
|
+
const reconcilingDatabase = {
|
|
111
|
+
...storeMethods,
|
|
112
|
+
resources,
|
|
113
|
+
execute,
|
|
114
|
+
observe,
|
|
115
|
+
toData: () => ({
|
|
116
|
+
store: observedToData(),
|
|
117
|
+
appliedEntries: serializeReconcilingEntries(),
|
|
118
|
+
}),
|
|
119
|
+
fromData: (data) => {
|
|
120
|
+
let storeData = data;
|
|
121
|
+
let serializedEntries;
|
|
122
|
+
if (typeof data === "object" && data !== null && "store" in data) {
|
|
123
|
+
const payload = data;
|
|
124
|
+
storeData = payload.store;
|
|
125
|
+
serializedEntries = Array.isArray(payload.appliedEntries) ? payload.appliedEntries : undefined;
|
|
126
|
+
}
|
|
127
|
+
observedFromData(storeData);
|
|
128
|
+
reconcilingEntries.length = 0;
|
|
129
|
+
if (serializedEntries) {
|
|
130
|
+
for (const serializedEntry of serializedEntries) {
|
|
131
|
+
const transaction = transactionDeclarations[serializedEntry.name];
|
|
132
|
+
if (!transaction) {
|
|
133
|
+
continue;
|
|
134
|
+
}
|
|
135
|
+
const entry = deserializeReconcilingEntry(serializedEntry, transaction);
|
|
136
|
+
reconcilingEntries.push(entry);
|
|
137
|
+
}
|
|
138
|
+
reconcilingEntries.sort(ReconcilingEntryOps.compare);
|
|
139
|
+
}
|
|
140
|
+
},
|
|
141
|
+
apply: applyEnvelope,
|
|
142
|
+
cancel: cancelEntry,
|
|
143
|
+
};
|
|
144
|
+
return reconcilingDatabase;
|
|
145
|
+
}
|
|
146
|
+
//# sourceMappingURL=create-reconciling-database.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-reconciling-database.js","sourceRoot":"","sources":["../../../../src/ecs/database/reconciling/create-reconciling-database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;WAmBW;AAIX,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAO7E,OAAO,EAEH,mBAAmB,EAEnB,yBAAyB,EACzB,2BAA2B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAQjF,MAAM,UAAU,yBAAyB,CAMrC,KAAqB,EACrB,uBAA2B;IAI3B,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,EACF,OAAO,EACP,OAAO,EACP,SAAS,EACT,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,gBAAgB,EAC1B,GAAG,YAAY,EAClB,GAAG,gBAAgB,CAAC;IAErB,MAAM,kBAAkB,GAAgC,EAAE,CAAC;IAE3D,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,EAAE;QACzC,KAAK,IAAI,CAAC,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/D,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACf,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,MAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC1E,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC;YAC7B,CAAC;QACL,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,UAAkB,EAAE,EAAE;QACvC,IAAI,UAA4C,CAAC;QACjD,KAAK,IAAI,CAAC,GAAG,UAAU,EAAE,CAAC,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACrH,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YACtB,UAAU,GAAG,MAAM,CAAC;QACxB,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,CAAC,QAA8C,EAAoC,EAAE;QACvG,MAAM,WAAW,GAAG,uBAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wBAAwB,QAAQ,CAAC,IAAc,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC;QAE3C,IAAI,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC;QAE3C,MAAM,aAAa,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YACrB,UAAU,GAAG,aAAa,CAAC;YAC3B,MAAM,aAAa,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;YACxD,IAAI,aAAa,CAAC,MAAM,EAAE,CAAC;gBACvB,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,aAAa,CAAC,MAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClF,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC;YACrC,CAAC;YACD,kBAAkB,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,cAAc,EAAE,CAAC;YACjB,IAAI,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC;gBACzC,aAAa,CAAC,UAAU,CAAC,CAAC;gBAC1B,WAAW,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,MAAM,KAAK,GAA8B;YACrC,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,WAAW,EAAE,WAAsE;YACnF,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,MAAM,EAAE,SAAS;SACpB,CAAC;QAEF,MAAM,WAAW,GAAG,mBAAmB,CAAC,eAAe,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;QACnF,kBAAkB,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAEvD,aAAa,CAAC,YAAY,CAAC,CAAC;QAC5B,WAAW,CAAC,YAAY,CAAC,CAAC;QAE1B,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,YAAY,GAAG,aAAa,EAAE,MAAM,CAAC;QAC3C,OAAO,YAAY,CAAC;IACxB,CAAC,CAAC;IAEF,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,EAAE,QAAQ,EAAyB,EAAE,EAAE;QAC9E,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,kBAAkB,CAAC,MAAM,EAAE,CAAC;YAClD,OAAO;QACX,CAAC;QACD,IAAI,QAAQ,EAAE,CAAC;YACX,aAAa,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,kBAAkB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACpC,IAAI,QAAQ,EAAE,CAAC;YACX,WAAW,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACL,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,EAAE;QAC/B,MAAM,KAAK,GAAG,kBAAkB,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACrE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,OAAO;QACX,CAAC;QACD,kBAAkB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,MAAM,2BAA2B,GAAG,GAAG,EAAE,CACrC,kBAAkB;SACb,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;SACvD,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,CAAC;IAExD,MAAM,mBAAmB,GAAqC;QAC1D,GAAG,YAAY;QACf,SAAS;QACT,OAAO;QACP,OAAO;QACP,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACX,KAAK,EAAE,cAAc,EAAE;YACvB,cAAc,EAAE,2BAA2B,EAAE;SAChD,CAAC;QACF,QAAQ,EAAE,CAAC,IAAa,EAAE,EAAE;YACxB,IAAI,SAAS,GAAY,IAAI,CAAC;YAC9B,IAAI,iBAA2D,CAAC;YAEhE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAK,IAAgC,EAAE,CAAC;gBAC5F,MAAM,OAAO,GAAG,IAA0C,CAAC;gBAC3D,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;gBAC1B,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;YACnG,CAAC;YAED,gBAAgB,CAAC,SAAS,CAAC,CAAC;YAE5B,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC;YAE9B,IAAI,iBAAiB,EAAE,CAAC;gBACpB,KAAK,MAAM,eAAe,IAAI,iBAAiB,EAAE,CAAC;oBAC9C,MAAM,WAAW,GAAG,uBAAuB,CAAC,eAAe,CAAC,IAAgB,CAAC,CAAC;oBAC9E,IAAI,CAAC,WAAW,EAAE,CAAC;wBACf,SAAS;oBACb,CAAC;oBACD,MAAM,KAAK,GAAG,2BAA2B,CACrC,eAAe,EACf,WAAsE,CACzE,CAAC;oBACF,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBACD,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACzD,CAAC;QACL,CAAC;QACD,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,WAAW;KACtB,CAAC;IAEF,OAAO,mBAAmB,CAAC;AAC/B,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { describe, it, expect } from "vitest";
|
|
2
|
+
import { createReconcilingDatabase } from "./create-reconciling-database.js";
|
|
3
|
+
import { createStore } from "../../store/create-store.js";
|
|
4
|
+
const createTestReconcilingDatabase = () => {
|
|
5
|
+
const store = createStore({
|
|
6
|
+
position: {
|
|
7
|
+
type: "object",
|
|
8
|
+
properties: {
|
|
9
|
+
x: { type: "number" },
|
|
10
|
+
y: { type: "number" },
|
|
11
|
+
z: { type: "number" },
|
|
12
|
+
},
|
|
13
|
+
required: ["x", "y", "z"],
|
|
14
|
+
additionalProperties: false,
|
|
15
|
+
},
|
|
16
|
+
name: { type: "string" },
|
|
17
|
+
}, {}, {
|
|
18
|
+
PositionNameEntity: ["position", "name"],
|
|
19
|
+
});
|
|
20
|
+
const transactions = {
|
|
21
|
+
createPositionNameEntity(t, args) {
|
|
22
|
+
return t.archetypes.PositionNameEntity.insert(args);
|
|
23
|
+
},
|
|
24
|
+
updatePositionNameEntity(t, args) {
|
|
25
|
+
t.update(args.entity, { name: args.name });
|
|
26
|
+
},
|
|
27
|
+
};
|
|
28
|
+
return createReconcilingDatabase(store, transactions);
|
|
29
|
+
};
|
|
30
|
+
const readEntityNames = (reconciling) => reconciling
|
|
31
|
+
.select(["name"])
|
|
32
|
+
.map(entity => reconciling.read(entity)?.name)
|
|
33
|
+
.filter((name) => Boolean(name));
|
|
34
|
+
describe("createReconcilingDatabase", () => {
|
|
35
|
+
it("replaces a transient entry when the same id yields again", () => {
|
|
36
|
+
const reconciling = createTestReconcilingDatabase();
|
|
37
|
+
reconciling.apply({
|
|
38
|
+
id: 1,
|
|
39
|
+
name: "createPositionNameEntity",
|
|
40
|
+
args: { position: { x: 0, y: 0, z: 0 }, name: "First" },
|
|
41
|
+
time: -1,
|
|
42
|
+
});
|
|
43
|
+
reconciling.apply({
|
|
44
|
+
id: 1,
|
|
45
|
+
name: "createPositionNameEntity",
|
|
46
|
+
args: { position: { x: 1, y: 1, z: 1 }, name: "Second" },
|
|
47
|
+
time: -2,
|
|
48
|
+
});
|
|
49
|
+
expect(readEntityNames(reconciling)).toEqual(["Second"]);
|
|
50
|
+
const serialized = reconciling.toData();
|
|
51
|
+
expect(serialized.appliedEntries).toHaveLength(1);
|
|
52
|
+
expect(serialized.appliedEntries?.[0]?.args).toEqual({ position: { x: 1, y: 1, z: 1 }, name: "Second" });
|
|
53
|
+
});
|
|
54
|
+
it("removes a transient entry when cancelled after other operations", () => {
|
|
55
|
+
const reconciling = createTestReconcilingDatabase();
|
|
56
|
+
reconciling.apply({
|
|
57
|
+
id: 10,
|
|
58
|
+
name: "createPositionNameEntity",
|
|
59
|
+
args: { position: { x: 0, y: 0, z: 0 }, name: "Transient" },
|
|
60
|
+
time: -1,
|
|
61
|
+
});
|
|
62
|
+
reconciling.apply({
|
|
63
|
+
id: 11,
|
|
64
|
+
name: "createPositionNameEntity",
|
|
65
|
+
args: { position: { x: 5, y: 5, z: 5 }, name: "Committed" },
|
|
66
|
+
time: 2,
|
|
67
|
+
});
|
|
68
|
+
const serializedBefore = reconciling.toData();
|
|
69
|
+
expect(serializedBefore.appliedEntries).toHaveLength(1);
|
|
70
|
+
reconciling.cancel(10);
|
|
71
|
+
expect(readEntityNames(reconciling)).toEqual(["Committed"]);
|
|
72
|
+
const serializedAfter = reconciling.toData();
|
|
73
|
+
expect(serializedAfter.appliedEntries ?? []).toHaveLength(0);
|
|
74
|
+
});
|
|
75
|
+
it("clears transient state after commit confirmation", () => {
|
|
76
|
+
const reconciling = createTestReconcilingDatabase();
|
|
77
|
+
reconciling.apply({
|
|
78
|
+
id: 21,
|
|
79
|
+
name: "createPositionNameEntity",
|
|
80
|
+
args: { position: { x: 1, y: 2, z: 3 }, name: "InFlight" },
|
|
81
|
+
time: -1,
|
|
82
|
+
});
|
|
83
|
+
reconciling.apply({
|
|
84
|
+
id: 21,
|
|
85
|
+
name: "createPositionNameEntity",
|
|
86
|
+
args: { position: { x: 4, y: 5, z: 6 }, name: "Final" },
|
|
87
|
+
time: 5,
|
|
88
|
+
});
|
|
89
|
+
expect(readEntityNames(reconciling)).toEqual(["Final"]);
|
|
90
|
+
const serialized = reconciling.toData();
|
|
91
|
+
expect(serialized.appliedEntries ?? []).toHaveLength(0);
|
|
92
|
+
});
|
|
93
|
+
});
|
|
94
|
+
//# sourceMappingURL=create-reconciling-database.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"create-reconciling-database.test.js","sourceRoot":"","sources":["../../../../src/ecs/database/reconciling/create-reconciling-database.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
import { TransactionResult } from "../transactional-store/index.js";
|
|
2
|
+
import { StringKeyof } from "../../../types/types.js";
|
|
3
|
+
import { Components } from "../../store/components.js";
|
|
4
|
+
import { ArchetypeComponents } from "../../store/archetype-components.js";
|
|
5
|
+
import { TransactionDeclarations } from "../database.js";
|
|
6
|
+
import { ResourceComponents } from "../../store/resource-components.js";
|
|
7
|
+
import { ObservedDatabase } from "../observed/observed-database.js";
|
|
8
|
+
export type TransactionEnvelope<Name extends string = string> = {
|
|
9
|
+
readonly id: number;
|
|
10
|
+
readonly name: Name;
|
|
11
|
+
readonly args: unknown;
|
|
12
|
+
/**
|
|
13
|
+
* Negative time indicates a transient application, positive time a committed one,
|
|
14
|
+
* and zero time cancels any existing entry.
|
|
15
|
+
*/
|
|
16
|
+
readonly time: number;
|
|
17
|
+
};
|
|
18
|
+
export interface ReconcilingDatabase<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>, TD extends TransactionDeclarations<C, R, A>> extends ObservedDatabase<C, R, A> {
|
|
19
|
+
readonly apply: (envelope: TransactionEnvelope<Extract<keyof TD, string>>) => TransactionResult<C> | undefined;
|
|
20
|
+
readonly cancel: (id: number) => void;
|
|
21
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/*MIT License
|
|
2
|
+
|
|
3
|
+
© Copyright 2025 Adobe. All rights reserved.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to do so, subject to the following conditions:
|
|
10
|
+
|
|
11
|
+
The above copyright notice and this permission notice shall be included in all
|
|
12
|
+
copies or substantial portions of the Software.
|
|
13
|
+
|
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
15
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
16
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
17
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
18
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
19
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
20
|
+
SOFTWARE.*/
|
|
21
|
+
export {};
|
|
22
|
+
//# sourceMappingURL=reconciling-database.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reconciling-database.js","sourceRoot":"","sources":["../../../../src/ecs/database/reconciling/reconciling-database.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;WAmBW"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { StringKeyof } from "../../../types/types.js";
|
|
2
|
+
import { Components } from "../../store/components.js";
|
|
3
|
+
import { ResourceComponents } from "../../store/resource-components.js";
|
|
4
|
+
import { ArchetypeComponents } from "../../store/archetype-components.js";
|
|
5
|
+
import { TransactionResult } from "../transactional-store/index.js";
|
|
6
|
+
import { TransactionWriteOperation } from "../transactional-store/transactional-store.js";
|
|
7
|
+
import { Store } from "../../store/index.js";
|
|
8
|
+
import { Entity } from "../../entity.js";
|
|
9
|
+
export type ReconcilingEntry<C extends Components = Components, R extends ResourceComponents = ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>> = ArchetypeComponents<StringKeyof<C>>> = {
|
|
10
|
+
readonly id: number;
|
|
11
|
+
readonly name: string;
|
|
12
|
+
readonly transaction: (store: Store<C, R, A>, args: unknown) => void | Entity;
|
|
13
|
+
readonly args: unknown;
|
|
14
|
+
readonly time: number;
|
|
15
|
+
result?: TransactionResult<C>;
|
|
16
|
+
};
|
|
17
|
+
export declare const ReconcilingEntryOps: {
|
|
18
|
+
isTransient<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entry: ReconcilingEntry<C, R, A>): boolean;
|
|
19
|
+
compare<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(a: ReconcilingEntry<C, R, A>, b: ReconcilingEntry<C, R, A>): number;
|
|
20
|
+
findInsertIndex<C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entries: ReconcilingEntry<C, R, A>[], entry: ReconcilingEntry<C, R, A>): number;
|
|
21
|
+
};
|
|
22
|
+
export type SerializedReconcilingEntry = {
|
|
23
|
+
readonly id: number;
|
|
24
|
+
readonly name: string;
|
|
25
|
+
readonly args: unknown;
|
|
26
|
+
readonly time: number;
|
|
27
|
+
readonly undo?: TransactionWriteOperation<any>[];
|
|
28
|
+
};
|
|
29
|
+
export declare const serializeReconcilingEntry: <C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(entry: ReconcilingEntry<C, R, A>) => SerializedReconcilingEntry;
|
|
30
|
+
export declare const deserializeReconcilingEntry: <C extends Components, R extends ResourceComponents, A extends ArchetypeComponents<StringKeyof<C>>>(serialized: SerializedReconcilingEntry, transaction: (store: Store<C, R, A>, args: unknown) => void | Entity) => ReconcilingEntry<C, R, A>;
|
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
/*MIT License
|
|
2
|
+
|
|
3
|
+
© Copyright 2025 Adobe. All rights reserved.
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to do so, subject to the following conditions:
|
|
10
|
+
|
|
11
|
+
The above copyright notice and this permission notice shall be included in all
|
|
12
|
+
copies or substantial portions of the Software.
|
|
13
|
+
|
|
14
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
15
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
16
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
17
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
18
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
19
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
20
|
+
SOFTWARE.*/
|
|
21
|
+
export const ReconcilingEntryOps = {
|
|
22
|
+
isTransient(entry) {
|
|
23
|
+
return entry.time < 0;
|
|
24
|
+
},
|
|
25
|
+
compare(a, b) {
|
|
26
|
+
const absDiff = Math.abs(a.time) - Math.abs(b.time);
|
|
27
|
+
if (absDiff !== 0) {
|
|
28
|
+
return absDiff;
|
|
29
|
+
}
|
|
30
|
+
const idDiff = a.id - b.id;
|
|
31
|
+
if (idDiff !== 0) {
|
|
32
|
+
return idDiff;
|
|
33
|
+
}
|
|
34
|
+
if (a.name < b.name) {
|
|
35
|
+
return -1;
|
|
36
|
+
}
|
|
37
|
+
if (a.name > b.name) {
|
|
38
|
+
return 1;
|
|
39
|
+
}
|
|
40
|
+
return 0;
|
|
41
|
+
},
|
|
42
|
+
findInsertIndex(entries, entry) {
|
|
43
|
+
let low = 0;
|
|
44
|
+
let high = entries.length;
|
|
45
|
+
while (low < high) {
|
|
46
|
+
const mid = (low + high) >> 1;
|
|
47
|
+
if (ReconcilingEntryOps.compare(entry, entries[mid]) < 0) {
|
|
48
|
+
high = mid;
|
|
49
|
+
}
|
|
50
|
+
else {
|
|
51
|
+
low = mid + 1;
|
|
52
|
+
}
|
|
53
|
+
}
|
|
54
|
+
return low;
|
|
55
|
+
},
|
|
56
|
+
};
|
|
57
|
+
export const serializeReconcilingEntry = (entry) => ({
|
|
58
|
+
id: entry.id,
|
|
59
|
+
name: entry.name,
|
|
60
|
+
args: entry.args,
|
|
61
|
+
time: entry.time,
|
|
62
|
+
undo: entry.result?.undo,
|
|
63
|
+
});
|
|
64
|
+
export const deserializeReconcilingEntry = (serialized, transaction) => {
|
|
65
|
+
const undoOperations = Array.isArray(serialized.undo)
|
|
66
|
+
? serialized.undo
|
|
67
|
+
: undefined;
|
|
68
|
+
return {
|
|
69
|
+
id: Number(serialized.id),
|
|
70
|
+
name: serialized.name,
|
|
71
|
+
transaction,
|
|
72
|
+
args: serialized.args,
|
|
73
|
+
time: serialized.time,
|
|
74
|
+
result: undoOperations
|
|
75
|
+
? {
|
|
76
|
+
value: undefined,
|
|
77
|
+
transient: serialized.time < 0,
|
|
78
|
+
undoable: null,
|
|
79
|
+
redo: [],
|
|
80
|
+
undo: undoOperations,
|
|
81
|
+
changedEntities: new Map(),
|
|
82
|
+
changedComponents: new Set(),
|
|
83
|
+
changedArchetypes: new Set(),
|
|
84
|
+
}
|
|
85
|
+
: undefined,
|
|
86
|
+
};
|
|
87
|
+
};
|
|
88
|
+
//# sourceMappingURL=reconciling-entry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reconciling-entry.js","sourceRoot":"","sources":["../../../../src/ecs/database/reconciling/reconciling-entry.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import { Database } from "./database.js";
|
|
2
|
+
import { Components } from "../store/components.js";
|
|
3
|
+
import { ResourceComponents } from "../store/resource-components.js";
|
|
4
|
+
import { ArchetypeComponents } from "../store/archetype-components.js";
|
|
5
|
+
import { Store } from "../store/index.js";
|
|
6
|
+
import { StringKeyof } from "../../types/types.js";
|
|
7
|
+
import { Entity } from "../entity.js";
|
|
8
|
+
export type ReplicationStop = () => void;
|
|
9
|
+
export declare const replicate: <const C extends Components, const R extends ResourceComponents, const A extends ArchetypeComponents<StringKeyof<C>>, const TC extends Components = C, const TR extends ResourceComponents = R>(database: Database<C, R, A, any>, target: Store<TC, TR, any>, callback?: (operation: "create" | "update" | "delete", source: Entity, target: Entity) => void) => ReplicationStop;
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
/*MIT License
|
|
2
|
+
© Copyright 2025 Adobe. All rights reserved.
|
|
3
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
4
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
5
|
+
in the Software without restriction, including without limitation the rights
|
|
6
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
7
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
8
|
+
furnished to do so, subject to the following conditions:
|
|
9
|
+
The above copyright notice and this permission notice shall be included in all
|
|
10
|
+
copies or substantial portions of the Software.
|
|
11
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
12
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
13
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
14
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
15
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
16
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
17
|
+
SOFTWARE.*/
|
|
18
|
+
export const replicate = (database, target, callback) => {
|
|
19
|
+
const entityMap = new Map();
|
|
20
|
+
const archetypeMap = new Map();
|
|
21
|
+
function getTargetArchetype(sourceArchetype) {
|
|
22
|
+
let targetArchetype = archetypeMap.get(sourceArchetype.id);
|
|
23
|
+
if (!targetArchetype) {
|
|
24
|
+
targetArchetype = target.ensureArchetype(sourceArchetype.components);
|
|
25
|
+
archetypeMap.set(sourceArchetype.id, targetArchetype);
|
|
26
|
+
}
|
|
27
|
+
return targetArchetype;
|
|
28
|
+
}
|
|
29
|
+
;
|
|
30
|
+
// Initialize the resource entity map with the resources from the database
|
|
31
|
+
// And copy the source resources to the target store
|
|
32
|
+
for (const name of Object.keys(database.resources)) {
|
|
33
|
+
const sourceArchetype = database.ensureArchetype(["id", name]);
|
|
34
|
+
const sourceEntity = sourceArchetype.columns.id.get(0);
|
|
35
|
+
const targetArchetype = getTargetArchetype(sourceArchetype);
|
|
36
|
+
const targetEntity = targetArchetype.columns.id.get(0);
|
|
37
|
+
entityMap.set(sourceEntity, targetEntity);
|
|
38
|
+
target.resources[name] = database.resources[name];
|
|
39
|
+
callback?.("update", sourceEntity, targetEntity);
|
|
40
|
+
}
|
|
41
|
+
return database.observe.transactions((transaction) => {
|
|
42
|
+
for (const [sourceEntity, change] of transaction.changedEntities) {
|
|
43
|
+
const existingTargetEntity = entityMap.get(sourceEntity);
|
|
44
|
+
if (change === null) {
|
|
45
|
+
// delete
|
|
46
|
+
target.delete(existingTargetEntity);
|
|
47
|
+
entityMap.delete(sourceEntity);
|
|
48
|
+
callback?.("delete", sourceEntity, existingTargetEntity);
|
|
49
|
+
}
|
|
50
|
+
else if (existingTargetEntity === undefined) {
|
|
51
|
+
// create
|
|
52
|
+
const sourceLocation = database.locate(sourceEntity);
|
|
53
|
+
const targetArchetype = getTargetArchetype(sourceLocation.archetype);
|
|
54
|
+
const newTargetEntity = targetArchetype.insert(change);
|
|
55
|
+
entityMap.set(sourceEntity, newTargetEntity);
|
|
56
|
+
callback?.("create", sourceEntity, newTargetEntity);
|
|
57
|
+
}
|
|
58
|
+
else {
|
|
59
|
+
// update
|
|
60
|
+
target.update(existingTargetEntity, change);
|
|
61
|
+
callback?.("update", sourceEntity, existingTargetEntity);
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
});
|
|
65
|
+
};
|
|
66
|
+
//# sourceMappingURL=replicate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"replicate.js","sourceRoot":"","sources":["../../../src/ecs/database/replicate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;WAgBW;AAcX,MAAM,CAAC,MAAM,SAAS,GAAG,CAOrB,QAAgC,EAChC,MAA0B,EAC1B,QAA8F,EAC/E,EAAE;IAEjB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,GAAG,EAAqD,CAAC;IAElF,SAAS,kBAAkB,CAAC,eAAkF;QAC1G,IAAI,eAAe,GAAG,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,EAAE,CAAC;YACnB,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC,eAAe,CAAC,UAAsE,CAAC,CAAC;YACjI,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,EAAE,eAAe,CAAC,CAAC;QAC1D,CAAC;QACD,OAAO,eAAe,CAAC;IAC3B,CAAC;IAAA,CAAC;IAEF,0EAA0E;IAC1E,oDAAoD;IACpD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAqB,EAAE,CAAC;QACrE,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC,CAAC,IAAI,EAAE,IAAkD,CAAC,CAAC,CAAC;QAC7G,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,eAAe,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;QAC5D,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvD,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;QACzC,MAAM,CAAC,SAAqC,CAAC,IAAc,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzF,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAiC,EAAE,EAAE;QACvE,KAAK,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC,eAAe,EAAE,CAAC;YAC/D,MAAM,oBAAoB,GAAG,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBAClB,SAAS;gBACT,MAAM,CAAC,MAAM,CAAC,oBAAqB,CAAC,CAAC;gBACrC,SAAS,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC/B,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,oBAAqB,CAAC,CAAC;YAC9D,CAAC;iBACI,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;gBAC1C,SAAS;gBACT,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAE,CAAC;gBACtD,MAAM,eAAe,GAAG,kBAAkB,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;gBACrE,MAAM,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC,MAAa,CAAC,CAAC;gBAC9D,SAAS,CAAC,GAAG,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;gBAC7C,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;YACxD,CAAC;iBACI,CAAC;gBACF,SAAS;gBACT,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAa,CAAC,CAAC;gBACnD,QAAQ,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|