cli

Documentation

Index

• func ExtractNotionUUID(s string) (string, bool)
• func GetClient() (*mcp.Client, error)
• func IsEmoji(r rune) bool
• func LooksLikeID(s string) bool
• func RequireClient() (*mcp.Client, error)
• func RequireOfficialAPIClient(overrides config.APIOverrides) (*api.Client, error)
• func ResolveDatabaseID(ctx context.Context, client *mcp.Client, input string) (string, error)
• func ResolvePageID(ctx context.Context, client *mcp.Client, input string) (string, error)
• func SetAccessToken(token string)
• func SetFrontmatterID(content string, notionID string) string
• type Frontmatter
  • func ParseFrontmatter(content string) (Frontmatter, string)
• type OfficialAPIConfig
  • func LoadOfficialAPIConfig(overrides config.APIOverrides) (*OfficialAPIConfig, error)
• type PageRef
  • func ParsePageRef(s string) PageRef
• type PageRefKind

Functions

func ExtractNotionUUID

func ExtractNotionUUID(s string) (string, bool)

ExtractNotionUUID finds exactly 32 hex digits in a string and returns the canonical UUID format (8-4-4-4-12).

func GetClient

func GetClient() (*mcp.Client, error)

func IsEmoji

func IsEmoji(r rune) bool

IsEmoji returns true if the rune is an emoji character.

func LooksLikeID

func LooksLikeID(s string) bool

LooksLikeID returns true if the string is a valid Notion UUID (32 or 36 hex chars).

func RequireClient

func RequireClient() (*mcp.Client, error)

func RequireOfficialAPIClient

func RequireOfficialAPIClient(overrides config.APIOverrides) (*api.Client, error)

func ResolveDatabaseID

func ResolveDatabaseID(ctx context.Context, client *mcp.Client, input string) (string, error)

ResolveDatabaseID resolves any database reference (URL, ID, or name) to a database ID. Like ResolvePageID but filters for databases/data sources.

func ResolvePageID

func ResolvePageID(ctx context.Context, client *mcp.Client, input string) (string, error)

ResolvePageID resolves any page reference (URL, ID, or name) to a page ID. For URLs, it extracts the embedded UUID. For names, it searches and requires an exact unique match.

func SetAccessToken

func SetAccessToken(token string)

func SetFrontmatterID

func SetFrontmatterID(content string, notionID string) string

SetFrontmatterID returns the content with notion-id set in frontmatter. If frontmatter already exists, it updates or adds the notion-id field. If no frontmatter exists, it prepends a new frontmatter block.

Types

type Frontmatter

type Frontmatter struct {
	NotionID string
}

func ParseFrontmatter

func ParseFrontmatter(content string) (Frontmatter, string)

ParseFrontmatter extracts frontmatter and body from a markdown string. Returns the parsed frontmatter (if any) and the body without frontmatter.

type OfficialAPIConfig

type OfficialAPIConfig struct {
	Config         config.Config
	ConfigPath     string
	APITokenSource string
	HasConfigToken bool
}

func LoadOfficialAPIConfig

func LoadOfficialAPIConfig(overrides config.APIOverrides) (*OfficialAPIConfig, error)

type PageRef

type PageRef struct {
	Kind PageRefKind
	Raw  string
	ID   string // canonical UUID if Kind==RefID
}

func ParsePageRef

func ParsePageRef(s string) PageRef

ParsePageRef classifies an input string as a URL, ID, or name.

type PageRefKind

type PageRefKind int

const (
	RefID PageRefKind = iota
	RefURL
	RefName
)