stackkit-cli 0.4.3 → 0.4.5

package/modules/auth/authjs/module.json

@@ -0,0 +1,95 @@
+{
+  "name": "authjs",
+  "displayName": "Auth.js",
+  "description": "Authentication with Auth.js (NextAuth.js v5)",
+  "category": "auth",
+  "provider": "authjs",
+  "supportedFrameworks": ["nextjs"],
+  "databaseAdapters": {
+    "common": {
+      "dependencies": {
+        "@auth/prisma-adapter": "^2.7.1"
+      },
+      "devDependencies": {}
+    },
+    "prisma-postgresql": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {}
+    },
+    "prisma-mongodb": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {}
+    },
+    "prisma-mysql": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {}
+    },
+    "prisma-sqlite": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {}
+    }
+  },
+  "frameworkConfigs": {
+    "nextjs": {
+      "dependencies": {
+        "next-auth": "^5.0.0"
+      },
+      "envVars": [
+        {
+          "key": "NEXTAUTH_SECRET",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "NEXTAUTH_URL",
+          "value": "http://localhost:3000",
+          "required": true
+        },
+        {
+          "key": "GOOGLE_CLIENT_ID",
+          "value": "",
+          "required": false
+        },
+        {
+          "key": "GOOGLE_CLIENT_SECRET",
+          "value": "",
+          "required": false
+        },
+        {
+          "key": "GITHUB_ID",
+          "value": "",
+          "required": false
+        },
+        {
+          "key": "GITHUB_SECRET",
+          "value": "",
+          "required": false
+        }
+      ],
+      "patches": [
+        {
+          "type": "create-file",
+          "description": "{{authDescription}}",
+          "source": "lib/{{authFile}}",
+          "destination": "{{lib}}/{{authFile}}"
+        },
+        {
+          "type": "create-file",
+          "description": "Create Auth.js API routes",
+          "source": "api/auth/[...nextauth]/route.ts",
+          "destination": "app/api/auth/[...nextauth]/route.ts"
+        },
+        {
+          "type": "create-file",
+          "description": "Create Auth.js client utilities",
+          "source": "lib/auth-client.ts",
+          "destination": "{{lib}}/auth-client.ts"
+        }
+      ]
+    }
+  }
+}

package/modules/auth/better-auth/files/lib/auth-client.ts

@@ -0,0 +1,7 @@
+import { createAuthClient } from "better-auth/react";
+
+export const authClient = createAuthClient({
+  baseURL: "http://localhost:3000",
+});
+
+export const { signIn, signUp, signOut, useSession } = authClient;

package/modules/auth/better-auth/files/lib/auth.ts

@@ -0,0 +1,75 @@
+import { betterAuth } from "better-auth";
+import { sendEmail } from "./email/email-service";
+import { getVerificationEmailTemplate, getPasswordResetEmailTemplate } from "./email/email-templates";
+{{dbImport}}
+
+export const auth = betterAuth({
+{{databaseAdapter}}
+  user: {
+    additionalFields: {
+      role: {
+        type: "string",
+        defaultValue: "USER",
+        required: true,
+      },
+    },
+  },
+  emailAndPassword: {
+    enabled: true,
+    requireEmailVerification: true,
+  },
+  socialProviders: {
+    google: {
+      clientId: process.env.GOOGLE_CLIENT_ID!,
+      clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
+    },
+  },
+  emailVerification: {
+    sendVerificationEmail: async ({ user, url }) => {
+      const { html, text } = getVerificationEmailTemplate(user, url);
+      await sendEmail({
+        to: user.email,
+        subject: "Verify Your Email Address",
+        text,
+        html,
+      });
+    },
+    sendOnSignIn: true,
+  },
+  password: {
+    reset: {
+      sendResetEmail: async ({ user, url }) => {
+        const { html, text } = getPasswordResetEmailTemplate(user, url);
+        await sendEmail({
+          to: user.email,
+          subject: "Reset Your Password",
+          text,
+          html,
+        });
+      },
+    },
+  },
+  // Additional production-ready options
+  rateLimit: {
+    window: 10, // 10 seconds
+    max: 100, // max requests per window
+  },
+  account: {
+    accountLinking: {
+      enabled: true,
+      trustedProviders: ["google"],
+    },
+  },
+  session: {
+    cookieCache: {
+      enabled: true,
+    },
+    expiresIn: 60 * 60 * 24 * 7, // 7 days
+    updateAge: 60 * 60 * 24, // 1 day
+  },
+  user: {
+    changeEmail: {
+      enabled: true,
+    },
+  },
+});

