@donotdev/cli 0.0.3

package/templates/functions-firebase/functions-firebase/README.md.example

@@ -0,0 +1,123 @@
+# {{APP_NAME}} Functions
+
+This directory contains the Firebase Functions for the {{APP_NAME}} app, generated using the DoNotDev framework's scaffolding system.
+
+## Structure
+
+```
+functions/
+├── src/
+│   ├── auth/                    # Authentication functions
+│   ├── oauth/                   # OAuth functions
+│   ├── billing/                 # Billing functions
+│   └── index.ts                # Main functions entry point
+├── package.json                # Dependencies and scripts
+├── tsconfig.json              # TypeScript configuration
+├── .env.example               # Environment variables template
+└── README.md                  # This file
+```
+
+## Features
+
+- **Authentication Management**: User custom claims and auth status
+- **OAuth Integration**: GitHub access management
+- **Billing Processing**: Stripe checkout and webhook handling
+- **Secure API Layer**: Professional frontend-backend communication
+- **Error Handling**: Comprehensive error handling and logging
+
+## Environment Variables
+
+### File Structure
+
+**Functions use a different .env system than Vite/Next.js:**
+- `.env` → Local development only (not automatically loaded, use with dotenv if needed)
+- Production → Use Firebase Functions Secrets (synced automatically during `dndev deploy`)
+
+**Note:** Functions don't follow Vite/Next.js `.env.local` priority rules. Use Firebase Secrets for production.
+
+### Required Environment Variables
+
+```bash
+# Stripe Configuration
+STRIPE_SECRET_KEY=sk_live_...
+STRIPE_WEBHOOK_SECRET=whsec_...
+
+# GitHub Configuration
+GITHUB_PERSONAL_ACCESS_TOKEN=ghp_...
+GITHUB_REPO_OWNER=your-org
+GITHUB_REPO_NAME=your-repo
+
+# Firebase Configuration
+FIREBASE_PROJECT_ID=your-project-id
+FIREBASE_REGION=us-central1
+```
+
+### Setup Instructions
+
+1. **Stripe Setup**:
+   - Create products in Stripe Dashboard
+   - Get price IDs and add to frontend `.env.local` (dev) or `.env.production.local` (prod)
+   - Configure webhook endpoint in Stripe
+   - Add webhook secret to functions `.env` (local) or Firebase Secrets (production)
+
+2. **GitHub Setup**:
+   - Create Personal Access Token with `repo` scope
+   - Add token to functions `.env` (local) or Firebase Secrets (production)
+   - Configure repository owner/name
+
+3. **Firebase Setup**:
+   - Get service account key: Firebase Console → Project Settings → Service Accounts → "Generate new private key"
+   - Copy JSON content into `service-account-key.json` in app root (shared by frontend + functions)
+   - Deploy: `dndev deploy` (from workspace root)
+   - Update webhook URL in Stripe dashboard
+
+## Deployment
+
+Use the unified deployment command from workspace root:
+
+```bash
+# Deploy everything (interactive)
+dndev deploy
+
+# Deploy specific app
+dndev deploy <app-name>
+```
+
+## Development
+
+```bash
+# Start Firebase emulators
+bun run serve
+
+# Start with debugging
+bun run dev
+```
+
+## API Endpoints
+
+### Stripe Webhook
+
+- **URL**: `https://your-project.cloudfunctions.net/stripeWebhook`
+- **Events**: `checkout.session.completed`
+- **Purpose**: Processes purchases and grants access
+
+### Checkout Session
+
+- **Integration**: Direct Stripe calls (no function needed)
+- **Purpose**: Creates Stripe checkout sessions for purchases
+
+## Security
+
+- All functions require authentication
+- Webhook signature verification
+- Secure GitHub token management
+- Firebase custom claims for user status
+
+## Framework Integration
+
+This functions package demonstrates how to:
+
+- Use the framework's scaffolding system
+- Implement secure API communication
+- Handle complex purchase flows
+- Integrate with external services (Stripe, GitHub)

