castle-web-cli 0.4.246 → 0.4.247
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/castle-host/host.js +362 -4
- package/dist/characterDoc.d.ts +1 -0
- package/dist/characterDoc.js +149 -0
- package/dist/cloudGit.d.ts +10 -0
- package/dist/cloudGit.js +210 -6
- package/dist/devSessionServer.js +3 -2
- package/dist/devSessionStorage.d.ts +7 -0
- package/dist/devSessionStorage.js +19 -0
- package/dist/init.js +1 -1
- package/dist/platformDoc.d.ts +2 -0
- package/dist/platformDoc.js +26 -1
- package/kits/base/castle.json +1 -1
- package/kits/base/sdk/README.md +174 -39
- package/kits/base/sdk/castle.d.ts +3 -0
- package/kits/base/sdk/castle.js +2 -0
- package/kits/base/sdk/commands.d.ts +37 -0
- package/kits/base/sdk/deckInvites.d.ts +27 -0
- package/kits/base/sdk/deckInvites.js +22 -0
- package/kits/base/sdk/runtime.js +49 -0
- package/kits/base/sdk/server/storage.d.ts +17 -4
- package/kits/base/sdk/server/storage.js +35 -7
- package/kits/hub-game/code/server/writerLease.js +156 -167
- package/kits/hub-game/docs/contract.md +33 -22
- package/kits/hub-game/scripts/test-writer-lease-server.mjs +11 -8
- package/kits/hub-game/scripts/test-writer-lease.mjs +310 -386
- package/kits/hub-game/scripts/writer-storage-fixture.mjs +38 -6
- package/package.json +1 -1
|
@@ -9,29 +9,61 @@ export function storeFixture() {
|
|
|
9
9
|
const saves = new DevSaveStorage();
|
|
10
10
|
const rows = new Map();
|
|
11
11
|
const roots = [];
|
|
12
|
+
// Every ordinary write that lands, with the writer it carried and the
|
|
13
|
+
// account's writer on the platform as it landed (user 101 unless named).
|
|
14
|
+
const commits = [];
|
|
15
|
+
const writerOf = (subject) => saves.state.targets.get(JSON.stringify(['user', subject, 'hub:writer:']))?.writer;
|
|
12
16
|
function root(binding) {
|
|
13
|
-
const calls = { claim: [], transaction: [], set: [], remove: [], increment: [], get: [], list: [] };
|
|
17
|
+
const calls = { claim: [], transaction: [], set: [], remove: [], increment: [], get: [], list: [], checked: [] };
|
|
14
18
|
const caller = { principal: 'server', binding, server: true, deckWritable: true, replyEnvelope: value => value, replyBytes: 1000000 };
|
|
19
|
+
const result = {};
|
|
15
20
|
const execute = (verb, input) => {
|
|
16
21
|
calls[verb].push(structuredClone(input));
|
|
17
22
|
const result = saves.execute(verb, input, caller);
|
|
18
23
|
if (!result.ok) throw Object.assign(new Error(result.error.message), result.error);
|
|
19
24
|
return result.value;
|
|
20
25
|
};
|
|
26
|
+
// A write carrying a writer check runs it and the write together, as the
|
|
27
|
+
// platform does (one transaction): a stale writer writes nothing.
|
|
28
|
+
// `result.checks = false` answers checked writes the way serve and world
|
|
29
|
+
// sessions do (UNAVAILABLE, nothing sent). `result.inTransit(verb, args)`
|
|
30
|
+
// may hold a request on the wire before the platform sees it.
|
|
31
|
+
const checked = (verb, options) => {
|
|
32
|
+
if (options?.check === undefined) return;
|
|
33
|
+
if (result.checks === false) {
|
|
34
|
+
// As castle-web serve answers it: the details under `extensions`.
|
|
35
|
+
throw Object.assign(new Error('no writer check here'), { code: 'CAULDRON_STORAGE_UNAVAILABLE', extensions: { committed: false, retryable: false } });
|
|
36
|
+
}
|
|
37
|
+
calls.checked.push({ verb, writer: options.check.writer });
|
|
38
|
+
const outcome = saves.execute('transaction', { operationId: `check-${Math.random()}`, expectedAccess: saves.access, checks: [options.check], changes: [] }, caller);
|
|
39
|
+
if (!outcome.ok) throw Object.assign(new Error(outcome.error.message), outcome.error);
|
|
40
|
+
};
|
|
21
41
|
const bucket = prefix => ({
|
|
22
42
|
async get(keys) { calls.get.push(keys); return Object.fromEntries(keys.filter(k => rows.has(prefix + k)).map(k => [k, rows.get(prefix + k)])); },
|
|
23
43
|
async list(input) { calls.list.push(input); return { entries: [], cursor: null }; },
|
|
24
|
-
async set(values
|
|
25
|
-
|
|
26
|
-
|
|
44
|
+
async set(values, options) {
|
|
45
|
+
await result.inTransit?.('set', values); checked('set', options); calls.set.push(values);
|
|
46
|
+
for (const [k, v] of Object.entries(values)) rows.set(prefix + k, v);
|
|
47
|
+
commits.push({ root: binding, values, carried: options?.check?.writer, current: writerOf(options?.check?.target.subject ?? '101') });
|
|
48
|
+
},
|
|
49
|
+
async remove(keys, options) { await result.inTransit?.('remove', keys); checked('remove', options); calls.remove.push(keys); for (const k of keys) rows.delete(prefix + k); },
|
|
50
|
+
async increment(key, amount = 1, options) { await result.inTransit?.('increment', key); checked('increment', options); calls.increment.push(key); const n = (rows.get(prefix + key) ?? 0) + amount; rows.set(prefix + key, n); return n; },
|
|
27
51
|
});
|
|
28
52
|
const storage = { deck: bucket('deck:'), user: userId => bucket(`user:${userId}:`),
|
|
29
53
|
async claim(input) { return execute('claim', input); },
|
|
30
54
|
async transaction(input) { return execute('transaction', input); },
|
|
31
55
|
};
|
|
32
|
-
|
|
56
|
+
Object.assign(result, { storage, calls });
|
|
33
57
|
roots.push(result);
|
|
34
58
|
return result;
|
|
35
59
|
}
|
|
36
|
-
|
|
60
|
+
// The writer checks of a transaction, run as the session `binding` would.
|
|
61
|
+
function checkAs(binding, checks = []) {
|
|
62
|
+
const writers = checks.filter(check => check.writer !== undefined);
|
|
63
|
+
if (!writers.length) return;
|
|
64
|
+
const caller = { principal: 'server', binding, server: true, deckWritable: true, replyEnvelope: value => value, replyBytes: 1000000 };
|
|
65
|
+
const outcome = saves.execute('transaction', { operationId: `check-${Math.random()}`, expectedAccess: saves.access, checks: writers, changes: [] }, caller);
|
|
66
|
+
if (!outcome.ok) throw Object.assign(new Error(outcome.error.message), outcome.error);
|
|
67
|
+
}
|
|
68
|
+
return { saves, rows, root, roots, commits, writerOf, checkAs };
|
|
37
69
|
}
|