@powerlines/schema 0.11.77 → 0.11.78

package/dist/index.mjs

@@ -1027,7 +1027,7 @@ function stringifyType(schema) {
 	}
 	if (objectSchema.type === "array" && Array.isArray(objectSchema.enum)) return objectSchema.enum.map((value) => JSON.stringify(value)).join(" | ");
 	if (objectSchema.const !== void 0) return JSON.stringify(objectSchema.const);
-	if (objectSchema.type === "array" || objectSchema.items) return `${stringifyType(objectSchema.items)}[]`;
+	if (objectSchema.type === "array" || objectSchema.items) return `${stringifyType(Array.isArray(objectSchema.items) ? objectSchema.items[0] : objectSchema.items)}[]`;
 	if (objectSchema.type === "object" || objectSchema.properties || objectSchema.additionalProperties) {
 		if (isJsonSchema(objectSchema.additionalProperties)) return `{ [key: string]: ${stringifyType(objectSchema.additionalProperties)} }`;
 		if (isJsonSchemaObject(objectSchema)) {
@@ -1052,10 +1052,262 @@ function getJsonSchemaType(value) {
 	return isNull$1(value) ? "null" : isBoolean$1(value) ? "boolean" : isInteger(value) ? "integer" : isNumber$1(value) ? "number" : isString(value) ? "string" : isObject(value) ? "object" : Array.isArray(value) ? "array" : void 0;
 }
 /**
+* Resolves a local JSON Schema `$ref` (e.g. `#/$defs/Name`) to the referenced definition name.
+*/
+function resolveLocalRefName(ref) {
+	return /^#\/(?:definitions|\$defs)\/(.+)$/.exec(ref)?.[1];
+}
+/**
+* Converts an arbitrary definition name into a safe JavaScript identifier suffix.
+*/
+function toParserIdentifier(name) {
+	const cleaned = name.replace(/[^\w$]/gu, "_");
+	return `parse_${/^\d/u.test(cleaned) ? `_${cleaned}` : cleaned}`;
+}
+/**
+* Returns the list of JSON Schema `type` keyword values declared on a fragment,
+* preserving `object` and `array` (which {@link readSchemaTypes} intentionally drops).
+*/
+function readDeclaredTypes(schema) {
+	const type = schema.type;
+	if (Array.isArray(type)) return [...type];
+	return type ? [type] : [];
+}
+/**
+* Generates a JavaScript expression that builds a path string for a child element.
+*/
+function childPath(pathExpr, segment) {
+	return `${pathExpr} + ${JSON.stringify(segment)}`;
+}
+/**
+* Generates standalone parser code for a JSON Schema.
+*
+* @remarks
+* The generated `parse` function reads an arbitrary input value and converts it
+* into the shape described by the schema. It walks the schema recursively to:
+*
+* - resolve local `$ref` pointers (`#/$defs/*` and `#/definitions/*`) into
+*   dedicated parser functions so recursive schemas are supported,
+* - apply `default` values for object properties (and root/array values) that
+*   are missing from the input,
+* - coerce primitive values to the declared type (for example `"42"` to `42`
+*   for an `integer` schema, or `1` to `true` for a `boolean` schema),
+* - validate `const`, `enum`, `oneOf`/`anyOf` and `allOf` constraints, and
+* - collect detailed, path-aware errors and throw a `ParserError` when the
+*   input cannot be converted into a valid value.
+*
+* @param schema - The JSON Schema to generate parser code for.
+* @returns The generated standalone parser code as a string.
+*/
+function generateParserCode(schema) {
+	const rootSchema = typeof schema === "boolean" ? schema : schema;
+	const definitions = typeof rootSchema === "boolean" ? {} : {
+		...rootSchema.definitions,
+		...rootSchema.$defs
+	};
+	/**
+	* Generates a JavaScript expression that parses `valueExpr` against `fragment`.
+	* The expression has access to an in-scope mutable `errors` array.
+	*/
+	function generateExpression(fragment, valueExpr, pathExpr) {
+		if (typeof fragment === "boolean") return fragment ? valueExpr : `((value, path) => { errors.push({ path, message: "No value is allowed at this location" }); return value; })(${valueExpr}, ${pathExpr})`;
+		const view = fragment;
+		if (isSetString$1(view.$ref)) {
+			const refName = resolveLocalRefName(view.$ref);
+			if (refName && refName in definitions) return `${toParserIdentifier(refName)}(${valueExpr}, ${pathExpr}, errors)`;
+			return valueExpr;
+		}
+		return `((value, path) => {\n${generateBody(view)}\n})(${valueExpr}, ${pathExpr})`;
+	}
+	/**
+	* Generates the body statements (including a terminating `return`) for the
+	* arrow function produced by {@link generateExpression}.
+	*/
+	function generateBody(view) {
+		const lines = [];
+		const nullable = isSchemaNullable(view);
+		if (view.default !== void 0) lines.push(`if (value === undefined) { return ${JSON.stringify(view.default)}; }`);
+		else lines.push(`if (value === undefined) { errors.push({ path, message: "A value is required" }); return value; }`);
+		if (nullable) lines.push(`if (value === null) { return null; }`);
+		if (view.const !== void 0) {
+			const constValue = JSON.stringify(view.const);
+			lines.push(`if (JSON.stringify(value) !== ${JSON.stringify(constValue)}) { errors.push({ path, message: "Expected the constant value " + ${JSON.stringify(constValue)} }); }`, `return ${constValue};`);
+			return lines.join("\n");
+		}
+		if (Array.isArray(view.enum)) {
+			const enumValues = JSON.stringify(view.enum);
+			lines.push(`if (!${enumValues}.some(allowed => JSON.stringify(allowed) === JSON.stringify(value))) { errors.push({ path, message: "Expected one of " + ${JSON.stringify(enumValues)} }); }`, `return value;`);
+			return lines.join("\n");
+		}
+		if (Array.isArray(view.oneOf) || Array.isArray(view.anyOf)) {
+			const branchFns = (view.oneOf ?? view.anyOf ?? []).map((branch) => `(value, path, errors) => (${generateExpression(branch, "value", "path")})`).join(",\n");
+			lines.push(`const branches = [\n${branchFns}\n];`, `for (const branch of branches) {`, `  const branchErrors = [];`, `  const branchResult = branch(value, path, branchErrors);`, `  if (branchErrors.length === 0) { return branchResult; }`, `}`, `errors.push({ path, message: "Value does not match any of the allowed schemas" });`, `return value;`);
+			return lines.join("\n");
+		}
+		if (Array.isArray(view.allOf)) {
+			const { allOf, ...rest } = view;
+			const merged = merge(rest, ...allOf);
+			lines.push(`return ${generateExpression(merged, "value", "path")};`);
+			return lines.join("\n");
+		}
+		const declaredTypes = readDeclaredTypes(view);
+		switch (getPrimarySchemaType(view) ?? declaredTypes.find((type) => type !== "null") ?? (view.properties ? "object" : view.items ? "array" : void 0)) {
+			case "object":
+				lines.push(generateObjectBody(view));
+				break;
+			case "array":
+				lines.push(generateArrayBody(view));
+				break;
+			case "string":
+				lines.push(`if (typeof value === "string") { return value; }`, `if (typeof value === "number" || typeof value === "boolean") { return String(value); }`, `errors.push({ path, message: "Expected a string value" });`, `return value;`);
+				break;
+			case "integer":
+				lines.push(`if (typeof value === "number" && Number.isInteger(value)) { return value; }`, `if (typeof value === "string" && value.trim() !== "" && Number.isInteger(Number(value))) { return Number(value); }`, `if (typeof value === "boolean") { return value ? 1 : 0; }`, `errors.push({ path, message: "Expected an integer value" });`, `return value;`);
+				break;
+			case "number":
+				lines.push(`if (typeof value === "number") { return value; }`, `if (typeof value === "string" && value.trim() !== "" && !Number.isNaN(Number(value))) { return Number(value); }`, `if (typeof value === "boolean") { return value ? 1 : 0; }`, `errors.push({ path, message: "Expected a number value" });`, `return value;`);
+				break;
+			case "boolean":
+				lines.push(`if (typeof value === "boolean") { return value; }`, `if (value === "true" || value === 1) { return true; }`, `if (value === "false" || value === 0) { return false; }`, `errors.push({ path, message: "Expected a boolean value" });`, `return value;`);
+				break;
+			case "null":
+				lines.push(`if (value === null) { return null; }`, `errors.push({ path, message: "Expected a null value" });`, `return value;`);
+				break;
+			case void 0:
+			default:
+				lines.push(`return value;`);
+				break;
+		}
+		return lines.join("\n");
+	}
+	/**
+	* Generates the parsing statements for an `object` schema, applying property
+	* defaults and recursing into each declared property.
+	*/
+	function generateObjectBody(view) {
+		const lines = [`if (typeof value !== "object" || value === null || Array.isArray(value)) { errors.push({ path, message: "Expected an object value" }); return value; }`, `const result = {};`];
+		const properties = isJsonSchemaObject(view) ? getPropertiesList(view) : [];
+		const propertyNames = /* @__PURE__ */ new Set();
+		for (const property of properties) {
+			const name = property.name;
+			propertyNames.add(name);
+			const accessor = `value[${JSON.stringify(name)}]`;
+			const propertyPath = childPath("path", `.${name}`);
+			const propertyExpression = generateExpression(property, accessor, propertyPath);
+			const missingBranch = property.default !== void 0 ? `result[${JSON.stringify(name)}] = ${JSON.stringify(property.default)};` : property.required ? `errors.push({ path: ${propertyPath}, message: "Required property is missing" });` : ``;
+			lines.push(`if (${accessor} !== undefined) {`, `  result[${JSON.stringify(name)}] = ${propertyExpression};`, `}${missingBranch ? ` else { ${missingBranch} }` : ``}`);
+		}
+		const additional = view.additionalProperties;
+		if (isJsonSchema(additional)) {
+			const additionalExpression = generateExpression(additional, `value[key]`, `path + "." + key`);
+			lines.push(`for (const key of Object.keys(value)) {`, `  if (${JSON.stringify([...propertyNames])}.includes(key)) { continue; }`, `  result[key] = ${additionalExpression};`, `}`);
+		} else if (additional !== false) lines.push(`for (const key of Object.keys(value)) {`, `  if (${JSON.stringify([...propertyNames])}.includes(key)) { continue; }`, `  result[key] = value[key];`, `}`);
+		lines.push(`return result;`);
+		return lines.join("\n");
+	}
+	/**
+	* Generates the parsing statements for an `array` schema, recursing into each
+	* item (supporting both list and tuple `items`/`prefixItems` forms).
+	*/
+	function generateArrayBody(view) {
+		const lines = [`if (!Array.isArray(value)) { errors.push({ path, message: "Expected an array value" }); return value; }`];
+		const tupleItems = view.prefixItems ?? (Array.isArray(view.items) ? view.items : void 0);
+		if (tupleItems) {
+			const listItems = !Array.isArray(view.items) ? view.items : void 0;
+			const itemExpressions = tupleItems.map((item, index) => `index === ${index} ? (${generateExpression(item, "item", childPath("path", `[${index}]`))})`);
+			const fallbackExpression = listItems ? generateExpression(listItems, "item", `path + "[" + index + "]"`) : "item";
+			lines.push(`return value.map((item, index) => ${itemExpressions.join(" : ")}${itemExpressions.length > 0 ? " : " : ""}${fallbackExpression});`);
+			return lines.join("\n");
+		}
+		const itemExpression = generateExpression(view.items ?? true, "item", `path + "[" + index + "]"`);
+		lines.push(`return value.map((item, index) => ${itemExpression});`);
+		return lines.join("\n");
+	}
+	const parserFunctions = Object.entries(definitions).map(([name, definition]) => `function ${toParserIdentifier(name)}(value, path, errors) {\n  return ${generateExpression(definition, "value", "path")};\n}`);
+	const rootExpression = generateExpression(schema, "value", "\"$\"");
+	return `/**
+ * Error thrown when an input value cannot be parsed into the type described by the JSON Schema.
+ */
+export class ParserError extends Error {
+  constructor(errors) {
+    super(
+      "Failed to parse the provided value against the JSON Schema:\\n" +
+        errors.map(error => "  - " + error.path + ": " + error.message).join("\\n")
+    );
+
+    this.name = "ParserError";
+    this.errors = errors;
+  }
+}
+
+${parserFunctions.join("\n\n")}
+
+/**
+ * Parses an input value into the type described by the JSON Schema.
+ *
+ * @remarks
+ * The parser applies default values for missing properties, coerces primitive
+ * values to the declared type, and throws a {@link ParserError} (containing
+ * a detailed list of validation errors) when the value cannot be converted into
+ * a valid result.
+ *
+ * @param value - The input value to parse.
+ * @returns The parsed value conforming to the schema.
+ */
+export function parse(value) {
+  const errors = [];
+  const result = ${rootExpression};
+  if (errors.length > 0) {
+    throw new ParserError(errors);
+  }
+
+  return result;
+}`;
+}
+/**
 * Generates standalone JSON Schema validation code using Ajv.
+*
+* @remarks
+* The generated code includes a validation function that can be used to validate data against the provided JSON Schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+*
+* @param schema - The JSON Schema to generate validation code for.
+* @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+* @returns The generated standalone validation code as a string.
+*/
+function generateValidationCode(schema, refsOrFuncts) {
+	return standaloneCode(getValidator(schema), refsOrFuncts);
+}
+/**
+* Generates standalone JavaScript code for validating and parsing data according to a JSON Schema.
+*
+* @remarks
+* The generated code includes:
+* - Validation code generated by Ajv for the provided JSON Schema, which can be used to validate data against the schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+* - Parsing code generated for the provided JSON Schema, which can be used to parse and validate data against the schema at runtime. The parsing function will apply default values specified in the schema if they are not present in the input data, throw an error if the input data does not conform to the schema (providing detailed information about the validation errors), and return the parsed data if it is valid according to the schema.
+*
+* @param schema - The JSON Schema to generate code for.
+* @param refsOrFuncts - Optional additional references or functions for Ajv's standalone code generation.
+* @returns The generated standalone validation and parsing code as a string.
 */
-async function generateCode(schemas, refsOrFuncts) {
-	return standaloneCode(getValidator(schemas), refsOrFuncts);
+function generateCode(schema, refsOrFuncts) {
+	return `
+/**
+ * Validation code generated by Ajv for the provided JSON Schema. This code can be used to validate data against the schema at runtime. The validation function will throw an error if the data does not conform to the schema, providing detailed information about the validation errors.
+ *
+ * @see https://ajv.js.org/standalone.html
+ */
+
+${generateValidationCode(schema, refsOrFuncts)}
+
+/**
+ * Parsing code generated for the provided JSON Schema. This code can be used to parse and validate data against the schema at runtime. The parsing function will do the following:
+ * - Apply default values specified in the schema if they are not present in the input data
+ * - Throw an error if the input data does not conform to the schema, providing detailed information about the validation errors
+ * - Return the parsed data if it is valid according to the schema
+ */
+
+${generateParserCode(schema)}
+`;
 }
 
 //#endregion
@@ -2080,5 +2332,5 @@ async function extract(context, input, options = {}) {
 }
 
 //#endregion
-export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames, VALID_SOURCE_FILE_EXTENSIONS, addProperty, applyJsonSchemaMetadata, bundle, bundleReferences, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaWithSource, extractSource, extractVariant, generateCode, getCacheDirectory, getCacheFilePath, getJsonSchema, getJsonSchemaObject, getJsonSchemaType, getPrimarySchemaType, getProperties, getPropertiesList, isJsonSchema, isJsonSchemaAllOf, isJsonSchemaAny, isJsonSchemaAnyOf, isJsonSchemaArray, isJsonSchemaBigint, isJsonSchemaBoolean, isJsonSchemaDate, isJsonSchemaDecimal, isJsonSchemaEnum, isJsonSchemaInteger, isJsonSchemaKeywords, isJsonSchemaLiteral, isJsonSchemaMap, isJsonSchemaNativeEnum, isJsonSchemaNever, isJsonSchemaNull, isJsonSchemaNullable, isJsonSchemaNumber, isJsonSchemaObject, isJsonSchemaPrimitiveType, isJsonSchemaPrimitiveUnion, isJsonSchemaRecord, isJsonSchemaRef, isJsonSchemaSet, isJsonSchemaString, isJsonSchemaTuple, isJsonSchemaType, isJsonSchemaUndefined, isJsonSchemaUnion, isJsonSchemaUnknown, isNullOnlyJsonSchema, isPropertyOptional, isSchema, isSchemaNullable, isSchemaObject, isSchemaWithSource, isStandardSchema, isUntypedInput, isUntypedInputStrict, isUntypedSchema, isUntypedSchemaStrict, isValibotSchema, isValidSchemaInputFile, merge, readSchema, readSchemaSafe, readSchemaTypes, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };
+export { JSON_SCHEMA_METADATA_KEYS, JSON_SCHEMA_PRIMITIVE_TYPES, JSON_SCHEMA_TYPES, JsonSchemaTypeNames, VALID_SOURCE_FILE_EXTENSIONS, addProperty, applyJsonSchemaMetadata, bundle, bundleReferences, extract, extractHash, extractJsonSchema, extractReflection, extractResolvedVariant, extractSchema, extractSchemaWithSource, extractSource, extractVariant, generateCode, generateParserCode, generateValidationCode, getCacheDirectory, getCacheFilePath, getJsonSchema, getJsonSchemaObject, getJsonSchemaType, getPrimarySchemaType, getProperties, getPropertiesList, isJsonSchema, isJsonSchemaAllOf, isJsonSchemaAny, isJsonSchemaAnyOf, isJsonSchemaArray, isJsonSchemaBigint, isJsonSchemaBoolean, isJsonSchemaDate, isJsonSchemaDecimal, isJsonSchemaEnum, isJsonSchemaInteger, isJsonSchemaKeywords, isJsonSchemaLiteral, isJsonSchemaMap, isJsonSchemaNativeEnum, isJsonSchemaNever, isJsonSchemaNull, isJsonSchemaNullable, isJsonSchemaNumber, isJsonSchemaObject, isJsonSchemaPrimitiveType, isJsonSchemaPrimitiveUnion, isJsonSchemaRecord, isJsonSchemaRef, isJsonSchemaSet, isJsonSchemaString, isJsonSchemaTuple, isJsonSchemaType, isJsonSchemaUndefined, isJsonSchemaUnion, isJsonSchemaUnknown, isNullOnlyJsonSchema, isPropertyOptional, isSchema, isSchemaNullable, isSchemaObject, isSchemaWithSource, isStandardSchema, isUntypedInput, isUntypedInputStrict, isUntypedSchema, isUntypedSchemaStrict, isValibotSchema, isValidSchemaInputFile, merge, readSchema, readSchemaSafe, readSchemaTypes, reflectionToJsonSchema, resolve, resolveModule, resolveReflection, stringifyType, stringifyValue, writeSchema };
 //# sourceMappingURL=index.mjs.map