package/templates/functions-firebase/functions-firebase/build.mjs.example

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Build script for {{APP_NAME}} functions
+ * @description Bundles @donotdev/types and imports framework functions
+ */
+
+import { build } from 'esbuild';
+import { createAppFunctionsConfig } from '@donotdev/core/functions';
+
+async function buildFunctions() {
+  console.log('🔨 Building {{APP_NAME}} functions...');
+  
+  try {
+    const config = createAppFunctionsConfig({
+      entry: 'src/index.ts',
+      outDir: 'lib',
+      minify: process.env.NODE_ENV === 'production',
+      sourcemap: true,
+    });
+
+    console.log('📦 Bundling @donotdev/types and importing framework functions...');
+    
+    const result = await build(config);
+    
+    if (result.errors.length > 0) {
+      console.error('❌ Build errors:', result.errors);
+      process.exit(1);
+    }
+    
+    if (result.warnings.length > 0) {
+      console.warn('⚠️ Build warnings:', result.warnings);
+    }
+    
+    console.log('✅ {{APP_NAME}} functions built successfully!');
+    console.log('📁 Output directory: lib/');
+    
+    // Log bundle info if metafile is available
+    if (result.metafile) {
+      const { analyzeMetafile } = await import('esbuild');
+      const analysis = await analyzeMetafile(result.metafile);
+      console.log('\n📊 Bundle analysis:');
+      console.log(analysis);
+    }
+    
+  } catch (error) {
+    console.error('❌ Build failed:', error);
+    process.exit(1);
+  }
+}
+
+// Run the build
+buildFunctions();

package/templates/functions-firebase/functions-firebase/src/auth/getCustomClaims.ts.example

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview {{APP_NAME}} Get Custom Claims Wrapper
+ * @description Wrapper for framework's getCustomClaims with {{APP_NAME}}-specific configuration
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { getCustomClaims as frameworkGetCustomClaims } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} custom claims retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const getCustomClaims = frameworkGetCustomClaims;

package/templates/functions-firebase/functions-firebase/src/auth/getUserAuthStatus.ts.example

@@ -0,0 +1,21 @@
+// functions/src/auth/getUserAuthStatus.ts
+
+/**
+ * @fileoverview {{APP_NAME}} User Auth Status Wrapper
+ * @description Wrapper for framework's getUserAuthStatus with {{APP_NAME}}-specific configuration
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { getUserAuthStatus as frameworkGetUserAuthStatus } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} user authentication status
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const getUserAuthStatus = frameworkGetUserAuthStatus;

package/templates/functions-firebase/functions-firebase/src/auth/index.ts.example

@@ -0,0 +1,11 @@
+// functions/src/auth/index.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Auth Functions
+ * @description Exports all auth-related functions for the {{APP_NAME}} app
+ */
+
+export { setCustomClaims } from './setCustomClaims';
+export { getCustomClaims } from './getCustomClaims';
+export { removeCustomClaims } from './removeCustomClaims';
+export { getUserAuthStatus } from './getUserAuthStatus';

package/templates/functions-firebase/functions-firebase/src/auth/removeCustomClaims.ts.example

@@ -0,0 +1,21 @@
+// functions/src/auth/removeCustomClaims.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Remove Custom Claims Wrapper
+ * @description Wrapper for framework's removeCustomClaims with {{APP_NAME}}-specific configuration
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { removeCustomClaims as frameworkRemoveCustomClaims } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} custom claims removal
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const removeCustomClaims = frameworkRemoveCustomClaims;

package/templates/functions-firebase/functions-firebase/src/auth/setCustomClaims.ts.example

@@ -0,0 +1,21 @@
+// functions/src/auth/setCustomClaims.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Set Custom Claims Wrapper
+ * @description Wrapper for framework's setCustomClaims with {{APP_NAME}}-specific configuration
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { setCustomClaims as frameworkSetCustomClaims } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} custom claims setting
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const setCustomClaims = frameworkSetCustomClaims;

package/templates/functions-firebase/functions-firebase/src/billing/handleStripeWebhook.ts.example

@@ -0,0 +1,24 @@
+// functions/src/billing/handleStripeWebhook.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Stripe Webhook Wrapper
+ * @description Wrapper for framework's createStripeWebhookHandler with {{APP_NAME}}-specific configuration
+ */
+
+import { createStripeWebhookHandler } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} Stripe webhook handler
+ * Configured with {{APP_NAME}}-specific product types and settings
+ */
+export const stripeWebhook = createStripeWebhookHandler({
+  productTypes: {
+    // Add your product types here
+    // Example:
+    // premium_plan: {
+    //   tier: 'premium',
+    //   subscriptionEnd: '2099-12-31T23:59:59.000Z',
+    //   githubRepo: { owner: 'your-org', repo: 'your-repo' },
+    // },
+  },
+});

package/templates/functions-firebase/functions-firebase/src/billing/index.ts.example

@@ -0,0 +1,10 @@
+// functions/src/billing/index.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Billing Functions
+ * @description Exports all billing-related functions for the {{APP_NAME}} app
+ */
+
+export { processPaymentSuccess } from './processPaymentSuccess';
+export { refreshSubscriptionStatus } from './refreshSubscriptionStatus';
+export { stripeWebhook } from './handleStripeWebhook';

