openapi-typesafe 0.0.0 → 1.0.0-rc.1

package/dist/api/openapi-ts.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const redoclySchemaLoader = require('../adapters/redocly-loader/redocly-schema-loader.cjs');
+const stackOverflow = require('../application/stack-overflow.cjs');
+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);
+  const startedAt = ports.now();
+  const result = stackOverflow.withStackOverflowReported("transform", () => transformSchema.default(schema, ctx));
+  ports.logger.debug(
+    "Completed AST transformation for entire document",
+    "ts",
+    ports.now() - startedAt
+  );
+  return result;
+}
+async function defaultGeneratorPorts(options) {
+  const logger = defaultPorts.defaultLogger(options.silent ?? false);
+  const redoc = options.redocly ?? await defaultPorts.defaultRedoclyConfig();
+  const loader = redoclySchemaLoader.createRedoclySchemaLoader({
+    redoc,
+    logger,
+    now: defaultPorts.monotonicNow,
+    remoteRefTimeoutMs: defaultPorts.REMOTE_REF_TIMEOUT_MS
+  });
+  return { loader, logger, redoc, now: defaultPorts.monotonicNow };
+}
+async function openapiTS(source, options = {}) {
+  return generateDeclarations(source, options, await defaultGeneratorPorts(options));
+}
+
+exports.default = openapiTS;
+exports.defaultGeneratorPorts = defaultGeneratorPorts;
+exports.generateDeclarations = generateDeclarations;
+//# sourceMappingURL=openapi-ts.cjs.map

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

@@ -0,0 +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  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  });\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"],"mappings":";;;;;;;;;;AAmBA,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;AAAA,GACrB,CAAA;AACD,EAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAKD,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;;;;"}

package/dist/api/openapi-ts.mjs

@@ -0,0 +1,34 @@
+import { createRedoclySchemaLoader } from '../adapters/redocly-loader/redocly-schema-loader.mjs';
+import { withStackOverflowReported } from '../application/stack-overflow.mjs';
+import { defaultLogger, defaultRedoclyConfig, monotonicNow, 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);
+  const startedAt = ports.now();
+  const result = withStackOverflowReported("transform", () => transformSchema(schema, ctx));
+  ports.logger.debug(
+    "Completed AST transformation for entire document",
+    "ts",
+    ports.now() - startedAt
+  );
+  return result;
+}
+async function defaultGeneratorPorts(options) {
+  const logger = defaultLogger(options.silent ?? false);
+  const redoc = options.redocly ?? await defaultRedoclyConfig();
+  const loader = createRedoclySchemaLoader({
+    redoc,
+    logger,
+    now: monotonicNow,
+    remoteRefTimeoutMs: REMOTE_REF_TIMEOUT_MS
+  });
+  return { loader, logger, redoc, now: monotonicNow };
+}
+async function openapiTS(source, options = {}) {
+  return generateDeclarations(source, options, await defaultGeneratorPorts(options));
+}
+
+export { openapiTS as default, defaultGeneratorPorts, generateDeclarations };
+//# sourceMappingURL=openapi-ts.mjs.map

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

@@ -0,0 +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  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  });\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":";;;;;;AAmBA,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;AAAA,GACrB,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;;"}

package/dist/api/path-template-warnings.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+const pathTemplates = require('../domain/openapi/path-templates.cjs');
+const warnings = require('../domain/warnings.cjs');
+
+const DOCS_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes";
+const SPEC_RULE = "OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical";
+function quotedList(urls) {
+  const quoted = urls.map((url) => `"${url}"`);
+  const last = quoted.pop();
+  return quoted.length === 0 ? last ?? "" : `${quoted.join(", ")} and ${last}`;
+}
+function warnIdenticalPathTemplates(document, logger) {
+  for (const urls of pathTemplates.findIdenticalPathTemplates(document)) {
+    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;
+    logger.warn(warnings.warningText(`${message}. See ${DOCS_URL}`, warnings.WARNING_CODES.PATH_TEMPLATES_IDENTICAL));
+  }
+}
+
+exports.warnIdenticalPathTemplates = warnIdenticalPathTemplates;
+//# sourceMappingURL=path-template-warnings.cjs.map

