@ebay-dt/bonfire-cli 0.1.0-alpha.3 → 0.1.0

package/templates/instance/src/actions/prototypes.ts

@@ -0,0 +1,37 @@
+'use server'
+
+import type {
+  CreatePrototypeInput,
+  DuplicatePrototypeInput,
+  EditPrototypeInput,
+  PrototypeCommandInput,
+} from '@ebay-dt/bonfire-core'
+import { bonfire } from '@/bonfire'
+
+export async function createPrototype(input: CreatePrototypeInput) {
+  return bonfire.prototypes.actions.create(input)
+}
+
+export async function duplicatePrototype(input: DuplicatePrototypeInput) {
+  return bonfire.prototypes.actions.duplicate(input)
+}
+
+export async function editPrototype(input: EditPrototypeInput) {
+  return bonfire.prototypes.actions.edit(input)
+}
+
+export async function deletePrototype(input: PrototypeCommandInput) {
+  return bonfire.prototypes.actions.delete(input)
+}
+
+export async function savePrototype(input: PrototypeCommandInput) {
+  return bonfire.prototypes.actions.save(input)
+}
+
+export async function discardPrototype(input: PrototypeCommandInput) {
+  return bonfire.prototypes.actions.discard(input)
+}
+
+export async function deployPrototype(input: PrototypeCommandInput) {
+  return bonfire.prototypes.actions.deploy(input)
+}

package/templates/instance/src/app/(prototypes)/layout.tsx

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react'
+import { notFound } from 'next/navigation'
+import { AppHeader, PrototypeEnvironment } from '@ebay-dt/bonfire-react'
+import { bonfire } from '@/bonfire'
+import { openInClaudeCode, openInCursor } from '@/actions/agents'
+
+export default async function PrototypesLayout({
+  children,
+}: Readonly<{ children: ReactNode }>) {
+  const [{ headerProps }, prototype] = await Promise.all([
+    bonfire.auth.getAppLayoutModel(),
+    bonfire.prototypes.getCurrentRouteModel(),
+  ])
+
+  if (prototype === null) notFound()
+
+  const agentActions = { openInClaudeCode, openInCursor }
+  const header = <AppHeader {...headerProps} agentActions={agentActions} />
+
+  if (prototype.theme === undefined) {
+    return (
+      <>
+        {header}
+        {children}
+      </>
+    )
+  }
+
+  return (
+    <PrototypeEnvironment
+      prototypeUrl={prototype.url}
+      theme={prototype.theme}
+      themeRegistry={prototype.themeRegistry}
+      agentActions={agentActions}
+    >
+      {header}
+      {children}
+    </PrototypeEnvironment>
+  )
+}

package/templates/instance/src/app/(system)/api/prototype-dirty/route.ts

@@ -0,0 +1,4 @@
+import { bonfire } from '@/bonfire'
+
+export const runtime = 'nodejs'
+export const GET = bonfire.prototypes.routes.dirty

package/templates/instance/src/app/(system)/auth/login/route.ts

@@ -0,0 +1,4 @@
+import { bonfire } from '@/bonfire'
+
+export const runtime = 'nodejs'
+export const GET = bonfire.auth.routes.login

package/templates/instance/src/app/(system)/auth/logout/route.ts

@@ -0,0 +1,4 @@
+import { bonfire } from '@/bonfire'
+
+export const runtime = 'nodejs'
+export const POST = bonfire.auth.routes.logout

package/templates/instance/src/app/(system)/auth/status/route.ts

@@ -0,0 +1,4 @@
+import { bonfire } from '@/bonfire'
+
+export const runtime = 'nodejs'
+export const GET = bonfire.auth.routes.status

package/templates/instance/src/app/(system)/layout.tsx

@@ -0,0 +1,20 @@
+import type { ReactNode } from 'react'
+import { AppHeader } from '@ebay-dt/bonfire-react'
+import { bonfire } from '@/bonfire'
+import { openInClaudeCode, openInCursor } from '@/actions/agents'
+
+export default async function SystemLayout({
+  children,
+}: Readonly<{ children: ReactNode }>) {
+  const { headerProps } = await bonfire.auth.getAppLayoutModel()
+
+  return (
+    <>
+      <AppHeader
+        {...headerProps}
+        agentActions={{ openInClaudeCode, openInCursor }}
+      />
+      {children}
+    </>
+  )
+}

