helix-lang 11.0.0

package/dist/types.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Helix Language - Type Definitions and System Prompts
+ * v11.0 - With Deep Research Capabilities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMPILER_SYSTEM_PROMPT = exports.ARCHITECT_SYSTEM_PROMPT = exports.RESEARCHER_SYSTEM_PROMPT = exports.HELIX_SYNTAX_GUIDE = void 0;
+// ============================================================================
+// HELIX SYNTAX GUIDE
+// ============================================================================
+exports.HELIX_SYNTAX_GUIDE = `
+HELIX SYNTAX RULES:
+1. 'strand Name {}' defines a stateful entity.
+2. 'field name: Type' defines data structure. Types: String, Int, Float, Boolean, DateTime.
+3. 'relation name: OtherStrand' defines a belongs-to relationship (foreign key).
+4. 'relation name: OtherStrand[]' defines a has-many relationship.
+5. 'strategy Name: Action -> Fallback' defines error handling.
+6. 'view Name {}' defines UI layout.
+7. 'theme: ThemeName' in a view selects the visual theme.
+   Available themes: Glassmorphism (default), Professional, Minimal, Vibrant.
+   Example: theme: Professional
+
+EXAMPLE:
+strand Customer {
+  field name: String
+  field email: String
+  relation orders: Order[]
+}
+
+strand Order {
+  field total: Float
+  field status: String
+  relation customer: Customer
+}
+
+view OrderBoard {
+  list: Order.all()
+  theme: Professional
+}
+`;
+// ============================================================================
+// RESEARCHER SYSTEM PROMPT
+// ============================================================================
+exports.RESEARCHER_SYSTEM_PROMPT = `
+You are the Helix Lead Researcher.
+Goal: Analyze the requested domain deeply.
+Output: A structured Markdown report containing:
+- Key Data Entities & Fields (e.g., specific schemas).
+- Critical Features (e.g., standard industry requirements).
+- "Gotchas" & Constraints (e.g., specific regulatory or physical limits).
+- User Interface trends for this domain.
+DO NOT write code. Write a System Analysis Report.
+`;
+// ============================================================================
+// ARCHITECT SYSTEM PROMPT
+// ============================================================================
+exports.ARCHITECT_SYSTEM_PROMPT = `
+You are the Helix Architect.
+Goal: Convert vague user requests into valid 'Helix' syntax blueprints.
+Output: ONLY the .helix code. No markdown fences.
+
+When Context is provided:
+- Use the research to inform the fields and logic of the Helix Blueprint.
+- If the research mentions specific constraints (e.g., service intervals, regulatory limits), include them in the 'strand'.
+- Reference specific data models and entities from the research.
+
+${exports.HELIX_SYNTAX_GUIDE}
+`;
+// ============================================================================
+// COMPILER SYSTEM PROMPT
+// ============================================================================
+exports.COMPILER_SYSTEM_PROMPT = `
+You are the Helix Compiler.
+Goal: Transpile 'Helix' blueprints into a single React (Next.js) + TypeScript + Tailwind file.
+Rules:
+- Implement 'strand' as React Hooks (swr/tanstack).
+- Implement 'strategy' as explicit try/catch/retry logic.
+- Implement 'view' as Tailwind JSX.
+Output: ONLY the .tsx code. No markdown fences.
+`;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAElE,QAAA,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6BjC,CAAC;AAEF,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAElE,QAAA,wBAAwB,GAAG;;;;;;;;;CASvC,CAAC;AAEF,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAElE,QAAA,uBAAuB,GAAG;;;;;;;;;;EAUrC,0BAAkB;CACnB,CAAC;AAEF,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAElE,QAAA,sBAAsB,GAAG;;;;;;;;CAQrC,CAAC"}

