@snap/camera-kit 0.17.0 → 0.18.1

package/dist/persistence/ExpiringPersistence.js

@@ -0,0 +1,64 @@
+import { __awaiter } from "tslib";
+import { getLogger } from "../logger/logger";
+const logger = getLogger("ExpiringPersistence");
+export class ExpiringPersistence {
+    constructor(expiration, persistence) {
+        this.expiration = expiration;
+        this.persistence = persistence;
+        this.removeExpired().catch((error) => {
+            logger.warn("Failed to cleanup expired entries on startup.", error);
+        });
+    }
+    get size() {
+        return this.persistence.size;
+    }
+    retrieve(key) {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const [expiry, value] = (_a = (yield this.persistence.retrieve(key))) !== null && _a !== void 0 ? _a : [];
+            if (value === undefined || expiry === undefined)
+                return undefined;
+            if (Date.now() > expiry) {
+                yield this.persistence.remove(key).catch((error) => {
+                    logger.warn(`Key ${key} is expired, but removing it from persistence failed.`, error);
+                });
+                return undefined;
+            }
+            return value;
+        });
+    }
+    retrieveAll() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const now = Date.now();
+            return (yield this.persistence.retrieveAll()).filter(([, [expiry]]) => expiry >= now).map(([, v]) => v);
+        });
+    }
+    remove(key) {
+        return this.persistence.remove(key);
+    }
+    removeAll() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield this.persistence.removeAll();
+            return results.map(([, v]) => v);
+        });
+    }
+    removeExpired() {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (const [key, [expiry]] of yield this.persistence.retrieveAll()) {
+                if (Date.now() >= expiry) {
+                    yield this.persistence
+                        .remove(key)
+                        .catch((error) => logger.warn(`Failed to remove expired key ${key}.`, error));
+                }
+            }
+        });
+    }
+    store(keyOrValue, maybeValue) {
+        const [key, value] = maybeValue === undefined ? [undefined, keyOrValue] : [keyOrValue, maybeValue];
+        const expiry = Date.now() + this.expiration(value) * 1000;
+        return key === undefined
+            ? this.persistence.store([expiry, value])
+            : this.persistence.store(key, [expiry, value]);
+    }
+}
+//# sourceMappingURL=ExpiringPersistence.js.map

package/dist/persistence/ExpiringPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpiringPersistence.js","sourceRoot":"","sources":["../../src/persistence/ExpiringPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLogger } from \"../logger/logger\";\nimport type { Persistence, ValidKey } from \"./Persistence\";\n\nconst logger = getLogger(\"ExpiringPersistence\");\n\n/**\n * Create a Persistence that will remove entries after they expire.\n *\n * An expiration function must be provided, which is called each time a value is stored. It must return the expiration\n * time for that value, given in seconds from now. For example, to expire a value 24 hours after it is stored, the\n * expiration function should return 86400 (the number of seconds in 24 hours).\n */\nexport class ExpiringPersistence<T> implements Persistence<T> {\n    constructor(\n        private readonly expiration: (value: T) => number,\n        private readonly persistence: Persistence<[number, T]>\n    ) {\n        this.removeExpired().catch((error) => {\n            logger.warn(\"Failed to cleanup expired entries on startup.\", error);\n        });\n    }\n\n    get size(): number {\n        return this.persistence.size;\n    }\n\n    async retrieve(key: ValidKey): Promise<T | undefined> {\n        const [expiry, value] = (await this.persistence.retrieve(key)) ?? [];\n        if (value === undefined || expiry === undefined) return undefined;\n\n        if (Date.now() > expiry) {\n            await this.persistence.remove(key).catch((error) => {\n                logger.warn(`Key ${key} is expired, but removing it from persistence failed.`, error);\n            });\n            return undefined;\n        }\n        return value;\n    }\n\n    async retrieveAll(): Promise<Array<[ValidKey, T]>> {\n        const now = Date.now();\n        return (await this.persistence.retrieveAll()).filter(([, [expiry]]) => expiry >= now).map(([, v]) => v);\n    }\n\n    remove(key: ValidKey): Promise<void> {\n        return this.persistence.remove(key);\n    }\n\n    async removeAll(): Promise<T[]> {\n        const results = await this.persistence.removeAll();\n        return results.map(([, v]) => v);\n    }\n\n    async removeExpired(): Promise<void> {\n        for (const [key, [expiry]] of await this.persistence.retrieveAll()) {\n            if (Date.now() >= expiry) {\n                await this.persistence\n                    .remove(key)\n                    .catch((error) => logger.warn(`Failed to remove expired key ${key}.`, error));\n            }\n        }\n    }\n\n    store(value: T): Promise<ValidKey>;\n    store(key: ValidKey, value: T): Promise<ValidKey>;\n    store(keyOrValue: T | ValidKey, maybeValue?: T): Promise<ValidKey> {\n        const [key, value] =\n            maybeValue === undefined ? [undefined, keyOrValue as T] : [keyOrValue as ValidKey, maybeValue];\n        const expiry = Date.now() + this.expiration(value) * 1000;\n        return key === undefined\n            ? this.persistence.store([expiry, value])\n            : this.persistence.store(key, [expiry, value]);\n    }\n}\n"]}

package/dist/persistence/IndexedDBPersistence.d.ts

