add npm plugin

Author: huangyoukun

.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+[*.md]
+insert_final_newline = false
+trim_trailing_whitespace = false
+[*.yml]
+indent_size = 2
+[*.json]
+indent_size = 2

plugins/npm/README.md

@@ -0,0 +1,47 @@
+# plugins for Coding-CI
+
+## Contributing
+
+Q: 我有一个好插件，希望大家都可以用上，应该如何贡献到镜像插件市场中？
+
+A: 恭喜你，找对地方了，这篇文章就是解释这个问题的！
+
+## Step by step
+
+### 前提
+
+1. 已经制作好了插件。
+3. 有 Git 和工蜂操作的相关经验。
+
+### Step 0
+
+fork 本项目，在 `plugins` 目录下创建插件子目录，比如 `plugins/example/plugin`
+
+### Step 1
+
+添加插件的 Meta 信息`plugin-meta.json` 到子目录中，字段如下：
+
+```json
+{
+  "name": "npm",
+  "description": "发布 NPM 包到仓库，支持官方仓库和私有仓库",
+  "tags": [ "publish", "npm" ],
+  "mark": "社区",
+  "images": "https://hub.docker.com/r/plugins/npm/tags",
+  "source": "https://github.com/drone-plugins/drone-npm",
+  "bugs": "https://github.com/drone-plugins/drone-npm/issues",
+  "logo": "logo.svg"
+}
+```
+- `name`: 插件名称，需要全英文，单词之间以中划线`-`分隔。
+- `description`: 插件描述，简单介绍插件作用。
+- `tags`: 标签，是一个字符串数组，填写前可以先参照已有的标签填写，收敛以便检索，若没有合适的，可以自创。
+- `mark`: 角标。目前只可填 `官方`、`社区` 两种。
+- `images`: 插件镜像地址。
+- `source`: 源码地址。
+- `bugs`: 问题反馈地址。
+- `logo`: logo 图片相对地址。如果没有，可以不填。图片规格最好为正方形，尺寸大于 200 x 200 即可。
+
+### Step 2
+
+提交修改，发起 PR 等待自动检查工具通过和人工审核。

plugins/npm/plugin-meta.json

@@ -0,0 +1,13 @@
+{
+  "name": "npm",
+  "description": "发布 NPM 包到仓库，支持官方仓库和私有仓库",
+  "mark": "社区",
+  "images": "https://hub.docker.com/r/plugins/npm/tags",
+  "source": "https://github.com/drone-plugins/drone-npm",
+  "bugs": "https://github.com/drone-plugins/drone-npm/issues",
+  "tags": [
+    "publish",
+    "npm"
+  ],
+  "logo": "logo.svg"
+}

plugins/npm/publish/README.md

@@ -0,0 +1,64 @@
+# npm
+
+`npm publish`，支持官方仓库和私有仓库。
+
+## 输入
+
+- `username`: `string` 用户名
+- `password`: `string` 密码
+- `token`: `string` token方式鉴权
+- `email`: `string` 邮箱
+- `registry`: `string` registry，默认：`https://registry.npmjs.org`
+- `folder`: `string` 要发布的目录，默认当前目录。
+- `fail_on_version_conflict`: `boolean` 版本存在时报错退出
+- `tag`: `boolean` NPM publish tag `--tag`
+- `access`: `string` NPM scoped package access `--access`
+
+## 在 Coding-CI 上使用
+
+### 发布到私有仓库
+
+```yaml
+master:
+  push:
+  - stages:
+    - name: npm publish
+      image: plugins/npm
+      imports: https://your-git.com/xxx/npm-token.yml
+      settings:
+        username: $NPM_USER
+        password: $NPM_PASS
+        email: $NPM_EMAIL
+        registry: https://your-npm-registry.com/
+        folder: ./
+        fail_on_version_conflict: true
+```
+
+`package.json` 文件需要声明相同的 `registry`，以通过 npm 校验
+
+```json
+{
+    "name": "xxx",
+    "version": "xxx",
+    "publishConfig": {
+        "registry": "https://your-npm-registry.com/"
+    }
+}
+```
+
+### 发布到 npm 官方仓库
+
+```yaml
+master:
+  push:
+  - stages:
+    - name: npm publish
+      image: plugins/npm
+      imports: https://your-git.com/xxx/npm-token.yml
+      settings:
+        username: $NPM_USER
+        password: $NPM_PASS
+        email: $NPM_EMAIL
+        folder: ./
+        fail_on_version_conflict: true
+```