@snap/camera-kit 0.14.1 → 0.15.0

package/docs/md/modules.md

@@ -1,6 +1,6 @@
-[CameraKit Web SDK - v0.14.1-alpha.1](README.md) / Exports
+[CameraKit Web SDK - v0.15.0-alpha.1](README.md) / Exports
 
-# CameraKit Web SDK - v0.14.1-alpha.1
+# CameraKit Web SDK - v0.15.0-alpha.1
 
 ## Table of contents
 
@@ -9,7 +9,6 @@
 - [CameraKit](classes/CameraKit.md)
 - [TypedCustomEvent](classes/TypedCustomEvent.md)
 - [TypedEventTarget](classes/TypedEventTarget.md)
-- [LensSources](classes/LensSources.md)
 - [LensRepository](classes/LensRepository.md)
 - [CameraKitSource](classes/CameraKitSource.md)
 - [CameraKitSession](classes/CameraKitSession.md)
@@ -22,7 +21,6 @@
 - [CreateSessionOptions](interfaces/CreateSessionOptions.md)
 - [EstimatedLensPerformance](interfaces/EstimatedLensPerformance.md)
 - [CameraKitBootstrapConfiguration](interfaces/CameraKitBootstrapConfiguration.md)
-- [LensSource](interfaces/LensSource.md)
 - [RemoteApiRequest](interfaces/RemoteApiRequest.md)
 - [RemoteApiResponse](interfaces/RemoteApiResponse.md)
 - [RemoteApiService](interfaces/RemoteApiService.md)
@@ -32,6 +30,8 @@
 - [Lens](interfaces/Lens.md)
 - [Preview](interfaces/Preview.md)
 - [Snapcode](interfaces/Snapcode.md)
+- [LensLaunchData](interfaces/LensLaunchData.md)
+- [LensSource](interfaces/LensSource.md)
 - [CameraKitSourceSubscriber](interfaces/CameraKitSourceSubscriber.md)
 - [MediaStreamSourceOptions](interfaces/MediaStreamSourceOptions.md)
 - [VideoSourceOptions](interfaces/VideoSourceOptions.md)
