@palmares/schemas 0.0.1

package/dist/cjs/types/schema/types.d.ts

@@ -0,0 +1,70 @@
+import type BooleanSchema from './boolean';
+import type ObjectSchema from './object';
+import type Schema from './schema';
+import type StringSchema from './string';
+import type SchemaAdapter from '../adapter';
+import type FieldAdapter from '../adapter/fields';
+import type { ErrorCodes } from '../adapter/types';
+import type { ValidatorTypes } from '../validators/types';
+import type Validator from '../validators/utils';
+export type OnlyFieldAdaptersFromSchemaAdapter = keyof {
+    [key in keyof SchemaAdapter as SchemaAdapter[key] extends FieldAdapter ? key : never]: SchemaAdapter[key];
+};
+export type DefinitionsOfSchemaType = {
+    schemaType: 'array' | 'object' | 'string' | 'number' | 'boolean' | 'union' | 'datetime' | 'field' | 'datetime';
+    schemaAdapter: SchemaAdapter;
+    hasSave?: boolean;
+};
+export type ValidationFallbackCallbackType = Validator['fallbacks'][number];
+export type ValidationFallbackCallbackReturnType = {
+    parsed: any;
+    errors: {
+        isValid: boolean;
+        code: ErrorCodes;
+        message: string;
+        path: (string | number)[];
+    }[];
+    preventChildValidation?: boolean;
+};
+export type ValidationFallbackReturnType = {
+    type: ValidatorTypes;
+    callback: ValidationFallbackCallbackType;
+};
+type TypesOfSchema = Schema extends Schema<infer TType, any> ? TType : never;
+type ExtractTypeFromSchemaByTypeOfSchema<TSchema extends Schema, TTypeToExtract extends keyof TypesOfSchema = 'input'> = TSchema extends Schema<{
+    input: infer TInputType;
+    validate: infer TValidateType;
+    internal: infer TInternalType;
+    output: infer TOutputType;
+    representation: infer TRepresentationType;
+}, any> | StringSchema<{
+    input: infer TInputType;
+    validate: infer TValidateType;
+    internal: infer TInternalType;
+    output: infer TOutputType;
+    representation: infer TRepresentationType;
+}, any> | ObjectSchema<{
+    input: infer TInputType;
+    validate: infer TValidateType;
+    internal: infer TInternalType;
+    output: infer TOutputType;
+    representation: infer TRepresentationType;
+}, any, any> | BooleanSchema<{
+    input: infer TInputType;
+    validate: infer TValidateType;
+    internal: infer TInternalType;
+    output: infer TOutputType;
+    representation: infer TRepresentationType;
+}, any> ? TTypeToExtract extends 'input' ? TInputType : TTypeToExtract extends 'validate' ? TValidateType : TTypeToExtract extends 'internal' ? TInternalType : TTypeToExtract extends 'output' ? TOutputType : TRepresentationType : never;
+export type ExtractTypeFromObjectOfSchemas<TData extends Record<string, Schema>, TTypeToExtract extends keyof TypesOfSchema = 'input'> = {
+    [key in keyof TData as undefined extends ExtractTypeFromSchemaByTypeOfSchema<TData[key], TTypeToExtract> ? never : key]: ExtractTypeFromSchemaByTypeOfSchema<TData[key], TTypeToExtract>;
+} & {
+    [key in keyof TData as undefined extends ExtractTypeFromSchemaByTypeOfSchema<TData[key], TTypeToExtract> ? key : never]?: ExtractTypeFromSchemaByTypeOfSchema<TData[key], TTypeToExtract>;
+};
+export type ExtractTypeFromArrayOfSchemas<TSchemas extends readonly [Schema, ...Schema[]] | [Schema[]], TTypeToExtract extends keyof TypesOfSchema = 'input', TResult extends any[] = []> = TSchemas extends readonly [infer TSchema, ...infer TRestSchemas] ? TSchema extends Schema ? TRestSchemas extends readonly [Schema, ...Schema[]] ? ExtractTypeFromArrayOfSchemas<TRestSchemas, TTypeToExtract, [
+    ...TResult,
+    ExtractTypeFromSchemaByTypeOfSchema<TSchema, TTypeToExtract>
+]> : [...TResult, ExtractTypeFromSchemaByTypeOfSchema<TSchema, TTypeToExtract>] : TSchemas extends [infer TArraySchema] ? TArraySchema extends Schema[] ? ExtractTypeFromSchemaByTypeOfSchema<TArraySchema[number], TTypeToExtract>[] : never : never : never;
+export type ExtractUnionTypesFromSchemas<TSchemas extends readonly Schema<any, any>[]> = TSchemas[number] extends Schema<infer TType, any> ? TType : never;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types/schema/types.d.ts.map

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

