// Package identity 定义注册、self.*、对话密码授权、停用与删除级联的接口。
package identity

import (
	"context"
	"errors"

	"git.asio.asia/nixevol/NixMsg/internal/protocol"
)

// ErrNotImplemented 表示假实现未提供业务能力。
var ErrNotImplemented = errors.New("identity: not implemented")

// RegisterRequest 对应 POST /api/client/register 与后台开通的公共字段。
type RegisterRequest struct {
	RegistrationCode string
	ID               string
	LoginPassword    string
	Name             string
	TalkPassword     string
	Remark           string
	DefaultDelayMs   int64
	Source           string // admin | self
	RemoteIP         string
}

// RegisterResult 是注册/开通结果。
type RegisterResult struct {
	ID            string
	LoginPassword string // 仅当请求留空由服务器生成时非空
}

// SelfInfo 是 self.get 返回。
type SelfInfo struct {
	ID              string `json:"id"`
	Name            string `json:"name"`
	DefaultDelayMs  int64  `json:"default_delay_ms"`
	TalkPasswordSet bool   `json:"talk_password_set"`
}

// Service 是身份子系统契约。
type Service interface {
	// Register 处理自助注册或供管理开通复用（第 6.9 节）。
	Register(ctx context.Context, req RegisterRequest) (RegisterResult, error)

	SelfGet(ctx context.Context, endpointID string) (SelfInfo, error)
	SelfUpdate(ctx context.Context, endpointID string, req *protocol.SelfUpdate) error
	SelfSetTalkPassword(ctx context.Context, endpointID string, talkPassword string) error
	// SelfChangeLoginPassword 校验旧密码后换新密码并签发新会话令牌；remoteIP 计入登录锁定。
	SelfChangeLoginPassword(ctx context.Context, endpointID, oldPassword, newPassword, remoteIP string) (sessionToken string, err error)
	SelfLogout(ctx context.Context, endpointID string) error

	// UnlockTalk 校验并写入 password 类对话授权（第 6.6 节 unlock）；remoteIP 计入对话密码锁定。
	UnlockTalk(ctx context.Context, senderID, targetID, talkPassword, remoteIP string) error
	// HasTalkGrant 查询发送方对目标是否有有效授权（无对话密码或已有匹配版本授权）。
	HasTalkGrant(ctx context.Context, senderID, targetID string) (bool, error)
	// CheckTalkPasswordForJoin 加人时校验对话密码：已有单聊授权不能代替，必须当次带对。
	CheckTalkPasswordForJoin(ctx context.Context, actorID, targetID, talkPassword, remoteIP string) error

	// Disable 停用端并作废相关消息/令牌（第 7.6 节）。
	Disable(ctx context.Context, endpointID string) error
	// Enable 重新启用。
	Enable(ctx context.Context, endpointID string) error
	// Delete 删除端并做级联清理。
	Delete(ctx context.Context, endpointID string) error
}