@scalar/api-client 2.38.3 → 2.39.0

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

@@ -0,0 +1,31 @@
+import { generateCustomId } from "./generate-client-options.js";
+//#region src/v2/blocks/operation-code-sample/helpers/get-clients.ts
+/**
+* Merges custom code samples with the client options
+*
+* @param customCodeSamples - The custom code samples from the operation to merge with the client options
+* @param clientOptions - The client options to merge with the custom code samples
+* @returns A list of client option groups
+*/
+var getClients = (customCodeSamples, clientOptions) => {
+	if (customCodeSamples.length) return [{
+		label: "Code Examples",
+		key: "custom",
+		options: customCodeSamples.map((sample) => {
+			const id = generateCustomId(sample);
+			const label = sample.label || sample.lang || id;
+			return {
+				id,
+				lang: sample.lang || "plaintext",
+				title: label,
+				label,
+				clientKey: "custom"
+			};
+		})
+	}, ...clientOptions];
+	return clientOptions;
+};
+//#endregion
+export { getClients };
+
+//# sourceMappingURL=get-clients.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-clients.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-clients.ts"],"sourcesContent":["import type { TargetId } from '@scalar/types/snippetz'\nimport type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\n\nimport type { ClientOptionGroup, CustomClientOption } from '@/v2/blocks/operation-code-sample'\nimport { generateCustomId } from '@/v2/blocks/operation-code-sample/helpers/generate-client-options'\nimport type { CustomClientOptionGroup } from '@/v2/blocks/operation-code-sample/types'\n\n/**\n * Merges custom code samples with the client options\n *\n * @param customCodeSamples - The custom code samples from the operation to merge with the client options\n * @param clientOptions - The client options to merge with the custom code samples\n * @returns A list of client option groups\n */\nexport const getClients = (\n  customCodeSamples: XCodeSample[],\n  clientOptions: ClientOptionGroup[],\n): CustomClientOptionGroup[] => {\n  // Handle custom code examples\n  if (customCodeSamples.length) {\n    const customClients = customCodeSamples.map((sample) => {\n      const id = generateCustomId(sample)\n      const label = sample.label || sample.lang || id\n      const lang = (sample.lang as TargetId) || 'plaintext'\n\n      return {\n        id,\n        lang,\n        title: label,\n        label,\n        clientKey: 'custom',\n      } satisfies CustomClientOption\n    })\n\n    return [\n      {\n        label: 'Code Examples',\n        key: 'custom',\n        options: customClients,\n      },\n      ...clientOptions,\n    ]\n  }\n\n  return clientOptions\n}\n"],"mappings":";;;;;;;;;AAcA,IAAa,cACX,mBACA,kBAC8B;AAE9B,KAAI,kBAAkB,OAepB,QAAO,CACL;EACE,OAAO;EACP,KAAK;EACL,SAlBkB,kBAAkB,KAAK,WAAW;GACtD,MAAM,KAAK,iBAAiB,OAAO;GACnC,MAAM,QAAQ,OAAO,SAAS,OAAO,QAAQ;AAG7C,UAAO;IACL;IACA,MAJY,OAAO,QAAqB;IAKxC,OAAO;IACP;IACA,WAAW;IACZ;IACD;EAOC,EACD,GAAG,cACJ;AAGH,QAAO"}

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

@@ -0,0 +1,18 @@
+//#region src/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.ts
+/**
+* Grabs any custom code samples from the operation
+*
+* @param operation - The operation to get the custom code samples from
+* @returns An array of custom code samples which exist in the operation
+*/
+var getCustomCodeSamples = (operation) => {
+	return [
+		"x-custom-examples",
+		"x-codeSamples",
+		"x-code-samples"
+	].flatMap((key) => operation[key] ?? []);
+};
+//#endregion
+export { getCustomCodeSamples };
+
+//# sourceMappingURL=get-custom-code-samples.js.map

