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

package/dist/api/document-run.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"document-run.mjs","sources":["../../src/api/document-run.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { Config as RedoclyConfig } from \"@redocly/openapi-core\";\nimport { sourceEmptyError } from \"../adapters/redocly-loader/schema-load-errors.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\nimport type { RefAccess, SchemaLoader } from \"../application/ports/schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport {\n  ineffectiveFixNotices,\n  type OutputFix,\n  outputFixNamesOf,\n  resolveOutputFixes,\n} from \"../domain/output-fixes.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { GeneratorOptions, OpenAPI3, SchemaSource } from \"../types.js\";\nimport { processCwd } from \"./default-ports.js\";\nimport { warnDiscriminatorValueConflicts } from \"./discriminator-conflict-warnings.js\";\nimport { findDiscriminators } from \"./discriminator-scan.js\";\nimport { resolveDocumentRef } from \"./document-refs.js\";\nimport { warnIdenticalPathTemplates } from \"./path-template-warnings.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { warnUnsupportedFeatures } from \"./unsupported-feature-warnings.js\";\n\n/** The ports of one generator run, wired by the Node API or the CLI (ENGINEERING_PLAN 4.5). */\nexport interface GeneratorPorts {\n  readonly loader: SchemaLoader;\n  readonly logger: Logger;\n  /** The Redocly config the loader uses; the run's context exposes it as `ctx.redoc`. */\n  readonly redoc: RedoclyConfig;\n  /** A monotonic time in milliseconds, for debug durations. */\n  readonly now: () => number;\n}\n\n/** A validated, bundled document and the context of one generator run. */\nexport interface DocumentRun {\n  readonly schema: OpenAPI3;\n  readonly ctx: RunContext;\n}\n\n/** The context fields that are user flags, with the original defaults. */\ntype ContextFlags = Omit<\n  RunContext,\n  | \"discriminators\"\n  | \"injectFooter\"\n  | \"redoc\"\n  | \"resolve\"\n  | \"runFooter\"\n  | \"legacyCallbackWarnings\"\n  | \"logger\"\n  | \"fix\"\n>;\n\n/**\n * The directory that relative `$ref`s of an inline source resolve against, as a URL that ends in\n * a slash. A path is resolved and encoded (`#`, `%`, spaces); a URL without the slash gets one.\n */\nfunction sourceCwd(options: GeneratorOptions): URL {\n  const { cwd } = options;\n  if (cwd instanceof URL) {\n    return cwd.pathname.endsWith(\"/\") ? cwd : new URL(`${cwd.pathname}/`, cwd);\n  }\n  const directory = path.resolve(cwd === undefined ? processCwd() : cwd.toString());\n  return pathToFileURL(path.join(directory, path.sep));\n}\n\n/** The `$ref` limits of the options; a relative local root resolves against the cwd. */\nfunction refAccessOf(options: GeneratorOptions, cwd: URL): RefAccess {\n  const { localRefRoot, remoteRefHosts } = options;\n  const localRoot =\n    typeof localRefRoot === \"string\"\n      ? pathToFileURL(path.resolve(fileURLToPath(cwd), localRefRoot))\n      : localRefRoot;\n  return {\n    ...(localRoot === undefined ? {} : { localRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteHosts: remoteRefHosts }),\n  };\n}\n\nfunction callbackOptions(options: GeneratorOptions) {\n  return {\n    irCallbacks: options.irCallbacks === true,\n    postTransform: typeof options.postTransform === \"function\" ? options.postTransform : undefined,\n    transform: typeof options.transform === \"function\" ? options.transform : undefined,\n    transformProperty:\n      typeof options.transformProperty === \"function\" ? options.transformProperty : undefined,\n  };\n}\n\nfunction contextFlags(options: GeneratorOptions): ContextFlags {\n  return {\n    additionalProperties: options.additionalProperties ?? false,\n    alphabetize: options.alphabetize ?? false,\n    arrayLength: options.arrayLength ?? false,\n    binaryAsBlob: options.binaryAsBlob ?? false,\n    defaultNonNullable: options.defaultNonNullable ?? true,\n    emptyObjectsUnknown: options.emptyObjectsUnknown ?? false,\n    enum: options.enum ?? false,\n    enumValues: options.enumValues ?? false,\n    conditionalEnums: options.conditionalEnums ?? false,\n    dedupeEnums: options.dedupeEnums ?? false,\n    excludeDeprecated: options.excludeDeprecated ?? false,\n    exportType: options.exportType ?? false,\n    immutable: options.immutable ?? false,\n    rootTypes: options.rootTypes ?? false,\n    rootTypesNoSchemaPrefix: options.rootTypesNoSchemaPrefix ?? false,\n    rootTypesKeepCasing: options.rootTypesKeepCasing ?? false,\n    pathParamsAsTypes: options.pathParamsAsTypes ?? false,\n    propertiesRequiredByDefault: options.propertiesRequiredByDefault ?? false,\n    silent: options.silent ?? false,\n    ...(options.inject === undefined ? {} : { inject: options.inject }),\n    makePathsEnum: options.makePathsEnum ?? false,\n    generatePathParams: options.generatePathParams ?? false,\n    readWriteMarkers: options.readWriteMarkers ?? false,\n    ...callbackOptions(options),\n  };\n}\n\n/**\n * The fixes of the options, `all` expanded; fails with `OPTION_FIX_UNKNOWN` for another name.\n * A fix named without the option it needs is reported, since it changes nothing.\n */\nfunction outputFixesOf(options: GeneratorOptions, logger: Logger): readonly OutputFix[] {\n  const names = outputFixNamesOf(options.fix ?? []);\n  for (const notice of ineffectiveFixNotices(names, (option) => options[option] === true)) {\n    logger.warn(warningText(notice, WARNING_CODES.FIX_NEEDS_OPTION));\n  }\n  return [...resolveOutputFixes(names)];\n}\n\n/** The warnings about the loaded document itself, before it is transformed. */\nfunction warnAboutDocument(schema: OpenAPI3, fix: readonly OutputFix[], logger: Logger): void {\n  withStackOverflowReported(\"transform\", () => warnUnsupportedFeatures(schema, logger));\n  withStackOverflowReported(\"transform\", () =>\n    warnDiscriminatorValueConflicts(schema, fix, logger),\n  );\n  warnIdenticalPathTemplates(schema, logger);\n}\n\n/**\n * Load the source through the ports, then build the run's context from the options. The fix names\n * are checked first, so a typo fails before the document is read.\n */\nexport async function createDocumentRun(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<DocumentRun> {\n  if (!source) {\n    throw sourceEmptyError(\"Empty schema. Please specify a URL, file path, or Redocly Config\");\n  }\n  const { logger } = ports;\n  const fix = outputFixesOf(options, logger);\n  const silent = options.silent ?? false;\n  const cwd = sourceCwd(options);\n  const schema = await ports.loader.load({\n    source,\n    cwd,\n    shouldLint: options.lint ?? true,\n    refAccess: refAccessOf(options, cwd),\n  });\n  warnAboutDocument(schema, fix, logger);\n  const ctx: RunContext = {\n    ...contextFlags(options),\n    fix,\n    // The scan walks every schema before the transform does, so on a larger stack, where loading\n    // passed, it is the first step to run out.\n    discriminators: withStackOverflowReported(\"transform\", () =>\n      findDiscriminators(schema, {\n        silent,\n        logger,\n        fixes: new Set(fix),\n      }),\n    ),\n    injectFooter: [],\n    redoc: ports.redoc,\n    resolve: ($ref) => resolveDocumentRef(schema, $ref, { silent, logger }),\n    logger,\n  };\n  return { schema, ctx };\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AAwDA,SAAS,UAAU,OAAA,EAAgC;AACjD,EAAA,MAAM,EAAE,KAAI,GAAI,OAAA;AAChB,EAAA,IAAI,eAAe,GAAA,EAAK;AACtB,IAAA,OAAO,GAAA,CAAI,QAAA,CAAS,QAAA,CAAS,GAAG,CAAA,GAAI,GAAA,GAAM,IAAI,GAAA,CAAI,CAAA,EAAG,GAAA,CAAI,QAAQ,CAAA,CAAA,CAAA,EAAK,GAAG,CAAA;AAAA,EAC3E;AACA,EAAA,MAAM,SAAA,GAAY,KAAK,OAAA,CAAQ,GAAA,KAAQ,SAAY,UAAA,EAAW,GAAI,GAAA,CAAI,QAAA,EAAU,CAAA;AAChF,EAAA,OAAO,cAAc,IAAA,CAAK,IAAA,CAAK,SAAA,EAAW,IAAA,CAAK,GAAG,CAAC,CAAA;AACrD;AAGA,SAAS,WAAA,CAAY,SAA2B,GAAA,EAAqB;AACnE,EAAA,MAAM,EAAE,YAAA,EAAc,cAAA,EAAe,GAAI,OAAA;AACzC,EAAA,MAAM,SAAA,GACJ,OAAO,YAAA,KAAiB,QAAA,GACpB,aAAA,CAAc,IAAA,CAAK,OAAA,CAAQ,aAAA,CAAc,GAAG,CAAA,EAAG,YAAY,CAAC,CAAA,GAC5D,YAAA;AACN,EAAA,OAAO;AAAA,IACL,GAAI,SAAA,KAAc,MAAA,GAAY,EAAC,GAAI,EAAE,SAAA,EAAU;AAAA,IAC/C,GAAI,cAAA,KAAmB,MAAA,GAAY,EAAC,GAAI,EAAE,aAAa,cAAA;AAAe,GACxE;AACF;AAEA,SAAS,gBAAgB,OAAA,EAA2B;AAClD,EAAA,OAAO;AAAA,IACL,WAAA,EAAa,QAAQ,WAAA,KAAgB,IAAA;AAAA,IACrC,eAAe,OAAO,OAAA,CAAQ,aAAA,KAAkB,UAAA,GAAa,QAAQ,aAAA,GAAgB,MAAA;AAAA,IACrF,WAAW,OAAO,OAAA,CAAQ,SAAA,KAAc,UAAA,GAAa,QAAQ,SAAA,GAAY,MAAA;AAAA,IACzE,mBACE,OAAO,OAAA,CAAQ,iBAAA,KAAsB,UAAA,GAAa,QAAQ,iBAAA,GAAoB;AAAA,GAClF;AACF;AAEA,SAAS,aAAa,OAAA,EAAyC;AAC7D,EAAA,OAAO;AAAA,IACL,oBAAA,EAAsB,QAAQ,oBAAA,IAAwB,KAAA;AAAA,IACtD,WAAA,EAAa,QAAQ,WAAA,IAAe,KAAA;AAAA,IACpC,WAAA,EAAa,QAAQ,WAAA,IAAe,KAAA;AAAA,IACpC,YAAA,EAAc,QAAQ,YAAA,IAAgB,KAAA;AAAA,IACtC,kBAAA,EAAoB,QAAQ,kBAAA,IAAsB,IAAA;AAAA,IAClD,mBAAA,EAAqB,QAAQ,mBAAA,IAAuB,KAAA;AAAA,IACpD,IAAA,EAAM,QAAQ,IAAA,IAAQ,KAAA;AAAA,IACtB,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,gBAAA,EAAkB,QAAQ,gBAAA,IAAoB,KAAA;AAAA,IAC9C,WAAA,EAAa,QAAQ,WAAA,IAAe,KAAA;AAAA,IACpC,iBAAA,EAAmB,QAAQ,iBAAA,IAAqB,KAAA;AAAA,IAChD,UAAA,EAAY,QAAQ,UAAA,IAAc,KAAA;AAAA,IAClC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,SAAA,EAAW,QAAQ,SAAA,IAAa,KAAA;AAAA,IAChC,uBAAA,EAAyB,QAAQ,uBAAA,IAA2B,KAAA;AAAA,IAC5D,mBAAA,EAAqB,QAAQ,mBAAA,IAAuB,KAAA;AAAA,IACpD,iBAAA,EAAmB,QAAQ,iBAAA,IAAqB,KAAA;AAAA,IAChD,2BAAA,EAA6B,QAAQ,2BAAA,IAA+B,KAAA;AAAA,IACpE,MAAA,EAAQ,QAAQ,MAAA,IAAU,KAAA;AAAA,IAC1B,GAAI,QAAQ,MAAA,KAAW,MAAA,GAAY,EAAC,GAAI,EAAE,MAAA,EAAQ,OAAA,CAAQ,MAAA,EAAO;AAAA,IACjE,aAAA,EAAe,QAAQ,aAAA,IAAiB,KAAA;AAAA,IACxC,kBAAA,EAAoB,QAAQ,kBAAA,IAAsB,KAAA;AAAA,IAClD,gBAAA,EAAkB,QAAQ,gBAAA,IAAoB,KAAA;AAAA,IAC9C,GAAG,gBAAgB,OAAO;AAAA,GAC5B;AACF;AAMA,SAAS,aAAA,CAAc,SAA2B,MAAA,EAAsC;AACtF,EAAA,MAAM,KAAA,GAAQ,gBAAA,CAAiB,OAAA,CAAQ,GAAA,IAAO,EAAE,CAAA;AAChD,EAAA,KAAA,MAAW,MAAA,IAAU,sBAAsB,KAAA,EAAO,CAAC,WAAW,OAAA,CAAQ,MAAM,CAAA,KAAM,IAAI,CAAA,EAAG;AACvF,IAAA,MAAA,CAAO,IAAA,CAAK,WAAA,CAAY,MAAA,EAAQ,aAAA,CAAc,gBAAgB,CAAC,CAAA;AAAA,EACjE;AACA,EAAA,OAAO,CAAC,GAAG,kBAAA,CAAmB,KAAK,CAAC,CAAA;AACtC;AAGA,SAAS,iBAAA,CAAkB,MAAA,EAAkB,GAAA,EAA2B,MAAA,EAAsB;AAC5F,EAAA,yBAAA,CAA0B,WAAA,EAAa,MAAM,uBAAA,CAAwB,MAAA,EAAQ,MAAM,CAAC,CAAA;AACpF,EAAA,yBAAA;AAAA,IAA0B,WAAA;AAAA,IAAa,MACrC,+BAAA,CAAgC,MAAA,EAAQ,GAAA,EAAK,MAAM;AAAA,GACrD;AACA,EAAA,0BAAA,CAA2B,QAAQ,MAAM,CAAA;AAC3C;AAMA,eAAsB,iBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EACsB;AACtB,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,iBAAiB,kEAAkE,CAAA;AAAA,EAC3F;AACA,EAAA,MAAM,EAAE,QAAO,GAAI,KAAA;AACnB,EAAA,MAAM,GAAA,GAAM,aAAA,CAAc,OAAA,EAAS,MAAM,CAAA;AACzC,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAA,IAAU,KAAA;AACjC,EAAA,MAAM,GAAA,GAAM,UAAU,OAAO,CAAA;AAC7B,EAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,MAAA,CAAO,IAAA,CAAK;AAAA,IACrC,MAAA;AAAA,IACA,GAAA;AAAA,IACA,UAAA,EAAY,QAAQ,IAAA,IAAQ,IAAA;AAAA,IAC5B,SAAA,EAAW,WAAA,CAAY,OAAA,EAAS,GAAG;AAAA,GACpC,CAAA;AACD,EAAA,iBAAA,CAAkB,MAAA,EAAQ,KAAK,MAAM,CAAA;AACrC,EAAA,MAAM,GAAA,GAAkB;AAAA,IACtB,GAAG,aAAa,OAAO,CAAA;AAAA,IACvB,GAAA;AAAA;AAAA;AAAA,IAGA,cAAA,EAAgB,yBAAA;AAAA,MAA0B,WAAA;AAAA,MAAa,MACrD,mBAAmB,MAAA,EAAQ;AAAA,QACzB,MAAA;AAAA,QACA,MAAA;AAAA,QACA,KAAA,EAAO,IAAI,GAAA,CAAI,GAAG;AAAA,OACnB;AAAA,KACH;AAAA,IACA,cAAc,EAAC;AAAA,IACf,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,OAAA,EAAS,CAAC,IAAA,KAAS,kBAAA,CAAmB,QAAQ,IAAA,EAAM,EAAE,MAAA,EAAQ,MAAA,EAAQ,CAAA;AAAA,IACtE;AAAA,GACF;AACA,EAAA,OAAO,EAAE,QAAQ,GAAA,EAAI;AACvB;;"}
+{"version":3,"file":"document-run.mjs","sources":["../../src/api/document-run.ts"],"sourcesContent":["import path from \"node:path\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport type { Config as RedoclyConfig } from \"@redocly/openapi-core\";\nimport { sourceEmptyError } from \"../adapters/redocly-loader/schema-load-errors.js\";\nimport type { DeprecationReporter } from \"../application/ports/deprecation-reporter.js\";\nimport type { Logger } from \"../application/ports/logger.js\";\nimport type { RefAccess, SchemaLoader } from \"../application/ports/schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport {\n  ineffectiveFixNotices,\n  type OutputFix,\n  outputFixNamesOf,\n  resolveOutputFixes,\n} from \"../domain/output-fixes.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { GeneratorOptions, OpenAPI3, SchemaSource } from \"../types.js\";\nimport { processCwd } from \"./default-ports.js\";\nimport { warnDiscriminatorValueConflicts } from \"./discriminator-conflict-warnings.js\";\nimport { findDiscriminators } from \"./discriminator-scan.js\";\nimport { resolveDocumentRef } from \"./document-refs.js\";\nimport { warnIdenticalPathTemplates } from \"./path-template-warnings.js\";\nimport type { RunContext } from \"./run-context.js\";\nimport { warnUnsupportedFeatures } from \"./unsupported-feature-warnings.js\";\n\n/** The ports of one generator run, wired by the Node API or the CLI (ENGINEERING_PLAN 4.5). */\nexport interface GeneratorPorts {\n  readonly loader: SchemaLoader;\n  readonly logger: Logger;\n  /** Where the run reports the deprecated callback forms (ADR-004). */\n  readonly deprecations: DeprecationReporter;\n  /** The Redocly config the loader uses; the run's context exposes it as `ctx.redoc`. */\n  readonly redoc: RedoclyConfig;\n  /** A monotonic time in milliseconds, for debug durations. */\n  readonly now: () => number;\n}\n\n/** A validated, bundled document, the local files it was read from, and the run's context. */\nexport interface DocumentRun {\n  readonly schema: OpenAPI3;\n  readonly localFiles: readonly URL[];\n  readonly ctx: RunContext;\n}\n\n/** The context fields that are user flags, with the original defaults. */\ntype ContextFlags = Omit<\n  RunContext,\n  | \"discriminators\"\n  | \"injectFooter\"\n  | \"redoc\"\n  | \"resolve\"\n  | \"runFooter\"\n  | \"legacyCallbackWarnings\"\n  | \"logger\"\n  | \"deprecations\"\n  | \"fix\"\n>;\n\n/**\n * The directory that relative `$ref`s of an inline source resolve against, as a URL that ends in\n * a slash. A path is resolved and encoded (`#`, `%`, spaces); a URL without the slash gets one.\n */\nfunction sourceCwd(options: GeneratorOptions): URL {\n  const { cwd } = options;\n  if (cwd instanceof URL) {\n    return cwd.pathname.endsWith(\"/\") ? cwd : new URL(`${cwd.pathname}/`, cwd);\n  }\n  const directory = path.resolve(cwd === undefined ? processCwd() : cwd.toString());\n  return pathToFileURL(path.join(directory, path.sep));\n}\n\n/** The `$ref` limits of the options; a relative local root resolves against the cwd. */\nfunction refAccessOf(options: GeneratorOptions, cwd: URL): RefAccess {\n  const { localRefRoot, remoteRefHosts } = options;\n  const localRoot =\n    typeof localRefRoot === \"string\"\n      ? pathToFileURL(path.resolve(fileURLToPath(cwd), localRefRoot))\n      : localRefRoot;\n  return {\n    ...(localRoot === undefined ? {} : { localRoot }),\n    ...(remoteRefHosts === undefined ? {} : { remoteHosts: remoteRefHosts }),\n  };\n}\n\nfunction callbackOptions(options: GeneratorOptions) {\n  return {\n    irCallbacks: options.irCallbacks === true,\n    postTransform: typeof options.postTransform === \"function\" ? options.postTransform : undefined,\n    transform: typeof options.transform === \"function\" ? options.transform : undefined,\n    transformProperty:\n      typeof options.transformProperty === \"function\" ? options.transformProperty : undefined,\n  };\n}\n\nfunction contextFlags(options: GeneratorOptions): ContextFlags {\n  return {\n    additionalProperties: options.additionalProperties ?? false,\n    alphabetize: options.alphabetize ?? false,\n    arrayLength: options.arrayLength ?? false,\n    binaryAsBlob: options.binaryAsBlob ?? false,\n    defaultNonNullable: options.defaultNonNullable ?? true,\n    emptyObjectsUnknown: options.emptyObjectsUnknown ?? false,\n    enum: options.enum ?? false,\n    enumValues: options.enumValues ?? false,\n    conditionalEnums: options.conditionalEnums ?? false,\n    dedupeEnums: options.dedupeEnums ?? false,\n    excludeDeprecated: options.excludeDeprecated ?? false,\n    exportType: options.exportType ?? false,\n    immutable: options.immutable ?? false,\n    rootTypes: options.rootTypes ?? false,\n    rootTypesNoSchemaPrefix: options.rootTypesNoSchemaPrefix ?? false,\n    rootTypesKeepCasing: options.rootTypesKeepCasing ?? false,\n    pathParamsAsTypes: options.pathParamsAsTypes ?? false,\n    propertiesRequiredByDefault: options.propertiesRequiredByDefault ?? false,\n    silent: options.silent ?? false,\n    ...(options.inject === undefined ? {} : { inject: options.inject }),\n    makePathsEnum: options.makePathsEnum ?? false,\n    generatePathParams: options.generatePathParams ?? false,\n    readWriteMarkers: options.readWriteMarkers ?? false,\n    ...callbackOptions(options),\n  };\n}\n\n/**\n * The fixes of the options, `all` expanded; fails with `OPTION_FIX_UNKNOWN` for another name.\n * A fix named without the option it needs is reported, since it changes nothing.\n */\nfunction outputFixesOf(options: GeneratorOptions, logger: Logger): readonly OutputFix[] {\n  const names = outputFixNamesOf(options.fix ?? []);\n  for (const notice of ineffectiveFixNotices(names, (option) => options[option] === true)) {\n    logger.warn(warningText(notice, WARNING_CODES.FIX_NEEDS_OPTION));\n  }\n  return [...resolveOutputFixes(names)];\n}\n\n/** The warnings about the loaded document itself, before it is transformed. */\nfunction warnAboutDocument(schema: OpenAPI3, fix: readonly OutputFix[], logger: Logger): void {\n  withStackOverflowReported(\"transform\", () => warnUnsupportedFeatures(schema, logger));\n  withStackOverflowReported(\"transform\", () =>\n    warnDiscriminatorValueConflicts(schema, fix, logger),\n  );\n  warnIdenticalPathTemplates(schema, logger);\n}\n\n/**\n * Load the source through the ports, then build the run's context from the options. The fix names\n * are checked first, so a typo fails before the document is read.\n */\nexport async function createDocumentRun(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<DocumentRun> {\n  if (!source) {\n    throw sourceEmptyError(\"Empty schema. Please specify a URL, file path, or Redocly Config\");\n  }\n  const { logger } = ports;\n  const fix = outputFixesOf(options, logger);\n  const silent = options.silent ?? false;\n  const cwd = sourceCwd(options);\n  const { document: schema, localFiles } = await ports.loader.load({\n    source,\n    cwd,\n    shouldLint: options.lint ?? true,\n    refAccess: refAccessOf(options, cwd),\n  });\n  warnAboutDocument(schema, fix, logger);\n  const ctx: RunContext = {\n    ...contextFlags(options),\n    fix,\n    // The scan walks every schema before the transform does, so on a larger stack, where loading\n    // passed, it is the first step to run out.\n    discriminators: withStackOverflowReported(\"transform\", () =>\n      findDiscriminators(schema, {\n        silent,\n        logger,\n        fixes: new Set(fix),\n      }),\n    ),\n    injectFooter: [],\n    redoc: ports.redoc,\n    resolve: ($ref) => resolveDocumentRef(schema, $ref, { silent, logger }),\n    logger,\n    deprecations: ports.deprecations,\n  };\n  return { schema, localFiles, ctx };\n}\n"],"names":[],"mappings":"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"}

