@scalar/api-client 2.5.34 → 2.6.0

package/dist/v2/blocks/operation-code-sample/helpers/get-example-from-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-example-from-schema.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-example-from-schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAA;AA8XhG;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,oBAAoB,GAC/B,QAAQ,YAAY,EACpB,UAAU;IACR,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4CAA4C;IAC5C,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,qDAAqD;IACrD,8BAA8B,CAAC,EAAE,OAAO,CAAA;CACzC,EACD,QAAO,MAAU,EACjB,eAAe,YAAY,EAC3B,OAAO,MAAM,KACZ,OAkHF,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/get-example-from-schema.js

@@ -0,0 +1,209 @@
+import { isDefined as x } from "@scalar/helpers/array/is-defined";
+import { getResolvedRef as l } from "@scalar/workspace-store/helpers/get-resolved-ref";
+const N = 10, A = 10, E = "propertyName*", O = (/* @__PURE__ */ new Date()).toISOString(), S = O.split("T")[0], R = O.split("T")[1].split(".")[0], T = {
+  "date-time": O,
+  date: S,
+  email: "hello@example.com",
+  hostname: "example.com",
+  // https://tools.ietf.org/html/rfc6531#section-3.3
+  "idn-email": "jane.doe@example.com",
+  // https://tools.ietf.org/html/rfc5890#section-2.3.2.3
+  "idn-hostname": "example.com",
+  ipv4: "127.0.0.1",
+  ipv6: "51d4:7fab:bfbf:b7d7:b2cb:d4b4:3dad:d998",
+  "iri-reference": "/entitiy/1",
+  // https://tools.ietf.org/html/rfc3987
+  iri: "https://example.com/entity/123",
+  "json-pointer": "/nested/objects",
+  password: "super-secret",
+  regex: "/[a-z]/",
+  // https://tools.ietf.org/html/draft-handrews-relative-json-pointer-01
+  "relative-json-pointer": "1/nested/objects",
+  // full-time in https://tools.ietf.org/html/rfc3339#section-5.6
+  time: R,
+  // either a URI or relative-reference https://tools.ietf.org/html/rfc3986#section-4.1
+  "uri-reference": "../folder",
+  "uri-template": "https://example.com/{id}",
+  uri: "https://example.com",
+  uuid: "123e4567-e89b-12d3-a456-426614174000",
+  "object-id": "6592008029c8c3e4dc76256c"
+}, v = (t, r = !1, o = "") => "type" in t && t.type === "string" && "format" in t && t.format === "binary" ? new File([""], "filename") : r && "format" in t && t.format ? T[t.format] ?? o : o, g = /* @__PURE__ */ new WeakMap(), j = /* @__PURE__ */ new WeakMap(), D = (t) => {
+  if (!t)
+    return;
+  const r = j.get(t);
+  if (r)
+    return r;
+  if ("required" in t) {
+    const o = t.required;
+    if (Array.isArray(o) && o.length > 0) {
+      const i = new Set(o);
+      return j.set(t, i), i;
+    }
+  }
+}, p = (t, r) => (typeof r != "object" || r === null || g.set(t, r), r), q = (t) => !!(t.allOf || t.oneOf || t.anyOf), w = (t, r, o, i) => {
+  if (i?.omitEmptyAndOptionalProperties !== !0 || "type" in t && (t.type === "object" || t.type === "array") || q(t) || "examples" in t && Array.isArray(t.examples) && t.examples.length > 0 || "example" in t && t.example !== void 0 || "default" in t && t.default !== void 0 || "const" in t && t.const !== void 0 || "enum" in t && Array.isArray(t.enum) && t.enum.length > 0)
+    return !1;
+  const e = o ?? t.title ?? "", u = D(r);
+  return !(u ? u.has(e) : !1);
+}, P = (t, r) => Array.isArray(t) && Array.isArray(r) ? [...t, ...r] : t && typeof t == "object" && r && typeof r == "object" ? { ...t, ...r } : r, I = (t, r, o) => {
+  const i = {};
+  if ("properties" in t && t.properties) {
+    const n = Object.keys(t.properties), e = o > 3 ? Math.min(A, n.length) : n.length;
+    for (let u = 0; u < e; u++) {
+      const s = n[u], a = l(t.properties[s]);
+      if (!a)
+        continue;
+      const y = r?.xml && "xml" in a ? a.xml?.name : void 0, f = d(a, r, o + 1, t, s);
+      typeof f < "u" && (i[y ?? s] = f);
+    }
+    o > 3 && n.length > A && (i["..."] = "[Additional Properties Truncated]");
+  }
+  if ("patternProperties" in t && t.patternProperties)
+    for (const n of Object.keys(t.patternProperties)) {
+      const e = l(t.patternProperties[n]);
+      e && (i[n] = d(e, r, o + 1, t, n));
+    }
+  if ("additionalProperties" in t && t.additionalProperties !== void 0) {
+    const n = l(t.additionalProperties), e = t.additionalProperties === !0 || typeof t.additionalProperties == "object" && Object.keys(t.additionalProperties).length === 0, u = typeof n == "object" && "x-additionalPropertiesName" in n && typeof n["x-additionalPropertiesName"] == "string" && n["x-additionalPropertiesName"].trim().length > 0 ? `${n["x-additionalPropertiesName"].trim()}*` : E;
+    i[u] = e ? "anything" : typeof n == "object" ? d(n, r, o + 1) : "anything";
+  }
+  if (t.oneOf?.[0])
+    Object.assign(i, d(l(t.oneOf[0]), r, o + 1));
+  else if (t.anyOf?.[0])
+    Object.assign(i, d(l(t.anyOf[0]), r, o + 1));
+  else if (Array.isArray(t.allOf) && t.allOf.length > 0) {
+    let n = i;
+    for (const e of t.allOf) {
+      const u = d(l(e), r, o + 1, t);
+      n = P(n, u);
+    }
+    n && typeof n == "object" && Object.assign(i, n);
+  }
+  if (r?.xml && "xml" in t && t.xml?.name && o === 0) {
+    const n = {};
+    return n[t.xml.name] = i, p(t, n);
+  }
+  return p(t, i);
+}, M = (t, r, o) => {
+  const i = "items" in t ? l(t.items) : void 0, n = i && typeof i == "object" && "xml" in i ? i.xml?.name : void 0, e = !!(r?.xml && "xml" in t && t.xml?.wrapped && n);
+  if (t.example !== void 0)
+    return p(t, e ? { [n]: t.example } : t.example);
+  if (i && typeof i == "object") {
+    if (Array.isArray(i.allOf) && i.allOf.length > 0) {
+      const y = i.allOf.filter(x), f = l(y[0]);
+      if (f && typeof f == "object" && "type" in f && f.type === "object") {
+        const c = d({ type: "object", allOf: y }, r, o + 1, t);
+        return p(t, e ? [{ [n]: c }] : [c]);
+      }
+      const m = y.map((b) => d(l(b), r, o + 1, t)).filter(x);
+      return p(
+        t,
+        e ? m.map((b) => ({ [n]: b })) : m
+      );
+    }
+    const a = i.anyOf || i.oneOf;
+    if (a && a.length > 0) {
+      const y = a[0], f = d(l(y), r, o + 1, t);
+      return p(t, e ? [{ [n]: f }] : [f]);
+    }
+  }
+  const u = i && typeof i == "object" && ("type" in i && i.type === "object" || "properties" in i), s = i && typeof i == "object" && ("type" in i && i.type === "array" || "items" in i);
+  if (i && typeof i == "object" && ("type" in i && i.type || u || s)) {
+    const a = d(i, r, o + 1);
+    return p(t, e ? [{ [n]: a }] : [a]);
+  }
+  return p(t, []);
+}, _ = (t, r, o) => {
+  if ("type" in t && t.type && !Array.isArray(t.type))
+    switch (t.type) {
+      case "string":
+        return v(t, r, o ?? "");
+      case "boolean":
+        return !0;
+      case "integer":
+        return "minimum" in t && typeof t.minimum == "number" ? t.minimum : 1;
+      case "number":
+        return "minimum" in t && typeof t.minimum == "number" ? t.minimum : 1;
+      case "array":
+        return [];
+      default:
+        return;
+    }
+}, k = (t, r, o) => {
+  if ("type" in t && Array.isArray(t.type)) {
+    if (t.type.includes("null"))
+      return null;
+    const i = t.type[0];
+    if (i)
+      switch (i) {
+        case "string":
+          return v(t, r, o ?? "");
+        case "boolean":
+          return !0;
+        case "integer":
+          return "minimum" in t && typeof t.minimum == "number" ? t.minimum : 1;
+        case "number":
+          return "minimum" in t && typeof t.minimum == "number" ? t.minimum : 1;
+        case "null":
+          return null;
+        default:
+          return;
+      }
+  }
+}, d = (t, r, o = 0, i, n) => {
+  const e = l(t);
+  if (!x(e))
+    return;
+  if (g.has(e))
+    return g.get(e);
+  if (o > N)
+    return "[Max Depth Exceeded]";
+  const u = !!r?.emptyString;
+  if (e.deprecated || r?.mode === "write" && e.readOnly || r?.mode === "read" && e.writeOnly || w(e, i, n, r))
+    return;
+  if ("x-variable" in e && e["x-variable"]) {
+    const f = r?.variables?.[e["x-variable"]];
+    if (f !== void 0)
+      return "type" in e && (e.type === "number" || e.type === "integer") ? p(e, Number(f)) : p(e, f);
+  }
+  if (Array.isArray(e.examples) && e.examples.length > 0)
+    return p(e, e.examples[0]);
+  if (e.example !== void 0)
+    return p(e, e.example);
+  if (e.default !== void 0)
+    return p(e, e.default);
+  if (e.const !== void 0)
+    return p(e, e.const);
+  if (Array.isArray(e.enum) && e.enum.length > 0)
+    return p(e, e.enum[0]);
+  if ("properties" in e || "type" in e && e.type === "object")
+    return I(t, r, o);
+  if ("type" in e && e.type === "array" || "items" in e)
+    return M(e, r, o);
+  const s = _(e, u, r?.emptyString);
+  if (s !== void 0)
+    return p(e, s);
+  const a = e.oneOf || e.anyOf;
+  if (Array.isArray(a) && a.length > 0) {
+    for (const f of a) {
+      const m = l(f);
+      if (m && (!("type" in m) || m.type !== "null"))
+        return p(e, d(m, r, o + 1));
+    }
+    return p(e, null);
+  }
+  if (Array.isArray(e.allOf) && e.allOf.length > 0) {
+    let f;
+    const m = e.allOf;
+    for (const b of m) {
+      const c = d(b, r, o + 1, e);
+      f === void 0 ? f = c : f && typeof f == "object" && c && typeof c == "object" ? f = P(f, c) : c !== void 0 && (f = c);
+    }
+    return p(e, f ?? null);
+  }
+  const y = k(e, u, r?.emptyString);
+  return y !== void 0 ? p(e, y) : p(e, null);
+};
+export {
+  d as getExampleFromSchema
+};

