proagents 1.0.0

package/proagents/scaffolding/nextjs/templates/api-route.ts.template

@@ -0,0 +1,185 @@
+/**
+ * {{RouteName}} API Route
+ *
+ * {{description}}
+ *
+ * Route: /api/{{route}}
+ */
+
+import { NextRequest, NextResponse } from 'next/server';
+import { z } from 'zod';
+{{#if useAuth}}
+import { auth } from '@/lib/auth';
+{{/if}}
+{{#if useDb}}
+import { db } from '@/lib/db';
+{{/if}}
+
+// ============================================================================
+// Validation Schemas
+// ============================================================================
+
+const {{entityName}}Schema = z.object({
+  name: z.string().min(1).max(255),
+  description: z.string().optional(),
+});
+
+const querySchema = z.object({
+  page: z.coerce.number().int().positive().default(1),
+  limit: z.coerce.number().int().positive().max(100).default(10),
+  search: z.string().optional(),
+});
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface {{EntityName}} {
+  id: string;
+  name: string;
+  description?: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+// ============================================================================
+// GET Handler
+// ============================================================================
+
+/**
+ * GET /api/{{route}}
+ *
+ * Fetch all {{entityName}}s with pagination
+ */
+export async function GET(request: NextRequest) {
+  try {
+    {{#if useAuth}}
+    // Check authentication
+    const session = await auth();
+    if (!session) {
+      return NextResponse.json(
+        { error: 'Unauthorized' },
+        { status: 401 }
+      );
+    }
+    {{/if}}
+
+    // Parse query parameters
+    const { searchParams } = new URL(request.url);
+    const query = querySchema.parse({
+      page: searchParams.get('page'),
+      limit: searchParams.get('limit'),
+      search: searchParams.get('search'),
+    });
+
+    // Fetch data
+    {{#if useDb}}
+    const skip = (query.page - 1) * query.limit;
+    const where = query.search
+      ? { name: { contains: query.search, mode: 'insensitive' } }
+      : {};
+
+    const [items, total] = await Promise.all([
+      db.{{entityName}}.findMany({
+        where,
+        skip,
+        take: query.limit,
+        orderBy: { createdAt: 'desc' },
+      }),
+      db.{{entityName}}.count({ where }),
+    ]);
+    {{else}}
+    // Placeholder: Replace with actual data fetching
+    const items: {{EntityName}}[] = [];
+    const total = 0;
+    {{/if}}
+
+    return NextResponse.json({
+      data: items,
+      meta: {
+        page: query.page,
+        limit: query.limit,
+        total,
+        totalPages: Math.ceil(total / query.limit),
+      },
+    });
+  } catch (error) {
+    console.error('GET /api/{{route}} error:', error);
+
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { error: 'Invalid query parameters', details: error.errors },
+        { status: 400 }
+      );
+    }
+
+    return NextResponse.json(
+      { error: 'Internal server error' },
+      { status: 500 }
+    );
+  }
+}
+
+// ============================================================================
+// POST Handler
+// ============================================================================
+
+/**
+ * POST /api/{{route}}
+ *
+ * Create a new {{entityName}}
+ */
+export async function POST(request: NextRequest) {
+  try {
+    {{#if useAuth}}
+    // Check authentication
+    const session = await auth();
+    if (!session) {
+      return NextResponse.json(
+        { error: 'Unauthorized' },
+        { status: 401 }
+      );
+    }
+    {{/if}}
+
+    // Parse and validate body
+    const body = await request.json();
+    const data = {{entityName}}Schema.parse(body);
+
+    // Create record
+    {{#if useDb}}
+    const item = await db.{{entityName}}.create({
+      data: {
+        ...data,
+        {{#if useAuth}}
+        userId: session.user.id,
+        {{/if}}
+      },
+    });
+    {{else}}
+    // Placeholder: Replace with actual creation logic
+    const item: {{EntityName}} = {
+      id: crypto.randomUUID(),
+      ...data,
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    };
+    {{/if}}
+
+    return NextResponse.json(item, { status: 201 });
+  } catch (error) {
+    console.error('POST /api/{{route}} error:', error);
+
+    if (error instanceof z.ZodError) {
+      return NextResponse.json(
+        { error: 'Validation error', details: error.errors },
+        { status: 400 }
+      );
+    }
+
+    return NextResponse.json(
+      { error: 'Internal server error' },
+      { status: 500 }
+    );
+  }
+}

package/proagents/scaffolding/nextjs/templates/page.tsx.template

@@ -0,0 +1,109 @@
+/**
+ * {{PageName}} Page
+ *
+ * {{description}}
+ *
+ * Route: /{{route}}
+ */
+
+import { Metadata } from 'next';
+import { notFound } from 'next/navigation';
+{{#if hasParams}}
+import { {{PageName}}Content } from './{{PageName}}Content';
+{{/if}}
+
+// ============================================================================
+// Metadata
+// ============================================================================
+
+export const metadata: Metadata = {
+  title: '{{pageTitle}}',
+  description: '{{pageDescription}}',
+  openGraph: {
+    title: '{{pageTitle}}',
+    description: '{{pageDescription}}',
+  },
+};
+
+{{#if hasParams}}
+// ============================================================================
+// Types
+// ============================================================================
+
+interface {{PageName}}PageProps {
+  params: {
+    {{paramName}}: string;
+  };
+  searchParams: {
+    [key: string]: string | string[] | undefined;
+  };
+}
+
+// ============================================================================
+// Data Fetching
+// ============================================================================
+
+async function get{{EntityName}}(id: string) {
+  try {
+    const response = await fetch(
+      `${process.env.API_URL}/api/{{kebabCase entityName}}s/${id}`,
+      {
+        next: { revalidate: 60 }, // Cache for 60 seconds
+      }
+    );
+
+    if (!response.ok) {
+      if (response.status === 404) {
+        return null;
+      }
+      throw new Error('Failed to fetch data');
+    }
+
+    return response.json();
+  } catch (error) {
+    console.error('Error fetching {{entityName}}:', error);
+    throw error;
+  }
+}
+
+// ============================================================================
+// Page Component
+// ============================================================================
+
+export default async function {{PageName}}Page({
+  params,
+  searchParams,
+}: {{PageName}}PageProps) {
+  const data = await get{{EntityName}}(params.{{paramName}});
+
+  if (!data) {
+    notFound();
+  }
+
+  return (
+    <main className="container mx-auto px-4 py-8">
+      <{{PageName}}Content data={data} />
+    </main>
+  );
+}
+
+{{else}}
+// ============================================================================
+// Page Component
+// ============================================================================
+
+export default function {{PageName}}Page() {
+  return (
+    <main className="container mx-auto px-4 py-8">
+      <h1 className="text-3xl font-bold mb-6">{{pageTitle}}</h1>
+
+      <section className="space-y-6">
+        {/* Page content */}
+        <p className="text-gray-600">
+          {{pageDescription}}
+        </p>
+      </section>
+    </main>
+  );
+}
+{{/if}}

package/proagents/scaffolding/nextjs/templates/server-action.ts.template

@@ -0,0 +1,204 @@
+/**
+ * {{ActionName}} Server Actions
+ *
+ * {{description}}
+ */
+
+'use server';
+
+import { revalidatePath, revalidateTag } from 'next/cache';
+import { redirect } from 'next/navigation';
+import { z } from 'zod';
+{{#if useAuth}}
+import { auth } from '@/lib/auth';
+{{/if}}
+{{#if useDb}}
+import { db } from '@/lib/db';
+{{/if}}
+
+// ============================================================================
+// Schemas
+// ============================================================================
+
+const create{{EntityName}}Schema = z.object({
+  name: z.string().min(1, 'Name is required').max(255),
+  description: z.string().optional(),
+});
+
+const update{{EntityName}}Schema = create{{EntityName}}Schema.partial();
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface ActionResult<T = unknown> {
+  success: boolean;
+  data?: T;
+  error?: string;
+  errors?: Record<string, string[]>;
+}
+
+// ============================================================================
+// Actions
+// ============================================================================
+
+/**
+ * Create a new {{entityName}}
+ */
+export async function create{{EntityName}}(
+  formData: FormData
+): Promise<ActionResult> {
+  try {
+    {{#if useAuth}}
+    // Check authentication
+    const session = await auth();
+    if (!session?.user) {
+      return { success: false, error: 'Unauthorized' };
+    }
+    {{/if}}
+
+    // Parse and validate
+    const rawData = {
+      name: formData.get('name'),
+      description: formData.get('description'),
+    };
+
+    const validatedData = create{{EntityName}}Schema.safeParse(rawData);
+
+    if (!validatedData.success) {
+      return {
+        success: false,
+        error: 'Validation failed',
+        errors: validatedData.error.flatten().fieldErrors,
+      };
+    }
+
+    // Create record
+    {{#if useDb}}
+    const item = await db.{{entityName}}.create({
+      data: {
+        ...validatedData.data,
+        {{#if useAuth}}
+        userId: session.user.id,
+        {{/if}}
+      },
+    });
+    {{else}}
+    // Placeholder: Replace with actual creation logic
+    const item = { id: crypto.randomUUID(), ...validatedData.data };
+    {{/if}}
+
+    // Revalidate cache
+    revalidatePath('/{{kebabCase entityName}}s');
+    revalidateTag('{{kebabCase entityName}}s');
+
+    return { success: true, data: item };
+  } catch (error) {
+    console.error('create{{EntityName}} error:', error);
+    return { success: false, error: 'Failed to create {{entityName}}' };
+  }
+}
+
+/**
+ * Update an existing {{entityName}}
+ */
+export async function update{{EntityName}}(
+  id: string,
+  formData: FormData
+): Promise<ActionResult> {
+  try {
+    {{#if useAuth}}
+    // Check authentication
+    const session = await auth();
+    if (!session?.user) {
+      return { success: false, error: 'Unauthorized' };
+    }
+    {{/if}}
+
+    // Parse and validate
+    const rawData = {
+      name: formData.get('name') || undefined,
+      description: formData.get('description') || undefined,
+    };
+
+    const validatedData = update{{EntityName}}Schema.safeParse(rawData);
+
+    if (!validatedData.success) {
+      return {
+        success: false,
+        error: 'Validation failed',
+        errors: validatedData.error.flatten().fieldErrors,
+      };
+    }
+
+    // Update record
+    {{#if useDb}}
+    const item = await db.{{entityName}}.update({
+      where: { id },
+      data: validatedData.data,
+    });
+    {{else}}
+    // Placeholder: Replace with actual update logic
+    const item = { id, ...validatedData.data };
+    {{/if}}
+
+    // Revalidate cache
+    revalidatePath('/{{kebabCase entityName}}s');
+    revalidatePath(`/{{kebabCase entityName}}s/${id}`);
+    revalidateTag('{{kebabCase entityName}}s');
+
+    return { success: true, data: item };
+  } catch (error) {
+    console.error('update{{EntityName}} error:', error);
+    return { success: false, error: 'Failed to update {{entityName}}' };
+  }
+}
+
+/**
+ * Delete a {{entityName}}
+ */
+export async function delete{{EntityName}}(id: string): Promise<ActionResult> {
+  try {
+    {{#if useAuth}}
+    // Check authentication
+    const session = await auth();
+    if (!session?.user) {
+      return { success: false, error: 'Unauthorized' };
+    }
+    {{/if}}
+
+    // Delete record
+    {{#if useDb}}
+    await db.{{entityName}}.delete({
+      where: { id },
+    });
+    {{else}}
+    // Placeholder: Replace with actual deletion logic
+    {{/if}}
+
+    // Revalidate cache
+    revalidatePath('/{{kebabCase entityName}}s');
+    revalidateTag('{{kebabCase entityName}}s');
+
+    return { success: true };
+  } catch (error) {
+    console.error('delete{{EntityName}} error:', error);
+    return { success: false, error: 'Failed to delete {{entityName}}' };
+  }
+}
+
+/**
+ * Form action wrapper for create
+ */
+export async function create{{EntityName}}Action(
+  _prevState: ActionResult,
+  formData: FormData
+): Promise<ActionResult> {
+  const result = await create{{EntityName}}(formData);
+
+  if (result.success) {
+    redirect('/{{kebabCase entityName}}s');
+  }
+
+  return result;
+}