@snap/camera-kit 0.16.2 → 0.18.0

package/dist/lens/LensLaunchData.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Lens launch params.
+ */
+export type LensLaunchParams = Record<string, string | number | string[] | number[]>;
+/**
+ * Some Lenses may accept (or require) certain data provided to them when the Lens is applied.
+ *
+ * This data may include things like user info (to render the user's name, for example, or perform some task based on
+ * their birth date), or arbitrary `launchParams` defined by the Lens.
+ *
+ * @category Lenses
+ */
+export interface LensLaunchData {
+    userId?: string;
+    userData?: LensUserData;
+    launchParams?: LensLaunchParams;
+}
+export interface LensUserData {
+    userId?: string;
+    username?: string;
+    birthdate?: string;
+    displayName?: string;
+    countrycode?: string;
+    score?: string;
+    bitmojiInfo?: BitmojiUserInfo;
+    friendInfo?: FriendUserInfo;
+    zodiac?: Zodiac;
+}
+export interface BitmojiUserInfo {
+    avatarId?: string;
+    selfieId?: string;
+}
+export interface FriendUserInfo {
+    friendshipStart?: Date;
+    lastInteraction?: Date;
+    streak?: number;
+}
+export type Zodiac = "aquarius" | "aries" | "cancer" | "capricorn" | "gemini" | "leo" | "libra" | "pisces" | "sagittarius" | "scorpio" | "taurus" | "virgo";
+export declare function isZodiac(value: unknown): value is Zodiac;
+export declare function isLensLaunchDataOrUndefined(value: unknown): value is LensLaunchData | undefined;
+/**
+ * @internal
+ */
+export declare const encodeLensLaunchData: (launchData: LensLaunchData, persistentStore: ArrayBuffer) => Uint8Array;
+//# sourceMappingURL=LensLaunchData.d.ts.map

package/dist/lens/LensLaunchData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensLaunchData.d.ts","sourceRoot":"","sources":["../../src/lens/LensLaunchData.ts"],"names":[],"mappings":"AAgBA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;AAErF;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACnC;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAoBD,MAAM,MAAM,MAAM,GACZ,UAAU,GACV,OAAO,GACP,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,KAAK,GACL,OAAO,GACP,QAAQ,GACR,aAAa,GACb,SAAS,GACT,QAAQ,GACR,OAAO,CAAC;AAId,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,GAAG,SAAS,CAE/F;AAqED;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAAgB,cAAc,mBAAmB,WAAW,KAAG,UAmB/F,CAAC"}

package/dist/lens/LensLaunchData.js

@@ -0,0 +1,83 @@
+import { LaunchData } from "../generated-proto/pb_schema/lenses/launchdata";
+import { isArrayOfType, isDateOrUndefined, isValidNumberOrUndefined, isRecord, isString, isStringOrUndefined, isUndefined, isValidNumber, predicateRecordValues, } from "../common/typeguards";
+import { UserData_Zodiac } from "../generated-proto/pb_schema/lenses/user_data";
+const zodiacMap = {
+    aquarius: UserData_Zodiac.Aquarius,
+    aries: UserData_Zodiac.Aries,
+    cancer: UserData_Zodiac.Cancer,
+    capricorn: UserData_Zodiac.Capricorn,
+    gemini: UserData_Zodiac.Gemini,
+    leo: UserData_Zodiac.Leo,
+    libra: UserData_Zodiac.Libra,
+    pisces: UserData_Zodiac.Pisces,
+    sagittarius: UserData_Zodiac.Sagittarius,
+    scorpio: UserData_Zodiac.Scorpio,
+    taurus: UserData_Zodiac.Taurus,
+    virgo: UserData_Zodiac.Virgo,
+};
+const zodiacValueSet = new Set(Object.keys(zodiacMap));
+export function isZodiac(value) {
+    return zodiacValueSet.has(value);
+}
+export function isLensLaunchDataOrUndefined(value) {
+    return isUndefined(value) || isLensLaunchData(value);
+}
+function isLensLaunchData(value) {
+    return (isRecord(value) &&
+        isStringOrUndefined(value.userId) &&
+        isLensUserDataOrUndefined(value.userData) &&
+        isLensLaunchParamsOrUndefined(value.launchParams));
+}
+function isLensUserDataOrUndefined(value) {
+    return isUndefined(value) || isLensUserData(value);
+}
+function isLensUserData(value) {
+    return (isRecord(value) &&
+        isStringOrUndefined(value.userId) &&
+        isStringOrUndefined(value.username) &&
+        isStringOrUndefined(value.birthdate) &&
+        isStringOrUndefined(value.displayName) &&
+        isStringOrUndefined(value.countrycode) &&
+        isStringOrUndefined(value.score) &&
+        isBitmojiUserInfoOrUndefined(value.bitmojiInfo) &&
+        isFriendUserInfoOrUndefined(value.friendInfo) &&
+        isZodiacOrUndefined(value.zodiac));
+}
+function isBitmojiUserInfoOrUndefined(value) {
+    return isUndefined(value) || isBitmojiUserInfo(value);
+}
+function isBitmojiUserInfo(value) {
+    return isRecord(value) && isStringOrUndefined(value.avatarId) && isStringOrUndefined(value.selfieId);
+}
+function isFriendUserInfoOrUndefined(value) {
+    return isUndefined(value) || isFriendUserInfo(value);
+}
+function isFriendUserInfo(value) {
+    return (isRecord(value) &&
+        isDateOrUndefined(value.friendshipStart) &&
+        isDateOrUndefined(value.lastInteraction) &&
+        isValidNumberOrUndefined(value.streak));
+}
+function isZodiacOrUndefined(value) {
+    return isUndefined(value) || isZodiac(value);
+}
+function isLensLaunchParamsOrUndefined(value) {
+    return isUndefined(value) || isLensLaunchParams(value);
+}
+function isLensLaunchParams(value) {
+    return isRecord(value) && predicateRecordValues(isStringOrNumberOrArrayOfStringsOrNumbers)(value);
+}
+function isStringOrNumberOrArrayOfStringsOrNumbers(value) {
+    return (isString(value) || isValidNumber(value) || isArrayOfType(isString, value) || isArrayOfType(isValidNumber, value));
+}
+export const encodeLensLaunchData = (launchData, persistentStore) => {
+    var _a;
+    return LaunchData.encode(LaunchData.fromPartial(Object.assign(Object.assign({}, launchData), { userData: launchData.userData
+            ? Object.assign(Object.assign({}, launchData.userData), { zodiac: ((_a = launchData.userData) === null || _a === void 0 ? void 0 : _a.zodiac) ? zodiacMap[launchData.userData.zodiac] : undefined }) : undefined, launchParams: launchData.launchParams ? encodeLensLaunchParams(launchData.launchParams) : undefined, persistentStore: { store: new Uint8Array(persistentStore) } })))
+        .finish()
+        .slice();
+};
+function encodeLensLaunchParams(launchParams) {
+    return { data: new TextEncoder().encode(JSON.stringify(launchParams)) };
+}
+//# sourceMappingURL=LensLaunchData.js.map