package/dist/v2/blocks/operation-code-sample/helpers/get-example-from-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-example-from-schema.test.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-example-from-schema.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-example-from-schema.test.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-example-from-schema.test.ts"],"names":[],"mappings":""}

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.d.ts

@@ -0,0 +1,26 @@
+import type { Dereference } from '@scalar/workspace-store/helpers/get-resolved-ref';
+export type RefNode<Node> = Partial<Node> & {
+    $ref: string;
+    '$ref-value': Node | RefNode<Node>;
+};
+export type NodeInput<Node> = Node | RefNode<Node>;
+/**
+ * Recursively resolves $ref objects
+ * This type helper ensures proper typing for deeply nested ref resolution.
+ * Properties that could contain $ref objects may resolve to '[circular]' if we have a circular reference.
+ */
+export type DeepDereference<T> = Dereference<T> extends T ? T extends readonly (infer U)[] ? DeepDereference<U>[] : T extends object ? {
+    [K in keyof T]: T[K] extends RefNode<any> ? DeepDereference<T[K]> | '[circular]' : DeepDereference<T[K]>;
+} : T : Dereference<T> extends object ? {
+    [K in keyof Dereference<T>]: Dereference<T>[K] extends RefNode<any> ? DeepDereference<Dereference<T>[K]> | '[circular]' : DeepDereference<Dereference<T>[K]>;
+} : Dereference<T>;
+/**
+ * Recursively resolves all $ref objects in a data structure to their actual values.
+ * Traverses through objects, arrays, and nested structures to find and resolve
+ * any $ref references at any depth level.
+ *
+ * Handles circular references gracefully by detecting them and returning '[circular]'
+ * to prevent infinite loops.
+ */
+export declare const getResolvedRefDeep: <Node>(node: NodeInput<Node>) => DeepDereference<NodeInput<Node>>;
+//# sourceMappingURL=get-resolved-ref-deep.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-resolved-ref-deep.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kDAAkD,CAAA;AAEnF,MAAM,MAAM,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAA;AAChG,MAAM,MAAM,SAAS,CAAC,IAAI,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAElD;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,GACrD,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC5B,eAAe,CAAC,CAAC,CAAC,EAAE,GACpB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC5G,CAAC,GACL,WAAW,CAAC,CAAC,CAAC,SAAS,MAAM,GAC3B;KACG,CAAC,IAAI,MAAM,WAAW,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,GAC/D,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,GACjD,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACvC,GACD,WAAW,CAAC,CAAC,CAAC,CAAA;AAEpB;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAAI,IAAI,EAAE,MAAM,SAAS,CAAC,IAAI,CAAC,KAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAoD/F,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.js

