@depup/apollo__server 5.5.0-depup.0

package/dist/esm/plugin/usageReporting/plugin.js

@@ -0,0 +1,487 @@
+import { Report, ReportHeader, Trace } from '@apollo/usage-reporting-protobuf';
+import { usageReportingSignature, calculateReferencedFieldsByType, } from '@apollo/utils.usagereporting';
+import retry from 'async-retry';
+import { printSchema } from 'graphql';
+import os from 'os';
+import { gzip } from 'zlib';
+import { internalPlugin } from '../../internalPlugin.js';
+import { dateToProtoTimestamp, TraceTreeBuilder } from '../traceTreeBuilder.js';
+import { defaultSendOperationsAsTrace } from './defaultSendOperationsAsTrace.js';
+import { createOperationDerivedDataCache, operationDerivedDataCacheKey, } from './operationDerivedDataCache.js';
+import { OurReport } from './stats.js';
+import { makeTraceDetails } from './traceDetails.js';
+import { packageVersion } from '../../generated/packageVersion.js';
+import { computeCoreSchemaHash } from '../../utils/computeCoreSchemaHash.js';
+import { schemaIsSubgraph } from '../schemaIsSubgraph.js';
+const reportHeaderDefaults = {
+    hostname: os.hostname(),
+    agentVersion: `@apollo/server@${packageVersion}`,
+    runtimeVersion: `node ${process.version}`,
+    uname: `${os.platform()}, ${os.type()}, ${os.release()}, ${os.arch()})`,
+};
+export function ApolloServerPluginUsageReporting(options = Object.create(null)) {
+    const fieldLevelInstrumentationOption = options.fieldLevelInstrumentation;
+    const fieldLevelInstrumentation = typeof fieldLevelInstrumentationOption === 'number'
+        ? async () => Math.random() < fieldLevelInstrumentationOption
+            ? 1 / fieldLevelInstrumentationOption
+            : 0
+        : fieldLevelInstrumentationOption
+            ? fieldLevelInstrumentationOption
+            : async () => true;
+    let requestDidStartHandler = null;
+    return internalPlugin({
+        __internal_plugin_id__: 'UsageReporting',
+        __is_disabled_plugin__: false,
+        async requestDidStart(requestContext) {
+            if (requestDidStartHandler) {
+                return requestDidStartHandler(requestContext);
+            }
+            return {};
+        },
+        async serverWillStart({ logger: serverLogger, apollo, startedInBackground, schema, }) {
+            const logger = options.logger ?? serverLogger;
+            const { key, graphRef } = apollo;
+            if (!(key && graphRef)) {
+                throw new Error("You've enabled usage reporting via ApolloServerPluginUsageReporting, " +
+                    'but you also need to provide your Apollo API key and graph ref, via ' +
+                    'the APOLLO_KEY/APOLLO_GRAPH_REF environment ' +
+                    'variables or via `new ApolloServer({apollo: {key, graphRef})`.');
+            }
+            if (schemaIsSubgraph(schema)) {
+                if (options.__onlyIfSchemaIsNotSubgraph) {
+                    logger.warn('You have specified an Apollo API key and graph ref but this server appears ' +
+                        'to be a subgraph. Typically usage reports are sent to Apollo by your Router ' +
+                        'or Gateway, not directly from your subgraph; usage reporting is disabled. To ' +
+                        'enable usage reporting anyway, explicitly install `ApolloServerPluginUsageReporting`. ' +
+                        'To disable this warning, install `ApolloServerPluginUsageReportingDisabled`.');
+                    return {};
+                }
+                else {
+                    logger.warn('You have installed `ApolloServerPluginUsageReporting` but this server appears to ' +
+                        'be a subgraph. Typically usage reports are sent to Apollo by your Router ' +
+                        'or Gateway, not directly from your subgraph. If this was unintentional, remove ' +
+                        "`ApolloServerPluginUsageReporting` from your server's `plugins` array.");
+                }
+            }
+            logger.info('Apollo usage reporting starting! See your graph at ' +
+                `https://studio.apollographql.com/graph/${encodeURI(graphRef)}/`);
+            const sendReportsImmediately = options.sendReportsImmediately ?? startedInBackground;
+            let operationDerivedDataCache = null;
+            const reportByExecutableSchemaId = new Map();
+            const getReportWhichMustBeUsedImmediately = (executableSchemaId) => {
+                const existing = reportByExecutableSchemaId.get(executableSchemaId);
+                if (existing) {
+                    return existing;
+                }
+                const report = new OurReport(new ReportHeader({
+                    ...reportHeaderDefaults,
+                    executableSchemaId,
+                    graphRef,
+                }));
+                reportByExecutableSchemaId.set(executableSchemaId, report);
+                return report;
+            };
+            const getAndDeleteReport = (executableSchemaId) => {
+                const report = reportByExecutableSchemaId.get(executableSchemaId);
+                if (report) {
+                    reportByExecutableSchemaId.delete(executableSchemaId);
+                    return report;
+                }
+                return null;
+            };
+            const overriddenExecutableSchemaId = options.overrideReportedSchema
+                ? computeCoreSchemaHash(options.overrideReportedSchema)
+                : undefined;
+            let lastSeenExecutableSchemaToId;
+            let reportTimer;
+            if (!sendReportsImmediately) {
+                reportTimer = setInterval(() => sendAllReportsAndReportErrors(), options.reportIntervalMs || 10 * 1000);
+            }
+            let sendTraces = options.sendTraces ?? true;
+            const sendOperationAsTrace = options.experimental_sendOperationAsTrace ??
+                defaultSendOperationsAsTrace();
+            let stopped = false;
+            function executableSchemaIdForSchema(schema) {
+                if (lastSeenExecutableSchemaToId?.executableSchema === schema) {
+                    return lastSeenExecutableSchemaToId.executableSchemaId;
+                }
+                const id = computeCoreSchemaHash(printSchema(schema));
+                lastSeenExecutableSchemaToId = {
+                    executableSchema: schema,
+                    executableSchemaId: id,
+                };
+                return id;
+            }
+            async function sendAllReportsAndReportErrors() {
+                await Promise.all([...reportByExecutableSchemaId.keys()].map((executableSchemaId) => sendReportAndReportErrors(executableSchemaId)));
+            }
+            async function sendReportAndReportErrors(executableSchemaId) {
+                return sendReport(executableSchemaId).catch((err) => {
+                    if (options.reportErrorFunction) {
+                        options.reportErrorFunction(err);
+                    }
+                    else {
+                        logger.error(err.message);
+                    }
+                });
+            }
+            const sendReport = async (executableSchemaId) => {
+                let report = getAndDeleteReport(executableSchemaId);
+                if (!report ||
+                    (Object.keys(report.tracesPerQuery).length === 0 &&
+                        report.operationCount === 0)) {
+                    return;
+                }
+                report.endTime = dateToProtoTimestamp(new Date());
+                report.ensureCountsAreIntegers();
+                const protobufError = Report.verify(report);
+                if (protobufError) {
+                    throw new Error(`Error verifying report: ${protobufError}`);
+                }
+                let message = Report.encode(report).finish();
+                report = null;
+                if (options.debugPrintReports) {
+                    const decodedReport = Report.decode(message);
+                    logger.info(`Apollo usage report: ${JSON.stringify(decodedReport.toJSON())}`);
+                }
+                const compressed = await new Promise((resolve, reject) => {
+                    gzip(message, (error, result) => {
+                        error ? reject(error) : resolve(result);
+                    });
+                });
+                message = null;
+                const fetcher = options.fetcher ?? fetch;
+                const response = await retry(async () => {
+                    const curResponse = await fetcher((options.endpointUrl ||
+                        'https://usage-reporting.api.apollographql.com') +
+                        '/api/ingress/traces', {
+                        method: 'POST',
+                        headers: {
+                            'user-agent': 'ApolloServerPluginUsageReporting',
+                            'x-api-key': key,
+                            'content-encoding': 'gzip',
+                            accept: 'application/json',
+                        },
+                        body: compressed,
+                        signal: AbortSignal.timeout(options.requestTimeoutMs ?? 30_000),
+                    });
+                    if (curResponse.status >= 500 && curResponse.status < 600) {
+                        throw new Error(`HTTP status ${curResponse.status}, ${(await curResponse.text()) || '(no body)'}`);
+                    }
+                    else {
+                        return curResponse;
+                    }
+                }, {
+                    retries: (options.maxAttempts || 5) - 1,
+                    minTimeout: options.minimumRetryDelayMs || 100,
+                    factor: 2,
+                }).catch((err) => {
+                    throw new Error(`Error sending report to Apollo servers: ${err.message}`);
+                });
+                if (response.status < 200 || response.status >= 300) {
+                    throw new Error(`Error sending report to Apollo servers: HTTP status ${response.status}, ${(await response.text()) || '(no body)'}`);
+                }
+                if (sendTraces &&
+                    response.status === 200 &&
+                    response.headers
+                        .get('content-type')
+                        ?.match(/^\s*application\/json\s*(?:;|$)/i)) {
+                    const body = await response.text();
+                    let parsedBody;
+                    try {
+                        parsedBody = JSON.parse(body);
+                    }
+                    catch (e) {
+                        throw new Error(`Error parsing response from Apollo servers: ${e}`);
+                    }
+                    if (parsedBody.tracesIgnored === true) {
+                        logger.debug("This graph's organization does not have access to traces; sending all " +
+                            'subsequent operations as stats.');
+                        sendTraces = false;
+                    }
+                }
+                if (options.debugPrintReports) {
+                    logger.info(`Apollo usage report: status ${response.status}`);
+                }
+            };
+            requestDidStartHandler = ({ metrics, schema, request: { http, variables }, }) => {
+                const treeBuilder = new TraceTreeBuilder({
+                    maskedBy: 'ApolloServerPluginUsageReporting',
+                    sendErrors: options.sendErrors,
+                });
+                treeBuilder.startTiming();
+                metrics.startHrTime = treeBuilder.startHrTime;
+                let graphqlValidationFailure = false;
+                let graphqlUnknownOperationName = false;
+                let includeOperationInUsageReporting = null;
+                if (http) {
+                    treeBuilder.trace.http = new Trace.HTTP({
+                        method: Trace.HTTP.Method[http.method] || Trace.HTTP.Method.UNKNOWN,
+                    });
+                    if (options.sendHeaders) {
+                        makeHTTPRequestHeaders(treeBuilder.trace.http, http.headers, options.sendHeaders);
+                    }
+                }
+                async function maybeCallIncludeRequestHook(requestContext) {
+                    if (includeOperationInUsageReporting !== null)
+                        return;
+                    if (typeof options.includeRequest !== 'function') {
+                        includeOperationInUsageReporting = true;
+                        return;
+                    }
+                    includeOperationInUsageReporting =
+                        await options.includeRequest(requestContext);
+                    if (typeof includeOperationInUsageReporting !== 'boolean') {
+                        logger.warn("The 'includeRequest' async predicate function must return a boolean value.");
+                        includeOperationInUsageReporting = true;
+                    }
+                }
+                let didResolveSource = false;
+                return {
+                    async didResolveSource(requestContext) {
+                        didResolveSource = true;
+                        if (metrics.persistedQueryHit) {
+                            treeBuilder.trace.persistedQueryHit = true;
+                        }
+                        if (metrics.persistedQueryRegister) {
+                            treeBuilder.trace.persistedQueryRegister = true;
+                        }
+                        if (variables) {
+                            treeBuilder.trace.details = makeTraceDetails(variables, options.sendVariableValues, requestContext.source);
+                        }
+                        const clientInfo = (options.generateClientInfo || defaultGenerateClientInfo)(requestContext);
+                        if (clientInfo) {
+                            const { clientName, clientVersion } = clientInfo;
+                            treeBuilder.trace.clientVersion = clientVersion || '';
+                            treeBuilder.trace.clientName = clientName || '';
+                        }
+                    },
+                    async validationDidStart() {
+                        return async (validationErrors) => {
+                            graphqlValidationFailure = validationErrors
+                                ? validationErrors.length !== 0
+                                : false;
+                        };
+                    },
+                    async didResolveOperation(requestContext) {
+                        graphqlUnknownOperationName =
+                            requestContext.operation === undefined;
+                        await maybeCallIncludeRequestHook(requestContext);
+                        if (includeOperationInUsageReporting &&
+                            !graphqlUnknownOperationName) {
+                            if (metrics.captureTraces === undefined) {
+                                const rawWeight = await fieldLevelInstrumentation(requestContext);
+                                treeBuilder.trace.fieldExecutionWeight =
+                                    typeof rawWeight === 'number' ? rawWeight : rawWeight ? 1 : 0;
+                                metrics.captureTraces =
+                                    !!treeBuilder.trace.fieldExecutionWeight;
+                            }
+                        }
+                    },
+                    async executionDidStart() {
+                        if (!metrics.captureTraces)
+                            return;
+                        return {
+                            willResolveField({ info }) {
+                                return treeBuilder.willResolveField(info);
+                            },
+                        };
+                    },
+                    async didEncounterSubsequentErrors(_requestContext, errors) {
+                        treeBuilder.didEncounterErrors(errors);
+                    },
+                    async willSendSubsequentPayload(requestContext, payload) {
+                        if (!payload.hasNext) {
+                            await operationFinished(requestContext);
+                        }
+                    },
+                    async willSendResponse(requestContext) {
+                        if (!didResolveSource)
+                            return;
+                        if (requestContext.errors) {
+                            treeBuilder.didEncounterErrors(requestContext.errors);
+                        }
+                        if (requestContext.response.body.kind === 'single') {
+                            await operationFinished(requestContext);
+                        }
+                    },
+                };
+                async function operationFinished(requestContext) {
+                    const resolvedOperation = !!requestContext.operation;
+                    await maybeCallIncludeRequestHook(requestContext);
+                    treeBuilder.stopTiming();
+                    const executableSchemaId = overriddenExecutableSchemaId ?? executableSchemaIdForSchema(schema);
+                    if (includeOperationInUsageReporting === false) {
+                        if (resolvedOperation) {
+                            getReportWhichMustBeUsedImmediately(executableSchemaId)
+                                .operationCount++;
+                        }
+                        return;
+                    }
+                    treeBuilder.trace.fullQueryCacheHit = !!metrics.responseCacheHit;
+                    treeBuilder.trace.forbiddenOperation = !!metrics.forbiddenOperation;
+                    treeBuilder.trace.registeredOperation = !!metrics.registeredOperation;
+                    const policyIfCacheable = requestContext.overallCachePolicy.policyIfCacheable();
+                    if (policyIfCacheable) {
+                        treeBuilder.trace.cachePolicy = new Trace.CachePolicy({
+                            scope: policyIfCacheable.scope === 'PRIVATE'
+                                ? Trace.CachePolicy.Scope.PRIVATE
+                                : policyIfCacheable.scope === 'PUBLIC'
+                                    ? Trace.CachePolicy.Scope.PUBLIC
+                                    : Trace.CachePolicy.Scope.UNKNOWN,
+                            maxAgeNs: policyIfCacheable.maxAge * 1e9,
+                        });
+                    }
+                    if (metrics.queryPlanTrace) {
+                        treeBuilder.trace.queryPlan = metrics.queryPlanTrace;
+                    }
+                    addTrace().catch(logger.error.bind(logger));
+                    async function addTrace() {
+                        if (stopped) {
+                            return;
+                        }
+                        await new Promise((res) => setImmediate(res));
+                        const executableSchemaId = overriddenExecutableSchemaId ??
+                            executableSchemaIdForSchema(schema);
+                        const { trace } = treeBuilder;
+                        let statsReportKey = undefined;
+                        let referencedFieldsByType;
+                        if (!requestContext.document) {
+                            statsReportKey = `## GraphQLParseFailure\n`;
+                        }
+                        else if (graphqlValidationFailure) {
+                            statsReportKey = `## GraphQLValidationFailure\n`;
+                        }
+                        else if (graphqlUnknownOperationName) {
+                            statsReportKey = `## GraphQLUnknownOperationName\n`;
+                        }
+                        const isExecutable = statsReportKey === undefined;
+                        if (statsReportKey) {
+                            if (options.sendUnexecutableOperationDocuments) {
+                                trace.unexecutedOperationBody = requestContext.source;
+                                trace.unexecutedOperationName =
+                                    requestContext.request.operationName || '';
+                            }
+                            referencedFieldsByType = Object.create(null);
+                        }
+                        else {
+                            const operationDerivedData = getOperationDerivedData();
+                            statsReportKey = `# ${requestContext.operationName || '-'}\n${operationDerivedData.signature}`;
+                            referencedFieldsByType =
+                                operationDerivedData.referencedFieldsByType;
+                        }
+                        const protobufError = Trace.verify(trace);
+                        if (protobufError) {
+                            throw new Error(`Error encoding trace: ${protobufError}`);
+                        }
+                        if (resolvedOperation) {
+                            getReportWhichMustBeUsedImmediately(executableSchemaId)
+                                .operationCount++;
+                        }
+                        getReportWhichMustBeUsedImmediately(executableSchemaId).addTrace({
+                            statsReportKey,
+                            trace,
+                            asTrace: sendTraces &&
+                                (!isExecutable || !!metrics.captureTraces) &&
+                                !metrics.nonFtv1ErrorPaths?.length &&
+                                sendOperationAsTrace(trace, statsReportKey),
+                            referencedFieldsByType,
+                            nonFtv1ErrorPaths: metrics.nonFtv1ErrorPaths ?? [],
+                        });
+                        if (sendReportsImmediately ||
+                            getReportWhichMustBeUsedImmediately(executableSchemaId)
+                                .sizeEstimator.bytes >=
+                                (options.maxUncompressedReportSize || 4 * 1024 * 1024)) {
+                            await sendReportAndReportErrors(executableSchemaId);
+                        }
+                    }
+                    function getOperationDerivedData() {
+                        if (!requestContext.document) {
+                            throw new Error('No document?');
+                        }
+                        const cacheKey = operationDerivedDataCacheKey(requestContext.queryHash, requestContext.operationName || '');
+                        if (!operationDerivedDataCache ||
+                            operationDerivedDataCache.forSchema !== schema) {
+                            operationDerivedDataCache = {
+                                forSchema: schema,
+                                cache: createOperationDerivedDataCache({ logger }),
+                            };
+                        }
+                        const cachedOperationDerivedData = operationDerivedDataCache.cache.get(cacheKey);
+                        if (cachedOperationDerivedData) {
+                            return cachedOperationDerivedData;
+                        }
+                        const generatedSignature = (options.calculateSignature || usageReportingSignature)(requestContext.document, requestContext.operationName || '');
+                        const generatedOperationDerivedData = {
+                            signature: generatedSignature,
+                            referencedFieldsByType: calculateReferencedFieldsByType({
+                                document: requestContext.document,
+                                schema,
+                                resolvedOperationName: requestContext.operationName ?? null,
+                            }),
+                        };
+                        operationDerivedDataCache.cache.set(cacheKey, generatedOperationDerivedData);
+                        return generatedOperationDerivedData;
+                    }
+                }
+            };
+            return {
+                async serverWillStop() {
+                    if (reportTimer) {
+                        clearInterval(reportTimer);
+                        reportTimer = undefined;
+                    }
+                    stopped = true;
+                    await sendAllReportsAndReportErrors();
+                },
+            };
+        },
+    });
+}
+export function makeHTTPRequestHeaders(http, headers, sendHeaders) {
+    if (!sendHeaders ||
+        ('none' in sendHeaders && sendHeaders.none) ||
+        ('all' in sendHeaders && !sendHeaders.all)) {
+        return;
+    }
+    for (const [key, value] of headers) {
+        if (('exceptNames' in sendHeaders &&
+            sendHeaders.exceptNames.some((exceptHeader) => {
+                return exceptHeader.toLowerCase() === key;
+            })) ||
+            ('onlyNames' in sendHeaders &&
+                !sendHeaders.onlyNames.some((header) => {
+                    return header.toLowerCase() === key;
+                }))) {
+            continue;
+        }
+        switch (key) {
+            case 'authorization':
+            case 'cookie':
+            case 'set-cookie':
+                break;
+            default:
+                http.requestHeaders[key] = new Trace.HTTP.Values({
+                    value: [value],
+                });
+        }
+    }
+}
+function defaultGenerateClientInfo({ request, }) {
+    const clientNameHeaderKey = 'apollographql-client-name';
+    const clientVersionHeaderKey = 'apollographql-client-version';
+    if (request.http?.headers?.get(clientNameHeaderKey) ||
+        request.http?.headers?.get(clientVersionHeaderKey)) {
+        return {
+            clientName: request.http?.headers?.get(clientNameHeaderKey),
+            clientVersion: request.http?.headers?.get(clientVersionHeaderKey),
+        };
+    }
+    else if (request.extensions?.clientInfo) {
+        return request.extensions.clientInfo;
+    }
+    else {
+        return {};
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/esm/plugin/usageReporting/plugin.js.map

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

package/dist/esm/plugin/usageReporting/stats.d.ts

@@ -0,0 +1,96 @@
+import type { NonFtv1ErrorPath } from '@apollo/server-gateway-interface';
+import { type google, type IContextualizedStats, type IFieldStat, type IPathErrorStats, type IQueryLatencyStats, type IReport, type IStatsContext, type ITracesAndStats, type ITypeStat, type ReportHeader, Trace } from '@apollo/usage-reporting-protobuf';
+import type { ReferencedFieldsByType } from '@apollo/utils.usagereporting';
+import { DurationHistogram } from './durationHistogram.js';
+export declare class SizeEstimator {
+    bytes: number;
+}
+export declare class OurReport implements Required<IReport> {
+    readonly header: ReportHeader;
+    tracesPreAggregated: boolean;
+    constructor(header: ReportHeader);
+    readonly tracesPerQuery: Record<string, OurTracesAndStats>;
+    endTime: google.protobuf.ITimestamp | null;
+    operationCount: number;
+    readonly sizeEstimator: SizeEstimator;
+    ensureCountsAreIntegers(): void;
+    addTrace({ statsReportKey, trace, asTrace, referencedFieldsByType, maxTraceBytes, nonFtv1ErrorPaths, }: {
+        statsReportKey: string;
+        trace: Trace;
+        asTrace: boolean;
+        referencedFieldsByType: ReferencedFieldsByType;
+        maxTraceBytes?: number;
+        nonFtv1ErrorPaths: NonFtv1ErrorPath[];
+    }): void;
+    private getTracesAndStats;
+}
+declare class OurTracesAndStats implements Required<ITracesAndStats> {
+    readonly referencedFieldsByType: ReferencedFieldsByType;
+    constructor(referencedFieldsByType: ReferencedFieldsByType);
+    readonly trace: Uint8Array[];
+    readonly statsWithContext: StatsByContext;
+    readonly internalTracesContributingToStats: Uint8Array[];
+    ensureCountsAreIntegers(): void;
+}
+declare class StatsByContext {
+    readonly map: {
+        [k: string]: OurContextualizedStats;
+    };
+    toArray(): IContextualizedStats[];
+    ensureCountsAreIntegers(): void;
+    addTrace(trace: Trace, sizeEstimator: SizeEstimator, nonFtv1ErrorPaths: NonFtv1ErrorPath[]): void;
+    private getContextualizedStats;
+}
+export declare class OurContextualizedStats implements Required<IContextualizedStats> {
+    readonly context: IStatsContext;
+    queryLatencyStats: OurQueryLatencyStats;
+    perTypeStat: {
+        [k: string]: OurTypeStat;
+    };
+    constructor(context: IStatsContext);
+    ensureCountsAreIntegers(): void;
+    addTrace(trace: Trace, sizeEstimator: SizeEstimator, nonFtv1ErrorPaths?: NonFtv1ErrorPath[]): void;
+    getTypeStat(parentType: string, sizeEstimator: SizeEstimator): OurTypeStat;
+}
+declare class OurQueryLatencyStats implements Required<IQueryLatencyStats> {
+    latencyCount: DurationHistogram;
+    requestCount: number;
+    requestsWithoutFieldInstrumentation: number;
+    cacheHits: number;
+    persistedQueryHits: number;
+    persistedQueryMisses: number;
+    cacheLatencyCount: DurationHistogram;
+    rootErrorStats: OurPathErrorStats;
+    requestsWithErrorsCount: number;
+    publicCacheTtlCount: DurationHistogram;
+    privateCacheTtlCount: DurationHistogram;
+    registeredOperationCount: number;
+    forbiddenOperationCount: number;
+}
+declare class OurPathErrorStats implements Required<IPathErrorStats> {
+    children: {
+        [k: string]: OurPathErrorStats;
+    };
+    errorsCount: number;
+    requestsWithErrorsCount: number;
+    getChild(subPath: string, sizeEstimator: SizeEstimator): OurPathErrorStats;
+}
+declare class OurTypeStat implements Required<ITypeStat> {
+    perFieldStat: {
+        [k: string]: OurFieldStat;
+    };
+    getFieldStat(fieldName: string, returnType: string, sizeEstimator: SizeEstimator): OurFieldStat;
+    ensureCountsAreIntegers(): void;
+}
+declare class OurFieldStat implements Required<IFieldStat> {
+    readonly returnType: string;
+    errorsCount: number;
+    observedExecutionCount: number;
+    estimatedExecutionCount: number;
+    requestsWithErrorsCount: number;
+    latencyCount: DurationHistogram;
+    constructor(returnType: string);
+    ensureCountsAreIntegers(): void;
+}
+export {};
+//# sourceMappingURL=stats.d.ts.map

package/dist/esm/plugin/usageReporting/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../../src/plugin/usageReporting/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EACL,KAAK,MAAM,EACX,KAAK,oBAAoB,EACzB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,EACN,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAkB3D,qBAAa,aAAa;IACxB,KAAK,SAAK;CACX;AACD,qBAAa,SAAU,YAAW,QAAQ,CAAC,OAAO,CAAC;IAOrC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAFzC,mBAAmB,UAAS;gBAEP,MAAM,EAAE,YAAY;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CACpC;IACtB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAQ;IAClD,cAAc,SAAK;IAUnB,QAAQ,CAAC,aAAa,gBAAuB;IAE7C,uBAAuB;IAMvB,QAAQ,CAAC,EACP,cAAc,EACd,KAAK,EACL,OAAO,EACP,sBAAsB,EAItB,aAAgC,EAChC,iBAAiB,GAClB,EAAE;QACD,cAAc,EAAE,MAAM,CAAC;QACvB,KAAK,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,sBAAsB,EAAE,sBAAsB,CAAC;QAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;KACvC;IA2BD,OAAO,CAAC,iBAAiB;CAqC1B;AAED,cAAM,iBAAkB,YAAW,QAAQ,CAAC,eAAe,CAAC;IAC9C,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB;gBAA9C,sBAAsB,EAAE,sBAAsB;IACnE,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAM;IAClC,QAAQ,CAAC,gBAAgB,iBAAwB;IACjD,QAAQ,CAAC,iCAAiC,EAAE,UAAU,EAAE,CAAM;IAE9D,uBAAuB;CAGxB;AAED,cAAM,cAAc;IAClB,QAAQ,CAAC,GAAG,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAA;KAAE,CAAuB;IAM5E,OAAO,IAAI,oBAAoB,EAAE;IAIjC,uBAAuB;IAMvB,QAAQ,CACN,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,iBAAiB,EAAE,gBAAgB,EAAE;IASvC,OAAO,CAAC,sBAAsB;CAyB/B;AAED,qBAAa,sBAAuB,YAAW,QAAQ,CAAC,oBAAoB,CAAC;IAI/D,QAAQ,CAAC,OAAO,EAAE,aAAa;IAH3C,iBAAiB,uBAA8B;IAC/C,WAAW,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,WAAW,CAAA;KAAE,CAAuB;gBAE3C,OAAO,EAAE,aAAa;IAE3C,uBAAuB;IAUvB,QAAQ,CACN,KAAK,EAAE,KAAK,EACZ,aAAa,EAAE,aAAa,EAC5B,iBAAiB,GAAE,gBAAgB,EAAO;IA+J5C,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,WAAW;CAU3E;AAED,cAAM,oBAAqB,YAAW,QAAQ,CAAC,kBAAkB,CAAC;IAChE,YAAY,EAAE,iBAAiB,CAA2B;IAC1D,YAAY,SAAK;IACjB,mCAAmC,SAAK;IACxC,SAAS,SAAK;IACd,kBAAkB,SAAK;IACvB,oBAAoB,SAAK;IACzB,iBAAiB,EAAE,iBAAiB,CAA2B;IAC/D,cAAc,EAAE,iBAAiB,CAA2B;IAC5D,uBAAuB,SAAK;IAC5B,mBAAmB,EAAE,iBAAiB,CAA2B;IACjE,oBAAoB,EAAE,iBAAiB,CAA2B;IAClE,wBAAwB,SAAK;IAC7B,uBAAuB,SAAK;CAC7B;AAED,cAAM,iBAAkB,YAAW,QAAQ,CAAC,eAAe,CAAC;IAC1D,QAAQ,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAAA;KAAE,CAAuB;IACnE,WAAW,SAAK;IAChB,uBAAuB,SAAK;IAE5B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,iBAAiB;CAW3E;AAED,cAAM,WAAY,YAAW,QAAQ,CAAC,SAAS,CAAC;IAC9C,YAAY,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,YAAY,CAAA;KAAE,CAAuB;IAElE,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,aAAa,GAC3B,YAAY;IAef,uBAAuB;CAKxB;AAED,cAAM,YAAa,YAAW,QAAQ,CAAC,UAAU,CAAC;IAUpC,QAAQ,CAAC,UAAU,EAAE,MAAM;IATvC,WAAW,SAAK;IAChB,sBAAsB,SAAK;IAI3B,uBAAuB,SAAK;IAC5B,uBAAuB,SAAK;IAC5B,YAAY,EAAE,iBAAiB,CAA2B;gBAErC,UAAU,EAAE,MAAM;IAEvC,uBAAuB;CAIxB"}