@snap/camera-kit 0.13.2 → 0.14.1

package/lib/lens-core-module/index.js

@@ -1,3 +1,4 @@
 export * from "./loader";
 export * from "./generated-types";
+export * from "./lensCore";
 //# sourceMappingURL=index.js.map

package/lib/lens-core-module/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lens-core-module/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC","sourcesContent":["export * from \"./loader\";\nexport * from \"./generated-types\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lens-core-module/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC","sourcesContent":["export * from \"./loader\";\nexport * from \"./generated-types\";\nexport * from \"./lensCore\";\n"]}

package/lib/lens-core-module/lensCore.d.ts

@@ -0,0 +1,41 @@
+import { DefaultErrorHandler, DefaultEventHandler, LensCoreModule } from "./generated-types";
+import { LensCoreError } from "./lensCoreError";
+type SafeOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;
+/**
+ * LensCore methods that require additional handling.
+ */
+type LensCoreCustomMethods = {
+    initialize(input: PromisifiedParam<MapParamErrorCallback<"initialize", "exceptionHandler">>): Promise<void>;
+    provideRemoteAssetsResponse(input: MapParamErrorCallback<"provideRemoteAssetsResponse", "onFailure">): void;
+};
+type LensCoreCustomMethodNames = keyof LensCoreCustomMethods extends keyof LensCoreModule ? keyof LensCoreCustomMethods : never;
+type PropertyKinds = "enum" | "sync method" | "promisifiable method" | "custom method";
+type LensCorePropertyKinds = {
+    [K in keyof LensCoreModule]: LensCoreModule[K] extends (...args: any[]) => any ? K extends LensCoreCustomMethodNames ? "custom method" : Parameters<LensCoreModule[K]>[0] extends {
+        onSuccess?: DefaultEventHandler;
+        onFailuer?: DefaultErrorHandler;
+    } ? "promisifiable method" : "sync method" : "enum";
+};
+type PropertiesOfKind<T extends PropertyKinds> = Exclude<{
+    [K in keyof LensCorePropertyKinds]: LensCorePropertyKinds[K] extends T ? K : never;
+}[keyof LensCorePropertyKinds], undefined>;
+type FirstParameter<T> = T extends (first: infer P, ...rest: any[]) => any ? P : never;
+type LensCoreEnums = Pick<LensCoreModule, PropertiesOfKind<"enum">>;
+type LensCoreSyncMethods = Pick<LensCoreModule, PropertiesOfKind<"sync method">>;
+type LensCorePromisifiedMethods = {
+    [K in PropertiesOfKind<"promisifiable method">]: K extends keyof LensCoreModule ? keyof SafeOmit<Parameters<LensCoreModule[K]>[0], "onSuccess" | "onFailure"> extends never ? () => Promise<FirstParameter<Parameters<LensCoreModule[K]>[0]["onSuccess"]>> : (input: SafeOmit<Parameters<LensCoreModule[K]>[0], "onSuccess" | "onFailure">) => Promise<FirstParameter<Parameters<LensCoreModule[K]>[0]["onSuccess"]>> : never;
+};
+type PromisifiedParam<T extends {
+    onSuccess?: DefaultEventHandler;
+    onFailure?: DefaultErrorHandler;
+}> = {
+    [P in keyof T as P extends "onSuccess" | "onFailure" ? never : P]: T[P];
+};
+type MapParamErrorCallback<T extends PropertiesOfKind<"custom method">, U extends keyof LensCoreMethodFirstParam<T>> = MapErrorCallback<LensCoreMethodFirstParam<T>, U>;
+type LensCoreMethodFirstParam<T extends PropertiesOfKind<"custom method">> = Parameters<LensCoreModule[T]>[0];
+type MapErrorCallback<T, U extends keyof T> = {
+    [P in keyof T]: P extends U ? (err: LensCoreError) => void : T[P];
+};
+export type LensCore = LensCoreEnums & LensCoreSyncMethods & LensCorePromisifiedMethods & LensCoreCustomMethods;
+export declare const createLensCore: (lensCoreModule: LensCoreModule) => LensCore;
+export {};

package/lib/lens-core-module/lensCore.js

@@ -0,0 +1,54 @@
+import { wrapLensCoreError } from "./lensCoreError";
+// By using PropertiesOfKind, we can ensure a compile-time error if LensCoreModule adds a new async method,
+// but we forget to update this list.
+const promisifiableMethods = {
+    addLens: null,
+    clearAllLenses: null,
+    imageToYuvBuffer: null,
+    pauseCanvas: null,
+    playCanvas: null,
+    processAudioSampleBuffer: null,
+    processFrame: null,
+    removeLens: null,
+    replaceLenses: null,
+    setAudioParameters: null,
+    setDeviceClass: null,
+    setFPSLimit: null,
+    setInputTransform: null,
+    setOnFrameProcessedCallback: null,
+    setRenderLoopMode: null,
+    setRenderSize: null,
+    teardown: null,
+    useMediaElement: null,
+    yuvBufferToBitmap: null,
+};
+export const createLensCore = (lensCoreModule) => {
+    const customMethods = {
+        initialize(input) {
+            return new Promise((onSuccess, onFailure) => lensCoreModule.initialize(Object.assign(Object.assign({}, input), { exceptionHandler: input.exceptionHandler && wrapLensCoreError(input.exceptionHandler), onSuccess, onFailure: wrapLensCoreError(onFailure) })));
+        },
+        provideRemoteAssetsResponse(input) {
+            return lensCoreModule.provideRemoteAssetsResponse(Object.assign(Object.assign({}, input), { onFailure: input.onFailure && wrapLensCoreError(input.onFailure) }));
+        },
+    };
+    return new Proxy(lensCoreModule, {
+        get: (target, property, receiver) => {
+            // Handle special methods with custom implementations
+            if (property in customMethods) {
+                // Safety: "in" operator above ensures that property is keyof LensCoreCustomMethods
+                return customMethods[property];
+            }
+            // All other async methods return Promises
+            if (property in promisifiableMethods) {
+                const method = Reflect.get(target, property, receiver);
+                if (!method)
+                    method;
+                return (input) => new Promise((onSuccess, onFailure) => method(Object.assign(Object.assign({}, input), { onSuccess, onFailure: wrapLensCoreError(onFailure) })));
+            }
+            // All other kinds of properties (enums, sync methods) are unmodified.
+            return Reflect.get(target, property, receiver);
+        },
+        // Safety: We ensured safety by defining types for both custom and promisifiable methods.
+    });
+};
+//# sourceMappingURL=lensCore.js.map