package/dist/api/path-template-warnings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-warnings.cjs","sources":["../../src/api/path-template-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport { findIdenticalPathTemplates } from \"../domain/openapi/path-templates.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\n\nconst DOCS_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes\";\nconst SPEC_RULE =\n  \"OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but \" +\n  \"different templated names MUST NOT exist as they are identical\";\n\n/** `\"/a\"`, `\"/a\" and \"/b\"`, `\"/a\", \"/b\" and \"/c\"`. */\nfunction quotedList(urls: readonly string[]): string {\n  const quoted = urls.map((url) => `\"${url}\"`);\n  const last = quoted.pop();\n  return quoted.length === 0 ? (last ?? \"\") : `${quoted.join(\", \")} and ${last}`;\n}\n\n/**\n * Warn once per group of paths that differ only in parameter names, which the spec forbids: a URL\n * cannot tell them apart, and `--path-params-as-types` gives them the same key type.\n */\nexport function warnIdenticalPathTemplates(document: unknown, logger: Logger): void {\n  for (const urls of findIdenticalPathTemplates(document)) {\n    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;\n    logger.warn(warningText(`${message}. See ${DOCS_URL}`, WARNING_CODES.PATH_TEMPLATES_IDENTICAL));\n  }\n}\n"],"names":["findIdenticalPathTemplates","warningText","WARNING_CODES"],"mappings":";;;;;AAIA,MAAM,QAAA,GACJ,8FAAA;AACF,MAAM,SAAA,GACJ,wJAAA;AAIF,SAAS,WAAW,IAAA,EAAiC;AACnD,EAAA,MAAM,SAAS,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,CAAG,CAAA;AAC3C,EAAA,MAAM,IAAA,GAAO,OAAO,GAAA,EAAI;AACxB,EAAA,OAAO,MAAA,CAAO,MAAA,KAAW,CAAA,GAAK,IAAA,IAAQ,EAAA,GAAM,CAAA,EAAG,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA;AAC9E;AAMO,SAAS,0BAAA,CAA2B,UAAmB,MAAA,EAAsB;AAClF,EAAA,KAAA,MAAW,IAAA,IAAQA,wCAAA,CAA2B,QAAQ,CAAA,EAAG;AACvD,IAAA,MAAM,UAAU,CAAA,MAAA,EAAS,UAAA,CAAW,IAAI,CAAC,0CAA0C,SAAS,CAAA,CAAA;AAC5F,IAAA,MAAA,CAAO,IAAA,CAAKC,qBAAY,CAAA,EAAG,OAAO,SAAS,QAAQ,CAAA,CAAA,EAAIC,sBAAA,CAAc,wBAAwB,CAAC,CAAA;AAAA,EAChG;AACF;;"}

package/dist/api/path-template-warnings.mjs

@@ -0,0 +1,19 @@
+import { findIdenticalPathTemplates } from '../domain/openapi/path-templates.mjs';
+import { warningText, WARNING_CODES } from '../domain/warnings.mjs';
+
+const DOCS_URL = "https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes";
+const SPEC_RULE = "OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but different templated names MUST NOT exist as they are identical";
+function quotedList(urls) {
+  const quoted = urls.map((url) => `"${url}"`);
+  const last = quoted.pop();
+  return quoted.length === 0 ? last ?? "" : `${quoted.join(", ")} and ${last}`;
+}
+function warnIdenticalPathTemplates(document, logger) {
+  for (const urls of findIdenticalPathTemplates(document)) {
+    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;
+    logger.warn(warningText(`${message}. See ${DOCS_URL}`, WARNING_CODES.PATH_TEMPLATES_IDENTICAL));
+  }
+}
+
+export { warnIdenticalPathTemplates };
+//# sourceMappingURL=path-template-warnings.mjs.map

