react-native-frame-capture 1.0.1

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Type definitions for React Native Frame Capture
+ * @module types
+ */
+/**
+ * Capture state values
+ */
+export declare enum CaptureState {
+    IDLE = "idle",
+    CAPTURING = "capturing",
+    PAUSED = "paused",
+    STOPPING = "stopping"
+}
+/**
+ * Permission status values
+ */
+export declare enum PermissionStatus {
+    GRANTED = "granted",
+    DENIED = "denied",
+    NOT_DETERMINED = "not_determined"
+}
+/**
+ * Error codes for capture operations
+ */
+export declare enum CaptureErrorCode {
+    PERMISSION_DENIED = "PERMISSION_DENIED",
+    ALREADY_CAPTURING = "ALREADY_CAPTURING",
+    INVALID_OPTIONS = "INVALID_OPTIONS",
+    STORAGE_ERROR = "STORAGE_ERROR",
+    SYSTEM_ERROR = "SYSTEM_ERROR",
+    NOT_SUPPORTED = "NOT_SUPPORTED"
+}
+/**
+ * Event types emitted by the capture system
+ */
+export declare enum CaptureEventType {
+    FRAME_CAPTURED = "onFrameCaptured",
+    CAPTURE_ERROR = "onCaptureError",
+    CAPTURE_STOP = "onCaptureStop",
+    CAPTURE_START = "onCaptureStart",
+    STORAGE_WARNING = "onStorageWarning",
+    CAPTURE_PAUSE = "onCapturePause",
+    CAPTURE_RESUME = "onCaptureResume",
+    OVERLAY_ERROR = "onOverlayError"
+}
+/**
+ * Unit type for capture region coordinates
+ */
+export type CaptureRegionUnit = 'pixels' | 'percentage';
+/**
+ * Position preset for overlay placement
+ */
+export type PositionPreset = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+/**
+ * Custom capture region specification
+ */
+export interface CaptureRegion {
+    /** Left position (pixels or 0-1 for percentage) */
+    x: number;
+    /** Top position (pixels or 0-1 for percentage) */
+    y: number;
+    /** Width (pixels or 0-1 for percentage) */
+    width: number;
+    /** Height (pixels or 0-1 for percentage) */
+    height: number;
+    /** Unit type for coordinates (default: 'percentage') */
+    unit?: CaptureRegionUnit;
+}
+/**
+ * File naming configuration
+ */
+export interface FileNamingConfig {
+    /** Filename prefix (default: "capture_") */
+    prefix?: string;
+    /** Date format pattern (default: "yyyyMMdd_HHmmss_SSS") */
+    dateFormat?: string;
+    /** Frame number padding digits (default: 5) */
+    framePadding?: number;
+}
+/**
+ * Notification customization options for the foreground service
+ */
+export interface NotificationOptions {
+    title?: string;
+    description?: string;
+    icon?: string;
+    smallIcon?: string;
+    color?: string;
+    channelName?: string;
+    channelDescription?: string;
+    priority?: 'low' | 'default' | 'high';
+    showFrameCount?: boolean;
+    updateInterval?: number;
+    pausedTitle?: string;
+    pausedDescription?: string;
+    showStopAction?: boolean;
+    showPauseAction?: boolean;
+    showResumeAction?: boolean;
+}
+/**
+ * Capture behavior configuration
+ */
+export interface CaptureConfig {
+    /** Milliseconds between captures (100-60000) */
+    interval: number;
+}
+/**
+ * Image processing configuration
+ */
+export interface ImageConfig {
+    /** Image quality 0-100 */
+    quality: number;
+    /** Output format */
+    format: 'png' | 'jpeg';
+    /** Resolution scale factor 0.1-1.0 */
+    scaleResolution?: number;
+    /** Custom capture region */
+    region?: CaptureRegion;
+    /** Exclude status bar from capture */
+    excludeStatusBar?: boolean;
+}
+/**
+ * Storage configuration
+ */
+export interface StorageOptions {
+    /** Whether to save captured frames to device storage */
+    saveFrames?: boolean;
+    /** Storage location for captured frames */
+    location?: 'private' | 'public';
+    /** Custom output directory */
+    outputDirectory?: string;
+    /** Storage warning threshold in bytes (default: 100MB, set to 0 to disable) */
+    warningThreshold?: number;
+    /** File naming configuration */
+    fileNaming?: FileNamingConfig;
+}
+/**
+ * Performance tuning configuration
+ */
+export interface PerformanceOptions {
+    /** Overlay image cache size in bytes (default: 10MB) */
+    overlayCacheSize?: number;
+    /** ImageReader buffer count (default: 2) */
+    imageReaderBuffers?: number;
+    /** Executor shutdown timeout in milliseconds (default: 5000ms) */
+    executorShutdownTimeout?: number;
+    /** Forced executor shutdown timeout in milliseconds (default: 1000ms) */
+    executorForcedShutdownTimeout?: number;
+}
+/**
+ * Configuration options for screen capture
+ */
+export interface CaptureOptions {
+    /** Capture behavior configuration */
+    capture: CaptureConfig;
+    /** Image processing configuration */
+    image: ImageConfig;
+    /** Storage configuration */
+    storage?: StorageOptions;
+    /** Performance tuning configuration */
+    performance?: PerformanceOptions;
+    /** Notification customization options */
+    notification?: NotificationOptions;
+    /** Array of overlays to render on captured frames */
+    overlays?: OverlayConfig[];
+}
+/**
+ * Custom position coordinates for overlay placement
+ */
+export interface PositionCoordinates {
+    x: number;
+    y: number;
+    unit?: 'pixels' | 'percentage';
+}
+/**
+ * Overlay position - either a preset string or custom coordinates
+ */
+export type OverlayPosition = PositionPreset | PositionCoordinates;
+/**
+ * Text overlay style configuration
+ */
+export interface TextStyle {
+    fontSize?: number;
+    color?: string;
+    backgroundColor?: string;
+    padding?: number;
+    fontWeight?: 'normal' | 'bold';
+    textAlign?: 'left' | 'center' | 'right';
+}
+/**
+ * Text overlay configuration
+ */
+export interface TextOverlay {
+    type: 'text';
+    content: string;
+    position: OverlayPosition;
+    style?: TextStyle;
+}
+/**
+ * Image size configuration
+ */
+export interface ImageSize {
+    width: number;
+    height: number;
+}
+/**
+ * Image overlay configuration
+ */
+export interface ImageOverlay {
+    type: 'image';
+    source: string;
+    position: OverlayPosition;
+    size?: ImageSize;
+    opacity?: number;
+}
+/**
+ * Union type for all overlay configurations
+ */
+export type OverlayConfig = TextOverlay | ImageOverlay;
+/**
+ * Information about an active capture session
+ */
+export interface CaptureSession {
+    id: string;
+    startTime: number;
+    frameCount: number;
+    options: CaptureOptions;
+}
+/**
+ * Current capture status
+ */
+export interface CaptureStatus {
+    state: CaptureState;
+    session: CaptureSession | null;
+    isPaused: boolean;
+}
+/**
+ * Re-export event types from NativeFrameCapture for consistency
+ * These are defined in NativeFrameCapture.ts for codegen compatibility
+ */
+import type { FrameCapturedEvent, CaptureErrorEvent, CaptureStopEvent, CaptureStartEvent, StorageWarningEvent, CapturePauseEvent, CaptureResumeEvent, OverlayErrorEvent } from './NativeFrameCapture';
+export type { FrameCapturedEvent, CaptureErrorEvent, CaptureStopEvent, CaptureStartEvent, StorageWarningEvent, CapturePauseEvent, CaptureResumeEvent, OverlayErrorEvent, };
+/**
+ * Union type for all event callbacks
+ */
+export type CaptureEventCallback = ((event: FrameCapturedEvent) => void) | ((event: CaptureErrorEvent) => void) | ((event: CaptureStopEvent) => void) | ((event: CaptureStartEvent) => void) | ((event: StorageWarningEvent) => void) | ((event: CapturePauseEvent) => void) | ((event: CaptureResumeEvent) => void) | ((event: OverlayErrorEvent) => void);
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/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/lib/typescript/src/validation.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Input validation utilities
+ * @module validation
+ */
+import type { CaptureOptions } from './types';
+/**
+ * Validates capture options
+ * @throws {CaptureError} if validation fails
+ */
+export declare function validateOptions(options: Partial<CaptureOptions>): void;
+/**
+ * Merges user options with defaults
+ */
+export declare function mergeOptions(options?: Partial<CaptureOptions>): CaptureOptions;
+//# sourceMappingURL=validation.d.ts.map

