core

type Metadata map[string]any

type Note struct {
	ID       string
	Content  string
	Metadata Metadata
}

type Repository interface {
	// Save persists a note. It creates if not exists, or updates if it does.
	Save(ctx context.Context, n Note) error

	// Get retrieves a note by its ID.
	Get(ctx context.Context, id string) (Note, error)

	// List returns all available notes.
	// TODO: Add pagination or filtering options in the future.
	List(ctx context.Context) ([]Note, error)

	// Delete removes a note by its ID.
	Delete(ctx context.Context, id string) error

	// Initialize ensures the underlying storage is ready (e.g., create directories, git init, schema migration).
	Initialize(ctx context.Context) error
}

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

type Syncable interface {
	// Sync synchronizes the local state with a remote source (e.g. git pull/push).
	Sync(ctx context.Context) error
}

type Transaction interface {
	// Save stages a note for persistence.
	Save(ctx context.Context, n Note) error

	// Get retrieves a note, preferring the staged version if it exists in the transaction.
	Get(ctx context.Context, id string) (Note, error)

	// List returns all available notes, including staged ones.
	List(ctx context.Context) ([]Note, error)

	// Delete stages a note for removal.
	Delete(ctx context.Context, id string) error

	// Commit applies all staged changes atomically.
	Commit(ctx context.Context, changeReason string) error

	// Rollback discards all staged changes.
	Rollback(ctx context.Context) error
}

type TransactionalRepository interface {
	Repository

	// Begin starts a new transaction.
	Begin(ctx context.Context) (Transaction, error)
}