projen-pipelines 0.3.4 → 0.3.6

package/node_modules/conventional-changelog-conventionalcommits/README.md

@@ -0,0 +1,50 @@
+# [![Build Status][travis-image]][travis-url] [![Coverage Status][coverage-image]][coverage-url]
+
+## conventionalcommits.org convention
+
+A concrete implementation of the specification described at
+[conventionalcommits.org](https://conventionalcommits.org/) for automated
+CHANGELOG generation and version management.
+
+
+## Indirect Usage (as preset)
+
+Use the [Conventional Changelog CLI Quick Start](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli#quick-start) with the `-p conventionalcommits` option.
+
+## Direct Usage (as a base preset so you can customize it)
+
+If you want to use this package directly and pass options, you can use the [Conventional Changelog CLI Quick Start](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli#quick-start) and with the `--config` or `-n` parameter, pass a js config that looks like this
+```
+'use strict'
+const config = require('conventional-changelog-conventionalcommits')
+
+module.exports = config({
+    "issuePrefixes": ["TEST-"],
+    "issueUrlFormat": "https://myBugTracker.com/{{prefix}}{{id}}"
+})
+```
+
+or json config like that:
+```
+{
+    "options": {
+        "preset": {
+            "name": "conventionalchangelog",
+            "issuePrefixes": ["TEST-"],
+            "issueUrlFormat": "https://myBugTracker.com/{{prefix}}{{id}}"
+        }
+    }
+}
+```
+This last json config way passes the `preset` object to the `conventional-changelog-preset-loader` package, that in turn, passes this same `preset` object as the config for the `conventional-changelog-conventionalcommits`.
+
+
+
+See [conventional-changelog-config-spec](https://github.com/conventional-changelog/conventional-changelog-config-spec) for available
+configuration options.
+
+
+[travis-image]: https://travis-ci.org/conventional-changelog/conventional-changelog.svg?branch=master
+[travis-url]: https://travis-ci.org/conventional-changelog/conventional-changelog
+[coverage-image]: https://coveralls.io/repos/github/conventional-changelog/conventional-changelog/badge.svg?branch=master
+[coverage-url]: https://coveralls.io/github/conventional-changelog/conventional-changelog?branch=master

package/node_modules/conventional-changelog-conventionalcommits/conventional-changelog.js

@@ -0,0 +1,12 @@
+'use strict'
+
+const parserOpts = require('./parser-opts')
+const writerOpts = require('./writer-opts')
+
+module.exports = function (config) {
+  return Promise.all([parserOpts(config), writerOpts(config)])
+    .then(([parserOpts, writerOpts]) => ({
+      parserOpts,
+      writerOpts
+    }))
+}

package/node_modules/conventional-changelog-conventionalcommits/index.js

@@ -0,0 +1,47 @@
+'use strict'
+const conventionalChangelog = require('./conventional-changelog')
+const parserOpts = require('./parser-opts')
+const recommendedBumpOpts = require('./conventional-recommended-bump')
+const writerOpts = require('./writer-opts')
+
+module.exports = function (parameter) {
+  // parameter passed can be either a config object or a callback function
+  if (typeof parameter === 'function') {
+    // parameter is a callback object
+    const config = {}
+    // FIXME: use presetOpts(config) for callback
+    Promise.all([
+      conventionalChangelog(config),
+      parserOpts(config),
+      recommendedBumpOpts(config),
+      writerOpts(config)
+    ]).then(([conventionalChangelog, parserOpts, recommendedBumpOpts, writerOpts]) => {
+      parameter(null, {
+        gitRawCommitsOpts: {
+          noMerges: null
+        },
+        conventionalChangelog,
+        parserOpts,
+        recommendedBumpOpts,
+        writerOpts
+      })
+    })
+  } else {
+    const config = parameter || {}
+    return presetOpts(config)
+  }
+}
+
+function presetOpts (config) {
+  return Promise.all([
+    conventionalChangelog(config),
+    parserOpts(config),
+    recommendedBumpOpts(config),
+    writerOpts(config)
+  ]).then(([conventionalChangelog, parserOpts, recommendedBumpOpts, writerOpts]) => ({
+    conventionalChangelog,
+    parserOpts,
+    recommendedBumpOpts,
+    writerOpts
+  }))
+}

package/node_modules/conventional-changelog-conventionalcommits/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "conventional-changelog-conventionalcommits",
+  "version": "6.1.0",
+  "description": "conventional-changelog conventionalcommits.org preset",
+  "main": "index.js",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/conventional-changelog/conventional-changelog.git"
+  },
+  "keywords": [
+    "conventional-changelog",
+    "conventionalcommits.org",
+    "preset"
+  ],
+  "files": [
+    "add-bang-notes.js",
+    "conventional-changelog.js",
+    "conventional-recommended-bump.js",
+    "index.js",
+    "parser-opts.js",
+    "writer-opts.js",
+    "templates"
+  ],
+  "author": "Ben Coe",
+  "engines": {
+    "node": ">=14"
+  },
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/conventional-changelog/conventional-changelog/issues"
+  },
+  "homepage": "https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-conventionalcommits#readme",
+  "dependencies": {
+    "compare-func": "^2.0.0"
+  },
+  "scripts": {
+    "test-windows": "mocha --timeout 30000"
+  }
+}

package/node_modules/conventional-changelog-conventionalcommits/templates/header.hbs

@@ -0,0 +1,9 @@
+## {{#if @root.linkCompare~}}
+  [{{version}}]({{compareUrlFormat}})
+{{~else}}
+  {{~version}}
+{{~/if}}
+{{~#if title}} "{{title}}"
+{{~/if}}
+{{~#if date}} ({{date}})
+{{/if}}

package/node_modules/conventional-changelog-conventionalcommits/writer-opts.js

@@ -0,0 +1,213 @@
+'use strict'
+
+const addBangNotes = require('./add-bang-notes')
+const compareFunc = require('compare-func')
+const { readFile } = require('fs').promises
+const { resolve } = require('path')
+const releaseAsRe = /release-as:\s*\w*@?([0-9]+\.[0-9]+\.[0-9a-z]+(-[0-9a-z.]+)?)\s*/i
+
+/**
+ * Handlebar partials for various property substitutions based on commit context.
+ */
+const owner = '{{#if this.owner}}{{~this.owner}}{{else}}{{~@root.owner}}{{/if}}'
+const host = '{{~@root.host}}'
+const repository = '{{#if this.repository}}{{~this.repository}}{{else}}{{~@root.repository}}{{/if}}'
+
+module.exports = async (config) => {
+  config = defaultConfig(config)
+  const commitUrlFormat = expandTemplate(config.commitUrlFormat, {
+    host,
+    owner,
+    repository
+  })
+  const compareUrlFormat = expandTemplate(config.compareUrlFormat, {
+    host,
+    owner,
+    repository
+  })
+  const issueUrlFormat = expandTemplate(config.issueUrlFormat, {
+    host,
+    owner,
+    repository,
+    id: '{{this.issue}}',
+    prefix: '{{this.prefix}}'
+  })
+
+  const [
+    template,
+    header,
+    commit,
+    footer
+  ] = await Promise.all([
+    readFile(resolve(__dirname, './templates/template.hbs'), 'utf-8'),
+    readFile(resolve(__dirname, './templates/header.hbs'), 'utf-8'),
+    readFile(resolve(__dirname, './templates/commit.hbs'), 'utf-8'),
+    readFile(resolve(__dirname, './templates/footer.hbs'), 'utf-8')
+  ])
+  const writerOpts = getWriterOpts(config)
+
+  writerOpts.mainTemplate = template
+  writerOpts.headerPartial = header
+    .replace(/{{compareUrlFormat}}/g, compareUrlFormat)
+  writerOpts.commitPartial = commit
+    .replace(/{{commitUrlFormat}}/g, commitUrlFormat)
+    .replace(/{{issueUrlFormat}}/g, issueUrlFormat)
+  writerOpts.footerPartial = footer
+
+  return writerOpts
+}
+
+function findTypeEntry (types, commit) {
+  const typeKey = (commit.revert ? 'revert' : (commit.type || '')).toLowerCase()
+  return types.find((entry) => {
+    if (entry.type !== typeKey) {
+      return false
+    }
+    if (entry.scope && entry.scope !== commit.scope) {
+      return false
+    }
+    return true
+  })
+}
+
+function getWriterOpts (config) {
+  config = defaultConfig(config)
+
+  const commitGroupOrder = config.types.flatMap(t => t.section).filter(t => t)
+
+  return {
+    transform: (commit, context) => {
+      let discard = true
+      const issues = []
+      const entry = findTypeEntry(config.types, commit)
+
+      // adds additional breaking change notes
+      // for the special case, test(system)!: hello world, where there is
+      // a '!' but no 'BREAKING CHANGE' in body:
+      addBangNotes(commit)
+
+      // Add an entry in the CHANGELOG if special Release-As footer
+      // is used:
+      if ((commit.footer && releaseAsRe.test(commit.footer)) ||
+          (commit.body && releaseAsRe.test(commit.body))) {
+        discard = false
+      }
+
+      commit.notes.forEach(note => {
+        note.title = 'BREAKING CHANGES'
+        discard = false
+      })
+
+      // breaking changes attached to any type are still displayed.
+      if (discard && (entry === undefined ||
+          entry.hidden)) return
+
+      if (entry) commit.type = entry.section
+
+      if (commit.scope === '*') {
+        commit.scope = ''
+      }
+
+      if (typeof commit.hash === 'string') {
+        commit.shortHash = commit.hash.substring(0, 7)
+      }
+
+      if (typeof commit.subject === 'string') {
+        // Issue URLs.
+        config.issuePrefixes.join('|')
+        const issueRegEx = '(' + config.issuePrefixes.join('|') + ')' + '([0-9]+)'
+        const re = new RegExp(issueRegEx, 'g')
+
+        commit.subject = commit.subject.replace(re, (_, prefix, issue) => {
+          issues.push(prefix + issue)
+          const url = expandTemplate(config.issueUrlFormat, {
+            host: context.host,
+            owner: context.owner,
+            repository: context.repository,
+            id: issue,
+            prefix: prefix
+          })
+          return `[${prefix}${issue}](${url})`
+        })
+        // User URLs.
+        commit.subject = commit.subject.replace(/\B@([a-z0-9](?:-?[a-z0-9/]){0,38})/g, (_, user) => {
+          // TODO: investigate why this code exists.
+          if (user.includes('/')) {
+            return `@${user}`
+          }
+
+          const usernameUrl = expandTemplate(config.userUrlFormat, {
+            host: context.host,
+            owner: context.owner,
+            repository: context.repository,
+            user: user
+          })
+
+          return `[@${user}](${usernameUrl})`
+        })
+      }
+
+      // remove references that already appear in the subject
+      commit.references = commit.references.filter(reference => {
+        if (issues.indexOf(reference.prefix + reference.issue) === -1) {
+          return true
+        }
+
+        return false
+      })
+
+      return commit
+    },
+    groupBy: 'type',
+    // the groupings of commit messages, e.g., Features vs., Bug Fixes, are
+    // sorted based on their probable importance:
+    commitGroupsSort: (a, b) => {
+      const gRankA = commitGroupOrder.indexOf(a.title)
+      const gRankB = commitGroupOrder.indexOf(b.title)
+      return gRankA - gRankB
+    },
+    commitsSort: ['scope', 'subject'],
+    noteGroupsSort: 'title',
+    notesSort: compareFunc
+  }
+}
+
+// merge user set configuration with default configuration.
+function defaultConfig (config) {
+  config = config || {}
+  config.types = config.types || [
+    { type: 'feat', section: 'Features' },
+    { type: 'feature', section: 'Features' },
+    { type: 'fix', section: 'Bug Fixes' },
+    { type: 'perf', section: 'Performance Improvements' },
+    { type: 'revert', section: 'Reverts' },
+    { type: 'docs', section: 'Documentation', hidden: true },
+    { type: 'style', section: 'Styles', hidden: true },
+    { type: 'chore', section: 'Miscellaneous Chores', hidden: true },
+    { type: 'refactor', section: 'Code Refactoring', hidden: true },
+    { type: 'test', section: 'Tests', hidden: true },
+    { type: 'build', section: 'Build System', hidden: true },
+    { type: 'ci', section: 'Continuous Integration', hidden: true }
+  ]
+  config.issueUrlFormat = config.issueUrlFormat ||
+    '{{host}}/{{owner}}/{{repository}}/issues/{{id}}'
+  config.commitUrlFormat = config.commitUrlFormat ||
+    '{{host}}/{{owner}}/{{repository}}/commit/{{hash}}'
+  config.compareUrlFormat = config.compareUrlFormat ||
+    '{{host}}/{{owner}}/{{repository}}/compare/{{previousTag}}...{{currentTag}}'
+  config.userUrlFormat = config.userUrlFormat ||
+    '{{host}}/{{user}}'
+  config.issuePrefixes = config.issuePrefixes || ['#']
+
+  return config
+}
+
+// expand on the simple mustache-style templates supported in
+// configuration (we may eventually want to use handlebars for this).
+function expandTemplate (template, context) {
+  let expanded = template
+  Object.keys(context).forEach(key => {
+    expanded = expanded.replace(new RegExp(`{{${key}}}`, 'g'), context[key])
+  })
+  return expanded
+}

package/node_modules/conventional-changelog-core/README.md

@@ -0,0 +1,255 @@
+#  [![NPM version][npm-image]][npm-url] [![Build Status: Linux][travis-image]][travis-url] [![Build Status: Windows][appveyor-image]][appveyor-url] [![Dependency Status][daviddm-image]][daviddm-url] [![Coverage Status][coverage-image]][coverage-url]
+
+> [conventional-changelog](https://github.com/conventional-changelog/conventional-changelog) core
+
+You are probably looking for the [cli](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-cli) module. Or use one of the plugins if you are already using the tool:  [grunt](https://github.com/btford/grunt-conventional-changelog)/[gulp](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/gulp-conventional-changelog)/[atom](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-atom).
+
+## Usage
+
+```sh
+$ npm install --save conventional-changelog-core
+```
+
+```js
+var conventionalChangelogCore = require('conventional-changelog-core');
+
+conventionalChangelogCore()
+  .pipe(process.stdout); // or any writable stream
+```
+
+## API
+
+### conventionalChangelogCore([options, [context, [gitRawCommitsOpts, [parserOpts, [writerOpts]]]]])
+
+Returns a readable stream.
+
+*Note:* [`options.transform`](#transform-1), [`options.pkg.transform`](#transform) and [`writerOpts.transform`](https://github.com/conventional-changelog/conventional-changelog-writer#transform) are different. If you have a better naming suggestion, please send a PR.
+
+#### options
+
+##### config
+
+Type: `promise`, `function` or `object`
+
+This should serve as default values for other arguments of `conventionalChangelogCore` so you don't need to rewrite the same or similar config across your projects. Any value in this could be overwritten.
+If this is a promise (recommended if async), it should resolve with the config.
+If this is a function, it expects a node style callback with the config object.
+If this is an object, it is the config object. The config object should include `context`, `gitRawCommitsOpts`, `parserOpts` and `writerOpts`.
+
+##### pkg
+
+Type: `object`
+
+###### path
+
+Type: `string` Default: [closest package.json](https://github.com/sindresorhus/read-pkg-up).
+
+The location of your "package.json".
+
+###### transform
+
+Type: `function` Default: pass through.
+
+A function that takes `package.json` data as the argument and returns the modified data. Note this is performed before normalizing package.json data. Useful when you need to add a leading 'v' to your version or modify your repository url, etc.
+
+##### append
+
+Type: `boolean` Default: `false`
+
+Should the log be appended to existing data.
+
+##### releaseCount
+
+Type: `number` Default: `1`
+
+How many releases of changelog you want to generate. It counts from the upcoming release. Useful when you forgot to generate any previous changelog. Set to `0` to regenerate all.
+
+##### skipUnstable
+
+Type: `boolean` Default: `false`
+
+If set, unstable release tags will be skipped, e.g., x.x.x-rc.
+
+##### debug
+
+Type: `function` Default: `function() {}`
+
+A debug function. EG: `console.debug.bind(console)`
+
+##### warn
+
+Type: `function` Default: `options.debug`
+
+A warn function. EG: `grunt.verbose.writeln`
+
+##### transform
+
+Type: `function` Default: get the version (without leading 'v') from tag and format date.
+
+###### function(commit, cb)
+
+A transform function that applies after the parser and before the writer.
+
+This is the place to modify the parsed commits.
+
+####### commit
+
+The commit from conventional-commits-parser.
+
+####### cb
+
+Callback when you are done.
+
+####### this
+
+`this` arg of transform handler of a stream.
+
+##### outputUnreleased
+
+Type: `boolean` Default: `true` if a different version than last release is given. Otherwise `false`.
+
+If this value is `true` and `context.version` equals last release then `context.version` will be changed to `'Unreleased'`.
+
+**NOTE:** You may want to combine this option with `releaseCount` set to `0` to always overwrite the whole CHANGELOG. `conventional-changelog` only outputs a CHANGELOG but doesn't read any existing one.
+
+##### lernaPackage
+
+Specify a package in lerna-style monorepo that the CHANGELOG should be generated for.
+
+Lerna tags releases in the format `foo-package@1.0.0` and assumes that packages
+are stored in the directory structure `./packages/foo-package`.
+
+##### tagPrefix
+
+Specify a prefix for the git tag that will be taken into account during the comparison.
+For instance if your version tag is prefixed by `version/` instead of `v` you would specify `--tagPrefix=version/`
+
+#### context
+
+See the [conventional-changelog-writer](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer) docs. There are some defaults or changes:
+
+##### host
+
+Default: normalized host found in `package.json`.
+
+##### version
+
+Default: version found in `package.json`.
+
+##### owner
+
+Default: extracted from normalized `package.json` `repository.url` field.
+
+##### repository
+
+Default: extracted from normalized `package.json` `repository.url` field.
+
+##### repoUrl
+
+Default: The whole normalized repository url in `package.json`.
+
+##### gitSemverTags
+
+Type: `array`
+
+All git semver tags found in the repository. You can't overwrite this value.
+
+##### previousTag
+
+Type: `string` Default: previous semver tag or the first commit hash if no previous tag.
+
+##### currentTag
+
+Type: `string` Default: current semver tag or `'v'` + version if no current tag.
+
+##### packageData
+
+Type: `object`
+
+Your `package.json` data. You can't overwrite this value.
+
+##### linkCompare
+
+Type: `boolean` Default: `true` if `previousTag` and `currentTag` are truthy.
+
+Should link to the page that compares current tag with previous tag?
+
+#### gitRawCommitsOpts
+
+See the [git-raw-commits](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/git-raw-commits) docs. There are some defaults:
+
+##### format
+
+Default: `'%B%n-hash-%n%H%n-gitTags-%n%d%n-committerDate-%n%ci'`
+
+##### from
+
+Default: based on `options.releaseCount`.
+
+##### reverse
+
+Default: `true` if `options.append` is truthy.
+
+##### debug
+
+Type: `function` Default: `options.debug`
+
+#### parserOpts
+
+See the [conventional-commits-parser](https://github.com/conventional-changelog/conventional-commits-parser) docs.
+
+##### warn
+
+Default: `options.warn`
+
+#### writerOpts
+
+See the [conventional-changelog-writer](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-writer) docs. There are some defaults:
+
+##### finalizeContext
+
+Finalize context is used for generating above context.
+
+**NOTE:** If you overwrite this value the above context defaults will be gone.
+
+##### debug
+
+Type: `function` Default: `options.debug`
+
+##### reverse
+
+Default: `options.append`
+
+##### doFlush
+
+Default: `options.outputUnreleased`
+
+
+## Notes for parent modules
+
+This module has options `append` and `releaseCount`. However, it doesn't read your previous changelog. Reasons being:
+
+1. The old logs is just to be appended or prepended to the newly generated logs, which is a very simple thing that could be done in the parent module.
+2. We want it to be very flexible for the parent module. You could create a readable stream from the file or you could just read the file.
+3. We want the duty of this module to be very minimum.
+
+So, when you build a parent module, you need to read the old logs and append or prepend to them based on `options.append`. However, if `options.releaseCount` is `0` you need to ignore any previous logs. Please see [conventional-github-releaser](https://github.com/conventional-changelog/conventional-github-releaser) as an example.
+
+Arguments passed to `conventionalChangelogCore` will be mutated.
+
+
+## License
+
+MIT
+
+
+[npm-image]: https://badge.fury.io/js/conventional-changelog-core.svg
+[npm-url]: https://npmjs.org/package/conventional-changelog-core
+[travis-image]: https://travis-ci.org/conventional-changelog/conventional-changelog-core.svg?branch=master
+[travis-url]: https://travis-ci.org/conventional-changelog/conventional-changelog-core
+[appveyor-image]: https://ci.appveyor.com/api/projects/status/baoumm34w8c5o0hv/branch/master?svg=true
+[appveyor-url]: https://ci.appveyor.com/project/stevemao/conventional-changelog-core/branch/master
+[daviddm-image]: https://david-dm.org/conventional-changelog/conventional-changelog-core.svg?theme=shields.io
+[daviddm-url]: https://david-dm.org/conventional-changelog/conventional-changelog-core
+[coverage-image]: https://coveralls.io/repos/github/conventional-changelog/conventional-changelog/badge.svg?branch=master
+[coverage-url]: https://coveralls.io/github/conventional-changelog/conventional-changelog?branch=master