@reactvision/react-viro 2.53.1 → 2.55.0

package/dist/components/Studio/types.d.ts

@@ -0,0 +1,149 @@
+export interface StudioSceneCreatedBy {
+    id: string;
+    first_name: string | null;
+    last_name: string | null;
+}
+export interface StudioSceneMeta {
+    id: string;
+    name: string | null;
+    belongs_to_project: string;
+    plane_detection: string | null;
+    plane_direction: string | null;
+    on_load_function: string | null;
+    physics_world_config: Record<string, unknown> | null;
+    created_at: string;
+    created_by: StudioSceneCreatedBy | null;
+}
+export interface StudioProjectMeta {
+    id: string;
+    occlusion_mode: "NONE" | "PEOPLEONLY" | "DEPTHBASED";
+}
+export interface StudioSceneFunction {
+    id: string;
+    scene: string;
+    function_type: "NAVIGATION" | "ALERT" | "ANIMATION";
+    navigation: string | null;
+    alert: string | null;
+    animation: string | null;
+    scene_navigation: {
+        id: string;
+        navigate_to: string;
+    } | null;
+    scene_alert: {
+        id: string;
+        alert_title: string | null;
+        alert_message: string | null;
+    } | null;
+    scene_animation: {
+        id: string;
+        animation_key: string;
+        duration_ms: number | null;
+        delay_ms: number | null;
+        properties: Record<string, unknown>;
+    } | null;
+}
+export interface StudioAsset {
+    id: string;
+    name: string | null;
+    description: string | null;
+    file_url: string | null;
+    file_size: number | null;
+    asset_type_name: "3D-MODEL" | "TEXT" | "IMAGE" | "VIDEO" | null;
+    position_x: number | null;
+    position_y: number | null;
+    position_z: number | null;
+    rotation_x: number | null;
+    rotation_y: number | null;
+    rotation_z: number | null;
+    scale: number | null;
+    latitude: number | null;
+    longitude: number | null;
+    is_draggable: boolean;
+    trigger_image_url: string | null;
+    trigger_image_orientation: "Up" | "Down" | "Left" | "Right" | null;
+    trigger_image_physical_width_m: number | null;
+    material_config: Record<string, unknown> | null;
+    physics_config: Record<string, unknown> | null;
+    on_click_function: string | null;
+    asset_id: string | null;
+    created_at: string;
+    updated_at: string;
+    scene_function: StudioSceneFunction | null;
+}
+export interface StudioCollisionBinding {
+    id: string;
+    scene_id: string;
+    function_id: string;
+    asset_x_id: string;
+    asset_y_id: string;
+    scene_function: StudioSceneFunction;
+}
+export interface StudioAnimation {
+    id: string;
+    scene_id: string;
+    target_asset_id: string;
+    animation_key: string;
+    properties: Record<string, unknown>;
+    duration_ms: number | null;
+    delay_ms: number | null;
+    easing: "Linear" | "EaseIn" | "EaseOut" | "EaseInEaseOut" | "Bounce" | null;
+    loop: boolean;
+    interruptible: boolean;
+    on_start_function: string | null;
+    on_finish_function: string | null;
+}
+export interface StudioProjectAsset {
+    id: string;
+    name: string | null;
+    url: string | null;
+}
+export interface StudioProjectSceneSummary {
+    id: string;
+    name: string | null;
+    created_at: string;
+    created_by: StudioSceneCreatedBy | null;
+    assets: StudioProjectAsset[];
+}
+export interface StudioProjectOpeningScene {
+    id: string;
+    name: string | null;
+}
+export interface StudioProjectOverview {
+    id: string;
+    name: string;
+    thumbnail: string | null;
+    occlusion_mode: "NONE" | "PEOPLEONLY" | "DEPTHBASED";
+    created_at: string;
+    created_by: StudioSceneCreatedBy | null;
+    opening_scene: StudioProjectOpeningScene | null;
+    scenes: StudioProjectSceneSummary[];
+}
+/** Top-level response from GET /functions/v1/projects/{project_id} (after JSON.parse) */
+export interface StudioProjectApiResponse {
+    project: StudioProjectOverview;
+    meta: {
+        request_id: string;
+    };
+}
+/** Top-level response from GET /functions/v1/scenes/{scene_id} (after JSON.parse) */
+export interface StudioSceneResponse {
+    scene: StudioSceneMeta;
+    project: StudioProjectMeta;
+    assets: StudioAsset[];
+    collision_bindings: StudioCollisionBinding[];
+    animations: StudioAnimation[];
+    functions: StudioSceneFunction[];
+    meta: {
+        request_id: string;
+    };
+}
+/** Viro animation prop shape passed to Viro components */
+export type ViroAnimationProp = {
+    name: string;
+    run: boolean;
+    loop: boolean;
+    interruptible: boolean;
+    delay: number;
+    onStart?: () => void;
+    onFinish?: () => void;
+};

