sweetlink 0.1.0

package/dist/src/runtime/browser/utils/number.d.ts

@@ -0,0 +1,2 @@
+export declare const clamp: (value: number, min: number, max: number) => number;
+//# sourceMappingURL=number.d.ts.map

package/dist/src/runtime/browser/utils/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/number.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,EAAE,KAAK,MAAM,KAAG,MAA6C,CAAC"}

package/dist/src/runtime/browser/utils/number.js

@@ -0,0 +1,2 @@
+export const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+//# sourceMappingURL=number.js.map

package/dist/src/runtime/browser/utils/number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.js","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/number.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC"}

package/dist/src/runtime/browser/utils/object.d.ts

@@ -0,0 +1,3 @@
+export declare const isRecord: <T extends Record<string, unknown>>(value: unknown) => value is T;
+export declare const toTrimmedNonEmptyString: (value: unknown) => string | null;
+//# sourceMappingURL=object.d.ts.map

package/dist/src/runtime/browser/utils/object.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/object.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,OAAO,KAAG,KAAK,IAAI,CAAyE,CAAC;AAEhK,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,IAMjE,CAAC"}

package/dist/src/runtime/browser/utils/object.js

@@ -0,0 +1,9 @@
+export const isRecord = (value) => Boolean(value && typeof value === 'object' && !Array.isArray(value));
+export const toTrimmedNonEmptyString = (value) => {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : null;
+};
+//# sourceMappingURL=object.js.map

package/dist/src/runtime/browser/utils/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/object.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAoC,KAAc,EAAc,EAAE,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAEhK,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,KAAc,EAAiB,EAAE;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC,CAAC"}

package/dist/src/runtime/browser/utils/sanitize.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeResult(value: unknown): unknown;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/src/runtime/browser/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/sanitize.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAwBtD"}

package/dist/src/runtime/browser/utils/sanitize.js

