feat: [#571] migrator supports After and First column modifiers

contracts/database/schema/blueprint.go

@@ -17,7 +17,7 @@ type Blueprint interface {
 	Char(column string, length ...int) ColumnDefinition
 	// Column Create a new custom type column on the table.
 	Column(column string, ttype string) ColumnDefinition
-	// Comment Add a comment to the table.
+	// Comment Add a comment to the table. (MySQL / PostgreSQL)
 	Comment(value string)
 	// Create Indicate that the table needs to be created.
 	Create()

contracts/database/schema/column.go

@@ -1,14 +1,20 @@
 package schema
 
 type ColumnDefinition interface {
+	// After Place the column "after" another column (MySQL only)
+	After(column string) ColumnDefinition
 	// AutoIncrement set the column as auto increment
 	AutoIncrement() ColumnDefinition
-	// Change the column
+	// Change the column (MySQL / PostgreSQL / SQL Server)
 	Change() ColumnDefinition
-	// Comment sets the comment value
+	// Comment sets the comment value (MySQL / PostgreSQL)
 	Comment(comment string) ColumnDefinition
 	// Default set the default value
 	Default(def any) ColumnDefinition
+	// First Place the column "first" in the table (MySQL only)
+	First() ColumnDefinition
+	// GetAfter returns the after value
+	GetAfter() string
 	// GetAllowed returns the allowed value
 	GetAllowed() []any
 	// GetAutoIncrement returns the autoIncrement value
@@ -41,6 +47,8 @@ type ColumnDefinition interface {
 	GetUseCurrentOnUpdate() bool
 	// IsChange returns true if the column has changed
 	IsChange() bool
+	// IsFirst returns true if the column is first
+	IsFirst() bool
 	// IsSetComment returns true if the comment value is set
 	IsSetComment() bool
 	// OnUpdate sets the column to use the value on update (Mysql only)
@@ -51,7 +59,7 @@ type ColumnDefinition interface {
 	Total(total int) ColumnDefinition
 	// Nullable allow NULL values to be inserted into the column
 	Nullable() ColumnDefinition
-	// Unsigned set the column as unsigned
+	// Unsigned set the column as unsigned (Mysql only)
 	Unsigned() ColumnDefinition
 	// UseCurrent set the column to use the current timestamp
 	UseCurrent() ColumnDefinition

database/schema/column.go

@@ -6,11 +6,13 @@ import (
 )
 
 type ColumnDefinition struct {
+	after              string
 	allowed            []any
 	autoIncrement      *bool
 	change             bool
 	comment            *string
 	def                any
+	first              bool
 	length             *int
 	name               *string
 	nullable           *bool
@@ -31,6 +33,12 @@ func NewColumnDefinition(name string, ttype string) schema.ColumnDefinition {
 	}
 }
 
+func (r *ColumnDefinition) After(column string) schema.ColumnDefinition {
+	r.after = column
+
+	return r
+}
+
 func (r *ColumnDefinition) AutoIncrement() schema.ColumnDefinition {
 	r.autoIncrement = convert.Pointer(true)
 
@@ -55,6 +63,16 @@ func (r *ColumnDefinition) Default(def any) schema.ColumnDefinition {
 	return r
 }
 
+func (r *ColumnDefinition) First() schema.ColumnDefinition {
+	r.first = true
+
+	return r
+}
+
+func (r *ColumnDefinition) GetAfter() string {
+	return r.after
+}
+
 func (r *ColumnDefinition) GetAllowed() []any {
 	return r.allowed
 }
@@ -167,6 +185,10 @@ func (r *ColumnDefinition) IsChange() bool {
 	return r.change
 }
 
+func (r *ColumnDefinition) IsFirst() bool {
+	return r.first
+}
+
 func (r *ColumnDefinition) IsSetComment() bool {
 	return r != nil && r.comment != nil
 }