package/dist/api/path-template-warnings.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-template-warnings.mjs","sources":["../../src/api/path-template-warnings.ts"],"sourcesContent":["import type { Logger } from \"../application/ports/logger.js\";\nimport { findIdenticalPathTemplates } from \"../domain/openapi/path-templates.js\";\nimport { WARNING_CODES, warningText } from \"../domain/warnings.js\";\n\nconst DOCS_URL =\n  \"https://github.com/openapi-typesafe/openapi-typesafe/blob/main/docs/cli.md#pathparamsastypes\";\nconst SPEC_RULE =\n  \"OpenAPI does not allow this (Paths Object): templated paths with the same hierarchy but \" +\n  \"different templated names MUST NOT exist as they are identical\";\n\n/** `\"/a\"`, `\"/a\" and \"/b\"`, `\"/a\", \"/b\" and \"/c\"`. */\nfunction quotedList(urls: readonly string[]): string {\n  const quoted = urls.map((url) => `\"${url}\"`);\n  const last = quoted.pop();\n  return quoted.length === 0 ? (last ?? \"\") : `${quoted.join(\", \")} and ${last}`;\n}\n\n/**\n * Warn once per group of paths that differ only in parameter names, which the spec forbids: a URL\n * cannot tell them apart, and `--path-params-as-types` gives them the same key type.\n */\nexport function warnIdenticalPathTemplates(document: unknown, logger: Logger): void {\n  for (const urls of findIdenticalPathTemplates(document)) {\n    const message = `Paths ${quotedList(urls)} differ only in their parameter names. ${SPEC_RULE}`;\n    logger.warn(warningText(`${message}. See ${DOCS_URL}`, WARNING_CODES.PATH_TEMPLATES_IDENTICAL));\n  }\n}\n"],"names":[],"mappings":";;;AAIA,MAAM,QAAA,GACJ,8FAAA;AACF,MAAM,SAAA,GACJ,wJAAA;AAIF,SAAS,WAAW,IAAA,EAAiC;AACnD,EAAA,MAAM,SAAS,IAAA,CAAK,GAAA,CAAI,CAAC,GAAA,KAAQ,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,CAAG,CAAA;AAC3C,EAAA,MAAM,IAAA,GAAO,OAAO,GAAA,EAAI;AACxB,EAAA,OAAO,MAAA,CAAO,MAAA,KAAW,CAAA,GAAK,IAAA,IAAQ,EAAA,GAAM,CAAA,EAAG,MAAA,CAAO,IAAA,CAAK,IAAI,CAAC,CAAA,KAAA,EAAQ,IAAI,CAAA,CAAA;AAC9E;AAMO,SAAS,0BAAA,CAA2B,UAAmB,MAAA,EAAsB;AAClF,EAAA,KAAA,MAAW,IAAA,IAAQ,0BAAA,CAA2B,QAAQ,CAAA,EAAG;AACvD,IAAA,MAAM,UAAU,CAAA,MAAA,EAAS,UAAA,CAAW,IAAI,CAAC,0CAA0C,SAAS,CAAA,CAAA;AAC5F,IAAA,MAAA,CAAO,IAAA,CAAK,YAAY,CAAA,EAAG,OAAO,SAAS,QAAQ,CAAA,CAAA,EAAI,aAAA,CAAc,wBAAwB,CAAC,CAAA;AAAA,EAChG;AACF;;"}

package/dist/api/schema-callbacks.cjs

