@snap/react-camera-kit 0.0.1

package/dist/cjs/Canvas.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptureCanvas = exports.LiveCanvas = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const CameraKitProvider_1 = require("./CameraKitProvider");
+// --- Internal helper hookup -------------------------------------------------
+function attachCanvas(container, canvas) {
+    if (!container.contains(canvas))
+        container.appendChild(canvas);
+}
+function detachCanvas(container, canvas) {
+    if (container?.contains(canvas))
+        container.removeChild(canvas);
+}
+// --- Live child -------------------------------------------------------------
+const LiveCanvas = ({ className, style }) => {
+    const { currentSession } = (0, CameraKitProvider_1.useInternalCameraKit)();
+    const containerRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        if (!currentSession || !containerRef.current)
+            return;
+        attachCanvas(containerRef.current, currentSession.output.live);
+        currentSession.play("live");
+        return () => {
+            detachCanvas(containerRef.current, currentSession.output.live);
+            currentSession.pause("live");
+        };
+    }, [currentSession]);
+    return (0, jsx_runtime_1.jsx)("div", { ref: containerRef, className: className, style: style });
+};
+exports.LiveCanvas = LiveCanvas;
+// --- Capture child ----------------------------------------------------------
+const CaptureCanvas = ({ className, style }) => {
+    const { currentSession } = (0, CameraKitProvider_1.useInternalCameraKit)();
+    const containerRef = (0, react_1.useRef)(null);
+    (0, react_1.useEffect)(() => {
+        if (!currentSession || !containerRef.current)
+            return;
+        attachCanvas(containerRef.current, currentSession.output.capture);
+        currentSession.play("capture");
+        return () => {
+            detachCanvas(containerRef.current, currentSession.output.capture);
+            currentSession.pause("capture");
+        };
+    }, [currentSession]);
+    return (0, jsx_runtime_1.jsx)("div", { ref: containerRef, className: className, style: style });
+};
+exports.CaptureCanvas = CaptureCanvas;
+//# sourceMappingURL=Canvas.js.map

package/dist/cjs/Canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Canvas.js","sourceRoot":"","sources":["../../src/Canvas.tsx"],"names":[],"mappings":";;;;AAAA,iCAA0C;AAC1C,2DAA2D;AAO3D,+EAA+E;AAC/E,SAAS,YAAY,CAAC,SAAsB,EAAE,MAAyB;IACrE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,YAAY,CAAC,SAA6B,EAAE,MAAyB;IAC5E,IAAI,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC;QAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC;AAED,+EAA+E;AACxE,MAAM,UAAU,GAA+B,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;IAC7E,MAAM,EAAE,cAAc,EAAE,GAAG,IAAA,wCAAoB,GAAE,CAAC;IAClD,MAAM,YAAY,GAAG,IAAA,cAAM,EAAiB,IAAI,CAAC,CAAC;IAElD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,OAAO;QAErD,YAAY,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/D,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE5B,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC/D,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,OAAO,gCAAK,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CAAC;AACxE,CAAC,CAAC;AAjBW,QAAA,UAAU,cAiBrB;AAEF,+EAA+E;AACxE,MAAM,aAAa,GAA+B,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE;IAChF,MAAM,EAAE,cAAc,EAAE,GAAG,IAAA,wCAAoB,GAAE,CAAC;IAClD,MAAM,YAAY,GAAG,IAAA,cAAM,EAAiB,IAAI,CAAC,CAAC;IAElD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,CAAC,cAAc,IAAI,CAAC,YAAY,CAAC,OAAO;YAAE,OAAO;QAErD,YAAY,CAAC,YAAY,CAAC,OAAO,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAClE,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE/B,OAAO,GAAG,EAAE;YACV,YAAY,CAAC,YAAY,CAAC,OAAQ,EAAE,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACnE,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,OAAO,gCAAK,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CAAC;AACxE,CAAC,CAAC;AAjBW,QAAA,aAAa,iBAiBxB","sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { useInternalCameraKit } from \"./CameraKitProvider\";\n\nexport interface CanvasChildProps {\n  className?: string;\n  style?: React.CSSProperties;\n}\n\n// --- Internal helper hookup -------------------------------------------------\nfunction attachCanvas(container: HTMLElement, canvas: HTMLCanvasElement) {\n  if (!container.contains(canvas)) container.appendChild(canvas);\n}\n\nfunction detachCanvas(container: HTMLElement | null, canvas: HTMLCanvasElement) {\n  if (container?.contains(canvas)) container.removeChild(canvas);\n}\n\n// --- Live child -------------------------------------------------------------\nexport const LiveCanvas: React.FC<CanvasChildProps> = ({ className, style }) => {\n  const { currentSession } = useInternalCameraKit();\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!currentSession || !containerRef.current) return;\n\n    attachCanvas(containerRef.current, currentSession.output.live);\n    currentSession.play(\"live\");\n\n    return () => {\n      detachCanvas(containerRef.current, currentSession.output.live);\n      currentSession.pause(\"live\");\n    };\n  }, [currentSession]);\n\n  return <div ref={containerRef} className={className} style={style} />;\n};\n\n// --- Capture child ----------------------------------------------------------\nexport const CaptureCanvas: React.FC<CanvasChildProps> = ({ className, style }) => {\n  const { currentSession } = useInternalCameraKit();\n  const containerRef = useRef<HTMLDivElement>(null);\n\n  useEffect(() => {\n    if (!currentSession || !containerRef.current) return;\n\n    attachCanvas(containerRef.current, currentSession.output.capture);\n    currentSession.play(\"capture\");\n\n    return () => {\n      detachCanvas(containerRef.current!, currentSession.output.capture);\n      currentSession.pause(\"capture\");\n    };\n  }, [currentSession]);\n\n  return <div ref={containerRef} className={className} style={style} />;\n};\n"]}

package/dist/cjs/LensPlayer.d.ts