@@ -0,0 +1,48 @@
+import type { Persistence, ValidKey } from "./Persistence";
+/**
+ * Specify a database name for this {@link IndexedDBPersistence} instance to use.
+ * This will be prefixed by `Snap.CameraKit`.
+ *
+ * A databaseVersion and objectStore may also be specified. Keep in mind the following limitations:
+ * - IndexedDBPersistence currently does nothing to migrate data between versions.
+ * - If two different IndexedDBPersistence instances use the same databaseName, they must also use the same objectStore.
+ * Otherwise a race condition will occur which prevents the creation of all but one objectStore per database.
+ */
+export interface IndexedDBPersistenceOptions {
+    databaseName: string;
+    databaseVersion?: number;
+    objectStore?: string;
+}
+/**
+ * A simple key/value persistence using an IndexedDB storage backend.
+ *
+ * See [Using IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB) for an
+ * introduction to how IndexedDB works, its APIs, and how to use it.
+ *
+ * Note: Currently there is no support for database upgrades. Each instance of this class uses a single IDBObjectStore
+ * object set at instantiation time, and there are no hooks for performing migrations between versions. This may be
+ * added in the future if such functionality is needed.
+ */
+export declare class IndexedDBPersistence<T> implements Persistence<T> {
+    size: number;
+    private db;
+    private readonly databaseName;
+    private readonly databaseVersion?;
+    private readonly objectStore;
+    /**
+     * Construct an {@link IndexedDBPersistence} instance corresponding to a given IndexedDB database version.
+     *
+     * Throws `ConstraintError` if the version number is invalid (e.g. NaN, or less than 1).
+     */
+    constructor(options: IndexedDBPersistenceOptions);
+    retrieve(key: ValidKey): Promise<T | undefined>;
+    retrieveAll(): Promise<Array<[ValidKey, T]>>;
+    remove(key: ValidKey): Promise<void>;
+    removeAll(): Promise<T[]>;
+    store(value: T): Promise<ValidKey>;
+    store(key: ValidKey, value: T): Promise<ValidKey>;
+    private openDatabase;
+    private simpleTransaction;
+    private transaction;
+}
+//# sourceMappingURL=IndexedDBPersistence.d.ts.map

package/dist/persistence/IndexedDBPersistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBPersistence.d.ts","sourceRoot":"","sources":["../../src/persistence/IndexedDBPersistence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA4D3D;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB,CAAC,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IAEb,OAAO,CAAC,EAAE,CAAuB;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IAErC;;;;OAIG;gBACS,OAAO,EAAE,2BAA2B;IAchD,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAIzC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAc5C,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpC,SAAS,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAmBzB,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAClC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;YAgBzC,YAAY;YA8BZ,iBAAiB;YASjB,WAAW;CAwB5B"}

package/dist/persistence/IndexedDBPersistence.js

@@ -0,0 +1,127 @@
+import { __awaiter } from "tslib";
+import { isValidKey } from "./Persistence";
+function wrapRequest(request) {
+    const p = new Promise((resolve, reject) => {
+        request.onsuccess = () => resolve(request.result);
+        request.onerror = () => reject(request.error);
+    });
+    p.request = request;
+    return p;
+}
+function wrapCursorRequest(request) {
+    return new Promise((resolve, reject) => {
+        request.onsuccess = () => {
+            const cursor = request.result;
+            if (!cursor)
+                resolve({ cursor: null, continue: () => Promise.reject() });
+            else
+                resolve({
+                    cursor,
+                    continue: () => {
+                        cursor.continue();
+                        return wrapCursorRequest(request);
+                    },
+                });
+        };
+        request.onerror = () => reject(request.error);
+    });
+}
+export class IndexedDBPersistence {
+    constructor(options) {
+        var _a;
+        this.databaseName = `Snap.CameraKit.${options.databaseName}`;
+        this.databaseVersion = options.databaseVersion;
+        this.objectStore = (_a = options.objectStore) !== null && _a !== void 0 ? _a : options.databaseName;
+        this.db = this.openDatabase(indexedDB.open(this.databaseName, this.databaseVersion));
+        this.size = 0;
+    }
+    retrieve(key) {
+        return this.simpleTransaction("readonly", (store) => store.get(key));
+    }
+    retrieveAll() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = [];
+            const { store, done } = yield this.transaction("readonly");
+            let request = yield wrapCursorRequest(store.openCursor());
+            while (request.cursor) {
+                results.push([request.cursor.primaryKey, request.cursor.value]);
+                request = yield request.continue();
+            }
+            yield done;
+            return results;
+        });
+    }
+    remove(key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.simpleTransaction("readwrite", (store) => store.delete(key));
+            this.size--;
+        });
+    }
+    removeAll() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = [];
+            const { store, done } = yield this.transaction("readwrite");
+            let request = yield wrapCursorRequest(store.openCursor());
+            const deleteRequests = [];
+            while (request.cursor) {
+                results.push(request.cursor.value);
+                deleteRequests.push(wrapRequest(store.delete(request.cursor.key)));
+                request = yield request.continue();
+            }
+            yield Promise.all(deleteRequests.concat(done));
+            this.size = 0;
+            return results;
+        });
+    }
+    store(keyOrValue, maybeValue) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const [key, value] = maybeValue === undefined ? [undefined, keyOrValue] : [keyOrValue, maybeValue];
+            if (!isValidKey(key) && typeof key !== "undefined")
+                throw new TypeError(`IndexedDBPersistence failed to ` + `store a value. Invalid key type: ${typeof key}`);
+            const storedKey = yield this.simpleTransaction("readwrite", (store) => store.put(value, key));
+            this.size++;
+            return storedKey;
+        });
+    }
+    openDatabase(request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const dbPromise = wrapRequest(request);
+            dbPromise.request.onupgradeneeded = () => {
+                try {
+                    dbPromise.request.result.createObjectStore(this.objectStore, { autoIncrement: true });
+                }
+                catch (error) {
+                    if (error instanceof DOMException && error.name === "ConstraintError")
+                        return;
+                    throw error;
+                }
+            };
+            const db = yield dbPromise;
+            db.onclose = () => {
+                this.db = this.openDatabase(indexedDB.open(this.databaseName, this.databaseVersion));
+            };
+            return db;
+        });
+    }
+    simpleTransaction(mode, operation) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { store, done } = yield this.transaction(mode);
+            const [result] = yield Promise.all([wrapRequest(operation(store)), done]);
+            return result;
+        });
+    }
+    transaction(mode) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const db = yield this.db;
+            const tx = db.transaction(this.objectStore, mode);
+            const store = tx.objectStore(this.objectStore);
+            const done = new Promise((resolve, reject) => {
+                tx.oncomplete = () => resolve();
+                tx.onerror = () => reject(tx.error);
+                tx.onabort = () => reject(new DOMException("The transaction was aborted", "AbortError"));
+            });
+            return { tx, store, done };
+        });
+    }
+}
+//# sourceMappingURL=IndexedDBPersistence.js.map