@@ -0,0 +1,140 @@
+'use strict';
+
+const irToTypescript = require('../adapters/type-ast-bridge/ir-to-typescript.cjs');
+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 legacyCallbackWarning = require('./legacy-callback-warning.cjs');
+const typeHelpers = require('./type-helpers.cjs');
+
+class UnreadablePropertyError extends errors.OpenAPITypesafeError {
+  constructor(path) {
+    super({
+      code: errors.ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
+      message: `transformProperty at ${path} returned a property with syntax the generator cannot read`,
+      details: { callback: "transformProperty", path }
+    });
+    this.name = "UnreadablePropertyError";
+  }
+}
+class UnreadableTypeError extends errors.OpenAPITypesafeError {
+  constructor(callback, path) {
+    super({
+      code: errors.ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
+      message: `${callback} at ${path} returned a value that is not a TypeScript node`,
+      details: { callback, path }
+    });
+    this.name = "UnreadableTypeError";
+  }
+}
+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 irCustomType(result) {
+  if (result === void 0 || result === null) {
+    return null;
+  }
+  if (typeof result === "object" && "schema" in result) {
+    return { type: fromCallbackType(result.schema), isOptional: Boolean(result.questionToken) };
+  }
+  return { type: fromCallbackType(result), isOptional: false };
+}
+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,
+    postTransform(type, location) {
+      const result = postTransform?.(type, nodeOptions(ctx, location));
+      return result === void 0 ? null : fromCallbackType(result);
+    },
+    transformProperty: (property, schema, location) => transformProperty?.(property, schema, nodeOptions(ctx, location)) ?? null
+  };
+}
+function readResultType(callback, result, location) {
+  const kind = result.kind;
+  if (typeof kind !== "string" && typeof kind !== "number") {
+    throw new UnreadableTypeError(callback, location.path);
+  }
+  return typeHelpers.toIrType(result);
+}
+function legacyResultType(ctx, type, location) {
+  const result = readResultType("transform", type, location);
+  if (typeof type.kind !== "string") {
+    legacyCallbackWarning.warnLegacyCallback(ctx, "transform");
+  }
+  return result;
+}
+function legacyCustomType(ctx, result, location) {
+  if (!result || typeof result !== "object") {
+    return null;
+  }
+  if ("schema" in result) {
+    return {
+      type: legacyResultType(ctx, result.schema, location),
+      isOptional: Boolean(result.questionToken)
+    };
+  }
+  return { type: legacyResultType(ctx, result, location), isOptional: false };
+}
+function legacySchemaCallbacks(ctx) {
+  const transform = ctx.transform;
+  const postTransform = ctx.postTransform;
+  return {
+    transform: (schema, location) => typeof transform === "function" ? legacyCustomType(
+      ctx,
+      transform(schema, nodeOptions(ctx, location)),
+      location
+    ) : null,
+    postTransform(type, location) {
+      if (typeof postTransform !== "function") {
+        return null;
+      }
+      legacyCallbackWarning.warnLegacyCallback(ctx, "postTransform");
+      const result = postTransform(irToTypescript.toTypeNode(loadTypescript.loadTypeScript(), type), nodeOptions(ctx, location));
+      return result ? readResultType("postTransform", result, location) : null;
+    },
+    transformProperty: (property, schema, location) => legacyTransformProperty(ctx, property, schema, location)
+  };
+}
+function isIrProperty(property) {
+  return typeof property.kind === "string";
+}
+function legacyTransformProperty(ctx, property, schema, location) {
+  const transformProperty = ctx.transformProperty;
+  if (typeof transformProperty !== "function") {
+    return null;
+  }
+  legacyCallbackWarning.warnLegacyCallback(ctx, "transformProperty");
+  const ts = loadTypescript.loadTypeScript();
+  const options = nodeOptions(ctx, location);
+  const result = transformProperty(
+    irToTypescript.toPropertySignature(ts, property),
+    schema,
+    options
+  );
+  if (!result) {
+    return null;
+  }
+  if (isIrProperty(result)) {
+    return result;
+  }
+  const converted = ts.isPropertySignature(result) ? typescriptToIr.fromPropertySignature(ts, result) : null;
+  if (converted === null) {
+    throw new UnreadablePropertyError(location.path);
+  }
+  return converted;
+}
+
+exports.UnreadablePropertyError = UnreadablePropertyError;
+exports.UnreadableTypeError = UnreadableTypeError;
+exports.schemaCallbacks = schemaCallbacks;
+//# sourceMappingURL=schema-callbacks.cjs.map

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

