npm - @descryy/adapter-graphql - Versions diffs - 0.1.0 - Mend

@descryy/adapter-graphql 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

package/dist/adapter.d.ts ADDED Viewed

@@ -0,0 +1,113 @@
+/**
+ * The GraphQL SDL adapter.
+ *
+ * The third capability in this project that reaches **R3 with no language
+ * adapter at all**, after `adapter-sql` and `adapter-openapi`, and for the same
+ * reason all three do: a published schema is *declared*, not deduced. It is a
+ * `LanguageAdapter` because it is a per-format reader with a capability matrix,
+ * not because SDL is a programming language — `language: "graphql"` describes
+ * the artifact it read, DEC-026, exactly the reading `adapter-sql` and
+ * `adapter-openapi` get.
+ *
+ * ## What it mints, and why the identity is not this file's to choose
+ *
+ * `DEC-317` fixed GraphQL operation identity, transposing `DEC-316`'s gRPC
+ * precedent: `method` is the literal sentinel `"GRAPHQL"`, the path is
+ * `/<OperationType>/<field>`. That decision was written against Python's
+ * strawberry, and its "Consequences" section says any later GraphQL reader
+ * "must mint this identical shape". This is the first such reader, so this is
+ * the first place that claim is *tested* rather than asserted —
+ * `test/sdl-strawberry-join.test.ts` runs both producers over the same
+ * operation and compares the emitted ids, in the shape `DEC-321` established
+ * for the PHP/SQL `DATABASE_TABLE` join.
+ *
+ * ## Why this reader supersedes the class-structure one, and how
+ *
+ * `DEC-317` §"The departure" is candid that strawberry forced a compromise:
+ * with no artifact to read, the schema-facing name had to be derived from the
+ * class structure, and a name that could only be *computed* had to be refused
+ * as `graphqlFieldNameNotReadable`. An SDL field name is the schema-facing name
+ * by definition. There is nothing to compute and nothing to refuse.
+ *
+ * **The precedence is expressed through resolution, not through a priority
+ * rule, and that is deliberate.** This adapter emits at R3: the document is the
+ * schema. `adapter-python`'s strawberry reader emits its operations at R0 or R1
+ * (`extract.ts` — R1 once a field was reached through the import graph). Rule 3,
+ * the resolution cap, then does the ranking on its own: an SDL-derived finding
+ * is capped at reliability class A and a strawberry-derived one at C or B. No
+ * new machinery, no producer allow-list, no "SDL wins" branch anywhere above
+ * the IR — the mechanism the engine already has says the right thing, because
+ * the two producers genuinely differ in the strength of their evidence.
+ *
+ * **Where SDL and source disagree, they do not fight — they diverge visibly.**
+ * The two producers' `API_ROUTE` nodes are distinct by construction (`API_ROUTE`
+ * is language-scoped, so `graphql` and `python` routes never share an id), and
+ * that asymmetry is the contract mechanism working as designed: the route is
+ * each producer's local view. They meet at the `API_ENDPOINT`, which is fileless
+ * and language-less. So:
+ *
+ * - **agreement** — one `API_ENDPOINT`, two `SERVES_API` edges into it from two
+ *   routes, at two resolutions. This is the join, and it is the case that
+ *   proves the convention transposed correctly.
+ * - **disagreement on a name** — two `API_ENDPOINT` nodes, one per spelling.
+ *   The SDL's is the correct one, and it carries R3 while the source-derived one
+ *   carries R0/R1. A stale committed SDL is the same risk a stale committed
+ *   `openapi.json` carries and is treated the same way: disclosed, not
+ *   downgraded. The divergence being *visible* is the useful property — a
+ *   published schema that no longer matches its source is a real finding, and a
+ *   reader that silently preferred one would have destroyed the evidence for it.
+ *
+ * ## What it does not claim, and the two refusals are load-bearing
+ *
+ * **No `DTO`, and not for scope reasons.** `adapter-openapi` mints a `DTO` per
+ * `components.schemas` entry and a `USES_TYPE` edge from the operation that
+ * names it, because in REST the response body *is* the schema the operation
+ * returns. **GraphQL does not work that way.** A client selects the fields it
+ * wants, so a `USES_TYPE` edge asserting "this operation returns this shape"
+ * would be false for every caller that selects a subset — which is every caller.
+ * Emitting one would be a wrong edge, and rule 2 puts a wrong edge below a
+ * missing one because it corrupts every layer above it. Disclosed gap.
+ *
+ * **No `USES_API`, and this one is a gate.** `DEC-317` §"The one flagged risk"
+ * found that `nearestMiss` rule 2 collapses under GraphQL paths — every
+ * operation is arity-2, carries no `{param}`, and draws its first segment from a
+ * set of size three — and gated any caller-side GraphQL reader on that being
+ * fixed first. `DEC-319` has since given rule 2 a measured similarity floor,
+ * which narrows the collapse but does not by itself discharge a gate that was
+ * written about a rule's reachability. This adapter builds the **server half
+ * only**, so it does not reach `nearestMiss` at all: that function is called
+ * from exactly one place, `orphans.ts`'s `withCallers` loop, which requires an
+ * endpoint with a `USES_API` caller. Verified in `descry-core` for this change,
+ * not inherited.
+ */
+import { type LanguageAdapter, type ResolutionLevel } from "@descryy/ir";
+import { type OperationSlot } from "./document.ts";
+export declare const ADAPTER_ID = "adapter-graphql";
+export declare const ADAPTER_VERSION = "0.1.0";
+/**
+ * `.graphql` and `.gql`. An introspection `schema.json` is **not** read — see
+ * `document.ts`'s declared limits for the census that decided it.
+ */
+export declare const DEFAULT_SCHEMA_GLOBS: readonly ["**/*.graphql", "**/*.gql"];
+/** DEC-026: the artifact read, not a programming language. Part of the id since DEC-054. */
+export declare const LANGUAGE = "graphql";
+/**
+ * `DEC-317`'s protocol sentinel, repeated here rather than imported.
+ *
+ * `adapter-python` exports the same constant from `packages/adapter-python/src/graphql.ts`,
+ * and importing it would make a format adapter depend on a language adapter to
+ * state its own identity — the dependency edge pointing the wrong way, and a
+ * package boundary crossed for one string. The value is pinned by the
+ * two-producer test instead, which is the guard that actually matters: a
+ * shared constant that both sides import can drift from the *decision* without
+ * either test noticing, whereas a test that runs both producers cannot.
+ */
+export declare const GRAPHQL_METHOD = "GRAPHQL";
+/** `Query` + `circuit` -> `/Query/circuit`. `DEC-317`'s path shape, exactly. */
+export declare function operationPath(slot: OperationSlot, fieldName: string): string;
+export interface GraphqlAdapterOptions {
+    readonly maxResolution?: ResolutionLevel;
+    readonly parseGlobs?: readonly string[];
+}
+export declare function createGraphqlAdapter(options?: GraphqlAdapterOptions): LanguageAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiFG;AAKH,OAAO,EAYL,KAAK,eAAe,EAGpB,KAAK,eAAe,EAErB,MAAM,aAAa,CAAC;AAIrB,OAAO,EAA4C,KAAK,aAAa,EAAe,MAAM,eAAe,CAAC;AAE1G,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAC5C,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,oBAAoB,uCAAwC,CAAC;AAE1E,4FAA4F;AAC5F,eAAO,MAAM,QAAQ,YAAY,CAAC;AAElC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,YAAY,CAAC;AAIxC,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe,CAAC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAOD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,qBAA0B,GAAG,eAAe,CA2GzF"}

