Versioned Audit Exporter

package versionedaudit

type Config struct {
    // Personal access token used for authentication.
    Token string
    // Required API version header value.
    Version string
    // Toggle to include the preview Accept header for audit log endpoints.
    EnablePreview bool
    // Organization login to fetch audit events for.
    Org string
    // Optional page size to apply to paginated requests.
    PageSize int
}

type Entry struct {
    Action string
    Actor  string
    Repo   string
    // Timestamp ISO 8601 string.
    OccurredAt string
    // Raw payload for assertions.
    Raw map[string]any
}

type PageInfo struct {
    // Next numeric page index if provided by the API; zero when absent.
    NextPage int
    // Forward pagination token (e.g., "after") from the response; empty when absent.
    NextToken string
    // Backward pagination token (e.g., "before") from the response; empty when absent.
    PrevToken string
}

type Client interface {
    // Fetches a single page of audit log entries, honoring the requested page number and/or pagination token.
    FetchAuditPage(ctx context.Context, page int, token string) (entries []Entry, pageInfo PageInfo, err error)
    // Fetches all audit log entries starting at the first page, following mixed pagination tokens until no further results remain.
    FetchAll(ctx context.Context) ([]Entry, error)
}

// NewClient constructs a client using the supplied config and prepares the authenticated HTTP transport.
func NewClient(cfg Config) (Client, error)