package/dist/utils/constitutional-validator.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Constitutional Helix - Validation & Compliance System
+ * Enforces UI Constitution (Deep Void) and AI Constitution (AI-First Agent)
+ */
+export declare const UI_CONSTITUTION: {
+    readonly background: {
+        readonly gradient: readonly ["#0f0c29", "#000000"];
+        readonly law: "All core views must use Deep Void gradient";
+    };
+    readonly glassmorphism: {
+        readonly blur: "16px";
+        readonly transparency: "rgba(255, 255, 255, 0.1)";
+        readonly border: "rgba(255, 255, 255, 0.2)";
+        readonly law: "All cards use glass blur with 10% white fill, 20% white border";
+    };
+    readonly accent: {
+        readonly helixGold: "#FFD700";
+        readonly law: "Reserved for high-action elements only (CTAs, FABs)";
+    };
+    readonly spacing: {
+        readonly grid: readonly [8, 16, 24];
+        readonly law: "Strict 8px/16px/24px spacing system";
+    };
+};
+export declare const AI_CONSTITUTION: {
+    readonly contextAwareness: {
+        readonly requirement: "Redis caching for user context memory";
+        readonly law: "AI must remember past interactions";
+    };
+    readonly proactiveIntelligence: {
+        readonly requirement: "One predictive feature per app";
+        readonly example: "Predict maintenance based on usage patterns";
+        readonly law: "Every app must be proactive, not just reactive";
+    };
+    readonly safetyHealth: {
+        readonly requirement: "Helix Evolve pre-scan before generation";
+        readonly law: "Prevent N+1 queries and inefficient renders at birth";
+    };
+    readonly naturalInterface: {
+        readonly preference: "Chat/voice over complex menus";
+        readonly law: "Favor conversational interfaces";
+    };
+};
+export interface ConstitutionalViolation {
+    type: 'ui' | 'ai';
+    severity: 'low' | 'medium' | 'high';
+    law: string;
+    message: string;
+    suggestion: string;
+    autoFixable: boolean;
+}
+export interface ConstitutionalReport {
+    compliant: boolean;
+    score: number;
+    violations: ConstitutionalViolation[];
+    warnings: string[];
+}
+export interface SpawnOptions {
+    target?: 'web' | 'flutter';
+    db?: string;
+    theme?: string;
+    aiContext?: boolean;
+    cache?: boolean;
+    noConstitution?: boolean;
+    components?: string[];
+}
+export declare function validateUIConstitution(prompt: string, options: SpawnOptions): ConstitutionalViolation[];
+export declare function validateAIConstitution(prompt: string, options: SpawnOptions): ConstitutionalViolation[];
+export declare function validateConstitution(prompt: string, options: SpawnOptions): ConstitutionalReport;
+export declare function autoCorrectOptions(options: SpawnOptions, violations: ConstitutionalViolation[]): SpawnOptions;
+export declare function printConstitutionalReport(report: ConstitutionalReport): void;
+export declare function enhancePromptWithConstitution(prompt: string): string;
+//# sourceMappingURL=constitutional-validator.d.ts.map

package/dist/utils/constitutional-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constitutional-validator.d.ts","sourceRoot":"","sources":["../../src/utils/constitutional-validator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;CAmBlB,CAAC;AAEX,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CAkBlB,CAAC;AAMX,MAAM,WAAW,uBAAuB;IACpC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAMD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,uBAAuB,EAAE,CAiDvG;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,uBAAuB,EAAE,CAqDvG;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,oBAAoB,CA6BhG;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,uBAAuB,EAAE,GAAG,YAAY,CAuB7G;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAmC5E;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAiBpE"}

package/dist/utils/constitutional-validator.js

