openapi-typesafe 0.0.0 → 1.0.0-rc.0

package/dist/api/document-run.cjs

@@ -0,0 +1,107 @@
+'use strict';
+
+const path = require('node:path');
+const node_url = require('node:url');
+const schemaLoadErrors = require('../adapters/redocly-loader/schema-load-errors.cjs');
+const stackOverflow = require('../application/stack-overflow.cjs');
+const outputFixes = require('../domain/output-fixes.cjs');
+const discriminatorScan = require('./discriminator-scan.cjs');
+const documentRefs = require('./document-refs.cjs');
+const unsupportedFeatureWarnings = require('./unsupported-feature-warnings.cjs');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const path__default = /*#__PURE__*/_interopDefaultCompat(path);
+
+function sourceCwd(options) {
+  return options.cwd instanceof URL ? options.cwd : new URL(`file://${options.cwd ?? process.cwd()}/`);
+}
+function refAccessOf(options, cwd) {
+  const { localRefRoot, remoteRefHosts } = options;
+  const localRoot = typeof localRefRoot === "string" ? node_url.pathToFileURL(path__default.resolve(node_url.fileURLToPath(cwd), localRefRoot)) : localRefRoot;
+  return {
+    ...localRoot === void 0 ? {} : { localRoot },
+    ...remoteRefHosts === void 0 ? {} : { remoteHosts: remoteRefHosts }
+  };
+}
+function callbackOptions(options) {
+  return {
+    irCallbacks: options.irCallbacks === true,
+    postTransform: typeof options.postTransform === "function" ? options.postTransform : void 0,
+    transform: typeof options.transform === "function" ? options.transform : void 0,
+    transformProperty: typeof options.transformProperty === "function" ? options.transformProperty : void 0
+  };
+}
+function contextFlags(options) {
+  return {
+    additionalProperties: options.additionalProperties ?? false,
+    alphabetize: options.alphabetize ?? false,
+    arrayLength: options.arrayLength ?? false,
+    binaryAsBlob: options.binaryAsBlob ?? false,
+    defaultNonNullable: options.defaultNonNullable ?? true,
+    emptyObjectsUnknown: options.emptyObjectsUnknown ?? false,
+    enum: options.enum ?? false,
+    enumValues: options.enumValues ?? false,
+    conditionalEnums: options.conditionalEnums ?? false,
+    dedupeEnums: options.dedupeEnums ?? false,
+    excludeDeprecated: options.excludeDeprecated ?? false,
+    exportType: options.exportType ?? false,
+    immutable: options.immutable ?? false,
+    rootTypes: options.rootTypes ?? false,
+    rootTypesNoSchemaPrefix: options.rootTypesNoSchemaPrefix ?? false,
+    rootTypesKeepCasing: options.rootTypesKeepCasing ?? false,
+    pathParamsAsTypes: options.pathParamsAsTypes ?? false,
+    propertiesRequiredByDefault: options.propertiesRequiredByDefault ?? false,
+    silent: options.silent ?? false,
+    ...options.inject === void 0 ? {} : { inject: options.inject },
+    makePathsEnum: options.makePathsEnum ?? false,
+    generatePathParams: options.generatePathParams ?? false,
+    readWriteMarkers: options.readWriteMarkers ?? false,
+    ...callbackOptions(options)
+  };
+}
+function outputFixesOf(options, logger) {
+  const names = outputFixes.outputFixNamesOf(options.fix ?? []);
+  for (const notice of outputFixes.ineffectiveFixNotices(names, (option) => options[option] === true)) {
+    logger.warn(notice);
+  }
+  return [...outputFixes.resolveOutputFixes(names)];
+}
+async function createDocumentRun(source, options, ports) {
+  if (!source) {
+    throw schemaLoadErrors.sourceEmptyError("Empty schema. Please specify a URL, file path, or Redocly Config");
+  }
+  const { logger } = ports;
+  const fix = outputFixesOf(options, logger);
+  const silent = options.silent ?? false;
+  const cwd = sourceCwd(options);
+  const schema = await ports.loader.load({
+    source,
+    cwd,
+    shouldLint: options.lint ?? true,
+    refAccess: refAccessOf(options, cwd)
+  });
+  stackOverflow.withStackOverflowReported("transform", () => unsupportedFeatureWarnings.warnUnsupportedFeatures(schema, logger));
+  const ctx = {
+    ...contextFlags(options),
+    fix,
+    // The scan walks every schema before the transform does, so on a larger stack, where loading
+    // passed, it is the first step to run out.
+    discriminators: stackOverflow.withStackOverflowReported(
+      "transform",
+      () => discriminatorScan.findDiscriminators(schema, {
+        silent,
+        logger,
+        fixesValueConflicts: fix.includes(outputFixes.OutputFix.DISCRIMINATOR_VALUES)
+      })
+    ),
+    injectFooter: [],
+    redoc: ports.redoc,
+    resolve: ($ref) => documentRefs.resolveDocumentRef(schema, $ref, { silent, logger }),
+    logger
+  };
+  return { schema, ctx };
+}
+
+exports.createDocumentRun = createDocumentRun;
+//# sourceMappingURL=document-run.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"document-run.cjs","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  OutputFix,\n  outputFixNamesOf,\n  resolveOutputFixes,\n} from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions, GlobalContext, OpenAPI3, SchemaSource } from \"../types.js\";\nimport { findDiscriminators } from \"./discriminator-scan.js\";\nimport { resolveDocumentRef } from \"./document-refs.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: GlobalContext;\n}\n\n/** The context fields that are user flags, with the original defaults. */\ntype ContextFlags = Omit<\n  GlobalContext,\n  | \"discriminators\"\n  | \"injectFooter\"\n  | \"redoc\"\n  | \"resolve\"\n  | \"runFooter\"\n  | \"legacyCallbackWarnings\"\n  | \"logger\"\n  | \"fix\"\n>;\n\nfunction sourceCwd(options: GeneratorOptions): URL {\n  return options.cwd instanceof URL\n    ? options.cwd\n    : new URL(`file://${options.cwd ?? process.cwd()}/`);\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(notice);\n  }\n  return [...resolveOutputFixes(names)];\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  withStackOverflowReported(\"transform\", () => warnUnsupportedFeatures(schema, logger));\n  const ctx: GlobalContext = {\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        fixesValueConflicts: fix.includes(OutputFix.DISCRIMINATOR_VALUES),\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":["pathToFileURL","path","fileURLToPath","outputFixNamesOf","ineffectiveFixNotices","resolveOutputFixes","sourceEmptyError","withStackOverflowReported","warnUnsupportedFeatures","findDiscriminators","OutputFix","resolveDocumentRef"],"mappings":"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"}

