@nextsparkjs/theme-default 0.1.0-beta.2 → 0.1.0-beta.21

package/tests/cypress/e2e/_superadmin/subscriptions-overview.cy.ts

@@ -0,0 +1,194 @@
+/// <reference types="cypress" />
+
+/**
+ * Superadmin Subscriptions Overview Tests
+ *
+ * Tests the Superadmin subscriptions overview page:
+ * - Subscriptions dashboard access
+ * - Revenue metrics display
+ * - Plan distribution stats
+ * - Subscription overview
+ *
+ * Note: The route is /superadmin/subscriptions (not /billing)
+ *
+ * Tags: @uat, @feat-superadmin, @superadmin, @subscriptions
+ */
+
+import * as allure from 'allure-cypress'
+
+import { loginAsDefaultSuperadmin } from '../../src/session-helpers'
+import { SuperadminPOM } from '../../src/features/SuperadminPOM'
+
+describe('Superadmin - Subscriptions Overview', {
+  tags: ['@uat', '@feat-superadmin', '@superadmin', '@subscriptions']
+}, () => {
+  const superadmin = SuperadminPOM.create()
+
+  beforeEach(() => {
+    allure.epic('Admin')
+    allure.feature('Subscriptions Overview')
+    allure.story('Platform Subscriptions')
+    loginAsDefaultSuperadmin()
+  })
+
+  describe('ADMIN-SUBS-001: Subscriptions Page Access', { tags: '@smoke' }, () => {
+    it('should access subscriptions overview page', { tags: '@smoke' }, () => {
+      allure.severity('critical')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Validate subscriptions page
+      cy.url().should('include', '/superadmin/subscriptions')
+
+      cy.log('✅ Subscriptions overview accessible')
+    })
+  })
+
+  describe('ADMIN-SUBS-002: Revenue Metrics', () => {
+    it('should display revenue metrics if available', () => {
+      allure.severity('high')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Check for revenue metrics (defensive - page may not have these yet)
+      cy.get('body').then(($body) => {
+        if ($body.find(superadmin.selectors.subscriptionsMrr).length > 0) {
+          cy.get(superadmin.selectors.subscriptionsMrr).should('be.visible')
+          cy.log('✅ MRR metric displayed')
+        } else if ($body.find(superadmin.selectors.subscriptionsRevenue).length > 0) {
+          cy.get(superadmin.selectors.subscriptionsRevenue).should('be.visible')
+          cy.log('✅ Revenue metric displayed')
+        } else {
+          // Check page loads at minimum
+          cy.url().should('include', '/superadmin/subscriptions')
+          cy.log('⚠️ Revenue metrics data-cy not found - page loads OK')
+        }
+      })
+    })
+  })
+
+  describe('ADMIN-SUBS-003: Plan Distribution', () => {
+    it('should display plan distribution stats if available', () => {
+      allure.severity('high')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Check for plan distribution (defensive)
+      cy.get('body').then(($body) => {
+        if ($body.find(superadmin.selectors.subscriptionsPlanDistribution).length > 0) {
+          cy.get(superadmin.selectors.subscriptionsPlanDistribution).should('be.visible')
+          cy.log('✅ Plan distribution displayed')
+        } else if ($body.find('[data-cy^="superadmin-subscriptions-plan-count-"]').length > 0) {
+          cy.get('[data-cy^="superadmin-subscriptions-plan-count-"]').first().should('be.visible')
+          cy.log('✅ Plan counts displayed')
+        } else {
+          cy.url().should('include', '/superadmin/subscriptions')
+          cy.log('⚠️ Plan distribution data-cy not found - page loads OK')
+        }
+      })
+    })
+  })
+
+  describe('ADMIN-SUBS-004: Active Subscriptions Count', () => {
+    it('should display active subscriptions count if available', () => {
+      allure.severity('normal')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Check for subscriptions count (defensive)
+      cy.get('body').then(($body) => {
+        if ($body.find(superadmin.selectors.subscriptionsActiveCount).length > 0) {
+          cy.get(superadmin.selectors.subscriptionsActiveCount).should('be.visible')
+          cy.log('✅ Active subscriptions count displayed')
+        } else {
+          cy.url().should('include', '/superadmin/subscriptions')
+          cy.log('⚠️ Active subscriptions count data-cy not found - page loads OK')
+        }
+      })
+    })
+  })
+
+  describe('ADMIN-SUBS-005: Free vs Paid Teams', () => {
+    it('should display free vs paid teams breakdown if available', () => {
+      allure.severity('normal')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Check for free/paid breakdown (defensive)
+      cy.get('body').then(($body) => {
+        if ($body.find(superadmin.selectors.subscriptionsFreeTeams).length > 0) {
+          cy.get(superadmin.selectors.subscriptionsFreeTeams).should('be.visible')
+          cy.get(superadmin.selectors.subscriptionsPaidTeams).should('be.visible')
+          cy.log('✅ Free vs paid breakdown displayed')
+        } else {
+          cy.url().should('include', '/superadmin/subscriptions')
+          cy.log('⚠️ Free/paid breakdown data-cy not found - page loads OK')
+        }
+      })
+    })
+  })
+
+  describe('ADMIN-SUBS-006: Trial Teams', () => {
+    it('should display teams on trial if available', () => {
+      allure.severity('normal')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Check for trial teams (defensive)
+      cy.get('body').then(($body) => {
+        if ($body.find(superadmin.selectors.subscriptionsTrialTeams).length > 0) {
+          cy.get(superadmin.selectors.subscriptionsTrialTeams).should('be.visible')
+          cy.log('✅ Trial teams displayed')
+        } else {
+          cy.url().should('include', '/superadmin/subscriptions')
+          cy.log('⚠️ Trial teams metric data-cy not found - page loads OK')
+        }
+      })
+    })
+  })
+
+  describe('ADMIN-SUBS-007: Navigate to Teams from Subscriptions', () => {
+    it('should navigate to teams page from subscriptions', () => {
+      allure.severity('normal')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Click on teams nav
+      superadmin.clickNavTeams()
+
+      // 3. Validate on teams page
+      cy.url().should('include', '/superadmin/teams')
+
+      cy.log('✅ Navigation to teams works')
+    })
+  })
+
+  describe('ADMIN-SUBS-008: Navigate Back to Dashboard', () => {
+    it('should navigate back to Superadmin dashboard', () => {
+      allure.severity('normal')
+
+      // 1. Visit Superadmin Subscriptions
+      superadmin.visitSubscriptions()
+
+      // 2. Click on dashboard nav
+      superadmin.clickNavDashboard()
+
+      // 3. Validate back at dashboard
+      cy.url().should('match', /\/superadmin\/?$/)
+      superadmin.assertDashboardVisible()
+
+      cy.log('✅ Navigation to dashboard works')
+    })
+  })
+
+  after(() => {
+    cy.log('✅ Superadmin subscriptions overview tests completed')
+  })
+})

