openapi-typesafe 1.0.0-rc.3 → 1.0.0-rc.5

package/dist/adapters/redocly-loader/schema-source.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema-source.cjs","sources":["../../../src/adapters/redocly-loader/schema-source.ts"],"sourcesContent":["import { Readable } from \"node:stream\";\nimport { text } from \"node:stream/consumers\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  type BaseResolver,\n  type Document,\n  makeDocumentFromString,\n  ResolveError,\n  Source,\n  YamlParseError,\n} from \"@redocly/openapi-core\";\nimport parseJson from \"parse-json\";\nimport { aliasExpansionFailure } from \"./alias-limit.js\";\nimport {\n  loadFailedError,\n  parseFailedError,\n  pathStringError,\n  sourceEmptyError,\n  sourceInvalidError,\n} from \"./schema-load-errors.js\";\n\n/** Parse a schema source of any supported type into a Redocly document (ENGINEERING_PLAN 4.5). */\n\nexport interface ParseSchemaOptions {\n  absoluteRef: string;\n  resolver: BaseResolver;\n}\n\n/**\n * Read a stream to the end as UTF-8 text, trimmed. A stream that fails rejects with\n * SCHEMA_LOAD_FAILED; listening only for `data` and `end` left the promise pending forever.\n */\nasync function readStream(stream: Readable, absoluteRef: string): Promise<string> {\n  try {\n    return (await text(stream)).trim();\n  } catch (error) {\n    throw loadFailedError(absoluteRef, error);\n  }\n}\n\nconst URL_PREFIXES = [\"http://\", \"https://\", \"file://\"] as const;\n\n/** A string is a URL, JSON (starts with `{`) or YAML. */\nfunction parseSchemaText(\n  schema: string,\n  options: ParseSchemaOptions,\n): Promise<Document> | Document {\n  if (URL_PREFIXES.some((prefix) => schema.startsWith(prefix))) {\n    const url = new URL(schema);\n    const absoluteRef = url.protocol === \"file:\" ? fileURLToPath(url) : url.href;\n    return parseSchema(url, { absoluteRef, resolver: options.resolver });\n  }\n  return schema[0] === \"{\"\n    ? parseJsonText(schema, options.absoluteRef)\n    : parseYamlText(schema, options.absoluteRef);\n}\n\nfunction parseJsonText(text: string, absoluteRef: string): Document {\n  try {\n    return { source: new Source(absoluteRef, text, \"application/json\"), parsed: parseJson(text) };\n  } catch (cause) {\n    throw parseFailedError(\"json\", absoluteRef, cause);\n  }\n}\n\nfunction parseYamlText(text: string, absoluteRef: string): Document {\n  let document: Document;\n  try {\n    document = makeDocumentFromString(text, absoluteRef);\n  } catch (cause) {\n    throw parseFailedError(\"yaml\", absoluteRef, cause);\n  }\n  // Text that is only a YAML string scalar, such as \"./openapi.yaml\", was meant as a file path.\n  if (typeof document.parsed === \"string\") {\n    throw pathStringError(text);\n  }\n  const failure = aliasExpansionFailure(document.parsed);\n  if (failure !== undefined) {\n    throw parseFailedError(\"yaml\", absoluteRef, failure);\n  }\n  return document;\n}\n\n/** The resolver throws for some failures (a missing file) and returns an error for others. */\nasync function resolveSchemaURL(options: ParseSchemaOptions): Promise<Document> {\n  const result = await options.resolver\n    .resolveDocument(null, options.absoluteRef, true)\n    .catch((cause: unknown) => {\n      throw cause instanceof YamlParseError\n        ? fileParseFailedError(options.absoluteRef, cause)\n        : loadFailedError(options.absoluteRef, readerError(cause));\n    });\n  if (\"parsed\" in result) {\n    return result;\n  }\n  throw loadFailedError(options.absoluteRef, readerError(result));\n}\n\n/**\n * Redocly wraps a failed read in `ResolveError`, which keeps the reader's error in\n * `originalError`, not in `cause`. Unwrapped, the cause keeps the network reason (refused, DNS).\n */\nfunction readerError(error: unknown): unknown {\n  let current = error;\n  while (current instanceof ResolveError) {\n    current = current.originalError;\n  }\n  return current;\n}\n\n/**\n * The resolver parses JSON files with its YAML parser too, so the format comes from the file\n * name. Some parser messages (a second YAML document) do not name the file; the error adds it.\n */\nfunction fileParseFailedError(absoluteRef: string, error: YamlParseError): Error {\n  const format = absoluteRef.toLowerCase().endsWith(\".json\") ? \"json\" : \"yaml\";\n  const cause = error.message.includes(absoluteRef)\n    ? error\n    : new Error(`${error.message} in \"${absoluteRef}\"`, { cause: error });\n  return parseFailedError(format, absoluteRef, cause);\n}\n\nfunction parseSchemaObject(schema: unknown, absoluteRef: string): Document {\n  if (typeof schema === \"object\" && !Array.isArray(schema)) {\n    return {\n      source: new Source(absoluteRef, JSON.stringify(schema), \"application/json\"),\n      parsed: schema,\n    };\n  }\n  throw sourceInvalidError(schema);\n}\n\n/** Parse any supported source: URL, stream, buffer, URL or document text, or a plain object. */\nexport async function parseSchema(schema: unknown, options: ParseSchemaOptions): Promise<Document> {\n  if (!schema) {\n    throw sourceEmptyError(\"Can’t parse empty schema\");\n  }\n  if (schema instanceof URL) {\n    return resolveSchemaURL(options);\n  }\n  if (schema instanceof Readable) {\n    return parseSchema(await readStream(schema, options.absoluteRef), options);\n  }\n  if (schema instanceof Buffer) {\n    return parseSchema(schema.toString(\"utf8\"), options);\n  }\n  if (typeof schema === \"string\") {\n    return parseSchemaText(schema, options);\n  }\n  return parseSchemaObject(schema, options.absoluteRef);\n}\n"],"names":["text","loadFailedError","fileURLToPath","Source","parseJson","parseFailedError","makeDocumentFromString","pathStringError","aliasExpansionFailure","YamlParseError","ResolveError","sourceInvalidError","sourceEmptyError","Readable"],"mappings":"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"}
+{"version":3,"file":"schema-source.cjs","sources":["../../../src/adapters/redocly-loader/schema-source.ts"],"sourcesContent":["import { Readable } from \"node:stream\";\nimport { text } from \"node:stream/consumers\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  type BaseResolver,\n  type Document,\n  parseYaml,\n  ResolveError,\n  Source,\n  YamlParseError,\n} from \"@redocly/openapi-core\";\nimport parseJson from \"parse-json\";\nimport { aliasExpansionFailure } from \"./alias-limit.js\";\nimport {\n  loadFailedError,\n  parseFailedError,\n  pathStringError,\n  sourceEmptyError,\n  sourceInvalidError,\n  type TextOrigin,\n  urlInvalidError,\n} from \"./schema-load-errors.js\";\n\n/** Parse a schema source of any supported type into a Redocly document (ENGINEERING_PLAN 4.5). */\n\nexport interface ParseSchemaOptions {\n  absoluteRef: string;\n  resolver: BaseResolver;\n  /** Where document text came from, for the message of text that is only a string. */\n  textOrigin?: TextOrigin;\n}\n\n/**\n * Read a stream to the end as UTF-8 text, trimmed. A stream that fails rejects with\n * SCHEMA_LOAD_FAILED; listening only for `data` and `end` left the promise pending forever.\n */\nasync function readStream(stream: Readable, absoluteRef: string): Promise<string> {\n  try {\n    return (await text(stream)).trim();\n  } catch (error) {\n    throw loadFailedError(absoluteRef, error);\n  }\n}\n\n/** A URL source string; a scheme is the same in any case (RFC 3986, section 3.1). */\nconst URL_PREFIX_RE = /^(?:https?|file):\\/\\//i;\n\n/**\n * A string is a URL, JSON (starts with `{`) or YAML. A string that starts like a URL but does not\n * parse as one fails with `SCHEMA_SOURCE_INVALID`, not the parser's `TypeError`.\n */\nfunction parseSchemaText(\n  schema: string,\n  options: ParseSchemaOptions,\n): Promise<Document> | Document {\n  if (URL_PREFIX_RE.test(schema)) {\n    const url = URL.parse(schema);\n    if (url === null) {\n      throw urlInvalidError(schema);\n    }\n    const absoluteRef = url.protocol === \"file:\" ? fileURLToPath(url) : url.href;\n    return parseSchema(url, { absoluteRef, resolver: options.resolver });\n  }\n  return schema[0] === \"{\"\n    ? parseJsonText(schema, options.absoluteRef)\n    : parseYamlText(schema, options.absoluteRef, options.textOrigin ?? \"string\");\n}\n\nfunction parseJsonText(text: string, absoluteRef: string): Document {\n  try {\n    return { source: new Source(absoluteRef, text, \"application/json\"), parsed: parseJson(text) };\n  } catch (cause) {\n    throw parseFailedError(\"json\", absoluteRef, cause);\n  }\n}\n\n/**\n * How a parser message names document text that is no file. The document itself is named as a\n * file in the working directory, so that its relative `$ref`s resolve there, but no such file\n * exists, and a message that named it sent the user looking for it.\n */\nconst TEXT_ORIGIN_NAMES: Readonly<Record<TextOrigin, string>> = {\n  string: \"the schema string\",\n  stream: \"the schema stream\",\n};\n\nfunction parseYamlText(text: string, absoluteRef: string, origin: TextOrigin): Document {\n  const source = new Source(absoluteRef, text);\n  let document: Document;\n  try {\n    document = { source, parsed: parseYaml(text, { filename: TEXT_ORIGIN_NAMES[origin] }) };\n  } catch (cause) {\n    // As Redocly's own parse: the error keeps the first line, not the parser's code excerpt.\n    throw parseFailedError(\"yaml\", absoluteRef, new YamlParseError(cause as Error, source));\n  }\n  // Text that is only a YAML string scalar, such as \"./openapi.yaml\", was meant as a file path.\n  if (typeof document.parsed === \"string\") {\n    throw pathStringError(text, origin);\n  }\n  const failure = aliasExpansionFailure(document.parsed);\n  if (failure !== undefined) {\n    throw parseFailedError(\"yaml\", absoluteRef, failure);\n  }\n  return document;\n}\n\n/** The resolver throws for some failures (a missing file) and returns an error for others. */\nasync function resolveSchemaURL(options: ParseSchemaOptions): Promise<Document> {\n  const result = await options.resolver\n    .resolveDocument(null, options.absoluteRef, true)\n    .catch((cause: unknown) => {\n      throw cause instanceof YamlParseError\n        ? fileParseFailedError(options.absoluteRef, cause)\n        : loadFailedError(options.absoluteRef, readerError(cause));\n    });\n  if (\"parsed\" in result) {\n    return result;\n  }\n  throw loadFailedError(options.absoluteRef, readerError(result));\n}\n\n/**\n * Redocly wraps a failed read in `ResolveError`, which keeps the reader's error in\n * `originalError`, not in `cause`. Unwrapped, the cause keeps the network reason (refused, DNS).\n */\nfunction readerError(error: unknown): unknown {\n  let current = error;\n  while (current instanceof ResolveError) {\n    current = current.originalError;\n  }\n  return current;\n}\n\n/**\n * The resolver parses JSON files with its YAML parser too, so the format comes from the file\n * name. Some parser messages (a second YAML document) do not name the file; the error adds it.\n */\nfunction fileParseFailedError(absoluteRef: string, error: YamlParseError): Error {\n  const format = absoluteRef.toLowerCase().endsWith(\".json\") ? \"json\" : \"yaml\";\n  const cause = error.message.includes(absoluteRef)\n    ? error\n    : new Error(`${error.message} in \"${absoluteRef}\"`, { cause: error });\n  return parseFailedError(format, absoluteRef, cause);\n}\n\nfunction parseSchemaObject(schema: unknown, absoluteRef: string): Document {\n  if (typeof schema === \"object\" && !Array.isArray(schema)) {\n    return {\n      source: new Source(absoluteRef, JSON.stringify(schema), \"application/json\"),\n      parsed: schema,\n    };\n  }\n  throw sourceInvalidError(schema);\n}\n\n/** Parse any supported source: URL, stream, buffer, URL or document text, or a plain object. */\nexport async function parseSchema(schema: unknown, options: ParseSchemaOptions): Promise<Document> {\n  if (!schema) {\n    throw sourceEmptyError(\"Can’t parse empty schema\");\n  }\n  if (schema instanceof URL) {\n    return resolveSchemaURL(options);\n  }\n  if (schema instanceof Readable) {\n    const text = await readStream(schema, options.absoluteRef);\n    return parseSchema(text, { ...options, textOrigin: \"stream\" });\n  }\n  if (schema instanceof Buffer) {\n    return parseSchema(schema.toString(\"utf8\"), options);\n  }\n  if (typeof schema === \"string\") {\n    return parseSchemaText(schema, options);\n  }\n  return parseSchemaObject(schema, options.absoluteRef);\n}\n"],"names":["text","loadFailedError","urlInvalidError","fileURLToPath","Source","parseJson","parseFailedError","parseYaml","YamlParseError","pathStringError","aliasExpansionFailure","ResolveError","sourceInvalidError","sourceEmptyError","Readable"],"mappings":"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"}

package/dist/adapters/redocly-loader/schema-source.mjs

@@ -1,10 +1,10 @@
 import { Readable } from 'node:stream';
 import { text } from 'node:stream/consumers';
 import { fileURLToPath } from 'node:url';
