rwsdk 1.0.0-alpha.2 → 1.0.0-alpha.20

package/dist/lib/e2e/testHarness.mjs

@@ -0,0 +1,437 @@
+import { test, beforeAll, afterAll, afterEach, describe, beforeEach, } from "vitest";
+import { basename, join as pathJoin, dirname } from "path";
+import { setupTarballEnvironment } from "./tarball.mjs";
+import { runDevServer } from "./dev.mjs";
+import { runRelease, deleteWorker, deleteD1Database, isRelatedToTest, } from "./release.mjs";
+import { launchBrowser } from "./browser.mjs";
+import puppeteer from "puppeteer-core";
+import fs from "fs-extra";
+import os from "os";
+import path from "path";
+import { poll, pollValue } from "./poll.mjs";
+const SETUP_PLAYGROUND_ENV_TIMEOUT = process.env
+    .RWSDK_SETUP_PLAYGROUND_ENV_TIMEOUT
+    ? parseInt(process.env.RWSDK_SETUP_PLAYGROUND_ENV_TIMEOUT, 10)
+    : 15 * 60 * 1000;
+const DEPLOYMENT_TIMEOUT = process.env.RWSDK_DEPLOYMENT_TIMEOUT
+    ? parseInt(process.env.RWSDK_DEPLOYMENT_TIMEOUT, 10)
+    : 5 * 60 * 1000;
+const DEPLOYMENT_MIN_TRIES = process.env.RWSDK_DEPLOYMENT_MIN_TRIES
+    ? parseInt(process.env.RWSDK_DEPLOYMENT_MIN_TRIES, 10)
+    : 5;
+const DEPLOYMENT_CHECK_TIMEOUT = process.env.RWSDK_DEPLOYMENT_CHECK_TIMEOUT
+    ? parseInt(process.env.RWSDK_DEPLOYMENT_CHECK_TIMEOUT, 10)
+    : 5 * 60 * 1000;
+const PUPPETEER_TIMEOUT = process.env.RWSDK_PUPPETEER_TIMEOUT
+    ? parseInt(process.env.RWSDK_PUPPETEER_TIMEOUT, 10)
+    : 60 * 1000 * 2;
+const HYDRATION_TIMEOUT = process.env.RWSDK_HYDRATION_TIMEOUT
+    ? parseInt(process.env.RWSDK_HYDRATION_TIMEOUT, 10)
+    : 5000;
+const DEV_SERVER_TIMEOUT = process.env.RWSDK_DEV_SERVER_TIMEOUT
+    ? parseInt(process.env.RWSDK_DEV_SERVER_TIMEOUT, 10)
+    : 5 * 60 * 1000;
+const DEV_SERVER_MIN_TRIES = process.env.RWSDK_DEV_SERVER_MIN_TRIES
+    ? parseInt(process.env.RWSDK_DEV_SERVER_MIN_TRIES, 10)
+    : 5;
+const SETUP_WAIT_TIMEOUT = process.env.RWSDK_SETUP_WAIT_TIMEOUT
+    ? parseInt(process.env.RWSDK_SETUP_WAIT_TIMEOUT, 10)
+    : 10 * 60 * 1000;
+// Environment variable flags for skipping tests
+const SKIP_DEV_SERVER_TESTS = process.env.RWSDK_SKIP_DEV === "1";
+const SKIP_DEPLOYMENT_TESTS = process.env.RWSDK_SKIP_DEPLOY === "1";
+// Global test environment state
+let globalDevPlaygroundEnv = null;
+let globalDeployPlaygroundEnv = null;
+let globalDevInstancePromise = null;
+let globalDeploymentInstancePromise = null;
+let globalDevInstance = null;
+let globalDeploymentInstance = null;
+let hooksRegistered = false;
+/**
+ * Registers global cleanup hooks automatically
+ */
+function ensureHooksRegistered() {
+    if (hooksRegistered)
+        return;
+    // Register global afterAll to clean up the playground environment
+    afterAll(async () => {
+        const cleanupPromises = [];
+        if (globalDevInstance) {
+            cleanupPromises.push(globalDevInstance.stopDev());
+        }
+        if (globalDeploymentInstance) {
+            cleanupPromises.push(globalDeploymentInstance.cleanup());
+        }
+        if (globalDevPlaygroundEnv) {
+            cleanupPromises.push(globalDevPlaygroundEnv.cleanup());
+        }
+        if (globalDeployPlaygroundEnv) {
+            cleanupPromises.push(globalDeployPlaygroundEnv.cleanup());
+        }
+        await Promise.all(cleanupPromises);
+        globalDevInstance = null;
+        globalDeploymentInstance = null;
+        globalDevPlaygroundEnv = null;
+        globalDeployPlaygroundEnv = null;
+    });
+    hooksRegistered = true;
+}
+/**
+ * Get the project directory for the current test by looking at the call stack
+ */
+function getProjectDirectory() {
+    // For now, let's hardcode this to '../playground/hello-world' since we only have one project
+    // TODO: Make this more dynamic when we have multiple playground projects
+    return "../playground/hello-world";
+}
+/**
+ * Derive the playground directory from import.meta.url by finding the nearest package.json
+ */
+function getPlaygroundDirFromImportMeta(importMetaUrl) {
+    const url = new URL(importMetaUrl);
+    const testFilePath = url.pathname;
+    let currentDir = dirname(testFilePath);
+    // Walk up the tree from the test file's directory
+    while (currentDir !== "/") {
+        // Check if a package.json exists in the current directory
+        if (fs.existsSync(pathJoin(currentDir, "package.json"))) {
+            return currentDir;
+        }
+        currentDir = dirname(currentDir);
+    }
+    throw new Error(`Could not determine playground directory from import.meta.url: ${importMetaUrl}. ` +
+        `Failed to find a package.json in any parent directory.`);
+}
+/**
+ * A Vitest hook that sets up a playground environment for a test file.
+ * It creates a temporary directory, copies the playground project into it,
+ * and installs dependencies using a tarball of the SDK.
+ * This ensures that tests run in a clean, isolated environment.
+ */
+export function setupPlaygroundEnvironment(options = {}) {
+    const { sourceProjectDir, monorepoRoot, dev = true, deploy = true, } = typeof options === "string" ? { sourceProjectDir: options } : options;
+    ensureHooksRegistered();
+    beforeAll(async () => {
+        let projectDir;
+        if (!sourceProjectDir) {
+            projectDir = getProjectDirectory();
+        }
+        else if (sourceProjectDir.startsWith("file://")) {
+            // This is import.meta.url, derive the playground directory
+            projectDir = getPlaygroundDirFromImportMeta(sourceProjectDir);
+        }
+        else {
+            // This is an explicit path
+            projectDir = sourceProjectDir;
+        }
+        console.log(`Setting up playground environment from ${projectDir}...`);
+        if (dev) {
+            const devEnv = await setupTarballEnvironment({
+                projectDir,
+                monorepoRoot,
+                packageManager: process.env.PACKAGE_MANAGER || "pnpm",
+            });
+            globalDevPlaygroundEnv = {
+                projectDir: devEnv.targetDir,
+                cleanup: devEnv.cleanup,
+            };
+            globalDevInstancePromise = createDevServer(devEnv.targetDir).then((instance) => {
+                globalDevInstance = instance;
+                return instance;
+            });
+            // Prevent unhandled promise rejections. The error will be handled inside
+            // the test's beforeEach hook where this promise is awaited.
+            globalDevInstancePromise.catch(() => { });
+        }
+        else {
+            globalDevInstancePromise = Promise.resolve(null);
+        }
+        if (deploy) {
+            const deployEnv = await setupTarballEnvironment({
+                projectDir,
+                monorepoRoot,
+                packageManager: process.env.PACKAGE_MANAGER || "pnpm",
+            });
+            globalDeployPlaygroundEnv = {
+                projectDir: deployEnv.targetDir,
+                cleanup: deployEnv.cleanup,
+            };
+            globalDeploymentInstancePromise = createDeployment(deployEnv.targetDir).then((instance) => {
+                globalDeploymentInstance = instance;
+                return instance;
+            });
+            // Prevent unhandled promise rejections
+            globalDeploymentInstancePromise.catch(() => { });
+        }
+        else {
+            globalDeploymentInstancePromise = Promise.resolve(null);
+        }
+    }, SETUP_PLAYGROUND_ENV_TIMEOUT);
+}
+/**
+ * Creates a dev server instance using the shared playground environment.
+ * Automatically registers cleanup to run after the test.
+ */
+export async function createDevServer(projectDir) {
+    if (SKIP_DEV_SERVER_TESTS) {
+        throw new Error("Dev server tests are skipped via RWSDK_SKIP_DEV=1");
+    }
+    const packageManager = process.env.PACKAGE_MANAGER || "pnpm";
+    const devResult = await pollValue(() => runDevServer(packageManager, projectDir), {
+        timeout: DEV_SERVER_TIMEOUT,
+        minTries: DEV_SERVER_MIN_TRIES,
+        onRetry: (error, tries) => {
+            console.log(`Retrying dev server creation (attempt ${tries})... Error: ${error.message}`);
+        },
+    });
+    return {
+        url: devResult.url,
+        stopDev: devResult.stopDev,
+    };
+}
+/**
+ * Creates a deployment instance using the shared playground environment.
+ * Automatically registers cleanup to run after the test.
+ */
+export async function createDeployment(projectDir) {
+    if (SKIP_DEPLOYMENT_TESTS) {
+        throw new Error("Deployment tests are skipped via RWSDK_SKIP_DEPLOY=1");
+    }
+    return await pollValue(async () => {
+        // Extract the unique key from the project directory name instead of generating a new one
+        // The directory name format is: {projectName}-e2e-test-{randomId}
+        const dirName = basename(projectDir);
+        const match = dirName.match(/-e2e-test-([a-f0-9]+)$/);
+        const resourceUniqueKey = match
+            ? match[1]
+            : Math.random().toString(36).substring(2, 15);
+        const deployResult = await runRelease(projectDir, projectDir, resourceUniqueKey);
+        // Poll the URL to ensure it's live before proceeding
+        await poll(async () => {
+            try {
+                const response = await fetch(deployResult.url);
+                // We consider any response (even 4xx or 5xx) as success,
+                // as it means the worker is routable.
+                return response.status > 0;
+            }
+            catch (e) {
+                return false;
+            }
+        }, {
+            timeout: DEPLOYMENT_CHECK_TIMEOUT,
+        });
+        const cleanup = async () => {
+            // Run deployment cleanup in background without blocking
+            const performCleanup = async () => {
+                if (isRelatedToTest(deployResult.workerName, resourceUniqueKey)) {
+                    await deleteWorker(deployResult.workerName, projectDir, resourceUniqueKey);
+                }
+                await deleteD1Database(resourceUniqueKey, projectDir, resourceUniqueKey);
+            };
+            // Start cleanup in background and return immediately
+            performCleanup().catch((error) => {
+                console.warn(`Warning: Background deployment cleanup failed: ${error.message}`);
+            });
+            return Promise.resolve();
+        };
+        return {
+            url: deployResult.url,
+            workerName: deployResult.workerName,
+            resourceUniqueKey,
+            projectDir: projectDir,
+            cleanup,
+        };
+    }, {
+        timeout: DEPLOYMENT_TIMEOUT,
+        minTries: DEPLOYMENT_MIN_TRIES,
+        onRetry: (error, tries) => {
+            console.log(`Retrying deployment creation (attempt ${tries})... Error: ${error.message}`);
+        },
+    });
+}
+/**
+ * Executes a test function with a retry mechanism for specific error codes.
+ * @param name - The name of the test, used for logging.
+ * @param attemptFn - A function that executes one attempt of the test.
+ *                     It should set up resources, run the test logic, and
+ *                     return a cleanup function. The cleanup function will be
+ *                     called automatically on failure.
+ */
+export async function runTestWithRetries(name, attemptFn) {
+    const MAX_RETRIES_PER_CODE = 6;
+    const retryCounts = {};
+    let attempt = 0;
+    while (true) {
+        attempt++;
+        try {
+            await attemptFn();
+            if (attempt > 1) {
+                console.log(`[runTestWithRetries] Test "${name}" succeeded on attempt ${attempt}.`);
+            }
+            return; // Success
+        }
+        catch (e) {
+            const errorCode = e?.code;
+            if (typeof errorCode === "string" && errorCode) {
+                const count = (retryCounts[errorCode] || 0) + 1;
+                retryCounts[errorCode] = count;
+                if (count <= MAX_RETRIES_PER_CODE) {
+                    console.log(`[runTestWithRetries] Attempt ${attempt} for "${name}" failed with code ${errorCode}. Retrying (failure ${count}/${MAX_RETRIES_PER_CODE} for this code)...`);
+                    await new Promise((resolve) => setTimeout(resolve, 1000));
+                    continue; // Next attempt
+                }
+                else {
+                    console.error(`[runTestWithRetries] Test "${name}" failed with code ${errorCode} after ${MAX_RETRIES_PER_CODE} retries for this code.`);
+                    throw e; // Give up
+                }
+            }
+            else {
+                console.error(`[runTestWithRetries] Test "${name}" failed on attempt ${attempt} with a non-retryable error:`, e);
+                throw e;
+            }
+        }
+    }
+}
+function createTestRunner(testFn, envType) {
+    return (name, testLogic) => {
+        if ((envType === "dev" && SKIP_DEV_SERVER_TESTS) ||
+            (envType === "deploy" && SKIP_DEPLOYMENT_TESTS)) {
+            test.skip(name, () => { });
+            return;
+        }
+        describe.concurrent(name, () => {
+            let page;
+            let instance;
+            let browser;
+            beforeAll(async () => {
+                const tempDir = path.join(os.tmpdir(), "rwsdk-e2e-tests");
+                const wsEndpointFile = path.join(tempDir, "wsEndpoint");
+                try {
+                    const wsEndpoint = await fs.readFile(wsEndpointFile, "utf-8");
+                    browser = await puppeteer.connect({ browserWSEndpoint: wsEndpoint });
+                }
+                catch (error) {
+                    console.warn("Failed to connect to existing browser instance. " +
+                        "This might happen if you are running a single test file. " +
+                        "Launching a new browser instance instead.");
+                    browser = await launchBrowser();
+                }
+            }, SETUP_WAIT_TIMEOUT);
+            afterAll(async () => {
+                if (browser) {
+                    await browser.disconnect();
+                }
+            });
+            beforeEach(async () => {
+                const instancePromise = envType === "dev"
+                    ? globalDevInstancePromise
+                    : globalDeploymentInstancePromise;
+                if (!instancePromise) {
+                    throw new Error("Test environment promises not initialized. Call setupPlaygroundEnvironment() in your test file.");
+                }
+                [instance] = await Promise.all([instancePromise]);
+                if (!instance) {
+                    throw new Error(`No ${envType} instance found. Make sure to enable it in setupPlaygroundEnvironment.`);
+                }
+                page = await browser.newPage();
+                page.setDefaultTimeout(PUPPETEER_TIMEOUT);
+            }, SETUP_WAIT_TIMEOUT);
+            afterEach(async () => {
+                if (page) {
+                    try {
+                        await page.close();
+                    }
+                    catch (error) {
+                        // Suppress errors during page close, as the browser might already be disconnecting
+                        // due to the test suite finishing.
+                        console.warn(`Suppressing error during page.close() in test "${name}":`, error);
+                    }
+                }
+            });
+            testFn(">", async () => {
+                if (!instance || !browser) {
+                    throw new Error("Test environment not ready.");
+                }
+                await runTestWithRetries(name, async () => {
+                    await testLogic({
+                        [envType === "dev" ? "devServer" : "deployment"]: instance,
+                        browser: browser,
+                        page: page,
+                        url: instance.url,
+                    });
+                });
+            });
+        });
+    };
+}
+/**
+ * High-level test wrapper for dev server tests.
+ * Automatically skips if RWSDK_SKIP_DEV=1
+ */
+export function testDev(...args) {
+    return createTestRunner(test.concurrent, "dev")(...args);
+}
+testDev.skip = (name, testFn) => {
+    test.skip(name, testFn || (() => { }));
+};
+testDev.only = createTestRunner(test.only, "dev");
+/**
+ * High-level test wrapper for deployment tests.
+ * Automatically skips if RWSDK_SKIP_DEPLOY=1
+ */
+export function testDeploy(...args) {
+    return createTestRunner(test.concurrent, "deploy")(...args);
+}
+testDeploy.skip = (name, testFn) => {
+    test.skip(name, testFn || (() => { }));
+};
+testDeploy.only = createTestRunner(test.only, "deploy");
+/**
+ * Unified test function that runs the same test against both dev server and deployment.
+ * Automatically skips based on environment variables.
+ */
+export function testDevAndDeploy(name, testFn) {
+    testDev(`${name} (dev)`, testFn);
+    testDeploy(`${name} (deployment)`, testFn);
+}
+/**
+ * Skip version of testDevAndDeploy
+ */
+testDevAndDeploy.skip = (name, testFn) => {
+    test.skip(name, testFn || (() => { }));
+};
+testDevAndDeploy.only = (name, testFn) => {
+    testDev.only(`${name} (dev)`, testFn);
+    testDeploy.only(`${name} (deployment)`, testFn);
+};
+/**
+ * Waits for the page to be fully loaded and hydrated.
+ * This should be used before any user interaction is simulated.
+ */
+export async function waitForHydration(page) {
+    // 1. Wait for the document to be fully loaded.
+    await page.waitForFunction('document.readyState === "complete"');
+    // 2. Wait a short, fixed amount of time for client-side hydration to finish.
+    // This is a pragmatic approach to ensure React has mounted.
+    await new Promise((resolve) => setTimeout(resolve, HYDRATION_TIMEOUT));
+}
+export function trackPageErrors(page) {
+    const consoleErrors = [];
+    const failedRequests = [];
+    page.on("requestfailed", (request) => {
+        failedRequests.push(`${request.url()} | ${request.failure()?.errorText}`);
+    });
+    page.on("console", (msg) => {
+        if (msg.type() === "error") {
+            consoleErrors.push(msg.text());
+        }
+    });
+    return {
+        get: () => ({
+            // context(justinvdm, 25 Sep 2025): Filter out irrelevant 404s (e.g. favicon)
+            consoleErrors: consoleErrors.filter((e) => !e.includes("404")),
+            failedRequests,
+        }),
+    };
+}

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

