@verdant-web/server 2.1.3 → 3.0.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 (198) hide show
  1. package/dist/esm/ClientConnection.d.ts +1 -0
  2. package/dist/esm/ClientConnection.js.map +1 -1
  3. package/dist/esm/Presence.js.map +1 -1
  4. package/dist/esm/Profiles.js.map +1 -1
  5. package/dist/esm/ReplicaKeepaliveTimers.js.map +1 -1
  6. package/dist/esm/Server.d.ts +15 -11
  7. package/dist/esm/Server.js +29 -30
  8. package/dist/esm/Server.js.map +1 -1
  9. package/dist/esm/ServerLibrary.d.ts +10 -17
  10. package/dist/esm/ServerLibrary.js +151 -127
  11. package/dist/esm/ServerLibrary.js.map +1 -1
  12. package/dist/esm/ServerLibrary.test.js +369 -0
  13. package/dist/esm/ServerLibrary.test.js.map +1 -0
  14. package/dist/esm/TokenVerifier.js.map +1 -1
  15. package/dist/esm/files/FileStorage.js.map +1 -1
  16. package/dist/esm/storage/Storage.d.ts +67 -0
  17. package/dist/esm/storage/Storage.js +2 -0
  18. package/dist/esm/storage/Storage.js.map +1 -0
  19. package/dist/esm/storage/index.d.ts +2 -0
  20. package/dist/esm/storage/index.js +3 -0
  21. package/dist/esm/storage/index.js.map +1 -0
  22. package/dist/esm/storage/sql/SqlBaselines.d.ts +22 -0
  23. package/dist/esm/storage/sql/SqlBaselines.js +101 -0
  24. package/dist/esm/storage/sql/SqlBaselines.js.map +1 -0
  25. package/dist/esm/storage/sql/SqlFileMetadata.d.ts +18 -0
  26. package/dist/esm/storage/sql/SqlFileMetadata.js +69 -0
  27. package/dist/esm/storage/sql/SqlFileMetadata.js.map +1 -0
  28. package/dist/esm/storage/sql/SqlOperations.d.ts +19 -0
  29. package/dist/esm/storage/sql/SqlOperations.js +104 -0
  30. package/dist/esm/storage/sql/SqlOperations.js.map +1 -0
  31. package/dist/esm/storage/sql/SqlReplicas.d.ts +32 -0
  32. package/dist/esm/storage/sql/SqlReplicas.js +163 -0
  33. package/dist/esm/storage/sql/SqlReplicas.js.map +1 -0
  34. package/dist/esm/storage/sql/migrations/v1.d.ts +3 -0
  35. package/dist/esm/storage/sql/migrations/v1.js +59 -0
  36. package/dist/esm/storage/sql/migrations/v1.js.map +1 -0
  37. package/dist/esm/storage/sql/migrations.d.ts +5 -0
  38. package/dist/esm/storage/sql/migrations.js +3 -0
  39. package/dist/esm/storage/sql/migrations.js.map +1 -0
  40. package/dist/esm/storage/sql/sqlStorage.d.ts +5 -0
  41. package/dist/esm/storage/sql/sqlStorage.js +43 -0
  42. package/dist/esm/storage/sql/sqlStorage.js.map +1 -0
  43. package/dist/esm/storage/sql/tables.d.ts +40 -0
  44. package/dist/esm/storage/sql/tables.js +2 -0
  45. package/dist/esm/storage/sql/tables.js.map +1 -0
  46. package/dist/esm/types.d.ts +14 -5
  47. package/package.json +20 -14
  48. package/src/Server.ts +37 -43
  49. package/src/ServerLibrary.test.ts +447 -0
  50. package/src/ServerLibrary.ts +239 -163
  51. package/src/storage/Storage.ts +118 -0
  52. package/src/storage/index.ts +2 -0
  53. package/src/storage/sql/SqlBaselines.ts +141 -0
  54. package/src/storage/sql/SqlFileMetadata.ts +94 -0
  55. package/src/storage/sql/SqlOperations.ts +149 -0
  56. package/src/storage/sql/SqlReplicas.ts +234 -0
  57. package/src/storage/sql/migrations/v1.ts +64 -0
  58. package/src/storage/sql/migrations.ts +3 -0
  59. package/src/storage/sql/sqlStorage.ts +59 -0
  60. package/src/storage/sql/tables.ts +45 -0
  61. package/src/types.ts +15 -4
  62. package/bin/server.mjs +0 -115
  63. package/dist/cjs/Baselines.d.ts +0 -16
  64. package/dist/cjs/Baselines.js +0 -128
  65. package/dist/cjs/Baselines.js.map +0 -1
  66. package/dist/cjs/ClientConnection.d.ts +0 -20
  67. package/dist/cjs/ClientConnection.js +0 -139
  68. package/dist/cjs/ClientConnection.js.map +0 -1
  69. package/dist/cjs/MessageSender.d.ts +0 -5
  70. package/dist/cjs/MessageSender.js +0 -3
  71. package/dist/cjs/MessageSender.js.map +0 -1
  72. package/dist/cjs/OperationHistory.d.ts +0 -36
  73. package/dist/cjs/OperationHistory.js +0 -165
  74. package/dist/cjs/OperationHistory.js.map +0 -1
  75. package/dist/cjs/Presence.d.ts +0 -15
  76. package/dist/cjs/Presence.js +0 -60
  77. package/dist/cjs/Presence.js.map +0 -1
  78. package/dist/cjs/Profiles.d.ts +0 -10
  79. package/dist/cjs/Profiles.js +0 -20
  80. package/dist/cjs/Profiles.js.map +0 -1
  81. package/dist/cjs/ReplicaKeepaliveTimers.d.ts +0 -17
  82. package/dist/cjs/ReplicaKeepaliveTimers.js +0 -31
  83. package/dist/cjs/ReplicaKeepaliveTimers.js.map +0 -1
  84. package/dist/cjs/Replicas.d.ts +0 -25
  85. package/dist/cjs/Replicas.js +0 -196
  86. package/dist/cjs/Replicas.js.map +0 -1
  87. package/dist/cjs/Server.d.ts +0 -167
  88. package/dist/cjs/Server.js +0 -552
  89. package/dist/cjs/Server.js.map +0 -1
  90. package/dist/cjs/ServerLibrary.d.ts +0 -65
  91. package/dist/cjs/ServerLibrary.js +0 -505
  92. package/dist/cjs/ServerLibrary.js.map +0 -1
  93. package/dist/cjs/TokenProvider.d.ts +0 -19
  94. package/dist/cjs/TokenProvider.js +0 -27
  95. package/dist/cjs/TokenProvider.js.map +0 -1
  96. package/dist/cjs/TokenVerifier.d.ts +0 -16
  97. package/dist/cjs/TokenVerifier.js +0 -40
  98. package/dist/cjs/TokenVerifier.js.map +0 -1
  99. package/dist/cjs/files/FileMetadata.d.ts +0 -28
  100. package/dist/cjs/files/FileMetadata.js +0 -69
  101. package/dist/cjs/files/FileMetadata.js.map +0 -1
  102. package/dist/cjs/files/FileStorage.d.ts +0 -35
  103. package/dist/cjs/files/FileStorage.js +0 -72
  104. package/dist/cjs/files/FileStorage.js.map +0 -1
  105. package/dist/cjs/index.d.ts +0 -10
  106. package/dist/cjs/index.js +0 -12
  107. package/dist/cjs/index.js.map +0 -1
  108. package/dist/cjs/migrations/v0.d.ts +0 -1
  109. package/dist/cjs/migrations/v0.js +0 -30
  110. package/dist/cjs/migrations/v0.js.map +0 -1
  111. package/dist/cjs/migrations/v1.d.ts +0 -1
  112. package/dist/cjs/migrations/v1.js +0 -32
  113. package/dist/cjs/migrations/v1.js.map +0 -1
  114. package/dist/cjs/migrations/v2.d.ts +0 -1
  115. package/dist/cjs/migrations/v2.js +0 -29
  116. package/dist/cjs/migrations/v2.js.map +0 -1
  117. package/dist/cjs/migrations/v3.d.ts +0 -1
  118. package/dist/cjs/migrations/v3.js +0 -15
  119. package/dist/cjs/migrations/v3.js.map +0 -1
  120. package/dist/cjs/migrations/v4.d.ts +0 -1
  121. package/dist/cjs/migrations/v4.js +0 -9
  122. package/dist/cjs/migrations/v4.js.map +0 -1
  123. package/dist/cjs/migrations/v5.d.ts +0 -2
  124. package/dist/cjs/migrations/v5.js +0 -37
  125. package/dist/cjs/migrations/v5.js.map +0 -1
  126. package/dist/cjs/migrations/v6.d.ts +0 -1
  127. package/dist/cjs/migrations/v6.js +0 -8
  128. package/dist/cjs/migrations/v6.js.map +0 -1
  129. package/dist/cjs/migrations/v7.d.ts +0 -1
  130. package/dist/cjs/migrations/v7.js +0 -10
  131. package/dist/cjs/migrations/v7.js.map +0 -1
  132. package/dist/cjs/migrations.d.ts +0 -6
  133. package/dist/cjs/migrations.js +0 -72
  134. package/dist/cjs/migrations.js.map +0 -1
  135. package/dist/cjs/migrations.test.js +0 -121
  136. package/dist/cjs/migrations.test.js.map +0 -1
  137. package/dist/cjs/types.d.ts +0 -38
  138. package/dist/cjs/types.js +0 -3
  139. package/dist/cjs/types.js.map +0 -1
  140. package/dist/esm/Baselines.d.ts +0 -16
  141. package/dist/esm/Baselines.js +0 -124
  142. package/dist/esm/Baselines.js.map +0 -1
  143. package/dist/esm/OperationHistory.d.ts +0 -36
  144. package/dist/esm/OperationHistory.js +0 -161
  145. package/dist/esm/OperationHistory.js.map +0 -1
  146. package/dist/esm/Replicas.d.ts +0 -25
  147. package/dist/esm/Replicas.js +0 -192
  148. package/dist/esm/Replicas.js.map +0 -1
  149. package/dist/esm/files/FileMetadata.d.ts +0 -28
  150. package/dist/esm/files/FileMetadata.js +0 -65
  151. package/dist/esm/files/FileMetadata.js.map +0 -1
  152. package/dist/esm/migrations/v0.d.ts +0 -1
  153. package/dist/esm/migrations/v0.js +0 -27
  154. package/dist/esm/migrations/v0.js.map +0 -1
  155. package/dist/esm/migrations/v1.d.ts +0 -1
  156. package/dist/esm/migrations/v1.js +0 -29
  157. package/dist/esm/migrations/v1.js.map +0 -1
  158. package/dist/esm/migrations/v2.d.ts +0 -1
  159. package/dist/esm/migrations/v2.js +0 -26
  160. package/dist/esm/migrations/v2.js.map +0 -1
  161. package/dist/esm/migrations/v3.d.ts +0 -1
  162. package/dist/esm/migrations/v3.js +0 -12
  163. package/dist/esm/migrations/v3.js.map +0 -1
  164. package/dist/esm/migrations/v4.d.ts +0 -1
  165. package/dist/esm/migrations/v4.js +0 -6
  166. package/dist/esm/migrations/v4.js.map +0 -1
  167. package/dist/esm/migrations/v5.d.ts +0 -2
  168. package/dist/esm/migrations/v5.js +0 -33
  169. package/dist/esm/migrations/v5.js.map +0 -1
  170. package/dist/esm/migrations/v6.d.ts +0 -1
  171. package/dist/esm/migrations/v6.js +0 -5
  172. package/dist/esm/migrations/v6.js.map +0 -1
  173. package/dist/esm/migrations/v7.d.ts +0 -1
  174. package/dist/esm/migrations/v7.js +0 -7
  175. package/dist/esm/migrations/v7.js.map +0 -1
  176. package/dist/esm/migrations.d.ts +0 -6
  177. package/dist/esm/migrations.js +0 -45
  178. package/dist/esm/migrations.js.map +0 -1
  179. package/dist/esm/migrations.test.d.ts +0 -1
  180. package/dist/esm/migrations.test.js +0 -116
  181. package/dist/esm/migrations.test.js.map +0 -1
  182. package/dist/tsconfig-cjs.tsbuildinfo +0 -1
  183. package/dist/tsconfig.tsbuildinfo +0 -1
  184. package/src/Baselines.ts +0 -198
  185. package/src/OperationHistory.ts +0 -232
  186. package/src/Replicas.ts +0 -274
  187. package/src/files/FileMetadata.ts +0 -112
  188. package/src/migrations/v0.ts +0 -26
  189. package/src/migrations/v1.ts +0 -28
  190. package/src/migrations/v2.ts +0 -26
  191. package/src/migrations/v3.ts +0 -12
  192. package/src/migrations/v4.ts +0 -6
  193. package/src/migrations/v5.ts +0 -49
  194. package/src/migrations/v6.ts +0 -4
  195. package/src/migrations/v7.ts +0 -6
  196. package/src/migrations.test.ts +0 -133
  197. package/src/migrations.ts +0 -61
  198. /package/dist/{cjs/migrations.test.d.ts → esm/ServerLibrary.test.d.ts} +0 -0
