@bigbinary/neeto-playwright-commons 2.1.5 → 2.2.0

package/README.md

@@ -130,6 +130,7 @@ import { COMMON_SELECTORS } from "@bigbinary/neeto-playwright-common";
 - [Routes](./docs/routes.md)
 - [Custom commands](./docs/custom-commands.md)
 - [MailerUtils](./docs/utils/mailer-utils.md)
+- [NeetoAuthServer](./docs/utils/neeto-auth-server.md)
 - [Util functions](./docs/utils)
 - [POMs](./docs/poms)
 - [Integration](./docs/integration)

package/index.cjs.js

@@ -3,29 +3,30 @@
 var child_process = require('child_process');
 var neetoCist = require('@bigbinary/neeto-cist');
 var faker = require('@faker-js/faker');
-var require$$0$4 = require('fs');
-var require$$0$5 = require('os');
+var fs$4 = require('fs');
+var require$$0$4 = require('os');
 var path$1 = require('path');
 var test = require('@playwright/test');
 var playwrightI18nextFixture = require('playwright-i18next-fixture');
 var require$$0$3 = require('util');
 var ramda = require('ramda');
 var dayjs = require('dayjs');
-var require$$0$8 = require('stream');
-var require$$0$7 = require('node:buffer');
-var require$$0$6 = require('buffer');
+var require$$0$7 = require('stream');
+var require$$0$6 = require('node:buffer');
+var require$$0$5 = require('buffer');
 var require$$1$2 = require('string_decoder');
 var require$$1$3 = require('node:stream');
-var require$$0$9 = require('crypto');
+var require$$0$8 = require('crypto');
 var require$$1$4 = require('zlib');
-var require$$0$a = require('assert');
-var require$$0$b = require('tty');
+var require$$0$9 = require('assert');
+var require$$0$a = require('tty');
 var stealth$1 = require('puppeteer-extra-plugin-stealth');
 var require$$1$5 = require('events');
 var customParseFormat = require('dayjs/plugin/customParseFormat');
 var timezone = require('dayjs/plugin/timezone');
 var utc = require('dayjs/plugin/utc');
 var https = require('https');
+var http = require('http');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -44,8 +45,9 @@ function _interopNamespaceDefault(e) {
     return Object.freeze(n);
 }
 
-var require$$0__namespace = /*#__PURE__*/_interopNamespaceDefault(require$$0$4);
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs$4);
 var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path$1);
+var http__namespace = /*#__PURE__*/_interopNamespaceDefault(http);
 
 const BASE_URL = "/api/v1";
 const NEETO_AUTH_BASE_URL = (subdomain = "app") => `https://${subdomain}.neetoauth.net`;
