@wildo-ai/external-connectors-models 1.1.11 → 1.1.12

package/dist/esm/protocols/graphql-operations.external-connectors-models.schemas.js

@@ -0,0 +1,480 @@
+/**
+ * GRAPHQL provider operations (#3392): an operation whose provider-owned part is a GraphQL document, and whose input is
+ * the document's VARIABLES.
+ *
+ * A REST operation is a method, a path and a body built from the caller's input. A GraphQL vendor (GitHub v4, Linear,
+ * Shopify Admin, monday.com) exposes ONE endpoint and tells operations apart by the query document sent to it. Written
+ * as a REST operation, the document had to be an input, which handed the caller the vendor's whole schema and made every
+ * operation the same operation. Here the PROVIDER owns the document (`graphql.document`, with its `operationName`), and
+ * the caller supplies only values for the variables that document declares.
+ *
+ * ## The wire, settled by the GraphQL-over-HTTP specification
+ *
+ * The request is a POST whose JSON body holds `query` (the document), `operationName` and `variables`. The client
+ * accepts `application/graphql-response+json` first and `application/json` after it, because the vendor's support for
+ * the newer media type is unknown.
+ * spec-cite: GraphQL over HTTP, Current Working Draft (https://graphql.github.io/graphql-over-http/draft/, fetched
+ * 2026-11-09) — §4.1 lists the request parameters `query` (required), `operationName`, `variables` and `extensions`;
+ * §4.4 "A server MUST support POST requests with a body encoded as UTF-8 JSON, using the `application/json` media type";
+ * §4.2 "the client SHOULD set the Accept header to application/graphql-response+json, application/json;q=0.9".
+ *
+ * ## The answer: errors arrive IN BAND, on a 2xx
+ *
+ * A GraphQL server reports most failures inside a successful HTTP answer, in an `errors` list beside (or instead of)
+ * `data`. Read as REST, such an answer is a success, so a refused call would be returned to its caller as a result. The
+ * rule here, which {@link readProviderGraphqlResponse} applies and the engine's transport enforces on every GraphQL call:
+ *
+ * | the answer | verdict |
+ * |---|---|
+ * | `data` is an object, no `errors` (or an empty list) | SUCCEEDED; the output is read from `data` |
+ * | `errors`, and no `data` entry | REQUEST_ERROR: the server refused before executing anything |
+ * | `errors`, and a `data` entry (null or partial) | EXECUTION_ERROR: execution began and a field failed |
+ * | neither a `data` object nor `errors` | UNSTATED: the answer does not say what happened |
+ * | `data`, no `errors`, and the mutation's declared `payloadRefusal` says refused | PAYLOAD_REFUSED: the vendor did not do the write |
+ *
+ * spec-cite: GraphQL, September 2025 edition (https://spec.graphql.org/September2025/, fetched 2026-11-09) — §7.1.1
+ * "If execution raised any errors, the execution result must contain an entry with key "errors"" and "The value of this
+ * entry must be a non-empty list"; §7.1.3 "The request error result map must not contain an entry with key "data""; §7.1.5
+ * "If an error was raised during the execution that prevented a valid response, the "data" entry in the response should
+ * be null"; §6.3.4 (mutation) "the selections in the top most selection set will be executed in serial order".
+ * spec-cite: https://docs.github.com/en/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api — for the
+ * primary rate limit "the response status will still be `200`", fetched 2026-11-09: a 200 is not a success.
+ *
+ * PARTIAL DATA IS NEVER RETURNED AS A RESULT. Any error fails the call, whatever `data` holds, because a caller handed a
+ * partial object cannot tell a field the vendor left null from a field that failed. For a MUTATION whose execution began,
+ * the failure says the outcome is UNKNOWN: the root fields run in order and an error in one does not undo the ones
+ * before it, so whether the change landed is not stated. A request error (no `data`) applied nothing, mutation or not.
+ *
+ * ## What is not checked here
+ *
+ * The document is checked for its SHAPE (it parses into exactly one operation of the declared name and type, and its
+ * variables are the input's fields). It is not validated against the vendor's schema here: publish does that, against
+ * the schema the module pins as `provider.graphqlSchema` (#3392, the counterpart of the OpenAPI conformance check of
+ * #2028). The OpenAPI conformance check skips a GraphQL operation, since an OpenAPI description does not describe a
+ * GraphQL endpoint.
+ */
+import { ExternalOperation_Classification } from '../core/operation-classification.external-connectors-models.schemas.js';
+import { API_HttpMethod } from '../core/commons.external-connectors-models.schemas.js';
+import { PROVIDER_VENDOR_ERROR_CODE_SHAPE, ProviderRestResponseDecoding } from './rest-operations.external-connectors-models.schemas.js';
+/** How a mutation's payload states a refusal. See {@link ProviderRestOperationGraphql.payloadRefusal}. */
+export var ProviderGraphqlPayloadRefusalKind;
+(function (ProviderGraphqlPayloadRefusalKind) {
+    /** A list of the vendor's refusals (Shopify's `userErrors`): the write was refused when the list is not empty. */
+    ProviderGraphqlPayloadRefusalKind["USER_ERRORS"] = "user_errors";
+    /** A boolean the vendor sets to `false` when it did not do the write (Linear's `success`). */
+    ProviderGraphqlPayloadRefusalKind["SUCCESS_FLAG"] = "success_flag";
+})(ProviderGraphqlPayloadRefusalKind || (ProviderGraphqlPayloadRefusalKind = {}));
+/** What a GraphQL document's operation does. A `subscription` is not served over a single POST, so it is no member. */
+export var ProviderGraphqlOperationType;
+(function (ProviderGraphqlOperationType) {
+    /** Reads. The operation must be classified READ. */
+    ProviderGraphqlOperationType["QUERY"] = "query";
+    /** Changes the vendor. The operation must be classified WRITE. */
+    ProviderGraphqlOperationType["MUTATION"] = "mutation";
+})(ProviderGraphqlOperationType || (ProviderGraphqlOperationType = {}));
+/**
+ * The `Accept` a GraphQL call sends: the GraphQL response media type first, `application/json` for a server that predates
+ * it (GraphQL over HTTP §4.2, quoted in this module's header).
+ * semantic-literal-boundary: the media types GraphQL over HTTP names, sent on the wire.
+ */
+export const PROVIDER_GRAPHQL_ACCEPT_HEADER = 'application/graphql-response+json, application/json;q=0.9';
+/** At most this many of the vendor's error messages are kept on a failure. */
+export const PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES = 10;
+/** A kept error message is cut at this many characters. */
+export const PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH = 500;
+const GRAPHQL_NAME = /^[_A-Za-z][_0-9A-Za-z]*$/;
+const GRAPHQL_PUNCTUATORS = new Set(['!', '$', '&', '(', ')', ':', '=', '@', '[', ']', '{', '|', '}']);
+/**
+ * The tokens of a GraphQL document, with strings and comments dropped: enough to find its definitions and their
+ * variables. Not a validating parser: the vendor's server is the parser that decides, and this only has to see the
+ * document's outline. A block string (`"""…"""`) and a string (`"…"`, with `\` escapes) are skipped whole, so a brace or
+ * a `$` inside one is never read as structure. `undefined` for a string that never closes.
+ */
+function tokenizeGraphqlDocument(document) {
+    const tokens = [];
+    let index = 0;
+    while (index < document.length) {
+        const character = document[index];
+        if (character === '#') {
+            while (index < document.length && document[index] !== '\n' && document[index] !== '\r')
+                index += 1;
+            continue;
+        }
+        if (character === '"') {
+            if (document.startsWith('"""', index)) {
+                const close = document.indexOf('"""', index + 3);
+                // A `\"""` inside a block string is an escaped delimiter, not its end.
+                let end = close;
+                while (end !== -1 && document[end - 1] === '\\')
+                    end = document.indexOf('"""', end + 3);
+                if (end === -1)
+                    return undefined;
+                index = end + 3;
+            }
+            else {
+                index += 1;
+                while (index < document.length && document[index] !== '"') {
+                    if (document[index] === '\n')
+                        return undefined;
+                    index += document[index] === '\\' ? 2 : 1;
+                }
+                if (index >= document.length)
+                    return undefined;
+                index += 1;
+            }
+            tokens.push('"');
+            continue;
+        }
+        if (character === '.' && document.startsWith('...', index)) {
+            tokens.push('...');
+            index += 3;
+            continue;
+        }
+        if (GRAPHQL_PUNCTUATORS.has(character)) {
+            tokens.push(character);
+            index += 1;
+            continue;
+        }
+        if (/[_A-Za-z0-9.+-]/.test(character)) {
+            let end = index + 1;
+            while (end < document.length && /[_A-Za-z0-9.+-]/.test(document[end]))
+                end += 1;
+            tokens.push(document.slice(index, end));
+            index = end;
+            continue;
+        }
+        // White space, commas (insignificant in GraphQL) and the byte order mark.
+        index += 1;
+    }
+    return tokens;
+}
+/**
+ * The executable definitions of a GraphQL document (#3392): each operation's type, name and declared variables. A
+ * fragment is skipped; a type-system definition (`type`, `schema`, …) is a defect, since a document sent to a server is
+ * executable only.
+ */
+export function readProviderGraphqlDocument(document) {
+    const tokens = tokenizeGraphqlDocument(document);
+    if (tokens === undefined)
+        return { operations: [], defect: 'a string in it never closes' };
+    const operations = [];
+    let index = 0;
+    /** Skips the balanced block opening at `index` (a `{` or a `(`), and answers the index after it, or -1. */
+    const skipBalanced = (open, close) => {
+        let depth = 0;
+        for (let position = index; position < tokens.length; position += 1) {
+            if (tokens[position] === open)
+                depth += 1;
+            else if (tokens[position] === close) {
+                depth -= 1;
+                if (depth === 0)
+                    return position + 1;
+            }
+        }
+        return -1;
+    };
+    while (index < tokens.length) {
+        const token = tokens[index];
+        if (token === '{') {
+            const after = skipBalanced('{', '}');
+            if (after === -1)
+                return { operations, defect: 'a selection set never closes' };
+            operations.push({ type: 'query', variables: [] });
+            index = after;
+            continue;
+        }
+        if (token === 'query' || token === 'mutation' || token === 'subscription') {
+            index += 1;
+            const name = tokens[index] !== undefined && GRAPHQL_NAME.test(tokens[index]) ? tokens[index] : undefined;
+            if (name !== undefined)
+                index += 1;
+            const variables = [];
+            if (tokens[index] === '(') {
+                const after = skipBalanced('(', ')');
+                if (after === -1)
+                    return { operations, defect: `the variable definitions of ${name ?? 'an operation'} never close` };
+                // A definition is `$name :`; a default value is constant and holds no variable.
+                for (let position = index; position < after - 2; position += 1) {
+                    if (tokens[position] === '$' && tokens[position + 2] === ':' && GRAPHQL_NAME.test(tokens[position + 1]))
+                        variables.push(tokens[position + 1]);
+                }
+                index = after;
+            }
+            while (index < tokens.length && tokens[index] !== '{')
+                index += 1;
+            if (index >= tokens.length)
+                return { operations, defect: `${name ?? 'an operation'} has no selection set` };
+            const after = skipBalanced('{', '}');
+            if (after === -1)
+                return { operations, defect: `the selection set of ${name ?? 'an operation'} never closes` };
+            operations.push({ type: token, ...(name === undefined ? {} : { name }), variables });
+            index = after;
+            continue;
+        }
+        if (token === 'fragment') {
+            while (index < tokens.length && tokens[index] !== '{')
+                index += 1;
+            if (index >= tokens.length)
+                return { operations, defect: 'a fragment has no selection set' };
+            const after = skipBalanced('{', '}');
+            if (after === -1)
+                return { operations, defect: 'a fragment\'s selection set never closes' };
+            index = after;
+            continue;
+        }
+        return { operations, defect: `'${token}' begins no executable definition (an operation or a fragment)` };
+    }
+    return { operations };
+}
+/**
+ * The top-level fields an input schema declares, read through Zod's own definition (`_zod.def`) as the input-options
+ * check reads it, so a module built against another copy of Zod is read the same. Wrappers that keep the value's shape
+ * are seen through; a union declares what any of its options declares. `undefined` when the schema is not an object
+ * (or a union of objects), so its fields cannot be listed.
+ */
+function inputSchemaTopLevelFields(schema) {
+    let current = schema;
+    for (let depth = 0; depth < 64; depth += 1) {
+        const def = current?._zod?.def;
+        if (def === undefined)
+            return undefined;
+        switch (def.type) {
+            case 'optional':
+            case 'nullable':
+            case 'default':
+            case 'prefault':
+            case 'readonly':
+            case 'catch':
+            case 'nonoptional':
+                current = def.innerType;
+                continue;
+            case 'pipe':
+                current = def.in;
+                continue;
+            case 'lazy':
+                current = typeof def.getter === 'function' ? def.getter() : undefined;
+                continue;
+            case 'object':
+                return new Set(Object.keys(def.shape ?? {}));
+            case 'union': {
+                const fields = new Set();
+                for (const option of Array.isArray(def.options) ? def.options : []) {
+                    const optionFields = inputSchemaTopLevelFields(option);
+                    if (optionFields === undefined)
+                        return undefined;
+                    for (const field of optionFields)
+                        fields.add(field);
+                }
+                return fields;
+            }
+            default:
+                return undefined;
+        }
+    }
+    return undefined;
+}
+/**
+ * Why a GraphQL operation cannot be sent as declared, or an empty list (#3392). Empty for an operation without
+ * `graphql`. Checked where a catalogue loads (the operation executor, an augmentation merge), at `wildo registry publish`,
+ * and by the request compiler on every call, so the one rule refuses in every place:
+ *
+ * - the call is a POST with no `requestBody`, every parameter carries a `constantValue` (the input is the variables
+ *   and nothing else), and the answer is read as JSON;
+ * - the document reads as exactly ONE operation, named `operationName`, beside any fragments;
+ * - a `query` is classified READ and a `mutation` WRITE; a `subscription` is refused;
+ * - each declared variable is a top-level field of `inputSchema`, and each top-level field is a declared variable, so no
+ *   value a caller supplies is silently dropped (when `inputSchema` lists its fields; without one, the call refuses a
+ *   value for a variable the document does not declare);
+ * - `errorCodePath` is a dot path;
+ * - each of `credentialRefusedErrorCodes` is code-shaped (a value of any other shape is never kept, so it could never
+ *   match), and the list comes with an `errorCodePath` to read the code at;
+ * - a `payloadRefusal` belongs to a mutation, names a kind of its vocabulary, and reads every path as a dot path.
+ */
+export function describeProviderRestOperationGraphqlDefects(operation) {
+    const graphql = operation.graphql;
+    if (graphql === undefined)
+        return [];
+    const at = `GraphQL operation '${operation.operationId}'`;
+    const defects = [];
+    if (operation.method !== API_HttpMethod.POST)
+        defects.push(`${at} is sent with ${operation.method}; a GraphQL call is a POST`);
+    if (operation.requestBody !== undefined)
+        defects.push(`${at} declares a requestBody; its body is the document and its variables`);
+    for (const parameter of operation.parameters ?? []) {
+        if (parameter.constantValue === undefined) {
+            defects.push(`${at} declares the ${parameter.in} parameter '${parameter.name}' fed by the input; its input is the document's variables only, so a parameter must carry a constantValue`);
+        }
+    }
+    if (operation.responseDecoding !== undefined && operation.responseDecoding !== ProviderRestResponseDecoding.JSON)
+        defects.push(`${at} reads its answer as ${operation.responseDecoding}; a GraphQL answer is JSON`);
+    if (operation.binaryResponse !== undefined)
+        defects.push(`${at} declares binaryResponse; a GraphQL answer is JSON`);
+    if (!GRAPHQL_NAME.test(graphql.operationName))
+        defects.push(`${at} names the operation '${graphql.operationName}', which is not a GraphQL name`);
+    if (graphql.errorCodePath !== undefined && graphql.errorCodePath.split('.').some((segment) => segment.length === 0)) {
+        defects.push(`${at} reads its error code at '${graphql.errorCodePath}', which is not a dot path`);
+    }
+    const payloadRefusal = graphql.payloadRefusal;
+    if (payloadRefusal !== undefined) {
+        const kinds = Object.values(ProviderGraphqlPayloadRefusalKind);
+        if (!kinds.includes(payloadRefusal.kind))
+            defects.push(`${at} declares the payload refusal kind ${JSON.stringify(payloadRefusal.kind)}, which is none of ${kinds.join(', ')}`);
+        const paths = [['path', payloadRefusal.path]];
+        if (payloadRefusal.kind === ProviderGraphqlPayloadRefusalKind.USER_ERRORS) {
+            paths.push(['messagePath', payloadRefusal.messagePath], ['fieldPath', payloadRefusal.fieldPath], ['codePath', payloadRefusal.codePath]);
+        }
+        for (const [field, value] of paths) {
+            if (value === undefined && field !== 'path')
+                continue;
+            if (typeof value !== 'string' || value.length === 0 || value.split('.').some((segment) => segment.length === 0)) {
+                defects.push(`${at} reads its payload refusal's ${field} at ${JSON.stringify(value)}, which is not a dot path`);
+            }
+        }
+    }
+    if (graphql.credentialRefusedErrorCodes !== undefined && graphql.errorCodePath === undefined) {
+        defects.push(`${at} lists credentialRefusedErrorCodes but no errorCodePath, so no code is read and none of them could ever match`);
+    }
+    for (const code of graphql.credentialRefusedErrorCodes ?? []) {
+        if (!PROVIDER_VENDOR_ERROR_CODE_SHAPE.test(code)) {
+            defects.push(`${at} lists the credential-refusal code '${code}', which is not code-shaped and would never match a code the transport keeps`);
+        }
+    }
+    const shape = readProviderGraphqlDocument(graphql.document);
+    if (shape.defect !== undefined) {
+        defects.push(`${at}: its document does not read as a GraphQL document (${shape.defect})`);
+        return defects;
+    }
+    const named = shape.operations.filter((candidate) => candidate.name === graphql.operationName);
+    if (named.length !== 1 || shape.operations.length !== 1) {
+        defects.push(`${at}: its document must define exactly one operation, named '${graphql.operationName}', and it defines `
+            + `${shape.operations.length === 0 ? 'none' : shape.operations.map((candidate) => `${candidate.type} ${candidate.name ?? '(anonymous)'}`).join(', ')}`);
+        return defects;
+    }
+    const [definition] = named;
+    const expected = definition.type === ProviderGraphqlOperationType.QUERY ? ExternalOperation_Classification.READ
+        : definition.type === ProviderGraphqlOperationType.MUTATION ? ExternalOperation_Classification.WRITE
+            : undefined;
+    if (expected === undefined)
+        defects.push(`${at} is a ${definition.type}, which is not answered over a single POST`);
+    // A refusal stated in a payload is a WRITE's: a query that answers data refused nothing.
+    if (graphql.payloadRefusal !== undefined && definition.type !== ProviderGraphqlOperationType.MUTATION) {
+        defects.push(`${at} is a ${definition.type} and declares a payload refusal, which only a mutation's payload states`);
+    }
+    else if (operation.classification !== expected)
+        defects.push(`${at} is a ${definition.type} classified ${operation.classification}; a query is a READ and a mutation a WRITE`);
+    const fields = operation.inputSchema === undefined ? undefined : inputSchemaTopLevelFields(operation.inputSchema);
+    if (operation.inputSchema !== undefined && fields === undefined) {
+        defects.push(`${at} has an inputSchema that is not an object, and its input is the document's variables`);
+    }
+    if (fields !== undefined) {
+        for (const variable of definition.variables) {
+            if (!fields.has(variable))
+                defects.push(`${at} declares the variable '$${variable}', which its inputSchema does not declare`);
+        }
+        for (const field of fields) {
+            if (!definition.variables.includes(field))
+                defects.push(`${at}: its inputSchema declares '${field}', which is no variable of the document, so a value for it would never be sent`);
+        }
+    }
+    return defects;
+}
+/** The variables a GraphQL operation's document declares, or `undefined` when the document cannot be read. */
+export function providerGraphqlOperationVariables(graphql) {
+    const shape = readProviderGraphqlDocument(graphql.document);
+    if (shape.defect !== undefined)
+        return undefined;
+    return shape.operations.find((candidate) => candidate.name === graphql.operationName)?.variables;
+}
+/** What a GraphQL answer says about the call. See the table in this module's header. */
+export var ProviderGraphqlResponseOutcomeKind;
+(function (ProviderGraphqlResponseOutcomeKind) {
+    /** `data` is an object and no error was reported. */
+    ProviderGraphqlResponseOutcomeKind["SUCCEEDED"] = "succeeded";
+    /** Errors, and no `data` entry: the request was refused before anything executed. Nothing was applied. */
+    ProviderGraphqlResponseOutcomeKind["REQUEST_ERROR"] = "request_error";
+    /** Errors beside a `data` entry (null or partial): execution began and something failed. */
+    ProviderGraphqlResponseOutcomeKind["EXECUTION_ERROR"] = "execution_error";
+    /** Neither a `data` object nor an error list: the answer does not state what happened. */
+    ProviderGraphqlResponseOutcomeKind["UNSTATED"] = "unstated";
+    /**
+     * `data` and no `errors`, and the mutation's payload states the vendor refused it (its declared `payloadRefusal`): the
+     * write was not done, as the vendor says (follow-up to #3392).
+     */
+    ProviderGraphqlResponseOutcomeKind["PAYLOAD_REFUSED"] = "payload_refused";
+})(ProviderGraphqlResponseOutcomeKind || (ProviderGraphqlResponseOutcomeKind = {}));
+/** The value at a dot path, read through own properties only (an array's index is an own property), or `undefined`. */
+function readGraphqlDotPath(value, path) {
+    let current = value;
+    for (const segment of path.split('.')) {
+        if (current === null || typeof current !== 'object' || !Object.hasOwn(current, segment))
+            return undefined;
+        current = current[segment];
+    }
+    return current;
+}
+function readGraphqlErrorCode(error, errorCodePath) {
+    const current = readGraphqlDotPath(error, errorCodePath);
+    return typeof current === 'string' && PROVIDER_VENDOR_ERROR_CODE_SHAPE.test(current) ? current : undefined;
+}
+/** A vendor message as the verdict keeps it: cut at {@link PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH}. */
+function keptGraphqlMessage(message) {
+    return message.length > PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH ? `${message.slice(0, PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH)}…` : message;
+}
+/**
+ * The refusal a mutation's payload states, read as its declaration says ({@link ProviderGraphqlPayloadRefusal}), or
+ * `undefined` when the payload refuses nothing.
+ */
+function readGraphqlPayloadRefusal(data, refusal) {
+    const stated = readGraphqlDotPath(data, refusal.path);
+    if (refusal.kind === ProviderGraphqlPayloadRefusalKind.SUCCESS_FLAG) {
+        return stated === false ? { errorMessages: [`the answer's ${refusal.path} is false: the vendor did not do the write`] } : undefined;
+    }
+    if (!Array.isArray(stated) || stated.length === 0)
+        return undefined;
+    const errorMessages = stated.slice(0, PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES).map((entry) => {
+        const message = readGraphqlDotPath(entry, refusal.messagePath ?? 'message');
+        const field = refusal.fieldPath === undefined ? undefined : readGraphqlDotPath(entry, refusal.fieldPath);
+        const fieldText = typeof field === 'string' ? field
+            : Array.isArray(field) && field.every((segment) => typeof segment === 'string' || typeof segment === 'number') ? field.join('.') : undefined;
+        const text = typeof message === 'string' ? message : 'the vendor refused the write without a message';
+        return keptGraphqlMessage(fieldText === undefined || fieldText.length === 0 ? text : `${fieldText}: ${text}`);
+    });
+    const errorCode = refusal.codePath === undefined ? undefined
+        : stated.map((entry) => readGraphqlErrorCode(entry, refusal.codePath)).find((code) => code !== undefined);
+    return { errorMessages, ...(errorCode === undefined ? {} : { errorCode }) };
+}
+/**
+ * Reads a parsed GraphQL answer (#3392). The ONE reader: the engine's transport, for a 2xx and a non-2xx answer alike,
+ * and every test go through it. See the module header for the rule and its sources.
+ */
+export function readProviderGraphqlResponse(body, errorCodePath, payloadRefusal) {
+    if (body === null || typeof body !== 'object' || Array.isArray(body))
+        return { kind: ProviderGraphqlResponseOutcomeKind.UNSTATED };
+    const answer = body;
+    const errors = Object.hasOwn(answer, 'errors') ? answer.errors : undefined;
+    if (errors !== undefined && errors !== null && !Array.isArray(errors))
+        return { kind: ProviderGraphqlResponseOutcomeKind.UNSTATED };
+    if (Array.isArray(errors) && errors.length > 0) {
+        const errorMessages = errors
+            .map((error) => (error !== null && typeof error === 'object' && typeof error.message === 'string' ? error.message : undefined))
+            .filter((message) => message !== undefined)
+            .slice(0, PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES)
+            .map(keptGraphqlMessage);
+        const errorCode = errorCodePath === undefined ? undefined
+            : errors.map((error) => readGraphqlErrorCode(error, errorCodePath)).find((code) => code !== undefined);
+        return {
+            kind: Object.hasOwn(answer, 'data') ? ProviderGraphqlResponseOutcomeKind.EXECUTION_ERROR : ProviderGraphqlResponseOutcomeKind.REQUEST_ERROR,
+            errorMessages,
+            ...(errorCode === undefined ? {} : { errorCode }),
+        };
+    }
+    const data = Object.hasOwn(answer, 'data') ? answer.data : undefined;
+    if (data === null || typeof data !== 'object' || Array.isArray(data))
+        return { kind: ProviderGraphqlResponseOutcomeKind.UNSTATED };
+    const refused = payloadRefusal === undefined ? undefined : readGraphqlPayloadRefusal(data, payloadRefusal);
+    if (refused !== undefined)
+        return { kind: ProviderGraphqlResponseOutcomeKind.PAYLOAD_REFUSED, ...refused };
+    return { kind: ProviderGraphqlResponseOutcomeKind.SUCCEEDED, data: data };
+}
+/** @wildo_source:part:end external-connectors.models.rest-operation-contract */
+//# sourceMappingURL=graphql-operations.external-connectors-models.schemas.js.map

