create-appraise 0.1.0

package/templates/default/src/app/(base)/tags/create/page.tsx

@@ -0,0 +1,39 @@
+import { createTagAction } from '@/actions/tags/tag-actions'
+import PageHeader from '@/components/typography/page-header'
+import HeaderSubtitle from '@/components/typography/page-header-subtitle'
+import { Tag } from 'lucide-react'
+import React from 'react'
+import TagForm from '../tag-form'
+import { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Appraise | Create Tag',
+  description: 'Create a new tag to be used in your test cases',
+}
+
+const CreateTag = () => {
+  return (
+    <>
+      <div className="mb-8">
+        <PageHeader>
+          <span className="flex items-center">
+            <Tag className="mr-2 h-8 w-8" />
+            Create Tag
+          </span>
+        </PageHeader>
+        <HeaderSubtitle>Create a new tag to be used in your test cases.</HeaderSubtitle>
+      </div>
+      <TagForm
+        successTitle="Tag created"
+        successMessage="Tag created successfully"
+        onSubmitAction={createTagAction}
+        defaultValues={{
+          name: '',
+          tagExpression: '',
+        }}
+      />
+    </>
+  )
+}
+
+export default CreateTag

package/templates/default/src/app/(base)/tags/modify/[id]/page.tsx

@@ -0,0 +1,50 @@
+import PageHeader from '@/components/typography/page-header'
+import HeaderSubtitle from '@/components/typography/page-header-subtitle'
+import React from 'react'
+import TagForm from '../../tag-form'
+import { getTagByIdAction, updateTagAction } from '@/actions/tags/tag-actions'
+import { Tag } from 'lucide-react'
+import { Tag as TagType } from '@prisma/client'
+import { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Appraise | Modify Tag',
+  description: 'Modify a tag',
+}
+
+const ModifyTag = async ({ params }: { params: Promise<{ id: string }> }) => {
+  const { id } = await params
+  const { data: tagToBeEditedData, error: tagToBeEditedError } = await getTagByIdAction(id)
+
+  if (tagToBeEditedError) {
+    return <div>Error: {tagToBeEditedError}</div>
+  }
+
+  const tagData = tagToBeEditedData as TagType
+
+  return (
+    <>
+      <div className="mb-8">
+        <PageHeader>
+          <span className="flex items-center">
+            <Tag className="mr-2 h-8 w-8" />
+            Modify Tag
+          </span>
+        </PageHeader>
+        <HeaderSubtitle>Modify a tag.</HeaderSubtitle>
+      </div>
+      <TagForm
+        successTitle="Tag modified"
+        successMessage="Tag modified successfully"
+        onSubmitAction={updateTagAction}
+        defaultValues={{
+          name: tagData.name,
+          tagExpression: tagData.tagExpression,
+        }}
+        id={id}
+      />
+    </>
+  )
+}
+
+export default ModifyTag

package/templates/default/src/app/(base)/tags/page.tsx

@@ -0,0 +1,58 @@
+import DataTableSkeleton from '@/components/loading-skeleton/data-table/data-table-skeleton'
+import PageHeader from '@/components/typography/page-header'
+import HeaderSubtitle from '@/components/typography/page-header-subtitle'
+import { Tag } from 'lucide-react'
+import React, { Suspense } from 'react'
+import TagTable from './tag-table'
+import { getAllTagsAction } from '@/actions/tags/tag-actions'
+import EmptyState from '@/components/data-state/empty-state'
+import { Tag as TagModel } from '@prisma/client'
+import { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Appraise | Tags',
+  description: 'Manage tags for categorizing test cases and test runs',
+}
+
+const Tags = async () => {
+  const { data: tags, error: tagsError } = await getAllTagsAction()
+
+  if (tagsError) {
+    return <div>Error: {tagsError}</div>
+  }
+
+  const tagsData = tags as TagModel[]
+
+  if (!tagsData || tagsData.length === 0) {
+    return (
+      <div className="flex min-h-[calc(100vh-20rem)] items-center justify-center">
+        <EmptyState
+          icon={<Tag className="h-8 w-8" />}
+          title="No tags found"
+          description="Get started by creating a tag to categorize your test cases and test runs"
+          createRoute="/tags/create"
+          createText="Create Tag"
+        />
+      </div>
+    )
+  }
+
+  return (
+    <>
+      <div className="mb-8">
+        <PageHeader>
+          <span className="flex items-center">
+            <Tag className="mr-2 h-8 w-8" />
+            Tags
+          </span>
+        </PageHeader>
+        <HeaderSubtitle>Tags are used to categorize test cases and test runs</HeaderSubtitle>
+      </div>
+      <Suspense fallback={<DataTableSkeleton />}>
+        <TagTable />
+      </Suspense>
+    </>
+  )
+}
+
+export default Tags

