map-transform 1.2.0 → 1.3.0

package/README.md

@@ -1452,7 +1452,7 @@ and not the order of the items in the original array. When a path is given, the
 array will be set on this path.
 
 ```javascript
-const def40 = bucket({
+const def40 = transform(bucket({
   path: 'users[]',
   buckets: [
     {
@@ -1467,7 +1467,7 @@ const def40 = bucket({
       key: 'users',
     },
   ],
-})
+}))
 
 const data = {
   users: [
@@ -1500,9 +1500,9 @@ const mappedData = await mapper(data)
 Or by size:
 
 ```javascript
-const def41 = bucket({
+const def41 = transform(bucket({
   buckets: [{ key: 'top3', size: 3 }, { key: 'theOthers' }],
-})
+}))
 
 const data = ['user1', 'user2', 'user3', 'user4', 'user5', 'user6', 'user7']
 
@@ -1848,6 +1848,46 @@ const def21b = [
 ]
 ```
 
+#### `project({include, exclude})` transformer
+
+Will return an object with only the props specified in `include` or none of the
+props in `exclude`. Both `include` and `exclude` may be array of strings, and
+they should not be used in combination. If both are provided, `include` will be
+used.
+
+When given an array of object, each object will be projected. When given
+anything that is not an object, undefined will be returned.
+
+As we cannot bring back the removed props when mapping in reverse, this
+transformer will pass on the object data as is in reverse.
+
+```javascript
+import { transform, transformers } from 'map-transform'
+const { project } = transformers
+
+const def42 = transform(project({ include: ['id', 'name'] }))
+
+const data = {
+  id: 'ent1',
+  name: 'Entry 1',
+  text: 'Do not include',
+  created: new Date('2023-12-01T00:00:00Z'),
+}
+
+const mapper = mapTransform(def42)
+const mappedData = await mapper(data)
+// --> {
+//   id: 'ent1',
+//   name: 'Entry 1',
+// }
+```
+
+You may also define this as an operation object:
+
+```javascript
+const def42b = { $transform: 'project', include: ['id', 'name'] }
+```
+
 #### `sort({asc, path})` transformer
 
 The `sort` transformer will sort the array at the given `path`, in the direction

package/dist/transformers/index.d.ts

@@ -12,6 +12,7 @@ declare const _default: {
     merge: import("../types.js").AsyncTransformer<import("./merge.js").Props>;
     mergeRev: import("../types.js").AsyncTransformer<import("./merge.js").Props>;
     not: import("../types.js").AsyncTransformer<import("../types.js").AsyncDataMapperWithOptions | import("../types.js").DataMapperWithOptions | import("./not.js").Props>;
+    project: import("../types.js").Transformer<import("./project.js").Props>;
     sort: import("../types.js").Transformer<import("./sort.js").Props>;
     value: import("../types.js").Transformer<unknown>;
 };

package/dist/transformers/index.js

@@ -9,6 +9,7 @@ import logical from './logical.js';
 import map from './map.js';
 import { merge, mergeRev } from './merge.js';
 import not from './not.js';
+import project from './project.js';
 import sort from './sort.js';
 export default {
     bucket,
@@ -24,6 +25,7 @@ export default {
     merge,
     mergeRev,
     not,
+    project,
     sort,
     value,
 };

package/dist/transformers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,KAAK,MAAM,cAAc,CAAA;AAChC,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,eAAe;IACb,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,GAAG;IACH,OAAO;IACP,KAAK;IACL,OAAO;IACP,GAAG;IACH,KAAK;IACL,QAAQ;IACR,GAAG;IACH,IAAI;IACJ,KAAK;CACN,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transformers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,MAAM,MAAM,aAAa,CAAA;AAChC,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,KAAK,MAAM,cAAc,CAAA;AAChC,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC5C,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,OAAO,MAAM,cAAc,CAAA;AAClC,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,eAAe;IACb,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,OAAO;IACP,GAAG;IACH,OAAO;IACP,KAAK;IACL,OAAO;IACP,GAAG;IACH,KAAK;IACL,QAAQ;IACR,GAAG;IACH,OAAO;IACP,IAAI;IACJ,KAAK;CACN,CAAA"}

package/dist/transformers/project.d.ts

@@ -0,0 +1,7 @@
+import type { Transformer, TransformerProps } from '../types.js';
+export interface Props extends TransformerProps {
+    include?: string[];
+    exclude?: string[];
+}
+declare const transformer: Transformer<Props>;
+export default transformer;

package/dist/transformers/project.js

@@ -0,0 +1,19 @@
+import mapAny from 'map-any';
+import { isObject, isString, isNonEmptyArray } from '../utils/is.js';
+const projectProps = (rawProps, doInclude) => {
+    const props = rawProps.filter(isString);
+    const filterFn = doInclude
+        ? ([key]) => props.includes(key)
+        : ([key]) => !props.includes(key);
+    return (obj) => Object.fromEntries(Object.entries(obj).filter(filterFn));
+};
+const transformer = function bucket({ include, exclude }) {
+    const projectFn = isNonEmptyArray(include)
+        ? projectProps(include, true)
+        : isNonEmptyArray(exclude)
+            ? projectProps(exclude, false)
+            : (obj) => obj;
+    return () => (data, state) => mapAny((data) => isObject(data) ? (state.rev ? data : projectFn(data)) : undefined, data);
+};
+export default transformer;
+//# sourceMappingURL=project.js.map

package/dist/transformers/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/transformers/project.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAQpE,MAAM,YAAY,GAAG,CAAC,QAAkB,EAAE,SAAkB,EAAE,EAAE;IAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAG,SAAS;QACxB,CAAC,CAAC,CAAC,CAAC,GAAG,CAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACnD,CAAC,CAAC,CAAC,CAAC,GAAG,CAAoB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IACtD,OAAO,CAAC,GAA4B,EAAE,EAAE,CACtC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;AAC5D,CAAC,CAAA;AAED,MAAM,WAAW,GAAuB,SAAS,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE;IAE1E,MAAM,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC;QACxC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC;QAC7B,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC;YACxB,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC;YAC9B,CAAC,CAAC,CAAC,GAA4B,EAAE,EAAE,CAAC,GAAG,CAAA;IAI3C,OAAO,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC3B,MAAM,CACJ,CAAC,IAAI,EAAE,EAAE,CACP,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EACnE,IAAI,CACL,CAAA;AACL,CAAC,CAAA;AAED,eAAe,WAAW,CAAA"}

package/dist/utils/is.d.ts

@@ -1,5 +1,7 @@
 export declare const isObject: (value: unknown) => value is Record<string, unknown>;
+export declare const isString: (value: unknown) => value is string;
 export declare const isPath: (value: unknown) => value is string;
 export declare const isArrayPath: (value: unknown) => value is string;
 export declare const isNullOrUndefined: (value: unknown) => value is null | undefined;
 export declare const isNotNullOrUndefined: <T>(value: T) => value is NonNullable<T>;
+export declare const isNonEmptyArray: <T>(value: unknown) => value is T[];

package/dist/utils/is.js

@@ -1,6 +1,8 @@
 export const isObject = (value) => Object.prototype.toString.call(value) === '[object Object]';
+export const isString = (value) => typeof value === 'string';
 export const isPath = (value) => typeof value === 'string';
 export const isArrayPath = (value) => isPath(value) && value.endsWith('[]');
 export const isNullOrUndefined = (value) => value === null || value === undefined;
 export const isNotNullOrUndefined = (value) => !isNullOrUndefined(value);
+export const isNonEmptyArray = (value) => Array.isArray(value) && value.length > 0;
 //# sourceMappingURL=is.js.map

package/dist/utils/is.js.map

@@ -1 +1 @@
-{"version":3,"file":"is.js","sourceRoot":"","sources":["../../src/utils/is.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC3E,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAAA;AAE7D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CACtD,OAAO,KAAK,KAAK,QAAQ,CAAA;AAE3B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAiB,EAAE,CAC3D,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC7E,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAA;AAEvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAI,KAAQ,EAA2B,EAAE,CAC3E,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAA"}
+{"version":3,"file":"is.js","sourceRoot":"","sources":["../../src/utils/is.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CAC3E,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,iBAAiB,CAAA;AAE7D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC1D,OAAO,KAAK,KAAK,QAAQ,CAAA;AAE3B,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAc,EAAiB,EAAE,CACtD,OAAO,KAAK,KAAK,QAAQ,CAAA;AAE3B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAiB,EAAE,CAC3D,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;AAEvC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA6B,EAAE,CAC7E,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAA;AAEvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAI,KAAQ,EAA2B,EAAE,CAC3E,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAA;AAE3B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAI,KAAc,EAAgB,EAAE,CACjE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "map-transform",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Map and transform objects with mapping definitions",
   "author": "Kjell-Morten Bratsberg Thorsen <kjellmorten@integreat.io>",
   "license": "ISC",