fix: update source api types to match S2 codebase

[alukach]

What I'm changing

Currently, some buckets/prefixes return parse errors while others do not:

• ✅ https://data.source.coop/harvard-lil?list-type=1&prefix=gov-data
• ❌ https://data.source.coop/youssef-harby?list-type=1&prefix=weather-station-realtime-parquet

  Internal Server Error: failed to parse JSON (url https://source.coop/api/v1/products/youssef-harby/weather-station-realtime-parquet)
  

The core issue regarding why the second API response failed to parse is that the youssef-harby account contains a populated metadata_public.domains array:

▶ curl -s https://source.coop/api/v1/products/youssef-harby/weather-station-realtime-parquet | jq .account.metadata_public.domains
[
  {
    "created_at": "2025-09-27T20:25:04.246Z",
    "domain": "youssefharby.com",
    "status": "unverified"
  }
]

Note that the account used in the successful API response lacks a populated metadata_public.domains array:

▶ curl -s https://source.coop/api/v1/products/harvard-lil/gov-data | jq .account.metadata_public.domains                   
[]

The proxy fails when it encounters a populated domain array due to the fact that the domain struct in the data proxy codebase does not match the API response. On the API, the status value is an enum¹ added in S2:

export const AccountDomainSchema = z.object({
  domain: z.string(),
  status: z.enum(["unverified", "pending", "verified"]),
  // ...
});

However, the data proxy is expecting the legacy schema where a domain would merely have a boolean verified property:

data.source.coop/src/apis/source.rs

Lines 100 to 104 in f497d48

	#[derive(Debug, Clone, Serialize, Deserialize)]
	pub struct AccountDomain {
	pub domain: String,
	pub verified: bool,
	}

How I did it

In this PR, we update the expected API schema to match the schema from within the source.coop codebase, namely within the following files:

• https://github.com/source-cooperative/source.coop/blob/c49aa11bb3f7a7bfd7caa40ff66193f9fe437b08/src/types/product_v2.ts
• https://github.com/source-cooperative/source.coop/blob/c49aa11bb3f7a7bfd7caa40ff66193f9fe437b08/src/types/account.ts

I let Cursor AI take the wheel to update these types.

Also added tests with the real (but anonymized) data returned from https://source.coop/api/v1/products/youssef-harby/weather-station-realtime-parquet to ensure parsing would not throw an error.

Finally, improved the documentation of the file.

How to test it

• See ce22b16, note that tests fail
• See c9a9bbc, note that tests are now passing

PR Checklist

• This PR has no breaking changes.
• I have updated or added new tests to cover the changes in this PR.
• This PR affects the Source Cooperative Frontend & API,
  and I have opened issue/PR #XXX to track the change.

Related Issues

Footnotes

1. https://github.com/source-cooperative/source.coop/blob/c49aa11bb3f7a7bfd7caa40ff66193f9fe437b08/src/types/account.ts#L52 ↩

[yharby]

@alukach Thank you so much 🙌

[jedsundwall]

Thanks for jumping on this one! Weird!