@snap/camera-kit 0.17.0 → 0.18.1

package/dist/media-sources/MediaStreamSource.js

@@ -0,0 +1,140 @@
+import { __awaiter } from "tslib";
+import { Subject, map } from "rxjs";
+import { copyDefinedProperties } from "../common/copyDefinedProperties";
+import { ensureError, stringifyErrorMessage } from "../common/errorHelpers";
+import { Transform2D } from "../transforms/Transform2D";
+import { debounceTimeAfter } from "../observable-operators/debounceTimeAfter";
+import { CameraKitSource, defaultDeviceInfo } from "./CameraKitSource";
+const defaultOptions = Object.assign(Object.assign({}, defaultDeviceInfo), { transform: Transform2D.Identity, disableSourceAudio: false });
+function closeWorklet(worklet) {
+    if (!worklet)
+        return;
+    worklet.port.close();
+    worklet.port.onmessage = null;
+    worklet.disconnect();
+}
+function closeAudioContext(audioContext) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (!audioContext || audioContext.state === "closed")
+            return;
+        return audioContext.close();
+    });
+}
+function handleAudioProcessingErrors(errors, reportError) {
+    return errors
+        .pipe(debounceTimeAfter(1, 1000), map((event) => {
+        if (event.type === "initial") {
+            reportError(new Error("The first audio processing error before debouncing.", { cause: event.value }));
+        }
+        else if (event.type === "debounced") {
+            const errorMessages = [...new Set(event.values.map(stringifyErrorMessage))].join("\n");
+            reportError(new Error(`Debounced ${event.values.length} audio processing errors.`, {
+                cause: new Error(errorMessages),
+            }));
+        }
+    }))
+        .subscribe();
+}
+export function createMediaStreamSource(stream, options = {}) {
+    var _a;
+    const { facingMode } = stream.getVideoTracks().length > 0 ? stream.getVideoTracks()[0].getSettings() : { facingMode: undefined };
+    const detectedCameraType = facingMode === "user" || facingMode === "environment" ? facingMode : undefined;
+    const optionsWithDefaults = Object.assign(Object.assign(Object.assign({}, defaultOptions), copyDefinedProperties(options)), { cameraType: (_a = options.cameraType) !== null && _a !== void 0 ? _a : detectedCameraType });
+    const enableSourceAudio = stream.getAudioTracks().length > 0 && !optionsWithDefaults.disableSourceAudio;
+    const simulateStereoAudio = true;
+    const sampleRate = 44100;
+    let audioContext = undefined;
+    let audioSource = undefined;
+    let worklet = undefined;
+    let microphoneRecorderUrl;
+    if (enableSourceAudio) {
+        const microphoneRecorderWorklet = `
+        class MicrophoneWorkletProcessor extends AudioWorkletProcessor {
+            process(inputs, outputs, parameters) {
+                this.port.postMessage({
+                    eventType: 'data',
+                    buffer: inputs
+                });
+                return true;
+            }
+        }
+        registerProcessor('microphone-worklet', MicrophoneWorkletProcessor);`;
+        const microphoneRecorderBlob = new Blob([microphoneRecorderWorklet], {
+            type: "application/javascript",
+        });
+        microphoneRecorderUrl = URL.createObjectURL(microphoneRecorderBlob);
+    }
+    let audioProcessingErrorSubscription = undefined;
+    return new CameraKitSource({ media: stream }, {
+        onAttach: (source, lensCore, reportError) => __awaiter(this, void 0, void 0, function* () {
+            yield source.setTransform(optionsWithDefaults.transform);
+            if (enableSourceAudio) {
+                const audioProcessingErrors = new Subject();
+                audioProcessingErrorSubscription = handleAudioProcessingErrors(audioProcessingErrors, reportError);
+                yield lensCore.setAudioParameters({
+                    parameters: {
+                        numChannels: simulateStereoAudio ? 2 : 1,
+                        sampleRate,
+                    },
+                });
+                try {
+                    closeWorklet(worklet);
+                    audioSource === null || audioSource === void 0 ? void 0 : audioSource.disconnect();
+                    yield closeAudioContext(audioContext);
+                }
+                catch (error) {
+                    reportError(ensureError(error));
+                }
+                audioContext = new AudioContext();
+                audioSource = audioContext.createMediaStreamSource(stream);
+                const scopedAudioSource = audioSource;
+                audioContext.audioWorklet
+                    .addModule(microphoneRecorderUrl)
+                    .then(() => {
+                    if (audioContext) {
+                        worklet = new AudioWorkletNode(audioContext, "microphone-worklet");
+                        scopedAudioSource.connect(worklet);
+                        worklet.connect(audioContext.destination);
+                        worklet.port.onmessage = (e) => {
+                            if (e.data.eventType === "data") {
+                                const leftSamples = e.data.buffer[0][0];
+                                if (!leftSamples)
+                                    return;
+                                let inputBuffers = [leftSamples];
+                                if (simulateStereoAudio) {
+                                    const rightSamples = e.data.buffer[0].length > 1 ? e.data.buffer[0][1] : leftSamples.slice();
+                                    inputBuffers.push(rightSamples);
+                                }
+                                lensCore
+                                    .processAudioSampleBuffer({ input: inputBuffers })
+                                    .catch((error) => audioProcessingErrors.next(error));
+                            }
+                        };
+                    }
+                })
+                    .catch((error) => {
+                    reportError(error);
+                });
+            }
+        }),
+        onDetach: (reportError) => __awaiter(this, void 0, void 0, function* () {
+            if (worklet) {
+                closeWorklet(worklet);
+                worklet = undefined;
+            }
+            if (audioSource) {
+                audioSource.disconnect();
+                audioSource = undefined;
+            }
+            if (audioContext) {
+                yield closeAudioContext(audioContext).catch(reportError);
+                audioContext = undefined;
+            }
+            if (audioProcessingErrorSubscription) {
+                audioProcessingErrorSubscription.unsubscribe();
+                audioProcessingErrorSubscription = undefined;
+            }
+        }),
+    }, optionsWithDefaults);
+}
+//# sourceMappingURL=MediaStreamSource.js.map

