Revert to es5 in lib Folder
After we had a number of issues reported that were all related to distributing es6 modules in the sp-pnp-js npm package's lib folder we are reverting back to es5 for distribution. We have maintained since the beginning we want to remove obstacles to using the library. In this case after hearing from folks it was an obvious choice.
One thing interesting point to consider is that the rollback is driven almost entirely by the wide usage of uglifyjs across the web development community. Because we (collectively all of us) have taken a dependency on uglifyjs and it cannot handle es6 modules the de facto module standard is es5. And this is not to point at uglifyjs in a bad way, they have done amazing work - as shown by the high usage, but rather it highlights the dependencies that aren't always immediately obvious in open source development.
But at the end of the day anything that makes it harder to use sp-pnp-js should be addressed and this is one of those cases. So all the issues folks were reporting around uglifyjs or --ship, etc should now be fixed. This also has the added benefit of helping out folks supporting IE 10 & 11 as well. The guidance on using the library with SPFx is updated as well.
Optimization for contextinfo Calls
An issue was reported where it was found we weren't effectively caching the contextinfo and then repeating calls unnecessarily within the same site. Great find and a good fix so you should see a reduction in traffic when using the library.
Support for Ambient Typings
It was reported twice in the last month that folks were trying to use the library in an ambient way (i.e. as if imported via a global script tag) and needed support for the typings. To enable this we added a shim file and usage is shown below. There is also a new wiki page with details of this approach as well.
Updated to Webpack 2
We also took some time to update our build pipeline to use webpack 2. This should be invisible to folks but worth mentioning. The update process was very easy and they have a great guide to follow when migrating from 1.*.
Be sure to check out the developer guide, we are working to add new articles and update existing ones based on feedback. This is a great place if you are just getting started with the library.
Fixes & Updates
This was a bug fix heavy release as opposed to new features, so wanted to call out those fixes in case you have seen similar issues.
- Fixed issue with adding items and batching
- Addressed issue with TypeScript 2.2.1
- Fixed an issue with JSDoc where the information in articles was being duplicated
- Updated release guide to remember to do git releases to support bower as reported in two issues
- Fixed an issue where errors on list item update were being hidden and not properly thrown to a subscribed catch
- Fixed an issue with updating list items in a batch were the dependency was not being resolved and the update hung
- Added the as function to Queryable - part of the upcoming extensibility story
- Exporting the Queryable base classes - part of the upcoming extensibility story
Thanks again to everyone that provided feedback on the library this month, it drove some great updates and fixes! Let's keep the dialog going.
What is the JS Core Component?
“Sharing is Caring”