@umituz/react-native-ai-generation-content 1.90.2 → 1.90.3

package/src/infrastructure/utils/couple-input-refiner.ts

@@ -0,0 +1,101 @@
+/**
+ * Couple Input Utilities - Prompt Refinement
+ */
+
+/**
+ * Refines a prompt for couple or solo mode by adjusting plurals and keywords.
+ * Primarily used to fix "baked" prompts that were generated with a specific mode in mind.
+ */
+export function refinePromptForCouple(prompt: string, isCouple: boolean): string {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[CoupleUtil] ===== REFINE PROMPT START =====");
+    console.log("[CoupleUtil] Is couple mode:", isCouple);
+    console.log("[CoupleUtil] Original prompt length:", prompt.length);
+    console.log("[CoupleUtil] Original prompt preview:", prompt.substring(0, 200) + "...");
+  }
+
+  if (isCouple) {
+    // Ensure couple context is present
+    let refined = prompt
+      .replace(/\bthe person must be\b/gi, "both people must be")
+      .replace(/\bthe person is\b/gi, "both people are")
+      .replace(/\bkeep every facial feature\b/gi, "keep every facial feature for both people")
+      .replace(/\bthe person\b/gi, "both people")
+      .replace(/\bfacial feature\b/gi, "facial features")
+      .replace(/\bidentical\b/gi, "identical for both individuals")
+      .replace(/\binstantly recognizable\b/gi, "instantly recognizable as themselves");
+
+    // Special mapping for common couple scenarios: map "dress/gown" to person 1 and "suit/tuxedo" to person 2
+    // this helps the AI map reference images correctly to the scene roles
+    if (/\b(dress|gown)\b/i.test(refined) && /\b(suit|tuxedo|linen trousers)\b/i.test(refined)) {
+      refined = refined
+        .replace(/\b(dress|gown)\b/gi, "$1 (worn by Person 1)")
+        .replace(/\b(suit|tuxedo|linen trousers)\b/gi, "$1 (worn by Person 2)");
+
+      // Also add explicit mapping to the top if not already there
+      if (!refined.includes("DIRECTIVE: MAP PHOTO 1 TO PERSON 1")) {
+        refined = `DIRECTIVE: MAP PHOTO 1 TO PERSON 1, MAP PHOTO 2 TO PERSON 2\n\n${refined}`;
+      }
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[CoupleUtil] ✅ Clothing mapping applied!");
+        console.log("[CoupleUtil] ✅ Directive added for photo mapping");
+      }
+    }
+
+    // If it doesn't already have couple-hints, add them at the start
+    if (!/\b(couple|both|matching|dual|two people)\b/i.test(refined) && !refined.includes("DIRECTIVE:")) {
+      refined = `A photo of a couple, ${refined}`;
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[CoupleUtil] ✅ Added 'A photo of a couple' prefix");
+      }
+    }
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[CoupleUtil] Refined prompt length:", refined.length);
+      console.log("[CoupleUtil] Refined prompt preview:", refined.substring(0, 300) + "...");
+      console.log("[CoupleUtil] ===== REFINE PROMPT END =====");
+    }
+    return refined;
+  } else {
+    // Solo mode: AGGRESSIVELY remove plural references to prevent "ghost" people
+    const soloRefined = prompt
+      // Instead of removing the clothing descriptions, just remove the gender labels
+      // so the AI can apply the relevant clothing to the single person it sees.
+      .replace(/\sfor women\b/gi, "")
+      .replace(/\sfor men\b/gi, "")
+      // Remove collective adjectives
+      .replace(/\bmatching\b/gi, "")
+      .replace(/\bcoordinated\b/gi, "")
+      .replace(/\bcomplementary\b/gi, "")
+      .replace(/\bcoordinating\b/gi, "")
+      .replace(/\bcouple\b/gi, "person")
+      .replace(/\bduo\b/gi, "person")
+      .replace(/\bpair\b/gi, "person")
+      .replace(/\bdoubles\b/gi, "")
+      .replace(/\bboth\b/gi, "the person")
+      .replace(/\bthey are\b/gi, "the person is")
+      .replace(/\btheir\b/gi, "the person's")
+      // Force singular clothing
+      .replace(/\bjackets\b/gi, "jacket")
+      .replace(/\boutfits\b/gi, "outfit")
+      .replace(/\bsuits\b/gi, "suit")
+      .replace(/\btuxedos\b/gi, "tuxedo")
+      .replace(/\bgowns\b/gi, "gown")
+      .replace(/\bdresses\b/gi, "dress")
+      .replace(/\bsweaters\b/gi, "sweater")
+      .replace(/\bhoodies\b/gi, "hoodie")
+      .replace(/\bcoats\b/gi, "coat")
+      .replace(/\bshirts\b/gi, "shirt")
+      .replace(/\bhats\b/gi, "hat")
+      .replace(/\baccessories\b/gi, "accessory")
+      .replace(/\s+/g, ' ').trim();
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      console.log("[CoupleUtil] ✅ Solo mode - removed all plural references");
+      console.log("[CoupleUtil] Solo refined prompt length:", soloRefined.length);
+      console.log("[CoupleUtil] ===== REFINE PROMPT END =====");
+    }
+    return soloRefined;
+  }
+}

