@untestutils/utils 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 s00d
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/browser.d.ts

@@ -0,0 +1,40 @@
+import type { Page, Response } from 'playwright-core';
+/**
+ * Proxy browser requests from `emulatedOrigin` to `realBaseURL`, forwarding
+ * `X-Forwarded-Host` / `X-Forwarded-Proto` so SSR sees the public domain.
+ */
+export declare function emulateDomain(page: Page, emulatedOrigin: string, realBaseURL: string): Promise<void>;
+export type TrackedResponse = {
+    url: string;
+    status: number;
+    response: Response;
+};
+/** Collect HTTP responses for redirect assertions. Returns live array + disposer. */
+export declare function trackResponses(page: Page): {
+    responses: TrackedResponse[];
+    stop: () => void;
+    findByPath: (pathname: string) => TrackedResponse | undefined;
+};
+export type ConsoleMatch = {
+    type: string;
+    text: string;
+};
+/**
+ * Collect console messages matching a predicate (hydration warnings, etc.).
+ * Call `stop()` when done; `messages` stays filled.
+ */
+export declare function collectConsole(page: Page, predicate?: (msg: {
+    type: () => string;
+    text: () => string;
+}) => boolean): {
+    messages: ConsoleMatch[];
+    stop: () => void;
+};
+/** Collect hydration / mismatch console errors & warnings. */
+export declare function collectHydrationIssues(page: Page): {
+    messages: ConsoleMatch[];
+    stop: () => void;
+};
+/** Apply `Accept-Language` for subsequent navigations on this page. */
+export declare function setAcceptLanguage(page: Page, value: string): Promise<void>;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAA;CAAE,CAAC;AAElF,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG;IAC1C,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,eAAe,GAAG,SAAS,CAAC;CAC/D,CAkBA;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,IAAI,EACV,SAAS,GAAE,CAAC,GAAG,EAAE;IAAE,IAAI,EAAE,MAAM,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,MAAM,CAAA;CAAE,KAAK,OAAoB,GACnF;IAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CAUhD;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,IAAI;cAblC,YAAY,EAAE;UAAQ,MAAM,IAAI;EAmB9C;AAED,uEAAuE;AACvE,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF"}

package/dist/browser.mjs

@@ -0,0 +1,71 @@
+import { forwardedHostHeaders } from "./headers.mjs";
+
+export async function emulateDomain(page, emulatedOrigin, realBaseURL) {
+	const realBase = realBaseURL.replace(/\/$/, "");
+	const { hostname: fwdHost } = new URL(emulatedOrigin);
+	await page.route(`${emulatedOrigin}/**`, async (route) => {
+		const url = new URL(route.request().url());
+		try {
+			const response = await route.fetch({
+				url: `${realBase}${url.pathname}${url.search}`,
+				headers: {
+					...route.request().headers(),
+					...forwardedHostHeaders(fwdHost, url.protocol.replace(":", ""))
+				}
+			});
+			await route.fulfill({ response });
+		} catch {
+			await route.abort();
+		}
+	});
+}
+
+export function trackResponses(page) {
+	const responses = [];
+	const onResponse = (response) => {
+		responses.push({
+			url: response.url(),
+			status: response.status(),
+			response
+		});
+	};
+	page.on("response", onResponse);
+	return {
+		responses,
+		stop: () => page.off("response", onResponse),
+		findByPath: (pathname) => responses.find((r) => {
+			try {
+				return new URL(r.url).pathname === pathname;
+			} catch {
+				return false;
+			}
+		})
+	};
+}
+
+export function collectConsole(page, predicate = () => true) {
+	const messages = [];
+	const onConsole = (msg) => {
+		if (predicate(msg)) messages.push({
+			type: msg.type(),
+			text: msg.text()
+		});
+	};
+	page.on("console", onConsole);
+	return {
+		messages,
+		stop: () => page.off("console", onConsole)
+	};
+}
+
+export function collectHydrationIssues(page) {
+	return collectConsole(page, (msg) => {
+		if (msg.type() !== "error" && msg.type() !== "warning") return false;
+		const text = msg.text().toLowerCase();
+		return text.includes("hydration") || text.includes("mismatch");
+	});
+}
+
+export async function setAcceptLanguage(page, value) {
+	await page.setExtraHTTPHeaders({ "Accept-Language": value });
+}

package/dist/cookies.d.mts

