@warlock.js/core 5.27.0 → 5.29.0

package/esm/openapi/postman/build-saved-responses.mjs

@@ -0,0 +1,60 @@
+import { exampleFromSchema } from "./example-from-schema.mjs";
+import { httpStatusText } from "./http-status-text.mjs";
+
+//#region ../core/src/openapi/postman/build-saved-responses.ts
+function previewLanguage(contentType) {
+	if (contentType === "application/json" || contentType.endsWith("+json")) return "json";
+	return contentType === "text/html" ? "html" : "text";
+}
+function stringExample(example) {
+	return typeof example === "string" ? example : "";
+}
+function responseBody(content, components) {
+	const contentTypes = Object.keys(content);
+	const contentType = contentTypes.find((type) => previewLanguage(type) === "json") ?? contentTypes[0];
+	const schema = contentType !== void 0 ? content[contentType]?.schema : void 0;
+	if (contentType === void 0 || schema === void 0) return {
+		body: "",
+		header: [],
+		language: "text"
+	};
+	const language = previewLanguage(contentType);
+	const example = exampleFromSchema(schema, components);
+	return {
+		body: language === "json" ? JSON.stringify(example, null, 2) : stringExample(example),
+		header: [{
+			key: "Content-Type",
+			value: contentType,
+			type: "text"
+		}],
+		language
+	};
+}
+/**
+* One saved Postman response per declared numeric status, with an example body from the
+* response schema. `default` and range keys (`2XX`) have no single status code and are skipped.
+*/
+function buildSavedResponses(responses, originalRequest, components) {
+	return Object.entries(responses).flatMap(([status, response]) => {
+		if (!/^\d{3}$/.test(status)) return [];
+		const code = Number(status);
+		const { body, header, language } = response.content ? responseBody(response.content, components) : {
+			body: "",
+			header: [],
+			language: "text"
+		};
+		return [{
+			name: `${status} ${response.description}`,
+			originalRequest,
+			status: httpStatusText(code, response.description),
+			code,
+			_postman_previewlanguage: language,
+			header,
+			body
+		}];
+	});
+}
+
+//#endregion
+export { buildSavedResponses };
+//# sourceMappingURL=build-saved-responses.mjs.map

package/esm/openapi/postman/build-saved-responses.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-saved-responses.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/build-saved-responses.ts"],"sourcesContent":["import type { OpenApiOperation } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport { httpStatusText } from \"./http-status-text\";\nimport type { PostmanHeader, PostmanOriginalRequest, PostmanResponse } from \"./postman-types\";\nimport type { SchemaComponents } from \"./schema-refs\";\n\ntype PreviewLanguage = PostmanResponse[\"_postman_previewlanguage\"];\n\nfunction previewLanguage(contentType: string): PreviewLanguage {\n  if (contentType === \"application/json\" || contentType.endsWith(\"+json\")) {\n    return \"json\";\n  }\n\n  return contentType === \"text/html\" ? \"html\" : \"text\";\n}\n\nfunction stringExample(example: unknown): string {\n  return typeof example === \"string\" ? example : \"\";\n}\n\nfunction responseBody(\n  content: NonNullable<OpenApiOperation[\"responses\"][string][\"content\"]>,\n  components: SchemaComponents,\n): { body: string; header: PostmanHeader[]; language: PreviewLanguage } {\n  const contentTypes = Object.keys(content);\n  const contentType = contentTypes.find((type) => previewLanguage(type) === \"json\") ?? contentTypes[0];\n  const schema = contentType !== undefined ? content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return { body: \"\", header: [], language: \"text\" };\n  }\n\n  const language = previewLanguage(contentType);\n  const example = exampleFromSchema(schema, components);\n  const body = language === \"json\" ? JSON.stringify(example, null, 2) : stringExample(example);\n\n  return { body, header: [{ key: \"Content-Type\", value: contentType, type: \"text\" }], language };\n}\n\n/**\n * One saved Postman response per declared numeric status, with an example body from the\n * response schema. `default` and range keys (`2XX`) have no single status code and are skipped.\n */\nexport function buildSavedResponses(\n  responses: OpenApiOperation[\"responses\"],\n  originalRequest: PostmanOriginalRequest,\n  components: SchemaComponents,\n): PostmanResponse[] {\n  return Object.entries(responses).flatMap(([status, response]): PostmanResponse[] => {\n    if (!/^\\d{3}$/.test(status)) {\n      return [];\n    }\n\n    const code = Number(status);\n    const { body, header, language } = response.content\n      ? responseBody(response.content, components)\n      : { body: \"\", header: [], language: \"text\" as const };\n\n    return [\n      {\n        name: `${status} ${response.description}`,\n        originalRequest,\n        status: httpStatusText(code, response.description),\n        code,\n        _postman_previewlanguage: language,\n        header,\n        body,\n      },\n    ];\n  });\n}\n"],"mappings":";;;;AAQA,SAAS,gBAAgB,aAAsC;CAC7D,IAAI,gBAAgB,sBAAsB,YAAY,SAAS,OAAO,GACpE,OAAO;CAGT,OAAO,gBAAgB,cAAc,SAAS;AAChD;AAEA,SAAS,cAAc,SAA0B;CAC/C,OAAO,OAAO,YAAY,WAAW,UAAU;AACjD;AAEA,SAAS,aACP,SACA,YACsE;CACtE,MAAM,eAAe,OAAO,KAAK,OAAO;CACxC,MAAM,cAAc,aAAa,MAAM,SAAS,gBAAgB,IAAI,MAAM,MAAM,KAAK,aAAa;CAClG,MAAM,SAAS,gBAAgB,SAAY,QAAQ,YAAY,EAAE,SAAS;CAE1E,IAAI,gBAAgB,UAAa,WAAW,QAC1C,OAAO;EAAE,MAAM;EAAI,QAAQ,CAAC;EAAG,UAAU;CAAO;CAGlD,MAAM,WAAW,gBAAgB,WAAW;CAC5C,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAGpD,OAAO;EAAE,MAFI,aAAa,SAAS,KAAK,UAAU,SAAS,MAAM,CAAC,IAAI,cAAc,OAAO;EAE5E,QAAQ,CAAC;GAAE,KAAK;GAAgB,OAAO;GAAa,MAAM;EAAO,CAAC;EAAG;CAAS;AAC/F;;;;;AAMA,SAAgB,oBACd,WACA,iBACA,YACmB;CACnB,OAAO,OAAO,QAAQ,SAAS,CAAC,CAAC,SAAS,CAAC,QAAQ,cAAiC;EAClF,IAAI,CAAC,UAAU,KAAK,MAAM,GACxB,OAAO,CAAC;EAGV,MAAM,OAAO,OAAO,MAAM;EAC1B,MAAM,EAAE,MAAM,QAAQ,aAAa,SAAS,UACxC,aAAa,SAAS,SAAS,UAAU,IACzC;GAAE,MAAM;GAAI,QAAQ,CAAC;GAAG,UAAU;EAAgB;EAEtD,OAAO,CACL;GACE,MAAM,GAAG,OAAO,GAAG,SAAS;GAC5B;GACA,QAAQ,eAAe,MAAM,SAAS,WAAW;GACjD;GACA,0BAA0B;GAC1B;GACA;EACF,CACF;CACF,CAAC;AACH"}