package/dist/api/document-run.mjs

@@ -0,0 +1,101 @@
+import path from 'node:path';
+import { pathToFileURL, fileURLToPath } from 'node:url';
+import { sourceEmptyError } from '../adapters/redocly-loader/schema-load-errors.mjs';
+import { withStackOverflowReported } from '../application/stack-overflow.mjs';
+import { OutputFix, outputFixNamesOf, ineffectiveFixNotices, resolveOutputFixes } from '../domain/output-fixes.mjs';
+import { findDiscriminators } from './discriminator-scan.mjs';
+import { resolveDocumentRef } from './document-refs.mjs';
+import { warnUnsupportedFeatures } from './unsupported-feature-warnings.mjs';
+
+function sourceCwd(options) {
+  return options.cwd instanceof URL ? options.cwd : new URL(`file://${options.cwd ?? process.cwd()}/`);
+}
+function refAccessOf(options, cwd) {
+  const { localRefRoot, remoteRefHosts } = options;
+  const localRoot = typeof localRefRoot === "string" ? pathToFileURL(path.resolve(fileURLToPath(cwd), localRefRoot)) : localRefRoot;
+  return {
+    ...localRoot === void 0 ? {} : { localRoot },
+    ...remoteRefHosts === void 0 ? {} : { remoteHosts: remoteRefHosts }
+  };
+}
+function callbackOptions(options) {
+  return {
+    irCallbacks: options.irCallbacks === true,
+    postTransform: typeof options.postTransform === "function" ? options.postTransform : void 0,
+    transform: typeof options.transform === "function" ? options.transform : void 0,
+    transformProperty: typeof options.transformProperty === "function" ? options.transformProperty : void 0
+  };
+}
+function contextFlags(options) {
+  return {
+    additionalProperties: options.additionalProperties ?? false,
+    alphabetize: options.alphabetize ?? false,
+    arrayLength: options.arrayLength ?? false,
+    binaryAsBlob: options.binaryAsBlob ?? false,
+    defaultNonNullable: options.defaultNonNullable ?? true,
+    emptyObjectsUnknown: options.emptyObjectsUnknown ?? false,
+    enum: options.enum ?? false,
+    enumValues: options.enumValues ?? false,
+    conditionalEnums: options.conditionalEnums ?? false,
+    dedupeEnums: options.dedupeEnums ?? false,
+    excludeDeprecated: options.excludeDeprecated ?? false,
+    exportType: options.exportType ?? false,
+    immutable: options.immutable ?? false,
+    rootTypes: options.rootTypes ?? false,
+    rootTypesNoSchemaPrefix: options.rootTypesNoSchemaPrefix ?? false,
+    rootTypesKeepCasing: options.rootTypesKeepCasing ?? false,
+    pathParamsAsTypes: options.pathParamsAsTypes ?? false,
+    propertiesRequiredByDefault: options.propertiesRequiredByDefault ?? false,
+    silent: options.silent ?? false,
+    ...options.inject === void 0 ? {} : { inject: options.inject },
+    makePathsEnum: options.makePathsEnum ?? false,
+    generatePathParams: options.generatePathParams ?? false,
+    readWriteMarkers: options.readWriteMarkers ?? false,
+    ...callbackOptions(options)
+  };
+}
+function outputFixesOf(options, logger) {
+  const names = outputFixNamesOf(options.fix ?? []);
+  for (const notice of ineffectiveFixNotices(names, (option) => options[option] === true)) {
+    logger.warn(notice);
+  }
+  return [...resolveOutputFixes(names)];
+}
+async function createDocumentRun(source, options, ports) {
+  if (!source) {
+    throw sourceEmptyError("Empty schema. Please specify a URL, file path, or Redocly Config");
+  }
+  const { logger } = ports;
+  const fix = outputFixesOf(options, logger);
+  const silent = options.silent ?? false;
+  const cwd = sourceCwd(options);
+  const schema = await ports.loader.load({
+    source,
+    cwd,
+    shouldLint: options.lint ?? true,
+    refAccess: refAccessOf(options, cwd)
+  });
+  withStackOverflowReported("transform", () => warnUnsupportedFeatures(schema, logger));
+  const ctx = {
+    ...contextFlags(options),
+    fix,
+    // The scan walks every schema before the transform does, so on a larger stack, where loading
+    // passed, it is the first step to run out.
+    discriminators: withStackOverflowReported(
+      "transform",
+      () => findDiscriminators(schema, {
+        silent,
+        logger,
+        fixesValueConflicts: fix.includes(OutputFix.DISCRIMINATOR_VALUES)
+      })
+    ),
+    injectFooter: [],
+    redoc: ports.redoc,
+    resolve: ($ref) => resolveDocumentRef(schema, $ref, { silent, logger }),
+    logger
+  };
+  return { schema, ctx };
+}
+
+export { createDocumentRun };
+//# sourceMappingURL=document-run.mjs.map

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

