@warlock.js/core 5.26.0 → 5.28.0

package/esm/openapi/paths.mjs

@@ -0,0 +1,63 @@
+//#region ../core/src/openapi/paths.ts
+/**
+* The concrete verbs an `all` route expands into. Mirrors `ALL_METHODS` in the route registry.
+*/
+const ALL_METHODS = [
+	"get",
+	"post",
+	"put",
+	"patch",
+	"delete",
+	"options",
+	"head"
+];
+const PATH_PARAM_PATTERN = /:([A-Za-z_][A-Za-z0-9_]*)(\([^)]*\))?/g;
+/**
+* Convert a Warlock path into an OpenAPI path template: `/users/:id` -> `/users/{id}`.
+* A Fastify-style regex suffix (`:id(\d+)`) is dropped.
+*/
+function toOpenApiPath(path) {
+	return path.replace(PATH_PARAM_PATTERN, (_match, name) => `{${name}}`);
+}
+/**
+* Names of the path parameters of a Warlock path, in order of appearance.
+*/
+function extractPathParamNames(path) {
+	return [...path.matchAll(PATH_PARAM_PATTERN)].flatMap((match) => match[1] ?? []);
+}
+/**
+* Lowercase operation verbs of a route method; `all` expands to every verb.
+*/
+function expandMethods(method) {
+	const lowered = String(method).toLowerCase();
+	if (lowered === "all") return [...ALL_METHODS];
+	return ALL_METHODS.includes(lowered) ? [lowered] : [];
+}
+/**
+* `operationId` for an operation. A named route keeps its name (with `.<verb>` appended when
+* an `all` route expands into several operations); an unnamed route gets a `method_path_slug`
+* id such as `get_users_id`.
+*/
+function buildOperationId(name, method, path, expanded) {
+	if (name) return expanded ? `${name}.${method}` : name;
+	const slug = path.replace(PATH_PARAM_PATTERN, "$1").replace(/[^A-Za-z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+	return slug ? `${method}_${slug}` : method;
+}
+/**
+* Tag of a route: its first static path segment (`/users/:id` -> `users`).
+*/
+function firstSegmentTag(path) {
+	const segment = path.split("/").find((part) => part.length > 0);
+	if (!segment || segment.startsWith(":") || segment === "*") return;
+	return segment;
+}
+/**
+* Verbs whose requests carry no body, so unscoped validation maps to query parameters.
+*/
+function isBodylessMethod(method) {
+	return method === "get" || method === "head" || method === "delete" || method === "options";
+}
+
+//#endregion
+export { buildOperationId, expandMethods, extractPathParamNames, firstSegmentTag, isBodylessMethod, toOpenApiPath };
+//# sourceMappingURL=paths.mjs.map

package/esm/openapi/paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../../../../../../core/src/openapi/paths.ts"],"sourcesContent":["import type { RequestMethod } from \"../router/types\";\n\n/**\n * The concrete verbs an `all` route expands into. Mirrors `ALL_METHODS` in the route registry.\n */\nconst ALL_METHODS = [\"get\", \"post\", \"put\", \"patch\", \"delete\", \"options\", \"head\"] as const;\n\nexport type OpenApiMethod = (typeof ALL_METHODS)[number];\n\nconst PATH_PARAM_PATTERN = /:([A-Za-z_][A-Za-z0-9_]*)(\\([^)]*\\))?/g;\n\n/**\n * Convert a Warlock path into an OpenAPI path template: `/users/:id` -> `/users/{id}`.\n * A Fastify-style regex suffix (`:id(\\d+)`) is dropped.\n */\nexport function toOpenApiPath(path: string): string {\n  return path.replace(PATH_PARAM_PATTERN, (_match, name: string) => `{${name}}`);\n}\n\n/**\n * Names of the path parameters of a Warlock path, in order of appearance.\n */\nexport function extractPathParamNames(path: string): string[] {\n  return [...path.matchAll(PATH_PARAM_PATTERN)].flatMap((match) => match[1] ?? []);\n}\n\n/**\n * Lowercase operation verbs of a route method; `all` expands to every verb.\n */\nexport function expandMethods(method: RequestMethod | string): OpenApiMethod[] {\n  const lowered = String(method).toLowerCase();\n\n  if (lowered === \"all\") {\n    return [...ALL_METHODS];\n  }\n\n  return (ALL_METHODS as readonly string[]).includes(lowered) ? [lowered as OpenApiMethod] : [];\n}\n\n/**\n * `operationId` for an operation. A named route keeps its name (with `.<verb>` appended when\n * an `all` route expands into several operations); an unnamed route gets a `method_path_slug`\n * id such as `get_users_id`.\n */\nexport function buildOperationId(\n  name: string | undefined,\n  method: OpenApiMethod,\n  path: string,\n  expanded: boolean,\n): string {\n  if (name) {\n    return expanded ? `${name}.${method}` : name;\n  }\n\n  const slug = path\n    .replace(PATH_PARAM_PATTERN, \"$1\")\n    .replace(/[^A-Za-z0-9]+/g, \"_\")\n    .replace(/^_+|_+$/g, \"\");\n\n  return slug ? `${method}_${slug}` : method;\n}\n\n/**\n * Tag of a route: its first static path segment (`/users/:id` -> `users`).\n */\nexport function firstSegmentTag(path: string): string | undefined {\n  const segment = path.split(\"/\").find((part) => part.length > 0);\n\n  if (!segment || segment.startsWith(\":\") || segment === \"*\") {\n    return undefined;\n  }\n\n  return segment;\n}\n\n/**\n * Verbs whose requests carry no body, so unscoped validation maps to query parameters.\n */\nexport function isBodylessMethod(method: OpenApiMethod): boolean {\n  return method === \"get\" || method === \"head\" || method === \"delete\" || method === \"options\";\n}\n"],"mappings":";;;;AAKA,MAAM,cAAc;CAAC;CAAO;CAAQ;CAAO;CAAS;CAAU;CAAW;AAAM;AAI/E,MAAM,qBAAqB;;;;;AAM3B,SAAgB,cAAc,MAAsB;CAClD,OAAO,KAAK,QAAQ,qBAAqB,QAAQ,SAAiB,IAAI,KAAK,EAAE;AAC/E;;;;AAKA,SAAgB,sBAAsB,MAAwB;CAC5D,OAAO,CAAC,GAAG,KAAK,SAAS,kBAAkB,CAAC,CAAC,CAAC,SAAS,UAAU,MAAM,MAAM,CAAC,CAAC;AACjF;;;;AAKA,SAAgB,cAAc,QAAiD;CAC7E,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,YAAY;CAE3C,IAAI,YAAY,OACd,OAAO,CAAC,GAAG,WAAW;CAGxB,OAAQ,YAAkC,SAAS,OAAO,IAAI,CAAC,OAAwB,IAAI,CAAC;AAC9F;;;;;;AAOA,SAAgB,iBACd,MACA,QACA,MACA,UACQ;CACR,IAAI,MACF,OAAO,WAAW,GAAG,KAAK,GAAG,WAAW;CAG1C,MAAM,OAAO,KACV,QAAQ,oBAAoB,IAAI,CAAC,CACjC,QAAQ,kBAAkB,GAAG,CAAC,CAC9B,QAAQ,YAAY,EAAE;CAEzB,OAAO,OAAO,GAAG,OAAO,GAAG,SAAS;AACtC;;;;AAKA,SAAgB,gBAAgB,MAAkC;CAChE,MAAM,UAAU,KAAK,MAAM,GAAG,CAAC,CAAC,MAAM,SAAS,KAAK,SAAS,CAAC;CAE9D,IAAI,CAAC,WAAW,QAAQ,WAAW,GAAG,KAAK,YAAY,KACrD;CAGF,OAAO;AACT;;;;AAKA,SAAgB,iBAAiB,QAAgC;CAC/D,OAAO,WAAW,SAAS,WAAW,UAAU,WAAW,YAAY,WAAW;AACpF"}