package/dist/media-sources/MediaStreamSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaStreamSource.js","sourceRoot":"","sources":["../../src/media-sources/MediaStreamSource.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Observable, Subscription } from \"rxjs\";\nimport { Subject, map } from \"rxjs\";\nimport { copyDefinedProperties } from \"../common/copyDefinedProperties\";\nimport { ensureError, stringifyErrorMessage } from \"../common/errorHelpers\";\nimport type { LensCoreError } from \"../lens-core-module/lensCoreError\";\nimport { Transform2D } from \"../transforms/Transform2D\";\nimport { debounceTimeAfter } from \"../observable-operators/debounceTimeAfter\";\nimport type { CameraKitDeviceOptions } from \"./CameraKitSource\";\nimport { CameraKitSource, defaultDeviceInfo } from \"./CameraKitSource\";\n\nconst defaultOptions: MediaStreamSourceOptions = {\n    ...defaultDeviceInfo,\n    transform: Transform2D.Identity,\n    disableSourceAudio: false,\n};\n\nfunction closeWorklet(worklet: AudioWorkletNode | undefined) {\n    if (!worklet) return;\n    worklet.port.close();\n    worklet.port.onmessage = null;\n    worklet.disconnect();\n}\n\nasync function closeAudioContext(audioContext: AudioContext | undefined) {\n    if (!audioContext || audioContext.state === \"closed\") return;\n    return audioContext.close();\n}\n\nfunction handleAudioProcessingErrors(errors: Observable<LensCoreError>, reportError: (error: Error) => void) {\n    return errors\n        .pipe(\n            // Emit the first error immediately and debounce any subsequent errors for 1 second.\n            debounceTimeAfter(1, 1000),\n\n            map((event) => {\n                if (event.type === \"initial\") {\n                    reportError(\n                        new Error(\"The first audio processing error before debouncing.\", { cause: event.value })\n                    );\n                } else if (event.type === \"debounced\") {\n                    const errorMessages = [...new Set(event.values.map(stringifyErrorMessage))].join(\"\\n\");\n                    reportError(\n                        new Error(`Debounced ${event.values.length} audio processing errors.`, {\n                            cause: new Error(errorMessages),\n                        })\n                    );\n                }\n            })\n        )\n        .subscribe();\n}\n\n/**\n * Media stream source options.\n *\n * @category Rendering\n */\nexport interface MediaStreamSourceOptions extends CameraKitDeviceOptions {\n    /**\n     * Specifies the 2D transformation to apply to the Lens.\n     * By default, CameraKit applies no transformation.\n     */\n    transform: Transform2D;\n\n    /**\n     * Indicates whether the audio from the source should be disabled.\n     * By default, CameraKit passes audio to the Lens.\n     */\n    disableSourceAudio: boolean;\n}\n\n/**\n * Create a {@link CameraKitSource} from any\n * [MediaStream](https://developer.mozilla.org/en-US/docs/Web/API/MediaStream).\n *\n * @param stream Any MediaStream, such as obtained via `canvas.captureStream()` or `mediaDevices.getUserMedia()`.\n * @param options Options.\n *\n * @category Rendering\n */\nexport function createMediaStreamSource(\n    stream: MediaStream,\n    options: Partial<MediaStreamSourceOptions> = {}\n): CameraKitSource {\n    const { facingMode } =\n        stream.getVideoTracks().length > 0 ? stream.getVideoTracks()[0].getSettings() : { facingMode: undefined };\n\n    const detectedCameraType = facingMode === \"user\" || facingMode === \"environment\" ? facingMode : undefined;\n\n    const optionsWithDefaults = {\n        ...defaultOptions,\n        ...copyDefinedProperties(options),\n        cameraType: options.cameraType ?? detectedCameraType,\n    };\n\n    const enableSourceAudio: boolean = stream.getAudioTracks().length > 0 && !optionsWithDefaults.disableSourceAudio;\n\n    const simulateStereoAudio = true;\n    const sampleRate: number = 44100;\n\n    let audioContext: AudioContext | undefined = undefined;\n    let audioSource: MediaStreamAudioSourceNode | undefined = undefined;\n    let worklet: AudioWorkletNode | undefined = undefined;\n    let microphoneRecorderUrl: string;\n\n    if (enableSourceAudio) {\n        // https://developer.mozilla.org/en-US/docs/Web/API/Web_Audio_API/Using_AudioWorklet\n        const microphoneRecorderWorklet = `\n        class MicrophoneWorkletProcessor extends AudioWorkletProcessor {\n            process(inputs, outputs, parameters) {\n                this.port.postMessage({\n                    eventType: 'data',\n                    buffer: inputs\n                });\n                return true;\n            }\n        }\n        registerProcessor('microphone-worklet', MicrophoneWorkletProcessor);`;\n        const microphoneRecorderBlob = new Blob([microphoneRecorderWorklet], {\n            type: \"application/javascript\",\n        });\n        microphoneRecorderUrl = URL.createObjectURL(microphoneRecorderBlob);\n    }\n\n    // Subscription for audio processing errors.\n    let audioProcessingErrorSubscription: Subscription | undefined = undefined;\n\n    return new CameraKitSource(\n        { media: stream },\n        {\n            onAttach: async (source, lensCore, reportError) => {\n                await source.setTransform(optionsWithDefaults.transform);\n\n                if (enableSourceAudio) {\n                    // We call LensCore.processAudioSampleBuffer every time microphone data appears,\n                    // which occurs multiple times per second.\n                    // It may happen that LensCore enters an inoperable state, resulting in the call failing with\n                    // the same error over and over again.\n                    // Instead of reporting all errors, we debounce them within a second and only report two errors:\n                    // 1. The initial error when the debounce starts.\n                    // 2. An aggregated error that includes unique error messages from all errors\n                    // within the debounce period.\n                    const audioProcessingErrors = new Subject<LensCoreError>();\n                    audioProcessingErrorSubscription = handleAudioProcessingErrors(audioProcessingErrors, reportError);\n\n                    // Audio parameters set has to be called before lens is applied\n                    await lensCore.setAudioParameters({\n                        parameters: {\n                            numChannels: simulateStereoAudio ? 2 : 1,\n                            sampleRate,\n                        },\n                    });\n\n                    try {\n                        // There is a possibility of the onAttach method being called twice in a row due to a bug.\n                        // To ensure there are not leaks, it is better to close any existing connections.\n                        closeWorklet(worklet);\n                        audioSource?.disconnect();\n                        await closeAudioContext(audioContext);\n                    } catch (error) {\n                        // We still want to continue if anything above failed\n                        reportError(ensureError(error));\n                    }\n\n                    audioContext = new AudioContext();\n                    audioSource = audioContext.createMediaStreamSource(stream);\n                    const scopedAudioSource = audioSource;\n                    audioContext.audioWorklet\n                        .addModule(microphoneRecorderUrl)\n                        .then(() => {\n                            if (audioContext) {\n                                worklet = new AudioWorkletNode(audioContext, \"microphone-worklet\");\n                                scopedAudioSource.connect(worklet);\n                                worklet.connect(audioContext.destination);\n                                // NOTE: We subscribe to messages here, and they will continue to arrive\n                                // even after audioContext.close() is called. To disconnect the audio worklets\n                                // created here, we need to track two variables - worklet and audioSource.\n                                // By calling disconnect() on them, we can properly\n                                // disconnect the audio worklets.\n                                worklet.port.onmessage = (e) => {\n                                    if (e.data.eventType === \"data\") {\n                                        // developer.mozilla.org/en-US/docs/Web/API/AudioWorkletProcessor/process\n                                        // inputs[n][m] is the list of samples in the n-th input at the m-th channel.\n                                        const leftSamples = e.data.buffer[0][0] as Float32Array;\n\n                                        // Firefox might have leftSamples undefined:\n                                        // https://jira.sc-corp.net/browse/CAMKIT-5189\n                                        if (!leftSamples) return;\n\n                                        let inputBuffers = [leftSamples];\n                                        if (simulateStereoAudio) {\n                                            const rightSamples =\n                                                e.data.buffer[0].length > 1 ? e.data.buffer[0][1] : leftSamples.slice();\n                                            inputBuffers.push(rightSamples);\n                                        }\n\n                                        lensCore\n                                            .processAudioSampleBuffer({ input: inputBuffers })\n                                            .catch((error) => audioProcessingErrors.next(error));\n                                    }\n                                };\n                            }\n                        })\n                        .catch((error: Error) => {\n                            reportError(error);\n                        });\n                }\n            },\n            onDetach: async (reportError) => {\n                if (worklet) {\n                    closeWorklet(worklet);\n                    worklet = undefined;\n                }\n                if (audioSource) {\n                    audioSource.disconnect();\n                    audioSource = undefined;\n                }\n                if (audioContext) {\n                    await closeAudioContext(audioContext).catch(reportError);\n                    audioContext = undefined;\n                }\n                if (audioProcessingErrorSubscription) {\n                    audioProcessingErrorSubscription.unsubscribe();\n                    audioProcessingErrorSubscription = undefined;\n                }\n            },\n        },\n        optionsWithDefaults\n    );\n}\n"]}

