@paulirish/trace_engine 0.0.26 → 0.0.28

package/models/trace/lantern/simulation/simulation.d.ts

@@ -1,21 +1,6 @@
-/**
- * @license
- * Copyright 2024 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import { type AnyNetworkObject, type Simulation } from '../types/lantern.js';
-export { ConnectionPool } from './ConnectionPool.js';
-export { Constants } from './Constants.js';
-export { DNSCache } from './DNSCache.js';
-export { NetworkAnalyzer } from './NetworkAnalyzer.js';
-export { SimulatorTimingMap, type CompleteNodeTiming } from './SimulationTimingMap.js';
-export { Simulator } from './Simulator.js';
-export { TCPConnection } from './TCPConnection.js';
-export type MetricCoefficients = Simulation.MetricCoefficients;
-export type MetricComputationDataInput = Simulation.MetricComputationDataInput;
-export type NodeTiming = Simulation.NodeTiming;
-export type Options = Simulation.Options;
-export type ProcessedNavigation = Simulation.ProcessedNavigation;
-export type Result<T = AnyNetworkObject> = Simulation.Result<T>;
-export type Settings = Simulation.Settings;
-export type URL = Simulation.URL;
+export * from './ConnectionPool.js';
+export * from './Constants.js';
+export * from './DNSCache.js';
+export * from './SimulationTimingMap.js';
+export * from './Simulator.js';
+export * from './TCPConnection.js';

package/models/trace/lantern/simulation/simulation.js

@@ -1,11 +1,10 @@
 // Copyright 2024 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
-export { ConnectionPool } from './ConnectionPool.js';
-export { Constants } from './Constants.js';
-export { DNSCache } from './DNSCache.js';
-export { NetworkAnalyzer } from './NetworkAnalyzer.js';
-export { SimulatorTimingMap } from './SimulationTimingMap.js';
-export { Simulator } from './Simulator.js';
-export { TCPConnection } from './TCPConnection.js';
+export * from './ConnectionPool.js';
+export * from './Constants.js';
+export * from './DNSCache.js';
+export * from './SimulationTimingMap.js';
+export * from './Simulator.js';
+export * from './TCPConnection.js';
 //# sourceMappingURL=simulation.js.map

package/models/trace/lantern/simulation/simulation.js.map

@@ -1 +1 @@
-{"version":3,"file":"simulation.js","sourceRoot":"","sources":["../../../../../../../../front_end/models/trace/lantern/simulation/simulation.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAU7B,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AACvC,OAAO,EAAC,eAAe,EAAC,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAC,kBAAkB,EAA0B,MAAM,0BAA0B,CAAC;AACrF,OAAO,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\n/**\n * @license\n * Copyright 2024 Google LLC\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport {type AnyNetworkObject, type Simulation} from '../types/lantern.js';\n\nexport {ConnectionPool} from './ConnectionPool.js';\nexport {Constants} from './Constants.js';\nexport {DNSCache} from './DNSCache.js';\nexport {NetworkAnalyzer} from './NetworkAnalyzer.js';\nexport {SimulatorTimingMap, type CompleteNodeTiming} from './SimulationTimingMap.js';\nexport {Simulator} from './Simulator.js';\nexport {TCPConnection} from './TCPConnection.js';\n\nexport type MetricCoefficients = Simulation.MetricCoefficients;\nexport type MetricComputationDataInput = Simulation.MetricComputationDataInput;\nexport type NodeTiming = Simulation.NodeTiming;\nexport type Options = Simulation.Options;\nexport type ProcessedNavigation = Simulation.ProcessedNavigation;\nexport type Result<T = AnyNetworkObject> = Simulation.Result<T>;\nexport type Settings = Simulation.Settings;\nexport type URL = Simulation.URL;\n"]}
+{"version":3,"file":"simulation.js","sourceRoot":"","sources":["../../../../../../../../front_end/models/trace/lantern/simulation/simulation.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport * from './ConnectionPool.js';\nexport * from './Constants.js';\nexport * from './DNSCache.js';\nexport * from './SimulationTimingMap.js';\nexport * from './Simulator.js';\nexport * from './TCPConnection.js';\n"]}

package/models/trace/lantern/types/{lantern.d.ts → Lantern.d.ts}

@@ -1,6 +1,24 @@
 import type * as Protocol from '../../../../generated/protocol.js';
-import { type Node } from '../BaseNode.js';
-import { type Simulator } from '../simulation/Simulator.js';
+export declare const NetworkRequestTypes: {
+    readonly XHR: "XHR";
+    readonly Fetch: "Fetch";
+    readonly EventSource: "EventSource";
+    readonly Script: "Script";
+    readonly Stylesheet: "Stylesheet";
+    readonly Image: "Image";
+    readonly Media: "Media";
+    readonly Font: "Font";
+    readonly Document: "Document";
+    readonly TextTrack: "TextTrack";
+    readonly WebSocket: "WebSocket";
+    readonly Other: "Other";
+    readonly Manifest: "Manifest";
+    readonly SignedExchange: "SignedExchange";
+    readonly Ping: "Ping";
+    readonly Preflight: "Preflight";
+    readonly CSPViolationReport: "CSPViolationReport";
+    readonly Prefetch: "Prefetch";
+};
 export type TraceEvent = {
     name: string;
     args: {
@@ -24,7 +42,7 @@ export type Trace = {
     traceEvents: TraceEvent[];
 };
 export type ResourcePriority = ('VeryLow' | 'Low' | 'Medium' | 'High' | 'VeryHigh');
-export type ResourceType = ('Document' | 'Stylesheet' | 'Image' | 'Media' | 'Font' | 'Script' | 'TextTrack' | 'XHR' | 'Fetch' | 'Prefetch' | 'EventSource' | 'WebSocket' | 'Manifest' | 'SignedExchange' | 'Ping' | 'CSPViolationReport' | 'Preflight' | 'Other');
+export type ResourceType = keyof typeof NetworkRequestTypes;
 type InitiatorType = ('parser' | 'script' | 'preload' | 'SignedExchange' | 'preflight' | 'other');
 export type ResourceTiming = Protocol.Network.ResourceTiming;
 type CallStack = {
@@ -172,34 +190,10 @@ export declare namespace Simulation {
             largestContentfulPaint?: number;
         };
     }
-    interface MetricComputationDataInput {
-        simulator: Simulator;
-        graph: Node<unknown>;
-        processedNavigation: ProcessedNavigation;
-    }
-    interface MetricCoefficients {
-        intercept: number;
-        optimistic: number;
-        pessimistic: number;
-    }
     interface NodeTiming {
         startTime: number;
         endTime: number;
         duration: number;
     }
-    interface Result<T = AnyNetworkObject> {
-        timeInMs: number;
-        nodeTimings: Map<Node<T>, NodeTiming>;
-    }
-}
-export declare namespace Metrics {
-    interface Result<T = AnyNetworkObject> {
-        timing: number;
-        timestamp?: never;
-        optimisticEstimate: Simulation.Result<T>;
-        pessimisticEstimate: Simulation.Result<T>;
-        optimisticGraph: Node<T>;
-        pessimisticGraph: Node<T>;
-    }
 }
 export {};

package/models/trace/lantern/types/Lantern.js

@@ -0,0 +1,24 @@
+// Copyright 2024 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+export const NetworkRequestTypes = {
+    XHR: 'XHR',
+    Fetch: 'Fetch',
+    EventSource: 'EventSource',
+    Script: 'Script',
+    Stylesheet: 'Stylesheet',
+    Image: 'Image',
+    Media: 'Media',
+    Font: 'Font',
+    Document: 'Document',
+    TextTrack: 'TextTrack',
+    WebSocket: 'WebSocket',
+    Other: 'Other',
+    Manifest: 'Manifest',
+    SignedExchange: 'SignedExchange',
+    Ping: 'Ping',
+    Preflight: 'Preflight',
+    CSPViolationReport: 'CSPViolationReport',
+    Prefetch: 'Prefetch',
+};
+//# sourceMappingURL=Lantern.js.map

package/models/trace/lantern/types/Lantern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lantern.js","sourceRoot":"","sources":["../../../../../../../../front_end/models/trace/lantern/types/Lantern.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAI7B,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,WAAW,EAAE,aAAa;IAC1B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;IAChC,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,kBAAkB,EAAE,oBAAoB;IACxC,QAAQ,EAAE,UAAU;CACZ,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nimport type * as Protocol from '../../../../generated/protocol.js';\n\nexport const NetworkRequestTypes = {\n  XHR: 'XHR',\n  Fetch: 'Fetch',\n  EventSource: 'EventSource',\n  Script: 'Script',\n  Stylesheet: 'Stylesheet',\n  Image: 'Image',\n  Media: 'Media',\n  Font: 'Font',\n  Document: 'Document',\n  TextTrack: 'TextTrack',\n  WebSocket: 'WebSocket',\n  Other: 'Other',\n  Manifest: 'Manifest',\n  SignedExchange: 'SignedExchange',\n  Ping: 'Ping',\n  Preflight: 'Preflight',\n  CSPViolationReport: 'CSPViolationReport',\n  Prefetch: 'Prefetch',\n} as const;\n\nexport type TraceEvent = {\n  name: string,\n  args: {\n    name?: string,\n    data?: {\n      frame?: string,\n      readyState?: number,\n      stackTrace?: {\n        url: string,\n      }[],\n      url?: string,\n    },\n  },\n  pid: number,\n  tid: number,\n  /** Timestamp of the event in microseconds. */\n  ts: number,\n  dur: number,\n};\nexport type Trace = {\n  traceEvents: TraceEvent[],\n};\nexport type ResourcePriority = ('VeryLow'|'Low'|'Medium'|'High'|'VeryHigh');\nexport type ResourceType = keyof typeof NetworkRequestTypes;\ntype InitiatorType = ('parser'|'script'|'preload'|'SignedExchange'|'preflight'|'other');\nexport type ResourceTiming = Protocol.Network.ResourceTiming;\ntype CallStack = {\n  callFrames: Array<{\n    scriptId: string,\n    url: string,\n    lineNumber: number,\n    columnNumber: number,\n    functionName: string,\n  }>,\n  parent?: CallStack,\n};\n\nexport type ParsedURL = {\n  /**\n   * Equivalent to a `new URL(url).protocol` BUT w/o the trailing colon (:)\n   */\n  scheme: string,\n  /**\n   * Equivalent to a `new URL(url).hostname`\n   */\n  host: string,\n  securityOrigin: string,\n};\n\n// When Lantern NetworkRequests are constructed, the source-of-truth of the network record is given as `rawRequest`.\n// Internally Lantern doesn't care about the type of this field, so a default type is given to simplify internal code\n// by avoiding unnecessary typescript overhead.\n// If callers want to access the underlying network record, they are expected to make use of this generic on top-level\n// interfaces like Simulator.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyNetworkObject = any;\n\nexport type NetworkRequest<T = AnyNetworkObject> = {\n  requestId: string,\n  connectionId: number,\n  connectionReused: boolean,\n  url: string,\n  protocol: string,\n  parsedURL: ParsedURL,\n  documentURL: string,\n  /** When the renderer process initially discovers a network request, in milliseconds. */\n  rendererStartTime: number,\n  /**\n   * When the network service is about to handle a request, ie. just before going to the\n   * HTTP cache or going to the network for DNS/connection setup, in milliseconds.\n   */\n  networkRequestTime: number,\n  /**\n   * When the last byte of the response headers is received, in milliseconds.\n   * Equal to networkRequestTime if no data is recieved over the\n   * network (ex: cached requests or data urls).\n   */\n  responseHeadersEndTime: number,\n  /** When the last byte of the response body is received, in milliseconds. */\n  networkEndTime: number,\n  transferSize: number,\n  resourceSize: number,\n  fromDiskCache: boolean,\n  fromMemoryCache: boolean,\n  isLinkPreload: boolean,\n  finished: boolean,\n  failed: boolean,\n  statusCode: number,\n  /** The network request that redirected to this one */\n  redirectSource: NetworkRequest<T>|undefined,\n  /** The network request that this one redirected to */\n  redirectDestination: NetworkRequest<T>|undefined,\n  // TODO: can't use Protocol.Network.Initiator because of type mismatch in Lighthouse initiator.\n  initiator: {\n    type: InitiatorType,\n    url?: string,\n    stack?: CallStack,\n  },\n  initiatorRequest: NetworkRequest<T>|undefined,\n  /** The chain of network requests that redirected to this one */\n  redirects: NetworkRequest[]|undefined,\n  timing: Protocol.Network.ResourceTiming|undefined,\n  resourceType: ResourceType|undefined,\n  mimeType: string,\n  priority: ResourcePriority,\n  frameId: string|undefined,\n  fromWorker: boolean,\n  /**\n   * Optional value for how long the server took to respond to this request.\n   * When not provided, the server response time is derived from the timing object.\n   */\n  serverResponseTime?: number,\n  /**\n   * Implementation-specific canoncial data structure that this Lantern NetworkRequest\n   * was derived from.\n   * Users of Lantern create a NetworkRequest matching this interface,\n   * but can store the source-of-truth for their network model in this property.\n   * This is then accessible as a read-only property on NetworkNode.\n   */\n  rawRequest?: T,\n};\n\nexport namespace Simulation {\n  export interface URL {\n    /** URL of the initially requested URL */\n    requestedUrl?: string;\n    /** URL of the last document request */\n    mainDocumentUrl?: string;\n  }\n\n  /** Simulation settings that control the amount of network & cpu throttling in the run. */\n  export interface ThrottlingSettings {\n    /** The round trip time in milliseconds. */\n    rttMs?: number;\n    /** The network throughput in kilobits per second. */\n    throughputKbps?: number;\n    // devtools settings\n    /** The network request latency in milliseconds. */\n    requestLatencyMs?: number;\n    /** The network download throughput in kilobits per second. */\n    downloadThroughputKbps?: number;\n    /** The network upload throughput in kilobits per second. */\n    uploadThroughputKbps?: number;\n    // used by both\n    /** The amount of slowdown applied to the cpu (1/<cpuSlowdownMultiplier>). */\n    cpuSlowdownMultiplier?: number;\n  }\n\n  export interface PrecomputedLanternData {\n    additionalRttByOrigin: {[origin: string]: number};\n    serverResponseTimeByOrigin: {[origin: string]: number};\n  }\n\n  export interface Settings {\n    networkAnalysis: {\n      rtt: number,\n      additionalRttByOrigin: Map<string, number>,\n      serverResponseTimeByOrigin: Map<string, number>,\n      throughput: number,\n    };\n    /** The method used to throttle the network. */\n    throttlingMethod: 'devtools'|'simulate'|'provided';\n    /** The throttling config settings. */\n    throttling: Required<ThrottlingSettings>;\n    /** Precomputed lantern estimates to use instead of observed analysis. */\n    precomputedLanternData?: PrecomputedLanternData|null;\n  }\n\n  export interface Options {\n    rtt?: number;\n    throughput?: number;\n    observedThroughput: number;\n    maximumConcurrentRequests?: number;\n    cpuSlowdownMultiplier?: number;\n    layoutTaskMultiplier?: number;\n    additionalRttByOrigin?: Map<string, number>;\n    serverResponseTimeByOrigin?: Map<string, number>;\n  }\n\n  export interface ProcessedNavigation {\n    timestamps: {\n      firstContentfulPaint: number,\n      largestContentfulPaint?: number,\n    };\n  }\n\n  export interface NodeTiming {\n    startTime: number;\n    endTime: number;\n    duration: number;\n  }\n}\n"]}

