@vforsh/argus-core 0.1.4 → 0.1.6

package/dist/auth/state.js

@@ -0,0 +1,189 @@
+import { AUTH_STATE_METADATA_SCHEMA_VERSION, } from '../protocol/http/auth.js';
+/**
+ * Parse an unknown JSON payload into a validated auth-state snapshot.
+ * Throws with a descriptive error when the payload shape is not usable.
+ */
+export const parseAuthStateSnapshot = (value, source = 'auth state snapshot') => {
+    const snapshot = expectRecord(value, source);
+    if (snapshot.ok !== true) {
+        throw new Error(`Invalid ${source}: "ok" must be true`);
+    }
+    return {
+        ok: true,
+        url: expectString(snapshot.url, `${source}.url`),
+        origin: expectString(snapshot.origin, `${source}.origin`),
+        cookies: expectArray(snapshot.cookies, `${source}.cookies`).map((cookie, index) => parseAuthStateCookie(cookie, `${source}.cookies[${index}]`)),
+        origins: expectArray(snapshot.origins, `${source}.origins`).map((originState, index) => parseAuthStateOrigin(originState, `${source}.origins[${index}]`)),
+        metadata: parseAuthStateMetadata(snapshot.metadata, `${source}.metadata`),
+    };
+};
+/**
+ * Replay an auth-state snapshot into a single browser tab.
+ * Storage is restored after navigating to each origin so sessionStorage stays bound to that tab.
+ */
+export const hydrateAuthState = async (input) => {
+    const startupUrl = resolveAuthStateStartupUrl(input.startupUrl ?? null, input.snapshot);
+    if (input.snapshot.cookies.length > 0) {
+        await input.driver.setCookies(input.snapshot.cookies);
+    }
+    for (const originState of input.snapshot.origins) {
+        if (!hasAuthStateStorage(originState)) {
+            continue;
+        }
+        await input.driver.navigateAndWait(createAuthStateOriginUrl(originState.origin));
+        await input.driver.seedStorage(originState);
+    }
+    if (startupUrl) {
+        await input.driver.navigateAndWait(startupUrl);
+    }
+    return { ok: true, startupUrl };
+};
+/** Resolve the final URL opened after auth-state hydration. */
+export const resolveAuthStateStartupUrl = (startupUrl, snapshot) => {
+    if (startupUrl?.trim()) {
+        return startupUrl.trim();
+    }
+    if (snapshot.url.trim()) {
+        return snapshot.url.trim();
+    }
+    if (snapshot.origin.trim()) {
+        return createAuthStateOriginUrl(snapshot.origin);
+    }
+    return null;
+};
+/** Convert an origin string into a navigable URL with a trailing slash. */
+export const createAuthStateOriginUrl = (origin) => `${origin.replace(/\/$/, '')}/`;
+/** Build the storage-restore script shared by watcher and Chrome-start hydration paths. */
+export const buildAuthStateStorageSeedExpression = (originState) => `(() => {
+	const payload = ${JSON.stringify(originState)}
+	const applyEntries = (storage, entries) => {
+		for (const entry of entries) {
+			storage.setItem(entry.name, entry.value)
+		}
+	}
+
+	applyEntries(localStorage, payload.localStorage)
+	applyEntries(sessionStorage, payload.sessionStorage)
+	return true
+})()`;
+const hasAuthStateStorage = (originState) => originState.localStorage.length > 0 || originState.sessionStorage.length > 0;
+const parseAuthStateCookie = (value, source) => {
+    const cookie = expectRecord(value, source);
+    return {
+        name: expectString(cookie.name, `${source}.name`),
+        value: expectString(cookie.value, `${source}.value`),
+        domain: expectString(cookie.domain, `${source}.domain`),
+        path: expectString(cookie.path, `${source}.path`),
+        secure: expectBoolean(cookie.secure, `${source}.secure`),
+        httpOnly: expectBoolean(cookie.httpOnly, `${source}.httpOnly`),
+        session: expectBoolean(cookie.session, `${source}.session`),
+        expires: expectNullableNumber(cookie.expires, `${source}.expires`),
+        sameSite: expectNullableString(cookie.sameSite, `${source}.sameSite`),
+    };
+};
+const parseAuthStateOrigin = (value, source) => {
+    const originState = expectRecord(value, source);
+    return {
+        origin: expectString(originState.origin, `${source}.origin`),
+        localStorage: expectArray(originState.localStorage, `${source}.localStorage`).map((entry, index) => parseStorageEntry(entry, `${source}.localStorage[${index}]`)),
+        sessionStorage: expectArray(originState.sessionStorage, `${source}.sessionStorage`).map((entry, index) => parseStorageEntry(entry, `${source}.sessionStorage[${index}]`)),
+    };
+};
+const parseAuthStateMetadata = (value, source) => {
+    const metadata = expectRecord(value, source);
+    const schemaVersionSource = `${source}.schemaVersion`;
+    const schemaVersion = expectNumber(metadata.schemaVersion, schemaVersionSource);
+    if (schemaVersion !== AUTH_STATE_METADATA_SCHEMA_VERSION) {
+        throw new Error(`Invalid ${schemaVersionSource}: expected ${AUTH_STATE_METADATA_SCHEMA_VERSION}, got ${schemaVersion}`);
+    }
+    const sourcePath = `${source}.source`;
+    const pagePath = `${source}.page`;
+    const capturePath = `${source}.capture`;
+    const authHintsPath = `${source}.authHints`;
+    const sourceMetadata = expectRecord(metadata.source, sourcePath);
+    const pageMetadata = expectRecord(metadata.page, pagePath);
+    const captureMetadata = expectRecord(metadata.capture, capturePath);
+    const authHints = expectRecord(metadata.authHints, authHintsPath);
+    return {
+        schemaVersion,
+        exportedAt: expectString(metadata.exportedAt, `${source}.exportedAt`),
+        source: {
+            watcherId: expectString(sourceMetadata.watcherId, `${sourcePath}.watcherId`),
+            watcherSource: expectNullableWatcherSource(sourceMetadata.watcherSource, `${sourcePath}.watcherSource`),
+        },
+        page: {
+            title: expectNullableString(pageMetadata.title, `${pagePath}.title`),
+            siteDomain: expectNullableString(pageMetadata.siteDomain, `${pagePath}.siteDomain`),
+        },
+        capture: {
+            cookieCount: expectNumber(captureMetadata.cookieCount, `${capturePath}.cookieCount`),
+        },
+        authHints: {
+            authCookieNames: parseStringArray(authHints.authCookieNames, `${authHintsPath}.authCookieNames`),
+        },
+        recommendedStartupUrl: expectNullableString(metadata.recommendedStartupUrl, `${source}.recommendedStartupUrl`),
+    };
+};
+const parseStorageEntry = (value, source) => {
+    const entry = expectRecord(value, source);
+    return {
+        name: expectString(entry.name, `${source}.name`),
+        value: expectString(entry.value, `${source}.value`),
+    };
+};
+const parseStringArray = (value, source) => expectArray(value, source).map((entry, index) => expectString(entry, `${source}[${index}]`));
+const expectRecord = (value, source) => {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Invalid ${source}: expected an object`);
+    }
+    return value;
+};
+const expectArray = (value, source) => {
+    if (!Array.isArray(value)) {
+        throw new Error(`Invalid ${source}: expected an array`);
+    }
+    return value;
+};
+const expectString = (value, source) => {
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid ${source}: expected a string`);
+    }
+    return value;
+};
+const expectBoolean = (value, source) => {
+    if (typeof value !== 'boolean') {
+        throw new Error(`Invalid ${source}: expected a boolean`);
+    }
+    return value;
+};
+const expectNumber = (value, source) => {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`Invalid ${source}: expected a finite number`);
+    }
+    return value;
+};
+const expectNullableString = (value, source) => {
+    if (value === null) {
+        return null;
+    }
+    return expectString(value, source);
+};
+const expectNullableNumber = (value, source) => {
+    if (value === null) {
+        return null;
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`Invalid ${source}: expected a finite number or null`);
+    }
+    return value;
+};
+const expectNullableWatcherSource = (value, source) => {
+    if (value === null) {
+        return null;
+    }
+    if (value === 'cdp' || value === 'extension') {
+        return value;
+    }
+    throw new Error(`Invalid ${source}: expected "cdp", "extension", or null`);
+};
+//# sourceMappingURL=state.js.map