package/dist/media-sources/VideoSource.d.ts

@@ -0,0 +1,27 @@
+import type { CameraKitDeviceOptions } from "./CameraKitSource";
+import { CameraKitSource } from "./CameraKitSource";
+/**
+ * Video source options.
+ *
+ * @category Rendering
+ */
+export interface VideoSourceOptions extends CameraKitDeviceOptions {
+    /**
+     * Optional pre-computed tracking data to enhance rendering performance.
+     * While not commonly provided, this can be used in specific scenarios
+     * where such data is available to optimize video processing.
+     */
+    trackingData: ArrayBuffer;
+}
+/**
+ * Create a {@link CameraKitSource} from an
+ * [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement).
+ *
+ * @param video CameraKit performs best when the source video is 720p – arbitrary resolutions are supported, but very
+ * high resolutions may not perform well.
+ * @param options Options.
+ *
+ * @category Rendering
+ */
+export declare function createVideoSource(video: HTMLVideoElement, options?: Partial<VideoSourceOptions>): CameraKitSource;
+//# sourceMappingURL=VideoSource.d.ts.map

package/dist/media-sources/VideoSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoSource.d.ts","sourceRoot":"","sources":["../../src/media-sources/VideoSource.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAqB,MAAM,mBAAmB,CAAC;AAOvE;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAC9D;;;;OAIG;IACH,YAAY,EAAE,WAAW,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,EAAE,OAAO,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAAG,eAAe,CAYrH"}

package/dist/media-sources/VideoSource.js

@@ -0,0 +1,12 @@
+import { copyDefinedProperties } from "../common/copyDefinedProperties";
+import { CameraKitSource, defaultDeviceInfo } from "./CameraKitSource";
+const defaultOptions = Object.assign(Object.assign({}, defaultDeviceInfo), { trackingData: new ArrayBuffer(0) });
+export function createVideoSource(video, options = {}) {
+    const { trackingData } = Object.assign(Object.assign({}, defaultOptions), copyDefinedProperties(options));
+    const replayTrackingData = trackingData.byteLength > 0 ? { buffer: trackingData } : undefined;
+    return new CameraKitSource({
+        media: video,
+        replayTrackingData,
+    }, {}, options);
+}
+//# sourceMappingURL=VideoSource.js.map

package/dist/media-sources/VideoSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VideoSource.js","sourceRoot":"","sources":["../../src/media-sources/VideoSource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEvE,MAAM,cAAc,mCACb,iBAAiB,KACpB,YAAY,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,GACnC,CAAC;AA0BF,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAE,UAAuC,EAAE;IAChG,MAAM,EAAE,YAAY,EAAE,mCAAQ,cAAc,GAAK,qBAAqB,CAAC,OAAO,CAAC,CAAE,CAAC;IAClF,MAAM,kBAAkB,GAAG,YAAY,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE9F,OAAO,IAAI,eAAe,CACtB;QACI,KAAK,EAAE,KAAK;QACZ,kBAAkB;KACrB,EACD,EAAE,EACF,OAAO,CACV,CAAC;AACN,CAAC","sourcesContent":["import { copyDefinedProperties } from \"../common/copyDefinedProperties\";\nimport type { CameraKitDeviceOptions } from \"./CameraKitSource\";\nimport { CameraKitSource, defaultDeviceInfo } from \"./CameraKitSource\";\n\nconst defaultOptions: VideoSourceOptions = {\n    ...defaultDeviceInfo,\n    trackingData: new ArrayBuffer(0),\n};\n\n/**\n * Video source options.\n *\n * @category Rendering\n */\nexport interface VideoSourceOptions extends CameraKitDeviceOptions {\n    /**\n     * Optional pre-computed tracking data to enhance rendering performance.\n     * While not commonly provided, this can be used in specific scenarios\n     * where such data is available to optimize video processing.\n     */\n    trackingData: ArrayBuffer;\n}\n\n/**\n * Create a {@link CameraKitSource} from an\n * [HTMLVideoElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLVideoElement).\n *\n * @param video CameraKit performs best when the source video is 720p – arbitrary resolutions are supported, but very\n * high resolutions may not perform well.\n * @param options Options.\n *\n * @category Rendering\n */\nexport function createVideoSource(video: HTMLVideoElement, options: Partial<VideoSourceOptions> = {}): CameraKitSource {\n    const { trackingData } = { ...defaultOptions, ...copyDefinedProperties(options) };\n    const replayTrackingData = trackingData.byteLength > 0 ? { buffer: trackingData } : undefined;\n\n    return new CameraKitSource(\n        {\n            media: video,\n            replayTrackingData,\n        },\n        {},\n        options\n    );\n}\n"]}

package/dist/metrics/businessEventsReporter.d.ts

@@ -0,0 +1,40 @@
+import * as blizzard from "../generated-proto/blizzard/cameraKitEvents";
+import type { MetricsClient } from "../clients/metricsClient";
+import type { CameraKitConfiguration } from "../configuration";
+import type { RemoteConfiguration } from "../remote-configuration/remoteConfiguration";
+import type { MetricsEventTarget } from "./metricsEventTarget";
+/**
+ * Translate between an external metric name, which is exposed to SDK users, and an internal Blizzard event name,
+ * property name, and constructor.
+ *
+ * It is very important that we do this, since the naming of these internal business events are unintuitive and will
+ * not make sense to SDK users.
+ *
+ * For a full list of business events (using their internal names), see:
+ * https://docs.google.com/document/d/1-kSzFWCWw9Qo3D08FR1_cqeHTsUtk9p3p3uOptzWDTY/
+ */
+type CameraKitBusinessEventMap = {
+    assetDownload: MakeBusinessEvent<blizzard.CameraKitAssetDownload>;
+    assetValidationFailed: MakeBusinessEvent<blizzard.CameraKitAssetValidationFailed>;
+    benchmarkComplete: MakeBusinessEvent<blizzard.CameraKitWebBenchmarkComplete>;
+    exception: MakeBusinessEvent<blizzard.CameraKitException>;
+    legalPrompt: MakeBusinessEvent<blizzard.CameraKitLegalPrompt>;
+    lensDownload: MakeBusinessEvent<blizzard.CameraKitLensDownload>;
+    lensView: MakeBusinessEvent<blizzard.CameraKitWebLensSwipe>;
+    lensWait: MakeBusinessEvent<blizzard.CameraKitLensSpin>;
+    lensContentValidationFailed: MakeBusinessEvent<blizzard.CameraKitLensContentValidationFailed>;
+    session: MakeBusinessEvent<blizzard.CameraKitSession>;
+};
+export type MakeBusinessEvent<E> = Omit<{
+    [K in keyof E]: Exclude<E[K], undefined> extends Record<keyof any, any> ? MakeBusinessEvent<Exclude<E[K], undefined>> : E[K];
+}, "cameraKitEventBase">;
+export type MakeTaggedBusinessEvent<K extends keyof CameraKitBusinessEventMap> = {
+    name: K;
+} & CameraKitBusinessEventMap[K];
+export declare const businessEventsReporterFactory: {
+    (args_0: MetricsEventTarget, args_1: MetricsClient, args_2: CameraKitConfiguration, args_3: RemoteConfiguration): void;
+    token: "businessEventsReporter";
+    dependencies: readonly ["metricsEventTarget", "metricsClient", "configuration", "remoteConfiguration"];
+};
+export {};
+//# sourceMappingURL=businessEventsReporter.d.ts.map

