openapi-typesafe 1.0.0-rc.0 → 1.0.0-rc.1

package/dist/domain/openapi/parameter-object.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parameter-object.mjs","sources":["../../../src/domain/openapi/parameter-object.ts"],"sourcesContent":["import type { ContentMap } from \"./media-type-object.js\";\nimport type { ReferenceSchema, Schema } from \"./schema-object.js\";\n\nexport type ParameterLocation = \"query\" | \"header\" | \"path\" | \"cookie\";\n\n/** Every parameter location, in the order the generated `parameters` type lists them. */\nexport const PARAMETER_LOCATIONS: readonly ParameterLocation[] = Object.freeze([\n  \"query\",\n  \"header\",\n  \"path\",\n  \"cookie\",\n]);\n\n/**\n * The OpenAPI 3.2 location of a parameter that is the whole query string, described by `content`.\n * Its type becomes the `query` member of `parameters` (ADR-020).\n */\nexport const QUERYSTRING_LOCATION = \"querystring\";\n\n/** The parts of a Parameter Object the generator reads (OpenAPI 3.2 §4.8.12). */\nexport interface ParameterObject {\n  readonly name: string;\n  readonly in: ParameterLocation | typeof QUERYSTRING_LOCATION;\n  readonly required?: boolean;\n  readonly deprecated?: boolean;\n  readonly schema?: Schema;\n  readonly content?: ContentMap;\n}\n\nexport type ParameterOrReference = ParameterObject | ReferenceSchema;\n"],"names":[],"mappings":"AAMO,MAAM,mBAAA,GAAoD,OAAO,MAAA,CAAO;AAAA,EAC7E,OAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAC;AAMM,MAAM,oBAAA,GAAuB;;"}
+{"version":3,"file":"parameter-object.mjs","sources":["../../../src/domain/openapi/parameter-object.ts"],"sourcesContent":["import type { ContentMap } from \"./media-type-object.js\";\nimport type { ReferenceSchema, Schema } from \"./schema-object.js\";\n\nexport type ParameterLocation = \"query\" | \"header\" | \"path\" | \"cookie\";\n\n/** Every parameter location, in the order the generated `parameters` type lists them. */\nexport const PARAMETER_LOCATIONS: readonly ParameterLocation[] = Object.freeze([\n  \"query\",\n  \"header\",\n  \"path\",\n  \"cookie\",\n]);\n\n/**\n * The OpenAPI 3.2 location of a parameter that is the whole query string, described by `content`.\n * Its type becomes the `query` member of `parameters` (ADR-020).\n */\nexport const QUERYSTRING_LOCATION = \"querystring\";\n\n/** The parts of a Parameter Object the generator reads (OpenAPI 3.2 §4.8.12). */\nexport interface ParameterObject {\n  readonly name: string;\n  readonly in: ParameterLocation | typeof QUERYSTRING_LOCATION;\n  readonly required?: boolean;\n  readonly deprecated?: boolean;\n  /** How the value is serialized; `form` for `in: query` when absent (§4.8.12.4). */\n  readonly style?: string;\n  /** Whether an array or object value is sent as several values; true for `form` when absent. */\n  readonly explode?: boolean;\n  readonly schema?: Schema;\n  readonly content?: ContentMap;\n}\n\nexport type ParameterOrReference = ParameterObject | ReferenceSchema;\n"],"names":[],"mappings":"AAMO,MAAM,mBAAA,GAAoD,OAAO,MAAA,CAAO;AAAA,EAC7E,OAAA;AAAA,EACA,QAAA;AAAA,EACA,MAAA;AAAA,EACA;AACF,CAAC;AAMM,MAAM,oBAAA,GAAuB;;"}

package/dist/domain/openapi/path-templates.cjs

@@ -0,0 +1,23 @@
+'use strict';
+
+const PATH_PARAMETER_RE = /\{[^}]+\}/g;
+const PATH_PREFIX = "/";
+const UNNAMED_PARAMETER = "{}";
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function findIdenticalPathTemplates(document) {
+  const paths = isObject(document) && isObject(document.paths) ? document.paths : {};
+  const byHierarchy = /* @__PURE__ */ new Map();
+  for (const url of Object.keys(paths)) {
+    if (!url.startsWith(PATH_PREFIX) || !url.includes("{")) {
+      continue;
+    }
+    const hierarchy = url.replace(PATH_PARAMETER_RE, UNNAMED_PARAMETER);
+    byHierarchy.set(hierarchy, [...byHierarchy.get(hierarchy) ?? [], url]);
+  }
+  return [...byHierarchy.values()].filter((urls) => urls.length > 1);
+}
+
+exports.findIdenticalPathTemplates = findIdenticalPathTemplates;
+//# sourceMappingURL=path-templates.cjs.map