-import { YamlParseError, Source, ResolveError, makeDocumentFromString } from '@redocly/openapi-core';
+import { YamlParseError, Source, ResolveError, parseYaml } from '@redocly/openapi-core';
 import parseJson from 'parse-json';
 import { aliasExpansionFailure } from './alias-limit.mjs';
-import { sourceEmptyError, loadFailedError, sourceInvalidError, parseFailedError, pathStringError } from './schema-load-errors.mjs';
+import { sourceEmptyError, loadFailedError, urlInvalidError, sourceInvalidError, parseFailedError, pathStringError } from './schema-load-errors.mjs';
 
 async function readStream(stream, absoluteRef) {
   try {
@@ -13,14 +13,17 @@ async function readStream(stream, absoluteRef) {
     throw loadFailedError(absoluteRef, error);
   }
 }
-const URL_PREFIXES = ["http://", "https://", "file://"];
+const URL_PREFIX_RE = /^(?:https?|file):\/\//i;
 function parseSchemaText(schema, options) {
-  if (URL_PREFIXES.some((prefix) => schema.startsWith(prefix))) {
-    const url = new URL(schema);
+  if (URL_PREFIX_RE.test(schema)) {
+    const url = URL.parse(schema);
+    if (url === null) {
+      throw urlInvalidError(schema);
+    }
     const absoluteRef = url.protocol === "file:" ? fileURLToPath(url) : url.href;
     return parseSchema(url, { absoluteRef, resolver: options.resolver });
   }
-  return schema[0] === "{" ? parseJsonText(schema, options.absoluteRef) : parseYamlText(schema, options.absoluteRef);
+  return schema[0] === "{" ? parseJsonText(schema, options.absoluteRef) : parseYamlText(schema, options.absoluteRef, options.textOrigin ?? "string");
 }
 function parseJsonText(text2, absoluteRef) {
   try {
@@ -29,15 +32,20 @@ function parseJsonText(text2, absoluteRef) {
     throw parseFailedError("json", absoluteRef, cause);
   }
 }
-function parseYamlText(text2, absoluteRef) {
+const TEXT_ORIGIN_NAMES = {
+  string: "the schema string",
+  stream: "the schema stream"
+};
+function parseYamlText(text2, absoluteRef, origin) {
+  const source = new Source(absoluteRef, text2);
   let document;
   try {
-    document = makeDocumentFromString(text2, absoluteRef);
+    document = { source, parsed: parseYaml(text2, { filename: TEXT_ORIGIN_NAMES[origin] }) };
   } catch (cause) {
-    throw parseFailedError("yaml", absoluteRef, cause);
+    throw parseFailedError("yaml", absoluteRef, new YamlParseError(cause, source));
   }
   if (typeof document.parsed === "string") {
-    throw pathStringError(text2);
+    throw pathStringError(text2, origin);
   }
   const failure = aliasExpansionFailure(document.parsed);
   if (failure !== void 0) {
@@ -83,7 +91,8 @@ async function parseSchema(schema, options) {
     return resolveSchemaURL(options);
   }
   if (schema instanceof Readable) {
-    return parseSchema(await readStream(schema, options.absoluteRef), options);
+    const text2 = await readStream(schema, options.absoluteRef);
+    return parseSchema(text2, { ...options, textOrigin: "stream" });
   }
   if (schema instanceof Buffer) {
     return parseSchema(schema.toString("utf8"), options);

package/dist/adapters/redocly-loader/schema-source.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema-source.mjs","sources":["../../../src/adapters/redocly-loader/schema-source.ts"],"sourcesContent":["import { Readable } from \"node:stream\";\nimport { text } from \"node:stream/consumers\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  type BaseResolver,\n  type Document,\n  makeDocumentFromString,\n  ResolveError,\n  Source,\n  YamlParseError,\n} from \"@redocly/openapi-core\";\nimport parseJson from \"parse-json\";\nimport { aliasExpansionFailure } from \"./alias-limit.js\";\nimport {\n  loadFailedError,\n  parseFailedError,\n  pathStringError,\n  sourceEmptyError,\n  sourceInvalidError,\n} from \"./schema-load-errors.js\";\n\n/** Parse a schema source of any supported type into a Redocly document (ENGINEERING_PLAN 4.5). */\n\nexport interface ParseSchemaOptions {\n  absoluteRef: string;\n  resolver: BaseResolver;\n}\n\n/**\n * Read a stream to the end as UTF-8 text, trimmed. A stream that fails rejects with\n * SCHEMA_LOAD_FAILED; listening only for `data` and `end` left the promise pending forever.\n */\nasync function readStream(stream: Readable, absoluteRef: string): Promise<string> {\n  try {\n    return (await text(stream)).trim();\n  } catch (error) {\n    throw loadFailedError(absoluteRef, error);\n  }\n}\n\nconst URL_PREFIXES = [\"http://\", \"https://\", \"file://\"] as const;\n\n/** A string is a URL, JSON (starts with `{`) or YAML. */\nfunction parseSchemaText(\n  schema: string,\n  options: ParseSchemaOptions,\n): Promise<Document> | Document {\n  if (URL_PREFIXES.some((prefix) => schema.startsWith(prefix))) {\n    const url = new URL(schema);\n    const absoluteRef = url.protocol === \"file:\" ? fileURLToPath(url) : url.href;\n    return parseSchema(url, { absoluteRef, resolver: options.resolver });\n  }\n  return schema[0] === \"{\"\n    ? parseJsonText(schema, options.absoluteRef)\n    : parseYamlText(schema, options.absoluteRef);\n}\n\nfunction parseJsonText(text: string, absoluteRef: string): Document {\n  try {\n    return { source: new Source(absoluteRef, text, \"application/json\"), parsed: parseJson(text) };\n  } catch (cause) {\n    throw parseFailedError(\"json\", absoluteRef, cause);\n  }\n}\n\nfunction parseYamlText(text: string, absoluteRef: string): Document {\n  let document: Document;\n  try {\n    document = makeDocumentFromString(text, absoluteRef);\n  } catch (cause) {\n    throw parseFailedError(\"yaml\", absoluteRef, cause);\n  }\n  // Text that is only a YAML string scalar, such as \"./openapi.yaml\", was meant as a file path.\n  if (typeof document.parsed === \"string\") {\n    throw pathStringError(text);\n  }\n  const failure = aliasExpansionFailure(document.parsed);\n  if (failure !== undefined) {\n    throw parseFailedError(\"yaml\", absoluteRef, failure);\n  }\n  return document;\n}\n\n/** The resolver throws for some failures (a missing file) and returns an error for others. */\nasync function resolveSchemaURL(options: ParseSchemaOptions): Promise<Document> {\n  const result = await options.resolver\n    .resolveDocument(null, options.absoluteRef, true)\n    .catch((cause: unknown) => {\n      throw cause instanceof YamlParseError\n        ? fileParseFailedError(options.absoluteRef, cause)\n        : loadFailedError(options.absoluteRef, readerError(cause));\n    });\n  if (\"parsed\" in result) {\n    return result;\n  }\n  throw loadFailedError(options.absoluteRef, readerError(result));\n}\n\n/**\n * Redocly wraps a failed read in `ResolveError`, which keeps the reader's error in\n * `originalError`, not in `cause`. Unwrapped, the cause keeps the network reason (refused, DNS).\n */\nfunction readerError(error: unknown): unknown {\n  let current = error;\n  while (current instanceof ResolveError) {\n    current = current.originalError;\n  }\n  return current;\n}\n\n/**\n * The resolver parses JSON files with its YAML parser too, so the format comes from the file\n * name. Some parser messages (a second YAML document) do not name the file; the error adds it.\n */\nfunction fileParseFailedError(absoluteRef: string, error: YamlParseError): Error {\n  const format = absoluteRef.toLowerCase().endsWith(\".json\") ? \"json\" : \"yaml\";\n  const cause = error.message.includes(absoluteRef)\n    ? error\n    : new Error(`${error.message} in \"${absoluteRef}\"`, { cause: error });\n  return parseFailedError(format, absoluteRef, cause);\n}\n\nfunction parseSchemaObject(schema: unknown, absoluteRef: string): Document {\n  if (typeof schema === \"object\" && !Array.isArray(schema)) {\n    return {\n      source: new Source(absoluteRef, JSON.stringify(schema), \"application/json\"),\n      parsed: schema,\n    };\n  }\n  throw sourceInvalidError(schema);\n}\n\n/** Parse any supported source: URL, stream, buffer, URL or document text, or a plain object. */\nexport async function parseSchema(schema: unknown, options: ParseSchemaOptions): Promise<Document> {\n  if (!schema) {\n    throw sourceEmptyError(\"Can’t parse empty schema\");\n  }\n  if (schema instanceof URL) {\n    return resolveSchemaURL(options);\n  }\n  if (schema instanceof Readable) {\n    return parseSchema(await readStream(schema, options.absoluteRef), options);\n  }\n  if (schema instanceof Buffer) {\n    return parseSchema(schema.toString(\"utf8\"), options);\n  }\n  if (typeof schema === \"string\") {\n    return parseSchemaText(schema, options);\n  }\n  return parseSchemaObject(schema, options.absoluteRef);\n}\n"],"names":["text"],"mappings":"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"}
+{"version":3,"file":"schema-source.mjs","sources":["../../../src/adapters/redocly-loader/schema-source.ts"],"sourcesContent":["import { Readable } from \"node:stream\";\nimport { text } from \"node:stream/consumers\";\nimport { fileURLToPath } from \"node:url\";\nimport {\n  type BaseResolver,\n  type Document,\n  parseYaml,\n  ResolveError,\n  Source,\n  YamlParseError,\n} from \"@redocly/openapi-core\";\nimport parseJson from \"parse-json\";\nimport { aliasExpansionFailure } from \"./alias-limit.js\";\nimport {\n  loadFailedError,\n  parseFailedError,\n  pathStringError,\n  sourceEmptyError,\n  sourceInvalidError,\n  type TextOrigin,\n  urlInvalidError,\n} from \"./schema-load-errors.js\";\n\n/** Parse a schema source of any supported type into a Redocly document (ENGINEERING_PLAN 4.5). */\n\nexport interface ParseSchemaOptions {\n  absoluteRef: string;\n  resolver: BaseResolver;\n  /** Where document text came from, for the message of text that is only a string. */\n  textOrigin?: TextOrigin;\n}\n\n/**\n * Read a stream to the end as UTF-8 text, trimmed. A stream that fails rejects with\n * SCHEMA_LOAD_FAILED; listening only for `data` and `end` left the promise pending forever.\n */\nasync function readStream(stream: Readable, absoluteRef: string): Promise<string> {\n  try {\n    return (await text(stream)).trim();\n  } catch (error) {\n    throw loadFailedError(absoluteRef, error);\n  }\n}\n\n/** A URL source string; a scheme is the same in any case (RFC 3986, section 3.1). */\nconst URL_PREFIX_RE = /^(?:https?|file):\\/\\//i;\n\n/**\n * A string is a URL, JSON (starts with `{`) or YAML. A string that starts like a URL but does not\n * parse as one fails with `SCHEMA_SOURCE_INVALID`, not the parser's `TypeError`.\n */\nfunction parseSchemaText(\n  schema: string,\n  options: ParseSchemaOptions,\n): Promise<Document> | Document {\n  if (URL_PREFIX_RE.test(schema)) {\n    const url = URL.parse(schema);\n    if (url === null) {\n      throw urlInvalidError(schema);\n    }\n    const absoluteRef = url.protocol === \"file:\" ? fileURLToPath(url) : url.href;\n    return parseSchema(url, { absoluteRef, resolver: options.resolver });\n  }\n  return schema[0] === \"{\"\n    ? parseJsonText(schema, options.absoluteRef)\n    : parseYamlText(schema, options.absoluteRef, options.textOrigin ?? \"string\");\n}\n\nfunction parseJsonText(text: string, absoluteRef: string): Document {\n  try {\n    return { source: new Source(absoluteRef, text, \"application/json\"), parsed: parseJson(text) };\n  } catch (cause) {\n    throw parseFailedError(\"json\", absoluteRef, cause);\n  }\n}\n\n/**\n * How a parser message names document text that is no file. The document itself is named as a\n * file in the working directory, so that its relative `$ref`s resolve there, but no such file\n * exists, and a message that named it sent the user looking for it.\n */\nconst TEXT_ORIGIN_NAMES: Readonly<Record<TextOrigin, string>> = {\n  string: \"the schema string\",\n  stream: \"the schema stream\",\n};\n\nfunction parseYamlText(text: string, absoluteRef: string, origin: TextOrigin): Document {\n  const source = new Source(absoluteRef, text);\n  let document: Document;\n  try {\n    document = { source, parsed: parseYaml(text, { filename: TEXT_ORIGIN_NAMES[origin] }) };\n  } catch (cause) {\n    // As Redocly's own parse: the error keeps the first line, not the parser's code excerpt.\n    throw parseFailedError(\"yaml\", absoluteRef, new YamlParseError(cause as Error, source));\n  }\n  // Text that is only a YAML string scalar, such as \"./openapi.yaml\", was meant as a file path.\n  if (typeof document.parsed === \"string\") {\n    throw pathStringError(text, origin);\n  }\n  const failure = aliasExpansionFailure(document.parsed);\n  if (failure !== undefined) {\n    throw parseFailedError(\"yaml\", absoluteRef, failure);\n  }\n  return document;\n}\n\n/** The resolver throws for some failures (a missing file) and returns an error for others. */\nasync function resolveSchemaURL(options: ParseSchemaOptions): Promise<Document> {\n  const result = await options.resolver\n    .resolveDocument(null, options.absoluteRef, true)\n    .catch((cause: unknown) => {\n      throw cause instanceof YamlParseError\n        ? fileParseFailedError(options.absoluteRef, cause)\n        : loadFailedError(options.absoluteRef, readerError(cause));\n    });\n  if (\"parsed\" in result) {\n    return result;\n  }\n  throw loadFailedError(options.absoluteRef, readerError(result));\n}\n\n/**\n * Redocly wraps a failed read in `ResolveError`, which keeps the reader's error in\n * `originalError`, not in `cause`. Unwrapped, the cause keeps the network reason (refused, DNS).\n */\nfunction readerError(error: unknown): unknown {\n  let current = error;\n  while (current instanceof ResolveError) {\n    current = current.originalError;\n  }\n  return current;\n}\n\n/**\n * The resolver parses JSON files with its YAML parser too, so the format comes from the file\n * name. Some parser messages (a second YAML document) do not name the file; the error adds it.\n */\nfunction fileParseFailedError(absoluteRef: string, error: YamlParseError): Error {\n  const format = absoluteRef.toLowerCase().endsWith(\".json\") ? \"json\" : \"yaml\";\n  const cause = error.message.includes(absoluteRef)\n    ? error\n    : new Error(`${error.message} in \"${absoluteRef}\"`, { cause: error });\n  return parseFailedError(format, absoluteRef, cause);\n}\n\nfunction parseSchemaObject(schema: unknown, absoluteRef: string): Document {\n  if (typeof schema === \"object\" && !Array.isArray(schema)) {\n    return {\n      source: new Source(absoluteRef, JSON.stringify(schema), \"application/json\"),\n      parsed: schema,\n    };\n  }\n  throw sourceInvalidError(schema);\n}\n\n/** Parse any supported source: URL, stream, buffer, URL or document text, or a plain object. */\nexport async function parseSchema(schema: unknown, options: ParseSchemaOptions): Promise<Document> {\n  if (!schema) {\n    throw sourceEmptyError(\"Can’t parse empty schema\");\n  }\n  if (schema instanceof URL) {\n    return resolveSchemaURL(options);\n  }\n  if (schema instanceof Readable) {\n    const text = await readStream(schema, options.absoluteRef);\n    return parseSchema(text, { ...options, textOrigin: \"stream\" });\n  }\n  if (schema instanceof Buffer) {\n    return parseSchema(schema.toString(\"utf8\"), options);\n  }\n  if (typeof schema === \"string\") {\n    return parseSchemaText(schema, options);\n  }\n  return parseSchemaObject(schema, options.absoluteRef);\n}\n"],"names":["text"],"mappings":"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"}

package/dist/adapters/redocly-loader/unsupported-keys.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 const errors = require('../../domain/errors.cjs');
+const jsonPointer = require('../../domain/openapi/json-pointer.cjs');
 
 const UNSUPPORTED_KEYS = /* @__PURE__ */ new Set([
   "hasOwnProperty",
@@ -22,9 +23,6 @@ function isUnsupportedEntry(key, value) {
   return key === CONSTRUCTOR_KEY && typeof value === "object" && typeof name === "string";
 }
 const KEYS_IN_MESSAGE = 5;
-function escapePointerSegment(segment) {
-  return segment.replaceAll("~", "~0").replaceAll("/", "~1");
-}
 function unsupportedKeysOf(document) {
   const found = [];
   const visited = /* @__PURE__ */ new WeakSet();
@@ -35,10 +33,10 @@ function unsupportedKeysOf(document) {
       pending.push({ value, pointer });
     }
   };
-  enqueue(document.parsed, "#");
+  enqueue(document.parsed, jsonPointer.ROOT_POINTER);
   for (let node = pending.pop(); node !== void 0; node = pending.pop()) {
     for (const [key, child] of Object.entries(node.value)) {
-      const pointer = `${node.pointer}/${escapePointerSegment(key)}`;
+      const pointer = jsonPointer.childPointer(node.pointer, key);
       if (isUnsupportedEntry(key, child)) {
         found.push({ key, pointer, source: document.source });
       }

package/dist/adapters/redocly-loader/unsupported-keys.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"unsupported-keys.cjs","sources":["../../../src/adapters/redocly-loader/unsupported-keys.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../../domain/errors.js\";\n\n/**\n * Keys Redocly 1.34 cannot walk. It looks up the type of every key with `type.properties[key]`,\n * which also finds inherited `Object.prototype` members; it then calls a found function with no\n * `this`, and these methods throw a `TypeError` for that. Redocly 2.x looks up own keys only\n * (ADR-005 keeps 1.34). `toString` does not throw, and loads as it should.\n *\n * Redocly does not walk every value (`default` and `const` are data), so a document with such a\n * key is not rejected up front: the loader looks for them only after Redocly threw a `TypeError`.\n */\nexport const UNSUPPORTED_KEYS: ReadonlySet<string> = new Set([\n  \"hasOwnProperty\",\n  \"isPrototypeOf\",\n  \"propertyIsEnumerable\",\n  \"toLocaleString\",\n  \"valueOf\",\n  \"__defineGetter__\",\n  \"__defineSetter__\",\n  \"__lookupGetter__\",\n  \"__lookupSetter__\",\n]);\n\n/**\n * `constructor` finds `Object`, which returns the value it is called with. Redocly then takes the\n * value for a node type when it has a string `name` (a security scheme, a header with a `name`),\n * and fails reading the type's fields. Any other `constructor` key loads.\n */\nconst CONSTRUCTOR_KEY = \"constructor\";\n\nfunction isUnsupportedEntry(key: string, value: unknown): boolean {\n  if (UNSUPPORTED_KEYS.has(key)) {\n    return true;\n  }\n  const name = (value as { name?: unknown } | null | undefined)?.name;\n  return key === CONSTRUCTOR_KEY && typeof value === \"object\" && typeof name === \"string\";\n}\n\n/** Enough found keys in the message to act on; `details.keys` has all of them. */\nconst KEYS_IN_MESSAGE = 5;\n\n/** A parsed document and where it was loaded from. */\nexport interface LoadedDocument {\n  readonly source: string;\n  readonly parsed: unknown;\n}\n\n/** An unsupported key: its JSON pointer and the document that has it. */\nexport interface UnsupportedKey {\n  readonly key: string;\n  readonly pointer: string;\n  readonly source: string;\n}\n\ninterface PendingNode {\n  readonly value: object;\n  readonly pointer: string;\n}\n\n/** RFC 6901: `~` becomes `~0` and `/` becomes `~1`. */\nfunction escapePointerSegment(segment: string): string {\n  return segment.replaceAll(\"~\", \"~0\").replaceAll(\"/\", \"~1\");\n}\n\n/**\n * The unsupported keys of one parsed document. The walk uses its own stack, so a deeply nested\n * document is checked without running out of call stack; nodes shared by YAML aliases are checked\n * once.\n */\nfunction unsupportedKeysOf(document: LoadedDocument): UnsupportedKey[] {\n  const found: UnsupportedKey[] = [];\n  const visited = new WeakSet<object>();\n  const pending: PendingNode[] = [];\n  const enqueue = (value: unknown, pointer: string): void => {\n    if (typeof value === \"object\" && value !== null && !visited.has(value)) {\n      visited.add(value);\n      pending.push({ value, pointer });\n    }\n  };\n  enqueue(document.parsed, \"#\");\n  for (let node = pending.pop(); node !== undefined; node = pending.pop()) {\n    for (const [key, child] of Object.entries(node.value)) {\n      const pointer = `${node.pointer}/${escapePointerSegment(key)}`;\n      if (isUnsupportedEntry(key, child)) {\n        found.push({ key, pointer, source: document.source });\n      }\n      enqueue(child, pointer);\n    }\n  }\n  return found;\n}\n\n/** Every unsupported key of the given documents. */\nexport function findUnsupportedKeys(documents: readonly LoadedDocument[]): UnsupportedKey[] {\n  return documents.flatMap(unsupportedKeysOf);\n}\n\nfunction describeKey(found: UnsupportedKey): string {\n  return `\"${found.key}\" at ${found.pointer} in ${found.source}`;\n}\n\n/** The typed error for the keys the schema loader failed on; `cause` is Redocly's `TypeError`. */\nexport function unsupportedKeysError(\n  keys: readonly UnsupportedKey[],\n  cause: unknown,\n): OpenAPITypesafeError {\n  const listed = keys.slice(0, KEYS_IN_MESSAGE).map(describeKey);\n  const more = keys.length > KEYS_IN_MESSAGE ? ` and ${keys.length - KEYS_IN_MESSAGE} more` : \"\";\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_KEY_UNSUPPORTED,\n    message:\n      \"The schema loader (Redocly 1.x) failed on a key named like a built-in object method. \" +\n      `Rename it: ${listed.join(\", \")}${more}.`,\n    details: { keys: keys.map((found) => ({ ...found })) },\n    cause,\n  });\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":";;;;AAWO,MAAM,gBAAA,uBAA4C,GAAA,CAAI;AAAA,EAC3D,gBAAA;AAAA,EACA,eAAA;AAAA,EACA,sBAAA;AAAA,EACA,gBAAA;AAAA,EACA,SAAA;AAAA,EACA,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA,kBAAA;AAAA,EACA;AACF,CAAC;AAOD,MAAM,eAAA,GAAkB,aAAA;AAExB,SAAS,kBAAA,CAAmB,KAAa,KAAA,EAAyB;AAChE,EAAA,IAAI,gBAAA,CAAiB,GAAA,CAAI,GAAG,CAAA,EAAG;AAC7B,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,MAAM,OAAQ,KAAA,EAAiD,IAAA;AAC/D,EAAA,OAAO,QAAQ,eAAA,IAAmB,OAAO,KAAA,KAAU,QAAA,IAAY,OAAO,IAAA,KAAS,QAAA;AACjF;AAGA,MAAM,eAAA,GAAkB,CAAA;AAqBxB,SAAS,qBAAqB,OAAA,EAAyB;AACrD,EAAA,OAAO,QAAQ,UAAA,CAAW,GAAA,EAAK,IAAI,CAAA,CAAE,UAAA,CAAW,KAAK,IAAI,CAAA;AAC3D;AAOA,SAAS,kBAAkB,QAAA,EAA4C;AACrE,EAAA,MAAM,QAA0B,EAAC;AACjC,EAAA,MAAM,OAAA,uBAAc,OAAA,EAAgB;AACpC,EAAA,MAAM,UAAyB,EAAC;AAChC,EAAA,MAAM,OAAA,GAAU,CAAC,KAAA,EAAgB,OAAA,KAA0B;AACzD,IAAA,IAAI,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,OAAA,CAAQ,GAAA,CAAI,KAAK,CAAA,EAAG;AACtE,MAAA,OAAA,CAAQ,IAAI,KAAK,CAAA;AACjB,MAAA,OAAA,CAAQ,IAAA,CAAK,EAAE,KAAA,EAAO,OAAA,EAAS,CAAA;AAAA,IACjC;AAAA,EACF,CAAA;AACA,EAAA,OAAA,CAAQ,QAAA,CAAS,QAAQ,GAAG,CAAA;AAC5B,EAAA,KAAA,IAAS,IAAA,GAAO,QAAQ,GAAA,EAAI,EAAG,SAAS,MAAA,EAAW,IAAA,GAAO,OAAA,CAAQ,GAAA,EAAI,EAAG;AACvE,IAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,IAAA,CAAK,KAAK,CAAA,EAAG;AACrD,MAAA,MAAM,UAAU,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,CAAA,EAAI,oBAAA,CAAqB,GAAG,CAAC,CAAA,CAAA;AAC5D,MAAA,IAAI,kBAAA,CAAmB,GAAA,EAAK,KAAK,CAAA,EAAG;AAClC,QAAA,KAAA,CAAM,KAAK,EAAE,GAAA,EAAK,SAAS,MAAA,EAAQ,QAAA,CAAS,QAAQ,CAAA;AAAA,MACtD;AACA,MAAA,OAAA,CAAQ,OAAO,OAAO,CAAA;AAAA,IACxB;AAAA,EACF;AACA,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,oBAAoB,SAAA,EAAwD;AAC1F,EAAA,OAAO,SAAA,CAAU,QAAQ,iBAAiB,CAAA;AAC5C;AAEA,SAAS,YAAY,KAAA,EAA+B;AAClD,EAAA,OAAO,CAAA,CAAA,EAAI,MAAM,GAAG,CAAA,KAAA,EAAQ,MAAM,OAAO,CAAA,IAAA,EAAO,MAAM,MAAM,CAAA,CAAA;AAC9D;AAGO,SAAS,oBAAA,CACd,MACA,KAAA,EACsB;AACtB,EAAA,MAAM,SAAS,IAAA,CAAK,KAAA,CAAM,GAAG,eAAe,CAAA,CAAE,IAAI,WAAW,CAAA;AAC7D,EAAA,MAAM,IAAA,GAAO,KAAK,MAAA,GAAS,eAAA,GAAkB,QAAQ,IAAA,CAAK,MAAA,GAAS,eAAe,CAAA,KAAA,CAAA,GAAU,EAAA;AAC5F,EAAA,OAAO,IAAIA,2BAAA,CAAqB;AAAA,IAC9B,MAAMC,kBAAA,CAAY,sBAAA;AAAA,IAClB,SACE,CAAA,gGAAA,EACc,MAAA,CAAO,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA,CAAA,CAAA;AAAA,IACxC,OAAA,EAAS,EAAE,IAAA,EAAM,IAAA,CAAK,GAAA,CAAI,CAAC,KAAA,MAAW,EAAE,GAAG,KAAA,EAAM,CAAE,CAAA,EAAE;AAAA,IACrD;AAAA,GACD,CAAA;AACH;;;;"}
+{"version":3,"file":"unsupported-keys.cjs","sources":["../../../src/adapters/redocly-loader/unsupported-keys.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../../domain/errors.js\";\nimport { childPointer, ROOT_POINTER } from \"../../domain/openapi/json-pointer.js\";\n\n/**\n * Keys Redocly 1.34 cannot walk. It looks up the type of every key with `type.properties[key]`,\n * which also finds inherited `Object.prototype` members; it then calls a found function with no\n * `this`, and these methods throw a `TypeError` for that. Redocly 2.x looks up own keys only\n * (ADR-005 keeps 1.34). `toString` does not throw, and loads as it should.\n *\n * Redocly does not walk every value (`default` and `const` are data), so a document with such a\n * key is not rejected up front: the loader looks for them only after Redocly threw a `TypeError`.\n */\nexport const UNSUPPORTED_KEYS: ReadonlySet<string> = new Set([\n  \"hasOwnProperty\",\n  \"isPrototypeOf\",\n  \"propertyIsEnumerable\",\n  \"toLocaleString\",\n  \"valueOf\",\n  \"__defineGetter__\",\n  \"__defineSetter__\",\n  \"__lookupGetter__\",\n  \"__lookupSetter__\",\n]);\n\n/**\n * `constructor` finds `Object`, which returns the value it is called with. Redocly then takes the\n * value for a node type when it has a string `name` (a security scheme, a header with a `name`),\n * and fails reading the type's fields. Any other `constructor` key loads.\n */\nconst CONSTRUCTOR_KEY = \"constructor\";\n\nfunction isUnsupportedEntry(key: string, value: unknown): boolean {\n  if (UNSUPPORTED_KEYS.has(key)) {\n    return true;\n  }\n  const name = (value as { name?: unknown } | null | undefined)?.name;\n  return key === CONSTRUCTOR_KEY && typeof value === \"object\" && typeof name === \"string\";\n}\n\n/** Enough found keys in the message to act on; `details.keys` has all of them. */\nconst KEYS_IN_MESSAGE = 5;\n\n/** A parsed document and where it was loaded from. */\nexport interface LoadedDocument {\n  readonly source: string;\n  readonly parsed: unknown;\n}\n\n/** An unsupported key: its JSON pointer and the document that has it. */\nexport interface UnsupportedKey {\n  readonly key: string;\n  readonly pointer: string;\n  readonly source: string;\n}\n\ninterface PendingNode {\n  readonly value: object;\n  readonly pointer: string;\n}\n\n/**\n * The unsupported keys of one parsed document. The walk uses its own stack, so a deeply nested\n * document is checked without running out of call stack; nodes shared by YAML aliases are checked\n * once.\n */\nfunction unsupportedKeysOf(document: LoadedDocument): UnsupportedKey[] {\n  const found: UnsupportedKey[] = [];\n  const visited = new WeakSet<object>();\n  const pending: PendingNode[] = [];\n  const enqueue = (value: unknown, pointer: string): void => {\n    if (typeof value === \"object\" && value !== null && !visited.has(value)) {\n      visited.add(value);\n      pending.push({ value, pointer });\n    }\n  };\n  enqueue(document.parsed, ROOT_POINTER);\n  for (let node = pending.pop(); node !== undefined; node = pending.pop()) {\n    for (const [key, child] of Object.entries(node.value)) {\n      const pointer = childPointer(node.pointer, key);\n      if (isUnsupportedEntry(key, child)) {\n        found.push({ key, pointer, source: document.source });\n      }\n      enqueue(child, pointer);\n    }\n  }\n  return found;\n}\n\n/** Every unsupported key of the given documents. */\nexport function findUnsupportedKeys(documents: readonly LoadedDocument[]): UnsupportedKey[] {\n  return documents.flatMap(unsupportedKeysOf);\n}\n\nfunction describeKey(found: UnsupportedKey): string {\n  return `\"${found.key}\" at ${found.pointer} in ${found.source}`;\n}\n\n/** The typed error for the keys the schema loader failed on; `cause` is Redocly's `TypeError`. */\nexport function unsupportedKeysError(\n  keys: readonly UnsupportedKey[],\n  cause: unknown,\n): OpenAPITypesafeError {\n  const listed = keys.slice(0, KEYS_IN_MESSAGE).map(describeKey);\n  const more = keys.length > KEYS_IN_MESSAGE ? ` and ${keys.length - KEYS_IN_MESSAGE} more` : \"\";\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_KEY_UNSUPPORTED,\n    message:\n      \"The schema loader (Redocly 1.x) failed on a key named like a built-in object method. \" +\n      `Rename it: ${listed.join(\", \")}${more}.`,\n    details: { keys: keys.map((found) => ({ ...found })) },\n    cause,\n  });\n}\n"],"names":["ROOT_POINTER","childPointer","OpenAPITypesafeError","ERROR_CODES"],"mappings":"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"}

package/dist/adapters/redocly-loader/unsupported-keys.mjs

@@ -1,4 +1,5 @@
 import { OpenAPITypesafeError, ERROR_CODES } from '../../domain/errors.mjs';
+import { childPointer, ROOT_POINTER } from '../../domain/openapi/json-pointer.mjs';
 
 const UNSUPPORTED_KEYS = /* @__PURE__ */ new Set([
   "hasOwnProperty",
@@ -20,9 +21,6 @@ function isUnsupportedEntry(key, value) {
   return key === CONSTRUCTOR_KEY && typeof value === "object" && typeof name === "string";
 }
 const KEYS_IN_MESSAGE = 5;
-function escapePointerSegment(segment) {
-  return segment.replaceAll("~", "~0").replaceAll("/", "~1");
-}
 function unsupportedKeysOf(document) {
   const found = [];
   const visited = /* @__PURE__ */ new WeakSet();
@@ -33,10 +31,10 @@ function unsupportedKeysOf(document) {
       pending.push({ value, pointer });
     }
   };
-  enqueue(document.parsed, "#");
+  enqueue(document.parsed, ROOT_POINTER);
   for (let node = pending.pop(); node !== void 0; node = pending.pop()) {
     for (const [key, child] of Object.entries(node.value)) {
-      const pointer = `${node.pointer}/${escapePointerSegment(key)}`;
+      const pointer = childPointer(node.pointer, key);
       if (isUnsupportedEntry(key, child)) {
         found.push({ key, pointer, source: document.source });
       }

package/dist/adapters/redocly-loader/unsupported-keys.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"unsupported-keys.mjs","sources":["../../../src/adapters/redocly-loader/unsupported-keys.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../../domain/errors.js\";\n\n/**\n * Keys Redocly 1.34 cannot walk. It looks up the type of every key with `type.properties[key]`,\n * which also finds inherited `Object.prototype` members; it then calls a found function with no\n * `this`, and these methods throw a `TypeError` for that. Redocly 2.x looks up own keys only\n * (ADR-005 keeps 1.34). `toString` does not throw, and loads as it should.\n *\n * Redocly does not walk every value (`default` and `const` are data), so a document with such a\n * key is not rejected up front: the loader looks for them only after Redocly threw a `TypeError`.\n */\nexport const UNSUPPORTED_KEYS: ReadonlySet<string> = new Set([\n  \"hasOwnProperty\",\n  \"isPrototypeOf\",\n  \"propertyIsEnumerable\",\n  \"toLocaleString\",\n  \"valueOf\",\n  \"__defineGetter__\",\n  \"__defineSetter__\",\n  \"__lookupGetter__\",\n  \"__lookupSetter__\",\n]);\n\n/**\n * `constructor` finds `Object`, which returns the value it is called with. Redocly then takes the\n * value for a node type when it has a string `name` (a security scheme, a header with a `name`),\n * and fails reading the type's fields. Any other `constructor` key loads.\n */\nconst CONSTRUCTOR_KEY = \"constructor\";\n\nfunction isUnsupportedEntry(key: string, value: unknown): boolean {\n  if (UNSUPPORTED_KEYS.has(key)) {\n    return true;\n  }\n  const name = (value as { name?: unknown } | null | undefined)?.name;\n  return key === CONSTRUCTOR_KEY && typeof value === \"object\" && typeof name === \"string\";\n}\n\n/** Enough found keys in the message to act on; `details.keys` has all of them. */\nconst KEYS_IN_MESSAGE = 5;\n\n/** A parsed document and where it was loaded from. */\nexport interface LoadedDocument {\n  readonly source: string;\n  readonly parsed: unknown;\n}\n\n/** An unsupported key: its JSON pointer and the document that has it. */\nexport interface UnsupportedKey {\n  readonly key: string;\n  readonly pointer: string;\n  readonly source: string;\n}\n\ninterface PendingNode {\n  readonly value: object;\n  readonly pointer: string;\n}\n\n/** RFC 6901: `~` becomes `~0` and `/` becomes `~1`. */\nfunction escapePointerSegment(segment: string): string {\n  return segment.replaceAll(\"~\", \"~0\").replaceAll(\"/\", \"~1\");\n}\n\n/**\n * The unsupported keys of one parsed document. The walk uses its own stack, so a deeply nested\n * document is checked without running out of call stack; nodes shared by YAML aliases are checked\n * once.\n */\nfunction unsupportedKeysOf(document: LoadedDocument): UnsupportedKey[] {\n  const found: UnsupportedKey[] = [];\n  const visited = new WeakSet<object>();\n  const pending: PendingNode[] = [];\n  const enqueue = (value: unknown, pointer: string): void => {\n    if (typeof value === \"object\" && value !== null && !visited.has(value)) {\n      visited.add(value);\n      pending.push({ value, pointer });\n    }\n  };\n  enqueue(document.parsed, \"#\");\n  for (let node = pending.pop(); node !== undefined; node = pending.pop()) {\n    for (const [key, child] of Object.entries(node.value)) {\n      const pointer = `${node.pointer}/${escapePointerSegment(key)}`;\n      if (isUnsupportedEntry(key, child)) {\n        found.push({ key, pointer, source: document.source });\n      }\n      enqueue(child, pointer);\n    }\n  }\n  return found;\n}\n\n/** Every unsupported key of the given documents. */\nexport function findUnsupportedKeys(documents: readonly LoadedDocument[]): UnsupportedKey[] {\n  return documents.flatMap(unsupportedKeysOf);\n}\n\nfunction describeKey(found: UnsupportedKey): string {\n  return `\"${found.key}\" at ${found.pointer} in ${found.source}`;\n}\n\n/** The typed error for the keys the schema loader failed on; `cause` is Redocly's `TypeError`. */\nexport function unsupportedKeysError(\n  keys: readonly UnsupportedKey[],\n  cause: unknown,\n): OpenAPITypesafeError {\n  const listed = keys.slice(0, KEYS_IN_MESSAGE).map(describeKey);\n  const more = keys.length > KEYS_IN_MESSAGE ? ` and ${keys.length - KEYS_IN_MESSAGE} more` : \"\";\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_KEY_UNSUPPORTED,\n    message:\n      \"The schema loader (Redocly 1.x) failed on a key named like a built-in object method. \" +\n      `Rename it: ${listed.join(\", \")}${more}.`,\n    details: { keys: keys.map((found) => ({ ...found })) },\n    cause,\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"unsupported-keys.mjs","sources":["../../../src/adapters/redocly-loader/unsupported-keys.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"../../domain/errors.js\";\nimport { childPointer, ROOT_POINTER } from \"../../domain/openapi/json-pointer.js\";\n\n/**\n * Keys Redocly 1.34 cannot walk. It looks up the type of every key with `type.properties[key]`,\n * which also finds inherited `Object.prototype` members; it then calls a found function with no\n * `this`, and these methods throw a `TypeError` for that. Redocly 2.x looks up own keys only\n * (ADR-005 keeps 1.34). `toString` does not throw, and loads as it should.\n *\n * Redocly does not walk every value (`default` and `const` are data), so a document with such a\n * key is not rejected up front: the loader looks for them only after Redocly threw a `TypeError`.\n */\nexport const UNSUPPORTED_KEYS: ReadonlySet<string> = new Set([\n  \"hasOwnProperty\",\n  \"isPrototypeOf\",\n  \"propertyIsEnumerable\",\n  \"toLocaleString\",\n  \"valueOf\",\n  \"__defineGetter__\",\n  \"__defineSetter__\",\n  \"__lookupGetter__\",\n  \"__lookupSetter__\",\n]);\n\n/**\n * `constructor` finds `Object`, which returns the value it is called with. Redocly then takes the\n * value for a node type when it has a string `name` (a security scheme, a header with a `name`),\n * and fails reading the type's fields. Any other `constructor` key loads.\n */\nconst CONSTRUCTOR_KEY = \"constructor\";\n\nfunction isUnsupportedEntry(key: string, value: unknown): boolean {\n  if (UNSUPPORTED_KEYS.has(key)) {\n    return true;\n  }\n  const name = (value as { name?: unknown } | null | undefined)?.name;\n  return key === CONSTRUCTOR_KEY && typeof value === \"object\" && typeof name === \"string\";\n}\n\n/** Enough found keys in the message to act on; `details.keys` has all of them. */\nconst KEYS_IN_MESSAGE = 5;\n\n/** A parsed document and where it was loaded from. */\nexport interface LoadedDocument {\n  readonly source: string;\n  readonly parsed: unknown;\n}\n\n/** An unsupported key: its JSON pointer and the document that has it. */\nexport interface UnsupportedKey {\n  readonly key: string;\n  readonly pointer: string;\n  readonly source: string;\n}\n\ninterface PendingNode {\n  readonly value: object;\n  readonly pointer: string;\n}\n\n/**\n * The unsupported keys of one parsed document. The walk uses its own stack, so a deeply nested\n * document is checked without running out of call stack; nodes shared by YAML aliases are checked\n * once.\n */\nfunction unsupportedKeysOf(document: LoadedDocument): UnsupportedKey[] {\n  const found: UnsupportedKey[] = [];\n  const visited = new WeakSet<object>();\n  const pending: PendingNode[] = [];\n  const enqueue = (value: unknown, pointer: string): void => {\n    if (typeof value === \"object\" && value !== null && !visited.has(value)) {\n      visited.add(value);\n      pending.push({ value, pointer });\n    }\n  };\n  enqueue(document.parsed, ROOT_POINTER);\n  for (let node = pending.pop(); node !== undefined; node = pending.pop()) {\n    for (const [key, child] of Object.entries(node.value)) {\n      const pointer = childPointer(node.pointer, key);\n      if (isUnsupportedEntry(key, child)) {\n        found.push({ key, pointer, source: document.source });\n      }\n      enqueue(child, pointer);\n    }\n  }\n  return found;\n}\n\n/** Every unsupported key of the given documents. */\nexport function findUnsupportedKeys(documents: readonly LoadedDocument[]): UnsupportedKey[] {\n  return documents.flatMap(unsupportedKeysOf);\n}\n\nfunction describeKey(found: UnsupportedKey): string {\n  return `\"${found.key}\" at ${found.pointer} in ${found.source}`;\n}\n\n/** The typed error for the keys the schema loader failed on; `cause` is Redocly's `TypeError`. */\nexport function unsupportedKeysError(\n  keys: readonly UnsupportedKey[],\n  cause: unknown,\n): OpenAPITypesafeError {\n  const listed = keys.slice(0, KEYS_IN_MESSAGE).map(describeKey);\n  const more = keys.length > KEYS_IN_MESSAGE ? ` and ${keys.length - KEYS_IN_MESSAGE} more` : \"\";\n  return new OpenAPITypesafeError({\n    code: ERROR_CODES.SCHEMA_KEY_UNSUPPORTED,\n    message:\n      \"The schema loader (Redocly 1.x) failed on a key named like a built-in object method. \" +\n      `Rename it: ${listed.join(\", \")}${more}.`,\n    details: { keys: keys.map((found) => ({ ...found })) },\n    cause,\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/adapters/terminal-logger/terminal-logger.cjs

@@ -1,12 +1,16 @@
 'use strict';
 
 const colors = require('ansi-colors');
-const urlCredentials = require('../../domain/url-credentials.cjs');
+const terminalText = require('../../domain/terminal-text.cjs');
+const urlSecrets = require('../../domain/url-secrets.cjs');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
 const colors__default = /*#__PURE__*/_interopDefaultCompat(colors);
 
+function shownText(message) {
+  return terminalText.terminalSafeText(urlSecrets.redactUrlSecrets(message));
+}
 const MILLISECONDS_PER_SECOND = 1e3;
 const MILLISECONDS_PER_MINUTE = 6e4;
 function formatDuration(milliseconds) {
@@ -47,16 +51,18 @@ class TerminalLogger {
     }
     const name = groupColor(this.#palette, group)(`openapi-ts:${group ?? "info"}`);
     const time = durationMs === void 0 ? " " : this.#palette.green(` ${formatDuration(durationMs)} `);
-    const text = urlCredentials.redactUrlCredentials(message);
+    const text = shownText(message);
     this.#options.sink.debug(`  ${this.#palette.bold(name)}${time}${text}`);
   }
   warn(message) {
     if (!this.#options.silent) {
-      this.#options.sink.warn(this.#palette.yellow(` \u26A0  ${urlCredentials.redactUrlCredentials(message)}`));
+      this.#options.sink.warn(this.#palette.yellow(` \u26A0  ${shownText(message)}`));
     }
   }
   error(message) {
-    this.#options.sink.error(this.#palette.red(` \u2718  ${urlCredentials.redactUrlCredentials(message)}`));
+    if (!this.#options.silent) {
+      this.#options.sink.error(this.#palette.red(` \u2718  ${shownText(message)}`));
+    }
   }
 }
 function createTerminalLogger(options) {

package/dist/adapters/terminal-logger/terminal-logger.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-logger.cjs","sources":["../../../src/adapters/terminal-logger/terminal-logger.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport type { DebugGroup, Logger } from \"../../application/ports/logger.js\";\nimport { redactUrlCredentials } from \"../../domain/url-credentials.js\";\n\n/**\n * The Logger port on a terminal, with the original output format: ` ⚠  ` warnings, ` ✘  `\n * errors, and `openapi-ts:<group>` debug lines filtered by `DEBUG` (ENGINEERING_PLAN 4.5). No\n * line shows the user info of a URL.\n */\n\n/** Where the lines go: `console` in production, a recording sink in tests. */\nexport interface TerminalSink {\n  debug(line: string): void;\n  warn(line: string): void;\n  error(line: string): void;\n}\n\nexport interface TerminalLoggerOptions {\n  /** Drop warnings (errors and debug lines are still written). */\n  readonly silent: boolean;\n  /** The value of `DEBUG`: `*`, `openapi-ts:*` or `openapi-ts:<group>` turn debug lines on. */\n  readonly debugFilter: string | undefined;\n  readonly useColors: boolean;\n  readonly sink: TerminalSink;\n}\n\ntype Colors = ReturnType<typeof colors.create>;\n\nconst MILLISECONDS_PER_SECOND = 1000;\nconst MILLISECONDS_PER_MINUTE = 60_000;\n\n/** A duration as the original prints it: one decimal, in ms, s or m. */\nexport function formatDuration(milliseconds: number): string {\n  if (milliseconds < MILLISECONDS_PER_SECOND) {\n    return `${Math.round(10 * milliseconds) / 10}ms`;\n  }\n  if (milliseconds < MILLISECONDS_PER_MINUTE) {\n    return `${Math.round(milliseconds / 100) / 10}s`;\n  }\n  return `${Math.round(milliseconds / 6000) / 10}m`;\n}\n\nfunction groupColor(palette: Colors, group: DebugGroup | undefined): (text: string) => string {\n  const byGroup: Readonly<Partial<Record<DebugGroup, (text: string) => string>>> = {\n    redoc: palette.cyanBright,\n    lint: palette.yellowBright,\n    bundle: palette.magentaBright,\n    ts: palette.blueBright,\n  };\n  return (group && byGroup[group]) || palette.whiteBright;\n}\n\n/** Whether `DEBUG` asks for this group (the original check, case-insensitive for the group). */\nexport function isDebugEnabled(filter: string | undefined, group: DebugGroup | undefined): boolean {\n  if (!filter) {\n    return false;\n  }\n  return (\n    !group ||\n    filter === \"*\" ||\n    filter === \"openapi-ts:*\" ||\n    filter.toLocaleLowerCase() === `openapi-ts:${group.toLocaleLowerCase()}`\n  );\n}\n\nclass TerminalLogger implements Logger {\n  readonly #options: TerminalLoggerOptions;\n  readonly #palette: Colors;\n\n  constructor(options: TerminalLoggerOptions) {\n    this.#options = options;\n    this.#palette = colors.create();\n    this.#palette.enabled = options.useColors;\n  }\n\n  debug(message: string, group?: DebugGroup, durationMs?: number): void {\n    if (!isDebugEnabled(this.#options.debugFilter, group)) {\n      return;\n    }\n    const name = groupColor(this.#palette, group)(`openapi-ts:${group ?? \"info\"}`);\n    // The original wrote no space without a duration (`openapi-ts:lintIgnored …`).\n    const time =\n      durationMs === undefined ? \" \" : this.#palette.green(` ${formatDuration(durationMs)} `);\n    const text = redactUrlCredentials(message);\n    this.#options.sink.debug(`  ${this.#palette.bold(name)}${time}${text}`);\n  }\n\n  warn(message: string): void {\n    if (!this.#options.silent) {\n      this.#options.sink.warn(this.#palette.yellow(` ⚠  ${redactUrlCredentials(message)}`));\n    }\n  }\n\n  error(message: string): void {\n    this.#options.sink.error(this.#palette.red(` ✘  ${redactUrlCredentials(message)}`));\n  }\n}\n\n/** A Logger that writes to a terminal sink. */\nexport function createTerminalLogger(options: TerminalLoggerOptions): Logger {\n  return new TerminalLogger(options);\n}\n"],"names":["colors","redactUrlCredentials"],"mappings":";;;;;;;;;AA4BA,MAAM,uBAAA,GAA0B,GAAA;AAChC,MAAM,uBAAA,GAA0B,GAAA;AAGzB,SAAS,eAAe,YAAA,EAA8B;AAC3D,EAAA,IAAI,eAAe,uBAAA,EAAyB;AAC1C,IAAA,OAAO,GAAG,IAAA,CAAK,KAAA,CAAM,EAAA,GAAK,YAAY,IAAI,EAAE,CAAA,EAAA,CAAA;AAAA,EAC9C;AACA,EAAA,IAAI,eAAe,uBAAA,EAAyB;AAC1C,IAAA,OAAO,GAAG,IAAA,CAAK,KAAA,CAAM,YAAA,GAAe,GAAG,IAAI,EAAE,CAAA,CAAA,CAAA;AAAA,EAC/C;AACA,EAAA,OAAO,GAAG,IAAA,CAAK,KAAA,CAAM,YAAA,GAAe,GAAI,IAAI,EAAE,CAAA,CAAA,CAAA;AAChD;AAEA,SAAS,UAAA,CAAW,SAAiB,KAAA,EAAyD;AAC5F,EAAA,MAAM,OAAA,GAA2E;AAAA,IAC/E,OAAO,OAAA,CAAQ,UAAA;AAAA,IACf,MAAM,OAAA,CAAQ,YAAA;AAAA,IACd,QAAQ,OAAA,CAAQ,aAAA;AAAA,IAChB,IAAI,OAAA,CAAQ;AAAA,GACd;AACA,EAAA,OAAQ,KAAA,IAAS,OAAA,CAAQ,KAAK,CAAA,IAAM,OAAA,CAAQ,WAAA;AAC9C;AAGO,SAAS,cAAA,CAAe,QAA4B,KAAA,EAAwC;AACjG,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OACE,CAAC,KAAA,IACD,MAAA,KAAW,GAAA,IACX,MAAA,KAAW,cAAA,IACX,MAAA,CAAO,iBAAA,EAAkB,KAAM,CAAA,WAAA,EAAc,KAAA,CAAM,iBAAA,EAAmB,CAAA,CAAA;AAE1E;AAEA,MAAM,cAAA,CAAiC;AAAA,EAC5B,QAAA;AAAA,EACA,QAAA;AAAA,EAET,YAAY,OAAA,EAAgC;AAC1C,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAChB,IAAA,IAAA,CAAK,QAAA,GAAWA,gBAAO,MAAA,EAAO;AAC9B,IAAA,IAAA,CAAK,QAAA,CAAS,UAAU,OAAA,CAAQ,SAAA;AAAA,EAClC;AAAA,EAEA,KAAA,CAAM,OAAA,EAAiB,KAAA,EAAoB,UAAA,EAA2B;AACpE,IAAA,IAAI,CAAC,cAAA,CAAe,IAAA,CAAK,QAAA,CAAS,WAAA,EAAa,KAAK,CAAA,EAAG;AACrD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,IAAA,GAAO,WAAW,IAAA,CAAK,QAAA,EAAU,KAAK,CAAA,CAAE,CAAA,WAAA,EAAc,KAAA,IAAS,MAAM,CAAA,CAAE,CAAA;AAE7E,IAAA,MAAM,IAAA,GACJ,UAAA,KAAe,MAAA,GAAY,GAAA,GAAM,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,CAAA,CAAA,EAAI,cAAA,CAAe,UAAU,CAAC,CAAA,CAAA,CAAG,CAAA;AACxF,IAAA,MAAM,IAAA,GAAOC,oCAAqB,OAAO,CAAA;AACzC,IAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,KAAA,CAAM,CAAA,EAAA,EAAK,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,IAAI,CAAC,CAAA,EAAG,IAAI,CAAA,EAAG,IAAI,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA,EAEA,KAAK,OAAA,EAAuB;AAC1B,IAAA,IAAI,CAAC,IAAA,CAAK,QAAA,CAAS,MAAA,EAAQ;AACzB,MAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,IAAA,CAAK,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,CAAA,SAAA,EAAOA,mCAAA,CAAqB,OAAO,CAAC,CAAA,CAAE,CAAC,CAAA;AAAA,IACtF;AAAA,EACF;AAAA,EAEA,MAAM,OAAA,EAAuB;AAC3B,IAAA,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,QAAA,CAAS,GAAA,CAAI,CAAA,SAAA,EAAOA,mCAAA,CAAqB,OAAO,CAAC,CAAA,CAAE,CAAC,CAAA;AAAA,EACpF;AACF;AAGO,SAAS,qBAAqB,OAAA,EAAwC;AAC3E,EAAA,OAAO,IAAI,eAAe,OAAO,CAAA;AACnC;;;;"}
+{"version":3,"file":"terminal-logger.cjs","sources":["../../../src/adapters/terminal-logger/terminal-logger.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport type { DebugGroup, Logger } from \"../../application/ports/logger.js\";\nimport { terminalSafeText } from \"../../domain/terminal-text.js\";\nimport { redactUrlSecrets } from \"../../domain/url-secrets.js\";\n\n/**\n * The Logger port on a terminal, with the original output format: ` ⚠  ` warnings, ` ✘  `\n * errors, and `openapi-ts:<group>` debug lines filtered by `DEBUG` (ENGINEERING_PLAN 4.5). No\n * line shows the secrets of a URL, and each message prints as one line: a message quotes the\n * document, whose control characters could forge CI commands (terminal-text.ts).\n */\n\nfunction shownText(message: string): string {\n  return terminalSafeText(redactUrlSecrets(message));\n}\n\n/** Where the lines go: `console` in production, a recording sink in tests. */\nexport interface TerminalSink {\n  debug(line: string): void;\n  warn(line: string): void;\n  error(line: string): void;\n}\n\nexport interface TerminalLoggerOptions {\n  /**\n   * Drop warnings and error lines; debug lines, which `DEBUG` asks for, are still written. The\n   * error lines are the problems of a document that fails to load, which the thrown error lists.\n   */\n  readonly silent: boolean;\n  /** The value of `DEBUG`: `*`, `openapi-ts:*` or `openapi-ts:<group>` turn debug lines on. */\n  readonly debugFilter: string | undefined;\n  readonly useColors: boolean;\n  readonly sink: TerminalSink;\n}\n\ntype Colors = ReturnType<typeof colors.create>;\n\nconst MILLISECONDS_PER_SECOND = 1000;\nconst MILLISECONDS_PER_MINUTE = 60_000;\n\n/** A duration as the original prints it: one decimal, in ms, s or m. */\nexport function formatDuration(milliseconds: number): string {\n  if (milliseconds < MILLISECONDS_PER_SECOND) {\n    return `${Math.round(10 * milliseconds) / 10}ms`;\n  }\n  if (milliseconds < MILLISECONDS_PER_MINUTE) {\n    return `${Math.round(milliseconds / 100) / 10}s`;\n  }\n  return `${Math.round(milliseconds / 6000) / 10}m`;\n}\n\nfunction groupColor(palette: Colors, group: DebugGroup | undefined): (text: string) => string {\n  const byGroup: Readonly<Partial<Record<DebugGroup, (text: string) => string>>> = {\n    redoc: palette.cyanBright,\n    lint: palette.yellowBright,\n    bundle: palette.magentaBright,\n    ts: palette.blueBright,\n  };\n  return (group && byGroup[group]) || palette.whiteBright;\n}\n\n/** Whether `DEBUG` asks for this group (the original check, case-insensitive for the group). */\nexport function isDebugEnabled(filter: string | undefined, group: DebugGroup | undefined): boolean {\n  if (!filter) {\n    return false;\n  }\n  return (\n    !group ||\n    filter === \"*\" ||\n    filter === \"openapi-ts:*\" ||\n    filter.toLocaleLowerCase() === `openapi-ts:${group.toLocaleLowerCase()}`\n  );\n}\n\nclass TerminalLogger implements Logger {\n  readonly #options: TerminalLoggerOptions;\n  readonly #palette: Colors;\n\n  constructor(options: TerminalLoggerOptions) {\n    this.#options = options;\n    this.#palette = colors.create();\n    this.#palette.enabled = options.useColors;\n  }\n\n  debug(message: string, group?: DebugGroup, durationMs?: number): void {\n    if (!isDebugEnabled(this.#options.debugFilter, group)) {\n      return;\n    }\n    const name = groupColor(this.#palette, group)(`openapi-ts:${group ?? \"info\"}`);\n    // The original wrote no space without a duration (`openapi-ts:lintIgnored …`).\n    const time =\n      durationMs === undefined ? \" \" : this.#palette.green(` ${formatDuration(durationMs)} `);\n    const text = shownText(message);\n    this.#options.sink.debug(`  ${this.#palette.bold(name)}${time}${text}`);\n  }\n\n  warn(message: string): void {\n    if (!this.#options.silent) {\n      this.#options.sink.warn(this.#palette.yellow(` ⚠  ${shownText(message)}`));\n    }\n  }\n\n  error(message: string): void {\n    if (!this.#options.silent) {\n      this.#options.sink.error(this.#palette.red(` ✘  ${shownText(message)}`));\n    }\n  }\n}\n\n/** A Logger that writes to a terminal sink. */\nexport function createTerminalLogger(options: TerminalLoggerOptions): Logger {\n  return new TerminalLogger(options);\n}\n"],"names":["terminalSafeText","redactUrlSecrets","colors"],"mappings":"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"}

package/dist/adapters/terminal-logger/terminal-logger.mjs

@@ -1,6 +1,10 @@
 import colors from 'ansi-colors';
-import { redactUrlCredentials } from '../../domain/url-credentials.mjs';
+import { terminalSafeText } from '../../domain/terminal-text.mjs';
+import { redactUrlSecrets } from '../../domain/url-secrets.mjs';
 
+function shownText(message) {
+  return terminalSafeText(redactUrlSecrets(message));
+}
 const MILLISECONDS_PER_SECOND = 1e3;
 const MILLISECONDS_PER_MINUTE = 6e4;
 function formatDuration(milliseconds) {
@@ -41,16 +45,18 @@ class TerminalLogger {
     }
     const name = groupColor(this.#palette, group)(`openapi-ts:${group ?? "info"}`);
     const time = durationMs === void 0 ? " " : this.#palette.green(` ${formatDuration(durationMs)} `);
-    const text = redactUrlCredentials(message);
+    const text = shownText(message);
     this.#options.sink.debug(`  ${this.#palette.bold(name)}${time}${text}`);
   }
   warn(message) {
     if (!this.#options.silent) {
-      this.#options.sink.warn(this.#palette.yellow(` \u26A0  ${redactUrlCredentials(message)}`));
+      this.#options.sink.warn(this.#palette.yellow(` \u26A0  ${shownText(message)}`));
     }
   }
   error(message) {
-    this.#options.sink.error(this.#palette.red(` \u2718  ${redactUrlCredentials(message)}`));
+    if (!this.#options.silent) {
+      this.#options.sink.error(this.#palette.red(` \u2718  ${shownText(message)}`));
+    }
   }
 }
 function createTerminalLogger(options) {

package/dist/adapters/terminal-logger/terminal-logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"terminal-logger.mjs","sources":["../../../src/adapters/terminal-logger/terminal-logger.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport type { DebugGroup, Logger } from \"../../application/ports/logger.js\";\nimport { redactUrlCredentials } from \"../../domain/url-credentials.js\";\n\n/**\n * The Logger port on a terminal, with the original output format: ` ⚠  ` warnings, ` ✘  `\n * errors, and `openapi-ts:<group>` debug lines filtered by `DEBUG` (ENGINEERING_PLAN 4.5). No\n * line shows the user info of a URL.\n */\n\n/** Where the lines go: `console` in production, a recording sink in tests. */\nexport interface TerminalSink {\n  debug(line: string): void;\n  warn(line: string): void;\n  error(line: string): void;\n}\n\nexport interface TerminalLoggerOptions {\n  /** Drop warnings (errors and debug lines are still written). */\n  readonly silent: boolean;\n  /** The value of `DEBUG`: `*`, `openapi-ts:*` or `openapi-ts:<group>` turn debug lines on. */\n  readonly debugFilter: string | undefined;\n  readonly useColors: boolean;\n  readonly sink: TerminalSink;\n}\n\ntype Colors = ReturnType<typeof colors.create>;\n\nconst MILLISECONDS_PER_SECOND = 1000;\nconst MILLISECONDS_PER_MINUTE = 60_000;\n\n/** A duration as the original prints it: one decimal, in ms, s or m. */\nexport function formatDuration(milliseconds: number): string {\n  if (milliseconds < MILLISECONDS_PER_SECOND) {\n    return `${Math.round(10 * milliseconds) / 10}ms`;\n  }\n  if (milliseconds < MILLISECONDS_PER_MINUTE) {\n    return `${Math.round(milliseconds / 100) / 10}s`;\n  }\n  return `${Math.round(milliseconds / 6000) / 10}m`;\n}\n\nfunction groupColor(palette: Colors, group: DebugGroup | undefined): (text: string) => string {\n  const byGroup: Readonly<Partial<Record<DebugGroup, (text: string) => string>>> = {\n    redoc: palette.cyanBright,\n    lint: palette.yellowBright,\n    bundle: palette.magentaBright,\n    ts: palette.blueBright,\n  };\n  return (group && byGroup[group]) || palette.whiteBright;\n}\n\n/** Whether `DEBUG` asks for this group (the original check, case-insensitive for the group). */\nexport function isDebugEnabled(filter: string | undefined, group: DebugGroup | undefined): boolean {\n  if (!filter) {\n    return false;\n  }\n  return (\n    !group ||\n    filter === \"*\" ||\n    filter === \"openapi-ts:*\" ||\n    filter.toLocaleLowerCase() === `openapi-ts:${group.toLocaleLowerCase()}`\n  );\n}\n\nclass TerminalLogger implements Logger {\n  readonly #options: TerminalLoggerOptions;\n  readonly #palette: Colors;\n\n  constructor(options: TerminalLoggerOptions) {\n    this.#options = options;\n    this.#palette = colors.create();\n    this.#palette.enabled = options.useColors;\n  }\n\n  debug(message: string, group?: DebugGroup, durationMs?: number): void {\n    if (!isDebugEnabled(this.#options.debugFilter, group)) {\n      return;\n    }\n    const name = groupColor(this.#palette, group)(`openapi-ts:${group ?? \"info\"}`);\n    // The original wrote no space without a duration (`openapi-ts:lintIgnored …`).\n    const time =\n      durationMs === undefined ? \" \" : this.#palette.green(` ${formatDuration(durationMs)} `);\n    const text = redactUrlCredentials(message);\n    this.#options.sink.debug(`  ${this.#palette.bold(name)}${time}${text}`);\n  }\n\n  warn(message: string): void {\n    if (!this.#options.silent) {\n      this.#options.sink.warn(this.#palette.yellow(` ⚠  ${redactUrlCredentials(message)}`));\n    }\n  }\n\n  error(message: string): void {\n    this.#options.sink.error(this.#palette.red(` ✘  ${redactUrlCredentials(message)}`));\n  }\n}\n\n/** A Logger that writes to a terminal sink. */\nexport function createTerminalLogger(options: TerminalLoggerOptions): Logger {\n  return new TerminalLogger(options);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"terminal-logger.mjs","sources":["../../../src/adapters/terminal-logger/terminal-logger.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport type { DebugGroup, Logger } from \"../../application/ports/logger.js\";\nimport { terminalSafeText } from \"../../domain/terminal-text.js\";\nimport { redactUrlSecrets } from \"../../domain/url-secrets.js\";\n\n/**\n * The Logger port on a terminal, with the original output format: ` ⚠  ` warnings, ` ✘  `\n * errors, and `openapi-ts:<group>` debug lines filtered by `DEBUG` (ENGINEERING_PLAN 4.5). No\n * line shows the secrets of a URL, and each message prints as one line: a message quotes the\n * document, whose control characters could forge CI commands (terminal-text.ts).\n */\n\nfunction shownText(message: string): string {\n  return terminalSafeText(redactUrlSecrets(message));\n}\n\n/** Where the lines go: `console` in production, a recording sink in tests. */\nexport interface TerminalSink {\n  debug(line: string): void;\n  warn(line: string): void;\n  error(line: string): void;\n}\n\nexport interface TerminalLoggerOptions {\n  /**\n   * Drop warnings and error lines; debug lines, which `DEBUG` asks for, are still written. The\n   * error lines are the problems of a document that fails to load, which the thrown error lists.\n   */\n  readonly silent: boolean;\n  /** The value of `DEBUG`: `*`, `openapi-ts:*` or `openapi-ts:<group>` turn debug lines on. */\n  readonly debugFilter: string | undefined;\n  readonly useColors: boolean;\n  readonly sink: TerminalSink;\n}\n\ntype Colors = ReturnType<typeof colors.create>;\n\nconst MILLISECONDS_PER_SECOND = 1000;\nconst MILLISECONDS_PER_MINUTE = 60_000;\n\n/** A duration as the original prints it: one decimal, in ms, s or m. */\nexport function formatDuration(milliseconds: number): string {\n  if (milliseconds < MILLISECONDS_PER_SECOND) {\n    return `${Math.round(10 * milliseconds) / 10}ms`;\n  }\n  if (milliseconds < MILLISECONDS_PER_MINUTE) {\n    return `${Math.round(milliseconds / 100) / 10}s`;\n  }\n  return `${Math.round(milliseconds / 6000) / 10}m`;\n}\n\nfunction groupColor(palette: Colors, group: DebugGroup | undefined): (text: string) => string {\n  const byGroup: Readonly<Partial<Record<DebugGroup, (text: string) => string>>> = {\n    redoc: palette.cyanBright,\n    lint: palette.yellowBright,\n    bundle: palette.magentaBright,\n    ts: palette.blueBright,\n  };\n  return (group && byGroup[group]) || palette.whiteBright;\n}\n\n/** Whether `DEBUG` asks for this group (the original check, case-insensitive for the group). */\nexport function isDebugEnabled(filter: string | undefined, group: DebugGroup | undefined): boolean {\n  if (!filter) {\n    return false;\n  }\n  return (\n    !group ||\n    filter === \"*\" ||\n    filter === \"openapi-ts:*\" ||\n    filter.toLocaleLowerCase() === `openapi-ts:${group.toLocaleLowerCase()}`\n  );\n}\n\nclass TerminalLogger implements Logger {\n  readonly #options: TerminalLoggerOptions;\n  readonly #palette: Colors;\n\n  constructor(options: TerminalLoggerOptions) {\n    this.#options = options;\n    this.#palette = colors.create();\n    this.#palette.enabled = options.useColors;\n  }\n\n  debug(message: string, group?: DebugGroup, durationMs?: number): void {\n    if (!isDebugEnabled(this.#options.debugFilter, group)) {\n      return;\n    }\n    const name = groupColor(this.#palette, group)(`openapi-ts:${group ?? \"info\"}`);\n    // The original wrote no space without a duration (`openapi-ts:lintIgnored …`).\n    const time =\n      durationMs === undefined ? \" \" : this.#palette.green(` ${formatDuration(durationMs)} `);\n    const text = shownText(message);\n    this.#options.sink.debug(`  ${this.#palette.bold(name)}${time}${text}`);\n  }\n\n  warn(message: string): void {\n    if (!this.#options.silent) {\n      this.#options.sink.warn(this.#palette.yellow(` ⚠  ${shownText(message)}`));\n    }\n  }\n\n  error(message: string): void {\n    if (!this.#options.silent) {\n      this.#options.sink.error(this.#palette.red(` ✘  ${shownText(message)}`));\n    }\n  }\n}\n\n/** A Logger that writes to a terminal sink. */\nexport function createTerminalLogger(options: TerminalLoggerOptions): Logger {\n  return new TerminalLogger(options);\n}\n"],"names":[],"mappings":"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"}

package/dist/api/default-ports.cjs

@@ -14,21 +14,33 @@ function terminalSupportsColor() {
   const stdout = supportsColor__default.stdout;
   return Boolean(stdout) && stdout !== false && stdout.hasBasic !== false;
 }
+const STDERR_SINK = {
+  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel
+  debug: (line) => console.error(line),
+  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel
+  warn: (line) => console.warn(line),
+  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel
+  error: (line) => console.error(line)
+};
 function defaultLogger(silent) {
   return terminalLogger.createTerminalLogger({
     silent,
     debugFilter: process.env.DEBUG,
     useColors: terminalSupportsColor(),
-    sink: console
+    sink: STDERR_SINK
   });
 }
 function defaultDeprecationReporter() {
   return nodeDeprecations.createNodeDeprecationReporter();
 }
 const REMOTE_REF_TIMEOUT_MS = 6e4;
+const MEBIBYTE = 1024 * 1024;
 const DEFAULT_REMOTE_DOCUMENT_LIMITS = {
   maxDocuments: 1e4,
-  maxParallelFetches: 16
+  maxParallelFetches: 16,
+  maxDocumentBytes: 128 * MEBIBYTE,
+  maxTotalBytes: 256 * MEBIBYTE,
+  maxNodes: 8e6
 };
 function processCwd() {
   return process.cwd();

package/dist/api/default-ports.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"default-ports.cjs","sources":["../../src/api/default-ports.ts"],"sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport { createConfig, type Config as RedoclyConfig } from \"@redocly/openapi-core\";\nimport supportsColor from \"supports-color\";\nimport { createNodeDeprecationReporter } from \"../adapters/node-deprecations/node-deprecations.js\";\nimport type { RemoteDocumentLimits } from \"../adapters/redocly-loader/remote-fetch.js\";\nimport { createTerminalLogger } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DeprecationReporter } from \"../application/ports/deprecation-reporter.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\n\n/**\n * The default adapters of the Node API (ENGINEERING_PLAN 4.5): this module and the CLI's\n * composition root are where the process environment is read.\n */\n\n/** Colors when the terminal supports them, as the original decided. */\nexport function terminalSupportsColor(): boolean {\n  const stdout = supportsColor.stdout;\n  return Boolean(stdout) && stdout !== false && stdout.hasBasic !== false;\n}\n\n/** The terminal logger with `DEBUG` from the environment, writing to the console. */\nexport function defaultLogger(silent: boolean): Logger {\n  return createTerminalLogger({\n    silent,\n    debugFilter: process.env.DEBUG,\n    useColors: terminalSupportsColor(),\n    sink: console,\n  });\n}\n\n/** Deprecations as Node.js `DeprecationWarning`s, each code once per process. */\nexport function defaultDeprecationReporter(): DeprecationReporter {\n  return createNodeDeprecationReporter();\n}\n\n/**\n * How long one remote `$ref` (or a remote source) may take to load. Large documents (the 27 MB\n * Cloudflare spec) download in seconds; a minute covers slow hosts, while Node's own fetch would\n * wait five minutes for a server that never answers (ENGINEERING_PLAN 8.5).\n */\nexport const REMOTE_REF_TIMEOUT_MS = 60_000;\n\n/**\n * Bounds on the remote documents of one run (ADR-033). Large split documents have a few thousand\n * files, so 10,000 leaves room and still ends an endless fan-out. 16 parallel fetches keep a\n * multi-file document fast without exhausting local ports.\n */\nexport const DEFAULT_REMOTE_DOCUMENT_LIMITS: RemoteDocumentLimits = {\n  maxDocuments: 10_000,\n  maxParallelFetches: 16,\n};\n\n/** The working directory of the process: the default `cwd` of an inline source. */\nexport function processCwd(): string {\n  return process.cwd();\n}\n\n/** A monotonic clock in milliseconds, for debug durations. */\nexport function monotonicNow(): number {\n  return performance.now();\n}\n\n/** The default Redocly config: minimal rules, and duplicate operation IDs are an error. */\nexport function defaultRedoclyConfig(): Promise<RedoclyConfig> {\n  const rules = { \"operation-operationId-unique\": { severity: \"error\" as const } };\n  return createConfig({ rules }, { extends: [\"minimal\"] });\n}\n"],"names":["supportsColor","createTerminalLogger","createNodeDeprecationReporter","performance","createConfig"],"mappings":";;;;;;;;;;;;AAeO,SAAS,qBAAA,GAAiC;AAC/C,EAAA,MAAM,SAASA,sBAAA,CAAc,MAAA;AAC7B,EAAA,OAAO,QAAQ,MAAM,CAAA,IAAK,MAAA,KAAW,KAAA,IAAS,OAAO,QAAA,KAAa,KAAA;AACpE;AAGO,SAAS,cAAc,MAAA,EAAyB;AACrD,EAAA,OAAOC,mCAAA,CAAqB;AAAA,IAC1B,MAAA;AAAA,IACA,WAAA,EAAa,QAAQ,GAAA,CAAI,KAAA;AAAA,IACzB,WAAW,qBAAA,EAAsB;AAAA,IACjC,IAAA,EAAM;AAAA,GACP,CAAA;AACH;AAGO,SAAS,0BAAA,GAAkD;AAChE,EAAA,OAAOC,8CAAA,EAA8B;AACvC;AAOO,MAAM,qBAAA,GAAwB;AAO9B,MAAM,8BAAA,GAAuD;AAAA,EAClE,YAAA,EAAc,GAAA;AAAA,EACd,kBAAA,EAAoB;AACtB;AAGO,SAAS,UAAA,GAAqB;AACnC,EAAA,OAAO,QAAQ,GAAA,EAAI;AACrB;AAGO,SAAS,YAAA,GAAuB;AACrC,EAAA,OAAOC,4BAAY,GAAA,EAAI;AACzB;AAGO,SAAS,oBAAA,GAA+C;AAC7D,EAAA,MAAM,QAAQ,EAAE,8BAAA,EAAgC,EAAE,QAAA,EAAU,SAAiB,EAAE;AAC/E,EAAA,OAAOC,wBAAA,CAAa,EAAE,KAAA,EAAM,EAAG,EAAE,OAAA,EAAS,CAAC,SAAS,CAAA,EAAG,CAAA;AACzD;;;;;;;;;"}
+{"version":3,"file":"default-ports.cjs","sources":["../../src/api/default-ports.ts"],"sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport { createConfig, type Config as RedoclyConfig } from \"@redocly/openapi-core\";\nimport supportsColor from \"supports-color\";\nimport { createNodeDeprecationReporter } from \"../adapters/node-deprecations/node-deprecations.js\";\nimport type { RemoteDocumentLimits } from \"../adapters/redocly-loader/remote-fetch.js\";\nimport {\n  createTerminalLogger,\n  type TerminalSink,\n} from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DeprecationReporter } from \"../application/ports/deprecation-reporter.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\n\n/**\n * The default adapters of the Node API (ENGINEERING_PLAN 4.5): this module and the CLI's\n * composition root are where the process environment is read.\n */\n\n/** Colors when the terminal supports them, as the original decided. */\nexport function terminalSupportsColor(): boolean {\n  const stdout = supportsColor.stdout;\n  return Boolean(stdout) && stdout !== false && stdout.hasBasic !== false;\n}\n\n/**\n * Every line of the logger goes to stderr: the CLI writes the types to stdout, and `console.debug`\n * writes there too, so debug lines would end up inside the generated file.\n */\nconst STDERR_SINK: TerminalSink = {\n  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel\n  debug: (line) => console.error(line),\n  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel\n  warn: (line) => console.warn(line),\n  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel\n  error: (line) => console.error(line),\n};\n\n/** The terminal logger with `DEBUG` from the environment, writing to stderr. */\nexport function defaultLogger(silent: boolean): Logger {\n  return createTerminalLogger({\n    silent,\n    debugFilter: process.env.DEBUG,\n    useColors: terminalSupportsColor(),\n    sink: STDERR_SINK,\n  });\n}\n\n/** Deprecations as Node.js `DeprecationWarning`s, each code once per process. */\nexport function defaultDeprecationReporter(): DeprecationReporter {\n  return createNodeDeprecationReporter();\n}\n\n/**\n * How long one remote `$ref` (or a remote source) may take to load. Large documents (the 27 MB\n * Cloudflare spec) download in seconds; a minute covers slow hosts, while Node's own fetch would\n * wait five minutes for a server that never answers (ENGINEERING_PLAN 8.5).\n */\nexport const REMOTE_REF_TIMEOUT_MS = 60_000;\n\nconst MEBIBYTE = 1024 * 1024;\n\n/**\n * Bounds on the remote documents of one schema (ADR-033). Large split documents have a few thousand\n * files, so 10,000 leaves room and still ends an endless fan-out. 16 parallel fetches keep a\n * multi-file document fast without exhausting local ports.\n *\n * The size limits count decoded bytes and parsed nodes (threat model T2, ADR-033 decision 6).\n * The largest document of the 1,820-entry compatibility corpus is Microsoft Graph beta: 71 MiB,\n * 2.65 million nodes (keys and values), 1.6 GB peak memory when loaded from a URL. A remote body\n * took about 7 bytes of memory per byte of text and 110 per node in our measurements, so 128 MiB\n * per document (1.8 times Graph beta), 256 MiB per schema (a split document may be twice as\n * large) and 8 million nodes per schema (3 times Graph beta) let crafted documents finish within\n * a heap of 2 GB; with the default heap of 4 GB they peak at about 1.2 to 2.3 GB.\n */\nexport const DEFAULT_REMOTE_DOCUMENT_LIMITS: RemoteDocumentLimits = {\n  maxDocuments: 10_000,\n  maxParallelFetches: 16,\n  maxDocumentBytes: 128 * MEBIBYTE,\n  maxTotalBytes: 256 * MEBIBYTE,\n  maxNodes: 8_000_000,\n};\n\n/** The working directory of the process: the default `cwd` of an inline source. */\nexport function processCwd(): string {\n  return process.cwd();\n}\n\n/** A monotonic clock in milliseconds, for debug durations. */\nexport function monotonicNow(): number {\n  return performance.now();\n}\n\n/** The default Redocly config: minimal rules, and duplicate operation IDs are an error. */\nexport function defaultRedoclyConfig(): Promise<RedoclyConfig> {\n  const rules = { \"operation-operationId-unique\": { severity: \"error\" as const } };\n  return createConfig({ rules }, { extends: [\"minimal\"] });\n}\n"],"names":["supportsColor","createTerminalLogger","createNodeDeprecationReporter","performance","createConfig"],"mappings":";;;;;;;;;;;;AAkBO,SAAS,qBAAA,GAAiC;AAC/C,EAAA,MAAM,SAASA,sBAAA,CAAc,MAAA;AAC7B,EAAA,OAAO,QAAQ,MAAM,CAAA,IAAK,MAAA,KAAW,KAAA,IAAS,OAAO,QAAA,KAAa,KAAA;AACpE;AAMA,MAAM,WAAA,GAA4B;AAAA;AAAA,EAEhC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA;AAAA,EAEnC,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,EAEjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI;AACrC,CAAA;AAGO,SAAS,cAAc,MAAA,EAAyB;AACrD,EAAA,OAAOC,mCAAA,CAAqB;AAAA,IAC1B,MAAA;AAAA,IACA,WAAA,EAAa,QAAQ,GAAA,CAAI,KAAA;AAAA,IACzB,WAAW,qBAAA,EAAsB;AAAA,IACjC,IAAA,EAAM;AAAA,GACP,CAAA;AACH;AAGO,SAAS,0BAAA,GAAkD;AAChE,EAAA,OAAOC,8CAAA,EAA8B;AACvC;AAOO,MAAM,qBAAA,GAAwB;AAErC,MAAM,WAAW,IAAA,GAAO,IAAA;AAejB,MAAM,8BAAA,GAAuD;AAAA,EAClE,YAAA,EAAc,GAAA;AAAA,EACd,kBAAA,EAAoB,EAAA;AAAA,EACpB,kBAAkB,GAAA,GAAM,QAAA;AAAA,EACxB,eAAe,GAAA,GAAM,QAAA;AAAA,EACrB,QAAA,EAAU;AACZ;AAGO,SAAS,UAAA,GAAqB;AACnC,EAAA,OAAO,QAAQ,GAAA,EAAI;AACrB;AAGO,SAAS,YAAA,GAAuB;AACrC,EAAA,OAAOC,4BAAY,GAAA,EAAI;AACzB;AAGO,SAAS,oBAAA,GAA+C;AAC7D,EAAA,MAAM,QAAQ,EAAE,8BAAA,EAAgC,EAAE,QAAA,EAAU,SAAiB,EAAE;AAC/E,EAAA,OAAOC,wBAAA,CAAa,EAAE,KAAA,EAAM,EAAG,EAAE,OAAA,EAAS,CAAC,SAAS,CAAA,EAAG,CAAA;AACzD;;;;;;;;;"}

package/dist/api/default-ports.mjs

@@ -8,21 +8,33 @@ function terminalSupportsColor() {
   const stdout = supportsColor.stdout;
   return Boolean(stdout) && stdout !== false && stdout.hasBasic !== false;
 }
+const STDERR_SINK = {
+  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel
+  debug: (line) => console.error(line),
+  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel
+  warn: (line) => console.warn(line),
+  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel
+  error: (line) => console.error(line)
+};
 function defaultLogger(silent) {
   return createTerminalLogger({
     silent,
     debugFilter: process.env.DEBUG,
     useColors: terminalSupportsColor(),
-    sink: console
+    sink: STDERR_SINK
   });
 }
 function defaultDeprecationReporter() {
   return createNodeDeprecationReporter();
 }
 const REMOTE_REF_TIMEOUT_MS = 6e4;
+const MEBIBYTE = 1024 * 1024;
 const DEFAULT_REMOTE_DOCUMENT_LIMITS = {
   maxDocuments: 1e4,
-  maxParallelFetches: 16
+  maxParallelFetches: 16,
+  maxDocumentBytes: 128 * MEBIBYTE,
+  maxTotalBytes: 256 * MEBIBYTE,
+  maxNodes: 8e6
 };
 function processCwd() {
   return process.cwd();

package/dist/api/default-ports.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"default-ports.mjs","sources":["../../src/api/default-ports.ts"],"sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport { createConfig, type Config as RedoclyConfig } from \"@redocly/openapi-core\";\nimport supportsColor from \"supports-color\";\nimport { createNodeDeprecationReporter } from \"../adapters/node-deprecations/node-deprecations.js\";\nimport type { RemoteDocumentLimits } from \"../adapters/redocly-loader/remote-fetch.js\";\nimport { createTerminalLogger } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DeprecationReporter } from \"../application/ports/deprecation-reporter.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\n\n/**\n * The default adapters of the Node API (ENGINEERING_PLAN 4.5): this module and the CLI's\n * composition root are where the process environment is read.\n */\n\n/** Colors when the terminal supports them, as the original decided. */\nexport function terminalSupportsColor(): boolean {\n  const stdout = supportsColor.stdout;\n  return Boolean(stdout) && stdout !== false && stdout.hasBasic !== false;\n}\n\n/** The terminal logger with `DEBUG` from the environment, writing to the console. */\nexport function defaultLogger(silent: boolean): Logger {\n  return createTerminalLogger({\n    silent,\n    debugFilter: process.env.DEBUG,\n    useColors: terminalSupportsColor(),\n    sink: console,\n  });\n}\n\n/** Deprecations as Node.js `DeprecationWarning`s, each code once per process. */\nexport function defaultDeprecationReporter(): DeprecationReporter {\n  return createNodeDeprecationReporter();\n}\n\n/**\n * How long one remote `$ref` (or a remote source) may take to load. Large documents (the 27 MB\n * Cloudflare spec) download in seconds; a minute covers slow hosts, while Node's own fetch would\n * wait five minutes for a server that never answers (ENGINEERING_PLAN 8.5).\n */\nexport const REMOTE_REF_TIMEOUT_MS = 60_000;\n\n/**\n * Bounds on the remote documents of one run (ADR-033). Large split documents have a few thousand\n * files, so 10,000 leaves room and still ends an endless fan-out. 16 parallel fetches keep a\n * multi-file document fast without exhausting local ports.\n */\nexport const DEFAULT_REMOTE_DOCUMENT_LIMITS: RemoteDocumentLimits = {\n  maxDocuments: 10_000,\n  maxParallelFetches: 16,\n};\n\n/** The working directory of the process: the default `cwd` of an inline source. */\nexport function processCwd(): string {\n  return process.cwd();\n}\n\n/** A monotonic clock in milliseconds, for debug durations. */\nexport function monotonicNow(): number {\n  return performance.now();\n}\n\n/** The default Redocly config: minimal rules, and duplicate operation IDs are an error. */\nexport function defaultRedoclyConfig(): Promise<RedoclyConfig> {\n  const rules = { \"operation-operationId-unique\": { severity: \"error\" as const } };\n  return createConfig({ rules }, { extends: [\"minimal\"] });\n}\n"],"names":[],"mappings":";;;;;;AAeO,SAAS,qBAAA,GAAiC;AAC/C,EAAA,MAAM,SAAS,aAAA,CAAc,MAAA;AAC7B,EAAA,OAAO,QAAQ,MAAM,CAAA,IAAK,MAAA,KAAW,KAAA,IAAS,OAAO,QAAA,KAAa,KAAA;AACpE;AAGO,SAAS,cAAc,MAAA,EAAyB;AACrD,EAAA,OAAO,oBAAA,CAAqB;AAAA,IAC1B,MAAA;AAAA,IACA,WAAA,EAAa,QAAQ,GAAA,CAAI,KAAA;AAAA,IACzB,WAAW,qBAAA,EAAsB;AAAA,IACjC,IAAA,EAAM;AAAA,GACP,CAAA;AACH;AAGO,SAAS,0BAAA,GAAkD;AAChE,EAAA,OAAO,6BAAA,EAA8B;AACvC;AAOO,MAAM,qBAAA,GAAwB;AAO9B,MAAM,8BAAA,GAAuD;AAAA,EAClE,YAAA,EAAc,GAAA;AAAA,EACd,kBAAA,EAAoB;AACtB;AAGO,SAAS,UAAA,GAAqB;AACnC,EAAA,OAAO,QAAQ,GAAA,EAAI;AACrB;AAGO,SAAS,YAAA,GAAuB;AACrC,EAAA,OAAO,YAAY,GAAA,EAAI;AACzB;AAGO,SAAS,oBAAA,GAA+C;AAC7D,EAAA,MAAM,QAAQ,EAAE,8BAAA,EAAgC,EAAE,QAAA,EAAU,SAAiB,EAAE;AAC/E,EAAA,OAAO,YAAA,CAAa,EAAE,KAAA,EAAM,EAAG,EAAE,OAAA,EAAS,CAAC,SAAS,CAAA,EAAG,CAAA;AACzD;;"}
+{"version":3,"file":"default-ports.mjs","sources":["../../src/api/default-ports.ts"],"sourcesContent":["import { performance } from \"node:perf_hooks\";\nimport { createConfig, type Config as RedoclyConfig } from \"@redocly/openapi-core\";\nimport supportsColor from \"supports-color\";\nimport { createNodeDeprecationReporter } from \"../adapters/node-deprecations/node-deprecations.js\";\nimport type { RemoteDocumentLimits } from \"../adapters/redocly-loader/remote-fetch.js\";\nimport {\n  createTerminalLogger,\n  type TerminalSink,\n} from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DeprecationReporter } from \"../application/ports/deprecation-reporter.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\n\n/**\n * The default adapters of the Node API (ENGINEERING_PLAN 4.5): this module and the CLI's\n * composition root are where the process environment is read.\n */\n\n/** Colors when the terminal supports them, as the original decided. */\nexport function terminalSupportsColor(): boolean {\n  const stdout = supportsColor.stdout;\n  return Boolean(stdout) && stdout !== false && stdout.hasBasic !== false;\n}\n\n/**\n * Every line of the logger goes to stderr: the CLI writes the types to stdout, and `console.debug`\n * writes there too, so debug lines would end up inside the generated file.\n */\nconst STDERR_SINK: TerminalSink = {\n  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel\n  debug: (line) => console.error(line),\n  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel\n  warn: (line) => console.warn(line),\n  // biome-ignore lint/suspicious/noConsole: the terminal logger's own channel\n  error: (line) => console.error(line),\n};\n\n/** The terminal logger with `DEBUG` from the environment, writing to stderr. */\nexport function defaultLogger(silent: boolean): Logger {\n  return createTerminalLogger({\n    silent,\n    debugFilter: process.env.DEBUG,\n    useColors: terminalSupportsColor(),\n    sink: STDERR_SINK,\n  });\n}\n\n/** Deprecations as Node.js `DeprecationWarning`s, each code once per process. */\nexport function defaultDeprecationReporter(): DeprecationReporter {\n  return createNodeDeprecationReporter();\n}\n\n/**\n * How long one remote `$ref` (or a remote source) may take to load. Large documents (the 27 MB\n * Cloudflare spec) download in seconds; a minute covers slow hosts, while Node's own fetch would\n * wait five minutes for a server that never answers (ENGINEERING_PLAN 8.5).\n */\nexport const REMOTE_REF_TIMEOUT_MS = 60_000;\n\nconst MEBIBYTE = 1024 * 1024;\n\n/**\n * Bounds on the remote documents of one schema (ADR-033). Large split documents have a few thousand\n * files, so 10,000 leaves room and still ends an endless fan-out. 16 parallel fetches keep a\n * multi-file document fast without exhausting local ports.\n *\n * The size limits count decoded bytes and parsed nodes (threat model T2, ADR-033 decision 6).\n * The largest document of the 1,820-entry compatibility corpus is Microsoft Graph beta: 71 MiB,\n * 2.65 million nodes (keys and values), 1.6 GB peak memory when loaded from a URL. A remote body\n * took about 7 bytes of memory per byte of text and 110 per node in our measurements, so 128 MiB\n * per document (1.8 times Graph beta), 256 MiB per schema (a split document may be twice as\n * large) and 8 million nodes per schema (3 times Graph beta) let crafted documents finish within\n * a heap of 2 GB; with the default heap of 4 GB they peak at about 1.2 to 2.3 GB.\n */\nexport const DEFAULT_REMOTE_DOCUMENT_LIMITS: RemoteDocumentLimits = {\n  maxDocuments: 10_000,\n  maxParallelFetches: 16,\n  maxDocumentBytes: 128 * MEBIBYTE,\n  maxTotalBytes: 256 * MEBIBYTE,\n  maxNodes: 8_000_000,\n};\n\n/** The working directory of the process: the default `cwd` of an inline source. */\nexport function processCwd(): string {\n  return process.cwd();\n}\n\n/** A monotonic clock in milliseconds, for debug durations. */\nexport function monotonicNow(): number {\n  return performance.now();\n}\n\n/** The default Redocly config: minimal rules, and duplicate operation IDs are an error. */\nexport function defaultRedoclyConfig(): Promise<RedoclyConfig> {\n  const rules = { \"operation-operationId-unique\": { severity: \"error\" as const } };\n  return createConfig({ rules }, { extends: [\"minimal\"] });\n}\n"],"names":[],"mappings":";;;;;;AAkBO,SAAS,qBAAA,GAAiC;AAC/C,EAAA,MAAM,SAAS,aAAA,CAAc,MAAA;AAC7B,EAAA,OAAO,QAAQ,MAAM,CAAA,IAAK,MAAA,KAAW,KAAA,IAAS,OAAO,QAAA,KAAa,KAAA;AACpE;AAMA,MAAM,WAAA,GAA4B;AAAA;AAAA,EAEhC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI,CAAA;AAAA;AAAA,EAEnC,IAAA,EAAM,CAAC,IAAA,KAAS,OAAA,CAAQ,KAAK,IAAI,CAAA;AAAA;AAAA,EAEjC,KAAA,EAAO,CAAC,IAAA,KAAS,OAAA,CAAQ,MAAM,IAAI;AACrC,CAAA;AAGO,SAAS,cAAc,MAAA,EAAyB;AACrD,EAAA,OAAO,oBAAA,CAAqB;AAAA,IAC1B,MAAA;AAAA,IACA,WAAA,EAAa,QAAQ,GAAA,CAAI,KAAA;AAAA,IACzB,WAAW,qBAAA,EAAsB;AAAA,IACjC,IAAA,EAAM;AAAA,GACP,CAAA;AACH;AAGO,SAAS,0BAAA,GAAkD;AAChE,EAAA,OAAO,6BAAA,EAA8B;AACvC;AAOO,MAAM,qBAAA,GAAwB;AAErC,MAAM,WAAW,IAAA,GAAO,IAAA;AAejB,MAAM,8BAAA,GAAuD;AAAA,EAClE,YAAA,EAAc,GAAA;AAAA,EACd,kBAAA,EAAoB,EAAA;AAAA,EACpB,kBAAkB,GAAA,GAAM,QAAA;AAAA,EACxB,eAAe,GAAA,GAAM,QAAA;AAAA,EACrB,QAAA,EAAU;AACZ;AAGO,SAAS,UAAA,GAAqB;AACnC,EAAA,OAAO,QAAQ,GAAA,EAAI;AACrB;AAGO,SAAS,YAAA,GAAuB;AACrC,EAAA,OAAO,YAAY,GAAA,EAAI;AACzB;AAGO,SAAS,oBAAA,GAA+C;AAC7D,EAAA,MAAM,QAAQ,EAAE,8BAAA,EAAgC,EAAE,QAAA,EAAU,SAAiB,EAAE;AAC/E,EAAA,OAAO,YAAA,CAAa,EAAE,KAAA,EAAM,EAAG,EAAE,OAAA,EAAS,CAAC,SAAS,CAAA,EAAG,CAAA;AACzD;;"}

package/dist/api/discriminator-enum-parent.cjs

@@ -7,14 +7,14 @@ const ROOT_SEGMENTS = 3;
 function typedAt(ref) {
   const segments = jsonPointer.parseRefPointer(ref);
   const nested = segments.slice(ROOT_SEGMENTS).filter((segment) => segment !== PROPERTIES_KEYWORD);
-  return jsonPointer.createRef([...segments.slice(0, ROOT_SEGMENTS), ...nested]);
+  return jsonPointer.appendPointer(jsonPointer.ROOT_POINTER, [...segments.slice(0, ROOT_SEGMENTS), ...nested]);
 }
 function isSchemaObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function ownProperty(item, ref, name) {
   const property = ("properties" in item ? item.properties : void 0)?.[name];
-  return property === void 0 ? void 0 : { property, path: jsonPointer.createRef([ref, name]) };
+  return property === void 0 ? void 0 : { property, path: jsonPointer.appendPointer(ref, [name]) };
 }
 function declaredProperty(ref, name, resolve, visited) {
   const schema = resolve(ref);