@nextsparkjs/mobile 0.1.0-beta.1

package/templates/src/config/hooks.ts

@@ -0,0 +1,58 @@
+/**
+ * Permission hooks for mobile
+ */
+
+import { useMemo } from 'react'
+import { useAuth } from '@nextsparkjs/mobile'
+import { canDoAction, PERMISSIONS_CONFIG } from './permissions.config'
+
+/**
+ * Check if current user has permission to perform an action
+ */
+export function usePermission(action: string): boolean {
+  const { team } = useAuth()
+
+  return useMemo(() => {
+    if (!team?.role) return false
+    return canDoAction(team.role, action)
+  }, [team?.role, action])
+}
+
+/**
+ * Check multiple permissions at once
+ */
+export function usePermissions<T extends Record<string, string>>(
+  permissions: T
+): Record<keyof T, boolean> {
+  const { team } = useAuth()
+
+  return useMemo(() => {
+    const result = {} as Record<keyof T, boolean>
+    for (const [key, action] of Object.entries(permissions)) {
+      result[key as keyof T] = team?.role ? canDoAction(team.role, action) : false
+    }
+    return result
+  }, [team?.role, permissions])
+}
+
+/**
+ * Get current team role
+ */
+export function useTeamRole(): string | null {
+  const { team } = useAuth()
+  return team?.role ?? null
+}
+
+/**
+ * Check if user can perform entity action
+ */
+export function useEntityPermission(entity: 'tasks' | 'customers', action: string): boolean {
+  const { team } = useAuth()
+
+  return useMemo(() => {
+    if (!team?.role) return false
+    const entityPerms = PERMISSIONS_CONFIG.entities[entity]
+    const perm = entityPerms.find(p => p.action === action)
+    return perm ? perm.roles.includes(team.role) : false
+  }, [team?.role, entity, action])
+}

package/templates/src/config/permissions.config.ts

