@blac/core 2.0.0-rc-5 → 2.0.0-rc-6

package/src/types.ts

@@ -54,8 +54,31 @@ export type BlocConstructorParameters<B extends BlocBase<any>> =
   BlocConstructor<B> extends new (...args: infer P) => B ? P : never;
 
 /**
- * Represents a function type for determining hook dependencies based on state changes
- * @template B - The BlocGeneric type
+ * Base interface for all Bloc events
+ * Events must be objects with a constructor to enable proper type matching
+ */
+export interface BlocEvent {
+  readonly type?: string;
+  readonly timestamp?: number;
+}
+
+/**
+ * Enhanced constraint for Bloc events - must be objects with proper constructor
+ */
+export type BlocEventConstraint = BlocEvent & object;
+
+/**
+ * Error boundary interface for Bloc error handling
+ */
+export interface BlocErrorBoundary<S, A extends BlocEventConstraint> {
+  onError: (error: Error, event: A, currentState: S, bloc: { name: string; id: string }) => void | Promise<void>;
+  shouldRethrow?: (error: Error, event: A) => boolean;
+}
+
+/**
+ * Function type for determining dependencies that trigger re-renders
+ * @template S The state type
+ * @returns Array of dependency arrays - if any dependency in any array changes, a re-render is triggered
  */
 export type BlocHookDependencyArrayFn<S> = (
   newState: S

package/src/utils/uuid.ts

@@ -0,0 +1,22 @@
+/**
+ * Cross-platform UUID v4 generator that works in all environments including React Native/Hermes
+ * Falls back to crypto.randomUUID() when available, otherwise uses Math.random()
+ */
+
+/**
+ * Generates a UUID v4 string compatible with all JavaScript environments
+ * @returns A UUID v4 string in the format xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
+ */
+export function generateUUID(): string {
+  // Try to use crypto.randomUUID() if available (Node.js 16+, modern browsers)
+  if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+
+  // Fallback implementation for React Native/Hermes and older environments
+  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
+    const r = Math.random() * 16 | 0;
+    const v = c === 'x' ? r : (r & 0x3 | 0x8);
+    return v.toString(16);
+  });
+}