@typeonce/ritmo-devtools 0.14.0 → 0.15.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/CHANGELOG.md +241 -0
- package/README.md +296 -55
- package/dist/Desync.d.ts +17 -3
- package/dist/Desync.d.ts.map +1 -1
- package/dist/Desync.js +17 -15
- package/dist/Desync.js.map +1 -1
- package/dist/Determinism.d.ts +17 -6
- package/dist/Determinism.d.ts.map +1 -1
- package/dist/Determinism.js +11 -3
- package/dist/Determinism.js.map +1 -1
- package/dist/Format.d.ts +43 -8
- package/dist/Format.d.ts.map +1 -1
- package/dist/Format.js +63 -31
- package/dist/Format.js.map +1 -1
- package/dist/Fuzz.d.ts +268 -0
- package/dist/Fuzz.d.ts.map +1 -0
- package/dist/Fuzz.js +355 -0
- package/dist/Fuzz.js.map +1 -0
- package/dist/Invariant.d.ts +6 -2
- package/dist/Invariant.d.ts.map +1 -1
- package/dist/Invariant.js.map +1 -1
- package/dist/PlaywrightEngine.d.ts +29 -0
- package/dist/PlaywrightEngine.d.ts.map +1 -0
- package/dist/PlaywrightEngine.js +193 -0
- package/dist/PlaywrightEngine.js.map +1 -0
- package/dist/Replay.d.ts +40 -22
- package/dist/Replay.d.ts.map +1 -1
- package/dist/Replay.js +20 -27
- package/dist/Replay.js.map +1 -1
- package/dist/Session.d.ts +214 -17
- package/dist/Session.d.ts.map +1 -1
- package/dist/Session.js +563 -57
- package/dist/Session.js.map +1 -1
- package/dist/Verify.d.ts +147 -0
- package/dist/Verify.d.ts.map +1 -0
- package/dist/Verify.js +151 -0
- package/dist/Verify.js.map +1 -0
- package/dist/cli.js +136 -8
- package/dist/cli.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +3 -2
- package/dist/index.js.map +1 -1
- package/dist/internal/dependencyScan.d.ts +44 -0
- package/dist/internal/dependencyScan.d.ts.map +1 -0
- package/dist/internal/dependencyScan.js +313 -0
- package/dist/internal/dependencyScan.js.map +1 -0
- package/dist/internal/fuzzNetwork.d.ts +56 -0
- package/dist/internal/fuzzNetwork.d.ts.map +1 -0
- package/dist/internal/fuzzNetwork.js +96 -0
- package/dist/internal/fuzzNetwork.js.map +1 -0
- package/dist/internal/values.d.ts +9 -1
- package/dist/internal/values.d.ts.map +1 -1
- package/dist/internal/values.js +11 -1
- package/dist/internal/values.js.map +1 -1
- package/dist/internal/verifyRunner.d.ts +19 -0
- package/dist/internal/verifyRunner.d.ts.map +1 -0
- package/dist/internal/verifyRunner.js +47 -0
- package/dist/internal/verifyRunner.js.map +1 -0
- package/dist/internal/version.d.ts +1 -1
- package/dist/internal/version.js +1 -1
- package/package.json +28 -3
- package/src/Desync.ts +34 -17
- package/src/Determinism.ts +46 -11
- package/src/Format.ts +99 -34
- package/src/Fuzz.ts +544 -0
- package/src/Invariant.ts +6 -2
- package/src/PlaywrightEngine.ts +229 -0
- package/src/Replay.ts +87 -43
- package/src/Session.ts +806 -72
- package/src/Verify.ts +273 -0
- package/src/cli.ts +131 -8
- package/src/index.ts +3 -2
- package/src/internal/dependencyScan.ts +356 -0
- package/src/internal/fuzzNetwork.ts +130 -0
- package/src/internal/values.ts +20 -1
- package/src/internal/verifyRunner.ts +46 -0
- package/src/internal/version.ts +1 -1
- package/dist/Monitor.d.ts +0 -101
- package/dist/Monitor.d.ts.map +0 -1
- package/dist/Monitor.js +0 -602
- package/dist/Monitor.js.map +0 -1
- package/dist/internal/monitor.d.ts +0 -126
- package/dist/internal/monitor.d.ts.map +0 -1
- package/dist/internal/monitor.js +0 -279
- package/dist/internal/monitor.js.map +0 -1
- package/src/Monitor.ts +0 -713
- package/src/internal/monitor.ts +0 -370
package/dist/Fuzz.js.map
ADDED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Fuzz.js","sourceRoot":"","sources":["../src/Fuzz.ts"],"names":[],"mappings":"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"}
|
package/dist/Invariant.d.ts
CHANGED
|
@@ -8,6 +8,10 @@
|
|
|
8
8
|
* invariant that reads a resource, service, or machine the runtime does not
|
|
9
9
|
* provide. The invariant is named after its inspector.
|
|
10
10
|
*
|
|
11
|
+
* Write entities in the message as `e${id}`: a session with `labels` prints
|
|
12
|
+
* each one with its label (`player e12`) in the run summary; the run's
|
|
13
|
+
* `stop.message` keeps the text the inspector returned.
|
|
14
|
+
*
|
|
11
15
|
* Use `Invariant.fromInspector` for checks over the world during a session.
|
|
12
16
|
* Use `Game.Inspector` with `runtime.inspect(...)` directly for one-off reads
|
|
13
17
|
* in tests and scripts.
|
|
@@ -20,9 +24,9 @@
|
|
|
20
24
|
* const PlayerInsideWorld = Invariant.fromInspector(Game.Inspector("player inside world", {
|
|
21
25
|
* queries: { players: Game.Query({ selection: { position: Game.Query.read(Position) }, with: [Player] }) }
|
|
22
26
|
* }, ({ queries }) => {
|
|
23
|
-
* for (const { data } of queries.players.each()) {
|
|
27
|
+
* for (const { entity, data } of queries.players.each()) {
|
|
24
28
|
* const { x } = data.position.get()
|
|
25
|
-
* if (x < 0 || x > WORLD_WIDTH) return `
|
|
29
|
+
* if (x < 0 || x > WORLD_WIDTH) return `e${entity.id} at x=${x}`
|
|
26
30
|
* }
|
|
27
31
|
* return undefined
|
|
28
32
|
* }))
|
package/dist/Invariant.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Invariant.d.ts","sourceRoot":"","sources":["../src/Invariant.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"Invariant.d.ts","sourceRoot":"","sources":["../src/Invariant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,OAAO,KAAK,KAAK,SAAS,MAAM,2BAA2B,CAAA;AAE3D,yBAAiB,SAAS,CAAC;IACzB,0FAA0F;IAC1F,KAAY,cAAc,GAAG,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;CACnG;AAED,sEAAsE;AACtE,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,SAAS,CAAC,cAAc,GAAG,SAAS,CAAC,cAAc;IACtF,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAA;IACxB,yFAAyF;IACzF,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAA;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,CAAC,CAAC,SAAS,SAAS,CAAC,cAAc,aAAa,CAAC,KAAG,SAAS,CAAC,CAAC,CAGhG,CAAA"}
|
package/dist/Invariant.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Invariant.js","sourceRoot":"","sources":["../src/Invariant.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"Invariant.js","sourceRoot":"","sources":["../src/Invariant.ts"],"names":[],"mappings":"AAmDA;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAA2C,SAAY,EAAgB,EAAE,CAAC,CAAC;IACtG,IAAI,EAAE,SAAS,CAAC,IAAI;IACpB,SAAS;CACV,CAAC,CAAA"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type * as Verify from "./Verify.ts";
|
|
2
|
+
/** A browser engine Playwright runs. */
|
|
3
|
+
export type Browser = "chromium" | "webkit" | "firefox";
|
|
4
|
+
/** Every browser engine, in report order. */
|
|
5
|
+
export declare const browsers: ReadonlyArray<Browser>;
|
|
6
|
+
/** Whether `name` is a browser engine Playwright runs (for parsing a command line). */
|
|
7
|
+
export declare const isBrowser: (name: string) => name is Browser;
|
|
8
|
+
/** Which entry to load, and in which browsers. */
|
|
9
|
+
export interface Options {
|
|
10
|
+
/** The module exporting `replayTarget`, the `make(playback)` factory `Replay.session` takes. */
|
|
11
|
+
readonly entry: string;
|
|
12
|
+
readonly browsers: ReadonlyArray<Browser>;
|
|
13
|
+
/** The dev server's root: where `node_modules` is found. Defaults to the working directory. */
|
|
14
|
+
readonly root?: string;
|
|
15
|
+
}
|
|
16
|
+
/** The browser engines, and how to stop them. */
|
|
17
|
+
export interface Engines {
|
|
18
|
+
/** One `Verify.Engine` per browser, in `options.browsers` order: pass them to `Verify.acrossEngines`. */
|
|
19
|
+
readonly engines: ReadonlyArray<Verify.Engine>;
|
|
20
|
+
/** Closes the browsers and the dev server. Call it when the check is done. */
|
|
21
|
+
readonly close: () => Promise<void>;
|
|
22
|
+
}
|
|
23
|
+
/**
|
|
24
|
+
* The browser engines for `options.entry`. Nothing starts until an engine
|
|
25
|
+
* is first used: the dev server once, each browser on its own engine's first
|
|
26
|
+
* `trace`.
|
|
27
|
+
*/
|
|
28
|
+
export declare const make: (options: Options) => Engines;
|
|
29
|
+
//# sourceMappingURL=PlaywrightEngine.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PlaywrightEngine.d.ts","sourceRoot":"","sources":["../src/PlaywrightEngine.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,KAAK,MAAM,MAAM,aAAa,CAAA;AAE1C,wCAAwC;AACxC,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEvD,6CAA6C;AAC7C,eAAO,MAAM,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAqC,CAAA;AAEjF,uFAAuF;AACvF,eAAO,MAAM,SAAS,SAAU,MAAM,KAAG,IAAI,IAAI,OAA6D,CAAA;AAE9G,kDAAkD;AAClD,MAAM,WAAW,OAAO;IACtB,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IACzC,+FAA+F;IAC/F,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,iDAAiD;AACjD,MAAM,WAAW,OAAO;IACtB,yGAAyG;IACzG,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC9C,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AA0BD;;;;GAIG;AACH,eAAO,MAAM,IAAI,YAAa,OAAO,KAAG,OAoIvC,CAAA"}
|
|
@@ -0,0 +1,193 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `Verify.Engine`s for real browsers, in Node: Chromium, WebKit, and
|
|
3
|
+
* Firefox, headless through Playwright. The game's entry is served by a Vite
|
|
4
|
+
* dev server and loaded in each browser beside a small runner, which plays
|
|
5
|
+
* the replay with the entry's `replayTarget` and returns the checksums.
|
|
6
|
+
*
|
|
7
|
+
* `playwright` and `vite` are optional peer dependencies: install them, and
|
|
8
|
+
* the browsers, only where this runs (a CI job, a machine checking a replay):
|
|
9
|
+
*
|
|
10
|
+
* ```sh
|
|
11
|
+
* npm install --save-dev playwright vite
|
|
12
|
+
* npx playwright install chromium webkit firefox
|
|
13
|
+
* ```
|
|
14
|
+
*
|
|
15
|
+
* One that is missing makes each engine fail with `EngineMissing` naming
|
|
16
|
+
* the install command; the others still run.
|
|
17
|
+
*
|
|
18
|
+
* The entry is served by a bare dev server rooted at `root`: imports
|
|
19
|
+
* resolve through `node_modules`, the game's `vite.config` is not read, and
|
|
20
|
+
* it must load in a browser (no Node built-ins).
|
|
21
|
+
*
|
|
22
|
+
* @module PlaywrightEngine
|
|
23
|
+
* @docGroup devtools
|
|
24
|
+
*
|
|
25
|
+
* @example
|
|
26
|
+
* ```ts
|
|
27
|
+
* const browsers = PlaywrightEngine.make({ entry: "src/replay-target.ts", browsers: ["chromium", "webkit", "firefox"] })
|
|
28
|
+
* const verified = await Verify.acrossEngines(replayTarget, file, { engines: browsers.engines })
|
|
29
|
+
* await browsers.close()
|
|
30
|
+
* ```
|
|
31
|
+
*/
|
|
32
|
+
import { extname, resolve, sep } from "node:path";
|
|
33
|
+
import { fileURLToPath } from "node:url";
|
|
34
|
+
import * as Result from "@typeonce/ritmo/Result";
|
|
35
|
+
/** Every browser engine, in report order. */
|
|
36
|
+
export const browsers = ["chromium", "webkit", "firefox"];
|
|
37
|
+
/** Whether `name` is a browser engine Playwright runs (for parsing a command line). */
|
|
38
|
+
export const isBrowser = (name) => browsers.includes(name);
|
|
39
|
+
const missing = (reason, install) => ({ _tag: "EngineMissing", reason, install });
|
|
40
|
+
const failed = (message) => ({ _tag: "EngineFailed", message });
|
|
41
|
+
const messageOf = (error) => error instanceof Error ? error.message : String(error);
|
|
42
|
+
/** A path as a dev server URL path: `/@fs/` and the absolute path, with forward slashes. */
|
|
43
|
+
const fsPath = (path) => `/@fs/${path.split(sep).join("/").replace(/^\/+/, "")}`;
|
|
44
|
+
/** The page side, beside this file: `.ts` in the workspace, `.js` once built. */
|
|
45
|
+
const runnerPath = () => {
|
|
46
|
+
const self = fileURLToPath(import.meta.url);
|
|
47
|
+
return fileURLToPath(new URL(`./internal/verifyRunner${extname(self)}`, import.meta.url));
|
|
48
|
+
};
|
|
49
|
+
/**
|
|
50
|
+
* The browser engines for `options.entry`. Nothing starts until an engine
|
|
51
|
+
* is first used: the dev server once, each browser on its own engine's first
|
|
52
|
+
* `trace`.
|
|
53
|
+
*/
|
|
54
|
+
export const make = (options) => {
|
|
55
|
+
const root = resolve(options.root ?? ".");
|
|
56
|
+
const entry = resolve(root, options.entry);
|
|
57
|
+
let server;
|
|
58
|
+
const pages = new Map();
|
|
59
|
+
const closers = [];
|
|
60
|
+
const startServer = async () => {
|
|
61
|
+
let vite;
|
|
62
|
+
try {
|
|
63
|
+
vite = await import("vite");
|
|
64
|
+
}
|
|
65
|
+
catch {
|
|
66
|
+
return Result.failure(missing("vite is not installed", "npm install --save-dev vite"));
|
|
67
|
+
}
|
|
68
|
+
const html = [
|
|
69
|
+
"<!doctype html><meta charset=\"utf-8\"><title>ritmo verify</title>",
|
|
70
|
+
"<script type=\"module\">",
|
|
71
|
+
`import { start } from ${JSON.stringify(fsPath(runnerPath()))}`,
|
|
72
|
+
`globalThis.__ritmoVerify = start(${JSON.stringify(fsPath(entry))})`,
|
|
73
|
+
"</script>"
|
|
74
|
+
].join("\n");
|
|
75
|
+
try {
|
|
76
|
+
const dev = await vite.createServer({
|
|
77
|
+
root,
|
|
78
|
+
configFile: false,
|
|
79
|
+
logLevel: "silent",
|
|
80
|
+
clearScreen: false,
|
|
81
|
+
appType: "custom",
|
|
82
|
+
server: { host: "127.0.0.1", port: 0, hmr: false, watch: null, fs: { strict: false } },
|
|
83
|
+
// Discovery would optimize dependencies mid-run and reload the page.
|
|
84
|
+
optimizeDeps: { noDiscovery: true, include: [] },
|
|
85
|
+
plugins: [{
|
|
86
|
+
name: "ritmo-verify",
|
|
87
|
+
configureServer: (dev) => {
|
|
88
|
+
dev.middlewares.use("/__ritmo-verify", (_request, response) => {
|
|
89
|
+
response.setHeader("content-type", "text/html");
|
|
90
|
+
response.end(html);
|
|
91
|
+
});
|
|
92
|
+
}
|
|
93
|
+
}]
|
|
94
|
+
});
|
|
95
|
+
await dev.listen();
|
|
96
|
+
const address = dev.httpServer?.address();
|
|
97
|
+
if (address === null || address === undefined || typeof address === "string") {
|
|
98
|
+
await dev.close();
|
|
99
|
+
return Result.failure(failed("the Vite dev server did not report its port"));
|
|
100
|
+
}
|
|
101
|
+
return Result.success({ url: `http://127.0.0.1:${address.port}/__ritmo-verify`, close: () => dev.close() });
|
|
102
|
+
}
|
|
103
|
+
catch (error) {
|
|
104
|
+
return Result.failure(failed(`the Vite dev server did not start: ${messageOf(error)}`));
|
|
105
|
+
}
|
|
106
|
+
};
|
|
107
|
+
const openPage = async (browser) => {
|
|
108
|
+
let playwright;
|
|
109
|
+
try {
|
|
110
|
+
playwright = await import("playwright");
|
|
111
|
+
}
|
|
112
|
+
catch {
|
|
113
|
+
return Result.failure(missing("playwright is not installed", `npm install --save-dev playwright && npx playwright install ${browser}`));
|
|
114
|
+
}
|
|
115
|
+
server ??= startServer();
|
|
116
|
+
const served = await server;
|
|
117
|
+
if (!served.ok)
|
|
118
|
+
return served;
|
|
119
|
+
let launched;
|
|
120
|
+
try {
|
|
121
|
+
launched = await playwright[browser].launch();
|
|
122
|
+
}
|
|
123
|
+
catch (error) {
|
|
124
|
+
const message = messageOf(error);
|
|
125
|
+
return Result.failure(/Executable doesn't exist|playwright install/i.test(message)
|
|
126
|
+
? missing(`the ${browser} browser is not downloaded`, `npx playwright install ${browser}`)
|
|
127
|
+
: failed(`${browser} did not launch: ${message}`));
|
|
128
|
+
}
|
|
129
|
+
closers.push(() => launched.close());
|
|
130
|
+
try {
|
|
131
|
+
const page = await launched.newPage();
|
|
132
|
+
const errors = [];
|
|
133
|
+
page.on("pageerror", (error) => errors.push(error.message));
|
|
134
|
+
await page.goto(served.value.url);
|
|
135
|
+
const started = await page.evaluate(async () => {
|
|
136
|
+
const result = await Reflect.get(globalThis, "__ritmoVerify");
|
|
137
|
+
if (result === undefined)
|
|
138
|
+
return "the runner did not start";
|
|
139
|
+
if (!result.ok)
|
|
140
|
+
return result.error;
|
|
141
|
+
Reflect.set(globalThis, "__ritmoRunner", result.value);
|
|
142
|
+
return undefined;
|
|
143
|
+
});
|
|
144
|
+
if (started !== undefined)
|
|
145
|
+
return Result.failure(failed([started, ...errors].join("\n")));
|
|
146
|
+
return Result.success(page);
|
|
147
|
+
}
|
|
148
|
+
catch (error) {
|
|
149
|
+
return Result.failure(failed(`the page did not load: ${messageOf(error)}`));
|
|
150
|
+
}
|
|
151
|
+
};
|
|
152
|
+
const engine = (browser) => {
|
|
153
|
+
const page = () => {
|
|
154
|
+
let opened = pages.get(browser);
|
|
155
|
+
if (opened === undefined) {
|
|
156
|
+
opened = openPage(browser);
|
|
157
|
+
pages.set(browser, opened);
|
|
158
|
+
}
|
|
159
|
+
return opened;
|
|
160
|
+
};
|
|
161
|
+
const call = async (run) => {
|
|
162
|
+
const opened = await page();
|
|
163
|
+
if (!opened.ok)
|
|
164
|
+
return Result.failure({ ...opened.error, engine: browser });
|
|
165
|
+
try {
|
|
166
|
+
const result = await run(opened.value);
|
|
167
|
+
return result.ok ? result : Result.failure({ _tag: "EngineFailed", engine: browser, message: result.error });
|
|
168
|
+
}
|
|
169
|
+
catch (error) {
|
|
170
|
+
return Result.failure({ _tag: "EngineFailed", engine: browser, message: messageOf(error) });
|
|
171
|
+
}
|
|
172
|
+
};
|
|
173
|
+
// These functions are sent to the page as source and run there: they reach only the page's globals.
|
|
174
|
+
// What crosses is the replay file in, and plain results out.
|
|
175
|
+
return {
|
|
176
|
+
name: browser,
|
|
177
|
+
trace: (file) => call((opened) => opened.evaluate((input) => Reflect.get(globalThis, "__ritmoRunner").trace(input), file)),
|
|
178
|
+
snapshotAt: (file, tick) => call((opened) => opened.evaluate((input) => Reflect.get(globalThis, "__ritmoRunner").snapshotAt(input.file, input.tick), { file, tick }))
|
|
179
|
+
};
|
|
180
|
+
};
|
|
181
|
+
return {
|
|
182
|
+
engines: options.browsers.map(engine),
|
|
183
|
+
close: async () => {
|
|
184
|
+
await Promise.all(closers.splice(0).map((close) => close().catch(() => undefined)));
|
|
185
|
+
const started = await server;
|
|
186
|
+
server = undefined;
|
|
187
|
+
pages.clear();
|
|
188
|
+
if (started?.ok === true)
|
|
189
|
+
await started.value.close();
|
|
190
|
+
}
|
|
191
|
+
};
|
|
192
|
+
};
|
|
193
|
+
//# sourceMappingURL=PlaywrightEngine.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"PlaywrightEngine.js","sourceRoot":"","sources":["../src/PlaywrightEngine.ts"],"names":[],"mappings":"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"}
|
package/dist/Replay.d.ts
CHANGED
|
@@ -4,7 +4,8 @@
|
|
|
4
4
|
*
|
|
5
5
|
* A replay is a debug artifact, not a long-term test: open it, find the bug
|
|
6
6
|
* with `why` / `journal`, `extract` the few ticks that show it into a test,
|
|
7
|
-
* then delete the replay.
|
|
7
|
+
* then delete the replay. `Fuzz.run` writes one too: the shrunk input that
|
|
8
|
+
* breaks an invariant, ready to become that test.
|
|
8
9
|
*
|
|
9
10
|
* - `recorder(runtime, options)` keeps a rolling window of one schedule's
|
|
10
11
|
* ticks: periodic world snapshots (so the window has a start), what each
|
|
@@ -12,8 +13,8 @@
|
|
|
12
13
|
* (stored as changes from the previous tick), and every `runtime.send`.
|
|
13
14
|
* Time and randomness live in the world, so that is everything the
|
|
14
15
|
* simulation reads. `save(reason)` hands the file to a `Sink`.
|
|
15
|
-
* - `session(make, file)` restores the start and replays
|
|
16
|
-
* normal devtools `Session`; `verify` replays twice and compares the
|
|
16
|
+
* - `session(make, file, { invariants })` restores the start and replays
|
|
17
|
+
* the ticks in a normal devtools `Session`; `verify` replays twice and compares the
|
|
17
18
|
* checkpoint hashes to find nondeterminism; `extract` cuts a range of
|
|
18
19
|
* ticks into a small replay with its own start, for a test.
|
|
19
20
|
*
|
|
@@ -58,7 +59,7 @@ import * as Rendered from "./Rendered.ts";
|
|
|
58
59
|
import * as Session from "./Session.ts";
|
|
59
60
|
type AnySchedule<S extends Schema.Any, Root> = ExecutableScheduleDefinition<S, any, Root, any, any, AnyScheduleOrder>;
|
|
60
61
|
/** The `@typeonce/ritmo-devtools` version written into replay files. */
|
|
61
|
-
export declare const version = "0.
|
|
62
|
+
export declare const version = "0.15.0";
|
|
62
63
|
type ServiceNeeds<Schedule> = Extract<Requirement.Of<Schedule>, Descriptor<"service", string, any>>;
|
|
63
64
|
type UnrecordableService<Need> = Need extends Descriptor<"service", infer Name, infer Value> ? Value extends Source<infer Data> ? IsPlain<Data> extends true ? never : `${Name}: its snapshot() returns data that is not plain (no functions, maps, or class instances), so it cannot be saved` : IsPlain<Value> extends true ? never : `${Name} is neither a snapshot() source of plain data nor plain data: give the simulation its input through a source, and its effects on the host through events or resources` : never;
|
|
64
65
|
/**
|
|
@@ -194,13 +195,25 @@ export type ReplayError = {
|
|
|
194
195
|
};
|
|
195
196
|
/** Checks the shape of untrusted replay data (`JSON.parse` output). */
|
|
196
197
|
export declare const parse: (data: unknown) => Result.Result<ReplayFile, ReplayError>;
|
|
198
|
+
/** What a `snapshot()` source service returns: the data a replay records and a fuzzed input generates. */
|
|
199
|
+
export type SourceData<Value extends Source<unknown>> = ReturnType<Value["snapshot"]>;
|
|
200
|
+
/**
|
|
201
|
+
* Rejects a source service a plain recorded source could not stand in for:
|
|
202
|
+
* one declared as the whole device, with more than `snapshot()` (`rebind`,
|
|
203
|
+
* `dispose`). Resolves to `unknown` for a `snapshot()`-only source.
|
|
204
|
+
*/
|
|
205
|
+
export type ValidateSource<Name extends string, Value extends Source<unknown>> = Source<SourceData<Value>> extends Value ? unknown : `${Name} has more than snapshot(), so a replay cannot provide it: declare the service as only its snapshot() source (InputCapture.SourceOf<typeof device> for browser input), and keep the device in the host`;
|
|
197
206
|
/**
|
|
198
207
|
* What a replay hands the game's `make` function: the recorded input, as
|
|
199
208
|
* sources to provide in place of the live ones, and the recorded constants.
|
|
200
209
|
*/
|
|
201
210
|
export interface Playback {
|
|
202
|
-
/**
|
|
203
|
-
|
|
211
|
+
/**
|
|
212
|
+
* A source returning, call by call, what the recorded one returned at the
|
|
213
|
+
* current tick. `descriptor` is a `snapshot()`-only source service
|
|
214
|
+
* (`Schedule.Source`, `InputCapture.SourceOf<...>`, `Netcode.Source`).
|
|
215
|
+
*/
|
|
216
|
+
readonly source: <const Name extends string, Value extends Source<unknown>>(descriptor: Descriptor<"service", Name, Value> & ValidateSource<Name, Value>) => Source<SourceData<Value>>;
|
|
204
217
|
/** A constant service's recorded value (`undefined` if it was not recorded). */
|
|
205
218
|
readonly constant: <const Name extends string, Value>(descriptor: Descriptor<"service", Name, Value>) => unknown;
|
|
206
219
|
}
|
|
@@ -210,15 +223,26 @@ export interface Playback {
|
|
|
210
223
|
* name, and the clock the replay session times runs with
|
|
211
224
|
* (`HostClock.test()` for identical text output).
|
|
212
225
|
*/
|
|
213
|
-
export interface Target<S extends Schema.Any, Root> {
|
|
226
|
+
export interface Target<S extends Schema.Any, Root, Schedules extends Readonly<Record<string, AnySchedule<S, Root>>> = Readonly<Record<string, AnySchedule<S, Root>>>, Services extends Record<string, unknown> = Record<string, unknown>, Resources extends object = object, Machines extends Record<string, unknown> = Record<string, unknown>> {
|
|
214
227
|
readonly hostClock: HostClock.HostClock;
|
|
215
|
-
readonly runtime: Session.Target<S, Root> & {
|
|
228
|
+
readonly runtime: Session.Target<S, Root, Services, Resources, Machines> & {
|
|
216
229
|
readonly snapshot: () => Result.Result<Snapshot.WorldSnapshot, Snapshot.SnapshotError>;
|
|
217
230
|
readonly checksum: () => Result.Result<string, Snapshot.SnapshotError>;
|
|
218
231
|
readonly restore: (data: unknown) => Result.Result<void, Snapshot.RestoreError>;
|
|
219
232
|
readonly send: (descriptor: never, value: never) => void;
|
|
220
233
|
};
|
|
221
|
-
readonly schedules:
|
|
234
|
+
readonly schedules: Schedules;
|
|
235
|
+
}
|
|
236
|
+
/** How `session` checks the replayed ticks and names what they touch. */
|
|
237
|
+
export interface SessionOptions<Invariants extends ReadonlyArray<Invariant<Invariant.CheckInspector>> = readonly [], Labels extends Session.LabelsInspector = never> {
|
|
238
|
+
/**
|
|
239
|
+
* Checked after every replayed tick, as in `Session.make`: `play` stops at
|
|
240
|
+
* the first violation. Pass the invariants a `Fuzz.run` found broken, so
|
|
241
|
+
* the replay stops where the bug shows.
|
|
242
|
+
*/
|
|
243
|
+
readonly invariants?: Invariants;
|
|
244
|
+
/** Names entities in the session's text, as `Session.make`'s `labels` does. */
|
|
245
|
+
readonly labels?: Labels;
|
|
222
246
|
}
|
|
223
247
|
/** What one `ReplaySession.play` did: the session run, and the checkpoints that differ. */
|
|
224
248
|
export interface PlayResult {
|
|
@@ -242,24 +266,18 @@ export interface ReplaySession<S extends Schema.Any, Names extends string> {
|
|
|
242
266
|
}) => Rendered.Rendered<PlayResult>;
|
|
243
267
|
/** Hashes of the world at the end of each replayed tick so far. */
|
|
244
268
|
readonly hashes: () => ReadonlyMap<number, string>;
|
|
245
|
-
/** The world as plain data now, or the value
|
|
269
|
+
/** The world as plain data now, or the value a `"~encode"` rejected. */
|
|
246
270
|
readonly snapshot: () => Result.Result<Snapshot.WorldSnapshot, Snapshot.SnapshotError>;
|
|
247
271
|
}
|
|
248
272
|
/**
|
|
249
273
|
* Opens a replay: builds the game with `make(playback)`, checks the schema,
|
|
250
|
-
* restores the start, and returns a session ready to `play
|
|
251
|
-
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
*
|
|
255
|
-
* mean the simulation reads something the replay does not hold (wall time,
|
|
256
|
-
* `Math.random`, host state).
|
|
274
|
+
* restores the start, and returns a session ready to `play`, checking
|
|
275
|
+
* `options.invariants` after every tick and naming entities with
|
|
276
|
+
* `options.labels`, as `Session.make` does. An invariant or a labels
|
|
277
|
+
* inspector that reads something the runtime does not provide does not
|
|
278
|
+
* compile.
|
|
257
279
|
*/
|
|
258
|
-
export declare const
|
|
259
|
-
readonly deterministic: boolean;
|
|
260
|
-
readonly firstDifference: number | undefined;
|
|
261
|
-
readonly diverged: PlayResult["diverged"];
|
|
262
|
-
}>, ReplayError>;
|
|
280
|
+
export declare const session: <S extends Schema.Any, Root, Schedules extends Readonly<Record<string, AnySchedule<S, Root>>>, Services extends Record<string, unknown>, Resources extends object, Machines extends Record<string, unknown>, const Invariants extends ReadonlyArray<Invariant<Invariant.CheckInspector>> = readonly [], const Labels extends Session.LabelsInspector<Root> = never>(make: (playback: Playback) => Target<S, Root, Schedules, Services, Resources, Machines>, file: ReplayFile, options?: SessionOptions<Invariants, Labels> & Session.ValidateInvariants<Invariants, Services, Resources, Machines> & Session.ValidateLabels<Labels, Services, Resources, Machines>) => Result.Result<ReplaySession<S, string>, ReplayError>;
|
|
263
281
|
/**
|
|
264
282
|
* Cuts ticks `from`..`to` (recorder tick numbers) into a smaller replay that
|
|
265
283
|
* starts at the end of tick `from - 1`: few enough ticks to keep next to a
|
package/dist/Replay.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"Replay.d.ts","sourceRoot":"","sources":["../src/Replay.ts"],"names":[],"mappings":"AAAA
|
|
1
|
+
{"version":3,"file":"Replay.d.ts","sourceRoot":"","sources":["../src/Replay.ts"],"names":[],"mappings":"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"}
|
package/dist/Replay.js
CHANGED
|
@@ -78,7 +78,7 @@ export const recorder = (runtime, options) => {
|
|
|
78
78
|
const broken = new Set();
|
|
79
79
|
const takePoint = () => {
|
|
80
80
|
const snapshot = runtime.snapshot();
|
|
81
|
-
// A tick whose world
|
|
81
|
+
// A tick whose world a `"~encode"` rejects is no starting point; the window keeps the previous one.
|
|
82
82
|
if (!snapshot.ok)
|
|
83
83
|
return;
|
|
84
84
|
points.push({ tick, snapshot: snapshot.value, pendingCommands: runtime.debug.dump({ limit: 0 }).pendingCommands.length });
|
|
@@ -110,7 +110,7 @@ export const recorder = (runtime, options) => {
|
|
|
110
110
|
const save = (reason) => {
|
|
111
111
|
const start = points[0];
|
|
112
112
|
if (start === undefined)
|
|
113
|
-
throw new Error("no tick of this run could be saved:
|
|
113
|
+
throw new Error("no tick of this run could be saved: a `~encode` rejected the world every time (see runtime.snapshot())");
|
|
114
114
|
const file = {
|
|
115
115
|
format: "ritmo-replay",
|
|
116
116
|
version: 1,
|
|
@@ -219,9 +219,13 @@ export const parse = (data) => {
|
|
|
219
219
|
};
|
|
220
220
|
/**
|
|
221
221
|
* Opens a replay: builds the game with `make(playback)`, checks the schema,
|
|
222
|
-
* restores the start, and returns a session ready to `play
|
|
222
|
+
* restores the start, and returns a session ready to `play`, checking
|
|
223
|
+
* `options.invariants` after every tick and naming entities with
|
|
224
|
+
* `options.labels`, as `Session.make` does. An invariant or a labels
|
|
225
|
+
* inspector that reads something the runtime does not provide does not
|
|
226
|
+
* compile.
|
|
223
227
|
*/
|
|
224
|
-
export const session = (make, file) => {
|
|
228
|
+
export const session = (make, file, options) => {
|
|
225
229
|
/** The last tick replayed (the start's tick before any). */
|
|
226
230
|
let ran = file.start.tick;
|
|
227
231
|
let calls = new Map();
|
|
@@ -240,7 +244,8 @@ export const session = (make, file) => {
|
|
|
240
244
|
constant: (descriptor) => file.constants[descriptor.name]
|
|
241
245
|
};
|
|
242
246
|
const target = make(playback);
|
|
243
|
-
const
|
|
247
|
+
const schedules = target.schedules;
|
|
248
|
+
const schedule = schedules[file.schedule];
|
|
244
249
|
if (schedule === undefined)
|
|
245
250
|
return Result.failure({ _tag: "MissingSchedule", schedule: file.schedule });
|
|
246
251
|
const current = schemaHash(target.runtime.debug);
|
|
@@ -250,7 +255,16 @@ export const session = (make, file) => {
|
|
|
250
255
|
const restored = target.runtime.restore(file.start.snapshot);
|
|
251
256
|
if (!restored.ok)
|
|
252
257
|
return Result.failure({ _tag: "RestoreFailed", error: restored.error });
|
|
253
|
-
const
|
|
258
|
+
const runtime = target.runtime;
|
|
259
|
+
// The signature checked the invariants and the labels against this runtime's provisions.
|
|
260
|
+
const invariants = (options?.invariants ?? []);
|
|
261
|
+
const labels = options?.labels;
|
|
262
|
+
const replay = Session.make(runtime, {
|
|
263
|
+
schedules: { [file.schedule]: schedule },
|
|
264
|
+
hostClock: target.hostClock,
|
|
265
|
+
invariants,
|
|
266
|
+
...(labels === undefined ? {} : { labels })
|
|
267
|
+
});
|
|
254
268
|
const send = target.runtime.send;
|
|
255
269
|
const events = new Map(target.runtime.debug.describe().events.map(({ name }) => [name, { kind: "event", name, key: Symbol.for(`ritmo/event/${name}`) }]));
|
|
256
270
|
const hashes = new Map([[ran, worldHash(target.runtime.checksum())]]);
|
|
@@ -299,27 +313,6 @@ export const session = (make, file) => {
|
|
|
299
313
|
snapshot: () => target.runtime.snapshot()
|
|
300
314
|
});
|
|
301
315
|
};
|
|
302
|
-
/**
|
|
303
|
-
* Replays twice and compares the world after every tick: different hashes
|
|
304
|
-
* mean the simulation reads something the replay does not hold (wall time,
|
|
305
|
-
* `Math.random`, host state).
|
|
306
|
-
*/
|
|
307
|
-
export const verify = (make, file) => {
|
|
308
|
-
const first = session(make, file);
|
|
309
|
-
if (!first.ok)
|
|
310
|
-
return first;
|
|
311
|
-
const second = session(make, file);
|
|
312
|
-
if (!second.ok)
|
|
313
|
-
return second;
|
|
314
|
-
const played = first.value.play();
|
|
315
|
-
second.value.play();
|
|
316
|
-
const ticks = [...first.value.hashes().keys()].sort((left, right) => left - right);
|
|
317
|
-
const firstDifference = ticks.find((tick) => first.value.hashes().get(tick) !== second.value.hashes().get(tick));
|
|
318
|
-
const deterministic = firstDifference === undefined;
|
|
319
|
-
return Result.success(Rendered.make({ deterministic, firstDifference, diverged: played.data.diverged }, deterministic
|
|
320
|
-
? `deterministic over ${ticks.length - 1} ticks${played.data.diverged.length === 0 ? ", and matches the recording" : `, but differs from the recording at tick ${played.data.diverged[0].tick}`}`
|
|
321
|
-
: `NOT deterministic: two replays differ from tick ${firstDifference}`));
|
|
322
|
-
};
|
|
323
316
|
/**
|
|
324
317
|
* Cuts ticks `from`..`to` (recorder tick numbers) into a smaller replay that
|
|
325
318
|
* starts at the end of tick `from - 1`: few enough ticks to keep next to a
|