@snap/react-camera-kit 0.0.1

package/dist/esm/internal/metrics.js

@@ -0,0 +1,91 @@
+import { Count, ConcatInjectable, Injectable } from "@snap/camera-kit";
+import * as CameraKitModule from "@snap/camera-kit";
+import { Subject } from "rxjs";
+import { VERSION } from "../version";
+/**
+ * Namespace alias for runtime feature detection.
+ * This allows graceful degradation across Camera Kit versions:
+ *  - Newer: `externalMetricsFactory`
+ *  - Older: `externalMetricsSubjectFactory`
+ *  - Unknown future: neither → metrics injection is silently skipped.
+ *
+ * TODO: once Camera Kit peer dependency is >= 1.15.0,
+ * we can remove the legacy code path and import externalMetricsFactory directly.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+const ck = CameraKitModule;
+const METRICS_PREFIX = "react_camera_kit";
+/** Single module-level Subject shared across all bootstrap cycles. */
+const metricsSubject = new Subject();
+/**
+ * Tracks the forwarding subscription used by the legacy API path.
+ * Only relevant when Camera Kit does not export `externalMetricsFactory`.
+ */
+let forwardingSubscription;
+/**
+ * Creates a metrics reporter that pushes Count metrics into a Subject.
+ * The subject is wired into Camera Kit's DI container so metrics flow
+ * through the SDK's built-in pipeline to the backend.
+ */
+function createMetricsReporter(subject) {
+    return {
+        reportCount(name) {
+            subject.next(Count.count(`${METRICS_PREFIX}_${name}`, 1, {
+                rck_version: sanitizeMetricFragment(VERSION),
+            }));
+        },
+    };
+}
+/** Global metrics reporter — safe to call at any point; events are buffered until the DI wiring is established. */
+export const metricsReporter = createMetricsReporter(metricsSubject);
+/**
+ * Wraps a user-supplied `extendContainer` (if any) so that our metrics Subject
+ * is always provided into Camera Kit's DI container.
+ *
+ * Newer Camera Kit versions (with `externalMetricsFactory`)
+ * use a simpler declarative approach. Older versions fall back to
+ * `externalMetricsSubjectFactory` with manual subscribe-and-forward.
+ *
+ * On re-bootstrap the previous forwarding subscription is torn down automatically
+ * (legacy path only; the new path doesn't need that).
+ */
+export function extendContainerWithMetrics(userExtendContainer) {
+    return (container) => {
+        const result = userExtendContainer ? userExtendContainer(container) : container;
+        // Resolve lazily — the export may or may not exist depending on the CK version.
+        const metricsFactory = ck["externalMetricsFactory"];
+        const subjectFactory = ck["externalMetricsSubjectFactory"];
+        // Newer Camera Kit: externalMetricsFactory
+        if (metricsFactory) {
+            return result.provides(getNewInjectable(metricsFactory, metricsSubject));
+        }
+        // Fallback: older Camera Kit externalMetricsSubjectFactory
+        if (subjectFactory) {
+            return result.provides(getLegacyInjectable(subjectFactory, metricsSubject));
+        }
+        // Neither API surface available — skip metrics injection.
+        return result;
+    };
+}
+function getNewInjectable(factory, metricsSubject) {
+    return ConcatInjectable(factory.token, () => metricsSubject.asObservable());
+}
+function getLegacyInjectable(factory, metricsSubject) {
+    return Injectable(factory.token, [factory.token], (existingSubject) => {
+        // Tear down previous forwarding subscription before creating a new one.
+        forwardingSubscription?.unsubscribe();
+        // Only forward `next` events – we must never propagate `error` or `complete`
+        // to the shared Subject, as that would terminate the metrics pipeline for
+        // all consumers.
+        forwardingSubscription = metricsSubject.subscribe({
+            next: (metric) => existingSubject.next(metric),
+            error: () => { },
+            complete: () => { },
+        });
+        return existingSubject;
+    });
+}
+function sanitizeMetricFragment(fragment) {
+    return fragment.toLowerCase().replaceAll(".", "_");
+}
+//# sourceMappingURL=metrics.js.map

