react-native-rn-story-editor 0.2.1 → 0.2.2

package/android/src/main/java/com/rnstoryeditor/StoryEditorErrors.kt

@@ -0,0 +1,169 @@
+package com.rnstoryeditor
+
+/**
+ * Error codes for Story Editor operations
+ * Matches the TypeScript error codes for consistency
+ */
+object StoryEditorErrorCodes {
+    const val NATIVE_MODULE_NOT_FOUND = "NATIVE_MODULE_NOT_FOUND"
+    const val VIEW_MANAGER_NOT_FOUND = "VIEW_MANAGER_NOT_FOUND"
+    const val INVALID_REF = "INVALID_REF"
+    const val NODE_HANDLE_NOT_FOUND = "NODE_HANDLE_NOT_FOUND"
+    const val COMMAND_NOT_SUPPORTED = "COMMAND_NOT_SUPPORTED"
+    const val IMAGE_EXPORT_FAILED = "IMAGE_EXPORT_FAILED"
+    const val INVALID_BASE64 = "INVALID_BASE64"
+    const val INVALID_COLOR = "INVALID_COLOR"
+    const val LAYER_OPERATION_FAILED = "LAYER_OPERATION_FAILED"
+    const val TEXT_INPUT_FAILED = "TEXT_INPUT_FAILED"
+    const val PLATFORM_NOT_SUPPORTED = "PLATFORM_NOT_SUPPORTED"
+    const val INITIALIZATION_FAILED = "INITIALIZATION_FAILED"
+    const val UNKNOWN_ERROR = "UNKNOWN_ERROR"
+    const val BITMAP_DECODE_FAILED = "BITMAP_DECODE_FAILED"
+    const val FILE_SAVE_FAILED = "FILE_SAVE_FAILED"
+    const val MEMORY_ERROR = "MEMORY_ERROR"
+}
+
+/**
+ * Data class representing a Story Editor error
+ */
+data class StoryEditorError(
+    val code: String,
+    val message: String,
+    val nativeError: Throwable? = null
+) : Exception(message, nativeError) {
+    
+    companion object {
+        fun nativeModuleNotFound(platform: String): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.NATIVE_MODULE_NOT_FOUND,
+                "RnStoryEditor native module not found for platform: $platform. " +
+                "Please ensure the library is properly linked. " +
+                "Run 'cd android && ./gradlew clean' and rebuild."
+            )
+        }
+        
+        fun viewManagerNotFound(): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.VIEW_MANAGER_NOT_FOUND,
+                "RnStoryEditorView native component not found. " +
+                "Ensure the app was rebuilt after installing the library. " +
+                "Run 'cd android && ./gradlew clean && ./gradlew assembleDebug'"
+            )
+        }
+        
+        fun invalidBase64(): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.INVALID_BASE64,
+                "Invalid base64 image data provided. " +
+                "Ensure the base64 string is properly formatted " +
+                "and includes the data URI prefix (e.g., data:image/png;base64,)"
+            )
+        }
+        
+        fun invalidColor(color: String): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.INVALID_COLOR,
+                "Invalid color value: \"$color\". " +
+                "Use hex format (#RRGGBB or #RRGGBBAA) or React Native color constants."
+            )
+        }
+        
+        fun bitmapDecodeFailed(reason: String): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.BITMAP_DECODE_FAILED,
+                "Failed to decode bitmap: $reason. " +
+                "Ensure the image data is valid and not corrupted."
+            )
+        }
+        
+        fun imageExportFailed(reason: String, cause: Throwable? = null): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.IMAGE_EXPORT_FAILED,
+                "Failed to export image: $reason. " +
+                "Common causes: no content to export, insufficient memory, or invalid base64 data.",
+                cause
+            )
+        }
+        
+        fun fileSaveFailed(reason: String, cause: Throwable? = null): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.FILE_SAVE_FAILED,
+                "Failed to save image to gallery: $reason. " +
+                "Check storage permissions and available space.",
+                cause
+            )
+        }
+        
+        fun memoryError(operation: String, cause: OutOfMemoryError): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.MEMORY_ERROR,
+                "Out of memory during $operation. " +
+                "Try reducing image size or closing other apps.",
+                cause
+            )
+        }
+        
+        fun layerOperationFailed(operation: String, reason: String): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.LAYER_OPERATION_FAILED,
+                "Failed to $operation layer: $reason. " +
+                "Ensure the layer exists and the editor is properly initialized."
+            )
+        }
+        
+        fun textInputFailed(reason: String): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.TEXT_INPUT_FAILED,
+                "Text input operation failed: $reason. " +
+                "Check that the editor has focus and text layers are enabled."
+            )
+        }
+        
+        fun unknownError(operation: String, cause: Throwable): StoryEditorError {
+            return StoryEditorError(
+                StoryEditorErrorCodes.UNKNOWN_ERROR,
+                "Unexpected error during $operation: ${cause.message}",
+                cause
+            )
+        }
+    }
+}
+
+/**
+ * Result type for operations that can fail
+ */
+sealed class StoryEditorResult<out T> {
+    data class Success<T>(val data: T) : StoryEditorResult<T>()
+    data class Error(val error: StoryEditorError) : StoryEditorResult<Nothing>()
+}
+
+/**
+ * Extension function to handle Result with callbacks
+ */
+inline fun <T> StoryEditorResult<T>.onSuccess(action: (T) -> Unit): StoryEditorResult<T> {
+    if (this is StoryEditorResult.Success) action(data)
+    return this
+}
+
+inline fun <T> StoryEditorResult<T>.onError(action: (StoryEditorError) -> Unit): StoryEditorResult<T> {
+    if (this is StoryEditorResult.Error) action(error)
+    return this
+}
+
+/**
+ * Wraps a block in try-catch with proper error conversion
+ */
+inline fun <T> safeStoryEditorCall(
+    operation: String,
+    block: () -> T
+): StoryEditorResult<T> {
+    return try {
+        StoryEditorResult.Success(block())
+    } catch (e: OutOfMemoryError) {
+        StoryEditorResult.Error(StoryEditorError.memoryError(operation, e))
+    } catch (e: StoryEditorError) {
+        StoryEditorResult.Error(e)
+    } catch (e: Exception) {
+        StoryEditorResult.Error(StoryEditorError.unknownError(operation, e))
+    }
+}