package/esm/openapi/postman/example-from-schema.d.mts

@@ -0,0 +1,17 @@
+import { OpenApiSchema } from "../types.mjs";
+import { SchemaComponents } from "./schema-refs.mjs";
+
+//#region ../core/src/openapi/postman/example-from-schema.d.ts
+/**
+ * A deterministic example value for a JSON Schema.
+ *
+ * Explicit `example`, `const`, `default`, `enum[0]` and `examples[0]` win, in that order;
+ * otherwise a type sample is produced (format-aware strings, `0`, `false`, one array item,
+ * every object property). `$ref`s resolve against `components`; a cyclic reference is cut
+ * (the property is omitted, an array of it is empty). A nullable union yields its non-null
+ * branch. A schema with no usable type is `null`.
+ */
+declare function exampleFromSchema(schema: OpenApiSchema, components?: SchemaComponents): unknown;
+//#endregion
+export { exampleFromSchema };
+//# sourceMappingURL=example-from-schema.d.mts.map

package/esm/openapi/postman/example-from-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-from-schema.d.mts","names":[],"sources":["../../../../../../../../core/src/openapi/postman/example-from-schema.ts"],"mappings":";;;;;;AAgJA;;;;;;;iBAAgB,iBAAA,CAAkB,MAAA,EAAQ,aAAA,EAAe,UAAA,GAAa,gBAAgB"}

package/esm/openapi/postman/example-from-schema.mjs

@@ -0,0 +1,92 @@
+import { isRecord, primaryType, refName, resolveSchema } from "./schema-refs.mjs";
+
+//#region ../core/src/openapi/postman/example-from-schema.ts
+const STRING_FORMAT_EXAMPLES = {
+	email: "user@example.com",
+	"date-time": "2024-01-01T00:00:00.000Z",
+	date: "2024-01-01",
+	time: "00:00:00",
+	uri: "https://example.com",
+	url: "https://example.com",
+	iri: "https://example.com",
+	uuid: "00000000-0000-4000-8000-000000000000",
+	hostname: "example.com",
+	ipv4: "127.0.0.1",
+	ipv6: "::1"
+};
+function numberExample(schema) {
+	if (typeof schema.minimum === "number" && schema.minimum > 0) return schema.minimum;
+	if (typeof schema.maximum === "number" && schema.maximum < 0) return schema.maximum;
+	return 0;
+}
+function stringExample(schema) {
+	const format = typeof schema.format === "string" ? schema.format : void 0;
+	return (format !== void 0 ? STRING_FORMAT_EXAMPLES[format] : void 0) ?? "string";
+}
+function isNullBranch(branch, components) {
+	return isRecord(branch) && primaryType(resolveSchema(branch, components)) === "null";
+}
+function mergeExamples(parts) {
+	const objects = parts.filter(isRecord);
+	if (objects.length === parts.length) return Object.assign({}, ...objects);
+	return parts[parts.length - 1] ?? null;
+}
+/**
+* `undefined` marks a `$ref` cycle: the caller omits the property, or yields an empty array.
+*/
+function generate(schema, components, stack) {
+	if (!isRecord(schema)) return null;
+	const name = refName(schema);
+	if (name !== void 0) {
+		const target = components?.[name];
+		if (stack.includes(name)) return;
+		return target ? generate(target, components, [...stack, name]) : null;
+	}
+	if ("example" in schema) return schema.example;
+	if ("const" in schema) return schema.const;
+	if ("default" in schema) return schema.default;
+	if (Array.isArray(schema.enum) && schema.enum.length > 0) return schema.enum[0];
+	if (Array.isArray(schema.examples) && schema.examples.length > 0) return schema.examples[0];
+	for (const key of ["oneOf", "anyOf"]) {
+		const branches = schema[key];
+		if (Array.isArray(branches) && branches.length > 0) return generate(branches.find((candidate) => !isNullBranch(candidate, components)) ?? branches[0], components, stack);
+	}
+	if (Array.isArray(schema.allOf) && schema.allOf.length > 0) return mergeExamples(schema.allOf.map((part) => generate(part, components, stack)));
+	switch (primaryType(schema)) {
+		case "string": return stringExample(schema);
+		case "number":
+		case "integer": return numberExample(schema);
+		case "boolean": return false;
+		case "array": {
+			const item = generate(schema.items, components, stack);
+			return item === void 0 ? [] : [item];
+		}
+		case "object": {
+			const result = {};
+			const properties = isRecord(schema.properties) ? schema.properties : {};
+			for (const [key, property] of Object.entries(properties)) {
+				const value = generate(property, components, stack);
+				if (value !== void 0) result[key] = value;
+			}
+			return result;
+		}
+		default: return null;
+	}
+}
+/**
+* A deterministic example value for a JSON Schema.
+*
+* Explicit `example`, `const`, `default`, `enum[0]` and `examples[0]` win, in that order;
+* otherwise a type sample is produced (format-aware strings, `0`, `false`, one array item,
+* every object property). `$ref`s resolve against `components`; a cyclic reference is cut
+* (the property is omitted, an array of it is empty). A nullable union yields its non-null
+* branch. A schema with no usable type is `null`.
+*/
+function exampleFromSchema(schema, components) {
+	const value = generate(schema, components, []);
+	return value === void 0 ? null : value;
+}
+
+//#endregion
+export { exampleFromSchema };
+//# sourceMappingURL=example-from-schema.mjs.map

