Source snapshot bcc79fcc · Declared package version 5.0.4. This page combines the checked-in package guide and manifest; commands and runtime behavior were not executed in this review.
GraphQL server runtime adapters for ContractSpec contracts.
What It Provides
Couche: lib.
Consumers: bundles, apps with GraphQL.
Related ContractSpec packages include @lssm-tech/lib.contracts-runtime-server-rest, @lssm-tech/lib.contracts-spec, @lssm-tech/lib.schema, @lssm-tech/tool.bun, @lssm-tech/tool.typescript.
Related ContractSpec packages include @lssm-tech/lib.contracts-runtime-server-rest, @lssm-tech/lib.contracts-spec, @lssm-tech/lib.schema, @lssm-tech/tool.bun, @lssm-tech/tool.typescript.
bun add @lssm-tech/lib.contracts-runtime-server-graphql
Usage
Import the root entrypoint from @lssm-tech/lib.contracts-runtime-server-graphql, or choose a documented subpath when you only need one part of the package surface.
Query envelope params
Every contract resolver puts a QueryEnvelope on HandlerCtx.queryEnvelope. By default it holds the operation and the field's input argument as sent (before contract validation; absent for a field without input), and the schema is unchanged. With registerContractsOnBuilder(builder, registry, resources, { queryEnvelopeArg: true }) each contract field also accepts an optional
envelope: JSON argument (the builder must register a JSON scalar, or building the schema fails) carrying search, filters, sort, pagination, cache, tags, consistency and economic evidence refs. Malformed params raise a BAD_REQUEST GraphQL error before the handler runs.
Architecture
src/graphql-pothos.ts is part of the package's public or composition surface.
src/index.ts is the root public barrel and package entrypoint.
Public Entry Points
Export . resolves through ./src/index.ts.
Export ./graphql-pothos resolves through ./src/graphql-pothos.ts.
Local Commands
bun run dev — contractspec-bun-build dev
bun run build — contractspec-bun-build build
bun run lint — bun run lint:fix
bun run lint:check — biome check .
bun run lint:fix — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
bun run typecheck — tsgo --noEmit
bun run publish:pkg — bun publish --tolerate-republish --ignore-scripts --verbose
bun run publish:pkg:canary — bun publish:pkg --tag canary
bun run clean — rm -rf dist
bun run build:bundle — contractspec-bun-build transpile
bun run build:types — contractspec-bun-build types
bun run prebuild — contractspec-bun-build prebuild
Recent Updates
Replace eslint+prettier by biomejs to optimize speed.
Notes
Pothos builder integration must stay compatible with graphql-core and graphql-prisma.
Do not introduce direct schema mutations outside the Pothos pipeline.
Declared capabilities.
Lib Contracts Runtime Server Graphql
GraphQL server runtime adapters for ContractSpec contracts
Use it to
Adopt graphql server runtime adapters for contractspec contracts
Requires
TypeScript
Choose another boundary when
The @lssm-tech/lib.contracts-runtime-server-graphql package constraints do not match the target runtime or platform.
These are package-manifest entry points. Named symbols listed above come from the capability catalogue; this is not an exhaustive TypeScript symbol reference.
