poweradmin

type APIError struct {
	StatusCode int
	Message    string
	Details    string
}

type Backoff func(attempt int) time.Duration

type BulkRecordOperation struct {
	Action   string
	RecordID int
	Name     string
	Type     string
	Content  string
	TTL      int
	Priority int
	Disabled bool
}

type BulkRecordsResult struct {
	Created int
	Updated int
	Deleted int
	Failed  int
	Errors  []string
}

type Client struct {

	// Per-resource clients
	Zone               IZoneClient
	ZoneTemplate       IZoneTemplateClient
	Record             IRecordClient
	RRSet              IRRSetClient
	User               IUserClient
	Group              IGroupClient
	Permission         IPermissionClient
	PermissionTemplate IPermissionTemplateClient
	// contains filtered or unexported fields
}

type Group struct {
	ID          int
	Name        string
	Description string
	PermTemplID int
	MemberCount int
	ZoneCount   int
	CreatedAt   string
}

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

type GroupCreateOpts struct {
	Name        string
	Description string
	PermTemplID int
}

type GroupMember struct {
	UserID   int
	Username string
	JoinedAt string
}

type GroupUpdateOpts struct {
	Name        string
	Description *string
}

type GroupZone struct {
	ZoneID   int
	ZoneName string
	ZoneType string
}

type IGroupClient interface {
	// GetByName returns a single [Group] by name.
	// Paginates the list endpoint and matches client-side.
	GetByName(ctx context.Context, name string) (*Group, *Response, error)
	// GetByID returns a single [Group] by ID.
	GetByID(ctx context.Context, id int) (*Group, *Response, error)
	// List returns one page of [Group]s.
	List(ctx context.Context, opts ListOpts) ([]*Group, *Response, error)
	// All returns all [Group]s across all pages.
	All(ctx context.Context) ([]*Group, error)
	// Create creates a new [Group] and returns the new ID.
	Create(ctx context.Context, opts GroupCreateOpts) (int, *Response, error)
	// Update updates an existing [Group] and returns the updated state.
	Update(ctx context.Context, id int, opts GroupUpdateOpts) (*Group, *Response, error)
	// Delete deletes the [Group] with the given ID.
	Delete(ctx context.Context, id int) (*Response, error)
	// Members returns the [GroupMember]s of a group.
	Members(ctx context.Context, id int) ([]*GroupMember, *Response, error)
	// AddMember adds a user to a group.
	AddMember(ctx context.Context, groupID, userID int) (*Response, error)
	// RemoveMember removes a user from a group.
	RemoveMember(ctx context.Context, groupID, userID int) (*Response, error)
	// Zones returns the zones associated with a group.
	Zones(ctx context.Context, id int) ([]*GroupZone, *Response, error)
	// AddZone associates a zone with a group.
	AddZone(ctx context.Context, groupID, zoneID int) (*Response, error)
	// RemoveZone disassociates a zone from a group.
	RemoveZone(ctx context.Context, groupID, zoneID int) (*Response, error)
}

type IPermissionClient interface {
	// GetByID returns a single [Permission] by ID.
	GetByID(ctx context.Context, id int) (*Permission, *Response, error)
	// List returns one page of [Permission]s.
	List(ctx context.Context, opts ListOpts) ([]*Permission, *Response, error)
	// All returns all [Permission]s across all pages.
	All(ctx context.Context) ([]*Permission, error)
}

type IPermissionTemplateClient interface {
	// GetByName returns a single [PermissionTemplate] by name.
	// Falls back to a list scan since there is no dedicated by-name endpoint.
	// Note: list responses do not include the full permission list — call
	// [PermissionTemplateClient.GetByID] on the result to get permissions.
	GetByName(ctx context.Context, name string) (*PermissionTemplate, *Response, error)
	// GetByID returns a single [PermissionTemplate] with its full permission list.
	GetByID(ctx context.Context, id int) (*PermissionTemplate, *Response, error)
	// List returns all [PermissionTemplate]s. The permission list is typically not
	// populated in list responses — use [PermissionTemplateClient.GetByID] for that.
	List(ctx context.Context) ([]*PermissionTemplate, *Response, error)
	// Create creates a new [PermissionTemplate].
	Create(ctx context.Context, opts PermissionTemplateOpts) (*PermissionTemplate, *Response, error)
	// Update updates an existing [PermissionTemplate].
	Update(ctx context.Context, id int, opts PermissionTemplateOpts) (*PermissionTemplate, *Response, error)
	// Delete deletes a [PermissionTemplate].
	Delete(ctx context.Context, id int) (*Response, error)
}

type IRRSetClient interface {
	// Get returns a single [RRSet] identified by name and type within a zone.
	Get(ctx context.Context, zoneID int, name, recordType string) (*RRSet, *Response, error)
	// List returns all [RRSet]s in a zone.
	List(ctx context.Context, zoneID int) ([]*RRSet, *Response, error)
	// Upsert creates or replaces an [RRSet] via PUT. The API treats this as an
	// idempotent create-or-update on (name, type) within the zone.
	Upsert(ctx context.Context, zoneID int, opts RRSetUpsertOpts) (*Response, error)
	// Delete deletes the [RRSet] identified by name and type within a zone.
	Delete(ctx context.Context, zoneID int, name, recordType string) (*Response, error)
}