package/dist/cjs/types/schema/union.d.ts

@@ -0,0 +1,388 @@
+import Schema from './schema';
+import type { DefinitionsOfSchemaType } from './types';
+import type FieldAdapter from '../adapter/fields';
+import type { Narrow } from '@palmares/core';
+export default class UnionSchema<TType extends {
+    input: any;
+    validate: any;
+    internal: any;
+    representation: any;
+    output: any;
+} = {
+    input: Record<any, any>;
+    output: Record<any, any>;
+    validate: Record<any, any>;
+    internal: Record<any, any>;
+    representation: Record<any, any>;
+}, TDefinitions extends DefinitionsOfSchemaType = DefinitionsOfSchemaType, TSchemas extends readonly [Schema<any, any>, Schema<any, any>, ...Schema<any, any>[]] = [
+    Schema<any, any>,
+    Schema<any, any>,
+    ...Schema<any, any>[]
+]> extends Schema<TType, TDefinitions> {
+    protected __schemas: Set<Schema<any, DefinitionsOfSchemaType>>;
+    constructor(schemas: TSchemas);
+    protected _transformToAdapter(options: Parameters<Schema['__transformToAdapter']>[0]): Promise<ReturnType<FieldAdapter['translate']>>;
+    /**
+     * This let's you refine the schema with custom validations. This is useful when you want to validate something that is not supported by default by the schema adapter.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const numberSchema = p.number().refine((value) => {
+     *   if (value < 0) return { code: 'invalid_number', message: 'The number should be greater than 0' };
+     * });
+     *
+     * const { errors, parsed } = await numberSchema.parse(-1);
+     *
+     * console.log(errors); // [{ isValid: false, code: 'invalid_number', message: 'The number should be greater than 0', path: [] }]
+     * ```
+     *
+     * @param refinementCallback - The callback that will be called to validate the value.
+     * @param options - Options for the refinement.
+     * @param options.isAsync - Whether the callback is async or not. Defaults to true.
+     */
+    refine(refinementCallback: (value: TType['input']) => Promise<void | undefined | {
+        code: string;
+        message: string;
+    }> | void | undefined | {
+        code: string;
+        message: string;
+    }): UnionSchema<{
+        input: TType["input"];
+        validate: TType["validate"];
+        internal: TType["internal"];
+        output: TType["output"];
+        representation: TType["representation"];
+    }, TDefinitions, TSchemas>;
+    /**
+     * Allows the value to be either undefined or null.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const numberSchema = p.number().optional();
+     *
+     * const { errors, parsed } = await numberSchema.parse(undefined);
+     *
+     * console.log(parsed); // undefined
+     *
+     * const { errors, parsed } = await numberSchema.parse(null);
+     *
+     * console.log(parsed); // null
+     *
+     * const { errors, parsed } = await numberSchema.parse(1);
+     *
+     * console.log(parsed); // 1
+     * ```
+     *
+     * @returns - The schema we are working with.
+     */
+    optional(options?: {
+        message: string;
+        allow: false;
+    }): UnionSchema<{
+        input: TType["input"] | undefined | null;
+        validate: TType["validate"] | undefined | null;
+        internal: TType["internal"] | undefined | null;
+        output: TType["output"] | undefined | null;
+        representation: TType["representation"] | undefined | null;
+    }, TDefinitions, TSchemas>;
+    /**
+     * Allows the value to be null and ONLY null. You can also use this function to set a custom message when the value is NULL by setting
+     * the { message: 'Your custom message', allow: false } on the options.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const numberSchema = p.number().nullable();
+     *
+     * const { errors, parsed } = await numberSchema.parse(null);
+     *
+     * console.log(parsed); // null
+     *
+     * const { errors, parsed } = await numberSchema.parse(undefined);
+     *
+     * console.log(errors); // [{ isValid: false, code: 'invalid_type', message: 'Invalid type', path: [] }]
+     * ```
+     *
+     * @param options - The options for the nullable function.
+     * @param options.message - The message to be shown when the value is not null. Defaults to 'Cannot be null'.
+     * @param options.allow - Whether the value can be null or not. Defaults to true.
+     *
+     * @returns The schema.
+     */
+    nullable(options?: {
+        message: string;
+        allow: false;
+    }): UnionSchema<{
+        input: TType["input"] | null;
+        validate: TType["validate"] | null;
+        internal: TType["internal"] | null;
+        output: TType["output"] | null;
+        representation: TType["representation"] | null;
+    }, TDefinitions, TSchemas>;
+    /**
+     * This method will remove the value from the representation of the schema. If the value is undefined it will keep that way
+     * otherwise it will set the value to undefined after it's validated.
+     * This is used in conjunction with the {@link data} function, the {@link parse} function or {@link validate}
+     * function. This will remove the value from the representation of the schema.
+     *
+     * By default, the value will be removed just from the representation, in other words, when you call the {@link data} function.
+     * But if you want to remove the value from the internal representation, you can pass the argument `toInternal` as true.
+     * Then if you still want to remove the value from the representation, you will need to pass the argument `toRepresentation` as true as well.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const userSchema = p.object({
+     *   id: p.number().optional(),
+     *   name: p.string(),
+     *   password: p.string().omit()
+     * });
+     *
+     * const user = await userSchema.data({
+     *  id: 1,
+     *  name: 'John Doe',
+     *  password: '123456'
+     * });
+     *
+     * console.log(user); // { id: 1, name: 'John Doe' }
+     * ```
+     *
+     *
+     * @param args - By default, the value will be removed just from the representation, in other words, when you call the {@link data} function.
+     * But if you want to remove the value from the internal representation, you can pass the argument `toInternal` as true.
+     * Then if you still want to remove the value from the representation, you will need to pass the argument `toRepresentation` as true as well.
+     *
+     * @returns The schema.
+     */
+    omit<TToInternal extends boolean, TToRepresentation extends boolean = boolean extends TToInternal ? true : false>(args?: {
+        toInternal?: TToInternal;
+        toRepresentation?: TToRepresentation;
+    }): UnionSchema<{
+        input: TToInternal extends true ? TType["input"] | undefined : TType["input"];
+        validate: TToInternal extends true ? TType["validate"] | undefined : TType["validate"];
+        internal: TToInternal extends true ? undefined : TType["internal"];
+        output: TToRepresentation extends true ? TType["output"] | undefined : TType["output"];
+        representation: TToRepresentation extends true ? undefined : TType["representation"];
+    }, TDefinitions, TSchemas>;
+    /**
+     * This function is used in conjunction with the {@link validate} function. It's used to save a value to an external source
+     * like a database. You should always return the schema after you save the value, that way we will always have the correct type
+     * of the schema after the save operation.
+     *
+     * You can use the {@link toRepresentation} function to transform and clean the value it returns after the save.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * import { User } from './models';
+     *
+     * const userSchema = p.object({
+     *   id: p.number().optional(),
+     *   name: p.string(),
+     *   email: p.string().email(),
+     * }).onSave(async (value) => {
+     *   // Create or update the user on the database using palmares models or any other library of your choice.
+     *   if (value.id)
+     *      await User.default.set(value, { search: { id: value.id } });
+     *   else
+     *      await User.default.set(value);
+     *
+     *   return value;
+     * });
+     *
+     *
+     * // Then, on your controller, do something like this:
+     * const { isValid, save, errors } = await userSchema.validate(req.body);
+     * if (isValid) {
+     *    const savedValue = await save();
+     *    return Response.json(savedValue, { status: 201 });
+     * }
+     *
+     * return Response.json({ errors }, { status: 400 });
+     * ```
+     *
+     * @param callback - The callback that will be called to save the value on an external source.
+     *
+     * @returns The schema.
+     */
+    onSave(callback: (value: TType['internal']) => Promise<TType['output']> | TType['output']): UnionSchema<{
+        input: TType["input"];
+        validate: TType["validate"];
+        internal: TType["internal"];
+        output: TType["output"];
+        representation: TType["representation"];
+    }, TDefinitions & {
+        hasSave: true;
+    }, TSchemas>;
+    /**
+     * This function is used to add a default value to the schema. If the value is either undefined or null, the default value will be used.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const numberSchema = p.number().default(0);
+     *
+     * const { errors, parsed } = await numberSchema.parse(undefined);
+     *
+     * console.log(parsed); // 0
+     * ```
+     */
+    default<TDefaultValue extends TType['input'] | (() => Promise<TType['input']>)>(defaultValueOrFunction: TDefaultValue): UnionSchema<{
+        input: TType["input"] | undefined | null;
+        validate: TType["validate"];
+        internal: TType["internal"];
+        output: TType["output"] | undefined | null;
+        representation: TType["representation"];
+    }, TDefinitions, TSchemas>;
+    /**
+     * This function let's you customize the schema your own way. After we translate the schema on the adapter we call this function to let you customize
+     * the custom schema your own way. Our API does not support passthrough? No problem, you can use this function to customize the zod schema.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const numberSchema = p.number().extends((schema) => {
+     *   return schema.nonnegative();
+     * });
+     *
+     * const { errors, parsed } = await numberSchema.parse(-1);
+     *
+     * console.log(errors); // [{ isValid: false, code: 'nonnegative', message: 'The number should be nonnegative', path: [] }]
+     * ```
+     *
+     * @param callback - The callback that will be called to customize the schema.
+     * @param toStringCallback - The callback that will be called to transform the schema to a string when you want to compile the underlying schema
+     * to a string so you can save it for future runs.
+     *
+     * @returns The schema.
+     */
+    extends(callback: (schema: Awaited<ReturnType<NonNullable<TDefinitions['schemaAdapter']['union']>['translate']>>) => Awaited<ReturnType<NonNullable<TDefinitions['schemaAdapter']['field']>['translate']>> | any, toStringCallback?: (schemaAsString: string) => string): this;
+    /**
+     * This function is used to transform the value to the representation of the schema. When using the {@link data} function. With this function you have full
+     * control to add data cleaning for example, transforming the data and whatever. Another use case is when you want to return deeply nested recursive data.
+     * The schema maps to itself.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const recursiveSchema = p.object({
+     *   id: p.number().optional(),
+     *   name: p.string(),
+     * }).toRepresentation(async (value) => {
+     *    return {
+     *      id: value.id,
+     *      name: value.name,
+     *      children: await Promise.all(value.children.map(async (child) => await recursiveSchema.data(child)))
+     *    }
+     * });
+     *
+     * const data = await recursiveSchema.data({
+     *    id: 1,
+     *    name: 'John Doe',
+     * });
+     * ```
+     *
+     * @example
+     * ```
+     * import * as p from '@palmares/schemas';
+     *
+     * const colorToRGBSchema = p.string().toRepresentation(async (value) => {
+     *    switch (value) {
+     *      case 'red': return { r: 255, g: 0, b: 0 };
+     *      case 'green': return { r: 0, g: 255, b: 0 };
+     *      case 'blue': return { r: 0, g: 0, b: 255 };
+     *      default: return { r: 0, g: 0, b: 0 };
+     *   }
+     * });
+     * ```
+     * @param toRepresentationCallback - The callback that will be called to transform the value to the representation.
+     *
+     * @returns The schema with a new return type
+     */
+    toRepresentation<TRepresentation>(toRepresentationCallback: (value: TType['representation']) => Promise<TRepresentation>): UnionSchema<{
+        input: TType["input"];
+        validate: TType["validate"];
+        internal: TType["internal"];
+        output: TType["output"];
+        representation: TRepresentation;
+    }, TDefinitions, TSchemas>;
+    /**
+     * This function is used to transform the value to the internal representation of the schema. This is useful when you want to transform the value
+     * to a type that the schema adapter can understand. For example, you might want to transform a string to a date. This is the function you use.
+     *
+     * @example
+     * ```typescript
+     * import * as p from '@palmares/schemas';
+     *
+     * const dateSchema = p.string().toInternal((value) => {
+     *   return new Date(value);
+     * });
+     *
+     * const date = await dateSchema.parse('2021-01-01');
+     *
+     * console.log(date); // Date object
+     *
+     * const rgbToColorSchema = p.object({
+     *   r: p.number().min(0).max(255),
+     *   g: p.number().min(0).max(255),
+     *   b: p.number().min(0).max(255),
+     * }).toInternal(async (value) => {
+     *    if (value.r === 255 && value.g === 0 && value.b === 0) return 'red';
+     *    if (value.r === 0 && value.g === 255 && value.b === 0) return 'green';
+     *    if (value.r === 0 && value.g === 0 && value.b === 255) return 'blue';
+     *    return `rgb(${value.r}, ${value.g}, ${value.b})`;
+     * });
+     * ```
+     *
+     * @param toInternalCallback - The callback that will be called to transform the value to the internal representation.
+     *
+     * @returns The schema with a new return type.
+     */
+    toInternal<TInternal>(toInternalCallback: (value: TType['validate']) => Promise<TInternal>): UnionSchema<{
+        input: TType["input"];
+        validate: TType["validate"];
+        internal: TInternal;
+        output: TType["output"];
+        representation: TType["representation"];
+    }, TDefinitions, TSchemas>;
+    /**
+     * Called before the validation of the schema. Let's say that you want to validate a date that might receive a string, you can convert that string to a date
+     * here BEFORE the validation. This pretty much transforms the value to a type that the schema adapter can understand.
+     *
+     * @example
+     * ```
+     * import * as p from '@palmares/schemas';
+     * import * as z from 'zod';
+     *
+     * const customRecordToMapSchema = p.schema().appendSchema(z.map()).toValidate(async (value) => {
+     *    return new Map(value); // Before validating we transform the value to a map.
+     * });
+     *
+     * const { errors, parsed } = await customRecordToMapSchema.parse({ key: 'value' });
+     * ```
+     *
+     * @param toValidateCallback - The callback that will be called to validate the value.
+     *
+     * @returns The schema with a new return type.
+     */
+    toValidate<TValidate>(toValidateCallback: (value: TType['input']) => Promise<TValidate> | TValidate): UnionSchema<{
+        input: TType["input"];
+        validate: TValidate;
+        internal: TType["internal"];
+        output: TType["output"];
+        representation: TType["representation"];
+    }, TDefinitions, TSchemas>;
+    static new<TSchemas extends readonly [Schema<any, any>, Schema<any, any>, ...Schema<any, any>[]], TDefinitions extends DefinitionsOfSchemaType = DefinitionsOfSchemaType>(schemas: Narrow<TSchemas>): UnionSchema<TSchemas[number] extends Schema<infer TType, any> ? TType : never>;
+}
+export declare const union: typeof UnionSchema.new;
+//# sourceMappingURL=union.d.ts.map