package/dist/api/legacy-callback-warning.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const warnings = require('../domain/warnings.cjs');
+const deprecations = require('../domain/deprecations.cjs');
 const defaultPorts = require('./default-ports.cjs');
 
 const IR_CALLBACKS_GUIDE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks";
@@ -9,6 +9,11 @@ const USES = {
   postTransform: "`postTransform` receives TypeScript nodes",
   transformProperty: "`transformProperty` receives TypeScript nodes"
 };
+const CODES = {
+  transform: deprecations.DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM,
+  postTransform: deprecations.DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM,
+  transformProperty: deprecations.DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY
+};
 function message(name) {
   return `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`;
 }
@@ -18,9 +23,7 @@ function warnLegacyCallback(ctx, name) {
     return;
   }
   ctx.legacyCallbackWarnings.add(name);
-  (ctx.logger ?? defaultPorts.defaultLogger(ctx.silent)).warn(
-    warnings.warningText(message(name), warnings.WARNING_CODES.LEGACY_CALLBACK_DEPRECATED)
-  );
+  (ctx.deprecations ?? defaultPorts.defaultDeprecationReporter()).report(CODES[name], message(name));
 }
 
 exports.IR_CALLBACKS_GUIDE_URL = IR_CALLBACKS_GUIDE_URL;