@@ -0,0 +1,16 @@
+import type { Page } from "playwright-core";
+export type CookiePage = Pick<Page, "context">;
+export type SetCookieOptions = {
+	/** Cookie name (default `user-locale`) */
+	name?: string;
+	/** Clear all cookies before setting */
+	clear?: boolean;
+};
+/**
+* Set a locale cookie on the browser context (common i18n e2e pattern).
+* `baseURL` must be an absolute origin (harness `baseURL` fixture).
+*/
+export declare function setLocaleCookie(page: CookiePage, baseURL: string, locale: string, options?: SetCookieOptions): Promise<void>;
+/** Read a named cookie value from the context (or `undefined`). */
+export declare function getLocaleCookie(page: CookiePage, name?: string): Promise<string | undefined>;
+export declare function clearCookies(page: CookiePage): Promise<void>;

package/dist/cookies.d.ts

@@ -0,0 +1,17 @@
+import type { Page } from 'playwright-core';
+export type CookiePage = Pick<Page, 'context'>;
+export type SetCookieOptions = {
+    /** Cookie name (default `user-locale`) */
+    name?: string;
+    /** Clear all cookies before setting */
+    clear?: boolean;
+};
+/**
+ * Set a locale cookie on the browser context (common i18n e2e pattern).
+ * `baseURL` must be an absolute origin (harness `baseURL` fixture).
+ */
+export declare function setLocaleCookie(page: CookiePage, baseURL: string, locale: string, options?: SetCookieOptions): Promise<void>;
+/** Read a named cookie value from the context (or `undefined`). */
+export declare function getLocaleCookie(page: CookiePage, name?: string): Promise<string | undefined>;
+export declare function clearCookies(page: CookiePage): Promise<void>;
+//# sourceMappingURL=cookies.d.ts.map

package/dist/cookies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookies.d.ts","sourceRoot":"","sources":["../src/cookies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,mEAAmE;AACnE,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE,MAAsB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAG7B;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAElE"}

package/dist/cookies.mjs

@@ -0,0 +1,20 @@
+
+export async function setLocaleCookie(page, baseURL, locale, options = {}) {
+	const name = options.name ?? "user-locale";
+	if (options.clear !== false) {
+		await page.context().clearCookies();
+	}
+	await page.context().addCookies([{
+		name,
+		value: locale,
+		url: baseURL
+	}]);
+}
+
+export async function getLocaleCookie(page, name = "user-locale") {
+	const cookies = await page.context().cookies();
+	return cookies.find((c) => c.name === name)?.value;
+}
+export async function clearCookies(page) {
+	await page.context().clearCookies();
+}

package/dist/headers.d.mts

@@ -0,0 +1,4 @@
+/** Build an `Accept-Language` header map for Playwright `request` / `setExtraHTTPHeaders`. */
+export declare function acceptLanguageHeaders(value: string): Record<string, string>;
+/** Headers for SSR that should resolve the public host (domain strategies / SEO). */
+export declare function forwardedHostHeaders(host: string, proto?: string): Record<string, string>;

package/dist/headers.d.ts

@@ -0,0 +1,5 @@
+/** Build an `Accept-Language` header map for Playwright `request` / `setExtraHTTPHeaders`. */
+export declare function acceptLanguageHeaders(value: string): Record<string, string>;
+/** Headers for SSR that should resolve the public host (domain strategies / SEO). */
+export declare function forwardedHostHeaders(host: string, proto?: string): Record<string, string>;
+//# sourceMappingURL=headers.d.ts.map

package/dist/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE3E;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKjG"}

package/dist/headers.mjs

@@ -0,0 +1,11 @@
+
+export function acceptLanguageHeaders(value) {
+	return { "Accept-Language": value };
+}
+
+export function forwardedHostHeaders(host, proto = "http") {
+	return {
+		"x-forwarded-host": host,
+		"x-forwarded-proto": proto.replace(/:$/, "")
+	};
+}

package/dist/http.d.mts

@@ -0,0 +1,12 @@
+import { type PollUntilOptions } from "./poll.mjs";
+export type WaitForUrlOptions = PollUntilOptions & {
+	/** Expected HTTP status (default: any 2xx) */
+	status?: number | ((status: number) => boolean);
+	init?: RequestInit;
+};
+/** Poll until `url` responds OK (or custom status). */
+export declare function waitForUrlOk(url: string, options?: WaitForUrlOptions): Promise<Response>;
+/** Poll until response body includes `needle`. */
+export declare function waitForUrlIncludes(url: string, needle: string, options?: PollUntilOptions & {
+	init?: RequestInit;
+}): Promise<string>;