@@ -46,7 +46,6 @@
 - [RemoteApiRequestHandler](modules.md#remoteapirequesthandler)
 - [RemoteApiServices](modules.md#remoteapiservices)
 - [Uri](modules.md#uri)
-- [LensLaunchParams](modules.md#lenslaunchparams)
 - [AssetTiming](modules.md#assettiming)
 - [AssetLoader](modules.md#assetloader)
 - [CameraKitDeviceInfo](modules.md#camerakitdeviceinfo)
@@ -86,9 +85,10 @@
 - [bootstrapCameraKit](modules.md#bootstrapcamerakit)
 - [createExtension](modules.md#createextension)
 - [Injectable](modules.md#injectable)
-- [lensSourcesFactory](modules.md#lenssourcesfactory)
+- [ConcatInjectable](modules.md#concatinjectable)
 - [remoteApiServicesFactory](modules.md#remoteapiservicesfactory)
 - [getRequiredBootstrapURLs](modules.md#getrequiredbootstrapurls)
+- [lensSourcesFactory](modules.md#lenssourcesfactory)
 - [createImageSource](modules.md#createimagesource)
 - [createUserMediaSource](modules.md#createusermediasource)
 - [createMediaStreamSource](modules.md#createmediastreamsource)
@@ -289,14 +289,6 @@ These events are emitted by [CameraKit](classes/CameraKit.md) to report lens usa
 
 ___
 
-### LensLaunchParams
-
-Ƭ **LensLaunchParams**: `Record`<`string`, `string` \| `number` \| `string`[] \| `number`[]\>
-
-Various lenses may support the passing of certain parameters from the application to the lens when it is launched.
-
-___
-
 ### AssetTiming
 
 Ƭ **AssetTiming**: keyof typeof `assetTimingMap`
@@ -651,13 +643,13 @@ ___
 
 ▸ **Injectable**<`Token`, `Service`\>(`token`, `fn`): `InjectableFunction`<`any`, [], `Token`, `Service`\>
 
-Create an Injectable function with no dependencies (i.e. arguments).
+Create an Injectable factory function with no dependencies (i.e. the factory function has no arguments).
 
 Ex:
 ```ts
-const createMyService = Factory(
+const createMyService = Injectable(
   'MyService',
-  () => { ... },
+  () => { return ... },
 )
 ```
 
@@ -681,18 +673,17 @@ const createMyService = Factory(
 
 ▸ **Injectable**<`Token`, `Tokens`, `Params`, `Service`\>(`token`, `dependencies`, `fn`): `Tokens`[``"length"``] extends `Params`[``"length"``] ? `InjectableFunction`<`ServicesFromTokenizedParams`<`Tokens`, `Params`\>, `Tokens`, `Token`, `Service`\> : `never`
 
-Create an Injectable function with dependencies (i.e. arguments).
+Create an Injectable factory function with dependencies (i.e. the factory function has arguments).
 
-**Note:** the list of dependencies must be readonly – that is, a literal tuple marked `as const`. This tuple must
-contain only string literals or string consts.
+**Note:** the list of dependencies must contain only string literals or string consts.
 
 Ex:
 ```ts
 const DependencyB = 'DependencyB'
-const createMyService = Factory(
+const createMyService = Injectable(
   'MyService',
-  ['DependencyA', DependencyB] as const,
-  (a: A, b: B) => { ... },
+  ['DependencyA', DependencyB],
+  (a: A, b: B) => { return ... },
 )
 ```
 
@@ -710,7 +701,7 @@ const createMyService = Factory(
 | Name | Type | Description |
 | :------ | :------ | :------ |
 | `token` | `Token` | A unique string Token which will correspond to the created Service. |
-| `dependencies` | `Tokens` | A *readonly* list of Tokens corresponding to dependencies (i.e. arguments to the Factory), which will be resolved by the Container to which this Factory is provided. |
+| `dependencies` | `Tokens` | A *readonly* list of Tokens corresponding to dependencies (i.e. arguments to the Factory), which will be resolved by the Container to which this Injectable is provided. |
 | `fn` | (...`args`: `Tokens`[``"length"``] extends `Params`[``"length"``] ? `Params` : `void`[]) => `Service` | A function with arguments matching in type and length to the given list of dependencies. When called, it must return the Service. |
 
 #### Returns
@@ -719,19 +710,91 @@ const createMyService = Factory(
 
 ___
 
-### lensSourcesFactory
+### ConcatInjectable
 
-▸ **lensSourcesFactory**(`...args`): [`LensSources`](classes/LensSources.md)
+▸ **ConcatInjectable**<`Token`, `Service`\>(`token`, `fn`): `InjectableFunction`<{ [T in keyof Token]: Service[] }, [], `Token`, `Service`[]\>
+
+Create an Injectable factory function without dependencies (i.e. the factory function has no arguments) that appends
+a Service onto an existing array of Services of the same type.
+
+Ex:
+```ts
+import { myServiceFactory, MyService } from './my-service'
+
+const createMyService = ConcatInjectable(
+  myServiceFactory.token,
+  (): MyService => { return ... },
+)
+
+// Consumers then do:
+const myConsumingServiceFactory = Injectable(
+  'myConsumingService',
+  [ myServiceFactory.token ],
+  (myServices: MyService[]) => { return ... }
+)
+```
+
+#### Type parameters
+
+| Name | Type |
+| :------ | :------ |
+| `Token` | extends `string` |
+| `Service` | `Service` |
 
 #### Parameters
 
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `token` | `Token` | A string Token identifying an existing Service that has an Array type, to which will be appended the Service created by this factory function. |
+| `fn` | () => `Service` | A function with no arguments which returns the Service. |
+
+#### Returns
+
+`InjectableFunction`<{ [T in keyof Token]: Service[] }, [], `Token`, `Service`[]\>
+
+▸ **ConcatInjectable**<`Token`, `Tokens`, `Params`, `Service`\>(`token`, `dependencies`, `fn`): `InjectableFunction`<`ServicesFromTokenizedParams`<`Tokens`, `Params`\>, `Tokens`, `Token`, `Service`[]\>
+
+Create an Injectable factory function with dependencies (i.e. the factory function has arguments) that appends
+a Service onto an existing array of Services of the same type.
+
+Ex:
+```ts
+import { myServiceFactory, MyService } from './my-service'
+
+const createMyService = ConcatInjectable(
+  myServiceFactory.token,
+  ['DependencyA', 'DependencyB'],
+  (a: A, b: B): MyService => { return ... },
+)
+
+// Consumers then do:
+const myConsumingServiceFactory = Injectable(
+  'myConsumingService',
+  [ myServiceFactory.token ],
+  (myServices: MyService[]) => { return ... }
+)
+```
+
+#### Type parameters
+
 | Name | Type |
 | :------ | :------ |
-| `...args` | [] |
+| `Token` | extends `string` |
+| `Tokens` | extends readonly `string`[] |
+| `Params` | extends readonly `any`[] |
+| `Service` | `Service` |
+
+#### Parameters
+
+| Name | Type | Description |
+| :------ | :------ | :------ |
+| `token` | `Token` | A string Token identifying an existing Service that has an Array type, to which will be appended the Service created by this factory function. |
+| `dependencies` | `Tokens` | A *readonly* list of Tokens corresponding to dependencies (i.e. arguments to the Factory), which will be resolved by the Container to which this Injectable is provided. |
+| `fn` | (...`args`: `Tokens`[``"length"``] extends `Params`[``"length"``] ? `Params` : `void`[]) => `Service` | A function with no arguments which returns the Service. |
 
 #### Returns
 
-[`LensSources`](classes/LensSources.md)
+`InjectableFunction`<`ServicesFromTokenizedParams`<`Tokens`, `Params`\>, `Tokens`, `Token`, `Service`[]\>
 
 ___
 
@@ -749,6 +812,40 @@ ___
 
 [`RemoteApiServices`](modules.md#remoteapiservices)
 
+___
+
+### lensSourcesFactory
+
+▸ **lensSourcesFactory**(`...args`): [`LensSource`](interfaces/LensSource.md)[]
+
+By default, no custom LensSources are provided to CameraKit. But to enable certain advanced use-cases,
+applications may provide their own LensSources.
+
+Perhaps the most convenient way to do this is with [ConcatInjectable](modules.md#concatinjectable), as shown here:
+
+**`Example`**
+
+```ts
+import { bootstrapCameraKit, lensSourcesFactory, LensSource } from '@snap/camera-kit'
+
+const cameraKit = bootstrapCameraKit(config, (container) => {
+  return container.provides(ConcatInjectable(
+    lensSourcesFactory.token,
+    (): LensSource => { return ... }
+  ))
+})
+```
+
+#### Parameters
+
+| Name | Type |
+| :------ | :------ |
+| `...args` | [] |
+
+#### Returns
+
+[`LensSource`](interfaces/LensSource.md)[]
+
 ## Rendering
 
 ### CameraKitDeviceInfo

package/lib/CameraKit.d.ts

@@ -212,7 +212,6 @@ export declare const cameraKitFactory: {
         useMediaElement: (input: Omit<import("./lens-core-module").UseMediaElementInput, "onFailure" | "onSuccess">) => Promise<any>;
         setFPSLimit: (input: Omit<import("./lens-core-module").SetFpsLimitInput, "onFailure" | "onSuccess">) => Promise<any>;
         setRenderLoopMode: (input: Omit<import("./lens-core-module").SetRenderLoopInput, "onFailure" | "onSuccess">) => Promise<any>;
-        playCanvas: (input: Omit<import("./lens-core-module").PlayCanvasInput, "onFailure" | "onSuccess">) => Promise<any>;
         pauseCanvas: (input: Omit<import("./lens-core-module").PauseCanvasInput, "onFailure" | "onSuccess">) => Promise<any>;
         setRenderSize: (input: Omit<import("./lens-core-module").SetRenderSizeMatchInputResolutionInput, "onFailure" | "onSuccess"> | Omit<import("./lens-core-module").SetRenderSizeExplicitInput, "onFailure" | "onSuccess">) => Promise<any>;
         setInputTransform: (input: Omit<import("./lens-core-module").SetInputTransformInput, "onFailure" | "onSuccess">) => Promise<any>;
@@ -239,6 +238,7 @@ export declare const cameraKitFactory: {
             assetChecksum?: string | undefined;
             onFailure?: ((err: LensCoreError) => void) | undefined;
         }): void;
+        playCanvas(input: Omit<import("./lens-core-module").PlayCanvasInput, "onFailure" | "onSuccess" | "onReady">): Promise<void>;
     }, args_3: PageVisibility, args_4: Container<{
         LensRepository: LensRepository;
     } & {
@@ -261,6 +261,14 @@ export declare const cameraKitFactory: {
         (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers").FetchHandler): import("./handlers/HandlerChainBuilder").Handler<RequestInfo, Response, RequestInit | undefined>;
         token: "cameraKitServiceFetchHandler";
         dependencies: readonly ["configuration", "defaultFetchHandler"];
+    }, {
+        (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers").FetchHandler): import("./clients/grpcHandler").GrpcHandler;
+        token: "grpcHandler";
+        dependencies: readonly ["configuration", "cameraKitServiceFetchHandler"];
+    }, {
+        (args_0: import("./clients/grpcHandler").GrpcHandler): import("./clients/lensesClient").LensesClient;
+        token: "lensesClient";
+        dependencies: readonly ["grpcHandler"];
     }, {
         (args_0: import("./configuration").CameraKitConfiguration, args_1: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_2: import("./metrics/operational/operationalMetricsReporter").OperationalMetricsReporter): import("./handlers/HandlerChainBuilder").Handler<Partial<import("./generated-proto/pb_schema/cdp/cof/config_request").ConfigTargetingRequest>, import("./generated-proto/pb_schema/cdp/cof/config_response").ConfigTargetingResponse, import("./remote-configuration/cofHandler").Metadata & {
             signal?: AbortSignal | null | undefined;
@@ -276,9 +284,9 @@ export declare const cameraKitFactory: {
         token: "remoteConfiguration";
         dependencies: readonly ["configuration", "cofHandler", "cameraKitServiceFetchHandler"];
     }, {
-        (args_0: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_1: import("./handlers").FetchHandler, args_2: import("./handlers").FetchHandler, args_3: import("./lens").LensSources, args_4: import("./lens").LensAssetRepository, args_5: import("./configuration").CameraKitConfiguration): LensRepository;
+        (args_0: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget, args_1: import("./handlers").FetchHandler, args_2: import(".").LensSource[], args_3: import("./lens/assets/LensAssetRepository").LensAssetRepository): LensRepository;
         token: "LensRepository";
-        dependencies: readonly ["requestStateEventTarget", "cameraKitServiceFetchHandler", "defaultFetchHandler", "lensSources", "lensAssetRepository", "configuration"];
+        dependencies: readonly ["requestStateEventTarget", "defaultFetchHandler", "lensSources", "lensAssetRepository"];
     }, {
         (args_0: LensCore): import("./persistence/IndexedDBPersistence").IndexedDBPersistence<ArrayBuffer>;
         token: "lensPersistenceStore";
@@ -292,15 +300,15 @@ export declare const cameraKitFactory: {
         token: "operationalMetricsReporter";
         dependencies: readonly ["metricsHandler", "pageVisibility", "configuration"];
     }, {
-        (args_0: LensCore, args_1: import("./lens").AssetLoader, args_2: import("./lens").AssetLoader, args_3: import("./lens").AssetLoader, args_4: MetricsEventTarget, args_5: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget): import("./lens").LensAssetRepository;
+        (args_0: LensCore, args_1: import(".").AssetLoader, args_2: import(".").AssetLoader, args_3: import(".").AssetLoader, args_4: MetricsEventTarget, args_5: import("./handlers/requestStateEmittingHandler").RequestStateEventTarget): import("./lens/assets/LensAssetRepository").LensAssetRepository;
         token: "lensAssetRepository";
         dependencies: readonly ["lensCore", "deviceDependentAssetLoader", "remoteMediaAssetLoader", "staticAssetLoader", "metricsEventTarget", "requestStateEventTarget"];
     }, {
-        (args_0: import("./handlers").FetchHandler, args_1: import("./remote-configuration/remoteConfiguration").RemoteConfiguration): import("./lens").AssetLoader;
+        (args_0: import("./handlers").FetchHandler, args_1: import("./remote-configuration/remoteConfiguration").RemoteConfiguration): import(".").AssetLoader;
         token: "deviceDependentAssetLoader";
         dependencies: readonly ["defaultFetchHandler", "remoteConfiguration"];
     }, {
-        (args_0: import("./handlers").FetchHandler): import("./lens").AssetLoader;
+        (args_0: import("./handlers").FetchHandler): import(".").AssetLoader;
         token: "staticAssetLoader";
         dependencies: readonly ["defaultFetchHandler"];
     }, {

package/lib/__tests__/data.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="jest" />
-import { ContentProto } from "../lens";
+import { Content } from "../generated-proto/pb_schema/camera_kit/v3/lens";
 import { LensCoreModule, AssetType as LensCoreAssetType } from "../lens-core-module/generated-types";
 import { LensProtoWithGroupId } from "../lens/Lens";
 export declare const falsyValues: readonly [false, null, undefined, 0, ""];
@@ -7,7 +7,7 @@ export declare const truthyValues: readonly [true, 1, {}, Date, readonly []];
 export declare function createLensFixture({ name, groupId, content, }: {
     name: string;
     groupId?: string;
-    content?: Partial<ContentProto>;
+    content?: Partial<Content>;
 }): LensProtoWithGroupId;
 export type LensCoreMock = Pick<jest.Mocked<LensCoreModule>, "AssetType" | "CanvasType" | "ExternalMediaOrientation" | "InterfaceAction" | "InterfaceControl" | "RenderLoopMode" | "getOutputCanvases" | "initialize" | "provideExternalImage" | "provideExternalVideo" | "provideRemoteAssetsResponse" | "provideRemoteAssetsUploadResponse" | "provideUriResponse" | "registerSavePersistentStoreCallback" | "registerUriListener" | "setAllSoundsMuted" | "setClientInterfaceRequestHandler" | "setFPSLimit" | "setInputTransform" | "setOnFrameProcessedCallback" | "setPreloadedConfiguration" | "setRemoteAssetsProvider" | "setRemoteAssetsUploadHandler" | "setRenderLoopMode" | "setRenderSize" | "useMediaElement">;
 export declare const AssetType: Record<keyof LensCoreModule["AssetType"], LensCoreAssetType>;

package/lib/__tests__/data.js

@@ -1,5 +1,5 @@
 /* eslint-disable max-len */
-import { Lens_CameraFacing } from "../lens";
+import { Lens_CameraFacing } from "../generated-proto/pb_schema/camera_kit/v3/lens";
 export const falsyValues = [false, null, undefined, 0, ""];
 export const truthyValues = [true, 1, {}, new Date(), []];
 export function createLensFixture({ name, groupId = "test-group-id", content = {}, }) {
@@ -8,7 +8,7 @@ export function createLensFixture({ name, groupId = "test-group-id", content = {
         groupId,
         name,
         vendorData: {},
-        content: Object.assign({ iconUrlBolt: "https://bolt.com/iconUrl1", lnsSha256: "", lnsUrlBolt: "", preview: {
+        content: Object.assign({ lnsUrl: "", iconUrl: "", iconUrlBolt: "https://bolt.com/iconUrl1", lnsSha256: "", lnsUrlBolt: "", preview: {
                 imageUrl: "https://bolt.com/previewUrl1",
                 imageSequenceSize: 100,
                 imageSequenceWebpUrlPattern: "http://images.com/face-%d.com",

package/lib/__tests__/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/__tests__/data.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-len */\nimport { ContentProto, Lens_CameraFacing } from \"../lens\";\nimport { LensCoreModule, AssetType as LensCoreAssetType } from \"../lens-core-module/generated-types\";\nimport { LensProtoWithGroupId } from \"../lens/Lens\";\n\nexport const falsyValues = [false, null, undefined, 0, \"\"] as const;\nexport const truthyValues = [true, 1, {}, new Date(), []] as const;\n\nexport function createLensFixture({\n    name,\n    groupId = \"test-group-id\",\n    content = {},\n}: {\n    name: string;\n    groupId?: string;\n    content?: Partial<ContentProto>;\n}): LensProtoWithGroupId {\n    return {\n        id: name,\n        groupId,\n        name,\n        vendorData: {},\n        content: {\n            iconUrlBolt: \"https://bolt.com/iconUrl1\",\n            lnsSha256: \"\",\n            lnsUrlBolt: \"\",\n            preview: {\n                imageUrl: \"https://bolt.com/previewUrl1\",\n                imageSequenceSize: 100,\n                imageSequenceWebpUrlPattern: \"http://images.com/face-%d.com\",\n            },\n            assetManifest: [],\n            defaultHintId: \"\",\n            hintTranslations: {},\n            ...content,\n        },\n        scannable: {\n            snapcodeImageUrl: \"https://snapcodeImageUrl.com\",\n            snapcodeDeeplink: \"https://snapcodeDeeplink.com\",\n        },\n        isThirdParty: false,\n        cameraFacingPreference: Lens_CameraFacing.UNRECOGNIZED,\n        featureMetadata: [],\n        lensCreator: {\n            displayName: \"\",\n        },\n    };\n}\n\nexport type LensCoreMock = Pick<\n    jest.Mocked<LensCoreModule>,\n    | \"AssetType\"\n    | \"CanvasType\"\n    | \"ExternalMediaOrientation\"\n    | \"InterfaceAction\"\n    | \"InterfaceControl\"\n    | \"RenderLoopMode\"\n    | \"getOutputCanvases\"\n    | \"initialize\"\n    | \"provideExternalImage\"\n    | \"provideExternalVideo\"\n    | \"provideRemoteAssetsResponse\"\n    | \"provideRemoteAssetsUploadResponse\"\n    | \"provideUriResponse\"\n    | \"registerSavePersistentStoreCallback\"\n    | \"registerUriListener\"\n    | \"setAllSoundsMuted\"\n    | \"setClientInterfaceRequestHandler\"\n    | \"setFPSLimit\"\n    | \"setInputTransform\"\n    | \"setOnFrameProcessedCallback\"\n    | \"setPreloadedConfiguration\"\n    | \"setRemoteAssetsProvider\"\n    | \"setRemoteAssetsUploadHandler\"\n    | \"setRenderLoopMode\"\n    | \"setRenderSize\"\n    | \"useMediaElement\"\n>;\n\n// NOTE: type of the record ensures newly added asset types break compilation\nexport const AssetType: Record<keyof LensCoreModule[\"AssetType\"], LensCoreAssetType> = {\n    DeviceDependent: { value: 3 },\n    RemoteMediaByUrl: { value: 6 },\n    Static: { value: 1 },\n    URL: { value: 2 },\n    BitmojiDynamicAsset: { value: 4 },\n};\n\nexport function createLensCoreModule(): LensCoreMock {\n    return {\n        AssetType,\n        CanvasType: { Preview: { value: 1 }, Capture: { value: 2 }, None: { value: 0 }, All: { value: 3 } },\n        RenderLoopMode: { SetTimeout: { value: 1 }, RequestAnimationFrame: { value: 0 } },\n        // https://github.sc-corp.net/Snapchat/LensCore/blob/502b54b9a663203bcdf3b90c63214cdf8cc1e713/Src/CoreManager/ClientInterfaceDelegate.hpp#L39\n        InterfaceAction: { Show: { value: 3 } } as any,\n        // https://github.sc-corp.net/Snapchat/LensCore/blob/502b54b9a663203bcdf3b90c63214cdf8cc1e713/Src/CoreManager/ClientInterfaceDelegate.hpp#L21\n        InterfaceControl: { ImagePicker: { value: 1 } } as any,\n        // https://github.sc-corp.net/Snapchat/LensCore/blob/2d538ecc41f67dd2c199e0ff0eefd96aac6f22dc/Src/Common/IExternalMediaFilePickedObserver.h#L21\n        ExternalMediaOrientation: { CW0: { value: 0 }, CW90: { value: 1 }, CW180: { value: 2 }, CW270: { value: 3 } },\n        getOutputCanvases: jest.fn(),\n        initialize: jest.fn(),\n        provideExternalImage: jest.fn(),\n        provideExternalVideo: jest.fn(),\n        provideRemoteAssetsResponse: jest.fn(),\n        provideRemoteAssetsUploadResponse: jest.fn(),\n        provideUriResponse: jest.fn(),\n        registerSavePersistentStoreCallback: jest.fn(),\n        registerUriListener: jest.fn(),\n        setAllSoundsMuted: jest.fn(),\n        setClientInterfaceRequestHandler: jest.fn(),\n        setFPSLimit: jest.fn(),\n        setOnFrameProcessedCallback: jest.fn(),\n        setPreloadedConfiguration: jest.fn(),\n        setRemoteAssetsProvider: jest.fn(),\n        setRemoteAssetsUploadHandler: jest.fn(),\n        setRenderLoopMode: jest.fn(),\n        setRenderSize: jest.fn(),\n        useMediaElement: jest.fn(),\n        setInputTransform: jest.fn(),\n    };\n}\n"]}
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/__tests__/data.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable max-len */\nimport { Content, Lens_CameraFacing } from \"../generated-proto/pb_schema/camera_kit/v3/lens\";\nimport { LensCoreModule, AssetType as LensCoreAssetType } from \"../lens-core-module/generated-types\";\nimport { LensProtoWithGroupId } from \"../lens/Lens\";\n\nexport const falsyValues = [false, null, undefined, 0, \"\"] as const;\nexport const truthyValues = [true, 1, {}, new Date(), []] as const;\n\nexport function createLensFixture({\n    name,\n    groupId = \"test-group-id\",\n    content = {},\n}: {\n    name: string;\n    groupId?: string;\n    content?: Partial<Content>;\n}): LensProtoWithGroupId {\n    return {\n        id: name,\n        groupId,\n        name,\n        vendorData: {},\n        content: {\n            lnsUrl: \"\",\n            iconUrl: \"\",\n            iconUrlBolt: \"https://bolt.com/iconUrl1\",\n            lnsSha256: \"\",\n            lnsUrlBolt: \"\",\n            preview: {\n                imageUrl: \"https://bolt.com/previewUrl1\",\n                imageSequenceSize: 100,\n                imageSequenceWebpUrlPattern: \"http://images.com/face-%d.com\",\n            },\n            assetManifest: [],\n            defaultHintId: \"\",\n            hintTranslations: {},\n            ...content,\n        },\n        scannable: {\n            snapcodeImageUrl: \"https://snapcodeImageUrl.com\",\n            snapcodeDeeplink: \"https://snapcodeDeeplink.com\",\n        },\n        isThirdParty: false,\n        cameraFacingPreference: Lens_CameraFacing.UNRECOGNIZED,\n        featureMetadata: [],\n        lensCreator: {\n            displayName: \"\",\n        },\n    };\n}\n\nexport type LensCoreMock = Pick<\n    jest.Mocked<LensCoreModule>,\n    | \"AssetType\"\n    | \"CanvasType\"\n    | \"ExternalMediaOrientation\"\n    | \"InterfaceAction\"\n    | \"InterfaceControl\"\n    | \"RenderLoopMode\"\n    | \"getOutputCanvases\"\n    | \"initialize\"\n    | \"provideExternalImage\"\n    | \"provideExternalVideo\"\n    | \"provideRemoteAssetsResponse\"\n    | \"provideRemoteAssetsUploadResponse\"\n    | \"provideUriResponse\"\n    | \"registerSavePersistentStoreCallback\"\n    | \"registerUriListener\"\n    | \"setAllSoundsMuted\"\n    | \"setClientInterfaceRequestHandler\"\n    | \"setFPSLimit\"\n    | \"setInputTransform\"\n    | \"setOnFrameProcessedCallback\"\n    | \"setPreloadedConfiguration\"\n    | \"setRemoteAssetsProvider\"\n    | \"setRemoteAssetsUploadHandler\"\n    | \"setRenderLoopMode\"\n    | \"setRenderSize\"\n    | \"useMediaElement\"\n>;\n\n// NOTE: type of the record ensures newly added asset types break compilation\nexport const AssetType: Record<keyof LensCoreModule[\"AssetType\"], LensCoreAssetType> = {\n    DeviceDependent: { value: 3 },\n    RemoteMediaByUrl: { value: 6 },\n    Static: { value: 1 },\n    URL: { value: 2 },\n    BitmojiDynamicAsset: { value: 4 },\n};\n\nexport function createLensCoreModule(): LensCoreMock {\n    return {\n        AssetType,\n        CanvasType: { Preview: { value: 1 }, Capture: { value: 2 }, None: { value: 0 }, All: { value: 3 } },\n        RenderLoopMode: { SetTimeout: { value: 1 }, RequestAnimationFrame: { value: 0 } },\n        // https://github.sc-corp.net/Snapchat/LensCore/blob/502b54b9a663203bcdf3b90c63214cdf8cc1e713/Src/CoreManager/ClientInterfaceDelegate.hpp#L39\n        InterfaceAction: { Show: { value: 3 } } as any,\n        // https://github.sc-corp.net/Snapchat/LensCore/blob/502b54b9a663203bcdf3b90c63214cdf8cc1e713/Src/CoreManager/ClientInterfaceDelegate.hpp#L21\n        InterfaceControl: { ImagePicker: { value: 1 } } as any,\n        // https://github.sc-corp.net/Snapchat/LensCore/blob/2d538ecc41f67dd2c199e0ff0eefd96aac6f22dc/Src/Common/IExternalMediaFilePickedObserver.h#L21\n        ExternalMediaOrientation: { CW0: { value: 0 }, CW90: { value: 1 }, CW180: { value: 2 }, CW270: { value: 3 } },\n        getOutputCanvases: jest.fn(),\n        initialize: jest.fn(),\n        provideExternalImage: jest.fn(),\n        provideExternalVideo: jest.fn(),\n        provideRemoteAssetsResponse: jest.fn(),\n        provideRemoteAssetsUploadResponse: jest.fn(),\n        provideUriResponse: jest.fn(),\n        registerSavePersistentStoreCallback: jest.fn(),\n        registerUriListener: jest.fn(),\n        setAllSoundsMuted: jest.fn(),\n        setClientInterfaceRequestHandler: jest.fn(),\n        setFPSLimit: jest.fn(),\n        setOnFrameProcessedCallback: jest.fn(),\n        setPreloadedConfiguration: jest.fn(),\n        setRemoteAssetsProvider: jest.fn(),\n        setRemoteAssetsUploadHandler: jest.fn(),\n        setRenderLoopMode: jest.fn(),\n        setRenderSize: jest.fn(),\n        useMediaElement: jest.fn(),\n        setInputTransform: jest.fn(),\n    };\n}\n"]}

package/lib/bootstrapCameraKit.js

@@ -1,4 +1,6 @@
 import { __awaiter } from "tslib";
+import environment from "./environment.json";
+import lensCoreWasm from "./lensCoreWasmVersions.json";
 import { lensRepositoryFactory } from "./lens/LensRepository";
 import { Container } from "./dependency-injection/Container";
 import { cameraKitFactory } from "./CameraKit";
@@ -13,7 +15,6 @@ import { createCameraKitConfigurationFactory } from "./configuration";
 import { PartialContainer } from "./dependency-injection/PartialContainer";
 import { metricsHandlerFactory } from "./metrics/metricsHandler";
 import { operationalMetricReporterFactory } from "./metrics/operational/operationalMetricsReporter";
-import { lensSourcesFactory } from "./extensions/LensSources";
 import { uriHandlersFactory } from "./extensions/UriHandlers";
 import { assert } from "./common/assertions";
 import { isSafeString } from "./common/typeguards";
@@ -35,6 +36,10 @@ import { requestStateEventTargetFactory } from "./handlers/requestStateEmittingH
 import { pageVisibilityFactory } from "./common/pageVisibility";
 import { cofHandlerFactory } from "./remote-configuration/cofHandler";
 import { remoteApiServicesFactory } from "./extensions/RemoteApiServices";
+import { lensesClientFactory } from "./clients/lensesClient";
+import { gprcHandlerFactory } from "./clients/grpcHandler";
+import { lensSourcesFactory } from "./lens/LensSource";
+import { cameraKitLensSourceFactory } from "./lens/cameraKitLensSource";
 const logger = getLogger("bootstrapCameraKit");
 // The following errors are not wrapped with BootstrapError and bubble up as is.
 const nonWrappableErrors = [
@@ -42,7 +47,7 @@ const nonWrappableErrors = [
     "PlatformNotSupportedError",
 ];
 /**
- * Returns true if given error has to be wrapped with BoostrapError.
+ * Returns true if given error has to be wrapped with BootstrapError.
  */
 function shouldWrapError(error) {
     if (error instanceof Error) {
@@ -94,6 +99,7 @@ function shouldWrapError(error) {
  */
 export function bootstrapCameraKit(configuration, provide) {
     return __awaiter(this, void 0, void 0, function* () {
+        console.info(`Camera Kit SDK: ${environment.PACKAGE_VERSION} (${lensCoreWasm.version}/${lensCoreWasm.buildNumber})`);
         try {
             const startTimeMs = performance.now();
             assert(isSafeString(configuration.apiToken), configurationError("Invalid or unsafe apiToken provided."));
@@ -114,9 +120,11 @@ export function bootstrapCameraKit(configuration, provide) {
             // and we're not interested in errors thrown by their provide() function.
             // Below is the minimum required container to report errors to Blizzard.
             const telemetryContainer = Container.provides(publicContainer)
+                .provides(cameraKitServiceFetchHandlerFactory)
+                .provides(gprcHandlerFactory)
                 .provides(logEntriesFactory)
                 .run(registerLogEntriesSubscriber)
-                .provides(cameraKitServiceFetchHandlerFactory)
+                .provides(lensesClientFactory)
                 .provides(requestStateEventTargetFactory)
                 .provides(metricsEventTargetFactory)
                 .provides(metricsHandlerFactory)
@@ -145,6 +153,7 @@ export function bootstrapCameraKit(configuration, provide) {
             const lensCore = yield telemetryContainer.provides(lensCoreFactory).get(lensCoreFactory.token);
             const container = telemetryContainer
                 .provides(Injectable(lensCoreFactory.token, () => lensCore))
+                .provides(cameraKitLensSourceFactory)
                 .provides(lensPersistenceStoreFactory)
                 .provides(deviceDependentAssetLoaderFactory)
                 .provides(staticAssetLoaderFactory)

package/lib/bootstrapCameraKit.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrapCameraKit.js","sourceRoot":"","sources":["../src/bootstrapCameraKit.ts"],"names":[],"mappings":"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","sourcesContent":["import { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport { Container } from \"./dependency-injection/Container\";\nimport { CameraKit, cameraKitFactory } from \"./CameraKit\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { Injectable } from \"./dependency-injection/Injectable\";\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 { CameraKitBootstrapConfiguration, createCameraKitConfigurationFactory } from \"./configuration\";\nimport { PublicServices } from \"./dependency-injection/RootServices\";\nimport { PartialContainer } from \"./dependency-injection/PartialContainer\";\nimport { metricsHandlerFactory } from \"./metrics/metricsHandler\";\nimport { operationalMetricReporterFactory } from \"./metrics/operational/operationalMetricsReporter\";\nimport { lensSourcesFactory } from \"./extensions/LensSources\";\nimport { uriHandlersFactory } from \"./extensions/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 { bootstrapError, ConfigurationError, configurationError, PlatformNotSupportedError } 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 \"./extensions/RemoteApiServices\";\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 BoostrapError.\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    try {\n        const startTimeMs = performance.now();\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(pageVisibilityFactory)\n            .provides(defaultFetchHandlerFactory)\n            .provides(remoteMediaAssetLoaderFactory)\n            .provides(lensSourcesFactory)\n            .provides(remoteApiServicesFactory)\n            .provides(uriHandlersFactory);\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(logEntriesFactory)\n            .run(registerLogEntriesSubscriber)\n            .provides(cameraKitServiceFetchHandlerFactory)\n            .provides(requestStateEventTargetFactory)\n            .provides(metricsEventTargetFactory)\n            .provides(metricsHandlerFactory)\n            .provides(operationalMetricReporterFactory)\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(lensPersistenceStoreFactory)\n            .provides(deviceDependentAssetLoaderFactory)\n            .provides(staticAssetLoaderFactory)\n            .provides(lensAssetRepositoryFactory)\n            .provides(lensRepositoryFactory)\n\n            .provides(cameraKitFactory);\n        const cameraKit = container.get(cameraKitFactory.token);\n\n        const bootstrapTimeMs = performance.now() - startTimeMs;\n        const reporter = container.get(operationalMetricReporterFactory.token);\n        reporter.timer(\"bootstrap_time\", bootstrapTimeMs);\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 [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(myCustomeRemoteAssetLoader)\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"]}
+{"version":3,"file":"bootstrapCameraKit.js","sourceRoot":"","sources":["../src/bootstrapCameraKit.ts"],"names":[],"mappings":";AAAA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAC7C,OAAO,YAAY,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAa,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,6CAA6C,CAAC;AAC5F,OAAO,EAAE,iCAAiC,EAAE,MAAM,0CAA0C,CAAC;AAC7F,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,mCAAmC,EAAE,MAAM,gDAAgD,CAAC;AACrG,OAAO,EAAmC,mCAAmC,EAAE,MAAM,iBAAiB,CAAC;AAEvG,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,kDAAkD,CAAC;AACpG,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAsB,kBAAkB,EAA6B,MAAM,eAAe,CAAC;AAClH,OAAO,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,MAAM,MAAM,GAAG,SAAS,CAAC,oBAAoB,CAAC,CAAC;AAE/C,gFAAgF;AAChF,MAAM,kBAAkB,GAAoE;IACxF,oBAAoB;IACpB,2BAA2B;CAC9B,CAAC;AAEF;;GAEG;AACH,SAAS,eAAe,CAAC,KAAc;IACnC,IAAI,KAAK,YAAY,KAAK,EAAE;QACxB,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;KAClE;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAUD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,UAAgB,kBAAkB,CACpC,aAA8C,EAC9C,OAAiD;;QAEjD,OAAO,CAAC,IAAI,CACR,mBAAmB,WAAW,CAAC,eAAe,KAAK,YAAY,CAAC,OAAO,IAAI,YAAY,CAAC,WAAW,GAAG,CACzG,CAAC;QAEF,IAAI;YACA,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAEtC,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,sCAAsC,CAAC,CAAC,CAAC;YAEzG,MAAM,oBAAoB,GAAG,mCAAmC,CAAC,aAAa,CAAC,CAAC;YAEhF,mGAAmG;YACnG,MAAM,sBAAsB,GAAG,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CAAC;iBAClE,QAAQ,CAAC,qBAAqB,CAAC;iBAC/B,QAAQ,CAAC,0BAA0B,CAAC;iBACpC,QAAQ,CAAC,6BAA6B,CAAC;iBACvC,QAAQ,CAAC,kBAAkB,CAAC;iBAC5B,QAAQ,CAAC,wBAAwB,CAAC;iBAClC,QAAQ,CAAC,kBAAkB,CAAC,CAAC;YAElC,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC;YAE3F,kGAAkG;YAClG,+FAA+F;YAC/F,qGAAqG;YACrG,kFAAkF;YAClF,yEAAyE;YACzE,wEAAwE;YACxE,MAAM,kBAAkB,GAAG,SAAS,CAAC,QAAQ,CAAC,eAAe,CAAC;iBACzD,QAAQ,CAAC,mCAAmC,CAAC;iBAC7C,QAAQ,CAAC,kBAAkB,CAAC;iBAC5B,QAAQ,CAAC,iBAAiB,CAAC;iBAC3B,GAAG,CAAC,4BAA4B,CAAC;iBACjC,QAAQ,CAAC,mBAAmB,CAAC;iBAC7B,QAAQ,CAAC,8BAA8B,CAAC;iBACxC,QAAQ,CAAC,yBAAyB,CAAC;iBACnC,QAAQ,CAAC,qBAAqB,CAAC;iBAC/B,QAAQ,CAAC,gCAAgC,CAAC;iBAC1C,QAAQ,CAAC,qBAAqB,CAAC;iBAC/B,QAAQ,CAAC,iBAAiB,CAAC;iBAC3B,QAAQ,CAAC,0BAA0B,CAAC;iBACpC,QAAQ,CAAC,kBAAkB,CAAC;iBAC5B,QAAQ,CAAC,iBAAiB,CAAC;gBAC5B,wGAAwG;gBACxG,0GAA0G;gBAC1G,4GAA4G;gBAC5G,iCAAiC;iBAChC,GAAG,CAAC,2BAA2B,CAAC;iBAChC,GAAG,CAAC,6BAA6B,CAAC,CAAC;YAExC,4GAA4G;YAC5G,2GAA2G;YAC3G,2BAA2B;YAC3B,kBAAkB,CAAC,GAAG,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;YAEpD,yEAAyE;YAEzE,MAAM,uBAAuB,EAAE,CAAC;YAEhC,6EAA6E;YAC7E,wFAAwF;YACxF,+GAA+G;YAC/G,+FAA+F;YAC/F,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;YAE/F,MAAM,SAAS,GAAG,kBAAkB;iBAC/B,QAAQ,CAAC,UAAU,CAAC,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC;iBAC3D,QAAQ,CAAC,0BAA0B,CAAC;iBACpC,QAAQ,CAAC,2BAA2B,CAAC;iBACrC,QAAQ,CAAC,iCAAiC,CAAC;iBAC3C,QAAQ,CAAC,wBAAwB,CAAC;iBAClC,QAAQ,CAAC,0BAA0B,CAAC;iBACpC,QAAQ,CAAC,qBAAqB,CAAC;iBAC/B,QAAQ,CAAC,gBAAgB,CAAC,CAAC;YAEhC,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAExD,MAAM,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC;YACxD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,gCAAgC,CAAC,KAAK,CAAC,CAAC;YACvE,QAAQ,CAAC,KAAK,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;YAElD,OAAO,SAAS,CAAC;SACpB;QAAC,OAAO,KAAK,EAAE;YACZ,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE;gBACxB,KAAK,GAAG,cAAc,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;aACpF;YACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,KAAK,CAAC;SACf;IACL,CAAC;CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,IAAI,gBAAgB,CAAC,EAAE,CAAC,CAAC;AACpC,CAAC","sourcesContent":["import environment from \"./environment.json\";\nimport lensCoreWasm from \"./lensCoreWasmVersions.json\";\nimport { lensRepositoryFactory } from \"./lens/LensRepository\";\nimport { Container } from \"./dependency-injection/Container\";\nimport { CameraKit, cameraKitFactory } from \"./CameraKit\";\nimport { lensCoreFactory } from \"./lens-core-module/loader/lensCoreFactory\";\nimport { Injectable } from \"./dependency-injection/Injectable\";\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 { CameraKitBootstrapConfiguration, createCameraKitConfigurationFactory } from \"./configuration\";\nimport { PublicServices } from \"./dependency-injection/RootServices\";\nimport { PartialContainer } from \"./dependency-injection/PartialContainer\";\nimport { metricsHandlerFactory } from \"./metrics/metricsHandler\";\nimport { operationalMetricReporterFactory } from \"./metrics/operational/operationalMetricsReporter\";\nimport { uriHandlersFactory } from \"./extensions/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 { bootstrapError, ConfigurationError, configurationError, PlatformNotSupportedError } 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 \"./extensions/RemoteApiServices\";\nimport { lensesClientFactory } from \"./clients/lensesClient\";\nimport { gprcHandlerFactory } from \"./clients/grpcHandler\";\nimport { lensSourcesFactory } from \"./lens/LensSource\";\nimport { cameraKitLensSourceFactory } from \"./lens/cameraKitLensSource\";\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 startTimeMs = performance.now();\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(pageVisibilityFactory)\n            .provides(defaultFetchHandlerFactory)\n            .provides(remoteMediaAssetLoaderFactory)\n            .provides(lensSourcesFactory)\n            .provides(remoteApiServicesFactory)\n            .provides(uriHandlersFactory);\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(cameraKitServiceFetchHandlerFactory)\n            .provides(gprcHandlerFactory)\n            .provides(logEntriesFactory)\n            .run(registerLogEntriesSubscriber)\n            .provides(lensesClientFactory)\n            .provides(requestStateEventTargetFactory)\n            .provides(metricsEventTargetFactory)\n            .provides(metricsHandlerFactory)\n            .provides(operationalMetricReporterFactory)\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(cameraKitLensSourceFactory)\n            .provides(lensPersistenceStoreFactory)\n            .provides(deviceDependentAssetLoaderFactory)\n            .provides(staticAssetLoaderFactory)\n            .provides(lensAssetRepositoryFactory)\n            .provides(lensRepositoryFactory)\n            .provides(cameraKitFactory);\n\n        const cameraKit = container.get(cameraKitFactory.token);\n\n        const bootstrapTimeMs = performance.now() - startTimeMs;\n        const reporter = container.get(operationalMetricReporterFactory.token);\n        reporter.timer(\"bootstrap_time\", bootstrapTimeMs);\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 [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(myCustomeRemoteAssetLoader)\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/lib/clients/createTsProtoClient.d.ts

@@ -0,0 +1,47 @@
+import { grpc } from "@improbable-eng/grpc-web";
+import { Writer } from "protobufjs";
+import { Exact, DeepPartial } from "../generated-proto/pb_schema/camera_kit/v3/service";
+import { Result } from "../common/result";
+import { GrpcHandler } from "./grpcHandler";
+type TsProtoServiceDefinition<Methods extends TsProtoMethods> = {
+    name: string;
+    fullName: string;
+    methods: Methods;
+};
+type TsProtoMethods = {
+    [methodName: string]: TsProtoMethodDefinition<any, any>;
+};
+type TsProtoMethodDefinition<Request, Response> = {
+    name: string;
+    requestType: TsProtoMessage<Request>;
+    responseType: TsProtoMessage<Response>;
+};
+type TsProtoMessage<M> = {
+    encode: (message: M) => Writer;
+    decode: (message: Uint8Array) => M;
+    fromPartial: (partialMessage: any) => M;
+};
+export type GrpcServiceClient<S extends TsProtoServiceDefinition<any>> = {
+    [MethodName in keyof S["methods"]]: InferGrpcMethod<S["methods"][MethodName]>;
+};
+interface UnaryOutput<M> {
+    status: grpc.Code;
+    statusMessage: string;
+    headers: grpc.Metadata;
+    message: M | null;
+    trailers: grpc.Metadata;
+}
+type InferGrpcMethod<M extends TsProtoMethodDefinition<any, any>> = M extends TsProtoMethodDefinition<infer Request, infer Response> ? <I extends Exact<DeepPartial<Request>, I>>(request: I) => Promise<Result<UnaryOutput<Response & grpc.ProtobufMessage>, UnaryOutput<Response & grpc.ProtobufMessage>>> : never;
+/**
+ * Convert a service definition generated by ts-proto (using the `outputServices=generic-definitions` CLI option) into
+ * a working client.
+ *
+ * @param serviceDefinition
+ * @param handler
+ * @returns A client that can make requests to a remote service by sending Protobuf-encoded messages over HTTP using the
+ * grpc-web package.
+ *
+ * @internal
+ */
+export declare function createTsProtoClient<Methods extends TsProtoMethods, S extends TsProtoServiceDefinition<Methods>>(serviceDefinition: S, handler: GrpcHandler): GrpcServiceClient<S>;
+export {};

package/lib/clients/createTsProtoClient.js

@@ -0,0 +1,53 @@
+import { __awaiter } from "tslib";
+import { entries, fromEntries } from "../common/entries";
+function messageClass(message, data) {
+    return class Message {
+        constructor() {
+            Object.assign(this, message.fromPartial(data));
+        }
+        static deserializeBinary(data) {
+            const protobufMessage = new Message();
+            return Object.assign(Object.assign({}, protobufMessage), message.decode(data));
+        }
+        serializeBinary() {
+            return message.encode(this).finish();
+        }
+        toObject() {
+            return this;
+        }
+    };
+}
+/**
+ * Convert a service definition generated by ts-proto (using the `outputServices=generic-definitions` CLI option) into
+ * a working client.
+ *
+ * @param serviceDefinition
+ * @param handler
+ * @returns A client that can make requests to a remote service by sending Protobuf-encoded messages over HTTP using the
+ * grpc-web package.
+ *
+ * @internal
+ */
+export function createTsProtoClient(serviceDefinition, handler) {
+    return fromEntries(entries(serviceDefinition.methods).map(([methodName, methodDefinition]) => {
+        return [
+            methodName,
+            (request) => __awaiter(this, void 0, void 0, function* () {
+                const requestType = messageClass(methodDefinition.requestType, request);
+                const responseType = messageClass(methodDefinition.responseType, {});
+                return handler({
+                    serviceName: serviceDefinition.fullName,
+                    methodName: methodDefinition.name,
+                    requestType,
+                    responseType,
+                });
+            }),
+        ];
+        // Safety: We're mapping from the method definitions object into the GrpcServiceClient object in a manner
+        // that preserves each key in the method definitions object, pairing it with the corresponding
+        // serialization/deserialization logic for that particular method. But in doing this, we lose type
+        // specificity by converting the method definition object to a list of entries, mapping them, and then
+        // converting back into the client object -- so we're forced into this type cast.
+    }));
+}
+//# sourceMappingURL=createTsProtoClient.js.map