package/esm/openapi/postman/build-request-body.mjs

@@ -0,0 +1,86 @@
+import { isRecord, primaryType, resolveSchema } from "./schema-refs.mjs";
+import { exampleFromSchema } from "./example-from-schema.mjs";
+
+//#region ../core/src/openapi/postman/build-request-body.ts
+const MULTIPART = "multipart/form-data";
+const URL_ENCODED = "application/x-www-form-urlencoded";
+function isJsonContentType(contentType) {
+	return contentType === "application/json" || contentType.endsWith("+json");
+}
+function stringifyValue(value) {
+	if (typeof value === "string") return value;
+	return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);
+}
+function isFileSchema(schema, components) {
+	const resolved = resolveSchema(schema, components);
+	if (resolved.format === "binary" || typeof resolved.contentMediaType === "string") return true;
+	return primaryType(resolved) === "array" && isRecord(resolved.items) ? isFileSchema(resolved.items, components) : false;
+}
+function formFields(schema, components) {
+	const resolved = resolveSchema(schema, components);
+	const properties = isRecord(resolved.properties) ? resolved.properties : {};
+	return Object.entries(properties).flatMap(([key, property]) => {
+		if (!isRecord(property)) return [];
+		const description = typeof property.description === "string" ? { description: property.description } : {};
+		if (isFileSchema(property, components)) return [{
+			key,
+			type: "file",
+			src: [],
+			...description
+		}];
+		return [{
+			key,
+			value: stringifyValue(exampleFromSchema(property, components)),
+			type: "text",
+			...description
+		}];
+	});
+}
+function pickContentType(contentTypes) {
+	return contentTypes.find(isJsonContentType) ?? contentTypes.find((contentType) => contentType === MULTIPART) ?? contentTypes.find((contentType) => contentType === URL_ENCODED) ?? contentTypes[0];
+}
+/**
+* The Postman body of an operation's request body: JSON becomes a raw JSON example, multipart
+* becomes `formdata` (binary properties as file rows), url-encoded becomes `urlencoded`.
+*
+* @returns `undefined` when the operation has no usable body.
+*/
+function buildRequestBody(requestBody, components) {
+	if (!requestBody) return;
+	const contentType = pickContentType(Object.keys(requestBody.content));
+	const schema = contentType !== void 0 ? requestBody.content[contentType]?.schema : void 0;
+	if (contentType === void 0 || schema === void 0) return;
+	if (contentType === MULTIPART) return { body: {
+		mode: "formdata",
+		formdata: formFields(schema, components)
+	} };
+	if (contentType === URL_ENCODED) return { body: {
+		mode: "urlencoded",
+		urlencoded: formFields(schema, components).flatMap((field) => field.type === "text" ? [{
+			key: field.key,
+			value: field.value,
+			type: "text"
+		}] : [])
+	} };
+	const example = exampleFromSchema(schema, components);
+	if (isJsonContentType(contentType)) return {
+		contentType,
+		body: {
+			mode: "raw",
+			raw: JSON.stringify(example, null, 2),
+			options: { raw: { language: "json" } }
+		}
+	};
+	return {
+		contentType,
+		body: {
+			mode: "raw",
+			raw: typeof example === "string" ? example : "",
+			options: { raw: { language: "text" } }
+		}
+	};
+}
+
+//#endregion
+export { buildRequestBody };
+//# sourceMappingURL=build-request-body.mjs.map

