@mintlify/common 1.0.1085 → 1.0.1086

package/dist/index.d.ts

@@ -39,3 +39,4 @@ export * from './isAllowedRedirectUri.js';
 export * from './knownMcpClients.js';
 export * from './live-preview.js';
 export * from './paths/isEqualIgnoringLeadingSlash.js';
+export * from './sdk/index.js';

package/dist/index.js

@@ -39,3 +39,4 @@ export * from './isAllowedRedirectUri.js';
 export * from './knownMcpClients.js';
 export * from './live-preview.js';
 export * from './paths/isEqualIgnoringLeadingSlash.js';
+export * from './sdk/index.js';

package/dist/sdk/index.d.ts

@@ -0,0 +1 @@
+export { parseSdkString, potentiallyParseSdkString, parseSdkTargetFromMetadata, resolveSdkTarget, } from './parseSdkString.js';

package/dist/sdk/index.js

@@ -0,0 +1 @@
+export { parseSdkString, potentiallyParseSdkString, parseSdkTargetFromMetadata, resolveSdkTarget, } from './parseSdkString.js';

package/dist/sdk/parseSdkString.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedSdkTarget, SdkFormat, SdkTarget } from '@mintlify/models';
+export declare const potentiallyParseSdkString: (str: string) => SdkTarget | undefined;
+export declare const parseSdkString: (str: string) => SdkTarget;
+export declare const parseSdkTargetFromMetadata: (metadata: {
+    sdk?: unknown;
+}, inherited?: {
+    format?: SdkFormat;
+    source?: string;
+}) => ResolvedSdkTarget | undefined;
+export declare const resolveSdkTarget: (target: SdkTarget, inherited?: {
+    format?: SdkFormat;
+    source?: string;
+}) => ResolvedSdkTarget | undefined;

package/dist/sdk/parseSdkString.js

@@ -0,0 +1,105 @@
+import { SDK_FORMATS, SDK_SYMBOL_KINDS } from '@mintlify/models';
+const MEMBER_KINDS = new Set(['method', 'property']);
+function isSdkFormat(value) {
+    return SDK_FORMATS.includes(value);
+}
+function isSdkSymbolKind(value) {
+    return SDK_SYMBOL_KINDS.includes(value);
+}
+function parseQualifiedName(kind, rawName) {
+    if (!MEMBER_KINDS.has(kind) || !rawName.includes('.')) {
+        return { name: rawName };
+    }
+    const lastDot = rawName.lastIndexOf('.');
+    const parent = rawName.slice(0, lastDot);
+    const name = rawName.slice(lastDot + 1);
+    if (!parent || !name) {
+        throw new Error('improperly formatted sdk string');
+    }
+    return { name, parent };
+}
+export const potentiallyParseSdkString = (str) => {
+    try {
+        return parseSdkString(str);
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
+export const parseSdkString = (str) => {
+    const components = str.trim().split(/\s+/);
+    if (components.length < 2 || components.length > 3) {
+        throw new Error('improperly formatted sdk string');
+    }
+    let source;
+    let kindRaw;
+    let nameRaw;
+    if (components.length === 3) {
+        const [sourcePart, kindPart, namePart] = components;
+        if (!sourcePart || !kindPart || !namePart) {
+            throw new Error('improperly formatted sdk string');
+        }
+        source = sourcePart;
+        kindRaw = kindPart;
+        nameRaw = namePart;
+    }
+    else {
+        const [kindPart, namePart] = components;
+        if (!kindPart || !namePart) {
+            throw new Error('improperly formatted sdk string');
+        }
+        kindRaw = kindPart;
+        nameRaw = namePart;
+    }
+    if (!isSdkSymbolKind(kindRaw)) {
+        throw new Error('invalid sdk symbol kind');
+    }
+    const { name, parent } = parseQualifiedName(kindRaw, nameRaw);
+    return Object.assign(Object.assign(Object.assign({}, (source ? { source } : {})), { kind: kindRaw, name }), (parent ? { parent } : {}));
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+export const parseSdkTargetFromMetadata = (metadata, inherited) => {
+    const raw = metadata.sdk;
+    if (raw === undefined || raw === null || raw === '')
+        return undefined;
+    let target;
+    if (typeof raw === 'string') {
+        try {
+            target = parseSdkString(raw);
+        }
+        catch (error) {
+            console.error(`unable to parse value "${raw}" for field "sdk":`, error);
+            return undefined;
+        }
+    }
+    else if (isRecord(raw)) {
+        const kind = raw.kind;
+        const name = raw.name;
+        if (typeof kind !== 'string' || !isSdkSymbolKind(kind) || typeof name !== 'string' || !name) {
+            return undefined;
+        }
+        const format = typeof raw.format === 'string' && isSdkFormat(raw.format) ? raw.format : undefined;
+        const source = typeof raw.source === 'string' && raw.source.length > 0 ? raw.source : undefined;
+        const parent = typeof raw.parent === 'string' && raw.parent.length > 0 ? raw.parent : undefined;
+        target = Object.assign(Object.assign(Object.assign(Object.assign({}, (format ? { format } : {})), (source ? { source } : {})), { kind,
+            name }), (parent ? { parent } : {}));
+    }
+    else {
+        return undefined;
+    }
+    return resolveSdkTarget(target, inherited);
+};
+export const resolveSdkTarget = (target, inherited) => {
+    var _a, _b;
+    const format = (_a = target.format) !== null && _a !== void 0 ? _a : inherited === null || inherited === void 0 ? void 0 : inherited.format;
+    const source = (_b = target.source) !== null && _b !== void 0 ? _b : inherited === null || inherited === void 0 ? void 0 : inherited.source;
+    if (!format || !source)
+        return undefined;
+    if (MEMBER_KINDS.has(target.kind) && !target.parent) {
+        return undefined;
+    }
+    return Object.assign({ format,
+        source, kind: target.kind, name: target.name }, (target.parent ? { parent: target.parent } : {}));
+};