@@ -0,0 +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  OutputFix,\n  outputFixNamesOf,\n  resolveOutputFixes,\n} from \"../domain/output-fixes.js\";\nimport type { GeneratorOptions, GlobalContext, OpenAPI3, SchemaSource } from \"../types.js\";\nimport { findDiscriminators } from \"./discriminator-scan.js\";\nimport { resolveDocumentRef } from \"./document-refs.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: GlobalContext;\n}\n\n/** The context fields that are user flags, with the original defaults. */\ntype ContextFlags = Omit<\n  GlobalContext,\n  | \"discriminators\"\n  | \"injectFooter\"\n  | \"redoc\"\n  | \"resolve\"\n  | \"runFooter\"\n  | \"legacyCallbackWarnings\"\n  | \"logger\"\n  | \"fix\"\n>;\n\nfunction sourceCwd(options: GeneratorOptions): URL {\n  return options.cwd instanceof URL\n    ? options.cwd\n    : new URL(`file://${options.cwd ?? process.cwd()}/`);\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(notice);\n  }\n  return [...resolveOutputFixes(names)];\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  withStackOverflowReported(\"transform\", () => warnUnsupportedFeatures(schema, logger));\n  const ctx: GlobalContext = {\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        fixesValueConflicts: fix.includes(OutputFix.DISCRIMINATOR_VALUES),\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":"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"}

package/dist/api/footer-entry.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+const footerNodes = require('../adapters/type-ast-bridge/footer-nodes.cjs');
+const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs');
+
+function isIrDeclaration(entry) {
+  return typeof entry.kind === "string";
+}
+function declaresTypeAlias(entry, name) {
+  if (!isIrDeclaration(entry)) {
+    return footerNodes.isTypeAliasNamed(loadTypescript.loadTypeScript(), entry, name);
+  }
+  return (entry.kind === "typeAlias" || entry.kind === "rawDeclaration") && entry.name === name;
+}
+
+exports.declaresTypeAlias = declaresTypeAlias;
+exports.isIrDeclaration = isIrDeclaration;
+//# sourceMappingURL=footer-entry.cjs.map