package/dist/esm/internal/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/internal/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAA2B,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,KAAK,eAAe,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAc,OAAO,EAAgB,MAAM,MAAM,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAcrC;;;;;;;;;GASG;AACH,8DAA8D;AAC9D,MAAM,EAAE,GAAG,eAAsC,CAAC;AAElD,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAE1C,sEAAsE;AACtE,MAAM,cAAc,GAAG,IAAI,OAAO,EAAU,CAAC;AAE7C;;;GAGG;AACH,IAAI,sBAAgD,CAAC;AAIrD;;;;GAIG;AACH,SAAS,qBAAqB,CAAC,OAAwB;IACrD,OAAO;QACL,WAAW,CAAC,IAAY;YACtB,OAAO,CAAC,IAAI,CACV,KAAK,CAAC,KAAK,CAAC,GAAG,cAAc,IAAI,IAAI,EAAE,EAAE,CAAC,EAAE;gBAC1C,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC;aAC7C,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mHAAmH;AACnH,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC,cAAc,CAAC,CAAC;AAErE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACxC,mBAAqE;IAErE,OAAO,CAAC,SAA0B,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAEhF,gFAAgF;QAChF,MAAM,cAAc,GAAG,EAAE,CAAC,wBAAwB,CAAuC,CAAC;QAC1F,MAAM,cAAc,GAAG,EAAE,CAAC,+BAA+B,CAA8C,CAAC;QAExG,2CAA2C;QAC3C,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;QAC3E,CAAC;QAED,2DAA2D;QAC3D,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC,CAAC;QAC9E,CAAC;QAED,0DAA0D;QAC1D,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,OAA+B,EAAE,cAA+B;IACxF,OAAO,gBAAgB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAsC,EAAE,cAA+B;IAClG,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,KAAK,CAAU,EAAE,CAAC,eAAgC,EAAE,EAAE;QAC9F,wEAAwE;QACxE,sBAAsB,EAAE,WAAW,EAAE,CAAC;QAEtC,6EAA6E;QAC7E,0EAA0E;QAC1E,iBAAiB;QACjB,sBAAsB,GAAG,cAAc,CAAC,SAAS,CAAC;YAChD,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC;YAC9C,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;YACf,QAAQ,EAAE,GAAG,EAAE,GAAE,CAAC;SACnB,CAAC,CAAC;QACH,OAAO,eAAe,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,QAAgB;IAC9C,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC","sourcesContent":["import { Count, Metric, PublicContainer, ConcatInjectable, Injectable } from \"@snap/camera-kit\";\nimport * as CameraKitModule from \"@snap/camera-kit\";\nimport { Observable, Subject, Subscription } from \"rxjs\";\nimport { VERSION } from \"../version\";\n\ntype ExternalMetricsFactory = {\n  (): Observable<Metric>[];\n  token: \"externalMetrics\";\n  dependencies: [];\n};\n\ntype ExternalMetricsSubjectFactory = {\n  (): Subject<Metric>;\n  token: \"externalMetricsSubject\";\n  dependencies: [];\n};\n\n/**\n * Namespace alias for runtime feature detection.\n * This allows graceful degradation across Camera Kit versions:\n *  - Newer: `externalMetricsFactory`\n *  - Older: `externalMetricsSubjectFactory`\n *  - Unknown future: neither → metrics injection is silently skipped.\n *\n * TODO: once Camera Kit peer dependency is >= 1.15.0,\n * we can remove the legacy code path and import externalMetricsFactory directly.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nconst ck = CameraKitModule as Record<string, any>;\n\nconst METRICS_PREFIX = \"react_camera_kit\";\n\n/** Single module-level Subject shared across all bootstrap cycles. */\nconst metricsSubject = new Subject<Metric>();\n\n/**\n * Tracks the forwarding subscription used by the legacy API path.\n * Only relevant when Camera Kit does not export `externalMetricsFactory`.\n */\nlet forwardingSubscription: Subscription | undefined;\n\nexport type MetricsReporter = ReturnType<typeof createMetricsReporter>;\n\n/**\n * Creates a metrics reporter that pushes Count metrics into a Subject.\n * The subject is wired into Camera Kit's DI container so metrics flow\n * through the SDK's built-in pipeline to the backend.\n */\nfunction createMetricsReporter(subject: Subject<Metric>) {\n  return {\n    reportCount(name: string) {\n      subject.next(\n        Count.count(`${METRICS_PREFIX}_${name}`, 1, {\n          rck_version: sanitizeMetricFragment(VERSION),\n        }),\n      );\n    },\n  };\n}\n\n/** Global metrics reporter — safe to call at any point; events are buffered until the DI wiring is established. */\nexport const metricsReporter = createMetricsReporter(metricsSubject);\n\n/**\n * Wraps a user-supplied `extendContainer` (if any) so that our metrics Subject\n * is always provided into Camera Kit's DI container.\n *\n * Newer Camera Kit versions (with `externalMetricsFactory`)\n * use a simpler declarative approach. Older versions fall back to\n * `externalMetricsSubjectFactory` with manual subscribe-and-forward.\n *\n * On re-bootstrap the previous forwarding subscription is torn down automatically\n * (legacy path only; the new path doesn't need that).\n */\nexport function extendContainerWithMetrics(\n  userExtendContainer?: (container: PublicContainer) => PublicContainer,\n): (container: PublicContainer) => PublicContainer {\n  return (container: PublicContainer) => {\n    const result = userExtendContainer ? userExtendContainer(container) : container;\n\n    // Resolve lazily — the export may or may not exist depending on the CK version.\n    const metricsFactory = ck[\"externalMetricsFactory\"] as ExternalMetricsFactory | undefined;\n    const subjectFactory = ck[\"externalMetricsSubjectFactory\"] as ExternalMetricsSubjectFactory | undefined;\n\n    // Newer Camera Kit: externalMetricsFactory\n    if (metricsFactory) {\n      return result.provides(getNewInjectable(metricsFactory, metricsSubject));\n    }\n\n    // Fallback: older Camera Kit externalMetricsSubjectFactory\n    if (subjectFactory) {\n      return result.provides(getLegacyInjectable(subjectFactory, metricsSubject));\n    }\n\n    // Neither API surface available — skip metrics injection.\n    return result;\n  };\n}\n\nfunction getNewInjectable(factory: ExternalMetricsFactory, metricsSubject: Subject<Metric>) {\n  return ConcatInjectable(factory.token, () => metricsSubject.asObservable());\n}\n\nfunction getLegacyInjectable(factory: ExternalMetricsSubjectFactory, metricsSubject: Subject<Metric>) {\n  return Injectable(factory.token, [factory.token] as const, (existingSubject: Subject<Metric>) => {\n    // Tear down previous forwarding subscription before creating a new one.\n    forwardingSubscription?.unsubscribe();\n\n    // Only forward `next` events – we must never propagate `error` or `complete`\n    // to the shared Subject, as that would terminate the metrics pipeline for\n    // all consumers.\n    forwardingSubscription = metricsSubject.subscribe({\n      next: (metric) => existingSubject.next(metric),\n      error: () => {},\n      complete: () => {},\n    });\n    return existingSubject;\n  });\n}\n\nfunction sanitizeMetricFragment(fragment: string) {\n  return fragment.toLowerCase().replaceAll(\".\", \"_\");\n}\n"]}

package/dist/esm/internal/sessionUtils.d.ts

