@la-main-verte/shared-types 1.0.72 → 1.0.74

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@la-main-verte/shared-types",
-  "version": "1.0.72",
+  "version": "1.0.74",
   "description": "Shared TypeScript interfaces for frontend of la-main-verte app",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/gardenZoneBlueprint.api.d.ts

@@ -1,7 +1,7 @@
-import type { HOME } from './home.api'
-
-export namespace GARDEN_ZONE_BLUEPRINT {
-  export interface Response {
-    sections: HOME.SectionI[]
-  }
-}
+import type { HOME } from './home.api'
+
+export namespace GARDEN_ZONE_BLUEPRINT {
+  export interface Response {
+    sections: HOME.SectionI[]
+  }
+}

package/src/home.api.d.ts

@@ -1,252 +1,257 @@
-import type { PlantI } from './plant'
-import type { SelectionI } from './selection'
-import type { TaskI } from './task'
-
-export namespace HOME {
-  export type HeroCardMode = 'featuredSelection' | 'featuredPlant'
-
-  export type SectionComponentType =
-    | 'Header'
-    | 'HeroCards'
-    | 'PlantCarousel'
-    | 'HeroCardsCarousel'
-    | 'WideCardsCarousel'
-    | 'Weather'
-    | 'AdviceCarousel'
-    | 'OnboardingCard'
-    | 'UpcomingTasks'
-
-  export type CarouselComponentType = Extract<
-    SectionComponentType,
-    'PlantCarousel' | 'HeroCardsCarousel' | 'WideCardsCarousel'
-  >
-
-  export interface WeatherDayI {
-    date: string
-    minTempC: number
-    maxTempC: number
-    iconUrl: string | null
-    condition?: string | null
-  }
-
-  export interface WeatherSectionI {
-    componentType: 'Weather'
-    title: string
-    subtitle?: string
-    locationName: string
-    timezone: string
-    days: WeatherDayI[]
-    lastUpdatedAt: string
-    dataSource: 'weatherapi'
-    backgroundColor?: string
-  }
-
-  export interface HeaderSectionI {
-    componentType: 'Header'
-    title: string
-    subtitle: string
-  }
-
-  export interface AdviceI {
-    id?: string | number
-    title: string
-    markdownContent: string
-    titleColor?: string
-    backgroundColor?: string
-  }
-
-  export interface AdviceSectionI {
-    componentType: 'AdviceCarousel'
-    title?: string
-    subtitle?: string
-    advices: AdviceI[]
-  }
-
-  export interface WideCardAuthorI {
-    name?: string | null
-    imageURL?: string | null
-  }
-
-  export interface WideCardItemI {
-    id?: string | number
-    title?: string | null
-    text: string
-    badgeText?: string | null
-    thumbnailImageURL: string
-    author?: WideCardAuthorI | null
-    link?: string | null
-    metadata?: Record<string, unknown>
-  }
-
-  export interface WideCardsCarouselSectionI {
-    componentType: 'WideCardsCarousel'
-    title: string
-    subtitle?: string
-    cards: WideCardItemI[]
-  }
-
-  export interface HeroCardBlueprintI {
-    mode: HeroCardMode
-    title?: string | null
-    description?: string | null
-    backgroundColor?: string | null
-    backgroundImageUrl?: string | null
-    ctaLabel?: string | null
-    ctaRoute?: string | null
-    previewPlants?: PlantI[]
-    selection?: SelectionI | null
-    plant?: PlantI | null
-  }
-
-  export interface HeroCardsSectionI {
-    componentType: 'HeroCards'
-    title?: string | null
-    subtitle?: string | null
-    cards: HeroCardBlueprintI[]
-  }
-
-  export interface PlantCarouselSectionI {
-    componentType: 'PlantCarousel'
-    title: string
-    subtitle?: string
-    selection: SelectionI
-    displayRanking?: boolean
-  }
-
-  export interface HeroCardsCarouselSectionI {
-    componentType: 'HeroCardsCarousel'
-    selections: SelectionI[]
-  }
-
-  export interface FamilyRecommendationI {
-    family: string
-    headline: string
-    plants: PlantI[]
-  }
-
-  export interface FamilyExplorerSectionI {
-    componentType: 'FamilyExplorer'
-    title: string
-    subtitle?: string
-    families: FamilyRecommendationI[]
-  }
-
-  export interface OnboardingStepI {
-    id: string
-    title: string
-    description: string
-    isCompleted: boolean
-    ctaLink: string
-  }
-
-  export interface OnboardingCardSectionI {
-    componentType: 'OnboardingCard'
-    title: string
-    subtitle: string
-    steps: OnboardingStepI[]
-    completedStepsCount: number
-    totalStepsCount: number
-  }
-
-  /** Minimal plant info for preview display in grouped tasks */
-  export interface TaskPlantPreviewI {
-    name: string
-    slug: string
-    imageURL?: string | null
-  }
-
-  /** Family group info when multiple plants share the same task */
-  export interface TaskFamilyGroupI {
-    familyName: string
-    plantsCount: number
-    plants: TaskPlantPreviewI[]
-  }
-
-  export interface UpcomingTaskI {
-    task: TaskI
-    plantName: string
-    plantSlug: string
-    plantImageURL?: string | null
-    gardenName: string
-    gardenCategory: string
-    selectionSlug: string
-    /** If this task is grouped by family */
-    familyGroup?: TaskFamilyGroupI
-  }
-
-  export interface UpcomingTaskAdviceI {
-    content: string
-    taskName: string
-    plantName: string
-    plantSlug: string
-    plantImageURL?: string | null
-    gardenName: string
-    gardenCategory: string
-    selectionSlug: string
-    task: TaskI
-    /** If this task is grouped by family */
-    familyGroup?: TaskFamilyGroupI
-  }
-
-  export interface UpcomingTasksSectionI {
-    componentType: 'UpcomingTasks'
-    title: string
-    subtitle?: string
-    advices: UpcomingTaskAdviceI[]
-  }
-
-  /** Preview plant for WhenToSeedWhat section */
-  export interface WhenToSeedWhatPlantPreviewI {
-    id: number
-    name: string
-    family?: string | null
-    slug: string
-    imageURL?: string | null
-  }
-
-  /** A generic link card section with title, subtitle, URL, and optional preview images */
-  export interface LinkCardSectionI {
-    componentType: 'LinkCard'
-    title: string
-    subtitle?: string
-    url: string
-    previewPlants?: WhenToSeedWhatPlantPreviewI[]
-    backgroundColor?: string
-    /** Show a red badge indicator (replaces the plant preview stack when true) */
-    showBadge?: boolean
-    /** Optional badge count to display */
-    badgeCount?: number
-  }
-
-  export type SectionI =
-    | HeaderSectionI
-    | HeroCardsSectionI
-    | PlantCarouselSectionI
-    | HeroCardsCarouselSectionI
-    | WideCardsCarouselSectionI
-    | WeatherSectionI
-    | AdviceSectionI
-    | OnboardingCardSectionI
-    | UpcomingTasksSectionI
-    | LinkCardSectionI
-
-  export interface Response {
-    sections: SectionI[]
-    weather?: WeatherSectionI
-    advice?: AdviceSectionI
-  }
-
-  export interface HeroCardItemI {
-    id?: string | null
-    mode: HeroCardMode
-    title?: string | null
-    description?: string | null
-    backgroundColor?: string | null
-    backgroundImageUrl?: string | null
-    previewPlants?: PlantI[]
-    ctaLabel?: string | null
-    selection?: SelectionI | null
-    plant?: PlantI | null
-    ctaRoute?: string | null
-  }
-}
+import type { PlantI } from './plant'
+import type { SelectionI } from './selection'
+import type { TaskI } from './task'
+
+export namespace HOME {
+  export type HeroCardMode = 'featuredSelection' | 'featuredPlant'
+
+  export type SectionComponentType =
+    | 'Header'
+    | 'HeroCards'
+    | 'PlantCarousel'
+    | 'HeroCardsCarousel'
+    | 'WideCardsCarousel'
+    | 'Weather'
+    | 'AdviceCarousel'
+    | 'OnboardingCard'
+    | 'UpcomingTasks'
+
+  export type CarouselComponentType = Extract<
+    SectionComponentType,
+    'PlantCarousel' | 'HeroCardsCarousel' | 'WideCardsCarousel'
+  >
+
+  export interface WeatherDayI {
+    date: string
+    minTempC: number
+    maxTempC: number
+    iconUrl: string | null
+    condition?: string | null
+  }
+
+  export interface WeatherSectionI {
+    componentType: 'Weather'
+    title: string
+    subtitle?: string
+    locationName: string
+    timezone: string
+    days: WeatherDayI[]
+    lastUpdatedAt: string
+    dataSource: 'weatherapi'
+    backgroundColor?: string
+  }
+
+  export interface HeaderSectionI {
+    componentType: 'Header'
+    title: string
+    subtitle: string
+  }
+
+  export interface AdviceI {
+    id?: string | number
+    title: string
+    markdownContent: string
+    titleColor?: string
+    backgroundColor?: string
+  }
+
+  export interface AdviceSectionI {
+    componentType: 'AdviceCarousel'
+    title?: string
+    subtitle?: string
+    advices: AdviceI[]
+  }
+
+  export interface WideCardAuthorI {
+    name?: string | null
+    imageURL?: string | null
+  }
+
+  export interface WideCardItemI {
+    id?: string | number
+    title?: string | null
+    text: string
+    badgeText?: string | null
+    thumbnailImageURL: string
+    author?: WideCardAuthorI | null
+    link?: string | null
+    metadata?: Record<string, unknown>
+  }
+
+  export interface WideCardsCarouselSectionI {
+    componentType: 'WideCardsCarousel'
+    title: string
+    subtitle?: string
+    cards: WideCardItemI[]
+  }
+
+  export interface HeroCardBlueprintI {
+    mode: HeroCardMode
+    title?: string | null
+    description?: string | null
+    backgroundColor?: string | null
+    backgroundImageUrl?: string | null
+    ctaLabel?: string | null
+    ctaRoute?: string | null
+    previewPlants?: PlantI[]
+    selection?: SelectionI | null
+    plant?: PlantI | null
+  }
+
+  export interface HeroCardsSectionI {
+    componentType: 'HeroCards'
+    title?: string | null
+    subtitle?: string | null
+    cards: HeroCardBlueprintI[]
+  }
+
+  export interface PlantCarouselSectionI {
+    componentType: 'PlantCarousel'
+    title: string
+    subtitle?: string
+    selection: SelectionI
+    displayRanking?: boolean
+  }
+
+  export interface HeroCardsCarouselSectionI {
+    componentType: 'HeroCardsCarousel'
+    selections: SelectionI[]
+  }
+
+  export interface FamilyRecommendationI {
+    family: string
+    headline: string
+    plants: PlantI[]
+  }
+
+  export interface FamilyExplorerSectionI {
+    componentType: 'FamilyExplorer'
+    title: string
+    subtitle?: string
+    families: FamilyRecommendationI[]
+  }
+
+  export interface OnboardingStepI {
+    id: string
+    title: string
+    description: string
+    isCompleted: boolean
+    ctaLink: string
+  }
+
+  export interface OnboardingCardSectionI {
+    componentType: 'OnboardingCard'
+    title: string
+    subtitle: string
+    steps: OnboardingStepI[]
+    completedStepsCount: number
+    totalStepsCount: number
+  }
+
+  /** Minimal plant info for preview display (e.g. parent plant in grouped tasks) */
+  export interface TaskPlantPreviewI {
+    name: string
+    slug: string
+    imageURL?: string | null
+  }
+
+  /** Plant info within a family group — includes the task ID specific to this plant */
+  export interface TaskFamilyPlantPreviewI extends TaskPlantPreviewI {
+    taskId: number
+  }
+
+  /** Family group info when multiple plants share the same task */
+  export interface TaskFamilyGroupI {
+    familyName: string
+    plantsCount: number
+    plants: TaskFamilyPlantPreviewI[]
+  }
+
+  export interface UpcomingTaskI {
+    task: TaskI
+    plantName: string
+    plantSlug: string
+    plantImageURL?: string | null
+    gardenName: string
+    gardenCategory: string
+    selectionSlug: string
+    /** If this task is grouped by family */
+    familyGroup?: TaskFamilyGroupI
+  }
+
+  export interface UpcomingTaskAdviceI {
+    content: string
+    taskName: string
+    plantName: string
+    plantSlug: string
+    plantImageURL?: string | null
+    gardenName: string
+    gardenCategory: string
+    selectionSlug: string
+    task: TaskI
+    /** If this task is grouped by family */
+    familyGroup?: TaskFamilyGroupI
+  }
+
+  export interface UpcomingTasksSectionI {
+    componentType: 'UpcomingTasks'
+    title: string
+    subtitle?: string
+    advices: UpcomingTaskAdviceI[]
+  }
+
+  /** Preview plant for WhenToSeedWhat section */
+  export interface WhenToSeedWhatPlantPreviewI {
+    id: number
+    name: string
+    family?: string | null
+    slug: string
+    imageURL?: string | null
+  }
+
+  /** A generic link card section with title, subtitle, URL, and optional preview images */
+  export interface LinkCardSectionI {
+    componentType: 'LinkCard'
+    title: string
+    subtitle?: string
+    url: string
+    previewPlants?: WhenToSeedWhatPlantPreviewI[]
+    backgroundColor?: string
+    /** Show a red badge indicator (replaces the plant preview stack when true) */
+    showBadge?: boolean
+    /** Optional badge count to display */
+    badgeCount?: number
+  }
+
+  export type SectionI =
+    | HeaderSectionI
+    | HeroCardsSectionI
+    | PlantCarouselSectionI
+    | HeroCardsCarouselSectionI
+    | WideCardsCarouselSectionI
+    | WeatherSectionI
+    | AdviceSectionI
+    | OnboardingCardSectionI
+    | UpcomingTasksSectionI
+    | LinkCardSectionI
+
+  export interface Response {
+    sections: SectionI[]
+    weather?: WeatherSectionI
+    advice?: AdviceSectionI
+  }
+
+  export interface HeroCardItemI {
+    id?: string | null
+    mode: HeroCardMode
+    title?: string | null
+    description?: string | null
+    backgroundColor?: string | null
+    backgroundImageUrl?: string | null
+    previewPlants?: PlantI[]
+    ctaLabel?: string | null
+    selection?: SelectionI | null
+    plant?: PlantI | null
+    ctaRoute?: string | null
+  }
+}

