@simonarcher/fika-types 2.1.0 → 2.3.0

package/dist/bean-scans.d.ts

@@ -20,6 +20,79 @@
  * - `created_new` — user created a new bean record from this scan
  */
 export type BeanScanAction = "pending" | "saved" | "tried" | "rejected" | "created_new";
+/**
+ * FIK-185 — AI vision draft persisted on bean_scans.ai_inferred when the
+ * trigram matcher returns bean_score < 0.4. Mobile uses this to prefill the
+ * AddBeanStep submission form; admin uses it to show the curator what AI
+ * suggested vs what the user actually submitted.
+ *
+ * Field shape mirrors the gpt-4o-mini extraction prompt in
+ * Fika-server/src/services/openAIService.ts (`extractBeanFromImage`).
+ * Curator-only fields (variety, roastDate, weightG) aren't on the mobile
+ * form — they sit here for the admin review screen to surface.
+ */
+export interface BeanScanAiDraft {
+    name: string | null;
+    roasterName: string | null;
+    roastLevel: string | null;
+    processing: string | null;
+    country: string | null;
+    isDecaf: boolean | null;
+    tastingNotes: string[] | null;
+    variety: string | null;
+    roastDate: string | null;
+    weightG: number | null;
+    model: string;
+    latencyMs: number;
+    extractedAt: string;
+}
+/**
+ * FIK-187 — admin scan log + FIK-186 user scan history list shape.
+ *
+ * Returned by:
+ *   GET /admin/bean-scans     (admin-only, all users)
+ *   GET /bean-scans/me        (caller-only, pinned to res.locals.uid)
+ *
+ * Carries enough to render a list row without a per-row catalog lookup —
+ * the top candidate is denormalised in. The full `candidates` array,
+ * `ai_inferred` payload, and `device_meta` are returned only on the
+ * detail endpoints.
+ */
+export interface BeanScanListItem {
+    id: string;
+    userId: string;
+    photoUrl: string;
+    ocrText?: string;
+    action: BeanScanAction;
+    matchedBeanId?: string;
+    /**
+     * Denormalised top candidate, derived server-side from the persisted
+     * `candidates` jsonb. Lets the list render a meaningful primary line
+     * without a join. May be undefined when the matcher returned zero
+     * candidates (e.g. empty OCR text).
+     */
+    topCandidate?: {
+        beanName: string;
+        roasterName: string;
+        score: number;
+    };
+    /** True when bean_scans.ai_inferred IS NOT NULL. */
+    hasAiInferred: boolean;
+    createdAt: string;
+    resolvedAt?: string;
+}
+/**
+ * Cursor-paginated list response shared by both endpoints.
+ *
+ * `nextCursor` is the ISO `created_at` of the oldest item in this page —
+ * caller passes it as `?before=<cursor>` on the next request. Null when
+ * exhausted.
+ */
+export interface BeanScanListResponse {
+    success: true;
+    scans: BeanScanListItem[];
+    nextCursor: string | null;
+}
 /**
  * One row per user scan event. Powers the bag-scan loop: photograph →
  * OCR + photo similarity → top-N candidate beans → user picks (or rejects).
@@ -47,6 +120,12 @@ export interface BeanScan {
     matchedBeanId?: string;
     action: BeanScanAction;
     deviceMeta?: Record<string, unknown>;
+    /**
+     * FIK-185 — gpt-4o-mini vision draft, set by POST /bean-scans/:id/enrich
+     * when the trigram matcher's top bean_score is below the auto-route gate.
+     * NULL until enriched (or if the kill switch is off).
+     */
+    aiInferred?: BeanScanAiDraft;
     createdAt: string;
     resolvedAt?: string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@simonarcher/fika-types",
-    "version": "2.1.0",
+    "version": "2.3.0",
     "description": "Shared TypeScript types for Fika projects",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",