@nu-art/ts-common 0.201.23 → 0.201.25

package/db/types.d.ts

@@ -30,6 +30,7 @@ export type DBDef<T extends DB_Object, Ks extends keyof T = Default_UniqueKey> =
     entityName: string;
     lockKeys?: (keyof T)[];
     uniqueKeys?: Ks[];
+    upgradeChunksSize?: number;
     /**
      * First item in the array is the latest version. Last item in the array is the oldest version.
      */

package/modules/CSVModule.d.ts

@@ -16,11 +16,11 @@ export type ReadOptions<T extends Partial<StringMap> = {}> = {
     quote?: string;
     headers?: string[];
 };
-export type ReadPropsMap<K extends TS_Object = TS_Object> = {
-    [s: string]: keyof K;
+export type ReadPropsMap<T extends TS_Object = TS_Object> = {
+    [s: string]: keyof T;
 };
-export type WritePropsMap<K extends TS_Object = TS_Object> = {
-    [P in keyof K]: string;
+export type WritePropsMap<T extends TS_Object = TS_Object> = {
+    [P in keyof T]: string;
 };
 declare class CSVModule_Class extends Module<Config> {
     private csvExporter;
@@ -30,11 +30,11 @@ declare class CSVModule_Class extends Module<Config> {
     updateExporterSettings(options: Options): void;
     export<T>(items: T[], returnCsv?: boolean): any;
     saveToFile<T extends TS_Object>(outputFile: string, items: T[], columnsToProps?: WritePropsMap<T>): Promise<void>;
-    readCsvFromFile<T extends Partial<StringMap>>(inputFile: string, readOptions?: ReadOptions): Promise<T[]>;
-    readCsvFromBuffer<T extends Partial<StringMap>>(buffer: Buffer, readOptions?: ReadOptions): Promise<T[]>;
-    readCsvFromStream<T extends Partial<StringMap>>(stream: Readable, readOptions?: ReadOptions): Promise<T[]>;
-    forEachCsvRowFromStreamAsync<T extends Partial<StringMap>>(stream: Readable, callback: (instance: T) => Promise<void>, readOptions?: ReadOptions, queueCount?: number): Promise<void>;
-    forEachCsvRowFromStreamSync<T extends Partial<StringMap>>(stream: Readable, callback: (instance: T, index: number) => void, readOptions?: ReadOptions): Promise<void>;
+    readCsvFromFile<T extends TS_Object>(inputFile: string, readOptions?: ReadOptions<T>): Promise<T[]>;
+    readCsvFromBuffer<T extends TS_Object>(buffer: Buffer, readOptions?: ReadOptions<T>): Promise<T[]>;
+    readCsvFromStream<T extends TS_Object>(stream: Readable, readOptions?: ReadOptions<T>): Promise<T[]>;
+    forEachCsvRowFromStreamAsync<T extends TS_Object>(stream: Readable, callback: (instance: T) => Promise<void>, readOptions?: ReadOptions, queueCount?: number): Promise<void>;
+    forEachCsvRowFromStreamSync<T extends TS_Object>(stream: Readable, callback: (instance: T, index: number) => void, readOptions?: ReadOptions): Promise<void>;
     private createReadParserOptions;
 }
 export declare const CSVModule: CSVModule_Class;

package/modules/CSVModule.js

@@ -131,7 +131,7 @@ class CSVModule_Class extends module_1.Module {
         return {
             mapHeaders: (args) => {
                 var _a, _b;
-                return (_b = (_a = readOptions.columnsToProps) === null || _a === void 0 ? void 0 : _a[args.header]) !== null && _b !== void 0 ? _b : args.header;
+                return ((_b = (_a = readOptions.columnsToProps) === null || _a === void 0 ? void 0 : _a[args.header]) !== null && _b !== void 0 ? _b : args.header);
             },
             mapValues: (args) => {
                 var _a;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nu-art/ts-common",
-  "version": "0.201.23",
+  "version": "0.201.25",
   "description": "js and ts infra",
   "keywords": [
     "TacB0sS",

package/utils/array-tools.d.ts

@@ -75,6 +75,25 @@ export declare function sortArray<T>(array: T[], map?: keyof T | (keyof T)[] | (
  * "splits" array into given size of chunks and then does "action" on chunk and return to array of actions on chunks +-
  * */
 export declare function batchAction<T extends any = any, R extends any = any>(arr: T[], chunk: number, action: (elements: T[]) => Promise<R | R[]>): Promise<R[]>;
+/**
+ * Processes an array of promise-returning tasks sequentially.
+ *
+ * @typeParam T - The type of resolved value of the promises.
+ * @returns A promise that resolves to an array of resolved values.
+ *
+ * @example
+ * ```typescript
+ * let tasks = [
+ *     () => new Promise<number>(resolve => setTimeout(() => resolve(1), 1000)),
+ *     () => new Promise<number>(resolve => setTimeout(() => resolve(2), 500)),
+ *     () => new Promise<number>(resolve => setTimeout(() => resolve(3), 1500))
+ * ];
+ *
+ * Promise_all_sequentially(tasks).then(console.log);  // [1, 2, 3]
+ * ```
+ * @param promises
+ */
+export declare function Promise_all_sequentially<T>(promises: Array<() => Promise<T>>): Promise<T[]>;
 export declare function batchActionParallel<T extends any = any, R extends any = any>(arr: T[], chunk: number, action: (elements: T[]) => Promise<R | R[]>): Promise<R[]>;
 /**
  * Returns a flat array from an array of arrays.

package/utils/array-tools.js

@@ -26,7 +26,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.arrayIncludesAny = exports.firstElement = exports.lastElement = exports.asOptionalArray = exports.asArray = exports.generateArray = exports.toggleInArray = exports.groupArrayBy = exports.flatArray = exports.batchActionParallel = exports.batchAction = exports.sortArray = exports.reduceToMap = exports.arrayToMap = exports.filterFalsy = exports.filterInstances = exports.filterDuplicates = exports.findDuplicates = exports.filterAsync = exports.toggleElementInArray = exports.addItemToArrayAtIndex = exports.addItemToArray = exports.removeFromArrayByIndex = exports.removeFromArray = exports.removeItemFromArray = exports.filterInOut = void 0;
+exports.arrayIncludesAny = exports.firstElement = exports.lastElement = exports.asOptionalArray = exports.asArray = exports.generateArray = exports.toggleInArray = exports.groupArrayBy = exports.flatArray = exports.batchActionParallel = exports.Promise_all_sequentially = exports.batchAction = exports.sortArray = exports.reduceToMap = exports.arrayToMap = exports.filterFalsy = exports.filterInstances = exports.filterDuplicates = exports.findDuplicates = exports.filterAsync = exports.toggleElementInArray = exports.addItemToArrayAtIndex = exports.addItemToArray = exports.removeFromArrayByIndex = exports.removeFromArray = exports.removeItemFromArray = exports.filterInOut = void 0;
 const tools_1 = require("./tools");
 const object_tools_1 = require("./object-tools");
 function filterInOut(input, filter) {
@@ -188,6 +188,34 @@ function batchAction(arr, chunk, action) {
     });
 }
 exports.batchAction = batchAction;
+/**
+ * Processes an array of promise-returning tasks sequentially.
+ *
+ * @typeParam T - The type of resolved value of the promises.
+ * @returns A promise that resolves to an array of resolved values.
+ *
+ * @example
+ * ```typescript
+ * let tasks = [
+ *     () => new Promise<number>(resolve => setTimeout(() => resolve(1), 1000)),
+ *     () => new Promise<number>(resolve => setTimeout(() => resolve(2), 500)),
+ *     () => new Promise<number>(resolve => setTimeout(() => resolve(3), 1500))
+ * ];
+ *
+ * Promise_all_sequentially(tasks).then(console.log);  // [1, 2, 3]
+ * ```
+ * @param promises
+ */
+function Promise_all_sequentially(promises) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const results = [];
+        for (const promise of promises) {
+            results.push(yield promise());
+        }
+        return results;
+    });
+}
+exports.Promise_all_sequentially = Promise_all_sequentially;
 function batchActionParallel(arr, chunk, action) {
     return __awaiter(this, void 0, void 0, function* () {
         const promises = [];