package/dist/domain/openapi/path-templates.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-templates.cjs","sources":["../../../src/domain/openapi/path-templates.ts"],"sourcesContent":["/**\n * The Paths Object rule (OpenAPI 3.1 §4.8.8): \"Templated paths with the same hierarchy but\n * different templated names MUST NOT exist as they are identical.\" Such paths, `/a/{id}` and\n * `/a/{name}`, match the same URLs, so a client cannot tell which one a request is for.\n */\n\nconst PATH_PARAMETER_RE = /\\{[^}]+\\}/g;\nconst PATH_PREFIX = \"/\";\nconst UNNAMED_PARAMETER = \"{}\";\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * The groups of paths that differ only in the names of their template parameters, each group in\n * document order, the groups in the order of their first path. Keys that are no path, such as an\n * `x-` extension, are left out.\n */\nexport function findIdenticalPathTemplates(document: unknown): string[][] {\n  const paths = isObject(document) && isObject(document.paths) ? document.paths : {};\n  const byHierarchy = new Map<string, string[]>();\n  for (const url of Object.keys(paths)) {\n    if (!url.startsWith(PATH_PREFIX) || !url.includes(\"{\")) {\n      continue;\n    }\n    const hierarchy = url.replace(PATH_PARAMETER_RE, UNNAMED_PARAMETER);\n    byHierarchy.set(hierarchy, [...(byHierarchy.get(hierarchy) ?? []), url]);\n  }\n  return [...byHierarchy.values()].filter((urls) => urls.length > 1);\n}\n"],"names":[],"mappings":";;AAMA,MAAM,iBAAA,GAAoB,YAAA;AAC1B,MAAM,WAAA,GAAc,GAAA;AACpB,MAAM,iBAAA,GAAoB,IAAA;AAE1B,SAAS,SAAS,KAAA,EAA4D;AAC5E,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAOO,SAAS,2BAA2B,QAAA,EAA+B;AACxE,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,QAAQ,CAAA,IAAK,QAAA,CAAS,SAAS,KAAK,CAAA,GAAI,QAAA,CAAS,KAAA,GAAQ,EAAC;AACjF,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAsB;AAC9C,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACpC,IAAA,IAAI,CAAC,IAAI,UAAA,CAAW,WAAW,KAAK,CAAC,GAAA,CAAI,QAAA,CAAS,GAAG,CAAA,EAAG;AACtD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAA,GAAY,GAAA,CAAI,OAAA,CAAQ,iBAAA,EAAmB,iBAAiB,CAAA;AAClE,IAAA,WAAA,CAAY,GAAA,CAAI,SAAA,EAAW,CAAC,GAAI,WAAA,CAAY,GAAA,CAAI,SAAS,CAAA,IAAK,EAAC,EAAI,GAAG,CAAC,CAAA;AAAA,EACzE;AACA,EAAA,OAAO,CAAC,GAAG,WAAA,CAAY,MAAA,EAAQ,CAAA,CAAE,MAAA,CAAO,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,GAAS,CAAC,CAAA;AACnE;;"}

package/dist/domain/openapi/path-templates.mjs

@@ -0,0 +1,21 @@
+const PATH_PARAMETER_RE = /\{[^}]+\}/g;
+const PATH_PREFIX = "/";
+const UNNAMED_PARAMETER = "{}";
+function isObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function findIdenticalPathTemplates(document) {
+  const paths = isObject(document) && isObject(document.paths) ? document.paths : {};
+  const byHierarchy = /* @__PURE__ */ new Map();
+  for (const url of Object.keys(paths)) {
+    if (!url.startsWith(PATH_PREFIX) || !url.includes("{")) {
+      continue;
+    }
+    const hierarchy = url.replace(PATH_PARAMETER_RE, UNNAMED_PARAMETER);
+    byHierarchy.set(hierarchy, [...byHierarchy.get(hierarchy) ?? [], url]);
+  }
+  return [...byHierarchy.values()].filter((urls) => urls.length > 1);
+}
+
+export { findIdenticalPathTemplates };
+//# sourceMappingURL=path-templates.mjs.map

package/dist/domain/openapi/path-templates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-templates.mjs","sources":["../../../src/domain/openapi/path-templates.ts"],"sourcesContent":["/**\n * The Paths Object rule (OpenAPI 3.1 §4.8.8): \"Templated paths with the same hierarchy but\n * different templated names MUST NOT exist as they are identical.\" Such paths, `/a/{id}` and\n * `/a/{name}`, match the same URLs, so a client cannot tell which one a request is for.\n */\n\nconst PATH_PARAMETER_RE = /\\{[^}]+\\}/g;\nconst PATH_PREFIX = \"/\";\nconst UNNAMED_PARAMETER = \"{}\";\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * The groups of paths that differ only in the names of their template parameters, each group in\n * document order, the groups in the order of their first path. Keys that are no path, such as an\n * `x-` extension, are left out.\n */\nexport function findIdenticalPathTemplates(document: unknown): string[][] {\n  const paths = isObject(document) && isObject(document.paths) ? document.paths : {};\n  const byHierarchy = new Map<string, string[]>();\n  for (const url of Object.keys(paths)) {\n    if (!url.startsWith(PATH_PREFIX) || !url.includes(\"{\")) {\n      continue;\n    }\n    const hierarchy = url.replace(PATH_PARAMETER_RE, UNNAMED_PARAMETER);\n    byHierarchy.set(hierarchy, [...(byHierarchy.get(hierarchy) ?? []), url]);\n  }\n  return [...byHierarchy.values()].filter((urls) => urls.length > 1);\n}\n"],"names":[],"mappings":"AAMA,MAAM,iBAAA,GAAoB,YAAA;AAC1B,MAAM,WAAA,GAAc,GAAA;AACpB,MAAM,iBAAA,GAAoB,IAAA;AAE1B,SAAS,SAAS,KAAA,EAA4D;AAC5E,EAAA,OAAO,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,CAAC,KAAA,CAAM,QAAQ,KAAK,CAAA;AAC5E;AAOO,SAAS,2BAA2B,QAAA,EAA+B;AACxE,EAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,QAAQ,CAAA,IAAK,QAAA,CAAS,SAAS,KAAK,CAAA,GAAI,QAAA,CAAS,KAAA,GAAQ,EAAC;AACjF,EAAA,MAAM,WAAA,uBAAkB,GAAA,EAAsB;AAC9C,EAAA,KAAA,MAAW,GAAA,IAAO,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,EAAG;AACpC,IAAA,IAAI,CAAC,IAAI,UAAA,CAAW,WAAW,KAAK,CAAC,GAAA,CAAI,QAAA,CAAS,GAAG,CAAA,EAAG;AACtD,MAAA;AAAA,IACF;AACA,IAAA,MAAM,SAAA,GAAY,GAAA,CAAI,OAAA,CAAQ,iBAAA,EAAmB,iBAAiB,CAAA;AAClE,IAAA,WAAA,CAAY,GAAA,CAAI,SAAA,EAAW,CAAC,GAAI,WAAA,CAAY,GAAA,CAAI,SAAS,CAAA,IAAK,EAAC,EAAI,GAAG,CAAC,CAAA;AAAA,EACzE;AACA,EAAA,OAAO,CAAC,GAAG,WAAA,CAAY,MAAA,EAAQ,CAAA,CAAE,MAAA,CAAO,CAAC,IAAA,KAAS,IAAA,CAAK,MAAA,GAAS,CAAC,CAAA;AACnE;;"}

