⚡ Energize

Author: cossssmin

.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+charset = utf-8
+indent_size = 2
+indent_style = space
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[*.md]
+trim_trailing_whitespace = false

.github/FUNDING.yml

@@ -0,0 +1,12 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+otechie: # Replace with a single Otechie username
+custom: ['https://paypal.me/cossssmin', 'https://www.amazon.co.uk/hz/wishlist/ls/3I8KTU4FLQIZ1']

.github/ISSUE_TEMPLATE/1_Bug_report.md

@@ -0,0 +1,15 @@
+---
+name: "🐛 Bug Report"
+about: 'Report a general issue.'
+
+---
+
+## Problem
+
+_Describe your problem._
+
+## Environment
+
+- `posthtml-myplugin` plugin version: #.#.#
+- PostHTML version: #.#.#
+- Node.js version: #.#.#

.gitignore

@@ -0,0 +1,3 @@
+node_modules/
+.nyc_output
+*.log

.travis.yml

@@ -0,0 +1,4 @@
+language: node_js
+node_js:
+  - latest
+  - stable

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) Cosmin Popovici
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,110 @@
+<div align="center">
+  <img width="150" height="150" title="PostHTML" src="https://posthtml.github.io/posthtml/logo.svg">
+  <h1>URL Parameters</h1>
+  <p>Add parameters to URLs</p>
+
+  [![Version][npm-version-shield]][npm]
+  [![License][license-shield]][license]
+  [![Build][travis-ci-shield]][travis-ci]
+  [![Downloads][npm-stats-shield]][npm-stats]
+</div>
+
+## About
+
+This is a PostHTML plugin that allows you to add parameters to URLs.
+
+## Install
+
+```
+$ npm i posthtml posthtml-url-parameters
+```
+
+## Usage
+
+```js
+const posthtml = require('posthtml')
+const urlParams = require('posthtml-url-parameters')
+
+const parameters = {foo: 'bar', baz: 'qux'}
+
+posthtml([
+    urlParams({
+      parameters: parameters
+    })
+  ])
+  .process('<a href="https://example.com">Test</div>')
+  .then(result => console.log(result.html)))
+
+  // <a href="https://example.com?baz=qux&foo=bar">Test</div>
+```
+
+## Configuration
+
+### `parameters`
+
+Default: `undefined`
+
+Object containing parameter name (key) and its value.
+
+Example:
+
+```js
+require('posthtml-url-parameters')({
+  parameters: {
+    utm_source: 'Campaign',
+    '1stDraft': true
+  }
+})
+```
+
+### `tags`
+
+Default: `[a]`
+
+Array of tag names to process. Only URLs inside `href=""` attributes of tags in this array will be processed.
+
+Example:
+
+```js
+require('posthtml-url-parameters')({
+  tags: ['a', 'link'],
+  // ...
+})
+```
+
+### `options`
+
+Default: `undefined`
+
+Options to pass to `query-string` - see available options [here](https://github.com/sindresorhus/query-string#stringifyobject-options).
+
+For example, you can disable encoding:
+
+```js
+const posthtml = require('posthtml')
+const urlParams = require('posthtml-url-parameters')
+
+const parameters = {foo: '@Bar@'}
+
+posthtml([
+    urlParams({
+      parameters: parameters,
+      options: {
+        encode: false
+      }
+    })
+  ])
+  .process('<a href="https://example.com">Test</div>')
+  .then(result => console.log(result.html)))
+
+  // <a href="https://example.com?foo=@Bar@">Test</div>
+```
+
+[npm]: https://www.npmjs.com/package/posthtml-url-parameters
+[npm-version-shield]: https://img.shields.io/npm/v/posthtml-url-parameters.svg
+[npm-stats]: http://npm-stat.com/charts.html?package=posthtml-url-parameters
+[npm-stats-shield]: https://img.shields.io/npm/dt/posthtml-url-parameters.svg
+[travis-ci]: https://travis-ci.org/cossssmin/posthtml-url-parameters/
+[travis-ci-shield]: https://img.shields.io/travis/cossssmin/posthtml-url-parameters/master.svg
+[license]: ./LICENSE
+[license-shield]: https://img.shields.io/npm/l/posthtml-url-parameters.svg

lib/index.js

@@ -0,0 +1,36 @@
+'use strict'
+
+const isUrl = require('is-url-superb')
+const qs = require('query-string')
+
+module.exports = config => tree => {
+  const process = node => {
+    if (!config || !config.parameters) {
+      return node
+    }
+
+    const tags = config && config.tags ? config.tags : ['a']
+
+    if (tags.includes(node.tag) && node.attrs && node.attrs.href) {
+      const url = node.attrs.href
+      const parsed = qs.parseUrl(url)
+
+      if (!isUrl(parsed.url)) {
+        return node
+      }
+
+      Object.keys(config.parameters).forEach(item => {
+        parsed.query[item] = config.parameters[item]
+      })
+
+      node.attrs.href = qs.stringifyUrl(parsed, config.options)
+    }
+
+    return node
+  }
+
+  return new Promise(resolve => {
+    tree.walk(process)
+    resolve(tree)
+  })
+}