Thunder Pack Laravel Package

Fixed

• Syntax error in CreateTenantWithPlan component (unexpected single-quoted string in $messages array)

Added

• Terms and privacy acceptance system for tenant creation
  • Added terms_accepted and privacy_accepted boolean properties to CreateTenantWithPlan component
  • Added validation rules (required|accepted) for both acceptance fields
  • Added Spanish error messages for acceptance validation failures
  • Store terms_accepted_at and privacy_accepted_at timestamps when creating tenant
  • Added acceptance checkboxes to tenant creation modal UI with links to legal pages
  • Reset acceptance fields when modal is closed
• Database support for acceptance tracking
  • Added terms_accepted_at and privacy_accepted_at (timestamp nullable) to tenants table
  • Updated Tenant model with new fillable fields and datetime casts

Changed

• Tenant creation now requires explicit acceptance of terms and privacy policy
• CreateTenantWithPlan modal now includes acceptance section with proper styling and validation

Added

• Create subscription functionality in SuperAdmin tenant detail page
  • New "Crear Suscripción" button in Subscriptions tab of /sa/tenants/{id}
  • Modal form to create manual subscriptions with plan selection, days, and trial option
  • Methods openSubscriptionForm(), createSubscription(), closeSubscriptionForm() in TenantShow component
• Subscription status badge now displays in tenant list (/sa/tenants)
  • Correctly differentiates "Período de Prueba" (trial) vs "Activo" (paid)
  • Uses subscription-status-badge component for consistency

Fixed

• Dark mode support for action buttons in SubscriptionShow component
  • Fixed "Marcar Vencida" button being invisible in dark mode (white text on white background)
  • All action buttons now have proper dark mode variants (Renovar, Activar, Marcar Vencida, Cancelar)
• Removed duplicate "Usuarios" link in SuperAdmin sidebar
• Fixed duplicate resetPhoneForm() method in TenantShow component

Changed

• TenantsIndex now uses subscription-status-badge component instead of manual status badges
  • Provides consistent UX between tenant selector and admin panel

Internal

• Skipped version (testing release)

Fixed

• CRITICAL FIX: Trial subscriptions now set BOTH trial_ends_at AND ends_at fields
  • Previously, trial subscriptions only set trial_ends_at and left ends_at as NULL
  • This broke agent validations that rely on ends_at for expiration checks
  • Agents can now properly validate subscription expiration dates during trial period
• Preserve trial_ends_at historical value when activating/renewing paid subscriptions
  • Previously, trial_ends_at was set to NULL during renewal, losing historical record
  • Trial end date now persists for auditing and historical tracking purposes

Added

• Migration to backfill ends_at for existing trial subscriptions (sets ends_at = trial_ends_at where NULL)

Changed

• SubscriptionService::activateManual() - Always sets ends_at regardless of trial status
• SubscriptionService::renewManual() - No longer clears trial_ends_at during renewal

Added

• TenantsDelete component with confirmation flow and safety checks
• Users tab in TenantShow (/sa/tenants/{id}) displaying tenant's users with roles and status
• Visual warnings when deleting tenant with active subscription (blocks deletion)
• Tenant deletion requires typing slug for confirmation
• Delete button in TenantShow header

Changed

• TenantShow now has 4 tabs: Información, Usuarios, Suscripciones, WhatsApp
• Users tab shows role badges (Owner, Admin, Member) and Super Admin status
• Improved tenant deletion safety with user count, subscription check, and impact warnings

Fixed

• Registered missing Livewire components in ServiceProvider (TenantsCreate, TenantsEdit, UsersIndex, UsersCreate, UsersShow)
• Fixed "Unable to find component" error when using tenant and user CRUD operations

Changed

• Enhanced Tenants table with storage progress bar and color-coded alerts (>90% red, >70% yellow)
• Added "Created" column in Tenants table showing both absolute and relative dates
• Improved Subscriptions table with "Start Date" column and expiration date visual alerts
• Added plan name under subscription status badge in Tenants table
• Improved status badges with Spanish translations (Activa, Prueba, Vencida, Cancelada)
• Added brand_name display in tenant row (if exists)
• Enhanced storage display with percentage bar and color indicators

Added

• Complete Tenant CRUD - Full tenant management in SuperAdmin panel
  • TenantsCreate component for creating new tenants with form validation
  • TenantsEdit component for updating tenant information
  • Auto-generation of unique slugs from tenant names
  • Storage quota management in GB (converted to bytes internally)
  • Routes: /sa/tenants/create, /sa/tenants/{tenant}/edit
• Complete User Management System - Full user CRUD and tenant assignment
  • UsersIndex component with search and filtering (by type, role, tenant)
  • UsersShow component with inline editing of basic info and password
  • UsersCreate component with multi-tenant assignment
  • User-tenant relationship management (add/remove tenants, change roles)
  • Super Admin badge display and filtering
  • Routes: /sa/users, /sa/users/create, /sa/users/{user}