@@ -0,0 +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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"}

package/dist/api/schema-callbacks.mjs

@@ -0,0 +1,136 @@
+import { toTypeNode, toPropertySignature } from '../adapters/type-ast-bridge/ir-to-typescript.mjs';
+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 { warnLegacyCallback } from './legacy-callback-warning.mjs';
+import { toIrType } from './type-helpers.mjs';
+
+class UnreadablePropertyError extends OpenAPITypesafeError {
+  constructor(path) {
+    super({
+      code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
+      message: `transformProperty at ${path} returned a property with syntax the generator cannot read`,
+      details: { callback: "transformProperty", path }
+    });
+    this.name = "UnreadablePropertyError";
+  }
+}
+class UnreadableTypeError extends OpenAPITypesafeError {
+  constructor(callback, path) {
+    super({
+      code: ERROR_CODES.CALLBACK_RESULT_UNREADABLE,
+      message: `${callback} at ${path} returned a value that is not a TypeScript node`,
+      details: { callback, path }
+    });
+    this.name = "UnreadableTypeError";
+  }
+}
+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 irCustomType(result) {
+  if (result === void 0 || result === null) {
+    return null;
+  }
+  if (typeof result === "object" && "schema" in result) {
+    return { type: fromCallbackType(result.schema), isOptional: Boolean(result.questionToken) };
+  }
+  return { type: fromCallbackType(result), isOptional: false };
+}
+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,
+    postTransform(type, location) {
+      const result = postTransform?.(type, nodeOptions(ctx, location));
+      return result === void 0 ? null : fromCallbackType(result);
+    },
+    transformProperty: (property, schema, location) => transformProperty?.(property, schema, nodeOptions(ctx, location)) ?? null
+  };
+}
+function readResultType(callback, result, location) {
+  const kind = result.kind;
+  if (typeof kind !== "string" && typeof kind !== "number") {
+    throw new UnreadableTypeError(callback, location.path);
+  }
+  return toIrType(result);
+}
+function legacyResultType(ctx, type, location) {
+  const result = readResultType("transform", type, location);
+  if (typeof type.kind !== "string") {
+    warnLegacyCallback(ctx, "transform");
+  }
+  return result;
+}
+function legacyCustomType(ctx, result, location) {
+  if (!result || typeof result !== "object") {
+    return null;
+  }
+  if ("schema" in result) {
+    return {
+      type: legacyResultType(ctx, result.schema, location),
+      isOptional: Boolean(result.questionToken)
+    };
+  }
+  return { type: legacyResultType(ctx, result, location), isOptional: false };
+}
+function legacySchemaCallbacks(ctx) {
+  const transform = ctx.transform;
+  const postTransform = ctx.postTransform;
+  return {
+    transform: (schema, location) => typeof transform === "function" ? legacyCustomType(
+      ctx,
+      transform(schema, nodeOptions(ctx, location)),
+      location
+    ) : null,
+    postTransform(type, location) {
+      if (typeof postTransform !== "function") {
+        return null;
+      }
+      warnLegacyCallback(ctx, "postTransform");
+      const result = postTransform(toTypeNode(loadTypeScript(), type), nodeOptions(ctx, location));
+      return result ? readResultType("postTransform", result, location) : null;
+    },
+    transformProperty: (property, schema, location) => legacyTransformProperty(ctx, property, schema, location)
+  };
+}
+function isIrProperty(property) {
+  return typeof property.kind === "string";
+}
+function legacyTransformProperty(ctx, property, schema, location) {
+  const transformProperty = ctx.transformProperty;
+  if (typeof transformProperty !== "function") {
+    return null;
+  }
+  warnLegacyCallback(ctx, "transformProperty");
+  const ts = loadTypeScript();
+  const options = nodeOptions(ctx, location);
+  const result = transformProperty(
+    toPropertySignature(ts, property),
+    schema,
+    options
+  );
+  if (!result) {
+    return null;
+  }
+  if (isIrProperty(result)) {
+    return result;
+  }
+  const converted = ts.isPropertySignature(result) ? fromPropertySignature(ts, result) : null;
+  if (converted === null) {
+    throw new UnreadablePropertyError(location.path);
+  }
+  return converted;
+}
+
+export { UnreadablePropertyError, UnreadableTypeError, schemaCallbacks };
+//# sourceMappingURL=schema-callbacks.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-callbacks.mjs","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":[],"mappings":"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"}

