GraphQL

The server exposes an async-graphql Federation v2 subgraph with resource CRUD, folder organization, and assessment bundle management.

Queries

Resources

Query	Arguments	Returns	Purpose
resource	id: ID!	Resource	Fetch single resource with snapshot
resources	ids: [ID!]!	[Resource!]!	Fetch multiple resources
resourceConnection	pagination args	ResourceConnection!	Paginated resource list
resourceSnapshot	id: ID!	Bytes	Raw snapshot bytes only
forksOf	id: ID!	[Resource!]!	List forks of a resource
sharePermissions	id: ID!	ResourceSharePermissions	Get sharing permissions

Folders

Query	Arguments	Returns	Purpose
folder	id: ID!	Folder	Fetch single folder
rootFolders	—	[Folder!]!	List top-level folders
subfolders	folderId: ID!	[Folder!]!	List child folders

Assessment Bundles

Query	Arguments	Returns	Purpose
assessmentBundle	networkIndex, curriculumIndex	AssessmentBundle	Fetch bundle data
assessmentBundles	—	[AssessmentBundleSummary!]!	List all bundles (metadata only)
assessmentBundleVersion	networkIndex, curriculumIndex	Int	Check bundle version

Federation

The server implements the _entities resolver for Resource, enabling federation with other subgraphs.

Mutations

Resources

Mutation	Arguments	Purpose
createResource	input: CreateResourceInput!	Create new resource
pushUpdate	id, snapshot	Push snapshot bytes
forkResource	id	Fork a resource
deleteResource	id	Delete single resource
deleteResources	ids	Batch delete
duplicateResources	ids	Batch duplicate
toggleVisibility	id	Toggle public/private
toggleReplicability	id	Toggle fork permission
shareResource	id, userId, permission	Share with user

Folders

Mutation	Arguments	Purpose
createFolder	input: CreateFolderInput!	Create folder
renameFolder	id, name	Rename folder
deleteFolder	id, keepChildren?	Delete folder (optionally reparent children)
moveFolder	id, targetFolderId	Move folder (with cycle detection)
moveFolderToParent	id	Move folder up one level
moveFolderToRoot	id	Move folder to root
moveResourceToFolder	resourceId, folderId	Move resource into folder
moveResourcesToFolder	resourceIds, folderId	Batch move
moveResourceToParent	resourceId	Move resource up one level
moveResourceToRoot	resourceId	Move resource to root

Assessment Bundles

Mutation	Arguments	Purpose
refreshAssessmentBundle	networkIndex, curriculumIndex	Refresh via gRPC from diagnostics service
seedAssessmentBundle	networkIndex, curriculumIndex, data	Manual JSON seed
deleteAssessmentBundle	networkIndex, curriculumIndex	Delete bundle

Types

Modality

enum Modality {
  WHITEBOARD
  WORKSHEET
  LESSON_PLAN
  ASSESSMENT
}

Resource

type Resource @key(fields: "id") {
  id: ID!
  name: String!
  description: String
  modality: Modality!
  snapshot: Bytes
  folderId: ID
  coverImageUrl: String
  isPublic: Boolean!
  isReplicable: Boolean!
  createdAt: DateTime!
  updatedAt: DateTime!
  lastViewedAt: DateTime
  createdBy: ID!
}

Folder

type Folder {
  id: ID!
  name: String!
  parentId: ID
  path: [Folder!]!       # recursive ancestors
  hasSubfolders: Boolean!
  createdAt: DateTime!
  updatedAt: DateTime!
}

Pagination

Resource listing uses cursor-based keyset pagination:

type ResourceConnection {
  edges: [ResourceEdge!]!
  pageInfo: PageInfo!
  totalCount: Int!
}

input ResourceFilterInput {
  modality: Modality
  folderId: ID
  search: String
}

Sort Orders

Sort	Description
CREATED_AT_ASC / CREATED_AT_DESC	By creation time
UPDATED_AT_ASC / UPDATED_AT_DESC	By last update
NAME_ASC / NAME_DESC	Alphabetical
LAST_VIEWED_ASC / LAST_VIEWED_DESC	By last viewed
MODALITY_ASC / MODALITY_DESC	By modality type

Cursors encode a CursorPayload with the sort field value and ID for stable keyset pagination. The server fetches N+1 rows to determine hasNextPage.

Related

• Auth — permission guards on resolvers
• Resources — resource repository layer
• Folders — folder repository layer
• Overview — server architecture