package/esm/openapi/postman/build-request-body.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-request-body.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/build-request-body.ts"],"sourcesContent":["import type { OpenApiRequestBody, OpenApiSchema } from \"../types\";\nimport { exampleFromSchema } from \"./example-from-schema\";\nimport type { PostmanBody, PostmanFormParam } from \"./postman-types\";\nimport { isRecord, primaryType, resolveSchema, type SchemaComponents } from \"./schema-refs\";\n\nexport type RequestBodyParts = {\n  body: PostmanBody;\n  /** Set when the request needs an explicit `Content-Type` header; Postman adds the form ones itself. */\n  contentType?: string;\n};\n\nconst MULTIPART = \"multipart/form-data\";\nconst URL_ENCODED = \"application/x-www-form-urlencoded\";\n\nfunction isJsonContentType(contentType: string): boolean {\n  return contentType === \"application/json\" || contentType.endsWith(\"+json\");\n}\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\nfunction isFileSchema(schema: OpenApiSchema, components: SchemaComponents): boolean {\n  const resolved = resolveSchema(schema, components);\n\n  if (resolved.format === \"binary\" || typeof resolved.contentMediaType === \"string\") {\n    return true;\n  }\n\n  return primaryType(resolved) === \"array\" && isRecord(resolved.items)\n    ? isFileSchema(resolved.items, components)\n    : false;\n}\n\nfunction formFields(schema: OpenApiSchema, components: SchemaComponents): PostmanFormParam[] {\n  const resolved = resolveSchema(schema, components);\n  const properties = isRecord(resolved.properties) ? resolved.properties : {};\n\n  return Object.entries(properties).flatMap(([key, property]): PostmanFormParam[] => {\n    if (!isRecord(property)) {\n      return [];\n    }\n\n    const description = typeof property.description === \"string\" ? { description: property.description } : {};\n\n    if (isFileSchema(property, components)) {\n      return [{ key, type: \"file\", src: [], ...description }];\n    }\n\n    return [{ key, value: stringifyValue(exampleFromSchema(property, components)), type: \"text\", ...description }];\n  });\n}\n\nfunction pickContentType(contentTypes: string[]): string | undefined {\n  return (\n    contentTypes.find(isJsonContentType) ??\n    contentTypes.find((contentType) => contentType === MULTIPART) ??\n    contentTypes.find((contentType) => contentType === URL_ENCODED) ??\n    contentTypes[0]\n  );\n}\n\n/**\n * The Postman body of an operation's request body: JSON becomes a raw JSON example, multipart\n * becomes `formdata` (binary properties as file rows), url-encoded becomes `urlencoded`.\n *\n * @returns `undefined` when the operation has no usable body.\n */\nexport function buildRequestBody(\n  requestBody: OpenApiRequestBody | undefined,\n  components: SchemaComponents,\n): RequestBodyParts | undefined {\n  if (!requestBody) {\n    return undefined;\n  }\n\n  const contentType = pickContentType(Object.keys(requestBody.content));\n  const schema = contentType !== undefined ? requestBody.content[contentType]?.schema : undefined;\n\n  if (contentType === undefined || schema === undefined) {\n    return undefined;\n  }\n\n  if (contentType === MULTIPART) {\n    return { body: { mode: \"formdata\", formdata: formFields(schema, components) } };\n  }\n\n  if (contentType === URL_ENCODED) {\n    const urlencoded = formFields(schema, components).flatMap((field) =>\n      field.type === \"text\" ? [{ key: field.key, value: field.value, type: \"text\" as const }] : [],\n    );\n\n    return { body: { mode: \"urlencoded\", urlencoded } };\n  }\n\n  const example = exampleFromSchema(schema, components);\n\n  if (isJsonContentType(contentType)) {\n    return {\n      contentType,\n      body: {\n        mode: \"raw\",\n        raw: JSON.stringify(example, null, 2),\n        options: { raw: { language: \"json\" } },\n      },\n    };\n  }\n\n  return {\n    contentType,\n    body: {\n      mode: \"raw\",\n      raw: typeof example === \"string\" ? example : \"\",\n      options: { raw: { language: \"text\" } },\n    },\n  };\n}\n"],"mappings":";;;;AAWA,MAAM,YAAY;AAClB,MAAM,cAAc;AAEpB,SAAS,kBAAkB,aAA8B;CACvD,OAAO,gBAAgB,sBAAsB,YAAY,SAAS,OAAO;AAC3E;AAEA,SAAS,eAAe,OAAwB;CAC9C,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,OAAO,SAAS,KAAK,KAAK,MAAM,QAAQ,KAAK,IAAI,KAAK,UAAU,KAAK,IAAI,OAAO,KAAK;AACvF;AAEA,SAAS,aAAa,QAAuB,YAAuC;CAClF,MAAM,WAAW,cAAc,QAAQ,UAAU;CAEjD,IAAI,SAAS,WAAW,YAAY,OAAO,SAAS,qBAAqB,UACvE,OAAO;CAGT,OAAO,YAAY,QAAQ,MAAM,WAAW,SAAS,SAAS,KAAK,IAC/D,aAAa,SAAS,OAAO,UAAU,IACvC;AACN;AAEA,SAAS,WAAW,QAAuB,YAAkD;CAC3F,MAAM,WAAW,cAAc,QAAQ,UAAU;CACjD,MAAM,aAAa,SAAS,SAAS,UAAU,IAAI,SAAS,aAAa,CAAC;CAE1E,OAAO,OAAO,QAAQ,UAAU,CAAC,CAAC,SAAS,CAAC,KAAK,cAAkC;EACjF,IAAI,CAAC,SAAS,QAAQ,GACpB,OAAO,CAAC;EAGV,MAAM,cAAc,OAAO,SAAS,gBAAgB,WAAW,EAAE,aAAa,SAAS,YAAY,IAAI,CAAC;EAExG,IAAI,aAAa,UAAU,UAAU,GACnC,OAAO,CAAC;GAAE;GAAK,MAAM;GAAQ,KAAK,CAAC;GAAG,GAAG;EAAY,CAAC;EAGxD,OAAO,CAAC;GAAE;GAAK,OAAO,eAAe,kBAAkB,UAAU,UAAU,CAAC;GAAG,MAAM;GAAQ,GAAG;EAAY,CAAC;CAC/G,CAAC;AACH;AAEA,SAAS,gBAAgB,cAA4C;CACnE,OACE,aAAa,KAAK,iBAAiB,KACnC,aAAa,MAAM,gBAAgB,gBAAgB,SAAS,KAC5D,aAAa,MAAM,gBAAgB,gBAAgB,WAAW,KAC9D,aAAa;AAEjB;;;;;;;AAQA,SAAgB,iBACd,aACA,YAC8B;CAC9B,IAAI,CAAC,aACH;CAGF,MAAM,cAAc,gBAAgB,OAAO,KAAK,YAAY,OAAO,CAAC;CACpE,MAAM,SAAS,gBAAgB,SAAY,YAAY,QAAQ,YAAY,EAAE,SAAS;CAEtF,IAAI,gBAAgB,UAAa,WAAW,QAC1C;CAGF,IAAI,gBAAgB,WAClB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAY,UAAU,WAAW,QAAQ,UAAU;CAAE,EAAE;CAGhF,IAAI,gBAAgB,aAKlB,OAAO,EAAE,MAAM;EAAE,MAAM;EAAc,YAJlB,WAAW,QAAQ,UAAU,CAAC,CAAC,SAAS,UACzD,MAAM,SAAS,SAAS,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,MAAM;EAAgB,CAAC,IAAI,CAAC,CAG/C;CAAE,EAAE;CAGpD,MAAM,UAAU,kBAAkB,QAAQ,UAAU;CAEpD,IAAI,kBAAkB,WAAW,GAC/B,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,KAAK,UAAU,SAAS,MAAM,CAAC;GACpC,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;CAGF,OAAO;EACL;EACA,MAAM;GACJ,MAAM;GACN,KAAK,OAAO,YAAY,WAAW,UAAU;GAC7C,SAAS,EAAE,KAAK,EAAE,UAAU,OAAO,EAAE;EACvC;CACF;AACF"}