package/dist/cjs/types/schema/union.d.ts.map

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

package/dist/cjs/types/types.d.ts

@@ -0,0 +1,11 @@
+import type Schema from './schema/schema';
+import type { ValidatorTypes } from './validators/types';
+export type MaybePromise<T> = T | Promise<T>;
+export type FallbackFunctionsType<TArguments> = {
+    [TKey in keyof TArguments]?: (args: NonNullable<TArguments[TKey]>) => {
+        type: ValidatorTypes;
+        callback: NonNullable<Schema['__rootFallbacksValidator']['fallbacks'][number]>;
+    };
+};
+export type SupportedSchemas = 'number' | 'object' | 'union' | 'string' | 'array' | 'boolean' | 'datetime';
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,iBAAiB,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAE7C,MAAM,MAAM,qBAAqB,CAAC,UAAU,IAAI;KAC7C,IAAI,IAAI,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK;QACpE,IAAI,EAAE,cAAc,CAAC;QACrB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KAChF;CACF,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC"}

package/dist/cjs/types/utils.d.ts

@@ -0,0 +1,79 @@
+import type SchemaAdapter from './adapter';
+import type FieldAdapter from './adapter/fields';
+import type { ValidationDataBasedOnType } from './adapter/types';
+import type Schema from './schema/schema';
+import type { ValidationFallbackCallbackReturnType, ValidationFallbackReturnType } from './schema/types';
+import type { FallbackFunctionsType, SupportedSchemas } from './types';
+/**
+ * The usage of this is that imagine that the library doesn't support a specific feature that we support on our schema definition, it can return an instance
+ * of this class and with this instance we are able to fallback to our default implementation of the schema validation.
+ */
+export default class WithFallback<TType extends SupportedSchemas> {
+    fallbackFor: Set<keyof Omit<ValidationDataBasedOnType<TType>, 'withFallback' | 'parsers'> | keyof ValidationDataBasedOnType<TType>['parsers']>;
+    transformedSchema: any;
+    adapterType: TType;
+    constructor(adapterType: TType, fallbackFor: (keyof Omit<ValidationDataBasedOnType<TType>, 'withFallback' | 'parsers'> | keyof ValidationDataBasedOnType<TType>['parsers'])[], transformedSchema: any);
+}
+/**
+ * Factory function for creating a new instance of WithFallback. We call that function when parsing the schema adapter, and then, inside of the adapter the user will can the inner function
+ * to create a new instance of WithFallback.
+ *
+ * @param adapterType - The type of the adapter that we are using.
+ *
+ * @returns - A currying function that will create a new instance of WithFallback.
+ */
+export declare function withFallbackFactory<TType extends SupportedSchemas>(adapterType: TType): (fallbackFor: (keyof Omit<ValidationDataBasedOnType<TType>, "withFallback" | "parsers"> | keyof ValidationDataBasedOnType<TType>["parsers"])[], transformedSchema: WithFallback<SupportedSchemas>["transformedSchema"]) => WithFallback<TType>;
+export declare function parseErrorsFactory(schemaAdapter: SchemaAdapter): (errorOrErrors: any | any[], metadata?: any) => Promise<Awaited<ReturnType<SchemaAdapter["formatError"]>>[]>;
+/**
+ * The default transform function that we use for the schema adapters. This function tries to abstract away the complexity of translating the schema to the adapter.
+ *
+ * So first things first, WHAT IS a fallback? A fallback is a function that we call when the user defines a validation that is not supported by the adapter. For example, imagine that
+ * for some reason the adapter doesn't support the `max` validation, we can define a fallback for that validation and then, when the user defines that validation, we call the fallback
+ * function. So, even if the adapter doesn't support that validation our schema will still be able to validate that.
+ *
+ * @param type - The type of the adapter that we are using, can be a number, an object, all of the possible schema adapters.
+ * @param schema - The schema that we are translating.
+ * @param validationData - The data that we are using to validate the schema. This means for example, the `max` validation, the `min` validation, etc. The message of the validation when
+ * it is not valid, etc.
+ * @param fallbackFunctions - The fallback functions that we are using to validate the schema. Those are the functions we fallback to when the user defines a validation that is not
+ * supported by the adapter.
+ *
+ * @returns - The translated schema for something that the adapter is able to understand.
+ */
+export declare function defaultTransform<TType extends SupportedSchemas>(type: TType, schema: Schema<any, any>, adapter: SchemaAdapter, fieldAdapter: FieldAdapter | undefined, getValidationData: (isStringVersion: boolean) => ValidationDataBasedOnType<TType>, fallbackFunctions: FallbackFunctionsType<Omit<Awaited<ReturnType<typeof getValidationData>>, 'parsers'>>, options: {
+    validatorsIfFallbackOrNotSupported?: ValidationFallbackReturnType | ValidationFallbackReturnType[];
+    /**
+     * If the schema is not supported by the adapter, this means, that the adapter hasn't defined an adapter for that field type, we can fallback to a custom implementation.
+     * The problem is that, for example: Unions,
+     *
+     * Let's say we have a schema like this: ObjectSchema.new({ age: UnionSchema.new([NumberSchema.new(), StringSchema.new()] )});
+     *
+     * The root object will be validated by the adapter so what we need to do is create two schemas on the root object, one where the
+     * value of `age` key is a number and another where the value of `age` key is a string. Now the root object has two schemas memoized on __transformedSchemas, nice,
+     * what's the logic on that case? The ObjectSchema shouldn't take care of that logic. So the Union schema takes control of validating through the adapter. Is adapter 1 without errors?
+     * If yes, return the result, if not, try the second adapter. If the second adapter is without errors, return the result, if not, return the errors.
+     *
+     * In other words, the `fallbackIfNotSupported` function on Unions should return the two schemas saved on it on that case, that way the root ObjectSchema will
+     * create those two schemas on the array.
+     */
+    fallbackIfNotSupported?: () => ReturnType<Schema['__transformToAdapter']>;
+} & Pick<Parameters<Schema['__transformToAdapter']>[0], 'shouldAddStringVersion'>): Promise<any[]>;
+/**
+ * This function is used to transform the schema to the adapter. By default it caches the transformed schemas on the schema instance. So on subsequent validations we don't need
+ * to transform to the schema again.
+ */
+export declare function defaultTransformToAdapter(callback: (adapter: SchemaAdapter) => ReturnType<FieldAdapter['translate']>, transformedSchemas: Schema['__transformedSchemas'], options: Parameters<Schema['__transformToAdapter']>[0], type: string): Promise<any[]>;
+export declare function formatErrorFromParseMethod(adapter: SchemaAdapter, fieldAdapter: FieldAdapter, error: any, path: ValidationFallbackCallbackReturnType['errors'][number]['path'], errorsAsHashedSet: Set<string>): Promise<{
+    isValid: boolean;
+    code: import("./adapter/types").ErrorCodes;
+    message: string;
+    path: (string | number)[];
+}>;
+/**
+ * Transform the schema and check if we should add a fallback validation for that schema. This is used for complex schemas like Objects, arrays, unions, etc.
+ */
+export declare function transformSchemaAndCheckIfShouldBeHandledByFallbackOnComplexSchemas(schema: Schema, options: Parameters<Schema['__transformToAdapter']>[0]): Promise<readonly [{
+    transformed: ReturnType<FieldAdapter["translate"]>;
+    asString: string;
+}[], boolean]>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/cjs/types/utils.d.ts.map

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

