3.7 KiB
npm-disputes(1) -- Handling Module Name Disputes
SYNOPSIS
- Get the author email with
npm owner ls <pkgname>
- Email the author, CC i@izs.me.
- After a few weeks, if there's no resolution, we'll sort it out.
DESCRIPTION
There sometimes arise cases where a user publishes a module, and then later, some other user wants to use that name. Here are some common ways that happens (each of these is based on actual events.)
- Bob writes a JavaScript module
foo
, which is not node-specific. Bob doesn't use node at all. Joe wants to usefoo
in node, so he wraps it in an npm module. Some time later, Bob starts using node, and wants to take over management of his program. - Bob writes an npm module
foo
, and publishes it. Perhaps much later, Joe finds a bug infoo
, and fixes it. He sends a pull request to Bob, but Bob doesn't have the time to deal with it, because he has a new job and a new baby and is focused on his new erlang project, and kind of not involved with node any more. Joe would like to publish a newfoo
, but can't, because the name is taken. - Bob writes a 10-line flow-control library, and calls it
foo
, and publishes it to the npm registry. Being a simple little thing, it never really has to be updated. Joe works for Foo Inc, the makers of the critically acclaimed and widely-marketedfoo
JavaScript toolkit framework. They publish it to npm asfoojs
, but people are routinely confused whennpm install foo
is some different thing. - Bob writes a parser for the widely-known
foo
file format, because he needs it for work. Then, he gets a new job, and never updates the prototype. Later on, Joe writes a much more completefoo
parser, but can't publish, because Bob'sfoo
is in the way.
The validity of Joe's claim in each situation can be debated. However, Joe's appropriate course of action in each case is the same.
npm owner ls foo
. This will tell Joe the email address of the owner (Bob).- Joe emails Bob, explaining the situation as respecfully as possible,
and what he would like to do with the module name. He adds
isaacs i@izs.me to the CC list of the email. Mention in the email
that Bob can run
npm owner add joe foo
to add Joe as an owner of thefoo
package. - After a reasonable amount of time, if Bob has not responded, or if Bob and Joe can't come to any sort of resolution, email isaacs i@izs.me and we'll sort it out.
REASONING
In almost every case so far, the parties involved have been able to reach an amicable resolution without any major intervention. Most people really do want to be reasonable, and are probably not even aware that they're in your way.
Module ecosystems are most vibrant and powerful when they are as self-directed as possible. If an admin one day deletes something you had worked on, then that is going to make most people quite upset, regardless of the justification. When humans solve their problems by talking to other humans with respect, everyone has the chance to end up feeling good about the interaction.
EXCEPTIONS
Some things are not allowed, and will be removed without discussion if they are brought to the attention of the npm registry admins, including but not limited to:
- Malware (that is, a module designed to exploit or harm the machine on which it is installed)
- Violations of copyright or licenses (for example, cloning an MIT-licensed program, and then removing or changing the copyright and license statement)
- Illegal content.
If you see bad behavior like this, please report it right away.
SEE ALSO
- npm-registry(1)
- npm-owner(1)