package/dist/metrics/businessEventsReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"businessEventsReporter.d.ts","sourceRoot":"","sources":["../../src/metrics/businessEventsReporter.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,QAAQ,MAAM,6CAA6C,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAOvF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAoB/D;;;;;;;;;GASG;AACH,KAAK,yBAAyB,GAAG;IAC7B,aAAa,EAAE,iBAAiB,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAAC;IAClE,qBAAqB,EAAE,iBAAiB,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IAClF,iBAAiB,EAAE,iBAAiB,CAAC,QAAQ,CAAC,6BAA6B,CAAC,CAAC;IAC7E,SAAS,EAAE,iBAAiB,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;IAC1D,WAAW,EAAE,iBAAiB,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAC;IAC9D,YAAY,EAAE,iBAAiB,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAChE,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;IAC5D,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACxD,2BAA2B,EAAE,iBAAiB,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC;IAC9F,OAAO,EAAE,iBAAiB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CACzD,CAAC;AAqIF,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,IAAI,CACnC;KACK,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,CAAC,GACjE,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAC3C,CAAC,CAAC,CAAC,CAAC;CACb,EACD,oBAAoB,CACvB,CAAC;AA+BF,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,MAAM,yBAAyB,IAAI;IAC7E,IAAI,EAAE,CAAC,CAAC;CACX,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAAC;AAEjC,eAAO,MAAM,6BAA6B;;;;CAyFzC,CAAC"}

package/dist/metrics/businessEventsReporter.js

@@ -0,0 +1,156 @@
+import { __awaiter } from "tslib";
+import { v4 } from "uuid";
+import { catchError, combineLatestWith, from, fromEvent, map, merge, of, switchMap, take } from "rxjs";
+import { entries } from "../common/entries";
+import { Injectable } from "../dependency-injection/Injectable";
+import * as blizzard from "../generated-proto/blizzard/cameraKitEvents";
+import { getLogger } from "../logger/logger";
+import { metricsClientFactory } from "../clients/metricsClient";
+import { configurationToken } from "../configuration";
+import { remoteConfigurationFactory } from "../remote-configuration/remoteConfiguration";
+import { IndexedDBPersistence } from "../persistence/IndexedDBPersistence";
+import { ExpiringPersistence } from "../persistence/ExpiringPersistence";
+import { convertDaysToSeconds } from "../common/time";
+import { getPlatformInfo } from "../platform/platformInfo";
+import { metricsEventTargetFactory } from "./metricsEventTarget";
+const logger = getLogger("BusinessEventsReporter");
+const connectivityTypeMapping = {
+    cellular: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_MOBILE,
+    bluetooth: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_BLUETOOTH,
+    wifi: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_WIFI,
+    unknown: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_UNKNOWN,
+    none: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_UNREACHABLE,
+};
+const vendorUuidKey = "vendorUuid";
+const vendorUuidExpiry = convertDaysToSeconds(60);
+const getOrGenerateVendorUuid = (persistence) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const storedUuid = yield persistence.retrieve(vendorUuidKey);
+        if (storedUuid) {
+            return storedUuid;
+        }
+        const newUuid = v4();
+        yield persistence.store(vendorUuidKey, newUuid);
+        return newUuid;
+    }
+    catch (error) {
+        throw new Error("Failed to generate vendor UUID");
+    }
+});
+function listenAndReport(metricsEventTarget, metricsClient, eventHandlers, appVendorAndPartnerUuid) {
+    const sessionId = v4();
+    logger.log(`Session ID: ${sessionId}`);
+    let sequenceId = 1;
+    const makeBlizzardEvent = (event, appVendorUuid, partnerUuid) => {
+        var _a;
+        const { sdkShortVersion, sdkLongVersion, lensCore, locale, origin, deviceModel, connectionType } = getPlatformInfo();
+        const deviceConnectivity = (_a = connectivityTypeMapping[connectionType]) !== null && _a !== void 0 ? _a : blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_UNKNOWN;
+        return Object.assign(Object.assign({}, event), { cameraKitEventBase: blizzard.CameraKitEventBase.fromPartial({
+                kitEventBase: blizzard.KitEventBase.fromPartial({
+                    locale,
+                    kitVariant: blizzard.KitType.CAMERA_KIT_WEB,
+                    kitVariantVersion: sdkShortVersion,
+                    kitClientTimestampMillis: `${Date.now()}`,
+                }),
+                deviceCluster: "0",
+                cameraKitVersion: sdkLongVersion,
+                lensCoreVersion: lensCore.version,
+                deviceModel,
+                cameraKitVariant: blizzard.CameraKitVariant.CAMERA_KIT_VARIANT_PARTNER,
+                cameraKitFlavor: blizzard.CameraKitFlavor.CAMERA_KIT_FLAVOR_DEBUG,
+                appId: origin,
+                deviceConnectivity,
+                sessionId,
+                appVendorUuid,
+                partnerUuid,
+            }) });
+    };
+    const sendServerEvent = (eventName, eventData) => {
+        const { osName: osType, osVersion } = getPlatformInfo();
+        return metricsClient.setBusinessEvents(blizzard.ServerEvent.fromPartial({
+            eventName,
+            osType,
+            osVersion,
+            maxSequenceIdOnInstance: "0",
+            sequenceId: `${sequenceId++}`,
+            eventData,
+        }));
+    };
+    const metricsEvents = entries(eventHandlers).map(([eventType, createEventData]) => fromEvent(metricsEventTarget, eventType).pipe(map((event) => ({ event, createEventData }))));
+    merge(...metricsEvents)
+        .pipe(combineLatestWith(appVendorAndPartnerUuid))
+        .subscribe(([{ event, createEventData }, { appVendorUuid, partnerUuid }]) => {
+        const [eventName, eventData] = createEventData(makeBlizzardEvent(event.detail, appVendorUuid, partnerUuid));
+        sendServerEvent(eventName, eventData);
+    });
+}
+function getAppVendorAndPartnerUuid(configuration, remoteConfiguration) {
+    const vendorAnalyticsPersistence = new ExpiringPersistence(() => vendorUuidExpiry, new IndexedDBPersistence({ databaseName: "VendorAnalytics" }));
+    return remoteConfiguration.getInitializationConfig().pipe(take(1), switchMap(({ appVendorUuidOptIn }) => {
+        const partnerUuid = configuration.analyticsId;
+        if (appVendorUuidOptIn) {
+            return from(getOrGenerateVendorUuid(vendorAnalyticsPersistence)).pipe(map((appVendorUuid) => ({ appVendorUuid, partnerUuid })));
+        }
+        return of({ appVendorUuid: undefined, partnerUuid });
+    }), catchError((error) => {
+        logger.warn(`Failed to retrieve or generate vendor UUID.`, error);
+        return of({ appVendorUuid: undefined, partnerUuid: configuration.analyticsId });
+    }));
+}
+export const businessEventsReporterFactory = Injectable("businessEventsReporter", [
+    metricsEventTargetFactory.token,
+    metricsClientFactory.token,
+    configurationToken,
+    remoteConfigurationFactory.token,
+], (metricsEventTarget, metricsClient, configuration, remoteConfiguration) => {
+    const appVendorAndPartnerUuid = getAppVendorAndPartnerUuid(configuration, remoteConfiguration);
+    listenAndReport(metricsEventTarget, metricsClient, {
+        assetDownload: (event) => [
+            "CAMERA_KIT_ASSET_DOWNLOAD",
+            { cameraKitAssetDownload: blizzard.CameraKitAssetDownload.fromPartial(event) },
+        ],
+        assetValidationFailed: (event) => [
+            "CAMERA_KIT_ASSET_VALIDATION_FAILED",
+            {
+                cameraKitAssetValidationFailed: blizzard.CameraKitAssetValidationFailed.fromPartial(event),
+            },
+        ],
+        benchmarkComplete: (event) => [
+            "CAMERA_KIT_WEB_BENCHMARK_COMPLETE",
+            {
+                cameraKitWebBenchmarkComplete: blizzard.CameraKitWebBenchmarkComplete.fromPartial(event),
+            },
+        ],
+        exception: (event) => [
+            "CAMERA_KIT_EXCEPTION",
+            { cameraKitException: blizzard.CameraKitException.fromPartial(event) },
+        ],
+        legalPrompt: (event) => [
+            "CAMERA_KIT_LEGAL_PROMPT",
+            { cameraKitLegalPrompt: blizzard.CameraKitLegalPrompt.fromPartial(event) },
+        ],
+        lensDownload: (event) => [
+            "CAMERA_KIT_LENS_DOWNLOAD",
+            { cameraKitLensDownload: blizzard.CameraKitLensDownload.fromPartial(event) },
+        ],
+        lensView: (event) => [
+            "CAMERA_KIT_WEB_LENS_SWIPE",
+            { cameraKitWebLensSwipe: blizzard.CameraKitWebLensSwipe.fromPartial(event) },
+        ],
+        lensWait: (event) => [
+            "CAMERA_KIT_LENS_SPIN",
+            { cameraKitLensSpin: blizzard.CameraKitLensSpin.fromPartial(event) },
+        ],
+        lensContentValidationFailed: (event) => [
+            "CAMERA_KIT_LENS_CONTENT_VALIDATION_FAILED",
+            {
+                cameraKitLensContentValidationFailed: blizzard.CameraKitLensContentValidationFailed.fromPartial(event),
+            },
+        ],
+        session: (event) => [
+            "CAMERA_KIT_SESSION",
+            { cameraKitSession: blizzard.CameraKitSession.fromPartial(event) },
+        ],
+    }, appVendorAndPartnerUuid);
+});
+//# sourceMappingURL=businessEventsReporter.js.map