package/dist/cjs/types/validators/array.d.ts

@@ -0,0 +1,8 @@
+import type ArraySchema from '../schema/array';
+import type Schema from '../schema/schema';
+import type { ValidationFallbackReturnType } from '../schema/types';
+export declare function arrayValidation(isTuple: boolean, schemas: Schema<any, any>[]): ValidationFallbackReturnType;
+export declare function minLength(args: ArraySchema['__minLength']): ValidationFallbackReturnType;
+export declare function maxLength(args: ArraySchema['__maxLength']): ValidationFallbackReturnType;
+export declare function nonEmpty(args: ArraySchema['__nonEmpty']): ValidationFallbackReturnType;
+//# sourceMappingURL=array.d.ts.map

package/dist/cjs/types/validators/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../../../../src/validators/array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,EAAwC,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE1G,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,4BAA4B,CAoF3G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,4BAA4B,CAuBxF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,aAAa,CAAC,GAAG,4BAA4B,CAuBxF;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,4BAA4B,CAuBtF"}

package/dist/cjs/types/validators/boolean.d.ts

@@ -0,0 +1,4 @@
+import type { ValidationFallbackReturnType } from '../schema/types';
+export declare function booleanValidation(): ValidationFallbackReturnType;
+export declare function allowStringParser(): ValidationFallbackReturnType;
+//# sourceMappingURL=boolean.d.ts.map