package/dist/api/string-to-ast.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+const node_util = require('node:util');
+const irDeclarationsToTypescript = require('../adapters/type-ast-bridge/ir-declarations-to-typescript.cjs');
+const loadTypescript = require('../adapters/type-ast-bridge/load-typescript.cjs');
+const legacyCallbackWarning = require('./legacy-callback-warning.cjs');
+
+const STRING_TO_AST_DEPRECATION = `stringToAST() is deprecated and removed in 2.0. Return TypeScript type text from an IR callback (irCallbacks: true) instead: ${legacyCallbackWarning.IR_CALLBACKS_GUIDE_URL}`;
+const STRING_TO_AST_DEPRECATION_CODE = "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
+function parseSource(source) {
+  return [...irDeclarationsToTypescript.parseStatements(loadTypescript.loadTypeScript(), source)];
+}
+const stringToAST = node_util.deprecate(
+  parseSource,
+  STRING_TO_AST_DEPRECATION,
+  STRING_TO_AST_DEPRECATION_CODE
+);
+
+exports.STRING_TO_AST_DEPRECATION_CODE = STRING_TO_AST_DEPRECATION_CODE;
+exports.stringToAST = stringToAST;
+//# sourceMappingURL=string-to-ast.cjs.map

package/dist/api/string-to-ast.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-ast.cjs","sources":["../../src/api/string-to-ast.ts"],"sourcesContent":["import { deprecate } from \"node:util\";\nimport { parseStatements } from \"../adapters/type-ast-bridge/ir-declarations-to-typescript.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { IR_CALLBACKS_GUIDE_URL } from \"./legacy-callback-warning.js\";\n\nconst STRING_TO_AST_DEPRECATION =\n  \"stringToAST() is deprecated and removed in 2.0. Return TypeScript type text from an IR \" +\n  `callback (irCallbacks: true) instead: ${IR_CALLBACKS_GUIDE_URL}`;\n\n/** Node's deprecation code for `stringToAST`, so users can filter or trace the warning. */\nexport const STRING_TO_AST_DEPRECATION_CODE = \"OPENAPI_TYPESAFE_DEP_STRING_TO_AST\";\n\nfunction parseSource(source: string): unknown[] {\n  return [...parseStatements(loadTypeScript(), source)];\n}\n\n/**\n * Convert an arbitrary string to TS (assuming it’s valid). Parses with the TypeScript bridge, so\n * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Node's `util.deprecate` warns\n * on the first call only.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 7). Use type text in IR callbacks.\n */\nexport const stringToAST: (source: string) => unknown[] = deprecate(\n  parseSource,\n  STRING_TO_AST_DEPRECATION,\n  STRING_TO_AST_DEPRECATION_CODE,\n);\n"],"names":["IR_CALLBACKS_GUIDE_URL","parseStatements","loadTypeScript","deprecate"],"mappings":";;;;;;;AAKA,MAAM,yBAAA,GACJ,gIACyCA,4CAAsB,CAAA,CAAA;AAG1D,MAAM,8BAAA,GAAiC;AAE9C,SAAS,YAAY,MAAA,EAA2B;AAC9C,EAAA,OAAO,CAAC,GAAGC,0CAAA,CAAgBC,6BAAA,EAAe,EAAG,MAAM,CAAC,CAAA;AACtD;AAQO,MAAM,WAAA,GAA6CC,mBAAA;AAAA,EACxD,WAAA;AAAA,EACA,yBAAA;AAAA,EACA;AACF;;;"}

