create-stackr 0.2.0

package/templates/integrations/mobile/revenuecat/store/revenuecat.store.ts

@@ -0,0 +1,286 @@
+import { create } from 'zustand';
+import { revenueCatService } from '../services/revenuecatService';
+import { CustomerInfo, PurchasesPackage, PurchasesOfferings } from 'react-native-purchases';
+import { logger } from '../utils/logger';
+
+interface RevenueCatState {
+  // State
+  isInitialized: boolean;
+  customerInfo: CustomerInfo | null;
+  offerings: PurchasesOfferings | null;
+  adjustId: string | null;
+  isLoading: boolean;
+  error: string | null;
+
+  // Actions
+  initialize: () => void;
+  setAdjustId: (adjustId: string) => void;
+  getCustomerInfo: () => Promise<void>;
+  getOfferings: () => Promise<void>;
+  purchasePackage: (pkg: PurchasesPackage) => Promise<{ success: boolean; userCancelled: boolean }>;
+  restorePurchases: () => Promise<void>;
+  setLoading: (loading: boolean) => void;
+  setError: (error: string | null) => void;
+  reset: () => void;
+
+  // Computed values
+  hasActiveSubscription: boolean;
+  getActiveEntitlements: () => string[];
+}
+
+export const useRevenueCatStore = create<RevenueCatState>((set, get) => ({
+  // Initial state
+  isInitialized: false,
+  customerInfo: null,
+  offerings: null,
+  adjustId: null,
+  isLoading: false,
+  error: null,
+
+  // Actions
+  initialize: () => {
+    const state = get();
+    if (state.isInitialized) {
+      logger.info('RevenueCatStore: Already initialized, skipping');
+      return;
+    }
+
+    try {
+      set({ isLoading: true, error: null });
+      logger.info('RevenueCatStore: Initializing RevenueCat SDK...');
+
+      revenueCatService.initialize();
+      
+      set({
+        isInitialized: true,
+        isLoading: false,
+        error: null
+      });
+
+      logger.info('RevenueCatStore: RevenueCat SDK initialized successfully');
+
+      // Get initial customer info
+      get().getCustomerInfo();
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to initialize RevenueCat SDK';
+      logger.error('RevenueCatStore: Failed to initialize RevenueCat SDK', { error });
+      set({
+        error: errorMessage,
+        isLoading: false,
+        isInitialized: false
+      });
+    }
+  },
+
+  setAdjustId: (adjustId) => {
+    try {
+      const currentState = get();
+      if (currentState.adjustId === adjustId) {
+        logger.info('RevenueCatStore: Adjust ID already set, skipping');
+        return;
+      }
+
+      logger.info('RevenueCatStore: Setting Adjust ID', { adjustId });
+      revenueCatService.setAdjustId(adjustId);
+      
+      set({ adjustId });
+      logger.info('RevenueCatStore: Adjust ID set successfully');
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to set Adjust ID';
+      logger.error('RevenueCatStore: Failed to set Adjust ID', { error });
+      set({ error: errorMessage });
+    }
+  },
+
+  getCustomerInfo: async () => {
+    const state = get();
+    if (state.isLoading) {
+      logger.info('RevenueCatStore: Customer info request already in progress');
+      return;
+    }
+
+    try {
+      set({ isLoading: true, error: null });
+      logger.info('RevenueCatStore: Getting customer info...');
+
+      const customerInfo = await revenueCatService.getCustomerInfo();
+
+      set({
+        customerInfo,
+        isLoading: false,
+        error: null
+      });
+
+      logger.info('RevenueCatStore: Customer info retrieved successfully');
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to get customer info';
+      logger.error('RevenueCatStore: Failed to get customer info', { error });
+      set({
+        error: errorMessage,
+        isLoading: false,
+        customerInfo: null
+      });
+    }
+  },
+
+  getOfferings: async () => {
+    const state = get();
+    if (state.isLoading) {
+      logger.info('RevenueCatStore: Offerings request already in progress');
+      return;
+    }
+
+    try {
+      set({ isLoading: true, error: null });
+      logger.info('RevenueCatStore: Getting offerings...');
+
+      const offerings = await revenueCatService.getOfferings();
+
+      set({
+        offerings,
+        isLoading: false,
+        error: null
+      });
+
+      logger.info('RevenueCatStore: Offerings retrieved successfully', {
+        offeringsCount: Object.keys(offerings.all).length,
+        hasCurrent: !!offerings.current,
+      });
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to get offerings';
+      logger.error('RevenueCatStore: Failed to get offerings', { error });
+      set({
+        error: errorMessage,
+        isLoading: false,
+        offerings: null
+      });
+    }
+  },
+
+  purchasePackage: async (pkg) => {
+    const state = get();
+    if (state.isLoading) {
+      logger.info('RevenueCatStore: Purchase already in progress');
+      return { success: false, userCancelled: false };
+    }
+
+    try {
+      set({ isLoading: true, error: null });
+      logger.info('RevenueCatStore: Purchasing package', { packageId: pkg.identifier });
+
+      const result = await revenueCatService.purchasePackage(pkg);
+      
+      set({
+        customerInfo: result.customerInfo,
+        isLoading: false,
+        error: null
+      });
+
+      const success = !result.userCancelled;
+      logger.info('RevenueCatStore: Package purchase completed', { 
+        success,
+        userCancelled: result.userCancelled 
+      });
+
+      return { success, userCancelled: result.userCancelled };
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to purchase package';
+      logger.error('RevenueCatStore: Failed to purchase package', { error });
+      set({
+        error: errorMessage,
+        isLoading: false
+      });
+      return { success: false, userCancelled: false };
+    }
+  },
+
+  restorePurchases: async () => {
+    const state = get();
+    if (state.isLoading) {
+      logger.info('RevenueCatStore: Restore purchases already in progress');
+      return;
+    }
+
+    try {
+      set({ isLoading: true, error: null });
+      logger.info('RevenueCatStore: Restoring purchases...');
+
+      const customerInfo = await revenueCatService.restorePurchases();
+      
+      set({
+        customerInfo,
+        isLoading: false,
+        error: null
+      });
+
+      logger.info('RevenueCatStore: Purchases restored successfully');
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to restore purchases';
+      logger.error('RevenueCatStore: Failed to restore purchases', { error });
+      set({
+        error: errorMessage,
+        isLoading: false
+      });
+    }
+  },
+
+  setLoading: (isLoading) => set({ isLoading }),
+  
+  setError: (error) => set({ error }),
+
+  reset: () => {
+    set({
+      isInitialized: false,
+      customerInfo: null,
+      offerings: null,
+      adjustId: null,
+      isLoading: false,
+      error: null
+    });
+    revenueCatService.reset();
+    logger.info('RevenueCatStore: Store reset');
+  },
+
+  // Computed values
+  get hasActiveSubscription() {
+    const state = get();
+    if (!state.customerInfo) return false;
+    return Object.keys(state.customerInfo.entitlements.active).length > 0;
+  },
+
+  getActiveEntitlements: () => {
+    const state = get();
+    if (!state.customerInfo) return [];
+    return Object.keys(state.customerInfo.entitlements.active);
+  },
+}));
+
+// Selectors for commonly used RevenueCat state
+export const useRevenueCat = () => {
+  const state = useRevenueCatStore();
+  return {
+    isInitialized: state.isInitialized,
+    customerInfo: state.customerInfo,
+    offerings: state.offerings,
+    adjustId: state.adjustId,
+    isLoading: state.isLoading,
+    error: state.error,
+    hasActiveSubscription: state.hasActiveSubscription,
+    activeEntitlements: state.getActiveEntitlements(),
+  };
+};
+
+export const useRevenueCatActions = () => {
+  const state = useRevenueCatStore();
+  return {
+    initialize: state.initialize,
+    setAdjustId: state.setAdjustId,
+    getCustomerInfo: state.getCustomerInfo,
+    getOfferings: state.getOfferings,
+    purchasePackage: state.purchasePackage,
+    restorePurchases: state.restorePurchases,
+    setLoading: state.setLoading,
+    setError: state.setError,
+    reset: state.reset,
+  };
+};

