@snap/camera-kit 0.16.2 → 0.18.0

package/dist/metrics/operational/Histogram.d.ts

@@ -0,0 +1,19 @@
+import type { OperationalMetric } from "../../generated-proto/pb_schema/camera_kit/v3/operational_metrics";
+import type { MetricDimensions } from "./Metric";
+import { Metric } from "./Metric";
+/** @internal */
+export type HistogramMetric = OperationalMetric & {
+    metric: Extract<OperationalMetric["metric"], {
+        $case: "histogram";
+    }>;
+};
+/** @internal */
+export declare class Histogram extends Metric {
+    readonly name: string;
+    static level(name: string, level: number, dimensions?: MetricDimensions): Histogram;
+    private readonly levels;
+    constructor(name: string, dimensions?: MetricDimensions);
+    add(level: number): void;
+    toOperationalMetric(): HistogramMetric[];
+}
+//# sourceMappingURL=Histogram.d.ts.map

package/dist/metrics/operational/Histogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Histogram.d.ts","sourceRoot":"","sources":["../../../src/metrics/operational/Histogram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mEAAmE,CAAC;AAC3G,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,MAAM,EAA6B,MAAM,UAAU,CAAC;AAE7D,gBAAgB;AAChB,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAC9C,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;CACxE,CAAC;AAEF,gBAAgB;AAChB,qBAAa,SAAU,SAAQ,MAAM;IASrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IARjC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,GAAE,gBAAqB,GAAG,SAAS;IAMvF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAElB,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,gBAAqB;IAIpE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxB,mBAAmB,IAAI,eAAe,EAAE;CAS3C"}

package/dist/metrics/operational/Histogram.js

@@ -0,0 +1,26 @@
+import { Metric, serializeMetricDimensions } from "./Metric";
+export class Histogram extends Metric {
+    static level(name, level, dimensions = {}) {
+        const histogram = new Histogram(name, dimensions);
+        histogram.add(level);
+        return histogram;
+    }
+    constructor(name, dimensions = {}) {
+        super(name, dimensions);
+        this.name = name;
+        this.levels = [];
+    }
+    add(level) {
+        this.levels.push(level);
+    }
+    toOperationalMetric() {
+        const timestamp = new Date();
+        const name = `${this.name}${serializeMetricDimensions(this.dimensions)}`;
+        return this.levels.map((level) => ({
+            name,
+            timestamp,
+            metric: { $case: "histogram", histogram: `${Math.ceil(level)}` },
+        }));
+    }
+}
+//# sourceMappingURL=Histogram.js.map

package/dist/metrics/operational/Histogram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Histogram.js","sourceRoot":"","sources":["../../../src/metrics/operational/Histogram.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAQ7D,MAAM,OAAO,SAAU,SAAQ,MAAM;IACjC,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,KAAa,EAAE,aAA+B,EAAE;QACvE,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAClD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,SAAS,CAAC;IACrB,CAAC;IAID,YAAqB,IAAY,EAAE,aAA+B,EAAE;QAChE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QADP,SAAI,GAAJ,IAAI,CAAQ;QAFhB,WAAM,GAAa,EAAE,CAAC;IAIvC,CAAC;IAED,GAAG,CAAC,KAAa;QACb,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,mBAAmB;QACf,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI;YACJ,SAAS;YACT,MAAM,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE;SACnE,CAAC,CAAC,CAAC;IACR,CAAC;CACJ","sourcesContent":["import type { OperationalMetric } from \"../../generated-proto/pb_schema/camera_kit/v3/operational_metrics\";\nimport type { MetricDimensions } from \"./Metric\";\nimport { Metric, serializeMetricDimensions } from \"./Metric\";\n\n/** @internal */\nexport type HistogramMetric = OperationalMetric & {\n    metric: Extract<OperationalMetric[\"metric\"], { $case: \"histogram\" }>;\n};\n\n/** @internal */\nexport class Histogram extends Metric {\n    static level(name: string, level: number, dimensions: MetricDimensions = {}): Histogram {\n        const histogram = new Histogram(name, dimensions);\n        histogram.add(level);\n        return histogram;\n    }\n\n    private readonly levels: number[] = [];\n\n    constructor(readonly name: string, dimensions: MetricDimensions = {}) {\n        super(name, dimensions);\n    }\n\n    add(level: number): void {\n        this.levels.push(level);\n    }\n\n    toOperationalMetric(): HistogramMetric[] {\n        const timestamp = new Date();\n        const name = `${this.name}${serializeMetricDimensions(this.dimensions)}`;\n        return this.levels.map((level) => ({\n            name,\n            timestamp,\n            metric: { $case: \"histogram\", histogram: `${Math.ceil(level)}` },\n        }));\n    }\n}\n"]}

package/dist/metrics/operational/Metric.d.ts

@@ -0,0 +1,21 @@
+import type { OperationalMetric } from "../../generated-proto/pb_schema/camera_kit/v3/operational_metrics";
+type MetricConstructor<T> = new (name: string, dimensions: MetricDimensions) => T;
+declare const nameDelimiter = "_";
+/** @internal */
+export type MetricDimensions = Record<string, string | number>;
+/** @internal */
+export declare abstract class Metric {
+    readonly name: string;
+    readonly dimensions: MetricDimensions;
+    constructor(name: string, dimensions?: MetricDimensions);
+    child<ChildName extends string, T extends Metric>(constructor: MetricConstructor<T>, name: ChildName, dimensions?: MetricDimensions): T;
+    abstract toOperationalMetric(): Required<OperationalMetric>[];
+}
+/** @internal */
+export type JoinMetricNames<Parent extends string, Child extends string> = `${Parent}${typeof nameDelimiter}${Child}`;
+/** @internal */
+export declare function joinMetricNames(names: string[]): string;
+/** @internal */
+export declare function serializeMetricDimensions(dimensions: MetricDimensions): string;
+export {};
+//# sourceMappingURL=Metric.d.ts.map

