@movementinfra/expo-twostep-video 0.1.0

package/build/index.js

@@ -0,0 +1,430 @@
+/**
+ * TwoStepVideo - Professional video editing for React Native
+ * Built on native AVFoundation with Expo Modules
+ */
+import ExpoTwoStepVideoModule from './ExpoTwostepVideoModule';
+// MARK: - Constants
+/**
+ * Quality constants
+ */
+export const Quality = {
+    LOW: ExpoTwoStepVideoModule.QUALITY_LOW,
+    MEDIUM: ExpoTwoStepVideoModule.QUALITY_MEDIUM,
+    HIGH: ExpoTwoStepVideoModule.QUALITY_HIGH,
+    HIGHEST: ExpoTwoStepVideoModule.QUALITY_HIGHEST,
+};
+/**
+ * Mirror axis constants
+ */
+export const Mirror = {
+    HORIZONTAL: ExpoTwoStepVideoModule.MIRROR_HORIZONTAL,
+    VERTICAL: ExpoTwoStepVideoModule.MIRROR_VERTICAL,
+    BOTH: ExpoTwoStepVideoModule.MIRROR_BOTH,
+};
+// MARK: - API Functions
+/**
+ * Load a video asset from a file URI
+ *
+ * @param options - Load options containing the file URI
+ * @returns Promise resolving to video asset metadata
+ *
+ * @example
+ * ```typescript
+ * const asset = await TwoStepVideo.loadAsset({
+ *   uri: 'file:///path/to/video.mp4'
+ * });
+ * console.log(`Duration: ${asset.duration}s, Size: ${asset.width}x${asset.height}`);
+ * ```
+ */
+export async function loadAsset(options) {
+    return await ExpoTwoStepVideoModule.loadAsset(options.uri);
+}
+/**
+ * Load a video asset from the Photos library
+ *
+ * @param localIdentifier - PHAsset local identifier from the Photos library
+ * @returns Promise resolving to video asset metadata
+ *
+ * @example
+ * ```typescript
+ * // After using expo-media-library to get a photo asset
+ * const asset = await TwoStepVideo.loadAssetFromPhotos(photoAsset.id);
+ * ```
+ */
+export async function loadAssetFromPhotos(localIdentifier) {
+    return await ExpoTwoStepVideoModule.loadAssetFromPhotos(localIdentifier);
+}
+/**
+ * Validate a video file URI without loading the full asset
+ * Useful for quick validation before processing
+ *
+ * @param uri - File URI to validate
+ * @returns Promise resolving to true if valid video file
+ *
+ * @example
+ * ```typescript
+ * const isValid = await TwoStepVideo.validateVideoUri('file:///path/to/video.mp4');
+ * if (isValid) {
+ *   const asset = await TwoStepVideo.loadAsset({ uri });
+ * }
+ * ```
+ */
+export async function validateVideoUri(uri) {
+    return await ExpoTwoStepVideoModule.validateVideoUri(uri);
+}
+/**
+ * Trim a video to a single time range
+ *
+ * @param options - Trim options including asset ID and time range
+ * @returns Promise resolving to composition metadata
+ *
+ * @example
+ * ```typescript
+ * const asset = await TwoStepVideo.loadAsset({ uri });
+ * const composition = await TwoStepVideo.trimVideo({
+ *   assetId: asset.id,
+ *   startTime: 5.0,
+ *   endTime: 15.0
+ * });
+ * console.log(`Trimmed to ${composition.duration}s`);
+ * ```
+ */
+export async function trimVideo(options) {
+    return await ExpoTwoStepVideoModule.trimVideo(options.assetId, options.startTime, options.endTime);
+}
+/**
+ * Trim a video to multiple segments and concatenate them
+ *
+ * @param options - Trim options including asset ID and segments
+ * @returns Promise resolving to composition metadata
+ *
+ * @example
+ * ```typescript
+ * const composition = await TwoStepVideo.trimVideoMultiple({
+ *   assetId: asset.id,
+ *   segments: [
+ *     { start: 0, end: 3 },    // First 3 seconds
+ *     { start: 10, end: 13 },  // 3 seconds from middle
+ *     { start: 20, end: 23 }   // 3 seconds from end
+ *   ]
+ * });
+ * ```
+ */
+export async function trimVideoMultiple(options) {
+    return await ExpoTwoStepVideoModule.trimVideoMultiple(options.assetId, options.segments);
+}
+/**
+ * Mirror a video horizontally, vertically, or both
+ *
+ * @param options - Mirror options including asset ID and axis
+ * @returns Promise resolving to composition metadata
+ *
+ * @example
+ * ```typescript
+ * // Mirror horizontally (flip left-right, common for selfie videos)
+ * const composition = await TwoStepVideo.mirrorVideo({
+ *   assetId: asset.id,
+ *   axis: 'horizontal'
+ * });
+ *
+ * // Mirror a specific segment
+ * const composition = await TwoStepVideo.mirrorVideo({
+ *   assetId: asset.id,
+ *   axis: 'vertical',
+ *   startTime: 5,
+ *   endTime: 10
+ * });
+ * ```
+ */
+export async function mirrorVideo(options) {
+    return await ExpoTwoStepVideoModule.mirrorVideo(options.assetId, options.axis, options.startTime, options.endTime);
+}
+/**
+ * Adjust the playback speed of a video
+ *
+ * @param options - Speed options including asset ID and speed multiplier
+ * @returns Promise resolving to composition metadata
+ *
+ * @example
+ * ```typescript
+ * // Slow motion (0.5x speed = 2x slower)
+ * const slowMo = await TwoStepVideo.adjustSpeed({
+ *   assetId: asset.id,
+ *   speed: 0.5
+ * });
+ *
+ * // Fast forward (2x speed)
+ * const fastForward = await TwoStepVideo.adjustSpeed({
+ *   assetId: asset.id,
+ *   speed: 2.0
+ * });
+ *
+ * // Speed up a specific segment
+ * const timelapse = await TwoStepVideo.adjustSpeed({
+ *   assetId: asset.id,
+ *   speed: 4.0,
+ *   startTime: 10,
+ *   endTime: 30
+ * });
+ * ```
+ */
+export async function adjustSpeed(options) {
+    return await ExpoTwoStepVideoModule.adjustSpeed(options.assetId, options.speed, options.startTime, options.endTime);
+}
+/**
+ * Transform a video with combined trimming, mirroring, and speed adjustment
+ * Use the player's `loop` prop for continuous playback looping
+ *
+ * @param options - Transform options including asset ID, speed, and mirror axis
+ * @returns Promise resolving to composition metadata
+ *
+ * @example
+ * ```typescript
+ * // Mirror and slow down
+ * const transformed = await TwoStepVideo.transformVideo({
+ *   assetId: asset.id,
+ *   speed: 0.5,
+ *   mirrorAxis: 'horizontal'
+ * });
+ *
+ * // Just mirror (speed defaults to 1.0)
+ * const mirrored = await TwoStepVideo.transformVideo({
+ *   assetId: asset.id,
+ *   mirrorAxis: 'both'
+ * });
+ *
+ * // Transform a specific segment (trim + mirror + speed)
+ * const segment = await TwoStepVideo.transformVideo({
+ *   assetId: asset.id,
+ *   speed: 2.0,
+ *   mirrorAxis: 'horizontal',
+ *   startTime: 0,
+ *   endTime: 5
+ * });
+ *
+ * // Play in loop mode
+ * <TwoStepVideoView compositionId={segment.id} loop />
+ * ```
+ */
+export async function transformVideo(options) {
+    return await ExpoTwoStepVideoModule.transformVideo(options.assetId, options.speed, options.mirrorAxis, options.startTime, options.endTime);
+}
+/**
+ * Loop a segment of a video multiple times
+ *
+ * @param options - Loop options including segment time range and repeat count
+ * @returns Promise resolving to loop result with duration info
+ *
+ * @example
+ * ```typescript
+ * // Loop a 2-second segment 3 times (plays 4 times total)
+ * const looped = await TwoStepVideo.loopSegment({
+ *   assetId: asset.id,
+ *   startTime: 5,
+ *   endTime: 7,
+ *   loopCount: 3
+ * });
+ * console.log(`Duration: ${looped.duration}s (plays ${looped.totalPlays} times)`);
+ *
+ * // Create a perfect loop for social media
+ * const perfectLoop = await TwoStepVideo.loopSegment({
+ *   assetId: asset.id,
+ *   startTime: 0,
+ *   endTime: 3,
+ *   loopCount: 4  // 15 seconds total (3s * 5 plays)
+ * });
+ * ```
+ */
+export async function loopSegment(options) {
+    return await ExpoTwoStepVideoModule.loopSegment(options.assetId, options.startTime, options.endTime, options.loopCount);
+}
+/**
+ * Generate thumbnail images from a video at specific times
+ *
+ * @param options - Thumbnail generation options
+ * @returns Promise resolving to array of base64 encoded PNG images
+ *
+ * @example
+ * ```typescript
+ * const thumbnails = await TwoStepVideo.generateThumbnails({
+ *   assetId: asset.id,
+ *   times: [1, 5, 10, 15],
+ *   size: { width: 300, height: 300 }
+ * });
+ *
+ * // Use in Image component
+ * <Image source={{ uri: `data:image/png;base64,${thumbnails[0]}` }} />
+ * ```
+ */
+export async function generateThumbnails(options) {
+    return await ExpoTwoStepVideoModule.generateThumbnails(options.assetId, options.times, options.size);
+}
+/**
+ * Export a composition to a video file
+ *
+ * @param options - Export options including composition ID and quality
+ * @returns Promise resolving to export result with file URI
+ *
+ * @example
+ * ```typescript
+ * const result = await TwoStepVideo.exportVideo({
+ *   compositionId: composition.id,
+ *   quality: 'high'
+ * });
+ * console.log(`Exported to: ${result.uri}`);
+ * ```
+ */
+export async function exportVideo(options) {
+    return await ExpoTwoStepVideoModule.exportVideo(options.compositionId, options.outputUri, options.quality);
+}
+/**
+ * Export an asset directly without creating a composition
+ * Useful for re-encoding or changing quality without trimming
+ *
+ * @param options - Export options including asset ID and quality
+ * @returns Promise resolving to export result with file URI
+ *
+ * @example
+ * ```typescript
+ * const result = await TwoStepVideo.exportAsset({
+ *   assetId: asset.id,
+ *   quality: 'medium'
+ * });
+ * ```
+ */
+export async function exportAsset(options) {
+    return await ExpoTwoStepVideoModule.exportAsset(options.assetId, options.outputUri, options.quality);
+}
+/**
+ * Clean up a temporary file
+ * Call this after you're done with exported files in the temp directory
+ *
+ * @param uri - File URI to clean up
+ *
+ * @example
+ * ```typescript
+ * const result = await TwoStepVideo.exportVideo({ ... });
+ * // ... do something with result.uri
+ * TwoStepVideo.cleanupFile(result.uri);
+ * ```
+ */
+export function cleanupFile(uri) {
+    ExpoTwoStepVideoModule.cleanupFile(uri);
+}
+/**
+ * Release an asset from memory
+ * Call this when you're done with an asset to free up memory
+ *
+ * @param assetId - ID of the asset to release
+ */
+export function releaseAsset(assetId) {
+    ExpoTwoStepVideoModule.releaseAsset(assetId);
+}
+/**
+ * Release a composition from memory
+ *
+ * @param compositionId - ID of the composition to release
+ */
+export function releaseComposition(compositionId) {
+    ExpoTwoStepVideoModule.releaseComposition(compositionId);
+}
+/**
+ * Release all cached assets and compositions
+ * Useful for cleanup when unmounting screens
+ */
+export function releaseAll() {
+    ExpoTwoStepVideoModule.releaseAll();
+}
+// MARK: - Event Listeners
+/**
+ * Add a listener for export progress events
+ *
+ * @param listener - Callback function receiving progress events
+ * @returns Subscription object with remove() method
+ *
+ * @example
+ * ```typescript
+ * const subscription = TwoStepVideo.addExportProgressListener((event) => {
+ *   console.log(`Export progress: ${Math.round(event.progress * 100)}%`);
+ *   setProgress(event.progress);
+ * });
+ *
+ * // Later, remove the listener
+ * subscription.remove();
+ * ```
+ */
+export function addExportProgressListener(listener) {
+    return ExpoTwoStepVideoModule.addListener('onExportProgress', listener);
+}
+// MARK: - Helper Hook (for React)
+/**
+ * React hook for managing export progress
+ * Only works in React components
+ *
+ * @returns Current export progress (0.0 to 1.0)
+ *
+ * @example
+ * ```typescript
+ * function VideoEditor() {
+ *   const progress = useExportProgress();
+ *
+ *   return (
+ *     <View>
+ *       <Text>Export Progress: {Math.round(progress * 100)}%</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function useExportProgress() {
+    const [progress, setProgress] = React.useState(0);
+    React.useEffect(() => {
+        const subscription = addExportProgressListener((event) => {
+            setProgress(event.progress);
+        });
+        return () => subscription.remove();
+    }, []);
+    return progress;
+}
+// Note: React import needed for the hook
+// If React is not available, the hook won't be usable but
+// the rest of the module will work fine
+let React;
+try {
+    React = require('react');
+}
+catch {
+    // React not available, hook won't work
+}
+// MARK: - Exports
+export default {
+    // Constants
+    Quality,
+    Mirror,
+    // Core functions
+    loadAsset,
+    loadAssetFromPhotos,
+    validateVideoUri,
+    trimVideo,
+    trimVideoMultiple,
+    generateThumbnails,
+    exportVideo,
+    exportAsset,
+    // Transformation functions
+    mirrorVideo,
+    adjustSpeed,
+    transformVideo,
+    loopSegment,
+    // Memory management
+    cleanupFile,
+    releaseAsset,
+    releaseComposition,
+    releaseAll,
+    // Events
+    addExportProgressListener,
+    // React hook
+    useExportProgress,
+};
+// MARK: - View Component Export
+export { default as TwoStepVideoView } from './ExpoTwostepVideoView';
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAuN9D,oBAAoB;AAEpB;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,GAAG,EAAE,sBAAsB,CAAC,WAAW;IACvC,MAAM,EAAE,sBAAsB,CAAC,cAAc;IAC7C,IAAI,EAAE,sBAAsB,CAAC,YAAY;IACzC,OAAO,EAAE,sBAAsB,CAAC,eAAe;CACvC,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,UAAU,EAAE,sBAAsB,CAAC,iBAAiB;IACpD,QAAQ,EAAE,sBAAsB,CAAC,eAAe;IAChD,IAAI,EAAE,sBAAsB,CAAC,WAAW;CAChC,CAAC;AAEX,wBAAwB;AAExB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,OAAO,MAAM,sBAAsB,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,eAAuB;IAC/D,OAAO,MAAM,sBAAsB,CAAC,mBAAmB,CAAC,eAAe,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW;IAChD,OAAO,MAAM,sBAAsB,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAyB;IACvD,OAAO,MAAM,sBAAsB,CAAC,SAAS,CAC3C,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAA4B;IAClE,OAAO,MAAM,sBAAsB,CAAC,iBAAiB,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,OAAO,MAAM,sBAAsB,CAAC,WAAW,CAC7C,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,IAAI,EACZ,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,OAAO,MAAM,sBAAsB,CAAC,WAAW,CAC7C,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B;IACjE,OAAO,MAAM,sBAAsB,CAAC,cAAc,CAChD,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,UAAU,EAClB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,OAAO,MAAM,sBAAsB,CAAC,WAAW,CAC7C,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,SAAS,CAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAkC;IAElC,OAAO,MAAM,sBAAsB,CAAC,kBAAkB,CACpD,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,KAAK,EACb,OAAO,CAAC,IAAI,CACb,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAiC;IACjE,OAAO,MAAM,sBAAsB,CAAC,WAAW,CAC7C,OAAO,CAAC,aAAa,EACrB,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAA2B;IAC3D,OAAO,MAAM,sBAAsB,CAAC,WAAW,CAC7C,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,OAAO,CAChB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,sBAAsB,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,sBAAsB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,aAAqB;IACtD,sBAAsB,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAC3D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU;IACxB,sBAAsB,CAAC,UAAU,EAAE,CAAC;AACtC,CAAC;AAED,0BAA0B;AAE1B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA8C;IAE9C,OAAO,sBAAsB,CAAC,WAAW,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAC1E,CAAC;AAED,kCAAkC;AAElC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAElD,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACnB,MAAM,YAAY,GAAG,yBAAyB,CAAC,CAAC,KAAK,EAAE,EAAE;YACvD,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,yCAAyC;AACzC,0DAA0D;AAC1D,wCAAwC;AACxC,IAAI,KAAU,CAAC;AACf,IAAI,CAAC;IACH,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAAC,MAAM,CAAC;IACP,uCAAuC;AACzC,CAAC;AAED,kBAAkB;AAElB,eAAe;IACb,YAAY;IACZ,OAAO;IACP,MAAM;IAEN,iBAAiB;IACjB,SAAS;IACT,mBAAmB;IACnB,gBAAgB;IAChB,SAAS;IACT,iBAAiB;IACjB,kBAAkB;IAClB,WAAW;IACX,WAAW;IAEX,2BAA2B;IAC3B,WAAW;IACX,WAAW;IACX,cAAc;IACd,WAAW;IAEX,oBAAoB;IACpB,WAAW;IACX,YAAY;IACZ,kBAAkB;IAClB,UAAU;IAEV,SAAS;IACT,yBAAyB;IAEzB,aAAa;IACb,iBAAiB;CAClB,CAAC;AAEF,gCAAgC;AAEhC,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC","sourcesContent":["/**\n * TwoStepVideo - Professional video editing for React Native\n * Built on native AVFoundation with Expo Modules\n */\n\nimport { type EventSubscription } from 'expo-modules-core';\nimport ExpoTwoStepVideoModule from './ExpoTwostepVideoModule';\n\n// MARK: - Types\n\n/**\n * Quality presets for video export\n */\nexport type VideoQuality = 'low' | 'medium' | 'high' | 'highest';\n\n/**\n * Mirror axis options for video mirroring\n */\nexport type MirrorAxis = 'horizontal' | 'vertical' | 'both';\n\n/**\n * Video asset metadata returned after loading\n */\nexport interface VideoAsset {\n  /** Unique identifier for this asset */\n  id: string;\n  /** Duration in seconds */\n  duration: number;\n  /** Video width in pixels */\n  width: number;\n  /** Video height in pixels */\n  height: number;\n  /** Frame rate (fps) */\n  frameRate: number;\n  /** Whether the video has audio */\n  hasAudio: boolean;\n}\n\n/**\n * Video composition metadata\n */\nexport interface VideoComposition {\n  /** Unique identifier for this composition */\n  id: string;\n  /** Total duration in seconds */\n  duration: number;\n}\n\n/**\n * Time segment for multi-segment trimming\n */\nexport interface TimeSegment {\n  /** Start time in seconds */\n  start: number;\n  /** End time in seconds */\n  end: number;\n}\n\n/**\n * Export result containing output file information\n */\nexport interface ExportResult {\n  /** File URI (e.g., \"file:///path/to/video.mp4\") */\n  uri: string;\n  /** Absolute file path */\n  path: string;\n}\n\n/**\n * Export progress event\n */\nexport interface ExportProgressEvent {\n  /** Progress from 0.0 to 1.0 */\n  progress: number;\n  /** Asset ID if exporting asset directly */\n  assetId?: string;\n  /** Composition ID if exporting composition */\n  compositionId?: string;\n}\n\n/**\n * Options for loading a video asset\n */\nexport interface LoadAssetOptions {\n  /** File URI (e.g., \"file:///path/to/video.mp4\") */\n  uri: string;\n}\n\n/**\n * Options for trimming a video\n */\nexport interface TrimVideoOptions {\n  /** Asset ID to trim */\n  assetId: string;\n  /** Start time in seconds */\n  startTime: number;\n  /** End time in seconds */\n  endTime: number;\n}\n\n/**\n * Options for multi-segment trimming\n */\nexport interface TrimMultipleOptions {\n  /** Asset ID to trim */\n  assetId: string;\n  /** Array of time segments to extract and concatenate */\n  segments: TimeSegment[];\n}\n\n/**\n * Options for generating thumbnails\n */\nexport interface GenerateThumbnailsOptions {\n  /** Asset ID to generate thumbnails from */\n  assetId: string;\n  /** Array of times (in seconds) to extract thumbnails */\n  times: number[];\n  /** Optional size for thumbnails */\n  size?: {\n    width: number;\n    height: number;\n  };\n}\n\n/**\n * Options for exporting a composition\n */\nexport interface ExportCompositionOptions {\n  /** Composition ID to export */\n  compositionId: string;\n  /** Optional output URI (uses temp directory if not provided) */\n  outputUri?: string;\n  /** Quality preset (default: 'high') */\n  quality?: VideoQuality;\n}\n\n/**\n * Options for exporting an asset directly\n */\nexport interface ExportAssetOptions {\n  /** Asset ID to export */\n  assetId: string;\n  /** Optional output URI (uses temp directory if not provided) */\n  outputUri?: string;\n  /** Quality preset (default: 'high') */\n  quality?: VideoQuality;\n}\n\n/**\n * Options for mirroring a video\n */\nexport interface MirrorVideoOptions {\n  /** Asset ID to mirror */\n  assetId: string;\n  /** Axis to mirror on: 'horizontal', 'vertical', or 'both' */\n  axis: MirrorAxis;\n  /** Optional start time in seconds (for segment mirroring) */\n  startTime?: number;\n  /** Optional end time in seconds (for segment mirroring) */\n  endTime?: number;\n}\n\n/**\n * Options for adjusting video speed\n */\nexport interface AdjustSpeedOptions {\n  /** Asset ID to adjust */\n  assetId: string;\n  /** Speed multiplier (0.25 = 4x slower, 2.0 = 2x faster) */\n  speed: number;\n  /** Optional start time in seconds */\n  startTime?: number;\n  /** Optional end time in seconds */\n  endTime?: number;\n}\n\n/**\n * Options for combined video transformation\n */\nexport interface TransformVideoOptions {\n  /** Asset ID to transform */\n  assetId: string;\n  /** Speed multiplier (default: 1.0) */\n  speed?: number;\n  /** Optional mirror axis */\n  mirrorAxis?: MirrorAxis;\n  /** Optional start time in seconds (for trimming) */\n  startTime?: number;\n  /** Optional end time in seconds (for trimming) */\n  endTime?: number;\n}\n\n/**\n * Options for looping a video segment\n */\nexport interface LoopSegmentOptions {\n  /** Asset ID to loop */\n  assetId: string;\n  /** Start time of the segment to loop (in seconds) */\n  startTime: number;\n  /** End time of the segment to loop (in seconds) */\n  endTime: number;\n  /** Number of times to repeat (total plays = loopCount + 1) */\n  loopCount: number;\n}\n\n/**\n * Result from looping a video segment\n */\nexport interface LoopResult {\n  /** Unique identifier for this composition */\n  id: string;\n  /** Total duration in seconds */\n  duration: number;\n  /** Number of times the segment repeats */\n  loopCount: number;\n  /** Total number of times the segment plays */\n  totalPlays: number;\n}\n\n// MARK: - Constants\n\n/**\n * Quality constants\n */\nexport const Quality = {\n  LOW: ExpoTwoStepVideoModule.QUALITY_LOW,\n  MEDIUM: ExpoTwoStepVideoModule.QUALITY_MEDIUM,\n  HIGH: ExpoTwoStepVideoModule.QUALITY_HIGH,\n  HIGHEST: ExpoTwoStepVideoModule.QUALITY_HIGHEST,\n} as const;\n\n/**\n * Mirror axis constants\n */\nexport const Mirror = {\n  HORIZONTAL: ExpoTwoStepVideoModule.MIRROR_HORIZONTAL,\n  VERTICAL: ExpoTwoStepVideoModule.MIRROR_VERTICAL,\n  BOTH: ExpoTwoStepVideoModule.MIRROR_BOTH,\n} as const;\n\n// MARK: - API Functions\n\n/**\n * Load a video asset from a file URI\n *\n * @param options - Load options containing the file URI\n * @returns Promise resolving to video asset metadata\n *\n * @example\n * ```typescript\n * const asset = await TwoStepVideo.loadAsset({\n *   uri: 'file:///path/to/video.mp4'\n * });\n * console.log(`Duration: ${asset.duration}s, Size: ${asset.width}x${asset.height}`);\n * ```\n */\nexport async function loadAsset(options: LoadAssetOptions): Promise<VideoAsset> {\n  return await ExpoTwoStepVideoModule.loadAsset(options.uri);\n}\n\n/**\n * Load a video asset from the Photos library\n *\n * @param localIdentifier - PHAsset local identifier from the Photos library\n * @returns Promise resolving to video asset metadata\n *\n * @example\n * ```typescript\n * // After using expo-media-library to get a photo asset\n * const asset = await TwoStepVideo.loadAssetFromPhotos(photoAsset.id);\n * ```\n */\nexport async function loadAssetFromPhotos(localIdentifier: string): Promise<VideoAsset> {\n  return await ExpoTwoStepVideoModule.loadAssetFromPhotos(localIdentifier);\n}\n\n/**\n * Validate a video file URI without loading the full asset\n * Useful for quick validation before processing\n *\n * @param uri - File URI to validate\n * @returns Promise resolving to true if valid video file\n *\n * @example\n * ```typescript\n * const isValid = await TwoStepVideo.validateVideoUri('file:///path/to/video.mp4');\n * if (isValid) {\n *   const asset = await TwoStepVideo.loadAsset({ uri });\n * }\n * ```\n */\nexport async function validateVideoUri(uri: string): Promise<boolean> {\n  return await ExpoTwoStepVideoModule.validateVideoUri(uri);\n}\n\n/**\n * Trim a video to a single time range\n *\n * @param options - Trim options including asset ID and time range\n * @returns Promise resolving to composition metadata\n *\n * @example\n * ```typescript\n * const asset = await TwoStepVideo.loadAsset({ uri });\n * const composition = await TwoStepVideo.trimVideo({\n *   assetId: asset.id,\n *   startTime: 5.0,\n *   endTime: 15.0\n * });\n * console.log(`Trimmed to ${composition.duration}s`);\n * ```\n */\nexport async function trimVideo(options: TrimVideoOptions): Promise<VideoComposition> {\n  return await ExpoTwoStepVideoModule.trimVideo(\n    options.assetId,\n    options.startTime,\n    options.endTime\n  );\n}\n\n/**\n * Trim a video to multiple segments and concatenate them\n *\n * @param options - Trim options including asset ID and segments\n * @returns Promise resolving to composition metadata\n *\n * @example\n * ```typescript\n * const composition = await TwoStepVideo.trimVideoMultiple({\n *   assetId: asset.id,\n *   segments: [\n *     { start: 0, end: 3 },    // First 3 seconds\n *     { start: 10, end: 13 },  // 3 seconds from middle\n *     { start: 20, end: 23 }   // 3 seconds from end\n *   ]\n * });\n * ```\n */\nexport async function trimVideoMultiple(options: TrimMultipleOptions): Promise<VideoComposition> {\n  return await ExpoTwoStepVideoModule.trimVideoMultiple(options.assetId, options.segments);\n}\n\n/**\n * Mirror a video horizontally, vertically, or both\n *\n * @param options - Mirror options including asset ID and axis\n * @returns Promise resolving to composition metadata\n *\n * @example\n * ```typescript\n * // Mirror horizontally (flip left-right, common for selfie videos)\n * const composition = await TwoStepVideo.mirrorVideo({\n *   assetId: asset.id,\n *   axis: 'horizontal'\n * });\n *\n * // Mirror a specific segment\n * const composition = await TwoStepVideo.mirrorVideo({\n *   assetId: asset.id,\n *   axis: 'vertical',\n *   startTime: 5,\n *   endTime: 10\n * });\n * ```\n */\nexport async function mirrorVideo(options: MirrorVideoOptions): Promise<VideoComposition> {\n  return await ExpoTwoStepVideoModule.mirrorVideo(\n    options.assetId,\n    options.axis,\n    options.startTime,\n    options.endTime\n  );\n}\n\n/**\n * Adjust the playback speed of a video\n *\n * @param options - Speed options including asset ID and speed multiplier\n * @returns Promise resolving to composition metadata\n *\n * @example\n * ```typescript\n * // Slow motion (0.5x speed = 2x slower)\n * const slowMo = await TwoStepVideo.adjustSpeed({\n *   assetId: asset.id,\n *   speed: 0.5\n * });\n *\n * // Fast forward (2x speed)\n * const fastForward = await TwoStepVideo.adjustSpeed({\n *   assetId: asset.id,\n *   speed: 2.0\n * });\n *\n * // Speed up a specific segment\n * const timelapse = await TwoStepVideo.adjustSpeed({\n *   assetId: asset.id,\n *   speed: 4.0,\n *   startTime: 10,\n *   endTime: 30\n * });\n * ```\n */\nexport async function adjustSpeed(options: AdjustSpeedOptions): Promise<VideoComposition> {\n  return await ExpoTwoStepVideoModule.adjustSpeed(\n    options.assetId,\n    options.speed,\n    options.startTime,\n    options.endTime\n  );\n}\n\n/**\n * Transform a video with combined trimming, mirroring, and speed adjustment\n * Use the player's `loop` prop for continuous playback looping\n *\n * @param options - Transform options including asset ID, speed, and mirror axis\n * @returns Promise resolving to composition metadata\n *\n * @example\n * ```typescript\n * // Mirror and slow down\n * const transformed = await TwoStepVideo.transformVideo({\n *   assetId: asset.id,\n *   speed: 0.5,\n *   mirrorAxis: 'horizontal'\n * });\n *\n * // Just mirror (speed defaults to 1.0)\n * const mirrored = await TwoStepVideo.transformVideo({\n *   assetId: asset.id,\n *   mirrorAxis: 'both'\n * });\n *\n * // Transform a specific segment (trim + mirror + speed)\n * const segment = await TwoStepVideo.transformVideo({\n *   assetId: asset.id,\n *   speed: 2.0,\n *   mirrorAxis: 'horizontal',\n *   startTime: 0,\n *   endTime: 5\n * });\n *\n * // Play in loop mode\n * <TwoStepVideoView compositionId={segment.id} loop />\n * ```\n */\nexport async function transformVideo(options: TransformVideoOptions): Promise<VideoComposition> {\n  return await ExpoTwoStepVideoModule.transformVideo(\n    options.assetId,\n    options.speed,\n    options.mirrorAxis,\n    options.startTime,\n    options.endTime\n  );\n}\n\n/**\n * Loop a segment of a video multiple times\n *\n * @param options - Loop options including segment time range and repeat count\n * @returns Promise resolving to loop result with duration info\n *\n * @example\n * ```typescript\n * // Loop a 2-second segment 3 times (plays 4 times total)\n * const looped = await TwoStepVideo.loopSegment({\n *   assetId: asset.id,\n *   startTime: 5,\n *   endTime: 7,\n *   loopCount: 3\n * });\n * console.log(`Duration: ${looped.duration}s (plays ${looped.totalPlays} times)`);\n *\n * // Create a perfect loop for social media\n * const perfectLoop = await TwoStepVideo.loopSegment({\n *   assetId: asset.id,\n *   startTime: 0,\n *   endTime: 3,\n *   loopCount: 4  // 15 seconds total (3s * 5 plays)\n * });\n * ```\n */\nexport async function loopSegment(options: LoopSegmentOptions): Promise<LoopResult> {\n  return await ExpoTwoStepVideoModule.loopSegment(\n    options.assetId,\n    options.startTime,\n    options.endTime,\n    options.loopCount\n  );\n}\n\n/**\n * Generate thumbnail images from a video at specific times\n *\n * @param options - Thumbnail generation options\n * @returns Promise resolving to array of base64 encoded PNG images\n *\n * @example\n * ```typescript\n * const thumbnails = await TwoStepVideo.generateThumbnails({\n *   assetId: asset.id,\n *   times: [1, 5, 10, 15],\n *   size: { width: 300, height: 300 }\n * });\n *\n * // Use in Image component\n * <Image source={{ uri: `data:image/png;base64,${thumbnails[0]}` }} />\n * ```\n */\nexport async function generateThumbnails(\n  options: GenerateThumbnailsOptions\n): Promise<string[]> {\n  return await ExpoTwoStepVideoModule.generateThumbnails(\n    options.assetId,\n    options.times,\n    options.size\n  );\n}\n\n/**\n * Export a composition to a video file\n *\n * @param options - Export options including composition ID and quality\n * @returns Promise resolving to export result with file URI\n *\n * @example\n * ```typescript\n * const result = await TwoStepVideo.exportVideo({\n *   compositionId: composition.id,\n *   quality: 'high'\n * });\n * console.log(`Exported to: ${result.uri}`);\n * ```\n */\nexport async function exportVideo(options: ExportCompositionOptions): Promise<ExportResult> {\n  return await ExpoTwoStepVideoModule.exportVideo(\n    options.compositionId,\n    options.outputUri,\n    options.quality\n  );\n}\n\n/**\n * Export an asset directly without creating a composition\n * Useful for re-encoding or changing quality without trimming\n *\n * @param options - Export options including asset ID and quality\n * @returns Promise resolving to export result with file URI\n *\n * @example\n * ```typescript\n * const result = await TwoStepVideo.exportAsset({\n *   assetId: asset.id,\n *   quality: 'medium'\n * });\n * ```\n */\nexport async function exportAsset(options: ExportAssetOptions): Promise<ExportResult> {\n  return await ExpoTwoStepVideoModule.exportAsset(\n    options.assetId,\n    options.outputUri,\n    options.quality\n  );\n}\n\n/**\n * Clean up a temporary file\n * Call this after you're done with exported files in the temp directory\n *\n * @param uri - File URI to clean up\n *\n * @example\n * ```typescript\n * const result = await TwoStepVideo.exportVideo({ ... });\n * // ... do something with result.uri\n * TwoStepVideo.cleanupFile(result.uri);\n * ```\n */\nexport function cleanupFile(uri: string): void {\n  ExpoTwoStepVideoModule.cleanupFile(uri);\n}\n\n/**\n * Release an asset from memory\n * Call this when you're done with an asset to free up memory\n *\n * @param assetId - ID of the asset to release\n */\nexport function releaseAsset(assetId: string): void {\n  ExpoTwoStepVideoModule.releaseAsset(assetId);\n}\n\n/**\n * Release a composition from memory\n *\n * @param compositionId - ID of the composition to release\n */\nexport function releaseComposition(compositionId: string): void {\n  ExpoTwoStepVideoModule.releaseComposition(compositionId);\n}\n\n/**\n * Release all cached assets and compositions\n * Useful for cleanup when unmounting screens\n */\nexport function releaseAll(): void {\n  ExpoTwoStepVideoModule.releaseAll();\n}\n\n// MARK: - Event Listeners\n\n/**\n * Add a listener for export progress events\n *\n * @param listener - Callback function receiving progress events\n * @returns Subscription object with remove() method\n *\n * @example\n * ```typescript\n * const subscription = TwoStepVideo.addExportProgressListener((event) => {\n *   console.log(`Export progress: ${Math.round(event.progress * 100)}%`);\n *   setProgress(event.progress);\n * });\n *\n * // Later, remove the listener\n * subscription.remove();\n * ```\n */\nexport function addExportProgressListener(\n  listener: (event: ExportProgressEvent) => void\n): EventSubscription {\n  return ExpoTwoStepVideoModule.addListener('onExportProgress', listener);\n}\n\n// MARK: - Helper Hook (for React)\n\n/**\n * React hook for managing export progress\n * Only works in React components\n *\n * @returns Current export progress (0.0 to 1.0)\n *\n * @example\n * ```typescript\n * function VideoEditor() {\n *   const progress = useExportProgress();\n *\n *   return (\n *     <View>\n *       <Text>Export Progress: {Math.round(progress * 100)}%</Text>\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useExportProgress(): number {\n  const [progress, setProgress] = React.useState(0);\n\n  React.useEffect(() => {\n    const subscription = addExportProgressListener((event) => {\n      setProgress(event.progress);\n    });\n\n    return () => subscription.remove();\n  }, []);\n\n  return progress;\n}\n\n// Note: React import needed for the hook\n// If React is not available, the hook won't be usable but\n// the rest of the module will work fine\nlet React: any;\ntry {\n  React = require('react');\n} catch {\n  // React not available, hook won't work\n}\n\n// MARK: - Exports\n\nexport default {\n  // Constants\n  Quality,\n  Mirror,\n\n  // Core functions\n  loadAsset,\n  loadAssetFromPhotos,\n  validateVideoUri,\n  trimVideo,\n  trimVideoMultiple,\n  generateThumbnails,\n  exportVideo,\n  exportAsset,\n\n  // Transformation functions\n  mirrorVideo,\n  adjustSpeed,\n  transformVideo,\n  loopSegment,\n\n  // Memory management\n  cleanupFile,\n  releaseAsset,\n  releaseComposition,\n  releaseAll,\n\n  // Events\n  addExportProgressListener,\n\n  // React hook\n  useExportProgress,\n};\n\n// MARK: - View Component Export\n\nexport { default as TwoStepVideoView } from './ExpoTwostepVideoView';\nexport type {\n  TwoStepVideoViewProps,\n  TwoStepVideoViewRef,\n  PlaybackStatusEvent,\n  ProgressEvent,\n  ErrorEvent,\n} from './ExpoTwostepVideo.types';\n"]}

package/expo-module.config.json

@@ -0,0 +1,10 @@
+{
+  "platforms": ["apple", "android", "web"],
+  "apple": {
+    "modules": ["ExpoTwoStepVideoModule"],
+    "podspecPath": "ios/ExpoTwostepVideo.podspec"
+  },
+  "android": {
+    "modules": ["expo.modules.twostepvideo.ExpoTwoStepVideoModule"]
+  }
+}

package/ios/ExpoTwostepVideo.podspec

@@ -0,0 +1,30 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name           = 'ExpoTwostepVideo'
+  s.version        = package['version']
+  s.summary        = package['description']
+  s.description    = package['description']
+  s.license        = package['license']
+  s.author         = package['author']
+  s.homepage       = package['homepage']
+  s.platforms      = {
+    :ios => '16.0',
+    :tvos => '16.0'
+  }
+  s.swift_version  = '5.9'
+  s.source         = { git: 'https://github.com/rguo123/twostep-video' }
+  s.static_framework = true
+
+  s.dependency 'ExpoModulesCore'
+
+  # Swift/Objective-C compatibility
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+  }
+
+  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
+  s.exclude_files = ["Tests/**/*", ".build/**/*", "Package.swift"]
+end