@glubean/graphql 0.1.7 → 0.2.2

package/dist/contract/adapter.js

@@ -0,0 +1,513 @@
+/**
+ * Built-in GraphQL contract adapter for @glubean/graphql 0.2.0.
+ *
+ * Shipped alongside the transport plugin in @glubean/graphql (single-package
+ * model — "contract is a first-class citizen"). Registered via
+ * `contract.register("graphql", graphqlAdapter)` on import — see ./index.ts.
+ *
+ * Responsibilities (same interface as HTTP / gRPC adapters):
+ *   - execute: setup → call → expect → verify → teardown
+ *   - executeCaseInFlow: deep-merge resolvedInputs, run case in flow mode
+ *   - validateCaseForFlow: reject function-valued variables / headers
+ *   - project: runtime ContractProjection<GraphqlPayloadSchemas>
+ *   - normalize: runtime → JSON-safe ExtractedContractProjection
+ *   - classifyFailure: 3-layer (transport / payload errors / data shape)
+ *   - renderTarget: operationName (parsed from query if needed)
+ *   - toMarkdown: case list with operation + query snippet
+ *   - describePayload: high-level summary for index views
+ *
+ * Phase 1 scope: query + mutation only. Subscription deferred to Phase 2.
+ */
+import { genericMarkdownPart } from "@glubean/sdk";
+import { parseOperationName } from "../index.js";
+// =============================================================================
+// Helpers
+// =============================================================================
+/** Convert a SchemaLike to a JSON Schema fragment if possible (best-effort). */
+export function schemaToJsonSchema(schema) {
+    if (!schema || typeof schema !== "object")
+        return null;
+    const maybe = schema.toJSONSchema;
+    if (typeof maybe === "function") {
+        try {
+            const out = maybe.call(schema);
+            if (out && typeof out === "object")
+                return out;
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/** Deep-merge two plain objects (right wins). Handles nested objects; skips arrays. */
+function deepMerge(base, override) {
+    if (!base && !override)
+        return {};
+    if (!base)
+        return { ...override };
+    if (!override)
+        return { ...base };
+    const out = { ...base };
+    for (const [k, v] of Object.entries(override)) {
+        const baseVal = base[k];
+        if (v != null &&
+            typeof v === "object" &&
+            !Array.isArray(v) &&
+            baseVal != null &&
+            typeof baseVal === "object" &&
+            !Array.isArray(baseVal)) {
+            out[k] = deepMerge(baseVal, v);
+        }
+        else {
+            out[k] = v;
+        }
+    }
+    return out;
+}
+/** Resolve the effective GraphQL client with case > spec fallback. */
+function resolveClient(caseSpec, spec) {
+    const client = caseSpec.client ?? spec.client;
+    if (!client) {
+        throw new Error(`No GraphQL client provided for case. Set "client" on the case or contract spec (e.g. via contract.graphql.with("name", { client: gqlPlugin })).`);
+    }
+    return client;
+}
+/** Merge headers: contract defaults < case. */
+function resolveHeaders(spec, caseSpec, state) {
+    const caseHeaders = typeof caseSpec.headers === "function"
+        ? caseSpec.headers(state)
+        : caseSpec.headers;
+    const specHeaders = spec.defaultHeaders;
+    if (!caseHeaders && !specHeaders)
+        return undefined;
+    return { ...(specHeaders ?? {}), ...(caseHeaders ?? {}) };
+}
+/** Resolve variables with deep-merge: spec.defaultVariables < case.variables. */
+function resolveVariables(spec, caseSpec, state) {
+    const caseVars = typeof caseSpec.variables === "function"
+        ? caseSpec.variables(state)
+        : caseSpec.variables;
+    return deepMerge(spec.defaultVariables, caseVars);
+}
+/** Resolve effective operation type: case > spec default > "query". */
+function resolveOperation(spec, caseSpec) {
+    return caseSpec.operation ?? spec.defaultOperation ?? "query";
+}
+/** Resolve display operationName: case.operationName > parsed from query > "anonymous". */
+function resolveOperationName(caseSpec) {
+    return (caseSpec.operationName ?? parseOperationName(caseSpec.query) ?? "anonymous");
+}
+/**
+ * Call the GraphQL client for a case. Returns the full GraphQLResult envelope
+ * plus the resolved operation + operationName + duration.
+ */
+async function callGraphql(client, caseSpec, spec, variables, headers) {
+    const operation = resolveOperation(spec, caseSpec);
+    const operationName = resolveOperationName(caseSpec);
+    const start = Date.now();
+    const callFn = operation === "mutation" ? client.mutate : client.query;
+    const res = await callFn.call(client, caseSpec.query, {
+        variables,
+        ...(headers ? { headers } : {}),
+        operationName: operationName !== "anonymous" ? operationName : undefined,
+    });
+    const duration = Date.now() - start;
+    return {
+        data: res.data,
+        errors: res.errors,
+        extensions: res.extensions,
+        httpStatus: res.httpStatus,
+        headers: res.headers,
+        rawBody: res.rawBody,
+        operationName,
+        duration,
+    };
+}
+/**
+ * 3-layer assertion: transport → payload errors → data shape.
+ * Uses `ctx.assert` / `ctx.expect` / `ctx.validate` for structured failures.
+ */
+function assertResult(ctx, result, caseSpec) {
+    const expect = caseSpec.expect ?? {};
+    const expectedStatus = expect.httpStatus ?? 200;
+    // Layer 1: transport (HTTP status)
+    if (result.httpStatus !== expectedStatus) {
+        ctx.assert(false, `Expected HTTP status ${expectedStatus} but got ${result.httpStatus}`, { actual: result.httpStatus, expected: expectedStatus });
+    }
+    // Layer 2: payload errors (GraphQL `errors` array)
+    assertErrors(ctx, result.errors, expect.errors ?? "absent");
+    // Layer 3: data shape (only when transport succeeded and errors absent OR
+    // `data` partial expect is declared — schema always runs if provided)
+    if (expect.schema) {
+        ctx.validate(result.data, expect.schema, `response data`);
+    }
+    if (expect.data) {
+        if (result.data == null) {
+            ctx.assert(false, `Expected data shape to match but response.data was null`, { actual: null, expected: expect.data });
+        }
+        else {
+            ctx.expect(result.data).toMatchObject(expect.data);
+        }
+    }
+    // Response headers assertions
+    if (expect.headersMatch) {
+        ctx.expect(result.headers).toMatchObject(expect.headersMatch);
+    }
+    if (expect.headers) {
+        ctx.validate(result.headers, expect.headers, `response headers`);
+    }
+}
+/**
+ * Assert the `errors` layer against a sentinel or partial array.
+ */
+function assertErrors(ctx, actual, expected) {
+    const errs = actual ?? [];
+    if (expected === "absent") {
+        if (errs.length > 0) {
+            ctx.assert(false, `Expected no GraphQL errors but got ${errs.length}: ${errs.map((e) => e.message).join("; ")}`, { actual: errs, expected: [] });
+        }
+        return;
+    }
+    if (expected === "any") {
+        return; // accept whatever shows up
+    }
+    // Array of partial GraphQLError — match by position (each entry partial-matches)
+    if (errs.length < expected.length) {
+        ctx.assert(false, `Expected ${expected.length} GraphQL errors but got ${errs.length}`, { actual: errs, expected });
+        return;
+    }
+    for (let i = 0; i < expected.length; i++) {
+        const want = expected[i];
+        const got = errs[i];
+        // Partial match on top-level keys (message, extensions.code, etc.)
+        for (const [k, v] of Object.entries(want)) {
+            if (k === "extensions" && v && typeof v === "object") {
+                ctx.expect((got.extensions ?? {})).toMatchObject(v);
+            }
+            else {
+                ctx.expect(got[k]).toEqual(v);
+            }
+        }
+    }
+}
+// =============================================================================
+// executeCase — standard (non-flow) case execution
+// =============================================================================
+async function executeCase(ctx, caseSpec, spec) {
+    if (!caseSpec.query || typeof caseSpec.query !== "string") {
+        throw new Error(`GraphQL contract case: "query" is required and must be a string.`);
+    }
+    const state = caseSpec.setup
+        ? await caseSpec.setup(ctx)
+        : undefined;
+    try {
+        const client = resolveClient(caseSpec, spec);
+        const variables = resolveVariables(spec, caseSpec, state);
+        const headers = resolveHeaders(spec, caseSpec, state);
+        const result = await callGraphql(client, caseSpec, spec, variables, headers);
+        assertResult(ctx, result, caseSpec);
+        if (caseSpec.verify) {
+            await caseSpec.verify(ctx, result);
+        }
+    }
+    finally {
+        if (caseSpec.teardown) {
+            await caseSpec.teardown(ctx, state);
+        }
+    }
+}
+// =============================================================================
+// project — runtime ContractProjection
+// =============================================================================
+function projectGraphql(spec) {
+    const meta = {
+        endpoint: spec.endpoint,
+        defaultOperation: spec.defaultOperation,
+        defaultHeaders: spec.defaultHeaders,
+        types: spec.types,
+    };
+    const cases = Object.entries(spec.cases).map(([key, c]) => {
+        const casted = c;
+        const lifecycle = casted.deprecated
+            ? "deprecated"
+            : casted.deferred
+                ? "deferred"
+                : "active";
+        const operation = resolveOperation(spec, casted);
+        const operationName = resolveOperationName(casted);
+        const schemas = {
+            query: casted.query,
+            operation,
+            operationName,
+            variables: spec.variablesSchema,
+            response: casted.expect?.schema ?? spec.responseSchema,
+            headers: casted.expect?.headers,
+        };
+        return {
+            key,
+            description: casted.description,
+            lifecycle,
+            severity: casted.severity ?? "warning",
+            deferredReason: casted.deferred,
+            deprecatedReason: casted.deprecated,
+            schemas,
+            tags: casted.tags,
+            extensions: casted.extensions,
+            requires: casted.requires,
+            defaultRun: casted.defaultRun,
+        };
+    });
+    // Read factory-provided metadata from the internal `_factory` channel
+    // populated by `mergeGraphqlDefaults`.
+    const factory = spec._factory;
+    return {
+        protocol: "graphql",
+        target: spec.endpoint ?? "",
+        description: spec.description,
+        feature: spec.feature,
+        instanceName: factory?.instanceName,
+        tags: spec.tags,
+        extensions: spec.extensions,
+        deprecated: spec.deprecated,
+        cases,
+        schemas: {},
+        meta,
+    };
+}
+// =============================================================================
+// normalize — runtime → JSON-safe Extracted
+// =============================================================================
+function normalizeGraphql(projection) {
+    const safeCases = projection.cases.map((c) => {
+        const s = c.schemas ?? {};
+        const safe = {
+            query: s.query,
+            operation: s.operation,
+            operationName: s.operationName,
+            variables: schemaToJsonSchema(s.variables) ?? undefined,
+            response: schemaToJsonSchema(s.response) ?? undefined,
+            headers: schemaToJsonSchema(s.headers) ?? undefined,
+            variablesExample: s.variablesExample,
+            variablesExamples: s.variablesExamples,
+        };
+        return { ...c, schemas: safe };
+    });
+    return {
+        id: projection.id,
+        protocol: projection.protocol,
+        target: projection.target,
+        description: projection.description,
+        feature: projection.feature,
+        instanceName: projection.instanceName,
+        tags: projection.tags,
+        extensions: projection.extensions,
+        deprecated: projection.deprecated,
+        cases: safeCases,
+        schemas: {},
+        meta: projection.meta,
+    };
+}
+// =============================================================================
+// executeCaseInFlow — flow-mode execution
+// =============================================================================
+async function executeCaseInFlowGraphql(input) {
+    const { ctx, contract: c, caseKey, resolvedInputs } = input;
+    const spec = c._spec;
+    const caseSpec = spec.cases[caseKey];
+    if (!caseSpec) {
+        throw new Error(`GraphQL contract: unknown case key "${caseKey}".`);
+    }
+    if (!caseSpec.query || typeof caseSpec.query !== "string") {
+        throw new Error(`GraphQL contract case "${caseKey}": "query" is required and must be a string.`);
+    }
+    const state = caseSpec.setup
+        ? (await caseSpec.setup(ctx))
+        : undefined;
+    try {
+        const client = resolveClient(caseSpec, spec);
+        const staticVars = typeof caseSpec.variables === "function"
+            ? undefined
+            : caseSpec.variables;
+        const staticHeaders = typeof caseSpec.headers === "function"
+            ? undefined
+            : caseSpec.headers;
+        const lensInput = (resolvedInputs ?? {});
+        // Deep-merge lens variables over case static + spec default
+        const mergedVariables = deepMerge(deepMerge(spec.defaultVariables, staticVars), lensInput.variables);
+        const mergedHeaders = {
+            ...(spec.defaultHeaders ?? {}),
+            ...(staticHeaders ?? {}),
+            ...(lensInput.headers ?? {}),
+        };
+        const result = await callGraphql(client, caseSpec, spec, mergedVariables, Object.keys(mergedHeaders).length > 0 ? mergedHeaders : undefined);
+        assertResult(ctx, result, caseSpec);
+        if (caseSpec.verify) {
+            await caseSpec.verify(ctx, result);
+        }
+        return result;
+    }
+    finally {
+        if (caseSpec.teardown) {
+            await caseSpec.teardown(ctx, state);
+        }
+    }
+}
+// =============================================================================
+// validateCaseForFlow — reject function-valued fields in flow mode
+// =============================================================================
+export function validateGraphqlCaseForFlow(spec, caseKey, contractId) {
+    const caseSpec = spec.cases[caseKey];
+    if (!caseSpec) {
+        throw new Error(`contract.graphql(${JSON.stringify(contractId)}).case(${JSON.stringify(caseKey)}): case not found.`);
+    }
+    const functionFields = [];
+    if (typeof caseSpec.variables === "function")
+        functionFields.push("variables");
+    if (typeof caseSpec.headers === "function")
+        functionFields.push("headers");
+    if (functionFields.length > 0) {
+        throw new Error(`contract.graphql(${JSON.stringify(contractId)}).case(${JSON.stringify(caseKey)}): ` +
+            `cannot use function-valued ${functionFields.join(" / ")} in a flow step — ` +
+            `these fields depend on case-local setup state which isn't available in flow mode. ` +
+            `Move the value into flow state and use step.in lens instead.`);
+    }
+}
+// =============================================================================
+// classifyFailure — 3-layer (transport / payload / data shape)
+// =============================================================================
+/**
+ * Classify failures based on:
+ *   1. Transport: HTTP status from the underlying POST
+ *   2. Payload: GraphQL `errors` array with optional `extensions.code`
+ *   3. Error shape (network / timeout) when no response was parsed
+ *
+ * Emitted events inspected: `graphql_response` (if adapter/transport emits
+ * it), else falls back to generic error shape.
+ */
+function classifyGraphqlFailure(input) {
+    const gqlEvent = input.events.find((e) => e.type === "graphql_response");
+    if (gqlEvent) {
+        const httpStatus = typeof gqlEvent.data?.httpStatus === "number"
+            ? gqlEvent.data.httpStatus
+            : undefined;
+        const errors = Array.isArray(gqlEvent.data?.errors)
+            ? gqlEvent.data.errors
+            : undefined;
+        const transport = statusToClassification(httpStatus);
+        if (transport)
+            return transport;
+        const payload = payloadErrorsToClassification(errors);
+        if (payload)
+            return payload;
+        return undefined;
+    }
+    // Fall back to HTTP event emitted by the underlying transport
+    const httpEvent = input.events.find((e) => e.type === "http_response");
+    if (httpEvent) {
+        const status = typeof httpEvent.data?.status === "number"
+            ? httpEvent.data.status
+            : undefined;
+        const transport = statusToClassification(status);
+        if (transport)
+            return transport;
+    }
+    // Error shape fallback
+    if (input.error instanceof Error) {
+        const name = input.error.name;
+        if (name === "TimeoutError" || name === "AbortError") {
+            return { kind: "transient", source: "trace", retryable: true, message: input.error.message };
+        }
+        if (name === "GraphQLResponseError") {
+            return { kind: "semantic", source: "trace", message: input.error.message };
+        }
+        return { kind: "server", source: "trace", message: input.error.message };
+    }
+    return undefined;
+}
+function statusToClassification(status) {
+    if (status === undefined)
+        return undefined;
+    if (status >= 200 && status < 300)
+        return undefined;
+    if (status === 401 || status === 403) {
+        return { kind: "auth", source: "trace", message: `HTTP ${status}` };
+    }
+    if (status === 408 || status === 429) {
+        return { kind: "transient", source: "trace", retryable: true, message: `HTTP ${status}` };
+    }
+    if (status >= 400 && status < 500) {
+        return { kind: "client", source: "trace", message: `HTTP ${status}` };
+    }
+    if (status === 502 || status === 503 || status === 504) {
+        return { kind: "transient", source: "trace", retryable: true, message: `HTTP ${status}` };
+    }
+    if (status >= 500) {
+        return { kind: "server", source: "trace", message: `HTTP ${status}` };
+    }
+    return undefined;
+}
+/**
+ * Interpret GraphQL `errors[].extensions.code` when present.
+ *
+ * Common codes: UNAUTHENTICATED, FORBIDDEN, BAD_USER_INPUT, NOT_FOUND,
+ * INTERNAL_SERVER_ERROR. Unknown or missing codes → semantic.
+ */
+function payloadErrorsToClassification(errors) {
+    if (!errors || errors.length === 0)
+        return undefined;
+    const first = errors[0];
+    const code = first.extensions?.code;
+    const codeStr = typeof code === "string" ? code.toUpperCase() : "";
+    if (codeStr === "UNAUTHENTICATED" || codeStr === "FORBIDDEN") {
+        return { kind: "auth", source: "trace", message: first.message };
+    }
+    if (codeStr === "BAD_USER_INPUT" || codeStr === "GRAPHQL_VALIDATION_FAILED" || codeStr === "GRAPHQL_PARSE_FAILED") {
+        return { kind: "client", source: "trace", message: first.message };
+    }
+    if (codeStr === "INTERNAL_SERVER_ERROR") {
+        return { kind: "server", source: "trace", message: first.message };
+    }
+    return { kind: "semantic", source: "trace", message: first.message };
+}
+// =============================================================================
+// renderTarget — display operationName (or endpoint if none)
+// =============================================================================
+function renderGraphqlTarget(target) {
+    // `target` here is `spec.endpoint` per projectGraphql. Display as-is;
+    // per-case operationName is surfaced in toMarkdown, not here.
+    return target || "(graphql)";
+}
+// =============================================================================
+// describePayload — high-level summary for index views
+// =============================================================================
+function describeGraphqlPayload(schemas) {
+    const hasRequest = schemas.query !== undefined || schemas.variables !== undefined;
+    const hasResponse = schemas.response !== undefined;
+    return {
+        hasRequest,
+        hasResponse,
+        protocol: "graphql",
+    };
+}
+// =============================================================================
+// Exported adapter
+// =============================================================================
+export const graphqlAdapter = {
+    async execute(ctx, caseSpec, contractSpec) {
+        await executeCase(ctx, caseSpec, contractSpec);
+    },
+    project: projectGraphql,
+    normalize: normalizeGraphql,
+    executeCaseInFlow: executeCaseInFlowGraphql,
+    validateCaseForFlow: validateGraphqlCaseForFlow,
+    classifyFailure: classifyGraphqlFailure,
+    renderTarget: renderGraphqlTarget,
+    // Markdown uses the SDK's generic structured renderer — GraphQL has no
+    // protocol-specific augmentations to contribute.
+    artifacts: {
+        markdown: (projection) => genericMarkdownPart(projection),
+    },
+    describePayload: describeGraphqlPayload,
+};
+//# sourceMappingURL=adapter.js.map

package/dist/contract/adapter.js.map

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

package/dist/contract/factory.d.ts

@@ -0,0 +1,34 @@
+/**
+ * contract.graphql factory — scoped-defaults pattern.
+ *
+ * Root `contract.graphql` exposes only `.with(name, defaults)`. Calling
+ * `contract.graphql("id", spec)` directly is forbidden — client injection
+ * via scoped instances is the canonical authoring pattern (same as HTTP
+ * and gRPC).
+ *
+ * The factory wraps the generic dispatcher attached to `contract.graphql`
+ * by `contract.register("graphql", graphqlAdapter)`. Calls flow through:
+ *   user code
+ *     → scoped factory(id, spec)
+ *     → merge instance defaults into spec
+ *     → dispatcher(id, mergedSpec)   [generic register() output]
+ *     → adapter.project + per-case registerTest + Test[] with
+ *       _projection/_spec
+ */
+import type { ProtocolContract } from "@glubean/sdk";
+import type { GraphqlContractCase, GraphqlContractDefaults, GraphqlContractFactory, GraphqlContractMeta, GraphqlContractRoot, GraphqlContractSpec, GraphqlPayloadSchemas } from "./types.js";
+type InternalDefaults = GraphqlContractDefaults & {
+    _name?: string;
+};
+type GraphqlDispatch = <Vars extends Record<string, unknown>, Res, Cases extends Record<string, GraphqlContractCase<Vars, Res, any>>>(id: string, spec: GraphqlContractSpec<Vars, Res, Cases>) => ProtocolContract<GraphqlContractSpec, GraphqlPayloadSchemas, GraphqlContractMeta>;
+/**
+ * Build a scoped GraphQL factory. `dispatch` is `contract.graphql` attached
+ * by the core's register() call — we wrap it to inject instance defaults.
+ */
+export declare function createGraphqlFactory(dispatch: GraphqlDispatch, defaults?: InternalDefaults): GraphqlContractFactory;
+/**
+ * Root factory — `.with()` only, direct call throws.
+ */
+export declare function createGraphqlRoot(dispatch: GraphqlDispatch): GraphqlContractRoot;
+export {};
+//# sourceMappingURL=factory.d.ts.map

package/dist/contract/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/contract/factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAc,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB,KAAK,gBAAgB,GAAG,uBAAuB,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE,KAAK,eAAe,GAAG,CACrB,IAAI,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,GAAG,EACH,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAEjE,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,mBAAmB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,KACxC,gBAAgB,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,mBAAmB,CAAC,CAAC;AA+CvF;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,eAAe,EACzB,QAAQ,CAAC,EAAE,gBAAgB,GAC1B,sBAAsB,CA0CxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,mBAAmB,CAEhF"}

package/dist/contract/factory.js

@@ -0,0 +1,94 @@
+/**
+ * contract.graphql factory — scoped-defaults pattern.
+ *
+ * Root `contract.graphql` exposes only `.with(name, defaults)`. Calling
+ * `contract.graphql("id", spec)` directly is forbidden — client injection
+ * via scoped instances is the canonical authoring pattern (same as HTTP
+ * and gRPC).
+ *
+ * The factory wraps the generic dispatcher attached to `contract.graphql`
+ * by `contract.register("graphql", graphqlAdapter)`. Calls flow through:
+ *   user code
+ *     → scoped factory(id, spec)
+ *     → merge instance defaults into spec
+ *     → dispatcher(id, mergedSpec)   [generic register() output]
+ *     → adapter.project + per-case registerTest + Test[] with
+ *       _projection/_spec
+ */
+function mergeExtensions(base, override) {
+    if (!base && !override)
+        return undefined;
+    const merged = {
+        ...(base ?? {}),
+        ...(override ?? {}),
+    };
+    return Object.keys(merged).length > 0 ? merged : undefined;
+}
+function mergeGraphqlDefaults(defaults, spec) {
+    if (!defaults)
+        return spec;
+    const mergedTags = [...(defaults.tags ?? []), ...(spec.tags ?? [])];
+    const mergedExtensions = mergeExtensions(defaults.extensions, spec.extensions);
+    const mergedHeaders = {
+        ...(defaults.headers ?? {}),
+        ...(spec.defaultHeaders ?? {}),
+    };
+    // Embed the factory's instanceName into the spec via a private `_factory`
+    // channel. `projectGraphql` reads this at projection time so the produced
+    // `_projection` (and `_extracted`) already carries it — no post-dispatch
+    // mutation needed.
+    const baseMerged = {
+        ...spec,
+        client: spec.client ?? defaults.client,
+        endpoint: spec.endpoint ?? defaults.endpoint,
+        feature: spec.feature ?? defaults.feature,
+        tags: mergedTags.length > 0 ? mergedTags : undefined,
+        extensions: mergedExtensions,
+        defaultHeaders: Object.keys(mergedHeaders).length > 0 ? mergedHeaders : undefined,
+    };
+    if (defaults._name) {
+        baseMerged._factory = {
+            instanceName: defaults._name,
+        };
+    }
+    return baseMerged;
+}
+/**
+ * Build a scoped GraphQL factory. `dispatch` is `contract.graphql` attached
+ * by the core's register() call — we wrap it to inject instance defaults.
+ */
+export function createGraphqlFactory(dispatch, defaults) {
+    const factory = (id, spec) => {
+        if (!defaults?._name) {
+            throw new Error(`contract.graphql("${id}", spec) is not supported. ` +
+                `Use contract.graphql.with("name", { client }) first to create a scoped instance, ` +
+                `then call instance("${id}", spec).`);
+        }
+        const merged = mergeGraphqlDefaults(defaults, spec);
+        return dispatch(id, merged);
+    };
+    factory.with = (name, more = {}) => {
+        const mergedTags = [...(defaults?.tags ?? []), ...(more.tags ?? [])];
+        const mergedExtensions = mergeExtensions(defaults?.extensions, more.extensions);
+        const mergedHeaders = {
+            ...(defaults?.headers ?? {}),
+            ...(more.headers ?? {}),
+        };
+        return createGraphqlFactory(dispatch, {
+            ...defaults,
+            ...more,
+            tags: mergedTags.length > 0 ? mergedTags : undefined,
+            extensions: mergedExtensions,
+            headers: Object.keys(mergedHeaders).length > 0 ? mergedHeaders : undefined,
+            _name: name,
+        });
+    };
+    return factory;
+}
+/**
+ * Root factory — `.with()` only, direct call throws.
+ */
+export function createGraphqlRoot(dispatch) {
+    return createGraphqlFactory(dispatch);
+}
+//# sourceMappingURL=factory.js.map