package/dist/metrics/operational/Metric.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metric.d.ts","sourceRoot":"","sources":["../../../src/metrics/operational/Metric.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mEAAmE,CAAC;AAE3G,KAAK,iBAAiB,CAAC,CAAC,IAAI,KAAK,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,KAAK,CAAC,CAAC;AAElF,QAAA,MAAM,aAAa,MAAM,CAAC;AAI1B,gBAAgB;AAChB,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAE/D,gBAAgB;AAChB,8BAAsB,MAAM;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM;IAAE,QAAQ,CAAC,UAAU,EAAE,gBAAgB;gBAAnD,IAAI,EAAE,MAAM,EAAW,UAAU,GAAE,gBAAqB;IAE7E,KAAK,CAAC,SAAS,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC5C,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,IAAI,EAAE,SAAS,EACf,UAAU,GAAE,gBAAqB,GAClC,CAAC;IAIJ,QAAQ,CAAC,mBAAmB,IAAI,QAAQ,CAAC,iBAAiB,CAAC,EAAE;CAChE;AAED,gBAAgB;AAChB,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,SAAS,MAAM,IAAI,GAAG,MAAM,GAAG,OAAO,aAAa,GAAG,KAAK,EAAE,CAAC;AAEtH,gBAAgB;AAChB,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD;AAED,gBAAgB;AAChB,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,gBAAgB,GAAG,MAAM,CAO9E"}

package/dist/metrics/operational/Metric.js

@@ -0,0 +1,23 @@
+const nameDelimiter = "_";
+const dimensionDelimiter = ".";
+const delimiterRegex = new RegExp(`^${nameDelimiter}+|${nameDelimiter}+$`, "g");
+export class Metric {
+    constructor(name, dimensions = {}) {
+        this.name = name;
+        this.dimensions = dimensions;
+    }
+    child(constructor, name, dimensions = {}) {
+        return new constructor(`${this.name}${nameDelimiter}${name}`, dimensions);
+    }
+}
+export function joinMetricNames(names) {
+    return names.join(nameDelimiter).replace(delimiterRegex, "");
+}
+export function serializeMetricDimensions(dimensions) {
+    if (Object.keys(dimensions).length === 0)
+        return "";
+    return `${dimensionDelimiter}${Array.from(Object.entries(dimensions))
+        .map((d) => d.join(dimensionDelimiter))
+        .join(dimensionDelimiter)}`;
+}
+//# sourceMappingURL=Metric.js.map

package/dist/metrics/operational/Metric.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Metric.js","sourceRoot":"","sources":["../../../src/metrics/operational/Metric.ts"],"names":[],"mappings":"AAIA,MAAM,aAAa,GAAG,GAAG,CAAC;AAC1B,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,cAAc,GAAG,IAAI,MAAM,CAAC,IAAI,aAAa,KAAK,aAAa,IAAI,EAAE,GAAG,CAAC,CAAC;AAMhF,MAAM,OAAgB,MAAM;IACxB,YAAqB,IAAY,EAAW,aAA+B,EAAE;QAAxD,SAAI,GAAJ,IAAI,CAAQ;QAAW,eAAU,GAAV,UAAU,CAAuB;IAAG,CAAC;IAEjF,KAAK,CACD,WAAiC,EACjC,IAAe,EACf,aAA+B,EAAE;QAEjC,OAAO,IAAI,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,aAAa,GAAG,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;IAC9E,CAAC;CAGJ;AAMD,MAAM,UAAU,eAAe,CAAC,KAAe;IAC3C,OAAO,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC;AAGD,MAAM,UAAU,yBAAyB,CAAC,UAA4B;IAClE,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAGpD,OAAO,GAAG,kBAAkB,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;SAChE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;SACtC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;AACpC,CAAC","sourcesContent":["import type { OperationalMetric } from \"../../generated-proto/pb_schema/camera_kit/v3/operational_metrics\";\n\ntype MetricConstructor<T> = new (name: string, dimensions: MetricDimensions) => T;\n\nconst nameDelimiter = \"_\";\nconst dimensionDelimiter = \".\";\nconst delimiterRegex = new RegExp(`^${nameDelimiter}+|${nameDelimiter}+$`, \"g\");\n\n/** @internal */\nexport type MetricDimensions = Record<string, string | number>;\n\n/** @internal */\nexport abstract class Metric {\n    constructor(readonly name: string, readonly dimensions: MetricDimensions = {}) {}\n\n    child<ChildName extends string, T extends Metric>(\n        constructor: MetricConstructor<T>,\n        name: ChildName,\n        dimensions: MetricDimensions = {}\n    ): T {\n        return new constructor(`${this.name}${nameDelimiter}${name}`, dimensions);\n    }\n\n    abstract toOperationalMetric(): Required<OperationalMetric>[];\n}\n\n/** @internal */\nexport type JoinMetricNames<Parent extends string, Child extends string> = `${Parent}${typeof nameDelimiter}${Child}`;\n\n/** @internal */\nexport function joinMetricNames(names: string[]): string {\n    return names.join(nameDelimiter).replace(delimiterRegex, \"\");\n}\n\n/** @internal */\nexport function serializeMetricDimensions(dimensions: MetricDimensions): string {\n    if (Object.keys(dimensions).length === 0) return \"\";\n    // The order in which we'll iterate over the dimension keys is governed by the (rather complex) rules for object\n    // key iteration in JS -- since ES2015, for string keys of own properties, this is insertion order.\n    return `${dimensionDelimiter}${Array.from(Object.entries(dimensions))\n        .map((d) => d.join(dimensionDelimiter))\n        .join(dimensionDelimiter)}`;\n}\n"]}

package/dist/metrics/operational/Timer.d.ts