package/dist/api/footer-entry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-entry.cjs","sources":["../../src/api/footer-entry.ts"],"sourcesContent":["import { isTypeAliasNamed } from \"../adapters/type-ast-bridge/footer-nodes.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\n\n/** A footer entry: a declaration in IR, or a TypeScript node added by user code. */\nexport type FooterEntry = IrDeclaration | ts.Node;\n\n/** IR nodes have a string `kind`; TypeScript nodes have a numeric `SyntaxKind`. */\nexport function isIrDeclaration(entry: FooterEntry): entry is IrDeclaration {\n  return typeof entry.kind === \"string\";\n}\n\n/**\n * Whether the entry declares a type alias with this name: an IR type alias, a named raw\n * declaration (the helper types), or a user's TypeScript type alias. Helpers are added once.\n */\nexport function declaresTypeAlias(entry: FooterEntry, name: string): boolean {\n  if (!isIrDeclaration(entry)) {\n    return isTypeAliasNamed(loadTypeScript(), entry, name);\n  }\n  return (entry.kind === \"typeAlias\" || entry.kind === \"rawDeclaration\") && entry.name === name;\n}\n"],"names":["isTypeAliasNamed","loadTypeScript"],"mappings":";;;;;AASO,SAAS,gBAAgB,KAAA,EAA4C;AAC1E,EAAA,OAAO,OAAO,MAAM,IAAA,KAAS,QAAA;AAC/B;AAMO,SAAS,iBAAA,CAAkB,OAAoB,IAAA,EAAuB;AAC3E,EAAA,IAAI,CAAC,eAAA,CAAgB,KAAK,CAAA,EAAG;AAC3B,IAAA,OAAOA,4BAAA,CAAiBC,6BAAA,EAAe,EAAG,KAAA,EAAO,IAAI,CAAA;AAAA,EACvD;AACA,EAAA,OAAA,CAAQ,MAAM,IAAA,KAAS,WAAA,IAAe,MAAM,IAAA,KAAS,gBAAA,KAAqB,MAAM,IAAA,KAAS,IAAA;AAC3F;;;"}

package/dist/api/footer-entry.mjs

@@ -0,0 +1,15 @@
+import { isTypeAliasNamed } from '../adapters/type-ast-bridge/footer-nodes.mjs';
+import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs';
+
+function isIrDeclaration(entry) {
+  return typeof entry.kind === "string";
+}
+function declaresTypeAlias(entry, name) {
+  if (!isIrDeclaration(entry)) {
+    return isTypeAliasNamed(loadTypeScript(), entry, name);
+  }
+  return (entry.kind === "typeAlias" || entry.kind === "rawDeclaration") && entry.name === name;
+}
+
+export { declaresTypeAlias, isIrDeclaration };
+//# sourceMappingURL=footer-entry.mjs.map

package/dist/api/footer-entry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-entry.mjs","sources":["../../src/api/footer-entry.ts"],"sourcesContent":["import { isTypeAliasNamed } from \"../adapters/type-ast-bridge/footer-nodes.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { ts } from \"../adapters/type-ast-bridge/typescript-types.js\";\nimport type { IrDeclaration } from \"../domain/ir/nodes.js\";\n\n/** A footer entry: a declaration in IR, or a TypeScript node added by user code. */\nexport type FooterEntry = IrDeclaration | ts.Node;\n\n/** IR nodes have a string `kind`; TypeScript nodes have a numeric `SyntaxKind`. */\nexport function isIrDeclaration(entry: FooterEntry): entry is IrDeclaration {\n  return typeof entry.kind === \"string\";\n}\n\n/**\n * Whether the entry declares a type alias with this name: an IR type alias, a named raw\n * declaration (the helper types), or a user's TypeScript type alias. Helpers are added once.\n */\nexport function declaresTypeAlias(entry: FooterEntry, name: string): boolean {\n  if (!isIrDeclaration(entry)) {\n    return isTypeAliasNamed(loadTypeScript(), entry, name);\n  }\n  return (entry.kind === \"typeAlias\" || entry.kind === \"rawDeclaration\") && entry.name === name;\n}\n"],"names":[],"mappings":";;;AASO,SAAS,gBAAgB,KAAA,EAA4C;AAC1E,EAAA,OAAO,OAAO,MAAM,IAAA,KAAS,QAAA;AAC/B;AAMO,SAAS,iBAAA,CAAkB,OAAoB,IAAA,EAAuB;AAC3E,EAAA,IAAI,CAAC,eAAA,CAAgB,KAAK,CAAA,EAAG;AAC3B,IAAA,OAAO,gBAAA,CAAiB,cAAA,EAAe,EAAG,KAAA,EAAO,IAAI,CAAA;AAAA,EACvD;AACA,EAAA,OAAA,CAAQ,MAAM,IAAA,KAAS,WAAA,IAAe,MAAM,IAAA,KAAS,gBAAA,KAAqB,MAAM,IAAA,KAAS,IAAA;AAC3F;;"}

