@simonarcher/fika-types 1.0.66 → 1.0.68

package/dist/coffee.d.ts

@@ -182,3 +182,25 @@ export declare const COFFEE_PRODUCING_COUNTRIES: string[];
 export declare const COUNTRY_NAME_TO_CODE: Record<string, string>;
 export declare const COUNTRY_CODE_TO_NAME: Record<string, string>;
 export type BrewMethod = "Espresso" | "Filter" | "Pour Over" | "Aeropress" | "French Press" | "Cold Brew" | "Moka Pot" | "Siphon" | "Other";
+export declare const BREW_METHOD_GROUPS: readonly [{
+    readonly id: "espresso";
+    readonly label: "Espresso Bar";
+    readonly methods: readonly ["Espresso"];
+}, {
+    readonly id: "pour-over";
+    readonly label: "Pour-Over";
+    readonly methods: readonly ["V60", "Kalita", "Chemex", "Clever"];
+}, {
+    readonly id: "immersion";
+    readonly label: "Immersion";
+    readonly methods: readonly ["Aeropress", "French Press", "Siphon"];
+}, {
+    readonly id: "cold";
+    readonly label: "Cold Brew & Iced";
+    readonly methods: readonly ["Cold Brew", "Kyoto", "Flash Brew", "Nitro"];
+}, {
+    readonly id: "other";
+    readonly label: "Other Methods";
+    readonly methods: readonly ["Moka Pot", "Turkish", "Batch Brew", "Capsule"];
+}];
+export type BrewMethodGroups = typeof BREW_METHOD_GROUPS;

package/dist/coffee.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.COUNTRY_CODE_TO_NAME = exports.COUNTRY_NAME_TO_CODE = exports.COFFEE_PRODUCING_COUNTRIES = exports.DECAF_METHODS = void 0;
+exports.BREW_METHOD_GROUPS = exports.COUNTRY_CODE_TO_NAME = exports.COUNTRY_NAME_TO_CODE = exports.COFFEE_PRODUCING_COUNTRIES = exports.DECAF_METHODS = void 0;
 exports.DECAF_METHODS = [
     "Swiss Water",
     "Sugarcane / Ethyl Acetate",
@@ -73,3 +73,30 @@ exports.COUNTRY_CODE_TO_NAME = {
     YE: "Yemen",
     ZZ: "Other",
 };
+exports.BREW_METHOD_GROUPS = [
+    {
+        id: 'espresso',
+        label: 'Espresso Bar',
+        methods: ['Espresso'],
+    },
+    {
+        id: 'pour-over',
+        label: 'Pour-Over',
+        methods: ['V60', 'Kalita', 'Chemex', 'Clever'],
+    },
+    {
+        id: 'immersion',
+        label: 'Immersion',
+        methods: ['Aeropress', 'French Press', 'Siphon'],
+    },
+    {
+        id: 'cold',
+        label: 'Cold Brew & Iced',
+        methods: ['Cold Brew', 'Kyoto', 'Flash Brew', 'Nitro'],
+    },
+    {
+        id: 'other',
+        label: 'Other Methods',
+        methods: ['Moka Pot', 'Turkish', 'Batch Brew', 'Capsule'],
+    },
+];

package/dist/shop.d.ts

@@ -375,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;
@@ -481,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;
@@ -501,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.66",
+    "version": "1.0.68",
     "description": "Shared TypeScript types for Fika projects",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",