package/src/member.d.ts

@@ -1,72 +1,72 @@
-import type { NoteI } from './note'
-import type { SelectionI } from './selection'
-
-export interface MemberI {
-  id: number
-  email: string
-  firstName: string
-  lastName: string
-  /** Virtual field to get the user's full name */
-  fullName?: string | null
-  city?: string
-  hardinessZoneName?: string
-  createdAt: Date
-  updatedAt: Date
-  lastFreezingDate?: Date
-  firstFreezingDate?: Date
-  /**
-   * Number of unread Crisp messages
-   */
-  unreadMessagesCount?: number
-  notes?: NoteI[]
-  selections?: SelectionI[]
-  userActivities?: UserActivityI[]
-  /**
-   * hasAnActiveSubscription is a VIRTUAL FIELD used to check if the user has an active subscription
-   */
-  hasAnActiveSubscription?: boolean
-  /**
-   * Acts as a one-way not identifiable token.
-   * Crisp uses this token to identify the user conversation
-   */
-  userToken: string
-  /**
-   * HMAC signature used by Crisp identity verification.
-   * Signed on the backend from the user email.
-   */
-  crispUserEmailSignature?: string
-  /**
-   * neverAddedATask <=> Has the use ever open the task form?
-   * Yes it is misleading, ticket is open to change it.
-   * It was too intense to force the user to add a task.
-   */
-  neverAddedATask?: boolean
-  neverAddedAPlant?: boolean
-  neverAddedANote?: boolean
-  neverTriedSpacingSection?: boolean
-  neverTriedAiAgent?: boolean
-  neverDeletedAPlant?: boolean
-  neverDeletedATask?: boolean
-  neverEditedATask?: boolean
-  finishedOnboarding: boolean
-  hasDownloadedNativeApp?: boolean
-  unitSystem: 'imperial' | 'metric'
-  gardenZoneTimelessPreference?: boolean
-  subscriptionEndDate?: Date
-  /**
-   * Last fertilizer ID chosen by the user.
-   * Used as the default fertilizer for new garden zones.
-   */
-  lastFertilizerIdChosen?: number
-  /**
-   * Virtual field to get the app badge count
-   * ----------------------------------------
-   * For now, it's just the number of unread messages.
-   */
-  badgeCount?: number
-  /**
-   * Number of unread alerts, cached version of unread alerts (the table) count
-   */
-  unreadAlertsCount?: number
-  isAdmin: boolean
-}
+import type { NoteI } from './note'
+import type { SelectionI } from './selection'
+
+export interface MemberI {
+  id: number
+  email: string
+  firstName: string
+  lastName: string
+  /** Virtual field to get the user's full name */
+  fullName?: string | null
+  city?: string
+  hardinessZoneName?: string
+  createdAt: Date
+  updatedAt: Date
+  lastFreezingDate?: Date
+  firstFreezingDate?: Date
+  /**
+   * Number of unread Crisp messages
+   */
+  unreadMessagesCount?: number
+  notes?: NoteI[]
+  selections?: SelectionI[]
+  userActivities?: UserActivityI[]
+  /**
+   * hasAnActiveSubscription is a VIRTUAL FIELD used to check if the user has an active subscription
+   */
+  hasAnActiveSubscription?: boolean
+  /**
+   * Acts as a one-way not identifiable token.
+   * Crisp uses this token to identify the user conversation
+   */
+  userToken: string
+  /**
+   * HMAC signature used by Crisp identity verification.
+   * Signed on the backend from the user email.
+   */
+  crispUserEmailSignature?: string
+  /**
+   * neverAddedATask <=> Has the use ever open the task form?
+   * Yes it is misleading, ticket is open to change it.
+   * It was too intense to force the user to add a task.
+   */
+  neverAddedATask?: boolean
+  neverAddedAPlant?: boolean
+  neverAddedANote?: boolean
+  neverTriedSpacingSection?: boolean
+  neverTriedAiAgent?: boolean
+  neverDeletedAPlant?: boolean
+  neverDeletedATask?: boolean
+  neverEditedATask?: boolean
+  finishedOnboarding: boolean
+  hasDownloadedNativeApp?: boolean
+  unitSystem: 'imperial' | 'metric'
+  gardenZoneTimelessPreference?: boolean
+  subscriptionEndDate?: Date
+  /**
+   * Last fertilizer ID chosen by the user.
+   * Used as the default fertilizer for new garden zones.
+   */
+  lastFertilizerIdChosen?: number
+  /**
+   * Virtual field to get the app badge count
+   * ----------------------------------------
+   * For now, it's just the number of unread messages.
+   */
+  badgeCount?: number
+  /**
+   * Number of unread alerts, cached version of unread alerts (the table) count
+   */
+  unreadAlertsCount?: number
+  isAdmin: boolean
+}

