@mechris3/glassbox 0.1.0

package/dist/src/utils/escape.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Escape utilities for safely interpolating values into JavaScript strings
+ * evaluated via CDP's Runtime.evaluate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeJS = escapeJS;
+/**
+ * Escape a string for safe interpolation into a single-quoted JS string.
+ * Handles quotes, backslashes, newlines, null bytes, and Unicode line/paragraph separators.
+ */
+function escapeJS(str) {
+    return str
+        .replace(/\\/g, '\\\\')
+        .replace(/'/g, "\\'")
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\0/g, '\\0')
+        .replace(/\u2028/g, '\\u2028')
+        .replace(/\u2029/g, '\\u2029');
+}
+//# sourceMappingURL=escape.js.map

package/dist/src/utils/escape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.js","sourceRoot":"","sources":["../../../src/utils/escape.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,4BASC;AAbD;;;GAGG;AACH,SAAgB,QAAQ,CAAC,GAAW;IAClC,OAAO,GAAG;SACP,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC;SAC7B,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACnC,CAAC"}

package/dist/src/utils/escape.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for escapeJS utility.
+ */
+export {};
+//# sourceMappingURL=escape.test.d.ts.map

package/dist/src/utils/escape.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.test.d.ts","sourceRoot":"","sources":["../../../src/utils/escape.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/utils/escape.test.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Unit tests for escapeJS utility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const escape_js_1 = require("./escape.js");
+(0, vitest_1.describe)('escapeJS', () => {
+    (0, vitest_1.it)('passes through plain strings unchanged', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('hello')).toBe('hello');
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('[data-testid="submit"]')).toBe('[data-testid="submit"]');
+    });
+    (0, vitest_1.it)('escapes single quotes', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)("it's")).toBe("it\\'s");
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)("a'b'c")).toBe("a\\'b\\'c");
+    });
+    (0, vitest_1.it)('escapes backslashes', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('path\\to\\file')).toBe('path\\\\to\\\\file');
+    });
+    (0, vitest_1.it)('escapes newlines and carriage returns', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('line1\nline2')).toBe('line1\\nline2');
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('line1\rline2')).toBe('line1\\rline2');
+    });
+    (0, vitest_1.it)('escapes null bytes', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('before\0after')).toBe('before\\0after');
+    });
+    (0, vitest_1.it)('escapes Unicode line/paragraph separators', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('a\u2028b')).toBe('a\\u2028b');
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('a\u2029b')).toBe('a\\u2029b');
+    });
+    (0, vitest_1.it)('handles combined special characters', () => {
+        const input = "it's a\nnew\\line\0end";
+        const expected = "it\\'s a\\nnew\\\\line\\0end";
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)(input)).toBe(expected);
+    });
+    (0, vitest_1.it)('handles empty string', () => {
+        (0, vitest_1.expect)((0, escape_js_1.escapeJS)('')).toBe('');
+    });
+    (0, vitest_1.it)('prevents selector injection', () => {
+        // A malicious selector that tries to break out of the string
+        const malicious = "'); document.location='http://evil.com';//";
+        const escaped = (0, escape_js_1.escapeJS)(malicious);
+        // When placed inside a JS string like '${escaped}', it should not break out
+        // All single quotes should be preceded by a backslash
+        (0, vitest_1.expect)(escaped).not.toMatch(/(?<!\\)'/);
+        (0, vitest_1.expect)(escaped).toContain("\\'");
+    });
+});
+//# sourceMappingURL=escape.test.js.map

package/dist/src/utils/escape.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.test.js","sourceRoot":"","sources":["../../../src/utils/escape.test.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,mCAA8C;AAC9C,2CAAuC;AAEvC,IAAA,iBAAQ,EAAC,UAAU,EAAE,GAAG,EAAE;IACxB,IAAA,WAAE,EAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qBAAqB,EAAE,GAAG,EAAE;QAC7B,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACvD,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAC/C,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAG,wBAAwB,CAAC;QACvC,MAAM,QAAQ,GAAG,8BAA8B,CAAC;QAChD,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,IAAA,eAAM,EAAC,IAAA,oBAAQ,EAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,6DAA6D;QAC7D,MAAM,SAAS,GAAG,4CAA4C,CAAC;QAC/D,MAAM,OAAO,GAAG,IAAA,oBAAQ,EAAC,SAAS,CAAC,CAAC;QACpC,4EAA4E;QAC5E,sDAAsD;QACtD,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACxC,IAAA,eAAM,EAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/utils/page-object-error.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @withErrorContext decorator — enhances page object errors with class/method context.
+ */
+export declare function withErrorContext(_target: unknown, propertyKey: string, descriptor: PropertyDescriptor): PropertyDescriptor;
+//# sourceMappingURL=page-object-error.d.ts.map