package/lib/typescript/src/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAkItE;AAsJD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,cAAc,CAgBhB"}

package/package.json

@@ -0,0 +1,196 @@
+{
+  "name": "react-native-frame-capture",
+  "version": "1.0.1",
+  "description": "Reliable screen capture for React Native Android. Capture frames at intervals with customizable overlays and storage options.",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./app.plugin.js": "./app.plugin.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "plugin/build",
+    "*.podspec",
+    "react-native.config.js",
+    "app.plugin.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-frame-capture-example",
+    "test": "jest --passWithNoTests",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "release": "release-it --only-version",
+    "run-dev": "cd example/android && gradlew clean && cd ../../ && yarn prepare && yarn example android"
+  },
+  "keywords": [
+    "react-native",
+    "android",
+    "screen-capture",
+    "frame-capture",
+    "screenshot",
+    "screen-recording",
+    "interval-capture",
+    "media-projection",
+    "turbo-module",
+    "expo",
+    "capture",
+    "frame",
+    "screen",
+    "recording",
+    "fps",
+    "foreground-service",
+    "overlay",
+    "watermark",
+    "image-overlay",
+    "text-overlay",
+    "kotlin",
+    "typescript",
+    "background-capture",
+    "periodic-capture"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nasyx-rakeeb/react-native-frame-capture.git"
+  },
+  "author": "Nasyx Rakeeb <nasyxrakeeb2@gmail.com> (https://github.com/nasyx-rakeeb)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/nasyx-rakeeb/react-native-frame-capture/issues"
+  },
+  "homepage": "https://github.com/nasyx-rakeeb/react-native-frame-capture#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@evilmartians/lefthook": "^1.12.3",
+    "@expo/config-plugins": "^9.0.0",
+    "@react-native-community/cli": "20.0.1",
+    "@react-native/babel-preset": "0.81.1",
+    "@react-native/eslint-config": "^0.81.1",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.1.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "prettier": "^3.6.2",
+    "react": "19.1.0",
+    "react-native": "0.81.1",
+    "react-native-builder-bob": "^0.40.13",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "expo": "*",
+    "react": "*",
+    "react-native": "*"
+  },
+  "peerDependenciesMeta": {
+    "expo": {
+      "optional": true
+    }
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@3.6.1",
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "FrameCaptureSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.framecapture"
+    }
+  },
+  "create-react-native-library": {
+    "languages": "kotlin-objc",
+    "type": "turbo-module",
+    "version": "0.54.8"
+  }
+}