@@ -0,0 +1,119 @@
+/**
+ * Mobile App - Permissions Configuration
+ *
+ * SINGLE SOURCE OF TRUTH for all permissions and roles.
+ * Structure matches web theme: teams, entities, features
+ */
+
+// Types (simplified for mobile - no ThemePermissionsConfig import)
+interface Permission {
+  action: string
+  label: string
+  description: string
+  roles: string[]
+  dangerous?: boolean
+  category?: string
+}
+
+interface PermissionsConfig {
+  teams: Permission[]
+  entities: {
+    tasks: Permission[]
+    customers: Permission[]
+  }
+  features: Permission[]
+}
+
+export const PERMISSIONS_CONFIG: PermissionsConfig = {
+  // ==========================================
+  // TEAM PERMISSIONS
+  // ==========================================
+  teams: [
+    // View permissions
+    { action: 'team.view', label: 'View Team', description: 'Can view team details', roles: ['owner', 'admin', 'member', 'viewer'] },
+    { action: 'team.members.view', label: 'View Members', description: 'Can see team member list', roles: ['owner', 'admin', 'member', 'viewer'] },
+    { action: 'team.settings.view', label: 'View Settings', description: 'Can view team settings', roles: ['owner', 'admin', 'member'] },
+
+    // Edit permissions
+    { action: 'team.edit', label: 'Edit Team', description: 'Can modify team name and details', roles: ['owner', 'admin'] },
+    { action: 'team.settings.edit', label: 'Edit Settings', description: 'Can modify team settings', roles: ['owner', 'admin'] },
+
+    // Member management
+    { action: 'team.members.invite', label: 'Invite Members', description: 'Can invite new team members', roles: ['owner', 'admin'] },
+    { action: 'team.members.remove', label: 'Remove Members', description: 'Can remove team members', roles: ['owner', 'admin'] },
+  ],
+
+  // ==========================================
+  // ENTITY PERMISSIONS
+  // ==========================================
+  entities: {
+    // TASKS
+    tasks: [
+      { action: 'create', label: 'Create tasks', description: 'Can create new tasks', roles: ['owner', 'admin', 'member'] },
+      { action: 'read', label: 'View tasks', description: 'Can view task details', roles: ['owner', 'admin', 'member'] },
+      { action: 'list', label: 'List tasks', description: 'Can see the tasks list', roles: ['owner', 'admin', 'member'] },
+      { action: 'update', label: 'Edit tasks', description: 'Can modify task information', roles: ['owner', 'admin', 'member'] },
+      { action: 'delete', label: 'Delete tasks', description: 'Can delete tasks', roles: ['owner', 'admin'], dangerous: true },
+    ],
+
+    // CUSTOMERS
+    customers: [
+      { action: 'create', label: 'Create customers', description: 'Can create new customers', roles: ['owner', 'admin'] },
+      { action: 'read', label: 'View customers', description: 'Can view customer details', roles: ['owner', 'admin', 'member'] },
+      { action: 'list', label: 'List customers', description: 'Can see the customers list', roles: ['owner', 'admin', 'member'] },
+      { action: 'update', label: 'Edit customers', description: 'Can modify customer information', roles: ['owner', 'admin'] },
+      { action: 'delete', label: 'Delete customers', description: 'Can delete customers', roles: ['owner'], dangerous: true },
+    ],
+  },
+
+  // ==========================================
+  // FEATURE PERMISSIONS
+  // ==========================================
+  features: [
+    // Offline Mode
+    {
+      action: 'offline.access',
+      label: 'Offline Mode',
+      description: 'Can use the app in offline mode',
+      category: 'Mobile',
+      roles: ['owner', 'admin', 'member'],
+    },
+    // Push Notifications
+    {
+      action: 'notifications.receive',
+      label: 'Push Notifications',
+      description: 'Can receive push notifications',
+      category: 'Mobile',
+      roles: ['owner', 'admin', 'member', 'viewer'],
+    },
+    // Quick Create
+    {
+      action: 'quick-create.access',
+      label: 'Quick Create',
+      description: 'Can use quick create from bottom nav',
+      category: 'Mobile',
+      roles: ['owner', 'admin', 'member'],
+    },
+  ],
+}
+
+// Helper function (optional - for future use)
+export function canDoAction(role: string, action: string): boolean {
+  // Check teams
+  const teamPerm = PERMISSIONS_CONFIG.teams.find(p => p.action === action)
+  if (teamPerm) return teamPerm.roles.includes(role)
+
+  // Check entities
+  for (const [entity, perms] of Object.entries(PERMISSIONS_CONFIG.entities)) {
+    const entityPerm = perms.find(p => `${entity}.${p.action}` === action)
+    if (entityPerm) return entityPerm.roles.includes(role)
+  }
+
+  // Check features
+  const featurePerm = PERMISSIONS_CONFIG.features.find(p => p.action === action)
+  if (featurePerm) return featurePerm.roles.includes(role)
+
+  return false
+}
+
+export default PERMISSIONS_CONFIG

package/templates/src/constants/colors.ts

@@ -0,0 +1,55 @@
+/**
+ * NextSpark Mobile Color Palette
+ * Black/White theme matching default NextSpark theme
+ */
+
+export const Colors = {
+  // Primary
+  primary: '#000000',
+  primaryForeground: '#FFFFFF',
+
+  // Background
+  background: '#FFFFFF',
+  backgroundSecondary: '#F9FAFB',
+  backgroundTertiary: '#F3F4F6',
+
+  // Foreground
+  foreground: '#111827',
+  foregroundSecondary: '#6B7280',
+  foregroundMuted: '#9CA3AF',
+
+  // Border
+  border: '#E5E7EB',
+  borderSecondary: '#D1D5DB',
+
+  // Accent
+  accent: '#F59E0B', // Orange for avatar
+  accentForeground: '#FFFFFF',
+
+  // Destructive
+  destructive: '#DC2626',
+  destructiveForeground: '#FFFFFF',
+
+  // Success
+  success: '#10B981',
+  successForeground: '#FFFFFF',
+
+  // Card
+  card: '#FFFFFF',
+  cardForeground: '#111827',
+
+  // Status colors
+  statusTodo: '#6B7280',
+  statusInProgress: '#3B82F6',
+  statusReview: '#F59E0B',
+  statusDone: '#10B981',
+  statusBlocked: '#DC2626',
+
+  // Priority colors
+  priorityLow: '#6B7280',
+  priorityMedium: '#F59E0B',
+  priorityHigh: '#F97316',
+  priorityUrgent: '#DC2626',
+}
+
+export default Colors

