extensions

type Extension struct{ Opts *Options }

type Mention struct {
	Username string
	Href     string
}

type Options struct {
	Ctx          context.Context
	RepoOwner    string
	RepoName     string
	ViewerUserID int64
	Resolvers    Resolvers
	// Refs and Mentions accumulate resolved references for the caller.
	// Pointers so the transformer can append.
	Refs     *[]Ref
	Mentions *[]Mention
}

type Ref struct {
	Kind    string
	Owner   string
	Repo    string
	Number  int64
	FullSHA string
	Href    string
}

type Resolvers struct {
	User func(ctx context.Context, username string) (href string, ok bool)
	// Issue covers both same-repo (#N when ownerHint == "") and
	// cross-repo (owner/repo#N).
	Issue func(ctx context.Context, ownerHint, repoHint string, number int64, viewerUserID int64) (href string, ok bool)
	// Commit is invoked only when RepoOwner+RepoName are both set
	// (a same-repo render) and the matched token is a 7-40 char
	// lowercase hex string at a word boundary.
	Commit func(ctx context.Context, repoOwner, repoName, shaPrefix string) (href, fullSHA string, ok bool)
	// Team resolves an `@org/team` mention to the team page link.
	// Visibility-aware: a secret team the viewer can't see should
	// return `ok=false` so the renderer falls back to plain text
	// (no existence leak).
	Team func(ctx context.Context, orgSlug, teamSlug string, viewerUserID int64) (href string, ok bool)
}