@snap/camera-kit 0.15.0 → 0.16.2

package/lib/CameraKit.d.ts

@@ -110,135 +110,135 @@ export declare class CameraKit {
 export declare const cameraKitFactory: {
     (args_0: LensRepository, args_1: MetricsEventTarget, args_2: {
         ErrorType: {
-            LensDeserialization: import("./lens-core-module").LensCoreEnumValue;
-            Validation: import("./lens-core-module").LensCoreEnumValue;
-            Uncategorized: import("./lens-core-module").LensCoreEnumValue;
-            LensExecution: import("./lens-core-module").LensCoreEnumValue;
-            Abort: import("./lens-core-module").LensCoreEnumValue;
-            Uninitialized: import("./lens-core-module").LensCoreEnumValue;
+            LensDeserialization: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Validation: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Uncategorized: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            LensExecution: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Abort: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Uninitialized: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         AssetType: {
-            RemoteMediaByUrl: import("./lens-core-module").LensCoreEnumValue;
-            DeviceDependent: import("./lens-core-module").LensCoreEnumValue;
-            Static: import("./lens-core-module").LensCoreEnumValue;
-            URL: import("./lens-core-module").LensCoreEnumValue;
-            BitmojiDynamicAsset: import("./lens-core-module").LensCoreEnumValue;
+            RemoteMediaByUrl: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            DeviceDependent: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Static: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            URL: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            BitmojiDynamicAsset: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         CanvasType: {
-            None: import("./lens-core-module").LensCoreEnumValue;
-            Preview: import("./lens-core-module").LensCoreEnumValue;
-            Capture: import("./lens-core-module").LensCoreEnumValue;
-            All: import("./lens-core-module").LensCoreEnumValue;
+            None: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Preview: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Capture: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            All: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         LensApiVisibility: {
-            Dev: import("./lens-core-module").LensCoreEnumValue;
-            Private: import("./lens-core-module").LensCoreEnumValue;
-            Public: import("./lens-core-module").LensCoreEnumValue;
+            Dev: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Private: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Public: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         DeviceClass: {
-            Undefined: import("./lens-core-module").LensCoreEnumValue;
-            BarelyWorking: import("./lens-core-module").LensCoreEnumValue;
-            LowEnd: import("./lens-core-module").LensCoreEnumValue;
-            MidEnd: import("./lens-core-module").LensCoreEnumValue;
-            HighEnd: import("./lens-core-module").LensCoreEnumValue;
+            Undefined: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            BarelyWorking: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            LowEnd: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            MidEnd: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            HighEnd: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         RenderLoopMode: {
-            SetTimeout: import("./lens-core-module").LensCoreEnumValue;
-            RequestAnimationFrame: import("./lens-core-module").LensCoreEnumValue;
+            SetTimeout: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            RequestAnimationFrame: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         UserDataAccess: {
-            Restricted: import("./lens-core-module").LensCoreEnumValue;
-            Unrestricted: import("./lens-core-module").LensCoreEnumValue;
+            Restricted: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Unrestricted: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         InterfaceControl: {
-            ToggleCameraButton: import("./lens-core-module").LensCoreEnumValue;
-            ImagePicker: import("./lens-core-module").LensCoreEnumValue;
-            Hint: import("./lens-core-module").LensCoreEnumValue;
-            Modal: import("./lens-core-module").LensCoreEnumValue;
-            LinkBitmojiCallToAction: import("./lens-core-module").LensCoreEnumValue;
-            SnapButton: import("./lens-core-module").LensCoreEnumValue;
-            PlayButton: import("./lens-core-module").LensCoreEnumValue;
-            All: import("./lens-core-module").LensCoreEnumValue;
-            ExitFullScreenButton: import("./lens-core-module").LensCoreEnumValue;
-            MemoriesButton: import("./lens-core-module").LensCoreEnumValue;
-            LensAttachmentButton: import("./lens-core-module").LensCoreEnumValue;
-            ReverseCamera: import("./lens-core-module").LensCoreEnumValue;
+            ToggleCameraButton: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            ImagePicker: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Hint: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Modal: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            LinkBitmojiCallToAction: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            SnapButton: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            PlayButton: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            All: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            ExitFullScreenButton: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            MemoriesButton: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            LensAttachmentButton: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            ReverseCamera: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         InterfaceAction: {
-            EnableHighlight: import("./lens-core-module").LensCoreEnumValue;
-            DisableHighlight: import("./lens-core-module").LensCoreEnumValue;
-            Trigger: import("./lens-core-module").LensCoreEnumValue;
-            Show: import("./lens-core-module").LensCoreEnumValue;
-            Hide: import("./lens-core-module").LensCoreEnumValue;
+            EnableHighlight: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            DisableHighlight: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Trigger: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Show: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            Hide: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         ExternalMediaOrientation: {
-            CW0: import("./lens-core-module").LensCoreEnumValue;
-            CW90: import("./lens-core-module").LensCoreEnumValue;
-            CW180: import("./lens-core-module").LensCoreEnumValue;
-            CW270: import("./lens-core-module").LensCoreEnumValue;
+            CW0: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            CW90: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            CW180: import("./lens-core-module/generated-types").LensCoreEnumValue;
+            CW270: import("./lens-core-module/generated-types").LensCoreEnumValue;
         };
         mainScriptUrlOrBlob: string;
     } & {
         getCoreVersion: () => number;
-        getOutputCanvases: () => import("./lens-core-module").GetOutputCanvasesOutput;
+        getOutputCanvases: () => import("./lens-core-module/generated-types").GetOutputCanvasesOutput;
         startProfiling: () => void;
         endProfiling: () => void;
-        registerUriListener: (scheme: string, route: string, listener: import("./lens-core-module").UriListener) => void;
-        provideUriResponse: (requestId: string, response: import("./lens-core-module").UriResponse) => void;
-        setRemoteAssetsProvider: (provider: import("./lens-core-module").SetRemoteAssetsProviderInput) => void;
-        setRemoteAssetsUploadHandler: (provider: import("./lens-core-module").SetRemoteAssetsUploadHandlerInput) => void;
-        provideRemoteAssetsUploadResponse: (assetResponse: import("./lens-core-module").ProvideRemoteAssetsUploadResponseInput) => void;
-        registerShowHintCallback: (callback: import("./lens-core-module").ShowHintCallback) => void;
-        registerHideHintCallback: (callback: import("./lens-core-module").HideHintCallback) => void;
-        registerSavePersistentStoreCallback: (callback: import("./lens-core-module").SavePersistentStoreCallback) => void;
-        setInterfaceControlVisibility: (config: import("./lens-core-module").SetInterfaceControlVisibilityInput) => void;
-        handleClientInterfaceAction: (config: import("./lens-core-module").HandleClientInterfaceActionInput) => void;
-        provideExternalImage: (config: import("./lens-core-module").ProvideExternalImageInput) => void;
-        provideExternalVideo: (config: import("./lens-core-module").ProvideExternalVideoInput) => void;
-        setScreenDimmingRequestHandler: (callback: import("./lens-core-module").ScreenDimmingRequestHandler) => void;
-        setClientInterfaceRequestHandler: (callback: import("./lens-core-module").ClientInterfaceRequestHandler) => void;
-        setPreloadedConfiguration: (config: import("./lens-core-module").SetPreloadedConfigurationInput) => void;
-        setAllSoundsMuted: (config: import("./lens-core-module").SetAllSoundsMutedInput) => void;
-        setSystemFonts: (config: import("./lens-core-module").SetSystemFontsInput) => void;
-        registerBeginWebXrHandler: (handler: ((config: import("./lens-core-module").BeginWebXrInput) => void) | null) => void;
+        registerUriListener: (scheme: string, route: string, listener: import("./lens-core-module/generated-types").UriListener) => void;
+        provideUriResponse: (requestId: string, response: import(".").UriResponse) => void;
+        setRemoteAssetsProvider: (provider: import("./lens-core-module/generated-types").SetRemoteAssetsProviderInput) => void;
+        setRemoteAssetsUploadHandler: (provider: import("./lens-core-module/generated-types").SetRemoteAssetsUploadHandlerInput) => void;
+        provideRemoteAssetsUploadResponse: (assetResponse: import("./lens-core-module/generated-types").ProvideRemoteAssetsUploadResponseInput) => void;
+        registerShowHintCallback: (callback: import("./lens-core-module/generated-types").ShowHintCallback) => void;
+        registerHideHintCallback: (callback: import("./lens-core-module/generated-types").HideHintCallback) => void;
+        registerSavePersistentStoreCallback: (callback: import("./lens-core-module/generated-types").SavePersistentStoreCallback) => void;
+        setInterfaceControlVisibility: (config: import("./lens-core-module/generated-types").SetInterfaceControlVisibilityInput) => void;
+        handleClientInterfaceAction: (config: import("./lens-core-module/generated-types").HandleClientInterfaceActionInput) => void;
+        provideExternalImage: (config: import("./lens-core-module/generated-types").ProvideExternalImageInput) => void;
+        provideExternalVideo: (config: import("./lens-core-module/generated-types").ProvideExternalVideoInput) => void;
+        setScreenDimmingRequestHandler: (callback: import("./lens-core-module/generated-types").ScreenDimmingRequestHandler) => void;
+        setClientInterfaceRequestHandler: (callback: import("./lens-core-module/generated-types").ClientInterfaceRequestHandler) => void;
+        setPreloadedConfiguration: (config: import("./lens-core-module/generated-types").SetPreloadedConfigurationInput) => void;
+        setAllSoundsMuted: (config: import("./lens-core-module/generated-types").SetAllSoundsMutedInput) => void;
+        setSystemFonts: (config: import("./lens-core-module/generated-types").SetSystemFontsInput) => void;
+        registerBeginWebXrHandler: (handler: ((config: import("./lens-core-module/generated-types").BeginWebXrInput) => void) | null) => void;
         registerEndWebXrHandler: (handler: (() => void) | null) => void;
     } & {
-        processFrame: (input: Omit<import("./lens-core-module").ProcessFrameInput, "onFailure" | "onSuccess">) => Promise<any>;
-        addLens: (input: Omit<import("./lens-core-module").AddLensInput, "onFailure" | "onSuccess">) => Promise<any>;
-        replaceLenses: (input: Omit<import("./lens-core-module").ReplaceLensesInput, "onFailure" | "onSuccess">) => Promise<any>;
-        removeLens: (input: Omit<import("./lens-core-module").RemoveLensInput, "onFailure" | "onSuccess">) => Promise<any>;
+        processFrame: (input: Omit<import("./lens-core-module/generated-types").ProcessFrameInput, "onFailure" | "onSuccess">) => Promise<any>;
+        addLens: (input: Omit<import("./lens-core-module/generated-types").AddLensInput, "onFailure" | "onSuccess">) => Promise<any>;
+        replaceLenses: (input: Omit<import("./lens-core-module/generated-types").ReplaceLensesInput, "onFailure" | "onSuccess">) => Promise<any>;
+        removeLens: (input: Omit<import("./lens-core-module/generated-types").RemoveLensInput, "onFailure" | "onSuccess">) => Promise<any>;
         clearAllLenses: () => Promise<any>;
         teardown: () => Promise<any>;
-        useMediaElement: (input: Omit<import("./lens-core-module").UseMediaElementInput, "onFailure" | "onSuccess">) => Promise<any>;
-        setFPSLimit: (input: Omit<import("./lens-core-module").SetFpsLimitInput, "onFailure" | "onSuccess">) => Promise<any>;
-        setRenderLoopMode: (input: Omit<import("./lens-core-module").SetRenderLoopInput, "onFailure" | "onSuccess">) => Promise<any>;
-        pauseCanvas: (input: Omit<import("./lens-core-module").PauseCanvasInput, "onFailure" | "onSuccess">) => Promise<any>;
-        setRenderSize: (input: Omit<import("./lens-core-module").SetRenderSizeMatchInputResolutionInput, "onFailure" | "onSuccess"> | Omit<import("./lens-core-module").SetRenderSizeExplicitInput, "onFailure" | "onSuccess">) => Promise<any>;
-        setInputTransform: (input: Omit<import("./lens-core-module").SetInputTransformInput, "onFailure" | "onSuccess">) => Promise<any>;
-        imageToYuvBuffer: (input: Omit<import("./lens-core-module").ImageToYuvBufferInput, "onFailure" | "onSuccess">) => Promise<ArrayBuffer>;
-        yuvBufferToBitmap: (input: Omit<import("./lens-core-module").YuvBufferToBitmapInput, "onFailure" | "onSuccess">) => Promise<ImageBitmap>;
-        setOnFrameProcessedCallback: (input: Omit<import("./lens-core-module").SetOnFrameProcessedInput, "onFailure" | "onSuccess">) => Promise<any>;
-        setDeviceClass: (input: Omit<import("./lens-core-module").SetDeviceClassInput, "onFailure" | "onSuccess">) => Promise<any>;
-        setAudioParameters: (input: Omit<import("./lens-core-module").SetAudioParametersInput, "onFailure" | "onSuccess">) => Promise<any>;
-        processAudioSampleBuffer: (input: Omit<import("./lens-core-module").ProcessAudioSampleBufferInput, "onFailure" | "onSuccess">) => Promise<any>;
+        useMediaElement: (input: Omit<import("./lens-core-module/generated-types").UseMediaElementInput, "onFailure" | "onSuccess">) => Promise<any>;
+        setFPSLimit: (input: Omit<import("./lens-core-module/generated-types").SetFpsLimitInput, "onFailure" | "onSuccess">) => Promise<any>;
+        setRenderLoopMode: (input: Omit<import("./lens-core-module/generated-types").SetRenderLoopInput, "onFailure" | "onSuccess">) => Promise<any>;
+        pauseCanvas: (input: Omit<import("./lens-core-module/generated-types").PauseCanvasInput, "onFailure" | "onSuccess">) => Promise<any>;
+        setRenderSize: (input: Omit<import("./lens-core-module/generated-types").SetRenderSizeMatchInputResolutionInput, "onFailure" | "onSuccess"> | Omit<import("./lens-core-module/generated-types").SetRenderSizeExplicitInput, "onFailure" | "onSuccess">) => Promise<any>;
+        setInputTransform: (input: Omit<import("./lens-core-module/generated-types").SetInputTransformInput, "onFailure" | "onSuccess">) => Promise<any>;
+        imageToYuvBuffer: (input: Omit<import("./lens-core-module/generated-types").ImageToYuvBufferInput, "onFailure" | "onSuccess">) => Promise<ArrayBuffer>;
+        yuvBufferToBitmap: (input: Omit<import("./lens-core-module/generated-types").YuvBufferToBitmapInput, "onFailure" | "onSuccess">) => Promise<ImageBitmap>;
+        setOnFrameProcessedCallback: (input: Omit<import("./lens-core-module/generated-types").SetOnFrameProcessedInput, "onFailure" | "onSuccess">) => Promise<any>;
+        setDeviceClass: (input: Omit<import("./lens-core-module/generated-types").SetDeviceClassInput, "onFailure" | "onSuccess">) => Promise<any>;
+        setAudioParameters: (input: Omit<import("./lens-core-module/generated-types").SetAudioParametersInput, "onFailure" | "onSuccess">) => Promise<any>;
+        processAudioSampleBuffer: (input: Omit<import("./lens-core-module/generated-types").ProcessAudioSampleBufferInput, "onFailure" | "onSuccess">) => Promise<any>;
     } & {
         initialize(input: {
             canvas?: string | HTMLCanvasElement | undefined;
-            outputResolution?: import("./lens-core-module").Dimensions | undefined;
+            outputResolution?: import("./lens-core-module/generated-types").Dimensions | undefined;
             showFpsPanel?: boolean | undefined;
             shouldUseWorker?: boolean | undefined;
-            onFrameProcessed?: ((arg: import("./lens-core-module").OnFrameProcessedParam) => void) | undefined;
-            xrCapabilities?: import("./lens-core-module").XrCapabilities | undefined;
+            onFrameProcessed?: ((arg: import("./lens-core-module/generated-types").OnFrameProcessedParam) => void) | undefined;
+            xrCapabilities?: import("./lens-core-module/generated-types").XrCapabilities | undefined;
             exceptionHandler?: ((err: LensCoreError) => void) | undefined;
         }): Promise<void>;
         provideRemoteAssetsResponse(input: {
             assetId: string;
-            assetType: import("./lens-core-module").LensCoreEnumValue;
+            assetType: import("./lens-core-module/generated-types").LensCoreEnumValue;
             assetBuffer?: ArrayBuffer | undefined;
             assetChecksum?: string | undefined;
             onFailure?: ((err: LensCoreError) => void) | undefined;
         }): void;
-        playCanvas(input: Omit<import("./lens-core-module").PlayCanvasInput, "onFailure" | "onSuccess" | "onReady">): Promise<void>;
+        playCanvas(input: Omit<import("./lens-core-module/generated-types").PlayCanvasInput, "onFailure" | "onSuccess" | "onReady">): Promise<void>;
     }, args_3: PageVisibility, args_4: Container<{
         LensRepository: LensRepository;
     } & {
@@ -250,6 +250,10 @@ export declare const cameraKitFactory: {
     } & {
         lensCore: LensCore;
     } & import("./dependency-injection/RootServices").PublicServices & import("./dependency-injection/types").ServicesFromInjectables<[{
+        (): PageVisibility;
+        token: "pageVisibility";
+        dependencies: [];
+    }, {
         (): MetricsEventTarget;
         token: "metricsEventTarget";
         dependencies: [];
@@ -258,33 +262,33 @@ export declare const cameraKitFactory: {
         token: "requestStateEventTarget";
         dependencies: [];
     }, {
-        (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers").FetchHandler): import("./handlers/HandlerChainBuilder").Handler<RequestInfo, Response, RequestInit | undefined>;
+        (args_0: import("./configuration").CameraKitConfiguration, args_1: import(".").FetchHandler): import("./handlers/HandlerChainBuilder").Handler<RequestInfo, Response, RequestInit | undefined>;
         token: "cameraKitServiceFetchHandler";
         dependencies: readonly ["configuration", "defaultFetchHandler"];
     }, {
-        (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers").FetchHandler): import("./clients/grpcHandler").GrpcHandler;
-        token: "grpcHandler";
+        (args_0: import("./configuration").CameraKitConfiguration, args_1: import(".").FetchHandler): import("./clients/grpcHandler").GrpcHandler;
+        token: "grpcHandlerFactory";
         dependencies: readonly ["configuration", "cameraKitServiceFetchHandler"];
     }, {
         (args_0: import("./clients/grpcHandler").GrpcHandler): import("./clients/lensesClient").LensesClient;
         token: "lensesClient";
-        dependencies: readonly ["grpcHandler"];
+        dependencies: readonly ["grpcHandlerFactory"];
     }, {
-        (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_2: import("./metrics/operational/operationalMetricsReporter").OperationalMetricsReporter): import("./handlers/HandlerChainBuilder").Handler<Partial<import("./generated-proto/pb_schema/cdp/cof/config_request").ConfigTargetingRequest>, import("./generated-proto/pb_schema/cdp/cof/config_response").ConfigTargetingResponse, import("./remote-configuration/cofHandler").Metadata & {
+        (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_2: import("./clients/metricsClient").MetricsClient): import("./handlers/HandlerChainBuilder").Handler<Partial<import("./generated-proto/pb_schema/cdp/cof/config_request").ConfigTargetingRequest>, import("./generated-proto/pb_schema/cdp/cof/config_response").ConfigTargetingResponse, import("./remote-configuration/cofHandler").Metadata & {
             signal?: AbortSignal | null | undefined;
             isSideEffect?: boolean | undefined;
         }>;
         token: "cofHandler";
-        dependencies: readonly ["configuration", "requestStateEventTarget", "operationalMetricsReporter"];
+        dependencies: readonly ["configuration", "requestStateEventTarget", "metricsClient"];
     }, {
         (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers/HandlerChainBuilder").Handler<Partial<import("./generated-proto/pb_schema/cdp/cof/config_request").ConfigTargetingRequest>, import("./generated-proto/pb_schema/cdp/cof/config_response").ConfigTargetingResponse, import("./remote-configuration/cofHandler").Metadata & {
             signal?: AbortSignal | null | undefined;
             isSideEffect?: boolean | undefined;
-        }>, args_2: import("./handlers").FetchHandler): import("./remote-configuration/remoteConfiguration").RemoteConfiguration;
+        }>, args_2: import("./clients/grpcHandler").GrpcHandler): import("./remote-configuration/remoteConfiguration").RemoteConfiguration;
         token: "remoteConfiguration";
-        dependencies: readonly ["configuration", "cofHandler", "cameraKitServiceFetchHandler"];
+        dependencies: readonly ["configuration", "cofHandler", "grpcHandlerFactory"];
     }, {
-        (args_0: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_1: import("./handlers").FetchHandler, args_2: import(".").LensSource[], args_3: import("./lens/assets/LensAssetRepository").LensAssetRepository): LensRepository;
+        (args_0: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_1: import(".").FetchHandler, args_2: import(".").LensSource[], args_3: import("./lens/assets/LensAssetRepository").LensAssetRepository): LensRepository;
         token: "LensRepository";
         dependencies: readonly ["requestStateEventTarget", "defaultFetchHandler", "lensSources", "lensAssetRepository"];
     }, {
@@ -292,23 +296,19 @@ export declare const cameraKitFactory: {
         token: "lensPersistenceStore";
         dependencies: readonly ["lensCore"];
     }, {
-        (args_0: import("./handlers").FetchHandler, args_1: PageVisibility): import("./handlers/HandlerChainBuilder").Handler<RequestInfo, Response, RequestInit | undefined>;
-        token: "metricsHandler";
-        dependencies: readonly ["cameraKitServiceFetchHandler", "pageVisibility"];
-    }, {
-        (args_0: import("./handlers").FetchHandler, args_1: PageVisibility, args_2: import("./configuration").CameraKitConfiguration): import("./metrics/operational/operationalMetricsReporter").OperationalMetricsReporter;
-        token: "operationalMetricsReporter";
-        dependencies: readonly ["metricsHandler", "pageVisibility", "configuration"];
+        (args_0: import("rxjs").Subject<import(".").Metric>, args_1: import("./clients/grpcHandler").GrpcHandler, args_2: PageVisibility): import("./clients/metricsClient").MetricsClient;
+        token: "metricsClient";
+        dependencies: readonly ["externalMetricsSubject", "grpcHandlerFactory", "pageVisibility"];
     }, {
         (args_0: LensCore, args_1: import(".").AssetLoader, args_2: import(".").AssetLoader, args_3: import(".").AssetLoader, args_4: MetricsEventTarget, args_5: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget): import("./lens/assets/LensAssetRepository").LensAssetRepository;
         token: "lensAssetRepository";
         dependencies: readonly ["lensCore", "deviceDependentAssetLoader", "remoteMediaAssetLoader", "staticAssetLoader", "metricsEventTarget", "requestStateEventTarget"];
     }, {
-        (args_0: import("./handlers").FetchHandler, args_1: import("./remote-configuration/remoteConfiguration").RemoteConfiguration): import(".").AssetLoader;
+        (args_0: import(".").FetchHandler, args_1: import("./remote-configuration/remoteConfiguration").RemoteConfiguration): import(".").AssetLoader;
         token: "deviceDependentAssetLoader";
         dependencies: readonly ["defaultFetchHandler", "remoteConfiguration"];
     }, {
-        (args_0: import("./handlers").FetchHandler): import(".").AssetLoader;
+        (args_0: import(".").FetchHandler): import(".").AssetLoader;
         token: "staticAssetLoader";
         dependencies: readonly ["defaultFetchHandler"];
     }, {
@@ -324,9 +324,9 @@ export declare const cameraKitFactory: {
         token: "logEntries";
         dependencies: [];
     }, {
-        (args_0: import("rxjs").Observable<import("./logger/logger").LogEntry>, args_1: MetricsEventTarget, args_2: import("./metrics/operational/operationalMetricsReporter").OperationalMetricsReporter): import("./metrics/reporters/reportGlobalException").GlobalExceptionReporter;
+        (args_0: import("rxjs").Observable<import("./logger/logger").LogEntry>, args_1: MetricsEventTarget, args_2: import("./clients/metricsClient").MetricsClient): import("./metrics/reporters/reportGlobalException").GlobalExceptionReporter;
         token: "reportGlobalException";
-        dependencies: readonly ["logEntries", "metricsEventTarget", "operationalMetricsReporter"];
+        dependencies: readonly ["logEntries", "metricsEventTarget", "metricsClient"];
     }]>>): CameraKit;
     token: "CameraKit";
     dependencies: readonly ["LensRepository", "metricsEventTarget", "lensCore", "pageVisibility", "$container"];

package/lib/CameraKit.js

@@ -99,7 +99,7 @@ export class CameraKit {
             };
             /**
              * If/when we add support for multiple concurrent sessions, we'll need to create a copy of the LensCore WASM
-             * module. If we move managing web workers into JS, spawing a new worker thread with its own copy of LensCore
+             * module. If we move managing web workers into JS, spawning a new worker thread with its own copy of LensCore
              * probably becomes a lot more straightforward.
              *
              * Currently chromium has a bug preventing rendering while tab is hidden when LensCore is in worker mode.

package/lib/CameraKit.js.map

@@ -1 +1 @@
-{"version":3,"file":"CameraKit.js","sourceRoot":"","sources":["../src/CameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import { lensRepositoryFactory, LensRepository } from \"./lens/LensRepository\";\nimport { CONTAINER, Container } from \"./dependency-injection/Container\";\nimport { Injectable } from \"./dependency-injection/Injectable\";\nimport { LensCoreError } from \"./lens-core-module/lensCoreError\";\nimport { LensCore } from \"./lens-core-module/lensCore\";\nimport { CameraKitSession, cameraKitSessionFactory } from \"./session/CameraKitSession\";\nimport { registerLensAssetsProvider } from \"./lens/assets/LensAssetsProvider\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { configurationToken } from \"./configuration\";\nimport { RootServices } from \"./dependency-injection/RootServices\";\nimport { registerUriHandlers } from \"./extensions/uriHandlersRegister\";\nimport { MetricsEventTarget, metricsEventTargetFactory } from \"./metrics/metricsEventTarget\";\nimport { reportSessionScopedMetrics } from \"./metrics/reporters/reporters\";\nimport { lensStateFactory } from \"./session/lensState\";\nimport { lensKeyboardFactory } from \"./session/LensKeyboard\";\nimport { registerLensClientInterfaceHandler } from \"./lens-client-interface/lensClientInterface\";\nimport { sessionStateFactory } from \"./session/sessionState\";\nimport { lensExecutionError, lensAbortError } from \"./namedErrors\";\nimport { getLogger, resetLogger } from \"./logger/logger\";\nimport { errorLoggingDecorator } from \"./logger/errorLoggingDecorator\";\nimport { TypedEventTarget } from \"./events/TypedEventTarget\";\nimport { TypedCustomEvent } from \"./events/TypedCustomEvent\";\nimport { LensView } from \"./metrics/reporters/reportLensView\";\nimport { LensWait } from \"./metrics/reporters/reportLensWait\";\nimport { PageVisibility, pageVisibilityFactory } from \"./common/pageVisibility\";\nimport { setPreloadedConfiguration } from \"./remote-configuration/preloadConfiguration\";\n\nconst logger = getLogger(\"CameraKit\");\nconst log = errorLoggingDecorator(logger);\n\n/**\n * Metrics event names that are exposed to apps.\n */\nconst publicMetricsEventNames: Array<LensMetricsEvents[\"detail\"][\"name\"]> = [\"lensView\", \"lensWait\"];\n\n/**\n * Lens metrics events.\n *\n * These events are emitted by {@link CameraKit} to report lens usage, performance, apply latency, etc.\n *\n * @category Lenses\n * @category Metrics\n */\nexport type LensMetricsEvents =\n    | TypedCustomEvent<LensView[\"name\"], LensView>\n    | TypedCustomEvent<LensWait[\"name\"], LensWait>;\n\n/**\n * Options available when creating a {@link CameraKitSession}.\n *\n * @category Rendering\n */\nexport interface CreateSessionOptions {\n    /**\n     * Optionally provide an existing canvas element, on which the Live RenderTarget will be rendered.\n     *\n     * If this is not provided, CameraKit will create a new canvas element which can be added to the DOM.\n     */\n    liveRenderTarget?: HTMLCanvasElement;\n\n    /**\n     * Browsers optimize tabs when they are hidden - for example, by pausing the execution of requestAnimationFrame\n     * callbacks.\n     *\n     * If you need the CameraKitSession to continue rendering even when the tab is in the background, set this to true.\n     * There is a small performance penalty, and it's a good practice to only render in the background if absolutely\n     * necessary.\n     */\n    renderWhileTabHidden?: boolean;\n}\n\n/**\n * The entry point to the CameraKit SDK's API. Most of CameraKit's features are accessed via this class.\n *\n * Applications obtain an instance of CameraKit by calling {@link bootstrapCameraKit}.\n *\n * @example\n * ```ts\n * const cameraKit = await bootstrapCameraKit(config)\n * ```\n *\n * Then this class can be used to:\n * - Create a {@link CameraKitSession} instance, which provides the API for setting up media inputs, applying Lenses,\n * and obtaining rendered `<canvas>` outputs.\n * - Query for lenses using {@link LensRepository}.\n * - Listen for lens usage metrics events using {@link MetricsEventTarget}.\n *\n * @category Rendering\n * @category Lenses\n */\nexport class CameraKit {\n    /** @deprecated Use {@link lensRepository} */\n    readonly lenses: { repository: LensRepository };\n\n    /**\n     * Business metrics (e.g. each time a lens is viewed) are emitted here.\n     */\n    readonly metrics: TypedEventTarget<LensMetricsEvents> = new TypedEventTarget();\n\n    private sessions: CameraKitSession[] = [];\n\n    /** @internal */\n    constructor(\n        /**\n         * Used to query for lenses and lens groups.\n         */\n        readonly lensRepository: LensRepository,\n\n        private readonly lensCore: LensCore,\n        private readonly pageVisibility: PageVisibility,\n        private readonly container: Container<RootServices>,\n        allMetrics: MetricsEventTarget\n    ) {\n        this.lenses = { repository: this.lensRepository };\n        // Proxy only a subset of all metrics events to the public-facing emitter -- applications don't need to\n        // know about most events.\n        publicMetricsEventNames.forEach((eventName) => {\n            allMetrics.addEventListener(eventName, (e) => this.metrics.dispatchEvent(e));\n        });\n    }\n\n    /**\n     * Create a CameraKitSession.\n     *\n     * This initializes the rendering engine and returns a {@link CameraKitSession} instance, which provides access\n     * to Lens rendering.\n     *\n     * @example\n     * ```ts\n     * const cameraKit = await bootstrapCameraKit(config)\n     * const session = await cameraKit.createSession()\n     *\n     * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)\n     * session.applyLens(lens)\n     * ```\n     *\n     * @param options\n     */\n    @log\n    async createSession({\n        liveRenderTarget,\n        renderWhileTabHidden,\n    }: CreateSessionOptions = {}): Promise<CameraKitSession> {\n        // Any error happened during lens rendering can be processed by subscribing to sessionErrors\n        const exceptionHandler = (error: LensCoreError) => {\n            if (error.name === \"LensCoreAbortError\") {\n                logger.error(\n                    lensAbortError(\n                        \"Unrecoverable error occurred during lens execution. \" +\n                            \"The CameraKitSession will be destroyed.\",\n                        error\n                    )\n                );\n            } else {\n                logger.error(\n                    lensExecutionError(\n                        \"Error occurred during lens execution. \" +\n                            \"The lens cannot be rendered and will be removed from the CameraKitSession.\",\n                        error\n                    )\n                );\n            }\n        };\n\n        /**\n         * If/when we add support for multiple concurrent sessions, we'll need to create a copy of the LensCore WASM\n         * module. If we move managing web workers into JS, spawing a new worker thread with its own copy of LensCore\n         * probably becomes a lot more straightforward.\n         *\n         * Currently chromium has a bug preventing rendering while tab is hidden when LensCore is in worker mode.\n         * In order to process tab while it is hidden, the current stopgap is to pass in renderWhileTabHidden as true,\n         * which will initiate session in non worker mode, and set the RenderLoopMode to `SetTimeout`.\n         */\n        await this.lensCore.initialize({\n            canvas: liveRenderTarget,\n            shouldUseWorker: !renderWhileTabHidden && this.container.get(configurationToken).shouldUseWorker,\n            exceptionHandler,\n        });\n\n        await this.lensCore.setRenderLoopMode({\n            mode: renderWhileTabHidden\n                ? this.lensCore.RenderLoopMode.SetTimeout\n                : this.lensCore.RenderLoopMode.RequestAnimationFrame,\n        });\n\n        // Each session gets its own DI Container – some Services provided by this Container may be shared with the\n        // root CameraKit Container, but others may be scoped to the session by passing their token to `copy()`.\n        const sessionContainer = this.container\n            // Right now this is a no-op. If/when we add support for multiple concurrent sessions, we may end up\n            // scoping LensCore to the session.\n            .copy()\n\n            .provides(sessionStateFactory)\n            .provides(lensStateFactory)\n            .provides(lensKeyboardFactory)\n            .provides(cameraKitSessionFactory)\n\n            .run(registerLensAssetsProvider)\n            .run(registerLensClientInterfaceHandler)\n            .run(setPreloadedConfiguration)\n\n            // We'll run a PartialContainer containing reporters for session-scoped metrics. Running this container\n            // allows each metric reporter to initialize itself (e.g. by adding event listeners to detect when certain\n            // actions occur).\n            .run(reportSessionScopedMetrics)\n\n            // UriHandlers may have dependencies on session-scoped services (e.g. LensState, LensKeyboard), so they'll\n            // be registered with LensCore here.\n            .run(registerUriHandlers);\n\n        const session = sessionContainer.get(cameraKitSessionFactory.token);\n        this.sessions.push(session);\n        return session;\n    }\n\n    /**\n     * Destroys all sessions and frees all resources.\n     */\n    @log\n    async destroy() {\n        resetLogger();\n        this.pageVisibility.destroy();\n        await Promise.all(this.sessions.map((session) => session.destroy()));\n        this.sessions = [];\n    }\n}\n\n/** @internal */\nexport const cameraKitFactory = Injectable(\n    \"CameraKit\",\n    [\n        lensRepositoryFactory.token,\n        metricsEventTargetFactory.token,\n        lensCoreFactory.token,\n        pageVisibilityFactory.token,\n        CONTAINER,\n    ] as const,\n    (\n        lensRepository: LensRepository,\n        metrics: MetricsEventTarget,\n        lensCore: LensCore,\n        pageVisibility: PageVisibility,\n        container: Container<RootServices>\n    ) => new CameraKit(lensRepository, lensCore, pageVisibility, container, metrics)\n);\n"]}
+{"version":3,"file":"CameraKit.js","sourceRoot":"","sources":["../src/CameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import { lensRepositoryFactory, LensRepository } from \"./lens/LensRepository\";\nimport { CONTAINER, Container } from \"./dependency-injection/Container\";\nimport { Injectable } from \"./dependency-injection/Injectable\";\nimport { LensCoreError } from \"./lens-core-module/lensCoreError\";\nimport { LensCore } from \"./lens-core-module/lensCore\";\nimport { CameraKitSession, cameraKitSessionFactory } from \"./session/CameraKitSession\";\nimport { registerLensAssetsProvider } from \"./lens/assets/LensAssetsProvider\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { configurationToken } from \"./configuration\";\nimport { RootServices } from \"./dependency-injection/RootServices\";\nimport { registerUriHandlers } from \"./extensions/uriHandlersRegister\";\nimport { MetricsEventTarget, metricsEventTargetFactory } from \"./metrics/metricsEventTarget\";\nimport { reportSessionScopedMetrics } from \"./metrics/reporters/reporters\";\nimport { lensStateFactory } from \"./session/lensState\";\nimport { lensKeyboardFactory } from \"./session/LensKeyboard\";\nimport { registerLensClientInterfaceHandler } from \"./lens-client-interface/lensClientInterface\";\nimport { sessionStateFactory } from \"./session/sessionState\";\nimport { lensExecutionError, lensAbortError } from \"./namedErrors\";\nimport { getLogger, resetLogger } from \"./logger/logger\";\nimport { errorLoggingDecorator } from \"./logger/errorLoggingDecorator\";\nimport { TypedEventTarget } from \"./events/TypedEventTarget\";\nimport { TypedCustomEvent } from \"./events/TypedCustomEvent\";\nimport { LensView } from \"./metrics/reporters/reportLensView\";\nimport { LensWait } from \"./metrics/reporters/reportLensWait\";\nimport { PageVisibility, pageVisibilityFactory } from \"./common/pageVisibility\";\nimport { setPreloadedConfiguration } from \"./remote-configuration/preloadConfiguration\";\n\nconst logger = getLogger(\"CameraKit\");\nconst log = errorLoggingDecorator(logger);\n\n/**\n * Metrics event names that are exposed to apps.\n */\nconst publicMetricsEventNames: Array<LensMetricsEvents[\"detail\"][\"name\"]> = [\"lensView\", \"lensWait\"];\n\n/**\n * Lens metrics events.\n *\n * These events are emitted by {@link CameraKit} to report lens usage, performance, apply latency, etc.\n *\n * @category Lenses\n * @category Metrics\n */\nexport type LensMetricsEvents =\n    | TypedCustomEvent<LensView[\"name\"], LensView>\n    | TypedCustomEvent<LensWait[\"name\"], LensWait>;\n\n/**\n * Options available when creating a {@link CameraKitSession}.\n *\n * @category Rendering\n */\nexport interface CreateSessionOptions {\n    /**\n     * Optionally provide an existing canvas element, on which the Live RenderTarget will be rendered.\n     *\n     * If this is not provided, CameraKit will create a new canvas element which can be added to the DOM.\n     */\n    liveRenderTarget?: HTMLCanvasElement;\n\n    /**\n     * Browsers optimize tabs when they are hidden - for example, by pausing the execution of requestAnimationFrame\n     * callbacks.\n     *\n     * If you need the CameraKitSession to continue rendering even when the tab is in the background, set this to true.\n     * There is a small performance penalty, and it's a good practice to only render in the background if absolutely\n     * necessary.\n     */\n    renderWhileTabHidden?: boolean;\n}\n\n/**\n * The entry point to the CameraKit SDK's API. Most of CameraKit's features are accessed via this class.\n *\n * Applications obtain an instance of CameraKit by calling {@link bootstrapCameraKit}.\n *\n * @example\n * ```ts\n * const cameraKit = await bootstrapCameraKit(config)\n * ```\n *\n * Then this class can be used to:\n * - Create a {@link CameraKitSession} instance, which provides the API for setting up media inputs, applying Lenses,\n * and obtaining rendered `<canvas>` outputs.\n * - Query for lenses using {@link LensRepository}.\n * - Listen for lens usage metrics events using {@link MetricsEventTarget}.\n *\n * @category Rendering\n * @category Lenses\n */\nexport class CameraKit {\n    /** @deprecated Use {@link lensRepository} */\n    readonly lenses: { repository: LensRepository };\n\n    /**\n     * Business metrics (e.g. each time a lens is viewed) are emitted here.\n     */\n    readonly metrics: TypedEventTarget<LensMetricsEvents> = new TypedEventTarget();\n\n    private sessions: CameraKitSession[] = [];\n\n    /** @internal */\n    constructor(\n        /**\n         * Used to query for lenses and lens groups.\n         */\n        readonly lensRepository: LensRepository,\n\n        private readonly lensCore: LensCore,\n        private readonly pageVisibility: PageVisibility,\n        private readonly container: Container<RootServices>,\n        allMetrics: MetricsEventTarget\n    ) {\n        this.lenses = { repository: this.lensRepository };\n        // Proxy only a subset of all metrics events to the public-facing emitter -- applications don't need to\n        // know about most events.\n        publicMetricsEventNames.forEach((eventName) => {\n            allMetrics.addEventListener(eventName, (e) => this.metrics.dispatchEvent(e));\n        });\n    }\n\n    /**\n     * Create a CameraKitSession.\n     *\n     * This initializes the rendering engine and returns a {@link CameraKitSession} instance, which provides access\n     * to Lens rendering.\n     *\n     * @example\n     * ```ts\n     * const cameraKit = await bootstrapCameraKit(config)\n     * const session = await cameraKit.createSession()\n     *\n     * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)\n     * session.applyLens(lens)\n     * ```\n     *\n     * @param options\n     */\n    @log\n    async createSession({\n        liveRenderTarget,\n        renderWhileTabHidden,\n    }: CreateSessionOptions = {}): Promise<CameraKitSession> {\n        // Any error happened during lens rendering can be processed by subscribing to sessionErrors\n        const exceptionHandler = (error: LensCoreError) => {\n            if (error.name === \"LensCoreAbortError\") {\n                logger.error(\n                    lensAbortError(\n                        \"Unrecoverable error occurred during lens execution. \" +\n                            \"The CameraKitSession will be destroyed.\",\n                        error\n                    )\n                );\n            } else {\n                logger.error(\n                    lensExecutionError(\n                        \"Error occurred during lens execution. \" +\n                            \"The lens cannot be rendered and will be removed from the CameraKitSession.\",\n                        error\n                    )\n                );\n            }\n        };\n\n        /**\n         * If/when we add support for multiple concurrent sessions, we'll need to create a copy of the LensCore WASM\n         * module. If we move managing web workers into JS, spawning a new worker thread with its own copy of LensCore\n         * probably becomes a lot more straightforward.\n         *\n         * Currently chromium has a bug preventing rendering while tab is hidden when LensCore is in worker mode.\n         * In order to process tab while it is hidden, the current stopgap is to pass in renderWhileTabHidden as true,\n         * which will initiate session in non worker mode, and set the RenderLoopMode to `SetTimeout`.\n         */\n        await this.lensCore.initialize({\n            canvas: liveRenderTarget,\n            shouldUseWorker: !renderWhileTabHidden && this.container.get(configurationToken).shouldUseWorker,\n            exceptionHandler,\n        });\n\n        await this.lensCore.setRenderLoopMode({\n            mode: renderWhileTabHidden\n                ? this.lensCore.RenderLoopMode.SetTimeout\n                : this.lensCore.RenderLoopMode.RequestAnimationFrame,\n        });\n\n        // Each session gets its own DI Container – some Services provided by this Container may be shared with the\n        // root CameraKit Container, but others may be scoped to the session by passing their token to `copy()`.\n        const sessionContainer = this.container\n            // Right now this is a no-op. If/when we add support for multiple concurrent sessions, we may end up\n            // scoping LensCore to the session.\n            .copy()\n\n            .provides(sessionStateFactory)\n            .provides(lensStateFactory)\n            .provides(lensKeyboardFactory)\n            .provides(cameraKitSessionFactory)\n\n            .run(registerLensAssetsProvider)\n            .run(registerLensClientInterfaceHandler)\n            .run(setPreloadedConfiguration)\n\n            // We'll run a PartialContainer containing reporters for session-scoped metrics. Running this container\n            // allows each metric reporter to initialize itself (e.g. by adding event listeners to detect when certain\n            // actions occur).\n            .run(reportSessionScopedMetrics)\n\n            // UriHandlers may have dependencies on session-scoped services (e.g. LensState, LensKeyboard), so they'll\n            // be registered with LensCore here.\n            .run(registerUriHandlers);\n\n        const session = sessionContainer.get(cameraKitSessionFactory.token);\n        this.sessions.push(session);\n        return session;\n    }\n\n    /**\n     * Destroys all sessions and frees all resources.\n     */\n    @log\n    async destroy() {\n        resetLogger();\n        this.pageVisibility.destroy();\n        await Promise.all(this.sessions.map((session) => session.destroy()));\n        this.sessions = [];\n    }\n}\n\n/** @internal */\nexport const cameraKitFactory = Injectable(\n    \"CameraKit\",\n    [\n        lensRepositoryFactory.token,\n        metricsEventTargetFactory.token,\n        lensCoreFactory.token,\n        pageVisibilityFactory.token,\n        CONTAINER,\n    ] as const,\n    (\n        lensRepository: LensRepository,\n        metrics: MetricsEventTarget,\n        lensCore: LensCore,\n        pageVisibility: PageVisibility,\n        container: Container<RootServices>\n    ) => new CameraKit(lensRepository, lensCore, pageVisibility, container, metrics)\n);\n"]}

package/lib/bootstrapCameraKit.d.ts

@@ -60,8 +60,8 @@ export declare function bootstrapCameraKit(configuration: CameraKitBootstrapConf
  * replacing the default implementation that loads remote lens assets with a custom implementation that returns
  * different assets based on some business logic within the application.
  *
- * An extension is implemented as a [PartialContainer] – a collection of factory functions, each with its own
- * dependencies, which each provide some "Service." A Service can be of any type, and the CameraKit SDK defines its
+ * An extension is implemented as a {@link PartialContainer} – a collection of factory functions, each with its own
+ * dependencies, which each provide some "Service". A Service can be of any type, and the CameraKit SDK defines its
  * own Services, some of which can be overridden by providing a custom implementation of the type via an extension.
  *
  * Here's an example of how extensions might be used:
@@ -81,8 +81,8 @@ export declare function bootstrapCameraKit(configuration: CameraKitBootstrapConf
  *   },
  * )
  *
- * const myExtension = createExtension().provides(myCustomeRemoteAssetLoader)
- * const cameraKit = bootstrapCameraKit(config, container => container.provides(myExtension))
+ * const myExtension = createExtension().provides(myCustomRemoteAssetLoader);
+ * const cameraKit = bootstrapCameraKit(config, container => container.provides(myExtension));
  * ```
  *
  * This also enables greater modularity – the person/team creating the extension can do so in their own package, which

package/lib/bootstrapCameraKit.js

@@ -1,6 +1,6 @@
 import { __awaiter } from "tslib";
-import environment from "./environment.json";
-import lensCoreWasm from "./lensCoreWasmVersions.json";
+import environment from "./environment";
+import lensCoreWasm from "./lensCoreWasmVersions";
 import { lensRepositoryFactory } from "./lens/LensRepository";
 import { Container } from "./dependency-injection/Container";
 import { cameraKitFactory } from "./CameraKit";
@@ -13,8 +13,6 @@ import { defaultFetchHandlerFactory } from "./handlers/defaultFetchHandler";
 import { cameraKitServiceFetchHandlerFactory } from "./handlers/cameraKitServiceFetchHandlerFactory";
 import { createCameraKitConfigurationFactory } from "./configuration";
 import { PartialContainer } from "./dependency-injection/PartialContainer";
-import { metricsHandlerFactory } from "./metrics/metricsHandler";
-import { operationalMetricReporterFactory } from "./metrics/operational/operationalMetricsReporter";
 import { uriHandlersFactory } from "./extensions/UriHandlers";
 import { assert } from "./common/assertions";
 import { isSafeString } from "./common/typeguards";
@@ -37,9 +35,11 @@ import { pageVisibilityFactory } from "./common/pageVisibility";
 import { cofHandlerFactory } from "./remote-configuration/cofHandler";
 import { remoteApiServicesFactory } from "./extensions/RemoteApiServices";
 import { lensesClientFactory } from "./clients/lensesClient";
-import { gprcHandlerFactory } from "./clients/grpcHandler";
+import { grpcHandlerFactory } from "./clients/grpcHandler";
 import { lensSourcesFactory } from "./lens/LensSource";
 import { cameraKitLensSourceFactory } from "./lens/cameraKitLensSource";
+import { externalMetricsSubjectFactory, metricsClientFactory } from "./clients/metricsClient";
+import { Timer } from "./metrics/operational/Timer";
 const logger = getLogger("bootstrapCameraKit");
 // The following errors are not wrapped with BootstrapError and bubble up as is.
 const nonWrappableErrors = [
@@ -101,17 +101,17 @@ export function bootstrapCameraKit(configuration, provide) {
     return __awaiter(this, void 0, void 0, function* () {
         console.info(`Camera Kit SDK: ${environment.PACKAGE_VERSION} (${lensCoreWasm.version}/${lensCoreWasm.buildNumber})`);
         try {
-            const startTimeMs = performance.now();
+            const bootstrapLatency = new Timer("bootstrap_time");
             assert(isSafeString(configuration.apiToken), configurationError("Invalid or unsafe apiToken provided."));
             const configurationFactory = createCameraKitConfigurationFactory(configuration);
             // Public container holds services which applications can overwrite with their own implementations.
             const defaultPublicContainer = Container.provides(configurationFactory)
-                .provides(pageVisibilityFactory)
                 .provides(defaultFetchHandlerFactory)
                 .provides(remoteMediaAssetLoaderFactory)
                 .provides(lensSourcesFactory)
                 .provides(remoteApiServicesFactory)
-                .provides(uriHandlersFactory);
+                .provides(uriHandlersFactory)
+                .provides(externalMetricsSubjectFactory);
             const publicContainer = provide ? provide(defaultPublicContainer) : defaultPublicContainer;
             // Now that the client's provide() function has completed and the configuration override is ready,
             // we create another container to initialize the logger. This ensures that logging is available
@@ -120,15 +120,14 @@ export function bootstrapCameraKit(configuration, provide) {
             // and we're not interested in errors thrown by their provide() function.
             // Below is the minimum required container to report errors to Blizzard.
             const telemetryContainer = Container.provides(publicContainer)
+                .provides(pageVisibilityFactory)
                 .provides(cameraKitServiceFetchHandlerFactory)
-                .provides(gprcHandlerFactory)
+                .provides(grpcHandlerFactory)
+                .provides(metricsClientFactory)
                 .provides(logEntriesFactory)
                 .run(registerLogEntriesSubscriber)
-                .provides(lensesClientFactory)
                 .provides(requestStateEventTargetFactory)
                 .provides(metricsEventTargetFactory)
-                .provides(metricsHandlerFactory)
-                .provides(operationalMetricReporterFactory)
                 .provides(reportGlobalException)
                 .provides(cofHandlerFactory)
                 .provides(remoteConfigurationFactory)
@@ -153,6 +152,7 @@ export function bootstrapCameraKit(configuration, provide) {
             const lensCore = yield telemetryContainer.provides(lensCoreFactory).get(lensCoreFactory.token);
             const container = telemetryContainer
                 .provides(Injectable(lensCoreFactory.token, () => lensCore))
+                .provides(lensesClientFactory)
                 .provides(cameraKitLensSourceFactory)
                 .provides(lensPersistenceStoreFactory)
                 .provides(deviceDependentAssetLoaderFactory)
@@ -161,9 +161,8 @@ export function bootstrapCameraKit(configuration, provide) {
                 .provides(lensRepositoryFactory)
                 .provides(cameraKitFactory);
             const cameraKit = container.get(cameraKitFactory.token);
-            const bootstrapTimeMs = performance.now() - startTimeMs;
-            const reporter = container.get(operationalMetricReporterFactory.token);
-            reporter.timer("bootstrap_time", bootstrapTimeMs);
+            bootstrapLatency.measure();
+            container.get(metricsClientFactory.token).setOperationalMetrics(bootstrapLatency);
             return cameraKit;
         }
         catch (error) {
@@ -182,8 +181,8 @@ export function bootstrapCameraKit(configuration, provide) {
  * replacing the default implementation that loads remote lens assets with a custom implementation that returns
  * different assets based on some business logic within the application.
  *
- * An extension is implemented as a [PartialContainer] – a collection of factory functions, each with its own
- * dependencies, which each provide some "Service." A Service can be of any type, and the CameraKit SDK defines its
+ * An extension is implemented as a {@link PartialContainer} – a collection of factory functions, each with its own
+ * dependencies, which each provide some "Service". A Service can be of any type, and the CameraKit SDK defines its
  * own Services, some of which can be overridden by providing a custom implementation of the type via an extension.
  *
  * Here's an example of how extensions might be used:
@@ -203,8 +202,8 @@ export function bootstrapCameraKit(configuration, provide) {
  *   },
  * )
  *
- * const myExtension = createExtension().provides(myCustomeRemoteAssetLoader)
- * const cameraKit = bootstrapCameraKit(config, container => container.provides(myExtension))
+ * const myExtension = createExtension().provides(myCustomRemoteAssetLoader);
+ * const cameraKit = bootstrapCameraKit(config, container => container.provides(myExtension));
  * ```
  *
  * This also enables greater modularity – the person/team creating the extension can do so in their own package, which