activesync

type Backend interface {
	// Logon authenticates the user. Returns false on failure.
	Logon(ctx context.Context, username, domain, password string) bool

	// Logoff is called after the request is complete. Should release resources.
	Logoff(ctx context.Context) error

	// Setup prepares the backend for the given user (and optional impersonated user).
	// This is called after Logon succeeds.
	Setup(ctx context.Context, username, impersonatedUser string) error

	// GetFolderList returns the complete folder hierarchy for the authenticated user.
	GetFolderList(ctx context.Context) ([]protocol.Folder, error)

	// GetFolderSyncKey returns the current sync key for the folder hierarchy.
	// An empty string or "0" means full sync is required.
	GetFolderSyncKey(ctx context.Context) (string, error)

	// SetFolderSyncKey saves a new folder hierarchy sync key.
	SetFolderSyncKey(ctx context.Context, key string) error

	// GetChanges returns items that have changed since the last sync.
	// syncKey "0" means a full sync; a non-zero key returns only deltas.
	// Returns the new sync key and a slice of changes.
	GetChanges(ctx context.Context, folderID, syncKey string, options *SyncOptions) (newKey string, changes []protocol.Change, err error)

	// ApplyChange applies a client-originated change (add/modify/delete) to the backend.
	ApplyChange(ctx context.Context, folderID string, change protocol.Change) (serverID string, err error)

	// GetItemCount returns the estimated number of items to sync for a folder.
	GetItemCount(ctx context.Context, folderID, syncKey string) (int, error)

	// SendMail sends an email message (raw MIME data).
	SendMail(ctx context.Context, mime []byte, saveInSentItems bool) error

	// SmartForward forwards an existing message with additional content.
	SmartForward(ctx context.Context, itemID, folderID string, mime []byte) error

	// SmartReply replies to an existing message.
	SmartReply(ctx context.Context, itemID, folderID string, mime []byte) error

	// GetAttachment fetches an attachment by its file reference.
	GetAttachment(ctx context.Context, fileRef string) (data []byte, contentType string, err error)

	// MoveItems moves one or more items between folders.
	MoveItems(ctx context.Context, moves []protocol.MoveRequest) ([]protocol.MoveResult, error)

	// MeetingResponse processes a meeting accept/decline/tentative response.
	MeetingResponse(ctx context.Context, requestID, folderID string, userResponse protocol.MeetingResponseStatus) (calendarID string, err error)

	// Search performs a search across the mailbox or GAL.
	Search(ctx context.Context, query *SearchQuery) ([]protocol.SearchResult, int, error)

	// GetDevicePolicy returns the device security policy for this user/device.
	// Returning nil means no policy enforcement.
	GetDevicePolicy(ctx context.Context) (*protocol.Policy, error)

	// AcknowledgePolicy acknowledges that the device accepted the policy.
	AcknowledgePolicy(ctx context.Context, policyKey string) error

	// GetDeviceInfo returns stored device info for this device, if any.
	GetDeviceInfo(ctx context.Context, deviceID string) (*protocol.DeviceInfo, error)

	// SaveDeviceInfo stores updated device information from a Settings request.
	SaveDeviceInfo(ctx context.Context, info *protocol.DeviceInfo) error
}

type BackendFactory func() Backend

type DeviceState struct {
	DeviceID   string
	DeviceType string
	UserAgent  string
	Username   string

	PolicyKey     string
	PolicyAcked   bool
	FolderSyncKey string
	ItemSyncKeys  map[string]string // folderID → syncKey
	LastSyncTime  map[string]time.Time

	CreatedAt time.Time
	UpdatedAt time.Time
	// contains filtered or unexported fields
}

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

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

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

type Options struct {
	// Addr is the listen address, e.g. ":8080" or ":443".
	Addr string

	// TLSCert and TLSKey are paths to the TLS certificate and key files.
	// If empty, the server starts without TLS (not suitable for production).
	TLSCert string
	TLSKey  string

	// Logger is the zap logger. If nil, a production logger is created.
	Logger *zap.Logger

	// MaxPingInterval is the maximum heartbeat interval for Ping commands (seconds).
	// Default: 540 (9 minutes).
	MaxPingInterval int

	// MinPingInterval is the minimum heartbeat interval (seconds).
	// Default: 60.
	MinPingInterval int

	// MaxPingFolders is the maximum number of folders a Ping command may monitor.
	// Default: 100.
	MaxPingFolders int

	// EnforceProvisioning requires clients to exchange a policy before syncing.
	// Default: false (permissive for testing).
	EnforceProvisioning bool

	// ServerHeader overrides the X-MS-Server-ActiveSync header value.
	ServerHeader string
}

type SearchQuery struct {
	StoreName     string
	Query         string
	FreeText      string
	RangeStart    int
	RangeEnd      int
	DeepTraversal bool
}

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

type SyncOptions struct {
	FilterType     protocol.FilterType
	WindowSize     int
	BodyType       protocol.BodyType
	TruncationSize int
	MIMESupport    int
}