@snap/camera-kit 0.7.0

package/lib/bootstrapCameraKit.js.map

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

package/lib/common/__mocks__/loadScript.d.ts

@@ -0,0 +1 @@
+export declare function loadScript(): Promise<void>;

package/lib/common/__mocks__/loadScript.js

@@ -0,0 +1,10 @@
+export function loadScript() {
+    global.createLensesModule = jest.fn().mockImplementation((module) => {
+        return new Promise((resolve) => {
+            module.getCoreVersion = () => 0;
+            module.instantiateWasm({}, () => resolve(module));
+        });
+    });
+    return Promise.resolve();
+}
+//# sourceMappingURL=loadScript.js.map

package/lib/common/__mocks__/loadScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadScript.js","sourceRoot":"","sources":["../../../src/common/__mocks__/loadScript.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,UAAU;IACtB,MAAM,CAAC,kBAAkB,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,MAAkB,EAAE,EAAE;QAC5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,CAAC,cAAc,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,eAAgB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;AAC7B,CAAC","sourcesContent":["import { InitialEmscriptenModule, LensCoreModule } from \"../../lens-core-module/generated-types\";\n\ntype MockModule = InitialEmscriptenModule & Partial<LensCoreModule>;\n\nexport function loadScript(): Promise<void> {\n    global.createLensesModule = jest.fn().mockImplementation((module: MockModule) => {\n        return new Promise((resolve) => {\n            module.getCoreVersion = () => 0;\n            module.instantiateWasm!({}, () => resolve(module));\n        });\n    });\n    return Promise.resolve();\n}\n"]}

package/lib/common/assertions.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Assert a particular code path is unreachable, e.g. to perform a compile-time exhaustiveness check.
+ *
+ * Ex:
+ * ```ts
+ * interface A { type: 'a' }
+ * interface B { type: 'b' }
+ * type TaggedUnion = A | B
+ *
+ * function exhaustiveSwitch(value: TaggedUnion) {
+ *   switch (value.type) {
+ *     case 'a': // do something with A
+ *     case 'b': // do something with B
+ *     // this will fail to compile if we add another type to TaggedUnion and forget to add a corresponding case
+ *     // to the switch statement.
+ *     default: assertUnreachable(value)
+ *   }
+ * }
+ * ```
+ */
+export declare function assertUnreachable(_: never): never;
+/**
+ * Assert that a condition is true. Otherwise, throws an error.
+ * @param condition Condition to test.
+ * @param error Optional error message or error instance to throw.
+ */
+export declare function assert(condition: boolean, error?: string | Error): asserts condition;

package/lib/common/assertions.js