@@ -5094,7 +5096,7 @@ const joinString = (string1, string2, string3 = "", separator = " ") => {
 };
 const readFileSyncIfExists = (path = STORAGE_STATE) => {
     try {
-        return JSON.parse(require$$0__namespace.readFileSync(path, "utf8"));
+        return JSON.parse(fs__namespace.readFileSync(path, "utf8"));
     }
     catch {
         return {};
@@ -5103,7 +5105,7 @@ const readFileSyncIfExists = (path = STORAGE_STATE) => {
 const getGlobalUserState = () => readFileSyncIfExists()?.user;
 const writeDataToFile = data => {
     try {
-        require$$0__namespace.writeFileSync(STORAGE_STATE, data, "utf8");
+        fs__namespace.writeFileSync(STORAGE_STATE, data, "utf8");
     }
     catch (error) {
         console.log(error);
@@ -5116,7 +5118,7 @@ const updateCredentials = ({ key, value }) => {
     return writeDataToFile(JSON.stringify(data));
 };
 const removeCredentialFile = () => {
-    require$$0__namespace.unlink(STORAGE_STATE, error => {
+    fs__namespace.unlink(STORAGE_STATE, error => {
         if (!error)
             return;
         console.log(error);
@@ -6079,7 +6081,7 @@ class CustomCommands {
     };
     uploadFileViaDispatch = async ({ fileNameWithType, assetsPath = "../../../e2e/assets/", dispatchEvent = "drop", droppableZone = this.page.getByTestId(COMMON_SELECTORS.fileUploadBody), }) => {
         const filePath = path$1.join(__dirname, `${assetsPath}/${fileNameWithType}`);
-        const buffer = require$$0$4.readFileSync(filePath).toString("base64");
+        const buffer = fs$4.readFileSync(filePath).toString("base64");
         const dataTransfer = await droppableZone.evaluateHandle((_, { buffer, fileNameWithType }) => {
             const dataTransfer = new DataTransfer();
             const fileName = fileNameWithType.split("/")?.[1];
@@ -6266,7 +6268,7 @@ class CustomCommands {
         await test.expect(locator).toBeChecked({ checked: shouldBeChecked });
     }).toPass({ timeout: 15_000 });
     moveCursorAtBottom = async () => {
-        const isMacOS = require$$0$5.platform() === "darwin";
+        const isMacOS = require$$0$4.platform() === "darwin";
         const rightArrowKey = isMacOS ? "Meta+ArrowRight" : "End";
         const downArrowKey = isMacOS ? "Meta+ArrowDown" : "PageDown";
         await this.page.keyboard.press(rightArrowKey);
@@ -8907,7 +8909,7 @@ function requireSafer () {
 	if (hasRequiredSafer) return safer_1;
 	hasRequiredSafer = 1;
 
-	var buffer = require$$0$6;
+	var buffer = require$$0$5;
 	var Buffer = buffer.Buffer;
 
 	var safer = {};
@@ -26602,7 +26604,7 @@ function requireCharset () {
 	if (hasRequiredCharset) return charset.exports;
 	hasRequiredCharset = 1;
 
-	const { Buffer } = require$$0$7;
+	const { Buffer } = require$$0$6;
 	const iconv = requireLib$b();
 	const encodingJapanese = requireSrc$2();
 	const charsets = requireCharsets();
@@ -26728,7 +26730,7 @@ function requireLibbase64 () {
 	if (hasRequiredLibbase64) return libbase64;
 	hasRequiredLibbase64 = 1;
 
-	const { Buffer } = require$$0$7;
+	const { Buffer } = require$$0$6;
 	const stream = require$$1$3;
 	const Transform = stream.Transform;
 
@@ -26989,7 +26991,7 @@ function requireLibqp () {
 	if (hasRequiredLibqp) return libqp;
 	hasRequiredLibqp = 1;
 
-	const { Buffer } = require$$0$7;
+	const { Buffer } = require$$0$6;
 	const stream = require$$1$3;
 	const Transform = stream.Transform;
 
@@ -29364,7 +29366,7 @@ function requireLibmime () {
 	if (hasRequiredLibmime) return libmime.exports;
 	hasRequiredLibmime = 1;
 
-	const { Buffer } = require$$0$7;
+	const { Buffer } = require$$0$6;
 	const libcharset = requireCharset();
 	const libbase64 = requireLibbase64();
 	const libqp = requireLibqp();
@@ -30545,7 +30547,7 @@ function requireMimeNode () {
 	const libmime = requireLibmime();
 	const libqp = requireLibqp();
 	const libbase64 = requireLibbase64();
-	const PassThrough = require$$0$8.PassThrough;
+	const PassThrough = require$$0$7.PassThrough;
 	const pathlib = path$1;
 
 	class MimeNode {
@@ -30814,7 +30816,7 @@ function requireMessageSplitter () {
 	if (hasRequiredMessageSplitter) return messageSplitter;
 	hasRequiredMessageSplitter = 1;
 
-	const Transform = require$$0$8.Transform;
+	const Transform = require$$0$7.Transform;
 	const MimeNode = requireMimeNode();
 
 	const MAX_HEAD_SIZE = 1 * 1024 * 1024;
@@ -31244,7 +31246,7 @@ function requireMessageJoiner () {
 	if (hasRequiredMessageJoiner) return messageJoiner;
 	hasRequiredMessageJoiner = 1;
 
-	const Transform = require$$0$8.Transform;
+	const Transform = require$$0$7.Transform;
 
 	class MessageJoiner extends Transform {
 	    constructor() {
@@ -31284,7 +31286,7 @@ function requireFlowedDecoder () {
 
 	// Helper class to rewrite nodes with specific mime type
 
-	const Transform = require$$0$8.Transform;
+	const Transform = require$$0$7.Transform;
 	const libmime = requireLibmime();
 
 	/**
@@ -31347,7 +31349,7 @@ function requireNodeRewriter () {
 
 	// Helper class to rewrite nodes with specific mime type
 
-	const Transform = require$$0$8.Transform;
+	const Transform = require$$0$7.Transform;
 	const FlowedDecoder = requireFlowedDecoder();
 
 	/**
@@ -31549,7 +31551,7 @@ function requireNodeStreamer () {
 
 	// Helper class to rewrite nodes with specific mime type
 
-	const Transform = require$$0$8.Transform;
+	const Transform = require$$0$7.Transform;
 	const FlowedDecoder = requireFlowedDecoder();
 
 	/**
@@ -31676,7 +31678,7 @@ function requireChunkedPassthrough () {
 	if (hasRequiredChunkedPassthrough) return chunkedPassthrough;
 	hasRequiredChunkedPassthrough = 1;
 
-	const { Transform } = require$$0$8;
+	const { Transform } = require$$0$7;
 
 	class ChunkedPassthrough extends Transform {
 	    constructor(options = {}) {
@@ -32602,8 +32604,8 @@ function requireStreamHash () {
 	if (hasRequiredStreamHash) return streamHash;
 	hasRequiredStreamHash = 1;
 
-	const crypto = require$$0$9;
-	const Transform = require$$0$8.Transform;
+	const crypto = require$$0$8;
+	const Transform = require$$0$7.Transform;
 
 	class StreamHash extends Transform {
 	    constructor(attachment, algo) {
@@ -54986,7 +54988,7 @@ function requireMailParser () {
 	const mailsplit = requireMailsplit();
 	const libmime = requireLibmime();
 	const addressparser = requireAddressparser();
-	const Transform = require$$0$8.Transform;
+	const Transform = require$$0$7.Transform;
 	const Splitter = mailsplit.Splitter;
 	const ChunkedPassthrough = mailsplit.ChunkedPassthrough;
 	const punycode = require$$4$2;
@@ -60620,9 +60622,7 @@ class MailerUtils {
         const { html: { codes }, } = await this.findMessage({ to: email, subject: subjectSubstring }, { timeout, receivedAfter, expectedEmailCount });
         return codes?.[0];
     };
-    generateRandomEmail = (shouldUseBypassEmail = false) => shouldUseBypassEmail
-        ? generateRandomBypassEmail()
-        : faker.faker.internet.email({ provider: process.env.FASTMAIL_DOMAIN_NAME });
+    generateRandomEmail = () => faker.faker.internet.email({ provider: process.env.FASTMAIL_DOMAIN_NAME });
     getEmailAttachment = async (attachmentName, messageSearchCriteria = {}, { timeout = 10_000, receivedAfter = dateTimeOneHourAgo(), expectedEmailCount = 1, } = {}, shouldThrowErrorOnTimeout = true) => {
         if (IS_DEV_ENV) {
             return this.railsEmailUtils.getEmailAttachment(attachmentName, messageSearchCriteria, { receivedAfter, expectedEmailCount, timeout: timeout / 3 }, shouldThrowErrorOnTimeout);
@@ -67006,7 +67006,7 @@ function requireGifutil () {
 
 		/** @namespace GifUtil */
 
-		const fs = require$$0$4;
+		const fs = fs$4;
 		const ImageQ = requireImageQ();
 
 		const BitmapImage = requireBitmapimage();
@@ -69823,7 +69823,7 @@ function requireChunkstream () {
 	hasRequiredChunkstream = 1;
 
 	let util = require$$0$3;
-	let Stream = require$$0$8;
+	let Stream = require$$0$7;
 
 	let ChunkStream = (chunkstream.exports = function () {
 	  Stream.call(this);
@@ -71792,7 +71792,7 @@ function requirePackerAsync () {
 	hasRequiredPackerAsync = 1;
 
 	let util = require$$0$3;
-	let Stream = require$$0$8;
+	let Stream = require$$0$7;
 	let constants = requireConstants$4();
 	let Packer = requirePacker();
 
@@ -71853,11 +71853,11 @@ function requireSyncInflate () {
 	hasRequiredSyncInflate = 1;
 	(function (module, exports$1) {
 
-		let assert = require$$0$a.ok;
+		let assert = require$$0$9.ok;
 		let zlib = require$$1$4;
 		let util = require$$0$3;
 
-		let kMaxLength = require$$0$6.kMaxLength;
+		let kMaxLength = require$$0$5.kMaxLength;
 
 		function Inflate(opts) {
 		  if (!(this instanceof Inflate)) {
@@ -72314,7 +72314,7 @@ function requirePng () {
 	hasRequiredPng = 1;
 
 	let util = require$$0$3;
-	let Stream = require$$0$8;
+	let Stream = require$$0$7;
 	let Parser = requireParserAsync();
 	let Packer = requirePackerAsync();
 	let PNGSync = requirePngSync();
@@ -89472,8 +89472,8 @@ function to(promise, errorExt) {
     });
 }
 
-const readFile = require$$0$4.promises.readFile;
-const writeFile = require$$0$4.promises.writeFile;
+const readFile = fs$4.promises.readFile;
+const writeFile = fs$4.promises.writeFile;
 
 var Mime_1;
 var hasRequiredMime;
@@ -91544,7 +91544,7 @@ function createJimp({ plugins: pluginsArg, formats: formatsArg, } = {}) {
             if (Buffer.isBuffer(url) || url instanceof ArrayBuffer) {
                 return this.fromBuffer(url);
             }
-            if (require$$0$4.existsSync(url)) {
+            if (fs$4.existsSync(url)) {
                 return this.fromBuffer(await readFile(url));
             }
             const [fetchErr, response] = await to(fetch(url));
@@ -107148,7 +107148,7 @@ var jsQR = /*@__PURE__*/getDefaultExportFromCjs(jsQRExports);
 const decodeQRCodeFromFile = async (filePath) => {
     let decodedString;
     try {
-        const buffer = require$$0$4.readFileSync(filePath);
+        const buffer = fs$4.readFileSync(filePath);
         const image = await Jimp.read(buffer);
         const bitmapData = new Uint8ClampedArray(image.bitmap.data);
         const qrData = jsQR(bitmapData, image.bitmap.width, image.bitmap.height);
@@ -107185,7 +107185,7 @@ class QRCodeUtils {
     decodeQRCodeFromFile = async (filePath) => {
         let decodedString;
         try {
-            const buffer = require$$0$4.readFileSync(filePath);
+            const buffer = fs$4.readFileSync(filePath);
             const image = await Jimp.read(buffer);
             const bitmapData = new Uint8ClampedArray(image.bitmap.data);
             const qrData = jsQR(bitmapData, image.bitmap.width, image.bitmap.height);
@@ -108041,7 +108041,7 @@ var hasRequiredSupportsColor;
 function requireSupportsColor () {
 	if (hasRequiredSupportsColor) return supportsColor_1;
 	hasRequiredSupportsColor = 1;
-	const os = require$$0$5;
+	const os = require$$0$4;
 	const hasFlag = requireHasFlag();
 
 	const env = process.env;
@@ -108184,7 +108184,7 @@ function requireNode () {
 	if (hasRequiredNode) return node.exports;
 	hasRequiredNode = 1;
 	(function (module, exports$1) {
-		const tty = require$$0$b;
+		const tty = require$$0$a;
 		const util = require$$0$3;
 
 		/**
@@ -109511,7 +109511,7 @@ function requirePath () {
 	hasRequiredPath = 1;
 	Object.defineProperty(path, "__esModule", { value: true });
 	path.convertPosixPathToPattern = path.convertWindowsPathToPattern = path.convertPathToPattern = path.escapePosixPath = path.escapeWindowsPath = path.escape = path.removeLeadingDotSegment = path.makeAbsolute = path.unixify = void 0;
-	const os = require$$0$5;
+	const os = require$$0$4;
 	const path$2 = path$1;
 	const IS_WINDOWS_PLATFORM = os.platform() === 'win32';
 	const LEADING_DOT_SEGMENT_CHARACTERS_COUNT = 2; // ./ or .\\
@@ -109778,7 +109778,7 @@ function requireGlobParent () {
 
 	var isGlob = requireIsGlob();
 	var pathPosixDirname = path$1.posix.dirname;
-	var isWin32 = require$$0$5.platform() === 'win32';
+	var isWin32 = require$$0$4.platform() === 'win32';
 
 	var slash = '/';
 	var backslash = /\\/g;
@@ -114171,7 +114171,7 @@ function requireMerge2 () {
 	 * Copyright (c) 2014-2020 Teambition
 	 * Licensed under the MIT license.
 	 */
-	const Stream = require$$0$8;
+	const Stream = require$$0$7;
 	const PassThrough = Stream.PassThrough;
 	const slice = Array.prototype.slice;
 
@@ -114600,7 +114600,7 @@ function requireFs$2 () {
 	(function (exports$1) {
 		Object.defineProperty(exports$1, "__esModule", { value: true });
 		exports$1.createFileSystemAdapter = exports$1.FILE_SYSTEM_ADAPTER = void 0;
-		const fs = require$$0$4;
+		const fs = fs$4;
 		exports$1.FILE_SYSTEM_ADAPTER = {
 		    lstat: fs.lstat,
 		    stat: fs.stat,
@@ -115030,7 +115030,7 @@ function requireFs () {
 	(function (exports$1) {
 		Object.defineProperty(exports$1, "__esModule", { value: true });
 		exports$1.createFileSystemAdapter = exports$1.FILE_SYSTEM_ADAPTER = void 0;
-		const fs = require$$0$4;
+		const fs = fs$4;
 		exports$1.FILE_SYSTEM_ADAPTER = {
 		    lstat: fs.lstat,
 		    stat: fs.stat,
@@ -115663,7 +115663,7 @@ function requireStream$2 () {
 	if (hasRequiredStream$2) return stream$2;
 	hasRequiredStream$2 = 1;
 	Object.defineProperty(stream$2, "__esModule", { value: true });
-	const stream_1 = require$$0$8;
+	const stream_1 = require$$0$7;
 	const async_1 = requireAsync$3();
 	class StreamProvider {
 	    constructor(_root, _settings) {
@@ -115915,7 +115915,7 @@ function requireStream$1 () {
 	if (hasRequiredStream$1) return stream$1;
 	hasRequiredStream$1 = 1;
 	Object.defineProperty(stream$1, "__esModule", { value: true });
-	const stream_1 = require$$0$8;
+	const stream_1 = require$$0$7;
 	const fsStat = requireOut$3();
 	const fsWalk = requireOut$1();
 	const reader_1 = requireReader();
@@ -116433,7 +116433,7 @@ function requireStream () {
 	if (hasRequiredStream) return stream;
 	hasRequiredStream = 1;
 	Object.defineProperty(stream, "__esModule", { value: true });
-	const stream_1 = require$$0$8;
+	const stream_1 = require$$0$7;
 	const stream_2 = requireStream$1();
 	const provider_1 = requireProvider();
 	class ProviderStream extends provider_1.default {
@@ -116559,8 +116559,8 @@ function requireSettings () {
 	(function (exports$1) {
 		Object.defineProperty(exports$1, "__esModule", { value: true });
 		exports$1.DEFAULT_FILE_SYSTEM_ADAPTER = void 0;
-		const fs = require$$0$4;
-		const os = require$$0$5;
+		const fs = fs$4;
+		const os = require$$0$4;
 		/**
 		 * The `os.cpus` method can return zero. We expect the number of cores to be greater than zero.
 		 * https://github.com/nodejs/node/blob/7faeddf23a98c53896f8b574a6e66589e8fb1eb8/lib/os.js#L106-L107
@@ -116916,7 +116916,7 @@ class EmbedBase {
             ? `${embedCode}<a href='#' id='open-popup-button'>${customElementText}</a>`
             : embedCode);
         this.filePath = `tmp/${faker.faker.word.noun()}.html`;
-        require$$0$4.writeFileSync(this.filePath, fileContent, "utf8");
+        fs$4.writeFileSync(this.filePath, fileContent, "utf8");
         await this.embedTestPage.goto(`file://${path$1.resolve(this.filePath)}`, {
             timeout: 20_000,
         });
@@ -116936,7 +116936,7 @@ class EmbedBase {
         }
         await this.embedTestPage.close();
         await this.context.close();
-        require$$0$4.unlinkSync(this.filePath);
+        fs$4.unlinkSync(this.filePath);
     };
     clickOnPopupButton = async (popUpButtonSelectorOptions) => {
         const popUpButton = this.embedTestPage.getByRole(this.embedTestPageType === "floatingPopup" ? "button" : "link", popUpButtonSelectorOptions);
@@ -120030,7 +120030,7 @@ class EditorPage {
     }).toPass({ timeout: 30_000 });
     focusText = (textLocator) => test.expect(async () => {
         await textLocator.click();
-        await this.page.keyboard.press(require$$0$5.platform() === "darwin" ? "Meta+ArrowRight" : "End");
+        await this.page.keyboard.press(require$$0$4.platform() === "darwin" ? "Meta+ArrowRight" : "End");
         await test.expect(textLocator.locator("..")).toHaveClass(/has-focus/, {
             timeout: 5_000,
         });
@@ -124970,6 +124970,160 @@ const generatePhoneNumberDetails = () => {
     return { flag: country.flag, name: country.name, code: country.code, number };
 };
 
+const CONFIG = {
+    DIR: "/tmp/neeto-auth-web",
+    LOG: "/tmp/neeto-auth-server.log",
+    PORT: 9000,
+    MAX_WAIT_MS: 120_000,
+    EMAIL_INIT: "/tmp/neeto-auth-web/config/initializers/playwright_email_capture.rb",
+};
+const SCRIPTS_DIR = path__namespace.join(__dirname, "scripts", "neeto-auth");
+const escapeRubyString = (value) => value.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+const buildEmailCaptureInitializer = (targetApp) => {
+    const template = fs__namespace.readFileSync(path__namespace.join(SCRIPTS_DIR, "playwright_email_capture.rb.template"), "utf-8");
+    return template.replace("{{TARGET_APP}}", escapeRubyString(targetApp));
+};
+const log = (msg) => console.log(`[NeetoAuth] ${msg}`);
+const sleep = (ms) => new Promise(resolve => setTimeout(resolve, ms));
+const httpCheck = (port, timeout = 3000) => new Promise(resolve => {
+    const req = http__namespace.get(`http://localhost:${port}/`, () => resolve(true));
+    req.on("error", () => resolve(false));
+    req.setTimeout(timeout, () => {
+        req.destroy();
+        resolve(false);
+    });
+});
+class NeetoAuthServer {
+    process = null;
+    targetApp;
+    constructor(appName) {
+        this.targetApp = STATUS_TEXTS.appName(appName);
+    }
+    get serverEnv() {
+        return {
+            ...process.env,
+            BUNDLE_PATH: undefined,
+            RAILS_ENV: "development",
+            POSTGRES_USER: process.env.POSTGRES_USER ?? process.env.USER ?? "postgres",
+        };
+    }
+    waitForProcessExit = async (pid) => {
+        const deadline = Date.now() + 10_000;
+        while (Date.now() < deadline) {
+            try {
+                process.kill(pid, 0);
+                await sleep(500);
+            }
+            catch {
+                return;
+            }
+        }
+    };
+    killServerOnPort = async () => {
+        try {
+            child_process.execSync(`lsof -ti tcp:${CONFIG.PORT} | xargs kill -9`, {
+                stdio: "ignore",
+            });
+            await sleep(1000);
+        }
+        catch {
+            // No process on that port — nothing to kill.
+        }
+    };
+    ensureSetup = () => {
+        if (fs__namespace.existsSync(`${CONFIG.DIR}/Gemfile`)) {
+            log("Already set up, skipping.");
+            return;
+        }
+        if (!process.env.GITHUB_TOKEN) {
+            throw new Error("[NeetoAuth] GITHUB_TOKEN is not set. Cannot clone neeto-auth-web.");
+        }
+        log("Running first-time setup...");
+        const setupScript = path__namespace.join(SCRIPTS_DIR, "setup.sh");
+        try {
+            child_process.execSync(`bash "${setupScript}" "${CONFIG.DIR}"`, {
+                stdio: "inherit",
+                env: this.serverEnv,
+            });
+        }
+        catch {
+            throw new Error("[NeetoAuth] First-time setup failed. Check the output above for details.");
+        }
+        log("Setup complete.");
+    };
+    waitForServer = async (timeoutMs = CONFIG.MAX_WAIT_MS) => {
+        const startTime = Date.now();
+        while (Date.now() - startTime < timeoutMs) {
+            if (this.process !== null && this.process.exitCode !== null) {
+                const logContent = fs__namespace.existsSync(CONFIG.LOG)
+                    ? fs__namespace.readFileSync(CONFIG.LOG, "utf-8")
+                    : "<no log file>";
+                throw new Error(`[NeetoAuth] Server process exited unexpectedly with code ${this.process.exitCode}.\nLog:\n${logContent}`);
+            }
+            if (await httpCheck(CONFIG.PORT))
+                return;
+            await sleep(3000);
+        }
+        const logContent = fs__namespace.existsSync(CONFIG.LOG)
+            ? fs__namespace.readFileSync(CONFIG.LOG, "utf-8")
+            : "<no log file>";
+        throw new Error(`[NeetoAuth] Server did not start within ${timeoutMs / 1000}s.\nLog:\n${logContent}`);
+    };
+    injectEmailCaptureInitializer = () => {
+        fs__namespace.writeFileSync(CONFIG.EMAIL_INIT, buildEmailCaptureInitializer(this.targetApp));
+    };
+    isRunningForCurrentApp = () => {
+        if (!fs__namespace.existsSync(CONFIG.EMAIL_INIT))
+            return false;
+        const currentContent = fs__namespace.readFileSync(CONFIG.EMAIL_INIT, "utf-8");
+        return currentContent === buildEmailCaptureInitializer(this.targetApp);
+    };
+    start = async () => {
+        if (IS_STAGING_ENV)
+            return;
+        if (await httpCheck(CONFIG.PORT)) {
+            if (this.isRunningForCurrentApp()) {
+                log("Server already running for this app.");
+                return;
+            }
+            log("Server running for a different app — restarting...");
+            await this.killServerOnPort();
+        }
+        this.ensureSetup();
+        this.injectEmailCaptureInitializer();
+        log("Starting server...");
+        const logStream = fs__namespace.createWriteStream(CONFIG.LOG);
+        this.process = child_process.spawn("bundle", [
+            "exec",
+            "rails",
+            "server",
+            "-p",
+            CONFIG.PORT.toString(),
+            "-b",
+            "0.0.0.0",
+        ], {
+            cwd: CONFIG.DIR,
+            stdio: ["ignore", "pipe", "pipe"],
+            env: this.serverEnv,
+        });
+        this.process.stdout?.pipe(logStream);
+        this.process.stderr?.pipe(logStream);
+        await this.waitForServer();
+        log("Server ready.");
+    };
+    stop = async () => {
+        if (IS_STAGING_ENV || !this.process)
+            return;
+        const pid = this.process.pid;
+        log("Stopping server...");
+        this.process.kill("SIGTERM");
+        this.process = null;
+        if (pid) {
+            await this.waitForProcessExit(pid);
+        }
+    };
+}
+
 var main$1 = {exports: {}};
 
 var version = "17.3.1";
@@ -124981,10 +125135,10 @@ var hasRequiredMain$1;
 function requireMain$1 () {
 	if (hasRequiredMain$1) return main$1.exports;
 	hasRequiredMain$1 = 1;
-	const fs = require$$0$4;
+	const fs = fs$4;
 	const path = path$1;
-	const os = require$$0$5;
-	const crypto = require$$0$9;
+	const os = require$$0$4;
+	const crypto = require$$0$8;
 	const packageJson = require$$4;
 
 	const version = packageJson.version;
@@ -125535,7 +125689,7 @@ const envLocalPath = `${envBasePath}.local`;
 const reporterPackageName = "@bigbinary/neeto-playwright-reporter";
 process.env.TEST_ENV = process.env.TEST_ENV ?? ENVIRONMENT.development;
 loadEnv(`${envBasePath}.${process.env.TEST_ENV}`);
-require$$0__namespace.existsSync(envLocalPath) && loadEnv(envLocalPath);
+fs__namespace.existsSync(envLocalPath) && loadEnv(envLocalPath);
 const playdashStagingConfig = {
     apiKey: process.env.PLAYDASH_STAGING_API_KEY,
     ciBuildId: process.env.NEETO_CI_JOB_ID,
@@ -125816,6 +125970,7 @@ exports.NEETO_IMAGE_UPLOADER_SELECTORS = NEETO_IMAGE_UPLOADER_SELECTORS;
 exports.NEETO_ROUTES = NEETO_ROUTES;
 exports.NEETO_SEO_SELECTORS = NEETO_SEO_SELECTORS;
 exports.NEETO_TEXT_MODIFIER_SELECTORS = NEETO_TEXT_MODIFIER_SELECTORS;
+exports.NeetoAuthServer = NeetoAuthServer;
 exports.NeetoTowerApi = NeetoTowerApi;
 exports.ONBOARDING_SELECTORS = ONBOARDING_SELECTORS;
 exports.ORGANIZATION_TEXTS = ORGANIZATION_TEXTS;