package/dist/persistence/IndexedDBPersistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IndexedDBPersistence.js","sourceRoot":"","sources":["../../src/persistence/IndexedDBPersistence.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Persistence, ValidKey } from \"./Persistence\";\nimport { isValidKey } from \"./Persistence\";\n\ntype IDBRequestPromise<T = any> = Promise<T> & { request: IDBRequest<T> };\n\ninterface EnhancedIDBTransaction {\n    tx: IDBTransaction;\n    store: IDBObjectStore;\n    done: Promise<void>;\n}\n\ninterface EnhancedIDBCursor<T> {\n    cursor: (IDBCursor & { readonly value: T }) | null;\n    continue: () => Promise<EnhancedIDBCursor<T>>;\n}\n\n/**\n * The IndexedDB API makes use of event callbacks that can be cumbersome to use. This method wraps an IDBRequest in a\n * Promise, making it easier to use.\n */\nfunction wrapRequest(request: IDBOpenDBRequest): Promise<IDBDatabase> & { request: IDBOpenDBRequest };\nfunction wrapRequest<T>(request: IDBRequest<T>): IDBRequestPromise<T>;\nfunction wrapRequest(request: IDBRequest): IDBRequestPromise {\n    const p = new Promise((resolve, reject) => {\n        request.onsuccess = () => resolve(request.result);\n        request.onerror = () => reject(request.error);\n    });\n    (p as IDBRequestPromise).request = request;\n    return p as IDBRequestPromise;\n}\n\n/**\n * IndexedDB cursor requests are unique, in that their `onsuccess` handler may be called multiple times. To support\n * this, and allow for an easier-to-use Promise-based API, we wrap the cursor request to support usage like:\n * ```ts\n * let request = await wrapCursorRequest(store.openCursor())\n * while (request.cursor) {\n *   console.log(request.cursor.key, request.cursor.value)\n *   request = await request.continue()\n * }\n * ```\n */\nfunction wrapCursorRequest<T>(request: IDBRequest<IDBCursorWithValue | null>): Promise<EnhancedIDBCursor<T>> {\n    return new Promise((resolve, reject) => {\n        request.onsuccess = () => {\n            const cursor = request.result;\n            if (!cursor) resolve({ cursor: null, continue: () => Promise.reject() });\n            else\n                resolve({\n                    cursor,\n                    continue: () => {\n                        cursor.continue();\n                        return wrapCursorRequest<T>(request);\n                    },\n                });\n        };\n        request.onerror = () => reject(request.error);\n    });\n}\n\n/**\n * Specify a database name for this {@link IndexedDBPersistence} instance to use.\n * This will be prefixed by `Snap.CameraKit`.\n *\n * A databaseVersion and objectStore may also be specified. Keep in mind the following limitations:\n * - IndexedDBPersistence currently does nothing to migrate data between versions.\n * - If two different IndexedDBPersistence instances use the same databaseName, they must also use the same objectStore.\n * Otherwise a race condition will occur which prevents the creation of all but one objectStore per database.\n */\nexport interface IndexedDBPersistenceOptions {\n    databaseName: string;\n    databaseVersion?: number;\n    objectStore?: string;\n}\n\n/**\n * A simple key/value persistence using an IndexedDB storage backend.\n *\n * See [Using IndexedDB](https://developer.mozilla.org/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB) for an\n * introduction to how IndexedDB works, its APIs, and how to use it.\n *\n * Note: Currently there is no support for database upgrades. Each instance of this class uses a single IDBObjectStore\n * object set at instantiation time, and there are no hooks for performing migrations between versions. This may be\n * added in the future if such functionality is needed.\n */\nexport class IndexedDBPersistence<T> implements Persistence<T> {\n    size: number;\n\n    private db: Promise<IDBDatabase>;\n    private readonly databaseName: string;\n    private readonly databaseVersion?: number;\n    private readonly objectStore: string;\n\n    /**\n     * Construct an {@link IndexedDBPersistence} instance corresponding to a given IndexedDB database version.\n     *\n     * Throws `ConstraintError` if the version number is invalid (e.g. NaN, or less than 1).\n     */\n    constructor(options: IndexedDBPersistenceOptions) {\n        // We'll namespace our DB names to A) avoid collisions with host applications and B) be transparent about who\n        // is using persistence.\n        this.databaseName = `Snap.CameraKit.${options.databaseName}`;\n        this.databaseVersion = options.databaseVersion;\n        this.objectStore = options.objectStore ?? options.databaseName;\n\n        // `open()` will throw if the version is invalid -- this is desirable vs. rejecting the `db` promise, since then\n        // the error is only reported when callers try to perform some operation. Instead, we want the instantiating\n        // code to see the error.\n        this.db = this.openDatabase(indexedDB.open(this.databaseName, this.databaseVersion));\n        this.size = 0;\n    }\n\n    retrieve(key: ValidKey): Promise<T | undefined> {\n        return this.simpleTransaction(\"readonly\", (store) => store.get(key));\n    }\n\n    async retrieveAll(): Promise<Array<[ValidKey, T]>> {\n        const results: Array<[ValidKey, T]> = [];\n        const { store, done } = await this.transaction(\"readonly\");\n        let request = await wrapCursorRequest<T>(store.openCursor());\n\n        while (request.cursor) {\n            results.push([request.cursor.primaryKey as ValidKey, request.cursor.value]);\n            request = await request.continue();\n        }\n\n        await done;\n        return results;\n    }\n\n    async remove(key: ValidKey): Promise<void> {\n        await this.simpleTransaction(\"readwrite\", (store) => store.delete(key));\n        this.size--;\n    }\n\n    async removeAll(): Promise<T[]> {\n        const results: T[] = [];\n        const { store, done } = await this.transaction(\"readwrite\");\n        let request = await wrapCursorRequest<T>(store.openCursor());\n        const deleteRequests: Promise<any>[] = [];\n        while (request.cursor) {\n            results.push(request.cursor.value);\n            // If any of the deletes fail (e.g. if the user deletes the object store during the transaction), it will\n            // fail the whole transaction. Since the primary expected cause of this failure mode is that the entire\n            // object store no longer exists, it's unlikely this will result in unbounded DB growth. That said, callers\n            // may want to attempt to retry the removal, or raise an alarm if the persistence size grows unexpectedly.\n            deleteRequests.push(wrapRequest(store.delete(request.cursor.key)));\n            request = await request.continue();\n        }\n        await Promise.all(deleteRequests.concat(done));\n        this.size = 0;\n        return results;\n    }\n\n    async store(value: T): Promise<ValidKey>;\n    async store(key: ValidKey, value: T): Promise<ValidKey>;\n    async store(keyOrValue: T | ValidKey, maybeValue?: T): Promise<ValidKey> {\n        const [key, value] = maybeValue === undefined ? [undefined, keyOrValue] : [keyOrValue, maybeValue];\n\n        // The key must be ValidKey | undefined.\n        if (!isValidKey(key) && typeof key !== \"undefined\")\n            throw new TypeError(`IndexedDBPersistence failed to ` + `store a value. Invalid key type: ${typeof key}`);\n\n        const storedKey = await this.simpleTransaction(\"readwrite\", (store) => store.put(value, key));\n        this.size++;\n\n        // Type safety: we already assert any given key is valid, and if the key is undefined IndexedDB will generate\n        // a numeric key (https://w3c.github.io/IndexedDB/#key-generator).\n        return storedKey as ValidKey;\n    }\n\n    private async openDatabase(request: IDBOpenDBRequest): Promise<IDBDatabase> {\n        // The `open()` call will throw if databaseVersion is invalid (e.g. < 1).\n        const dbPromise = wrapRequest(request);\n        dbPromise.request.onupgradeneeded = () => {\n            try {\n                // The following DOMExceptions may be thrown by `createObjectStore()` – they should all be logically\n                // impossible. We handle the one recoverable exception which could occur below.\n                //\n                // TransactionInactiveError: the database does not exist.\n                // InvalidStateError: `createObjectStore` was called outside a `versionchange` transaction.\n                // InvalidAccessError: `autoIncrement` is true and `keyPath` contains an empty string.\n                dbPromise.request.result.createObjectStore(this.objectStore, { autoIncrement: true });\n            } catch (error) {\n                // ConstraintError is thrown if the object store already exists. Could happen if multiple tabs to the\n                // same domain are opened and race to create the object store. In this case we can safely ignore the\n                // error and continue.\n                if (error instanceof DOMException && error.name === \"ConstraintError\") return;\n                throw error;\n            }\n        };\n        const db = await dbPromise;\n        db.onclose = () => {\n            // The 'close` event fires when the DB is unexpectedly closed (e.g. user clears application data). We'll\n            // attempt to re-open it (which may fail, in which case no further attempts will be made, and all future\n            // transactions will fail).\n            this.db = this.openDatabase(indexedDB.open(this.databaseName, this.databaseVersion));\n        };\n        return db;\n    }\n\n    private async simpleTransaction<R>(\n        mode: IDBTransactionMode,\n        operation: (tx: IDBObjectStore) => IDBRequest<R>\n    ): Promise<R> {\n        const { store, done } = await this.transaction(mode);\n        const [result] = await Promise.all([wrapRequest(operation(store)), done]);\n        return result;\n    }\n\n    private async transaction(mode: IDBTransactionMode): Promise<EnhancedIDBTransaction> {\n        const db = await this.db;\n        // The following DOMExceptions may be thrown – they should all be logically impossible, or could be\n        // triggered by the user deleting or modifying the database (e.g. via DevTools) at the right time. We won't\n        // attempt to recover from them now, but may decide to do so in the future (if we see them in the wild).\n        //\n        // InvalidStateError: `close()` has previously been called on the IDBDatabase\n        // NotFoundError: the object store does not exist.\n        // TypeError: the `mode` parameter is invalid.\n        // InvalidAccessError: the function was called with an empty list of object stores.\n        const tx = db.transaction(this.objectStore, mode);\n\n        // Similarly, the following DOMExceptions may be thrown by `objectStore()`:\n        //\n        // InvalidStateError: the transaction has already completed.\n        // NotFoundError: the object store is not in the transaction's scope.\n        const store = tx.objectStore(this.objectStore);\n        const done = new Promise<void>((resolve, reject) => {\n            tx.oncomplete = () => resolve();\n            tx.onerror = () => reject(tx.error);\n            tx.onabort = () => reject(new DOMException(\"The transaction was aborted\", \"AbortError\"));\n        });\n        return { tx, store, done };\n    }\n}\n"]}