package/src/infrastructure/utils/couple-input-resolver.ts

@@ -0,0 +1,71 @@
+/**
+ * Couple Input Utilities - Input Resolution
+ */
+
+import type { GenerationTargetLike } from "./couple-input-types";
+
+interface CoupleInputResult {
+  readonly target: GenerationTargetLike;
+  readonly imageUrls: string[];
+}
+
+/**
+ * Resolves generation target and image URLs based on couple/single mode.
+ * Eliminates non-null assertions by narrowing partner2PhotoUri internally.
+ */
+export function resolveCoupleInput(
+  partner1PhotoUri: string,
+  partner2PhotoUri: string | null,
+  isCoupleMode: boolean,
+  singleTarget: GenerationTargetLike,
+  coupleTarget: GenerationTargetLike,
+): CoupleInputResult {
+  const DEV = typeof __DEV__ !== "undefined" && __DEV__;
+
+  if (DEV) {
+    console.log("[CoupleUtil] ===== RESOLVE COUPLE INPUT =====");
+    console.log("[CoupleUtil] Is couple mode:", isCoupleMode);
+    console.log("[CoupleUtil] Has partner 2:", !!partner2PhotoUri);
+    console.log("[CoupleUtil] Partner 1 URI:", partner1PhotoUri.substring(0, 60) + "...");
+    if (partner2PhotoUri) {
+      console.log("[CoupleUtil] Partner 2 URI:", partner2PhotoUri.substring(0, 60) + "...");
+    }
+    console.log("[CoupleUtil] Single target:", `${singleTarget.model}/${singleTarget.providerId}`);
+    console.log("[CoupleUtil] Couple target:", `${coupleTarget.model}/${coupleTarget.providerId}`);
+  }
+
+  if (isCoupleMode && partner2PhotoUri) {
+    const result = {
+      target: coupleTarget,
+      imageUrls: [partner1PhotoUri, partner2PhotoUri],
+    };
+
+    if (DEV) {
+      console.log("[CoupleUtil] ===== COUPLE MODE SELECTED =====");
+      console.log("[CoupleUtil] Target model:", result.target.model);
+      console.log("[CoupleUtil] Target provider:", result.target.providerId);
+      console.log("[CoupleUtil] Image URLs:", result.imageUrls.length);
+      console.log("[CoupleUtil] Image 1:", result.imageUrls[0].substring(0, 60) + "...");
+      console.log("[CoupleUtil] Image 2:", result.imageUrls[1].substring(0, 60) + "...");
+      console.log("[CoupleUtil] ===== RESOLVE COMPLETE =====");
+    }
+
+    return result;
+  }
+
+  const result = {
+    target: singleTarget,
+    imageUrls: [partner1PhotoUri],
+  };
+
+  if (DEV) {
+    console.log("[CoupleUtil] ===== SINGLE MODE SELECTED =====");
+    console.log("[CoupleUtil] Target model:", result.target.model);
+    console.log("[CoupleUtil] Target provider:", result.target.providerId);
+    console.log("[CoupleUtil] Image URLs:", result.imageUrls.length);
+    console.log("[CoupleUtil] Image 1:", result.imageUrls[0].substring(0, 60) + "...");
+    console.log("[CoupleUtil] ===== RESOLVE COMPLETE =====");
+  }
+
+  return result;
+}

