@simonarcher/fika-types 1.0.63 → 1.0.65

package/dist/coffee.d.ts

@@ -1,4 +1,48 @@
 import type { GeoPoint, Timestamp } from "firebase-admin/firestore";
+/** How “established” a roaster is within specialty (used by shop scoring). */
+export type RoasterTier = 1 | 2 | 3;
+export interface RoasterSpecialtyMeta {
+    tier?: RoasterTier;
+    verified?: boolean;
+    notes?: string;
+    curatedByUserId?: string;
+    curatedAt?: Timestamp;
+    /** Optional admin override of tier for edge cases (rare). */
+    override?: {
+        tier: RoasterTier;
+        reason: string;
+        byUserId: string;
+        at: Timestamp;
+    } | null;
+}
+/** Sourcing / transparency signals that justify tier & help UX “Why” copy. */
+export interface RoasterSourcingSignals {
+    directTrade?: boolean;
+    transparentPricing?: boolean;
+    qGradersOnStaff?: boolean;
+    cupOfExcellenceLots?: boolean;
+    competitionInvolvement?: boolean;
+    sustainabilityBadges?: string[];
+    relationshipCoffeeYears?: number;
+    originFootprint?: string[];
+}
+/** Public web signals—useful for automated parsing & evidence. */
+export interface RoasterWebSignals {
+    website?: string;
+    instagram?: string;
+    lastCrawledAt?: Timestamp;
+    semanticKeywordHits?: number;
+    semanticKeywordDensity?: number;
+    sources?: Array<"website" | "ig" | "other">;
+    crawlError?: string | null;
+}
+/** Lightweight analytics to help admin and list pages. */
+export interface RoasterStats {
+    shopsUsingCount?: number;
+    activeBeansCount?: number;
+    lastUsedAt?: Timestamp;
+}
+/** NEW extended Roaster model. All new fields optional to avoid breaking writes. */
 export interface Roaster {
     id: string;
     name: string;
@@ -24,15 +68,23 @@ export interface Roaster {
         };
     };
     farms?: LinkedFarm[];
+    /** ===== Specialty additions ===== */
+    specialty?: RoasterSpecialtyMeta;
+    sourcing?: RoasterSourcingSignals;
+    webSignals?: RoasterWebSignals;
+    stats?: RoasterStats;
+    /** ===== Existing fields (kept) ===== */
     addedByUser?: string;
     active: boolean;
     createdAt?: Timestamp;
     updatedAt?: Timestamp;
     status: "inReview" | "approved" | "rejected";
     additionalInfo?: string;
+    /** Consider replacing with stats.shopsUsingCount over time; keep for back-compat. */
     suppliedShops?: string[];
     geoPoint?: GeoPoint;
 }
+/** Submission payload from users (or shops) proposing a new roaster. */
 export interface SubmissionRoaster {
     name: string;
     logoImage?: string;
@@ -51,12 +103,17 @@ export interface SubmissionRoaster {
             city: string;
         };
     };
+    /** Allow submitter to *suggest* a tier with evidence (curators decide). */
+    suggestedTier?: RoasterTier;
+    evidenceUrls?: string[];
+    notesForCurator?: string;
     userId: string;
     status: "inReview" | "approved" | "rejected";
     active: boolean;
     additionalInfo?: string;
     geoPoint?: GeoPoint;
 }
