compare-versions - npm Package Compare versions

Comparing version 6.0.0 to 6.1.0

lib/esm/index.d.ts

@@ -5,2 +5,2 @@ export { compare } from './compare';
 export { CompareOperator } from './utils';
-export { validate } from './validate';
+export { validate, validateStrict } from './validate';

lib/esm/index.js

 export { compare } from './compare';
 export { compareVersions } from './compareVersions';
 export { satisfies } from './satisfies';
-export { validate } from './validate';
+export { validate, validateStrict } from './validate';
 //# sourceMappingURL=index.js.map

lib/esm/validate.d.ts

@@ -15,1 +15,15 @@ /**
 export declare const validate: (version: string) => boolean;
+/**
+ * Validate [semver](https://semver.org/) version strings strictly. Will not accept wildcards and version ranges.
+ *
+ * @param version Version number to validate
+ * @returns `true` if the version number is a valid semver version number `false` otherwise
+ *
+ * @example
+ * ```
+ * validate('1.0.0-rc.1'); // return true
+ * validate('1.0-rc.1'); // return false
+ * validate('foo'); // return false
+ * ```
+ */
+export declare const validateStrict: (version: string) => boolean;

lib/esm/validate.js

@@ -16,2 +16,17 @@ import { semver } from './utils';
 export const validate = (version) => typeof version === 'string' && /^[v\d]/.test(version) && semver.test(version);
+/**
+ * Validate [semver](https://semver.org/) version strings strictly. Will not accept wildcards and version ranges.
+ *
+ * @param version Version number to validate
+ * @returns `true` if the version number is a valid semver version number `false` otherwise
+ *
+ * @example
+ * ```
+ * validate('1.0.0-rc.1'); // return true
+ * validate('1.0-rc.1'); // return false
+ * validate('foo'); // return false
+ * ```
+ */
+export const validateStrict = (version) => typeof version === 'string' &&
+    /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/.test(version);
 //# sourceMappingURL=validate.js.map

lib/umd/index.js

@@ -193,2 +193,17 @@ (function (global, factory) {
     const validate = (version) => typeof version === 'string' && /^[v\d]/.test(version) && semver.test(version);
+    /**
+     * Validate [semver](https://semver.org/) version strings strictly. Will not accept wildcards and version ranges.
+     *
+     * @param version Version number to validate
+     * @returns `true` if the version number is a valid semver version number `false` otherwise
+     *
+     * @example
+     * ```
+     * validate('1.0.0-rc.1'); // return true
+     * validate('1.0-rc.1'); // return false
+     * validate('foo'); // return false
+     * ```
+     */
+    const validateStrict = (version) => typeof version === 'string' &&
+        /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/.test(version);
 
@@ -199,4 +214,5 @@ exports.compare = compare;
     exports.validate = validate;
+    exports.validateStrict = validateStrict;
 
 }));
 //# sourceMappingURL=index.js.map

package.json

 {
   "name": "compare-versions",
-  "version": "6.0.0",
+  "version": "6.1.0",
   "description": "Compare semver version strings to find greater, equal or lesser.",
@@ -39,8 +39,8 @@ "repository": {
     "@types/mocha": "^10.0.1",
-    "c8": "^7.10.0",
+    "c8": "^8.0.1",
     "mocha": "^10.0.0",
     "rollup": "^3.7.4",
     "ts-node": "^10.7.0",
-    "typescript": "^4.6.3"
+    "typescript": "^5.1.6"
   }
 }

README.md

@@ -105,2 +105,16 @@ # compare-versions
 
+### Validate version numbers (strict)
+
+Validate version numbers strictly according to semver.org; 3 integers, no wildcards, no leading zero or "v" etc:
+
+```js
+import { validateStrict } from 'compare-versions';
+
+validate('1.0.0');      // true
+validate('1.0.0-rc.1'); // true
+validate('1.0');        // false
+validate('1.x');        // false
+validate('v1.02');      // false
+```
+
 ### Browser
@@ -118,3 +132,4 @@
   console.log(validate('11.0.0'))
+  console.log(validateStrict('11.0.0'))
 </script>
 ```

src/index.ts

@@ -5,2 +5,2 @@ export { compare } from './compare';
 export { CompareOperator } from './utils';
-export { validate } from './validate';
+export { validate, validateStrict } from './validate';

src/validate.ts

@@ -18,1 +18,20 @@ import { semver } from './utils';
   typeof version === 'string' && /^[v\d]/.test(version) && semver.test(version);
+
+/**
+ * Validate [semver](https://semver.org/) version strings strictly. Will not accept wildcards and version ranges.
+ *
+ * @param version Version number to validate
+ * @returns `true` if the version number is a valid semver version number `false` otherwise
+ *
+ * @example
+ * ```
+ * validate('1.0.0-rc.1'); // return true
+ * validate('1.0-rc.1'); // return false
+ * validate('foo'); // return false
+ * ```
+ */
+export const validateStrict = (version: string) =>
+  typeof version === 'string' &&
+  /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/.test(
+    version
+  );

New alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Fixed alerts

License Policy Violation

License

This package is not allowed per your license policy. Review the package's license to ensure compliance.

Found 1 instance in 1 package

Improved metrics

Total package byte prevSize

55217

increased by8.11%

Lines of code

710

increased by9.74%

Number of lines in readme file

134

increased by12.61%

No dependency changes