package/dist/adapter.js ADDED Viewed

@@ -0,0 +1,294 @@
+/**
+ * The GraphQL SDL adapter.
+ *
+ * The third capability in this project that reaches **R3 with no language
+ * adapter at all**, after `adapter-sql` and `adapter-openapi`, and for the same
+ * reason all three do: a published schema is *declared*, not deduced. It is a
+ * `LanguageAdapter` because it is a per-format reader with a capability matrix,
+ * not because SDL is a programming language — `language: "graphql"` describes
+ * the artifact it read, DEC-026, exactly the reading `adapter-sql` and
+ * `adapter-openapi` get.
+ *
+ * ## What it mints, and why the identity is not this file's to choose
+ *
+ * `DEC-317` fixed GraphQL operation identity, transposing `DEC-316`'s gRPC
+ * precedent: `method` is the literal sentinel `"GRAPHQL"`, the path is
+ * `/<OperationType>/<field>`. That decision was written against Python's
+ * strawberry, and its "Consequences" section says any later GraphQL reader
+ * "must mint this identical shape". This is the first such reader, so this is
+ * the first place that claim is *tested* rather than asserted —
+ * `test/sdl-strawberry-join.test.ts` runs both producers over the same
+ * operation and compares the emitted ids, in the shape `DEC-321` established
+ * for the PHP/SQL `DATABASE_TABLE` join.
+ *
+ * ## Why this reader supersedes the class-structure one, and how
+ *
+ * `DEC-317` §"The departure" is candid that strawberry forced a compromise:
+ * with no artifact to read, the schema-facing name had to be derived from the
+ * class structure, and a name that could only be *computed* had to be refused
+ * as `graphqlFieldNameNotReadable`. An SDL field name is the schema-facing name
+ * by definition. There is nothing to compute and nothing to refuse.
+ *
+ * **The precedence is expressed through resolution, not through a priority
+ * rule, and that is deliberate.** This adapter emits at R3: the document is the
+ * schema. `adapter-python`'s strawberry reader emits its operations at R0 or R1
+ * (`extract.ts` — R1 once a field was reached through the import graph). Rule 3,
+ * the resolution cap, then does the ranking on its own: an SDL-derived finding
+ * is capped at reliability class A and a strawberry-derived one at C or B. No
+ * new machinery, no producer allow-list, no "SDL wins" branch anywhere above
+ * the IR — the mechanism the engine already has says the right thing, because
+ * the two producers genuinely differ in the strength of their evidence.
+ *
+ * **Where SDL and source disagree, they do not fight — they diverge visibly.**
+ * The two producers' `API_ROUTE` nodes are distinct by construction (`API_ROUTE`
+ * is language-scoped, so `graphql` and `python` routes never share an id), and
+ * that asymmetry is the contract mechanism working as designed: the route is
+ * each producer's local view. They meet at the `API_ENDPOINT`, which is fileless
+ * and language-less. So:
+ *
+ * - **agreement** — one `API_ENDPOINT`, two `SERVES_API` edges into it from two
+ *   routes, at two resolutions. This is the join, and it is the case that
+ *   proves the convention transposed correctly.
+ * - **disagreement on a name** — two `API_ENDPOINT` nodes, one per spelling.
+ *   The SDL's is the correct one, and it carries R3 while the source-derived one
+ *   carries R0/R1. A stale committed SDL is the same risk a stale committed
+ *   `openapi.json` carries and is treated the same way: disclosed, not
+ *   downgraded. The divergence being *visible* is the useful property — a
+ *   published schema that no longer matches its source is a real finding, and a
+ *   reader that silently preferred one would have destroyed the evidence for it.
+ *
+ * ## What it does not claim, and the two refusals are load-bearing
+ *
+ * **No `DTO`, and not for scope reasons.** `adapter-openapi` mints a `DTO` per
+ * `components.schemas` entry and a `USES_TYPE` edge from the operation that
+ * names it, because in REST the response body *is* the schema the operation
+ * returns. **GraphQL does not work that way.** A client selects the fields it
+ * wants, so a `USES_TYPE` edge asserting "this operation returns this shape"
+ * would be false for every caller that selects a subset — which is every caller.
+ * Emitting one would be a wrong edge, and rule 2 puts a wrong edge below a
+ * missing one because it corrupts every layer above it. Disclosed gap.
+ *
+ * **No `USES_API`, and this one is a gate.** `DEC-317` §"The one flagged risk"
+ * found that `nearestMiss` rule 2 collapses under GraphQL paths — every
+ * operation is arity-2, carries no `{param}`, and draws its first segment from a
+ * set of size three — and gated any caller-side GraphQL reader on that being
+ * fixed first. `DEC-319` has since given rule 2 a measured similarity floor,
+ * which narrows the collapse but does not by itself discharge a gate that was
+ * written about a rule's reachability. This adapter builds the **server half
+ * only**, so it does not reach `nearestMiss` at all: that function is called
+ * from exactly one place, `orphans.ts`'s `withCallers` loop, which requires an
+ * endpoint with a `USES_API` caller. Verified in `descry-core` for this change,
+ * not inherited.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { endpointQsp, nodeId, normaliseEndpointPath, } from "@descryy/ir";
+import { discover } from "@descryy/adapter-common";
+import { OPERATION_TYPE, readSchema, rootFieldsOf } from "./document.js";
+export const ADAPTER_ID = "adapter-graphql";
+export const ADAPTER_VERSION = "0.1.0";
+/**
+ * `.graphql` and `.gql`. An introspection `schema.json` is **not** read — see
+ * `document.ts`'s declared limits for the census that decided it.
+ */
+export const DEFAULT_SCHEMA_GLOBS = ["**/*.graphql", "**/*.gql"];
+/** DEC-026: the artifact read, not a programming language. Part of the id since DEC-054. */
+export const LANGUAGE = "graphql";
+/**
+ * `DEC-317`'s protocol sentinel, repeated here rather than imported.
+ *
+ * `adapter-python` exports the same constant from `packages/adapter-python/src/graphql.ts`,
+ * and importing it would make a format adapter depend on a language adapter to
+ * state its own identity — the dependency edge pointing the wrong way, and a
+ * package boundary crossed for one string. The value is pinned by the
+ * two-producer test instead, which is the guard that actually matters: a
+ * shared constant that both sides import can drift from the *decision* without
+ * either test noticing, whereas a test that runs both producers cannot.
+ */
+export const GRAPHQL_METHOD = "GRAPHQL";
+const PRODUCED_BY = `${ADAPTER_ID}@${ADAPTER_VERSION}`;
+/** `Query` + `circuit` -> `/Query/circuit`. `DEC-317`'s path shape, exactly. */
+export function operationPath(slot, fieldName) {
+    return `/${OPERATION_TYPE[slot]}/${fieldName}`;
+}
+export function createGraphqlAdapter(options = {}) {
+    const ceiling = options.maxResolution ?? 3;
+    const globs = options.parseGlobs ?? DEFAULT_SCHEMA_GLOBS;
+    let root;
+    const read = (repoRoot, file) => {
+        try {
+            return { file, schema: readSchema(readFileSync(join(repoRoot.absolutePath, file), "utf8")) };
+        }
+        catch {
+            return { file, schema: undefined };
+        }
+    };
+    /** Every candidate file that actually read as a schema — an executable document does not. */
+    const schemasUnder = (repoRoot) => [...new Set(discover(repoRoot.absolutePath, globs))]
+        .sort()
+        .map((file) => read(repoRoot, file))
+        .filter((unit) => unit.schema !== undefined);
+    return {
+        id: ADAPTER_ID,
+        version: ADAPTER_VERSION,
+        async detect(repoRoot) {
+            const units = schemasUnder(repoRoot);
+            if (units.length === 0)
+                return { detected: false, roots: [], evidence: [] };
+            const operations = units.reduce((sum, unit) => sum + (unit.schema === undefined ? 0 : rootFieldsOf(unit.schema).length), 0);
+            return {
+                detected: true,
+                roots: [...new Set(units.map((unit) => unit.file.split("/")[0] ?? "."))].sort(),
+                evidence: [
+                    `${units.length} GraphQL SDL document(s), ${operations} root operation(s)`,
+                    "SDL only — an introspection schema.json is not read, by declared limit",
+                ],
+            };
+        },
+        capabilities() {
+            return {
+                maxResolution: ceiling,
+                // No DTO and no USES_TYPE: a GraphQL client selects its own fields, so
+                // an edge asserting that an operation returns a whole named shape would
+                // be wrong for every caller. See the module header.
+                nodeTypes: ["API_ROUTE", "API_ENDPOINT"],
+                edgeTypes: ["SERVES_API"],
+                hasCallHierarchy: false,
+                hasTypeHierarchy: false,
+                frameworkExtractors: ["graphql-sdl"],
+                frameworkCapabilities: ["route-extractor"],
+            };
+        },
+        async prepare(ctx) {
+            root = ctx.root;
+            // Nothing to prepare and nothing that can fail: no dependency resolution,
+            // no type checker, no index. R3 is not optimism — the document *is* the
+            // schema, and every name in it is the served name.
+            return ceiling;
+        },
+        async parseFiles(files) {
+            const active = root;
+            return files.map((file) => ({
+                file,
+                tree: active === undefined ? { file: file.path, schema: undefined } : read(active, file.path),
+            }));
+        },
+        extractNodes(units) {
+            return build(units.map((unit) => unit.tree), root, ceiling).nodes;
+        },
+        extractEdges(units) {
+            return build(units.map((unit) => unit.tree), root, ceiling).edges;
+        },
+        async emit(ctx) {
+            const reached = await this.prepare(ctx);
+            const units = schemasUnder(ctx.root);
+            const { nodes, edges, unresolved } = build(units, ctx.root, reached);
+            return {
+                repo: ctx.root.repo,
+                ...(ctx.root.workspace === undefined ? {} : { workspace: ctx.root.workspace }),
+                commitSha: ctx.root.commitSha,
+                producedBy: PRODUCED_BY,
+                sourceFiles: units.map((unit) => unit.file),
+                // `schemasUnder` already filters to units that read as a schema — a
+                // `.graphql` file holding an executable document is excluded from
+                // `units` (and so from `sourceFiles`) without reaching this session,
+                // exactly as `adapter-openapi` handles an unparseable contract.
+                skippedFiles: [],
+                reachedResolution: reached,
+                nodes,
+                edges,
+                unresolved,
+            };
+        },
+        async dispose() {
+            root = undefined;
+        },
+    };
+}
+function build(units, repoRoot, reached) {
+    if (repoRoot === undefined)
+        return { nodes: [], edges: [], unresolved: [] };
+    const nodes = new Map();
+    const edges = new Map();
+    const unresolved = [];
+    const scope = { repo: repoRoot.repo, workspace: repoRoot.workspace };
+    for (const unit of units) {
+        const schema = unit.schema;
+        if (schema === undefined)
+            continue;
+        let anchorId;
+        for (const field of rootFieldsOf(schema)) {
+            const served = operationPath(field.slot, field.name);
+            // `${method} ${served}` and `endpointQsp(method, served)` are the two
+            // minting sites `DEC-317` fixed, spelled here exactly as
+            // `adapter-python`'s `emitDjangoRoute` spells them. The two-producer test
+            // is what holds them equal; this comment is not.
+            const routeId = nodeId(scope, "API_ROUTE", `${GRAPHQL_METHOD} ${served}`, LANGUAGE);
+            if (!nodes.has(routeId)) {
+                anchorId ??= routeId;
+                nodes.set(routeId, {
+                    id: routeId,
+                    type: "API_ROUTE",
+                    name: `${GRAPHQL_METHOD} ${served}`,
+                    file: unit.file,
+                    range: { startLine: field.line, endLine: field.line },
+                    language: LANGUAGE,
+                    producedBy: PRODUCED_BY,
+                    resolution: reached,
+                    attrs: {
+                        method: GRAPHQL_METHOD,
+                        pathTemplate: normaliseEndpointPath(served),
+                        rawTemplate: served,
+                        framework: "graphql-sdl",
+                        operationType: OPERATION_TYPE[field.slot],
+                    },
+                });
+            }
+            // Fileless AND language-less. This node is where an SDL-derived operation
+            // and a strawberry-derived one for the same real operation meet, and
+            // `nodeId` throws if a fileless type is hashed with a language — the guard
+            // against an id whose only symptom would be a join that silently does not
+            // happen.
+            const endpointId = nodeId(scope, "API_ENDPOINT", endpointQsp(GRAPHQL_METHOD, served), null);
+            if (!nodes.has(endpointId)) {
+                nodes.set(endpointId, {
+                    id: endpointId,
+                    type: "API_ENDPOINT",
+                    name: `${GRAPHQL_METHOD} ${normaliseEndpointPath(served)}`,
+                    file: null,
+                    range: null,
+                    language: null,
+                    producedBy: PRODUCED_BY,
+                    resolution: reached,
+                    attrs: { method: GRAPHQL_METHOD, pathTemplate: normaliseEndpointPath(served) },
+                });
+            }
+            edges.set(`${routeId} ${endpointId} SERVES_API`, {
+                from: routeId,
+                to: endpointId,
+                type: "SERVES_API",
+                producedBy: PRODUCED_BY,
+                resolution: reached,
+                confidence: 0.95,
+            });
+        }
+        // Every refusal, anchored to a node the batch actually contains. A ledger
+        // entry naming a node that was never emitted is a dangling reference
+        // dressed up as a disclosure.
+        if (anchorId === undefined)
+            continue;
+        for (const refusal of schema.refused) {
+            unresolved.push({
+                fromNodeId: anchorId,
+                edgeType: "SERVES_API",
+                rawTarget: refusal.what.slice(0, 120),
+                file: unit.file,
+                line: refusal.line,
+                producedBy: PRODUCED_BY,
+                reason: refusal.why,
+            });
+        }
+    }
+    return { nodes: [...nodes.values()], edges: [...edges.values()], unresolved };
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/document.d.ts ADDED Viewed

@@ -0,0 +1,116 @@
+/**
+ * Reading a GraphQL SDL document, and why this is the *strong* half of the
+ * GraphQL story rather than a convenience.
+ *
+ * `DEC-317` built GraphQL operation identity for Python/strawberry, and was
+ * explicit about the compromise it had to make. gRPC's precedent
+ * (`DEC-316`) rests on **"the path is read, not assembled"** — protoc writes
+ * `Service_Method_FullMethodName = "/pkg.Service/Method"` and the reader takes
+ * that literal verbatim. strawberry writes no such artifact: the schema is
+ * built at import time out of the class structure, the schema-facing name is
+ * camel-cased by default, and so `DEC-317` had to narrow itself to the three
+ * cases in which a name is genuinely *read* and refuse the rest as
+ * `graphqlFieldNameNotReadable`.
+ *
+ * **An SDL artifact removes the compromise entirely.** A field name in SDL is
+ * the schema-facing name — not a Python attribute that a naming converter will
+ * later transform, not a value a default might change, but the string the
+ * server publishes and a client types. There is nothing to compute, nothing to
+ * resolve and nothing to refuse on naming grounds. `DEC-317` §"The three
+ * sub-questions" says so outright: where an SDL artifact exists it "**is** the
+ * protoc-const analogue and should be preferred over this mechanism outright".
+ * This reader is that preference, built.
+ *
+ * ## Why a lexer and not a regex
+ *
+ * The naive rule — *a `Name` followed by `:` inside a type body is a field* —
+ * fails on the first real schema it meets, in four separate ways that Saleor's
+ * `saleor/graphql/schema.graphql` contains thousands of instances of:
+ *
+ * | construct | what the naive rule does |
+ * | --- | --- |
+ * | `webhook(id: ID!, filter: F = { channel: "x" }): Webhook` | emits `id`, `filter` and `channel` as operations |
+ * | `webhookEvents: [E!] @doc(category: "Webhooks")` | emits `category` |
+ * | `"""A description with a { brace and a colon: here."""` | emits whatever the prose contains |
+ * | `# a comment` | the same |
+ *
+ * So the document is tokenised properly — block strings, strings, comments and
+ * punctuation — and a field is admitted only in the one position the grammar
+ * puts one: a `Name`, at the type body's own brace depth and outside every
+ * parenthesis, followed (past a balanced argument list, if it has one) by `:`.
+ *
+ * ## Declared limits
+ *
+ * **`.graphql`/`.gql` only — an introspection `schema.json` is not read.**
+ * `DEC-317` names it as a third artifact that could carry the same truth, and
+ * it could. It is not built because **no repository on hand contains one**: a
+ * census of 52 reference repositories plus Saleor found two `.graphql` files
+ * and zero GraphQL introspection JSON documents. Building a second format
+ * reader against documentation with no source to measure it on is the thing
+ * `DEC-317`'s own graphene paragraph refuses to do, and it would be no more
+ * defensible here. Disclosed gap, not a silent one.
+ *
+ * **One file is one document.** A schema block naming a root type that the same
+ * file does not declare earns a ledger row rather than a search of the other
+ * `.graphql` files in the repository. SDL *can* legally be split across files,
+ * and where it is this reader under-reports and says so; both real artifacts
+ * measured here are single-file, so cross-file stitching would be reach built
+ * against zero demand, and a wrong stitch — pairing a schema block with a
+ * same-named type from an unrelated schema — is a silently wrong answer rather
+ * than a missing one.
+ *
+ * **Executable documents are not schemas.** A `.graphql` file holding
+ * `query IntrospectionQuery { ... }` or a fragment is a *client* document;
+ * twenty ships exactly one. It yields no type-system definition, so it yields
+ * no schema, and `readSchema` returns `undefined` rather than minting
+ * operations named after an introspection payload.
+ */
+/** GraphQL's three root operation types, fixed by the specification. */
+export declare const OPERATION_SLOTS: readonly ["query", "mutation", "subscription"];
+export type OperationSlot = (typeof OPERATION_SLOTS)[number];
+/**
+ * The path segment each slot contributes, and the type name each slot defaults
+ * to when the document declares no `schema` block.
+ *
+ * **These two columns are the same word for a reason, and it is not a
+ * coincidence worth collapsing.** The left is GraphQL's operation-type
+ * vocabulary, which `DEC-317` puts in the path; the right is the specification's
+ * default root type name (October 2021 §3.3.1), which a `schema` block may
+ * override. Saleor overrides nothing and still writes the block; twenty writes
+ * no block at all. Keeping them apart is what makes `schema { query: RootQuery }`
+ * yield `/Query/…` rather than `/RootQuery/…`.
+ */
+export declare const OPERATION_TYPE: Readonly<Record<OperationSlot, string>>;
+export interface Refusal {
+    readonly what: string;
+    readonly why: string;
+    readonly line: number;
+}
+export interface RootField {
+    readonly slot: OperationSlot;
+    /**
+     * The schema-facing name, **read verbatim**. There is no other kind here —
+     * that is the whole reason this adapter is worth more than the class-structure
+     * mechanism it supersedes.
+     */
+    readonly name: string;
+    readonly line: number;
+}
+export interface Schema {
+    /** Slot -> the type name occupying it, as the document states or defaults it. */
+    readonly roots: ReadonlyMap<OperationSlot, string>;
+    /** Whether the roots came from a `schema` block or from the specification's defaults. */
+    readonly rootsDeclared: boolean;
+    readonly fields: ReadonlyMap<string, readonly RootField[]>;
+    readonly refused: readonly Refusal[];
+}
+/**
+ * The type-system definitions of one document.
+ *
+ * Returns `undefined` when the text yields no root operation type at all —
+ * an executable document, a fragment library, or a file that is not SDL.
+ */
+export declare function readSchema(text: string): Schema | undefined;
+/** Every root operation the document declares, in slot then declaration order. */
+export declare function rootFieldsOf(schema: Schema): readonly RootField[];
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AAEH,wEAAwE;AACxE,eAAO,MAAM,eAAe,gDAAiD,CAAC;AAC9E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAIlE,CAAC;AAIF,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACnD,yFAAyF;IACzF,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,CAAC;CACtC;AAkND;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CA8H3D;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAQjE"}

package/dist/document.js ADDED Viewed

@@ -0,0 +1,415 @@
+/**
+ * Reading a GraphQL SDL document, and why this is the *strong* half of the
+ * GraphQL story rather than a convenience.
+ *
+ * `DEC-317` built GraphQL operation identity for Python/strawberry, and was
+ * explicit about the compromise it had to make. gRPC's precedent
+ * (`DEC-316`) rests on **"the path is read, not assembled"** — protoc writes
+ * `Service_Method_FullMethodName = "/pkg.Service/Method"` and the reader takes
+ * that literal verbatim. strawberry writes no such artifact: the schema is
+ * built at import time out of the class structure, the schema-facing name is
+ * camel-cased by default, and so `DEC-317` had to narrow itself to the three
+ * cases in which a name is genuinely *read* and refuse the rest as
+ * `graphqlFieldNameNotReadable`.
+ *
+ * **An SDL artifact removes the compromise entirely.** A field name in SDL is
+ * the schema-facing name — not a Python attribute that a naming converter will
+ * later transform, not a value a default might change, but the string the
+ * server publishes and a client types. There is nothing to compute, nothing to
+ * resolve and nothing to refuse on naming grounds. `DEC-317` §"The three
+ * sub-questions" says so outright: where an SDL artifact exists it "**is** the
+ * protoc-const analogue and should be preferred over this mechanism outright".
+ * This reader is that preference, built.
+ *
+ * ## Why a lexer and not a regex
+ *
+ * The naive rule — *a `Name` followed by `:` inside a type body is a field* —
+ * fails on the first real schema it meets, in four separate ways that Saleor's
+ * `saleor/graphql/schema.graphql` contains thousands of instances of:
+ *
+ * | construct | what the naive rule does |
+ * | --- | --- |
+ * | `webhook(id: ID!, filter: F = { channel: "x" }): Webhook` | emits `id`, `filter` and `channel` as operations |
+ * | `webhookEvents: [E!] @doc(category: "Webhooks")` | emits `category` |
+ * | `"""A description with a { brace and a colon: here."""` | emits whatever the prose contains |
+ * | `# a comment` | the same |
+ *
+ * So the document is tokenised properly — block strings, strings, comments and
+ * punctuation — and a field is admitted only in the one position the grammar
+ * puts one: a `Name`, at the type body's own brace depth and outside every
+ * parenthesis, followed (past a balanced argument list, if it has one) by `:`.
+ *
+ * ## Declared limits
+ *
+ * **`.graphql`/`.gql` only — an introspection `schema.json` is not read.**
+ * `DEC-317` names it as a third artifact that could carry the same truth, and
+ * it could. It is not built because **no repository on hand contains one**: a
+ * census of 52 reference repositories plus Saleor found two `.graphql` files
+ * and zero GraphQL introspection JSON documents. Building a second format
+ * reader against documentation with no source to measure it on is the thing
+ * `DEC-317`'s own graphene paragraph refuses to do, and it would be no more
+ * defensible here. Disclosed gap, not a silent one.
+ *
+ * **One file is one document.** A schema block naming a root type that the same
+ * file does not declare earns a ledger row rather than a search of the other
+ * `.graphql` files in the repository. SDL *can* legally be split across files,
+ * and where it is this reader under-reports and says so; both real artifacts
+ * measured here are single-file, so cross-file stitching would be reach built
+ * against zero demand, and a wrong stitch — pairing a schema block with a
+ * same-named type from an unrelated schema — is a silently wrong answer rather
+ * than a missing one.
+ *
+ * **Executable documents are not schemas.** A `.graphql` file holding
+ * `query IntrospectionQuery { ... }` or a fragment is a *client* document;
+ * twenty ships exactly one. It yields no type-system definition, so it yields
+ * no schema, and `readSchema` returns `undefined` rather than minting
+ * operations named after an introspection payload.
+ */
+/** GraphQL's three root operation types, fixed by the specification. */
+export const OPERATION_SLOTS = ["query", "mutation", "subscription"];
+/**
+ * The path segment each slot contributes, and the type name each slot defaults
+ * to when the document declares no `schema` block.
+ *
+ * **These two columns are the same word for a reason, and it is not a
+ * coincidence worth collapsing.** The left is GraphQL's operation-type
+ * vocabulary, which `DEC-317` puts in the path; the right is the specification's
+ * default root type name (October 2021 §3.3.1), which a `schema` block may
+ * override. Saleor overrides nothing and still writes the block; twenty writes
+ * no block at all. Keeping them apart is what makes `schema { query: RootQuery }`
+ * yield `/Query/…` rather than `/RootQuery/…`.
+ */
+export const OPERATION_TYPE = {
+    query: "Query",
+    mutation: "Mutation",
+    subscription: "Subscription",
+};
+const DEFAULT_ROOT_TYPE = OPERATION_TYPE;
+const isNameStart = (c) => /[_A-Za-z]/.test(c);
+const isNameChar = (c) => /[_0-9A-Za-z]/.test(c);
+/**
+ * Tokens, with comments and commas dropped.
+ *
+ * Numbers and the rest of the value grammar are deliberately *not* classified:
+ * nothing this reader decides depends on telling `1` from `x`, and every value
+ * it might meet sits inside a parenthesis or a brace it is already skipping.
+ * A digit run therefore falls through to the single-character `punct` arm,
+ * which is harmless — it can never be mistaken for a `name`, which is the only
+ * classification that carries a decision.
+ */
+function tokenise(text) {
+    const tokens = [];
+    let index = 0;
+    let line = 1;
+    while (index < text.length) {
+        const char = text[index];
+        if (char === "\n") {
+            line += 1;
+            index += 1;
+            continue;
+        }
+        if (char === " " || char === "\t" || char === "\r" || char === "," || char === "") {
+            index += 1;
+            continue;
+        }
+        // A comment runs to end of line and can say anything at all, including
+        // something shaped exactly like a field.
+        if (char === "#") {
+            while (index < text.length && text[index] !== "\n")
+                index += 1;
+            continue;
+        }
+        if (char === '"') {
+            const startLine = line;
+            // A block string is the case that matters: Saleor's descriptions contain
+            // braces, quotes and colons, and a reader that scanned to the next `"`
+            // would resume parsing in the middle of prose.
+            if (text.startsWith('"""', index)) {
+                index += 3;
+                while (index < text.length) {
+                    if (text[index] === "\\" && text.startsWith('"""', index + 1)) {
+                        index += 4;
+                        continue;
+                    }
+                    if (text.startsWith('"""', index)) {
+                        index += 3;
+                        break;
+                    }
+                    if (text[index] === "\n")
+                        line += 1;
+                    index += 1;
+                }
+            }
+            else {
+                index += 1;
+                while (index < text.length && text[index] !== '"') {
+                    if (text[index] === "\\")
+                        index += 1;
+                    if (text[index] === "\n")
+                        line += 1;
+                    index += 1;
+                }
+                index += 1;
+            }
+            tokens.push({ kind: "string", value: "", line: startLine });
+            continue;
+        }
+        if (isNameStart(char)) {
+            const start = index;
+            while (index < text.length && isNameChar(text[index]))
+                index += 1;
+            tokens.push({ kind: "name", value: text.slice(start, index), line });
+            continue;
+        }
+        tokens.push({ kind: "punct", value: char, line });
+        index += 1;
+    }
+    return tokens;
+}
+/** The index just past the balanced `(`…`)` or `{`…`}` opening at `from`. */
+function skipBalanced(tokens, from, open, close) {
+    let depth = 0;
+    let index = from;
+    for (; index < tokens.length; index += 1) {
+        const token = tokens[index];
+        if (token.kind !== "punct")
+            continue;
+        if (token.value === open)
+            depth += 1;
+        else if (token.value === close) {
+            depth -= 1;
+            if (depth === 0)
+                return index + 1;
+        }
+    }
+    return tokens.length;
+}
+/**
+ * The fields a type body declares, read from the token just past its `{`.
+ *
+ * A field is a `Name` at the body's own depth, outside every parenthesis,
+ * followed — past its argument list if it has one — by `:`. That trailing colon
+ * is what does the precision work: `@doc(category: "x")` puts `doc` in exactly
+ * the same position as a field name and is separated from one only by what
+ * comes after its parentheses.
+ */
+function fieldsIn(tokens, bodyStart) {
+    const fields = [];
+    let index = bodyStart;
+    let depth = 1;
+    while (index < tokens.length && depth > 0) {
+        const token = tokens[index];
+        if (token.kind === "punct") {
+            if (token.value === "{") {
+                depth += 1;
+                index += 1;
+                continue;
+            }
+            if (token.value === "}") {
+                depth -= 1;
+                index += 1;
+                continue;
+            }
+            if (token.value === "(") {
+                index = skipBalanced(tokens, index, "(", ")");
+                continue;
+            }
+            // `@` — the directive's own name follows and is not a field. Skipping it
+            // here is belt-and-braces: the trailing-colon test already rejects it.
+            if (token.value === "@") {
+                index += 2;
+                continue;
+            }
+            index += 1;
+            continue;
+        }
+        if (token.kind !== "name" || depth !== 1) {
+            index += 1;
+            continue;
+        }
+        let next = index + 1;
+        if (tokens[next]?.kind === "punct" && tokens[next].value === "(") {
+            next = skipBalanced(tokens, next, "(", ")");
+        }
+        if (tokens[next]?.kind === "punct" && tokens[next].value === ":") {
+            fields.push({ slot: "query", name: token.value, line: token.line });
+            index = next + 1;
+            continue;
+        }
+        index += 1;
+    }
+    return { fields, end: index };
+}
+/** `schema { query: Query … }` — the slot map, and a ledger row for any slot that is not a bare name. */
+function readSchemaBlock(tokens, bodyStart, roots, refused) {
+    let index = bodyStart;
+    while (index < tokens.length) {
+        const token = tokens[index];
+        if (token.kind === "punct" && token.value === "}")
+            return index + 1;
+        const slot = OPERATION_SLOTS.find((candidate) => token.kind === "name" && token.value === candidate);
+        if (slot === undefined) {
+            index += 1;
+            continue;
+        }
+        if (!(tokens[index + 1]?.kind === "punct" && tokens[index + 1].value === ":")) {
+            index += 1;
+            continue;
+        }
+        const value = tokens[index + 2];
+        if (value?.kind === "name") {
+            roots.set(slot, value.value);
+            index += 3;
+            continue;
+        }
+        // `query: [Query]` and friends. Legal SDL forbids it, but a hand-edited or
+        // generated document can contain anything, and picking the name out of a
+        // wrapper would be a guess about what the server actually serves.
+        refused.push({
+            what: slot,
+            why: `the schema block's ${slot} slot is not a bare type name, so the root type it names cannot be read`,
+            line: token.line,
+        });
+        index += 2;
+    }
+    return index;
+}
+/**
+ * The type-system definitions of one document.
+ *
+ * Returns `undefined` when the text yields no root operation type at all —
+ * an executable document, a fragment library, or a file that is not SDL.
+ */
+export function readSchema(text) {
+    const tokens = tokenise(text);
+    const roots = new Map();
+    const refused = [];
+    const byType = new Map();
+    let sawSchemaBlock = false;
+    let sawTypeDefinition = false;
+    let index = 0;
+    while (index < tokens.length) {
+        const token = tokens[index];
+        if (token.kind !== "name") {
+            index += 1;
+            continue;
+        }
+        if (token.value === "schema") {
+            // `schema @link(...) { … }` is legal; skip to the body the same way a
+            // type definition's directives are skipped.
+            let cursor = index + 1;
+            while (cursor < tokens.length) {
+                const next = tokens[cursor];
+                if (next.kind === "punct" && next.value === "(") {
+                    cursor = skipBalanced(tokens, cursor, "(", ")");
+                    continue;
+                }
+                if (next.kind === "punct" && next.value === "{")
+                    break;
+                if (next.kind === "punct" && next.value === "}")
+                    break;
+                cursor += 1;
+            }
+            if (tokens[cursor]?.kind === "punct" && tokens[cursor].value === "{") {
+                sawSchemaBlock = true;
+                index = readSchemaBlock(tokens, cursor + 1, roots, refused);
+                continue;
+            }
+            index += 1;
+            continue;
+        }
+        // `type X` and `extend type X`. Only object types can be a root operation
+        // type — an `input`, `interface`, `enum`, `union` or `scalar` never is.
+        const isExtend = token.value === "extend" && tokens[index + 1]?.value === "type";
+        if (token.value !== "type" && !isExtend) {
+            index += 1;
+            continue;
+        }
+        const nameToken = tokens[index + (isExtend ? 2 : 1)];
+        if (nameToken?.kind !== "name") {
+            index += 1;
+            continue;
+        }
+        // Past `implements A & B` and any directives, to the body.
+        let cursor = index + (isExtend ? 3 : 2);
+        while (cursor < tokens.length) {
+            const next = tokens[cursor];
+            if (next.kind === "punct" && next.value === "(") {
+                cursor = skipBalanced(tokens, cursor, "(", ")");
+                continue;
+            }
+            if (next.kind === "punct" && next.value === "{")
+                break;
+            // A type extension may have no body at all (`extend type X @dir`), and a
+            // bare `type X` ends where the next definition begins.
+            if (next.kind === "name" && (next.value === "type" || next.value === "extend" || next.value === "schema")) {
+                break;
+            }
+            cursor += 1;
+        }
+        if (!(tokens[cursor]?.kind === "punct" && tokens[cursor].value === "{")) {
+            index = cursor;
+            continue;
+        }
+        sawTypeDefinition = true;
+        const { fields, end } = fieldsIn(tokens, cursor + 1);
+        const existing = byType.get(nameToken.value);
+        if (existing === undefined)
+            byType.set(nameToken.value, fields);
+        else
+            existing.push(...fields);
+        index = end;
+    }
+    if (!sawTypeDefinition)
+        return undefined;
+    if (!sawSchemaBlock) {
+        // The specification's defaults. This assembles no name that is not written
+        // in the file: the *field* names are still read verbatim, and the three
+        // root type words are GraphQL's own, fixed by the grammar — the same
+        // footing on which `DEC-317` assembles the `/Query/` prefix from a slot.
+        for (const slot of OPERATION_SLOTS) {
+            if (byType.has(DEFAULT_ROOT_TYPE[slot]))
+                roots.set(slot, DEFAULT_ROOT_TYPE[slot]);
+        }
+    }
+    // **Not `roots.size === 0`.** A document whose `schema` block declares roots
+    // this reader could not read has zero roots and something to say, and
+    // returning `undefined` there would drop the refusal on the floor — the
+    // adapter would report "no GraphQL here" about a file that plainly contains
+    // a schema. Silence is what rule 7 forbids; the empty result must arrive
+    // carrying its reasons.
+    if (roots.size === 0 && refused.length === 0)
+        return undefined;
+    const fields = new Map();
+    for (const [slot, typeName] of roots) {
+        const declared = byType.get(typeName);
+        if (declared === undefined) {
+            refused.push({
+                what: typeName,
+                why: `the schema block names ${typeName} as the ${slot} root, but this document does not declare it — ` +
+                    "SDL split across files is not stitched, by declared limit",
+                line: 1,
+            });
+            continue;
+        }
+        // Illegal in valid SDL, but a duplicate would otherwise report one
+        // operation twice and inflate every count this adapter is measured by.
+        const seen = new Set();
+        fields.set(typeName, declared
+            .filter((field) => (seen.has(field.name) ? false : (seen.add(field.name), true)))
+            .map((field) => ({ ...field, slot })));
+    }
+    return { roots, rootsDeclared: sawSchemaBlock, fields, refused };
+}
+/** Every root operation the document declares, in slot then declaration order. */
+export function rootFieldsOf(schema) {
+    const out = [];
+    for (const slot of OPERATION_SLOTS) {
+        const typeName = schema.roots.get(slot);
+        if (typeName === undefined)
+            continue;
+        out.push(...(schema.fields.get(typeName) ?? []));
+    }
+    return out;
+}
+//# sourceMappingURL=document.js.map

package/dist/document.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export { ADAPTER_ID, ADAPTER_VERSION, DEFAULT_SCHEMA_GLOBS, GRAPHQL_METHOD, LANGUAGE, createGraphqlAdapter, operationPath, type GraphqlAdapterOptions, } from "./adapter.ts";
+export { OPERATION_SLOTS, OPERATION_TYPE, readSchema, rootFieldsOf, type OperationSlot, type Refusal, type RootField, type Schema, } from "./document.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,aAAa,EACb,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,EACZ,KAAK,aAAa,EAClB,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,MAAM,GACZ,MAAM,eAAe,CAAC"}

package/dist/index.js ADDED Viewed

@@ -0,0 +1,3 @@
+export { ADAPTER_ID, ADAPTER_VERSION, DEFAULT_SCHEMA_GLOBS, GRAPHQL_METHOD, LANGUAGE, createGraphqlAdapter, operationPath, } from "./adapter.js";
+export { OPERATION_SLOTS, OPERATION_TYPE, readSchema, rootFieldsOf, } from "./document.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,QAAQ,EACR,oBAAoB,EACpB,aAAa,GAEd,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,cAAc,EACd,UAAU,EACV,YAAY,GAKb,MAAM,eAAe,CAAC"}

package/package.json ADDED Viewed

@@ -0,0 +1,31 @@
+{
+  "name": "@descryy/adapter-graphql",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "GraphQL SDL adapter. Reaches R3 with no language adapter at all \u2014 a published schema states its own operations, and their names are read rather than computed.",
+  "license": "UNLICENSED",
+  "engines": {
+    "node": ">=22.5"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@descryy/adapter-common": "0.1.0",
+    "@descryy/ir": "0.3.0",
+    "@descryy/adapter-python": "0.1.0"
+  }
+}