package/dist/components/Studio/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Types mirror the actual server response from GET /functions/v1/scenes/{scene_id}.
+// Field names are snake_case as returned by the Supabase Edge Function / Postgres RPC.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/components/Types/ViroEvents.d.ts

@@ -100,7 +100,8 @@ export type ViroPlatformInfo = {
 };
 export declare enum ViroPlatformTypes {
     GVR = "gvr",
-    GEAR_VR = "ovr-mobile"
+    GEAR_VR = "ovr-mobile",
+    QUEST = "quest"
 }
 export declare enum ViroHeadsetTypes {
     CARDBOARD = "cardboard",
@@ -135,6 +136,53 @@ export type ViroExitViroEvent = {};
 export type ViroErrorEvent = {
     error: Error;
 };
+/** ===========================================================================
+ * Quest / OpenXR Hand Tracking Types (M4)
+ * ============================================================================ */
+export type ViroJoint = {
+    position: Viro3DPoint;
+    /** Sphere radius representing finger pad size (meters). */
+    radius: number;
+};
+export type ViroHandJoints = {
+    wrist: ViroJoint;
+    thumbMetacarpal: ViroJoint;
+    thumbProximal: ViroJoint;
+    thumbDistal: ViroJoint;
+    thumbTip: ViroJoint;
+    indexMetacarpal: ViroJoint;
+    indexProximal: ViroJoint;
+    indexIntermediate: ViroJoint;
+    indexDistal: ViroJoint;
+    indexTip: ViroJoint;
+    middleMetacarpal: ViroJoint;
+    middleProximal: ViroJoint;
+    middleIntermediate: ViroJoint;
+    middleDistal: ViroJoint;
+    middleTip: ViroJoint;
+    ringMetacarpal: ViroJoint;
+    ringProximal: ViroJoint;
+    ringIntermediate: ViroJoint;
+    ringDistal: ViroJoint;
+    ringTip: ViroJoint;
+    littleMetacarpal: ViroJoint;
+    littleProximal: ViroJoint;
+    littleIntermediate: ViroJoint;
+    littleDistal: ViroJoint;
+    littleTip: ViroJoint;
+};
+export type ViroHandPinchEvent = {
+    hand: "left" | "right";
+    /** World-space position of the pinch point (midpoint between thumb tip and index tip). */
+    position: Viro3DPoint;
+    /** Pinch strength [0..1] from XR_FB_hand_tracking_aim, or 1.0 on pinch-complete fallback. */
+    pinchStrength: number;
+};
+/** Per-frame skeletal hand data dispatched via onHandUpdate. null when hand is not tracked. */
+export type ViroHandUpdateEvent = {
+    left: ViroHandJoints | null;
+    right: ViroHandJoints | null;
+};
 /** ===========================================================================
  * Viro Animation Events
  * ============================================================================ */

package/dist/components/Types/ViroEvents.js

@@ -35,6 +35,7 @@ var ViroPlatformTypes;
 (function (ViroPlatformTypes) {
     ViroPlatformTypes["GVR"] = "gvr";
     ViroPlatformTypes["GEAR_VR"] = "ovr-mobile";
+    ViroPlatformTypes["QUEST"] = "quest";
 })(ViroPlatformTypes || (exports.ViroPlatformTypes = ViroPlatformTypes = {}));
 var ViroHeadsetTypes;
 (function (ViroHeadsetTypes) {

package/dist/components/Utilities/VRModuleOpenXR.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Finishes VRActivity and returns the user to the panel (MainActivity).
+ * Safe to call on any platform — no-op when VRLauncher is unavailable.
+ */
+export declare function exitVRScene(): void;
+export type VRModuleOpenXRType = {
+    recenterTracking?: (viewTag: number) => void;
+    setPassthroughEnabled?: (viewTag: number, enabled: boolean) => void;
+};
+/**
+ * Typed reference to the VRModuleOpenXR native module.
+ * undefined when not running on Meta Quest (no-op calls are safe via optional chaining).
+ */
+export declare const VRModuleOpenXR: VRModuleOpenXRType | undefined;
+/**
+ * Returns the live viewTag of the ViroVRSceneNavigator running in VRActivity,
+ * kept in sync via VRQuestNavigatorBridge.  null until ViroQuestEntryPoint has
+ * mounted and published the tag.
+ *
+ * Use this inside VR scenes when you need to call VRModuleOpenXR methods:
+ *
+ * ```tsx
+ * function MyVRScene() {
+ *   const viewTag = useVRViewTag();
+ *   const recenter = () => {
+ *     if (viewTag != null) VRModuleOpenXR?.recenterTracking?.(viewTag);
+ *   };
+ *   return <ViroScene>...</ViroScene>;
+ * }
+ * ```
+ */
+export declare function useVRViewTag(): number | null;

package/dist/components/Utilities/VRModuleOpenXR.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VRModuleOpenXR = void 0;
+exports.exitVRScene = exitVRScene;
+exports.useVRViewTag = useVRViewTag;
+const react_1 = require("react");
+const react_native_1 = require("react-native");
+const VRQuestNavigatorBridge_1 = require("./VRQuestNavigatorBridge");
+/**
+ * Finishes VRActivity and returns the user to the panel (MainActivity).
+ * Safe to call on any platform — no-op when VRLauncher is unavailable.
+ */
+function exitVRScene() {
+    VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.setVRActive(false);
+    react_native_1.NativeModules.VRLauncher
+        ?.exitVRScene?.();
+}
+/**
+ * Typed reference to the VRModuleOpenXR native module.
+ * undefined when not running on Meta Quest (no-op calls are safe via optional chaining).
+ */
+exports.VRModuleOpenXR = react_native_1.NativeModules.VRModuleOpenXR ?? undefined;
+/**
+ * Returns the live viewTag of the ViroVRSceneNavigator running in VRActivity,
+ * kept in sync via VRQuestNavigatorBridge.  null until ViroQuestEntryPoint has
+ * mounted and published the tag.
+ *
+ * Use this inside VR scenes when you need to call VRModuleOpenXR methods:
+ *
+ * ```tsx
+ * function MyVRScene() {
+ *   const viewTag = useVRViewTag();
+ *   const recenter = () => {
+ *     if (viewTag != null) VRModuleOpenXR?.recenterTracking?.(viewTag);
+ *   };
+ *   return <ViroScene>...</ViroScene>;
+ * }
+ * ```
+ */
+function useVRViewTag() {
+    const [tag, setTag] = (0, react_1.useState)(() => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.getViewTag());
+    (0, react_1.useEffect)(() => VRQuestNavigatorBridge_1.VRQuestNavigatorBridge.onViewTag(setTag), []);
+    return tag;
+}

package/dist/components/Utilities/VRQuestNavigatorBridge.d.ts

@@ -0,0 +1,85 @@
+/**
+ * VRQuestNavigatorBridge
+ *
+ * Carries VR "intents" and navigator operations from panel-Activity component
+ * trees to VRActivity. Both activities run in the same process and share the
+ * same Hermes JS engine, so a module-level store is sufficient — no native
+ * round-trip needed.
+ *
+ * Flow:
+ *   Panel (MainActivity)
+ *     ViroXRSceneNavigator mounts
+ *       → setIntent(scene, config)  — stores intent, notifies ViroQuestEntryPoint
+ *       → launchVRScene()           — OS switches to VRActivity
+ *       → ref.push(StudioScene)     — dispatchOp() queues the op
+ *
+ *   VRActivity mounts VRQuestScene → ViroQuestEntryPoint
+ *       → onIntent cb fires      — reads intentKey + initialScene + rendererConfig
+ *       → renders ViroVRSceneNavigator key={intentKey}  (fresh mount per intent)
+ *       → ViroQuestEntryPoint captures viewTag → setViewTag()
+ *       → subscribeOps() drains queued ops  — push(StudioScene) arrives
+ *
+ * Each call to setIntent() generates a new intentKey.  ViroQuestEntryPoint
+ * uses key={intentKey} on ViroVRSceneNavigator, guaranteeing a clean navigator
+ * stack whenever a different panel screen activates VR.
+ */
+export type VRNavigatorOp = {
+    type: "push";
+    scene: any;
+} | {
+    type: "pop";
+} | {
+    type: "popN";
+    n: number;
+} | {
+    type: "replace";
+    scene: any;
+} | {
+    type: "jump";
+    scene: any;
+};
+/** Renderer flags forwarded from ViroXRSceneNavigator to ViroVRSceneNavigator. */
+export type VRQuestRendererConfig = {
+    hdrEnabled?: boolean;
+    pbrEnabled?: boolean;
+    bloomEnabled?: boolean;
+    shadowsEnabled?: boolean;
+    multisamplingEnabled?: boolean;
+    vrModeEnabled?: boolean;
+    passthroughEnabled?: boolean;
+    handTrackingEnabled?: boolean;
+    debug?: boolean;
+    onExitViro?: () => void;
+};
+export type VRQuestIntent = {
+    intentKey: string;
+    initialScene: any;
+    rendererConfig?: VRQuestRendererConfig;
+};
+export declare const VRQuestNavigatorBridge: {
+    /**
+     * Record the scene and renderer config that VRActivity should use, and
+     * return a unique intent key. Call launchVRScene() after this.
+     */
+    setIntent(initialScene: any, rendererConfig?: VRQuestRendererConfig): string;
+    /** Current intent (may be null if VR has never been launched). */
+    getIntent(): VRQuestIntent | null;
+    /**
+     * Subscribe to intent changes. Fires immediately with the current intent if
+     * one exists so that ViroQuestEntryPoint can render even if it mounts after
+     * setIntent() was called.
+     */
+    onIntent(cb: (intent: VRQuestIntent) => void): () => void;
+    dispatchOp(op: VRNavigatorOp): void;
+    subscribeOps(cb: (op: VRNavigatorOp) => void): () => void;
+    setVRActive(active: boolean): void;
+    isVRActive(): boolean;
+    setViewTag(tag: number | null): void;
+    getViewTag(): number | null;
+    /**
+     * Subscribe to viewTag changes. Fires immediately with the current value.
+     * Use this inside VR scenes that need VRModuleOpenXR (recenterTracking,
+     * setPassthroughEnabled) without a direct ref to ViroVRSceneNavigator.
+     */
+    onViewTag(cb: (tag: number | null) => void): () => void;
+};

package/dist/components/Utilities/VRQuestNavigatorBridge.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * VRQuestNavigatorBridge
+ *
+ * Carries VR "intents" and navigator operations from panel-Activity component
+ * trees to VRActivity. Both activities run in the same process and share the
+ * same Hermes JS engine, so a module-level store is sufficient — no native
+ * round-trip needed.
+ *
+ * Flow:
+ *   Panel (MainActivity)
+ *     ViroXRSceneNavigator mounts
+ *       → setIntent(scene, config)  — stores intent, notifies ViroQuestEntryPoint
+ *       → launchVRScene()           — OS switches to VRActivity
+ *       → ref.push(StudioScene)     — dispatchOp() queues the op
+ *
+ *   VRActivity mounts VRQuestScene → ViroQuestEntryPoint
+ *       → onIntent cb fires      — reads intentKey + initialScene + rendererConfig
+ *       → renders ViroVRSceneNavigator key={intentKey}  (fresh mount per intent)
+ *       → ViroQuestEntryPoint captures viewTag → setViewTag()
+ *       → subscribeOps() drains queued ops  — push(StudioScene) arrives
+ *
+ * Each call to setIntent() generates a new intentKey.  ViroQuestEntryPoint
+ * uses key={intentKey} on ViroVRSceneNavigator, guaranteeing a clean navigator
+ * stack whenever a different panel screen activates VR.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VRQuestNavigatorBridge = void 0;
+// ── Intent store ────────────────────────────────────────────────────────────
+let _intent = null;
+const _intentListeners = new Set();
+// ── Op queue ─────────────────────────────────────────────────────────────────
+const _opListeners = new Set();
+const _opQueue = [];
+let _opCounter = 0;
+// ── VR active flag ────────────────────────────────────────────────────────────
+// True while VRActivity is running. Set to true just before launchVRScene(),
+// set to false by exitVRScene(). The AppState-based relaunch in
+// ViroXRSceneNavigator checks this so it only fires for system-level
+// backgrounding (Quest menu / home), not for explicit exits.
+let _vrActive = false;
+// ── ViewTag store ─────────────────────────────────────────────────────────────
+// ViroQuestEntryPoint populates this after ViroVRSceneNavigator mounts.
+// Panel-side code (e.g. VRModuleOpenXR.recenterTracking) reads it to target
+// the live native view without needing a direct ref to ViroVRSceneNavigator.
+let _viewTag = null;
+const _viewTagListeners = new Set();
+exports.VRQuestNavigatorBridge = {
+    // ── Called by ViroXRSceneNavigator when mounting on Quest ──────────────────
+    /**
+     * Record the scene and renderer config that VRActivity should use, and
+     * return a unique intent key. Call launchVRScene() after this.
+     */
+    setIntent(initialScene, rendererConfig) {
+        const intentKey = `vr-${Date.now()}-${++_opCounter}`;
+        _intent = { intentKey, initialScene, rendererConfig };
+        // Clear any stale ops from the previous intent.
+        _opQueue.length = 0;
+        _intentListeners.forEach((l) => l(_intent));
+        return intentKey;
+    },
+    /** Current intent (may be null if VR has never been launched). */
+    getIntent() {
+        return _intent;
+    },
+    /**
+     * Subscribe to intent changes. Fires immediately with the current intent if
+     * one exists so that ViroQuestEntryPoint can render even if it mounts after
+     * setIntent() was called.
+     */
+    onIntent(cb) {
+        _intentListeners.add(cb);
+        if (_intent)
+            cb(_intent);
+        return () => {
+            _intentListeners.delete(cb);
+        };
+    },
+    // ── Called by ViroXRSceneNavigator ref (push / pop / etc.) ────────────────
+    dispatchOp(op) {
+        if (_opListeners.size > 0) {
+            _opListeners.forEach((l) => l(op));
+        }
+        else {
+            _opQueue.push(op);
+        }
+    },
+    // ── Called by ViroQuestEntryPoint after ViroVRSceneNavigator mounts ────────
+    subscribeOps(cb) {
+        _opListeners.add(cb);
+        const pending = _opQueue.splice(0);
+        pending.forEach((op) => cb(op));
+        return () => {
+            _opListeners.delete(cb);
+        };
+    },
+    // ── VR active flag ────────────────────────────────────────────────────────
+    setVRActive(active) {
+        _vrActive = active;
+    },
+    isVRActive() {
+        return _vrActive;
+    },
+    // ── ViewTag — native node handle of the live ViroVRSceneNavigator ──────────
+    setViewTag(tag) {
+        _viewTag = tag;
+        _viewTagListeners.forEach((l) => l(tag));
+    },
+    getViewTag() {
+        return _viewTag;
+    },
+    /**
+     * Subscribe to viewTag changes. Fires immediately with the current value.
+     * Use this inside VR scenes that need VRModuleOpenXR (recenterTracking,
+     * setPassthroughEnabled) without a direct ref to ViroVRSceneNavigator.
+     */
+    onViewTag(cb) {
+        _viewTagListeners.add(cb);
+        cb(_viewTag);
+        return () => {
+            _viewTagListeners.delete(cb);
+        };
+    },
+};

package/dist/components/Utilities/ViroPlatform.d.ts

@@ -0,0 +1,10 @@
+export declare const isQuest: boolean;
+/**
+ * True when this app build includes the OpenXR VR native module (i.e. the
+ * Quest variant of react-viro is registered in `MainApplication`). Does NOT
+ * imply the current device is a Quest — for that, use `isQuest`.
+ *
+ * Useful when you need to decide whether `ViroVRSceneNavigator` *could* render
+ * if you forced VR mode (e.g., for in-app build diagnostics).
+ */
+export declare const hasOpenXRSupport: boolean;

package/dist/components/Utilities/ViroPlatform.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasOpenXRSupport = exports.isQuest = void 0;
+const react_native_1 = require("react-native");
+/**
+ * True only on actual Meta Quest hardware (Quest 1/2/Pro/3/3S).
+ *
+ * Detection is based on `Platform.constants` (Android `Build.MANUFACTURER`,
+ * `BRAND`, `MODEL`) — NOT on the presence of `NativeModules.VRModuleOpenXR`.
+ * The OpenXR module ships with any app built against the Quest variant of
+ * react-viro and is therefore present on regular Android phones too when the
+ * same APK targets both phone and Quest. Branding strings are the
+ * authoritative signal for "is the user wearing a Quest right now".
+ *
+ * Quest 1/2/Pro:  Manufacturer="Oculus", Brand="oculus"
+ * Quest 3/3S:     Manufacturer="Meta",   Brand="meta"
+ */
+function detectQuest() {
+    if (react_native_1.Platform.OS !== "android")
+        return false;
+    const c = (react_native_1.Platform.constants ?? {});
+    const manufacturer = (c.Manufacturer ?? "").toLowerCase();
+    const brand = (c.Brand ?? "").toLowerCase();
+    const model = (c.Model ?? "").toLowerCase();
+    if (manufacturer === "oculus" ||
+        manufacturer === "meta" ||
+        brand === "oculus" ||
+        brand === "meta") {
+        return true;
+    }
+    // Defensive: future hardware shipping under new manufacturer strings.
+    return /\bquest\b/.test(model);
+}
+exports.isQuest = detectQuest();
+/**
+ * True when this app build includes the OpenXR VR native module (i.e. the
+ * Quest variant of react-viro is registered in `MainApplication`). Does NOT
+ * imply the current device is a Quest — for that, use `isQuest`.
+ *
+ * Useful when you need to decide whether `ViroVRSceneNavigator` *could* render
+ * if you forced VR mode (e.g., for in-app build diagnostics).
+ */
+exports.hasOpenXRSupport = react_native_1.NativeModules.VRModuleOpenXR !== undefined;

package/dist/components/Utilities/ViroUtils.d.ts

@@ -49,6 +49,25 @@ export declare function latLngToMercator(lat: number, lng: number): [number, num
  * @returns [arX, arY, arZ] position in metres relative to the device
  */
 export declare function gpsToArWorld(devicePose: ViroGeospatialPose, anchorLat: number, anchorLng: number, anchorAlt: number): [number, number, number];
+export type ViroPermission = "camera" | "microphone" | "storage" | "location";
+export interface ViroPermissionsResult {
+    camera?: boolean;
+    microphone?: boolean;
+    storage?: boolean;
+    location?: boolean;
+}
+/**
+ * Request the specified permissions required for Viro AR to function.
+ * Omit `permissions` to request all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+export declare function requestRequiredPermissions(permissions?: ViroPermission[]): Promise<ViroPermissionsResult>;
+/**
+ * Check the current status of the specified permissions without prompting the user.
+ * Omit `permissions` to check all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+export declare function checkPermissions(permissions?: ViroPermission[]): Promise<ViroPermissionsResult>;
 export interface ViroiOSArSupportResponse {
     isARSupported: boolean;
 }

package/dist/components/Utilities/ViroUtils.js

@@ -14,6 +14,8 @@ exports.polarToCartesian = polarToCartesian;
 exports.polarToCartesianActual = polarToCartesianActual;
 exports.latLngToMercator = latLngToMercator;
 exports.gpsToArWorld = gpsToArWorld;
+exports.requestRequiredPermissions = requestRequiredPermissions;
+exports.checkPermissions = checkPermissions;
 exports.isARSupportedOnDevice = isARSupportedOnDevice;
 /**
  * Convert the given polar coords of the form [r, theta, phi] to cartesian
@@ -113,6 +115,38 @@ function gpsToArWorld(devicePose, anchorLat, anchorLng, anchorAlt) {
         -distance * Math.cos(relBearing), // arZ
     ];
 }
+const ALL_PERMISSIONS = [
+    "camera",
+    "microphone",
+    "storage",
+    "location",
+];
+/**
+ * Request the specified permissions required for Viro AR to function.
+ * Omit `permissions` to request all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+function requestRequiredPermissions(permissions = ALL_PERMISSIONS) {
+    if (react_native_1.Platform.OS === "ios") {
+        return react_native_1.NativeModules.VRTARUtils.requestRequiredPermissions(permissions);
+    }
+    else {
+        return react_native_1.NativeModules.VRTARSceneNavigatorModule.requestRequiredPermissions(permissions);
+    }
+}
+/**
+ * Check the current status of the specified permissions without prompting the user.
+ * Omit `permissions` to check all four (camera, microphone, storage, location).
+ * Only the requested keys are present in the resolved result.
+ */
+function checkPermissions(permissions = ALL_PERMISSIONS) {
+    if (react_native_1.Platform.OS === "ios") {
+        return react_native_1.NativeModules.VRTARUtils.checkPermissions(permissions);
+    }
+    else {
+        return react_native_1.NativeModules.VRTARSceneNavigatorModule.checkPermissions(permissions);
+    }
+}
 function isARSupportedOnDevice() {
     return new Promise((resolve, reject) => {
         if (react_native_1.Platform.OS == "ios") {

package/dist/components/Utilities/ViroVersion.d.ts

@@ -1 +1 @@
-export declare const VIRO_VERSION = "2.53.1";
+export declare const VIRO_VERSION = "2.55.0";

package/dist/components/Utilities/ViroVersion.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VIRO_VERSION = void 0;
-exports.VIRO_VERSION = "2.53.1";
+exports.VIRO_VERSION = "2.55.0";