@cravery/types 0.0.1

package/src/ingredients/recipe.ts

@@ -0,0 +1,17 @@
+import { Unit } from "../common";
+
+export interface RecipeIngredientMeta {
+  slug: string;
+  optional?: boolean;
+  quantity?: number;
+  unit?: Unit;
+}
+
+export interface RecipeIngredientContent {
+  name: string;
+  slug: string;
+  notes?: string;
+}
+
+export interface RecipeIngredient
+  extends RecipeIngredientMeta, RecipeIngredientContent {}

package/src/ingredients/section.ts

@@ -0,0 +1,22 @@
+import {
+  RecipeIngredient,
+  RecipeIngredientContent,
+  RecipeIngredientMeta,
+} from "./recipe";
+
+export interface IngredientSectionMeta {
+  ingredients: RecipeIngredientMeta[];
+  slug: string;
+}
+
+export interface IngredientSectionContent {
+  ingredients: RecipeIngredientContent[];
+  slug: string;
+  title?: string;
+}
+
+export interface IngredientSection {
+  ingredients: RecipeIngredient[];
+  slug: string;
+  title?: string;
+}

package/src/ingredients/user.ts

@@ -0,0 +1,14 @@
+import { Currency, Unit } from "../common";
+import { Entity, Timestamp } from "../core";
+import { IngredientCategory } from "./category";
+import { IngredientGroup } from "./group";
+
+export interface UserIngredient extends Entity {
+  category: IngredientCategory;
+  cost: Currency;
+  expiresAt: Timestamp | null;
+  group: IngredientGroup;
+  slug: string;
+  quantity?: number;
+  unit?: Unit;
+}

package/src/interactions/collection.ts

@@ -0,0 +1,7 @@
+import { Entity } from "src/core";
+
+export interface RecipeCollection extends Entity {
+  userId: string;
+  name: string;
+  recipeIds: string[];
+}

package/src/interactions/cooked.ts

@@ -0,0 +1,6 @@
+import { Entity } from "../core";
+
+export interface CookedRecipe extends Entity {
+  recipeId: string;
+  count: number;
+}

package/src/interactions/event.ts

@@ -0,0 +1,10 @@
+import { InteractionEventType } from "./event_type";
+
+export interface InteractionEvent {
+  userId: string;
+  recipeId: string;
+  eventType: InteractionEventType;
+  value?: number;
+  region?: string;
+  timestamp: number;
+}

package/src/interactions/event_type.ts

@@ -0,0 +1,9 @@
+export const INTERACTION_EVENT_TYPES = [
+  "save",
+  "unsave",
+  "cook",
+  "rate",
+  "unrate",
+  "share",
+] as const;
+export type InteractionEventType = (typeof INTERACTION_EVENT_TYPES)[number];

package/src/interactions/index.ts

@@ -0,0 +1,5 @@
+export * from "./cooked";
+export * from "./event_type";
+export * from "./event";
+export * from "./rated";
+export * from "./saved";

package/src/interactions/rated.ts

@@ -0,0 +1,6 @@
+import { Entity } from "../core";
+
+export interface RatedRecipe extends Entity {
+  recipeId: string;
+  value: number;
+}

package/src/interactions/saved.ts

@@ -0,0 +1,6 @@
+import { Entity } from "../core";
+
+export interface SavedRecipe extends Entity {
+  recipeId: string;
+  searchTerms?: string[];
+}

package/src/limits/index.ts

@@ -0,0 +1,3 @@
+export * from "./limits";
+export * from "./operation";
+export * from "./usage";

package/src/limits/limits.ts

@@ -0,0 +1,6 @@
+import { SubscriptionTier } from "../subscriptions";
+import { Operation } from "./operation";
+
+export type TierLimits = Record<SubscriptionTier, number>;
+
+export type LimitsConfig = Record<Operation, TierLimits>;

package/src/limits/operation.ts

@@ -0,0 +1,10 @@
+export const OPERATION_VALUES = [
+  "assistant",
+  "mealPlan",
+  "recipeFromUrl",
+  "recipeFromImage",
+  "recipeFromText",
+  "scanIngredients",
+  "scanEquipment",
+] as const;
+export type Operation = (typeof OPERATION_VALUES)[number];

