@mintlify/common 1.0.1191 → 1.0.1193

package/dist/graphql/index.d.ts

@@ -0,0 +1,2 @@
+export * from './parseGraphqlSelector.js';
+export * from './resolveGraphqlOperation.js';

package/dist/graphql/index.js

@@ -0,0 +1,2 @@
+export * from './parseGraphqlSelector.js';
+export * from './resolveGraphqlOperation.js';

package/dist/graphql/parseGraphqlSelector.d.ts

@@ -0,0 +1,6 @@
+import type { GraphqlTarget } from '@mintlify/models';
+export type GraphqlSelector = {
+    kind: GraphqlTarget['kind'];
+    name: string;
+};
+export declare const parseGraphqlSelector: (str: string) => GraphqlSelector | undefined;

package/dist/graphql/parseGraphqlSelector.js

@@ -0,0 +1,15 @@
+const GRAPHQL_NAME = /^[_A-Za-z][_0-9A-Za-z]*$/;
+const SELECTOR_KINDS = ['query', 'mutation', 'type'];
+export const parseGraphqlSelector = (str) => {
+    const [rawKind, name, ...extra] = str.trim().split(/\s+/);
+    if (!rawKind || !name || extra.length > 0)
+        return undefined;
+    const kind = SELECTOR_KINDS.find((kind) => kind.toUpperCase() === rawKind);
+    if (!kind)
+        return undefined;
+    if (kind === 'type' && name.includes('.'))
+        return undefined;
+    if (!name.split('.').every((segment) => GRAPHQL_NAME.test(segment)))
+        return undefined;
+    return { kind, name };
+};

package/dist/graphql/resolveGraphqlOperation.d.ts

@@ -0,0 +1,7 @@
+import type { GraphqlField, GraphqlReference, GraphqlTarget, GraphqlTypeRef } from '@mintlify/models';
+export declare const getNamedGraphqlType: (type: GraphqlTypeRef) => string;
+export type ResolvedGraphqlOperation = {
+    field: GraphqlField;
+    parents: GraphqlField[];
+};
+export declare const resolveGraphqlOperation: (reference: GraphqlReference, target: Pick<GraphqlTarget, "kind" | "name">) => ResolvedGraphqlOperation | undefined;

package/dist/graphql/resolveGraphqlOperation.js

@@ -0,0 +1,21 @@
+export const getNamedGraphqlType = (type) => type.kind === 'named' ? type.name : getNamedGraphqlType(type.ofType);
+export const resolveGraphqlOperation = (reference, target) => {
+    if (target.kind !== 'query' && target.kind !== 'mutation')
+        return undefined;
+    let typeName = target.kind === 'query' ? reference.queryType : reference.mutationType;
+    const path = [];
+    for (const segment of target.name.split('.')) {
+        const type = reference.types.find(({ name }) => name === typeName);
+        if ((type === null || type === void 0 ? void 0 : type.kind) !== 'object' && (type === null || type === void 0 ? void 0 : type.kind) !== 'interface')
+            return undefined;
+        const field = type.fields.find(({ name }) => name === segment);
+        if (!field)
+            return undefined;
+        path.push(field);
+        typeName = getNamedGraphqlType(field.type);
+    }
+    const field = path.pop();
+    if (!field)
+        return undefined;
+    return { field, parents: path };
+};

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from './title.js';
 export * from './schema/common.js';
 export * from './camelToSentenceCase.js';
 export * from './asyncapi/index.js';
+export * from './graphql/index.js';
 export * from './isAbsoluteUrl.js';
 export * from './isValidEmail.js';
 export * from './rss/index.js';

package/dist/index.js

@@ -18,6 +18,7 @@ export * from './title.js';
 export * from './schema/common.js';
 export * from './camelToSentenceCase.js';
 export * from './asyncapi/index.js';
+export * from './graphql/index.js';
 export * from './isAbsoluteUrl.js';
 export * from './isValidEmail.js';
 export * from './rss/index.js';