package/dist/metrics/businessEventsReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"businessEventsReporter.js","sourceRoot":"","sources":["../../src/metrics/businessEventsReporter.ts"],"names":[],"mappings":"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","sourcesContent":["import { v4 } from \"uuid\";\nimport type { Observable } from \"rxjs\";\nimport { catchError, combineLatestWith, from, fromEvent, map, merge, of, switchMap, take } from \"rxjs\";\nimport { entries } from \"../common/entries\";\nimport { Injectable } from \"../dependency-injection/Injectable\";\nimport type { EventOfType } from \"../events/TypedCustomEvent\";\nimport type { EventsFromTarget } from \"../events/TypedEventTarget\";\nimport * as blizzard from \"../generated-proto/blizzard/cameraKitEvents\";\nimport { getLogger } from \"../logger/logger\";\nimport type { MetricsClient } from \"../clients/metricsClient\";\nimport { metricsClientFactory } from \"../clients/metricsClient\";\nimport type { CameraKitConfiguration } from \"../configuration\";\nimport { configurationToken } from \"../configuration\";\nimport type { RemoteConfiguration } from \"../remote-configuration/remoteConfiguration\";\nimport { remoteConfigurationFactory } from \"../remote-configuration/remoteConfiguration\";\nimport { IndexedDBPersistence } from \"../persistence/IndexedDBPersistence\";\nimport { ExpiringPersistence } from \"../persistence/ExpiringPersistence\";\nimport { convertDaysToSeconds } from \"../common/time\";\nimport type { ConnectionType } from \"../platform/platformInfo\";\nimport { getPlatformInfo } from \"../platform/platformInfo\";\nimport type { MetricsEventTarget } from \"./metricsEventTarget\";\nimport { metricsEventTargetFactory } from \"./metricsEventTarget\";\n\nconst logger = getLogger(\"BusinessEventsReporter\");\n\ntype Nullables<T> = { [K in keyof T]-?: undefined extends T[K] ? K : never }[keyof T];\ntype UndefinedToOptional<T> = Partial<Pick<T, Nullables<T>>> & Omit<T, Nullables<T>>;\n\ntype CameraKitBusinessEvents = EventsFromTarget<MetricsEventTarget>[\"detail\"];\n\ntype MakeBlizzardEvent<E> = Omit<E, \"name\"> & { cameraKitEventBase: blizzard.CameraKitEventBase };\n\ntype CreateEventData<EventType extends EventsFromTarget<MetricsEventTarget>[\"type\"]> = (\n    event: MakeBlizzardEvent<EventOfType<EventType, EventsFromTarget<MetricsEventTarget>>[\"detail\"]>\n) => [string, UndefinedToOptional<blizzard.ServerEventData>];\n\ntype EventHandlers = {\n    [EventType in EventsFromTarget<MetricsEventTarget>[\"type\"]]: CreateEventData<EventType>;\n};\n\n/**\n * Translate between an external metric name, which is exposed to SDK users, and an internal Blizzard event name,\n * property name, and constructor.\n *\n * It is very important that we do this, since the naming of these internal business events are unintuitive and will\n * not make sense to SDK users.\n *\n * For a full list of business events (using their internal names), see:\n * https://docs.google.com/document/d/1-kSzFWCWw9Qo3D08FR1_cqeHTsUtk9p3p3uOptzWDTY/\n */\ntype CameraKitBusinessEventMap = {\n    assetDownload: MakeBusinessEvent<blizzard.CameraKitAssetDownload>;\n    assetValidationFailed: MakeBusinessEvent<blizzard.CameraKitAssetValidationFailed>;\n    benchmarkComplete: MakeBusinessEvent<blizzard.CameraKitWebBenchmarkComplete>;\n    exception: MakeBusinessEvent<blizzard.CameraKitException>;\n    legalPrompt: MakeBusinessEvent<blizzard.CameraKitLegalPrompt>;\n    lensDownload: MakeBusinessEvent<blizzard.CameraKitLensDownload>;\n    lensView: MakeBusinessEvent<blizzard.CameraKitWebLensSwipe>;\n    lensWait: MakeBusinessEvent<blizzard.CameraKitLensSpin>;\n    lensContentValidationFailed: MakeBusinessEvent<blizzard.CameraKitLensContentValidationFailed>;\n    session: MakeBusinessEvent<blizzard.CameraKitSession>;\n};\n\ninterface AppVendorAndPartnerUuid {\n    appVendorUuid: string | undefined;\n    partnerUuid: string | undefined;\n}\n\nconst connectivityTypeMapping: Partial<Record<ConnectionType, blizzard.CameraKitConnectivityType>> = {\n    cellular: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_MOBILE,\n    bluetooth: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_BLUETOOTH,\n    wifi: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_WIFI,\n    unknown: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_UNKNOWN,\n    none: blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_UNREACHABLE,\n};\n\nconst vendorUuidKey = \"vendorUuid\";\nconst vendorUuidExpiry = convertDaysToSeconds(60);\n\n/**\n * Retrieves or generates a vendor UUID (Universally Unique Identifier).\n *\n * @param persistence - The persistence storage interface where UUID is stored.\n * @returns {Promise<string | undefined>} - A Promise that resolves to the vendor UUID or undefined,\n * if any failure occurs or opt-in is not enabled.\n */\nconst getOrGenerateVendorUuid = async (persistence: ExpiringPersistence<string>): Promise<string | undefined> => {\n    try {\n        const storedUuid = await persistence.retrieve(vendorUuidKey);\n        if (storedUuid) {\n            return storedUuid;\n        }\n\n        const newUuid = v4();\n        await persistence.store(vendorUuidKey, newUuid);\n\n        return newUuid;\n    } catch (error) {\n        throw new Error(\"Failed to generate vendor UUID\");\n    }\n};\n\nfunction listenAndReport(\n    metricsEventTarget: MetricsEventTarget,\n    metricsClient: MetricsClient,\n    eventHandlers: EventHandlers,\n    appVendorAndPartnerUuid: Observable<AppVendorAndPartnerUuid>\n): void {\n    const sessionId = v4();\n    logger.log(`Session ID: ${sessionId}`);\n\n    // Blizzard convention is to start the sequenceId at 1.\n    let sequenceId = 1;\n\n    const makeBlizzardEvent = <E extends CameraKitBusinessEvents>(\n        event: E,\n        appVendorUuid: string | undefined,\n        partnerUuid: string | undefined\n    ): MakeBlizzardEvent<E> => {\n        const { sdkShortVersion, sdkLongVersion, lensCore, locale, origin, deviceModel, connectionType } =\n            getPlatformInfo();\n\n        const deviceConnectivity =\n            connectivityTypeMapping[connectionType!] ??\n            blizzard.CameraKitConnectivityType.CAMERA_KIT_CONNECTIVITY_TYPE_UNKNOWN;\n\n        return {\n            ...event,\n            cameraKitEventBase: blizzard.CameraKitEventBase.fromPartial({\n                kitEventBase: blizzard.KitEventBase.fromPartial({\n                    locale,\n                    kitVariant: blizzard.KitType.CAMERA_KIT_WEB,\n                    kitVariantVersion: sdkShortVersion,\n                    kitClientTimestampMillis: `${Date.now()}`,\n                }),\n                deviceCluster: \"0\",\n                cameraKitVersion: sdkLongVersion,\n                lensCoreVersion: lensCore.version,\n                deviceModel,\n                cameraKitVariant: blizzard.CameraKitVariant.CAMERA_KIT_VARIANT_PARTNER,\n                cameraKitFlavor: blizzard.CameraKitFlavor.CAMERA_KIT_FLAVOR_DEBUG,\n                // We overload appId, using the origin instead because it's nice and human-readable (our backed adds\n                // the true appId as oauth_client_id before forwarding events to Blizzard).\n                appId: origin,\n                deviceConnectivity,\n                sessionId,\n                appVendorUuid,\n                partnerUuid,\n            }),\n        };\n    };\n\n    const sendServerEvent = (\n        eventName: string,\n        eventData: UndefinedToOptional<blizzard.ServerEventData>\n    ): Promise<void> => {\n        const { osName: osType, osVersion } = getPlatformInfo();\n        return metricsClient.setBusinessEvents(\n            blizzard.ServerEvent.fromPartial({\n                eventName,\n                osType,\n                osVersion,\n                maxSequenceIdOnInstance: \"0\",\n                sequenceId: `${sequenceId++}`,\n                eventData,\n            })\n        );\n    };\n\n    // Add event listeners for each event type and turn those listeners into Observables\n    const metricsEvents = entries(eventHandlers).map(([eventType, createEventData]) =>\n        fromEvent(metricsEventTarget, eventType).pipe(map((event) => ({ event, createEventData })))\n    );\n\n    // Subscribe to all the metrics events and combine them with the app/partner IDs obtained\n    // from remote configuration -- this means we'll queue up any metrics events that occur\n    // before remote config is downloaded, and send them once that config is available.\n    merge(...metricsEvents)\n        .pipe(combineLatestWith(appVendorAndPartnerUuid))\n        .subscribe(([{ event, createEventData }, { appVendorUuid, partnerUuid }]) => {\n            // Safety: When iterating over object keys in a mapped type, we lose the association between the key type\n            // and the value type – at each iteration, the key type is a union of all possible keys and the value type\n            // is a union of all possible values. When the value is a function with an argument, and that argument\n            // depends on the key type (which is a union), the contravariance of the argument type means that the union\n            // becomes an intersection. In our case here, this means the compiler expects each argument to contain all\n            // properties from all event types. The cast is safe because the mapped `EventHandlers` type ensures that\n            // `createEventData` takes an argument of the type corresponding its key's `eventType`'s event detail.\n            const [eventName, eventData] = createEventData(\n                makeBlizzardEvent(event.detail, appVendorUuid, partnerUuid) as any\n            );\n            sendServerEvent(eventName, eventData);\n        });\n}\n\nexport type MakeBusinessEvent<E> = Omit<\n    {\n        [K in keyof E]: Exclude<E[K], undefined> extends Record<keyof any, any>\n            ? MakeBusinessEvent<Exclude<E[K], undefined>>\n            : E[K];\n    },\n    \"cameraKitEventBase\"\n>;\n\nfunction getAppVendorAndPartnerUuid(\n    configuration: CameraKitConfiguration,\n    remoteConfiguration: RemoteConfiguration\n): Observable<AppVendorAndPartnerUuid> {\n    const vendorAnalyticsPersistence = new ExpiringPersistence<string>(\n        () => vendorUuidExpiry,\n        new IndexedDBPersistence({ databaseName: \"VendorAnalytics\" })\n    );\n\n    return remoteConfiguration.getInitializationConfig().pipe(\n        take(1),\n\n        switchMap(({ appVendorUuidOptIn }) => {\n            const partnerUuid = configuration.analyticsId;\n            if (appVendorUuidOptIn) {\n                return from(getOrGenerateVendorUuid(vendorAnalyticsPersistence)).pipe(\n                    map((appVendorUuid) => ({ appVendorUuid, partnerUuid }))\n                );\n            }\n            return of({ appVendorUuid: undefined, partnerUuid });\n        }),\n\n        catchError((error) => {\n            logger.warn(`Failed to retrieve or generate vendor UUID.`, error);\n            return of({ appVendorUuid: undefined, partnerUuid: configuration.analyticsId });\n        })\n    );\n}\n\nexport type MakeTaggedBusinessEvent<K extends keyof CameraKitBusinessEventMap> = {\n    name: K;\n} & CameraKitBusinessEventMap[K];\n\nexport const businessEventsReporterFactory = Injectable(\n    \"businessEventsReporter\",\n    [\n        metricsEventTargetFactory.token,\n        metricsClientFactory.token,\n        configurationToken,\n        remoteConfigurationFactory.token,\n    ] as const,\n    (\n        metricsEventTarget: MetricsEventTarget,\n        metricsClient: MetricsClient,\n        configuration: CameraKitConfiguration,\n        remoteConfiguration: RemoteConfiguration\n    ) => {\n        const appVendorAndPartnerUuid = getAppVendorAndPartnerUuid(configuration, remoteConfiguration);\n\n        /**\n         * This defines a mapping from a business event's external name (the name we document in public\n         * API docs), to its internal representation as a Blizzard ServerEvent.\n         *\n         * It is important that we do this, since the naming of these internal business events are\n         * unintuitive and will not make sense to SDK users.\n         *\n         * To specify the internal event, we must give the ServerEvent's eventName, the specific property\n         *  name which contains the event data (this is a \"oneof\" property on ServerEvent), and use the\n         * correct event type's `fromPartial` method (this is generated from the ServerEvent protobuf).\n         *\n         * These events are documented here:\n         * https://docs.google.com/document/d/1-kSzFWCWw9Qo3D08FR1_cqeHTsUtk9p3p3uOptzWDTY/\n         *\n         * They are defined in code here:\n         * https://github.sc-corp.net/Snapchat/snapchat/tree/master/blizzard/schema/blizzard-schema/\n         *  codeGen/src/main/java/com/snapchat/analytics/schema/events/cameraKit\n         */\n        listenAndReport(\n            metricsEventTarget,\n            metricsClient,\n            {\n                assetDownload: (event) => [\n                    \"CAMERA_KIT_ASSET_DOWNLOAD\",\n                    { cameraKitAssetDownload: blizzard.CameraKitAssetDownload.fromPartial(event) },\n                ],\n                assetValidationFailed: (event) => [\n                    \"CAMERA_KIT_ASSET_VALIDATION_FAILED\",\n                    {\n                        cameraKitAssetValidationFailed: blizzard.CameraKitAssetValidationFailed.fromPartial(event),\n                    },\n                ],\n                benchmarkComplete: (event) => [\n                    \"CAMERA_KIT_WEB_BENCHMARK_COMPLETE\",\n                    {\n                        cameraKitWebBenchmarkComplete: blizzard.CameraKitWebBenchmarkComplete.fromPartial(event),\n                    },\n                ],\n                exception: (event) => [\n                    \"CAMERA_KIT_EXCEPTION\",\n                    { cameraKitException: blizzard.CameraKitException.fromPartial(event) },\n                ],\n                legalPrompt: (event) => [\n                    \"CAMERA_KIT_LEGAL_PROMPT\",\n                    { cameraKitLegalPrompt: blizzard.CameraKitLegalPrompt.fromPartial(event) },\n                ],\n                lensDownload: (event) => [\n                    \"CAMERA_KIT_LENS_DOWNLOAD\",\n                    { cameraKitLensDownload: blizzard.CameraKitLensDownload.fromPartial(event) },\n                ],\n                lensView: (event) => [\n                    \"CAMERA_KIT_WEB_LENS_SWIPE\",\n                    { cameraKitWebLensSwipe: blizzard.CameraKitWebLensSwipe.fromPartial(event) },\n                ],\n                lensWait: (event) => [\n                    \"CAMERA_KIT_LENS_SPIN\",\n                    { cameraKitLensSpin: blizzard.CameraKitLensSpin.fromPartial(event) },\n                ],\n                lensContentValidationFailed: (event) => [\n                    \"CAMERA_KIT_LENS_CONTENT_VALIDATION_FAILED\",\n                    {\n                        cameraKitLensContentValidationFailed:\n                            blizzard.CameraKitLensContentValidationFailed.fromPartial(event),\n                    },\n                ],\n                session: (event) => [\n                    \"CAMERA_KIT_SESSION\",\n                    { cameraKitSession: blizzard.CameraKitSession.fromPartial(event) },\n                ],\n            },\n            appVendorAndPartnerUuid\n        );\n    }\n);\n"]}

