vibefast-cli 1.2.1 → 1.3.1

package/recipes/README.md

@@ -1,156 +0,0 @@
-# VibeFast Service Configuration Recipes
-
-This directory contains configuration guides for third-party services that are **already integrated** in VibeFast. These services just need your API keys and credentials to work.
-
-## What are Recipes?
-
-Recipes are JSON files that provide:
-- **Configuration steps** - How to get API keys and set them up
-- **Environment variables** - Which .env vars you need
-- **File locations** - Where to add your credentials in the codebase
-- **Documentation links** - Official service documentation
-
-## Available Recipes
-
-### Analytics & Monitoring
-- **sentry.json** - Error tracking (already integrated, just add DSN)
-- **posthog.json** - Product analytics (already integrated, just add API key)
-
-### Payments & Subscriptions
-- **revenuecat.json** - In-app purchases (already integrated, just add API keys)
-
-## Recipe Structure
-
-```json
-{
-  "name": "service-name",
-  "version": "1.0.0",
-  "description": "Service description",
-  "target": "service",
-  "manualSteps": [
-    {
-      "title": "Step Title",
-      "description": "Step description",
-      "link": "https://docs.example.com",
-      "file": ".env.local",
-      "content": "ENV_VAR=value"
-    }
-  ],
-  "env": [
-    {
-      "key": "ENV_VAR_NAME",
-      "description": "Variable description",
-      "example": "example-value",
-      "required": true,
-      "link": "https://docs.example.com"
-    }
-  ],
-  "postInstall": {
-    "message": "Success message"
-  }
-}
-```
-
-## Fields
-
-### Root Level
-- `name` - Service identifier (lowercase, no spaces)
-- `version` - Recipe version (semver)
-- `description` - Short description of the service
-- `target` - Type of recipe (usually "service")
-- `manualSteps` - Array of setup steps
-- `env` - Array of environment variables
-- `postInstall` - Post-installation message
-
-### Manual Steps
-- `title` - Step title
-- `description` - Step description
-- `link` - (Optional) Documentation link
-- `file` - (Optional) File to edit
-- `content` - (Optional) Content to add
-
-### Environment Variables
-- `key` - Variable name
-- `description` - What the variable is for
-- `example` - Example value
-- `required` - Whether it's required
-- `link` - (Optional) Where to get the value
-
-## How to Use
-
-### View Setup Steps
-```bash
-vf checklist sentry
-vf checklist posthog
-vf checklist stripe
-```
-
-### List All Services
-```bash
-vf list
-```
-
-## Adding New Recipes
-
-1. Create a new JSON file in this directory
-2. Follow the recipe structure above
-3. Include clear setup steps and documentation links
-4. Test with `vf checklist <service-name>`
-
-## Recipe Guidelines
-
-### Setup Steps
-- Keep steps clear and actionable
-- Include links to official documentation
-- Specify which files need to be edited
-- Provide example values
-
-### Environment Variables
-- Use clear, descriptive names
-- Include example values
-- Mark required vs optional
-- Provide links to where users can get values
-- Never include actual secrets in examples
-
-### Documentation
-- Link to official service documentation
-- Link to relevant setup guides
-- Include links to dashboards/settings pages
-
-## Integration with CLI
-
-Recipes are automatically discovered by the CLI through the VibeFast API. When users run:
-
-```bash
-vf list              # Shows all available services
-vf checklist <name>  # Shows setup steps for a service
-vf env               # Prompts for environment variables
-```
-
-The CLI fetches recipe data from the API and displays it to users.
-
-## Testing Recipes
-
-To test a recipe locally:
-
-1. Ensure the recipe JSON is valid
-2. Run `vf checklist <service-name>`
-3. Verify all steps display correctly
-4. Check that environment variables are listed
-5. Verify documentation links work
-
-## Best Practices
-
-1. **Be Specific** - Clear, actionable steps
-2. **Provide Examples** - Show what values should look like
-3. **Link to Docs** - Always provide official documentation
-4. **Test Thoroughly** - Verify all links work
-5. **Keep Updated** - Update recipes when services change
-6. **Security** - Never include real secrets or API keys
-
-## Support
-
-For issues or questions about recipes:
-- 📧 Email: support@vibefast.pro
-- 📚 Docs: https://vibefast.pro/docs
-- 🐛 Issues: https://github.com/vibefast/vibefast-cli/issues

package/recipes/audio-recorder-supabase/packages/backend/src/services/recordings.ts