package/dist/lens/LensLaunchData.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensLaunchData.js","sourceRoot":"","sources":["../../src/lens/LensLaunchData.ts"],"names":[],"mappings":"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","sourcesContent":["import { LaunchData } from \"../generated-proto/pb_schema/lenses/launchdata\";\nimport {\n    isArrayOfType,\n    isDateOrUndefined,\n    isValidNumberOrUndefined,\n    isRecord,\n    isString,\n    isStringOrUndefined,\n    isUndefined,\n    isValidNumber,\n    predicateRecordValues,\n} from \"../common/typeguards\";\nimport type { LaunchParams } from \"../generated-proto/pb_schema/lenses/launch_params\";\nimport { UserData_Zodiac } from \"../generated-proto/pb_schema/lenses/user_data\";\nimport type { EnumToPublicStringLiteralMap, ExcludeKeys } from \"../common/types\";\n\n/**\n * Lens launch params.\n */\nexport type LensLaunchParams = Record<string, string | number | string[] | number[]>;\n\n/**\n * Some Lenses may accept (or require) certain data provided to them when the Lens is applied.\n *\n * This data may include things like user info (to render the user's name, for example, or perform some task based on\n * their birth date), or arbitrary `launchParams` defined by the Lens.\n *\n * @category Lenses\n */\nexport interface LensLaunchData {\n    userId?: string;\n    userData?: LensUserData;\n    launchParams?: LensLaunchParams;\n}\n\nexport interface LensUserData {\n    userId?: string;\n    username?: string;\n    birthdate?: string;\n    displayName?: string;\n    countrycode?: string;\n    score?: string;\n    bitmojiInfo?: BitmojiUserInfo;\n    friendInfo?: FriendUserInfo;\n    zodiac?: Zodiac;\n}\n\nexport interface BitmojiUserInfo {\n    avatarId?: string;\n    selfieId?: string;\n}\n\nexport interface FriendUserInfo {\n    friendshipStart?: Date;\n    lastInteraction?: Date;\n    streak?: number;\n}\n\n// Extract public values of UserData_Zodiac\nconst zodiacMap: ExcludeKeys<EnumToPublicStringLiteralMap<typeof UserData_Zodiac>, \"invalid\" | \"unrecognized\"> = {\n    aquarius: UserData_Zodiac.Aquarius,\n    aries: UserData_Zodiac.Aries,\n    cancer: UserData_Zodiac.Cancer,\n    capricorn: UserData_Zodiac.Capricorn,\n    gemini: UserData_Zodiac.Gemini,\n    leo: UserData_Zodiac.Leo,\n    libra: UserData_Zodiac.Libra,\n    pisces: UserData_Zodiac.Pisces,\n    sagittarius: UserData_Zodiac.Sagittarius,\n    scorpio: UserData_Zodiac.Scorpio,\n    taurus: UserData_Zodiac.Taurus,\n    virgo: UserData_Zodiac.Virgo,\n    // NOTE: This rule helps keep the public-facing Zodiac type consistent with the proto.\n    // We prefer using a separate type for TypeDoc purposes.\n} satisfies Record<Zodiac, UserData_Zodiac>;\n\nexport type Zodiac =\n    | \"aquarius\"\n    | \"aries\"\n    | \"cancer\"\n    | \"capricorn\"\n    | \"gemini\"\n    | \"leo\"\n    | \"libra\"\n    | \"pisces\"\n    | \"sagittarius\"\n    | \"scorpio\"\n    | \"taurus\"\n    | \"virgo\";\n\nconst zodiacValueSet = new Set(Object.keys(zodiacMap) as Zodiac[]);\n\nexport function isZodiac(value: unknown): value is Zodiac {\n    return zodiacValueSet.has(value as Zodiac);\n}\n\nexport function isLensLaunchDataOrUndefined(value: unknown): value is LensLaunchData | undefined {\n    return isUndefined(value) || isLensLaunchData(value);\n}\n\nfunction isLensLaunchData(value: unknown): value is LensLaunchData {\n    return (\n        isRecord(value) &&\n        isStringOrUndefined(value.userId) &&\n        isLensUserDataOrUndefined(value.userData) &&\n        isLensLaunchParamsOrUndefined(value.launchParams)\n    );\n}\n\nfunction isLensUserDataOrUndefined(value: unknown): value is LensUserData | undefined {\n    return isUndefined(value) || isLensUserData(value);\n}\n\nfunction isLensUserData(value: unknown): value is LensUserData {\n    return (\n        isRecord(value) &&\n        isStringOrUndefined(value.userId) &&\n        isStringOrUndefined(value.username) &&\n        isStringOrUndefined(value.birthdate) &&\n        isStringOrUndefined(value.displayName) &&\n        isStringOrUndefined(value.countrycode) &&\n        isStringOrUndefined(value.score) &&\n        isBitmojiUserInfoOrUndefined(value.bitmojiInfo) &&\n        isFriendUserInfoOrUndefined(value.friendInfo) &&\n        isZodiacOrUndefined(value.zodiac)\n    );\n}\n\nfunction isBitmojiUserInfoOrUndefined(value: unknown): value is BitmojiUserInfo | undefined {\n    return isUndefined(value) || isBitmojiUserInfo(value);\n}\n\nfunction isBitmojiUserInfo(value: unknown): value is BitmojiUserInfo {\n    return isRecord(value) && isStringOrUndefined(value.avatarId) && isStringOrUndefined(value.selfieId);\n}\n\nfunction isFriendUserInfoOrUndefined(value: unknown): value is FriendUserInfo | undefined {\n    return isUndefined(value) || isFriendUserInfo(value);\n}\n\nfunction isFriendUserInfo(value: unknown): value is FriendUserInfo {\n    return (\n        isRecord(value) &&\n        isDateOrUndefined(value.friendshipStart) &&\n        isDateOrUndefined(value.lastInteraction) &&\n        isValidNumberOrUndefined(value.streak)\n    );\n}\n\nfunction isZodiacOrUndefined(value: unknown): value is Zodiac | undefined {\n    return isUndefined(value) || isZodiac(value);\n}\n\nfunction isLensLaunchParamsOrUndefined(value: unknown): value is LensLaunchParams | undefined {\n    return isUndefined(value) || isLensLaunchParams(value);\n}\n\nfunction isLensLaunchParams(value: unknown): value is LensLaunchParams {\n    return isRecord(value) && predicateRecordValues(isStringOrNumberOrArrayOfStringsOrNumbers)(value);\n}\n\nfunction isStringOrNumberOrArrayOfStringsOrNumbers(value: unknown): value is string | number | string[] | number[] {\n    return (\n        isString(value) || isValidNumber(value) || isArrayOfType(isString, value) || isArrayOfType(isValidNumber, value)\n    );\n}\n\n/**\n * @internal\n */\nexport const encodeLensLaunchData = (launchData: LensLaunchData, persistentStore: ArrayBuffer): Uint8Array => {\n    // finish() protobufjs method returns UInt8Array with shared ArrayBuffer\n    // to avoid of detached buffer error when passing data to Lens Core\n    // data should be copied using slice() method\n    return LaunchData.encode(\n        LaunchData.fromPartial({\n            ...launchData,\n            userData: launchData.userData\n                ? {\n                      ...launchData.userData,\n                      zodiac: launchData.userData?.zodiac ? zodiacMap[launchData.userData.zodiac] : undefined,\n                  }\n                : undefined,\n            launchParams: launchData.launchParams ? encodeLensLaunchParams(launchData.launchParams) : undefined,\n            persistentStore: { store: new Uint8Array(persistentStore) },\n        })\n    )\n        .finish()\n        .slice();\n};\n\nfunction encodeLensLaunchParams(launchParams?: LensLaunchParams): LaunchParams {\n    return { data: new TextEncoder().encode(JSON.stringify(launchParams)) };\n}\n"]}

