@snap/camera-kit 0.10.0 → 0.12.0

package/lib/lens/LensRepository.d.ts

@@ -4,6 +4,7 @@ import { RequestStateEventTarget } from "../handlers/requestStateEmittingHandler
 import { LensDownloadDimensions } from "../metrics/reporters/reportLensAndAssetDownload";
 import { Handler } from "../handlers/HandlerChainBuilder";
 import { LensAssetManifestItem_RequestTiming } from "../generated-proto/pb_schema/camera_kit/v3/lens";
+import { CameraKitApiHostname, CameraKitConfiguration } from "../configuration";
 import { Lens, LensProto } from "./Lens";
 import { LensAssetRepository } from "./assets/LensAssetRepository";
 type LensFetchHandler = Handler<[
@@ -56,10 +57,11 @@ export declare class LensRepository {
     private readonly lensFetchHandler;
     private readonly lensSources;
     private readonly lensAssetRepository;
+    private readonly apiHostname;
     private readonly metadataCache;
     private readonly binariesCache;
     /** @internal */
-    constructor(lensMetadataFetchHandler: FetchHandler, lensFetchHandler: LensFetchHandler, lensSources: LensSources, lensAssetRepository: LensAssetRepository);
+    constructor(lensMetadataFetchHandler: FetchHandler, lensFetchHandler: LensFetchHandler, lensSources: LensSources, lensAssetRepository: LensAssetRepository, apiHostname: CameraKitApiHostname);
     /**
      * Retrieve a single Lens.
      *
@@ -127,8 +129,8 @@ export declare class LensRepository {
  * @internal
  */
 export declare const lensRepositoryFactory: {
-    (args_0: RequestStateEventTarget, args_1: FetchHandler, args_2: FetchHandler, args_3: LensSources, args_4: LensAssetRepository): LensRepository;
+    (args_0: RequestStateEventTarget, args_1: FetchHandler, args_2: FetchHandler, args_3: LensSources, args_4: LensAssetRepository, args_5: CameraKitConfiguration): LensRepository;
     token: "LensRepository";
-    dependencies: readonly ["requestStateEventTarget", "cameraKitServiceFetchHandler", "defaultFetchHandler", "lensSources", "lensAssetRepository"];
+    dependencies: readonly ["requestStateEventTarget", "cameraKitServiceFetchHandler", "defaultFetchHandler", "lensSources", "lensAssetRepository", "configuration"];
 };
 export {};

package/lib/lens/LensRepository.js

@@ -11,6 +11,7 @@ import { createArrayBufferParsingHandler } from "../handlers/arrayBufferParsingH
 import { LensAssetManifestItem_RequestTiming } from "../generated-proto/pb_schema/camera_kit/v3/lens";
 import { getLogger } from "../logger/logger";
 import { errorLoggingDecorator } from "../logger/errorLoggingDecorator";
+import { configurationToken } from "../configuration";
 import { isLensArray, toPublicLens } from "./Lens";
 import { retrieveCameraKitLens, retrieveCameraKitLensGroup } from "./lensHttpUtil";
 import { decodeEnvelopes } from "./lensEnvelopeUtil";
@@ -46,11 +47,12 @@ function isOptionalAssetTimingArray(value) {
  */
 export class LensRepository {
     /** @internal */
-    constructor(lensMetadataFetchHandler, lensFetchHandler, lensSources, lensAssetRepository) {
+    constructor(lensMetadataFetchHandler, lensFetchHandler, lensSources, lensAssetRepository, apiHostname) {
         this.lensMetadataFetchHandler = lensMetadataFetchHandler;
         this.lensFetchHandler = lensFetchHandler;
         this.lensSources = lensSources;
         this.lensAssetRepository = lensAssetRepository;
+        this.apiHostname = apiHostname;
         this.metadataCache = new Map();
         this.binariesCache = new Map();
     }
@@ -72,7 +74,7 @@ export class LensRepository {
                 }
             }
             else {
-                lens = yield retrieveCameraKitLens(this.lensMetadataFetchHandler, lensId, groupId);
+                lens = yield retrieveCameraKitLens(this.lensMetadataFetchHandler, lensId, groupId, this.apiHostname);
             }
             this.metadataCache.set(lens.id, lens);
             return toPublicLens(lens);
@@ -97,7 +99,7 @@ export class LensRepository {
                     const envelopes = yield this.lensSources.retrieveLenses({ groupId });
                     const lenses = envelopes
                         ? decodeEnvelopes(envelopes)
-                        : yield retrieveCameraKitLensGroup(this.lensMetadataFetchHandler, groupId);
+                        : yield retrieveCameraKitLensGroup(this.lensMetadataFetchHandler, groupId, this.apiHostname);
                     lenses.forEach((lens) => this.metadataCache.set(lens.id, lens));
                     return lenses.map(toPublicLens);
                 }
@@ -231,10 +233,11 @@ export const lensRepositoryFactory = Injectable("LensRepository", [
     defaultFetchHandlerFactory.token,
     lensSourcesFactory.token,
     lensAssetRepositoryFactory.token,
-], (requestStateEventTarget, lensMetadataFetchHandler, defaultFetchHandler, lensSources, lensAssetRepository) => {
+    configurationToken,
+], (requestStateEventTarget, lensMetadataFetchHandler, defaultFetchHandler, lensSources, lensAssetRepository, configuration) => {
     const lensFetchHandler = new HandlerChainBuilder(defaultFetchHandler)
         .map(createRequestStateEmittingHandler(requestStateEventTarget))
         .map(createArrayBufferParsingHandler()).handler;
-    return new LensRepository(lensMetadataFetchHandler, lensFetchHandler, lensSources, lensAssetRepository);
+    return new LensRepository(lensMetadataFetchHandler, lensFetchHandler, lensSources, lensAssetRepository, configuration.apiHostname);
 });
 //# sourceMappingURL=LensRepository.js.map

package/lib/lens/LensRepository.js.map

@@ -1 +1 @@
-{"version":3,"file":"LensRepository.js","sourceRoot":"","sources":["../../src/lens/LensRepository.ts"],"names":[],"mappings":"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","sourcesContent":["import { guard, validate } from \"../common/validate\";\nimport { isArrayOfType, isSafeString, isSafeStringArray, isString, isUndefined } from \"../common/typeguards\";\nimport { Injectable } from \"../dependency-injection/Injectable\";\nimport { cameraKitServiceFetchHandlerFactory } from \"../handlers/cameraKitServiceFetchHandlerFactory\";\nimport { defaultFetchHandlerFactory, FetchHandler } from \"../handlers/defaultFetchHandler\";\nimport { LensSources, lensSourcesFactory } from \"../extensions/LensSources\";\nimport {\n    RequestStateEventTarget,\n    createRequestStateEmittingHandler,\n    requestStateEventTargetFactory,\n} from \"../handlers/requestStateEmittingHandler\";\nimport { LensDownloadDimensions } from \"../metrics/reporters/reportLensAndAssetDownload\";\nimport { Handler, HandlerChainBuilder } from \"../handlers/HandlerChainBuilder\";\nimport { createArrayBufferParsingHandler } from \"../handlers/arrayBufferParsingHandler\";\nimport { LensAssetManifestItem_RequestTiming } from \"../generated-proto/pb_schema/camera_kit/v3/lens\";\nimport { getLogger } from \"../logger/logger\";\nimport { errorLoggingDecorator } from \"../logger/errorLoggingDecorator\";\nimport { isLensArray, Lens, LensProto, toPublicLens } from \"./Lens\";\nimport { retrieveCameraKitLens, retrieveCameraKitLensGroup } from \"./lensHttpUtil\";\nimport { decodeEnvelopes } from \"./lensEnvelopeUtil\";\nimport { LensAssetRepository, lensAssetRepositoryFactory } from \"./assets/LensAssetRepository\";\n\nconst logger = getLogger(\"LensRepository\");\nconst log = errorLoggingDecorator(logger);\n\ntype LensFetchHandler = Handler<\n    [RequestInfo, LensDownloadDimensions],\n    [ArrayBuffer, Response],\n    RequestInit | undefined\n>;\n\nconst assetTimingMap = {\n    required: LensAssetManifestItem_RequestTiming.REQUIRED,\n    onDemand: LensAssetManifestItem_RequestTiming.ON_DEMAND,\n};\n\nfunction isAssetTiming(value: unknown): value is AssetTiming {\n    return isString(value) && assetTimingMap.hasOwnProperty(value);\n}\n\nfunction isOptionalAssetTimingArray(value: unknown): value is undefined | AssetTiming[] {\n    return isUndefined(value) || isArrayOfType(isAssetTiming, value);\n}\n\n/**\n * Lens assets are included in a manifest, and each will indicate when that asset will be used by the lens.\n *\n * Assets can have the following timing values:\n * - `required`: the lens will definitely request this asset immediately when the lens is applied.\n * - `onDemand`: the lens may request this asset at some time while the lens is applied.\n *\n * Depending on the use-case, an application may want to cache both required and onDemand assets for\n * a particular lens, or may decide to only cache required assets (or cache no assets).\n *\n * @category Lenses\n */\nexport type AssetTiming = keyof typeof assetTimingMap;\n\nexport interface LensBinary {\n    lensBuffer: ArrayBuffer;\n    lensChecksum: string;\n}\n\n/**\n * The LensRepository is used to query for lenses from specific lens groups, or for a lens with a specific ID.\n *\n * Lens groups are configured in the CameraKit Portal -- that's where you'll find lens group IDs and lens IDs.\n *\n * Lenses must be loaded by the LensRepository before they can be applied to a {@link CameraKitSession}.\n *\n * @example\n * ```ts\n * const cameraKit = await bootstrapCameraKit(options)\n * const session = await cameraKit.createSession()\n * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)\n * session.applyLens(lens)\n * ```\n *\n * @category Lenses\n */\nexport class LensRepository {\n    private readonly metadataCache = new Map<string, LensProto>();\n    private readonly binariesCache = new Map<string, ArrayBuffer>();\n\n    /** @internal */\n    constructor(\n        private readonly lensMetadataFetchHandler: FetchHandler,\n        private readonly lensFetchHandler: LensFetchHandler,\n        private readonly lensSources: LensSources,\n        private readonly lensAssetRepository: LensAssetRepository\n    ) {}\n\n    /**\n     * Retrieve a single Lens.\n     *\n     * @param lensId Desired Lens's unique ID. Can be found in the CameraKit Portal.\n     * @param groupId The ID of a group containing the desired Lens. Can be found in the CameraKit Portal.\n     * @returns Resolves with the desired Lens, or rejects if an error occurred (including a missing Lens).\n     */\n    @validate\n    @log\n    async loadLens(@guard(isSafeString) lensId: string, @guard(isSafeString) groupId: string): Promise<Lens> {\n        const envelopes = await this.lensSources.retrieveLenses({ lensId, groupId });\n        let lens: LensProto;\n        if (envelopes) {\n            lens = decodeEnvelopes(envelopes)[0];\n            if (!lens) {\n                throw new Error(\"Expected non-empty envelope.\");\n            }\n        } else {\n            lens = await retrieveCameraKitLens(this.lensMetadataFetchHandler, lensId, groupId);\n        }\n        this.metadataCache.set(lens.id, lens);\n        return toPublicLens(lens);\n    }\n\n    /**\n     * Retrieve the Lenses contained in a list of Lens Groups.\n     *\n     * This may result in multiple requests to retrieve Lens data (e.g. one per desired group). If any constituent\n     * requests fail, those errors will be reported in the response – but the returned Promise will not be rejected. Any\n     * Lenses which could be successfully retrieved will be available in the response.\n     *\n     * @param groupIds A list of Lens Group IDs. Can be found in the CameraKit Portal.\n     * @returns Resolves with a flattened list of all lenses in the desired groups. If any errors occurred during the\n     * query operation, these will be included in a separate list. If errors are present, the list of Lenses may not\n     * contain all the Lenses from the desired groups.\n     */\n    @validate\n    @log\n    async loadLensGroups(@guard(isSafeStringArray) groupIds: string[]): Promise<{\n        errors: Error[];\n        lenses: Lens[];\n    }> {\n        const responses = await Promise.all(\n            groupIds.map(async (groupId) => {\n                try {\n                    const envelopes = await this.lensSources.retrieveLenses({ groupId });\n                    const lenses = envelopes\n                        ? decodeEnvelopes(envelopes)\n                        : await retrieveCameraKitLensGroup(this.lensMetadataFetchHandler, groupId);\n                    lenses.forEach((lens) => this.metadataCache.set(lens.id, lens));\n                    return lenses.map(toPublicLens);\n                } catch (error) {\n                    logger.error(new Error(`Failed to load lens group ${groupId}.`, { cause: error }));\n                    return error as Error;\n                }\n            })\n        );\n\n        const errors: Error[] = [];\n        const lenses: Lens[] = [];\n        responses.forEach((response) => (Array.isArray(response) ? lenses.push(...response) : errors.push(response)));\n        return { errors, lenses };\n    }\n\n    /**\n     * Loads and caches lens content and dependencies to reduce latency when {@link CameraKitSession.applyLens} is later\n     * called to apply the lens. This is an in-memory cache, it will not be persisted across page loads.\n     *\n     * This may useful if the application A) knows which lenses will be applied and B) has some opportunity to call\n     * this method before a lens is applied. For example, if the user must perform some other actions before lenses\n     * become active, this might be a good opportunity to cache lenses to improve applyLens latency.\n     *\n     * @example\n     * ```ts\n     * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)\n     * await cameraKit.lensRepository.cacheLensContent([lens])\n     *\n     * // sometime later -- this call will use the cached lens content, making lens application faster.\n     * await cameraKitSession.applyLens(lens)\n     * ```\n     *\n     * @param lenses Array of lenses to cache in memory.\n     * @param assetTimingsToCache Lenses specify certain required assets that are necessary for the lens to render, and\n     * other assets which may be needed by the lens. By default this method will cache all of those assets, but this\n     * behavior can be modified to only load the required assets, only the \"onDemand\" assets, or neither (by passing\n     * an empty array).\n     */\n    @validate\n    @log\n    async cacheLensContent(\n        @guard(isLensArray) lenses: Lens[],\n        @guard(isOptionalAssetTimingArray) assetTimingsToCache: AssetTiming[] = [\"required\", \"onDemand\"]\n    ) {\n        const assetTimingsToLoad = assetTimingsToCache.map((timing) => assetTimingMap[timing]);\n        await Promise.all(\n            lenses.map(async (lens) => {\n                try {\n                    const { lensBuffer } = await this.getLensContent(lens);\n                    // Safety: getLensContent() call above ensures metadata to exist\n                    const { content } = this.metadataCache.get(lens.id)!;\n                    this.binariesCache.set(lens.id, lensBuffer);\n                    await this.lensAssetRepository.cacheAssets(content!.assetManifest, lens, assetTimingsToLoad);\n                } catch (e) {\n                    logger.warn(new Error(`Failed to cache lens ${lens.id}.`, { cause: e }));\n                }\n            })\n        );\n    }\n\n    /**\n     * Returns loaded Lens metadata if available.\n     */\n    getLensMetadata(lensId: string): LensProto | undefined {\n        return this.metadataCache.get(lensId);\n    }\n\n    /**\n     * Removes Lens content from the in-memory cache.\n     */\n    removeCachedLenses(lenses: Lens[]) {\n        lenses.forEach((lens) => this.binariesCache.delete(lens.id));\n    }\n\n    /**\n     * Fetches lens content and assets. This may come from the cache, otherwise network requests will be made.\n     *\n     * @internal\n     */\n    async getLensContent(lens: Lens): Promise<LensBinary> {\n        const { content } = this.metadataCache.get(lens.id) ?? {};\n        if (!content) {\n            throw new Error(`Cannot find metadata for lens ${lens.id}.`);\n        }\n\n        const cachedLensBuffer = this.binariesCache.get(lens.id);\n        if (cachedLensBuffer) {\n            return {\n                lensBuffer: cachedLensBuffer,\n                lensChecksum: content.lnsSha256,\n            };\n        }\n\n        // Load required lens assets and the lens itself in parallel. We count both toward lens download time.\n        const [lensBuffer] = await this.lensFetchHandler([\n            // TODO: remove force-cache once https://jira.sc-corp.net/browse/CAMKIT-3671 is addressed\n            new Request(content.lnsUrlBolt, { cache: \"force-cache\" }),\n            {\n                requestType: \"lens_content\",\n                lensId: lens.id,\n            },\n        ]);\n        return { lensBuffer, lensChecksum: content.lnsSha256 };\n    }\n}\n\n/**\n * @internal\n */\nexport const lensRepositoryFactory = Injectable(\n    \"LensRepository\",\n    [\n        requestStateEventTargetFactory.token,\n        cameraKitServiceFetchHandlerFactory.token,\n        defaultFetchHandlerFactory.token,\n        lensSourcesFactory.token,\n        lensAssetRepositoryFactory.token,\n    ] as const,\n    (\n        requestStateEventTarget: RequestStateEventTarget,\n        lensMetadataFetchHandler: FetchHandler,\n        defaultFetchHandler: FetchHandler,\n        lensSources: LensSources,\n        lensAssetRepository: LensAssetRepository\n    ) => {\n        const lensFetchHandler = new HandlerChainBuilder(defaultFetchHandler)\n            .map(createRequestStateEmittingHandler<LensDownloadDimensions>(requestStateEventTarget))\n            .map(createArrayBufferParsingHandler()).handler;\n        return new LensRepository(lensMetadataFetchHandler, lensFetchHandler, lensSources, lensAssetRepository);\n    }\n);\n"]}
+{"version":3,"file":"LensRepository.js","sourceRoot":"","sources":["../../src/lens/LensRepository.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7G,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,mCAAmC,EAAE,MAAM,iDAAiD,CAAC;AACtG,OAAO,EAAE,0BAA0B,EAAgB,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAe,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,EAEH,iCAAiC,EACjC,8BAA8B,GACjC,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAW,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,+BAA+B,EAAE,MAAM,uCAAuC,CAAC;AACxF,OAAO,EAAE,mCAAmC,EAAE,MAAM,iDAAiD,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAAgD,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,WAAW,EAAmB,YAAY,EAAE,MAAM,QAAQ,CAAC;AACpE,OAAO,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAuB,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/F,MAAM,MAAM,GAAG,SAAS,CAAC,gBAAgB,CAAC,CAAC;AAC3C,MAAM,GAAG,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAQ1C,MAAM,cAAc,GAAG;IACnB,QAAQ,EAAE,mCAAmC,CAAC,QAAQ;IACtD,QAAQ,EAAE,mCAAmC,CAAC,SAAS;CAC1D,CAAC;AAEF,SAAS,aAAa,CAAC,KAAc;IACjC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,cAAc,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAC9C,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AACrE,CAAC;AAqBD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IAIvB,gBAAgB;IAChB,YACqB,wBAAsC,EACtC,gBAAkC,EAClC,WAAwB,EACxB,mBAAwC,EACxC,WAAiC;QAJjC,6BAAwB,GAAxB,wBAAwB,CAAc;QACtC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,gBAAW,GAAX,WAAW,CAAa;QACxB,wBAAmB,GAAnB,mBAAmB,CAAqB;QACxC,gBAAW,GAAX,WAAW,CAAsB;QATrC,kBAAa,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC7C,kBAAa,GAAG,IAAI,GAAG,EAAuB,CAAC;IAS7D,CAAC;IAEJ;;;;;;OAMG;IAGG,QAAQ,CAAsB,MAAc,EAAuB,OAAe;;YACpF,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7E,IAAI,IAAe,CAAC;YACpB,IAAI,SAAS,EAAE;gBACX,IAAI,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,IAAI,EAAE;oBACP,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;iBACnD;aACJ;iBAAM;gBACH,IAAI,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,wBAAwB,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;aACxG;YACD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACtC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;KAAA;IAED;;;;;;;;;;;OAWG;IAGG,cAAc,CAA2B,QAAkB;;YAI7D,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAC/B,QAAQ,CAAC,GAAG,CAAC,CAAO,OAAO,EAAE,EAAE;gBAC3B,IAAI;oBACA,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;oBACrE,MAAM,MAAM,GAAG,SAAS;wBACpB,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC;wBAC5B,CAAC,CAAC,MAAM,0BAA0B,CAAC,IAAI,CAAC,wBAAwB,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;oBACjG,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;oBAChE,OAAO,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;iBACnC;gBAAC,OAAO,KAAK,EAAE;oBACZ,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,6BAA6B,OAAO,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;oBACnF,OAAO,KAAc,CAAC;iBACzB;YACL,CAAC,CAAA,CAAC,CACL,CAAC;YAEF,MAAM,MAAM,GAAY,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAW,EAAE,CAAC;YAC1B,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9G,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC9B,CAAC;KAAA;IAED;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAGG,gBAAgB,CACE,MAAc,EACC,sBAAqC,CAAC,UAAU,EAAE,UAAU,CAAC;;YAEhG,MAAM,kBAAkB,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;YACvF,MAAM,OAAO,CAAC,GAAG,CACb,MAAM,CAAC,GAAG,CAAC,CAAO,IAAI,EAAE,EAAE;gBACtB,IAAI;oBACA,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;oBACvD,gEAAgE;oBAChE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC;oBACrD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;oBAC5C,MAAM,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,OAAQ,CAAC,aAAa,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;iBAChG;gBAAC,OAAO,CAAC,EAAE;oBACR,MAAM,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;iBAC5E;YACL,CAAC,CAAA,CAAC,CACL,CAAC;QACN,CAAC;KAAA;IAED;;OAEG;IACH,eAAe,CAAC,MAAc;QAC1B,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAC,MAAc;QAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,CAAC;IAED;;;;OAIG;IACG,cAAc,CAAC,IAAU;;;YAC3B,MAAM,EAAE,OAAO,EAAE,GAAG,MAAA,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,mCAAI,EAAE,CAAC;YAC1D,IAAI,CAAC,OAAO,EAAE;gBACV,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;aAChE;YAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzD,IAAI,gBAAgB,EAAE;gBAClB,OAAO;oBACH,UAAU,EAAE,gBAAgB;oBAC5B,YAAY,EAAE,OAAO,CAAC,SAAS;iBAClC,CAAC;aACL;YAED,sGAAsG;YACtG,MAAM,CAAC,UAAU,CAAC,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC;gBAC7C,yFAAyF;gBACzF,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;gBACzD;oBACI,WAAW,EAAE,cAAc;oBAC3B,MAAM,EAAE,IAAI,CAAC,EAAE;iBAClB;aACJ,CAAC,CAAC;YACH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;;KAC1D;CACJ;AAhJS;IAFL,QAAQ;IACR,GAAG;IACY,WAAA,KAAK,CAAC,YAAY,CAAC,CAAA;IAAkB,WAAA,KAAK,CAAC,YAAY,CAAC,CAAA;;;;8CAavE;AAgBK;IAFL,QAAQ;IACR,GAAG;IACkB,WAAA,KAAK,CAAC,iBAAiB,CAAC,CAAA;;;;oDAwB7C;AA2BK;IAFL,QAAQ;IACR,GAAG;IAEC,WAAA,KAAK,CAAC,WAAW,CAAC,CAAA;IAClB,WAAA,KAAK,CAAC,0BAA0B,CAAC,CAAA;;;;sDAgBrC;AAgDL;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAC3C,gBAAgB,EAChB;IACI,8BAA8B,CAAC,KAAK;IACpC,mCAAmC,CAAC,KAAK;IACzC,0BAA0B,CAAC,KAAK;IAChC,kBAAkB,CAAC,KAAK;IACxB,0BAA0B,CAAC,KAAK;IAChC,kBAAkB;CACZ,EACV,CACI,uBAAgD,EAChD,wBAAsC,EACtC,mBAAiC,EACjC,WAAwB,EACxB,mBAAwC,EACxC,aAAqC,EACvC,EAAE;IACA,MAAM,gBAAgB,GAAG,IAAI,mBAAmB,CAAC,mBAAmB,CAAC;SAChE,GAAG,CAAC,iCAAiC,CAAyB,uBAAuB,CAAC,CAAC;SACvF,GAAG,CAAC,+BAA+B,EAAE,CAAC,CAAC,OAAO,CAAC;IACpD,OAAO,IAAI,cAAc,CACrB,wBAAwB,EACxB,gBAAgB,EAChB,WAAW,EACX,mBAAmB,EACnB,aAAa,CAAC,WAAW,CAC5B,CAAC;AACN,CAAC,CACJ,CAAC","sourcesContent":["import { guard, validate } from \"../common/validate\";\nimport { isArrayOfType, isSafeString, isSafeStringArray, isString, isUndefined } from \"../common/typeguards\";\nimport { Injectable } from \"../dependency-injection/Injectable\";\nimport { cameraKitServiceFetchHandlerFactory } from \"../handlers/cameraKitServiceFetchHandlerFactory\";\nimport { defaultFetchHandlerFactory, FetchHandler } from \"../handlers/defaultFetchHandler\";\nimport { LensSources, lensSourcesFactory } from \"../extensions/LensSources\";\nimport {\n    RequestStateEventTarget,\n    createRequestStateEmittingHandler,\n    requestStateEventTargetFactory,\n} from \"../handlers/requestStateEmittingHandler\";\nimport { LensDownloadDimensions } from \"../metrics/reporters/reportLensAndAssetDownload\";\nimport { Handler, HandlerChainBuilder } from \"../handlers/HandlerChainBuilder\";\nimport { createArrayBufferParsingHandler } from \"../handlers/arrayBufferParsingHandler\";\nimport { LensAssetManifestItem_RequestTiming } from \"../generated-proto/pb_schema/camera_kit/v3/lens\";\nimport { getLogger } from \"../logger/logger\";\nimport { errorLoggingDecorator } from \"../logger/errorLoggingDecorator\";\nimport { CameraKitApiHostname, CameraKitConfiguration, configurationToken } from \"../configuration\";\nimport { isLensArray, Lens, LensProto, toPublicLens } from \"./Lens\";\nimport { retrieveCameraKitLens, retrieveCameraKitLensGroup } from \"./lensHttpUtil\";\nimport { decodeEnvelopes } from \"./lensEnvelopeUtil\";\nimport { LensAssetRepository, lensAssetRepositoryFactory } from \"./assets/LensAssetRepository\";\n\nconst logger = getLogger(\"LensRepository\");\nconst log = errorLoggingDecorator(logger);\n\ntype LensFetchHandler = Handler<\n    [RequestInfo, LensDownloadDimensions],\n    [ArrayBuffer, Response],\n    RequestInit | undefined\n>;\n\nconst assetTimingMap = {\n    required: LensAssetManifestItem_RequestTiming.REQUIRED,\n    onDemand: LensAssetManifestItem_RequestTiming.ON_DEMAND,\n};\n\nfunction isAssetTiming(value: unknown): value is AssetTiming {\n    return isString(value) && assetTimingMap.hasOwnProperty(value);\n}\n\nfunction isOptionalAssetTimingArray(value: unknown): value is undefined | AssetTiming[] {\n    return isUndefined(value) || isArrayOfType(isAssetTiming, value);\n}\n\n/**\n * Lens assets are included in a manifest, and each will indicate when that asset will be used by the lens.\n *\n * Assets can have the following timing values:\n * - `required`: the lens will definitely request this asset immediately when the lens is applied.\n * - `onDemand`: the lens may request this asset at some time while the lens is applied.\n *\n * Depending on the use-case, an application may want to cache both required and onDemand assets for\n * a particular lens, or may decide to only cache required assets (or cache no assets).\n *\n * @category Lenses\n */\nexport type AssetTiming = keyof typeof assetTimingMap;\n\nexport interface LensBinary {\n    lensBuffer: ArrayBuffer;\n    lensChecksum: string;\n}\n\n/**\n * The LensRepository is used to query for lenses from specific lens groups, or for a lens with a specific ID.\n *\n * Lens groups are configured in the CameraKit Portal -- that's where you'll find lens group IDs and lens IDs.\n *\n * Lenses must be loaded by the LensRepository before they can be applied to a {@link CameraKitSession}.\n *\n * @example\n * ```ts\n * const cameraKit = await bootstrapCameraKit(options)\n * const session = await cameraKit.createSession()\n * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)\n * session.applyLens(lens)\n * ```\n *\n * @category Lenses\n */\nexport class LensRepository {\n    private readonly metadataCache = new Map<string, LensProto>();\n    private readonly binariesCache = new Map<string, ArrayBuffer>();\n\n    /** @internal */\n    constructor(\n        private readonly lensMetadataFetchHandler: FetchHandler,\n        private readonly lensFetchHandler: LensFetchHandler,\n        private readonly lensSources: LensSources,\n        private readonly lensAssetRepository: LensAssetRepository,\n        private readonly apiHostname: CameraKitApiHostname\n    ) {}\n\n    /**\n     * Retrieve a single Lens.\n     *\n     * @param lensId Desired Lens's unique ID. Can be found in the CameraKit Portal.\n     * @param groupId The ID of a group containing the desired Lens. Can be found in the CameraKit Portal.\n     * @returns Resolves with the desired Lens, or rejects if an error occurred (including a missing Lens).\n     */\n    @validate\n    @log\n    async loadLens(@guard(isSafeString) lensId: string, @guard(isSafeString) groupId: string): Promise<Lens> {\n        const envelopes = await this.lensSources.retrieveLenses({ lensId, groupId });\n        let lens: LensProto;\n        if (envelopes) {\n            lens = decodeEnvelopes(envelopes)[0];\n            if (!lens) {\n                throw new Error(\"Expected non-empty envelope.\");\n            }\n        } else {\n            lens = await retrieveCameraKitLens(this.lensMetadataFetchHandler, lensId, groupId, this.apiHostname);\n        }\n        this.metadataCache.set(lens.id, lens);\n        return toPublicLens(lens);\n    }\n\n    /**\n     * Retrieve the Lenses contained in a list of Lens Groups.\n     *\n     * This may result in multiple requests to retrieve Lens data (e.g. one per desired group). If any constituent\n     * requests fail, those errors will be reported in the response – but the returned Promise will not be rejected. Any\n     * Lenses which could be successfully retrieved will be available in the response.\n     *\n     * @param groupIds A list of Lens Group IDs. Can be found in the CameraKit Portal.\n     * @returns Resolves with a flattened list of all lenses in the desired groups. If any errors occurred during the\n     * query operation, these will be included in a separate list. If errors are present, the list of Lenses may not\n     * contain all the Lenses from the desired groups.\n     */\n    @validate\n    @log\n    async loadLensGroups(@guard(isSafeStringArray) groupIds: string[]): Promise<{\n        errors: Error[];\n        lenses: Lens[];\n    }> {\n        const responses = await Promise.all(\n            groupIds.map(async (groupId) => {\n                try {\n                    const envelopes = await this.lensSources.retrieveLenses({ groupId });\n                    const lenses = envelopes\n                        ? decodeEnvelopes(envelopes)\n                        : await retrieveCameraKitLensGroup(this.lensMetadataFetchHandler, groupId, this.apiHostname);\n                    lenses.forEach((lens) => this.metadataCache.set(lens.id, lens));\n                    return lenses.map(toPublicLens);\n                } catch (error) {\n                    logger.error(new Error(`Failed to load lens group ${groupId}.`, { cause: error }));\n                    return error as Error;\n                }\n            })\n        );\n\n        const errors: Error[] = [];\n        const lenses: Lens[] = [];\n        responses.forEach((response) => (Array.isArray(response) ? lenses.push(...response) : errors.push(response)));\n        return { errors, lenses };\n    }\n\n    /**\n     * Loads and caches lens content and dependencies to reduce latency when {@link CameraKitSession.applyLens} is later\n     * called to apply the lens. This is an in-memory cache, it will not be persisted across page loads.\n     *\n     * This may useful if the application A) knows which lenses will be applied and B) has some opportunity to call\n     * this method before a lens is applied. For example, if the user must perform some other actions before lenses\n     * become active, this might be a good opportunity to cache lenses to improve applyLens latency.\n     *\n     * @example\n     * ```ts\n     * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)\n     * await cameraKit.lensRepository.cacheLensContent([lens])\n     *\n     * // sometime later -- this call will use the cached lens content, making lens application faster.\n     * await cameraKitSession.applyLens(lens)\n     * ```\n     *\n     * @param lenses Array of lenses to cache in memory.\n     * @param assetTimingsToCache Lenses specify certain required assets that are necessary for the lens to render, and\n     * other assets which may be needed by the lens. By default this method will cache all of those assets, but this\n     * behavior can be modified to only load the required assets, only the \"onDemand\" assets, or neither (by passing\n     * an empty array).\n     */\n    @validate\n    @log\n    async cacheLensContent(\n        @guard(isLensArray) lenses: Lens[],\n        @guard(isOptionalAssetTimingArray) assetTimingsToCache: AssetTiming[] = [\"required\", \"onDemand\"]\n    ) {\n        const assetTimingsToLoad = assetTimingsToCache.map((timing) => assetTimingMap[timing]);\n        await Promise.all(\n            lenses.map(async (lens) => {\n                try {\n                    const { lensBuffer } = await this.getLensContent(lens);\n                    // Safety: getLensContent() call above ensures metadata to exist\n                    const { content } = this.metadataCache.get(lens.id)!;\n                    this.binariesCache.set(lens.id, lensBuffer);\n                    await this.lensAssetRepository.cacheAssets(content!.assetManifest, lens, assetTimingsToLoad);\n                } catch (e) {\n                    logger.warn(new Error(`Failed to cache lens ${lens.id}.`, { cause: e }));\n                }\n            })\n        );\n    }\n\n    /**\n     * Returns loaded Lens metadata if available.\n     */\n    getLensMetadata(lensId: string): LensProto | undefined {\n        return this.metadataCache.get(lensId);\n    }\n\n    /**\n     * Removes Lens content from the in-memory cache.\n     */\n    removeCachedLenses(lenses: Lens[]) {\n        lenses.forEach((lens) => this.binariesCache.delete(lens.id));\n    }\n\n    /**\n     * Fetches lens content and assets. This may come from the cache, otherwise network requests will be made.\n     *\n     * @internal\n     */\n    async getLensContent(lens: Lens): Promise<LensBinary> {\n        const { content } = this.metadataCache.get(lens.id) ?? {};\n        if (!content) {\n            throw new Error(`Cannot find metadata for lens ${lens.id}.`);\n        }\n\n        const cachedLensBuffer = this.binariesCache.get(lens.id);\n        if (cachedLensBuffer) {\n            return {\n                lensBuffer: cachedLensBuffer,\n                lensChecksum: content.lnsSha256,\n            };\n        }\n\n        // Load required lens assets and the lens itself in parallel. We count both toward lens download time.\n        const [lensBuffer] = await this.lensFetchHandler([\n            // TODO: remove force-cache once https://jira.sc-corp.net/browse/CAMKIT-3671 is addressed\n            new Request(content.lnsUrlBolt, { cache: \"force-cache\" }),\n            {\n                requestType: \"lens_content\",\n                lensId: lens.id,\n            },\n        ]);\n        return { lensBuffer, lensChecksum: content.lnsSha256 };\n    }\n}\n\n/**\n * @internal\n */\nexport const lensRepositoryFactory = Injectable(\n    \"LensRepository\",\n    [\n        requestStateEventTargetFactory.token,\n        cameraKitServiceFetchHandlerFactory.token,\n        defaultFetchHandlerFactory.token,\n        lensSourcesFactory.token,\n        lensAssetRepositoryFactory.token,\n        configurationToken,\n    ] as const,\n    (\n        requestStateEventTarget: RequestStateEventTarget,\n        lensMetadataFetchHandler: FetchHandler,\n        defaultFetchHandler: FetchHandler,\n        lensSources: LensSources,\n        lensAssetRepository: LensAssetRepository,\n        configuration: CameraKitConfiguration\n    ) => {\n        const lensFetchHandler = new HandlerChainBuilder(defaultFetchHandler)\n            .map(createRequestStateEmittingHandler<LensDownloadDimensions>(requestStateEventTarget))\n            .map(createArrayBufferParsingHandler()).handler;\n        return new LensRepository(\n            lensMetadataFetchHandler,\n            lensFetchHandler,\n            lensSources,\n            lensAssetRepository,\n            configuration.apiHostname\n        );\n    }\n);\n"]}

package/lib/lens/assets/LensAssetsProvider.js

@@ -7,6 +7,7 @@ import { toPublicLens } from "../Lens";
 import { lensRepositoryFactory } from "../LensRepository";
 import { lensAssetRepositoryFactory } from "./LensAssetRepository";
 const logger = getLogger("LensAssetProvider");
+const maxConsecutiveErrors = 3;
 /**
  * Registers a remote asset provider function with a given instance of LensCore.
  *
@@ -16,15 +17,20 @@ const logger = getLogger("LensAssetProvider");
  * @internal
  */
 export const registerLensAssetsProvider = Injectable("registerLensAssetsProvider", [lensCoreFactory.token, lensRepositoryFactory.token, lensAssetRepositoryFactory.token], (lensCore, lensRepository, lensAssetRepository) => {
+    const consecutiveErrorsPerAsset = new Map();
     lensCore.setRemoteAssetsProvider((assetDescriptor) => __awaiter(void 0, void 0, void 0, function* () {
-        var _a;
+        var _a, _b, _c;
         // Fetch an asset and provide it to LensCore. If fetching the asset fails we give LensCore
         // an empty response (which it may handle in a variety of ways, e.g. retry, gracefully
         // degrade lens behavior, throw error) and then reject.
         const { assetId, assetType, effectId } = assetDescriptor;
         try {
+            if (((_a = consecutiveErrorsPerAsset.get(assetId)) !== null && _a !== void 0 ? _a : 0) > maxConsecutiveErrors) {
+                throw new Error(`Maximum consecutive asset load errors reached for asset ${assetId}`);
+            }
             const lens = effectId ? lensRepository.getLensMetadata(effectId) : undefined;
-            yield lensAssetRepository.loadAsset(assetDescriptor, lens && toPublicLens(lens), (_a = lens === null || lens === void 0 ? void 0 : lens.content) === null || _a === void 0 ? void 0 : _a.assetManifest);
+            yield lensAssetRepository.loadAsset(assetDescriptor, lens && toPublicLens(lens), (_b = lens === null || lens === void 0 ? void 0 : lens.content) === null || _b === void 0 ? void 0 : _b.assetManifest);
+            consecutiveErrorsPerAsset.set(assetId, 0);
         }
         catch (error) {
             // if an error occurs, LensCore handles things in different ways
@@ -34,7 +40,16 @@ export const registerLensAssetsProvider = Injectable("registerLensAssetsProvider
                 assetId,
                 assetType,
             });
-            logger.error(lensAssetError(`Error occurred while handling lens asset ${assetId} request.`, error));
+            const consecutiveErrors = ((_c = consecutiveErrorsPerAsset.get(assetId)) !== null && _c !== void 0 ? _c : 0) + 1;
+            consecutiveErrorsPerAsset.set(assetId, consecutiveErrors);
+            // We've already reported `maxConsecutiveErrors` number of errors for this asset, so we can skip
+            // logging additional errors.
+            if (consecutiveErrors <= maxConsecutiveErrors) {
+                logger.error(lensAssetError(`Error occurred while handling lens asset ${assetId} request.`, error));
+            }
+            else {
+                logger.warn(`Maximum consecutive asset load errors reached for asset ${assetId}`);
+            }
         }
     }));
 });

package/lib/lens/assets/LensAssetsProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LensAssetsProvider.js","sourceRoot":"","sources":["../../../src/lens/assets/LensAssetsProvider.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAkB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAkB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAuB,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExF,MAAM,MAAM,GAAG,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAO9C;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAChD,4BAA4B,EAC5B,CAAC,eAAe,CAAC,KAAK,EAAE,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAU,EAC/F,CAAC,QAAwB,EAAE,cAA8B,EAAE,mBAAwC,EAAE,EAAE;IACnG,QAAQ,CAAC,uBAAuB,CAAC,CAAO,eAAe,EAAE,EAAE;;QACvD,0FAA0F;QAC1F,sFAAsF;QACtF,uDAAuD;QACvD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;QACzD,IAAI;YACA,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,MAAM,mBAAmB,CAAC,SAAS,CAC/B,eAAe,EACf,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,EAC1B,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,0CAAE,aAAa,CAC/B,CAAC;SACL;QAAC,OAAO,KAAK,EAAE;YACZ,gEAAgE;YAChE,yFAAyF;YACzF,kGAAkG;YAClG,QAAQ,CAAC,2BAA2B,CAAC;gBACjC,OAAO;gBACP,SAAS;aACZ,CAAC,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,4CAA4C,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;SACvG;IACL,CAAC,CAAA,CAAC,CAAC;AACP,CAAC,CACJ,CAAC","sourcesContent":["import { Injectable } from \"../../dependency-injection/Injectable\";\nimport { lensAssetError } from \"../../namedErrors\";\nimport { lensCoreFactory, LensCoreModule } from \"../../lens-core-module\";\nimport { getLogger } from \"../../logger/logger\";\nimport { MakeTaggedBusinessEvent } from \"../../metrics/businessEventsReporter\";\nimport { toPublicLens } from \"../Lens\";\nimport { LensRepository, lensRepositoryFactory } from \"../LensRepository\";\nimport { LensAssetRepository, lensAssetRepositoryFactory } from \"./LensAssetRepository\";\n\nconst logger = getLogger(\"LensAssetProvider\");\n\n/**\n * The AssetValidationFailed metric reports every time we handle an asset checksum validation failure.\n */\nexport type AssetValidationFailed = MakeTaggedBusinessEvent<\"assetValidationFailed\">;\n\n/**\n * Registers a remote asset provider function with a given instance of LensCore.\n *\n * *Note:* LensCoreModule.initialize must be called on the desired LensCoreModule instance **prior** to passing it\n * to the LensAssetsProvider constructor. If this class is instantiated with a LensCoreModule that has not been\n * initialized, the registry of the asset provider function will fail silently and no remote assets will be loaded.\n * @internal\n */\nexport const registerLensAssetsProvider = Injectable(\n    \"registerLensAssetsProvider\",\n    [lensCoreFactory.token, lensRepositoryFactory.token, lensAssetRepositoryFactory.token] as const,\n    (lensCore: LensCoreModule, lensRepository: LensRepository, lensAssetRepository: LensAssetRepository) => {\n        lensCore.setRemoteAssetsProvider(async (assetDescriptor) => {\n            // Fetch an asset and provide it to LensCore. If fetching the asset fails we give LensCore\n            // an empty response (which it may handle in a variety of ways, e.g. retry, gracefully\n            // degrade lens behavior, throw error) and then reject.\n            const { assetId, assetType, effectId } = assetDescriptor;\n            try {\n                const lens = effectId ? lensRepository.getLensMetadata(effectId) : undefined;\n                await lensAssetRepository.loadAsset(\n                    assetDescriptor,\n                    lens && toPublicLens(lens),\n                    lens?.content?.assetManifest\n                );\n            } catch (error) {\n                // if an error occurs, LensCore handles things in different ways\n                // depending on the active lens. It might: 1) retry, 2) gracefully degrade lens behavior,\n                // 3) lens JS might throw, which will be passed to the exceptionHandler we register with LensCore.\n                lensCore.provideRemoteAssetsResponse({\n                    assetId,\n                    assetType,\n                });\n                logger.error(lensAssetError(`Error occurred while handling lens asset ${assetId} request.`, error));\n            }\n        });\n    }\n);\n"]}
+{"version":3,"file":"LensAssetsProvider.js","sourceRoot":"","sources":["../../../src/lens/assets/LensAssetsProvider.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAkB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAkB,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAuB,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAExF,MAAM,MAAM,GAAG,SAAS,CAAC,mBAAmB,CAAC,CAAC;AAC9C,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAO/B;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,UAAU,CAChD,4BAA4B,EAC5B,CAAC,eAAe,CAAC,KAAK,EAAE,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,CAAC,KAAK,CAAU,EAC/F,CAAC,QAAwB,EAAE,cAA8B,EAAE,mBAAwC,EAAE,EAAE;IACnG,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5D,QAAQ,CAAC,uBAAuB,CAAC,CAAO,eAAe,EAAE,EAAE;;QACvD,0FAA0F;QAC1F,sFAAsF;QACtF,uDAAuD;QACvD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC;QAEzD,IAAI;YACA,IAAI,CAAC,MAAA,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,mCAAI,CAAC,CAAC,GAAG,oBAAoB,EAAE;gBACtE,MAAM,IAAI,KAAK,CAAC,2DAA2D,OAAO,EAAE,CAAC,CAAC;aACzF;YAED,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC7E,MAAM,mBAAmB,CAAC,SAAS,CAC/B,eAAe,EACf,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,EAC1B,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,OAAO,0CAAE,aAAa,CAC/B,CAAC;YACF,yBAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;SAC7C;QAAC,OAAO,KAAK,EAAE;YACZ,gEAAgE;YAChE,yFAAyF;YACzF,kGAAkG;YAClG,QAAQ,CAAC,2BAA2B,CAAC;gBACjC,OAAO;gBACP,SAAS;aACZ,CAAC,CAAC;YAEH,MAAM,iBAAiB,GAAG,CAAC,MAAA,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,mCAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC5E,yBAAyB,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;YAE1D,gGAAgG;YAChG,6BAA6B;YAC7B,IAAI,iBAAiB,IAAI,oBAAoB,EAAE;gBAC3C,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,4CAA4C,OAAO,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;aACvG;iBAAM;gBACH,MAAM,CAAC,IAAI,CAAC,2DAA2D,OAAO,EAAE,CAAC,CAAC;aACrF;SACJ;IACL,CAAC,CAAA,CAAC,CAAC;AACP,CAAC,CACJ,CAAC","sourcesContent":["import { Injectable } from \"../../dependency-injection/Injectable\";\nimport { lensAssetError } from \"../../namedErrors\";\nimport { lensCoreFactory, LensCoreModule } from \"../../lens-core-module\";\nimport { getLogger } from \"../../logger/logger\";\nimport { MakeTaggedBusinessEvent } from \"../../metrics/businessEventsReporter\";\nimport { toPublicLens } from \"../Lens\";\nimport { LensRepository, lensRepositoryFactory } from \"../LensRepository\";\nimport { LensAssetRepository, lensAssetRepositoryFactory } from \"./LensAssetRepository\";\n\nconst logger = getLogger(\"LensAssetProvider\");\nconst maxConsecutiveErrors = 3;\n\n/**\n * The AssetValidationFailed metric reports every time we handle an asset checksum validation failure.\n */\nexport type AssetValidationFailed = MakeTaggedBusinessEvent<\"assetValidationFailed\">;\n\n/**\n * Registers a remote asset provider function with a given instance of LensCore.\n *\n * *Note:* LensCoreModule.initialize must be called on the desired LensCoreModule instance **prior** to passing it\n * to the LensAssetsProvider constructor. If this class is instantiated with a LensCoreModule that has not been\n * initialized, the registry of the asset provider function will fail silently and no remote assets will be loaded.\n * @internal\n */\nexport const registerLensAssetsProvider = Injectable(\n    \"registerLensAssetsProvider\",\n    [lensCoreFactory.token, lensRepositoryFactory.token, lensAssetRepositoryFactory.token] as const,\n    (lensCore: LensCoreModule, lensRepository: LensRepository, lensAssetRepository: LensAssetRepository) => {\n        const consecutiveErrorsPerAsset = new Map<string, number>();\n\n        lensCore.setRemoteAssetsProvider(async (assetDescriptor) => {\n            // Fetch an asset and provide it to LensCore. If fetching the asset fails we give LensCore\n            // an empty response (which it may handle in a variety of ways, e.g. retry, gracefully\n            // degrade lens behavior, throw error) and then reject.\n            const { assetId, assetType, effectId } = assetDescriptor;\n\n            try {\n                if ((consecutiveErrorsPerAsset.get(assetId) ?? 0) > maxConsecutiveErrors) {\n                    throw new Error(`Maximum consecutive asset load errors reached for asset ${assetId}`);\n                }\n\n                const lens = effectId ? lensRepository.getLensMetadata(effectId) : undefined;\n                await lensAssetRepository.loadAsset(\n                    assetDescriptor,\n                    lens && toPublicLens(lens),\n                    lens?.content?.assetManifest\n                );\n                consecutiveErrorsPerAsset.set(assetId, 0);\n            } catch (error) {\n                // if an error occurs, LensCore handles things in different ways\n                // depending on the active lens. It might: 1) retry, 2) gracefully degrade lens behavior,\n                // 3) lens JS might throw, which will be passed to the exceptionHandler we register with LensCore.\n                lensCore.provideRemoteAssetsResponse({\n                    assetId,\n                    assetType,\n                });\n\n                const consecutiveErrors = (consecutiveErrorsPerAsset.get(assetId) ?? 0) + 1;\n                consecutiveErrorsPerAsset.set(assetId, consecutiveErrors);\n\n                // We've already reported `maxConsecutiveErrors` number of errors for this asset, so we can skip\n                // logging additional errors.\n                if (consecutiveErrors <= maxConsecutiveErrors) {\n                    logger.error(lensAssetError(`Error occurred while handling lens asset ${assetId} request.`, error));\n                } else {\n                    logger.warn(`Maximum consecutive asset load errors reached for asset ${assetId}`);\n                }\n            }\n        });\n    }\n);\n"]}

package/lib/lens/lensHttpUtil.d.ts

@@ -1,4 +1,5 @@
+import { CameraKitApiHostname } from "../configuration";
 import { FetchHandler } from "../handlers/defaultFetchHandler";
 import { LensProto } from "./Lens";
-export declare function retrieveCameraKitLens(httpClient: FetchHandler, lensId: string, groupId: string): Promise<LensProto>;
-export declare function retrieveCameraKitLensGroup(httpClient: FetchHandler, groupId: string): Promise<LensProto[]>;
+export declare function retrieveCameraKitLens(httpClient: FetchHandler, lensId: string, groupId: string, apiHostname: CameraKitApiHostname): Promise<LensProto>;
+export declare function retrieveCameraKitLensGroup(httpClient: FetchHandler, groupId: string, apiHostname: CameraKitApiHostname): Promise<LensProto[]>;

package/lib/lens/lensHttpUtil.js

@@ -1,12 +1,12 @@
 import { __awaiter } from "tslib";
 import { isGetGroupResponse, isLensProto } from "./Lens";
-const BASE_PATH = "https://api-kit.snapchat.com/com.snap.camerakit.v3.Lenses";
+const relativePath = "/com.snap.camerakit.v3.Lenses";
 function getRequestId(res) {
     return res.headers.get("x-request-id");
 }
-export function retrieveCameraKitLens(httpClient, lensId, groupId) {
+export function retrieveCameraKitLens(httpClient, lensId, groupId, apiHostname) {
     return __awaiter(this, void 0, void 0, function* () {
-        const url = [BASE_PATH, "groups", groupId, "lenses", lensId].join("/");
+        const url = `https://${apiHostname}${relativePath}/groups/${groupId}/lenses/${lensId}`;
         const response = yield httpClient(url, { credentials: "include" });
         const body = yield response.json();
         const lens = body.lens;
@@ -16,9 +16,9 @@ export function retrieveCameraKitLens(httpClient, lensId, groupId) {
         return lens;
     });
 }
-export function retrieveCameraKitLensGroup(httpClient, groupId) {
+export function retrieveCameraKitLensGroup(httpClient, groupId, apiHostname) {
     return __awaiter(this, void 0, void 0, function* () {
-        const url = [BASE_PATH, "groups", groupId].join("/");
+        const url = `https://${apiHostname}${relativePath}/groups/${groupId}`;
         const response = yield httpClient(url, { credentials: "include" });
         const body = yield response.json();
         if (!isGetGroupResponse(body)) {

package/lib/lens/lensHttpUtil.js.map

@@ -1 +1 @@
-{"version":3,"file":"lensHttpUtil.js","sourceRoot":"","sources":["../../src/lens/lensHttpUtil.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAa,MAAM,QAAQ,CAAC;AAEpE,MAAM,SAAS,GAAG,2DAA2D,CAAC;AAE9E,SAAS,YAAY,CAAC,GAAa;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAgB,qBAAqB,CACvC,UAAwB,EACxB,MAAc,EACd,OAAe;;QAEf,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;YACpB,MAAM,IAAI,KAAK,CACX,uBAAuB,GAAG,8BAA8B,IAAI,CAAC,SAAS,CAClE,IAAI,CACP,wBAAwB,YAAY,CAAC,QAAQ,CAAC,GAAG,CACrD,CAAC;SACL;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CAAA;AAED,MAAM,UAAgB,0BAA0B,CAAC,UAAwB,EAAE,OAAe;;QACtF,MAAM,GAAG,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CACX,uBAAuB,GAAG,mCAAmC,IAAI,CAAC,SAAS,CACvE,IAAI,CACP,wBAAwB,YAAY,CAAC,QAAQ,CAAC,GAAG,CACrD,CAAC;SACL;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CAAA","sourcesContent":["import { FetchHandler } from \"../handlers/defaultFetchHandler\";\nimport { isGetGroupResponse, isLensProto, LensProto } from \"./Lens\";\n\nconst BASE_PATH = \"https://api-kit.snapchat.com/com.snap.camerakit.v3.Lenses\";\n\nfunction getRequestId(res: Response) {\n    return res.headers.get(\"x-request-id\");\n}\n\nexport async function retrieveCameraKitLens(\n    httpClient: FetchHandler,\n    lensId: string,\n    groupId: string\n): Promise<LensProto> {\n    const url = [BASE_PATH, \"groups\", groupId, \"lenses\", lensId].join(\"/\");\n    const response = await httpClient(url, { credentials: \"include\" });\n    const body = await response.json();\n    const lens = body.lens;\n    if (!isLensProto(lens)) {\n        throw new Error(\n            `Expected request to ${url} to return a Lens. Got:\\n\\n${JSON.stringify(\n                body\n            )} with request-id of \"${getRequestId(response)}\"`\n        );\n    }\n    return lens;\n}\n\nexport async function retrieveCameraKitLensGroup(httpClient: FetchHandler, groupId: string): Promise<LensProto[]> {\n    const url = [BASE_PATH, \"groups\", groupId].join(\"/\");\n    const response = await httpClient(url, { credentials: \"include\" });\n    const body = await response.json();\n    if (!isGetGroupResponse(body)) {\n        throw new Error(\n            `Expected request to ${url} to return a LensGroup. Got:\\n\\n${JSON.stringify(\n                body\n            )} with request-id of \"${getRequestId(response)}\"`\n        );\n    }\n    return body.lenses;\n}\n"]}
+{"version":3,"file":"lensHttpUtil.js","sourceRoot":"","sources":["../../src/lens/lensHttpUtil.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAa,MAAM,QAAQ,CAAC;AAEpE,MAAM,YAAY,GAAG,+BAA+B,CAAC;AAErD,SAAS,YAAY,CAAC,GAAa;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAgB,qBAAqB,CACvC,UAAwB,EACxB,MAAc,EACd,OAAe,EACf,WAAiC;;QAEjC,MAAM,GAAG,GAAG,WAAW,WAAW,GAAG,YAAY,WAAW,OAAO,WAAW,MAAM,EAAE,CAAC;QACvF,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;YACpB,MAAM,IAAI,KAAK,CACX,uBAAuB,GAAG,8BAA8B,IAAI,CAAC,SAAS,CAClE,IAAI,CACP,wBAAwB,YAAY,CAAC,QAAQ,CAAC,GAAG,CACrD,CAAC;SACL;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CAAA;AAED,MAAM,UAAgB,0BAA0B,CAC5C,UAAwB,EACxB,OAAe,EACf,WAAiC;;QAEjC,MAAM,GAAG,GAAG,WAAW,WAAW,GAAG,YAAY,WAAW,OAAO,EAAE,CAAC;QACtE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE;YAC3B,MAAM,IAAI,KAAK,CACX,uBAAuB,GAAG,mCAAmC,IAAI,CAAC,SAAS,CACvE,IAAI,CACP,wBAAwB,YAAY,CAAC,QAAQ,CAAC,GAAG,CACrD,CAAC;SACL;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CAAA","sourcesContent":["import { CameraKitApiHostname } from \"../configuration\";\nimport { FetchHandler } from \"../handlers/defaultFetchHandler\";\nimport { isGetGroupResponse, isLensProto, LensProto } from \"./Lens\";\n\nconst relativePath = \"/com.snap.camerakit.v3.Lenses\";\n\nfunction getRequestId(res: Response) {\n    return res.headers.get(\"x-request-id\");\n}\n\nexport async function retrieveCameraKitLens(\n    httpClient: FetchHandler,\n    lensId: string,\n    groupId: string,\n    apiHostname: CameraKitApiHostname\n): Promise<LensProto> {\n    const url = `https://${apiHostname}${relativePath}/groups/${groupId}/lenses/${lensId}`;\n    const response = await httpClient(url, { credentials: \"include\" });\n    const body = await response.json();\n    const lens = body.lens;\n    if (!isLensProto(lens)) {\n        throw new Error(\n            `Expected request to ${url} to return a Lens. Got:\\n\\n${JSON.stringify(\n                body\n            )} with request-id of \"${getRequestId(response)}\"`\n        );\n    }\n    return lens;\n}\n\nexport async function retrieveCameraKitLensGroup(\n    httpClient: FetchHandler,\n    groupId: string,\n    apiHostname: CameraKitApiHostname\n): Promise<LensProto[]> {\n    const url = `https://${apiHostname}${relativePath}/groups/${groupId}`;\n    const response = await httpClient(url, { credentials: \"include\" });\n    const body = await response.json();\n    if (!isGetGroupResponse(body)) {\n        throw new Error(\n            `Expected request to ${url} to return a LensGroup. Got:\\n\\n${JSON.stringify(\n                body\n            )} with request-id of \"${getRequestId(response)}\"`\n        );\n    }\n    return body.lenses;\n}\n"]}

package/lib/lens-core-module/generated-types.d.ts

@@ -7,6 +7,7 @@ export type LensCoreEnumValue = {
 export type GetOutputCanvasesOutput = Record<number, HTMLCanvasElement>;
 export type SetRenderSizeInput = SetRenderSizeMatchInputResolutionInput | SetRenderSizeExplicitInput;
 export type SetRemoteAssetsProviderInput = (assetDescriptor: AssetDescriptor) => void;
+export type SetRemoteAssetsUploadHandlerInput = (assetUploadDescriptor: AssetUploadDescriptor) => void;
 export type ContentType = "text/plain" | "text/html" | "application/json" | "application/octet-stream" | "application/x-protobuf" | "application/grpc";
 export type SavePersistentStoreCallback = (id: string, data: ArrayBuffer) => void;
 export type ShowHintCallback = (effectId: string, hintId: string) => void;
@@ -128,6 +129,7 @@ export interface UriRequest {
     method: "GET" | "POST";
     contentType: ContentType;
     data: ArrayBuffer;
+    metadata: Record<string, string>;
 }
 export interface UriResponse {
     code: number;
@@ -172,6 +174,17 @@ export interface AssetDescriptor {
     assetType: AssetType;
     avatarId?: string;
     effectId?: string;
+    encryptionKey?: string;
+}
+export interface AssetUploadDescriptor {
+    requestId: number;
+    assetId: string;
+    assetType: AssetType;
+    effectId: string;
+    assetBuffer: ArrayBuffer;
+    encryptionKey?: string;
+    encryptionIv?: string;
+    assetBatchId?: string;
 }
 export interface ProvideRemoteAssetsResponseInput {
     assetId: string;
@@ -180,6 +193,12 @@ export interface ProvideRemoteAssetsResponseInput {
     assetChecksum?: string;
     onFailure?: DefaultErrorHandler;
 }
+export interface ProvideRemoteAssetsUploadResponseInput {
+    requestId: number;
+    success: boolean;
+    assetUrl?: string;
+    assetUploadMetadata?: ArrayBuffer;
+}
 export interface ProcessFrameInput {
     inputFrame: ImageBitmap | HTMLCanvasElement | HTMLImageElement | VideoFrame;
     timestampMillis: number;
@@ -402,6 +421,8 @@ export interface LensCoreModule extends InitialEmscriptenModule {
     provideUriResponse: (requestId: string, response: UriResponse) => void;
     setRemoteAssetsProvider: (provider: SetRemoteAssetsProviderInput) => void;
     provideRemoteAssetsResponse: (assetResponse: ProvideRemoteAssetsResponseInput) => void;
+    setRemoteAssetsUploadHandler: (provider: SetRemoteAssetsUploadHandlerInput) => void;
+    provideRemoteAssetsUploadResponse: (assetResponse: ProvideRemoteAssetsUploadResponseInput) => void;
     registerShowHintCallback: (callback: ShowHintCallback) => void;
     registerHideHintCallback: (callback: HideHintCallback) => void;
     registerSavePersistentStoreCallback: (callback: SavePersistentStoreCallback) => void;

package/lib/lens-core-module/generated-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"generated-types.js","sourceRoot":"","sources":["../../src/lens-core-module/generated-types.ts"],"names":[],"mappings":"","sourcesContent":["export type DefaultEventHandler = (...data: any[]) => void;\n\nexport type DefaultErrorHandler = (err: LensCoreError) => void;\n\nexport type LensCoreEnumValue = { value: number };\n\nexport type GetOutputCanvasesOutput = Record<number, HTMLCanvasElement>;\n\nexport type SetRenderSizeInput = SetRenderSizeMatchInputResolutionInput | SetRenderSizeExplicitInput;\n\nexport type SetRemoteAssetsProviderInput = (assetDescriptor: AssetDescriptor) => void;\n\nexport type ContentType =\n    | \"text/plain\"\n    | \"text/html\"\n    | \"application/json\"\n    | \"application/octet-stream\"\n    | \"application/x-protobuf\"\n    | \"application/grpc\";\n\nexport type SavePersistentStoreCallback = (id: string, data: ArrayBuffer) => void;\n\nexport type ShowHintCallback = (effectId: string, hintId: string) => void;\n\nexport type HideHintCallback = (effectId: string) => void;\n\nexport type ReceiveInstanceCallback = (instance: WebAssembly.Instance, module: WebAssembly.Module) => void;\n\nexport type AssetType = LensCoreEnumValue;\n\nexport type CanvasType = LensCoreEnumValue;\n\nexport type RenderLoopMode = LensCoreEnumValue;\n\nexport type LensApiVisibility = LensCoreEnumValue;\n\nexport type DeviceClass = LensCoreEnumValue;\n\nexport type UserDataAccess = LensCoreEnumValue;\n\nexport type InterfaceControl = LensCoreEnumValue;\n\nexport type InterfaceAction = LensCoreEnumValue;\n\nexport type ExternalMediaOrientation = LensCoreEnumValue;\n\nexport type ErrorType = LensCoreEnumValue;\n\nexport type Uri = `${string}://${string}`;\n\nexport type Dimensions = { width: number; height: number };\n\nexport type Size2D = { width: number; height: number };\n\nexport type Vec2D = { x: number; y: number };\n\nexport type Rect = { origin: Vec2D; size: Size2D };\n\nexport interface ClearAllLensesInput {\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface OnFrameProcessedParam {\n    processingTimeMs: number;\n}\n\nexport interface InitializeInput {\n    canvas?: HTMLCanvasElement | string;\n    outputResolution?: Dimensions;\n    showFpsPanel?: boolean;\n    shouldUseWorker?: boolean;\n    onFrameProcessed?: (arg: OnFrameProcessedParam) => void;\n    onFailure?: DefaultErrorHandler;\n    onSuccess?: DefaultEventHandler;\n    exceptionHandler?: (error: LensCoreError) => void;\n}\n\nexport interface PlayCanvasInput {\n    type: CanvasType;\n    onReady?: () => void;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface PauseCanvasInput {\n    type: CanvasType;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetFpsLimitInput {\n    fps: number;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetInputTransformInput {\n    matrix: Float32Array | ArrayBuffer;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetOnFrameProcessedInput {\n    onFrameProcessed: (arg: OnFrameProcessedParam) => void;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetRenderSizeMatchInputResolutionInput {\n    mode: \"matchInputResolution\";\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetRenderSizeExplicitInput {\n    mode: \"explicit\";\n    target: Dimensions;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetRenderLoopInput {\n    mode: RenderLoopMode;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface TeardownInput {\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultEventHandler;\n}\n\nexport interface ReplayTrackingDataInput {\n    buffer: Uint8Array | ArrayBuffer;\n}\n\nexport interface UseMediaElementInput {\n    media?: HTMLCanvasElement | HTMLImageElement | HTMLVideoElement | MediaStream;\n    requestWebcam?: boolean;\n    startOnFrontCamera?: boolean;\n    mirrorMedia?: boolean;\n    pauseExistingMedia?: boolean;\n    autoplayNewMedia?: boolean;\n    autoplayPreviewCanvas?: boolean;\n    useManualFrameProcessing?: boolean;\n    replayTrackingData?: ReplayTrackingDataInput;\n    onFailure?: DefaultErrorHandler;\n    onSuccess?: DefaultEventHandler;\n}\n\nexport interface UriListener {\n    handleRequest: (request: UriRequest) => void;\n    cancelRequest?: (request: UriCancelRequest) => void;\n}\n\nexport interface UriRequest {\n    uri: Uri;\n    identifier: string;\n    method: \"GET\" | \"POST\";\n    contentType: ContentType;\n    data: ArrayBuffer;\n}\n\nexport interface UriResponse {\n    code: number;\n    description: string;\n    contentType: ContentType;\n    data: ArrayBuffer;\n    metadata?: Record<string, string>;\n}\n\nexport interface UriCancelRequest {\n    uri: Uri;\n    requestId: string;\n}\n\nexport interface LensDescriptor {\n    lensId: string;\n    lensChecksum: string;\n    lensPath?: string;\n    lensDataBuffer?: Uint8Array | ArrayBuffer;\n    onTurnOn?: DefaultEventHandler;\n    onTurnOff?: DefaultEventHandler;\n    onFirstFrameProcessed?: DefaultEventHandler;\n    onResourcesLoaded?: DefaultEventHandler;\n    launchData?: Uint8Array | ArrayBuffer;\n    apiVisibility?: LensApiVisibility;\n    publicApiUserDataAccess?: UserDataAccess;\n}\n\nexport interface AddLensInput extends LensDescriptor {\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface ReplaceLensesInput {\n    lenses: LensDescriptor | Array<LensDescriptor>;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface RemoveLensInput {\n    lensId: string;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface AssetDescriptor {\n    assetId: string;\n    assetType: AssetType;\n    avatarId?: string;\n    effectId?: string;\n}\n\nexport interface ProvideRemoteAssetsResponseInput {\n    assetId: string;\n    assetType: AssetType;\n    assetBuffer?: ArrayBuffer;\n    assetChecksum?: string;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface ProcessFrameInput {\n    inputFrame: ImageBitmap | HTMLCanvasElement | HTMLImageElement | VideoFrame;\n    timestampMillis: number;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface LensCoreError extends Error {\n    otherExceptions?: Array<Error>;\n    cause: { type: ErrorType; metadata?: any };\n}\n\nexport interface ImageToYuvBufferInput {\n    image: Uint8Array | ArrayBuffer | ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | ImageBitmap;\n    width: number;\n    height: number;\n    outputBuffer?: Uint8Array | ArrayBuffer;\n    onSuccess: (buffer: ArrayBuffer) => void;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface YuvBufferToBitmapInput {\n    buffer: Uint8Array | ArrayBuffer;\n    width: number;\n    height: number;\n    targetWidth?: number;\n    targetHeight?: number;\n    preserveCanvasState?: boolean;\n    allowBufferTransfer?: boolean;\n    onSuccess: (bitmap: ImageBitmap) => void;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetInterfaceControlVisibilityInput {\n    effectId: string;\n    interfaceControl: InterfaceControl;\n    visibility: boolean;\n}\n\nexport interface HandleClientInterfaceActionInput {\n    effectId: string;\n    interfaceControl: InterfaceControl;\n    interfaceAction: InterfaceAction;\n}\n\nexport interface ProvideExternalImageInput {\n    data: Uint8Array | ArrayBuffer;\n    orientation: ExternalMediaOrientation;\n    faceRects?: Array<Rect>;\n}\n\nexport interface ProvideExternalVideoInput {\n    data: Uint8Array | ArrayBuffer;\n    orientation: ExternalMediaOrientation;\n    relStartPosition?: number;\n    relEndPosition?: number;\n    volume?: number;\n}\n\nexport interface ScreenDimmingRequestInput {\n    effectId: string;\n    enabled: boolean;\n}\n\nexport type ScreenDimmingRequestHandler = (config: ScreenDimmingRequestInput) => void;\n\nexport interface ClientInterfaceData {\n    HeaderId?: string;\n    DescriptionId?: string;\n    FaceFilteringEnabled?: \"0\" | \"1\";\n    FaceFilteringMultipleFaces?: \"0\" | \"1\";\n    ImageEnabled?: \"0\" | \"1\";\n    VideoEnabled?: \"0\" | \"1\";\n}\n\nexport interface ClientInterfaceRequestInput {\n    effectId: string;\n    interfaceControl: InterfaceControl;\n    interfaceAction: InterfaceAction;\n    data: ClientInterfaceData;\n}\n\nexport type ClientInterfaceRequestHandler = (config: ClientInterfaceRequestInput) => void;\n\nexport interface LensCoreConfig {\n    configId: string;\n    value:\n        | { stringValue: string }\n        | { boolValue: boolean }\n        | { intValue: number }\n        | { longValue: number }\n        | { floatValue: number }\n        | {\n        anyValue: {\n            typeUrl: string;\n            value: Uint8Array | ArrayBuffer;\n        };\n    };\n}\n\nexport type SetPreloadedConfigurationInput = Array<LensCoreConfig>;\n\nexport interface SetAllSoundsMutedInput {\n    muted: boolean;\n    fade: boolean;\n}\n\nexport interface SetDeviceClassInput {\n    deviceClass: DeviceClass;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetAudioParametersInput {\n    parameters: {\n        numChannels?: number;\n        sampleRate?: number;\n    };\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SystemFont {\n    name: string;\n    data: Uint8Array | ArrayBuffer;\n}\n\nexport interface SetSystemFontsInput {\n    fonts: SystemFont[]\n}\nexport interface ProcessAudioSampleBufferInput {\n    input: Float32Array[] | ArrayBuffer[];\n    output?: Float32Array[] | ArrayBuffer[];\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface InitialEmscriptenModule {\n    mainScriptUrlOrBlob: string;\n    compiledModule?: WebAssembly.Module;\n    pthreadWorkerScriptUrl?: string;\n    instantiateWasm?: (importObject: WebAssembly.Imports, receiveInstance: ReceiveInstanceCallback) => void;\n    print?: (text: string) => void;\n    printErr?: (text: string) => void;\n}\n\nexport interface LensCoreModule extends InitialEmscriptenModule {\n    AssetType: {\n        RemoteMediaByUrl: AssetType;\n        DeviceDependent: AssetType;\n        Static: AssetType;\n        URL: AssetType;\n        BitmojiDynamicAsset: AssetType;\n    };\n\n    CanvasType: {\n        None: CanvasType;\n        Preview: CanvasType;\n        Capture: CanvasType;\n        All: CanvasType;\n    };\n\n    LensApiVisibility: {\n        Dev: LensApiVisibility;\n        Private: LensApiVisibility;\n        Public: LensApiVisibility;\n    };\n\n    DeviceClass: {\n        Undefined: DeviceClass;\n        BarelyWorking: DeviceClass;\n        LowEnd: DeviceClass;\n        MidEnd: DeviceClass;\n        HighEnd: DeviceClass;\n    };\n\n    RenderLoopMode: {\n        SetTimeout: RenderLoopMode;\n        RequestAnimationFrame: RenderLoopMode;\n    };\n\n    UserDataAccess: {\n        Restricted: UserDataAccess;\n        Unrestricted: UserDataAccess;\n    };\n\n    InterfaceControl: {\n        ToggleCameraButton: InterfaceControl;\n        ImagePicker: InterfaceControl;\n        Hint: InterfaceControl;\n        Modal: InterfaceControl;\n        LinkBitmojiCallToAction: InterfaceControl;\n        SnapButton: InterfaceControl;\n        PlayButton: InterfaceControl;\n        All: InterfaceControl;\n        ExitFullScreenButton: InterfaceControl;\n        MemoriesButton: InterfaceControl;\n        LensAttachmentButton: InterfaceControl;\n        ReverseCamera: InterfaceControl;\n    };\n\n    InterfaceAction: {\n        EnableHighlight: InterfaceAction;\n        DisableHighlight: InterfaceAction;\n        Trigger: InterfaceAction;\n        Show: InterfaceAction;\n        Hide: InterfaceAction;\n    };\n\n    ExternalMediaOrientation: {\n        CW0: ExternalMediaOrientation;\n        CW90: ExternalMediaOrientation;\n        CW180: ExternalMediaOrientation;\n        CW270: ExternalMediaOrientation;\n    };\n\n    ErrorType: {\n        LensDeserialization: ErrorType;\n        Validation: ErrorType;\n        Uncategorized: ErrorType;\n        LensExecution: ErrorType;\n        Abort: ErrorType;\n    };\n\n    initialize: (config: InitializeInput) => void;\n    processFrame: (config: ProcessFrameInput) => void;\n    addLens: (config: AddLensInput) => void;\n    replaceLenses: (config: ReplaceLensesInput) => void;\n    removeLens: (config: RemoveLensInput) => void;\n    clearAllLenses: (config: ClearAllLensesInput) => void;\n    teardown: (config: TeardownInput) => void;\n    useMediaElement: (config: UseMediaElementInput) => void;\n    setFPSLimit: (config: SetFpsLimitInput) => void;\n    setRenderLoopMode: (config: SetRenderLoopInput) => void;\n    getCoreVersion: () => number;\n    playCanvas: (input: PlayCanvasInput) => void;\n    pauseCanvas: (input: PauseCanvasInput) => void;\n    getOutputCanvases: () => GetOutputCanvasesOutput;\n    setRenderSize: (input: SetRenderSizeInput) => void;\n    startProfiling: () => void;\n    endProfiling: () => void;\n    setInputTransform: (config: SetInputTransformInput) => void;\n    registerUriListener: (scheme: string, route: string, listener: UriListener) => void;\n    provideUriResponse: (requestId: string, response: UriResponse) => void;\n    setRemoteAssetsProvider: (provider: SetRemoteAssetsProviderInput) => void;\n    provideRemoteAssetsResponse: (assetResponse: ProvideRemoteAssetsResponseInput) => void;\n    registerShowHintCallback: (callback: ShowHintCallback) => void;\n    registerHideHintCallback: (callback: HideHintCallback) => void;\n    registerSavePersistentStoreCallback: (callback: SavePersistentStoreCallback) => void;\n    imageToYuvBuffer: (config: ImageToYuvBufferInput) => void;\n    yuvBufferToBitmap: (config: YuvBufferToBitmapInput) => void;\n    setOnFrameProcessedCallback: (config: SetOnFrameProcessedInput) => void;\n    setInterfaceControlVisibility: (config: SetInterfaceControlVisibilityInput) => void;\n    handleClientInterfaceAction: (config: HandleClientInterfaceActionInput) => void;\n    provideExternalImage: (config: ProvideExternalImageInput) => void;\n    provideExternalVideo: (config: ProvideExternalVideoInput) => void;\n    setScreenDimmingRequestHandler: (callback: ScreenDimmingRequestHandler) => void;\n    setClientInterfaceRequestHandler: (callback: ClientInterfaceRequestHandler) => void;\n    setPreloadedConfiguration: (config: SetPreloadedConfigurationInput) => void;\n    setAllSoundsMuted: (config: SetAllSoundsMutedInput) => void;\n    setDeviceClass: (config: SetDeviceClassInput) => void;\n    setSystemFonts: (config: SetSystemFontsInput) => void;\n    setAudioParameters: (config: SetAudioParametersInput) => void;\n    processAudioSampleBuffer: (config: ProcessAudioSampleBufferInput) => void;\n}\n\ndeclare global {\n    // This function is provided by the Emscripten glue file and responsible for initialization, will be fullfiled\n    // when everything is loaded and it is safe to call compiled functions\n    // eslint-disable-next-line max-len\n    // https://emscripten.org/docs/getting_started/FAQ.html#how-can-i-tell-when-the-page-is-fully-loaded-and-it-is-safe-to-call-compiled-functions\n    // Function is defined by the LensCore web assembly\n    // eslint-disable-next-line max-len\n    // https://github.sc-corp.net/Snapchat/LensCore/blob/6715da8c877d593e4fe133f4145eb3022204525d/Platforms/WebAssembly/LookserySDK/CMakeLists.txt#L65\n    function createLensesModule(module: InitialEmscriptenModule): Promise<InitialEmscriptenModule & LensCoreModule>;\n}\n"]}
+{"version":3,"file":"generated-types.js","sourceRoot":"","sources":["../../src/lens-core-module/generated-types.ts"],"names":[],"mappings":"","sourcesContent":["export type DefaultEventHandler = (...data: any[]) => void;\n\nexport type DefaultErrorHandler = (err: LensCoreError) => void;\n\nexport type LensCoreEnumValue = { value: number };\n\nexport type GetOutputCanvasesOutput = Record<number, HTMLCanvasElement>;\n\nexport type SetRenderSizeInput = SetRenderSizeMatchInputResolutionInput | SetRenderSizeExplicitInput;\n\nexport type SetRemoteAssetsProviderInput = (assetDescriptor: AssetDescriptor) => void;\n\nexport type SetRemoteAssetsUploadHandlerInput = (assetUploadDescriptor: AssetUploadDescriptor) => void;\n\nexport type ContentType =\n    | \"text/plain\"\n    | \"text/html\"\n    | \"application/json\"\n    | \"application/octet-stream\"\n    | \"application/x-protobuf\"\n    | \"application/grpc\";\n\nexport type SavePersistentStoreCallback = (id: string, data: ArrayBuffer) => void;\n\nexport type ShowHintCallback = (effectId: string, hintId: string) => void;\n\nexport type HideHintCallback = (effectId: string) => void;\n\nexport type ReceiveInstanceCallback = (instance: WebAssembly.Instance, module: WebAssembly.Module) => void;\n\nexport type AssetType = LensCoreEnumValue;\n\nexport type CanvasType = LensCoreEnumValue;\n\nexport type RenderLoopMode = LensCoreEnumValue;\n\nexport type LensApiVisibility = LensCoreEnumValue;\n\nexport type DeviceClass = LensCoreEnumValue;\n\nexport type UserDataAccess = LensCoreEnumValue;\n\nexport type InterfaceControl = LensCoreEnumValue;\n\nexport type InterfaceAction = LensCoreEnumValue;\n\nexport type ExternalMediaOrientation = LensCoreEnumValue;\n\nexport type ErrorType = LensCoreEnumValue;\n\nexport type Uri = `${string}://${string}`;\n\nexport type Dimensions = { width: number; height: number };\n\nexport type Size2D = { width: number; height: number };\n\nexport type Vec2D = { x: number; y: number };\n\nexport type Rect = { origin: Vec2D; size: Size2D };\n\nexport interface ClearAllLensesInput {\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface OnFrameProcessedParam {\n    processingTimeMs: number;\n}\n\nexport interface InitializeInput {\n    canvas?: HTMLCanvasElement | string;\n    outputResolution?: Dimensions;\n    showFpsPanel?: boolean;\n    shouldUseWorker?: boolean;\n    onFrameProcessed?: (arg: OnFrameProcessedParam) => void;\n    onFailure?: DefaultErrorHandler;\n    onSuccess?: DefaultEventHandler;\n    exceptionHandler?: (error: LensCoreError) => void;\n}\n\nexport interface PlayCanvasInput {\n    type: CanvasType;\n    onReady?: () => void;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface PauseCanvasInput {\n    type: CanvasType;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetFpsLimitInput {\n    fps: number;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetInputTransformInput {\n    matrix: Float32Array | ArrayBuffer;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetOnFrameProcessedInput {\n    onFrameProcessed: (arg: OnFrameProcessedParam) => void;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetRenderSizeMatchInputResolutionInput {\n    mode: \"matchInputResolution\";\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetRenderSizeExplicitInput {\n    mode: \"explicit\";\n    target: Dimensions;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetRenderLoopInput {\n    mode: RenderLoopMode;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface TeardownInput {\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultEventHandler;\n}\n\nexport interface ReplayTrackingDataInput {\n    buffer: Uint8Array | ArrayBuffer;\n}\n\nexport interface UseMediaElementInput {\n    media?: HTMLCanvasElement | HTMLImageElement | HTMLVideoElement | MediaStream;\n    requestWebcam?: boolean;\n    startOnFrontCamera?: boolean;\n    mirrorMedia?: boolean;\n    pauseExistingMedia?: boolean;\n    autoplayNewMedia?: boolean;\n    autoplayPreviewCanvas?: boolean;\n    useManualFrameProcessing?: boolean;\n    replayTrackingData?: ReplayTrackingDataInput;\n    onFailure?: DefaultErrorHandler;\n    onSuccess?: DefaultEventHandler;\n}\n\nexport interface UriListener {\n    handleRequest: (request: UriRequest) => void;\n    cancelRequest?: (request: UriCancelRequest) => void;\n}\n\nexport interface UriRequest {\n    uri: Uri;\n    identifier: string;\n    method: \"GET\" | \"POST\";\n    contentType: ContentType;\n    data: ArrayBuffer;\n    metadata: Record<string, string>;\n}\n\nexport interface UriResponse {\n    code: number;\n    description: string;\n    contentType: ContentType;\n    data: ArrayBuffer;\n    metadata?: Record<string, string>;\n}\n\nexport interface UriCancelRequest {\n    uri: Uri;\n    requestId: string;\n}\n\nexport interface LensDescriptor {\n    lensId: string;\n    lensChecksum: string;\n    lensPath?: string;\n    lensDataBuffer?: Uint8Array | ArrayBuffer;\n    onTurnOn?: DefaultEventHandler;\n    onTurnOff?: DefaultEventHandler;\n    onFirstFrameProcessed?: DefaultEventHandler;\n    onResourcesLoaded?: DefaultEventHandler;\n    launchData?: Uint8Array | ArrayBuffer;\n    apiVisibility?: LensApiVisibility;\n    publicApiUserDataAccess?: UserDataAccess;\n}\n\nexport interface AddLensInput extends LensDescriptor {\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface ReplaceLensesInput {\n    lenses: LensDescriptor | Array<LensDescriptor>;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface RemoveLensInput {\n    lensId: string;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface AssetDescriptor {\n    assetId: string;\n    assetType: AssetType;\n    avatarId?: string;\n    effectId?: string;\n    encryptionKey?: string;\n}\n\nexport interface AssetUploadDescriptor {\n    requestId: number;\n    assetId: string;\n    assetType: AssetType;\n    effectId: string;\n    assetBuffer: ArrayBuffer;\n    encryptionKey?: string;\n    encryptionIv?: string;\n    assetBatchId?: string;\n}\n\nexport interface ProvideRemoteAssetsResponseInput {\n    assetId: string;\n    assetType: AssetType;\n    assetBuffer?: ArrayBuffer;\n    assetChecksum?: string;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface ProvideRemoteAssetsUploadResponseInput {\n    requestId: number;\n    success: boolean;\n    assetUrl?: string;\n    assetUploadMetadata?: ArrayBuffer;\n}\n\nexport interface ProcessFrameInput {\n    inputFrame: ImageBitmap | HTMLCanvasElement | HTMLImageElement | VideoFrame;\n    timestampMillis: number;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface LensCoreError extends Error {\n    otherExceptions?: Array<Error>;\n    cause: { type: ErrorType; metadata?: any };\n}\n\nexport interface ImageToYuvBufferInput {\n    image: Uint8Array | ArrayBuffer | ImageData | HTMLImageElement | HTMLCanvasElement | HTMLVideoElement | ImageBitmap;\n    width: number;\n    height: number;\n    outputBuffer?: Uint8Array | ArrayBuffer;\n    onSuccess: (buffer: ArrayBuffer) => void;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface YuvBufferToBitmapInput {\n    buffer: Uint8Array | ArrayBuffer;\n    width: number;\n    height: number;\n    targetWidth?: number;\n    targetHeight?: number;\n    preserveCanvasState?: boolean;\n    allowBufferTransfer?: boolean;\n    onSuccess: (bitmap: ImageBitmap) => void;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetInterfaceControlVisibilityInput {\n    effectId: string;\n    interfaceControl: InterfaceControl;\n    visibility: boolean;\n}\n\nexport interface HandleClientInterfaceActionInput {\n    effectId: string;\n    interfaceControl: InterfaceControl;\n    interfaceAction: InterfaceAction;\n}\n\nexport interface ProvideExternalImageInput {\n    data: Uint8Array | ArrayBuffer;\n    orientation: ExternalMediaOrientation;\n    faceRects?: Array<Rect>;\n}\n\nexport interface ProvideExternalVideoInput {\n    data: Uint8Array | ArrayBuffer;\n    orientation: ExternalMediaOrientation;\n    relStartPosition?: number;\n    relEndPosition?: number;\n    volume?: number;\n}\n\nexport interface ScreenDimmingRequestInput {\n    effectId: string;\n    enabled: boolean;\n}\n\nexport type ScreenDimmingRequestHandler = (config: ScreenDimmingRequestInput) => void;\n\nexport interface ClientInterfaceData {\n    HeaderId?: string;\n    DescriptionId?: string;\n    FaceFilteringEnabled?: \"0\" | \"1\";\n    FaceFilteringMultipleFaces?: \"0\" | \"1\";\n    ImageEnabled?: \"0\" | \"1\";\n    VideoEnabled?: \"0\" | \"1\";\n}\n\nexport interface ClientInterfaceRequestInput {\n    effectId: string;\n    interfaceControl: InterfaceControl;\n    interfaceAction: InterfaceAction;\n    data: ClientInterfaceData;\n}\n\nexport type ClientInterfaceRequestHandler = (config: ClientInterfaceRequestInput) => void;\n\nexport interface LensCoreConfig {\n    configId: string;\n    value:\n        | { stringValue: string }\n        | { boolValue: boolean }\n        | { intValue: number }\n        | { longValue: number }\n        | { floatValue: number }\n        | {\n        anyValue: {\n            typeUrl: string;\n            value: Uint8Array | ArrayBuffer;\n        };\n    };\n}\n\nexport type SetPreloadedConfigurationInput = Array<LensCoreConfig>;\n\nexport interface SetAllSoundsMutedInput {\n    muted: boolean;\n    fade: boolean;\n}\n\nexport interface SetDeviceClassInput {\n    deviceClass: DeviceClass;\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SetAudioParametersInput {\n    parameters: {\n        numChannels?: number;\n        sampleRate?: number;\n    };\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface SystemFont {\n    name: string;\n    data: Uint8Array | ArrayBuffer;\n}\n\nexport interface SetSystemFontsInput {\n    fonts: SystemFont[]\n}\nexport interface ProcessAudioSampleBufferInput {\n    input: Float32Array[] | ArrayBuffer[];\n    output?: Float32Array[] | ArrayBuffer[];\n    onSuccess?: DefaultEventHandler;\n    onFailure?: DefaultErrorHandler;\n}\n\nexport interface InitialEmscriptenModule {\n    mainScriptUrlOrBlob: string;\n    compiledModule?: WebAssembly.Module;\n    pthreadWorkerScriptUrl?: string;\n    instantiateWasm?: (importObject: WebAssembly.Imports, receiveInstance: ReceiveInstanceCallback) => void;\n    print?: (text: string) => void;\n    printErr?: (text: string) => void;\n}\n\nexport interface LensCoreModule extends InitialEmscriptenModule {\n    AssetType: {\n        RemoteMediaByUrl: AssetType;\n        DeviceDependent: AssetType;\n        Static: AssetType;\n        URL: AssetType;\n        BitmojiDynamicAsset: AssetType;\n    };\n\n    CanvasType: {\n        None: CanvasType;\n        Preview: CanvasType;\n        Capture: CanvasType;\n        All: CanvasType;\n    };\n\n    LensApiVisibility: {\n        Dev: LensApiVisibility;\n        Private: LensApiVisibility;\n        Public: LensApiVisibility;\n    };\n\n    DeviceClass: {\n        Undefined: DeviceClass;\n        BarelyWorking: DeviceClass;\n        LowEnd: DeviceClass;\n        MidEnd: DeviceClass;\n        HighEnd: DeviceClass;\n    };\n\n    RenderLoopMode: {\n        SetTimeout: RenderLoopMode;\n        RequestAnimationFrame: RenderLoopMode;\n    };\n\n    UserDataAccess: {\n        Restricted: UserDataAccess;\n        Unrestricted: UserDataAccess;\n    };\n\n    InterfaceControl: {\n        ToggleCameraButton: InterfaceControl;\n        ImagePicker: InterfaceControl;\n        Hint: InterfaceControl;\n        Modal: InterfaceControl;\n        LinkBitmojiCallToAction: InterfaceControl;\n        SnapButton: InterfaceControl;\n        PlayButton: InterfaceControl;\n        All: InterfaceControl;\n        ExitFullScreenButton: InterfaceControl;\n        MemoriesButton: InterfaceControl;\n        LensAttachmentButton: InterfaceControl;\n        ReverseCamera: InterfaceControl;\n    };\n\n    InterfaceAction: {\n        EnableHighlight: InterfaceAction;\n        DisableHighlight: InterfaceAction;\n        Trigger: InterfaceAction;\n        Show: InterfaceAction;\n        Hide: InterfaceAction;\n    };\n\n    ExternalMediaOrientation: {\n        CW0: ExternalMediaOrientation;\n        CW90: ExternalMediaOrientation;\n        CW180: ExternalMediaOrientation;\n        CW270: ExternalMediaOrientation;\n    };\n\n    ErrorType: {\n        LensDeserialization: ErrorType;\n        Validation: ErrorType;\n        Uncategorized: ErrorType;\n        LensExecution: ErrorType;\n        Abort: ErrorType;\n    };\n\n    initialize: (config: InitializeInput) => void;\n    processFrame: (config: ProcessFrameInput) => void;\n    addLens: (config: AddLensInput) => void;\n    replaceLenses: (config: ReplaceLensesInput) => void;\n    removeLens: (config: RemoveLensInput) => void;\n    clearAllLenses: (config: ClearAllLensesInput) => void;\n    teardown: (config: TeardownInput) => void;\n    useMediaElement: (config: UseMediaElementInput) => void;\n    setFPSLimit: (config: SetFpsLimitInput) => void;\n    setRenderLoopMode: (config: SetRenderLoopInput) => void;\n    getCoreVersion: () => number;\n    playCanvas: (input: PlayCanvasInput) => void;\n    pauseCanvas: (input: PauseCanvasInput) => void;\n    getOutputCanvases: () => GetOutputCanvasesOutput;\n    setRenderSize: (input: SetRenderSizeInput) => void;\n    startProfiling: () => void;\n    endProfiling: () => void;\n    setInputTransform: (config: SetInputTransformInput) => void;\n    registerUriListener: (scheme: string, route: string, listener: UriListener) => void;\n    provideUriResponse: (requestId: string, response: UriResponse) => void;\n    setRemoteAssetsProvider: (provider: SetRemoteAssetsProviderInput) => void;\n    provideRemoteAssetsResponse: (assetResponse: ProvideRemoteAssetsResponseInput) => void;\n    setRemoteAssetsUploadHandler: (provider: SetRemoteAssetsUploadHandlerInput) => void;\n    provideRemoteAssetsUploadResponse: (assetResponse: ProvideRemoteAssetsUploadResponseInput) => void;\n    registerShowHintCallback: (callback: ShowHintCallback) => void;\n    registerHideHintCallback: (callback: HideHintCallback) => void;\n    registerSavePersistentStoreCallback: (callback: SavePersistentStoreCallback) => void;\n    imageToYuvBuffer: (config: ImageToYuvBufferInput) => void;\n    yuvBufferToBitmap: (config: YuvBufferToBitmapInput) => void;\n    setOnFrameProcessedCallback: (config: SetOnFrameProcessedInput) => void;\n    setInterfaceControlVisibility: (config: SetInterfaceControlVisibilityInput) => void;\n    handleClientInterfaceAction: (config: HandleClientInterfaceActionInput) => void;\n    provideExternalImage: (config: ProvideExternalImageInput) => void;\n    provideExternalVideo: (config: ProvideExternalVideoInput) => void;\n    setScreenDimmingRequestHandler: (callback: ScreenDimmingRequestHandler) => void;\n    setClientInterfaceRequestHandler: (callback: ClientInterfaceRequestHandler) => void;\n    setPreloadedConfiguration: (config: SetPreloadedConfigurationInput) => void;\n    setAllSoundsMuted: (config: SetAllSoundsMutedInput) => void;\n    setDeviceClass: (config: SetDeviceClassInput) => void;\n    setSystemFonts: (config: SetSystemFontsInput) => void;\n    setAudioParameters: (config: SetAudioParametersInput) => void;\n    processAudioSampleBuffer: (config: ProcessAudioSampleBufferInput) => void;\n}\n\ndeclare global {\n    // This function is provided by the Emscripten glue file and responsible for initialization, will be fullfiled\n    // when everything is loaded and it is safe to call compiled functions\n    // eslint-disable-next-line max-len\n    // https://emscripten.org/docs/getting_started/FAQ.html#how-can-i-tell-when-the-page-is-fully-loaded-and-it-is-safe-to-call-compiled-functions\n    // Function is defined by the LensCore web assembly\n    // eslint-disable-next-line max-len\n    // https://github.sc-corp.net/Snapchat/LensCore/blob/6715da8c877d593e4fe133f4145eb3022204525d/Platforms/WebAssembly/LookserySDK/CMakeLists.txt#L65\n    function createLensesModule(module: InitialEmscriptenModule): Promise<InitialEmscriptenModule & LensCoreModule>;\n}\n"]}

package/lib/lens-core-module/loader/lensCoreFactory.js

@@ -88,7 +88,7 @@ export const lensCoreFactory = Injectable("lensCore", [defaultFetchHandlerFactor
         const glueScript = yield handler(lensCoreJS).then((r) => r.blob());
         lensCoreJS = URL.createObjectURL(glueScript);
     }
-    yield loadScript(lensCoreJS);
+    const scriptElement = yield loadScript(lensCoreJS);
     const lensCore = yield new Promise((resolve, reject) => {
         let initialModule;
         // will trigger WASM initialization and data loading,
@@ -112,6 +112,8 @@ export const lensCoreFactory = Injectable("lensCore", [defaultFetchHandlerFactor
             },
         }));
     });
+    // now when we have LensCore WASM in memory we can release the script element
+    scriptElement.remove();
     // print warning if loaded version differs from hardcoded one
     if (lensCoreWasm.version != `${lensCore.getCoreVersion()}`) {
         logger.warn(`Loaded LensCore version (${lensCore.getCoreVersion()}) differs from expected one (${lensCoreWasm.version})`);

package/lib/lens-core-module/loader/lensCoreFactory.js.map

@@ -1 +1 @@
-{"version":3,"file":"lensCoreFactory.js","sourceRoot":"","sources":["../../../src/lens-core-module/loader/lensCoreFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import { simd, exceptions } from \"wasm-feature-detect\";\nimport lensCoreWasm from \"../../lensCoreWasmVersions.json\";\nimport { loadScript } from \"../../common\";\nimport { CameraKitConfiguration, configurationToken } from \"../../configuration\";\nimport { Injectable } from \"../../dependency-injection/Injectable\";\nimport { defaultFetchHandlerFactory, FetchHandler } from \"../../handlers/defaultFetchHandler\";\nimport { InitialEmscriptenModule, LensCoreModule } from \"../generated-types\";\nimport { getLogger } from \"../../logger/logger\";\nimport { cameraKitUserAgent } from \"../../common/cameraKitUserAgent\";\n\nconst logger = getLogger(\"lensCoreFactory\");\n\nconst wasmAssets = [\"LensCoreWebAssembly.js\", \"LensCoreWebAssembly.wasm\"];\n\nconst findMatch = (regex: RegExp, strings: string[]) => strings.find((s) => regex.test(s));\n\nconst PlatformFeatures = {\n    Default: 0,\n    Simd: 0b01,\n    Exceptions: 0b10,\n};\n\nconst platformFeaturesToFlavour = {\n    [PlatformFeatures.Exceptions | PlatformFeatures.Simd]: \"rel-simd-neh\",\n    [PlatformFeatures.Simd]: \"release-simd\",\n    [PlatformFeatures.Exceptions]: \"rel-neh\",\n    [PlatformFeatures.Default]: \"release\",\n};\n\n/**\n * Returns a list of URLs for resources which will be fetched during {@link bootstrapCameraKit}.\n *\n * When CameraKit is used on a website, these URLs much be reachable in order for CameraKit to be successfully\n * bootstrapped.\n *\n * @param endpointOverride Optional endpoint override to load the assets from.\n * @returns An array of asset URLs.\n *\n * @category Bootstrapping and Configuration\n */\nexport async function getRequiredBootstrapURLs(endpointOverride?: string): Promise<string[]> {\n    // If we have an endpoint override, remove trailing `/` so we can construct a valid URL.\n    const endpoint = endpointOverride?.replace(/[\\/]+$/, \"\");\n\n    let [simdFeature, exceptionsFeature] = await Promise.all([\n        simd().then((supported) => (supported ? PlatformFeatures.Simd : PlatformFeatures.Default)),\n        exceptions().then((supported) => (supported ? PlatformFeatures.Exceptions : PlatformFeatures.Default)),\n    ]);\n\n    // Although Safari 16.4 reports SIMD support, LensCore encounters rendering bugs when using SIMD in Safari 16.4.\n    // Therefore, we have made the decision to disable SIMD for now until Safari stabilizes the feature.\n    const { brand } = cameraKitUserAgent.browser;\n    if (brand === \"Safari\") simdFeature = PlatformFeatures.Default;\n\n    const flavor = platformFeaturesToFlavour[simdFeature | exceptionsFeature];\n\n    const version = lensCoreWasm.version;\n    const buildNumber = lensCoreWasm.buildNumber;\n    return wasmAssets.map((asset) => {\n        if (endpoint) return `${endpoint}/${asset}`;\n        const { origin, pathname, search } = new URL(lensCoreWasm.baseUrl);\n        return `${origin}${pathname}/${version}/${buildNumber}/${flavor}/${asset}${search}`;\n    });\n}\n\n/**\n * This component is responsible for:\n *   1) Loading LensCore WebAssembly (WASM) assets\n *   2) Using the WASM assets to initialize the LensCore WASM module\n *\n * By default, WASM assets will be loaded from the Bolt CDN – but if `endpoint` is provided, assets will be loaded\n * using it as a base URL.\n *\n * @internal\n */\nexport const lensCoreFactory = Injectable(\n    \"lensCore\",\n    [defaultFetchHandlerFactory.token, configurationToken] as const,\n    async (handler: FetchHandler, { lensCoreOverrideUrls, wasmEndpointOverride }: CameraKitConfiguration) => {\n        let lensCoreJS: string;\n        let lensCoreWASM: string;\n\n        if (lensCoreOverrideUrls) {\n            lensCoreJS = lensCoreOverrideUrls.js;\n            lensCoreWASM = lensCoreOverrideUrls.wasm;\n        } else {\n            const endpointOverride = wasmEndpointOverride ?? undefined;\n            const assetURLs = await getRequiredBootstrapURLs(endpointOverride);\n\n            lensCoreJS = findMatch(/\\.js/, assetURLs) ?? \"\";\n            lensCoreWASM = findMatch(/\\.wasm/, assetURLs) ?? \"\";\n\n            if (!lensCoreJS || !lensCoreWASM) {\n                throw new Error(\n                    `Cannot fetch required LensCore assets. Either the JS or WASM filename is missing from ` +\n                        `this list: ${assetURLs}.`\n                );\n            }\n\n            // Fetching here and creating an Object URL lets LensCore optimized loading itself in a WebWorker,\n            // otherwise the glue script would need to be downloaded again.\n            const glueScript = await handler(lensCoreJS).then((r) => r.blob());\n            lensCoreJS = URL.createObjectURL(glueScript);\n        }\n\n        await loadScript(lensCoreJS);\n\n        const lensCore = await new Promise<InitialEmscriptenModule & LensCoreModule>((resolve, reject) => {\n            let initialModule: Partial<InitialEmscriptenModule>;\n            // will trigger WASM initialization and data loading,\n            // after completion it will be safe to call imported WASM functions\n            // More about emscripten initialization:\n            // eslint-disable-next-line max-len\n            // https://emscripten.org/docs/getting_started/FAQ.html?highlight=modularize#how-can-i-tell-when-the-page-is-fully-loaded-and-it-is-safe-to-call-compiled-functions\n            const moduleInit = globalThis.createLensesModule(\n                (initialModule = {\n                    // url will be used for loading glue JS during Worker inialization\n                    mainScriptUrlOrBlob: lensCoreJS,\n                    // will be triggered by Emscripten during the initialization\n                    instantiateWasm: (importObject, receiveInstance) => {\n                        WebAssembly.instantiateStreaming(handler(lensCoreWASM), importObject)\n                            .then(function ({ instance, module }) {\n                                receiveInstance(instance, module);\n                                // compiled module will be reused in Worker\n                                initialModule.compiledModule = module;\n                                resolve(moduleInit);\n                            })\n                            .catch(reject);\n                    },\n                })\n            );\n        });\n\n        // print warning if loaded version differs from hardcoded one\n        if (lensCoreWasm.version != `${lensCore.getCoreVersion()}`) {\n            logger.warn(\n                `Loaded LensCore version (${lensCore.getCoreVersion()}) differs from expected one (${\n                    lensCoreWasm.version\n                })`\n            );\n        }\n\n        return lensCore;\n    }\n);\n"]}
+{"version":3,"file":"lensCoreFactory.js","sourceRoot":"","sources":["../../../src/lens-core-module/loader/lensCoreFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import { simd, exceptions } from \"wasm-feature-detect\";\nimport lensCoreWasm from \"../../lensCoreWasmVersions.json\";\nimport { loadScript } from \"../../common\";\nimport { CameraKitConfiguration, configurationToken } from \"../../configuration\";\nimport { Injectable } from \"../../dependency-injection/Injectable\";\nimport { defaultFetchHandlerFactory, FetchHandler } from \"../../handlers/defaultFetchHandler\";\nimport { InitialEmscriptenModule, LensCoreModule } from \"../generated-types\";\nimport { getLogger } from \"../../logger/logger\";\nimport { cameraKitUserAgent } from \"../../common/cameraKitUserAgent\";\n\nconst logger = getLogger(\"lensCoreFactory\");\n\nconst wasmAssets = [\"LensCoreWebAssembly.js\", \"LensCoreWebAssembly.wasm\"];\n\nconst findMatch = (regex: RegExp, strings: string[]) => strings.find((s) => regex.test(s));\n\nconst PlatformFeatures = {\n    Default: 0,\n    Simd: 0b01,\n    Exceptions: 0b10,\n};\n\nconst platformFeaturesToFlavour = {\n    [PlatformFeatures.Exceptions | PlatformFeatures.Simd]: \"rel-simd-neh\",\n    [PlatformFeatures.Simd]: \"release-simd\",\n    [PlatformFeatures.Exceptions]: \"rel-neh\",\n    [PlatformFeatures.Default]: \"release\",\n};\n\n/**\n * Returns a list of URLs for resources which will be fetched during {@link bootstrapCameraKit}.\n *\n * When CameraKit is used on a website, these URLs much be reachable in order for CameraKit to be successfully\n * bootstrapped.\n *\n * @param endpointOverride Optional endpoint override to load the assets from.\n * @returns An array of asset URLs.\n *\n * @category Bootstrapping and Configuration\n */\nexport async function getRequiredBootstrapURLs(endpointOverride?: string): Promise<string[]> {\n    // If we have an endpoint override, remove trailing `/` so we can construct a valid URL.\n    const endpoint = endpointOverride?.replace(/[\\/]+$/, \"\");\n\n    let [simdFeature, exceptionsFeature] = await Promise.all([\n        simd().then((supported) => (supported ? PlatformFeatures.Simd : PlatformFeatures.Default)),\n        exceptions().then((supported) => (supported ? PlatformFeatures.Exceptions : PlatformFeatures.Default)),\n    ]);\n\n    // Although Safari 16.4 reports SIMD support, LensCore encounters rendering bugs when using SIMD in Safari 16.4.\n    // Therefore, we have made the decision to disable SIMD for now until Safari stabilizes the feature.\n    const { brand } = cameraKitUserAgent.browser;\n    if (brand === \"Safari\") simdFeature = PlatformFeatures.Default;\n\n    const flavor = platformFeaturesToFlavour[simdFeature | exceptionsFeature];\n\n    const version = lensCoreWasm.version;\n    const buildNumber = lensCoreWasm.buildNumber;\n    return wasmAssets.map((asset) => {\n        if (endpoint) return `${endpoint}/${asset}`;\n        const { origin, pathname, search } = new URL(lensCoreWasm.baseUrl);\n        return `${origin}${pathname}/${version}/${buildNumber}/${flavor}/${asset}${search}`;\n    });\n}\n\n/**\n * This component is responsible for:\n *   1) Loading LensCore WebAssembly (WASM) assets\n *   2) Using the WASM assets to initialize the LensCore WASM module\n *\n * By default, WASM assets will be loaded from the Bolt CDN – but if `endpoint` is provided, assets will be loaded\n * using it as a base URL.\n *\n * @internal\n */\nexport const lensCoreFactory = Injectable(\n    \"lensCore\",\n    [defaultFetchHandlerFactory.token, configurationToken] as const,\n    async (handler: FetchHandler, { lensCoreOverrideUrls, wasmEndpointOverride }: CameraKitConfiguration) => {\n        let lensCoreJS: string;\n        let lensCoreWASM: string;\n\n        if (lensCoreOverrideUrls) {\n            lensCoreJS = lensCoreOverrideUrls.js;\n            lensCoreWASM = lensCoreOverrideUrls.wasm;\n        } else {\n            const endpointOverride = wasmEndpointOverride ?? undefined;\n            const assetURLs = await getRequiredBootstrapURLs(endpointOverride);\n\n            lensCoreJS = findMatch(/\\.js/, assetURLs) ?? \"\";\n            lensCoreWASM = findMatch(/\\.wasm/, assetURLs) ?? \"\";\n\n            if (!lensCoreJS || !lensCoreWASM) {\n                throw new Error(\n                    `Cannot fetch required LensCore assets. Either the JS or WASM filename is missing from ` +\n                        `this list: ${assetURLs}.`\n                );\n            }\n\n            // Fetching here and creating an Object URL lets LensCore optimized loading itself in a WebWorker,\n            // otherwise the glue script would need to be downloaded again.\n            const glueScript = await handler(lensCoreJS).then((r) => r.blob());\n            lensCoreJS = URL.createObjectURL(glueScript);\n        }\n\n        const scriptElement = await loadScript(lensCoreJS);\n\n        const lensCore = await new Promise<InitialEmscriptenModule & LensCoreModule>((resolve, reject) => {\n            let initialModule: Partial<InitialEmscriptenModule>;\n            // will trigger WASM initialization and data loading,\n            // after completion it will be safe to call imported WASM functions\n            // More about emscripten initialization:\n            // eslint-disable-next-line max-len\n            // https://emscripten.org/docs/getting_started/FAQ.html?highlight=modularize#how-can-i-tell-when-the-page-is-fully-loaded-and-it-is-safe-to-call-compiled-functions\n            const moduleInit = globalThis.createLensesModule(\n                (initialModule = {\n                    // url will be used for loading glue JS during Worker inialization\n                    mainScriptUrlOrBlob: lensCoreJS,\n                    // will be triggered by Emscripten during the initialization\n                    instantiateWasm: (importObject, receiveInstance) => {\n                        WebAssembly.instantiateStreaming(handler(lensCoreWASM), importObject)\n                            .then(function ({ instance, module }) {\n                                receiveInstance(instance, module);\n                                // compiled module will be reused in Worker\n                                initialModule.compiledModule = module;\n                                resolve(moduleInit);\n                            })\n                            .catch(reject);\n                    },\n                })\n            );\n        });\n\n        // now when we have LensCore WASM in memory we can release the script element\n        scriptElement.remove();\n\n        // print warning if loaded version differs from hardcoded one\n        if (lensCoreWasm.version != `${lensCore.getCoreVersion()}`) {\n            logger.warn(\n                `Loaded LensCore version (${lensCore.getCoreVersion()}) differs from expected one (${\n                    lensCoreWasm.version\n                })`\n            );\n        }\n\n        return lensCore;\n    }\n);\n"]}

package/lib/lensCoreWasmVersions.json

@@ -1,5 +1,5 @@
 {
-    "version": "214",
-    "buildNumber": "22",
-    "baseUrl": "https://cf-st.sc-cdn.net/d/NhOZEMtsN1zJBWzj2dabN?go=IgsKCTIBBEgBUFxgAQ%3D%3D&uc=9"
+    "version": "225",
+    "buildNumber": "64",
+    "baseUrl": "https://cf-st.sc-cdn.net/d/JigrWXPgfeH1cbTxyo1FM?go=IgsKCTIBBEgBUFxgAQ%3D%3D&uc=92"
 }

package/lib/logger/logEntries.d.ts

@@ -1,7 +1,7 @@
 /**
  * The factory creates new logEntries subject.
  *
- * NOTE: The factory calls `initLogger()`, which overrides the global `logEntrySubject`.
+ * NOTE: The factory calls `resetLogger()`, which overrides the global `logEntrySubject`.
  * This is currently necessary to avoid sharing the same subject between multiple `CameraKit` instances.
  * In the future, we may throw an error when bootstrapping more than a single `CameraKit`,
  * that will allow us to have a single log entry subject.

package/lib/logger/logEntries.js

@@ -1,14 +1,14 @@
 import { Injectable } from "../dependency-injection/Injectable";
-import { initLogger } from "./logger";
+import { resetLogger } from "./logger";
 /**
  * The factory creates new logEntries subject.
  *
- * NOTE: The factory calls `initLogger()`, which overrides the global `logEntrySubject`.
+ * NOTE: The factory calls `resetLogger()`, which overrides the global `logEntrySubject`.
  * This is currently necessary to avoid sharing the same subject between multiple `CameraKit` instances.
  * In the future, we may throw an error when bootstrapping more than a single `CameraKit`,
  * that will allow us to have a single log entry subject.
  *
  * @internal
  */
-export const logEntriesFactory = Injectable("logEntries", () => initLogger().asObservable());
+export const logEntriesFactory = Injectable("logEntries", () => resetLogger().asObservable());
 //# sourceMappingURL=logEntries.js.map

package/lib/logger/logEntries.js.map

@@ -1 +1 @@
-{"version":3,"file":"logEntries.js","sourceRoot":"","sources":["../../src/logger/logEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,UAAU,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC","sourcesContent":["import { Injectable } from \"../dependency-injection/Injectable\";\nimport { initLogger } from \"./logger\";\n\n/**\n * The factory creates new logEntries subject.\n *\n * NOTE: The factory calls `initLogger()`, which overrides the global `logEntrySubject`.\n * This is currently necessary to avoid sharing the same subject between multiple `CameraKit` instances.\n * In the future, we may throw an error when bootstrapping more than a single `CameraKit`,\n * that will allow us to have a single log entry subject.\n *\n * @internal\n */\nexport const logEntriesFactory = Injectable(\"logEntries\", () => initLogger().asObservable());\n"]}
+{"version":3,"file":"logEntries.js","sourceRoot":"","sources":["../../src/logger/logEntries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC","sourcesContent":["import { Injectable } from \"../dependency-injection/Injectable\";\nimport { resetLogger } from \"./logger\";\n\n/**\n * The factory creates new logEntries subject.\n *\n * NOTE: The factory calls `resetLogger()`, which overrides the global `logEntrySubject`.\n * This is currently necessary to avoid sharing the same subject between multiple `CameraKit` instances.\n * In the future, we may throw an error when bootstrapping more than a single `CameraKit`,\n * that will allow us to have a single log entry subject.\n *\n * @internal\n */\nexport const logEntriesFactory = Injectable(\"logEntries\", () => resetLogger().asObservable());\n"]}

package/lib/logger/logger.d.ts

@@ -12,10 +12,15 @@ export declare const logLevelMap: {
     debug: number;
 };
 /**
- * Initializes new logger subject.
+ * Initializes a new logger subject.
+ *
+ * Note: currently only one `CameraKit` instance is allowed to listen to log messages at a time, therefore that is
+ * necessary to avoid sharing the same subject between multiple `CameraKit` instances by calling`resetLogger()`.
+ * Also, `resetLogger()` should be called when there is no interest in logged messages.
+ * This allows the previous logEntriesSubject to be GCec.
  * @internal
  */
-export declare function initLogger(): Subject<LogEntry>;
+export declare function resetLogger(): Subject<LogEntry>;
 export interface LogEntry {
     time: Date;
     module: string;