package/src/infrastructure/utils/couple-input-types.ts

@@ -0,0 +1,14 @@
+/**
+ * Couple Input Utilities - Type Definitions
+ */
+
+/** Target for generation: which model on which provider */
+export interface GenerationTargetLike {
+  readonly model: string;
+  readonly providerId: string;
+}
+
+interface CoupleInputResult {
+  readonly target: GenerationTargetLike;
+  readonly imageUrls: string[];
+}

package/src/infrastructure/utils/couple-input.util.ts

@@ -1,180 +1,7 @@
-/** Target for generation: which model on which provider */
-export interface GenerationTargetLike {
-  readonly model: string;
-  readonly providerId: string;
-}
-
-interface CoupleInputResult {
-  readonly target: GenerationTargetLike;
-  readonly imageUrls: string[];
-}
-
 /**
- * Resolves generation target and image URLs based on couple/single mode.
- * Eliminates non-null assertions by narrowing partner2PhotoUri internally.
+ * Couple Input Utilities
  */
-export function resolveCoupleInput(
-  partner1PhotoUri: string,
-  partner2PhotoUri: string | null,
-  isCoupleMode: boolean,
-  singleTarget: GenerationTargetLike,
-  coupleTarget: GenerationTargetLike,
-): CoupleInputResult {
-  const DEV = typeof __DEV__ !== "undefined" && __DEV__;
-
-  if (DEV) {
-    console.log("[CoupleUtil] ===== RESOLVE COUPLE INPUT =====");
-    console.log("[CoupleUtil] Is couple mode:", isCoupleMode);
-    console.log("[CoupleUtil] Has partner 2:", !!partner2PhotoUri);
-    console.log("[CoupleUtil] Partner 1 URI:", partner1PhotoUri.substring(0, 60) + "...");
-    if (partner2PhotoUri) {
-      console.log("[CoupleUtil] Partner 2 URI:", partner2PhotoUri.substring(0, 60) + "...");
-    }
-    console.log("[CoupleUtil] Single target:", `${singleTarget.model}/${singleTarget.providerId}`);
-    console.log("[CoupleUtil] Couple target:", `${coupleTarget.model}/${coupleTarget.providerId}`);
-  }
-
-  if (isCoupleMode && partner2PhotoUri) {
-    const result = {
-      target: coupleTarget,
-      imageUrls: [partner1PhotoUri, partner2PhotoUri],
-    };
-
-    if (DEV) {
-      console.log("[CoupleUtil] ===== COUPLE MODE SELECTED =====");
-      console.log("[CoupleUtil] Target model:", result.target.model);
-      console.log("[CoupleUtil] Target provider:", result.target.providerId);
-      console.log("[CoupleUtil] Image URLs:", result.imageUrls.length);
-      console.log("[CoupleUtil] Image 1:", result.imageUrls[0].substring(0, 60) + "...");
-      console.log("[CoupleUtil] Image 2:", result.imageUrls[1].substring(0, 60) + "...");
-      console.log("[CoupleUtil] ===== RESOLVE COMPLETE =====");
-    }
-
-    return result;
-  }
-
-  const result = {
-    target: singleTarget,
-    imageUrls: [partner1PhotoUri],
-  };
-
-  if (DEV) {
-    console.log("[CoupleUtil] ===== SINGLE MODE SELECTED =====");
-    console.log("[CoupleUtil] Target model:", result.target.model);
-    console.log("[CoupleUtil] Target provider:", result.target.providerId);
-    console.log("[CoupleUtil] Image URLs:", result.imageUrls.length);
-    console.log("[CoupleUtil] Image 1:", result.imageUrls[0].substring(0, 60) + "...");
-    console.log("[CoupleUtil] ===== RESOLVE COMPLETE =====");
-  }
-
-  return result;
-}
-
-/**
- * Prepends optional context (e.g. appearance analysis) to a base prompt.
- */
-export function prependContext(
-  basePrompt: string,
-  context: string | undefined | null,
-): string {
-  return context ? `${context}\n\n${basePrompt}` : basePrompt;
-}
-
-/**
- * Refines a prompt for couple or solo mode by adjusting plurals and keywords.
- * Primarily used to fix "baked" prompts that were generated with a specific mode in mind.
- */
-export function refinePromptForCouple(prompt: string, isCouple: boolean): string {
-  if (typeof __DEV__ !== "undefined" && __DEV__) {
-    console.log("[CoupleUtil] ===== REFINE PROMPT START =====");
-    console.log("[CoupleUtil] Is couple mode:", isCouple);
-    console.log("[CoupleUtil] Original prompt length:", prompt.length);
-    console.log("[CoupleUtil] Original prompt preview:", prompt.substring(0, 200) + "...");
-  }
-
-  if (isCouple) {
-    // Ensure couple context is present
-    let refined = prompt
-      .replace(/\bthe person must be\b/gi, "both people must be")
-      .replace(/\bthe person is\b/gi, "both people are")
-      .replace(/\bkeep every facial feature\b/gi, "keep every facial feature for both people")
-      .replace(/\bthe person\b/gi, "both people")
-      .replace(/\bfacial feature\b/gi, "facial features")
-      .replace(/\bidentical\b/gi, "identical for both individuals")
-      .replace(/\binstantly recognizable\b/gi, "instantly recognizable as themselves");
-
-    // Special mapping for common couple scenarios: map "dress/gown" to person 1 and "suit/tuxedo" to person 2
-    // this helps the AI map reference images correctly to the scene roles
-    if (/\b(dress|gown)\b/i.test(refined) && /\b(suit|tuxedo|linen trousers)\b/i.test(refined)) {
-      refined = refined
-        .replace(/\b(dress|gown)\b/gi, "$1 (worn by Person 1)")
-        .replace(/\b(suit|tuxedo|linen trousers)\b/gi, "$1 (worn by Person 2)");
-
-      // Also add explicit mapping to the top if not already there
-      if (!refined.includes("DIRECTIVE: MAP PHOTO 1 TO PERSON 1")) {
-        refined = `DIRECTIVE: MAP PHOTO 1 TO PERSON 1, MAP PHOTO 2 TO PERSON 2\n\n${refined}`;
-      }
-
-      if (typeof __DEV__ !== "undefined" && __DEV__) {
-        console.log("[CoupleUtil] ✅ Clothing mapping applied!");
-        console.log("[CoupleUtil] ✅ Directive added for photo mapping");
-      }
-    }
-
-    // If it doesn't already have couple-hints, add them at the start
-    if (!/\b(couple|both|matching|dual|two people)\b/i.test(refined) && !refined.includes("DIRECTIVE:")) {
-      refined = `A photo of a couple, ${refined}`;
-      if (typeof __DEV__ !== "undefined" && __DEV__) {
-        console.log("[CoupleUtil] ✅ Added 'A photo of a couple' prefix");
-      }
-    }
-
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-      console.log("[CoupleUtil] Refined prompt length:", refined.length);
-      console.log("[CoupleUtil] Refined prompt preview:", refined.substring(0, 300) + "...");
-      console.log("[CoupleUtil] ===== REFINE PROMPT END =====");
-    }
-    return refined;
-  } else {
-    // Solo mode: AGGRESSIVELY remove plural references to prevent "ghost" people
-    const soloRefined = prompt
-      // Instead of removing the clothing descriptions, just remove the gender labels
-      // so the AI can apply the relevant clothing to the single person it sees.
-      .replace(/\sfor women\b/gi, "")
-      .replace(/\sfor men\b/gi, "")
-      // Remove collective adjectives
-      .replace(/\bmatching\b/gi, "")
-      .replace(/\bcoordinated\b/gi, "")
-      .replace(/\bcomplementary\b/gi, "")
-      .replace(/\bcoordinating\b/gi, "")
-      .replace(/\bcouple\b/gi, "person")
-      .replace(/\bduo\b/gi, "person")
-      .replace(/\bpair\b/gi, "person")
-      .replace(/\bdoubles\b/gi, "")
-      .replace(/\bboth\b/gi, "the person")
-      .replace(/\bthey are\b/gi, "the person is")
-      .replace(/\btheir\b/gi, "the person's")
-      // Force singular clothing
-      .replace(/\bjackets\b/gi, "jacket")
-      .replace(/\boutfits\b/gi, "outfit")
-      .replace(/\bsuits\b/gi, "suit")
-      .replace(/\btuxedos\b/gi, "tuxedo")
-      .replace(/\bgowns\b/gi, "gown")
-      .replace(/\bdresses\b/gi, "dress")
-      .replace(/\bsweaters\b/gi, "sweater")
-      .replace(/\bhoodies\b/gi, "hoodie")
-      .replace(/\bcoats\b/gi, "coat")
-      .replace(/\bshirts\b/gi, "shirt")
-      .replace(/\bhats\b/gi, "hat")
-      .replace(/\baccessories\b/gi, "accessory")
-      .replace(/\s+/g, ' ').trim();
 
-    if (typeof __DEV__ !== "undefined" && __DEV__) {
-      console.log("[CoupleUtil] ✅ Solo mode - removed all plural references");
-      console.log("[CoupleUtil] Solo refined prompt length:", soloRefined.length);
-      console.log("[CoupleUtil] ===== REFINE PROMPT END =====");
-    }
-    return soloRefined;
-  }
-}
+export { resolveCoupleInput, prependContext, refinePromptForCouple } from "./couple-input-index";
+export type { GenerationTargetLike } from "./couple-input-index";
 