package/dist/cjs/types/validators/boolean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean.d.ts","sourceRoot":"","sources":["../../../../src/validators/boolean.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAEpE,wBAAgB,iBAAiB,IAAI,4BAA4B,CAwBhE;AAED,wBAAgB,iBAAiB,IAAI,4BAA4B,CAgBhE"}

package/dist/cjs/types/validators/datetime.d.ts

@@ -0,0 +1,7 @@
+import type DatetimeSchema from '../schema/datetime';
+import type { ValidationFallbackReturnType } from '../schema/types';
+export declare function datetimeValidation(): ValidationFallbackReturnType;
+export declare function allowStringParser(): ValidationFallbackReturnType;
+export declare function below(args: DatetimeSchema['__below']): ValidationFallbackReturnType;
+export declare function above(args: DatetimeSchema['__above']): ValidationFallbackReturnType;
+//# sourceMappingURL=datetime.d.ts.map

package/dist/cjs/types/validators/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../../../src/validators/datetime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,cAAc,MAAM,oBAAoB,CAAC;AAErD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAEpE,wBAAgB,kBAAkB,IAAI,4BAA4B,CAwBjE;AAED,wBAAgB,iBAAiB,IAAI,4BAA4B,CAwBhE;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,4BAA4B,CA2BnF;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,GAAG,4BAA4B,CA2BnF"}