package/dist/metrics/metricsEventTarget.d.ts

@@ -0,0 +1,42 @@
+import type { TypedCustomEvent } from "../events/TypedCustomEvent";
+import { TypedEventTarget } from "../events/TypedEventTarget";
+import type { AssetValidationFailed } from "../lens/assets/LensAssetsProvider";
+import type { AssetDownload, LensDownload } from "./reporters/reportLensAndAssetDownload";
+import type { LensContentValidationFailed } from "./reporters/reportLensValidationFailed";
+import type { LensView } from "./reporters/reportLensView";
+import type { LensWait } from "./reporters/reportLensWait";
+import type { Session } from "./reporters/reportUserSession";
+import type { BenchmarkComplete } from "./reporters/reportBenchmarks";
+import type { LegalPrompt } from "./reporters/reportLegalState";
+import type { MakeTaggedBusinessEvent } from "./businessEventsReporter";
+/**
+ * The Exception metric reports every time we handle an exception.
+ */
+export type Exception = MakeTaggedBusinessEvent<"exception">;
+export type CameraKitBootstrapMetricEvents = TypedCustomEvent<BenchmarkComplete["name"], BenchmarkComplete>;
+export type CameraKitSessionMetricEvents = TypedCustomEvent<LegalPrompt["name"], LegalPrompt> | TypedCustomEvent<LensView["name"], LensView> | TypedCustomEvent<LensWait["name"], LensWait> | TypedCustomEvent<LensDownload["name"], LensDownload> | TypedCustomEvent<AssetDownload["name"], AssetDownload> | TypedCustomEvent<AssetValidationFailed["name"], AssetValidationFailed> | TypedCustomEvent<LensContentValidationFailed["name"], LensContentValidationFailed> | TypedCustomEvent<Session["name"], Session>;
+/**
+ * A union of all event types emitted by the {@link CameraKit.events} event emitter.
+ *
+ * @internal
+ */
+export type CameraKitMetricEvents = CameraKitSessionMetricEvents | CameraKitBootstrapMetricEvents | TypedCustomEvent<Exception["name"], Exception>;
+/**
+ * This event target may be used to listen for any of the metrics events reported by CameraKit.
+ *
+ * @internal
+ */
+export type MetricsEventTarget = TypedEventTarget<CameraKitMetricEvents>;
+/**
+ * Any metrics that we wish to emit to applications should be dispatched on this event target.
+ *
+ * Our business events reporter also listens to this event target, and may report the emitted metrics to our backend.
+ *
+ * @internal
+ */
+export declare const metricsEventTargetFactory: {
+    (): MetricsEventTarget;
+    token: "metricsEventTarget";
+    dependencies: [];
+};
+//# sourceMappingURL=metricsEventTarget.d.ts.map

