react-native-frame-capture 1.0.1

package/lib/module/validation.js

@@ -0,0 +1,190 @@
+"use strict";
+
+/**
+ * Input validation utilities
+ * @module validation
+ */
+
+import { CaptureErrorCode } from "./types.js";
+import { CaptureError } from "./errors.js";
+import { MIN_INTERVAL, MAX_INTERVAL, MIN_QUALITY, MAX_QUALITY } from "./constants.js";
+/**
+ * Validates capture options
+ * @throws {CaptureError} if validation fails
+ */
+export function validateOptions(options) {
+  // Validate capture config
+  if (options.capture) {
+    const {
+      interval
+    } = options.capture;
+    if (interval !== undefined) {
+      if (typeof interval !== 'number' || interval < MIN_INTERVAL || interval > MAX_INTERVAL) {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `capture.interval must be a number between ${MIN_INTERVAL} and ${MAX_INTERVAL} milliseconds`);
+      }
+    }
+  }
+
+  // Validate image config
+  if (options.image) {
+    const {
+      quality,
+      format,
+      scaleResolution,
+      region,
+      excludeStatusBar
+    } = options.image;
+    if (quality !== undefined) {
+      if (typeof quality !== 'number' || quality < MIN_QUALITY || quality > MAX_QUALITY) {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.quality must be a number between ${MIN_QUALITY} and ${MAX_QUALITY}`);
+      }
+    }
+    if (format !== undefined) {
+      if (format !== 'png' && format !== 'jpeg') {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.format must be either 'png' or 'jpeg'`);
+      }
+    }
+    if (scaleResolution !== undefined) {
+      if (typeof scaleResolution !== 'number' || scaleResolution < 0.1 || scaleResolution > 1.0) {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.scaleResolution must be a number between 0.1 and 1.0`);
+      }
+    }
+    if (region !== undefined) {
+      validateCaptureRegion(region);
+    }
+    if (excludeStatusBar !== undefined && typeof excludeStatusBar !== 'boolean') {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.excludeStatusBar must be a boolean`);
+    }
+  }
+
+  // Validate storage config
+  if (options.storage) {
+    const {
+      saveFrames,
+      location,
+      outputDirectory,
+      warningThreshold,
+      fileNaming
+    } = options.storage;
+    if (saveFrames !== undefined && typeof saveFrames !== 'boolean') {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.saveFrames must be a boolean`);
+    }
+    if (location !== undefined) {
+      if (location !== 'private' && location !== 'public') {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.location must be either 'private' or 'public'`);
+      }
+    }
+    if (outputDirectory !== undefined) {
+      if (typeof outputDirectory !== 'string' || outputDirectory.trim() === '') {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.outputDirectory must be a non-empty string`);
+      }
+    }
+    if (warningThreshold !== undefined) {
+      if (typeof warningThreshold !== 'number' || warningThreshold < 0) {
+        throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.warningThreshold must be a non-negative number (bytes)`);
+      }
+    }
+    if (fileNaming) {
+      validateFileNaming(fileNaming);
+    }
+  }
+
+  // Validate performance config
+  if (options.performance) {
+    validatePerformance(options.performance);
+  }
+}
+
+/**
+ * Validates file naming configuration
+ */
+function validateFileNaming(fn) {
+  if (fn.prefix !== undefined) {
+    if (typeof fn.prefix !== 'string' || fn.prefix.trim() === '') {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.fileNaming.prefix must be a non-empty string`);
+    }
+    if (/[<>:"/\\|?*]/.test(fn.prefix)) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.fileNaming.prefix contains invalid filename characters`);
+    }
+  }
+  if (fn.dateFormat !== undefined) {
+    if (typeof fn.dateFormat !== 'string' || fn.dateFormat.trim() === '') {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.fileNaming.dateFormat must be a non-empty string`);
+    }
+  }
+  if (fn.framePadding !== undefined) {
+    if (typeof fn.framePadding !== 'number' || fn.framePadding < 1 || fn.framePadding > 10) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `storage.fileNaming.framePadding must be between 1 and 10`);
+    }
+  }
+}
+
+/**
+ * Validates performance configuration
+ */
+function validatePerformance(perf) {
+  if (perf.overlayCacheSize !== undefined) {
+    if (typeof perf.overlayCacheSize !== 'number' || perf.overlayCacheSize < 0) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `performance.overlayCacheSize must be a non-negative number (bytes)`);
+    }
+  }
+  if (perf.imageReaderBuffers !== undefined) {
+    if (typeof perf.imageReaderBuffers !== 'number' || perf.imageReaderBuffers < 1 || perf.imageReaderBuffers > 10) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `performance.imageReaderBuffers must be between 1 and 10`);
+    }
+  }
+  if (perf.executorShutdownTimeout !== undefined) {
+    if (typeof perf.executorShutdownTimeout !== 'number' || perf.executorShutdownTimeout < 100 || perf.executorShutdownTimeout > 30000) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `performance.executorShutdownTimeout must be between 100 and 30000ms`);
+    }
+  }
+  if (perf.executorForcedShutdownTimeout !== undefined) {
+    if (typeof perf.executorForcedShutdownTimeout !== 'number' || perf.executorForcedShutdownTimeout < 100 || perf.executorForcedShutdownTimeout > 10000) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `performance.executorForcedShutdownTimeout must be between 100 and 10000ms`);
+    }
+  }
+}
+
+/**
+ * Validates capture region configuration
+ */
+function validateCaptureRegion(region) {
+  const unit = region.unit || 'percentage';
+  if (typeof region.x !== 'number' || typeof region.y !== 'number' || typeof region.width !== 'number' || typeof region.height !== 'number') {
+    throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.region coordinates must be numbers`);
+  }
+  if (unit === 'percentage') {
+    if (region.x < 0 || region.x > 1 || region.y < 0 || region.y > 1 || region.width < 0 || region.width > 1 || region.height < 0 || region.height > 1) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.region percentage values must be between 0 and 1`);
+    }
+    if (region.x + region.width > 1 || region.y + region.height > 1) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.region extends beyond screen bounds (x + width or y + height > 1)`);
+    }
+  } else if (unit === 'pixels') {
+    if (region.width <= 0 || region.height <= 0) {
+      throw new CaptureError(CaptureErrorCode.INVALID_OPTIONS, `image.region width and height must be positive`);
+    }
+  }
+}
+
+/**
+ * Merges user options with defaults
+ */
+export function mergeOptions(options) {
+  return {
+    capture: {
+      interval: 1000,
+      ...options?.capture
+    },
+    image: {
+      quality: 80,
+      format: 'jpeg',
+      ...options?.image
+    },
+    storage: options?.storage,
+    performance: options?.performance,
+    notification: options?.notification,
+    overlays: options?.overlays
+  };
+}
+//# sourceMappingURL=validation.js.map

