map-transform 0.4.0-alpha.3 → 0.4.0-alpha.30

package/README.md

@@ -148,8 +148,8 @@ npm install map-transform --save
 - Map objects won't be mapped over an array by default. You have to specify
   `$iterate: true`
 - The `alt` operation now accepts any type of pipeline, but not a helper
-  function
-- The root path prefix is changed from `$` to `^`
+  function, and all alternative pipelines must be given as arguments to `alt()`
+- The root path prefix is changed from `$` to `^^`
 
 ## Usage
 
@@ -188,11 +188,14 @@ const def2 = {
 // }
 ```
 
-When you transform an array of data with a mapping object, each item in the
-data array will be be transformed with the mapping object.
+When you transform an array of data with a mapping object, you'll have to set
+`$iterate: true` to have each item in the data array be transformed with the
+mapping object. If you don't the entire array will be passed to the mapping
+object.
 
 ```javascript
 const def3 = {
+  $iterate: true,
   title: 'heading',
 }
 
@@ -203,12 +206,8 @@ const def3 = {
 // ]
 ```
 
-If you want to apply the mapping object to the entire array – not each item in
-the array – set `$iterate: false` on the mapping object or wrap the object in a
-transform pipeline.
-
-**Note:** When a mapping object is part of a transform pipeline, the default is
-to not iterate. See [**transform pipeline**](#transform-pipeline) for more.
+**Note:** Iterating used to be the default behavior, but it has been changed due
+to the contradiction with how the mapping object behaves everywhere else.
 
 A key will set whatever is returned by the pipeline (see
 [next section](#values-on-the-transform-object)), whether it is a string, a
@@ -306,15 +305,18 @@ below.
 
 MapTransform will treat `undefined` as a value that is not set, and so a
 transform object will not be applied to it. So if an `undefined` value meets
-a transform object, it will produce `undefined`, regardsless of the shape of the
+a transform object, it will produce `undefined`, regardless of the shape of the
 transform object.
 
 This is not the case for `null`, though. MapTransform treats `null` as a value,
 an intended nothing, and will apply a transform object to it, even though it
 will most likely produce nothing but default values. To change this behavior,
-set `mutateNull: false` on the `options` object passed to MapTransform. This
-will essentially make MapTransform treat `null` the same way as `undefined` when
-it comes to the transform object.
+set `noneValues: [undefined, null]` on the `options` object passed to
+MapTransform. This will essentially make MapTransform treat `null` the same way
+as `undefined` when it meets to the transform object.
+
+The example above sets `undefined` and `null` as none-values, but you could in
+principle set any primitive values here.
 
 #### Directional transform objects
 
@@ -326,6 +328,17 @@ When running a forward transformation, transform objects marked with
 `$direction: 'rev'` will be skipped. The same goes for `$direction: 'fwd'` in
 reverse.
 
+You may specify aliases for `fwd` and `rev` in the `mapTransform` options:
+
+```javascript
+const options = { fwdAlias: 'from', revAlias: 'to' }
+const mapper = mapTransform(def, options)
+```
+
+In this case, `from` and `to` may be used to specify forward and reverse
+direction respectively. `fwd` and `rev` will still work in addition to the
+aliases.
+
 ### Transform pipeline
 
 The idea of the transform pipeline, is that you describe a set of
@@ -553,10 +566,10 @@ See the `transform()` operation for more on how defining as an object works.
 
 #### `ifelse(conditionFn, truePipeline, falsePipeline)` operation
 
-The `ifelse()` operation will run the `truePipeline` if the `conditionFn` results
-in `true`, otherwise it will run the `falsePipeline`. See
-[the `filter()` operation](#filterconditionFn-operation) for more on the
-requirements for the `conditionFn`.
+The `ifelse()` operation will run the `truePipeline` if the `conditionFn`
+results in something truthy, JavaScript tstyle, otherwise it will run the
+`falsePipeline`. See [the `filter()` operation](#filterconditionFn-operation)
+for more on the requirements for the `conditionFn`.
 
 Both `truePipeline` and `falsePipeline` are optional, in case you only need to
 apply a pipeline in one of the cases.
@@ -577,6 +590,29 @@ const def31 = [
 ]
 ```
 
+Defining an if operation as an object:
+
+```javascript
+import { mapTransform } from 'map-transform'
+
+const def31b = [
+  'members'
+  {
+    name: 'name',
+    active: 'hasPayed'
+  },
+  {
+    $if: 'active',
+    then: set('active[]'),
+    else: set('inactive[]')
+  }
+]
+```
+
+Note that `$if`, `then`, and `else` in the object notation may be any type of
+pipeline definition. The only gotcha is that if `$if` is a function, it is
+treated as a `conditionFn`, like in `def31`, not as a state mapper.
+
 #### `iterate(pipeline)` operation
 
 If you want something to be mapped over the items of an array, the `iterate`
@@ -612,6 +648,9 @@ When an id is passed to the apply operation as `pipelinedId`, the pipeline will
 be applied in the place of the apply operation and executed as if it was part of
 the pipeline definition in the first place.
 
+When no pipeline is provided, e.g. because the id is unknown, no pipeline will
+be applied and the data will pass through untouched.
+
 ```javascript
 import { mapTransform, apply, transform } from 'map-transform'
 
@@ -680,20 +719,20 @@ import { value, alt } from 'map-transform'
 const def10 = {
   id: 'data.customerNo',
   type: value('customer'),
-  name: ['data.name', alt(value('Anonymous'))],
+  name: alt('data.name', value('Anonymous')),
 }
 ```
 
 The operation will not set anything when mapping with `.onlyMappedValues()`.
 
 If you want to define the `value` operation as an operation object, use
-`$transform` or `$alt`:
+`$transform` or the short form `$value`:
 
 ```javascript
 const def10asObject = {
   id: 'data.customerNo',
   type: { $transform: 'value', value: 'customer' },
-  name: ['data.name', { $alt: 'value', value: 'Anonymous' }],
+  name: { $alt: ['data.name', { $value: 'Anonymous' }] },
 }
 ```
 
@@ -708,14 +747,15 @@ will be included when mapping with `.onlyMappedValues()` as well.
 
 #### `alt(pipeline)` operation
 
-The alt operation will apply the pipeline it is given when the data already in
-the pipeline is `undefined`. This is how you provide default values in
-MapTransform. The pipeline may be as simple as a `value()` operation, a dot
-notation path into the source data, or a full pipeline of several operations.
+The alt operation will apply the pipelines in turn until it gets a value,
+meaning that if the first pipeline returns `undefined`, it will try the next and
+so on. This is how you provide default values in MapTransform. The pipeline may
+be as simple as a `value()` operation, a dot notation path into the source data,
+or a full pipeline of several operations.
 
-When given an array, the `alt` operation will treat it as a value and do
-nothing, as it is not an `undefined` value. To provide the `alt` operation to
-every item in the array, please use the `iterate` operation.
+Note that when the return value is an array, it is treated as a value, as it is
+not an `undefined` value. To provide the `alt` operation to every item in the
+array, use the `iterate` operation.
 
 ```javascript
 import { alt, transform, functions } from 'map-transform'
@@ -727,11 +767,9 @@ const formatDate = (data) => {
 
 const def11 = {
   id: 'data.id',
-  name: ['data.name', alt(value('Anonymous'))],
+  name: alt('data.name', value('Anonymous')),
   updatedAt: [
-    'data.updateDate',
-    alt('data.createDate'),
-    alt(transform(currentDate)),
+    alt('data.updateDate', 'data.createDate', transform(currentDate)),
     transform(formatDate),
   ],
 }
@@ -745,16 +783,24 @@ we still have `undefined`, the second alt will call the customer function
 another transform operation pipes whatever data we get from all of this through
 the `formatDate` function.
 
+When `alt` is run in reverse, the alternative pipelines are run in the oposite
+order, with the last being run first. The first pipeline is always run, though,
+as it is common practice to let the first be a `get` that acts like a `set` in
+reverse.
+
+With only one pipeline, `alt` will behave a bit differently. A single pipeline
+will be run if the state has an `undefined` value, but skipped otherwise. This
+is different from the multi-pipeline behavor, where the first is always run and
+the rest is only run if the previous returns `undefined`.
+
 You may also define an alt operation as an object:
 
 ```javascript
 const def11asObject = {
   id: 'data.id',
-  name: ['data.name', { $alt: 'value', value: 'Anonymous' }],
+  name: { $alt: ['data.name', { $value: 'Anonymous' }] },
   updatedAt: [
-    'data.updateDate',
-    { $alt: 'get', path: 'data.createDate' },
-    { $alt: 'currentDate' },
+    { $alt: ['data.updateDate', 'data.createDate', 'currentDate'] },
     { $transform: 'formatDate' },
   ],
 }
@@ -818,6 +864,27 @@ const response = {
 Had we ran this without the `modify()` operation, the returned object would only
 have the `data` prop.
 
+This is equivalent to setting the `$modify` property to `true` on the object
+mutation object:
+
+```javascript
+const def34b = {
+  $modify: true,
+  data: 'data.deeply.placed.items',
+}
+```
+
+Note that `$modify` may also be set further down in the object structure. Also,
+in some cases it may make more sense to specify a path in the source data to
+merge with:
+
+```javascript
+const def34c = {
+  $modify: 'response',
+  data: 'response.data.deeply.placed.items',
+}
+```
+
 #### `fwd(pipeline)` and `rev(pipeline)` operation
 
 All operations in MapTransform will apply in both directions, although some of
@@ -998,7 +1065,51 @@ mapper.rev(mappedData)
 // --> { content: { meta: { authors: ['user1', 'user3'] } } }
 ```
 
-#### `compare({ path, operator, match, matchPath })` function
+You may also define this as a transform object:
+
+```javascript
+const def18o = ['content.meta.authors[]', { $lookup: '$users[]', path: 'id' }]
+```
+
+#### `and(pipeline, pipeline, ...)` operation
+
+Will run all provided pipelines, force their return values to boolean, according
+to JavaScript rules, and return `true` if they are all `true`, otherwise
+`false`.
+
+Typically used together with [`ifelse` operation](#ifelseconditionFn-truePipeline-falsePipeline-operation),
+to support AND logic:
+
+```javascript
+const def36 = [
+  {
+    $if: { $and: ['active', 'authorized'] },
+    then: 'content',
+    else: { $value: undefined },
+  },
+]
+```
+
+#### `or(pipeline, pipeline, ...)` operation
+
+Will run all provided pipelines, force their return values to boolean, according
+to JavaScript rules, and return `true` if any of the are `true`, otherwise
+`false`.
+
+Typically used together with [`ifelse` operation](#ifelseconditionFn-truePipeline-falsePipeline-operation),
+to support OR logic:
+
+```javascript
+const def37 = [
+  {
+    $if: { $or: ['active', 'draft'] },
+    then: 'content',
+    else: { $value: undefined },
+  },
+]
+```
+
+#### `compare({ path, operator, match, matchPath, not })` function
 
 This is a helper function intended for use with the `filter()` operation. You
 pass a dot notation `path` and a `match` value (string, number, boolean) to
@@ -1011,10 +1122,14 @@ data.
 
 The default is to compare the values resulting from `path` and `match` or
 `matchPath` with equality, but other operations may be set on the `operator`
-property. Alternatives: `'='`, `'!='`, `'>'`, `'>='`, `'<'`, or `'<='`.
+property. Alternatives: `'='`, `'!='`, `'>'`, `'>='`, `'<'`, or `'<='`, `in`, or
+`exists`. `in` requires equality to at least one of the elements in an array,
+and `exists` requires any value besides `undefined`.
+
+If the `path` points to an array, the value is expected to be one of the values
+in the array.
 
-If the path points to an array, the value is expected to be one of the values in
-the array.
+Set `not` to `true` to reverse the result of the comparison.
 
 Here's an example where only data where role is set to 'admin' will be kept:
 
@@ -1043,6 +1158,9 @@ const def19o = [
 ]
 ```
 
+When you define the `compare` function as a transform object in JSON and need to
+compare to `undefined`, use `**undefined**` instead.
+
 #### `explode()` function
 
 Given an object, the `explode` helper function will return an array with one
@@ -1081,6 +1199,13 @@ Or as a transform object:
 const def32o = ['currencies', { $transform: 'explode' }]
 ```
 
+#### `implode()` function
+
+This is the exact opposite of the `explode` helper, imploding from a service and
+explode in reverse (to a service). See
+[the documentation for `explode()`](#explode-function), but remember that the
+directions will be reversed for `implode()`.
+
 #### `map(dictionary)` function
 
 This helper function accepts a dictionary described as an array of tuples, where
@@ -1096,7 +1221,8 @@ is returned instead.
 
 The `map` function only supports primitive values, so any object will be mapped to
 `undefined` or the value given by the wildcard in the dictionary. Arrays will be
-iterated to map each value in the array.
+iterated to map each value in the array. To map to or from `undefined` with a
+dictionary defined in JSON, use the value `**undefined**`.
 
 Example:
 
@@ -1115,7 +1241,7 @@ const def28 = {
 }
 ```
 
-When using `map` in an operation object, you may provice a dictionary array
+When using `map` in an operation object, you may provide a dictionary array
 or a named dictionary on the `dictionary` property. An example of with a named
 dictionary:
 
@@ -1138,6 +1264,40 @@ const def29 = {
 const mapper = mapTransform(def29, { dictionaries: { statusCodes: dictionary } })
 ```
 
+#### `sort({asc, path})` function
+
+The `sort` helper function will sort the given array of items in ascending or
+descending (depending on whether `asc` is `true` or `false`). Ascending is the
+default. When a `path` is given, the sort is performed on the value at that path
+on each object in the array. With no `path`, the values in the array are sorted
+directly.
+
+Example:
+
+```javascript
+import { mapTransform, transform, functions } from 'map-transform'
+const { sort } = functions
+
+const data = {
+  items: [{ id: 'ent5' }, { id: 'ent1' }, { id: 'ent3' }],
+}
+
+const def35 = {
+  data: ['items', transform(sort({ asc: true, path: 'id' }))],
+}
+
+const ret = mapTransform(def35)(data)
+// --> { caption: 'Bergen by night. By John F.' }
+```
+
+The `sort` function is also available through a transform object:
+
+```javascript
+const def35o = {
+  data: ['items', { $transform: 'sort', asc: true, path: 'id' }],
+}
+```
+
 #### `template(template)` function
 
 The `template` helper function takes a [handlebars] template and applies the
@@ -1249,7 +1409,7 @@ const def22 = [
   'data.customers[]',
   {
     id: 'customerNo',
-    name: ['fullname', alt(value('Anonymous'))],
+    name: [alt('fullname', value('Anonymous'))],
   },
 ]
 
@@ -1363,8 +1523,8 @@ same goes for flipped transform objects if you want to forward transform.
 
 MapTransform will try its best to map the data it gets to the state you want,
 and will always set all properties, even though the mapping you defined result
-in `undefined`. You may include `alt()` operations to provide default or fallback
-values for these cases.
+in `undefined`. You may include `alt()` operations to provide default or
+fallback values for these cases.
 
 But sometimes, you want just the data that is actually present in the source
 data, without defaults or properties set to `undefined`. MapTransform's
@@ -1380,7 +1540,7 @@ import { mapTransform, alt, value } from 'map-transform'
 
 const def24 = {
   id: 'customerNo',
-  name: ['fullname', alt(value('Anonymous'))],
+  name: alt('fullname', value('Anonymous')),
 }
 
 const mapper = mapTransform(def24)

package/dist/functions/compare.d.ts

@@ -4,6 +4,7 @@ interface CompareOperands extends Operands {
     operator?: string;
     match?: unknown;
     matchPath?: Path;
+    not?: boolean;
 }
-export default function compare({ path, operator, match, matchPath, }: CompareOperands): DataMapper;
+export default function compare({ path, operator, match, matchPath, not, }: CompareOperands): DataMapper;
 export {};

package/dist/functions/compare.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const mapAny = require("map-any");
 const pathGetter_1 = require("../utils/pathGetter");
+const escape_1 = require("../utils/escape");
+const stateHelpers_1 = require("../utils/stateHelpers");
 const not = (comparer) => (value, match) => !comparer(value, match);
 const compareArrayOrValue = (comparer) => (value, match) => Array.isArray(value)
     ? value.some((value) => comparer(value, match))
@@ -8,6 +11,10 @@ const compareArrayOrValue = (comparer) => (value, match) => Array.isArray(value)
 const isNumeric = (value) => typeof value === 'number';
 const compareArrayOrValueNumeric = (comparer) => compareArrayOrValue((value, match) => isNumeric(value) && isNumeric(match) && comparer(value, match));
 const compareEqual = compareArrayOrValue((value, match) => value === match);
+const compareIn = (value, match) => Array.isArray(match)
+    ? match.some((item) => compareEqual(value, item))
+    : compareEqual(value, match);
+const exists = (value) => value !== undefined;
 function createComparer(operator) {
     switch (operator) {
         case '=':
@@ -22,18 +29,32 @@ function createComparer(operator) {
             return compareArrayOrValueNumeric((value, match) => value < match);
         case '<=':
             return compareArrayOrValueNumeric((value, match) => value <= match);
+        case 'in':
+            return compareIn;
+        case 'exists':
+            return exists;
         default:
             return (_value, _match) => false;
     }
 }
-function compare({ path = '.', operator = '=', match, matchPath, }) {
+function compare({ path = '.', operator = '=', match, matchPath, not = false, }) {
     const getValue = (0, pathGetter_1.default)(path);
-    const getMatch = matchPath ? (0, pathGetter_1.default)(matchPath) : () => match;
+    const useRoot = typeof matchPath === 'string' &&
+        matchPath[0] === '^' &&
+        matchPath[1] !== '.';
+    const realMatchPath = useRoot
+        ? matchPath.slice(matchPath[1] === '^' ? 2 : 1)
+        : matchPath;
+    const realMatchValue = mapAny(escape_1.unescapeValue, match);
+    const getMatch = typeof realMatchPath === 'string'
+        ? (0, pathGetter_1.default)(realMatchPath)
+        : () => realMatchValue;
     const comparer = createComparer(operator);
-    return (data) => {
+    return (data, state) => {
         const value = getValue(data);
-        const match = getMatch(data);
-        return comparer(value, match);
+        const match = getMatch(useRoot ? (0, stateHelpers_1.getRootFromState)(state) : data);
+        const result = comparer(value, match);
+        return not ? !result : result;
     };
 }
 exports.default = compare;

package/dist/functions/compare.js.map

@@ -1 +1 @@
-{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/functions/compare.ts"],"names":[],"mappings":";;AACA,oDAAwC;AAiBxC,MAAM,GAAG,GAAG,CAAC,QAAkB,EAAE,EAAE,CAAC,CAAC,KAAc,EAAE,KAAc,EAAE,EAAE,CACrE,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAEzB,MAAM,mBAAmB,GAAG,CAAC,QAAkB,EAAE,EAAE,CAAC,CAClD,KAAc,EACd,KAAc,EACd,EAAE,CACF,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;IAClB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;AAE5B,MAAM,SAAS,GAAG,CAAC,KAAc,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAA;AAEhF,MAAM,0BAA0B,GAAG,CAAC,QAAyB,EAAE,EAAE,CAC/D,mBAAmB,CACjB,CAAC,KAAc,EAAE,KAAc,EAAE,EAAE,CACjC,SAAS,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CACjE,CAAA;AAEH,MAAM,YAAY,GAAG,mBAAmB,CACtC,CAAC,KAAc,EAAE,KAAc,EAAE,EAAE,CAAC,KAAK,KAAK,KAAK,CACpD,CAAA;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,QAAQ,QAAQ,EAAE;QAChB,KAAK,GAAG;YACN,OAAO,YAAY,CAAA;QACrB,KAAK,IAAI;YACP,OAAO,GAAG,CAAC,YAAY,CAAC,CAAA;QAC1B,KAAK,GAAG;YACN,OAAO,0BAA0B,CAC/B,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAChD,CAAA;QACH,KAAK,IAAI;YACP,OAAO,0BAA0B,CAC/B,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CACjD,CAAA;QACH,KAAK,GAAG;YACN,OAAO,0BAA0B,CAC/B,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAChD,CAAA;QACH,KAAK,IAAI;YACP,OAAO,0BAA0B,CAC/B,CAAC,KAAa,EAAE,KAAa,EAAE,EAAE,CAAC,KAAK,IAAI,KAAK,CACjD,CAAA;QACH;YACE,OAAO,CAAC,MAAe,EAAE,MAAe,EAAE,EAAE,CAAC,KAAK,CAAA;KACrD;AACH,CAAC;AAED,SAAwB,OAAO,CAAC,EAC9B,IAAI,GAAG,GAAG,EACV,QAAQ,GAAG,GAAG,EACd,KAAK,EACL,SAAS,GACO;IAChB,MAAM,QAAQ,GAAG,IAAA,oBAAM,EAAC,IAAI,CAAC,CAAA;IAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,IAAA,oBAAM,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAA;IAE5D,MAAM,QAAQ,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IAEzC,OAAO,CAAC,IAAI,EAAE,EAAE;QACd,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC5B,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC5B,OAAO,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;IAC/B,CAAC,CAAA;AACH,CAAC;AAhBD,0BAgBC"}
+{"version":3,"file":"compare.js","sourceRoot":"","sources":["../../src/functions/compare.ts"],"names":[],"mappings":"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"}

package/dist/functions/explode.d.ts

@@ -3,4 +3,5 @@ export interface KeyValue {
     key: string | number;
     value: unknown;
 }
-export default function explode(): DataMapper;
+export declare function explode(): DataMapper;
+export declare function implode(): DataMapper;

package/dist/functions/explode.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.implode = exports.explode = void 0;
 const is_1 = require("../utils/is");
-const isExplodedArray = (data) => data.every((item) => (0, is_1.isObject)(item) && typeof item.key === 'number');
+const isExplodedArray = (data) => data.length > 0 &&
+    data.every((item) => (0, is_1.isObject)(item) && typeof item.key === 'number');
 const setValueOnKey = (target, keyValue) => {
     if ((0, is_1.isObject)(keyValue)) {
         const { key, value } = keyValue;
@@ -26,7 +28,9 @@ function doImplode(data) {
 }
 function doExplode(data) {
     if ((0, is_1.isObject)(data)) {
-        return Object.entries(data).map(([key, value]) => ({
+        return Object.entries(data)
+            .filter(([, value]) => value !== undefined)
+            .map(([key, value]) => ({
             key,
             value,
         }));
@@ -39,7 +43,11 @@ function doExplode(data) {
     }
 }
 function explode() {
-    return (data, context) => (context.rev ? doImplode(data) : doExplode(data));
+    return (data, state) => (state.rev ? doImplode(data) : doExplode(data));
 }
-exports.default = explode;
+exports.explode = explode;
+function implode() {
+    return (data, state) => (state.rev ? doExplode(data) : doImplode(data));
+}
+exports.implode = implode;
 //# sourceMappingURL=explode.js.map

package/dist/functions/explode.js.map

@@ -1 +1 @@
-{"version":3,"file":"explode.js","sourceRoot":"","sources":["../../src/functions/explode.ts"],"names":[],"mappings":";;AAEA,oCAAsC;AAOtC,MAAM,eAAe,GAAG,CAAC,IAAe,EAAE,EAAE,CAC1C,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,aAAQ,EAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAA;AAEtE,MAAM,aAAa,GAAG,CACpB,MAA2C,EAC3C,QAAiB,EACjB,EAAE;IACF,IAAI,IAAA,aAAQ,EAAC,QAAQ,CAAC,EAAE;QACtB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAA;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACzB,MAAM,CAAC,GAAa,CAAC,GAAG,KAAK,CAAA;SAC9B;aAAM;YACL,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;SAC5B;KACF;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACvB,OAAO,IAAI,CAAC,MAAM,CAChB,aAAa,EACb,eAAe,CAAC,IAAI,CAAC;YACnB,CAAC,CAAE,EAAgB;YACnB,CAAC,CAAE,EAA8B,CACpC,CAAA;KACF;SAAM;QACL,OAAO,SAAS,CAAA;KACjB;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,IAAA,aAAQ,EAAC,IAAI,CAAC,EAAE;QAClB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAoB,EAAE,EAAE,CAAC,CAAC;YACpE,GAAG;YACH,KAAK;SACN,CAAC,CAAC,CAAA;KACJ;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAc,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;KACnE;SAAM;QACL,OAAO,SAAS,CAAA;KACjB;AACH,CAAC;AAED,SAAwB,OAAO;IAC7B,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AAC7E,CAAC;AAFD,0BAEC"}
+{"version":3,"file":"explode.js","sourceRoot":"","sources":["../../src/functions/explode.ts"],"names":[],"mappings":";;;AAEA,oCAAsC;AAOtC,MAAM,eAAe,GAAG,CAAC,IAAe,EAAE,EAAE,CAC1C,IAAI,CAAC,MAAM,GAAG,CAAC;IACf,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,aAAQ,EAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAA;AAEtE,MAAM,aAAa,GAAG,CACpB,MAA2C,EAC3C,QAAiB,EACjB,EAAE;IACF,IAAI,IAAA,aAAQ,EAAC,QAAQ,CAAC,EAAE;QACtB,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAA;QAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;YACzB,MAAM,CAAC,GAAa,CAAC,GAAG,KAAK,CAAA;SAC9B;aAAM;YACL,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;SAC5B;KACF;IACD,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACvB,OAAO,IAAI,CAAC,MAAM,CAChB,aAAa,EACb,eAAe,CAAC,IAAI,CAAC;YACnB,CAAC,CAAE,EAAgB;YACnB,CAAC,CAAE,EAA8B,CACpC,CAAA;KACF;SAAM;QACL,OAAO,SAAS,CAAA;KACjB;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAa;IAC9B,IAAI,IAAA,aAAQ,EAAC,IAAI,CAAC,EAAE;QAClB,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;aACxB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAoB,EAAE,EAAE,CAAC,CAAC;YACzC,GAAG;YACH,KAAK;SACN,CAAC,CAAC,CAAA;KACN;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QAC9B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,KAAc,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;KACnE;SAAM;QACL,OAAO,SAAS,CAAA;KACjB;AACH,CAAC;AAED,SAAgB,OAAO;IACrB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AACzE,CAAC;AAFD,0BAEC;AAED,SAAgB,OAAO;IACrB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAA;AACzE,CAAC;AAFD,0BAEC"}

package/dist/functions/index.d.ts

@@ -1,19 +1,22 @@
 import { value, fixed } from './value';
 import compare from './compare';
-import explode from './explode';
+import { explode, implode } from './explode';
 import get from './get';
 import { join, split } from './joinSplit';
 import logical from './logical';
 import map from './map';
+import sort from './sort';
 import template from './template';
 declare const _default: {
     compare: typeof compare;
     explode: typeof explode;
     fixed: typeof fixed;
     get: typeof get;
+    implode: typeof implode;
     join: typeof join;
     logical: typeof logical;
     map: typeof map;
+    sort: typeof sort;
     split: typeof split;
     template: typeof template;
     value: typeof value;

package/dist/functions/index.js

@@ -7,15 +7,18 @@ const get_1 = require("./get");
 const joinSplit_1 = require("./joinSplit");
 const logical_1 = require("./logical");
 const map_1 = require("./map");
+const sort_1 = require("./sort");
 const template_1 = require("./template");
 exports.default = {
     compare: compare_1.default,
-    explode: explode_1.default,
+    explode: explode_1.explode,
     fixed: value_1.fixed,
     get: get_1.default,
+    implode: explode_1.implode,
     join: joinSplit_1.join,
     logical: logical_1.default,
     map: map_1.default,
+    sort: sort_1.default,
     split: joinSplit_1.split,
     template: template_1.default,
     value: value_1.value,

package/dist/functions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":";;AAAA,mCAAsC;AACtC,uCAA+B;AAC/B,uCAA+B;AAC/B,+BAAuB;AACvB,2CAAyC;AACzC,uCAA+B;AAC/B,+BAAuB;AACvB,yCAAiC;AAEjC,kBAAe;IACb,OAAO,EAAP,iBAAO;IACP,OAAO,EAAP,iBAAO;IACP,KAAK,EAAL,aAAK;IACL,GAAG,EAAH,aAAG;IACH,IAAI,EAAJ,gBAAI;IACJ,OAAO,EAAP,iBAAO;IACP,GAAG,EAAH,aAAG;IACH,KAAK,EAAL,iBAAK;IACL,QAAQ,EAAR,kBAAQ;IACR,KAAK,EAAL,aAAK;CACN,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/functions/index.ts"],"names":[],"mappings":";;AAAA,mCAAsC;AACtC,uCAA+B;AAC/B,uCAA4C;AAC5C,+BAAuB;AACvB,2CAAyC;AACzC,uCAA+B;AAC/B,+BAAuB;AACvB,iCAAyB;AACzB,yCAAiC;AAEjC,kBAAe;IACb,OAAO,EAAP,iBAAO;IACP,OAAO,EAAP,iBAAO;IACP,KAAK,EAAL,aAAK;IACL,GAAG,EAAH,aAAG;IACH,OAAO,EAAP,iBAAO;IACP,IAAI,EAAJ,gBAAI;IACJ,OAAO,EAAP,iBAAO;IACP,GAAG,EAAH,aAAG;IACH,IAAI,EAAJ,cAAI;IACJ,KAAK,EAAL,iBAAK;IACL,QAAQ,EAAR,kBAAQ;IACR,KAAK,EAAL,aAAK;CACN,CAAA"}

package/dist/functions/joinSplit.js

@@ -5,16 +5,15 @@ const pathGetter_1 = require("../utils/pathGetter");
 const pathSetter_1 = require("../utils/pathSetter");
 function joinSplit({ path = [], sep = ' ' }, split) {
     const pathArr = [].concat(path);
+    if (pathArr.length === 0) {
+        return (_data, _context) => undefined;
+    }
     const getFns = pathArr.map(pathGetter_1.default);
     const setFns = pathArr.map(pathSetter_1.default);
     return (data, { rev }) => {
         if (split ? !rev : rev) {
             const values = typeof data === 'string' ? data.split(sep) : [];
-            let ret = {};
-            setFns.forEach((setFn, index) => {
-                ret = setFn(values[index], ret);
-            });
-            return ret;
+            return setFns.reduce((obj, setFn, index) => setFn(values[index], obj), undefined);
         }
         else {
             const values = getFns.map((fn) => fn(data));

package/dist/functions/joinSplit.js.map

@@ -1 +1 @@
-{"version":3,"file":"joinSplit.js","sourceRoot":"","sources":["../../src/functions/joinSplit.ts"],"names":[],"mappings":";;;AACA,oDAAwC;AACxC,oDAAwC;AAOxC,SAAS,SAAS,CAChB,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,GAAG,GAAG,EAAW,EACjC,KAAc;IAEd,MAAM,OAAO,GAAI,EAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAM,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAM,CAAC,CAAA;IAElC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACvB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE;YACtB,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAC9D,IAAI,GAAG,GAAG,EAAE,CAAA;YACZ,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBAE9B,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAA;YACjC,CAAC,CAAC,CAAA;YACF,OAAO,GAAG,CAAA;SACX;aAAM;YACL,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;SAC/D;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,IAAI,CAAC,OAAgB;IACnC,OAAO,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAClC,CAAC;AAFD,oBAEC;AAED,SAAgB,KAAK,CAAC,OAAgB;IACpC,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AACjC,CAAC;AAFD,sBAEC"}
+{"version":3,"file":"joinSplit.js","sourceRoot":"","sources":["../../src/functions/joinSplit.ts"],"names":[],"mappings":";;;AAEA,oDAAwC;AACxC,oDAAwC;AAOxC,SAAS,SAAS,CAChB,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,GAAG,GAAG,EAAW,EACjC,KAAc;IAEd,MAAM,OAAO,GAAI,EAAe,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC7C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;QACxB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAA;KACtC;IAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAM,CAAC,CAAA;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAM,CAAC,CAAA;IAElC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;QACvB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE;YACtB,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAC9D,OAAO,MAAM,CAAC,MAAM,CAClB,CAAC,GAAY,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,EACzD,SAAS,CACV,CAAA;SACF;aAAM;YACL,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;YAC3C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;SAC/D;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAgB,IAAI,CAAC,OAAgB;IACnC,OAAO,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAClC,CAAC;AAFD,oBAEC;AAED,SAAgB,KAAK,CAAC,OAAgB;IACpC,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;AACjC,CAAC;AAFD,sBAEC"}