@@ -0,0 +1,101 @@
+import { ReactNode } from "react";
+import { CameraKitSessionEvents, Lens, LensLaunchData, ScreenRegions } from "@snap/camera-kit";
+import { CanvasType, OutputSize, SourceInput } from "./types";
+/**
+ * Props for the LensPlayer component.
+ */
+export interface LensPlayerProps {
+    /** The media source to apply (camera, video, or image). Defaults to camera if not specified. */
+    source?: SourceInput;
+    /** Optional output size configuration for the rendering canvas. */
+    outputSize?: OutputSize;
+    /** The unique identifier of the Lens to apply. */
+    lensId?: string;
+    /** The group ID containing the Lens. Required when lensId is provided. */
+    lensGroupId?: string;
+    /** Optional launch parameters to pass to the Lens.. */
+    lensLaunchData?: LensLaunchData;
+    /** Optional async guard that must resolve before the Lens is considered ready.
+     * The guard is called when the lens is in loading state,
+     * and when the promise returned by the function resolves, it will transition to the ready state.
+     * If the promise doesn't resolve within 2 seconds, the ready state is forced. */
+    lensReadyGuard?: () => Promise<void>;
+    /**
+     * Trigger to refresh the current Lens. When this value changes,
+     * the Lens will be removed and reapplied. Useful for restarting
+     * the Lens experience without moving LensPlayer to another component.
+     */
+    refreshTrigger?: unknown;
+    /** Which canvas to render: "live" for real-time preview or "capture" for snapshot. Defaults to "live". */
+    canvasType?: CanvasType;
+    /**
+     * A maximum FPS, rendering will not exceed this limit.
+     *
+     * This may be useful to reduce CPU/GPU resource usage by CameraKit if, for example,
+     * the input media source has a low FPS – CameraKit would then not try to render more
+     * frequently than the source produces new frames.
+     *
+     * This may also be useful to gracefully degrade performance in situations where
+     * lowering FPS is preferable over alternatives.
+     */
+    fpsLimit?: number;
+    /**
+     * Whether to mute all sounds. Unmuted by default.
+     */
+    muted?: boolean;
+    /**
+     * Configuration object containing the current set of screen regions.
+     *
+     * Screen regions define areas of the screen that have special meaning for Lens rendering,
+     * such as safe rendering areas, UI button locations, keyboard areas, etc. This allows lenses
+     * to adapt their content placement based on the host application's UI layout.
+     */
+    screenRegions?: ScreenRegions;
+    /**
+     * A callback to handle Lens playback errors.
+     */
+    onError?: (error: CameraKitSessionEvents["detail"]["error"], lens: Lens) => void;
+    /** CSS class name to apply to the wrapper or canvas element. */
+    className?: string;
+    /** Inline styles to apply to the wrapper or canvas element. */
+    style?: React.CSSProperties;
+    /** Custom children to render instead of the default canvas. When provided, children are wrapped in a styled div. */
+    children?: ReactNode;
+}
+/**
+ * A declarative, all-in-one component for rendering Camera Kit Lenses.
+ *
+ * LensPlayer combines source management, lens application, and playback controls into a single
+ * component. It handles the complexity of coordinating multiple hooks and provides a simple
+ * prop-based API for common use cases.
+ *
+ * @example
+ * ```tsx
+ * // Basic lens player with camera source
+ * <LensPlayer lensId="lens-123" lensGroupId="my-group" />
+ *
+ * // With custom source and output size
+ * <LensPlayer
+ *   source={{ kind: "video", element: videoElement }}
+ *   outputSize={{ mode: "fixed", width: 1280, height: 720 }}
+ *   lensId="lens-123"
+ *   lensGroupId="my-group"
+ * />
+ *
+ * // With playback controls and error handling
+ * <LensPlayer
+ *   lensId="lens-123"
+ *   lensGroupId="my-group"
+ *   fpsLimit={30}
+ *   muted={true}
+ *   onError={(error) => console.error("Playback error:", error)}
+ * />
+ *
+ * // With custom children instead of default canvas
+ * <LensPlayer lensId="lens-123" lensGroupId="my-group">
+ *   <div>Custom UI overlaying the Lens <LiveCanvas /></div>
+ * </LensPlayer>
+ * ```
+ */
+export declare const LensPlayer: React.FC<LensPlayerProps>;
+//# sourceMappingURL=LensPlayer.d.ts.map

package/dist/cjs/LensPlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensPlayer.d.ts","sourceRoot":"","sources":["../../src/LensPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,OAAO,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAO9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gGAAgG;IAChG,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB,mEAAmE;IACnE,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uDAAuD;IACvD,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;qFAGiF;IACjF,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAEjF,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+DAA+D;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAE5B,oHAAoH;IACpH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA8ChD,CAAC"}

package/dist/cjs/LensPlayer.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LensPlayer = void 0;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const useApplySource_1 = require("./useApplySource");
+const useApplyLens_1 = require("./useApplyLens");
+const usePlaybackOptions_1 = require("./usePlaybackOptions");
+const Canvas_1 = require("./Canvas");
+const CameraKitProvider_1 = require("./CameraKitProvider");
+/**
+ * A declarative, all-in-one component for rendering Camera Kit Lenses.
+ *
+ * LensPlayer combines source management, lens application, and playback controls into a single
+ * component. It handles the complexity of coordinating multiple hooks and provides a simple
+ * prop-based API for common use cases.
+ *
+ * @example
+ * ```tsx
+ * // Basic lens player with camera source
+ * <LensPlayer lensId="lens-123" lensGroupId="my-group" />
+ *
+ * // With custom source and output size
+ * <LensPlayer
+ *   source={{ kind: "video", element: videoElement }}
+ *   outputSize={{ mode: "fixed", width: 1280, height: 720 }}
+ *   lensId="lens-123"
+ *   lensGroupId="my-group"
+ * />
+ *
+ * // With playback controls and error handling
+ * <LensPlayer
+ *   lensId="lens-123"
+ *   lensGroupId="my-group"
+ *   fpsLimit={30}
+ *   muted={true}
+ *   onError={(error) => console.error("Playback error:", error)}
+ * />
+ *
+ * // With custom children instead of default canvas
+ * <LensPlayer lensId="lens-123" lensGroupId="my-group">
+ *   <div>Custom UI overlaying the Lens <LiveCanvas /></div>
+ * </LensPlayer>
+ * ```
+ */
+const LensPlayer = ({ source, outputSize, lensId, lensGroupId, lensLaunchData, lensReadyGuard, refreshTrigger, canvasType, fpsLimit, muted, screenRegions, onError, className, style, children, }) => {
+    (0, usePlaybackOptions_1.usePlaybackOptions)({ fpsLimit, muted, screenRegions, onError });
+    (0, useApplySource_1.useApplySource)(source, outputSize);
+    (0, useApplyLens_1.useApplyLens)(lensId, lensGroupId, lensLaunchData, lensReadyGuard);
+    // Handle refresh trigger - only refresh when the value actually changes (not on mount)
+    const { refreshLens } = (0, CameraKitProvider_1.useCameraKit)();
+    const prevRefreshTrigger = (0, react_1.useRef)(refreshTrigger);
+    (0, react_1.useEffect)(() => {
+        if (prevRefreshTrigger.current !== refreshTrigger) {
+            prevRefreshTrigger.current = refreshTrigger;
+            refreshLens();
+        }
+    }, [refreshTrigger, refreshLens]);
+    if (children) {
+        // If custom children were provided, we wrap them to allow styling at the outer div.
+        return ((0, jsx_runtime_1.jsx)("div", { className: className, style: style, children: children }));
+    }
+    // Otherwise, we render the asked (or by default live) canvas.
+    return canvasType === "capture" ? ((0, jsx_runtime_1.jsx)(Canvas_1.CaptureCanvas, { className: className, style: style })) : ((0, jsx_runtime_1.jsx)(Canvas_1.LiveCanvas, { className: className, style: style }));
+};
+exports.LensPlayer = LensPlayer;
+//# sourceMappingURL=LensPlayer.js.map