package/dist/persistence/Persistence.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Different persistence mechanisms (e.g. localStorage, IndexedDB) may support different key types. This type should be
+ * a valid key across all concrete Persistence implementations.
+ */
+export type ValidKey = string | number;
+export declare const isValidKey: (key: unknown) => key is ValidKey;
+/**
+ * The abstract Persistence class defines an async interface for interacting with persistent client-side storage. This
+ * is modeled as a simple key/value store.
+ *
+ * Subclasses may be implemented to support a variety of persistence mechanisms – e.g. localStorage, IndexedDB, etc.
+ */
+export declare abstract class Persistence<T> {
+    abstract size: number;
+    abstract retrieve(key: ValidKey): Promise<T | undefined>;
+    abstract retrieveAll(): Promise<Array<[ValidKey, T]>>;
+    abstract remove(key: ValidKey): Promise<void>;
+    abstract removeAll(): Promise<T[]>;
+    /**
+     * Persistence implementations must be capable of generating unique keys, or accepting a unique key from the
+     * caller.
+     */
+    abstract store(value: T): Promise<ValidKey>;
+    abstract store(key: ValidKey, value: T): Promise<ValidKey>;
+}
+//# sourceMappingURL=Persistence.d.ts.map

package/dist/persistence/Persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Persistence.d.ts","sourceRoot":"","sources":["../../src/persistence/Persistence.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,eAAO,MAAM,UAAU,QAAS,OAAO,oBAAwE,CAAC;AAEhH;;;;;GAKG;AACH,8BAAsB,WAAW,CAAC,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAExD,QAAQ,CAAC,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAErD,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAE7C,QAAQ,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;IAElC;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;CAC7D"}