package/dist/lens/LensPersistenceStore.d.ts

@@ -0,0 +1,8 @@
+import { IndexedDBPersistence } from "../persistence/IndexedDBPersistence";
+import type { LensCore } from "../lens-core-module/lensCore";
+export declare const lensPersistenceStoreFactory: {
+    (args_0: LensCore): IndexedDBPersistence<ArrayBuffer>;
+    token: "lensPersistenceStore";
+    dependencies: readonly ["lensCore"];
+};
+//# sourceMappingURL=LensPersistenceStore.d.ts.map

package/dist/lens/LensPersistenceStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensPersistenceStore.d.ts","sourceRoot":"","sources":["../../src/lens/LensPersistenceStore.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAI7D,eAAO,MAAM,2BAA2B;;;;CAcvC,CAAC"}

package/dist/lens/LensPersistenceStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensPersistenceStore.js","sourceRoot":"","sources":["../../src/lens/LensPersistenceStore.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAG7E,MAAM,MAAM,GAAG,SAAS,CAAC,sBAAsB,CAAC,CAAC;AAEjD,MAAM,CAAC,MAAM,2BAA2B,GAAG,UAAU,CACjD,sBAAsB,EACtB,CAAC,eAAe,CAAC,KAAK,CAAU,EAChC,CAAC,QAAkB,EAAqC,EAAE;IACtD,MAAM,EAAE,GAAG,IAAI,oBAAoB,CAAc,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC,CAAC;IAC3F,QAAQ,CAAC,mCAAmC,CAAC,CAAO,EAAE,EAAE,IAAI,EAAE,EAAE;QAC5D,IAAI;YACA,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;SAC5B;QAAC,OAAO,KAAK,EAAE;YACZ,MAAM,CAAC,KAAK,CAAC,oBAAoB,CAAC,8CAA8C,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;SAClG;IACL,CAAC,CAAA,CAAC,CAAC;IACH,OAAO,EAAE,CAAC;AACd,CAAC,CACJ,CAAC","sourcesContent":["import { Injectable } from \"../dependency-injection/Injectable\";\nimport { persistentStoreError } from \"../namedErrors\";\nimport { getLogger } from \"../logger/logger\";\nimport { IndexedDBPersistence } from \"../persistence/IndexedDBPersistence\";\nimport { lensCoreFactory } from \"../lens-core-module/loader/lensCoreFactory\";\nimport type { LensCore } from \"../lens-core-module/lensCore\";\n\nconst logger = getLogger(\"LensPersistenceStore\");\n\nexport const lensPersistenceStoreFactory = Injectable(\n    \"lensPersistenceStore\",\n    [lensCoreFactory.token] as const,\n    (lensCore: LensCore): IndexedDBPersistence<ArrayBuffer> => {\n        const db = new IndexedDBPersistence<ArrayBuffer>({ databaseName: \"lensPersistenceStore\" });\n        lensCore.registerSavePersistentStoreCallback(async (id, data) => {\n            try {\n                await db.store(id, data);\n            } catch (error) {\n                logger.error(persistentStoreError(`Error occurred while storing data for lens ${id}.`, error));\n            }\n        });\n        return db;\n    }\n);\n"]}