package/dist/cjs/LensPlayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LensPlayer.js","sourceRoot":"","sources":["../../src/LensPlayer.tsx"],"names":[],"mappings":";;;;AAAA,iCAAqD;AAGrD,qDAAkD;AAClD,iDAA8C;AAC9C,6DAA0D;AAC1D,qCAAqD;AACrD,2DAAmD;AA8EnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACI,MAAM,UAAU,GAA8B,CAAC,EACpD,MAAM,EACN,UAAU,EACV,MAAM,EACN,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,EACd,UAAU,EACV,QAAQ,EACR,KAAK,EACL,aAAa,EACb,OAAO,EACP,SAAS,EACT,KAAK,EACL,QAAQ,GACT,EAAE,EAAE;IACH,IAAA,uCAAkB,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,CAAC;IAChE,IAAA,+BAAc,EAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,IAAA,2BAAY,EAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;IAElE,uFAAuF;IACvF,MAAM,EAAE,WAAW,EAAE,GAAG,IAAA,gCAAY,GAAE,CAAC;IACvC,MAAM,kBAAkB,GAAG,IAAA,cAAM,EAAC,cAAc,CAAC,CAAC;IAClD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,kBAAkB,CAAC,OAAO,KAAK,cAAc,EAAE,CAAC;YAClD,kBAAkB,CAAC,OAAO,GAAG,cAAc,CAAC;YAC5C,WAAW,EAAE,CAAC;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,IAAI,QAAQ,EAAE,CAAC;QACb,oFAAoF;QACpF,OAAO,CACL,gCAAK,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,YACpC,QAAQ,GACL,CACP,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,OAAO,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAChC,uBAAC,sBAAa,IAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CACtD,CAAC,CAAC,CAAC,CACF,uBAAC,mBAAU,IAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAI,CACnD,CAAC;AACJ,CAAC,CAAC;AA9CW,QAAA,UAAU,cA8CrB","sourcesContent":["import { ReactNode, useEffect, useRef } from \"react\";\nimport { CameraKitSessionEvents, Lens, LensLaunchData, ScreenRegions } from \"@snap/camera-kit\";\nimport { CanvasType, OutputSize, SourceInput } from \"./types\";\nimport { useApplySource } from \"./useApplySource\";\nimport { useApplyLens } from \"./useApplyLens\";\nimport { usePlaybackOptions } from \"./usePlaybackOptions\";\nimport { CaptureCanvas, LiveCanvas } from \"./Canvas\";\nimport { useCameraKit } from \"./CameraKitProvider\";\n\n/**\n * Props for the LensPlayer component.\n */\nexport interface LensPlayerProps {\n  /** The media source to apply (camera, video, or image). Defaults to camera if not specified. */\n  source?: SourceInput;\n\n  /** Optional output size configuration for the rendering canvas. */\n  outputSize?: OutputSize;\n\n  /** The unique identifier of the Lens to apply. */\n  lensId?: string;\n\n  /** The group ID containing the Lens. Required when lensId is provided. */\n  lensGroupId?: string;\n\n  /** Optional launch parameters to pass to the Lens.. */\n  lensLaunchData?: LensLaunchData;\n\n  /** Optional async guard that must resolve before the Lens is considered ready.\n   * The guard is called when the lens is in loading state,\n   * and when the promise returned by the function resolves, it will transition to the ready state.\n   * If the promise doesn't resolve within 2 seconds, the ready state is forced. */\n  lensReadyGuard?: () => Promise<void>;\n\n  /**\n   * Trigger to refresh the current Lens. When this value changes,\n   * the Lens will be removed and reapplied. Useful for restarting\n   * the Lens experience without moving LensPlayer to another component.\n   */\n  refreshTrigger?: unknown;\n\n  /** Which canvas to render: \"live\" for real-time preview or \"capture\" for snapshot. Defaults to \"live\". */\n  canvasType?: CanvasType;\n\n  /**\n   * A maximum FPS, rendering will not exceed this limit.\n   *\n   * This may be useful to reduce CPU/GPU resource usage by CameraKit if, for example,\n   * the input media source has a low FPS – CameraKit would then not try to render more\n   * frequently than the source produces new frames.\n   *\n   * This may also be useful to gracefully degrade performance in situations where\n   * lowering FPS is preferable over alternatives.\n   */\n  fpsLimit?: number;\n\n  /**\n   * Whether to mute all sounds. Unmuted by default.\n   */\n  muted?: boolean;\n\n  /**\n   * Configuration object containing the current set of screen regions.\n   *\n   * Screen regions define areas of the screen that have special meaning for Lens rendering,\n   * such as safe rendering areas, UI button locations, keyboard areas, etc. This allows lenses\n   * to adapt their content placement based on the host application's UI layout.\n   */\n  screenRegions?: ScreenRegions;\n\n  /**\n   * A callback to handle Lens playback errors.\n   */\n  onError?: (error: CameraKitSessionEvents[\"detail\"][\"error\"], lens: Lens) => void;\n\n  /** CSS class name to apply to the wrapper or canvas element. */\n  className?: string;\n\n  /** Inline styles to apply to the wrapper or canvas element. */\n  style?: React.CSSProperties;\n\n  /** Custom children to render instead of the default canvas. When provided, children are wrapped in a styled div. */\n  children?: ReactNode;\n}\n\n/**\n * A declarative, all-in-one component for rendering Camera Kit Lenses.\n *\n * LensPlayer combines source management, lens application, and playback controls into a single\n * component. It handles the complexity of coordinating multiple hooks and provides a simple\n * prop-based API for common use cases.\n *\n * @example\n * ```tsx\n * // Basic lens player with camera source\n * <LensPlayer lensId=\"lens-123\" lensGroupId=\"my-group\" />\n *\n * // With custom source and output size\n * <LensPlayer\n *   source={{ kind: \"video\", element: videoElement }}\n *   outputSize={{ mode: \"fixed\", width: 1280, height: 720 }}\n *   lensId=\"lens-123\"\n *   lensGroupId=\"my-group\"\n * />\n *\n * // With playback controls and error handling\n * <LensPlayer\n *   lensId=\"lens-123\"\n *   lensGroupId=\"my-group\"\n *   fpsLimit={30}\n *   muted={true}\n *   onError={(error) => console.error(\"Playback error:\", error)}\n * />\n *\n * // With custom children instead of default canvas\n * <LensPlayer lensId=\"lens-123\" lensGroupId=\"my-group\">\n *   <div>Custom UI overlaying the Lens <LiveCanvas /></div>\n * </LensPlayer>\n * ```\n */\nexport const LensPlayer: React.FC<LensPlayerProps> = ({\n  source,\n  outputSize,\n  lensId,\n  lensGroupId,\n  lensLaunchData,\n  lensReadyGuard,\n  refreshTrigger,\n  canvasType,\n  fpsLimit,\n  muted,\n  screenRegions,\n  onError,\n  className,\n  style,\n  children,\n}) => {\n  usePlaybackOptions({ fpsLimit, muted, screenRegions, onError });\n  useApplySource(source, outputSize);\n  useApplyLens(lensId, lensGroupId, lensLaunchData, lensReadyGuard);\n\n  // Handle refresh trigger - only refresh when the value actually changes (not on mount)\n  const { refreshLens } = useCameraKit();\n  const prevRefreshTrigger = useRef(refreshTrigger);\n  useEffect(() => {\n    if (prevRefreshTrigger.current !== refreshTrigger) {\n      prevRefreshTrigger.current = refreshTrigger;\n      refreshLens();\n    }\n  }, [refreshTrigger, refreshLens]);\n\n  if (children) {\n    // If custom children were provided, we wrap them to allow styling at the outer div.\n    return (\n      <div className={className} style={style}>\n        {children}\n      </div>\n    );\n  }\n\n  // Otherwise, we render the asked (or by default live) canvas.\n  return canvasType === \"capture\" ? (\n    <CaptureCanvas className={className} style={style} />\n  ) : (\n    <LiveCanvas className={className} style={style} />\n  );\n};\n"]}