@@ -0,0 +1,39 @@
+/**
+ * Assert a particular code path is unreachable, e.g. to perform a compile-time exhaustiveness check.
+ *
+ * Ex:
+ * ```ts
+ * interface A { type: 'a' }
+ * interface B { type: 'b' }
+ * type TaggedUnion = A | B
+ *
+ * function exhaustiveSwitch(value: TaggedUnion) {
+ *   switch (value.type) {
+ *     case 'a': // do something with A
+ *     case 'b': // do something with B
+ *     // this will fail to compile if we add another type to TaggedUnion and forget to add a corresponding case
+ *     // to the switch statement.
+ *     default: assertUnreachable(value)
+ *   }
+ * }
+ * ```
+ */
+export function assertUnreachable(_) {
+    throw new Error("Reached unreachable code at runtime.");
+}
+/**
+ * Assert that a condition is true. Otherwise, throws an error.
+ * @param condition Condition to test.
+ * @param error Optional error message or error instance to throw.
+ */
+export function assert(condition, error = "Assertion failed") {
+    if (!condition) {
+        if (error instanceof Error) {
+            throw error;
+        }
+        else {
+            throw new Error(error);
+        }
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/lib/common/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../../src/common/assertions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB,CAAC,CAAQ;IACtC,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,QAAwB,kBAAkB;IACjF,IAAI,CAAC,SAAS,EAAE;QACZ,IAAI,KAAK,YAAY,KAAK,EAAE;YACxB,MAAM,KAAK,CAAC;SACf;aAAM;YACH,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;SAC1B;KACJ;AACL,CAAC","sourcesContent":["/**\n * Assert a particular code path is unreachable, e.g. to perform a compile-time exhaustiveness check.\n *\n * Ex:\n * ```ts\n * interface A { type: 'a' }\n * interface B { type: 'b' }\n * type TaggedUnion = A | B\n *\n * function exhaustiveSwitch(value: TaggedUnion) {\n *   switch (value.type) {\n *     case 'a': // do something with A\n *     case 'b': // do something with B\n *     // this will fail to compile if we add another type to TaggedUnion and forget to add a corresponding case\n *     // to the switch statement.\n *     default: assertUnreachable(value)\n *   }\n * }\n * ```\n */\nexport function assertUnreachable(_: never): never {\n    throw new Error(\"Reached unreachable code at runtime.\");\n}\n\n/**\n * Assert that a condition is true. Otherwise, throws an error.\n * @param condition Condition to test.\n * @param error Optional error message or error instance to throw.\n */\nexport function assert(condition: boolean, error: string | Error = \"Assertion failed\"): asserts condition {\n    if (!condition) {\n        if (error instanceof Error) {\n            throw error;\n        } else {\n            throw new Error(error);\n        }\n    }\n}\n"]}

package/lib/common/cameraKitUserAgent.d.ts

@@ -0,0 +1,34 @@
+declare type BrandArray = Array<{
+    brand: string;
+    version: string;
+}>;
+interface NavigatorUAData {
+    brands: BrandArray;
+    mobile: boolean;
+    platform: string;
+}
+declare global {
+    interface Navigator {
+        userAgentData?: NavigatorUAData;
+    }
+}
+/** @internal */
+export interface CameraKitUserAgent {
+    osType: string;
+    osVersion: string;
+    locale: string;
+    sdkShortVersion: string;
+    sdkLongVersion: string;
+    flavor: "release" | "debug";
+    lensCoreVersion: string;
+    deviceModel: string;
+    browser: {
+        brand: string;
+        version: string;
+    };
+    origin: string;
+    userAgent: string;
+}
+/** @internal */
+export declare const cameraKitUserAgent: CameraKitUserAgent;
+export {};

package/lib/common/cameraKitUserAgent.js

@@ -0,0 +1,216 @@
+import environment from "../environment.json";
+import lensCoreWasm from "../lensCoreWasmVersions.json";
+import { locale } from "./locale";
+/**
+ * Parse the platform (i.e. OS) version.
+ *
+ * From limited testing, this seems to often produce incorrect results – the userAgent string does not typically include
+ * the actual OS version.
+ *
+ * Better results could be obtained from [NavigatorUAData.getHighEntropyValues]
+ * (https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData/getHighEntropyValues), but this presents two
+ * problems: 1) it's currently only supported on Chrome and 2) browsers may prompt the user for permission to share
+ * this information.
+ *
+ * So, at least for now, we'll be satisfied with the incorrect version number.
+ */
+function parsePlatformVersion(userAgent) {
+    // possible platform version values inside of user agent string
+    // " 11;"
+    // " 10_15_7)"
+    // " 13_5_1 "
+    // " 10.0;"
+    // " 15_1 "
+    const versionMatch = userAgent.match(/\s([\d][\d_.]*[\d])(;|\)|\s)/);
+    if (versionMatch != null) {
+        return versionMatch[1].replace(/_/g, ".");
+    }
+    return "";
+}
+/**
+ * In the future, we may invest in more robust device-detection (e.g. a UA string database), but for now this will give
+ * us some sense of device usage.
+ */
+function parseDeviceModel(userAgent) {
+    // from user agent like "(Linux; Android 11; Pixel 2)" extact "Pixel 2"
+    const userAgentWithModel = userAgent.match(/;[^;]+?;([^\)]+?)\)/);
+    if (userAgentWithModel) {
+        return userAgentWithModel[1].trim();
+    }
+    // from user agent like "... (iPad; CPU OS 15_1 like Mac OS X) ..." extract "IPad"
+    const userAgentWithModel2 = userAgent.match(/\(([^;]+);/);
+    if (userAgentWithModel2) {
+        return userAgentWithModel2[1].trim();
+    }
+    return "unknown";
+}
+/**
+ * Some browsers (e.g. Safari) do not support the `Navigator.userAgentData` API. We'll attempt a sort of polyfill by
+ * parsing the data found in [NavigatorUAData](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData) from
+ * the raw user agent string.
+ */
+function parseUserAgentData(userAgent) {
+    let brand;
+    // Parse UA string for Chromium-based browsers (e.g. Chrome, Edge)
+    if (/Chrome/.test(userAgent)) {
+        const versionMatch = userAgent.match(/Chrome\/([\d.]+)/);
+        brand = {
+            brand: "Chrome",
+            version: versionMatch !== null ? versionMatch[1] : "unknown",
+        };
+    }
+    // Parse UA string for Safari (very important for this to only be done if Chrome is not found – Chrome userAgent
+    // strings will contain "Safari")
+    else if (/Safari/.test(userAgent)) {
+        let versionMatch = userAgent.match(/Version\/([\d.]+)/);
+        if (versionMatch === null)
+            versionMatch = userAgent.match(/Safari\/([\d.]+)/);
+        brand = {
+            brand: "Safari",
+            version: versionMatch !== null ? versionMatch[1] : "unknown",
+        };
+    }
+    // Parse UA for unknown browser.
+    // TODO: will be changed, default value support should be added on a COF server side.
+    else {
+        brand = {
+            brand: "Firefox",
+            version: "0",
+        };
+    }
+    // We're not using `mobile` for anything, and we have no consistent way to determine this from the UA string.
+    // We'll set it to false, but this should not be used – instead, we'll need to rely on more sophisticated methods
+    // (e.g. a userAgent database) to determine actual device.
+    const mobile = false;
+    const platform = parsePlaftformName(userAgent);
+    return {
+        brands: [brand],
+        mobile,
+        platform,
+    };
+}
+function normalizeBrands(brands) {
+    const knownBrands = new Map([
+        ["Chrome", "Chrome"],
+        ["Chromium", "Chrome"],
+        ["Firefox", "Firefox"],
+        ["Microsoft Edge", "Chrome"],
+        ["Safari", "Safari"],
+    ]);
+    const normalizedBrands = brands
+        .filter(({ brand }) => knownBrands.has(brand))
+        .map((brand) => {
+        return {
+            // Safety: we've filtered out brands which do not appear as keys in `knownBrands`, so this cannot return
+            // undefined.
+            brand: knownBrands.get(brand.brand),
+            version: brand.version,
+        };
+    });
+    // TODO: default "unknown" value should be added on COF server side. For now we'll use Firefox.
+    if (normalizedBrands.length === 0)
+        return [{ brand: "Firefox", version: "0" }];
+    return normalizedBrands;
+}
+/* eslint-disable max-len */
+/**
+ * We must ensure the data we get from `navigator.userAgentData` is normalized to match what our backend expects to
+ * see in our custom CameraKitWeb userAgent string.
+ *
+ * This string is defined here:
+ * https://github.sc-corp.net/Snapchat/useragent/blob/9333afe7cc6ac00503ad46cb234bcf94006dff98/java/useragent/src/main/java/snapchat/client/UserAgent.java#L124
+ */
+/* eslint-enable */
+function normalizeUserAgentData(userAgentData) {
+    return {
+        brands: normalizeBrands(userAgentData.brands),
+        mobile: userAgentData.mobile,
+        platform: parsePlaftformName(userAgentData.platform),
+    };
+}
+function parsePlaftformName(userAgent) {
+    const knownPlatforms = new Map([
+        ["android", "android"],
+        ["linux", "linux"],
+        ["iphone os", "ios"],
+        ["ipad", "ipados"],
+        ["mac os", "macos"],
+        ["macos", "macos"],
+        ["windows", "windows"],
+    ]);
+    const normalizedUserAgent = userAgent.toLowerCase();
+    for (const [match, platform] of knownPlatforms.entries()) {
+        if (normalizedUserAgent.includes(match))
+            return platform;
+    }
+    return "unknown";
+}
+/**
+ * We'll use the application's origin as an identifier – this isn't used for any kind of authentication, but it may be
+ * useful metadata to have in the future.
+ *
+ * We also need to handle cases in which the SDK is used in a child browsing context (e.g. an iframe), which may not
+ * have a hostname – in this case we'll check each ancestor context until we find a valid hostname.
+ */
+function parseApplicationOrigin() {
+    var _a, _b;
+    let origin = location.hostname;
+    // Firefox does not implement ancestorOrigins, so we need a fallback.
+    // Context here: https://github.com/whatwg/html/issues/1918
+    const ancestorOrigins = location.ancestorOrigins === undefined
+        ? [window.parent.origin, (_b = (_a = window.top) === null || _a === void 0 ? void 0 : _a.origin) !== null && _b !== void 0 ? _b : ""]
+        : Array.from(location.ancestorOrigins);
+    while (origin === "" && ancestorOrigins.length > 0) {
+        // Safety: ancestorOrigins must contain at least one element, so shift() will always be defined.
+        origin = new URL(ancestorOrigins.shift()).hostname;
+    }
+    return origin;
+}
+function getCameraKitUserAgent() {
+    const userAgent = navigator.userAgent;
+    // [NavigatorUAData](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData) is currently only
+    // available on Chromium-based browsers – it's nice because it gives us clear, well-documented information. But
+    // we'll have to fallback to parsing the userAgent string when it's not available.
+    const userAgentData = navigator.userAgentData !== undefined
+        ? normalizeUserAgentData(navigator.userAgentData)
+        : parseUserAgentData(userAgent);
+    const platformVersion = parsePlatformVersion(userAgent);
+    const deviceModel = parseDeviceModel(userAgent);
+    // In cases where we've parsed the userAgent string to find the brand, there will only ever be a single brand –
+    // in browsers which support NavigatorUAData there could be more than one (e.g. Chrome and Chromium), but they
+    // should be equivalent for our purposes.
+    const browser = userAgentData.brands[0];
+    const origin = parseApplicationOrigin();
+    const sdkLongVersion = environment.PACKAGE_VERSION;
+    // Remove any `-prerelease` or `+buildmetadata` portions from the semver string.
+    const sdkShortVersion = sdkLongVersion.replace(/[-+]\S+$/, "");
+    // Set this to `debug` manually while testing / root-causing.
+    const flavor = "release";
+    // This full string is defined here:
+    // eslint-disable-next-line max-len
+    // https://github.sc-corp.net/Snapchat/useragent/blob/9333afe7cc6ac00503ad46cb234bcf94006dff98/java/useragent/src/main/java/snapchat/client/UserAgent.java#L124
+    const cameraKitUserAgent = `CameraKitWeb/${sdkShortVersion} ` +
+        `${flavor === "release" ? "" : "DEBUG"}` +
+        `(${deviceModel}; ${userAgentData.platform} ${platformVersion}) ` +
+        `${browser.brand}/${browser.version} ` +
+        `Core/${lensCoreWasm.version} ` +
+        // We overload appId, using the origin instead of the true appId parsed from the apiToken -- we do this because
+        // origin is human-readable, and this is used to populate the appId dimension in operational metrics.
+        `AppId/${origin}`;
+    return {
+        osType: userAgentData.platform,
+        osVersion: platformVersion,
+        locale,
+        sdkShortVersion,
+        sdkLongVersion,
+        flavor,
+        lensCoreVersion: `${lensCoreWasm.version}`,
+        deviceModel,
+        browser,
+        origin,
+        userAgent: cameraKitUserAgent,
+    };
+}
+/** @internal */
+export const cameraKitUserAgent = getCameraKitUserAgent();
+//# sourceMappingURL=cameraKitUserAgent.js.map