package/lib/lens-core-module/lensCore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lensCore.js","sourceRoot":"","sources":["../../src/lens-core-module/lensCore.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAoEnE,2GAA2G;AAC3G,qCAAqC;AACrC,MAAM,oBAAoB,GAA8D;IACpF,OAAO,EAAE,IAAI;IACb,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,IAAI;IAChB,wBAAwB,EAAE,IAAI;IAC9B,YAAY,EAAE,IAAI;IAClB,UAAU,EAAE,IAAI;IAChB,aAAa,EAAE,IAAI;IACnB,kBAAkB,EAAE,IAAI;IACxB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,IAAI;IACjB,iBAAiB,EAAE,IAAI;IACvB,2BAA2B,EAAE,IAAI;IACjC,iBAAiB,EAAE,IAAI;IACvB,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,IAAI;CAC1B,CAAC;AAIF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,cAA8B,EAAY,EAAE;IACvE,MAAM,aAAa,GAA0B;QACzC,UAAU,CAAC,KAAK;YACZ,OAAO,IAAI,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACxC,cAAc,CAAC,UAAU,iCAClB,KAAK,KACR,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,IAAI,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,CAAC,EACrF,SAAS,EACT,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC,IACzC,CACL,CAAC;QACN,CAAC;QAED,2BAA2B,CAAC,KAAK;YAC7B,OAAO,cAAc,CAAC,2BAA2B,iCAC1C,KAAK,KACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,iBAAiB,CAAC,KAAK,CAAC,SAAS,CAAC,IAClE,CAAC;QACP,CAAC;KACJ,CAAC;IAEF,OAAO,IAAI,KAAK,CAAC,cAAc,EAAE;QAC7B,GAAG,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE;YAChC,qDAAqD;YACrD,IAAI,QAAQ,IAAI,aAAa,EAAE;gBAC3B,mFAAmF;gBACnF,OAAO,aAAa,CAAC,QAAuC,CAAC,CAAC;aACjE;YAED,0CAA0C;YAC1C,IAAI,QAAQ,IAAI,oBAAoB,EAAE;gBAClC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACvD,IAAI,CAAC,MAAM;oBAAE,MAAM,CAAC;gBACpB,OAAO,CAAC,KAAkF,EAAE,EAAE,CAC1F,IAAI,OAAO,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,CACjC,MAAM,iCACC,KAAK,KACR,SAAS,EACT,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC,IACzC,CACL,CAAC;aACT;YAED,sEAAsE;YACtE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC;QACD,yFAAyF;KAC5F,CAAa,CAAC;AACnB,CAAC,CAAC","sourcesContent":["import { DefaultErrorHandler, DefaultEventHandler, LensCoreModule } from \"./generated-types\";\nimport { LensCoreError, wrapLensCoreError } from \"./lensCoreError\";\n\n// Note: While this looks similar to Omit, Omit breaks discriminated unions:\n// https://github.com/microsoft/TypeScript/issues/31501\n// This is relevant in the case of setRenderMode().\ntype SafeOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;\n\n/**\n * LensCore methods that require additional handling.\n */\ntype LensCoreCustomMethods = {\n    // initialize() param has exceptionHandler, which requires error mapping.\n    initialize(input: PromisifiedParam<MapParamErrorCallback<\"initialize\", \"exceptionHandler\">>): Promise<void>;\n\n    // provideRemoteAssetsResponse() param has onFailure, which requires error mapping.\n    provideRemoteAssetsResponse(input: MapParamErrorCallback<\"provideRemoteAssetsResponse\", \"onFailure\">): void;\n};\n\n// Ensure method names defined in CustomLensCoreMethods are the ones that exist in LensCoreModule.\ntype LensCoreCustomMethodNames = keyof LensCoreCustomMethods extends keyof LensCoreModule\n    ? keyof LensCoreCustomMethods\n    : never;\n\ntype PropertyKinds = \"enum\" | \"sync method\" | \"promisifiable method\" | \"custom method\";\n\n// Create a mapping between property keys and the kind of property it is (enum, sync method, or async method)\ntype LensCorePropertyKinds = {\n    [K in keyof LensCoreModule]: LensCoreModule[K] extends (...args: any[]) => any\n        ? K extends LensCoreCustomMethodNames\n            ? \"custom method\"\n            : Parameters<LensCoreModule[K]>[0] extends {\n                  onSuccess?: DefaultEventHandler;\n                  onFailuer?: DefaultErrorHandler;\n              }\n            ? \"promisifiable method\"\n            : \"sync method\"\n        : \"enum\";\n};\n\n// Helper to select LensCoreModule properties of a particular kind.\ntype PropertiesOfKind<T extends PropertyKinds> = Exclude<\n    {\n        [K in keyof LensCorePropertyKinds]: LensCorePropertyKinds[K] extends T ? K : never;\n    }[keyof LensCorePropertyKinds],\n    undefined\n>;\ntype FirstParameter<T> = T extends (first: infer P, ...rest: any[]) => any ? P : never;\ntype LensCoreEnums = Pick<LensCoreModule, PropertiesOfKind<\"enum\">>;\ntype LensCoreSyncMethods = Pick<LensCoreModule, PropertiesOfKind<\"sync method\">>;\ntype LensCorePromisifiedMethods = {\n    [K in PropertiesOfKind<\"promisifiable method\">]: K extends keyof LensCoreModule\n        ? keyof SafeOmit<Parameters<LensCoreModule[K]>[0], \"onSuccess\" | \"onFailure\"> extends never\n            ? () => Promise<FirstParameter<Parameters<LensCoreModule[K]>[0][\"onSuccess\"]>>\n            : (\n                  input: SafeOmit<Parameters<LensCoreModule[K]>[0], \"onSuccess\" | \"onFailure\">\n              ) => Promise<FirstParameter<Parameters<LensCoreModule[K]>[0][\"onSuccess\"]>>\n        : never;\n};\ntype PromisifiedParam<T extends { onSuccess?: DefaultEventHandler; onFailure?: DefaultErrorHandler }> = {\n    [P in keyof T as P extends \"onSuccess\" | \"onFailure\" ? never : P]: T[P];\n};\ntype MapParamErrorCallback<\n    T extends PropertiesOfKind<\"custom method\">,\n    U extends keyof LensCoreMethodFirstParam<T>\n> = MapErrorCallback<LensCoreMethodFirstParam<T>, U>;\ntype LensCoreMethodFirstParam<T extends PropertiesOfKind<\"custom method\">> = Parameters<LensCoreModule[T]>[0];\ntype MapErrorCallback<T, U extends keyof T> = { [P in keyof T]: P extends U ? (err: LensCoreError) => void : T[P] };\n\n// By using PropertiesOfKind, we can ensure a compile-time error if LensCoreModule adds a new async method,\n// but we forget to update this list.\nconst promisifiableMethods: { [K in PropertiesOfKind<\"promisifiable method\">]: null } = {\n    addLens: null,\n    clearAllLenses: null,\n    imageToYuvBuffer: null,\n    pauseCanvas: null,\n    playCanvas: null,\n    processAudioSampleBuffer: null,\n    processFrame: null,\n    removeLens: null,\n    replaceLenses: null,\n    setAudioParameters: null,\n    setDeviceClass: null,\n    setFPSLimit: null,\n    setInputTransform: null,\n    setOnFrameProcessedCallback: null,\n    setRenderLoopMode: null,\n    setRenderSize: null,\n    teardown: null,\n    useMediaElement: null,\n    yuvBufferToBitmap: null,\n};\n\nexport type LensCore = LensCoreEnums & LensCoreSyncMethods & LensCorePromisifiedMethods & LensCoreCustomMethods;\n\nexport const createLensCore = (lensCoreModule: LensCoreModule): LensCore => {\n    const customMethods: LensCoreCustomMethods = {\n        initialize(input) {\n            return new Promise((onSuccess, onFailure) =>\n                lensCoreModule.initialize({\n                    ...input,\n                    exceptionHandler: input.exceptionHandler && wrapLensCoreError(input.exceptionHandler),\n                    onSuccess,\n                    onFailure: wrapLensCoreError(onFailure),\n                })\n            );\n        },\n\n        provideRemoteAssetsResponse(input) {\n            return lensCoreModule.provideRemoteAssetsResponse({\n                ...input,\n                onFailure: input.onFailure && wrapLensCoreError(input.onFailure),\n            });\n        },\n    };\n\n    return new Proxy(lensCoreModule, {\n        get: (target, property, receiver) => {\n            // Handle special methods with custom implementations\n            if (property in customMethods) {\n                // Safety: \"in\" operator above ensures that property is keyof LensCoreCustomMethods\n                return customMethods[property as keyof LensCoreCustomMethods];\n            }\n\n            // All other async methods return Promises\n            if (property in promisifiableMethods) {\n                const method = Reflect.get(target, property, receiver);\n                if (!method) method;\n                return (input: Parameters<LensCorePromisifiedMethods[keyof LensCorePromisifiedMethods]>[0]) =>\n                    new Promise((onSuccess, onFailure) =>\n                        method({\n                            ...input,\n                            onSuccess,\n                            onFailure: wrapLensCoreError(onFailure),\n                        })\n                    );\n            }\n\n            // All other kinds of properties (enums, sync methods) are unmodified.\n            return Reflect.get(target, property, receiver);\n        },\n        // Safety: We ensured safety by defining types for both custom and promisifiable methods.\n    }) as LensCore;\n};\n"]}