package/models/trace/lantern/types/bundle-tsconfig.json

@@ -0,0 +1 @@
+{"compilerOptions":{"composite":true,"outDir":".","baseUrl":".","rootDir":"../../../../../../../../front_end/models/trace/lantern/types"},"files":["../../../../../../../../front_end/models/trace/lantern/types/types.ts"],"references":[{"path":"./types-tsconfig.json"}]}

package/models/trace/lantern/types/devtools_entrypoint-bundle-typescript-tsconfig.json

@@ -0,0 +1,42 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "composite": true,
+    "declaration": true,
+    "experimentalDecorators": true,
+    "forceConsistentCasingInFileNames": true,
+    "inlineSources": true,
+    "lib": [
+      "esnext",
+      "dom",
+      "dom.iterable"
+    ],
+    "module": "esnext",
+    "noEmitOnError": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": false,
+    "outDir": ".",
+    "rootDir": "../../../../../../../../front_end/models/trace/lantern/types",
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "esnext",
+    "tsBuildInfoFile": "devtools_entrypoint-bundle-typescript-tsconfig.json.tsbuildinfo",
+    "typeRoots": [],
+    "useUnknownInCatchVariables": false
+  },
+  "files": [
+    "../../../../../../../../front_end/models/trace/lantern/types/types.ts",
+    "../../../../../../../../front_end/legacy/legacy-defs.d.ts",
+    "../../../../../../../../front_end/global_typings/global_defs.d.ts",
+    "../../../../../../../../node_modules/@types/filesystem/index.d.ts"
+  ],
+  "references": [
+    {
+      "path": "./types-tsconfig.json"
+    }
+  ]
+}

