papitable

type AddField struct {
	Type     FieldType      `json:"type"`
	Name     string         `json:"name"`
	Property map[string]any `json:"property"`
}

type AddRecord struct {
	Values map[string]any `json:"fields"`
}

type ApiTableEvent struct {
	DatasheetId string `json:"datasheetId,omitempty"` // 表格ID
	RecordId    string `json:"recordId,omitempty"`    // 记录ID
	Event       string `json:"event,omitempty"`       // 事件类型，insert/update/delete
}

type AttachmentValue struct {
	ID       string `json:"id,omitempty"`
	Name     string `json:"name,omitempty"`
	Token    string `json:"token,omitempty"`
	MimeType string `json:"mimeType,omitempty"`
	Size     int64  `json:"size,omitempty"`
	Url      string `json:"url,omitempty"`
	Width    int    `json:"width,omitempty"`
	Height   int    `json:"height,omitempty"`
}

type BaseDataProvider struct {
	Ctx context.Context

	// 该字段需要初始化设置好，mtbl事件处理中用于过滤属于当前表的事件
	DatasheetID string
	// 初始化总是nil，由 SyncHelper 根据mtbl事件自动加载
	Doc *MultiTableDoc

	TableConfig *TableConfig
	DAO         MtblDAO
	// contains filtered or unexported fields
}

type CellOption string

type CellUserValue struct {
	// Id     string `json:"id"`               // 组织单元的ID
	UserId string `json:"id"`               // 组织单元的ID
	Type   int32  `json:"type"`             // 组织单元的类型，1是小组，3是成员
	Name   string `json:"name"`             // 小组或成员的名称
	Avatar string `json:"avatar,omitempty"` // 头像URL，只读，不可写入
}

type CommonRecord struct {
	RecordId  string         `json:"recordId"`
	Fields    map[string]any `json:"fields"`
	CreatedAt int64          `json:"createdAt"`
	UpdatedAt int64          `json:"updatedAt"`
}

type DataProvider interface {
	// 如果内部创建新的表，传递到外部存储
	SetDoc(doc *MultiTableDoc)

	// --------------------------------------------------
	// 表配置
	GetTableName() string    // GetTableName 获取表名
	GetFirstCol() *AddField  // GetFirstCol 获取主键列定义
	GetColList() []*AddField // GetColList 获取所有列定义

	// --------------------------------------------------
	// 本地主键，用于在MTBL中定位本地记录
	GetPrimaryCol() *FieldConfig
	GetPrimaryVal(localRecord any) string

	// GetLastEditFrom 获取最后修改来源
	GetLastEditFrom(localRecord any) string
	// UpdateLastEditFromToLTBL 更新本地记录的 LastEditFrom 字段
	UpdateLastEditToLTBL(localId, lastEditFrom string) error

	// --------------------------------------------------
	GetSyncData() ([]*AddRecord, error) // 获取全量同步的数据，用于SyncHelper.InitMTBL

	// GetLocalRecordByMtbl 根据MTBL记录获取本地记录，隐含了M2LTBL的反向映射逻辑
	// 返回error将中断处理，可以返回[nil,nil]继续处理mtbl新增数据，而ltbl不存在的情况
	GetLocalRecordByMtbl(mtblRecord *CommonRecord) (localRecord any, err error)

	// CreateOrUpdateLocalRecord 应用本地更新（写入DB）
	// localRecord: 旧的本地记录，可能是nil，一般意味着需要创建新本地记录
	// mtblRecord: 原始MTBL记录
	// 返回:
	//  newRecord: 创建或更新后的新数据
	// 	stop用于中断SyncHelper后续对MTBL的处理，
	// 		用户通过MTBL操作，但只是作为一个入口，触发后端复杂逻辑
	// 		而这个数据其实不需要维护，甚至被删除了，则SyncHelper.UpdateToLTBL不再需要继续处理
	CreateOrUpdateLocalRecord(localRecord any, mtblRecord *CommonRecord,
	) (newRecord any, stop bool, err error)

	// L2M 将本地记录转换为APITable记录
	// 先赋值oldRecord，再用localRecord覆盖
	L2M(localRecord any, mtblRecord *CommonRecord) map[string]any

	// M2L 将MTBL记录转换为本地记录结构
	// 如果localRecord不为nil，则直接用mtblRecord覆盖到localRecord
	M2L(mtblRecord *CommonRecord, localRecord any) any
}

type Field struct {
	Id       string         `json:"id"`
	Name     string         `json:"name"`
	Type     FieldType      `json:"type"`
	Desc     string         `json:"desc,omitempty"`
	Property map[string]any `json:"property"`
}

type FieldConfig struct {
	Col     *AddField
	DOField string
}

type FieldType string

type GetRecordRequest struct {
	PageSize        int        `json:"pageSize,omitempty"`
	MaxRecords      int        `json:"maxRecords,omitempty"`
	PageNum         int        `json:"pageNum,omitempty"`
	Sort            []SortRule `json:"sort,omitempty"`
	RecordIds       []string   `json:"recordIds,omitempty"`
	ViewId          string     `json:"viewId,omitempty"`
	Fields          []string   `json:"fields,omitempty"`
	FilterByFormula string     `json:"filterByFormula,omitempty"`
	CellFormat      string     `json:"cellFormat,omitempty"`
	FieldKey        string     `json:"fieldKey,omitempty"`
}