package/templates/default/src/app/(base)/tags/tag-form.tsx

@@ -0,0 +1,147 @@
+'use client'
+
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { formOpts, type Tag } from '@/constants/form-opts/tag-form-opts'
+import { toast } from '@/hooks/use-toast'
+import { ActionResponse } from '@/types/form/actionHandler'
+
+import { useForm } from '@tanstack/react-form'
+import { useRouter } from 'next/navigation'
+import React from 'react'
+import { z } from 'zod'
+
+const TagForm = ({
+  defaultValues,
+  successTitle,
+  successMessage,
+  id,
+  onSubmitAction,
+}: {
+  defaultValues?: Tag
+  successTitle: string
+  successMessage: string
+  id?: string
+  onSubmitAction: (_prev: unknown, value: Tag, id?: string) => Promise<ActionResponse>
+}) => {
+  const router = useRouter()
+  const form = useForm({
+    defaultValues: defaultValues ?? formOpts?.defaultValues,
+    validators: formOpts?.validators,
+    onSubmit: async ({ value }) => {
+      const res = await onSubmitAction(undefined, value, id)
+      if (res.status === 200) {
+        toast({
+          title: successTitle,
+          description: successMessage,
+        })
+        router.push('/tags')
+      }
+      if (res.status === 400) {
+        toast({
+          title: 'Error',
+          description: res.error,
+          variant: 'destructive',
+        })
+      }
+      if (res.status === 500) {
+        toast({
+          title: 'Error',
+          description: res.error,
+          variant: 'destructive',
+        })
+      }
+    },
+  })
+  return (
+    <form
+      onSubmit={e => {
+        e.preventDefault()
+        e.stopPropagation()
+        form.handleSubmit()
+      }}
+    >
+      <form.Field
+        name="name"
+        validators={{
+          onChange: z.string().min(1, { message: 'Name is required' }),
+        }}
+      >
+        {field => {
+          return (
+            <div className="mb-4 flex flex-col gap-2 lg:w-1/3">
+              <Label htmlFor={field.name}>Name</Label>
+              <Input id={field.name} value={field.state.value} onChange={e => field.handleChange(e.target.value)} />
+              {field.state.meta.isTouched &&
+                field.state.meta.errors.map((error, index) => (
+                  <p key={index} className="text-xs text-pink-500">
+                    {typeof error === 'string' ? error : error?.message || String(error)}
+                  </p>
+                ))}
+            </div>
+          )
+        }}
+      </form.Field>
+      <form.Field
+        name="tagExpression"
+        validators={{
+          onChange: z
+            .string()
+            .min(1, { message: 'Tag expression is required' })
+            .refine(
+              value => {
+                // Check if the value follows Gherkin tag rules
+                // Only one tag allowed per entry - single word after @ symbol
+                const trimmedValue = value.trim()
+                if (!trimmedValue) return false
+
+                // Should not contain any spaces (only one tag allowed)
+                if (trimmedValue.includes(' ')) return false
+
+                // Tag should start with @
+                if (!trimmedValue.startsWith('@')) return false
+
+                // Tag should have at least one character after @
+                if (trimmedValue.length <= 1) return false
+
+                return true
+              },
+              {
+                message: 'Tag expression must be a single tag starting with @ and contain no spaces (e.g., "@smoke")',
+              },
+            ),
+        }}
+      >
+        {field => {
+          return (
+            <div className="mb-4 flex flex-col gap-2 lg:w-1/3">
+              <Label htmlFor={field.name}>Tag Expression</Label>
+              <Input
+                id={field.name}
+                value={field.state.value}
+                onChange={e => field.handleChange(e.target.value)}
+                placeholder="e.g. @smoke"
+              />
+              {field.state.meta.isTouched &&
+                field.state.meta.errors.map((error, index) => (
+                  <p key={index} className="text-xs text-pink-500">
+                    {typeof error === 'string' ? error : error?.message || String(error)}
+                  </p>
+                ))}
+            </div>
+          )
+        }}
+      </form.Field>
+      <form.Subscribe selector={formState => [formState.canSubmit, formState.isSubmitting]}>
+        {([canSubmit, isSubmitting]) => (
+          <Button type="submit" disabled={!canSubmit}>
+            {isSubmitting ? '...' : 'Save'}
+          </Button>
+        )}
+      </form.Subscribe>
+    </form>
+  )
+}
+
+export default TagForm

