@onkernel/sdk 0.49.0 → 0.52.0

package/lib/browser-routing.js

@@ -0,0 +1,246 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserRouteCache = void 0;
+exports.browserRoutingSubresourcesFromEnv = browserRoutingSubresourcesFromEnv;
+exports.createRoutingFetch = createRoutingFetch;
+const join_url_1 = require("./join-url.js");
+class BrowserRouteCache {
+    constructor() {
+        this.entries = new Map();
+    }
+    get(sessionId) {
+        return this.entries.get(sessionId);
+    }
+    set(route) {
+        this.entries.set(route.sessionId, route);
+    }
+    delete(sessionId) {
+        this.entries.delete(sessionId);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+exports.BrowserRouteCache = BrowserRouteCache;
+const BROWSER_ROUTING_SUBRESOURCES_ENV = 'KERNEL_BROWSER_ROUTING_SUBRESOURCES';
+const DEFAULT_BROWSER_ROUTING_SUBRESOURCES = ['curl'];
+const BROWSER_ROUTE_CACHEABLE_PATH = /^\/(?:v\d+\/)?browsers(?:\/[^/]+)?\/?$/;
+const BROWSER_POOL_ACQUIRE_PATH = /^\/(?:v\d+\/)?browser_pools\/[^/]+\/acquire\/?$/;
+const BROWSER_DELETE_BY_ID_PATH = /^\/(?:v\d+\/)?browsers\/([^/]+)\/?$/;
+const BROWSER_POOL_RELEASE_PATH = /^\/(?:v\d+\/)?browser_pools\/[^/]+\/release\/?$/;
+function browserRoutingSubresourcesFromEnv() {
+    const raw = readBrowserRoutingSubresourcesEnv();
+    if (raw === undefined) {
+        return [...DEFAULT_BROWSER_ROUTING_SUBRESOURCES];
+    }
+    if (raw.trim() === '') {
+        return [];
+    }
+    return raw
+        .split(',')
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+function createRoutingFetch(innerFetch, { apiBaseURL, subresources, cache, }) {
+    const allowed = new Set([...subresources].map((value) => value.trim()).filter(Boolean));
+    const apiOrigin = new URL(apiBaseURL).origin;
+    return async (input, init) => {
+        const request = new Request(input, init);
+        const shouldSniff = shouldSniffAndPopulateCache(request, apiOrigin);
+        const response = await routeRequest(innerFetch, { input, init, request }, apiOrigin, allowed, cache);
+        if (shouldSniff) {
+            await sniffAndPopulateCache(response, cache);
+        }
+        await maybeEvictBrowserRoute(request, response, apiOrigin, cache);
+        return response;
+    };
+}
+function shouldSniffAndPopulateCache(request, apiOrigin) {
+    const url = new URL(request.url);
+    return (url.origin === apiOrigin &&
+        (BROWSER_ROUTE_CACHEABLE_PATH.test(url.pathname) || BROWSER_POOL_ACQUIRE_PATH.test(url.pathname)));
+}
+async function maybeEvictBrowserRoute(request, response, apiOrigin, cache) {
+    if (!response.ok) {
+        return;
+    }
+    const url = new URL(request.url);
+    if (url.origin !== apiOrigin) {
+        return;
+    }
+    const sessionId = deletedSessionIdFromPath(request, url.pathname) ??
+        (await releasedSessionIdFromRequest(request, url.pathname));
+    if (sessionId) {
+        cache.delete(sessionId);
+    }
+}
+function deletedSessionIdFromPath(request, pathname) {
+    if (request.method.toUpperCase() !== 'DELETE') {
+        return undefined;
+    }
+    const match = pathname.match(BROWSER_DELETE_BY_ID_PATH);
+    if (!match) {
+        return undefined;
+    }
+    const sessionId = decodeURIComponent(match[1] ?? '');
+    return sessionId || undefined;
+}
+async function releasedSessionIdFromRequest(request, pathname) {
+    if (request.method.toUpperCase() !== 'POST' || !BROWSER_POOL_RELEASE_PATH.test(pathname)) {
+        return undefined;
+    }
+    try {
+        const body = await request.clone().json();
+        if (!body || typeof body !== 'object') {
+            return undefined;
+        }
+        const sessionId = body['session_id'];
+        return typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function browserRouteFromValue(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = value;
+    const sessionId = typeof record['session_id'] === 'string' ? record['session_id'].trim() : '';
+    const baseURL = typeof record['base_url'] === 'string' ? record['base_url'].trim() : '';
+    if (!sessionId || !baseURL) {
+        return undefined;
+    }
+    const explicitJWT = typeof record['jwt'] === 'string' ? record['jwt'].trim() : '';
+    const cdpWsURL = typeof record['cdp_ws_url'] === 'string' ? record['cdp_ws_url'] : undefined;
+    const jwt = explicitJWT || parseJwtFromCdpWsUrl(cdpWsURL) || '';
+    if (!jwt) {
+        return undefined;
+    }
+    return {
+        sessionId,
+        baseURL,
+        jwt,
+    };
+}
+async function sniffAndPopulateCache(response, cache) {
+    const contentType = response.headers.get('content-type')?.toLowerCase() ?? '';
+    if (!contentType.includes('application/json')) {
+        return;
+    }
+    try {
+        populateCache(await response.clone().json(), cache);
+    }
+    catch {
+        // Ignore malformed JSON in routing cache population.
+    }
+}
+function populateCache(value, cache) {
+    const route = browserRouteFromValue(value);
+    if (route) {
+        cache.set(route);
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            populateCache(item, cache);
+        }
+        return;
+    }
+    if (!value || typeof value !== 'object') {
+        return;
+    }
+    for (const child of Object.values(value)) {
+        if (typeof child === 'object' && child !== null) {
+            populateCache(child, cache);
+        }
+    }
+}
+async function routeRequest(innerFetch, { input, init, request, }, apiOrigin, allowed, cache) {
+    const url = new URL(request.url);
+    if (url.origin !== apiOrigin) {
+        return innerFetch(input, init);
+    }
+    const match = url.pathname.match(/^\/(?:v\d+\/)?browsers\/([^/]+)\/([^/]+)(\/.*)?$/);
+    if (!match) {
+        return innerFetch(input, init);
+    }
+    const sessionId = decodeURIComponent(match[1] ?? '');
+    const subresource = match[2] ?? '';
+    if (!sessionId || !allowed.has(subresource)) {
+        return innerFetch(input, init);
+    }
+    const route = cache.get(sessionId);
+    if (route === undefined) {
+        return innerFetch(input, init);
+    }
+    const target = new URL((0, join_url_1.joinURL)(route.baseURL, `/${subresource}${match[3] ?? ''}`));
+    url.searchParams.forEach((value, key) => {
+        if (key !== 'jwt') {
+            target.searchParams.append(key, value);
+        }
+    });
+    if (!target.searchParams.get('jwt')) {
+        target.searchParams.set('jwt', route.jwt);
+    }
+    const headers = new Headers(request.headers);
+    headers.delete('authorization');
+    return innerFetch(target.toString(), buildRoutedInit(request, init, headers));
+}
+function buildRoutedInit(request, originalInit, headers) {
+    const method = request.method.toUpperCase();
+    const routedInit = {
+        ...(originalInit ?? {}),
+        method,
+        headers,
+        redirect: request.redirect,
+        signal: request.signal,
+    };
+    delete routedInit['body'];
+    delete routedInit['duplex'];
+    if (method !== 'GET' && method !== 'HEAD') {
+        const body = requestBodyForFetch(request, originalInit);
+        if (body !== undefined) {
+            routedInit.body = body;
+        }
+        if (originalInit?.duplex !== undefined) {
+            routedInit.duplex = originalInit.duplex;
+        }
+        else if (requiresHalfDuplex(body)) {
+            routedInit.duplex = 'half';
+        }
+    }
+    return routedInit;
+}
+function requestBodyForFetch(request, originalInit) {
+    if (originalInit?.body !== undefined && originalInit.body !== null) {
+        return originalInit.body;
+    }
+    return request.body ?? undefined;
+}
+function requiresHalfDuplex(body) {
+    return ((globalThis.ReadableStream && body instanceof globalThis.ReadableStream) ||
+        (typeof body === 'object' && body !== null && Symbol.asyncIterator in body));
+}
+function parseJwtFromCdpWsUrl(cdpWsUrl) {
+    if (!cdpWsUrl) {
+        return undefined;
+    }
+    try {
+        return new URL(cdpWsUrl).searchParams.get('jwt') ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readBrowserRoutingSubresourcesEnv() {
+    if (typeof globalThis.process !== 'undefined') {
+        const value = globalThis.process.env?.[BROWSER_ROUTING_SUBRESOURCES_ENV];
+        return typeof value === 'string' ? value : undefined;
+    }
+    if (typeof globalThis.Deno !== 'undefined') {
+        const value = globalThis.Deno.env?.get?.(BROWSER_ROUTING_SUBRESOURCES_ENV);
+        return typeof value === 'string' ? value : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=browser-routing.js.map

package/lib/browser-routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-routing.js","sourceRoot":"","sources":["../src/lib/browser-routing.ts"],"names":[],"mappings":";;;AAoCA,8EAcC;AAED,gDAyBC;AA5ED,4CAAqC;AAQrC,MAAa,iBAAiB;IAA9B;QACU,YAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAiBpD,CAAC;IAfC,GAAG,CAAC,SAAiB;QACnB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,KAAmB;QACrB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,CAAC,SAAiB;QACtB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF;AAlBD,8CAkBC;AAED,MAAM,gCAAgC,GAAG,qCAAqC,CAAC;AAC/E,MAAM,oCAAoC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtD,MAAM,4BAA4B,GAAG,wCAAwC,CAAC;AAC9E,MAAM,yBAAyB,GAAG,iDAAiD,CAAC;AACpF,MAAM,yBAAyB,GAAG,qCAAqC,CAAC;AACxE,MAAM,yBAAyB,GAAG,iDAAiD,CAAC;AAEpF,SAAgB,iCAAiC;IAC/C,MAAM,GAAG,GAAG,iCAAiC,EAAE,CAAC;IAChD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,oCAAoC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SAC5B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAgB,kBAAkB,CAChC,UAAiB,EACjB,EACE,UAAU,EACV,YAAY,EACZ,KAAK,GAKN;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC;IAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACzC,MAAM,WAAW,GAAG,2BAA2B,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpE,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;QACrG,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,sBAAsB,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAClE,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,OAAgB,EAAE,SAAiB;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,CACL,GAAG,CAAC,MAAM,KAAK,SAAS;QACxB,CAAC,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAClG,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,OAAgB,EAChB,QAAkB,EAClB,SAAiB,EACjB,KAAwB;IAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GACb,wBAAwB,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC;QAC/C,CAAC,MAAM,4BAA4B,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAgB,EAAE,QAAgB;IAClE,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,SAAS,IAAI,SAAS,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,4BAA4B,CAAC,OAAgB,EAAE,QAAgB;IAC5E,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,SAAS,GAAI,IAAgC,CAAC,YAAY,CAAC,CAAC;QAClE,OAAO,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9F,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,UAAU,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxF,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7F,MAAM,GAAG,GAAG,WAAW,IAAI,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO;QACL,SAAS;QACT,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,QAAkB,EAAE,KAAwB;IAC/E,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9E,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC9C,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,aAAa,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc,EAAE,KAAwB;IAC7D,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,KAAgC,CAAC,EAAE,CAAC;QACpE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YAChD,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,UAAiB,EACjB,EACE,KAAK,EACL,IAAI,EACJ,OAAO,GAKR,EACD,SAAiB,EACjB,OAA4B,EAC5B,KAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACrF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,SAAS,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QAC5C,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,IAAA,kBAAO,EAAC,KAAK,CAAC,OAAO,EAAE,IAAI,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IACnF,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACtC,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACpC,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IAChC,OAAO,UAAU,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,eAAe,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,eAAe,CACtB,OAAgB,EAChB,YAAqC,EACrC,OAAgB;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,UAAU,GAAG;QACjB,GAAI,CAAC,YAAY,IAAI,EAAE,CAA6B;QACpD,MAAM;QACN,OAAO;QACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;KACkB,CAAC;IAE3C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;IAE5B,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QACxD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,YAAY,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;YACvC,UAAU,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAC1C,CAAC;aAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAC1B,OAAgB,EAChB,YAAqC;IAErC,IAAI,YAAY,EAAE,IAAI,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACnE,OAAO,YAAY,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;AACnC,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAqC;IAC/D,OAAO,CACL,CAAE,UAAkB,CAAC,cAAc,IAAI,IAAI,YAAa,UAAkB,CAAC,cAAc,CAAC;QAC1F,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC,CAC5E,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,QAA4B;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IAChE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,iCAAiC;IACxC,IAAI,OAAQ,UAAkB,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;QACvD,MAAM,KAAK,GAAI,UAAkB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,gCAAgC,CAAC,CAAC;QAClF,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAED,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpD,MAAM,KAAK,GAAI,UAAkB,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,gCAAgC,CAAC,CAAC;QACpF,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/lib/browser-routing.mjs

@@ -0,0 +1,240 @@
+import { joinURL } from "./join-url.mjs";
+export class BrowserRouteCache {
+    constructor() {
+        this.entries = new Map();
+    }
+    get(sessionId) {
+        return this.entries.get(sessionId);
+    }
+    set(route) {
+        this.entries.set(route.sessionId, route);
+    }
+    delete(sessionId) {
+        this.entries.delete(sessionId);
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+const BROWSER_ROUTING_SUBRESOURCES_ENV = 'KERNEL_BROWSER_ROUTING_SUBRESOURCES';
+const DEFAULT_BROWSER_ROUTING_SUBRESOURCES = ['curl'];
+const BROWSER_ROUTE_CACHEABLE_PATH = /^\/(?:v\d+\/)?browsers(?:\/[^/]+)?\/?$/;
+const BROWSER_POOL_ACQUIRE_PATH = /^\/(?:v\d+\/)?browser_pools\/[^/]+\/acquire\/?$/;
+const BROWSER_DELETE_BY_ID_PATH = /^\/(?:v\d+\/)?browsers\/([^/]+)\/?$/;
+const BROWSER_POOL_RELEASE_PATH = /^\/(?:v\d+\/)?browser_pools\/[^/]+\/release\/?$/;
+export function browserRoutingSubresourcesFromEnv() {
+    const raw = readBrowserRoutingSubresourcesEnv();
+    if (raw === undefined) {
+        return [...DEFAULT_BROWSER_ROUTING_SUBRESOURCES];
+    }
+    if (raw.trim() === '') {
+        return [];
+    }
+    return raw
+        .split(',')
+        .map((value) => value.trim())
+        .filter(Boolean);
+}
+export function createRoutingFetch(innerFetch, { apiBaseURL, subresources, cache, }) {
+    const allowed = new Set([...subresources].map((value) => value.trim()).filter(Boolean));
+    const apiOrigin = new URL(apiBaseURL).origin;
+    return async (input, init) => {
+        const request = new Request(input, init);
+        const shouldSniff = shouldSniffAndPopulateCache(request, apiOrigin);
+        const response = await routeRequest(innerFetch, { input, init, request }, apiOrigin, allowed, cache);
+        if (shouldSniff) {
+            await sniffAndPopulateCache(response, cache);
+        }
+        await maybeEvictBrowserRoute(request, response, apiOrigin, cache);
+        return response;
+    };
+}
+function shouldSniffAndPopulateCache(request, apiOrigin) {
+    const url = new URL(request.url);
+    return (url.origin === apiOrigin &&
+        (BROWSER_ROUTE_CACHEABLE_PATH.test(url.pathname) || BROWSER_POOL_ACQUIRE_PATH.test(url.pathname)));
+}
+async function maybeEvictBrowserRoute(request, response, apiOrigin, cache) {
+    if (!response.ok) {
+        return;
+    }
+    const url = new URL(request.url);
+    if (url.origin !== apiOrigin) {
+        return;
+    }
+    const sessionId = deletedSessionIdFromPath(request, url.pathname) ??
+        (await releasedSessionIdFromRequest(request, url.pathname));
+    if (sessionId) {
+        cache.delete(sessionId);
+    }
+}
+function deletedSessionIdFromPath(request, pathname) {
+    if (request.method.toUpperCase() !== 'DELETE') {
+        return undefined;
+    }
+    const match = pathname.match(BROWSER_DELETE_BY_ID_PATH);
+    if (!match) {
+        return undefined;
+    }
+    const sessionId = decodeURIComponent(match[1] ?? '');
+    return sessionId || undefined;
+}
+async function releasedSessionIdFromRequest(request, pathname) {
+    if (request.method.toUpperCase() !== 'POST' || !BROWSER_POOL_RELEASE_PATH.test(pathname)) {
+        return undefined;
+    }
+    try {
+        const body = await request.clone().json();
+        if (!body || typeof body !== 'object') {
+            return undefined;
+        }
+        const sessionId = body['session_id'];
+        return typeof sessionId === 'string' && sessionId.trim() ? sessionId.trim() : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function browserRouteFromValue(value) {
+    if (!value || typeof value !== 'object') {
+        return undefined;
+    }
+    const record = value;
+    const sessionId = typeof record['session_id'] === 'string' ? record['session_id'].trim() : '';
+    const baseURL = typeof record['base_url'] === 'string' ? record['base_url'].trim() : '';
+    if (!sessionId || !baseURL) {
+        return undefined;
+    }
+    const explicitJWT = typeof record['jwt'] === 'string' ? record['jwt'].trim() : '';
+    const cdpWsURL = typeof record['cdp_ws_url'] === 'string' ? record['cdp_ws_url'] : undefined;
+    const jwt = explicitJWT || parseJwtFromCdpWsUrl(cdpWsURL) || '';
+    if (!jwt) {
+        return undefined;
+    }
+    return {
+        sessionId,
+        baseURL,
+        jwt,
+    };
+}
+async function sniffAndPopulateCache(response, cache) {
+    const contentType = response.headers.get('content-type')?.toLowerCase() ?? '';
+    if (!contentType.includes('application/json')) {
+        return;
+    }
+    try {
+        populateCache(await response.clone().json(), cache);
+    }
+    catch {
+        // Ignore malformed JSON in routing cache population.
+    }
+}
+function populateCache(value, cache) {
+    const route = browserRouteFromValue(value);
+    if (route) {
+        cache.set(route);
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            populateCache(item, cache);
+        }
+        return;
+    }
+    if (!value || typeof value !== 'object') {
+        return;
+    }
+    for (const child of Object.values(value)) {
+        if (typeof child === 'object' && child !== null) {
+            populateCache(child, cache);
+        }
+    }
+}
+async function routeRequest(innerFetch, { input, init, request, }, apiOrigin, allowed, cache) {
+    const url = new URL(request.url);
+    if (url.origin !== apiOrigin) {
+        return innerFetch(input, init);
+    }
+    const match = url.pathname.match(/^\/(?:v\d+\/)?browsers\/([^/]+)\/([^/]+)(\/.*)?$/);
+    if (!match) {
+        return innerFetch(input, init);
+    }
+    const sessionId = decodeURIComponent(match[1] ?? '');
+    const subresource = match[2] ?? '';
+    if (!sessionId || !allowed.has(subresource)) {
+        return innerFetch(input, init);
+    }
+    const route = cache.get(sessionId);
+    if (route === undefined) {
+        return innerFetch(input, init);
+    }
+    const target = new URL(joinURL(route.baseURL, `/${subresource}${match[3] ?? ''}`));
+    url.searchParams.forEach((value, key) => {
+        if (key !== 'jwt') {
+            target.searchParams.append(key, value);
+        }
+    });
+    if (!target.searchParams.get('jwt')) {
+        target.searchParams.set('jwt', route.jwt);
+    }
+    const headers = new Headers(request.headers);
+    headers.delete('authorization');
+    return innerFetch(target.toString(), buildRoutedInit(request, init, headers));
+}
+function buildRoutedInit(request, originalInit, headers) {
+    const method = request.method.toUpperCase();
+    const routedInit = {
+        ...(originalInit ?? {}),
+        method,
+        headers,
+        redirect: request.redirect,
+        signal: request.signal,
+    };
+    delete routedInit['body'];
+    delete routedInit['duplex'];
+    if (method !== 'GET' && method !== 'HEAD') {
+        const body = requestBodyForFetch(request, originalInit);
+        if (body !== undefined) {
+            routedInit.body = body;
+        }
+        if (originalInit?.duplex !== undefined) {
+            routedInit.duplex = originalInit.duplex;
+        }
+        else if (requiresHalfDuplex(body)) {
+            routedInit.duplex = 'half';
+        }
+    }
+    return routedInit;
+}
+function requestBodyForFetch(request, originalInit) {
+    if (originalInit?.body !== undefined && originalInit.body !== null) {
+        return originalInit.body;
+    }
+    return request.body ?? undefined;
+}
+function requiresHalfDuplex(body) {
+    return ((globalThis.ReadableStream && body instanceof globalThis.ReadableStream) ||
+        (typeof body === 'object' && body !== null && Symbol.asyncIterator in body));
+}
+function parseJwtFromCdpWsUrl(cdpWsUrl) {
+    if (!cdpWsUrl) {
+        return undefined;
+    }
+    try {
+        return new URL(cdpWsUrl).searchParams.get('jwt') ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function readBrowserRoutingSubresourcesEnv() {
+    if (typeof globalThis.process !== 'undefined') {
+        const value = globalThis.process.env?.[BROWSER_ROUTING_SUBRESOURCES_ENV];
+        return typeof value === 'string' ? value : undefined;
+    }
+    if (typeof globalThis.Deno !== 'undefined') {
+        const value = globalThis.Deno.env?.get?.(BROWSER_ROUTING_SUBRESOURCES_ENV);
+        return typeof value === 'string' ? value : undefined;
+    }
+    return undefined;
+}
+//# sourceMappingURL=browser-routing.mjs.map

package/lib/browser-routing.mjs.map

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

package/lib/join-url.d.mts

@@ -0,0 +1,2 @@
+export declare function joinURL(baseURL: string, path: string): string;
+//# sourceMappingURL=join-url.d.mts.map

package/lib/join-url.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-url.d.mts","sourceRoot":"","sources":["../src/lib/join-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/lib/join-url.d.ts

@@ -0,0 +1,2 @@
+export declare function joinURL(baseURL: string, path: string): string;
+//# sourceMappingURL=join-url.d.ts.map

package/lib/join-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-url.d.ts","sourceRoot":"","sources":["../src/lib/join-url.ts"],"names":[],"mappings":"AAAA,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/lib/join-url.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.joinURL = joinURL;
+function joinURL(baseURL, path) {
+    return `${baseURL.replace(/\/+$/, '')}${path.startsWith('/') ? path : `/${path}`}`;
+}
+//# sourceMappingURL=join-url.js.map

package/lib/join-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-url.js","sourceRoot":"","sources":["../src/lib/join-url.ts"],"names":[],"mappings":";;AAAA,0BAEC;AAFD,SAAgB,OAAO,CAAC,OAAe,EAAE,IAAY;IACnD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACrF,CAAC"}

package/lib/join-url.mjs

@@ -0,0 +1,4 @@
+export function joinURL(baseURL, path) {
+    return `${baseURL.replace(/\/+$/, '')}${path.startsWith('/') ? path : `/${path}`}`;
+}
+//# sourceMappingURL=join-url.mjs.map

package/lib/join-url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"join-url.mjs","sourceRoot":"","sources":["../src/lib/join-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,OAAe,EAAE,IAAY;IACnD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AACrF,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onkernel/sdk",
-  "version": "0.49.0",
+  "version": "0.52.0",
   "description": "The official TypeScript library for the Kernel API",
   "author": "Kernel <>",
   "types": "./index.d.ts",
@@ -95,6 +95,16 @@
     "./index.mjs": {
       "default": "./index.mjs"
     },
+    "./lib/*.mjs": {
+      "default": "./lib/*.mjs"
+    },
+    "./lib/*.js": {
+      "default": "./lib/*.js"
+    },
+    "./lib/*": {
+      "import": "./lib/*.mjs",
+      "require": "./lib/*.js"
+    },
     "./pagination": {
       "import": "./pagination.mjs",
       "require": "./pagination.js"

package/resources/auth/connections.d.mts

@@ -184,6 +184,12 @@ export interface ManagedAuth {
      * - Ping Identity: _.pingone.com, _.pingidentity.com
      */
     allowed_domains?: Array<string>;
+    /**
+     * ID of the underlying browser session driving the current flow (present when flow
+     * in progress). Use this to inspect or terminate the browser session via the
+     * `/browsers` API.
+     */
+    browser_session_id?: string | null;
     /**
      * Whether automatic re-authentication is possible (has credential, selectors, and
      * login_url)
@@ -219,7 +225,10 @@ export interface ManagedAuth {
      */
     external_action_message?: string | null;
     /**
-     * When the current flow expires (null when no flow in progress)
+     * When the current flow expires (null when no flow in progress). A flow past this
+     * timestamp is no longer valid and its `flow_status` will be `EXPIRED`. Clients
+     * may start a new login to supersede a stale `IN_PROGRESS` flow past this
+     * timestamp.
      */
     flow_expires_at?: string | null;
     /**
@@ -247,9 +256,19 @@ export interface ManagedAuth {
      */
     hosted_url?: string | null;
     /**
-     * When the profile was last successfully authenticated
+     * @deprecated Deprecated alias for `last_auth_check_at`. Despite the name, this is
+     * the last health-check timestamp, not the last successful authentication. Use
+     * `last_auth_check_at` instead.
      */
     last_auth_at?: string;
+    /**
+     * When the most recent auth health check ran for this connection, regardless of
+     * outcome. Updated on every health check and does not by itself indicate that the
+     * profile is currently authenticated - use `status` for that. May be newer than
+     * `flow_expires_at` when a flow is still in progress because health checks
+     * continue to run in parallel.
+     */
+    last_auth_check_at?: string;
     /**
      * Browser live view URL for debugging (present when flow in progress)
      */
@@ -336,6 +355,11 @@ export declare namespace ManagedAuth {
          * Field type
          */
         type: 'text' | 'email' | 'password' | 'tel' | 'number' | 'url' | 'code' | 'totp';
+        /**
+         * Contextual help text near the field that tells the user what to enter (e.g.,
+         * "Enter the phone ending in (**_) _**-\*\*92")
+         */
+        hint?: string;
         /**
          * If this field is associated with an MFA option, the type of that option (e.g.,
          * password field linked to "Enter password" option)
@@ -726,6 +750,11 @@ export declare namespace ConnectionFollowResponse {
              * Field type
              */
             type: 'text' | 'email' | 'password' | 'tel' | 'number' | 'url' | 'code' | 'totp';
+            /**
+             * Contextual help text near the field that tells the user what to enter (e.g.,
+             * "Enter the phone ending in (**_) _**-\*\*92")
+             */
+            hint?: string;
             /**
              * If this field is associated with an MFA option, the type of that option (e.g.,
              * password field linked to "Enter password" option)