feat: Migrate geographies to API v2 alpha

.github/workflows/pr.yaml

@@ -2,9 +2,6 @@ name: PR checks
 
 on:
   pull_request:
-    branches:
-      - main
-      - master
 
 jobs:
   lint:

app/src/adapters/RegionsAdapter.ts

@@ -0,0 +1,34 @@
+import { V2RegionMetadata } from '@/api/v2';
+import { MetadataRegionEntry } from '@/types/metadata';
+
+/**
+ * Adapter for converting between V2 API region data and internal formats
+ */
+export class RegionsAdapter {
+  /**
+   * Convert a single V2 region to frontend MetadataRegionEntry
+   *
+   * Maps API fields to the existing frontend region structure:
+   * - code -> name (the unique identifier)
+   * - label -> label (display name)
+   * - region_type -> type
+   * - state_code -> state_abbreviation
+   * - state_name -> state_name
+   */
+  static regionFromV2(region: V2RegionMetadata): MetadataRegionEntry {
+    return {
+      name: region.code,
+      label: region.label,
+      type: region.region_type as MetadataRegionEntry['type'],
+      state_abbreviation: region.state_code ?? undefined,
+      state_name: region.state_name ?? undefined,
+    };
+  }
+
+  /**
+   * Convert V2 regions array to frontend MetadataRegionEntry array
+   */
+  static regionsFromV2(regions: V2RegionMetadata[]): MetadataRegionEntry[] {
+    return regions.map((r) => RegionsAdapter.regionFromV2(r));
+  }
+}

app/src/adapters/SimulationAdapter.ts

@@ -76,9 +76,15 @@ export class SimulationAdapter {
       throw new Error('Simulation must have a populationType');
     }
 
+    // Map internal Simulation fields to V2-style payload
+    if (simulation.populationType === 'geography') {
+      return {
+        region: simulation.populationId,
+        policy_id: parseInt(simulation.policyId, 10),
+      };
+    }
     return {
-      population_id: simulation.populationId,
-      population_type: simulation.populationType,
+      household_id: simulation.populationId,
       policy_id: parseInt(simulation.policyId, 10),
     };
   }

app/src/adapters/index.ts

@@ -5,12 +5,12 @@ export { ReportAdapter } from './ReportAdapter';
 export { HouseholdAdapter } from './HouseholdAdapter';
 export { MetadataAdapter } from './MetadataAdapter';
 export type { DatasetEntry } from './MetadataAdapter';
+export { RegionsAdapter } from './RegionsAdapter';
 
 // User Ingredient Adapters
 export { UserReportAdapter } from './UserReportAdapter';
 export { UserSimulationAdapter } from './UserSimulationAdapter';
 export { UserHouseholdAdapter } from './UserHouseholdAdapter';
-export { UserGeographicAdapter } from './UserGeographicAdapter';
 
 // Conversion Helpers
 export {

app/src/api/policyAssociation.ts

@@ -11,7 +11,11 @@ export interface UserPolicyStore {
   create: (policy: Omit<UserPolicy, 'id' | 'createdAt'>) => Promise<UserPolicy>;
   findByUser: (userId: string, countryId?: string) => Promise<UserPolicy[]>;
   findById: (userPolicyId: string) => Promise<UserPolicy | null>;
-  update: (userPolicyId: string, updates: Partial<UserPolicy>, userId: string) => Promise<UserPolicy>;
+  update: (
+    userPolicyId: string,
+    updates: Partial<UserPolicy>,
+    userId: string
+  ) => Promise<UserPolicy>;
   delete: (userPolicyId: string, userId: string) => Promise<void>;
 }
 
@@ -71,9 +75,7 @@ export class LocalStoragePolicyStore implements UserPolicyStore {
 
   async findByUser(userId: string, countryId?: string): Promise<UserPolicy[]> {
     const policies = this.getStoredPolicies();
-    return policies.filter(
-      (p) => p.userId === userId && (!countryId || p.countryId === countryId)
-    );
+    return policies.filter((p) => p.userId === userId && (!countryId || p.countryId === countryId));
   }
 
   async findById(userPolicyId: string): Promise<UserPolicy | null> {

app/src/api/simulation.ts

@@ -44,13 +44,21 @@ export async function createSimulation(
 ): Promise<{ result: { simulation_id: string } }> {
   const url = `${BASE_URL}/${countryId}/simulation`;
 
+  // Translate V2-style payload to V1 wire format; note this is temporary
+  // until we migrate to v2 simulation in a future PR
+  const v1Payload = {
+    population_id: data.region ?? data.household_id,
+    population_type: data.region ? 'geography' : 'household',
+    policy_id: data.policy_id,
+  };
+
   const response = await fetch(url, {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',
       Accept: 'application/json',
     },
-    body: JSON.stringify(data),
+    body: JSON.stringify(v1Payload),
   });
 
   if (!response.ok) {

app/src/api/v2/index.ts

@@ -21,3 +21,6 @@ export { fetchParameterValues, BASELINE_POLICY_ID } from './parameterValues';
 
 // Datasets
 export { fetchDatasets } from './datasets';
+
+// Regions
+export { fetchRegions, fetchRegionByCode, type V2RegionMetadata } from './regions';