package/dist/http.d.ts

@@ -0,0 +1,13 @@
+import { type PollUntilOptions } from './poll';
+export type WaitForUrlOptions = PollUntilOptions & {
+    /** Expected HTTP status (default: any 2xx) */
+    status?: number | ((status: number) => boolean);
+    init?: RequestInit;
+};
+/** Poll until `url` responds OK (or custom status). */
+export declare function waitForUrlOk(url: string, options?: WaitForUrlOptions): Promise<Response>;
+/** Poll until response body includes `needle`. */
+export declare function waitForUrlIncludes(url: string, needle: string, options?: PollUntilOptions & {
+    init?: RequestInit;
+}): Promise<string>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAE1D,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IACjD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,CAAC;AAEF,uDAAuD;AACvD,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,QAAQ,CAAC,CAoBnB;AAED,kDAAkD;AAClD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,WAAW,CAAA;CAAO,GACtD,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/http.mjs

@@ -0,0 +1,38 @@
+import { pollUntil } from "./poll.mjs";
+
+export async function waitForUrlOk(url, options = {}) {
+	let last;
+	await pollUntil(async () => {
+		try {
+			last = await fetch(url, options.init);
+			if (typeof options.status === "function") return options.status(last.status);
+			if (typeof options.status === "number") return last.status === options.status;
+			return last.ok;
+		} catch {
+			return false;
+		}
+	}, {
+		intervalMs: options.intervalMs,
+		timeoutMs: options.timeoutMs,
+		message: options.message ?? `Timed out waiting for OK response from ${url}`
+	});
+	return last;
+}
+
+export async function waitForUrlIncludes(url, needle, options = {}) {
+	let body = "";
+	await pollUntil(async () => {
+		try {
+			const res = await fetch(url, options.init);
+			body = await res.text();
+			return body.includes(needle);
+		} catch {
+			return false;
+		}
+	}, {
+		intervalMs: options.intervalMs,
+		timeoutMs: options.timeoutMs,
+		message: options.message ?? `Timed out waiting for "${needle}" from ${url}`
+	});
+	return body;
+}

package/dist/index.d.mts

@@ -0,0 +1,10 @@
+/**
+* Shared e2e / integration utilities (the “utils” in untestutils).
+* Browser helpers need optional peer `playwright-core`.
+*/
+export { pollUntil, runSequential, type PollUntilOptions } from "./poll.mjs";
+export { acceptLanguageHeaders, forwardedHostHeaders } from "./headers.mjs";
+export { parseSeoHead, extractSitemapLocs, extractJsonLd, readSeoHead, type SeoHead, type SeoAlternate, type PageLike } from "./seo.mjs";
+export { setLocaleCookie, getLocaleCookie, clearCookies, type CookiePage, type SetCookieOptions } from "./cookies.mjs";
+export { emulateDomain, trackResponses, collectConsole, collectHydrationIssues, setAcceptLanguage, type TrackedResponse, type ConsoleMatch } from "./browser.mjs";
+export { waitForUrlOk, waitForUrlIncludes, type WaitForUrlOptions } from "./http.mjs";

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared e2e / integration utilities (the “utils” in untestutils).
+ * Browser helpers need optional peer `playwright-core`.
+ */
+export { pollUntil, runSequential, type PollUntilOptions } from './poll';
+export { acceptLanguageHeaders, forwardedHostHeaders } from './headers';
+export { parseSeoHead, extractSitemapLocs, extractJsonLd, readSeoHead, type SeoHead, type SeoAlternate, type PageLike, } from './seo';
+export { setLocaleCookie, getLocaleCookie, clearCookies, type CookiePage, type SetCookieOptions, } from './cookies';
+export { emulateDomain, trackResponses, collectConsole, collectHydrationIssues, setAcceptLanguage, type TrackedResponse, type ConsoleMatch, } from './browser';
+export { waitForUrlOk, waitForUrlIncludes, type WaitForUrlOptions } from './http';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,OAAO,CAAC;AACf,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,KAAK,UAAU,EACf,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,aAAa,EACb,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,QAAQ,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,7 @@
+
+export { pollUntil, runSequential } from "./poll.mjs";
+export { acceptLanguageHeaders, forwardedHostHeaders } from "./headers.mjs";
+export { parseSeoHead, extractSitemapLocs, extractJsonLd, readSeoHead } from "./seo.mjs";
+export { setLocaleCookie, getLocaleCookie, clearCookies } from "./cookies.mjs";
+export { emulateDomain, trackResponses, collectConsole, collectHydrationIssues, setAcceptLanguage } from "./browser.mjs";
+export { waitForUrlOk, waitForUrlIncludes } from "./http.mjs";