package/esm/openapi/postman/example-from-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-from-schema.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/example-from-schema.ts"],"sourcesContent":["import type { OpenApiSchema } from \"../types\";\nimport { isRecord, primaryType, refName, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nconst STRING_FORMAT_EXAMPLES: Record<string, string> = {\n  email: \"user@example.com\",\n  \"date-time\": \"2024-01-01T00:00:00.000Z\",\n  date: \"2024-01-01\",\n  time: \"00:00:00\",\n  uri: \"https://example.com\",\n  url: \"https://example.com\",\n  iri: \"https://example.com\",\n  uuid: \"00000000-0000-4000-8000-000000000000\",\n  hostname: \"example.com\",\n  ipv4: \"127.0.0.1\",\n  ipv6: \"::1\",\n};\n\nfunction numberExample(schema: OpenApiSchema): number {\n  if (typeof schema.minimum === \"number\" && schema.minimum > 0) {\n    return schema.minimum;\n  }\n\n  if (typeof schema.maximum === \"number\" && schema.maximum < 0) {\n    return schema.maximum;\n  }\n\n  return 0;\n}\n\nfunction stringExample(schema: OpenApiSchema): string {\n  const format = typeof schema.format === \"string\" ? schema.format : undefined;\n\n  return (format !== undefined ? STRING_FORMAT_EXAMPLES[format] : undefined) ?? \"string\";\n}\n\nfunction isNullBranch(branch: unknown, components: SchemaComponents): boolean {\n  return isRecord(branch) && primaryType(resolveSchema(branch, components)) === \"null\";\n}\n\nfunction mergeExamples(parts: unknown[]): unknown {\n  const objects = parts.filter(isRecord);\n\n  if (objects.length === parts.length) {\n    return Object.assign({}, ...objects);\n  }\n\n  return parts[parts.length - 1] ?? null;\n}\n\n/**\n * `undefined` marks a `$ref` cycle: the caller omits the property, or yields an empty array.\n */\nfunction generate(schema: unknown, components: SchemaComponents, stack: readonly string[]): unknown {\n  if (!isRecord(schema)) {\n    return null;\n  }\n\n  const name = refName(schema);\n\n  if (name !== undefined) {\n    const target = components?.[name];\n\n    if (stack.includes(name)) {\n      return undefined;\n    }\n\n    return target ? generate(target, components, [...stack, name]) : null;\n  }\n\n  if (\"example\" in schema) {\n    return schema.example;\n  }\n\n  if (\"const\" in schema) {\n    return schema.const;\n  }\n\n  if (\"default\" in schema) {\n    return schema.default;\n  }\n\n  if (Array.isArray(schema.enum) && schema.enum.length > 0) {\n    return schema.enum[0];\n  }\n\n  if (Array.isArray(schema.examples) && schema.examples.length > 0) {\n    return schema.examples[0];\n  }\n\n  for (const key of [\"oneOf\", \"anyOf\"] as const) {\n    const branches = schema[key];\n\n    if (Array.isArray(branches) && branches.length > 0) {\n      const branch = branches.find((candidate) => !isNullBranch(candidate, components)) ?? branches[0];\n\n      return generate(branch, components, stack);\n    }\n  }\n\n  if (Array.isArray(schema.allOf) && schema.allOf.length > 0) {\n    return mergeExamples(schema.allOf.map((part) => generate(part, components, stack)));\n  }\n\n  switch (primaryType(schema)) {\n    case \"string\":\n      return stringExample(schema);\n    case \"number\":\n    case \"integer\":\n      return numberExample(schema);\n    case \"boolean\":\n      return false;\n    case \"array\": {\n      const item = generate(schema.items, components, stack);\n\n      return item === undefined ? [] : [item];\n    }\n    case \"object\": {\n      const result: Record<string, unknown> = {};\n      const properties = isRecord(schema.properties) ? schema.properties : {};\n\n      for (const [key, property] of Object.entries(properties)) {\n        const value = generate(property, components, stack);\n\n        if (value !== undefined) {\n          result[key] = value;\n        }\n      }\n\n      return result;\n    }\n    default:\n      return null;\n  }\n}\n\n/**\n * A deterministic example value for a JSON Schema.\n *\n * Explicit `example`, `const`, `default`, `enum[0]` and `examples[0]` win, in that order;\n * otherwise a type sample is produced (format-aware strings, `0`, `false`, one array item,\n * every object property). `$ref`s resolve against `components`; a cyclic reference is cut\n * (the property is omitted, an array of it is empty). A nullable union yields its non-null\n * branch. A schema with no usable type is `null`.\n */\nexport function exampleFromSchema(schema: OpenApiSchema, components?: SchemaComponents): unknown {\n  const value = generate(schema, components, []);\n\n  return value === undefined ? null : value;\n}\n"],"mappings":"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"}

package/esm/openapi/postman/http-status-text.mjs

@@ -0,0 +1,31 @@
+//#region ../core/src/openapi/postman/http-status-text.ts
+const STATUS_TEXT = {
+	200: "OK",
+	201: "Created",
+	202: "Accepted",
+	204: "No Content",
+	301: "Moved Permanently",
+	302: "Found",
+	304: "Not Modified",
+	400: "Bad Request",
+	401: "Unauthorized",
+	403: "Forbidden",
+	404: "Not Found",
+	405: "Method Not Allowed",
+	409: "Conflict",
+	410: "Gone",
+	422: "Unprocessable Entity",
+	429: "Too Many Requests",
+	500: "Internal Server Error",
+	503: "Service Unavailable"
+};
+/**
+* The HTTP reason phrase of a status code, or `fallback` for one that is not listed.
+*/
+function httpStatusText(code, fallback) {
+	return STATUS_TEXT[code] ?? fallback;
+}
+
+//#endregion
+export { httpStatusText };
+//# sourceMappingURL=http-status-text.mjs.map

package/esm/openapi/postman/http-status-text.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-status-text.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/http-status-text.ts"],"sourcesContent":["const STATUS_TEXT: Record<number, string> = {\n  200: \"OK\",\n  201: \"Created\",\n  202: \"Accepted\",\n  204: \"No Content\",\n  301: \"Moved Permanently\",\n  302: \"Found\",\n  304: \"Not Modified\",\n  400: \"Bad Request\",\n  401: \"Unauthorized\",\n  403: \"Forbidden\",\n  404: \"Not Found\",\n  405: \"Method Not Allowed\",\n  409: \"Conflict\",\n  410: \"Gone\",\n  422: \"Unprocessable Entity\",\n  429: \"Too Many Requests\",\n  500: \"Internal Server Error\",\n  503: \"Service Unavailable\",\n};\n\n/**\n * The HTTP reason phrase of a status code, or `fallback` for one that is not listed.\n */\nexport function httpStatusText(code: number, fallback: string): string {\n  return STATUS_TEXT[code] ?? fallback;\n}\n"],"mappings":";AAAA,MAAM,cAAsC;CAC1C,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP;;;;AAKA,SAAgB,eAAe,MAAc,UAA0B;CACrE,OAAO,YAAY,SAAS;AAC9B"}

package/esm/openapi/postman/index.d.mts

@@ -0,0 +1,3 @@
+import { PostmanAuth, PostmanAuthEntry, PostmanBody, PostmanCollection, PostmanCollectionOptions, PostmanFolder, PostmanFormParam, PostmanHeader, PostmanItem, PostmanOriginalRequest, PostmanQueryParam, PostmanRequest, PostmanRequestItem, PostmanResponse, PostmanUrl, PostmanVariable } from "./postman-types.mjs";
+import { exampleFromSchema } from "./example-from-schema.mjs";
+import { DEFAULT_POSTMAN_BASE_URL, POSTMAN_COLLECTION_SCHEMA, openApiToPostmanCollection } from "./openapi-to-postman-collection.mjs";

package/esm/openapi/postman/openapi-to-postman-collection.d.mts