@@ -0,0 +1,96 @@
+import type { MetricsClient } from "../../clients/metricsClient";
+import type { OperationalMetric } from "../../generated-proto/pb_schema/camera_kit/v3/operational_metrics";
+import type { JoinMetricNames, MetricDimensions } from "./Metric";
+import { Metric } from "./Metric";
+interface Measure {
+    name: string;
+    duration: number;
+    dimensions: MetricDimensions;
+}
+/** @internal */
+export type LatencyMetric = OperationalMetric & {
+    metric: Extract<OperationalMetric["metric"], {
+        $case: "latencyMillis";
+    }>;
+};
+/** @internal */
+export declare class Timer<Name extends string> extends Metric {
+    readonly name: Name;
+    private readonly marks;
+    private readonly measures;
+    private readonly startTime;
+    private stopped;
+    constructor(name: Name, dimensions?: MetricDimensions);
+    /**
+     * Return all measures created by this Timer and any child timers.
+     */
+    getMeasures(): ReadonlyArray<Measure>;
+    /**
+     * Create a child Timer, using this Timer's name as a prefix when naming the new Timer. Any measures made with the
+     * child Timer will be included when calling `getMeasures()` on this Timer, or when calling `toOperationalMetric`
+     * on this Timer.
+     *
+     * @example
+     * ```ts
+     * const parent = new Timer('parent')
+     * const child = parent.mark('child') // child metric name is parent_child.
+     *
+     * child.measure()
+     * const measures = parent.getMeasures() // has one element.
+     * ```
+     *
+     * @param name
+     * @param dimensions If omitted, the child timer will NOT inherit dimensions from the parent -- if the child timer
+     * should re-use the parent's dimensions, this must be done explicitly by passing the parent's dimensions as an
+     * argument here.
+     * @returns A child Timer.
+     */
+    mark<MarkName extends string>(name: MarkName, dimensions?: MetricDimensions): Timer<JoinMetricNames<Name, MarkName>>;
+    /**
+     * Measure the time (in milliseconds) since this Timer was created.
+     *
+     * If a name is provided, the measure's name will be prefixed with the name of this Timer. Otherwise the name of
+     * the measure will be the name of this Timer.
+     *
+     * @example
+     * ```ts
+     * const timer = new Timer('a')
+     * timer.measure('b')
+     * const measures = timer.getMeasures()
+     * // measure[0].name === 'a_b'
+     * ```
+     *
+     * @param name
+     * @returns
+     */
+    measure(): Measure | undefined;
+    measure(dimensions: MetricDimensions): Measure | undefined;
+    measure(name: string): Measure | undefined;
+    measure(name: string, dimensions: MetricDimensions): Measure | undefined;
+    /**
+     * Remove all measures from this Timer and any child timers previously created by calls to `mark()`.
+     */
+    clear(): void;
+    /**
+     * Prevent any future measures from being created by this Timer or any child timers.
+     */
+    stop(): void;
+    /**
+     * Report this metric using {@link MetricsClient}.
+     *
+     * After reporting, the Timer can longer be used. Its internal state is cleared and cannot be updated. Calling this
+     * method a second time will no-op.
+     *
+     * @param reporter All measurements will be reported using the given reporter.
+     */
+    stopAndReport(client: MetricsClient): Promise<void>;
+    /**
+     * Convert all measures from this Timer and from any child timers into an array of {@link OperationalMetric}
+     * objects, which can be sent to the backend.
+     *
+     * @returns
+     */
+    toOperationalMetric(): LatencyMetric[];
+}
+export {};
+//# sourceMappingURL=Timer.d.ts.map

package/dist/metrics/operational/Timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timer.d.ts","sourceRoot":"","sources":["../../../src/metrics/operational/Timer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mEAAmE,CAAC;AAC3G,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,MAAM,EAA8C,MAAM,UAAU,CAAC;AAE9E,UAAU,OAAO;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,gBAAgB,CAAC;CAChC;AAED,gBAAgB;AAChB,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG;IAC5C,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,eAAe,CAAA;KAAE,CAAC,CAAC;CAC5E,CAAC;AAEF,gBAAgB;AAChB,qBAAa,KAAK,CAAC,IAAI,SAAS,MAAM,CAAE,SAAQ,MAAM;IAMtC,QAAQ,CAAC,IAAI,EAAE,IAAI;IAL/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,OAAO,CAAS;gBAEH,IAAI,EAAE,IAAI,EAAE,UAAU,GAAE,gBAAqB;IAOlE;;OAEG;IACH,WAAW,IAAI,aAAa,CAAC,OAAO,CAAC;IAMrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,CAAC,QAAQ,SAAS,MAAM,EACxB,IAAI,EAAE,QAAQ,EACd,UAAU,GAAE,gBAAqB,GAClC,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAOzC;;;;;;;;;;;;;;;;OAgBG;IACH,OAAO,IAAI,OAAO,GAAG,SAAS;IAC9B,OAAO,CAAC,UAAU,EAAE,gBAAgB,GAAG,OAAO,GAAG,SAAS;IAC1D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO,GAAG,SAAS;IAgBxE;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,IAAI;IAKZ;;;;;;;OAOG;IACG,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD;;;;;OAKG;IACH,mBAAmB,IAAI,aAAa,EAAE;CAWzC"}

package/dist/metrics/operational/Timer.js

@@ -0,0 +1,64 @@
+import { __awaiter } from "tslib";
+import { getTimeMs } from "../../common/time";
+import { Metric, joinMetricNames, serializeMetricDimensions } from "./Metric";
+export class Timer extends Metric {
+    constructor(name, dimensions = {}) {
+        super(name, dimensions);
+        this.name = name;
+        this.startTime = getTimeMs();
+        this.stopped = false;
+        this.marks = new Set();
+        this.measures = new Set();
+    }
+    getMeasures() {
+        return Array.from(this.measures.values()).concat(...Array.from(this.marks.values()).map((mark) => mark.getMeasures()));
+    }
+    mark(name, dimensions = {}) {
+        const mark = new Timer(joinMetricNames([this.name, name]), dimensions);
+        if (this.stopped)
+            mark.stop();
+        this.marks.add(mark);
+        return mark;
+    }
+    measure(nameOrDimensions, maybeDimensions) {
+        if (this.stopped)
+            return undefined;
+        const name = typeof nameOrDimensions === "string" ? nameOrDimensions : "";
+        const dimensions = typeof nameOrDimensions === "string" ? maybeDimensions : nameOrDimensions;
+        const fullName = joinMetricNames([this.name, name]);
+        const measure = {
+            name: fullName,
+            duration: getTimeMs() - this.startTime,
+            dimensions: dimensions !== null && dimensions !== void 0 ? dimensions : this.dimensions,
+        };
+        this.measures.add(measure);
+        return measure;
+    }
+    clear() {
+        this.measures.clear();
+        this.marks.forEach((mark) => mark.clear());
+    }
+    stop() {
+        this.stopped = true;
+        this.marks.forEach((mark) => mark.stop());
+    }
+    stopAndReport(client) {
+        return __awaiter(this, void 0, void 0, function* () {
+            client.setOperationalMetrics(this);
+            this.stop();
+            this.clear();
+        });
+    }
+    toOperationalMetric() {
+        const timestamp = new Date();
+        return this.getMeasures().map((measure) => ({
+            name: `${measure.name}${serializeMetricDimensions(measure.dimensions)}`,
+            timestamp,
+            metric: {
+                $case: "latencyMillis",
+                latencyMillis: `${Math.ceil(measure.duration)}`,
+            },
+        }));
+    }
+}
+//# sourceMappingURL=Timer.js.map