package/templates/integrations/mobile/scate/services/scateService.ts.ejs

@@ -0,0 +1,85 @@
+import { ScateSDK } from 'scatesdk-react';
+import Constants from 'expo-constants';
+import { logger } from '../utils/logger';
+
+class ScateService {
+  private static readonly API_KEY = Constants.expoConfig?.extra?.scate?.apiKey || '';
+  
+  private _isInitialized: boolean = false;
+
+  /**
+   * Check if Scate SDK is initialized
+   */
+  get isInitialized(): boolean {
+    return this._isInitialized;
+  }
+
+  /**
+   * Initialize Scate SDK
+   */
+  initialize(): void {
+    if (this._isInitialized) {
+      logger.info('ScateService: Already initialized, skipping');
+      return;
+    }
+
+    try {
+      logger.info('ScateService: Initializing Scate SDK...');
+      
+      ScateSDK.Init(ScateService.API_KEY);
+      
+      this._isInitialized = true;
+      logger.info('ScateService: Scate SDK initialized successfully');
+    } catch (error) {
+      logger.error('ScateService: Failed to initialize Scate SDK', { error });
+      throw error;
+    }
+  }
+
+  /**
+   * Set Adjust ADID for attribution
+   */
+  setAdid(adid: string): void {
+    try {
+      logger.info('ScateService: Setting ADID', { adid });
+      ScateSDK.SetAdid(adid);
+      logger.info('ScateService: ADID set successfully');
+    } catch (error) {
+      logger.error('ScateService: Failed to set ADID', { error });
+      throw error;
+    }
+  }
+
+  /**
+   * Track custom event (if needed for future features)
+   */
+  trackEvent(eventName: string, parameters?: Record<string, any>): void {
+    try {
+      logger.info('ScateService: Custom event tracking would be implemented here', { 
+        eventName, 
+        parameters 
+      });
+      // Implementation would depend on Scate SDK's event tracking capabilities
+    } catch (error) {
+      logger.error('ScateService: Failed to track event', { error });
+    }
+  }
+
+  /**
+   * Get API key
+   */
+  getApiKey(): string {
+    return ScateService.API_KEY;
+  }
+
+  /**
+   * Reset Scate SDK state (useful for testing)
+   */
+  reset(): void {
+    this._isInitialized = false;
+    logger.info('ScateService: Service reset');
+  }
+}
+
+// Export singleton instance
+export const scateService = new ScateService();