@@ -0,0 +1,22 @@
+import { PostmanCollection, PostmanCollectionOptions } from "./postman-types.mjs";
+import { OpenApiDocument } from "../types.mjs";
+
+//#region ../core/src/openapi/postman/openapi-to-postman-collection.d.ts
+/** `info.schema` of every collection this converter produces. */
+declare const POSTMAN_COLLECTION_SCHEMA = "https://schema.getpostman.com/json/collection/v2.1.0/collection.json";
+/** `{{baseUrl}}` when neither the options nor the document name a server. */
+declare const DEFAULT_POSTMAN_BASE_URL = "http://localhost:3000";
+/**
+ * Convert an OpenAPI document into a Postman Collection v2.1.0 object.
+ *
+ * Pure and deterministic (the collection id is a UUIDv5 of the title), derived only from the
+ * document so the collection can never disagree with the OpenAPI output. Each tag becomes a
+ * folder in order of first appearance and untagged operations stay at the root; each
+ * operation becomes a request with example bodies generated from its schemas and a saved
+ * response per declared status. `{{baseUrl}}` and `{{token}}` are collection variables; a
+ * bearer scheme becomes collection-level bearer auth and public operations opt out of it.
+ */
+declare function openApiToPostmanCollection(document: OpenApiDocument, options?: PostmanCollectionOptions): PostmanCollection;
+//#endregion
+export { DEFAULT_POSTMAN_BASE_URL, POSTMAN_COLLECTION_SCHEMA, openApiToPostmanCollection };
+//# sourceMappingURL=openapi-to-postman-collection.d.mts.map

package/esm/openapi/postman/openapi-to-postman-collection.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-to-postman-collection.d.mts","names":[],"sources":["../../../../../../../../core/src/openapi/postman/openapi-to-postman-collection.ts"],"mappings":";;;;;cAgBa,yBAAA;AAAb;AAAA,cAGa,wBAAA;;;AAHyB;AAGtC;;;;AAAqC;AAqDrC;;iBAAgB,0BAAA,CACd,QAAA,EAAU,eAAA,EACV,OAAA,GAAS,wBAAA,GACR,iBAAA"}

package/esm/openapi/postman/openapi-to-postman-collection.mjs

@@ -0,0 +1,109 @@
+import { buildRequestBody } from "./build-request-body.mjs";
+import { buildHeaderParameters, buildRequestUrl } from "./build-request-url.mjs";
+import { buildSavedResponses } from "./build-saved-responses.mjs";
+import { collectionBearerAuth, hasBearerScheme, resolveOperationAuth } from "./resolve-operation-auth.mjs";
+import { uuidV5 } from "./uuid-v5.mjs";
+
+//#region ../core/src/openapi/postman/openapi-to-postman-collection.ts
+/** `info.schema` of every collection this converter produces. */
+const POSTMAN_COLLECTION_SCHEMA = "https://schema.getpostman.com/json/collection/v2.1.0/collection.json";
+/** `{{baseUrl}}` when neither the options nor the document name a server. */
+const DEFAULT_POSTMAN_BASE_URL = "http://localhost:3000";
+const OPERATION_METHODS = [
+	"get",
+	"put",
+	"post",
+	"delete",
+	"options",
+	"head",
+	"patch",
+	"trace"
+];
+function buildRequestItem(path, method, operation, document) {
+	const components = document.components?.schemas;
+	const parameters = operation.parameters ?? [];
+	const body = buildRequestBody(operation.requestBody, components);
+	const { auth, note } = resolveOperationAuth(operation, document.components);
+	const description = [operation.description, note].filter((line) => Boolean(line)).join("\n\n");
+	const header = [...body?.contentType ? [{
+		key: "Content-Type",
+		value: body.contentType,
+		type: "text"
+	}] : [], ...buildHeaderParameters(parameters, components)];
+	const originalRequest = {
+		method: method.toUpperCase(),
+		header,
+		...body ? { body: body.body } : {},
+		url: buildRequestUrl(path, parameters, components)
+	};
+	return {
+		name: operation.summary ?? operation.operationId,
+		request: {
+			...originalRequest,
+			...auth ? { auth } : {},
+			...description ? { description } : {}
+		},
+		response: buildSavedResponses(operation.responses, originalRequest, components)
+	};
+}
+function normalizeBaseUrl(baseUrl) {
+	return baseUrl.replace(/\/+$/, "");
+}
+/**
+* Convert an OpenAPI document into a Postman Collection v2.1.0 object.
+*
+* Pure and deterministic (the collection id is a UUIDv5 of the title), derived only from the
+* document so the collection can never disagree with the OpenAPI output. Each tag becomes a
+* folder in order of first appearance and untagged operations stay at the root; each
+* operation becomes a request with example bodies generated from its schemas and a saved
+* response per declared status. `{{baseUrl}}` and `{{token}}` are collection variables; a
+* bearer scheme becomes collection-level bearer auth and public operations opt out of it.
+*/
+function openApiToPostmanCollection(document, options = {}) {
+	const name = options.title ?? document.info.title;
+	const baseUrl = normalizeBaseUrl(options.baseUrl ?? document.servers?.[0]?.url ?? "http://localhost:3000");
+	const root = [];
+	const folders = /* @__PURE__ */ new Map();
+	for (const [path, pathItem] of Object.entries(document.paths)) for (const [method, operation] of Object.entries(pathItem)) {
+		if (!OPERATION_METHODS.includes(method)) continue;
+		const item = buildRequestItem(path, method, operation, document);
+		const tag = operation.tags?.[0];
+		if (tag === void 0) {
+			root.push(item);
+			continue;
+		}
+		let folder = folders.get(tag);
+		if (!folder) {
+			folder = {
+				name: tag,
+				item: []
+			};
+			folders.set(tag, folder);
+			root.push(folder);
+		}
+		folder.item.push(item);
+	}
+	return {
+		info: {
+			_postman_id: uuidV5(name),
+			name,
+			...document.info.description ? { description: document.info.description } : {},
+			schema: POSTMAN_COLLECTION_SCHEMA
+		},
+		item: root,
+		...hasBearerScheme(document.components) ? { auth: collectionBearerAuth() } : {},
+		variable: [{
+			key: "baseUrl",
+			value: baseUrl,
+			type: "string"
+		}, {
+			key: "token",
+			value: "",
+			type: "string"
+		}]
+	};
+}
+
+//#endregion
+export { DEFAULT_POSTMAN_BASE_URL, POSTMAN_COLLECTION_SCHEMA, openApiToPostmanCollection };
+//# sourceMappingURL=openapi-to-postman-collection.mjs.map