package/dist/metrics/operational/Timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Timer.js","sourceRoot":"","sources":["../../../src/metrics/operational/Timer.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MetricsClient } from \"../../clients/metricsClient\";\nimport { getTimeMs } from \"../../common/time\";\nimport type { OperationalMetric } from \"../../generated-proto/pb_schema/camera_kit/v3/operational_metrics\";\nimport type { JoinMetricNames, MetricDimensions } from \"./Metric\";\nimport { Metric, joinMetricNames, serializeMetricDimensions } from \"./Metric\";\n\ninterface Measure {\n    name: string;\n    duration: number;\n    dimensions: MetricDimensions;\n}\n\n/** @internal */\nexport type LatencyMetric = OperationalMetric & {\n    metric: Extract<OperationalMetric[\"metric\"], { $case: \"latencyMillis\" }>;\n};\n\n/** @internal */\nexport class Timer<Name extends string> extends Metric {\n    private readonly marks: Set<Timer<string>>;\n    private readonly measures: Set<Measure>;\n    private readonly startTime = getTimeMs();\n    private stopped = false;\n\n    constructor(readonly name: Name, dimensions: MetricDimensions = {}) {\n        super(name, dimensions);\n\n        this.marks = new Set();\n        this.measures = new Set();\n    }\n\n    /**\n     * Return all measures created by this Timer and any child timers.\n     */\n    getMeasures(): ReadonlyArray<Measure> {\n        return Array.from(this.measures.values()).concat(\n            ...Array.from(this.marks.values()).map((mark) => mark.getMeasures())\n        );\n    }\n\n    /**\n     * Create a child Timer, using this Timer's name as a prefix when naming the new Timer. Any measures made with the\n     * child Timer will be included when calling `getMeasures()` on this Timer, or when calling `toOperationalMetric`\n     * on this Timer.\n     *\n     * @example\n     * ```ts\n     * const parent = new Timer('parent')\n     * const child = parent.mark('child') // child metric name is parent_child.\n     *\n     * child.measure()\n     * const measures = parent.getMeasures() // has one element.\n     * ```\n     *\n     * @param name\n     * @param dimensions If omitted, the child timer will NOT inherit dimensions from the parent -- if the child timer\n     * should re-use the parent's dimensions, this must be done explicitly by passing the parent's dimensions as an\n     * argument here.\n     * @returns A child Timer.\n     */\n    mark<MarkName extends string>(\n        name: MarkName,\n        dimensions: MetricDimensions = {}\n    ): Timer<JoinMetricNames<Name, MarkName>> {\n        const mark = new Timer(joinMetricNames([this.name, name]) as JoinMetricNames<Name, MarkName>, dimensions);\n        if (this.stopped) mark.stop();\n        this.marks.add(mark);\n        return mark;\n    }\n\n    /**\n     * Measure the time (in milliseconds) since this Timer was created.\n     *\n     * If a name is provided, the measure's name will be prefixed with the name of this Timer. Otherwise the name of\n     * the measure will be the name of this Timer.\n     *\n     * @example\n     * ```ts\n     * const timer = new Timer('a')\n     * timer.measure('b')\n     * const measures = timer.getMeasures()\n     * // measure[0].name === 'a_b'\n     * ```\n     *\n     * @param name\n     * @returns\n     */\n    measure(): Measure | undefined;\n    measure(dimensions: MetricDimensions): Measure | undefined;\n    measure(name: string): Measure | undefined;\n    measure(name: string, dimensions: MetricDimensions): Measure | undefined;\n    measure(nameOrDimensions?: string | MetricDimensions, maybeDimensions?: MetricDimensions): Measure | undefined {\n        if (this.stopped) return undefined;\n        const name = typeof nameOrDimensions === \"string\" ? nameOrDimensions : \"\";\n        const dimensions = typeof nameOrDimensions === \"string\" ? maybeDimensions : nameOrDimensions;\n\n        const fullName = joinMetricNames([this.name, name]);\n        const measure: Measure = {\n            name: fullName,\n            duration: getTimeMs() - this.startTime,\n            dimensions: dimensions ?? this.dimensions,\n        };\n        this.measures.add(measure);\n        return measure;\n    }\n\n    /**\n     * Remove all measures from this Timer and any child timers previously created by calls to `mark()`.\n     */\n    clear(): void {\n        this.measures.clear();\n        this.marks.forEach((mark) => mark.clear());\n    }\n\n    /**\n     * Prevent any future measures from being created by this Timer or any child timers.\n     */\n    stop(): void {\n        this.stopped = true;\n        this.marks.forEach((mark) => mark.stop());\n    }\n\n    /**\n     * Report this metric using {@link MetricsClient}.\n     *\n     * After reporting, the Timer can longer be used. Its internal state is cleared and cannot be updated. Calling this\n     * method a second time will no-op.\n     *\n     * @param reporter All measurements will be reported using the given reporter.\n     */\n    async stopAndReport(client: MetricsClient): Promise<void> {\n        client.setOperationalMetrics(this);\n        this.stop();\n        this.clear();\n    }\n\n    /**\n     * Convert all measures from this Timer and from any child timers into an array of {@link OperationalMetric}\n     * objects, which can be sent to the backend.\n     *\n     * @returns\n     */\n    toOperationalMetric(): LatencyMetric[] {\n        const timestamp = new Date();\n        return this.getMeasures().map((measure) => ({\n            name: `${measure.name}${serializeMetricDimensions(measure.dimensions)}`,\n            timestamp,\n            metric: {\n                $case: \"latencyMillis\",\n                latencyMillis: `${Math.ceil(measure.duration)}`,\n            },\n        }));\n    }\n}\n"]}

package/dist/metrics/reporters/reportBenchmarks.d.ts

