# Changelog

All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).

# [1.15.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.15.0) - 2021-01-21

### Changed

- `typedi` DI was completely removed from the project. All the services are now plain old singletons.

# [1.14.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.14.0) - 2020-09-07

### Removed

- `entities` and related action handlers were removed, as functionality was never used seriously and can be replaced with other technics that are more obvious for script writer.
- dropped support of previously optional global configuration file stored in `$HOME/$FBL_HOME/config`. This functionality was never provided a real value.

# [1.13.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.13.2) - 2020-02-25

### Fixed

- When enabled`dynamicWorkDir` option, `virtual` was incorrectly passing working directory to the child action. Unit tests were updated to cover this case.

# [1.13.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.13.1) - 2020-02-25

### Added

- New option `dynamicWorkDir` for `virtual` action handler that can override default behavior to resolve work dir based on the place of invocation, but not declaration.

# [1.13.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.13.0) - 2020-02-24

### Added

- New action handler `invoke` that allows to execute action handler passed as parameter value. Can be used in pair with `virtual` to create reach flow experiences.

# [1.12.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.12.1) - 2020-02-24

### Fixed

- `switch` action handler didn't resolve value on subsequent execution and kept using the first resolved value.

# [1.12.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.12.0) - 2020-02-04

### Added

- New action handler `retry` that allows to retry failed action till it passes or reaches maximum retry attempts.

# [1.11.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.11.0) - 2019-11-20

### Fixed