package/dist/api/footer-sink.cjs

@@ -0,0 +1,53 @@
+'use strict';
+
+const footerNodes = require('../adapters/type-ast-bridge/footer-nodes.cjs');
+const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs');
+const footerEntry = require('./footer-entry.cjs');
+
+const OPERATIONS_NAME = "operations";
+class ContextFooterSink {
+  footer;
+  constructor(footer) {
+    this.footer = footer;
+  }
+  hasTypeAlias(name) {
+    return this.footer.some((entry) => footerEntry.declaresTypeAlias(entry, name));
+  }
+  add(declaration) {
+    this.footer.push(declaration);
+  }
+  /**
+   * Add a member to the `operations` interface, declared first (exported) when missing, so it
+   * comes before any declaration `build` adds. A user's TypeScript `operations` interface gets
+   * the member in place, as in the original.
+   */
+  addOperation(build) {
+    const existing = this.findOperations();
+    if (existing !== null && !footerEntry.isIrDeclaration(existing.entry)) {
+      const ts = loadTypescript.loadTypeScript();
+      const node = footerNodes.asInterfaceNamed(ts, existing.entry, OPERATIONS_NAME);
+      if (node) {
+        footerNodes.appendMember(ts, node, build());
+      }
+      return;
+    }
+    const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;
+    const member = build();
+    const operations = this.footer[index];
+    this.footer[index] = { ...operations, members: [...operations.members, member] };
+  }
+  /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */
+  findOperations() {
+    const index = this.footer.findIndex(
+      (entry2) => footerEntry.isIrDeclaration(entry2) ? entry2.kind === "interface" && entry2.name === OPERATIONS_NAME : footerNodes.asInterfaceNamed(loadTypescript.loadTypeScript(), entry2, OPERATIONS_NAME) !== null
+    );
+    const entry = this.footer[index];
+    return entry === void 0 ? null : { entry, index };
+  }
+}
+function emptyOperations() {
+  return { kind: "interface", name: OPERATIONS_NAME, isExported: true, members: [], comments: [] };
+}
+
+exports.ContextFooterSink = ContextFooterSink;
+//# sourceMappingURL=footer-sink.cjs.map

