ar-saas 0.4.3 → 0.5.0

package/templates/frontend/src/components/ui/sheet.tsx

@@ -0,0 +1,140 @@
+"use client"
+
+import * as React from "react"
+import * as SheetPrimitive from "@radix-ui/react-dialog"
+import { cva, type VariantProps } from "class-variance-authority"
+import { X } from "lucide-react"
+
+import { cn } from "@/lib/utils"
+
+const Sheet = SheetPrimitive.Root
+
+const SheetTrigger = SheetPrimitive.Trigger
+
+const SheetClose = SheetPrimitive.Close
+
+const SheetPortal = SheetPrimitive.Portal
+
+const SheetOverlay = React.forwardRef<
+  React.ElementRef<typeof SheetPrimitive.Overlay>,
+  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Overlay>
+>(({ className, ...props }, ref) => (
+  <SheetPrimitive.Overlay
+    className={cn(
+      "fixed inset-0 z-50 bg-black/80  data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
+      className
+    )}
+    {...props}
+    ref={ref}
+  />
+))
+SheetOverlay.displayName = SheetPrimitive.Overlay.displayName
+
+const sheetVariants = cva(
+  "fixed z-50 gap-4 bg-background p-6 shadow-lg transition ease-in-out data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:duration-300 data-[state=open]:duration-500",
+  {
+    variants: {
+      side: {
+        top: "inset-x-0 top-0 border-b data-[state=closed]:slide-out-to-top data-[state=open]:slide-in-from-top",
+        bottom:
+          "inset-x-0 bottom-0 border-t data-[state=closed]:slide-out-to-bottom data-[state=open]:slide-in-from-bottom",
+        left: "inset-y-0 left-0 h-full w-3/4 border-r data-[state=closed]:slide-out-to-left data-[state=open]:slide-in-from-left sm:max-w-sm",
+        right:
+          "inset-y-0 right-0 h-full w-3/4  border-l data-[state=closed]:slide-out-to-right data-[state=open]:slide-in-from-right sm:max-w-sm",
+      },
+    },
+    defaultVariants: {
+      side: "right",
+    },
+  }
+)
+
+interface SheetContentProps
+  extends React.ComponentPropsWithoutRef<typeof SheetPrimitive.Content>,
+    VariantProps<typeof sheetVariants> {}
+
+const SheetContent = React.forwardRef<
+  React.ElementRef<typeof SheetPrimitive.Content>,
+  SheetContentProps
+>(({ side = "right", className, children, ...props }, ref) => (
+  <SheetPortal>
+    <SheetOverlay />
+    <SheetPrimitive.Content
+      ref={ref}
+      className={cn(sheetVariants({ side }), className)}
+      {...props}
+    >
+      {children}
+      <SheetPrimitive.Close className="absolute right-4 top-4 rounded-sm opacity-70 ring-offset-background transition-opacity hover:opacity-100 focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none data-[state=open]:bg-secondary">
+        <X className="h-4 w-4" />
+        <span className="sr-only">Close</span>
+      </SheetPrimitive.Close>
+    </SheetPrimitive.Content>
+  </SheetPortal>
+))
+SheetContent.displayName = SheetPrimitive.Content.displayName
+
+const SheetHeader = ({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) => (
+  <div
+    className={cn(
+      "flex flex-col space-y-2 text-center sm:text-left",
+      className
+    )}
+    {...props}
+  />
+)
+SheetHeader.displayName = "SheetHeader"
+
+const SheetFooter = ({
+  className,
+  ...props
+}: React.HTMLAttributes<HTMLDivElement>) => (
+  <div
+    className={cn(
+      "flex flex-col-reverse sm:flex-row sm:justify-end sm:space-x-2",
+      className
+    )}
+    {...props}
+  />
+)
+SheetFooter.displayName = "SheetFooter"
+
+const SheetTitle = React.forwardRef<
+  React.ElementRef<typeof SheetPrimitive.Title>,
+  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Title>
+>(({ className, ...props }, ref) => (
+  <SheetPrimitive.Title
+    ref={ref}
+    className={cn("text-lg font-semibold text-foreground", className)}
+    {...props}
+  />
+))
+SheetTitle.displayName = SheetPrimitive.Title.displayName
+
+const SheetDescription = React.forwardRef<
+  React.ElementRef<typeof SheetPrimitive.Description>,
+  React.ComponentPropsWithoutRef<typeof SheetPrimitive.Description>
+>(({ className, ...props }, ref) => (
+  <SheetPrimitive.Description
+    ref={ref}
+    className={cn("text-sm text-muted-foreground", className)}
+    {...props}
+  />
+))
+SheetDescription.displayName = SheetPrimitive.Description.displayName
+
+export {
+  Sheet,
+  SheetPortal,
+  SheetOverlay,
+  SheetTrigger,
+  SheetClose,
+  SheetContent,
+  SheetHeader,
+  SheetFooter,
+  SheetTitle,
+  SheetDescription,
+}

package/templates/frontend/src/lib/api/auth.ts

@@ -36,4 +36,11 @@ export const authApi = {
   getMe() {
     return apiClient.get<never, User>('/api/auth/me')
   },
+
+  exchangeGithubCode(code: string) {
+    return apiClient.post<never, { success: boolean; alreadyExisted: boolean }>(
+      '/api/auth/github/exchange',
+      { code },
+    )
+  },
 }

package/templates/frontend/src/lib/api/clients.ts

@@ -0,0 +1,17 @@
+import apiClient from '@/lib/api/client'
+import type { Client, CreateClientDto, PaginatedResult, QueryClientDto, UpdateClientDto } from '@/types/clients'
+
+export const getClients = (params?: QueryClientDto): Promise<PaginatedResult<Client>> =>
+  apiClient.get('/api/clients', { params }) as Promise<PaginatedResult<Client>>
+
+export const getClient = (id: string): Promise<Client> =>
+  apiClient.get(`/api/clients/${id}`) as Promise<Client>
+
+export const createClient = (dto: CreateClientDto): Promise<Client> =>
+  apiClient.post('/api/clients', dto) as Promise<Client>
+
+export const updateClient = (id: string, dto: UpdateClientDto): Promise<Client> =>
+  apiClient.patch(`/api/clients/${id}`, dto) as Promise<Client>
+
+export const deleteClient = (id: string): Promise<void> =>
+  apiClient.delete(`/api/clients/${id}`) as Promise<void>

package/templates/frontend/src/lib/api/invoices.ts

@@ -0,0 +1,18 @@
+import apiClient from '@/lib/api/client'
+import type { CreateInvoiceDto, Invoice, QueryInvoiceDto, UpdateInvoiceDto } from '@/types/invoices'
+import type { PaginatedResult } from '@/types/clients'
+
+export const getInvoices = (params?: QueryInvoiceDto): Promise<PaginatedResult<Invoice>> =>
+  apiClient.get('/api/invoices', { params }) as Promise<PaginatedResult<Invoice>>
+
+export const getInvoice = (id: string): Promise<Invoice> =>
+  apiClient.get(`/api/invoices/${id}`) as Promise<Invoice>
+
+export const createInvoice = (dto: CreateInvoiceDto): Promise<Invoice> =>
+  apiClient.post('/api/invoices', dto) as Promise<Invoice>
+
+export const updateInvoice = (id: string, dto: UpdateInvoiceDto): Promise<Invoice> =>
+  apiClient.patch(`/api/invoices/${id}`, dto) as Promise<Invoice>
+
+export const deleteInvoice = (id: string): Promise<void> =>
+  apiClient.delete(`/api/invoices/${id}`) as Promise<void>

package/templates/frontend/src/lib/api/notifications.ts

@@ -0,0 +1,27 @@
+import apiClient from '@/lib/api/client'
+import type { CreateNotificationDto, Notification, QueryNotificationDto } from '@/types/notifications'
+import type { PaginatedResult } from '@/types/clients'
+
+export const getNotifications = (params?: QueryNotificationDto): Promise<PaginatedResult<Notification>> =>
+  apiClient.get('/api/notifications', { params }) as Promise<PaginatedResult<Notification>>
+
+export const getNotification = (id: string): Promise<Notification> =>
+  apiClient.get(`/api/notifications/${id}`) as Promise<Notification>
+
+export const createNotification = (dto: CreateNotificationDto): Promise<Notification> =>
+  apiClient.post('/api/notifications', dto) as Promise<Notification>
+
+export const markAsRead = (id: string): Promise<Notification> =>
+  apiClient.patch(`/api/notifications/${id}/read`) as Promise<Notification>
+
+export const markAsUnread = (id: string): Promise<Notification> =>
+  apiClient.patch(`/api/notifications/${id}/unread`) as Promise<Notification>
+
+export const markAllAsRead = (): Promise<{ message: string }> =>
+  apiClient.post('/api/notifications/mark-all-read') as Promise<{ message: string }>
+
+export const getUnreadCount = (): Promise<{ count: number }> =>
+  apiClient.get('/api/notifications/unread-count') as Promise<{ count: number }>
+
+export const deleteNotification = (id: string): Promise<void> =>
+  apiClient.delete(`/api/notifications/${id}`) as Promise<void>

package/templates/frontend/src/lib/api/pipeline.ts

@@ -0,0 +1,18 @@
+import apiClient from '@/lib/api/client'
+import type { CreateDealDto, Deal, QueryDealDto, UpdateDealDto } from '@/types/pipeline'
+import type { PaginatedResult } from '@/types/clients'
+
+export const getDeals = (params?: QueryDealDto): Promise<PaginatedResult<Deal>> =>
+  apiClient.get('/api/pipeline', { params }) as Promise<PaginatedResult<Deal>>
+
+export const getDeal = (id: string): Promise<Deal> =>
+  apiClient.get(`/api/pipeline/${id}`) as Promise<Deal>
+
+export const createDeal = (dto: CreateDealDto): Promise<Deal> =>
+  apiClient.post('/api/pipeline', dto) as Promise<Deal>
+
+export const updateDeal = (id: string, dto: UpdateDealDto): Promise<Deal> =>
+  apiClient.patch(`/api/pipeline/${id}`, dto) as Promise<Deal>
+
+export const deleteDeal = (id: string): Promise<void> =>
+  apiClient.delete(`/api/pipeline/${id}`) as Promise<void>

package/templates/frontend/src/lib/api/planner.ts

@@ -0,0 +1,26 @@
+import apiClient from '@/lib/api/client'
+import type { CreatePlannerBlockDto, PlannerBlock, QueryPlannerBlockDto, UpdatePlannerBlockDto } from '@/types/planner'
+import type { BlockStatus } from '@/types/planner'
+
+export const getPlannerBlocks = (params?: QueryPlannerBlockDto): Promise<{ data: PlannerBlock[]; total: number }> =>
+  apiClient.get('/api/planner-blocks', { params }) as Promise<{ data: PlannerBlock[]; total: number }>
+
+export const getPlannerBlock = (id: string): Promise<PlannerBlock> =>
+  apiClient.get(`/api/planner-blocks/${id}`) as Promise<PlannerBlock>
+
+export const createPlannerBlock = (dto: CreatePlannerBlockDto): Promise<PlannerBlock> =>
+  apiClient.post('/api/planner-blocks', dto) as Promise<PlannerBlock>
+
+export const updatePlannerBlock = (id: string, dto: UpdatePlannerBlockDto): Promise<PlannerBlock> =>
+  apiClient.patch(`/api/planner-blocks/${id}`, dto) as Promise<PlannerBlock>
+
+export const updateBlockStatus = (id: string, status: BlockStatus): Promise<PlannerBlock> =>
+  apiClient.patch(`/api/planner-blocks/${id}/status`, { status }) as Promise<PlannerBlock>
+
+export const duplicatePlannerBlock = (id: string, targetDate?: string): Promise<PlannerBlock> =>
+  apiClient.post(`/api/planner-blocks/${id}/duplicate`, null, {
+    params: targetDate ? { targetDate } : undefined,
+  }) as Promise<PlannerBlock>
+
+export const deletePlannerBlock = (id: string): Promise<void> =>
+  apiClient.delete(`/api/planner-blocks/${id}`) as Promise<void>

package/templates/frontend/src/lib/api/task-columns.ts

@@ -0,0 +1,17 @@
+import apiClient from '@/lib/api/client'
+import type { CreateTaskColumnDto, TaskColumn, UpdateTaskColumnDto } from '@/types/tasks'
+
+export const getTaskColumns = (): Promise<TaskColumn[]> =>
+  apiClient.get('/api/task-columns') as Promise<TaskColumn[]>
+
+export const createTaskColumn = (dto: CreateTaskColumnDto): Promise<TaskColumn> =>
+  apiClient.post('/api/task-columns', dto) as Promise<TaskColumn>
+
+export const updateTaskColumn = (id: string, dto: UpdateTaskColumnDto): Promise<TaskColumn> =>
+  apiClient.patch(`/api/task-columns/${id}`, dto) as Promise<TaskColumn>
+
+export const reorderTaskColumns = (ids: string[]): Promise<TaskColumn[]> =>
+  apiClient.patch('/api/task-columns/reorder', { ids }) as Promise<TaskColumn[]>
+
+export const deleteTaskColumn = (id: string): Promise<void> =>
+  apiClient.delete(`/api/task-columns/${id}`) as Promise<void>

package/templates/frontend/src/lib/api/tasks.ts

@@ -0,0 +1,21 @@
+import apiClient from '@/lib/api/client'
+import type { CreateTaskDto, MoveTaskDto, Task, UpdateTaskDto } from '@/types/tasks'
+import type { PaginatedResult } from '@/types/clients'
+
+export const getTasks = (params?: Record<string, unknown>): Promise<PaginatedResult<Task>> =>
+  apiClient.get('/api/tasks', { params }) as Promise<PaginatedResult<Task>>
+
+export const getTask = (id: string): Promise<Task> =>
+  apiClient.get(`/api/tasks/${id}`) as Promise<Task>
+
+export const createTask = (dto: CreateTaskDto): Promise<Task> =>
+  apiClient.post('/api/tasks', dto) as Promise<Task>
+
+export const updateTask = (id: string, dto: UpdateTaskDto): Promise<Task> =>
+  apiClient.patch(`/api/tasks/${id}`, dto) as Promise<Task>
+
+export const moveTask = (id: string, dto: MoveTaskDto): Promise<Task> =>
+  apiClient.patch(`/api/tasks/${id}/move`, dto) as Promise<Task>
+
+export const deleteTask = (id: string): Promise<void> =>
+  apiClient.delete(`/api/tasks/${id}`) as Promise<void>

package/templates/frontend/src/lib/hooks/use-unread-notifications.ts

@@ -0,0 +1,23 @@
+import { useEffect, useState } from 'react'
+import { getUnreadCount } from '@/lib/api/notifications'
+
+export function useUnreadNotifications(intervalMs = 30000) {
+  const [count, setCount] = useState(0)
+
+  useEffect(() => {
+    let mounted = true
+
+    const fetch = async () => {
+      try {
+        const res = await getUnreadCount()
+        if (mounted) setCount(res.count)
+      } catch { /* silent */ }
+    }
+
+    fetch()
+    const timer = setInterval(fetch, intervalMs)
+    return () => { mounted = false; clearInterval(timer) }
+  }, [intervalMs])
+
+  return count
+}

package/templates/frontend/src/providers/auth-provider.tsx

@@ -9,6 +9,7 @@ interface AuthContextValue extends AuthState {
   login: (email: string, password: string) => Promise<void>
   logout: () => Promise<void>
   register: (name: string, email: string, password: string) => Promise<{ message: string }>
+  refreshUser: () => Promise<void>
 }
 
 const AuthContext = createContext<AuthContextValue | null>(null)
@@ -46,8 +47,13 @@ export function AuthProvider({ children }: { children: React.ReactNode }) {
     [],
   )
 
+  const refreshUser = useCallback(async () => {
+    const user = await authApi.getMe()
+    setState({ user, isLoading: false, isAuthenticated: true })
+  }, [])
+
   return (
-    <AuthContext.Provider value={{ ...state, login, logout, register }}>
+    <AuthContext.Provider value={{ ...state, login, logout, register, refreshUser }}>
       {children}
     </AuthContext.Provider>
   )

package/templates/frontend/src/types/clients.ts

@@ -0,0 +1,38 @@
+export interface Client {
+  _id: string
+  name: string
+  email?: string
+  phone?: string
+  address?: string
+  status: 'active' | 'archived'
+  notes?: string
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateClientDto {
+  name: string
+  email?: string
+  phone?: string
+  address?: string
+  notes?: string
+  status?: 'active' | 'archived'
+}
+
+export type UpdateClientDto = Partial<CreateClientDto>
+
+export interface QueryClientDto {
+  search?: string
+  status?: 'active' | 'archived'
+  page?: number
+  limit?: number
+}
+
+export interface PaginatedResult<T> {
+  data: T[]
+  total: number
+  page: number
+  limit: number
+  totalPages: number
+}

package/templates/frontend/src/types/invoices.ts

@@ -0,0 +1,51 @@
+export interface InvoiceItem {
+  description: string
+  quantity: number
+  unitPrice: number
+  amount: number
+}
+
+export interface Invoice {
+  _id: string
+  type: 'income' | 'expense'
+  number?: string
+  clientId?: string
+  status: 'draft' | 'pending' | 'paid' | 'overdue' | 'cancelled'
+  issueDate: string
+  dueDate?: string
+  items: InvoiceItem[]
+  subtotal: number
+  taxRate: number
+  taxAmount: number
+  total: number
+  currency: string
+  notes?: string
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateInvoiceDto {
+  type?: 'income' | 'expense'
+  number?: string
+  clientId?: string
+  status?: 'draft' | 'pending' | 'paid' | 'overdue' | 'cancelled'
+  issueDate?: string
+  dueDate?: string
+  items?: InvoiceItem[]
+  taxRate?: number
+  currency?: string
+  notes?: string
+  total?: number
+}
+
+export type UpdateInvoiceDto = Partial<CreateInvoiceDto>
+
+export interface QueryInvoiceDto {
+  search?: string
+  status?: string
+  type?: 'income' | 'expense'
+  clientId?: string
+  page?: number
+  limit?: number
+}

package/templates/frontend/src/types/notifications.ts

@@ -0,0 +1,30 @@
+export interface Notification {
+  _id: string
+  userId: string
+  title: string
+  message: string
+  type: 'info' | 'warning' | 'success' | 'error'
+  link?: string
+  isRead: boolean
+  refId?: string
+  refType?: string
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateNotificationDto {
+  userId: string
+  title: string
+  message: string
+  type?: 'info' | 'warning' | 'success' | 'error'
+  link?: string
+  refId?: string
+  refType?: string
+}
+
+export interface QueryNotificationDto {
+  isRead?: boolean
+  page?: number
+  limit?: number
+}

package/templates/frontend/src/types/pipeline.ts

@@ -0,0 +1,35 @@
+export type DealStage = 'lead' | 'contacted' | 'proposal' | 'won' | 'lost'
+
+export interface Deal {
+  _id: string
+  title: string
+  clientId?: string
+  value: number
+  currency: string
+  stage: DealStage
+  expectedCloseDate?: string
+  notes?: string
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateDealDto {
+  title: string
+  clientId?: string
+  value?: number
+  currency?: string
+  stage?: DealStage
+  expectedCloseDate?: string
+  notes?: string
+}
+
+export type UpdateDealDto = Partial<CreateDealDto>
+
+export interface QueryDealDto {
+  search?: string
+  stage?: DealStage
+  clientId?: string
+  page?: number
+  limit?: number
+}

package/templates/frontend/src/types/planner.ts

@@ -0,0 +1,49 @@
+export type BlockStatus = 'pending' | 'in-progress' | 'completed' | 'skipped'
+export type BlockPriority = 'low' | 'medium' | 'high'
+
+export interface PlannerBlock {
+  _id: string
+  userId: string
+  date: string
+  startTime: string
+  endTime: string
+  title: string
+  description?: string
+  category: string
+  priority: BlockPriority
+  status: BlockStatus
+  color: string
+  isFocusBlock: boolean
+  order: number
+  tags: string[]
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreatePlannerBlockDto {
+  date: string
+  startTime: string
+  endTime: string
+  title: string
+  description?: string
+  category?: string
+  priority?: BlockPriority
+  status?: BlockStatus
+  color?: string
+  isFocusBlock?: boolean
+  order?: number
+  tags?: string[]
+}
+
+export type UpdatePlannerBlockDto = Partial<CreatePlannerBlockDto>
+
+export interface QueryPlannerBlockDto {
+  date?: string
+  dateFrom?: string
+  dateTo?: string
+  status?: BlockStatus
+  category?: string
+  page?: number
+  limit?: number
+}

package/templates/frontend/src/types/tasks.ts

@@ -0,0 +1,65 @@
+export interface ChecklistItem {
+  text: string
+  completed: boolean
+}
+
+export interface TaskLabel {
+  name: string
+  color: string
+}
+
+export type TaskStatus = 'todo' | 'in-progress' | 'done' | 'cancelled'
+export type TaskPriority = 'low' | 'medium' | 'high' | 'urgent'
+
+export interface Task {
+  _id: string
+  title: string
+  description?: string
+  status: TaskStatus
+  priority: TaskPriority
+  dueDate?: string
+  columnId: string | null
+  order: number
+  checklist: ChecklistItem[]
+  labels: TaskLabel[]
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface TaskColumn {
+  _id: string
+  name: string
+  color: string
+  order: number
+  workspaceId: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface CreateTaskDto {
+  title: string
+  description?: string
+  status?: TaskStatus
+  priority?: TaskPriority
+  dueDate?: string
+  columnId?: string | null
+  order?: number
+  checklist?: ChecklistItem[]
+  labels?: TaskLabel[]
+}
+
+export type UpdateTaskDto = Partial<CreateTaskDto>
+
+export interface MoveTaskDto {
+  columnId: string | null
+  order?: number
+}
+
+export interface CreateTaskColumnDto {
+  name: string
+  color?: string
+  order?: number
+}
+
+export type UpdateTaskColumnDto = Partial<CreateTaskColumnDto>