vibefast-cli 0.2.4 → 0.3.1

package/2/apps/native/scripts/genrate-apk-and-install

@@ -0,0 +1,39 @@
+#!/bin/bash
+# This script builds a release APK and installs it on a connected device
+# Note: In a monorepo, run this from the apps/native directory
+
+# Check if android directory exists
+if [ ! -d "./android" ]; then
+  echo "❌ Android directory not found!"
+  echo "💡 Run 'pnpm prebuild' first to generate native projects"
+  exit 1
+fi
+
+# Check if adb is installed
+if ! command -v adb &> /dev/null; then
+  echo "❌ adb command not found!"
+  echo "💡 Install Android SDK Platform Tools"
+  exit 1
+fi
+
+echo "🔨 Building release APK..."
+./android/gradlew assembleRelease -p ./android
+
+echo "🔍 Finding APK file..."
+APK_PATH=$(find ./android -type f -name "app-release.apk" | head -n 1)
+
+if [ -z "$APK_PATH" ]; then
+  echo "❌ APK file not found!"
+  exit 1
+fi
+
+echo "✅ APK found at: $APK_PATH"
+echo "📱 Installing APK on device..."
+adb install "$APK_PATH"
+
+if [ $? -eq 0 ]; then
+  echo "✅ APK installed successfully!"
+else
+  echo "❌ Failed to install APK"
+  exit 1
+fi

package/2/apps/native/scripts/i18next-syntax-validation.js

@@ -0,0 +1,23 @@
+const validate = (message = '') => {
+  if (!(message || '').trim()) {
+    throw new SyntaxError('Message is Empty.');
+  }
+  if (typeof message !== 'string') {
+    throw new TypeError('Message must be a String.');
+  }
+  if (
+    (message.includes('{') || message.includes('}')) &&
+    !/{{ ?(?:- |\w+?)(, ?)?\w+? ?}}/g.test(message)
+  ) {
+    throw new SyntaxError(
+      'Interpolation error. See: https://www.i18next.com/misc/json-format',
+    );
+  }
+  if (message.includes('$t(') && !/\$t\([\w]+:\w+(?:\.\w+)*\)/g.test(message)) {
+    throw new SyntaxError(
+      'Nesting error. See: https://www.i18next.com/misc/json-format',
+    );
+  }
+};
+
+module.exports = validate;

package/2/apps/native/scripts/starter-setup.mjs

