map-transform 0.4.0-alpha.1 → 0.4.0-alpha.10

package/README.md

@@ -85,8 +85,8 @@ const def2 = [
   {
     title: 'name',
     author: 'meta.author',
-    date: 'meta.date'
-  }
+    date: 'meta.date',
+  },
 ]
 
 const target2 = mapTransform(def2)(source)
@@ -105,15 +105,15 @@ const { mapTransform, transform } = require('map-transform')
 // ....
 
 // Write a transform function, that accepts a value and returns a value
-const msToDate = ms => new Date(ms).toISOString()
+const msToDate = (ms) => new Date(ms).toISOString()
 
 const def3 = [
   'data[0].content',
   {
     title: 'name',
     author: 'meta.author',
-    date: ['meta.date', transform(msToDate)]
-  }
+    date: ['meta.date', transform(msToDate)],
+  },
 ]
 
 const target3 = mapTransform(def3)(source)
@@ -167,15 +167,15 @@ taste.
 
 ```javascript
 const def1 = {
-  'data.entry.title': 'heading'
+  'data.entry.title': 'heading',
 }
 
 const def2 = {
   data: {
     entry: {
-      title: 'heading'
-    }
-  }
+      title: 'heading',
+    },
+  },
 }
 
 // def1 and def2 are identical, and will result in an object like this:
@@ -188,12 +188,15 @@ 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 = {
-  title: 'heading'
+  $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
@@ -252,7 +251,7 @@ is at this path on the source object.
 
 ```javascript
 const def4 = {
-  title: 'data.item.heading'
+  title: 'data.item.heading',
 }
 
 const source1 = {
@@ -260,9 +259,9 @@ const source1 = {
     item: {
       id: 'item1',
       heading: 'The actual heading',
-      intro: 'The actual intro'
-    }
-  }
+      intro: 'The actual intro',
+    },
+  },
 }
 
 // `mapTransform(def4)(source1)` will transform to:
@@ -286,7 +285,7 @@ an array by indicating the array index in the brackets.
 
 ```javascript
 const def5 = {
-  title: 'data.items[0].heading'
+  title: 'data.items[0].heading',
 }
 
 // def5 will pull the heading from the first item in the `items` array, and will
@@ -326,6 +325,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
@@ -361,9 +371,9 @@ const def6 = [
     $iterate: true,
     id: 'articleNo',
     title: ['headline', transform(maxLength(20))],
-    sections: 'meta.sections[].id'
+    sections: 'meta.sections[].id',
   },
-  filter(onlyItemsWithSection)
+  filter(onlyItemsWithSection),
 ]
 ```
 
@@ -404,16 +414,16 @@ on an object. You would probably just not get the end result you expected.
 ```javascript
 import { mapTransform, transform } from 'map-transform'
 
-const ensureInteger = data => Number.parseInt(data, 10) || 0
+const ensureInteger = (data) => Number.parseInt(data, 10) || 0
 const def7 = {
-  count: ['statistics.views', transform(ensureInteger)]
+  count: ['statistics.views', transform(ensureInteger)],
 }
 
 const data = {
   statistics: {
-    view: '18'
+    view: '18',
     // ...
-  }
+  },
 }
 
 mapTransform(def7)(data)
@@ -449,7 +459,7 @@ Example transformation pipeline with a `yearsSince` function:
 
 ```javascript
 const def8 = {
-  age: ['birthyear', yearsSince(new Date())]
+  age: ['birthyear', yearsSince(new Date())],
 }
 ```
 
@@ -462,17 +472,17 @@ You may also define a transform operation as an object:
 ```javascript
 import { mapTransform } from 'map-transform'
 
-const ensureInteger = operands => data => Number.parseInt(data, 10) || 0
+const ensureInteger = (operands) => (data) => Number.parseInt(data, 10) || 0
 const functions = { ensureInteger }
 const def7asObject = {
-  count: ['statistics.views', { $transform: 'ensureInteger' }]
+  count: ['statistics.views', { $transform: 'ensureInteger' }],
 }
 
 const data = {
   statistics: {
-    view: '18'
+    view: '18',
     // ...
-  }
+  },
 }
 
 mapTransform(def7asObject, { functions })(data)
