feat: adding kotlin sample

pengying · pengying · commit 9e09ccc943af · 2026-02-12T18:52:48.000-08:00
diff --git a/.gitignore b/.gitignore
@@ -36,6 +36,9 @@ local.properties
 # CLI build output
 cli/dist/
 
+# Frontend build output
+samples/frontend/dist/
+
 # Figma design tokens (local reference only)
 mintlify/tokens/
 
diff --git a/samples/README.md b/samples/README.md
@@ -1,6 +1,6 @@
 # Grid API Samples
 
-Sample applications demonstrating the Grid API payout flow — creating a customer, linking a bank account, creating and executing a quote, and simulating funding in the sandbox.
+Sample applications demonstrating the Grid API payout flow — creating a customer, linking a bank account, creating a quote, and simulating funding in the sandbox.
 
 ## Structure
 
@@ -23,7 +23,6 @@ Each backend must implement the same API contract:
 | POST | `/api/customers` | Create a customer |
 | POST | `/api/customers/{id}/external-accounts` | Create an external account |
 | POST | `/api/quotes` | Create a quote |
-| POST | `/api/quotes/{id}/execute` | Execute a quote |
 | POST | `/api/sandbox/send-funds` | Simulate sandbox funding |
 | POST | `/api/webhooks` | Receive webhook events from Grid |
 | GET  | `/api/sse` | Stream webhook events to the frontend via SSE |
diff --git a/samples/frontend/src/App.tsx b/samples/frontend/src/App.tsx
@@ -4,7 +4,6 @@ import WebhookStream from './components/WebhookStream'
 import CreateCustomer from './steps/CreateCustomer'
 import CreateExternalAccount from './steps/CreateExternalAccount'
 import CreateQuote from './steps/CreateQuote'