package/dist/lens/LensRepository.d.ts

@@ -0,0 +1,133 @@
+import type { FetchHandler } from "../handlers/defaultFetchHandler";
+import type { RequestStateEventTarget } from "../handlers/requestStateEmittingHandler";
+import type { LensDownloadDimensions } from "../metrics/reporters/reportLensAndAssetDownload";
+import type { Handler } from "../handlers/HandlerChainBuilder";
+import type { Lens, LensProtoWithGroupId } from "./Lens";
+import type { LensAssetRepository } from "./assets/LensAssetRepository";
+import type { LensSource } from "./LensSource";
+type LensFetchHandler = Handler<[
+    RequestInfo,
+    LensDownloadDimensions
+], [
+    ArrayBuffer,
+    Response
+], RequestInit | undefined>;
+/**
+ * Lens assets are included in a manifest, and each will indicate when that asset will be used by the lens.
+ *
+ * Assets can have the following timing values:
+ * - `required`: the lens will definitely request this asset immediately when the lens is applied.
+ * - `onDemand`: the lens may request this asset at some time while the lens is applied.
+ *
+ * Depending on the use-case, an application may want to cache both required and onDemand assets for
+ * a particular lens, or may decide to only cache required assets (or cache no assets).
+ *
+ * @category Lenses
+ */
+export type AssetTiming = "required" | "onDemand";
+export interface LensBinary {
+    lensBuffer: ArrayBuffer;
+    lensChecksum: string;
+}
+/**
+ * The LensRepository is used to query for lenses from specific lens groups, or for a lens with a specific ID.
+ *
+ * Lens groups are configured in the CameraKit Portal -- that's where you'll find lens group IDs and lens IDs.
+ *
+ * Lenses must be loaded by the LensRepository before they can be applied to a {@link CameraKitSession}.
+ *
+ * @example
+ * ```ts
+ * const cameraKit = await bootstrapCameraKit(options)
+ * const session = await cameraKit.createSession()
+ * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)
+ * session.applyLens(lens)
+ * ```
+ *
+ * @category Lenses
+ */
+declare class LensRepository {
+    private readonly lensFetchHandler;
+    private readonly lensSources;
+    private readonly lensAssetRepository;
+    private readonly metadataCache;
+    private readonly binariesCache;
+    /** @internal */
+    constructor(lensFetchHandler: LensFetchHandler, lensSources: LensSource[], lensAssetRepository: LensAssetRepository);
+    /**
+     * Retrieve a single Lens.
+     *
+     * @param lensId Desired Lens's unique ID. Can be found in the CameraKit Portal.
+     * @param groupId The ID of a group containing the desired Lens. Can be found in the CameraKit Portal.
+     * @returns Resolves with the desired Lens, or rejects if an error occurred (including a missing Lens).
+     */
+    loadLens(lensId: string, groupId: string): Promise<Lens>;
+    /**
+     * Retrieve the Lenses contained in a list of Lens Groups.
+     *
+     * This may result in multiple requests to retrieve Lens data (e.g. one per desired group). If any constituent
+     * requests fail, those errors will be reported in the response – but the returned Promise will not be rejected. Any
+     * Lenses which could be successfully retrieved will be available in the response.
+     *
+     * @param groupIds A list of Lens Group IDs. Can be found in the CameraKit Portal.
+     * @returns Resolves with a flattened list of all lenses in the desired groups. If any errors occurred during the
+     * query operation, these will be included in a separate list. If errors are present, the list of Lenses may not
+     * contain all the Lenses from the desired groups.
+     */
+    loadLensGroups(groupIds: string[]): Promise<{
+        errors: Error[];
+        lenses: Lens[];
+    }>;
+    /**
+     * Loads and caches lens content and dependencies to reduce latency when {@link CameraKitSession.applyLens} is later
+     * called to apply the lens. This is an in-memory cache, it will not be persisted across page loads.
+     *
+     * This may useful if the application A) knows which lenses will be applied and B) has some opportunity to call
+     * this method before a lens is applied. For example, if the user must perform some other actions before lenses
+     * become active, this might be a good opportunity to cache lenses to improve applyLens latency.
+     *
+     * @example
+     * ```ts
+     * const lens = await cameraKit.lensRepository.loadLens(lensId, groupId)
+     * await cameraKit.lensRepository.cacheLensContent([lens])
+     *
+     * // sometime later -- this call will use the cached lens content, making lens application faster.
+     * await cameraKitSession.applyLens(lens)
+     * ```
+     *
+     * @param lenses Array of lenses to cache in memory.
+     * @param assetTimingsToCache Lenses specify certain required assets that are necessary for the lens to render, and
+     * other assets which may be needed by the lens. By default this method will cache all of those assets, but this
+     * behavior can be modified to only load the required assets, only the "onDemand" assets, or neither (by passing
+     * an empty array).
+     */
+    cacheLensContent(lenses: Lens[], assetTimingsToCache?: AssetTiming[]): Promise<void>;
+    /**
+     * Returns loaded Lens metadata if available.
+     */
+    getLensMetadata(lensId: string): LensProtoWithGroupId | undefined;
+    /**
+     * Removes Lens content from the in-memory cache.
+     */
+    removeCachedLenses(lenses: Lens[]): void;
+    /**
+     * Fetches lens content and assets. This may come from the cache, otherwise network requests will be made.
+     *
+     * @internal
+     *
+     * @param lens Lens to fetch content for.
+     * @param lowPriority Flag indicating if the fetch requests should be treated with lower priority,
+     *                    leveraging browser capabilities to defer or deprioritize network traffic.
+     */
+    getLensContent(lens: Lens, lowPriority?: boolean): Promise<LensBinary>;
+}
+export { LensRepository };
+/**
+ * @internal
+ */
+export declare const lensRepositoryFactory: {
+    (args_0: RequestStateEventTarget, args_1: FetchHandler, args_2: LensSource[], args_3: LensAssetRepository): LensRepository;
+    token: "LensRepository";
+    dependencies: readonly ["requestStateEventTarget", "defaultFetchHandler", "lensSources", "lensAssetRepository"];
+};
+//# sourceMappingURL=LensRepository.d.ts.map