package/templates/instance/src/app/(system)/login/page.tsx

@@ -0,0 +1,14 @@
+import { GitHubCliLoginPage } from '@ebay-dt/bonfire-react'
+import { bonfire } from '@/bonfire'
+import type { Metadata } from 'next'
+
+export const metadata: Metadata = { title: 'Sign in — Design Sandbox' }
+
+type LoginPageProps = {
+  searchParams?: Promise<Record<string, string | string[] | undefined>>
+}
+
+export default async function LoginPage({ searchParams }: LoginPageProps) {
+  const model = await bonfire.auth.getLoginPageModel(searchParams)
+  return <GitHubCliLoginPage {...model} />
+}

package/templates/instance/src/app/(system)/page.tsx

@@ -0,0 +1,33 @@
+import { PrototypeDashboard } from '@ebay-dt/bonfire-react'
+import { bonfire } from '@/bonfire'
+import { openInClaudeCode, openInCursor } from '@/actions/agents'
+import type { Metadata } from 'next'
+
+interface PageProps {
+  searchParams: Promise<Record<string, string | string[] | undefined>>
+}
+
+export const metadata: Metadata = { title: 'Dashboard — Design Sandbox' }
+
+export default async function DashboardPage({ searchParams }: PageProps) {
+  const [dashboard, user] = await Promise.all([
+    bonfire.prototypes.getDashboardModel(searchParams),
+    bonfire.auth.getCurrentUser(),
+  ])
+  const lifecycleEnabled = process.env.NODE_ENV !== 'production'
+
+  return (
+    <PrototypeDashboard
+      {...dashboard}
+      user={user}
+      {...(lifecycleEnabled
+        ? {
+            agentActions: {
+              openInCursor,
+              openInClaudeCode,
+            },
+          }
+        : {})}
+    />
+  )
+}

package/templates/instance/src/app/api/items/[itemId]/route.ts

@@ -0,0 +1,21 @@
+import {
+  createItemDetailRoute,
+  type ItemRouteDiagnostic,
+} from '@ebay-dt/bonfire-preset-ebay/data/items/server'
+import { getItemById } from '@/lib/items/server'
+
+function onDiagnostic({ operation, code }: ItemRouteDiagnostic) {
+  console.error(`Item ${operation} failed (${code}).`)
+}
+
+const handleItemDetail = createItemDetailRoute(
+  { getItemById },
+  { onDiagnostic }
+)
+
+export async function GET(
+  request: Request,
+  context: RouteContext<'/api/items/[itemId]'>
+) {
+  return handleItemDetail(request, context)
+}

package/templates/instance/src/app/api/items/route.ts

@@ -0,0 +1,11 @@
+import {
+  createItemSearchRoute,
+  type ItemRouteDiagnostic,
+} from '@ebay-dt/bonfire-preset-ebay/data/items/server'
+import { searchItems } from '@/lib/items/server'
+
+function onDiagnostic({ operation, code }: ItemRouteDiagnostic) {
+  console.error(`Item ${operation} failed (${code}).`)
+}
+
+export const GET = createItemSearchRoute({ searchItems }, { onDiagnostic })

package/templates/instance/src/app/layout.tsx

@@ -0,0 +1,56 @@
+import type { Metadata } from 'next'
+import { NextLifecycleProvider } from '@ebay-dt/bonfire-next/client'
+import { EbayDesignSystemProvider } from '@ebay-dt/bonfire-preset-ebay'
+import { bonfire } from '@/bonfire'
+import {
+  createPrototype,
+  deletePrototype,
+  discardPrototype,
+  duplicatePrototype,
+  editPrototype,
+  deployPrototype,
+  savePrototype,
+} from '@/actions/prototypes'
+import '@ebay-dt/bonfire-react/styles/defaults.css'
+import '@ebay-dt/bonfire-preset-ebay/styles.css'
+
+export const metadata: Metadata = {
+  title: 'Design Sandbox',
+  description: 'eBay Design Technology prototype sandbox',
+  icons: { icon: 'https://fav.farm/🤙' },
+}
+
+export default async function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  const lifecycleEnabled = process.env.NODE_ENV !== 'production'
+  const { htmlProps, headerProps } = await bonfire.auth.getAppLayoutModel()
+
+  return (
+    <html lang="en" {...htmlProps}>
+      <body>
+        <EbayDesignSystemProvider>
+          <NextLifecycleProvider
+            enabled={lifecycleEnabled}
+            deploymentAvailable={bonfire.prototypes.capabilities.deployment}
+            user={headerProps.user}
+            dirtyEndpoint="/api/prototype-dirty"
+            actions={{
+              create: createPrototype,
+              duplicate: duplicatePrototype,
+              edit: editPrototype,
+              delete: deletePrototype,
+              save: savePrototype,
+              discard: discardPrototype,
+              ...(lifecycleEnabled ? { deploy: deployPrototype } : {}),
+            }}
+          >
+            {children}
+          </NextLifecycleProvider>
+        </EbayDesignSystemProvider>
+      </body>
+    </html>
+  )
+}