package/src/limits/usage.ts

@@ -0,0 +1,9 @@
+import { Timestamp } from "../core";
+import { Operation } from "./operation";
+
+export type UsageCounts = Partial<Record<Operation, number>>;
+
+export interface UsagePeriod {
+  counts: UsageCounts;
+  updatedAt: Timestamp;
+}

package/src/mealplan/day.ts

@@ -0,0 +1,6 @@
+import { PlannedMeal } from "./meal";
+
+export interface MealPlanDay {
+  date: string; // ISO: "2026-01-19"
+  meals: PlannedMeal[];
+}

package/src/mealplan/index.ts

@@ -0,0 +1,4 @@
+export * from "./day";
+export * from "./meal";
+export * from "./plan";
+export * from "./slot";

package/src/mealplan/meal.ts

@@ -0,0 +1,9 @@
+import { MealSlot } from "./slot";
+
+export interface PlannedMeal {
+  completed: boolean;
+  recipeId: string;
+  servings: number;
+  slot: MealSlot;
+  notes?: string;
+}

package/src/mealplan/plan.ts

@@ -0,0 +1,9 @@
+import { Entity } from "../core";
+import { MealPlanDay } from "./day";
+
+export interface MealPlan extends Entity {
+  startDate: string;
+  endDate: string;
+  days: MealPlanDay[];
+  name?: string;
+}

package/src/mealplan/slot.ts

@@ -0,0 +1,7 @@
+export const MEAL_SLOT_VALUES = [
+  "breakfast",
+  "lunch",
+  "dinner",
+  "snack",
+] as const;
+export type MealSlot = (typeof MEAL_SLOT_VALUES)[number];

package/src/recipes/admin.ts

@@ -0,0 +1,12 @@
+import { Locale } from "../core";
+import { Recipe } from "./recipe";
+import { RecipeSource } from "./source";
+
+export interface AdminRecipe extends Recipe {
+  confidence: number;
+  createdBy: string;
+  originalLocale: Locale;
+  searchTerms: string[];
+  source: RecipeSource;
+  sourceRef: string;
+}

package/src/recipes/content.ts

@@ -0,0 +1,14 @@
+import { Locale } from "../core/locale";
+import { RecipeEquipmentContent } from "../equipment";
+import { IngredientSectionContent } from "../ingredients";
+import { InstructionContent } from "./instruction";
+
+export interface RecipeContent {
+  description: string;
+  equipment?: RecipeEquipmentContent[];
+  ingredientSections: IngredientSectionContent[];
+  instructions: InstructionContent[];
+  locale: Locale;
+  tips?: string[];
+  title: string;
+}

package/src/recipes/index.ts

@@ -0,0 +1,4 @@
+export * from "./instruction";
+export * from "./recipe";
+export * from "./source";
+export * from "./stats";

package/src/recipes/instruction.ts

@@ -0,0 +1,19 @@
+import { Temperature } from "../common";
+
+export interface InstructionMeta {
+  step: number;
+  duration?: number;
+  equipment?: string[];
+  ingredients?: string[];
+  optional?: boolean;
+  temperature?: Temperature;
+}
+
+export interface InstructionContent {
+  step: number;
+  text: string;
+  tip?: string;
+  warning?: string;
+}
+
+export interface Instruction extends InstructionMeta, InstructionContent {}

package/src/recipes/meta.ts