package/models/trace/lantern/types/types-tsconfig.json

@@ -0,0 +1,42 @@
+{
+  "compilerOptions": {
+    "allowJs": true,
+    "checkJs": true,
+    "composite": true,
+    "declaration": true,
+    "experimentalDecorators": true,
+    "forceConsistentCasingInFileNames": true,
+    "inlineSources": true,
+    "lib": [
+      "esnext",
+      "dom",
+      "dom.iterable"
+    ],
+    "module": "esnext",
+    "noEmitOnError": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noUnusedLocals": false,
+    "outDir": ".",
+    "rootDir": "../../../../../../../../front_end/models/trace/lantern/types",
+    "skipLibCheck": true,
+    "sourceMap": true,
+    "strict": true,
+    "target": "esnext",
+    "tsBuildInfoFile": "types-tsconfig.json.tsbuildinfo",
+    "typeRoots": [],
+    "useUnknownInCatchVariables": false
+  },
+  "files": [
+    "../../../../../../../../front_end/models/trace/lantern/types/Lantern.ts",
+    "../../../../../../../../front_end/legacy/legacy-defs.d.ts",
+    "../../../../../../../../front_end/global_typings/global_defs.d.ts",
+    "../../../../../../../../node_modules/@types/filesystem/index.d.ts"
+  ],
+  "references": [
+    {
+      "path": "../../types/bundle-tsconfig.json"
+    }
+  ]
+}

