@la-main-verte/shared-types 1.0.77 → 1.0.79

package/package.json

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

package/src/fertilizer.d.ts

@@ -1,56 +1,55 @@
-export interface FertilizerI {
-  id: number
-  name: string
-  slug: string
-  azotePercentage: number
-  phosphorePercentage: number
-  potassiumPercentage: number
-  /**
-   * The real azote percentage is the azote percentage multiplied by the azote efficiency.
-   */
-  realAzotePercentage: number
-  /**
-   * The azote efficiency is a percentage number between 0 and 1.
-   * Its how efficient the mineralization of the azote is.
-   */
-  azoteEfficiency: number
-  imageLocation: string
-  imageURL: string
-  quantitySuggested: string
-  /**
-   * Blend composition when this fertilizer is a combination of two products.
-   * Null for single fertilizers.
-   * When populated, contains the IDs and ratios (as percentages) of the primary and secondary fertilizers.
-   * The NPK values should be calculated by fetching each fertilizer and applying the weighted average.
-   *
-   * @example
-   * // For a blend:
-   * {
-   *   "primary_fertilizer_id": 1,    // Acti-Sol (70%)
-   *   "primary_fertilizer_ratio": 70,
-   *   "secondary_fertilizer_id": 12,  // Bionik (30%)
-   *   "secondary_fertilizer_ratio": 30
-   * }
-   *
-   * // For a single fertilizer:
-   * {}
-   */
-  combination_details: BlendCompositionI | null
-}
-
-interface BlendCompositionI {
-  primary_fertilizer_id: number
-  primary_fertilizer_ratio: number
-  secondary_fertilizer_id: number
-  secondary_fertilizer_ratio: number
-}
-
-export interface FertilizerSectionI {
-  sectionTitle: string
-  sectionSubtitle: string
-  fertilizers: FertilizerI[]
-}
-
-export interface FertilizersInGridI {
-  fertilizerSection: FertilizerSectionI[]
-}
+export interface FertilizerI {
+  id: number
+  name: string
+  slug: string
+  azotePercentage: number
+  phosphorePercentage: number
+  potassiumPercentage: number
+  /**
+   * The real azote percentage is the azote percentage multiplied by the azote efficiency.
+   */
+  realAzotePercentage: number
+  /**
+   * Nitrogen mineralization rate, between 0 and 1 (e.g. 0.9 for 90%).
+   */
+  nitrogenMineralizationRate: number | null
+  imageLocation: string
+  imageURL: string
+  quantitySuggested: string
+  /**
+   * Blend composition when this fertilizer is a combination of two products.
+   * Null for single fertilizers.
+   * When populated, contains the IDs and ratios (as percentages) of the primary and secondary fertilizers.
+   * The NPK values should be calculated by fetching each fertilizer and applying the weighted average.
+   *
+   * @example
+   * // For a blend:
+   * {
+   *   "primary_fertilizer_id": 1,    // Acti-Sol (70%)
+   *   "primary_fertilizer_ratio": 70,
+   *   "secondary_fertilizer_id": 12,  // Bionik (30%)
+   *   "secondary_fertilizer_ratio": 30
+   * }
+   *
+   * // For a single fertilizer:
+   * {}
+   */
+  combination_details: BlendCompositionI | null
+}
+
+interface BlendCompositionI {
+  primary_fertilizer_id: number
+  primary_fertilizer_ratio: number
+  secondary_fertilizer_id: number
+  secondary_fertilizer_ratio: number
+}
+
+export interface FertilizerSectionI {
+  sectionTitle: string
+  sectionSubtitle: string
+  fertilizers: FertilizerI[]
+}
+
+export interface FertilizersInGridI {
+  fertilizerSection: FertilizerSectionI[]
+}

package/src/gardenMap.d.ts