package/esm/openapi/postman/openapi-to-postman-collection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi-to-postman-collection.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/openapi-to-postman-collection.ts"],"sourcesContent":["import type { OpenApiDocument, OpenApiOperation } from \"../types\";\nimport { buildRequestBody } from \"./build-request-body\";\nimport { buildHeaderParameters, buildRequestUrl } from \"./build-request-url\";\nimport { buildSavedResponses } from \"./build-saved-responses\";\nimport type {\n  PostmanCollection,\n  PostmanCollectionOptions,\n  PostmanFolder,\n  PostmanHeader,\n  PostmanItem,\n  PostmanRequestItem,\n} from \"./postman-types\";\nimport { collectionBearerAuth, hasBearerScheme, resolveOperationAuth } from \"./resolve-operation-auth\";\nimport { uuidV5 } from \"./uuid-v5\";\n\n/** `info.schema` of every collection this converter produces. */\nexport const POSTMAN_COLLECTION_SCHEMA = \"https://schema.getpostman.com/json/collection/v2.1.0/collection.json\";\n\n/** `{{baseUrl}}` when neither the options nor the document name a server. */\nexport const DEFAULT_POSTMAN_BASE_URL = \"http://localhost:3000\";\n\nconst OPERATION_METHODS = [\"get\", \"put\", \"post\", \"delete\", \"options\", \"head\", \"patch\", \"trace\"];\n\nfunction buildRequestItem(\n  path: string,\n  method: string,\n  operation: OpenApiOperation,\n  document: OpenApiDocument,\n): PostmanRequestItem {\n  const components = document.components?.schemas;\n  const parameters = operation.parameters ?? [];\n  const body = buildRequestBody(operation.requestBody, components);\n  const { auth, note } = resolveOperationAuth(operation, document.components);\n  const description = [operation.description, note].filter((line): line is string => Boolean(line)).join(\"\\n\\n\");\n\n  const header: PostmanHeader[] = [\n    ...(body?.contentType ? [{ key: \"Content-Type\", value: body.contentType, type: \"text\" as const }] : []),\n    ...buildHeaderParameters(parameters, components),\n  ];\n\n  const originalRequest = {\n    method: method.toUpperCase(),\n    header,\n    ...(body ? { body: body.body } : {}),\n    url: buildRequestUrl(path, parameters, components),\n  };\n\n  return {\n    name: operation.summary ?? operation.operationId,\n    request: {\n      ...originalRequest,\n      ...(auth ? { auth } : {}),\n      ...(description ? { description } : {}),\n    },\n    response: buildSavedResponses(operation.responses, originalRequest, components),\n  };\n}\n\nfunction normalizeBaseUrl(baseUrl: string): string {\n  return baseUrl.replace(/\\/+$/, \"\");\n}\n\n/**\n * Convert an OpenAPI document into a Postman Collection v2.1.0 object.\n *\n * Pure and deterministic (the collection id is a UUIDv5 of the title), derived only from the\n * document so the collection can never disagree with the OpenAPI output. Each tag becomes a\n * folder in order of first appearance and untagged operations stay at the root; each\n * operation becomes a request with example bodies generated from its schemas and a saved\n * response per declared status. `{{baseUrl}}` and `{{token}}` are collection variables; a\n * bearer scheme becomes collection-level bearer auth and public operations opt out of it.\n */\nexport function openApiToPostmanCollection(\n  document: OpenApiDocument,\n  options: PostmanCollectionOptions = {},\n): PostmanCollection {\n  const name = options.title ?? document.info.title;\n  const baseUrl = normalizeBaseUrl(options.baseUrl ?? document.servers?.[0]?.url ?? DEFAULT_POSTMAN_BASE_URL);\n  const root: PostmanItem[] = [];\n  const folders = new Map<string, PostmanFolder>();\n\n  for (const [path, pathItem] of Object.entries(document.paths)) {\n    for (const [method, operation] of Object.entries(pathItem)) {\n      if (!OPERATION_METHODS.includes(method)) {\n        continue;\n      }\n\n      const item = buildRequestItem(path, method, operation, document);\n      const tag = operation.tags?.[0];\n\n      if (tag === undefined) {\n        root.push(item);\n\n        continue;\n      }\n\n      let folder = folders.get(tag);\n\n      if (!folder) {\n        folder = { name: tag, item: [] };\n        folders.set(tag, folder);\n        root.push(folder);\n      }\n\n      folder.item.push(item);\n    }\n  }\n\n  return {\n    info: {\n      _postman_id: uuidV5(name),\n      name,\n      ...(document.info.description ? { description: document.info.description } : {}),\n      schema: POSTMAN_COLLECTION_SCHEMA,\n    },\n    item: root,\n    ...(hasBearerScheme(document.components) ? { auth: collectionBearerAuth() } : {}),\n    variable: [\n      { key: \"baseUrl\", value: baseUrl, type: \"string\" },\n      { key: \"token\", value: \"\", type: \"string\" },\n    ],\n  };\n}\n"],"mappings":";;;;;;;;AAgBA,MAAa,4BAA4B;;AAGzC,MAAa,2BAA2B;AAExC,MAAM,oBAAoB;CAAC;CAAO;CAAO;CAAQ;CAAU;CAAW;CAAQ;CAAS;AAAO;AAE9F,SAAS,iBACP,MACA,QACA,WACA,UACoB;CACpB,MAAM,aAAa,SAAS,YAAY;CACxC,MAAM,aAAa,UAAU,cAAc,CAAC;CAC5C,MAAM,OAAO,iBAAiB,UAAU,aAAa,UAAU;CAC/D,MAAM,EAAE,MAAM,SAAS,qBAAqB,WAAW,SAAS,UAAU;CAC1E,MAAM,cAAc,CAAC,UAAU,aAAa,IAAI,CAAC,CAAC,QAAQ,SAAyB,QAAQ,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM;CAE7G,MAAM,SAA0B,CAC9B,GAAI,MAAM,cAAc,CAAC;EAAE,KAAK;EAAgB,OAAO,KAAK;EAAa,MAAM;CAAgB,CAAC,IAAI,CAAC,GACrG,GAAG,sBAAsB,YAAY,UAAU,CACjD;CAEA,MAAM,kBAAkB;EACtB,QAAQ,OAAO,YAAY;EAC3B;EACA,GAAI,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EAClC,KAAK,gBAAgB,MAAM,YAAY,UAAU;CACnD;CAEA,OAAO;EACL,MAAM,UAAU,WAAW,UAAU;EACrC,SAAS;GACP,GAAG;GACH,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC;GACvB,GAAI,cAAc,EAAE,YAAY,IAAI,CAAC;EACvC;EACA,UAAU,oBAAoB,UAAU,WAAW,iBAAiB,UAAU;CAChF;AACF;AAEA,SAAS,iBAAiB,SAAyB;CACjD,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AACnC;;;;;;;;;;;AAYA,SAAgB,2BACd,UACA,UAAoC,CAAC,GAClB;CACnB,MAAM,OAAO,QAAQ,SAAS,SAAS,KAAK;CAC5C,MAAM,UAAU,iBAAiB,QAAQ,WAAW,SAAS,UAAU,EAAE,EAAE,8BAA+B;CAC1G,MAAM,OAAsB,CAAC;CAC7B,MAAM,0BAAU,IAAI,IAA2B;CAE/C,KAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,SAAS,KAAK,GAC1D,KAAK,MAAM,CAAC,QAAQ,cAAc,OAAO,QAAQ,QAAQ,GAAG;EAC1D,IAAI,CAAC,kBAAkB,SAAS,MAAM,GACpC;EAGF,MAAM,OAAO,iBAAiB,MAAM,QAAQ,WAAW,QAAQ;EAC/D,MAAM,MAAM,UAAU,OAAO;EAE7B,IAAI,QAAQ,QAAW;GACrB,KAAK,KAAK,IAAI;GAEd;EACF;EAEA,IAAI,SAAS,QAAQ,IAAI,GAAG;EAE5B,IAAI,CAAC,QAAQ;GACX,SAAS;IAAE,MAAM;IAAK,MAAM,CAAC;GAAE;GAC/B,QAAQ,IAAI,KAAK,MAAM;GACvB,KAAK,KAAK,MAAM;EAClB;EAEA,OAAO,KAAK,KAAK,IAAI;CACvB;CAGF,OAAO;EACL,MAAM;GACJ,aAAa,OAAO,IAAI;GACxB;GACA,GAAI,SAAS,KAAK,cAAc,EAAE,aAAa,SAAS,KAAK,YAAY,IAAI,CAAC;GAC9E,QAAQ;EACV;EACA,MAAM;EACN,GAAI,gBAAgB,SAAS,UAAU,IAAI,EAAE,MAAM,qBAAqB,EAAE,IAAI,CAAC;EAC/E,UAAU,CACR;GAAE,KAAK;GAAW,OAAO;GAAS,MAAM;EAAS,GACjD;GAAE,KAAK;GAAS,OAAO;GAAI,MAAM;EAAS,CAC5C;CACF;AACF"}