package/lib/module/errors.js

@@ -0,0 +1,89 @@
+"use strict";
+
+/**
+ * Error types for React Native Story Editor
+ * Provides specific error classes for different failure scenarios
+ */
+
+export class StoryEditorError extends Error {
+  constructor(message, code, nativeError) {
+    super(message);
+    this.code = code;
+    this.nativeError = nativeError;
+    this.name = 'StoryEditorError';
+    Object.setPrototypeOf(this, StoryEditorError.prototype);
+  }
+}
+export class NativeModuleNotFoundError extends StoryEditorError {
+  constructor(platform) {
+    super(`RnStoryEditor native module not found for platform: ${platform}. ` + `Please ensure the library is properly linked. ` + `Run 'cd android && ./gradlew clean' and rebuild.`, 'NATIVE_MODULE_NOT_FOUND');
+    this.name = 'NativeModuleNotFoundError';
+  }
+}
+export class ViewManagerNotFoundError extends StoryEditorError {
+  constructor() {
+    super('RnStoryEditorView native component not found. ' + 'Ensure the app was rebuilt after installing the library. ' + 'For iOS: cd ios && pod install. For Android: cd android && ./gradlew clean', 'VIEW_MANAGER_NOT_FOUND');
+    this.name = 'ViewManagerNotFoundError';
+  }
+}
+export class InvalidRefError extends StoryEditorError {
+  constructor(operation) {
+    super(`Cannot ${operation}: Invalid or null component ref. ` + `Ensure the ref is properly attached to a StoryEditorView component. ` + `Example: <StoryEditorView ref={editorRef} />`, 'INVALID_REF');
+    this.name = 'InvalidRefError';
+  }
+}
+export class NodeHandleNotFoundError extends StoryEditorError {
+  constructor() {
+    super('Could not find node handle for StoryEditorView. ' + 'The component may not be mounted yet. ' + 'Wait for onLayout or use a timeout.', 'NODE_HANDLE_NOT_FOUND');
+    this.name = 'NodeHandleNotFoundError';
+  }
+}
+export class CommandNotSupportedError extends StoryEditorError {
+  constructor(command, platform) {
+    super(`Command '${command}' is not supported on ${platform}. ` + `This may indicate an outdated native implementation. ` + `Please update to the latest version of react-native-rn-story-editor.`, 'COMMAND_NOT_SUPPORTED');
+    this.name = 'CommandNotSupportedError';
+  }
+}
+export class ImageExportError extends StoryEditorError {
+  constructor(reason, nativeError) {
+    super(`Failed to export image: ${reason}. ` + `Common causes: no content to export, insufficient memory, or invalid base64 data.`, 'IMAGE_EXPORT_FAILED', nativeError);
+    this.name = 'ImageExportError';
+  }
+}
+export class InvalidBase64Error extends StoryEditorError {
+  constructor() {
+    super('Invalid base64 image data provided. ' + 'Ensure the base64 string is properly formatted and includes the data URI prefix (e.g., data:image/png;base64,)', 'INVALID_BASE64');
+    this.name = 'InvalidBase64Error';
+  }
+}
+export class InvalidColorError extends StoryEditorError {
+  constructor(color) {
+    super(`Invalid color value: "${color}". ` + `Use hex format (#RRGGBB or #RRGGBBAA) or React Native color constants.`, 'INVALID_COLOR');
+    this.name = 'InvalidColorError';
+  }
+}
+export class LayerOperationError extends StoryEditorError {
+  constructor(operation, reason) {
+    super(`Failed to ${operation} layer: ${reason}. ` + `Ensure the layer exists and the editor is properly initialized.`, 'LAYER_OPERATION_FAILED');
+    this.name = 'LayerOperationError';
+  }
+}
+export class TextInputError extends StoryEditorError {
+  constructor(reason) {
+    super(`Text input operation failed: ${reason}. ` + `Check that the editor has focus and text layers are enabled.`, 'TEXT_INPUT_FAILED');
+    this.name = 'TextInputError';
+  }
+}
+export class PlatformNotSupportedError extends StoryEditorError {
+  constructor(platform) {
+    super(`Platform '${platform}' is not supported. ` + `This library only supports iOS and Android.`, 'PLATFORM_NOT_SUPPORTED');
+    this.name = 'PlatformNotSupportedError';
+  }
+}
+export class InitializationError extends StoryEditorError {
+  constructor(reason) {
+    super(`StoryEditor initialization failed: ${reason}. ` + `Try clearing caches: watchman watch-del-all && rm -rf node_modules && npm install`, 'INITIALIZATION_FAILED');
+    this.name = 'InitializationError';
+  }
+}
+//# sourceMappingURL=errors.js.map

