ac-sanitizer 5.0.0 → 5.1.0

package/CHANGELOG.md

@@ -1,4 +1,32 @@
  
+# [5.1.0](https://github.com/mmpro/ac-sanitizer/compare/v5.0.1..v5.1.0) (2025-09-10 10:32:21)
+
+
+### Feature
+
+* **App:** Add option to convert a string with splitSpaceSeparated | MP | [d5974ea9286ceaa9cd6a3273e713ccf002cc7e7c](https://github.com/mmpro/ac-sanitizer/commit/d5974ea9286ceaa9cd6a3273e713ccf002cc7e7c)    
+Converts an URL encoded, space separated string into an array (e.g. for OAuth scopes)  
+Related issues:
+### Chores
+
+* **App:** Updated packages | MP | [3f832431642e3ae5705eb45f1c823ba5f29d9d50](https://github.com/mmpro/ac-sanitizer/commit/3f832431642e3ae5705eb45f1c823ba5f29d9d50)    
+Updated packages  
+Related issues:
+
+## [5.0.1](https://github.com/mmpro/ac-sanitizer/compare/v5.0.0..v5.0.1) (2025-08-31 12:35:43)
+
+
+### Bug Fix
+
+* **App:** Add option unique for arrays | MP | [2484bd72c6ca31610361056eb05dd6b0b05bf3c3](https://github.com/mmpro/ac-sanitizer/commit/2484bd72c6ca31610361056eb05dd6b0b05bf3c3)    
+If unique is true, duplicates will be removed from array  
+Related issues:
+### Chores
+
+* **App:** Updated packages | MP | [f4689d9b3bdbde42098fef0827cad691dd5d651f](https://github.com/mmpro/ac-sanitizer/commit/f4689d9b3bdbde42098fef0827cad691dd5d651f)    
+Updated packages  
+Related issues:
+ 
 # [5.0.0](https://github.com/mmpro/ac-sanitizer/compare/v4.2.1..v5.0.0) (2025-05-21 15:57:54)
 
 

package/README.md

@@ -80,6 +80,7 @@ integer | 60.1 -> 60 | Convert incoming number to integer - this way you can mak
 string | Hello Developer -> Hello (with maxLength = 5) | Reduce string to max length
 base64 | SGVsbG8= -> Hello | Convert base64 encoded string to UTF-8 string
 iso-639 | { iso-639-2: 'tlh', translations: [] } -> tlh (with convert=iso-639-2) | Returns only the select property for the ISO-639 object
+splitSpaceSeparated | user_read%20user_write -> ['user_read', 'user_write'] | Converts an URL encoded, space separated string into an array (e.g. for OAuth scopes)
 
 
 ## Available types
@@ -87,6 +88,7 @@ iso-639 | { iso-639-2: 'tlh', translations: [] } -> tlh (with convert=iso-639-2)
 Type | Options | Remarks
 --- | --- | --- |
 any | | Any can be string, integer, boolean, object or array - it will be automatically detected.
+array | unique | If unique=true, duplicate entries will be removed from array
 base64 | | Checks if a string is base64 encoded, optional with field option "convert" (to string)
 boolean | | 
 cidr | | Check CIDR, see example
@@ -110,7 +112,7 @@ number | | Should no be used - use integer, long, short, floag
 ratio | | x:y
 rgb | | Check for valid RGB value (r,g,b) or (r%,g%, b%)
 short | | 0 - 2^15
-string | minLength (int), maxLength (int), ignoreCase | With ignoreCase=true enum checks are case insensitive (e.g. abc in ['ABC'] is valid) 
+string | minLength (int), maxLength (int), ignoreCase, splitSpaceSeparated | With ignoreCase=true enum checks are case insensitive (e.g. abc in ['ABC'] is valid) 
 url| protocols, require_tld, require_protocol | Default values: protocols ['http', 'https'], required_tld true, require_protocol true
 
 # Examples

package/index.js

@@ -254,6 +254,15 @@ const sanitizer = function() {
           }
           else error = { message: fieldName + '_stringTooLong_maxLength' + field.maxLength }
         }
+        if (_.get(field, 'convert') === 'splitSpaceSeparated') {
+          try {
+            const decoded = decodeURIComponent(value)
+            _.set(paramsToCheck, fieldName, decoded.split(' ').filter(Boolean))
+          }
+          catch(e) {
+            error = { message: fieldName + '_couldNotDecodeURI' }
+          }
+        }
       }
       else if (field.type === 'boolean') {
         // GET params are strings -> try to make the boolean
@@ -300,6 +309,8 @@ const sanitizer = function() {
         if (!error && _.isFunction(_.get(schema, 'verify'))) {
           error = schema.verify(value)
         }
+
+        if (field.unique) _.set(paramsToCheck, fieldName, _.uniqWith(value, _.isEqual))
       }
       else if (field.type === 'object') {
         if (!_.isPlainObject(value)) error = { message: fieldName + '_' + getTypeMapping(field.type, 'errorMessage') }

package/package.json

@@ -4,23 +4,23 @@
   "author": "Mark Poepping (https://www.admiralcloud.com)",
   "license": "MIT",
   "repository": "admiralcloud/ac-sanitizer",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "homepage": "https://www.admiralcloud.com",
   "dependencies": {
-    "ac-countrylist": "^1.0.13",
-    "ac-file-extensions": "^2.0.10",
-    "ac-ip": "^4.1.3",
+    "ac-countrylist": "^1.0.14",
+    "ac-file-extensions": "^2.0.11",
+    "ac-ip": "^4.1.4",
     "chai": "^4.5.0",
     "date-and-time": "^3.6.0",
     "hashids": "^2.3.0",
     "lodash": "^4.17.21",
-    "validator": "^13.15.0"
+    "validator": "^13.15.15"
   },
   "devDependencies": {
-    "ac-semantic-release": "^0.4.6",
+    "ac-semantic-release": "^0.4.7",
     "c8": "^10.1.3",
-    "eslint": "^9.27.0",
-    "mocha": "^11.3.0"
+    "eslint": "^9.35.0",
+    "mocha": "^11.7.2"
   },
   "scripts": {
     "test": "mocha --reporter spec --bail",

package/test/tests/array.js

@@ -41,6 +41,8 @@ module.exports = {
       { name: 'Array of strings with enum - uppercase vs lowercase - with ignoreCase', type: 'array', valueType: 'string', ignoreCase: true, value: ['ABC', 'DEF'], enum: ['abc'], error: 'array_atLeastOneValueFailed' },
       { name: 'Array of urls with https', type: 'array', valueType: 'url', value: ['https://www.admiralcloud.com'], expected: ['https://www.admiralcloud.com'] },
       { name: 'Array of urls with http and https - only https is allowed', type: 'array', valueType: 'url', protocols: ['https'], value: ['http://www.admiralcloud.com'], error: 'array_atLeastOneValueFailed' },
+      { name: 'Array with unique values', type: 'array', value: ['a', 'b', 'a'], unique: true, expected: ['a', 'b'] },
+      { name: 'Array with unique objects', type: 'array', value: [{ a: 1, x: true }, { a: 2, x: true }, { a: 2, x: false }, { a: 1, x: true }], unique: true, expected: [{ a: 1, x: true }, { a: 2, x: true }, { a: 2, x: false }] },
   ]
 
     runValidationTests(baseTests, 'array', { equalityCheck: 'eql' })

package/test/tests/string.js

@@ -20,6 +20,7 @@ module.exports = {
       { name: 'Valid - uppercase vs lowercase', type: 'string', ignoreCase: true, value: 'ABC', enum: ['abc'], expected: 'ABC' },
       { name: 'Invalid - value too short', type: 'string', minLength: 5, value: 'ABC', error: 'string_stringTooShort_minLength5' },
       { name: 'Valid - value is longer than 5 chars', type: 'string', minLength: 5, value: 'ABCDEF', expected: 'ABCDEF' },
+      { name: 'Valid - value is a URL encoded, space separated string', type: 'string', convert: 'splitSpaceSeparated', value: 'one%20two%20three', expected: ['one', 'two', 'three'] }
     ]
 
     runValidationTests(baseTests, 'string', { equalityCheck: 'eql' })