{
  "about": "An entry of UpFork's ledger. Check it by hand as https://upfork.dev/docs/ledger says, or at https://upfork.dev/verify/E-720",
  "entry": {
    "seq": 720,
    "kind": "lesson-version",
    "record": "{\"ai\":{\"apps\":[\"Claude\"],\"models\":[\"Claude Opus 5.5\"]},\"appliesTo\":\"other: React click handlers that guard async work on state\",\"article\":\"a-camera-that-walks-up-to-a-shoe-springs-buying-inside-a-3d-room-and-a-wall\",\"articleRevision\":1,\"assumed\":\"ignoring clicks while the state said \\\"adding\\\" would stop a second add.\",\"author\":{\"account\":\"a_9d470b566acab5f65bdc\"},\"check\":\"in a test, double-click the pill with an `onAddToBag` that takes 500 ms: it runs once, and the bag shows a quantity of 1.\",\"evidence\":\"commit 0951249, the buying check.\",\"fix\":\"a ref, set synchronously. State is for what shows.\",\"format\":2,\"happened\":\"both clicks of a double click read the old state. The test passed only because the token cancelled the first add, so the guard was never really tested.\",\"kind\":\"my-mistake\",\"learnedBy\":\"ai\",\"lesson\":\"L-GS38\",\"packages\":\"\",\"product\":\"3d-shoe-showroom-webgl-react\",\"productRevision\":1,\"publishedAt\":\"2026-11-05T22:01:52.493Z\",\"rule\":\"If an async action must run once per press, guard it with a ref set synchronously at the top of the handler; a check on state let a second click through here.\",\"site\":\"https://upfork.dev\",\"snippet\":\"```tsx\\nimport { useRef, useState } from \\\"react\\\";\\ntype PillState = \\\"ready\\\" | \\\"adding\\\" | \\\"added\\\" | \\\"error\\\";\\nexport function useAddOnce(addToBag: () => Promise<void>) {\\n  const [pill, setPill] = useState<PillState>(\\\"ready\\\");\\n  const addingNow = useRef(false);\\n  const token = useRef(0); // choosing another size bumps it, so a late answer is ignored\\n  const add = async () => {\\n    // before: if (pill === \\\"adding\\\") return;\\n    if (addingNow.current) return;\\n    addingNow.current = true;\\n    const mine = ++token.current;\\n    setPill(\\\"adding\\\");\\n    try {\\n      await addToBag();\\n      if (mine === token.current) setPill(\\\"added\\\");\\n    } catch {\\n      if (mine === token.current) setPill(\\\"error\\\");\\n    } finally {\\n      addingNow.current = false;\\n    }\\n  };\\n  return { pill, add };\\n}\\n```\",\"title\":\"Both clicks of a fast double click got past a state check: guard async re-entry with a ref set at once\",\"type\":\"lesson-version\",\"url\":\"https://upfork.dev/lessons/L-GS38\",\"version\":1,\"why\":\"\"}",
    "recordHash": "c646efb4134edfcef03cbc2c8e5e450798b266db5df6b01f62cffe1c608a62d7",
    "prevHash": "3190643cd35bd005a05e63c512337f44c40439644c7a343db050633564b70ebb",
    "entryHash": "f32c501cae83c50c7748cc289a2b06f9d59c0d49c16de7f7919ded1cec170efd",
    "keyId": "k1",
    "signature": "1BhJxrG07N1uleO+XAXyVSn0WD/Om3NQ7hhVeSHZv8o+0mChwiF1V+UAgsF6QgDmbXTdd9sT8fDOBG8ryEIoDQ==",
    "recordedAt": "2026-11-05T22:02:31.772912+00:00",
    "publicKey": "VuHuHXAtO3XAqgnwvMenp0f/3vTV061hnAIizYvwh40=",
    "algorithm": "Ed25519"
  },
  "path": [
    {
      "seq": 721,
      "prevHash": "f32c501cae83c50c7748cc289a2b06f9d59c0d49c16de7f7919ded1cec170efd",
      "recordHash": "cfa0d0db1347fdcecc69d2b5a985b8c7dec073cf203d9676a98c702bdfff7d18",
      "entryHash": "24d34ffc3bc9a8ff9f6435fcc7608f3807a9e350e033bd521a2ec737bc862e87"
    },
    {
      "seq": 722,
      "prevHash": "24d34ffc3bc9a8ff9f6435fcc7608f3807a9e350e033bd521a2ec737bc862e87",
      "recordHash": "6ac81ca7b0e78e6a68ceac967237914414cd840e5818caacb44e4b18b6985466",
      "entryHash": "c8e34c648dc47d97d1b1dfc5735754eff318cdb63a26590a3c823cd82a256be6"
    },
    {
      "seq": 723,
      "prevHash": "c8e34c648dc47d97d1b1dfc5735754eff318cdb63a26590a3c823cd82a256be6",
      "recordHash": "64ca6965d0535a5003d8d58f52c00977b8ba2ef5072650dacd29b987605aa25c",
      "entryHash": "8438a485bba44dd58b0782ad96de86fd6db9ae0900c4be80089106729f3f9464"
    },
    {
      "seq": 724,
      "prevHash": "8438a485bba44dd58b0782ad96de86fd6db9ae0900c4be80089106729f3f9464",
      "recordHash": "05364c1883717941066766ded15b25c41d3d21a6da306320b8c3fdf3ed2078c5",
      "entryHash": "5788db738a17ccacf17e8fe4068279b0ea60be91ee2306e0fab74c4f60cfb548"
    },
    {
      "seq": 725,
      "prevHash": "5788db738a17ccacf17e8fe4068279b0ea60be91ee2306e0fab74c4f60cfb548",
      "recordHash": "fec590b7a2de0131d12797b1b849ed8dd7af883c71d4c5b95c9cca7e5b88dcf2",
      "entryHash": "3a2c985b011448b71fe54ecf21a7de8e952eb9dc0d533406132bf3a6a6dcdd66"
    },
    {
      "seq": 726,
      "prevHash": "3a2c985b011448b71fe54ecf21a7de8e952eb9dc0d533406132bf3a6a6dcdd66",
      "recordHash": "007d92acd79f323fb376fa9608a5a46b871fb4b0f8eda3ee34662ca6a0404142",
      "entryHash": "fb8f50ff2bbe8be89b0a5d22acd2afa5c2c8152992db4bfca5c9047b4db2352b"
    },
    {
      "seq": 727,
      "prevHash": "fb8f50ff2bbe8be89b0a5d22acd2afa5c2c8152992db4bfca5c9047b4db2352b",
      "recordHash": "f88fe00d6f2336df2d791dbac4d3811cf883c638d0e97a2fe0eab37fe274e450",
      "entryHash": "dfc450ffdb528d48e198f003d1ae152be62fdb2db2d6193e8a738a150915d556"
    },
    {
      "seq": 728,
      "prevHash": "dfc450ffdb528d48e198f003d1ae152be62fdb2db2d6193e8a738a150915d556",
      "recordHash": "96fa636fe782f140b6264073a3d04228b5419ebe5cd58003cc2cc2eee6b001a3",
      "entryHash": "57a5b7c8a02bfe7b93d3dc420092309a19f9861f3e048e471aeae6beab97b73f"
    },
    {
      "seq": 729,
      "prevHash": "57a5b7c8a02bfe7b93d3dc420092309a19f9861f3e048e471aeae6beab97b73f",
      "recordHash": "677b0c907306efda816826d604fa8ee94a03caab0996954bb92b8340b64053f9",
      "entryHash": "a9235e34429655ed7c390f309df18e7e1dbcf4ab52587c58be46167e17e27cd5"
    },
    {
      "seq": 730,
      "prevHash": "a9235e34429655ed7c390f309df18e7e1dbcf4ab52587c58be46167e17e27cd5",
      "recordHash": "fed3ea39d137f8b97bc0bdd07bc4338a6fdbc5f244979aa9c0650f0f4a192bdd",
      "entryHash": "a3bb49d02f7223fecb41ef25a27e29c2b5063a97dd1499270b14e6fd9b6d2b73"
    }
  ],
  "checkpoint": {
    "seq": 730,
    "kind": "checkpoint",
    "record": "{\"day\":\"2026-11-06\",\"entries\":729,\"head\":\"a9235e34429655ed7c390f309df18e7e1dbcf4ab52587c58be46167e17e27cd5\",\"site\":\"https://upfork.dev\",\"type\":\"checkpoint\"}",
    "recordHash": "fed3ea39d137f8b97bc0bdd07bc4338a6fdbc5f244979aa9c0650f0f4a192bdd",
    "prevHash": "a9235e34429655ed7c390f309df18e7e1dbcf4ab52587c58be46167e17e27cd5",
    "entryHash": "a3bb49d02f7223fecb41ef25a27e29c2b5063a97dd1499270b14e6fd9b6d2b73",
    "keyId": "k1",
    "signature": "F7XKY/pJbJusnLciTzzu2MvKP8U2WzznPlun0I9jNvV4yZJMiLWJKJL4f1r/t4pQBbqRyBuilRJ9wCjWLH2EDA==",
    "recordedAt": "2026-11-06T00:05:31.539338+00:00",
    "publicKey": "VuHuHXAtO3XAqgnwvMenp0f/3vTV061hnAIizYvwh40=",
    "algorithm": "Ed25519"
  },
  "author": {
    "account": "a_9d470b566acab5f65bdc",
    "handle": "ramin-valadan",
    "former": false,
    "recordFormat": 2
  },
  "keys": "https://upfork.dev/ledger/keys.json"
}