@digilogiclabs/create-saas-app 1.20.1 → 2.0.0

package/src/templates/web/ui-auth-payments/template/src/lib/platform.ts

@@ -0,0 +1,146 @@
+/**
+ * Platform Core Integration
+ *
+ * This file sets up the @digilogiclabs/platform-core integration for
+ * unified infrastructure services across your application.
+ *
+ * Platform-core provides:
+ * - Database abstraction (Supabase, PostgreSQL)
+ * - Cache abstraction (Redis, Upstash, Memory)
+ * - Storage abstraction (S3, MinIO, R2)
+ * - Email abstraction (Resend, SMTP)
+ * - Queue abstraction (BullMQ)
+ * - Logging and Metrics
+ * - Resilience patterns (retry, circuit breaker, timeout)
+ */
+
+import { createPlatform, createPlatformAsync, type IPlatform } from '@digilogiclabs/platform-core';
+import { setPlatform as setAuthPlatform } from '@digilogiclabs/saas-factory-auth';
+import { setPlatform as setPaymentsPlatform } from '@digilogiclabs/saas-factory-payments';
+
+// Singleton platform instance
+let platformInstance: IPlatform | null = null;
+
+/**
+ * Get the platform instance (creates a new one if needed)
+ *
+ * For testing or development without external services,
+ * this uses in-memory adapters.
+ *
+ * @example
+ * ```ts
+ * const platform = getPlatform();
+ * await platform.cache.set('key', 'value', 3600);
+ * ```
+ */
+export function getPlatform(): IPlatform {
+  if (!platformInstance) {
+    platformInstance = createPlatform();
+    initializePackageIntegrations(platformInstance);
+  }
+  return platformInstance;
+}
+
+/**
+ * Initialize platform with production adapters (async)
+ *
+ * Call this once at application startup to configure
+ * production services based on environment variables.
+ *
+ * @example
+ * ```ts
+ * // In app/layout.tsx or a server initialization file
+ * await initializePlatform();
+ * ```
+ */
+export async function initializePlatform(): Promise<IPlatform> {
+  if (platformInstance) {
+    return platformInstance;
+  }
+
+  // Use createPlatformAsync for production adapters
+  // Falls back to memory adapters if env vars are not set
+  platformInstance = await createPlatformAsync();
+  initializePackageIntegrations(platformInstance);
+
+  return platformInstance;
+}
+
+/**
+ * Initialize package integrations with platform services
+ */
+function initializePackageIntegrations(platform: IPlatform): void {
+  // Connect saas-factory-auth to platform-core
+  // Enables: logging, metrics, and email for auth events
+  setAuthPlatform({
+    email: platform.email,
+    logger: platform.logger,
+    metrics: platform.metrics,
+  });
+
+  // Connect saas-factory-payments to platform-core
+  // Enables: logging, metrics, and caching for payment events
+  setPaymentsPlatform({
+    logger: platform.logger,
+    metrics: platform.metrics,
+    cache: platform.cache,
+  });
+}
+
+/**
+ * Reset platform instance (useful for testing)
+ */
+export function resetPlatform(): void {
+  platformInstance = null;
+}
+
+/**
+ * Example: Using platform services
+ *
+ * Database:
+ * ```ts
+ * const users = await platform.db
+ *   .from('users')
+ *   .where('active', '=', true)
+ *   .execute();
+ * ```
+ *
+ * Cache:
+ * ```ts
+ * await platform.cache.set('user:123', userData, 3600);
+ * const cached = await platform.cache.get<User>('user:123');
+ * ```
+ *
+ * Storage:
+ * ```ts
+ * await platform.storage.upload('avatars/user-123.png', buffer, {
+ *   contentType: 'image/png',
+ *   public: true,
+ * });
+ * ```
+ *
+ * Email:
+ * ```ts
+ * await platform.email.send({
+ *   to: { email: 'user@example.com', name: 'John' },
+ *   subject: 'Welcome!',
+ *   html: '<h1>Welcome to {{titleCaseName}}</h1>',
+ * });
+ * ```
+ *
+ * Queue:
+ * ```ts
+ * await platform.queue.add('sendWelcomeEmail', { userId: '123' });
+ * ```
+ *
+ * Logging:
+ * ```ts
+ * platform.logger.info('User signed up', { userId: '123' });
+ * ```
+ *
+ * Metrics:
+ * ```ts
+ * platform.metrics.increment('user.signup');
+ * platform.metrics.timing('api.response_time', 150);
+ * ```
+ */