package/templates/src/data/notifications.mock.json

@@ -0,0 +1,100 @@
+{
+  "notifications": [
+    {
+      "id": "notif-001",
+      "type": "task_assigned",
+      "title": "Nueva tarea asignada",
+      "message": "Se te ha asignado la tarea 'Revisar propuesta de diseño'",
+      "read": false,
+      "createdAt": "2025-01-24T10:30:00Z",
+      "data": {
+        "taskId": "task-123",
+        "taskTitle": "Revisar propuesta de diseño"
+      }
+    },
+    {
+      "id": "notif-002",
+      "type": "task_completed",
+      "title": "Tarea completada",
+      "message": "La tarea 'Implementar autenticación' ha sido marcada como completada",
+      "read": false,
+      "createdAt": "2025-01-24T09:15:00Z",
+      "data": {
+        "taskId": "task-456",
+        "taskTitle": "Implementar autenticación"
+      }
+    },
+    {
+      "id": "notif-003",
+      "type": "customer_added",
+      "title": "Nuevo cliente agregado",
+      "message": "Se ha agregado el cliente 'Acme Corporation' al sistema",
+      "read": true,
+      "createdAt": "2025-01-23T16:45:00Z",
+      "data": {
+        "customerId": "cust-789",
+        "customerName": "Acme Corporation"
+      }
+    },
+    {
+      "id": "notif-004",
+      "type": "task_due_soon",
+      "title": "Tarea por vencer",
+      "message": "La tarea 'Entregar reporte mensual' vence mañana",
+      "read": false,
+      "createdAt": "2025-01-23T14:00:00Z",
+      "data": {
+        "taskId": "task-101",
+        "taskTitle": "Entregar reporte mensual",
+        "dueDate": "2025-01-25T23:59:59Z"
+      }
+    },
+    {
+      "id": "notif-005",
+      "type": "team_invite",
+      "title": "Invitación a equipo",
+      "message": "Has sido invitado a unirte al equipo 'Marketing Digital'",
+      "read": true,
+      "createdAt": "2025-01-22T11:20:00Z",
+      "data": {
+        "teamId": "team-202",
+        "teamName": "Marketing Digital"
+      }
+    },
+    {
+      "id": "notif-006",
+      "type": "task_comment",
+      "title": "Nuevo comentario",
+      "message": "Carlos Mendoza comentó en 'Planificación Q1'",
+      "read": true,
+      "createdAt": "2025-01-22T08:30:00Z",
+      "data": {
+        "taskId": "task-303",
+        "taskTitle": "Planificación Q1",
+        "commentBy": "Carlos Mendoza"
+      }
+    },
+    {
+      "id": "notif-007",
+      "type": "system",
+      "title": "Actualización del sistema",
+      "message": "Se han realizado mejoras de rendimiento en la plataforma",
+      "read": true,
+      "createdAt": "2025-01-21T12:00:00Z",
+      "data": {}
+    },
+    {
+      "id": "notif-008",
+      "type": "task_overdue",
+      "title": "Tarea vencida",
+      "message": "La tarea 'Actualizar documentación' está vencida desde hace 2 días",
+      "read": false,
+      "createdAt": "2025-01-20T09:00:00Z",
+      "data": {
+        "taskId": "task-404",
+        "taskTitle": "Actualizar documentación",
+        "dueDate": "2025-01-18T23:59:59Z"
+      }
+    }
+  ]
+}

package/templates/src/entities/customers/api.ts