@@ -615,26 +625,26 @@ the pipeline definition in the first place.
 ```javascript
 import { mapTransform, apply, transform } from 'map-transform'
 
-const ensureInteger = data => Number.parseInt(data, 10) || 0
+const ensureInteger = (data) => Number.parseInt(data, 10) || 0
 const pipelines = {
   castEntry: {
     title: ['title', transform(String)],
-    count: ['count', transform(ensureInteger)]
-  }
+    count: ['count', transform(ensureInteger)],
+  },
 }
 const def25 = [
   {
     title: 'heading',
-    count: 'statistics.views'
+    count: 'statistics.views',
   },
-  apply('castEntry')
+  apply('castEntry'),
 ]
 
 const data = {
   heading: 'Entry 1',
   statistics: {
-    view: '18'
-  }
+    view: '18',
+  },
 }
 
 mapTransform(def7)(data)
@@ -650,9 +660,9 @@ You may also define the apply operation as an operation object:
 const def25 = [
   {
     title: 'heading',
-    count: 'statistics.views'
+    count: 'statistics.views',
   },
-  { $apply: 'castEntry' }
+  { $apply: 'castEntry' },
 ]
 ```
 
@@ -680,7 +690,7 @@ import { value, alt } from 'map-transform'
 const def10 = {
   id: 'data.customerNo',
   type: value('customer'),
-  name: ['data.name', alt(value('Anonymous'))]
+  name: ['data.name', alt(value('Anonymous'))],
 }
 ```
 
@@ -693,10 +703,12 @@ If you want to define the `value` operation as an operation object, use
 const def10asObject = {
   id: 'data.customerNo',
   type: { $transform: 'value', value: 'customer' },
-  name: ['data.name', { $alt: 'value', value: 'Anonymous' }]
+  name: ['data.name', { $alt: 'value', value: 'Anonymous' }],
 }
 ```
 
+There is also a shortcut for `{ $transform: 'value', value: 'customer' }`: `{ $value: 'customer' }`, which might be useful when typing definitions by hand.
+
 #### `fixed(data)` operation
 
 The data given to the fixed operation, will be inserted in the pipeline in place
@@ -720,8 +732,8 @@ every item in the array, please use the `iterate` operation.
 ```javascript
 import { alt, transform, functions } from 'map-transform'
 const { value } = functions
-const currentDate = data => new Date()
-const formatDate = data => {
+const currentDate = (data) => new Date()
+const formatDate = (data) => {
   /* implementation not included */
 }
 
@@ -732,8 +744,8 @@ const def11 = {
     'data.updateDate',
     alt('data.createDate'),
     alt(transform(currentDate)),
-    transform(formatDate)
-  ]
+    transform(formatDate),
+  ],
 }
 ```
 
@@ -755,8 +767,8 @@ const def11asObject = {
     'data.updateDate',
     { $alt: 'get', path: 'data.createDate' },
     { $alt: 'currentDate' },
-    { $transform: 'formatDate' }
-  ]
+    { $transform: 'formatDate' },
+  ],
 }
 ```
 
@@ -792,7 +804,7 @@ Example:
 import { modify } from 'map-transform'
 
 const def34 = modify({
-  data: 'data.deeply.placed.items'
+  data: 'data.deeply.placed.items',
 })
 ```
 
@@ -802,7 +814,7 @@ prop. Giving this an object like:
 ```javascript
 const response = {
   status: 'ok',
-  data: { deeply: { placed: { items: [{ id: 'ent1' }] } } }
+  data: { deeply: { placed: { items: [{ id: 'ent1' }] } } },
 }
 ```
 
@@ -811,7 +823,7 @@ const response = {
 ```javascript
 const response = {
   status: 'ok',
-  data: [{ id: 'ent1' }]
+  data: [{ id: 'ent1' }],
 }
 ```
 
@@ -830,11 +842,11 @@ pipeline when we're mapping in reverse.
 
 ```javascript
 import { fwd, rev, transform } from 'map-transform'
-const increment = data => data + 1
-const decrement = data => data - 1
+const increment = (data) => data + 1
+const decrement = (data) => data - 1
 
 const def12 = {
-  order: ['index', fwd(transform(increment)), rev(transform(decrement))]
+  order: ['index', fwd(transform(increment)), rev(transform(decrement))],
 }
 ```
 
@@ -887,7 +899,7 @@ This example results in the exact same pipeline as the example above:
 
 ```javascript
 const def14 = {
-  'content[]': 'data.items[].content'
+  'content[]': 'data.items[].content',
 }
 ```
 
@@ -916,13 +928,13 @@ const def15 = [
   {
     id: 'id',
     title: 'headline',
-    section: root('meta.section')
-  }
+    section: root('meta.section'),
+  },
 ]
 
 const data = {
   articles: [{ id: '1', headline: 'An article' } /* ... */],
-  meta: { section: 'news' }
+  meta: { section: 'news' },
 }
 
 mapTransform(def15)(data)