package/lib/common/cameraKitUserAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraKitUserAgent.js","sourceRoot":"","sources":["../../src/common/cameraKitUserAgent.ts"],"names":[],"mappings":"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","sourcesContent":["import environment from \"../environment.json\";\nimport lensCoreWasm from \"../lensCoreWasmVersions.json\";\nimport { locale } from \"./locale\";\n\ntype BrandArray = Array<{ brand: string; version: string }>;\n\ninterface NavigatorUAData {\n    brands: BrandArray;\n    mobile: boolean;\n    platform: string;\n}\n\ndeclare global {\n    interface Navigator {\n        userAgentData?: NavigatorUAData;\n    }\n}\n\n/**\n * Parse the platform (i.e. OS) version.\n *\n * From limited testing, this seems to often produce incorrect results – the userAgent string does not typically include\n * the actual OS version.\n *\n * Better results could be obtained from [NavigatorUAData.getHighEntropyValues]\n * (https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData/getHighEntropyValues), but this presents two\n * problems: 1) it's currently only supported on Chrome and 2) browsers may prompt the user for permission to share\n * this information.\n *\n * So, at least for now, we'll be satisfied with the incorrect version number.\n */\nfunction parsePlatformVersion(userAgent: string) {\n    // possible platform version values inside of user agent string\n    // \" 11;\"\n    // \" 10_15_7)\"\n    // \" 13_5_1 \"\n    // \" 10.0;\"\n    // \" 15_1 \"\n    const versionMatch = userAgent.match(/\\s([\\d][\\d_.]*[\\d])(;|\\)|\\s)/);\n\n    if (versionMatch != null) {\n        return versionMatch[1].replace(/_/g, \".\");\n    }\n\n    return \"\";\n}\n\n/**\n * In the future, we may invest in more robust device-detection (e.g. a UA string database), but for now this will give\n * us some sense of device usage.\n */\nfunction parseDeviceModel(userAgent: string) {\n    // from user agent like \"(Linux; Android 11; Pixel 2)\" extact \"Pixel 2\"\n    const userAgentWithModel = userAgent.match(/;[^;]+?;([^\\)]+?)\\)/);\n\n    if (userAgentWithModel) {\n        return userAgentWithModel[1].trim();\n    }\n\n    // from user agent like \"... (iPad; CPU OS 15_1 like Mac OS X) ...\" extract \"IPad\"\n    const userAgentWithModel2 = userAgent.match(/\\(([^;]+);/);\n\n    if (userAgentWithModel2) {\n        return userAgentWithModel2[1].trim();\n    }\n\n    return \"unknown\";\n}\n\n/**\n * Some browsers (e.g. Safari) do not support the `Navigator.userAgentData` API. We'll attempt a sort of polyfill by\n * parsing the data found in [NavigatorUAData](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData) from\n * the raw user agent string.\n */\nfunction parseUserAgentData(userAgent: string): NavigatorUAData {\n    let brand: BrandArray[number];\n\n    // Parse UA string for Chromium-based browsers (e.g. Chrome, Edge)\n    if (/Chrome/.test(userAgent)) {\n        const versionMatch = userAgent.match(/Chrome\\/([\\d.]+)/);\n        brand = {\n            brand: \"Chrome\",\n            version: versionMatch !== null ? versionMatch[1] : \"unknown\",\n        };\n    }\n\n    // Parse UA string for Safari (very important for this to only be done if Chrome is not found – Chrome userAgent\n    // strings will contain \"Safari\")\n    else if (/Safari/.test(userAgent)) {\n        let versionMatch = userAgent.match(/Version\\/([\\d.]+)/);\n        if (versionMatch === null) versionMatch = userAgent.match(/Safari\\/([\\d.]+)/);\n        brand = {\n            brand: \"Safari\",\n            version: versionMatch !== null ? versionMatch[1] : \"unknown\",\n        };\n    }\n\n    // Parse UA for unknown browser.\n    // TODO: will be changed, default value support should be added on a COF server side.\n    else {\n        brand = {\n            brand: \"Firefox\",\n            version: \"0\",\n        };\n    }\n\n    // We're not using `mobile` for anything, and we have no consistent way to determine this from the UA string.\n    // We'll set it to false, but this should not be used – instead, we'll need to rely on more sophisticated methods\n    // (e.g. a userAgent database) to determine actual device.\n    const mobile = false;\n    const platform = parsePlaftformName(userAgent);\n\n    return {\n        brands: [brand],\n        mobile,\n        platform,\n    };\n}\n\n/* eslint-disable max-len */\n/**\n * The `brands` array found in [NavigatorUAData](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData) is\n * intentionally designed to discourage standardized processing. This method of extracting brand information will be\n * inherently brittle, and it relies on us matching some well-known brands.\n *\n * For more detail from the spec:\n * See https://wicg.github.io/ua-client-hints/#monkeypatch-html-windoworworkerglobalscope\n * And https://wicg.github.io/ua-client-hints/#grease\n *\n * We also must match the list of known brands allowed by the backend, defined here:\n * https://github.sc-corp.net/Snapchat/useragent/blob/9333afe7cc6ac00503ad46cb234bcf94006dff98/java/useragent/src/main/java/snapchat/client/UserAgent.java#L124\n */\n/* eslint-enable */\ntype KnownBrand = \"Chrome\" | \"Safari\" | \"Firefox\";\nfunction normalizeBrands(brands: BrandArray): BrandArray {\n    const knownBrands = new Map<string, KnownBrand>([\n        [\"Chrome\", \"Chrome\"],\n        [\"Chromium\", \"Chrome\"],\n        [\"Firefox\", \"Firefox\"],\n        [\"Microsoft Edge\", \"Chrome\"],\n        [\"Safari\", \"Safari\"],\n    ]);\n\n    const normalizedBrands = brands\n        .filter(({ brand }) => knownBrands.has(brand))\n        .map((brand) => {\n            return {\n                // Safety: we've filtered out brands which do not appear as keys in `knownBrands`, so this cannot return\n                // undefined.\n                brand: knownBrands.get(brand.brand)!,\n                version: brand.version,\n            };\n        });\n\n    // TODO: default \"unknown\" value should be added on COF server side. For now we'll use Firefox.\n    if (normalizedBrands.length === 0) return [{ brand: \"Firefox\", version: \"0\" }];\n    return normalizedBrands;\n}\n\n/* eslint-disable max-len */\n/**\n * We must ensure the data we get from `navigator.userAgentData` is normalized to match what our backend expects to\n * see in our custom CameraKitWeb userAgent string.\n *\n * This string is defined here:\n * https://github.sc-corp.net/Snapchat/useragent/blob/9333afe7cc6ac00503ad46cb234bcf94006dff98/java/useragent/src/main/java/snapchat/client/UserAgent.java#L124\n */\n/* eslint-enable */\nfunction normalizeUserAgentData(userAgentData: NavigatorUAData): NavigatorUAData {\n    return {\n        brands: normalizeBrands(userAgentData.brands),\n        mobile: userAgentData.mobile,\n        platform: parsePlaftformName(userAgentData.platform),\n    };\n}\n\n/* eslint-disable max-len */\n/**\n * The backend defines the allowed list of known platforms which will pass their RegEx test when found in our custom\n * CameraKitWeb userAgent string.\n *\n * See https://github.sc-corp.net/Snapchat/useragent/blob/9333afe7cc6ac00503ad46cb234bcf94006dff98/java/useragent/src/main/java/snapchat/client/UserAgent.java#L124\n */\n/* eslint-enable */\ntype KnownPlatform = \"macos\" | \"windows\" | \"linux\" | \"android\" | \"ios\" | \"ipados\" | \"unknown\";\nfunction parsePlaftformName(userAgent: string): KnownPlatform {\n    const knownPlatforms = new Map<string, KnownPlatform>([\n        [\"android\", \"android\"],\n        [\"linux\", \"linux\"],\n        [\"iphone os\", \"ios\"],\n        [\"ipad\", \"ipados\"],\n        [\"mac os\", \"macos\"],\n        [\"macos\", \"macos\"],\n        [\"windows\", \"windows\"],\n    ]);\n\n    const normalizedUserAgent = userAgent.toLowerCase();\n    for (const [match, platform] of knownPlatforms.entries()) {\n        if (normalizedUserAgent.includes(match)) return platform;\n    }\n    return \"unknown\";\n}\n\n/**\n * We'll use the application's origin as an identifier – this isn't used for any kind of authentication, but it may be\n * useful metadata to have in the future.\n *\n * We also need to handle cases in which the SDK is used in a child browsing context (e.g. an iframe), which may not\n * have a hostname – in this case we'll check each ancestor context until we find a valid hostname.\n */\nfunction parseApplicationOrigin(): string {\n    let origin = location.hostname;\n    // Firefox does not implement ancestorOrigins, so we need a fallback.\n    // Context here: https://github.com/whatwg/html/issues/1918\n    const ancestorOrigins =\n        location.ancestorOrigins === undefined\n            ? [window.parent.origin, window.top?.origin ?? \"\"]\n            : Array.from(location.ancestorOrigins);\n\n    while (origin === \"\" && ancestorOrigins.length > 0) {\n        // Safety: ancestorOrigins must contain at least one element, so shift() will always be defined.\n        origin = new URL(ancestorOrigins.shift()!).hostname;\n    }\n    return origin;\n}\n\nfunction getCameraKitUserAgent(): CameraKitUserAgent {\n    const userAgent = navigator.userAgent;\n    // [NavigatorUAData](https://developer.mozilla.org/en-US/docs/Web/API/NavigatorUAData) is currently only\n    // available on Chromium-based browsers – it's nice because it gives us clear, well-documented information. But\n    // we'll have to fallback to parsing the userAgent string when it's not available.\n    const userAgentData =\n        navigator.userAgentData !== undefined\n            ? normalizeUserAgentData(navigator.userAgentData)\n            : parseUserAgentData(userAgent);\n\n    const platformVersion = parsePlatformVersion(userAgent);\n    const deviceModel = parseDeviceModel(userAgent);\n\n    // In cases where we've parsed the userAgent string to find the brand, there will only ever be a single brand –\n    // in browsers which support NavigatorUAData there could be more than one (e.g. Chrome and Chromium), but they\n    // should be equivalent for our purposes.\n    const browser = userAgentData.brands[0];\n    const origin = parseApplicationOrigin();\n\n    const sdkLongVersion = environment.PACKAGE_VERSION;\n    // Remove any `-prerelease` or `+buildmetadata` portions from the semver string.\n    const sdkShortVersion = sdkLongVersion.replace(/[-+]\\S+$/, \"\");\n\n    // Set this to `debug` manually while testing / root-causing.\n    const flavor: \"release\" | \"debug\" = \"release\";\n\n    // This full string is defined here:\n    // eslint-disable-next-line max-len\n    // https://github.sc-corp.net/Snapchat/useragent/blob/9333afe7cc6ac00503ad46cb234bcf94006dff98/java/useragent/src/main/java/snapchat/client/UserAgent.java#L124\n    const cameraKitUserAgent =\n        `CameraKitWeb/${sdkShortVersion} ` +\n        `${flavor === \"release\" ? \"\" : \"DEBUG\"}` +\n        `(${deviceModel}; ${userAgentData.platform} ${platformVersion}) ` +\n        `${browser.brand}/${browser.version} ` +\n        `Core/${lensCoreWasm.version} ` +\n        // We overload appId, using the origin instead of the true appId parsed from the apiToken -- we do this because\n        // origin is human-readable, and this is used to populate the appId dimension in operational metrics.\n        `AppId/${origin}`;\n\n    return {\n        osType: userAgentData.platform,\n        osVersion: platformVersion,\n        locale,\n        sdkShortVersion,\n        sdkLongVersion,\n        flavor,\n        lensCoreVersion: `${lensCoreWasm.version}`,\n        deviceModel,\n        browser,\n        origin,\n        userAgent: cameraKitUserAgent,\n    };\n}\n\n/** @internal */\nexport interface CameraKitUserAgent {\n    osType: string;\n    osVersion: string;\n    locale: string;\n    sdkShortVersion: string;\n    sdkLongVersion: string;\n    flavor: \"release\" | \"debug\";\n    lensCoreVersion: string;\n    deviceModel: string;\n    browser: { brand: string; version: string };\n    origin: string;\n    userAgent: string;\n}\n\n/** @internal */\nexport const cameraKitUserAgent = getCameraKitUserAgent();\n"]}