package/esm/openapi/postman/build-request-url.mjs

@@ -0,0 +1,85 @@
+import { isRecord, resolveSchema } from "./schema-refs.mjs";
+
+//#region ../core/src/openapi/postman/build-request-url.ts
+/** The Postman variable every request URL starts with. */
+const BASE_URL_HOST = "{{baseUrl}}";
+const PATH_TEMPLATE_PARAM = /\{([^}]+)\}/g;
+function stringifyValue(value) {
+	if (typeof value === "string") return value;
+	return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);
+}
+/**
+* Value a parameter starts with in Postman: its declared `example`, `default`, `const` or
+* first `enum` value, otherwise empty so the caller fills it in.
+*/
+function parameterValue(schema, components) {
+	const resolved = resolveSchema(schema, components);
+	for (const key of [
+		"example",
+		"default",
+		"const"
+	]) if (key in resolved) return stringifyValue(resolved[key]);
+	if (Array.isArray(resolved.enum) && resolved.enum.length > 0) return stringifyValue(resolved.enum[0]);
+	return "";
+}
+function withDescription(row, parameter) {
+	return parameter.description ? {
+		...row,
+		description: parameter.description
+	} : row;
+}
+function queryRows(parameter, components) {
+	const disabled = parameter.required === true ? {} : { disabled: true };
+	const schema = resolveSchema(parameter.schema, components);
+	if (parameter.style === "deepObject" && isRecord(schema.properties)) return Object.entries(schema.properties).map(([property, propertySchema]) => ({
+		key: `${parameter.name}[${property}]`,
+		value: isRecord(propertySchema) ? parameterValue(propertySchema, components) : "",
+		...disabled
+	}));
+	return [{
+		key: parameter.name,
+		value: parameterValue(parameter.schema, components),
+		...parameter.description ? { description: parameter.description } : {},
+		...disabled
+	}];
+}
+/**
+* Header rows for the `header` parameters of an operation. Optional ones start disabled.
+*/
+function buildHeaderParameters(parameters, components) {
+	return parameters.filter((parameter) => parameter.in === "header").map((parameter) => withDescription({
+		key: parameter.name,
+		value: parameterValue(parameter.schema, components),
+		...parameter.required === true ? {} : { disabled: true }
+	}, parameter));
+}
+/**
+* The Postman URL of an operation: `{id}` templates become `:id` path variables, query
+* parameters become rows (optional ones disabled, so `raw` carries only the enabled ones).
+*/
+function buildRequestUrl(path, parameters, components) {
+	const segments = path.split("/").filter((segment) => segment.length > 0).map((segment) => segment.replace(PATH_TEMPLATE_PARAM, ":$1"));
+	const variables = [...path.matchAll(PATH_TEMPLATE_PARAM)].flatMap((match) => {
+		const name = match[1];
+		if (name === void 0) return [];
+		const description = parameters.find((parameter) => parameter.in === "path" && parameter.name === name)?.description;
+		return [{
+			key: name,
+			value: "",
+			...description ? { description } : {}
+		}];
+	});
+	const query = parameters.filter((parameter) => parameter.in === "query").flatMap((parameter) => queryRows(parameter, components));
+	const search = query.filter((row) => row.disabled !== true).map((row) => `${row.key}=${row.value}`).join("&");
+	return {
+		raw: `${BASE_URL_HOST}/${segments.join("/")}${search ? `?${search}` : ""}`,
+		host: [BASE_URL_HOST],
+		path: segments,
+		...variables.length > 0 ? { variable: variables } : {},
+		...query.length > 0 ? { query } : {}
+	};
+}
+
+//#endregion
+export { buildHeaderParameters, buildRequestUrl };
+//# sourceMappingURL=build-request-url.mjs.map

