@mintlify/msft-sdk 1.1.61 → 1.1.63

package/dist/api-playground-2/hooks/useInitializeInputs.js

@@ -1,100 +1,197 @@
-import { useRef as k, useEffect as W } from "react";
-import { apiPlaygroundInputKeys as q } from "../constants/index.js";
-import { escapeDots as O, getSchemaDefault as P, mapParamInToPlaygroundInputKey as w, getParametersPerSection as B, getRequestBodyContentType as G, isSchemaObject as H, getBodyDefaultsFromSchema as J } from "../schemaGraph/utils.js";
-import { usePlaygroundInputsStore as A } from "./usePlaygroundInputsStore.js";
-function X({
-  apiReferenceData: e,
-  selectedBaseUrlIndex: d,
-  selectedExampleIndex: a,
-  selectedRequestBodyContentTypeIndex: p
+import { useRef as b, useEffect as x } from "react";
+import { apiPlaygroundInputKeys as m } from "../constants/index.js";
+import { getRequestBodyContentType as K, getSchemaDefault as g, isSchemaObject as A, getBodyDefaultsFromSchema as T, getParametersPerSection as W, mapParamInToPlaygroundInputKey as v, escapeDots as y, getSecurityOptionInputKeyPrefix as B, isBasicAuth as S } from "../schemaGraph/utils.js";
+import { usePlaygroundInputsStore as d } from "./usePlaygroundInputsStore.js";
+function Z({
+  apiReferenceData: n,
+  selectedBaseUrlIndex: o,
+  selectedExampleIndex: c,
+  selectedRequestBodyContentTypeIndex: s,
+  locallyStoredCredentials: i,
+  serverInputs: t
 }) {
-  const r = k(null), { reset: y, initialize: t, getApiPlaygroundInputs: f, inputs: b } = A(), h = k(!1);
-  W(() => {
-    const m = window.location.pathname, c = A.getState().selectedSecurityOptionIndex;
-    if (!h.current && Object.keys(b).length === 0) {
-      const u = C({
-        apiReferenceData: e,
-        inputs: f(),
-        selectedBaseUrlIndex: d,
-        selectedSecurityOptionIndex: c,
-        selectedExampleIndex: a,
-        selectedContentTypeIndex: p
-      });
-      t(u), h.current = !0, r.current = m;
+  var u;
+  const e = b(!1), r = b(!1), f = b(c);
+  x(() => {
+    if (e.current) return;
+    const h = d.getState();
+    h.reset();
+    const p = P({
+      apiReferenceData: n,
+      selectedBaseUrlIndex: o,
+      selectedSecurityOptionIndex: 0,
+      // Always start with first security option
+      selectedExampleIndex: 0,
+      // Always start with first example
+      selectedContentTypeIndex: s,
+      locallyStoredCredentials: i,
+      serverInputs: t
+    });
+    h.initializeInputs(p), h.initializeApiReferenceData(n), e.current = !0, r.current = !!i, f.current = 0;
+  }, []), x(() => {
+    if (!e.current || r.current || !i)
       return;
-    }
-    if (r.current === null) {
-      r.current = m;
+    const h = d.getState(), p = P({
+      apiReferenceData: n,
+      selectedBaseUrlIndex: o,
+      selectedSecurityOptionIndex: h.selectedSecurityOptionIndex,
+      selectedExampleIndex: h.selectedExampleIndex,
+      selectedContentTypeIndex: s,
+      locallyStoredCredentials: i,
+      serverInputs: t
+    });
+    h.replaceInputs(p), r.current = !0;
+  }, [i]), x(() => {
+    var E;
+    if (!e.current || f.current === c || !((E = n.operation) == null ? void 0 : E.prefillPlaygroundWithExample))
       return;
+    const p = d.getState();
+    p.clear();
+    const a = P({
+      apiReferenceData: n,
+      selectedBaseUrlIndex: o,
+      selectedSecurityOptionIndex: p.selectedSecurityOptionIndex,
+      selectedExampleIndex: c,
+      selectedContentTypeIndex: s,
+      locallyStoredCredentials: i,
+      serverInputs: t
+    });
+    p.initializeInputs(a), f.current = c;
+  }, [c, (u = n.operation) == null ? void 0 : u.prefillPlaygroundWithExample]);
+}
+function P({
+  apiReferenceData: n,
+  selectedBaseUrlIndex: o,
+  selectedSecurityOptionIndex: c,
+  selectedExampleIndex: s,
+  selectedContentTypeIndex: i,
+  locallyStoredCredentials: t,
+  serverInputs: e
+}) {
+  var u;
+  const r = (u = n.operation) == null ? void 0 : u.userInfoPlaygroundInputs, f = {
+    server: { ...r == null ? void 0 : r.server, ...e },
+    header: { ...r == null ? void 0 : r.header, ...t == null ? void 0 : t.header },
+    query: { ...r == null ? void 0 : r.query, ...t == null ? void 0 : t.query },
+    cookie: { ...r == null ? void 0 : r.cookie, ...t == null ? void 0 : t.cookie }
+  };
+  return F({
+    apiReferenceData: n,
+    selectedBaseUrlIndex: o,
+    selectedSecurityOptionIndex: c,
+    selectedExampleIndex: s,
+    selectedContentTypeIndex: i,
+    mergedUserInfo: f
+  });
+}
+const F = ({
+  apiReferenceData: n,
+  selectedBaseUrlIndex: o,
+  selectedSecurityOptionIndex: c,
+  selectedExampleIndex: s = 0,
+  selectedContentTypeIndex: i = 0,
+  mergedUserInfo: t
+}) => {
+  var O, $, j, l, w, k, q;
+  let e = {};
+  const r = (O = n.operation) == null ? void 0 : O.prefillPlaygroundWithExample, u = ((($ = n.operation) == null ? void 0 : $.prefillPlaygroundExamples) ?? [])[s], p = (l = Object.values(((j = n.dependencies) == null ? void 0 : j.servers) ?? {})[o]) == null ? void 0 : l.variables, a = (w = n.dependencies) == null ? void 0 : w.processedSecurityOptions, E = a == null ? void 0 : a[c], V = (k = n.dependencies) == null ? void 0 : k.parameters, z = (q = n.dependencies) == null ? void 0 : q.requestBody;
+  return r && u ? e = u : e = {
+    ...N(p),
+    ...G(E),
+    ...H({ apiReferenceData: n, parameters: V }),
+    ...J({ requestBody: z, apiReferenceData: n, selectedContentTypeIndex: i })
+  }, t && (e = {
+    ...e,
+    ...L({
+      mergedUserInfo: t,
+      securityOption: E,
+      serverVariables: p
+    })
+  }), e;
+};
+function N(n) {
+  const o = {};
+  return n && Object.entries(n).forEach(([c, s]) => {
+    const i = `${m.server}.${y(c)}`;
+    if (typeof s == "object" && s !== null) {
+      const t = g(s);
+      t && (o[i] = t);
     }
-    if (r.current !== m) {
-      y();
-      const u = C({
-        apiReferenceData: e,
-        inputs: f(),
-        selectedBaseUrlIndex: d,
-        selectedSecurityOptionIndex: c,
-        selectedExampleIndex: a,
-        selectedContentTypeIndex: p
-      });
-      t(u), r.current = m;
+  }), o;
+}
+function G(n) {
+  const o = {};
+  return n && n.schemes.forEach(
+    ({
+      scheme: c,
+      schema: s,
+      name: i
+    }) => {
+      const t = B({ scheme: c, name: i }), e = g(s);
+      e && typeof e == "string" && (o[t] = e), e && typeof e == "object" && (o[t + ".username"] = "username" in e && typeof e.username == "string" ? e.username : "", o[t + ".password"] = "password" in e && typeof e.password == "string" ? e.password : "");
     }
-  }, [
-    e,
-    d,
-    a,
-    p,
-    y,
-    t,
-    f,
-    b
-  ]);
+  ), o;
 }
-const C = ({
-  apiReferenceData: e,
-  // eslint-disable-next-line unused-imports/no-unused-vars
-  inputs: d,
-  selectedBaseUrlIndex: a,
-  selectedSecurityOptionIndex: p,
-  selectedExampleIndex: r = 0,
-  selectedContentTypeIndex: y = 0
-}) => {
-  var E, V, I, $, j, x, K, z;
-  let t = {};
-  const f = (E = e.operation) == null ? void 0 : E.prefillPlaygroundWithExample, h = (((V = e.operation) == null ? void 0 : V.prefillPlaygroundExamples) ?? [])[r], S = ($ = Object.values(((I = e.dependencies) == null ? void 0 : I.servers) ?? {})[a]) == null ? void 0 : $.variables, c = (j = e.dependencies) == null ? void 0 : j.processedSecurityOptions, u = c == null ? void 0 : c[p], F = (x = e.dependencies) == null ? void 0 : x.parameters, v = (K = e.dependencies) == null ? void 0 : K.requestBody;
-  if (!(f && h)) {
-    if (S && Object.entries(S).forEach(([n, s]) => {
-      const o = `${q.server}.${O(n)}`, i = P(s);
-      i && (t[o] = i);
-    }), u) {
-      const { scheme: n, schema: s } = u, o = "in" in n ? n.in : "header", i = "name" in n ? n.name : s.title ?? "", l = `${w(o)}.${O(i)}`, g = P(s);
-      g && (t[l] = g);
+function H({
+  apiReferenceData: n,
+  parameters: o
+}) {
+  const c = {};
+  if (!o) return c;
+  const { header: s, path: i, query: t, cookie: e } = W(n);
+  return [...s, ...i, ...t, ...e].forEach((r) => {
+    if (r.schema) {
+      const f = `${v(r.in)}.${y(r.name)}`, u = g(r.schema);
+      u && (c[f] = u);
     }
-    if (F) {
-      const { header: n, path: s, query: o, cookie: i } = B(e);
-      [...n, ...s, ...o, ...i].forEach((l) => {
-        if (l.schema) {
-          const g = `${w(l.in)}.${O(l.name)}`, T = P(l.schema);
-          T && (t[g] = T);
-        }
-      });
+  }), c;
+}
+function J({
+  requestBody: n,
+  apiReferenceData: o,
+  selectedContentTypeIndex: c
+}) {
+  var t;
+  const s = {};
+  if (!n) return s;
+  const i = K(o, c);
+  if (i) {
+    const e = (t = n.content[i]) == null ? void 0 : t.schema, r = g(e);
+    if (r)
+      s[`${m.body}`] = r;
+    else if (A(e)) {
+      const f = T(e);
+      return { ...s, ...f };
     }
-    if (v) {
-      const n = G(e, y);
-      if (n) {
-        const s = (z = v.content[n]) == null ? void 0 : z.schema, o = P(s);
-        if (o)
-          t[`${q.body}`] = o;
-        else if (H(s)) {
-          const i = J(s);
-          t = { ...t, ...i };
-        }
+  }
+  return s;
+}
+function L({
+  mergedUserInfo: n,
+  securityOption: o,
+  serverVariables: c
+}) {
+  const s = {};
+  if (o) {
+    const i = {};
+    o.schemes.forEach(
+      ({ scheme: t, name: e }) => {
+        i[e] = t;
       }
-    }
+    ), Object.entries(n.header ?? {}).forEach(([t, e]) => {
+      const r = i[t];
+      r && (S(r) ? (typeof e == "object" && e !== null && "username" in e && typeof e.username == "string" && (s[`${m.header}.Authorization.username`] = e.username), typeof e == "object" && e !== null && "password" in e && typeof e.password == "string" && (s[`${m.header}.Authorization.password`] = e.password)) : typeof e == "string" && (s[`${m.header}.${y(t)}`] = e));
+    }), Object.entries(n.query ?? {}).forEach(([t, e]) => {
+      i[t] && (s[`${m.query}.${y(t)}`] = e);
+    }), Object.entries(n.cookie ?? {}).forEach(([t, e]) => {
+      i[t] && (s[`${m.cookie}.${y(t)}`] = e);
+    });
   }
-  return t;
-};
+  return c && Object.keys(c).length > 0 && n.server && Object.entries(n.server).forEach(([i, t]) => {
+    c[i] && (s[`${m.server}.${y(i)}`] = t);
+  }), s;
+}
 export {
-  C as getInitialPlaygroundValues,
-  X as useInitializeInputs
+  F as getInitialPlaygroundValues,
+  Z as useInitializeInputs
 };

package/dist/api-playground-2/hooks/usePlaygroundInputsStore.js

@@ -1,32 +1,77 @@
-import { create as s } from "zustand";
-import { unflattenInputs as c } from "../schemaGraph/utils.js";
-const u = s((e, n) => ({
+import { useState as l, useEffect as I, useMemo as a } from "react";
+import { create as x } from "zustand";
+import { useShallow as f } from "zustand/react/shallow";
+import { unflattenInputs as i } from "../schemaGraph/utils.js";
+const c = x((t, p) => ({
   inputs: {},
-  initialize: (t) => e({
-    inputs: { ...t }
+  apiReferenceData: void 0,
+  initializeInputs: (e) => t({
+    inputs: { ...e }
   }),
-  setInput: (t, i) => e((p) => ({
-    inputs: { ...p.inputs, [t]: i }
-  })),
-  setInputs: (t) => e((i) => ({
-    inputs: { ...i.inputs, ...t }
+  initializeApiReferenceData: (e) => t({
+    apiReferenceData: e
+  }),
+  setInput: (e, n) => t((s) => {
+    const o = { ...s.inputs, [e]: n }, u = e.match(/^(.+)\.oneOf\.(\d+)$/);
+    if (u) {
+      const [, r] = u;
+      Object.keys(o).forEach((d) => {
+        d !== e && d.startsWith(`${r}.oneOf.`) && delete o[d];
+      });
+    }
+    return { inputs: o };
+  }),
+  setInputs: (e) => t((n) => ({
+    inputs: { ...n.inputs, ...e }
   })),
-  replaceInputs: (t) => e({ inputs: t }),
-  getInput: (t) => n().inputs[t],
-  getApiPlaygroundInputs: () => c(n().inputs),
-  clear: () => e({ inputs: {} }),
-  reset: () => e({ inputs: {} }),
+  replaceInputs: (e) => t({ inputs: e }),
+  deleteInput: (e) => t((n) => {
+    const s = { ...n.inputs };
+    delete s[e];
+    const o = e + ".";
+    return Object.keys(s).forEach((u) => {
+      u.startsWith(o) && delete s[u];
+    }), { inputs: s };
+  }),
+  getInput: (e) => p().inputs[e],
+  getApiPlaygroundInputs: () => i(p().inputs),
+  clear: () => t({ inputs: {} }),
+  reset: () => t({
+    inputs: {},
+    selectedSecurityOptionIndex: 0,
+    selectedExampleIndex: 0,
+    selectedRequestBodyContentTypeIndex: 0,
+    selectedResponseContentTypeIndex: 0
+  }),
+  selectedBaseUrlIndex: 0,
+  setSelectedBaseUrlIndex: (e) => t({ selectedBaseUrlIndex: e }),
   selectedSecurityOptionIndex: 0,
-  setSelectedSecurityOptionIndex: (t) => e({ selectedSecurityOptionIndex: t })
-})), d = () => {
-  const e = u(
-    (t) => t.selectedSecurityOptionIndex
-  ), n = u(
-    (t) => t.setSelectedSecurityOptionIndex
-  );
-  return { selectedSecurityOptionIndex: e, setSelectedSecurityOptionIndex: n };
+  setSelectedSecurityOptionIndex: (e) => t({ selectedSecurityOptionIndex: e }),
+  // Note: selectedExampleIndex is for prefill example selection (Example 1, Example 2, etc.)
+  // NOT for code snippet selection (Python, Node.js, cURL, etc.)
+  // Code snippet selection is managed by CodeGroupSelect component's local state
+  selectedExampleIndex: 0,
+  setSelectedExampleIndex: (e) => t({ selectedExampleIndex: e }),
+  selectedRequestBodyContentTypeIndex: 0,
+  setSelectedRequestBodyContentTypeIndex: (e) => t({ selectedRequestBodyContentTypeIndex: e }),
+  selectedResponseContentTypeIndex: 0,
+  setSelectedResponseContentTypeIndex: (e) => t({ selectedResponseContentTypeIndex: e })
+})), T = (t) => {
+  const p = c((n) => n.inputs[t]), e = c((n) => n.setInput);
+  return { value: p, setInput: e };
+}, O = (t = 300) => {
+  const p = c(f((s) => s.inputs)), [e, n] = l(p);
+  return I(() => {
+    const s = setTimeout(() => {
+      n(p);
+    }, t);
+    return () => {
+      clearTimeout(s);
+    };
+  }, [p, t]), a(() => i(e), [e]);
 };
 export {
-  u as usePlaygroundInputsStore,
-  d as useSelectedSecurityOption
+  O as useDebouncedApiPlaygroundInputs,
+  T as usePlaygroundInput,
+  c as usePlaygroundInputsStore
 };

package/dist/api-playground-2/hooks/useSelectedBaseUrl.js

@@ -0,0 +1,13 @@
+import { useContext as c } from "react";
+import { ApiReferenceContext2 as d } from "../../contexts/ConfigContext.js";
+import { usePlaygroundInputsStore as n } from "./usePlaygroundInputsStore.js";
+const x = () => {
+  var s, o;
+  const t = n((e) => e.selectedBaseUrlIndex), a = n(
+    (e) => e.setSelectedBaseUrlIndex
+  ), { apiReferenceData2: r } = c(d), l = ((s = r.operation) == null ? void 0 : s.baseUrl) ?? ((o = r.operation) == null ? void 0 : o.baseUrlOptions[t]) ?? "";
+  return { selectedBaseUrlIndex: t, setSelectedBaseUrlIndex: a, baseUrl: l };
+};
+export {
+  x as useSelectedBaseUrl
+};

package/dist/api-playground-2/hooks/useSelectedExample.js

@@ -0,0 +1,10 @@
+import { usePlaygroundInputsStore as t } from "./usePlaygroundInputsStore.js";
+const s = () => {
+  const l = t((e) => e.selectedExampleIndex), d = t(
+    (e) => e.setSelectedExampleIndex
+  );
+  return { selectedExampleIndex: l, setSelectedExampleIndex: d };
+};
+export {
+  s as useSelectedExample
+};

package/dist/api-playground-2/hooks/useSelectedRequestBodyContentType.js

@@ -0,0 +1,12 @@
+import { usePlaygroundInputsStore as t } from "./usePlaygroundInputsStore.js";
+const s = () => {
+  const n = t(
+    (e) => e.selectedRequestBodyContentTypeIndex
+  ), o = t(
+    (e) => e.setSelectedRequestBodyContentTypeIndex
+  );
+  return { selectedRequestBodyContentTypeIndex: n, setSelectedRequestBodyContentTypeIndex: o };
+};
+export {
+  s as useSelectedRequestBodyContentType
+};

package/dist/api-playground-2/hooks/useSelectedResponseContentType.js

@@ -0,0 +1,12 @@
+import { usePlaygroundInputsStore as n } from "./usePlaygroundInputsStore.js";
+const p = () => {
+  const t = n(
+    (e) => e.selectedResponseContentTypeIndex
+  ), s = n(
+    (e) => e.setSelectedResponseContentTypeIndex
+  );
+  return { selectedResponseContentTypeIndex: t, setSelectedResponseContentTypeIndex: s };
+};
+export {
+  p as useSelectedResponseContentType
+};

package/dist/api-playground-2/hooks/useSelectedSecurityOption.js

@@ -0,0 +1,31 @@
+import { useContext as m, useRef as x, useEffect as O } from "react";
+import { ApiReferenceContext2 as g } from "../../contexts/ConfigContext.js";
+import { getSecurityOptionInputKeyPrefix as y, getSchemaDefault as w } from "../schemaGraph/utils.js";
+import { usePlaygroundInputsStore as p } from "./usePlaygroundInputsStore.js";
+const b = () => {
+  var f;
+  const { apiReferenceData2: S } = m(g), r = p(
+    (c) => c.selectedSecurityOptionIndex
+  ), l = p(
+    (c) => c.setSelectedSecurityOptionIndex
+  ), u = x(r), t = (f = S.dependencies) == null ? void 0 : f.processedSecurityOptions;
+  return O(() => {
+    if (u.current !== r) {
+      const c = t == null ? void 0 : t[u.current], d = t == null ? void 0 : t[r];
+      if (c && d) {
+        const n = { ...p.getState().inputs };
+        c.schemes.forEach(({ scheme: s, name: a }) => {
+          const o = y({ scheme: s, name: a });
+          s.type === "http" && s.scheme === "basic" ? (delete n[o + ".username"], delete n[o + ".password"]) : delete n[o];
+        }), d.schemes.forEach(({ scheme: s, schema: a, name: o }) => {
+          const i = y({ scheme: s, name: o }), I = s.type === "http" && s.scheme === "basic", e = w(a);
+          I ? e && typeof e == "object" && (n[i + ".username"] = "username" in e && typeof e.username == "string" ? e.username : "", n[i + ".password"] = "password" in e && typeof e.password == "string" ? e.password : "") : e && typeof e == "string" && (n[i] = e);
+        }), p.getState().replaceInputs(n);
+      }
+      u.current = r;
+    }
+  }, [r, t]), { selectedSecurityOptionIndex: r, setSelectedSecurityOptionIndex: l };
+};
+export {
+  b as useSelectedSecurityOption
+};