@@ -0,0 +1,11 @@
+import type { MetricsClient } from "../../clients/metricsClient";
+import type { CameraKitConfiguration } from "../../configuration";
+import type { MakeTaggedBusinessEvent } from "../businessEventsReporter";
+import type { MetricsEventTarget } from "../metricsEventTarget";
+export type BenchmarkComplete = MakeTaggedBusinessEvent<"benchmarkComplete">;
+export declare const reportBenchmarks: {
+    (args_0: MetricsEventTarget, args_1: MetricsClient, args_2: CameraKitConfiguration): Promise<void>;
+    token: "reportBenchmarks";
+    dependencies: readonly ["metricsEventTarget", "metricsClient", "configuration"];
+};
+//# sourceMappingURL=reportBenchmarks.d.ts.map

package/dist/metrics/reporters/reportBenchmarks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportBenchmarks.d.ts","sourceRoot":"","sources":["../../../src/metrics/reporters/reportBenchmarks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAIlE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOhE,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,CAAC,mBAAmB,CAAC,CAAC;AAE7E,eAAO,MAAM,gBAAgB;;;;CAyB5B,CAAC"}

package/dist/metrics/reporters/reportBenchmarks.js

@@ -0,0 +1,27 @@
+import { __awaiter } from "tslib";
+import { metricsClientFactory } from "../../clients/metricsClient";
+import { configurationToken } from "../../configuration";
+import { Injectable } from "../../dependency-injection/Injectable";
+import { TypedCustomEvent } from "../../events/TypedCustomEvent";
+import { metricsEventTargetFactory } from "../metricsEventTarget";
+import { Histogram } from "../operational/Histogram";
+const reportableBenchmarks = ["gflops"];
+export const reportBenchmarks = Injectable("reportBenchmarks", [metricsEventTargetFactory.token, metricsClientFactory.token, configurationToken], (metricsEventTarget, metrics, config) => __awaiter(void 0, void 0, void 0, function* () {
+    if (config.lensPerformance === undefined)
+        return;
+    const lensPerformance = yield config.lensPerformance;
+    const baseBenchmark = {
+        name: "benchmarkComplete",
+        performanceCluster: `${lensPerformance.cluster}`,
+        webglRendererInfo: lensPerformance.webglRendererInfo,
+    };
+    const dimensions = { performance_cluster: lensPerformance.cluster.toString() };
+    for (const benchmark of lensPerformance.benchmarks) {
+        if (!reportableBenchmarks.includes(benchmark.name))
+            continue;
+        const benchmarkComplete = Object.assign(Object.assign({}, baseBenchmark), { benchmarkName: benchmark.name, benchmarkValue: benchmark.value });
+        metricsEventTarget.dispatchEvent(new TypedCustomEvent("benchmarkComplete", benchmarkComplete));
+        metrics.setOperationalMetrics(Histogram.level(`benchmark.${benchmark.name}`, benchmark.value, dimensions));
+    }
+}));
+//# sourceMappingURL=reportBenchmarks.js.map

package/dist/metrics/reporters/reportBenchmarks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportBenchmarks.js","sourceRoot":"","sources":["../../../src/metrics/reporters/reportBenchmarks.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAGrD,MAAM,oBAAoB,GAAG,CAAC,QAAQ,CAAC,CAAC;AAIxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CACtC,kBAAkB,EAClB,CAAC,yBAAyB,CAAC,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,kBAAkB,CAAU,EAC1F,CAAO,kBAAsC,EAAE,OAAsB,EAAE,MAA8B,EAAE,EAAE;IACrG,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS;QAAE,OAAO;IAGjD,MAAM,eAAe,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC;IACrD,MAAM,aAAa,GAAiF;QAChG,IAAI,EAAE,mBAAmB;QACzB,kBAAkB,EAAE,GAAG,eAAe,CAAC,OAAO,EAAE;QAChD,iBAAiB,EAAE,eAAe,CAAC,iBAAiB;KACvD,CAAC;IACF,MAAM,UAAU,GAAG,EAAE,mBAAmB,EAAE,eAAe,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IAC/E,KAAK,MAAM,SAAS,IAAI,eAAe,CAAC,UAAU,EAAE;QAChD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7D,MAAM,iBAAiB,mCAChB,aAAa,KAChB,aAAa,EAAE,SAAS,CAAC,IAAI,EAC7B,cAAc,EAAE,SAAS,CAAC,KAAK,GAClC,CAAC;QACF,kBAAkB,CAAC,aAAa,CAAC,IAAI,gBAAgB,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC;QAC/F,OAAO,CAAC,qBAAqB,CAAC,SAAS,CAAC,KAAK,CAAC,aAAa,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;KAC9G;AACL,CAAC,CAAA,CACJ,CAAC","sourcesContent":["import type { MetricsClient } from \"../../clients/metricsClient\";\nimport { metricsClientFactory } from \"../../clients/metricsClient\";\nimport type { CameraKitConfiguration } from \"../../configuration\";\nimport { configurationToken } from \"../../configuration\";\nimport { Injectable } from \"../../dependency-injection/Injectable\";\nimport { TypedCustomEvent } from \"../../events/TypedCustomEvent\";\nimport type { MakeTaggedBusinessEvent } from \"../businessEventsReporter\";\nimport type { MetricsEventTarget } from \"../metricsEventTarget\";\nimport { metricsEventTargetFactory } from \"../metricsEventTarget\";\nimport { Histogram } from \"../operational/Histogram\";\n\n// Allowlist the benchmarks we wish to report.\nconst reportableBenchmarks = [\"gflops\"];\n\nexport type BenchmarkComplete = MakeTaggedBusinessEvent<\"benchmarkComplete\">;\n\nexport const reportBenchmarks = Injectable(\n    \"reportBenchmarks\",\n    [metricsEventTargetFactory.token, metricsClientFactory.token, configurationToken] as const,\n    async (metricsEventTarget: MetricsEventTarget, metrics: MetricsClient, config: CameraKitConfiguration) => {\n        if (config.lensPerformance === undefined) return;\n        // Safety: config.lensPerformance cannot reject – all Promises contained in CameraKitConfiguration have\n        // catch blocks which return a default value.\n        const lensPerformance = await config.lensPerformance;\n        const baseBenchmark: Pick<BenchmarkComplete, \"name\" | \"performanceCluster\" | \"webglRendererInfo\"> = {\n            name: \"benchmarkComplete\",\n            performanceCluster: `${lensPerformance.cluster}`,\n            webglRendererInfo: lensPerformance.webglRendererInfo,\n        };\n        const dimensions = { performance_cluster: lensPerformance.cluster.toString() };\n        for (const benchmark of lensPerformance.benchmarks) {\n            if (!reportableBenchmarks.includes(benchmark.name)) continue;\n            const benchmarkComplete: BenchmarkComplete = {\n                ...baseBenchmark,\n                benchmarkName: benchmark.name,\n                benchmarkValue: benchmark.value,\n            };\n            metricsEventTarget.dispatchEvent(new TypedCustomEvent(\"benchmarkComplete\", benchmarkComplete));\n            metrics.setOperationalMetrics(Histogram.level(`benchmark.${benchmark.name}`, benchmark.value, dimensions));\n        }\n    }\n);\n"]}

