{"name":"published","version":"1.8.5-rc-41c0514","keywords":["npm","publish","ci-cd","automation","cli","npx","📦"],"author":{"name":"Fiverr SRE"},"license":"MIT","_id":"published@1.8.5-rc-41c0514","maintainers":[{"name":"fiverrit","email":"it@fiverr.com"},{"name":"omrilotan","email":"omri@hamadgera.com"},{"name":"michael5r","email":"michael@fiverr.com"}],"homepage":"https://published.js.org/","bugs":{"url":"https://github.com/fiverr/published/issues"},"bin":{"published":"bin/index.js"},"dist":{"shasum":"c3ca7764c89c0d086f8a5c0a69b53a7515181ee0","tarball":"https://registry.npmjs.org/published/-/published-1.8.5-rc-41c0514.tgz","fileCount":24,"integrity":"sha512-Vj8xrOEbmDDUbE7MlYmJiXjA67dM8dnCVXi5RAa6iQG12FkUzuFJnxCPAgd1+MVPOhRmjUgFah4mv3orGOLnvQ==","signatures":[{"sig":"MEUCID432SlmL1DGxwI7AKwpN7Vxv+3xwMTIZMH5TUhA98GMAiEAnIklE+E/48ec30WnNiZV013lbasElB8eOvfwwhCkOKE=","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":26939,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v4.10.10\r\nComment: https://openpgpjs.org\r\n\r\nwsFzBAEBCAAGBQJjC3H1ACEJED1NWxICdlZqFiEECWMYAoorWMhJKdjhPU1b\r\nEgJ2Vmpy0hAAltdQmtg78+p4L1urjWNxRvZsPXXth8BDfwGImI/HdXWQDH3y\r\nKbMB4VYjaLwDSVR1eeB0clAIkDXzg5wnO/4q5D/v+fYDxqwjQa6UypuydtfC\r\nHWAGGlMCTUf6rPoIN+HxpcSSPLW4VBTQCkUnMPQhqfVC4loy7EwNDJEQ8nmR\r\naB0+nI7+lKEP4Rpdz+CVSSGxqfZUaJ+O7Zl3jsMbzyiugvwIUmoNtJyFuY68\r\niupRic2AT0splCioaag6MJnv6xEJcwpl8PuoFQGCImym7WyvH6w4CKTUXjRo\r\nfqhF8DxLPfz9x6uZg4JUkhH+Mi2173vyZS0mZ/idH/BArNv4AtGfdeTfyIWh\r\nezEXXithC5Li/DXI5n+8fee38chuDrYq4H6vYSukQUqmdCTUdAszMpfzueWe\r\n7Lom/GaGapUjC4pq0ryDi6ldq4CJrEgllfN2MVsawDbGrk7Mn7/3i+/5C7xN\r\nx5qwT/+2I2ZK3HLo1Akgzj6zUFy1eXrB7ZE88RZfTbFbprV1Mlc0rDZT1TQQ\r\nhznArxTj+DuZPi9bPMgvPcTUiONPGx5LSWx89pgaASCu1v9ueLIj8VK1+xBg\r\nY/xlk6vimTx9wo227SAoK4CjXJbGDlO4vH35Kw5VGATmo/Xjruc/4U2ol34D\r\nT/7Df+slBy5hfGcwbE464aOaV/YkdPjOm2A=\r\n=bmo4\r\n-----END PGP SIGNATURE-----\r\n"},"main":"./app/index.js","readme":"# published [](https://github.com/fiverr/published) [](https://www.npmjs.com/package/published) [](https://circleci.com/gh/fiverr/workflows/published/tree/master)\n\n## 📦 Opinionated NPM publish program \n\npublished helps streamline a git based workflow with package publishing through continues delivery. Developers control their branch and version strategies, and published takes care of logical conditioning of when to publish stable versions and/or release candidates.\n\n### Run using npm exec\n```sh\nnpm exec published --yes\n```\n\n### Options\n\n| option | Description | Example\n| - | - | -\n| testing | Dry run | `npm exec published --yes -- --testing`\n| slack.webhook | Notify on Slack | `npm exec published --yes -- --slack.webhook $SLACK_WEBHOOK`\n| slack.channel | Change Slack webhook channel | `npm exec published --yes -- --slack.webhook $SLACK_WEBHOOK --slack.channel \"#publish\"`\n| quiet | Silent outputs and notifications | `npm exec published --yes -- --quiet`\n| git-tag | Push a tag to git, Only from `master`(latest-branch) or `latest` branch | `npm exec published --yes -- --git-tag`\n| on-publish | Execute shell command after a publish event | `npm exec published --yes -- --on-publish bash\\ ./do-more.sh`\n| on-<tag> | Execute shell command after a publish event with this tag (executes after on-publish) | `npm exec published --yes -- --on-latest 'echo \"Published!\"'`\n| latest-branch | Branch that is considered latest (default is 'master') | `npm exec published --yes -- --latest-branch stable`\n| tag-name | Tag name to be used regardless of config. If performed from a branch other than `master`, needs to be used in conjunction with `latest-branch` option | `npm exec published --yes -- --tag-name next --latest-branch next`\n| no-sha | Disables the commit's SHA suffix for RC versions | `npm exec published --yes -- --no-sha`\n\n## TL;DR\n| Branch type | action |\n| --- | --- |\n| **Feature branch** | Release RC versions on tag by branch name. |\n| **Master (latest) branch** | Release clean semver on \"latest\" tag. |\n\n\nNPM Permissions\nIn order to publish an NPM package as a privileged user, create an NPM configuration file. One way to do it is to hide the token in an environment variable and add this preceding step:\n\n```sh\necho \"//registry.npmjs.org/:_authToken=$NPM_TOKEN\" >> ~/.npmrc\n```\n\n\n## Flow\n\n#### Feature branch\n\n- Publish only versions with a pre-release section containing `rc` string\n- Unless the `--no-sha` flag was passed, branch versions get a suffix that matches the commit ID, so you can re install the same tag and get updates\n- Tags are named after the branch name\n\n#### \"master\" branch\n\n- Only publish clean semver versions, no pre-release\n- Publish versions to tag \"latest\" (or publishConfig.tag from package.json)\n\n> \\* using `latest-branch` option will switch its behaviour with master\n\n#### \"latest\" branch\n- Same as master, but will ignore publishConfig.tag setting. Use this if your master branch points to \"next\" through publishConfig.tag\n\n### Examples\n\n| branch | version | publish | tag | w/o sha\n| - | - | - | - | -\n| `my_feature_branch`, `next` | `1.3.0` | nothing | N/A | -\n| `my_feature_branch`, `next` | `1.3.1-alpha` | nothing | N/A | -\n| `my_feature_branch`, `next` | `1.3.1-rc` | `1.3.1-rc` | `my_feature_branch`, `next` | ✓\n| `my_feature_branch`, `next` | `1.3.1-rc.1` | `1.3.1-rc.1` | `my_feature_branch`, `next` | ✓\n| `my_feature_branch`, `next` | `1.3.1-rc` | `1.3.1-rc-c447f6a` | `my_feature_branch`, `next` | ✕\n| `my_feature_branch`, `next` | `1.3.1-rc.1` | `1.3.1-rc.1-c447f6a` | `my_feature_branch`, `next` | ✕\n| `master`, `latest` | `1.3.0` | `1.3.0` | `latest` | -\n| `master`, `latest` | `1.3.0-beta` | Throws Error | N/A | -\n| `master`, `latest` | `1.3.0-rc` | Throws Error | N/A | -\n\n> \\* using `latest-branch` option will switch its behaviour with master\n\nPackage icon by Julien Deveaux from the Noun Project\n","gitHead":"41c051426bff275993a45f82895a3700bac9327c","scripts":{"lint":"eslint -c .eslintrc '**/*.js'","test":"mocha '**/spec.js'","start":"./bin/index.js --git-tag"},"_npmUser":{"name":"fiverrit","email":"it@fiverr.com"},"repository":{"url":"git+https://github.com/fiverr/published.git","type":"git"},"_npmVersion":"6.14.17","description":"📦 Opinionated NPM publish program","directories":{},"_nodeVersion":"8.17.0","dependencies":{"jsnpm":"^0.3.7","yargs":"^14.0.0","doamrn":"^1.0.3","async-git":"1.13.0","paraphrase":"^1.7.0","edit-package":"^1.0.3","async-execute":"^1.1.0","index-require":"^1.0.0"},"publishConfig":{"tag":"allow-beta-versions_rc"},"_hasShrinkwrap":false,"readmeFilename":"README.md","devDependencies":{"chai":"^4.2.0","mocha":"^6.2.0","eslint":"^6.4.0","import-fresh":"^3.1.0","eslint-plugin-log":"^1.2.3","@fiverr/eslint-config-fiverr":"^3.1.3"},"_npmOperationalInternal":{"tmp":"tmp/published_1.8.5-rc-41c0514_1661694453544_0.2621282001678271","host":"s3://npm-registry-packages"}}