package/dist/domain/output-fixes.cjs

@@ -3,14 +3,43 @@
 const errors = require('./errors.cjs');
 
 const OutputFix = {
+  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */
+  ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union",
   /** An `allOf` member with only `required` makes those properties of the others required. */
   ALLOF_REQUIRED: "allof-required",
+  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */
+  ANYOF_ONEOF_DESCRIPTIONS: "anyof-oneof-descriptions",
+  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */
+  ANYOF_ONEOF_REQUIRED: "anyof-oneof-required",
   /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */
   ANYOF_PROPERTIES: "anyof-properties",
   /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */
   ARRAY_LENGTH_TUPLES: "array-length-tuples",
-  /** A schema two discriminators name gets one enum of their values, a mapping before its name. */
+  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
+  DEDUPE_ENUM_NAMES: "dedupe-enum-names",
+  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
+  DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required",
+  /**
+   * The value a discriminator member gets: one enum of every discriminator's values, a mapping
+   * before the schema name, a schema's own mapping before an inherited one, none where the member
+   * declares it, and with `--enum` a member of the owner's enum.
+   */
   DISCRIMINATOR_VALUES: "discriminator-values",
+  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */
+  EXPLODED_QUERY_OBJECTS: "exploded-query-objects",
+  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
+  NULLABLE_ENUMS: "nullable-enums",
+  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
+  PATH_PARAM_TYPE_NAMES: "path-param-type-names",
+  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
+  PREFIX_ITEMS: "prefix-items",
+  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */
+  READ_WRITE_REFS: "read-write-refs",
+  /**
+   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it
+   * points at, also where the original type compiles through an index signature.
+   */
+  REF_POINTERS: "ref-pointers",
   /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */
   ROOT_TYPE_NUMBERING: "root-type-numbering",
   /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */
@@ -39,12 +68,18 @@ function resolveOutputFixes(names) {
   return new Set(names.flatMap((name) => name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name]));
 }
 const ROOT_TYPES = { option: "rootTypes", flag: "--root-types" };
+const ENUM = { option: "enum", flag: "--enum" };
 const NO_SCHEMA_PREFIX = {
   option: "rootTypesNoSchemaPrefix",
   flag: "--root-types-no-schema-prefix"
 };
 const REQUIREMENTS = {
   [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: "arrayLength", flag: "--array-length" }],
+  [OutputFix.DEDUPE_ENUM_NAMES]: [ENUM, { option: "dedupeEnums", flag: "--dedupe-enums" }],
+  [OutputFix.NULLABLE_ENUMS]: [ENUM],
+  [OutputFix.PATH_PARAM_TYPE_NAMES]: [
+    { option: "pathParamsAsTypes", flag: "--path-params-as-types" }
+  ],
   [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX]
 };
 function describeRequirement(requirement) {

package/dist/domain/output-fixes.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"output-fixes.cjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default.\n */\nexport const OutputFix = {\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** A schema two discriminators name gets one enum of their values, a mapping before its name. */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\nexport type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(OutputFix);\n\n/** The name that turns on every fix of the installed version. */\nexport const ALL_OUTPUT_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `all`. */\nexport type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_OUTPUT_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/** The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value. */\nexport function outputFixNamesOf(values: readonly unknown[]): readonly OutputFixName[] {\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option: \"arrayLength\" | \"rootTypes\" | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":"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"}
+{"version":3,"file":"output-fixes.cjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default.\n */\nexport const OutputFix = {\n  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */\n  ALLOF_DISCRIMINATED_UNION: \"allof-discriminated-union\",\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */\n  ANYOF_ONEOF_DESCRIPTIONS: \"anyof-oneof-descriptions\",\n  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */\n  ANYOF_ONEOF_REQUIRED: \"anyof-oneof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */\n  DEDUPE_ENUM_NAMES: \"dedupe-enum-names\",\n  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */\n  DISCRIMINATOR_MEMBER_REQUIRED: \"discriminator-member-required\",\n  /**\n   * The value a discriminator member gets: one enum of every discriminator's values, a mapping\n   * before the schema name, a schema's own mapping before an inherited one, none where the member\n   * declares it, and with `--enum` a member of the owner's enum.\n   */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */\n  EXPLODED_QUERY_OBJECTS: \"exploded-query-objects\",\n  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */\n  NULLABLE_ENUMS: \"nullable-enums\",\n  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */\n  PATH_PARAM_TYPE_NAMES: \"path-param-type-names\",\n  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */\n  PREFIX_ITEMS: \"prefix-items\",\n  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */\n  READ_WRITE_REFS: \"read-write-refs\",\n  /**\n   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it\n   * points at, also where the original type compiles through an index signature.\n   */\n  REF_POINTERS: \"ref-pointers\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\nexport type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(OutputFix);\n\n/** The name that turns on every fix of the installed version. */\nexport const ALL_OUTPUT_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `all`. */\nexport type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_OUTPUT_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/** The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value. */\nexport function outputFixNamesOf(values: readonly unknown[]): readonly OutputFixName[] {\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option:\n    | \"arrayLength\"\n    | \"dedupeEnums\"\n    | \"enum\"\n    | \"pathParamsAsTypes\"\n    | \"rootTypes\"\n    | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst ENUM = { option: \"enum\", flag: \"--enum\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [OutputFix.DEDUPE_ENUM_NAMES]: [ENUM, { option: \"dedupeEnums\", flag: \"--dedupe-enums\" }],\n  [OutputFix.NULLABLE_ENUMS]: [ENUM],\n  [OutputFix.PATH_PARAM_TYPE_NAMES]: [\n    { option: \"pathParamsAsTypes\", flag: \"--path-params-as-types\" },\n  ],\n  [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES"],"mappings":"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"}

package/dist/domain/output-fixes.mjs