package/dist/persistence/Persistence.js

@@ -0,0 +1,4 @@
+export const isValidKey = (key) => typeof key === "string" || typeof key === "number";
+export class Persistence {
+}
+//# sourceMappingURL=Persistence.js.map

package/dist/persistence/Persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Persistence.js","sourceRoot":"","sources":["../../src/persistence/Persistence.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAY,EAAmB,EAAE,CAAC,OAAO,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,KAAK,QAAQ,CAAC;AAQhH,MAAM,OAAgB,WAAW;CAiBhC","sourcesContent":["/**\n * Different persistence mechanisms (e.g. localStorage, IndexedDB) may support different key types. This type should be\n * a valid key across all concrete Persistence implementations.\n */\nexport type ValidKey = string | number;\n\nexport const isValidKey = (key: unknown): key is ValidKey => typeof key === \"string\" || typeof key === \"number\";\n\n/**\n * The abstract Persistence class defines an async interface for interacting with persistent client-side storage. This\n * is modeled as a simple key/value store.\n *\n * Subclasses may be implemented to support a variety of persistence mechanisms – e.g. localStorage, IndexedDB, etc.\n */\nexport abstract class Persistence<T> {\n    abstract size: number;\n\n    abstract retrieve(key: ValidKey): Promise<T | undefined>;\n\n    abstract retrieveAll(): Promise<Array<[ValidKey, T]>>;\n\n    abstract remove(key: ValidKey): Promise<void>;\n\n    abstract removeAll(): Promise<T[]>;\n\n    /**\n     * Persistence implementations must be capable of generating unique keys, or accepting a unique key from the\n     * caller.\n     */\n    abstract store(value: T): Promise<ValidKey>;\n    abstract store(key: ValidKey, value: T): Promise<ValidKey>;\n}\n"]}

package/dist/platform/assertPlatformSupported.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Throw if the current platform is not capable of running Camera Kit.
+ */
+export declare function assertPlatformSupported(): Promise<void>;
+//# sourceMappingURL=assertPlatformSupported.d.ts.map

package/dist/platform/assertPlatformSupported.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertPlatformSupported.d.ts","sourceRoot":"","sources":["../../src/platform/assertPlatformSupported.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CAI7D"}

package/dist/platform/assertPlatformSupported.js

@@ -0,0 +1,12 @@
+import { __awaiter } from "tslib";
+import { getPlatformCapabilities } from "./platformCapabilities";
+export function assertPlatformSupported() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { wasm, webgl } = yield getPlatformCapabilities();
+        if (!wasm.supported)
+            throw wasm.error;
+        if (!webgl.supported)
+            throw webgl.error;
+    });
+}
+//# sourceMappingURL=assertPlatformSupported.js.map

package/dist/platform/assertPlatformSupported.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertPlatformSupported.js","sourceRoot":"","sources":["../../src/platform/assertPlatformSupported.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAKjE,MAAM,UAAgB,uBAAuB;;QACzC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,uBAAuB,EAAE,CAAC;QACxD,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,CAAC,KAAK,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,SAAS;YAAE,MAAM,KAAK,CAAC,KAAK,CAAC;IAC5C,CAAC;CAAA","sourcesContent":["import { getPlatformCapabilities } from \"./platformCapabilities\";\n\n/**\n * Throw if the current platform is not capable of running Camera Kit.\n */\nexport async function assertPlatformSupported(): Promise<void> {\n    const { wasm, webgl } = await getPlatformCapabilities();\n    if (!wasm.supported) throw wasm.error;\n    if (!webgl.supported) throw webgl.error;\n}\n"]}

package/dist/platform/cameraKitUserAgent.d.ts

@@ -0,0 +1,3 @@
+/** @internal */
+export declare const getCameraKitUserAgent: import("../common/memoize").Memoized<() => string>;
+//# sourceMappingURL=cameraKitUserAgent.d.ts.map

package/dist/platform/cameraKitUserAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraKitUserAgent.d.ts","sourceRoot":"","sources":["../../src/platform/cameraKitUserAgent.ts"],"names":[],"mappings":"AAIA,gBAAgB;AAChB,eAAO,MAAM,qBAAqB,6CAA6C,MAAM,CAiBnF,CAAC"}

package/dist/platform/cameraKitUserAgent.js

@@ -0,0 +1,13 @@
+import { memoize } from "../common/memoize";
+import { getConfigurationOverrides } from "../configurationOverrides";
+import { getPlatformInfo } from "./platformInfo";
+export const getCameraKitUserAgent = memoize(function getCameraKitUserAgent() {
+    var _a;
+    const { browser, deviceModel, origin, osName, osVersion, sdkShortVersion, lensCore } = getPlatformInfo();
+    const { userAgentFlavor } = (_a = getConfigurationOverrides()) !== null && _a !== void 0 ? _a : { userAgentFlavor: "release" };
+    const flavor = userAgentFlavor === "release" ? "" : "DEBUG ";
+    return (`CameraKitWeb/${sdkShortVersion} ${flavor}(${deviceModel}; ${osName} ${osVersion}) ` +
+        `${browser.brand}/${browser.version} Core/${lensCore.version} ` +
+        `AppId/${origin}`);
+});
+//# sourceMappingURL=cameraKitUserAgent.js.map