@@ -984,8 +996,8 @@ const data = {
   users: [
     { id: 'user1', name: 'User 1' },
     { id: 'user2', name: 'User 2' },
-    { id: 'user3', name: 'User 3' }
-  ]
+    { id: 'user3', name: 'User 3' },
+  ],
 }
 const mapper = mapTransform(def18)
 const mappedData = mapper(data)
@@ -1025,9 +1037,9 @@ const { compare } = functions
 const def19 = [
   {
     name: 'name',
-    role: 'editor'
+    role: 'editor',
   },
-  filter(compare({ path: 'role', operator: '=', match: 'admin' }))
+  filter(compare({ path: 'role', operator: '=', match: 'admin' })),
 ]
 ```
 
@@ -1037,9 +1049,9 @@ You may also define this with a transform object:
 const def19o = [
   {
     name: 'name',
-    role: 'editor'
+    role: 'editor',
   },
-  { $filter: 'compare', path: 'role', operator: '=', match: 'admin' }
+  { $filter: 'compare', path: 'role', operator: '=', match: 'admin' },
 ]
 ```
 
@@ -1065,7 +1077,7 @@ import { mapTransform, transform, functions } from 'map-transform'
 const { explode } = functions
 
 const data = {
-  currencies: { NOK: 1, USD: 0.125, EUR: 0.1 }
+  currencies: { NOK: 1, USD: 0.125, EUR: 0.1 },
 }
 
 const def32 = ['currencies', transform(explode())]
@@ -1081,6 +1093,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
@@ -1138,6 +1157,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
@@ -1154,11 +1207,11 @@ import { mapTransform, transform, functions } from 'map-transform'
 const { template } = functions
 
 const data = {
-  content: { description: 'Bergen by night', artist: 'John F.' }
+  content: { description: 'Bergen by night', artist: 'John F.' },
 }
 
 const def30 = {
-  caption: ['content', transform(template('{{description}}. By {{artist}}'))]
+  caption: ['content', transform(template('{{description}}. By {{artist}}'))],
 }
 
 const ret = mapTransform(def30)(data)
@@ -1171,8 +1224,8 @@ The `template` function is also available through a transform object:
 const def30o = {
   caption: [
     'content',
-    { $transform: 'template', template: '{{description}}. By {{artist}}' }
-  ]
+    { $transform: 'template', template: '{{description}}. By {{artist}}' },
+  ],
 }
 ```
 
@@ -1200,8 +1253,8 @@ const def20 = [
   'items',
   filter(validate('draft', { const: false })),
   {
-    title: 'heading'
-  }
+    title: 'heading',
+  },
 ]
 ```
 
@@ -1220,9 +1273,9 @@ const { compare } = functions
 const def21 = [
   {
     name: 'name',
-    role: 'role'
+    role: 'role',
   },
-  filter(not(compare('role', 'admin')))
+  filter(not(compare('role', 'admin'))),
 ]
 ```
 
@@ -1249,14 +1302,14 @@ const def22 = [
   'data.customers[]',
   {
     id: 'customerNo',
-    name: ['fullname', alt(value('Anonymous'))]
-  }
+    name: ['fullname', alt(value('Anonymous'))],
+  },
 ]
 
 const dataInTargetState = [
   { id: 'cust1', name: 'Fred Johnsen' },
   // { id: 'cust2', name: 'Lucy Knight' },
-  { id: 'cust3' }
+  { id: 'cust3' },
 ]
 
 const dataInSourceState = mapTransform(def22).rev(dataInTargetState)
@@ -1282,15 +1335,15 @@ For example:
 ```javascript
 import { mapTransform, transform } from 'map-transform'
 
-const username = name => name.replace(/\s+/, '.').toLowerCase()
+const username = (name) => name.replace(/\s+/, '.').toLowerCase()
 
 const def23 = [
   'data.customers[]',
   {
     id: 'customerNo',
     name: 'fullname',
-    'name/1': ['username', rev(transform(username))]
-  }
+    'name/1': ['username', rev(transform(username))],
+  },
 ]
 
 const dataInTargetState = [{ id: 'cust1', name: 'Fred Johnsen' }]