package/src/infrastructure/utils/photo-generation/photo-preparation.util.ts

@@ -7,7 +7,7 @@
 import {
   calculateBase64Size,
   calculateBase64SizeMB,
-} from "../../../shared/utils/calculations.util";
+} from "../../../shared/utils/calculations";
 
 export interface PhotoInput {
   base64: string;

package/src/infrastructure/validation/base-validator.ts

@@ -3,33 +3,7 @@
  * Core validation functions for strings, numbers, URLs, emails, and base64
  */
 
-/**
- * Validation result type
- */
-export interface ValidationResult {
-  readonly isValid: boolean;
-  readonly errors: readonly string[];
-}
-
-/**
- * String validation options
- */
-export interface StringValidationOptions {
-  readonly minLength?: number;
-  readonly maxLength?: number;
-  readonly pattern?: RegExp;
-  readonly allowedCharacters?: RegExp;
-  readonly trim?: boolean;
-}
-
-/**
- * Numeric validation options
- */
-export interface NumericValidationOptions {
-  readonly min?: number;
-  readonly max?: number;
-  readonly integer?: boolean;
-}
+import type { ValidationResult, StringValidationOptions, NumericValidationOptions } from "./base-validator.types";
 
 /**
  * Validates a string input against provided rules

package/src/infrastructure/validation/base-validator.types.ts

@@ -0,0 +1,32 @@
+/**
+ * Base Validation Utilities - Types
+ * Type definitions for base validation
+ */
+
+/**
+ * Validation result type
+ */
+export interface ValidationResult {
+  readonly isValid: boolean;
+  readonly errors: readonly string[];
+}
+
+/**
+ * String validation options
+ */
+export interface StringValidationOptions {
+  readonly minLength?: number;
+  readonly maxLength?: number;
+  readonly pattern?: RegExp;
+  readonly allowedCharacters?: RegExp;
+  readonly trim?: boolean;
+}
+
+/**
+ * Numeric validation options
+ */
+export interface NumericValidationOptions {
+  readonly min?: number;
+  readonly max?: number;
+  readonly integer?: boolean;
+}

package/src/presentation/hooks/generation/index.ts

@@ -4,7 +4,7 @@
  */
 
 // Core orchestrator
-export { useGenerationOrchestrator } from "./orchestrator";
+export { useGenerationOrchestrator } from "./orchestrator-index";
 
 // Generic feature hooks
 export { useImageGeneration } from "./useImageGeneration";

package/src/presentation/hooks/generation/orchestrator-abort-logs.ts

@@ -0,0 +1,48 @@
+/**
+ * Generation Orchestrator - Abort Logging
+ */
+
+/**
+ * Log abort before start
+ */
+export function logAbortBeforeStart(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Aborted before generation started");
+  }
+}
+
+/**
+ * Log abort after completion
+ */
+export function logAbortAfterCompletion(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Aborted after generation completed");
+  }
+}
+
+/**
+ * Log abort before save
+ */
+export function logAbortBeforeSave(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Aborted before save");
+  }
+}
+
+/**
+ * Log abort before success
+ */
+export function logAbortBeforeSuccess(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Aborted before success callback");
+  }
+}
+
+/**
+ * Log aborted
+ */
+export function logAborted(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Generation aborted");
+  }
+}