@@ -0,0 +1,28 @@
+export function sanitizeResult(value) {
+    if (value instanceof Error) {
+        return {
+            name: value.name,
+            message: value.message,
+            stack: value.stack,
+        };
+    }
+    if (typeof value === 'bigint') {
+        return value.toString();
+    }
+    if (typeof value === 'function') {
+        return value.toString();
+    }
+    try {
+        return structuredClone(value);
+    }
+    catch {
+        try {
+            const serialized = JSON.stringify(value);
+            return JSON.parse(serialized);
+        }
+        catch {
+            return String(value);
+        }
+    }
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/src/runtime/browser/utils/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;SACnB,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IACD,IAAI,CAAC;QACH,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACzC,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/runtime/browser/utils/time.d.ts

@@ -0,0 +1,2 @@
+export declare const normalizeExpiresAtMs: (expiresAt: unknown) => number | null;
+//# sourceMappingURL=time.d.ts.map

package/dist/src/runtime/browser/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/time.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,GAAI,WAAW,OAAO,KAAG,MAAM,GAAG,IAKlE,CAAC"}

package/dist/src/runtime/browser/utils/time.js

@@ -0,0 +1,7 @@
+export const normalizeExpiresAtMs = (expiresAt) => {
+    if (typeof expiresAt !== 'number' || !Number.isFinite(expiresAt)) {
+        return null;
+    }
+    return expiresAt > 10_000_000_000 ? expiresAt : expiresAt * 1000;
+};
+//# sourceMappingURL=time.js.map

package/dist/src/runtime/browser/utils/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../../../src/runtime/browser/utils/time.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAkB,EAAiB,EAAE;IACxE,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC;AACnE,CAAC,CAAC"}

package/dist/src/runtime/chrome/constants.d.ts

@@ -0,0 +1,5 @@
+export declare const PUPPETEER_NAVIGATION_TIMEOUT_MS = 45000;
+export declare const PAGE_READY_PRIMARY_TIMEOUT_MS = 15000;
+export declare const PAGE_READY_SECONDARY_TIMEOUT_MS = 30000;
+export declare const PUPPETEER_PROTOCOL_TIMEOUT_MS = 45000;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/runtime/chrome/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/runtime/chrome/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,6BAA6B,QAAS,CAAC;AACpD,eAAO,MAAM,+BAA+B,QAAS,CAAC;AACtD,eAAO,MAAM,6BAA6B,QAAS,CAAC"}

package/dist/src/runtime/chrome/constants.js

@@ -0,0 +1,5 @@
+export const PUPPETEER_NAVIGATION_TIMEOUT_MS = 45_000;
+export const PAGE_READY_PRIMARY_TIMEOUT_MS = 15_000;
+export const PAGE_READY_SECONDARY_TIMEOUT_MS = 30_000;
+export const PUPPETEER_PROTOCOL_TIMEOUT_MS = 45_000;
+//# sourceMappingURL=constants.js.map

package/dist/src/runtime/chrome/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/runtime/chrome/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AACtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AACpD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAM,CAAC;AACtD,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC"}

package/dist/src/runtime/chrome/cookies.d.ts

@@ -0,0 +1,20 @@
+import { delay } from '../../util/time.js';
+import { buildCookieOrigins, collectChromeCookies } from '../cookies.js';
+import { attemptPuppeteerReload, navigatePuppeteerPage, resolvePuppeteerPage, waitForPageReady } from './puppeteer.js';
+type PrimeChromeCookiesDeps = {
+    collectChromeCookies: typeof collectChromeCookies;
+    resolvePuppeteerPage: typeof resolvePuppeteerPage;
+    navigatePuppeteerPage: typeof navigatePuppeteerPage;
+    waitForPageReady: typeof waitForPageReady;
+    attemptPuppeteerReload: typeof attemptPuppeteerReload;
+    delay: typeof delay;
+    buildCookieOrigins: typeof buildCookieOrigins;
+};
+export declare function primeControlledChromeCookies(options: {
+    devtoolsUrl: string;
+    targetUrl: string;
+    reload: boolean;
+    context: 'new-window' | 'existing-tab' | 'new-tab';
+}, deps?: Partial<PrimeChromeCookiesDeps>): Promise<void>;
+export {};
+//# sourceMappingURL=cookies.d.ts.map

package/dist/src/runtime/chrome/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../../../../src/runtime/chrome/cookies.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAA6B,MAAM,eAAe,CAAC;AAEpG,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvH,KAAK,sBAAsB,GAAG;IAC5B,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;IACpD,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IAC1C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,KAAK,EAAE,OAAO,KAAK,CAAC;IACpB,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;CAC/C,CAAC;AAEF,wBAAsB,4BAA4B,CAChD,OAAO,EAAE;IACP,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;CACpD,EACD,IAAI,GAAE,OAAO,CAAC,sBAAsB,CAAM,GACzC,OAAO,CAAC,IAAI,CAAC,CAkHf"}

package/dist/src/runtime/chrome/cookies.js

@@ -0,0 +1,139 @@
+import { regex } from 'arkregex';
+import { uniq } from 'es-toolkit';
+import { sweetLinkDebug } from '../../env.js';
+import { delay } from '../../util/time.js';
+import { buildCookieOrigins, collectChromeCookies } from '../cookies.js';
+import { PUPPETEER_PROTOCOL_TIMEOUT_MS } from './constants.js';
+import { attemptPuppeteerReload, navigatePuppeteerPage, resolvePuppeteerPage, waitForPageReady } from './puppeteer.js';
+const AUTH_COOKIE_PATTERN = regex.as('auth|session|token', 'i');
+export async function primeControlledChromeCookies(options, deps = {}) {
+    const { collectChromeCookies: collectCookies = collectChromeCookies, resolvePuppeteerPage: resolvePage = resolvePuppeteerPage, navigatePuppeteerPage: navigatePage = navigatePuppeteerPage, waitForPageReady: waitForPage = waitForPageReady, attemptPuppeteerReload: reloadPage = attemptPuppeteerReload, delay: delayFn = delay, buildCookieOrigins: buildOrigins = buildCookieOrigins, } = deps;
+    const cookies = await collectCookies(options.targetUrl);
+    if (cookies.length === 0) {
+        console.log('No Chrome cookies found for this origin; continuing without priming the controlled window.');
+        return;
+    }
+    let puppeteer = null;
+    try {
+        ({ default: puppeteer } = await import('puppeteer'));
+    }
+    catch (error) {
+        console.warn('Unable to load Puppeteer while priming cookies:', error);
+        return;
+    }
+    if (!puppeteer) {
+        return;
+    }
+    let browser = null;
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+        try {
+            // biome-ignore lint/performance/noAwaitInLoops: puppeteer connection retries must be sequential.
+            browser = await puppeteer.connect({
+                browserURL: options.devtoolsUrl,
+                defaultViewport: null,
+                protocolTimeout: PUPPETEER_PROTOCOL_TIMEOUT_MS,
+            });
+            break;
+        }
+        catch (error) {
+            if (attempt === 9) {
+                console.warn('Unable to attach to controlled Chrome for cookie priming:', error);
+                return;
+            }
+            await delayFn(200);
+        }
+    }
+    if (!browser) {
+        console.warn('Unable to attach to controlled Chrome for cookie priming: unknown error');
+        return;
+    }
+    try {
+        let page = await resolvePage(browser, options.targetUrl);
+        if (!page) {
+            const fallbackPage = await browser.newPage();
+            const navigated = await navigatePage(fallbackPage, options.targetUrl, 3);
+            if (!navigated) {
+                console.warn('Unable to locate or recreate the controlled tab while priming cookies.');
+                await fallbackPage.close().catch(() => {
+                    /* ignored */
+                });
+                return;
+            }
+            page = fallbackPage;
+        }
+        await waitForPage(page);
+        await page.setCookie(...cookies);
+        await verifyCookieSync(page, options.targetUrl, cookies, buildOrigins);
+        if (options.reload) {
+            await reloadPage(page);
+        }
+        let contextLabel = 'controlled window';
+        if (options.context === 'existing-tab') {
+            contextLabel = 'existing controlled tab';
+        }
+        else if (options.context === 'new-tab') {
+            contextLabel = 'controlled tab';
+        }
+        console.log(`Copied ${cookies.length} cookie${cookies.length === 1 ? '' : 's'} from your main Chrome profile into the ${contextLabel}${options.reload ? ' and refreshed the tab to apply the session.' : '.'}`);
+        const cookieNames = cookies
+            .map((cookie) => (typeof cookie.name === 'string' ? cookie.name : null))
+            .filter((name) => typeof name === 'string' && name.trim().length > 0);
+        if (cookieNames.length > 0) {
+            const authCookies = uniq(cookieNames.filter((name) => AUTH_COOKIE_PATTERN.test(name)));
+            if (authCookies.length > 0) {
+                console.log(`Detected likely auth cookies: ${authCookies.join(', ')}.`);
+            }
+            else {
+                console.log('No obvious auth/session cookies detected—expect to re-authenticate in the controlled window.');
+            }
+            const hasHttpOnly = cookies.some((cookie) => Boolean(cookie.httpOnly));
+            console.log(`HttpOnly cookies present: ${hasHttpOnly ? 'yes' : 'no'} (Chrome may restrict visibility inside the page).`);
+        }
+        if (!options.reload && options.context === 'existing-tab') {
+            console.log('Hint: reload the tab if the session has not updated yet.');
+        }
+    }
+    catch (error) {
+        console.warn('Failed to apply Chrome cookies to the controlled window:', error);
+    }
+    finally {
+        try {
+            await browser.disconnect();
+        }
+        catch (disconnectError) {
+            if (sweetLinkDebug) {
+                console.warn('Unable to disconnect Puppeteer browser after cookie sync.', disconnectError);
+            }
+        }
+    }
+}
+async function verifyCookieSync(page, targetUrl, attempted, buildOrigins = buildCookieOrigins) {
+    if (attempted.length === 0) {
+        return;
+    }
+    try {
+        const appliedNames = new Set();
+        const origins = buildOrigins(targetUrl);
+        for (const origin of origins) {
+            try {
+                // biome-ignore lint/performance/noAwaitInLoops: cookie collection per origin must remain sequential for accurate logging.
+                const cookies = await page.cookies(origin);
+                for (const cookie of cookies) {
+                    appliedNames.add(cookie.name);
+                }
+            }
+            catch {
+                /* ignore per-origin failures */
+            }
+        }
+        const missing = attempted.filter((cookie) => !appliedNames.has(cookie.name));
+        if (missing.length > 0) {
+            const missingNames = missing.map((cookie) => cookie.name).join(', ');
+            console.warn(`Warning: the controlled window is missing ${missing.length} cookie(s) (${missingNames}).`);
+        }
+    }
+    catch (error) {
+        console.warn('Unable to verify cookie sync in the controlled window:', error);
+    }
+}
+//# sourceMappingURL=cookies.js.map