@@ -0,0 +1,32 @@
+export type PackageManager = "pnpm" | "npm" | "yarn" | "yarn-classic";
+/**
+ * Options for smoke tests
+ */
+export interface SmokeTestOptions {
+    projectDir?: string;
+    artifactDir?: string;
+    headless?: boolean;
+    keep?: boolean;
+    sync?: boolean;
+    bail?: boolean;
+    skipDev?: boolean;
+    skipRelease?: boolean;
+    skipClient?: boolean;
+    packageManager?: PackageManager;
+    realtime?: boolean;
+    skipHmr?: boolean;
+    skipStyleTests?: boolean;
+    tarballPath?: string;
+}
+/**
+ * Resources created during a test run that need to be cleaned up
+ */
+export interface TestResources {
+    tempDirCleanup?: () => Promise<void>;
+    workerName?: string;
+    targetDir?: string;
+    originalCwd: string;
+    workerCreatedDuringTest: boolean;
+    stopDev?: () => Promise<void>;
+    resourceUniqueKey: string;
+}

package/dist/lib/getShortName.mjs

@@ -1,2 +1,7 @@
 import { relative } from "node:path";
-export const getShortName = (file, root) => file.startsWith(root) ? relative(root, file) : file;
+import path from "node:path";
+export const getShortName = (file, root) => file === root
+    ? ""
+    : file.startsWith(root + path.sep)
+        ? relative(root, file)
+        : file;

