expo-rotation-module 0.1.0

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "expo-rotation-module",
+  "version": "0.1.0",
+  "description": "Screen Orientation Native Module",
+  "main": "index.js",
+  "types": "src/index.d.ts",
+  "scripts": {
+    "build": "expo-module build",
+    "clean": "expo-module clean",
+    "lint": "expo-module lint",
+    "test": "expo-module test",
+    "prepare": "expo-module prepare",
+    "prepublishOnly": "expo-module prepublishOnly",
+    "expo-module": "expo-module",
+    "open:ios": "xed example/ios",
+    "open:android": "open -a \"Android Studio\" example/android"
+  },
+  "keywords": [
+    "react-native",
+    "expo",
+    "expo-rotation-module",
+    "ExpoRotationModule"
+  ],
+  "repository": "https://github.com/Ktsierra/expo-rotation-module",
+  "expo": {
+    "plugin": "./plugin/index.js"
+  },
+  "bugs": {
+    "url": "https://github.com/Ktsierra/expo-rotation-module/issues"
+  },
+  "author": "Ktsierra <josejaviersierra1998@gmail.com> (https://github.com/Ktsierra)",
+  "license": "MIT",
+  "homepage": "https://github.com/Ktsierra/expo-rotation-module#readme",
+  "dependencies": {
+    "@expo/npm-proofread": "^1.0.1"
+  },
+  "devDependencies": {
+    "@types/react": "~19.1.0",
+    "expo": "^54.0.27",
+    "expo-module-scripts": "^5.0.8",
+    "react-native": "0.81.5"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  }
+}

package/plugin/index.js

@@ -0,0 +1,33 @@
+let withAndroidManifest;
+try {
+  // Prefer the project's installed config-plugins so resolution works from the app
+  withAndroidManifest = require(process.cwd() + '/node_modules/@expo/config-plugins').withAndroidManifest;
+} catch (e) {
+  // Fallback to resolving from this package (useful for local dev)
+  withAndroidManifest = require('@expo/config-plugins').withAndroidManifest;
+}
+
+function addWriteSettingsPermission(androidManifest) {
+  const usesPermissions = androidManifest.manifest['uses-permission'] || [];
+  const exists = usesPermissions.some(
+    (p) => p.$['android:name'] === 'android.permission.WRITE_SETTINGS'
+  );
+  if (!exists) {
+    usesPermissions.push({
+      $: {
+        'android:name': 'android.permission.WRITE_SETTINGS',
+      },
+    });
+    androidManifest.manifest['uses-permission'] = usesPermissions;
+  }
+  return androidManifest;
+}
+
+module.exports = function withWriteSettingsPermission(config) {
+  return withAndroidManifest(config, (config) => {
+    config.modResults = addWriteSettingsPermission(config.modResults);
+    return config;
+  });
+};
+
+module.exports.plugin = module.exports;

package/src/ExpoRotationModule.ts