package/dist/api/string-to-ast.mjs

@@ -0,0 +1,18 @@
+import { deprecate } from 'node:util';
+import { parseStatements } from '../adapters/type-ast-bridge/ir-declarations-to-typescript.mjs';
+import { loadTypeScript } from '../adapters/type-ast-bridge/load-typescript.mjs';
+import { IR_CALLBACKS_GUIDE_URL } from './legacy-callback-warning.mjs';
+
+const STRING_TO_AST_DEPRECATION = `stringToAST() is deprecated and removed in 2.0. Return TypeScript type text from an IR callback (irCallbacks: true) instead: ${IR_CALLBACKS_GUIDE_URL}`;
+const STRING_TO_AST_DEPRECATION_CODE = "OPENAPI_TYPESAFE_DEP_STRING_TO_AST";
+function parseSource(source) {
+  return [...parseStatements(loadTypeScript(), source)];
+}
+const stringToAST = deprecate(
+  parseSource,
+  STRING_TO_AST_DEPRECATION,
+  STRING_TO_AST_DEPRECATION_CODE
+);
+
+export { STRING_TO_AST_DEPRECATION_CODE, stringToAST };
+//# sourceMappingURL=string-to-ast.mjs.map

package/dist/api/string-to-ast.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-ast.mjs","sources":["../../src/api/string-to-ast.ts"],"sourcesContent":["import { deprecate } from \"node:util\";\nimport { parseStatements } from \"../adapters/type-ast-bridge/ir-declarations-to-typescript.js\";\nimport { loadTypeScript } from \"../adapters/type-ast-bridge/load-typescript.js\";\nimport { IR_CALLBACKS_GUIDE_URL } from \"./legacy-callback-warning.js\";\n\nconst STRING_TO_AST_DEPRECATION =\n  \"stringToAST() is deprecated and removed in 2.0. Return TypeScript type text from an IR \" +\n  `callback (irCallbacks: true) instead: ${IR_CALLBACKS_GUIDE_URL}`;\n\n/** Node's deprecation code for `stringToAST`, so users can filter or trace the warning. */\nexport const STRING_TO_AST_DEPRECATION_CODE = \"OPENAPI_TYPESAFE_DEP_STRING_TO_AST\";\n\nfunction parseSource(source: string): unknown[] {\n  return [...parseStatements(loadTypeScript(), source)];\n}\n\n/**\n * Convert an arbitrary string to TS (assuming it’s valid). Parses with the TypeScript bridge, so\n * it needs TypeScript 6 or earlier (or `@typescript/typescript6`). Node's `util.deprecate` warns\n * on the first call only.\n * @deprecated Kept for 1.x; removed in 2.0 (ADR-004, decision 7). Use type text in IR callbacks.\n */\nexport const stringToAST: (source: string) => unknown[] = deprecate(\n  parseSource,\n  STRING_TO_AST_DEPRECATION,\n  STRING_TO_AST_DEPRECATION_CODE,\n);\n"],"names":[],"mappings":";;;;;AAKA,MAAM,yBAAA,GACJ,gIACyC,sBAAsB,CAAA,CAAA;AAG1D,MAAM,8BAAA,GAAiC;AAE9C,SAAS,YAAY,MAAA,EAA2B;AAC9C,EAAA,OAAO,CAAC,GAAG,eAAA,CAAgB,cAAA,EAAe,EAAG,MAAM,CAAC,CAAA;AACtD;AAQO,MAAM,WAAA,GAA6C,SAAA;AAAA,EACxD,WAAA;AAAA,EACA,yBAAA;AAAA,EACA;AACF;;"}