package/templates/integrations/mobile/scate/store/scate.store.ts

@@ -0,0 +1,125 @@
+import { create } from 'zustand';
+import { scateService } from '../services/scateService';
+import { logger } from '../utils/logger';
+
+interface ScateState {
+  // State
+  isInitialized: boolean;
+  adid: string | null;
+  isLoading: boolean;
+  error: string | null;
+
+  // Actions
+  initialize: () => void;
+  setAdid: (adid: string) => void;
+  setLoading: (loading: boolean) => void;
+  setError: (error: string | null) => void;
+  reset: () => void;
+
+  // Computed values
+  hasAdid: boolean;
+}
+
+export const useScateStore = create<ScateState>((set, get) => ({
+  // Initial state
+  isInitialized: false,
+  adid: null,
+  isLoading: false,
+  error: null,
+
+  // Actions
+  initialize: () => {
+    const state = get();
+    if (state.isInitialized) {
+      logger.info('ScateStore: Already initialized, skipping');
+      return;
+    }
+
+    try {
+      set({ isLoading: true, error: null });
+      logger.info('ScateStore: Initializing Scate SDK...');
+
+      scateService.initialize();
+      
+      set({
+        isInitialized: true,
+        isLoading: false,
+        error: null
+      });
+
+      logger.info('ScateStore: Scate SDK initialized successfully');
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to initialize Scate SDK';
+      logger.error('ScateStore: Failed to initialize Scate SDK', { error });
+      set({
+        error: errorMessage,
+        isLoading: false,
+        isInitialized: false
+      });
+    }
+  },
+
+  setAdid: (adid) => {
+    try {
+      const currentState = get();
+      if (currentState.adid === adid) {
+        logger.info('ScateStore: ADID already set, skipping');
+        return;
+      }
+
+      logger.info('ScateStore: Setting ADID', { adid });
+      scateService.setAdid(adid);
+      
+      set({ adid });
+      logger.info('ScateStore: ADID set successfully');
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : 'Failed to set ADID';
+      logger.error('ScateStore: Failed to set ADID', { error });
+      set({ error: errorMessage });
+    }
+  },
+
+  setLoading: (isLoading) => set({ isLoading }),
+  
+  setError: (error) => set({ error }),
+
+  reset: () => {
+    set({
+      isInitialized: false,
+      adid: null,
+      isLoading: false,
+      error: null
+    });
+    scateService.reset();
+    logger.info('ScateStore: Store reset');
+  },
+
+  // Computed values
+  get hasAdid() {
+    const state = get();
+    return !!state.adid;
+  },
+}));
+
+// Selectors for commonly used Scate state
+export const useScate = () => {
+  const state = useScateStore();
+  return {
+    isInitialized: state.isInitialized,
+    adid: state.adid,
+    isLoading: state.isLoading,
+    error: state.error,
+    hasAdid: state.hasAdid,
+  };
+};
+
+export const useScateActions = () => {
+  const state = useScateStore();
+  return {
+    initialize: state.initialize,
+    setAdid: state.setAdid,
+    setLoading: state.setLoading,
+    setError: state.setError,
+    reset: state.reset,
+  };
+};

