api-services

This repository contains Videre's API-facing TypeScript services:

Service	Purpose
services/videre-api	Cloudflare Worker API for Magic: The Gathering data.
services/videre-bot	Cloudflare Worker Discord bot and interaction handler.

The repo is a small pnpm workspace over services/*, with shared TypeScript defaults in tsconfig.base.json.

Setup

Use Node.js 18 or newer. pnpm is pinned through Corepack:

corepack enable
pnpm install

Commands

Run a service locally:

pnpm --filter videre-api run dev
pnpm --filter videre-bot run dev

Deploy a service:

pnpm --filter videre-api run deploy
pnpm --filter videre-bot run deploy

Sync Discord commands for the bot:

pnpm --filter videre-bot run sync
pnpm --filter videre-bot run sync:dev

Run the API regression tests:

pnpm --filter videre-api test

To include HTTP route checks against a running local API Worker, start the API and pass its base URL:

VIDERE_API_BASE_URL=http://localhost:8787 pnpm --filter videre-api test

The root dev and deploy scripts run the matching script across every workspace.

API Docs

• API Overview
• Cards API
• Sets API
• Products API
• Prices API
• Events API
• Decks API
• Matches API
• Standings API
• Metagame API
• Archetypes API
• Matchups API
• MTGO Manifest API
• Card Search Syntax
• Data Sources And Freshness
• Rate Limits
• Responses And Errors

License

Apache-2.0 License.