import type { DatafnFieldSchema } from "./types.js"; type DatafnFieldType = DatafnFieldSchema["type"]; type NoFieldOptions = Record; type DatafnFieldMetadataOptions = Partial< Pick >; type DatafnFieldCommonOptions = DatafnFieldMetadataOptions & { required?: boolean; } & ( | { nullable?: false; default?: Value; } | { nullable: true; default?: Value | null; } ); type DatafnEnumOptions = { enum?: readonly Value[]; }; /** A JSON-compatible value accepted by a DataFn JSON field. */ export type DatafnJsonValue = | null | boolean | number | string | readonly DatafnJsonValue[] | { readonly [key: string]: DatafnJsonValue }; /** Named options for a string field. */ export type DatafnStringFieldOptions = DatafnFieldCommonOptions & DatafnEnumOptions & { minLength?: number; maxLength?: number; pattern?: string; }; /** Named options for a number field. */ export type DatafnNumberFieldOptions = DatafnFieldCommonOptions & DatafnEnumOptions & { min?: number; max?: number; }; /** Named options for a boolean field. */ export type DatafnBooleanFieldOptions = DatafnFieldCommonOptions & DatafnEnumOptions; /** Named options for an object field. */ export type DatafnObjectFieldOptions = DatafnFieldCommonOptions< Readonly> >; /** Named options for an array field. */ export type DatafnArrayFieldOptions = DatafnFieldCommonOptions< readonly unknown[] > & { min?: number; max?: number; }; /** Named options for a date field. */ export type DatafnDateFieldOptions = DatafnFieldCommonOptions< string | number > & { min?: number; max?: number; }; /** Named options for a file-reference field. */ export type DatafnFileFieldOptions = DatafnFieldCommonOptions & DatafnEnumOptions; /** Named options for a JSON field. */ export type DatafnJsonFieldOptions = DatafnFieldCommonOptions< Exclude >; /** Maps each public field kind to its accepted named options. */ export type DatafnFieldOptionsByType = { string: DatafnStringFieldOptions; number: DatafnNumberFieldOptions; boolean: DatafnBooleanFieldOptions; object: DatafnObjectFieldOptions; array: DatafnArrayFieldOptions; date: DatafnDateFieldOptions; file: DatafnFileFieldOptions; json: DatafnJsonFieldOptions; }; type KeysOfUnion = Value extends Value ? keyof Value : never; type BooleanOption< Options, Key extends "required" | "nullable", > = Key extends keyof Options ? Options extends { readonly [Option in Key]-?: true } ? true : true extends Exclude ? boolean : false : false; type DefinedOption = Key extends keyof Options ? [Exclude] extends [never] ? Record : undefined extends Options[Key] ? { readonly [Option in Key]?: Exclude } : Options extends { readonly [Option in Key]-?: unknown } ? { readonly [Option in Key]: Options[Key] } : { readonly [Option in Key]?: Options[Key] } : Record; /** Plain field schema returned by a const-safe field builder. */ export type DatafnBuiltField< Name extends string, Type extends DatafnFieldType, Options extends DatafnFieldOptionsByType[Type], > = Options extends DatafnFieldOptionsByType[Type] ? Omit & DefinedOption & { readonly name: Name; readonly type: Type; readonly required: BooleanOption; readonly nullable: BooleanOption; } : never; function buildField< const Name extends string, Type extends DatafnFieldType, Options extends DatafnFieldOptionsByType[Type], >( name: Name, type: Type, options?: Options, ): DatafnBuiltField { const values = { ...options } as Record; if (values.default === undefined) { delete values.default; } return { ...values, name, type, required: values?.required ?? false, nullable: values?.nullable ?? false, } as DatafnBuiltField; } type DatafnFieldBuilder< Type extends DatafnFieldType, OptionsShape extends DatafnFieldOptionsByType[Type], > = { ( name: Name, ): DatafnBuiltField; // Infer the complete caller shape before validating it, so a weak options // constraint cannot discard unknown-only keys. Keep exported unions intact. ( name: Name, options: Options & ([Options] extends [OptionsShape] ? Record, KeysOfUnion>, never> : never), ): DatafnBuiltField>; }; function createFieldBuilder< Type extends DatafnFieldType, OptionsShape extends DatafnFieldOptionsByType[Type], >(type: Type): DatafnFieldBuilder { return ((name: string, options?: OptionsShape) => buildField(name, type, options)) as DatafnFieldBuilder; } /** * Const-safe field builders. Each builder returns a plain schema object, * preserves inference-relevant literals, and defaults `required` and * `nullable` to `false`. */ export const field = { string: createFieldBuilder<"string", DatafnStringFieldOptions>("string"), number: createFieldBuilder<"number", DatafnNumberFieldOptions>("number"), boolean: createFieldBuilder<"boolean", DatafnBooleanFieldOptions>("boolean"), object: createFieldBuilder<"object", DatafnObjectFieldOptions>("object"), array: createFieldBuilder<"array", DatafnArrayFieldOptions>("array"), date: createFieldBuilder<"date", DatafnDateFieldOptions>("date"), file: createFieldBuilder<"file", DatafnFileFieldOptions>("file"), json: createFieldBuilder<"json", DatafnJsonFieldOptions>("json"), } as const;