@@ -1,14 +1,43 @@
 import { OpenAPITypesafeError, ERROR_CODES } from './errors.mjs';
 
 const OutputFix = {
+  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */
+  ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union",
   /** An `allOf` member with only `required` makes those properties of the others required. */
   ALLOF_REQUIRED: "allof-required",
+  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */
+  ANYOF_ONEOF_DESCRIPTIONS: "anyof-oneof-descriptions",
+  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */
+  ANYOF_ONEOF_REQUIRED: "anyof-oneof-required",
   /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */
   ANYOF_PROPERTIES: "anyof-properties",
   /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */
   ARRAY_LENGTH_TUPLES: "array-length-tuples",
-  /** A schema two discriminators name gets one enum of their values, a mapping before its name. */
+  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */
+  DEDUPE_ENUM_NAMES: "dedupe-enum-names",
+  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */
+  DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required",
+  /**
+   * The value a discriminator member gets: one enum of every discriminator's values, a mapping
+   * before the schema name, a schema's own mapping before an inherited one, none where the member
+   * declares it, and with `--enum` a member of the owner's enum.
+   */
   DISCRIMINATOR_VALUES: "discriminator-values",
+  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */
+  EXPLODED_QUERY_OBJECTS: "exploded-query-objects",
+  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */
+  NULLABLE_ENUMS: "nullable-enums",
+  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */
+  PATH_PARAM_TYPE_NAMES: "path-param-type-names",
+  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */
+  PREFIX_ITEMS: "prefix-items",
+  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */
+  READ_WRITE_REFS: "read-write-refs",
+  /**
+   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it
+   * points at, also where the original type compiles through an index signature.
+   */
+  REF_POINTERS: "ref-pointers",
   /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */
   ROOT_TYPE_NUMBERING: "root-type-numbering",
   /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */
@@ -37,12 +66,18 @@ function resolveOutputFixes(names) {
   return new Set(names.flatMap((name) => name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name]));
 }
 const ROOT_TYPES = { option: "rootTypes", flag: "--root-types" };
+const ENUM = { option: "enum", flag: "--enum" };
 const NO_SCHEMA_PREFIX = {
   option: "rootTypesNoSchemaPrefix",
   flag: "--root-types-no-schema-prefix"
 };
 const REQUIREMENTS = {
   [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: "arrayLength", flag: "--array-length" }],