package/dist/lib/getShortName.test.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/lib/getShortName.test.mjs

@@ -0,0 +1,25 @@
+import { describe, it, expect } from "vitest";
+import { getShortName } from "./getShortName.mjs";
+import path from "node:path";
+describe("getShortName", () => {
+    it("should return the relative path if the file is inside the root", () => {
+        const root = path.join("/Users", "test", "project");
+        const file = path.join(root, "src", "index.ts");
+        expect(getShortName(file, root)).toBe(path.join("src", "index.ts"));
+    });
+    it("should return the original path if the file is outside the root", () => {
+        const root = path.join("/Users", "test", "project");
+        const file = path.join("/Users", "test", "another", "project", "src", "index.ts");
+        expect(getShortName(file, root)).toBe(file);
+    });
+    it("should return an empty string if the paths are identical", () => {
+        const root = path.join("/Users", "test", "project");
+        const file = path.join("/Users", "test", "project");
+        expect(getShortName(file, root)).toBe("");
+    });
+    it("should handle paths that are substrings of each other correctly", () => {
+        const root = path.join("/Users", "test", "project");
+        const file = path.join("/Users", "test", "project-longer", "src", "index.ts");
+        expect(getShortName(file, root)).toBe(file);
+    });
+});

package/dist/lib/hasPkgScript.d.mts