package/models/trace/lantern/types/types.d.ts

@@ -0,0 +1 @@
+export * from './Lantern.js';

package/models/trace/lantern/types/{lantern.js → types.js}

@@ -1,5 +1,5 @@
 // Copyright 2024 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
-export {};
-//# sourceMappingURL=lantern.js.map
+export * from './Lantern.js';
+//# sourceMappingURL=types.js.map

package/models/trace/lantern/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../front_end/models/trace/lantern/types/types.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B;AAE7B,cAAc,cAAc,CAAC","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nexport * from './Lantern.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paulirish/trace_engine",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "description": "",
   "main": "models/trace/trace.js",
   "scripts": {

package/models/trace/lantern/types/lantern.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lantern.js","sourceRoot":"","sources":["../../../../../../../../front_end/models/trace/lantern/types/lantern.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,yEAAyE;AACzE,6BAA6B","sourcesContent":["// Copyright 2024 The Chromium Authors. All rights reserved.\n// Use of this source code is governed by a BSD-style license that can be\n// found in the LICENSE file.\n\nimport type * as Protocol from '../../../../generated/protocol.js';\nimport {type Node} from '../BaseNode.js';\nimport {type Simulator} from '../simulation/Simulator.js';\n\nexport type TraceEvent = {\n  name: string,\n  args: {\n    name?: string,\n    data?: {\n      frame?: string,\n      readyState?: number,\n      stackTrace?: {\n        url: string,\n      }[],\n      url?: string,\n    },\n  },\n  pid: number,\n  tid: number,\n  /** Timestamp of the event in microseconds. */\n  ts: number,\n  dur: number,\n};\nexport type Trace = {\n  traceEvents: TraceEvent[],\n};\nexport type ResourcePriority = ('VeryLow'|'Low'|'Medium'|'High'|'VeryHigh');\nexport type ResourceType =\n    ('Document'|'Stylesheet'|'Image'|'Media'|'Font'|'Script'|'TextTrack'|'XHR'|'Fetch'|'Prefetch'|'EventSource'|\n     'WebSocket'|'Manifest'|'SignedExchange'|'Ping'|'CSPViolationReport'|'Preflight'|'Other');\ntype InitiatorType = ('parser'|'script'|'preload'|'SignedExchange'|'preflight'|'other');\nexport type ResourceTiming = Protocol.Network.ResourceTiming;\ntype CallStack = {\n  callFrames: Array<{\n    scriptId: string,\n    url: string,\n    lineNumber: number,\n    columnNumber: number,\n    functionName: string,\n  }>,\n  parent?: CallStack,\n};\n\nexport type ParsedURL = {\n  /**\n   * Equivalent to a `new URL(url).protocol` BUT w/o the trailing colon (:)\n   */\n  scheme: string,\n  /**\n   * Equivalent to a `new URL(url).hostname`\n   */\n  host: string,\n  securityOrigin: string,\n};\n\n// When Lantern NetworkRequests are constructed, the source-of-truth of the network record is given as `rawRequest`.\n// Internally Lantern doesn't care about the type of this field, so a default type is given to simplify internal code\n// by avoiding unnecessary typescript overhead.\n// If callers want to access the underlying network record, they are expected to make use of this generic on top-level\n// interfaces like Simulator.\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyNetworkObject = any;\n\nexport type NetworkRequest<T = AnyNetworkObject> = {\n  requestId: string,\n  connectionId: number,\n  connectionReused: boolean,\n  url: string,\n  protocol: string,\n  parsedURL: ParsedURL,\n  documentURL: string,\n  /** When the renderer process initially discovers a network request, in milliseconds. */\n  rendererStartTime: number,\n  /**\n   * When the network service is about to handle a request, ie. just before going to the\n   * HTTP cache or going to the network for DNS/connection setup, in milliseconds.\n   */\n  networkRequestTime: number,\n  /**\n   * When the last byte of the response headers is received, in milliseconds.\n   * Equal to networkRequestTime if no data is recieved over the\n   * network (ex: cached requests or data urls).\n   */\n  responseHeadersEndTime: number,\n  /** When the last byte of the response body is received, in milliseconds. */\n  networkEndTime: number,\n  transferSize: number,\n  resourceSize: number,\n  fromDiskCache: boolean,\n  fromMemoryCache: boolean,\n  isLinkPreload: boolean,\n  finished: boolean,\n  failed: boolean,\n  statusCode: number,\n  /** The network request that redirected to this one */\n  redirectSource: NetworkRequest<T>|undefined,\n  /** The network request that this one redirected to */\n  redirectDestination: NetworkRequest<T>|undefined,\n  // TODO: can't use Protocol.Network.Initiator because of type mismatch in Lighthouse initiator.\n  initiator: {\n    type: InitiatorType,\n    url?: string,\n    stack?: CallStack,\n  },\n  initiatorRequest: NetworkRequest<T>|undefined,\n  /** The chain of network requests that redirected to this one */\n  redirects: NetworkRequest[]|undefined,\n  timing: Protocol.Network.ResourceTiming|undefined,\n  resourceType: ResourceType|undefined,\n  mimeType: string,\n  priority: ResourcePriority,\n  frameId: string|undefined,\n  fromWorker: boolean,\n  /**\n   * Optional value for how long the server took to respond to this request.\n   * When not provided, the server response time is derived from the timing object.\n   */\n  serverResponseTime?: number,\n  /**\n   * Implementation-specific canoncial data structure that this Lantern NetworkRequest\n   * was derived from.\n   * Users of Lantern create a NetworkRequest matching this interface,\n   * but can store the source-of-truth for their network model in this property.\n   * This is then accessible as a read-only property on NetworkNode.\n   */\n  rawRequest?: T,\n};\n\nexport namespace Simulation {\n  export interface URL {\n    /** URL of the initially requested URL */\n    requestedUrl?: string;\n    /** URL of the last document request */\n    mainDocumentUrl?: string;\n  }\n\n  /** Simulation settings that control the amount of network & cpu throttling in the run. */\n  export interface ThrottlingSettings {\n    /** The round trip time in milliseconds. */\n    rttMs?: number;\n    /** The network throughput in kilobits per second. */\n    throughputKbps?: number;\n    // devtools settings\n    /** The network request latency in milliseconds. */\n    requestLatencyMs?: number;\n    /** The network download throughput in kilobits per second. */\n    downloadThroughputKbps?: number;\n    /** The network upload throughput in kilobits per second. */\n    uploadThroughputKbps?: number;\n    // used by both\n    /** The amount of slowdown applied to the cpu (1/<cpuSlowdownMultiplier>). */\n    cpuSlowdownMultiplier?: number;\n  }\n\n  export interface PrecomputedLanternData {\n    additionalRttByOrigin: {[origin: string]: number};\n    serverResponseTimeByOrigin: {[origin: string]: number};\n  }\n\n  export interface Settings {\n    networkAnalysis: {\n      rtt: number,\n      additionalRttByOrigin: Map<string, number>,\n      serverResponseTimeByOrigin: Map<string, number>,\n      throughput: number,\n    };\n    /** The method used to throttle the network. */\n    throttlingMethod: 'devtools'|'simulate'|'provided';\n    /** The throttling config settings. */\n    throttling: Required<ThrottlingSettings>;\n    /** Precomputed lantern estimates to use instead of observed analysis. */\n    precomputedLanternData?: PrecomputedLanternData|null;\n  }\n\n  export interface Options {\n    rtt?: number;\n    throughput?: number;\n    observedThroughput: number;\n    maximumConcurrentRequests?: number;\n    cpuSlowdownMultiplier?: number;\n    layoutTaskMultiplier?: number;\n    additionalRttByOrigin?: Map<string, number>;\n    serverResponseTimeByOrigin?: Map<string, number>;\n  }\n\n  export interface ProcessedNavigation {\n    timestamps: {\n      firstContentfulPaint: number,\n      largestContentfulPaint?: number,\n    };\n  }\n\n  export interface MetricComputationDataInput {\n    simulator: Simulator;\n    graph: Node<unknown>;\n    processedNavigation: ProcessedNavigation;\n  }\n\n  export interface MetricCoefficients {\n    intercept: number;\n    optimistic: number;\n    pessimistic: number;\n  }\n\n  export interface NodeTiming {\n    startTime: number;\n    endTime: number;\n    duration: number;\n  }\n\n  export interface Result<T = AnyNetworkObject> {\n    timeInMs: number;\n    nodeTimings: Map<Node<T>, NodeTiming>;\n  }\n}\n\nexport namespace Metrics {\n  export interface Result<T = AnyNetworkObject> {\n    timing: number;\n    timestamp?: never;\n    optimisticEstimate: Simulation.Result<T>;\n    pessimisticEstimate: Simulation.Result<T>;\n    optimisticGraph: Node<T>;\n    pessimisticGraph: Node<T>;\n  }\n}\n"]}