@kubesense/kubesense-browser-rum-core 1.0.0

package/cjs/domain/resource/graphql.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractGraphQlMetadata = extractGraphQlMetadata;
+exports.parseGraphQlResponse = parseGraphQlResponse;
+exports.findGraphQlConfiguration = findGraphQlConfiguration;
+exports.extractGraphQlRequestMetadata = extractGraphQlRequestMetadata;
+const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
+/**
+ * arbitrary value, byte precision not needed
+ */
+const GRAPHQL_PAYLOAD_LIMIT = 32 * kubesense_browser_core_1.ONE_KIBI_BYTE;
+function extractGraphQlMetadata(request, graphQlConfig) {
+    const metadata = extractGraphQlRequestMetadata(request.requestBody, graphQlConfig.trackPayload);
+    if (!metadata) {
+        return;
+    }
+    if (graphQlConfig.trackResponseErrors && request.responseBody) {
+        const responseErrors = parseGraphQlResponse(request.responseBody);
+        if (responseErrors) {
+            metadata.error_count = responseErrors.length;
+            metadata.errors = responseErrors;
+        }
+    }
+    return metadata;
+}
+function parseGraphQlResponse(responseText) {
+    let response;
+    try {
+        response = JSON.parse(responseText);
+    }
+    catch (_a) {
+        // Invalid JSON response
+        return;
+    }
+    if (!response || typeof response !== 'object') {
+        return;
+    }
+    const responseObj = response;
+    if (!(0, kubesense_browser_core_1.isNonEmptyArray)(responseObj.errors)) {
+        return;
+    }
+    const errors = responseObj.errors.map((error) => {
+        var _a;
+        const graphqlError = {
+            message: error.message,
+            path: error.path,
+            locations: error.locations,
+            code: (_a = error.extensions) === null || _a === void 0 ? void 0 : _a.code,
+        };
+        return graphqlError;
+    });
+    return errors;
+}
+function findGraphQlConfiguration(url, configuration) {
+    return configuration.allowedGraphQlUrls.find((graphQlOption) => (0, kubesense_browser_core_1.matchList)([graphQlOption.match], url));
+}
+function extractGraphQlRequestMetadata(requestBody, trackPayload = false) {
+    if (!requestBody || typeof requestBody !== 'string') {
+        return;
+    }
+    let graphqlBody;
+    try {
+        graphqlBody = JSON.parse(requestBody);
+    }
+    catch (_a) {
+        // Not valid JSON
+        return;
+    }
+    if (!graphqlBody) {
+        return;
+    }
+    let operationType;
+    let payload;
+    if (graphqlBody.query) {
+        const trimmedQuery = graphqlBody.query.trim();
+        operationType = getOperationType(trimmedQuery);
+        if (trackPayload) {
+            payload = (0, kubesense_browser_core_1.safeTruncate)(trimmedQuery, GRAPHQL_PAYLOAD_LIMIT, '...');
+        }
+    }
+    const operationName = graphqlBody.operationName;
+    let variables;
+    if (graphqlBody.variables) {
+        variables = JSON.stringify(graphqlBody.variables);
+    }
+    return {
+        operationType,
+        operationName,
+        variables,
+        payload,
+    };
+}
+function getOperationType(query) {
+    var _a;
+    return (_a = query.match(/^\s*(query|mutation|subscription)\b/i)) === null || _a === void 0 ? void 0 : _a[1];
+}
+//# sourceMappingURL=graphql.js.map

package/cjs/domain/resource/graphql.js.map

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

package/cjs/domain/resource/matchRequestResourceEntry.d.ts

@@ -0,0 +1,16 @@
+import type { RumPerformanceResourceTiming } from '../../browser/performanceObservable';
+import type { RequestCompleteEvent } from '../requestCollection';
+/**
+ * Look for corresponding timing in resource timing buffer
+ *
+ * Observations:
+ * - Timing (start, end) are nested inside the request (start, end)
+ * - Some timing can be not exactly nested, being off by < 1 ms
+ *
+ * Strategy:
+ * - from valid nested entries (with 1 ms error margin)
+ * - filter out timing that were already matched to a request
+ * - then, if a single timing match, return the timing
+ * - otherwise we can't decide, return undefined
+ */
+export declare function matchRequestResourceEntry(request: RequestCompleteEvent): RumPerformanceResourceTiming | undefined;