package/templates/instance/src/bonfire.ts

@@ -0,0 +1,25 @@
+import 'server-only'
+import { themes } from '@ebay-dt/bonfire-preset-ebay'
+import { projectPrototypeContext } from '@ebay-dt/bonfire-context'
+import {
+  createBonfireNext,
+  createDeploymentProvider,
+} from '@ebay-dt/bonfire-next/server'
+const deploymentProvider = createDeploymentProvider({
+  endpoint: 'https://dtsvc.vip.qa.ebay.com/dt/v1/bonfire-deploy',
+})
+
+export const bonfire = createBonfireNext({
+  appId: 'design-sandbox-next',
+  name: 'Design Sandbox',
+  auth: { github: { hostname: 'github.corp.ebay.com' } },
+  themes,
+  repositoryRoot: process.cwd(),
+  primaryBranch: process.env.BF_PROTOTYPE_BASE_BRANCH,
+  sessionSecret: process.env.BF_SESSION_SECRET,
+  disableAutoBranchSwitch: process.env.BF_DISABLE_AUTO_BRANCH_SWITCH,
+  deploymentProvider,
+  preparePrototypeFiles: async ({ prototypePath, repositoryRoot }) => {
+    await projectPrototypeContext({ repositoryRoot, prototypePath })
+  },
+})

package/templates/instance/src/lib/items/gateway-schemas.ts

@@ -0,0 +1,100 @@
+import { z } from 'zod'
+
+const nullableString = z.string().nullable().optional()
+const nullableNumber = z.number().nullable().optional()
+const gatewayImageSchema = z.object({ imageUrl: nullableString }).nullable()
+const gatewayPriceSchema = z
+  .object({
+    value: z.union([z.string(), z.number()]).nullable().optional(),
+    currency: nullableString,
+    convertedFromValue: z.union([z.string(), z.number()]).nullable().optional(),
+  })
+  .nullable()
+
+export const gatewayErrorsSchema = z
+  .array(z.object({ message: nullableString }).passthrough())
+  .optional()
+
+const gatewaySearchItemSchema = z
+  .object({
+    itemId: nullableString,
+    title: nullableString,
+    itemWebUrl: nullableString,
+    image: gatewayImageSchema.optional(),
+    condition: nullableString,
+    price: gatewayPriceSchema.optional(),
+    marketingPrice: z
+      .object({ originalPrice: gatewayPriceSchema.optional() })
+      .nullable()
+      .optional(),
+  })
+  .nullable()
+
+export const gatewaySearchResponseSchema = z.object({
+  data: z
+    .object({
+      itemsBySearch: z
+        .object({
+          total: nullableNumber,
+          limit: nullableNumber,
+          offset: nullableNumber,
+          items: z.array(gatewaySearchItemSchema).nullable().optional(),
+        })
+        .nullable()
+        .optional(),
+    })
+    .optional(),
+  errors: gatewayErrorsSchema,
+})
+
+const gatewayItemSchema = z.object({
+  itemId: nullableString,
+  legacyItemId: nullableString,
+  title: nullableString,
+  bidCount: nullableNumber,
+  watchCount: nullableNumber,
+  brand: nullableString,
+  categories: z
+    .array(z.object({ categoryId: nullableString }).nullable())
+    .nullable()
+    .optional(),
+  categoryPath: nullableString,
+  color: nullableString,
+  conditionId: nullableString,
+  condition: nullableString,
+  conditionDescription: nullableString,
+  gender: nullableString,
+  image: gatewayImageSchema.optional(),
+  additionalImages: z.array(gatewayImageSchema).nullable().optional(),
+  localizedAspects: z
+    .array(
+      z
+        .object({
+          type: nullableString,
+          name: nullableString,
+          value: nullableString,
+        })
+        .nullable()
+    )
+    .nullable()
+    .optional(),
+  price: gatewayPriceSchema.optional(),
+  shippingOptions: z
+    .array(
+      z
+        .object({
+          shippingCarrierCode: nullableString,
+          quantityUsedForEstimate: nullableNumber,
+          trademarkSymbol: nullableString,
+          type: nullableString,
+        })
+        .nullable()
+    )
+    .nullable()
+    .optional(),
+})
+
+export const gatewayItemResponseSchema = z.object({
+  data: z.object({ item: gatewayItemSchema.nullable().optional() }).optional(),
+  errors: gatewayErrorsSchema,
+})

