Entities

# This makes User an entity - no @key needed
type User @connect(
  source: "api"
  http: { GET: "/users/{$this.id}" }
  selection: "id name email"
) {
  id: ID!
  name: String
  email: String
}

{
  "id": "order-1",
  "userId": "user-123",
  "total": 99.99
}

type Order {
  id: ID!
  user: User  # Entity reference
  total: Float
}

type User @connect(
  source: "api"
  http: { GET: "/users/{$this.id}" }
  selection: "id name email"
) {
  id: ID!
  name: String
  email: String
}

type Query {
  order(id: ID!): Order
    @connect(
      source: "api"
      http: { GET: "/orders/{$args.id}" }
      selection: """
      id
      user: { id: userId }  # Entity stub - only the key field
      total
      """
    )
}

type Product @connect(
  source: "api"
  http: { GET: "/products/{$this.id}" }
  selection: """
  id
  name
  price
  """
) {
  id: ID!
  name: String
  price: Float
}

type User {
  id: ID!
  name: String
  posts: [Post] @connect(
    source: "api"
    http: { GET: "/users/{$this.id}/posts" }
    selection: "id title content"
  )
}

type User @connect(
  source: "users_api"
  http: { GET: "/users/{$this.id}" }
  selection: "id name email avatar"
) {
  id: ID!
  name: String
  email: String
  avatar: String
}

# Only define the key field
type User @key(fields: "id") {
  id: ID!
}

type Order {
  id: ID!
  user: User  # References the entity
}

type Query {
  order(id: ID!): Order
    @connect(
      selection: """
      id
      user: { id: userId }  # Create stub with key
      """
    )
}

type Product @connect(
  source: "api"
  http: { GET: "/products/{$this.id}" }
  selection: "id name price"
) {
  id: ID!
  name: String
  price: Float
}

type Product @connect(
  source: "api"
  http: {
    POST: "/products/batch"
    body: "ids: $batch.id"
  }
  selection: "id name price"
) {
  id: ID!
  name: String
  price: Float
}

[
  { "productId": "1", "reviews": [...] },
  { "productId": "2", "reviews": [...] }
]

type Product @connect(
  source: "api"
  http: {
    POST: "/reviews/batch"
    body: "productIds: $batch.id"
  }
  selection: """
  id: productId
  reviews {
    id
    rating
    text
  }
  """
) {
  id: ID!
  reviews: [Review]
}

type Product @connect(
  source: "api"
  http: {
    POST: "/products/batch"
    body: "ids: $batch.id"
  }
  batch: { maxSize: 100 }  # Limit to 100 items per request
  selection: "id name"
) {
  id: ID!
  name: String
}

type Product {
  id: ID!
  name: String
  reviews: [Review] @connect(
    source: "api"
    http: { GET: "/products/{$this.id}/reviews" }
    selection: "id rating text productId"  # Include foreign key
  )
}

type Review {
  id: ID!
  rating: Int
  text: String
  productId: ID! @inaccessible  # Hidden from clients
  product: Product @connect(
    source: "api"
    http: { GET: "/products/{$this.productId}" }
    selection: "id name"
  )
}

type User
  @connect(
    source: "api"
    http: { GET: "/users/{$this.id}" }
    selection: "id firstName lastName"
  )
  @connect(
    source: "api"
    http: { GET: "/users/{$this.id}?detailed=true" }
    selection: """
    id
    address {
      street
      city
      country
    }
    """
  ) {
  id: ID!
  firstName: String
  lastName: String
  address: Address
}

type User @connect(
  http: { GET: "/users/{$this.id}" }
  selection: "id name"
) {
  id: ID!
  name: String
}

type User {
  id: ID!
  profile: Profile @connect(
    http: { GET: "/users/{$this.id}/profile" }
    selection: "bio avatar"
  )
}

type User @connect(
  http: { POST: "/users/batch", body: "ids: $batch.id" }
  selection: "id name"
) {
  id: ID!
  name: String
}

# In orders subgraph
type User @key(fields: "id") {
  id: ID!  # Stub only
}

type Order {
  user: User  # Resolved by users subgraph
}