package/dist/platform/cameraKitUserAgent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cameraKitUserAgent.js","sourceRoot":"","sources":["../../src/platform/cameraKitUserAgent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC,SAAS,qBAAqB;;IACvE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,GAAG,eAAe,EAAE,CAAC;IAGzG,MAAM,EAAE,eAAe,EAAE,GAAG,MAAA,yBAAyB,EAAE,mCAAI,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;IAC1F,MAAM,MAAM,GAAkB,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAK5E,OAAO,CACH,gBAAgB,eAAe,IAAI,MAAM,IAAI,WAAW,KAAK,MAAM,IAAI,SAAS,IAAI;QACpF,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,OAAO,SAAS,QAAQ,CAAC,OAAO,GAAG;QAG/D,SAAS,MAAM,EAAE,CACpB,CAAC;AACN,CAAC,CAAC,CAAC","sourcesContent":["import { memoize } from \"../common/memoize\";\nimport { getConfigurationOverrides } from \"../configurationOverrides\";\nimport { getPlatformInfo } from \"./platformInfo\";\n\n/** @internal */\nexport const getCameraKitUserAgent = memoize(function getCameraKitUserAgent(): string {\n    const { browser, deviceModel, origin, osName, osVersion, sdkShortVersion, lensCore } = getPlatformInfo();\n\n    // Set this to `DEBUG` manually while testing / root-causing.\n    const { userAgentFlavor } = getConfigurationOverrides() ?? { userAgentFlavor: \"release\" };\n    const flavor: \"\" | \"DEBUG \" = userAgentFlavor === \"release\" ? \"\" : \"DEBUG \";\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    return (\n        `CameraKitWeb/${sdkShortVersion} ${flavor}(${deviceModel}; ${osName} ${osVersion}) ` +\n        `${browser.brand}/${browser.version} Core/${lensCore.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});\n"]}

package/dist/platform/platformCapabilities.d.ts

@@ -0,0 +1,58 @@
+import type { XrCapabilities } from "../lens-core-module/generated-types";
+/** @internal */
+export type SupportedCapability<T> = T & {
+    supported: true;
+};
+/** @internal */
+export type UnsupportedCapability = {
+    supported: false;
+    error: Error;
+};
+/** @internal */
+export type Capability<T = void> = SupportedCapability<T> | UnsupportedCapability;
+type WebGlCapability = Capability<{
+    maxTextureSize: number;
+}>;
+type WasmCapability = Capability<{
+    wasmFeatures: number;
+}>;
+/**
+ * Because there may be a large number of WASM-related capabilities, and because these may correspond to various builds
+ * of LensCore, we encode the various WASM capabilities into a single number by bitwise OR-ing together the numbers
+ * corresponding to each capability.
+ *
+ * Since each combindation of capabilities is represented by a single number, we can easily map between that number and
+ * the corresponding LensCore build name that makes use of those capabilities.
+ *
+ * @internal
+ */
+export declare enum WasmFeatures {
+    Default = 0,
+    SIMD = 1,
+    ExceptionHandling = 2
+}
+type WebXrCapability = Capability<XrCapabilities>;
+/**
+ * @returns A Promise containing an object with fields describing the support of various WebXR features. This object's
+ * type is defined by LensCore, as they consume these capabilities and adjust behavior accordingly.
+ *
+ * @internal
+ */
+export declare function getWebXrCapabilities(): Promise<WebXrCapability>;
+/** @internal */
+export interface PlatformCapabilities {
+    webgl: WebGlCapability;
+    wasm: WasmCapability;
+    webxr: WebXrCapability;
+}
+/**
+ * Get information about the current platform capabilities, including:
+ * - WebGL support and various WebGL parameters.
+ * - WASM support and support for various WASM features.
+ * - WebXR support and support for various WebXR features.
+ *
+ * @internal
+ */
+export declare const getPlatformCapabilities: import("../common/memoize").Memoized<() => Promise<PlatformCapabilities>>;
+export {};
+//# sourceMappingURL=platformCapabilities.d.ts.map

package/dist/platform/platformCapabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformCapabilities.d.ts","sourceRoot":"","sources":["../../src/platform/platformCapabilities.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAI1E,gBAAgB;AAChB,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAC7D,gBAAgB;AAChB,MAAM,MAAM,qBAAqB,GAAG;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AACvE,gBAAgB;AAChB,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,IAAI,IAAI,mBAAmB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC;AAMlF,KAAK,eAAe,GAAG,UAAU,CAAC;IAAE,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AA8C9D,KAAK,cAAc,GAAG,UAAU,CAAC;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE3D;;;;;;;;;GASG;AACH,oBAAY,YAAY;IACpB,OAAO,IAAa;IACpB,IAAI,IAAa;IACjB,iBAAiB,IAAa;CACjC;AAoCD,KAAK,eAAe,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;AAalD;;;;;GAKG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,eAAe,CAAC,CAuBrE;AAED,gBAAgB;AAChB,MAAM,WAAW,oBAAoB;IACjC,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,6CAAqD,QAAQ,oBAAoB,CAAC,CAMpH,CAAC"}

package/dist/platform/platformCapabilities.js

