@haddowg/json-api-codegen 1.0.0 → 1.1.0

package/dist/cli.d.mts

@@ -1,4 +1,4 @@
-import { r as CodegenConfig } from "./index-C0becRSc.mjs";
+import { r as CodegenConfig } from "./index-JD2FpQHX.mjs";
 
 //#region src/cli.d.ts
 declare const USAGE = "Usage: json-api-codegen --input <url|file> --output <file> [--server <name>] [--schemas <url|file>] [--check]";
@@ -9,6 +9,12 @@ declare const USAGE = "Usage: json-api-codegen --input <url|file> --output <file
  */
 declare function parseArgs(argv: string[]): Partial<CodegenConfig>;
 declare function run(argv: string[]): Promise<number>;
+/**
+ * Whether the module at `moduleUrl` is the script node was asked to run (`argv1`). Compares real
+ * paths, because a package manager installs the bin as a symlink (`node_modules/.bin/...`) and
+ * node reports the symlink in `process.argv[1]` but the resolved file in `import.meta.url`.
+ */
+declare function isEntry(moduleUrl: string, argv1: string | undefined): boolean;
 //#endregion
-export { USAGE, parseArgs, run };
+export { USAGE, isEntry, parseArgs, run };
 //# sourceMappingURL=cli.d.mts.map

package/dist/cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";;;cAIa,KAAA;AAAb;;;;AAAkB;AAAlB,iBAQgB,SAAA,CAAU,IAAA,aAAiB,OAAO,CAAC,aAAA;AAAA,iBA6B7B,GAAA,CAAI,IAAA,aAAiB,OAAO"}
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";;;cAKa,KAAA;AAAb;;;;AAAkB;AAAlB,iBAQgB,SAAA,CAAU,IAAA,aAAiB,OAAO,CAAC,aAAA;AAAA,iBA6B7B,GAAA,CAAI,IAAA,aAAiB,OAAO;;;;;;iBAgClC,OAAA,CAAQ,SAAA,UAAmB,KAAyB"}

package/dist/cli.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
-import { n as generate, t as check } from "./src-B24cYyjM.mjs";
-import { pathToFileURL } from "node:url";
+import { n as generate, r as schemasOutputPath, t as check } from "./src-CDV4z7In.mjs";
+import { realpathSync } from "node:fs";
+import { fileURLToPath } from "node:url";
 //#region src/cli.ts
 const USAGE = "Usage: json-api-codegen --input <url|file> --output <file> [--server <name>] [--schemas <url|file>] [--check]";
 /**
@@ -50,17 +51,31 @@ async function run(argv) {
 		return 0;
 	}
 	await generate(config);
+	console.error(`wrote ${config.output}`);
+	if (config.schemas !== void 0) console.error(`wrote ${schemasOutputPath(config.output)}`);
 	return 0;
 }
+/**
+* Whether the module at `moduleUrl` is the script node was asked to run (`argv1`). Compares real
+* paths, because a package manager installs the bin as a symlink (`node_modules/.bin/...`) and
+* node reports the symlink in `process.argv[1]` but the resolved file in `import.meta.url`.
+*/
+function isEntry(moduleUrl, argv1) {
+	if (argv1 === void 0) return false;
+	try {
+		return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argv1);
+	} catch {
+		return false;
+	}
+}
 async function main() {
 	process.exitCode = await run(process.argv.slice(2));
 }