package/lib/common/copyDefinedProperties.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Copy only those properties of an object which are not undefined.
+ *
+ * This can be useful when using `Object.assign(foo, bar)` or `{ ...foo, ...bar }` to copy values from one object to
+ * another. There's a (rather annoying) difference between a property not existing in an object and that property
+ * existing but having an undefined value. When copying values using either of the methods above, it's generally
+ * expected that undefined properties won't overwrite defined properties. But that's not the behavior – this helper
+ * function is needed to ensure undefined properties in `bar` don't clobber corresponding properties in `foo`.
+ *
+ * @param obj Any object, possibly with properties whose values are undefined.
+ * @returns A copy of the input object, without keys whose values were undefined.
+ */
+export declare function copyDefinedProperties<T extends {}>(obj: T): T;

package/lib/common/copyDefinedProperties.js

@@ -0,0 +1,16 @@
+/**
+ * Copy only those properties of an object which are not undefined.
+ *
+ * This can be useful when using `Object.assign(foo, bar)` or `{ ...foo, ...bar }` to copy values from one object to
+ * another. There's a (rather annoying) difference between a property not existing in an object and that property
+ * existing but having an undefined value. When copying values using either of the methods above, it's generally
+ * expected that undefined properties won't overwrite defined properties. But that's not the behavior – this helper
+ * function is needed to ensure undefined properties in `bar` don't clobber corresponding properties in `foo`.
+ *
+ * @param obj Any object, possibly with properties whose values are undefined.
+ * @returns A copy of the input object, without keys whose values were undefined.
+ */
+export function copyDefinedProperties(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([_, value]) => value !== undefined));
+}
+//# sourceMappingURL=copyDefinedProperties.js.map