package/dist/poll.d.mts

@@ -0,0 +1,9 @@
+export type PollUntilOptions = {
+	intervalMs?: number;
+	timeoutMs?: number;
+	message?: string;
+};
+/** Poll until `check` returns true or the deadline is reached. */
+export declare function pollUntil(check: () => boolean | Promise<boolean>, options?: PollUntilOptions): Promise<void>;
+/** Run async callbacks one after another (shared Playwright page, etc.). */
+export declare function runSequential<T>(items: readonly T[], fn: (item: T, index: number) => Promise<void>): Promise<void>;

package/dist/poll.d.ts

@@ -0,0 +1,10 @@
+export type PollUntilOptions = {
+    intervalMs?: number;
+    timeoutMs?: number;
+    message?: string;
+};
+/** Poll until `check` returns true or the deadline is reached. */
+export declare function pollUntil(check: () => boolean | Promise<boolean>, options?: PollUntilOptions): Promise<void>;
+/** Run async callbacks one after another (shared Playwright page, etc.). */
+export declare function runSequential<T>(items: readonly T[], fn: (item: T, index: number) => Promise<void>): Promise<void>;
+//# sourceMappingURL=poll.d.ts.map

package/dist/poll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.d.ts","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,kEAAkE;AAClE,wBAAsB,SAAS,CAC7B,KAAK,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EACvC,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAWf;AAED,4EAA4E;AAC5E,wBAAsB,aAAa,CAAC,CAAC,EACnC,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/poll.mjs

@@ -0,0 +1,19 @@
+
+export async function pollUntil(check, options = {}) {
+	const intervalMs = options.intervalMs ?? 250;
+	const deadline = Date.now() + (options.timeoutMs ?? 2e4);
+	for (;;) {
+		if (await check()) return;
+		if (Date.now() >= deadline) {
+			throw new Error(options.message ?? "Timed out while polling");
+		}
+		await new Promise((r) => setTimeout(r, intervalMs));
+	}
+}
+
+export async function runSequential(items, fn) {
+	let i = 0;
+	for (const item of items) {
+		await fn(item, i++);
+	}
+}

package/dist/seo.d.mts

@@ -0,0 +1,27 @@
+export type SeoAlternate = {
+	hreflang: string;
+	href: string;
+};
+export type SeoHead = {
+	canonical: string | null;
+	ogUrl: string | null;
+	ogLocale: string | null;
+	hreflangs: SeoAlternate[];
+};
+/** Parse common SEO tags from an HTML document string (SSR `$fetch` / `request.get().text()`). */
+export declare function parseSeoHead(html: string): SeoHead;
+/** `<loc>` values from a sitemap XML body. */
+export declare function extractSitemapLocs(xml: string): string[];
+/** JSON-LD objects from `<script type="application/ld+json">` blocks. */
+export declare function extractJsonLd(html: string): unknown[];
+export type PageLike = {
+	locator: (selector: string) => {
+		getAttribute: (name: string) => Promise<string | null>;
+		count: () => Promise<number>;
+		nth: (i: number) => {
+			getAttribute: (name: string) => Promise<string | null>;
+		};
+	};
+};
+/** Read SEO tags from a live Playwright page (after goto). */
+export declare function readSeoHead(page: PageLike): Promise<SeoHead>;

package/dist/seo.d.ts

@@ -0,0 +1,28 @@
+export type SeoAlternate = {
+    hreflang: string;
+    href: string;
+};
+export type SeoHead = {
+    canonical: string | null;
+    ogUrl: string | null;
+    ogLocale: string | null;
+    hreflangs: SeoAlternate[];
+};
+/** Parse common SEO tags from an HTML document string (SSR `$fetch` / `request.get().text()`). */
+export declare function parseSeoHead(html: string): SeoHead;
+/** `<loc>` values from a sitemap XML body. */
+export declare function extractSitemapLocs(xml: string): string[];
+/** JSON-LD objects from `<script type="application/ld+json">` blocks. */
+export declare function extractJsonLd(html: string): unknown[];
+export type PageLike = {
+    locator: (selector: string) => {
+        getAttribute: (name: string) => Promise<string | null>;
+        count: () => Promise<number>;
+        nth: (i: number) => {
+            getAttribute: (name: string) => Promise<string | null>;
+        };
+    };
+};
+/** Read SEO tags from a live Playwright page (after goto). */
+export declare function readSeoHead(page: PageLike): Promise<SeoHead>;
+//# sourceMappingURL=seo.d.ts.map

