SW: Unlimited card scanner API

const { ticket } = await fetch("https://api.tcggraph.com/v1/scan/tickets", {
  method: "POST",
  headers: { authorization: `Bearer ${process.env.TCGGRAPH_KEY}` },
}).then((r) => r.json());

const socket = new WebSocket(`wss://api.tcggraph.com/v1/scan?ticket=${ticket}`);

socket.onopen = () => {
  socket.send(
    JSON.stringify({
      type: "config",
      games: ["star-wars-unlimited"],
      minConfidence: 0.92,
    }),
  );
  // A JPEG straight off the camera, 1280 px across at quality 70.
  socket.send(camera.latestJpeg());
};

socket.onmessage = (event) => {
  const frame = JSON.parse(event.data);

  for (const match of frame.matches ?? []) {
    // printingResolved: set, number and language are settled. finishResolved:
    // the record has one finish. Either false is a choice for the operator.
    intake.add(match.card, match.printingResolved && match.finishResolved, match.alternatives);
  }

  // Unresolved frames arrive too, and cost nothing.
  for (const miss of frame.unresolved ?? []) showHint(miss.reason);

  // Every frame is answered. One in flight at a time: the next goes now.
  if (frame.type === "match" || frame.type === "unresolved" || frame.type === "error") {
    socket.send(camera.latestJpeg());
  }
};

{
  "requestId": "scan_01K5Z8P4XQJ7YB3M",
  "latencyMs": 41,
  "matches": [
    {
      "confidence": 0.9962,
      "billed": true,
      "box": {
        "x": 0.171,
        "y": 0.064,
        "w": 0.658,
        "h": 0.872
      },
      "corners": [
        {
          "x": 0.183,
          "y": 0.064
        },
        {
          "x": 0.829,
          "y": 0.071
        },
        {
          "x": 0.817,
          "y": 0.936
        },
        {
          "x": 0.171,
          "y": 0.928
        }
      ],
      "distance": 21,
      "printingResolved": true,
      "finishResolved": true,
      "card": {
        "id": "swu_ibh_52",
        "game": "star-wars-unlimited",
        "name": "Watch This",
        "set": {
          "code": "IBH",
          "name": "In the Blast Shadow"
        },
        "rarity": "Special",
        "prices": [
          {
            "source": "tcgplayer",
            "region": "NA",
            "currency": "USD",
            "market": 19.02
          },
          {
            "source": "cardmarket",
            "region": "EU",
            "currency": "EUR",
            "market": 13.88,
            "trend": 13.88,
            "avg7": 14.14
          }
        ]
      },
      "alternatives": []
    }
  ],
  "scans": {
    "billed": 1,
    "remaining": 5842
  }
}