package/cjs/domain/resource/matchRequestResourceEntry.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.matchRequestResourceEntry = matchRequestResourceEntry;
+const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
+const resourceUtils_1 = require("./resourceUtils");
+const alreadyMatchedEntries = new WeakSet();
+/**
+ * Look for corresponding timing in resource timing buffer
+ *
+ * Observations:
+ * - Timing (start, end) are nested inside the request (start, end)
+ * - Some timing can be not exactly nested, being off by < 1 ms
+ *
+ * Strategy:
+ * - from valid nested entries (with 1 ms error margin)
+ * - filter out timing that were already matched to a request
+ * - then, if a single timing match, return the timing
+ * - otherwise we can't decide, return undefined
+ */
+function matchRequestResourceEntry(request) {
+    if (!performance || !('getEntriesByName' in performance)) {
+        return;
+    }
+    const sameNameEntries = performance.getEntriesByName(request.url, 'resource');
+    if (!sameNameEntries.length || !('toJSON' in sameNameEntries[0])) {
+        return;
+    }
+    const candidates = sameNameEntries
+        .filter((entry) => !alreadyMatchedEntries.has(entry))
+        // Only require valid duration — needed for the isBetween time-window check.
+        // hasValidResourceEntryTimings is intentionally NOT used here: cached resources often have
+        // timing fields zeroed out (browser behaviour) even though their duration and start time
+        // are correct and the entry should still be matched to its request.
+        .filter((entry) => (0, resourceUtils_1.hasValidResourceEntryDuration)(entry))
+        .filter((entry) => isBetween(entry, request.startClocks.relative, endTime({ startTime: request.startClocks.relative, duration: request.duration })));
+    if (candidates.length === 1) {
+        alreadyMatchedEntries.add(candidates[0]);
+        return candidates[0].toJSON();
+    }
+    return;
+}
+function endTime(timing) {
+    return (0, kubesense_browser_core_1.addDuration)(timing.startTime, timing.duration);
+}
+function isBetween(timing, start, end) {
+    const errorMargin = 1;
+    return timing.startTime >= start - errorMargin && endTime(timing) <= (0, kubesense_browser_core_1.addDuration)(end, errorMargin);
+}
+//# sourceMappingURL=matchRequestResourceEntry.js.map

package/cjs/domain/resource/matchRequestResourceEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matchRequestResourceEntry.js","sourceRoot":"","sources":["../../../src/domain/resource/matchRequestResourceEntry.ts"],"names":[],"mappings":";;AA0BA,8DAgCC;AAzDD,8EAA+D;AAG/D,mDAA+D;AAO/D,MAAM,qBAAqB,GAAG,IAAI,OAAO,EAAoB,CAAA;AAE7D;;;;;;;;;;;;GAYG;AACH,SAAgB,yBAAyB,CAAC,OAA6B;IACrE,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,kBAAkB,IAAI,WAAW,CAAC,EAAE,CAAC;QACzD,OAAM;IACR,CAAC;IACD,MAAM,eAAe,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,UAAU,CAAmC,CAAA;IAE/G,IAAI,CAAC,eAAe,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,OAAM;IACR,CAAC;IAED,MAAM,UAAU,GAAG,eAAe;SAC/B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrD,4EAA4E;QAC5E,2FAA2F;QAC3F,yFAAyF;QACzF,oEAAoE;SACnE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAA,6CAA6B,EAAC,KAAK,CAAC,CAAC;SACvD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAChB,SAAS,CACP,KAAK,EACL,OAAO,CAAC,WAAW,CAAC,QAAQ,EAC5B,OAAO,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CACjF,CACF,CAAA;IAEH,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,qBAAqB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;QAExC,OAAO,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,EAAkC,CAAA;IAC/D,CAAC;IAED,OAAM;AACR,CAAC;AAED,SAAS,OAAO,CAAC,MAAc;IAC7B,OAAO,IAAA,oCAAW,EAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,MAAc,EAAE,KAAmB,EAAE,GAAiB;IACvE,MAAM,WAAW,GAAG,CAAa,CAAA;IACjC,OAAO,MAAM,CAAC,SAAS,IAAI,KAAK,GAAG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,IAAA,oCAAW,EAAC,GAAG,EAAE,WAAW,CAAC,CAAA;AACpG,CAAC"}

package/cjs/domain/resource/requestRegistry.d.ts

