kernal

type AlterTablePlan struct {
	// AddColumns 向表添加新列。新列可携带 Default 值，对已有行自动回填。
	// 若列名已存在则返回 ErrColumnAlreadyExists。
	AddColumns []Column `json:"addColumns,omitempty"`

	// DropColumns 按列名删除列，已有行的对应字段也会被清除。
	// 不允许删除主键列（返回 ErrCannotDropPrimaryKey）。
	// 若列名不存在则返回 ErrColumnNotFound。
	DropColumns []string `json:"dropColumns,omitempty"`

	// AddIndexes 为已有列添加普通索引（将列的 Indexed 置为 true）。
	AddIndexes []string `json:"addIndexes,omitempty"`

	// DropIndexes 移除已有列的普通索引（将列的 Indexed 置为 false）。
	// 若该列同时是唯一索引，唯一索引不受影响。
	DropIndexes []string `json:"dropIndexes,omitempty"`

	// AddUniques 为已有列添加唯一索引（同时隐式将 Indexed 置为 true）。
	AddUniques []string `json:"addUniques,omitempty"`

	// DropUniques 移除已有列的唯一索引（将列的 Unique 置为 false）。
	// 普通索引标志 Indexed 不受影响。
	DropUniques []string `json:"dropUniques,omitempty"`

	// AddForeignKeys 新增外键链路定义。
	// 会自动将外键字段标记为 Indexed（由 normalizeSchema 处理）。
	AddForeignKeys []ForeignKey `json:"addForeignKeys,omitempty"`

	// DropForeignKeys 删除外键链路，支持通过 Name / Field / Alias 指定。
	DropForeignKeys []string `json:"dropForeignKeys,omitempty"`
}

type AttrCascadeMaxDepth struct{ CascadeMaxDepth int }

type AttrMaxCPUCores struct{ MaxCPUCores uint8 }

type AttrMaxMemoryBytes struct{ MaxMemoryBytes uint64 }

type AttrMaxMemoryGB struct{ MaxMemoryGB uint64 }

type AttrMaxMemoryKB struct{ MaxMemoryKB uint64 }

type AttrMaxMemoryMB struct{ MaxMemoryMB uint64 }

type AttrUUIDUpper struct{ UUIDUpper *bool }

type AttrUUIDVersion struct{ UUIDVersion uint8 }

type AttrUUIDWithHyphen struct{ UUIDWithHyphen *bool }

type AuthenticatedUser struct {
	ID          string   `json:"id"`
	Username    string   `json:"username"`
	DisplayName string   `json:"displayName,omitempty"`
	Status      string   `json:"status,omitempty"`
	IsAdmin     bool     `json:"isAdmin"`
	Roles       []string `json:"roles,omitempty"`
	Permissions []string `json:"permissions,omitempty"`
}

type CascadeInclude struct {
	Table      string           `json:"table"`
	Alias      string           `json:"alias,omitempty"`
	ForeignKey string           `json:"foreignKey,omitempty"`
	Conditions []QueryCondition `json:"conditions,omitempty"`
	Includes   []CascadeInclude `json:"includes,omitempty"`
}

type CascadeQuery struct {
	Conditions []QueryCondition `json:"conditions,omitempty"`
	Includes   []CascadeInclude `json:"includes,omitempty"`
	MaxDepth   int              `json:"maxDepth,omitempty"`
}

type Column struct {
	Name          string        `json:"name"`
	Type          string        `json:"type,omitempty"`
	Default       any           `json:"default,omitempty"`
	DefaultExpr   string        `json:"defaultExpr,omitempty"`
	OnUpdateExpr  string        `json:"onUpdateExpr,omitempty"`
	MinLength     int           `json:"minLength,omitempty"`
	MaxLength     int           `json:"maxLength,omitempty"`
	Enum          []any         `json:"enum,omitempty"`
	Checks        []ColumnCheck `json:"checks,omitempty"`
	Nullable      *bool         `json:"nullable,omitempty"`
	Required      bool          `json:"required,omitempty"`
	PrimaryKey    bool          `json:"primaryKey,omitempty"`
	AutoIncrement bool          `json:"autoIncrement,omitempty"`
	Unique        bool          `json:"unique,omitempty"`
	Indexed       bool          `json:"indexed,omitempty"`
}

type ColumnCheck struct {
	Operator string `json:"operator"`
	Value    any    `json:"value"`
}

type ColumnType string

type DatabaseConfig struct {
	DefaultUUIDVersion     int    `json:"defaultUUIDVersion,omitempty"`
	DefaultUUIDWithHyphen  *bool  `json:"defaultUUIDWithHyphen,omitempty"`
	DefaultUUIDUppercase   *bool  `json:"defaultUUIDUppercase,omitempty"`
	DefaultCascadeMaxDepth int    `json:"defaultCascadeMaxDepth,omitempty"`
	MaxCPUCores            int    `json:"maxCpuCores,omitempty"`
	MaxMemoryBytes         uint64 `json:"maxMemoryBytes,omitempty"`
}

type ForeignKey struct {
	Name     string `json:"name,omitempty"`
	Field    string `json:"field"`
	RefTable string `json:"refTable"`
	RefField string `json:"refField"`
	Alias    string `json:"alias,omitempty"`
}

type QueryCondition struct {
	Field    string `json:"field"`
	Operator string `json:"operator"`
	Value    any    `json:"value,omitempty"`
	Values   []any  `json:"values,omitempty"`
	Lower    any    `json:"lower,omitempty"`
	Upper    any    `json:"upper,omitempty"`
}

type Row map[string]any

type RowUpdate struct {
	PrimaryKey any `json:"primaryKey"`
	Updates    Row `json:"updates"`
}

type SchemaAttributer interface{ RegisterAttr(db *SimpleDB) }

type SimpleDB struct {
	// contains filtered or unexported fields
}

type TableAccessGrant struct {
	TableName     string           `json:"tableName"`
	GranteeUserID string           `json:"granteeUserId"`
	Scope         TableAccessScope `json:"scope"`
	OwnerApproved bool             `json:"ownerApproved"`
	AdminApproved bool             `json:"adminApproved"`
}

type TableAccessScope string

type TableSchema struct {
	Columns       []Column     `json:"columns"`
	ForeignKeys   []ForeignKey `json:"foreignKeys,omitempty"`
	PrimaryKey    string       `json:"primaryKey"`
	AutoIncrement bool         `json:"autoIncrement,omitempty"`
}

type Tx struct {
	// contains filtered or unexported fields
}

type TxIsolationLevel string

type TxOptions struct {
	ReadOnly  bool
	Isolation TxIsolationLevel
}