A lightweight Cloudflare Workers api and proxy service for HERE API endpoints, iOS universal links, etc. with Sentry monitoring.

• Bun installed
• Cloudflare account
• HERE API key
• Sentry account (optional but recommended for error logging)

bun install

Copy the example file and fill in your credentials:

cp .dev.vars.example .dev.vars

Edit .dev.vars with your actual values:

HERE_API_KEY=your_here_api_key
SENTRY_DSN=https://[email protected]/project-id

Run the development server:

bun run dev

The service will be available at http://localhost:8787

# Autocomplete
curl "http://localhost:8787/autocomplete?q=cincinnati&limit=5"

# Geocode
curl "http://localhost:8787/geocode?q=48 Muir+Rd,+Rogers,+KY+41365"

# Health check
curl "http://localhost:8787/health"

Set secrets (one-time setup):

bunx wrangler secret put HERE_API_KEY
# Paste your HERE API key when prompted

bunx wrangler secret put SENTRY_DSN
# Paste your Sentry DSN when prompted

Verify secrets are set:

bunx wrangler secret list

Deploy to Cloudflare Workers:

bun run deploy

The project includes CI/CD that deploys automatically on git tags.

Go to your repo → Settings → Secrets and variables → Actions

Add these secrets:

• CLOUDFLARE_API_TOKEN - Get from Cloudflare Dashboard
• HERE_API_KEY - Your HERE API key
• SENTRY_DSN - Your Sentry DSN

1. Go to Cloudflare API Tokens
2. Click "Create Token"
3. Use "Edit Cloudflare Workers" template
4. Copy the token and add it to GitHub secrets as CLOUDFLARE_API_TOKEN

git tag v1.0.0
git push origin v1.0.0

GitHub Actions will automatically deploy to Cloudflare Workers. Monitor deployment in the Actions tab.

Proxies to HERE Autocomplete API.

Example request:

curl "https://your-worker.workers.dev/autocomplete?q=Seattle&limit=5"

Query parameters:

• q: Search query (required)
• limit: Max number of suggestions
• in: Geographic filter (e.g., circle:47.6,-122.3;r=50000)
• All other HERE Autocomplete API parameters and docs

Note: The apiKey parameter is automatically injected by the proxy. Any apiKey sent by the client will be removed.

Proxies to HERE Geocode API.

Example request:

curl "https://your-worker.workers.dev/geocode?q=1600+Amphitheatre+Parkway"

Query parameters:

• q: Address to geocode (required)
• All other HERE Geocode API parameters and docs

Note: The apiKey parameter is automatically injected by the proxy. Any apiKey sent by the client will be removed.

Serves the AASA JSON used by iOS to validate universal links for contact sharing. Lists both dev (com.leviwilkerson.jwtimedev) and prod (com.leviwilkerson.jwtime) bundle IDs, prefixed with APPLE_TEAM_ID.

Matches any URL under /c/*.

Universal-link landing page for shared WitnessWork contacts. iOS hands the request off to the WitnessWork app when installed; otherwise this endpoint serves a fallback HTML page with an App Store CTA.

The payload segment is an opaque gzip + base64url–encoded contact export produced by the app — the worker never decodes it.

Health check endpoint.

Response:

{
  "status": "ok",
  "timestamp": "2024-11-27T12:34:56.789Z"
}

All errors return JSON with an error field:

{
  "error": "Error message"
}

All errors are automatically reported to Sentry with full context.

Client Request
    ↓
Cloudflare Workers (Global Edge)
    ↓
Hono Router
    ↓
API Key Injection & Sanitization
    ↓
HERE API
    ↓
Response to Client

(Sentry monitors all errors)

• Runtime: Cloudflare Workers with nodejs_compat
• Framework: Hono
• Language: TypeScript
• Package Manager: Bun
• Monitoring: Sentry
• Wrangler: v4.42.2