type IRecordClient interface {
	// GetByID returns a single [Record] by zone and record ID.
	GetByID(ctx context.Context, zoneID int, recordID int64) (*Record, *Response, error)
	// List returns one page of [Record]s for the given zone.
	// Use [RecordListOpts] with Type set to filter by record type.
	List(ctx context.Context, zoneID int, opts RecordListOpts) ([]*Record, *Response, error)
	// All returns all [Record]s in a zone across all pages.
	All(ctx context.Context, zoneID int) ([]*Record, error)
	// Create creates a new [Record] in the given zone and returns the new ID.
	Create(ctx context.Context, zoneID int, opts RecordCreateOpts) (int64, *Response, error)
	// Update updates an existing [Record] and returns the updated state.
	Update(ctx context.Context, zoneID int, recordID int64, opts RecordUpdateOpts) (*Record, *Response, error)
	// Delete deletes the [Record] with the given ID.
	Delete(ctx context.Context, zoneID int, recordID int64) (*Response, error)
	// Bulk executes multiple record operations atomically against the given zone.
	Bulk(ctx context.Context, zoneID int, ops []BulkRecordOperation) (*BulkRecordsResult, *Response, error)
}

type IUserClient interface {
	// GetByName returns a single [User] by username.
	// Paginates the list endpoint server-side and matches client-side; the API
	// has no dedicated username lookup.
	GetByName(ctx context.Context, username string) (*User, *Response, error)
	// GetByID returns a single [User] by ID.
	GetByID(ctx context.Context, id int) (*User, *Response, error)
	// List returns one page of [User]s.
	List(ctx context.Context, opts ListOpts) ([]*User, *Response, error)
	// All returns all [User]s across all pages.
	All(ctx context.Context) ([]*User, error)
	// Create creates a new [User] and returns the new ID.
	Create(ctx context.Context, opts UserCreateOpts) (int, *Response, error)
	// Update updates an existing [User] and returns the updated state.
	Update(ctx context.Context, id int, opts UserUpdateOpts) (*User, *Response, error)
	// Delete deletes the [User] with the given ID.
	Delete(ctx context.Context, id int) (*Response, error)
	// SetPermissionTemplate assigns a permission template to a user via PATCH.
	// This is a partial update; other user fields are untouched.
	SetPermissionTemplate(ctx context.Context, id, permTemplID int) (*Response, error)
}

type IZoneClient interface {
	// GetByID returns a single [Zone] by its numeric ID.
	GetByID(ctx context.Context, id int) (*Zone, *Response, error)
	// GetByName returns a single [Zone] by its DNS name.
	// Performs a list + linear search across all pages — no dedicated API endpoint exists.
	GetByName(ctx context.Context, name string) (*Zone, *Response, error)
	// List returns one page of [Zone]s.
	// Note: /v2/zones wraps the array under data.zones — unlike the other list
	// endpoints in this API. The wrapper is unmarshalled here so callers see a
	// plain slice.
	List(ctx context.Context, opts ListOpts) ([]*Zone, *Response, error)
	// All returns all [Zone]s across all pages.
	All(ctx context.Context) ([]*Zone, error)
	// Create creates a new [Zone] and returns the new ID.
	// Call [ZoneClient.GetByID] to fetch the full object.
	Create(ctx context.Context, opts ZoneCreateOpts) (int, *Response, error)
	// Update updates an existing [Zone] and returns the updated state.
	Update(ctx context.Context, id int, opts ZoneUpdateOpts) (*Zone, *Response, error)
	// Delete deletes the [Zone] with the given ID.
	Delete(ctx context.Context, id int) (*Response, error)
	// Owners returns all owners of the zone.
	Owners(ctx context.Context, zoneID int) ([]*ZoneOwner, *Response, error)
	// AddOwner adds a single user as owner of the zone.
	AddOwner(ctx context.Context, zoneID, userID int) (*Response, error)
	// AddOwners adds multiple users as owners in a single request.
	AddOwners(ctx context.Context, zoneID int, userIDs []int) (*Response, error)
	// RemoveOwner removes a user from the zone's owners.
	RemoveOwner(ctx context.Context, zoneID, userID int) (*Response, error)
}