package/templates/functions-firebase/functions-firebase/src/billing/processPaymentSuccess.ts.example

@@ -0,0 +1,14 @@
+// functions/src/billing/processPaymentSuccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Payment Success Wrapper
+ * @description Wrapper for framework's processPaymentSuccess with {{APP_NAME}}-specific configuration
+ */
+
+import { processPaymentSuccess as frameworkProcessPaymentSuccess } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} payment success processing
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const processPaymentSuccess = frameworkProcessPaymentSuccess;

package/templates/functions-firebase/functions-firebase/src/billing/refreshSubscriptionStatus.ts.example

@@ -0,0 +1,14 @@
+// functions/src/billing/refreshSubscriptionStatus.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Subscription Status Wrapper
+ * @description Wrapper for framework's refreshSubscriptionStatus with {{APP_NAME}}-specific configuration
+ */
+
+import { refreshSubscriptionStatus as frameworkRefreshSubscriptionStatus } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} subscription status refresh
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const refreshSubscriptionStatus = frameworkRefreshSubscriptionStatus;

package/templates/functions-firebase/functions-firebase/src/crud/createEntity.ts.example

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview {{APP_NAME}} Create Entity Wrapper
+ * @description Wrapper for framework's createEntity with {{APP_NAME}}-specific configuration
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+
+import { createEntity as frameworkCreateEntity } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} entity creation
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export const createEntity = frameworkCreateEntity;

package/templates/functions-firebase/functions-firebase/src/crud/deleteEntity.ts.example

@@ -0,0 +1,14 @@
+// functions/src/crud/deleteEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Delete Entity Wrapper
+ * @description Wrapper for framework's deleteEntity with {{APP_NAME}}-specific configuration
+ */
+
+import { deleteEntity as frameworkDeleteEntity } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} entity deletion
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const deleteEntity = frameworkDeleteEntity;

package/templates/functions-firebase/functions-firebase/src/crud/getEntity.ts.example

@@ -0,0 +1,14 @@
+// functions/src/crud/getEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Get Entity Wrapper
+ * @description Wrapper for framework's getEntity with {{APP_NAME}}-specific configuration
+ */
+
+import { getEntity as frameworkGetEntity } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} entity retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const getEntity = frameworkGetEntity;

package/templates/functions-firebase/functions-firebase/src/crud/index.ts.example

@@ -0,0 +1,12 @@
+// functions/src/crud/index.ts
+
+/**
+ * @fileoverview {{APP_NAME}} CRUD Functions
+ * @description Exports all CRUD-related functions for the {{APP_NAME}} app
+ */
+
+export { createEntity } from './createEntity';
+export { updateEntity } from './updateEntity';
+export { deleteEntity } from './deleteEntity';
+export { getEntity } from './getEntity';
+export { listEntities } from './listEntities';

package/templates/functions-firebase/functions-firebase/src/crud/listEntities.ts.example

@@ -0,0 +1,14 @@
+// functions/src/crud/listEntities.ts
+
+/**
+ * @fileoverview {{APP_NAME}} List Entities Wrapper
+ * @description Wrapper for framework's listEntities with {{APP_NAME}}-specific configuration
+ */
+
+import { listEntities as frameworkListEntities } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} entities listing
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const listEntities = frameworkListEntities;

package/templates/functions-firebase/functions-firebase/src/crud/updateEntity.ts.example

@@ -0,0 +1,14 @@
+// functions/src/crud/updateEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Update Entity Wrapper
+ * @description Wrapper for framework's updateEntity with {{APP_NAME}}-specific configuration
+ */
+
+import { updateEntity as frameworkUpdateEntity } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} entity update
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const updateEntity = frameworkUpdateEntity;

package/templates/functions-firebase/functions-firebase/src/index.ts.example

@@ -0,0 +1,45 @@
+// functions/src/index.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Firebase Functions
+ * @description {{APP_NAME}} functions that wrap framework functions with {{APP_NAME}}-specific configuration
+ */
+
+import { initializeApp } from 'firebase-admin/app';
+
+// Initialize Firebase Admin if not already initialized
+if (!(globalThis as any).__FIREBASE_ADMIN_INITIALIZED__) {
+  initializeApp();
+  (globalThis as any).__FIREBASE_ADMIN_INITIALIZED__ = true;
+}
+
+// Export auth functions
+export {
+  setCustomClaims,
+  getCustomClaims,
+  removeCustomClaims,
+  getUserAuthStatus,
+} from './auth';
+
+// Export OAuth functions
+export {
+  grantGitHubAccess,
+  revokeGitHubAccess,
+  checkGitHubAccess,
+} from './oauth';
+
+// Export CRUD functions
+export {
+  createEntity,
+  updateEntity,
+  deleteEntity,
+  getEntity,
+  listEntities,
+} from './crud';
+
+// Export billing functions
+export {
+  processPaymentSuccess,
+  refreshSubscriptionStatus,
+  stripeWebhook,
+} from './billing';

