@clipboard-health/playwright-toolkit 1.0.0

package/src/lib/cognitoDiagnostics.js

@@ -0,0 +1,331 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fillOtpAndWaitForCognitoRedirect = fillOtpAndWaitForCognitoRedirect;
+exports.isCognitoOtpChallengeRequest = isCognitoOtpChallengeRequest;
+exports.summarizeCognitoAuthRequest = summarizeCognitoAuthRequest;
+exports.sanitizeCognitoDiagnosticText = sanitizeCognitoDiagnosticText;
+// cspell:ignore requestfailed
+const util_ts_1 = require("@clipboard-health/util-ts");
+const COGNITO_HOST_PATTERN = /^cognito-idp\.[^.]+\.amazonaws\.com$/;
+const RESPOND_TO_AUTH_CHALLENGE_TARGET = "AWSCognitoIdentityProviderService.RespondToAuthChallenge";
+const OTP_CHALLENGE_NAMES = new Set(["EMAIL_OTP", "SMS_OTP"]);
+const DEFAULT_REDIRECT_TIMEOUT_MS = 30_000;
+const DIAGNOSTIC_SAMPLE_MAX_LENGTH = 700;
+const SCREENSHOT_ATTACHMENT_NAME = "cognito-otp-diagnostics";
+/**
+ * Fills an OTP and waits for the login redirect. On failure it reports the
+ * observed Cognito challenge, sanitized response/page text, current URL, and
+ * an optional redacted screenshot attachment.
+ */
+async function fillOtpAndWaitForCognitoRedirect(params) {
+    const timeoutMs = params.expectedUrlTimeoutMs ?? DEFAULT_REDIRECT_TIMEOUT_MS;
+    const monitor = createCognitoChallengeMonitor({
+        page: params.page,
+        timeoutMs,
+    });
+    try {
+        await params.page
+            .getByLabel(params.inputLabel ?? "Verification Code", { exact: true })
+            .fill(params.otp);
+    }
+    catch (error) {
+        monitor.dispose();
+        throw error;
+    }
+    try {
+        await params.page.waitForURL(params.expectedUrl, { timeout: timeoutMs });
+        monitor.dispose();
+        return { redirectUrl: params.page.url() };
+    }
+    catch (error) {
+        const diagnostics = await getFailureDiagnostics({
+            attemptPromise: monitor.result,
+            page: params.page,
+            testInfo: params.testInfo,
+        });
+        const finalErrorMessage = sanitizeCognitoDiagnosticText({
+            text: (0, util_ts_1.toErrorMessage)(error),
+        });
+        // oxlint-disable-next-line preserve-caught-error -- Raw Playwright errors may contain OTPs or account PII.
+        throw new Error(`Post-OTP redirect did not reach ${formatExpectedUrl(params.expectedUrl)} ` +
+            `within ${timeoutMs}ms. ${diagnostics} Last error: ${finalErrorMessage}`, { cause: new Error(finalErrorMessage) });
+    }
+}
+function isCognitoOtpChallengeRequest(params) {
+    const { request } = params;
+    if (request.method() !== "POST" || !isCognitoIdpUrl({ rawUrl: request.url() })) {
+        return false;
+    }
+    if (request.headers()["x-amz-target"] !== RESPOND_TO_AUTH_CHALLENGE_TARGET) {
+        return false;
+    }
+    const challengeName = getStringProperty({
+        value: getRequestPostDataJson({ request }),
+        propertyName: "ChallengeName",
+    });
+    return challengeName !== undefined && OTP_CHALLENGE_NAMES.has(challengeName);
+}
+function summarizeCognitoAuthRequest(params) {
+    const target = params.request.headers()["x-amz-target"] ?? "unknown";
+    const targetParts = target.split(".");
+    const postData = getRequestPostDataJson({ request: params.request });
+    return {
+        action: targetParts.at(-1) ?? target,
+        challengeName: getStringProperty({ value: postData, propertyName: "ChallengeName" }) ?? "unknown",
+        method: params.request.method(),
+        target,
+        url: sanitizeUrl({ rawUrl: params.request.url() }),
+    };
+}
+function sanitizeCognitoDiagnosticText(params) {
+    return params.text
+        .replaceAll(/Bearer\s+[A-Za-z0-9._-]+/gi, "Bearer [redacted-token]")
+        .replaceAll(/eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g, "[redacted-jwt]")
+        .replaceAll(/("(?:[^"]*(?:authorization|challengeResponse|code|email|password|phone|session|token)[^"]*)"\s*:\s*)"[^"]*"/gi, '$1"[redacted]"')
+        .replaceAll(/\b(?:authorization|challengeResponse|code|email|password|phone|session|token)=\S+/gi, (match) => match.replace(/[=].*/, "=[redacted]"))
+        .replaceAll(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi, "[redacted-email]")
+        .replaceAll(/\+?\d[\d\s().-]{5,}\d/g, "[redacted-number]")
+        .replaceAll(/\b\d{4,}\b/g, "[redacted-number]");
+}
+function createCognitoChallengeMonitor(params) {
+    let complete;
+    const result = new Promise((resolve) => {
+        let isComplete = false;
+        const timeout = setTimeout(() => {
+            completeAttempt({ timeoutMs: params.timeoutMs, type: "not-observed" });
+        }, params.timeoutMs);
+        function completeAttempt(attempt) {
+            if (isComplete) {
+                return;
+            }
+            isComplete = true;
+            clearTimeout(timeout);
+            params.page.off("response", handleResponse);
+            params.page.off("requestfailed", handleRequestFailure);
+            resolve(attempt);
+        }
+        complete = completeAttempt;
+        async function handleResponse(response) {
+            if (!isCognitoOtpChallengeRequest({ request: response.request() })) {
+                return;
+            }
+            try {
+                completeAttempt(await buildResponseAttempt({ response }));
+            }
+            catch (error) {
+                completeAttempt({
+                    request: summarizeCognitoAuthRequest({ request: response.request() }),
+                    responseBodySample: `unavailable: ${sanitizeCognitoDiagnosticText({
+                        text: (0, util_ts_1.toErrorMessage)(error),
+                    })}`,
+                    status: response.status(),
+                    statusText: response.statusText(),
+                    type: "response",
+                });
+            }
+        }
+        function handleRequestFailure(request) {
+            if (!isCognitoOtpChallengeRequest({ request })) {
+                return;
+            }
+            completeAttempt({
+                failureText: sanitizeCognitoDiagnosticText({
+                    text: request.failure()?.errorText ?? "unknown request failure",
+                }),
+                request: summarizeCognitoAuthRequest({ request }),
+                type: "request-failure",
+            });
+        }
+        params.page.on("response", handleResponse);
+        params.page.on("requestfailed", handleRequestFailure);
+    });
+    return {
+        result,
+        dispose() {
+            complete?.({ timeoutMs: params.timeoutMs, type: "not-observed" });
+        },
+    };
+}
+async function buildResponseAttempt(params) {
+    return {
+        request: summarizeCognitoAuthRequest({
+            request: params.response.request(),
+        }),
+        responseBodySample: await getResponseBodySample({
+            response: params.response,
+        }),
+        status: params.response.status(),
+        statusText: params.response.statusText(),
+        type: "response",
+    };
+}
+async function getFailureDiagnostics(params) {
+    const [attempt, pageTextSample, screenshotStatus] = await Promise.all([
+        params.attemptPromise,
+        getVisiblePageTextSample({ page: params.page }),
+        attachSanitizedScreenshot({ page: params.page, testInfo: params.testInfo }),
+    ]);
+    return [
+        `Cognito OTP challenge: ${formatAttempt(attempt)}.`,
+        `Current URL: ${sanitizeUrl({ rawUrl: params.page.url() })}.`,
+        `Visible page text sample: "${pageTextSample}".`,
+        `Screenshot: ${screenshotStatus}.`,
+    ].join(" ");
+}
+function formatAttempt(attempt) {
+    if (attempt.type === "not-observed") {
+        return `not observed within ${attempt.timeoutMs}ms`;
+    }
+    const request = [
+        `method=${attempt.request.method}`,
+        `url=${attempt.request.url}`,
+        `target=${attempt.request.target}`,
+        `action=${attempt.request.action}`,
+        `challengeName=${attempt.request.challengeName}`,
+    ].join("; ");
+    if (attempt.type === "request-failure") {
+        return `${request}; failureText="${attempt.failureText}"`;
+    }
+    const status = attempt.statusText.length === 0
+        ? `${attempt.status}`
+        : `${attempt.status} ${attempt.statusText}`;
+    return `${request}; status=${status}; responseBodySample="${attempt.responseBodySample}"`;
+}
+async function getResponseBodySample(params) {
+    if (params.response.status() >= 200 && params.response.status() < 400) {
+        return "omitted because successful Cognito responses can include tokens";
+    }
+    try {
+        return truncateDiagnosticText({
+            text: sanitizeCognitoDiagnosticText({
+                text: await params.response.text(),
+            }),
+        });
+    }
+    catch (error) {
+        return `unavailable: ${sanitizeCognitoDiagnosticText({ text: (0, util_ts_1.toErrorMessage)(error) })}`;
+    }
+}
+async function getVisiblePageTextSample(params) {
+    try {
+        const bodyText = (await params.page.locator("body").textContent({ timeout: 1000 })) ?? "";
+        return truncateDiagnosticText({
+            text: sanitizeCognitoDiagnosticText({ text: bodyText }),
+        });
+    }
+    catch (error) {
+        return `unavailable: ${sanitizeCognitoDiagnosticText({ text: (0, util_ts_1.toErrorMessage)(error) })}`;
+    }
+}
+async function attachSanitizedScreenshot(params) {
+    if (params.testInfo === undefined) {
+        return "not attached; testInfo unavailable";
+    }
+    try {
+        await redactPageForScreenshot({ page: params.page });
+        const screenshot = await params.page.screenshot({ fullPage: true });
+        await params.testInfo.attach(SCREENSHOT_ATTACHMENT_NAME, {
+            body: screenshot,
+            contentType: "image/png",
+        });
+        return `attached as ${SCREENSHOT_ATTACHMENT_NAME}`;
+    }
+    catch (error) {
+        return `unavailable: ${sanitizeCognitoDiagnosticText({ text: (0, util_ts_1.toErrorMessage)(error) })}`;
+    }
+}
+async function redactPageForScreenshot(params) {
+    await params.page.evaluate(() => {
+        // eslint-disable-next-line unicorn/consistent-function-scoping -- Serialized into the browser context.
+        function redact(value) {
+            return value
+                .replaceAll(/Bearer\s+[A-Za-z0-9._-]+/gi, "Bearer [redacted-token]")
+                .replaceAll(/eyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+/g, "[redacted-jwt]")
+                .replaceAll(/[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}/gi, "[redacted-email]")
+                .replaceAll(/\+?\d[\d\s().-]{5,}\d/g, "[redacted-number]")
+                .replaceAll(/\b\d{4,}\b/g, "[redacted-number]");
+        }
+        if (document.body === null) {
+            return;
+        }
+        const treeWalker = document.createTreeWalker(document.body, NodeFilter.SHOW_TEXT);
+        let currentNode = treeWalker.nextNode();
+        while (currentNode !== null) {
+            const originalText = currentNode.textContent ?? "";
+            const redactedText = redact(originalText);
+            if (redactedText !== originalText) {
+                currentNode.textContent = redactedText;
+            }
+            currentNode = treeWalker.nextNode();
+        }
+        const fields = document.querySelectorAll("input, textarea");
+        for (const field of fields) {
+            const redactedValue = redact(field.value);
+            if (redactedValue !== field.value) {
+                field.value = redactedValue;
+            }
+            const valueAttribute = field.getAttribute("value");
+            if (valueAttribute !== null) {
+                const redactedValueAttribute = redact(valueAttribute);
+                if (redactedValueAttribute !== valueAttribute) {
+                    field.setAttribute("value", redactedValueAttribute);
+                }
+            }
+        }
+    });
+}
+function getRequestPostDataJson(params) {
+    try {
+        return params.request.postDataJSON();
+    }
+    catch {
+        return undefined;
+    }
+}
+function getStringProperty(params) {
+    if (!(0, util_ts_1.isRecord)(params.value)) {
+        return undefined;
+    }
+    const propertyValue = params.value[params.propertyName];
+    return typeof propertyValue === "string" ? propertyValue : undefined;
+}
+function isCognitoIdpUrl(params) {
+    try {
+        return COGNITO_HOST_PATTERN.test(new URL(params.rawUrl).hostname);
+    }
+    catch {
+        return false;
+    }
+}
+function sanitizeUrl(params) {
+    try {
+        const url = new URL(params.rawUrl);
+        return [
+            url.origin,
+            url.pathname === "/" ? "/" : "/[redacted-path]",
+            url.search.length === 0 ? "" : "?[redacted-query]",
+            url.hash.length === 0 ? "" : "#[redacted-hash]",
+        ].join("");
+    }
+    catch {
+        return truncateDiagnosticText({
+            text: sanitizeCognitoDiagnosticText({ text: params.rawUrl }),
+        });
+    }
+}
+function formatExpectedUrl(expectedUrl) {
+    if (typeof expectedUrl === "string") {
+        return sanitizeUrl({ rawUrl: expectedUrl });
+    }
+    if (expectedUrl instanceof RegExp) {
+        return sanitizeCognitoDiagnosticText({ text: expectedUrl.toString() });
+    }
+    return "[URL predicate]";
+}
+function truncateDiagnosticText(params) {
+    const normalizedText = params.text.replaceAll(/\s+/g, " ").trim();
+    return normalizedText.length <= DIAGNOSTIC_SAMPLE_MAX_LENGTH
+        ? normalizedText
+        : `${normalizedText.slice(0, DIAGNOSTIC_SAMPLE_MAX_LENGTH)}...`;
+}
+//# sourceMappingURL=cognitoDiagnostics.js.map