@@ -1329,11 +1382,11 @@ const def33flipped = {
   id: 'key',
   attributes: {
     title: ['headline', transform(threeLetters)],
-    age: ['unknown']
+    age: ['unknown'],
   },
   relationships: {
-    author: value('johnf')
-  }
+    author: value('johnf'),
+  },
 }
 ```
 
@@ -1380,7 +1433,7 @@ import { mapTransform, alt, value } from 'map-transform'
 
 const def24 = {
   id: 'customerNo',
-  name: ['fullname', alt(value('Anonymous'))]
+  name: ['fullname', alt(value('Anonymous'))],
 }
 
 const mapper = mapTransform(def24)

package/ava-dist.config.cjs

@@ -0,0 +1,3 @@
+module.exports = {
+  files: ['dist/**/*.test.js'],
+}

package/ava.config.cjs

@@ -0,0 +1,5 @@
+module.exports = {
+  extensions: ['ts'],
+  require: ['ts-node/register/transpile-only'],
+  files: ['src/**/*.test.ts']
+}

package/dist/functions/compare.js

@@ -27,8 +27,8 @@ function createComparer(operator) {
     }
 }
 function compare({ path = '.', operator = '=', match, matchPath, }) {
-    const getValue = pathGetter_1.default(path);
-    const getMatch = matchPath ? pathGetter_1.default(matchPath) : () => match;
+    const getValue = (0, pathGetter_1.default)(path);
+    const getMatch = matchPath ? (0, pathGetter_1.default)(matchPath) : () => match;
     const comparer = createComparer(operator);
     return (data) => {
         const value = getValue(data);

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,oBAAM,CAAC,IAAI,CAAC,CAAA;IAC7B,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,oBAAM,CAAC,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":";;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"}

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,9 +1,11 @@
 "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) => 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 (is_1.isObject(keyValue)) {
+    if ((0, is_1.isObject)(keyValue)) {
         const { key, value } = keyValue;
         if (Array.isArray(target)) {
             target[key] = value;
@@ -25,8 +27,10 @@ function doImplode(data) {
     }
 }
 function doExplode(data) {
-    if (is_1.isObject(data)) {
-        return Object.entries(data).map(([key, value]) => ({
+    if ((0, is_1.isObject)(data)) {
+        return Object.entries(data)
+            .filter(([, value]) => value !== undefined)
+            .map(([key, value]) => ({
             key,
             value,
         }));
@@ -41,5 +45,9 @@ function doExplode(data) {
 function explode() {
     return (data, context) => (context.rev ? doImplode(data) : doExplode(data));
 }
-exports.default = explode;
+exports.explode = explode;
+function implode() {
+    return (data, context) => (context.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,aAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAA;AAEtE,MAAM,aAAa,GAAG,CACpB,MAA2C,EAC3C,QAAiB,EACjB,EAAE;IACF,IAAI,aAAQ,CAAC,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,aAAQ,CAAC,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,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;AAED,SAAgB,OAAO;IACrB,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"}

package/dist/functions/get.js

@@ -4,7 +4,7 @@ const pathGetter_1 = require("../utils/pathGetter");
 const extractPath = (path) => typeof path === 'string' ? path : path.path;
 function get(options) {
     const path = extractPath(options) || '.';
-    const getFn = pathGetter_1.default(path);
+    const getFn = (0, pathGetter_1.default)(path);
     return (data) => getFn(data);
 }
 exports.default = get;

package/dist/functions/get.js.map

@@ -1 +1 @@
-{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/functions/get.ts"],"names":[],"mappings":";;AACA,oDAAwC;AAMxC,MAAM,WAAW,GAAG,CAAC,IAAsB,EAAE,EAAE,CAC7C,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;AAE7C,SAAwB,GAAG,CAAC,OAAyB;IACnD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,GAAG,CAAA;IACxC,MAAM,KAAK,GAAG,oBAAM,CAAC,IAAI,CAAC,CAAA;IAE1B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AALD,sBAKC"}
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../src/functions/get.ts"],"names":[],"mappings":";;AACA,oDAAwC;AAMxC,MAAM,WAAW,GAAG,CAAC,IAAsB,EAAE,EAAE,CAC7C,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;AAE7C,SAAwB,GAAG,CAAC,OAAyB;IACnD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,GAAG,CAAA;IACxC,MAAM,KAAK,GAAG,IAAA,oBAAM,EAAC,IAAI,CAAC,CAAA;IAE1B,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;AAC9B,CAAC;AALD,sBAKC"}