-const entry = process.argv[1];
-if (entry !== void 0 && import.meta.url === pathToFileURL(entry).href) main().catch((error) => {
+if (isEntry(import.meta.url, process.argv[1])) main().catch((error) => {
 	console.error(error instanceof Error ? error.message : error);
 	process.exitCode = 1;
 });
 //#endregion
-export { USAGE, parseArgs, run };
+export { USAGE, isEntry, parseArgs, run };
 
 //# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { pathToFileURL } from 'node:url'\nimport { check, generate, type CodegenConfig } from './index'\n\nexport const USAGE =\n  'Usage: json-api-codegen --input <url|file> --output <file> [--server <name>] [--schemas <url|file>] [--check]'\n\n/**\n * Thin CLI wrapper. Real arg parsing + `japi.config.ts` discovery land with the\n * generator itself; this stub establishes the bin entry and the shape of invocation.\n * `--check` is a boolean flag (drift gate) with no value.\n */\nexport function parseArgs(argv: string[]): Partial<CodegenConfig> {\n  const config: Partial<CodegenConfig> = {}\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]\n    if (arg === '--check') {\n      config.check = true\n      continue\n    }\n    const next = argv[i + 1]\n    if (next === undefined) {\n      continue\n    }\n    if (arg === '--input') {\n      config.input = next\n      i++\n    } else if (arg === '--output') {\n      config.output = next\n      i++\n    } else if (arg === '--server') {\n      config.server = next\n      i++\n    } else if (arg === '--schemas') {\n      config.schemas = next\n      i++\n    }\n  }\n  return config\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const config = parseArgs(argv)\n  if (!config.input || !config.output) {\n    console.error(USAGE)\n    return 1\n  }\n  if (config.check) {\n    const result = await check(config as CodegenConfig)\n    for (const { path, upToDate } of result.artifacts) {\n      console.error(`${upToDate ? 'ok  ' : 'DRIFT'} ${path}`)\n    }\n    if (!result.ok) {\n      console.error(\n        'Generated client is out of date with the source spec. Regenerate (drop --check) and commit the result.',\n      )\n      return 1\n    }\n    return 0\n  }\n  await generate(config as CodegenConfig)\n  return 0\n}\n\nasync function main(): Promise<void> {\n  process.exitCode = await run(process.argv.slice(2))\n}\n\n// Only run when invoked as the bin, not when imported (e.g. by tests).\nconst entry = process.argv[1]\nif (entry !== undefined && import.meta.url === pathToFileURL(entry).href) {\n  main().catch((error: unknown) => {\n    console.error(error instanceof Error ? error.message : error)\n    process.exitCode = 1\n  })\n}\n"],"mappings":";;;;AAIA,MAAa,QACX;;;;;;AAOF,SAAgB,UAAU,MAAwC;CAChE,MAAM,SAAiC,CAAC;CACxC,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EACjB,IAAI,QAAQ,WAAW;GACrB,OAAO,QAAQ;GACf;EACF;EACA,MAAM,OAAO,KAAK,IAAI;EACtB,IAAI,SAAS,KAAA,GACX;EAEF,IAAI,QAAQ,WAAW;GACrB,OAAO,QAAQ;GACf;EACF,OAAO,IAAI,QAAQ,YAAY;GAC7B,OAAO,SAAS;GAChB;EACF,OAAO,IAAI,QAAQ,YAAY;GAC7B,OAAO,SAAS;GAChB;EACF,OAAO,IAAI,QAAQ,aAAa;GAC9B,OAAO,UAAU;GACjB;EACF;CACF;CACA,OAAO;AACT;AAEA,eAAsB,IAAI,MAAiC;CACzD,MAAM,SAAS,UAAU,IAAI;CAC7B,IAAI,CAAC,OAAO,SAAS,CAAC,OAAO,QAAQ;EACnC,QAAQ,MAAM,KAAK;EACnB,OAAO;CACT;CACA,IAAI,OAAO,OAAO;EAChB,MAAM,SAAS,MAAM,MAAM,MAAuB;EAClD,KAAK,MAAM,EAAE,MAAM,cAAc,OAAO,WACtC,QAAQ,MAAM,GAAG,WAAW,SAAS,QAAQ,GAAG,MAAM;EAExD,IAAI,CAAC,OAAO,IAAI;GACd,QAAQ,MACN,wGACF;GACA,OAAO;EACT;EACA,OAAO;CACT;CACA,MAAM,SAAS,MAAuB;CACtC,OAAO;AACT;AAEA,eAAe,OAAsB;CACnC,QAAQ,WAAW,MAAM,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC;AACpD;AAGA,MAAM,QAAQ,QAAQ,KAAK;AAC3B,IAAI,UAAU,KAAA,KAAa,OAAO,KAAK,QAAQ,cAAc,KAAK,CAAC,CAAC,MAClE,KAAK,CAAC,CAAC,OAAO,UAAmB;CAC/B,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,KAAK;CAC5D,QAAQ,WAAW;AACrB,CAAC"}
+{"version":3,"file":"cli.mjs","names":[],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { realpathSync } from 'node:fs'\nimport { fileURLToPath } from 'node:url'\nimport { check, generate, schemasOutputPath, type CodegenConfig } from './index'\n\nexport const USAGE =\n  'Usage: json-api-codegen --input <url|file> --output <file> [--server <name>] [--schemas <url|file>] [--check]'\n\n/**\n * Thin CLI wrapper. Real arg parsing + `japi.config.ts` discovery land with the\n * generator itself; this stub establishes the bin entry and the shape of invocation.\n * `--check` is a boolean flag (drift gate) with no value.\n */\nexport function parseArgs(argv: string[]): Partial<CodegenConfig> {\n  const config: Partial<CodegenConfig> = {}\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]\n    if (arg === '--check') {\n      config.check = true\n      continue\n    }\n    const next = argv[i + 1]\n    if (next === undefined) {\n      continue\n    }\n    if (arg === '--input') {\n      config.input = next\n      i++\n    } else if (arg === '--output') {\n      config.output = next\n      i++\n    } else if (arg === '--server') {\n      config.server = next\n      i++\n    } else if (arg === '--schemas') {\n      config.schemas = next\n      i++\n    }\n  }\n  return config\n}\n\nexport async function run(argv: string[]): Promise<number> {\n  const config = parseArgs(argv)\n  if (!config.input || !config.output) {\n    console.error(USAGE)\n    return 1\n  }\n  if (config.check) {\n    const result = await check(config as CodegenConfig)\n    for (const { path, upToDate } of result.artifacts) {\n      console.error(`${upToDate ? 'ok  ' : 'DRIFT'} ${path}`)\n    }\n    if (!result.ok) {\n      console.error(\n        'Generated client is out of date with the source spec. Regenerate (drop --check) and commit the result.',\n      )\n      return 1\n    }\n    return 0\n  }\n  await generate(config as CodegenConfig)\n  console.error(`wrote ${config.output}`)\n  if (config.schemas !== undefined) {\n    console.error(`wrote ${schemasOutputPath(config.output)}`)\n  }\n  return 0\n}\n\n/**\n * Whether the module at `moduleUrl` is the script node was asked to run (`argv1`). Compares real\n * paths, because a package manager installs the bin as a symlink (`node_modules/.bin/...`) and\n * node reports the symlink in `process.argv[1]` but the resolved file in `import.meta.url`.\n */\nexport function isEntry(moduleUrl: string, argv1: string | undefined): boolean {\n  if (argv1 === undefined) {\n    return false\n  }\n  try {\n    return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argv1)\n  } catch {\n    return false\n  }\n}\n\nasync function main(): Promise<void> {\n  process.exitCode = await run(process.argv.slice(2))\n}\n\n// Only run when invoked as the bin, not when imported (e.g. by tests).\nif (isEntry(import.meta.url, process.argv[1])) {\n  main().catch((error: unknown) => {\n    console.error(error instanceof Error ? error.message : error)\n    process.exitCode = 1\n  })\n}\n"],"mappings":";;;;;AAKA,MAAa,QACX;;;;;;AAOF,SAAgB,UAAU,MAAwC;CAChE,MAAM,SAAiC,CAAC;CACxC,KAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;EACpC,MAAM,MAAM,KAAK;EACjB,IAAI,QAAQ,WAAW;GACrB,OAAO,QAAQ;GACf;EACF;EACA,MAAM,OAAO,KAAK,IAAI;EACtB,IAAI,SAAS,KAAA,GACX;EAEF,IAAI,QAAQ,WAAW;GACrB,OAAO,QAAQ;GACf;EACF,OAAO,IAAI,QAAQ,YAAY;GAC7B,OAAO,SAAS;GAChB;EACF,OAAO,IAAI,QAAQ,YAAY;GAC7B,OAAO,SAAS;GAChB;EACF,OAAO,IAAI,QAAQ,aAAa;GAC9B,OAAO,UAAU;GACjB;EACF;CACF;CACA,OAAO;AACT;AAEA,eAAsB,IAAI,MAAiC;CACzD,MAAM,SAAS,UAAU,IAAI;CAC7B,IAAI,CAAC,OAAO,SAAS,CAAC,OAAO,QAAQ;EACnC,QAAQ,MAAM,KAAK;EACnB,OAAO;CACT;CACA,IAAI,OAAO,OAAO;EAChB,MAAM,SAAS,MAAM,MAAM,MAAuB;EAClD,KAAK,MAAM,EAAE,MAAM,cAAc,OAAO,WACtC,QAAQ,MAAM,GAAG,WAAW,SAAS,QAAQ,GAAG,MAAM;EAExD,IAAI,CAAC,OAAO,IAAI;GACd,QAAQ,MACN,wGACF;GACA,OAAO;EACT;EACA,OAAO;CACT;CACA,MAAM,SAAS,MAAuB;CACtC,QAAQ,MAAM,SAAS,OAAO,QAAQ;CACtC,IAAI,OAAO,YAAY,KAAA,GACrB,QAAQ,MAAM,SAAS,kBAAkB,OAAO,MAAM,GAAG;CAE3D,OAAO;AACT;;;;;;AAOA,SAAgB,QAAQ,WAAmB,OAAoC;CAC7E,IAAI,UAAU,KAAA,GACZ,OAAO;CAET,IAAI;EACF,OAAO,aAAa,cAAc,SAAS,CAAC,MAAM,aAAa,KAAK;CACtE,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAe,OAAsB;CACnC,QAAQ,WAAW,MAAM,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC;AACpD;AAGA,IAAI,QAAQ,OAAO,KAAK,KAAK,QAAQ,KAAK,EAAE,GAC1C,KAAK,CAAC,CAAC,OAAO,UAAmB;CAC/B,QAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,KAAK;CAC5D,QAAQ,WAAW;AACrB,CAAC"}

