@le-space/playwright 0.7.0 → 0.9.0

package/index.d.ts

@@ -95,6 +95,17 @@ interface AlephRunnerJanitorSelection {
     retained: Array<AlephRunnerInstanceCandidate & {
         reason: string;
     }>;
+    /**
+     * Instances the janitor may not touch — their name matches none of the
+     * configured prefixes — that are nevertheless past the TTL and still
+     * allocated. These are the invisible credit leaks: two `simple-todo-e2e-*`
+     * VMs burned ~811k credits over 38 h while seven consecutive janitor runs
+     * reported success, because "name I do not recognise" was indistinguishable
+     * from "nothing to do" (NiKrause/simple-todo#88).
+     */
+    unswept: Array<AlephRunnerInstanceCandidate & {
+        ageMs: number;
+    }>;
 }
 interface RelayAddressPolicy {
     allowWebTransport?: boolean;
@@ -206,6 +217,13 @@ declare function selectExpiredAlephPlaywrightRunners(options: {
     repository: string;
     now?: number;
     ttlMs?: number;
+    /**
+     * Extra exact name prefixes to sweep beyond `playwright-<repository>-`.
+     * Ephemeral VMs that a repository names by its own scheme (simple-todo's
+     * relay runners are `simple-todo-e2e-<timestamp>`) never matched the
+     * repository prefix and so leaked forever (#88).
+     */
+    additionalNamePrefixes?: readonly string[];
 }): AlephRunnerJanitorSelection;
 declare function waitForPubsubSubscriber(page: Page, options: WaitForPubsubSubscriberOptions): Promise<string[]>;
 /**

package/index.js

@@ -156,22 +156,29 @@ function selectExpiredAlephPlaywrightRunners(options) {
   const repository = options.repository.trim().toLowerCase().replace(/[^a-z0-9]+/gu, "-");
   if (!/^0x[a-f0-9]{40}$/u.test(owner)) throw new Error("Janitor requires an exact EVM owner address");
   if (!repository) throw new Error("Janitor requires a repository name");
-  const prefix = `playwright-${repository}-`;
+  const prefixes = [
+    `playwright-${repository}-`,
+    ...(options.additionalNamePrefixes ?? []).map((value) => value.trim().toLowerCase()).filter(Boolean)
+  ];
   const now = options.now ?? Date.now();
   const ttlMs = options.ttlMs ?? 60 * 6e4;
   if (!Number.isFinite(ttlMs) || ttlMs < 15 * 6e4) throw new Error("Janitor TTL must be at least 15 minutes");
-  const selection = { expired: [], retained: [] };
+  const selection = { expired: [], retained: [], unswept: [] };
   for (const candidate of options.candidates) {
     let reason = "";
     const createdAt = Date.parse(candidate.createdAt);
     if (!/^[a-f0-9]{64}$/iu.test(candidate.itemHash)) reason = "invalid exact INSTANCE hash";
     else if (candidate.ownerAddress.toLowerCase() !== owner) reason = "different owner";
-    else if (!candidate.instanceName.toLowerCase().startsWith(prefix)) reason = "name outside repository scope";
+    else if (!prefixes.some((prefix) => candidate.instanceName.toLowerCase().startsWith(prefix)))
+      reason = "name outside repository scope";
     else if (!Number.isFinite(createdAt)) reason = "invalid creation timestamp";
     else if (now - createdAt < ttlMs) reason = "within TTL";
     else if (!["processed", "pending"].includes(candidate.status.toLowerCase())) reason = `terminal status ${candidate.status}`;
-    if (reason) selection.retained.push({ ...candidate, reason });
-    else selection.expired.push(candidate);
+    if (reason) {
+      selection.retained.push({ ...candidate, reason });
+      if (reason === "name outside repository scope" && Number.isFinite(createdAt) && now - createdAt >= ttlMs && ["processed", "pending"].includes(candidate.status.toLowerCase()))
+        selection.unswept.push({ ...candidate, ageMs: now - createdAt });
+    } else selection.expired.push(candidate);
   }
   return selection;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/playwright",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Reusable Playwright fixtures and Relay Button lifecycle helpers.",
   "license": "MIT",
   "type": "module",
@@ -27,8 +27,8 @@
     "url": "https://github.com/NiKrause/relay-button/issues"
   },
   "dependencies": {
-    "@le-space/aleph-bootstrap": "0.7.0",
-    "@le-space/core": "0.7.0"
+    "@le-space/aleph-bootstrap": "0.9.0",
+    "@le-space/core": "0.9.0"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.61.1 <1.62.0"