@sasjs/utils 3.7.3 → 4.0.0

package/README.md

@@ -6,6 +6,29 @@
 
 A library of utilities and types for SASjs written in TypeScript.
 
+## Entry points
+
+This is a Node library, and the barrel - `import { x } from '@sasjs/utils'` - is its Node
+entry point. Importing from it pulls in the modules that only Node can run: `fs-extra` and
+`@fast-csv/format` through `./file`, `prompts` through `./input`, `chalk` and `consola`
+through `./logger` and `./formatter`.
+
+Code that is bundled for a browser imports the subpath it needs instead:
+
+```
+import { ServerType } from '@sasjs/utils/types'
+import { prefixMessage } from '@sasjs/utils/error'
+import { isSpecialMissing } from '@sasjs/utils/input/validators'
+import { bytesToSize } from '@sasjs/utils/utils'
+```
+
+The hash and sync helpers - `getHash`, `compareHashes`, `extractHashArray`,
+`generateCompileProgram`, `generateProgramToGetRemoteHash`, `generateProgramToSyncHashDiff`
+and `findResourcesNotPresentLocally` - live in `@sasjs/utils/fs`. They hash files and
+folders on disk, so they are Node-only, and the barrel does not re-export them: a browser
+bundle that imports the barrel for anything else no longer reaches `crypto`, which used to
+arrive with the whole AES/RSA/ECDSA polyfill suite behind it.
+
 ## Contributors ✨
 
 Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

package/index.d.ts

@@ -8,4 +8,3 @@ export * from './time';
 export * from './types';
 export * from './utils';
 export * from './compileTree';
-export * from './fs';

package/index.js

@@ -20,5 +20,10 @@ __exportStar(require("./time"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./utils"), exports);
 __exportStar(require("./compileTree"), exports);
-__exportStar(require("./fs"), exports);
+// './fs' is deliberately absent: it is the only module here that imports
+// `crypto`, and re-exporting it put that - plus browserify-sign, parse-asn1,
+// asn1.js and vm-browserify, roughly 555 KB of AES/RSA/ECDSA polyfills and a
+// vm shim's dynamic code execution - into every browser bundle that imported
+// anything from this barrel. The helpers live at '@sasjs/utils/fs' instead.
+// See sasjs/utils#275.
 //# sourceMappingURL=index.js.map

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAsB;AACtB,yCAAsB;AACtB,8CAA2B;AAC3B,0CAAuB;AACvB,2CAAwB;AACxB,6CAA0B;AAC1B,yCAAsB;AACtB,0CAAuB;AACvB,0CAAuB;AACvB,gDAA6B;AAC7B,uCAAoB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yCAAsB;AACtB,yCAAsB;AACtB,8CAA2B;AAC3B,0CAAuB;AACvB,2CAAwB;AACxB,6CAA0B;AAC1B,yCAAsB;AACtB,0CAAuB;AACvB,0CAAuB;AACvB,gDAA6B;AAC7B,yEAAyE;AACzE,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,uBAAuB"}

package/package.json

@@ -95,5 +95,5 @@
     "jwt-decode": "4.0.0",
     "prompts": "2.4.2"
   },
-  "version": "3.7.3"
+  "version": "4.0.0"
 }

package/utils/base64.js

@@ -11,15 +11,35 @@ const PREFIX_HEX_LENGTH = 200;
 const randomHexPrefix = () => Array.from(crypto.getRandomValues(new Uint8Array(PREFIX_HEX_LENGTH / 2)))
     .map((byte) => byte.toString(16).padStart(2, '0'))
     .join('');