package/templates/shared/.env.example.ejs

@@ -0,0 +1,21 @@
+# =============================================================================
+# Docker Compose Environment Variables
+# =============================================================================
+# These variables are used by docker-compose.yml for container orchestration.
+# The setup.sh script will create .env from this template automatically.
+#
+# For application-specific configuration (OAuth, BetterAuth, etc.),
+# see backend/.env.example
+# =============================================================================
+
+# Database Configuration (for PostgreSQL container)
+DB_USER=postgres
+DB_PASSWORD=your-secure-database-password
+DB_NAME=<%= projectName.toLowerCase().replace(/[^a-z0-9]/g, '_') %>_db
+
+# JWT Secret (must match between services)
+JWT_SECRET=your-jwt-secret-change-in-production
+<% if (backend.eventQueue) { %>
+# Redis Configuration
+REDIS_PASSWORD=your-redis-password
+<% } %>

package/templates/shared/.gitignore.ejs

@@ -0,0 +1,145 @@
+# Dependencies
+node_modules/
+.bun/
+
+# Environment variables
+.env
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+.env.staging
+
+# Build outputs
+dist/
+build/
+out/
+.next/
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Runtime data
+pids/
+*.pid
+*.seed
+*.pid.lock
+
+# Coverage directory used by tools like istanbul
+coverage/
+*.lcov
+.nyc_output/
+
+# Dependency directories
+jspm_packages/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*
+
+# IDEs and editors
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+*.sublime-*
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Docker
+docker-compose.override.yml
+.dockerignore.local
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+*.temp
+
+# Backup files
+*.backup
+*.bak
+*.orig
+
+# Database
+*.sqlite
+*.db
+database.sqlite
+
+# Redis dump
+dump.rdb
+
+# Prisma
+prisma/migrations/migration_lock.toml
+
+# Production deployment artifacts
+.vercel/
+.netlify/
+.firebase/
+
+# Local development overrides
+*.local
+local-*
+
+# Test artifacts
+.nyc_output/
+test-results/
+playwright-report/
+
+# Certificates
+*.pem
+*.key
+*.crt
+*.cert
+
+# Secrets
+secrets/
+.secrets/
+*.secret