@le-space/playwright 0.6.29 → 0.6.30

package/index.d.ts

@@ -139,6 +139,8 @@ interface CleanupRelayOptions {
     account: RelayWalletAccount;
     instanceName: string;
     instanceHash: string;
+    /** Guest-published relay-bootstrap POST to verify after graceful VM shutdown. */
+    registrationHash?: string;
     driver?: RelayButtonDriver;
     apiHosts?: readonly string[];
     schedulerUrl?: string;
@@ -157,6 +159,7 @@ interface CleanupRelayResult {
     eraseSummary: string;
     forgetSummary: string;
     verificationSummary: string;
+    registrationVerificationSummary?: string;
 }
 interface CleanupRelayHooks {
     erase?: typeof eraseInstanceOnCrn;
@@ -237,6 +240,13 @@ declare function waitForAlephInstanceDeletion(options: {
     pollIntervalMs?: number;
     fetch?: typeof fetch;
 }): Promise<string>;
+declare function waitForAlephMessageForgotten(options: {
+    messageHash: string;
+    apiHosts?: readonly string[];
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    fetch?: typeof fetch;
+}): Promise<string>;
 declare function cleanupRelay(options: CleanupRelayOptions): Promise<CleanupRelayResult>;
 declare function createRelayEvidence(options: {
     instanceName: string;
@@ -255,4 +265,4 @@ declare function createRelayTest(options: CreateRelayTestOptions): _playwright_t
     relayLifecycle: RelayLifecycleFixture;
 }, _playwright_test.PlaywrightWorkerArgs & _playwright_test.PlaywrightWorkerOptions>;
 
-export { type AlephChromiumConnector, type AlephCostEvidence, type AlephCreditBalanceSnapshot, type AlephPricingSnapshot, type AlephRemoteBrowserOptions, type AlephRunnerInstanceCandidate, type AlephRunnerJanitorSelection, type CleanupRelayHooks, type CleanupRelayOptions, type CleanupRelayResult, type CreateRelayTestOptions, DEFAULT_ALEPH_SCHEDULER_URL, PLAYWRIGHT_RUNNER_VERSION, type ProvisionRelayOptions, type ProvisionedRelay, type RelayAddressPolicy, RelayButtonDriver, type RelayButtonDriverOptions, type RelayEvidence, type RelayEvidenceStep, type RelayLifecycleFixture, type RelayWalletAccount, SUPPORTED_ALEPH_API_HOSTS, type WaitForPubsubSubscriberOptions, appendRelayGithubSummary, buildAlephCostEvidence, cleanupRelay, connectAlephChromium, createRelayEvidence, createRelayTest, findAlephInstanceHash, formatAlephCostGithubSummary, formatRelayGithubSummary, installEip1193WalletMock, provisionRelay, resolveAlephApiHosts, selectBrowserRelayAddresses, selectExpiredAlephPlaywrightRunners, updateRelayEvidenceStep, waitForAlephInstanceDeletion, waitForBootstrapRegistration, waitForDeployableManifest, waitForPubsubSubscriber, writeRelayEvidence };
+export { type AlephChromiumConnector, type AlephCostEvidence, type AlephCreditBalanceSnapshot, type AlephPricingSnapshot, type AlephRemoteBrowserOptions, type AlephRunnerInstanceCandidate, type AlephRunnerJanitorSelection, type CleanupRelayHooks, type CleanupRelayOptions, type CleanupRelayResult, type CreateRelayTestOptions, DEFAULT_ALEPH_SCHEDULER_URL, PLAYWRIGHT_RUNNER_VERSION, type ProvisionRelayOptions, type ProvisionedRelay, type RelayAddressPolicy, RelayButtonDriver, type RelayButtonDriverOptions, type RelayEvidence, type RelayEvidenceStep, type RelayLifecycleFixture, type RelayWalletAccount, SUPPORTED_ALEPH_API_HOSTS, type WaitForPubsubSubscriberOptions, appendRelayGithubSummary, buildAlephCostEvidence, cleanupRelay, connectAlephChromium, createRelayEvidence, createRelayTest, findAlephInstanceHash, formatAlephCostGithubSummary, formatRelayGithubSummary, installEip1193WalletMock, provisionRelay, resolveAlephApiHosts, selectBrowserRelayAddresses, selectExpiredAlephPlaywrightRunners, updateRelayEvidenceStep, waitForAlephInstanceDeletion, waitForAlephMessageForgotten, waitForBootstrapRegistration, waitForDeployableManifest, waitForPubsubSubscriber, writeRelayEvidence };

package/index.js

@@ -489,6 +489,35 @@ async function waitForAlephInstanceDeletion(options) {
   }
   throw new Error(`Aleph INSTANCE ${options.instanceHash} was not deleted within ${options.timeoutMs ?? 5 * 6e4}ms: ${lastSummary}`);
 }
+async function waitForAlephMessageForgotten(options) {
+  const fetchImpl = options.fetch ?? globalThis.fetch?.bind(globalThis);
+  if (!fetchImpl) throw new Error("A fetch implementation is required for cleanup verification");
+  const hosts = resolveAlephApiHosts(options.apiHosts);
+  const deadline = Date.now() + (options.timeoutMs ?? 2 * 6e4);
+  let lastSummary = "Bootstrap deregistration has not been observed yet.";
+  while (Date.now() < deadline) {
+    let forgottenOnAllReplicas = true;
+    const observations = [];
+    for (const apiHost of hosts) {
+      try {
+        const response = await fetchImpl(new URL(`/api/v0/messages/${options.messageHash}`, apiHost), { cache: "no-cache" });
+        const payload = await response.json().catch(() => null);
+        const forgotten = payload?.status === "forgotten" || Boolean(payload?.forgotten_by?.length);
+        forgottenOnAllReplicas &&= forgotten;
+        observations.push(`${apiHost}: ${forgotten ? "forgotten" : payload?.status ?? `HTTP ${response.status}`}`);
+      } catch (error) {
+        forgottenOnAllReplicas = false;
+        observations.push(`${apiHost}: ${error instanceof Error ? error.message : String(error)}`);
+      }
+    }
+    lastSummary = observations.join("; ");
+    if (forgottenOnAllReplicas) return lastSummary;
+    await delay(options.pollIntervalMs ?? 2e3);
+  }
+  throw new Error(
+    `Aleph bootstrap registration ${options.messageHash} was not deregistered within ${options.timeoutMs ?? 2 * 6e4}ms: ${lastSummary}`
+  );
+}
 async function cleanupRelay(options) {
   if (!/^[a-f0-9]{64}$/iu.test(options.instanceHash)) {
     throw new Error(`Invalid Aleph INSTANCE hash: ${options.instanceHash}`);
@@ -516,13 +545,21 @@ async function cleanupRelay(options) {
         pollIntervalMs: options.pollIntervalMs,
         fetch: fetchImpl
       });
+      const registrationVerificationSummary2 = options.registrationHash ? await waitForAlephMessageForgotten({
+        messageHash: options.registrationHash,
+        apiHosts: hosts,
+        timeoutMs: options.timeoutMs,
+        pollIntervalMs: options.pollIntervalMs,
+        fetch: fetchImpl
+      }) : void 0;
       return {
         instanceHash: options.instanceHash,
         uiDeleteRequested,
         fallbackUsed: false,
         eraseSummary: "Relay Button UI requested runtime erase",
         forgetSummary: "Relay Button UI submitted FORGET",
-        verificationSummary: verificationSummary2
+        verificationSummary: verificationSummary2,
+        registrationVerificationSummary: registrationVerificationSummary2
       };
     } catch {
     }
@@ -584,13 +621,21 @@ async function cleanupRelay(options) {
     pollIntervalMs: options.pollIntervalMs,
     fetch: fetchImpl
   });
+  const registrationVerificationSummary = options.registrationHash ? await waitForAlephMessageForgotten({
+    messageHash: options.registrationHash,
+    apiHosts: hosts,
+    timeoutMs: options.timeoutMs,
+    pollIntervalMs: options.pollIntervalMs,
+    fetch: fetchImpl
+  }) : void 0;
   return {
     instanceHash: options.instanceHash,
     uiDeleteRequested,
     fallbackUsed: true,
     eraseSummary,
     forgetSummary,
-    verificationSummary
+    verificationSummary,
+    registrationVerificationSummary
   };
 }
 function createRelayEvidence(options) {
@@ -705,6 +750,7 @@ function createRelayTest(options) {
                   account: options.account,
                   instanceName: relay.instanceName,
                   instanceHash: relay.instanceHash,
+                  registrationHash: relay.registration.itemHash ?? relay.registration.hash ?? void 0,
                   driver: relay.driver
                 })
               );
@@ -745,6 +791,7 @@ export {
   selectExpiredAlephPlaywrightRunners,
   updateRelayEvidenceStep,
   waitForAlephInstanceDeletion,
+  waitForAlephMessageForgotten,
   waitForBootstrapRegistration,
   waitForDeployableManifest,
   waitForPubsubSubscriber,

package/package.json

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