add llms.txt and docs

Author: Bewinxed

docs/conditions.md

@@ -0,0 +1,143 @@
+# Conditions
+
+Build complex trigger conditions with type safety.
+
+## Basic Comparisons
+
+```typescript
+.when(c => c.NEW('status').eq('active'))      // equals
+.when(c => c.NEW('price').gt(100))            // greater than
+.when(c => c.NEW('stock').gte(10))            // greater or equal
+.when(c => c.NEW('discount').lt(50))          // less than
+.when(c => c.NEW('quantity').lte(5))          // less or equal
+.when(c => c.NEW('email').ne('old@mail.com')) // not equal
+```
+
+## Field Comparisons
+
+```typescript
+// Compare OLD vs NEW
+.when(c => c.OLD('email').ne(c.NEW('email')))
+
+// Check if changed
+.when(c => c.changed('status'))
+.when(c => c.changed('email', 'phone'))  // Any of these changed
+```
+
+## Null Checks
+
+```typescript
+.when(c => c.NEW('deletedAt').isNull())
+.when(c => c.NEW('approvedBy').isNotNull())
+```
+
+## Boolean Logic
+
+```typescript
+// AND
+.when(c => c.and(
+  c.NEW('status').eq('published'),
+  c.NEW('visibility').eq('public')
+))
+
+// OR
+.when(c => c.or(
+  c.NEW('priority').eq('high'),
+  c.NEW('deadline').lt(new Date())
+))
+
+// NOT
+.when(c => c.not(c.NEW('archived').eq(true)))
+```
+
+## Complex Conditions
+
+```typescript
+// Nested logic
+.when(c => c.and(
+  c.changed('status'),
+  c.or(
+    c.and(
+      c.OLD('status').eq('draft'),
+      c.NEW('status').eq('published')
+    ),
+    c.and(
+      c.OLD('status').eq('published'),
+      c.NEW('status').eq('archived')
+    )
+  )
+))
+```
+
+## Pattern Matching
+
+```typescript
+// LIKE
+.when(c => c.NEW('email').like('%@company.com'))
+
+// IN
+.when(c => c.NEW('status').in(['active', 'pending', 'processing']))
+
+// BETWEEN
+.when(c => c.NEW('age').between(18, 65))
+```
+
+## Real-World Examples
+
+### Order Status Workflow
+
+```typescript
+triggers
+  .for('order')
+  .after()
+  .on('UPDATE')
+  .when(c => c.and(
+    c.changed('status'),
+    c.OLD('status').eq('payment_pending'),
+    c.NEW('status').eq('payment_confirmed'),
+    c.NEW('amount').gt(0)
+  ))
+  .notify('order_paid')
+  .build();
+```
+
+### User Account Changes
+
+```typescript
+triggers
+  .for('user')
+  .after()
+  .on('UPDATE')
+  .when(c => c.or(
+    c.changed('email'),
+    c.changed('password'),
+    c.changed('twoFactorEnabled')
+  ))
+  .notify('security_change')
+  .build();
+```
+
+### Inventory Alerts
+
+```typescript
+triggers
+  .for('product')
+  .after()
+  .on('UPDATE')
+  .when(c => c.and(
+    c.NEW('stock').lt(10),
+    c.OLD('stock').gte(10),
+    c.NEW('active').eq(true)
+  ))
+  .notify('low_stock_alert')
+  .build();
+```
+
+## Raw SQL Escape Hatch
+
+```typescript
+// For complex conditions not supported by the builder
+.when('NEW.data::jsonb @> \'{"featured": true}\'::jsonb')
+```
+
+## Next: [Real-time Events](./realtime-events.md)

docs/index.md

@@ -0,0 +1,52 @@
+# pg-typesafe-triggers
+
+Type-safe PostgreSQL triggers for Prisma without writing SQL.
+
+## What it does
+
+Automatically creates PostgreSQL trigger functions from TypeScript code. Full type safety using your Prisma schema types.
+
+## Quick Example
+
+```typescript
+// Instead of writing SQL...
+triggers
+  .for('order')
+  .after()
+  .on('UPDATE')
+  .when(c => c.NEW('status').eq('shipped'))
+  .notify('order_shipped')
+  .build();
+
+// Automatically generates and manages the PostgreSQL trigger
+```
+
+## Use Cases
+
+- [Individual Triggers](./individual-triggers.md) - Fine control over single triggers
+- [Registry Pattern](./registry-pattern.md) - Manage multiple triggers at once
+- [Conditions](./conditions.md) - Complex trigger logic
+- [Real-time Events](./realtime-events.md) - Subscribe to database changes
+- [Common Patterns](./patterns.md) - Audit logs, workflows, sync
+
+## Installation
+
+```bash
+npm install pg-typesafe-triggers
+```
+
+## Basic Setup
+
+```typescript
+import { createTriggers } from 'pg-typesafe-triggers';
+import { PrismaClient } from '@prisma/client';
+
+const prisma = new PrismaClient();
+const triggers = createTriggers<typeof prisma>(DATABASE_URL);
+```
+
+## Next Steps
+
+Choose your approach:
+- [Individual Triggers](./individual-triggers.md) for specific use cases
+- [Registry Pattern](./registry-pattern.md) for managing many triggers

docs/individual-triggers.md

@@ -0,0 +1,87 @@
+# Individual Triggers
+
+Create and manage single triggers with fine-grained control.
+
+## Basic Trigger
+
+```typescript
+const trigger = triggers
+  .for('user')
+  .after()
+  .on('INSERT')
+  .notify('new_user')
+  .build();
+
+await trigger.setup();
+```
+
+## Trigger Options
+
+### Timing
+
+```typescript
+.before()  // Run before the operation
+.after()   // Run after the operation
+```
+
+### Events
+
+```typescript
+.on('INSERT')
+.on('UPDATE')
+.on('DELETE')
+.on('INSERT', 'UPDATE')  // Multiple events
+```
+
+### Column Watching
+
+```typescript
+.watchColumns('email', 'status')  // Only trigger on specific column changes
+```
+
+### Custom Names
+
+```typescript
+.withName('user_email_change_trigger')
+```
+
+## Complete Example
+
+```typescript
+const emailChangeTrigger = triggers
+  .for('user')
+  .withName('track_email_changes')
+  .after()
+  .on('UPDATE')
+  .watchColumns('email')
+  .when(c => c.OLD('email').ne(c.NEW('email')))
+  .notify('user_email_changed')
+  .build();
+
+// Deploy
+await emailChangeTrigger.setup();
+await emailChangeTrigger.listen();
+
+// Handle events
+emailChangeTrigger.subscribe((event) => {
+  console.log(`Email changed from ${event.old.email} to ${event.data.email}`);
+});
+```
+
+## Lifecycle Methods
+
+```typescript
+await trigger.setup();   // Create in database
+await trigger.listen();  // Start listening for events
+await trigger.stop();    // Stop listening
+await trigger.drop();    // Remove from database
+```
+
+## When to Use
+
+- Single, specific business logic
+- Testing individual triggers
+- Gradual migration from SQL triggers
+- Simple notification needs
+
+## Next: [Registry Pattern](./registry-pattern.md)