npm - @snap/camera-kit - Versions diffs - 1.14.0 → 1.15.1 - Mend

@snap/camera-kit 1.14.0 → 1.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (270) hide show

package/README.md CHANGED Viewed

@@ -182,7 +182,7 @@ session.pause("capture");
 ## Error Handling
-Camera Kit Web SDK methods may throw errors, or return rejected Promises -- these are documented in the [API docs](https://kit.snapchat.com/reference/CameraKit/web/1.14.0/index.html). It is good practice to handle such cases, to provide a good experience to your users.
+Camera Kit Web SDK methods may throw errors, or return rejected Promises -- these are documented in the [API docs](https://kit.snapchat.com/reference/CameraKit/web/1.15.1/index.html). It is good practice to handle such cases, to provide a good experience to your users.
 Errors may also occur during Lens rendering. For example, Lenses contain their own scripting, which could throw an error. A rendering error could also occur if a Lens attempts to use a feature that is not supported by Camera Kit Web SDK.

package/dist/CameraKit.d.ts CHANGED Viewed

@@ -322,9 +322,9 @@ export declare const cameraKitFactory: {
         token: "lensPersistenceStore";
         dependencies: readonly ["lensCore"];
     }, {
-        (args_0: import("rxjs").Subject<import(".").Metric>, args_1: import("./clients/grpcHandler").GrpcHandler, args_2: PageVisibility): import("./clients/metricsClient").MetricsClient;
+        (args_0: import("rxjs").Subject<import(".").Metric>, args_1: import("rxjs").Observable<import(".").Metric>[], args_2: import("./clients/grpcHandler").GrpcHandler, args_3: PageVisibility): import("./clients/metricsClient").MetricsClient;
         token: "metricsClient";
-        dependencies: readonly ["externalMetricsSubject", "grpcHandlerFactory", "pageVisibility"];
+        dependencies: readonly ["externalMetricsSubject", "externalMetrics", "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";

package/dist/CameraKit.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"CameraKit.d.ts","sourceRoot":"","sources":["../src/CameraKit.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAUvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;~~AAG9D~~,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;~~AAatF~~;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACvB,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAC5C,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IAErC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS;IAad;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IApBjC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,cAAc,CAAA;KAAE,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAA0B;IAE/E,OAAO,CAAC,QAAQ,CAA0B;IAE1C,gBAAgB;;IAEZ;;OAEG;IACM,cAAc,EAAE,cAAc,EAEtB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,EAClC,YAAY,EAAE,mBAAmB,EAClD,UAAU,EAAE,kBAAkB;IAUlC;;;;;;;;;;;;;;;;OAgBG;IAEG,aAAa,CAAC,EAChB,gBAAgB,EAChB,oBAAoB,GACvB,GAAE,oBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC;~~IAgHxD~~;;OAEG;IAEG,OAAO;CAMhB;AAED,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB5B,CAAC"}
1	+ {"version":3,"file":"CameraKit.d.ts","sourceRoot":"","sources":["../src/CameraKit.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAKnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAUvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAI9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4CAA4C,CAAC;AActF;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACvB,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,GAC5C,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IAErC;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS;IAad;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,cAAc;IAEvC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,YAAY;IApBjC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,cAAc,CAAA;KAAE,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAA0B;IAE/E,OAAO,CAAC,QAAQ,CAA0B;IAE1C,gBAAgB;;IAEZ;;OAEG;IACM,cAAc,EAAE,cAAc,EAEtB,QAAQ,EAAE,QAAQ,EAClB,cAAc,EAAE,cAAc,EAC9B,SAAS,EAAE,SAAS,CAAC,YAAY,CAAC,EAClC,YAAY,EAAE,mBAAmB,EAClD,UAAU,EAAE,kBAAkB;IAUlC;;;;;;;;;;;;;;;;OAgBG;IAEG,aAAa,CAAC,EAChB,gBAAgB,EAChB,oBAAoB,GACvB,GAAE,oBAAyB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkHxD;;OAEG;IAEG,OAAO;CAMhB;AAED,gBAAgB;AAChB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkB5B,CAAC"}

package/dist/CameraKit.js CHANGED Viewed

@@ -19,10 +19,12 @@ import { errorLoggingDecorator } from "./logger/errorLoggingDecorator";
 import { TypedEventTarget } from "./events/TypedEventTarget";
 import { pageVisibilityFactory } from "./common/pageVisibility";
 import { setPreloadedConfiguration } from "./remote-configuration/preloadConfiguration";
+import { registerConfigurationProvider } from "./remote-configuration/configurationProvider";
 import { getTrustedTypesHandler } from "./trusted-types/trustedTypesHandler";
 import { remoteConfigurationFactory } from "./remote-configuration/remoteConfiguration";
 import { registerGeoDataProvider } from "./geo/registerGeoDataProvider";
 import { frameEventsFactory } from "./session/frameEvents";
+import { registerLensAnalyticEventsHandler } from "./lens/analytics/registerLensAnalyticEventsHandler";
 const logger = getLogger("CameraKit");
 const publicMetricsEventNames = ["lensView", "lensWait"];
 export let CameraKit = (() => {
@@ -98,7 +100,9 @@ export let CameraKit = (() => {
                         .run(registerLensAssetsProvider)
                         .run(registerLensClientInterfaceHandler)
                         .run(registerGeoDataProvider)
+                        .run(registerConfigurationProvider)
                         .run(setPreloadedConfiguration)
+                        .run(registerLensAnalyticEventsHandler)
                         .run(reportSessionScopedMetrics)
                         .run(registerUriHandlers);
                     const session = sessionContainer.get(cameraKitSessionFactory.token);

package/dist/CameraKit.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"CameraKit.js","sourceRoot":"","sources":["../src/CameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Container } from \"@snap/ts-inject\";\nimport { CONTAINER, Injectable } from \"@snap/ts-inject\";\nimport { firstValueFrom } from \"rxjs\";\nimport type { LensRepository } from \"./lens/LensRepository\";\nimport { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport type { LensCoreError } from \"./lens-core-module/lensCoreError\";\nimport type { LensCore } from \"./lens-core-module/lensCore\";\nimport type { CameraKitSession } from \"./session/CameraKitSession\";\nimport { cameraKitSessionFactory } from \"./session/CameraKitSession\";\nimport { registerLensAssetsProvider } from \"./lens/assets/LensAssetsProvider\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { configurationToken } from \"./configuration\";\nimport type { RootServices } from \"./RootServices\";\nimport { registerUriHandlers } from \"./uri-handlers/uriHandlersRegister\";\nimport type { MetricsEventTarget } from \"./metrics/metricsEventTarget\";\nimport { 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 type { TypedCustomEvent } from \"./events/TypedCustomEvent\";\nimport type { LensView } from \"./metrics/reporters/reportLensView\";\nimport type { LensWait } from \"./metrics/reporters/reportLensWait\";\nimport type { PageVisibility } from \"./common/pageVisibility\";\nimport { pageVisibilityFactory } from \"./common/pageVisibility\";\nimport { setPreloadedConfiguration } from \"./remote-configuration/preloadConfiguration\";\nimport type { RemoteConfiguration } from \"./remote-configuration/remoteConfiguration\";\nimport { getTrustedTypesHandler } from \"./trusted-types/trustedTypesHandler\";\nimport { remoteConfigurationFactory } from \"./remote-configuration/remoteConfiguration\";\nimport { registerGeoDataProvider } from \"./geo/registerGeoDataProvider\";\nimport { frameEventsFactory } from \"./session/frameEvents\";\n\nconst logger = getLogger(\"CameraKit\");\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 private readonly remoteConfig: RemoteConfiguration,\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 @errorLoggingDecorator(logger)\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 const config = this.container.get(configurationToken);\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 const trustedTypesHandler = getTrustedTypesHandler(config.trustedTypesPolicyName);\n await this.lensCore.initialize({\n canvas: liveRenderTarget,\n shouldUseWorker: !renderWhileTabHidden && config.shouldUseWorker,\n exceptionHandler,\n trustedTypes: {\n policyName: trustedTypesHandler.policyName,\n getTrustedUrls: trustedTypesHandler.getTrustedUrls,\n trustUrl: trustedTypesHandler.trustUrl,\n },\n });\n\n if (this.lensCore.setGpuIndex) {\n // NOTE: setGpuIndex was added in LensCore@292. This check ensures compatibility with older versions.\n\n // Camera Kit allows a performance cluster to be provided during bootstrap.\n // This cluster is passed to the LENS_FEATURE_GPU_INDEX config as LENS_CLUSTER_ORIG_4,\n // which maps the cluster to a GPU index.\n try {\n await this.lensCore.setGpuIndex({\n gpuIndex: await firstValueFrom(this.remoteConfig.getGpuIndexConfig()),\n });\n } catch (cause) {\n // LensCore initialization can proceed without the GPU index,\n // as it is mainly needed for ML lenses.\n logger.error(new Error(\"Cannot set GPU index.\", { cause }));\n }\n }\n\n if (config.fonts.length > 0) {\n // LensCore detaches font data and mutates font properties during processing.\n // To prevent issues when reusing font objects across multiple applications,\n // we create deep copies of font objects before passing them to LensCore.\n this.lensCore.setSystemFonts({\n fonts: config.fonts.map((font) => ({\n ...font,\n data: font.data.slice(0),\n })),\n });\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(frameEventsFactory)\n .provides(cameraKitSessionFactory)\n\n .run(registerLensAssetsProvider)\n .run(registerLensClientInterfaceHandler)\n .run(registerGeoDataProvider)\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 @errorLoggingDecorator(logger)\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 remoteConfigurationFactory.token,\n CONTAINER,\n ] as const,\n (\n lensRepository: LensRepository,\n metrics: MetricsEventTarget,\n lensCore: LensCore,\n pageVisibility: PageVisibility,\n remoteConfiguration: RemoteConfiguration,\n container: Container<RootServices>\n ) => new CameraKit(lensRepository, lensCore, pageVisibility, container, remoteConfiguration, metrics)\n);\n"]}
1	+ {"version":3,"file":"CameraKit.js","sourceRoot":"","sources":["../src/CameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Container } from \"@snap/ts-inject\";\nimport { CONTAINER, Injectable } from \"@snap/ts-inject\";\nimport { firstValueFrom } from \"rxjs\";\nimport type { LensRepository } from \"./lens/LensRepository\";\nimport { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport type { LensCoreError } from \"./lens-core-module/lensCoreError\";\nimport type { LensCore } from \"./lens-core-module/lensCore\";\nimport type { CameraKitSession } from \"./session/CameraKitSession\";\nimport { cameraKitSessionFactory } from \"./session/CameraKitSession\";\nimport { registerLensAssetsProvider } from \"./lens/assets/LensAssetsProvider\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { configurationToken } from \"./configuration\";\nimport type { RootServices } from \"./RootServices\";\nimport { registerUriHandlers } from \"./uri-handlers/uriHandlersRegister\";\nimport type { MetricsEventTarget } from \"./metrics/metricsEventTarget\";\nimport { 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 type { TypedCustomEvent } from \"./events/TypedCustomEvent\";\nimport type { LensView } from \"./metrics/reporters/reportLensView\";\nimport type { LensWait } from \"./metrics/reporters/reportLensWait\";\nimport type { PageVisibility } from \"./common/pageVisibility\";\nimport { pageVisibilityFactory } from \"./common/pageVisibility\";\nimport { setPreloadedConfiguration } from \"./remote-configuration/preloadConfiguration\";\nimport { registerConfigurationProvider } from \"./remote-configuration/configurationProvider\";\nimport type { RemoteConfiguration } from \"./remote-configuration/remoteConfiguration\";\nimport { getTrustedTypesHandler } from \"./trusted-types/trustedTypesHandler\";\nimport { remoteConfigurationFactory } from \"./remote-configuration/remoteConfiguration\";\nimport { registerGeoDataProvider } from \"./geo/registerGeoDataProvider\";\nimport { frameEventsFactory } from \"./session/frameEvents\";\nimport { registerLensAnalyticEventsHandler } from \"./lens/analytics/registerLensAnalyticEventsHandler\";\n\nconst logger = getLogger(\"CameraKit\");\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 private readonly remoteConfig: RemoteConfiguration,\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 @errorLoggingDecorator(logger)\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 const config = this.container.get(configurationToken);\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 const trustedTypesHandler = getTrustedTypesHandler(config.trustedTypesPolicyName);\n await this.lensCore.initialize({\n canvas: liveRenderTarget,\n shouldUseWorker: !renderWhileTabHidden && config.shouldUseWorker,\n exceptionHandler,\n trustedTypes: {\n policyName: trustedTypesHandler.policyName,\n getTrustedUrls: trustedTypesHandler.getTrustedUrls,\n trustUrl: trustedTypesHandler.trustUrl,\n },\n });\n\n if (this.lensCore.setGpuIndex) {\n // NOTE: setGpuIndex was added in LensCore@292. This check ensures compatibility with older versions.\n\n // Camera Kit allows a performance cluster to be provided during bootstrap.\n // This cluster is passed to the LENS_FEATURE_GPU_INDEX config as LENS_CLUSTER_ORIG_4,\n // which maps the cluster to a GPU index.\n try {\n await this.lensCore.setGpuIndex({\n gpuIndex: await firstValueFrom(this.remoteConfig.getGpuIndexConfig()),\n });\n } catch (cause) {\n // LensCore initialization can proceed without the GPU index,\n // as it is mainly needed for ML lenses.\n logger.error(new Error(\"Cannot set GPU index.\", { cause }));\n }\n }\n\n if (config.fonts.length > 0) {\n // LensCore detaches font data and mutates font properties during processing.\n // To prevent issues when reusing font objects across multiple applications,\n // we create deep copies of font objects before passing them to LensCore.\n this.lensCore.setSystemFonts({\n fonts: config.fonts.map((font) => ({\n ...font,\n data: font.data.slice(0),\n })),\n });\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(frameEventsFactory)\n .provides(cameraKitSessionFactory)\n\n .run(registerLensAssetsProvider)\n .run(registerLensClientInterfaceHandler)\n .run(registerGeoDataProvider)\n .run(registerConfigurationProvider)\n .run(setPreloadedConfiguration)\n .run(registerLensAnalyticEventsHandler)\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 @errorLoggingDecorator(logger)\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 remoteConfigurationFactory.token,\n CONTAINER,\n ] as const,\n (\n lensRepository: LensRepository,\n metrics: MetricsEventTarget,\n lensCore: LensCore,\n pageVisibility: PageVisibility,\n remoteConfiguration: RemoteConfiguration,\n container: Container<RootServices>\n ) => new CameraKit(lensRepository, lensCore, pageVisibility, container, remoteConfiguration, metrics)\n);\n"]}

package/dist/RootServices.d.ts CHANGED Viewed

@@ -7,7 +7,7 @@ import type { staticAssetLoaderFactory } from "./lens/assets/staticAssetLoader";
 import type { defaultFetchHandlerFactory } from "./handlers/defaultFetchHandler";
 import type { cameraKitServiceFetchHandlerFactory } from "./handlers/cameraKitServiceFetchHandlerFactory";
 import type { createCameraKitConfigurationFactory } from "./configuration";
-import type { externalMetricsSubjectFactory, metricsClientFactory } from "./clients/metricsClient";
+import type { externalMetricsFactory, externalMetricsSubjectFactory, metricsClientFactory } from "./clients/metricsClient";
 import type { LensCore } from "./lens-core-module/lensCore";
 import type { metricsEventTargetFactory } from "./metrics/metricsEventTarget";
 import type { lensSourcesFactory } from "./lens/LensSource";
@@ -29,6 +29,7 @@ import type { filePickerFactory } from "./lens-client-interface/filePicker";
 import type { userDataAccessResolverFactory } from "./lens/userDataAccessResolver";
 import type { remoteApiSpecsClientFactory } from "./clients/remoteApiSpecsClient";
 import type { geoDataProviderFactory } from "./geo/geoDataProvider";
+import type { lensAnalyticEventsHandlerFactory } from "./lens/analytics/lensAnalyticEventsHandler";
 /**
  * All services available to be customized by client app.
  */
@@ -42,7 +43,9 @@ export type PublicServices = ServicesFromInjectables<[
     typeof remoteApiServicesFactory,
     typeof uriHandlersFactory,
     typeof geoDataProviderFactory,
-    typeof externalMetricsSubjectFactory
+    typeof externalMetricsSubjectFactory,
+    typeof externalMetricsFactory,
+    typeof lensAnalyticEventsHandlerFactory
 ]>;
 /**
  * Define all the Services contained in CameraKit's root dependency injection container.

package/dist/RootServices.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"RootServices.d.ts","sourceRoot":"","sources":["../src/RootServices.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AACjG,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAClG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,gDAAgD,CAAC;AAC1G,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,~~EAAE~~,6BAA6B,~~EAAE~~,oBAAoB,~~EAAE~~,MAAM,yBAAyB,CAAC;~~AACnG~~,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AACvF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AAC7F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;~~AAEpE~~;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,uBAAuB,CAChD;IACI,UAAU,CAAC,OAAO,mCAAmC,CAAC;IACtD,OAAO,6BAA6B;IACpC,OAAO,iBAAiB;IACxB,OAAO,0BAA0B;IACjC,OAAO,6BAA6B;IACpC,OAAO,kBAAkB;IACzB,OAAO,wBAAwB;IAC/B,OAAO,kBAAkB;IACzB,OAAO,sBAAsB;IAC7B,OAAO,6BAA6B;~~CACvC~~,CACJ,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG;IAGvB,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CACrC,GAAG,cAAc,GACd,uBAAuB,CACnB;IACI,OAAO,qBAAqB;IAC5B,OAAO,yBAAyB;IAChC,OAAO,8BAA8B;IACrC,OAAO,mCAAmC;IAC1C,OAAO,kBAAkB;IACzB,OAAO,mBAAmB;IAC1B,OAAO,2BAA2B;IAClC,OAAO,iBAAiB;IACxB,OAAO,0BAA0B;IACjC,OAAO,qBAAqB;IAC5B,OAAO,2BAA2B;IAClC,OAAO,oBAAoB;IAC3B,OAAO,0BAA0B;IACjC,OAAO,iCAAiC;IACxC,OAAO,wBAAwB;IAC/B,OAAO,iBAAiB;IACxB,OAAO,kBAAkB;IACzB,OAAO,iBAAiB;IACxB,OAAO,qBAAqB;CAC/B,CACJ,CAAC"}
1	+ {"version":3,"file":"RootServices.d.ts","sourceRoot":"","sources":["../src/RootServices.ts"],"names":[],"mappings":"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"}

package/dist/RootServices.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"RootServices.js","sourceRoot":"","sources":["../src/RootServices.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicesFromInjectables } from \"@snap/ts-inject\";\nimport type { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport type { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport type { remoteMediaAssetLoaderFactory } from \"./lens/assets/remoteMediaAssetLoaderFactory\";\nimport type { deviceDependentAssetLoaderFactory } from \"./lens/assets/deviceDependentAssetLoader\";\nimport type { staticAssetLoaderFactory } from \"./lens/assets/staticAssetLoader\";\nimport type { defaultFetchHandlerFactory } from \"./handlers/defaultFetchHandler\";\nimport type { cameraKitServiceFetchHandlerFactory } from \"./handlers/cameraKitServiceFetchHandlerFactory\";\nimport type { createCameraKitConfigurationFactory } from \"./configuration\";\nimport type { externalMetricsSubjectFactory, metricsClientFactory } from \"./clients/metricsClient\";\nimport type { LensCore } from \"./lens-core-module/lensCore\";\nimport type { metricsEventTargetFactory } from \"./metrics/metricsEventTarget\";\nimport type { lensSourcesFactory } from \"./lens/LensSource\";\nimport type { uriHandlersFactory } from \"./uri-handlers/UriHandlers\";\nimport type { lensPersistenceStoreFactory } from \"./lens/LensPersistenceStore\";\nimport type { cofHandlerFactory } from \"./remote-configuration/cofHandler\";\nimport type { remoteConfigurationFactory } from \"./remote-configuration/remoteConfiguration\";\nimport type { lensAssetRepositoryFactory } from \"./lens/assets/LensAssetRepository\";\nimport type { legalStateFactory } from \"./legal/legalState\";\nimport type { legalPromptFactory } from \"./legal/legalPrompt\";\nimport type { logEntriesFactory } from \"./logger/logEntries\";\nimport type { reportGlobalException } from \"./metrics/reporters/reportGlobalException\";\nimport type { requestStateEventTargetFactory } from \"./handlers/requestStateEmittingHandler\";\nimport type { lensesClientFactory } from \"./clients/lensesClient\";\nimport type { pageVisibilityFactory } from \"./common/pageVisibility\";\nimport type { remoteApiServicesFactory } from \"./uri-handlers/internal-handlers/remoteApiUriHandler\";\nimport type { grpcHandlerFactory } from \"./clients/grpcHandler\";\nimport type { filePickerFactory } from \"./lens-client-interface/filePicker\";\nimport type { userDataAccessResolverFactory } from \"./lens/userDataAccessResolver\";\nimport type { remoteApiSpecsClientFactory } from \"./clients/remoteApiSpecsClient\";\nimport type { geoDataProviderFactory } from \"./geo/geoDataProvider\";\n\n/*\n All services available to be customized by client app.\n /\nexport type PublicServices = ServicesFromInjectables<\n [\n ReturnType<typeof createCameraKitConfigurationFactory>,\n typeof userDataAccessResolverFactory,\n typeof filePickerFactory,\n typeof defaultFetchHandlerFactory,\n typeof remoteMediaAssetLoaderFactory,\n typeof lensSourcesFactory,\n typeof remoteApiServicesFactory,\n typeof uriHandlersFactory,\n typeof geoDataProviderFactory,\n typeof externalMetricsSubjectFactory\n ]\n>;\n\n/\n Define all the Services contained in CameraKit's root dependency injection container.\n \n Note: we do end up defining this list of Services twice (once here to create the type, once when we actually\n * create the Container inside the `bootstrapCameraKit` function). We could avoid doing this and just infer the\n * RootContainer type from the constructed container – but since we can only do that inside `bootstrapCameraKit`, it\n * makes it more awkward to provide a type for the `provide` user-supplied function (or use the type elsewhere, like in\n * CameraKitSession).\n \n There may be a way to eliminate this extra boilerplate, but for now it's required in order to present a cleaner\n * `bootstrapCameraKit` API to applications.\n */\nexport type RootServices = {\n // bootstrapCameraKit replaces the lensCoreFactory token's value with the resolved LensCore (rather than the\n // Promise of the LensCore), so we need to do the same re-mapping here.\n [lensCoreFactory.token]: LensCore;\n} & PublicServices &\n ServicesFromInjectables<\n [\n typeof pageVisibilityFactory,\n typeof metricsEventTargetFactory,\n typeof requestStateEventTargetFactory,\n typeof cameraKitServiceFetchHandlerFactory,\n typeof grpcHandlerFactory,\n typeof lensesClientFactory,\n typeof remoteApiSpecsClientFactory,\n typeof cofHandlerFactory,\n typeof remoteConfigurationFactory,\n typeof lensRepositoryFactory,\n typeof lensPersistenceStoreFactory,\n typeof metricsClientFactory,\n typeof lensAssetRepositoryFactory,\n typeof deviceDependentAssetLoaderFactory,\n typeof staticAssetLoaderFactory,\n typeof legalStateFactory,\n typeof legalPromptFactory,\n typeof logEntriesFactory,\n typeof reportGlobalException\n ]\n >;\n"]}
1	+ {"version":3,"file":"RootServices.js","sourceRoot":"","sources":["../src/RootServices.ts"],"names":[],"mappings":"","sourcesContent":["import type { ServicesFromInjectables } from \"@snap/ts-inject\";\nimport type { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport type { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport type { remoteMediaAssetLoaderFactory } from \"./lens/assets/remoteMediaAssetLoaderFactory\";\nimport type { deviceDependentAssetLoaderFactory } from \"./lens/assets/deviceDependentAssetLoader\";\nimport type { staticAssetLoaderFactory } from \"./lens/assets/staticAssetLoader\";\nimport type { defaultFetchHandlerFactory } from \"./handlers/defaultFetchHandler\";\nimport type { cameraKitServiceFetchHandlerFactory } from \"./handlers/cameraKitServiceFetchHandlerFactory\";\nimport type { createCameraKitConfigurationFactory } from \"./configuration\";\nimport type {\n externalMetricsFactory,\n externalMetricsSubjectFactory,\n metricsClientFactory,\n} from \"./clients/metricsClient\";\nimport type { LensCore } from \"./lens-core-module/lensCore\";\nimport type { metricsEventTargetFactory } from \"./metrics/metricsEventTarget\";\nimport type { lensSourcesFactory } from \"./lens/LensSource\";\nimport type { uriHandlersFactory } from \"./uri-handlers/UriHandlers\";\nimport type { lensPersistenceStoreFactory } from \"./lens/LensPersistenceStore\";\nimport type { cofHandlerFactory } from \"./remote-configuration/cofHandler\";\nimport type { remoteConfigurationFactory } from \"./remote-configuration/remoteConfiguration\";\nimport type { lensAssetRepositoryFactory } from \"./lens/assets/LensAssetRepository\";\nimport type { legalStateFactory } from \"./legal/legalState\";\nimport type { legalPromptFactory } from \"./legal/legalPrompt\";\nimport type { logEntriesFactory } from \"./logger/logEntries\";\nimport type { reportGlobalException } from \"./metrics/reporters/reportGlobalException\";\nimport type { requestStateEventTargetFactory } from \"./handlers/requestStateEmittingHandler\";\nimport type { lensesClientFactory } from \"./clients/lensesClient\";\nimport type { pageVisibilityFactory } from \"./common/pageVisibility\";\nimport type { remoteApiServicesFactory } from \"./uri-handlers/internal-handlers/remoteApiUriHandler\";\nimport type { grpcHandlerFactory } from \"./clients/grpcHandler\";\nimport type { filePickerFactory } from \"./lens-client-interface/filePicker\";\nimport type { userDataAccessResolverFactory } from \"./lens/userDataAccessResolver\";\nimport type { remoteApiSpecsClientFactory } from \"./clients/remoteApiSpecsClient\";\nimport type { geoDataProviderFactory } from \"./geo/geoDataProvider\";\nimport type { lensAnalyticEventsHandlerFactory } from \"./lens/analytics/lensAnalyticEventsHandler\";\n\n/*\n All services available to be customized by client app.\n /\nexport type PublicServices = ServicesFromInjectables<\n [\n ReturnType<typeof createCameraKitConfigurationFactory>,\n typeof userDataAccessResolverFactory,\n typeof filePickerFactory,\n typeof defaultFetchHandlerFactory,\n typeof remoteMediaAssetLoaderFactory,\n typeof lensSourcesFactory,\n typeof remoteApiServicesFactory,\n typeof uriHandlersFactory,\n typeof geoDataProviderFactory,\n typeof externalMetricsSubjectFactory,\n typeof externalMetricsFactory,\n typeof lensAnalyticEventsHandlerFactory\n ]\n>;\n\n/\n Define all the Services contained in CameraKit's root dependency injection container.\n \n Note: we do end up defining this list of Services twice (once here to create the type, once when we actually\n * create the Container inside the `bootstrapCameraKit` function). We could avoid doing this and just infer the\n * RootContainer type from the constructed container – but since we can only do that inside `bootstrapCameraKit`, it\n * makes it more awkward to provide a type for the `provide` user-supplied function (or use the type elsewhere, like in\n * CameraKitSession).\n \n There may be a way to eliminate this extra boilerplate, but for now it's required in order to present a cleaner\n * `bootstrapCameraKit` API to applications.\n */\nexport type RootServices = {\n // bootstrapCameraKit replaces the lensCoreFactory token's value with the resolved LensCore (rather than the\n // Promise of the LensCore), so we need to do the same re-mapping here.\n [lensCoreFactory.token]: LensCore;\n} & PublicServices &\n ServicesFromInjectables<\n [\n typeof pageVisibilityFactory,\n typeof metricsEventTargetFactory,\n typeof requestStateEventTargetFactory,\n typeof cameraKitServiceFetchHandlerFactory,\n typeof grpcHandlerFactory,\n typeof lensesClientFactory,\n typeof remoteApiSpecsClientFactory,\n typeof cofHandlerFactory,\n typeof remoteConfigurationFactory,\n typeof lensRepositoryFactory,\n typeof lensPersistenceStoreFactory,\n typeof metricsClientFactory,\n typeof lensAssetRepositoryFactory,\n typeof deviceDependentAssetLoaderFactory,\n typeof staticAssetLoaderFactory,\n typeof legalStateFactory,\n typeof legalPromptFactory,\n typeof logEntriesFactory,\n typeof reportGlobalException\n ]\n >;\n"]}

package/dist/bootstrapCameraKit.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"bootstrapCameraKit.d.ts","sourceRoot":"","sources":["../src/bootstrapCameraKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAc,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAM1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;~~AAwD7C~~;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,kBAAkB,CACpC,aAAa,EAAE,+BAA+B,EAC9C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,eAAe,GAClD,OAAO,CAAC,SAAS,CAAC,~~CA8FpB~~;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAElD"}
1	+ {"version":3,"file":"bootstrapCameraKit.d.ts","sourceRoot":"","sources":["../src/bootstrapCameraKit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAc,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAM1E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAyD7C;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAsB,kBAAkB,CACpC,aAAa,EAAE,+BAA+B,EAC9C,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,eAAe,KAAK,eAAe,GAClD,OAAO,CAAC,SAAS,CAAC,CAkGpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,CAElD"}

package/dist/bootstrapCameraKit.js CHANGED Viewed

@@ -36,13 +36,14 @@ import { lensesClientFactory } from "./clients/lensesClient";
 import { grpcHandlerFactory } from "./clients/grpcHandler";
 import { lensSourcesFactory } from "./lens/LensSource";
 import { cameraKitLensSourceFactory } from "./lens/cameraKitLensSource";
-import { externalMetricsSubjectFactory, metricsClientFactory } from "./clients/metricsClient";
+import { externalMetricsFactory, externalMetricsSubjectFactory, metricsClientFactory } from "./clients/metricsClient";
 import { Timer } from "./metrics/operational/Timer";
 import { fetchWatermarkLens } from "./lens/fetchWatermarkLens";
 import { filePickerFactory } from "./lens-client-interface/filePicker";
 import { userDataAccessResolverFactory } from "./lens/userDataAccessResolver";
 import { remoteApiSpecsClientFactory } from "./clients/remoteApiSpecsClient";
 import { geoDataProviderFactory } from "./geo/geoDataProvider";
+import { lensAnalyticEventsHandlerFactory } from "./lens/analytics/lensAnalyticEventsHandler";
 const logger = getLogger("bootstrapCameraKit");
 const nonWrappableErrors = [
     "ConfigurationError",
@@ -70,7 +71,9 @@ export function bootstrapCameraKit(configuration, provide) {
                 .provides(remoteApiServicesFactory)
                 .provides(uriHandlersFactory)
                 .provides(geoDataProviderFactory)
-                .provides(externalMetricsSubjectFactory);
+                .provides(externalMetricsFactory)
+                .provides(externalMetricsSubjectFactory)
+                .provides(lensAnalyticEventsHandlerFactory);
             const publicContainer = provide ? provide(defaultPublicContainer) : defaultPublicContainer;
             const telemetryContainer = Container.provides(publicContainer)
                 .provides(pageVisibilityFactory)

package/dist/bootstrapCameraKit.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"bootstrapCameraKit.js","sourceRoot":"","sources":["../src/bootstrapCameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container, Injectable, PartialContainer } from \"@snap/ts-inject\";\nimport { remoteMediaAssetLoaderFactory } from \"./lens/assets/remoteMediaAssetLoaderFactory\";\nimport { deviceDependentAssetLoaderFactory } from \"./lens/assets/deviceDependentAssetLoader\";\nimport { staticAssetLoaderFactory } from \"./lens/assets/staticAssetLoader\";\nimport { defaultFetchHandlerFactory } from \"./handlers/defaultFetchHandler\";\nimport { cameraKitServiceFetchHandlerFactory } from \"./handlers/cameraKitServiceFetchHandlerFactory\";\nimport type { CameraKitBootstrapConfiguration } from \"./configuration\";\nimport { createCameraKitConfigurationFactory } from \"./configuration\";\nimport type { PublicServices } from \"./RootServices\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { cameraKitFactory } from \"./CameraKit\";\nimport type { CameraKit } from \"./CameraKit\";\nimport { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport lensCoreWasm from \"./lensCoreWasmVersions\";\nimport environment from \"./environment\";\nimport { uriHandlersFactory } from \"./uri-handlers/UriHandlers\";\nimport { assert } from \"./common/assertions\";\nimport { isSafeString } from \"./common/typeguards\";\nimport { metricsEventTargetFactory } from \"./metrics/metricsEventTarget\";\nimport { reportGloballyScopedMetrics } from \"./metrics/reporters/reporters\";\nimport { getLogger } from \"./logger/logger\";\nimport { logEntriesFactory } from \"./logger/logEntries\";\nimport { assertPlatformSupported } from \"./platform/assertPlatformSupported\";\nimport { lensPersistenceStoreFactory } from \"./lens/LensPersistenceStore\";\nimport { remoteConfigurationFactory } from \"./remote-configuration/remoteConfiguration\";\nimport { lensAssetRepositoryFactory } from \"./lens/assets/LensAssetRepository\";\nimport { legalStateFactory } from \"./legal/legalState\";\nimport { legalPromptFactory } from \"./legal/legalPrompt\";\nimport type { ConfigurationError, PlatformNotSupportedError } from \"./namedErrors\";\nimport { bootstrapError, configurationError } from \"./namedErrors\";\nimport { businessEventsReporterFactory } from \"./metrics/businessEventsReporter\";\nimport { reportGlobalException } from \"./metrics/reporters/reportGlobalException\";\nimport { registerLogEntriesSubscriber } from \"./logger/registerLogEntriesSubscriber\";\nimport { requestStateEventTargetFactory } from \"./handlers/requestStateEmittingHandler\";\nimport { pageVisibilityFactory } from \"./common/pageVisibility\";\nimport { cofHandlerFactory } from \"./remote-configuration/cofHandler\";\nimport { remoteApiServicesFactory } from \"./uri-handlers/internal-handlers/remoteApiUriHandler\";\nimport { lensesClientFactory } from \"./clients/lensesClient\";\nimport { grpcHandlerFactory } from \"./clients/grpcHandler\";\nimport { lensSourcesFactory } from \"./lens/LensSource\";\nimport { cameraKitLensSourceFactory } from \"./lens/cameraKitLensSource\";\nimport { externalMetricsSubjectFactory, metricsClientFactory } from \"./clients/metricsClient\";\nimport { Timer } from \"./metrics/operational/Timer\";\nimport { fetchWatermarkLens } from \"./lens/fetchWatermarkLens\";\nimport { filePickerFactory } from \"./lens-client-interface/filePicker\";\nimport { userDataAccessResolverFactory } from \"./lens/userDataAccessResolver\";\nimport { remoteApiSpecsClientFactory } from \"./clients/remoteApiSpecsClient\";\nimport { geoDataProviderFactory } from \"./geo/geoDataProvider\";\n\nconst logger = getLogger(\"bootstrapCameraKit\");\n\n// The following errors are not wrapped with BootstrapError and bubble up as is.\nconst nonWrappableErrors: [ConfigurationError[\"name\"], PlatformNotSupportedError[\"name\"]] = [\n \"ConfigurationError\",\n \"PlatformNotSupportedError\",\n];\n\n/*\n Returns true if given error has to be wrapped with BootstrapError.\n /\nfunction shouldWrapError(error: unknown): boolean {\n if (error instanceof Error) {\n return !nonWrappableErrors.some((name) => error.name === name);\n }\n return true;\n}\n\n/\n For more advanced use-cases, this DI Container holds services for which a custom implementation may be provided by\n * the application.\n \n @category Bootstrapping and Configuration\n /\nexport type PublicContainer = Container<PublicServices>;\n\n/\n Bootstrap CameraKit. This will download the WebAssembly code which powers CameraKit's rendering engine, and return\n * an instance of {@link CameraKit}.\n \n CameraKit must be provided with some configuration (the application's API token), and there are some additional\n * configurations which are optional.\n \n Descriptions of the available configurations can be found in the documentation for\n * {@link CameraKitBootstrapConfiguration}\n \n ---\n \n There is also a second, more advanced way to modify CameraKit to provide greater flexibility to support less common\n * use cases.\n \n This requires some knowledge of CameraKit's dependency injection system, and allows applications to provide their\n * own custom implementations of certain CameraKit components. This functionality will only be needed by applications\n * with very specific, more advanced requirements.\n \n @example\n * ```ts\n * // The most common way to bootstrap:\n * const cameraKit = await bootstrapCameraKit({ apiToken: myApiToken })\n \n // For special advanced use-cases, it is possible to provide custom implementations for certain CameraKit components.\n * const cameraKit = await bootstrapCameraKit(config, (container) => {\n * return container.provides(myCustomRemoteMediaAssetLoaderFactory)\n * })\n * ```\n \n @param configuration Configure CameraKit with e.g. credentials, global resource endpoints, etc.\n * @param provide Optional function that can make modifications to CameraKit's root DI container.\n * @returns A {@link CameraKit} instance, which is the entry point to CameraKit's API.\n \n @throws\n * - {@link ConfigurationError} when provided configuration object is invalid\n * - {@link PlatformNotSupportedError} when current platform is not supported by CameraKit\n * - {@link BootstrapError} when a failure occurs while initializing CameraKit and downloading the render engine\n * WebAssembly binary.\n \n @category Bootstrapping and Configuration\n /\nexport async function bootstrapCameraKit(\n configuration: CameraKitBootstrapConfiguration,\n provide?: (c: PublicContainer) => PublicContainer\n): Promise<CameraKit> {\n console.info(\n `Camera Kit SDK: ${environment.PACKAGE_VERSION} (${lensCoreWasm.version}/${lensCoreWasm.buildNumber})`\n );\n\n try {\n const bootstrapLatency = new Timer(\"bootstrap_time\");\n\n assert(isSafeString(configuration.apiToken), configurationError(\"Invalid or unsafe apiToken provided.\"));\n\n const configurationFactory = createCameraKitConfigurationFactory(configuration);\n\n // Public container holds services which applications can overwrite with their own implementations.\n const defaultPublicContainer = Container.provides(configurationFactory)\n .provides(userDataAccessResolverFactory)\n .provides(filePickerFactory)\n .provides(defaultFetchHandlerFactory)\n .provides(remoteMediaAssetLoaderFactory)\n .provides(lensSourcesFactory)\n .provides(remoteApiServicesFactory)\n .provides(uriHandlersFactory)\n .provides(geoDataProviderFactory)\n .provides(externalMetricsSubjectFactory);\n\n const publicContainer = provide ? provide(defaultPublicContainer) : defaultPublicContainer;\n\n // Now that the client's provide() function has completed and the configuration override is ready,\n // we create another container to initialize the logger. This ensures that logging is available\n // as we continue bootstrapping. We don't initialize the logger as part of the defaultPublicContainer\n // because we don't want applications to provide their own logger implementations,\n // and we're not interested in errors thrown by their provide() function.\n // Below is the minimum required container to report errors to Blizzard.\n const telemetryContainer = Container.provides(publicContainer)\n .provides(pageVisibilityFactory)\n .provides(cameraKitServiceFetchHandlerFactory)\n .provides(requestStateEventTargetFactory)\n .provides(grpcHandlerFactory)\n .provides(metricsClientFactory)\n .provides(logEntriesFactory)\n .run(registerLogEntriesSubscriber)\n .provides(metricsEventTargetFactory)\n .provides(reportGlobalException)\n .provides(cofHandlerFactory)\n .provides(remoteConfigurationFactory)\n .provides(legalPromptFactory)\n .provides(legalStateFactory)\n // We'll run a PartialContainer containing reporters for globally-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). This PartialContainer also includes the service which listens to locally-reported metrics\n // and sends them to our backend.\n .run(reportGloballyScopedMetrics)\n .run(businessEventsReporterFactory);\n\n // Run the exception logger so that it can subscribe to log events -- we can't use `Container.run()` because\n // reportGlobalException is also used as a dependency by other Services (and run does not provide Services,\n // it just runs them once).\n telemetryContainer.get(reportGlobalException.token);\n\n // At this point, logger is configured to report to console and Blizzard.\n\n await assertPlatformSupported();\n\n // LensCore is a foundational component which must be created asynchronously.\n // But it's annoying for every consumer of LensCore to have to wait on Promise<LensCore>\n // (which means they become async themselves). So we'll create a DI container which provides Promise<LensCore>,\n // wait for that promise once here, then create a new DI container that just contains LensCore.\n const lensCore = await telemetryContainer.provides(lensCoreFactory).get(lensCoreFactory.token);\n\n const container = telemetryContainer\n .provides(Injectable(lensCoreFactory.token, () => lensCore))\n .provides(lensesClientFactory)\n .provides(remoteApiSpecsClientFactory)\n .provides(cameraKitLensSourceFactory)\n .provides(lensPersistenceStoreFactory)\n .provides(deviceDependentAssetLoaderFactory)\n .provides(staticAssetLoaderFactory)\n .provides(lensAssetRepositoryFactory)\n .provides(lensRepositoryFactory)\n .provides(cameraKitFactory)\n .run(fetchWatermarkLens);\n\n const cameraKit = container.get(cameraKitFactory.token);\n\n bootstrapLatency.measure();\n container.get(metricsClientFactory.token).setOperationalMetrics(bootstrapLatency);\n\n return cameraKit;\n } catch (error) {\n if (shouldWrapError(error)) {\n error = bootstrapError(\"Error occurred during Camera Kit bootstrapping.\", error);\n }\n logger.error(error);\n throw error;\n }\n}\n\n/\n Extensions offer a way to provide custom implementations of certain parts of the CameraKit SDK.\n \n This enables more advanced use-cases, in which the default behavior of the SDK is substantially altered. For example,\n * replacing the default implementation that loads remote lens assets with a custom implementation that returns\n * different assets based on some business logic within the application.\n \n An extension is implemented as a {@link PartialContainer} – a collection of factory functions, each with its own\n * dependencies, which each provide some \"Service\". A Service can be of any type, and the CameraKit SDK defines its\n * own Services, some of which can be overridden by providing a custom implementation of the type via an extension.\n \n Here's an example of how extensions might be used:\n * ```ts\n * import { bootstrapCameraKit, createExtension, remoteMediaAssetLoaderFactory } from '@snap/camera-kit'\n \n const myCustomRemoteAssetLoader = Injectable(\n * remoteMediaAssetLoaderFactory.token,\n * [remoteMediaAssetLoaderFactory.token] as const,\n * (defaultLoader: AssetLoader): AssetLoader => {\n * return async (asset, lens) => {\n * if (lens?.id === MY_SPECIAL_LENS) {\n * return (await fetch('my/asset.glb')).arrayBuffer()\n * }\n * return defaultLoader(asset, lens)\n * }\n * },\n * )\n \n const myExtension = createExtension().provides(myCustomRemoteAssetLoader);\n * const cameraKit = bootstrapCameraKit(config, container => container.provides(myExtension));\n * ```\n \n This also enables greater modularity – the person/team creating the extension can do so in their own package, which\n * could be shared by many applications that all require the same functionality.\n \n @returns A {@link PartialContainer} which can be used to create a collection of Services, and can later be provided\n * to CameraKit's DI container during {@link bootstrapCameraKit}.\n \n @category Bootstrapping and Configuration\n */\nexport function createExtension(): PartialContainer {\n return new PartialContainer({});\n}\n"]}
1	+ {"version":3,"file":"bootstrapCameraKit.js","sourceRoot":"","sources":["../src/bootstrapCameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import { Container, Injectable, PartialContainer } from \"@snap/ts-inject\";\nimport { remoteMediaAssetLoaderFactory } from \"./lens/assets/remoteMediaAssetLoaderFactory\";\nimport { deviceDependentAssetLoaderFactory } from \"./lens/assets/deviceDependentAssetLoader\";\nimport { staticAssetLoaderFactory } from \"./lens/assets/staticAssetLoader\";\nimport { defaultFetchHandlerFactory } from \"./handlers/defaultFetchHandler\";\nimport { cameraKitServiceFetchHandlerFactory } from \"./handlers/cameraKitServiceFetchHandlerFactory\";\nimport type { CameraKitBootstrapConfiguration } from \"./configuration\";\nimport { createCameraKitConfigurationFactory } from \"./configuration\";\nimport type { PublicServices } from \"./RootServices\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { cameraKitFactory } from \"./CameraKit\";\nimport type { CameraKit } from \"./CameraKit\";\nimport { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport lensCoreWasm from \"./lensCoreWasmVersions\";\nimport environment from \"./environment\";\nimport { uriHandlersFactory } from \"./uri-handlers/UriHandlers\";\nimport { assert } from \"./common/assertions\";\nimport { isSafeString } from \"./common/typeguards\";\nimport { metricsEventTargetFactory } from \"./metrics/metricsEventTarget\";\nimport { reportGloballyScopedMetrics } from \"./metrics/reporters/reporters\";\nimport { getLogger } from \"./logger/logger\";\nimport { logEntriesFactory } from \"./logger/logEntries\";\nimport { assertPlatformSupported } from \"./platform/assertPlatformSupported\";\nimport { lensPersistenceStoreFactory } from \"./lens/LensPersistenceStore\";\nimport { remoteConfigurationFactory } from \"./remote-configuration/remoteConfiguration\";\nimport { lensAssetRepositoryFactory } from \"./lens/assets/LensAssetRepository\";\nimport { legalStateFactory } from \"./legal/legalState\";\nimport { legalPromptFactory } from \"./legal/legalPrompt\";\nimport type { ConfigurationError, PlatformNotSupportedError } from \"./namedErrors\";\nimport { bootstrapError, configurationError } from \"./namedErrors\";\nimport { businessEventsReporterFactory } from \"./metrics/businessEventsReporter\";\nimport { reportGlobalException } from \"./metrics/reporters/reportGlobalException\";\nimport { registerLogEntriesSubscriber } from \"./logger/registerLogEntriesSubscriber\";\nimport { requestStateEventTargetFactory } from \"./handlers/requestStateEmittingHandler\";\nimport { pageVisibilityFactory } from \"./common/pageVisibility\";\nimport { cofHandlerFactory } from \"./remote-configuration/cofHandler\";\nimport { remoteApiServicesFactory } from \"./uri-handlers/internal-handlers/remoteApiUriHandler\";\nimport { lensesClientFactory } from \"./clients/lensesClient\";\nimport { grpcHandlerFactory } from \"./clients/grpcHandler\";\nimport { lensSourcesFactory } from \"./lens/LensSource\";\nimport { cameraKitLensSourceFactory } from \"./lens/cameraKitLensSource\";\nimport { externalMetricsFactory, externalMetricsSubjectFactory, metricsClientFactory } from \"./clients/metricsClient\";\nimport { Timer } from \"./metrics/operational/Timer\";\nimport { fetchWatermarkLens } from \"./lens/fetchWatermarkLens\";\nimport { filePickerFactory } from \"./lens-client-interface/filePicker\";\nimport { userDataAccessResolverFactory } from \"./lens/userDataAccessResolver\";\nimport { remoteApiSpecsClientFactory } from \"./clients/remoteApiSpecsClient\";\nimport { geoDataProviderFactory } from \"./geo/geoDataProvider\";\nimport { lensAnalyticEventsHandlerFactory } from \"./lens/analytics/lensAnalyticEventsHandler\";\n\nconst logger = getLogger(\"bootstrapCameraKit\");\n\n// The following errors are not wrapped with BootstrapError and bubble up as is.\nconst nonWrappableErrors: [ConfigurationError[\"name\"], PlatformNotSupportedError[\"name\"]] = [\n \"ConfigurationError\",\n \"PlatformNotSupportedError\",\n];\n\n/*\n Returns true if given error has to be wrapped with BootstrapError.\n /\nfunction shouldWrapError(error: unknown): boolean {\n if (error instanceof Error) {\n return !nonWrappableErrors.some((name) => error.name === name);\n }\n return true;\n}\n\n/\n For more advanced use-cases, this DI Container holds services for which a custom implementation may be provided by\n * the application.\n \n @category Bootstrapping and Configuration\n /\nexport type PublicContainer = Container<PublicServices>;\n\n/\n Bootstrap CameraKit. This will download the WebAssembly code which powers CameraKit's rendering engine, and return\n * an instance of {@link CameraKit}.\n \n CameraKit must be provided with some configuration (the application's API token), and there are some additional\n * configurations which are optional.\n \n Descriptions of the available configurations can be found in the documentation for\n * {@link CameraKitBootstrapConfiguration}\n \n ---\n \n There is also a second, more advanced way to modify CameraKit to provide greater flexibility to support less common\n * use cases.\n \n This requires some knowledge of CameraKit's dependency injection system, and allows applications to provide their\n * own custom implementations of certain CameraKit components. This functionality will only be needed by applications\n * with very specific, more advanced requirements.\n \n @example\n * ```ts\n * // The most common way to bootstrap:\n * const cameraKit = await bootstrapCameraKit({ apiToken: myApiToken })\n \n // For special advanced use-cases, it is possible to provide custom implementations for certain CameraKit components.\n * const cameraKit = await bootstrapCameraKit(config, (container) => {\n * return container.provides(myCustomRemoteMediaAssetLoaderFactory)\n * })\n * ```\n \n @param configuration Configure CameraKit with e.g. credentials, global resource endpoints, etc.\n * @param provide Optional function that can make modifications to CameraKit's root DI container.\n * @returns A {@link CameraKit} instance, which is the entry point to CameraKit's API.\n \n @throws\n * - {@link ConfigurationError} when provided configuration object is invalid\n * - {@link PlatformNotSupportedError} when current platform is not supported by CameraKit\n * - {@link BootstrapError} when a failure occurs while initializing CameraKit and downloading the render engine\n * WebAssembly binary.\n \n @category Bootstrapping and Configuration\n /\nexport async function bootstrapCameraKit(\n configuration: CameraKitBootstrapConfiguration,\n provide?: (c: PublicContainer) => PublicContainer\n): Promise<CameraKit> {\n console.info(\n `Camera Kit SDK: ${environment.PACKAGE_VERSION} (${lensCoreWasm.version}/${lensCoreWasm.buildNumber})`\n );\n\n try {\n const bootstrapLatency = new Timer(\"bootstrap_time\");\n\n assert(isSafeString(configuration.apiToken), configurationError(\"Invalid or unsafe apiToken provided.\"));\n\n const configurationFactory = createCameraKitConfigurationFactory(configuration);\n\n // Public container holds services which applications can overwrite with their own implementations.\n const defaultPublicContainer = Container.provides(configurationFactory)\n .provides(userDataAccessResolverFactory)\n .provides(filePickerFactory)\n .provides(defaultFetchHandlerFactory)\n .provides(remoteMediaAssetLoaderFactory)\n .provides(lensSourcesFactory)\n .provides(remoteApiServicesFactory)\n .provides(uriHandlersFactory)\n .provides(geoDataProviderFactory)\n .provides(externalMetricsFactory)\n .provides(externalMetricsSubjectFactory)\n // This handler is primarily used by internal consumers. It's safe on the public surface because it only\n // triggers for lenses using private APIs that external partners cannot access.\n .provides(lensAnalyticEventsHandlerFactory);\n\n const publicContainer = provide ? provide(defaultPublicContainer) : defaultPublicContainer;\n\n // Now that the client's provide() function has completed and the configuration override is ready,\n // we create another container to initialize the logger. This ensures that logging is available\n // as we continue bootstrapping. We don't initialize the logger as part of the defaultPublicContainer\n // because we don't want applications to provide their own logger implementations,\n // and we're not interested in errors thrown by their provide() function.\n // Below is the minimum required container to report errors to Blizzard.\n const telemetryContainer = Container.provides(publicContainer)\n .provides(pageVisibilityFactory)\n .provides(cameraKitServiceFetchHandlerFactory)\n .provides(requestStateEventTargetFactory)\n .provides(grpcHandlerFactory)\n .provides(metricsClientFactory)\n .provides(logEntriesFactory)\n .run(registerLogEntriesSubscriber)\n .provides(metricsEventTargetFactory)\n .provides(reportGlobalException)\n .provides(cofHandlerFactory)\n .provides(remoteConfigurationFactory)\n .provides(legalPromptFactory)\n .provides(legalStateFactory)\n // We'll run a PartialContainer containing reporters for globally-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). This PartialContainer also includes the service which listens to locally-reported metrics\n // and sends them to our backend.\n .run(reportGloballyScopedMetrics)\n .run(businessEventsReporterFactory);\n\n // Run the exception logger so that it can subscribe to log events -- we can't use `Container.run()` because\n // reportGlobalException is also used as a dependency by other Services (and run does not provide Services,\n // it just runs them once).\n telemetryContainer.get(reportGlobalException.token);\n\n // At this point, logger is configured to report to console and Blizzard.\n\n await assertPlatformSupported();\n\n // LensCore is a foundational component which must be created asynchronously.\n // But it's annoying for every consumer of LensCore to have to wait on Promise<LensCore>\n // (which means they become async themselves). So we'll create a DI container which provides Promise<LensCore>,\n // wait for that promise once here, then create a new DI container that just contains LensCore.\n const lensCore = await telemetryContainer.provides(lensCoreFactory).get(lensCoreFactory.token);\n\n const container = telemetryContainer\n .provides(Injectable(lensCoreFactory.token, () => lensCore))\n .provides(lensesClientFactory)\n .provides(remoteApiSpecsClientFactory)\n .provides(cameraKitLensSourceFactory)\n .provides(lensPersistenceStoreFactory)\n .provides(deviceDependentAssetLoaderFactory)\n .provides(staticAssetLoaderFactory)\n .provides(lensAssetRepositoryFactory)\n .provides(lensRepositoryFactory)\n .provides(cameraKitFactory)\n .run(fetchWatermarkLens);\n\n const cameraKit = container.get(cameraKitFactory.token);\n\n bootstrapLatency.measure();\n container.get(metricsClientFactory.token).setOperationalMetrics(bootstrapLatency);\n\n return cameraKit;\n } catch (error) {\n if (shouldWrapError(error)) {\n error = bootstrapError(\"Error occurred during Camera Kit bootstrapping.\", error);\n }\n logger.error(error);\n throw error;\n }\n}\n\n/\n Extensions offer a way to provide custom implementations of certain parts of the CameraKit SDK.\n \n This enables more advanced use-cases, in which the default behavior of the SDK is substantially altered. For example,\n * replacing the default implementation that loads remote lens assets with a custom implementation that returns\n * different assets based on some business logic within the application.\n \n An extension is implemented as a {@link PartialContainer} – a collection of factory functions, each with its own\n * dependencies, which each provide some \"Service\". A Service can be of any type, and the CameraKit SDK defines its\n * own Services, some of which can be overridden by providing a custom implementation of the type via an extension.\n \n Here's an example of how extensions might be used:\n * ```ts\n * import { bootstrapCameraKit, createExtension, remoteMediaAssetLoaderFactory } from '@snap/camera-kit'\n \n const myCustomRemoteAssetLoader = Injectable(\n * remoteMediaAssetLoaderFactory.token,\n * [remoteMediaAssetLoaderFactory.token] as const,\n * (defaultLoader: AssetLoader): AssetLoader => {\n * return async (asset, lens) => {\n * if (lens?.id === MY_SPECIAL_LENS) {\n * return (await fetch('my/asset.glb')).arrayBuffer()\n * }\n * return defaultLoader(asset, lens)\n * }\n * },\n * )\n \n const myExtension = createExtension().provides(myCustomRemoteAssetLoader);\n * const cameraKit = bootstrapCameraKit(config, container => container.provides(myExtension));\n * ```\n \n This also enables greater modularity – the person/team creating the extension can do so in their own package, which\n * could be shared by many applications that all require the same functionality.\n \n @returns A {@link PartialContainer} which can be used to create a collection of Services, and can later be provided\n * to CameraKit's DI container during {@link bootstrapCameraKit}.\n \n @category Bootstrapping and Configuration\n */\nexport function createExtension(): PartialContainer {\n return new PartialContainer({});\n}\n"]}

package/dist/clients/metricsClient.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+import type { Observable } from "rxjs";
 import { Subject } from "rxjs";
 import type { PageVisibility } from "../common/pageVisibility";
 import type { ServerEvent } from "../generated-proto/blizzard/cameraKitEvents";
@@ -13,15 +14,27 @@ export declare class MetricsClient {
     setBusinessEvents(event: ServerEvent): Promise<void>;
     setOperationalMetrics(metric: Metric): Promise<void>;
 }
-/** @internal */
+/**
+ * @internal
+ * @deprecated Use externalMetricsFactory instead, which provides an array of Observables that can be subscribed to,
+ * rather than a single Subject that is shared across all consumers.
+ * This allows for better encapsulation and prevents unintended interactions between
+ * different consumers of the metrics data.
+ */
 export declare const externalMetricsSubjectFactory: {
     (): Subject<Metric>;
     token: "externalMetricsSubject";
     dependencies: [];
 };
+/** @internal */
+export declare const externalMetricsFactory: {
+    (): Observable<Metric>[];
+    token: "externalMetrics";
+    dependencies: [];
+};
 export declare const metricsClientFactory: {
-    (args_0: Subject<Metric>, args_1: GrpcHandler, args_2: PageVisibility): MetricsClient;
+    (args_0: Subject<Metric>, args_1: Observable<Metric>[], args_2: GrpcHandler, args_3: PageVisibility): MetricsClient;
     token: "metricsClient";
-    dependencies: readonly ["externalMetricsSubject", "grpcHandlerFactory", "pageVisibility"];
+    dependencies: readonly ["externalMetricsSubject", "externalMetrics", "grpcHandlerFactory", "pageVisibility"];
 };
 //# sourceMappingURL=metricsClient.d.ts.map

package/dist/clients/metricsClient.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"metricsClient.d.ts","sourceRoot":"","sources":["../../src/clients/metricsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAU,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAO/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAOvF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAqBjD,qBAAa,aAAa;IAKlB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAsD;IAC5F,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4D;gBAGjF,UAAU,EAAE,oBAAoB,CAAC,OAAO,iBAAiB,CAAC,EAC3E,cAAc,EAAE,cAAc,GAAG,KAAK;IAgFpC,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7D;AAID~~,gBAAgB~~;~~AAChB~~,eAAO,MAAM,6BAA6B;;;;CAAoE,CAAC;AAE/G,eAAO,MAAM,oBAAoB;;;;~~CAYhC~~,CAAC"}
1	+ {"version":3,"file":"metricsClient.d.ts","sourceRoot":"","sources":["../../src/clients/metricsClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAU,MAAM,MAAM,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6CAA6C,CAAC;AAO/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAOvF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAqBjD,qBAAa,aAAa;IAKlB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAsD;IAC5F,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAA4D;gBAGjF,UAAU,EAAE,oBAAoB,CAAC,OAAO,iBAAiB,CAAC,EAC3E,cAAc,EAAE,cAAc,GAAG,KAAK;IAgFpC,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAO7D;AAID;;;;;;GAMG;AACH,eAAO,MAAM,6BAA6B;;;;CAAoE,CAAC;AAE/G,gBAAgB;AAChB,eAAO,MAAM,sBAAsB;;;;CAAkE,CAAC;AAEtG,eAAO,MAAM,oBAAoB;;;;CAuBhC,CAAC"}

package/dist/clients/metricsClient.js CHANGED Viewed

@@ -1,4 +1,5 @@
 import { __awaiter } from "tslib";
+import { merge } from "rxjs";
 import { Subject, filter } from "rxjs";
 import { Injectable } from "@snap/ts-inject";
 import { pageVisibilityFactory } from "../common/pageVisibility";
@@ -82,15 +83,22 @@ export class MetricsClient {
         });
     }
 }
-const validExternalMetrics = /^push2web_/;
+const validExternalMetrics = /^(push2web|react_camera_kit)_/;
 export const externalMetricsSubjectFactory = Injectable("externalMetricsSubject", () => new Subject());
-export const metricsClientFactory = Injectable("metricsClient", [externalMetricsSubjectFactory.token, grpcHandlerFactory.token, pageVisibilityFactory.token], (externalMetricsSubjectFactory, grpcHandler, pageVisibility) => {
-    const metrics = new MetricsClient(createTsProtoClient(MetricsDefinition, grpcHandler), pageVisibility);
-    externalMetricsSubjectFactory.pipe(filter((metric) => validExternalMetrics.test(metric.name))).subscribe({
+export const externalMetricsFactory = Injectable("externalMetrics", () => []);
+export const metricsClientFactory = Injectable("metricsClient", [
+    externalMetricsSubjectFactory.token,
+    externalMetricsFactory.token,
+    grpcHandlerFactory.token,
+    pageVisibilityFactory.token,
+], (externalMetricsSubjectFactory, externalMetrics, grpcHandler, pageVisibility) => {
+    const client = new MetricsClient(createTsProtoClient(MetricsDefinition, grpcHandler), pageVisibility);
+    const metrics = merge(externalMetricsSubjectFactory, ...externalMetrics);
+    metrics.pipe(filter((metric) => validExternalMetrics.test(metric.name))).subscribe({
         next: (metric) => {
-            metrics.setOperationalMetrics(metric);
+            client.setOperationalMetrics(metric);
         },
     });
-    return metrics;
+    return client;
 });
 //# sourceMappingURL=metricsClient.js.map

package/dist/clients/metricsClient.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"metricsClient.js","sourceRoot":"","sources":["../../src/clients/metricsClient.ts"],"names":[],"mappings":"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","sourcesContent":["import { Subject, filter } from \"rxjs\";\nimport { Injectable } from \"@snap/ts-inject\";\nimport type { PageVisibility } from \"../common/pageVisibility\";\nimport { pageVisibilityFactory } from \"../common/pageVisibility\";\nimport type { ServerEvent } from \"../generated-proto/blizzard/cameraKitEvents\";\nimport { ServerEventBatch } from \"../generated-proto/blizzard/cameraKitEvents\";\nimport type {\n OperationalMetric,\n OperationalMetricsBundle,\n} from \"../generated-proto/pb_schema/camera_kit/v3/operational_metrics\";\nimport type { SetBusinessEventsRequest } from \"../generated-proto/pb_schema/camera_kit/v3/service\";\nimport { MetricsDefinition } from \"../generated-proto/pb_schema/camera_kit/v3/service\";\nimport type { Handler, RequestMetadata } from \"../handlers/HandlerChainBuilder\";\nimport { HandlerChainBuilder } from \"../handlers/HandlerChainBuilder\";\nimport { createBatchingHandler } from \"../handlers/batchingHandler\";\nimport { createMappingHandler } from \"../handlers/mappingHandler\";\nimport { createRateLimitingHandler } from \"../handlers/rateLimitingHandler\";\nimport { isCountMetric } from \"../metrics/operational/Count\";\nimport type { Metric } from \"../metrics/operational/Metric\";\nimport type { TsProtoServiceClient } from \"./createTsProtoClient\";\nimport { createTsProtoClient } from \"./createTsProtoClient\";\nimport type { GrpcHandler } from \"./grpcHandler\";\nimport { grpcHandlerFactory } from \"./grpcHandler\";\n\n// Send at most one metric (operational or business) per second.\nconst METRIC_REQUEST_RATE_LIMIT_MS = 1000;\n\n// It is rather cumbersome to check the actual final size of a batch, but we can easily limit the number of events we\n// include in each batch -- looking at historical data, typical events average ~1.3kb per event. But there are some\n// events (like CAMERA_KIT_EXCEPTION, which includes a stack trace) that can be much larger.\n//\n// To prevent us running over the 64kibibyte limit imposed by browsers on `keep-alive` requests, we'll set quite a low\n// limit to ensure we don't lose events which are larger in size than we expect.\nconst BUSINESS_EVENT_BATCH_MAX_SIZE = 10;\nconst BUSINESS_EVENT_BATCH_MAX_AGE_MS = 5000;\n\n// These values are (currently) arbitrarily selected.\n// TODO: Once we have gathered a sufficient quantity of metrics data, we should tune these numbers to ensure we're\n// operating with the right cost vs. alarming SLA vs. IDB storage size tradeoffs.\nconst METRIC_BATCH_MAX_SIZE = 100;\nconst METRIC_BATCH_MAX_AGE_MS = 5000;\n\nexport class MetricsClient {\n private readonly businessEventsHandler: Handler<ServerEvent, void, RequestInit \| undefined>;\n private readonly operationalMetricsHandler: Handler<OperationalMetric, void, RequestInit \| undefined>;\n\n constructor(\n private readonly grpcClient: TsProtoServiceClient<typeof MetricsDefinition>,\n pageVisibility: PageVisibility \| false\n ) {\n // Both business events and operational metrics will share a rate limit.\n const rateLimitingHandler = createRateLimitingHandler<any, any, RequestMetadata>(\n METRIC_REQUEST_RATE_LIMIT_MS,\n pageVisibility\n );\n\n // The business events handler has to do some manual encoding, because the CameraKit service's backend expects\n // an `Any` type inside of SetBusinessEventsRequest -- even though this `Any` type is always `ServerEventBatch`.\n // eslint-disable-next-line max-len\n // See: https://github.sc-corp.net/Snapchat/pb_schema/blob/4bc5ec98243c472c848cccc577d8cfd21317af51/proto/camera_kit/v3/service.proto#L94\n this.businessEventsHandler = new HandlerChainBuilder(async (request: SetBusinessEventsRequest) => {\n await this.grpcClient.setBusinessEvents(request);\n })\n .map(rateLimitingHandler)\n .map(\n createMappingHandler((serverEvents: ServerEvent[]) => {\n const batch: ServerEventBatch = ServerEventBatch.fromPartial({ serverEvents });\n const request: SetBusinessEventsRequest = {\n batchEvents: {\n typeUrl: \"com.snapchat.analytics.blizzard.ServerEventBatch\",\n value: ServerEventBatch.encode(batch).finish(),\n },\n };\n return request;\n }, pageVisibility)\n )\n .map(\n createBatchingHandler({\n batchReduce: (previous: ServerEvent[] \| undefined, event: ServerEvent) => {\n const batch = previous ?? [];\n batch.push(event);\n return batch;\n },\n isBatchComplete: (batch) => batch.length >= BUSINESS_EVENT_BATCH_MAX_SIZE,\n maxBatchAge: BUSINESS_EVENT_BATCH_MAX_AGE_MS,\n pageVisibility,\n })\n ).handler;\n\n // The operational metrics handler is slightly simpler, but it has more interesting batching logic (e.g. we can\n // sum up Count metrics, for example, rather than sending multiple single-count metrics objects).\n this.operationalMetricsHandler = new HandlerChainBuilder(async (metrics: OperationalMetricsBundle) => {\n await this.grpcClient.setOperationalMetrics({ metrics });\n })\n .map(rateLimitingHandler)\n .map(\n createBatchingHandler({\n // The batching logic here is very simple – it could be improved by e.g.\n // computing statistics to reduce overall data sent, etc. Right now this is\n // premature optimization, but could become a good idea in the future.\n batchReduce: (previous: OperationalMetricsBundle \| undefined, metric: OperationalMetric) => {\n const batch: OperationalMetricsBundle = { metrics: previous?.metrics ?? [] };\n\n // For \"count\" metrics, it's straightforward to merge them into\n // a single metric with the same name.\n if (isCountMetric(metric)) {\n const priorCount = batch.metrics.find((m) => {\n return isCountMetric(m) && m.name === metric.name;\n });\n if (priorCount && isCountMetric(priorCount)) {\n priorCount.metric.count = `${\n Number(priorCount.metric.count) + Number(metric.metric.count)\n }`;\n return batch;\n }\n }\n\n // For all other cases, we'll just add the metric separately to the batch.\n batch.metrics.push(metric);\n return batch;\n },\n isBatchComplete: (bundle) => bundle.metrics.length >= METRIC_BATCH_MAX_SIZE,\n maxBatchAge: METRIC_BATCH_MAX_AGE_MS,\n pageVisibility,\n })\n ).handler;\n }\n\n async setBusinessEvents(event: ServerEvent): Promise<void> {\n await this.businessEventsHandler(event);\n }\n\n async setOperationalMetrics(metric: Metric): Promise<void> {\n await Promise.all(\n metric.toOperationalMetric().map((metric) => {\n return this.operationalMetricsHandler(metric);\n })\n );\n }\n}\n\nconst validExternalMetrics = /^push2web_/;\n\n/** @internal */\nexport const externalMetricsSubjectFactory = Injectable(\"externalMetricsSubject\", () => new Subject<Metric>());\n\nexport const metricsClientFactory = Injectable(\n \"metricsClient\",\n [externalMetricsSubjectFactory.token, grpcHandlerFactory.token, pageVisibilityFactory.token] as const,\n (externalMetricsSubjectFactory: Subject<Metric>, grpcHandler: GrpcHandler, pageVisibility: PageVisibility) => {\n const metrics = new MetricsClient(createTsProtoClient(MetricsDefinition, grpcHandler), pageVisibility);\n externalMetricsSubjectFactory.pipe(filter((metric) => validExternalMetrics.test(metric.name))).subscribe({\n next: (metric) => {\n metrics.setOperationalMetrics(metric);\n },\n });\n return metrics;\n }\n);\n"]}
1	+ {"version":3,"file":"metricsClient.js","sourceRoot":"","sources":["../../src/clients/metricsClient.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAM/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oDAAoD,CAAC;AAEvF,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAG7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGnD,MAAM,4BAA4B,GAAG,IAAI,CAAC;AAQ1C,MAAM,6BAA6B,GAAG,EAAE,CAAC;AACzC,MAAM,+BAA+B,GAAG,IAAI,CAAC;AAK7C,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,MAAM,OAAO,aAAa;IAItB,YACqB,UAA0D,EAC3E,cAAsC;QADrB,eAAU,GAAV,UAAU,CAAgD;QAI3E,MAAM,mBAAmB,GAAG,yBAAyB,CACjD,4BAA4B,EAC5B,cAAc,CACjB,CAAC;QAMF,IAAI,CAAC,qBAAqB,GAAG,IAAI,mBAAmB,CAAC,CAAO,OAAiC,EAAE,EAAE;YAC7F,MAAM,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;QACrD,CAAC,CAAA,CAAC;aACG,GAAG,CAAC,mBAAmB,CAAC;aACxB,GAAG,CACA,oBAAoB,CAAC,CAAC,YAA2B,EAAE,EAAE;YACjD,MAAM,KAAK,GAAqB,gBAAgB,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;YAC/E,MAAM,OAAO,GAA6B;gBACtC,WAAW,EAAE;oBACT,OAAO,EAAE,kDAAkD;oBAC3D,KAAK,EAAE,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE;iBACjD;aACJ,CAAC;YACF,OAAO,OAAO,CAAC;QACnB,CAAC,EAAE,cAAc,CAAC,CACrB;aACA,GAAG,CACA,qBAAqB,CAAC;YAClB,WAAW,EAAE,CAAC,QAAmC,EAAE,KAAkB,EAAE,EAAE;gBACrE,MAAM,KAAK,GAAG,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,EAAE,CAAC;gBAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,6BAA6B;YACzE,WAAW,EAAE,+BAA+B;YAC5C,cAAc;SACjB,CAAC,CACL,CAAC,OAAO,CAAC;QAId,IAAI,CAAC,yBAAyB,GAAG,IAAI,mBAAmB,CAAC,CAAO,OAAiC,EAAE,EAAE;YACjG,MAAM,IAAI,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAA,CAAC;aACG,GAAG,CAAC,mBAAmB,CAAC;aACxB,GAAG,CACA,qBAAqB,CAAC;YAIlB,WAAW,EAAE,CAAC,QAA8C,EAAE,MAAyB,EAAE,EAAE;;gBACvF,MAAM,KAAK,GAA6B,EAAE,OAAO,EAAE,MAAA,QAAQ,aAAR,QAAQ,uBAAR,QAAQ,CAAE,OAAO,mCAAI,EAAE,EAAE,CAAC;gBAI7E,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE;oBACvB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;wBACxC,OAAO,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,CAAC;oBACtD,CAAC,CAAC,CAAC;oBACH,IAAI,UAAU,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE;wBACzC,UAAU,CAAC,MAAM,CAAC,KAAK,GAAG,GACtB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAChE,EAAE,CAAC;wBACH,OAAO,KAAK,CAAC;qBAChB;iBACJ;gBAGD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC3B,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,eAAe,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,qBAAqB;YAC3E,WAAW,EAAE,uBAAuB;YACpC,cAAc;SACjB,CAAC,CACL,CAAC,OAAO,CAAC;IAClB,CAAC;IAEK,iBAAiB,CAAC,KAAkB;;YACtC,MAAM,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC5C,CAAC;KAAA;IAEK,qBAAqB,CAAC,MAAc;;YACtC,MAAM,OAAO,CAAC,GAAG,CACb,MAAM,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;gBACxC,OAAO,IAAI,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC;YAClD,CAAC,CAAC,CACL,CAAC;QACN,CAAC;KAAA;CACJ;AAED,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAS7D,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC,wBAAwB,EAAE,GAAG,EAAE,CAAC,IAAI,OAAO,EAAU,CAAC,CAAC;AAG/G,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,EAA0B,CAAC,CAAC;AAEtG,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAC1C,eAAe,EACf;IACI,6BAA6B,CAAC,KAAK;IACnC,sBAAsB,CAAC,KAAK;IAC5B,kBAAkB,CAAC,KAAK;IACxB,qBAAqB,CAAC,KAAK;CACrB,EACV,CACI,6BAA8C,EAC9C,eAAqC,EACrC,WAAwB,EACxB,cAA8B,EAChC,EAAE;IACA,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC;IACtG,MAAM,OAAO,GAAG,KAAK,CAAC,6BAA6B,EAAE,GAAG,eAAe,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE;YACb,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;KACJ,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAClB,CAAC,CACJ,CAAC","sourcesContent":["import type { Observable } from \"rxjs\";\nimport { merge } from \"rxjs\";\nimport { Subject, filter } from \"rxjs\";\nimport { Injectable } from \"@snap/ts-inject\";\nimport type { PageVisibility } from \"../common/pageVisibility\";\nimport { pageVisibilityFactory } from \"../common/pageVisibility\";\nimport type { ServerEvent } from \"../generated-proto/blizzard/cameraKitEvents\";\nimport { ServerEventBatch } from \"../generated-proto/blizzard/cameraKitEvents\";\nimport type {\n OperationalMetric,\n OperationalMetricsBundle,\n} from \"../generated-proto/pb_schema/camera_kit/v3/operational_metrics\";\nimport type { SetBusinessEventsRequest } from \"../generated-proto/pb_schema/camera_kit/v3/service\";\nimport { MetricsDefinition } from \"../generated-proto/pb_schema/camera_kit/v3/service\";\nimport type { Handler, RequestMetadata } from \"../handlers/HandlerChainBuilder\";\nimport { HandlerChainBuilder } from \"../handlers/HandlerChainBuilder\";\nimport { createBatchingHandler } from \"../handlers/batchingHandler\";\nimport { createMappingHandler } from \"../handlers/mappingHandler\";\nimport { createRateLimitingHandler } from \"../handlers/rateLimitingHandler\";\nimport { isCountMetric } from \"../metrics/operational/Count\";\nimport type { Metric } from \"../metrics/operational/Metric\";\nimport type { TsProtoServiceClient } from \"./createTsProtoClient\";\nimport { createTsProtoClient } from \"./createTsProtoClient\";\nimport type { GrpcHandler } from \"./grpcHandler\";\nimport { grpcHandlerFactory } from \"./grpcHandler\";\n\n// Send at most one metric (operational or business) per second.\nconst METRIC_REQUEST_RATE_LIMIT_MS = 1000;\n\n// It is rather cumbersome to check the actual final size of a batch, but we can easily limit the number of events we\n// include in each batch -- looking at historical data, typical events average ~1.3kb per event. But there are some\n// events (like CAMERA_KIT_EXCEPTION, which includes a stack trace) that can be much larger.\n//\n// To prevent us running over the 64kibibyte limit imposed by browsers on `keep-alive` requests, we'll set quite a low\n// limit to ensure we don't lose events which are larger in size than we expect.\nconst BUSINESS_EVENT_BATCH_MAX_SIZE = 10;\nconst BUSINESS_EVENT_BATCH_MAX_AGE_MS = 5000;\n\n// These values are (currently) arbitrarily selected.\n// TODO: Once we have gathered a sufficient quantity of metrics data, we should tune these numbers to ensure we're\n// operating with the right cost vs. alarming SLA vs. IDB storage size tradeoffs.\nconst METRIC_BATCH_MAX_SIZE = 100;\nconst METRIC_BATCH_MAX_AGE_MS = 5000;\n\nexport class MetricsClient {\n private readonly businessEventsHandler: Handler<ServerEvent, void, RequestInit \| undefined>;\n private readonly operationalMetricsHandler: Handler<OperationalMetric, void, RequestInit \| undefined>;\n\n constructor(\n private readonly grpcClient: TsProtoServiceClient<typeof MetricsDefinition>,\n pageVisibility: PageVisibility \| false\n ) {\n // Both business events and operational metrics will share a rate limit.\n const rateLimitingHandler = createRateLimitingHandler<any, any, RequestMetadata>(\n METRIC_REQUEST_RATE_LIMIT_MS,\n pageVisibility\n );\n\n // The business events handler has to do some manual encoding, because the CameraKit service's backend expects\n // an `Any` type inside of SetBusinessEventsRequest -- even though this `Any` type is always `ServerEventBatch`.\n // eslint-disable-next-line max-len\n // See: https://github.sc-corp.net/Snapchat/pb_schema/blob/4bc5ec98243c472c848cccc577d8cfd21317af51/proto/camera_kit/v3/service.proto#L94\n this.businessEventsHandler = new HandlerChainBuilder(async (request: SetBusinessEventsRequest) => {\n await this.grpcClient.setBusinessEvents(request);\n })\n .map(rateLimitingHandler)\n .map(\n createMappingHandler((serverEvents: ServerEvent[]) => {\n const batch: ServerEventBatch = ServerEventBatch.fromPartial({ serverEvents });\n const request: SetBusinessEventsRequest = {\n batchEvents: {\n typeUrl: \"com.snapchat.analytics.blizzard.ServerEventBatch\",\n value: ServerEventBatch.encode(batch).finish(),\n },\n };\n return request;\n }, pageVisibility)\n )\n .map(\n createBatchingHandler({\n batchReduce: (previous: ServerEvent[] \| undefined, event: ServerEvent) => {\n const batch = previous ?? [];\n batch.push(event);\n return batch;\n },\n isBatchComplete: (batch) => batch.length >= BUSINESS_EVENT_BATCH_MAX_SIZE,\n maxBatchAge: BUSINESS_EVENT_BATCH_MAX_AGE_MS,\n pageVisibility,\n })\n ).handler;\n\n // The operational metrics handler is slightly simpler, but it has more interesting batching logic (e.g. we can\n // sum up Count metrics, for example, rather than sending multiple single-count metrics objects).\n this.operationalMetricsHandler = new HandlerChainBuilder(async (metrics: OperationalMetricsBundle) => {\n await this.grpcClient.setOperationalMetrics({ metrics });\n })\n .map(rateLimitingHandler)\n .map(\n createBatchingHandler({\n // The batching logic here is very simple – it could be improved by e.g.\n // computing statistics to reduce overall data sent, etc. Right now this is\n // premature optimization, but could become a good idea in the future.\n batchReduce: (previous: OperationalMetricsBundle \| undefined, metric: OperationalMetric) => {\n const batch: OperationalMetricsBundle = { metrics: previous?.metrics ?? [] };\n\n // For \"count\" metrics, it's straightforward to merge them into\n // a single metric with the same name.\n if (isCountMetric(metric)) {\n const priorCount = batch.metrics.find((m) => {\n return isCountMetric(m) && m.name === metric.name;\n });\n if (priorCount && isCountMetric(priorCount)) {\n priorCount.metric.count = `${\n Number(priorCount.metric.count) + Number(metric.metric.count)\n }`;\n return batch;\n }\n }\n\n // For all other cases, we'll just add the metric separately to the batch.\n batch.metrics.push(metric);\n return batch;\n },\n isBatchComplete: (bundle) => bundle.metrics.length >= METRIC_BATCH_MAX_SIZE,\n maxBatchAge: METRIC_BATCH_MAX_AGE_MS,\n pageVisibility,\n })\n ).handler;\n }\n\n async setBusinessEvents(event: ServerEvent): Promise<void> {\n await this.businessEventsHandler(event);\n }\n\n async setOperationalMetrics(metric: Metric): Promise<void> {\n await Promise.all(\n metric.toOperationalMetric().map((metric) => {\n return this.operationalMetricsHandler(metric);\n })\n );\n }\n}\n\nconst validExternalMetrics = /^(push2web\|react_camera_kit)_/;\n\n/*\n @internal\n * @deprecated Use externalMetricsFactory instead, which provides an array of Observables that can be subscribed to,\n * rather than a single Subject that is shared across all consumers.\n * This allows for better encapsulation and prevents unintended interactions between\n * different consumers of the metrics data.\n /\nexport const externalMetricsSubjectFactory = Injectable(\"externalMetricsSubject\", () => new Subject<Metric>());\n\n/* @internal */\nexport const externalMetricsFactory = Injectable(\"externalMetrics\", () => [] as Observable<Metric>[]);\n\nexport const metricsClientFactory = Injectable(\n \"metricsClient\",\n [\n externalMetricsSubjectFactory.token,\n externalMetricsFactory.token,\n grpcHandlerFactory.token,\n pageVisibilityFactory.token,\n ] as const,\n (\n externalMetricsSubjectFactory: Subject<Metric>,\n externalMetrics: Observable<Metric>[],\n grpcHandler: GrpcHandler,\n pageVisibility: PageVisibility\n ) => {\n const client = new MetricsClient(createTsProtoClient(MetricsDefinition, grpcHandler), pageVisibility);\n const metrics = merge(externalMetricsSubjectFactory, ...externalMetrics);\n metrics.pipe(filter((metric) => validExternalMetrics.test(metric.name))).subscribe({\n next: (metric) => {\n client.setOperationalMetrics(metric);\n },\n });\n return client;\n }\n);\n"]}

package/dist/configuration.d.ts CHANGED Viewed

@@ -10,9 +10,24 @@ interface CameraKitRuntimeConfiguration {
     userAgentFlavor: "release" | "debug";
     fonts: Font[];
     lensHttpHandler?: LensHttpHandler;
+    lensHttpValidationStrategy: ValidationStrategy;
     trustedTypesPolicyName: string;
 }
 export type CameraKitApiHostname = "camera-kit-api.snapar.com" | "api-kit.snapchat.com";
+/**
+ * Defines how Camera Kit handles lens HTTP requests against Remote API specs in the My Lenses portal.
+ *
+ * - `"deny"`: Rejects all lens HTTP requests.
+ * - `"strict"`: Full validation: host + path + method + path parameters + query parameters + headers. Default.
+ * - `"route"`: Validates host + path + method + path parameters (skips query parameters and headers).
+ * - `"host"`: Validates host only.
+ * - `"unrestricted"`: No validation.
+ *
+ * @remarks
+ * Use `"unrestricted"` only if you fully trust your lens developers. Lenses will be able to make
+ * HTTP requests to any endpoint without validation against the allowlist.
+ */
+export type ValidationStrategy = "deny" | "strict" | "route" | "host" | "unrestricted";
 /**
  * Represents a font to be used by Camera Kit for text rendering.
  */
@@ -170,8 +185,6 @@ export interface CameraKitBootstrapConfiguration {
      * If not specified, the Lens system will use a default HTTP implementation.
      *
      * @example
-     * Here is an example of how to configure a custom `LensHttpHandler` to add an authentication token:
-     *
      * ```typescript
      * const customLensHttpHandler: LensHttpHandler = async (url, init, lensRequest) => {
      *   // Add an authentication token to the headers
@@ -198,6 +211,43 @@ export interface CameraKitBootstrapConfiguration {
      * ```
      */
     lensHttpHandler?: LensHttpHandler;
+    /**
+     * Configures how Camera Kit validates lens HTTP requests against Remote API specs.
+     *
+     * Available strategies:
+     * - `"deny"`: Rejects all lens HTTP requests.
+     * - `"strict"` (default): Full validation of host, path, method, and parameters.
+     * - `"route"`: Validates host, path (including path parameters), and method.
+     *              Skips validation of query parameters and headers.
+     * - `"host"`: Only validates the host.
+     * - `"unrestricted"`: No validation.
+     *
+     * @remarks
+     * Use `"unrestricted"` only if you fully trust your lens developers, as lenses will be able to make
+     * HTTP requests to any endpoint without validation.
+     *
+     * @example
+     * ```typescript
+     * const cameraKit = bootstrapCameraKit({
+     *   apiToken,
+     *   lensHttpValidationStrategy: "host",
+     * });
+     * ```
+     *
+     * @example
+     * Combine with custom handler:
+     * ```typescript
+     * const cameraKit = bootstrapCameraKit({
+     *   apiToken,
+     *   lensHttpValidationStrategy: "unrestricted",
+     *   lensHttpHandler: async (url, init, lensRequest) => {
+     *     // Custom logic here
+     *     return fetch(url, init);
+     *   },
+     * });
+     * ```
+     */
+    lensHttpValidationStrategy?: ValidationStrategy;
     /**
      * The name of the Trusted Types policy to use when loading scripts.
      * Defaults to "snap-camera-kit".

package/dist/configuration.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AAG3F,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAyB,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;~~AA2BpF~~,UAAU,6BAA6B;IACnC,eAAe,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,oBAAoB,CAAC;IAClC,eAAe,EAAE,SAAS,GAAG,OAAO,CAAC;IACrC,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,sBAAsB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,MAAM,oBAAoB,GAAG,2BAA2B,GAAG,sBAAsB,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,IAAI;IACjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,eAAe,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAElH;;;;;GAKG;AACH,MAAM,WAAW,+BAA+B;IAC5C;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB;;;;;;;;;;;;;;;;;;;OAmBG;IACH,eAAe,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAE/E;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAEpD;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC;IAEf~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoCG~~;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAElC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,GAAG,+BAA+B,CAAC;AAErG,gBAAgB;AAChB,eAAO,MAAM,kBAAkB,kBAAkB,CAAC;AAelD,gBAAgB;AAChB,eAAO,MAAM,mCAAmC,kBAAmB,+BAA+B;;;;~~CA2BjG~~,CAAC"}
1	+ {"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../src/configuration.ts"],"names":[],"mappings":"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"}

package/dist/configuration.js CHANGED Viewed

@@ -10,6 +10,7 @@ const defaultConfiguration = {
     apiHostname: "camera-kit-api.snapar.com",
     userAgentFlavor: "release",
     fonts: [],
+    lensHttpValidationStrategy: "strict",
     trustedTypesPolicyName: "snap-camera-kit",
 };
 export const configurationToken = "configuration";