@@ -0,0 +1,9 @@
+import type { RumPerformanceResourceTiming } from '../../browser/performanceObservable';
+import type { LifeCycle } from '../lifeCycle';
+import type { RequestCompleteEvent } from '../requestCollection';
+export interface RequestRegistry {
+    getMatchingRequest(entry: RumPerformanceResourceTiming): RequestCompleteEvent | undefined;
+    stop(): void;
+}
+export declare const MAX_REQUESTS = 1000;
+export declare function createRequestRegistry(lifeCycle: LifeCycle): RequestRegistry;

package/cjs/domain/resource/requestRegistry.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_REQUESTS = void 0;
+exports.createRequestRegistry = createRequestRegistry;
+const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
+// Maximum number of requests to keep in the registry. Requests should be removed quite quickly in
+// general, this is just a safety limit to avoid memory leaks in case of a bug.
+exports.MAX_REQUESTS = 1000;
+function createRequestRegistry(lifeCycle) {
+    const requests = new Set();
+    const subscription = lifeCycle.subscribe(8 /* LifeCycleEventType.REQUEST_COMPLETED */, (request) => {
+        requests.add(request);
+        if (requests.size > exports.MAX_REQUESTS) {
+            // monitor-until: 2026-01-01, after early request collection GA
+            (0, kubesense_browser_core_1.addTelemetryDebug)('Too many requests');
+            requests.delete(requests.values().next().value);
+        }
+    });
+    return {
+        getMatchingRequest(entry) {
+            // Returns the closest request object that happened before the entry
+            let minTimeDifference = Infinity;
+            let closestRequest;
+            for (const request of requests) {
+                const timeDifference = entry.startTime - request.startClocks.relative;
+                if (0 <= timeDifference && timeDifference < minTimeDifference && request.url === entry.name) {
+                    minTimeDifference = Math.abs(timeDifference);
+                    closestRequest = request;
+                }
+            }
+            if (closestRequest) {
+                requests.delete(closestRequest);
+            }
+            return closestRequest;
+        },
+        stop() {
+            subscription.unsubscribe();
+        },
+    };
+}
+//# sourceMappingURL=requestRegistry.js.map

package/cjs/domain/resource/requestRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestRegistry.js","sourceRoot":"","sources":["../../../src/domain/resource/requestRegistry.ts"],"names":[],"mappings":";;;AAeA,sDAoCC;AAnDD,8EAAqE;AAWrE,kGAAkG;AAClG,+EAA+E;AAClE,QAAA,YAAY,GAAG,IAAI,CAAA;AAEhC,SAAgB,qBAAqB,CAAC,SAAoB;IACxD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAA;IAEhD,MAAM,YAAY,GAAG,SAAS,CAAC,SAAS,+CAAuC,CAAC,OAAO,EAAE,EAAE;QACzF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACrB,IAAI,QAAQ,CAAC,IAAI,GAAG,oBAAY,EAAE,CAAC;YACjC,+DAA+D;YAC/D,IAAA,0CAAiB,EAAC,mBAAmB,CAAC,CAAA;YACtC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAM,CAAC,CAAA;QAClD,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,kBAAkB,CAAC,KAAK;YACtB,oEAAoE;YACpE,IAAI,iBAAiB,GAAG,QAAQ,CAAA;YAChC,IAAI,cAAgD,CAAA;YACpD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,cAAc,GAAG,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAA;gBACrE,IAAI,CAAC,IAAI,cAAc,IAAI,cAAc,GAAG,iBAAiB,IAAI,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;oBAC5F,iBAAiB,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;oBAC5C,cAAc,GAAG,OAAO,CAAA;gBAC1B,CAAC;YACH,CAAC;YAED,IAAI,cAAc,EAAE,CAAC;gBACnB,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,CAAA;YACjC,CAAC;YAED,OAAO,cAAc,CAAA;QACvB,CAAC;QAED,IAAI;YACF,YAAY,CAAC,WAAW,EAAE,CAAA;QAC5B,CAAC;KACF,CAAA;AACH,CAAC"}

package/cjs/domain/resource/resourceCollection.d.ts