@@ -0,0 +1,42 @@
+import { Entity } from "../core";
+import { Locale } from "../core/locale";
+import {
+  Allergen,
+  Cuisine,
+  Currency,
+  DietaryTag,
+  Difficulty,
+  MealType,
+  Nutrition,
+  Spiciness,
+} from "../common";
+import { RecipeEquipmentMeta } from "../equipment";
+import { IngredientSectionMeta } from "../ingredients";
+import { InstructionMeta } from "./instruction";
+import { RecipeSource } from "./source";
+import { RecipeStatus } from "./status";
+
+export interface RecipeMeta extends Entity {
+  allergens: Allergen[];
+  confidence: number;
+  cost: Currency;
+  createdBy: string;
+  cuisines: Cuisine[];
+  dietaryTags: DietaryTag[];
+  difficulty: Difficulty;
+  duration: number;
+  equipment: RecipeEquipmentMeta[];
+  images: string[];
+  ingredientSections: IngredientSectionMeta[];
+  instructions: InstructionMeta[];
+  mealTypes: MealType[];
+  nutrition: Nutrition;
+  originalLocale: Locale;
+  searchTerms: string[];
+  servings: number;
+  source: RecipeSource;
+  sourceRef: string;
+  spiciness: Spiciness;
+  status: RecipeStatus;
+  videoUrl?: string;
+}

package/src/recipes/recipe.ts

@@ -0,0 +1,39 @@
+import { Entity } from "../core";
+import { Locale } from "../core/locale";
+import {
+  Allergen,
+  Cuisine,
+  Currency,
+  DietaryTag,
+  Difficulty,
+  MealType,
+  Nutrition,
+  Spiciness,
+} from "../common";
+import { RecipeEquipment } from "../equipment";
+import { IngredientSection } from "../ingredients";
+import { Instruction } from "./instruction";
+import { RecipeStatus } from "./status";
+
+export interface Recipe extends Entity {
+  allergens: Allergen[];
+  cuisines: Cuisine[];
+  cost: Currency;
+  description: string;
+  dietaryTags: DietaryTag[];
+  difficulty: Difficulty;
+  duration: number;
+  equipment: RecipeEquipment[];
+  images: string[];
+  ingredientSections: IngredientSection[];
+  instructions: Instruction[];
+  locale: Locale;
+  mealTypes: MealType[];
+  nutrition: Nutrition;
+  servings: number;
+  spiciness: Spiciness;
+  status: RecipeStatus;
+  tips: string[];
+  title: string;
+  videoUrl?: string;
+}

package/src/recipes/source.ts

@@ -0,0 +1,2 @@
+export const RECIPE_SOURCE_VALUES = ["image", "text", "url"] as const;
+export type RecipeSource = (typeof RECIPE_SOURCE_VALUES)[number];

package/src/recipes/stats.ts

@@ -0,0 +1,9 @@
+export interface RecipeStats {
+  cooks: number;
+  ratingCount: number;
+  ratingSum: number;
+  saves: number;
+  shares: number;
+  score: number;
+  updatedAt: number;
+}

package/src/recipes/status.ts

@@ -0,0 +1,8 @@
+export const RECIPE_STATUS_VALUES = [
+  "active",
+  "archived",
+  "deleted",
+  "flagged",
+  "pending",
+] as const;
+export type RecipeStatus = (typeof RECIPE_STATUS_VALUES)[number];

package/src/reports/category.ts

@@ -0,0 +1,11 @@
+export const REPORT_CATEGORY_VALUES = [
+  "copyright",
+  "harassment",
+  "inappropriate",
+  "low_confidence",
+  "misinformation",
+  "not_recipe",
+  "other",
+  "spam",
+] as const;
+export type ReportCategory = (typeof REPORT_CATEGORY_VALUES)[number];

package/src/reports/index.ts

@@ -0,0 +1,8 @@
+export * from "./category";
+export * from "./priority";
+export * from "./report";
+export * from "./status";
+export * from "./submission";
+export * from "./target";
+export * from "./update_type";
+export * from "./update";

package/src/reports/priority.ts

@@ -0,0 +1,7 @@
+export const REPORT_PRIORITY_VALUES = [
+  "critical",
+  "high",
+  "medium",
+  "low",
+] as const;
+export type ReportPriority = (typeof REPORT_PRIORITY_VALUES)[number];

package/src/reports/report.ts

@@ -0,0 +1,18 @@
+import { Entity } from "../core";
+import { ReportPriority } from "./priority";
+import { ReportStatus } from "./status";
+import { ReportSubmission } from "./submission";
+import { ReportTarget } from "./target";
+import { ReportUpdate } from "./update";
+
+export interface Report extends Entity {
+  priority: ReportPriority;
+  status: ReportStatus;
+  reporterId: string;
+  submission: ReportSubmission;
+  target: ReportTarget;
+}
+
+export interface UpdatedReport extends Report {
+  updates: ReportUpdate[];
+}