package/dist/metrics/reporters/reportGlobalException.d.ts

@@ -0,0 +1,27 @@
+import type { Observable } from "rxjs";
+import type { LogEntry } from "../../logger/logger";
+import type { LensState } from "../../session/lensState";
+import type { MetricsEventTarget } from "../metricsEventTarget";
+import type { MetricsClient } from "../../clients/metricsClient";
+interface RepeatableLogEntry {
+    entry: LogEntry;
+    count: number;
+    lastTime: Date;
+}
+export declare function getContextString(logEntries: RepeatableLogEntry[]): string;
+export declare function reportExceptionToBlizzard(logEntries: Observable<LogEntry>, metricsEventTarget: MetricsEventTarget, metrics: MetricsClient, lensState?: LensState): void;
+export interface GlobalExceptionReporter {
+    attachLensContext: (lensState: LensState) => void;
+}
+/**
+ * Reports log entries to Blizzard when there is no CameraKit session yet.
+ *
+ * @internal
+ */
+export declare const reportGlobalException: {
+    (args_0: Observable<LogEntry>, args_1: MetricsEventTarget, args_2: MetricsClient): GlobalExceptionReporter;
+    token: "reportGlobalException";
+    dependencies: readonly ["logEntries", "metricsEventTarget", "metricsClient"];
+};
+export {};
+//# sourceMappingURL=reportGlobalException.d.ts.map

package/dist/metrics/reporters/reportGlobalException.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportGlobalException.d.ts","sourceRoot":"","sources":["../../../src/metrics/reporters/reportGlobalException.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAOvC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAWjE,UAAU,kBAAkB;IACxB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,IAAI,CAAC;CAClB;AAaD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,EAAE,UAYhE;AAWD,wBAAgB,yBAAyB,CACrC,UAAU,EAAE,UAAU,CAAC,QAAQ,CAAC,EAChC,kBAAkB,EAAE,kBAAkB,EACtC,OAAO,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,SAAS,QAmDxB;AAED,MAAM,WAAW,uBAAuB;IACpC,iBAAiB,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACrD;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB;;;;CAqBjC,CAAC"}

package/dist/metrics/reporters/reportGlobalException.js

@@ -0,0 +1,82 @@
+import { isState } from "@snap/state-management";
+import { filter, map, scan, Subject, takeUntil } from "rxjs";
+import { entries } from "../../common/entries";
+import { stringifyError, stringifyErrorMessage } from "../../common/errorHelpers";
+import { Injectable } from "../../dependency-injection/Injectable";
+import { TypedCustomEvent } from "../../events/TypedCustomEvent";
+import { logEntriesFactory } from "../../logger/logEntries";
+import { logLevelMap } from "../../logger/logger";
+import { metricsEventTargetFactory } from "../metricsEventTarget";
+import { metricsClientFactory } from "../../clients/metricsClient";
+import { Count } from "../operational/Count";
+const logMethods = entries(logLevelMap).map(([level]) => level);
+const maxBufferedEntries = 15;
+const contextSeparator = "\n\n----------------- Context -----------------\n\n";
+const methodLength = logMethods.reduce((max, method) => Math.max(max, method.length), 0);
+export function getContextString(logEntries) {
+    const result = [];
+    for (const { entry, count, lastTime } of logEntries) {
+        const time = entry.time.toISOString();
+        const method = entry.level.padStart(methodLength);
+        const messages = entry.messages.map(prettyPrintMessage).join(" ");
+        let dupSuffix = count > 1 ? ` (Repeated ${count} times with the last occurrence at ${lastTime.toISOString()})` : "";
+        result.push(`${time} [${entry.module}] ${method}: ${messages}${dupSuffix}`);
+    }
+    return result.join("\n");
+}
+function prettyPrintMessage(message) {
+    if (message instanceof Error)
+        return stringifyErrorMessage(message);
+    if (message instanceof Date)
+        return message.toISOString();
+    return message + "";
+}
+export function reportExceptionToBlizzard(logEntries, metricsEventTarget, metrics, lensState) {
+    logEntries
+        .pipe(scan(({ entries }, newEntry) => {
+        const lastEntry = entries[entries.length - 1];
+        const isNewEntryRepeated = lastEntry &&
+            lastEntry.entry.messages.join() === newEntry.messages.join() &&
+            lastEntry.entry.level === newEntry.level;
+        if (isNewEntryRepeated) {
+            lastEntry.count += 1;
+            lastEntry.lastTime = newEntry.time;
+        }
+        else {
+            entries.push({
+                entry: newEntry,
+                count: 1,
+                lastTime: newEntry.time,
+            });
+        }
+        return {
+            entries: entries.slice(-maxBufferedEntries),
+            recent: newEntry,
+        };
+    }, { entries: [], recent: { time: new Date(), module: "any", level: "debug", messages: [] } }), filter(({ recent }) => recent.level === "error"), map(({ entries, recent }) => ({
+        context: entries,
+        error: recent.messages.find((e) => e instanceof Error),
+    })), filter(({ error }) => !!error))
+        .subscribe(({ error, context }) => {
+        const currentLensState = lensState === null || lensState === void 0 ? void 0 : lensState.getState();
+        const lensId = currentLensState && !isState(currentLensState, "noLensApplied") ? currentLensState.data.id : "none";
+        metricsEventTarget.dispatchEvent(new TypedCustomEvent("exception", {
+            name: "exception",
+            lensId,
+            type: error.name,
+            reason: `${stringifyError(error)}${contextSeparator}${getContextString(context)}`,
+        }));
+        metrics.setOperationalMetrics(Count.count("handled_exception", 1, { type: error.name }));
+    });
+}
+export const reportGlobalException = Injectable("reportGlobalException", [logEntriesFactory.token, metricsEventTargetFactory.token, metricsClientFactory.token], (logEntries, metricsEventTarget, metrics) => {
+    const cancellationSubject = new Subject();
+    reportExceptionToBlizzard(logEntries.pipe(takeUntil(cancellationSubject)), metricsEventTarget, metrics);
+    return {
+        attachLensContext: (lensState) => {
+            cancellationSubject.next();
+            reportExceptionToBlizzard(logEntries, metricsEventTarget, metrics, lensState);
+        },
+    };
+});
+//# sourceMappingURL=reportGlobalException.js.map