@@ -0,0 +1,3 @@
+import { CameraKitSession } from "@snap/camera-kit";
+export declare function withSessionPaused<T>(session: CameraKitSession, cb: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=sessionUtils.d.ts.map

package/dist/esm/internal/sessionUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionUtils.d.ts","sourceRoot":"","sources":["../../../src/internal/sessionUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,cAazF"}

package/dist/esm/internal/sessionUtils.js

@@ -0,0 +1,14 @@
+export async function withSessionPaused(session, cb) {
+    const { capture, live } = session.playing;
+    // Pause everything in parallel
+    await Promise.all([capture && session.pause("capture"), live && session.pause("live")]);
+    try {
+        // Run the user callback while paused
+        return await cb();
+    }
+    finally {
+        // Always resume, even if cb() throws
+        await Promise.all([capture && session.play("capture"), live && session.play("live")]);
+    }
+}
+//# sourceMappingURL=sessionUtils.js.map

package/dist/esm/internal/sessionUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionUtils.js","sourceRoot":"","sources":["../../../src/internal/sessionUtils.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAI,OAAyB,EAAE,EAAoB;IACxF,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAE1C,+BAA+B;IAC/B,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAExF,IAAI,CAAC;QACH,qCAAqC;QACrC,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,qCAAqC;QACrC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC","sourcesContent":["import { CameraKitSession } from \"@snap/camera-kit\";\n\nexport async function withSessionPaused<T>(session: CameraKitSession, cb: () => Promise<T>) {\n  const { capture, live } = session.playing;\n\n  // Pause everything in parallel\n  await Promise.all([capture && session.pause(\"capture\"), live && session.pause(\"live\")]);\n\n  try {\n    // Run the user callback while paused\n    return await cb();\n  } finally {\n    // Always resume, even if cb() throws\n    await Promise.all([capture && session.play(\"capture\"), live && session.play(\"live\")]);\n  }\n}\n"]}

package/dist/esm/internal/sourceUtils.d.ts

@@ -0,0 +1,22 @@
+import { SourceInput, SourceOutput } from "../types";
+import { CameraKitSource, Transform2D } from "@snap/camera-kit";
+export declare const DEFAULT_CAMERA_DEVICE_ID = "";
+type _TupleOf<T, N extends number, R extends unknown[]> = R["length"] extends N ? R : _TupleOf<T, N, [T, ...R]>;
+export type TupleOf<T, N extends number> = N extends N ? (number extends N ? T[] : _TupleOf<T, N, []>) : never;
+export declare const defaultStreamResolution: {
+    width: number;
+    height: number;
+};
+export interface SourceApplication {
+    cameraKitSource: CameraKitSource;
+    transform: Transform2D;
+    /**
+     * Dimensions of the input source in pixels, as [width, height], or undefined if unavailable.
+     */
+    inputSize?: [number, number];
+    mediaStream?: MediaStream;
+    initializedSourceInput: SourceOutput;
+}
+export declare function createCameraKitSource(source: SourceInput): Promise<SourceApplication>;
+export {};
+//# sourceMappingURL=sourceUtils.d.ts.map

package/dist/esm/internal/sourceUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceUtils.d.ts","sourceRoot":"","sources":["../../../src/internal/sourceUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACtG,OAAO,EACL,eAAe,EAIf,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,KAAK,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAChH,MAAM,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAE/G,eAAO,MAAM,uBAAuB;;;CAGnC,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,SAAS,EAAE,WAAW,CAAC;IACvB;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,sBAAsB,EAAE,YAAY,CAAC;CACtC;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqB3F"}

package/dist/esm/internal/sourceUtils.js