• UI/UX Improvements
  • Converted TenantsIndex from card layout to compact table format
  • Converted SubscriptionsIndex from card layout to table format
  • Added "Users" link to SuperAdmin sidebar navigation
  • Consistent minimalist design across all SuperAdmin components
  • Dark mode support in all new components

Changed

• TenantsIndex now uses table format matching PlansIndex style
• SubscriptionsIndex now uses table format with improved stats cards
• SuperAdmin sidebar menu reordered: Dashboard → Organizaciones → Usuarios → Suscripciones → Planes

Fixed

• Storage display bug - Changed from MB to GB in TenantsIndex (now correctly divides by 1024³ instead of 1024²)
• Storage quota now displays as "X.XX GB / Y GB" format consistently

Documentation

• Added comprehensive Copilot instructions file (.github/copilot-instructions.md)
• Documented package publishing workflow and semantic versioning guidelines
• Added UI design system standards and component creation patterns

Added

• Lemon Squeezy Payment Gateway Integration - Full payment gateway abstraction system
  • PaymentGatewayInterface for multi-gateway support
  • ManualGateway encapsulating existing manual payment logic
  • LemonSqueezyGateway with direct API integration (no official package dependency)
  • WebhookController for processing Lemon Squeezy webhooks with signature verification
  • Support for 12 webhook event types (subscription lifecycle, payments, refunds)
  • Automatic subscription creation and updates from webhooks
  • Customer portal URL generation for self-service subscription management
  • Plan upgrade/downgrade detection and handling
• Database Schema Updates
  • Added lemon_monthly_variant_id and lemon_yearly_variant_id to plans table
  • Added yearly_price_cents to plans table for annual billing support
  • Added billing_cycle (monthly/yearly) to subscriptions table
  • Added next_billing_date to subscriptions table (fixes missing field used in code)
• Model Enhancements
  • Plan::getYearlyPrice() accessor for annual pricing
  • Plan::getLemonVariantId($billingCycle) helper method
  • Plan::hasLemonSqueezyIntegration() check method
  • Added billing_cycle and next_billing_date to Subscription fillable/casts
• SubscriptionService Enhancements
  • getGateway($provider) method for gateway resolution
  • createCheckout($tenant, $plan, $provider, $billingCycle) for checkout URL generation
  • clearNotifications() and sendActivationEmail() now public for gateway access
• ChoosePlan Livewire Component
  • Full-featured plan selection UI with monthly/yearly toggle
  • Responsive design with dark mode support
  • Automatic checkout URL generation and redirect to Lemon Squeezy
  • Feature list display from plan JSON data
  • Error handling and loading states
• Configuration
  • Added lemon_squeezy section to config with api_key, store_id, signing_secret
• Routes
  • Added /webhooks/lemon-squeezy webhook endpoint (POST, no auth)
  • Added /plans route for plan selection (auth + tenant required)

Changed

• Payment gateway logic abstracted into pluggable interface system
• Existing manual payment functionality preserved and encapsulated in ManualGateway

Fixed

• Critical: next_billing_date column migration was missing despite being used in code

Documentation

• Added comprehensive LEMON_SQUEEZY_INTEGRATION.md with setup guide, webhook reference, and troubleshooting

Added

• Manual payment recording UI in subscription detail view (/sa/subscriptions/{id})
• Manual next billing date setter with date picker input
• Visual form for registering manual payments with amount, currency, and notes fields

Fixed

• Trial subscriptions now properly set next_billing_date when activated
• Subscription detail view now displays trial_ends_at, ends_at, and next_billing_date fields
• Improved date visibility for trial periods in SuperAdmin panel

Fixed

• TypeError in tenant-limits view when calculating usage percentages with non-numeric values
• BadMethodCallException in plans view when Collection is treated as Model (Livewire serialization issue)
• Improved type checking for current_usage values to prevent division errors

Added

• Database-driven tenant limits system with AvailableLimit model
• Dynamic limit dropdown populated from database instead of hardcoded options
• Comprehensive default limits covering general, storage, communication, API, reporting, business, and technology categories
• Available limits seeder with 18 standard SaaS limits including max_installations
• Categorized limit options with descriptive tooltips
• Integration with installation command for easy setup
• Plan limits management interface - Configure which limits each plan includes with specific values
• Plan features editor - Visual interface to select and configure limits per plan
• Organized limits by categories with individual value inputs

Changed

• TenantLimits component now shows only limits defined in the plan instead of all available limits
• PlansIndex now includes comprehensive limit management interface
• Limits are organized by categories (general, storage, communication, etc.)
• Better limit management with descriptions and units
• Install command now includes available limits seeding

Fixed

• max_installations limit now appears in tenant management dropdown
• Changed default_value field to bigInteger to support large values like storage quotas in bytes
• Core UX issue: TenantLimits now correctly shows only plan-specific limits instead of all system limits
• Plan configuration: Now possible to define which limits each plan includes

Fixed

• Register PlansIndex Livewire component in ServiceProvider (fixes ComponentNotFoundException)

Added