package/templates/instance/src/lib/items/server.ts

@@ -0,0 +1,220 @@
+import 'server-only'
+
+import {
+  itemDetailSchema,
+  itemSearchPageSchema,
+  type ItemDetail,
+  type ItemSearchPage,
+} from '@ebay-dt/bonfire-preset-ebay/data/items'
+import {
+  gatewayItemResponseSchema,
+  gatewaySearchResponseSchema,
+} from './gateway-schemas'
+
+const DEFAULT_GATEWAY_URL = 'https://dtsvc.vip.qa.ebay.com/dt/v1/gateway-gql'
+
+const SEARCH_QUERY = `
+  query Search($q: String!, $limit: Int!, $offset: Int!) {
+    itemsBySearch(q: $q, limit: $limit, offset: $offset) {
+      items {
+        itemId title itemWebUrl image { imageUrl } condition
+        price { value currency }
+        marketingPrice { originalPrice { value currency } }
+      }
+      total limit offset
+    }
+  }
+`
+
+const ITEM_QUERY = `
+  query ItemById($id: String!) {
+    item(id: $id) {
+      itemId legacyItemId title bidCount watchCount brand
+      categories { categoryId }
+      categoryPath color conditionId condition conditionDescription gender
+      image { imageUrl }
+      additionalImages { imageUrl }
+      localizedAspects { type name value }
+      price { convertedFromValue value }
+      shippingOptions {
+        shippingCarrierCode quantityUsedForEstimate trademarkSymbol type
+      }
+    }
+  }
+`
+
+async function requestGateway(
+  operationName: string,
+  query: string,
+  variables: Record<string, unknown>,
+  signal: AbortSignal
+): Promise<unknown> {
+  const endpoint = process.env.DT_GATEWAY_URL?.trim() || DEFAULT_GATEWAY_URL
+  const apiKey = process.env.DT_GATEWAY_API_KEY?.trim()
+  const response = await fetch(endpoint, {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      ...(apiKey ? { Authorization: `Bearer ${apiKey}` } : {}),
+    },
+    body: JSON.stringify({ operationName, query, variables }),
+    cache: 'no-store',
+    signal,
+  })
+
+  let result: unknown
+  try {
+    result = await response.json()
+  } catch {
+    throw new Error(`The item gateway returned HTTP ${response.status}.`)
+  }
+
+  if (!response.ok) {
+    throw new Error(`The item gateway returned HTTP ${response.status}.`)
+  }
+  return result
+}
+
+function graphQLError(errors?: Array<{ message?: string | null }>) {
+  return errors
+    ?.map(({ message }) => message)
+    .filter(Boolean)
+    .join('; ')
+}
+
+function optionalNumber(value: string | number | null | undefined) {
+  if (value == null || value === '') return undefined
+  const number = typeof value === 'number' ? value : Number(value)
+  return Number.isFinite(number) ? number : undefined
+}
+
+export async function searchItems(
+  query: string,
+  limit: number,
+  offset: number,
+  signal: AbortSignal
+): Promise<ItemSearchPage> {
+  const result = gatewaySearchResponseSchema.parse(
+    await requestGateway(
+      'Search',
+      SEARCH_QUERY,
+      { q: query, limit, offset },
+      signal
+    )
+  )
+  const message = graphQLError(result.errors)
+  if (message) throw new Error(message)
+
+  const search = result.data?.itemsBySearch
+  return itemSearchPageSchema.parse({
+    total: search?.total ?? 0,
+    limit: search?.limit ?? limit,
+    offset: search?.offset ?? offset,
+    items:
+      search?.items?.flatMap((item) => {
+        if (!item?.itemId || !item.title || !item.itemWebUrl) return []
+        const priceValue = optionalNumber(item.price?.value)
+        const previousPriceValue = optionalNumber(
+          item.marketingPrice?.originalPrice?.value
+        )
+        return [
+          {
+            id: item.itemId,
+            title: item.title,
+            itemUrl: item.itemWebUrl,
+            imageUrl: item.image?.imageUrl ?? undefined,
+            condition: item.condition ?? undefined,
+            price:
+              priceValue != null && item.price?.currency
+                ? { value: priceValue, currency: item.price.currency }
+                : undefined,
+            previousPrice:
+              previousPriceValue != null &&
+              item.marketingPrice?.originalPrice?.currency
+                ? {
+                    value: previousPriceValue,
+                    currency: item.marketingPrice.originalPrice.currency,
+                  }
+                : undefined,
+          },
+        ]
+      }) ?? [],
+  })
+}
+
+export async function getItemById(
+  itemId: string,
+  signal: AbortSignal
+): Promise<ItemDetail | null> {
+  const result = gatewayItemResponseSchema.parse(
+    await requestGateway('ItemById', ITEM_QUERY, { id: itemId }, signal)
+  )
+  const message = graphQLError(result.errors)
+  if (message) throw new Error(message)
+  const item = result.data?.item
+  if (!item) return null
+  if (!item.itemId || !item.title) {
+    throw new Error('The item gateway returned an incomplete item.')
+  }
+
+  const imageUrls = [
+    item.image?.imageUrl,
+    ...(item.additionalImages?.map((image) => image?.imageUrl) ?? []),
+  ].filter((url): url is string => Boolean(url))
+  const priceValue = optionalNumber(item.price?.value)
+  const convertedFromValue = optionalNumber(item.price?.convertedFromValue)
+
+  return itemDetailSchema.parse({
+    id: item.itemId,
+    legacyId: item.legacyItemId ?? undefined,
+    title: item.title,
+    images: [...new Set(imageUrls)].map((url) => ({ url })),
+    price:
+      priceValue == null
+        ? undefined
+        : { value: priceValue, convertedFromValue },
+    conditionId: item.conditionId ?? undefined,
+    condition: item.condition ?? undefined,
+    conditionDescription: item.conditionDescription ?? undefined,
+    brand: item.brand ?? undefined,
+    color: item.color ?? undefined,
+    gender: item.gender ?? undefined,
+    categoryPath:
+      item.categoryPath
+        ?.split('|')
+        .map((part) => part.trim())
+        .filter(Boolean) ?? [],
+    categoryIds:
+      item.categories?.flatMap((category) =>
+        category?.categoryId ? [category.categoryId] : []
+      ) ?? [],
+    aspects:
+      item.localizedAspects?.flatMap((aspect) =>
+        aspect?.name && aspect.value
+          ? [
+              {
+                name: aspect.name,
+                value: aspect.value,
+                type: aspect.type ?? undefined,
+              },
+            ]
+          : []
+      ) ?? [],
+    shippingOptions:
+      item.shippingOptions?.flatMap((option) =>
+        option
+          ? [
+              {
+                carrierCode: option.shippingCarrierCode ?? undefined,
+                quantityUsedForEstimate:
+                  option.quantityUsedForEstimate ?? undefined,
+                trademarkSymbol: option.trademarkSymbol ?? undefined,
+                type: option.type ?? undefined,
+              },
+            ]
+          : []
+      ) ?? [],
+    bidCount: item.bidCount ?? undefined,
+    watchCount: item.watchCount ?? undefined,
+  })
+}

package/templates/instance/src/proxy.ts

@@ -0,0 +1,8 @@
+import { bonfire } from '@/bonfire'
+
+export const proxy = bonfire.auth.proxy
+
+export const config = {
+  // Run on all routes except Next.js internals and static assets
+  matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'],
+}