@umituz/react-native-ai-generation-content 1.17.27 → 1.17.28

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.17.27",
+  "version": "1.17.28",
   "description": "Provider-agnostic AI generation orchestration for React Native",
   "main": "src/index.ts",
   "types": "src/index.ts",

package/src/domain/interfaces/app-services.interface.ts

@@ -0,0 +1,122 @@
+/**
+ * App Services Interface
+ * Defines contracts for app-specific services that package uses
+ * Apps implement these interfaces to provide their specific logic
+ */
+
+/**
+ * Network service interface
+ * Handles network availability checks
+ */
+export interface INetworkService {
+  /**
+   * Check if device is online
+   */
+  isOnline: () => boolean;
+
+  /**
+   * Require network connection - throws if offline
+   */
+  requireNetwork: () => void;
+}
+
+/**
+ * Credit service interface
+ * Handles credit operations (check, deduct, refund)
+ */
+export interface ICreditService {
+  /**
+   * Check if user has enough credits
+   * @param cost - Required credit amount
+   * @returns true if has enough credits
+   */
+  checkCredits: (cost: number) => Promise<boolean>;
+
+  /**
+   * Deduct credits from user balance
+   * @param cost - Amount to deduct
+   */
+  deductCredits: (cost: number) => Promise<void>;
+
+  /**
+   * Refund credits on failure (non-user caused errors)
+   * @param amount - Amount to refund
+   * @param error - Original error (used to determine if refund is applicable)
+   */
+  refundCredits: (amount: number, error?: unknown) => Promise<void>;
+
+  /**
+   * Calculate credit cost for operation
+   * @param capability - Generation capability type
+   * @param metadata - Additional metadata for cost calculation
+   */
+  calculateCost: (
+    capability: string,
+    metadata?: Record<string, unknown>,
+  ) => number;
+}
+
+/**
+ * Paywall service interface
+ * Shows paywall UI when credits insufficient
+ */
+export interface IPaywallService {
+  /**
+   * Show paywall to user
+   * @param requiredCredits - Credits needed for operation
+   */
+  showPaywall: (requiredCredits: number) => void;
+}
+
+/**
+ * Auth service interface
+ * Handles user authentication
+ */
+export interface IAuthService {
+  /**
+   * Get current user ID
+   * @returns User ID or null if not authenticated
+   */
+  getUserId: () => string | null;
+
+  /**
+   * Check if user is authenticated
+   */
+  isAuthenticated: () => boolean;
+
+  /**
+   * Require authenticated user - throws if not authenticated
+   * @returns User ID
+   */
+  requireAuth: () => string;
+}
+
+/**
+ * Analytics service interface (optional)
+ * Tracks events for analytics
+ */
+export interface IAnalyticsService {
+  /**
+   * Track an event
+   * @param event - Event name
+   * @param data - Event data
+   */
+  track: (event: string, data: Record<string, unknown>) => void;
+}
+
+/**
+ * Combined app services interface
+ * Apps implement this to provide all required services
+ */
+export interface IAppServices {
+  readonly network: INetworkService;
+  readonly credits: ICreditService;
+  readonly paywall: IPaywallService;
+  readonly auth: IAuthService;
+  readonly analytics?: IAnalyticsService;
+}
+
+/**
+ * Partial app services for optional configuration
+ */
+export type PartialAppServices = Partial<IAppServices>;

package/src/domain/interfaces/index.ts

@@ -4,3 +4,4 @@
  */
 
 export * from "./ai-provider.interface";
+export * from "./app-services.interface";

package/src/index.ts

