rwsdk 1.0.0-beta.2-test.20250930092748 → 1.0.0-beta.21

package/dist/lib/constants.d.mts

@@ -7,5 +7,6 @@ export declare const VENDOR_CLIENT_BARREL_PATH: string;
 export declare const VENDOR_SERVER_BARREL_PATH: string;
 export declare const VENDOR_CLIENT_BARREL_EXPORT_PATH = "rwsdk/__vendor_client_barrel";
 export declare const VENDOR_SERVER_BARREL_EXPORT_PATH = "rwsdk/__vendor_server_barrel";
+export declare const RW_STATE_EXPORT_PATH = "rwsdk/__state";
 export declare const INTERMEDIATE_SSR_BRIDGE_PATH: string;
 export declare const CLIENT_MANIFEST_RELATIVE_PATH: string;

package/dist/lib/constants.mjs

@@ -1,13 +1,16 @@
-import path, { resolve } from "node:path";
-const __dirname = new URL(".", import.meta.url).pathname;
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
 export const ROOT_DIR = resolve(__dirname, "..", "..");
 export const SRC_DIR = resolve(ROOT_DIR, "src");
 export const DIST_DIR = resolve(ROOT_DIR, "dist");
 export const VITE_DIR = resolve(ROOT_DIR, "src", "vite");
 export const INTERMEDIATES_OUTPUT_DIR = resolve(DIST_DIR, "__intermediate_builds");
-export const VENDOR_CLIENT_BARREL_PATH = path.resolve(INTERMEDIATES_OUTPUT_DIR, "rwsdk-vendor-client-barrel.js");
-export const VENDOR_SERVER_BARREL_PATH = path.resolve(INTERMEDIATES_OUTPUT_DIR, "rwsdk-vendor-server-barrel.js");
+export const VENDOR_CLIENT_BARREL_PATH = resolve(INTERMEDIATES_OUTPUT_DIR, "rwsdk-vendor-client-barrel.js");
+export const VENDOR_SERVER_BARREL_PATH = resolve(INTERMEDIATES_OUTPUT_DIR, "rwsdk-vendor-server-barrel.js");
 export const VENDOR_CLIENT_BARREL_EXPORT_PATH = "rwsdk/__vendor_client_barrel";
 export const VENDOR_SERVER_BARREL_EXPORT_PATH = "rwsdk/__vendor_server_barrel";
+export const RW_STATE_EXPORT_PATH = "rwsdk/__state";
 export const INTERMEDIATE_SSR_BRIDGE_PATH = resolve(INTERMEDIATES_OUTPUT_DIR, "ssr", "ssr_bridge.js");
 export const CLIENT_MANIFEST_RELATIVE_PATH = resolve("dist", "client", ".vite", "manifest.json");

package/dist/lib/e2e/constants.d.mts

@@ -0,0 +1,14 @@
+export declare const IS_CI: boolean;
+export declare const IS_DEBUG_MODE: boolean;
+export declare const SETUP_PLAYGROUND_ENV_TIMEOUT: number;
+export declare const DEPLOYMENT_TIMEOUT: number;
+export declare const DEPLOYMENT_MIN_TRIES: number;
+export declare const DEPLOYMENT_CHECK_TIMEOUT: number;
+export declare const PUPPETEER_TIMEOUT: number;
+export declare const HYDRATION_TIMEOUT: number;
+export declare const DEV_SERVER_TIMEOUT: number;
+export declare const DEV_SERVER_MIN_TRIES: number;
+export declare const SETUP_WAIT_TIMEOUT: number;
+export declare const TEST_MAX_RETRIES: number;
+export declare const TEST_MAX_RETRIES_PER_CODE: number;
+export declare const INSTALL_DEPENDENCIES_RETRIES: number;

package/dist/lib/e2e/constants.mjs