package/lib/lens-core-module/lensCoreError.d.ts

@@ -0,0 +1,15 @@
+import { DefaultErrorHandler } from "./generated-types";
+type ErrorName = `${string}Error`;
+type NamedError<Name extends ErrorName> = Error & {
+    name: Name;
+};
+export type LensCoreLensDeserializationError = NamedError<"LensCoreLensDeserializationError">;
+export type LensCoreValidationError = NamedError<"LensCoreValidationError">;
+export type LensCoreUncategorizedError = NamedError<"LensCoreUncategorizedError">;
+export type LensCoreLensExecutionError = NamedError<"LensCoreLensExecutionError">;
+export type LensCoreAbortError = NamedError<"LensCoreAbortError">;
+export type LensCoreUninitializedError = NamedError<"LensCoreUninitializedError">;
+export type LensCoreUnknownError = NamedError<"LensCoreUnknownError">;
+export type LensCoreError = LensCoreLensDeserializationError | LensCoreValidationError | LensCoreUncategorizedError | LensCoreLensExecutionError | LensCoreAbortError | LensCoreUninitializedError;
+export declare function wrapLensCoreError(fn: (e: LensCoreError) => void): DefaultErrorHandler;
+export {};

package/lib/lens-core-module/lensCoreError.js

@@ -0,0 +1,43 @@
+// Construct a map linking each LensCore error name to its value,
+// designed to trigger a compile-time error if an error is added or removed in LensCore.
+// eslint-disable-next-line max-len
+// https://github.sc-corp.net/Snapchat/LensCore/blob/master/Src/PlatformSpecific/WebAssembly/ErrorType.hpp#L4
+const lensCoreErrorValue = {
+    LensDeserialization: 0,
+    Validation: 1,
+    Uncategorized: 2,
+    LensExecution: 3,
+    Abort: 4,
+    Uninitialized: 5,
+};
+// The purpose of lensCoreErrorValue above is to safeguard integrity.
+// To achieve constant lookup times, we must swap the keys with their corresponding values.
+const lensCoreErrorName = Object.fromEntries(Object.entries(lensCoreErrorValue).map((entry) => [entry[1], entry[0]]));
+export function wrapLensCoreError(fn) {
+    const handler = (cause) => {
+        var _a;
+        const error = new Error(cause.message.split("\n")[0], {
+            cause: cause.otherExceptions || ((_a = cause.cause) === null || _a === void 0 ? void 0 : _a.metadata)
+                ? {
+                    otherExceptions: cause.otherExceptions,
+                    metadata: cause.cause.metadata,
+                }
+                : undefined,
+        });
+        const name = `LensCore${cause.cause ? lensCoreErrorName[cause.cause.type.value] : "Unknown"}Error`;
+        error.name = name;
+        if (cause.stack) {
+            // if cause has a stack, then we just replace the first line of it
+            // which is actually a error message with our new one, which also contains new error name
+            const [_, ...stackLines] = cause.stack.split("\n");
+            if (error.stack) {
+                stackLines.unshift(error.stack.split("\n")[0]);
+            }
+            error.stack = stackLines.join("\n");
+        }
+        // Safety: we set name above and therefore sure the type of error is correct
+        fn(error);
+    };
+    return handler;
+}
+//# sourceMappingURL=lensCoreError.js.map

package/lib/lens-core-module/lensCoreError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lensCoreError.js","sourceRoot":"","sources":["../../src/lens-core-module/lensCoreError.ts"],"names":[],"mappings":"AAuBA,iEAAiE;AACjE,wFAAwF;AACxF,mCAAmC;AACnC,6GAA6G;AAC7G,MAAM,kBAAkB,GAAwC;IAC5D,mBAAmB,EAAE,CAAC;IACtB,UAAU,EAAE,CAAC;IACb,aAAa,EAAE,CAAC;IAChB,aAAa,EAAE,CAAC;IAChB,KAAK,EAAE,CAAC;IACR,aAAa,EAAE,CAAC;CACnB,CAAC;AAEF,qEAAqE;AACrE,2FAA2F;AAC3F,MAAM,iBAAiB,GAAG,MAAM,CAAC,WAAW,CACxC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAwB,CAAU,CAAC,CAC1G,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,EAA8B;IAC5D,MAAM,OAAO,GAAwB,CAAC,KAAK,EAAE,EAAE;;QAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE;YAClD,KAAK,EACD,KAAK,CAAC,eAAe,KAAI,MAAA,KAAK,CAAC,KAAK,0CAAE,QAAQ,CAAA;gBAC1C,CAAC,CAAC;oBACI,eAAe,EAAE,KAAK,CAAC,eAAe;oBACtC,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ;iBACjC;gBACH,CAAC,CAAC,SAAS;SACtB,CAAC,CAAC;QACH,MAAM,IAAI,GAAmD,WACzD,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAC9D,OAAgB,CAAC;QACjB,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QAClB,IAAI,KAAK,CAAC,KAAK,EAAE;YACb,kEAAkE;YAClE,yFAAyF;YACzF,MAAM,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,IAAI,KAAK,CAAC,KAAK,EAAE;gBACb,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAClD;YACD,KAAK,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;SACvC;QACD,4EAA4E;QAC5E,EAAE,CAAC,KAAsB,CAAC,CAAC;IAC/B,CAAC,CAAC;IACF,OAAO,OAAO,CAAC;AACnB,CAAC","sourcesContent":["import { DefaultErrorHandler, LensCoreModule } from \"./generated-types\";\n\ntype ErrorName = `${string}Error`;\ntype NamedError<Name extends ErrorName> = Error & { name: Name };\n\nexport type LensCoreLensDeserializationError = NamedError<\"LensCoreLensDeserializationError\">;\nexport type LensCoreValidationError = NamedError<\"LensCoreValidationError\">;\nexport type LensCoreUncategorizedError = NamedError<\"LensCoreUncategorizedError\">;\nexport type LensCoreLensExecutionError = NamedError<\"LensCoreLensExecutionError\">;\nexport type LensCoreAbortError = NamedError<\"LensCoreAbortError\">;\nexport type LensCoreUninitializedError = NamedError<\"LensCoreUninitializedError\">;\nexport type LensCoreUnknownError = NamedError<\"LensCoreUnknownError\">;\n\nexport type LensCoreError =\n    | LensCoreLensDeserializationError\n    | LensCoreValidationError\n    | LensCoreUncategorizedError\n    | LensCoreLensExecutionError\n    | LensCoreAbortError\n    | LensCoreUninitializedError;\n\ntype NativeLensCoreError = keyof LensCoreModule[\"ErrorType\"];\n\n// Construct a map linking each LensCore error name to its value,\n// designed to trigger a compile-time error if an error is added or removed in LensCore.\n// eslint-disable-next-line max-len\n// https://github.sc-corp.net/Snapchat/LensCore/blob/master/Src/PlatformSpecific/WebAssembly/ErrorType.hpp#L4\nconst lensCoreErrorValue: Record<NativeLensCoreError, number> = {\n    LensDeserialization: 0,\n    Validation: 1,\n    Uncategorized: 2,\n    LensExecution: 3,\n    Abort: 4,\n    Uninitialized: 5,\n};\n\n// The purpose of lensCoreErrorValue above is to safeguard integrity.\n// To achieve constant lookup times, we must swap the keys with their corresponding values.\nconst lensCoreErrorName = Object.fromEntries(\n    Object.entries(lensCoreErrorValue).map((entry) => [entry[1], entry[0] as NativeLensCoreError] as const)\n);\n\nexport function wrapLensCoreError(fn: (e: LensCoreError) => void) {\n    const handler: DefaultErrorHandler = (cause) => {\n        const error = new Error(cause.message.split(\"\\n\")[0], {\n            cause:\n                cause.otherExceptions || cause.cause?.metadata\n                    ? {\n                          otherExceptions: cause.otherExceptions,\n                          metadata: cause.cause.metadata,\n                      }\n                    : undefined,\n        });\n        const name: (LensCoreError | LensCoreUnknownError)[\"name\"] = `LensCore${\n            cause.cause ? lensCoreErrorName[cause.cause.type.value] : \"Unknown\"\n        }Error` as const;\n        error.name = name;\n        if (cause.stack) {\n            // if cause has a stack, then we just replace the first line of it\n            // which is actually a error message with our new one, which also contains new error name\n            const [_, ...stackLines] = cause.stack.split(\"\\n\");\n            if (error.stack) {\n                stackLines.unshift(error.stack.split(\"\\n\")[0]);\n            }\n            error.stack = stackLines.join(\"\\n\");\n        }\n        // Safety: we set name above and therefore sure the type of error is correct\n        fn(error as LensCoreError);\n    };\n    return handler;\n}\n"]}

