Add PayloadCMS type definitions, Prettier config, and PNPM lockfile

2025-12-12 03:43:23 +00:00 · 2025-09-13 17:17:50 +02:00
parent bb86a68fa2
commit b995bdb505
50 changed files with 16356 additions and 0 deletions
--- a/src/collections/customers.ts
+++ b/src/collections/customers.ts
@@ -0,0 +1,149 @@
+import type { CollectionConfig } from 'payload'
+
+import type { 
+  AccessArgs,
+  CollectionAfterChangeHook,
+  CollectionBeforeChangeHook,
+  CustomerData,
+  CustomerDocument
+} from '../types/payload'
+
+export function createCustomersCollection(slug: string = 'customers'): 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: ['email', 'name', 'createdAt'],
+      group: 'Billing',
+      useAsTitle: 'email',
+    },
+    fields: [
+      {
+        name: 'email',
+        type: 'email',
+        admin: {
+          description: 'Customer email address',
+        },
+        index: true,
+        unique: true,
+      },
+      {
+        name: 'name',
+        type: 'text',
+        admin: {
+          description: 'Customer full name',
+        },
+      },
+      {
+        name: 'phone',
+        type: 'text',
+        admin: {
+          description: 'Customer phone number',
+        },
+      },
+      {
+        name: 'address',
+        type: 'group',
+        fields: [
+          {
+            name: 'line1',
+            type: 'text',
+            label: 'Address Line 1',
+          },
+          {
+            name: 'line2',
+            type: 'text',
+            label: 'Address Line 2',
+          },
+          {
+            name: 'city',
+            type: 'text',
+            label: 'City',
+          },
+          {
+            name: 'state',
+            type: 'text',
+            label: 'State/Province',
+          },
+          {
+            name: 'postal_code',
+            type: 'text',
+            label: 'Postal Code',
+          },
+          {
+            name: 'country',
+            type: 'text',
+            admin: {
+              description: 'ISO 3166-1 alpha-2 country code',
+            },
+            label: 'Country',
+            maxLength: 2,
+          },
+        ],
+      },
+      {
+        name: 'providerIds',
+        type: 'json',
+        admin: {
+          description: 'Customer IDs from payment providers',
+          readOnly: true,
+        },
+      },
+      {
+        name: 'metadata',
+        type: 'json',
+        admin: {
+          description: 'Additional customer metadata',
+        },
+      },
+      {
+        name: 'payments',
+        type: 'relationship',
+        admin: {
+          description: 'Customer payments',
+          readOnly: true,
+        },
+        hasMany: true,
+        relationTo: 'payments',
+      },
+      {
+        name: 'invoices',
+        type: 'relationship',
+        admin: {
+          description: 'Customer invoices',
+          readOnly: true,
+        },
+        hasMany: true,
+        relationTo: 'invoices',
+      },
+    ],
+    hooks: {
+      afterChange: [
+        ({ doc, operation, req }: CollectionAfterChangeHook<CustomerDocument>) => {
+          if (operation === 'create') {
+            req.payload.logger.info(`Customer created: ${doc.id} (${doc.email})`)
+          }
+        },
+      ],
+      beforeChange: [
+        ({ data, operation }: CollectionBeforeChangeHook<CustomerData>) => {
+          if (operation === 'create' || operation === 'update') {
+            // Normalize country code
+            if (data.address?.country) {
+              data.address.country = data.address.country.toUpperCase()
+              if (!/^[A-Z]{2}$/.test(data.address.country)) {
+                throw new Error('Country must be a 2-letter ISO code')
+              }
+            }
+          }
+        },
+      ],
+    },
+    timestamps: true,
+  }
+}