package/plugin/build/index.js

@@ -0,0 +1,48 @@
+'use strict';
+Object.defineProperty(exports, '__esModule', { value: true });
+const config_plugins_1 = require('@expo/config-plugins');
+
+/**
+ * Expo Config Plugin for react-native-frame-capture
+ *
+ * This plugin ensures the library is properly configured for Expo projects.
+ * The native Android configuration (permissions, service) is already defined
+ * in the library's AndroidManifest.xml and will be merged automatically
+ * during the Expo prebuild process.
+ *
+ * This plugin serves as:
+ * 1. A marker that the library supports Expo
+ * 2. A placeholder for future configuration options
+ * 3. Documentation for Expo users
+ */
+const withFrameCapture = (config) => {
+  // The library's AndroidManifest.xml already contains:
+  // - FOREGROUND_SERVICE permission
+  // - FOREGROUND_SERVICE_MEDIA_PROJECTION permission (API 34+)
+  // - POST_NOTIFICATIONS permission (API 33+)
+  // - ScreenCaptureService with proper foregroundServiceType
+  //
+  // These will be automatically merged by Expo's manifest merger.
+  // No additional modifications needed at this time.
+
+  return config;
+};
+
+// Read package.json to get the actual version
+let pkg = {
+  name: 'react-native-frame-capture',
+  version: '1.0.0',
+};
+
+try {
+  pkg = require('react-native-frame-capture/package.json');
+} catch {
+  // Fallback to hardcoded values if package.json can't be found
+  // This shouldn't happen in normal usage
+}
+
+exports.default = (0, config_plugins_1.createRunOncePlugin)(
+  withFrameCapture,
+  pkg.name,
+  pkg.version
+);