@@ -0,0 +1,86 @@
+import { NativeModule, requireNativeModule } from 'expo';
+import { Platform } from 'react-native';
+
+import { ExpoRotationModuleEvents } from './ExpoRotationModule.types';
+
+export type RotationState = 'AUTOROTATE' | 'PORTRAIT' | 'LANDSCAPE';
+
+declare class ExpoRotationModule extends NativeModule<ExpoRotationModuleEvents> {
+  canWrite(): Promise<boolean>;
+  requestWritePermission(): void;
+  getRotationState(): Promise<RotationState>;
+  setRotationState(state: RotationState): Promise<void>;
+  getPackageName(): Promise<string>;
+}
+
+// This call loads the native module object from the JSI on native platforms.
+const isAndroid = Platform.OS === 'android';
+const nativeModule = isAndroid ? requireNativeModule<ExpoRotationModule>('ExpoRotationModule') : null;
+
+export async function canWrite(): Promise<boolean> {
+  if (!isAndroid || !nativeModule || !nativeModule.canWrite) return false;
+  try {
+    return await nativeModule.canWrite();
+  } catch (e: any) {
+    throw normalizeError(e);
+  }
+}
+
+export function requestWritePermission(): void {
+  if (!isAndroid || !nativeModule || !nativeModule.requestWritePermission) return;
+  try {
+    nativeModule.requestWritePermission();
+  } catch (e: any) {
+    throw normalizeError(e);
+  }
+}
+
+export async function getPackageName(): Promise<string> {
+  if (!isAndroid || !nativeModule || !nativeModule.getPackageName) return '';
+  try {
+    return await nativeModule.getPackageName();
+  } catch (e: any) {
+    throw normalizeError(e);
+  }
+}
+
+export async function getRotationState(): Promise<RotationState> {
+  if (!isAndroid || !nativeModule || !nativeModule.getRotationState) return 'AUTOROTATE';
+  try {
+    return await nativeModule.getRotationState();
+  } catch (e: any) {
+    throw normalizeError(e);
+  }
+}
+
+function normalizeError(e: any): Error & { code?: string } {
+  const err = new Error(e?.message || String(e));
+  // Try to extract code from messages like "E_PERMISSION: ..."
+  const m = (e?.message || '').match(/^([A-Z_]+):\s*(.*)$/);
+  if (m) {
+    (err as any).code = m[1];
+    err.message = m[2] || err.message;
+  }
+  return err as Error & { code?: string };
+}
+
+export async function setRotationState(state: RotationState): Promise<void> {
+  if (!isAndroid || !nativeModule || !nativeModule.setRotationState) {
+    const err = new Error('Rotation native module not available') as Error & { code?: string };
+    err.code = 'E_NO_MODULE';
+    throw err;
+  }
+  try {
+    return await nativeModule.setRotationState(state);
+  } catch (e: any) {
+    throw normalizeError(e);
+  }
+}
+
+export default {
+  canWrite,
+  requestWritePermission,
+  getRotationState,
+  setRotationState,
+  getPackageName,
+};

package/src/ExpoRotationModule.types.ts

@@ -0,0 +1,19 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+
+export type OnLoadEventPayload = {
+  url: string;
+};
+
+export type ExpoRotationModuleEvents = {
+  onChange: (params: ChangeEventPayload) => void;
+};
+
+export type ChangeEventPayload = {
+  value: string;
+};
+
+export type ExpoRotationModuleViewProps = {
+  url: string;
+  onLoad: (event: { nativeEvent: OnLoadEventPayload }) => void;
+  style?: StyleProp<ViewStyle>;
+};

package/src/ExpoRotationModule.web.ts

@@ -0,0 +1,21 @@
+import { registerWebModule, NativeModule } from 'expo';
+
+import { ExpoRotationModuleEvents } from './ExpoRotationModule.types';
+import type { RotationState } from './ExpoRotationModule';
+
+class ExpoRotationModule extends NativeModule<ExpoRotationModuleEvents> {
+  async canWrite(): Promise<boolean> {
+    return true;
+  }
+  requestWritePermission(): void {
+    // no-op on web
+  }
+  async getRotationState(): Promise<RotationState> {
+    return 'AUTOROTATE';
+  }
+  async setRotationState(state: RotationState): Promise<void> {
+    // no-op on web
+  }
+}
+
+export default registerWebModule(ExpoRotationModule, 'ExpoRotationModule');

package/src/index.d.ts

@@ -0,0 +1,17 @@
+export type RotationState = "AUTOROTATE" | "PORTRAIT" | "LANDSCAPE";
+
+export function canWrite(): Promise<boolean>;
+export function requestWritePermission(): void;
+export function getRotationState(): Promise<RotationState>;
+export function setRotationState(state: RotationState): Promise<void>;
+export function getPackageName(): Promise<string>;
+
+declare const _default: {
+  canWrite: typeof canWrite;
+  requestWritePermission: typeof requestWritePermission;
+  getRotationState: typeof getRotationState;
+  setRotationState: typeof setRotationState;
+  getPackageName: typeof getPackageName;
+};
+
+export default _default;

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './ExpoRotationModule';
+export * from './ExpoRotationModule.types';

package/tsconfig.json

@@ -0,0 +1,9 @@
+// @generated by expo-module-scripts
+{
+  "extends": "expo-module-scripts/tsconfig.base",
+  "compilerOptions": {
+    "outDir": "./build"
+  },
+  "include": ["./src"],
+  "exclude": ["**/__mocks__/*", "**/__tests__/*", "**/__rsc_tests__/*"]
+}