package/dist/api/footer-sink.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-sink.cjs","sources":["../../src/api/footer-sink.ts"],"sourcesContent":["import { appendMember, asInterfaceNamed } from \"../adapters/type-ast-bridge/footer-nodes.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { FooterSink } from \"../application/transform/footer/document-footer.js\";\nimport type {\n  IrDeclaration,\n  IrInterfaceDeclaration,\n  IrPropertySignature,\n} from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/**\n * The footer of a run is its `ctx.injectFooter` list. The generator adds IR declarations; user\n * code may add IR declarations or TypeScript nodes (ENGINEERING_PLAN 6.2).\n */\nexport class ContextFooterSink implements FooterSink {\n  private readonly footer: FooterEntry[];\n\n  constructor(footer: FooterEntry[]) {\n    this.footer = footer;\n  }\n\n  hasTypeAlias(name: string): boolean {\n    return this.footer.some((entry) => declaresTypeAlias(entry, name));\n  }\n\n  add(declaration: IrDeclaration): void {\n    this.footer.push(declaration);\n  }\n\n  /**\n   * Add a member to the `operations` interface, declared first (exported) when missing, so it\n   * comes before any declaration `build` adds. A user's TypeScript `operations` interface gets\n   * the member in place, as in the original.\n   */\n  addOperation(build: () => IrPropertySignature): void {\n    const existing = this.findOperations();\n    if (existing !== null && !isIrDeclaration(existing.entry)) {\n      const ts = loadTypeScript();\n      const node = asInterfaceNamed(ts, existing.entry, OPERATIONS_NAME);\n      if (node) {\n        appendMember(ts, node, build());\n      }\n      return;\n    }\n    const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;\n    const member = build();\n    const operations = this.footer[index] as IrInterfaceDeclaration;\n    this.footer[index] = { ...operations, members: [...operations.members, member] };\n  }\n\n  /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */\n  private findOperations(): { entry: FooterEntry; index: number } | null {\n    const index = this.footer.findIndex((entry) =>\n      isIrDeclaration(entry)\n        ? entry.kind === \"interface\" && entry.name === OPERATIONS_NAME\n        : asInterfaceNamed(loadTypeScript(), entry, OPERATIONS_NAME) !== null,\n    );\n    const entry = this.footer[index];\n    return entry === undefined ? null : { entry, index };\n  }\n}\n\nfunction emptyOperations(): IrInterfaceDeclaration {\n  return { kind: \"interface\", name: OPERATIONS_NAME, isExported: true, members: [], comments: [] };\n}\n"],"names":["declaresTypeAlias","isIrDeclaration","loadTypeScript","asInterfaceNamed","appendMember","entry"],"mappings":";;;;;;AAUA,MAAM,eAAA,GAAkB,YAAA;AAMjB,MAAM,iBAAA,CAAwC;AAAA,EAClC,MAAA;AAAA,EAEjB,YAAY,MAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA,EAEA,aAAa,IAAA,EAAuB;AAClC,IAAA,OAAO,IAAA,CAAK,OAAO,IAAA,CAAK,CAAC,UAAUA,6BAAA,CAAkB,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,EACnE;AAAA,EAEA,IAAI,WAAA,EAAkC;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,WAAW,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAAA,EAAwC;AACnD,IAAA,MAAM,QAAA,GAAW,KAAK,cAAA,EAAe;AACrC,IAAA,IAAI,aAAa,IAAA,IAAQ,CAACC,2BAAA,CAAgB,QAAA,CAAS,KAAK,CAAA,EAAG;AACzD,MAAA,MAAM,KAAKC,6BAAA,EAAe;AAC1B,MAAA,MAAM,IAAA,GAAOC,4BAAA,CAAiB,EAAA,EAAI,QAAA,CAAS,OAAO,eAAe,CAAA;AACjE,MAAA,IAAI,IAAA,EAAM;AACR,QAAAC,wBAAA,CAAa,EAAA,EAAI,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,MAChC;AACA,MAAA;AAAA,IACF;AACA,IAAA,MAAM,KAAA,GAAQ,UAAU,KAAA,IAAS,IAAA,CAAK,OAAO,IAAA,CAAK,eAAA,EAAiB,CAAA,GAAI,CAAA;AACvE,IAAA,MAAM,SAAS,KAAA,EAAM;AACrB,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA,GAAI,EAAE,GAAG,UAAA,EAAY,OAAA,EAAS,CAAC,GAAG,UAAA,CAAW,OAAA,EAAS,MAAM,CAAA,EAAE;AAAA,EACjF;AAAA;AAAA,EAGQ,cAAA,GAA+D;AACrE,IAAA,MAAM,KAAA,GAAQ,KAAK,MAAA,CAAO,SAAA;AAAA,MAAU,CAACC,MAAAA,KACnCJ,2BAAA,CAAgBI,MAAK,CAAA,GACjBA,OAAM,IAAA,KAAS,WAAA,IAAeA,MAAAA,CAAM,IAAA,KAAS,kBAC7CF,4BAAA,CAAiBD,6BAAA,EAAe,EAAGG,MAAAA,EAAO,eAAe,CAAA,KAAM;AAAA,KACrE;AACA,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AAC/B,IAAA,OAAO,KAAA,KAAU,MAAA,GAAY,IAAA,GAAO,EAAE,OAAO,KAAA,EAAM;AAAA,EACrD;AACF;AAEA,SAAS,eAAA,GAA0C;AACjD,EAAA,OAAO,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,eAAA,EAAiB,UAAA,EAAY,IAAA,EAAM,OAAA,EAAS,EAAC,EAAG,QAAA,EAAU,EAAC,EAAE;AACjG;;"}

package/dist/api/footer-sink.mjs

@@ -0,0 +1,51 @@
+import { asInterfaceNamed, appendMember } from '../adapters/type-ast-bridge/footer-nodes.mjs';
+import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs';
+import { declaresTypeAlias, isIrDeclaration } from './footer-entry.mjs';
+
+const OPERATIONS_NAME = "operations";
+class ContextFooterSink {
+  footer;
+  constructor(footer) {
+    this.footer = footer;
+  }
+  hasTypeAlias(name) {
+    return this.footer.some((entry) => declaresTypeAlias(entry, name));
+  }
+  add(declaration) {
+    this.footer.push(declaration);
+  }
+  /**
+   * Add a member to the `operations` interface, declared first (exported) when missing, so it
+   * comes before any declaration `build` adds. A user's TypeScript `operations` interface gets
+   * the member in place, as in the original.
+   */
+  addOperation(build) {
+    const existing = this.findOperations();
+    if (existing !== null && !isIrDeclaration(existing.entry)) {
+      const ts = loadTypeScript();
+      const node = asInterfaceNamed(ts, existing.entry, OPERATIONS_NAME);
+      if (node) {
+        appendMember(ts, node, build());
+      }
+      return;
+    }
+    const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;
+    const member = build();
+    const operations = this.footer[index];
+    this.footer[index] = { ...operations, members: [...operations.members, member] };
+  }
+  /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */
+  findOperations() {
+    const index = this.footer.findIndex(
+      (entry2) => isIrDeclaration(entry2) ? entry2.kind === "interface" && entry2.name === OPERATIONS_NAME : asInterfaceNamed(loadTypeScript(), entry2, OPERATIONS_NAME) !== null
+    );
+    const entry = this.footer[index];
+    return entry === void 0 ? null : { entry, index };
+  }
+}
+function emptyOperations() {
+  return { kind: "interface", name: OPERATIONS_NAME, isExported: true, members: [], comments: [] };
+}
+
+export { ContextFooterSink };
+//# sourceMappingURL=footer-sink.mjs.map