package/src/templates/web/ui-auth-payments-ai/template/.env.example

@@ -1,22 +1,60 @@
-# Auth Configuration
-NEXT_PUBLIC_AUTH_PROVIDER=supabase|firebase
-
-# Supabase
-NEXT_PUBLIC_SUPABASE_URL=
-NEXT_PUBLIC_SUPABASE_ANON_KEY=
-
-# Firebase
-NEXT_PUBLIC_FIREBASE_API_KEY=
-NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
-NEXT_PUBLIC_FIREBASE_PROJECT_ID=
-
-# Payments
-NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
-STRIPE_SECRET_KEY=
-
-# AI Configuration (Client-side accessible)
-NEXT_PUBLIC_OPENAI_API_KEY=your_openai_key_here
-NEXT_PUBLIC_ANTHROPIC_API_KEY=your_anthropic_key_here
-NEXT_PUBLIC_GOOGLE_AI_API_KEY=your_google_key_here
-NEXT_PUBLIC_ELEVENLABS_API_KEY=your_elevenlabs_key_here
-NEXT_PUBLIC_REPLICATE_API_TOKEN=your_replicate_token_here
+# ═══════════════════════════════════════════════════════════════
+# Auth Configuration
+# ═══════════════════════════════════════════════════════════════
+NEXT_PUBLIC_AUTH_PROVIDER=supabase|firebase
+
+# Supabase
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+SUPABASE_SERVICE_ROLE_KEY=
+
+# Firebase
+NEXT_PUBLIC_FIREBASE_API_KEY=
+NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=
+NEXT_PUBLIC_FIREBASE_PROJECT_ID=
+
+# ═══════════════════════════════════════════════════════════════
+# Payments (Stripe)
+# ═══════════════════════════════════════════════════════════════
+NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=
+STRIPE_SECRET_KEY=
+STRIPE_WEBHOOK_SECRET=
+
+# ═══════════════════════════════════════════════════════════════
+# AI Providers
+# ═══════════════════════════════════════════════════════════════
+OPENAI_API_KEY=
+ANTHROPIC_API_KEY=
+GOOGLE_AI_API_KEY=
+ELEVENLABS_API_KEY=
+REPLICATE_API_TOKEN=
+
+# ═══════════════════════════════════════════════════════════════
+# Platform Core - Infrastructure Services (Optional)
+# Configure these for production. Memory adapters used if not set.
+# ═══════════════════════════════════════════════════════════════
+
+# Cache (Upstash Redis - great for AI response caching)
+UPSTASH_REDIS_REST_URL=
+UPSTASH_REDIS_REST_TOKEN=
+
+# Storage (S3-compatible: AWS S3, MinIO, Cloudflare R2)
+S3_ENDPOINT=
+S3_REGION=
+S3_ACCESS_KEY_ID=
+S3_SECRET_ACCESS_KEY=
+S3_BUCKET=
+
+# Email (Resend)
+RESEND_API_KEY=
+EMAIL_FROM=noreply@example.com
+
+# Queue (BullMQ - for AI background processing)
+REDIS_URL=redis://localhost:6379
+
+# ═══════════════════════════════════════════════════════════════
+# Application
+# ═══════════════════════════════════════════════════════════════
+NEXT_PUBLIC_APP_URL=http://localhost:3000
+NEXT_PUBLIC_APP_NAME={{titleCaseName}}
+NODE_ENV=development

