@treeseed/sdk 0.12.7 → 0.12.9

package/dist/scenes/builtin-plugins.js

@@ -57,6 +57,27 @@ function extractConfirmationUrl(body) {
   const relative = body.match(/(?:\/auth\/confirm-email\?[^"' <>\n]+|\/team-invites\/[^"' <>\n]+\/accept)/u)?.[0];
   return relative ?? null;
 }
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+function isRetryableNavigationError(error) {
+  const message = error instanceof Error ? error.message : String(error ?? "");
+  return /Timeout|ERR_CONNECTION|ECONNRESET|ECONNREFUSED|ETIMEDOUT|503|502|504/iu.test(message);
+}
+async function navigateScenePage(page, url) {
+  let lastError = null;
+  for (let attempt = 1; attempt <= 3; attempt += 1) {
+    try {
+      await page.goto(url, { waitUntil: "domcontentloaded", timeout: 45e3 });
+      return;
+    } catch (error) {
+      lastError = error;
+      if (!isRetryableNavigationError(error) || attempt >= 3) break;
+      await sleep(500 * attempt);
+    }
+  }
+  throw lastError instanceof Error ? lastError : new Error(String(lastError ?? `Navigation failed for ${url}`));
+}
 async function assertionReport(kind, action, selector) {
   const startedAt = /* @__PURE__ */ new Date();
   try {
@@ -85,7 +106,7 @@ function createBuiltInTreeseedScenePlugins() {
           summary: "Navigate to a route or absolute URL.",
           async run({ action, context }) {
             if (!("goto" in action)) return { ok: false, diagnostics: [sceneErrorDiagnostic("scene.invalid_action", "Expected goto action.", "workflow.action.goto")] };
-            await context.session.page.goto(context.resolveUrl(action.goto));
+            await navigateScenePage(context.session.page, context.resolveUrl(action.goto));
             return { ok: true, diagnostics: [] };
           }
         },
@@ -219,18 +240,18 @@ function createBuiltInTreeseedScenePlugins() {
                 search.searchParams.set("query", `to:${email}`);
                 context.timeline.push("mailpit.inbox.open", { messageId: id, email, url: search.toString() }, step.id);
                 context.progress?.push("mailpit.inbox.open", { messageId: id, email }, { stepId: step.id });
-                await context.session.page.goto(search.toString());
+                await navigateScenePage(context.session.page, search.toString());
                 await context.sleep(displayInboxSeconds * 1e3);
               }
               if (displayMessageSeconds && displayMessageSeconds > 0) {
                 const view = new URL(`view/${encodeURIComponent(id)}`, mailpitBase);
                 context.timeline.push("mailpit.message.open", { messageId: id, email, url: view.toString() }, step.id);
                 context.progress?.push("mailpit.message.open", { messageId: id, email }, { stepId: step.id });
-                await context.session.page.goto(view.toString());
+                await navigateScenePage(context.session.page, view.toString());
                 await context.sleep(displayMessageSeconds * 1e3);
               }
               context.timeline.push("mailpit.confirm.open", { messageId: id, email, url: resolvedUrl }, step.id);
-              await context.session.page.goto(resolvedUrl);
+              await navigateScenePage(context.session.page, resolvedUrl);
               return { ok: true, diagnostics: [] };
             } catch (error) {
               return { ok: false, diagnostics: [sceneErrorDiagnostic("scene.mailpit_unavailable", error instanceof Error ? error.message : String(error ?? "Mailpit confirmation failed."), `workflow.${step.id}.action.mailpitConfirmLatest`)] };

package/dist/scenes/types.d.ts

@@ -1809,7 +1809,10 @@ export type TreeseedSceneLocator = {
     isVisible(): Promise<boolean>;
 };
 export type TreeseedScenePage = {
-    goto(url: string): Promise<void>;
+    goto(url: string, options?: {
+        waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+        timeout?: number;
+    }): Promise<void>;
     url(): string;
     locator(selector: string): TreeseedSceneLocator;
     getByTestId(testId: string): TreeseedSceneLocator;

package/dist/scenes/visual-audit-fixtures.js

@@ -58,6 +58,22 @@ function serviceHeaders(input) {
     "x-treeseed-service-secret": configuredValue(input, "TREESEED_API_WEB_SERVICE_SECRET") ?? configuredValue(input, "TREESEED_WEB_SERVICE_SECRET") ?? "treeseed-web-service-dev-secret"
   };
 }
+async function sleep(ms) {
+  await new Promise((resolve) => setTimeout(resolve, ms));
+}
+function retryDelayMs(attempt) {
+  return Math.min(500 * attempt, 2e3);
+}
+function isRetryableStatus(status) {
+  return [408, 425, 429, 500, 502, 503, 504].includes(status);
+}
+async function gotoSceneFixturePage(page, url) {
+  await page.goto(url, { waitUntil: "domcontentloaded", timeout: 45e3 });
+  await page.waitForLoadState?.("networkidle", { timeout: 5e3 }).catch(() => void 0);
+}
+function isSignInUrl(value) {
+  return /\/auth\/sign-in/u.test(value);
+}
 function seedActorsForRoles(roles) {
   const actors = {};
   for (const role of roles) {
@@ -76,32 +92,33 @@ function seedActorsForRoles(roles) {
 async function seedVisualAuditFixtures(input) {
   const actors = seedActorsForRoles(input.roles);
   if (Object.keys(actors).length === 0) return [];
-  try {
-    const response = await fetch(new URL("/v1/acceptance/seed", input.baseUrl).toString(), {
-      method: "POST",
-      headers: serviceHeaders(input),
-      body: JSON.stringify({
-        namespace: "visual-audit",
-        password: TREESEED_VISUAL_AUDIT_PASSWORD,
-        actors
-      })
-    });
-    const text = await response.text();
-    if (!response.ok) {
-      return [sceneWarningDiagnostic(
-        "scene.visual_audit_fixture_unavailable",
-        `Visual audit API fixture seed failed with HTTP ${response.status}: ${text.slice(0, 500)}`,
-        "roles"
-      )];
+  let lastFailure = null;
+  for (let attempt = 1; attempt <= 3; attempt += 1) {
+    try {
+      const response = await fetch(new URL("/v1/acceptance/seed", input.baseUrl).toString(), {
+        method: "POST",
+        headers: serviceHeaders(input),
+        body: JSON.stringify({
+          namespace: "visual-audit",
+          password: TREESEED_VISUAL_AUDIT_PASSWORD,
+          actors
+        })
+      });
+      const text = await response.text();
+      if (response.ok) return [];
+      lastFailure = `HTTP ${response.status}: ${text.slice(0, 500)}`;
+      if (!isRetryableStatus(response.status) || attempt >= 3) break;
+    } catch (error) {
+      lastFailure = error instanceof Error ? error.message : String(error ?? "local fixture API is unavailable");
+      if (attempt >= 3) break;
     }
-    return [];
-  } catch (error) {
-    return [sceneWarningDiagnostic(
-      "scene.visual_audit_fixture_unavailable",
-      `Visual audit API fixture seed failed against ${input.baseUrl}: ${error instanceof Error ? error.message : String(error ?? "local fixture API is unavailable")}.`,
-      "roles"
-    )];
+    await sleep(retryDelayMs(attempt));
   }
+  return [sceneWarningDiagnostic(
+    "scene.visual_audit_fixture_unavailable",
+    `Visual audit API fixture seed failed against ${input.baseUrl}: ${lastFailure ?? "local fixture API is unavailable"}.`,
+    "roles"
+  )];
 }
 async function ensureTreeseedSceneVisualAuditRoleFixtures(input) {
   const diagnostics = [];
@@ -165,40 +182,54 @@ async function signInTreeseedSceneVisualAuditRole(input) {
     return [sceneErrorDiagnostic("scene.visual_audit_role_unknown", `Visual audit role "${input.role}" has no fixture login.`, "role")];
   }
   const apiBaseUrl = input.apiBaseUrl?.trim() || input.baseUrl;
+  let lastError = null;
   try {
-    const session = await clientFor(apiBaseUrl).webSignIn({ login: user.email, password: user.password });
-    const accessToken = session.payload.accessToken;
-    if (accessToken) {
-      const webUrl = new URL(input.baseUrl);
-      await input.page.context().addCookies([{
-        name: "ts_market_api_access",
-        value: accessToken,
-        domain: webUrl.hostname,
-        path: "/",
-        httpOnly: true,
-        secure: webUrl.protocol === "https:",
-        sameSite: "Lax",
-        expires: Math.floor(Date.now() / 1e3) + Number(session.payload.expiresInSeconds ?? 900)
-      }]);
-      await input.page.goto(new URL("/app/", input.baseUrl).toString(), { waitUntil: "networkidle", timeout: 2e4 });
-      if (!/\/auth\/sign-in/u.test(input.page.url())) return [];
+    for (let attempt = 1; attempt <= 3; attempt += 1) {
+      const session = await clientFor(apiBaseUrl).webSignIn({ login: user.email, password: user.password });
+      const accessToken = session.payload.accessToken;
+      if (accessToken) {
+        const webUrl = new URL(input.baseUrl);
+        await input.page.context().addCookies([{
+          name: "ts_market_api_access",
+          value: accessToken,
+          domain: webUrl.hostname,
+          path: "/",
+          httpOnly: true,
+          secure: webUrl.protocol === "https:",
+          sameSite: "Lax",
+          expires: Math.floor(Date.now() / 1e3) + Number(session.payload.expiresInSeconds ?? 900)
+        }]);
+        await gotoSceneFixturePage(input.page, new URL("/app/", input.baseUrl).toString());
+        if (!isSignInUrl(input.page.url())) return [];
+      }
+      await sleep(retryDelayMs(attempt));
     }
   } catch {
   }
-  try {
-    await input.page.goto(new URL("/auth/sign-in", input.baseUrl).toString(), { waitUntil: "networkidle", timeout: 2e4 });
-    await input.page.locator('input[name="login"], input[name="email"], input[name="emailOrUsername"], input[name="username"]').first().fill(user.email, { timeout: 5e3 });
-    await input.page.locator('input[name="password"]').first().fill(user.password, { timeout: 5e3 });
-    await input.page.getByRole("button", { name: /sign in/i }).click({ timeout: 5e3 });
-    await input.page.waitForLoadState("networkidle", { timeout: 5e3 }).catch(() => void 0);
-    const url = input.page.url();
-    if (/\/auth\/sign-in/u.test(url)) {
-      return [sceneWarningDiagnostic("scene.visual_audit_role_login_failed", `Visual audit login for ${input.role} did not leave the sign-in page. Ensure deterministic fixture user ${user.email} exists.`, "roles")];
+  for (let attempt = 1; attempt <= 3; attempt += 1) {
+    try {
+      const signInUrl = new URL("/auth/sign-in", input.baseUrl);
+      signInUrl.searchParams.set("returnTo", "/app/");
+      await gotoSceneFixturePage(input.page, signInUrl.toString());
+      await input.page.locator('input[name="login"], input[name="email"], input[name="emailOrUsername"], input[name="username"]').first().fill(user.email, { timeout: 1e4 });
+      await input.page.locator('input[name="password"]').first().fill(user.password, { timeout: 1e4 });
+      await input.page.getByRole("button", { name: /sign in/i }).click({ timeout: 1e4 });
+      await input.page.waitForURL?.((url) => !isSignInUrl(url.pathname), { timeout: 15e3 }).catch(() => void 0);
+      await input.page.waitForLoadState?.("networkidle", { timeout: 5e3 }).catch(() => void 0);
+      if (!isSignInUrl(input.page.url())) {
+        return [];
+      }
+      lastError = new Error(`Visual audit login for ${input.role} did not leave the sign-in page. Ensure deterministic fixture user ${user.email} exists.`);
+    } catch (error) {
+      lastError = error;
     }
-    return [];
-  } catch (error) {
-    return [sceneWarningDiagnostic("scene.visual_audit_role_login_failed", error instanceof Error ? error.message : String(error ?? `Visual audit login for ${input.role} failed.`), "roles")];
+    await sleep(retryDelayMs(attempt));
   }
+  return [sceneWarningDiagnostic(
+    "scene.visual_audit_role_login_failed",
+    lastError instanceof Error ? lastError.message : String(lastError ?? `Visual audit login for ${input.role} failed.`),
+    "roles"
+  )];
 }
 export {
   TREESEED_VISUAL_AUDIT_PASSWORD,

package/dist/workflow/operations.d.ts

@@ -1048,9 +1048,11 @@ export declare function workflowRelease(helpers: WorkflowOperationHelpers, input
         rootInstall: {
             status: string;
             reason: string;
+            attempts?: undefined;
         } | {
             status: string;
             reason: null;
+            attempts: number;
         };
         commit: {
             committed: boolean;

package/dist/workflow/operations.js

@@ -1933,31 +1933,36 @@ function runReleaseNpmInstall(repoDir, options = {}) {
   }
   const args = repoDir === options.workspaceRoot ? ["install", "--package-lock-only", "--ignore-scripts", "--no-audit", "--no-fund"] : ["install", "--package-lock-only", "--ignore-scripts", "--workspaces=false", "--no-audit", "--no-fund"];
   const spawnCommand = npmCommandForWorkflowSpawn(args);
-  const result = spawnSync(spawnCommand.command, spawnCommand.args, {
-    cwd: repoDir,
-    env: {
-      ...process.env,
-      npm_config_audit: "false",
-      npm_config_fetch_retries: "2",
-      npm_config_fund: "false",
-      npm_config_foreground_scripts: "true",
-      npm_config_loglevel: "warn",
-      npm_config_maxsockets: "4",
-      npm_config_prefer_offline: "true",
-      npm_config_progress: "false"
-    },
-    stdio: "pipe",
-    encoding: "utf8"
-  });
-  if (result.status !== 0) {
-    const detail = [
+  let lastDetail = "";
+  for (let attempt = 1; attempt <= 10; attempt += 1) {
+    const result = spawnSync(spawnCommand.command, spawnCommand.args, {
+      cwd: repoDir,
+      env: {
+        ...process.env,
+        npm_config_audit: "false",
+        npm_config_fetch_retries: "4",
+        npm_config_fund: "false",
+        npm_config_foreground_scripts: "true",
+        npm_config_loglevel: "warn",
+        npm_config_maxsockets: "4",
+        npm_config_prefer_online: "true",
+        npm_config_progress: "false"
+      },
+      stdio: "pipe",
+      encoding: "utf8"
+    });
+    if (result.status === 0) {
+      return { status: "completed", reason: null, attempts: attempt };
+    }
+    lastDetail = [
       result.error?.message,
       result.stderr?.trim(),
       result.stdout?.trim()
     ].filter(Boolean).join("\n");
-    throw new Error(detail || `npm ${args.join(" ")} failed`);
+    if (!/No matching version found|notarget|ETARGET|E404/u.test(lastDetail) || attempt === 10) break;
+    spawnSync("sleep", ["30"], { stdio: "ignore" });
   }
-  return { status: "completed", reason: null };
+  throw new Error(lastDetail || `npm ${args.join(" ")} failed`);
 }
 function pathIsWithin(parent, candidate) {
   const path = relative(parent, candidate);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/sdk",
-  "version": "0.12.7",
+  "version": "0.12.9",
   "description": "Shared Treeseed SDK for content-backed and D1-backed object models.",
   "license": "AGPL-3.0-only",
   "repository": {