package/esm/openapi/postman/postman-types.d.mts

@@ -0,0 +1,119 @@
+//#region ../core/src/openapi/postman/postman-types.d.ts
+/**
+ * The slice of the Postman Collection Format v2.1.0 the converter emits.
+ * Schema: https://schema.getpostman.com/json/collection/v2.1.0/collection.json
+ */
+type PostmanVariable = {
+  key: string;
+  value: string;
+  type?: "string";
+  description?: string;
+};
+type PostmanAuthEntry = {
+  key: string;
+  value: string;
+  type: "string";
+};
+type PostmanAuth = {
+  type: "noauth";
+} | {
+  type: "bearer";
+  bearer: PostmanAuthEntry[];
+};
+type PostmanHeader = {
+  key: string;
+  value: string;
+  type?: "text";
+  description?: string;
+  disabled?: boolean;
+};
+type PostmanQueryParam = {
+  key: string;
+  value: string;
+  description?: string;
+  disabled?: boolean;
+};
+type PostmanUrl = {
+  raw: string;
+  host: string[];
+  path: string[];
+  variable?: PostmanVariable[];
+  query?: PostmanQueryParam[];
+};
+type PostmanFormParam = {
+  key: string;
+  value: string;
+  type: "text";
+  description?: string;
+} | {
+  key: string;
+  type: "file";
+  src: string[];
+  description?: string;
+};
+type PostmanBody = {
+  mode: "raw";
+  raw: string;
+  options: {
+    raw: {
+      language: "json" | "text";
+    };
+  };
+} | {
+  mode: "formdata";
+  formdata: PostmanFormParam[];
+} | {
+  mode: "urlencoded";
+  urlencoded: {
+    key: string;
+    value: string;
+    type: "text";
+  }[];
+};
+type PostmanOriginalRequest = {
+  method: string;
+  header: PostmanHeader[];
+  body?: PostmanBody;
+  url: PostmanUrl;
+};
+type PostmanRequest = PostmanOriginalRequest & {
+  auth?: PostmanAuth;
+  description?: string;
+};
+type PostmanResponse = {
+  name: string;
+  originalRequest: PostmanOriginalRequest;
+  status: string;
+  code: number;
+  _postman_previewlanguage: "json" | "html" | "text";
+  header: PostmanHeader[];
+  body: string;
+};
+type PostmanRequestItem = {
+  name: string;
+  request: PostmanRequest;
+  response: PostmanResponse[];
+};
+type PostmanFolder = {
+  name: string;
+  item: PostmanItem[];
+};
+type PostmanItem = PostmanFolder | PostmanRequestItem;
+type PostmanCollection = {
+  info: {
+    _postman_id: string;
+    name: string;
+    description?: string;
+    schema: "https://schema.getpostman.com/json/collection/v2.1.0/collection.json";
+  };
+  item: PostmanItem[];
+  auth?: PostmanAuth;
+  variable: PostmanVariable[];
+};
+type PostmanCollectionOptions = {
+  /** Collection name. Defaults to `info.title` of the document. */title?: string; /** Value of the `{{baseUrl}}` variable. Defaults to `servers[0].url`, else `http://localhost:3000`. */
+  baseUrl?: string;
+};
+//#endregion
+export { PostmanAuth, PostmanAuthEntry, PostmanBody, PostmanCollection, PostmanCollectionOptions, PostmanFolder, PostmanFormParam, PostmanHeader, PostmanItem, PostmanOriginalRequest, PostmanQueryParam, PostmanRequest, PostmanRequestItem, PostmanResponse, PostmanUrl, PostmanVariable };
+//# sourceMappingURL=postman-types.d.mts.map

package/esm/openapi/postman/postman-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postman-types.d.mts","names":[],"sources":["../../../../../../../../core/src/openapi/postman/postman-types.ts"],"mappings":";;AAKA;;;KAAY,eAAA;EACV,GAAA;EACA,KAAA;EACA,IAAA;EACA,WAAA;AAAA;AAAA,KAGU,gBAAA;EAAqB,GAAA;EAAa,KAAA;EAAe,IAAA;AAAA;AAAA,KAEjD,WAAA;EAAgB,IAAA;AAAA;EAAqB,IAAA;EAAgB,MAAA,EAAQ,gBAAgB;AAAA;AAAA,KAE7E,aAAA;EACV,GAAA;EACA,KAAA;EACA,IAAA;EACA,WAAA;EACA,QAAA;AAAA;AAAA,KAGU,iBAAA;EACV,GAAA;EACA,KAAA;EACA,WAAA;EACA,QAAA;AAAA;AAAA,KAGU,UAAA;EACV,GAAA;EACA,IAAA;EACA,IAAA;EACA,QAAA,GAAW,eAAA;EACX,KAAA,GAAQ,iBAAiB;AAAA;AAAA,KAGf,gBAAA;EACN,GAAA;EAAa,KAAA;EAAe,IAAA;EAAc,WAAA;AAAA;EAC1C,GAAA;EAAa,IAAA;EAAc,GAAA;EAAe,WAAA;AAAA;AAAA,KAEpC,WAAA;EACN,IAAA;EAAa,GAAA;EAAa,OAAA;IAAW,GAAA;MAAO,QAAA;IAAA;EAAA;AAAA;EAC5C,IAAA;EAAkB,QAAA,EAAU,gBAAgB;AAAA;EAC5C,IAAA;EAAoB,UAAA;IAAc,GAAA;IAAa,KAAA;IAAe,IAAA;EAAA;AAAA;AAAA,KAExD,sBAAA;EACV,MAAA;EACA,MAAA,EAAQ,aAAA;EACR,IAAA,GAAO,WAAA;EACP,GAAA,EAAK,UAAA;AAAA;AAAA,KAGK,cAAA,GAAiB,sBAAA;EAC3B,IAAA,GAAO,WAAW;EAClB,WAAA;AAAA;AAAA,KAGU,eAAA;EACV,IAAA;EACA,eAAA,EAAiB,sBAAA;EACjB,MAAA;EACA,IAAA;EACA,wBAAA;EACA,MAAA,EAAQ,aAAa;EACrB,IAAA;AAAA;AAAA,KAGU,kBAAA;EACV,IAAA;EACA,OAAA,EAAS,cAAA;EACT,QAAA,EAAU,eAAe;AAAA;AAAA,KAGf,aAAA;EACV,IAAA;EACA,IAAA,EAAM,WAAW;AAAA;AAAA,KAGP,WAAA,GAAc,aAAA,GAAgB,kBAAkB;AAAA,KAEhD,iBAAA;EACV,IAAA;IACE,WAAA;IACA,IAAA;IACA,WAAA;IACA,MAAA;EAAA;EAEF,IAAA,EAAM,WAAA;EACN,IAAA,GAAO,WAAA;EACP,QAAA,EAAU,eAAA;AAAA;AAAA,KAGA,wBAAA;EA3CK,iEA6Cf,KAAA,WA1CU;EA4CV,OAAO;AAAA"}