package/dist/api/transform-context.cjs

@@ -0,0 +1,84 @@
+'use strict';
+
+const changeCase = require('change-case');
+const documentFooter = require('../application/transform/footer/document-footer.cjs');
+const defaultPorts = require('./default-ports.cjs');
+const footerSink = require('./footer-sink.cjs');
+const schemaCallbacks = require('./schema-callbacks.cjs');
+
+function _interopNamespaceCompat(e) {
+  if (e && typeof e === 'object' && 'default' in e) return e;
+  const n = Object.create(null);
+  if (e) {
+    for (const k in e) {
+      n[k] = e[k];
+    }
+  }
+  n.default = e;
+  return n;
+}
+
+const changeCase__namespace = /*#__PURE__*/_interopNamespaceCompat(changeCase);
+
+function transformOptions(ctx) {
+  return {
+    additionalProperties: ctx.additionalProperties,
+    alphabetize: ctx.alphabetize,
+    arrayLength: ctx.arrayLength,
+    binaryAsBlob: ctx.binaryAsBlob,
+    conditionalEnums: ctx.conditionalEnums,
+    dedupeEnums: ctx.dedupeEnums,
+    defaultNonNullable: ctx.defaultNonNullable,
+    emptyObjectsUnknown: ctx.emptyObjectsUnknown,
+    enum: ctx.enum,
+    enumValues: ctx.enumValues,
+    excludeDeprecated: ctx.excludeDeprecated,
+    fixes: new Set(ctx.fix ?? []),
+    immutable: ctx.immutable,
+    propertiesRequiredByDefault: ctx.propertiesRequiredByDefault,
+    readWriteMarkers: ctx.readWriteMarkers,
+    generatePathParams: ctx.generatePathParams,
+    pathParamsAsTypes: ctx.pathParamsAsTypes,
+    rootTypes: ctx.rootTypes,
+    rootTypesNoSchemaPrefix: ctx.rootTypesNoSchemaPrefix,
+    rootTypesKeepCasing: ctx.rootTypesKeepCasing,
+    exportType: ctx.exportType,
+    inject: ctx.inject,
+    makePathsEnum: ctx.makePathsEnum
+  };
+}
+function runFooter(ctx) {
+  ctx.runFooter ??= new documentFooter.RunFooter(new footerSink.ContextFooterSink(ctx.injectFooter), ctx.dedupeEnums);
+  return ctx.runFooter;
+}
+const CASING = { pascalCase: (text) => changeCase__namespace.pascalCase(text) };
+function diagnostics(ctx) {
+  const logger = ctx.logger ?? defaultPorts.defaultLogger(ctx.silent);
+  return {
+    now: defaultPorts.monotonicNow,
+    debug: (message, durationMs) => logger.debug(message, "ts", durationMs)
+  };
+}
+function createTransformContext(ctx) {
+  return {
+    options: transformOptions(ctx),
+    refs: { resolve: (ref) => ctx.resolve(ref) },
+    discriminators: {
+      objectAt: (ref) => ctx.discriminators.objects[ref],
+      isHandled: (ref) => ctx.discriminators.refsHandled.includes(ref),
+      otherPropertiesAt: (ref) => ctx.discriminators.otherProperties?.[ref] ?? [],
+      enumParentOf: (schema) => ctx.discriminators.enumParents?.get(schema)
+    },
+    footer: runFooter(ctx),
+    callbacks: schemaCallbacks.schemaCallbacks(ctx),
+    diagnostics: diagnostics(ctx),
+    casing: CASING
+  };
+}
+function schemaLocation(options) {
+  return { path: options.path, schema: options.schema };
+}
+
+exports.createTransformContext = createTransformContext;
+exports.schemaLocation = schemaLocation;
+//# sourceMappingURL=transform-context.cjs.map