package/lib/lens-core-module/loader/lensCoreFactory.d.ts

@@ -1,6 +1,5 @@
 import { CameraKitConfiguration } from "../../configuration";
 import { FetchHandler } from "../../handlers/defaultFetchHandler";
-import { InitialEmscriptenModule, LensCoreModule } from "../generated-types";
 /**
  * Returns a list of URLs for resources which will be fetched during {@link bootstrapCameraKit}.
  *
@@ -24,7 +23,7 @@ export declare function getRequiredBootstrapURLs(endpointOverride?: string): Pro
  * @internal
  */
 export declare const lensCoreFactory: {
-    (args_0: FetchHandler, args_1: CameraKitConfiguration): Promise<InitialEmscriptenModule & LensCoreModule>;
+    (args_0: FetchHandler, args_1: CameraKitConfiguration): Promise<import("../lensCore").LensCore>;
     token: "lensCore";
     dependencies: readonly ["defaultFetchHandler", "configuration"];
 };

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

@@ -1,25 +1,25 @@
 import { __awaiter } from "tslib";
-import { simd, exceptions } from "wasm-feature-detect";
 import lensCoreWasm from "../../lensCoreWasmVersions.json";
 import { loadScript } from "../../common";
 import { configurationToken } from "../../configuration";
 import { Injectable } from "../../dependency-injection/Injectable";
 import { defaultFetchHandlerFactory } from "../../handlers/defaultFetchHandler";
 import { getLogger } from "../../logger/logger";
-import { cameraKitUserAgent } from "../../common/cameraKitUserAgent";
+import { WasmFeatures, getPlatformCapabilities } from "../../platform/platformCapabilities";
+import { getPlatformInfo } from "../../platform/platformInfo";
+import { createLensCore } from "../lensCore";
 const logger = getLogger("lensCoreFactory");
 const wasmAssets = ["LensCoreWebAssembly.js", "LensCoreWebAssembly.wasm"];
 const findMatch = (regex, strings) => strings.find((s) => regex.test(s));
-const PlatformFeatures = {
-    Default: 0,
-    Simd: 0b01,
-    Exceptions: 0b10,
-};
-const platformFeaturesToFlavour = {
-    [PlatformFeatures.Exceptions | PlatformFeatures.Simd]: "rel-simd-neh",
-    [PlatformFeatures.Simd]: "release-simd",
-    [PlatformFeatures.Exceptions]: "rel-neh",
-    [PlatformFeatures.Default]: "release",
+/**
+ * Map various combinations of WebAssembly capabilities to the corresponding LensCore build flavours which make use
+ * of them.
+ */
+const wasmCapabilitiesToLensCoreBuildFlavor = {
+    [WasmFeatures.Default]: "release",
+    [WasmFeatures.ExceptionHandling]: "rel-neh",
+    [WasmFeatures.SIMD]: "release-simd",
+    [WasmFeatures.ExceptionHandling | WasmFeatures.SIMD]: "rel-simd-neh",
 };
 /**
  * Returns a list of URLs for resources which will be fetched during {@link bootstrapCameraKit}.
@@ -36,22 +36,20 @@ export function getRequiredBootstrapURLs(endpointOverride) {
     return __awaiter(this, void 0, void 0, function* () {
         // If we have an endpoint override, remove trailing `/` so we can construct a valid URL.
         const endpoint = endpointOverride === null || endpointOverride === void 0 ? void 0 : endpointOverride.replace(/[\/]+$/, "");
-        let [simdFeature, exceptionsFeature] = yield Promise.all([
-            simd().then((supported) => (supported ? PlatformFeatures.Simd : PlatformFeatures.Default)),
-            exceptions().then((supported) => (supported ? PlatformFeatures.Exceptions : PlatformFeatures.Default)),
-        ]);
-        // Although Safari 16.4 reports SIMD support, LensCore encounters rendering bugs when using SIMD in Safari 16.4.
-        // Therefore, we have made the decision to disable SIMD for now until Safari stabilizes the feature.
-        const { brand } = cameraKitUserAgent.browser;
-        if (brand === "Safari")
-            simdFeature = PlatformFeatures.Default;
-        const flavor = platformFeaturesToFlavour[simdFeature | exceptionsFeature];
-        const version = lensCoreWasm.version;
-        const buildNumber = lensCoreWasm.buildNumber;
+        const { wasm } = yield getPlatformCapabilities();
+        if (!wasm.supported)
+            throw wasm.error;
+        const { lensCore } = getPlatformInfo();
+        const flavor = wasmCapabilitiesToLensCoreBuildFlavor[wasm.wasmFeatures];
+        if (!flavor)
+            throw new Error(`Could not determine a LensCore build flavor corresponding to the bitstring ` +
+                `${wasm.wasmFeatures.toString(2)}. CameraKit cannot be bootstrapped.`);
+        const version = lensCore.version;
+        const buildNumber = lensCore.buildNumber;
         return wasmAssets.map((asset) => {
             if (endpoint)
                 return `${endpoint}/${asset}`;
-            const { origin, pathname, search } = new URL(lensCoreWasm.baseUrl);
+            const { origin, pathname, search } = new URL(lensCore.baseUrl);
             return `${origin}${pathname}/${version}/${buildNumber}/${flavor}/${asset}${search}`;
         });
     });
@@ -118,6 +116,6 @@ export const lensCoreFactory = Injectable("lensCore", [defaultFetchHandlerFactor
     if (lensCoreWasm.version != `${lensCore.getCoreVersion()}`) {
         logger.warn(`Loaded LensCore version (${lensCore.getCoreVersion()}) differs from expected one (${lensCoreWasm.version})`);
     }
-    return lensCore;
+    return createLensCore(lensCore);
 }));
 //# sourceMappingURL=lensCoreFactory.js.map

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        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"]}
+{"version":3,"file":"lensCoreFactory.js","sourceRoot":"","sources":["../../../src/lens-core-module/loader/lensCoreFactory.ts"],"names":[],"mappings":"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","sourcesContent":["import 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 { WasmFeatures, getPlatformCapabilities } from \"../../platform/platformCapabilities\";\nimport { getPlatformInfo } from \"../../platform/platformInfo\";\nimport { createLensCore } from \"../lensCore\";\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\n/**\n * Map various combinations of WebAssembly capabilities to the corresponding LensCore build flavours which make use\n * of them.\n */\nconst wasmCapabilitiesToLensCoreBuildFlavor = {\n    [WasmFeatures.Default]: \"release\",\n    [WasmFeatures.ExceptionHandling]: \"rel-neh\",\n    [WasmFeatures.SIMD]: \"release-simd\",\n    [WasmFeatures.ExceptionHandling | WasmFeatures.SIMD]: \"rel-simd-neh\",\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    const { wasm } = await getPlatformCapabilities();\n    if (!wasm.supported) throw wasm.error;\n\n    const { lensCore } = getPlatformInfo();\n    const flavor = wasmCapabilitiesToLensCoreBuildFlavor[wasm.wasmFeatures];\n    if (!flavor)\n        throw new Error(\n            `Could not determine a LensCore build flavor corresponding to the bitstring ` +\n                `${wasm.wasmFeatures.toString(2)}. CameraKit cannot be bootstrapped.`\n        );\n    const version = lensCore.version;\n    const buildNumber = lensCore.buildNumber;\n    return wasmAssets.map((asset) => {\n        if (endpoint) return `${endpoint}/${asset}`;\n        const { origin, pathname, search } = new URL(lensCore.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 createLensCore(lensCore);\n    }\n);\n"]}