+// Buffer does not exist in a browser, and this module is reachable from the
+// package root, so the encoding uses the platform globals instead. TextEncoder
+// and TextDecoder carry the UTF-8 step: btoa is latin1, so encoding a password
+// through it directly corrupts anything non-ASCII. The binary string is built
+// in chunks because spreading a whole byte array into String.fromCharCode
+// overflows the call stack on long input.
+const CHUNK_SIZE = 0x8000;
+const toBase64 = (bytes) => {
+    let binary = '';
+    for (let offset = 0; offset < bytes.length; offset += CHUNK_SIZE) {
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + CHUNK_SIZE));
+    }
+    return btoa(binary);
+};
+const fromBase64 = (str) => {
+    // Buffer ignores whitespace when decoding base64 and atob does not, so a
+    // wrapped or padded stored value still decodes.
+    const binary = atob(str.replace(/\s/g, ''));
+    return new TextDecoder().decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
+};
 const encodeToBase64 = (str) => {
-    const encodedPassword = Buffer.from(randomHexPrefix() + str).toString('base64');
+    const encodedPassword = toBase64(new TextEncoder().encode(randomHexPrefix() + str));
     return PREFIX + encodedPassword;
 };
 exports.encodeToBase64 = encodeToBase64;
 const decodeFromBase64 = (str) => {
     if (str.startsWith(PREFIX)) {
         str = str.replace(/^{sasjs_encoded}/, '');
-        const decodedPassword = Buffer.from(str, 'base64').toString();
+        const decodedPassword = fromBase64(str);
         return decodedPassword.substring(200);
     }
     return str;

package/utils/base64.js.map

@@ -1 +1 @@
-{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/utils/base64.ts"],"names":[],"mappings":";;;AAAA,MAAM,MAAM,GAAG,iBAAiB,CAAA;AAChC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,sEAAsE;AACtE,MAAM,eAAe,GAAG,GAAW,EAAE,CACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC;KACtE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;KACjD,IAAI,CAAC,EAAE,CAAC,CAAA;AAEN,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE;IAC5C,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,CAAC,QAAQ,CACnE,QAAQ,CACT,CAAA;IACD,OAAO,MAAM,GAAG,eAAe,CAAA;AACjC,CAAC,CAAA;AALY,QAAA,cAAc,kBAK1B;AACM,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE;IAC9C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QAC1B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;QACzC,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;QAC7D,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;KACtC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAPY,QAAA,gBAAgB,oBAO5B"}
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../../src/utils/base64.ts"],"names":[],"mappings":";;;AAAA,MAAM,MAAM,GAAG,iBAAiB,CAAA;AAChC,MAAM,iBAAiB,GAAG,GAAG,CAAA;AAE7B,iFAAiF;AACjF,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,sEAAsE;AACtE,MAAM,eAAe,GAAG,GAAW,EAAE,CACnC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,iBAAiB,GAAG,CAAC,CAAC,CAAC,CAAC;KACtE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;KACjD,IAAI,CAAC,EAAE,CAAC,CAAA;AAEb,4EAA4E;AAC5E,+EAA+E;AAC/E,+EAA+E;AAC/E,8EAA8E;AAC9E,0EAA0E;AAC1E,0CAA0C;AAC1C,MAAM,UAAU,GAAG,MAAM,CAAA;AAEzB,MAAM,QAAQ,GAAG,CAAC,KAAiB,EAAU,EAAE;IAC7C,IAAI,MAAM,GAAG,EAAE,CAAA;IAEf,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,EAAE;QAChE,MAAM,IAAI,MAAM,CAAC,YAAY,CAC3B,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAC/C,CAAA;KACF;IAED,OAAO,IAAI,CAAC,MAAM,CAAC,CAAA;AACrB,CAAC,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,GAAW,EAAU,EAAE;IACzC,yEAAyE;IACzE,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAA;IAE3C,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAC7B,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CACtD,CAAA;AACH,CAAC,CAAA;AAEM,MAAM,cAAc,GAAG,CAAC,GAAW,EAAE,EAAE;IAC5C,MAAM,eAAe,GAAG,QAAQ,CAC9B,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,GAAG,CAAC,CAClD,CAAA;IACD,OAAO,MAAM,GAAG,eAAe,CAAA;AACjC,CAAC,CAAA;AALY,QAAA,cAAc,kBAK1B;AAEM,MAAM,gBAAgB,GAAG,CAAC,GAAW,EAAE,EAAE;IAC9C,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;QAC1B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;QACzC,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAA;QACvC,OAAO,eAAe,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;KACtC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC,CAAA;AAPY,QAAA,gBAAgB,oBAO5B"}