@@ -0,0 +1,74 @@
+export const IS_CI = !!((process.env.CI && !process.env.NOT_CI) ||
+    process.env.GITHUB_ACTIONS ||
+    process.env.GITLAB_CI ||
+    process.env.CIRCLECI ||
+    process.env.TRAVIS ||
+    process.env.JENKINS_URL ||
+    process.env.NETLIFY);
+export const IS_DEBUG_MODE = process.env.RWSDK_E2E_DEBUG
+    ? process.env.RWSDK_E2E_DEBUG === "true"
+    : !IS_CI;
+export const SETUP_PLAYGROUND_ENV_TIMEOUT = process.env
+    .RWSDK_SETUP_PLAYGROUND_ENV_TIMEOUT
+    ? parseInt(process.env.RWSDK_SETUP_PLAYGROUND_ENV_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 10 * 60 * 1000
+        : 15 * 60 * 1000;
+export const DEPLOYMENT_TIMEOUT = process.env.RWSDK_DEPLOYMENT_TIMEOUT
+    ? parseInt(process.env.RWSDK_DEPLOYMENT_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 5 * 30 * 1000
+        : 5 * 60 * 1000;
+export const DEPLOYMENT_MIN_TRIES = process.env.RWSDK_DEPLOYMENT_MIN_TRIES
+    ? parseInt(process.env.RWSDK_DEPLOYMENT_MIN_TRIES, 10)
+    : IS_DEBUG_MODE
+        ? 1
+        : 5;
+export const DEPLOYMENT_CHECK_TIMEOUT = process.env
+    .RWSDK_DEPLOYMENT_CHECK_TIMEOUT
+    ? parseInt(process.env.RWSDK_DEPLOYMENT_CHECK_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 30 * 1000
+        : 5 * 60 * 1000;
+export const PUPPETEER_TIMEOUT = process.env.RWSDK_PUPPETEER_TIMEOUT
+    ? parseInt(process.env.RWSDK_PUPPETEER_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 30 * 1000
+        : 60 * 1000 * 2;
+export const HYDRATION_TIMEOUT = process.env.RWSDK_HYDRATION_TIMEOUT
+    ? parseInt(process.env.RWSDK_HYDRATION_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 2000
+        : 5000;
+export const DEV_SERVER_TIMEOUT = process.env.RWSDK_DEV_SERVER_TIMEOUT
+    ? parseInt(process.env.RWSDK_DEV_SERVER_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 60 * 1000
+        : 5 * 60 * 1000;
+export const DEV_SERVER_MIN_TRIES = process.env.RWSDK_DEV_SERVER_MIN_TRIES
+    ? parseInt(process.env.RWSDK_DEV_SERVER_MIN_TRIES, 10)
+    : IS_DEBUG_MODE
+        ? 1
+        : 5;
+export const SETUP_WAIT_TIMEOUT = process.env.RWSDK_SETUP_WAIT_TIMEOUT
+    ? parseInt(process.env.RWSDK_SETUP_WAIT_TIMEOUT, 10)
+    : IS_DEBUG_MODE
+        ? 60 * 1000
+        : 10 * 60 * 1000;
+export const TEST_MAX_RETRIES = process.env.RWSDK_TEST_MAX_RETRIES
+    ? parseInt(process.env.RWSDK_TEST_MAX_RETRIES, 10)
+    : IS_DEBUG_MODE
+        ? 1
+        : 10;
+export const TEST_MAX_RETRIES_PER_CODE = process.env
+    .RWSDK_TEST_MAX_RETRIES_PER_CODE
+    ? parseInt(process.env.RWSDK_TEST_MAX_RETRIES_PER_CODE, 10)
+    : IS_DEBUG_MODE
+        ? 0
+        : 6;
+export const INSTALL_DEPENDENCIES_RETRIES = process.env
+    .RWSDK_INSTALL_DEPENDENCIES_RETRIES
+    ? parseInt(process.env.RWSDK_INSTALL_DEPENDENCIES_RETRIES, 10)
+    : IS_DEBUG_MODE
+        ? 1
+        : 10;

package/dist/lib/e2e/dev.mjs

@@ -1,6 +1,6 @@
 import debug from "debug";
 import { setTimeout as sleep } from "node:timers/promises";
-import { $ } from "../../lib/$.mjs";
+import { $, $sh } from "../../lib/$.mjs";
 import { poll } from "./poll.mjs";
 const DEV_SERVER_CHECK_TIMEOUT = process.env.RWSDK_DEV_SERVER_CHECK_TIMEOUT
     ? parseInt(process.env.RWSDK_DEV_SERVER_CHECK_TIMEOUT, 10)
@@ -21,43 +21,30 @@ export async function runDevServer(packageManager = "pnpm", cwd) {
             return;
         }
         console.log("Stopping development server...");
-        try {
-            // Send a regular termination signal to the entire process group first
-            process.kill(-devProcess.pid, "SIGTERM");
-        }
-        catch (e) {
-            log("Could not send SIGTERM to dev server process group: %O", e);
-        }
-        // Wait for the process to terminate with a timeout
-        const terminationTimeout = 5000; // 5 seconds
-        const processExitPromise = devProcess.catch(() => {
-            // We expect this promise to reject when the process is killed,
-            // so we catch and ignore the error.
-        });
-        const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve(undefined), terminationTimeout));
-        await Promise.race([processExitPromise, timeoutPromise]);
-        // Check if the process is still alive. We can't reliably check exitCode
-        // on a detached process, so we try sending a signal 0, which errors
-        // if the process doesn't exist.
-        let isAlive = true;
-        try {
-            // Sending signal 0 doesn't kill the process, but checks if it exists
-            process.kill(-devProcess.pid, 0);
-        }
-        catch (e) {
-            isAlive = false;
+        if (process.platform === "win32") {
+            try {
+                await $sh(`taskkill /pid ${devProcess.pid} /f /t`);
+            }
+            catch (err) {
+                log("Failed to kill process tree with taskkill:", err);
+            }
         }
-        // If not terminated within timeout, force kill the entire process group
-        if (isAlive) {
-            log("Dev server process did not terminate within timeout, force killing with SIGKILL");
-            console.log("⚠️ Development server not responding after 5 seconds timeout, force killing...");
+        else {
+            // On Unix-like systems, we kill the entire process group by sending a signal
+            // to the negative PID. This is the equivalent of the `/t` flag for `taskkill` on Windows.
+            // This relies on `detached: true` being set in the execa options, which makes
+            // the child process the leader of a new process group.
             try {
                 process.kill(-devProcess.pid, "SIGKILL");
             }
             catch (e) {
-                log("Could not send SIGKILL to dev server process group: %O", e);
+                log("Failed to kill process group. This may happen if the process already exited. %O", e);
             }
         }
+        await devProcess.catch(() => {
+            // We expect this promise to reject when the process is killed,
+            // so we catch and ignore the error.
+        });
         console.log("Development server stopped");
     };
     try {
@@ -88,8 +75,9 @@ export async function runDevServer(packageManager = "pnpm", cwd) {
         // Use the provided cwd if available
         devProcess = $({
             all: true,
-            detached: true, // Run in a new process group so we can kill the entire group
-            cleanup: false, // Don't auto-kill on exit
+            detached: true, // Re-enable for reliable process cleanup
+            cleanup: true, // Let execa handle cleanup
+            forceKillAfterTimeout: 2000, // Force kill if graceful shutdown fails
             cwd: cwd || process.cwd(), // Use provided directory or current directory
             env, // Pass the updated environment variables
             stdio: "pipe", // Ensure streams are piped
@@ -109,7 +97,6 @@ export async function runDevServer(packageManager = "pnpm", cwd) {
         // Listen for all output to get the URL
         const handleOutput = (data, source) => {
             const output = data.toString();
-            console.log(output);
             allOutput += output; // Accumulate all output
             log("Received output from %s: %s", source, output.replace(/\n/g, "\\n"));
             if (!url) {

package/dist/lib/e2e/environment.d.mts

@@ -3,7 +3,7 @@ import { PackageManager } from "./types.mjs";
 /**
  * Copy project to a temporary directory with a unique name
  */
-export declare function copyProjectToTempDir(projectDir: string, resourceUniqueKey: string, packageManager?: PackageManager, monorepoRoot?: string): Promise<{
+export declare function copyProjectToTempDir(projectDir: string, resourceUniqueKey: string, packageManager?: PackageManager, monorepoRoot?: string, installDependenciesRetries?: number): Promise<{
     tempDir: tmp.DirectoryResult;
     targetDir: string;
     workerName: string;

package/dist/lib/e2e/environment.mjs

@@ -1,3 +1,4 @@
+import { createHash } from "crypto";
 import debug from "debug";
 import { copy, pathExists } from "fs-extra";
 import ignore from "ignore";
@@ -8,8 +9,25 @@ import { basename, join, relative, resolve } from "path";
 import tmp from "tmp-promise";
 import { $ } from "../../lib/$.mjs";
 import { ROOT_DIR } from "../constants.mjs";
+import { INSTALL_DEPENDENCIES_RETRIES, IS_CI } from "./constants.mjs";
 import { retry } from "./retry.mjs";
 const log = debug("rwsdk:e2e:environment");
+const IS_CACHE_ENABLED = process.env.RWSDK_E2E_CACHE
+    ? process.env.RWSDK_E2E_CACHE === "1"
+    : !IS_CI;
+if (IS_CACHE_ENABLED) {
+    log("E2E test caching is enabled.");
+}
+const getTempDir = async () => {
+    return tmp.dir({ unsafeCleanup: true });
+};
+function slugify(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/--+/g, "-")
+        .replace(/^-|-$/g, "");
+}
 const createSdkTarball = async () => {
     const existingTarballPath = process.env.RWSKD_SMOKE_TEST_TARBALL_PATH;
     if (existingTarballPath) {
@@ -24,15 +42,27 @@ const createSdkTarball = async () => {
             }, // No-op cleanup
         };
     }
-    const packResult = await $({ cwd: ROOT_DIR, stdio: "pipe" }) `npm pack`;
-    const tarballName = packResult.stdout?.trim();
-    const tarballPath = path.join(ROOT_DIR, tarballName);
-    log(`📦 Created tarball: ${tarballPath}`);
+    // Create a temporary directory to receive the tarball, ensuring a stable path.
+    const tempDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "rwsdk-tarball-"));
+    await $({
+        cwd: ROOT_DIR,
+        stdio: "pipe",
+    }) `npm pack --pack-destination=${tempDir}`;
+    // We need to determine the tarball's name, as it's version-dependent.
+    // Running `npm pack --dry-run` gives us the filename without creating a file.
+    const packDryRun = await $({
+        cwd: ROOT_DIR,
+        stdio: "pipe",
+    }) `npm pack --dry-run`;
+    const tarballName = packDryRun.stdout?.trim();
+    const tarballPath = path.join(tempDir, tarballName);
+    if (!fs.existsSync(tarballPath)) {
+        throw new Error(`Tarball was not created in the expected location: ${tarballPath}`);
+    }
+    log(`📦 Created tarball in stable temp location: ${tarballPath}`);
     const cleanupTarball = async () => {
-        if (fs.existsSync(tarballPath)) {
-            log(`🧹 Cleaning up tarball: ${tarballPath}`);
-            await fs.promises.rm(tarballPath, { force: true });
-        }
+        log(`🧹 Cleaning up tarball directory: ${tempDir}`);
+        await fs.promises.rm(tempDir, { recursive: true, force: true });
     };
     return { tarballPath, cleanupTarball };
 };
@@ -46,17 +76,16 @@ const setTarballDependency = async (targetDir, tarballName) => {
 /**
  * Copy project to a temporary directory with a unique name
  */
-export async function copyProjectToTempDir(projectDir, resourceUniqueKey, packageManager, monorepoRoot) {
+export async function copyProjectToTempDir(projectDir, resourceUniqueKey, packageManager, monorepoRoot, installDependenciesRetries) {
     const { tarballPath, cleanupTarball } = await createSdkTarball();
     try {
         log("Creating temporary directory for project");
-        // Create a temporary directory
-        const tempDir = await tmp.dir({ unsafeCleanup: true });
+        const tempDir = await getTempDir();
         // Determine the source directory to copy from
         const sourceDir = monorepoRoot || projectDir;
         // Create unique project directory name
         const originalDirName = basename(sourceDir);
-        const workerName = `${originalDirName}-test-${resourceUniqueKey}`;
+        const workerName = `${slugify(originalDirName)}-test-${resourceUniqueKey}`;
         const tempCopyRoot = resolve(tempDir.path, workerName);
         // If it's a monorepo, the targetDir for commands is a subdirectory
         const targetDir = monorepoRoot
@@ -112,7 +141,9 @@ export async function copyProjectToTempDir(projectDir, resourceUniqueKey, packag
                 const workspaces = rwsdkWs.workspaces;
                 if (packageManager === "pnpm") {
                     const pnpmWsPath = join(tempCopyRoot, "pnpm-workspace.yaml");
-                    const pnpmWsConfig = `packages:\n${workspaces.map((w) => `  - '${w}'`).join("\n")}\n`;
+                    const pnpmWsConfig = `packages:\n${workspaces
+                        .map((w) => `  - '${w}'`)
+                        .join("\n")}\n`;
                     await fs.promises.writeFile(pnpmWsPath, pnpmWsConfig);
                     log("Created pnpm-workspace.yaml");
                 }
@@ -130,7 +161,6 @@ export async function copyProjectToTempDir(projectDir, resourceUniqueKey, packag
         log("⚙️  Configuring temp project to not use frozen lockfile...");
         const npmrcPath = join(targetDir, ".npmrc");
         await fs.promises.writeFile(npmrcPath, "frozen-lockfile=false\n");
-        // For yarn, create .yarnrc.yml to disable PnP and allow lockfile changes
         if (packageManager === "yarn") {
             const yarnrcPath = join(targetDir, ".yarnrc.yml");
             const yarnCacheDir = path.join(os.tmpdir(), "yarn-cache");
@@ -144,11 +174,19 @@ export async function copyProjectToTempDir(projectDir, resourceUniqueKey, packag
             await fs.promises.writeFile(yarnrcPath, yarnConfig);
             log("Created .yarnrc.yml to allow lockfile changes for yarn");
         }
+        if (packageManager === "yarn-classic") {
+            const yarnrcPath = join(targetDir, ".yarnrc");
+            const yarnCacheDir = path.join(os.tmpdir(), "yarn-classic-cache");
+            await fs.promises.mkdir(yarnCacheDir, { recursive: true });
+            const yarnConfig = `cache-folder "${yarnCacheDir}"`;
+            await fs.promises.writeFile(yarnrcPath, yarnConfig);
+            log("Created .yarnrc with cache-folder for yarn-classic");
+        }
         await setTarballDependency(targetDir, tarballFilename);
         // Install dependencies in the target directory
         const installDir = monorepoRoot ? tempCopyRoot : targetDir;
-        await retry(() => installDependencies(installDir, packageManager), {
-            retries: 3,
+        await retry(() => installDependencies(installDir, packageManager, projectDir, monorepoRoot), {
+            retries: INSTALL_DEPENDENCIES_RETRIES,
             delay: 1000,
         });
         // Return the environment details
@@ -158,7 +196,42 @@ export async function copyProjectToTempDir(projectDir, resourceUniqueKey, packag
         await cleanupTarball();
     }
 }
-async function installDependencies(targetDir, packageManager = "pnpm") {
+async function installDependencies(targetDir, packageManager = "pnpm", projectDir, monorepoRoot) {
+    if (IS_CACHE_ENABLED) {
+        // Generate a checksum of the SDK's dist directory to factor into the cache key
+        const { stdout: sdkDistChecksum } = await $("find . -type f | sort | md5sum", {
+            shell: true,
+            cwd: path.join(ROOT_DIR, "dist"),
+        });
+        const projectIdentifier = monorepoRoot
+            ? `${monorepoRoot}-${projectDir}`
+            : projectDir;
+        const projectHash = createHash("md5")
+            .update(`${projectIdentifier}-${sdkDistChecksum}`)
+            .digest("hex")
+            .substring(0, 8);
+        const cacheDirName = monorepoRoot
+            ? basename(monorepoRoot)
+            : basename(projectDir);
+        const cacheRoot = path.join(os.tmpdir(), "rwsdk-e2e-cache", `${cacheDirName}-${projectHash}`);
+        const nodeModulesCachePath = path.join(cacheRoot, "node_modules");
+        if (await pathExists(nodeModulesCachePath)) {
+            console.log(`✅ CACHE HIT for source "${projectIdentifier}": Found cached node_modules. Hard-linking from ${nodeModulesCachePath}`);
+            try {
+                // Use cp -al for a fast, hardlink-based copy
+                await $("cp", ["-al", nodeModulesCachePath, join(targetDir, "node_modules")], { stdio: "pipe" });
+                console.log(`✅ Hardlink copy created successfully.`);
+            }
+            catch (e) {
+                console.warn(`⚠️ Hardlink copy failed, falling back to full copy. Error: ${e.message}`);
+                // Fallback to a regular copy if hardlinking fails (e.g., cross-device)
+                await copy(nodeModulesCachePath, join(targetDir, "node_modules"));
+                console.log(`✅ Full copy created successfully.`);
+            }
+            return;
+        }
+        console.log(`ℹ️ CACHE MISS for source "${projectIdentifier}": No cached node_modules found at ${nodeModulesCachePath}. Proceeding with installation.`);
+    }
     console.log(`📦 Installing project dependencies in ${targetDir} using ${packageManager}...`);
     try {
         // Clean up any pre-existing node_modules and lockfiles
@@ -185,7 +258,7 @@ async function installDependencies(targetDir, packageManager = "pnpm") {
             }
             else if (packageManager === "yarn-classic") {
                 log(`Preparing yarn@1.22.19 with corepack...`);
-                await $("corepack", ["prepare", "yarn@1.22.19", "--activate"], {
+                await $("corepack", ["prepare", "yarn@1.x", "--activate"], {
                     cwd: targetDir,
                     stdio: "pipe",
                 });
@@ -210,6 +283,33 @@ async function installDependencies(targetDir, packageManager = "pnpm") {
             },
         });
         console.log("✅ Dependencies installed successfully");
+        // After successful install, populate the cache if enabled
+        if (IS_CACHE_ENABLED) {
+            // Re-calculate cache path to be safe
+            const { stdout: sdkDistChecksum } = await $("find . -type f | sort | md5sum", {
+                shell: true,
+                cwd: path.join(ROOT_DIR, "dist"),
+            });
+            const projectIdentifier = monorepoRoot
+                ? `${monorepoRoot}-${projectDir}`
+                : projectDir;
+            const projectHash = createHash("md5")
+                .update(`${projectIdentifier}-${sdkDistChecksum}`)
+                .digest("hex")
+                .substring(0, 8);
+            const cacheDirName = monorepoRoot
+                ? basename(monorepoRoot)
+                : basename(projectDir);
+            const cacheRoot = path.join(os.tmpdir(), "rwsdk-e2e-cache", `${cacheDirName}-${projectHash}`);
+            const nodeModulesCachePath = path.join(cacheRoot, "node_modules");
+            console.log(`Caching node_modules to ${nodeModulesCachePath} for future runs...`);
+            // Ensure parent directory exists
+            await fs.promises.mkdir(path.dirname(nodeModulesCachePath), {
+                recursive: true,
+            });
+            await copy(join(targetDir, "node_modules"), nodeModulesCachePath);
+            console.log(`✅ node_modules cached successfully.`);
+        }
         // Log installation details at debug level
         if (result.stdout) {
             log(`${packageManager} install output: %s`, result.stdout);

package/dist/lib/e2e/index.d.mts

@@ -1,3 +1,4 @@
+export * from "../$.mjs";
 export * from "./browser.mjs";
 export * from "./dev.mjs";
 export * from "./environment.mjs";

package/dist/lib/e2e/index.mjs

@@ -1,3 +1,4 @@
+export * from "../$.mjs";
 export * from "./browser.mjs";
 export * from "./dev.mjs";
 export * from "./environment.mjs";

package/dist/lib/e2e/poll.d.mts

@@ -4,5 +4,5 @@ export interface PollOptions {
     minTries: number;
     onRetry?: (error: unknown, tries: number) => void;
 }
-export declare function poll(fn: () => Promise<boolean>, options?: Partial<PollOptions>): Promise<void>;
+export declare function poll(fn: () => boolean | Promise<boolean>, options?: Partial<PollOptions>): Promise<void>;
 export declare function pollValue<T>(fn: () => Promise<T>, options?: Partial<PollOptions>): Promise<T>;

package/dist/lib/e2e/testHarness.d.mts

@@ -1,8 +1,11 @@
 import { type Browser, type Page } from "puppeteer-core";
 import { test } from "vitest";
+import { DEPLOYMENT_CHECK_TIMEOUT, DEPLOYMENT_MIN_TRIES, DEPLOYMENT_TIMEOUT, DEV_SERVER_MIN_TRIES, DEV_SERVER_TIMEOUT, HYDRATION_TIMEOUT, INSTALL_DEPENDENCIES_RETRIES, PUPPETEER_TIMEOUT, SETUP_PLAYGROUND_ENV_TIMEOUT, SETUP_WAIT_TIMEOUT, TEST_MAX_RETRIES, TEST_MAX_RETRIES_PER_CODE } from "./constants.mjs";
 export type { Browser, Page } from "puppeteer-core";
+export { DEPLOYMENT_CHECK_TIMEOUT, DEPLOYMENT_MIN_TRIES, DEPLOYMENT_TIMEOUT, DEV_SERVER_MIN_TRIES, DEV_SERVER_TIMEOUT, HYDRATION_TIMEOUT, INSTALL_DEPENDENCIES_RETRIES, PUPPETEER_TIMEOUT, SETUP_PLAYGROUND_ENV_TIMEOUT, SETUP_WAIT_TIMEOUT, TEST_MAX_RETRIES, TEST_MAX_RETRIES_PER_CODE, };
 interface DevServerInstance {
     url: string;
+    projectDir: string;
     stopDev: () => Promise<void>;
 }
 interface DeploymentInstance {
@@ -34,6 +37,11 @@ export interface SetupPlaygroundEnvironmentOptions {
      * @default true
      */
     deploy?: boolean;
+    /**
+     * Whether to automatically start the dev server.
+     * @default true
+     */
+    autoStartDevServer?: boolean;
 }
 /**
  * A Vitest hook that sets up a playground environment for a test file.
@@ -41,17 +49,29 @@ export interface SetupPlaygroundEnvironmentOptions {
  * and installs dependencies using a tarball of the SDK.
  * This ensures that tests run in a clean, isolated environment.
  */
-export declare function setupPlaygroundEnvironment(options?: string | SetupPlaygroundEnvironmentOptions): void;
+export declare function setupPlaygroundEnvironment(options: SetupPlaygroundEnvironmentOptions | string): void;
 /**
  * Creates a dev server instance using the shared playground environment.
  * Automatically registers cleanup to run after the test.
  */
-export declare function createDevServer(projectDir: string): Promise<DevServerInstance>;
+export declare function createDevServer(): {
+    projectDir: string;
+    start: () => Promise<DevServerInstance>;
+};
 /**
  * Creates a deployment instance using the shared playground environment.
  * Automatically registers cleanup to run after the test.
  */
-export declare function createDeployment(projectDir: string): Promise<DeploymentInstance>;
+export declare function createDeployment(): {
+    projectDir: string;
+    start: () => Promise<{
+        url: string;
+        workerName: string;
+        resourceUniqueKey: string;
+        projectDir: string;
+        cleanup: () => Promise<void>;
+    }>;
+};
 /**
  * Executes a test function with a retry mechanism for specific error codes.
  * @param name - The name of the test, used for logging.
@@ -61,13 +81,23 @@ export declare function createDeployment(projectDir: string): Promise<Deployment
  *                     called automatically on failure.
  */
 export declare function runTestWithRetries(name: string, attemptFn: () => Promise<void>): Promise<void>;
+type SDKRunner = (name: string, testLogic: (context: {
+    browser: Browser;
+    page: Page;
+    projectDir: string;
+}) => Promise<void>) => void;
 declare function createTestRunner(testFn: (typeof test | typeof test.only)["concurrent"], envType: "dev" | "deploy"): (name: string, testLogic: (context: {
     devServer?: DevServerInstance;
     deployment?: DeploymentInstance;
     browser: Browser;
     page: Page;
     url: string;
+    projectDir: string;
 }) => Promise<void>) => void;
+export declare const testSDK: SDKRunner & {
+    only: SDKRunner;
+    skip: typeof test.skip;
+};
 /**
  * High-level test wrapper for dev server tests.
  * Automatically skips if RWSDK_SKIP_DEV=1
@@ -81,6 +111,7 @@ export declare namespace testDev {
         browser: Browser;
         page: Page;
         url: string;
+        projectDir: string;
     }) => Promise<void>) => void;
 }
 /**
@@ -96,6 +127,7 @@ export declare namespace testDeploy {
         browser: Browser;
         page: Page;
         url: string;
+        projectDir: string;
     }) => Promise<void>) => void;
 }
 /**
@@ -108,6 +140,7 @@ export declare function testDevAndDeploy(name: string, testFn: (context: {
     browser: Browser;
     page: Page;
     url: string;
+    projectDir: string;
 }) => Promise<void>): void;
 export declare namespace testDevAndDeploy {
     var skip: (name: string, testFn?: any) => void;