@@ -0,0 +1,139 @@
+import { createImageSource, createMediaStreamSource, createVideoSource, Transform2D, } from "@snap/camera-kit";
+import { isMobile } from "./isMobile";
+export const DEFAULT_CAMERA_DEVICE_ID = "";
+export const defaultStreamResolution = {
+    width: 1280,
+    height: 720,
+};
+export async function createCameraKitSource(source) {
+    if (source.kind === "camera") {
+        return createCameraStreamSource({
+            // undefined deviceId brings default camera
+            deviceId: source.deviceId !== DEFAULT_CAMERA_DEVICE_ID ? source.deviceId : undefined,
+            cameraFacing: source.options?.cameraFacing ?? "user",
+            cameraConstraints: source.options?.cameraConstraints ?? defaultStreamResolution,
+            cameraRotation: source.options?.cameraRotation ?? 0,
+            fpsLimit: source.options?.fpsLimit,
+        });
+    }
+    else if (source.kind === "video") {
+        return createCameraKitVideoSource({
+            videoUrl: source.url,
+            autoplay: source.autoplay,
+        });
+    }
+    else if (source.kind === "image") {
+        return createCameraKitImageSource({
+            imageUrl: source.url,
+        });
+    }
+    throw new Error(`Unsupported source kind`);
+}
+async function createCameraStreamSource({ deviceId, cameraConstraints, cameraFacing, fpsLimit, cameraRotation, }) {
+    const mediaStream = await navigator.mediaDevices.getUserMedia({
+        video: {
+            ...cameraConstraints,
+            deviceId: isMobile() ? undefined : deviceId,
+            facingMode: cameraFacing,
+        },
+        audio: false,
+    });
+    const track = mediaStream.getVideoTracks()[0];
+    const { width, height, deviceId: actualDeviceId } = track?.getSettings() ?? {};
+    const cameraKitSource = createMediaStreamSource(mediaStream, {
+        cameraType: cameraFacing,
+        fpsLimit,
+    });
+    // On some mobile browsers, track settings can initially report landscape
+    // dimensions even when the device is held in portrait, so we normalize by
+    // treating mobile capture as rotated when deriving input size.
+    const rotate = isMobile() || Math.abs(cameraRotation) === 90;
+    const mirror = cameraFacing === "user";
+    const transform = new Transform2D(getTransform(cameraRotation, mirror));
+    return {
+        cameraKitSource,
+        transform,
+        inputSize: typeof width === "number" && typeof height === "number"
+            ? [rotate ? height : width, rotate ? width : height]
+            : undefined,
+        mediaStream,
+        initializedSourceInput: {
+            kind: "camera",
+            deviceId: actualDeviceId ?? "",
+            label: track?.label ?? "",
+        },
+    };
+}
+function createCameraKitVideoSource({ videoUrl, autoplay }) {
+    return new Promise((res, rej) => {
+        autoplay = autoplay ?? true;
+        const videoInput = document.createElement("video");
+        videoInput.src = videoUrl;
+        videoInput.autoplay = autoplay;
+        videoInput.muted = true;
+        videoInput.loop = true;
+        videoInput.crossOrigin = "anonymous";
+        videoInput.playsInline = true;
+        videoInput.addEventListener("canplay", async () => {
+            if (autoplay)
+                await videoInput.play();
+            res({
+                cameraKitSource: createVideoSource(videoInput),
+                transform: Transform2D.Identity,
+                inputSize: [videoInput.videoWidth, videoInput.videoHeight],
+                initializedSourceInput: {
+                    kind: "video",
+                    url: videoUrl,
+                    videoElement: videoInput,
+                },
+            });
+        }, { once: true });
+        videoInput.addEventListener("error", async (event) => {
+            rej(new Error(event.message ?? "Unable to load video.", {
+                cause: event.error,
+            }));
+        }, { once: true });
+    });
+}
+function createCameraKitImageSource({ imageUrl }) {
+    return new Promise((res, rej) => {
+        const imageInput = document.createElement("img");
+        imageInput.src = imageUrl;
+        imageInput.crossOrigin = "anonymous";
+        imageInput.addEventListener("load", async () => {
+            res({
+                cameraKitSource: createImageSource(imageInput),
+                transform: Transform2D.Identity,
+                inputSize: [imageInput.naturalWidth, imageInput.naturalHeight],
+                initializedSourceInput: {
+                    kind: "image",
+                    url: imageUrl,
+                    imageElement: imageInput,
+                },
+            });
+        }, { once: true });
+        imageInput.addEventListener("error", async (event) => {
+            rej(new Error(event.message ?? "Unable to load image.", {
+                cause: event.error,
+            }));
+        }, { once: true });
+    });
+}
+function getTransform(degrees, mirror) {
+    const mirrorFactor = mirror ? -1 : 1;
+    const rad = (degrees * Math.PI) / 180;
+    const cos = Number(Math.cos(rad).toFixed(2));
+    const sin = Number(Math.sin(rad).toFixed(2));
+    let normalizedDegrees = degrees % 360;
+    if (normalizedDegrees < 0)
+        normalizedDegrees += 360;
+    const quadrant = Math.floor(normalizedDegrees / 90) % 4;
+    let translateX = quadrant === 1 || quadrant === 2 ? 1 : 0;
+    let translateY = quadrant === 2 || quadrant === 3 ? 1 : 0;
+    if (mirror) {
+        translateX = quadrant === 0 || quadrant === 2 ? 1 - translateX : translateX;
+        translateY = quadrant === 1 || quadrant === 3 ? 1 - translateY : translateY;
+    }
+    return [cos * mirrorFactor, sin * mirrorFactor, 0, sin === 0 ? 0 : -sin, cos, 0, translateX, translateY, 1];
+}
+//# sourceMappingURL=sourceUtils.js.map

