@nextsparkjs/core 0.1.0-beta.3 → 0.1.0-beta.5

package/templates/app/api/v1/[entity]/[id]/child/[childType]/route.ts

@@ -7,7 +7,7 @@
 import { NextRequest, NextResponse } from 'next/server'
 import { queryWithRLS } from '@nextsparkjs/core/lib/db'
 import { resolveEntityFromUrl } from '@nextsparkjs/core/lib/api/entity/resolver'
-import { getChildEntities, getEntity, type EntityName } from '@nextsparkjs/core/lib/entities/queries'
+import { getChildEntities, getEntity } from '@nextsparkjs/core/lib/entities/queries'
 
 
 interface RouteParams {
@@ -34,7 +34,7 @@ export async function GET(
     }
 
     // Check if child entity exists using the new registry system
-    const childEntities = getChildEntities(resolution.entityName as EntityName)
+    const childEntities = getChildEntities(resolution.entityName)
     const childEntity = childEntities.find(child => child.name === childType)
 
     if (!childEntity) {
@@ -45,7 +45,7 @@ export async function GET(
     }
 
     // Get child config from registry
-    const childConfig = getEntity(childType as EntityName)
+    const childConfig = getEntity(childType)
     if (!childConfig) {
       return NextResponse.json(
         { error: `Child entity configuration "${childType}" not found` },
@@ -103,7 +103,7 @@ export async function POST(
     }
 
     // Check if child entity exists using the new registry system
-    const childEntities = getChildEntities(resolution.entityName as EntityName)
+    const childEntities = getChildEntities(resolution.entityName)
     const childEntity = childEntities.find(child => child.name === childType)
     console.log(`[ChildAPI] Found child entities for ${entity}:`, childEntities.map(c => c.name))
     console.log(`[ChildAPI] Looking for childType:`, childType)
@@ -117,7 +117,7 @@ export async function POST(
     }
 
     // Get child config from registry
-    const childConfig = getEntity(childType as EntityName)
+    const childConfig = getEntity(childType)
     console.log(`[ChildAPI] Child config for ${childType}:`, childConfig)
     if (!childConfig) {
       return NextResponse.json(

package/templates/app/dashboard/(main)/[entity]/[id]/page.tsx

@@ -1,5 +1,5 @@
 import { notFound, redirect } from 'next/navigation'
-import { getEntity, ENTITY_REGISTRY, getChildEntities, type EntityName } from '@nextsparkjs/core/lib/entities/queries'
+import { getEntity, getEntityRegistry, getChildEntities } from '@nextsparkjs/core/lib/entities/queries'
 import { EntityDetailWrapper } from '@nextsparkjs/core/components/entities/wrappers/EntityDetailWrapper'
 import type { Metadata } from 'next'
 import { TemplateService } from '@nextsparkjs/core/lib/services/template.service'
@@ -33,11 +33,12 @@ async function EntityDetailPage({ params }: PageProps) {
   }
 
   // Verificar que la entidad existe en el registro
-  if (!(entitySlug in ENTITY_REGISTRY)) {
+  const registry = getEntityRegistry()
+  if (!(entitySlug in registry)) {
     notFound()
   }
 
-  const entityConfig = getEntity(entitySlug as EntityName)
+  const entityConfig = getEntity(entitySlug)
   if (!entityConfig || !isEntityConfig(entityConfig)) {
     notFound()
   }
@@ -60,7 +61,7 @@ async function EntityDetailPage({ params }: PageProps) {
   }
 
   // Get child entities for this parent entity
-  const childEntities = getChildEntities(entitySlug as EntityName)
+  const childEntities = getChildEntities(entitySlug)
   const childEntityNames = childEntities.map(child => child.name)
 
   return (
@@ -76,13 +77,14 @@ export async function generateMetadata({ params }: PageProps): Promise<Metadata>
   const resolvedParams = await params
   const entitySlug = resolvedParams.entity
 
-  if (!(entitySlug in ENTITY_REGISTRY)) {
+  const registry = getEntityRegistry()
+  if (!(entitySlug in registry)) {
     return {
       title: 'Not Found - Dashboard'
     }
   }
 
-  const entityConfig = getEntity(entitySlug as EntityName)
+  const entityConfig = getEntity(entitySlug)
   if (!entityConfig || !isEntityConfig(entityConfig)) {
     return {
       title: 'Not Found - Dashboard'

package/templates/app/dashboard/(main)/[entity]/page.tsx

@@ -1,5 +1,5 @@
 import { notFound } from 'next/navigation'
-import { getEntity, ENTITY_REGISTRY, type EntityName } from '@nextsparkjs/core/lib/entities/queries'
+import { getEntity, getEntityRegistry } from '@nextsparkjs/core/lib/entities/queries'
 import { EntityListWrapper } from '@nextsparkjs/core/components/entities/wrappers/EntityListWrapper'
 import type { Metadata } from 'next'
 import { getTemplateOrDefault } from '@nextsparkjs/core/lib/template-resolver'
@@ -20,11 +20,12 @@ async function EntityListPage({ params }: PageProps) {
   const entitySlug = resolvedParams.entity
 
   // Verificar que la entidad existe usando el nuevo registry
-  if (!(entitySlug in ENTITY_REGISTRY)) {
+  const registry = getEntityRegistry()
+  if (!(entitySlug in registry)) {
     notFound()
   }
 
-  const entityConfig = getEntity(entitySlug as EntityName)
+  const entityConfig = getEntity(entitySlug)
   if (!entityConfig || !isEntityConfig(entityConfig)) {
     notFound()
   }
@@ -61,13 +62,14 @@ export async function generateMetadata({ params }: PageProps): Promise<Metadata>
   const resolvedParams = await params
   const entitySlug = resolvedParams.entity
 
-  if (!(entitySlug in ENTITY_REGISTRY)) {
+  const registry = getEntityRegistry()
+  if (!(entitySlug in registry)) {
     return {
       title: 'Not Found - Dashboard'
     }
   }
 
-  const entityConfig = getEntity(entitySlug as EntityName)
+  const entityConfig = getEntity(entitySlug)
   if (!entityConfig || !isEntityConfig(entityConfig)) {
     return {
       title: 'Not Found - Dashboard'

package/templates/app/dashboard/(main)/page.tsx

@@ -78,7 +78,7 @@ function DefaultDashboardPage() {
         <div className="mb-8" data-cy="dashboard-welcome">
           <h1 className="text-3xl font-bold">{t('title')}</h1>
           <p className="text-muted-foreground mt-1">
-            {t('welcome', { name: user.firstName || user.email })}
+            {t('welcome', { name: user?.firstName || user?.email || '' })}
           </p>
         </div>
 

package/templates/contents/themes/starter/components/.gitkeep

@@ -0,0 +1 @@
+# Add your theme-specific components here

package/templates/contents/themes/starter/components/analytics/index.ts

@@ -0,0 +1,3 @@
+export { StatsCard } from './StatsCard'
+export { TasksChart } from './TasksChart'
+export { RecentActivity } from './RecentActivity'

package/templates/contents/themes/starter/entities/tasks/tasks.config.ts

@@ -99,21 +99,6 @@ export const taskEntityConfig: EntityConfig = {
     ],
   },
 
-  // ==========================================
-  // 5. INTERNATIONALIZATION
-  // ==========================================
-  i18n: {
-    fallbackLocale: 'en',
-    loaders: {
-      en: () => import('./messages/en.json'),
-      es: () => import('./messages/es.json'),
-      fr: () => import('./messages/fr.json'),
-      it: () => import('./messages/it.json'),
-      de: () => import('./messages/de.json'),
-      pt: () => import('./messages/pt.json'),
-    },
-  },
-
   // ==========================================
   // FIELDS (imported from separate file)
   // ==========================================

package/templates/contents/themes/starter/lib/.gitkeep

@@ -0,0 +1 @@
+# Add your theme-specific utilities and helpers here

package/templates/contents/themes/starter/lib/hooks/index.ts

@@ -1 +1,2 @@
 export { useTaskStats } from './useTaskStats'
+export { useAnalyticsData } from './useAnalyticsData'

package/templates/contents/themes/starter/lib/hooks/useTaskStats.ts

@@ -2,7 +2,7 @@
 
 import { useMemo } from 'react'
 import { useQuery } from '@tanstack/react-query'
-import { useTeamContext } from '@nextsparkjs/core/hooks/useTeamContext'
+import { useTeamContext } from '@nextsparkjs/core/contexts/TeamContext'
 import { calculateTaskStats, type TaskStats } from '../utils'
 
 interface Task {

package/templates/contents/themes/starter/messages/de/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Willkommen in Ihrer App",
+      "description": "Eine moderne SaaS-Anwendung gebaut mit NextSpark",
+      "cta": "Loslegen"
+    },
+    "features": {
+      "title": "Funktionen",
+      "subtitle": "Alles was Sie brauchen um Ihr SaaS zu bauen"
+    }
+  },
+  "footer": {
+    "copyright": "Alle Rechte vorbehalten.",
+    "privacyPolicy": "Datenschutzrichtlinie",
+    "termsOfService": "Nutzungsbedingungen"
+  }
+}

package/templates/contents/themes/starter/messages/en/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Welcome to Your App",
+      "description": "A modern SaaS application built with NextSpark",
+      "cta": "Get Started"
+    },
+    "features": {
+      "title": "Features",
+      "subtitle": "Everything you need to build your SaaS"
+    }
+  },
+  "footer": {
+    "copyright": "All rights reserved.",
+    "privacyPolicy": "Privacy Policy",
+    "termsOfService": "Terms of Service"
+  }
+}

package/templates/contents/themes/starter/messages/es/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Bienvenido a Tu App",
+      "description": "Una aplicación SaaS moderna construida con NextSpark",
+      "cta": "Comenzar"
+    },
+    "features": {
+      "title": "Características",
+      "subtitle": "Todo lo que necesitas para construir tu SaaS"
+    }
+  },
+  "footer": {
+    "copyright": "Todos los derechos reservados.",
+    "privacyPolicy": "Política de Privacidad",
+    "termsOfService": "Términos de Servicio"
+  }
+}

package/templates/contents/themes/starter/messages/fr/public.json

@@ -0,0 +1,18 @@
+{
+  "home": {
+    "hero": {
+      "title": "Bienvenue dans Votre Application",
+      "description": "Une application SaaS moderne construite avec NextSpark",
+      "cta": "Commencer"
+    },
+    "features": {
+      "title": "Fonctionnalités",
+      "subtitle": "Tout ce dont vous avez besoin pour construire votre SaaS"
+    }
+  },
+  "footer": {
+    "copyright": "Tous droits réservés.",
+    "privacyPolicy": "Politique de Confidentialité",
+    "termsOfService": "Conditions d'Utilisation"
+  }
+}

package/templates/contents/themes/starter/templates/(dashboard)/analytics/page.tsx

@@ -1,8 +1,6 @@
 import { Metadata } from 'next'
 import { getTranslations } from 'next-intl/server'
-import { StatsCard } from './components/StatsCard'
-import { TasksChart } from './components/TasksChart'
-import { RecentActivity } from './components/RecentActivity'
+import { StatsCard, TasksChart, RecentActivity } from '../../../components/analytics'
 
 export async function generateMetadata(): Promise<Metadata> {
   const t = await getTranslations('analytics')

package/tests/jest/__mocks__/@nextsparkjs/registries/billing-registry.ts

@@ -0,0 +1,181 @@
+/**
+ * Mock Billing Registry for Jest tests
+ * This matches the expected structure used by billing tests
+ */
+
+export interface FeatureDefinition {
+  slug: string
+  name: string
+  description: string
+  type: 'boolean' | 'limit'
+}
+
+export interface LimitDefinition {
+  slug: string
+  name: string
+  unit: string
+  description: string
+}
+
+export interface PlanDefinition {
+  slug: string
+  name: string
+  description: string
+  price: number
+  interval: 'month' | 'year'
+  type: 'free' | 'paid' | 'custom'
+  visibility: 'public' | 'hidden' | 'invite_only'
+  features: string[]
+  limits: Record<string, number>
+  stripeProductId?: string
+  stripePriceId?: string
+}
+
+export interface BillingConfig {
+  provider: 'stripe' | 'custom'
+  currency: string
+  defaultPlan: string
+  features: Record<string, FeatureDefinition>
+  limits: Record<string, LimitDefinition>
+  plans: PlanDefinition[]
+  actionMappings: {
+    permissions: Record<string, string>
+    features: Record<string, string>
+    limits: Record<string, string>
+  }
+}
+
+export const BILLING_REGISTRY: BillingConfig = {
+  provider: 'stripe',
+  currency: 'usd',
+  defaultPlan: 'free',
+  features: {
+    api_access: {
+      slug: 'api_access',
+      name: 'API Access',
+      description: 'Access to API',
+      type: 'boolean'
+    },
+    advanced_analytics: {
+      slug: 'advanced_analytics',
+      name: 'Advanced Analytics',
+      description: 'Advanced analytics features',
+      type: 'boolean'
+    },
+    priority_support: {
+      slug: 'priority_support',
+      name: 'Priority Support',
+      description: '24/7 priority support',
+      type: 'boolean'
+    },
+    custom_integrations: {
+      slug: 'custom_integrations',
+      name: 'Custom Integrations',
+      description: 'Custom API integrations',
+      type: 'boolean'
+    },
+  },
+  limits: {
+    api_calls: {
+      slug: 'api_calls',
+      name: 'API Calls',
+      unit: 'calls/month',
+      description: 'Number of API calls per month'
+    },
+    storage: {
+      slug: 'storage',
+      name: 'Storage',
+      unit: 'GB',
+      description: 'Storage space in GB'
+    },
+    team_members: {
+      slug: 'team_members',
+      name: 'Team Members',
+      unit: 'users',
+      description: 'Number of team members'
+    },
+  },
+  plans: [
+    {
+      slug: 'free',
+      name: 'Free',
+      description: 'Free plan for getting started',
+      price: 0,
+      interval: 'month',
+      type: 'free',
+      visibility: 'public',
+      features: ['api_access'],
+      limits: { api_calls: 1000, storage: 1, team_members: 1 },
+    },
+    {
+      slug: 'starter',
+      name: 'Starter',
+      description: 'Starter plan for small teams',
+      price: 19,
+      interval: 'month',
+      type: 'paid',
+      visibility: 'public',
+      features: ['api_access'],
+      limits: { api_calls: 5000, storage: 5, team_members: 3 },
+      stripeProductId: 'prod_starter',
+      stripePriceId: 'price_starter',
+    },
+    {
+      slug: 'pro',
+      name: 'Pro',
+      description: 'Pro plan for growing businesses',
+      price: 49,
+      interval: 'month',
+      type: 'paid',
+      visibility: 'public',
+      features: ['api_access', 'advanced_analytics', 'priority_support'],
+      limits: { api_calls: 50000, storage: 50, team_members: 10 },
+      stripeProductId: 'prod_pro',
+      stripePriceId: 'price_pro',
+    },
+    {
+      slug: 'business',
+      name: 'Business',
+      description: 'Business plan for enterprises',
+      price: 199,
+      interval: 'month',
+      type: 'paid',
+      visibility: 'public',
+      features: ['api_access', 'advanced_analytics', 'priority_support', 'custom_integrations'],
+      limits: { api_calls: 500000, storage: 500, team_members: 50 },
+      stripeProductId: 'prod_business',
+      stripePriceId: 'price_business',
+    },
+  ],
+  actionMappings: {
+    permissions: {},
+    features: {},
+    limits: {},
+  },
+}
+
+export const BILLING_MATRIX = {
+  features: {
+    api_access: { free: true, starter: true, pro: true, business: true },
+    advanced_analytics: { free: false, starter: false, pro: true, business: true },
+    priority_support: { free: false, starter: false, pro: true, business: true },
+    custom_integrations: { free: false, starter: false, pro: false, business: true },
+  },
+  limits: {
+    api_calls: { free: 1000, starter: 5000, pro: 50000, business: 500000 },
+    storage: { free: 1, starter: 5, pro: 50, business: 500 },
+    team_members: { free: 1, starter: 3, pro: 10, business: 50 },
+  },
+} as const
+
+export const PUBLIC_PLANS: readonly PlanDefinition[] = BILLING_REGISTRY.plans.filter(
+  p => p.visibility === 'public' || p.visibility === undefined
+)
+
+export const BILLING_METADATA = {
+  totalPlans: BILLING_REGISTRY.plans.length,
+  publicPlans: PUBLIC_PLANS.length,
+  totalFeatures: Object.keys(BILLING_REGISTRY.features).length,
+  totalLimits: Object.keys(BILLING_REGISTRY.limits).length,
+  theme: 'default',
+} as const

package/tests/jest/__mocks__/@nextsparkjs/registries/block-registry.ts

@@ -0,0 +1,12 @@
+/**
+ * Mock Block Registry for Jest tests
+ */
+
+export const BLOCK_REGISTRY: Record<string, any> = {}
+
+export const BLOCK_COMPONENTS: Record<string, any> = {}
+
+export const BLOCK_METADATA = {
+  generated: new Date().toISOString(),
+  totalBlocks: 0,
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/entity-registry.client.ts

@@ -0,0 +1,8 @@
+/**
+ * Mock Entity Registry Client for Jest tests
+ */
+
+export const clientMetaSystemAdapter = {
+  getEntityMeta: (name: string) => null,
+  getAllEntities: () => [],
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/entity-registry.ts

@@ -0,0 +1,64 @@
+/**
+ * Mock Entity Registry for Jest tests
+ */
+
+export const ENTITY_REGISTRY: Record<string, any> = {
+  posts: {
+    config: {
+      name: 'posts',
+      label: 'Posts',
+      labelPlural: 'Posts',
+      icon: 'FileText',
+      slug: 'posts',
+      apiSlug: 'posts',
+      db: { table: 'posts' },
+      fields: [],
+      access: { shared: false },
+    },
+    tableName: 'posts',
+    parent: null,
+    depth: 0,
+    source: 'theme',
+    sourceName: 'default',
+  },
+  users: {
+    config: {
+      name: 'users',
+      label: 'User',
+      labelPlural: 'Users',
+      icon: 'User',
+      slug: 'users',
+      apiSlug: 'users',
+      db: { table: 'users' },
+      fields: [],
+      access: { shared: false },
+    },
+    tableName: 'users',
+    parent: null,
+    depth: 0,
+    source: 'core',
+    sourceName: 'core',
+  },
+}
+
+export const ENTITY_METADATA = {
+  generated: new Date().toISOString(),
+  totalEntities: Object.keys(ENTITY_REGISTRY).length,
+  sources: { theme: 1, core: 1, plugin: 0 },
+}
+
+export type EntityName = keyof typeof ENTITY_REGISTRY
+
+export interface EntityRegistryEntry {
+  config: any
+  tableName: string
+  parent: string | null
+  depth: number
+  source: string
+  sourceName: string
+}
+
+export const clientMetaSystemAdapter = {
+  getEntityMeta: (name: string) => ENTITY_REGISTRY[name]?.config || null,
+  getAllEntities: () => Object.values(ENTITY_REGISTRY).map((e: any) => e.config),
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/entity-types.ts

@@ -0,0 +1,21 @@
+/**
+ * Mock Entity Types Registry for Jest tests
+ */
+
+export const ENTITY_METADATA = {
+  generated: new Date().toISOString(),
+  totalEntities: 0,
+}
+
+export type EntityName = string
+
+export type SearchResultType = {
+  id: string
+  title: string
+  type: string
+}
+
+export type SystemSearchType = {
+  query: string
+  results: SearchResultType[]
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/middleware-registry.ts

@@ -0,0 +1,18 @@
+/**
+ * Mock Middleware Registry for Jest tests
+ */
+
+export const MIDDLEWARE_REGISTRY: Record<string, any> = {}
+
+export const MIDDLEWARE_METADATA = {
+  generated: new Date().toISOString(),
+  totalMiddlewares: 0,
+}
+
+export interface MiddlewareRegistryEntry {
+  name: string
+  path: string
+  priority: number
+}
+
+export type ThemeName = string

package/tests/jest/__mocks__/@nextsparkjs/registries/namespace-registry.ts

@@ -0,0 +1,15 @@
+/**
+ * Mock Namespace Registry for Jest tests
+ */
+
+export const NAMESPACE_REGISTRY: Record<string, any> = {}
+
+export interface RouteNamespaceConfig {
+  namespace: string
+  basePath: string
+}
+
+export interface NamespaceConfig {
+  name: string
+  path: string
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/plugin-registry.ts

@@ -0,0 +1,29 @@
+/**
+ * Mock Plugin Registry for Jest tests
+ */
+
+export const PLUGIN_REGISTRY: Record<string, any> = {}
+
+export const PLUGIN_METADATA = {
+  generated: new Date().toISOString(),
+  totalPlugins: 0,
+}
+
+export type PluginName = string
+
+export interface PluginRegistryEntry {
+  name: string
+  version: string
+  entities: any[]
+  routes: any[]
+}
+
+export interface RouteFileEndpoint {
+  path: string
+  method: string
+}
+
+export interface PluginEntity {
+  name: string
+  config: any
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/route-handlers.ts

@@ -0,0 +1,20 @@
+/**
+ * Mock Route Handlers Registry for Jest tests
+ */
+
+export const THEME_ROUTE_HANDLERS: Record<string, any> = {}
+
+export const PLUGIN_ROUTE_HANDLERS: Record<string, any> = {}
+
+export const API_ROUTES_SUMMARY: any[] = []
+
+export interface RouteHandler {
+  path: string
+  method: string
+  handler: any
+}
+
+export interface ApiRouteEntry {
+  path: string
+  methods: string[]
+}

package/tests/jest/__mocks__/@nextsparkjs/registries/scheduled-actions-registry.ts

@@ -0,0 +1,10 @@
+/**
+ * Mock Scheduled Actions Registry for Jest tests
+ */
+
+export const SCHEDULED_ACTIONS_REGISTRY: Record<string, any> = {}
+
+export const SCHEDULED_ACTIONS_METADATA = {
+  generated: new Date().toISOString(),
+  totalActions: 0,
+}