Add PayloadCMS type definitions, Prettier config, and PNPM lockfile

src/collections/invoices.ts

@@ -0,0 +1,248 @@
+import type { CollectionConfig } from 'payload'
+
+import type { 
+  AccessArgs,
+  CollectionAfterChangeHook,
+  CollectionBeforeChangeHook,
+  CollectionBeforeValidateHook,
+  InvoiceData,
+  InvoiceDocument,
+  InvoiceItemData
+} from '../types/payload'
+
+export function createInvoicesCollection(slug: string = 'invoices'): CollectionConfig {
+  return {
+    slug,
+    access: {
+      create: ({ req: { user } }: AccessArgs) => !!user,
+      delete: ({ req: { user } }: AccessArgs) => !!user,
+      read: ({ req: { user } }: AccessArgs) => !!user,
+      update: ({ req: { user } }: AccessArgs) => !!user,
+    },
+    admin: {
+      defaultColumns: ['number', 'customer', 'status', 'amount', 'currency', 'dueDate'],
+      group: 'Billing',
+      useAsTitle: 'number',
+    },
+    fields: [
+      {
+        name: 'number',
+        type: 'text',
+        admin: {
+          description: 'Invoice number (e.g., INV-001)',
+        },
+        index: true,
+        required: true,
+        unique: true,
+      },
+      {
+        name: 'customer',
+        type: 'relationship',
+        admin: {
+          position: 'sidebar',
+        },
+        relationTo: 'customers',
+        required: true,
+      },
+      {
+        name: 'status',
+        type: 'select',
+        admin: {
+          position: 'sidebar',
+        },
+        defaultValue: 'draft',
+        options: [
+          { label: 'Draft', value: 'draft' },
+          { label: 'Open', value: 'open' },
+          { label: 'Paid', value: 'paid' },
+          { label: 'Void', value: 'void' },
+          { label: 'Uncollectible', value: 'uncollectible' },
+        ],
+        required: true,
+      },
+      {
+        name: 'currency',
+        type: 'text',
+        admin: {
+          description: 'ISO 4217 currency code (e.g., USD, EUR)',
+        },
+        defaultValue: 'USD',
+        maxLength: 3,
+        required: true,
+      },
+      {
+        name: 'items',
+        type: 'array',
+        admin: {
+          // Custom row labeling can be added here when needed
+        },
+        fields: [
+          {
+            name: 'description',
+            type: 'text',
+            admin: {
+              width: '40%',
+            },
+            required: true,
+          },
+          {
+            name: 'quantity',
+            type: 'number',
+            admin: {
+              width: '15%',
+            },
+            defaultValue: 1,
+            min: 1,
+            required: true,
+          },
+          {
+            name: 'unitAmount',
+            type: 'number',
+            admin: {
+              description: 'Amount in cents',
+              width: '20%',
+            },
+            min: 0,
+            required: true,
+          },
+          {
+            name: 'totalAmount',
+            type: 'number',
+            admin: {
+              description: 'Calculated: quantity × unitAmount',
+              readOnly: true,
+              width: '20%',
+            },
+          },
+        ],
+        minRows: 1,
+        required: true,
+      },
+      {
+        name: 'subtotal',
+        type: 'number',
+        admin: {
+          description: 'Sum of all line items',
+          readOnly: true,
+        },
+      },
+      {
+        name: 'taxAmount',
+        type: 'number',
+        admin: {
+          description: 'Tax amount in cents',
+        },
+        defaultValue: 0,
+      },
+      {
+        name: 'amount',
+        type: 'number',
+        admin: {
+          description: 'Total amount (subtotal + tax)',
+          readOnly: true,
+        },
+      },
+      {
+        name: 'dueDate',
+        type: 'date',
+        admin: {
+          date: {
+            pickerAppearance: 'dayOnly',
+          },
+        },
+      },
+      {
+        name: 'paidAt',
+        type: 'date',
+        admin: {
+          condition: (data: InvoiceData) => data.status === 'paid',
+          readOnly: true,
+        },
+      },
+      {
+        name: 'payment',
+        type: 'relationship',
+        admin: {
+          condition: (data: InvoiceData) => data.status === 'paid',
+          position: 'sidebar',
+        },
+        relationTo: 'payments',
+      },
+      {
+        name: 'notes',
+        type: 'textarea',
+        admin: {
+          description: 'Internal notes',
+        },
+      },
+      {
+        name: 'metadata',
+        type: 'json',
+        admin: {
+          description: 'Additional invoice metadata',
+        },
+      },
+    ],
+    hooks: {
+      afterChange: [
+        ({ doc, operation, req }: CollectionAfterChangeHook<InvoiceDocument>) => {
+          if (operation === 'create') {
+            req.payload.logger.info(`Invoice created: ${doc.number}`)
+          }
+        },
+      ],
+      beforeChange: [
+        ({ data, operation }: CollectionBeforeChangeHook<InvoiceData>) => {
+          if (operation === 'create') {
+            // Generate invoice number if not provided
+            if (!data.number) {
+              const timestamp = Date.now()
+              data.number = `INV-${timestamp}`
+            }
+
+            // Validate currency format
+            if (data.currency) {
+              data.currency = data.currency.toUpperCase()
+              if (!/^[A-Z]{3}$/.test(data.currency)) {
+                throw new Error('Currency must be a 3-letter ISO code')
+              }
+            }
+
+            // Set due date if not provided (30 days from now)
+            if (!data.dueDate) {
+              const dueDate = new Date()
+              dueDate.setDate(dueDate.getDate() + 30)
+              data.dueDate = dueDate.toISOString()
+            }
+          }
+
+          // Set paid date when status changes to paid
+          if (data.status === 'paid' && !data.paidAt) {
+            data.paidAt = new Date().toISOString()
+          }
+        },
+      ],
+      beforeValidate: [
+        ({ data }: CollectionBeforeValidateHook<InvoiceData>) => {
+          if (data && data.items && Array.isArray(data.items)) {
+            // Calculate totals for each line item
+            data.items = data.items.map((item: InvoiceItemData) => ({
+              ...item,
+              totalAmount: (item.quantity || 0) * (item.unitAmount || 0),
+            }))
+
+            // Calculate subtotal
+            data.subtotal = data.items.reduce(
+              (sum: number, item: InvoiceItemData) => sum + (item.totalAmount || 0),
+              0
+            )
+
+            // Calculate total amount
+            data.amount = (data.subtotal || 0) + (data.taxAmount || 0)
+          }
+        },
+      ],
+    },
+    timestamps: true,
+  }
+}