package/dist/esm/internal/sourceUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceUtils.js","sourceRoot":"","sources":["../../../src/internal/sourceUtils.ts"],"names":[],"mappings":"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","sourcesContent":["import { CameraConstraints, CameraFacing, CameraRotation, SourceInput, SourceOutput } from \"../types\";\nimport {\n  CameraKitSource,\n  createImageSource,\n  createMediaStreamSource,\n  createVideoSource,\n  Transform2D,\n} from \"@snap/camera-kit\";\nimport { isMobile } from \"./isMobile\";\n\nexport const DEFAULT_CAMERA_DEVICE_ID = \"\";\n\ntype _TupleOf<T, N extends number, R extends unknown[]> = R[\"length\"] extends N ? R : _TupleOf<T, N, [T, ...R]>;\nexport type TupleOf<T, N extends number> = N extends N ? (number extends N ? T[] : _TupleOf<T, N, []>) : never;\n\nexport const defaultStreamResolution = {\n  width: 1280,\n  height: 720,\n};\n\nexport interface SourceApplication {\n  cameraKitSource: CameraKitSource;\n  transform: Transform2D;\n  /**\n   * Dimensions of the input source in pixels, as [width, height], or undefined if unavailable.\n   */\n  inputSize?: [number, number];\n  mediaStream?: MediaStream;\n  initializedSourceInput: SourceOutput;\n}\n\nexport async function createCameraKitSource(source: SourceInput): Promise<SourceApplication> {\n  if (source.kind === \"camera\") {\n    return createCameraStreamSource({\n      // undefined deviceId brings default camera\n      deviceId: source.deviceId !== DEFAULT_CAMERA_DEVICE_ID ? source.deviceId : undefined,\n      cameraFacing: source.options?.cameraFacing ?? \"user\",\n      cameraConstraints: source.options?.cameraConstraints ?? defaultStreamResolution,\n      cameraRotation: source.options?.cameraRotation ?? 0,\n      fpsLimit: source.options?.fpsLimit,\n    });\n  } else if (source.kind === \"video\") {\n    return createCameraKitVideoSource({\n      videoUrl: source.url,\n      autoplay: source.autoplay,\n    });\n  } else if (source.kind === \"image\") {\n    return createCameraKitImageSource({\n      imageUrl: source.url,\n    });\n  }\n  throw new Error(`Unsupported source kind`);\n}\n\nasync function createCameraStreamSource({\n  deviceId,\n  cameraConstraints,\n  cameraFacing,\n  fpsLimit,\n  cameraRotation,\n}: {\n  deviceId: string | undefined;\n  cameraConstraints: CameraConstraints;\n  cameraFacing: CameraFacing;\n  fpsLimit: number | undefined;\n  cameraRotation: CameraRotation;\n}): Promise<SourceApplication> {\n  const mediaStream = await navigator.mediaDevices.getUserMedia({\n    video: {\n      ...cameraConstraints,\n      deviceId: isMobile() ? undefined : deviceId,\n      facingMode: cameraFacing,\n    },\n    audio: false,\n  });\n\n  const track = mediaStream.getVideoTracks()[0];\n  const { width, height, deviceId: actualDeviceId } = track?.getSettings() ?? {};\n\n  const cameraKitSource = createMediaStreamSource(mediaStream, {\n    cameraType: cameraFacing,\n    fpsLimit,\n  });\n\n  // On some mobile browsers, track settings can initially report landscape\n  // dimensions even when the device is held in portrait, so we normalize by\n  // treating mobile capture as rotated when deriving input size.\n  const rotate = isMobile() || Math.abs(cameraRotation) === 90;\n  const mirror = cameraFacing === \"user\";\n  const transform = new Transform2D(getTransform(cameraRotation, mirror));\n\n  return {\n    cameraKitSource,\n    transform,\n    inputSize:\n      typeof width === \"number\" && typeof height === \"number\"\n        ? [rotate ? height : width, rotate ? width : height]\n        : undefined,\n    mediaStream,\n    initializedSourceInput: {\n      kind: \"camera\",\n      deviceId: actualDeviceId ?? \"\",\n      label: track?.label ?? \"\",\n    },\n  };\n}\n\nfunction createCameraKitVideoSource({ videoUrl, autoplay }: { videoUrl: string; autoplay?: boolean }) {\n  return new Promise<SourceApplication>((res, rej) => {\n    autoplay = autoplay ?? true;\n    const videoInput = document.createElement(\"video\");\n    videoInput.src = videoUrl;\n    videoInput.autoplay = autoplay;\n    videoInput.muted = true;\n    videoInput.loop = true;\n    videoInput.crossOrigin = \"anonymous\";\n    videoInput.playsInline = true;\n    videoInput.addEventListener(\n      \"canplay\",\n      async () => {\n        if (autoplay) await videoInput.play();\n        res({\n          cameraKitSource: createVideoSource(videoInput),\n          transform: Transform2D.Identity,\n          inputSize: [videoInput.videoWidth, videoInput.videoHeight],\n          initializedSourceInput: {\n            kind: \"video\",\n            url: videoUrl,\n            videoElement: videoInput,\n          },\n        });\n      },\n      { once: true },\n    );\n    videoInput.addEventListener(\n      \"error\",\n      async (event) => {\n        rej(\n          new Error(event.message ?? \"Unable to load video.\", {\n            cause: event.error,\n          }),\n        );\n      },\n      { once: true },\n    );\n  });\n}\n\nfunction createCameraKitImageSource({ imageUrl }: { imageUrl: string }) {\n  return new Promise<SourceApplication>((res, rej) => {\n    const imageInput = document.createElement(\"img\");\n    imageInput.src = imageUrl;\n    imageInput.crossOrigin = \"anonymous\";\n    imageInput.addEventListener(\n      \"load\",\n      async () => {\n        res({\n          cameraKitSource: createImageSource(imageInput),\n          transform: Transform2D.Identity,\n          inputSize: [imageInput.naturalWidth, imageInput.naturalHeight],\n          initializedSourceInput: {\n            kind: \"image\",\n            url: imageUrl,\n            imageElement: imageInput,\n          },\n        });\n      },\n      { once: true },\n    );\n    imageInput.addEventListener(\n      \"error\",\n      async (event) => {\n        rej(\n          new Error(event.message ?? \"Unable to load image.\", {\n            cause: event.error,\n          }),\n        );\n      },\n      { once: true },\n    );\n  });\n}\n\nfunction getTransform(degrees: number, mirror: boolean): TupleOf<number, 9> {\n  const mirrorFactor = mirror ? -1 : 1;\n  const rad = (degrees * Math.PI) / 180;\n  const cos = Number(Math.cos(rad).toFixed(2));\n  const sin = Number(Math.sin(rad).toFixed(2));\n\n  let normalizedDegrees = degrees % 360;\n  if (normalizedDegrees < 0) normalizedDegrees += 360;\n\n  const quadrant = Math.floor(normalizedDegrees / 90) % 4;\n\n  let translateX = quadrant === 1 || quadrant === 2 ? 1 : 0;\n  let translateY = quadrant === 2 || quadrant === 3 ? 1 : 0;\n\n  if (mirror) {\n    translateX = quadrant === 0 || quadrant === 2 ? 1 - translateX : translateX;\n    translateY = quadrant === 1 || quadrant === 3 ? 1 - translateY : translateY;\n  }\n\n  return [cos * mirrorFactor, sin * mirrorFactor, 0, sin === 0 ? 0 : -sin, cos, 0, translateX, translateY, 1];\n}\n"]}

package/dist/esm/types.d.ts