-import ExecuteQuote from './steps/ExecuteQuote'
 import SandboxFund from './steps/SandboxFund'
 
 export default function App() {
@@ -48,6 +47,7 @@ export default function App() {
       summary: quoteId ? `ID: ${quoteId}` : null,
       content: (
         <CreateQuote
+          customerId={customerId}
           externalAccountId={externalAccountId}
           disabled={activeStep !== 2}
           onComplete={(data) => {
@@ -58,23 +58,12 @@ export default function App() {
       ),
     },
     {
-      title: '4. Execute Quote',
-      summary: activeStep > 3 ? 'Executed' : null,
-      content: (
-        <ExecuteQuote
-          quoteId={quoteId}
-          disabled={activeStep !== 3}
-          onComplete={() => advance()}
-        />
-      ),
-    },
-    {
-      title: '5. Sandbox Fund',
-      summary: activeStep > 4 ? 'Funded' : null,
+      title: '4. Simulate Funding (Sandbox Only)',
+      summary: activeStep > 3 ? 'Funded' : null,
       content: (
         <SandboxFund
           quoteId={quoteId}
-          disabled={activeStep !== 4}
+          disabled={activeStep !== 3}
           onComplete={() => advance()}
         />
       ),
@@ -85,7 +74,7 @@ export default function App() {
     <div className="min-h-screen bg-gray-950 text-gray-100">
       <header className="border-b border-gray-800 px-6 py-4">
         <h1 className="text-xl font-bold">Grid API Sample</h1>
-        <p className="text-sm text-gray-400">Payout flow: USDC &rarr; USD via external bank account</p>
+        <p className="text-sm text-gray-400">Send a real time payment to a US bank account funded with USDC</p>
       </header>
       <div className="flex">
         <main className="w-3/5 p-6 border-r border-gray-800 min-h-[calc(100vh-73px)]">
diff --git a/samples/frontend/src/components/JsonEditor.tsx b/samples/frontend/src/components/JsonEditor.tsx
@@ -25,7 +25,7 @@ export default function JsonEditor({ value, onChange, disabled }: JsonEditorProp
         onChange={(e) => onChange(e.target.value)}
         disabled={disabled}
         spellCheck={false}
-        className="w-full h-48 bg-gray-900 text-green-400 font-mono text-sm p-3 rounded-lg border border-gray-700 focus:border-blue-500 focus:outline-none resize-y disabled:opacity-50"
+        className="w-full h-72 bg-gray-900 text-green-400 font-mono text-sm p-3 rounded-lg border border-gray-700 focus:border-blue-500 focus:outline-none resize-y disabled:opacity-50"
       />
       {error && (
         <p className="text-red-400 text-xs mt-1">Invalid JSON: {error}</p>
diff --git a/samples/frontend/src/components/ResponsePanel.tsx b/samples/frontend/src/components/ResponsePanel.tsx
@@ -20,7 +20,7 @@ export default function ResponsePanel({ response, error }: ResponsePanelProps) {
       </button>
       {expanded && (
         <pre
-          className={`text-sm font-mono p-3 rounded-lg overflow-auto max-h-64 ${
+          className={`text-sm font-mono p-3 rounded-lg overflow-auto max-h-96 ${
             error
               ? 'bg-red-950 text-red-300 border border-red-800'
               : 'bg-gray-900 text-gray-300 border border-gray-700'
diff --git a/samples/frontend/src/components/StepWizard.tsx b/samples/frontend/src/components/StepWizard.tsx
@@ -1,4 +1,4 @@
-import { ReactNode } from 'react'
+import { ReactNode, useState } from 'react'
 
 interface Step {
   title: string
@@ -12,20 +12,35 @@ interface StepWizardProps {
 }
 
 export default function StepWizard({ steps, activeStep }: StepWizardProps) {
+  const [expandedSteps, setExpandedSteps] = useState<Set<number>>(new Set())
+
+  const toggleStep = (index: number) => {
+    setExpandedSteps(prev => {
+      const next = new Set(prev)
+      if (next.has(index)) next.delete(index)
+      else next.add(index)
+      return next
+    })
+  }
+
   return (
     <div className="space-y-4">
       {steps.map((step, i) => {
         const isCompleted = i < activeStep
         const isActive = i === activeStep
         const isFuture = i > activeStep
+        const isExpanded = expandedSteps.has(i)
 
         return (
           <div key={i} className={`rounded-lg border ${
             isActive ? 'border-blue-600 bg-gray-900' :
             isCompleted ? 'border-green-800 bg-gray-900/50' :
             'border-gray-800 bg-gray-900/30 opacity-50'
           }`}>
-            <div className="flex items-center gap-3 p-4">
+            <div
+              className={`flex items-center gap-3 p-4 ${isCompleted ? 'cursor-pointer select-none' : ''}`}
+              onClick={() => isCompleted && toggleStep(i)}
+            >
               <div className={`flex items-center justify-center w-7 h-7 rounded-full text-sm font-bold ${
                 isCompleted ? 'bg-green-700 text-green-200' :
                 isActive ? 'bg-blue-600 text-white' :
@@ -41,9 +56,14 @@ export default function StepWizard({ steps, activeStep }: StepWizardProps) {
                   {step.summary}
                 </span>
               )}
+              {isCompleted && (
+                <span className={`text-xs text-gray-500 ${step.summary ? 'ml-2' : 'ml-auto'}`}>
+                  {isExpanded ? '\u25BC' : '\u25B6'}
+                </span>
+              )}
             </div>
-            {isActive && (
-              <div className="px-4 pb-4">
+            {(isActive || isCompleted) && (
+              <div className={`px-4 pb-4 ${isCompleted && !isExpanded ? 'hidden' : ''}`}>
                 {step.content}
               </div>
             )}
diff --git a/samples/frontend/src/steps/CreateCustomer.tsx b/samples/frontend/src/steps/CreateCustomer.tsx
@@ -4,8 +4,18 @@ import ResponsePanel from '../components/ResponsePanel'
 import { apiPost } from '../lib/api'
 
 const DEFAULT_BODY = JSON.stringify({
+  platformCustomerId: `cust_${Math.random().toString(36).slice(2, 10)}`,
   customerType: "INDIVIDUAL",
-  platformCustomerId: `sample-customer-${Date.now()}`
+  fullName: "Jack Doe",
+  birthDate: "1992-03-25",
+  address: {
+    line1: "123 Pine Street",
+    line2: "Unit 501",
+    city: "Seattle",
+    state: "WA",
+    postalCode: "98101",
+    country: "US"
+  }
 }, null, 2)
 
 interface Props {
diff --git a/samples/frontend/src/steps/CreateExternalAccount.tsx b/samples/frontend/src/steps/CreateExternalAccount.tsx
@@ -17,11 +17,29 @@ export default function CreateExternalAccount({ customerId, onComplete, disabled
 
   useEffect(() => {
     setBody(JSON.stringify({
+      customerId: customerId ?? "<customer-id>",
       currency: "USD",
+      platformAccountId: `acct_${Math.random().toString(36).slice(2, 10)}`,
       accountInfo: {
-        accountType: "CHECKING",
-        routingNumber: "021000021",
-        accountNumber: "123456789"
+        accountType: "US_ACCOUNT",
+        accountNumber: "12345678901",
+        routingNumber: "123456789",
+        accountCategory: "CHECKING",
+        bankName: "Chase Bank"
+      },
+      beneficiary: {
+        beneficiaryType: "INDIVIDUAL",
+        fullName: "Jack Doe",
+        birthDate: "1992-03-25",
+        nationality: "US",
+        address: {
+          line1: "123 Pine Street",
+          line2: "Unit 501",
+          city: "Seattle",
+          state: "WA",
+          postalCode: "98101",
+          country: "US"
+        }
       }
     }, null, 2))
   }, [customerId])
diff --git a/samples/frontend/src/steps/CreateQuote.tsx b/samples/frontend/src/steps/CreateQuote.tsx
@@ -4,12 +4,13 @@ import ResponsePanel from '../components/ResponsePanel'
 import { apiPost } from '../lib/api'
 
 interface Props {
+  customerId: string | null
   externalAccountId: string | null
   onComplete: (response: Record<string, unknown>) => void
   disabled: boolean
 }
 
-export default function CreateQuote({ externalAccountId, onComplete, disabled }: Props) {
+export default function CreateQuote({ customerId, externalAccountId, onComplete, disabled }: Props) {
   const [body, setBody] = useState('')
   const [response, setResponse] = useState<string | null>(null)
   const [error, setError] = useState<string | null>(null)
@@ -19,7 +20,8 @@ export default function CreateQuote({ externalAccountId, onComplete, disabled }:
     setBody(JSON.stringify({
       source: {
         sourceType: "REALTIME_FUNDING",
-        currency: "USDC"
+        currency: "USDC",
+        customerId: customerId ?? "<customer-id>"
       },
       destination: {
         destinationType: "ACCOUNT",
@@ -28,7 +30,7 @@ export default function CreateQuote({ externalAccountId, onComplete, disabled }:
       lockedCurrencyAmount: 1000,
       lockedCurrencySide: "SENDING"
     }, null, 2))
-  }, [externalAccountId])
+  }, [customerId, externalAccountId])
 
   const submit = async () => {
     setLoading(true)
diff --git a/samples/frontend/tsconfig.tsbuildinfo b/samples/frontend/tsconfig.tsbuildinfo
@@ -0,0 +1 @@
+{"root":["./src/app.tsx","./src/main.tsx","./src/vite-env.d.ts","./src/components/jsoneditor.tsx","./src/components/responsepanel.tsx","./src/components/stepwizard.tsx","./src/components/webhookstream.tsx","./src/lib/api.ts","./src/steps/createcustomer.tsx","./src/steps/createexternalaccount.tsx","./src/steps/createquote.tsx","./src/steps/executequote.tsx","./src/steps/sandboxfund.tsx"],"version":"5.9.3"}
diff --git a/samples/kotlin/README.md b/samples/kotlin/README.md
@@ -9,8 +9,7 @@ This sample walks through a complete payout:
 1. **Create Customer** — Register an individual customer on the platform
 2. **Create External Account** — Link a USD bank account to the customer
 3. **Create Quote** — Get a real-time quote for USDC to USD conversion
-4. **Execute Quote** — Initiate the payment
-5. **Sandbox Fund** — Simulate funding to complete the transaction
+4. **Sandbox Fund** — Simulate funding to complete the transaction
 
 Webhook events are streamed to the frontend in real time via Server-Sent Events (SSE).
 
diff --git a/samples/kotlin/build.gradle.kts b/samples/kotlin/build.gradle.kts
@@ -35,7 +35,6 @@ application {
 }
 
 repositories {
-    mavenLocal()
     mavenCentral()
 }
 
@@ -49,10 +48,11 @@ dependencies {
     implementation("io.ktor:ktor-server-config-yaml:3.1.3")
 
     // Grid Kotlin SDK
-    implementation("com.grid.api:grid-kotlin:0.0.1")
+    implementation("com.lightspark.grid:lightspark-grid-kotlin:0.5.0")
 
     // JSON
     implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.18.2")
+    implementation("com.fasterxml.jackson.datatype:jackson-datatype-jsr310:2.18.2")
 
     // Environment
     implementation("io.github.cdimascio:dotenv-kotlin:6.4.1")
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/Application.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/Application.kt
@@ -5,6 +5,7 @@ import io.ktor.http.*
 import io.ktor.server.application.*
 import io.ktor.server.plugins.cors.routing.*
 import io.ktor.server.http.content.*
+import io.ktor.server.request.*
 import io.ktor.server.routing.*
 import io.ktor.server.sse.*
 
@@ -23,6 +24,15 @@ fun Application.module() {
         anyHost()
     }
     install(SSE)
+
+    intercept(ApplicationCallPipeline.Monitoring) {
+        val method = call.request.httpMethod.value
+        val path = call.request.path()
+        if (path.startsWith("/api/") && method != "OPTIONS") {
+            Log.incoming(method, path)
+        }
+    }
+
     routing {
         customerRoutes()
         externalAccountRoutes()
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/GridClientBuilder.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/GridClientBuilder.kt
@@ -1,11 +1,11 @@
 package com.grid.sample
 
-import com.grid.api.client.GridClient
-import com.grid.api.client.okhttp.GridOkHttpClient
+import com.lightspark.grid.client.LightsparkGridClient
+import com.lightspark.grid.client.okhttp.LightsparkGridOkHttpClient
 
 object GridClientBuilder {
-    val client: GridClient by lazy {
-        GridOkHttpClient.builder()
+    val client: LightsparkGridClient by lazy {
+        LightsparkGridOkHttpClient.builder()
             .username(Config.apiTokenId)
             .password(Config.apiClientSecret)
             .build()
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/JsonUtils.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/JsonUtils.kt
@@ -2,10 +2,13 @@ package com.grid.sample
 
 import com.fasterxml.jackson.databind.ObjectMapper
 import com.fasterxml.jackson.databind.SerializationFeature
+import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule
 import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
 
 object JsonUtils {
     val mapper: ObjectMapper = jacksonObjectMapper().apply {
+        registerModule(JavaTimeModule())
+        disable(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS)
         enable(SerializationFeature.INDENT_OUTPUT)
     }
 
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/Log.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/Log.kt
@@ -0,0 +1,61 @@
+package com.grid.sample
+
+import org.slf4j.LoggerFactory
+
+object Log {
+    private val logger = LoggerFactory.getLogger("grid-sample")
+
+    private const val RESET = "\u001B[0m"
+    private const val CYAN = "\u001B[36m"
+    private const val GREEN = "\u001B[32m"
+    private const val YELLOW = "\u001B[33m"
+    private const val MAGENTA = "\u001B[35m"
+    private const val RED = "\u001B[31m"
+    private const val DIM = "\u001B[2m"
+    private const val BOLD = "\u001B[1m"
+
+    fun incoming(method: String, path: String, body: String? = null) {
+        logger.info("${CYAN}${BOLD}⬇ FE REQUEST${RESET}  ${CYAN}$method $path${RESET}")
+        body?.let {
+            if (it.isNotBlank()) logger.info("${DIM}  Body: ${prettyOneLine(it)}${RESET}")
+        }
+    }
+
+    fun gridRequest(operation: String, detail: String? = null) {
+        logger.info("${YELLOW}${BOLD}➡ GRID API${RESET}   ${YELLOW}$operation${RESET}")
+        detail?.let {
+            logger.info("${DIM}  Params: ${prettyOneLine(it)}${RESET}")
+        }
+    }
+
+    fun gridResponse(operation: String, response: String) {
+        logger.info("${GREEN}${BOLD}⬅ GRID RESP${RESET}  ${GREEN}$operation${RESET}")
+        logger.info("${DIM}  ${prettyOneLine(response)}${RESET}")
+    }
+
+    fun gridError(operation: String, error: Exception) {
+        logger.error("${RED}${BOLD}✘ GRID ERR${RESET}   ${RED}$operation: ${error.message}${RESET}")
+    }
+
+    fun webhook(body: String) {
+        logger.info("${MAGENTA}${BOLD}⚡ WEBHOOK${RESET}   ${MAGENTA}${prettyOneLine(body)}${RESET}")
+    }
+
+    fun webhookSignatureResult(valid: Boolean) {
+        if (valid) {
+            logger.info("${GREEN}  Signature: valid${RESET}")
+        } else {
+            logger.warn("${RED}  Signature: INVALID${RESET}")
+        }
+    }
+
+    fun response(status: Int) {
+        val color = if (status < 400) GREEN else RED
+        logger.info("${color}${BOLD}⬆ FE RESPONSE${RESET} ${color}$status${RESET}")
+    }
+
+    private fun prettyOneLine(json: String): String {
+        val trimmed = json.trim()
+        return if (trimmed.length > 500) trimmed.take(500) + "..." else trimmed
+    }
+}
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Customers.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Customers.kt
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/routes/ExternalAccounts.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/routes/ExternalAccounts.kt
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Quotes.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Quotes.kt
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Sandbox.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Sandbox.kt
diff --git a/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Webhooks.kt b/samples/kotlin/src/main/kotlin/com/grid/sample/routes/Webhooks.kt

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+{"root":["./src/app.tsx","./src/main.tsx","./src/vite-env.d.ts","./src/components/jsoneditor.tsx","./src/components/responsepanel.tsx","./src/components/stepwizard.tsx","./src/components/webhookstream.tsx","./src/lib/api.ts","./src/steps/createcustomer.tsx","./src/steps/createexternalaccount.tsx","./src/steps/createquote.tsx","./src/steps/executequote.tsx","./src/steps/sandboxfund.tsx"],"version":"5.9.3"}`