@le-space/playwright 0.8.0 → 0.9.1

package/index.d.ts

@@ -316,6 +316,22 @@ declare function waitForAlephMessageForgotten(options: {
     pollIntervalMs?: number;
     fetch?: typeof fetch;
 }): Promise<string>;
+/**
+ * The address that published `messageHash`, or `null` when no replica will say.
+ *
+ * Aleph only honours a FORGET signed by a message's original sender, so this is
+ * what decides whether a cleanup account has any power over a message at all.
+ *
+ * `null` means "could not be read" — never "not owned". Callers must treat the
+ * two differently: an unreadable sender is a transient API problem, and turning
+ * it into a hard failure would make cleanup flaky for reasons unrelated to the
+ * relay being cleaned up.
+ */
+declare function resolveAlephMessageSender(options: {
+    messageHash: string;
+    apiHosts?: readonly string[];
+    fetch?: typeof fetch;
+}): Promise<string | null>;
 declare function cleanupRelay(options: CleanupRelayOptions): Promise<CleanupRelayResult>;
 declare function createRelayEvidence(options: {
     instanceName: string;
@@ -334,4 +350,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, type ForwardBrowserConsoleOptions, LIBP2P_DIAGNOSTIC_CONSOLE_FILTER, PLAYWRIGHT_RUNNER_VERSION, type ProgressLogger, 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, createProgressLogger, createRelayEvidence, createRelayTest, findAlephInstanceHash, formatAlephCostGithubSummary, formatRelayGithubSummary, forwardBrowserConsole, installEip1193WalletMock, provisionRelay, resolveAlephApiHosts, selectBrowserRelayAddresses, selectExpiredAlephPlaywrightRunners, updateRelayEvidenceStep, waitForAlephInstanceDeletion, waitForAlephMessageForgotten, 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, type ForwardBrowserConsoleOptions, LIBP2P_DIAGNOSTIC_CONSOLE_FILTER, PLAYWRIGHT_RUNNER_VERSION, type ProgressLogger, 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, createProgressLogger, createRelayEvidence, createRelayTest, findAlephInstanceHash, formatAlephCostGithubSummary, formatRelayGithubSummary, forwardBrowserConsole, installEip1193WalletMock, provisionRelay, resolveAlephApiHosts, resolveAlephMessageSender, selectBrowserRelayAddresses, selectExpiredAlephPlaywrightRunners, updateRelayEvidenceStep, waitForAlephInstanceDeletion, waitForAlephMessageForgotten, waitForBootstrapRegistration, waitForDeployableManifest, waitForPubsubSubscriber, writeRelayEvidence };

package/index.js

@@ -573,6 +573,22 @@ async function waitForAlephMessageForgotten(options) {
     `Aleph bootstrap registration ${options.messageHash} was not deregistered within ${options.timeoutMs ?? 2 * 6e4}ms: ${lastSummary}`
   );
 }
+async function resolveAlephMessageSender(options) {
+  const fetchImpl = options.fetch ?? globalThis.fetch?.bind(globalThis);
+  if (!fetchImpl) throw new Error("A fetch implementation is required to resolve a message sender");
+  for (const apiHost of resolveAlephApiHosts(options.apiHosts)) {
+    try {
+      const response = await fetchImpl(new URL(`/api/v0/messages/${options.messageHash}`, apiHost), {
+        cache: "no-cache"
+      });
+      const payload = await response.json().catch(() => null);
+      const sender = payload?.message?.sender;
+      if (typeof sender === "string" && sender.length > 0) return sender;
+    } catch {
+    }
+  }
+  return null;
+}
 async function cleanupRelay(options) {
   if (!/^[a-f0-9]{64}$/iu.test(options.instanceHash)) {
     throw new Error(`Invalid Aleph INSTANCE hash: ${options.instanceHash}`);
@@ -585,6 +601,35 @@ async function cleanupRelay(options) {
   const forget = options.hooks?.forget ?? forgetAlephMessages;
   const hosts = resolveAlephApiHosts(options.apiHosts);
   let uiDeleteRequested = false;
+  let ownership;
+  const resolveRegistrationOwnership = async () => {
+    if (!ownership) {
+      const sender = options.registrationHash ? await resolveAlephMessageSender({
+        messageHash: options.registrationHash,
+        apiHosts: hosts,
+        fetch: fetchImpl
+      }) : null;
+      ownership = {
+        owned: sender !== null && sender.toLowerCase() === options.account.address.toLowerCase(),
+        sender
+      };
+    }
+    return ownership;
+  };
+  const verifyRegistrationDeregistered = async () => {
+    if (!options.registrationHash) return void 0;
+    const { owned, sender } = await resolveRegistrationOwnership();
+    if (!owned) {
+      return sender === null ? `Bootstrap registration ${options.registrationHash} was not awaited: its sender could not be read from any Aleph replica.` : `Bootstrap registration ${options.registrationHash} was not awaited: it belongs to ${sender}, not the cleanup account ${options.account.address}, so only the relay itself can deregister it.`;
+    }
+    return waitForAlephMessageForgotten({
+      messageHash: options.registrationHash,
+      apiHosts: hosts,
+      timeoutMs: options.timeoutMs,
+      pollIntervalMs: options.pollIntervalMs,
+      fetch: fetchImpl
+    });
+  };
   try {
     await driver.requestDelete(options.instanceName);
     uiDeleteRequested = true;
@@ -600,13 +645,7 @@ 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;
+      const registrationVerificationSummary2 = await verifyRegistrationDeregistered();
       return {
         instanceHash: options.instanceHash,
         uiDeleteRequested,
@@ -644,11 +683,13 @@ async function cleanupRelay(options) {
   const hasher = (content) => createHash("sha256").update(content).digest("hex");
   let forgetSummary = "";
   let lastForgetError = "No Aleph API host attempted.";
+  const { owned: registrationOwned } = await resolveRegistrationOwnership();
+  const forgetHashes = registrationOwned && options.registrationHash ? [options.instanceHash, options.registrationHash] : [options.instanceHash];
   for (const apiHost of hosts) {
     try {
       const result = await forget({
         sender: options.account.address,
-        hashes: [options.instanceHash],
+        hashes: forgetHashes,
         reason: "Relay Button Playwright cleanup",
         signer,
         hasher,
@@ -676,13 +717,7 @@ 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;
+  const registrationVerificationSummary = await verifyRegistrationDeregistered();
   return {
     instanceHash: options.instanceHash,
     uiDeleteRequested,
@@ -845,6 +880,7 @@ export {
   installEip1193WalletMock,
   provisionRelay,
   resolveAlephApiHosts,
+  resolveAlephMessageSender,
   selectBrowserRelayAddresses,
   selectExpiredAlephPlaywrightRunners,
   updateRelayEvidenceStep,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@le-space/playwright",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "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.8.0",
-    "@le-space/core": "0.8.0"
+    "@le-space/aleph-bootstrap": "0.9.1",
+    "@le-space/core": "0.9.1"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.61.1 <1.62.0"