package/dist/auth/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/auth/state.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,kCAAkC,GAMlC,MAAM,0BAA0B,CAAA;AAYjC;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAE,MAAM,GAAG,qBAAqB,EAAqB,EAAE;IAC3G,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAE5C,IAAI,QAAQ,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,qBAAqB,CAAC,CAAA;IACxD,CAAC;IAED,OAAO;QACN,EAAE,EAAE,IAAI;QACR,GAAG,EAAE,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC;QAChD,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC;QACzD,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CACjF,oBAAoB,CAAC,MAAM,EAAE,GAAG,MAAM,YAAY,KAAK,GAAG,CAAC,CAC3D;QACD,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,EAAE,CACtF,oBAAoB,CAAC,WAAW,EAAE,GAAG,MAAM,YAAY,KAAK,GAAG,CAAC,CAChE;QACD,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC;KACzE,CAAA;AACF,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,KAItC,EAAkC,EAAE;IACpC,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,UAAU,IAAI,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;IAEvF,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAA;IACtD,CAAC;IAED,KAAK,MAAM,WAAW,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAClD,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,CAAC;YACvC,SAAQ;QACT,CAAC;QAED,MAAM,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,wBAAwB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;QAChF,MAAM,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,CAAA;IAC5C,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QAChB,MAAM,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;IAC/C,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAChC,CAAC,CAAA;AAED,+DAA+D;AAC/D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,UAAyB,EAAE,QAAmD,EAAiB,EAAE;IAC3I,IAAI,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,IAAI,EAAE,CAAA;IACzB,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAA;IAC3B,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,OAAO,wBAAwB,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjD,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC,CAAA;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAA;AAEnG,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,WAA4B,EAAU,EAAE,CAAC;mBAC1E,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;;;;;;;;;;KAUzC,CAAA;AAEL,MAAM,mBAAmB,GAAG,CAAC,WAAqE,EAAW,EAAE,CAC9G,WAAW,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAA;AAE7E,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAE,MAAc,EAAmB,EAAE;IAChF,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAE1C,OAAO;QACN,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC;QACjD,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC;QACpD,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC;QACvD,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC;QACjD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC;QACxD,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC;QAC9D,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC;QAC3D,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,UAAU,CAAC;QAClE,QAAQ,EAAE,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,MAAM,WAAW,CAAC;KACrE,CAAA;AACF,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAE,MAAc,EAAmB,EAAE;IAChF,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAE/C,OAAO;QACN,MAAM,EAAE,YAAY,CAAC,WAAW,CAAC,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC;QAC5D,YAAY,EAAE,WAAW,CAAC,WAAW,CAAC,YAAY,EAAE,GAAG,MAAM,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAClG,iBAAiB,CAAC,KAAK,EAAE,GAAG,MAAM,iBAAiB,KAAK,GAAG,CAAC,CAC5D;QACD,cAAc,EAAE,WAAW,CAAC,WAAW,CAAC,cAAc,EAAE,GAAG,MAAM,iBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CACxG,iBAAiB,CAAC,KAAK,EAAE,GAAG,MAAM,mBAAmB,KAAK,GAAG,CAAC,CAC9D;KACD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,sBAAsB,GAAG,CAAC,KAAc,EAAE,MAAc,EAA6B,EAAE;IAC5F,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAC5C,MAAM,mBAAmB,GAAG,GAAG,MAAM,gBAAgB,CAAA;IACrD,MAAM,aAAa,GAAG,YAAY,CAAC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAA;IAC/E,IAAI,aAAa,KAAK,kCAAkC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,WAAW,mBAAmB,cAAc,kCAAkC,SAAS,aAAa,EAAE,CAAC,CAAA;IACxH,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,MAAM,SAAS,CAAA;IACrC,MAAM,QAAQ,GAAG,GAAG,MAAM,OAAO,CAAA;IACjC,MAAM,WAAW,GAAG,GAAG,MAAM,UAAU,CAAA;IACvC,MAAM,aAAa,GAAG,GAAG,MAAM,YAAY,CAAA;IAC3C,MAAM,cAAc,GAAG,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IAChE,MAAM,YAAY,GAAG,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC1D,MAAM,eAAe,GAAG,YAAY,CAAC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;IACnE,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IAEjE,OAAO;QACN,aAAa;QACb,UAAU,EAAE,YAAY,CAAC,QAAQ,CAAC,UAAU,EAAE,GAAG,MAAM,aAAa,CAAC;QACrE,MAAM,EAAE;YACP,SAAS,EAAE,YAAY,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,UAAU,YAAY,CAAC;YAC5E,aAAa,EAAE,2BAA2B,CAAC,cAAc,CAAC,aAAa,EAAE,GAAG,UAAU,gBAAgB,CAAC;SACvG;QACD,IAAI,EAAE;YACL,KAAK,EAAE,oBAAoB,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,QAAQ,QAAQ,CAAC;YACpE,UAAU,EAAE,oBAAoB,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,QAAQ,aAAa,CAAC;SACnF;QACD,OAAO,EAAE;YACR,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,WAAW,EAAE,GAAG,WAAW,cAAc,CAAC;SACpF;QACD,SAAS,EAAE;YACV,eAAe,EAAE,gBAAgB,CAAC,SAAS,CAAC,eAAe,EAAE,GAAG,aAAa,kBAAkB,CAAC;SAChG;QACD,qBAAqB,EAAE,oBAAoB,CAAC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,MAAM,wBAAwB,CAAC;KAC9G,CAAA;AACF,CAAC,CAAA;AAED,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAAE,MAAc,EAAmC,EAAE;IAC7F,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IACzC,OAAO;QACN,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,MAAM,OAAO,CAAC;QAChD,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC;KACnD,CAAA;AACF,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAE,MAAc,EAAY,EAAE,CACrE,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,MAAM,IAAI,KAAK,GAAG,CAAC,CAAC,CAAA;AAE7F,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,MAAc,EAA2B,EAAE;IAChF,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjE,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,sBAAsB,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,KAAgC,CAAA;AACxC,CAAC,CAAA;AAED,MAAM,WAAW,GAAG,CAAC,KAAc,EAAE,MAAc,EAAa,EAAE;IACjE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,qBAAqB,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,MAAc,EAAU,EAAE;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,qBAAqB,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,MAAc,EAAW,EAAE;IACjE,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,sBAAsB,CAAC,CAAA;IACzD,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,YAAY,GAAG,CAAC,KAAc,EAAE,MAAc,EAAU,EAAE;IAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,4BAA4B,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAE,MAAc,EAAiB,EAAE;IAC9E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACZ,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AACnC,CAAC,CAAA;AAED,MAAM,oBAAoB,GAAG,CAAC,KAAc,EAAE,MAAc,EAAiB,EAAE;IAC9E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACZ,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,oCAAoC,CAAC,CAAA;IACvE,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC,CAAA;AAED,MAAM,2BAA2B,GAAG,CAAC,KAAc,EAAE,MAAc,EAA8B,EAAE;IAClG,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACZ,CAAC;IACD,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAA;IACb,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,wCAAwC,CAAC,CAAA;AAC3E,CAAC,CAAA"}