package/dist/api/footer-sink.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-sink.mjs","sources":["../../src/api/footer-sink.ts"],"sourcesContent":["import { appendMember, asInterfaceNamed } from \"../adapters/type-ast-bridge/footer-nodes.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport type { FooterSink } from \"../application/transform/footer/document-footer.js\";\nimport type {\n  IrDeclaration,\n  IrInterfaceDeclaration,\n  IrPropertySignature,\n} from \"../domain/ir/nodes.js\";\nimport { declaresTypeAlias, type FooterEntry, isIrDeclaration } from \"./footer-entry.js\";\n\nconst OPERATIONS_NAME = \"operations\";\n\n/**\n * The footer of a run is its `ctx.injectFooter` list. The generator adds IR declarations; user\n * code may add IR declarations or TypeScript nodes (ENGINEERING_PLAN 6.2).\n */\nexport class ContextFooterSink implements FooterSink {\n  private readonly footer: FooterEntry[];\n\n  constructor(footer: FooterEntry[]) {\n    this.footer = footer;\n  }\n\n  hasTypeAlias(name: string): boolean {\n    return this.footer.some((entry) => declaresTypeAlias(entry, name));\n  }\n\n  add(declaration: IrDeclaration): void {\n    this.footer.push(declaration);\n  }\n\n  /**\n   * Add a member to the `operations` interface, declared first (exported) when missing, so it\n   * comes before any declaration `build` adds. A user's TypeScript `operations` interface gets\n   * the member in place, as in the original.\n   */\n  addOperation(build: () => IrPropertySignature): void {\n    const existing = this.findOperations();\n    if (existing !== null && !isIrDeclaration(existing.entry)) {\n      const ts = loadTypeScript();\n      const node = asInterfaceNamed(ts, existing.entry, OPERATIONS_NAME);\n      if (node) {\n        appendMember(ts, node, build());\n      }\n      return;\n    }\n    const index = existing?.index ?? this.footer.push(emptyOperations()) - 1;\n    const member = build();\n    const operations = this.footer[index] as IrInterfaceDeclaration;\n    this.footer[index] = { ...operations, members: [...operations.members, member] };\n  }\n\n  /** The first `operations` interface: the generator's (IR) or a user's (TypeScript). */\n  private findOperations(): { entry: FooterEntry; index: number } | null {\n    const index = this.footer.findIndex((entry) =>\n      isIrDeclaration(entry)\n        ? entry.kind === \"interface\" && entry.name === OPERATIONS_NAME\n        : asInterfaceNamed(loadTypeScript(), entry, OPERATIONS_NAME) !== null,\n    );\n    const entry = this.footer[index];\n    return entry === undefined ? null : { entry, index };\n  }\n}\n\nfunction emptyOperations(): IrInterfaceDeclaration {\n  return { kind: \"interface\", name: OPERATIONS_NAME, isExported: true, members: [], comments: [] };\n}\n"],"names":["entry"],"mappings":";;;;AAUA,MAAM,eAAA,GAAkB,YAAA;AAMjB,MAAM,iBAAA,CAAwC;AAAA,EAClC,MAAA;AAAA,EAEjB,YAAY,MAAA,EAAuB;AACjC,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,EAChB;AAAA,EAEA,aAAa,IAAA,EAAuB;AAClC,IAAA,OAAO,IAAA,CAAK,OAAO,IAAA,CAAK,CAAC,UAAU,iBAAA,CAAkB,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,EACnE;AAAA,EAEA,IAAI,WAAA,EAAkC;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,WAAW,CAAA;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAAA,EAAwC;AACnD,IAAA,MAAM,QAAA,GAAW,KAAK,cAAA,EAAe;AACrC,IAAA,IAAI,aAAa,IAAA,IAAQ,CAAC,eAAA,CAAgB,QAAA,CAAS,KAAK,CAAA,EAAG;AACzD,MAAA,MAAM,KAAK,cAAA,EAAe;AAC1B,MAAA,MAAM,IAAA,GAAO,gBAAA,CAAiB,EAAA,EAAI,QAAA,CAAS,OAAO,eAAe,CAAA;AACjE,MAAA,IAAI,IAAA,EAAM;AACR,QAAA,YAAA,CAAa,EAAA,EAAI,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,MAChC;AACA,MAAA;AAAA,IACF;AACA,IAAA,MAAM,KAAA,GAAQ,UAAU,KAAA,IAAS,IAAA,CAAK,OAAO,IAAA,CAAK,eAAA,EAAiB,CAAA,GAAI,CAAA;AACvE,IAAA,MAAM,SAAS,KAAA,EAAM;AACrB,IAAA,MAAM,UAAA,GAAa,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AACpC,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA,GAAI,EAAE,GAAG,UAAA,EAAY,OAAA,EAAS,CAAC,GAAG,UAAA,CAAW,OAAA,EAAS,MAAM,CAAA,EAAE;AAAA,EACjF;AAAA;AAAA,EAGQ,cAAA,GAA+D;AACrE,IAAA,MAAM,KAAA,GAAQ,KAAK,MAAA,CAAO,SAAA;AAAA,MAAU,CAACA,MAAAA,KACnC,eAAA,CAAgBA,MAAK,CAAA,GACjBA,OAAM,IAAA,KAAS,WAAA,IAAeA,MAAAA,CAAM,IAAA,KAAS,kBAC7C,gBAAA,CAAiB,cAAA,EAAe,EAAGA,MAAAA,EAAO,eAAe,CAAA,KAAM;AAAA,KACrE;AACA,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,MAAA,CAAO,KAAK,CAAA;AAC/B,IAAA,OAAO,KAAA,KAAU,MAAA,GAAY,IAAA,GAAO,EAAE,OAAO,KAAA,EAAM;AAAA,EACrD;AACF;AAEA,SAAS,eAAA,GAA0C;AACjD,EAAA,OAAO,EAAE,IAAA,EAAM,WAAA,EAAa,IAAA,EAAM,eAAA,EAAiB,UAAA,EAAY,IAAA,EAAM,OAAA,EAAS,EAAC,EAAG,QAAA,EAAU,EAAC,EAAE;AACjG;;"}

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

