dolphin-server-modules 2.11.1 → 2.11.2

package/dist/templates/index.js

@@ -2,111 +2,288 @@ export const TEMPLATES = {
     app: `import { createDolphinServer } from 'dolphin-server-modules/server';
 import { createMongooseAdapter } from 'dolphin-server-modules/adapters/mongoose';
 import { createDolphinAuthController } from 'dolphin-server-modules/auth-controller';
+import { connectDB } from './config/db.js';
+import { User, RefreshToken } from './models/User.js';
 
 const app = createDolphinServer();
 
-// DB Connection & Adapter
-const dbAdapter = createMongooseAdapter(process.env.MONGO_URI || 'mongodb://localhost:27017/dolphin_db');
+// Global Error Handler — server crash बाट बचाउँछ
+app.use(async (ctx, next) => {
+  try { if (next) await next(); }
+  catch (error) {
+    console.error('🔥 ERROR:', error.message);
+    ctx.status(500).json({ success: false, message: 'Internal Server Error' });
+  }
+});
+
+// DB connect
+connectDB(process.env.MONGO_URI || 'mongodb://localhost:27017/dolphin_db');
 
-// Auth Setup
+// Mongoose Adapter
+const db = createMongooseAdapter({ User, RefreshToken });
+
+// Auth
 const auth = createDolphinAuthController({
-    adapter: dbAdapter,
-    jwtSecret: process.env.JWT_SECRET || 'dolphin_secret'
+  adapter: db,
+  jwtSecret: process.env.JWT_SECRET || 'change_in_production',
 });
 
 app.post('/api/auth/register', auth.register);
-app.post('/api/auth/login', auth.login);
+app.post('/api/auth/login',    auth.login);
+app.post('/api/auth/refresh',  auth.refresh);
+app.post('/api/auth/logout',   auth.middleware(), auth.logout);
+
+app.get('/health', (ctx) => ({ status: 'ok', ts: new Date().toISOString() }));
 
-app.listen(3000, () => console.log('🐬 Dolphin Production Server is swimming on port 3000'));
+const PORT = parseInt(process.env.PORT || '3000');
+app.listen(PORT, () => console.log(\`🐬 Dolphin Server swimming on port \${PORT}\`));
 `,
     mongoose: `import mongoose from 'mongoose';
+
 export const connectDB = async (uri) => {
-    try {
-        await mongoose.connect(uri);
-        console.log('✅ MongoDB Connected');
-    } catch (e) {
-        console.error('❌ DB Error:', e);
-    }
-};`,
+  try {
+    await mongoose.connect(uri, { serverSelectionTimeoutMS: 5000 });
+    console.log('✅ MongoDB Connected:', mongoose.connection.host);
+  } catch (e) {
+    console.error('❌ MongoDB Error:', e.message);
+    process.exit(1);
+  }
+};
+
+mongoose.connection.on('disconnected', () => console.warn('⚠️  MongoDB disconnected'));
+mongoose.connection.on('error', (err) => console.error('❌ MongoDB:', err.message));
+`,
     sequelize: `import { Sequelize } from 'sequelize';