@@ -1 +1,4 @@
-export declare const hasPkgScript: (projectRootDir: string, script: string) => Promise<any>;
+import { readFile as fsReadFile } from "fs/promises";
+export declare let _pkgCache: Record<string, any> | undefined;
+export declare const hasPkgScript: (projectRootDir: string, script: string, readFile?: typeof fsReadFile) => Promise<any>;
+export declare const _resetPkgCache: () => void;

package/dist/lib/hasPkgScript.mjs

@@ -1,9 +1,12 @@
-import { readFile } from "fs/promises";
+import { readFile as fsReadFile } from "fs/promises";
 import { resolve } from "path";
-let pkg;
-export const hasPkgScript = async (projectRootDir, script) => {
-    if (!pkg) {
-        pkg = JSON.parse(await readFile(resolve(projectRootDir, "package.json"), "utf-8"));
+export let _pkgCache;
+export const hasPkgScript = async (projectRootDir, script, readFile = fsReadFile) => {
+    if (!_pkgCache) {
+        _pkgCache = JSON.parse((await readFile(resolve(projectRootDir, "package.json"))).toString());
     }
-    return pkg.scripts?.[script];
+    return _pkgCache?.scripts?.[script];
+};
+export const _resetPkgCache = () => {
+    _pkgCache = undefined;
 };

package/dist/lib/hasPkgScript.test.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/lib/hasPkgScript.test.mjs

@@ -0,0 +1,33 @@
+import { describe, it, expect, beforeEach } from "vitest";
+import { hasPkgScript, _resetPkgCache } from "./hasPkgScript.mjs";
+// Manually reset the cache before each test
+beforeEach(() => {
+    _resetPkgCache();
+});
+describe("hasPkgScript", () => {
+    it("should return the script if it exists", async () => {
+        const fakeReadFile = async () => JSON.stringify({ scripts: { "dev:init": "command" } });
+        const result = await hasPkgScript("/test", "dev:init", fakeReadFile);
+        expect(result).toBe("command");
+    });
+    it("should return undefined if the script does not exist", async () => {
+        const fakeReadFile = async () => JSON.stringify({ scripts: { test: "command" } });
+        const result = await hasPkgScript("/test", "dev:init", fakeReadFile);
+        expect(result).toBeUndefined();
+    });
+    it("should return undefined if scripts block does not exist", async () => {
+        const fakeReadFile = async () => JSON.stringify({});
+        const result = await hasPkgScript("/test", "dev:init", fakeReadFile);
+        expect(result).toBeUndefined();
+    });
+    it("should cache the package.json read", async () => {
+        let readCount = 0;
+        const fakeReadFile = async () => {
+            readCount++;
+            return JSON.stringify({ scripts: { "dev:init": "command" } });
+        };
+        await hasPkgScript("/test", "dev:init", fakeReadFile);
+        await hasPkgScript("/test", "dev:init", fakeReadFile);
+        expect(readCount).toBe(1);
+    });
+});

package/dist/lib/jsonUtils.mjs

@@ -158,6 +158,9 @@ export function parseJson(input, defaultValue, findUuid = false) {
                 }
             }
         }