package/lib/common/copyDefinedProperties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copyDefinedProperties.js","sourceRoot":"","sources":["../../src/common/copyDefinedProperties.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAe,GAAM;IACtD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAM,CAAC;AACpG,CAAC","sourcesContent":["/**\n * Copy only those properties of an object which are not undefined.\n *\n * This can be useful when using `Object.assign(foo, bar)` or `{ ...foo, ...bar }` to copy values from one object to\n * another. There's a (rather annoying) difference between a property not existing in an object and that property\n * existing but having an undefined value. When copying values using either of the methods above, it's generally\n * expected that undefined properties won't overwrite defined properties. But that's not the behavior – this helper\n * function is needed to ensure undefined properties in `bar` don't clobber corresponding properties in `foo`.\n *\n * @param obj Any object, possibly with properties whose values are undefined.\n * @returns A copy of the input object, without keys whose values were undefined.\n */\nexport function copyDefinedProperties<T extends {}>(obj: T): T {\n    return Object.fromEntries(Object.entries(obj).filter(([_, value]) => value !== undefined)) as T;\n}\n"]}

package/lib/common/entries.d.ts

@@ -0,0 +1,3 @@
+export declare const entries: <T extends {
+    [s: string]: U;
+} | ArrayLike<U>, U>(o: T) => [keyof T, T[keyof T]][];