@@ -1,214 +1,214 @@
-import type { FertilizerI } from './fertilizer'
-import type { PlantSelectionI } from './plantSelection'
-
-/**
- * Viewport corners with x/y coordinates
- * Used by front-end to describe the visible area of the map
- */
-export interface ViewportCornersI {
-  topLeft: { x: number; y: number } | null
-  topRight: { x: number; y: number } | null
-  bottomLeft: { x: number; y: number } | null
-  bottomRight: { x: number; y: number } | null
-}
-
-/**
- * Viewport as min/max boundaries
- * Used by back-end placement logic for collision detection
- */
-export interface ViewportBoundariesI {
-  minX: number
-  minY: number
-  maxX: number
-  maxY: number
-}
-
-/**
- * Available garden map categories across the platform
- */
-export type GardenMapCategory =
-  | 'community_garden'
-  | 'greenhouse'
-  | 'garden'
-  | 'recipe'
-  | 'favorites'
-  | 'indoor_garden'
-  | 'balcony'
-  | 'inventory'
-  | 'others'
-
-/**
- * A gardenMap is a collection of garden zones
- */
-export interface GardenMapI {
-  id: number
-  name: string
-  icon_name: string
-  category: GardenMapCategory
-  default: boolean
-  memberId: number
-  width_in_units: number
-  height_in_units: number
-  createdAt: string
-  Selections: SelectionI[]
-  GardenZones: GardenZoneI[]
-  imageURL: string
-}
-
-/**
- * Legacy shape values accepted by the v1 route
- * (`POST /selections/:slug/gardenMap/gardenZone`).
- * This legacy param must remain rectangle/circle only.
- */
-export type GardenZoneLegacyShape = 'rectangle' | 'circle'
-
-/**
- * Visual shape identifier stored in `geometry.properties.shape`.
- */
-export type GardenZoneShape = 'rectangle' | 'circle' | 'polygon'
-
-export type GardenZoneCategory = 'cultural' | 'decorative'
-
-/**
- * Inner GeoJSON Polygon geometry (coordinates ring).
- */
-export interface GeoJSONPolygon {
-  type: 'Polygon'
-  coordinates: number[][][]
-}
-
-/**
- * Properties stored alongside the GeoJSON Feature.
- * `shape` is the canonical shape identifier.
- * Shape-specific fields (center, radius, radiusX, radiusY) describe the parametric definition.
- * `rotation` (degrees, clockwise) and `cornerRadius` (cm) follow GeoJSON/MapBox conventions.
- * `svgPath` holds the editable SVG path string for Bézier polygon rendering.
- */
-export interface GeoJSONFeatureProperties {
-  shape: GardenZoneShape
-  /** Rotation in degrees, clockwise. GeoJSON convention name. */
-  rotation?: number
-  /** Corner radius in cm. MapBox convention name. */
-  cornerRadius?: number
-  /** SVG path string with Bézier curves for polygon rendering. */
-  svgPath?: string
-  /** Center point [x, y] in cm for circle/ellipse shapes. */
-  center?: [number, number]
-  /** Radius in cm for circle shapes. */
-  radius?: number
-  /** Horizontal radius in cm for ellipse shapes. */
-  radiusX?: number
-  /** Vertical radius in cm for ellipse shapes. */
-  radiusY?: number
-}
-
-/**
- * GeoJSON Feature wrapping a Polygon geometry with shape properties.
- * This is the canonical storage format for all garden zone geometries.
- *
- * - `properties` holds the parametric definition (shape, rotation, radii, svgPath)
- * - `geometry` holds the computed polygon coordinates for calculations
- *
- * GeoJSON is the truth (for logic), SVG is the projection (for display and editing).
- */
-export interface GeoJSONFeature {
-  type: 'Feature'
-  properties: GeoJSONFeatureProperties
-  geometry: GeoJSONPolygon
-}
-
-export interface GardenZoneI {
-  id: number
-  name: string | null
-  gardenMapId: number
-  widthInMeters: number
-  heightInMeters: number
-  diameterInMeters: number
-  shape: GardenZoneShape
-  /**
-   * Virtual field — the actual visual shape derived from geometry.properties.shape,
-   * falling back to the DB shape column for legacy zones.
-   */
-  geometryShape: GardenZoneShape
-  geometry?: GeoJSONFeature | null
-  category: GardenZoneCategory
-  backgroundImage: string | null
-  xPosition: number
-  yPosition: number
-  zIndex: number
-  order: number
-  /**
-   * When set, the zone is shown only for that year.
-   * Null means the zone is timeless (visible for every year).
-   */
-  yearOfCulture: number | null
-  totalSurfaceInSquareMeters: number
-  totalSurfaceInSquareFeet: number
-  backgroundColor: string
-  createdAt: Date
-  updatedAt: Date
-  /**
-   * When set, the garden zone is a subdivision of another garden zone
-   * Parent zones are meant to be as eternal as possible.
-   * Subdivisions are meant to be created and destroyed on a yearly basis.
-   */
-  parent_garden_zone_id: number
-  /**
-   * Virtual field to check if the garden zone is a subdivision
-   * It is a renamed field from parent_garden_zone_id
-   */
-  is_subdivision: boolean
-  has_subdivisions: boolean
-  timeless: boolean
-  /**
-   * Orientation virtual field ONLY USE FOR RECTANGLES
-   * --------------------------------
-   * Disregard if the shape is a circle or square. It will return 'vertical'
-   */
-  orientation: 'horizontal' | 'vertical'
-  /**
-   * NOT USED BY THE FRONTEND YET - Use GardenZoneCulture instead
-   */
-  GardenZoneCultures?: GardenZoneCultureI[]
-  /**
-   * The culture on the GardenZone
-   */
-  GardenZoneCulture?: GardenZoneCultureI
-  rotationSuggestion?: string
-  category?: 'cultural' | 'decorative' | null
-}
-
-export interface GardenZoneCultureI {
-  id: number
-  gardenZoneId: number
-  plantSelectionId: number
-  seedQuantity: number
-  densityMode: 'dense' | 'sparse' | 'custom'
-  fertilizerId: number
-  /**
-   * The year of the culture - do not use it yet.
-   * @deprecated Potentially a mistake to have this field here
-   */
-  yearOfCulture: number
-  PlantSelection?: PlantSelectionI
-  /**
-   * The number of alleys
-   * --------------------------------
-   * Value is computed by the backend and NOT coming from the DB.
-   */
-  numberOfAlleys?: number
-  /**
-   * The number of seeds per alley
-   * --------------------------------
-   * Value is computed by the backend and NOT coming from the DB.
-   */
-  numberOfSeedsPerAlley?: number
-  Fertilizer?: FertilizerI
-  custom_space_between_seeds_in_cm?: number
-  custom_space_between_alley_in_cm?: number
-}
-
-export type UpdateGardenZonePayload = Partial<GardenZoneI> &
-  Partial<GardenZoneCultureI> & {
-    targetNumberOfPlants?: number
-  }
+import type { FertilizerI } from './fertilizer'
+import type { PlantSelectionI } from './plantSelection'
+
+/**
+ * Viewport corners with x/y coordinates
+ * Used by front-end to describe the visible area of the map
+ */
+export interface ViewportCornersI {
+  topLeft: { x: number; y: number } | null
+  topRight: { x: number; y: number } | null
+  bottomLeft: { x: number; y: number } | null
+  bottomRight: { x: number; y: number } | null
+}
+
+/**
+ * Viewport as min/max boundaries
+ * Used by back-end placement logic for collision detection
+ */
+export interface ViewportBoundariesI {
+  minX: number
+  minY: number
+  maxX: number
+  maxY: number
+}
+
+/**
+ * Available garden map categories across the platform
+ */
+export type GardenMapCategory =
+  | 'community_garden'
+  | 'greenhouse'
+  | 'garden'
+  | 'recipe'
+  | 'favorites'
+  | 'indoor_garden'
+  | 'balcony'
+  | 'inventory'
+  | 'others'
+
+/**
+ * A gardenMap is a collection of garden zones
+ */
+export interface GardenMapI {
+  id: number
+  name: string
+  icon_name: string
+  category: GardenMapCategory
+  default: boolean
+  memberId: number
+  width_in_units: number
+  height_in_units: number
+  createdAt: string
+  Selections: SelectionI[]
+  GardenZones: GardenZoneI[]
+  imageURL: string
+}
+
+/**
+ * Legacy shape values accepted by the v1 route
+ * (`POST /selections/:slug/gardenMap/gardenZone`).
+ * This legacy param must remain rectangle/circle only.
+ */
+export type GardenZoneLegacyShape = 'rectangle' | 'circle'
+
+/**
+ * Visual shape identifier stored in `geometry.properties.shape`.
+ */
+export type GardenZoneShape = 'rectangle' | 'circle' | 'polygon'
+
+export type GardenZoneCategory = 'cultural' | 'decorative'
+
+/**
+ * Inner GeoJSON Polygon geometry (coordinates ring).
+ */
+export interface GeoJSONPolygon {
+  type: 'Polygon'
+  coordinates: number[][][]
+}
+
+/**
+ * Properties stored alongside the GeoJSON Feature.
+ * `shape` is the canonical shape identifier.
+ * Shape-specific fields (center, radius, radiusX, radiusY) describe the parametric definition.
+ * `rotation` (degrees, clockwise) and `cornerRadius` (cm) follow GeoJSON/MapBox conventions.
+ * `svgPath` holds the editable SVG path string for Bézier polygon rendering.
+ */
+export interface GeoJSONFeatureProperties {
+  shape: GardenZoneShape
+  /** Rotation in degrees, clockwise. GeoJSON convention name. */
+  rotation?: number
+  /** Corner radius in cm. MapBox convention name. */
+  cornerRadius?: number
+  /** SVG path string with Bézier curves for polygon rendering. */
+  svgPath?: string
+  /** Center point [x, y] in cm for circle/ellipse shapes. */
+  center?: [number, number]
+  /** Radius in cm for circle shapes. */
+  radius?: number
+  /** Horizontal radius in cm for ellipse shapes. */
+  radiusX?: number
+  /** Vertical radius in cm for ellipse shapes. */
+  radiusY?: number
+}
+
+/**
+ * GeoJSON Feature wrapping a Polygon geometry with shape properties.
+ * This is the canonical storage format for all garden zone geometries.
+ *
+ * - `properties` holds the parametric definition (shape, rotation, radii, svgPath)
+ * - `geometry` holds the computed polygon coordinates for calculations
+ *
+ * GeoJSON is the truth (for logic), SVG is the projection (for display and editing).
+ */
+export interface GeoJSONFeature {
+  type: 'Feature'
+  properties: GeoJSONFeatureProperties
+  geometry: GeoJSONPolygon
+}
+
+export interface GardenZoneI {
+  id: number
+  name: string | null
+  gardenMapId: number
+  widthInMeters: number
+  heightInMeters: number
+  diameterInMeters: number
+  shape: GardenZoneShape
+  /**
+   * Virtual field — the actual visual shape derived from geometry.properties.shape,
+   * falling back to the DB shape column for legacy zones.
+   */
+  geometryShape: GardenZoneShape
+  geometry?: GeoJSONFeature | null
+  category: GardenZoneCategory
+  backgroundImage: string | null
+  xPosition: number
+  yPosition: number
+  zIndex: number
+  order: number
+  /**
+   * When set, the zone is shown only for that year.
+   * Null means the zone is timeless (visible for every year).
+   */
+  yearOfCulture: number | null
+  totalSurfaceInSquareMeters: number
+  totalSurfaceInSquareFeet: number
+  backgroundColor: string
+  createdAt: Date
+  updatedAt: Date
+  /**
+   * When set, the garden zone is a subdivision of another garden zone
+   * Parent zones are meant to be as eternal as possible.
+   * Subdivisions are meant to be created and destroyed on a yearly basis.
+   */
+  parent_garden_zone_id: number
+  /**
+   * Virtual field to check if the garden zone is a subdivision
+   * It is a renamed field from parent_garden_zone_id
+   */
+  is_subdivision: boolean
+  has_subdivisions: boolean
+  timeless: boolean
+  /**
+   * Orientation virtual field ONLY USE FOR RECTANGLES
+   * --------------------------------
+   * Disregard if the shape is a circle or square. It will return 'vertical'
+   */
+  orientation: 'horizontal' | 'vertical'
+  /**
+   * NOT USED BY THE FRONTEND YET - Use GardenZoneCulture instead
+   */
+  GardenZoneCultures?: GardenZoneCultureI[]
+  /**
+   * The culture on the GardenZone
+   */
+  GardenZoneCulture?: GardenZoneCultureI
+  rotationSuggestion?: string
+  category?: 'cultural' | 'decorative' | null
+}
+
+export interface GardenZoneCultureI {
+  id: number
+  gardenZoneId: number
+  plantSelectionId: number
+  seedQuantity: number
+  densityMode: 'dense' | 'sparse' | 'custom'
+  fertilizerId: number
+  /**
+   * The year of the culture - do not use it yet.
+   * @deprecated Potentially a mistake to have this field here
+   */
+  yearOfCulture: number
+  PlantSelection?: PlantSelectionI
+  /**
+   * The number of alleys
+   * --------------------------------
+   * Value is computed by the backend and NOT coming from the DB.
+   */
+  numberOfAlleys?: number
+  /**
+   * The number of seeds per alley
+   * --------------------------------
+   * Value is computed by the backend and NOT coming from the DB.
+   */
+  numberOfSeedsPerAlley?: number
+  Fertilizer?: FertilizerI
+  custom_space_between_seeds_in_cm?: number
+  custom_space_between_alley_in_cm?: number
+}
+
+export type UpdateGardenZonePayload = Partial<GardenZoneI> &
+  Partial<GardenZoneCultureI> & {
+    targetNumberOfPlants?: number
+  }