package/src/templates/web/ui-auth-payments-ai/template/package.json

@@ -1,7 +1,7 @@
 {
   "name": "{{packageName}}",
   "version": "0.1.0",
-  "description": "{{description}} - Full-Stack AI Platform (with UI v0.18.2 + Auth v1.0.0 + Payments + AI v1.0.0)",
+  "description": "{{description}} - Full-Stack AI Platform (with Platform Core + UI + Auth + Payments + AI)",
   "private": true,
   "scripts": {
     "dev": "next dev",
@@ -17,10 +17,11 @@
     "next": "^15.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
-    "@digilogiclabs/saas-factory-ui": "^0.26.1",
-    "@digilogiclabs/saas-factory-auth": "^1.0.3",
-    "@digilogiclabs/saas-factory-payments": "^1.2.3",
-    "@digilogiclabs/saas-factory-ai": "^4.0.2",
+    "@digilogiclabs/platform-core": "^0.1.0",
+    "@digilogiclabs/saas-factory-ui": "^0.27.3",
+    "@digilogiclabs/saas-factory-auth": "^1.0.6",
+    "@digilogiclabs/saas-factory-payments": "^1.2.8",
+    "@digilogiclabs/saas-factory-ai": "^4.0.4",
     "stripe": "^14.0.0",
     "@stripe/react-stripe-js": "^2.0.0",
     "@stripe/stripe-js": "^2.0.0",

package/src/templates/web/ui-auth-payments-ai/template/src/lib/platform.ts

@@ -0,0 +1,155 @@
+/**
+ * Platform Core Integration
+ *
+ * This file sets up the @digilogiclabs/platform-core integration for
+ * unified infrastructure services across your application.
+ *
+ * Platform-core provides:
+ * - Database abstraction (Supabase, PostgreSQL)
+ * - Cache abstraction (Redis, Upstash, Memory)
+ * - Storage abstraction (S3, MinIO, R2)
+ * - Email abstraction (Resend, SMTP)
+ * - Queue abstraction (BullMQ)
+ * - Logging and Metrics
+ * - Resilience patterns (retry, circuit breaker, timeout)
+ */
+
+import { createPlatform, createPlatformAsync, type IPlatform } from '@digilogiclabs/platform-core';
+import { setPlatform as setAuthPlatform } from '@digilogiclabs/saas-factory-auth';
+import { setPlatform as setPaymentsPlatform } from '@digilogiclabs/saas-factory-payments';
+import { setPlatform as setAIPlatform } from '@digilogiclabs/saas-factory-ai';
+
+// Singleton platform instance
+let platformInstance: IPlatform | null = null;
+
+/**
+ * Get the platform instance (creates a new one if needed)
+ *
+ * For testing or development without external services,
+ * this uses in-memory adapters.
+ *
+ * @example
+ * ```ts
+ * const platform = getPlatform();
+ * await platform.cache.set('key', 'value', 3600);
+ * ```
+ */
+export function getPlatform(): IPlatform {
+  if (!platformInstance) {
+    platformInstance = createPlatform();
+    initializePackageIntegrations(platformInstance);
+  }
+  return platformInstance;
+}
+
+/**
+ * Initialize platform with production adapters (async)
+ *
+ * Call this once at application startup to configure
+ * production services based on environment variables.
+ *
+ * @example
+ * ```ts
+ * // In app/layout.tsx or a server initialization file
+ * await initializePlatform();
+ * ```
+ */
+export async function initializePlatform(): Promise<IPlatform> {
+  if (platformInstance) {
+    return platformInstance;
+  }
+
+  // Use createPlatformAsync for production adapters
+  // Falls back to memory adapters if env vars are not set
+  platformInstance = await createPlatformAsync();
+  initializePackageIntegrations(platformInstance);
+
+  return platformInstance;
+}
+
+/**
+ * Initialize package integrations with platform services
+ */
+function initializePackageIntegrations(platform: IPlatform): void {
+  // Connect saas-factory-auth to platform-core
+  // Enables: logging, metrics, and email for auth events
+  setAuthPlatform({
+    email: platform.email,
+    logger: platform.logger,
+    metrics: platform.metrics,
+  });
+
+  // Connect saas-factory-payments to platform-core
+  // Enables: logging, metrics, and caching for payment events
+  setPaymentsPlatform({
+    logger: platform.logger,
+    metrics: platform.metrics,
+    cache: platform.cache,
+  });
+
+  // Connect saas-factory-ai to platform-core
+  // Enables: logging, metrics, and caching for AI operations
+  setAIPlatform({
+    logger: platform.logger,
+    metrics: platform.metrics,
+    cache: platform.cache,
+  });
+}
+
+/**
+ * Reset platform instance (useful for testing)
+ */
+export function resetPlatform(): void {
+  platformInstance = null;
+}
+
+/**
+ * Example: Using platform services
+ *
+ * Database:
+ * ```ts
+ * const users = await platform.db
+ *   .from('users')
+ *   .where('active', '=', true)
+ *   .execute();
+ * ```
+ *
+ * Cache (great for AI response caching):
+ * ```ts
+ * await platform.cache.set('ai:response:123', response, 3600);
+ * const cached = await platform.cache.get<AIResponse>('ai:response:123');
+ * ```
+ *
+ * Storage (for file uploads, AI assets):
+ * ```ts
+ * await platform.storage.upload('uploads/file-123.pdf', buffer, {
+ *   contentType: 'application/pdf',
+ * });
+ * ```
+ *
+ * Email:
+ * ```ts
+ * await platform.email.send({
+ *   to: { email: 'user@example.com', name: 'John' },
+ *   subject: 'Welcome!',
+ *   html: '<h1>Welcome to {{titleCaseName}}</h1>',
+ * });
+ * ```
+ *
+ * Queue (for AI background jobs):
+ * ```ts
+ * await platform.queue.add('processDocument', { documentId: '123' });
+ * ```
+ *
+ * Logging:
+ * ```ts
+ * platform.logger.info('AI request completed', { tokens: 150, model: 'gpt-4' });
+ * ```
+ *
+ * Metrics (track AI usage):
+ * ```ts
+ * platform.metrics.increment('ai.requests');
+ * platform.metrics.histogram('ai.tokens_used', tokenCount);
+ * platform.metrics.timing('ai.response_time', responseMs);
+ * ```
+ */

package/bin/index.js

@@ -1,36 +0,0 @@
-#!/usr/bin/env node
-
-const { execSync } = require('child_process');
-const path = require('path');
-const fs = require('fs');
-
-// Check Node version
-const nodeVersion = process.version;
-const majorVersion = parseInt(nodeVersion.split('.')[0].substring(1));
-
-if (majorVersion < 18) {
-  console.error(`❌ Node.js 18.0.0 or higher is required. You have ${nodeVersion}.`);
-  console.error('Please upgrade Node.js: https://nodejs.org/');
-  process.exit(1);
-}
-
-// Check if dist directory exists
-const distPath = path.join(__dirname, '..', 'dist');
-if (!fs.existsSync(distPath)) {
-  console.error('❌ CLI not built. Please run: npm run build');
-  process.exit(1);
-}
-
-// Run the compiled CLI
-try {
-  require('../dist/cli/index.js');
-} catch (error) {
-  console.error('❌ Error running create-saas-app:');
-  console.error(error.message);
-  
-  if (error.code === 'MODULE_NOT_FOUND') {
-    console.error('\n💡 Try running: npm install -g @digilogiclabs/create-saas-app');
-  }
-  
-  process.exit(1);
-}