@nextsparkjs/theme-default 0.1.0-beta.17 → 0.1.0-beta.170

package/tests/cypress/src/features/BillingPOM.ts

@@ -0,0 +1,385 @@
+/**
+ * Billing Page Object Model
+ *
+ * Encapsulates interactions with the billing settings page:
+ * - /dashboard/settings/billing
+ *
+ * UI Elements:
+ * - Current plan card with usage
+ * - Billing history (invoices)
+ * - Payment method
+ * - Plan features
+ *
+ * @version 3.0 - Uses centralized selectors from cySelector()
+ */
+
+import { BasePOM } from '../core/BasePOM'
+import { cySelector } from '../selectors'
+
+export class BillingPOM extends BasePOM {
+  /**
+   * Selectors using centralized cySelector()
+   */
+  get selectors() {
+    return {
+      main: cySelector('settings.billing.main'),
+      header: cySelector('settings.billing.header'),
+      upgradePlan: cySelector('settings.billing.upgradePlan'),
+      addPayment: cySelector('settings.billing.addPayment'),
+      invoicesTable: cySelector('settings.billing.invoicesTableAlt'),
+      invoicesRow: cySelector('settings.billing.invoicesRow'),
+      invoicesLoadMore: cySelector('settings.billing.invoicesLoadMore'),
+      invoiceStatusBadge: cySelector('settings.billing.invoiceStatusBadge'),
+      paymentMethod: cySelector('settings.billing.paymentMethod'),
+      usage: cySelector('settings.billing.usage'),
+      usageDashboard: cySelector('settings.billing.usageDashboard'),
+      pricingTable: cySelector('settings.pricing.table'),
+      pricingSettingsTable: cySelector('settings.pricing.settingsTable'),
+      featurePlaceholder: (feature: string) => cySelector('settings.features.placeholder', { feature }),
+      featureContent: (feature: string) => cySelector('settings.features.content', { feature }),
+      placeholderUpgradeBtn: cySelector('settings.features.placeholderUpgradeBtn'),
+    }
+  }
+
+  // Factory method for clean instantiation
+  static create(): BillingPOM {
+    return new BillingPOM()
+  }
+
+  // ============================================================
+  // NAVIGATION
+  // ============================================================
+
+  /**
+   * Visit billing settings page
+   * Uses failOnStatusCode: false to handle intermittent 500 errors
+   */
+  visitBilling(): BillingPOM {
+    cy.visit('/dashboard/settings/billing', { timeout: 60000, failOnStatusCode: false })
+    cy.url().should('include', '/billing')
+    return this
+  }
+
+  /**
+   * Visit pricing page
+   */
+  visitPricing(): BillingPOM {
+    cy.visit('/pricing', { timeout: 30000 })
+    return this
+  }
+
+  // ============================================================
+  // SELECTORS
+  // ============================================================
+
+  /**
+   * Main billing container
+   */
+  getBillingMain(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.main)
+  }
+
+  /**
+   * Billing header
+   */
+  getBillingHeader(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.header)
+  }
+
+  /**
+   * Upgrade plan button
+   */
+  getUpgradeButton(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.upgradePlan)
+  }
+
+  /**
+   * Add payment method button
+   */
+  getAddPaymentButton(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.addPayment)
+  }
+
+  /**
+   * Load more invoices button
+   */
+  getLoadMoreInvoicesButton(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.invoicesLoadMore)
+  }
+
+  /**
+   * Invoices table
+   */
+  getInvoicesTable(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.invoicesTable)
+  }
+
+  /**
+   * Invoice rows
+   */
+  getInvoiceRows(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.invoicesRow)
+  }
+
+  /**
+   * Invoice status badges
+   */
+  getInvoiceStatusBadge(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.invoiceStatusBadge)
+  }
+
+  // ============================================================
+  // ASSERTIONS
+  // ============================================================
+
+  /**
+   * Assert billing page is visible
+   */
+  assertBillingPageVisible(): BillingPOM {
+    this.getBillingMain().should('be.visible')
+    this.getBillingHeader().should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert current plan is displayed
+   * @param planName Expected plan name (e.g., "Free", "Pro")
+   */
+  assertCurrentPlan(planName: string): BillingPOM {
+    cy.contains(planName).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert upgrade button is visible
+   */
+  assertUpgradeButtonVisible(): BillingPOM {
+    this.getUpgradeButton().should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert invoices are displayed
+   * @param count Expected number of invoices (0 for empty state)
+   */
+  assertInvoicesCount(count: number): BillingPOM {
+    if (count === 0) {
+      // Empty state
+      cy.contains(/no invoices|sin facturas/i).should('be.visible')
+    } else {
+      this.getInvoiceRows().should('have.length.at.least', count)
+    }
+    return this
+  }
+
+  /**
+   * Assert no payment method message
+   */
+  assertNoPaymentMethod(): BillingPOM {
+    // Match both English and Spanish:
+    // EN: "No payment method configured"
+    // ES: "No hay método de pago configurado"
+    cy.contains(/no payment method configured|no hay método de pago configurado/i).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert usage is displayed
+   */
+  assertUsageVisible(): BillingPOM {
+    // Check for usage numbers (format: X / Y)
+    cy.contains(/\d+\s*\/\s*\d+/).should('be.visible')
+    return this
+  }
+
+  // ============================================================
+  // ACTIONS
+  // ============================================================
+
+  /**
+   * Click upgrade button
+   */
+  clickUpgrade(): BillingPOM {
+    this.getUpgradeButton().click()
+    return this
+  }
+
+  /**
+   * Click add payment button
+   */
+  clickAddPayment(): BillingPOM {
+    this.getAddPaymentButton().click()
+    return this
+  }
+
+  /**
+   * Load more invoices
+   */
+  loadMoreInvoices(): BillingPOM {
+    this.getLoadMoreInvoicesButton().click()
+    return this
+  }
+
+  // ============================================================
+  // FEATURE GATE ASSERTIONS
+  // ============================================================
+
+  /**
+   * Assert feature is blocked (shows upgrade message)
+   * @param featureName Name of the blocked feature
+   */
+  assertFeatureBlocked(featureName: string): BillingPOM {
+    cy.contains(new RegExp(`(upgrade|plan required|not available)`, 'i')).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert feature is available
+   * @param featureName Name of the feature
+   */
+  assertFeatureAvailable(featureName: string): BillingPOM {
+    // No upgrade message for this feature
+    cy.contains(featureName).should('be.visible')
+    return this
+  }
+
+  // ============================================================
+  // PRICING PAGE METHODS
+  // ============================================================
+
+  /**
+   * Visit pricing settings page
+   */
+  visitPricingSettings(): BillingPOM {
+    cy.visit('/dashboard/settings/pricing', { timeout: 30000 })
+    return this
+  }
+
+  /**
+   * Get pricing table
+   */
+  getPricingTable(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(`${this.selectors.pricingTable}, ${this.selectors.pricingSettingsTable}`)
+  }
+
+  /**
+   * Assert pricing table is visible
+   */
+  assertPricingTableVisible(): BillingPOM {
+    this.getPricingTable().should('be.visible')
+    return this
+  }
+
+  // ============================================================
+  // FEATURE PAGES METHODS
+  // ============================================================
+
+  /**
+   * Visit feature analytics page
+   */
+  visitAnalyticsFeature(): BillingPOM {
+    cy.visit('/dashboard/features/analytics', { timeout: 30000 })
+    return this
+  }
+
+  /**
+   * Visit feature webhooks page
+   */
+  visitWebhooksFeature(): BillingPOM {
+    cy.visit('/dashboard/features/webhooks', { timeout: 30000 })
+    return this
+  }
+
+  /**
+   * Visit feature automation page
+   */
+  visitAutomationFeature(): BillingPOM {
+    cy.visit('/dashboard/features/automation', { timeout: 30000 })
+    return this
+  }
+
+  /**
+   * Get feature placeholder
+   */
+  getFeaturePlaceholder(feature: string): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.featurePlaceholder(feature))
+  }
+
+  /**
+   * Assert feature placeholder is visible
+   */
+  assertFeaturePlaceholderVisible(feature: string): BillingPOM {
+    this.getFeaturePlaceholder(feature).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert feature content is visible (user has access)
+   */
+  assertFeatureContentVisible(feature: string): BillingPOM {
+    cy.get(this.selectors.featureContent(feature)).should('be.visible')
+    return this
+  }
+
+  /**
+   * Get placeholder upgrade button
+   */
+  getPlaceholderUpgradeButton(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(this.selectors.placeholderUpgradeBtn)
+  }
+
+  /**
+   * Click placeholder upgrade button
+   */
+  clickPlaceholderUpgrade(): BillingPOM {
+    this.getPlaceholderUpgradeButton().click()
+    return this
+  }
+
+  // ============================================================
+  // USAGE METHODS
+  // ============================================================
+
+  /**
+   * Get usage section
+   */
+  getUsageSection(): Cypress.Chainable<JQuery<HTMLElement>> {
+    return cy.get(`${this.selectors.usage}, ${this.selectors.usageDashboard}`)
+  }
+
+  /**
+   * Assert usage limit is displayed
+   * @param limitName Name of the limit (e.g., "tasks", "customers")
+   * @param current Current usage (optional, just checks format if not provided)
+   * @param max Maximum allowed (optional)
+   */
+  assertUsageLimit(limitName: string, current?: number, max?: number): BillingPOM {
+    if (current !== undefined && max !== undefined) {
+      cy.contains(new RegExp(`${current}\\s*/\\s*${max}`, 'i')).should('be.visible')
+    } else {
+      // Just check for X / Y format
+      cy.contains(/\d+\s*\/\s*\d+/).should('be.visible')
+    }
+    return this
+  }
+
+  // ============================================================
+  // PAYMENT METHODS
+  // ============================================================
+
+  /**
+   * Get payment method section
+   */
+  getPaymentMethodSection(): Cypress.Chainable<JQuery<HTMLElement>> {
+    const paymentMethodAlt = cySelector('settings.billing.paymentMethodAlt')
+    return cy.get(`${this.selectors.paymentMethod}, ${paymentMethodAlt}`)
+  }
+
+  /**
+   * Assert payment method exists
+   */
+  assertPaymentMethodExists(): BillingPOM {
+    this.getPaymentMethodSection().should('be.visible')
+    return this
+  }
+}

package/tests/cypress/src/features/DashboardPOM.ts

@@ -0,0 +1,271 @@
+/**
+ * DashboardPOM - Page Object Model for Dashboard Navigation
+ *
+ * Handles dashboard shell navigation and access control:
+ * - Sidebar navigation links (nav-link-entity-{slug})
+ * - Entity page access verification
+ * - Quick create menu
+ * - Dashboard page access
+ *
+ * Uses selectors from centralized selectors.ts
+ *
+ * NOTE: For CRUD operations on entities, use entity-specific POMs:
+ * - CustomersPOM, TasksPOM, etc. from entities/
+ * - These extend DashboardEntityPOM for full CRUD support
+ *
+ * NOTE: For team switching, use TeamSwitcherPOM from components/
+ */
+
+import { BasePOM } from '../core/BasePOM'
+import { cySelector } from '../selectors'
+
+export class DashboardPOM extends BasePOM {
+  // ============================================
+  // FACTORY METHOD
+  // ============================================
+
+  static create(): DashboardPOM {
+    return new DashboardPOM()
+  }
+
+  // ============================================
+  // SELECTORS
+  // ============================================
+
+  get selectors() {
+    return {
+      // Main container
+      container: cySelector('dashboard.container'),
+
+      // Navigation
+      navContainer: cySelector('dashboard.navigation.container'),
+      navDashboard: cySelector('dashboard.navigation.dashboardLink'),
+      navEntity: (slug: string) => cySelector('dashboard.navigation.entityLink', { slug }),
+      navSection: (id: string) => cySelector('dashboard.navigation.section', { id }),
+      navSectionLabel: (id: string) => cySelector('dashboard.navigation.sectionLabel', { id }),
+      navSectionItem: (sectionId: string, itemId: string) => cySelector('dashboard.navigation.sectionItem', { sectionId, itemId }),
+
+      // Topnav
+      topnavContainer: cySelector('dashboard.topnav.container'),
+      topnavSidebarToggle: cySelector('dashboard.topnav.sidebarToggle'),
+      topnavLogo: cySelector('dashboard.topnav.logo'),
+      topnavSearchContainer: cySelector('dashboard.topnav.search.container'),
+      topnavActions: cySelector('dashboard.topnav.actions'),
+      topnavNotificationsTrigger: cySelector('dashboard.topnav.notifications.trigger'),
+      topnavQuickCreateTrigger: cySelector('dashboard.topnav.quickCreate.trigger'),
+      topnavQuickCreateContent: cySelector('dashboard.topnav.quickCreate.content'),
+      topnavQuickCreateLink: (slug: string) => cySelector('dashboard.topnav.quickCreate.link', { slug }),
+      topnavUserMenuTrigger: cySelector('dashboard.topnav.userMenu.trigger'),
+      topnavUserMenuContent: cySelector('dashboard.topnav.userMenu.content'),
+      topnavUserMenuItem: (icon: string) => cySelector('dashboard.topnav.userMenu.item', { icon }),
+      topnavUserMenuAction: (action: string) => cySelector('dashboard.topnav.userMenu.action', { action }),
+      topnavHelp: cySelector('dashboard.topnav.help'),
+      topnavThemeToggle: cySelector('dashboard.topnav.themeToggle'),
+      topnavSuperadmin: cySelector('dashboard.topnav.superadmin'),
+      topnavDevtools: cySelector('dashboard.topnav.devtools'),
+      topnavUserLoading: cySelector('dashboard.topnav.userLoading'),
+      topnavSignin: cySelector('dashboard.topnav.signin'),
+      topnavSignup: cySelector('dashboard.topnav.signup'),
+      // Topnav settings menu
+      topnavSettingsMenuTrigger: cySelector('dashboard.topnav.settingsMenu.trigger'),
+      topnavSettingsMenuContent: cySelector('dashboard.topnav.settingsMenu.content'),
+      topnavSettingsMenuItem: (index: number) => cySelector('dashboard.topnav.settingsMenu.item', { index }),
+      topnavSettingsMenuLink: (index: number) => cySelector('dashboard.topnav.settingsMenu.link', { index }),
+      // Topnav mobile menu
+      topnavMobileMenuToggle: cySelector('dashboard.topnav.mobileMenu.toggle'),
+      topnavMobileMenuContainer: cySelector('dashboard.topnav.mobileMenu.container'),
+      topnavMobileMenuActions: cySelector('dashboard.topnav.mobileMenu.actions'),
+      topnavMobileMenuUserInfo: cySelector('dashboard.topnav.mobileMenu.userInfo'),
+      topnavMobileMenuLinkProfile: cySelector('dashboard.topnav.mobileMenu.linkProfile'),
+      topnavMobileMenuLinkSettings: cySelector('dashboard.topnav.mobileMenu.linkSettings'),
+      topnavMobileMenuLinkBilling: cySelector('dashboard.topnav.mobileMenu.linkBilling'),
+      topnavMobileMenuSignout: cySelector('dashboard.topnav.mobileMenu.signout'),
+      topnavMobileMenuSuperadmin: cySelector('dashboard.topnav.mobileMenu.superadmin'),
+      topnavMobileMenuDevtools: cySelector('dashboard.topnav.mobileMenu.devtools'),
+
+      // Sidebar
+      sidebarContainer: cySelector('dashboard.sidebar.container'),
+      sidebarHeader: cySelector('dashboard.sidebar.header'),
+      sidebarLogo: cySelector('dashboard.sidebar.logo'),
+      sidebarContent: cySelector('dashboard.sidebar.content'),
+      sidebarFooter: cySelector('dashboard.sidebar.footer'),
+
+      // Mobile Topbar
+      mobileTopbarContainer: cySelector('dashboard.mobile.topbar.container'),
+      mobileTopbarUserProfile: cySelector('dashboard.mobile.topbar.userProfile'),
+      mobileTopbarNotifications: cySelector('dashboard.mobile.topbar.notifications'),
+      mobileTopbarThemeToggle: cySelector('dashboard.mobile.topbar.themeToggle'),
+
+      // Mobile Bottom Nav
+      mobileBottomNavContainer: cySelector('dashboard.mobile.bottomNav.container'),
+      mobileBottomNavItem: (id: string) => cySelector('dashboard.mobile.bottomNav.item', { id }),
+
+      // Mobile More Sheet
+      mobileMoreSheetContainer: cySelector('dashboard.mobile.moreSheet.container'),
+      mobileMoreSheetItem: (id: string) => cySelector('dashboard.mobile.moreSheet.item', { id }),
+      mobileMoreSheetSuperadminLink: cySelector('dashboard.mobile.moreSheet.superadminLink'),
+      mobileMoreSheetTeamSwitcher: cySelector('dashboard.mobile.moreSheet.teamSwitcher'),
+      mobileMoreSheetSignoutButton: cySelector('dashboard.mobile.moreSheet.signoutButton'),
+
+      // Mobile Quick Create Sheet
+      mobileQuickCreateSheetContainer: cySelector('dashboard.mobile.quickCreateSheet.container'),
+      mobileQuickCreateSheetItem: (slug: string) => cySelector('dashboard.mobile.quickCreateSheet.item', { slug }),
+
+      // Entity table (for verifying entity pages)
+      entityPage: (slug: string) => cySelector('entities.page.container', { slug }),
+      entityTable: (slug: string) => cySelector('entities.table.container', { slug }),
+      entityAddButton: (slug: string) => cySelector('entities.table.addButton', { slug }),
+
+      // Legacy aliases (for backward compatibility during transition)
+      /** @deprecated Use navContainer instead */
+      navMain: cySelector('dashboard.navigation.container'),
+      /** @deprecated Use topnavQuickCreateTrigger instead */
+      quickCreateButton: cySelector('dashboard.topnav.quickCreate.trigger'),
+      /** @deprecated Use topnavQuickCreateContent instead */
+      quickCreateDropdown: cySelector('dashboard.topnav.quickCreate.content'),
+      /** @deprecated Use topnavQuickCreateLink instead */
+      quickCreateLink: (slug: string) => cySelector('dashboard.topnav.quickCreate.link', { slug }),
+    }
+  }
+
+  // ============================================
+  // NAVIGATION
+  // ============================================
+
+  /**
+   * Navigate to main dashboard
+   */
+  visitDashboard() {
+    cy.visit('/dashboard', { timeout: 60000 })
+    return this
+  }
+
+  /**
+   * Navigate to an entity page
+   */
+  visitEntity(slug: string) {
+    cy.visit(`/dashboard/${slug}`, { timeout: 60000 })
+    return this
+  }
+
+  /**
+   * Navigate to entity via sidebar link
+   */
+  clickEntityNav(slug: string) {
+    cy.get(this.selectors.navEntity(slug)).click()
+    return this
+  }
+
+  /**
+   * Navigate to dashboard via sidebar link
+   */
+  clickDashboardNav() {
+    cy.get(this.selectors.navDashboard).click()
+    return this
+  }
+
+  // ============================================
+  // QUICK CREATE
+  // ============================================
+
+  /**
+   * Open quick create dropdown
+   */
+  openQuickCreate() {
+    cy.get(this.selectors.topnavQuickCreateTrigger).click()
+    return this
+  }
+
+  /**
+   * Click quick create link for an entity
+   */
+  quickCreate(slug: string) {
+    this.openQuickCreate()
+    cy.get(this.selectors.topnavQuickCreateLink(slug)).click()
+    return this
+  }
+
+  // ============================================
+  // ASSERTIONS
+  // ============================================
+
+  /**
+   * Assert dashboard page is visible
+   */
+  assertDashboardVisible() {
+    cy.url().should('include', '/dashboard')
+    return this
+  }
+
+  /**
+   * Assert entity nav link is visible
+   */
+  assertEntityNavVisible(slug: string) {
+    cy.get(this.selectors.navEntity(slug)).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert entity nav link is NOT visible (restricted access)
+   */
+  assertEntityNavNotVisible(slug: string) {
+    cy.get(this.selectors.navEntity(slug)).should('not.exist')
+    return this
+  }
+
+  /**
+   * Assert entity page is accessible (table container visible)
+   */
+  assertEntityPageVisible(slug: string) {
+    cy.get(this.selectors.entityTable(slug)).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert entity add button is visible (create permission)
+   */
+  assertEntityAddButtonVisible(slug: string) {
+    cy.get(this.selectors.entityAddButton(slug)).should('be.visible')
+    return this
+  }
+
+  /**
+   * Assert entity add button is NOT visible (no create permission)
+   */
+  assertEntityAddButtonNotVisible(slug: string) {
+    cy.get(this.selectors.entityAddButton(slug)).should('not.exist')
+    return this
+  }
+
+  /**
+   * Assert quick create button is visible
+   */
+  assertQuickCreateVisible() {
+    cy.get(this.selectors.topnavQuickCreateTrigger).should('be.visible')
+    return this
+  }
+
+  // ============================================
+  // WAITS
+  // ============================================
+
+  /**
+   * Wait for dashboard to be fully loaded
+   */
+  waitForDashboard() {
+    cy.url().should('include', '/dashboard')
+    cy.get(this.selectors.navContainer, { timeout: 15000 }).should('be.visible')
+    return this
+  }
+
+  /**
+   * Wait for entity page to be loaded
+   */
+  waitForEntityPage(slug: string) {
+    cy.url().should('include', `/dashboard/${slug}`)
+    cy.get(this.selectors.entityTable(slug), { timeout: 15000 }).should('be.visible')
+    return this
+  }
+}
+
+export default DashboardPOM