@beignet/core/dist/contracts/schema-shape.js

Core framework primitives for Beignet

/**
 * Internal schema shape helpers shared by server route registration and
 * OpenAPI generation.
 *
 * These helpers are intentionally zod-free: zod is an optional peer
 * dependency, so shape extraction duck-types Zod's `_def.shape` internals and
 * returns undefined for schemas it cannot introspect. This module is not
 * exported from the package index.
 */
/**
 * Extract the field shape (field name → field schema) from an object schema.
 *
 * Returns undefined when the schema is not an introspectable object schema,
 * for example a non-Zod Standard Schema.
 */
export function getObjectSchemaShape(schema) {
    if (!schema || typeof schema !== "object")
        return undefined;
    const schemaDef = schema?._def;
    if (!schemaDef || typeof schemaDef !== "object")
        return undefined;
    if (!("shape" in schemaDef))
        return undefined;
    let shape;
    if (typeof schemaDef.shape === "function") {
        shape = schemaDef.shape();
    }
    else if (typeof schemaDef.shape === "object") {
        shape = schemaDef.shape;
    }
    if (!shape || typeof shape !== "object")
        return undefined;
    return shape;
}
/**
 * Compare a path template's dynamic keys against a pathParams schema shape.
 */
export function comparePathParamsToTemplate(args) {
    const missingKeys = args.pathKeys.filter((key) => !args.shapeKeys.includes(key));
    const extraKeys = args.shapeKeys.filter((key) => !args.pathKeys.includes(key));
    return { missingKeys, extraKeys };
}
/**
 * Format a pathParams/template mismatch for error messages.
 *
 * Shared so server registration and OpenAPI generation report the same
 * diagnostic details.
 */
export function formatPathParamsMismatch(args) {
    return [
        args.missingKeys.length > 0
            ? `missing pathParams keys: ${args.missingKeys.join(", ")}`
            : undefined,
        args.extraKeys.length > 0
            ? `extra pathParams keys: ${args.extraKeys.join(", ")}`
            : undefined,
    ]
        .filter(Boolean)
        .join("; ");
}
//# sourceMappingURL=schema-shape.js.map