package/lib/common/entries.js

@@ -0,0 +1,3 @@
+// `Object.entries` does not use `keyof` types, so it loses type specificity. We'll fix this with a wrapper.
+export const entries = (o) => Object.entries(o);
+//# sourceMappingURL=entries.js.map

package/lib/common/entries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entries.js","sourceRoot":"","sources":["../../src/common/entries.ts"],"names":[],"mappings":"AAAA,4GAA4G;AAC5G,MAAM,CAAC,MAAM,OAAO,GAAG,CAAiD,CAAI,EAAgC,EAAE,CAC1G,MAAM,CAAC,OAAO,CAAC,CAAC,CAAiC,CAAC","sourcesContent":["// `Object.entries` does not use `keyof` types, so it loses type specificity. We'll fix this with a wrapper.\nexport const entries = <T extends { [s: string]: U } | ArrayLike<U>, U>(o: T): Array<[keyof T, T[keyof T]]> =>\n    Object.entries(o) as Array<[keyof T, T[keyof T]]>;\n"]}

package/lib/common/errorHelpers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns a stack trace for a given error, and also appends the stack trace of any nested error, if one exists.
+ * @param error Error to stringify.
+ * @returns Error stack trace.
+ */
+export declare function stringifyError(error: Error): string;
+/**
+ * If given a value of type Error, return it – otherwise wrap the value in an Error.
+ */
+export declare function ensureError(error: unknown): Error;