- [\#559](https://github.com/FireBlinkLTD/fbl/issues/559) - allow to use `$ref` syntax in object keys, not simply values

### Added

- [\#519](https://github.com/FireBlinkLTD/fbl/issues/519) - documentation related to ability use file masks with `ctx` and `secrets` action handlers

# [1.10.3](https://github.com/FireBlinkLTD/fbl/releases/tag/1.10.3) - 2019-11-10

### Fixed

- [\#546](https://github.com/FireBlinkLTD/fbl/issues/546) - `foreach` action handler now stops of first failed iteration (if not using `async` mode).

# [1.10.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.10.2) - 2019-10-30

### Fixed

- `@Inject()` annotation didn't work in second level nested injections for plugins.

# [1.10.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.10.1) - 2019-10-04

### Added

- `find` action handler now allows to provide result relative to give base directory path.

# [1.10.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.10.0) - 2019-09-12

### Changed

- [\#490](https://github.com/FireBlinkLTD/fbl/issues/490) - log messages now included full path to the flow file.

### Fixed

- [#501](https://github.com/FireBlinkLTD/fbl/issues/501) - \$ref syntax is now supporting environment variables, e.g. `$ref:env.VAR_NAME`

# [1.9.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.9.2) - 2019-08-12

### Fixed

- `$.include` incorrect behavior; unit tests added.

# [1.9.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.9.1) - 2019-08-12

### Fixed

- `$.include` now uses file path when invoked from "Write to File" action handler's template.

# [1.9.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.9.0) - 2019-08-10

### Changed

- removed support of `include` EJS directive, instead `$.include` utility function now available to mimic same functionality.

# [1.8.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.8.0) - 2019-07-23

### Added

- [\#434](https://github.com/FireBlinkLTD/fbl/issues/434) - added `ActionError` that can be used to report custom error codes by Action Handlers that later can be caught by `try` Action Handler to behave differently on different kinds of errors.

- [\#446](https://github.com/FireBlinkLTD/fbl/issues/446) - added support of `include` EJS directive for both local and global template processors.

# [1.7.5](https://github.com/FireBlinkLTD/fbl/releases/tag/1.7.5) - 2019-07-03

### Changed

- [\#431](https://github.com/FireBlinkLTD/fbl/issues/431) - `shelljs` module was replaced with `command-exists` to find installed apps (specified in flow requirements)

# [1.7.4](https://github.com/FireBlinkLTD/fbl/releases/tag/1.7.4) - 2019-06-05

### Changed

- [\#394](https://github.com/FireBlinkLTD/fbl/issues/394) - `exec` and `shell` action handlers now print verbose output even when `--verbose` cli attribute isn't provided

### Fixed

- [\#393](https://github.com/FireBlinkLTD/fbl/issues/393) - `exec` and `shell` action handlers now support relative paths for `wd` (working directory) option

# [1.7.3](https://github.com/FireBlinkLTD/fbl/releases/tag/1.7.3) - 2019-06-04

### Added

- [\#390](https://github.com/FireBlinkLTD/fbl/issues/390) - CLI now allows to assign JSON value inline (from the command argument value)
- [\#391](https://github.com/FireBlinkLTD/fbl/issues/391) - CLI now allows to provide escape sequence for inline values to assign ones that start with either `@` or `%`

# [1.7.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.7.2) - 2019-05-30

### Changed

- [\#367](https://github.com/FireBlinkLTD/fbl/issues/367) - Select Action Handler now allows to specify title and value as separate options
- [\#368](https://github.com/FireBlinkLTD/fbl/issues/368) - Multiselect Action Handler now allows to specify title and value as separate options

# [1.7.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.7.1) - 2019-04-29

### Fixed

- [\#365](https://github.com/FireBlinkLTD/fbl/issues/365) - Incomplete string escaping of EJS template values.
- [\#355](https://github.com/FireBlinkLTD/fbl/issues/355) - BaseValuesAssignmentActionProcessor now also processed reference syntax inside files.

## [1.7.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.7.0) - 2019-03-23

### Fixed

- [\#336](https://github.com/FireBlinkLTD/fbl/issues/336) - Help output no longer prints `-h` option twice.

### Changed

- [\#229](https://github.com/FireBlinkLTD/fbl/issues/229) - ActionHandler changed to return ActionProcessor instance instead of handling `validate`, `execute` methods directly.

### Added

- [\#210](https://github.com/FireBlinkLTD/fbl/issues/210) - Backward compatibility test coverage for changes introduced by [\#229](https://github.com/FireBlinkLTD/fbl/issues/229)

## [1.6.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.6.0) - 2019-02-27

### Changed

- [\#330](https://github.com/FireBlinkLTD/fbl/issues/330) - FlowService's executeAction signature changed to make way easier invocation process. That also maked possible to use action handlers without options.

## [1.5.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.5.2) - 2019-02-25

### Added

- [\#324](https://github.com/FireBlinkLTD/fbl/issues/324) - Added new action handler "void" to basically do nothing :)

### Changed

- [\#323](https://github.com/FireBlinkLTD/fbl/issues/324) - sequence and parallel action handlers now support empty arrays of actions and no longer require at least one action to exists inside it.

## [1.5.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.5.1) - 2019-01-17

### Fixed

- [\#304](https://github.com/FireBlinkLTD/fbl/issues/304) - CLI assignment no longer overrides values when multiple assignment arguments passed to the same parent path.

### Changes

## [1.5.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.5.0) - 2019-01-16

### Changes

- \[Breaking\] [\#295](https://github.com/FireBlinkLTD/fbl/issues/295) global file format changed. Old one no longer works.
- [\#297](https://github.com/FireBlinkLTD/fbl/issues/297) DeepMergeUtil replaced with [object-collider](https://www.npmjs.com/package/object-collider) module.

## [1.4.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.4.0) - 2019-01-08

### Added

- [\#288](https://github.com/FireBlinkLTD/fbl/issues/288) Added `find` action handler that allows to search files by masks.

### Changes

- \[Breaking\] [\#287](https://github.com/FireBlinkLTD/fbl/issues/287) `encrypt` and `decrypt` action handlers moved out to separate [plugin](https://github.com/FireBlinkLTD/fbl-plugins-crypto).

## [1.3.3](https://github.com/FireBlinkLTD/fbl/releases/tag/1.3.2) - 2018-12-17

### Added

- [\#276](https://github.com/FireBlinkLTD/fbl/issues/276) Added `echo` action handler.

## [1.3.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.3.2) - 2018-12-13

### Added

- [\#267](https://github.com/FireBlinkLTD/fbl/issues/267) Added `shareParameters` option for `while` action handler.
- [\#268](https://github.com/FireBlinkLTD/fbl/issues/268) Added `shareParameters` option for `each` action handler.
- [\#269](https://github.com/FireBlinkLTD/fbl/issues/269) Added `shareParameters` option for `parallel` action handler.
- [\#270](https://github.com/FireBlinkLTD/fbl/issues/270) Added `shareParameters` option for `repeat` action handler.

## [1.3.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.3.1) - 2018-12-10

### Added

- [\#259](https://github.com/FireBlinkLTD/fbl/issues/259) Added root facade to make plugin import more organized.

### Fixed

- [\#263](https://github.com/FireBlinkLTD/fbl/issues/263) `$.assignTo` and `$.pushTo` no longer fails on missing paths, instead it just ignores the execution.

## [1.3.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.3.0) - 2018-12-05

### Added

- [\#254](https://github.com/FireBlinkLTD/fbl/issues/254) Added `$.assignTo` and `$.pushTo` template utility functions.

### Fixed

- [\#253](https://github.com/FireBlinkLTD/fbl/issues/253) "virtual" action handler now processes templates inside "defaults" and "parametersSchema" fields.
- [\#255](https://github.com/FireBlinkLTD/fbl/issues/255) "function" action handler now has access to template utility functions directly inside the body.

### Changes

- \[Breaking\] ITemplateUtility interface was changed to be more action handler oriented. `wd` parameter removed in favor of `context`, `snapshot` and `parameters` ones that are neede for `$.assigTo` and `$.pushTo` utility functions to operate. `wd` can be taken from `snapshot.wd`.

## [1.2.6](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.6) - 2018-12-04

### Added

- [\#250](https://github.com/FireBlinkLTD/fbl/issues/250) "sequence" action handler now supports alternative options syntax with "shareParameters" options. That options allow to re-use `parameters` across all invoked actions instead of making a clone for each.

### Changes

- [\#251](https://github.com/FireBlinkLTD/fbl/issues/251) "function" action handler now also can return object that will be used to override context and parameters.

## [1.2.5](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.5) - 2018-12-03

### Fixed

- [\#247](https://github.com/FireBlinkLTD/fbl/issues/247) Expose "parameters" and "iteration" properties to "function" action handler.
- [\#243](https://github.com/FireBlinkLTD/fbl/issues/243) Reference extended to support `$ref:cwd` and `$ref:iteration`

### Changes

- Along with [\#247](https://github.com/FireBlinkLTD/fbl/issues/247) fix, `context` property no longer wraps context fields. Instead all the fields are not available without a wrapper.

## [1.2.4](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.4) - 2018-11-30

### Fixed

- [\#241](https://github.com/FireBlinkLTD/fbl/issues/241) Reference resoling (`$ref:`) now also works for array items.

### Added

- Added `IAssignTo` and `IPushTo` interfaces to describe `assignTo` and `pushTo` options.

## [1.2.3](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.3) - 2018-11-28

### Fixed

- [\#234](https://github.com/FireBlinkLTD/fbl/issues/234) Parameters assignment action handler replaced with \$parameters metadata processing.

## [1.2.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.2) - 2018-11-27

### Added

- [\#230](https://github.com/FireBlinkLTD/fbl/issues/230) Parameters assignment action handler.

### Changed

- [\#231](https://github.com/FireBlinkLTD/fbl/issues/231) \$.hash function now rejects undefined, null and non-string values.
- [\#232](https://github.com/FireBlinkLTD/fbl/issues/232) EJS custom escape function now returns "null" for null and undefined values.

## [1.2.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.1) - 2018-11-26

### Fixed

- [\#225](https://github.com/FireBlinkLTD/fbl/issues/225) Fixed issue, when "select" and "multiselect" action handlers were not printing options correctly.
- [\#226](https://github.com/FireBlinkLTD/fbl/issues/226) Allow `false` value assignment for context actions handlers.

### Added

- [\#227](https://github.com/FireBlinkLTD/fbl/issues/227) Added `--verbose` CLI parameter to print all log statements.
- [\#224](https://github.com/FireBlinkLTD/fbl/issues/224) Added ability to use `assignTo` and `pushTo` parameters with alternative syntax.

### Changed

- [\#227](https://github.com/FireBlinkLTD/fbl/issues/227) All previously printed `info` logs are now suppressed by default.

## [1.2.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.2.0) - 2018-11-23

### Changed

- [\#218](https://github.com/FireBlinkLTD/fbl/issues/218) Breaking change. `$.escape` template utility function has been removed in favor of custom EJS escape function.

### Added

- [\#220](https://github.com/FireBlinkLTD/fbl/issues/220) Added functionality to reference context values in template directly without a need to convert values to JSON beforehand and passing through EJS template.

### Fixed

- [\#219](https://github.com/FireBlinkLTD/fbl/issues/219) Default virtual's merge function no longer produces duplicated records upon merging arrays.

## [1.1.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.1.2) - 2018-11-21

### Fixed

- [\#215](https://github.com/FireBlinkLTD/fbl/issues/215) plugin loading via CLI is now working same way as "requires" section inside the flow definition.

## [1.1.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.1.1) - 2018-11-21

### Fixed

- [\#213](https://github.com/FireBlinkLTD/fbl/issues/213) "try" action handler now invokes "finally" action regardless of "action" result.

### Added

- [\#206](https://github.com/FireBlinkLTD/fbl/issues/206) added option to cache remote flows inside \${FBL_HOME}/cache dir via CLI and "attachment" action.

## [1.1.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.1.0) - 2018-11-19

### Changed

- [\#205](https://github.com/FireBlinkLTD/fbl/issues/205) virtual default parameters are now automatically merged.
- [\#207](https://github.com/FireBlinkLTD/fbl/issues/207) $.toJSON replaced with $.escape that allows to escape unquoted strings that can break YAML parser.

### Added

- Virtual merge modification by path. No need to override entire merge behaviour. Override is possible for sub-path elements only.

### Fixed

- [\#208](https://github.com/FireBlinkLTD/fbl/issues/208) Virtual action handler now uses directory where virtual action handler is located as working directory.

## [1.0.4](https://github.com/FireBlinkLTD/fbl/releases/tag/1.0.4) - 2018-11-16

### Fixed

- [\#200](https://github.com/FireBlinkLTD/fbl/issues/200) FSUtil.getAbsolutePath now removes trailing slash if path is already absolute.

### Added

- [\#198](https://github.com/FireBlinkLTD/fbl/issues/198) Added notification to user about action handler overrides.
- [\#201](https://github.com/FireBlinkLTD/fbl/issues/201) Added "wd" option for "shell" and "exec" action handlers that allow to run commands from given directory.

### Changes

- [\#199](https://github.com/FireBlinkLTD/fbl/issues/199) "fn" action handler moved from "context" core plugin to "exec" one.

## [1.0.3](https://github.com/FireBlinkLTD/fbl/releases/tag/1.0.3) - 2018-11-14

### Changes

- [\#192](https://github.com/FireBlinkLTD/fbl/issues/192) Updated "assignXXXTo" options across all action handlers to have an option to assign result\(s\) to parameters.
- [\#194](https://github.com/FireBlinkLTD/fbl/issues/194) Similar to "assignTo" property added another one "pushTo" that allows to push record\(s\) into array instead of overriding the field value.
- [\#195](https://github.com/FireBlinkLTD/fbl/issues/195) "ctx" and "secrets" action handlers now allow array concatenation not just assignment.
- "cmd" and "shell" assignTo field renamed to "assignResultTo" to conform with naming convention across other action handlers.

## [1.0.2](https://github.com/FireBlinkLTD/fbl/releases/tag/1.0.2) - 2018-11-08

### Fixed

- [\#186](https://github.com/FireBlinkLTD/fbl/issues/186) - Fixed issue when cached resolved flow was not counting full

  path, but just relative and when 2 separate subflows were referencing different files with same relative path but

  different absolute - first cached was returned for both.

### Changes

- [\#184](https://github.com/FireBlinkLTD/fbl/issues/184) - "ctx" and "secrets" now allowing assignment any value to non-root path, not just object.

## [1.0.1](https://github.com/FireBlinkLTD/fbl/releases/tag/1.0.1) - 2018-11-07

### Fixed

- [\#181](https://github.com/FireBlinkLTD/fbl/issues/181) - Allow relative path usage inside the flow's required plugins

  section.

- Fix dead-loop upon loading circular plugin dependencies.

## [1.0.0](https://github.com/FireBlinkLTD/fbl/releases/tag/1.0.0) - 2018-11-06

### Added

- [\#178](https://github.com/FireBlinkLTD/fbl/issues/178) - New action handler "while" that allow to repeat some

  action over and over again till it matches something or still not \(configurable\).

- [\#179](https://github.com/FireBlinkLTD/fbl/issues/179) - New action handler "sleep" that allows to wait for given

  amount of seconds.

## [0.5.1](https://github.com/FireBlinkLTD/fbl/releases/tag/0.5.1) - 2018-11-05

Contains JS/TS API breaking changes for ActionHandler.ts.

### Added

- [\#172](https://github.com/FireBlinkLTD/fbl/issues/172) - Virtual action handler now supports default values. Requires

  to define merge function.

### Changed

- [\#171](https://github.com/FireBlinkLTD/fbl/issues/171) - Virtual action handler parameters are now propagated down the

  flow invocation pipe.

## [0.5.0](https://github.com/FireBlinkLTD/fbl/releases/tag/0.5.0) - 2018-11-05

### Added

- [\#166](https://github.com/FireBlinkLTD/fbl/issues/166) - Added ability to reference non-index flow files inside the

  package \(CLI + attachment action handler\)

- [\#167](https://github.com/FireBlinkLTD/fbl/issues/167) - Added ability to provide custom http headers for GET request

  to download package \(CLI + attachment action handler\)

### Changed

- [\#153](https://github.com/FireBlinkLTD/fbl/issues/153) - Report format changed. Now stores context initial and final

  state. Any changes made to context upon execution now stored as diff.

## Previous Releases

You can review notes for previous releases [here](https://github.com/FireBlinkLTD/fbl/releases).