@@ -0,0 +1,96 @@
+import { Lens, LensLaunchData } from "@snap/camera-kit";
+export type SourceStatus = {
+    state: "none";
+} | {
+    state: "loading";
+} | {
+    state: "ready";
+} | {
+    state: "error";
+    error: Error;
+};
+export type LensStatus = {
+    state: "none";
+} | {
+    state: "loading";
+} | {
+    state: "ready";
+} | {
+    state: "error";
+    error: Error;
+};
+export interface CurrentSource {
+    status: "none" | "loading" | "ready" | "error";
+    error: Error | undefined;
+    input: SourceInput | undefined;
+    initializedInput: SourceOutput | undefined;
+}
+export interface CurrentLens {
+    status: "none" | "loading" | "ready" | "error";
+    error: Error | undefined;
+    lensId: string | undefined;
+    lensGroupId: string | undefined;
+    lensLaunchData: LensLaunchData | undefined;
+    lensReadyGuard: (() => Promise<void>) | undefined;
+    lens: Lens | undefined;
+}
+export declare const NO_CURRENT_LENS: CurrentLens;
+export type CameraSourceInput = {
+    kind: "camera";
+    deviceId?: string;
+    options?: SourceOptions;
+};
+export type VideoSourceInput = {
+    kind: "video";
+    url: string;
+    autoplay?: boolean;
+};
+export type ImageSourceInput = {
+    kind: "image";
+    url: string;
+};
+export type SourceInput = CameraSourceInput | VideoSourceInput | ImageSourceInput;
+export declare function isCameraSource(source: SourceInput | undefined): source is CameraSourceInput;
+export declare function isVideoSource(source: SourceInput | undefined): source is VideoSourceInput;
+export declare function isImageSource(source: SourceInput | undefined): source is ImageSourceInput;
+export interface CameraInfo {
+    kind: "camera";
+    deviceId: string;
+    label: string;
+}
+export type CameraSourceOutput = CameraInfo;
+export type VideoSourceOutput = {
+    kind: "video";
+    url: string;
+    videoElement: HTMLVideoElement;
+};
+export type ImageSourceOutput = {
+    kind: "image";
+    url: string;
+    imageElement: HTMLImageElement;
+};
+export type SourceOutput = CameraSourceOutput | VideoSourceOutput | ImageSourceOutput;
+/** Explicit, fixed‐pixel dimensions */
+export interface FixedOutputSize {
+    mode: "fixed";
+    width: number;
+    height: number;
+}
+/** Exactly match whatever the camera/input delivers */
+export interface MatchInputSize {
+    mode: "match-input";
+}
+export declare const CameraRotationOptions: readonly [0, -90, 90, 180];
+export type OutputSize = MatchInputSize | FixedOutputSize;
+export interface SourceOptions {
+    cameraFacing?: CameraFacing;
+    cameraConstraints?: CameraConstraints;
+    cameraRotation?: CameraRotation;
+    fpsLimit?: number;
+    outputSize?: OutputSize;
+}
+export type CameraFacing = "user" | "environment";
+export type CameraConstraints = MediaTrackConstraints;
+export type CameraRotation = (typeof CameraRotationOptions)[number];
+export type CanvasType = "live" | "capture";
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/types.js

@@ -0,0 +1,20 @@
+export const NO_CURRENT_LENS = {
+    status: "none",
+    error: undefined,
+    lensId: undefined,
+    lensGroupId: undefined,
+    lensLaunchData: undefined,
+    lensReadyGuard: undefined,
+    lens: undefined,
+};
+export function isCameraSource(source) {
+    return source?.kind === "camera";
+}
+export function isVideoSource(source) {
+    return source?.kind === "video";
+}
+export function isImageSource(source) {
+    return source?.kind === "image";
+}
+export const CameraRotationOptions = [0, -90, 90, 180];
+//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AA+BA,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,SAAS;IACzB,cAAc,EAAE,SAAS;IACzB,IAAI,EAAE,SAAS;CAChB,CAAC;AAgBF,MAAM,UAAU,cAAc,CAAC,MAA+B;IAC5D,OAAO,MAAM,EAAE,IAAI,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,OAAO,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,OAAO,MAAM,EAAE,IAAI,KAAK,OAAO,CAAC;AAClC,CAAC;AAkCD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAU,CAAC","sourcesContent":["import { Lens, LensLaunchData } from \"@snap/camera-kit\";\n\nexport type SourceStatus =\n  | { state: \"none\" }\n  | { state: \"loading\" }\n  | { state: \"ready\" }\n  | { state: \"error\"; error: Error };\n\nexport type LensStatus =\n  | { state: \"none\" }\n  | { state: \"loading\" }\n  | { state: \"ready\" }\n  | { state: \"error\"; error: Error };\n\nexport interface CurrentSource {\n  status: \"none\" | \"loading\" | \"ready\" | \"error\";\n  error: Error | undefined;\n  input: SourceInput | undefined;\n  initializedInput: SourceOutput | undefined;\n}\n\nexport interface CurrentLens {\n  status: \"none\" | \"loading\" | \"ready\" | \"error\";\n  error: Error | undefined;\n  lensId: string | undefined;\n  lensGroupId: string | undefined;\n  lensLaunchData: LensLaunchData | undefined;\n  lensReadyGuard: (() => Promise<void>) | undefined;\n  lens: Lens | undefined;\n}\n\nexport const NO_CURRENT_LENS: CurrentLens = {\n  status: \"none\",\n  error: undefined,\n  lensId: undefined,\n  lensGroupId: undefined,\n  lensLaunchData: undefined,\n  lensReadyGuard: undefined,\n  lens: undefined,\n};\n\nexport type CameraSourceInput = {\n  kind: \"camera\";\n  deviceId?: string;\n  options?: SourceOptions;\n};\nexport type VideoSourceInput = {\n  kind: \"video\";\n  url: string;\n  autoplay?: boolean;\n};\nexport type ImageSourceInput = { kind: \"image\"; url: string };\n\nexport type SourceInput = CameraSourceInput | VideoSourceInput | ImageSourceInput;\n\nexport function isCameraSource(source: SourceInput | undefined): source is CameraSourceInput {\n  return source?.kind === \"camera\";\n}\n\nexport function isVideoSource(source: SourceInput | undefined): source is VideoSourceInput {\n  return source?.kind === \"video\";\n}\n\nexport function isImageSource(source: SourceInput | undefined): source is ImageSourceInput {\n  return source?.kind === \"image\";\n}\n\nexport interface CameraInfo {\n  kind: \"camera\";\n  deviceId: string;\n  label: string;\n}\n\nexport type CameraSourceOutput = CameraInfo;\nexport type VideoSourceOutput = {\n  kind: \"video\";\n  url: string;\n  videoElement: HTMLVideoElement;\n};\nexport type ImageSourceOutput = {\n  kind: \"image\";\n  url: string;\n  imageElement: HTMLImageElement;\n};\n\nexport type SourceOutput = CameraSourceOutput | VideoSourceOutput | ImageSourceOutput;\n\n/** Explicit, fixed‐pixel dimensions */\nexport interface FixedOutputSize {\n  mode: \"fixed\";\n  width: number;\n  height: number;\n}\n\n/** Exactly match whatever the camera/input delivers */\nexport interface MatchInputSize {\n  mode: \"match-input\";\n}\n\nexport const CameraRotationOptions = [0, -90, 90, 180] as const;\n\nexport type OutputSize = MatchInputSize | FixedOutputSize;\n\nexport interface SourceOptions {\n  cameraFacing?: CameraFacing;\n  cameraConstraints?: CameraConstraints;\n  cameraRotation?: CameraRotation;\n  fpsLimit?: number;\n  outputSize?: OutputSize;\n}\n\nexport type CameraFacing = \"user\" | \"environment\";\nexport type CameraConstraints = MediaTrackConstraints;\nexport type CameraRotation = (typeof CameraRotationOptions)[number];\n\nexport type CanvasType = \"live\" | \"capture\";\n"]}