package/dist/metrics/reporters/reportGlobalException.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportGlobalException.js","sourceRoot":"","sources":["../../../src/metrics/reporters/reportGlobalException.ts"],"names":[],"mappings":"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","sourcesContent":["import { isState } from \"@snap/state-management\";\nimport type { Observable } from \"rxjs\";\nimport { filter, map, scan, Subject, takeUntil } from \"rxjs\";\nimport { entries } from \"../../common/entries\";\nimport { stringifyError, stringifyErrorMessage } from \"../../common/errorHelpers\";\nimport { Injectable } from \"../../dependency-injection/Injectable\";\nimport { TypedCustomEvent } from \"../../events/TypedCustomEvent\";\nimport { logEntriesFactory } from \"../../logger/logEntries\";\nimport type { LogEntry } from \"../../logger/logger\";\nimport { logLevelMap } from \"../../logger/logger\";\nimport type { LensState } from \"../../session/lensState\";\nimport type { MetricsEventTarget } from \"../metricsEventTarget\";\nimport { metricsEventTargetFactory } from \"../metricsEventTarget\";\nimport type { MetricsClient } from \"../../clients/metricsClient\";\nimport { metricsClientFactory } from \"../../clients/metricsClient\";\nimport { Count } from \"../operational/Count\";\n\nconst logMethods = entries(logLevelMap).map(([level]) => level);\n\n// How many log entries to include as the error context\nconst maxBufferedEntries = 15;\nconst contextSeparator = \"\\n\\n----------------- Context -----------------\\n\\n\";\nconst methodLength = logMethods.reduce((max, method) => Math.max(max, method.length), 0);\n\ninterface RepeatableLogEntry {\n    entry: LogEntry;\n    count: number;\n    lastTime: Date;\n}\n\ninterface EntriesBuffer {\n    /**\n     * LogEntries grouped by their message.\n     */\n    entries: RepeatableLogEntry[];\n    /**\n     * The recent log entry.\n     */\n    recent: LogEntry;\n}\n\nexport function getContextString(logEntries: RepeatableLogEntry[]) {\n    const result = [];\n    for (const { entry, count, lastTime } of logEntries) {\n        const time = entry.time.toISOString();\n        const method = entry.level.padStart(methodLength);\n        const messages = entry.messages.map(prettyPrintMessage).join(\" \");\n        let dupSuffix =\n            count > 1 ? ` (Repeated ${count} times with the last occurrence at ${lastTime.toISOString()})` : \"\";\n\n        result.push(`${time} [${entry.module}] ${method}: ${messages}${dupSuffix}`);\n    }\n    return result.join(\"\\n\");\n}\n\n/**\n * Pretty print a log message.\n */\nfunction prettyPrintMessage(message: unknown): string {\n    if (message instanceof Error) return stringifyErrorMessage(message);\n    if (message instanceof Date) return message.toISOString();\n    return message + \"\";\n}\n\nexport function reportExceptionToBlizzard(\n    logEntries: Observable<LogEntry>,\n    metricsEventTarget: MetricsEventTarget,\n    metrics: MetricsClient,\n    lensState?: LensState\n) {\n    logEntries\n        .pipe(\n            scan<LogEntry, EntriesBuffer>(\n                ({ entries }, newEntry) => {\n                    const lastEntry = entries[entries.length - 1];\n                    const isNewEntryRepeated =\n                        lastEntry &&\n                        lastEntry.entry.messages.join() === newEntry.messages.join() &&\n                        lastEntry.entry.level === newEntry.level;\n                    if (isNewEntryRepeated) {\n                        lastEntry.count += 1;\n                        lastEntry.lastTime = newEntry.time;\n                    } else {\n                        entries.push({\n                            entry: newEntry,\n                            count: 1,\n                            lastTime: newEntry.time,\n                        });\n                    }\n                    return {\n                        entries: entries.slice(-maxBufferedEntries),\n                        recent: newEntry,\n                    };\n                },\n                // Start with a dummy recent entry -- it gets overridden each time we handle a log entry.\n                { entries: [], recent: { time: new Date(), module: \"any\", level: \"debug\", messages: [] } }\n            ),\n            filter(({ recent }) => recent.level === \"error\"),\n            map(({ entries, recent }) => ({\n                context: entries,\n                error: recent.messages.find((e) => e instanceof Error) as Error,\n            })),\n            filter(({ error }) => !!error)\n        )\n        .subscribe(({ error, context }) => {\n            const currentLensState = lensState?.getState();\n            const lensId =\n                currentLensState && !isState(currentLensState, \"noLensApplied\") ? currentLensState.data.id : \"none\";\n            metricsEventTarget.dispatchEvent(\n                new TypedCustomEvent(\"exception\", {\n                    name: \"exception\",\n                    lensId,\n                    type: error.name,\n                    reason: `${stringifyError(error)}${contextSeparator}${getContextString(context)}`,\n                })\n            );\n\n            metrics.setOperationalMetrics(Count.count(\"handled_exception\", 1, { type: error.name }));\n        });\n}\n\nexport interface GlobalExceptionReporter {\n    attachLensContext: (lensState: LensState) => void;\n}\n\n/**\n * Reports log entries to Blizzard when there is no CameraKit session yet.\n *\n * @internal\n */\nexport const reportGlobalException = Injectable(\n    \"reportGlobalException\",\n    [logEntriesFactory.token, metricsEventTargetFactory.token, metricsClientFactory.token] as const,\n    (\n        logEntries: Observable<LogEntry>,\n        metricsEventTarget: MetricsEventTarget,\n        metrics: MetricsClient\n    ): GlobalExceptionReporter => {\n        // Initially we log exceptions without any lens context\n        const cancellationSubject = new Subject<void>();\n        reportExceptionToBlizzard(logEntries.pipe(takeUntil(cancellationSubject)), metricsEventTarget, metrics);\n\n        // Later session scope reporter triggers cancellation of the global one\n        // and initiates exception reporting with a lens context\n        return {\n            attachLensContext: (lensState: LensState) => {\n                cancellationSubject.next();\n                reportExceptionToBlizzard(logEntries, metricsEventTarget, metrics, lensState);\n            },\n        };\n    }\n);\n"]}

