typeshi 2.0.0 → 2.0.2

package/dist/utils/io/reading.js

@@ -720,9 +720,9 @@ function parseExcelForOneToMany(filePath, sheetName, keyColumn, valueColumn, opt
 function parseCsvForOneToMany(filePath, keyColumn, valueColumn, delimiter = types_1.DelimiterCharacterEnum.COMMA, options = {}) {
     filePath = coerceFileExtension(filePath, (delimiter === types_1.DelimiterCharacterEnum.TAB) ? 'tsv' : 'csv');
     const source = `[reading.parseCsvForOneToMany()]`;
-    validate.existingFileArgument(source, ['.tsv', '.csv'], { filePath });
-    validate.multipleStringArguments(source, { keyColumn, valueColumn });
     try {
+        validate.existingFileArgument(source, ['.tsv', '.csv'], { filePath });
+        validate.multipleStringArguments(source, { keyColumn, valueColumn });
         const { keyStripOptions, valueStripOptions, keyCaseOptions, valueCaseOptions, keyPadOptions, valuePadOptions } = options;
         const data = fs_1.default.readFileSync(filePath, 'utf8');
         const lines = data.split('\n');

package/dist/utils/io/types/Io.TypeGuards.js

@@ -71,7 +71,7 @@ function isFileData(value) {
 function isDirectoryFileOptions(value) {
     const candidate = value;
     return ((0, typeValidation_1.isObject)(candidate, false)
-        && typeValidation_1.isOptional.stringArray(candidate.targetExtensions)
+        && typeValidation_1.isOptional.stringArray(candidate.targetExtensions, false)
         && typeValidation_1.isOptional.boolean(candidate.basenameOnly)
         && typeValidation_1.isOptional.boolean(candidate.recursive));
 }

package/dist/utils/io/writing.js

@@ -151,7 +151,7 @@ function writeListsToCsvSync(listData, outputPath, delimiter = types_1.Delimiter
 function writeArrayToFileSync(arr, outputPath, separator = '\n', options = { encoding: 'utf-8', flag: 'w' }) {
     const source = (0, logging_1.getSourceString)(__filename, writeArrayToFileSync.name);
     try {
-        const content = arr.map(el => JSON.stringify(el)).join(separator);
+        const content = arr.map(el => typeof el === 'string' ? el : JSON.stringify(el)).join(separator);
         fs.writeFileSync(outputPath, content, options);
     }
     catch (error) {

package/dist/utils/typeValidation.d.ts

@@ -147,7 +147,7 @@ export declare function isPositveInteger(value: any): value is number;
 export declare const isType: <T>(value: any, guard: (v: any, ...args: any[]) => v is T, ...args: any[]) => value is T;
 /**
  * - calls {@link isUndefinedOrNull}`(value)` which allows for value to be `undefined` or `null`
- * - use {@link isUndefinedOr} if you want value is `T | undefined`
+ * - use {@link isUndefinedOr} if you want `value is T | undefined`
  */
 export declare class isOptional {
     static type: <T>(value: any, guard: (v: any, ...args: any[]) => v is T, ...args: any[]) => value is T | undefined | null;
@@ -168,7 +168,7 @@ export declare class isOptional {
     static string: (value: any, requireNonSpace?: boolean) => value is string | undefined | null;
     /**
      * @param value
-     * @param requireNonEmpty `boolean` `default` = `true` (if `true`, require that array have at least 1 element)
+     * @param requireNonEmpty `boolean` `default` = `false` (if `true`, require that array have at least 1 element)
      */
     static stringArray: (value: any, requireNonEmpty?: boolean) => value is string[] | undefined | null;
     /**
@@ -183,6 +183,11 @@ export declare class isOptional {
     static numeric: (value: any, requireInteger?: boolean, requireNonNegative?: boolean) => value is string | number | undefined | null;
     static number: (value: any, requireInteger?: boolean, requireNonNegative?: boolean) => value is number | undefined | null;
     static positiveInteger: (value: any) => value is number | undefined | null;
+    /**
+     * @param value
+     * @param requireNonNegative `boolean (optional)` `default` = `false`
+     * @param requireNonEmpty `boolean (optional)` `default` = `false`
+     */
     static integerArray: (value: any, requireNonNegative?: boolean, requireNonEmpty?: boolean) => value is number[] | undefined | null;
     static boolean: (value: any) => value is boolean | undefined | null;
     static function: (value: any) => value is Function | undefined | null;
@@ -205,7 +210,7 @@ export declare class isUndefinedOr {
     static string: (value: any, requireNonSpace?: boolean) => value is string | undefined;
     /**
      * @param value
-     * @param requireNonEmpty `boolean` `default` = `true`
+     * @param requireNonEmpty `boolean` `default` = `false`
      * - `if` `true`, require that array have at least 1 element
      */
     static stringArray: (value: any, requireNonEmpty?: boolean) => value is string[] | undefined;
@@ -221,6 +226,11 @@ export declare class isUndefinedOr {
     static numeric: (value: any, requireInteger?: boolean, requireNonNegative?: boolean) => value is string | number | undefined;
     static number: (value: any, requireInteger?: boolean, requireNonNegative?: boolean) => value is number | undefined;
     static positiveInteger: (value: any) => value is number | undefined;
+    /**
+     * @param value
+     * @param requireNonNegative `boolean (optional)` `default` = `false`
+     * @param requireNonEmpty `boolean (optional)` `default` = `false`
+     */
     static integerArray: (value: any, requireNonNegative?: boolean, requireNonEmpty?: boolean) => value is number[] | undefined;
     static boolean: (value: any) => value is boolean | undefined;
     static function: (value: any) => value is Function | undefined;

package/dist/utils/typeValidation.js

@@ -305,7 +305,7 @@ const isType = (value, guard, ...args) => {
 exports.isType = isType;
 /**
  * - calls {@link isUndefinedOrNull}`(value)` which allows for value to be `undefined` or `null`
- * - use {@link isUndefinedOr} if you want value is `T | undefined`
+ * - use {@link isUndefinedOr} if you want `value is T | undefined`
  */
 class isOptional {
 }
@@ -335,9 +335,9 @@ isOptional.string = (value, requireNonSpace = false) => {
 };
 /**
  * @param value
- * @param requireNonEmpty `boolean` `default` = `true` (if `true`, require that array have at least 1 element)
+ * @param requireNonEmpty `boolean` `default` = `false` (if `true`, require that array have at least 1 element)
  */
-isOptional.stringArray = (value, requireNonEmpty = true) => {
+isOptional.stringArray = (value, requireNonEmpty = false) => {
     return isUndefinedOrNull(value) || isStringArray(value, requireNonEmpty);
 };
 /**
@@ -359,7 +359,12 @@ isOptional.number = (value, requireInteger = false, requireNonNegative = false)
 isOptional.positiveInteger = (value) => {
     return (isUndefinedOrNull(value) || isPositveInteger(value));
 };
-isOptional.integerArray = (value, requireNonNegative = false, requireNonEmpty = true) => {
+/**
+ * @param value
+ * @param requireNonNegative `boolean (optional)` `default` = `false`
+ * @param requireNonEmpty `boolean (optional)` `default` = `false`
+ */
+isOptional.integerArray = (value, requireNonNegative = false, requireNonEmpty = false) => {
     return isUndefinedOrNull(value) || isIntegerArray(value, requireNonNegative, requireNonEmpty);
 };
 isOptional.boolean = (value) => {
@@ -395,10 +400,10 @@ isUndefinedOr.string = (value, requireNonSpace = false) => {
 };
 /**
  * @param value
- * @param requireNonEmpty `boolean` `default` = `true`
+ * @param requireNonEmpty `boolean` `default` = `false`
  * - `if` `true`, require that array have at least 1 element
  */
-isUndefinedOr.stringArray = (value, requireNonEmpty = true) => {
+isUndefinedOr.stringArray = (value, requireNonEmpty = false) => {
     return isUndefined(value) || isStringArray(value, requireNonEmpty);
 };
 /**
@@ -420,7 +425,12 @@ isUndefinedOr.number = (value, requireInteger = false, requireNonNegative = fals
 isUndefinedOr.positiveInteger = (value) => {
     return (isUndefined(value) || isPositveInteger(value));
 };
-isUndefinedOr.integerArray = (value, requireNonNegative = false, requireNonEmpty = true) => {
+/**
+ * @param value
+ * @param requireNonNegative `boolean (optional)` `default` = `false`
+ * @param requireNonEmpty `boolean (optional)` `default` = `false`
+ */
+isUndefinedOr.integerArray = (value, requireNonNegative = false, requireNonEmpty = false) => {
     return isUndefined(value) || isIntegerArray(value, requireNonNegative, requireNonEmpty);
 };
 isUndefinedOr.boolean = (value) => {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "typeshi",
-    "version": "2.0.0",
+    "version": "2.0.2",
     "description": "TypeScript utility modules",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -24,20 +24,21 @@
     "author": "Andrew Garwood",
     "license": "MIT",
     "dependencies": {
-        "rimraf": "^5.0.0",
-        "ts-jest": "^29.3.4",
-        "ts-node": "^10.9.2",
-        "tslog": "^4.9.3",
-        "lodash": "^4.17.21",
         "addresser": "^1.1.20",
         "csv-parser": "^3.2.0",
         "fastest-levenshtein": "^1.0.16",
+        "lodash": "^4.17.21",
+        "rimraf": "^5.0.0",
+        "ts-node": "^10.9.2",
+        "tslog": "^4.9.3",
         "xlsx": "https://cdn.sheetjs.com/xlsx-latest/xlsx-latest.tgz"
     },
     "devDependencies": {
+        "@jest/globals": "^30.2.0",
         "@types/jest": "^29.5.14",
         "@types/node": "^22.15.15",
         "jest": "^29.7.0",
+        "ts-jest": "^29.4.6",
         "tsconfig-paths": "^4.2.0",
         "typescript": "^5.0.0"
     },