package/dist/esm/useApplyLens.d.ts

@@ -0,0 +1,25 @@
+import { LensLaunchData } from "@snap/camera-kit";
+/**
+ * Declaratively applies a Lens to the current CameraKit session.
+ *
+ * This hook synchronizes the active lens with the provided parameters. When the lens ID,
+ * group ID, or launch data changes, the hook automatically applies the new lens or removes
+ * the current lens if parameters are cleared.
+ *
+ * @param lensId - The unique identifier of the lens to apply. If undefined, removes the current lens.
+ * @param lensGroupId - The group ID containing the lens. Required when lensId is provided.
+ * @param lensLaunchData - Optional launch parameters to pass to the lens.
+ * @param lensReadyGuard - Optional async guard that must resolve before the lens is considered ready.
+ *                         Useful for coordinating lens application with animations or other async operations.
+ *
+ * @example
+ * ```tsx
+ * // Simple lens application
+ * useApplyLens("lens-id-123", "my-group");
+ *
+ * // With launch data
+ * useApplyLens("lens-id-123", "my-group", { launchParams: { hint: "face" } });
+ * ```
+ */
+export declare function useApplyLens(lensId?: string, lensGroupId?: string, lensLaunchData?: LensLaunchData, lensReadyGuard?: () => Promise<void>): void;
+//# sourceMappingURL=useApplyLens.d.ts.map

package/dist/esm/useApplyLens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplyLens.d.ts","sourceRoot":"","sources":["../../src/useApplyLens.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAC1B,MAAM,CAAC,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,cAAc,EAC/B,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,QA4DrC"}

package/dist/esm/useApplyLens.js

@@ -0,0 +1,81 @@
+import { useEffect, useMemo, useRef } from "react";
+import hash from "stable-hash";
+import { useInternalCameraKit } from "./CameraKitProvider";
+/**
+ * Declaratively applies a Lens to the current CameraKit session.
+ *
+ * This hook synchronizes the active lens with the provided parameters. When the lens ID,
+ * group ID, or launch data changes, the hook automatically applies the new lens or removes
+ * the current lens if parameters are cleared.
+ *
+ * @param lensId - The unique identifier of the lens to apply. If undefined, removes the current lens.
+ * @param lensGroupId - The group ID containing the lens. Required when lensId is provided.
+ * @param lensLaunchData - Optional launch parameters to pass to the lens.
+ * @param lensReadyGuard - Optional async guard that must resolve before the lens is considered ready.
+ *                         Useful for coordinating lens application with animations or other async operations.
+ *
+ * @example
+ * ```tsx
+ * // Simple lens application
+ * useApplyLens("lens-id-123", "my-group");
+ *
+ * // With launch data
+ * useApplyLens("lens-id-123", "my-group", { launchParams: { hint: "face" } });
+ * ```
+ */
+export function useApplyLens(lensId, lensGroupId, lensLaunchData, lensReadyGuard) {
+    const { cameraKit, sdkStatus, currentSession, applyLens, removeLens, getLogger } = useInternalCameraKit();
+    const log = getLogger("useApplyLens");
+    const launchKey = hash(lensLaunchData);
+    const safeLaunchData = useMemo(() => lensLaunchData, [launchKey]);
+    // Don’t put lensReadyGuard in the dependency array of the “apply-lens” effect:
+    // the caller often passes it as an inline function, so its identity
+    // changes on every render. Re-running the whole lens-apply sequence just
+    // because the guard’s reference changed doesn't make any sense.
+    // It does make sense ony next time lens is applied.
+    // Instead, we store the latest guard in a ref that we update after each re-render.
+    const guardRef = useRef(lensReadyGuard);
+    useEffect(() => {
+        guardRef.current = lensReadyGuard;
+    });
+    //  Synchronize the current CameraKit session with the requested Lens.
+    //   * Runs when lensId, lensGroupId, or lensLaunchData meaningfully change (see stable-key check).
+    //   * Applies the Lens once, with an abort-guard so late resolutions don’t touch an unmounted component.
+    useEffect(() => {
+        if (sdkStatus !== "ready" || !cameraKit || !currentSession)
+            return;
+        if (!lensId || !lensGroupId) {
+            removeLens();
+            return;
+        }
+        let cancelled = false;
+        const started = performance.now();
+        log.info("apply_attempt", { lensId, groupId: lensGroupId });
+        (async () => {
+            try {
+                await applyLens(lensId, lensGroupId, safeLaunchData, guardRef.current);
+                if (cancelled) {
+                    await removeLens();
+                    return;
+                }
+                log.info("apply_success", {
+                    lensId,
+                    groupId: lensGroupId,
+                    elapsedMs: Math.round(performance.now() - started),
+                });
+            }
+            catch (err) {
+                if (cancelled)
+                    return;
+                log.error("apply_failure", { lensId, groupId: lensGroupId }, err);
+            }
+        })();
+        return () => {
+            cancelled = true;
+            removeLens().catch((err) => {
+                log.warn("remove_on_unmount_failed", { lensId, groupId: lensGroupId }, err);
+            });
+        };
+    }, [lensId, lensGroupId, launchKey, sdkStatus, cameraKit, currentSession, applyLens, removeLens, log]);
+}
+//# sourceMappingURL=useApplyLens.js.map