@@ -0,0 +1,10 @@
+/**
+ * Customers API Client
+ *
+ * Auto-generated entity API using createEntityApi factory.
+ */
+
+import { createEntityApi } from '@nextsparkjs/mobile'
+import type { Customer, CreateCustomerInput, UpdateCustomerInput } from './types'
+
+export const customersApi = createEntityApi<Customer, CreateCustomerInput, UpdateCustomerInput>('customers')

package/templates/src/entities/customers/constants.internal.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal constants for customers module
+ * (Query keys and other internal values)
+ */
+
+export const CUSTOMERS_QUERY_KEY = ['customers'] as const

package/templates/src/entities/customers/constants.ts

@@ -0,0 +1,14 @@
+/**
+ * Customer Entity Constants
+ */
+
+import type { DayOption } from './types'
+
+// Day labels for display
+export const DAY_LABELS: Record<DayOption, string> = {
+  lun: 'Lunes',
+  mar: 'Martes',
+  mie: 'Miércoles',
+  jue: 'Jueves',
+  vie: 'Viernes',
+}

package/templates/src/entities/customers/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Customers Entity Module
+ */
+
+export * from './types'
+export * from './api'
+export * from './queries'
+export * from './mutations'
+export * from './constants'

package/templates/src/entities/customers/mutations.ts

@@ -0,0 +1,58 @@
+/**
+ * TanStack Query mutations for Customers
+ */
+
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+import { customersApi } from './api'
+import { CUSTOMERS_QUERY_KEY } from './constants.internal'
+import type { CreateCustomerInput, UpdateCustomerInput } from './types'
+
+/**
+ * Hook to create a new customer
+ */
+export function useCreateCustomer() {
+  const queryClient = useQueryClient()
+
+  return useMutation({
+    mutationFn: (data: CreateCustomerInput) => customersApi.create(data),
+    onSuccess: () => {
+      // Invalidate customers list to refetch
+      queryClient.invalidateQueries({ queryKey: CUSTOMERS_QUERY_KEY })
+    },
+  })
+}
+
+/**
+ * Hook to update an existing customer
+ */
+export function useUpdateCustomer() {
+  const queryClient = useQueryClient()
+
+  return useMutation({
+    mutationFn: ({ id, data }: { id: string; data: UpdateCustomerInput }) =>
+      customersApi.update(id, data),
+    onSuccess: (response) => {
+      // Update the specific customer in cache
+      queryClient.setQueryData([...CUSTOMERS_QUERY_KEY, response.data.id], response)
+      // Invalidate list to refetch
+      queryClient.invalidateQueries({ queryKey: CUSTOMERS_QUERY_KEY })
+    },
+  })
+}
+
+/**
+ * Hook to delete a customer
+ */
+export function useDeleteCustomer() {
+  const queryClient = useQueryClient()
+
+  return useMutation({
+    mutationFn: (id: string) => customersApi.delete(id),
+    onSuccess: (_, deletedId) => {
+      // Remove from cache
+      queryClient.removeQueries({ queryKey: [...CUSTOMERS_QUERY_KEY, deletedId] })
+      // Invalidate list to refetch
+      queryClient.invalidateQueries({ queryKey: CUSTOMERS_QUERY_KEY })
+    },
+  })
+}

package/templates/src/entities/customers/queries.ts

@@ -0,0 +1,40 @@
+/**
+ * TanStack Query hooks for Customers
+ */
+
+import { useQuery } from '@tanstack/react-query'
+import { customersApi } from './api'
+import { CUSTOMERS_QUERY_KEY } from './constants.internal'
+
+export { CUSTOMERS_QUERY_KEY }
+
+interface UseCustomersOptions {
+  page?: number
+  limit?: number
+  search?: string
+  enabled?: boolean
+}
+
+/**
+ * Hook to fetch paginated customers list
+ */
+export function useCustomers(options: UseCustomersOptions = {}) {
+  const { page = 1, limit = 20, search, enabled = true } = options
+
+  return useQuery({
+    queryKey: [...CUSTOMERS_QUERY_KEY, { page, limit, search }],
+    queryFn: () => customersApi.list({ page, limit, search }),
+    enabled,
+  })
+}
+
+/**
+ * Hook to fetch a single customer by ID
+ */
+export function useCustomer(id: string | undefined) {
+  return useQuery({
+    queryKey: [...CUSTOMERS_QUERY_KEY, id],
+    queryFn: () => customersApi.get(id!),
+    enabled: !!id,
+  })
+}

