@simonarcher/fika-types 1.0.65 → 1.0.67

package/dist/shop.d.ts

@@ -195,6 +195,7 @@ export type ShopData = {
      * --------- NEW FOR SPECIALTY SCORING (all optional/merge-friendly) ----------
      */
     roasterRefs?: RoasterRef[];
+    roasterRefsIds?: string[];
     houseRoasted?: boolean;
     brewMethods?: string[];
     menuKeywords?: string[];
@@ -374,32 +375,6 @@ export type SubmissionShopFormData = {
         };
     };
 };
-export interface ShopReview {
-    id: string;
-    userId: string;
-    shopId?: string;
-    reviewText?: string;
-    imageUrl?: string | undefined;
-    createdAt: Timestamp;
-    createdAtISO?: string;
-    ratings?: {
-        coffee?: number;
-        service?: number;
-        ambience?: number;
-    };
-}
-export interface PostShopReviewData {
-    userId: string | undefined;
-    shopId: string;
-    reviewText?: string;
-    imageUrl?: string | undefined;
-    ratings?: {
-        coffee?: number;
-        service?: number;
-        ambience?: number;
-    };
-    createdAt: AdminTimestamp;
-}
 export interface ShopReviewSubmission {
     reviewText?: string;
     imageUrl?: string | undefined;
@@ -480,11 +455,6 @@ export type SpecialtySemanticSignals = {
     keywordDensity?: number;
     sources?: Array<'website' | 'ig' | 'menu' | 'other'>;
 };
-export type SpecialtyCrowdSignals = {
-    votes?: number;
-    specialtyVotes?: number;
-    avgCraftRating?: number;
-};
 export type SpecialtySignals = {
     semantic?: SpecialtySemanticSignals;
     crowd?: SpecialtyCrowdSignals;
@@ -500,4 +470,97 @@ export type BaristaAchievement = {
     year?: number;
     notes?: string;
 };
+/**
+ *  Denormalized version used when displaying or exporting reviews.
+ *  Mirrors PostShopReviewData but includes IDs, timestamps, and optional ISO string.
+ */
+export interface ShopReview {
+    id: string;
+    userId: string;
+    shopId?: string;
+    reviewText?: string;
+    imageUrl?: string | undefined;
+    createdAt: Timestamp;
+    createdAtISO?: string;
+    ratings?: {
+        coffee?: number;
+        service?: number;
+        ambience?: number;
+    };
+    /** -------- Specialty crowd data -------- */
+    craftPerception?: 0 | 0.5 | 1;
+    craftRating?: 1 | 2 | 3 | 4 | 5;
+    brewSightings?: string[];
+    roasterSightings?: string[];
+    evidence?: {
+        photos?: string[];
+        links?: string[];
+    };
+    reviewerTrust?: number;
+    status?: "active" | "flagged" | "hidden";
+}
+/**
+ * Incoming payload when a user posts a new review.
+ * Used in your client submission and Cloud Functions triggers.
+ */
+export interface PostShopReviewData {
+    userId: string | undefined;
+    shopId: string;
+    reviewText?: string;
+    imageUrl?: string | undefined;
+    ratings?: {
+        coffee?: number;
+        service?: number;
+        ambience?: number;
+    };
+    createdAt: AdminTimestamp;
+    /** -------- Specialty crowd data additions -------- */
+    /**
+     *  User’s perception of whether this is a specialty coffee shop.
+     *  1 = Yes, 0.5 = Not sure, 0 = No
+     */
+    craftPerception?: 0 | 0.5 | 1;
+    /**
+     *  How “craft-focused” the experience felt (1–5 slider).
+     */
+    craftRating?: 1 | 2 | 3 | 4 | 5;
+    /**
+     *  Brewing methods or equipment observed in the shop.
+     *  e.g., ["V60", "Aeropress", "Espresso", "Chemex"]
+     */
+    brewSightings?: string[];
+    /**
+     *  Roasters observed or confirmed at the shop.
+     *  Ideally references `roasters/{id}` but may also be free text.
+     */
+    roasterSightings?: string[];
+    /**
+     *  Optional evidence supporting the review — photo links or menu links.
+     */
+    evidence?: {
+        photos?: string[];
+        links?: string[];
+    };
+    /**
+     *  System-assigned weight (0.5–1.5) to trust reviews more/less
+     *  based on history, evidence, and consistency.
+     */
+    reviewerTrust?: number;
+    /**
+     *  Internal moderation / review status.
+     */
+    status?: "active" | "flagged" | "hidden";
+}
+export interface ShopSignals {
+    crowd: SpecialtyCrowdSignals;
+}
+export interface SpecialtyCrowdSignals {
+    votes: number;
+    specialtyVotes: number;
+    avgCraftRating?: number | null;
+    brewTallies?: Record<string, number>;
+    roasterTallies?: Record<string, number>;
+    _smoothedCraftRatio?: number;
+    updatedAt: number;
+}
 export {};

package/package.json

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