package/src/lib/cognitoDiagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cognitoDiagnostics.js","sourceRoot":"","sources":["../../../../../packages/playwright-toolkit/src/lib/cognitoDiagnostics.ts"],"names":[],"mappings":"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"}

package/src/lib/deployedAssets.d.ts

@@ -0,0 +1,77 @@
+export type DeployedAssetRequestMethod = "GET" | "HEAD";
+export type DeployedAssetCacheMode = "cache-busted" | "normal";
+export interface DeployedAssetValidationResult {
+    isValid: boolean;
+    message?: string | undefined;
+    isTransient?: boolean | undefined;
+}
+export interface DeployedAssetCheck {
+    path: string;
+    url: string;
+    method?: DeployedAssetRequestMethod | undefined;
+    cacheMode?: DeployedAssetCacheMode | undefined;
+    expectedContentTypes?: readonly string[] | undefined;
+    headers?: Record<string, string> | undefined;
+    validateResponse?: ((params: {
+        response: Response;
+    }) => Promise<DeployedAssetValidationResult> | DeployedAssetValidationResult) | undefined;
+}
+export interface DeployedAssetAttempt {
+    attemptNumber: number;
+    contentType?: string | undefined;
+    durationMs: number;
+    errorMessage?: string | undefined;
+    status?: number | undefined;
+    url: string;
+}
+export type DeployedAssetReportCheck = Omit<DeployedAssetCheck, "headers" | "validateResponse">;
+export interface DeployedAssetResult {
+    attempts: DeployedAssetAttempt[];
+    check: DeployedAssetReportCheck;
+    contentType?: string | undefined;
+    errorMessage?: string | undefined;
+    isSuccess: boolean;
+    status?: number | undefined;
+}
+export interface DeployedAssetVerificationReport {
+    results: DeployedAssetResult[];
+    summary: {
+        failureCount: number;
+        passedCount: number;
+        totalCount: number;
+    };
+    wait?: {
+        attempts: number;
+        isStableWindowSatisfied: boolean;
+        stableWindowElapsedMs: number;
+    } | undefined;
+}
+export interface VerifyDeployedAssetsParams {
+    checks: readonly DeployedAssetCheck[];
+    concurrencyLimit?: number | undefined;
+    fetchImplementation?: typeof fetch | undefined;
+    fetchTimeoutMs?: number | undefined;
+    nowImplementation?: (() => number) | undefined;
+    retry?: {
+        maxAttempts?: number | undefined;
+        delayMs?: number | undefined;
+    } | undefined;
+    sleepImplementation?: ((params: {
+        durationMs: number;
+    }) => Promise<void>) | undefined;
+}
+export interface WaitForDeployedAssetsParams extends VerifyDeployedAssetsParams {
+    timeoutMs: number;
+    pollIntervalMs?: number | undefined;
+    stableWindowMs?: number | undefined;
+}
+/**
+ * Checks a repo-supplied deployed asset graph with bounded concurrency and
+ * classified per-asset retries. Discovery and asset classification remain in
+ * thin repo wrappers.
+ */
+export declare function verifyDeployedAssets(params: VerifyDeployedAssetsParams): Promise<DeployedAssetVerificationReport>;
+/**
+ * Polls the whole graph until it is healthy for an optional stable window.
+ */
+export declare function waitForDeployedAssets(params: WaitForDeployedAssetsParams): Promise<DeployedAssetVerificationReport>;