package/esm/openapi/postman/resolve-operation-auth.mjs

@@ -0,0 +1,51 @@
+//#region ../core/src/openapi/postman/resolve-operation-auth.ts
+/** The collection-level auth: a bearer token read from the `{{token}}` variable. */
+function collectionBearerAuth() {
+	return {
+		type: "bearer",
+		bearer: [{
+			key: "token",
+			value: "{{token}}",
+			type: "string"
+		}]
+	};
+}
+function isBearer(scheme) {
+	return scheme?.type === "http" && scheme.scheme.toLowerCase() === "bearer";
+}
+/**
+* Whether the document declares an HTTP bearer scheme, which is what the collection-level
+* auth stands for.
+*/
+function hasBearerScheme(components) {
+	return Object.values(components?.securitySchemes ?? {}).some(isBearer);
+}
+/**
+* How one operation relates to the collection-level bearer auth.
+*
+* - No `security` (a public route): `noauth`, so the token is not sent.
+* - A bearer requirement: inherits the collection auth.
+* - Cookie-only: `noauth` plus a note, because Postman keeps cookies per domain instead of
+*   in collection auth.
+*/
+function resolveOperationAuth(operation, components) {
+	const bearerDocument = hasBearerScheme(components);
+	const schemes = components?.securitySchemes ?? {};
+	const names = (operation.security ?? []).flatMap((requirement) => Object.keys(requirement));
+	if (names.some((name) => isBearer(schemes[name]))) return {};
+	const cookies = names.flatMap((name) => {
+		const scheme = schemes[name];
+		return scheme?.type === "apiKey" && scheme.in === "cookie" ? [scheme.name] : [];
+	});
+	const auth = bearerDocument ? { auth: { type: "noauth" } } : {};
+	if (cookies.length === 0) return auth;
+	const cookieList = cookies.map((cookie) => `"${cookie}"`).join(", ");
+	return {
+		...auth,
+		note: `Authenticates with the ${cookieList} cookie. Postman keeps cookies per domain, so sign in against {{baseUrl}} first or add the cookie in the Cookies manager.`
+	};
+}
+
+//#endregion
+export { collectionBearerAuth, hasBearerScheme, resolveOperationAuth };
+//# sourceMappingURL=resolve-operation-auth.mjs.map

package/esm/openapi/postman/resolve-operation-auth.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-operation-auth.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/resolve-operation-auth.ts"],"sourcesContent":["import type { OpenApiComponents, OpenApiOperation, OpenApiSecurityScheme } from \"../types\";\nimport type { PostmanAuth } from \"./postman-types\";\n\nexport type OperationAuth = {\n  /** Set only when the operation must not inherit the collection auth. */\n  auth?: PostmanAuth;\n  /** Text appended to the request description. */\n  note?: string;\n};\n\n/** The collection-level auth: a bearer token read from the `{{token}}` variable. */\nexport function collectionBearerAuth(): PostmanAuth {\n  return { type: \"bearer\", bearer: [{ key: \"token\", value: \"{{token}}\", type: \"string\" }] };\n}\n\nfunction isBearer(scheme: OpenApiSecurityScheme | undefined): boolean {\n  return scheme?.type === \"http\" && scheme.scheme.toLowerCase() === \"bearer\";\n}\n\n/**\n * Whether the document declares an HTTP bearer scheme, which is what the collection-level\n * auth stands for.\n */\nexport function hasBearerScheme(components: OpenApiComponents | undefined): boolean {\n  return Object.values(components?.securitySchemes ?? {}).some(isBearer);\n}\n\n/**\n * How one operation relates to the collection-level bearer auth.\n *\n * - No `security` (a public route): `noauth`, so the token is not sent.\n * - A bearer requirement: inherits the collection auth.\n * - Cookie-only: `noauth` plus a note, because Postman keeps cookies per domain instead of\n *   in collection auth.\n */\nexport function resolveOperationAuth(\n  operation: OpenApiOperation,\n  components: OpenApiComponents | undefined,\n): OperationAuth {\n  const bearerDocument = hasBearerScheme(components);\n  const schemes = components?.securitySchemes ?? {};\n  const names = (operation.security ?? []).flatMap((requirement) => Object.keys(requirement));\n\n  if (names.some((name) => isBearer(schemes[name]))) {\n    return {};\n  }\n\n  const cookies = names.flatMap((name) => {\n    const scheme = schemes[name];\n\n    return scheme?.type === \"apiKey\" && scheme.in === \"cookie\" ? [scheme.name] : [];\n  });\n\n  const auth = bearerDocument ? { auth: { type: \"noauth\" } as const } : {};\n\n  if (cookies.length === 0) {\n    return auth;\n  }\n\n  const cookieList = cookies.map((cookie) => `\"${cookie}\"`).join(\", \");\n\n  return {\n    ...auth,\n    note: `Authenticates with the ${cookieList} cookie. Postman keeps cookies per domain, so sign in against {{baseUrl}} first or add the cookie in the Cookies manager.`,\n  };\n}\n"],"mappings":";;AAWA,SAAgB,uBAAoC;CAClD,OAAO;EAAE,MAAM;EAAU,QAAQ,CAAC;GAAE,KAAK;GAAS,OAAO;GAAa,MAAM;EAAS,CAAC;CAAE;AAC1F;AAEA,SAAS,SAAS,QAAoD;CACpE,OAAO,QAAQ,SAAS,UAAU,OAAO,OAAO,YAAY,MAAM;AACpE;;;;;AAMA,SAAgB,gBAAgB,YAAoD;CAClF,OAAO,OAAO,OAAO,YAAY,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ;AACvE;;;;;;;;;AAUA,SAAgB,qBACd,WACA,YACe;CACf,MAAM,iBAAiB,gBAAgB,UAAU;CACjD,MAAM,UAAU,YAAY,mBAAmB,CAAC;CAChD,MAAM,SAAS,UAAU,YAAY,CAAC,EAAC,CAAE,SAAS,gBAAgB,OAAO,KAAK,WAAW,CAAC;CAE1F,IAAI,MAAM,MAAM,SAAS,SAAS,QAAQ,KAAK,CAAC,GAC9C,OAAO,CAAC;CAGV,MAAM,UAAU,MAAM,SAAS,SAAS;EACtC,MAAM,SAAS,QAAQ;EAEvB,OAAO,QAAQ,SAAS,YAAY,OAAO,OAAO,WAAW,CAAC,OAAO,IAAI,IAAI,CAAC;CAChF,CAAC;CAED,MAAM,OAAO,iBAAiB,EAAE,MAAM,EAAE,MAAM,SAAS,EAAW,IAAI,CAAC;CAEvE,IAAI,QAAQ,WAAW,GACrB,OAAO;CAGT,MAAM,aAAa,QAAQ,KAAK,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC,KAAK,IAAI;CAEnE,OAAO;EACL,GAAG;EACH,MAAM,0BAA0B,WAAW;CAC7C;AACF"}

