{"id":"@lssm-tech/lib.contracts-runtime-server-graphql","slug":"lib.contracts-runtime-server-graphql","name":"@lssm-tech/lib.contracts-runtime-server-graphql","version":"5.0.4","path":"packages/platform/delivery/contracts-runtime-server-graphql","manifestPath":"packages/platform/delivery/contracts-runtime-server-graphql/package.json","manifestBlobSha":"e30a04bec0118d085cd5c78aad174333b9dbbab8","layer":"platform","physicalArea":"delivery","primaryArea":"runtime-adapters","classification":{"privateDeclared":null,"catalogFamily":"runtime","catalogKind":"library","catalogStatus":"active","adoptionMode":"adoptable","stability":"stable"},"description":"GraphQL server runtime adapters for ContractSpec contracts","descriptionOrigin":"package.json","catalog":{"family":"runtime","kind":"library","status":"active","adoptionMode":"adoptable","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./contracts-runtime-server-graphql.feature","./graphql-pothos"],"documentation":[{"title":"Lib Contracts Runtime Server Graphql documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.contracts-runtime-server-graphql","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.lib.contracts.runtime.server.graphql","title":"Lib Contracts Runtime Server Graphql","description":"GraphQL server runtime adapters for ContractSpec contracts","status":"active","useCases":["Adopt graphql server runtime adapters for contractspec contracts"],"aliases":["lib","contracts","runtime","server","graphql"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/lib.contracts-runtime-server-graphql","symbols":[]},{"from":"@lssm-tech/lib.contracts-runtime-server-graphql/contracts-runtime-server-graphql.feature","symbols":[]},{"from":"@lssm-tech/lib.contracts-runtime-server-graphql/graphql-pothos","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/lib.contracts-runtime-server-graphql package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}]},"canonicalImports":[{"capabilityId":"package.lssm.tech.lib.contracts.runtime.server.graphql","from":"@lssm-tech/lib.contracts-runtime-server-graphql","symbols":[]},{"capabilityId":"package.lssm.tech.lib.contracts.runtime.server.graphql","from":"@lssm-tech/lib.contracts-runtime-server-graphql/contracts-runtime-server-graphql.feature","symbols":[]},{"capabilityId":"package.lssm.tech.lib.contracts.runtime.server.graphql","from":"@lssm-tech/lib.contracts-runtime-server-graphql/graphql-pothos","symbols":[]}],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","clean":"rm -rf dist","lint":"bun run lint:fix","lint:fix":"node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .","lint:check":"node ../../../../scripts/biome.cjs check .","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit","dev":"contractspec-bun-build dev"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.contracts-runtime-core":"workspace:^","@lssm-tech/lib.contracts-runtime-kernel":"workspace:^","@lssm-tech/lib.contracts-runtime-server-rest":"workspace:^","@lssm-tech/lib.contracts-spec-core":"workspace:^","@lssm-tech/lib.schema":"workspace:^","@lssm-tech/lib.utils-typescript":"workspace:^","@pothos/plugin-complexity":"catalog:graphql","@pothos/plugin-dataloader":"catalog:graphql","@pothos/plugin-prisma":"^4.17.0","@pothos/plugin-relay":"catalog:graphql","@pothos/plugin-tracing":"catalog:graphql"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:","@lssm-tech/tool.bun":"workspace:*"},"peerDependencies":{"@pothos/core":"catalog:graphql"},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./contracts-runtime-server-graphql.feature":"./src/contracts-runtime-server-graphql.feature.ts","./graphql-pothos":"./src/graphql-pothos.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./contracts-runtime-server-graphql.feature":{"types":"./dist/contracts-runtime-server-graphql.feature.d.ts","browser":"./dist/browser/contracts-runtime-server-graphql.feature.js","bun":"./dist/contracts-runtime-server-graphql.feature.js","node":"./dist/node/contracts-runtime-server-graphql.feature.js","default":"./dist/contracts-runtime-server-graphql.feature.js"},"./graphql-pothos":{"types":"./dist/graphql-pothos.d.ts","browser":"./dist/browser/graphql-pothos.js","bun":"./dist/graphql-pothos.js","node":"./dist/node/graphql-pothos.js","default":"./dist/graphql-pothos.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/lib.contracts-runtime-server-graphql","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/platform/delivery/contracts-runtime-server-graphql/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./contracts-runtime-server-graphql.feature","importPath":"@lssm-tech/lib.contracts-runtime-server-graphql/contracts-runtime-server-graphql.feature","target":"./src/contracts-runtime-server-graphql.feature.ts","targets":[{"conditions":[],"target":"./src/contracts-runtime-server-graphql.feature.ts","sourcePath":"packages/platform/delivery/contracts-runtime-server-graphql/src/contracts-runtime-server-graphql.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql/src/contracts-runtime-server-graphql.feature.ts","sourceStatus":"verified source file"}]},{"subpath":"./graphql-pothos","importPath":"@lssm-tech/lib.contracts-runtime-server-graphql/graphql-pothos","target":"./src/graphql-pothos.ts","targets":[{"conditions":[],"target":"./src/graphql-pothos.ts","sourcePath":"packages/platform/delivery/contracts-runtime-server-graphql/src/graphql-pothos.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql/src/graphql-pothos.ts","sourceStatus":"verified source file"}]}],"entryCount":3,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Lib Contracts Runtime Server Graphql documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.contracts-runtime-server-graphql","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.contracts-runtime-server-graphql.txt"},"readme":{"status":"available","body":"# @lssm-tech/lib.contracts-runtime-server-graphql\n\n**GraphQL server runtime adapters for ContractSpec contracts.**\n\n## What It Provides\n\n- **Layer**: lib.\n- **Consumers**: bundles, apps with GraphQL.\n- 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`.\n- 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`.\n\n## Installation\n\n`npm install @lssm-tech/lib.contracts-runtime-server-graphql`\n\nor\n\n`bun add @lssm-tech/lib.contracts-runtime-server-graphql`\n\n## Usage\n\nImport 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.\n\n### Query envelope params\n\nEvery contract resolver puts a `QueryEnvelope` on `HandlerCtx.queryEnvelope`.\nBy default it holds the operation and the field's `input` argument as sent\n(before contract validation; absent for a field without input), and the schema\nis unchanged. With `registerContractsOnBuilder(builder, registry, resources, {\nqueryEnvelopeArg: true })` each contract field also accepts an optional\n`envelope: JSON` argument (the builder must register a `JSON` scalar, or\nbuilding the schema fails) carrying\nsearch, filters, sort, pagination, cache, tags, consistency and economic\nevidence refs. Malformed params raise a `BAD_REQUEST` GraphQL error before the\nhandler runs.\n\n## Architecture\n\n- `src/graphql-pothos.ts` is part of the package's public or composition surface.\n- `src/index.ts` is the root public barrel and package entrypoint.\n\n## Public Entry Points\n\n- Export `.` resolves through `./src/index.ts`.\n- Export `./graphql-pothos` resolves through `./src/graphql-pothos.ts`.\n\n## Local Commands\n\n- `bun run dev` — contractspec-bun-build dev\n- `bun run build` — contractspec-bun-build build\n- `bun run lint` — bun run lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run typecheck` — tsgo --noEmit\n- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose\n- `bun run publish:pkg:canary` — bun publish:pkg --tag canary\n- `bun run clean` — rm -rf dist\n- `bun run build:bundle` — contractspec-bun-build transpile\n- `bun run build:types` — contractspec-bun-build types\n- `bun run prebuild` — contractspec-bun-build prebuild\n\n## Recent Updates\n\n- Replace eslint+prettier by biomejs to optimize speed.\n\n## Notes\n\n- Pothos builder integration must stay compatible with graphql-core and graphql-prisma.\n- Do not introduce direct schema mutations outside the Pothos pipeline.\n","sourcePath":"packages/platform/delivery/contracts-runtime-server-graphql/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/delivery/contracts-runtime-server-graphql/README.md","blobSha":"e28d9bddf5d97a2003217aedf2230bee238982a4","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"runtime-adapters","areaTitle":"Handlers, runtimes and transports","displayName":"lib.contracts-runtime-server-graphql","runtimes":["node"],"platforms":["server"],"kind":"library","scope":"Package manifest","canonicalRoute":"/docs/packages/lib.contracts-runtime-server-graphql/","contextUrl":"/docs/packages/lib.contracts-runtime-server-graphql.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}