quickslice#

GraphQL API for AT Protocol records with automatic schema generation from Lexicon definitions.

Work in progress. APIs subject to change.

Features#

• Automatic GraphQL schema generation from AT Protocol Lexicons
• Relay-compliant cursor-based pagination
• Real-time ingestion via Jetstream
• Backfill support for historical data
• SQLite storage

Example#

The status lexicon (xyz.statusphere.status):

{
  "lexicon": 1,
  "id": "xyz.statusphere.status",
  "defs": {
    "main": {
      "type": "record",
      "key": "tid",
      "record": {
        "type": "object",
        "required": ["status", "createdAt"],
        "properties": {
          "status": {
            "type": "string",
            "minLength": 1,
            "maxGraphemes": 1,
            "maxLength": 32
          },
          "createdAt": { "type": "string", "format": "datetime" }
        }
      }
    }
  }
}

Querying the status records:

query {
  xyzStatusphereStatus(
    first: 50
    sortBy: [
      { field: "createdAt", direction: DESC }
    ]
    where: {
      status: { contains: "👍" }
    }
  ) {
    edges {
      node {
        uri
        did
        status
        createdAt
      }
      cursor
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}

Documentation#

• Queries
• Joins
• Mutations
• Subscriptions
• Blobs
• Variables
• Deployment

Architecture#

• lexicon_graphql/ - Schema generation from Lexicons
• server/ - Database layer and record storage