package/tests/cypress/e2e/ai/ai-usage.cy.ts

@@ -0,0 +1,209 @@
+/**
+ * AI Usage Dashboard E2E Tests
+ *
+ * Tests the AI usage tracking dashboard at /dashboard/settings/ai-usage
+ *
+ * Scope:
+ * - Page navigation and loading
+ * - Period selector functionality
+ * - Stats cards display
+ * - Empty state handling
+ * - Loading state visibility
+ *
+ * Limitations:
+ * - Cannot test with real token usage data without LLM provider
+ * - Tests verify UI structure and component rendering
+ * - Actual API data fetching requires backend implementation
+ */
+
+import { loginAsDefaultOwner } from '../../src/session-helpers'
+
+describe('AI Usage Dashboard', {
+  tags: ['@feat-ai', '@ui', '@dashboard']
+}, () => {
+  beforeEach(() => {
+    // Login as owner user with team context
+    loginAsDefaultOwner()
+  })
+
+  describe('AI_USAGE_01: Page loads successfully', () => {
+    it('should navigate to AI usage page and display main container', () => {
+      // Navigate to AI usage dashboard
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Verify URL
+      cy.url().should('include', '/dashboard/settings/ai-usage')
+
+      // Verify page container exists
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+    })
+
+    it('should display page header with title', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Verify page structure (title is rendered in the component)
+      cy.get('[data-cy="ai-usage-page"]').within(() => {
+        // Header should be present (h1 or similar)
+        cy.get('h1').should('exist')
+      })
+    })
+  })
+
+  describe('AI_USAGE_02: Period selector works', () => {
+    it('should display period selector with all options', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Wait for page to load
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Period selector should exist
+      cy.get('[data-cy="ai-usage-period-select"]').should('exist')
+    })
+
+    it('should have correct period options available', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Click period selector to open options
+      cy.get('[data-cy="ai-usage-period-select"]').click()
+
+      // Verify all period options are available
+      // Note: The exact selector for options may vary based on Select component implementation
+      // This is a structural test that verifies the selector is clickable
+      cy.get('[data-cy="ai-usage-period-select"]').should('exist')
+    })
+
+    it('should allow selecting different periods', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Period selector should be interactive
+      cy.get('[data-cy="ai-usage-period-select"]').should('not.be.disabled')
+    })
+  })
+
+  describe('AI_USAGE_03: Stats cards display', () => {
+    it('should display total tokens card', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Wait for page to load (either loading state or data)
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Total tokens card should exist (may show loading or data)
+      cy.get('[data-cy="ai-usage-total-tokens"]', { timeout: 10000 }).should('exist')
+    })
+
+    it('should display total cost card', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Total cost card should exist
+      cy.get('[data-cy="ai-usage-total-cost"]', { timeout: 10000 }).should('exist')
+    })
+
+    it('should display requests card', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Requests card should exist
+      cy.get('[data-cy="ai-usage-requests"]', { timeout: 10000 }).should('exist')
+    })
+
+    it('should display all three stats cards together', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // All three cards should be present
+      cy.get('[data-cy="ai-usage-total-tokens"]').should('exist')
+      cy.get('[data-cy="ai-usage-total-cost"]').should('exist')
+      cy.get('[data-cy="ai-usage-requests"]').should('exist')
+    })
+  })
+
+  describe('AI_USAGE_04: Empty state shown when no data', () => {
+    it('should display daily usage chart container', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Daily usage chart/container should exist
+      // May show "no data" message or actual chart
+      cy.get('[data-cy="ai-usage-chart"]', { timeout: 10000 }).should('exist')
+    })
+
+    it('should handle case when no usage data exists', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // The component should gracefully handle empty data
+      // Either show loading, empty state, or zero values
+      cy.get('[data-cy="ai-usage-total-tokens"]').should('exist')
+
+      // Verify page doesn't crash with no data
+      cy.get('[data-cy="ai-usage-page"]').should('be.visible')
+    })
+  })
+
+  describe('AI_USAGE_05: Loading state visible', () => {
+    it('should show loading state before data loads', () => {
+      // Intercept API call to delay response
+      cy.intercept('GET', '/api/v1/theme/default/ai/usage*', (req) => {
+        req.reply((res) => {
+          // Delay response to ensure loading state is visible
+          res.delay = 1000
+        })
+      }).as('getUsage')
+
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Loading state should be visible initially
+      cy.get('[data-cy="ai-usage-loading"]').should('exist')
+
+      // Wait for API call
+      cy.wait('@getUsage')
+
+      // Loading state should disappear after data loads
+      cy.get('[data-cy="ai-usage-loading"]').should('not.exist')
+    })
+
+    it('should display content after loading completes', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Wait for page to load completely
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Either loading is gone or content is visible
+      cy.get('[data-cy="ai-usage-page"]').within(() => {
+        // At least one of these should be visible
+        cy.get('[data-cy="ai-usage-loading"], [data-cy="ai-usage-total-tokens"]').should('exist')
+      })
+    })
+  })
+
+  describe('Additional UI Elements', () => {
+    it('should display usage by model section if data exists', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      cy.get('[data-cy="ai-usage-page"]').should('exist')
+
+      // Usage by model is conditionally rendered
+      // This test just verifies the selector pattern exists in the component
+      // It may or may not be visible depending on data
+      cy.get('[data-cy="ai-usage-page"]').should('be.visible')
+    })
+
+    it('should be responsive and not have layout issues', () => {
+      cy.visit('/dashboard/settings/ai-usage')
+
+      // Verify page renders without errors
+      cy.get('[data-cy="ai-usage-page"]').should('be.visible')
+
+      // Check that cards are laid out properly
+      cy.get('[data-cy="ai-usage-total-tokens"]').should('be.visible')
+      cy.get('[data-cy="ai-usage-total-cost"]').should('be.visible')
+      cy.get('[data-cy="ai-usage-requests"]').should('be.visible')
+    })
+  })
+})

