@donotdev/cli 0.0.3

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

@@ -0,0 +1,116 @@
+# {{APP_NAME}} Functions
+
+This directory contains the Vercel Functions for the {{APP_NAME}} app, generated using the DoNotDev framework's scaffolding system.
+
+## Structure
+
+```
+functions/
+├── src/
+│   └── api/
+│       ├── auth/                    # Authentication functions
+│       ├── oauth/                   # OAuth functions
+│       └── billing/                 # Billing functions
+├── package.json                    # Dependencies and scripts
+├── tsconfig.json                   # TypeScript configuration
+├── vercel.json                     # Vercel 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 Vercel Environment Variables (synced automatically during `dndev deploy`)
+
+**Note:** Functions don't follow Vite/Next.js `.env.local` priority rules. Use Vercel Environment Variables 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
+```
+
+### 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 Vercel Environment Variables (production)
+
+2. **GitHub Setup**:
+   - Create Personal Access Token with `repo` scope
+   - Add token to functions `.env` (local) or Vercel Environment Variables (production)
+   - Configure repository owner/name
+
+3. **Vercel Setup**:
+   - Deploy: `dndev deploy` (from workspace root)
+   - Set environment variables in Vercel dashboard
+   - 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 Vercel development server
+bun run dev
+```
+
+## API Endpoints
+
+### Stripe Webhook
+
+- **URL**: `https://your-app.vercel.app/api/billing/handleStripeWebhook`
+- **Events**: `checkout.session.completed`
+- **Purpose**: Processes purchases and grants access
+
+### Checkout Session
+
+- **Integration**: Direct Stripe calls (no API needed)
+- **Purpose**: Creates Stripe checkout sessions for purchases
+
+## Security
+
+- All functions require authentication
+- Webhook signature verification
+- Secure GitHub token management
+- Environment variable protection
+
+## 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-vercel/functions-vercel/build.mjs.example

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview Build script for {{APP_NAME}} Vercel 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}} Vercel 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}} Vercel 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-vercel/functions-vercel/src/api/auth/getCustomClaims.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/auth/getCustomClaims.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Get Custom Claims Wrapper
+ * @description Wrapper for framework's getCustomClaims with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { getCustomClaims as frameworkGetCustomClaims } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} custom claims retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGetCustomClaims(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/auth/getUserAuthStatus.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/auth/getUserAuthStatus.ts
+
+/**
+ * @fileoverview {{APP_NAME}} User Auth Status Wrapper
+ * @description Wrapper for framework's getUserAuthStatus with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { getUserAuthStatus as frameworkGetUserAuthStatus } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} user authentication status
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGetUserAuthStatus(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/auth/removeCustomClaims.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/auth/removeCustomClaims.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Remove Custom Claims Wrapper
+ * @description Wrapper for framework's removeCustomClaims with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { removeCustomClaims as frameworkRemoveCustomClaims } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} custom claims removal
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkRemoveCustomClaims(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/auth/setCustomClaims.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/auth/setCustomClaims.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Set Custom Claims Wrapper
+ * @description Wrapper for framework's setCustomClaims with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { setCustomClaims as frameworkSetCustomClaims } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} custom claims setting
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkSetCustomClaims(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/billing/handleStripeWebhook.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/billing/handleStripeWebhook.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Stripe Webhook Wrapper
+ * @description Wrapper for framework's handleStripeWebhook with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { handleStripeWebhook as frameworkHandleStripeWebhook } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} Stripe webhook handler
+ * Configured with {{APP_NAME}}-specific product types and settings
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkHandleStripeWebhook(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/billing/processPaymentSuccess.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/billing/processPaymentSuccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Payment Success Wrapper
+ * @description Wrapper for framework's processPaymentSuccess with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { processPaymentSuccess as frameworkProcessPaymentSuccess } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} payment success processing
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkProcessPaymentSuccess(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/billing/refreshSubscriptionStatus.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/billing/refreshSubscriptionStatus.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Subscription Status Wrapper
+ * @description Wrapper for framework's refreshSubscriptionStatus with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { refreshSubscriptionStatus as frameworkRefreshSubscriptionStatus } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} subscription status refresh
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkRefreshSubscriptionStatus(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/crud/createEntity.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/crud/createEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Create Entity Wrapper
+ * @description Wrapper for framework's createEntity with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { createEntity as frameworkCreateEntity } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} entity creation
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkCreateEntity(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/crud/deleteEntity.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/crud/deleteEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Delete Entity Wrapper
+ * @description Wrapper for framework's deleteEntity with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { deleteEntity as frameworkDeleteEntity } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} entity deletion
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkDeleteEntity(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/crud/getEntity.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/crud/getEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Get Entity Wrapper
+ * @description Wrapper for framework's getEntity with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { getEntity as frameworkGetEntity } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} entity retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGetEntity(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/crud/listEntities.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/crud/listEntities.ts
+
+/**
+ * @fileoverview {{APP_NAME}} List Entities Wrapper
+ * @description Wrapper for framework's listEntities with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { listEntities as frameworkListEntities } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} entities listing
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkListEntities(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/crud/updateEntity.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/crud/updateEntity.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Update Entity Wrapper
+ * @description Wrapper for framework's updateEntity with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { updateEntity as frameworkUpdateEntity } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} entity update
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkUpdateEntity(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/checkGitHubAccess.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/checkGitHubAccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} GitHub Access Check Wrapper
+ * @description Wrapper for framework's checkGitHubAccess with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { checkGitHubAccess as frameworkCheckGitHubAccess } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} GitHub access checking
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkCheckGitHubAccess(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/disconnect.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/disconnect.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Disconnect OAuth Wrapper
+ * @description Wrapper for framework's disconnect with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { disconnect as frameworkDisconnect } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} OAuth disconnection
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkDisconnect(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/exchangeToken.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/exchangeToken.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Exchange Token Wrapper
+ * @description Wrapper for framework's exchangeToken with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { exchangeToken as frameworkExchangeToken } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} OAuth token exchange
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkExchangeToken(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/getConnections.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/getConnections.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Get Connections Wrapper
+ * @description Wrapper for framework's getConnections with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { getConnections as frameworkGetConnections } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} OAuth connections retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGetConnections(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/grantGitHubAccess.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/grantGitHubAccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} GitHub Access Wrapper
+ * @description Wrapper for framework's grantGitHubAccess with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { grantGitHubAccess as frameworkGrantGitHubAccess } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} GitHub access granting
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGrantGitHubAccess(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/refreshToken.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/refreshToken.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Refresh Token Wrapper
+ * @description Wrapper for framework's refreshToken with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { refreshToken as frameworkRefreshToken } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} OAuth token refresh
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkRefreshToken(req, res);
+}

package/templates/functions-vercel/functions-vercel/src/api/oauth/revokeGitHubAccess.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/oauth/revokeGitHubAccess.ts
+
+/**
+ * @fileoverview {{APP_NAME}} GitHub Access Revocation Wrapper
+ * @description Wrapper for framework's revokeGitHubAccess with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { revokeGitHubAccess as frameworkRevokeGitHubAccess } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} GitHub access revocation
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkRevokeGitHubAccess(req, res);
+}

package/templates/functions-vercel/functions-vercel/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-vercel/functions-vercel/vercel.json.example

@@ -0,0 +1,14 @@
+{
+  "functions": {
+    "src/api/**/*.ts": {
+      "runtime": "nodejs20.x"
+    }
+  },
+  "env": {
+    "STRIPE_SECRET_KEY": "@stripe-secret-key",
+    "STRIPE_WEBHOOK_SECRET": "@stripe-webhook-secret",
+    "GITHUB_PERSONAL_ACCESS_TOKEN": "@github-token",
+    "GITHUB_REPO_OWNER": "@github-repo-owner",
+    "GITHUB_REPO_NAME": "@github-repo-name"
+  }
+}

package/templates/functions-vercel/src/api/auth/getCustomClaims.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/auth/getCustomClaims.ts
+
+/**
+ * @fileoverview {{APP_NAME}} Get Custom Claims Wrapper
+ * @description Wrapper for framework's getCustomClaims with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { getCustomClaims as frameworkGetCustomClaims } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} custom claims retrieval
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGetCustomClaims(req, res);
+}

package/templates/functions-vercel/src/api/auth/getUserAuthStatus.ts.example

@@ -0,0 +1,20 @@
+// functions/src/api/auth/getUserAuthStatus.ts
+
+/**
+ * @fileoverview {{APP_NAME}} User Auth Status Wrapper
+ * @description Wrapper for framework's getUserAuthStatus with {{APP_NAME}}-specific configuration
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { getUserAuthStatus as frameworkGetUserAuthStatus } from '@donotdev/functions/vercel';
+
+/**
+ * {{APP_NAME}} user authentication status
+ * Wraps the framework function with {{APP_NAME}}-specific configuration
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  return frameworkGetUserAuthStatus(req, res);
+}