@strapi/utils 4.6.0-beta.2 → 4.6.1

package/lib/async.d.ts

@@ -0,0 +1,12 @@
+export type MapAsync<T = any, R = any> = lodash.CurriedFunction3<
+  T[],
+  (element: T, index: number) => R | Promise<R>,
+  { concurrency?: number },
+  Promise<R[]>
+>;
+
+export type ForEachAsync<T = any, R = any> = (
+  array: T[],
+  func: (element: T, index: number) => R | Promise<R>,
+  options?: { concurrency?: number }
+) => Promise<R[]>;

package/lib/async.js

@@ -0,0 +1,34 @@
+'use strict';
+
+const pMap = require('p-map');
+const { curry } = require('lodash/fp');
+
+function pipeAsync(...methods) {
+  return async (data) => {
+    let res = data;
+
+    for (const method of methods) {
+      res = await method(res);
+    }
+
+    return res;
+  };
+}
+
+/**
+ * @type { import('./async').MapAsync }
+ */
+const mapAsync = curry(pMap);
+
+/**
+ * @type { import('./async').ForEachAsync }
+ */
+const forEachAsync = curry(async (array, func, options) => {
+  await mapAsync(array, func, options);
+});
+
+module.exports = {
+  mapAsync,
+  forEachAsync,
+  pipeAsync,
+};

package/lib/file.js

@@ -0,0 +1,60 @@
+'use strict';
+
+/**
+ * Utils file containing file treatment utils
+ */
+const { Writable } = require('stream');
+
+const kbytesToBytes = (kbytes) => kbytes * 1000;
+const bytesToKbytes = (bytes) => Math.round((bytes / 1000) * 100) / 100;
+const bytesToHumanReadable = (bytes) => {
+  const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB'];
+  if (bytes === 0) return '0 Bytes';
+  const i = parseInt(Math.floor(Math.log(bytes) / Math.log(1000)), 10);
+  return `${Math.round(bytes / 1000 ** i, 2)} ${sizes[i]}`;
+};
+
+const streamToBuffer = (stream) =>
+  new Promise((resolve, reject) => {
+    const chunks = [];
+    stream.on('data', (chunk) => {
+      chunks.push(chunk);
+    });
+    stream.on('end', () => {
+      resolve(Buffer.concat(chunks));
+    });
+    stream.on('error', reject);
+  });
+
+const getStreamSize = (stream) =>
+  new Promise((resolve, reject) => {
+    let size = 0;
+    stream.on('data', (chunk) => {
+      size += Buffer.byteLength(chunk);
+    });
+    stream.on('close', () => resolve(size));
+    stream.on('error', reject);
+    stream.resume();
+  });
+
+/**
+ * Create a writeable Node.js stream that discards received data.
+ * Useful for testing, draining a stream of data, etc.
+ */
+function writableDiscardStream(options) {
+  return new Writable({
+    ...options,
+    write(chunk, encding, callback) {
+      setImmediate(callback);
+    },
+  });
+}
+
+module.exports = {
+  streamToBuffer,
+  bytesToHumanReadable,
+  bytesToKbytes,
+  kbytesToBytes,
+  getStreamSize,
+  writableDiscardStream,
+};

package/lib/index.js

@@ -37,10 +37,11 @@ const providerFactory = require('./provider-factory');
 const pagination = require('./pagination');
 const sanitize = require('./sanitize');
 const traverseEntity = require('./traverse-entity');
-const pipeAsync = require('./pipe-async');
+const { pipeAsync, mapAsync, forEachAsync } = require('./async');
 const convertQueryParams = require('./convert-query-params');
 const importDefault = require('./import-default');
 const template = require('./template');
+const file = require('./file');
 
 module.exports = {
   yup,
@@ -81,9 +82,12 @@ module.exports = {
   providerFactory,
   pagination,
   pipeAsync,
+  mapAsync,
+  forEachAsync,
   errors,
   validateYupSchema,
   validateYupSchemaSync,
   convertQueryParams,
   importDefault,
+  file,
 };

package/lib/sanitize/index.js

@@ -4,7 +4,7 @@ const { isArray } = require('lodash/fp');
 
 const traverseEntity = require('../traverse-entity');
 const { getNonWritableAttributes } = require('../content-types');
-const pipeAsync = require('../pipe-async');
+const { pipeAsync } = require('../async');
 
 const visitors = require('./visitors');
 const sanitizers = require('./sanitizers');

package/lib/sanitize/sanitizers.js

@@ -2,7 +2,7 @@
 
 const { curry } = require('lodash/fp');
 
-const pipeAsync = require('../pipe-async');
+const { pipeAsync } = require('../async');
 const traverseEntity = require('../traverse-entity');
 
 const { removePassword, removePrivate } = require('./visitors');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/utils",
-  "version": "4.6.0-beta.2",
+  "version": "4.6.1",
   "description": "Shared utilities for the Strapi packages",
   "keywords": [
     "strapi",
@@ -39,11 +39,12 @@
     "date-fns": "2.29.3",
     "http-errors": "1.8.1",
     "lodash": "4.17.21",
+    "p-map": "4.0.0",
     "yup": "0.32.9"
   },
   "engines": {
     "node": ">=14.19.1 <=18.x.x",
     "npm": ">=6.0.0"
   },
-  "gitHead": "b852090f931cd21868c4016f24db2f9fdfc7a7ab"
+  "gitHead": "17a7845e3d453ea2e7911bda6ec25ed196dd5f16"
 }

package/lib/pipe-async.js

@@ -1,13 +0,0 @@
-'use strict';
-
-module.exports =
-  (...methods) =>
-  async (data) => {
-    let res = data;
-
-    for (const method of methods) {
-      res = await method(res);
-    }
-
-    return res;
-  };