package/dist/esm/protocols/graphql-operations.external-connectors-models.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-operations.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../src/protocols/graphql-operations.external-connectors-models.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * GRAPHQL provider operations (#3392): an operation whose provider-owned part is a GraphQL document, and whose input is\n * the document's VARIABLES.\n *\n * A REST operation is a method, a path and a body built from the caller's input. A GraphQL vendor (GitHub v4, Linear,\n * Shopify Admin, monday.com) exposes ONE endpoint and tells operations apart by the query document sent to it. Written\n * as a REST operation, the document had to be an input, which handed the caller the vendor's whole schema and made every\n * operation the same operation. Here the PROVIDER owns the document (`graphql.document`, with its `operationName`), and\n * the caller supplies only values for the variables that document declares.\n *\n * ## The wire, settled by the GraphQL-over-HTTP specification\n *\n * The request is a POST whose JSON body holds `query` (the document), `operationName` and `variables`. The client\n * accepts `application/graphql-response+json` first and `application/json` after it, because the vendor's support for\n * the newer media type is unknown.\n * spec-cite: GraphQL over HTTP, Current Working Draft (https://graphql.github.io/graphql-over-http/draft/, fetched\n * 2026-11-09) — §4.1 lists the request parameters `query` (required), `operationName`, `variables` and `extensions`;\n * §4.4 \"A server MUST support POST requests with a body encoded as UTF-8 JSON, using the `application/json` media type\";\n * §4.2 \"the client SHOULD set the Accept header to application/graphql-response+json, application/json;q=0.9\".\n *\n * ## The answer: errors arrive IN BAND, on a 2xx\n *\n * A GraphQL server reports most failures inside a successful HTTP answer, in an `errors` list beside (or instead of)\n * `data`. Read as REST, such an answer is a success, so a refused call would be returned to its caller as a result. The\n * rule here, which {@link readProviderGraphqlResponse} applies and the engine's transport enforces on every GraphQL call:\n *\n * | the answer | verdict |\n * |---|---|\n * | `data` is an object, no `errors` (or an empty list) | SUCCEEDED; the output is read from `data` |\n * | `errors`, and no `data` entry | REQUEST_ERROR: the server refused before executing anything |\n * | `errors`, and a `data` entry (null or partial) | EXECUTION_ERROR: execution began and a field failed |\n * | neither a `data` object nor `errors` | UNSTATED: the answer does not say what happened |\n * | `data`, no `errors`, and the mutation's declared `payloadRefusal` says refused | PAYLOAD_REFUSED: the vendor did not do the write |\n *\n * spec-cite: GraphQL, September 2025 edition (https://spec.graphql.org/September2025/, fetched 2026-11-09) — §7.1.1\n * \"If execution raised any errors, the execution result must contain an entry with key \"errors\"\" and \"The value of this\n * entry must be a non-empty list\"; §7.1.3 \"The request error result map must not contain an entry with key \"data\"\"; §7.1.5\n * \"If an error was raised during the execution that prevented a valid response, the \"data\" entry in the response should\n * be null\"; §6.3.4 (mutation) \"the selections in the top most selection set will be executed in serial order\".\n * spec-cite: https://docs.github.com/en/graphql/overview/rate-limits-and-query-limits-for-the-graphql-api — for the\n * primary rate limit \"the response status will still be `200`\", fetched 2026-11-09: a 200 is not a success.\n *\n * PARTIAL DATA IS NEVER RETURNED AS A RESULT. Any error fails the call, whatever `data` holds, because a caller handed a\n * partial object cannot tell a field the vendor left null from a field that failed. For a MUTATION whose execution began,\n * the failure says the outcome is UNKNOWN: the root fields run in order and an error in one does not undo the ones\n * before it, so whether the change landed is not stated. A request error (no `data`) applied nothing, mutation or not.\n *\n * ## What is not checked here\n *\n * The document is checked for its SHAPE (it parses into exactly one operation of the declared name and type, and its\n * variables are the input's fields). It is not validated against the vendor's schema here: publish does that, against\n * the schema the module pins as `provider.graphqlSchema` (#3392, the counterpart of the OpenAPI conformance check of\n * #2028). The OpenAPI conformance check skips a GraphQL operation, since an OpenAPI description does not describe a\n * GraphQL endpoint.\n */\n\nimport { ExternalOperation_Classification } from '../core/operation-classification.external-connectors-models.schemas';\nimport { API_HttpMethod } from '../core/commons.external-connectors-models.schemas';\n\nimport { PROVIDER_VENDOR_ERROR_CODE_SHAPE, ProviderRestResponseDecoding, type ProviderRestOperation } from './rest-operations.external-connectors-models.schemas';\n\n/** @wildo_source:part:start external-connectors.models.rest-operation-contract facet:layer:shared facet:family:provider facet:audience:app-developer */\n/**\n * The GraphQL document a provider operation sends (#3392), set as `ProviderRestOperation.graphql`.\n *\n * With it the operation is a GraphQL call: `method` must be `POST`, `pathTemplate` is the vendor's GraphQL endpoint\n * (`/graphql`), and the operation's input IS the variables. So it may declare no `requestBody`, and no parameter fed by\n * the input (a `constantValue` header or path parameter, such as a pinned API version, is allowed). `inputSchema`\n * describes the variables, one top-level field per variable the document declares, and `inputOptions` work on them as on\n * any input. `resultPath` and `outputSchema` read the answer's `data`, never the `{ data, errors }` envelope around it.\n * `responseDecoding` stays JSON.\n *\n * Checked when the catalogue loads, at publish and on every call ({@link describeProviderRestOperationGraphqlDefects}).\n *\n * @example\n * // GitHub: a repository's discussions, which GitHub serves through GraphQL only.\n * {\n *   operationId: 'github_issues_list_discussions', domain: 'default', method: API_HttpMethod.POST, pathTemplate: '/graphql',\n *   classification: ExternalOperation_Classification.READ,\n *   graphql: {\n *     operationName: 'ListDiscussions',\n *     document: 'query ListDiscussions($owner: String!, $repo: String!, $first: Int!) { repository(owner: $owner, name: $repo) { discussions(first: $first) { nodes { number title } } } }',\n *   },\n *   inputSchema: z.strictObject({ owner: z.string(), repo: z.string(), first: z.number().int() }),\n *   resultPath: 'repository.discussions',\n * }\n */\nexport interface ProviderRestOperationGraphql {\n  /**\n   * The executable document, owned by the provider: exactly ONE operation (a `query` or a `mutation`, named\n   * {@link operationName}) and any fragments it uses. A `query` is a READ operation and a `mutation` a WRITE; a\n   * `subscription` is refused, since it is not answered over a single POST.\n   */\n  readonly document: string;\n  /** The operation's name in {@link document}, sent as `operationName`. */\n  readonly operationName: string;\n  /**\n   * Dot path, inside EACH error of the answer's `errors` list, to the vendor's machine-readable code (`extensions.code`\n   * by convention, where a vendor uses it). The specification standardizes no code, so absent, no code is read and the\n   * failure carries the vendor's messages only. A code is kept only when it is code-shaped, as every vendor code is.\n   */\n  readonly errorCodePath?: string;\n  /**\n   * The codes, read at {@link errorCodePath}, that mean the vendor refused the CREDENTIAL itself rather than the request\n   * (#3392): the stored credential is then recorded as rejected, as a REST vendor's\n   * `applicationOutcome.credentialRefusedErrorCodes` records it. A GraphQL vendor may name a dead or expired token inside\n   * a 200 (an error list beside or instead of `data`) or inside a 4xx carrying the same error list, and both are read.\n   * The failure itself is unchanged: the call fails with the vendor's code and is never retried.\n   *\n   * List only a code the vendor DOCUMENTS as a refused credential. A code for a resource the credential may not reach\n   * (`FORBIDDEN` on one repository), for a missing scope, or for a request sent with no credential at all, does not\n   * belong here: the credential still works, and recording it rejected would show a working connection as broken.\n   * Requires {@link errorCodePath}, without which no code is read and none could match.\n   *\n   * @example\n   * // monday.com answers a key it refuses with the error code `Unauthorized`, whose documented resolution is a valid key.\n   * // spec-cite: https://developer.monday.com/api-reference/docs/errors — the `Unauthorized` row (HTTP 401, resolution\n   * // \"Input a valid API key.\"), fetched 2026-11-09.\n   * graphql: { operationName: 'CreateItem', document: CREATE_ITEM, errorCodePath: 'extensions.code', credentialRefusedErrorCodes: ['Unauthorized'] }\n   */\n  readonly credentialRefusedErrorCodes?: readonly string[];\n  /**\n   * Where a MUTATION's answer says the vendor refused it in the DATA rather than in `errors` (follow-up to #3392). Several\n   * GraphQL vendors answer a write they refused with a successful response whose payload carries the refusal: Shopify's\n   * `userErrors` list (\"validation failures, such as invalid field values or business logic violations, that prevent the\n   * operation from completing\"), Linear's `success: Boolean!`. Without it such an answer is returned as the result and a\n   * caller that does not read the payload takes a refused write for a done one; with it the call FAILS, carrying the\n   * vendor's messages, exactly as an `errors` entry does. See {@link ProviderGraphqlPayloadRefusal}.\n   * spec-cite: https://shopify.dev/docs/api/admin-graphql — the `UserError` description quoted above, fetched 2026-11-10.\n   *\n   * @example\n   * // Shopify: productCreate's userErrors, each `{ field, message }`.\n   * payloadRefusal: { kind: ProviderGraphqlPayloadRefusalKind.USER_ERRORS, path: 'productCreate.userErrors', messagePath: 'message', fieldPath: 'field' }\n   */\n  readonly payloadRefusal?: ProviderGraphqlPayloadRefusal;\n}\n\n/** How a mutation's payload states a refusal. See {@link ProviderRestOperationGraphql.payloadRefusal}. */\nexport enum ProviderGraphqlPayloadRefusalKind {\n  /** A list of the vendor's refusals (Shopify's `userErrors`): the write was refused when the list is not empty. */\n  USER_ERRORS = 'user_errors',\n  /** A boolean the vendor sets to `false` when it did not do the write (Linear's `success`). */\n  SUCCESS_FLAG = 'success_flag',\n}\n\n/**\n * Where a mutation's payload states a refusal (follow-up to #3392). Every path is a dot path, `path` from the answer's\n * `data` (as `resultPath` is), `messagePath`, `fieldPath` and `codePath` from inside each listed refusal.\n *\n * - {@link ProviderGraphqlPayloadRefusalKind.USER_ERRORS}: a non-empty list at `path` fails the call. Each entry's text at\n *   `messagePath` (`message` when absent) is kept, prefixed with the input field it names at `fieldPath` (a string or a\n *   list of path segments), and the first code-shaped value at `codePath` is the failure's code.\n * - {@link ProviderGraphqlPayloadRefusalKind.SUCCESS_FLAG}: `false` at `path` fails the call.\n *\n * Anything else at `path` (an absent payload, `true`, an empty list) refuses nothing: the answer is read as it is.\n */\nexport type ProviderGraphqlPayloadRefusal =\n  | {\n      readonly kind: ProviderGraphqlPayloadRefusalKind.USER_ERRORS;\n      readonly path: string;\n      readonly messagePath?: string;\n      readonly fieldPath?: string;\n      readonly codePath?: string;\n    }\n  | { readonly kind: ProviderGraphqlPayloadRefusalKind.SUCCESS_FLAG; readonly path: string };\n\n/** What a GraphQL document's operation does. A `subscription` is not served over a single POST, so it is no member. */\nexport enum ProviderGraphqlOperationType {\n  /** Reads. The operation must be classified READ. */\n  QUERY = 'query',\n  /** Changes the vendor. The operation must be classified WRITE. */\n  MUTATION = 'mutation',\n}\n\n/**\n * The `Accept` a GraphQL call sends: the GraphQL response media type first, `application/json` for a server that predates\n * it (GraphQL over HTTP §4.2, quoted in this module's header).\n * semantic-literal-boundary: the media types GraphQL over HTTP names, sent on the wire.\n */\nexport const PROVIDER_GRAPHQL_ACCEPT_HEADER = 'application/graphql-response+json, application/json;q=0.9';\n\n/** At most this many of the vendor's error messages are kept on a failure. */\nexport const PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES = 10;\n/** A kept error message is cut at this many characters. */\nexport const PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH = 500;\n\n/** One operation a document defines, as {@link readProviderGraphqlDocument} reads it. */\nexport interface ProviderGraphqlDocumentOperation {\n  /** `query`, `mutation` or `subscription`, as written (an anonymous `{ … }` is a query). */\n  readonly type: string;\n  /** Absent for an anonymous operation. */\n  readonly name?: string;\n  /** The variables it declares, without their `$`, in order. */\n  readonly variables: readonly string[];\n}\n\n/** What a document holds, or why it cannot be read. */\nexport interface ProviderGraphqlDocumentShape {\n  readonly operations: readonly ProviderGraphqlDocumentOperation[];\n  /** Set when the text is not a document of executable definitions. `operations` is then what was read before it. */\n  readonly defect?: string;\n}\n\nconst GRAPHQL_NAME = /^[_A-Za-z][_0-9A-Za-z]*$/;\nconst GRAPHQL_PUNCTUATORS = new Set(['!', '$', '&', '(', ')', ':', '=', '@', '[', ']', '{', '|', '}']);\n\n/**\n * The tokens of a GraphQL document, with strings and comments dropped: enough to find its definitions and their\n * variables. Not a validating parser: the vendor's server is the parser that decides, and this only has to see the\n * document's outline. A block string (`\"\"\"…\"\"\"`) and a string (`\"…\"`, with `\\` escapes) are skipped whole, so a brace or\n * a `$` inside one is never read as structure. `undefined` for a string that never closes.\n */\nfunction tokenizeGraphqlDocument(document: string): string[] | undefined {\n  const tokens: string[] = [];\n  let index = 0;\n  while (index < document.length) {\n    const character = document[index]!;\n    if (character === '#') {\n      while (index < document.length && document[index] !== '\\n' && document[index] !== '\\r') index += 1;\n      continue;\n    }\n    if (character === '\"') {\n      if (document.startsWith('\"\"\"', index)) {\n        const close = document.indexOf('\"\"\"', index + 3);\n        // A `\\\"\"\"` inside a block string is an escaped delimiter, not its end.\n        let end = close;\n        while (end !== -1 && document[end - 1] === '\\\\') end = document.indexOf('\"\"\"', end + 3);\n        if (end === -1) return undefined;\n        index = end + 3;\n      } else {\n        index += 1;\n        while (index < document.length && document[index] !== '\"') {\n          if (document[index] === '\\n') return undefined;\n          index += document[index] === '\\\\' ? 2 : 1;\n        }\n        if (index >= document.length) return undefined;\n        index += 1;\n      }\n      tokens.push('\"');\n      continue;\n    }\n    if (character === '.' && document.startsWith('...', index)) {\n      tokens.push('...');\n      index += 3;\n      continue;\n    }\n    if (GRAPHQL_PUNCTUATORS.has(character)) {\n      tokens.push(character);\n      index += 1;\n      continue;\n    }\n    if (/[_A-Za-z0-9.+-]/.test(character)) {\n      let end = index + 1;\n      while (end < document.length && /[_A-Za-z0-9.+-]/.test(document[end]!)) end += 1;\n      tokens.push(document.slice(index, end));\n      index = end;\n      continue;\n    }\n    // White space, commas (insignificant in GraphQL) and the byte order mark.\n    index += 1;\n  }\n  return tokens;\n}\n\n/**\n * The executable definitions of a GraphQL document (#3392): each operation's type, name and declared variables. A\n * fragment is skipped; a type-system definition (`type`, `schema`, …) is a defect, since a document sent to a server is\n * executable only.\n */\nexport function readProviderGraphqlDocument(document: string): ProviderGraphqlDocumentShape {\n  const tokens = tokenizeGraphqlDocument(document);\n  if (tokens === undefined) return { operations: [], defect: 'a string in it never closes' };\n  const operations: ProviderGraphqlDocumentOperation[] = [];\n  let index = 0;\n  /** Skips the balanced block opening at `index` (a `{` or a `(`), and answers the index after it, or -1. */\n  const skipBalanced = (open: string, close: string): number => {\n    let depth = 0;\n    for (let position = index; position < tokens.length; position += 1) {\n      if (tokens[position] === open) depth += 1;\n      else if (tokens[position] === close) {\n        depth -= 1;\n        if (depth === 0) return position + 1;\n      }\n    }\n    return -1;\n  };\n  while (index < tokens.length) {\n    const token = tokens[index]!;\n    if (token === '{') {\n      const after = skipBalanced('{', '}');\n      if (after === -1) return { operations, defect: 'a selection set never closes' };\n      operations.push({ type: 'query', variables: [] });\n      index = after;\n      continue;\n    }\n    if (token === 'query' || token === 'mutation' || token === 'subscription') {\n      index += 1;\n      const name = tokens[index] !== undefined && GRAPHQL_NAME.test(tokens[index]!) ? tokens[index] : undefined;\n      if (name !== undefined) index += 1;\n      const variables: string[] = [];\n      if (tokens[index] === '(') {\n        const after = skipBalanced('(', ')');\n        if (after === -1) return { operations, defect: `the variable definitions of ${name ?? 'an operation'} never close` };\n        // A definition is `$name :`; a default value is constant and holds no variable.\n        for (let position = index; position < after - 2; position += 1) {\n          if (tokens[position] === '$' && tokens[position + 2] === ':' && GRAPHQL_NAME.test(tokens[position + 1]!)) variables.push(tokens[position + 1]!);\n        }\n        index = after;\n      }\n      while (index < tokens.length && tokens[index] !== '{') index += 1;\n      if (index >= tokens.length) return { operations, defect: `${name ?? 'an operation'} has no selection set` };\n      const after = skipBalanced('{', '}');\n      if (after === -1) return { operations, defect: `the selection set of ${name ?? 'an operation'} never closes` };\n      operations.push({ type: token, ...(name === undefined ? {} : { name }), variables });\n      index = after;\n      continue;\n    }\n    if (token === 'fragment') {\n      while (index < tokens.length && tokens[index] !== '{') index += 1;\n      if (index >= tokens.length) return { operations, defect: 'a fragment has no selection set' };\n      const after = skipBalanced('{', '}');\n      if (after === -1) return { operations, defect: 'a fragment\\'s selection set never closes' };\n      index = after;\n      continue;\n    }\n    return { operations, defect: `'${token}' begins no executable definition (an operation or a fragment)` };\n  }\n  return { operations };\n}\n\n/**\n * The top-level fields an input schema declares, read through Zod's own definition (`_zod.def`) as the input-options\n * check reads it, so a module built against another copy of Zod is read the same. Wrappers that keep the value's shape\n * are seen through; a union declares what any of its options declares. `undefined` when the schema is not an object\n * (or a union of objects), so its fields cannot be listed.\n */\nfunction inputSchemaTopLevelFields(schema: unknown): Set<string> | undefined {\n  let current: unknown = schema;\n  for (let depth = 0; depth < 64; depth += 1) {\n    const def = (current as { _zod?: { def?: Record<string, unknown> } } | undefined)?._zod?.def;\n    if (def === undefined) return undefined;\n    switch (def.type) {\n      case 'optional': case 'nullable': case 'default': case 'prefault': case 'readonly': case 'catch': case 'nonoptional':\n        current = def.innerType;\n        continue;\n      case 'pipe':\n        current = def.in;\n        continue;\n      case 'lazy':\n        current = typeof def.getter === 'function' ? (def.getter as () => unknown)() : undefined;\n        continue;\n      case 'object':\n        return new Set(Object.keys((def.shape as Record<string, unknown> | undefined) ?? {}));\n      case 'union': {\n        const fields = new Set<string>();\n        for (const option of Array.isArray(def.options) ? def.options : []) {\n          const optionFields = inputSchemaTopLevelFields(option);\n          if (optionFields === undefined) return undefined;\n          for (const field of optionFields) fields.add(field);\n        }\n        return fields;\n      }\n      default:\n        return undefined;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Why a GraphQL operation cannot be sent as declared, or an empty list (#3392). Empty for an operation without\n * `graphql`. Checked where a catalogue loads (the operation executor, an augmentation merge), at `wildo registry publish`,\n * and by the request compiler on every call, so the one rule refuses in every place:\n *\n * - the call is a POST with no `requestBody`, every parameter carries a `constantValue` (the input is the variables\n *   and nothing else), and the answer is read as JSON;\n * - the document reads as exactly ONE operation, named `operationName`, beside any fragments;\n * - a `query` is classified READ and a `mutation` WRITE; a `subscription` is refused;\n * - each declared variable is a top-level field of `inputSchema`, and each top-level field is a declared variable, so no\n *   value a caller supplies is silently dropped (when `inputSchema` lists its fields; without one, the call refuses a\n *   value for a variable the document does not declare);\n * - `errorCodePath` is a dot path;\n * - each of `credentialRefusedErrorCodes` is code-shaped (a value of any other shape is never kept, so it could never\n *   match), and the list comes with an `errorCodePath` to read the code at;\n * - a `payloadRefusal` belongs to a mutation, names a kind of its vocabulary, and reads every path as a dot path.\n */\nexport function describeProviderRestOperationGraphqlDefects(\n  operation: Pick<\n    ProviderRestOperation,\n    'operationId' | 'method' | 'classification' | 'parameters' | 'requestBody' | 'responseDecoding' | 'binaryResponse' | 'inputSchema' | 'graphql'\n  >,\n): string[] {\n  const graphql = operation.graphql;\n  if (graphql === undefined) return [];\n  const at = `GraphQL operation '${operation.operationId}'`;\n  const defects: string[] = [];\n  if (operation.method !== API_HttpMethod.POST) defects.push(`${at} is sent with ${operation.method}; a GraphQL call is a POST`);\n  if (operation.requestBody !== undefined) defects.push(`${at} declares a requestBody; its body is the document and its variables`);\n  for (const parameter of operation.parameters ?? []) {\n    if (parameter.constantValue === undefined) {\n      defects.push(`${at} declares the ${parameter.in} parameter '${parameter.name}' fed by the input; its input is the document's variables only, so a parameter must carry a constantValue`);\n    }\n  }\n  if (operation.responseDecoding !== undefined && operation.responseDecoding !== ProviderRestResponseDecoding.JSON) defects.push(`${at} reads its answer as ${operation.responseDecoding}; a GraphQL answer is JSON`);\n  if (operation.binaryResponse !== undefined) defects.push(`${at} declares binaryResponse; a GraphQL answer is JSON`);\n  if (!GRAPHQL_NAME.test(graphql.operationName)) defects.push(`${at} names the operation '${graphql.operationName}', which is not a GraphQL name`);\n  if (graphql.errorCodePath !== undefined && graphql.errorCodePath.split('.').some((segment) => segment.length === 0)) {\n    defects.push(`${at} reads its error code at '${graphql.errorCodePath}', which is not a dot path`);\n  }\n  const payloadRefusal = graphql.payloadRefusal;\n  if (payloadRefusal !== undefined) {\n    const kinds: readonly string[] = Object.values(ProviderGraphqlPayloadRefusalKind);\n    if (!kinds.includes(payloadRefusal.kind)) defects.push(`${at} declares the payload refusal kind ${JSON.stringify(payloadRefusal.kind)}, which is none of ${kinds.join(', ')}`);\n    const paths: [string, string | undefined][] = [['path', payloadRefusal.path]];\n    if (payloadRefusal.kind === ProviderGraphqlPayloadRefusalKind.USER_ERRORS) {\n      paths.push(['messagePath', payloadRefusal.messagePath], ['fieldPath', payloadRefusal.fieldPath], ['codePath', payloadRefusal.codePath]);\n    }\n    for (const [field, value] of paths) {\n      if (value === undefined && field !== 'path') continue;\n      if (typeof value !== 'string' || value.length === 0 || value.split('.').some((segment) => segment.length === 0)) {\n        defects.push(`${at} reads its payload refusal's ${field} at ${JSON.stringify(value)}, which is not a dot path`);\n      }\n    }\n  }\n  if (graphql.credentialRefusedErrorCodes !== undefined && graphql.errorCodePath === undefined) {\n    defects.push(`${at} lists credentialRefusedErrorCodes but no errorCodePath, so no code is read and none of them could ever match`);\n  }\n  for (const code of graphql.credentialRefusedErrorCodes ?? []) {\n    if (!PROVIDER_VENDOR_ERROR_CODE_SHAPE.test(code)) {\n      defects.push(`${at} lists the credential-refusal code '${code}', which is not code-shaped and would never match a code the transport keeps`);\n    }\n  }\n\n  const shape = readProviderGraphqlDocument(graphql.document);\n  if (shape.defect !== undefined) {\n    defects.push(`${at}: its document does not read as a GraphQL document (${shape.defect})`);\n    return defects;\n  }\n  const named = shape.operations.filter((candidate) => candidate.name === graphql.operationName);\n  if (named.length !== 1 || shape.operations.length !== 1) {\n    defects.push(\n      `${at}: its document must define exactly one operation, named '${graphql.operationName}', and it defines `\n      + `${shape.operations.length === 0 ? 'none' : shape.operations.map((candidate) => `${candidate.type} ${candidate.name ?? '(anonymous)'}`).join(', ')}`,\n    );\n    return defects;\n  }\n  const [definition] = named as [ProviderGraphqlDocumentOperation];\n  const expected = definition.type === ProviderGraphqlOperationType.QUERY ? ExternalOperation_Classification.READ\n    : definition.type === ProviderGraphqlOperationType.MUTATION ? ExternalOperation_Classification.WRITE\n      : undefined;\n  if (expected === undefined) defects.push(`${at} is a ${definition.type}, which is not answered over a single POST`);\n  // A refusal stated in a payload is a WRITE's: a query that answers data refused nothing.\n  if (graphql.payloadRefusal !== undefined && definition.type !== ProviderGraphqlOperationType.MUTATION) {\n    defects.push(`${at} is a ${definition.type} and declares a payload refusal, which only a mutation's payload states`);\n  }\n  else if (operation.classification !== expected) defects.push(`${at} is a ${definition.type} classified ${operation.classification}; a query is a READ and a mutation a WRITE`);\n\n  const fields = operation.inputSchema === undefined ? undefined : inputSchemaTopLevelFields(operation.inputSchema);\n  if (operation.inputSchema !== undefined && fields === undefined) {\n    defects.push(`${at} has an inputSchema that is not an object, and its input is the document's variables`);\n  }\n  if (fields !== undefined) {\n    for (const variable of definition.variables) {\n      if (!fields.has(variable)) defects.push(`${at} declares the variable '$${variable}', which its inputSchema does not declare`);\n    }\n    for (const field of fields) {\n      if (!definition.variables.includes(field)) defects.push(`${at}: its inputSchema declares '${field}', which is no variable of the document, so a value for it would never be sent`);\n    }\n  }\n  return defects;\n}\n\n/** The variables a GraphQL operation's document declares, or `undefined` when the document cannot be read. */\nexport function providerGraphqlOperationVariables(graphql: ProviderRestOperationGraphql): readonly string[] | undefined {\n  const shape = readProviderGraphqlDocument(graphql.document);\n  if (shape.defect !== undefined) return undefined;\n  return shape.operations.find((candidate) => candidate.name === graphql.operationName)?.variables;\n}\n\n/** What a GraphQL answer says about the call. See the table in this module's header. */\nexport enum ProviderGraphqlResponseOutcomeKind {\n  /** `data` is an object and no error was reported. */\n  SUCCEEDED = 'succeeded',\n  /** Errors, and no `data` entry: the request was refused before anything executed. Nothing was applied. */\n  REQUEST_ERROR = 'request_error',\n  /** Errors beside a `data` entry (null or partial): execution began and something failed. */\n  EXECUTION_ERROR = 'execution_error',\n  /** Neither a `data` object nor an error list: the answer does not state what happened. */\n  UNSTATED = 'unstated',\n  /**\n   * `data` and no `errors`, and the mutation's payload states the vendor refused it (its declared `payloadRefusal`): the\n   * write was not done, as the vendor says (follow-up to #3392).\n   */\n  PAYLOAD_REFUSED = 'payload_refused',\n}\n\n/** What {@link readProviderGraphqlResponse} read. */\nexport interface ProviderGraphqlResponseVerdict {\n  readonly kind: ProviderGraphqlResponseOutcomeKind;\n  /** On SUCCEEDED, the answer's `data` object: what the operation's `resultPath` and `outputSchema` read. */\n  readonly data?: Readonly<Record<string, unknown>>;\n  /**\n   * The vendor's error messages, in its order, at most {@link PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES}, each cut at\n   * {@link PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH} characters. Vendor prose: it may quote what the call sent, so it\n   * travels to the caller and is never written to a log or an audit row by the engine.\n   */\n  readonly errorMessages?: readonly string[];\n  /** The first code-shaped value at the operation's `errorCodePath` among the errors, when one is declared and found. */\n  readonly errorCode?: string;\n}\n\n/** The value at a dot path, read through own properties only (an array's index is an own property), or `undefined`. */\nfunction readGraphqlDotPath(value: unknown, path: string): unknown {\n  let current: unknown = value;\n  for (const segment of path.split('.')) {\n    if (current === null || typeof current !== 'object' || !Object.hasOwn(current, segment)) return undefined;\n    current = (current as Record<string, unknown>)[segment];\n  }\n  return current;\n}\n\nfunction readGraphqlErrorCode(error: unknown, errorCodePath: string): string | undefined {\n  const current = readGraphqlDotPath(error, errorCodePath);\n  return typeof current === 'string' && PROVIDER_VENDOR_ERROR_CODE_SHAPE.test(current) ? current : undefined;\n}\n\n/** A vendor message as the verdict keeps it: cut at {@link PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH}. */\nfunction keptGraphqlMessage(message: string): string {\n  return message.length > PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH ? `${message.slice(0, PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGE_LENGTH)}…` : message;\n}\n\n/**\n * The refusal a mutation's payload states, read as its declaration says ({@link ProviderGraphqlPayloadRefusal}), or\n * `undefined` when the payload refuses nothing.\n */\nfunction readGraphqlPayloadRefusal(\n  data: Readonly<Record<string, unknown>>,\n  refusal: ProviderGraphqlPayloadRefusal,\n): Pick<ProviderGraphqlResponseVerdict, 'errorMessages' | 'errorCode'> | undefined {\n  const stated = readGraphqlDotPath(data, refusal.path);\n  if (refusal.kind === ProviderGraphqlPayloadRefusalKind.SUCCESS_FLAG) {\n    return stated === false ? { errorMessages: [`the answer's ${refusal.path} is false: the vendor did not do the write`] } : undefined;\n  }\n  if (!Array.isArray(stated) || stated.length === 0) return undefined;\n  const errorMessages = stated.slice(0, PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES).map((entry) => {\n    const message = readGraphqlDotPath(entry, refusal.messagePath ?? 'message');\n    const field = refusal.fieldPath === undefined ? undefined : readGraphqlDotPath(entry, refusal.fieldPath);\n    const fieldText = typeof field === 'string' ? field\n      : Array.isArray(field) && field.every((segment) => typeof segment === 'string' || typeof segment === 'number') ? field.join('.') : undefined;\n    const text = typeof message === 'string' ? message : 'the vendor refused the write without a message';\n    return keptGraphqlMessage(fieldText === undefined || fieldText.length === 0 ? text : `${fieldText}: ${text}`);\n  });\n  const errorCode = refusal.codePath === undefined ? undefined\n    : stated.map((entry) => readGraphqlErrorCode(entry, refusal.codePath!)).find((code) => code !== undefined);\n  return { errorMessages, ...(errorCode === undefined ? {} : { errorCode }) };\n}\n\n/**\n * Reads a parsed GraphQL answer (#3392). The ONE reader: the engine's transport, for a 2xx and a non-2xx answer alike,\n * and every test go through it. See the module header for the rule and its sources.\n */\nexport function readProviderGraphqlResponse(\n  body: unknown,\n  errorCodePath?: string,\n  payloadRefusal?: ProviderGraphqlPayloadRefusal,\n): ProviderGraphqlResponseVerdict {\n  if (body === null || typeof body !== 'object' || Array.isArray(body)) return { kind: ProviderGraphqlResponseOutcomeKind.UNSTATED };\n  const answer = body as Record<string, unknown>;\n  const errors = Object.hasOwn(answer, 'errors') ? answer.errors : undefined;\n  if (errors !== undefined && errors !== null && !Array.isArray(errors)) return { kind: ProviderGraphqlResponseOutcomeKind.UNSTATED };\n  if (Array.isArray(errors) && errors.length > 0) {\n    const errorMessages = errors\n      .map((error) => (error !== null && typeof error === 'object' && typeof (error as { message?: unknown }).message === 'string' ? (error as { message: string }).message : undefined))\n      .filter((message): message is string => message !== undefined)\n      .slice(0, PROVIDER_GRAPHQL_MAXIMUM_ERROR_MESSAGES)\n      .map(keptGraphqlMessage);\n    const errorCode = errorCodePath === undefined ? undefined\n      : errors.map((error) => readGraphqlErrorCode(error, errorCodePath)).find((code) => code !== undefined);\n    return {\n      kind: Object.hasOwn(answer, 'data') ? ProviderGraphqlResponseOutcomeKind.EXECUTION_ERROR : ProviderGraphqlResponseOutcomeKind.REQUEST_ERROR,\n      errorMessages,\n      ...(errorCode === undefined ? {} : { errorCode }),\n    };\n  }\n  const data = Object.hasOwn(answer, 'data') ? answer.data : undefined;\n  if (data === null || typeof data !== 'object' || Array.isArray(data)) return { kind: ProviderGraphqlResponseOutcomeKind.UNSTATED };\n  const refused = payloadRefusal === undefined ? undefined : readGraphqlPayloadRefusal(data as Record<string, unknown>, payloadRefusal);\n  if (refused !== undefined) return { kind: ProviderGraphqlResponseOutcomeKind.PAYLOAD_REFUSED, ...refused };\n  return { kind: ProviderGraphqlResponseOutcomeKind.SUCCEEDED, data: data as Record<string, unknown> };\n}\n/** @wildo_source:part:end external-connectors.models.rest-operation-contract */\n"]}

package/dist/esm/protocols/hooks-capability.external-connectors-models.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks-capability.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../../src/protocols/hooks-capability.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B;AAMD;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,wBAAwB,GAAG,IAAI,CAAC;CACpC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,WAAW,CACT,gBAAgB,EAAE,OAAO,EAAE,wEAAwE;IACnG,WAAW,EAAE,wBAAwB,GACpC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,0BAA0B;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,mDAAmD;IACnD,YAAY,CAAC,WAAW,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEzF,wFAAwF;IACxF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C"}
+{"version":3,"file":"hooks-capability.external-connectors-models.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/hooks-capability.external-connectors-models.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,sBAAsB;IACtB,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;CAC1B;AAMD;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;;;OAKG;IACH,eAAe,CACb,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACxC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B;;;OAGG;IACH,UAAU,CACR,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,wBAAwB,GAAG,IAAI,CAAC;CACpC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,WAAW,CACT,gBAAgB,EAAE,OAAO,EAAE,wEAAwE;IACnG,WAAW,EAAE,wBAAwB,GACpC,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,0BAA0B;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,mDAAmD;IACnD,YAAY,CAAC,WAAW,EAAE,wBAAwB,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;IAEzF,wFAAwF;IACxF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7C"}