mushroom-cli 1.0.14 → 1.1.0-alpha.1

package/README.md

@@ -24,7 +24,7 @@ Config gen database docs
 
 Config gen javascript driver
 
-    npx mr config gen projectName js-driver ./src/api/mushroom.api.js [alias aliasName] [roles Admin,User-Contributor]
+    npx mr config gen projectName js-driver ./src/api/mushroom.api.js [alias aliasName] [roles Admin,User-Contributor] [tarball tarballName]
 
 Config gen entities for Mushroom project in CSharp and using MongoDb
 

package/config.js

@@ -153,7 +153,6 @@ function configGenDatabaseDocs(args, mushroomConfig, projectName){
 }
 
 function configGenJavascriptDriver(args, mushroomConfig, projectName){
-    console.log("a");
     const path = args[4];
     if (!path) {
         help(args);
@@ -166,6 +165,7 @@ function configGenJavascriptDriver(args, mushroomConfig, projectName){
         denyRoles: []
     };
     let alias = "default";
+    let tarball = undefined;
     while (index < args.length) {
         switch (args[index]) {
             case "roles":
@@ -188,6 +188,12 @@ function configGenJavascriptDriver(args, mushroomConfig, projectName){
                 if (strAlias)
                     alias = strAlias;
                 break;
+            case "tarball":
+                index++;
+                const strTarball = args[index];
+                if (strTarball)
+                    tarball = strTarball;
+                break;
         }
         index++;
     }
@@ -202,6 +208,60 @@ function configGenJavascriptDriver(args, mushroomConfig, projectName){
             projectAlias[key] = value;
         }
     }
+    projectAlias.tarballName = tarball;
+    projectAlias.output = path;
+    saveConfig(mushroomConfig, () => console.log(`Saved configuration of gen javascript driver for ${projectName}@${alias}`));
+}
+
+function configGenTypescriptDriver(args, mushroomConfig, projectName){
+    const path = args[4];
+    if (!path) {
+        help(args);
+        return;
+    }
+
+    let index = 5;
+    let parameters = {
+        allowRoles: ["*"],
+        denyRoles: []
+    };
+    let alias = "default";
+    while (index < args.length) {
+        switch (args[index]) {
+            case "roles":
+                index++;
+                const strRoles = args[index];
+                if (strRoles) {
+                    const minusIndex = strRoles.indexOf("-");
+                    let grantedRoles = minusIndex == -1 ? strRoles : strRoles.substr(0, minusIndex);
+                    const deniedRoles = minusIndex == -1 ? "" : strRoles.substr(minusIndex + 1);
+                    if (!grantedRoles)
+                        grantedRoles = "*";
+                    parameters.allowRoles = grantedRoles.split(",");
+                    if (deniedRoles)
+                        parameters.denyRoles = deniedRoles.split(",");
+                }
+                break;
+            case "alias":
+                index++;
+                const strAlias = args[index];
+                if (strAlias)
+                    alias = strAlias;
+                break;
+        }
+        index++;
+    }
+
+    const project = mushroomConfig.projects[projectName];
+    project.tsDriver = project.tsDriver || {};
+    project.tsDriver.alias = project.tsDriver.alias || {};
+    const projectAlias = project.tsDriver.alias[alias] = project.tsDriver.alias[alias] || {};
+    for (const key in parameters) {
+        if (parameters.hasOwnProperty(key)) {
+            const value = parameters[key];
+            projectAlias[key] = value;
+        }
+    }
     projectAlias.output = path;
     saveConfig(mushroomConfig, () => console.log(`Saved configuration of gen javascript driver for ${projectName}@${alias}`));
 }
@@ -338,6 +398,9 @@ function configGen(args) {
         case "js-driver":
             configGenJavascriptDriver(args, mushroomConfig, projectName);
             break;
+        case "ts-driver":
+            configGenTypescriptDriver(args, mushroomConfig, projectName);
+            break;
         case "c#-mongo":
             configGenCSharpMongo(args, mushroomConfig, projectName);
             break;

package/gen/gen-api-docs.js

@@ -97,6 +97,16 @@ async function genDocs(args, projectName, project, alias, source) {
 
     const entities = common.getEntities(source, aliasProject.allowRoles);
 
+    if (Array.isArray(aliasProject.entities)) {
+        for (const entityName in entities) {
+            if (Object.hasOwnProperty.call(entities, entityName)) {
+                if (aliasProject.entities.every(re => !new RegExp(re).test(entityName))){
+                    delete entities[entityName];
+                }
+            }
+        }
+    }
+
     console.log('Fetching https://api.siten.vn/gen/docs.html');
     const html = await fetch('https://api.siten.vn/gen/docs.html').then(res => res.text());
     await processGenDocs(aliasProject, entities, source, html, args, projectName, alias);

package/gen/gen-csharp.js

@@ -1,5 +1,6 @@
 const fs = require("fs");
 const common = require("../common.js");
+const package = require("./../package.json");
 
 //#region shared function
 function singleLine(str) {
@@ -145,8 +146,17 @@ function generateCSharpClassMongoDb(source, className, fields, isRoot, descripti
     /// </summary>\r\n`;
     }
     var supperClass = "";
-    if (isRoot)
-        supperClass = " : Resource<" + getCSharpTypeFromMushroomType(source, fields.id ? fields.id.type : "AutoId", true) + ">";
+    if (isRoot) {
+        // thêm cho trường hợp không khai báo id hoặc id.type
+        if (!fields.id) {
+            fields.id = {
+                type: "AutoId"
+            };
+        }
+        if (!fields.id.type) fields.id.type = "AutoId";
+
+        supperClass = " : Mushroom.Models.IResource<" + getCSharpTypeFromMushroomType(source, fields.id.type, true) + ">";
+    }
     content += `    public class ${className}${supperClass}
     {
 `;
@@ -385,9 +395,9 @@ function genCSharpMongoDbClasses(args, projectName, project, alias, source) {
             .join("\r\n")
         : "";
 
-    const code = `// This file was generated by Mushroom CLI (https://www.npmjs.com/package/mushroom-cli), please do not modify
+    const code = `// This file was generated by Mushroom CLI ${package.version} (https://www.npmjs.com/package/mushroom-cli), please do not modify
 
-// NOTE: Compatible with Mushroom Server version 0.2.15 or higher
+// NOTE: Compatible with Mushroom Server version 0.2.18 or higher
 
 // ReSharper disable RedundantUsingDirective
 // ReSharper disable InconsistentNaming
@@ -413,17 +423,17 @@ namespace ${namespace}
 ${collectionNames}
         public static IMongoDatabase GetDatabase() => Mushroom.MushroomDaoFactory.GetDbAdapter() as IMongoDatabase;
         
-        public static async System.Threading.Tasks.Task<T> FindByIdAsync<T, TId>(this IMongoCollection<T> collection, TId id) where T : Resource<TId>
+        public static async System.Threading.Tasks.Task<T> FindByIdAsync<T, TId>(this IMongoCollection<T> collection, TId id) where T : Mushroom.Models.IResource<TId>
         {
             return await (await collection.FindAsync(Builders<T>.Filter.Eq(doc => doc.Id, id))).FirstOrDefaultAsync();
         }
         
-        public static async System.Threading.Tasks.Task<T> FindByIdAsync<T, TId>(this IMongoCollection<T> collection, TId id, FindOptions<T> findOptions) where T : Resource<TId>
+        public static async System.Threading.Tasks.Task<T> FindByIdAsync<T, TId>(this IMongoCollection<T> collection, TId id, FindOptions<T> findOptions) where T : Mushroom.Models.IResource<TId>
         {
             return await (await collection.FindAsync(Builders<T>.Filter.Eq(doc => doc.Id, id), findOptions)).FirstOrDefaultAsync();
         }
         
-        public static async System.Threading.Tasks.Task<T> FindByIdAsync<T, TId>(this IMongoCollection<T> collection, TId id, ProjectionDefinition<T> projection) where T : Resource<TId>
+        public static async System.Threading.Tasks.Task<T> FindByIdAsync<T, TId>(this IMongoCollection<T> collection, TId id, ProjectionDefinition<T> projection) where T : Mushroom.Models.IResource<TId>
         {
             return await (await collection.FindAsync(Builders<T>.Filter.Eq(doc => doc.Id, id), new FindOptions<T> { Projection = projection })).FirstOrDefaultAsync();
         }
@@ -433,11 +443,6 @@ ${collectionNames}
     {
 ${resourceNames}
     }
-
-    public interface Resource<T>
-    {
-        public T Id { get; set; }
-    }
 }
 
 namespace ${namespace}.Resources
@@ -905,11 +910,8 @@ ${strEnumClasses}
 
     common.ensureFolder(aliasProject.output);
 
-    fs.writeFile(aliasProject.output, code, err => {
-        if (err)
-            throw err;
-        console.log(`Generated CSharp Driver for ${projectName}@${alias} to ${aliasProject.output}`);
-    });
+    fs.writeFileSync(aliasProject.output, code);
+    console.log(`Generated CSharp Driver for ${projectName}@${alias} to ${aliasProject.output}`);
 }
 //#endregion
 

package/gen/gen-db-docs.js

@@ -19,7 +19,7 @@ function getConstrains(valField) {
     const constraints = [];
 
     if (valField.reference)
-        constraints.push(`Ref to ${valField.reference}`);
+        constraints.push(`Ref to <a href="#${valField.reference}">${encodeHtml(valField.reference)}</a>`);
 
     if (valField.validation) {
         if (valField.validation.required)
@@ -35,13 +35,13 @@ function getConstrains(valField) {
         if (valField.validation.maxLength !== undefined)
             constraints.push(`Max length: ${valField.validation.maxLength}`);
         if (valField.validation.gt !== undefined)
-            constraints.push(`GT: ${valField.validation.gt}`);
+            constraints.push(`GT: ${encodeHtml(valField.validation.gt)}`);
         if (valField.validation.lt !== undefined)
-            constraints.push(`LT: ${valField.validation.lt}`);
+            constraints.push(`LT: ${encodeHtml(valField.validation.lt)}`);
         if (valField.validation.min !== undefined)
-            constraints.push(`Min: ${valField.validation.min}`);
+            constraints.push(`Min: ${encodeHtml(valField.validation.min)}`);
         if (valField.validation.max !== undefined)
-            constraints.push(`Max: ${valField.validation.max}`);
+            constraints.push(`Max: ${encodeHtml(valField.validation.max)}`);
         if (valField.validation.pattern)
             constraints.push(`Pattern: ${encodeHtml(valField.validation.pattern)}`);
     }
@@ -83,7 +83,7 @@ function getMongoTableDocs(valTable) {
             <tr>
                 <td valign="top">${keyField}</td>
                 <td valign="top">${isArray ? "array of " + valField.items.type : valField.type}</td>
-                <td valign="top">${getConstrains(valField)}</td>
+                <td valign="top">${getConstrains(valField)}${isArray ? "<hr/>Array items:<br/>" + getConstrains(valField.items) : ""}</td>
                 <td valign="top" style="word-break: break-word">${encodeHtml(valField.description)}</td>
             </tr>`;
         }
@@ -103,7 +103,7 @@ function getMongoDbDocs(entities, source) {
                     <div>${des}</div>
                     ${getMongoTableDocs(valTable.fields)}
                     <br>`;
-        toc += `<li><a href="#${keyTable}"><b>${keyTable}</b></a> - ${des}</li>`;
+        toc += `<li><a href="#${keyTable}">${keyTable}</a> <span class="des">- ${des}</span></li>`;
     }
     
     return `
@@ -114,18 +114,57 @@ function getMongoDbDocs(entities, source) {
     <style>
         * {box-sizing: border-box}
         html, body {margin: 0 0; padding: 0 0; font-family: Calibri, 'helvetica neue', Arial, serifs}
+        h2{background-color: #ccc;margin: 30px -20px 0;padding: 5px 10px;}
+        hr{border-width: 0; border-top: 1px solid #ccc;}
         table {border-collapse: collapse;margin-top: 5px;}
-        th{background-color: #ccc}
+        th{background-color: #d7d7d7}
         a{color: #000; text-decoration: none}
         a:hover{color: blue; text-decoration: underline}
-        .paper{max-width: 11.69in; margin: 0 auto}
+
+        .nav{position: fixed; top: 0; left: 0; bottom: 0; width: 200px; z-index: 100; overflow: auto;border-right: 1px solid #bbb;background-color: #eee}
+        ul#nav-toc{padding: 0;margin: 0}
+        ul#nav-toc li{list-style: none;padding: 0;margin: 0;}
+        ul#nav-toc a{display: block;padding: 5px 10px;}
+        ul#nav-toc a:hover{background-color: #aaa; color: #fff; text-decoration: none}
+        ul#nav-toc .des{display: none}
+
+        :target {
+            -webkit-animation: target-fade 2s 1;
+            -moz-animation: target-fade 2s 1;
+        }
+        
+        @-webkit-keyframes target-fade {
+            0% { background-color: #ff0; }
+            100% { background-color: #ccc; }
+        }
+        @-moz-keyframes target-fade {
+            0% { background-color: #ff0; }
+            100% { background-color: #ccc; }
+        }
+        
+        body{padding-left: 200px}
+        .paper{padding: 0 20px}
+
+        ul#main-toc a{font-weight: bold}
+
+        @media print {
+            body{padding-left: 0}
+            .nav{display: none}
+        }
+        @media only screen and (max-width: 768px) {
+            body{padding-left: 0}
+            .nav{display: none}
+        }
     </style>
 <head>
 <body>
+    <div class="nav">
+        <ul id="nav-toc">${toc}</ul>
+    </div>
     <div class="paper">
         <h1 style="text-align: center">Đặc tả Cơ sở dữ liệu</h1>
         Hệ quản trị cơ sở dữ liệu: <b>${source.db}</b>
-        <ul>${toc}</ul>
+        <ul id="main-toc">${toc}</ul>
         ${htmlStr}
     </div>
 </body>
@@ -176,11 +215,8 @@ function genDatabaseDocs(args, projectName, project, alias, source) {
 
     common.ensureFolder(aliasProject.output);
 
-    fs.writeFile(aliasProject.output, code, err => {
-        if (err)
-            throw err;
-        console.log(`Generated Database docs for ${projectName}@${alias} to ${aliasProject.output}`);
-    });
+    fs.writeFileSync(aliasProject.output, code);
+    console.log(`Generated Database docs for ${projectName}@${alias} to ${aliasProject.output}`);
 }
 
 module.exports = genDatabaseDocs;

package/gen/gen-js-driver-tarball.js

@@ -0,0 +1,89 @@
+const fs = require("fs");
+const path = require('path');
+var targz = require('targz');
+const javascriptDriverGenerator = require("./gen-js-driver");
+const typescriptDriverGenerator = require("./gen-ts-driver");
+
+function compressAsync(src, dest, folderName) {
+    return new Promise((resolve, reject) => {
+        const options = {
+            src: src,
+            dest: dest
+        };
+        if (folderName) {
+            options.tar = {
+                map: (header) => {
+                    if (header.name === ".") return header;
+                    header.name = folderName + '/' + header.name;
+                    return header;
+                }
+            };
+        }
+
+        targz.compress(options, function(err){
+            if(err) {
+                reject(err);
+                return;
+            }
+            resolve();
+        });
+    });
+}
+
+async function genJavascriptDriverTarball(args, projectName, project, alias, source) {
+    const aliasProject = ((project.jsDriver || {}).alias || {})[alias];
+
+    let tarballName = aliasProject.tarballName ? aliasProject.tarballName : projectName;
+    tarballName = tarballName.toLowerCase().replace(/[^a-z-]/g, "-");
+
+    const dirPath = path.join(path.dirname(aliasProject.output), tarballName);
+    //const mainFileName = path.basename(aliasProject.output);
+    //const dtsFileName = mainFileName.replace(/\.js$/i, ".d.ts");
+
+    const packageContent = `{
+    "version": "1.0.${new Date().getTime()}",
+    "name": "${tarballName}",
+    "private": true,
+    "main": "${tarballName}.js",
+    "types": "${tarballName}.d.ts",
+    "dependencies": {
+        "mushroomjs": "^1.1.0-alpha.5"${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? ',\n        "mushroomjs-auth": "^1.1.0-alpha.4"' : ""}${Array.isArray(aliasProject.features) && aliasProject.features.includes("file") ? ',\n        "mushroomjs-file": "^1.1.0-alpha.1"' : ""}
+    }
+}`;
+
+    if (fs.existsSync(dirPath)) {
+        console.log("Clean up tarball folder");
+        fs.rmdirSync(dirPath, { recursive: true });
+    }
+
+    const tarballFileName = path.join(path.dirname(aliasProject.output), tarballName + ".tar.gz");
+
+    if (fs.existsSync(tarballFileName)) {
+        console.log("Clean up old tarball file");
+        fs.unlinkSync(tarballFileName);
+    }
+
+    console.log("Creating tarball folder");
+
+    fs.mkdirSync(dirPath, { recursive: true, mode: 0755 });
+
+    console.log("Generating main file: " + tarballName + ".js");
+    let code = javascriptDriverGenerator.genJavascriptDriverString(aliasProject, source);
+    fs.writeFileSync(path.join(dirPath, tarballName + ".js"), code);
+    
+    console.log("Generating types file: " + tarballName + ".d.ts");
+    code = typescriptDriverGenerator.genDtsString(aliasProject, source);
+    fs.writeFileSync(path.join(dirPath, tarballName + ".d.ts"), code);
+
+    console.log("Generating package file: package.json");
+    fs.writeFileSync(path.join(dirPath, "package.json"), packageContent);
+   
+    console.log("Generating tarball file: " + tarballFileName);
+    await compressAsync(dirPath, tarballFileName, tarballName);
+
+    console.log("Generated tarball file");
+    fs.rmdirSync(dirPath, { recursive: true });
+    console.log("Cleaned up tarball folder");
+}
+
+module.exports = genJavascriptDriverTarball;

package/gen/gen-js-driver.js

@@ -1,5 +1,6 @@
 const fs = require("fs");
 const common = require("../common.js");
+const typescriptDriverGenerator = require("./gen-ts-driver");
 
 function isAllowCache(actions, defaultValue) {
     let result = defaultValue;
@@ -22,11 +23,9 @@ function isAllowCache(actions, defaultValue) {
     return result;
 }
 
-function genJavascriptDriver(args, projectName, project, alias, source) {
-    const aliasProject = ((project.jsDriver || {}).alias || {})[alias];
-
+function genJavascriptDriverString(aliasProject, source) {
     if (!aliasProject) {
-        throw new Error(`Not found gen js-driver configuration. Please run 'npx mr config ${projectName} gen js-driver OUTPUT_FILE.js${alias === "default" ? "" : " alias " + alias}' first`);
+        return "";
     }
 
     const entities = common.getEntities(source, aliasProject.allowRoles);
@@ -66,15 +65,35 @@ const rootApiUrl = ${JSON.stringify(common.getRootUrl(source))};
 `;
     }
     code += `
-mushroom.$using(rootApiUrl);`;
+mushroom.$using(rootApiUrl);
+
+export default mushroom;`;
+
+    return code;
+}
+
+function genJavascriptDriver(args, projectName, project, alias, source) {
+    const aliasProject = ((project.jsDriver || {}).alias || {})[alias];
+
+    if (!aliasProject) {
+        throw new Error(`Not found gen js-driver configuration. Please run 'npx mr config gen ${projectName} js-driver OUTPUT_FILE.js${alias === "default" ? "" : " alias " + alias}' first`);
+    }
+
+    let code = genJavascriptDriverString(aliasProject, source);
 
     common.ensureFolder(aliasProject.output);
 
-    fs.writeFile(aliasProject.output, code, err => {
-        if (err)
-            throw err;
-        console.log(`Generated Javascript driver for ${projectName}@${alias} to ${aliasProject.output}`);
-    });
+    fs.writeFileSync(aliasProject.output, code);
+    console.log(`Generated ${aliasProject.output}`);
+
+    code = typescriptDriverGenerator.genDtsString(aliasProject, source);
+    const dtsFilePath = aliasProject.output.replace(/\.js$/i, ".d.ts");
+    fs.writeFileSync(dtsFilePath, code);
+    console.log(`Generated ${dtsFilePath}`);
+    console.log(`Generated Javascript driver for ${projectName}@${alias}`);
 }
 
-module.exports = genJavascriptDriver;
+module.exports = {
+    genJavascriptDriver,
+    genJavascriptDriverString
+};

package/gen/gen-ts-driver.js

@@ -0,0 +1,405 @@
+const fs = require("fs");
+const common = require("../common.js");
+
+function isAllowCache(actions, defaultValue) {
+    let result = defaultValue;
+    for (let i = 0; i < actions.length; i++) {
+        const action = actions[i];
+
+        if (!action ||
+            !action.cache ||
+            !action.cache.client ||
+            !action.cache.client.policy ||
+            action.cache.client.policy === "unset")
+            continue;
+
+        if (action.cache.client.policy === "disabled")
+            return false;
+
+        if (action.cache.client.policy === "allow" || action.cache.client.policy === "required")
+            result = true;
+    }
+    return result;
+}
+
+function toVietnameseNonTongue(str) {
+    const signText = "ăâđêôơưàảãạáằẳẵặắầẩẫậấèẻẽẹéềểễệếìỉĩịíòỏõọóồổỗộốờởỡợớùủũụúừửữựứỳỷỹỵýĂÂĐÐÊÔƠƯÀẢÃẠÁẰẲẴẶẮẦẨẪẬẤÈẺẼẸÉỀỂỄỆẾÌỈĨỊÍÒỎÕỌÓỒỔỖỘỐỜỞỠỢỚÙỦŨỤÚỪỬỮỰỨỲỶỸỴÝ";
+    const unsignedText = "aadeoouaaaaaaaaaaaaaaaeeeeeeeeeeiiiiiooooooooooooooouuuuuuuuuuyyyyyAADDEOOUAAAAAAAAAAAAAAAEEEEEEEEEEIIIIIOOOOOOOOOOOOOOOUUUUUUUUUUYYYYY";
+    var returnValue = "";
+    for (let i = 0; i < str.length; i++) {
+        const index = signText.indexOf(str.charAt(i));
+        returnValue += index !== -1 ? unsignedText.charAt(index) : str.charAt(i);
+    }
+    return returnValue;
+}
+
+function toTypeScriptClassName(str) {
+    if (!str)
+        return "_";
+    const name = toVietnameseNonTongue(str).replace(/\W/g, "_");
+    const c = name.charAt(0);
+    return ('0' <= c && c <= '9' ? '_' : "") + c.toUpperCase() + name.substr(1);
+}
+
+function getCSharpTypeFromMushroomType(type) {
+    switch (type) {
+        case "string":
+            return "string";
+        case "object":
+        case "array":
+            return "";
+        case "boolean":
+            return "boolean";
+        case "integer":
+        case "long":
+        case "double":
+            return "number";
+        case "datetime":
+            return "ISODateValue";
+        case "IdRef":
+        case "AutoId":
+            return "IdValue";
+    }
+    return "UNKNOWN_TYPE_" + type;
+}
+
+function generateTypescriptClass(objectDefination, indent) {
+    if (!indent) indent = "";
+    let code = "{\n";
+    for (let fieldName in objectDefination) {
+        if (objectDefination[fieldName].type == "object") {
+            code += `${indent}    ${fieldName}?: ${generateTypescriptClass(objectDefination[fieldName].fields, indent + "    ")},
+`;
+        }
+        else if (objectDefination[fieldName].type == "array") {
+            if (objectDefination[fieldName].items.type == "object") {
+                code += `${indent}    ${fieldName}?: ${generateTypescriptClass(objectDefination[fieldName].items.fields, indent + "    ")}[],
+`;
+            }
+            else {
+                code += `${indent}    ${fieldName}?: ${getCSharpTypeFromMushroomType(objectDefination[fieldName].items.type)}[],
+`;
+            }
+        }
+        else {
+            code += `${indent}    ${fieldName}?: ${getCSharpTypeFromMushroomType(objectDefination[fieldName].type)},
+`;
+        }
+    }
+    code += indent + "}";
+    return code;
+}
+
+function generateTypescriptClassFromViewParameters(parameters) {
+    if (Array.isArray(parameters)){
+        return '{\n' + parameters.map(p => `    ${p.field}?: ${getCSharpTypeFromMushroomType(p.type || "string")}${p.isArray ? "[]" : ""}`).join(',\n') + '\n}';
+    }
+    return '{}';
+}
+
+function genTypescriptDriverString(aliasProject, source) {
+    if (!aliasProject) {
+        return "";
+    }
+
+    const entities = common.getEntities(source, aliasProject.allowRoles);
+
+    let code = `import mushroom, { defineAsyncResource, defineAsyncView, fireEvent, createRestfulAsyncFunction, IdType, IMushroom, Mushroom, MushroomRequest, MushroomRequestSetting, MushroomRestfulRequest, MushroomResponse, MushroomResourceBase, MushroomListResource, MushroomFindByIdResource, MushroomCreateResource, MushroomBatchCreateResource, MushroomUpdateResource, MushroomBatchUpdateResource, MushroomPartialUpdateResource, MushroomDeleteResource, MushroomBatchDeleteResource, MushroomExtensibleResource, MushroomViewFunction, MushroomError } from "mushroomjs";
+${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? 'import { IMushroomAuth, useAuth, AuthLocalStorage } from "mushroomjs-auth";' : ""}
+${Array.isArray(aliasProject.features) && aliasProject.features.includes("file") ? 'import { IMushroomFile, useFile } from "mushroomjs-file";' : ""}
+
+export type ISODateValue = string | Date;
+export type IdValue = ${source.idType == "AutoIncInt" || source.idType == "AutoIncLong" ? "number" : "string"};
+
+`;
+    let iApiClassBody = "";
+    for (let entityName in entities) {
+        if (!entities.hasOwnProperty(entityName))
+            continue;
+
+        const entity = entities[entityName];
+        const typescriptClassName = toTypeScriptClassName(entityName);
+        code += `interface ${typescriptClassName} ${generateTypescriptClass(entity.fields)};
+`;
+
+
+        const actions = {};
+        iApiClassBody += `    ${entityName}: MushroomResourceBase`;
+        let customMethodCode = "";
+        for (const actionName in entity.actions) {
+            if (!entity.actions.hasOwnProperty(actionName))
+                continue;
+
+            actions[actionName] = {
+                clientCache: (actionName === "findById" || actionName === "findMany") && isAllowCache(entity.actions[actionName], true) ? true : undefined
+            };
+
+            switch (actionName) {
+                case "findMany": {
+                    iApiClassBody += ` & MushroomListResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "findById": {
+                    iApiClassBody += ` & MushroomFindByIdResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "createOne": {
+                    iApiClassBody += ` & MushroomCreateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "createMany": {
+                    iApiClassBody += ` & MushroomBatchCreateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "updateOne": {
+                    iApiClassBody += ` & MushroomUpdateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "updateMany": {
+                    iApiClassBody += ` & MushroomBatchUpdateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "updatePartially": {
+                    iApiClassBody += ` & MushroomPartialUpdateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "deleteOne": {
+                    iApiClassBody += " & MushroomDeleteResource";
+                    break;
+                }
+                case "deleteMany": {
+                    iApiClassBody += " & MushroomBatchDeleteResource";
+                    break;
+                }
+                default: {
+                    if (actionName.indexOf("_raw_http_method_") === 0) {
+                        customMethodCode += `    ${actionName.substr("_raw_http_method_".length)}Async: (rawRequest: MushroomRequest) => Promise<MushroomResponse<any>>,
+`;
+                        break;
+                    }
+                    else {
+                        console.warn(`Unknown action name: ${entityName}.${actionName}`);
+                        break;
+                    }
+                }
+            }
+        }
+
+        if (customMethodCode) {
+            code += `interface ${typescriptClassName}$CustomMethodResource {
+${customMethodCode}}
+`;
+            iApiClassBody += ` & ${typescriptClassName}$CustomMethodResource`;
+        }
+
+        const views = {};
+        let viewCode = "";
+        for (const viewName in entity.views) {
+            if (!entity.views.hasOwnProperty(viewName)) continue;
+
+            const viewRoles = entity.views[viewName];
+            if (!Array.isArray(viewRoles) || !viewRoles.length) continue;
+
+            views[viewName] = { clientCache: true };
+
+            const viewParameterTypes = viewRoles.map(view => {
+                const type = `${typescriptClassName}$ViewsResource_${viewName}View_${view.grant === "*" ? "" : toTypeScriptClassName(view.grant)}Parameters`;
+                code += `interface ${type} ${generateTypescriptClassFromViewParameters(view.parameters)};
+`;
+                return `MushroomViewFunction<any, ${type}>`;
+            });
+            viewCode += `
+        ${viewName}Async: ${viewParameterTypes.join(' & ')},`;
+        }
+        
+        if (viewCode) {
+            code += `interface ${typescriptClassName}$ViewsResource {
+    views: {${viewCode}
+    }
+}
+`;
+            iApiClassBody += ` & ${typescriptClassName}$ViewsResource`;
+        }
+
+        iApiClassBody +=`,
+`;
+
+        code += `defineAsyncResource<${typescriptClassName}>(${JSON.stringify({ name: entityName, actions: actions, views: views })});
+
+`;
+    }
+
+    code += `
+${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? "useAuth(AuthLocalStorage);" : ""}
+${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? "useFile();" : ""}
+mushroom.$using(${JSON.stringify(common.getRootUrl(source))});
+
+interface IApi extends IMushroom {
+${iApiClassBody}};
+
+type Api = ${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? "IMushroomAuth & " : ""}${Array.isArray(aliasProject.features) && aliasProject.features.includes("file") ? "IMushroomFile & " : ""}IApi;
+
+export default mushroom as Api;`;
+
+    return code;
+}
+
+function genDtsString(aliasProject, source) {
+    if (!aliasProject) {
+        return "";
+    }
+
+    const entities = common.getEntities(source, aliasProject.allowRoles);
+
+    let code = `import { IdType, IMushroom, Mushroom, MushroomRequest, MushroomRequestSetting, MushroomRestfulRequest, MushroomResponse, MushroomResourceBase, MushroomListResource, MushroomFindByIdResource, MushroomCreateResource, MushroomBatchCreateResource, MushroomUpdateResource, MushroomBatchUpdateResource, MushroomPartialUpdateResource, MushroomDeleteResource, MushroomBatchDeleteResource, MushroomExtensibleResource, MushroomViewFunction, MushroomError } from "mushroomjs";
+${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? 'import { IMushroomAuth } from "mushroomjs-auth";' : ""}
+${Array.isArray(aliasProject.features) && aliasProject.features.includes("file") ? 'import { IMushroomFile } from "mushroomjs-file";' : ""}
+
+export declare type ISODateValue = string | Date;
+export declare type IdValue = ${source.idType == "AutoIncInt" || source.idType == "AutoIncLong" ? "number" : "string"};
+
+`;
+    let iApiClassBody = "";
+    for (let entityName in entities) {
+        if (!entities.hasOwnProperty(entityName))
+            continue;
+
+        const entity = entities[entityName];
+        const typescriptClassName = toTypeScriptClassName(entityName);
+        code += `interface ${typescriptClassName} ${generateTypescriptClass(entity.fields)};
+`;
+
+
+        const actions = {};
+        iApiClassBody += `    ${entityName}: MushroomResourceBase`;
+        let customMethodCode = "";
+        for (const actionName in entity.actions) {
+            if (!entity.actions.hasOwnProperty(actionName))
+                continue;
+
+            actions[actionName] = {
+                clientCache: (actionName === "findById" || actionName === "findMany") && isAllowCache(entity.actions[actionName], true) ? true : undefined
+            };
+
+            switch (actionName) {
+                case "findMany": {
+                    iApiClassBody += ` & MushroomListResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "findById": {
+                    iApiClassBody += ` & MushroomFindByIdResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "createOne": {
+                    iApiClassBody += ` & MushroomCreateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "createMany": {
+                    iApiClassBody += ` & MushroomBatchCreateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "updateOne": {
+                    iApiClassBody += ` & MushroomUpdateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "updateMany": {
+                    iApiClassBody += ` & MushroomBatchUpdateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "updatePartially": {
+                    iApiClassBody += ` & MushroomPartialUpdateResource<${typescriptClassName}>`;
+                    break;
+                }
+                case "deleteOne": {
+                    iApiClassBody += " & MushroomDeleteResource";
+                    break;
+                }
+                case "deleteMany": {
+                    iApiClassBody += " & MushroomBatchDeleteResource";
+                    break;
+                }
+                default: {
+                    if (actionName.indexOf("_raw_http_method_") === 0) {
+                        customMethodCode += `    ${actionName.substr("_raw_http_method_".length)}Async: (rawRequest: MushroomRequest) => Promise<MushroomResponse<any>>,
+`;
+                        break;
+                    }
+                    else {
+                        console.warn(`Unknown action name: ${entityName}.${actionName}`);
+                        break;
+                    }
+                }
+            }
+        }
+
+        if (customMethodCode) {
+            code += `interface ${typescriptClassName}$CustomMethodResource {
+${customMethodCode}}
+`;
+            iApiClassBody += ` & ${typescriptClassName}$CustomMethodResource`;
+        }
+
+        const views = {};
+        let viewCode = "";
+        for (const viewName in entity.views) {
+            if (!entity.views.hasOwnProperty(viewName)) continue;
+
+            const viewRoles = entity.views[viewName];
+            if (!Array.isArray(viewRoles) || !viewRoles.length) continue;
+
+            views[viewName] = { clientCache: true };
+
+            const viewParameterTypes = viewRoles.map(view => {
+                const type = `${typescriptClassName}$ViewsResource_${viewName}View_${view.grant === "*" ? "" : toTypeScriptClassName(view.grant)}Parameters`;
+                code += `interface ${type} ${generateTypescriptClassFromViewParameters(view.parameters)};
+`;
+                return `MushroomViewFunction<any, ${type}>`;
+            });
+            viewCode += `
+        ${viewName}Async: ${viewParameterTypes.join(' & ')},`;
+        }
+        
+        if (viewCode) {
+            code += `interface ${typescriptClassName}$ViewsResource {
+    views: {${viewCode}
+    }
+}
+`;
+            iApiClassBody += ` & ${typescriptClassName}$ViewsResource`;
+        }
+
+        iApiClassBody +=`,
+`;
+    }
+
+    code += `
+interface IApi extends IMushroom {
+${iApiClassBody}};
+
+declare type Api = ${Array.isArray(aliasProject.features) && aliasProject.features.includes("auth") ? "IMushroomAuth & " : ""}${Array.isArray(aliasProject.features) && aliasProject.features.includes("file") ? "IMushroomFile & " : ""}IApi;
+declare const _default: Api;
+export default _default;`;
+
+    return code;
+}
+
+function genTypescriptDriver(args, projectName, project, alias, source) {
+    const aliasProject = ((project.tsDriver || {}).alias || {})[alias];
+
+    if (!aliasProject) {
+        throw new Error(`Not found gen ts-driver configuration. Please run 'npx mr config gen ${projectName} ts-driver OUTPUT_FILE.ts${alias === "default" ? "" : " alias " + alias}' first`);
+    }
+
+    const code = genTypescriptDriverString(aliasProject, source);
+
+    common.ensureFolder(aliasProject.output);
+
+    fs.writeFileSync(aliasProject.output, code);
+    console.log(`Generated Typescript driver for ${projectName}@${alias} to ${aliasProject.output}`);
+}
+
+module.exports = {
+    genTypescriptDriver,
+    genTypescriptDriverString,
+    genDtsString
+};

package/gen.js

@@ -7,7 +7,9 @@ const masterFile = require("./master-file/master-file");
 
 const genApiDocs = require("./gen/gen-api-docs");
 const genDatabaseDocs = require("./gen/gen-db-docs");
-const genJavascriptDriver = require("./gen/gen-js-driver");
+const javascriptDriverGenerator = require("./gen/gen-js-driver");
+const genJavascriptDriverTarball = require("./gen/gen-js-driver-tarball");
+const typescriptDriverGenerator = require("./gen/gen-ts-driver");
 const csharp = require("./gen/gen-csharp");
 
 
@@ -86,16 +88,22 @@ async function gen(args) {
             await genApiDocs(args, projectName, project, alias, source);
             break;
         case "db-docs":
-            await genDatabaseDocs(args, projectName, project, alias, source);
+            genDatabaseDocs(args, projectName, project, alias, source);
             break;
         case "js-driver":
-            await genJavascriptDriver(args, projectName, project, alias, source);
+            javascriptDriverGenerator.genJavascriptDriver(args, projectName, project, alias, source);
+            break;
+        case "js-driver-tarball":
+            await genJavascriptDriverTarball(args, projectName, project, alias, source);
+            break;
+        case "ts-driver":
+            typescriptDriverGenerator.genTypescriptDriver(args, projectName, project, alias, source);
             break;
         case "c#-mongo":
-            await csharp.genCSharpMongoDbClasses(args, projectName, project, alias, source);
+            csharp.genCSharpMongoDbClasses(args, projectName, project, alias, source);
             break;
         case "c#-driver":
-            await csharp.genCSharpDriver(args, projectName, project, alias, source);
+            csharp.genCSharpDriver(args, projectName, project, alias, source);
             break;
         case "":
         case undefined:

package/help.js

@@ -31,7 +31,7 @@ Generate database docs (html format)
     npx mr gen projectName[@aliasName] db-docs [tmp]
 
 Config gen javascript driver
-    npx mr config gen projectName js-driver ./src/api/mushroom.api.js [alias aliasName] [roles Admin,User-Contributor]
+    npx mr config gen projectName js-driver ./src/api/mushroom.api.js [alias aliasName] [roles Admin,User-Contributor] [tarball tarballName]
 
 Generate javascript driver
     npx mr gen projectName[@aliasName] js-driver

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "mushroom-cli",
-  "version": "1.0.14",
+  "version": "1.1.0-alpha.1",
   "description": "Mushroom CLI",
   "main": "mr.js",
   "scripts": {
-    "publish": "npm publish --access public"
+    "release": "npm publish --access public --tag alpha"
   },
   "keywords": [
     "Mushroom",
@@ -21,6 +21,7 @@
     "json5": "^2.1.2",
     "node-fetch": "^2.6.0",
     "open": "^7.0.3",
-    "readline-sync": "^1.4.10"
+    "readline-sync": "^1.4.10",
+    "targz": "^1.0.1"
   }
-}
+}