package/dist/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9D,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B,CAAC;AAMF,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAyBlD;AAED,8CAA8C;AAC9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAYrD;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK;QAC7B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACvD,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7B,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK;YAAE,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;SAAE,CAAC;KAChF,CAAC;CACH,CAAC;AAEF,8DAA8D;AAC9D,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAgBlE"}

package/dist/seo.mjs

@@ -0,0 +1,70 @@
+function attr(tag, name) {
+	return tag.match(new RegExp(`${name}="([^"]*)"`, "i"))?.[1] ?? null;
+}
+
+export function parseSeoHead(html) {
+	const canonical = html.match(/<link[^>]*rel=["']canonical["'][^>]*>/i)?.[0] !== undefined ? attr(html.match(/<link[^>]*rel=["']canonical["'][^>]*>/i)[0], "href") : null;
+	let ogUrl = null;
+	let ogLocale = null;
+	for (const m of html.matchAll(/<meta\b[^>]*>/gi)) {
+		const tag = m[0];
+		const prop = attr(tag, "property") ?? attr(tag, "name");
+		if (prop === "og:url") ogUrl = attr(tag, "content");
+		if (prop === "og:locale") ogLocale = attr(tag, "content");
+	}
+	const hreflangs = [];
+	for (const m of html.matchAll(/<link\b[^>]*>/gi)) {
+		const tag = m[0];
+		if (!/\brel=["']alternate["']/i.test(tag)) continue;
+		const hreflang = attr(tag, "hreflang");
+		const href = attr(tag, "href");
+		if (hreflang && href) hreflangs.push({
+			hreflang,
+			href
+		});
+	}
+	return {
+		canonical,
+		ogUrl,
+		ogLocale,
+		hreflangs
+	};
+}
+
+export function extractSitemapLocs(xml) {
+	return [...xml.matchAll(/<loc>([^<]+)<\/loc>/g)].map((m) => m[1]);
+}
+
+export function extractJsonLd(html) {
+	const out = [];
+	for (const m of html.matchAll(/<script[^>]*type=["']application\/ld\+json["'][^>]*>([\s\S]*?)<\/script>/gi)) {
+		try {
+			out.push(JSON.parse(m[1]));
+		} catch {}
+	}
+	return out;
+}
+
+export async function readSeoHead(page) {
+	const canonical = await page.locator("link[rel=\"canonical\"]").getAttribute("href");
+	const ogUrl = await page.locator("meta[property=\"og:url\"]").getAttribute("content");
+	const ogLocale = await page.locator("meta[property=\"og:locale\"]").getAttribute("content");
+	const alt = page.locator("link[rel=\"alternate\"][hreflang]");
+	const n = await alt.count();
+	const hreflangs = [];
+	for (let i = 0; i < n; i++) {
+		const el = alt.nth(i);
+		const hreflang = await el.getAttribute("hreflang");
+		const href = await el.getAttribute("href");
+		if (hreflang && href) hreflangs.push({
+			hreflang,
+			href
+		});
+	}
+	return {
+		canonical,
+		ogUrl,
+		ogLocale,
+		hreflangs
+	};
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@untestutils/utils",
+  "version": "0.5.0",
+  "description": "Shared e2e/test utilities — cookies, SEO head, poll, browser helpers",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.1",
+    "playwright-core": "^1.63.0",
+    "publint": "^0.3.24",
+    "typescript": "^6.0.3",
+    "obuild": "^0.4.40"
+  },
+  "peerDependencies": {
+    "playwright-core": "^1.63.0"
+  },
+  "peerDependenciesMeta": {
+    "playwright-core": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "homepage": "https://s00d.github.io/untestutils/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/s00d/untestutils.git",
+    "directory": "packages/utils"
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "build": "obuild && tsc -p tsconfig.build.json",
+    "publint": "publint --strict"
+  }
+}