arkormx 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -238,6 +238,95 @@ var ForeignKeyBuilder = class {
 
 //#endregion
 //#region src/database/TableBuilder.ts
+const PRISMA_ENUM_MEMBER_REGEX$1 = /^[A-Za-z][A-Za-z0-9_]*$/;
+const normalizeEnumMember = (columnName, value) => {
+	const normalized = value.trim();
+	if (!normalized) throw new Error(`Enum column [${columnName}] must define only non-empty values.`);
+	if (!PRISMA_ENUM_MEMBER_REGEX$1.test(normalized)) throw new Error(`Enum column [${columnName}] contains invalid Prisma enum value [${normalized}].`);
+	return normalized;
+};
+const normalizeEnumMembers = (columnName, values) => {
+	const normalizedValues = values.map((value) => normalizeEnumMember(columnName, value));
+	const seen = /* @__PURE__ */ new Set();
+	for (const value of normalizedValues) {
+		if (seen.has(value)) throw new Error(`Enum column [${columnName}] contains duplicate enum value [${value}].`);
+		seen.add(value);
+	}
+	return normalizedValues;
+};
+/**
+* The EnumBuilder class provides a fluent interface for configuring enum columns
+* after they are defined on a table.
+*
+* @author Legacy (3m1n3nc3)
+* @since 0.2.3
+*/
+var EnumBuilder = class {
+	tableBuilder;
+	columnName;
+	constructor(tableBuilder, columnName) {
+		this.tableBuilder = tableBuilder;
+		this.columnName = columnName;
+	}
+	/**
+	* Defines the Prisma enum name for this column.
+	*
+	* @param name
+	* @returns
+	*/
+	enumName(name) {
+		this.tableBuilder.enumName(name, this.columnName);
+		return this;
+	}
+	/**
+	* Marks the enum column as nullable.
+	*
+	* @returns
+	*/
+	nullable() {
+		this.tableBuilder.nullable(this.columnName);
+		return this;
+	}
+	/**
+	* Marks the enum column as unique.
+	*
+	* @returns
+	*/
+	unique() {
+		this.tableBuilder.unique(this.columnName);
+		return this;
+	}
+	/**
+	* Sets a default value for the enum column.
+	*
+	* @param value
+	* @returns
+	*/
+	default(value) {
+		this.tableBuilder.default(value, this.columnName);
+		return this;
+	}
+	/**
+	* Positions the enum column after another column when supported.
+	*
+	* @param referenceColumn
+	* @returns
+	*/
+	after(referenceColumn) {
+		this.tableBuilder.after(referenceColumn, this.columnName);
+		return this;
+	}
+	/**
+	* Maps the enum column to a custom database column name.
+	*
+	* @param name
+	* @returns
+	*/
+	map(name) {
+		this.tableBuilder.map(name, this.columnName);
+		return this;
+	}
+};
 /**
 * The TableBuilder class provides a fluent interface for defining 
 * the structure of a database table in a migration, including columns to add or drop.
@@ -290,6 +379,27 @@ var TableBuilder = class {
 		return this.column(name, "uuid", options);
 	}
 	/**
+	* Defines an enum column in the table.
+	*
+	* @param name      The name of the enum column.
+	* @param values    Either an array of string values for the enum or the name of an existing enum to reuse.
+	* @param options   Additional options for the enum column.
+	* @returns
+	*/
+	enum(name, valuesOrEnumName, options = {}) {
+		const isEnumReuse = typeof valuesOrEnumName === "string";
+		if (!isEnumReuse && valuesOrEnumName.length === 0) throw new Error(`Enum column [${name}] must define at least one value.`);
+		const normalizedEnumValues = isEnumReuse ? void 0 : normalizeEnumMembers(name, valuesOrEnumName);
+		const enumName = isEnumReuse ? valuesOrEnumName.trim() : options.enumName?.trim();
+		if (isEnumReuse && !enumName) throw new Error(`Enum column [${name}] must define an enum name.`);
+		this.column(name, "enum", {
+			...options,
+			enumName,
+			enumValues: normalizedEnumValues
+		});
+		return new EnumBuilder(this, name);
+	}
+	/**
 	* Defines a string column in the table.
 	* 
 	* @param name      The name of the string column.
@@ -459,6 +569,21 @@ var TableBuilder = class {
 		return this;
 	}
 	/**
+	* Sets the Prisma enum name for an enum column.
+	*
+	* @param name       The enum name to assign.
+	* @param columnName Optional explicit target column name. When omitted, applies to the latest defined column.
+	* @returns          The current TableBuilder instance for chaining.
+	*/
+	enumName(name, columnName) {
+		const column = this.resolveColumn(columnName);
+		if (column.type !== "enum") throw new Error(`Column [${column.name}] is not an enum column.`);
+		const enumName = name.trim();
+		if (!enumName) throw new Error(`Enum column [${column.name}] must define an enum name.`);
+		column.enumName = enumName;
+		return this;
+	}
+	/**
 	* Sets a default value for a column.
 	*
 	* @param value      The default scalar value or Prisma expression (e.g. 'now()').
@@ -541,7 +666,10 @@ var TableBuilder = class {
 	* @returns 
 	*/
 	getColumns() {
-		return this.columns.map((column) => ({ ...column }));
+		return this.columns.map((column) => ({
+			...column,
+			enumValues: column.enumValues ? [...column.enumValues] : void 0
+		}));
 	}
 	/**
 	* Returns a copy of the defined column names to be dropped from the table.
@@ -582,6 +710,8 @@ var TableBuilder = class {
 		this.columns.push({
 			name,
 			type,
+			enumName: options.enumName,
+			enumValues: options.enumValues ? [...options.enumValues] : void 0,
 			map: options.map,
 			nullable: options.nullable,
 			unique: options.unique,
@@ -681,7 +811,10 @@ var SchemaBuilder = class {
 		return this.operations.map((operation) => {
 			if (operation.type === "createTable") return {
 				...operation,
-				columns: operation.columns.map((column) => ({ ...column })),
+				columns: operation.columns.map((column) => ({
+					...column,
+					enumValues: column.enumValues ? [...column.enumValues] : void 0
+				})),
 				indexes: operation.indexes.map((index) => ({
 					...index,
 					columns: [...index.columns]
@@ -690,7 +823,10 @@ var SchemaBuilder = class {
 			};
 			if (operation.type === "alterTable") return {
 				...operation,
-				addColumns: operation.addColumns.map((column) => ({ ...column })),
+				addColumns: operation.addColumns.map((column) => ({
+					...column,
+					enumValues: column.enumValues ? [...column.enumValues] : void 0
+				})),
 				dropColumns: [...operation.dropColumns],
 				addIndexes: operation.addIndexes.map((index) => ({
 					...index,
@@ -706,6 +842,8 @@ var SchemaBuilder = class {
 //#endregion
 //#region src/helpers/migrations.ts
 const PRISMA_MODEL_REGEX = /model\s+(\w+)\s*\{[\s\S]*?\n\}/g;
+const PRISMA_ENUM_REGEX = /enum\s+(\w+)\s*\{[\s\S]*?\n\}/g;
+const PRISMA_ENUM_MEMBER_REGEX = /^[A-Za-z][A-Za-z0-9_]*$/;
 /**
 * Convert a table name to a PascalCase model name, with basic singularization.
 * 
@@ -733,6 +871,7 @@ const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 */
 const resolvePrismaType = (column) => {
 	if (column.type === "id") return "Int";
+	if (column.type === "enum") return resolveEnumName(column);
 	if (column.type === "uuid") return "String";
 	if (column.type === "string" || column.type === "text") return "String";
 	if (column.type === "integer") return "Int";
@@ -742,6 +881,11 @@ const resolvePrismaType = (column) => {
 	if (column.type === "json") return "Json";
 	return "DateTime";
 };
+const resolveEnumName = (column) => {
+	if (column.type !== "enum") throw new ArkormException(`Column [${column.name}] is not an enum column.`);
+	if (column.enumName && column.enumName.trim().length > 0) return column.enumName.trim();
+	throw new ArkormException(`Enum column [${column.name}] must define an enum name.`);
+};
 /** 
 * Format a default value for inclusion in a Prisma schema field definition, based on its type.
 * 
@@ -756,6 +900,61 @@ const formatDefaultValue = (value) => {
 	if (typeof value === "boolean") return `@default(${value ? "true" : "false"})`;
 };
 /**
+* Format a default value for an enum column as a Prisma @default attribute, validating that it is a non-empty string.
+* 
+* @param value 
+* @returns 
+*/
+const formatEnumDefaultValue = (value) => {
+	if (value == null) return void 0;
+	if (typeof value !== "string" || value.trim().length === 0) throw new ArkormException("Enum default values must be provided as non-empty strings.");
+	return `@default(${value.trim()})`;
+};
+/**
+* Normalize an enum value by ensuring it is a non-empty string and trimming whitespace.
+* 
+* @param value 
+* @returns 
+*/
+const normalizeEnumValue = (value) => {
+	if (typeof value !== "string" || value.trim().length === 0) throw new ArkormException("Enum values must be provided as non-empty strings.");
+	const normalized = value.trim();
+	if (!PRISMA_ENUM_MEMBER_REGEX.test(normalized)) throw new ArkormException(`Enum value [${normalized}] is not a valid Prisma enum member name.`);
+	return normalized;
+};
+/**
+* Extract the enum values from a Prisma enum block string.
+* 
+* @param block 
+* @returns 
+*/
+const extractEnumBlockValues = (block) => {
+	return block.split("\n").slice(1, -1).map((line) => line.trim()).filter(Boolean);
+};
+const validateEnumValues = (column, enumName, enumValues) => {
+	const normalizedValues = enumValues.map(normalizeEnumValue);
+	const seen = /* @__PURE__ */ new Set();
+	for (const value of normalizedValues) {
+		if (seen.has(value)) throw new ArkormException(`Prisma enum [${enumName}] for column [${column.name}] contains duplicate value [${value}].`);
+		seen.add(value);
+	}
+	return normalizedValues;
+};
+/**
+* Validate that a default value for an enum column is included in the defined enum values.
+* 
+* @param column 
+* @param enumName 
+* @param enumValues 
+* @returns 
+*/
+const validateEnumDefaultValue = (column, enumName, enumValues) => {
+	if (column.default == null) return;
+	const normalizedDefault = normalizeEnumValue(column.default);
+	if (enumValues.includes(normalizedDefault)) return;
+	throw new ArkormException(`Enum default value [${normalizedDefault}] is not defined in Prisma enum [${enumName}] for column [${column.name}].`);
+};
+/**
 * Build a single line of a Prisma model field definition based on a SchemaColumn, including type and modifiers.
 * 
 * @param column 
@@ -776,11 +975,82 @@ const buildFieldLine = (column) => {
 	const primary = column.primary ? " @id" : "";
 	const mapped = typeof column.map === "string" && column.map.trim().length > 0 ? ` @map("${column.map.replace(/"/g, "\\\"")}")` : "";
 	const updatedAt = column.updatedAt ? " @updatedAt" : "";
-	const defaultValue = formatDefaultValue(column.default) ?? (column.type === "uuid" && column.primary ? "@default(uuid())" : void 0);
+	const defaultValue = column.type === "enum" ? formatEnumDefaultValue(column.default) : formatDefaultValue(column.default) ?? (column.type === "uuid" && column.primary ? "@default(uuid())" : void 0);
 	const defaultSuffix = defaultValue ? ` ${defaultValue}` : "";
 	return `  ${column.name} ${scalar}${nullable}${primary}${unique}${defaultSuffix}${updatedAt}${mapped}`;
 };
 /**
+* Build a Prisma enum block string based on an enum name and its values, validating that 
+* at least one value is provided.
+* 
+* @param enumName      The name of the enum to create.
+* @param values        The array of values for the enum.
+* @returns             The Prisma enum block string.
+*/
+const buildEnumBlock = (enumName, values) => {
+	if (values.length === 0) throw new ArkormException(`Enum [${enumName}] must define at least one value.`);
+	return `enum ${enumName} {\n${values.map((value) => `  ${value}`).join("\n")}\n}`;
+};
+/**
+* Find the Prisma enum block in a schema string that corresponds to a given enum 
+* name, returning its details if found.
+* 
+* @param schema        The Prisma schema string to search for the enum block.
+* @param enumName      The name of the enum to find in the schema.
+* @returns 
+*/
+const findEnumBlock = (schema, enumName) => {
+	const candidates = [...schema.matchAll(PRISMA_ENUM_REGEX)];
+	for (const match of candidates) {
+		const block = match[0];
+		const matchedEnumName = match[1];
+		const start = match.index ?? 0;
+		const end = start + block.length;
+		if (matchedEnumName === enumName) return {
+			enumName: matchedEnumName,
+			block,
+			start,
+			end
+		};
+	}
+	return null;
+};
+/**
+* Ensure that Prisma enum blocks exist in the schema for any enum columns defined in a 
+* create or alter table operation, adding them if necessary and validating against 
+* existing blocks.
+* 
+* @param schema    The current Prisma schema string to check and modify.
+* @param columns   The array of schema column definitions to check for enum types and ensure corresponding blocks exist for.
+* @returns 
+*/
+const ensureEnumBlocks = (schema, columns) => {
+	let nextSchema = schema;
+	for (const column of columns) {
+		if (column.type !== "enum") continue;
+		const enumName = resolveEnumName(column);
+		const enumValues = column.enumValues ?? [];
+		const existing = findEnumBlock(nextSchema, enumName);
+		if (existing) {
+			const existingValues = validateEnumValues(column, enumName, extractEnumBlockValues(existing.block));
+			if (enumValues.length === 0) {
+				validateEnumDefaultValue(column, enumName, existingValues);
+				continue;
+			}
+			const normalizedEnumValues = validateEnumValues(column, enumName, enumValues);
+			if (existingValues.join("|") !== normalizedEnumValues.join("|")) throw new ArkormException(`Prisma enum [${enumName}] already exists with different values.`);
+			validateEnumDefaultValue(column, enumName, existingValues);
+			continue;
+		}
+		if (enumValues.length === 0) throw new ArkormException(`Prisma enum [${enumName}] was not found for column [${column.name}].`);
+		const normalizedEnumValues = validateEnumValues(column, enumName, enumValues);
+		validateEnumDefaultValue(column, enumName, normalizedEnumValues);
+		const block = buildEnumBlock(enumName, normalizedEnumValues);
+		nextSchema = `${nextSchema.trimEnd()}\n\n${block}\n`;
+	}
+	return nextSchema;
+};
+/**
 * Build a Prisma model-level @@index definition line.
 * 
 * @param index     The schema index definition to convert to a Prisma \@\@index line.
@@ -982,8 +1252,9 @@ const findModelBlock = (schema, table) => {
 */
 const applyCreateTableOperation = (schema, operation) => {
 	if (findModelBlock(schema, operation.table)) throw new ArkormException(`Prisma model for table [${operation.table}] already exists.`);
+	const schemaWithEnums = ensureEnumBlocks(schema, operation.columns);
 	const block = buildModelBlock(operation);
-	return applyInverseRelations(`${schema.trimEnd()}\n\n${block}\n`, toModelName(operation.table), operation.foreignKeys ?? []);
+	return applyInverseRelations(`${schemaWithEnums.trimEnd()}\n\n${block}\n`, toModelName(operation.table), operation.foreignKeys ?? []);
 };
 /**
 * Apply an alter table operation to a Prisma schema string, modifying the model 
@@ -996,7 +1267,10 @@ const applyCreateTableOperation = (schema, operation) => {
 const applyAlterTableOperation = (schema, operation) => {
 	const model = findModelBlock(schema, operation.table);
 	if (!model) throw new ArkormException(`Prisma model for table [${operation.table}] was not found.`);
-	let block = model.block;
+	const schemaWithEnums = ensureEnumBlocks(schema, operation.addColumns);
+	const refreshedModel = findModelBlock(schemaWithEnums, operation.table);
+	if (!refreshedModel) throw new ArkormException(`Prisma model for table [${operation.table}] was not found.`);
+	let block = refreshedModel.block;
 	const bodyLines = block.split("\n");
 	operation.dropColumns.forEach((column) => {
 		const columnRegex = new RegExp(`^\\s*${escapeRegex(column)}\\s+`);
@@ -1026,7 +1300,7 @@ const applyAlterTableOperation = (schema, operation) => {
 		injectLineIntoModelBody(bodyLines, relationLine, (line) => relationRegex.test(line));
 	}
 	block = bodyLines.join("\n");
-	return applyInverseRelations(`${schema.slice(0, model.start)}${block}${schema.slice(model.end)}`, model.modelName, operation.addForeignKeys ?? []);
+	return applyInverseRelations(`${schemaWithEnums.slice(0, refreshedModel.start)}${block}${schemaWithEnums.slice(refreshedModel.end)}`, model.modelName, operation.addForeignKeys ?? []);
 };
 /**
 * Apply a drop table operation to a Prisma schema string, removing the model block
@@ -6135,6 +6409,7 @@ exports.ArkormCollection = ArkormCollection;
 exports.ArkormException = ArkormException;
 exports.Attribute = Attribute;
 exports.CliApp = CliApp;
+exports.EnumBuilder = EnumBuilder;
 exports.ForeignKeyBuilder = ForeignKeyBuilder;
 exports.InitCommand = InitCommand;
 exports.InlineFactory = InlineFactory;
@@ -6153,6 +6428,8 @@ exports.Model = Model;
 exports.ModelFactory = ModelFactory;
 exports.ModelNotFoundException = ModelNotFoundException;
 exports.ModelsSyncCommand = ModelsSyncCommand;
+exports.PRISMA_ENUM_MEMBER_REGEX = PRISMA_ENUM_MEMBER_REGEX;
+exports.PRISMA_ENUM_REGEX = PRISMA_ENUM_REGEX;
 exports.PRISMA_MODEL_REGEX = PRISMA_MODEL_REGEX;
 exports.Paginator = Paginator;
 exports.QueryBuilder = QueryBuilder;
@@ -6173,6 +6450,7 @@ exports.applyDropTableOperation = applyDropTableOperation;
 exports.applyMigrationRollbackToPrismaSchema = applyMigrationRollbackToPrismaSchema;
 exports.applyMigrationToPrismaSchema = applyMigrationToPrismaSchema;
 exports.applyOperationsToPrismaSchema = applyOperationsToPrismaSchema;
+exports.buildEnumBlock = buildEnumBlock;
 exports.buildFieldLine = buildFieldLine;
 exports.buildIndexLine = buildIndexLine;
 exports.buildInverseRelationLine = buildInverseRelationLine;
@@ -6194,8 +6472,10 @@ exports.deriveRelationFieldName = deriveRelationFieldName;
 exports.ensureArkormConfigLoading = ensureArkormConfigLoading;
 exports.escapeRegex = escapeRegex;
 exports.findAppliedMigration = findAppliedMigration;
+exports.findEnumBlock = findEnumBlock;
 exports.findModelBlock = findModelBlock;
 exports.formatDefaultValue = formatDefaultValue;
+exports.formatEnumDefaultValue = formatEnumDefaultValue;
 exports.formatRelationAction = formatRelationAction;
 exports.generateMigrationFile = generateMigrationFile;
 exports.getActiveTransactionClient = getActiveTransactionClient;
@@ -6219,6 +6499,7 @@ exports.readAppliedMigrationsState = readAppliedMigrationsState;
 exports.removeAppliedMigration = removeAppliedMigration;
 exports.resetArkormRuntimeForTests = resetArkormRuntimeForTests;
 exports.resolveCast = resolveCast;
+exports.resolveEnumName = resolveEnumName;
 exports.resolveMigrationClassName = resolveMigrationClassName;
 exports.resolveMigrationStateFilePath = resolveMigrationStateFilePath;
 exports.resolvePrismaType = resolvePrismaType;

package/dist/index.d.cts

@@ -24,10 +24,12 @@ type FactoryDefinition<TAttributes extends FactoryAttributes> = (sequence: numbe
 type FactoryState<TAttributes extends FactoryAttributes> = (attributes: TAttributes, sequence: number) => TAttributes;
 //#endregion
 //#region src/types/migrations.d.ts
-type SchemaColumnType = 'id' | 'uuid' | 'string' | 'text' | 'integer' | 'bigInteger' | 'float' | 'boolean' | 'json' | 'date' | 'timestamp';
+type SchemaColumnType = 'id' | 'uuid' | 'enum' | 'string' | 'text' | 'integer' | 'bigInteger' | 'float' | 'boolean' | 'json' | 'date' | 'timestamp';
 interface SchemaColumn {
   name: string;
   type: SchemaColumnType;
+  enumName?: string;
+  enumValues?: string[];
   map?: string;
   nullable?: boolean;
   unique?: boolean;
@@ -2670,6 +2672,58 @@ declare class ForeignKeyBuilder {
 }
 //#endregion
 //#region src/database/TableBuilder.d.ts
+/**
+ * The EnumBuilder class provides a fluent interface for configuring enum columns
+ * after they are defined on a table.
+ *
+ * @author Legacy (3m1n3nc3)
+ * @since 0.2.3
+ */
+declare class EnumBuilder {
+  private readonly tableBuilder;
+  private readonly columnName;
+  constructor(tableBuilder: TableBuilder, columnName: string);
+  /**
+   * Defines the Prisma enum name for this column.
+   *
+   * @param name
+   * @returns
+   */
+  enumName(name: string): this;
+  /**
+   * Marks the enum column as nullable.
+   *
+   * @returns
+   */
+  nullable(): this;
+  /**
+   * Marks the enum column as unique.
+   *
+   * @returns
+   */
+  unique(): this;
+  /**
+   * Sets a default value for the enum column.
+   *
+   * @param value
+   * @returns
+   */
+  default(value: unknown): this;
+  /**
+   * Positions the enum column after another column when supported.
+   *
+   * @param referenceColumn
+   * @returns
+   */
+  after(referenceColumn: string): this;
+  /**
+   * Maps the enum column to a custom database column name.
+   *
+   * @param name
+   * @returns
+   */
+  map(name: string): this;
+}
 /**
  * The TableBuilder class provides a fluent interface for defining
  * the structure of a database table in a migration, including columns to add or drop.
@@ -2714,6 +2768,17 @@ declare class TableBuilder {
    * @returns         The current TableBuilder instance for chaining.
    */
   uuid(name: string, options?: Partial<SchemaColumn>): this;
+  /**
+   * Defines an enum column in the table.
+   *
+   * @param name      The name of the enum column.
+   * @param values    Either an array of string values for the enum or the name of an existing enum to reuse.
+   * @param options   Additional options for the enum column.
+   * @returns
+   */
+  enum(name: string, valuesOrEnumName: string[] | string, options?: Partial<SchemaColumn> & {
+    enumName?: string;
+  }): EnumBuilder;
   /**
    * Defines a string column in the table.
    *
@@ -2835,6 +2900,14 @@ declare class TableBuilder {
    * @returns          The current TableBuilder instance for chaining.
    */
   nullable(columnName?: string): this;
+  /**
+   * Sets the Prisma enum name for an enum column.
+   *
+   * @param name       The enum name to assign.
+   * @param columnName Optional explicit target column name. When omitted, applies to the latest defined column.
+   * @returns          The current TableBuilder instance for chaining.
+   */
+  enumName(name: string, columnName?: string): this;
   /**
    * Sets a default value for a column.
    *
@@ -3124,6 +3197,8 @@ declare const getLatestAppliedMigrations: (state: AppliedMigrationsState, steps:
 //#endregion
 //#region src/helpers/migrations.d.ts
 declare const PRISMA_MODEL_REGEX: RegExp;
+declare const PRISMA_ENUM_REGEX: RegExp;
+declare const PRISMA_ENUM_MEMBER_REGEX: RegExp;
 /**
  * Convert a table name to a PascalCase model name, with basic singularization.
  *
@@ -3145,6 +3220,7 @@ declare const escapeRegex: (value: string) => string;
  * @returns
  */
 declare const resolvePrismaType: (column: SchemaColumn) => string;
+declare const resolveEnumName: (column: SchemaColumn) => string;
 /**
  * Format a default value for inclusion in a Prisma schema field definition, based on its type.
  *
@@ -3152,6 +3228,13 @@ declare const resolvePrismaType: (column: SchemaColumn) => string;
  * @returns
  */
 declare const formatDefaultValue: (value: unknown) => string | undefined;
+/**
+ * Format a default value for an enum column as a Prisma @default attribute, validating that it is a non-empty string.
+ *
+ * @param value
+ * @returns
+ */
+declare const formatEnumDefaultValue: (value: unknown) => string | undefined;
 /**
  * Build a single line of a Prisma model field definition based on a SchemaColumn, including type and modifiers.
  *
@@ -3159,6 +3242,29 @@ declare const formatDefaultValue: (value: unknown) => string | undefined;
  * @returns
  */
 declare const buildFieldLine: (column: SchemaColumn) => string;
+/**
+ * Build a Prisma enum block string based on an enum name and its values, validating that
+ * at least one value is provided.
+ *
+ * @param enumName      The name of the enum to create.
+ * @param values        The array of values for the enum.
+ * @returns             The Prisma enum block string.
+ */
+declare const buildEnumBlock: (enumName: string, values: string[]) => string;
+/**
+ * Find the Prisma enum block in a schema string that corresponds to a given enum
+ * name, returning its details if found.
+ *
+ * @param schema        The Prisma schema string to search for the enum block.
+ * @param enumName      The name of the enum to find in the schema.
+ * @returns
+ */
+declare const findEnumBlock: (schema: string, enumName: string) => {
+  enumName: string;
+  block: string;
+  start: number;
+  end: number;
+} | null;
 /**
  * Build a Prisma model-level @@index definition line.
  *
@@ -3492,4 +3598,4 @@ declare class URLDriver {
   url(page: number): string;
 }
 //#endregion
-export { ArkormCollection, ArkormErrorContext, ArkormException, Attribute, AttributeOptions, CliApp, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateRollbackCommand, Migration, MigrationHistoryCommand, MissingDelegateException, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, QueryConstraintException, RelationResolutionException, SEEDER_BRAND, SchemaBuilder, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToPrismaSchema, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findModelBlock, formatDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, removeAppliedMigration, resetArkormRuntimeForTests, resolveCast, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };
+export { ArkormCollection, ArkormErrorContext, ArkormException, Attribute, AttributeOptions, CliApp, EnumBuilder, ForeignKeyBuilder, InitCommand, InlineFactory, LengthAwarePaginator, MIGRATION_BRAND, MakeFactoryCommand, MakeMigrationCommand, MakeModelCommand, MakeSeederCommand, MigrateCommand, MigrateRollbackCommand, Migration, MigrationHistoryCommand, MissingDelegateException, Model, ModelFactory, ModelNotFoundException, ModelsSyncCommand, PRISMA_ENUM_MEMBER_REGEX, PRISMA_ENUM_REGEX, PRISMA_MODEL_REGEX, Paginator, PrismaDelegateMap, QueryBuilder, QueryConstraintException, RelationResolutionException, SEEDER_BRAND, SchemaBuilder, ScopeNotDefinedException, SeedCommand, Seeder, SeederCallArgument, SeederConstructor, SeederInput, TableBuilder, URLDriver, UniqueConstraintResolutionException, UnsupportedAdapterFeatureException, applyAlterTableOperation, applyCreateTableOperation, applyDropTableOperation, applyMigrationRollbackToPrismaSchema, applyMigrationToPrismaSchema, applyOperationsToPrismaSchema, buildEnumBlock, buildFieldLine, buildIndexLine, buildInverseRelationLine, buildMigrationIdentity, buildMigrationRunId, buildMigrationSource, buildModelBlock, buildRelationLine, computeMigrationChecksum, configureArkormRuntime, createMigrationTimestamp, createPrismaAdapter, createPrismaDelegateMap, defineConfig, defineFactory, deriveCollectionFieldName, deriveInverseRelationAlias, deriveRelationFieldName, ensureArkormConfigLoading, escapeRegex, findAppliedMigration, findEnumBlock, findModelBlock, formatDefaultValue, formatEnumDefaultValue, formatRelationAction, generateMigrationFile, getActiveTransactionClient, getDefaultStubsPath, getLastMigrationRun, getLatestAppliedMigrations, getMigrationPlan, getRuntimePaginationCurrentPageResolver, getRuntimePaginationURLDriverFactory, getRuntimePrismaClient, getUserConfig, inferDelegateName, isDelegateLike, isMigrationApplied, isTransactionCapableClient, loadArkormConfig, markMigrationApplied, markMigrationRun, pad, readAppliedMigrationsState, removeAppliedMigration, resetArkormRuntimeForTests, resolveCast, resolveEnumName, resolveMigrationClassName, resolveMigrationStateFilePath, resolvePrismaType, runArkormTransaction, runMigrationWithPrisma, runPrismaCommand, toMigrationFileSlug, toModelName, writeAppliedMigrationsState };