package/lib/module/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StoryEditorError","Error","constructor","message","code","nativeError","name","Object","setPrototypeOf","prototype","NativeModuleNotFoundError","platform","ViewManagerNotFoundError","InvalidRefError","operation","NodeHandleNotFoundError","CommandNotSupportedError","command","ImageExportError","reason","InvalidBase64Error","InvalidColorError","color","LayerOperationError","TextInputError","PlatformNotSupportedError","InitializationError"],"sourceRoot":"../../src","sources":["errors.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,OAAO,MAAMA,gBAAgB,SAASC,KAAK,CAAC;EAC1CC,WAAWA,CACTC,OAAe,EACRC,IAAY,EACZC,WAAiB,EACxB;IACA,KAAK,CAACF,OAAO,CAAC;IAAC,KAHRC,IAAY,GAAZA,IAAY;IAAA,KACZC,WAAiB,GAAjBA,WAAiB;IAGxB,IAAI,CAACC,IAAI,GAAG,kBAAkB;IAC9BC,MAAM,CAACC,cAAc,CAAC,IAAI,EAAER,gBAAgB,CAACS,SAAS,CAAC;EACzD;AACF;AAEA,OAAO,MAAMC,yBAAyB,SAASV,gBAAgB,CAAC;EAC9DE,WAAWA,CAACS,QAAgB,EAAE;IAC5B,KAAK,CACH,uDAAuDA,QAAQ,IAAI,GACjE,gDAAgD,GAChD,kDAAkD,EACpD,yBACF,CAAC;IACD,IAAI,CAACL,IAAI,GAAG,2BAA2B;EACzC;AACF;AAEA,OAAO,MAAMM,wBAAwB,SAASZ,gBAAgB,CAAC;EAC7DE,WAAWA,CAAA,EAAG;IACZ,KAAK,CACH,gDAAgD,GAC9C,2DAA2D,GAC3D,4EAA4E,EAC9E,wBACF,CAAC;IACD,IAAI,CAACI,IAAI,GAAG,0BAA0B;EACxC;AACF;AAEA,OAAO,MAAMO,eAAe,SAASb,gBAAgB,CAAC;EACpDE,WAAWA,CAACY,SAAiB,EAAE;IAC7B,KAAK,CACH,UAAUA,SAAS,mCAAmC,GACpD,sEAAsE,GACtE,8CAA8C,EAChD,aACF,CAAC;IACD,IAAI,CAACR,IAAI,GAAG,iBAAiB;EAC/B;AACF;AAEA,OAAO,MAAMS,uBAAuB,SAASf,gBAAgB,CAAC;EAC5DE,WAAWA,CAAA,EAAG;IACZ,KAAK,CACH,kDAAkD,GAChD,wCAAwC,GACxC,qCAAqC,EACvC,uBACF,CAAC;IACD,IAAI,CAACI,IAAI,GAAG,yBAAyB;EACvC;AACF;AAEA,OAAO,MAAMU,wBAAwB,SAAShB,gBAAgB,CAAC;EAC7DE,WAAWA,CAACe,OAAe,EAAEN,QAAgB,EAAE;IAC7C,KAAK,CACH,YAAYM,OAAO,yBAAyBN,QAAQ,IAAI,GACtD,uDAAuD,GACvD,sEAAsE,EACxE,uBACF,CAAC;IACD,IAAI,CAACL,IAAI,GAAG,0BAA0B;EACxC;AACF;AAEA,OAAO,MAAMY,gBAAgB,SAASlB,gBAAgB,CAAC;EACrDE,WAAWA,CAACiB,MAAc,EAAEd,WAAiB,EAAE;IAC7C,KAAK,CACH,2BAA2Bc,MAAM,IAAI,GACnC,mFAAmF,EACrF,qBAAqB,EACrBd,WACF,CAAC;IACD,IAAI,CAACC,IAAI,GAAG,kBAAkB;EAChC;AACF;AAEA,OAAO,MAAMc,kBAAkB,SAASpB,gBAAgB,CAAC;EACvDE,WAAWA,CAAA,EAAG;IACZ,KAAK,CACH,sCAAsC,GACpC,gHAAgH,EAClH,gBACF,CAAC;IACD,IAAI,CAACI,IAAI,GAAG,oBAAoB;EAClC;AACF;AAEA,OAAO,MAAMe,iBAAiB,SAASrB,gBAAgB,CAAC;EACtDE,WAAWA,CAACoB,KAAa,EAAE;IACzB,KAAK,CACH,yBAAyBA,KAAK,KAAK,GACjC,wEAAwE,EAC1E,eACF,CAAC;IACD,IAAI,CAAChB,IAAI,GAAG,mBAAmB;EACjC;AACF;AAEA,OAAO,MAAMiB,mBAAmB,SAASvB,gBAAgB,CAAC;EACxDE,WAAWA,CAACY,SAAiB,EAAEK,MAAc,EAAE;IAC7C,KAAK,CACH,aAAaL,SAAS,WAAWK,MAAM,IAAI,GACzC,iEAAiE,EACnE,wBACF,CAAC;IACD,IAAI,CAACb,IAAI,GAAG,qBAAqB;EACnC;AACF;AAEA,OAAO,MAAMkB,cAAc,SAASxB,gBAAgB,CAAC;EACnDE,WAAWA,CAACiB,MAAc,EAAE;IAC1B,KAAK,CACH,gCAAgCA,MAAM,IAAI,GACxC,8DAA8D,EAChE,mBACF,CAAC;IACD,IAAI,CAACb,IAAI,GAAG,gBAAgB;EAC9B;AACF;AAEA,OAAO,MAAMmB,yBAAyB,SAASzB,gBAAgB,CAAC;EAC9DE,WAAWA,CAACS,QAAgB,EAAE;IAC5B,KAAK,CACH,aAAaA,QAAQ,sBAAsB,GACzC,6CAA6C,EAC/C,wBACF,CAAC;IACD,IAAI,CAACL,IAAI,GAAG,2BAA2B;EACzC;AACF;AAEA,OAAO,MAAMoB,mBAAmB,SAAS1B,gBAAgB,CAAC;EACxDE,WAAWA,CAACiB,MAAc,EAAE;IAC1B,KAAK,CACH,sCAAsCA,MAAM,IAAI,GAC9C,mFAAmF,EACrF,uBACF,CAAC;IACD,IAAI,CAACb,IAAI,GAAG,qBAAqB;EACnC;AACF","ignoreList":[]}