@@ -0,0 +1,249 @@
+"use strict";
+/**
+ * Constitutional Helix - Validation & Compliance System
+ * Enforces UI Constitution (Deep Void) and AI Constitution (AI-First Agent)
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_CONSTITUTION = exports.UI_CONSTITUTION = void 0;
+exports.validateUIConstitution = validateUIConstitution;
+exports.validateAIConstitution = validateAIConstitution;
+exports.validateConstitution = validateConstitution;
+exports.autoCorrectOptions = autoCorrectOptions;
+exports.printConstitutionalReport = printConstitutionalReport;
+exports.enhancePromptWithConstitution = enhancePromptWithConstitution;
+const chalk_1 = __importDefault(require("chalk"));
+// ============================================
+// CONSTITUTIONAL DEFINITIONS
+// ============================================
+exports.UI_CONSTITUTION = {
+    background: {
+        gradient: ['#0f0c29', '#000000'],
+        law: 'All core views must use Deep Void gradient',
+    },
+    glassmorphism: {
+        blur: '16px',
+        transparency: 'rgba(255, 255, 255, 0.1)',
+        border: 'rgba(255, 255, 255, 0.2)',
+        law: 'All cards use glass blur with 10% white fill, 20% white border',
+    },
+    accent: {
+        helixGold: '#FFD700',
+        law: 'Reserved for high-action elements only (CTAs, FABs)',
+    },
+    spacing: {
+        grid: [8, 16, 24],
+        law: 'Strict 8px/16px/24px spacing system',
+    },
+};
+exports.AI_CONSTITUTION = {
+    contextAwareness: {
+        requirement: 'Redis caching for user context memory',
+        law: 'AI must remember past interactions',
+    },
+    proactiveIntelligence: {
+        requirement: 'One predictive feature per app',
+        example: 'Predict maintenance based on usage patterns',
+        law: 'Every app must be proactive, not just reactive',
+    },
+    safetyHealth: {
+        requirement: 'Helix Evolve pre-scan before generation',
+        law: 'Prevent N+1 queries and inefficient renders at birth',
+    },
+    naturalInterface: {
+        preference: 'Chat/voice over complex menus',
+        law: 'Favor conversational interfaces',
+    },
+};
+// ============================================
+// VALIDATORS
+// ============================================
+function validateUIConstitution(prompt, options) {
+    const violations = [];
+    // V2: Accept any valid theme — only flag if no theme at all
+    const validThemes = ['deep-void', 'glassmorphism', 'glass', 'professional', 'pro', 'saas',
+        'business', 'clean', 'minimal', 'minimalist', 'simple', 'vibrant', 'colorful', 'social'];
+    const hasValidTheme = options.theme && validThemes.includes(options.theme.toLowerCase());
+    if (!hasValidTheme) {
+        violations.push({
+            type: 'ui',
+            severity: 'low', // Downgraded from 'high' — glassmorphism is applied as default anyway
+            law: exports.UI_CONSTITUTION.background.law,
+            message: 'No explicit theme specified — defaulting to Glassmorphism',
+            suggestion: 'Set --theme <name> to choose: glassmorphism, professional, minimal, vibrant',
+            autoFixable: true,
+        });
+    }
+    // Check for glass/blur mentions
+    const hasGlassmorphism = prompt.toLowerCase().includes('glass') ||
+        prompt.toLowerCase().includes('blur') ||
+        prompt.toLowerCase().includes('frosted');
+    if (!hasGlassmorphism && !prompt.includes('card')) {
+        violations.push({
+            type: 'ui',
+            severity: 'medium',
+            law: exports.UI_CONSTITUTION.glassmorphism.law,
+            message: 'No glassmorphism UI specified',
+            suggestion: 'Cards should use blur(16px) with glass effect',
+            autoFixable: false,
+        });
+    }
+    // Check spacing mentions
+    const hasSpacing = prompt.match(/\d+(px|rem)/);
+    if (!hasSpacing) {
+        violations.push({
+            type: 'ui',
+            severity: 'low',
+            law: exports.UI_CONSTITUTION.spacing.law,
+            message: 'No spacing system mentioned',
+            suggestion: 'Use 8/16/24px grid for consistent spacing',
+            autoFixable: false,
+        });
+    }
+    return violations;
+}
+function validateAIConstitution(prompt, options) {
+    const violations = [];
+    // Check Redis context
+    const hasRedis = prompt.toLowerCase().includes('redis') ||
+        options.cache ||
+        options.db?.includes('redis');
+    if (!hasRedis) {
+        violations.push({
+            type: 'ai',
+            severity: 'medium',
+            law: exports.AI_CONSTITUTION.contextAwareness.law,
+            message: 'No Redis context layer specified',
+            suggestion: 'Add --cache or include redis in --db for user context memory',
+            autoFixable: true,
+        });
+    }
+    // Check for predictive features
+    const hasPredictive = prompt.toLowerCase().includes('predict') ||
+        prompt.toLowerCase().includes('suggest') ||
+        prompt.toLowerCase().includes('recommend') ||
+        prompt.toLowerCase().includes('forecast');
+    if (!hasPredictive) {
+        violations.push({
+            type: 'ai',
+            severity: 'high',
+            law: exports.AI_CONSTITUTION.proactiveIntelligence.law,
+            message: 'No predictive AI feature detected',
+            suggestion: 'Add AI prediction/suggestion capability to make app proactive',
+            autoFixable: false,
+        });
+    }
+    // Check for natural interface
+    const hasNaturalUI = prompt.toLowerCase().includes('chat') ||
+        prompt.toLowerCase().includes('voice') ||
+        prompt.toLowerCase().includes('conversation');
+    if (!hasNaturalUI && !prompt.includes('dashboard')) {
+        violations.push({
+            type: 'ai',
+            severity: 'low',
+            law: exports.AI_CONSTITUTION.naturalInterface.law,
+            message: 'No natural interface (chat/voice) specified',
+            suggestion: 'Consider chat or voice input for better UX',
+            autoFixable: false,
+        });
+    }
+    return violations;
+}
+function validateConstitution(prompt, options) {
+    // Bypass if explicitly disabled
+    if (options.noConstitution) {
+        return {
+            compliant: true,
+            score: 100,
+            violations: [],
+            warnings: ['Constitutional validation bypassed with --no-constitution'],
+        };
+    }
+    const uiViolations = validateUIConstitution(prompt, options);
+    const aiViolations = validateAIConstitution(prompt, options);
+    const allViolations = [...uiViolations, ...aiViolations];
+    // Calculate score
+    const highCount = allViolations.filter(v => v.severity === 'high').length;
+    const mediumCount = allViolations.filter(v => v.severity === 'medium').length;
+    const lowCount = allViolations.filter(v => v.severity === 'low').length;
+    const score = Math.max(0, 100 - (highCount * 15 + mediumCount * 8 + lowCount * 3));
+    const compliant = score >= 70; // 70% threshold for compliance
+    return {
+        compliant,
+        score,
+        violations: allViolations,
+        warnings: [],
+    };
+}
+function autoCorrectOptions(options, violations) {
+    const corrected = { ...options };
+    violations.forEach(violation => {
+        if (!violation.autoFixable)
+            return;
+        // Auto-fix theme — default to glassmorphism if none specified
+        if (violation.message.includes('theme')) {
+            corrected.theme = corrected.theme || 'glassmorphism';
+        }
+        // Auto-add Redis cache
+        if (violation.message.includes('Redis')) {
+            corrected.cache = true;
+            if (corrected.db && !corrected.db.includes('redis')) {
+                corrected.db += ',redis';
+            }
+            else if (!corrected.db) {
+                corrected.db = 'redis';
+            }
+        }
+    });
+    return corrected;
+}
+function printConstitutionalReport(report) {
+    console.log(chalk_1.default.cyan('\n📜 Constitutional Compliance Report\n'));
+    // Score
+    const scoreColor = report.score >= 90 ? chalk_1.default.green :
+        report.score >= 70 ? chalk_1.default.yellow :
+            chalk_1.default.red;
+    console.log(scoreColor(`Score: ${report.score}/100`));
+    console.log(report.compliant ? chalk_1.default.green('✅ Compliant') : chalk_1.default.red('❌ Non-Compliant'));
+    // Violations
+    if (report.violations.length > 0) {
+        console.log(chalk_1.default.yellow(`\n⚠️  ${report.violations.length} Constitutional Violations:\n`));
+        report.violations.forEach((v, index) => {
+            const severityIcon = v.severity === 'high' ? '🔴' :
+                v.severity === 'medium' ? '🟡' :
+                    '⚪';
+            console.log(`${severityIcon} ${index + 1}. [${v.type.toUpperCase()}] ${v.message}`);
+            console.log(chalk_1.default.gray(`   Law: "${v.law}"`));
+            console.log(chalk_1.default.cyan(`   💡 ${v.suggestion}`));
+            if (v.autoFixable) {
+                console.log(chalk_1.default.green('   ✨ Auto-fixable'));
+            }
+            console.log('');
+        });
+    }
+    // Warnings
+    if (report.warnings.length > 0) {
+        console.log(chalk_1.default.yellow('Warnings:'));
+        report.warnings.forEach(w => console.log(chalk_1.default.gray(`  - ${w}`)));
+    }
+}
+function enhancePromptWithConstitution(prompt) {
+    const enhancement = `
+CONSTITUTIONAL REQUIREMENTS:
+
+UI Constitution - Deep Void:
+- Background: Linear gradient #0f0c29 → #000000
+- Cards: backdrop-filter blur(16px), rgba(255,255,255,0.1), border rgba(255,255,255,0.2)
+- Accent: #FFD700 for CTAs/FABs only
+- Spacing: 8px/16px/24px grid
+
+AI Constitution - AI-First:
+- Redis context for user memory
+- One predictive AI feature
+- Natural interface (chat/voice preferred)
+`;
+    return `${prompt}\n${enhancement}`;
+}
+//# sourceMappingURL=constitutional-validator.js.map

package/dist/utils/constitutional-validator.js.map

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

package/library/auth-flow/app/api/auth/[...nextauth]/route.ts

@@ -0,0 +1,31 @@
+/**
+ * NextAuth catch-all API route.
+ *
+ * This file should be placed at: app/api/auth/[...nextauth]/route.ts
+ *
+ * Prerequisites:
+ *   - npm install next-auth
+ *   - Set NEXTAUTH_SECRET in your .env
+ *   - Configure authOptions in components/auth/nextauth-config.ts
+ */
+
+// import NextAuth from 'next-auth';
+// import { authOptions } from '@/components/auth/nextauth-config';
+//
+// const handler = NextAuth(authOptions);
+// export { handler as GET, handler as POST };
+
+import { NextResponse } from 'next/server';
+
+// Placeholder until NextAuth is installed and configured
+export async function GET() {
+    return NextResponse.json({
+        message: 'NextAuth not configured yet. Install next-auth and uncomment the handler above.',
+    });
+}
+
+export async function POST() {
+    return NextResponse.json({
+        message: 'NextAuth not configured yet. Install next-auth and uncomment the handler above.',
+    });
+}

