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

package/dist/domain/warnings.cjs

@@ -2,6 +2,7 @@
 
 const WARNING_CODES = {
   CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED",
+  CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED",
   CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN",
   DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID",
   DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",

package/dist/domain/warnings.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.cjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":";;AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;;"}
+{"version":3,"file":"warnings.cjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CLI_OUTPUT_IGNORED: \"CLI_OUTPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":";;AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;;"}

package/dist/domain/warnings.mjs

@@ -1,5 +1,6 @@
 const WARNING_CODES = {
   CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED",
+  CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED",
   CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN",
   DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID",
   DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",

package/dist/domain/warnings.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"warnings.mjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":"AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;"}
+{"version":3,"file":"warnings.mjs","sources":["../../src/domain/warnings.ts"],"sourcesContent":["/**\n * Typed warnings. A warning does not stop the run: the output is written and the CLI exits with 0.\n * Each one ends with a stable machine-readable code in parentheses, as the CLI prints errors\n * (`message (CODE)`), so a script or a person can search for it.\n */\n\n/** Every warning code. */\nexport const WARNING_CODES = {\n  CLI_INPUT_IGNORED: \"CLI_INPUT_IGNORED\",\n  CLI_OUTPUT_IGNORED: \"CLI_OUTPUT_IGNORED\",\n  CONFIG_SETTING_UNKNOWN: \"CONFIG_SETTING_UNKNOWN\",\n  DISCRIMINATOR_MAPPING_INVALID: \"DISCRIMINATOR_MAPPING_INVALID\",\n  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  FIX_NEEDS_OPTION: \"FIX_NEEDS_OPTION\",\n  LINT_PROBLEM: \"LINT_PROBLEM\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\n  REF_CIRCULAR: \"REF_CIRCULAR\",\n  REF_NOT_FOUND: \"REF_NOT_FOUND\",\n} as const;\n\nexport type WarningCode = (typeof WARNING_CODES)[keyof typeof WARNING_CODES];\n\n/** The warning line for people, with its code at the end. */\nexport function warningText(message: string, code: WarningCode): string {\n  return `${message} (${code})`;\n}\n"],"names":[],"mappings":"AAOO,MAAM,aAAA,GAAgB;AAAA,EAC3B,iBAAA,EAAmB,mBAAA;AAAA,EACnB,kBAAA,EAAoB,oBAAA;AAAA,EACpB,sBAAA,EAAwB,wBAAA;AAAA,EACxB,6BAAA,EAA+B,+BAAA;AAAA,EAC/B,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,gBAAA,EAAkB,kBAAA;AAAA,EAClB,YAAA,EAAc,cAAA;AAAA,EACd,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B,2BAAA;AAAA,EAC3B,YAAA,EAAc,cAAA;AAAA,EACd,aAAA,EAAe;AACjB;AAKO,SAAS,WAAA,CAAY,SAAiB,IAAA,EAA2B;AACtE,EAAA,OAAO,CAAA,EAAG,OAAO,CAAA,EAAA,EAAK,IAAI,CAAA,CAAA,CAAA;AAC5B;;"}

package/dist/index.d.cts

@@ -4,6 +4,22 @@ import { Config } from '@redocly/openapi-core';
 import * as TypeScript from 'typescript';
 import colors from 'ansi-colors';
 
+/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
+type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
+/**
+ * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
+ * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
+ */
+interface Logger {
+    /**
+     * A debug line, with how long the step took when it was measured. A line without a group is
+     * written whenever debug output is on.
+     */
+    debug(message: string, group?: DebugGroup, durationMs?: number): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+
 /**
  * Type IR: the closed set of immutable nodes that describes the TypeScript types and declarations
  * the generator emits (ENGINEERING_PLAN §4.2, ADR-002). Nodes are plain readonly data with a `kind`
@@ -268,6 +284,11 @@ declare const FIX: {
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
     /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
     readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    /**
+     * `--default-non-nullable` finds parameters and request bodies by the document's structure, not
+     * by the words `parameters` and `requestBody` anywhere in a schema's location.
+     */
+    readonly DEFAULT_INPUT_LOCATIONS: "default-input-locations";
     /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
     readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     /**
@@ -280,8 +301,8 @@ declare const FIX: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
-    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
-    readonly PARAMETER_CONTENT: "parameter-content";
+    /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */
+    readonly PARAMETER_HEADER_CONTENT: "parameter-header-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -1474,22 +1495,6 @@ declare const DEPRECATION_CODES: {
 };
 type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
 
-/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
-type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
-/**
- * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
- * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
- */
-interface Logger {
-    /**
-     * A debug line, with how long the step took when it was measured. A line without a group is
-     * written whenever debug output is on.
-     */
-    debug(message: string, group?: DebugGroup, durationMs?: number): void;
-    warn(message: string): void;
-    error(message: string): void;
-}
-
 /**
  * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)
  * @param {string|URL|object|Readable} source OpenAPI schema source:
@@ -1526,8 +1531,10 @@ declare const ERROR_CODES: {
     readonly ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY";
     readonly CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE";
     readonly OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN";
+    readonly OPTION_INVALID: "OPTION_INVALID";
     readonly TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND";
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
+    readonly CLI_FLAG_INVALID: "CLI_FLAG_INVALID";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
     readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
@@ -1849,6 +1856,7 @@ declare function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclar
 /** Every warning code. */
 declare const WARNING_CODES: {
     readonly CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED";
+    readonly CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED";
     readonly CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN";
     readonly DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID";
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";

package/dist/index.d.mts

@@ -4,6 +4,22 @@ import { Config } from '@redocly/openapi-core';
 import * as TypeScript from 'typescript';
 import colors from 'ansi-colors';
 
+/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
+type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
+/**
+ * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
+ * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
+ */
+interface Logger {
+    /**
+     * A debug line, with how long the step took when it was measured. A line without a group is
+     * written whenever debug output is on.
+     */
+    debug(message: string, group?: DebugGroup, durationMs?: number): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+
 /**
  * Type IR: the closed set of immutable nodes that describes the TypeScript types and declarations
  * the generator emits (ENGINEERING_PLAN §4.2, ADR-002). Nodes are plain readonly data with a `kind`
@@ -268,6 +284,11 @@ declare const FIX: {
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
     /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
     readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    /**
+     * `--default-non-nullable` finds parameters and request bodies by the document's structure, not
+     * by the words `parameters` and `requestBody` anywhere in a schema's location.
+     */
+    readonly DEFAULT_INPUT_LOCATIONS: "default-input-locations";
     /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
     readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     /**
@@ -280,8 +301,8 @@ declare const FIX: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
-    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
-    readonly PARAMETER_CONTENT: "parameter-content";
+    /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */
+    readonly PARAMETER_HEADER_CONTENT: "parameter-header-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -1474,22 +1495,6 @@ declare const DEPRECATION_CODES: {
 };
 type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
 
-/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
-type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
-/**
- * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
- * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
- */
-interface Logger {
-    /**
-     * A debug line, with how long the step took when it was measured. A line without a group is
-     * written whenever debug output is on.
-     */
-    debug(message: string, group?: DebugGroup, durationMs?: number): void;
-    warn(message: string): void;
-    error(message: string): void;
-}
-
 /**
  * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)
  * @param {string|URL|object|Readable} source OpenAPI schema source:
@@ -1526,8 +1531,10 @@ declare const ERROR_CODES: {
     readonly ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY";
     readonly CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE";
     readonly OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN";
+    readonly OPTION_INVALID: "OPTION_INVALID";
     readonly TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND";
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
+    readonly CLI_FLAG_INVALID: "CLI_FLAG_INVALID";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
     readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
@@ -1849,6 +1856,7 @@ declare function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclar
 /** Every warning code. */
 declare const WARNING_CODES: {
     readonly CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED";
+    readonly CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED";
     readonly CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN";
     readonly DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID";
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";

package/dist/index.d.ts

@@ -4,6 +4,22 @@ import { Config } from '@redocly/openapi-core';
 import * as TypeScript from 'typescript';
 import colors from 'ansi-colors';
 
+/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
+type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
+/**
+ * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
+ * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
+ */
+interface Logger {
+    /**
+     * A debug line, with how long the step took when it was measured. A line without a group is
+     * written whenever debug output is on.
+     */
+    debug(message: string, group?: DebugGroup, durationMs?: number): void;
+    warn(message: string): void;
+    error(message: string): void;
+}
+
 /**
  * Type IR: the closed set of immutable nodes that describes the TypeScript types and declarations
  * the generator emits (ENGINEERING_PLAN §4.2, ADR-002). Nodes are plain readonly data with a `kind`
@@ -268,6 +284,11 @@ declare const FIX: {
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
     /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
     readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    /**
+     * `--default-non-nullable` finds parameters and request bodies by the document's structure, not
+     * by the words `parameters` and `requestBody` anywhere in a schema's location.
+     */
+    readonly DEFAULT_INPUT_LOCATIONS: "default-input-locations";
     /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
     readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     /**
@@ -280,8 +301,8 @@ declare const FIX: {
     readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
     /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
     readonly NULLABLE_ENUMS: "nullable-enums";
-    /** A parameter with `content` instead of `schema` is typed by the schema of its media type. */
-    readonly PARAMETER_CONTENT: "parameter-content";
+    /** A parameter or header with `content`, not `schema`, is typed by its media type's schema. */
+    readonly PARAMETER_HEADER_CONTENT: "parameter-header-content";
     /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
     readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
     /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
@@ -1474,22 +1495,6 @@ declare const DEPRECATION_CODES: {
 };
 type DeprecationCode = (typeof DEPRECATION_CODES)[keyof typeof DEPRECATION_CODES];
 
-/** The debug groups of the original `DEBUG=openapi-ts:<group>` output. */
-type DebugGroup = "redoc" | "lint" | "bundle" | "ts";
-/**
- * Where the generator reports progress and problems (ENGINEERING_PLAN 4.5). Whether warnings are
- * printed (`silent`) and debug output (`DEBUG`) is decided by the adapter, when it is created.
- */
-interface Logger {
-    /**
-     * A debug line, with how long the step took when it was measured. A line without a group is
-     * written whenever debug output is on.
-     */
-    debug(message: string, group?: DebugGroup, durationMs?: number): void;
-    warn(message: string): void;
-    error(message: string): void;
-}
-
 /**
  * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)
  * @param {string|URL|object|Readable} source OpenAPI schema source:
@@ -1526,8 +1531,10 @@ declare const ERROR_CODES: {
     readonly ENUM_NAME_EMPTY: "ENUM_NAME_EMPTY";
     readonly CALLBACK_RESULT_UNREADABLE: "CALLBACK_RESULT_UNREADABLE";
     readonly OPTION_FIX_UNKNOWN: "OPTION_FIX_UNKNOWN";
+    readonly OPTION_INVALID: "OPTION_INVALID";
     readonly TYPESCRIPT_NOT_FOUND: "TYPESCRIPT_NOT_FOUND";
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
+    readonly CLI_FLAG_INVALID: "CLI_FLAG_INVALID";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
     readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
@@ -1849,6 +1856,7 @@ declare function transformSchema(schema: OpenAPI3, ctx: GlobalContext): IrDeclar
 /** Every warning code. */
 declare const WARNING_CODES: {
     readonly CLI_INPUT_IGNORED: "CLI_INPUT_IGNORED";
+    readonly CLI_OUTPUT_IGNORED: "CLI_OUTPUT_IGNORED";
     readonly CONFIG_SETTING_UNKNOWN: "CONFIG_SETTING_UNKNOWN";
     readonly DISCRIMINATOR_MAPPING_INVALID: "DISCRIMINATOR_MAPPING_INVALID";
     readonly DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "openapi-typesafe",
   "description": "Convert OpenAPI 3.0, 3.1 & 3.2 schemas to TypeScript",
-  "version": "1.0.0-rc.4",
+  "version": "1.0.0-rc.5",
   "author": {
     "name": "Fedor Chishchin",
     "url": "https://github.com/fedorello"

package/src/adapters/node-file-system/node-file-system.ts

@@ -3,6 +3,7 @@ import { fileURLToPath } from "node:url";
 import type {
   ClaimedFile,
   DirectoryCheck,
+  FileCheck,
   FileClaims,
   FileIdentity,
   FileReader,
@@ -110,7 +111,9 @@ function typedWrite<T>(file: URL, step: () => T): T {
   }
 }
 
-class NodeFileSystem implements FileReader, FileWriter, FileIdentity, DirectoryCheck, FileClaims {
+class NodeFileSystem
+  implements FileReader, FileWriter, FileIdentity, DirectoryCheck, FileCheck, FileClaims
+{
   readText(file: URL): string {
     try {
       return fs.readFileSync(file, "utf8");
@@ -144,6 +147,15 @@ class NodeFileSystem implements FileReader, FileWriter, FileIdentity, DirectoryC
     }
   }
 
+  isFile(file: URL): boolean {
+    try {
+      return fs.statSync(file).isFile();
+    } catch {
+      // Missing or unreadable: no file; the read that follows reports a failure.
+      return false;
+    }
+  }
+
   isSameFile(left: URL, right: URL): boolean {
     const leftPath = fileURLToPath(left);
     const rightPath = fileURLToPath(right);
@@ -166,6 +178,7 @@ export function createNodeFileSystem(): FileReader &
   FileWriter &
   FileIdentity &
   DirectoryCheck &
+  FileCheck &
   FileClaims {
   return new NodeFileSystem();
 }

package/src/adapters/pipe-safe-writer/pipe-safe-writer.ts

@@ -0,0 +1,29 @@
+import type { Writable } from "node:stream";
+
+/**
+ * A writer for the CLI's stdout that stops when the reader closes the pipe (`| head`): the write
+ * fails with `EPIPE`, which Node raises as an unhandled `error` event and a crash with exit code
+ * 1. The reader has all it wanted, so the rest is dropped and the run ends as it would have.
+ * Every other write error is thrown again, as before.
+ */
+
+const BROKEN_PIPE = "EPIPE";
+
+function isBrokenPipe(error: Error): boolean {
+  return (error as NodeJS.ErrnoException).code === BROKEN_PIPE;
+}
+
+/**
+ * The text writer of the stream. After `EPIPE` the stream is destroyed, so later writes are
+ * dropped by the stream itself and raise no second error.
+ */
+export function createPipeSafeWriter(stream: Writable): (text: string) => void {
+  stream.on("error", (error: Error) => {
+    if (!isBrokenPipe(error)) {
+      throw error;
+    }
+  });
+  return (text) => {
+    stream.write(text);
+  };
+}

package/src/adapters/redocly-loader/bundled-mapping-copies.ts

@@ -1,5 +1,6 @@
-import { childPointer, ROOT_POINTER } from "../../domain/openapi/json-pointer.js";
-import { findRefHolders } from "./ref-holders.js";
+import { childPointer } from "../../domain/openapi/json-pointer.js";
+import { type ComponentSchemas, componentSchemasOf, SCHEMAS_POINTER } from "./component-schemas.js";
+import { findMappings, findRefHolders } from "./ref-holders.js";
 
 /**
  * Redocly 1.x bundles every discriminator `mapping` value as if it were an external `$ref`: it
@@ -11,27 +12,13 @@ import { findRefHolders } from "./ref-holders.js";
  * and the mapping values and `$ref`s that name it point at the original.
  */
 
-type Schemas = Record<string, unknown>;
-
-const SCHEMAS_POINTER = childPointer(childPointer(ROOT_POINTER, "components"), "schemas");
-
-function isContainer(value: unknown): value is Record<string, unknown> {
-  return typeof value === "object" && value !== null;
-}
-
-function schemasOf(document: unknown): Schemas | undefined {
-  const components = isContainer(document) ? document.components : undefined;
-  const schemas = isContainer(components) ? components.schemas : undefined;
-  return isContainer(schemas) ? schemas : undefined;
-}
-
 /** The keys of `components.schemas` before bundling: the bundle edits the document in place. */
 export function schemaKeysOf(document: unknown): ReadonlySet<string> {
-  return new Set(Object.keys(schemasOf(document) ?? {}));
+  return new Set(Object.keys(componentSchemasOf(document) ?? {}));
 }
 
 /** Each key the bundle added as a copy, with the pointer of the schema it copies. */
-function copiesIn(schemas: Schemas, keysBefore: ReadonlySet<string>): Map<string, string> {
+function copiesIn(schemas: ComponentSchemas, keysBefore: ReadonlySet<string>): Map<string, string> {
   const originals = new Map<unknown, string>();
   for (const key of keysBefore) {
     if (Object.hasOwn(schemas, key) && !originals.has(schemas[key])) {
@@ -49,39 +36,17 @@ function copiesIn(schemas: Schemas, keysBefore: ReadonlySet<string>): Map<string
   return copies;
 }
 
-/** Every `discriminator.mapping` object of the document; the walk has its own stack. */
-function mappingsOf(document: unknown): Record<string, unknown>[] {
-  const mappings: Record<string, unknown>[] = [];
-  const visited = new WeakSet<object>();
-  const pending: unknown[] = [document];
-  for (let next = pending.pop(); next !== undefined; next = pending.pop()) {
-    if (!isContainer(next) || visited.has(next)) {
-      continue;
-    }
-    visited.add(next);
-    const mapping = isContainer(next.discriminator) ? next.discriminator.mapping : undefined;
-    if (isContainer(mapping)) {
-      mappings.push(mapping);
-    }
-    // One push per child: spreading an array of millions of children overflows the stack.
-    for (const child of Object.values(next)) {
-      pending.push(child);
-    }
-  }
-  return mappings;
-}
-
 /** Remove the bundle's copies of the document's own schemas, in place. */
 export function removeBundledMappingCopies(
   bundled: unknown,
   keysBefore: ReadonlySet<string>,
 ): void {
-  const schemas = schemasOf(bundled);
+  const schemas = componentSchemasOf(bundled);
   const copies = schemas === undefined ? new Map<string, string>() : copiesIn(schemas, keysBefore);
   if (copies.size === 0) {
     return;
   }
-  for (const mapping of mappingsOf(bundled)) {
+  for (const mapping of findMappings(bundled)) {
     for (const [name, value] of Object.entries(mapping)) {
       const original = typeof value === "string" ? copies.get(value) : undefined;
       if (original !== undefined) {

package/src/adapters/redocly-loader/component-schemas.ts

@@ -0,0 +1,19 @@
+import { childPointer, ROOT_POINTER } from "../../domain/openapi/json-pointer.js";
+
+/** `components.schemas` of a parsed document, which the loader repairs in place. */
+
+export type ComponentSchemas = Record<string, unknown>;
+
+/** `#/components/schemas`. */
+export const SCHEMAS_POINTER = childPointer(childPointer(ROOT_POINTER, "components"), "schemas");
+
+function isContainer(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null;
+}
+
+/** The `components.schemas` object of a document, when it has one. */
+export function componentSchemasOf(document: unknown): ComponentSchemas | undefined {
+  const components = isContainer(document) ? document.components : undefined;
+  const schemas = isContainer(components) ? components.schemas : undefined;
+  return isContainer(schemas) ? schemas : undefined;
+}

package/src/adapters/redocly-loader/mapping-schema-names.ts

@@ -0,0 +1,25 @@
+import { childPointer } from "../../domain/openapi/json-pointer.js";
+import { componentSchemasOf, SCHEMAS_POINTER } from "./component-schemas.js";
+import { findMappings } from "./ref-holders.js";
+
+/**
+ * A discriminator `mapping` value may be a schema name (`cat: Cat`) or a URI reference. Redocly
+ * reads every value as a `$ref`, so a name failed with "Can't resolve $ref". OpenAPI 3.1.1
+ * (§4.8.25) leaves a value that is both to the implementation and recommends the schema name; a
+ * relative URI is then written `./Cat`. So a value that is a key of the document's
+ * `components.schemas` becomes the pointer to that schema, in place, before the `$ref`s are
+ * resolved. Any other value stays a URI reference.
+ */
+export function pointMappingNamesAtSchemas(document: unknown): void {
+  const schemas = componentSchemasOf(document);
+  if (schemas === undefined) {
+    return;
+  }
+  for (const mapping of findMappings(document)) {
+    for (const [name, value] of Object.entries(mapping)) {
+      if (typeof value === "string" && Object.hasOwn(schemas, value)) {
+        mapping[name] = childPointer(SCHEMAS_POINTER, value);
+      }
+    }
+  }
+}