package/src/gardenOverview.d.ts

@@ -1,87 +1,87 @@
-/**
- * Garden Overview Types
- * Represents the detailed overview of a garden selection
- */
-import { PlantI } from './plant'
-
-export interface GardenOverviewI {
-  id: number
-  title: string
-  iconName: string
-  yearOfCulture: number
-  statistics: GardenOverviewStatsI
-}
-
-export interface GardenOverviewStatsI {
-  totalSeeds: number
-  totalSurface: string
-  totalSurfaceWithoutCulture: string
-  surfaceComparisonMessage: string | null
-  familyDistribution: FamilyStatsI[]
-  jardinVivrierComparison: GardenOverviewJardinVivrierFamilyStatsI[]
-  fertilization: FertilizationStatsI
-  zones: GardenOverviewZoneStatsI[]
-}
-
-export interface FertilizationStatsI {
-  totalWeightInKg: number
-  weightComparisonMessage: string | null
-  fertilizerDetails: FertilizerStatsI[]
-}
-
-export interface FertilizerStatsI {
-  fertilizerName: string
-  fertilizerQuantity: string
-  imageURL: string
-}
-
-export interface FamilyStatsI {
-  family: string
-  hexColor: string
-  totalSeeds: number
-  totalSurface: string
-  percentage: number
-  plants: GardenOverviewPlantStatsI[]
-}
-
-export interface GardenOverviewJardinVivrierFamilyStatsI {
-  family: string
-  parentImageURL: string | null
-  cultivatedQuantity: number
-  suggestedQuantityForFiveInJardinVivrier: number | null
-}
-
-/**
- * Extended PlantI with overview-specific statistics
- * Contains the full plant data plus surface, seedQuantity, and position
- */
-export interface GardenOverviewPlantStatsI extends PlantI {
-  seedQuantity: number
-  surface: string
-  position: number
-  densityMode: string
-  fertilizerName: string
-  fertilizerQuantity: string
-}
-
-export interface GardenOverviewZonePlantStatsI {
-  id: number
-  name: string
-  imageURL: string | null
-}
-
-export interface GardenOverviewZoneFertilizerStatsI {
-  name: string
-  quantity: string
-}
-
-export interface GardenOverviewZoneStatsI {
-  id: number
-  name: string
-  totalSeeds: number
-  surface: string
-  fertilizerQuantity: string
-  thumbnailURL: string
-  plants: GardenOverviewZonePlantStatsI[]
-  fertilizers: GardenOverviewZoneFertilizerStatsI[]
-}
+/**
+ * Garden Overview Types
+ * Represents the detailed overview of a garden selection
+ */
+import { PlantI } from './plant'
+
+export interface GardenOverviewI {
+  id: number
+  title: string
+  iconName: string
+  yearOfCulture: number
+  statistics: GardenOverviewStatsI
+}
+
+export interface GardenOverviewStatsI {
+  totalSeeds: number
+  totalSurface: string
+  totalSurfaceWithoutCulture: string
+  surfaceComparisonMessage: string | null
+  familyDistribution: FamilyStatsI[]
+  jardinVivrierComparison: GardenOverviewJardinVivrierFamilyStatsI[]
+  fertilization: FertilizationStatsI
+  zones: GardenOverviewZoneStatsI[]
+}
+
+export interface FertilizationStatsI {
+  totalWeightInKg: number
+  weightComparisonMessage: string | null
+  fertilizerDetails: FertilizerStatsI[]
+}
+
+export interface FertilizerStatsI {
+  fertilizerName: string
+  fertilizerQuantity: string
+  imageURL: string
+}
+
+export interface FamilyStatsI {
+  family: string
+  hexColor: string
+  totalSeeds: number
+  totalSurface: string
+  percentage: number
+  plants: GardenOverviewPlantStatsI[]
+}
+
+export interface GardenOverviewJardinVivrierFamilyStatsI {
+  family: string
+  parentImageURL: string | null
+  cultivatedQuantity: number
+  suggestedQuantityForFiveInJardinVivrier: number | null
+}
+
+/**
+ * Extended PlantI with overview-specific statistics
+ * Contains the full plant data plus surface, seedQuantity, and position
+ */
+export interface GardenOverviewPlantStatsI extends PlantI {
+  seedQuantity: number
+  surface: string
+  position: number
+  densityMode: string
+  fertilizerName: string
+  fertilizerQuantity: string
+}
+
+export interface GardenOverviewZonePlantStatsI {
+  id: number
+  name: string
+  imageURL: string | null
+}
+
+export interface GardenOverviewZoneFertilizerStatsI {
+  name: string
+  quantity: string
+}
+
+export interface GardenOverviewZoneStatsI {
+  id: number
+  name: string
+  totalSeeds: number
+  surface: string
+  fertilizerQuantity: string
+  thumbnailURL: string
+  plants: GardenOverviewZonePlantStatsI[]
+  fertilizers: GardenOverviewZoneFertilizerStatsI[]
+}