@@ -0,0 +1,98 @@
+import { __awaiter } from "tslib";
+import { exceptions, simd } from "wasm-feature-detect";
+import { memoize } from "../common/memoize";
+import { platformNotSupportedError } from "../namedErrors";
+import { getPlatformInfo } from "./platformInfo";
+const minRequiredMaxTextureSize = 1024;
+function getWebGlSupport() {
+    var _a, _b;
+    const ctx = (_a = globalThis.document) === null || _a === void 0 ? void 0 : _a.createElement("canvas").getContext("webgl2");
+    if (!ctx) {
+        const cause = ((_b = globalThis.document) === null || _b === void 0 ? void 0 : _b.createElement("canvas").getContext("webgl"))
+            ? "platform_not_supported_only_webgl1"
+            : typeof globalThis.WebGLRenderingContext === "function"
+                ? "platform_not_supported_likely_no_hw_accel"
+                : "platform_not_supported_no_webgl_browser_support";
+        return {
+            supported: false,
+            error: platformNotSupportedError("CameraKit requires WebGL2, but this browser does not support WebGL2.", new Error(cause)),
+        };
+    }
+    const maxTextureSize = ctx.getParameter(ctx.MAX_TEXTURE_SIZE);
+    const supported = maxTextureSize >= minRequiredMaxTextureSize;
+    return supported
+        ? { supported, maxTextureSize }
+        : {
+            supported,
+            error: platformNotSupportedError(`CameraKit requires WebGL's MAX_TEXTURE_SIZE exceed a minimum value of ` +
+                `${minRequiredMaxTextureSize}, but the browser's reported MAX_TEXTURE_SIZE is ${maxTextureSize}.`),
+        };
+}
+export var WasmFeatures;
+(function (WasmFeatures) {
+    WasmFeatures[WasmFeatures["Default"] = 0] = "Default";
+    WasmFeatures[WasmFeatures["SIMD"] = 1] = "SIMD";
+    WasmFeatures[WasmFeatures["ExceptionHandling"] = 2] = "ExceptionHandling";
+})(WasmFeatures || (WasmFeatures = {}));
+function getWebAssemblyCapabilities() {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (globalThis.WebAssembly === undefined)
+            return {
+                supported: false,
+                error: platformNotSupportedError("CameraKit requires WebAssembly, but this browser does not support WebAssembly."),
+            };
+        return {
+            supported: true,
+            wasmFeatures: (yield Promise.all([
+                simd().then((supported) => {
+                    if (getPlatformInfo().browser.brand === "Safari")
+                        return WasmFeatures.Default;
+                    return supported ? WasmFeatures.SIMD : WasmFeatures.Default;
+                }),
+                exceptions().then((supported) => (supported ? WasmFeatures.ExceptionHandling : WasmFeatures.Default)),
+            ])).reduce((features, feature) => features | feature, WasmFeatures.Default),
+        };
+    });
+}
+function getGenericWebXrNotSupported(cause) {
+    return {
+        supported: false,
+        error: platformNotSupportedError(`Use of this feature requires WebXR support for immersive AR sessions, but ` +
+            `this browser does not support immersive AR sessions.`, cause),
+    };
+}
+export function getWebXrCapabilities() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            if (!isSecureContext || !navigator.xr)
+                return getGenericWebXrNotSupported();
+            const isImmersiveArSupported = yield navigator.xr.isSessionSupported("immersive-ar");
+            return isImmersiveArSupported
+                ? {
+                    supported: true,
+                    sixDofSupported: true,
+                    sceneDepthSupported: true,
+                }
+                : getGenericWebXrNotSupported();
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === "SecurityError") {
+                return {
+                    supported: false,
+                    error: platformNotSupportedError("Failed to check XR capabilities due to permissions or other issues.", error),
+                };
+            }
+            return getGenericWebXrNotSupported(error);
+        }
+    });
+}
+export const getPlatformCapabilities = memoize(function getPlatformCapabilities() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return {
+            webgl: getWebGlSupport(),
+            wasm: yield getWebAssemblyCapabilities(),
+            webxr: yield getWebXrCapabilities(),
+        };
+    });
+});
+//# sourceMappingURL=platformCapabilities.js.map