package/dist/cjs/types/validators/number.d.ts

@@ -0,0 +1,10 @@
+import type NumberSchema from '../schema/number';
+import type { ValidationFallbackReturnType } from '../schema/types';
+export declare function numberValidation(): ValidationFallbackReturnType;
+export declare function max(args: NumberSchema['__max']): ValidationFallbackReturnType;
+export declare function min(args: NumberSchema['__min']): ValidationFallbackReturnType;
+export declare function negative(args: NumberSchema['__allowNegative']): ValidationFallbackReturnType;
+export declare function positive(args: NumberSchema['__allowPositive']): ValidationFallbackReturnType;
+export declare function maxDigits(args: NumberSchema['__maxDigits']): ValidationFallbackReturnType;
+export declare function decimalPlaces(args: NumberSchema['__decimalPlaces']): ValidationFallbackReturnType;
+//# sourceMappingURL=number.d.ts.map

package/dist/cjs/types/validators/number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../../src/validators/number.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAEjD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAEpE,wBAAgB,gBAAgB,IAAI,4BAA4B,CAmB/D;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,4BAA4B,CAiC7E;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,4BAA4B,CA+B7E;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,4BAA4B,CAsB5F;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,4BAA4B,CAsB5F;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,aAAa,CAAC,GAAG,4BAA4B,CAsBzF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,iBAAiB,CAAC,GAAG,4BAA4B,CAsBjG"}

package/dist/cjs/types/validators/object.d.ts

@@ -0,0 +1,6 @@
+import type Schema from '../schema/schema';
+import type { ValidationFallbackReturnType } from '../schema/types';
+export declare function objectValidation(keysToFallback: {
+    [key: string]: Schema;
+}): ValidationFallbackReturnType;
+//# sourceMappingURL=object.d.ts.map