@env-hopper/frontend-core 2.0.1-alpha → 2.0.1-alpha-20260224145405

package/src/routes/admin/app-for-catalog/$id.tsx

@@ -0,0 +1,571 @@
+import { zodResolver } from '@hookform/resolvers/zod'
+import { useMutation, useQueryClient } from '@tanstack/react-query'
+import { createFileRoute, useNavigate } from '@tanstack/react-router'
+import type { Control, FieldValues } from 'react-hook-form'
+import { useForm } from 'react-hook-form'
+import { z } from 'zod'
+import { useTRPC } from '~/api/infra/trpc'
+import { IconPickerField } from '~/components/IconPickerField'
+import type { Screenshot } from '~/modules/appCatalog/ScreenshotManager'
+import { ScreenshotManager } from '~/modules/appCatalog/ScreenshotManager'
+import { ApprovalMethodSelector } from '~/modules/approvalMethod/ApprovalMethodSelector'
+import { AccessRequestFormFields } from '~/modules/approvalMethod/AccessRequestFormFields'
+import { Button } from '~/ui/button'
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardHeader,
+  CardTitle,
+} from '~/ui/card'
+import {
+  Form,
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from '~/ui/form'
+import { Input } from '~/ui/input'
+import { Textarea } from '~/ui/textarea'
+
+export const Route = createFileRoute('/admin/app-for-catalog/$id')({
+  component: RouteComponent,
+  async loader({ params, context }) {
+    const { id } = params
+    const { trpcClient } = context
+
+    const app =
+      id === 'new'
+        ? null
+        : await trpcClient.appCatalogAdmin.getBySlug.query({ slug: id })
+
+    return { app }
+  },
+  staticData: {
+    breadcrumb: {
+      title: 'Edit App',
+    },
+  },
+})
+
+type AccessType =
+  | 'none'
+  | 'bot'
+  | 'ticketing'
+  | 'email'
+  | 'self-service'
+  | 'documentation'
+  | 'manual'
+
+type ValidAccessType = Exclude<AccessType, 'none'>
+
+const formSchema = z.object({
+  slug: z
+    .string()
+    .min(1, 'Slug is required')
+    .regex(
+      /^[a-z0-9-]+$/,
+      'Slug must contain only lowercase letters, numbers, and hyphens',
+    ),
+  displayName: z.string().min(1, 'Display name is required'),
+  description: z.string().min(1, 'Description is required'),
+  accessType: z
+    .enum([
+      'none',
+      'self-service',
+      'ticketing',
+      'bot',
+      'email',
+      'documentation',
+      'manual',
+    ])
+    .default('none'),
+  // Access method fields
+  accessUrl: z.string().url('Must be a valid URL').optional().or(z.literal('')),
+  accessInstructions: z.string().optional(),
+  iconName: z.string().optional(),
+  appUrl: z.string().url('Must be a valid URL').optional().or(z.literal('')),
+  notes: z.string().optional(),
+  links: z.string().default('[]'),
+  // Approval Method fields
+  hasApproval: z.boolean().default(false),
+  approvalMethodId: z.string().optional(),
+  accessRequest: z
+    .object({
+      approvalMethodId: z.string().optional(),
+      comments: z.string().optional(),
+      requestPrompt: z.string().optional(),
+      postApprovalInstructions: z.string().optional(),
+      roles: z
+        .array(
+          z.object({ name: z.string(), description: z.string().optional() }),
+        )
+        .optional(),
+      approvers: z
+        .array(
+          z.object({ displayName: z.string(), contact: z.string().optional() }),
+        )
+        .optional(),
+      urls: z
+        .array(z.object({ label: z.string().optional(), url: z.string() }))
+        .optional(),
+      whoToReachOut: z.string().optional(),
+    })
+    .optional(),
+})
+
+type FormData = z.infer<typeof formSchema>
+
+function RouteComponent() {
+  const { id } = Route.useParams()
+  const navigate = useNavigate()
+  const trpc = useTRPC()
+  const queryClient = useQueryClient()
+  const loaderData = Route.useLoaderData()
+  const isNew = id === 'new'
+
+  const app = loaderData.app
+
+  const accessRequest = app?.accessRequest as any
+  const hasApproval = !!accessRequest
+
+  const form = useForm<FormData>({
+    resolver: zodResolver(formSchema as unknown as never),
+    defaultValues: app
+      ? {
+          slug: app.slug || '',
+          displayName: app.displayName || '',
+          description: app.description || '',
+          accessUrl: (app.access as { url?: string } | undefined)?.url || '',
+          accessInstructions:
+            (app.access as { instructions?: string } | undefined)
+              ?.instructions || '',
+          iconName: app.iconName || '',
+          appUrl: app.appUrl || '',
+          notes: app.notes || '',
+          links: JSON.stringify(
+            (app as { links?: unknown }).links || [],
+            null,
+            2,
+          ),
+          hasApproval,
+          approvalMethodId: accessRequest?.approvalMethodId,
+          accessRequest: hasApproval ? accessRequest : undefined,
+        }
+      : {
+          slug: '',
+          displayName: '',
+          description: '',
+          accessUrl: '',
+          accessInstructions: '',
+          iconName: '',
+          appUrl: '',
+          notes: '',
+          links: '[]',
+          hasApproval: false,
+          approvalMethodId: undefined,
+          accessRequest: undefined,
+        },
+  })
+  const formControl = form.control as unknown as Control<FieldValues>
+
+  // Watch form values for reactivity
+  const hasApprovalValue = form.watch('hasApproval')
+  const approvalMethodIdValue = form.watch('approvalMethodId')
+
+  const createMutation = useMutation({
+    ...trpc.appCatalogAdmin.create.mutationOptions(),
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: trpc.appCatalogAdmin.list.queryKey(),
+      })
+      navigate({ to: '/admin/app-for-catalog' })
+    },
+  })
+
+  const updateMutation = useMutation({
+    ...trpc.appCatalogAdmin.update.mutationOptions(),
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: trpc.appCatalogAdmin.list.queryKey(),
+      })
+      navigate({ to: '/admin/app-for-catalog' })
+    },
+  })
+
+  const updateScreenshotsMutation = useMutation({
+    ...trpc.appCatalogAdmin.update.mutationOptions(),
+    onSuccess: () => {
+      queryClient.invalidateQueries({
+        queryKey: trpc.appCatalogAdmin.list.queryKey(),
+      })
+      queryClient.invalidateQueries({
+        queryKey: trpc.appCatalogAdmin.getBySlug.queryKey({ slug: id }),
+      })
+    },
+  })
+
+  const onSubmit = (formData: FormData) => {
+    try {
+      type AppLink = { displayName?: string; url: string }
+      const linksData: unknown = JSON.parse(formData.links)
+      const links: Array<AppLink> | undefined = Array.isArray(linksData)
+        ? linksData.filter(
+            (l): l is AppLink =>
+              typeof l === 'object' &&
+              l !== null &&
+              'url' in l &&
+              typeof (l as { url?: unknown }).url === 'string',
+          )
+        : undefined
+
+      // Only create access object if type is not 'none'
+      const access =
+        formData.accessType !== 'none'
+          ? ({
+              type: formData.accessType,
+              ...(formData.accessUrl && { url: formData.accessUrl }),
+              ...(formData.accessInstructions && {
+                instructions: formData.accessInstructions,
+              }),
+            } as {
+              type: ValidAccessType
+            } & Record<string, unknown>)
+          : undefined
+
+      // Process approval details
+      let accessRequestPayload: any = undefined
+      if (
+        formData.hasApproval &&
+        formData.approvalMethodId &&
+        formData.accessRequest
+      ) {
+        accessRequestPayload = {
+          approvalMethodId: formData.approvalMethodId,
+          comments: formData.accessRequest.comments || undefined,
+          requestPrompt: formData.accessRequest.requestPrompt || undefined,
+          postApprovalInstructions:
+            formData.accessRequest.postApprovalInstructions || undefined,
+          roles: formData.accessRequest.roles?.length
+            ? formData.accessRequest.roles
+            : undefined,
+          approvers: formData.accessRequest.approvers?.length
+            ? formData.accessRequest.approvers
+            : undefined,
+          urls: formData.accessRequest.urls?.length
+            ? formData.accessRequest.urls
+            : undefined,
+          whoToReachOut: formData.accessRequest.whoToReachOut || undefined,
+        }
+      }
+
+      const payload = {
+        slug: formData.slug,
+        displayName: formData.displayName,
+        description: formData.description,
+        access,
+        iconName: formData.iconName || undefined,
+        appUrl: formData.appUrl || undefined,
+        notes: formData.notes || undefined,
+        links: links && links.length > 0 ? links : undefined,
+        accessRequest: accessRequestPayload,
+      }
+
+      if (isNew) {
+        createMutation.mutate(payload)
+      } else {
+        if (!app?.id) {
+          throw new Error('App ID is required for update')
+        }
+        updateMutation.mutate({
+          id: app.id,
+          ...payload,
+        })
+      }
+    } catch (error) {
+      form.setError('links', {
+        type: 'validate',
+        message:
+          error instanceof Error
+            ? error.message
+            : 'Invalid JSON in form fields',
+      })
+    }
+  }
+
+  const isPending = createMutation.isPending || updateMutation.isPending
+
+  return (
+    <div className="flex-1 flex flex-col">
+      <div className="border-b px-6 py-4 flex items-center justify-between">
+        <h2 className="text-xl font-semibold">
+          {isNew ? 'Create New App' : `Edit: ${app?.displayName || ''}`}
+        </h2>
+        <Button
+          variant="outline"
+          onClick={() => navigate({ to: '/admin/app-for-catalog' })}
+        >
+          Back to List
+        </Button>
+      </div>
+
+      <div className="flex-1 overflow-auto p-6">
+        <div className="max-w-4xl space-y-6">
+          <Card>
+            <CardHeader>
+              <CardTitle>App Details</CardTitle>
+              <CardDescription>
+                Configure the app catalog entry with all necessary information
+              </CardDescription>
+            </CardHeader>
+            <CardContent>
+              <Form {...form}>
+                <form
+                  onSubmit={form.handleSubmit(onSubmit)}
+                  className="space-y-6"
+                >
+                  <div className="grid grid-cols-2 gap-4">
+                    <FormField
+                      control={formControl}
+                      name="slug"
+                      render={({ field }) => (
+                        <FormItem>
+                          <FormLabel>Slug (URL identifier) *</FormLabel>
+                          <FormControl>
+                            <Input placeholder="my-app" {...field} />
+                          </FormControl>
+                          <FormDescription>
+                            Lowercase letters, numbers, and hyphens only
+                          </FormDescription>
+                          <FormMessage />
+                        </FormItem>
+                      )}
+                    />
+
+                    <FormField
+                      control={formControl}
+                      name="displayName"
+                      render={({ field }) => (
+                        <FormItem>
+                          <FormLabel>Display Name *</FormLabel>
+                          <FormControl>
+                            <Input placeholder="My Application" {...field} />
+                          </FormControl>
+                          <FormMessage />
+                        </FormItem>
+                      )}
+                    />
+                  </div>
+
+                  <FormField
+                    control={formControl}
+                    name="description"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>Description *</FormLabel>
+                        <FormControl>
+                          <Textarea
+                            placeholder="Enter app description..."
+                            rows={3}
+                            {...field}
+                          />
+                        </FormControl>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+
+                  <div className="grid grid-cols-2 gap-4">
+                    <FormField
+                      control={formControl}
+                      name="iconName"
+                      render={({ field }) => (
+                        <FormItem>
+                          <FormControl>
+                            <IconPickerField
+                              value={field.value}
+                              onChange={field.onChange}
+                              placeholder="Select an icon..."
+                            />
+                          </FormControl>
+                          <FormMessage />
+                        </FormItem>
+                      )}
+                    />
+                  </div>
+
+                  <FormField
+                    control={formControl}
+                    name="appUrl"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>App URL</FormLabel>
+                        <FormControl>
+                          <Input
+                            type="url"
+                            placeholder="https://..."
+                            {...field}
+                          />
+                        </FormControl>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+
+                  <FormField
+                    control={formControl}
+                    name="notes"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>Notes</FormLabel>
+                        <FormControl>
+                          <Textarea
+                            placeholder="Any additional notes..."
+                            rows={2}
+                            {...field}
+                          />
+                        </FormControl>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+
+                  <FormField
+                    control={formControl}
+                    name="links"
+                    render={({ field }) => (
+                      <FormItem>
+                        <FormLabel>Links (JSON)</FormLabel>
+                        <FormControl>
+                          <Textarea
+                            placeholder={`[\n  { "displayName": "Documentation", "url": "https://..." },\n  { "url": "https://..." }\n]`}
+                            rows={5}
+                            className="font-mono text-sm"
+                            {...field}
+                          />
+                        </FormControl>
+                        <FormDescription>
+                          Array of link objects with url and optional
+                          displayName
+                        </FormDescription>
+                        <FormMessage />
+                      </FormItem>
+                    )}
+                  />
+
+                  {/* Approval Configuration */}
+                  <div className="pt-6 border-t">
+                    <div className="space-y-4">
+                      <FormField
+                        control={formControl}
+                        name="hasApproval"
+                        render={({ field }) => (
+                          <FormItem className="flex items-center gap-2">
+                            <FormControl>
+                              <input
+                                type="checkbox"
+                                checked={field.value}
+                                onChange={field.onChange}
+                                className="h-4 w-4"
+                              />
+                            </FormControl>
+                            <FormLabel className="!mt-0">
+                              Configure Approval
+                            </FormLabel>
+                          </FormItem>
+                        )}
+                      />
+
+                      {hasApprovalValue && (
+                        <div className="space-y-4 pl-6">
+                          <FormField
+                            control={formControl}
+                            name="approvalMethodId"
+                            render={({ field }) => (
+                              <FormItem>
+                                <FormLabel>Approval Method *</FormLabel>
+                                <FormControl>
+                                  <ApprovalMethodSelector
+                                    value={field.value}
+                                    onChange={field.onChange}
+                                  />
+                                </FormControl>
+                                <FormMessage />
+                              </FormItem>
+                            )}
+                          />
+
+                          <AccessRequestFormFields
+                            control={formControl}
+                            approvalMethodId={approvalMethodIdValue}
+                          />
+                        </div>
+                      )}
+                    </div>
+                  </div>
+
+                  <div className="flex gap-2 pt-4">
+                    <Button type="submit" disabled={isPending}>
+                      {isPending
+                        ? 'Saving...'
+                        : isNew
+                          ? 'Create App'
+                          : 'Save Changes'}
+                    </Button>
+                    <Button
+                      type="button"
+                      variant="outline"
+                      onClick={() => navigate({ to: '/admin/app-for-catalog' })}
+                    >
+                      Cancel
+                    </Button>
+                  </div>
+                </form>
+              </Form>
+            </CardContent>
+          </Card>
+
+          {!isNew && (
+            <ScreenshotManager
+              screenshots={(
+                (app as { screenshotIds?: Array<string> }).screenshotIds || []
+              ).map((screenshotId) => ({
+                id: screenshotId,
+                url: `/api/assets/${screenshotId}`,
+              }))}
+              onAddScreenshot={async (file) => {
+                const formData = new FormData()
+                formData.append('asset', file)
+                formData.append('name', `${app?.id ?? 'app'}-${file.name}`)
+                formData.append('assetType', 'screenshot')
+
+                const response = await fetch('/api/assets/upload', {
+                  method: 'POST',
+                  body: formData,
+                })
+
+                if (!response.ok) {
+                  throw new Error('Failed to upload screenshot')
+                }
+
+                const data: { id: string } = await response.json()
+                return { id: data.id, url: `/api/assets/${data.id}` }
+              }}
+              onScreenshotsChange={(screenshots: Array<Screenshot>) => {
+                if (!app?.id) {
+                  throw new Error('App ID is required for screenshot update')
+                }
+                updateScreenshotsMutation.mutate({
+                  id: app.id,
+                  screenshotIds: screenshots.map((s) => s.id),
+                })
+              }}
+            />
+          )}
+        </div>
+      </div>
+    </div>
+  )
+}

package/src/routes/admin/app-for-catalog/index.tsx

@@ -0,0 +1,19 @@
+import { createFileRoute } from '@tanstack/react-router'
+import { AppCatalogAdminPage } from '~/modules/appCatalog/AppCatalogAdminPage'
+
+export const Route = createFileRoute('/admin/app-for-catalog/')({
+  component: RouteComponent,
+})
+
+function RouteComponent() {
+  return (
+    <div className="flex-1 flex flex-col">
+      <div className="border-b px-6 py-4">
+        <h2 className="text-xl font-semibold">App Catalog</h2>
+      </div>
+      <div className="flex-1 overflow-auto p-6">
+        <AppCatalogAdminPage />
+      </div>
+    </div>
+  )
+}

package/src/routes/admin/app-for-catalog.tsx

@@ -0,0 +1,12 @@
+import { Outlet, createFileRoute } from '@tanstack/react-router'
+
+export const Route = createFileRoute('/admin/app-for-catalog')({
+  component: AppCatalogLayoutRoute,
+  staticData: {
+    breadcrumb: { title: 'App Catalog' },
+  },
+})
+
+function AppCatalogLayoutRoute() {
+  return <Outlet />
+}