+  [OutputFix.DEDUPE_ENUM_NAMES]: [ENUM, { option: "dedupeEnums", flag: "--dedupe-enums" }],
+  [OutputFix.NULLABLE_ENUMS]: [ENUM],
+  [OutputFix.PATH_PARAM_TYPE_NAMES]: [
+    { option: "pathParamsAsTypes", flag: "--path-params-as-types" }
+  ],
   [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX]
 };
 function describeRequirement(requirement) {

package/dist/domain/output-fixes.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"output-fixes.mjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default.\n */\nexport const OutputFix = {\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** A schema two discriminators name gets one enum of their values, a mapping before its name. */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\nexport type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(OutputFix);\n\n/** The name that turns on every fix of the installed version. */\nexport const ALL_OUTPUT_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `all`. */\nexport type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_OUTPUT_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/** The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value. */\nexport function outputFixNamesOf(values: readonly unknown[]): readonly OutputFixName[] {\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option: \"arrayLength\" | \"rootTypes\" | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"output-fixes.mjs","sources":["../../src/domain/output-fixes.ts"],"sourcesContent":["import { ERROR_CODES, OpenAPITypesafeError } from \"./errors.js\";\n\n/**\n * Opt-in fixes of the output of valid schemas (ADR-021). Each one changes only the cases it names;\n * without any, the output is the same as openapi-typescript 7.13 gives. In 2.0 they become the\n * default.\n */\nexport const OutputFix = {\n  /** An `allOf` `$ref` to a discriminated union is the union, without `Omit` or a schema name. */\n  ALLOF_DISCRIMINATED_UNION: \"allof-discriminated-union\",\n  /** An `allOf` member with only `required` makes those properties of the others required. */\n  ALLOF_REQUIRED: \"allof-required\",\n  /** The JSDoc of a schema lists the descriptions of its `anyOf` and `oneOf` members. */\n  ANYOF_ONEOF_DESCRIPTIONS: \"anyof-oneof-descriptions\",\n  /** `anyOf` / `oneOf` variants with only `required` make those keys of the parent required. */\n  ANYOF_ONEOF_REQUIRED: \"anyof-oneof-required\",\n  /** `anyOf` next to object keywords or `allOf` is intersected with them, not added to a union. */\n  ANYOF_PROPERTIES: \"anyof-properties\",\n  /** `--array-length` tuples have `min` to `max` items, nest right and follow `--immutable`. */\n  ARRAY_LENGTH_TUPLES: \"array-length-tuples\",\n  /** `--dedupe-enums` names a shared enum by all of its schemas, not by the first one. */\n  DEDUPE_ENUM_NAMES: \"dedupe-enum-names\",\n  /** `required` next to an `allOf` `$ref` to a discriminator member still gives `WithRequired`. */\n  DISCRIMINATOR_MEMBER_REQUIRED: \"discriminator-member-required\",\n  /**\n   * The value a discriminator member gets: one enum of every discriminator's values, a mapping\n   * before the schema name, a schema's own mapping before an inherited one, none where the member\n   * declares it, and with `--enum` a member of the owner's enum.\n   */\n  DISCRIMINATOR_VALUES: \"discriminator-values\",\n  /** An exploded object query parameter's properties are keys of `query`, as they are sent. */\n  EXPLODED_QUERY_OBJECTS: \"exploded-query-objects\",\n  /** `--enum` declares an enum that lists `null` without it, and the type adds `| null`. */\n  NULLABLE_ENUMS: \"nullable-enums\",\n  /** `--path-params-as-types` gives each `{name}` its placeholder, `{number}` included. */\n  PATH_PARAM_TYPE_NAMES: \"path-param-type-names\",\n  /** A `prefixItems` tuple is open unless `items` or `unevaluatedItems` closes it (2020-12). */\n  PREFIX_ITEMS: \"prefix-items\",\n  /** `readOnly` and `writeOnly` of the schema a `$ref` names, or of `allOf` members, count. */\n  READ_WRITE_REFS: \"read-write-refs\",\n  /**\n   * A `$ref` into schema keywords (`content/<type>/schema`, `items`, `allOf/0`) gets the type it\n   * points at, also where the original type compiles through an index signature.\n   */\n  REF_POINTERS: \"ref-pointers\",\n  /** Schemas of one root type name without the prefix each get an alias, the earlier numbered. */\n  ROOT_TYPE_NUMBERING: \"root-type-numbering\",\n  /** `unevaluatedProperties` types the keys no other keyword declares (an index signature). */\n  UNEVALUATED_PROPERTIES: \"unevaluated-properties\",\n} as const;\nexport type OutputFix = (typeof OutputFix)[keyof typeof OutputFix];\n\n/** Every fix of this version, in the order the docs list them. */\nexport const OUTPUT_FIXES: readonly OutputFix[] = Object.values(OutputFix);\n\n/** The name that turns on every fix of the installed version. */\nexport const ALL_OUTPUT_FIXES = \"all\";\n\n/** A name the `fix` option accepts: one fix, or `all`. */\nexport type OutputFixName = OutputFix | typeof ALL_OUTPUT_FIXES;\n\nconst KNOWN_NAMES: ReadonlySet<string> = new Set<string>([...OUTPUT_FIXES, ALL_OUTPUT_FIXES]);\n\nfunction isOutputFixName(value: unknown): value is OutputFixName {\n  return typeof value === \"string\" && KNOWN_NAMES.has(value);\n}\n\n/** The fix names as given; fails with `OPTION_FIX_UNKNOWN` for any other value. */\nexport function outputFixNamesOf(values: readonly unknown[]): readonly OutputFixName[] {\n  const unknown = values.filter((value) => !isOutputFixName(value));\n  if (unknown.length > 0) {\n    const names = unknown.map((value) => JSON.stringify(value)).join(\", \");\n    const known = [...KNOWN_NAMES].join(\", \");\n    throw new OpenAPITypesafeError({\n      code: ERROR_CODES.OPTION_FIX_UNKNOWN,\n      message: `Unknown fix ${names}. Known fixes: ${known}.`,\n      details: { unknown, known: [...KNOWN_NAMES] },\n    });\n  }\n  return values as readonly OutputFixName[];\n}\n\n/** The fixes the names turn on; `all` stands for every fix of this version. */\nexport function resolveOutputFixes(names: readonly OutputFixName[]): ReadonlySet<OutputFix> {\n  return new Set(names.flatMap((name) => (name === ALL_OUTPUT_FIXES ? OUTPUT_FIXES : [name])));\n}\n\n/** A generator option that a fix works with; without it, the fix changes nothing (ADR-021). */\nexport interface OutputFixRequirement {\n  readonly option:\n    | \"arrayLength\"\n    | \"dedupeEnums\"\n    | \"enum\"\n    | \"pathParamsAsTypes\"\n    | \"rootTypes\"\n    | \"rootTypesNoSchemaPrefix\";\n  readonly flag: string;\n}\n\nconst ROOT_TYPES = { option: \"rootTypes\", flag: \"--root-types\" } as const;\nconst ENUM = { option: \"enum\", flag: \"--enum\" } as const;\nconst NO_SCHEMA_PREFIX = {\n  option: \"rootTypesNoSchemaPrefix\",\n  flag: \"--root-types-no-schema-prefix\",\n} as const;\n\n/** The options each fix needs, by fix name; `all` has none. */\nconst REQUIREMENTS: Readonly<Partial<Record<OutputFixName, readonly OutputFixRequirement[]>>> = {\n  [OutputFix.ARRAY_LENGTH_TUPLES]: [{ option: \"arrayLength\", flag: \"--array-length\" }],\n  [OutputFix.DEDUPE_ENUM_NAMES]: [ENUM, { option: \"dedupeEnums\", flag: \"--dedupe-enums\" }],\n  [OutputFix.NULLABLE_ENUMS]: [ENUM],\n  [OutputFix.PATH_PARAM_TYPE_NAMES]: [\n    { option: \"pathParamsAsTypes\", flag: \"--path-params-as-types\" },\n  ],\n  [OutputFix.ROOT_TYPE_NUMBERING]: [ROOT_TYPES, NO_SCHEMA_PREFIX],\n};\n\nfunction describeRequirement(requirement: OutputFixRequirement): string {\n  return `${requirement.option} (${requirement.flag})`;\n}\n\n/**\n * A notice for each fix given by name with an option it needs off; it names the options that are\n * off. `all` adds none: it means every fix that applies, so one that does not apply is expected.\n */\nexport function ineffectiveFixNotices(\n  names: readonly OutputFixName[],\n  isOptionOn: (option: OutputFixRequirement[\"option\"]) => boolean,\n): string[] {\n  return [...new Set(names)].flatMap((name) => {\n    const missing = (REQUIREMENTS[name] ?? []).filter(({ option }) => !isOptionOn(option));\n    return missing.length === 0\n      ? []\n      : [`Fix \"${name}\" has no effect without ${missing.map(describeRequirement).join(\" and \")}`];\n  });\n}\n"],"names":[],"mappings":"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"}

package/dist/domain/warnings.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+const WARNING_CODES = {
+  DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",
+  ENUM_VALUES_EXCLUDED: "ENUM_VALUES_EXCLUDED",
+  PATH_TEMPLATES_IDENTICAL: "PATH_TEMPLATES_IDENTICAL",
+  QUERYSTRING_NEXT_TO_QUERY: "QUERYSTRING_NEXT_TO_QUERY"
+};
+function warningText(message, code) {
+  return `${message} (${code})`;
+}
+
+exports.WARNING_CODES = WARNING_CODES;
+exports.warningText = warningText;
+//# sourceMappingURL=warnings.cjs.map

package/dist/domain/warnings.cjs.map

@@ -0,0 +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  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\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,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B;AAC7B;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