package/dist/src/utils/page-object-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-object-error.d.ts","sourceRoot":"","sources":["../../../src/utils/page-object-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAepB"}

package/dist/src/utils/page-object-error.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * @withErrorContext decorator — enhances page object errors with class/method context.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withErrorContext = withErrorContext;
+function withErrorContext(_target, propertyKey, descriptor) {
+    const originalMethod = descriptor.value;
+    descriptor.value = async function (...args) {
+        try {
+            return await originalMethod.apply(this, args);
+        }
+        catch (error) {
+            const className = this.constructor.name;
+            const enhanced = error instanceof Error ? error : new Error(String(error));
+            enhanced.message = `\n[${className}.${propertyKey}]\n${enhanced.message}`;
+            throw enhanced;
+        }
+    };
+    return descriptor;
+}
+//# sourceMappingURL=page-object-error.js.map

package/dist/src/utils/page-object-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-object-error.js","sourceRoot":"","sources":["../../../src/utils/page-object-error.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,4CAmBC;AAnBD,SAAgB,gBAAgB,CAC9B,OAAgB,EAChB,WAAmB,EACnB,UAA8B;IAE9B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAiD,CAAC;IAEpF,UAAU,CAAC,KAAK,GAAG,KAAK,WAAoD,GAAG,IAAe;QAC5F,IAAI,CAAC;YACH,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;YACxC,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3E,QAAQ,CAAC,OAAO,GAAG,MAAM,SAAS,IAAI,WAAW,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;YAC1E,MAAM,QAAQ,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/src/utils/profile-discovery.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Profile discovery — scans a browser's user data directory for available profiles.
+ *
+ * Chrome/Brave/Edge store profiles as subdirectories (Default, Profile 1, Profile 2, etc.)
+ * each containing a Preferences JSON file with the profile name.
+ */
+export interface DiscoveredProfile {
+    /** Display name from Chrome Preferences (e.g. "Personal", "Work"). */
+    name: string;
+    /** Directory name (e.g. "Default", "Profile 1"). */
+    directory: string;
+    /** Full path to the profile directory. */
+    path: string;
+}
+/**
+ * Discover all profiles within a browser's user data directory.
+ * Returns an empty array if the directory doesn't exist or has no valid profiles.
+ */
+export declare function discoverProfiles(userDataDir: string): DiscoveredProfile[];
+//# sourceMappingURL=profile-discovery.d.ts.map

package/dist/src/utils/profile-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-discovery.d.ts","sourceRoot":"","sources":["../../../src/utils/profile-discovery.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAqBzE"}