package/dist/lens/LensRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensRepository.d.ts","sourceRoot":"","sources":["../../src/lens/LensRepository.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AAKvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAC;AAS/D,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAExE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK/C,KAAK,gBAAgB,GAAG,OAAO,CAC3B;IAAC,WAAW;IAAE,sBAAsB;CAAC,EACrC;IAAC,WAAW;IAAE,QAAQ;CAAC,EACvB,WAAW,GAAG,SAAS,CAC1B,CAAC;AAoBF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;AAElD,MAAM,WAAW,UAAU;IACvB,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,cAAM,cAAc;IAMZ,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IAPxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA2C;IACzE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAEhE,gBAAgB;gBAEK,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,UAAU,EAAE,EACzB,mBAAmB,EAAE,mBAAmB;IAG7D;;;;;;OAMG;IAGG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9D;;;;;;;;;;;OAWG;IAGG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAC9C,MAAM,EAAE,KAAK,EAAE,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,CAAC;KAClB,CAAC;IA2BF;;;;;;;;;;;;;;;;;;;;;;OAsBG;IAGG,gBAAgB,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,mBAAmB,GAAE,WAAW,EAA6B;IAiBpG;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIjE;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE;IAIjC;;;;;;;;OAQG;IACG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,GAAE,OAAe,GAAG,OAAO,CAAC,UAAU,CAAC;CAwBtF;AAGD,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;;CAoBjC,CAAC"}

package/dist/lens/LensRepository.js

@@ -0,0 +1,147 @@
+import { __awaiter, __esDecorate, __runInitializers } from "tslib";
+import { validate } from "../common/validate";
+import { isArrayOfType, isSafeString, isSafeStringArray, isString, isUndefined } from "../common/typeguards";
+import { Injectable } from "../dependency-injection/Injectable";
+import { defaultFetchHandlerFactory } from "../handlers/defaultFetchHandler";
+import { createRequestStateEmittingHandler, requestStateEventTargetFactory, } from "../handlers/requestStateEmittingHandler";
+import { HandlerChainBuilder } from "../handlers/HandlerChainBuilder";
+import { createArrayBufferParsingHandler } from "../handlers/arrayBufferParsingHandler";
+import { LensAssetManifestItem_RequestTiming } from "../generated-proto/pb_schema/camera_kit/v3/lens";
+import { getLogger } from "../logger/logger";
+import { errorLoggingDecorator } from "../logger/errorLoggingDecorator";
+import { ensureError } from "../common/errorHelpers";
+import { withRequestPriority } from "../handlers/utils";
+import { isLensArray, toPublicLens } from "./Lens";
+import { lensAssetRepositoryFactory } from "./assets/LensAssetRepository";
+import { loadLensesFromSources, lensSourcesFactory } from "./LensSource";
+const logger = getLogger("LensRepository");
+const assetTimingMap = {
+    required: LensAssetManifestItem_RequestTiming.REQUIRED,
+    onDemand: LensAssetManifestItem_RequestTiming.ON_DEMAND,
+};
+function isAssetTiming(value) {
+    return isString(value) && assetTimingMap.hasOwnProperty(value);
+}
+function isAssetTimingArrayOrUndefined(value) {
+    return isUndefined(value) || isArrayOfType(isAssetTiming, value);
+}
+let LensRepository = (() => {
+    var _a;
+    let _instanceExtraInitializers = [];
+    let _loadLens_decorators;
+    let _loadLensGroups_decorators;
+    let _cacheLensContent_decorators;
+    return _a = class LensRepository {
+            constructor(lensFetchHandler, lensSources, lensAssetRepository) {
+                this.lensFetchHandler = (__runInitializers(this, _instanceExtraInitializers), lensFetchHandler);
+                this.lensSources = lensSources;
+                this.lensAssetRepository = lensAssetRepository;
+                this.metadataCache = new Map();
+                this.binariesCache = new Map();
+            }
+            loadLens(lensId, groupId) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const lens = (yield loadLensesFromSources(this.lensSources, groupId, lensId))[0];
+                    if (!lens) {
+                        throw new Error(`Cannot load lens. No lens with id ${lensId} was found in lens group ${groupId}.`);
+                    }
+                    const lensWithGroup = Object.assign(Object.assign({}, lens), { groupId });
+                    this.metadataCache.set(lens.id, lensWithGroup);
+                    return toPublicLens(lensWithGroup);
+                });
+            }
+            loadLensGroups(groupIds) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const responses = yield Promise.all(groupIds.map((groupId) => __awaiter(this, void 0, void 0, function* () {
+                        try {
+                            return (yield loadLensesFromSources(this.lensSources, groupId)).map((lens) => {
+                                const lensWithGroup = Object.assign(Object.assign({}, lens), { groupId });
+                                this.metadataCache.set(lens.id, lensWithGroup);
+                                return toPublicLens(lensWithGroup);
+                            });
+                        }
+                        catch (e) {
+                            const error = ensureError(e);
+                            logger.error(new Error(`Failed to load lens group ${groupId}.`, { cause: error }));
+                            return error;
+                        }
+                    })));
+                    return responses.reduce((result, response) => {
+                        if (response instanceof Error)
+                            result.errors.push(response);
+                        else
+                            result.lenses.push(...response);
+                        return result;
+                    }, { errors: [], lenses: [] });
+                });
+            }
+            cacheLensContent(lenses, assetTimingsToCache = ["required", "onDemand"]) {
+                return __awaiter(this, void 0, void 0, function* () {
+                    const assetTimingsToLoad = assetTimingsToCache.map((timing) => assetTimingMap[timing]);
+                    yield Promise.all(lenses.map((lens) => __awaiter(this, void 0, void 0, function* () {
+                        try {
+                            const { lensBuffer } = yield this.getLensContent(lens, true);
+                            const { content } = this.metadataCache.get(lens.id);
+                            this.binariesCache.set(lens.id, lensBuffer);
+                            yield this.lensAssetRepository.cacheAssets(content.assetManifest, lens, assetTimingsToLoad, true);
+                        }
+                        catch (error) {
+                            logger.warn(`Failed to cache lens ${lens.id}.`, error);
+                        }
+                    })));
+                });
+            }
+            getLensMetadata(lensId) {
+                return this.metadataCache.get(lensId);
+            }
+            removeCachedLenses(lenses) {
+                lenses.forEach((lens) => this.binariesCache.delete(lens.id));
+            }
+            getLensContent(lens, lowPriority = false) {
+                var _a;
+                return __awaiter(this, void 0, void 0, function* () {
+                    const { content } = (_a = this.metadataCache.get(lens.id)) !== null && _a !== void 0 ? _a : {};
+                    if (!content) {
+                        throw new Error(`Cannot find metadata for lens ${lens.id}.`);
+                    }
+                    const cachedLensBuffer = this.binariesCache.get(lens.id);
+                    if (cachedLensBuffer) {
+                        return {
+                            lensBuffer: cachedLensBuffer,
+                            lensChecksum: content.lnsSha256,
+                        };
+                    }
+                    const [lensBuffer] = yield this.lensFetchHandler([
+                        new Request(content.lnsUrlBolt, withRequestPriority({ cache: "force-cache" }, lowPriority)),
+                        {
+                            requestType: "lens_content",
+                            lensId: lens.id,
+                        },
+                    ]);
+                    return { lensBuffer, lensChecksum: content.lnsSha256 };
+                });
+            }
+        },
+        (() => {
+            _loadLens_decorators = [validate(isSafeString, isSafeString), errorLoggingDecorator(logger)];
+            _loadLensGroups_decorators = [validate(isSafeStringArray), errorLoggingDecorator(logger)];
+            _cacheLensContent_decorators = [validate(isLensArray, isAssetTimingArrayOrUndefined), errorLoggingDecorator(logger)];
+            __esDecorate(_a, null, _loadLens_decorators, { kind: "method", name: "loadLens", static: false, private: false, access: { has: obj => "loadLens" in obj, get: obj => obj.loadLens } }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _loadLensGroups_decorators, { kind: "method", name: "loadLensGroups", static: false, private: false, access: { has: obj => "loadLensGroups" in obj, get: obj => obj.loadLensGroups } }, null, _instanceExtraInitializers);
+            __esDecorate(_a, null, _cacheLensContent_decorators, { kind: "method", name: "cacheLensContent", static: false, private: false, access: { has: obj => "cacheLensContent" in obj, get: obj => obj.cacheLensContent } }, null, _instanceExtraInitializers);
+        })(),
+        _a;
+})();
+export { LensRepository };
+export const lensRepositoryFactory = Injectable("LensRepository", [
+    requestStateEventTargetFactory.token,
+    defaultFetchHandlerFactory.token,
+    lensSourcesFactory.token,
+    lensAssetRepositoryFactory.token,
+], (requestStateEventTarget, defaultFetchHandler, lensSources, lensAssetRepository) => {
+    const lensFetchHandler = new HandlerChainBuilder(defaultFetchHandler)
+        .map(createRequestStateEmittingHandler(requestStateEventTarget))
+        .map(createArrayBufferParsingHandler()).handler;
+    return new LensRepository(lensFetchHandler, lensSources, lensAssetRepository);
+});
+//# sourceMappingURL=LensRepository.js.map