@@ -0,0 +1,246 @@
+import { execSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+
+const run = (cmd, opts = {}) => {
+	console.log(`\n> ${cmd}`);
+	execSync(cmd, { stdio: 'inherit', ...opts });
+};
+
+const runSilent = (cmd, opts = {}) => {
+	try {
+		return execSync(cmd, { stdio: 'pipe', encoding: 'utf8', ...opts });
+	} catch {
+		return null;
+	}
+};
+
+const renameEnvFiles = () => {
+	const envs = ['local', 'staging', 'production'];
+	let renamed = false;
+	envs.forEach((env) => {
+		const src = `.env.${env}.example`;
+		const dest = `.env.${env}`;
+		if (!fs.existsSync(dest) && fs.existsSync(src)) {
+			fs.renameSync(src, dest);
+			console.log(`✅ Renamed ${src} → ${dest}`);
+			renamed = true;
+		}
+	});
+	if (!renamed) {
+		console.log('ℹ️  No env example files to rename');
+	}
+};
+
+const updateSiteUrl = (envFile) => {
+	if (!fs.existsSync(envFile)) {
+		console.warn(`⚠️  ${envFile} not found, skipping CONVEX_SITE_URL setup`);
+		return;
+	}
+
+	const content = fs.readFileSync(envFile, 'utf8');
+	const urlMatch = content.match(/^CONVEX_URL=(.*)$/m);
+
+	if (urlMatch) {
+		const convexUrl = urlMatch[1].trim();
+		const siteUrl = convexUrl.replace(/\.cloud(?=$|[:/?#])/i, '.site');
+		let newContent;
+
+		if (/^CONVEX_SITE_URL=/m.test(content)) {
+			newContent = content.replace(
+				/^CONVEX_SITE_URL=.*$/m,
+				`CONVEX_SITE_URL=${siteUrl}`,
+			);
+		} else {
+			newContent = `${content}\nCONVEX_SITE_URL=${siteUrl}`;
+		}
+
+		fs.writeFileSync(envFile, newContent, 'utf8');
+		console.log(`✅ Set CONVEX_SITE_URL=${siteUrl} in ${envFile}`);
+	} else {
+		console.warn(
+			`⚠️  Couldn't find CONVEX_URL in ${envFile}, skipping CONVEX_SITE_URL setup`,
+		);
+	}
+};
+
+(async () => {
+	try {
+		console.log('🚀 VibeFast Monorepo Native App Setup\n');
+
+		// Check if we're in the right directory
+		if (!fs.existsSync('package.json')) {
+			console.error(
+				'❌ package.json not found. Please run this from apps/native directory.',
+			);
+			console.error('   cd apps/native && pnpm setup:starter');
+			process.exit(1);
+		}
+
+		// Verify monorepo structure
+		const monorepoRoot = path.resolve('../..');
+		const workspaceFile = path.join(monorepoRoot, 'pnpm-workspace.yaml');
+
+		if (!fs.existsSync(workspaceFile)) {
+			console.error(
+				'❌ Not in a monorepo structure. Expected pnpm-workspace.yaml at root.',
+			);
+			console.error(
+				'   Make sure you are in apps/native directory of the monorepo.',
+			);
+			process.exit(1);
+		}
+
+		console.log('✅ Monorepo structure verified\n');
+
+		// Check for pnpm
+		console.log('📦 Checking for pnpm...');
+		const pnpmVersion = runSilent('pnpm -v');
+		if (!pnpmVersion) {
+			console.error('❌ pnpm is not installed. Please install pnpm first:');
+			console.error('   npm install -g pnpm');
+			console.error('   or visit: https://pnpm.io/installation');
+			process.exit(1);
+		}
+		console.log(`✅ pnpm ${pnpmVersion.trim()} is installed`);
+
+		// Check for eas-cli
+		console.log('🔧 Checking for eas-cli...');
+		const easVersion = runSilent('eas --version');
+		if (!easVersion) {
+			console.log('📥 Installing eas-cli globally...');
+			try {
+				run('npm install -g eas-cli');
+				console.log('✅ eas-cli installed');
+			} catch (err) {
+				console.warn(
+					'⚠️  Failed to install eas-cli. You can install it later with:',
+				);
+				console.warn('   npm install -g eas-cli');
+			}
+		} else {
+			console.log(`✅ eas-cli ${easVersion.trim()} is installed`);
+		}
+
+		// Rename env files
+		console.log('\n📝 Checking for env example files...');
+		renameEnvFiles();
+
+		// Install packages from monorepo root
+		console.log('\n📦 Installing dependencies from monorepo root...');
+		console.log('   This may take a few minutes...');
+		run('pnpm install', { cwd: monorepoRoot });
+		console.log('✅ Dependencies installed');
+
+		// Fix Expo SDK peer deps
+		console.log('\n🔧 Fixing Expo SDK peer dependencies...');
+		try {
+			run('pnpm expo install --fix');
+			console.log('✅ Expo dependencies fixed');
+		} catch (err) {
+			console.warn(
+				'⚠️  Failed to fix Expo deps. You may need to run this manually later.',
+			);
+		}
+
+		// Check if backend package exists
+		const backendPath = path.join(monorepoRoot, 'packages/backend');
+		if (!fs.existsSync(backendPath)) {
+			console.log('\n⚠️  Backend package not found at:', backendPath);
+			console.log(
+				'   Skipping Convex setup. Set up backend separately if needed.',
+			);
+			console.log("\n✅ Setup complete! You're ready to vibe. ✨");
+			console.log('\n📱 Next steps:');
+			console.log('   From monorepo root:');
+			console.log('   • pnpm dev:native       (start dev server)');
+			console.log('   • pnpm native:ios       (run on iOS)');
+			console.log('   • pnpm native:android   (run on Android)');
+			return;
+		}
+
+		// Convex setup
+		console.log('\n⚙️  Setting up Convex backend...');
+
+		// First run: Initialize Convex
+		console.log('\n🔄 Initializing Convex (first run)...');
+		try {
+			run('npx convex dev --once', { cwd: backendPath });
+		} catch (err) {
+			console.warn(
+				'⚠️  Expected error during first Convex setup, continuing...',
+			);
+		}
+
+		// Inject env vars if .env.local exists
+		const convexSetupScript = path.resolve('scripts/convex-setup.js');
+		const envLocal = path.resolve('.env.local');
+
+		if (fs.existsSync(envLocal)) {
+			if (fs.existsSync(convexSetupScript)) {
+				console.log('\n🔐 Injecting environment variables into Convex...');
+				try {
+					run('node scripts/convex-setup.js');
+					console.log('✅ Environment variables injected');
+
+					// Add CONVEX_SITE_URL
+					updateSiteUrl(envLocal);
+				} catch (err) {
+					console.warn('⚠️  Failed to inject env vars:', err.message);
+					console.warn(
+						'   You may need to set them manually in Convex dashboard',
+					);
+				}
+			} else {
+				console.warn('⚠️  convex-setup.js not found, skipping env injection');
+			}
+		} else {
+			console.warn('⚠️  .env.local not found, skipping Convex env setup');
+			console.warn(
+				'   Create .env.local with your Convex credentials to continue',
+			);
+		}
+
+		// Setup Convex Auth
+		console.log('\n🔐 Setting up Convex Auth...');
+		console.log('   Enter Y for all questions it asks.\n');
+		try {
+			run('npx @convex-dev/auth', { cwd: backendPath });
+			console.log('✅ Convex Auth configured');
+		} catch (err) {
+			console.warn(
+				'⚠️  Convex Auth setup had issues. You may need to run it manually:',
+			);
+			console.warn('   cd packages/backend && npx @convex-dev/auth');
+		}
+
+		// Final Convex dev run
+		console.log('\n🔄 Running Convex dev server (final setup)...');
+		try {
+			run('npx convex dev --once', { cwd: backendPath });
+			console.log('✅ Convex backend ready');
+		} catch (err) {
+			console.warn('⚠️  Final Convex setup had issues. Try running:');
+			console.warn('   pnpm dev:server');
+		}
+
+		console.log("\n\n✅ Setup complete! You're ready to vibe. ✨");
+		console.log('\n📱 Next steps:');
+		console.log('\n   From monorepo root:');
+		console.log('   • pnpm dev:native       (start dev server)');
+		console.log('   • pnpm native:ios       (run on iOS)');
+		console.log('   • pnpm native:android   (run on Android)');
+		console.log('\n   From apps/native:');
+		console.log('   • pnpm start            (start dev server)');
+		console.log('   • pnpm ios              (run on iOS)');
+		console.log('   • pnpm android          (run on Android)');
+		console.log('\n   Backend:');
+		console.log('   • pnpm dev:server       (start Convex dev server)');
+	} catch (err) {
+		console.error('\n❌ Setup failed:', err.message);
+		console.error('\nFor help, check:');
+		console.error('   • scripts/README.md');
+		console.error('   • scripts/QUICK_START.md');
+		process.exit(1);
+	}
+})();

package/2/apps/native/src/api-client/auth.ts

@@ -0,0 +1,68 @@
+import { api } from '@vibefast/backend/_generated/api';
+import { useAction, useConvex, useQuery } from 'convex/react';
+
+/**
+ * Auth API Gateway
+ *
+ * This gateway provides typed wrappers around Convex authentication functions.
+ * It handles OTP, password reset, and user management.
+ *
+ * Usage:
+ * - Import this gateway in feature code: `import { authApi } from '@/platform/api/auth'`
+ * - Never import from `@vibefast/backend/_generated/api` directly in feature code
+ */
+export const authApi = {
+  /**
+   * Get the current viewer/user
+   */
+  useViewer() {
+    return useQuery(api.sharedUsers.viewer);
+  },
+
+  /**
+   * Sign up with OTP
+   */
+  useSignUpWithOtp() {
+    return useAction(api.authOtp.signUpWithOtp);
+  },
+
+  /**
+   * Verify OTP and create user
+   */
+  useVerifyOtpAndCreateUser() {
+    return useAction(api.authOtp.verifyOtpAndCreateUser);
+  },
+
+  /**
+   * Request password reset
+   */
+  useRequestPasswordReset() {
+    return useAction(api.authPasswordResetActions.requestPasswordReset);
+  },
+
+  /**
+   * Reset password with token
+   */
+  useResetPassword() {
+    return useAction(api.authPasswordResetActions.resetPassword);
+  },
+
+  /**
+   * Verify password reset token
+   * Note: This uses the convex client directly for query execution
+   */
+  useVerifyPasswordResetToken() {
+    const convex = useConvex();
+    return (token: string) =>
+      convex.query(api.authPasswordReset.verifyPasswordResetToken, { token });
+  },
+
+  /**
+   * Check and grant initial tier
+   */
+  useCheckAndGrantInitialTier() {
+    return useAction(api.grantFunctions.checkAndGrantInitialTier);
+  },
+};
+
+export type AuthApi = typeof authApi;

package/2/apps/native/src/api-client/chatbot.ts

@@ -0,0 +1,83 @@
+import { api } from '@vibefast/backend/_generated/api';
+import type { Id } from '@vibefast/backend/_generated/dataModel';
+import { useMutation, useQuery } from 'convex/react';
+
+type ConversationId = Id<'conversations'>;
+
+const skipToken = 'skip' as const;
+
+/**
+ * Chatbot API Gateway
+ *
+ * This gateway provides typed wrappers around Convex chatbot functions.
+ * It decouples the frontend from the backend file structure by using
+ * the chatbot domain aggregator (convex/chatbot/index.ts).
+ *
+ * Usage:
+ * - Import this gateway in feature code: `import { chatbotApi } from '@/platform/api/chatbot'`
+ * - Never import from `@vibefast/backend/_generated/api` directly in feature code
+ * - All chatbot-related Convex calls should go through this gateway
+ */
+export const chatbotApi = {
+  useAgentSession(conversationId?: ConversationId | null) {
+    return useQuery(
+      api['chatbot/index'].getAgentSession,
+      conversationId ? { conversationId } : skipToken,
+    );
+  },
+
+  useAgentStreamBody(
+    conversationId?: ConversationId | null,
+    streamId?: string | null,
+  ) {
+    return useQuery(
+      api['chatbot/index'].getAgentStreamBody,
+      conversationId && streamId
+        ? {
+            conversationId,
+            streamId,
+          }
+        : skipToken,
+    );
+  },
+
+  useStartAgentStream() {
+    return useMutation(api['chatbot/index'].startAgentStream);
+  },
+
+  useListMessages(
+    conversationId?: ConversationId | null,
+    paginationOpts: { numItems: number; cursor: string | null } = {
+      numItems: 50,
+      cursor: null,
+    },
+  ) {
+    return useQuery(
+      api['chatbot/index'].listMessages,
+      conversationId
+        ? {
+            conversationId,
+            paginationOpts,
+          }
+        : skipToken,
+    );
+  },
+
+  useGetOrCreateConversation() {
+    return useMutation(api['chatbot/index'].getOrCreateDefaultConversation);
+  },
+
+  useStoreMessage() {
+    return useMutation(api['chatbot/index'].storeMessage);
+  },
+
+  useClearConversation() {
+    return useMutation(api['chatbot/index'].clearConversationMessages);
+  },
+
+  useDeleteUserMessage() {
+    return useMutation(api['chatbot/index'].deleteUserMessage);
+  },
+};
+
+export type ChatbotApi = typeof chatbotApi;

package/2/apps/native/src/api-client/client.ts

@@ -0,0 +1,4 @@
+import { Env } from '@env';
+import { ConvexReactClient } from 'convex/react';
+
+export const convex = new ConvexReactClient(Env.CONVEX_URL);

package/2/apps/native/src/api-client/image-analyzer.ts

@@ -0,0 +1,62 @@
+import { api } from '@vibefast/backend/_generated/api';
+import type { Id } from '@vibefast/backend/_generated/dataModel';
+import { useAction, useQuery } from 'convex/react';
+
+const skipToken = 'skip' as const;
+
+/**
+ * Image Analyzer API Gateway
+ *
+ * This gateway provides typed wrappers around Convex image analysis functions.
+ * It handles AI-powered image analysis with configurable goals and feedback styles.
+ *
+ * Usage:
+ * - Import this gateway in feature code: `import { imageAnalyzerApi } from '@/platform/api/image-analyzer'`
+ * - Never import from `@vibefast/backend/_generated/api` directly in feature code
+ */
+export const imageAnalyzerApi = {
+  /**
+   * Start image analysis action
+   *
+   * @returns Promise with analysis ID
+   */
+  useAnalyzeImages() {
+    return useAction(api['imageAnalysis/index'].analyzeImages);
+  },
+
+  /**
+   * Get analysis by ID
+   */
+  useGetAnalysisById(analysisId?: Id<'imageAnalyses'> | null) {
+    return useQuery(
+      api['imageAnalysis/index'].getAnalysisById,
+      analysisId ? { analysisId } : skipToken,
+    );
+  },
+
+  /**
+   * Get full analysis with image URLs
+   */
+  useGetImageAnalysis(analysisId?: Id<'imageAnalyses'> | null) {
+    return useQuery(
+      api['imageAnalysis/index'].getImageAnalysis,
+      analysisId ? { analysisId } : skipToken,
+    );
+  },
+
+  /**
+   * Get user's analysis history with pagination
+   */
+  useGetUserImageAnalyses(
+    paginationOpts: { numItems: number; cursor: string | null } = {
+      numItems: 50,
+      cursor: null,
+    },
+  ) {
+    return useQuery(api['imageAnalysis/index'].getUserImageAnalyses, {
+      paginationOpts,
+    });
+  },
+};
+
+export type ImageAnalyzerApi = typeof imageAnalyzerApi;

package/2/apps/native/src/api-client/image-generator.ts

@@ -0,0 +1,34 @@
+import { api } from '@vibefast/backend/_generated/api';
+import { useAction } from 'convex/react';
+
+/**
+ * Image Generator API Gateway
+ *
+ * This gateway provides typed wrappers around Convex image generation functions.
+ * It handles AI-powered image generation backed by the AI SDK providers.
+ *
+ * Usage:
+ * - Import this gateway in feature code: `import { imageGeneratorApi } from '@/platform/api/image-generator'`
+ * - Never import from `@vibefast/backend/_generated/api` directly in feature code
+ */
+export const imageGeneratorApi = {
+  /**
+   * Generate an image based on user prompt and provider selection
+   *
+   * @returns Promise with image data URI, mime type, and metadata
+   */
+  useGenerateImage() {
+    const action = useAction(api['imageGeneration/index'].generateImageAction);
+
+    return (args: GenerateImageArgs) =>
+      action(args as Parameters<typeof action>[0]);
+  },
+};
+
+export type ImageGeneratorApi = typeof imageGeneratorApi;
+
+export type GenerateImageArgs = {
+  prompt: string;
+  provider: string;
+  model: string;
+};

package/2/apps/native/src/api-client/index.ts

@@ -0,0 +1,27 @@
+/**
+ * Platform API Gateway Index
+ *
+ * This module exports all domain-specific API gateways.
+ * Feature code should import from these gateways instead of
+ * directly from `@vibefast/backend/_generated/api`.
+ *
+ * Architecture:
+ * - Each gateway wraps Convex functions for a specific domain
+ * - Gateways use backend aggregators (convex/[domain]/index.ts) when available
+ * - This decouples frontend from backend file structure
+ *
+ * Usage:
+ * ```typescript
+ * import { chatbotApi } from '@/platform/api';
+ * // or
+ * import { chatbotApi } from '@/platform/api/chatbot';
+ * ```
+ */
+
+export { type AuthApi, authApi } from './auth';
+export { type ChatbotApi, chatbotApi } from './chatbot';
+export { type ImageAnalyzerApi, imageAnalyzerApi } from './image-analyzer';
+export { type ImageGeneratorApi, imageGeneratorApi } from './image-generator';
+export { type PaymentsApi, paymentsApi } from './payments';
+export { type ReportingApi, reportingApi } from './reporting';
+export { type SharedApi, sharedApi } from './shared';

package/2/apps/native/src/api-client/payments.ts

@@ -0,0 +1,44 @@
+import { api } from '@vibefast/backend/_generated/api';
+import { useMutation, useQuery } from 'convex/react';
+
+/**
+ * Payments API Gateway
+ *
+ * This gateway provides typed wrappers around Convex payment functions.
+ * It handles RevenueCat purchases, credit management, and purchase history.
+ *
+ * Usage:
+ * - Import this gateway in feature code: `import { paymentsApi } from '@/platform/api/payments'`
+ * - Never import from `@vibefast/backend/_generated/api` directly in feature code
+ */
+export const paymentsApi = {
+  /**
+   * Record a consumable purchase (like credits) in the database
+   */
+  useRecordConsumablePurchase() {
+    return useMutation(api['payments/index'].recordConsumablePurchase);
+  },
+
+  /**
+   * Get user's current credit balance
+   */
+  useGetUserCredits() {
+    return useQuery(api['payments/index'].getUserCredits);
+  },
+
+  /**
+   * Get user's purchase history with pagination
+   */
+  useGetPurchaseHistory(
+    paginationOpts: { numItems: number; cursor: string | null } = {
+      numItems: 50,
+      cursor: null,
+    },
+  ) {
+    return useQuery(api['payments/index'].getPurchaseHistory, {
+      paginationOpts,
+    });
+  },
+};
+
+export type PaymentsApi = typeof paymentsApi;

package/2/apps/native/src/api-client/reporting.ts

@@ -0,0 +1,29 @@
+import { api } from '@vibefast/backend/_generated/api';
+import { useMutation } from 'convex/react';
+
+/**
+ * Reporting API Gateway
+ *
+ * This gateway provides typed wrappers around Convex reporting functions.
+ * It handles content reporting for AI-generated images and other content.
+ *
+ * Usage:
+ * - Import this gateway in feature code: `import { reportingApi } from '@/platform/api/reporting'`
+ * - Never import from `@vibefast/backend/_generated/api` directly in feature code
+ */
+export const reportingApi = {
+  /**
+   * Report an AI-generated image
+   */
+  useReportAIGeneratedImage() {
+    return useMutation(api['reporting/index'].reportAIGeneratedImage);
+  },
+  /**
+   * Report a chat message from the AI assistant
+   */
+  useReportChatMessage() {
+    return useMutation(api['reporting/index'].reportChatMessage);
+  },
+};
+
+export type ReportingApi = typeof reportingApi;