package/tests/cypress/e2e/ai/chat-api.cy.ts

@@ -0,0 +1,107 @@
+describe('AI Chat API', {
+    tags: ['@api', '@feat-ai', '@crud']
+}, () => {
+    // Test constants - Using superadmin API key for API-level tests
+    const API_KEY = 'test_api_key_for_testing_purposes_only_not_a_real_secret_key_abc123'
+    const TEAM_ID = 'team-personal-superadmin-003'
+    const API_URL = '/api/v1/theme/default/ai/chat'
+
+    const getHeaders = () => ({
+        'Content-Type': 'application/json',
+        'Authorization': `Bearer ${API_KEY}`,
+        'x-team-id': TEAM_ID
+    })
+
+    it('AI_CHAT_001: POST - returns response for valid message', { tags: '@smoke' }, () => {
+        cy.request({
+            method: 'POST',
+            url: API_URL,
+            headers: getHeaders(),
+            body: { message: 'Hello' },
+            failOnStatusCode: false
+        }).then(response => {
+            // If Ollama is down, we might get 500, but we want to check the structure if it succeeds
+            if (response.status === 200) {
+                expect(response.body.success).to.be.true
+                expect(response.body.data.message).to.be.a('string')
+                expect(response.body.data.sessionId).to.be.a('string')
+            } else {
+                // If it fails, it should be likely due to Ollama connection
+                cy.log('Request failed, possibly due to Ollama not running:', response.body)
+            }
+        })
+    })
+
+    it('AI_CHAT_002: POST - returns 400 for empty message', () => {
+        cy.request({
+            method: 'POST',
+            url: API_URL,
+            headers: getHeaders(),
+            body: { message: '' },
+            failOnStatusCode: false
+        }).then(response => {
+            expect(response.status).to.eq(400)
+            expect(response.body.success).to.be.false
+        })
+    })
+
+    it('AI_CHAT_003: POST - returns 401 without authentication', () => {
+        cy.request({
+            method: 'POST',
+            url: API_URL,
+            headers: {
+                'Content-Type': 'application/json',
+                'x-team-id': TEAM_ID
+            },
+            body: { message: 'Hello' },
+            failOnStatusCode: false
+        }).then(response => {
+            expect(response.status).to.eq(401)
+            expect(response.body.success).to.be.false
+        })
+    })
+
+    it('AI_CHAT_004: POST - returns 400 without x-team-id header', () => {
+        cy.request({
+            method: 'POST',
+            url: API_URL,
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${API_KEY}`
+            },
+            body: { message: 'Hello' },
+            failOnStatusCode: false
+        }).then(response => {
+            expect(response.status).to.eq(400)
+            expect(response.body.code).to.eq('TEAM_CONTEXT_REQUIRED')
+        })
+    })
+
+    it('AI_CHAT_005: POST - maintains session context', () => {
+        cy.request({
+            method: 'POST',
+            url: API_URL,
+            headers: getHeaders(),
+            body: { message: 'My name is John' },
+            failOnStatusCode: false
+        }).then(response1 => {
+            if (response1.status === 200) {
+                const sessionId = response1.body.data.sessionId
+
+                cy.request({
+                    method: 'POST',
+                    url: API_URL,
+                    headers: getHeaders(),
+                    body: { message: 'What is my name?', sessionId }
+                }).then(response2 => {
+                    expect(response2.status).to.eq(200)
+                    expect(response2.body.data.sessionId).to.eq(sessionId)
+                    // Note: This assertion depends on the model's capability, so it might be flaky
+                    // expect(response2.body.data.message.toLowerCase()).to.include('john')
+                })
+            } else {
+                cy.log('Skipping session test - Ollama not running')
+            }
+        })
+    })
+})