@donotdev/cli 0.0.3

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

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "strict": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowSyntheticDefaultImports": true,
+    "noUncheckedIndexedAccess": true,
+    "types": ["node"],
+    "outDir": "./lib",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "lib", "**/*.test.ts"]
+}

package/templates/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/github/github/workflows/firebase-deploy.yml.example

@@ -0,0 +1,79 @@
+name: Deploy to Firebase Hosting
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build_and_deploy:
+    runs-on: ubuntu-latest
+    steps:
+      # Step 1: Create parent directory for proper relative paths
+      - name: Create parent directory structure
+        run: |
+          mkdir -p $GITHUB_WORKSPACE/../dndev
+          ls -la $GITHUB_WORKSPACE/..
+
+      # Step 2: Checkout main repository
+      - name: Checkout {{projectName}} Repository
+        uses: actions/checkout@v4
+        with:
+          path: {{projectName}}
+
+      # Step 3: Checkout dndev repository
+      - name: Checkout DnDev Repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository_owner }}/dndev  # Uses same owner as project repo
+          token: ${{ secrets.GH_PAT }} # Personal access token with repo scope
+          path: dndev
+
+      # Step 4: Set up Node.js
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20' # Using Node 20
+          
+      # Step 5: Setup Bun
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: 1.3.0
+
+      # Step 6: Setup Bun cache
+      - name: Setup Bun cache
+        uses: actions/cache@v3
+        with:
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-cache-${{ hashFiles('**/bun.lockb') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-cache-
+
+      # Step 7: Install dependencies
+      - name: Install Dependencies
+        working-directory: {{projectName}}
+        run: bun install
+
+      # Step 8: Build the project
+      - name: Build
+        working-directory: {{projectName}}
+        run: bun run build
+
+      # Step 10: Copy firebase.json to the right location
+      - name: Copy Firebase configuration
+        run: |
+          cp {{projectName}}/firebase.json .
+          cp {{projectName}}/.firebaserc .
+          ls -la
+
+      # Step 11: Deploy to Firebase Hosting
+      - name: Deploy to Firebase Hosting
+        uses: FirebaseExtended/action-hosting-deploy@v0
+        with:
+          repoToken: '${{ secrets.GITHUB_TOKEN }}'
+          firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT_{{firebaseSecretName}} }}'
+          channelId: live
+          projectId: {{firebaseProjectId}}
+          entryPoint: '.'  # Uses firebase.json at the root
+        env:
+          FIREBASE_CLI_PREVIEWS: hostingchannels

package/templates/github/workflows/firebase-deploy.yml.example

@@ -0,0 +1,79 @@
+name: Deploy to Firebase Hosting
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build_and_deploy:
+    runs-on: ubuntu-latest
+    steps:
+      # Step 1: Create parent directory for proper relative paths
+      - name: Create parent directory structure
+        run: |
+          mkdir -p $GITHUB_WORKSPACE/../dndev
+          ls -la $GITHUB_WORKSPACE/..
+
+      # Step 2: Checkout main repository
+      - name: Checkout {{projectName}} Repository
+        uses: actions/checkout@v4
+        with:
+          path: {{projectName}}
+
+      # Step 3: Checkout dndev repository
+      - name: Checkout DnDev Repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository_owner }}/dndev  # Uses same owner as project repo
+          token: ${{ secrets.GH_PAT }} # Personal access token with repo scope
+          path: dndev
+
+      # Step 4: Set up Node.js
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20' # Using Node 20
+          
+      # Step 5: Setup Bun
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: 1.3.0
+
+      # Step 6: Setup Bun cache
+      - name: Setup Bun cache
+        uses: actions/cache@v3
+        with:
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-cache-${{ hashFiles('**/bun.lockb') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-cache-
+
+      # Step 7: Install dependencies
+      - name: Install Dependencies
+        working-directory: {{projectName}}
+        run: bun install
+
+      # Step 8: Build the project
+      - name: Build
+        working-directory: {{projectName}}
+        run: bun run build
+
+      # Step 10: Copy firebase.json to the right location
+      - name: Copy Firebase configuration
+        run: |
+          cp {{projectName}}/firebase.json .
+          cp {{projectName}}/.firebaserc .
+          ls -la
+
+      # Step 11: Deploy to Firebase Hosting
+      - name: Deploy to Firebase Hosting
+        uses: FirebaseExtended/action-hosting-deploy@v0
+        with:
+          repoToken: '${{ secrets.GITHUB_TOKEN }}'
+          firebaseServiceAccount: '${{ secrets.FIREBASE_SERVICE_ACCOUNT_{{firebaseSecretName}} }}'
+          channelId: live
+          projectId: {{firebaseProjectId}}
+          entryPoint: '.'  # Uses firebase.json at the root
+        env:
+          FIREBASE_CLI_PREVIEWS: hostingchannels

package/templates/root-consumer/.env.example

@@ -0,0 +1,19 @@
+# =============================================================================
+# DoNotDev Framework License Key
+# =============================================================================
+# This root-level .env file should ONLY contain the framework license key.
+# App-specific environment variables (Firebase, emulators, etc.) should be
+# placed in each app's own .env files (apps/*/.env).
+#
+# ⚠️ WARNING: If a root .env file exists, Vite/Next.js will load it and
+# it will take priority over app-specific .env files. Only create a root .env
+# if you want to share the same license key across all apps.
+#
+# Get your license key from: https://donotdev.com/pricing
+# Removes watermark and enables all features
+#
+# For Vite projects:
+VITE_DONOTDEV_LICENSE_KEY=dndev_your_key_here
+#
+# For Next.js projects:
+NEXT_PUBLIC_DONOTDEV_LICENSE_KEY=dndev_your_key_here

package/templates/root-consumer/.gitignore.example

@@ -0,0 +1,82 @@
+# Dependencies
+node_modules
+.bun/install/cache/
+
+# Build outputs
+dist
+build
+.turbo/
+.vite/
+.next/
+coverage/
+storybook-static/
+*.tsbuildinfo
+stats.html
+
+# Environment variables
+.env
+.env.*
+!.env.example
+# Note: .env.local and .env.*.local are gitignored (local overrides)
+# .env.production.local is gitignored (production secrets)
+
+# IDE files
+.vscode/*
+!.vscode/extensions.json
+.vscode/settings.json
+.idea/
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+bun-debug.log*
+lerna-debug.log*
+firebase-debug.log*
+ui-debug.log*
+.test-report.json
+
+# System files
+.DS_Store
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Generated files
+*.local
+*.patch
+*.txt
+*.ps1
+
+# Cache
+.cache/
+.firebase/
+.eslintcache
+.stylelintcache
+
+# Firebase service account keys (sensitive, project-specific)
+service-account-key.json
+**/functions/service-account-key.json
+
+# Lock files (using Bun)
+package-lock.json
+yarn.lock
+pnpm-lock.yaml
+bun.lockb
+
+# Temporary files
+.temp
+.tmp
+tmp/
+temp/
+
+# Testing
+/cypress/videos/
+/cypress/screenshots/

package/templates/root-consumer/.prettierrc.cjs.example

@@ -0,0 +1,12 @@
+// .prettierrc.cjs
+// Prettier configuration for DoNotDev projects
+// This config matches the framework's default formatting rules
+module.exports = {
+  semi: true,
+  singleQuote: true,
+  trailingComma: 'es5',
+  tabWidth: 2,
+  printWidth: 80,
+  arrowParens: 'always',
+  endOfLine: 'lf',
+};