@wollemia/remote-metadata

Read‑only snapshot of Cavuno's country and timezone metadata, exported as a single JSON file for use in any language (TS/JS, Python, Ruby, etc.).

What this package provides

The published npm package contains one file at the top level:

• remote-data.json – a JSON object with the following top‑level keys:
  • countries
  • worldRegionToAlpha2
  • continentToAlpha2
  • regionToAlpha2
  • subregionToAlpha2
  • timezoneOffsets
  • offsetToCountries
  • countryNameToAlpha2
  • timezoneLabels
  • allowedShortTags
  • timezoneLabelToOffsetHours
  • timezoneLabelToAbbreviation
  • worldRegionCopy
  • worldRegionToTz
  • alpha2ToWorldRegion

You can validate this JSON with the schema in:

• packages/data/remote-metadata/remote-data.schema.json

The shape of these values matches the exports from @kit/data-remote.

How it is generated

Inside this monorepo, the JSON is generated by:

• Script: packages/data/remote-metadata/scripts/export-json.ts
• Command (from repo root):
  pnpm --filter @wollemia/remote-metadata run build

This script imports from @kit/data-remote, builds the aggregate payload, and writes remote-data.json.

CI publishing

GitHub Actions workflow: .github/workflows/publish-remote-metadata.yml

• Triggers:
  • Manual: workflow_dispatch
  • Tag push: remote-metadata-v*
• Steps:
  • Install deps with pnpm install
  • Build JSON with pnpm --filter @wollemia/remote-metadata run build
  • Publish with npm publish --access public from packages/data/remote-metadata

Consuming from other repositories

TypeScript / JavaScript

If you depend on the published package directly:

import data from '@wollemia/remote-metadata/remote-data.json' assert { type: 'json' };

const countries = data.countries;

Python

import json
import requests

VERSION = "0.1.0"
url = f"https://unpkg.com/@wollemia/remote-metadata@{VERSION}/remote-data.json"

resp = requests.get(url, timeout=5)
resp.raise_for_status()
data = resp.json()

countries = data["countries"]

Ruby

require "net/http"
require "json"

VERSION = "0.1.0"
url = URI("https://unpkg.com/@wollemia/remote-metadata@#{VERSION}/remote-data.json")

res = Net::HTTP.get_response(url)
data = JSON.parse(res.body)

COUNTRIES = data["countries"].freeze

Update cadence

Publish a new version when:

• @kit/data-remote logic changes, or
• Its underlying data sources (world-countries, @vvo/tzdb) are updated and you want those changes reflected downstream.