package/dist/metrics/metricsEventTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsEventTarget.d.ts","sourceRoot":"","sources":["../../src/metrics/metricsEventTarget.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,wCAAwC,CAAC;AAC1F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,uBAAuB,CAAC,WAAW,CAAC,CAAC;AAE7D,MAAM,MAAM,8BAA8B,GAAG,gBAAgB,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,CAAC;AAE5G,MAAM,MAAM,4BAA4B,GAClC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,GAClD,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAC5C,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAC5C,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,YAAY,CAAC,GACpD,gBAAgB,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC,GACtD,gBAAgB,CAAC,qBAAqB,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC,GACtE,gBAAgB,CAAC,2BAA2B,CAAC,MAAM,CAAC,EAAE,2BAA2B,CAAC,GAClF,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;AAEjD;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC3B,4BAA4B,GAC5B,8BAA8B,GAC9B,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,CAAC;AAErD;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,qBAAqB,CAAC,CAAC;AAEzE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;CAGrC,CAAC"}

package/dist/metrics/metricsEventTarget.js

@@ -0,0 +1,4 @@
+import { Injectable } from "../dependency-injection/Injectable";
+import { TypedEventTarget } from "../events/TypedEventTarget";
+export const metricsEventTargetFactory = Injectable("metricsEventTarget", () => new TypedEventTarget());
+//# sourceMappingURL=metricsEventTarget.js.map