package/dist/{index-C0becRSc.d.mts → index-JD2FpQHX.d.mts}

@@ -42,6 +42,8 @@ interface ParameterObject {
   in?: string;
   $ref?: string;
   schema?: SchemaObject;
+  style?: string;
+  explode?: boolean;
   /** The negotiation profile a client must opt into to use this parameter (e.g. `withCount`). */
   'x-profile'?: string;
 }
@@ -55,6 +57,10 @@ type PathItemObject = Partial<Record<HttpMethod, OperationObject>>;
 interface InfoObject {
   title?: string;
   version?: string;
+  /** The projector's generator contract, bumped whenever the emitted structure changes. */
+  'x-generator'?: {
+    contract?: number;
+  };
 }
 interface OpenApiDocument {
   openapi?: string;
@@ -160,15 +166,24 @@ declare class DescriptorBuilder {
   /** Any `P/{id}/<rel>` related path (excludes relationships/ and custom `-actions`). */
   private hasRelatedPath;
   private hasRelationshipPath;
-  /** Detect the paginator kind from the fetchMany operation's query parameter names. */
+  /** Detect the paginator from the fetchMany operation's page parameters. */
   private paginator;
   /**
-   * Detect the paginator kind an operation advertises from its `page[...]` query parameter names.
-   * `page[number]`+`page[size]` = `page`; `page[offset]`+`page[limit]` = `offset`; either cursor
-   * bound (`page[after]`/`page[before]`) = `cursor` (link-driven, D44); anything else = `none`.
-   * `label` (a path, for the drift warning) names the endpoint when page params match no known kind.
+   * Detect the paginator an operation advertises. A page schema stamped with `x-paginator`
+   * (contract 3) names its strategy and the wire key for each role, so it decides both. Without
+   * the stamp, the strategy is inferred from canonical member names (see {@link kindOfMembers}).
+   * Anything unrecognised warns and generates as unpaginated. `label` (a path) names the endpoint
+   * in the warning; without it nothing is logged.
+   */
+  private paginatorOf;
+  /**
+   * The `page` members an operation accepts, from either wire form: one `page` parameter
+   * (`style: deepObject`) whose schema `properties` name the members, as `haddowg/json-api` v1
+   * projects it, or the older flattened `page[number]`/`page[size]` parameters. A `oneOf` page
+   * schema (a MultiPaginator menu) yields each arm's members in `menu` instead, minus the
+   * `kind` discriminator.
    */
-  private paginatorKindOf;
+  private pageMembers;
   /**
    * The `withCount` capability (Countable profile) for a type's COLLECTION read (`list`): the
    * count tokens (`schema.items.enum`) + the negotiation profile (`x-profile`) carried by the
@@ -206,7 +221,6 @@ declare class DescriptorBuilder {
    * deliberately not captured — `filter` values stay `unknown` (out of scope for v0.1).
    */
   private filterable;
-  private queryParamNames;
   private operation;
   private requestBodyRef;
   private okResponseRef;
@@ -216,6 +230,19 @@ declare function buildDescriptor(doc: OpenApiDocument): ApiDescriptor;
 /** Detect the server-level Atomic Operations capability (`null` when none). */
 declare function buildAtomic(doc: OpenApiDocument): AtomicDescriptor | null;
 //#endregion
+//#region src/contract.d.ts
+/** Below this the document predates the structures this codegen reads. */
+declare const MINIMUM_CONTRACT = 1;
+/** Above this the document carries structures this codegen does not read. */
+declare const MAXIMUM_CONTRACT = 4;
+/**
+ * Check the document's `info.x-generator.contract` against the range this codegen reads. A
+ * document older than the range throws; a newer one returns a warning, because its new
+ * structures would go unread and the client would silently miss what the server offers. A
+ * document with no contract (json-api before 1.1.0) passes.
+ */
+declare function checkContract(doc: OpenApiDocument): string | undefined;
+//#endregion
 //#region src/emit.d.ts
 /** A relation name that will later collide with a fluent-surface verb. */
 interface VerbCollision {
@@ -347,6 +374,41 @@ declare class Emitter {
  */
 declare function emit(doc: OpenApiDocument, descriptor: ApiDescriptor, atomic?: AtomicDescriptor | null): string;
 //#endregion
+//#region src/error-codes.d.ts
+/** One documented error code, with whatever the document says about it. */
+interface DocumentedErrorCode {
+  code: string;
+  /** The `<Code>Error` component's `description`, when the document has one (contract 4). */
+  description?: string;
+  /** Example `detail` values, from the component's `detail` property (`example` / `examples`). */
+  examples: unknown[];
+}
+/** The server's error catalogue as the codegen reads it. */
+interface ErrorCatalogue {
+  /** Every code any error document offers, sorted by code. */
+  codes: DocumentedErrorCode[];
+  /**
+   * Per status, the codes its `ErrorDocument<NNN>` offers, sorted by code. A status whose
+   * document offers only the generic `Error` maps to an empty list.
+   */
+  byStatus: Map<number, string[]>;
+}
+/**
+ * Read the documented error codes off a document's error documents. `ErrorDocument` and each
+ * `ErrorDocument<NNN>` offer their codes as `errors.items.anyOf` branches that `$ref` a
+ * `<Code>Error` component; a branch with a `code` const names a code, and the generic `Error`
+ * branch (no const) names none.
+ */
+declare function readErrorCatalogue(doc: OpenApiDocument): ErrorCatalogue;
+/**
+ * Emit `ErrorCodes`, a const object keyed by every documented code with its TSDoc on the key
+ * (editors show TSDoc on an object key, not on a string-literal union member), the `ErrorCode`
+ * union derived from it, and `ErrorCodeByStatus`, the codes each status's error document offers.
+ * A document with no code catalogue gets an empty `ErrorCodes` and `ErrorCode = string`, so the
+ * bound guard still takes any code.
+ */
+declare function emitErrorCodes(catalogue: ErrorCatalogue): string;
+//#endregion
 //#region src/reader.d.ts
 /** A self-contained JSON Schema document, keyed by JSON:API type, as served at `GET /schemas.json`. */
 type SchemaBundle = Record<string, SchemaObject>;
@@ -467,5 +529,5 @@ declare function generate(config: CodegenConfig): Promise<string>;
  */
 declare function check(config: CodegenConfig): Promise<CheckResult>;
 //#endregion
-export { ResponseObject as A, InfoObject as C, ParameterObject as D, OperationObject as E, SchemaOrBool as M, PathItemObject as O, HttpMethod as S, OpenApiDocument as T, detectVerbCollisions as _, generate as a, buildAtomic as b, deriveProvenance as c, emitSchemas as d, SchemaBundle as f, VerbCollision as g, Emitter as h, check as i, SchemaObject as j, RequestBodyObject as k, hashJson as l, readSchemas as m, CheckResult as n, schemasOutputPath as o, readDocument as p, CodegenConfig as r, Provenance as s, ArtifactDrift as t, provenanceLines as u, emit as v, MediaTypeObject as w, buildDescriptor as x, DescriptorBuilder as y };
-//# sourceMappingURL=index-C0becRSc.d.mts.map
+export { InfoObject as A, MAXIMUM_CONTRACT as C, buildAtomic as D, DescriptorBuilder as E, PathItemObject as F, RequestBodyObject as I, ResponseObject as L, OpenApiDocument as M, OperationObject as N, buildDescriptor as O, ParameterObject as P, SchemaObject as R, emit as S, checkContract as T, emitErrorCodes as _, generate as a, VerbCollision as b, deriveProvenance as c, emitSchemas as d, SchemaBundle as f, ErrorCatalogue as g, DocumentedErrorCode as h, check as i, MediaTypeObject as j, HttpMethod as k, hashJson as l, readSchemas as m, CheckResult as n, schemasOutputPath as o, readDocument as p, CodegenConfig as r, Provenance as s, ArtifactDrift as t, provenanceLines as u, readErrorCatalogue as v, MINIMUM_CONTRACT as w, detectVerbCollisions as x, Emitter as y, SchemaOrBool as z };
+//# sourceMappingURL=index-JD2FpQHX.d.mts.map

package/dist/index-JD2FpQHX.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-JD2FpQHX.d.mts","names":[],"sources":["../src/openapi.ts","../src/build-descriptor.ts","../src/contract.ts","../src/emit.ts","../src/error-codes.ts","../src/reader.ts","../src/emit-schemas.ts","../src/provenance.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { A as ResponseObject, C as InfoObject, D as ParameterObject, E as OperationObject, M as SchemaOrBool, O as PathItemObject, S as HttpMethod, T as OpenApiDocument, _ as detectVerbCollisions, a as generate, b as buildAtomic, c as deriveProvenance, d as emitSchemas, f as SchemaBundle, g as VerbCollision, h as Emitter, i as check, j as SchemaObject, k as RequestBodyObject, l as hashJson, m as readSchemas, n as CheckResult, o as schemasOutputPath, p as readDocument, r as CodegenConfig, s as Provenance, t as ArtifactDrift, u as provenanceLines, v as emit, w as MediaTypeObject, x as buildDescriptor, y as DescriptorBuilder } from "./index-C0becRSc.mjs";
-export { ArtifactDrift, CheckResult, CodegenConfig, DescriptorBuilder, Emitter, type HttpMethod, type InfoObject, type MediaTypeObject, type OpenApiDocument, type OperationObject, type ParameterObject, type PathItemObject, type Provenance, type RequestBodyObject, type ResponseObject, type SchemaBundle, type SchemaObject, type SchemaOrBool, type VerbCollision, buildAtomic, buildDescriptor, check, deriveProvenance, detectVerbCollisions, emit, emitSchemas, generate, hashJson, provenanceLines, readDocument, readSchemas, schemasOutputPath };
+import { A as InfoObject, C as MAXIMUM_CONTRACT, D as buildAtomic, E as DescriptorBuilder, F as PathItemObject, I as RequestBodyObject, L as ResponseObject, M as OpenApiDocument, N as OperationObject, O as buildDescriptor, P as ParameterObject, R as SchemaObject, S as emit, T as checkContract, _ as emitErrorCodes, a as generate, b as VerbCollision, c as deriveProvenance, d as emitSchemas, f as SchemaBundle, g as ErrorCatalogue, h as DocumentedErrorCode, i as check, j as MediaTypeObject, k as HttpMethod, l as hashJson, m as readSchemas, n as CheckResult, o as schemasOutputPath, p as readDocument, r as CodegenConfig, s as Provenance, t as ArtifactDrift, u as provenanceLines, v as readErrorCatalogue, w as MINIMUM_CONTRACT, x as detectVerbCollisions, y as Emitter, z as SchemaOrBool } from "./index-JD2FpQHX.mjs";
+export { ArtifactDrift, CheckResult, CodegenConfig, DescriptorBuilder, type DocumentedErrorCode, Emitter, type ErrorCatalogue, type HttpMethod, type InfoObject, MAXIMUM_CONTRACT, MINIMUM_CONTRACT, type MediaTypeObject, type OpenApiDocument, type OperationObject, type ParameterObject, type PathItemObject, type Provenance, type RequestBodyObject, type ResponseObject, type SchemaBundle, type SchemaObject, type SchemaOrBool, type VerbCollision, buildAtomic, buildDescriptor, check, checkContract, deriveProvenance, detectVerbCollisions, emit, emitErrorCodes, emitSchemas, generate, hashJson, provenanceLines, readDocument, readErrorCatalogue, readSchemas, schemasOutputPath };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as readSchemas, c as detectVerbCollisions, d as hashJson, f as provenanceLines, h as buildDescriptor, i as readDocument, l as emit, m as buildAtomic, n as generate, o as emitSchemas, p as DescriptorBuilder, r as schemasOutputPath, s as Emitter, t as check, u as deriveProvenance } from "./src-B24cYyjM.mjs";
-export { DescriptorBuilder, Emitter, buildAtomic, buildDescriptor, check, deriveProvenance, detectVerbCollisions, emit, emitSchemas, generate, hashJson, provenanceLines, readDocument, readSchemas, schemasOutputPath };
+import { _ as checkContract, a as readSchemas, b as buildDescriptor, c as detectVerbCollisions, d as hashJson, f as provenanceLines, g as MINIMUM_CONTRACT, h as MAXIMUM_CONTRACT, i as readDocument, l as emit, m as readErrorCatalogue, n as generate, o as emitSchemas, p as emitErrorCodes, r as schemasOutputPath, s as Emitter, t as check, u as deriveProvenance, v as DescriptorBuilder, y as buildAtomic } from "./src-CDV4z7In.mjs";
+export { DescriptorBuilder, Emitter, MAXIMUM_CONTRACT, MINIMUM_CONTRACT, buildAtomic, buildDescriptor, check, checkContract, deriveProvenance, detectVerbCollisions, emit, emitErrorCodes, emitSchemas, generate, hashJson, provenanceLines, readDocument, readErrorCatalogue, readSchemas, schemasOutputPath };