package/src/pages.api.d.ts

@@ -33,4 +33,20 @@ export namespace PAGES {
   export interface MonthsPreviewResponse {
     months: MonthPreviewI[]
   }
+
+  export interface HelpVideoI {
+    id: string
+    youtubeVideoId: string
+    youtubeUrl: string
+    thumbnailUrl: string
+    title: string
+    subtitle: string
+    mp4Url: string | null
+  }
+
+  export interface HelpResponse {
+    title: string
+    subtitle?: string | null
+    videos: HelpVideoI[]
+  }
 }

package/src/plant.d.ts

@@ -1,115 +1,107 @@
-import type { TaxonFamilyI } from './taxonFamily'
-import type { SeedingInfoI } from './pages.api'
-/**
- * Range filter value for min/max filters
- */
-export interface RangeFilterValueI {
-  min: number
-  max: number
-}
-
-/**
- * Plant filter value types
- * Represents the possible values for a single filter
- */
-export type PlantFilterValueI = string | string[] | number | boolean | RangeFilterValueI
-
-/**
- * Plant attributes for filtering
- * Used in JSONB field and as query parameters
- * Supports multiple value types for different filter types
- */
-export type PlantAttributesI = Record<string, PlantFilterValueI>
-
-export interface PlantI {
-  id: number
-  name: string
-  slug: string
-  description: string
-  descriptionSource?: string
-  female: boolean
-  family?: string | null
-  taxonFamilyId?: number | null
-  spaceBetweenSeedMin: number
-  spaceBetweenSeedMax: number
-  spaceBetweenAlleyMin: number
-  spaceBetweenAlleyMax: number
-  weeksInTransplant: number
-  weeksDuringWhichYouCanSeedOutdoor: number
-  weeksToMaturity: number
-  weeksToWaitAfterFreezingDate: number
-  weeksToHarvest: number
-  indoorSeeding: boolean
-  outdoorSeeding: boolean
-  azoteNeedsKgPerHa: number
-  hibernate: boolean
-  germinationTemperature: number | null
-  minGerminationTemperature: number | null
-  germinationNumberOfDays: string | null
-  germinationSeedDepth: string | null
-  cultivationInfo: string | null
-  parentId: number | null
-  memberId?: number
-  memberFirstName?: string | null
-  shared: boolean
-  hexColor: string | null
-  sunRequirements: 'partialShade' | 'fullSun' | 'fullShade' | null
-  isHardy: boolean | null
-  imageURL: string
-  totalWeeksToMaturity: number
-  hasNoInformation: boolean
-  createdAt: Date
-  updatedAt: Date
-  translatedSunRequirements: 'Plein soleil' | 'Mi-ombre' | 'Ombre' | null
-  parent?: PlantI
-  children?: PlantI[]
-  PlantInventories?: PlantInventoryI[]
-  taggedItems?: TaggedItemI[]
-  /**
-   * List of selections that the plant is in.
-   * --------------------------------------
-   * Tends to be used for featured selections
-   */
-  Selections?: SelectionI[]
-  tasks?: TaskI[]
-  Images?: ImageI[]
-  Member?: Partial<MemberI>
-  notes?: NoteI[]
-  rotationGroup?: string
-  // @deprecate once v1.8.1 is fully adopted
-  rotationFamily?: string
-  taxonFamily?: TaxonFamilyI
-  seedingInfo: SeedingInfoI
-  /**
-   * Contextual search text for recommended plants
-   * Provides additional context when suggesting plants for specific garden zones
-   */
-  contextualSearchText?: string
-}
-
-interface PlantTagI {
-  name: string
-  /**
-   * JSONB field containing plant-specific attributes for filtering
-   * Ex: { growth: { type: 'déterminée' }, fruit: { color: 'rouge' } }
-   */
-  attributes?: PlantAttributesI
-}
-
-interface PlantInventoryI {
-  id: number
-  plantId: number
-  supplierName: string
-  plantName: string
-  supplierURL: string
-  imageLocation: string
-  description: string
-  inStock: boolean
-}
-
-export interface PlantSearchResultI {
-  plants: PlantModelI[]
-  selections: SelectionModelI[]
-  total?: number
-  familyName?: string
-}
+import type { TaxonFamilyI } from './taxonFamily'
+import type { SeedingInfoI } from './pages.api'
+/**
+ * Range filter value for min/max filters
+ */
+export interface RangeFilterValueI {
+  min: number
+  max: number
+}
+
+/**
+ * Plant filter value types
+ * Represents the possible values for a single filter
+ */
+export type PlantFilterValueI = string | string[] | number | boolean | RangeFilterValueI
+
+/**
+ * Plant attributes for filtering
+ * Used in JSONB field and as query parameters
+ * Supports multiple value types for different filter types
+ */
+export type PlantAttributesI = Record<string, PlantFilterValueI>
+
+export interface PlantI {
+  id: number
+  name: string
+  slug: string
+  description: string
+  descriptionSource?: string
+  female: boolean
+  family?: string | null
+  taxonFamilyId?: number | null
+  spaceBetweenSeedMin: number
+  spaceBetweenSeedMax: number
+  spaceBetweenAlleyMin: number
+  spaceBetweenAlleyMax: number
+  weeksInTransplant: number
+  weeksDuringWhichYouCanSeedOutdoor: number
+  weeksToMaturity: number
+  daysToMaturity: number | null
+  weeksToWaitAfterFreezingDate: number
+  weeksToHarvest: number
+  indoorSeeding: boolean
+  outdoorSeeding: boolean
+  azoteNeedsKgPerHa: number
+  hibernate: boolean
+  germinationTemperature: number | null
+  minGerminationTemperature: number | null
+  germinationNumberOfDays: string | null
+  germinationSeedDepth: string | null
+  cultivationInfo: string | null
+  parentId: number | null
+  memberId?: number
+  memberFirstName?: string | null
+  shared: boolean
+  hexColor: string | null
+  sunRequirements: 'partialShade' | 'fullSun' | 'fullShade' | null
+  isHardy: boolean | null
+  imageURL: string
+  totalWeeksToMaturity: number
+  hasNoInformation: boolean
+  createdAt: Date
+  updatedAt: Date
+  translatedSunRequirements: 'Plein soleil' | 'Mi-ombre' | 'Ombre' | null
+  parent?: PlantI
+  children?: PlantI[]
+  PlantInventories?: PlantInventoryI[]
+  taggedItems?: TaggedItemI[]
+  /**
+   * List of selections that the plant is in.
+   * --------------------------------------
+   * Tends to be used for featured selections
+   */
+  Selections?: SelectionI[]
+  tasks?: TaskI[]
+  Images?: ImageI[]
+  Member?: Partial<MemberI>
+  notes?: NoteI[]
+  rotationGroup?: string
+  // @deprecate once v1.8.1 is fully adopted
+  rotationFamily?: string
+  taxonFamily?: TaxonFamilyI
+  seedingInfo: SeedingInfoI
+  /**
+   * Contextual search text for recommended plants
+   * Provides additional context when suggesting plants for specific garden zones
+   */
+  contextualSearchText?: string
+}
+
+interface PlantInventoryI {
+  id: number
+  plantId: number
+  supplierName: string
+  plantName: string
+  supplierURL: string
+  imageLocation: string
+  description: string
+  inStock: boolean
+}
+
+export interface PlantSearchResultI {
+  plants: PlantModelI[]
+  selections: SelectionModelI[]
+  total?: number
+  familyName?: string
+}