@@ -0,0 +1,29 @@
+import { getRaw as i } from "@scalar/json-magic/magic-proxy";
+const n = (a) => {
+  const o = /* @__PURE__ */ new WeakSet(), f = (e) => {
+    if (e == null || typeof e != "object")
+      return e;
+    const t = i(e);
+    if (o.has(t))
+      return "[circular]";
+    if (o.add(t), typeof e == "object" && e !== null && "$ref" in e) {
+      const l = e["$ref-value"], s = f(l);
+      return o.delete(t), s;
+    }
+    if (Array.isArray(e)) {
+      const l = e.map((s) => f(s));
+      return o.delete(t), l;
+    }
+    if (typeof e == "object" && e !== null) {
+      const l = {};
+      for (const [s, d] of Object.entries(e))
+        l[s] = f(d);
+      return o.delete(t), l;
+    }
+    return o.delete(t), e;
+  };
+  return f(a);
+};
+export {
+  n as getResolvedRefDeep
+};

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-resolved-ref-deep.test.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-resolved-ref-deep.test.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.test.ts"],"names":[],"mappings":""}

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.d.ts

@@ -0,0 +1,4 @@
+import type { SecuritySchemeObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+/** Extract secrets from security schemes */
+export declare const getSecrets: (securitySchemes: SecuritySchemeObject[]) => string[];
+//# sourceMappingURL=get-secrets.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-secrets.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-secrets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAA;AAGxG,4CAA4C;AAC5C,eAAO,MAAM,UAAU,GAAI,iBAAiB,oBAAoB,EAAE,KAAG,MAAM,EAqBvD,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.js

@@ -0,0 +1,10 @@
+import { encode as e } from "js-base64";
+const l = (t) => t.flatMap((r) => r.type === "apiKey" ? r["x-scalar-secret-token"] : r?.type === "http" ? [
+  r["x-scalar-secret-token"],
+  r["x-scalar-secret-username"],
+  r["x-scalar-secret-password"],
+  e(`${r["x-scalar-secret-username"]}:${r["x-scalar-secret-password"]}`)
+] : r.type === "oauth2" ? Object.values(r.flows).map((a) => a["x-scalar-secret-token"]) : []).filter(Boolean);
+export {
+  l as getSecrets
+};

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-secrets.test.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/get-secrets.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-secrets.test.d.ts","sourceRoot":"","sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-secrets.test.ts"],"names":[],"mappings":""}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.d.ts

@@ -0,0 +1,7 @@
+import type { ParameterObject, RequestBodyObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+/**
+ * Resolve an example value for a parameter or requestBody from either `examples` or `content.*.examples`.
+ * Or the [deprecated] `example` field.
+ */
+export declare const getExampleValue: (param: ParameterObject | RequestBodyObject, example?: string, contentType?: string) => unknown;
+//# sourceMappingURL=get-example-value.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-example-value.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,8DAA8D,CAAA;AAItH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,eAAe,GAAG,iBAAiB,EAC1C,UAAU,MAAM,EAChB,cAAc,MAAM,KACnB,OA8CF,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.js

@@ -0,0 +1,28 @@
+import { getResolvedRefDeep as l } from "../get-resolved-ref-deep.js";
+const f = (e, s, i) => {
+  if (s && "examples" in e && e.examples) {
+    const n = l(e.examples[s])?.value;
+    if (n)
+      return n;
+  }
+  if ("content" in e && e.content) {
+    const n = i ?? Object.keys(e.content)[0], t = e.content[n ?? ""];
+    if (t?.examples) {
+      const x = s ?? Object.keys(t.examples)[0], o = l(t.examples[x ?? ""]);
+      if (o)
+        return o.value;
+    }
+    if (t?.example !== void 0)
+      return t.example;
+  }
+  if ("example" in e && e.example !== void 0)
+    return e.example;
+  if ("examples" in e && e.examples) {
+    const n = Object.keys(e.examples)[0] ?? "", t = l(e.examples[n])?.value;
+    if (t)
+      return t;
+  }
+};
+export {
+  f as getExampleValue
+};

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=get-example-value.test.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-example-value.test.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/get-example-value.test.ts"],"names":[],"mappings":""}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.d.ts

@@ -0,0 +1,52 @@
+import type { HttpMethod } from '@scalar/helpers/http/http-methods';
+import type { OperationObject, SecuritySchemeObject, ServerObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { Request as HarRequest } from 'har-format';
+export type OperationToHarProps = {
+    /** OpenAPI Operation object */
+    operation: OperationObject;
+    /** HTTP method of the operation */
+    method: HttpMethod;
+    /** Path of the operation */
+    path: string;
+    /**
+     * Name of the currently selected operation example
+     *
+     * Applies to both the body and the parameters
+     */
+    example?: string;
+    /**
+     * Content type of the operation
+     *
+     * Applies to both the body and the parameters (if applicable)
+     * @defaults to the first content type in the MediaTypeObject
+     */
+    contentType?: string;
+    /** OpenAPI Server object */
+    server?: ServerObject | undefined;
+    /** OpenAPI SecurityScheme objects which are applicable to the operation */
+    securitySchemes?: SecuritySchemeObject[];
+};
+/**
+ * Converts an OpenAPI Operation to a HarRequest format for generating HTTP request snippets.
+ *
+ * This function transforms OpenAPI 3.1 operation objects into HAR (HTTP Archive) format requests,
+ * which can be used to generate code snippets for various programming languages and HTTP clients.
+ *
+ * The conversion handles:
+ * - Server URL processing and path parameter substitution
+ * - Query parameter formatting based on OpenAPI parameter styles
+ * - Request body processing with content type handling
+ * - Security scheme integration (API keys, etc.)
+ *
+ * The resulting HarRequest object follows the HAR specification and includes:
+ * - HTTP method and URL
+ * - Headers and query parameters
+ * - Request body (if present)
+ * - Cookie information
+ * - Size calculations for headers and body
+ *
+ * @see https://w3c.github.io/web-performance/specs/HAR/Overview.html
+ * @see https://spec.openapis.org/oas/v3.1.0#operation-object
+ */
+export declare const operationToHar: ({ operation, contentType, method, path, server, example, securitySchemes, }: OperationToHarProps) => HarRequest;
+//# sourceMappingURL=operation-to-har.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-to-har.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAA;AAEnE,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACb,MAAM,8DAA8D,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAOvD,MAAM,MAAM,mBAAmB,GAAG;IAChC,+BAA+B;IAC/B,SAAS,EAAE,eAAe,CAAA;IAC1B,mCAAmC;IACnC,MAAM,EAAE,UAAU,CAAA;IAClB,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;IACjC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,oBAAoB,EAAE,CAAA;CACzC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,cAAc,GAAI,6EAQ5B,mBAAmB,KAAG,UA6ExB,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.js

@@ -0,0 +1,59 @@
+import { getResolvedRef as y } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { processBody as f } from "./process-body.js";
+import { processParameters as l } from "./process-parameters.js";
+import { processSecuritySchemes as S } from "./process-security-schemes.js";
+import { processServerUrl as g } from "./process-server-url.js";
+const b = ({
+  operation: t,
+  contentType: a,
+  method: h,
+  path: i,
+  server: n,
+  example: p,
+  securitySchemes: m
+}) => {
+  const e = {
+    method: h,
+    url: i,
+    headers: [],
+    queryString: [],
+    postData: void 0,
+    httpVersion: "HTTP/1.1",
+    cookies: [],
+    headersSize: -1,
+    bodySize: -1
+  };
+  if (n?.url && (e.url = g(n, i)), t.parameters) {
+    const { url: r, headers: o, queryString: s, cookies: c } = l({
+      harRequest: e,
+      parameters: t.parameters,
+      example: p,
+      contentType: a
+    });
+    e.url = r, e.headers = o, e.queryString = s, e.cookies = c;
+  }
+  const u = y(t.requestBody);
+  if (u?.content) {
+    const r = f({ requestBody: u, contentType: a, example: p });
+    if (e.postData = r, e.bodySize = r.text?.length ?? -1, r.mimeType) {
+      const o = e.headers.find(
+        (s) => s.name.toLowerCase() === "content-type"
+      );
+      o && !o.value ? o.value = r.mimeType : e.headers.push({
+        name: "Content-Type",
+        value: r.mimeType
+      });
+    }
+  }
+  if (m) {
+    const { headers: r, queryString: o, cookies: s } = S(m);
+    e.headers.push(...r), e.queryString.push(...o), e.cookies.push(...s);
+  }
+  let d = 0;
+  for (const r of e.headers)
+    d += (r.name?.length ?? 0) + 2 + (r.value?.length ?? 0) + 2;
+  return e.headersSize = d, e;
+};
+export {
+  b as operationToHar
+};

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operation-to-har.test.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-to-har.test.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/operation-to-har.test.ts"],"names":[],"mappings":""}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.d.ts

@@ -0,0 +1,12 @@
+import type { RequestBodyObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { PostData } from 'har-format';
+import type { OperationToHarProps } from './operation-to-har.js';
+type ProcessBodyProps = Pick<OperationToHarProps, 'contentType' | 'example'> & {
+    requestBody: RequestBodyObject;
+};
+/**
+ * Processes the request body and returns the processed data
+ */
+export declare const processBody: ({ requestBody, contentType, example }: ProcessBodyProps) => PostData;
+export {};
+//# sourceMappingURL=process-body.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-body.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8DAA8D,CAAA;AAErG,OAAO,KAAK,EAAS,QAAQ,EAAE,MAAM,YAAY,CAAA;AAGjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAE7D,KAAK,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,aAAa,GAAG,SAAS,CAAC,GAAG;IAC7E,WAAW,EAAE,iBAAiB,CAAA;CAC/B,CAAA;AAoCD;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,uCAAuC,gBAAgB,KAAG,QAoErF,CAAA"}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.js

@@ -0,0 +1,57 @@
+import { json2xml as s } from "@scalar/helpers/file/json2xml";
+import { getResolvedRef as c } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { getExampleFromSchema as l } from "../get-example-from-schema.js";
+import { getExampleValue as u } from "./get-example-value.js";
+const p = (i) => {
+  const n = [];
+  for (const [a, e] of Object.entries(i))
+    if (e != null)
+      if (Array.isArray(e))
+        for (const m of e)
+          n.push({ name: a, value: String(m) });
+      else if (typeof e == "object") {
+        const m = p(e);
+        for (const r of m)
+          n.push({ name: `${a}.${r.name}`, value: r.value });
+      } else
+        n.push({ name: a, value: String(e) });
+  return n;
+}, b = ({ requestBody: i, contentType: n, example: a }) => {
+  const e = n || Object.keys(i.content)[0] || "", m = e === "multipart/form-data" || e === "application/x-www-form-urlencoded", r = e === "application/xml", t = u(i, a, n);
+  if (typeof t < "u")
+    return m && typeof t == "object" && t !== null ? {
+      mimeType: e,
+      params: p(t)
+    } : r && typeof t == "object" && t !== null ? {
+      mimeType: e,
+      text: s(t)
+    } : {
+      mimeType: e,
+      text: JSON.stringify(t)
+    };
+  const f = c(i.content[e]?.schema);
+  if (typeof f < "u") {
+    const o = l(f, {
+      mode: "write",
+      xml: r
+    });
+    if (o !== void 0)
+      return m && typeof o == "object" && o !== null ? {
+        mimeType: e,
+        params: p(o)
+      } : r && typeof o == "object" && o !== null ? {
+        mimeType: e,
+        text: s(o)
+      } : {
+        mimeType: e,
+        text: JSON.stringify(o)
+      };
+  }
+  return {
+    mimeType: e,
+    text: "null"
+  };
+};
+export {
+  b as processBody
+};

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=process-body.test.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-body.test.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-body.test.ts"],"names":[],"mappings":""}

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-parameters.d.ts

@@ -0,0 +1,25 @@
+import type { OperationObject, ParameterObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document';
+import type { Request as HarRequest } from 'har-format';
+type ProcessedParameters = {
+    url: string;
+    headers: HarRequest['headers'];
+    queryString: HarRequest['queryString'];
+    cookies: HarRequest['cookies'];
+};
+/** Ensures we don't have any references in the parameters */
+export declare const deReferenceParams: (params: OperationObject["parameters"]) => ParameterObject[];
+/**
+ * Process OpenAPI parameters and return the updated properties.
+ * Handles path, query, and header parameters with various styles and explode options.
+ *
+ * @see https://spec.openapis.org/oas/latest.html#style-values
+ */
+export declare const processParameters: ({ harRequest, parameters, example, contentType, }: {
+    harRequest: HarRequest;
+    parameters: OperationObject["parameters"];
+    /** The name of the example to use */
+    example?: string | undefined;
+    contentType?: string | undefined;
+}) => ProcessedParameters;
+export {};
+//# sourceMappingURL=process-parameters.d.ts.map

package/dist/v2/blocks/operation-code-sample/helpers/operation-to-har/process-parameters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-parameters.d.ts","sourceRoot":"","sources":["../../../../../../src/v2/blocks/operation-code-sample/helpers/operation-to-har/process-parameters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,8DAA8D,CAAA;AAEpH,OAAO,KAAK,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,YAAY,CAAA;AAIvD,KAAK,mBAAmB,GAAG;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAC9B,WAAW,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IACtC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CAC/B,CAAA;AAED,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,GAAI,QAAQ,eAAe,CAAC,YAAY,CAAC,KAAG,eAAe,EACnC,CAAA;AA0DtD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,mDAK/B;IACD,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAA;IACzC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACjC,KAAG,mBAsNH,CAAA"}