App Model

{
  // Identity
  packageName: string,              // Unique identifier (e.g., "com.translator.app")
  name: string,                     // Display name
  description: string,              // App description
  version: string,                  // Semantic version
  type: AppType,                    // 'AGENT' | 'UI' | 'HARDWARE'
  
  // Authentication
  hashedApiKey: string,             // Hashed API key for authentication
  hashedEndpointSecret?: string,    // Optional webhook secret
  
  // Store Management
  appStoreStatus: AppStoreStatus,   // Development/Published status
  isPublic: boolean,                // Publicly available flag
  reviewNotes?: string,             // Review process notes
  reviewedBy?: string,              // Reviewer identifier
  reviewedAt?: Date,                // Review timestamp
  
  // Organization
  organizationId?: ObjectId,        // Owning organization
  
  // Configuration
  settings?: AppSetting[],          // Available settings
  permissions?: Permission[],       // Required permissions
  tools?: ToolSchema[],            // AI tool definitions
  webhooks?: WebhookConfig,        // Webhook endpoints
  hardware?: HardwareRequirement[], // Hardware requirements
  
  // Metadata
  logo?: string,                    // App logo URL
  smallLogo?: string,              // Small logo variant
  bannerImage?: string,            // Store banner image
  screenshots?: string[],          // App screenshots
  demoVideoUrl?: string,           // Demo video
  supportUrl?: string,             // Support contact
  documentationUrl?: string,       // Documentation link
  websiteUrl?: string,             // Marketing website
  privacyPolicyUrl?: string,       // Privacy policy
  termsOfServiceUrl?: string,      // Terms of service
  
  // Analytics
  installCount?: number,           // Total installations
  activeUsers?: number,            // Active user count
  rating?: number,                 // Average rating
  featured?: boolean,              // Featured app flag
  
  // Timestamps
  createdAt: Date,
  updatedAt: Date
}

enum AppType {
  AGENT = 'AGENT',      // AI-powered apps
  UI = 'UI',           // Visual interface apps
  HARDWARE = 'HARDWARE' // Hardware integration apps
}

type AppStoreStatus = 
  | 'DEVELOPMENT'    // In development, not public
  | 'SUBMITTED'      // Submitted for review
  | 'REJECTED'       // Failed review
  | 'PUBLISHED'      // Available in store

settings: [{
  key: string,                    // Setting identifier
  type: AppSettingType,          // STRING | NUMBER | BOOLEAN | SELECT
  label: string,                 // Display label
  description?: string,          // Help text
  defaultValue?: any,           // Default value
  required?: boolean,           // Required flag
  options?: Array<{             // For SELECT type
    label: string,
    value: string
  }>,
  min?: number,                 // For NUMBER type
  max?: number,
  step?: number
}]

permissions: [{
  type: PermissionType,         // Permission category
  reason: string,               // Why it's needed
  required: boolean,            // Required vs optional
  settings?: any               // Permission-specific config
}]

hardware: [{
  type: HardwareType,                    // DISPLAY | CAMERA | etc.
  level: HardwareRequirementLevel,       // REQUIRED | OPTIONAL
  minVersion?: string,                   // Minimum version
  features?: string[]                    // Specific features
}]

webhooks: {
  start?: {
    url: string,                        // Webhook URL
    headers?: Record<string, string>,   // Custom headers
    timeout?: number                    // Timeout in ms
  },
  stop?: { /* same structure */ },
  toolCall?: { /* same structure */ }
}

tools: [{
  name: string,                         // Tool identifier
  description: string,                  // What it does
  inputSchema: {                        // JSON Schema
    type: 'object',
    properties: { /* ... */ },
    required: string[]
  },
  outputSchema?: { /* ... */ }          // Expected output
}]

// Find app
const app = await App.findOne({ packageName: 'com.translator.app' });

// Update app
app.version = '1.2.0';
await app.save();

// Soft delete
app.isPublic = false;
app.appStoreStatus = 'DEVELOPMENT';
await app.save();

// Find all published apps
const publishedApps = await App.find({ 
  appStoreStatus: 'PUBLISHED',
  isPublic: true 
});

// Find organization apps
const orgApps = await App.find({ 
  organizationId: orgId 
});

// Submit for review
app.appStoreStatus = 'SUBMITTED';
app.reviewNotes = 'Ready for review';
await app.save();

// Review decision
app.appStoreStatus = 'PUBLISHED';
app.reviewedBy = '[email protected]';
app.reviewedAt = new Date();
await app.save();

const app = new App({
  packageName: 'com.example.translator',
  name: 'Universal Translator',
  description: 'Real-time translation for smart glasses',
  version: '1.0.0',
  type: 'UI',
  
  // Organization
  organizationId: orgId,
  
  // Settings
  settings: [
    {
      key: 'targetLanguage',
      type: 'SELECT',
      label: 'Target Language',
      defaultValue: 'es',
      options: [
        { label: 'Spanish', value: 'es' },
        { label: 'French', value: 'fr' }
      ]
    }
  ],
  
  // Permissions
  permissions: [
    {
      type: 'TRANSCRIPTION',
      reason: 'To capture speech for translation',
      required: true
    },
    {
      type: 'DISPLAY',
      reason: 'To show translations',
      required: true
    }
  ],
  
  // Webhooks
  webhooks: {
    start: {
      url: 'https://api.example.com/webhook/start',
      headers: { 'X-API-Key': 'webhook-key' }
    }
  },
  
  // Store info
  appStoreStatus: 'DEVELOPMENT',
  isPublic: false,
  logo: 'https://example.com/logo.png',
  supportUrl: '[email protected]'
});

// Hash the API key before saving
app.hashedApiKey = hashApiKey('app_secret_key');
await app.save();

// Get user's installed apps
const user = await User.findOne({ email: '[email protected]' });
const installedPackageNames = user.installedApps.map(a => a.packageName);

// Find app details
const apps = await App.find({
  packageName: { $in: installedPackageNames },
  appStoreStatus: 'PUBLISHED'
}).lean();