package/src/presentation/hooks/generation/orchestrator-execution-logs.ts

@@ -0,0 +1,67 @@
+/**
+ * Generation Orchestrator - Execution Logging
+ */
+
+/**
+ * Log state generating
+ */
+export function logStateGenerating(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] State: generating - calling strategy.execute()");
+  }
+}
+
+/**
+ * Log execute completed
+ */
+export function logExecuteCompleted(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] strategy.execute() completed");
+  }
+}
+
+/**
+ * Log state saving
+ */
+export function logStateSaving(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Saving result to Firestore");
+  }
+}
+
+/**
+ * Log save success
+ */
+export function logSaveSuccess(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Result saved successfully");
+  }
+}
+
+/**
+ * Log save failed
+ */
+export function logSaveFailed(error: unknown): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] ERROR: Save failed:", error);
+  }
+}
+
+/**
+ * Log generation success
+ */
+export function logGenerationSuccess(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] ✅ Generation SUCCESS");
+    console.log("[Orchestrator] ========================================");
+  }
+}
+
+/**
+ * Log error
+ */
+export function logError(error: unknown): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Error:", error);
+  }
+}

package/src/presentation/hooks/generation/orchestrator-index.ts

@@ -0,0 +1,14 @@
+/**
+ * Generation Orchestrator
+ * Handles AI generation execution with network check, moderation, credit deduction, and error handling
+ */
+
+export { useGenerationOrchestrator } from "./orchestrator";
+export type {
+  GenerationStatus,
+  GenerationState,
+  GenerationError,
+  GenerationStrategy,
+  GenerationConfig,
+  UseGenerationOrchestratorReturn,
+} from "./orchestrator-types";