package/esm/openapi/postman/schema-refs.d.mts

@@ -0,0 +1,7 @@
+import { OpenApiSchema } from "../types.mjs";
+
+//#region ../core/src/openapi/postman/schema-refs.d.ts
+type SchemaComponents = Record<string, OpenApiSchema> | undefined;
+//#endregion
+export { SchemaComponents };
+//# sourceMappingURL=schema-refs.d.mts.map

package/esm/openapi/postman/schema-refs.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-refs.d.mts","names":[],"sources":["../../../../../../../../core/src/openapi/postman/schema-refs.ts"],"mappings":";;;KAEY,gBAAA,GAAmB,MAAM,SAAS,aAAA"}

package/esm/openapi/postman/schema-refs.mjs

@@ -0,0 +1,41 @@
+//#region ../core/src/openapi/postman/schema-refs.ts
+const REF_PREFIX = "#/components/schemas/";
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+* Component name a `$ref` schema points at, or `undefined` for a schema that is not a local
+* component reference.
+*/
+function refName(schema) {
+	const ref = schema.$ref;
+	return typeof ref === "string" && ref.startsWith(REF_PREFIX) ? ref.slice(21) : void 0;
+}
+/**
+* Follow `$ref`s (with a hop limit, so a ref loop cannot hang) to the schema they name.
+* An unknown component resolves to `{}`.
+*/
+function resolveSchema(schema, components) {
+	let current = schema;
+	for (let hop = 0; hop < 32; hop++) {
+		const name = refName(current);
+		if (name === void 0) return current;
+		current = components?.[name] ?? {};
+	}
+	return {};
+}
+/**
+* The effective JSON Schema type: `type`, or the first non-null member of a `type` array
+* (the 3.1 nullable form), or one inferred from `properties` / `items`.
+*/
+function primaryType(schema) {
+	const { type } = schema;
+	if (typeof type === "string") return type;
+	if (Array.isArray(type)) return type.find((member) => typeof member === "string" && member !== "null") ?? (type.includes("null") ? "null" : void 0);
+	if (isRecord(schema.properties)) return "object";
+	if (isRecord(schema.items)) return "array";
+}
+
+//#endregion
+export { isRecord, primaryType, refName, resolveSchema };
+//# sourceMappingURL=schema-refs.mjs.map

package/esm/openapi/postman/schema-refs.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-refs.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/schema-refs.ts"],"sourcesContent":["import type { OpenApiSchema } from \"../types\";\n\nexport type SchemaComponents = Record<string, OpenApiSchema> | undefined;\n\nconst REF_PREFIX = \"#/components/schemas/\";\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Component name a `$ref` schema points at, or `undefined` for a schema that is not a local\n * component reference.\n */\nexport function refName(schema: OpenApiSchema): string | undefined {\n  const ref = schema.$ref;\n\n  return typeof ref === \"string\" && ref.startsWith(REF_PREFIX) ? ref.slice(REF_PREFIX.length) : undefined;\n}\n\n/**\n * Follow `$ref`s (with a hop limit, so a ref loop cannot hang) to the schema they name.\n * An unknown component resolves to `{}`.\n */\nexport function resolveSchema(schema: OpenApiSchema, components: SchemaComponents): OpenApiSchema {\n  let current = schema;\n\n  for (let hop = 0; hop < 32; hop++) {\n    const name = refName(current);\n\n    if (name === undefined) {\n      return current;\n    }\n\n    current = components?.[name] ?? {};\n  }\n\n  return {};\n}\n\n/**\n * The effective JSON Schema type: `type`, or the first non-null member of a `type` array\n * (the 3.1 nullable form), or one inferred from `properties` / `items`.\n */\nexport function primaryType(schema: OpenApiSchema): string | undefined {\n  const { type } = schema;\n\n  if (typeof type === \"string\") {\n    return type;\n  }\n\n  if (Array.isArray(type)) {\n    const concrete = type.find((member): member is string => typeof member === \"string\" && member !== \"null\");\n\n    return concrete ?? (type.includes(\"null\") ? \"null\" : undefined);\n  }\n\n  if (isRecord(schema.properties)) {\n    return \"object\";\n  }\n\n  if (isRecord(schema.items)) {\n    return \"array\";\n  }\n\n  return undefined;\n}\n"],"mappings":";AAIA,MAAM,aAAa;AAEnB,SAAgB,SAAS,OAAkD;CACzE,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;;;;;AAMA,SAAgB,QAAQ,QAA2C;CACjE,MAAM,MAAM,OAAO;CAEnB,OAAO,OAAO,QAAQ,YAAY,IAAI,WAAW,UAAU,IAAI,IAAI,MAAM,EAAiB,IAAI;AAChG;;;;;AAMA,SAAgB,cAAc,QAAuB,YAA6C;CAChG,IAAI,UAAU;CAEd,KAAK,IAAI,MAAM,GAAG,MAAM,IAAI,OAAO;EACjC,MAAM,OAAO,QAAQ,OAAO;EAE5B,IAAI,SAAS,QACX,OAAO;EAGT,UAAU,aAAa,SAAS,CAAC;CACnC;CAEA,OAAO,CAAC;AACV;;;;;AAMA,SAAgB,YAAY,QAA2C;CACrE,MAAM,EAAE,SAAS;CAEjB,IAAI,OAAO,SAAS,UAClB,OAAO;CAGT,IAAI,MAAM,QAAQ,IAAI,GAGpB,OAFiB,KAAK,MAAM,WAA6B,OAAO,WAAW,YAAY,WAAW,MAEpF,MAAM,KAAK,SAAS,MAAM,IAAI,SAAS;CAGvD,IAAI,SAAS,OAAO,UAAU,GAC5B,OAAO;CAGT,IAAI,SAAS,OAAO,KAAK,GACvB,OAAO;AAIX"}