@@ -0,0 +1,25 @@
+'use strict';
+
+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";
+const USES = {
+  transform: "`transform` returned a TypeScript node",
+  postTransform: "`postTransform` receives TypeScript nodes",
+  transformProperty: "`transformProperty` receives TypeScript nodes"
+};
+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}`;
+}
+function warnLegacyCallback(ctx, name) {
+  ctx.legacyCallbackWarnings ??= /* @__PURE__ */ new Set();
+  if (ctx.legacyCallbackWarnings.has(name)) {
+    return;
+  }
+  ctx.legacyCallbackWarnings.add(name);
+  (ctx.logger ?? defaultPorts.defaultLogger(ctx.silent)).warn(message(name));
+}
+
+exports.IR_CALLBACKS_GUIDE_URL = IR_CALLBACKS_GUIDE_URL;
+exports.warnLegacyCallback = warnLegacyCallback;
+//# sourceMappingURL=legacy-callback-warning.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-callback-warning.cjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import type { GlobalContext, LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.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: GlobalContext, 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(message(name));\n}\n"],"names":["defaultLogger"],"mappings":";;;;AAIO,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,KAAoB,IAAA,EAAgC;AACrF,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,UAAUA,0BAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAC,CAAA;AAC9D;;;"}

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

@@ -0,0 +1,22 @@
+import { defaultLogger } 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 = {
+  transform: "`transform` returned a TypeScript node",
+  postTransform: "`postTransform` receives TypeScript nodes",
+  transformProperty: "`transformProperty` receives TypeScript nodes"
+};
+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}`;
+}
+function warnLegacyCallback(ctx, name) {
+  ctx.legacyCallbackWarnings ??= /* @__PURE__ */ new Set();
+  if (ctx.legacyCallbackWarnings.has(name)) {
+    return;
+  }
+  ctx.legacyCallbackWarnings.add(name);
+  (ctx.logger ?? defaultLogger(ctx.silent)).warn(message(name));
+}
+
+export { IR_CALLBACKS_GUIDE_URL, warnLegacyCallback };
+//# sourceMappingURL=legacy-callback-warning.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-callback-warning.mjs","sources":["../../src/api/legacy-callback-warning.ts"],"sourcesContent":["import type { GlobalContext, LegacyCallbackName } from \"../types.js\";\nimport { defaultLogger } from \"./default-ports.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: GlobalContext, 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(message(name));\n}\n"],"names":[],"mappings":";;AAIO,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,KAAoB,IAAA,EAAgC;AACrF,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,UAAU,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAC,CAAA;AAC9D;;"}