package/dist/lens/LensRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensRepository.js","sourceRoot":"","sources":["../../src/lens/LensRepository.ts"],"names":[],"mappings":"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","sourcesContent":["import { validate } from \"../common/validate\";\nimport { isArrayOfType, isSafeString, isSafeStringArray, isString, isUndefined } from \"../common/typeguards\";\nimport { Injectable } from \"../dependency-injection/Injectable\";\nimport type { FetchHandler } from \"../handlers/defaultFetchHandler\";\nimport { defaultFetchHandlerFactory } from \"../handlers/defaultFetchHandler\";\nimport type { RequestStateEventTarget } from \"../handlers/requestStateEmittingHandler\";\nimport {\n    createRequestStateEmittingHandler,\n    requestStateEventTargetFactory,\n} from \"../handlers/requestStateEmittingHandler\";\nimport type { LensDownloadDimensions } from \"../metrics/reporters/reportLensAndAssetDownload\";\nimport type { Handler } from \"../handlers/HandlerChainBuilder\";\nimport { 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 { ensureError } from \"../common/errorHelpers\";\nimport { withRequestPriority } from \"../handlers/utils\";\nimport type { EnumToPublicStringLiteralMap, ExcludeKeys } from \"../common/types\";\nimport type { Lens, LensProtoWithGroupId } from \"./Lens\";\nimport { isLensArray, toPublicLens } from \"./Lens\";\nimport type { LensAssetRepository } from \"./assets/LensAssetRepository\";\nimport { lensAssetRepositoryFactory } from \"./assets/LensAssetRepository\";\nimport type { LensSource } from \"./LensSource\";\nimport { loadLensesFromSources, lensSourcesFactory } from \"./LensSource\";\n\nconst logger = getLogger(\"LensRepository\");\n\ntype LensFetchHandler = Handler<\n    [RequestInfo, LensDownloadDimensions],\n    [ArrayBuffer, Response],\n    RequestInit | undefined\n>;\n\nconst assetTimingMap: ExcludeKeys<\n    EnumToPublicStringLiteralMap<typeof LensAssetManifestItem_RequestTiming>,\n    \"preloadUnset\" | \"unrecognized\"\n> = {\n    required: LensAssetManifestItem_RequestTiming.REQUIRED,\n    onDemand: LensAssetManifestItem_RequestTiming.ON_DEMAND,\n    // NOTE: This rule helps keep the public-facing AssetTiming type consistent with the proto.\n    // We prefer using a separate type for TypeDoc purposes.\n} satisfies Record<AssetTiming, LensAssetManifestItem_RequestTiming>;\n\nfunction isAssetTiming(value: unknown): value is AssetTiming {\n    return isString(value) && assetTimingMap.hasOwnProperty(value);\n}\n\nfunction isAssetTimingArrayOrUndefined(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 = \"required\" | \"onDemand\";\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 */\nclass LensRepository {\n    private readonly metadataCache = new Map<string, LensProtoWithGroupId>();\n    private readonly binariesCache = new Map<string, ArrayBuffer>();\n\n    /** @internal */\n    constructor(\n        private readonly lensFetchHandler: LensFetchHandler,\n        private readonly lensSources: LensSource[],\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(isSafeString, isSafeString)\n    @errorLoggingDecorator(logger)\n    async loadLens(lensId: string, groupId: string): Promise<Lens> {\n        const lens = (await loadLensesFromSources(this.lensSources, groupId, lensId))[0];\n        if (!lens) {\n            throw new Error(`Cannot load lens. No lens with id ${lensId} was found in lens group ${groupId}.`);\n        }\n        const lensWithGroup: LensProtoWithGroupId = { ...lens, groupId };\n        this.metadataCache.set(lens.id, lensWithGroup);\n        return toPublicLens(lensWithGroup);\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(isSafeStringArray)\n    @errorLoggingDecorator(logger)\n    async loadLensGroups(groupIds: string[]): Promise<{\n        errors: Error[];\n        lenses: Lens[];\n    }> {\n        const responses = await Promise.all(\n            groupIds.map(async (groupId) => {\n                try {\n                    return (await loadLensesFromSources(this.lensSources, groupId)).map((lens) => {\n                        const lensWithGroup = { ...lens, groupId };\n                        this.metadataCache.set(lens.id, lensWithGroup);\n                        return toPublicLens(lensWithGroup);\n                    });\n                } catch (e) {\n                    const error = ensureError(e);\n                    logger.error(new Error(`Failed to load lens group ${groupId}.`, { cause: error }));\n                    return error;\n                }\n            })\n        );\n\n        return responses.reduce(\n            (result, response) => {\n                if (response instanceof Error) result.errors.push(response);\n                else result.lenses.push(...response);\n                return result;\n            },\n            { errors: [], lenses: [] } as { errors: Error[]; lenses: Lens[] }\n        );\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(isLensArray, isAssetTimingArrayOrUndefined)\n    @errorLoggingDecorator(logger)\n    async cacheLensContent(lenses: Lens[], assetTimingsToCache: AssetTiming[] = [\"required\", \"onDemand\"]) {\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, true);\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, true);\n                } catch (error) {\n                    logger.warn(`Failed to cache lens ${lens.id}.`, error);\n                }\n            })\n        );\n    }\n\n    /**\n     * Returns loaded Lens metadata if available.\n     */\n    getLensMetadata(lensId: string): LensProtoWithGroupId | 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     * @param lens Lens to fetch content for.\n     * @param lowPriority Flag indicating if the fetch requests should be treated with lower priority,\n     *                    leveraging browser capabilities to defer or deprioritize network traffic.\n     */\n    async getLensContent(lens: Lens, lowPriority: boolean = false): 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        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, withRequestPriority({ cache: \"force-cache\" }, lowPriority)),\n            {\n                requestType: \"lens_content\",\n                lensId: lens.id,\n            },\n        ]);\n        return { lensBuffer, lensChecksum: content.lnsSha256 };\n    }\n}\n\n// NOTE: jest doesn't like default exports of classes with decorated methods.\nexport { LensRepository };\n\n/**\n * @internal\n */\nexport const lensRepositoryFactory = Injectable(\n    \"LensRepository\",\n    [\n        requestStateEventTargetFactory.token,\n        defaultFetchHandlerFactory.token,\n        lensSourcesFactory.token,\n        lensAssetRepositoryFactory.token,\n    ] as const,\n    (\n        requestStateEventTarget: RequestStateEventTarget,\n        defaultFetchHandler: FetchHandler,\n        lensSources: LensSource[],\n        lensAssetRepository: LensAssetRepository\n    ) => {\n        const lensFetchHandler = new HandlerChainBuilder(defaultFetchHandler)\n            .map(createRequestStateEmittingHandler<LensDownloadDimensions>(requestStateEventTarget))\n            .map(createArrayBufferParsingHandler()).handler;\n\n        return new LensRepository(lensFetchHandler, lensSources, lensAssetRepository);\n    }\n);\n"]}