package/dist/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-custom-code-samples.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-custom-code-samples.ts"],"sourcesContent":["import type { XCodeSample } from '@scalar/workspace-store/schemas/extensions/operation'\nimport type { OperationObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\n/**\n * Grabs any custom code samples from the operation\n *\n * @param operation - The operation to get the custom code samples from\n * @returns An array of custom code samples which exist in the operation\n */\nexport const getCustomCodeSamples = (operation: OperationObject): XCodeSample[] => {\n  const customCodeKeys = ['x-custom-examples', 'x-codeSamples', 'x-code-samples'] as const\n  return customCodeKeys.flatMap((key) => operation[key] ?? [])\n}\n"],"mappings":";;;;;;;AASA,IAAa,wBAAwB,cAA8C;AAEjF,QADuB;EAAC;EAAqB;EAAiB;EAAiB,CACzD,SAAS,QAAQ,UAAU,QAAQ,EAAE,CAAC"}

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

@@ -0,0 +1,411 @@
+import { isDefined } from "@scalar/helpers/array/is-defined";
+import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
+import { resolve } from "@scalar/workspace-store/resolve";
+//#region src/v2/blocks/operation-code-sample/helpers/get-example-from-schema.ts
+/** Maximum recursion depth to prevent infinite loops in circular references */
+var MAX_LEVELS_DEEP = 10;
+/** Default name used for additional properties when no custom name is provided */
+var DEFAULT_ADDITIONAL_PROPERTIES_NAME = "additionalProperty";
+/**
+* Pre-computed date/time values to avoid expensive Date operations on every call.
+* These are calculated once at module load time for better performance.
+*/
+var currentISOString = (/* @__PURE__ */ new Date()).toISOString();
+var currentDateString = currentISOString.split("T")[0];
+var currentTimeString = currentISOString.split("T")[1].split(".")[0];
+/**
+* Mapping of OpenAPI string formats to example values.
+* Used to generate realistic examples for different string formats.
+*/
+var genericExampleValues = {
+	"date-time": currentISOString,
+	"date": currentDateString,
+	"email": "hello@example.com",
+	"hostname": "example.com",
+	"idn-email": "jane.doe@example.com",
+	"idn-hostname": "example.com",
+	"ipv4": "127.0.0.1",
+	"ipv6": "51d4:7fab:bfbf:b7d7:b2cb:d4b4:3dad:d998",
+	"iri-reference": "/entitiy/1",
+	"iri": "https://example.com/entity/123",
+	"json-pointer": "/nested/objects",
+	"password": "super-secret",
+	"regex": "/[a-z]/",
+	"relative-json-pointer": "1/nested/objects",
+	"time": currentTimeString,
+	"uri-reference": "../folder",
+	"uri-template": "https://example.com/{id}",
+	"uri": "https://example.com",
+	"uuid": "123e4567-e89b-12d3-a456-426614174000",
+	"object-id": "6592008029c8c3e4dc76256c"
+};
+/**
+* Extract enum values from the propertyNames keyword of an object schema.
+* JSON Schema's propertyNames constrains which keys are valid in a map/dict.
+*/
+var getPropertyNamesEnumValues = (schema) => {
+	if (!("propertyNames" in schema) || !schema.propertyNames) return;
+	const resolved = resolve.schema(schema.propertyNames);
+	if (resolved && "enum" in resolved && Array.isArray(resolved.enum) && resolved.enum.length > 0) return resolved.enum;
+};
+/**
+* Generate example values for string types based on their format.
+* Special handling for binary format which returns a File object.
+*/
+var guessFromFormat = (schema, makeUpRandomData = false, fallback = "") => {
+	if ("type" in schema && schema.type === "string" && "format" in schema && schema.format === "binary") return "@filename";
+	if (makeUpRandomData && "format" in schema && schema.format) return genericExampleValues[schema.format] ?? fallback;
+	return fallback;
+};
+/**
+* WeakMap cache for memoizing resolved example results.
+* Uses the resolved schema object as the key for efficient lookups.
+*/
+var resultCache = /* @__PURE__ */ new WeakMap();
+/** Cache required property names per parent schema for O(1) membership checks */
+var requiredNamesCache = /* @__PURE__ */ new WeakMap();
+/** Normalize schema identity for cache and cycle tracking */
+var getSchemaCacheTarget = (schema) => unpackProxyObject(schema, { depth: 1 });
+/**
+* Retrieves the set of required property names from a schema.
+* Caches the result in a WeakMap for efficient lookups.
+*/
+var getRequiredNames = (parentSchema) => {
+	if (!parentSchema) return;
+	const cached = requiredNamesCache.get(parentSchema);
+	if (cached) return cached;
+	if ("required" in parentSchema) {
+		const required = parentSchema.required;
+		if (Array.isArray(required) && required.length > 0) {
+			const set = new Set(required);
+			requiredNamesCache.set(parentSchema, set);
+			return set;
+		}
+	}
+};
+/**
+* Cache the result for a schema if it is an object type.
+* Primitive values are not cached to avoid unnecessary WeakMap operations.
+* Stores a map of cacheKey strings which is made up of the options object.
+*/
+var cache = (schema, result, cacheKey) => {
+	if (typeof result !== "object" || result === null) return result;
+	const rawSchema = getSchemaCacheTarget(schema);
+	const cacheMap = resultCache.get(rawSchema) ?? /* @__PURE__ */ new Map();
+	if (cacheMap) cacheMap.set(cacheKey, result);
+	resultCache.set(rawSchema, cacheMap);
+	return result;
+};
+/**
+* Check if a schema uses composition keywords (allOf, oneOf, anyOf).
+* These require special handling for merging or selecting schemas.
+*/
+var isComposed = (schema) => !!(schema.allOf || schema.oneOf || schema.anyOf);
+/**
+* Determine if a property should be omitted based on the options.
+* Properties are omitted if they are not required and the option is enabled.
+*/
+var shouldOmitProperty = (schema, parentSchema, propertyName, options) => {
+	if (schema.deprecated || options?.mode === "write" && schema.readOnly || options?.mode === "read" && schema.writeOnly) return true;
+	if (options?.omitEmptyAndOptionalProperties !== true) return false;
+	if ("type" in schema && (schema.type === "object" || schema.type === "array") || isComposed(schema)) return false;
+	if ("examples" in schema && Array.isArray(schema.examples) && schema.examples.length > 0 || "example" in schema && schema.example !== void 0 || "default" in schema && schema.default !== void 0 || "const" in schema && schema.const !== void 0 || "enum" in schema && Array.isArray(schema.enum) && schema.enum.length > 0) return false;
+	const name = propertyName ?? schema.title ?? "";
+	const requiredNames = getRequiredNames(parentSchema);
+	return !(requiredNames ? requiredNames.has(name) : false);
+};
+/**
+* Merge two example values with predictable semantics.
+* Arrays are concatenated, objects are merged, otherwise the new value wins.
+*/
+var mergeExamples = (baseValue, newValue) => {
+	if (Array.isArray(baseValue) && Array.isArray(newValue)) return [...baseValue, ...newValue];
+	if (baseValue && typeof baseValue === "object" && newValue && typeof newValue === "object") return {
+		...baseValue,
+		...newValue
+	};
+	return newValue;
+};
+/**
+* Build an example for an object schema, including properties, patternProperties,
+* additionalProperties, and composition (allOf/oneOf/anyOf) merging.
+*/
+var handleObjectSchema = (schema, options, level, seen, cacheKey) => {
+	const response = {};
+	if ("properties" in schema && schema.properties) {
+		const propertyNames = Object.keys(schema.properties);
+		const limit = propertyNames.length;
+		for (let i = 0; i < limit; i++) {
+			const propertyName = propertyNames[i];
+			const propertySchema = resolve.schema(schema.properties[propertyName]);
+			if (!propertySchema) continue;
+			const propertyXmlName = options?.xml && "xml" in propertySchema ? propertySchema.xml?.name : void 0;
+			const value = getExampleFromSchema(propertySchema, options, {
+				level: level + 1,
+				parentSchema: schema,
+				name: propertyName,
+				seen
+			});
+			if (typeof value !== "undefined") response[propertyXmlName ?? propertyName] = value;
+		}
+	}
+	if ("patternProperties" in schema && schema.patternProperties) for (const pattern of Object.keys(schema.patternProperties)) {
+		const propertySchema = resolve.schema(schema.patternProperties[pattern]);
+		if (!propertySchema) continue;
+		response[pattern] = getExampleFromSchema(propertySchema, options, {
+			level: level + 1,
+			parentSchema: schema,
+			name: pattern,
+			seen
+		});
+	}
+	if ("additionalProperties" in schema && schema.additionalProperties) {
+		const additional = typeof schema.additionalProperties === "boolean" ? schema.additionalProperties : resolve.schema(schema.additionalProperties);
+		const isAnyType = schema.additionalProperties === true || typeof schema.additionalProperties === "object" && Object.keys(schema.additionalProperties).length === 0;
+		const hasCustomName = typeof additional === "object" && "x-additionalPropertiesName" in additional && typeof additional["x-additionalPropertiesName"] === "string" && additional["x-additionalPropertiesName"].trim().length > 0;
+		const propertyNamesEnum = hasCustomName ? void 0 : getPropertyNamesEnumValues(schema);
+		const additionalName = hasCustomName ? additional["x-additionalPropertiesName"].trim() : DEFAULT_ADDITIONAL_PROPERTIES_NAME;
+		const additionalValue = isAnyType ? "anything" : typeof additional === "object" ? getExampleFromSchema(additional, options, {
+			level: level + 1,
+			seen
+		}) : "anything";
+		if (propertyNamesEnum && propertyNamesEnum.length > 0) response[String(propertyNamesEnum[0])] = additionalValue;
+		else response[additionalName] = additionalValue;
+	}
+	if (schema.oneOf?.[0]) Object.assign(response, getExampleFromSchema(resolve.schema(schema.oneOf[0]), options, {
+		level: level + 1,
+		seen
+	}));
+	else if (schema.anyOf?.[0]) Object.assign(response, getExampleFromSchema(resolve.schema(schema.anyOf[0]), options, {
+		level: level + 1,
+		seen
+	}));
+	else if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {
+		let merged = response;
+		for (const item of schema.allOf) {
+			const ex = getExampleFromSchema(resolve.schema(item), options, {
+				level: level + 1,
+				parentSchema: schema,
+				seen
+			});
+			merged = mergeExamples(merged, ex);
+		}
+		if (merged && typeof merged === "object") Object.assign(response, merged);
+	}
+	if (options?.xml && "xml" in schema && schema.xml?.name && level === 0) {
+		const wrapped = {};
+		wrapped[schema.xml.name] = response;
+		return cache(schema, wrapped, cacheKey);
+	}
+	return cache(schema, response, cacheKey);
+};
+/** Build an example for an array schema, including items, allOf, oneOf/anyOf, and XML wrapping */
+var handleArraySchema = (schema, options, level, seen, cacheKey) => {
+	const items = "items" in schema ? resolve.schema(schema.items) : void 0;
+	const itemsXmlTagName = items && typeof items === "object" && "xml" in items ? items.xml?.name : void 0;
+	const wrapItems = !!(options?.xml && "xml" in schema && schema.xml?.wrapped && itemsXmlTagName);
+	if (schema.example !== void 0) return cache(schema, wrapItems ? { [itemsXmlTagName]: schema.example } : schema.example, cacheKey);
+	if (items && typeof items === "object") {
+		if (Array.isArray(items.allOf) && items.allOf.length > 0) {
+			const allOf = items.allOf.filter(isDefined);
+			const first = resolve.schema(allOf[0]);
+			if (first && typeof first === "object" && "type" in first && first.type === "object") {
+				const merged = getExampleFromSchema({
+					type: "object",
+					allOf
+				}, options, {
+					level: level + 1,
+					parentSchema: schema,
+					seen
+				});
+				return cache(schema, wrapItems ? [{ [itemsXmlTagName]: merged }] : [merged], cacheKey);
+			}
+			const examples = allOf.map((s) => getExampleFromSchema(resolve.schema(s), options, {
+				level: level + 1,
+				parentSchema: schema,
+				seen
+			})).filter(isDefined);
+			return cache(schema, wrapItems ? examples.map((e) => ({ [itemsXmlTagName]: e })) : examples, cacheKey);
+		}
+		const union = items.anyOf || items.oneOf;
+		if (union && union.length > 0) {
+			const first = union[0];
+			const ex = getExampleFromSchema(resolve.schema(first), options, {
+				level: level + 1,
+				parentSchema: schema,
+				seen
+			});
+			return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey);
+		}
+	}
+	const isObject = items && typeof items === "object" && ("type" in items && items.type === "object" || "properties" in items);
+	const isArray = items && typeof items === "object" && ("type" in items && items.type === "array" || "items" in items);
+	if (items && typeof items === "object" && ("type" in items && items.type || isObject || isArray)) {
+		const ex = getExampleFromSchema(items, options, {
+			level: level + 1,
+			seen
+		});
+		return cache(schema, wrapItems ? [{ [itemsXmlTagName]: ex }] : [ex], cacheKey);
+	}
+	return cache(schema, [], cacheKey);
+};
+/** Return primitive example value for single-type schemas, or undefined if not primitive */
+var getPrimitiveValue = (schema, makeUpRandomData, emptyString) => {
+	if ("type" in schema && schema.type && !Array.isArray(schema.type)) switch (schema.type) {
+		case "string": return guessFromFormat(schema, makeUpRandomData, emptyString ?? "");
+		case "boolean": return true;
+		case "integer": return "minimum" in schema && typeof schema.minimum === "number" ? schema.minimum : 1;
+		case "number": return "minimum" in schema && typeof schema.minimum === "number" ? schema.minimum : 1;
+		case "array": return [];
+		default: return;
+	}
+};
+/** Return primitive example value for union-type schemas (type: string[]) */
+var getUnionPrimitiveValue = (schema, makeUpRandomData, emptyString) => {
+	if ("type" in schema && Array.isArray(schema.type)) {
+		if (schema.type.includes("null")) return null;
+		const first = schema.type[0];
+		if (first) switch (first) {
+			case "string": return guessFromFormat(schema, makeUpRandomData, emptyString ?? "");
+			case "boolean": return true;
+			case "integer": return "minimum" in schema && typeof schema.minimum === "number" ? schema.minimum : 1;
+			case "number": return "minimum" in schema && typeof schema.minimum === "number" ? schema.minimum : 1;
+			case "null": return null;
+			default: return;
+		}
+	}
+};
+/** Create stable cache key from the options object */
+var createOptionsCacheKey = (options) => JSON.stringify({
+	emptyString: options?.emptyString,
+	xml: options?.xml,
+	mode: options?.mode,
+	variables: options?.variables,
+	omitEmptyAndOptionalProperties: options?.omitEmptyAndOptionalProperties
+});
+/**
+* Generate an example value from a given OpenAPI SchemaObject.
+*
+* This function recursively processes OpenAPI schemas to create realistic example data.
+* It handles all OpenAPI schema types including primitives, objects, arrays, and
+* composition schemas (allOf, oneOf, anyOf).
+* Uses a tonne of caching for maximum performance.
+*
+* @param schema - The OpenAPI SchemaObject to generate an example from.
+* @param options - Options to customize example generation.
+* @param level - The current recursion depth.
+* @param parentSchema - The parent schema, if any.
+* @param name - The name of the property being processed.
+* @returns An example value for the given schema.
+*/
+var getExampleFromSchema = (schema, options, { level = 0, parentSchema, name, seen = /* @__PURE__ */ new WeakSet() } = {}) => {
+	const _schema = resolve.schema(schema);
+	if (!isDefined(_schema)) return;
+	const targetValue = getSchemaCacheTarget(_schema);
+	if (seen.has(targetValue)) return;
+	seen.add(targetValue);
+	/** Make the cache key unique per options */
+	const cacheKey = createOptionsCacheKey(options);
+	const cached = resultCache.get(targetValue)?.get(cacheKey);
+	if (typeof cached !== "undefined") {
+		seen.delete(targetValue);
+		return cached;
+	}
+	if (level > MAX_LEVELS_DEEP) {
+		seen.delete(targetValue);
+		return "[Max Depth Exceeded]";
+	}
+	const makeUpRandomData = !!options?.emptyString;
+	if (shouldOmitProperty(_schema, parentSchema, name, options)) {
+		seen.delete(targetValue);
+		return;
+	}
+	if ("x-variable" in _schema && _schema["x-variable"]) {
+		const value = options?.variables?.[_schema["x-variable"]];
+		if (value !== void 0) {
+			if ("type" in _schema && (_schema.type === "number" || _schema.type === "integer")) {
+				seen.delete(targetValue);
+				return cache(_schema, Number(value), cacheKey);
+			}
+			seen.delete(targetValue);
+			return cache(_schema, value, cacheKey);
+		}
+	}
+	if (Array.isArray(_schema.examples) && _schema.examples.length > 0) {
+		seen.delete(targetValue);
+		return cache(_schema, _schema.examples[0], cacheKey);
+	}
+	if (_schema.example !== void 0) {
+		seen.delete(targetValue);
+		return cache(_schema, _schema.example, cacheKey);
+	}
+	if (_schema.default !== void 0) {
+		seen.delete(targetValue);
+		return cache(_schema, _schema.default, cacheKey);
+	}
+	if (_schema.const !== void 0) {
+		seen.delete(targetValue);
+		return cache(_schema, _schema.const, cacheKey);
+	}
+	if (Array.isArray(_schema.enum) && _schema.enum.length > 0) {
+		seen.delete(targetValue);
+		return cache(_schema, _schema.enum[0], cacheKey);
+	}
+	if ("properties" in _schema || "type" in _schema && _schema.type === "object") {
+		const result = handleObjectSchema(_schema, options, level, seen, cacheKey);
+		seen.delete(targetValue);
+		return result;
+	}
+	if ("type" in _schema && _schema.type === "array" || "items" in _schema) {
+		const result = handleArraySchema(_schema, options, level, seen, cacheKey);
+		seen.delete(targetValue);
+		return result;
+	}
+	const primitive = getPrimitiveValue(_schema, makeUpRandomData, options?.emptyString);
+	if (primitive !== void 0) {
+		seen.delete(targetValue);
+		return cache(_schema, primitive, cacheKey);
+	}
+	const discriminate = _schema.oneOf || _schema.anyOf;
+	if (Array.isArray(discriminate) && discriminate.length > 0) {
+		for (const item of discriminate) {
+			const resolved = resolve.schema(item);
+			if (resolved && (!("type" in resolved) || resolved.type !== "null")) {
+				seen.delete(targetValue);
+				return cache(_schema, getExampleFromSchema(resolved, options, {
+					level: level + 1,
+					seen
+				}), cacheKey);
+			}
+		}
+		seen.delete(targetValue);
+		return cache(_schema, null, cacheKey);
+	}
+	if (Array.isArray(_schema.allOf) && _schema.allOf.length > 0) {
+		let merged = void 0;
+		const items = _schema.allOf;
+		for (const item of items) {
+			const ex = getExampleFromSchema(item, options, {
+				level: level + 1,
+				parentSchema: _schema,
+				seen
+			});
+			if (merged === void 0) merged = ex;
+			else if (merged && typeof merged === "object" && ex && typeof ex === "object") merged = mergeExamples(merged, ex);
+			else if (ex !== void 0) merged = ex;
+		}
+		seen.delete(targetValue);
+		return cache(_schema, merged ?? null, cacheKey);
+	}
+	const unionPrimitive = getUnionPrimitiveValue(_schema, makeUpRandomData, options?.emptyString);
+	if (unionPrimitive !== void 0) {
+		seen.delete(targetValue);
+		return cache(_schema, unionPrimitive, cacheKey);
+	}
+	seen.delete(targetValue);
+	return cache(_schema, null, cacheKey);
+};
+//#endregion
+export { getExampleFromSchema };
+
+//# sourceMappingURL=get-example-from-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-example-from-schema.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-example-from-schema.ts"],"sourcesContent":["import { isDefined } from '@scalar/helpers/array/is-defined'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\nimport { resolve } from '@scalar/workspace-store/resolve'\nimport type { SchemaObject } from '@scalar/workspace-store/schemas/v3.1/strict/openapi-document'\n\n/** Maximum recursion depth to prevent infinite loops in circular references */\nconst MAX_LEVELS_DEEP = 10\n\n/** Default name used for additional properties when no custom name is provided */\nconst DEFAULT_ADDITIONAL_PROPERTIES_NAME = 'additionalProperty'\n\n/**\n * Pre-computed date/time values to avoid expensive Date operations on every call.\n * These are calculated once at module load time for better performance.\n */\nconst currentISOString = new Date().toISOString()\nconst currentDateString = currentISOString.split('T')[0]!\nconst currentTimeString = currentISOString.split('T')[1]!.split('.')[0]!\n\n/**\n * Mapping of OpenAPI string formats to example values.\n * Used to generate realistic examples for different string formats.\n */\nconst genericExampleValues: Record<string, string> = {\n  'date-time': currentISOString,\n  'date': currentDateString,\n  'email': 'hello@example.com',\n  'hostname': 'example.com',\n  // https://tools.ietf.org/html/rfc6531#section-3.3\n  'idn-email': 'jane.doe@example.com',\n  // https://tools.ietf.org/html/rfc5890#section-2.3.2.3\n  'idn-hostname': 'example.com',\n  'ipv4': '127.0.0.1',\n  'ipv6': '51d4:7fab:bfbf:b7d7:b2cb:d4b4:3dad:d998',\n  'iri-reference': '/entitiy/1',\n  // https://tools.ietf.org/html/rfc3987\n  'iri': 'https://example.com/entity/123',\n  'json-pointer': '/nested/objects',\n  'password': 'super-secret',\n  'regex': '/[a-z]/',\n  // https://tools.ietf.org/html/draft-handrews-relative-json-pointer-01\n  'relative-json-pointer': '1/nested/objects',\n  // full-time in https://tools.ietf.org/html/rfc3339#section-5.6\n  'time': currentTimeString,\n  // either a URI or relative-reference https://tools.ietf.org/html/rfc3986#section-4.1\n  'uri-reference': '../folder',\n  'uri-template': 'https://example.com/{id}',\n  'uri': 'https://example.com',\n  'uuid': '123e4567-e89b-12d3-a456-426614174000',\n  'object-id': '6592008029c8c3e4dc76256c',\n}\n\n/**\n * Extract enum values from the propertyNames keyword of an object schema.\n * JSON Schema's propertyNames constrains which keys are valid in a map/dict.\n */\nconst getPropertyNamesEnumValues = (schema: SchemaObject): unknown[] | undefined => {\n  if (!('propertyNames' in schema) || !schema.propertyNames) {\n    return undefined\n  }\n\n  const resolved = resolve.schema(schema.propertyNames as SchemaObject)\n  if (resolved && 'enum' in resolved && Array.isArray(resolved.enum) && resolved.enum.length > 0) {\n    return resolved.enum\n  }\n\n  return undefined\n}\n\n/**\n * Generate example values for string types based on their format.\n * Special handling for binary format which returns a File object.\n */\nconst guessFromFormat = (\n  schema: SchemaObject,\n  makeUpRandomData: boolean = false,\n  fallback: string = '',\n): string | File => {\n  // Handle binary format specially - return a File object\n  if ('type' in schema && schema.type === 'string' && 'format' in schema && schema.format === 'binary') {\n    return '@filename'\n  }\n\n  // Return format-specific example if we have one and are making up data\n  if (makeUpRandomData && 'format' in schema && schema.format) {\n    return genericExampleValues[schema.format] ?? fallback\n  }\n\n  return fallback\n}\n\n/**\n * WeakMap cache for memoizing resolved example results.\n * Uses the resolved schema object as the key for efficient lookups.\n */\nconst resultCache = new WeakMap<object, Map<string, unknown>>()\n\n/** Cache required property names per parent schema for O(1) membership checks */\nconst requiredNamesCache = new WeakMap<object, ReadonlySet<string>>()\n\n/** Normalize schema identity for cache and cycle tracking */\nconst getSchemaCacheTarget = (schema: SchemaObject): object => unpackProxyObject(schema, { depth: 1 }) as object\n\n/**\n * Retrieves the set of required property names from a schema.\n * Caches the result in a WeakMap for efficient lookups.\n */\nconst getRequiredNames = (parentSchema: SchemaObject | undefined): ReadonlySet<string> | undefined => {\n  if (!parentSchema) {\n    return undefined\n  }\n\n  const cached = requiredNamesCache.get(parentSchema)\n  if (cached) {\n    return cached\n  }\n\n  if ('required' in parentSchema) {\n    const required = parentSchema.required\n    if (Array.isArray(required) && required.length > 0) {\n      const set = new Set<string>(required)\n      requiredNamesCache.set(parentSchema, set)\n      return set\n    }\n  }\n\n  return undefined\n}\n\n/**\n * Cache the result for a schema if it is an object type.\n * Primitive values are not cached to avoid unnecessary WeakMap operations.\n * Stores a map of cacheKey strings which is made up of the options object.\n */\nconst cache = (schema: SchemaObject, result: unknown, cacheKey: string) => {\n  if (typeof result !== 'object' || result === null) {\n    return result\n  }\n  const rawSchema = getSchemaCacheTarget(schema)\n\n  const cacheMap = resultCache.get(rawSchema) ?? new Map()\n  if (cacheMap) {\n    cacheMap.set(cacheKey, result)\n  }\n  resultCache.set(rawSchema, cacheMap)\n  return result\n}\n\n/**\n * Check if a schema uses composition keywords (allOf, oneOf, anyOf).\n * These require special handling for merging or selecting schemas.\n */\nconst isComposed = (schema: SchemaObject): boolean => !!(schema.allOf || schema.oneOf || schema.anyOf)\n\n/**\n * Determine if a property should be omitted based on the options.\n * Properties are omitted if they are not required and the option is enabled.\n */\nconst shouldOmitProperty = (\n  schema: SchemaObject,\n  parentSchema: SchemaObject | undefined,\n  propertyName: string | undefined,\n  options: Pick<GetExampleFromSchemaOptions, 'omitEmptyAndOptionalProperties' | 'mode'> | undefined,\n): boolean => {\n  // Early exits for schemas that should not be included (deprecated, readOnly, writeOnly)\n  if (\n    schema.deprecated ||\n    (options?.mode === 'write' && schema.readOnly) ||\n    (options?.mode === 'read' && schema.writeOnly)\n  ) {\n    return true\n  }\n\n  if (options?.omitEmptyAndOptionalProperties !== true) {\n    return false\n  }\n\n  // Never omit container types (objects/arrays) or composed schemas\n  const isContainer = ('type' in schema && (schema.type === 'object' || schema.type === 'array')) || isComposed(schema)\n  if (isContainer) {\n    return false\n  }\n\n  // Do not omit if explicit example-like values are present\n  if (\n    ('examples' in schema && Array.isArray(schema.examples) && schema.examples.length > 0) ||\n    ('example' in schema && schema.example !== undefined) ||\n    ('default' in schema && schema.default !== undefined) ||\n    ('const' in schema && schema.const !== undefined) ||\n    ('enum' in schema && Array.isArray(schema.enum) && schema.enum.length > 0)\n  ) {\n    return false\n  }\n\n  // Check if the property is required\n  const name = propertyName ?? schema.title ?? ''\n  const requiredNames = getRequiredNames(parentSchema)\n  const isRequired = requiredNames ? requiredNames.has(name) : false\n\n  return !isRequired\n}\n\n/**\n * Merge two example values with predictable semantics.\n * Arrays are concatenated, objects are merged, otherwise the new value wins.\n */\nconst mergeExamples = (baseValue: unknown, newValue: unknown): unknown => {\n  if (Array.isArray(baseValue) && Array.isArray(newValue)) {\n    return [...baseValue, ...newValue]\n  }\n  if (baseValue && typeof baseValue === 'object' && newValue && typeof newValue === 'object') {\n    return { ...(baseValue as Record<string, unknown>), ...(newValue as Record<string, unknown>) }\n  }\n  return newValue\n}\n\n/**\n * Build an example for an object schema, including properties, patternProperties,\n * additionalProperties, and composition (allOf/oneOf/anyOf) merging.\n */\nconst handleObjectSchema = (\n  schema: SchemaObject,\n  options: Parameters<typeof getExampleFromSchema>[1],\n  level: number,\n  seen: WeakSet<object>,\n  cacheKey: string,\n): unknown => {\n  const response: Record<string, unknown> = {}\n\n  if ('properties' in schema && schema.properties) {\n    const propertyNames = Object.keys(schema.properties)\n    const limit = propertyNames.length\n\n    for (let i = 0; i < limit; i++) {\n      const propertyName = propertyNames[i]!\n      const propertySchema = resolve.schema(schema.properties[propertyName])\n      if (!propertySchema) {\n        continue\n      }\n\n      const propertyXmlName = options?.xml && 'xml' in propertySchema ? propertySchema.xml?.name : undefined\n      const value = getExampleFromSchema(propertySchema, options, {\n        level: level + 1,\n        parentSchema: schema,\n        name: propertyName,\n        seen,\n      })\n\n      if (typeof value !== 'undefined') {\n        response[propertyXmlName ?? propertyName] = value\n      }\n    }\n  }\n\n  if ('patternProperties' in schema && schema.patternProperties) {\n    for (const pattern of Object.keys(schema.patternProperties)) {\n      const propertySchema = resolve.schema(schema.patternProperties[pattern])\n      if (!propertySchema) {\n        continue\n      }\n      response[pattern] = getExampleFromSchema(propertySchema, options, {\n        level: level + 1,\n        parentSchema: schema,\n        name: pattern,\n        seen,\n      })\n    }\n  }\n\n  if ('additionalProperties' in schema && schema.additionalProperties) {\n    const additional =\n      typeof schema.additionalProperties === 'boolean'\n        ? schema.additionalProperties\n        : resolve.schema(schema.additionalProperties)\n    const isAnyType =\n      schema.additionalProperties === true ||\n      (typeof schema.additionalProperties === 'object' && Object.keys(schema.additionalProperties).length === 0)\n\n    // Check for explicit x-additionalPropertiesName first\n    const hasCustomName =\n      typeof additional === 'object' &&\n      'x-additionalPropertiesName' in additional &&\n      typeof additional['x-additionalPropertiesName'] === 'string' &&\n      additional['x-additionalPropertiesName'].trim().length > 0\n\n    // Use propertyNames enum values as example keys when no custom name is set\n    const propertyNamesEnum = hasCustomName ? undefined : getPropertyNamesEnumValues(schema)\n\n    const additionalName = hasCustomName\n      ? (additional as unknown as Record<string, string>)['x-additionalPropertiesName']!.trim()\n      : DEFAULT_ADDITIONAL_PROPERTIES_NAME\n\n    const additionalValue = isAnyType\n      ? 'anything'\n      : typeof additional === 'object'\n        ? getExampleFromSchema(additional, options, {\n            level: level + 1,\n            seen,\n          })\n        : 'anything'\n\n    if (propertyNamesEnum && propertyNamesEnum.length > 0) {\n      // Use the first enum value as a realistic example key\n      response[String(propertyNamesEnum[0])] = additionalValue\n    } else {\n      response[additionalName] = additionalValue\n    }\n  }\n\n  // onOf\n  if (schema.oneOf?.[0]) {\n    Object.assign(\n      response,\n      getExampleFromSchema(resolve.schema(schema.oneOf[0]), options, {\n        level: level + 1,\n        seen,\n      }),\n    )\n  }\n  // anyOf\n  else if (schema.anyOf?.[0]) {\n    Object.assign(\n      response,\n      getExampleFromSchema(resolve.schema(schema.anyOf[0]), options, {\n        level: level + 1,\n        seen,\n      }),\n    )\n  }\n  // allOf\n  else if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {\n    let merged: unknown = response\n    for (const item of schema.allOf) {\n      const ex = getExampleFromSchema(resolve.schema(item), options, {\n        level: level + 1,\n        parentSchema: schema,\n        seen,\n      })\n      merged = mergeExamples(merged, ex)\n    }\n    if (merged && typeof merged === 'object') {\n      Object.assign(response, merged as Record<string, unknown>)\n    }\n  }\n\n  if (options?.xml && 'xml' in schema && schema.xml?.name && level === 0) {\n    const wrapped: Record<string, unknown> = {}\n    wrapped[schema.xml.name] = response\n    return cache(schema, wrapped, cacheKey)\n  }\n\n  return cache(schema, response, cacheKey)\n}\n\n/** Build an example for an array schema, including items, allOf, oneOf/anyOf, and XML wrapping */\nconst handleArraySchema = (\n  schema: SchemaObject,\n  options: Parameters<typeof getExampleFromSchema>[1],\n  level: number,\n  seen: WeakSet<object>,\n  cacheKey: string,\n) => {\n  const items = 'items' in schema ? resolve.schema(schema.items) : undefined\n  const itemsXmlTagName = items && typeof items === 'object' && 'xml' in items ? items.xml?.name : undefined\n  const wrapItems = !!(options?.xml && 'xml' in schema && schema.xml?.wrapped && itemsXmlTagName)\n\n  if (schema.example !== undefined) {\n    return cache(schema, wrapItems ? { [itemsXmlTagName as string]: schema.example } : schema.example, cacheKey)\n  }\n\n  if (items && typeof items === 'object') {\n    if (Array.isArray(items.allOf) && items.allOf.length > 0) {\n      const allOf = items.allOf.filter(isDefined)\n      const first = resolve.schema(allOf[0])\n\n      if (first && typeof first === 'object' && 'type' in first && first.type === 'object') {\n        const combined: SchemaObject = { type: 'object', allOf }\n        const merged = getExampleFromSchema(combined, options, {\n          level: level + 1,\n          parentSchema: schema,\n          seen,\n        })\n        return cache(schema, wrapItems ? [{ [itemsXmlTagName as string]: merged }] : [merged], cacheKey)\n      }\n\n      const examples = allOf\n        .map((s) =>\n          getExampleFromSchema(resolve.schema(s), options, {\n            level: level + 1,\n            parentSchema: schema,\n            seen,\n          }),\n        )\n        .filter(isDefined)\n      return cache(\n        schema,\n        wrapItems ? (examples as unknown[]).map((e) => ({ [itemsXmlTagName as string]: e })) : examples,\n        cacheKey,\n      )\n    }\n\n    const union = items.anyOf || items.oneOf\n    if (union && union.length > 0) {\n      const first = union[0]!\n      const ex = getExampleFromSchema(resolve.schema(first), options, {\n        level: level + 1,\n        parentSchema: schema,\n        seen,\n      })\n      return cache(schema, wrapItems ? [{ [itemsXmlTagName as string]: ex }] : [ex], cacheKey)\n    }\n  }\n\n  const isObject =\n    items && typeof items === 'object' && (('type' in items && items.type === 'object') || 'properties' in items)\n  const isArray =\n    items && typeof items === 'object' && (('type' in items && items.type === 'array') || 'items' in items)\n\n  if (items && typeof items === 'object' && (('type' in items && items.type) || isObject || isArray)) {\n    const ex = getExampleFromSchema(items as SchemaObject, options, {\n      level: level + 1,\n      seen,\n    })\n    return cache(schema, wrapItems ? [{ [itemsXmlTagName as string]: ex }] : [ex], cacheKey)\n  }\n\n  return cache(schema, [], cacheKey)\n}\n\n/** Return primitive example value for single-type schemas, or undefined if not primitive */\nconst getPrimitiveValue = (schema: SchemaObject, makeUpRandomData: boolean, emptyString: string | undefined) => {\n  if ('type' in schema && schema.type && !Array.isArray(schema.type)) {\n    switch (schema.type) {\n      case 'string':\n        return guessFromFormat(schema, makeUpRandomData, emptyString ?? '')\n      case 'boolean':\n        return true\n      case 'integer':\n        return 'minimum' in schema && typeof schema.minimum === 'number' ? schema.minimum : 1\n      case 'number':\n        return 'minimum' in schema && typeof schema.minimum === 'number' ? schema.minimum : 1\n      case 'array':\n        return []\n      default:\n        return undefined\n    }\n  }\n  return undefined\n}\n\n/** Return primitive example value for union-type schemas (type: string[]) */\nconst getUnionPrimitiveValue = (schema: SchemaObject, makeUpRandomData: boolean, emptyString: string | undefined) => {\n  if ('type' in schema && Array.isArray(schema.type)) {\n    if (schema.type.includes('null')) {\n      return null\n    }\n\n    const first = schema.type[0]\n    if (first) {\n      switch (first) {\n        case 'string':\n          return guessFromFormat(schema, makeUpRandomData, emptyString ?? '')\n        case 'boolean':\n          return true\n        case 'integer':\n          return 'minimum' in schema && typeof schema.minimum === 'number' ? schema.minimum : 1\n        case 'number':\n          return 'minimum' in schema && typeof schema.minimum === 'number' ? schema.minimum : 1\n        case 'null':\n          return null\n        default:\n          return undefined\n      }\n    }\n  }\n  return undefined\n}\n\ntype GetExampleFromSchemaOptions = {\n  /** Fallback string for empty string values. */\n  emptyString?: string\n  /** Whether to use XML tag names as keys. */\n  xml?: boolean\n  /** Whether to show read-only/write-only properties. */\n  mode?: 'read' | 'write'\n  /** Dynamic variables which can replace values via x-variable. */\n  variables?: Record<string, unknown>\n  /** Whether to omit empty and optional properties. */\n  omitEmptyAndOptionalProperties?: boolean\n}\n\n/** Create stable cache key from the options object */\nconst createOptionsCacheKey = (options: GetExampleFromSchemaOptions | undefined) =>\n  JSON.stringify({\n    emptyString: options?.emptyString,\n    xml: options?.xml,\n    mode: options?.mode,\n    variables: options?.variables,\n    omitEmptyAndOptionalProperties: options?.omitEmptyAndOptionalProperties,\n  })\n\n/**\n * Generate an example value from a given OpenAPI SchemaObject.\n *\n * This function recursively processes OpenAPI schemas to create realistic example data.\n * It handles all OpenAPI schema types including primitives, objects, arrays, and\n * composition schemas (allOf, oneOf, anyOf).\n * Uses a tonne of caching for maximum performance.\n *\n * @param schema - The OpenAPI SchemaObject to generate an example from.\n * @param options - Options to customize example generation.\n * @param level - The current recursion depth.\n * @param parentSchema - The parent schema, if any.\n * @param name - The name of the property being processed.\n * @returns An example value for the given schema.\n */\nexport const getExampleFromSchema = (\n  schema: SchemaObject,\n  options?: GetExampleFromSchemaOptions,\n  {\n    level = 0,\n    parentSchema,\n    name,\n    seen = new WeakSet(),\n  }: Partial<{\n    level: number\n    parentSchema: SchemaObject\n    name: string\n    seen: WeakSet<object>\n  }> = {},\n): unknown => {\n  // Resolve any $ref references to get the actual schema\n  const _schema = resolve.schema(schema)\n  if (!isDefined(_schema)) {\n    return undefined\n  }\n\n  // Unpack from all proxies to get the raw schema object for cycle detection\n  const targetValue = getSchemaCacheTarget(_schema)\n  if (seen.has(targetValue)) {\n    return undefined\n  }\n  seen.add(targetValue)\n\n  /** Make the cache key unique per options */\n  const cacheKey = createOptionsCacheKey(options)\n\n  // Check cache first for performance - avoid recomputing the same schema\n  const cached = resultCache.get(targetValue)?.get(cacheKey)\n  if (typeof cached !== 'undefined') {\n    seen.delete(targetValue)\n    return cached\n  }\n\n  // Prevent infinite recursion in circular references\n  if (level > MAX_LEVELS_DEEP) {\n    seen.delete(targetValue)\n    return '[Max Depth Exceeded]'\n  }\n\n  // Determine if we should generate realistic example data\n  const makeUpRandomData = !!options?.emptyString\n\n  // Early exits for schemas that should not be included (deprecated, readOnly, writeOnly, omitEmptyAndOptionalProperties)\n  if (shouldOmitProperty(_schema, parentSchema, name, options)) {\n    seen.delete(targetValue)\n    return undefined\n  }\n\n  // Handle custom variables (x-variable extension)\n  if ('x-variable' in _schema && _schema['x-variable']) {\n    const value = options?.variables?.[_schema['x-variable']]\n    if (value !== undefined) {\n      // Type coercion for numeric types\n      if ('type' in _schema && (_schema.type === 'number' || _schema.type === 'integer')) {\n        seen.delete(targetValue)\n        return cache(_schema, Number(value), cacheKey)\n      }\n      seen.delete(targetValue)\n      return cache(_schema, value, cacheKey)\n    }\n  }\n\n  // Priority order: examples > example > default > const > enum\n  if (Array.isArray(_schema.examples) && _schema.examples.length > 0) {\n    seen.delete(targetValue)\n    return cache(_schema, _schema.examples[0], cacheKey)\n  }\n  if (_schema.example !== undefined) {\n    seen.delete(targetValue)\n    return cache(_schema, _schema.example, cacheKey)\n  }\n  if (_schema.default !== undefined) {\n    seen.delete(targetValue)\n    return cache(_schema, _schema.default, cacheKey)\n  }\n  if (_schema.const !== undefined) {\n    seen.delete(targetValue)\n    return cache(_schema, _schema.const, cacheKey)\n  }\n  if (Array.isArray(_schema.enum) && _schema.enum.length > 0) {\n    seen.delete(targetValue)\n    return cache(_schema, _schema.enum[0], cacheKey)\n  }\n\n  // Handle object types - check for properties to identify objects\n  if ('properties' in _schema || ('type' in _schema && _schema.type === 'object')) {\n    const result = handleObjectSchema(_schema, options, level, seen, cacheKey)\n    seen.delete(targetValue)\n    return result\n  }\n\n  // Handle array types\n  if (('type' in _schema && _schema.type === 'array') || 'items' in _schema) {\n    const result = handleArraySchema(_schema, options, level, seen, cacheKey)\n    seen.delete(targetValue)\n    return result\n  }\n\n  // Handle primitive types without allocating temporary objects\n  const primitive = getPrimitiveValue(_schema, makeUpRandomData, options?.emptyString)\n  if (primitive !== undefined) {\n    seen.delete(targetValue)\n    return cache(_schema, primitive, cacheKey)\n  }\n\n  // Handle composition schemas (oneOf, anyOf) at root level\n  const discriminate = _schema.oneOf || _schema.anyOf\n  if (Array.isArray(discriminate) && discriminate.length > 0) {\n    // Find the first non-null type without allocating intermediate arrays\n    for (const item of discriminate) {\n      const resolved = resolve.schema(item)\n      if (resolved && (!('type' in resolved) || resolved.type !== 'null')) {\n        seen.delete(targetValue)\n        return cache(\n          _schema,\n          getExampleFromSchema(resolved, options, {\n            level: level + 1,\n            seen,\n          }),\n          cacheKey,\n        )\n      }\n    }\n    seen.delete(targetValue)\n    return cache(_schema, null, cacheKey)\n  }\n\n  // Handle allOf at root level (non-object/array schemas)\n  if (Array.isArray(_schema.allOf) && _schema.allOf.length > 0) {\n    let merged: unknown = undefined\n    const items = _schema.allOf\n    for (const item of items) {\n      const ex = getExampleFromSchema(item as SchemaObject, options, {\n        level: level + 1,\n        parentSchema: _schema,\n        seen,\n      })\n      if (merged === undefined) {\n        merged = ex\n      } else if (merged && typeof merged === 'object' && ex && typeof ex === 'object') {\n        merged = mergeExamples(merged, ex)\n      } else if (ex !== undefined) {\n        // Prefer the latest defined primitive value\n        merged = ex\n      }\n    }\n    seen.delete(targetValue)\n    return cache(_schema, merged ?? null, cacheKey)\n  }\n\n  // Handle union types (array of types)\n  const unionPrimitive = getUnionPrimitiveValue(_schema, makeUpRandomData, options?.emptyString)\n  if (unionPrimitive !== undefined) {\n    seen.delete(targetValue)\n    return cache(_schema, unionPrimitive, cacheKey)\n  }\n\n  // Default fallback\n  seen.delete(targetValue)\n  return cache(_schema, null, cacheKey)\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,41 @@
+import { getResolvedRef } from "@scalar/workspace-store/helpers/get-resolved-ref";
+import { isObject } from "@scalar/helpers/object/is-object";
+import { unpackProxyObject } from "@scalar/workspace-store/helpers/unpack-proxy";
+//#region src/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.ts
+/**
+* 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.
+*/
+var getResolvedRefDeep = (node) => {
+	const visited = /* @__PURE__ */ new WeakSet();
+	const cachedResults = /* @__PURE__ */ new WeakMap();
+	const resolveNode = (current) => {
+		if (!isObject(current) && !Array.isArray(current)) return current;
+		const rawValue = unpackProxyObject(current, { depth: 1 });
+		if (cachedResults.has(rawValue)) return cachedResults.get(rawValue);
+		if (visited.has(rawValue)) return "[circular]";
+		visited.add(rawValue);
+		if ("$ref" in current) {
+			const result = resolveNode(getResolvedRef(current));
+			cachedResults.set(rawValue, result);
+			return result;
+		}
+		if (Array.isArray(current)) {
+			const result = current.map(resolveNode);
+			cachedResults.set(rawValue, result);
+			return result;
+		}
+		const result = Object.fromEntries(Object.entries(current).map(([key, value]) => [key, resolveNode(value)]));
+		cachedResults.set(rawValue, result);
+		return result;
+	};
+	return resolveNode(node);
+};
+//#endregion
+export { getResolvedRefDeep };
+
+//# sourceMappingURL=get-resolved-ref-deep.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-resolved-ref-deep.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-resolved-ref-deep.ts"],"sourcesContent":["import { isObject } from '@scalar/helpers/object/is-object'\nimport { type Dereference, getResolvedRef } from '@scalar/workspace-store/helpers/get-resolved-ref'\nimport { unpackProxyObject } from '@scalar/workspace-store/helpers/unpack-proxy'\n\ntype RefNode<Node> = Partial<Node> & { $ref: string; '$ref-value': Node | RefNode<Node> }\ntype NodeInput<Node> = Node | RefNode<Node>\n\n/**\n * Recursively resolves $ref objects\n * This type helper ensures proper typing for deeply nested ref resolution.\n * Properties that could contain $ref objects may resolve to '[circular]' if we have a circular reference.\n */\ntype DeepDereference<T> = Dereference<T> extends T\n  ? T extends readonly (infer U)[]\n    ? DeepDereference<U>[]\n    : T extends object\n      ? { [K in keyof T]: T[K] extends RefNode<any> ? DeepDereference<T[K]> | '[circular]' : DeepDereference<T[K]> }\n      : T\n  : Dereference<T> extends object\n    ? {\n        [K in keyof Dereference<T>]: Dereference<T>[K] extends RefNode<any>\n          ? DeepDereference<Dereference<T>[K]> | '[circular]'\n          : DeepDereference<Dereference<T>[K]>\n      }\n    : Dereference<T>\n\n/**\n * Recursively resolves all $ref objects in a data structure to their actual values.\n * Traverses through objects, arrays, and nested structures to find and resolve\n * any $ref references at any depth level.\n *\n * Handles circular references gracefully by detecting them and returning '[circular]'\n * to prevent infinite loops.\n */\nexport const getResolvedRefDeep = <Node>(node: NodeInput<Node>): DeepDereference<NodeInput<Node>> => {\n  const visited = new WeakSet<object>()\n  const cachedResults = new WeakMap<object, any>()\n\n  const resolveNode = (current: any): any => {\n    // Only recurse into objects and arrays; return primitives as-is\n    if (!isObject(current) && !Array.isArray(current)) {\n      return current\n    }\n\n    const rawValue = unpackProxyObject(current, { depth: 1 })\n\n    // We don't have to recurse into the same object again\n    // This helps us having to manually remove the tracked node after we recurse into the tree\n    if (cachedResults.has(rawValue)) {\n      return cachedResults.get(rawValue)\n    }\n\n    // Break circular references\n    if (visited.has(rawValue)) {\n      return '[circular]'\n    }\n\n    // Track visited nodes\n    visited.add(rawValue)\n\n    if ('$ref' in current) {\n      const resolved = getResolvedRef(current)\n      const result = resolveNode(resolved)\n      cachedResults.set(rawValue, result)\n      return result\n    }\n\n    // For arrays\n    if (Array.isArray(current)) {\n      const result = current.map(resolveNode)\n      cachedResults.set(rawValue, result)\n      return result\n    }\n\n    const result = Object.fromEntries(Object.entries(current).map(([key, value]) => [key, resolveNode(value)]))\n    cachedResults.set(rawValue, result)\n    return result\n  }\n\n  return resolveNode(node)\n}\n"],"mappings":";;;;;;;;;;;;AAkCA,IAAa,sBAA4B,SAA4D;CACnG,MAAM,0BAAU,IAAI,SAAiB;CACrC,MAAM,gCAAgB,IAAI,SAAsB;CAEhD,MAAM,eAAe,YAAsB;AAEzC,MAAI,CAAC,SAAS,QAAQ,IAAI,CAAC,MAAM,QAAQ,QAAQ,CAC/C,QAAO;EAGT,MAAM,WAAW,kBAAkB,SAAS,EAAE,OAAO,GAAG,CAAC;AAIzD,MAAI,cAAc,IAAI,SAAS,CAC7B,QAAO,cAAc,IAAI,SAAS;AAIpC,MAAI,QAAQ,IAAI,SAAS,CACvB,QAAO;AAIT,UAAQ,IAAI,SAAS;AAErB,MAAI,UAAU,SAAS;GAErB,MAAM,SAAS,YADE,eAAe,QAAQ,CACJ;AACpC,iBAAc,IAAI,UAAU,OAAO;AACnC,UAAO;;AAIT,MAAI,MAAM,QAAQ,QAAQ,EAAE;GAC1B,MAAM,SAAS,QAAQ,IAAI,YAAY;AACvC,iBAAc,IAAI,UAAU,OAAO;AACnC,UAAO;;EAGT,MAAM,SAAS,OAAO,YAAY,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,KAAK,WAAW,CAAC,KAAK,YAAY,MAAM,CAAC,CAAC,CAAC;AAC3G,gBAAc,IAAI,UAAU,OAAO;AACnC,SAAO;;AAGT,QAAO,YAAY,KAAK"}

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