package/library/auth-flow/app/api/auth/login/route.ts

@@ -0,0 +1,90 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * POST /api/auth/login
+ * Authenticates a user with email and password.
+ *
+ * Replace the database stubs below with your actual Prisma or Supabase queries.
+ */
+export async function POST(request: NextRequest) {
+    try {
+        const { email, password } = await request.json();
+
+        if (!email || !password) {
+            return NextResponse.json(
+                { error: 'Email and password are required' },
+                { status: 400 }
+            );
+        }
+
+        // --- Replace with your database lookup ---
+        // const user = await prisma.user.findUnique({ where: { email } });
+        const user = await lookupUser(email);
+
+        if (!user) {
+            return NextResponse.json(
+                { error: 'Invalid credentials' },
+                { status: 401 }
+            );
+        }
+
+        // --- Replace with bcrypt.compare(password, user.passwordHash) ---
+        const isValid = await verifyPassword(password, user.passwordHash);
+
+        if (!isValid) {
+            return NextResponse.json(
+                { error: 'Invalid credentials' },
+                { status: 401 }
+            );
+        }
+
+        // Create session
+        const sessionToken = crypto.randomUUID();
+        const expiresAt = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
+
+        // --- Replace with your session creation logic ---
+        // await prisma.session.create({ data: { userId: user.id, token: sessionToken, expiresAt } });
+        await createSession(user.id, sessionToken, expiresAt);
+
+        const response = NextResponse.json({
+            message: 'Login successful',
+            token: sessionToken,
+            user: { id: user.id, email: user.email, name: user.name },
+        });
+
+        // Set httpOnly cookie as well
+        response.cookies.set('authToken', sessionToken, {
+            httpOnly: true,
+            secure: process.env.NODE_ENV === 'production',
+            sameSite: 'lax',
+            path: '/',
+            maxAge: 7 * 24 * 60 * 60,
+        });
+
+        return response;
+    } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : 'Internal server error';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}
+
+// --- Stubs: replace with real implementations ---
+
+async function lookupUser(_email: string): Promise<{
+    id: string;
+    email: string;
+    name: string | null;
+    passwordHash: string;
+} | null> {
+    // Replace with: return prisma.user.findUnique({ where: { email } });
+    return null;
+}
+
+async function verifyPassword(_plain: string, _hash: string): Promise<boolean> {
+    // Replace with: return bcrypt.compare(plain, hash);
+    return false;
+}
+
+async function createSession(_userId: string, _token: string, _expiresAt: Date): Promise<void> {
+    // Replace with: await prisma.session.create({ data: { userId, token, expiresAt } });
+}