@@ -1,369 +0,0 @@
-/**
- * Recordings Service
- *
- * Handles recording operations including createRecordingDraft, finalizeRecording,
- * listRecordings, updateRecordingName, and deleteRecording.
- *
- * Requirements: 12.1, 12.2, 12.3, 12.4, 12.5
- */
-
-import type { SupabaseClientType } from '../lib/supabase';
-import type { Recording } from '../types';
-import type { Json } from '../types/database';
-
-export interface CreateRecordingDraftInput {
-  name?: string | null;
-  fileUri: string;
-}
-
-export interface CreateRecordingDraftResult {
-  success: boolean;
-  recording?: Recording;
-  error?: string;
-}
-
-export interface FinalizeRecordingInput {
-  recordingId: string;
-  duration: number;
-  fileUri: string;
-  metering?: Json | null;
-}
-
-export interface FinalizeRecordingResult {
-  success: boolean;
-  recording?: Recording;
-  error?: string;
-}
-
-export interface ListRecordingsResult {
-  success: boolean;
-  recordings?: Recording[];
-  hasMore?: boolean;
-  error?: string;
-}
-
-export interface UpdateRecordingNameResult {
-  success: boolean;
-  recording?: Recording;
-  error?: string;
-}
-
-export interface DeleteRecordingResult {
-  success: boolean;
-  error?: string;
-}
-
-const DEFAULT_PAGE_SIZE = 50;
-
-/**
- * Create a recording draft
- *
- * Creates a new recording with status "draft". The recording can be finalized
- * later with duration and metering data.
- *
- * @param supabase - Supabase client (authenticated)
- * @param input - Recording draft data
- * @returns The created recording draft
- *
- * Requirements: 12.1
- */
-export async function createRecordingDraft(
-  supabase: SupabaseClientType,
-  input: CreateRecordingDraftInput
-): Promise<CreateRecordingDraftResult> {
-  // Get the current auth user
-  const { data: authData, error: authError } = await supabase.auth.getUser();
-
-  if (authError || !authData.user) {
-    return { success: false, error: 'Not authenticated' };
-  }
-
-  if (!input.fileUri) {
-    return { success: false, error: 'File URI is required' };
-  }
-
-  // Create the recording draft
-  const { data: recording, error: createError } = await supabase
-    .from('recordings')
-    .insert({
-      user_id: authData.user.id,
-      name: input.name || null,
-      file_uri: input.fileUri,
-      duration: 0, // Will be updated when finalized
-      status: 'draft',
-      metering: null,
-    })
-    .select()
-    .single();
-
-  if (createError) {
-    return { success: false, error: `Failed to create recording draft: ${createError.message}` };
-  }
-
-  return { success: true, recording };
-}
-
-
-/**
- * Finalize a recording
- *
- * Updates a draft recording with duration, file URI, and metering data,
- * then sets status to "completed".
- *
- * @param supabase - Supabase client (authenticated)
- * @param input - Finalization data
- * @returns The finalized recording
- *
- * Requirements: 12.2
- */
-export async function finalizeRecording(
-  supabase: SupabaseClientType,
-  input: FinalizeRecordingInput
-): Promise<FinalizeRecordingResult> {
-  // Get the current auth user
-  const { data: authData, error: authError } = await supabase.auth.getUser();
-
-  if (authError || !authData.user) {
-    return { success: false, error: 'Not authenticated' };
-  }
-
-  if (!input.recordingId) {
-    return { success: false, error: 'Recording ID is required' };
-  }
-
-  if (input.duration < 0) {
-    return { success: false, error: 'Duration must be non-negative' };
-  }
-
-  if (!input.fileUri) {
-    return { success: false, error: 'File URI is required' };
-  }
-
-  // Update the recording (RLS + user_id check ensures ownership)
-  const { data: recording, error: updateError } = await supabase
-    .from('recordings')
-    .update({
-      duration: input.duration,
-      file_uri: input.fileUri,
-      metering: input.metering || null,
-      status: 'completed',
-    })
-    .eq('id', input.recordingId)
-    .eq('user_id', authData.user.id)
-    .eq('status', 'draft') // Can only finalize drafts
-    .select()
-    .single();
-
-  if (updateError) {
-    if (updateError.code === 'PGRST116') {
-      return { success: false, error: 'Recording not found, not owned by user, or already finalized' };
-    }
-    return { success: false, error: `Failed to finalize recording: ${updateError.message}` };
-  }
-
-  return { success: true, recording };
-}
-
-/**
- * List recordings for the current user
- *
- * Returns only completed recordings, ordered by creation time (newest first).
- *
- * @param supabase - Supabase client (authenticated)
- * @param options - Pagination options
- * @returns Paginated list of completed recordings
- *
- * Requirements: 12.3
- */
-export async function listRecordings(
-  supabase: SupabaseClientType,
-  options?: {
-    limit?: number;
-    cursor?: string; // created_at timestamp for cursor-based pagination
-  }
-): Promise<ListRecordingsResult> {
-  // Get the current auth user
-  const { data: authData, error: authError } = await supabase.auth.getUser();
-
-  if (authError || !authData.user) {
-    return { success: false, error: 'Not authenticated' };
-  }
-
-  const limit = options?.limit || DEFAULT_PAGE_SIZE;
-
-  // Build query - only return completed recordings
-  let query = supabase
-    .from('recordings')
-    .select('*')
-    .eq('user_id', authData.user.id)
-    .eq('status', 'completed')
-    .order('created_at', { ascending: false })
-    .limit(limit + 1); // Fetch one extra to check if there are more
-
-  // Apply cursor if provided
-  if (options?.cursor) {
-    query = query.lt('created_at', options.cursor);
-  }
-
-  const { data: recordings, error: listError } = await query;
-
-  if (listError) {
-    return { success: false, error: `Failed to list recordings: ${listError.message}` };
-  }
-
-  // Check if there are more results
-  const hasMore = recordings && recordings.length > limit;
-  const resultRecordings = hasMore ? recordings.slice(0, limit) : (recordings || []);
-
-  return {
-    success: true,
-    recordings: resultRecordings,
-    hasMore,
-  };
-}
-
-
-/**
- * Update a recording's name
- *
- * Only allows update if the user owns the recording.
- *
- * @param supabase - Supabase client (authenticated)
- * @param recordingId - The ID of the recording to update
- * @param name - The new name for the recording
- * @returns The updated recording
- *
- * Requirements: 12.4
- */
-export async function updateRecordingName(
-  supabase: SupabaseClientType,
-  recordingId: string,
-  name: string | null
-): Promise<UpdateRecordingNameResult> {
-  // Get the current auth user
-  const { data: authData, error: authError } = await supabase.auth.getUser();
-
-  if (authError || !authData.user) {
-    return { success: false, error: 'Not authenticated' };
-  }
-
-  if (!recordingId) {
-    return { success: false, error: 'Recording ID is required' };
-  }
-
-  // Update the recording name (RLS + user_id check ensures ownership)
-  const { data: recording, error: updateError } = await supabase
-    .from('recordings')
-    .update({ name })
-    .eq('id', recordingId)
-    .eq('user_id', authData.user.id)
-    .select()
-    .single();
-
-  if (updateError) {
-    if (updateError.code === 'PGRST116') {
-      return { success: false, error: 'Recording not found or access denied' };
-    }
-    return { success: false, error: `Failed to update recording: ${updateError.message}` };
-  }
-
-  return { success: true, recording };
-}
-
-/**
- * Delete a recording
- *
- * Removes the recording record. Note: This does not delete the associated
- * file from storage - that should be handled separately.
- *
- * @param supabase - Supabase client (authenticated)
- * @param recordingId - The ID of the recording to delete
- * @returns Success or error
- *
- * Requirements: 12.5
- */
-export async function deleteRecording(
-  supabase: SupabaseClientType,
-  recordingId: string
-): Promise<DeleteRecordingResult> {
-  // Get the current auth user
-  const { data: authData, error: authError } = await supabase.auth.getUser();
-
-  if (authError || !authData.user) {
-    return { success: false, error: 'Not authenticated' };
-  }
-
-  if (!recordingId) {
-    return { success: false, error: 'Recording ID is required' };
-  }
-
-  // Delete the recording (RLS + user_id check ensures ownership)
-  const { data, error: deleteError } = await supabase
-    .from('recordings')
-    .delete()
-    .eq('id', recordingId)
-    .eq('user_id', authData.user.id)
-    .select('id')
-    .single();
-
-  if (deleteError) {
-    if (deleteError.code === 'PGRST116') {
-      return { success: false, error: 'Recording not found or access denied' };
-    }
-    return { success: false, error: `Failed to delete recording: ${deleteError.message}` };
-  }
-
-  if (!data) {
-    return { success: false, error: 'Recording not found or access denied' };
-  }
-
-  return { success: true };
-}
-
-/**
- * Get a recording by ID
- *
- * @param supabase - Supabase client (authenticated)
- * @param recordingId - The ID of the recording
- * @returns The recording or error
- */
-export async function getRecordingById(
-  supabase: SupabaseClientType,
-  recordingId: string
-): Promise<{ success: boolean; recording?: Recording; error?: string }> {
-  // Get the current auth user
-  const { data: authData, error: authError } = await supabase.auth.getUser();
-
-  if (authError || !authData.user) {
-    return { success: false, error: 'Not authenticated' };
-  }
-
-  if (!recordingId) {
-    return { success: false, error: 'Recording ID is required' };
-  }
-
-  const { data: recording, error: getError } = await supabase
-    .from('recordings')
-    .select('*')
-    .eq('id', recordingId)
-    .eq('user_id', authData.user.id)
-    .single();
-
-  if (getError) {
-    if (getError.code === 'PGRST116') {
-      return { success: false, error: 'Recording not found' };
-    }
-    return { success: false, error: `Failed to get recording: ${getError.message}` };
-  }
-
-  return { success: true, recording };
-}
-
-export const recordingsService = {
-  createRecordingDraft,
-  finalizeRecording,
-  listRecordings,
-  updateRecordingName,
-  deleteRecording,
-  getRecordingById,
-};

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

@@ -1,83 +0,0 @@
-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;