package/modules/auth/better-auth/files/lib/email-service.ts

@@ -0,0 +1,34 @@
+import nodemailer from "nodemailer";
+
+// Create email transporter
+const transporter = nodemailer.createTransporter({
+  host: process.env.EMAIL_HOST,
+  port: parseInt(process.env.EMAIL_PORT || "587"),
+  secure: process.env.EMAIL_PORT === "465",
+  auth: {
+    user: process.env.EMAIL_USER,
+    pass: process.env.EMAIL_PASS,
+  },
+});
+
+// Send email function
+export const sendEmail = async ({ to, subject, text, html }: {
+  to: string;
+  subject: string;
+  text?: string;
+  html?: string;
+}) => {
+  try {
+    await transporter.sendMail({
+      from: process.env.EMAIL_FROM,
+      to,
+      subject,
+      text,
+      html,
+    });
+  } catch (error) {
+    // eslint-disable-next-line no-console
+    console.error("Email sending failed:", error);
+    throw error;
+  }
+};

package/modules/auth/better-auth/files/lib/email-templates.ts

@@ -0,0 +1,89 @@
+export const getVerificationEmailTemplate = (user: { name?: string; email: string }, url: string) => {
+  const html = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Verify Your Email</title>
+  <style>
+    body { font-family: Arial, sans-serif; line-height: 1.6; color: #000; max-width: 600px; margin: 0 auto; padding: 20px; background-color: #fff; }
+    .header { padding: 20px; text-align: center; border-bottom: 1px solid #000; }
+    .content { padding: 20px; }
+    .button { display: inline-block; background-color: #fff; color: #000; padding: 10px 20px; text-decoration: none; border: 1px solid #000; border-radius: 5px; margin: 20px 0; }
+    .footer { font-size: 12px; color: #000; text-align: center; margin-top: 20px; border-top: 1px solid #000; padding-top: 20px; }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>Verify Your Email Address</h1>
+  </div>
+  <div class="content">
+    <p>Hi ${user.name || user.email},</p>
+    <p>Thank you for signing up. Please verify your email address to complete your registration.</p>
+    <a href="${url}" class="button">Verify Email</a>
+    <p>If the button doesn't work, copy and paste this link: <a href="${url}">${url}</a></p>
+    <p>This link expires in 24 hours.</p>
+  </div>
+  <div class="footer">
+    <p>If you didn't create an account, ignore this email.</p>
+  </div>
+</body>
+</html>
+  `;
+
+  const text = `Hi ${user.name || user.email},
+
+Thank you for signing up. Please verify your email address by clicking this link: ${url}
+
+This link expires in 24 hours.
+
+If you didn't create an account, ignore this email.`;
+
+  return { html, text };
+};
+
+export const getPasswordResetEmailTemplate = (user: { name?: string; email: string }, url: string) => {
+  const html = `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Reset Your Password</title>
+  <style>
+    body { font-family: Arial, sans-serif; line-height: 1.6; color: #000; max-width: 600px; margin: 0 auto; padding: 20px; background-color: #fff; }
+    .header { padding: 20px; text-align: center; border-bottom: 1px solid #000; }
+    .content { padding: 20px; }
+    .button { display: inline-block; background-color: #fff; color: #000; padding: 10px 20px; text-decoration: none; border: 1px solid #000; border-radius: 5px; margin: 20px 0; }
+    .footer { font-size: 12px; color: #000; text-align: center; margin-top: 20px; border-top: 1px solid #000; padding-top: 20px; }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>Reset Your Password</h1>
+  </div>
+  <div class="content">
+    <p>Hi ${user.name || user.email},</p>
+    <p>You requested a password reset. Click the link below to reset your password.</p>
+    <a href="${url}" class="button">Reset Password</a>
+    <p>If the button doesn't work, copy and paste this link: <a href="${url}">${url}</a></p>
+    <p>This link expires in 1 hour.</p>
+  </div>
+  <div class="footer">
+    <p>If you didn't request this, ignore this email.</p>
+  </div>
+</body>
+</html>
+  `;
+
+  const text = `Hi ${user.name || user.email},
+
+You requested a password reset. Click this link to reset your password: ${url}
+
+This link expires in 1 hour.
+
+If you didn't request this, ignore this email.`;
+
+  return { html, text };
+};

package/modules/auth/better-auth/files/schemas/prisma-schema.prisma

@@ -0,0 +1,63 @@
+
+model User {
+    id            String    @id {{idDefault}}
+    name          String
+    email         String
+    emailVerified Boolean   @default(false)
+    image         String?
+    createdAt     DateTime  @default(now())
+    updatedAt     DateTime  @updatedAt
+    sessions      Session[]
+    accounts      Account[]
+    role          String    @default("USER")
+
+    @@unique([email])
+    @@map("user")
+}
+
+model Session {
+    id        String   @id {{idDefault}}
+    expiresAt DateTime
+    token     String   @unique
+    createdAt DateTime @default(now())
+    updatedAt DateTime @updatedAt
+    ipAddress String?
+    userAgent String?
+    userId    String {{userIdType}}
+    user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
+
+    @@index([userId])
+    @@map("session")
+}
+
+model Account {
+    id                    String    @id {{idDefault}}
+    accountId             String
+    providerId            String
+    userId                String {{userIdType}}
+    user                  User      @relation(fields: [userId], references: [id], onDelete: Cascade)
+    accessToken           String?
+    refreshToken          String?
+    idToken               String?
+    accessTokenExpiresAt  DateTime?
+    refreshTokenExpiresAt DateTime?
+    scope                 String?
+    password              String?
+    createdAt             DateTime  @default(now())
+    updatedAt             DateTime  @updatedAt
+
+    @@index([userId])
+    @@map("account")
+}
+
+model Verification {
+    id         String   @id {{idDefault}}
+    identifier String
+    value      String
+    expiresAt  DateTime
+    createdAt  DateTime @default(now())
+    updatedAt  DateTime @updatedAt
+
+    @@index([identifier])
+    @@map("verification")
+}

package/modules/auth/better-auth/module.json

@@ -0,0 +1,191 @@
+{
+  "name": "better-auth",
+  "displayName": "Better Auth",
+  "description": "Modern authentication with Better Auth",
+  "category": "auth",
+  "provider": "better-auth",
+  "supportedFrameworks": ["nextjs", "express", "react-vite"],
+  "databaseAdapters": {
+    "common": {
+      "dependencies": {},
+      "devDependencies": {}
+    },
+    "prisma-postgresql": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {
+        "@prisma/adapter-pg": "^5.0.0",
+        "pg": "^8.0.0"
+      }
+    },
+    "prisma-mongodb": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {}
+    },
+    "prisma-mysql": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {
+        "@prisma/adapter-mariadb": "^5.0.0",
+        "mysql2": "^3.0.0"
+      }
+    },
+    "prisma-sqlite": {
+      "schema": "files/schemas/prisma-schema.prisma",
+      "schemaDestination": "prisma/schema.prisma",
+      "dependencies": {
+        "@prisma/adapter-better-sqlite3": "^5.0.0",
+        "better-sqlite3": "^9.0.0"
+      }
+    }
+  },
+  "frameworkConfigs": {
+    "shared": {
+      "dependencies": {
+        "better-auth": "^1.4.12",
+        "nodemailer": "^7.0.12"
+      },
+      "devDependencies": {
+        "@types/nodemailer": "^6.4.17"
+      },
+      "envVars": [
+        {
+          "key": "BETTER_AUTH_SECRET",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "BETTER_AUTH_URL",
+          "value": "http://localhost:3000",
+          "required": true
+        },
+        {
+          "key": "EMAIL_HOST",
+          "value": "smtp.gmail.com",
+          "required": true
+        },
+        {
+          "key": "EMAIL_PORT",
+          "value": "587",
+          "required": true
+        },
+        {
+          "key": "EMAIL_USER",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "EMAIL_PASS",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "EMAIL_FROM",
+          "value": "noreply@yourapp.com",
+          "required": true
+        }
+      ]
+    },
+    "nextjs": {
+      "patches": [
+        {
+          "type": "create-file",
+          "description": "{{authDescription}}",
+          "source": "lib/{{authFile}}",
+          "destination": "{{lib}}/{{authFile}}"
+        },
+        {
+          "type": "create-file",
+          "description": "Create Better Auth API routes",
+          "source": "api/auth/[...all]/route.ts",
+          "destination": "app/api/auth/[...all]/route.ts"
+        },
+        {
+          "type": "create-file",
+          "description": "Create Better Auth client for React",
+          "source": "lib/auth-client.ts",
+          "destination": "{{lib}}/auth-client.ts"
+        },
+        {
+          "type": "create-file",
+          "description": "Create email service for sending emails",
+          "source": "lib/email-service.ts",
+          "destination": "{{lib}}/email/email-service.ts"
+        },
+        {
+          "type": "create-file",
+          "description": "Create email templates",
+          "source": "lib/email-templates.ts",
+          "destination": "{{lib}}/email/email-templates.ts"
+        }
+      ]
+    },
+    "express": {
+      "patches": [
+        {
+          "type": "create-file",
+          "description": "{{authDescription}}",
+          "source": "lib/{{authFile}}",
+          "destination": "{{lib}}/{{authFile}}"
+        },
+        {
+          "type": "patch-file",
+          "description": "Add Better Auth routes to Express app",
+          "file": "src/app.ts",
+          "operations": [
+            {
+              "type": "add-import",
+              "imports": [
+                "import { auth } from \"@/lib/auth\";",
+                "import { toNodeHandler } from \"better-auth/node\";"
+              ]
+            },
+            {
+              "type": "add-code",
+              "after": "// routes",
+              "code": "\napp.all(\"/api/auth/*splat\", toNodeHandler(auth));"
+            }
+          ]
+        },
+        {
+          "type": "create-file",
+          "description": "Create email service for sending emails",
+          "source": "lib/email-service.ts",
+          "destination": "{{lib}}/email/email-service.ts"
+        },
+        {
+          "type": "create-file",
+          "description": "Create email templates",
+          "source": "lib/email-templates.ts",
+          "destination": "{{lib}}/email/email-templates.ts"
+        }
+      ]
+    },
+    "react-vite": {
+      "dependencies": {
+        "better-auth": "^1.4.12"
+      },
+      "envVars": [
+        {
+          "key": "BETTER_AUTH_SECRET",
+          "value": "",
+          "required": true
+        },
+        {
+          "key": "BETTER_AUTH_URL",
+          "value": "http://localhost:3000",
+          "required": true
+        }
+      ],
+      "patches": [
+        {
+          "type": "create-file",
+          "description": "Create Better Auth client for React",
+          "source": "lib/auth-client.ts",
+          "destination": "{{lib}}/auth-client.ts"
+        }
+      ]
+    }
+  }
+}

package/modules/database/mongoose/files/lib/db.ts

@@ -0,0 +1,68 @@
+import mongoose from "mongoose";
+import { ServerApiVersion } from "mongodb";
+
+type MongooseCache = {
+  conn: typeof mongoose | null;
+  promise: Promise<typeof mongoose> | null;
+};
+
+const globalWithMongoose = globalThis as unknown as {
+  mongoose: MongooseCache;
+};
+
+// Initialize the cache if not already present
+const cached = globalWithMongoose.mongoose || {
+  conn: null,
+  promise: null,
+};
+
+if (!globalWithMongoose.mongoose) {
+  globalWithMongoose.mongoose = cached;
+}
+
+async function dbConnect(): Promise<typeof mongoose> {
+  if (cached.conn) {
+    return cached.conn;
+  }
+
+  const uri = process.env.DATABASE_URL as string;
+
+  if (!cached.promise) {
+    const opts = {
+      bufferCommands: false,
+      connectTimeoutMS: 10000,
+      serverSelectionTimeoutMS: 10000,
+      serverApi: {
+        version: ServerApiVersion.v1,
+        strict: true,
+        deprecationErrors: true,
+      },
+    };
+
+    cached.promise = mongoose
+      .connect(uri, opts)
+      .then(async (mongooseInstance: typeof mongoose) => {
+        console.info("MongoDB connected successfully");
+        if (mongoose.connection.db) {
+          await mongoose.connection.db.admin().command({ ping: 1 });
+          console.info("Pinged your deployment. You successfully connected to MongoDB!");
+        }
+        return mongooseInstance;
+      })
+      .catch((error: Error) => {
+        console.error("MongoDB connection failed", { error });
+        throw error;
+      });
+  }
+
+  try {
+    cached.conn = await cached.promise;
+  } catch (error) {
+    cached.promise = null;
+    throw error;
+  }
+
+  return cached.conn;
+}
+
+export default dbConnect;

package/modules/database/mongoose/files/models/User.ts

@@ -0,0 +1,34 @@
+import mongoose, { Document, Schema } from "mongoose";
+
+export interface IUser extends Document {
+  name: string;
+  email: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+const UserSchema: Schema = new Schema(
+  {
+    name: {
+      type: String,
+      required: true,
+      trim: true,
+    },
+    email: {
+      type: String,
+      required: true,
+      unique: true,
+      lowercase: true,
+      trim: true,
+    },
+  },
+  {
+    timestamps: true,
+  },
+);
+
+// Add indexes for better performance
+UserSchema.index({ email: 1 });
+UserSchema.index({ createdAt: -1 });
+
+export default mongoose.models.User || mongoose.model<IUser>("User", UserSchema);