package/library/auth-flow/app/api/auth/register/route.ts

@@ -0,0 +1,91 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * POST /api/auth/register
+ * Creates a new user account.
+ *
+ * Replace the database stubs below with your actual Prisma or Supabase queries.
+ */
+export async function POST(request: NextRequest) {
+    try {
+        const { name, email, password } = await request.json();
+
+        if (!email || !password) {
+            return NextResponse.json(
+                { error: 'Email and password are required' },
+                { status: 400 }
+            );
+        }
+
+        if (typeof password !== 'string' || password.length < 8) {
+            return NextResponse.json(
+                { error: 'Password must be at least 8 characters' },
+                { status: 400 }
+            );
+        }
+
+        // Check if user already exists
+        const existing = await lookupUserByEmail(email);
+        if (existing) {
+            return NextResponse.json(
+                { error: 'An account with this email already exists' },
+                { status: 409 }
+            );
+        }
+
+        // Hash password
+        const passwordHash = await hashPassword(password);
+
+        // Create user
+        const user = await createUser({ name: name || null, email, passwordHash });
+
+        // Create session
+        const sessionToken = crypto.randomUUID();
+        const expiresAt = new Date(Date.now() + 7 * 24 * 60 * 60 * 1000);
+        await createSession(user.id, sessionToken, expiresAt);
+
+        const response = NextResponse.json({
+            message: 'Account created successfully',
+            token: sessionToken,
+            user: { id: user.id, email: user.email, name: user.name },
+        }, { status: 201 });
+
+        response.cookies.set('authToken', sessionToken, {
+            httpOnly: true,
+            secure: process.env.NODE_ENV === 'production',
+            sameSite: 'lax',
+            path: '/',
+            maxAge: 7 * 24 * 60 * 60,
+        });
+
+        return response;
+    } catch (error: unknown) {
+        const message = error instanceof Error ? error.message : 'Internal server error';
+        return NextResponse.json({ error: message }, { status: 500 });
+    }
+}
+
+// --- Stubs: replace with real implementations ---
+
+async function lookupUserByEmail(_email: string): Promise<{ id: string } | null> {
+    // return prisma.user.findUnique({ where: { email }, select: { id: true } });
+    return null;
+}
+
+async function hashPassword(_password: string): Promise<string> {
+    // return bcrypt.hash(password, 12);
+    return '';
+}
+
+async function createUser(data: {
+    name: string | null;
+    email: string;
+    passwordHash: string;
+}): Promise<{ id: string; email: string; name: string | null }> {
+    // return prisma.user.create({ data });
+    return { id: crypto.randomUUID(), email: data.email, name: data.name };
+}
+
+async function createSession(_userId: string, _token: string, _expiresAt: Date): Promise<void> {
+    // await prisma.session.create({ data: { userId, token, expiresAt } });
+}