package/dist/http/fetch.d.ts

@@ -0,0 +1,11 @@
+export type HttpMethod = 'GET' | 'POST' | 'PUT';
+export type HttpOptions = {
+    timeoutMs?: number;
+    method?: HttpMethod;
+    body?: unknown;
+    /** If true, return JSON body for 4xx responses instead of throwing. Default: false. */
+    returnErrorResponse?: boolean;
+};
+export declare const fetchJson: <T>(url: string, options?: HttpOptions) => Promise<T>;
+export declare const fetchText: (url: string, options?: HttpOptions) => Promise<string>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/http/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/http/fetch.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAA;AAE/C,MAAM,MAAM,WAAW,GAAG;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uFAAuF;IACvF,mBAAmB,CAAC,EAAE,OAAO,CAAA;CAC7B,CAAA;AAED,eAAO,MAAM,SAAS,GAAU,CAAC,EAAE,KAAK,MAAM,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,CAAC,CAgCpF,CAAA;AAED,eAAO,MAAM,SAAS,GAAU,KAAK,MAAM,EAAE,UAAS,WAAgB,KAAG,OAAO,CAAC,MAAM,CA2BtF,CAAA"}

package/dist/http/fetch.js

@@ -0,0 +1,80 @@
+export const fetchJson = async (url, options = {}) => {
+    const controller = new AbortController();
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const body = options.body != null ? JSON.stringify(options.body) : undefined;
+    try {
+        const response = await fetch(url, {
+            method: options.method ?? 'GET',
+            signal: controller.signal,
+            body,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+        });
+        if (!response.ok) {
+            if (options.returnErrorResponse && response.status >= 400) {
+                return (await response.json());
+            }
+            const errorMessage = await extractErrorMessage(response);
+            throw new Error(errorMessage ?? `Request failed (${response.status} ${response.statusText})`);
+        }
+        return (await response.json());
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            throw new Error(`Request timed out after ${timeoutMs}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+export const fetchText = async (url, options = {}) => {
+    const controller = new AbortController();
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    const body = options.body != null ? JSON.stringify(options.body) : undefined;
+    try {
+        const response = await fetch(url, {
+            method: options.method ?? 'GET',
+            signal: controller.signal,
+            body,
+            headers: body ? { 'Content-Type': 'application/json' } : undefined,
+        });
+        if (!response.ok) {
+            throw new Error(`Request failed (${response.status} ${response.statusText})`);
+        }
+        return await response.text();
+    }
+    catch (error) {
+        if (isAbortError(error)) {
+            throw new Error(`Request timed out after ${timeoutMs}ms`);
+        }
+        throw error;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+};
+const isAbortError = (error) => {
+    if (!error || typeof error !== 'object' || !('name' in error)) {
+        return false;
+    }
+    return error.name === 'AbortError';
+};
+const extractErrorMessage = async (response) => {
+    try {
+        const body = await response.json();
+        if (body && typeof body === 'object' && 'error' in body) {
+            const error = body.error;
+            if (error && typeof error === 'object' && 'message' in error) {
+                return error.message;
+            }
+        }
+    }
+    catch {
+        // Ignore JSON parse errors - fall back to status text
+    }
+    return null;
+};
+//# sourceMappingURL=fetch.js.map

package/dist/http/fetch.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './protocol/logs.js';
 export * from './protocol/http.js';
+export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './protocol/http/auth.js';
 export * from './protocol/version.js';
 export * from './registry/registry.js';
 export * from './registry/types.js';
@@ -7,4 +8,6 @@ export * from './registry/paths.js';
 export * from './logs/previewStringify.js';
 export * from './textPattern.js';
 export * from './auth/cookies.js';
+export * from './auth/state.js';
+export * from './http/fetch.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAA;AAC5E,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './protocol/logs.js';
 export * from './protocol/http.js';
+export { AUTH_STATE_METADATA_SCHEMA_VERSION } from './protocol/http/auth.js';
 export * from './protocol/version.js';
 export * from './registry/registry.js';
 export * from './registry/types.js';
@@ -7,4 +8,6 @@ export * from './registry/paths.js';
 export * from './logs/previewStringify.js';
 export * from './textPattern.js';
 export * from './auth/cookies.js';
+export * from './auth/state.js';
+export * from './http/fetch.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAA;AAC5E,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA"}

package/dist/protocol/http/auth.d.ts

@@ -11,10 +11,150 @@ export type AuthCookie = {
     expires: number | null;
     sameSite: string | null;
 };
+/** Exact cookie identity used for lookup/delete responses. */
+export type AuthCookieIdentity = {
+    name: string;
+    domain: string;
+    path: string;
+};
 /** Response payload for GET /auth/cookies. */
 export type AuthCookiesResponse = {
     ok: true;
     origin: string;
     cookies: AuthCookie[];
 };
+/** Request payload for exact cookie lookup. */
+export type AuthCookieGetRequest = AuthCookieIdentity & {
+    includeValue?: boolean;
+};
+/** Response payload for exact cookie lookup. */
+export type AuthCookieGetResponse = {
+    ok: true;
+    origin: string;
+    cookie: AuthCookie | null;
+};
+/** Cookie payload used by auth-state export and import. */
+export type AuthStateCookie = {
+    name: string;
+    value: string;
+    domain: string;
+    path: string;
+    secure: boolean;
+    httpOnly: boolean;
+    session: boolean;
+    expires: number | null;
+    sameSite: string | null;
+};
+/** Request payload for exact cookie upserts. */
+export type AuthCookieSetRequest = {
+    cookie: AuthStateCookie;
+};
+/** Response payload for cookie upserts. */
+export type AuthCookieSetResponse = {
+    ok: true;
+    origin: string;
+    cookie: AuthCookie;
+};
+/** Request payload for exact cookie deletion. */
+export type AuthCookieDeleteRequest = AuthCookieIdentity;
+/** Response payload for exact cookie deletion. */
+export type AuthCookieDeleteResponse = {
+    ok: true;
+    origin: string;
+    deleted: boolean;
+    cookie: AuthCookieIdentity;
+};
+/** Scope used by bulk cookie clearing. */
+export type AuthCookieClearScope = 'origin' | 'site' | 'domain' | 'browserContext';
+/** Request payload for scoped cookie clearing. */
+export type AuthCookieClearRequest = {
+    scope: AuthCookieClearScope;
+    domain?: string;
+    sessionOnly?: boolean;
+    authOnly?: boolean;
+};
+/** Response payload for scoped cookie clearing. */
+export type AuthCookieClearResponse = {
+    ok: true;
+    origin: string;
+    scope: AuthCookieClearScope;
+    scopeValue: string | null;
+    sessionOnly: boolean;
+    authOnly: boolean;
+    cleared: number;
+    cookies: AuthCookieIdentity[];
+};
+/** A single storage entry for localStorage/sessionStorage snapshots. */
+export type AuthStateStorageEntry = {
+    name: string;
+    value: string;
+};
+/** Per-origin storage captured alongside cookies in an auth-state snapshot. */
+export type AuthStateOrigin = {
+    origin: string;
+    localStorage: AuthStateStorageEntry[];
+    sessionStorage: AuthStateStorageEntry[];
+};
+/** Schema version for the auth-state metadata block. */
+export declare const AUTH_STATE_METADATA_SCHEMA_VERSION = 1;
+/** Source metadata for auth-state snapshots. */
+export type AuthStateSnapshotSourceMetadata = {
+    /** Watcher id that produced the snapshot. */
+    watcherId: string;
+    /** Watcher transport used for capture. Null when unavailable. */
+    watcherSource: 'cdp' | 'extension' | null;
+};
+/** Page metadata for auth-state snapshots. */
+export type AuthStateSnapshotPageMetadata = {
+    /** Best-effort page title at export time. */
+    title: string | null;
+    /** Best-effort site domain used for same-site cookie capture. */
+    siteDomain: string | null;
+};
+/** Capture summary metadata for auth-state snapshots. */
+export type AuthStateSnapshotCaptureMetadata = {
+    /** Number of cookies stored in `snapshot.cookies`. */
+    cookieCount: number;
+};
+/** Lightweight auth hints that help agents reason about replay usefulness. */
+export type AuthStateSnapshotAuthHints = {
+    /** Cookie names that look auth-related by conservative name matching. */
+    authCookieNames: string[];
+};
+/** Metadata attached to auth-state snapshots for provenance and triage. */
+export type AuthStateSnapshotMetadata = {
+    /** Metadata schema version. */
+    schemaVersion: number;
+    /** ISO timestamp when the snapshot was exported. */
+    exportedAt: string;
+    /** Watcher provenance. */
+    source: AuthStateSnapshotSourceMetadata;
+    /** Page context. */
+    page: AuthStateSnapshotPageMetadata;
+    /** Snapshot size summary. */
+    capture: AuthStateSnapshotCaptureMetadata;
+    /** Conservative auth hints for agents. */
+    authHints: AuthStateSnapshotAuthHints;
+    /** Preferred URL to open after hydration. */
+    recommendedStartupUrl: string | null;
+};
+/** Portable auth snapshot used to rehydrate a fresh browser session. */
+export type AuthStateSnapshot = {
+    ok: true;
+    url: string;
+    origin: string;
+    cookies: AuthStateCookie[];
+    origins: AuthStateOrigin[];
+    metadata: AuthStateSnapshotMetadata;
+};
+/** Request payload for loading an auth-state snapshot into an attached watcher target. */
+export type AuthStateLoadRequest = {
+    snapshot: AuthStateSnapshot;
+    url?: string;
+};
+/** Response payload for auth-state hydration requests. */
+export type AuthStateLoadResponse = {
+    ok: true;
+    startupUrl: string | null;
+};
 //# sourceMappingURL=auth.d.ts.map

package/dist/protocol/http/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,UAAU,EAAE,CAAA;CACrB,CAAA"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,mBAAmB,GAAG;IACjC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,UAAU,EAAE,CAAA;CACrB,CAAA;AAED,+CAA+C;AAC/C,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GAAG;IACvD,YAAY,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,2DAA2D;AAC3D,MAAM,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,oBAAoB,GAAG;IAClC,MAAM,EAAE,eAAe,CAAA;CACvB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,iDAAiD;AACjD,MAAM,MAAM,uBAAuB,GAAG,kBAAkB,CAAA;AAExD,kDAAkD;AAClD,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,kBAAkB,CAAA;CAC1B,CAAA;AAED,0CAA0C;AAC1C,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,gBAAgB,CAAA;AAElF,kDAAkD;AAClD,MAAM,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,oBAAoB,CAAA;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,mDAAmD;AACnD,MAAM,MAAM,uBAAuB,GAAG;IACrC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,oBAAoB,CAAA;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,OAAO,CAAA;IACpB,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,kBAAkB,EAAE,CAAA;CAC7B,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,qBAAqB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACb,CAAA;AAED,+EAA+E;AAC/E,MAAM,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,qBAAqB,EAAE,CAAA;IACrC,cAAc,EAAE,qBAAqB,EAAE,CAAA;CACvC,CAAA;AAED,wDAAwD;AACxD,eAAO,MAAM,kCAAkC,IAAI,CAAA;AAEnD,gDAAgD;AAChD,MAAM,MAAM,+BAA+B,GAAG;IAC7C,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAA;IACjB,iEAAiE;IACjE,aAAa,EAAE,KAAK,GAAG,WAAW,GAAG,IAAI,CAAA;CACzC,CAAA;AAED,8CAA8C;AAC9C,MAAM,MAAM,6BAA6B,GAAG;IAC3C,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,iEAAiE;IACjE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA;AAED,yDAAyD;AACzD,MAAM,MAAM,gCAAgC,GAAG;IAC9C,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,8EAA8E;AAC9E,MAAM,MAAM,0BAA0B,GAAG;IACxC,yEAAyE;IACzE,eAAe,EAAE,MAAM,EAAE,CAAA;CACzB,CAAA;AAED,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG;IACvC,+BAA+B;IAC/B,aAAa,EAAE,MAAM,CAAA;IACrB,oDAAoD;IACpD,UAAU,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,MAAM,EAAE,+BAA+B,CAAA;IACvC,oBAAoB;IACpB,IAAI,EAAE,6BAA6B,CAAA;IACnC,6BAA6B;IAC7B,OAAO,EAAE,gCAAgC,CAAA;IACzC,0CAA0C;IAC1C,SAAS,EAAE,0BAA0B,CAAA;IACrC,6CAA6C;IAC7C,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAA;CACpC,CAAA;AAED,wEAAwE;AACxE,MAAM,MAAM,iBAAiB,GAAG;IAC/B,EAAE,EAAE,IAAI,CAAA;IACR,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,QAAQ,EAAE,yBAAyB,CAAA;CACnC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,0DAA0D;AAC1D,MAAM,MAAM,qBAAqB,GAAG;IACnC,EAAE,EAAE,IAAI,CAAA;IACR,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB,CAAA"}

package/dist/protocol/http/auth.js

@@ -1,2 +1,3 @@
-export {};
+/** Schema version for the auth-state metadata block. */
+export const AUTH_STATE_METADATA_SCHEMA_VERSION = 1;
 //# sourceMappingURL=auth.js.map

package/dist/protocol/http/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":""}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/protocol/http/auth.ts"],"names":[],"mappings":"AAgHA,wDAAwD;AACxD,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAA"}

package/dist/protocol/http/code.d.ts

@@ -51,9 +51,20 @@ export type CodeGrepMatch = {
     lineNumber: number;
     lineContent: string;
 };
+/** Runtime resource skipped during grep because its live handle could not be read. */
+export type CodeGrepSkippedResource = {
+    /** Runtime resource URL originally discovered via `code ls`. */
+    url: string;
+    /** Resource kind. */
+    type: CodeResourceType;
+    /** Human-readable read failure reason. */
+    reason: string;
+};
 /** Response payload for POST /code/grep. */
 export type CodeGrepResponse = {
     ok: true;
     matches: CodeGrepMatch[];
+    /** Non-fatal runtime resources skipped while searching. */
+    skippedResources: CodeGrepSkippedResource[];
 };
 //# sourceMappingURL=code.d.ts.map

package/dist/protocol/http/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/code.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG;IAC1B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;CACtB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,SAAS,EAAE,YAAY,EAAE,CAAA;CACzB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,YAAY,CAAA;IACtB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,gBAAgB,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,aAAa,EAAE,CAAA;CACxB,CAAA"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/code.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,CAAA;AAEtD,0CAA0C;AAC1C,MAAM,MAAM,YAAY,GAAG;IAC1B,yDAAyD;IACzD,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;CACtB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,SAAS,EAAE,YAAY,EAAE,CAAA;CACzB,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAA;IACX,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,QAAQ,EAAE,YAAY,CAAA;IACtB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CACf,CAAA;AAED,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG;IAC7B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,gBAAgB,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,sFAAsF;AACtF,MAAM,MAAM,uBAAuB,GAAG;IACrC,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAA;IACX,qBAAqB;IACrB,IAAI,EAAE,gBAAgB,CAAA;IACtB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACd,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,EAAE,EAAE,IAAI,CAAA;IACR,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,2DAA2D;IAC3D,gBAAgB,EAAE,uBAAuB,EAAE,CAAA;CAC3C,CAAA"}

package/dist/protocol/http/dialog.d.ts

@@ -0,0 +1,28 @@
+/** Browser dialog types exposed by Chrome DevTools Protocol. */
+export type DialogType = 'alert' | 'confirm' | 'prompt' | 'beforeunload';
+/** Snapshot of the currently active JavaScript dialog. */
+export type DialogStatus = {
+    type: DialogType;
+    message: string;
+    defaultPrompt: string | null;
+    url: string | null;
+    hasBrowserHandler: boolean;
+    openedAt: number;
+};
+/** Response payload for GET /dialog. */
+export type DialogStatusResponse = {
+    ok: true;
+    dialog: DialogStatus | null;
+};
+/** Request payload for POST /dialog. */
+export type DialogHandleRequest = {
+    action: 'accept' | 'dismiss';
+    promptText?: string;
+};
+/** Response payload for POST /dialog. */
+export type DialogHandleResponse = {
+    ok: true;
+    action: 'accept' | 'dismiss';
+    dialog: DialogStatus;
+};
+//# sourceMappingURL=dialog.d.ts.map

package/dist/protocol/http/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../src/protocol/http/dialog.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAA;AAExE,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,UAAU,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,iBAAiB,EAAE,OAAO,CAAA;IAC1B,QAAQ,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,wCAAwC;AACxC,MAAM,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,yCAAyC;AACzC,MAAM,MAAM,oBAAoB,GAAG;IAClC,EAAE,EAAE,IAAI,CAAA;IACR,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAA;IAC5B,MAAM,EAAE,YAAY,CAAA;CACpB,CAAA"}

package/dist/protocol/http/dialog.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dialog.js.map

package/dist/protocol/http/dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.js","sourceRoot":"","sources":["../../../src/protocol/http/dialog.ts"],"names":[],"mappings":""}