package/dist/esm/useApplyLens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplyLens.js","sourceRoot":"","sources":["../../src/useApplyLens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,IAAI,MAAM,aAAa,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAe,EACf,WAAoB,EACpB,cAA+B,EAC/B,cAAoC;IAEpC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC1G,MAAM,GAAG,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;IAEtC,MAAM,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC;IACvC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAElE,+EAA+E;IAC/E,oEAAoE;IACpE,yEAAyE;IACzE,gEAAgE;IAChE,oDAAoD;IACpD,mFAAmF;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC;IACxC,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,OAAO,GAAG,cAAc,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,sEAAsE;IACtE,mGAAmG;IACnG,yGAAyG;IACzG,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,KAAK,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,cAAc;YAAE,OAAO;QAEnE,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5B,UAAU,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAElC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;QAE5D,CAAC,KAAK,IAAI,EAAE;YACV,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACvE,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,UAAU,EAAE,CAAC;oBACnB,OAAO;gBACT,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE;oBACxB,MAAM;oBACN,OAAO,EAAE,WAAW;oBACpB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC;iBACnD,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,SAAS;oBAAE,OAAO;gBACtB,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;YACpE,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE;YACV,SAAS,GAAG,IAAI,CAAC;YACjB,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBACzB,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,GAAG,CAAC,CAAC;YAC9E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;AACzG,CAAC","sourcesContent":["import { useEffect, useMemo, useRef } from \"react\";\nimport { LensLaunchData } from \"@snap/camera-kit\";\nimport hash from \"stable-hash\";\nimport { useInternalCameraKit } from \"./CameraKitProvider\";\n\n/**\n * Declaratively applies a Lens to the current CameraKit session.\n *\n * This hook synchronizes the active lens with the provided parameters. When the lens ID,\n * group ID, or launch data changes, the hook automatically applies the new lens or removes\n * the current lens if parameters are cleared.\n *\n * @param lensId - The unique identifier of the lens to apply. If undefined, removes the current lens.\n * @param lensGroupId - The group ID containing the lens. Required when lensId is provided.\n * @param lensLaunchData - Optional launch parameters to pass to the lens.\n * @param lensReadyGuard - Optional async guard that must resolve before the lens is considered ready.\n *                         Useful for coordinating lens application with animations or other async operations.\n *\n * @example\n * ```tsx\n * // Simple lens application\n * useApplyLens(\"lens-id-123\", \"my-group\");\n *\n * // With launch data\n * useApplyLens(\"lens-id-123\", \"my-group\", { launchParams: { hint: \"face\" } });\n * ```\n */\nexport function useApplyLens(\n  lensId?: string,\n  lensGroupId?: string,\n  lensLaunchData?: LensLaunchData,\n  lensReadyGuard?: () => Promise<void>,\n) {\n  const { cameraKit, sdkStatus, currentSession, applyLens, removeLens, getLogger } = useInternalCameraKit();\n  const log = getLogger(\"useApplyLens\");\n\n  const launchKey = hash(lensLaunchData);\n  const safeLaunchData = useMemo(() => lensLaunchData, [launchKey]);\n\n  // Don’t put lensReadyGuard in the dependency array of the “apply-lens” effect:\n  // the caller often passes it as an inline function, so its identity\n  // changes on every render. Re-running the whole lens-apply sequence just\n  // because the guard’s reference changed doesn't make any sense.\n  // It does make sense ony next time lens is applied.\n  // Instead, we store the latest guard in a ref that we update after each re-render.\n  const guardRef = useRef(lensReadyGuard);\n  useEffect(() => {\n    guardRef.current = lensReadyGuard;\n  });\n\n  //  Synchronize the current CameraKit session with the requested Lens.\n  //   * Runs when lensId, lensGroupId, or lensLaunchData meaningfully change (see stable-key check).\n  //   * Applies the Lens once, with an abort-guard so late resolutions don’t touch an unmounted component.\n  useEffect(() => {\n    if (sdkStatus !== \"ready\" || !cameraKit || !currentSession) return;\n\n    if (!lensId || !lensGroupId) {\n      removeLens();\n      return;\n    }\n\n    let cancelled = false;\n    const started = performance.now();\n\n    log.info(\"apply_attempt\", { lensId, groupId: lensGroupId });\n\n    (async () => {\n      try {\n        await applyLens(lensId, lensGroupId, safeLaunchData, guardRef.current);\n        if (cancelled) {\n          await removeLens();\n          return;\n        }\n        log.info(\"apply_success\", {\n          lensId,\n          groupId: lensGroupId,\n          elapsedMs: Math.round(performance.now() - started),\n        });\n      } catch (err) {\n        if (cancelled) return;\n        log.error(\"apply_failure\", { lensId, groupId: lensGroupId }, err);\n      }\n    })();\n\n    return () => {\n      cancelled = true;\n      removeLens().catch((err) => {\n        log.warn(\"remove_on_unmount_failed\", { lensId, groupId: lensGroupId }, err);\n      });\n    };\n  }, [lensId, lensGroupId, launchKey, sdkStatus, cameraKit, currentSession, applyLens, removeLens, log]);\n}\n"]}

package/dist/esm/useApplySource.d.ts

@@ -0,0 +1,11 @@
+import { OutputSize, SourceInput } from "./types";
+/**
+ * Declarative hook to apply a source to the current CameraKit session.
+ * This is a thin wrapper around the imperative `applySource` and `removeSource` methods
+ * exposed by `useCameraKit()`.
+ *
+ * @param source - The source input (camera, video, or image)
+ * @param outputSize - Optional output size configuration
+ */
+export declare function useApplySource(source?: SourceInput, outputSize?: OutputSize): void;
+//# sourceMappingURL=useApplySource.d.ts.map

package/dist/esm/useApplySource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useApplySource.d.ts","sourceRoot":"","sources":["../../src/useApplySource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,GAAE,WAAgC,EAAE,UAAU,CAAC,EAAE,UAAU,QAmD/F"}