@@ -29,6 +29,14 @@ export type {
   VideoFeatureType,
   ImageFeatureInputData,
   VideoFeatureInputData,
+  // App Services Interfaces
+  INetworkService,
+  ICreditService,
+  IPaywallService,
+  IAuthService,
+  IAnalyticsService,
+  IAppServices,
+  PartialAppServices,
 } from "./domain/interfaces";
 
 export {
@@ -85,6 +93,23 @@ export {
   getPromptRequiredModes,
 } from "./domain/constants/processing-modes.constants";
 
+// =============================================================================
+// INFRASTRUCTURE LAYER - App Services Configuration
+// =============================================================================
+
+export {
+  configureAppServices,
+  updateAppServices,
+  getAppServices,
+  isAppServicesConfigured,
+  resetAppServices,
+  getNetworkService,
+  getCreditService,
+  getPaywallService,
+  getAuthService,
+  getAnalyticsService,
+} from "./infrastructure/config";
+
 // =============================================================================
 // INFRASTRUCTURE LAYER - Services
 // =============================================================================

package/src/infrastructure/config/app-services.config.ts

@@ -0,0 +1,122 @@
+/**
+ * App Services Configuration
+ * Singleton for storing app-provided service implementations
+ */
+
+import type { IAppServices, PartialAppServices } from "../../domain/interfaces/app-services.interface";
+
+declare const __DEV__: boolean;
+
+let appServices: IAppServices | null = null;
+
+/**
+ * Default no-op implementations for optional services
+ */
+const defaultAnalytics = {
+  track: () => {
+    // No-op by default
+  },
+};
+
+/**
+ * Configure app services
+ * Must be called before using any generation features
+ * @param services - App-specific service implementations
+ */
+export function configureAppServices(services: IAppServices): void {
+  if (typeof __DEV__ !== "undefined" && __DEV__) {
+    // eslint-disable-next-line no-console
+    console.log("[AppServices] Configuring app services");
+  }
+
+  appServices = {
+    ...services,
+    analytics: services.analytics || defaultAnalytics,
+  };
+}
+
+/**
+ * Update specific app services
+ * Useful for lazy initialization
+ * @param updates - Partial service updates
+ */
+export function updateAppServices(updates: PartialAppServices): void {
+  if (!appServices) {
+    throw new Error(
+      "[AppServices] Must call configureAppServices before updateAppServices",
+    );
+  }
+
+  appServices = {
+    ...appServices,
+    ...updates,
+  };
+}
+
+/**
+ * Get configured app services
+ * @throws Error if services not configured
+ */
+export function getAppServices(): IAppServices {
+  if (!appServices) {
+    throw new Error(
+      "[AppServices] App services not configured. Call configureAppServices first.",
+    );
+  }
+
+  return appServices;
+}
+
+/**
+ * Check if app services are configured
+ */
+export function isAppServicesConfigured(): boolean {
+  return appServices !== null;
+}
+
+/**
+ * Reset app services (useful for testing)
+ */
+export function resetAppServices(): void {
+  appServices = null;
+}
+
+/**
+ * Get network service
+ * @throws Error if not configured
+ */
+export function getNetworkService(): IAppServices["network"] {
+  return getAppServices().network;
+}
+
+/**
+ * Get credit service
+ * @throws Error if not configured
+ */
+export function getCreditService(): IAppServices["credits"] {
+  return getAppServices().credits;
+}
+
+/**
+ * Get paywall service
+ * @throws Error if not configured
+ */
+export function getPaywallService(): IAppServices["paywall"] {
+  return getAppServices().paywall;
+}
+
+/**
+ * Get auth service
+ * @throws Error if not configured
+ */
+export function getAuthService(): IAppServices["auth"] {
+  return getAppServices().auth;
+}
+
+/**
+ * Get analytics service
+ * @throws Error if not configured
+ */
+export function getAnalyticsService(): IAppServices["analytics"] {
+  return getAppServices().analytics;
+}

package/src/infrastructure/config/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Infrastructure Config Exports
+ */
+
+export {
+  configureAppServices,
+  updateAppServices,
+  getAppServices,
+  isAppServicesConfigured,
+  resetAppServices,
+  getNetworkService,
+  getCreditService,
+  getPaywallService,
+  getAuthService,
+  getAnalyticsService,
+} from "./app-services.config";