package/esm/openapi/postman/build-request-url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-request-url.mjs","names":[],"sources":["../../../../../../../../core/src/openapi/postman/build-request-url.ts"],"sourcesContent":["import type { OpenApiParameter, OpenApiSchema } from \"../types\";\nimport { isRecord, resolveSchema, type SchemaComponents } from \"./schema-refs\";\nimport type { PostmanHeader, PostmanQueryParam, PostmanUrl, PostmanVariable } from \"./postman-types\";\n\n/** The Postman variable every request URL starts with. */\nexport const BASE_URL_HOST = \"{{baseUrl}}\";\n\nconst PATH_TEMPLATE_PARAM = /\\{([^}]+)\\}/g;\n\nfunction stringifyValue(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  return isRecord(value) || Array.isArray(value) ? JSON.stringify(value) : String(value);\n}\n\n/**\n * Value a parameter starts with in Postman: its declared `example`, `default`, `const` or\n * first `enum` value, otherwise empty so the caller fills it in.\n */\nfunction parameterValue(schema: OpenApiSchema, components: SchemaComponents): string {\n  const resolved = resolveSchema(schema, components);\n\n  for (const key of [\"example\", \"default\", \"const\"]) {\n    if (key in resolved) {\n      return stringifyValue(resolved[key]);\n    }\n  }\n\n  if (Array.isArray(resolved.enum) && resolved.enum.length > 0) {\n    return stringifyValue(resolved.enum[0]);\n  }\n\n  return \"\";\n}\n\nfunction withDescription<T extends object>(row: T, parameter: OpenApiParameter): T & { description?: string } {\n  return parameter.description ? { ...row, description: parameter.description } : row;\n}\n\nfunction queryRows(parameter: OpenApiParameter, components: SchemaComponents): PostmanQueryParam[] {\n  const disabled = parameter.required === true ? {} : { disabled: true as const };\n  const schema = resolveSchema(parameter.schema, components);\n\n  if (parameter.style === \"deepObject\" && isRecord(schema.properties)) {\n    return Object.entries(schema.properties).map(([property, propertySchema]) => ({\n      key: `${parameter.name}[${property}]`,\n      value: isRecord(propertySchema) ? parameterValue(propertySchema, components) : \"\",\n      ...disabled,\n    }));\n  }\n\n  return [\n    {\n      key: parameter.name,\n      value: parameterValue(parameter.schema, components),\n      ...(parameter.description ? { description: parameter.description } : {}),\n      ...disabled,\n    },\n  ];\n}\n\n/**\n * Header rows for the `header` parameters of an operation. Optional ones start disabled.\n */\nexport function buildHeaderParameters(\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanHeader[] {\n  return parameters\n    .filter((parameter) => parameter.in === \"header\")\n    .map((parameter) =>\n      withDescription(\n        {\n          key: parameter.name,\n          value: parameterValue(parameter.schema, components),\n          ...(parameter.required === true ? {} : { disabled: true as const }),\n        },\n        parameter,\n      ),\n    );\n}\n\n/**\n * The Postman URL of an operation: `{id}` templates become `:id` path variables, query\n * parameters become rows (optional ones disabled, so `raw` carries only the enabled ones).\n */\nexport function buildRequestUrl(\n  path: string,\n  parameters: readonly OpenApiParameter[],\n  components: SchemaComponents,\n): PostmanUrl {\n  const segments = path\n    .split(\"/\")\n    .filter((segment) => segment.length > 0)\n    .map((segment) => segment.replace(PATH_TEMPLATE_PARAM, \":$1\"));\n\n  const variables: PostmanVariable[] = [...path.matchAll(PATH_TEMPLATE_PARAM)].flatMap((match) => {\n    const name = match[1];\n\n    if (name === undefined) {\n      return [];\n    }\n\n    const description = parameters.find((parameter) => parameter.in === \"path\" && parameter.name === name)\n      ?.description;\n\n    return [{ key: name, value: \"\", ...(description ? { description } : {}) }];\n  });\n\n  const query = parameters\n    .filter((parameter) => parameter.in === \"query\")\n    .flatMap((parameter) => queryRows(parameter, components));\n\n  const search = query\n    .filter((row) => row.disabled !== true)\n    .map((row) => `${row.key}=${row.value}`)\n    .join(\"&\");\n\n  return {\n    raw: `${BASE_URL_HOST}/${segments.join(\"/\")}${search ? `?${search}` : \"\"}`,\n    host: [BASE_URL_HOST],\n    path: segments,\n    ...(variables.length > 0 ? { variable: variables } : {}),\n    ...(query.length > 0 ? { query } : {}),\n  };\n}\n"],"mappings":"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"}

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"}