package/lib/module/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CaptureErrorCode","CaptureError","MIN_INTERVAL","MAX_INTERVAL","MIN_QUALITY","MAX_QUALITY","validateOptions","options","capture","interval","undefined","INVALID_OPTIONS","image","quality","format","scaleResolution","region","excludeStatusBar","validateCaptureRegion","storage","saveFrames","location","outputDirectory","warningThreshold","fileNaming","trim","validateFileNaming","performance","validatePerformance","fn","prefix","test","dateFormat","framePadding","perf","overlayCacheSize","imageReaderBuffers","executorShutdownTimeout","executorForcedShutdownTimeout","unit","x","y","width","height","mergeOptions","notification","overlays"],"sourceRoot":"..\\..\\src","sources":["validation.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/plugin/src/index.d.ts

@@ -0,0 +1,4 @@
+import type { ConfigPlugin } from '@expo/config-plugins';
+declare const _default: ConfigPlugin<void>;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/plugin/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../plugin/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;;AA0CzD,wBAA4E"}

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

@@ -0,0 +1,75 @@
+/**
+ * Native TurboModule bridge for React Native Frame Capture
+ * @module NativeFrameCapture
+ */
+import { 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 {
+    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>;
+    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>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeFrameCapture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeFrameCapture.d.ts","sourceRoot":"","sources":["../../../src/NativeFrameCapture.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;GAEG;AACH,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,KAAK;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACzD,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAAC;IACvD,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACzD,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAAC;IAC7D,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IACzD,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAC3D,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAC;IAGzD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACnC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACpC,2BAA2B,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;;AAED,wBAAsE"}

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

@@ -0,0 +1,66 @@
+/**
+ * Core API functions for React Native Frame Capture
+ * @module api
+ */
+import { PermissionStatus, type CaptureOptions, type CaptureSession, type CaptureStatus } from './types';
+/**
+ * Requests MediaProjection permission from the user
+ *
+ * @returns Promise resolving to permission status
+ * @throws {CaptureError} if permission request fails
+ */
+export declare function requestPermission(): Promise<PermissionStatus>;
+/**
+ * Checks current permission status without requesting
+ *
+ * @returns Promise resolving to current permission status
+ */
+export declare function checkPermission(): Promise<PermissionStatus>;
+/**
+ * Starts screen capture with the given options
+ *
+ * @param options - Capture configuration options (optional, uses defaults if not provided)
+ * @returns Promise resolving to capture session information
+ * @throws {CaptureError} if capture cannot be started
+ */
+export declare function startCapture(options?: Partial<CaptureOptions>): Promise<CaptureSession>;
+/**
+ * Stops the active capture session
+ *
+ * @returns Promise that resolves when capture is stopped
+ * @throws {CaptureError} if stop operation fails
+ */
+export declare function stopCapture(): Promise<void>;
+/**
+ * Pauses the active capture session
+ *
+ * @returns Promise that resolves when capture is paused
+ * @throws {CaptureError} if pause operation fails
+ */
+export declare function pauseCapture(): Promise<void>;
+/**
+ * Resumes a paused capture session
+ *
+ * @returns Promise that resolves when capture is resumed
+ * @throws {CaptureError} if resume operation fails
+ */
+export declare function resumeCapture(): Promise<void>;
+/**
+ * Gets the current capture status
+ *
+ * @returns Promise resolving to current capture status
+ */
+export declare function getCaptureStatus(): Promise<CaptureStatus>;
+/**
+ * Checks if notification permission is granted (Android 13+)
+ *
+ * @returns Promise resolving to permission status
+ */
+export declare function checkNotificationPermission(): Promise<PermissionStatus>;
+/**
+ * Manually cleans up all temporary frame files
+ *
+ * @returns Promise that resolves when cleanup is complete
+ */
+export declare function cleanupTempFrames(): Promise<void>;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/api.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAEL,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAWnE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAWjE;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,OAAO,CAAC,cAAc,CAAC,CAkBzB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAUjD;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAUlD;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAUnD;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,aAAa,CAAC,CAW/D;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAW7E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUvD"}

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

@@ -0,0 +1,41 @@
+/**
+ * Constants for React Native Frame Capture
+ * @module constants
+ */
+import type { CaptureOptions, FileNamingConfig, PerformanceOptions } from './types';
+/**
+ * Default configuration options
+ */
+export declare const DEFAULT_OPTIONS: CaptureOptions;
+/**
+ * Default advanced configuration (for validation fallbacks)
+ */
+export declare const DEFAULT_ADVANCED_CONFIG: {
+    storage: {
+        warningThreshold: number;
+    };
+    fileNaming: Required<FileNamingConfig>;
+    performance: Required<PerformanceOptions>;
+};
+/**
+ * Minimum interval between captures (milliseconds)
+ */
+export declare const MIN_INTERVAL = 100;
+/**
+ * Maximum interval between captures (milliseconds)
+ */
+export declare const MAX_INTERVAL = 60000;
+/**
+ * Minimum image quality value
+ */
+export declare const MIN_QUALITY = 0;
+/**
+ * Maximum image quality value
+ */
+export declare const MAX_QUALITY = 100;
+/**
+ * Storage warning threshold (bytes)
+ * @deprecated Use advanced.storage.warningThreshold in CaptureOptions instead
+ */
+export declare const STORAGE_WARNING_THRESHOLD: number;
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/constants.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,cAQ7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;gBAQ7B,QAAQ,CAAC,gBAAgB,CAAC;iBAM1B,QAAQ,CAAC,kBAAkB,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,MAAM,CAAC;AAEhC;;GAEG;AACH,eAAO,MAAM,YAAY,QAAQ,CAAC;AAElC;;GAEG;AACH,eAAO,MAAM,WAAW,IAAI,CAAC;AAE7B;;GAEG;AACH,eAAO,MAAM,WAAW,MAAM,CAAC;AAE/B;;;GAGG;AACH,eAAO,MAAM,yBAAyB,QAAoB,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * Error handling for React Native Frame Capture
+ * @module errors
+ */
+import { CaptureErrorCode } from './types';
+/**
+ * Custom error class for capture operations
+ */
+export declare class CaptureError extends Error {
+    code: CaptureErrorCode;
+    details?: any;
+    constructor(code: CaptureErrorCode, message: string, details?: any);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,CAAC,EAAE,GAAG,CAAC;gBAEF,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;CAMnE"}

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

@@ -0,0 +1,30 @@
+/**
+ * Event handling for React Native Frame Capture
+ * @module events
+ */
+import type { EventSubscription } from 'react-native';
+import { CaptureEventType, type CaptureEventCallback } from './types';
+/**
+ * Adds an event listener for capture events
+ *
+ * @param event - Event type to listen for
+ * @param callback - Function to call when event is emitted
+ * @returns Subscription object that can be used to remove the listener
+ *
+ * @example
+ * ```typescript
+ * const subscription = addListener(
+ *   CaptureEventType.FRAME_CAPTURED,
+ *   (event) => console.log('Frame captured:', event.filePath)
+ * );
+ *
+ * // Later, remove the listener
+ * subscription.remove();
+ * ```
+ */
+export declare function addListener(event: CaptureEventType, callback: CaptureEventCallback): EventSubscription;
+/**
+ * @deprecated Use subscription.remove() instead
+ */
+export declare function removeAllListeners(_event: CaptureEventType): void;
+//# sourceMappingURL=events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,oBAAoB,GAC7B,iBAAiB,CAqBnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAIjE"}

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

@@ -0,0 +1,12 @@
+/**
+ * React Native Frame Capture
+ * Production-grade screen capture library for React Native Android
+ *
+ * @packageDocumentation
+ */
+export * from './types';
+export * from './constants';
+export { CaptureError } from './errors';
+export { requestPermission, checkPermission, startCapture, stopCapture, pauseCapture, resumeCapture, getCaptureStatus, checkNotificationPermission, cleanupTempFrames, } from './api';
+export { addListener, removeAllListeners } from './events';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,OAAO,CAAC;AAGf,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Normalization utilities for converting organized CaptureOptions
+ * to the flat structure expected by native code
+ * @module normalize
+ */
+import type { CaptureOptions } from './types';
+/**
+ * Flat options structure expected by native code
+ */
+export interface NativeCaptureOptions {
+    interval: number;
+    quality: number;
+    format: 'png' | 'jpeg';
+    saveFrames?: boolean;
+    storageLocation?: 'private' | 'public';
+    outputDirectory?: string;
+    scaleResolution?: number;
+    captureRegion?: any;
+    excludeStatusBar?: boolean;
+    notification?: any;
+    overlays?: any[];
+    advanced?: {
+        storage?: {
+            warningThreshold?: number;
+        };
+        fileNaming?: {
+            prefix?: string;
+            dateFormat?: string;
+            framePadding?: number;
+        };
+        performance?: {
+            overlayCacheSize?: number;
+            imageReaderBuffers?: number;
+            executorShutdownTimeout?: number;
+            executorForcedShutdownTimeout?: number;
+        };
+    };
+}
+/**
+ * Normalizes organized CaptureOptions to flat structure for native code
+ */
+export declare function normalizeOptions(options: CaptureOptions): NativeCaptureOptions;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE;YACR,gBAAgB,CAAC,EAAE,MAAM,CAAC;SAC3B,CAAC;QACF,UAAU,CAAC,EAAE;YACX,MAAM,CAAC,EAAE,MAAM,CAAC;YAChB,UAAU,CAAC,EAAE,MAAM,CAAC;YACpB,YAAY,CAAC,EAAE,MAAM,CAAC;SACvB,CAAC;QACF,WAAW,CAAC,EAAE;YACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;YAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;YACjC,6BAA6B,CAAC,EAAE,MAAM,CAAC;SACxC,CAAC;KACH,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,GACtB,oBAAoB,CAkCtB"}