package/src/plants.api.d.ts

@@ -80,7 +80,7 @@ export namespace PLANTS {
         spaceBetweenSeedMax?: number | null
         spaceBetweenAlleyMin?: number | null
         spaceBetweenAlleyMax?: number | null
-        weeksToMaturity?: number | null
+        daysToMaturity?: number | null
         indoorSeeding?: boolean
         outdoorSeeding?: boolean
         sunRequirements?: 'partialShade' | 'fullSun' | 'fullShade' | null

package/src/task.d.ts

@@ -10,6 +10,8 @@ export interface TaskI {
   colourCode: string
   iconName?: string
   private: boolean
+  isDone: boolean
+  doneAt?: Date
 }
 
 /**
@@ -27,6 +29,25 @@ export interface TaskTagI {
   iconName?: string
 }
 
+/** Optional toast notification payload returned after task completion. All fields are optional — the frontend applies its own defaults for any missing field. */
+export interface CompleteTaskToastI {
+  title?: string
+  subtitle?: string
+  iconName?: string
+}
+
+/**
+ * Response returned when one or more tasks are marked as done.
+ * Keys are plant slugs, values are the full updated task list for that plant selection.
+ * Single completion returns a record with one entry; bulk returns one entry per plant.
+ */
+export interface CompleteTaskResponseI {
+  success: boolean
+  updatedTasksByPlant: Record<string, TaskI[]>
+  /** Optional toast to display after completion. Missing fields fall back to frontend defaults. */
+  toast?: CompleteTaskToastI
+}
+
 /**
  * Data used to create or edit a task
  */