package/src/reports/status.ts

@@ -0,0 +1,9 @@
+export const REPORT_STATUS_VALUES = [
+  "closed",
+  "escalated",
+  "in_progress",
+  "pending",
+  "rejected",
+  "resolved",
+] as const;
+export type ReportStatus = (typeof REPORT_STATUS_VALUES)[number];

package/src/reports/submission.ts

@@ -0,0 +1,8 @@
+import { ReportCategory } from "./category";
+
+export interface ReportSubmission {
+  category: ReportCategory;
+  description: string;
+  contentSnapshot?: string;
+  imageHashes?: string[];
+}

package/src/reports/target.ts

@@ -0,0 +1,22 @@
+import { RecipeSource } from "../recipes";
+
+export interface ExtractionTarget {
+  type: "extraction";
+  source: RecipeSource;
+  sourceRef: string;
+}
+
+export interface ImageTarget {
+  type: "image";
+  imageUrl: string;
+}
+
+export interface RecipeTarget {
+  type: "recipe";
+  recipeId: string;
+}
+
+export type ReportTarget =
+  | ExtractionTarget
+  | ImageTarget
+  | RecipeTarget;

package/src/reports/update.ts

@@ -0,0 +1,21 @@
+import { Entity } from "../core";
+import { ReportUpdateType } from "./update_type";
+
+export interface ReportUpdateBase extends Entity {
+  content: string;
+  reportId: string;
+  type: ReportUpdateType;
+}
+
+export interface AIUpdate extends ReportUpdateBase {
+  type: "ai";
+  score: number;
+  reasoning: string;
+}
+
+export interface ResolutionUpdate extends ReportUpdateBase {
+  type: "resolution";
+  action: "dismissed" | "warning_issued" | "content_removed" | "user_suspended";
+}
+
+export type ReportUpdate = AIUpdate | ReportUpdateBase | ResolutionUpdate;

package/src/reports/update_type.ts

@@ -0,0 +1,2 @@
+export const REPORT_UPDATE_TYPE_VALUES = ["ai", "note", "resolution"] as const;
+export type ReportUpdateType = (typeof REPORT_UPDATE_TYPE_VALUES)[number];

package/src/settings/index.ts

@@ -0,0 +1,2 @@
+export * from "./notification";
+export * from "./settings";

package/src/settings/notification.ts

@@ -0,0 +1,6 @@
+export interface NotificationSettings {
+  email: boolean;
+  push: boolean;
+  marketing: boolean;
+  weeklyDigest: boolean;
+}

package/src/settings/settings.ts

@@ -0,0 +1,27 @@
+import {
+  Allergen,
+  Cuisine,
+  DietaryTag,
+  Difficulty,
+  MeasurementSystem,
+  Spiciness,
+  TemperatureUnit,
+} from "../common";
+import { Entity, Locale, Theme } from "../core";
+import { NotificationSettings } from "./notification";
+
+export interface Settings extends Entity {
+  allergens: Allergen[];
+  cuisines: Cuisine[];
+  defaultServings: number;
+  dietaryTags: DietaryTag[];
+  excludedIngredients: string[];
+  locale: Locale;
+  measurementSystem: MeasurementSystem;
+  notifications: NotificationSettings;
+  skillLevel: Difficulty;
+  spiciness: Spiciness;
+  temperatureUnit: TemperatureUnit;
+  textScale: number;
+  theme: Theme;
+}

package/src/shopping/index.ts

@@ -0,0 +1,3 @@
+export * from "./item_status";
+export * from "./item";
+export * from "./list";

package/src/shopping/item.ts

@@ -0,0 +1,9 @@
+import { Unit } from "../common";
+import { ShoppingItemStatus } from "./item_status";
+
+export interface ShoppingItem {
+  slug: string;
+  quantity: number;
+  unit: Unit;
+  status: ShoppingItemStatus;
+}