type GetTeamListResponse struct {
	Success bool   `json:"success"`
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    struct {
		PageNum  int     `json:"pageNum"`
		PageSize int     `json:"pageSize"`
		Total    int     `json:"total"`
		Teams    []*Team `json:"teams"`
	} `json:"data"`
}

type GetTeamMembersResponse struct {
	Success bool   `json:"success"`
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    struct {
		PageNum  int     `json:"pageNum"`
		PageSize int     `json:"pageSize"`
		Total    int     `json:"total"`
		Members  []*User `json:"members"`
	} `json:"data"`
}

type GetUserResponse struct {
	Success bool   `json:"success"`
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    User   `json:"data"`
}

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

type MagicLookUpConfig struct {
	RelatedLinkFieldId string                 // 引用的当前表的关联字段 ID（注意这是本表）
	TargetFieldId      string                 // 关联表中查询的字段 ID（注意这是关联的表）
	RollupFunction     string                 // 汇总函数，如 "VALUES", "AVERAGE", "COUNT" 等
	EnableFilterSort   bool                   // 是否开启筛选和排序
	SortInfo           *MagicLookUpSortInfo   // 排序设置
	FilterInfo         *MagicLookUpFilterInfo // 筛选设置
	LookUpLimit        string                 // 限制展示的记录数量 "ALL" 或 "FIRST"
}

type MagicLookUpFilterCondition struct {
	FieldId   string        `json:"fieldId"`   // 筛选字段的字段ID
	FieldType string        `json:"fieldType"` // 筛选字段的字段类型
	Operator  string        `json:"operator"`  // 筛选条件的运算符
	Value     []interface{} `json:"value"`     // 筛选条件的基准值
}

type MagicLookUpFilterInfo struct {
	Conjunction string                       `json:"conjunction"` // "and" 或 "or"
	Conditions  []MagicLookUpFilterCondition `json:"conditions"`
}

type MagicLookUpSortInfo struct {
	Rules []MagicLookUpSortRule `json:"rules"`
}

type MagicLookUpSortRule struct {
	FieldId string `json:"fieldId"` // 用于排序的字段ID
	Desc    bool   `json:"desc"`    // 是否按降序排序
}

type MtblDAO interface {
	Add(ctx context.Context, do any) error
	UpdateByID(ctx context.Context, do any) error

	GetAll(ctx context.Context) ([]any, error)
	GetByID(ctx context.Context, id int32) (any, error)

	// 删除只能依靠mtblRecordId，因为回调中mtbl已经没有这个数据，无法二次查询到LocalId了
	DeleteByID(ctx context.Context, id int32) error
	UpdateMtblInfo(_ctx context.Context, localId string, lastEditFrom string) error
}

type MultiTableDoc struct {
	SpaceId     string `json:"spaceId"`     // 空间ID
	DatasheetId string `json:"datasheetId"` // 数据表ID
	// contains filtered or unexported fields
}

type Role string

type SelectFieldOption struct {
	Id string `json:"id,omitempty"`
	// Name  string                  `json:"name"`
	Text string `json:"name"`
	// Color *SelectFieldOptionColor `json:"color,omitempty"` // 文档有问题，这里只需要string
	Style SelectFieldOptionColor `json:"color,omitempty"`
}

type SelectFieldOptionColor string

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

type SortRule struct {
	Field string `json:"field"`
	Order string `json:"order"` // "asc" 或 "desc"
}

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

type TableConfig struct {
	TableName  string
	FirstCol   *AddField    // 多维表格的第一列，无法隐藏无法移动
	PrimaryCol *FieldConfig // 对应本地唯一标识字段，一般是主键字段
	ColList    []*FieldConfig
	NewDO      func() any
}

type Team struct {
	UnitId       string `json:"unitId"`
	Name         string `json:"name"`
	Sequence     int    `json:"sequence"`
	ParentUnitId string `json:"parentUnitId"`
	Roles        []struct {
		UnitId   string `json:"unitId"`
		Name     string `json:"name"`
		Sequence int    `json:"sequence"`
	} `json:"roles"`
}

type UpdateRecord struct {
	RecordId string         `json:"recordId"`
	Fields   map[string]any `json:"fields"`
}

type UpdateRecordRequest struct {
	Records  []*UpdateRecord `json:"records"`
	FieldKey string          `json:"fieldKey,omitempty"` // "name" or "id", default "name"
}

type UpdateRecordResponse struct {
	Success bool   `json:"success"`
	Code    int    `json:"code"`
	Message string `json:"message"`
	Data    struct {
		Records []CommonRecord `json:"records"`
	} `json:"data"`
}

type User struct {
	UnitId string `json:"unitId"`
	Name   string `json:"name"`
	Email  string `json:"email"`
	Mobile struct {
		Number   string `json:"number"`
		AreaCode string `json:"areaCode"`
	} `json:"mobile"`
	Avatar string `json:"avatar"`
	Status int    `json:"status"` // 0:未加入空间站, 1:已加入空间站
	Type   string `json:"type"`   // PrimaryAdmin, SubAdmin, Member
	Teams  []struct {
		UnitId       string `json:"unitId"`
		Name         string `json:"name"`
		Sequence     int    `json:"sequence"`
		ParentUnitId string `json:"parentUnitId"`
	} `json:"teams"`
	Roles []struct {
		UnitId   string `json:"unitId"`
		Name     string `json:"name"`
		Sequence int    `json:"sequence"`
	} `json:"roles"`
}