@@ -0,0 +1,7 @@
+import type { RumConfiguration } from '../configuration';
+import type { LifeCycle } from '../lifeCycle';
+import type { PageStateHistory } from '../contexts/pageStateHistory';
+import { retrieveInitialDocumentResourceTiming } from './retrieveInitialDocumentResourceTiming';
+export declare function startResourceCollection(lifeCycle: LifeCycle, configuration: RumConfiguration, pageStateHistory: PageStateHistory, taskQueue?: import("@kubesense/kubesense-browser-core").TaskQueue, retrieveInitialDocumentResourceTimingImpl?: typeof retrieveInitialDocumentResourceTiming): {
+    stop: () => void;
+};

package/cjs/domain/resource/resourceCollection.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startResourceCollection = startResourceCollection;
+const kubesense_browser_core_1 = require("@kubesense/kubesense-browser-core");
+const performanceObservable_1 = require("../../browser/performanceObservable");
+const rawRumEvent_types_1 = require("../../rawRumEvent.types");
+const identifier_1 = require("../tracing/identifier");
+const matchRequestResourceEntry_1 = require("./matchRequestResourceEntry");
+const resourceUtils_1 = require("./resourceUtils");
+const retrieveInitialDocumentResourceTiming_1 = require("./retrieveInitialDocumentResourceTiming");
+const requestRegistry_1 = require("./requestRegistry");
+const graphql_1 = require("./graphql");
+function startResourceCollection(lifeCycle, configuration, pageStateHistory, taskQueue = (0, kubesense_browser_core_1.createTaskQueue)(), retrieveInitialDocumentResourceTimingImpl = retrieveInitialDocumentResourceTiming_1.retrieveInitialDocumentResourceTiming) {
+    let requestRegistry;
+    const isEarlyRequestCollectionEnabled = configuration.trackEarlyRequests;
+    if (isEarlyRequestCollectionEnabled) {
+        requestRegistry = (0, requestRegistry_1.createRequestRegistry)(lifeCycle);
+    }
+    else {
+        lifeCycle.subscribe(8 /* LifeCycleEventType.REQUEST_COMPLETED */, (request) => {
+            handleResource(() => processRequest(request, configuration, pageStateHistory));
+        });
+    }
+    const performanceResourceSubscription = (0, performanceObservable_1.createPerformanceObservable)(configuration, {
+        type: performanceObservable_1.RumPerformanceEntryType.RESOURCE,
+        buffered: true,
+    }).subscribe((entries) => {
+        for (const entry of entries) {
+            if (isEarlyRequestCollectionEnabled || !(0, resourceUtils_1.isResourceEntryRequestType)(entry)) {
+                handleResource(() => processResourceEntry(entry, configuration, pageStateHistory, requestRegistry));
+            }
+        }
+    });
+    retrieveInitialDocumentResourceTimingImpl(configuration, (timing) => {
+        handleResource(() => processResourceEntry(timing, configuration, pageStateHistory, requestRegistry));
+    });
+    function handleResource(computeRawEvent) {
+        taskQueue.push(() => {
+            const rawEvent = computeRawEvent();
+            if (rawEvent) {
+                lifeCycle.notify(12 /* LifeCycleEventType.RAW_RUM_EVENT_COLLECTED */, rawEvent);
+            }
+        });
+    }
+    return {
+        stop: () => {
+            taskQueue.stop();
+            performanceResourceSubscription.unsubscribe();
+        },
+    };
+}
+function processRequest(request, configuration, pageStateHistory) {
+    const matchingTiming = (0, matchRequestResourceEntry_1.matchRequestResourceEntry)(request);
+    return assembleResource(matchingTiming, request, pageStateHistory, configuration);
+}
+function processResourceEntry(entry, configuration, pageStateHistory, requestRegistry) {
+    const matchingRequest = (0, resourceUtils_1.isResourceEntryRequestType)(entry) && requestRegistry ? requestRegistry.getMatchingRequest(entry) : undefined;
+    return assembleResource(entry, matchingRequest, pageStateHistory, configuration);
+}
+// TODO: In the future, the `entry` parameter should be required, making things simpler.
+function assembleResource(entry, request, pageStateHistory, configuration) {
+    if (!entry && !request) {
+        return;
+    }
+    const tracingInfo = request
+        ? computeRequestTracingInfo(request, configuration)
+        : computeResourceEntryTracingInfo(entry, configuration);
+    if (!configuration.trackResources && !tracingInfo) {
+        return;
+    }
+    const startClocks = entry ? (0, kubesense_browser_core_1.relativeToClocks)(entry.startTime) : request.startClocks;
+    const duration = entry
+        ? (0, resourceUtils_1.computeResourceEntryDuration)(entry)
+        : computeRequestDuration(pageStateHistory, startClocks, request.duration);
+    const graphql = request && computeGraphQlMetaData(request, configuration);
+    const resourceEvent = (0, kubesense_browser_core_1.combine)({
+        date: startClocks.timeStamp,
+        resource: {
+            id: (0, kubesense_browser_core_1.generateUUID)(),
+            duration: (0, kubesense_browser_core_1.toServerDuration)(duration),
+            // TODO: in the future when `entry` is required, we can probably only rely on `computeResourceEntryType`
+            type: request
+                ? request.type === kubesense_browser_core_1.RequestType.XHR
+                    ? kubesense_browser_core_1.ResourceType.XHR
+                    : kubesense_browser_core_1.ResourceType.FETCH
+                : (0, resourceUtils_1.computeResourceEntryType)(entry),
+            method: request ? request.method : undefined,
+            status_code: request ? request.status : discardZeroStatus(entry.responseStatus),
+            url: request ? (0, resourceUtils_1.sanitizeIfLongDataUrl)(request.url) : entry.name,
+            protocol: entry && (0, resourceUtils_1.computeResourceEntryProtocol)(entry),
+            delivery_type: entry && (0, resourceUtils_1.computeResourceEntryDeliveryType)(entry),
+            provider: (0, resourceUtils_1.computeResourceProvider)(request ? request.url : entry.name, configuration.firstPartyDomains),
+            graphql,
+        },
+        type: rawRumEvent_types_1.RumEventType.RESOURCE,
+        _kubesense: {
+            discarded: !configuration.trackResources,
+        },
+    }, tracingInfo, entry && computeResourceEntryMetrics(entry));
+    return {
+        startTime: startClocks.relative,
+        duration,
+        rawRumEvent: resourceEvent,
+        domainContext: getResourceDomainContext(entry, request),
+    };
+}
+function computeGraphQlMetaData(request, configuration) {
+    const graphQlConfig = (0, graphql_1.findGraphQlConfiguration)(request.url, configuration);
+    if (!graphQlConfig) {
+        return;
+    }
+    return (0, graphql_1.extractGraphQlMetadata)(request, graphQlConfig);
+}
+function getResourceDomainContext(entry, request) {
+    if (request) {
+        const baseDomainContext = {
+            performanceEntry: entry,
+            isAborted: request.isAborted,
+            handlingStack: request.handlingStack,
+        };
+        if (request.type === kubesense_browser_core_1.RequestType.XHR) {
+            return {
+                xhr: request.xhr,
+                ...baseDomainContext,
+            };
+        }
+        return {
+            requestInput: request.input,
+            requestInit: request.init,
+            response: request.response,
+            error: request.error,
+            ...baseDomainContext,
+        };
+    }
+    return {
+        // Currently, at least one of `entry` or `request` must be defined when calling this function.
+        // So `entry` is guaranteed to be defined here. In the future, when `entry` is required, we can
+        // remove the `!` assertion.
+        performanceEntry: entry,
+    };
+}
+function computeResourceEntryMetrics(entry) {
+    const { renderBlockingStatus } = entry;
+    return {
+        resource: {
+            render_blocking_status: renderBlockingStatus,
+            ...(0, resourceUtils_1.computeResourceEntrySize)(entry),
+            ...(0, resourceUtils_1.computeResourceEntryDetails)(entry),
+        },
+    };
+}
+function computeRequestTracingInfo(request, configuration) {
+    const hasBeenTraced = request.traceSampled && request.traceId && request.spanId;
+    if (!hasBeenTraced) {
+        return undefined;
+    }
+    return {
+        _kubesense: {
+            span_id: request.spanId.toString(),
+            trace_id: request.traceId.toString(),
+            rule_psr: configuration.rulePsr,
+        },
+    };
+}
+function computeResourceEntryTracingInfo(entry, configuration) {
+    const hasBeenTraced = entry.traceId;
+    if (!hasBeenTraced) {
+        return undefined;
+    }
+    return {
+        _kubesense: {
+            trace_id: entry.traceId,
+            span_id: (0, identifier_1.createSpanIdentifier)().toString(),
+            rule_psr: configuration.rulePsr,
+        },
+    };
+}
+function computeRequestDuration(pageStateHistory, startClocks, duration) {
+    return !pageStateHistory.wasInPageStateDuringPeriod("frozen" /* PageState.FROZEN */, startClocks.relative, duration)
+        ? duration
+        : undefined;
+}
+/**
+ * The status is 0 for cross-origin resources without CORS headers, so the status is meaningless, and we shouldn't report it
+ * https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/responseStatus#cross-origin_response_status_codes
+ */
+function discardZeroStatus(statusCode) {
+    return statusCode === 0 ? undefined : statusCode;
+}
+//# sourceMappingURL=resourceCollection.js.map