package/lib/common/errorHelpers.js

@@ -0,0 +1,24 @@
+/**
+ * Returns a stack trace for a given error, and also appends the stack trace of any nested error, if one exists.
+ * @param error Error to stringify.
+ * @returns Error stack trace.
+ */
+export function stringifyError(error) {
+    var _a;
+    const outer = (_a = error.stack) !== null && _a !== void 0 ? _a : "";
+    return error.cause ? `${outer}\nCaused By: ${stringifyError(ensureError(error.cause))}` : outer;
+}
+/**
+ * If given a value of type Error, return it – otherwise wrap the value in an Error.
+ */
+export function ensureError(error) {
+    if (error instanceof Error)
+        return error;
+    try {
+        return new Error(`Non-Error type exception thrown. Serialized error value: ${JSON.stringify(error)}`);
+    }
+    catch (_) {
+        return new Error("Non-Error type exception thrown. Original error value could not be serialized.");
+    }
+}
+//# sourceMappingURL=errorHelpers.js.map

package/lib/common/errorHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorHelpers.js","sourceRoot":"","sources":["../../src/common/errorHelpers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,KAAY;;IACvC,MAAM,KAAK,GAAG,MAAA,KAAK,CAAC,KAAK,mCAAI,EAAE,CAAC;IAChC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,gBAAgB,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACpG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACtC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzC,IAAI;QACA,OAAO,IAAI,KAAK,CAAC,4DAA4D,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;KACzG;IAAC,OAAO,CAAC,EAAE;QACR,OAAO,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;KACtG;AACL,CAAC","sourcesContent":["/**\n * Returns a stack trace for a given error, and also appends the stack trace of any nested error, if one exists.\n * @param error Error to stringify.\n * @returns Error stack trace.\n */\nexport function stringifyError(error: Error): string {\n    const outer = error.stack ?? \"\";\n    return error.cause ? `${outer}\\nCaused By: ${stringifyError(ensureError(error.cause))}` : outer;\n}\n\n/**\n * If given a value of type Error, return it – otherwise wrap the value in an Error.\n */\nexport function ensureError(error: unknown): Error {\n    if (error instanceof Error) return error;\n\n    try {\n        return new Error(`Non-Error type exception thrown. Serialized error value: ${JSON.stringify(error)}`);\n    } catch (_) {\n        return new Error(\"Non-Error type exception thrown. Original error value could not be serialized.\");\n    }\n}\n"]}

