@vertesia/common 1.5.0-dev.20260807.073259Z → 1.5.0-dev.20260901.005903Z

package/lib/api-contract/index.js

@@ -0,0 +1,554 @@
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import ajvFormats from 'ajv-formats';
+import { findUnprunablePaths, isPlainObject, pruneToSchema } from '../api-schemas/adapter.js';
+import { normalizeParameters, } from '../api-schemas/parameters.js';
+import API_SCHEMA_COMPONENTS from './components.generated.json' with { type: 'json' };
+// ajv-formats is CommonJS with an ESM-style declaration file. Node's interop makes the default
+// import the whole `module.exports` (itself callable), while TypeScript sees the namespace — and
+// `.default` is the plugin function in both shapes.
+const addFormats = ajvFormats.default;
+/**
+ * The canonical `components.schemas` for all documented endpoints.
+ *
+ * This exact object is what the OpenAPI spec publishes AND what AJV compiles, so the published
+ * contract and the enforced contract cannot diverge. It is the prebuilt emission of the Zod
+ * registry rather than a live conversion of it — see the module comment.
+ *
+ * Widened on import on purpose: `resolveJsonModule` would otherwise infer the literal type of a
+ * 1187-key document and bake it into this package's `.d.ts`.
+ */
+export const ApiSchemaComponents = API_SCHEMA_COMPONENTS;
+/**
+ * A canonical component as a SELF-CONTAINED JSON Schema, for consumers that compile it directly.
+ *
+ * `components` defaults to the generated artifact, which is what a server wants. A GENERATOR must
+ * pass `buildApiSchemaComponents()` instead: the artifact on disk is the previous run's output, so
+ * bundling from it would emit an artifact derived from the last contract rather than the current Zod
+ * schemas — and, run in the wrong order, would leave the two generated files describing different
+ * shapes. Passing the fresh emission makes each generator independent of the others' ordering.
+ *
+ * The published component `$ref`s its neighbours through `#/components/schemas/...`, which resolves
+ * only inside the OpenAPI document. AJV and the Monaco editor need a document they can compile on
+ * its own, so the transitive closure is inlined under `$defs` and the pointers rewritten. Nothing
+ * about the shapes changes — this is a re-rooting of the same objects, plus the removal of the
+ * OpenAPI-only discriminator keywords described below, which is what lets a generated artifact be
+ * compared with the component it came from.
+ */
+export function bundleCanonicalComponent(name, components = ApiSchemaComponents) {
+    const seen = new Set();
+    const queue = [name];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (seen.has(current))
+            continue;
+        seen.add(current);
+        for (const referenced of collectComponentRefs(components[current])) {
+            if (!seen.has(referenced))
+                queue.push(referenced);
+        }
+    }
+    seen.delete(name);
+    const defs = {};
+    for (const dependency of [...seen].sort()) {
+        defs[dependency] = toPlainJsonSchema(components[dependency]);
+    }
+    const root = toPlainJsonSchema(components[name]);
+    return seen.size > 0 ? { ...root, $defs: defs } : root;
+}
+const COMPONENT_REF_PREFIX = '#/components/schemas/';
+/**
+ * Re-roots the component pointers AND drops the discriminator keywords, which are OpenAPI's, not
+ * JSON Schema's.
+ *
+ * `synthesizeDiscriminator` in the adapter gives a discriminated union a `discriminator` plus a
+ * restated `type: 'object'` and `required: [propertyName]` ON THE UNION NODE, so a generated
+ * Java/Go client can pick a subtype from the union rather than the branches. That restatement is a
+ * codegen hint: the node carries no `properties`, so it says "an object that must have
+ * `_option_id`" while declaring nothing that could be one.
+ *
+ * A JSON Schema validator does not mind — `required` needs no matching `properties`, and each
+ * branch requires the same key anyway, so removing all three is validation-neutral. Gemini's
+ * function-declaration validator does mind, and rejects the whole tool:
+ *
+ *     schema at properties.intake.properties.extraction.properties.config.properties.model_options
+ *     requires unspecified property '_option_id'
+ *
+ * That was a 400 on every agent turn offering `create_or_update_type`, because the intake-policy
+ * artifact reaches Vertex inside that tool's input schema. Stripping here rather than at the tool
+ * keeps the next component someone bundles from reintroducing it. The OpenAPI document is untouched
+ * — `ApiSchemaComponents` still carries the hint, and the generated clients still read it.
+ */
+function toPlainJsonSchema(value) {
+    const rerooted = rerootComponentRefs(value);
+    return stripDiscriminators(rerooted);
+}
+function stripDiscriminators(value) {
+    if (Array.isArray(value))
+        return value.map(stripDiscriminators);
+    if (!value || typeof value !== 'object')
+        return value;
+    const node = value;
+    // `properties` present means the node describes an object in its own right, so its `type` and
+    // `required` are the schema's own rather than the restatement — only the OpenAPI keyword goes.
+    const restated = node.discriminator !== undefined && node.properties === undefined;
+    const out = {};
+    for (const [key, item] of Object.entries(node)) {
+        if (key === 'discriminator')
+            continue;
+        if (restated && (key === 'type' || key === 'required'))
+            continue;
+        out[key] = stripDiscriminators(item);
+    }
+    return out;
+}
+function collectComponentRefs(value, out = new Set()) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            collectComponentRefs(item, out);
+        return out;
+    }
+    if (!value || typeof value !== 'object')
+        return out;
+    for (const [key, item] of Object.entries(value)) {
+        if (key === '$ref' && typeof item === 'string' && item.startsWith(COMPONENT_REF_PREFIX)) {
+            out.add(item.slice(COMPONENT_REF_PREFIX.length));
+        }
+        else {
+            collectComponentRefs(item, out);
+        }
+    }
+    return out;
+}
+function rerootComponentRefs(value) {
+    if (Array.isArray(value))
+        return value.map(rerootComponentRefs);
+    if (!value || typeof value !== 'object')
+        return value;
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        out[key] =
+            key === '$ref' && typeof item === 'string' && item.startsWith(COMPONENT_REF_PREFIX)
+                ? `#/$defs/${item.slice(COMPONENT_REF_PREFIX.length)}`
+                : rerootComponentRefs(item);
+    }
+    return out;
+}
+/** The `$ref` pointer for a component, in the same spelling the spec publishes. */
+export function apiComponentRef(name) {
+    return `#/components/schemas/${name}`;
+}
+/**
+ * Validators compiled against the published components, through an envelope so the pointer AJV
+ * resolves is the exact pointer the spec publishes. `strictSchema: false` tolerates the
+ * `components` wrapper while leaving type and tuple checks active.
+ *
+ * Compiled lazily and cached: AJV compilation is the expensive step, and most components are
+ * never validated in a given process.
+ */
+const validators = new Map();
+/**
+ * One instance for the process, built on first validation.
+ *
+ * Per-component instances meant re-registering the whole thousand-component envelope for every
+ * component ever validated, and AJV walks a schema when it is added. Sharing one instance also lets
+ * it reuse the compiled form of a component that two others reference.
+ */
+let ajvInstance;
+/**
+ * The published components as AJV can consume them: the same schemas, with the two adjustments
+ * AJV's discriminator support requires and the OpenAPI document must not have.
+ *
+ * `discriminator: true` below is what makes AJV validate a discriminated union through the branch
+ * its tag names, instead of trying every branch and reporting all of their failures at once. The
+ * difference is not cosmetic — a legacy MCP tool collection missing `id` used to report the real
+ * error alongside two impossible ones from the branch it was never meant to match:
+ *
+ *     / must have required property 'id'                        <- the real one
+ *     / must NOT have additional properties: oauth_app          <- vertesia_sdk branch
+ *     /type must be equal to constant                           <- vertesia_sdk branch
+ *     / must match exactly one schema in oneOf
+ *
+ * AJV rejects `mapping` outright ("discriminator: mapping is not supported"), because it derives
+ * the tag-to-branch map from each branch's own `const`/`enum` instead. The OpenAPI document still
+ * needs the mapping — a generated Java or Go client reads it to pick a concrete subtype — so both
+ * fixups here apply to AJV's copy only, and `ApiSchemaComponents` is published exactly as built.
+ *
+ * AJV's remaining requirements — the tag required in every branch, carrying `const` or a
+ * single-valued `enum`, with the union node typed as an object — are what `synthesizeDiscriminator`
+ * in the adapter already checks before it emits a discriminator at all, and what the hand-written
+ * `.meta({ discriminator })` declarations restate. `api-discriminators.test.ts` compiles every
+ * registered component so a union satisfying neither fails the build rather than the request.
+ */
+function toAjvComponents() {
+    const schemas = structuredClone(ApiSchemaComponents);
+    const resolve = (value) => {
+        if (!isPlainObject(value))
+            return undefined;
+        const ref = value.$ref;
+        if (typeof ref !== 'string' || !ref.startsWith(COMPONENT_REF_PREFIX))
+            return value;
+        return schemas[ref.slice(COMPONENT_REF_PREFIX.length)];
+    };
+    visitSchemaNodes(schemas, (node) => {
+        const discriminator = node.discriminator;
+        if (!isPlainObject(discriminator) || !Array.isArray(node.oneOf))
+            return;
+        // AJV derives the tag-to-branch map from each branch's own literal, so `mapping` is both
+        // redundant and rejected.
+        delete discriminator.mapping;
+        const tag = discriminator.propertyName;
+        if (typeof tag !== 'string')
+            return;
+        for (const member of node.oneOf) {
+            const branch = resolve(member);
+            const properties = branch && isPlainObject(branch.properties) ? branch.properties : undefined;
+            const tagSchema = properties?.[tag];
+            if (!isPlainObject(tagSchema) || tagSchema.const !== undefined || tagSchema.enum !== undefined)
+                continue;
+            // The tag is a `$ref` to a named literal component — `TaskType_ACTIVITY`,
+            // `SupportedIntegrations_gladia` — because the literal carries its own `.meta({ id })`.
+            // AJV reads `properties/<tag>` looking for `const` or `enum` and does not follow a
+            // `$ref` to find one, so it refuses to compile the union at all. Restating the resolved
+            // literal ALONGSIDE the `$ref` is validation-neutral: `$ref` has no special precedence
+            // in 2020-12, both keywords apply, and they carry the same value by construction.
+            const target = resolve(tagSchema);
+            if (!target)
+                continue;
+            if (target.const !== undefined)
+                tagSchema.const = target.const;
+            else if (Array.isArray(target.enum))
+                tagSchema.enum = target.enum;
+        }
+    });
+    return schemas;
+}
+/** Every object node in the component graph, parents before children. */
+function visitSchemaNodes(value, visit) {
+    if (Array.isArray(value)) {
+        for (const item of value)
+            visitSchemaNodes(item, visit);
+        return;
+    }
+    if (!isPlainObject(value))
+        return;
+    visit(value);
+    for (const item of Object.values(value))
+        visitSchemaNodes(item, visit);
+}
+/** The `$id` the whole component envelope is registered under, and the base of every `$ref` to it. */
+const AJV_SCHEMA_ID = 'vertesia://openapi';
+function getAjv() {
+    if (ajvInstance)
+        return ajvInstance;
+    // `verbose` carries two things {@link collectIssues} needs and nothing else supplies: the schema
+    // object that raised each error, which is the only unambiguous way to tell one union candidate
+    // from another, and the value under evaluation, which is what a failed union is re-checked
+    // against. Both are populated only when validation fails, and both are references rather than
+    // copies.
+    // `allowUnionTypes` because a few published components declare `type: [...]` on purpose:
+    // `DurationValue` is `['string', 'number']` specifically so the generated Java client gets one
+    // writable property instead of the unusable `AnyOfnumber` an `anyOf` produces. AJV's
+    // `strictTypes` default of "log" reported that deliberate choice to its logger on every startup.
+    // The default logger is `console`, so the notice left on stderr, where log collectors routinely
+    // classify it as an error — turning a healthy design decision into recurring server error noise.
+    const ajv = new Ajv2020({
+        strictSchema: false,
+        allErrors: true,
+        discriminator: true,
+        verbose: true,
+        allowUnionTypes: true,
+    });
+    // Without this, AJV treats `format` as an annotation and ignores it, so a `date-time` property
+    // would document a constraint nothing checks — the exact spec/enforcement gap this design is
+    // meant to close.
+    addFormats(ajv);
+    ajv.addSchema({ $id: AJV_SCHEMA_ID, components: { schemas: toAjvComponents() } });
+    ajvInstance = ajv;
+    return ajv;
+}
+function getValidator(name) {
+    const cached = validators.get(name);
+    if (cached)
+        return cached;
+    const validate = getAjv().compile({ $ref: `${AJV_SCHEMA_ID}${apiComponentRef(name)}` });
+    validators.set(name, validate);
+    return validate;
+}
+function additionalProperty(error) {
+    // AJV writes "must NOT have additional properties" and puts the offending key in `params`,
+    // so the message alone says a body is wrong without saying which property made it wrong.
+    // Every other keyword names its subject already — `required` quotes the missing property,
+    // `enum` and `type` describe the value in place — and this is the one a caller most often
+    // trips, so it is the one worth spelling out rather than reformatting all of them.
+    return error.params?.additionalProperty;
+}
+/**
+ * The failures, with the undeclared properties a SINGLE schema reported at a given path gathered
+ * into one issue, and each failed untagged union expanded per candidate.
+ *
+ * AJV reports `additionalProperties` per property, so a value carrying a whole foreign object — a
+ * Mongoose document that reached the response mapper unmapped, say — produces one error per own key
+ * and buries every other failure in the payload. Gathering is lossless: every name is kept, in the
+ * order AJV found it. It is keyed by the schema that raised the error as well as the path, so two
+ * candidates complaining at one path never merge into a single line. `schemaPath` will not do: a
+ * `$ref`'d candidate resets it to `#/additionalProperties`, identical for every candidate. The
+ * schema object itself is unambiguous, and `verbose: true` supplies it.
+ *
+ * `discriminator: true` narrows a TAGGED union to the one branch its tag names, so nothing below
+ * applies to those. What is left is the unions with no tag: AJV runs the value against every
+ * candidate and reports all of their failures, flat and unattributed. Read as facts they are
+ * nonsense — for a condition branch `{ to, when }` with a malformed `when`, raw AJV says
+ *
+ *     /nodes/a/branches/0/when must be object                              <- BranchDefinition
+ *     /nodes/a/branches/0 must have required property 'id'                 <- BranchNodeBranchDefinition
+ *     /nodes/a/branches/0 must NOT have additional properties: to, when    <- BranchNodeBranchDefinition
+ *     /nodes/a/branches/0 must match exactly one schema in oneOf
+ *
+ * where `to` and `when` are declared on `BranchDefinition` and only wrong for a candidate the value
+ * never meant. Nothing in the error list says which claim belongs to which candidate, and the
+ * candidates fail at DIFFERENT paths, so no rule based on the path can recover it.
+ *
+ * So the union is re-validated candidate by candidate, and each candidate's own failures are
+ * attributed to it by name. That is exact rather than inferred, at the cost of one extra validation
+ * per candidate — paid only on a response that is already failing:
+ *
+ *     /nodes/a/branches/0 must match exactly one schema in oneOf
+ *     /nodes/a/branches/0/when as BranchDefinition: must be object
+ *     /nodes/a/branches/0 as BranchNodeBranchDefinition: must have required property 'id'
+ *     /nodes/a/branches/0 as BranchNodeBranchDefinition: must NOT have additional properties: to, when
+ *
+ * Expansion goes ONE level deep: a candidate's own errors are collected without expanding any union
+ * nested inside it, which bounds the work and keeps the output readable.
+ */
+function collectIssues(validate) {
+    return toIssues(validate.errors ?? [], true);
+}
+function toIssues(errors, expandUnions) {
+    const expansions = new Map();
+    if (expandUnions) {
+        for (const error of errors) {
+            if (error.keyword !== 'oneOf' && error.keyword !== 'anyOf')
+                continue;
+            const expanded = expandUnion(error);
+            if (expanded)
+                expansions.set(error.instancePath, expanded);
+        }
+    }
+    /** Whether an expanded union already accounts for this error, making the raw form redundant. */
+    const superseded = (error) => {
+        for (const base of expansions.keys()) {
+            if (error.instancePath === base || error.instancePath.startsWith(`${base}/`))
+                return true;
+        }
+        return false;
+    };
+    const issues = [];
+    // Keyed by the raising schema, then by path: two candidates at one path stay separate, and one
+    // schema's repeats at one path merge.
+    const gathered = new Map();
+    for (const error of errors) {
+        const path = error.instancePath || '/';
+        const message = error.message ?? 'is invalid';
+        const expanded = expansions.get(error.instancePath);
+        if (expanded && (error.keyword === 'oneOf' || error.keyword === 'anyOf')) {
+            // The union's own line frames the candidates that follow it.
+            issues.push({ path, message });
+            issues.push(...expanded);
+            continue;
+        }
+        if (superseded(error))
+            continue;
+        const additional = additionalProperty(error);
+        if (additional === undefined) {
+            issues.push({ path, message });
+            continue;
+        }
+        let byPath = gathered.get(error.parentSchema);
+        if (!byPath) {
+            byPath = new Map();
+            gathered.set(error.parentSchema, byPath);
+        }
+        const existing = byPath.get(path);
+        if (existing) {
+            // One schema reporting the same name twice is not a second fact.
+            if (!existing.names.has(additional)) {
+                existing.names.add(additional);
+                existing.issue.undeclared?.push(additional);
+            }
+            continue;
+        }
+        const issue = { path, message, undeclared: [additional] };
+        byPath.set(path, { issue, names: new Set([additional]) });
+        issues.push(issue);
+    }
+    return issues;
+}
+/**
+ * One failed union, re-stated as what each candidate objected to.
+ *
+ * `undefined` when the union cannot be attributed exactly — a candidate that is not a `$ref` to a
+ * registered component has no name to report it under, and a partly-named expansion would read as
+ * though the unnamed candidate had no objection. The raw errors are kept in that case, which is what
+ * AJV would have produced anyway.
+ */
+function expandUnion(error) {
+    const parent = error.parentSchema;
+    if (!isPlainObject(parent))
+        return undefined;
+    const members = Array.isArray(parent.oneOf) ? parent.oneOf : Array.isArray(parent.anyOf) ? parent.anyOf : undefined;
+    if (!members?.length)
+        return undefined;
+    const issues = [];
+    for (const member of members) {
+        const ref = isPlainObject(member) && typeof member.$ref === 'string' ? member.$ref : undefined;
+        if (!ref?.startsWith(COMPONENT_REF_PREFIX))
+            return undefined;
+        const validateMember = getAjv().getSchema(`${AJV_SCHEMA_ID}${ref}`);
+        if (!validateMember)
+            return undefined;
+        // `verbose: true` puts the value under evaluation on the error, so the candidates are run
+        // against exactly what the union saw.
+        if (validateMember(error.data))
+            continue;
+        const component = ref.slice(COMPONENT_REF_PREFIX.length);
+        for (const issue of toIssues(validateMember.errors ?? [], false)) {
+            issues.push({ ...issue, path: joinInstancePath(error.instancePath, issue.path), component });
+        }
+    }
+    return issues.length > 0 ? issues : undefined;
+}
+/** Re-roots a candidate-relative path under the union's own path. */
+function joinInstancePath(base, relative) {
+    if (relative === '/')
+        return base || '/';
+    return `${base}${relative}`;
+}
+/**
+ * The complete rendering of one issue — every name, no budget.
+ *
+ * This is what gets logged. A caller-facing message renders from {@link ApiValidationIssue} itself
+ * with a length limit rather than shortening this string; see `reportableErrors` in the enforcer.
+ */
+export function renderApiValidationIssue(issue) {
+    const head = renderApiValidationIssueHead(issue);
+    return issue.undeclared?.length ? `${head}: ${issue.undeclared.join(', ')}` : head;
+}
+/**
+ * Everything in a rendered issue except the property names: `<path> [as <component>]: <message>`.
+ *
+ * Exported because it is not the only renderer. A caller that has to bound the length of a message
+ * cannot use {@link renderApiValidationIssue} — it emits every name — and has to rebuild the line
+ * from {@link ApiValidationIssue} with its own budget for the names. Rebuilding the HEAD too is what
+ * lets the two drift: when `component` was added, the bounded renderer at the HTTP boundary went on
+ * concatenating path and message and silently dropped it, so callers were told
+ * `must NOT have additional properties: to, when` with no sign it was one candidate's claim. There is
+ * one definition of the head so that cannot happen again.
+ */
+export function renderApiValidationIssueHead(issue) {
+    return issue.component ? `${issue.path} as ${issue.component}: ${issue.message}` : `${issue.path} ${issue.message}`;
+}
+/** The failed branch of every validator here, so the two views cannot be built inconsistently. */
+function invalidResult(validate) {
+    const issues = collectIssues(validate);
+    return { valid: false, errors: issues.map(renderApiValidationIssue), issues };
+}
+/**
+ * Validates an untyped request body against the component the endpoint publishes.
+ *
+ * Non-mutating by design. AJV's removal modes are never used here: the server would then accept a
+ * body the published schema declares invalid, silently disagreeing with its own spec — and
+ * `removeAdditional: 'all'` additionally empties freeform maps. An undeclared property is reported,
+ * not deleted.
+ *
+ * The component type is handed back only on the `valid` branch, so a body missing required fields
+ * cannot be typed as complete. What the caller does with a failure — reject, or log and continue —
+ * is the endpoint's policy, not this function's.
+ */
+export function validateApiRequest(name, value) {
+    const validate = getValidator(name);
+    if (validate(value)) {
+        return { valid: true, data: value };
+    }
+    return invalidResult(validate);
+}
+/**
+ * Validates an already-mapped response against the component it is published as.
+ *
+ * Separate from {@link pruneAndValidateApiResponse} because a resource mapper has already produced
+ * the wire shape: there is nothing to prune, and pruning would only mask a mapper bug. Use this at
+ * the response boundary to detect drift between what the mapper builds and what the spec promises.
+ */
+export function validateApiResponse(name, value) {
+    const validate = getValidator(name);
+    if (validate(value)) {
+        return { valid: true, data: value };
+    }
+    return invalidResult(validate);
+}
+/**
+ * Best-effort normalization of a response payload towards the fields its published component
+ * declares. Use this on the response path INSTEAD of an AJV removal mode, which would empty
+ * freeform maps such as `Account.feature_flags`.
+ *
+ * NOT a secret-removal boundary. Ambiguous schema shapes pass values through untouched — see
+ * {@link pruneToSchema} and check a component with {@link findUnprunablePaths} before treating its
+ * output as closed. Fields that must never ship still need an explicit response mapper.
+ *
+ * Never throws and never rejects: an undocumented field is server-side drift, and failing the
+ * response would punish the caller for it.
+ *
+ * Takes a value the caller has already typed as the component. Pruning only REMOVES undeclared
+ * extras, so a conforming input yields a conforming output and the return type is honest. It does
+ * NOT validate, which is why it cannot accept `unknown` — narrowing a payload that is missing
+ * required fields would hand TypeScript a complete `Account` that does not exist at runtime. Use
+ * {@link pruneAndValidateApiResponse} when the payload's shape is not already established.
+ *
+ * Request validation stays separate and non-mutating — pruning a request would make the server
+ * silently disagree with the permissive schema it publishes.
+ */
+export function pruneApiResponse(name, value) {
+    return pruneToSchema(value, { $ref: apiComponentRef(name) }, ApiSchemaComponents);
+}
+/**
+ * Prunes an untyped payload and validates the result against the published component.
+ *
+ * The only sound entry point for a payload of unknown shape: the component type is handed back
+ * exclusively on the `valid` branch, so a document missing required fields cannot be typed as
+ * complete. On failure the pruned value is still returned — the caller decides whether to ship it
+ * and log, or fail — which keeps the "never turn drift into a 500" property a policy choice rather
+ * than something baked in here.
+ *
+ */
+export function pruneAndValidateApiResponse(name, value) {
+    const pruned = pruneToSchema(value, { $ref: apiComponentRef(name) }, ApiSchemaComponents);
+    const validate = getValidator(name);
+    if (validate(pruned)) {
+        return { valid: true, data: pruned };
+    }
+    return { ...invalidResult(validate), data: pruned };
+}
+/**
+ * Paths inside a component where pruning cannot narrow. Empty means no STRUCTURAL gaps for
+ * schema-conforming input — see {@link findUnprunablePaths} for why that is weaker than "nothing
+ * can escape". Anything listed needs an explicit response mapper.
+ */
+export function findUnprunableApiPaths(name) {
+    return findUnprunablePaths({ $ref: apiComponentRef(name) }, ApiSchemaComponents);
+}
+/**
+ * Normalizes raw query or header text into the value a component describes.
+ *
+ * Binds {@link normalizeParameters} to {@link ApiSchemaComponents} — the same objects the OpenAPI
+ * document publishes and {@link validateApiRequest} compiles. That is what keeps the published
+ * parameter and the enforced one the same declaration: the scanner expands this component's
+ * properties into `in: query` parameters, and the coercion below is decided by those same property
+ * schemas, so neither can be changed without changing the other.
+ *
+ * Validate the result with {@link validateApiRequest}, which is non-coercing: everything type-related
+ * has already happened here, so a value this could not coerce is reported against the published
+ * schema rather than by a second rule.
+ */
+export function normalizeApiParameters(name, raw, location) {
+    return normalizeParameters(name, raw, location, ApiSchemaComponents[name], ApiSchemaComponents);
+}
+//# sourceMappingURL=index.js.map

package/lib/api-contract/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/api-contract/index.ts"],"names":[],"mappings":"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"}