bzh.herve.atmot.defs

{
  "id": "bzh.herve.atmot.defs",
  "defs": {
    "dailyStats": {
      "type": "object",
      "required": [
        "lang",
        "puzzleNumber",
        "players"
      ],
      "properties": {
        "lang": {
          "type": "string",
          "format": "language",
          "description": "Language series."
        },
        "players": {
          "type": "integer",
          "minimum": 0,
          "description": "Distinct DIDs that recorded a result for this puzzle."
        },
        "solvers": {
          "type": "integer",
          "minimum": 0,
          "description": "How many of those players solved it."
        },
        "puzzleNumber": {
          "type": "integer",
          "minimum": 1,
          "description": "Per-language puzzle index."
        },
        "averageGuesses": {
          "type": "integer",
          "description": "Average winning guess count, scaled by 100 (integer to avoid float ambiguity); e.g. 412 means 4.12. Absent when there are no solvers."
        },
        "guessDistribution": {
          "type": "array",
          "items": {
            "ref": "bzh.herve.atmot.stats#guessBucket",
            "type": "ref"
          },
          "maxLength": 6,
          "description": "Histogram of winning guess counts across all solvers."
        }
      },
      "description": "Aggregate statistics for one (lang, puzzleNumber), computed in the browser. Counts are read live from Constellation and never stored on any record."
    },
    "resultView": {
      "type": "object",
      "required": [
        "did",
        "lang",
        "puzzleNumber",
        "solved"
      ],
      "properties": {
        "did": {
          "type": "string",
          "format": "did",
          "description": "DID of the player who recorded this result."
        },
        "lang": {
          "type": "string",
          "format": "language",
          "description": "Language series of the puzzle."
        },
        "handle": {
          "type": "string",
          "format": "handle",
          "description": "Resolved handle of the player, if available."
        },
        "solved": {
          "type": "boolean",
          "description": "Whether the player solved the puzzle."
        },
        "guessCount": {
          "type": "integer",
          "maximum": 6,
          "minimum": 1,
          "description": "Guesses used; present only when solved."
        },
        "puzzleNumber": {
          "type": "integer",
          "minimum": 1,
          "description": "Per-language puzzle index."
        }
      },
      "description": "Client-side view of one player's result, assembled in the browser after reading records (there is no server implementing query lexicons in v1)."
    },
    "leaderboardEntry": {
      "type": "object",
      "required": [
        "did",
        "solved"
      ],
      "properties": {
        "did": {
          "type": "string",
          "format": "did",
          "description": "DID of the player."
        },
        "handle": {
          "type": "string",
          "format": "handle",
          "description": "Resolved handle of the player, if available."
        },
        "solved": {
          "type": "boolean",
          "description": "Whether the player solved the puzzle."
        },
        "guessCount": {
          "type": "integer",
          "maximum": 6,
          "minimum": 1,
          "description": "Guesses used; present only when solved."
        }
      },
      "description": "One aggregated row of a daily leaderboard, computed in the browser from result records discovered via Constellation."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}