package/templates/default/src/app/(base)/tags/tag-table-columns.tsx

@@ -0,0 +1,63 @@
+'use client'
+
+import { DataTableColumnHeader } from '@/components/ui/data-table-column-header'
+import { Tag } from '@prisma/client'
+import { ColumnDef } from '@tanstack/react-table'
+
+import { Checkbox } from '@/components/ui/checkbox'
+import TableActions from '@/components/table/table-actions'
+import { deleteTagAction } from '@/actions/tags/tag-actions'
+import { formatDateTime } from '@/lib/utils'
+
+export const tagTableCols: ColumnDef<Tag>[] = [
+  {
+    id: 'select',
+    header: ({ table }) => (
+      <Checkbox
+        checked={table.getIsAllPageRowsSelected() || (table.getIsSomePageRowsSelected() && 'indeterminate')}
+        onCheckedChange={value => table.toggleAllPageRowsSelected(!!value)}
+        aria-label="Select all"
+        className="mr-2"
+      />
+    ),
+    cell: ({ row }) => (
+      <Checkbox
+        checked={row.getIsSelected()}
+        onCheckedChange={value => row.toggleSelected(!!value)}
+        aria-label="Select row"
+        className="mr-2"
+      />
+    ),
+    enableSorting: false,
+    enableHiding: false,
+  },
+  {
+    accessorKey: 'name',
+    header: ({ column }) => <DataTableColumnHeader column={column} title="Name" />,
+  },
+  {
+    accessorKey: 'tagExpression',
+    header: ({ column }) => <DataTableColumnHeader column={column} title="Tag Expression" />,
+  },
+  {
+    accessorKey: 'createdAt',
+    header: ({ column }) => <DataTableColumnHeader column={column} title="Created At" />,
+    cell: ({ row }) => {
+      return formatDateTime(row.original.createdAt)
+    },
+  },
+  {
+    accessorKey: 'updatedAt',
+    header: ({ column }) => <DataTableColumnHeader column={column} title="Updated At" />,
+    cell: ({ row }) => {
+      return formatDateTime(row.original.updatedAt)
+    },
+  },
+  {
+    id: 'actions',
+    cell: ({ row }) => {
+      const tag = row.original
+      return <TableActions modifyLink={`/tags/modify/${tag.id}`} deleteHandler={() => deleteTagAction([tag.id])} />
+    },
+  },
+]

package/templates/default/src/app/(base)/tags/tag-table.tsx

@@ -0,0 +1,29 @@
+import { DataTable } from '@/components/ui/data-table'
+import { deleteTagAction, getAllTagsAction } from '@/actions/tags/tag-actions'
+import { Tag } from '@prisma/client'
+import React from 'react'
+import { tagTableCols } from './tag-table-columns'
+
+const TagTable = async () => {
+  const { data: tags, error: tagsError } = await getAllTagsAction()
+
+  if (tagsError) {
+    return <div>Error: {tagsError}</div>
+  }
+
+  return (
+    <>
+      <DataTable
+        columns={tagTableCols}
+        data={tags as Tag[]}
+        filterColumn="name"
+        filterPlaceholder="Filter by name..."
+        createLink="/tags/create"
+        modifyLink="/tags/modify"
+        deleteAction={deleteTagAction}
+      />
+    </>
+  )
+}
+
+export default TagTable

package/templates/default/src/app/(base)/template-step-groups/create/page.tsx

@@ -0,0 +1,28 @@
+import { createTemplateStepGroupAction } from '@/actions/template-step-group/template-step-group-actions'
+import { TemplateStepGroupForm } from '../template-step-group-form'
+import PageHeader from '@/components/typography/page-header'
+import HeaderSubtitle from '@/components/typography/page-header-subtitle'
+import { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Appraise | Create Template Step Group',
+  description: 'Create a new template step group to organize related template steps',
+}
+
+const CreateTemplateStepGroup = async () => {
+  return (
+    <>
+      <div className="mb-8">
+        <PageHeader>Create Template Step Group</PageHeader>
+        <HeaderSubtitle>Create a new template step group to organize related template steps</HeaderSubtitle>
+      </div>
+      <TemplateStepGroupForm
+        successTitle="Group created"
+        successMessage="Template step group created successfully"
+        onSubmitAction={createTemplateStepGroupAction}
+      />
+    </>
+  )
+}
+
+export default CreateTemplateStepGroup

package/templates/default/src/app/(base)/template-step-groups/modify/[id]/page.tsx