• GB input field with automatic byte conversion for storage quota
• Quick buttons for common storage sizes (1GB, 5GB, 10GB, 50GB, 100GB)
• Real-time display of calculated bytes value
• Better UX: no need to manually calculate bytes from GB

Added

• Plans CRUD: Full management interface for subscription plans in SuperAdmin panel
  • Create, edit, and delete plans
  • Set plan pricing (monthly_price_cents) and currency
  • Configure staff limits and storage quotas
  • View subscription count per plan
  • Prevent deletion of plans with active subscriptions
• New route: /sa/plans (SuperAdmin only)
• New Livewire component: ThunderPack\Livewire\SuperAdmin\PlansIndex
• Added "Planes" link to SuperAdmin sidebar navigation

Changed

• Enhanced Plan model with subscription count relationship
• Updated SuperAdmin layout with Plans navigation item

Fixed

• Update orchestra/testbench to ^10.0 for Laravel 12 compatibility in GitHub Actions

Added

• Subscription status badge now displayed in tenant selector for better visibility
• Extensible SuperAdmin sidebar navigation via partials.superadmin-nav view (allows apps to add custom menu items)

Improved

• Tenant selector UI now shows subscription status inline with tenant name
• SuperAdmin layout more flexible for app-specific customizations

Fixed

• Fix GitHub Actions tests by adding Livewire service provider to TestCase
• Add Thunder-Pack configuration to test environment setup

Added

• SubscriptionStatusBadge Component: New Livewire component to display subscription status
• Visual badges for: Trial, Active, Suspended, Past Due, Canceled, No Subscription
• Interactive tooltips showing expiration/renewal dates
• Color-coded status indicators (green, blue, yellow, orange, red, gray)
• [@subscriptionStatus](https://github.com/subscriptionStatus) Blade directive for easy integration in layouts
• Icon indicators for each subscription state

Features

• Reusable Status Display: Use [@subscriptionStatus](https://github.com/subscriptionStatus) or [@livewire](https://github.com/livewire)('thunder-pack::subscription-status-badge') anywhere
• Automatic Status Detection: Detects trial vs regular subscription states
• Dark Mode Support: Full Tailwind dark mode theming for badges

Fixed

• Fix "Call to a member function format() on null" error in SubscriptionService when creating trials
• Handle both trial_ends_at and ends_at in subscription activation messages
• Improve subscription message to differentiate between trial and regular subscription

Fixed

• Auto-generate unique slug for tenants when creating via CreateTenantWithPlan component
• Added random 4-character suffix to slugs to prevent collisions with duplicate company names
• Slug generation now falls back to timestamp if random suffixes are exhausted

Added

• Self-Service Tenant Creation: New CreateTenantWithPlan Livewire component for user-initiated tenant creation
• Automatic Trial Activation: 7-day trial periods automatically created when new tenants are registered
• Plan Selection UI: Users can now choose plans during tenant creation with pricing and limits displayed
• "Create New Organization" Button: Added to TenantSelector component for easy access to tenant creation

Changed

• Updated SubscriptionService::activateManual() to support trial mode with new $isTrial parameter
• Enhanced TenantSelector to refresh automatically when new tenants are created via event listeners
• Improved empty state messaging in TenantSelector to encourage tenant creation

Security

• Replaced exposed APP_KEY in phpunit.xml with dummy key for security

Added

• Initial stable release
• Multi-tenant SaaS architecture with session-based tenancy
• Subscription management system with flexible plans (monthly/yearly)
• Feature gates for tier-based functionality control
• Plan limits system with soft/hard limits and overrides
• WhatsApp integration for notifications (optional)
• Super Admin panel at /sa/* routes
• Tenant management and switching
• Team invitation system
• Livewire v3 components for interactive UI
• Email notifications for subscription events
• Payment events tracking
• Usage events tracking for analytics
• Middleware stack: tenant, subscription, superadmin
• BelongsToTenant trait for automatic model scoping
• HasTenants trait for user-tenant relationships
• Comprehensive documentation in /docs folder
• Artisan commands for maintenance and testing
• 13 database migrations for complete schema
• Plan seeder with example plans

Features

• Subscription Management: Manual activation, status checking, expiration handling
• Flexible Limits System: Per-tenant limits with overrides, soft/hard enforcement
• Feature Gating: Enable/disable features based on subscription tier
• Multi-Tenancy: Session-based tenant isolation with automatic query scoping
• Team Management: Invite users to tenants with role-based access
• Super Admin Panel: Manage all tenants, subscriptions, and system settings
• WhatsApp Notifications: Optional integration for subscription alerts
• Email Notifications: Automated emails for subscription lifecycle events
• Usage Tracking: Monitor feature usage and enforce limits
• Payment Events: Track all payment-related activities
• Dark Mode Support: Full Tailwind CSS dark mode theming

Documentation

• Installation guide with step-by-step setup
• Flexible limits system documentation
• WhatsApp notifications integration guide
• Quick reference for common tasks
• Implementation summary
• Full feature documentation