package/dist/platform/platformCapabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformCapabilities.js","sourceRoot":"","sources":["../../src/platform/platformCapabilities.ts"],"names":[],"mappings":"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","sourcesContent":["import { exceptions, simd } from \"wasm-feature-detect\";\nimport { memoize } from \"../common/memoize\";\nimport type { XrCapabilities } from \"../lens-core-module/generated-types\";\nimport { platformNotSupportedError } from \"../namedErrors\";\nimport { getPlatformInfo } from \"./platformInfo\";\n\n/** @internal */\nexport type SupportedCapability<T> = T & { supported: true };\n/** @internal */\nexport type UnsupportedCapability = { supported: false; error: Error };\n/** @internal */\nexport type Capability<T = void> = SupportedCapability<T> | UnsupportedCapability;\n\n//-----------\n// WebGL\n//-----------\n\ntype WebGlCapability = Capability<{ maxTextureSize: number }>;\n\n// This required minimum max texture size is based on data from\n// https://web3dsurvey.com/webgl/parameters/MAX_TEXTURE_SIZE. Checking for a reasonable minimum MAX_TEXTURE_SIZE avoids\n// attempting to run lenses on platforms that will not support them -- most commonly, we've seen some platforms that\n// report 0 MAX_TEXTURE_SIZE, which will cause errors for all lenses.\nconst minRequiredMaxTextureSize = 1024;\n\n/**\n * @returns An object with fields describing support for various WebGL features.\n *\n * @internal\n */\nfunction getWebGlSupport(): WebGlCapability {\n    const ctx = globalThis.document?.createElement(\"canvas\").getContext(\"webgl2\");\n    if (!ctx) {\n        const cause = globalThis.document?.createElement(\"canvas\").getContext(\"webgl\")\n            ? \"platform_not_supported_only_webgl1\"\n            : typeof globalThis.WebGLRenderingContext === \"function\"\n            ? \"platform_not_supported_likely_no_hw_accel\"\n            : \"platform_not_supported_no_webgl_browser_support\";\n        return {\n            supported: false,\n            error: platformNotSupportedError(\n                \"CameraKit requires WebGL2, but this browser does not support WebGL2.\",\n                new Error(cause)\n            ),\n        };\n    }\n    const maxTextureSize = ctx.getParameter(ctx.MAX_TEXTURE_SIZE);\n    const supported = maxTextureSize >= minRequiredMaxTextureSize;\n    return supported\n        ? { supported, maxTextureSize }\n        : {\n              supported,\n              error: platformNotSupportedError(\n                  `CameraKit requires WebGL's MAX_TEXTURE_SIZE exceed a minimum value of ` +\n                      `${minRequiredMaxTextureSize}, but the browser's reported MAX_TEXTURE_SIZE is ${maxTextureSize}.`\n              ),\n          };\n}\n\n//-----------\n// WASM\n//-----------\n\ntype WasmCapability = Capability<{ wasmFeatures: number }>;\n\n/**\n * Because there may be a large number of WASM-related capabilities, and because these may correspond to various builds\n * of LensCore, we encode the various WASM capabilities into a single number by bitwise OR-ing together the numbers\n * corresponding to each capability.\n *\n * Since each combindation of capabilities is represented by a single number, we can easily map between that number and\n * the corresponding LensCore build name that makes use of those capabilities.\n *\n * @internal\n */\nexport enum WasmFeatures {\n    Default = 0b00000000,\n    SIMD = 0b00000001,\n    ExceptionHandling = 0b00000010,\n}\n\n/**\n * @returns A non-negative integer representing the combination of supported WebAssembly features, or -1 if WebAssembly\n * is not supported at all.\n *\n * @internal\n */\nasync function getWebAssemblyCapabilities(): Promise<WasmCapability> {\n    if (globalThis.WebAssembly === undefined)\n        return {\n            supported: false,\n            error: platformNotSupportedError(\n                \"CameraKit requires WebAssembly, but this browser does not support WebAssembly.\"\n            ),\n        };\n    return {\n        supported: true,\n        wasmFeatures: (\n            await Promise.all([\n                simd().then((supported) => {\n                    // Although Safari 16.4 reports SIMD support, LensCore encounters rendering bugs when using\n                    // SIMD in Safari 16.4. We will disable SIMD for now until Safari stabilizes the feature.\n                    if (getPlatformInfo().browser.brand === \"Safari\") return WasmFeatures.Default;\n                    return supported ? WasmFeatures.SIMD : WasmFeatures.Default;\n                }),\n                exceptions().then((supported) => (supported ? WasmFeatures.ExceptionHandling : WasmFeatures.Default)),\n            ])\n        ).reduce((features, feature) => features | feature, WasmFeatures.Default),\n    };\n}\n\n//-----------\n// WebXR\n//-----------\n\ntype WebXrCapability = Capability<XrCapabilities>;\n\nfunction getGenericWebXrNotSupported(cause?: unknown): WebXrCapability {\n    return {\n        supported: false,\n        error: platformNotSupportedError(\n            `Use of this feature requires WebXR support for immersive AR sessions, but ` +\n                `this browser does not support immersive AR sessions.`,\n            cause\n        ),\n    };\n}\n\n/**\n * @returns A Promise containing an object with fields describing the support of various WebXR features. This object's\n * type is defined by LensCore, as they consume these capabilities and adjust behavior accordingly.\n *\n * @internal\n */\nexport async function getWebXrCapabilities(): Promise<WebXrCapability> {\n    try {\n        if (!isSecureContext || !navigator.xr) return getGenericWebXrNotSupported();\n        const isImmersiveArSupported = await navigator.xr.isSessionSupported(\"immersive-ar\");\n        return isImmersiveArSupported\n            ? {\n                  supported: true,\n                  sixDofSupported: true,\n                  sceneDepthSupported: true,\n              }\n            : getGenericWebXrNotSupported();\n    } catch (error) {\n        if (error instanceof Error && error.name === \"SecurityError\") {\n            return {\n                supported: false,\n                error: platformNotSupportedError(\n                    \"Failed to check XR capabilities due to permissions or other issues.\",\n                    error\n                ),\n            };\n        }\n        return getGenericWebXrNotSupported(error);\n    }\n}\n\n/** @internal */\nexport interface PlatformCapabilities {\n    webgl: WebGlCapability;\n    wasm: WasmCapability;\n    webxr: WebXrCapability;\n}\n\n/**\n * Get information about the current platform capabilities, including:\n * - WebGL support and various WebGL parameters.\n * - WASM support and support for various WASM features.\n * - WebXR support and support for various WebXR features.\n *\n * @internal\n */\nexport const getPlatformCapabilities = memoize(async function getPlatformCapabilities(): Promise<PlatformCapabilities> {\n    return {\n        webgl: getWebGlSupport(),\n        wasm: await getWebAssemblyCapabilities(),\n        webxr: await getWebXrCapabilities(),\n    };\n});\n"]}

package/dist/platform/platformInfo.d.ts

@@ -0,0 +1,44 @@
+type BrandArray = Array<{
+    brand: string;
+    version: string;
+}>;
+interface NavigatorUAData {
+    brands: BrandArray;
+    mobile: boolean;
+    platform: string;
+}
+/** @internal */
+export type ConnectionType = "bluetooth" | "cellular" | "ethernet" | "none" | "wifi" | "wimax" | "other" | "unknown";
+declare global {
+    interface Navigator {
+        userAgentData?: NavigatorUAData;
+        connection?: {
+            type?: ConnectionType;
+        };
+    }
+}
+/** @internal */
+export interface PlatformInfo {
+    sdkShortVersion: string;
+    sdkLongVersion: string;
+    lensCore: {
+        version: string;
+        buildNumber: string;
+        baseUrl: string;
+    };
+    browser: {
+        brand: string;
+        version: string;
+    };
+    osName: string;
+    osVersion: string;
+    deviceModel: string;
+    locale: string;
+    fullLocale: string;
+    origin: string;
+    connectionType: ConnectionType;
+}
+/** @internal */
+export declare const getPlatformInfo: import("../common/memoize").Memoized<() => PlatformInfo>;
+export {};
+//# sourceMappingURL=platformInfo.d.ts.map

package/dist/platform/platformInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformInfo.d.ts","sourceRoot":"","sources":["../../src/platform/platformInfo.ts"],"names":[],"mappings":"AAKA,KAAK,UAAU,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE5D,UAAU,eAAe;IACrB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,gBAAgB;AAChB,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAErH,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,SAAS;QACf,aAAa,CAAC,EAAE,eAAe,CAAC;QAChC,UAAU,CAAC,EAAE;YAGT,IAAI,CAAC,EAAE,cAAc,CAAC;SACzB,CAAC;KACL;CACJ;AAsOD,gBAAgB;AAChB,MAAM,WAAW,YAAY;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,cAAc,CAAC;CAClC;AAED,gBAAgB;AAChB,eAAO,MAAM,eAAe,6CAAsC,YAAY,CA0C5E,CAAC"}