@serfab/quereus-plugin-sereus 1.15.0 → 1.17.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -0
- package/dist/compose-strand.js +13 -10
- package/dist/compose-strand.js.map +1 -1
- package/dist/empty-collections.d.ts +23 -0
- package/dist/empty-collections.js +71 -0
- package/dist/empty-collections.js.map +1 -0
- package/dist/plugin-browser.js +27 -27
- package/dist/plugin-browser.js.map +4 -4
- package/dist/types.d.ts +10 -0
- package/package.json +7 -7
- package/src/compose-strand.ts +491 -484
- package/src/empty-collections.ts +89 -0
- package/src/types.ts +10 -0
package/README.md
CHANGED
|
@@ -274,6 +274,10 @@ on shutdown.
|
|
|
274
274
|
|
|
275
275
|
The result's `onCommitDurability(listener)` is called after every commit that wrote something, before the commit returns, with who holds what it wrote; `onCommitFullyHeld(listener)` is called once when a commit reported `followed` below full replication becomes held by its whole cohort. Both pass through from `@optimystic/quereus-plugin-optimystic`, whose README explains the report ([A commit's durability](https://github.com/gotchoices/optimystic/blob/main/packages/quereus-plugin-optimystic/README.md#a-commits-durability--pluginoncommitdurabilitylistener)); the `SqlCommitDurability` and `CommitFullyHeld` types are re-exported here. A cadre app reads the same reports through `@serfab/cadre-core` ([strands.md → A commit's durability](../../docs/strands.md#a-commits-durability)).
|
|
276
276
|
|
|
277
|
+
### Founding a strand: `createEmptyCollections()`
|
|
278
|
+
|
|
279
|
+
A table nobody has written has no collection, so no single machine can show it empty: every read of it asks the other members, and fails while they are offline. The result's `createEmptyCollections()` commits an empty collection for every table the `Strand` and `App` schemas declare that has none yet, and resolves to how many it committed. The founder calls it once, before writing `Strand.Header`, while no other machine can have written to the strand; cadre-core's founder bootstrap does this ([strands.md → Joining](../../docs/strands.md#joining-no-writes-before-the-first-sync)). Call it only while nothing else writes through the `Database`: it commits whatever is staged in those collections outside any SQL transaction.
|
|
280
|
+
|
|
277
281
|
---
|
|
278
282
|
|
|
279
283
|
## Configuration
|
package/dist/compose-strand.js
CHANGED
|
@@ -3,6 +3,7 @@ import optimysticPlugin from '@optimystic/quereus-plugin-optimystic/plugin';
|
|
|
3
3
|
import { STRAND_SCHEMA } from './strand-schema.js';
|
|
4
4
|
import { resolveStrandClusterSize, STRAND_CLUSTER_POLICY } from './cluster-size.js';
|
|
5
5
|
import { wrapStorageWithCache, disposeStorageCache } from './cached-storage.js';
|
|
6
|
+
import { createEmptyCollections } from './empty-collections.js';
|
|
6
7
|
const log = debug('sereus:plugin:strand');
|
|
7
8
|
const timing = debug('sereus:plugin:strand:timing');
|
|
8
9
|
/**
|
|
@@ -192,11 +193,11 @@ export async function composeStrand(db, options, platform) {
|
|
|
192
193
|
// Manager/Member, invite/peer flows) is owned by the lifecycle ticket
|
|
193
194
|
// `strand-membership-lifecycle-population`.
|
|
194
195
|
log('Applying Strand membership schema for strand %s', strandId);
|
|
195
|
-
await db.exec(`
|
|
196
|
-
declare schema Strand {
|
|
197
|
-
${STRAND_SCHEMA}
|
|
198
|
-
}
|
|
199
|
-
apply schema Strand;
|
|
196
|
+
await db.exec(`
|
|
197
|
+
declare schema Strand {
|
|
198
|
+
${STRAND_SCHEMA}
|
|
199
|
+
}
|
|
200
|
+
apply schema Strand;
|
|
200
201
|
`);
|
|
201
202
|
log('Strand membership schema applied');
|
|
202
203
|
// 7. Apply the sApp schema, if provided.
|
|
@@ -227,7 +228,8 @@ export async function composeStrand(db, options, platform) {
|
|
|
227
228
|
await releaseStorageCache();
|
|
228
229
|
throw err;
|
|
229
230
|
}
|
|
230
|
-
// 8. Return result with hydrate counts, the commit-durability listeners
|
|
231
|
+
// 8. Return result with hydrate counts, the commit-durability listeners, the founder's
|
|
232
|
+
// empty-collection step + shutdown handler.
|
|
231
233
|
// `shutdown` releases the plugin and stops the node only if this composition created it.
|
|
232
234
|
return {
|
|
233
235
|
vtables: [],
|
|
@@ -237,6 +239,7 @@ export async function composeStrand(db, options, platform) {
|
|
|
237
239
|
transactor: resolvedTransactor,
|
|
238
240
|
onCommitDurability: listener => pluginResult.onCommitDurability(listener),
|
|
239
241
|
onCommitFullyHeld: listener => pluginResult.onCommitFullyHeld(listener),
|
|
242
|
+
createEmptyCollections: () => createEmptyCollections(db, pluginResult.txnBridge),
|
|
240
243
|
async shutdown() {
|
|
241
244
|
log('Shutting down strand connection %s', strandId);
|
|
242
245
|
await releaseOptimysticPlugin(pluginResult, createdNode);
|
|
@@ -262,10 +265,10 @@ export async function composeStrand(db, options, platform) {
|
|
|
262
265
|
* the same key at once would collide. Rows an app needs at birth are the founding app's to write.
|
|
263
266
|
*/
|
|
264
267
|
export async function applyAppSchema(db, schema) {
|
|
265
|
-
await db.exec(`
|
|
266
|
-
declare schema App {
|
|
267
|
-
${schema}
|
|
268
|
-
}
|
|
268
|
+
await db.exec(`
|
|
269
|
+
declare schema App {
|
|
270
|
+
${schema}
|
|
271
|
+
}
|
|
269
272
|
`);
|
|
270
273
|
assertNoIgnoredItems(db);
|
|
271
274
|
assertNoSeedItems(db);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"compose-strand.js","sourceRoot":"","sources":["../src/compose-strand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,gBAAgB,MAAM,8CAA8C,CAAC;AAM5E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;
|
|
1
|
+
{"version":3,"file":"compose-strand.js","sourceRoot":"","sources":["../src/compose-strand.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { Database } from '@quereus/quereus';
|
|
2
|
+
import type { Collection, CollectionId } from '@optimystic/db-core';
|
|
3
|
+
/**
|
|
4
|
+
* The part of the Optimystic plugin's transaction bridge this module reads: the live registry of
|
|
5
|
+
* every collection a table opened (its main tree, index trees and unique-enforcement trees),
|
|
6
|
+
* filled as each table initializes.
|
|
7
|
+
*/
|
|
8
|
+
export interface CollectionRegistrySource {
|
|
9
|
+
getCollectionRegistry(): Map<CollectionId, Collection<unknown>>;
|
|
10
|
+
}
|
|
11
|
+
/**
|
|
12
|
+
* Commit an empty collection for every table declared in the `Strand` and `App` schemas that
|
|
13
|
+
* has none yet, and resolve to how many collections were committed.
|
|
14
|
+
*
|
|
15
|
+
* Opening a table whose collection was never committed stages a fresh empty one in this node's
|
|
16
|
+
* tracker and writes nothing (`Collection.createOrOpen`'s invented branch), and a SQL commit
|
|
17
|
+
* flushes only the trees it wrote to. So the step opens every table, which registers each of its
|
|
18
|
+
* trees with the bridge, then syncs every registered collection still in that invented state.
|
|
19
|
+
*
|
|
20
|
+
* Commits outside any SQL transaction whatever is staged in those collections, so it is only
|
|
21
|
+
* sound while nothing else writes through `db`.
|
|
22
|
+
*/
|
|
23
|
+
export declare function createEmptyCollections(db: Database, bridge: CollectionRegistrySource): Promise<number>;
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import debug from 'debug';
|
|
2
|
+
import { defaultCollectionUri } from '@optimystic/quereus-plugin-optimystic';
|
|
3
|
+
const log = debug('sereus:plugin:strand');
|
|
4
|
+
/** The schemas whose tables a founder gives a collection: strand membership, then the sApp's. */
|
|
5
|
+
const FOUNDED_SCHEMAS = ['Strand', 'App'];
|
|
6
|
+
/**
|
|
7
|
+
* Commit an empty collection for every table declared in the `Strand` and `App` schemas that
|
|
8
|
+
* has none yet, and resolve to how many collections were committed.
|
|
9
|
+
*
|
|
10
|
+
* Opening a table whose collection was never committed stages a fresh empty one in this node's
|
|
11
|
+
* tracker and writes nothing (`Collection.createOrOpen`'s invented branch), and a SQL commit
|
|
12
|
+
* flushes only the trees it wrote to. So the step opens every table, which registers each of its
|
|
13
|
+
* trees with the bridge, then syncs every registered collection still in that invented state.
|
|
14
|
+
*
|
|
15
|
+
* Commits outside any SQL transaction whatever is staged in those collections, so it is only
|
|
16
|
+
* sound while nothing else writes through `db`.
|
|
17
|
+
*/
|
|
18
|
+
export async function createEmptyCollections(db, bridge) {
|
|
19
|
+
const tables = foundedTables(db);
|
|
20
|
+
await openTables(db, tables);
|
|
21
|
+
const registry = bridge.getCollectionRegistry();
|
|
22
|
+
assertMainCollectionsRegistered(registry, tables);
|
|
23
|
+
return await syncInventedCollections(registry);
|
|
24
|
+
}
|
|
25
|
+
function foundedTables(db) {
|
|
26
|
+
return FOUNDED_SCHEMAS.flatMap(name => {
|
|
27
|
+
const schema = db.schemaManager.getSchema(name);
|
|
28
|
+
return schema
|
|
29
|
+
? Array.from(schema.getAllTables()).filter(table => !table.isView && table.vtabModuleName === 'optimystic')
|
|
30
|
+
: [];
|
|
31
|
+
});
|
|
32
|
+
}
|
|
33
|
+
/** A read initializes the table's vtab, which is what opens and registers its collections. */
|
|
34
|
+
async function openTables(db, tables) {
|
|
35
|
+
for (const table of tables) {
|
|
36
|
+
for await (const _row of db.eval(`select 1 from ${table.schemaName}."${table.name}" limit 1`)) {
|
|
37
|
+
break;
|
|
38
|
+
}
|
|
39
|
+
}
|
|
40
|
+
}
|
|
41
|
+
/**
|
|
42
|
+
* A declared table whose main collection is not registered means the plugin's open or
|
|
43
|
+
* registration path has changed under this module; founding on would leave that table with no
|
|
44
|
+
* collection while appearing to have given every table one.
|
|
45
|
+
*/
|
|
46
|
+
function assertMainCollectionsRegistered(registry, tables) {
|
|
47
|
+
const unregistered = tables.filter(table => !registry.has(mainCollectionId(table)));
|
|
48
|
+
if (unregistered.length > 0) {
|
|
49
|
+
const names = unregistered.map(table => `${table.schemaName}.${table.name} (${mainCollectionId(table)})`).join(', ');
|
|
50
|
+
throw new Error(`Opening the strand's tables registered no collection for ${names}; cannot give those tables an empty collection`);
|
|
51
|
+
}
|
|
52
|
+
}
|
|
53
|
+
/** The collection id the Optimystic vtab stores `table` under: its URI without the `tree://` scheme. */
|
|
54
|
+
function mainCollectionId(table) {
|
|
55
|
+
const explicitUri = table.vtabArgs?.['0'];
|
|
56
|
+
const uri = typeof explicitUri === 'string' && explicitUri !== '' ? explicitUri : defaultCollectionUri(table.schemaName, table.name);
|
|
57
|
+
return (uri.startsWith('tree://') ? uri.slice('tree://'.length) : uri);
|
|
58
|
+
}
|
|
59
|
+
async function syncInventedCollections(registry) {
|
|
60
|
+
let committed = 0;
|
|
61
|
+
for (const [id, collection] of registry) {
|
|
62
|
+
// `committedRevision() === undefined` is the invented STATE, which its doc says is safe to branch on.
|
|
63
|
+
if (collection.committedRevision() === undefined && collection.hasUnsyncedChanges()) {
|
|
64
|
+
await collection.sync();
|
|
65
|
+
log('Committed empty collection %s', id);
|
|
66
|
+
committed++;
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
return committed;
|
|
70
|
+
}
|
|
71
|
+
//# sourceMappingURL=empty-collections.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"empty-collections.js","sourceRoot":"","sources":["../src/empty-collections.ts"],"names":[],"mappings":"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"}
|