package/src/presentation/hooks/generation/orchestrator-start-logs.ts

@@ -0,0 +1,65 @@
+/**
+ * Generation Orchestrator - Start Logging
+ */
+
+/**
+ * Log generation start
+ */
+export function logGenerationStart(input: unknown, userId: string | null, isGenerating: boolean): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] ========================================");
+    console.log("[Orchestrator] generate() called with input:", JSON.stringify(input).substring(0, 200));
+    console.log("[Orchestrator] isGenerating:", isGenerating);
+    console.log("[Orchestrator] userId:", userId);
+  }
+}
+
+/**
+ * Log already generating state
+ */
+export function logAlreadyGenerating(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] BLOCKED: Already generating");
+  }
+}
+
+/**
+ * Log state change
+ */
+export function logStateChange(state: string): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] State set to '" + state + "', isGenerating: true");
+  }
+}
+
+/**
+ * Log online check result
+ */
+export function logOnlineCheck(online: boolean): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    if (online) {
+      console.log("[Orchestrator] Online check passed");
+    } else {
+      console.log("[Orchestrator] ERROR: User is offline");
+    }
+  }
+}
+
+/**
+ * Log moderation start
+ */
+export function logModerationStart(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] Starting moderation check");
+  }
+}
+
+/**
+ * Log execution start
+ */
+export function logExecutionStart(): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    console.log("[Orchestrator] ----------------------------------------");
+    console.log("[Orchestrator] executeGeneration() called");
+  }
+}

package/src/presentation/hooks/generation/orchestrator-state-utils.ts

@@ -0,0 +1,17 @@
+/**
+ * Generation Orchestrator - State Utilities
+ */
+
+import type { GenerationState } from "./orchestrator-types";
+
+/**
+ * Get initial generation state
+ */
+export function getInitialState<T>(): GenerationState<T> {
+  return {
+    status: "idle",
+    isGenerating: false,
+    result: null,
+    error: null,
+  };
+}