package/cjs/domain/resource/resourceCollection.js.map

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

package/cjs/domain/resource/resourceUtils.d.ts

@@ -0,0 +1,55 @@
+import type { Duration } from '@kubesense/kubesense-browser-core';
+import { ResourceType } from '@kubesense/kubesense-browser-core';
+import type { MatchOption } from '@kubesense/kubesense-browser-core';
+import type { RumPerformanceResourceTiming } from '../../browser/performanceObservable';
+import type { ResourceEntryDetailsElement, DeliveryType } from '../../rawRumEvent.types';
+export interface ResourceEntryDetails {
+    worker?: ResourceEntryDetailsElement;
+    redirect?: ResourceEntryDetailsElement;
+    dns?: ResourceEntryDetailsElement;
+    connect?: ResourceEntryDetailsElement;
+    ssl?: ResourceEntryDetailsElement;
+    first_byte?: ResourceEntryDetailsElement;
+    download?: ResourceEntryDetailsElement;
+}
+export declare const FAKE_INITIAL_DOCUMENT = "initial_document";
+export declare function computeResourceEntryType(entry: RumPerformanceResourceTiming): ResourceType;
+export declare function isResourceEntryRequestType(entry: RumPerformanceResourceTiming): boolean;
+export declare function computeResourceEntryDuration(entry: RumPerformanceResourceTiming): Duration;
+export declare function computeResourceEntryDetails(entry: RumPerformanceResourceTiming): ResourceEntryDetails | undefined;
+/**
+ * Entries with negative duration are unexpected and should be dismissed. The intake will ignore RUM
+ * Resource events with negative durations anyway.
+ * Since Chromium 128, more entries have unexpected negative durations, see
+ * https://issues.chromium.org/issues/363031537
+ */
+export declare function hasValidResourceEntryDuration(entry: RumPerformanceResourceTiming): boolean;
+export declare function hasValidResourceEntryTimings(entry: RumPerformanceResourceTiming): boolean;
+/**
+ * The 'nextHopProtocol' is an empty string for cross-origin resources without CORS headers,
+ * meaning the protocol is unknown, and we shouldn't report it.
+ * https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/nextHopProtocol#cross-origin_resources
+ */
+export declare function computeResourceEntryProtocol(entry: RumPerformanceResourceTiming): string | undefined;
+/**
+ * Handles the 'deliveryType' property to distinguish between supported values ('cache', 'navigational-prefetch'),
+ * undefined (unsupported in some browsers), and other cases ('other' for unknown or unrecognized values).
+ * see: https://developer.mozilla.org/en-US/docs/Web/API/PerformanceResourceTiming/deliveryType
+ */
+export declare function computeResourceEntryDeliveryType(entry: RumPerformanceResourceTiming): DeliveryType | undefined;
+export declare function computeResourceEntrySize(entry: RumPerformanceResourceTiming): {
+    size: number | undefined;
+    encoded_body_size: number | undefined;
+    decoded_body_size: number | undefined;
+    transfer_size: number | undefined;
+};
+export declare function isAllowedRequestUrl(url: string): boolean | "";
+type ProviderType = 'ad' | 'advertising' | 'analytics' | 'cdn' | 'content' | 'customer-success' | 'first party' | 'hosting' | 'marketing' | 'other' | 'social' | 'tag-manager' | 'utility' | 'video';
+export declare function computeResourceProvider(url: string, firstPartyDomains?: MatchOption[]): {
+    domain?: string;
+    name?: string;
+    type?: ProviderType;
+} | undefined;
+export declare const MAX_RESOURCE_VALUE_CHAR_LENGTH = 24000;
+export declare function sanitizeIfLongDataUrl(url: string, lengthLimit?: number): string;
+export {};