package/lib/lensCoreWasmVersions.json

@@ -1,5 +1,5 @@
 {
-    "version": "231",
-    "buildNumber": "111",
-    "baseUrl": "https://cf-st.sc-cdn.net/d/Cqf3dzYV6Dvo2mhyCozDq?go=IgsKCTIBBEgBUFxgAQ%3D%3D&uc=92"
+    "version": "239",
+    "buildNumber": "148",
+    "baseUrl": "https://cf-st.sc-cdn.net/d/vzrhSjRylX02Y8J6eVgUV?go=IgsKCTIBBEgBUFxgAQ%3D%3D&uc=92"
 }

package/lib/logger/registerLogEntriesSubscriber.js

@@ -1,8 +1,8 @@
 import { filter } from "rxjs";
-import { cameraKitUserAgent } from "../common/cameraKitUserAgent";
 import { stringifyError } from "../common/errorHelpers";
 import { configurationToken } from "../configuration";
 import { Injectable } from "../dependency-injection/Injectable";
+import { getPlatformInfo } from "../platform/platformInfo";
 import { logEntriesFactory } from "./logEntries";
 import { logLevelMap } from "./logger";
 /**
@@ -19,7 +19,7 @@ export const registerLogEntriesSubscriber = Injectable("registerLogEntriesSubscr
             case "console":
                 // Chrome doesn't print the `cause` Error property, so we need to manually construct a complete
                 // stack trace using our `stringifyError` helper.
-                const messages = cameraKitUserAgent.browser.brand === "Chrome"
+                const messages = getPlatformInfo().browser.brand === "Chrome"
                     ? logEntry.messages.map((message) => {
                         if (!(message instanceof Error))
                             return message;

package/lib/logger/registerLogEntriesSubscriber.js.map

@@ -1 +1 @@
-{"version":3,"file":"registerLogEntriesSubscriber.js","sourceRoot":"","sources":["../../src/logger/registerLogEntriesSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAc,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAA0B,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAY,WAAW,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAClD,8BAA8B,EAC9B,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,KAAK,CAAU,EACtD,CAAC,aAAqC,EAAE,UAAgC,EAAE,EAAE;IACxE,UAAU;SACL,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;SACxF,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpB,QAAQ,aAAa,CAAC,MAAM,EAAE;YAC1B,KAAK,SAAS;gBACV,+FAA+F;gBAC/F,iDAAiD;gBACjD,MAAM,QAAQ,GACV,kBAAkB,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ;oBACzC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;wBAC9B,IAAI,CAAC,CAAC,OAAO,YAAY,KAAK,CAAC;4BAAE,OAAO,OAAO,CAAC;wBAChD,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;wBACxC,OAAO,OAAO,CAAC;oBACnB,CAAC,CAAC;oBACJ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAE5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,cAAc,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;gBACvE,MAAM;SACb;IACL,CAAC,CAAC,CAAC;AACX,CAAC,CACJ,CAAC","sourcesContent":["import { filter, Observable } from \"rxjs\";\nimport { cameraKitUserAgent } from \"../common/cameraKitUserAgent\";\nimport { stringifyError } from \"../common/errorHelpers\";\nimport { CameraKitConfiguration, configurationToken } from \"../configuration\";\nimport { Injectable } from \"../dependency-injection/Injectable\";\nimport { logEntriesFactory } from \"./logEntries\";\nimport { LogEntry, logLevelMap } from \"./logger\";\n\n/**\n * The factory subscribes to log entry events and, based on the configured log level,\n * forwards matching log entries to the logger specified in the CameraKit configuration object.\n *\n * @internal\n */\nexport const registerLogEntriesSubscriber = Injectable(\n    \"registerLogEntriesSubscriber\",\n    [configurationToken, logEntriesFactory.token] as const,\n    (configuration: CameraKitConfiguration, logEntries: Observable<LogEntry>) => {\n        logEntries\n            .pipe(filter((entry) => logLevelMap[entry.level] >= logLevelMap[configuration.logLevel]))\n            .subscribe((logEntry) => {\n                switch (configuration.logger) {\n                    case \"console\":\n                        // Chrome doesn't print the `cause` Error property, so we need to manually construct a complete\n                        // stack trace using our `stringifyError` helper.\n                        const messages =\n                            cameraKitUserAgent.browser.brand === \"Chrome\"\n                                ? logEntry.messages.map((message) => {\n                                      if (!(message instanceof Error)) return message;\n                                      message.stack = stringifyError(message);\n                                      return message;\n                                  })\n                                : logEntry.messages;\n\n                        console[logEntry.level](`[CameraKit.${logEntry.module}]`, ...messages);\n                        break;\n                }\n            });\n    }\n);\n"]}
+{"version":3,"file":"registerLogEntriesSubscriber.js","sourceRoot":"","sources":["../../src/logger/registerLogEntriesSubscriber.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAc,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAA0B,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAY,WAAW,EAAE,MAAM,UAAU,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,UAAU,CAClD,8BAA8B,EAC9B,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,KAAK,CAAU,EACtD,CAAC,aAAqC,EAAE,UAAgC,EAAE,EAAE;IACxE,UAAU;SACL,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;SACxF,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpB,QAAQ,aAAa,CAAC,MAAM,EAAE;YAC1B,KAAK,SAAS;gBACV,+FAA+F;gBAC/F,iDAAiD;gBACjD,MAAM,QAAQ,GACV,eAAe,EAAE,CAAC,OAAO,CAAC,KAAK,KAAK,QAAQ;oBACxC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;wBAC9B,IAAI,CAAC,CAAC,OAAO,YAAY,KAAK,CAAC;4BAAE,OAAO,OAAO,CAAC;wBAChD,OAAO,CAAC,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;wBACxC,OAAO,OAAO,CAAC;oBACnB,CAAC,CAAC;oBACJ,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAE5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,cAAc,QAAQ,CAAC,MAAM,GAAG,EAAE,GAAG,QAAQ,CAAC,CAAC;gBACvE,MAAM;SACb;IACL,CAAC,CAAC,CAAC;AACX,CAAC,CACJ,CAAC","sourcesContent":["import { filter, Observable } from \"rxjs\";\nimport { stringifyError } from \"../common/errorHelpers\";\nimport { CameraKitConfiguration, configurationToken } from \"../configuration\";\nimport { Injectable } from \"../dependency-injection/Injectable\";\nimport { getPlatformInfo } from \"../platform/platformInfo\";\nimport { logEntriesFactory } from \"./logEntries\";\nimport { LogEntry, logLevelMap } from \"./logger\";\n\n/**\n * The factory subscribes to log entry events and, based on the configured log level,\n * forwards matching log entries to the logger specified in the CameraKit configuration object.\n *\n * @internal\n */\nexport const registerLogEntriesSubscriber = Injectable(\n    \"registerLogEntriesSubscriber\",\n    [configurationToken, logEntriesFactory.token] as const,\n    (configuration: CameraKitConfiguration, logEntries: Observable<LogEntry>) => {\n        logEntries\n            .pipe(filter((entry) => logLevelMap[entry.level] >= logLevelMap[configuration.logLevel]))\n            .subscribe((logEntry) => {\n                switch (configuration.logger) {\n                    case \"console\":\n                        // Chrome doesn't print the `cause` Error property, so we need to manually construct a complete\n                        // stack trace using our `stringifyError` helper.\n                        const messages =\n                            getPlatformInfo().browser.brand === \"Chrome\"\n                                ? logEntry.messages.map((message) => {\n                                      if (!(message instanceof Error)) return message;\n                                      message.stack = stringifyError(message);\n                                      return message;\n                                  })\n                                : logEntry.messages;\n\n                        console[logEntry.level](`[CameraKit.${logEntry.module}]`, ...messages);\n                        break;\n                }\n            });\n    }\n);\n"]}

package/lib/media-sources/CameraKitSource.d.ts

@@ -1,4 +1,4 @@
-import { LensCoreModule, UseMediaElementInput } from "../lens-core-module/generated-types";
+import { LensCore, UseMediaElementInput } from "../lens-core-module";
 import { Transform2D } from "../transforms";
 /**
  * When creating a {@link CameraKitSource}, passing a CameraKitSourceSubscriber allows logic to implemented which will
@@ -7,7 +7,7 @@ import { Transform2D } from "../transforms";
  * @category Rendering
  */
 export interface CameraKitSourceSubscriber {
-    readonly onAttach?: (source: CameraKitSource, lensCore: LensCoreModule, reportError: (error: Error) => void) => void | Promise<void>;
+    readonly onAttach?: (source: CameraKitSource, lensCore: LensCore, reportError: (error: Error) => void) => void | Promise<void>;
     readonly onDetach?: (reportError: (error: Error) => void) => void | Promise<void>;
 }
 /** @category Rendering
@@ -51,7 +51,7 @@ export declare class CameraKitSource {
      * @returns Rejects if any calls to LensCore or CameraKitSource.subscriber.onAttach fail.
      * @internal
      */
-    attach(lensCore: LensCoreModule, reportError: (error: Error) => void): Promise<void>;
+    attach(lensCore: LensCore, reportError: (error: Error) => void): Promise<void>;
     /**
      * Make a copy of the source, sharing the same {@link CameraKitSourceSubscriber}.
      *

package/lib/media-sources/CameraKitSource.js

@@ -1,5 +1,6 @@
 /* eslint-disable @typescript-eslint/member-ordering */
 import { __awaiter, __decorate, __metadata } from "tslib";
+import { copyDefinedProperties } from "../common/copyDefinedProperties";
 import { validate } from "../common/validate";
 import { Transform2D } from "../transforms";
 const defaultDeviceInfo = {
@@ -22,7 +23,7 @@ export class CameraKitSource {
     constructor(sourceInfo, subscriber = {}, deviceInfo = {}) {
         this.sourceInfo = sourceInfo;
         this.subscriber = subscriber;
-        this.deviceInfo = Object.assign(Object.assign({}, defaultDeviceInfo), deviceInfo);
+        this.deviceInfo = Object.assign(Object.assign({}, defaultDeviceInfo), copyDefinedProperties(deviceInfo));
     }
     /**
      * Called by {@link CameraKitSession} when this source is set as that session's source.
@@ -39,25 +40,19 @@ export class CameraKitSource {
                     "a CameraKitSession. To re-attach, create a copy of this CameraKitCustomSource.");
             }
             this.lensCore = lensCore;
-            yield new Promise((onSuccess, onFailure) => {
-                lensCore.useMediaElement({
-                    autoplayNewMedia: false,
-                    autoplayPreviewCanvas: false,
-                    media: this.sourceInfo.media,
-                    pauseExistingMedia: false,
-                    replayTrackingData: this.sourceInfo.replayTrackingData,
-                    requestWebcam: false,
-                    startOnFrontCamera: ["user", "front"].includes(this.deviceInfo.cameraType),
-                    useManualFrameProcessing: this.sourceInfo.useManualFrameProcessing,
-                    onSuccess,
-                    onFailure,
-                });
-            });
-            yield new Promise((onSuccess, onFailure) => {
-                // LensCore uses 0 to remove the limit.
-                const fps = this.deviceInfo.fpsLimit < Number.POSITIVE_INFINITY ? this.deviceInfo.fpsLimit : 0;
-                lensCore.setFPSLimit({ fps, onSuccess, onFailure });
+            yield lensCore.useMediaElement({
+                autoplayNewMedia: false,
+                autoplayPreviewCanvas: false,
+                media: this.sourceInfo.media,
+                pauseExistingMedia: false,
+                replayTrackingData: this.sourceInfo.replayTrackingData,
+                requestWebcam: false,
+                startOnFrontCamera: ["user", "front"].includes(this.deviceInfo.cameraType),
+                useManualFrameProcessing: this.sourceInfo.useManualFrameProcessing,
             });
+            // LensCore uses 0 to remove the limit.
+            const fps = this.deviceInfo.fpsLimit < Number.POSITIVE_INFINITY ? this.deviceInfo.fpsLimit : 0;
+            yield lensCore.setFPSLimit({ fps });
             if (this.subscriber.onAttach)
                 yield this.subscriber.onAttach(this, lensCore, reportError);
         });
@@ -98,12 +93,10 @@ export class CameraKitSource {
      * @returns Promise resolves when the render size has been successfully updated.
      */
     setRenderSize(width, height) {
-        return new Promise((onSuccess, onFailure) => {
-            if (!this.lensCore)
-                return onFailure(createNotAttachedError("Cannot setRenderSize"));
-            const target = { width, height };
-            this.lensCore.setRenderSize({ mode: "explicit", target, onSuccess, onFailure });
-        });
+        if (!this.lensCore)
+            return Promise.reject(createNotAttachedError("Cannot setRenderSize"));
+        const target = { width, height };
+        return this.lensCore.setRenderSize({ mode: "explicit", target });
     }
     /**
      * Apply a 2D transformation to the source (e.g. translation, rotation, scale).
@@ -111,12 +104,10 @@ export class CameraKitSource {
      * @param transform Specifies the 3x3 matrix describing the transformation.
      */
     setTransform(transform) {
-        return new Promise((onSuccess, onFailure) => {
-            if (!this.lensCore)
-                return onFailure(createNotAttachedError("Cannot setTransform"));
-            const matrix = new Float32Array(transform.matrix);
-            this.lensCore.setInputTransform({ matrix, onSuccess, onFailure });
-        });
+        if (!this.lensCore)
+            return Promise.reject(createNotAttachedError("Cannot setTransform"));
+        const matrix = new Float32Array(transform.matrix);
+        return this.lensCore.setInputTransform({ matrix });
     }
 }
 __decorate([

package/lib/media-sources/CameraKitSource.js.map

@@ -1 +1 @@
-{"version":3,"file":"CameraKitSource.js","sourceRoot":"","sources":["../../src/media-sources/CameraKitSource.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/member-ordering */\n\nimport { validate } from \"../common/validate\";\nimport { LensCoreModule, UseMediaElementInput } from \"../lens-core-module/generated-types\";\nimport { Transform2D } from \"../transforms\";\n\nconst defaultDeviceInfo: CameraKitDeviceOptions = {\n    cameraType: \"user\",\n    fpsLimit: Number.POSITIVE_INFINITY,\n};\n\nconst createNotAttachedError = (message: string) =>\n    new Error(`${message}. This CameraKitSource is not attached to a CameraKitSession.`);\n\n/**\n * When creating a {@link CameraKitSource}, passing a CameraKitSourceSubscriber allows logic to implemented which will\n * run whenever that source is attached/detached from a CameraKitSession.\n *\n * @category Rendering\n */\nexport interface CameraKitSourceSubscriber {\n    readonly onAttach?: (\n        source: CameraKitSource,\n        lensCore: LensCoreModule,\n        reportError: (error: Error) => void\n    ) => void | Promise<void>;\n    readonly onDetach?: (reportError: (error: Error) => void) => void | Promise<void>;\n}\n\n/** @category Rendering\n * @deprecated use {@link CameraKitDeviceOptions}\n */\nexport type CameraKitDeviceInfo = {\n    /** @deprecated \"front\" and \"back\" are deprecated please use \"user\" or \"enviroment\" for cameraType instead */\n    cameraType: \"front\" | \"back\";\n    fpsLimit: number;\n};\n\n/** @category Rendering */\nexport type CameraKitDeviceOptions = {\n    cameraType: \"user\" | \"environment\";\n    fpsLimit: number;\n};\n\nexport type CameraKitSourceInfo = Pick<\n    UseMediaElementInput,\n    \"media\" | \"replayTrackingData\" | \"useManualFrameProcessing\"\n>;\n\n/** @category Rendering */\nexport type CameraKitSourceOptions<T = {}> = Partial<T> & Partial<CameraKitDeviceInfo | CameraKitDeviceOptions>;\n\n/**\n * This general-purpose class represents a source of media for a {@link CameraKitSession}.\n *\n * When an instance is passed to {@link CameraKitSession.setSource | CameraKitSession.setSource}, it will be \"attached\"\n * to the session. Later it may be \"detached\" from the session.\n *\n * Passing a {@link CameraKitSourceSubscriber} to the constructor allows callers to specify behavior\n * that will occur when the source is attached and detached. This can be used to e.g. update the render size.\n *\n * @category Rendering\n */\nexport class CameraKitSource {\n    private lensCore?: LensCoreModule;\n    private readonly deviceInfo: CameraKitDeviceInfo | CameraKitDeviceOptions;\n\n    constructor(\n        private readonly sourceInfo: CameraKitSourceInfo,\n        private readonly subscriber: CameraKitSourceSubscriber = {},\n        deviceInfo: Partial<CameraKitDeviceInfo | CameraKitDeviceOptions> = {}\n    ) {\n        this.deviceInfo = { ...defaultDeviceInfo, ...deviceInfo };\n    }\n\n    /**\n     * Called by {@link CameraKitSession} when this source is set as that session's source.\n     *\n     * @param lensCore\n     * @param reportError Calling this function will report an error back to the session.\n     * @returns Rejects if any calls to LensCore or CameraKitSource.subscriber.onAttach fail.\n     * @internal\n     */\n    async attach(lensCore: LensCoreModule, reportError: (error: Error) => void): Promise<void> {\n        if (this.lensCore) {\n            throw new Error(\n                \"Cannot attach. This CameraKitCustomSource has already been attached to \" +\n                    \"a CameraKitSession. To re-attach, create a copy of this CameraKitCustomSource.\"\n            );\n        }\n\n        this.lensCore = lensCore;\n\n        await new Promise((onSuccess, onFailure) => {\n            lensCore.useMediaElement({\n                autoplayNewMedia: false,\n                autoplayPreviewCanvas: false,\n                media: this.sourceInfo.media,\n                pauseExistingMedia: false,\n                replayTrackingData: this.sourceInfo.replayTrackingData,\n                requestWebcam: false,\n                startOnFrontCamera: [\"user\", \"front\"].includes(this.deviceInfo.cameraType),\n                useManualFrameProcessing: this.sourceInfo.useManualFrameProcessing,\n                onSuccess,\n                onFailure,\n            });\n        });\n\n        await new Promise<void>((onSuccess, onFailure) => {\n            // LensCore uses 0 to remove the limit.\n            const fps = this.deviceInfo.fpsLimit < Number.POSITIVE_INFINITY ? this.deviceInfo.fpsLimit : 0;\n            lensCore.setFPSLimit({ fps, onSuccess, onFailure });\n        });\n\n        if (this.subscriber.onAttach) await this.subscriber.onAttach(this, lensCore, reportError);\n    }\n\n    /**\n     * Make a copy of the source, sharing the same {@link CameraKitSourceSubscriber}.\n     *\n     * @param deviceInfo Optionally provide new device info for the copy (e.g. to change the camera type).\n     * @returns The new {@link CameraKitSource}\n     */\n    /** @deprecated Use {@link CameraKitDeviceOptions} where cameraType is either \"environment\" or \"user\" */\n    copy(deviceInfo?: Partial<CameraKitDeviceInfo>): CameraKitSource;\n    copy(deviceInfo?: Partial<CameraKitDeviceOptions>): CameraKitSource;\n    copy(deviceInfo: Partial<CameraKitDeviceOptions | CameraKitDeviceInfo> = {}): CameraKitSource {\n        return new CameraKitSource(this.sourceInfo, this.subscriber, { ...this.deviceInfo, ...deviceInfo });\n    }\n\n    /**\n     * Called by {@link CameraKitSession} when it must remove this source.\n     *\n     * @param reportError Calling this function will report an error back to the session.\n     * @returns\n     * @internal\n     */\n    detach(reportError: (error: Error) => void): void | Promise<void> {\n        if (!this.lensCore) return Promise.reject(createNotAttachedError(\"Cannot detach\"));\n        if (this.subscriber.onDetach) return this.subscriber.onDetach(reportError);\n    }\n\n    /**\n     * Set the resolution used to render this source.\n     *\n     * It’s important to distinguish render size from display size. The size at which the output canvases are displayed\n     * on a web page is determined by the CSS of the page. It is distinct from the size at which LensCore renders\n     * Lenses. Performance is dominated by render size, while any display scaling can most often be thought of as free.\n     *\n     * If greater performance is required, a smaller render size may boost frame-rate. It does come at a cost, including\n     * loss of accuracy in various tracking and computer-vision algorithms (since they'll be operating on fewer pixels).\n     *\n     * The size of the Live and Capture {@link RenderTarget} is always the same.\n     *\n     * @todo Currently it's only valid to call `setRenderSize` after `CameraKitSession.play` has been called. This\n     * constraint should be removed, so callers don't have to understand the underlying LensCore state machine.\n     *\n     * @param width pixels\n     * @param height pixels\n     * @returns Promise resolves when the render size has been successfully updated.\n     */\n    @validate\n    setRenderSize(width: number, height: number): Promise<void> {\n        return new Promise((onSuccess, onFailure) => {\n            if (!this.lensCore) return onFailure(createNotAttachedError(\"Cannot setRenderSize\"));\n            const target = { width, height };\n            this.lensCore.setRenderSize({ mode: \"explicit\", target, onSuccess, onFailure });\n        });\n    }\n\n    /**\n     * Apply a 2D transformation to the source (e.g. translation, rotation, scale).\n     *\n     * @param transform Specifies the 3x3 matrix describing the transformation.\n     */\n    @validate\n    setTransform(transform: Transform2D): Promise<void> {\n        return new Promise((onSuccess, onFailure) => {\n            if (!this.lensCore) return onFailure(createNotAttachedError(\"Cannot setTransform\"));\n            const matrix = new Float32Array(transform.matrix);\n            this.lensCore.setInputTransform({ matrix, onSuccess, onFailure });\n        });\n    }\n}\n"]}
+{"version":3,"file":"CameraKitSource.js","sourceRoot":"","sources":["../../src/media-sources/CameraKitSource.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/member-ordering */\n\nimport { copyDefinedProperties } from \"../common/copyDefinedProperties\";\nimport { validate } from \"../common/validate\";\nimport { LensCore, UseMediaElementInput } from \"../lens-core-module\";\nimport { Transform2D } from \"../transforms\";\n\nconst defaultDeviceInfo: CameraKitDeviceOptions = {\n    cameraType: \"user\",\n    fpsLimit: Number.POSITIVE_INFINITY,\n};\n\nconst createNotAttachedError = (message: string) =>\n    new Error(`${message}. This CameraKitSource is not attached to a CameraKitSession.`);\n\n/**\n * When creating a {@link CameraKitSource}, passing a CameraKitSourceSubscriber allows logic to implemented which will\n * run whenever that source is attached/detached from a CameraKitSession.\n *\n * @category Rendering\n */\nexport interface CameraKitSourceSubscriber {\n    readonly onAttach?: (\n        source: CameraKitSource,\n        lensCore: LensCore,\n        reportError: (error: Error) => void\n    ) => void | Promise<void>;\n    readonly onDetach?: (reportError: (error: Error) => void) => void | Promise<void>;\n}\n\n/** @category Rendering\n * @deprecated use {@link CameraKitDeviceOptions}\n */\nexport type CameraKitDeviceInfo = {\n    /** @deprecated \"front\" and \"back\" are deprecated please use \"user\" or \"enviroment\" for cameraType instead */\n    cameraType: \"front\" | \"back\";\n    fpsLimit: number;\n};\n\n/** @category Rendering */\nexport type CameraKitDeviceOptions = {\n    cameraType: \"user\" | \"environment\";\n    fpsLimit: number;\n};\n\nexport type CameraKitSourceInfo = Pick<\n    UseMediaElementInput,\n    \"media\" | \"replayTrackingData\" | \"useManualFrameProcessing\"\n>;\n\n/** @category Rendering */\nexport type CameraKitSourceOptions<T = {}> = Partial<T> & Partial<CameraKitDeviceInfo | CameraKitDeviceOptions>;\n\n/**\n * This general-purpose class represents a source of media for a {@link CameraKitSession}.\n *\n * When an instance is passed to {@link CameraKitSession.setSource | CameraKitSession.setSource}, it will be \"attached\"\n * to the session. Later it may be \"detached\" from the session.\n *\n * Passing a {@link CameraKitSourceSubscriber} to the constructor allows callers to specify behavior\n * that will occur when the source is attached and detached. This can be used to e.g. update the render size.\n *\n * @category Rendering\n */\nexport class CameraKitSource {\n    private lensCore?: LensCore;\n    private readonly deviceInfo: CameraKitDeviceInfo | CameraKitDeviceOptions;\n\n    constructor(\n        private readonly sourceInfo: CameraKitSourceInfo,\n        private readonly subscriber: CameraKitSourceSubscriber = {},\n        deviceInfo: Partial<CameraKitDeviceInfo | CameraKitDeviceOptions> = {}\n    ) {\n        this.deviceInfo = { ...defaultDeviceInfo, ...copyDefinedProperties(deviceInfo) };\n    }\n\n    /**\n     * Called by {@link CameraKitSession} when this source is set as that session's source.\n     *\n     * @param lensCore\n     * @param reportError Calling this function will report an error back to the session.\n     * @returns Rejects if any calls to LensCore or CameraKitSource.subscriber.onAttach fail.\n     * @internal\n     */\n    async attach(lensCore: LensCore, reportError: (error: Error) => void): Promise<void> {\n        if (this.lensCore) {\n            throw new Error(\n                \"Cannot attach. This CameraKitCustomSource has already been attached to \" +\n                    \"a CameraKitSession. To re-attach, create a copy of this CameraKitCustomSource.\"\n            );\n        }\n\n        this.lensCore = lensCore;\n\n        await lensCore.useMediaElement({\n            autoplayNewMedia: false,\n            autoplayPreviewCanvas: false,\n            media: this.sourceInfo.media,\n            pauseExistingMedia: false,\n            replayTrackingData: this.sourceInfo.replayTrackingData,\n            requestWebcam: false,\n            startOnFrontCamera: [\"user\", \"front\"].includes(this.deviceInfo.cameraType),\n            useManualFrameProcessing: this.sourceInfo.useManualFrameProcessing,\n        });\n\n        // LensCore uses 0 to remove the limit.\n        const fps = this.deviceInfo.fpsLimit < Number.POSITIVE_INFINITY ? this.deviceInfo.fpsLimit : 0;\n        await lensCore.setFPSLimit({ fps });\n\n        if (this.subscriber.onAttach) await this.subscriber.onAttach(this, lensCore, reportError);\n    }\n\n    /**\n     * Make a copy of the source, sharing the same {@link CameraKitSourceSubscriber}.\n     *\n     * @param deviceInfo Optionally provide new device info for the copy (e.g. to change the camera type).\n     * @returns The new {@link CameraKitSource}\n     */\n    /** @deprecated Use {@link CameraKitDeviceOptions} where cameraType is either \"environment\" or \"user\" */\n    copy(deviceInfo?: Partial<CameraKitDeviceInfo>): CameraKitSource;\n    copy(deviceInfo?: Partial<CameraKitDeviceOptions>): CameraKitSource;\n    copy(deviceInfo: Partial<CameraKitDeviceOptions | CameraKitDeviceInfo> = {}): CameraKitSource {\n        return new CameraKitSource(this.sourceInfo, this.subscriber, { ...this.deviceInfo, ...deviceInfo });\n    }\n\n    /**\n     * Called by {@link CameraKitSession} when it must remove this source.\n     *\n     * @param reportError Calling this function will report an error back to the session.\n     * @returns\n     * @internal\n     */\n    detach(reportError: (error: Error) => void): void | Promise<void> {\n        if (!this.lensCore) return Promise.reject(createNotAttachedError(\"Cannot detach\"));\n        if (this.subscriber.onDetach) return this.subscriber.onDetach(reportError);\n    }\n\n    /**\n     * Set the resolution used to render this source.\n     *\n     * It’s important to distinguish render size from display size. The size at which the output canvases are displayed\n     * on a web page is determined by the CSS of the page. It is distinct from the size at which LensCore renders\n     * Lenses. Performance is dominated by render size, while any display scaling can most often be thought of as free.\n     *\n     * If greater performance is required, a smaller render size may boost frame-rate. It does come at a cost, including\n     * loss of accuracy in various tracking and computer-vision algorithms (since they'll be operating on fewer pixels).\n     *\n     * The size of the Live and Capture {@link RenderTarget} is always the same.\n     *\n     * @todo Currently it's only valid to call `setRenderSize` after `CameraKitSession.play` has been called. This\n     * constraint should be removed, so callers don't have to understand the underlying LensCore state machine.\n     *\n     * @param width pixels\n     * @param height pixels\n     * @returns Promise resolves when the render size has been successfully updated.\n     */\n    @validate\n    setRenderSize(width: number, height: number): Promise<void> {\n        if (!this.lensCore) return Promise.reject(createNotAttachedError(\"Cannot setRenderSize\"));\n        const target = { width, height };\n        return this.lensCore.setRenderSize({ mode: \"explicit\", target });\n    }\n\n    /**\n     * Apply a 2D transformation to the source (e.g. translation, rotation, scale).\n     *\n     * @param transform Specifies the 3x3 matrix describing the transformation.\n     */\n    @validate\n    setTransform(transform: Transform2D): Promise<void> {\n        if (!this.lensCore) return Promise.reject(createNotAttachedError(\"Cannot setTransform\"));\n        const matrix = new Float32Array(transform.matrix);\n        return this.lensCore.setInputTransform({ matrix });\n    }\n}\n"]}