package/src/NativeFrameCapture.ts

@@ -0,0 +1,86 @@
+/**
+ * Native TurboModule bridge for React Native Frame Capture
+ * @module NativeFrameCapture
+ */
+
+import { TurboModuleRegistry, type TurboModule } from 'react-native';
+
+/**
+ * EventEmitter type for TurboModule events
+ */
+type EventEmitter<T> = (callback: (event: T) => void) => { remove: () => void };
+
+/**
+ * Event payload types (defined inline for codegen compatibility)
+ */
+export type FrameCapturedEvent = {
+  filePath: string;
+  timestamp: number;
+  frameNumber: number;
+  fileSize: number;
+};
+
+export type CaptureErrorEvent = {
+  code: string;
+  message: string;
+  details?: Object;
+};
+
+export type CaptureStopEvent = {
+  sessionId: string;
+  totalFrames: number;
+  duration: number;
+};
+
+export type CaptureStartEvent = {
+  sessionId: string;
+  options: Object;
+};
+
+export type StorageWarningEvent = {
+  availableSpace: number;
+  threshold: number;
+};
+
+export type CapturePauseEvent = {
+  sessionId: string;
+};
+
+export type CaptureResumeEvent = {
+  sessionId: string;
+};
+
+export type OverlayErrorEvent = {
+  overlayIndex: number;
+  overlayType: string;
+  message: string;
+};
+
+/**
+ * TurboModule specification for FrameCapture
+ * Defines the native methods implemented in Kotlin
+ */
+export interface Spec extends TurboModule {
+  // Event Emitters
+  readonly onFrameCaptured: EventEmitter<FrameCapturedEvent>;
+  readonly onCaptureError: EventEmitter<CaptureErrorEvent>;
+  readonly onCaptureStop: EventEmitter<CaptureStopEvent>;
+  readonly onCaptureStart: EventEmitter<CaptureStartEvent>;
+  readonly onStorageWarning: EventEmitter<StorageWarningEvent>;
+  readonly onCapturePause: EventEmitter<CapturePauseEvent>;
+  readonly onCaptureResume: EventEmitter<CaptureResumeEvent>;
+  readonly onOverlayError: EventEmitter<OverlayErrorEvent>;
+
+  // Methods
+  requestPermission(): Promise<string>;
+  checkPermission(): Promise<string>;
+  startCapture(options: Object): Promise<Object>;
+  stopCapture(): Promise<void>;
+  pauseCapture(): Promise<void>;
+  resumeCapture(): Promise<void>;
+  getCaptureStatus(): Promise<Object>;
+  checkNotificationPermission(): Promise<string>;
+  cleanupTempFrames(): Promise<void>;
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('FrameCapture');