package/dist/metrics/reporters/reportHttpMetrics.d.ts

@@ -0,0 +1,11 @@
+import type { CofDimensions } from "../../remote-configuration/cofHandler";
+import type { Dimensions, RequestStateEventTarget } from "../../handlers/requestStateEmittingHandler";
+import type { MetricsClient } from "../../clients/metricsClient";
+import type { AssetDownloadDimensions, LensDownloadDimensions } from "./reportLensAndAssetDownload";
+export declare const isRelevantRequest: (value: Dimensions) => value is CofDimensions | AssetDownloadDimensions | LensDownloadDimensions;
+export declare const reportHttpMetrics: {
+    (args_0: MetricsClient, args_1: RequestStateEventTarget): void;
+    token: "reportHttpMetrics";
+    dependencies: readonly ["metricsClient", "requestStateEventTarget"];
+};
+//# sourceMappingURL=reportHttpMetrics.d.ts.map

package/dist/metrics/reporters/reportHttpMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportHttpMetrics.d.ts","sourceRoot":"","sources":["../../../src/metrics/reporters/reportHttpMetrics.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAE3E,OAAO,KAAK,EACR,UAAU,EACV,uBAAuB,EAE1B,MAAM,4CAA4C,CAAC;AAGpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAKjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAuEpG,eAAO,MAAM,iBAAiB,UACnB,UAAU,8EAGpB,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;;CA2D7B,CAAC"}

package/dist/metrics/reporters/reportHttpMetrics.js

@@ -0,0 +1,107 @@
+import { assertUnreachable } from "../../common/assertions";
+import { Injectable } from "../../dependency-injection/Injectable";
+import { scan } from "../../events/scan";
+import { COF_REQUEST_TYPE } from "../../remote-configuration/cofHandler";
+import { requestStateEventTargetFactory } from "../../handlers/requestStateEmittingHandler";
+import { getPlatformInfo } from "../../platform/platformInfo";
+import { metricsClientFactory } from "../../clients/metricsClient";
+import { Count } from "../operational/Count";
+import { Histogram } from "../operational/Histogram";
+import { isLensOrAssetRequest } from "./reportLensAndAssetDownload";
+const getAdditionalDimensions = (dimensions) => {
+    switch (dimensions.requestType) {
+        case "lens_content":
+        case "asset":
+            return [];
+        case COF_REQUEST_TYPE:
+            return [["delta", dimensions.delta]];
+        default:
+            assertUnreachable(dimensions);
+    }
+};
+const getContentType = (dimensions) => {
+    switch (dimensions.requestType) {
+        case "lens_content":
+            return "lens_content";
+        case "asset":
+            return dimensions.assetType;
+        case COF_REQUEST_TYPE:
+            return COF_REQUEST_TYPE;
+        default:
+            assertUnreachable(dimensions);
+    }
+};
+const getSizeKb = (event) => {
+    switch (event.type) {
+        case "started":
+        case "errored":
+            return 0;
+        case "completed":
+            return event.detail.sizeByte / 1024;
+        default:
+            assertUnreachable(event);
+    }
+};
+const getStatus = (event) => {
+    switch (event.type) {
+        case "started":
+        case "errored":
+            return "0";
+        case "completed":
+            return event.detail.status.toString();
+        default:
+            assertUnreachable(event);
+    }
+};
+export const isRelevantRequest = (value) => {
+    return isLensOrAssetRequest(value) || value["requestType"] === COF_REQUEST_TYPE;
+};
+export const reportHttpMetrics = Injectable("reportHttpMetrics", [metricsClientFactory.token, requestStateEventTargetFactory.token], (metrics, requestStateEventTarget) => {
+    scan({ name: "inProgress", inProgress: new Map() })(requestStateEventTarget, ["started", "completed", "errored"], (state, event) => {
+        var _a;
+        const { inProgress } = state;
+        const { dimensions, requestId } = event.detail;
+        if (!isRelevantRequest(dimensions))
+            return state;
+        switch (event.type) {
+            case "started":
+                const timer = event.detail.timer;
+                inProgress.set(requestId, { timer });
+                return { name: "inProgress", inProgress };
+            case "completed":
+            case "errored":
+                const completedRequest = inProgress.get(requestId);
+                if (!completedRequest)
+                    return state;
+                inProgress.delete(requestId);
+                const downloadSizeKb = getSizeKb(event);
+                const status = getStatus(event);
+                const operationalDimensions = {
+                    content_type: getContentType(dimensions),
+                    network_type: (_a = getPlatformInfo().connectionType) !== null && _a !== void 0 ? _a : "unknown",
+                    status,
+                };
+                for (const [key, value] of getAdditionalDimensions(dimensions)) {
+                    operationalDimensions[key] = value;
+                }
+                completedRequest.timer.measure(operationalDimensions);
+                return {
+                    name: "completed",
+                    inProgress: state.inProgress,
+                    dimensions: operationalDimensions,
+                    downloadSizeKb,
+                    timer: completedRequest.timer,
+                };
+            default:
+                assertUnreachable(event);
+        }
+    }).addEventListener("state", ({ detail: state }) => {
+        if (state.name !== "completed")
+            return;
+        const { dimensions, timer, downloadSizeKb } = state;
+        metrics.setOperationalMetrics(Count.count("download_finished", 1, dimensions));
+        metrics.setOperationalMetrics(Histogram.level("download_size_kb", downloadSizeKb, dimensions));
+        metrics.setOperationalMetrics(timer);
+    });
+});
+//# sourceMappingURL=reportHttpMetrics.js.map