type IZoneTemplateClient interface {
	// GetByName returns a single [ZoneTemplate] by name.
	// The template endpoint is not paginated, so this is a single-page scan.
	GetByName(ctx context.Context, name string) (*ZoneTemplate, *Response, error)
	// GetByID returns a single [ZoneTemplate].
	GetByID(ctx context.Context, id int) (*ZoneTemplate, *Response, error)
	// List returns all [ZoneTemplate]s.
	List(ctx context.Context) ([]*ZoneTemplate, *Response, error)
	// Create creates a new [ZoneTemplate].
	Create(ctx context.Context, opts ZoneTemplateCreateOpts) (*ZoneTemplate, *Response, error)
	// Update updates an existing [ZoneTemplate].
	Update(ctx context.Context, id int, opts ZoneTemplateUpdateOpts) (*ZoneTemplate, *Response, error)
	// Delete deletes a [ZoneTemplate].
	Delete(ctx context.Context, id int) (*Response, error)
	// Records returns all records belonging to the template.
	Records(ctx context.Context, templateID int) ([]*ZoneTemplateRecord, *Response, error)
	// GetRecord returns a single template record.
	GetRecord(ctx context.Context, templateID, recordID int) (*ZoneTemplateRecord, *Response, error)
	// CreateRecord adds a record to a template.
	CreateRecord(ctx context.Context, templateID int, opts ZoneTemplateRecordOpts) (*ZoneTemplateRecord, *Response, error)
	// UpdateRecord replaces a template record.
	UpdateRecord(ctx context.Context, templateID, recordID int, opts ZoneTemplateRecordOpts) (*ZoneTemplateRecord, *Response, error)
	// DeleteRecord removes a record from a template.
	DeleteRecord(ctx context.Context, templateID, recordID int) (*Response, error)
}

type ListOpts struct {
	Page    int
	PerPage int
}

type Option func(*Client)

type Pagination struct {
	Page     int
	PerPage  int
	Total    int
	LastPage int
}

type Permission struct {
	ID    int
	Name  string
	Descr string
}

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

type PermissionTemplate struct {
	ID           int
	Name         string
	Descr        string
	TemplateType string // "user" or "group"
	Permissions  []Permission
}

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

type PermissionTemplateOpts struct {
	Name         string
	Descr        string
	TemplateType string // "user" (default) or "group"
	Permissions  []int  // permission IDs to assign
}

type RRSet struct {
	Name    string
	Type    string
	TTL     int
	Records []RRSetRecord
}

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

type RRSetRecord struct {
	Content  string
	Priority int
	Disabled bool
}

type RRSetUpsertOpts struct {
	Name    string
	Type    string
	TTL     int
	Records []RRSetRecord
}

type Record struct {
	ID       int64
	ZoneID   int64
	Name     string
	Type     string
	Content  string
	TTL      int
	Priority int
	Disabled bool
	Auth     bool // authoritative flag (managed by PowerDNS)
}

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

type RecordCreateOpts struct {
	Name      string
	Type      string
	Content   string
	TTL       int
	Priority  int
	Disabled  bool
	CreatePTR bool
}

type RecordListOpts struct {
	ListOpts
	Type string // optional record-type filter (e.g. "A", "MX")
}

type RecordUpdateOpts struct {
	Name     string
	Type     string
	Content  string
	TTL      *int
	Priority *int
	Disabled *bool
}

type Response struct {
	*http.Response
	Meta ResponseMeta
}

type ResponseMeta struct {
	Pagination *Pagination
}

type User struct {
	ID          int
	Username    string
	Fullname    string
	Email       string
	Description string
	Active      bool
	PermTempl   int
	UseLdap     bool
	IsAdmin     bool
	Permissions []string
	ZoneCount   int
	CreatedAt   string
	UpdatedAt   string
}

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

type UserCreateOpts struct {
	Username    string
	Password    string
	Fullname    string
	Email       string
	Description string
	Active      bool
	PermTempl   int
	UseLdap     bool
}

type UserUpdateOpts struct {
	Username    string
	Password    string
	Fullname    string
	Email       string
	Description string
	Active      *bool
	PermTempl   int
	UseLdap     *bool
}

type Zone struct {
	ID           int
	Name         string
	Type         ZoneType
	Masters      string
	Account      string
	Description  string
	SOASerial    int
	DNSSECSigned bool
}

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

type ZoneCreateOpts struct {
	Name        string
	Type        ZoneType
	Masters     string
	Account     string
	Description string
	Template    string
}

type ZoneOwner struct {
	UserID   int
	Username string
	Fullname string
}

type ZoneTemplate struct {
	ID          int
	Name        string
	Description string
	Owner       int
	IsGlobal    bool
	ZonesLinked int
}

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

type ZoneTemplateCreateOpts struct {
	Name        string
	Description string
	IsGlobal    bool
}

type ZoneTemplateRecord struct {
	ID       int
	Name     string
	Type     string
	Content  string
	TTL      int
	Priority int
}

type ZoneTemplateRecordOpts struct {
	Name     string
	Type     string
	Content  string
	TTL      int
	Priority int
}

type ZoneTemplateUpdateOpts struct {
	Name        string
	Description string
	IsGlobal    bool
}

type ZoneType string

type ZoneUpdateOpts struct {
	Type        *ZoneType
	Masters     *string
	Account     *string
	Description *string
}