@verdant-web/common 1.11.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.
Files changed (241) hide show
  1. package/LICENSE +21 -0
  2. package/dist/cjs/EventSubscriber.d.ts +17 -0
  3. package/dist/cjs/EventSubscriber.js +67 -0
  4. package/dist/cjs/EventSubscriber.js.map +1 -0
  5. package/dist/cjs/baseline.d.ts +5 -0
  6. package/dist/cjs/baseline.js +3 -0
  7. package/dist/cjs/baseline.js.map +1 -0
  8. package/dist/cjs/batching.d.ts +41 -0
  9. package/dist/cjs/batching.js +89 -0
  10. package/dist/cjs/batching.js.map +1 -0
  11. package/dist/cjs/files.d.ts +19 -0
  12. package/dist/cjs/files.js +19 -0
  13. package/dist/cjs/files.js.map +1 -0
  14. package/dist/cjs/files.test.d.ts +1 -0
  15. package/dist/cjs/files.test.js +81 -0
  16. package/dist/cjs/files.test.js.map +1 -0
  17. package/dist/cjs/index.d.ts +18 -0
  18. package/dist/cjs/index.js +36 -0
  19. package/dist/cjs/index.js.map +1 -0
  20. package/dist/cjs/indexes.d.ts +14 -0
  21. package/dist/cjs/indexes.js +116 -0
  22. package/dist/cjs/indexes.js.map +1 -0
  23. package/dist/cjs/indexes.test.d.ts +1 -0
  24. package/dist/cjs/indexes.test.js +128 -0
  25. package/dist/cjs/indexes.test.js.map +1 -0
  26. package/dist/cjs/migration.d.ts +98 -0
  27. package/dist/cjs/migration.js +128 -0
  28. package/dist/cjs/migration.js.map +1 -0
  29. package/dist/cjs/oids.d.ts +87 -0
  30. package/dist/cjs/oids.js +375 -0
  31. package/dist/cjs/oids.js.map +1 -0
  32. package/dist/cjs/oids.test.d.ts +1 -0
  33. package/dist/cjs/oids.test.js +282 -0
  34. package/dist/cjs/oids.test.js.map +1 -0
  35. package/dist/cjs/operation.d.ts +139 -0
  36. package/dist/cjs/operation.js +533 -0
  37. package/dist/cjs/operation.js.map +1 -0
  38. package/dist/cjs/operation.test.d.ts +1 -0
  39. package/dist/cjs/operation.test.js +827 -0
  40. package/dist/cjs/operation.test.js.map +1 -0
  41. package/dist/cjs/patch.d.ts +26 -0
  42. package/dist/cjs/patch.js +227 -0
  43. package/dist/cjs/patch.js.map +1 -0
  44. package/dist/cjs/presence.d.ts +27 -0
  45. package/dist/cjs/presence.js +3 -0
  46. package/dist/cjs/presence.js.map +1 -0
  47. package/dist/cjs/protocol.d.ts +145 -0
  48. package/dist/cjs/protocol.js +4 -0
  49. package/dist/cjs/protocol.js.map +1 -0
  50. package/dist/cjs/refs.d.ts +5 -0
  51. package/dist/cjs/refs.js +22 -0
  52. package/dist/cjs/refs.js.map +1 -0
  53. package/dist/cjs/replica.d.ts +28 -0
  54. package/dist/cjs/replica.js +29 -0
  55. package/dist/cjs/replica.js.map +1 -0
  56. package/dist/cjs/schema/defaults.d.ts +4 -0
  57. package/dist/cjs/schema/defaults.js +72 -0
  58. package/dist/cjs/schema/defaults.js.map +1 -0
  59. package/dist/cjs/schema/defaults.test.d.ts +1 -0
  60. package/dist/cjs/schema/defaults.test.js +21 -0
  61. package/dist/cjs/schema/defaults.test.js.map +1 -0
  62. package/dist/cjs/schema/index.d.ts +8 -0
  63. package/dist/cjs/schema/index.js +29 -0
  64. package/dist/cjs/schema/index.js.map +1 -0
  65. package/dist/cjs/schema/indexFilters.d.ts +6 -0
  66. package/dist/cjs/schema/indexFilters.js +31 -0
  67. package/dist/cjs/schema/indexFilters.js.map +1 -0
  68. package/dist/cjs/schema/types/collection.d.ts +51 -0
  69. package/dist/cjs/schema/types/collection.js +3 -0
  70. package/dist/cjs/schema/types/collection.js.map +1 -0
  71. package/dist/cjs/schema/types/compounds.d.ts +12 -0
  72. package/dist/cjs/schema/types/compounds.js +3 -0
  73. package/dist/cjs/schema/types/compounds.js.map +1 -0
  74. package/dist/cjs/schema/types/fields.d.ts +59 -0
  75. package/dist/cjs/schema/types/fields.js +3 -0
  76. package/dist/cjs/schema/types/fields.js.map +1 -0
  77. package/dist/cjs/schema/types/filters.d.ts +29 -0
  78. package/dist/cjs/schema/types/filters.js +3 -0
  79. package/dist/cjs/schema/types/filters.js.map +1 -0
  80. package/dist/cjs/schema/types/shapes.d.ts +21 -0
  81. package/dist/cjs/schema/types/shapes.js +3 -0
  82. package/dist/cjs/schema/types/shapes.js.map +1 -0
  83. package/dist/cjs/schema/types/synthetics.d.ts +28 -0
  84. package/dist/cjs/schema/types/synthetics.js +3 -0
  85. package/dist/cjs/schema/types/synthetics.js.map +1 -0
  86. package/dist/cjs/schema/types.d.ts +18 -0
  87. package/dist/cjs/schema/types.js +23 -0
  88. package/dist/cjs/schema/types.js.map +1 -0
  89. package/dist/cjs/timestamp.d.ts +48 -0
  90. package/dist/cjs/timestamp.js +244 -0
  91. package/dist/cjs/timestamp.js.map +1 -0
  92. package/dist/cjs/timestamp.test.d.ts +1 -0
  93. package/dist/cjs/timestamp.test.js +94 -0
  94. package/dist/cjs/timestamp.test.js.map +1 -0
  95. package/dist/cjs/undo.d.ts +3 -0
  96. package/dist/cjs/undo.js +199 -0
  97. package/dist/cjs/undo.js.map +1 -0
  98. package/dist/cjs/utils.d.ts +15 -0
  99. package/dist/cjs/utils.js +128 -0
  100. package/dist/cjs/utils.js.map +1 -0
  101. package/dist/cjs/utils.test.d.ts +1 -0
  102. package/dist/cjs/utils.test.js +37 -0
  103. package/dist/cjs/utils.test.js.map +1 -0
  104. package/dist/esm/EventSubscriber.d.ts +17 -0
  105. package/dist/esm/EventSubscriber.js +63 -0
  106. package/dist/esm/EventSubscriber.js.map +1 -0
  107. package/dist/esm/baseline.d.ts +5 -0
  108. package/dist/esm/baseline.js +2 -0
  109. package/dist/esm/baseline.js.map +1 -0
  110. package/dist/esm/batching.d.ts +41 -0
  111. package/dist/esm/batching.js +84 -0
  112. package/dist/esm/batching.js.map +1 -0
  113. package/dist/esm/files.d.ts +19 -0
  114. package/dist/esm/files.js +13 -0
  115. package/dist/esm/files.js.map +1 -0
  116. package/dist/esm/files.test.d.ts +1 -0
  117. package/dist/esm/files.test.js +79 -0
  118. package/dist/esm/files.test.js.map +1 -0
  119. package/dist/esm/index.d.ts +18 -0
  120. package/dist/esm/index.js +16 -0
  121. package/dist/esm/index.js.map +1 -0
  122. package/dist/esm/indexes.d.ts +14 -0
  123. package/dist/esm/indexes.js +106 -0
  124. package/dist/esm/indexes.js.map +1 -0
  125. package/dist/esm/indexes.test.d.ts +1 -0
  126. package/dist/esm/indexes.test.js +126 -0
  127. package/dist/esm/indexes.test.js.map +1 -0
  128. package/dist/esm/migration.d.ts +98 -0
  129. package/dist/esm/migration.js +122 -0
  130. package/dist/esm/migration.js.map +1 -0
  131. package/dist/esm/oids.d.ts +87 -0
  132. package/dist/esm/oids.js +348 -0
  133. package/dist/esm/oids.js.map +1 -0
  134. package/dist/esm/oids.test.d.ts +1 -0
  135. package/dist/esm/oids.test.js +280 -0
  136. package/dist/esm/oids.test.js.map +1 -0
  137. package/dist/esm/operation.d.ts +139 -0
  138. package/dist/esm/operation.js +518 -0
  139. package/dist/esm/operation.js.map +1 -0
  140. package/dist/esm/operation.test.d.ts +1 -0
  141. package/dist/esm/operation.test.js +825 -0
  142. package/dist/esm/operation.test.js.map +1 -0
  143. package/dist/esm/patch.d.ts +26 -0
  144. package/dist/esm/patch.js +223 -0
  145. package/dist/esm/patch.js.map +1 -0
  146. package/dist/esm/presence.d.ts +27 -0
  147. package/dist/esm/presence.js +2 -0
  148. package/dist/esm/presence.js.map +1 -0
  149. package/dist/esm/protocol.d.ts +145 -0
  150. package/dist/esm/protocol.js +3 -0
  151. package/dist/esm/protocol.js.map +1 -0
  152. package/dist/esm/refs.d.ts +5 -0
  153. package/dist/esm/refs.js +17 -0
  154. package/dist/esm/refs.js.map +1 -0
  155. package/dist/esm/replica.d.ts +28 -0
  156. package/dist/esm/replica.js +26 -0
  157. package/dist/esm/replica.js.map +1 -0
  158. package/dist/esm/schema/defaults.d.ts +4 -0
  159. package/dist/esm/schema/defaults.js +66 -0
  160. package/dist/esm/schema/defaults.js.map +1 -0
  161. package/dist/esm/schema/defaults.test.d.ts +1 -0
  162. package/dist/esm/schema/defaults.test.js +19 -0
  163. package/dist/esm/schema/defaults.test.js.map +1 -0
  164. package/dist/esm/schema/index.d.ts +8 -0
  165. package/dist/esm/schema/index.js +10 -0
  166. package/dist/esm/schema/index.js.map +1 -0
  167. package/dist/esm/schema/indexFilters.d.ts +6 -0
  168. package/dist/esm/schema/indexFilters.js +23 -0
  169. package/dist/esm/schema/indexFilters.js.map +1 -0
  170. package/dist/esm/schema/types/collection.d.ts +51 -0
  171. package/dist/esm/schema/types/collection.js +2 -0
  172. package/dist/esm/schema/types/collection.js.map +1 -0
  173. package/dist/esm/schema/types/compounds.d.ts +12 -0
  174. package/dist/esm/schema/types/compounds.js +2 -0
  175. package/dist/esm/schema/types/compounds.js.map +1 -0
  176. package/dist/esm/schema/types/fields.d.ts +59 -0
  177. package/dist/esm/schema/types/fields.js +2 -0
  178. package/dist/esm/schema/types/fields.js.map +1 -0
  179. package/dist/esm/schema/types/filters.d.ts +29 -0
  180. package/dist/esm/schema/types/filters.js +2 -0
  181. package/dist/esm/schema/types/filters.js.map +1 -0
  182. package/dist/esm/schema/types/shapes.d.ts +21 -0
  183. package/dist/esm/schema/types/shapes.js +2 -0
  184. package/dist/esm/schema/types/shapes.js.map +1 -0
  185. package/dist/esm/schema/types/synthetics.d.ts +28 -0
  186. package/dist/esm/schema/types/synthetics.js +2 -0
  187. package/dist/esm/schema/types/synthetics.js.map +1 -0
  188. package/dist/esm/schema/types.d.ts +18 -0
  189. package/dist/esm/schema/types.js +7 -0
  190. package/dist/esm/schema/types.js.map +1 -0
  191. package/dist/esm/timestamp.d.ts +48 -0
  192. package/dist/esm/timestamp.js +229 -0
  193. package/dist/esm/timestamp.js.map +1 -0
  194. package/dist/esm/timestamp.test.d.ts +1 -0
  195. package/dist/esm/timestamp.test.js +92 -0
  196. package/dist/esm/timestamp.test.js.map +1 -0
  197. package/dist/esm/undo.d.ts +3 -0
  198. package/dist/esm/undo.js +195 -0
  199. package/dist/esm/undo.js.map +1 -0
  200. package/dist/esm/utils.d.ts +15 -0
  201. package/dist/esm/utils.js +114 -0
  202. package/dist/esm/utils.js.map +1 -0
  203. package/dist/esm/utils.test.d.ts +1 -0
  204. package/dist/esm/utils.test.js +35 -0
  205. package/dist/esm/utils.test.js.map +1 -0
  206. package/dist/tsconfig-cjs.tsbuildinfo +1 -0
  207. package/dist/tsconfig.tsbuildinfo +1 -0
  208. package/package.json +38 -0
  209. package/src/EventSubscriber.ts +81 -0
  210. package/src/baseline.ts +9 -0
  211. package/src/batching.ts +135 -0
  212. package/src/files.ts +34 -0
  213. package/src/index.ts +26 -0
  214. package/src/indexes.test.ts +158 -0
  215. package/src/indexes.ts +151 -0
  216. package/src/migration.ts +391 -0
  217. package/src/oids.test.ts +395 -0
  218. package/src/oids.ts +442 -0
  219. package/src/operation.test.ts +966 -0
  220. package/src/operation.ts +755 -0
  221. package/src/patch.ts +277 -0
  222. package/src/presence.ts +29 -0
  223. package/src/protocol.ts +184 -0
  224. package/src/refs.ts +16 -0
  225. package/src/replica.ts +29 -0
  226. package/src/schema/defaults.test.ts +19 -0
  227. package/src/schema/defaults.ts +72 -0
  228. package/src/schema/index.ts +28 -0
  229. package/src/schema/indexFilters.ts +49 -0
  230. package/src/schema/types/collection.ts +133 -0
  231. package/src/schema/types/compounds.ts +33 -0
  232. package/src/schema/types/fields.ts +85 -0
  233. package/src/schema/types/filters.ts +39 -0
  234. package/src/schema/types/shapes.ts +83 -0
  235. package/src/schema/types/synthetics.ts +45 -0
  236. package/src/schema/types.ts +28 -0
  237. package/src/timestamp.test.ts +113 -0
  238. package/src/timestamp.ts +284 -0
  239. package/src/undo.ts +205 -0
  240. package/src/utils.test.ts +38 -0
  241. package/src/utils.ts +137 -0