package/dist/lens/LensSource.d.ts

@@ -0,0 +1,44 @@
+import type { Lens } from "../generated-proto/pb_schema/camera_kit/v3/lens";
+/**
+ * Provides Lens metadata for one or more Lens groups.
+ *
+ * When a Lens or Lens group is requested via the {@link LensRepository}, CameraKit will find the LensSource which
+ * claims ownership of that group. The appropriate LensSource method will be called and must return an ArrayBuffer
+ * containing the encoded Lens metadata -- this can be obtained from a CameraKit backend API.
+ */
+export interface LensSource {
+    isGroupOwner(groupId: string): boolean;
+    loadLens(lensId: string, groupId: string): Promise<ArrayBuffer>;
+    loadLensGroup(groupId: string): Promise<ArrayBuffer>;
+}
+/**
+ * By default, no custom {@link LensSource} is provided to CameraKit. But to enable certain advanced use-cases,
+ * applications may provide their own {@link LensSource}.
+ *
+ * Perhaps the most convenient way to do this is with {@link ConcatInjectable}, as shown here:
+ *
+ * @example
+ * ```ts
+ * import { bootstrapCameraKit, lensSourcesFactory, LensSource } from '@snap/camera-kit'
+ *
+ * const cameraKit = bootstrapCameraKit(config, (container) => {
+ *   return container.provides(ConcatInjectable(
+ *     lensSourcesFactory.token,
+ *     (): LensSource => { return ... }
+ *   ))
+ * })
+ * ```
+ */
+export declare const lensSourcesFactory: {
+    (): LensSource[];
+    token: "lensSources";
+    dependencies: [];
+};
+/**
+ * Given a list of LensSources (like the one provided by CameraKit's DI container under the `'lensSources'` token), and
+ * a groupId/lensId, return a list of lenses loaded by the first LensSource claiming ownership of the given groupId.
+ *
+ * @internal
+ */
+export declare function loadLensesFromSources(sources: LensSource[], groupId: string, lensId?: string): Promise<Lens[]>;
+//# sourceMappingURL=LensSource.d.ts.map

