drizzle-seed 1.0.0-beta.2-58a4521 → 1.0.0-beta.2-278d7e6

package/generators/GeneratorFuncs.d.cts

@@ -1,7 +1,8 @@
-import type { AbstractGenerator } from './Generators.js';
-import { GenerateArray, GenerateBitString, GenerateBoolean, GenerateCity, GenerateCompanyName, GenerateCompositeUniqueKey, GenerateCountry, GenerateDate, GenerateDatetime, GenerateDefault, GenerateEmail, GenerateEnum, GenerateFirstName, GenerateFullName, GenerateGeometry, GenerateHashFromString, GenerateInet, GenerateInt, GenerateInterval, GenerateIntPrimaryKey, GenerateJobTitle, GenerateJson, GenerateLastName, GenerateLine, GenerateLoremIpsum, GenerateNumber, GeneratePhoneNumber, GeneratePoint, GeneratePostcode, GenerateSelfRelationsValuesFromArray, GenerateState, GenerateStreetAddress, GenerateString, GenerateTime, GenerateTimestamp, GenerateUniqueBitString, GenerateUniqueCity, GenerateUniqueCompanyName, GenerateUniqueCountry, GenerateUniqueFirstName, GenerateUniqueFullName, GenerateUniqueGeometry, GenerateUniqueInet, GenerateUniqueInt, GenerateUniqueInterval, GenerateUniqueLastName, GenerateUniqueLine, GenerateUniqueNumber, GenerateUniquePoint, GenerateUniquePostcode, GenerateUniqueStreetAddress, GenerateUniqueString, GenerateUniqueVector, GenerateUUID, GenerateValuesFromArray, GenerateVector, GenerateWeightedCount, GenerateYear, HollowGenerator, WeightedRandomGenerator } from './Generators.js';
-import { GenerateStringV2, GenerateUniqueIntervalV2, GenerateUniqueStringV2 } from './versioning/v2.js';
-import { GenerateHashFromStringV3 } from './versioning/v3.js';
+import type { AbstractGenerator } from './Generators.ts';
+import { GenerateArray, GenerateBitString, GenerateBoolean, GenerateCity, GenerateCompanyName, GenerateCompositeUniqueKey, GenerateCountry, GenerateDate, GenerateDatetime, GenerateDefault, GenerateEmail, GenerateEnum, GenerateFirstName, GenerateFullName, GenerateGeometry, GenerateHashFromString, GenerateInet, GenerateInt, GenerateInterval, GenerateIntPrimaryKey, GenerateJobTitle, GenerateJson, GenerateLastName, GenerateLine, GenerateLoremIpsum, GenerateNumber, GeneratePhoneNumber, GeneratePoint, GeneratePostcode, GenerateSelfRelationsValuesFromArray, GenerateState, GenerateStreetAddress, GenerateString, GenerateTime, GenerateTimestamp, GenerateUniqueBitString, GenerateUniqueCity, GenerateUniqueCompanyName, GenerateUniqueCountry, GenerateUniqueFirstName, GenerateUniqueFullName, GenerateUniqueGeometry, GenerateUniqueInet, GenerateUniqueInt, GenerateUniqueInterval, GenerateUniqueLastName, GenerateUniqueLine, GenerateUniqueNumber, GenerateUniquePoint, GenerateUniquePostcode, GenerateUniqueStreetAddress, GenerateUniqueString, GenerateUniqueVector, GenerateUUID, GenerateValuesFromArray, GenerateVector, GenerateWeightedCount, GenerateYear, HollowGenerator, WeightedRandomGenerator } from './Generators.ts';
+import { GenerateStringV2, GenerateUniqueIntervalV2, GenerateUniqueStringV2 } from './versioning/v2.ts';
+import { GenerateHashFromStringV3 } from './versioning/v3.ts';
+import { GenerateUUIDV4 } from './versioning/v4.ts';
 export declare const generatorsFuncs: {
     /**
      * generates same given value each time the generator is called.
@@ -63,7 +64,7 @@ export declare const generatorsFuncs: {
      *
      * ```
      */
-    valuesFromArray: (args_0: import("./Generators.js").GenerateValuesFromArrayT) => GenerateValuesFromArray;
+    valuesFromArray: (args_0: import("./Generators.ts").GenerateValuesFromArrayT) => GenerateValuesFromArray;
     /**
      * generates sequential integers starting with 1.
      * @example
@@ -177,6 +178,8 @@ export declare const generatorsFuncs: {
     }]) => GenerateDate;
     /**
      * generates time in 24 hours style.
+     * @param minTime - lower border of range.
+     * @param maxTime - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -184,7 +187,7 @@ export declare const generatorsFuncs: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    users: {
      *      columns: {
-     *        birthTime: funcs.time()
+     *        birthTime: funcs.time({ minTime: "11:12:13.141", maxTime: "15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -192,10 +195,14 @@ export declare const generatorsFuncs: {
      * ```
      */
     time: (...args: [] | [{
+        minTime?: string | Date;
+        maxTime?: string | Date;
         arraySize?: number;
     }]) => GenerateTime;
     /**
      * generates timestamps.
+     * @param minTimestamp - lower border of range.
+     * @param maxTimestamp - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -203,7 +210,7 @@ export declare const generatorsFuncs: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    orders: {
      *      columns: {
-     *        shippedDate: funcs.timestamp()
+     *        shippedDate: funcs.timestamp({ minTimestamp: "2025-03-07T11:12:13.141", maxTimestamp: "2025-03-08T15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -211,10 +218,14 @@ export declare const generatorsFuncs: {
      * ```
      */
     timestamp: (...args: [] | [{
+        minTimestamp?: string | Date;
+        maxTimestamp?: string | Date;
         arraySize?: number;
     }]) => GenerateTimestamp;
     /**
      * generates datetime objects.
+     * @param minDatetime - lower border of range.
+     * @param maxDatetime - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -222,7 +233,7 @@ export declare const generatorsFuncs: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    orders: {
      *      columns: {
-     *        shippedDate: funcs.datetime()
+     *        shippedDate: funcs.datetime({ minDatetime: "2025-03-07T11:12:13.141", maxDatetime: "2025-03-08T15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -230,6 +241,8 @@ export declare const generatorsFuncs: {
      * ```
      */
     datetime: (...args: [] | [{
+        minDatetime?: string | Date;
+        maxDatetime?: string | Date;
         arraySize?: number;
     }]) => GenerateDatetime;
     /**
@@ -473,7 +486,7 @@ export declare const generatorsFuncs: {
      *
      * ```
      */
-    phoneNumber: (...args: [] | [import("./Generators.js").GeneratePhoneNumberT]) => GeneratePhoneNumber;
+    phoneNumber: (...args: [] | [import("./Generators.ts").GeneratePhoneNumberT]) => GeneratePhoneNumber;
     /**
      * generates country's names.
      * @param isUnique - property that controls if generated values gonna be unique or not.
@@ -944,7 +957,7 @@ export declare const generatorsFuncsV2: {
      *
      * ```
      */
-    valuesFromArray: (args_0: import("./Generators.js").GenerateValuesFromArrayT) => GenerateValuesFromArray;
+    valuesFromArray: (args_0: import("./Generators.ts").GenerateValuesFromArrayT) => GenerateValuesFromArray;
     /**
      * generates sequential integers starting with 1.
      * @example
@@ -1058,6 +1071,8 @@ export declare const generatorsFuncsV2: {
     }]) => GenerateDate;
     /**
      * generates time in 24 hours style.
+     * @param minTime - lower border of range.
+     * @param maxTime - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -1065,7 +1080,7 @@ export declare const generatorsFuncsV2: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    users: {
      *      columns: {
-     *        birthTime: funcs.time()
+     *        birthTime: funcs.time({ minTime: "11:12:13.141", maxTime: "15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -1073,10 +1088,14 @@ export declare const generatorsFuncsV2: {
      * ```
      */
     time: (...args: [] | [{
+        minTime?: string | Date;
+        maxTime?: string | Date;
         arraySize?: number;
     }]) => GenerateTime;
     /**
      * generates timestamps.
+     * @param minTimestamp - lower border of range.
+     * @param maxTimestamp - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -1084,7 +1103,7 @@ export declare const generatorsFuncsV2: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    orders: {
      *      columns: {
-     *        shippedDate: funcs.timestamp()
+     *        shippedDate: funcs.timestamp({ minTimestamp: "2025-03-07T11:12:13.141", maxTimestamp: "2025-03-08T15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -1092,10 +1111,14 @@ export declare const generatorsFuncsV2: {
      * ```
      */
     timestamp: (...args: [] | [{
+        minTimestamp?: string | Date;
+        maxTimestamp?: string | Date;
         arraySize?: number;
     }]) => GenerateTimestamp;
     /**
      * generates datetime objects.
+     * @param minDatetime - lower border of range.
+     * @param maxDatetime - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -1103,7 +1126,7 @@ export declare const generatorsFuncsV2: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    orders: {
      *      columns: {
-     *        shippedDate: funcs.datetime()
+     *        shippedDate: funcs.datetime({ minDatetime: "2025-03-07T11:12:13.141", maxDatetime: "2025-03-08T15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -1111,6 +1134,8 @@ export declare const generatorsFuncsV2: {
      * ```
      */
     datetime: (...args: [] | [{
+        minDatetime?: string | Date;
+        maxDatetime?: string | Date;
         arraySize?: number;
     }]) => GenerateDatetime;
     /**
@@ -1354,7 +1379,7 @@ export declare const generatorsFuncsV2: {
      *
      * ```
      */
-    phoneNumber: (...args: [] | [import("./Generators.js").GeneratePhoneNumberT]) => GeneratePhoneNumber;
+    phoneNumber: (...args: [] | [import("./Generators.ts").GeneratePhoneNumberT]) => GeneratePhoneNumber;
     /**
      * generates country's names.
      * @param isUnique - property that controls if generated values gonna be unique or not.
@@ -1825,7 +1850,7 @@ export declare const generatorsFuncsV3: {
      *
      * ```
      */
-    valuesFromArray: (args_0: import("./Generators.js").GenerateValuesFromArrayT) => GenerateValuesFromArray;
+    valuesFromArray: (args_0: import("./Generators.ts").GenerateValuesFromArrayT) => GenerateValuesFromArray;
     /**
      * generates sequential integers starting with 1.
      * @example
@@ -1939,6 +1964,8 @@ export declare const generatorsFuncsV3: {
     }]) => GenerateDate;
     /**
      * generates time in 24 hours style.
+     * @param minTime - lower border of range.
+     * @param maxTime - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -1946,7 +1973,7 @@ export declare const generatorsFuncsV3: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    users: {
      *      columns: {
-     *        birthTime: funcs.time()
+     *        birthTime: funcs.time({ minTime: "11:12:13.141", maxTime: "15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -1954,10 +1981,14 @@ export declare const generatorsFuncsV3: {
      * ```
      */
     time: (...args: [] | [{
+        minTime?: string | Date;
+        maxTime?: string | Date;
         arraySize?: number;
     }]) => GenerateTime;
     /**
      * generates timestamps.
+     * @param minTimestamp - lower border of range.
+     * @param maxTimestamp - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -1965,7 +1996,7 @@ export declare const generatorsFuncsV3: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    orders: {
      *      columns: {
-     *        shippedDate: funcs.timestamp()
+     *        shippedDate: funcs.timestamp({ minTimestamp: "2025-03-07T11:12:13.141", maxTimestamp: "2025-03-08T15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -1973,10 +2004,14 @@ export declare const generatorsFuncsV3: {
      * ```
      */
     timestamp: (...args: [] | [{
+        minTimestamp?: string | Date;
+        maxTimestamp?: string | Date;
         arraySize?: number;
     }]) => GenerateTimestamp;
     /**
      * generates datetime objects.
+     * @param minDatetime - lower border of range.
+     * @param maxDatetime - upper border of range.
      * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
      *
      * @example
@@ -1984,7 +2019,7 @@ export declare const generatorsFuncsV3: {
      *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
      *    orders: {
      *      columns: {
-     *        shippedDate: funcs.datetime()
+     *        shippedDate: funcs.datetime({ minDatetime: "2025-03-07T11:12:13.141", maxDatetime: "2025-03-08T15:16:17.181" })
      *      },
      *    },
      *  }));
@@ -1992,6 +2027,8 @@ export declare const generatorsFuncsV3: {
      * ```
      */
     datetime: (...args: [] | [{
+        minDatetime?: string | Date;
+        maxDatetime?: string | Date;
         arraySize?: number;
     }]) => GenerateDatetime;
     /**
@@ -2235,7 +2272,900 @@ export declare const generatorsFuncsV3: {
      *
      * ```
      */
-    phoneNumber: (...args: [] | [import("./Generators.js").GeneratePhoneNumberT]) => GeneratePhoneNumber;
+    phoneNumber: (...args: [] | [import("./Generators.ts").GeneratePhoneNumberT]) => GeneratePhoneNumber;
+    /**
+     * generates country's names.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        country: funcs.country({isUnique: false})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    country: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateCountry;
+    /**
+     * generates city's names.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        city: funcs.city({isUnique: false})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    city: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateCity;
+    /**
+     * generates street address.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        streetAddress: funcs.streetAddress({isUnique: true})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    streetAddress: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateStreetAddress;
+    /**
+     * generates job titles.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        jobTitle: funcs.jobTitle()
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    jobTitle: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateJobTitle;
+    /**
+     * generates postal codes.
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        postcode: funcs.postcode({isUnique: true})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    postcode: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GeneratePostcode;
+    /**
+     * generates states of America.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        state: funcs.state()
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    state: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateState;
+    /**
+     * generates company's names.
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        company: funcs.companyName({isUnique: true})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    companyName: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateCompanyName;
+    /**
+     * generates 'lorem ipsum' text sentences.
+     *
+     * @param sentencesCount - number of sentences you want to generate as one generated value(string).
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    posts: {
+     *      columns: {
+     *        content: funcs.loremIpsum({sentencesCount: 2})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    loremIpsum: (...args: [] | [{
+        sentencesCount?: number;
+        arraySize?: number;
+    }]) => GenerateLoremIpsum;
+    /**
+     * generates 2D points within specified ranges for x and y coordinates.
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param minXValue - lower bound of range for x coordinate.
+     * @param maxXValue - upper bound of range for x coordinate.
+     * @param minYValue - lower bound of range for y coordinate.
+     * @param maxYValue - upper bound of range for y coordinate.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    triangles: {
+     *      columns: {
+     *        pointCoords: funcs.point({
+     *          isUnique: true,
+     *          minXValue: -5, maxXValue:20,
+     *          minYValue: 0, maxYValue: 30
+     *        })
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    point: (...args: [] | [{
+        isUnique?: boolean;
+        minXValue?: number;
+        maxXValue?: number;
+        minYValue?: number;
+        maxYValue?: number;
+        arraySize?: number;
+    }]) => GeneratePoint;
+    /**
+     * generates 2D lines within specified ranges for a, b and c parameters of line.
+     *
+     * ```
+     * line equation: a*x + b*y + c = 0
+     * ```
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param minAValue - lower bound of range for a parameter.
+     * @param maxAValue - upper bound of range for x parameter.
+     * @param minBValue - lower bound of range for y parameter.
+     * @param maxBValue - upper bound of range for y parameter.
+     * @param minCValue - lower bound of range for y parameter.
+     * @param maxCValue - upper bound of range for y parameter.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    lines: {
+     *      columns: {
+     *        lineParams: funcs.point({
+     *          isUnique: true,
+     *          minAValue: -5, maxAValue:20,
+     *          minBValue: 0, maxBValue: 30,
+     *          minCValue: 0, maxCValue: 10
+     *        })
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    line: (...args: [] | [{
+        isUnique?: boolean;
+        minAValue?: number;
+        maxAValue?: number;
+        minBValue?: number;
+        maxBValue?: number;
+        minCValue?: number;
+        maxCValue?: number;
+        arraySize?: number;
+    }]) => GenerateLine;
+    /**
+     * gives you the opportunity to call different generators with different probabilities to generate values for one column.
+     * @param params - array of generators with probabilities you would like to call them to generate values.
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    posts: {
+     *      columns: {
+     *        content: funcs.weightedRandom([
+     *          {
+     *            weight: 0.6,
+     *            value: funcs.loremIpsum({ sentencesCount: 3 }),
+     *          },
+     *          {
+     *            weight: 0.4,
+     *            value: funcs.default({ defaultValue: "TODO" }),
+     *          },
+     *        ]),
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    weightedRandom: (args_0: {
+        weight: number;
+        value: AbstractGenerator<any>;
+    }[]) => WeightedRandomGenerator;
+    /**
+     * generates bit strings based on specified parameters
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array (If specified, arrays will be generated).
+     * @param dimensions - desired length of each bit string (e.g., `dimensions = 3` produces values like `'010'`).
+     *
+     * Defaults to the value of the database column bit-length.
+     *
+     * @example
+     * ```ts
+     *  await seed(db, { bitStringTable: schema.bitStringTable }).refine((funcs) => ({
+     * 		bitStringTable: {
+     * 			count,
+     * 			columns: {
+     * 				bit: funcs.bitString({
+     * 					dimensions: 12,
+     * 					isUnique: true
+     * 				}),
+     * 			},
+     * 		},
+     * 	}));
+     * ```
+     */
+    bitString: (...args: [] | [{
+        dimensions?: number;
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateBitString;
+    /**
+     * generates ip addresses based on specified parameters
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array (If specified, arrays will be generated).
+     * @param ipAddress - type of IP address to generate — either "ipv4" or "ipv6".
+     *
+     * Defaults to `'ipv4'`.
+     * @param includeCidr - determines whether generated IPs include a CIDR suffix.
+     *
+     * Defaults to `true`.
+     *
+     * @example
+     * ```ts
+     *  await seed(db, { inetTable: schema.inetTable }).refine((funcs) => ({
+     * 		inetTable: {
+     * 			count,
+     * 			columns: {
+     * 				inet: funcs.inet({
+     * 					ipAddress: 'ipv4',
+     * 					includeCidr: true,
+     * 					isUnique: true
+     * 				}),
+     * 			},
+     * 		},
+     * 	}));
+     * ```
+     */
+    inet: (...args: [] | [{
+        ipAddress?: "ipv4" | "ipv6";
+        includeCidr?: boolean;
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateInet;
+    /**
+     * generates PostGIS geometry objects based on the given parameters.
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array (If specified, arrays will be generated).
+     * @param type - geometry type to generate; currently only `'point'` is supported.
+     *
+     * Defaults to `'point'`.
+     * @param srid - Spatial Reference System Identifier: determines what type of point will be generated - either `4326` or `3857`.
+     *
+     * Defaults to `4326`.
+     * @param decimalPlaces - number of decimal places for points when `srid` is `4326` (e.g., `decimalPlaces = 3` produces values like `'point(30.723 46.482)'`).
+     *
+     * Defaults to `6`.
+     *
+     * @example
+     * ```ts
+     *  await seed(db, { geometryTable: schema.geometryTable }).refine((funcs) => ({
+     * 		geometryTable: {
+     * 			count,
+     * 			columns: {
+     * 				geometryPointTuple: funcs.geometry({
+     * 					type: 'point',
+     * 					srid: 4326,
+     * 					decimalPlaces: 5,
+     * 					isUnique: true
+     * 				})
+     * 			},
+     * 		},
+     * 	}));
+     * ```
+     */
+    geometry: (...args: [] | [{
+        type?: "point";
+        srid?: 4326 | 3857;
+        decimalPlaces?: 1 | 2 | 3 | 4 | 5 | 6 | 7;
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateGeometry;
+    /**
+     * generates vectors based on the provided parameters.
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array (If specified, arrays will be generated).
+     * @param decimalPlaces - number of decimal places for each vector element (e.g., `decimalPlaces = 3` produces values like `1.123`).
+     *
+     * Defaults to `2`.
+     * @param dimensions - number of elements in each generated vector (e.g., `dimensions = 3` produces values like `[1,2,3]`).
+     *
+     * Defaults to the value of the database column’s dimensions.
+     * @param minValue - minimum allowed value for each vector element.
+     *
+     * Defaults to `-1000`.
+     * @param maxValue - maximum allowed value for each vector element.
+     *
+     * Defaults to `1000`.
+     *
+     * @example
+     * ```ts
+     *  await seed(db, { vectorTable: schema.vectorTable }).refine((funcs) => ({
+     * 		vectorTable: {
+     * 			count,
+     * 			columns: {
+     * 				vector: funcs.vector({
+     * 					decimalPlaces: 5,
+     * 					dimensions: 12,
+     * 					minValue: -100,
+     * 					maxValue: 100,
+     * 					isUnique: true
+     * 				}),
+     * 			},
+     * 		},
+     * 	}));
+     * ```
+     */
+    vector: (...args: [] | [{
+        dimensions?: number;
+        minValue?: number;
+        maxValue?: number;
+        decimalPlaces?: number;
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateVector;
+};
+export declare const generatorsFuncsV4: {
+    /**
+     * generates same given value each time the generator is called.
+     * @param defaultValue - value you want to generate
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *   posts: {
+     *    columns: {
+     *     content: funcs.default({ defaultValue: "post content" }),
+     *    },
+     *   },
+     *  }));
+     * ```
+     */
+    default: (args_0: {
+        defaultValue: unknown;
+        arraySize?: number;
+    }) => GenerateDefault;
+    /**
+     * generates values from given array
+     * @param values - array of values you want to generate. can be array of weighted values.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    posts: {
+     *      columns: {
+     *        title: funcs.valuesFromArray({
+     *          values: ["Title1", "Title2", "Title3", "Title4", "Title5"],
+     *          isUnique: true
+     *        }),
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     * weighted values example
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    posts: {
+     *      columns: {
+     *        title: funcs.valuesFromArray({
+     *          values: [
+     *            { weight: 0.35, values: ["Title1", "Title2"] },
+     *            { weight: 0.5, values: ["Title3", "Title4"] },
+     *            { weight: 0.15, values: ["Title5"] },
+     *          ],
+     *          isUnique: false
+     *        }),
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    valuesFromArray: (args_0: import("./Generators.ts").GenerateValuesFromArrayT) => GenerateValuesFromArray;
+    /**
+     * generates sequential integers starting with 1.
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    posts: {
+     *      columns: {
+     *        id: funcs.intPrimaryKey(),
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    intPrimaryKey: (...args: [] | [{}]) => GenerateIntPrimaryKey;
+    /**
+     * generates numbers with floating point in given range.
+     * @param minValue - lower border of range.
+     * @param maxValue - upper border of range.
+     * @param precision - precision of generated number:
+     * precision equals 10 means that values will be accurate to one tenth (1.2, 34.6);
+     * precision equals 100 means that values will be accurate to one hundredth (1.23, 34.67).
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    products: {
+     *      columns: {
+     *        unitPrice: funcs.number({ minValue: 10, maxValue: 120, precision: 100, isUnique: false }),
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    number: (...args: [] | [{
+        minValue?: number;
+        maxValue?: number;
+        precision?: number;
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateNumber;
+    /**
+     * generates integers within given range.
+     * @param minValue - lower border of range.
+     * @param maxValue - upper border of range.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    products: {
+     *      columns: {
+     *        unitsInStock: funcs.number({ minValue: 0, maxValue: 100, isUnique: false }),
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    int: (...args: [] | [{
+        minValue?: number | bigint;
+        maxValue?: number | bigint;
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateInt;
+    /**
+     * generates boolean values(true or false)
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        isAvailable: funcs.boolean()
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    boolean: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateBoolean;
+    /**
+     * generates date within given range.
+     * @param minDate - lower border of range.
+     * @param maxDate - upper border of range.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        birthDate: funcs.date({ minDate: "1990-01-01", maxDate: "2010-12-31" })
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    date: (...args: [] | [{
+        minDate?: string | Date;
+        maxDate?: string | Date;
+        arraySize?: number;
+    }]) => GenerateDate;
+    /**
+     * generates time in 24 hours style.
+     * @param minTime - lower border of range.
+     * @param maxTime - upper border of range.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        birthTime: funcs.time({ minTime: "11:12:13.141", maxTime: "15:16:17.181" })
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    time: (...args: [] | [{
+        minTime?: string | Date;
+        maxTime?: string | Date;
+        arraySize?: number;
+    }]) => GenerateTime;
+    /**
+     * generates timestamps.
+     * @param minTimestamp - lower border of range.
+     * @param maxTimestamp - upper border of range.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    orders: {
+     *      columns: {
+     *        shippedDate: funcs.timestamp({ minTimestamp: "2025-03-07T11:12:13.141", maxTimestamp: "2025-03-08T15:16:17.181" })
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    timestamp: (...args: [] | [{
+        minTimestamp?: string | Date;
+        maxTimestamp?: string | Date;
+        arraySize?: number;
+    }]) => GenerateTimestamp;
+    /**
+     * generates datetime objects.
+     * @param minDatetime - lower border of range.
+     * @param maxDatetime - upper border of range.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    orders: {
+     *      columns: {
+     *        shippedDate: funcs.datetime({ minDatetime: "2025-03-07T11:12:13.141", maxDatetime: "2025-03-08T15:16:17.181" })
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    datetime: (...args: [] | [{
+        minDatetime?: string | Date;
+        maxDatetime?: string | Date;
+        arraySize?: number;
+    }]) => GenerateDatetime;
+    /**
+     * generates years.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        birthYear: funcs.year()
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    year: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateYear;
+    /**
+     * generates json objects with fixed structure.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * json structure can equal this:
+     * ```
+     * {
+     *     email,
+     *     name,
+     *     isGraduated,
+     *     hasJob,
+     *     salary,
+     *     startedWorking,
+     *     visitedCountries,
+     * }
+     * ```
+     * or this
+     * ```
+     * {
+     *     email,
+     *     name,
+     *     isGraduated,
+     *     hasJob,
+     *     visitedCountries,
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        metadata: funcs.json()
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    json: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateJson;
+    /**
+     * generates time intervals.
+     *
+     * interval example: "1 years 12 days 5 minutes"
+     *
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     * @param fields - range of values you want to see in your intervals.
+     * @example
+     * ```ts
+     * await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        timeSpentOnWebsite: funcs.interval()
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    interval: (...args: [] | [{
+        fields?: "year" | "month" | "day" | "hour" | "minute" | "second" | "year to month" | "day to hour" | "day to minute" | "day to second" | "hour to minute" | "hour to second" | "minute to second";
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateInterval;
+    /**
+     * generates random strings.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     * await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        hashedPassword: funcs.string({isUnique: false})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    string: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateString;
+    /**
+     * generates v4 UUID strings if arraySize is not specified, or v4 UUID 1D arrays if it is.
+     *
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        uuid: funcs.uuid({
+     *          arraySize: 4
+     *        })
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    uuid: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateUUID;
+    /**
+     * generates person's first names.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        firstName: funcs.firstName({isUnique: true})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    firstName: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateFirstName;
+    /**
+     * generates person's last names.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        lastName: funcs.lastName({isUnique: false})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    lastName: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateLastName;
+    /**
+     * generates person's full names.
+     * @param isUnique - property that controls if generated values gonna be unique or not.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        fullName: funcs.fullName({isUnique: true})
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    fullName: (...args: [] | [{
+        isUnique?: boolean;
+        arraySize?: number;
+    }]) => GenerateFullName;
+    /**
+     * generates unique emails.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @example
+     * ```ts
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        email: funcs.email()
+     *      },
+     *    },
+     *  }));
+     * ```
+     */
+    email: (...args: [] | [{
+        arraySize?: number;
+    }]) => GenerateEmail;
+    /**
+     * generates unique phone numbers.
+     * @param arraySize - number of elements in each one-dimensional array. (If specified, arrays will be generated.)
+     *
+     * @param template - phone number template, where all '#' symbols will be substituted with generated digits.
+     * @param prefixes - array of any string you want to be your phone number prefixes.(not compatible with template property)
+     * @param generatedDigitsNumbers - number of digits that will be added at the end of prefixes.(not compatible with template property)
+     * @example
+     * ```ts
+     *  //generate phone number using template property
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        phoneNumber: funcs.phoneNumber({template: "+(380) ###-####"})
+     *      },
+     *    },
+     *  }));
+     *
+     *  //generate phone number using prefixes and generatedDigitsNumbers properties
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        phoneNumber: funcs.phoneNumber({prefixes: [ "+380 99", "+380 67" ], generatedDigitsNumbers: 7})
+     *      },
+     *    },
+     *  }));
+     *
+     *  //generate phone number using prefixes and generatedDigitsNumbers properties but with different generatedDigitsNumbers for prefixes
+     *  await seed(db, schema, { count: 1000 }).refine((funcs) => ({
+     *    users: {
+     *      columns: {
+     *        phoneNumber: funcs.phoneNumber({prefixes: [ "+380 99", "+380 67", "+1" ], generatedDigitsNumbers: [7, 7, 10]})
+     *      },
+     *    },
+     *  }));
+     *
+     * ```
+     */
+    phoneNumber: (...args: [] | [import("./Generators.ts").GeneratePhoneNumberT]) => GeneratePhoneNumber;
     /**
      * generates country's names.
      * @param isUnique - property that controls if generated values gonna be unique or not.
@@ -2668,7 +3598,7 @@ export declare const generatorsMap: {
     readonly GenerateUniqueInterval: readonly [typeof GenerateUniqueInterval, typeof GenerateUniqueIntervalV2];
     readonly GenerateString: readonly [typeof GenerateString, typeof GenerateStringV2];
     readonly GenerateUniqueString: readonly [typeof GenerateUniqueString, typeof GenerateUniqueStringV2];
-    readonly GenerateUUID: readonly [typeof GenerateUUID];
+    readonly GenerateUUID: readonly [typeof GenerateUUID, typeof GenerateUUIDV4];
     readonly GenerateFirstName: readonly [typeof GenerateFirstName];
     readonly GenerateUniqueFirstName: readonly [typeof GenerateUniqueFirstName];
     readonly GenerateLastName: readonly [typeof GenerateLastName];