@@ -1,4 +1,4 @@
-import type { SecuritySchemeObjectSecret } from '@/v2/blocks/scalar-auth-selector-block/helpers/secret-types';
+import type { SecuritySchemeObjectSecret } from '../../../../v2/blocks/scalar-auth-selector-block/helpers/secret-types';
 /** Extract secrets from security schemes */
 export declare const getSecrets: (securitySchemes: SecuritySchemeObjectSecret[]) => string[];
 //# sourceMappingURL=get-secrets.d.ts.map

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

@@ -0,0 +1,18 @@
+import { encode } from "js-base64";
+//#region src/v2/blocks/operation-code-sample/helpers/get-secrets.ts
+/** Extract secrets from security schemes */
+var getSecrets = (securitySchemes) => securitySchemes.flatMap((scheme) => {
+	if (scheme.type === "apiKey") return scheme["x-scalar-secret-token"];
+	if (scheme?.type === "http") return [
+		scheme["x-scalar-secret-token"],
+		scheme["x-scalar-secret-username"],
+		scheme["x-scalar-secret-password"],
+		encode(`${scheme["x-scalar-secret-username"]}:${scheme["x-scalar-secret-password"]}`)
+	];
+	if (scheme.type === "oauth2") return Object.values(scheme.flows).map((flow) => flow["x-scalar-secret-token"]);
+	return [];
+}).filter(Boolean);
+//#endregion
+export { getSecrets };
+
+//# sourceMappingURL=get-secrets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-secrets.js","names":[],"sources":["../../../../../src/v2/blocks/operation-code-sample/helpers/get-secrets.ts"],"sourcesContent":["import { encode } from 'js-base64'\n\nimport type { SecuritySchemeObjectSecret } from '@/v2/blocks/scalar-auth-selector-block/helpers/secret-types'\n\n/** Extract secrets from security schemes */\nexport const getSecrets = (securitySchemes: SecuritySchemeObjectSecret[]): string[] =>\n  securitySchemes\n    .flatMap((scheme) => {\n      if (scheme.type === 'apiKey') {\n        return scheme['x-scalar-secret-token']\n      }\n      if (scheme?.type === 'http') {\n        return [\n          scheme['x-scalar-secret-token'],\n          scheme['x-scalar-secret-username'],\n          scheme['x-scalar-secret-password'],\n          encode(`${scheme['x-scalar-secret-username']}:${scheme['x-scalar-secret-password']}`),\n        ]\n      }\n      if (scheme.type === 'oauth2') {\n        const flows = Object.values(scheme.flows)\n        return flows.map((flow) => flow['x-scalar-secret-token'])\n      }\n\n      return []\n    })\n    .filter(Boolean)\n"],"mappings":";;;AAKA,IAAa,cAAc,oBACzB,gBACG,SAAS,WAAW;AACnB,KAAI,OAAO,SAAS,SAClB,QAAO,OAAO;AAEhB,KAAI,QAAQ,SAAS,OACnB,QAAO;EACL,OAAO;EACP,OAAO;EACP,OAAO;EACP,OAAO,GAAG,OAAO,4BAA4B,GAAG,OAAO,8BAA8B;EACtF;AAEH,KAAI,OAAO,SAAS,SAElB,QADc,OAAO,OAAO,OAAO,MAAM,CAC5B,KAAK,SAAS,KAAK,yBAAyB;AAG3D,QAAO,EAAE;EACT,CACD,OAAO,QAAQ"}