package/dist/lens/LensSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensSource.d.ts","sourceRoot":"","sources":["../../src/lens/LensSource.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iDAAiD,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACvB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAChE,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB;;;;CAAoD,CAAC;AAEpF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAcpH"}

package/dist/lens/LensSource.js

@@ -0,0 +1,18 @@
+import { __awaiter } from "tslib";
+import { Injectable } from "../dependency-injection/Injectable";
+import { Envelope } from "../generated-proto/pb_schema/camera_kit/v3/export";
+export const lensSourcesFactory = Injectable("lensSources", () => []);
+export function loadLensesFromSources(sources, groupId, lensId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const source = sources.find((source) => source.isGroupOwner(groupId));
+        if (!source) {
+            throw new Error(`Cannot load lens ${lensId ? `${lensId} from ` : ""}group ${groupId}. ` +
+                `No LensSource claimed ownership of that lens group.`);
+        }
+        const envelope = lensId === undefined ? yield source.loadLensGroup(groupId) : yield source.loadLens(lensId, groupId);
+        return envelope instanceof ArrayBuffer || ArrayBuffer.isView(envelope)
+            ? Envelope.decode(envelope instanceof Uint8Array ? envelope : new Uint8Array(envelope)).lenses
+            : [];
+    });
+}
+//# sourceMappingURL=LensSource.js.map

package/dist/lens/LensSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensSource.js","sourceRoot":"","sources":["../../src/lens/LensSource.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,mDAAmD,CAAC;AAkC7E,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,aAAa,EAAE,GAAiB,EAAE,CAAC,EAAE,CAAC,CAAC;AAQpF,MAAM,UAAgB,qBAAqB,CAAC,OAAqB,EAAE,OAAe,EAAE,MAAe;;QAC/F,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,EAAE;YACT,MAAM,IAAI,KAAK,CACX,oBAAoB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,QAAQ,CAAC,CAAC,CAAC,EAAE,SAAS,OAAO,IAAI;gBACnE,qDAAqD,CAC5D,CAAC;SACL;QACD,MAAM,QAAQ,GACV,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAExG,OAAO,QAAQ,YAAY,WAAW,IAAI,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,YAAY,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM;YAC9F,CAAC,CAAC,EAAE,CAAC;IACb,CAAC;CAAA","sourcesContent":["import { Injectable } from \"../dependency-injection/Injectable\";\nimport { Envelope } from \"../generated-proto/pb_schema/camera_kit/v3/export\";\nimport type { Lens } from \"../generated-proto/pb_schema/camera_kit/v3/lens\";\n\n/**\n * Provides Lens metadata for one or more Lens groups.\n *\n * When a Lens or Lens group is requested via the {@link LensRepository}, CameraKit will find the LensSource which\n * claims ownership of that group. The appropriate LensSource method will be called and must return an ArrayBuffer\n * containing the encoded Lens metadata -- this can be obtained from a CameraKit backend API.\n */\nexport interface LensSource {\n    isGroupOwner(groupId: string): boolean;\n    loadLens(lensId: string, groupId: string): Promise<ArrayBuffer>;\n    loadLensGroup(groupId: string): Promise<ArrayBuffer>;\n}\n\n/**\n * By default, no custom {@link LensSource} is provided to CameraKit. But to enable certain advanced use-cases,\n * applications may provide their own {@link LensSource}.\n *\n * Perhaps the most convenient way to do this is with {@link ConcatInjectable}, as shown here:\n *\n * @example\n * ```ts\n * import { bootstrapCameraKit, lensSourcesFactory, LensSource } from '@snap/camera-kit'\n *\n * const cameraKit = bootstrapCameraKit(config, (container) => {\n *   return container.provides(ConcatInjectable(\n *     lensSourcesFactory.token,\n *     (): LensSource => { return ... }\n *   ))\n * })\n * ```\n */\nexport const lensSourcesFactory = Injectable(\"lensSources\", (): LensSource[] => []);\n\n/**\n * Given a list of LensSources (like the one provided by CameraKit's DI container under the `'lensSources'` token), and\n * a groupId/lensId, return a list of lenses loaded by the first LensSource claiming ownership of the given groupId.\n *\n * @internal\n */\nexport async function loadLensesFromSources(sources: LensSource[], groupId: string, lensId?: string): Promise<Lens[]> {\n    const source = sources.find((source) => source.isGroupOwner(groupId));\n    if (!source) {\n        throw new Error(\n            `Cannot load lens ${lensId ? `${lensId} from ` : \"\"}group ${groupId}. ` +\n                `No LensSource claimed ownership of that lens group.`\n        );\n    }\n    const envelope =\n        lensId === undefined ? await source.loadLensGroup(groupId) : await source.loadLens(lensId, groupId);\n\n    return envelope instanceof ArrayBuffer || ArrayBuffer.isView(envelope)\n        ? Envelope.decode(envelope instanceof Uint8Array ? envelope : new Uint8Array(envelope)).lenses\n        : [];\n}\n"]}