package/templates/src/entities/customers/types.ts

@@ -0,0 +1,43 @@
+/**
+ * Customer Entity Types
+ */
+
+// Day options for visit/contact days
+export type DayOption = 'lun' | 'mar' | 'mie' | 'jue' | 'vie'
+
+// Customer entity
+export interface Customer {
+  id: string
+  name: string
+  account: number
+  office: string
+  phone?: string | null
+  salesRep?: string | null
+  visitDays?: DayOption[] | null
+  contactDays?: DayOption[] | null
+  teamId: string
+  createdAt: string
+  updatedAt: string
+}
+
+// Create customer payload
+export interface CreateCustomerInput {
+  name: string
+  account: number
+  office: string
+  phone?: string
+  salesRep?: string
+  visitDays?: DayOption[]
+  contactDays?: DayOption[]
+}
+
+// Update customer payload
+export interface UpdateCustomerInput {
+  name?: string
+  account?: number
+  office?: string
+  phone?: string | null
+  salesRep?: string | null
+  visitDays?: DayOption[] | null
+  contactDays?: DayOption[] | null
+}

package/templates/src/entities/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Entities Module
+ *
+ * Central export for all entity types and APIs.
+ */
+
+export * from './tasks'
+export * from './customers'

package/templates/src/entities/tasks/api.ts

@@ -0,0 +1,10 @@
+/**
+ * Tasks API Client
+ *
+ * Auto-generated entity API using createEntityApi factory.
+ */
+
+import { createEntityApi } from '@nextsparkjs/mobile'
+import type { Task, CreateTaskInput, UpdateTaskInput } from './types'
+
+export const tasksApi = createEntityApi<Task, CreateTaskInput, UpdateTaskInput>('tasks')

package/templates/src/entities/tasks/constants.internal.ts

@@ -0,0 +1,6 @@
+/**
+ * Internal constants for tasks module
+ * (Query keys and other internal values)
+ */
+
+export const TASKS_QUERY_KEY = ['tasks'] as const

package/templates/src/entities/tasks/constants.ts

@@ -0,0 +1,39 @@
+/**
+ * Task Entity Constants
+ */
+
+import type { TaskStatus, TaskPriority } from './types'
+
+// Status display labels
+export const STATUS_LABELS: Record<TaskStatus, string> = {
+  'todo': 'To Do',
+  'in-progress': 'In Progress',
+  'review': 'In Review',
+  'done': 'Done',
+  'blocked': 'Blocked',
+}
+
+// Priority display labels
+export const PRIORITY_LABELS: Record<TaskPriority, string> = {
+  low: 'Low',
+  medium: 'Medium',
+  high: 'High',
+  urgent: 'Urgent',
+}
+
+// Status colors
+export const STATUS_COLORS: Record<TaskStatus, string> = {
+  'todo': '#6B7280',
+  'in-progress': '#3B82F6',
+  'review': '#F59E0B',
+  'done': '#10B981',
+  'blocked': '#EF4444',
+}
+
+// Priority colors
+export const PRIORITY_COLORS: Record<TaskPriority, string> = {
+  low: '#6B7280',
+  medium: '#3B82F6',
+  high: '#F59E0B',
+  urgent: '#EF4444',
+}

package/templates/src/entities/tasks/index.ts

@@ -0,0 +1,9 @@
+/**
+ * Tasks Entity Module
+ */
+
+export * from './types'
+export * from './api'
+export * from './queries'
+export * from './mutations'
+export * from './constants'