+        if (lastJson !== null) {
+            return lastJson;
+        }
         return defaultValue;
     }
     catch (error) {

package/dist/lib/jsonUtils.test.d.mts

@@ -0,0 +1 @@
+export {};

package/dist/lib/jsonUtils.test.mjs

@@ -0,0 +1,90 @@
+import { describe, it, expect } from "vitest";
+import { extractLastJson, extractAllJson, parseJson } from "./jsonUtils.mjs";
+describe("jsonUtils", () => {
+    describe("extractLastJson", () => {
+        it("should extract the last JSON object from a string", () => {
+            const output = 'some text {"a":1} some other text {"b":2, "c": {"d": 3}} end';
+            expect(extractLastJson(output)).toEqual({ b: 2, c: { d: 3 } });
+        });
+        it("should extract the last JSON array from a string", () => {
+            const output = "start [1, 2] middle [3, 4, [5]] end";
+            expect(extractLastJson(output)).toEqual([3, 4, [5]]);
+        });
+        it("should return the object if the string is just JSON", () => {
+            const output = '{"a":1}';
+            expect(extractLastJson(output)).toEqual({ a: 1 });
+        });
+        it("should handle nested structures correctly", () => {
+            const output = '{"a":{"b":{"c":"d"}}}';
+            expect(extractLastJson(output)).toEqual({ a: { b: { c: "d" } } });
+        });
+        it("should return null if no valid JSON is found", () => {
+            const output = "this is just some text without json";
+            expect(extractLastJson(output)).toBeNull();
+        });
+        it("should return null for malformed JSON", () => {
+            const output = '{"a":1, "b":}';
+            expect(extractLastJson(output)).toBeNull();
+        });
+        it("should handle undefined and empty string input", () => {
+            expect(extractLastJson(undefined)).toBeNull();
+            expect(extractLastJson("")).toBeNull();
+        });
+    });
+    describe("extractAllJson", () => {
+        it("should extract all JSON objects from a string", () => {
+            const output = '{"a":1} some text {"b":2} and then {"c":3, "d": [4]}';
+            expect(extractAllJson(output)).toEqual([
+                { a: 1 },
+                { b: 2 },
+                { c: 3, d: [4] },
+            ]);
+        });
+        it("should extract all JSON arrays from a string", () => {
+            const output = "[1,2] then [3,4]";
+            expect(extractAllJson(output)).toEqual([
+                [1, 2],
+                [3, 4],
+            ]);
+        });
+        it("should handle a mix of objects and arrays", () => {
+            const output = '{"a":1} [2,3] {"b":4}';
+            expect(extractAllJson(output)).toEqual([{ a: 1 }, [2, 3], { b: 4 }]);
+        });
+        it("should return an empty array if no JSON is found", () => {
+            const output = "no json here";
+            expect(extractAllJson(output)).toEqual([]);
+        });
+        it("should ignore malformed JSON", () => {
+            const output = '{"a":1} {"b":2,} [3,4]';
+            expect(extractAllJson(output)).toEqual([{ a: 1 }, [3, 4]]);
+        });
+    });
+    describe("parseJson", () => {
+        it("should parse the last JSON object by default", () => {
+            const output = '{"a":1} {"b":2}';
+            expect(parseJson(output, {})).toEqual({ b: 2 });
+        });
+        it("should return the default value if no JSON is found", () => {
+            const output = "no json";
+            expect(parseJson(output, { default: true })).toEqual({ default: true });
+        });
+        it("should find an object with a uuid property when requested", () => {
+            const output = '{"a":1} {"uuid":"123-abc", "data": "yes"} {"c":3}';
+            expect(parseJson(output, {}, true)).toEqual({
+                uuid: "123-abc",
+                data: "yes",
+            });
+        });
+        it("should return the last object if findUuid is true but no object with uuid is found", () => {
+            const output = '{"a":1} {"b":2}';
+            expect(parseJson(output, {}, true)).toEqual({ b: 2 });
+        });
+        it("should return the default value if findUuid is true and no JSON is found", () => {
+            const output = "no json";
+            expect(parseJson(output, { default: true }, true)).toEqual({
+                default: true,
+            });
+        });
+    });
+});