package/lib/module/index.js

@@ -1,39 +1,199 @@
 "use strict";
 
-import { requireNativeComponent, UIManager, findNodeHandle } from 'react-native';
+import { requireNativeComponent, UIManager, findNodeHandle, Platform } from 'react-native';
+import { StoryEditorError, ViewManagerNotFoundError, InvalidRefError, NodeHandleNotFoundError, CommandNotSupportedError, InvalidBase64Error, InvalidColorError, PlatformNotSupportedError } from "./errors.js";
 const COMPONENT_NAME = 'RnStoryEditorView';
 
+// Extended native props with event callbacks
+
 // Type definition for view manager commands
 
-export const StoryEditorView = requireNativeComponent(COMPONENT_NAME);
+/**
+ * Validates a base64 image string
+ * @param base64 - The base64 string to validate
+ * @throws InvalidBase64Error if the string is invalid
+ */
+function validateBase64(base64) {
+  if (base64 === undefined || base64 === null) {
+    return; // Optional prop
+  }
+  if (typeof base64 !== 'string') {
+    throw new InvalidBase64Error();
+  }
+
+  // Check for data URI prefix and remove it for validation
+  let cleanBase64 = base64;
+  if (base64.includes(',')) {
+    const parts = base64.split(',');
+    if (parts.length !== 2 || !parts[1]) {
+      throw new InvalidBase64Error();
+    }
+    cleanBase64 = parts[1];
+  }
+
+  // Validate base64 characters
+  const base64Regex = /^[A-Za-z0-9+/]*={0,2}$/;
+  if (!base64Regex.test(cleanBase64)) {
+    throw new InvalidBase64Error();
+  }
+}
+
+/**
+ * Validates a color value
+ * @param color - The color string to validate
+ * @throws InvalidColorError if the color is invalid
+ */
+function validateColor(color) {
+  if (color === undefined || color === null) {
+    return;
+  }
+  if (typeof color !== 'string') {
+    throw new InvalidColorError(String(color));
+  }
+
+  // Hex color validation (#RGB, #RRGGBB, #RRGGBBAA)
+  const hexRegex = /^#([0-9A-Fa-f]{3}|[0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/;
+  if (!hexRegex.test(color)) {
+    throw new InvalidColorError(color);
+  }
+}
+
+/**
+ * Validates platform support
+ * @throws PlatformNotSupportedError if platform is not iOS or Android
+ */
+function validatePlatform() {
+  if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+    throw new PlatformNotSupportedError(Platform.OS);
+  }
+}
+
+/**
+ * Gets view manager configuration with error handling
+ * @returns View manager config or throws ViewManagerNotFoundError
+ */
+function getViewManagerConfig() {
+  validatePlatform();
+  const config = UIManager.getViewManagerConfig(COMPONENT_NAME);
+  if (!config) {
+    throw new ViewManagerNotFoundError();
+  }
+  return config;
+}
+
+/**
+ * Gets node handle from component ref with validation
+ * @param ref - Component ref
+ * @param operation - Operation name for error messages
+ * @returns Node handle number
+ * @throws InvalidRefError or NodeHandleNotFoundError
+ */
+function getNodeHandle(ref, operation) {
+  if (!ref || typeof ref !== 'object') {
+    throw new InvalidRefError(operation);
+  }
+  const nodeHandle = findNodeHandle(ref);
+  if (nodeHandle == null) {
+    throw new NodeHandleNotFoundError();
+  }
+  return nodeHandle;
+}
+
+/**
+ * Validates that a command is supported
+ * @param _config - View manager config (for future use)
+ * @param command - Command name
+ * @param commandId - Command ID from config
+ * @throws CommandNotSupportedError if command not available
+ */
+function validateCommand(_config, command, commandId) {
+  if (commandId === undefined || commandId === null) {
+    throw new CommandNotSupportedError(command, Platform.OS);
+  }
+}
 