package/dist/api/legacy-callback-warning.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-callback-warning.cjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\nimport type { RunContext } from \"./run-context.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/** Warn once per run and callback; `silent` runs record the use but print nothing. */\nexport function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.logger ?? defaultLogger(ctx.silent)).warn(\n    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED),\n  );\n}\n"],"names":["defaultLogger","warningText","WARNING_CODES"],"mappings":";;;;;AAMO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAGO,SAAS,kBAAA,CAAmB,KAAiB,IAAA,EAAgC;AAClF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,MAAA,IAAUA,0BAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA;AAAA,IACxCC,oBAAA,CAAY,OAAA,CAAQ,IAAI,CAAA,EAAGC,uBAAc,0BAA0B;AAAA,GACrE;AACF;;;"}
+{"version":3,"file":"legacy-callback-warning.cjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import { DEPRECATION_CODES, type DeprecationCode } from \"../domain/deprecations.js\";\nimport type { LegacyCallbackName } from \"../types.js\";\nimport { defaultDeprecationReporter } from \"./default-ports.js\";\nimport type { RunContext } from \"./run-context.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nconst CODES: Readonly<Record<LegacyCallbackName, DeprecationCode>> = {\n  transform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM,\n  postTransform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM,\n  transformProperty: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY,\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/**\n * Report a deprecated callback form once per run and callback, as a deprecation (not through the\n * logger, so `silent` does not hide it). The Node.js reporter shows each code once per process.\n */\nexport function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.deprecations ?? defaultDeprecationReporter()).report(CODES[name], message(name));\n}\n"],"names":["DEPRECATION_CODES","defaultDeprecationReporter"],"mappings":";;;;;AAMO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,MAAM,KAAA,GAA+D;AAAA,EACnE,WAAWA,8BAAA,CAAkB,iCAAA;AAAA,EAC7B,eAAeA,8BAAA,CAAkB,sCAAA;AAAA,EACjC,mBAAmBA,8BAAA,CAAkB;AACvC,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAMO,SAAS,kBAAA,CAAmB,KAAiB,IAAA,EAAgC;AAClF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,YAAA,IAAgBC,uCAAA,EAA2B,EAAG,MAAA,CAAO,MAAM,IAAI,CAAA,EAAG,OAAA,CAAQ,IAAI,CAAC,CAAA;AACtF;;;"}

package/dist/api/legacy-callback-warning.mjs

@@ -1,5 +1,5 @@
-import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
-import { defaultLogger } from './default-ports.mjs';
+import { DEPRECATION_CODES } from '../domain/deprecations.mjs';
+import { defaultDeprecationReporter } from './default-ports.mjs';
 
 const IR_CALLBACKS_GUIDE_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks";
 const USES = {
@@ -7,6 +7,11 @@ const USES = {
   postTransform: "`postTransform` receives TypeScript nodes",
   transformProperty: "`transformProperty` receives TypeScript nodes"
 };
+const CODES = {
+  transform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM,
+  postTransform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM,
+  transformProperty: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY
+};
 function message(name) {
   return `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`;
 }
@@ -16,9 +21,7 @@ function warnLegacyCallback(ctx, name) {
     return;
   }
   ctx.legacyCallbackWarnings.add(name);
-  (ctx.logger ?? defaultLogger(ctx.silent)).warn(
-    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED)
-  );
+  (ctx.deprecations ?? defaultDeprecationReporter()).report(CODES[name], message(name));
 }
 
 export { IR_CALLBACKS_GUIDE_URL, warnLegacyCallback };

package/dist/api/legacy-callback-warning.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-callback-warning.mjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import { WARNING_CODES, warningText } from \"../domain/warnings.js\";\nimport type { LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.js\";\nimport type { RunContext } from \"./run-context.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/** Warn once per run and callback; `silent` runs record the use but print nothing. */\nexport function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.logger ?? defaultLogger(ctx.silent)).warn(\n    warningText(message(name), WARNING_CODES.LEGACY_CALLBACK_DEPRECATED),\n  );\n}\n"],"names":[],"mappings":";;;AAMO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAGO,SAAS,kBAAA,CAAmB,KAAiB,IAAA,EAAgC;AAClF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,MAAA,IAAU,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA;AAAA,IACxC,WAAA,CAAY,OAAA,CAAQ,IAAI,CAAA,EAAG,cAAc,0BAA0B;AAAA,GACrE;AACF;;"}
+{"version":3,"file":"legacy-callback-warning.mjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import { DEPRECATION_CODES, type DeprecationCode } from \"../domain/deprecations.js\";\nimport type { LegacyCallbackName } from \"../types.js\";\nimport { defaultDeprecationReporter } from \"./default-ports.js\";\nimport type { RunContext } from \"./run-context.js\";\n\n/** Where the IR callbacks are documented; the warning points users there. */\nexport const IR_CALLBACKS_GUIDE_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/node.md#ir-callbacks\";\n\nconst USES: Readonly<Record<LegacyCallbackName, string>> = {\n  transform: \"`transform` returned a TypeScript node\",\n  postTransform: \"`postTransform` receives TypeScript nodes\",\n  transformProperty: \"`transformProperty` receives TypeScript nodes\",\n};\n\nconst CODES: Readonly<Record<LegacyCallbackName, DeprecationCode>> = {\n  transform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM,\n  postTransform: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_POST_TRANSFORM,\n  transformProperty: DEPRECATION_CODES.OPENAPI_TYPESAFE_DEP_TS_TRANSFORM_PROPERTY,\n};\n\nfunction message(name: LegacyCallbackName): string {\n  return (\n    `${USES[name]}. This form works in 1.x through the TypeScript bridge and is removed in 2.0. ` +\n    `Use irCallbacks: true and return IR or type text instead: ${IR_CALLBACKS_GUIDE_URL}`\n  );\n}\n\n/**\n * Report a deprecated callback form once per run and callback, as a deprecation (not through the\n * logger, so `silent` does not hide it). The Node.js reporter shows each code once per process.\n */\nexport function warnLegacyCallback(ctx: RunContext, name: LegacyCallbackName): void {\n  ctx.legacyCallbackWarnings ??= new Set();\n  if (ctx.legacyCallbackWarnings.has(name)) {\n    return;\n  }\n  ctx.legacyCallbackWarnings.add(name);\n  (ctx.deprecations ?? defaultDeprecationReporter()).report(CODES[name], message(name));\n}\n"],"names":[],"mappings":";;;AAMO,MAAM,sBAAA,GACX;AAEF,MAAM,IAAA,GAAqD;AAAA,EACzD,SAAA,EAAW,wCAAA;AAAA,EACX,aAAA,EAAe,2CAAA;AAAA,EACf,iBAAA,EAAmB;AACrB,CAAA;AAEA,MAAM,KAAA,GAA+D;AAAA,EACnE,WAAW,iBAAA,CAAkB,iCAAA;AAAA,EAC7B,eAAe,iBAAA,CAAkB,sCAAA;AAAA,EACjC,mBAAmB,iBAAA,CAAkB;AACvC,CAAA;AAEA,SAAS,QAAQ,IAAA,EAAkC;AACjD,EAAA,OACE,CAAA,EAAG,IAAA,CAAK,IAAI,CAAC,2IACgD,sBAAsB,CAAA,CAAA;AAEvF;AAMO,SAAS,kBAAA,CAAmB,KAAiB,IAAA,EAAgC;AAClF,EAAA,GAAA,CAAI,sBAAA,yBAA+B,GAAA,EAAI;AACvC,EAAA,IAAI,GAAA,CAAI,sBAAA,CAAuB,GAAA,CAAI,IAAI,CAAA,EAAG;AACxC,IAAA;AAAA,EACF;AACA,EAAA,GAAA,CAAI,sBAAA,CAAuB,IAAI,IAAI,CAAA;AACnC,EAAA,CAAC,GAAA,CAAI,YAAA,IAAgB,0BAAA,EAA2B,EAAG,MAAA,CAAO,MAAM,IAAI,CAAA,EAAG,OAAA,CAAQ,IAAI,CAAC,CAAA;AACtF;;"}