@@ -1,31 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ReplicaKeepaliveTimers = void 0;
4
- const common_1 = require("@verdant-web/common");
5
- /**
6
- * A set of timers per-replica which are
7
- * refreshed whenever the replica sends
8
- * a message to the server. If a timer expires,
9
- * the replica is removed from presence. This
10
- * is a failsafe for socket-based replicas but
11
- * essential for pull-based replicas.
12
- */
13
- class ReplicaKeepaliveTimers extends common_1.EventSubscriber {
14
- constructor(timeout = 30 * 1000) {
15
- super();
16
- this.timeout = timeout;
17
- this.timers = new Map();
18
- this.refresh = (libraryId, replicaId) => {
19
- const existing = this.timers.get(replicaId);
20
- if (existing) {
21
- clearTimeout(existing);
22
- }
23
- this.timers.set(replicaId, setTimeout(() => {
24
- this.emit('lost', libraryId, replicaId);
25
- this.timers.delete(replicaId);
26
- }, this.timeout));
27
- };
28
- }
29
- }
30
- exports.ReplicaKeepaliveTimers = ReplicaKeepaliveTimers;
31
- //# sourceMappingURL=ReplicaKeepaliveTimers.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"ReplicaKeepaliveTimers.js","sourceRoot":"","sources":["../../src/ReplicaKeepaliveTimers.ts"],"names":[],"mappings":";;;AAAA,gDAAsD;AAEtD;;;;;;;GAOG;AACH,MAAa,sBAAuB,SAAQ,wBAE1C;IAGD,YAAoB,UAAU,EAAE,GAAG,IAAI;QACtC,KAAK,EAAE,CAAC;QADW,YAAO,GAAP,OAAO,CAAY;QAF/B,WAAM,GAAG,IAAI,GAAG,EAA0B,CAAC;QAMnD,YAAO,GAAG,CAAC,SAAiB,EAAE,SAAiB,EAAE,EAAE;YAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC5C,IAAI,QAAQ,EAAE;gBACb,YAAY,CAAC,QAAQ,CAAC,CAAC;aACvB;YAED,IAAI,CAAC,MAAM,CAAC,GAAG,CACd,SAAS,EACT,UAAU,CAAC,GAAG,EAAE;gBACf,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;gBACxC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAChB,CAAC;QACH,CAAC,CAAC;IAfF,CAAC;CAgBD;AAvBD,wDAuBC"}
@@ -1,25 +0,0 @@
1
- import { Database } from 'better-sqlite3';
2
- import { TokenInfo } from './TokenVerifier.js';
3
- import { ReplicaInfoSpec } from './types.js';
4
- export declare class ReplicaInfos {
5
- private db;
6
- private readonly replicaTruancyMinutes;
7
- constructor(db: Database, replicaTruancyMinutes: number);
8
- get truantCutoff(): number;
9
- get: (libraryId: string, replicaId: string) => ReplicaInfoSpec | null;
10
- getOrCreate: (libraryId: string, replicaId: string, info: TokenInfo) => {
11
- status: 'new' | 'existing' | 'truant';
12
- replicaInfo: ReplicaInfoSpec;
13
- };
14
- getAllNonTruant: (libraryId: string) => ReplicaInfoSpec[];
15
- getAll: (libraryId: string) => ReplicaInfoSpec[];
16
- updateLastSeen: (libraryId: string, replicaId: string) => import("better-sqlite3").RunResult;
17
- updateAcknowledged: (libraryId: string, replicaId: string, timestamp: string) => void;
18
- updateServerOrder: (libraryId: string, replicaId: string, serverOrder: number) => void;
19
- getEarliestAckedServerOrder: (libraryId: string) => number | null;
20
- acknowledgeOperation: (libraryId: string, replicaId: string, timestamp: string) => void;
21
- getGlobalAck: (libraryId: string, onlineReplicaIds?: string[]) => string | undefined;
22
- delete: (libraryId: string, replicaId: string) => import("better-sqlite3").RunResult;
23
- deleteAll: (libraryId: string) => import("better-sqlite3").RunResult;
24
- deleteAllForUser: (libraryId: string, userId: string) => import("better-sqlite3").RunResult;
25
- }
@@ -1,196 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.ReplicaInfos = void 0;
4
- class ReplicaInfos {
5
- constructor(db, replicaTruancyMinutes) {
6
- this.db = db;
7
- this.replicaTruancyMinutes = replicaTruancyMinutes;
8
- this.get = (libraryId, replicaId) => {
9
- const row = this.db
10
- .prepare(`
11
- SELECT * FROM ReplicaInfo
12
- WHERE id = ? AND libraryId = ?
13
- `)
14
- .get(replicaId, libraryId);
15
- if (!row) {
16
- return null;
17
- }
18
- return {
19
- id: row.id,
20
- libraryId: row.libraryId,
21
- clientId: row.clientId,
22
- lastSeenWallClockTime: row.lastSeenWallClockTime,
23
- ackedLogicalTime: row.ackedLogicalTime,
24
- type: row.type,
25
- ackedServerOrder: row.ackedServerOrder,
26
- };
27
- };
28
- this.getOrCreate = (libraryId, replicaId, info) => {
29
- const replicaInfo = this.db
30
- .prepare(`
31
- SELECT * FROM ReplicaInfo
32
- WHERE id = ? AND libraryId = ?
33
- `)
34
- .get(replicaId, libraryId);
35
- if (!replicaInfo) {
36
- this.db
37
- .prepare(`
38
- INSERT INTO ReplicaInfo (id, clientId, libraryId, type)
39
- VALUES (?, ?, ?, ?)
40
- `)
41
- .run(replicaId, info.userId, libraryId, info.type);
42
- return {
43
- status: 'new',
44
- replicaInfo: {
45
- id: replicaId,
46
- clientId: info.userId,
47
- ackedLogicalTime: null,
48
- lastSeenWallClockTime: null,
49
- libraryId: libraryId,
50
- type: info.type,
51
- ackedServerOrder: 0,
52
- },
53
- };
54
- }
55
- if (replicaInfo.type !== info.type) {
56
- // type should be updated if a new token changes it
57
- this.db
58
- .prepare(`
59
- UPDATE ReplicaInfo
60
- SET type = ?
61
- WHERE id = ? AND libraryId = ?
62
- `)
63
- .run(info.type, replicaId, libraryId);
64
- }
65
- if (replicaInfo.clientId !== info.userId) {
66
- throw new Error(`Replica ${replicaId} already exists with a different user ID`);
67
- }
68
- if (replicaInfo.lastSeenWallClockTime &&
69
- replicaInfo.lastSeenWallClockTime < this.truantCutoff) {
70
- return {
71
- status: 'truant',
72
- replicaInfo,
73
- };
74
- }
75
- return {
76
- status: 'existing',
77
- replicaInfo,
78
- };
79
- };
80
- this.getAllNonTruant = (libraryId) => {
81
- return this.db
82
- .prepare(`
83
- SELECT * FROM ReplicaInfo
84
- WHERE libraryId = ? AND lastSeenWallClockTime > ?
85
- `)
86
- .all(libraryId, this.truantCutoff);
87
- };
88
- this.getAll = (libraryId) => {
89
- return this.db
90
- .prepare(`
91
- SELECT * FROM ReplicaInfo
92
- WHERE libraryId = ?
93
- `)
94
- .all(libraryId);
95
- };
96
- this.updateLastSeen = (libraryId, replicaId) => {
97
- const clockTime = new Date().getTime();
98
- return this.db
99
- .prepare(`
100
- UPDATE ReplicaInfo
101
- SET lastSeenWallClockTime = ?
102
- WHERE id = ? AND libraryId = ?
103
- `)
104
- .run(clockTime, replicaId, libraryId);
105
- };
106
- this.updateAcknowledged = (libraryId, replicaId, timestamp) => {
107
- this.db
108
- .prepare(`
109
- UPDATE ReplicaInfo
110
- SET ackedLogicalTime = ?
111
- WHERE id = ? AND libraryId = ?
112
- `)
113
- .run(timestamp, replicaId, libraryId);
114
- };
115
- this.updateServerOrder = (libraryId, replicaId, serverOrder) => {
116
- // only increment the server order, never set it to lower than before
117
- this.db
118
- .prepare(`
119
- UPDATE ReplicaInfo
120
- SET ackedServerOrder = MAX(ackedServerOrder, ?)
121
- WHERE id = ? AND libraryId = ?
122
- `)
123
- .run(serverOrder, replicaId, libraryId);
124
- };
125
- this.getEarliestAckedServerOrder = (libraryId) => {
126
- // get the earliest acked server order of all non-truant replicas
127
- const allAcks = this.db
128
- .prepare(`
129
- SELECT ackedServerOrder FROM ReplicaInfo
130
- WHERE libraryId = ?
131
- AND lastSeenWallClockTime > ?
132
- `)
133
- .all(libraryId, this.truantCutoff).map((row) => row.ackedServerOrder);
134
- if (allAcks.some((ack) => ack === null)) {
135
- return null;
136
- }
137
- return Math.min(...allAcks);
138
- };
139
- this.acknowledgeOperation = (libraryId, replicaId, timestamp) => {
140
- if (!timestamp)
141
- return;
142
- // get the server order from the operation with the timestamp and update the replica's server order
143
- // to the max of the current server order and the server order of the operation
144
- this.db
145
- .prepare(`
146
- UPDATE ReplicaInfo
147
- SET ackedLogicalTime = ?, ackedServerOrder = MAX(ackedServerOrder, COALESCE((
148
- SELECT serverOrder FROM OperationHistory
149
- WHERE libraryId = ? AND timestamp = ?
150
- ), 0))
151
- WHERE id = ? AND libraryId = ?
152
- `)
153
- .run(timestamp, libraryId, timestamp, replicaId, libraryId);
154
- };
155
- this.getGlobalAck = (libraryId, onlineReplicaIds) => {
156
- const nonTruant = this.getAllNonTruant(libraryId);
157
- const globalAckEligible = nonTruant.filter((replica) => replica.type < 2 || (onlineReplicaIds === null || onlineReplicaIds === void 0 ? void 0 : onlineReplicaIds.includes(replica.id)));
158
- // get the earliest acked time
159
- return globalAckEligible.reduce((acc, replica) => {
160
- if (!replica.ackedLogicalTime) {
161
- return acc;
162
- }
163
- if (acc === undefined) {
164
- return replica.ackedLogicalTime;
165
- }
166
- return acc < replica.ackedLogicalTime ? acc : replica.ackedLogicalTime;
167
- }, undefined);
168
- };
169
- this.delete = (libraryId, replicaId) => {
170
- return this.db
171
- .prepare(`
172
- DELETE FROM ReplicaInfo
173
- WHERE id = ? AND libraryId = ?
174
- `)
175
- .run(replicaId, libraryId);
176
- };
177
- this.deleteAll = (libraryId) => {
178
- return this.db
179
- .prepare(`
180
- DELETE FROM ReplicaInfo
181
- WHERE libraryId = ?
182
- `)
183
- .run(libraryId);
184
- };
185
- this.deleteAllForUser = (libraryId, userId) => {
186
- return this.db
187
- .prepare(`DELETE FROM ReplicaInfo WHERE libraryId = ? AND clientId = ?`)
188
- .run(libraryId, userId);
189
- };
190
- }
191
- get truantCutoff() {
192
- return Date.now() - this.replicaTruancyMinutes * 60 * 1000;
193
- }
194
- }
195
- exports.ReplicaInfos = ReplicaInfos;
196
- //# sourceMappingURL=Replicas.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"Replicas.js","sourceRoot":"","sources":["../../src/Replicas.ts"],"names":[],"mappings":";;;AAIA,MAAa,YAAY;IACxB,YACS,EAAY,EACH,qBAA6B;QADtC,OAAE,GAAF,EAAE,CAAU;QACH,0BAAqB,GAArB,qBAAqB,CAAQ;QAO/C,QAAG,GAAG,CAAC,SAAiB,EAAE,SAAiB,EAA0B,EAAE;YACtE,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;iBACjB,OAAO,CACP;;;KAGC,CACD;iBACA,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAC5B,IAAI,CAAC,GAAG,EAAE;gBACT,OAAO,IAAI,CAAC;aACZ;YACD,OAAO;gBACN,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,qBAAqB,EAAE,GAAG,CAAC,qBAAqB;gBAChD,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;gBACtC,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;aACtC,CAAC;QACH,CAAC,CAAC;QAEF,gBAAW,GAAG,CACb,SAAiB,EACjB,SAAiB,EACjB,IAAe,EAId,EAAE;YACH,MAAM,WAAW,GAAoB,IAAI,CAAC,EAAE;iBAC1C,OAAO,CACP;;;IAGA,CACA;iBACA,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAE5B,IAAI,CAAC,WAAW,EAAE;gBACjB,IAAI,CAAC,EAAE;qBACL,OAAO,CACP;;;IAGD,CACC;qBACA,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBAEpD,OAAO;oBACN,MAAM,EAAE,KAAK;oBACb,WAAW,EAAE;wBACZ,EAAE,EAAE,SAAS;wBACb,QAAQ,EAAE,IAAI,CAAC,MAAM;wBACrB,gBAAgB,EAAE,IAAI;wBACtB,qBAAqB,EAAE,IAAI;wBAC3B,SAAS,EAAE,SAAS;wBACpB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,gBAAgB,EAAE,CAAC;qBACnB;iBACD,CAAC;aACF;YAED,IAAI,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE;gBACnC,mDAAmD;gBACnD,IAAI,CAAC,EAAE;qBACL,OAAO,CACP;;;;MAIC,CACD;qBACA,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;aACvC;YAED,IAAI,WAAW,CAAC,QAAQ,KAAK,IAAI,CAAC,MAAM,EAAE;gBACzC,MAAM,IAAI,KAAK,CACd,WAAW,SAAS,0CAA0C,CAC9D,CAAC;aACF;YAED,IACC,WAAW,CAAC,qBAAqB;gBACjC,WAAW,CAAC,qBAAqB,GAAG,IAAI,CAAC,YAAY,EACpD;gBACD,OAAO;oBACN,MAAM,EAAE,QAAQ;oBAChB,WAAW;iBACX,CAAC;aACF;YAED,OAAO;gBACN,MAAM,EAAE,UAAU;gBAClB,WAAW;aACX,CAAC;QACH,CAAC,CAAC;QAEF,oBAAe,GAAG,CAAC,SAAiB,EAAqB,EAAE;YAC1D,OAAO,IAAI,CAAC,EAAE;iBACZ,OAAO,CACP;;;GAGD,CACC;iBACA,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACrC,CAAC,CAAC;QAEF,WAAM,GAAG,CAAC,SAAiB,EAAqB,EAAE;YACjD,OAAO,IAAI,CAAC,EAAE;iBACZ,OAAO,CACP;;;GAGD,CACC;iBACA,GAAG,CAAC,SAAS,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,mBAAc,GAAG,CAAC,SAAiB,EAAE,SAAiB,EAAE,EAAE;YACzD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,EAAE;iBACZ,OAAO,CACP;;;;KAIC,CACD;iBACA,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,uBAAkB,GAAG,CACpB,SAAiB,EACjB,SAAiB,EACjB,SAAiB,EAChB,EAAE;YACH,IAAI,CAAC,EAAE;iBACL,OAAO,CACP;;;;GAID,CACC;iBACA,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC;QAEF,sBAAiB,GAAG,CACnB,SAAiB,EACjB,SAAiB,EACjB,WAAmB,EAClB,EAAE;YACH,qEAAqE;YACrE,IAAI,CAAC,EAAE;iBACL,OAAO,CACP;;;;GAID,CACC;iBACA,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC1C,CAAC,CAAC;QAEF,gCAA2B,GAAG,CAAC,SAAiB,EAAE,EAAE;YACnD,iEAAiE;YACjE,MAAM,OAAO,GACZ,IAAI,CAAC,EAAE;iBACL,OAAO,CACP;;;;GAIF,CACE;iBACA,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,CAGlC,CAAC,GAAG,CAAC,CAAC,GAAwC,EAAE,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;YAE1E,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE;gBACxC,OAAO,IAAI,CAAC;aACZ;YACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAI,OAAoB,CAAC,CAAC;QAC3C,CAAC,CAAC;QAEF,yBAAoB,GAAG,CACtB,SAAiB,EACjB,SAAiB,EACjB,SAAiB,EAChB,EAAE;YACH,IAAI,CAAC,SAAS;gBAAE,OAAO;YAEvB,mGAAmG;YACnG,+EAA+E;YAC/E,IAAI,CAAC,EAAE;iBACL,OAAO,CACP;;;;;;;IAOA,CACA;iBACA,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9D,CAAC,CAAC;QAEF,iBAAY,GAAG,CAAC,SAAiB,EAAE,gBAA2B,EAAE,EAAE;YACjE,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,iBAAiB,GAAG,SAAS,CAAC,MAAM,CACzC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,KAAI,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CACvE,CAAC;YACF,8BAA8B;YAC9B,OAAO,iBAAiB,CAAC,MAAM,CAC9B,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;gBAChB,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE;oBAC9B,OAAO,GAAG,CAAC;iBACX;gBACD,IAAI,GAAG,KAAK,SAAS,EAAE;oBACtB,OAAO,OAAO,CAAC,gBAAgB,CAAC;iBAChC;gBACD,OAAO,GAAG,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC;YACxE,CAAC,EACD,SAA+B,CAC/B,CAAC;QACH,CAAC,CAAC;QAEF,WAAM,GAAG,CAAC,SAAiB,EAAE,SAAiB,EAAE,EAAE;YACjD,OAAO,IAAI,CAAC,EAAE;iBACZ,OAAO,CACP;;;GAGD,CACC;iBACA,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC7B,CAAC,CAAC;QAEF,cAAS,GAAG,CAAC,SAAiB,EAAE,EAAE;YACjC,OAAO,IAAI,CAAC,EAAE;iBACZ,OAAO,CACP;;;GAGD,CACC;iBACA,GAAG,CAAC,SAAS,CAAC,CAAC;QAClB,CAAC,CAAC;QAEF,qBAAgB,GAAG,CAAC,SAAiB,EAAE,MAAc,EAAE,EAAE;YACxD,OAAO,IAAI,CAAC,EAAE;iBACZ,OAAO,CAAC,8DAA8D,CAAC;iBACvE,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC,CAAC;IAxQC,CAAC;IAEJ,IAAI,YAAY;QACf,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,qBAAqB,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5D,CAAC;CAqQD;AA7QD,oCA6QC"}
@@ -1,167 +0,0 @@
1
- /// <reference types="node" resolution-mode="require"/>
2
- /// <reference types="node" resolution-mode="require"/>
3
- /// <reference types="node" resolution-mode="require"/>
4
- /// <reference types="node" resolution-mode="require"/>
5
- import { DocumentBaseline, Operation, ServerMessage } from '@verdant-web/common';
6
- import EventEmitter from 'events';
7
- import { IncomingMessage, Server as HttpServer, ServerResponse } from 'http';
8
- import { UserProfiles } from './Profiles.js';
9
- import { MessageSender } from './MessageSender.js';
10
- import { TokenInfo } from './TokenVerifier.js';
11
- import { FileStorage } from './files/FileStorage.js';
12
- import internal from 'stream';
13
- import { FileMetadataConfig } from './files/FileMetadata.js';
14
- export interface ServerOptions {
15
- /**
16
- * Attach to a pre-existing HTTP server. Provide this if you have another server,
17
- * like an Express server, that you want to add lofi to. If provided, you don't
18
- * need to call .listen()
19
- */
20
- httpServer?: HttpServer;
21
- /**
22
- * The secret value used to generate tokens from your authentication endpoint.
23
- * Used to verify and decode user identity and library access on connection.
24
- */
25
- tokenSecret: string;
26
- /**
27
- * The path to your SQLite database.
28
- */
29
- databaseFile: string;
30
- /**
31
- * Optionally provide an implementation of the UserProfiles interface to look up
32
- * static user profile data to use in persistence. This data is considered trusted
33
- * and can be used to identify users with information like name or profile image.
34
- */
35
- profiles?: UserProfiles<any>;
36
- /**
37
- * How many minutes of inactivity before a replica is considered truant and
38
- * removed from the library. Defaults to 30 days.
39
- */
40
- replicaTruancyMinutes?: number;
41
- /**
42
- * Supply a logging function to log debug messages.
43
- */
44
- log?: (...args: any[]) => void;
45
- /**
46
- * Disable history compaction. Storage usage will grow indefinitely. Not recommended.
47
- */
48
- disableRebasing?: boolean;
49
- /**
50
- * Provide a FileStorage backend to accept file uploads. Without a file backend,
51
- * users will not be able to synchronize files, and all files added on peer replicas
52
- * will be forever unavailable.
53
- *
54
- * A default, filesystem-backed FileStorage implementation is provided as an export
55
- * of this library.
56
- */
57
- fileStorage?: FileStorage;
58
- fileConfig?: FileMetadataConfig;
59
- }
60
- export interface ServerEvents {
61
- error: (err: any) => void;
62
- warning: (msg: string, ...args: any[]) => void;
63
- changes: (info: Omit<TokenInfo, 'token'>, operations: Operation[], baselines: DocumentBaseline[]) => void;
64
- request: (info: TokenInfo) => void;
65
- 'socket-close': (info: TokenInfo) => void;
66
- 'socket-connection': (info: TokenInfo) => void;
67
- }
68
- export declare interface Server {
69
- on<Event extends keyof ServerEvents>(ev: Event, cb: ServerEvents[Event]): this;
70
- off<Event extends keyof ServerEvents>(ev: Event, cb: ServerEvents[Event]): this;
71
- emit<Event extends keyof ServerEvents>(ev: Event, ...args: Parameters<ServerEvents[Event]>): boolean;
72
- }
73
- export declare class Server extends EventEmitter implements MessageSender {
74
- private httpServer;
75
- private wss;
76
- private fileStorage?;
77
- private fileMetadata;
78
- private library;
79
- private clientConnections;
80
- private keepalives;
81
- private tokenVerifier;
82
- private connectionToReplicaIdMap;
83
- private log;
84
- private __testMode;
85
- constructor(options: ServerOptions);
86
- /**
87
- * Attaches the Verdant server to an HttpServer instance, which
88
- * allows it to handle requests and websockets required for the
89
- * Verdant protocol.
90
- *
91
- * You can pass httpPath = false if you want to handle HTTP requests
92
- * yourself, and this will only attach the websocket handling.
93
- */
94
- attach: (server: HttpServer, options?: {
95
- httpPath?: string | false;
96
- }) => void;
97
- /**
98
- * Handles an HTTP upgrade request to a websocket connection.
99
- */
100
- handleUpgrade: (req: IncomingMessage, socket: internal.Duplex, head: Buffer) => Promise<void>;
101
- private authorizeRequest;
102
- private getRequestToken;
103
- private createInternalRequestHandler;
104
- /**
105
- * Handles an HTTP request from a verdant client.
106
- */
107
- handleRequest: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
108
- /**
109
- * Handles a "fetch" style request. Complement to handleRequest, for servers
110
- * that use Request/Response style handlers.
111
- */
112
- handleFetch: (req: Request) => Promise<Response>;
113
- private handleRequestBody;
114
- private writeErrorResponse;
115
- private getErrorResponse;
116
- /**
117
- * Handles a multipart upload of a file from a verdant client. The upload
118
- * will include parameters for the file's ID, name, and type. The request
119
- * must be authenticated with a token to tie it to a library.
120
- */
121
- handleFileRequest: (req: IncomingMessage, res: ServerResponse) => Promise<void>;
122
- /**
123
- * Handles a "fetch" style file request. Complement to handleFileRequest,
124
- * for servers that use Request/Response style handlers.
125
- */
126
- handleFileFetch: (req: Request) => Promise<Response>;
127
- private getFileStorageOrThrow;
128
- private streamIncomingFile;
129
- private getFileData;
130
- broadcast: (libraryId: string, message: ServerMessage, omitKeys?: string[]) => void;
131
- send: (libraryId: string, key: string, message: ServerMessage) => void;
132
- private handleMessage;
133
- private handleConnection;
134
- listen: (handle: any, listeningListener?: (() => void) | undefined) => void;
135
- close: () => Promise<void>;
136
- /**
137
- * Completely remove a library from the server.
138
- * This will remove all data associated with the library.
139
- * Use it very carefully! Data will still be stored on user
140
- * devices, so this is not as scary as it sounds - the next time
141
- * any replica connects, it will repopulate the library. But
142
- * you should still be careful.
143
- */
144
- evictLibrary: (libraryId: string) => void;
145
- /**
146
- * Returns currently connected replica info for a library
147
- */
148
- getLibraryPresence: (libraryId: string) => Record<string, import("@verdant-web/common").UserInfo<any, any>>;
149
- /**
150
- * Returns helpful information about a library.
151
- * This is currently only the known replicas and some
152
- * more low-level metadata.
153
- */
154
- getLibraryInfo: (libraryId: string) => Promise<import("./types.js").LibraryInfo<unknown> | null>;
155
- /**
156
- * Removes all replicas associated with a User ID from
157
- * the server. Consistency algorithms will no longer wait on these
158
- * replicas before confirming and squashing changes.
159
- */
160
- evictUser: (libraryId: string, userId: string) => void;
161
- /**
162
- * Retrieves a snapshot of the full document contents at this time.
163
- * Useful for capturing the shape of data for static usage outside
164
- * of the live system.
165
- */
166
- getDocumentSnapshot: (libraryId: string, collection: string, documentId: string) => any;
167
- }