package/dist/metrics/metricsEventTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsEventTarget.js","sourceRoot":"","sources":["../../src/metrics/metricsEventTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAoD9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAC/C,oBAAoB,EACpB,GAAuB,EAAE,CAAC,IAAI,gBAAgB,EAAE,CACnD,CAAC","sourcesContent":["import { Injectable } from \"../dependency-injection/Injectable\";\nimport type { TypedCustomEvent } from \"../events/TypedCustomEvent\";\nimport { TypedEventTarget } from \"../events/TypedEventTarget\";\nimport type { AssetValidationFailed } from \"../lens/assets/LensAssetsProvider\";\nimport type { AssetDownload, LensDownload } from \"./reporters/reportLensAndAssetDownload\";\nimport type { LensContentValidationFailed } from \"./reporters/reportLensValidationFailed\";\nimport type { LensView } from \"./reporters/reportLensView\";\nimport type { LensWait } from \"./reporters/reportLensWait\";\nimport type { Session } from \"./reporters/reportUserSession\";\nimport type { BenchmarkComplete } from \"./reporters/reportBenchmarks\";\nimport type { LegalPrompt } from \"./reporters/reportLegalState\";\nimport type { MakeTaggedBusinessEvent } from \"./businessEventsReporter\";\n\n/**\n * The Exception metric reports every time we handle an exception.\n */\nexport type Exception = MakeTaggedBusinessEvent<\"exception\">;\n\nexport type CameraKitBootstrapMetricEvents = TypedCustomEvent<BenchmarkComplete[\"name\"], BenchmarkComplete>;\n\nexport type CameraKitSessionMetricEvents =\n    | TypedCustomEvent<LegalPrompt[\"name\"], LegalPrompt>\n    | TypedCustomEvent<LensView[\"name\"], LensView>\n    | TypedCustomEvent<LensWait[\"name\"], LensWait>\n    | TypedCustomEvent<LensDownload[\"name\"], LensDownload>\n    | TypedCustomEvent<AssetDownload[\"name\"], AssetDownload>\n    | TypedCustomEvent<AssetValidationFailed[\"name\"], AssetValidationFailed>\n    | TypedCustomEvent<LensContentValidationFailed[\"name\"], LensContentValidationFailed>\n    | TypedCustomEvent<Session[\"name\"], Session>;\n\n/**\n * A union of all event types emitted by the {@link CameraKit.events} event emitter.\n *\n * @internal\n */\nexport type CameraKitMetricEvents =\n    | CameraKitSessionMetricEvents\n    | CameraKitBootstrapMetricEvents\n    | TypedCustomEvent<Exception[\"name\"], Exception>;\n\n/**\n * This event target may be used to listen for any of the metrics events reported by CameraKit.\n *\n * @internal\n */\nexport type MetricsEventTarget = TypedEventTarget<CameraKitMetricEvents>;\n\n/**\n * Any metrics that we wish to emit to applications should be dispatched on this event target.\n *\n * Our business events reporter also listens to this event target, and may report the emitted metrics to our backend.\n *\n * @internal\n */\nexport const metricsEventTargetFactory = Injectable(\n    \"metricsEventTarget\",\n    (): MetricsEventTarget => new TypedEventTarget()\n);\n"]}

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

@@ -0,0 +1,21 @@
+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 CountMetric = OperationalMetric & {
+    metric: Extract<OperationalMetric["metric"], {
+        $case: "count";
+    }>;
+};
+/** @internal */
+export declare function isCountMetric(value: OperationalMetric): value is CountMetric;
+/** @internal */
+export declare class Count extends Metric {
+    readonly name: string;
+    static count(name: string, n: number, dimensions?: MetricDimensions): Count;
+    private count;
+    constructor(name: string, dimensions?: MetricDimensions);
+    increment(count: number): number;
+    toOperationalMetric(): CountMetric[];
+}
+//# sourceMappingURL=Count.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Count.d.ts","sourceRoot":"","sources":["../../../src/metrics/operational/Count.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,WAAW,GAAG,iBAAiB,GAAG;IAC1C,MAAM,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACpE,CAAC;AAEF,gBAAgB;AAChB,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,WAAW,CAE5E;AAED,gBAAgB;AAChB,qBAAa,KAAM,SAAQ,MAAM;IASjB,QAAQ,CAAC,IAAI,EAAE,MAAM;IARjC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,GAAE,gBAAqB,GAAG,KAAK;IAM/E,OAAO,CAAC,KAAK,CAAK;gBAEG,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,gBAAqB;IAIpE,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAKhC,mBAAmB,IAAI,WAAW,EAAE;CASvC"}

package/dist/metrics/operational/Count.js

@@ -0,0 +1,31 @@
+import { Metric, serializeMetricDimensions } from "./Metric";
+export function isCountMetric(value) {
+    var _a;
+    return ((_a = value.metric) === null || _a === void 0 ? void 0 : _a.$case) === "count";
+}
+export class Count extends Metric {
+    static count(name, n, dimensions = {}) {
+        const count = new Count(name, dimensions);
+        count.increment(n);
+        return count;
+    }
+    constructor(name, dimensions = {}) {
+        super(name, dimensions);
+        this.name = name;
+        this.count = 0;
+    }
+    increment(count) {
+        this.count += count;
+        return this.count;
+    }
+    toOperationalMetric() {
+        return [
+            {
+                name: `${this.name}${serializeMetricDimensions(this.dimensions)}`,
+                timestamp: new Date(),
+                metric: { $case: "count", count: `${Math.ceil(this.count)}` },
+            },
+        ];
+    }
+}
+//# sourceMappingURL=Count.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Count.js","sourceRoot":"","sources":["../../../src/metrics/operational/Count.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAQ7D,MAAM,UAAU,aAAa,CAAC,KAAwB;;IAClD,OAAO,CAAA,MAAA,KAAK,CAAC,MAAM,0CAAE,KAAK,MAAK,OAAO,CAAC;AAC3C,CAAC;AAGD,MAAM,OAAO,KAAM,SAAQ,MAAM;IAC7B,MAAM,CAAC,KAAK,CAAC,IAAY,EAAE,CAAS,EAAE,aAA+B,EAAE;QACnE,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC1C,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACnB,OAAO,KAAK,CAAC;IACjB,CAAC;IAID,YAAqB,IAAY,EAAE,aAA+B,EAAE;QAChE,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QADP,SAAI,GAAJ,IAAI,CAAQ;QAFzB,UAAK,GAAG,CAAC,CAAC;IAIlB,CAAC;IAED,SAAS,CAAC,KAAa;QACnB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;QACpB,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,mBAAmB;QACf,OAAO;YACH;gBACI,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;gBACjE,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE;aAChE;SACJ,CAAC;IACN,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 CountMetric = OperationalMetric & {\n    metric: Extract<OperationalMetric[\"metric\"], { $case: \"count\" }>;\n};\n\n/** @internal */\nexport function isCountMetric(value: OperationalMetric): value is CountMetric {\n    return value.metric?.$case === \"count\";\n}\n\n/** @internal */\nexport class Count extends Metric {\n    static count(name: string, n: number, dimensions: MetricDimensions = {}): Count {\n        const count = new Count(name, dimensions);\n        count.increment(n);\n        return count;\n    }\n\n    private count = 0;\n\n    constructor(readonly name: string, dimensions: MetricDimensions = {}) {\n        super(name, dimensions);\n    }\n\n    increment(count: number): number {\n        this.count += count;\n        return this.count;\n    }\n\n    toOperationalMetric(): CountMetric[] {\n        return [\n            {\n                name: `${this.name}${serializeMetricDimensions(this.dimensions)}`,\n                timestamp: new Date(),\n                metric: { $case: \"count\", count: `${Math.ceil(this.count)}` },\n            },\n        ];\n    }\n}\n"]}