package/src/shopping/item_status.ts

@@ -0,0 +1,6 @@
+export const SHOPPING_ITEM_STATUS_VALUES = [
+  "pending",
+  "purchased",
+  "skipped",
+] as const;
+export type ShoppingItemStatus = (typeof SHOPPING_ITEM_STATUS_VALUES)[number];

package/src/shopping/list.ts

@@ -0,0 +1,9 @@
+import { Entity } from "../core";
+import { ShoppingItem } from "./item";
+
+export interface ShoppingList extends Entity {
+  name?: string;
+  items: ShoppingItem[];
+  planId: string;
+  archived: boolean;
+}

package/src/subscriptions/billing_period.ts

@@ -0,0 +1,2 @@
+export const BILLING_PERIOD_VALUES = ["monthly", "yearly"] as const;
+export type BillingPeriod = (typeof BILLING_PERIOD_VALUES)[number];

package/src/subscriptions/index.ts

@@ -0,0 +1,8 @@
+export * from "./billing_period";
+export * from "./member_status";
+export * from "./member";
+export * from "./store";
+export * from "./subscription_role";
+export * from "./subscription_status";
+export * from "./subscription_tier";
+export * from "./subscription";

package/src/subscriptions/member.ts

@@ -0,0 +1,10 @@
+import { Timestamp } from "../core";
+import { MemberStatus } from "./member_status";
+import { SubscriptionRole } from "./subscription_role";
+
+export interface Member {
+  joinedAt: Timestamp | null;
+  role: SubscriptionRole;
+  status: MemberStatus;
+  userId: string;
+}

package/src/subscriptions/member_status.ts

@@ -0,0 +1,7 @@
+export const MEMBER_STATUS_VALUES = [
+  "invited",
+  "active",
+  "declined",
+  "removed",
+] as const;
+export type MemberStatus = (typeof MEMBER_STATUS_VALUES)[number];

package/src/subscriptions/store.ts

@@ -0,0 +1,7 @@
+export const SUBSCRIPTION_STORE_VALUES = [
+  "app_store",
+  "play_store",
+  "promotional",
+  "stripe",
+] as const;
+export type SubscriptionStore = (typeof SUBSCRIPTION_STORE_VALUES)[number];

package/src/subscriptions/subscription.ts

@@ -0,0 +1,22 @@
+import { Entity, Timestamp } from "../core";
+import { BillingPeriod } from "./billing_period";
+import { Member } from "./member";
+import { SubscriptionStore } from "./store";
+import { SubscriptionStatus } from "./subscription_status";
+import { SubscriptionTier } from "./subscription_tier";
+
+export interface Subscription extends Entity {
+  billingPeriod: BillingPeriod;
+  cancelledAt: Timestamp | null;
+  customerId: string;
+  entitlementId: string;
+  expiresAt: Timestamp;
+  members: Member[];
+  productId: string;
+  purchasedAt: Timestamp;
+  renewable: boolean;
+  status: SubscriptionStatus;
+  store: SubscriptionStore;
+  tier: SubscriptionTier;
+  trialExpiresAt: Timestamp | null;
+}

package/src/subscriptions/subscription_role.ts

@@ -0,0 +1,2 @@
+export const SUBSCRIPTION_ROLE_VALUES = ["member", "owner"] as const;
+export type SubscriptionRole = (typeof SUBSCRIPTION_ROLE_VALUES)[number];

package/src/subscriptions/subscription_status.ts

@@ -0,0 +1,11 @@
+export const SUBSCRIPTION_STATUS_VALUES = [
+  "active",
+  "deleted",
+  "expired",
+  "grace",
+  "paused",
+  "pending",
+  "rejected",
+  "trialing",
+] as const;
+export type SubscriptionStatus = (typeof SUBSCRIPTION_STATUS_VALUES)[number];

package/src/subscriptions/subscription_tier.ts

@@ -0,0 +1,2 @@
+export const SUBSCRIPTION_TIER_VALUES = ["family", "free", "pro"] as const;
+export type SubscriptionTier = (typeof SUBSCRIPTION_TIER_VALUES)[number];