package/dist/api/legacy-utils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-utils.cjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/** Create a $ref pointer (even from other $refs) */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: unknown,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["terminalSupportsColor","colors","discriminatorProperty","createDomainRef","defaultLogger","formatDuration","resolveDocumentRef","walkDocument"],"mappings":";;;;;;;;;;;;;AAiBA,IAAI,CAACA,oCAAsB,EAAG;AAC5B,EAAAC,eAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAIA;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAOC,2CAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAGO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOC,sBAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAAC,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAAA,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAWC,6BAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAOC,+BAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAAC,yBAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAAH,0BAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;;;;;;;;;;"}
+{"version":3,"file":"legacy-utils.cjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/**\n * Create a $ref pointer (even from other $refs). A part that contains `#/` is read as a `$ref`\n * and contributes its decoded segments, so it throws URIError for a malformed percent escape; any\n * other part is one segment. To append raw document keys, escape each one instead.\n */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: unknown,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["terminalSupportsColor","colors","discriminatorProperty","createDomainRef","defaultLogger","formatDuration","resolveDocumentRef","walkDocument"],"mappings":";;;;;;;;;;;;;AAiBA,IAAI,CAACA,oCAAsB,EAAG;AAC5B,EAAAC,eAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAIA;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAOC,2CAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAOO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOC,sBAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAAC,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAAA,0BAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAWC,6BAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAOC,+BAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAAC,yBAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAAH,0BAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;;;;;;;;;;"}

package/dist/api/legacy-utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"legacy-utils.mjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/** Create a $ref pointer (even from other $refs) */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: unknown,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["createDomainRef"],"mappings":";;;;;;;AAiBA,IAAI,CAAC,uBAAsB,EAAG;AAC5B,EAAA,MAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAI;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAO,qBAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAGO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOA,YAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAW,cAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAA,YAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAA,aAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;"}
+{"version":3,"file":"legacy-utils.mjs","sources":["../../src/api/legacy-utils.ts"],"sourcesContent":["import colors from \"ansi-colors\";\nimport { formatDuration } from \"../adapters/terminal-logger/terminal-logger.js\";\nimport type { DebugGroup } from \"../application/ports/logger.js\";\nimport { discriminatorProperty } from \"../application/transform/schema/discriminator-property.js\";\nimport type { IrPropertySignature } from \"../domain/ir/nodes.js\";\nimport { createRef as createDomainRef } from \"../domain/openapi/json-pointer.js\";\nimport type { DiscriminatorObject } from \"../types.js\";\nimport { defaultLogger, terminalSupportsColor } from \"./default-ports.js\";\nimport { type ResolveRefOptions, resolveDocumentRef, walkDocument } from \"./document-refs.js\";\n\n/**\n * The original's exported utilities, kept for 1.x (ADR-004, decision 9). The generator itself\n * logs through the Logger port; `debug`, `warn` and `error` here write through the default one.\n */\n\n// The exported `c` is the shared ansi-colors instance, switched off at import when the terminal has\n// no colors, as the original did. The generator's own logger uses a separate instance.\nif (!terminalSupportsColor()) {\n  colors.enabled = false;\n}\n\n/**\n * The shared ansi-colors instance.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9). Use a color library directly.\n */\nexport const c = colors;\n\n/**\n * The discriminator property of a schema at `path`, typed as its discriminator value. Returns IR\n * (task 6.2), like the exported transformers.\n */\nexport function createDiscriminatorProperty(\n  discriminator: DiscriminatorObject,\n  { path, readonly = false }: { path: string; readonly?: boolean },\n): IrPropertySignature {\n  return discriminatorProperty(discriminator, path, readonly);\n}\n\n/**\n * Create a $ref pointer (even from other $refs). A part that contains `#/` is read as a `$ref`\n * and contributes its decoded segments, so it throws URIError for a malformed percent escape; any\n * other part is one segment. To append raw document keys, escape each one instead.\n */\nexport function createRef(parts: (number | string | undefined | null)[]): string {\n  return createDomainRef(parts);\n}\n\n/**\n * Print debug message (cribbed from the `debug` package, but without all the bells & whistles\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function debug(msg: string, group?: string, time?: number) {\n  // Any group name was accepted; one the logger does not know prints in white, as before.\n  defaultLogger(false).debug(msg, group as DebugGroup | undefined, time);\n}\n\n/**\n * Print error message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function error(msg: string) {\n  defaultLogger(false).error(msg);\n}\n\n/** Format a performance log in a friendly format */\nexport function formatTime(t: number) {\n  return typeof t === \"number\" ? formatDuration(t) : t;\n}\n\n/** Call Object.entries() and optionally sort */\nexport function getEntries<T>(\n  obj: ArrayLike<T> | Record<string, T>,\n  options?: {\n    alphabetize?: boolean;\n    excludeDeprecated?: boolean;\n  },\n) {\n  let entries = Object.entries(obj);\n  if (options?.alphabetize) {\n    entries.sort(([a], [b]) => a.localeCompare(b, \"en-us\", { numeric: true }));\n  }\n  if (options?.excludeDeprecated) {\n    entries = entries.filter(\n      ([, v]) => !(v && typeof v === \"object\" && \"deprecated\" in v && v.deprecated),\n    );\n  }\n  return entries;\n}\n\nexport type { ResolveRefOptions } from \"./document-refs.js\";\n\n/**\n * resolve a $ref in a schema\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function resolveRef<T>(\n  schema: unknown,\n  $ref: string,\n  options: ResolveRefOptions,\n): T | undefined {\n  return resolveDocumentRef<T>(schema, $ref, options);\n}\n\n/**\n * Walk through any JSON-serializable (i.e. non-circular) object\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function walk(\n  obj: unknown,\n  cb: (value: Record<string, unknown>, path: (string | number)[]) => void,\n  path: (string | number)[] = [],\n): void {\n  walkDocument(obj, cb, path);\n}\n\n/**\n * Print warning message\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 9).\n */\nexport function warn(msg: string, silent = false) {\n  defaultLogger(silent).warn(msg);\n}\n"],"names":["createDomainRef"],"mappings":";;;;;;;AAiBA,IAAI,CAAC,uBAAsB,EAAG;AAC5B,EAAA,MAAA,CAAO,OAAA,GAAU,KAAA;AACnB;AAMO,MAAM,CAAA,GAAI;AAMV,SAAS,4BACd,aAAA,EACA,EAAE,IAAA,EAAM,QAAA,GAAW,OAAM,EACJ;AACrB,EAAA,OAAO,qBAAA,CAAsB,aAAA,EAAe,IAAA,EAAM,QAAQ,CAAA;AAC5D;AAOO,SAAS,UAAU,KAAA,EAAuD;AAC/E,EAAA,OAAOA,YAAgB,KAAK,CAAA;AAC9B;AAMO,SAAS,KAAA,CAAM,GAAA,EAAa,KAAA,EAAgB,IAAA,EAAe;AAEhE,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAA,EAAK,OAAiC,IAAI,CAAA;AACvE;AAMO,SAAS,MAAM,GAAA,EAAa;AACjC,EAAA,aAAA,CAAc,KAAK,CAAA,CAAE,KAAA,CAAM,GAAG,CAAA;AAChC;AAGO,SAAS,WAAW,CAAA,EAAW;AACpC,EAAA,OAAO,OAAO,CAAA,KAAM,QAAA,GAAW,cAAA,CAAe,CAAC,CAAA,GAAI,CAAA;AACrD;AAGO,SAAS,UAAA,CACd,KACA,OAAA,EAIA;AACA,EAAA,IAAI,OAAA,GAAU,MAAA,CAAO,OAAA,CAAQ,GAAG,CAAA;AAChC,EAAA,IAAI,SAAS,WAAA,EAAa;AACxB,IAAA,OAAA,CAAQ,KAAK,CAAC,CAAC,CAAC,CAAA,EAAG,CAAC,CAAC,CAAA,KAAM,CAAA,CAAE,aAAA,CAAc,GAAG,OAAA,EAAS,EAAE,OAAA,EAAS,IAAA,EAAM,CAAC,CAAA;AAAA,EAC3E;AACA,EAAA,IAAI,SAAS,iBAAA,EAAmB;AAC9B,IAAA,OAAA,GAAU,OAAA,CAAQ,MAAA;AAAA,MAChB,CAAC,GAAG,CAAC,CAAA,KAAM,EAAE,CAAA,IAAK,OAAO,CAAA,KAAM,QAAA,IAAY,YAAA,IAAgB,CAAA,IAAK,CAAA,CAAE,UAAA;AAAA,KACpE;AAAA,EACF;AACA,EAAA,OAAO,OAAA;AACT;AAQO,SAAS,UAAA,CACd,MAAA,EACA,IAAA,EACA,OAAA,EACe;AACf,EAAA,OAAO,kBAAA,CAAsB,MAAA,EAAQ,IAAA,EAAM,OAAO,CAAA;AACpD;AAMO,SAAS,IAAA,CACd,GAAA,EACA,EAAA,EACA,IAAA,GAA4B,EAAC,EACvB;AACN,EAAA,YAAA,CAAa,GAAA,EAAK,IAAI,IAAI,CAAA;AAC5B;AAMO,SAAS,IAAA,CAAK,GAAA,EAAa,MAAA,GAAS,KAAA,EAAO;AAChD,EAAA,aAAA,CAAc,MAAM,CAAA,CAAE,IAAA,CAAK,GAAG,CAAA;AAChC;;"}

package/dist/api/openapi-ts.cjs

@@ -8,16 +8,19 @@ const defaultPorts = require('./default-ports.cjs');
 const documentRun = require('./document-run.cjs');
 const transformSchema = require('./transform-schema.cjs');
 
-async function generateDeclarations(source, options, ports) {
-  const { schema, ctx } = await documentRun.createDocumentRun(source, options, ports);
+async function generateDocument(source, options, ports) {
+  const { schema, localFiles, ctx } = await documentRun.createDocumentRun(source, options, ports);
   const startedAt = ports.now();
-  const result = stackOverflow.withStackOverflowReported("transform", () => transformSchema.default(schema, ctx));
+  const declarations = stackOverflow.withStackOverflowReported("transform", () => transformSchema.default(schema, ctx));
   ports.logger.debug(
     "Completed AST transformation for entire document",
     "ts",
     ports.now() - startedAt
   );
-  return result;
+  return { declarations, localFiles };
+}
+async function generateDeclarations(source, options, ports) {
+  return (await generateDocument(source, options, ports)).declarations;
 }
 async function defaultGeneratorPorts(options) {
   const logger = defaultPorts.defaultLogger(options.silent ?? false);
@@ -29,7 +32,7 @@ async function defaultGeneratorPorts(options) {
     remoteRefTimeoutMs: defaultPorts.REMOTE_REF_TIMEOUT_MS,
     remoteDocumentLimits: defaultPorts.DEFAULT_REMOTE_DOCUMENT_LIMITS
   });
-  return { loader, logger, redoc, now: defaultPorts.monotonicNow };
+  return { loader, logger, deprecations: defaultPorts.defaultDeprecationReporter(), redoc, now: defaultPorts.monotonicNow };
 }
 async function openapiTS(source, options = {}) {
   return generateDeclarations(source, options, await defaultGeneratorPorts(options));
@@ -38,4 +41,5 @@ async function openapiTS(source, options = {}) {
 exports.default = openapiTS;
 exports.defaultGeneratorPorts = defaultGeneratorPorts;
 exports.generateDeclarations = generateDeclarations;
+exports.generateDocument = generateDocument;
 //# sourceMappingURL=openapi-ts.cjs.map

package/dist/api/openapi-ts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-ts.cjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  const { schema, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const result = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return result;\n}\n\n/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  });\n  return { loader, logger, redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":["createDocumentRun","withStackOverflowReported","transformSchema","defaultLogger","defaultRedoclyConfig","createRedoclySchemaLoader","monotonicNow","REMOTE_REF_TIMEOUT_MS","DEFAULT_REMOTE_DOCUMENT_LIMITS"],"mappings":";;;;;;;;;;AAoBA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,QAAQ,GAAA,EAAI,GAAI,MAAMA,6BAAA,CAAkB,MAAA,EAAQ,SAAS,KAAK,CAAA;AACtE,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,SAASC,uCAAA,CAA0B,WAAA,EAAa,MAAMC,uBAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AACxF,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAASC,0BAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAMC,iCAAA,EAAqB;AAC7D,EAAA,MAAM,SAASC,6CAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAKC,yBAAA;AAAA,IACL,kBAAA,EAAoBC,kCAAA;AAAA,IACpB,oBAAA,EAAsBC;AAAA,GACvB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAKF,yBAAA,EAAa;AACpD;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;;;"}
+{"version":3,"file":"openapi-ts.cjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  defaultDeprecationReporter,\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** The declarations of one document, and the local files it was read from. */\nexport interface GeneratedDocument {\n  readonly declarations: IrDeclaration[];\n  readonly localFiles: readonly URL[];\n}\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDocument(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<GeneratedDocument> {\n  const { schema, localFiles, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const declarations = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return { declarations, localFiles };\n}\n\n/** As `generateDocument`, the declarations only. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  return (await generateDocument(source, options, ports)).declarations;\n}\n\n/**\n * The default ports: the terminal logger, Node.js deprecation warnings, the given or default\n * Redocly config, Redocly loading.\n */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  });\n  return { loader, logger, deprecations: defaultDeprecationReporter(), redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":["createDocumentRun","withStackOverflowReported","transformSchema","defaultLogger","defaultRedoclyConfig","createRedoclySchemaLoader","monotonicNow","REMOTE_REF_TIMEOUT_MS","DEFAULT_REMOTE_DOCUMENT_LIMITS","defaultDeprecationReporter"],"mappings":";;;;;;;;;;AA2BA,eAAsB,gBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,EAAE,QAAQ,UAAA,EAAY,GAAA,KAAQ,MAAMA,6BAAA,CAAkB,MAAA,EAAQ,OAAA,EAAS,KAAK,CAAA;AAClF,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,eAAeC,uCAAA,CAA0B,WAAA,EAAa,MAAMC,uBAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AAC9F,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,EAAE,cAAc,UAAA,EAAW;AACpC;AAGA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,OAAA,CAAQ,MAAM,gBAAA,CAAiB,MAAA,EAAQ,OAAA,EAAS,KAAK,CAAA,EAAG,YAAA;AAC1D;AAMA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAASC,0BAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAMC,iCAAA,EAAqB;AAC7D,EAAA,MAAM,SAASC,6CAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAKC,yBAAA;AAAA,IACL,kBAAA,EAAoBC,kCAAA;AAAA,IACpB,oBAAA,EAAsBC;AAAA,GACvB,CAAA;AACD,EAAA,OAAO,EAAE,QAAQ,MAAA,EAAQ,YAAA,EAAcC,yCAA2B,EAAG,KAAA,EAAO,KAAKH,yBAAA,EAAa;AAChG;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;;;;"}

package/dist/api/openapi-ts.mjs

@@ -1,19 +1,22 @@
 import { createRedoclySchemaLoader } from '../adapters/redocly-loader/redocly-schema-loader.mjs';
 import { withStackOverflowReported } from '../application/stack-overflow.mjs';
-import { defaultLogger, defaultRedoclyConfig, monotonicNow, DEFAULT_REMOTE_DOCUMENT_LIMITS, REMOTE_REF_TIMEOUT_MS } from './default-ports.mjs';
+import { defaultLogger, defaultRedoclyConfig, monotonicNow, defaultDeprecationReporter, DEFAULT_REMOTE_DOCUMENT_LIMITS, REMOTE_REF_TIMEOUT_MS } from './default-ports.mjs';
 import { createDocumentRun } from './document-run.mjs';
 import transformSchema from './transform-schema.mjs';
 
-async function generateDeclarations(source, options, ports) {
-  const { schema, ctx } = await createDocumentRun(source, options, ports);
+async function generateDocument(source, options, ports) {
+  const { schema, localFiles, ctx } = await createDocumentRun(source, options, ports);
   const startedAt = ports.now();
-  const result = withStackOverflowReported("transform", () => transformSchema(schema, ctx));
+  const declarations = withStackOverflowReported("transform", () => transformSchema(schema, ctx));
   ports.logger.debug(
     "Completed AST transformation for entire document",
     "ts",
     ports.now() - startedAt
   );
-  return result;
+  return { declarations, localFiles };
+}
+async function generateDeclarations(source, options, ports) {
+  return (await generateDocument(source, options, ports)).declarations;
 }
 async function defaultGeneratorPorts(options) {
   const logger = defaultLogger(options.silent ?? false);
@@ -25,11 +28,11 @@ async function defaultGeneratorPorts(options) {
     remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,
     remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS
   });
-  return { loader, logger, redoc, now: monotonicNow };
+  return { loader, logger, deprecations: defaultDeprecationReporter(), redoc, now: monotonicNow };
 }
 async function openapiTS(source, options = {}) {
   return generateDeclarations(source, options, await defaultGeneratorPorts(options));
 }
 
-export { openapiTS as default, defaultGeneratorPorts, generateDeclarations };
+export { openapiTS as default, defaultGeneratorPorts, generateDeclarations, generateDocument };
 //# sourceMappingURL=openapi-ts.mjs.map

package/dist/api/openapi-ts.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"openapi-ts.mjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  const { schema, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const result = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return result;\n}\n\n/** The default ports: the terminal logger, the given or default Redocly config, Redocly loading. */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  });\n  return { loader, logger, redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":[],"mappings":";;;;;;AAoBA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,MAAM,EAAE,QAAQ,GAAA,EAAI,GAAI,MAAM,iBAAA,CAAkB,MAAA,EAAQ,SAAS,KAAK,CAAA;AACtE,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,SAAS,yBAAA,CAA0B,WAAA,EAAa,MAAM,eAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AACxF,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,MAAA;AACT;AAGA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAM,oBAAA,EAAqB;AAC7D,EAAA,MAAM,SAAS,yBAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAK,YAAA;AAAA,IACL,kBAAA,EAAoB,qBAAA;AAAA,IACpB,oBAAA,EAAsB;AAAA,GACvB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAK,YAAA,EAAa;AACpD;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;"}
+{"version":3,"file":"openapi-ts.mjs","sources":["../../src/api/openapi-ts.ts"],"sourcesContent":["import { createRedoclySchemaLoader } from \"../adapters/redocly-loader/redocly-schema-loader.js\";\nimport { withStackOverflowReported } from \"../application/stack-overflow.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\nimport type { GeneratorOptions, SchemaSource } from \"../types.js\";\nimport {\n  DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  defaultDeprecationReporter,\n  defaultLogger,\n  defaultRedoclyConfig,\n  monotonicNow,\n  REMOTE_REF_TIMEOUT_MS,\n} from \"./default-ports.js\";\nimport { createDocumentRun, type GeneratorPorts } from \"./document-run.js\";\nimport transformSchema from \"./transform-schema.js\";\n\n/**\n * The Node API's composition root (ENGINEERING_PLAN 4.5): `openapiTS` wires the default adapters;\n * `generateDeclarations` runs with any ports, which is how the CLI calls it.\n */\n\n/** The declarations of one document, and the local files it was read from. */\nexport interface GeneratedDocument {\n  readonly declarations: IrDeclaration[];\n  readonly localFiles: readonly URL[];\n}\n\n/** Load, validate and bundle the source, then transform it into IR declarations. */\nexport async function generateDocument(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<GeneratedDocument> {\n  const { schema, localFiles, ctx } = await createDocumentRun(source, options, ports);\n  const startedAt = ports.now();\n  const declarations = withStackOverflowReported(\"transform\", () => transformSchema(schema, ctx));\n  ports.logger.debug(\n    \"Completed AST transformation for entire document\",\n    \"ts\",\n    ports.now() - startedAt,\n  );\n  return { declarations, localFiles };\n}\n\n/** As `generateDocument`, the declarations only. */\nexport async function generateDeclarations(\n  source: SchemaSource,\n  options: GeneratorOptions,\n  ports: GeneratorPorts,\n): Promise<IrDeclaration[]> {\n  return (await generateDocument(source, options, ports)).declarations;\n}\n\n/**\n * The default ports: the terminal logger, Node.js deprecation warnings, the given or default\n * Redocly config, Redocly loading.\n */\nexport async function defaultGeneratorPorts(options: GeneratorOptions): Promise<GeneratorPorts> {\n  const logger = defaultLogger(options.silent ?? false);\n  const redoc = options.redocly ?? (await defaultRedoclyConfig());\n  const loader = createRedoclySchemaLoader({\n    redoc,\n    logger,\n    now: monotonicNow,\n    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS,\n    remoteDocumentLimits: DEFAULT_REMOTE_DOCUMENT_LIMITS,\n  });\n  return { loader, logger, deprecations: defaultDeprecationReporter(), redoc, now: monotonicNow };\n}\n\n/**\n * Convert an OpenAPI schema to TypeScript declarations (IR nodes; print them with `astToString`)\n * @param {string|URL|object|Readable} source OpenAPI schema source:\n *   - YAML: string\n *   - JSON: parsed object\n *   - URL: URL to a YAML or JSON file (local or remote)\n *   - Readable: Readable stream of YAML or JSON\n */\nexport default async function openapiTS(\n  source: SchemaSource,\n  options: GeneratorOptions = {},\n): Promise<IrDeclaration[]> {\n  return generateDeclarations(source, options, await defaultGeneratorPorts(options));\n}\n"],"names":[],"mappings":";;;;;;AA2BA,eAAsB,gBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC4B;AAC5B,EAAA,MAAM,EAAE,QAAQ,UAAA,EAAY,GAAA,KAAQ,MAAM,iBAAA,CAAkB,MAAA,EAAQ,OAAA,EAAS,KAAK,CAAA;AAClF,EAAA,MAAM,SAAA,GAAY,MAAM,GAAA,EAAI;AAC5B,EAAA,MAAM,eAAe,yBAAA,CAA0B,WAAA,EAAa,MAAM,eAAA,CAAgB,MAAA,EAAQ,GAAG,CAAC,CAAA;AAC9F,EAAA,KAAA,CAAM,MAAA,CAAO,KAAA;AAAA,IACX,kDAAA;AAAA,IACA,IAAA;AAAA,IACA,KAAA,CAAM,KAAI,GAAI;AAAA,GAChB;AACA,EAAA,OAAO,EAAE,cAAc,UAAA,EAAW;AACpC;AAGA,eAAsB,oBAAA,CACpB,MAAA,EACA,OAAA,EACA,KAAA,EAC0B;AAC1B,EAAA,OAAA,CAAQ,MAAM,gBAAA,CAAiB,MAAA,EAAQ,OAAA,EAAS,KAAK,CAAA,EAAG,YAAA;AAC1D;AAMA,eAAsB,sBAAsB,OAAA,EAAoD;AAC9F,EAAA,MAAM,MAAA,GAAS,aAAA,CAAc,OAAA,CAAQ,MAAA,IAAU,KAAK,CAAA;AACpD,EAAA,MAAM,KAAA,GAAQ,OAAA,CAAQ,OAAA,IAAY,MAAM,oBAAA,EAAqB;AAC7D,EAAA,MAAM,SAAS,yBAAA,CAA0B;AAAA,IACvC,KAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAA,EAAK,YAAA;AAAA,IACL,kBAAA,EAAoB,qBAAA;AAAA,IACpB,oBAAA,EAAsB;AAAA,GACvB,CAAA;AACD,EAAA,OAAO,EAAE,QAAQ,MAAA,EAAQ,YAAA,EAAc,4BAA2B,EAAG,KAAA,EAAO,KAAK,YAAA,EAAa;AAChG;AAUA,eAA8B,SAAA,CAC5B,MAAA,EACA,OAAA,GAA4B,EAAC,EACH;AAC1B,EAAA,OAAO,qBAAqB,MAAA,EAAQ,OAAA,EAAS,MAAM,qBAAA,CAAsB,OAAO,CAAC,CAAA;AACnF;;"}

package/dist/api/schema-callbacks.cjs

@@ -5,58 +5,82 @@ const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs'
 const typescriptToIr = require('../adapters/type-ast-bridge/typescript-to-ir.cjs');
 const errors = require('../domain/errors.cjs');
 const constructors = require('../domain/ir/constructors.cjs');
+const irShape = require('../domain/ir/ir-shape.cjs');
 const legacyCallbackWarning = require('./legacy-callback-warning.cjs');
 const typeHelpers = require('./type-helpers.cjs');
 
+const LEGACY_PROPERTY_PROBLEM = "a property with syntax the generator cannot read";
 class UnreadablePropertyError extends errors.OpenAPITypesafeError {
-  constructor(path) {
+  constructor(path, problem = LEGACY_PROPERTY_PROBLEM) {
     super({
       code: errors.ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
-      message: `transformProperty at ${path} returned a property with syntax the generator cannot read`,
+      message: `transformProperty at ${path} returned ${problem}`,
       details: { callback: "transformProperty", path }
     });
     this.name = "UnreadablePropertyError";
   }
 }
 class UnreadableTypeError extends errors.OpenAPITypesafeError {
-  constructor(callback, path) {
+  constructor(callback, path, expected = "a TypeScript node") {
     super({
       code: errors.ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
-      message: `${callback} at ${path} returned a value that is not a TypeScript node`,
+      message: `${callback} at ${path} returned a value that is not ${expected}`,
       details: { callback, path }
     });
     this.name = "UnreadableTypeError";
   }
 }
+const IR_TYPE_EXPECTED = "an IR type or non-empty type text";
+const IR_PROPERTY_PROBLEM = "a value that is not an IR property the generator can print";
 function nodeOptions(ctx, location) {
   return { ...location, ctx };
 }
 function schemaCallbacks(ctx) {
   return ctx.irCallbacks ? irSchemaCallbacks(ctx) : legacySchemaCallbacks(ctx);
 }
-function fromCallbackType(type) {
-  return typeof type === "string" ? constructors.irRaw(type) : type;
+function fromCallbackType(callback, type, location) {
+  const candidate = typeof type === "string" ? constructors.irRaw(type) : type;
+  if (!irShape.isPrintableIrType(candidate)) {
+    throw new UnreadableTypeError(callback, location.path, IR_TYPE_EXPECTED);
+  }
+  return candidate;
 }
-function irCustomType(result) {
+function irCustomType(result, location) {
   if (result === void 0 || result === null) {
     return null;
   }
   if (typeof result === "object" && "schema" in result) {
-    return { type: fromCallbackType(result.schema), isOptional: Boolean(result.questionToken) };
+    const { schema, questionToken } = result;
+    return {
+      type: fromCallbackType("transform", schema, location),
+      isOptional: Boolean(questionToken)
+    };
+  }
+  return { type: fromCallbackType("transform", result, location), isOptional: false };
+}
+function irProperty(result, location) {
+  if (result === void 0 || result === null) {
+    return null;
+  }
+  if (!irShape.isPrintableIrProperty(result)) {
+    throw new UnreadablePropertyError(location.path, IR_PROPERTY_PROBLEM);
   }
-  return { type: fromCallbackType(result), isOptional: false };
+  return result;
 }
 function irSchemaCallbacks(ctx) {
   const transform = ctx.transform;
   const postTransform = ctx.postTransform;
   const transformProperty = ctx.transformProperty;
   return {
-    transform: (schema, location) => transform ? irCustomType(transform(schema, nodeOptions(ctx, location))) : null,
+    transform: (schema, location) => transform ? irCustomType(transform(schema, nodeOptions(ctx, location)), location) : null,
     postTransform(type, location) {
       const result = postTransform?.(type, nodeOptions(ctx, location));
-      return result === void 0 ? null : fromCallbackType(result);
+      return result === void 0 ? null : fromCallbackType("postTransform", result, location);
     },
-    transformProperty: (property, schema, location) => transformProperty?.(property, schema, nodeOptions(ctx, location)) ?? null
+    transformProperty: (property, schema, location) => transformProperty ? irProperty(
+      transformProperty(property, schema, nodeOptions(ctx, location)),
+      location
+    ) : null
   };
 }
 function readResultType(callback, result, location) {

package/dist/api/schema-callbacks.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"schema-callbacks.cjs","sources":["../../src/api/schema-callbacks.ts"],"sourcesContent":["import { toPropertySignature, toTypeNode } from \"../adapters/type-ast-bridge/ir-to-typescript.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { fromPropertySignature } from \"../adapters/type-ast-bridge/typescript-to-ir.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport type {\n  CustomType,\n  SchemaCallbacks,\n  SchemaLocation,\n} from \"../application/transform/schema/schema-context.js\";\nimport { ERROR_CODES, OpenAPITypesafeError } from \"../domain/errors.js\";\nimport { irRaw } from \"../domain/ir/constructors.js\";\nimport type { IrPropertySignature, IrType } from \"../domain/ir/nodes.js\";\nimport type {\n  GlobalContext,\n  IrCallbackType,\n  IrPostTransform,\n  IrTransform,\n  IrTransformProperty,\n  LegacyCallbackOptions,\n  SchemaObject,\n  TransformNodeOptions,\n} from \"../types.js\";\nimport { warnLegacyCallback } from \"./legacy-callback-warning.js\";\nimport { toIrType } from \"./type-helpers.js\";\n\n/**\n * The user's schema callbacks as the transformers call them (ENGINEERING_PLAN 6.3, ADR-004).\n * With `irCallbacks: true` they receive and return IR; otherwise they receive TypeScript nodes and\n * their results are read by the bridge.\n */\n\nexport class UnreadablePropertyError extends OpenAPITypesafeError {\n  constructor(path: string | undefined) {\n    super({\n      code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,\n      message:\n        `transformProperty at ${path} returned a property ` +\n        \"with syntax the generator cannot read\",\n      details: { callback: \"transformProperty\", path },\n    });\n    this.name = \"UnreadablePropertyError\";\n  }\n}\n\n/** A `transform` or `postTransform` result that is neither IR nor a TypeScript node. */\nexport class UnreadableTypeError extends OpenAPITypesafeError {\n  constructor(callback: \"transform\" | \"postTransform\", path: string | undefined) {\n    super({\n      code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,\n      message: `${callback} at ${path} returned a value that is not a TypeScript node`,\n      details: { callback, path },\n    });\n    this.name = \"UnreadableTypeError\";\n  }\n}\n\nfunction nodeOptions(ctx: GlobalContext, location: SchemaLocation): TransformNodeOptions {\n  return { ...location, ctx } as TransformNodeOptions;\n}\n\n/** The callbacks of the run: IR callbacks when the run asks for them, legacy ones otherwise. */\nexport function schemaCallbacks(ctx: GlobalContext): SchemaCallbacks {\n  return ctx.irCallbacks ? irSchemaCallbacks(ctx) : legacySchemaCallbacks(ctx);\n}\n\n/** An IR callback type; text is a raw type, printed as written. */\nfunction fromCallbackType(type: IrCallbackType): IrType {\n  return typeof type === \"string\" ? irRaw(type) : type;\n}\n\nfunction irCustomType(result: ReturnType<IrTransform>): CustomType | null {\n  if (result === undefined || result === null) {\n    return null;\n  }\n  if (typeof result === \"object\" && \"schema\" in result) {\n    return { type: fromCallbackType(result.schema), isOptional: Boolean(result.questionToken) };\n  }\n  return { type: fromCallbackType(result), isOptional: false };\n}\n\n/**\n * The context fields hold either callback form; `irCallbacks` says which one, so the casts below\n * only name the form the user declared with `OpenAPITSIrOptions`.\n */\nfunction irSchemaCallbacks(ctx: GlobalContext): SchemaCallbacks {\n  const transform = ctx.transform as IrTransform | undefined;\n  const postTransform = ctx.postTransform as IrPostTransform | undefined;\n  const transformProperty = ctx.transformProperty as IrTransformProperty | undefined;\n  return {\n    transform: (schema, location) =>\n      transform\n        ? irCustomType(transform(schema as SchemaObject, nodeOptions(ctx, location)))\n        : null,\n    postTransform(type, location) {\n      const result = postTransform?.(type, nodeOptions(ctx, location));\n      return result === undefined ? null : fromCallbackType(result);\n    },\n    transformProperty: (property, schema, location) =>\n      transformProperty?.(property, schema as SchemaObject, nodeOptions(ctx, location)) ?? null,\n  };\n}\n\ntype LegacyTransform = NonNullable<LegacyCallbackOptions[\"transform\"]>;\ntype LegacyPostTransform = NonNullable<LegacyCallbackOptions[\"postTransform\"]>;\ntype LegacyTransformProperty = NonNullable<LegacyCallbackOptions[\"transformProperty\"]>;\n\n/** A legacy result type: IR from the helpers as it is; a TypeScript node through the bridge. */\n/**\n * IR nodes have a string `kind`, TypeScript nodes a number. JavaScript callers can return any\n * value, and anything else would crash the TypeScript printer later.\n */\nfunction readResultType(\n  callback: \"transform\" | \"postTransform\",\n  result: unknown,\n  location: SchemaLocation,\n): IrType {\n  const kind = (result as { kind?: unknown }).kind;\n  if (typeof kind !== \"string\" && typeof kind !== \"number\") {\n    throw new UnreadableTypeError(callback, location.path);\n  }\n  return toIrType(result as IrType | ts.TypeNode);\n}\n\nfunction legacyResultType(ctx: GlobalContext, type: unknown, location: SchemaLocation): IrType {\n  const result = readResultType(\"transform\", type, location);\n  if (typeof (type as { kind: unknown }).kind !== \"string\") {\n    warnLegacyCallback(ctx, \"transform\");\n  }\n  return result;\n}\n\nfunction legacyCustomType(\n  ctx: GlobalContext,\n  result: ReturnType<LegacyTransform>,\n  location: SchemaLocation,\n): CustomType | null {\n  if (!result || typeof result !== \"object\") {\n    return null;\n  }\n  if (\"schema\" in result) {\n    return {\n      type: legacyResultType(ctx, result.schema, location),\n      isOptional: Boolean(result.questionToken),\n    };\n  }\n  return { type: legacyResultType(ctx, result, location), isOptional: false };\n}\n\n/** See `irSchemaCallbacks` for the casts; `typeof` checks keep the original's tolerance. */\nfunction legacySchemaCallbacks(ctx: GlobalContext): SchemaCallbacks {\n  const transform = ctx.transform as LegacyTransform | undefined;\n  const postTransform = ctx.postTransform as LegacyPostTransform | undefined;\n  return {\n    transform: (schema, location) =>\n      typeof transform === \"function\"\n        ? legacyCustomType(\n            ctx,\n            transform(schema as SchemaObject, nodeOptions(ctx, location)),\n            location,\n          )\n        : null,\n    postTransform(type, location) {\n      if (typeof postTransform !== \"function\") {\n        return null;\n      }\n      warnLegacyCallback(ctx, \"postTransform\");\n      const result = postTransform(toTypeNode(loadTypeScript(), type), nodeOptions(ctx, location));\n      return result ? readResultType(\"postTransform\", result, location) : null;\n    },\n    transformProperty: (property, schema, location) =>\n      legacyTransformProperty(ctx, property, schema, location),\n  };\n}\n\nfunction isIrProperty(\n  property: IrPropertySignature | ts.PropertySignature,\n): property is IrPropertySignature {\n  return typeof property.kind === \"string\";\n}\n\nfunction legacyTransformProperty(\n  ctx: GlobalContext,\n  property: IrPropertySignature,\n  schema: unknown,\n  location: SchemaLocation,\n): IrPropertySignature | null {\n  const transformProperty = ctx.transformProperty as LegacyTransformProperty | undefined;\n  if (typeof transformProperty !== \"function\") {\n    return null;\n  }\n  warnLegacyCallback(ctx, \"transformProperty\");\n  const ts = loadTypeScript();\n  const options = nodeOptions(ctx, location);\n  const result = transformProperty(\n    toPropertySignature(ts, property),\n    schema as SchemaObject,\n    options,\n  );\n  if (!result) {\n    return null;\n  }\n  if (isIrProperty(result)) {\n    return result;\n  }\n  // JavaScript callers can return any value, so check the node kind before reading it.\n  const converted = ts.isPropertySignature(result) ? fromPropertySignature(ts, result) : null;\n  if (converted === null) {\n    throw new UnreadablePropertyError(location.path);\n  }\n  return converted;\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES","irRaw","toIrType","warnLegacyCallback","toTypeNode","loadTypeScript","toPropertySignature","fromPropertySignature"],"mappings":"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"}
+{"version":3,"file":"schema-callbacks.cjs","sources":["../../src/api/schema-callbacks.ts"],"sourcesContent":["import { toPropertySignature, toTypeNode } from \"../adapters/type-ast-bridge/ir-to-typescript.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { fromPropertySignature } from \"../adapters/type-ast-bridge/typescript-to-ir.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport type {\n  CustomType,\n  SchemaCallbacks,\n  SchemaLocation,\n} from \"../application/transform/schema/schema-context.js\";\nimport { ERROR_CODES, OpenAPITypesafeError } from \"../domain/errors.js\";\nimport { irRaw } from \"../domain/ir/constructors.js\";\nimport { isPrintableIrProperty, isPrintableIrType } from \"../domain/ir/ir-shape.js\";\nimport type { IrPropertySignature, IrType } from \"../domain/ir/nodes.js\";\nimport type {\n  GlobalContext,\n  IrPostTransform,\n  IrTransform,\n  IrTransformProperty,\n  LegacyCallbackOptions,\n  SchemaObject,\n  TransformNodeOptions,\n} from \"../types.js\";\nimport { warnLegacyCallback } from \"./legacy-callback-warning.js\";\nimport { toIrType } from \"./type-helpers.js\";\n\n/**\n * The user's schema callbacks as the transformers call them (ENGINEERING_PLAN 6.3, ADR-004).\n * With `irCallbacks: true` they receive and return IR; otherwise they receive TypeScript nodes and\n * their results are read by the bridge.\n */\n\n/** What a legacy `transformProperty` result fails to be. */\nconst LEGACY_PROPERTY_PROBLEM = \"a property with syntax the generator cannot read\";\n\n/** A `transformProperty` result the generator cannot print as a property. */\nexport class UnreadablePropertyError extends OpenAPITypesafeError {\n  constructor(path: string | undefined, problem = LEGACY_PROPERTY_PROBLEM) {\n    super({\n      code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,\n      message: `transformProperty at ${path} returned ${problem}`,\n      details: { callback: \"transformProperty\", path },\n    });\n    this.name = \"UnreadablePropertyError\";\n  }\n}\n\n/** A `transform` or `postTransform` result that is neither IR nor a TypeScript node. */\nexport class UnreadableTypeError extends OpenAPITypesafeError {\n  constructor(\n    callback: \"transform\" | \"postTransform\",\n    path: string | undefined,\n    expected = \"a TypeScript node\",\n  ) {\n    super({\n      code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,\n      message: `${callback} at ${path} returned a value that is not ${expected}`,\n      details: { callback, path },\n    });\n    this.name = \"UnreadableTypeError\";\n  }\n}\n\n/** What an IR type result must be (docs/node.md, IR callbacks). */\nconst IR_TYPE_EXPECTED = \"an IR type or non-empty type text\";\n\n/** What an IR property result must be. */\nconst IR_PROPERTY_PROBLEM = \"a value that is not an IR property the generator can print\";\n\nfunction nodeOptions(ctx: GlobalContext, location: SchemaLocation): TransformNodeOptions {\n  return { ...location, ctx } as TransformNodeOptions;\n}\n\n/** The callbacks of the run: IR callbacks when the run asks for them, legacy ones otherwise. */\nexport function schemaCallbacks(ctx: GlobalContext): SchemaCallbacks {\n  return ctx.irCallbacks ? irSchemaCallbacks(ctx) : legacySchemaCallbacks(ctx);\n}\n\n/**\n * An IR callback type; text is a raw type, printed as written. Any other value, and IR the\n * printer cannot write as TypeScript, fails with `CALLBACK_RESULT_UNREADABLE` (`ir-shape.ts`).\n */\nfunction fromCallbackType(\n  callback: \"transform\" | \"postTransform\",\n  type: unknown,\n  location: SchemaLocation,\n): IrType {\n  const candidate = typeof type === \"string\" ? irRaw(type) : type;\n  if (!isPrintableIrType(candidate)) {\n    throw new UnreadableTypeError(callback, location.path, IR_TYPE_EXPECTED);\n  }\n  return candidate;\n}\n\nfunction irCustomType(result: unknown, location: SchemaLocation): CustomType | null {\n  if (result === undefined || result === null) {\n    return null;\n  }\n  if (typeof result === \"object\" && \"schema\" in result) {\n    const { schema, questionToken } = result as { schema: unknown; questionToken?: unknown };\n    return {\n      type: fromCallbackType(\"transform\", schema, location),\n      isOptional: Boolean(questionToken),\n    };\n  }\n  return { type: fromCallbackType(\"transform\", result, location), isOptional: false };\n}\n\nfunction irProperty(result: unknown, location: SchemaLocation): IrPropertySignature | null {\n  if (result === undefined || result === null) {\n    return null;\n  }\n  if (!isPrintableIrProperty(result)) {\n    throw new UnreadablePropertyError(location.path, IR_PROPERTY_PROBLEM);\n  }\n  return result;\n}\n\n/**\n * The context fields hold either callback form; `irCallbacks` says which one, so the casts below\n * only name the form the user declared with `OpenAPITSIrOptions`. The results are checked, since\n * JavaScript callers can return any value.\n */\nfunction irSchemaCallbacks(ctx: GlobalContext): SchemaCallbacks {\n  const transform = ctx.transform as IrTransform | undefined;\n  const postTransform = ctx.postTransform as IrPostTransform | undefined;\n  const transformProperty = ctx.transformProperty as IrTransformProperty | undefined;\n  return {\n    transform: (schema, location) =>\n      transform\n        ? irCustomType(transform(schema as SchemaObject, nodeOptions(ctx, location)), location)\n        : null,\n    postTransform(type, location) {\n      const result = postTransform?.(type, nodeOptions(ctx, location));\n      return result === undefined ? null : fromCallbackType(\"postTransform\", result, location);\n    },\n    transformProperty: (property, schema, location) =>\n      transformProperty\n        ? irProperty(\n            transformProperty(property, schema as SchemaObject, nodeOptions(ctx, location)),\n            location,\n          )\n        : null,\n  };\n}\n\ntype LegacyTransform = NonNullable<LegacyCallbackOptions[\"transform\"]>;\ntype LegacyPostTransform = NonNullable<LegacyCallbackOptions[\"postTransform\"]>;\ntype LegacyTransformProperty = NonNullable<LegacyCallbackOptions[\"transformProperty\"]>;\n\n/** A legacy result type: IR from the helpers as it is; a TypeScript node through the bridge. */\n/**\n * IR nodes have a string `kind`, TypeScript nodes a number. JavaScript callers can return any\n * value, and anything else would crash the TypeScript printer later.\n */\nfunction readResultType(\n  callback: \"transform\" | \"postTransform\",\n  result: unknown,\n  location: SchemaLocation,\n): IrType {\n  const kind = (result as { kind?: unknown }).kind;\n  if (typeof kind !== \"string\" && typeof kind !== \"number\") {\n    throw new UnreadableTypeError(callback, location.path);\n  }\n  return toIrType(result as IrType | ts.TypeNode);\n}\n\nfunction legacyResultType(ctx: GlobalContext, type: unknown, location: SchemaLocation): IrType {\n  const result = readResultType(\"transform\", type, location);\n  if (typeof (type as { kind: unknown }).kind !== \"string\") {\n    warnLegacyCallback(ctx, \"transform\");\n  }\n  return result;\n}\n\nfunction legacyCustomType(\n  ctx: GlobalContext,\n  result: ReturnType<LegacyTransform>,\n  location: SchemaLocation,\n): CustomType | null {\n  if (!result || typeof result !== \"object\") {\n    return null;\n  }\n  if (\"schema\" in result) {\n    return {\n      type: legacyResultType(ctx, result.schema, location),\n      isOptional: Boolean(result.questionToken),\n    };\n  }\n  return { type: legacyResultType(ctx, result, location), isOptional: false };\n}\n\n/** See `irSchemaCallbacks` for the casts; `typeof` checks keep the original's tolerance. */\nfunction legacySchemaCallbacks(ctx: GlobalContext): SchemaCallbacks {\n  const transform = ctx.transform as LegacyTransform | undefined;\n  const postTransform = ctx.postTransform as LegacyPostTransform | undefined;\n  return {\n    transform: (schema, location) =>\n      typeof transform === \"function\"\n        ? legacyCustomType(\n            ctx,\n            transform(schema as SchemaObject, nodeOptions(ctx, location)),\n            location,\n          )\n        : null,\n    postTransform(type, location) {\n      if (typeof postTransform !== \"function\") {\n        return null;\n      }\n      warnLegacyCallback(ctx, \"postTransform\");\n      const result = postTransform(toTypeNode(loadTypeScript(), type), nodeOptions(ctx, location));\n      return result ? readResultType(\"postTransform\", result, location) : null;\n    },\n    transformProperty: (property, schema, location) =>\n      legacyTransformProperty(ctx, property, schema, location),\n  };\n}\n\nfunction isIrProperty(\n  property: IrPropertySignature | ts.PropertySignature,\n): property is IrPropertySignature {\n  return typeof property.kind === \"string\";\n}\n\nfunction legacyTransformProperty(\n  ctx: GlobalContext,\n  property: IrPropertySignature,\n  schema: unknown,\n  location: SchemaLocation,\n): IrPropertySignature | null {\n  const transformProperty = ctx.transformProperty as LegacyTransformProperty | undefined;\n  if (typeof transformProperty !== \"function\") {\n    return null;\n  }\n  warnLegacyCallback(ctx, \"transformProperty\");\n  const ts = loadTypeScript();\n  const options = nodeOptions(ctx, location);\n  const result = transformProperty(\n    toPropertySignature(ts, property),\n    schema as SchemaObject,\n    options,\n  );\n  if (!result) {\n    return null;\n  }\n  if (isIrProperty(result)) {\n    return result;\n  }\n  // JavaScript callers can return any value, so check the node kind before reading it.\n  const converted = ts.isPropertySignature(result) ? fromPropertySignature(ts, result) : null;\n  if (converted === null) {\n    throw new UnreadablePropertyError(location.path);\n  }\n  return converted;\n}\n"],"names":["OpenAPITypesafeError","ERROR_CODES","irRaw","isPrintableIrType","isPrintableIrProperty","toIrType","warnLegacyCallback","toTypeNode","loadTypeScript","toPropertySignature","fromPropertySignature"],"mappings":";;;;;;;;;;;AAgCA,MAAM,uBAAA,GAA0B,kDAAA;AAGzB,MAAM,gCAAgCA,2BAAA,CAAqB;AAAA,EAChE,WAAA,CAAY,IAAA,EAA0B,OAAA,GAAU,uBAAA,EAAyB;AACvE,IAAA,KAAA,CAAM;AAAA,MACJ,MAAMC,kBAAA,CAAY,0BAAA;AAAA,MAClB,OAAA,EAAS,CAAA,qBAAA,EAAwB,IAAI,CAAA,UAAA,EAAa,OAAO,CAAA,CAAA;AAAA,MACzD,OAAA,EAAS,EAAE,QAAA,EAAU,mBAAA,EAAqB,IAAA;AAAK,KAChD,CAAA;AACD,IAAA,IAAA,CAAK,IAAA,GAAO,yBAAA;AAAA,EACd;AACF;AAGO,MAAM,4BAA4BD,2BAAA,CAAqB;AAAA,EAC5D,WAAA,CACE,QAAA,EACA,IAAA,EACA,QAAA,GAAW,mBAAA,EACX;AACA,IAAA,KAAA,CAAM;AAAA,MACJ,MAAMC,kBAAA,CAAY,0BAAA;AAAA,MAClB,SAAS,CAAA,EAAG,QAAQ,CAAA,IAAA,EAAO,IAAI,iCAAiC,QAAQ,CAAA,CAAA;AAAA,MACxE,OAAA,EAAS,EAAE,QAAA,EAAU,IAAA;AAAK,KAC3B,CAAA;AACD,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAAA,EACd;AACF;AAGA,MAAM,gBAAA,GAAmB,mCAAA;AAGzB,MAAM,mBAAA,GAAsB,4DAAA;AAE5B,SAAS,WAAA,CAAY,KAAoB,QAAA,EAAgD;AACvF,EAAA,OAAO,EAAE,GAAG,QAAA,EAAU,GAAA,EAAI;AAC5B;AAGO,SAAS,gBAAgB,GAAA,EAAqC;AACnE,EAAA,OAAO,IAAI,WAAA,GAAc,iBAAA,CAAkB,GAAG,CAAA,GAAI,sBAAsB,GAAG,CAAA;AAC7E;AAMA,SAAS,gBAAA,CACP,QAAA,EACA,IAAA,EACA,QAAA,EACQ;AACR,EAAA,MAAM,YAAY,OAAO,IAAA,KAAS,QAAA,GAAWC,kBAAA,CAAM,IAAI,CAAA,GAAI,IAAA;AAC3D,EAAA,IAAI,CAACC,yBAAA,CAAkB,SAAS,CAAA,EAAG;AACjC,IAAA,MAAM,IAAI,mBAAA,CAAoB,QAAA,EAAU,QAAA,CAAS,MAAM,gBAAgB,CAAA;AAAA,EACzE;AACA,EAAA,OAAO,SAAA;AACT;AAEA,SAAS,YAAA,CAAa,QAAiB,QAAA,EAA6C;AAClF,EAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,KAAW,IAAA,EAAM;AAC3C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,IAAY,QAAA,IAAY,MAAA,EAAQ;AACpD,IAAA,MAAM,EAAE,MAAA,EAAQ,aAAA,EAAc,GAAI,MAAA;AAClC,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,gBAAA,CAAiB,WAAA,EAAa,MAAA,EAAQ,QAAQ,CAAA;AAAA,MACpD,UAAA,EAAY,QAAQ,aAAa;AAAA,KACnC;AAAA,EACF;AACA,EAAA,OAAO,EAAE,MAAM,gBAAA,CAAiB,WAAA,EAAa,QAAQ,QAAQ,CAAA,EAAG,YAAY,KAAA,EAAM;AACpF;AAEA,SAAS,UAAA,CAAW,QAAiB,QAAA,EAAsD;AACzF,EAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,KAAW,IAAA,EAAM;AAC3C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,CAACC,6BAAA,CAAsB,MAAM,CAAA,EAAG;AAClC,IAAA,MAAM,IAAI,uBAAA,CAAwB,QAAA,CAAS,IAAA,EAAM,mBAAmB,CAAA;AAAA,EACtE;AACA,EAAA,OAAO,MAAA;AACT;AAOA,SAAS,kBAAkB,GAAA,EAAqC;AAC9D,EAAA,MAAM,YAAY,GAAA,CAAI,SAAA;AACtB,EAAA,MAAM,gBAAgB,GAAA,CAAI,aAAA;AAC1B,EAAA,MAAM,oBAAoB,GAAA,CAAI,iBAAA;AAC9B,EAAA,OAAO;AAAA,IACL,SAAA,EAAW,CAAC,MAAA,EAAQ,QAAA,KAClB,YACI,YAAA,CAAa,SAAA,CAAU,MAAA,EAAwB,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAC,CAAA,EAAG,QAAQ,CAAA,GACpF,IAAA;AAAA,IACN,aAAA,CAAc,MAAM,QAAA,EAAU;AAC5B,MAAA,MAAM,SAAS,aAAA,GAAgB,IAAA,EAAM,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAC,CAAA;AAC/D,MAAA,OAAO,WAAW,MAAA,GAAY,IAAA,GAAO,gBAAA,CAAiB,eAAA,EAAiB,QAAQ,QAAQ,CAAA;AAAA,IACzF,CAAA;AAAA,IACA,iBAAA,EAAmB,CAAC,QAAA,EAAU,MAAA,EAAQ,aACpC,iBAAA,GACI,UAAA;AAAA,MACE,kBAAkB,QAAA,EAAU,MAAA,EAAwB,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAC,CAAA;AAAA,MAC9E;AAAA,KACF,GACA;AAAA,GACR;AACF;AAWA,SAAS,cAAA,CACP,QAAA,EACA,MAAA,EACA,QAAA,EACQ;AACR,EAAA,MAAM,OAAQ,MAAA,CAA8B,IAAA;AAC5C,EAAA,IAAI,OAAO,IAAA,KAAS,QAAA,IAAY,OAAO,SAAS,QAAA,EAAU;AACxD,IAAA,MAAM,IAAI,mBAAA,CAAoB,QAAA,EAAU,QAAA,CAAS,IAAI,CAAA;AAAA,EACvD;AACA,EAAA,OAAOC,qBAAS,MAA8B,CAAA;AAChD;AAEA,SAAS,gBAAA,CAAiB,GAAA,EAAoB,IAAA,EAAe,QAAA,EAAkC;AAC7F,EAAA,MAAM,MAAA,GAAS,cAAA,CAAe,WAAA,EAAa,IAAA,EAAM,QAAQ,CAAA;AACzD,EAAA,IAAI,OAAQ,IAAA,CAA2B,IAAA,KAAS,QAAA,EAAU;AACxD,IAAAC,wCAAA,CAAmB,KAAK,WAAW,CAAA;AAAA,EACrC;AACA,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,gBAAA,CACP,GAAA,EACA,MAAA,EACA,QAAA,EACmB;AACnB,EAAA,IAAI,CAAC,MAAA,IAAU,OAAO,MAAA,KAAW,QAAA,EAAU;AACzC,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,YAAY,MAAA,EAAQ;AACtB,IAAA,OAAO;AAAA,MACL,IAAA,EAAM,gBAAA,CAAiB,GAAA,EAAK,MAAA,CAAO,QAAQ,QAAQ,CAAA;AAAA,MACnD,UAAA,EAAY,OAAA,CAAQ,MAAA,CAAO,aAAa;AAAA,KAC1C;AAAA,EACF;AACA,EAAA,OAAO,EAAE,MAAM,gBAAA,CAAiB,GAAA,EAAK,QAAQ,QAAQ,CAAA,EAAG,YAAY,KAAA,EAAM;AAC5E;AAGA,SAAS,sBAAsB,GAAA,EAAqC;AAClE,EAAA,MAAM,YAAY,GAAA,CAAI,SAAA;AACtB,EAAA,MAAM,gBAAgB,GAAA,CAAI,aAAA;AAC1B,EAAA,OAAO;AAAA,IACL,WAAW,CAAC,MAAA,EAAQ,QAAA,KAClB,OAAO,cAAc,UAAA,GACjB,gBAAA;AAAA,MACE,GAAA;AAAA,MACA,SAAA,CAAU,MAAA,EAAwB,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAC,CAAA;AAAA,MAC5D;AAAA,KACF,GACA,IAAA;AAAA,IACN,aAAA,CAAc,MAAM,QAAA,EAAU;AAC5B,MAAA,IAAI,OAAO,kBAAkB,UAAA,EAAY;AACvC,QAAA,OAAO,IAAA;AAAA,MACT;AACA,MAAAA,wCAAA,CAAmB,KAAK,eAAe,CAAA;AACvC,MAAA,MAAM,MAAA,GAAS,aAAA,CAAcC,yBAAA,CAAWC,6BAAA,EAAe,EAAG,IAAI,CAAA,EAAG,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAC,CAAA;AAC3F,MAAA,OAAO,MAAA,GAAS,cAAA,CAAe,eAAA,EAAiB,MAAA,EAAQ,QAAQ,CAAA,GAAI,IAAA;AAAA,IACtE,CAAA;AAAA,IACA,iBAAA,EAAmB,CAAC,QAAA,EAAU,MAAA,EAAQ,aACpC,uBAAA,CAAwB,GAAA,EAAK,QAAA,EAAU,MAAA,EAAQ,QAAQ;AAAA,GAC3D;AACF;AAEA,SAAS,aACP,QAAA,EACiC;AACjC,EAAA,OAAO,OAAO,SAAS,IAAA,KAAS,QAAA;AAClC;AAEA,SAAS,uBAAA,CACP,GAAA,EACA,QAAA,EACA,MAAA,EACA,QAAA,EAC4B;AAC5B,EAAA,MAAM,oBAAoB,GAAA,CAAI,iBAAA;AAC9B,EAAA,IAAI,OAAO,sBAAsB,UAAA,EAAY;AAC3C,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAAF,wCAAA,CAAmB,KAAK,mBAAmB,CAAA;AAC3C,EAAA,MAAM,KAAKE,6BAAA,EAAe;AAC1B,EAAA,MAAM,OAAA,GAAU,WAAA,CAAY,GAAA,EAAK,QAAQ,CAAA;AACzC,EAAA,MAAM,MAAA,GAAS,iBAAA;AAAA,IACbC,kCAAA,CAAoB,IAAI,QAAQ,CAAA;AAAA,IAChC,MAAA;AAAA,IACA;AAAA,GACF;AACA,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,IAAA;AAAA,EACT;AACA,EAAA,IAAI,YAAA,CAAa,MAAM,CAAA,EAAG;AACxB,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,MAAM,SAAA,GAAY,GAAG,mBAAA,CAAoB,MAAM,IAAIC,oCAAA,CAAsB,EAAA,EAAI,MAAM,CAAA,GAAI,IAAA;AACvF,EAAA,IAAI,cAAc,IAAA,EAAM;AACtB,IAAA,MAAM,IAAI,uBAAA,CAAwB,QAAA,CAAS,IAAI,CAAA;AAAA,EACjD;AACA,EAAA,OAAO,SAAA;AACT;;;;"}

package/dist/api/schema-callbacks.mjs

@@ -3,58 +3,82 @@ import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs'
 import { fromPropertySignature } from '../adapters/type-ast-bridge/typescript-to-ir.mjs';
 import { OpenAPITypesafeError, ERROR_CODES } from '../domain/errors.mjs';
 import { irRaw } from '../domain/ir/constructors.mjs';
+import { isPrintableIrProperty, isPrintableIrType } from '../domain/ir/ir-shape.mjs';
 import { warnLegacyCallback } from './legacy-callback-warning.mjs';
 import { toIrType } from './type-helpers.mjs';
 
+const LEGACY_PROPERTY_PROBLEM = "a property with syntax the generator cannot read";
 class UnreadablePropertyError extends OpenAPITypesafeError {
-  constructor(path) {
+  constructor(path, problem = LEGACY_PROPERTY_PROBLEM) {
     super({
       code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
-      message: `transformProperty at ${path} returned a property with syntax the generator cannot read`,
+      message: `transformProperty at ${path} returned ${problem}`,
       details: { callback: "transformProperty", path }
     });
     this.name = "UnreadablePropertyError";
   }
 }
 class UnreadableTypeError extends OpenAPITypesafeError {
-  constructor(callback, path) {
+  constructor(callback, path, expected = "a TypeScript node") {
     super({
       code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
-      message: `${callback} at ${path} returned a value that is not a TypeScript node`,
+      message: `${callback} at ${path} returned a value that is not ${expected}`,
       details: { callback, path }
     });
     this.name = "UnreadableTypeError";
   }
 }
+const IR_TYPE_EXPECTED = "an IR type or non-empty type text";
+const IR_PROPERTY_PROBLEM = "a value that is not an IR property the generator can print";
 function nodeOptions(ctx, location) {
   return { ...location, ctx };
 }
 function schemaCallbacks(ctx) {
   return ctx.irCallbacks ? irSchemaCallbacks(ctx) : legacySchemaCallbacks(ctx);
 }
-function fromCallbackType(type) {
-  return typeof type === "string" ? irRaw(type) : type;
+function fromCallbackType(callback, type, location) {
+  const candidate = typeof type === "string" ? irRaw(type) : type;
+  if (!isPrintableIrType(candidate)) {
+    throw new UnreadableTypeError(callback, location.path, IR_TYPE_EXPECTED);
+  }
+  return candidate;
 }
-function irCustomType(result) {
+function irCustomType(result, location) {
   if (result === void 0 || result === null) {
     return null;
   }
   if (typeof result === "object" && "schema" in result) {
-    return { type: fromCallbackType(result.schema), isOptional: Boolean(result.questionToken) };
+    const { schema, questionToken } = result;
+    return {
+      type: fromCallbackType("transform", schema, location),
+      isOptional: Boolean(questionToken)
+    };
+  }
+  return { type: fromCallbackType("transform", result, location), isOptional: false };
+}
+function irProperty(result, location) {
+  if (result === void 0 || result === null) {
+    return null;
+  }
+  if (!isPrintableIrProperty(result)) {
+    throw new UnreadablePropertyError(location.path, IR_PROPERTY_PROBLEM);
   }
-  return { type: fromCallbackType(result), isOptional: false };
+  return result;
 }
 function irSchemaCallbacks(ctx) {
   const transform = ctx.transform;
   const postTransform = ctx.postTransform;
   const transformProperty = ctx.transformProperty;
   return {
-    transform: (schema, location) => transform ? irCustomType(transform(schema, nodeOptions(ctx, location))) : null,
+    transform: (schema, location) => transform ? irCustomType(transform(schema, nodeOptions(ctx, location)), location) : null,
     postTransform(type, location) {
       const result = postTransform?.(type, nodeOptions(ctx, location));
-      return result === void 0 ? null : fromCallbackType(result);
+      return result === void 0 ? null : fromCallbackType("postTransform", result, location);
     },
-    transformProperty: (property, schema, location) => transformProperty?.(property, schema, nodeOptions(ctx, location)) ?? null
+    transformProperty: (property, schema, location) => transformProperty ? irProperty(
+      transformProperty(property, schema, nodeOptions(ctx, location)),
+      location
+    ) : null
   };
 }
 function readResultType(callback, result, location) {