@@ -0,0 +1,12 @@
+const WARNING_CODES = {
+  DISCRIMINATOR_VALUE_NOT_ALLOWED: "DISCRIMINATOR_VALUE_NOT_ALLOWED",
+  ENUM_VALUES_EXCLUDED: "ENUM_VALUES_EXCLUDED",
+  PATH_TEMPLATES_IDENTICAL: "PATH_TEMPLATES_IDENTICAL",
+  QUERYSTRING_NEXT_TO_QUERY: "QUERYSTRING_NEXT_TO_QUERY"
+};
+function warningText(message, code) {
+  return `${message} (${code})`;
+}
+
+export { WARNING_CODES, warningText };
+//# sourceMappingURL=warnings.mjs.map

package/dist/domain/warnings.mjs.map

@@ -0,0 +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  DISCRIMINATOR_VALUE_NOT_ALLOWED: \"DISCRIMINATOR_VALUE_NOT_ALLOWED\",\n  ENUM_VALUES_EXCLUDED: \"ENUM_VALUES_EXCLUDED\",\n  PATH_TEMPLATES_IDENTICAL: \"PATH_TEMPLATES_IDENTICAL\",\n  QUERYSTRING_NEXT_TO_QUERY: \"QUERYSTRING_NEXT_TO_QUERY\",\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,+BAAA,EAAiC,iCAAA;AAAA,EACjC,oBAAA,EAAsB,sBAAA;AAAA,EACtB,wBAAA,EAA0B,0BAAA;AAAA,EAC1B,yBAAA,EAA2B;AAC7B;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