+/** Unchanged helper types (kept for beans/origins) */
 export interface LinkedFarm {
     id: string;
     name: string;
@@ -68,7 +125,7 @@ export interface LinkedFarm {
 export type DecafMethod = "Swiss Water" | "Sugarcane / Ethyl Acetate" | "Carbon Dioxide (CO₂)" | "Methylene Chloride" | "Mountain Water" | "Unknown";
 export declare const DECAF_METHODS: readonly ["Swiss Water", "Sugarcane / Ethyl Acetate", "Carbon Dioxide (CO₂)", "Methylene Chloride", "Mountain Water", "Unknown"];
 export type CoffeeProcessingMethod = "Washed (Wet)" | "Natural (Dry)" | "Honey" | "Anaerobic Fermentation" | "Carbonic Maceration" | "Wet-Hulled" | "Semi-Washed" | "Experimental / Other" | "Unknown";
-export type RoastLevel = 'Light' | 'Medium' | 'Dark' | 'Medium-Dark' | 'Medium-Light' | 'Espresso';
+export type RoastLevel = "Light" | "Medium" | "Dark" | "Medium-Dark" | "Medium-Light" | "Espresso";
 export interface Origin {
     countryCode: string;
     countryName?: string;

package/dist/coffee.js

@@ -7,36 +7,12 @@ exports.DECAF_METHODS = [
     "Carbon Dioxide (CO₂)",
     "Methylene Chloride",
     "Mountain Water",
-    "Unknown"
+    "Unknown",
 ];
 exports.COFFEE_PRODUCING_COUNTRIES = [
-    "Bolivia",
-    "Brazil",
-    "Burundi",
-    "Colombia",
-    "Costa Rica",
-    "Dominican Republic",
-    "Ecuador",
-    "El Salvador",
-    "Ethiopia",
-    "Guatemala",
-    "Haiti",
-    "Honduras",
-    "India",
-    "Indonesia",
-    "Jamaica",
-    "Kenya",
-    "Mexico",
-    "Nicaragua",
-    "Panama",
-    "Papua New Guinea",
-    "Peru",
-    "Rwanda",
-    "Tanzania",
-    "Uganda",
-    "Vietnam",
-    "Yemen",
-    "Other",
+    "Bolivia", "Brazil", "Burundi", "Colombia", "Costa Rica", "Dominican Republic", "Ecuador", "El Salvador",
+    "Ethiopia", "Guatemala", "Haiti", "Honduras", "India", "Indonesia", "Jamaica", "Kenya", "Mexico", "Nicaragua",
+    "Panama", "Papua New Guinea", "Peru", "Rwanda", "Tanzania", "Uganda", "Vietnam", "Yemen", "Other",
 ];
 // Mapping between common origin country names and ISO 3166-1 alpha-2 codes
 exports.COUNTRY_NAME_TO_CODE = {

package/dist/shop.d.ts

@@ -5,6 +5,7 @@ export type MenuItemDrinkType = "Filter" | "ColdBrew" | "Specialty" | "Iced" | "
 export type MenuItemFoodType = "Breakfast" | "Lunch" | "Pastry" | "Snack" | "Sweets" | "Sandwiches" | "Other";
 export type MenuItemType = MenuItemDrinkType | MenuItemFoodType;
 export type MenuItemCategory = "drink" | "food";
+export type SpecialtyTier = 'specialty' | 'quality' | 'everyday';
 export interface MenuItem {
     id: string;
     productId?: string;
@@ -190,6 +191,18 @@ export type ShopData = {
     communityStats?: ShopCommunityStats;
     spotifyPlaylistId?: string;
     paymentOptions?: ShopPaymentOptions;
+    /**
+     * --------- NEW FOR SPECIALTY SCORING (all optional/merge-friendly) ----------
+     */
+    roasterRefs?: RoasterRef[];
+    houseRoasted?: boolean;
+    brewMethods?: string[];
+    menuKeywords?: string[];
+    events?: string[];
+    sustainability?: Array<'direct trade' | 'traceable' | 'organic' | 'b-corp' | string>;
+    baristaAchievements?: BaristaAchievement[];
+    signals?: SpecialtySignals;
+    specialty?: SpecialtyMeta;
 };
 export interface ShopCommunityStats {
     totalCheckIns: number;
@@ -448,4 +461,43 @@ export interface PublicShopData extends Omit<ShopData, 'analytics' | 'googleRati
     spotifyPlaylistId?: string;
     address?: string;
 }
+export type SpecialtyOverride = {
+    score: number;
+    reason?: string;
+    byUserId?: string;
+    at?: number;
+};
+export type SpecialtyMeta = {
+    score?: number;
+    tier?: SpecialtyTier;
+    verified?: boolean;
+    override?: SpecialtyOverride | null;
+    explanations?: string[];
+    updatedAt?: number;
+};
+export type SpecialtySemanticSignals = {
+    keywordHits?: number;
+    keywordDensity?: number;
+    sources?: Array<'website' | 'ig' | 'menu' | 'other'>;
+};
+export type SpecialtyCrowdSignals = {
+    votes?: number;
+    specialtyVotes?: number;
+    avgCraftRating?: number;
+};
+export type SpecialtySignals = {
+    semantic?: SpecialtySemanticSignals;
+    crowd?: SpecialtyCrowdSignals;
+};
+export type RoasterRef = {
+    id: string;
+    displayName?: string;
+    tierHint?: 1 | 2 | 3;
+};
+export type CommunitySignal = 'cupping' | 'training' | 'education' | 'origin talk' | 'sustainability' | 'direct trade' | 'traceable';
+export type BaristaAchievement = {
+    title: string;
+    year?: number;
+    notes?: string;
+};
 export {};

package/package.json

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