-// Enhanced Commands with additional functionality
+/**
+ * Commands for controlling the StoryEditorView
+ *
+ * @example
+ * const editorRef = useRef(null);
+ *
+ * // Export image
+ * StoryEditorCommands.exportImage(editorRef.current);
+ *
+ * // Show text input
+ * StoryEditorCommands.showTextInput(editorRef.current);
+ */
 export const StoryEditorCommands = {
+  /**
+   * Exports the current canvas as a base64 encoded image
+   * @param ref - Reference to the StoryEditorView component
+   * @throws {InvalidRefError} If ref is invalid
+   * @throws {NodeHandleNotFoundError} If component is not mounted
+   * @throws {CommandNotSupportedError} If command not supported on platform
+   * @throws {ViewManagerNotFoundError} If native module not found
+   */
   exportImage: ref => {
-    const viewManagerConfig = UIManager.getViewManagerConfig(COMPONENT_NAME);
-    if (viewManagerConfig?.Commands?.exportImage) {
-      const nodeHandle = findNodeHandle(ref);
-      if (nodeHandle != null) {
-        UIManager.dispatchViewManagerCommand(nodeHandle, viewManagerConfig.Commands.exportImage, []);
+    try {
+      const viewManagerConfig = getViewManagerConfig();
+      const commandId = viewManagerConfig.Commands?.exportImage;
+      validateCommand(viewManagerConfig, 'exportImage', commandId);
+      const nodeHandle = getNodeHandle(ref, 'export image');
+      UIManager.dispatchViewManagerCommand(nodeHandle, commandId, []);
+    } catch (error) {
+      if (error instanceof StoryEditorError) {
+        throw error;
       }
+      throw new StoryEditorError(`Unexpected error during exportImage: ${error}`, 'UNKNOWN_ERROR', error);
     }
   },
+  /**
+   * Shows the text input overlay for adding text layers
+   * @param ref - Reference to the StoryEditorView component
+   * @throws {InvalidRefError} If ref is invalid
+   * @throws {NodeHandleNotFoundError} If component is not mounted
+   * @throws {CommandNotSupportedError} If command not supported on platform
+   * @throws {ViewManagerNotFoundError} If native module not found
+   */
   showTextInput: ref => {
-    const viewManagerConfig = UIManager.getViewManagerConfig(COMPONENT_NAME);
-    if (viewManagerConfig?.Commands?.showTextInput) {
-      const nodeHandle = findNodeHandle(ref);
-      if (nodeHandle != null) {
-        UIManager.dispatchViewManagerCommand(nodeHandle, viewManagerConfig.Commands.showTextInput, []);
+    try {
+      const viewManagerConfig = getViewManagerConfig();
+      const commandId = viewManagerConfig.Commands?.showTextInput;
+      validateCommand(viewManagerConfig, 'showTextInput', commandId);
+      const nodeHandle = getNodeHandle(ref, 'show text input');
+      UIManager.dispatchViewManagerCommand(nodeHandle, commandId, []);
+    } catch (error) {
+      if (error instanceof StoryEditorError) {
+        throw error;
       }
+      throw new StoryEditorError(`Unexpected error during showTextInput: ${error}`, 'UNKNOWN_ERROR', error);
     }
   }
 };
 
-// Event listener for export results
-export const addExportImageListener = _callback => {
-  // This would be implemented with proper event handling
-  console.warn('Event listener not yet implemented. Use native export dialog instead.');
-};
+/**
+ * Validates props before passing to native component
+ * @param props - Props to validate
+ * @throws {InvalidColorError} If color is invalid
+ * @throws {InvalidBase64Error} If base64 image data is invalid
+ */
+export function validateProps(props) {
+  if (props.colorString) {
+    validateColor(props.colorString);
+  }
+  if (props.baseImage) {
+    validateBase64(props.baseImage);
+  }
+  if (props.addImage) {
+    validateBase64(props.addImage);
+  }
+}
 
-// Export types for TypeScript users
+// Re-export error types
+export { StoryEditorError, NativeModuleNotFoundError, ViewManagerNotFoundError, InvalidRefError, NodeHandleNotFoundError, CommandNotSupportedError, ImageExportError, InvalidBase64Error, InvalidColorError, LayerOperationError, TextInputError, PlatformNotSupportedError, InitializationError } from "./errors.js";
+
+// Export types
+
+// Export the native view component
+export const StoryEditorView = requireNativeComponent(COMPONENT_NAME);
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["requireNativeComponent","UIManager","findNodeHandle","COMPONENT_NAME","StoryEditorView","StoryEditorCommands","exportImage","ref","viewManagerConfig","getViewManagerConfig","Commands","nodeHandle","dispatchViewManagerCommand","showTextInput","addExportImageListener","_callback","console","warn"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,sBAAsB,EAAEC,SAAS,EAAEC,cAAc,QAAQ,cAAc;AAGhF,MAAMC,cAAc,GAAG,mBAAmB;;AAE1C;;AAUA,OAAO,MAAMC,eAAe,GAAGJ,sBAAsB,CAAcG,cAAc,CAAC;;AAElF;AACA,OAAO,MAAME,mBAAmB,GAAG;EACjCC,WAAW,EAAGC,GAAQ,IAAK;IACzB,MAAMC,iBAAiB,GAAGP,SAAS,CAACQ,oBAAoB,CAACN,cAAc,CAA6B;IACpG,IAAIK,iBAAiB,EAAEE,QAAQ,EAAEJ,WAAW,EAAE;MAC5C,MAAMK,UAAU,GAAGT,cAAc,CAACK,GAAG,CAAC;MACtC,IAAII,UAAU,IAAI,IAAI,EAAE;QACtBV,SAAS,CAACW,0BAA0B,CAClCD,UAAU,EACVH,iBAAiB,CAACE,QAAQ,CAACJ,WAAW,EACtC,EACF,CAAC;MACH;IACF;EACF,CAAC;EAEDO,aAAa,EAAGN,GAAQ,IAAK;IAC3B,MAAMC,iBAAiB,GAAGP,SAAS,CAACQ,oBAAoB,CAACN,cAAc,CAA6B;IACpG,IAAIK,iBAAiB,EAAEE,QAAQ,EAAEG,aAAa,EAAE;MAC9C,MAAMF,UAAU,GAAGT,cAAc,CAACK,GAAG,CAAC;MACtC,IAAII,UAAU,IAAI,IAAI,EAAE;QACtBV,SAAS,CAACW,0BAA0B,CAClCD,UAAU,EACVH,iBAAiB,CAACE,QAAQ,CAACG,aAAa,EACxC,EACF,CAAC;MACH;IACF;EACF;AACF,CAAC;;AAED;AACA,OAAO,MAAMC,sBAAsB,GAAIC,SAAmC,IAAK;EAC7E;EACAC,OAAO,CAACC,IAAI,CAAC,uEAAuE,CAAC;AACvF,CAAC;;AAED","ignoreList":[]}
+{"version":3,"names":["requireNativeComponent","UIManager","findNodeHandle","Platform","StoryEditorError","ViewManagerNotFoundError","InvalidRefError","NodeHandleNotFoundError","CommandNotSupportedError","InvalidBase64Error","InvalidColorError","PlatformNotSupportedError","COMPONENT_NAME","validateBase64","base64","undefined","cleanBase64","includes","parts","split","length","base64Regex","test","validateColor","color","String","hexRegex","validatePlatform","OS","getViewManagerConfig","config","getNodeHandle","ref","operation","nodeHandle","validateCommand","_config","command","commandId","StoryEditorCommands","exportImage","viewManagerConfig","Commands","dispatchViewManagerCommand","error","showTextInput","validateProps","props","colorString","baseImage","addImage","NativeModuleNotFoundError","ImageExportError","LayerOperationError","TextInputError","InitializationError","StoryEditorView"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,46 @@
+/**
+ * Error types for React Native Story Editor
+ * Provides specific error classes for different failure scenarios
+ */
+export declare class StoryEditorError extends Error {
+    code: string;
+    nativeError?: any | undefined;
+    constructor(message: string, code: string, nativeError?: any | undefined);
+}
+export declare class NativeModuleNotFoundError extends StoryEditorError {
+    constructor(platform: string);
+}
+export declare class ViewManagerNotFoundError extends StoryEditorError {
+    constructor();
+}
+export declare class InvalidRefError extends StoryEditorError {
+    constructor(operation: string);
+}
+export declare class NodeHandleNotFoundError extends StoryEditorError {
+    constructor();
+}
+export declare class CommandNotSupportedError extends StoryEditorError {
+    constructor(command: string, platform: string);
+}
+export declare class ImageExportError extends StoryEditorError {
+    constructor(reason: string, nativeError?: any);
+}
+export declare class InvalidBase64Error extends StoryEditorError {
+    constructor();
+}
+export declare class InvalidColorError extends StoryEditorError {
+    constructor(color: string);
+}
+export declare class LayerOperationError extends StoryEditorError {
+    constructor(operation: string, reason: string);
+}
+export declare class TextInputError extends StoryEditorError {
+    constructor(reason: string);
+}
+export declare class PlatformNotSupportedError extends StoryEditorError {
+    constructor(platform: string);
+}
+export declare class InitializationError extends StoryEditorError {
+    constructor(reason: string);
+}
+//# 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,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,IAAI,EAAE,MAAM;IACZ,WAAW,CAAC,EAAE,GAAG;gBAFxB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,GAAG,YAAA;CAM3B;AAED,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,QAAQ,EAAE,MAAM;CAS7B;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;;CAU7D;AAED,qBAAa,eAAgB,SAAQ,gBAAgB;gBACvC,SAAS,EAAE,MAAM;CAS9B;AAED,qBAAa,uBAAwB,SAAQ,gBAAgB;;CAU5D;AAED,qBAAa,wBAAyB,SAAQ,gBAAgB;gBAChD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAS9C;AAED,qBAAa,gBAAiB,SAAQ,gBAAgB;gBACxC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,GAAG;CAS9C;AAED,qBAAa,kBAAmB,SAAQ,gBAAgB;;CASvD;AAED,qBAAa,iBAAkB,SAAQ,gBAAgB;gBACzC,KAAK,EAAE,MAAM;CAQ1B;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAQ9C;AAED,qBAAa,cAAe,SAAQ,gBAAgB;gBACtC,MAAM,EAAE,MAAM;CAQ3B;AAED,qBAAa,yBAA0B,SAAQ,gBAAgB;gBACjD,QAAQ,EAAE,MAAM;CAQ7B;AAED,qBAAa,mBAAoB,SAAQ,gBAAgB;gBAC3C,MAAM,EAAE,MAAM;CAQ3B"}

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

@@ -1,9 +1,58 @@
-import type { NativeProps } from './RnStoryEditorViewNativeComponent';
-export declare const StoryEditorView: import("react-native").HostComponent<NativeProps>;
+import type { NativeProps as BaseNativeProps } from './RnStoryEditorViewNativeComponent';
+export interface NativeProps extends BaseNativeProps {
+    onExportImage?: (event: {
+        nativeEvent: {
+            base64: string;
+            error?: string;
+        };
+    }) => void;
+    onError?: (event: {
+        nativeEvent: {
+            code: string;
+            message: string;
+        };
+    }) => void;
+}
+/**
+ * Commands for controlling the StoryEditorView
+ *
+ * @example
+ * const editorRef = useRef(null);
+ *
+ * // Export image
+ * StoryEditorCommands.exportImage(editorRef.current);
+ *
+ * // Show text input
+ * StoryEditorCommands.showTextInput(editorRef.current);
+ */
 export declare const StoryEditorCommands: {
+    /**
+     * Exports the current canvas as a base64 encoded image
+     * @param ref - Reference to the StoryEditorView component
+     * @throws {InvalidRefError} If ref is invalid
+     * @throws {NodeHandleNotFoundError} If component is not mounted
+     * @throws {CommandNotSupportedError} If command not supported on platform
+     * @throws {ViewManagerNotFoundError} If native module not found
+     */
     exportImage: (ref: any) => void;
+    /**
+     * Shows the text input overlay for adding text layers
+     * @param ref - Reference to the StoryEditorView component
+     * @throws {InvalidRefError} If ref is invalid
+     * @throws {NodeHandleNotFoundError} If component is not mounted
+     * @throws {CommandNotSupportedError} If command not supported on platform
+     * @throws {ViewManagerNotFoundError} If native module not found
+     */
     showTextInput: (ref: any) => void;
 };
-export declare const addExportImageListener: (_callback: (base64: string) => void) => void;
-export type { NativeProps };
+/**
+ * Validates props before passing to native component
+ * @param props - Props to validate
+ * @throws {InvalidColorError} If color is invalid
+ * @throws {InvalidBase64Error} If base64 image data is invalid
+ */
+export declare function validateProps(props: Partial<NativeProps>): void;
+export { StoryEditorError, NativeModuleNotFoundError, ViewManagerNotFoundError, InvalidRefError, NodeHandleNotFoundError, CommandNotSupportedError, ImageExportError, InvalidBase64Error, InvalidColorError, LayerOperationError, TextInputError, PlatformNotSupportedError, InitializationError, } from './errors';
+export type { NativeProps as StoryEditorProps };
+export declare const StoryEditorView: import("react-native").HostComponent<NativeProps>;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AActE,eAAO,MAAM,eAAe,mDAAsD,CAAC;AAGnF,eAAO,MAAM,mBAAmB;uBACX,GAAG;yBAcD,GAAG;CAazB,CAAC;AAGF,eAAO,MAAM,sBAAsB,GAAI,WAAW,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,SAGzE,CAAC;AAGF,YAAY,EAAE,WAAW,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAezF,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE;QACtB,WAAW,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACjD,KAAK,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,WAAW,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/E;AAkID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;;;;;;OAOG;uBACgB,GAAG,KAAG,IAAI;IAsB7B;;;;;;;OAOG;yBACkB,GAAG,KAAG,IAAI;CAqBhC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAU/D;AAGD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,wBAAwB,EACxB,eAAe,EACf,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAGlB,YAAY,EAAE,WAAW,IAAI,gBAAgB,EAAE,CAAC;AAGhD,eAAO,MAAM,eAAe,mDACyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-rn-story-editor",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A React Native story editor with layers, drag-drop, text/image overlays, and export functionality",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",