@@ -0,0 +1,244 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.OLD_deserializeHlcTimestamp = exports.OLD_serializeHlcTimestamp = exports.convertOldHlcTimestamp = exports.deserializeHlcTimestamp = exports.serializeHlcTimestamp = exports.HybridLogicalClockTimestampProvider = exports.NaiveTimestampProvider = exports.OLD_encodeVersion = exports.encodeVersion = void 0;
7
+ const cuid_1 = __importDefault(require("cuid"));
8
+ const VERSION_BLOCK_LENGTH = 4;
9
+ const ENCODING_NUMBER_RADIX = 36;
10
+ function encodeVersion(version) {
11
+ return version
12
+ .toString(ENCODING_NUMBER_RADIX)
13
+ .padStart(VERSION_BLOCK_LENGTH, '0');
14
+ }
15
+ exports.encodeVersion = encodeVersion;
16
+ function OLD_encodeVersion(version) {
17
+ return version.toString().padStart(6, '0');
18
+ }
19
+ exports.OLD_encodeVersion = OLD_encodeVersion;
20
+ class NaiveTimestampProvider {
21
+ constructor() {
22
+ this.counter = 0;
23
+ this.now = (version) => {
24
+ return (encodeVersion(version) + Date.now().toString() + '-' + this.counter++);
25
+ };
26
+ this.update = () => {
27
+ this.counter = 0;
28
+ };
29
+ this.zero = (version) => {
30
+ return encodeVersion(version) + '0' + '-' + this.counter++;
31
+ };
32
+ this.getWallClockTime = (timestamp) => {
33
+ return parseInt(timestamp.slice(VERSION_BLOCK_LENGTH).split('-')[0], 10);
34
+ };
35
+ }
36
+ }
37
+ exports.NaiveTimestampProvider = NaiveTimestampProvider;
38
+ class HybridLogicalClockTimestampProvider {
39
+ constructor() {
40
+ this.latest = {
41
+ time: Date.now(),
42
+ counter: 0,
43
+ node: generateNodeId(),
44
+ };
45
+ this.zeroCounter = 0;
46
+ this.now = (version) => {
47
+ this.latest = getHlcNow(this.latest);
48
+ return this.get(version, this.latest);
49
+ };
50
+ /**
51
+ * @deprecated - use now() instead and update to latest format
52
+ */
53
+ this.OLD_now = (version) => {
54
+ this.latest = getHlcNow(this.latest);
55
+ return OLD_encodeVersion(version) + OLD_serializeHlcTimestamp(this.latest);
56
+ };
57
+ /** Get the current timer state. Does not increment counter. */
58
+ this.timerState = () => {
59
+ return this.latest;
60
+ };
61
+ this.update = (remoteTimestamp) => {
62
+ // strip version from remote timestamp
63
+ const hlcString = remoteTimestamp.slice(VERSION_BLOCK_LENGTH);
64
+ this.latest = updateFromRemote(this.latest, deserializeHlcTimestamp(hlcString));
65
+ };
66
+ this.get = (version, raw) => {
67
+ return encodeVersion(version) + serializeHlcTimestamp(raw);
68
+ };
69
+ this.zero = (version) => {
70
+ return (encodeVersion(version) +
71
+ serializeHlcTimestamp({
72
+ time: 0,
73
+ // to keep zero timestamps unique, we use a counter here as well
74
+ counter: this.zeroCounter++,
75
+ node: this.latest.node,
76
+ }));
77
+ };
78
+ this.getWallClockTime = (timestamp) => {
79
+ return deserializeHlcTimestamp(timestamp.slice(VERSION_BLOCK_LENGTH)).time;
80
+ };
81
+ }
82
+ }
83
+ exports.HybridLogicalClockTimestampProvider = HybridLogicalClockTimestampProvider;
84
+ class ClockDriftError extends Error {
85
+ constructor(...args) {
86
+ super();
87
+ this.type = 'ClockDriftError';
88
+ this.message = ['maximum clock drift exceeded'].concat(args).join(' ');
89
+ }
90
+ }
91
+ class OverflowError extends Error {
92
+ constructor() {
93
+ super();
94
+ this.type = 'OverflowError';
95
+ this.message = 'timestamp counter overflow';
96
+ }
97
+ }
98
+ const COUNTER_BLOCK_LENGTH = 4;
99
+ const NODE_BLOCK_LENGTH = 7;
100
+ const MAX_CLOCK_DRIFT = 60 * 1000;
101
+ // 9 base36 characters should last until the year 5000
102
+ // when encoding a unix MS timestamp
103
+ const TIME_BLOCK_LENGTH = 9;
104
+ function generateNodeId() {
105
+ return cuid_1.default
106
+ .slug()
107
+ .padStart(NODE_BLOCK_LENGTH, '0')
108
+ .slice(0, NODE_BLOCK_LENGTH);
109
+ }
110
+ function serializeHlcTimestamp(ts) {
111
+ // string representation of the time
112
+ const dateString = new Date(ts.time)
113
+ .getTime()
114
+ .toString(ENCODING_NUMBER_RADIX)
115
+ .padStart(TIME_BLOCK_LENGTH, '0');
116
+ // counter, 336, padded to 4 characters
117
+ const counter = ts.counter
118
+ .toString(ENCODING_NUMBER_RADIX)
119
+ .padStart(COUNTER_BLOCK_LENGTH, '0');
120
+ // node id padded to 16 characters
121
+ const node = ts.node.padStart(NODE_BLOCK_LENGTH, '0');
122
+ return `${dateString}${counter}${node}`;
123
+ }
124
+ exports.serializeHlcTimestamp = serializeHlcTimestamp;
125
+ function getHlcNow(prev) {
126
+ const wallTime = Date.now();
127
+ // pick prev's time if it's later than our local device
128
+ const newWallTime = Math.max(prev.time, wallTime);
129
+ // reset counter if wall time changed
130
+ const newCounter = prev.time === newWallTime ? prev.counter + 1 : 0;
131
+ // check for drift
132
+ if (newWallTime - wallTime > MAX_CLOCK_DRIFT) {
133
+ throw new ClockDriftError(newWallTime, wallTime, MAX_CLOCK_DRIFT);
134
+ }
135
+ // check for counter overflow (max is 4 bytes)
136
+ if (newCounter > 65535) {
137
+ throw new OverflowError();
138
+ }
139
+ return {
140
+ time: newWallTime,
141
+ counter: newCounter,
142
+ node: prev.node,
143
+ };
144
+ }
145
+ function updateFromRemote(local, remote) {
146
+ const wallTime = Date.now();
147
+ // pick remote's time if it's later than our local device
148
+ const newTime = Math.max(wallTime, Math.max(local.time, remote.time));
149
+ const maxCounter = Math.max(local.counter, remote.counter);
150
+ let newCounter;
151
+ // if all clocks are the same, increment the counter
152
+ if (local.time === newTime && remote.time === newTime) {
153
+ newCounter = maxCounter + 1;
154
+ }
155
+ // if local time is the same as new time, increment our local counter
156
+ else if (local.time === newTime) {
157
+ newCounter = local.counter + 1;
158
+ }
159
+ // if remote time is the same as new time, increment remote counter
160
+ else if (remote.time === newTime) {
161
+ newCounter = remote.counter + 1;
162
+ }
163
+ // otherwise, reset the counter
164
+ else {
165
+ newCounter = 0;
166
+ }
167
+ // check for drift
168
+ if (newTime - wallTime > MAX_CLOCK_DRIFT) {
169
+ throw new ClockDriftError(newTime, wallTime, MAX_CLOCK_DRIFT);
170
+ }
171
+ if (newCounter > 65535) {
172
+ throw new OverflowError();
173
+ }
174
+ return {
175
+ time: newTime,
176
+ counter: newCounter,
177
+ node: local.node,
178
+ };
179
+ }
180
+ function deserializeHlcTimestamp(clock) {
181
+ const dateString = clock.slice(0, TIME_BLOCK_LENGTH);
182
+ const counter = clock.slice(TIME_BLOCK_LENGTH, TIME_BLOCK_LENGTH + COUNTER_BLOCK_LENGTH);
183
+ const node = clock.slice(TIME_BLOCK_LENGTH + COUNTER_BLOCK_LENGTH);
184
+ const time = parseInt(dateString, ENCODING_NUMBER_RADIX);
185
+ const counterNum = parseInt(counter, ENCODING_NUMBER_RADIX);
186
+ if (isNaN(time) || isNaN(counterNum)) {
187
+ throw new Error('invalid clock format');
188
+ }
189
+ return {
190
+ time,
191
+ counter: counterNum,
192
+ node,
193
+ };
194
+ }
195
+ exports.deserializeHlcTimestamp = deserializeHlcTimestamp;
196
+ function removeLeadingZeroes(str) {
197
+ return str.replace(/^0+/, '');
198
+ }
199
+ /**
200
+ * Below, converters for old-style timestamps are defined.
201
+ * These are for migrating older clients to the new format.
202
+ */
203
+ /**
204
+ * Converts a timestamp from the old format to the new format.
205
+ */
206
+ function convertOldHlcTimestamp(ts) {
207
+ const versionBlock = ts.slice(0, 6);
208
+ // no jokes please
209
+ const clockBlock = ts.slice(6);
210
+ const deserialized = OLD_deserializeHlcTimestamp(clockBlock);
211
+ // version was base 10 and now is base 36
212
+ const versionNumber = parseInt(versionBlock, 10);
213
+ const encodedVersion = encodeVersion(versionNumber);
214
+ return encodedVersion + serializeHlcTimestamp(deserialized);
215
+ }
216
+ exports.convertOldHlcTimestamp = convertOldHlcTimestamp;
217
+ function OLD_serializeHlcTimestamp(ts) {
218
+ // ISO string representation of the time
219
+ const dateString = new Date(ts.time).toISOString();
220
+ // counter, base16, padded to 4 characters
221
+ const counter = ts.counter.toString(16).toUpperCase().padStart(4, '0');
222
+ // node id padded to 16 characters
223
+ const node = ts.node.padStart(16, '0');
224
+ return `${dateString}-${counter}-${node}`;
225
+ }
226
+ exports.OLD_serializeHlcTimestamp = OLD_serializeHlcTimestamp;
227
+ function OLD_deserializeHlcTimestamp(clock) {
228
+ // ISO string representation of the time
229
+ const dateString = clock.slice(0, 24);
230
+ const counter = clock.slice(25, 25 + 4);
231
+ const node = clock.slice(25 + 4 + 1);
232
+ const time = new Date(dateString).getTime();
233
+ const counterNum = parseInt(counter, 16);
234
+ if (isNaN(time) || isNaN(counterNum)) {
235
+ throw new Error('invalid clock format');
236
+ }
237
+ return {
238
+ time,
239
+ counter: counterNum,
240
+ node: node.slice(node.length - 7),
241
+ };
242
+ }
243
+ exports.OLD_deserializeHlcTimestamp = OLD_deserializeHlcTimestamp;
244
+ //# sourceMappingURL=timestamp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../src/timestamp.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,94 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const vitest_1 = require("vitest");
4
+ const timestamp_js_1 = require("./timestamp.js");
5
+ (0, vitest_1.describe)('the hybrid logical clock', () => {
6
+ (0, vitest_1.it)('always produces incrementing timestamps', async () => {
7
+ const clock = new timestamp_js_1.HybridLogicalClockTimestampProvider();
8
+ let prev = clock.now(1);
9
+ clock.update(prev);
10
+ let now;
11
+ for (let i = 0; i < 1000; i++) {
12
+ now = clock.now(1);
13
+ (0, vitest_1.expect)(now > prev, `${now} not later than ${prev}`).toBe(true);
14
+ clock.update(now);
15
+ prev = now;
16
+ }
17
+ let time = new Date().getTime();
18
+ for (let i = 0; i < 1000; i++) {
19
+ vitest_1.vitest.setSystemTime(time++);
20
+ now = clock.now(1);
21
+ (0, vitest_1.expect)(now > prev, `${now} not later than ${prev}`).toBe(true);
22
+ clock.update(now);
23
+ prev = now;
24
+ }
25
+ });
26
+ (0, vitest_1.it)('groups blocks of time by version', () => {
27
+ const clock = new timestamp_js_1.HybridLogicalClockTimestampProvider();
28
+ let prev = clock.now(1);
29
+ clock.update(prev);
30
+ let now;
31
+ for (let i = 0; i < 10; i++) {
32
+ now = clock.now(1);
33
+ (0, vitest_1.expect)(now > prev, `${now} not later than ${prev}`).toBe(true);
34
+ clock.update(now);
35
+ prev = now;
36
+ }
37
+ for (let i = 0; i < 10; i++) {
38
+ now = clock.now(2);
39
+ (0, vitest_1.expect)(now > prev, `${now} not later than ${prev}`).toBe(true);
40
+ clock.update(now);
41
+ prev = now;
42
+ }
43
+ const startOfVersion2 = now;
44
+ // jump back to 1
45
+ prev = clock.now(1);
46
+ clock.update(prev);
47
+ for (let i = 0; i < 10; i++) {
48
+ now = clock.now(1);
49
+ (0, vitest_1.expect)(now > prev, `${now} not later than ${prev}`).toBe(true);
50
+ (0, vitest_1.expect)(now < startOfVersion2, `${now} not earlier than ${startOfVersion2}`).toBe(true);
51
+ clock.update(now);
52
+ prev = now;
53
+ }
54
+ });
55
+ (0, vitest_1.it)('is shorter than the previous format', () => {
56
+ const clock = new timestamp_js_1.HybridLogicalClockTimestampProvider();
57
+ (0, vitest_1.expect)(clock.now(1).length).toBeLessThan(clock.OLD_now(1).length);
58
+ });
59
+ (0, vitest_1.it)('correctly converts old to new format', () => {
60
+ const clock = new timestamp_js_1.HybridLogicalClockTimestampProvider();
61
+ const oldFormat = clock.OLD_now(1);
62
+ const value = clock.timerState();
63
+ const converted = (0, timestamp_js_1.convertOldHlcTimestamp)(oldFormat);
64
+ const newFormat = clock.get(1, value);
65
+ (0, vitest_1.expect)(converted).toEqual(newFormat);
66
+ });
67
+ // this is mostly to verify as I move to the new format.
68
+ // instead of attempting a distributed migration of timestamps, it
69
+ // will be easier that the new format just acts as always in the
70
+ // future of the old one. this will only mess with offline clients,
71
+ // but nobody is using verdant but me yet at time of this change (2022-12-19)
72
+ // which is kind of why I'm doing it now anyway.
73
+ (0, vitest_1.it)('old format always comes before new format', () => {
74
+ const clock = new timestamp_js_1.HybridLogicalClockTimestampProvider();
75
+ const newFormat = clock.now(1);
76
+ const oldFormat = clock.OLD_now(1);
77
+ (0, vitest_1.expect)(oldFormat < newFormat).toBe(true);
78
+ // even far-future old timestamps are before new timestamps
79
+ const oldFormat2 = (0, timestamp_js_1.OLD_serializeHlcTimestamp)({
80
+ counter: 999,
81
+ node: '9876543210',
82
+ time: new Date(3000, 1, 1).getTime(),
83
+ });
84
+ (0, vitest_1.expect)((0, timestamp_js_1.OLD_encodeVersion)(1) + oldFormat2 < newFormat).toBe(true);
85
+ });
86
+ (0, vitest_1.it)('decodes timestamps', () => {
87
+ const time = new Date();
88
+ vitest_1.vitest.setSystemTime(time);
89
+ const clock = new timestamp_js_1.HybridLogicalClockTimestampProvider();
90
+ const now = clock.now(1);
91
+ (0, vitest_1.expect)(clock.getWallClockTime(now)).toEqual(time.getTime());
92
+ });
93
+ });
94
+ //# sourceMappingURL=timestamp.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"timestamp.test.js","sourceRoot":"","sources":["../../src/timestamp.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import { ObjectIdentifier } from './oids.js';
2
+ import { Operation } from './operation.js';
3
+ export declare function getUndoOperations(oid: ObjectIdentifier, initial: any, operations: Operation[], getNow: () => string): Operation[];
@@ -0,0 +1,199 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getUndoOperations = void 0;
4
+ const operation_js_1 = require("./operation.js");
5
+ const utils_js_1 = require("./utils.js");
6
+ function getUndoOperations(oid, initial, operations, getNow) {
7
+ if (initial === undefined) {
8
+ // if the initial state is nothing, then the undo is to delete everything.
9
+ // there's nothing else to worry about!
10
+ return [
11
+ {
12
+ oid,
13
+ timestamp: getNow(),
14
+ data: {
15
+ op: 'delete',
16
+ },
17
+ },
18
+ ];
19
+ }
20
+ // otherwise, traverse the operations one by one,
21
+ // applying them, and using the prior state to determine
22
+ // what the undo operation is.
23
+ let state = (0, utils_js_1.cloneDeep)(initial);
24
+ const undoOperations = [];
25
+ for (const operation of operations) {
26
+ const undo = getUndoOperation(oid, state, operation, getNow);
27
+ undoOperations.unshift(...undo);
28
+ (0, operation_js_1.applyPatch)(state, operation.data);
29
+ }
30
+ return undoOperations;
31
+ }
32
+ exports.getUndoOperations = getUndoOperations;
33
+ function getUndoOperation(oid, initial, operation, getNow) {
34
+ const data = operation.data;
35
+ switch (data.op) {
36
+ case 'set':
37
+ case 'remove':
38
+ return [
39
+ {
40
+ oid,
41
+ timestamp: getNow(),
42
+ data: {
43
+ op: 'set',
44
+ name: data.name,
45
+ value: initial[data.name],
46
+ },
47
+ },
48
+ ];
49
+ case 'list-insert':
50
+ return [
51
+ {
52
+ oid,
53
+ timestamp: getNow(),
54
+ data: {
55
+ op: 'list-delete',
56
+ index: data.index,
57
+ count: 1,
58
+ },
59
+ },
60
+ ];
61
+ case 'list-delete':
62
+ return [
63
+ {
64
+ oid,
65
+ timestamp: getNow(),
66
+ data: {
67
+ op: 'list-insert',
68
+ index: data.index,
69
+ values: initial.slice(data.index, data.count),
70
+ },
71
+ },
72
+ ];
73
+ case 'list-move-by-ref':
74
+ return [
75
+ {
76
+ oid,
77
+ timestamp: getNow(),
78
+ data: {
79
+ op: 'list-move-by-ref',
80
+ value: data.value,
81
+ index: initial.indexOf(data.value),
82
+ },
83
+ },
84
+ ];
85
+ case 'list-move-by-index':
86
+ return [
87
+ {
88
+ oid,
89
+ timestamp: getNow(),
90
+ data: {
91
+ op: 'list-move-by-index',
92
+ from: data.to,
93
+ to: data.from,
94
+ },
95
+ },
96
+ ];
97
+ case 'delete':
98
+ return [
99
+ {
100
+ oid,
101
+ timestamp: getNow(),
102
+ data: {
103
+ op: 'initialize',
104
+ value: initial,
105
+ },
106
+ },
107
+ ];
108
+ case 'list-push':
109
+ return [
110
+ {
111
+ oid,
112
+ timestamp: getNow(),
113
+ data: {
114
+ op: 'list-remove',
115
+ value: data.value,
116
+ // best heuristic here - remove the last instance of the item.
117
+ only: 'last',
118
+ },
119
+ },
120
+ ];
121
+ case 'list-remove':
122
+ if (data.only === 'last') {
123
+ const index = initial.lastIndexOf(data.value);
124
+ return [
125
+ {
126
+ oid,
127
+ timestamp: getNow(),
128
+ data: {
129
+ op: 'list-insert',
130
+ index,
131
+ values: [data.value],
132
+ },
133
+ },
134
+ ];
135
+ }
136
+ else if (data.only === 'first') {
137
+ const index = initial.indexOf(data.value);
138
+ return [
139
+ {
140
+ oid,
141
+ timestamp: getNow(),
142
+ data: {
143
+ op: 'list-insert',
144
+ index,
145
+ values: [data.value],
146
+ },
147
+ },
148
+ ];
149
+ }
150
+ else {
151
+ // find all instances of value and restore them at their
152
+ // original index
153
+ const indexesOfValue = [];
154
+ let index = initial.indexOf(data.value);
155
+ while (index !== -1) {
156
+ indexesOfValue.push(index);
157
+ index = initial.indexOf(data.value, index + 1);
158
+ }
159
+ return indexesOfValue.map((index) => ({
160
+ oid,
161
+ timestamp: getNow(),
162
+ data: {
163
+ op: 'list-insert',
164
+ index,
165
+ value: data.value,
166
+ },
167
+ }));
168
+ }
169
+ case 'list-add':
170
+ // this one is kind of ambiguous. in theory the set may have
171
+ // already included the value and so no change happened. but
172
+ // basically we infer the intent is to remove what was meant
173
+ // to be added by this change.
174
+ return [
175
+ {
176
+ oid,
177
+ timestamp: getNow(),
178
+ data: {
179
+ op: 'list-remove',
180
+ value: data.value,
181
+ only: 'last',
182
+ },
183
+ },
184
+ ];
185
+ case 'initialize':
186
+ return [
187
+ {
188
+ oid,
189
+ timestamp: getNow(),
190
+ data: {
191
+ op: 'delete',
192
+ },
193
+ },
194
+ ];
195
+ default:
196
+ throw new Error(`Cannot undo operation type: ${data.op}`);
197
+ }
198
+ }
199
+ //# sourceMappingURL=undo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"undo.js","sourceRoot":"","sources":["../../src/undo.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ export declare function take<T extends object, Keys extends keyof T>(obj: T, keys: Keys[]): Pick<T, Keys>;
2
+ export declare function omit<T extends object, Keys extends keyof T>(obj: T, keys: Keys[]): Omit<T, Keys>;
3
+ export declare function getSortedIndex<T>(array: T[], insert: T, compare: (a: T, b: T) => number): number;
4
+ /**
5
+ * Consistently stringifies an object regardless
6
+ * of key insertion order
7
+ */
8
+ export declare function stableStringify(obj: any): string;
9
+ export declare function cloneDeep<T>(obj: T): T;
10
+ export declare function hashObject(obj: any): string;
11
+ export declare function isObject(obj: any): any;
12
+ export declare function roughSizeOfObject(object: any): number;
13
+ export declare function assert(condition: any, message?: string): asserts condition;
14
+ export declare function generateId(length?: number): string;
15
+ export declare function findLastIndex<T>(array: T[], predicate: (item: T) => boolean): number;