package/dist/src/utils/profile-discovery.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Profile discovery — scans a browser's user data directory for available profiles.
+ *
+ * Chrome/Brave/Edge store profiles as subdirectories (Default, Profile 1, Profile 2, etc.)
+ * each containing a Preferences JSON file with the profile name.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverProfiles = discoverProfiles;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Discover all profiles within a browser's user data directory.
+ * Returns an empty array if the directory doesn't exist or has no valid profiles.
+ */
+function discoverProfiles(userDataDir) {
+    if (!userDataDir || !(0, fs_1.existsSync)(userDataDir))
+        return [];
+    try {
+        const entries = (0, fs_1.readdirSync)(userDataDir);
+        return entries
+            .filter((entry) => isProfileDir(userDataDir, entry))
+            .map((entry) => ({
+            name: getProfileName(userDataDir, entry),
+            directory: entry,
+            path: (0, path_1.join)(userDataDir, entry),
+        }))
+            .sort((a, b) => {
+            // Default always first, then alphabetical
+            if (a.directory === 'Default')
+                return -1;
+            if (b.directory === 'Default')
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+    }
+    catch {
+        return [];
+    }
+}
+/** Check if a subdirectory looks like a Chrome profile (has a Preferences file). */
+function isProfileDir(userDataDir, entry) {
+    // Chrome profiles are named "Default" or "Profile N"
+    if (entry !== 'Default' && !entry.startsWith('Profile '))
+        return false;
+    try {
+        const dirPath = (0, path_1.join)(userDataDir, entry);
+        if (!(0, fs_1.statSync)(dirPath).isDirectory())
+            return false;
+        return (0, fs_1.existsSync)((0, path_1.join)(dirPath, 'Preferences'));
+    }
+    catch {
+        return false;
+    }
+}
+/** Read the display name from a profile's Preferences file. */
+function getProfileName(userDataDir, entry) {
+    try {
+        const prefsPath = (0, path_1.join)(userDataDir, entry, 'Preferences');
+        const content = (0, fs_1.readFileSync)(prefsPath, 'utf-8');
+        const prefs = JSON.parse(content);
+        return prefs?.profile?.name ?? entry;
+    }
+    catch {
+        return entry;
+    }
+}
+//# sourceMappingURL=profile-discovery.js.map

package/dist/src/utils/profile-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-discovery.js","sourceRoot":"","sources":["../../../src/utils/profile-discovery.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAkBH,4CAqBC;AArCD,2BAAqE;AACrE,+BAA4B;AAW5B;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,WAAmB;IAClD,IAAI,CAAC,WAAW,IAAI,CAAC,IAAA,eAAU,EAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAExD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,gBAAW,EAAC,WAAW,CAAC,CAAC;QACzC,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;aACnD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACf,IAAI,EAAE,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC;YACxC,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,IAAA,WAAI,EAAC,WAAW,EAAE,KAAK,CAAC;SAC/B,CAAC,CAAC;aACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACb,0CAA0C;YAC1C,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACP,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,YAAY,CAAC,WAAmB,EAAE,KAAa;IACtD,qDAAqD;IACrD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,IAAA,aAAQ,EAAC,OAAO,CAAC,CAAC,WAAW,EAAE;YAAE,OAAO,KAAK,CAAC;QACnD,OAAO,IAAA,eAAU,EAAC,IAAA,WAAI,EAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,SAAS,cAAc,CAAC,WAAmB,EAAE,KAAa;IACxD,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,IAAI,KAAK,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/utils/wait-utils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * waitForCondition — polls a condition until met or timeout.
+ */
+export interface WaitOptions {
+    timeout?: number;
+    interval?: number;
+    errorMessage?: string;
+}
+export declare function waitForCondition<T>(getValue: () => Promise<T>, condition: (value: T) => boolean, options?: WaitOptions): Promise<T>;
+//# sourceMappingURL=wait-utils.d.ts.map

package/dist/src/utils/wait-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/wait-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC1B,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAChC,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,CAAC,CAAC,CAaZ"}

package/dist/src/utils/wait-utils.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * waitForCondition — polls a condition until met or timeout.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.waitForCondition = waitForCondition;
+async function waitForCondition(getValue, condition, options) {
+    const timeout = options?.timeout ?? 5000;
+    const interval = options?.interval ?? 250;
+    const errorMessage = options?.errorMessage ?? 'Condition not met within timeout';
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        const value = await getValue();
+        if (condition(value))
+            return value;
+        await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+    throw new Error(`${errorMessage} (${timeout}ms)`);
+}
+//# sourceMappingURL=wait-utils.js.map

package/dist/src/utils/wait-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-utils.js","sourceRoot":"","sources":["../../../src/utils/wait-utils.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAQH,4CAiBC;AAjBM,KAAK,UAAU,gBAAgB,CACpC,QAA0B,EAC1B,SAAgC,EAChC,OAAqB;IAErB,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,GAAG,CAAC;IAC1C,MAAM,YAAY,GAAG,OAAO,EAAE,YAAY,IAAI,kCAAkC,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACnC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,GAAG,YAAY,KAAK,OAAO,KAAK,CAAC,CAAC;AACpD,CAAC"}

package/dist/src/utils/wait-utils.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for waitForCondition utility.
+ */
+export {};
+//# sourceMappingURL=wait-utils.test.d.ts.map

package/dist/src/utils/wait-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-utils.test.d.ts","sourceRoot":"","sources":["../../../src/utils/wait-utils.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/utils/wait-utils.test.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Unit tests for waitForCondition utility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const wait_utils_js_1 = require("./wait-utils.js");
+(0, vitest_1.describe)('waitForCondition', () => {
+    (0, vitest_1.it)('resolves immediately when condition is already met', async () => {
+        const result = await (0, wait_utils_js_1.waitForCondition)(async () => 42, (v) => v === 42);
+        (0, vitest_1.expect)(result).toBe(42);
+    });
+    (0, vitest_1.it)('polls until condition is met', async () => {
+        let counter = 0;
+        const result = await (0, wait_utils_js_1.waitForCondition)(async () => ++counter, (v) => v >= 3, { interval: 10 });
+        (0, vitest_1.expect)(result).toBe(3);
+    });
+    (0, vitest_1.it)('throws on timeout', async () => {
+        await (0, vitest_1.expect)((0, wait_utils_js_1.waitForCondition)(async () => false, (v) => v === true, { timeout: 50, interval: 10 })).rejects.toThrow('(50ms)');
+    });
+    (0, vitest_1.it)('uses custom error message', async () => {
+        await (0, vitest_1.expect)((0, wait_utils_js_1.waitForCondition)(async () => null, (v) => v !== null, { timeout: 50, interval: 10, errorMessage: 'Element not found' })).rejects.toThrow('Element not found (50ms)');
+    });
+    (0, vitest_1.it)('returns the value that satisfied the condition', async () => {
+        let count = 0;
+        const result = await (0, wait_utils_js_1.waitForCondition)(async () => ({ ready: ++count > 2 }), (v) => v.ready, { interval: 10 });
+        (0, vitest_1.expect)(result.ready).toBe(true);
+    });
+});
+//# sourceMappingURL=wait-utils.test.js.map

package/dist/src/utils/wait-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-utils.test.js","sourceRoot":"","sources":["../../../src/utils/wait-utils.test.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,mCAA8C;AAC9C,mDAAmD;AAEnD,IAAA,iBAAQ,EAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,IAAA,WAAE,EAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAgB,EACnC,KAAK,IAAI,EAAE,CAAC,EAAE,EACd,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAChB,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAgB,EACnC,KAAK,IAAI,EAAE,CAAC,EAAE,OAAO,EACrB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EACb,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mBAAmB,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,IAAA,eAAM,EACV,IAAA,gCAAgB,EACd,KAAK,IAAI,EAAE,CAAC,KAAK,EACjB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,EACjB,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAC9B,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;QACzC,MAAM,IAAA,eAAM,EACV,IAAA,gCAAgB,EACd,KAAK,IAAI,EAAE,CAAC,IAAI,EAChB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,EACjB,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,mBAAmB,EAAE,CACjE,CACF,CAAC,OAAO,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,MAAM,MAAM,GAAG,MAAM,IAAA,gCAAgB,EACnC,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,EACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EACd,EAAE,QAAQ,EAAE,EAAE,EAAE,CACjB,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@mechris3/glassbox",
+  "version": "0.1.0",
+  "description": "Debugger-style browser automation test runner with live execution control via CDP",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "bin": {
+    "glassbox": "dist/bin/glassbox.js"
+  },
+  "files": [
+    "dist/",
+    "ui/dist/",
+    "src/server/static/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "dev": "tsx watch bin/glassbox.ts serve",
+    "start": "node dist/bin/glassbox.js serve",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "tsx scripts/test-e2e.ts",
+    "sample-app": "node examples/sample-app/server.js",
+    "lint": "eslint src/ bin/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "browser-automation",
+    "cdp",
+    "chrome-devtools-protocol",
+    "test-runner",
+    "debugger",
+    "e2e"
+  ],
+  "author": "",
+  "license": "UNLICENSED",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^12.1.0",
+    "cors": "^2.8.5",
+    "express": "^4.21.0",
+    "glob": "^11.0.0",
+    "jiti": "^2.6.1",
+    "tsx": "^4.21.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.0",
+    "devtools-protocol": "^0.0.1648812",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}