# Source Cooperative — Fields of the World account (vector / parquet host).
# Path-as-id: registry/sources/source-coop/ftw.yaml resolves catalog ref `@source-coop/ftw`.
#
# Source Cooperative is a multi-tenant host (each "account" is a publisher's
# namespace). Per the catalog-per-account convention, each account gets its own
# YAML file under registry/sources/source-coop/. The FTW account hosts only the
# global-field-boundaries dataset today.

title: "Source Cooperative — Fields of the World"
endpoint: https://data.source.coop/ftw/
homepage: https://source.coop/repositories/ftw/global-field-boundaries/
operator: Source Cooperative (Radiant Earth) — hosting; data by Kerner Lab / TGI
backend: s3                              # AWS us-west-2 bucket fronted by Cloudflare CDN
bucket: us-west-2.opendata.source.coop
bucket_path: ftw/

aliases:
  - ftw-source-coop

auth:
  mode: anonymous

cors_enabled: true                       # ACAO: * verified on data.source.coop responses
egress_cost: free                        # AWS Open Data sponsorship + Cloudflare CDN
region: us-west-2

notes: |
  Source Cooperative serves datasets via two equivalent URLs:
    - Cloudflare-fronted CDN: https://data.source.coop/<account>/<repo>/<file>
    - S3 virtual-hosted:      https://us-west-2.opendata.source.coop.s3.<region>.amazonaws.com/...
  Both anonymous, both CORS. The CDN URL is preferred for browser fetches;
  the S3 URL is preferred for boto3/awscli + range-read patterns.

  Bucket directory listing requires the S3 API path (the bare CDN dir URL
  returns 404 — confirmed 2026-06-07). Per-file fetches work fine via either.