package/dist/src/runtime/chrome/cookies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.js","sourceRoot":"","sources":["../../../../src/runtime/chrome/cookies.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/chrome/diagnostics.d.ts

@@ -0,0 +1,6 @@
+export declare function collectPuppeteerDiagnostics(devtoolsUrl: string, targetUrl: string): Promise<{
+    overlayText?: string | null;
+    bodyText?: string | null;
+    title?: string | null;
+} | null>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/src/runtime/chrome/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../src/runtime/chrome/diagnostics.ts"],"names":[],"mappings":"AAGA,wBAAsB,2BAA2B,CAC/C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAAC,CA+ClG"}

package/dist/src/runtime/chrome/diagnostics.js

@@ -0,0 +1,49 @@
+import { sweetLinkDebug } from '../../env.js';
+import { connectPuppeteerBrowser, resolvePuppeteerPage, waitForPageReady } from './puppeteer.js';
+export async function collectPuppeteerDiagnostics(devtoolsUrl, targetUrl) {
+    let puppeteer;
+    try {
+        ({ default: puppeteer } = await import('puppeteer'));
+    }
+    catch (error) {
+        console.warn('Unable to load Puppeteer while collecting diagnostics:', error);
+        return null;
+    }
+    const browser = await connectPuppeteerBrowser(puppeteer, devtoolsUrl, 2);
+    if (!browser) {
+        return null;
+    }
+    try {
+        const page = await resolvePuppeteerPage(browser, targetUrl);
+        if (!page) {
+            return null;
+        }
+        await waitForPageReady(page).catch(() => {
+            /* ignore readiness errors */
+        });
+        return await page.evaluate(() => {
+            const overlay = document.querySelector('[data-nextjs-error-overlay-root]') ||
+                document.querySelector('[data-nextjs-error-overlay]') ||
+                document.querySelector('#__nextjs__container_errors');
+            const overlayText = overlay && typeof overlay.textContent === 'string' ? overlay.textContent : null;
+            const bodyText = document.body && typeof document.body.textContent === 'string' ? document.body.textContent : null;
+            const title = typeof document.title === 'string' ? document.title : null;
+            return { overlayText, bodyText, title };
+        });
+    }
+    catch (error) {
+        if (sweetLinkDebug) {
+            console.warn('Unable to capture Puppeteer diagnostics:', error);
+        }
+        return null;
+    }
+    finally {
+        try {
+            await browser.disconnect();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/src/runtime/chrome/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../../src/runtime/chrome/diagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEjG,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,SAAiB;IAEjB,IAAI,SAA6C,CAAC;IAClD,IAAI,CAAC;QACH,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,wDAAwD,EAAE,KAAK,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACtC,6BAA6B;QAC/B,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE;YAC9B,MAAM,OAAO,GACX,QAAQ,CAAC,aAAa,CAAC,kCAAkC,CAAC;gBAC1D,QAAQ,CAAC,aAAa,CAAC,6BAA6B,CAAC;gBACrD,QAAQ,CAAC,aAAa,CAAC,6BAA6B,CAAC,CAAC;YACxD,MAAM,WAAW,GAAG,OAAO,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;YACpG,MAAM,QAAQ,GACZ,QAAQ,CAAC,IAAI,IAAI,OAAO,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;YACpG,MAAM,KAAK,GAAG,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACzE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QAClE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/runtime/chrome/focus.d.ts

@@ -0,0 +1,2 @@
+export declare function focusControlledChromePage(devtoolsUrl: string, targetUrl: string): Promise<boolean>;
+//# sourceMappingURL=focus.d.ts.map

package/dist/src/runtime/chrome/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../../../src/runtime/chrome/focus.ts"],"names":[],"mappings":"AAGA,wBAAsB,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmCxG"}

package/dist/src/runtime/chrome/focus.js

@@ -0,0 +1,41 @@
+import { logDebugError } from '../../util/errors.js';
+import { connectPuppeteerBrowser, resolvePuppeteerPage } from './puppeteer.js';
+export async function focusControlledChromePage(devtoolsUrl, targetUrl) {
+    let puppeteer;
+    try {
+        ({ default: puppeteer } = await import('puppeteer'));
+    }
+    catch (error) {
+        logDebugError('Unable to load Puppeteer while attempting to focus controlled Chrome', error);
+        return false;
+    }
+    const browser = await connectPuppeteerBrowser(puppeteer, devtoolsUrl, 3);
+    if (!browser) {
+        return false;
+    }
+    try {
+        let page = await resolvePuppeteerPage(browser, targetUrl);
+        if (!page) {
+            const pages = await browser.pages();
+            page = pages.at(0) ?? null;
+        }
+        if (!page) {
+            return false;
+        }
+        await page.bringToFront();
+        return true;
+    }
+    catch (error) {
+        logDebugError('Failed to focus controlled Chrome page', error);
+        return false;
+    }
+    finally {
+        try {
+            await browser.disconnect();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+//# sourceMappingURL=focus.js.map

package/dist/src/runtime/chrome/focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.js","sourceRoot":"","sources":["../../../../src/runtime/chrome/focus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAE/E,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAmB,EAAE,SAAiB;IACpF,IAAI,SAA6C,CAAC;IAClD,IAAI,CAAC;QACH,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,sEAAsE,EAAE,KAAK,CAAC,CAAC;QAC7F,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,MAAM,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACpC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC7B,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,aAAa,CAAC,wCAAwC,EAAE,KAAK,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/runtime/chrome/launch.d.ts

@@ -0,0 +1,23 @@
+export declare function launchChrome(target: string, options?: {
+    foreground?: boolean;
+}): Promise<void>;
+export declare function launchControlledChrome(target: string, options: {
+    port?: number;
+    cookieSync: boolean;
+    headless?: boolean;
+    foreground?: boolean;
+}): Promise<{
+    port: number;
+    userDataDir: string;
+    devtoolsUrl: string;
+}>;
+export declare function prepareChromeLaunch(platform: NodeJS.Platform, chromePath: string, chromeArgs: string[], options?: {
+    background?: boolean;
+}): {
+    command: string;
+    args: string[];
+};
+export declare function spawnChromeDetached(chromePath: string, chromeArgs: string[], options?: {
+    background?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/src/runtime/chrome/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../../../src/runtime/chrome/launch.ts"],"names":[],"mappings":"AAWA,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUxG;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACxF,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAoDrE;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO;;;EAYvC;AAED,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/dist/src/runtime/chrome/launch.js

@@ -0,0 +1,102 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { cliEnv } from '../../env.js';
+import { saveDevToolsConfig } from '../devtools.js';
+import { primeControlledChromeCookies } from './cookies.js';
+import { findAvailablePort } from './reuse.js';
+const DEFAULT_MAC_CHROME = '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome';
+export async function launchChrome(target, options = {}) {
+    const chromePath = cliEnv.chromePath ?? DEFAULT_MAC_CHROME;
+    if (!existsSync(chromePath)) {
+        throw new Error(`Google Chrome is required but was not found at "${chromePath}". Set SWEETLINK_CHROME_PATH to override the location.`);
+    }
+    const background = process.platform === 'darwin' && options.foreground !== true;
+    await spawnChromeDetached(chromePath, ['--new-tab', target], { background });
+}
+export async function launchControlledChrome(target, options) {
+    const chromePath = cliEnv.chromePath ?? DEFAULT_MAC_CHROME;
+    if (!existsSync(chromePath)) {
+        throw new Error(`Google Chrome is required but was not found at "${chromePath}". Set SWEETLINK_CHROME_PATH to override the location.`);
+    }
+    const port = options.port && !Number.isNaN(options.port) ? options.port : await findAvailablePort();
+    const userDataDirectory = path.join(os.tmpdir(), `sweetlink-chrome-${port}-${Date.now()}`);
+    mkdirSync(userDataDirectory, { recursive: true });
+    const args = [
+        `--remote-debugging-port=${port}`,
+        `--user-data-dir=${userDataDirectory}`,
+        '--no-first-run',
+        '--no-default-browser-check',
+        '--disable-background-networking',
+        '--disable-renderer-backgrounding',
+        '--allow-insecure-localhost',
+        '--new-window',
+        target,
+    ];
+    if (options.headless) {
+        args.push('--headless=new', '--disable-gpu', '--hide-scrollbars');
+    }
+    const background = process.platform === 'darwin' && options.foreground !== true;
+    await spawnChromeDetached(chromePath, args, { background });
+    const devtoolsUrl = `http://127.0.0.1:${port}`;
+    await saveDevToolsConfig({
+        devtoolsUrl,
+        port,
+        userDataDir: userDataDirectory,
+        updatedAt: Date.now(),
+        targetUrl: target,
+    }).catch((error) => {
+        console.warn('Failed to persist DevTools config:', error);
+    });
+    if (options.cookieSync) {
+        await primeControlledChromeCookies({
+            devtoolsUrl,
+            targetUrl: target,
+            reload: true,
+            context: 'new-window',
+        });
+    }
+    return { port, userDataDir: userDataDirectory, devtoolsUrl };
+}
+export function prepareChromeLaunch(platform, chromePath, chromeArgs, options = {}) {
+    const background = Boolean(options.background);
+    if (platform === 'darwin' && background) {
+        const appTarget = deriveMacChromeApplication(chromePath) ?? 'Google Chrome';
+        const args = ['-g', '-n', '-a', appTarget];
+        if (chromeArgs.length > 0) {
+            args.push('--args', ...chromeArgs);
+        }
+        return { command: 'open', args };
+    }
+    return { command: chromePath, args: chromeArgs };
+}
+export async function spawnChromeDetached(chromePath, chromeArgs, options = {}) {
+    const spec = prepareChromeLaunch(process.platform, chromePath, chromeArgs, options);
+    await new Promise((resolve, reject) => {
+        const child = spawn(spec.command, spec.args, {
+            detached: true,
+            stdio: 'ignore',
+        });
+        child.once('error', (error) => reject(error));
+        child.once('spawn', () => {
+            child.unref();
+            resolve();
+        });
+    });
+}
+function deriveMacChromeApplication(chromePath) {
+    let candidate = chromePath;
+    for (let depth = 0; depth < 4; depth += 1) {
+        if (candidate.endsWith('.app')) {
+            return candidate;
+        }
+        const parent = path.dirname(candidate);
+        if (parent === candidate) {
+            break;
+        }
+        candidate = parent;
+    }
+    return null;
+}
+//# sourceMappingURL=launch.js.map

package/dist/src/runtime/chrome/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../../../src/runtime/chrome/launch.ts"],"names":[],"mappings":"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"}

package/dist/src/runtime/chrome/puppeteer.d.ts

@@ -0,0 +1,7 @@
+import type { Browser as PuppeteerBrowser, Page as PuppeteerPage } from 'puppeteer';
+export declare function connectPuppeteerBrowser(puppeteer: typeof import('puppeteer').default, browserURL: string, attempts: number): Promise<PuppeteerBrowser | null>;
+export declare function resolvePuppeteerPage(browser: PuppeteerBrowser, targetUrl: string): Promise<PuppeteerPage | null>;
+export declare function navigatePuppeteerPage(page: PuppeteerPage, targetUrl: string, attempts?: number): Promise<boolean>;
+export declare function waitForPageReady(page: PuppeteerPage): Promise<void>;
+export declare function attemptPuppeteerReload(page: PuppeteerPage): Promise<void>;
+//# sourceMappingURL=puppeteer.d.ts.map

package/dist/src/runtime/chrome/puppeteer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"puppeteer.d.ts","sourceRoot":"","sources":["../../../../src/runtime/chrome/puppeteer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,gBAAgB,EAAE,IAAI,IAAI,aAAa,EAAE,MAAM,WAAW,CAAC;AAWpF,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,cAAc,WAAW,EAAE,OAAO,EAC7C,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAoBlC;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmB/B;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,SAAI,GACX,OAAO,CAAC,OAAO,CAAC,CAclB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzE;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/E"}