-export const sequelize = new Sequelize(process.env.DB_NAME, process.env.DB_USER, process.env.DB_PASS, {
-    host: process.env.DB_HOST || 'localhost',
-    dialect: 'mysql',
-    logging: false
-});
+
+export const sequelize = new Sequelize(
+  process.env.DB_NAME || 'dolphin_db',
+  process.env.DB_USER || 'root',
+  process.env.DB_PASS || '',
+  {
+    host:    process.env.DB_HOST    || 'localhost',
+    dialect: process.env.DB_DIALECT || 'mysql',
+    logging: process.env.NODE_ENV === 'development' ? console.log : false,
+    pool: { max: 10, min: 0, acquire: 30000, idle: 10000 },
+  }
+);
 
 export const connectDB = async () => {
-    try {
-        await sequelize.authenticate();
-        console.log('✅ MySQL/Sequelize Connected');
-    } catch (e) {
-        console.error('❌ DB Error:', e);
-    }
-};`,
+  try {
+    await sequelize.authenticate();
+    console.log('✅ Sequelize Connected:', process.env.DB_HOST || 'localhost');
+    await sequelize.sync({ alter: process.env.NODE_ENV === 'development' });
+  } catch (e) {
+    console.error('❌ Sequelize Error:', e.message); process.exit(1);
+  }
+};
+`,
+    redis: `import { createClient } from 'redis';
+
+const REDIS_URL = process.env.REDIS_URL || 'redis://localhost:6379';
+
+export const redisClient = createClient({ url: REDIS_URL });
+redisClient.on('error',       (err) => console.error('❌ Redis:', err.message));
+redisClient.on('connect',     ()    => console.log('✅ Redis Connected:', REDIS_URL));
+redisClient.on('reconnecting',()    => console.warn('⚠️  Redis reconnecting...'));
+
+export const connectRedis = async () => {
+  await redisClient.connect().catch(e => { console.error('❌ Redis:', e.message); process.exit(1); });
+};
+
+export const cache = {
+  set:    (key, value, ttl = 3600) => redisClient.setEx(key, ttl, JSON.stringify(value)),
+  get:    async (key)  => { const v = await redisClient.get(key); return v ? JSON.parse(v) : null; },
+  del:    (key)        => redisClient.del(key),
+  exists: async (key)  => (await redisClient.exists(key)) === 1,
+};
+`,
     auth: `import { createDolphinAuthController } from 'dolphin-server-modules/auth-controller';
-import { User } from '../models/User.js';
+import { db } from './adapter.js'; // तपाईंको createMongooseAdapter instance
 
-// This is a production-ready Auth Controller using Dolphin Modules
 export const auth = createDolphinAuthController({
-    secret: process.env.JWT_SECRET || 'your_ultra_secret_key',
-    model: User, // In a real app, you'd pass a Database Adapter
-    issuer: 'DolphinApp'
+  adapter: db,
+  jwtSecret: process.env.JWT_SECRET || 'change_in_production',
+  accessTokenExpiry:  '15m',
+  refreshTokenExpiry: '7d',
 });
 
-export const register = auth.register;
-export const login = auth.login;
+export const { register, login, refresh, logout, middleware } = auth;
 `,
     crud: (name) => `import { createCrudController } from 'dolphin-server-modules/crud';
-import { ${name} } from '../models/${name}.js';
+import { db } from '../config/adapter.js';
 
-// Fully automated CRUD controller for ${name}
-export const ${name.toLowerCase()}Controller = createCrudController(
-    ${name}, // Mongoose Model
-    '${name.toLowerCase()}s', // Collection Name
-    { softDelete: true, enforceOwnership: true }
-);
+const ctrl = createCrudController(db, '${name}', {
+  softDelete: true,
+  enforceOwnership: false,
+});
 
-export const getAll = ${name.toLowerCase()}Controller.getAll;
-export const getOne = ${name.toLowerCase()}Controller.getOne;
-export const create = ${name.toLowerCase()}Controller.create;
-export const update = ${name.toLowerCase()}Controller.update;
-export const remove = ${name.toLowerCase()}Controller.delete;
+export const { getAll, getOne, create, update } = ctrl;
+export const remove = ctrl.delete;
 `,
     crudModel: (name) => `import mongoose from 'mongoose';
 
-const ${name.toLowerCase()}Schema = new mongoose.Schema({
-    userId: { type: mongoose.Schema.Types.ObjectId, ref: 'User', required: true },
-    title: { type: String, required: true },
-    description: { type: String },
-    status: { type: String, enum: ['pending', 'completed'], default: 'pending' }
-}, { timestamps: true });
+const ${name.toLowerCase()}Schema = new mongoose.Schema(
+  {
+    title:       { type: String, required: true, trim: true },
+    description: { type: String, default: '' },
+    status:      { type: String, enum: ['active','inactive'], default: 'active' },
+    userId:      { type: mongoose.Schema.Types.ObjectId, ref: 'User' },
+  },
+  { timestamps: true, versionKey: false }
+);
+
+${name.toLowerCase()}Schema.index({ userId: 1, status: 1 });
+${name.toLowerCase()}Schema.index({ createdAt: -1 });
 
 export const ${name} = mongoose.model('${name}', ${name.toLowerCase()}Schema);
 `,
     authModel: `import mongoose from 'mongoose';
 
-const userSchema = new mongoose.Schema({
-    email: { type: String, required: true, unique: true },
-    password: { type: String, required: true },
-    role: { type: String, default: 'user' },
-    twoFactorEnabled: { type: Boolean, default: false },
-    twoFactorSecret: { type: String, default: null },
-    pending2FASecret: { type: String, default: null },
-    recoveryCodes: { type: [String], default: [] }
-}, { timestamps: true });
-
+const userSchema = new mongoose.Schema(
+  {
+    email:           { type: String, required: true, unique: true, lowercase: true, trim: true },
+    password:        { type: String, required: true },
+    role:            { type: String, enum: ['user','admin','moderator'], default: 'user' },
+    twoFactorEnabled:  { type: Boolean, default: false },
+    twoFactorSecret:   { type: String, default: null },
+    pending2FASecret:  { type: String, default: null },
+    recoveryCodes:     { type: [String], default: [] },
+    isActive:          { type: Boolean, default: true },
+    lastLoginAt:       { type: Date, default: null },
+  },
+  { timestamps: true, versionKey: false }
+);
+userSchema.index({ email: 1 });
 export const User = mongoose.model('User', userSchema);
 
-const refreshTokenSchema = new mongoose.Schema({
-    token: { type: String, required: true, unique: true },
-    userId: { type: mongoose.Schema.Types.ObjectId, ref: 'User', required: true },
-    expiresAt: { type: Date, required: true },
-    twoFactorVerified: { type: Boolean, default: false }
-}, { timestamps: true });
+const refreshTokenSchema = new mongoose.Schema(
+  {
+    token:              { type: String, required: true, unique: true, index: true },
+    userId:             { type: mongoose.Schema.Types.ObjectId, ref: 'User', required: true },
+    expiresAt:          { type: Date, required: true },
+    twoFactorVerified:  { type: Boolean, default: false },
+    userAgent:          { type: String, default: null },
+    ip:                 { type: String, default: null },
+  },
+  { timestamps: true, versionKey: false }
+);
+refreshTokenSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
+export const RefreshToken = mongoose.model('RefreshToken', refreshTokenSchema);
+`,
+    model: (name) => `import mongoose from 'mongoose';
 
-refreshTokenSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 }); // Auto-delete expired tokens
+const ${name.toLowerCase()}Schema = new mongoose.Schema(
+  {
+    name:        { type: String, required: true, trim: true, maxlength: 200 },
+    description: { type: String, default: '', maxlength: 2000 },
+    isActive:    { type: Boolean, default: true },
+  },
+  {
+    timestamps: true,
+    versionKey: false,
+    toJSON: {
+      transform: (_, ret) => { ret.id = ret._id?.toString(); delete ret._id; return ret; }
+    }
+  }
+);
 
-export const RefreshToken = mongoose.model('RefreshToken', refreshTokenSchema);
-`
+${name.toLowerCase()}Schema.index({ name: 1 });
+${name.toLowerCase()}Schema.index({ isActive: 1, createdAt: -1 });
+
+export const ${name} = mongoose.model('${name}', ${name.toLowerCase()}Schema);
+`,
+    middleware: (name) => `/**
+ * ${name} Middleware
+ * Usage: app.use(${name.toLowerCase()}Middleware)  वा  app.get('/route', ${name.toLowerCase()}Middleware, handler)
+ */
+export const ${name.toLowerCase()}Middleware = async (ctx, next) => {
+  // TODO: तपाईंको logic यहाँ लेख्नुहोस्
+  console.log(\`[${name}] \${ctx.req.method} \${ctx.req.url}\`);
+  if (next) await next();
+};
+`,
+    route: (name) => `import { createDolphinRouter } from 'dolphin-server-modules/router';
+
+const router = createDolphinRouter();
+const base = '/${name.toLowerCase()}s';
+
+router.get(base, async (ctx) => {
+  return { success: true, data: [], message: '${name} list' };
+});
+
+router.get(\`\${base}/:id\`, async (ctx) => {
+  return { success: true, data: { id: ctx.params.id } };
+});
+
+router.post(base, async (ctx) => {
+  return ctx.status(201).json({ success: true, data: ctx.body });
+});
+
+router.put(\`\${base}/:id\`, async (ctx) => {
+  return { success: true, data: { id: ctx.params.id, ...ctx.body } };
+});
+
+router.delete(\`\${base}/:id\`, async (ctx) => {
+  return { success: true, data: { id: ctx.params.id, deleted: true } };
+});
+
+export const ${name.toLowerCase()}Router = router;
+`,
+    service: (name) => `/**
+ * ${name}Service — Business logic layer
+ * Controller र Database को बीचको layer
+ */
+export class ${name}Service {
+
+  static async getAll(filter = {}) {
+    // TODO: DB query
+    return [];
+  }
+
+  static async getById(id) {
+    // TODO: DB findById
+    return null;
+  }
+
+  static async create(data) {
+    // TODO: DB create
+    return { id: Date.now().toString(), ...data, createdAt: new Date() };
+  }
+
+  static async update(id, data) {
+    // TODO: DB update
+    return { id, ...data, updatedAt: new Date() };
+  }
+
+  static async delete(id) {
+    // TODO: DB delete
+    return { id, deleted: true };
+  }
+}
+`,
+    env: `# 🐬 Dolphin Framework — Environment Variables
+# ⚠️  यो file .gitignore मा राख्नुहोस् — production मा NEVER commit!
+
+NODE_ENV=development
+PORT=3000
+
+# MongoDB
+MONGO_URI=mongodb://localhost:27017/dolphin_db
+
+# JWT Secret (कम्तीमा 32 chars)
+JWT_SECRET=change_this_ultra_secret_key_in_production_32chars
+
+# Redis (optional — realtime scaling)
+# REDIS_URL=redis://localhost:6379
+
+# AI Keys (dolphin chat/generate को लागि)
+# GEMINI_API_KEY=your_key_here
+# GROQ_API_KEY=your_key_here
+# OPENAI_API_KEY=your_key_here
+
+# Local Ollama (optional)
+# USE_OLLAMA=true
+# OLLAMA_MODEL=gemma3:latest
+`,
 };
 //# sourceMappingURL=index.js.map

package/dist/templates/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACrB,GAAG,EAAE;;;;;;;;;;;;;;;;;;;CAmBR;IACG,QAAQ,EAAE;;;;;;;;GAQX;IACC,SAAS,EAAE;;;;;;;;;;;;;;GAcZ;IACC,IAAI,EAAE;;;;;;;;;;;;CAYT;IACG,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;WACjB,IAAI,sBAAsB,IAAI;;yCAEA,IAAI;eAC9B,IAAI,CAAC,WAAW,EAAE;MAC3B,IAAI;OACH,IAAI,CAAC,WAAW,EAAE;;;;wBAID,IAAI,CAAC,WAAW,EAAE;wBAClB,IAAI,CAAC,WAAW,EAAE;wBAClB,IAAI,CAAC,WAAW,EAAE;wBAClB,IAAI,CAAC,WAAW,EAAE;wBAClB,IAAI,CAAC,WAAW,EAAE;CACzC;IACG,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;QAEzB,IAAI,CAAC,WAAW,EAAE;;;;;;;eAOX,IAAI,sBAAsB,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE;CACpE;IACG,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;CAwBd;CACA,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IAErB,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCR;IAEG,QAAQ,EAAE;;;;;;;;;;;;;;CAcb;IAEG,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBd;IAEG,KAAK,EAAE;;;;;;;;;;;;;;;;;;;CAmBV;IAEG,IAAI,EAAE;;;;;;;;;;;CAWT;IAEG,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;;yCAGa,IAAI;;;;;;;CAO5C;IAEG,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;QAEzB,IAAI,CAAC,WAAW,EAAE;;;;;;;;;;EAUxB,IAAI,CAAC,WAAW,EAAE;EAClB,IAAI,CAAC,WAAW,EAAE;;eAEL,IAAI,sBAAsB,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE;CACpE;IAEG,SAAS,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCd;IAEG,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;QAErB,IAAI,CAAC,WAAW,EAAE;;;;;;;;;;;;;;;EAexB,IAAI,CAAC,WAAW,EAAE;EAClB,IAAI,CAAC,WAAW,EAAE;;eAEL,IAAI,sBAAsB,IAAI,MAAM,IAAI,CAAC,WAAW,EAAE;CACpE;IAEG,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;KAC7B,IAAI;oBACW,IAAI,CAAC,WAAW,EAAE,sCAAsC,IAAI,CAAC,WAAW,EAAE;;eAE/E,IAAI,CAAC,WAAW,EAAE;;mBAEd,IAAI;;;CAGtB;IAEG,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;;;iBAGZ,IAAI,CAAC,WAAW,EAAE;;;gDAGa,IAAI;;;;;;;;;;;;;;;;;;;eAmBrC,IAAI,CAAC,WAAW,EAAE;CAChC;IAEG,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC;KAC1B,IAAI;;;eAGM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2BlB;IAEG,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBR;CACA,CAAC"}

package/dist/test-2fa-real.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-2fa-real.js

@@ -0,0 +1,105 @@
+// test-2fa-real.ts
+import { createAuth } from "./auth/auth";
+import crypto from "node:crypto";
+import argon2 from "argon2";
+// Helper to simulate a TOTP app (reusing logic from auth.ts)
+const BASE32_CHARS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
+const base32Decode = (str) => {
+    str = str.replace(/=/g, '').toUpperCase();
+    let bits = 0, value = 0;
+    const bytes = [];
+    for (let i = 0; i < str.length; i++) {
+        const idx = BASE32_CHARS.indexOf(str[i]);
+        value = (value << 5) | idx;
+        bits += 5;
+        if (bits >= 8) {
+            bytes.push((value >>> (bits - 8)) & 255);
+            bits -= 8;
+        }
+    }
+    return Buffer.from(bytes);
+};
+const generateTOTP = (secretBase32, timestamp = Date.now()) => {
+    const counter = Math.floor(timestamp / 30000);
+    const counterBuf = Buffer.alloc(8);
+    counterBuf.writeBigInt64BE(BigInt(counter), 0);
+    const secret = base32Decode(secretBase32);
+    const hmac = crypto.createHmac('sha1', secret);
+    hmac.update(counterBuf);
+    const hash = hmac.digest();
+    const offset = hash[hash.length - 1] & 0xf;
+    const code = (hash.readUInt32BE(offset) & 0x7fffffff) % 1000000;
+    return code.toString().padStart(6, '0');
+};
+async function run2FATest() {
+    console.log("🔐 Starting 'Real' 2FA Flow Test...\n");
+    const auth = createAuth({ secret: 'test-secret' });
+    // 1. Mock DB state
+    let mockUser = {
+        id: "user123",
+        email: "test@example.com",
+        password: await argon2.hash("password123"),
+        twoFactorEnabled: false,
+        twoFactorSecret: null,
+        pending2FASecret: null,
+        recoveryCodes: []
+    };
+    const db = {
+        findUserById: async () => mockUser,
+        findUserByEmail: async () => mockUser,
+        updateUser: async (id, data) => {
+            mockUser = { ...mockUser, ...data };
+            return mockUser;
+        },
+        saveRefreshToken: async () => { },
+        findRefreshToken: async () => null,
+        deleteRefreshToken: async () => { }
+    };
+    // --- STEP 1: Enable 2FA ---
+    console.log("Step 1: Enabling 2FA (Generating Secret)...");
+    const setup = await auth.enable2FA(db, mockUser.id);
+    console.log("✅ Secret Generated:", setup.secret);
+    console.log("✅ URI:", setup.uri);
+    // --- STEP 2: Verify 2FA ---
+    console.log("\nStep 2: Verifying 2FA with TOTP Token...");
+    const realToken = generateTOTP(setup.secret);
+    console.log("📱 Simulated App Token:", realToken);
+    const verifyResult = await auth.verify2FA(db, mockUser.id, realToken);
+    console.log("✅ 2FA Verified! Recovery Codes:", verifyResult.recoveryCodes);
+    console.log("✅ User 2FA Status:", mockUser.twoFactorEnabled ? "ENABLED" : "FAILED");
+    // --- STEP 3: Login without TOTP (Should fail) ---
+    console.log("\nStep 3: Attempting Login WITHOUT TOTP...");
+    try {
+        await auth.login(db, { email: mockUser.email, password: "password123" });
+        console.log("❌ FAILED: Login succeeded without TOTP!");
+    }
+    catch (err) {
+        console.log("✅ SUCCESS: Login denied as expected:", err.message);
+    }
+    // --- STEP 4: Login with correct TOTP ---
+    console.log("\nStep 4: Attempting Login WITH correct TOTP...");
+    const loginToken = generateTOTP(setup.secret);
+    const loginResult = await auth.login(db, { email: mockUser.email, password: "password123", totp: loginToken });
+    console.log("✅ SUCCESS: Logged in! Access Token length:", loginResult.accessToken.length);
+    // --- STEP 5: Test Recovery Codes ---
+    console.log("\nStep 5: Testing Recovery Code Login...");
+    const backupCode = verifyResult.recoveryCodes[0];
+    const recoveryResult = await auth.login(db, {
+        email: mockUser.email,
+        password: "password123",
+        recovery: backupCode
+    });
+    console.log("✅ SUCCESS: Logged in using recovery code!");
+    console.log("✅ Remaining recovery codes count:", mockUser.recoveryCodes.length);
+    // --- STEP 6: Disable 2FA ---
+    console.log("\nStep 6: Disabling 2FA...");
+    const disableToken = generateTOTP(setup.secret);
+    await auth.disable2FA(db, mockUser.id, disableToken);
+    console.log("✅ SUCCESS: 2FA Disabled. Status:", mockUser.twoFactorEnabled ? "ENABLED (Error)" : "DISABLED");
+    console.log("\n🎊 ALL 2FA FLOWS COMPLETED SUCCESSFULLY! 🎊");
+}
+run2FATest().catch(err => {
+    console.error("❌ TEST FAILED:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=test-2fa-real.js.map

package/dist/test-2fa-real.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-2fa-real.js","sourceRoot":"","sources":["../src/test-2fa-real.ts"],"names":[],"mappings":"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"}

package/dist/test-dolphin.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/test-dolphin.js

@@ -0,0 +1,98 @@
+// test-dolphin.ts
+import { createDolphinServer } from "./server/server";
+import { createDolphinController } from "./controller/controller";
+import { createDolphinAuthController } from "./authController/authController";
+// Mock Database Connection (Replacing ./config.js)
+const dbConnect = async () => {
+    console.log("🛠️ Mock Database Connected");
+};
+// Mock Database Interface (Replacing ./auth/model.js)
+const db = {
+    createUser: async (data) => ({ id: "123", ...data }),
+    findUserByEmail: async (email) => ({ id: "123", email, password: "hashed_password", role: "admin" }),
+    findUserById: async (id) => ({ id, email: "user@example.com", role: "admin" }),
+    updateUser: async (id, data) => ({ id, ...data }),
+    saveRefreshToken: async () => { },
+    findRefreshToken: async () => ({ userId: "123", expiresAt: new Date(Date.now() + 10000) }),
+    deleteRefreshToken: async () => { },
+    // For CRUD
+    read: async () => [{ id: "123", name: "John Doe" }],
+    create: async (data) => ({ id: "456", ...data }),
+    update: async (id, data) => ({ id, ...data }),
+    delete: async (id) => ({ id })
+};
+async function main() {
+    const app = createDolphinServer();
+    await dbConnect();
+    // ============ SETUP AUTH ============
+    const auth = createDolphinAuthController(db, {
+        secret: process.env.JWT_SECRET || 'my-super-secret-key',
+        cookieMaxAge: 7 * 24 * 60 * 60 * 1000, // 7 days
+        issuer: 'MyApp'
+    });
+    // ============ CRUD CONTROLLER ============
+    const userController = createDolphinController(db, "User");
+    // ============ PUBLIC ROUTES (No Auth) ============
+    app.post("/auth/register", async (ctx) => {
+        const result = await auth.register(ctx);
+        return result; // Using the new auto-reply feature!
+    });
+    app.post("/auth/login", async (ctx) => {
+        return await auth.login(ctx);
+    });
+    app.post("/auth/refresh", async (ctx) => {
+        return await auth.refresh(ctx);
+    });
+    // ============ PROTECTED ROUTES (Auth Required) ============
+    // ✅ NOW SUPPORTED: Multiple handlers (middleware + final handler)
+    app.get("/auth/me", auth.requireAuth, async (ctx) => {
+        const result = await auth.me(ctx);
+        return result;
+    });
+    app.post("/auth/logout", auth.requireAuth, async (ctx) => {
+        return await auth.logout(ctx);
+    });
+    // ============ PROTECTED CRUD ROUTES (Auth Required) ============
+    app.get("/user", auth.requireAuth, async (ctx) => {
+        const users = await userController.list(ctx, ctx.req.user?.id);
+        return users.map((user) => auth.sanitize(user));
+    });
+    app.post("/user", auth.requireAuth, async (ctx) => {
+        const user = await userController.create(ctx, ctx.req.user?.id);
+        return auth.sanitize(user);
+    });
+    // ============ ADMIN ROUTES ============
+    app.get("/admin/users", auth.requireAdmin, async (ctx) => {
+        const users = await userController.list(ctx);
+        return users.map(auth.sanitize);
+    });
+    // ============ START SERVER ============
+    const PORT = 3000;
+    app.listen(PORT, () => {
+        console.log(`
+  🚀 Dolphin Server running on port ${PORT}
+  
+  📋 Available Routes:
+  
+  🔓 PUBLIC ROUTES:
+  ┌─────────────────────────────────────────────┐
+  │ POST   /auth/register                       │
+  │ POST   /auth/login                          │
+  │ POST   /auth/refresh                        │
+  ├─────────────────────────────────────────────┤
+  │ 🔒 PROTECTED ROUTES (Auth Required):        │
+  │ GET    /auth/me                             │
+  │ POST   /auth/logout                         │
+  ├─────────────────────────────────────────────┤
+  │ 👤 USER CRUD (Protected):                   │
+  │ GET    /user                                │
+  │ POST   /user                                │
+  ├─────────────────────────────────────────────┤
+  │ 👑 ADMIN ROUTES:                            │
+  │ GET    /admin/users                         │
+  └─────────────────────────────────────────────┘
+    `);
+    });
+}
+main().catch(console.error);
+//# sourceMappingURL=test-dolphin.js.map

package/dist/test-dolphin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-dolphin.js","sourceRoot":"","sources":["../src/test-dolphin.ts"],"names":[],"mappings":"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"}

package/dist/utils/ctx.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Dolphin Universal Context Builder
+ *
+ * Dolphin modules (auth-controller, crud, router) ले ctx object use गर्छन्।
+ * यो helper ले कुनै पनि framework को req/res बाट ctx बनाउँछ।
+ *
+ * ─── Express ──────────────────────────────────────────────────────
+ *   import { createCtx } from 'dolphin-server-modules/utils/ctx';
+ *   app.post('/login', (req, res) => auth.login(createCtx(req, res)));
+ *
+ * ─── Fastify ──────────────────────────────────────────────────────
+ *   fastify.post('/login', (req, reply) =>
+ *     auth.login(createCtx(req.raw, reply.raw, req.body, req.params, req.query))
+ *   );
+ *
+ * ─── Next.js API Route ────────────────────────────────────────────
+ *   export default async function handler(req, res) {
+ *     return auth.login(createCtx(req, res));
+ *   }
+ *
+ * ─── Hono ─────────────────────────────────────────────────────────
+ *   app.post('/login', async (c) => {
+ *     const ctx = createCtx(c.req.raw, c.res, await c.req.json(), c.req.param());
+ *     return auth.login(ctx);
+ *   });
+ */
+export interface DolphinCtx {
+    req: any;
+    res: any;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    body: any;
+    state: Record<string, any>;
+    json: (data: any, status?: number) => DolphinCtx;
+    text: (data: any, status?: number) => DolphinCtx;
+    html: (data: any, status?: number) => DolphinCtx;
+    status: (code: number) => DolphinCtx;
+    setHeader: (name: string, value: string) => DolphinCtx;
+    getHeader: (name: string) => string | undefined;
+}
+/**
+ * कुनै पनि framework को req/res बाट Dolphin ctx बनाउने
+ * @param req  - Express req / Fastify request.raw / Next.js req / Node.js IncomingMessage
+ * @param res  - Express res / Fastify reply.raw / Next.js res / Node.js ServerResponse
+ * @param body - parsed body (req.body वा await req.json())
+ * @param params - route params ({ id: '123' })
+ * @param query  - query string params
+ */
+export declare function createCtx(req: any, res: any, body?: any, params?: Record<string, string>, query?: Record<string, string>): DolphinCtx;
+export default createCtx;