perf(IDEA): implementation

Author: aleen42

.eslintignore

@@ -0,0 +1 @@
+dist

.eslintrc.yaml

@@ -0,0 +1,6 @@
+
+---
+root: true
+extends: plugin:coremail/standard
+env:
+    jasmine: true

.gitignore

@@ -105,3 +105,6 @@ dist
 
 # IDEA
 .idea
+
+# locked dependencies
+package-lock.json

README.md

@@ -1,5 +1,46 @@
-## IDEA
+# IDEA
 
 ![npm](https://badges.aleen42.com/src/npm.svg) ![javascript](https://badges.aleen42.com/src/javascript.svg)
 
-The IDEA cypher implementation in JavaScript
+It is about the IDEA cypher which is implemented in JavaScript within ~10 KiB. If you want better compatibility, you may need the polyfill version `dist/idea.all.js`, which has shimmed [`Int8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Int8Array) for you.
+
+## Compatibility
+
+- IE6+ (polyfills required for ES7- browsers)
+- NodeJS
+
+## Install
+
+```bash
+npm install @cormeail/idea
+```
+
+## Usage
+
+- without padding:
+
+    ```js
+    function paddingToBytes(str) {
+        typeof str !== 'string' && (str = JSON.stringify(str));
+
+        const blockSize = 8;
+        const srcBytes = encoder.encode(str);
+        const len = Math.ceil(srcBytes.length / blockSize) * blockSize; // padding with \x00
+        const src = new Int8Array(len);
+        src.set(srcBytes);
+        return src;
+    }
+  
+    const IDEA = require('@coremail/idea');
+    const idea = new IDEA(str2bytes('private key'), /* no padding */-1);
+    idea.encrypt(paddingToBytes('message')); // => Int8Array[]
+    ```
+
+- with xor padding (ENC3 by default):
+
+    ```js
+    const encoder = new TextEncoder(); 
+    const IDEA = require('@coremail/idea');
+    const idea = new IDEA(str2bytes('private key'), /* ENC3 by default */197);
+    idea.encrypt(encoder.encode('message')); // => Int8Array[]
+    ```

build.js

@@ -0,0 +1,21 @@
+const webpack = require('webpack');
+const config = require('./webpack.config');
+
+// build uncompressed
+webpack(config(0)).run(webpackCallback);
+// build minimized
+webpack(config(1)).run(webpackCallback);
+
+function log(msg) {
+    log.logged ? console.log('') : (log.logged = true); // add blank line
+    console.log(msg);
+}
+
+function webpackCallback(err, stats) {
+    if (err) {
+        process.exit(1);
+    }
+    log(stats.toString({
+        colors : true,
+    }));
+}

build/ES3HarmonyPlugin.js

@@ -0,0 +1,68 @@
+/*
+ * Copyright (c) 2018 Coremail.cn, Ltd. All Rights Reserved.
+ */
+
+// see https://github.com/inferpse/es3-harmony-webpack-plugin
+
+const name = 'ES3HarmonyPlugin';
+
+module.exports = class ES3HarmonyPlugin {
+    apply({hooks, webpack : {javascript : {JavascriptModulesPlugin}}}) {
+        // noinspection JSUnresolvedVariable
+        hooks.compilation.tap({name}, compilation => {
+            // noinspection JSUnresolvedVariable, JSUnresolvedFunction
+            JavascriptModulesPlugin.getCompilationHooks(compilation).renderMain.tap({name}, replaceSource)
+        });
+    }
+};
+
+function replaceSource(source) {
+    source = source['original'] ? source['original']() : source;
+    if (source['getChildren']) {
+        source['getChildren']().forEach(replaceSource);
+    } else {
+        // pattern: RegExp|substr, replacement: newSubstr|function
+        replacements.forEach(([pattern, replacement]) => {
+            if (pattern.test(source.source())) {
+                source._value = source.source().replace(pattern, replacement);
+            }
+        });
+    }
+}
+
+const toReplace = (pattern, replacement) => [
+    new RegExp(pattern.trim().replace(/.*noinspection.*\n/g, '').replace(/[?.[\]()]/g, '\\$&').replace(/\s+/g, '\\s*'), 'g'),
+    // trimIndent
+    replacement.trim().replace(/^ {8}/mg, ''),
+];
+
+/* global __webpack_require__ */// eslint-disable-line no-unused-vars
+// language=JS
+const replacements = [
+    // @formatter:off
+    toReplace(`
+        __webpack_require__.d = function (exports, definition) {
+            for (var key in definition) {
+                // noinspection JSUnfilteredForInLoop, JSUnresolvedFunction
+                if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+                    // noinspection JSUnfilteredForInLoop
+                    Object.defineProperty(exports, key, { enumerable : true, get : definition[key] });
+                }
+            }
+        };
+    `, `
+        __webpack_require__.d = function (exports, definition) {
+            for (var key in definition) {
+                // noinspection JSUnfilteredForInLoop, JSUnresolvedFunction
+                if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {
+                    // noinspection JSUnfilteredForInLoop
+                    exports[key] = definition[key](); // patched by ${name}
+                }
+            }
+        };
+    `),
+    // @formatter:on
+
+    // remove "use strict"
+    [/(['"])use\s+strict(['"]);?/gm, ''],
+];

karma.config.js

@@ -0,0 +1,38 @@
+/*
+ * Copyright (c) 2021 Coremail.cn, Ltd. All Rights Reserved.
+ */
+
+const webpackConfig = Object.assign({}, require('./webpack.config')(1));
+delete webpackConfig.entry;
+delete webpackConfig.output;
+
+module.exports = config => {
+    config.set({
+        webpack       : webpackConfig,
+        files         : ['test/index.js'],
+        preprocessors : {'test/index.js' : ['webpack', 'sourcemap']},
+        frameworks    : ['jasmine', 'webpack', 'detectBrowsers'],
+        reporters     : ['mocha'],
+        singleRun     : true,
+        plugins       : [
+            'karma-jasmine',
+            'karma-mocha-reporter',
+            'karma-sourcemap-loader',
+            'karma-webpack',
+            'karma-chrome-launcher',
+            'karma-safari-launcher',
+            'karma-firefox-launcher',
+            'karma-ie-launcher',
+            'karma-edge-launcher',
+            'karma-detect-browsers',
+        ],
+
+        client : {jasmine : {random : false}},
+
+        detectBrowsers : {
+            usePhantomJS : false,
+            // ref: https://github.com/karma-runner/karma-safari-launcher/issues/12
+            'postDetection' : availableBrowser => availableBrowser.filter(name => name !== 'Safari'),
+        },
+    });
+};