package/lib/common/getFilename.d.ts

@@ -0,0 +1 @@
+export declare function getFilename(lensUri: string): string;

package/lib/common/getFilename.js

@@ -0,0 +1,4 @@
+export function getFilename(lensUri) {
+    return lensUri.substring(lensUri.lastIndexOf("/") + 1);
+}
+//# sourceMappingURL=getFilename.js.map

package/lib/common/getFilename.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFilename.js","sourceRoot":"","sources":["../../src/common/getFilename.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,WAAW,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["export function getFilename(lensUri: string) {\n    return lensUri.substring(lensUri.lastIndexOf(\"/\") + 1);\n}\n"]}

package/lib/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./getFilename";
+export * from "./loadScript";

package/lib/common/index.js

@@ -0,0 +1,3 @@
+export * from "./getFilename";
+export * from "./loadScript";
+//# sourceMappingURL=index.js.map

package/lib/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC","sourcesContent":["export * from \"./getFilename\";\nexport * from \"./loadScript\";\n"]}

package/lib/common/loadScript.d.ts

@@ -0,0 +1 @@
+export declare function loadScript(scriptUri: string): Promise<void>;

package/lib/common/loadScript.js

@@ -0,0 +1,11 @@
+export function loadScript(scriptUri) {
+    return new Promise((resolve, reject) => {
+        const scriptElement = document.createElement("script");
+        scriptElement.src = scriptUri;
+        scriptElement.async = true;
+        scriptElement.addEventListener("load", () => resolve(), { once: true });
+        scriptElement.addEventListener("error", (event) => reject(event), { once: true });
+        document.body.appendChild(scriptElement);
+    });
+}
+//# sourceMappingURL=loadScript.js.map

package/lib/common/loadScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadScript.js","sourceRoot":"","sources":["../../src/common/loadScript.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,SAAiB;IACxC,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACvD,aAAa,CAAC,GAAG,GAAG,SAAS,CAAC;QAC9B,aAAa,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,aAAa,CAAC,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxE,aAAa,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["export function loadScript(scriptUri: string) {\n    return new Promise<void>((resolve, reject) => {\n        const scriptElement = document.createElement(\"script\");\n        scriptElement.src = scriptUri;\n        scriptElement.async = true;\n        scriptElement.addEventListener(\"load\", () => resolve(), { once: true });\n        scriptElement.addEventListener(\"error\", (event) => reject(event), { once: true });\n        document.body.appendChild(scriptElement);\n    });\n}\n"]}

package/lib/common/locale.d.ts

@@ -0,0 +1,2 @@
+export declare const locale: string;
+export declare const fullLocale: string;

package/lib/common/locale.js

@@ -0,0 +1,11 @@
+export const locale = navigator.language;
+// Below adds qvalue to languages as per a backend issue:
+// https://github.sc-corp.net/Snapchat/phantom/pull/196781
+// More on qvalues: https://developer.mozilla.org/en-US/docs/Glossary/Quality_values
+export const fullLocale = navigator.languages
+    .map((lang, index) => {
+    const qvalue = Math.max(0, (10 - index) / 10);
+    return `${lang};q=${qvalue.toFixed(1)}`;
+})
+    .join(", ");
+//# sourceMappingURL=locale.js.map

package/lib/common/locale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.js","sourceRoot":"","sources":["../../src/common/locale.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC;AAEzC,yDAAyD;AACzD,0DAA0D;AAC1D,oFAAoF;AACpF,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC,SAAS;KACxC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;IACjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,OAAO,GAAG,IAAI,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5C,CAAC,CAAC;KACD,IAAI,CAAC,IAAI,CAAC,CAAC","sourcesContent":["export const locale = navigator.language;\n\n// Below adds qvalue to languages as per a backend issue:\n// https://github.sc-corp.net/Snapchat/phantom/pull/196781\n// More on qvalues: https://developer.mozilla.org/en-US/docs/Glossary/Quality_values\nexport const fullLocale = navigator.languages\n    .map((lang, index) => {\n        const qvalue = Math.max(0, (10 - index) / 10);\n        return `${lang};q=${qvalue.toFixed(1)}`;\n    })\n    .join(\", \");\n"]}