package/templates/functions-firebase/functions-firebase/src/oauth/checkGitHubAccess.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/checkGitHubAccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} GitHub Access Check Wrapper
+ * @description Wrapper for framework's checkGitHubAccess with {{APP_NAME}}-specific configuration
+ */
+
+import { checkGitHubAccess as frameworkCheckGitHubAccess } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} GitHub access checking
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const checkGitHubAccess = frameworkCheckGitHubAccess;

package/templates/functions-firebase/functions-firebase/src/oauth/disconnect.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/disconnect.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Disconnect OAuth Wrapper
+ * @description Wrapper for framework's disconnect with {{APP_NAME}}-specific configuration
+ */
+
+import { disconnect as frameworkDisconnect } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} OAuth disconnection
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const disconnect = frameworkDisconnect;

package/templates/functions-firebase/functions-firebase/src/oauth/exchangeToken.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/exchangeToken.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Exchange Token Wrapper
+ * @description Wrapper for framework's exchangeToken with {{APP_NAME}}-specific configuration
+ */
+
+import { exchangeToken as frameworkExchangeToken } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} OAuth token exchange
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const exchangeToken = frameworkExchangeToken;

package/templates/functions-firebase/functions-firebase/src/oauth/getConnections.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/getConnections.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Get Connections Wrapper
+ * @description Wrapper for framework's getConnections with {{APP_NAME}}-specific configuration
+ */
+
+import { getConnections as frameworkGetConnections } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} OAuth connections retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const getConnections = frameworkGetConnections;

package/templates/functions-firebase/functions-firebase/src/oauth/grantGitHubAccess.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/grantGitHubAccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} GitHub Access Wrapper
+ * @description Wrapper for framework's grantGitHubAccess with {{APP_NAME}}-specific configuration
+ */
+
+import { grantGitHubAccess as frameworkGrantGitHubAccess } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} GitHub access granting
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const grantGitHubAccess = frameworkGrantGitHubAccess;

package/templates/functions-firebase/functions-firebase/src/oauth/index.ts.example

@@ -0,0 +1,17 @@
+// functions/src/oauth/index.ts
+
+/**
+ * @fileoverview {{APP_NAME}} OAuth Functions
+ * @description Exports all OAuth-related functions for the {{APP_NAME}} app
+ */
+
+// Generic OAuth functions
+export { exchangeToken } from './exchangeToken';
+export { getConnections } from './getConnections';
+export { disconnect } from './disconnect';
+export { refreshToken } from './refreshToken';
+
+// GitHub-specific OAuth functions
+export { grantGitHubAccess } from './grantGitHubAccess';
+export { revokeGitHubAccess } from './revokeGitHubAccess';
+export { checkGitHubAccess } from './checkGitHubAccess';

package/templates/functions-firebase/functions-firebase/src/oauth/refreshToken.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/refreshToken.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Refresh Token Wrapper
+ * @description Wrapper for framework's refreshToken with {{APP_NAME}}-specific configuration
+ */
+
+import { refreshToken as frameworkRefreshToken } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} OAuth token refresh
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const refreshToken = frameworkRefreshToken;

package/templates/functions-firebase/functions-firebase/src/oauth/revokeGitHubAccess.ts.example

@@ -0,0 +1,14 @@
+// functions/src/oauth/revokeGitHubAccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} GitHub Access Revocation Wrapper
+ * @description Wrapper for framework's revokeGitHubAccess with {{APP_NAME}}-specific configuration
+ */
+
+import { revokeGitHubAccess as frameworkRevokeGitHubAccess } from '@donotdev/functions/firebase';
+
+/**
+ * {{APP_NAME}} GitHub access revocation
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export const revokeGitHubAccess = frameworkRevokeGitHubAccess;

package/templates/functions-firebase/functions-firebase/tsconfig.json.example

@@ -0,0 +1,21 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./lib",
+    "rootDir": "./src",
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "lib", "**/*.test.ts"]
+}

package/templates/functions-firebase/functions.yaml.example

@@ -0,0 +1,14 @@
+endpoints:
+  # Add one entry per function exported from src/index.ts
+  # Each function name must match the export name exactly
+  # Example:
+  # functionName:
+  #   region:
+  #     - europe-west1
+  #   platform: gcfv2
+  #   httpsTrigger: {}
+  #   entryPoint: functionName
+  #   labels: {}
+specVersion: v1alpha1
+requiredAPIs: []
+