@@ -0,0 +1,45 @@
+import {
+  getTemplateStepGroupByIdAction,
+  updateTemplateStepGroupAction,
+} from '@/actions/template-step-group/template-step-group-actions'
+import { TemplateStepGroupForm } from '../../template-step-group-form'
+import React from 'react'
+import { TemplateStepGroup } from '@prisma/client'
+import { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Appraise | Modify Template Step Group',
+  description: 'Update template step group configuration',
+}
+
+const TemplateStepGroupType = {
+  ACTION: 'ACTION',
+  VALIDATION: 'VALIDATION',
+} as const
+
+const ModifyTemplateStepGroup = async ({ params }: { params: Promise<{ id: string }> }) => {
+  const { id } = await params
+  const { data: templateStepGroup, error } = await getTemplateStepGroupByIdAction(id)
+
+  if (error) {
+    return <div>Error: {error}</div>
+  }
+
+  const templateStepGroupData = templateStepGroup as TemplateStepGroup
+
+  return (
+    <TemplateStepGroupForm
+      defaultValues={{
+        name: templateStepGroupData.name ?? '',
+        description: templateStepGroupData.description ?? '',
+        type: (templateStepGroupData as { type?: 'ACTION' | 'VALIDATION' }).type ?? TemplateStepGroupType.ACTION,
+      }}
+      successTitle="Group updated"
+      successMessage="Template step group updated successfully"
+      onSubmitAction={updateTemplateStepGroupAction}
+      id={id}
+    />
+  )
+}
+
+export default ModifyTemplateStepGroup

package/templates/default/src/app/(base)/template-step-groups/page.tsx

@@ -0,0 +1,60 @@
+import PageHeader from '@/components/typography/page-header'
+import HeaderSubtitle from '@/components/typography/page-header-subtitle'
+import { Component } from 'lucide-react'
+import TemplateStepGroupTable from './template-step-group-table'
+import { Suspense } from 'react'
+import DataTableSkeleton from '@/components/loading-skeleton/data-table/data-table-skeleton'
+import { getAllTemplateStepGroupsAction } from '@/actions/template-step-group/template-step-group-actions'
+import EmptyState from '@/components/data-state/empty-state'
+import { TemplateStepGroup } from '@prisma/client'
+import { Metadata } from 'next'
+
+export const metadata: Metadata = {
+  title: 'Appraise | Template Step Groups',
+  description: 'Manage template step groups for organizing related template steps',
+}
+
+const TemplateStepGroups = async () => {
+  const { data: templateStepGroups, error: templateStepGroupsError } = await getAllTemplateStepGroupsAction()
+
+  if (templateStepGroupsError) {
+    return <div>Error: {templateStepGroupsError}</div>
+  }
+
+  const templateStepGroupsData = templateStepGroups as TemplateStepGroup[]
+
+  if (!templateStepGroupsData || templateStepGroupsData.length === 0) {
+    return (
+      <div className="flex min-h-[calc(100vh-20rem)] items-center justify-center">
+        <EmptyState
+          icon={<Component className="h-8 w-8" />}
+          title="No template step groups found"
+          description="Get started by creating a template step group to organize related template steps"
+          createRoute="/template-step-groups/create"
+          createText="Create Template Step Group"
+        />
+      </div>
+    )
+  }
+
+  return (
+    <>
+      <div className="mb-8">
+        <PageHeader>
+          <span className="flex items-center">
+            <Component className="mr-2 h-8 w-8" />
+            Template Step Groups
+          </span>
+        </PageHeader>
+        <HeaderSubtitle>
+          Template step groups organize related template steps for better management and reusability
+        </HeaderSubtitle>
+      </div>
+      <Suspense fallback={<DataTableSkeleton />}>
+        <TemplateStepGroupTable />
+      </Suspense>
+    </>
+  )
+}
+
+export default TemplateStepGroups

package/templates/default/src/app/(base)/template-step-groups/template-step-group-form.tsx