@@ -35,6 +35,7 @@ interface IrArrayType {
 interface IrTupleElement {
     readonly type: IrType;
     readonly isRest: boolean;
+    readonly isOptional: boolean;
 }
 interface IrTupleType {
     readonly kind: "tuple";
@@ -152,10 +153,21 @@ interface Logger {
 }
 
 declare const OutputFix: {
+    readonly ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union";
     readonly ALLOF_REQUIRED: "allof-required";
+    readonly ANYOF_ONEOF_DESCRIPTIONS: "anyof-oneof-descriptions";
+    readonly ANYOF_ONEOF_REQUIRED: "anyof-oneof-required";
     readonly ANYOF_PROPERTIES: "anyof-properties";
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
+    readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     readonly DISCRIMINATOR_VALUES: "discriminator-values";
+    readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
+    readonly NULLABLE_ENUMS: "nullable-enums";
+    readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
+    readonly PREFIX_ITEMS: "prefix-items";
+    readonly READ_WRITE_REFS: "read-write-refs";
+    readonly REF_POINTERS: "ref-pointers";
     readonly ROOT_TYPE_NUMBERING: "root-type-numbering";
     readonly UNEVALUATED_PROPERTIES: "unevaluated-properties";
 };
@@ -170,8 +182,10 @@ interface EnumMemberMetadata {
 }
 interface EnumDeclarationRequest {
     readonly name: string;
+    readonly isComponentSchema: boolean;
     readonly values: readonly (string | number)[];
     readonly metadata: readonly EnumMemberMetadata[];
+    readonly isOwnerReference?: boolean;
 }
 interface EnumValuesRequest {
     readonly name: string;
@@ -180,6 +194,7 @@ interface EnumValuesRequest {
 }
 interface FooterDeclarations {
     addEnum(request: EnumDeclarationRequest): string;
+    enumMembers(name: string): ReadonlyMap<string | number, string>;
     addEnumValues(request: EnumValuesRequest): void;
     requireWithRequired(): void;
     requirePropertyValues(): void;
@@ -584,6 +599,11 @@ interface GlobalContext {
     discriminators: {
         objects: Record<string, DiscriminatorObject>;
         refsHandled: string[];
+        enumParents?: ReadonlyMap<object, {
+            readonly schema: SchemaObject;
+            readonly path: string;
+        }>;
+        otherProperties?: Readonly<Record<string, readonly string[]>>;
     };
     emptyObjectsUnknown: boolean;
     enum: boolean;
@@ -643,8 +663,10 @@ declare const ERROR_CODES: {
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
+    readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
+    readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
     readonly OUTPUT_STALE: "OUTPUT_STALE";
     readonly OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED";
     readonly OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED";
@@ -677,9 +699,16 @@ declare function astToString(ast: AstToStringInput, options?: AstToStringOptions
 
 declare const COMMENT_HEADER = "/**\n * This file was auto-generated by openapi-typesafe.\n * Do not make direct changes to the file.\n */\n\n";
 
+interface EnumParent {
+    readonly schema: SchemaObject;
+    readonly path: string;
+}
+
 interface DiscriminatorScan {
     objects: Record<string, DiscriminatorObject>;
     refsHandled: string[];
+    enumParents: ReadonlyMap<object, EnumParent>;
+    otherProperties: Readonly<Record<string, readonly string[]>>;
 }
 declare function scanDiscriminators(schema: OpenAPI3, options: GeneratorOptions, logger?: Logger): DiscriminatorScan;
 

package/dist/index.d.mts

@@ -35,6 +35,7 @@ interface IrArrayType {
 interface IrTupleElement {
     readonly type: IrType;
     readonly isRest: boolean;
+    readonly isOptional: boolean;
 }
 interface IrTupleType {
     readonly kind: "tuple";
@@ -152,10 +153,21 @@ interface Logger {
 }
 
 declare const OutputFix: {
+    readonly ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union";
     readonly ALLOF_REQUIRED: "allof-required";
+    readonly ANYOF_ONEOF_DESCRIPTIONS: "anyof-oneof-descriptions";
+    readonly ANYOF_ONEOF_REQUIRED: "anyof-oneof-required";
     readonly ANYOF_PROPERTIES: "anyof-properties";
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
+    readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     readonly DISCRIMINATOR_VALUES: "discriminator-values";
+    readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
+    readonly NULLABLE_ENUMS: "nullable-enums";
+    readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
+    readonly PREFIX_ITEMS: "prefix-items";
+    readonly READ_WRITE_REFS: "read-write-refs";
+    readonly REF_POINTERS: "ref-pointers";
     readonly ROOT_TYPE_NUMBERING: "root-type-numbering";
     readonly UNEVALUATED_PROPERTIES: "unevaluated-properties";
 };
@@ -170,8 +182,10 @@ interface EnumMemberMetadata {
 }
 interface EnumDeclarationRequest {
     readonly name: string;
+    readonly isComponentSchema: boolean;
     readonly values: readonly (string | number)[];
     readonly metadata: readonly EnumMemberMetadata[];
+    readonly isOwnerReference?: boolean;
 }
 interface EnumValuesRequest {
     readonly name: string;
@@ -180,6 +194,7 @@ interface EnumValuesRequest {
 }
 interface FooterDeclarations {
     addEnum(request: EnumDeclarationRequest): string;
+    enumMembers(name: string): ReadonlyMap<string | number, string>;
     addEnumValues(request: EnumValuesRequest): void;
     requireWithRequired(): void;
     requirePropertyValues(): void;
@@ -584,6 +599,11 @@ interface GlobalContext {
     discriminators: {
         objects: Record<string, DiscriminatorObject>;
         refsHandled: string[];
+        enumParents?: ReadonlyMap<object, {
+            readonly schema: SchemaObject;
+            readonly path: string;
+        }>;
+        otherProperties?: Readonly<Record<string, readonly string[]>>;
     };
     emptyObjectsUnknown: boolean;
     enum: boolean;
@@ -643,8 +663,10 @@ declare const ERROR_CODES: {
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
+    readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
+    readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
     readonly OUTPUT_STALE: "OUTPUT_STALE";
     readonly OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED";
     readonly OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED";
@@ -677,9 +699,16 @@ declare function astToString(ast: AstToStringInput, options?: AstToStringOptions
 
 declare const COMMENT_HEADER = "/**\n * This file was auto-generated by openapi-typesafe.\n * Do not make direct changes to the file.\n */\n\n";
 
+interface EnumParent {
+    readonly schema: SchemaObject;
+    readonly path: string;
+}
+
 interface DiscriminatorScan {
     objects: Record<string, DiscriminatorObject>;
     refsHandled: string[];
+    enumParents: ReadonlyMap<object, EnumParent>;
+    otherProperties: Readonly<Record<string, readonly string[]>>;
 }
 declare function scanDiscriminators(schema: OpenAPI3, options: GeneratorOptions, logger?: Logger): DiscriminatorScan;
 

package/dist/index.d.ts

@@ -35,6 +35,7 @@ interface IrArrayType {
 interface IrTupleElement {
     readonly type: IrType;
     readonly isRest: boolean;
+    readonly isOptional: boolean;
 }
 interface IrTupleType {
     readonly kind: "tuple";
@@ -152,10 +153,21 @@ interface Logger {
 }
 
 declare const OutputFix: {
+    readonly ALLOF_DISCRIMINATED_UNION: "allof-discriminated-union";
     readonly ALLOF_REQUIRED: "allof-required";
+    readonly ANYOF_ONEOF_DESCRIPTIONS: "anyof-oneof-descriptions";
+    readonly ANYOF_ONEOF_REQUIRED: "anyof-oneof-required";
     readonly ANYOF_PROPERTIES: "anyof-properties";
     readonly ARRAY_LENGTH_TUPLES: "array-length-tuples";
+    readonly DEDUPE_ENUM_NAMES: "dedupe-enum-names";
+    readonly DISCRIMINATOR_MEMBER_REQUIRED: "discriminator-member-required";
     readonly DISCRIMINATOR_VALUES: "discriminator-values";
+    readonly EXPLODED_QUERY_OBJECTS: "exploded-query-objects";
+    readonly NULLABLE_ENUMS: "nullable-enums";
+    readonly PATH_PARAM_TYPE_NAMES: "path-param-type-names";
+    readonly PREFIX_ITEMS: "prefix-items";
+    readonly READ_WRITE_REFS: "read-write-refs";
+    readonly REF_POINTERS: "ref-pointers";
     readonly ROOT_TYPE_NUMBERING: "root-type-numbering";
     readonly UNEVALUATED_PROPERTIES: "unevaluated-properties";
 };
@@ -170,8 +182,10 @@ interface EnumMemberMetadata {
 }
 interface EnumDeclarationRequest {
     readonly name: string;
+    readonly isComponentSchema: boolean;
     readonly values: readonly (string | number)[];
     readonly metadata: readonly EnumMemberMetadata[];
+    readonly isOwnerReference?: boolean;
 }
 interface EnumValuesRequest {
     readonly name: string;
@@ -180,6 +194,7 @@ interface EnumValuesRequest {
 }
 interface FooterDeclarations {
     addEnum(request: EnumDeclarationRequest): string;
+    enumMembers(name: string): ReadonlyMap<string | number, string>;
     addEnumValues(request: EnumValuesRequest): void;
     requireWithRequired(): void;
     requirePropertyValues(): void;
@@ -584,6 +599,11 @@ interface GlobalContext {
     discriminators: {
         objects: Record<string, DiscriminatorObject>;
         refsHandled: string[];
+        enumParents?: ReadonlyMap<object, {
+            readonly schema: SchemaObject;
+            readonly path: string;
+        }>;
+        otherProperties?: Readonly<Record<string, readonly string[]>>;
     };
     emptyObjectsUnknown: boolean;
     enum: boolean;
@@ -643,8 +663,10 @@ declare const ERROR_CODES: {
     readonly CLI_FLAG_REMOVED: "CLI_FLAG_REMOVED";
     readonly CLI_GLOB_UNSUPPORTED: "CLI_GLOB_UNSUPPORTED";
     readonly CLI_CONFIG_NOT_FOUND: "CLI_CONFIG_NOT_FOUND";
+    readonly CLI_CONFIG_INVALID: "CLI_CONFIG_INVALID";
     readonly CLI_CONFIG_OUTPUT_MISSING: "CLI_CONFIG_OUTPUT_MISSING";
     readonly CLI_CHECK_OUTPUT_MISSING: "CLI_CHECK_OUTPUT_MISSING";
+    readonly CLI_INPUT_MISSING: "CLI_INPUT_MISSING";
     readonly OUTPUT_STALE: "OUTPUT_STALE";
     readonly OUTPUT_READ_FAILED: "OUTPUT_READ_FAILED";
     readonly OUTPUT_WRITE_FAILED: "OUTPUT_WRITE_FAILED";
@@ -677,9 +699,16 @@ declare function astToString(ast: AstToStringInput, options?: AstToStringOptions
 
 declare const COMMENT_HEADER = "/**\n * This file was auto-generated by openapi-typesafe.\n * Do not make direct changes to the file.\n */\n\n";
 
+interface EnumParent {
+    readonly schema: SchemaObject;
+    readonly path: string;
+}
+
 interface DiscriminatorScan {
     objects: Record<string, DiscriminatorObject>;
     refsHandled: string[];
+    enumParents: ReadonlyMap<object, EnumParent>;
+    otherProperties: Readonly<Record<string, readonly string[]>>;
 }
 declare function scanDiscriminators(schema: OpenAPI3, options: GeneratorOptions, logger?: Logger): DiscriminatorScan;
 

package/dist/transform/components-object.cjs

@@ -4,10 +4,11 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 const transformContext = require('../api/transform-context.cjs');
 const components = require('../application/transform/document/components.cjs');
+const rootTypeAliases = require('../application/transform/document/root-type-aliases.cjs');
 
 function transformComponentsObject(componentsObject, ctx) {
   const { type, rootTypes } = components.componentsType(componentsObject, transformContext.createTransformContext(ctx));
-  return [type, ...rootTypes];
+  return [type, ...rootTypeAliases.renameTakenAliases(rootTypes, [])];
 }
 
 exports.default = transformComponentsObject;

package/dist/transform/components-object.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"components-object.cjs","sources":["../../src/transform/components-object.ts"],"sourcesContent":["import { createTransformContext } from \"../api/transform-context.js\";\nimport { componentsType } from \"../application/transform/document/components.js\";\nimport type { IrType, IrTypeAliasDeclaration } from \"../domain/ir/nodes.js\";\nimport { isEnumSchema, singularizeComponentKind } from \"../domain/openapi/components-object.js\";\nimport type { ComponentsObject, GlobalContext } from \"../types.js\";\n\nexport { isEnumSchema };\n\n/** `requestBodies` → `requestBody`; other keys drop the final `s`. */\nexport const singularizeComponentKey = singularizeComponentKind;\n\n/**\n * Transform the ComponentsObject (4.8.7)\n * @see https://spec.openapis.org/oas/latest.html#components-object\n *\n * Ported to IR (ENGINEERING_PLAN Phase 5, step 6). Same name and parameters as the original;\n * returns IR (task 6.2). For the public API: the `components` type, then the root type aliases.\n */\nexport default function transformComponentsObject(\n  componentsObject: ComponentsObject,\n  ctx: GlobalContext,\n): (IrType | IrTypeAliasDeclaration)[] {\n  const { type, rootTypes } = componentsType(componentsObject, createTransformContext(ctx));\n  return [type, ...rootTypes];\n}\n"],"names":["componentsType","createTransformContext"],"mappings":";;;;;;;AAkBA,SAAwB,yBAAA,CACtB,kBACA,GAAA,EACqC;AACrC,EAAA,MAAM,EAAE,MAAM,SAAA,EAAU,GAAIA,0BAAe,gBAAA,EAAkBC,uCAAA,CAAuB,GAAG,CAAC,CAAA;AACxF,EAAA,OAAO,CAAC,IAAA,EAAM,GAAG,SAAS,CAAA;AAC5B;;"}
+{"version":3,"file":"components-object.cjs","sources":["../../src/transform/components-object.ts"],"sourcesContent":["import { createTransformContext } from \"../api/transform-context.js\";\nimport { componentsType } from \"../application/transform/document/components.js\";\nimport { renameTakenAliases } from \"../application/transform/document/root-type-aliases.js\";\nimport type { IrType, IrTypeAliasDeclaration } from \"../domain/ir/nodes.js\";\nimport { isEnumSchema, singularizeComponentKind } from \"../domain/openapi/components-object.js\";\nimport type { ComponentsObject, GlobalContext } from \"../types.js\";\n\nexport { isEnumSchema };\n\n/** `requestBodies` → `requestBody`; other keys drop the final `s`. */\nexport const singularizeComponentKey = singularizeComponentKind;\n\n/**\n * Transform the ComponentsObject (4.8.7)\n * @see https://spec.openapis.org/oas/latest.html#components-object\n *\n * Ported to IR (ENGINEERING_PLAN Phase 5, step 6). Same name and parameters as the original;\n * returns IR (task 6.2). For the public API: the `components` type, then the root type aliases.\n */\nexport default function transformComponentsObject(\n  componentsObject: ComponentsObject,\n  ctx: GlobalContext,\n): (IrType | IrTypeAliasDeclaration)[] {\n  const { type, rootTypes } = componentsType(componentsObject, createTransformContext(ctx));\n  // No footer here: only the aliases the `root-type-numbering` fix keeps get numbers.\n  return [type, ...renameTakenAliases(rootTypes, [])];\n}\n"],"names":["componentsType","createTransformContext","renameTakenAliases"],"mappings":";;;;;;;;AAmBA,SAAwB,yBAAA,CACtB,kBACA,GAAA,EACqC;AACrC,EAAA,MAAM,EAAE,MAAM,SAAA,EAAU,GAAIA,0BAAe,gBAAA,EAAkBC,uCAAA,CAAuB,GAAG,CAAC,CAAA;AAExF,EAAA,OAAO,CAAC,IAAA,EAAM,GAAGC,mCAAmB,SAAA,EAAW,EAAE,CAAC,CAAA;AACpD;;"}

package/dist/transform/components-object.mjs

@@ -1,9 +1,10 @@
 import { createTransformContext } from '../api/transform-context.mjs';
 import { componentsType } from '../application/transform/document/components.mjs';
+import { renameTakenAliases } from '../application/transform/document/root-type-aliases.mjs';
 
 function transformComponentsObject(componentsObject, ctx) {
   const { type, rootTypes } = componentsType(componentsObject, createTransformContext(ctx));
-  return [type, ...rootTypes];
+  return [type, ...renameTakenAliases(rootTypes, [])];
 }
 
 export { transformComponentsObject as default };