Initial commit of Descrybe v2 without local scratch artifacts.

Drop one-shot tmp/axe scripts and agent i18n scratch so the Gitea tree is deployable.
2026-08-09 22:47:43 +02:00
commit 8580c996c3
1285 changed files with 325780 additions and 0 deletions
@@ -0,0 +1,120 @@
+/**
+ * cutover-readiness-poll unit tests (node:test).
+ *
+ * Run from apps/web:
+ *   node --experimental-strip-types --test src/lib/cutover-readiness-poll.test.ts
+ */
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+
+import {
+	CUTOVER_READINESS_POLL_MS,
+	shouldRunCutoverReadinessFetch
+} from "./cutover-readiness-poll.ts";
+
+describe("cutover-readiness-poll", () => {
+	it("exports a 60s poll interval", () => {
+		assert.equal(CUTOVER_READINESS_POLL_MS, 60_000);
+	});
+
+	it("allows the first attempt when visible and idle", () => {
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 1_000,
+				lastAttemptAtMs: 0,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: true,
+				inFlight: false
+			}),
+			true
+		);
+	});
+
+	it("blocks while a request is in flight", () => {
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 1_000,
+				lastAttemptAtMs: 0,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: true,
+				inFlight: true
+			}),
+			false
+		);
+	});
+
+	it("blocks when the document is hidden", () => {
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 1_000,
+				lastAttemptAtMs: 0,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: false,
+				inFlight: false
+			}),
+			false
+		);
+	});
+
+	it("throttles repeats inside the min interval", () => {
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 30_000,
+				lastAttemptAtMs: 1_000,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: true,
+				inFlight: false
+			}),
+			false
+		);
+	});
+
+	it("allows a repeat after the min interval", () => {
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 61_000,
+				lastAttemptAtMs: 1_000,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: true,
+				inFlight: false
+			}),
+			true
+		);
+	});
+
+	it("force bypasses the min interval but not hidden/in-flight", () => {
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 2_000,
+				lastAttemptAtMs: 1_000,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: true,
+				inFlight: false,
+				force: true
+			}),
+			true
+		);
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 2_000,
+				lastAttemptAtMs: 1_000,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: false,
+				inFlight: false,
+				force: true
+			}),
+			false
+		);
+		assert.equal(
+			shouldRunCutoverReadinessFetch({
+				nowMs: 2_000,
+				lastAttemptAtMs: 1_000,
+				minIntervalMs: CUTOVER_READINESS_POLL_MS,
+				documentVisible: true,
+				inFlight: true,
+				force: true
+			}),
+			false
+		);
+	});
+});