package/src/users.api.d.ts

@@ -1,136 +1,136 @@
-import type { DeviceDataI } from './device.d'
-import type { MemberI as MemberDataI } from './member.d'
-import type { SelectionI } from './selection.d'
-import type { PlantI } from './plant.d'
-
-interface RequestHeaders {
-  'x-session-token': string
-  'x-native-app-version'?: string
-  'x-application-type'?: 'react-native' | 'web'
-}
-
-export namespace USERS {
-  export namespace GET {
-    export interface Request {
-      headers: RequestHeaders
-      params: {
-        scopes: ('unreadNotificationsCount' | 'coordinates')[]
-      }
-    }
-    export type Response = MemberDataI & {
-      unreadAlertsCount?: number
-    }
-  }
-  export namespace DEVICES {
-    export interface Request {
-      headers: RequestHeaders
-      body: {
-        /** @see DeviceDataI */
-        userAgent?: DeviceDataI['userAgent']
-        platform?: DeviceDataI['platform']
-        version?: DeviceDataI['version']
-        model?: DeviceDataI['model']
-        name?: DeviceDataI['name']
-        appVersion?: DeviceDataI['appVersion']
-        pushKey?: DeviceDataI['pushKey']
-        apnsToken?: DeviceDataI['apnsToken']
-        fcmToken?: DeviceDataI['fcmToken']
-        webPushEndpoint?: DeviceDataI['webPushEndpoint']
-        webPushP256dh?: DeviceDataI['webPushP256dh']
-        webPushAuth?: DeviceDataI['webPushAuth']
-        webPushSubscription?: DeviceDataI['webPushSubscription']
-      }
-    }
-    export type Response = DeviceDataI
-  }
-  export namespace RECOMMENDATIONS {
-    export type ComponentType = 'PlantCarousel' | 'SelectionCarousel' | 'HeroCardsCarousel' | 'YourSelection'
-
-    interface BaseRecommendation {
-      id: string
-      componentType: ComponentType
-      title?: string
-      subtitle?: string
-      cardsVisible?: number
-    }
-
-    export interface PlantCarouselRecommendation extends BaseRecommendation {
-      componentType: 'PlantCarousel'
-      selection: SelectionI & { Plants?: PlantI[] }
-      displayRanking?: boolean
-    }
-
-    export interface SelectionCarouselRecommendation extends BaseRecommendation {
-      componentType: 'SelectionCarousel'
-      selections: SelectionI[]
-      displayRanking?: boolean
-    }
-
-    export interface HeroCardsCarouselRecommendation extends BaseRecommendation {
-      componentType: 'HeroCardsCarousel'
-      selections: SelectionI[]
-    }
-
-    export interface YourSelectionRecommendation extends BaseRecommendation {
-      componentType: 'YourSelection'
-    }
-
-    export interface ThemedRecommendationI {
-      id: string
-      label: string
-      icon: string
-      title?: string
-      subtitle?: string
-      selections: SelectionI[]
-      cardsVisible?: number
-      displayRanking?: boolean
-    }
-
-    export type RecommendationI =
-      | PlantCarouselRecommendation
-      | SelectionCarouselRecommendation
-      | HeroCardsCarouselRecommendation
-      | YourSelectionRecommendation
-
-    export interface Request {
-      headers: RequestHeaders
-    }
-
-    export interface Response {
-      recommendations: RecommendationI[]
-      themedRecommendations: ThemedRecommendationI[]
-    }
-  }
-  export namespace UPDATE {
-    export interface Request {
-      headers: RequestHeaders
-      body: {
-        city?: string
-        lastFreezingDate?: string | Date
-        firstFreezingDate?: string | Date
-        moveDatesRequested?: boolean
-        lastFertilizerIdChosen?: number
-        lastOrganicMatterPercentage?: number
-        unitSystem?: 'imperial' | 'metric'
-        gardenZoneTimelessPreference?: boolean
-      }
-    }
-    export type Response = MemberDataI
-  }
-  export namespace GIFT_CARDS {
-    export namespace REDEEM {
-      export interface Request {
-        headers: RequestHeaders
-        body: {
-          code: string
-        }
-      }
-      export interface Response {
-        success: boolean
-        message?: string
-        error?: string
-        error_message?: string
-      }
-    }
-  }
-}
+import type { DeviceDataI } from './device.d'
+import type { MemberI as MemberDataI } from './member.d'
+import type { SelectionI } from './selection.d'
+import type { PlantI } from './plant.d'
+
+interface RequestHeaders {
+  'x-session-token': string
+  'x-native-app-version'?: string
+  'x-application-type'?: 'react-native' | 'web'
+}
+
+export namespace USERS {
+  export namespace GET {
+    export interface Request {
+      headers: RequestHeaders
+      params: {
+        scopes: ('unreadNotificationsCount' | 'coordinates')[]
+      }
+    }
+    export type Response = MemberDataI & {
+      unreadAlertsCount?: number
+    }
+  }
+  export namespace DEVICES {
+    export interface Request {
+      headers: RequestHeaders
+      body: {
+        /** @see DeviceDataI */
+        userAgent?: DeviceDataI['userAgent']
+        platform?: DeviceDataI['platform']
+        version?: DeviceDataI['version']
+        model?: DeviceDataI['model']
+        name?: DeviceDataI['name']
+        appVersion?: DeviceDataI['appVersion']
+        pushKey?: DeviceDataI['pushKey']
+        apnsToken?: DeviceDataI['apnsToken']
+        fcmToken?: DeviceDataI['fcmToken']
+        webPushEndpoint?: DeviceDataI['webPushEndpoint']
+        webPushP256dh?: DeviceDataI['webPushP256dh']
+        webPushAuth?: DeviceDataI['webPushAuth']
+        webPushSubscription?: DeviceDataI['webPushSubscription']
+      }
+    }
+    export type Response = DeviceDataI
+  }
+  export namespace RECOMMENDATIONS {
+    export type ComponentType = 'PlantCarousel' | 'SelectionCarousel' | 'HeroCardsCarousel' | 'YourSelection'
+
+    interface BaseRecommendation {
+      id: string
+      componentType: ComponentType
+      title?: string
+      subtitle?: string
+      cardsVisible?: number
+    }
+
+    export interface PlantCarouselRecommendation extends BaseRecommendation {
+      componentType: 'PlantCarousel'
+      selection: SelectionI & { Plants?: PlantI[] }
+      displayRanking?: boolean
+    }
+
+    export interface SelectionCarouselRecommendation extends BaseRecommendation {
+      componentType: 'SelectionCarousel'
+      selections: SelectionI[]
+      displayRanking?: boolean
+    }
+
+    export interface HeroCardsCarouselRecommendation extends BaseRecommendation {
+      componentType: 'HeroCardsCarousel'
+      selections: SelectionI[]
+    }
+
+    export interface YourSelectionRecommendation extends BaseRecommendation {
+      componentType: 'YourSelection'
+    }
+
+    export interface ThemedRecommendationI {
+      id: string
+      label: string
+      icon: string
+      title?: string
+      subtitle?: string
+      selections: SelectionI[]
+      cardsVisible?: number
+      displayRanking?: boolean
+    }
+
+    export type RecommendationI =
+      | PlantCarouselRecommendation
+      | SelectionCarouselRecommendation
+      | HeroCardsCarouselRecommendation
+      | YourSelectionRecommendation
+
+    export interface Request {
+      headers: RequestHeaders
+    }
+
+    export interface Response {
+      recommendations: RecommendationI[]
+      themedRecommendations: ThemedRecommendationI[]
+    }
+  }
+  export namespace UPDATE {
+    export interface Request {
+      headers: RequestHeaders
+      body: {
+        city?: string
+        lastFreezingDate?: string | Date
+        firstFreezingDate?: string | Date
+        moveDatesRequested?: boolean
+        lastFertilizerIdChosen?: number
+        lastOrganicMatterPercentage?: number
+        unitSystem?: 'imperial' | 'metric'
+        gardenZoneTimelessPreference?: boolean
+      }
+    }
+    export type Response = MemberDataI
+  }
+  export namespace GIFT_CARDS {
+    export namespace REDEEM {
+      export interface Request {
+        headers: RequestHeaders
+        body: {
+          code: string
+        }
+      }
+      export interface Response {
+        success: boolean
+        message?: string
+        error?: string
+        error_message?: string
+      }
+    }
+  }
+}