@donotdev/cli 0.0.6 → 0.0.8

package/templates/root-consumer/guides/SETUP_FUNCTIONS.md.example

@@ -1,114 +0,0 @@
-# Setup: Firebase Functions
-
-**Most is pre-configured.** Functions scaffolded. Just add config and deploy.
-
----
-
-## ⚠️ CRITICAL: Import Rules for Functions
-
-**Functions run on Node.js - you MUST use `/server` imports or your function will crash on deploy.**
-
-```typescript
-// ✅ CORRECT - Functions MUST use /server imports
-import { getFirebaseAdminAuth } from '@donotdev/firebase/server';
-import { getFirebaseAdminFirestore } from '@donotdev/firebase/server';
-import { handleError } from '@donotdev/core/server';
-
-// ❌ WRONG - This will crash on deploy (pulls in React/client code)
-import { getAuth } from '@donotdev/firebase';
-import { getFirestore } from '@donotdev/firebase';
-import { handleError } from '@donotdev/core';
-```
-
-**Why?** Functions run in Node.js, not the browser. Client imports (`@donotdev/firebase`) include React and browser-only code that will crash your function.
-
-**Rule:** Always use `/server` suffix for:
-- `@donotdev/firebase/server` (not `@donotdev/firebase`)
-- `@donotdev/core/server` (not `@donotdev/core`)
-- `@donotdev/utils/server` (not `@donotdev/utils`)
-
----
-
-## Standard Use
-
-**Structure:**
-```
-functions/
-├── src/
-│   ├── billing/
-│   └── index.ts
-├── functions.yaml    # Manually maintained
-└── .env.local        # Local secrets
-```
-
-**Environment:**
-```bash
-# .env.local (local)
-STRIPE_SECRET_KEY=sk_test_...
-
-# .env (production, synced via dndev sync-secrets)
-STRIPE_SECRET_KEY=sk_live_...
-```
-
----
-
-## Advanced: Adding Functions
-
-1. **Create:** `src/billing/myFunction.ts`
-2. **Export:** `export * from './billing/myFunction.js';` in `src/index.ts`
-3. **Add to functions.yaml:**
-```yaml
-endpoints:
-  myFunction:
-    region: [europe-west1]
-    platform: gcfv2
-    httpsTrigger: {}
-    entryPoint: myFunction
-    labels: {}
-```
-4. **Deploy:** `dndev deploy`
-
-**Critical:** Every exported function must be in `functions.yaml` or it won't deploy.
-
----
-
-## Advanced: Framework Integration
-
-```typescript
-// Your function = framework + your config
-import { createCheckoutSession as generic } from '@donotdev/functions/firebase';
-import { stripeBackConfig } from '../config/stripeBackConfig';
-
-export const createCheckoutSession = generic(stripeBackConfig);
-```
-
----
-
-## Advanced: Custom Functions with Firebase
-
-**When writing custom functions that access Firestore/Auth, use `/server` imports:**
-
-```typescript
-import { onCall } from 'firebase-functions/v2/https';
-import { FUNCTION_CONFIG } from '@donotdev/functions/firebase';
-// ✅ MUST use /server imports in functions
-import { getFirebaseAdminFirestore } from '@donotdev/firebase/server';
-import { getFirebaseAdminAuth } from '@donotdev/firebase/server';
-import { handleError } from '@donotdev/core/server';
-
-export const myCustomFunction = onCall(FUNCTION_CONFIG, async (request) => {
-  const firestore = getFirebaseAdminFirestore();
-  const auth = getFirebaseAdminAuth();
-  
-  // Your custom logic here
-  const doc = await firestore.collection('users').doc(request.auth.uid).get();
-  
-  return { data: doc.data() };
-});
-```
-
-**Remember:** All Firebase imports in functions MUST use `@donotdev/firebase/server`, never `@donotdev/firebase`.
-
----
-
-**Add functions, get backend. Framework handles the rest.**