@@ -0,0 +1,167 @@
+'use client'
+
+import { Button } from '@/components/ui/button'
+import { Input } from '@/components/ui/input'
+import { Label } from '@/components/ui/label'
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/components/ui/select'
+import { formOpts, TemplateStepGroup } from '@/constants/form-opts/template-step-group-form-opts'
+import { toast } from '@/hooks/use-toast'
+import { ActionResponse } from '@/types/form/actionHandler'
+import { useForm } from '@tanstack/react-form'
+import { useRouter } from 'next/navigation'
+import { z } from 'zod'
+
+// TemplateStepGroupType values
+const TemplateStepGroupType = {
+  ACTION: 'ACTION',
+  VALIDATION: 'VALIDATION',
+} as const
+
+// Enum validator for type field
+const TemplateStepGroupTypeEnum = z.enum(['ACTION', 'VALIDATION'])
+
+export const TemplateStepGroupForm = ({
+  defaultValues,
+  successTitle,
+  successMessage,
+  id,
+  onSubmitAction,
+}: {
+  defaultValues?: TemplateStepGroup
+  successTitle: string
+  successMessage: string
+  id?: string
+  onSubmitAction: (
+    _prev: unknown,
+    value: TemplateStepGroup,
+    id?: string,
+  ) => Promise<ActionResponse>
+}) => {
+  const router = useRouter()
+  const form = useForm({
+    defaultValues: defaultValues ?? formOpts?.defaultValues,
+    validators: formOpts?.validators,
+    onSubmit: async ({ value }) => {
+      const res = await onSubmitAction(undefined, value, id)
+      if (res.status === 200) {
+        toast({
+          title: successTitle,
+          description: successMessage,
+        })
+        router.push('/template-step-groups')
+      }
+      if (res.status === 400) {
+        toast({
+          title: 'Error',
+          description: res.error,
+          variant: 'destructive',
+        })
+      }
+      if (res.status === 500) {
+        toast({
+          title: 'Error',
+          description: res.error,
+          variant: 'destructive',
+        })
+      }
+    },
+  })
+  return (
+    <form
+      onSubmit={e => {
+        e.preventDefault()
+        e.stopPropagation()
+        form.handleSubmit()
+      }}
+    >
+      <form.Field
+        name="name"
+        validators={{
+          onChange: z.string().min(3, { message: 'Name must be at least 3 characters' }),
+        }}
+      >
+        {field => {
+          return (
+            <div className="mb-4 flex flex-col gap-2 lg:w-1/3">
+              <Label htmlFor={field.name}>Name</Label>
+              <Input
+                id={field.name}
+                name={field.name}
+                value={field.state.value}
+                onChange={e => field.handleChange(e.target.value)}
+              />
+              {field.state.meta.errors.map((error, index) => (
+                <p key={index} className="text-xs text-pink-500">
+                  {typeof error === 'string' ? error : error?.message || String(error)}
+                </p>
+              ))}
+            </div>
+          )
+        }}
+      </form.Field>
+      <form.Field name="description">
+        {field => {
+          return (
+            <div className="mb-4 flex flex-col gap-2 lg:w-1/3">
+              <Label htmlFor={field.name}>Description</Label>
+              <Input
+                id={field.name}
+                name={field.name}
+                value={field.state.value}
+                onChange={e => field.handleChange(e.target.value)}
+              />
+              {field.state.meta.errors.map((error, index) => (
+                <p key={index} className="text-xs text-pink-500">
+                  {typeof error === 'string' ? error : error?.message || String(error)}
+                </p>
+              ))}
+            </div>
+          )
+        }}
+      </form.Field>
+      <form.Field
+        name="type"
+        validators={{
+          onChange: TemplateStepGroupTypeEnum,
+        }}
+      >
+        {field => {
+          return (
+            <div className="mb-4 flex flex-col gap-2 lg:w-1/3">
+              <Label htmlFor={field.name}>Type</Label>
+              <Select
+                onValueChange={value => {
+                  field.handleChange(value as 'ACTION' | 'VALIDATION')
+                }}
+                value={field.state.value}
+              >
+                <SelectTrigger id={field.name}>
+                  <SelectValue placeholder="Select a type" />
+                </SelectTrigger>
+                <SelectContent>
+                  {Object.values(TemplateStepGroupType).map(type => (
+                    <SelectItem key={type} value={type as string}>
+                      {type}
+                    </SelectItem>
+                  ))}
+                </SelectContent>
+              </Select>
+              {field.state.meta.errors.map((error, index) => (
+                <p key={index} className="text-xs text-pink-500">
+                  {typeof error === 'string' ? error : error?.message || String(error)}
+                </p>
+              ))}
+            </div>
+          )
+        }}
+      </form.Field>
+      <form.Subscribe selector={formState => [formState.canSubmit, formState.isSubmitting]}>
+        {([canSubmit, isSubmitting]) => (
+          <Button type="submit" disabled={!canSubmit}>
+            {isSubmitting ? '...' : 'Save'}
+          </Button>
+        )}
+      </form.Subscribe>
+    </form>
+  )
+}