refactor: move phrase for procssing level into utils folder

datapage/Datapage.ts

@@ -18,6 +18,7 @@ import {
     getAttributionFragmentsFromVariable,
     getLastUpdatedFromVariable,
     getNextUpdateFromVariable,
+    OwidProcessingLevel,
 } from "@ourworldindata/utils"
 import { ExplorerProgram } from "../explorer/ExplorerProgram.js"
 import { Gdoc } from "../db/model/Gdoc/Gdoc.js"
@@ -28,7 +29,8 @@ export const getDatapageDataV2 = async (
     partialGrapherConfig: GrapherInterface
 ): Promise<DataPageDataV2> => {
     {
-        const processingLevel = variableMetadata.processingLevel ?? "minor"
+        const processingLevel =
+            variableMetadata.processingLevel ?? OwidProcessingLevel.minor
         const lastUpdated = getLastUpdatedFromVariable(variableMetadata) ?? ""
         const nextUpdate = getNextUpdateFromVariable(variableMetadata)
         const datapageJson: DataPageDataV2 = {

db/model/Variable.ts

@@ -13,6 +13,7 @@ import {
     OwidVariableId,
     retryPromise,
     OwidLicense,
+    OwidProcessingLevel,
 } from "@ourworldindata/utils"
 import {
     GrapherInterface,
@@ -41,7 +42,7 @@ export interface VariableRow {
     catalogPath?: string
     dimensions?: Dimensions
     schemaVersion?: number
-    processingLevel?: "minor" | "major"
+    processingLevel?: OwidProcessingLevel
     titlePublic?: string
     titleVariant?: string
     attributionShort?: string

packages/@ourworldindata/components/src/IndicatorKeyData/IndicatorKeyData.tsx

@@ -1,5 +1,9 @@
 import React from "react"
-import { dayjs } from "@ourworldindata/utils"
+import {
+    dayjs,
+    OwidProcessingLevel,
+    getPhraseForProcessingLevel,
+} from "@ourworldindata/utils"
 import { DATAPAGE_SOURCES_AND_PROCESSING_SECTION_ID } from "../SharedDataPageConstants.js"
 
 interface IndicatorKeyDataProps {
@@ -8,16 +12,15 @@ interface IndicatorKeyDataProps {
     lastUpdated: string
     nextUpdate?: string
     unit?: string
-    owidProcessingLevel?: "minor" | "major"
+    owidProcessingLevel?: OwidProcessingLevel
     canonicalUrl?: string
 }
 
 export const IndicatorKeyData = (props: IndicatorKeyDataProps) => {
     const canonicalUrl = props.canonicalUrl ?? ""
-    const processedAdapted =
-        props.owidProcessingLevel === "minor"
-            ? `minor processing`
-            : `major adaptations`
+    const processedAdapted = getPhraseForProcessingLevel(
+        props.owidProcessingLevel ?? OwidProcessingLevel.minor
+    )
     const dateRange = getDateRange(props.dateRange)
     const lastUpdated = dayjs(props.lastUpdated, ["YYYY", "YYYY-MM-DD"])
     const keyDataCount = 3 + (props.nextUpdate ? 1 : 0) + (props.unit ? 1 : 0)

packages/@ourworldindata/utils/src/OwidVariable.ts

@@ -69,7 +69,7 @@ export interface OwidVariableWithSource {
     source?: OwidSource
     origins?: OwidOrigin[]
     schemaVersion?: number
-    processingLevel?: "minor" | "major"
+    processingLevel?: OwidProcessingLevel
     presentation?: OwidVariablePresentation
     shortName?: string
     timespan?: string
@@ -100,6 +100,11 @@ export interface OwidVariablePresentation {
     faqs?: FaqLink[]
 }
 
+export enum OwidProcessingLevel {
+    minor = "minor",
+    major = "major",
+}
+
 export interface FaqLink {
     gdocId: string
     fragmentId: string

packages/@ourworldindata/utils/src/index.ts

@@ -350,6 +350,7 @@ export {
     formatAuthors,
     getLastUpdatedFromVariable,
     getNextUpdateFromVariable,
+    getPhraseForProcessingLevel,
 } from "./metadataHelpers.js"
 
 export {
@@ -496,6 +497,7 @@ export {
     type OwidVariablePresentation,
     type OwidEntityKey,
     type OwidLicense,
+    OwidProcessingLevel,
 } from "./OwidVariable.js"
 
 export {

packages/@ourworldindata/utils/src/metadataHelpers.ts

@@ -1,5 +1,5 @@
 import { OwidOrigin } from "./OwidOrigin"
-import { OwidVariableWithSource } from "./OwidVariable"
+import { OwidProcessingLevel, OwidVariableWithSource } from "./OwidVariable"
 import { compact, uniq, last } from "./Util"
 import dayjs from "./dayjs.js"
 
@@ -101,3 +101,7 @@ export const getNextUpdateFromVariable = (
     }
     return nextUpdate
 }
+
+export const getPhraseForProcessingLevel = (
+    processingLevel: OwidProcessingLevel
+) => (processingLevel === "major" ? "major adaptations" : "minor processing")

packages/@ourworldindata/utils/src/owidTypes.ts

@@ -3,6 +3,7 @@ import { Static, Type } from "@sinclair/typebox"
 import { gdocUrlRegex } from "./GdocsConstants.js"
 import { OwidOrigin } from "./OwidOrigin.js"
 import { OwidSource } from "./OwidSource.js"
+import { OwidProcessingLevel } from "./OwidVariable.js"
 
 // todo: remove when we ditch Year and YearIsDay
 export const EPOCH_DATE = "2020-01-21"
@@ -1482,7 +1483,7 @@ export interface DataPageDataV2 {
     faqs: FaqLink[] // Todo: resolve these at this level to the point where we can preview them
     descriptionKey: string[]
     descriptionProcessing?: string
-    owidProcessingLevel: "minor" | "major"
+    owidProcessingLevel: OwidProcessingLevel
     dateRange: string
     lastUpdated: string
     nextUpdate?: string

site/DataPageV2Content.tsx

@@ -21,6 +21,7 @@ import {
     uniq,
     pick,
     formatAuthors,
+    getPhraseForProcessingLevel,
 } from "@ourworldindata/utils"
 import { AttachmentsContext, DocumentContext } from "./gdocs/OwidGdoc.js"
 import StickyNav from "./blocks/StickyNav.js"
@@ -120,10 +121,9 @@ export const DataPageV2Content = ({
             ? `${attributionFragments[0]} and other sources`
             : attributionFragments.join(", ")
     const attributionUnshortened = attributionFragments.join(", ")
-    const processedAdapted =
-        datapageData.owidProcessingLevel === "minor"
-            ? `minor processing`
-            : `major adaptations`
+    const processedAdapted = getPhraseForProcessingLevel(
+        datapageData.owidProcessingLevel
+    )
     const lastUpdated = dayjs(datapageData.lastUpdated, ["YYYY", "YYYY-MM-DD"])
     const yearOfUpdate = lastUpdated.year()
     const citationShort = `${attributionPotentiallyShortened} – with ${processedAdapted} by Our World In Data (${yearOfUpdate})`