@la-main-verte/shared-types 1.0.88 → 1.0.89

package/package.json

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

package/src/audience.d.ts

@@ -1,86 +1,93 @@
-/**
- * Audience targeting shared types
- * -------------------------------
- * An Audience is a reusable, named set of targeting criteria. Membership is
- * precomputed into a join table, so these shapes describe the *definition* of
- * an audience, not its resolved members.
- *
- * Criteria are heterogeneous and open-ended: each `type` has its own `params`.
- * The canonical runtime validation lives in the zod discriminated union at
- * `server/domains/audience/criterion.schema.ts`; keep these types in sync with it.
- */
-
-/** How an audience combines its criteria. */
-export type AudienceCombinator = 'all' | 'any'
-
-/** Member within `radiusKm` of a point. `label` is a human-readable origin (e.g. a city name). */
-export interface GeoRadiusCriterion {
-  type: 'geo_radius'
-  params: {
-    latitude: number
-    longitude: number
-    radiusKm: number
-    label?: string
-  }
-}
-
-/**
- * Member whose `countryCode` matches (ISO 3166-1 alpha-2, e.g. "CA", "US", "FR").
- * @see documentation/geographic-targeting.md
- */
-export interface CountryCriterion {
-  type: 'country'
-  params: { countryCode: string }
-}
-
-/**
- * Member whose `provinceCode` matches (ISO 3166-2 subdivision code, e.g. "CA-QC", "US-CA", "FR-IDF").
- * @see documentation/geographic-targeting.md
- */
-export interface ProvinceCriterion {
-  type: 'province'
-  params: { provinceCode: string }
-}
-
-/** Member whose `city` matches (case-insensitive). */
-export interface CityCriterion {
-  type: 'city'
-  params: { cityName: string }
-}
-
-/** Member owns at least one GardenMap of the given category (e.g. "greenhouse"). */
-export interface GardenMapCategoryCriterion {
-  type: 'garden_map_category'
-  params: { category: string }
-}
-
-/**
- * Behavioral: member who was active on at least `minDistinctDays` distinct
- * calendar days (counted from SessionEvents) within the last `windowDays`.
- * Time-relative — evaluated at recompute time, so the daily refresh cron keeps
- * the trailing window honest.
- */
-export interface ActivityDistinctDaysCriterion {
-  type: 'activity_distinct_days'
-  params: { minDistinctDays: number; windowDays: number }
-}
-
-export type AudienceCriterion =
-  | GeoRadiusCriterion
-  | CountryCriterion
-  | ProvinceCriterion
-  | CityCriterion
-  | GardenMapCategoryCriterion
-  | ActivityDistinctDaysCriterion
-
-export type AudienceCriterionType = AudienceCriterion['type']
-
-export interface AudienceI {
-  id: number
-  name: string
-  description: string | null
-  combinator: AudienceCombinator
-  criteria: AudienceCriterion[]
-  createdAt: Date
-  updatedAt: Date
-}
+/**
+ * Audience targeting shared types
+ * -------------------------------
+ * An Audience is a reusable, named set of targeting criteria. Membership is
+ * precomputed into a join table, so these shapes describe the *definition* of
+ * an audience, not its resolved members.
+ *
+ * Criteria are heterogeneous and open-ended: each `type` has its own `params`.
+ * The canonical runtime validation lives in the zod discriminated union at
+ * `server/domains/audience/criterion.schema.ts`; keep these types in sync with it.
+ */
+
+/** How an audience combines its criteria. */
+export type AudienceCombinator = 'all' | 'any'
+
+/** Member within `radiusKm` of a point. `label` is a human-readable origin (e.g. a city name). */
+export interface GeoRadiusCriterion {
+  type: 'geo_radius'
+  params: {
+    latitude: number
+    longitude: number
+    radiusKm: number
+    label?: string
+  }
+}
+
+/**
+ * Member whose `countryCode` matches (ISO 3166-1 alpha-2, e.g. "CA", "US", "FR").
+ * @see documentation/geographic-targeting.md
+ */
+export interface CountryCriterion {
+  type: 'country'
+  params: { countryCode: string }
+}
+
+/**
+ * Member whose `provinceCode` matches (ISO 3166-2 subdivision code, e.g. "CA-QC", "US-CA", "FR-IDF").
+ * @see documentation/geographic-targeting.md
+ */
+export interface ProvinceCriterion {
+  type: 'province'
+  params: { provinceCode: string }
+}
+
+/** Member whose `city` matches (case-insensitive). */
+export interface CityCriterion {
+  type: 'city'
+  params: { cityName: string }
+}
+
+/** Member owns at least one GardenMap of the given category (e.g. "greenhouse"). */
+export interface GardenMapCategoryCriterion {
+  type: 'garden_map_category'
+  params: { category: string }
+}
+
+/** Member has the given plant placed in at least one non-deleted garden zone culture. */
+export interface PlantInGardenCriterion {
+  type: 'plant_in_garden'
+  params: { plantSlug: string }
+}
+
+/**
+ * Behavioral: member who was active on at least `minDistinctDays` distinct
+ * calendar days (counted from SessionEvents) within the last `windowDays`.
+ * Time-relative — evaluated at recompute time, so the daily refresh cron keeps
+ * the trailing window honest.
+ */
+export interface ActivityDistinctDaysCriterion {
+  type: 'activity_distinct_days'
+  params: { minDistinctDays: number; windowDays: number }
+}
+
+export type AudienceCriterion =
+  | GeoRadiusCriterion
+  | CountryCriterion
+  | ProvinceCriterion
+  | CityCriterion
+  | GardenMapCategoryCriterion
+  | PlantInGardenCriterion
+  | ActivityDistinctDaysCriterion
+
+export type AudienceCriterionType = AudienceCriterion['type']
+
+export interface AudienceI {
+  id: number
+  name: string
+  description: string | null
+  combinator: AudienceCombinator
+  criteria: AudienceCriterion[]
+  createdAt: Date
+  updatedAt: Date
+}

package/src/fertilizer.d.ts

@@ -1,55 +1,67 @@
-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[]
-}
+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
+  /**
+   * Bulk density in kg/L, used to convert quantities to litres or cubic yards.
+   * Null for fertilizers without a known density.
+   */
+  volumetricDensity: number | null
+  /**
+   * Controls how the quantity is displayed in the garden overview.
+   * - `'weight'`: kg/g, plus cubic yards if ≥ 1 yd³ (default for most bulk organics)
+   * - `'litre'`: solid products sold by volume (e.g. bagged compost) — L for small, yd³ for large
+   * - `'liquid'`: true liquid products (e.g. liquid seaweed) — L or mL only, never cubic yards
+   */
+  presentationMode: 'weight' | 'litre' | 'liquid'
+}
+
+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[]
+}