package/dist/cjs/index.d.ts

@@ -0,0 +1,17 @@
+export { CameraKitProvider, useCameraKit } from "./CameraKitProvider";
+export type { MetricEventHandlerFactory } from "./CameraKitProvider";
+export type { CameraKitLogger, LogLevel } from "./internal/logging";
+export { createConsoleLogger, createNoopLogger } from "./internal/logging";
+export { LensPlayer } from "./LensPlayer";
+export type { LensPlayerProps } from "./LensPlayer";
+export { LiveCanvas, CaptureCanvas } from "./Canvas";
+export type { CanvasChildProps } from "./Canvas";
+export { useApplyLens } from "./useApplyLens";
+export { useApplySource } from "./useApplySource";
+export { usePlaybackOptions } from "./usePlaybackOptions";
+export type { PlaybackOptions } from "./usePlaybackOptions";
+export type { SourceStatus, LensStatus, CurrentSource, CurrentLens, CameraSourceInput, VideoSourceInput, ImageSourceInput, SourceInput, CameraSourceOutput, VideoSourceOutput, ImageSourceOutput, SourceOutput, FixedOutputSize, MatchInputSize, OutputSize, SourceOptions, CameraFacing, CameraConstraints, CameraRotation, CanvasType, CameraInfo, } from "./types";
+export { NO_CURRENT_LENS, isCameraSource, isVideoSource, isImageSource, CameraRotationOptions } from "./types";
+export { createCameraKitSource, DEFAULT_CAMERA_DEVICE_ID, defaultStreamResolution } from "./internal/sourceUtils";
+export type { SourceApplication, TupleOf } from "./internal/sourceUtils";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACtE,YAAY,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAGrE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAGjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG5D,YAAY,EACV,YAAY,EACZ,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAG/G,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAClH,YAAY,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultStreamResolution = exports.DEFAULT_CAMERA_DEVICE_ID = exports.createCameraKitSource = exports.CameraRotationOptions = exports.isImageSource = exports.isVideoSource = exports.isCameraSource = exports.NO_CURRENT_LENS = exports.usePlaybackOptions = exports.useApplySource = exports.useApplyLens = exports.CaptureCanvas = exports.LiveCanvas = exports.LensPlayer = exports.createNoopLogger = exports.createConsoleLogger = exports.useCameraKit = exports.CameraKitProvider = void 0;
+// Main components
+var CameraKitProvider_1 = require("./CameraKitProvider");
+Object.defineProperty(exports, "CameraKitProvider", { enumerable: true, get: function () { return CameraKitProvider_1.CameraKitProvider; } });
+Object.defineProperty(exports, "useCameraKit", { enumerable: true, get: function () { return CameraKitProvider_1.useCameraKit; } });
+var logging_1 = require("./internal/logging");
+Object.defineProperty(exports, "createConsoleLogger", { enumerable: true, get: function () { return logging_1.createConsoleLogger; } });
+Object.defineProperty(exports, "createNoopLogger", { enumerable: true, get: function () { return logging_1.createNoopLogger; } });
+var LensPlayer_1 = require("./LensPlayer");
+Object.defineProperty(exports, "LensPlayer", { enumerable: true, get: function () { return LensPlayer_1.LensPlayer; } });
+var Canvas_1 = require("./Canvas");
+Object.defineProperty(exports, "LiveCanvas", { enumerable: true, get: function () { return Canvas_1.LiveCanvas; } });
+Object.defineProperty(exports, "CaptureCanvas", { enumerable: true, get: function () { return Canvas_1.CaptureCanvas; } });
+// Hooks
+var useApplyLens_1 = require("./useApplyLens");
+Object.defineProperty(exports, "useApplyLens", { enumerable: true, get: function () { return useApplyLens_1.useApplyLens; } });
+var useApplySource_1 = require("./useApplySource");
+Object.defineProperty(exports, "useApplySource", { enumerable: true, get: function () { return useApplySource_1.useApplySource; } });
+var usePlaybackOptions_1 = require("./usePlaybackOptions");
+Object.defineProperty(exports, "usePlaybackOptions", { enumerable: true, get: function () { return usePlaybackOptions_1.usePlaybackOptions; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "NO_CURRENT_LENS", { enumerable: true, get: function () { return types_1.NO_CURRENT_LENS; } });
+Object.defineProperty(exports, "isCameraSource", { enumerable: true, get: function () { return types_1.isCameraSource; } });
+Object.defineProperty(exports, "isVideoSource", { enumerable: true, get: function () { return types_1.isVideoSource; } });
+Object.defineProperty(exports, "isImageSource", { enumerable: true, get: function () { return types_1.isImageSource; } });
+Object.defineProperty(exports, "CameraRotationOptions", { enumerable: true, get: function () { return types_1.CameraRotationOptions; } });
+// Source utilities
+var sourceUtils_1 = require("./internal/sourceUtils");
+Object.defineProperty(exports, "createCameraKitSource", { enumerable: true, get: function () { return sourceUtils_1.createCameraKitSource; } });
+Object.defineProperty(exports, "DEFAULT_CAMERA_DEVICE_ID", { enumerable: true, get: function () { return sourceUtils_1.DEFAULT_CAMERA_DEVICE_ID; } });
+Object.defineProperty(exports, "defaultStreamResolution", { enumerable: true, get: function () { return sourceUtils_1.defaultStreamResolution; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,kBAAkB;AAClB,yDAAsE;AAA7D,sHAAA,iBAAiB,OAAA;AAAE,iHAAA,YAAY,OAAA;AAKxC,8CAA2E;AAAlE,8GAAA,mBAAmB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAE9C,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAGnB,mCAAqD;AAA5C,oGAAA,UAAU,OAAA;AAAE,uGAAA,aAAa,OAAA;AAGlC,QAAQ;AACR,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AA4B3B,iCAA+G;AAAtG,wGAAA,eAAe,OAAA;AAAE,uGAAA,cAAc,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,8GAAA,qBAAqB,OAAA;AAE7F,mBAAmB;AACnB,sDAAkH;AAAzG,oHAAA,qBAAqB,OAAA;AAAE,uHAAA,wBAAwB,OAAA;AAAE,sHAAA,uBAAuB,OAAA","sourcesContent":["// Main components\nexport { CameraKitProvider, useCameraKit } from \"./CameraKitProvider\";\nexport type { MetricEventHandlerFactory } from \"./CameraKitProvider\";\n\n// Logging\nexport type { CameraKitLogger, LogLevel } from \"./internal/logging\";\nexport { createConsoleLogger, createNoopLogger } from \"./internal/logging\";\n\nexport { LensPlayer } from \"./LensPlayer\";\nexport type { LensPlayerProps } from \"./LensPlayer\";\n\nexport { LiveCanvas, CaptureCanvas } from \"./Canvas\";\nexport type { CanvasChildProps } from \"./Canvas\";\n\n// Hooks\nexport { useApplyLens } from \"./useApplyLens\";\nexport { useApplySource } from \"./useApplySource\";\nexport { usePlaybackOptions } from \"./usePlaybackOptions\";\nexport type { PlaybackOptions } from \"./usePlaybackOptions\";\n\n// Types\nexport type {\n  SourceStatus,\n  LensStatus,\n  CurrentSource,\n  CurrentLens,\n  CameraSourceInput,\n  VideoSourceInput,\n  ImageSourceInput,\n  SourceInput,\n  CameraSourceOutput,\n  VideoSourceOutput,\n  ImageSourceOutput,\n  SourceOutput,\n  FixedOutputSize,\n  MatchInputSize,\n  OutputSize,\n  SourceOptions,\n  CameraFacing,\n  CameraConstraints,\n  CameraRotation,\n  CanvasType,\n  CameraInfo,\n} from \"./types\";\n\nexport { NO_CURRENT_LENS, isCameraSource, isVideoSource, isImageSource, CameraRotationOptions } from \"./types\";\n\n// Source utilities\nexport { createCameraKitSource, DEFAULT_CAMERA_DEVICE_ID, defaultStreamResolution } from \"./internal/sourceUtils\";\nexport type { SourceApplication, TupleOf } from \"./internal/sourceUtils\";\n"]}

package/dist/cjs/internal/bootstrapUtils.d.ts

@@ -0,0 +1,13 @@
+import { CameraKit, CameraKitBootstrapConfiguration, CameraKitSession, CreateSessionOptions, PublicContainer } from "@snap/camera-kit";
+import { CameraKitLogger } from "./logging";
+export interface BootstrapResult {
+    kit: CameraKit;
+    session: CameraKitSession;
+    destroy: () => Promise<void>;
+}
+/**
+ * Bootstraps CameraKit and creates a session with proper cancellation support.
+ * Cleans up resources if the operation is aborted via the AbortSignal.
+ */
+export declare function bootstrapCameraKitWithSession(config: CameraKitBootstrapConfiguration, extendContainer: ((container: PublicContainer) => PublicContainer) | undefined, sessionOptions: CreateSessionOptions, signal: AbortSignal, log: CameraKitLogger): Promise<BootstrapResult>;
+//# sourceMappingURL=bootstrapUtils.d.ts.map

package/dist/cjs/internal/bootstrapUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapUtils.d.ts","sourceRoot":"","sources":["../../../src/internal/bootstrapUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,SAAS,EACT,+BAA+B,EAC/B,gBAAgB,EAChB,oBAAoB,EACpB,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,gBAAgB,CAAC;IAC1B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,+BAA+B,EACvC,eAAe,EAAE,CAAC,CAAC,SAAS,EAAE,eAAe,KAAK,eAAe,CAAC,GAAG,SAAS,EAC9E,cAAc,EAAE,oBAAoB,EACpC,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,eAAe,GACnB,OAAO,CAAC,eAAe,CAAC,CAwB1B"}

package/dist/cjs/internal/bootstrapUtils.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.bootstrapCameraKitWithSession = bootstrapCameraKitWithSession;
+const camera_kit_1 = require("@snap/camera-kit");
+/**
+ * Bootstraps CameraKit and creates a session with proper cancellation support.
+ * Cleans up resources if the operation is aborted via the AbortSignal.
+ */
+async function bootstrapCameraKitWithSession(config, extendContainer, sessionOptions, signal, log) {
+    // Bootstrap the CameraKit SDK
+    const kit = await (0, camera_kit_1.bootstrapCameraKit)(config, extendContainer);
+    function destroy() {
+        return kit.destroy().catch((error) => log.error("kit_destroy_failed", error));
+    }
+    // Check if aborted after bootstrap
+    if (signal.aborted) {
+        destroy();
+        signal.throwIfAborted();
+    }
+    // Create session
+    const session = await kit.createSession(sessionOptions);
+    // Check if aborted after session creation
+    if (signal.aborted) {
+        destroy();
+        signal.throwIfAborted();
+    }
+    return { kit, session, destroy };
+}
+//# sourceMappingURL=bootstrapUtils.js.map

package/dist/cjs/internal/bootstrapUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapUtils.js","sourceRoot":"","sources":["../../../src/internal/bootstrapUtils.ts"],"names":[],"mappings":";;AAoBA,sEA8BC;AAlDD,iDAO0B;AAS1B;;;GAGG;AACI,KAAK,UAAU,6BAA6B,CACjD,MAAuC,EACvC,eAA8E,EAC9E,cAAoC,EACpC,MAAmB,EACnB,GAAoB;IAEpB,8BAA8B;IAC9B,MAAM,GAAG,GAAG,MAAM,IAAA,+BAAkB,EAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAE9D,SAAS,OAAO;QACd,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,KAAK,CAAC,CAAC,CAAC;IAChF,CAAC;IAED,mCAAmC;IACnC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;QACV,MAAM,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;IAED,iBAAiB;IACjB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAExD,0CAA0C;IAC1C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;QACV,MAAM,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC","sourcesContent":["import {\n  bootstrapCameraKit,\n  CameraKit,\n  CameraKitBootstrapConfiguration,\n  CameraKitSession,\n  CreateSessionOptions,\n  PublicContainer,\n} from \"@snap/camera-kit\";\nimport { CameraKitLogger } from \"./logging\";\n\nexport interface BootstrapResult {\n  kit: CameraKit;\n  session: CameraKitSession;\n  destroy: () => Promise<void>;\n}\n\n/**\n * Bootstraps CameraKit and creates a session with proper cancellation support.\n * Cleans up resources if the operation is aborted via the AbortSignal.\n */\nexport async function bootstrapCameraKitWithSession(\n  config: CameraKitBootstrapConfiguration,\n  extendContainer: ((container: PublicContainer) => PublicContainer) | undefined,\n  sessionOptions: CreateSessionOptions,\n  signal: AbortSignal,\n  log: CameraKitLogger,\n): Promise<BootstrapResult> {\n  // Bootstrap the CameraKit SDK\n  const kit = await bootstrapCameraKit(config, extendContainer);\n\n  function destroy() {\n    return kit.destroy().catch((error) => log.error(\"kit_destroy_failed\", error));\n  }\n\n  // Check if aborted after bootstrap\n  if (signal.aborted) {\n    destroy();\n    signal.throwIfAborted();\n  }\n\n  // Create session\n  const session = await kit.createSession(sessionOptions);\n\n  // Check if aborted after session creation\n  if (signal.aborted) {\n    destroy();\n    signal.throwIfAborted();\n  }\n\n  return { kit, session, destroy };\n}\n"]}

package/dist/cjs/internal/error.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureError(error: unknown, context?: string): Error;
+//# sourceMappingURL=error.d.ts.map

package/dist/cjs/internal/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/internal/error.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CA8BnE"}

package/dist/cjs/internal/error.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureError = ensureError;
+function ensureError(error, context) {
+    if (error instanceof Error)
+        return error;
+    const contextPrefix = context ? `[${context}] ` : "";
+    try {
+        // Handle primitive types more explicitly
+        if (typeof error === "string") {
+            return new Error(`${contextPrefix}${error}`);
+        }
+        if (error === null || error === undefined) {
+            return new Error(`${contextPrefix}An unknown error occurred (${error})`);
+        }
+        // Try to extract useful info from error-like objects
+        const errorObj = error;
+        const message = errorObj.message || errorObj.error || "Unknown error";
+        const details = JSON.stringify(error, null, 2);
+        return new Error(`${contextPrefix}Non-Error exception: ${message}\nDetails: ${details}`);
+    }
+    catch (serializationError) {
+        // Provide more info about what failed
+        return new Error(`${contextPrefix}Non-Error exception thrown. ` +
+            `Type: ${typeof error}, ` +
+            `Constructor: ${error?.constructor?.name ?? "unknown"}, ` +
+            `Serialization failed: ${serializationError instanceof Error ? serializationError.message : "unknown reason"}`);
+    }
+}
+//# sourceMappingURL=error.js.map

package/dist/cjs/internal/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../../src/internal/error.ts"],"names":[],"mappings":";;AAAA,kCA8BC;AA9BD,SAAgB,WAAW,CAAC,KAAc,EAAE,OAAgB;IAC1D,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzC,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAErD,IAAI,CAAC;QACH,yCAAyC;QACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,IAAI,KAAK,CAAC,GAAG,aAAa,GAAG,KAAK,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,IAAI,KAAK,CAAC,GAAG,aAAa,8BAA8B,KAAK,GAAG,CAAC,CAAC;QAC3E,CAAC;QAED,qDAAqD;QACrD,MAAM,QAAQ,GAAG,KAAgC,CAAC;QAClD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,KAAK,IAAI,eAAe,CAAC;QACtE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAE/C,OAAO,IAAI,KAAK,CAAC,GAAG,aAAa,wBAAwB,OAAO,cAAc,OAAO,EAAE,CAAC,CAAC;IAC3F,CAAC;IAAC,OAAO,kBAAkB,EAAE,CAAC;QAC5B,sCAAsC;QACtC,OAAO,IAAI,KAAK,CACd,GAAG,aAAa,8BAA8B;YAC5C,SAAS,OAAO,KAAK,IAAI;YACzB,gBAAgB,KAAK,EAAE,WAAW,EAAE,IAAI,IAAI,SAAS,IAAI;YACzD,yBAAyB,kBAAkB,YAAY,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,gBAAgB,EAAE,CACjH,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["export function ensureError(error: unknown, context?: string): Error {\n  if (error instanceof Error) return error;\n\n  const contextPrefix = context ? `[${context}] ` : \"\";\n\n  try {\n    // Handle primitive types more explicitly\n    if (typeof error === \"string\") {\n      return new Error(`${contextPrefix}${error}`);\n    }\n\n    if (error === null || error === undefined) {\n      return new Error(`${contextPrefix}An unknown error occurred (${error})`);\n    }\n\n    // Try to extract useful info from error-like objects\n    const errorObj = error as Record<string, unknown>;\n    const message = errorObj.message || errorObj.error || \"Unknown error\";\n    const details = JSON.stringify(error, null, 2);\n\n    return new Error(`${contextPrefix}Non-Error exception: ${message}\\nDetails: ${details}`);\n  } catch (serializationError) {\n    // Provide more info about what failed\n    return new Error(\n      `${contextPrefix}Non-Error exception thrown. ` +\n        `Type: ${typeof error}, ` +\n        `Constructor: ${error?.constructor?.name ?? \"unknown\"}, ` +\n        `Serialization failed: ${serializationError instanceof Error ? serializationError.message : \"unknown reason\"}`,\n    );\n  }\n}\n"]}

package/dist/cjs/internal/isMobile.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Detects if the current device is a mobile device
+ */
+export declare function isMobile(): boolean;
+//# sourceMappingURL=isMobile.d.ts.map

package/dist/cjs/internal/isMobile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isMobile.d.ts","sourceRoot":"","sources":["../../../src/internal/isMobile.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,wBAAgB,QAAQ,IAAI,OAAO,CASlC"}

package/dist/cjs/internal/isMobile.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Detects if the current device is a mobile device
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMobile = isMobile;
+function isMobile() {
+    if (typeof navigator === "undefined" || typeof window === "undefined") {
+        return false;
+    }
+    // Check user agent for mobile indicators
+    const userAgent = navigator.userAgent || navigator.vendor || window.opera;
+    return /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(userAgent);
+}
+//# sourceMappingURL=isMobile.js.map

package/dist/cjs/internal/isMobile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isMobile.js","sourceRoot":"","sources":["../../../src/internal/isMobile.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,4BASC;AATD,SAAgB,QAAQ;IACtB,IAAI,OAAO,SAAS,KAAK,WAAW,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,yCAAyC;IACzC,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,IAAI,SAAS,CAAC,MAAM,IAAK,MAAc,CAAC,KAAK,CAAC;IAEnF,OAAO,gEAAgE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC1F,CAAC","sourcesContent":["/**\n * Detects if the current device is a mobile device\n */\n\nexport function isMobile(): boolean {\n  if (typeof navigator === \"undefined\" || typeof window === \"undefined\") {\n    return false;\n  }\n\n  // Check user agent for mobile indicators\n  const userAgent = navigator.userAgent || navigator.vendor || (window as any).opera;\n\n  return /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(userAgent);\n}\n"]}

package/dist/cjs/internal/logging.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pluggable logging interface for react-camera-kit.
+ * Vendor-neutral design allows integrating with any logging system.
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error";
+/**
+ * Logger interface that matches console.log signature.
+ * Can be implemented by any logging library.
+ * Users only need to implement the basic log methods - child logger creation is handled internally.
+ */
+export interface CameraKitLogger {
+    debug(message?: any, ...optionalParams: any[]): void;
+    info(message?: any, ...optionalParams: any[]): void;
+    warn(message?: any, ...optionalParams: any[]): void;
+    error(message?: any, ...optionalParams: any[]): void;
+}
+/**
+ * Logger interface that matches console.log signature.
+ * Can be implemented by any logging library.
+ * Users only need to implement the basic log methods - child logger creation is handled internally.
+ */
+export interface InternalLogger extends CameraKitLogger {
+    logLevel: LogLevel;
+}
+/**
+ * Creates a child logger with a namespace prefix.
+ * This is used internally to create namespaced loggers for different parts of the library.
+ */
+export declare function wrapLogger(inner: InternalLogger, namespace: string): InternalLogger;
+/**
+ * Console-based logger implementation with timestamps.
+ * Log level can be controlled via the setLevel() method or CameraKitProvider's logLevel prop.
+ */
+export declare function createConsoleLogger(): CameraKitLogger;
+/**
+ * No-op logger that discards all log messages.
+ * Useful for production environments where logging is handled externally.
+ */
+export declare function createNoopLogger(): CameraKitLogger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/cjs/internal/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/internal/logging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACrD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACpD,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACpD,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CACtD;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;IACrD,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAID;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,CA0BnF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,CAOrD;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,CAOlD"}

package/dist/cjs/internal/logging.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Pluggable logging interface for react-camera-kit.
+ * Vendor-neutral design allows integrating with any logging system.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.wrapLogger = wrapLogger;
+exports.createConsoleLogger = createConsoleLogger;
+exports.createNoopLogger = createNoopLogger;
+const noop = () => { };
+/**
+ * Creates a child logger with a namespace prefix.
+ * This is used internally to create namespaced loggers for different parts of the library.
+ */
+function wrapLogger(inner, namespace) {
+    const levelOrder = ["debug", "info", "warn", "error"];
+    const minLevelIndex = levelOrder.indexOf(inner.logLevel);
+    function shouldLog(msgLevel) {
+        return levelOrder.indexOf(msgLevel) >= minLevelIndex;
+    }
+    // Create a wrapper that prefixes messages with namespace
+    const outer = {
+        logLevel: inner.logLevel,
+        debug: shouldLog("debug")
+            ? (message, ...optionalParams) => inner.debug(`[${namespace}] ${message}`, ...optionalParams)
+            : noop,
+        info: shouldLog("info")
+            ? (message, ...optionalParams) => inner.info(`[${namespace}] ${message}`, ...optionalParams)
+            : noop,
+        warn: shouldLog("warn")
+            ? (message, ...optionalParams) => inner.warn(`[${namespace}] ${message}`, ...optionalParams)
+            : noop,
+        error: shouldLog("error")
+            ? (message, ...optionalParams) => inner.error(`[${namespace}] ${message}`, ...optionalParams)
+            : noop,
+    };
+    return outer;
+}
+/**
+ * Console-based logger implementation with timestamps.
+ * Log level can be controlled via the setLevel() method or CameraKitProvider's logLevel prop.
+ */
+function createConsoleLogger() {
+    return {
+        debug: (message, ...optionalParams) => console.debug(message, ...optionalParams),
+        info: (message, ...optionalParams) => console.info(message, ...optionalParams),
+        warn: (message, ...optionalParams) => console.warn(message, ...optionalParams),
+        error: (message, ...optionalParams) => console.error(message, ...optionalParams),
+    };
+}
+/**
+ * No-op logger that discards all log messages.
+ * Useful for production environments where logging is handled externally.
+ */
+function createNoopLogger() {
+    return {
+        debug: noop,
+        info: noop,
+        warn: noop,
+        error: noop,
+    };
+}
+//# sourceMappingURL=logging.js.map

package/dist/cjs/internal/logging.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/internal/logging.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA+BH,gCA0BC;AAMD,kDAOC;AAMD,4CAOC;AA1DD,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;AAEtB;;;GAGG;AACH,SAAgB,UAAU,CAAC,KAAqB,EAAE,SAAiB;IACjE,MAAM,UAAU,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAClE,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAEzD,SAAS,SAAS,CAAC,QAAkB;QACnC,OAAO,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC;IACvD,CAAC;IAED,yDAAyD;IACzD,MAAM,KAAK,GAAmB;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;YACvB,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC;YAC7F,CAAC,CAAC,IAAI;QACR,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;YACrB,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC;YAC5F,CAAC,CAAC,IAAI;QACR,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC;YACrB,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC;YAC5F,CAAC,CAAC,IAAI;QACR,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC;YACvB,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,KAAK,OAAO,EAAE,EAAE,GAAG,cAAc,CAAC;YAC7F,CAAC,CAAC,IAAI;KACT,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;QAChF,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;QAC9E,IAAI,EAAE,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;QAC9E,KAAK,EAAE,CAAC,OAAO,EAAE,GAAG,cAAc,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,cAAc,CAAC;KACjF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB;IAC9B,OAAO;QACL,KAAK,EAAE,IAAI;QACX,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Pluggable logging interface for react-camera-kit.\n * Vendor-neutral design allows integrating with any logging system.\n */\n\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\n\n/**\n * Logger interface that matches console.log signature.\n * Can be implemented by any logging library.\n * Users only need to implement the basic log methods - child logger creation is handled internally.\n */\nexport interface CameraKitLogger {\n  debug(message?: any, ...optionalParams: any[]): void;\n  info(message?: any, ...optionalParams: any[]): void;\n  warn(message?: any, ...optionalParams: any[]): void;\n  error(message?: any, ...optionalParams: any[]): void;\n}\n\n/**\n * Logger interface that matches console.log signature.\n * Can be implemented by any logging library.\n * Users only need to implement the basic log methods - child logger creation is handled internally.\n */\nexport interface InternalLogger extends CameraKitLogger {\n  logLevel: LogLevel;\n}\n\nconst noop = () => {};\n\n/**\n * Creates a child logger with a namespace prefix.\n * This is used internally to create namespaced loggers for different parts of the library.\n */\nexport function wrapLogger(inner: InternalLogger, namespace: string): InternalLogger {\n  const levelOrder: LogLevel[] = [\"debug\", \"info\", \"warn\", \"error\"];\n  const minLevelIndex = levelOrder.indexOf(inner.logLevel);\n\n  function shouldLog(msgLevel: LogLevel): boolean {\n    return levelOrder.indexOf(msgLevel) >= minLevelIndex;\n  }\n\n  // Create a wrapper that prefixes messages with namespace\n  const outer: InternalLogger = {\n    logLevel: inner.logLevel,\n    debug: shouldLog(\"debug\")\n      ? (message, ...optionalParams) => inner.debug(`[${namespace}] ${message}`, ...optionalParams)\n      : noop,\n    info: shouldLog(\"info\")\n      ? (message, ...optionalParams) => inner.info(`[${namespace}] ${message}`, ...optionalParams)\n      : noop,\n    warn: shouldLog(\"warn\")\n      ? (message, ...optionalParams) => inner.warn(`[${namespace}] ${message}`, ...optionalParams)\n      : noop,\n    error: shouldLog(\"error\")\n      ? (message, ...optionalParams) => inner.error(`[${namespace}] ${message}`, ...optionalParams)\n      : noop,\n  };\n\n  return outer;\n}\n\n/**\n * Console-based logger implementation with timestamps.\n * Log level can be controlled via the setLevel() method or CameraKitProvider's logLevel prop.\n */\nexport function createConsoleLogger(): CameraKitLogger {\n  return {\n    debug: (message, ...optionalParams) => console.debug(message, ...optionalParams),\n    info: (message, ...optionalParams) => console.info(message, ...optionalParams),\n    warn: (message, ...optionalParams) => console.warn(message, ...optionalParams),\n    error: (message, ...optionalParams) => console.error(message, ...optionalParams),\n  };\n}\n\n/**\n * No-op logger that discards all log messages.\n * Useful for production environments where logging is handled externally.\n */\nexport function createNoopLogger(): CameraKitLogger {\n  return {\n    debug: noop,\n    info: noop,\n    warn: noop,\n    error: noop,\n  };\n}\n"]}

package/dist/cjs/internal/metrics.d.ts

@@ -0,0 +1,29 @@
+import { Metric, PublicContainer } from "@snap/camera-kit";
+import { Subject } from "rxjs";
+export type MetricsReporter = ReturnType<typeof createMetricsReporter>;
+/**
+ * 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.
+ */
+declare function createMetricsReporter(subject: Subject<Metric>): {
+    reportCount(name: string): void;
+};
+/** Global metrics reporter — safe to call at any point; events are buffered until the DI wiring is established. */
+export declare const metricsReporter: {
+    reportCount(name: string): void;
+};
+/**
+ * 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 declare function extendContainerWithMetrics(userExtendContainer?: (container: PublicContainer) => PublicContainer): (container: PublicContainer) => PublicContainer;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/cjs/internal/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/internal/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAE,eAAe,EAAgC,MAAM,kBAAkB,CAAC;AAEhG,OAAO,EAAc,OAAO,EAAgB,MAAM,MAAM,CAAC;AAuCzD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvE;;;;GAIG;AACH,iBAAS,qBAAqB,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC;sBAEjC,MAAM;EAQ3B;AAED,mHAAmH;AACnH,eAAO,MAAM,eAAe;sBAXN,MAAM;CAWwC,CAAC;AAErE;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,mBAAmB,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,KAAK,eAAe,GACpE,CAAC,SAAS,EAAE,eAAe,KAAK,eAAe,CAqBjD"}