/*****************************************************************************\ | ( )_ _ | | _ _ _ __ _ _ __ ___ ___ _ _ | ,_)(_) ___ ___ _ | | ( '_`\ ( '__)/'_` ) /'_ `\/' _ ` _ `\ /'_` )| | | |/',__)/' _ `\ /'_`\ | | | (_) )| | ( (_| |( (_) || ( ) ( ) |( (_| || |_ | |\__, \| ( ) |( (_) ) | | | ,__/'(_) `\__,_)`\__ |(_) (_) (_)`\__,_)`\__)(_)(____/(_) (_)`\___/' | | | | ( )_) | | | (_) \___/' | | | | General Bots Copyright (c) Pragmatismo.io. All rights reserved. | | Licensed under the AGPL-3.0. | | | | According to our dual licensing model, this program can be used either | | under the terms of the GNU Affero General Public License, version 3, | | or under a proprietary license. | | | | The texts of the GNU Affero General Public License with an additional | | permission and of our proprietary license can be found at and | | in the LICENSE file you have received along with this program. | | | | This program is distributed in the hope that it will be useful, | | but WITHOUT ANY WARRANTY; without even the implied warranty of | | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | | GNU Affero General Public License for more details. | | | | "General Bots" is a registered trademark of Pragmatismo.io. | | The licensing of the program under the AGPLv3 does not imply a | | trademark license. Therefore any rights, title and interest in | | our trademarks remain entirely with us. | | | \*****************************************************************************/ "use strict"; const gBuilder = require("botbuilder"); const UrlJoin = require("url-join"); const Path = require("path"); const Fs = require("fs"); const Url = require("url"); const logger = require("../../../src/logger"); const WaitUntil = require("wait-until"); const Walk = require("fs-walk"); const express = require("express"); import { UniversalBot } from "botbuilder"; import { Session, MemoryBotStorage, Message } from "botbuilder"; import { GBCoreService } from "./GBCoreService"; import { GBConversationalService } from "./GBConversationalService"; import { GBConfigService } from "./GBConfigService"; import * as request from "request-promise-native"; import { GBMinInstance, IGBCoreService, IGBInstance, IGBPackage, GBError } from "botlib"; import { GBServiceCallback } from "botlib"; import { GBAnalyticsPackage } from "../../analytics.gblib"; import { GBCorePackage } from "../../core.gbapp"; import { GBKBPackage } from '../../kb.gbapp'; import { GBDeployer } from './GBDeployer'; import { GBSecurityPackage } from '../../security.gblib'; import { GBAdminPackage } from './../../admin.gbapp/index'; import { GBCustomerSatisfactionPackage } from "../../customer-satisfaction.gbapp"; /** Minimal service layer for a bot. */ export class GBMinService { core: GBCoreService; conversationalService: GBConversationalService; deployer: GBDeployer; deployFolder = "deploy"; corePackage = "core.gbai"; /** * Static iniatialization of minimal instance. * * @param core Basic database services to identify instance, for example. * @param cb Returns the loaded instance. */ constructor( core: GBCoreService, conversationalService: GBConversationalService, deployer: GBDeployer ) { this.core = core; this.conversationalService = conversationalService; this.deployer = deployer; } /** Constructs a new minimal instance for each bot. */ buildMin(cb: GBServiceCallback, server: any, appPackages: Array) { var _this = this; // Serves default UI on root address '/'. let uiPackage = "default.gbui"; server.use( "/", express.static(UrlJoin(this.deployFolder, uiPackage, "build")) ); // Loads all bot instances from storage. _this.core.loadInstances((instances: IGBInstance[], err) => { // Gets the authorization key for each instance from Bot Service. instances.forEach(instance => { let options = { url: "https://directline.botframework.com/v3/directline/tokens/generate", method: "POST", headers: { Authorization: `Bearer ${instance.webchatKey}` } }; request(options).then((response: string) => { // Serves the bot information object via http so clients can get // instance information stored on server. let responseObject = JSON.parse(response); server.get("/instances/:botId", (req, res) => { // Returns the instance object to clients requesting bot info. let botId = req.params.botId; _this.core.loadInstance( botId, (instance: IGBInstance, err) => { if (instance) { res.send( JSON.stringify({ instanceId: instance.instanceId, botId: botId, theme: instance.theme, secret: instance.webchatKey, // TODO: Use token. conversationId: responseObject.conversationId }) ); } else { let error = `Instance not found: ${botId}.`; res.send(error); logger.error(error); } } ); }); }); // The minimal bot is built here. let min = new GBMinInstance(); min.botId = instance.botId; min.core = _this.core; min.conversationalService = _this.conversationalService; let connector = new gBuilder.ChatConnector({ appId: instance.marketplaceId, appPassword: instance.marketplacePassword }); // Serves individual URL for each bot conversational interface... let url = `/api/messages/${instance.botId}`; logger.trace( `GeneralBots(${instance.engineName}) listening on: ${url}.` ); server.post(url, connector.listen()); // Serves individual URL for each bot user interface. let uiUrl = `/${instance.botId}`; server.use( uiUrl, express.static(UrlJoin(this.deployFolder, uiPackage, "build")) ); logger.trace(`Bot UI ${uiPackage} acessible at: ${uiUrl}.`); // Prepares bot service. let inMemoryStorage = new MemoryBotStorage(); min.bot = new gBuilder.UniversalBot(connector, { storage: inMemoryStorage }); // Call the loadBot event. appPackages.forEach(e => e.loadBot(min)); // Setups handlers. min.bot.use({ botbuilder: (session, next) => { if (!session.privateConversationData.loaded) { setTimeout( () => `Sending loading instance to client ${min.instance.ui}.`, min.conversationalService.sendEvent( session, "loadInstance", min.instance // TODO: Send a new thiner object. ), 500 ); session.privateConversationData.loaded = true; appPackages.forEach(e => { e.onNewSession(min, session) }); // PACKAGE: min.subjects = []; } next(); }, receive: function (event: any, next) { logger.trace( `Event RCV: (Type: ${event.type}, Name: ${event.name}, Value: ${ event.value }).` ); // PACKAGE: Provide loop here. if ( event.type === "conversationUpdate" && event.membersAdded.length > 0 && event.membersAdded[0].name != "You" ) { min.bot.beginDialog(event.address, "/"); } else if (event.name === "whoAmI") { min.bot.beginDialog(event.address, "/whoAmI"); } else if (event.name === "showSubjects") { min.bot.beginDialog(event.address, "/menu"); } else if (event.name === "giveFeedback") { min.bot.beginDialog(event.address, "/feedback", { fromMenu: true }); } else if (event.name === "showFAQ") { min.bot.beginDialog(event.address, "/faq"); } else if (event.name === "ask") { min.bot.beginDialog(event.address, "/answer", { query: event.data, fromFaq: true }); } else if (event.name === "quality") { min.bot.beginDialog(event.address, "/quality", { score: event.data }); } else { next(); } }, send: function (event, next) { this.core.createMessage( this.min.conversation, this.min.conversation.startedBy, event.source, (data, err) => { logger.trace(event.source); } ); next(); } }); let generalPackages = [GBAdminPackage, GBAnalyticsPackage, GBCorePackage, GBSecurityPackage, GBKBPackage, GBCustomerSatisfactionPackage]; generalPackages.forEach(e => { logger.trace(`Loading package: ${e.name}...`); let p = Object.create(e.prototype) as IGBPackage; p.loadBot(min) }); // Specialized load for each min instance. cb(min, null); }); }); } /** Performs package deployment in all .gbai or default. */ public deployPackages(core: IGBCoreService, server: any, appPackages: Array, sysPackages: Array) { return new Promise((resolve, reject) => { try { var _this = this; let botsToProcess = 0, botsProcessed = 0; let additionalPath = GBConfigService.get("ADDITIONAL_DEPLOY_PATH"); let paths = [this.deployFolder]; if (additionalPath) { paths = paths.concat(additionalPath.toLowerCase().split(";")); } let botPackages = new Array(); let generalPackages = new Array(); function doIt(path) { const isDirectory = source => Fs.lstatSync(source).isDirectory() const getDirectories = source => Fs.readdirSync(source).map(name => Path.join(source, name)).filter(isDirectory) let dirs = getDirectories(path); dirs.forEach(element => { if (element.endsWith('.gbot')) { botPackages.push(element); } else { generalPackages.push(element); } }); } logger.trace(`Starting looking for generalPackages...`); paths.forEach(e => { logger.trace(`Looking in: ${e}...`); doIt(e) }); /** Deploys all .gbot files first. */ botPackages.forEach(e => { logger.trace(`Deploying bot: ${e}...`); this.deployer.deployBot(e, (data, err) => { botsProcessed++; }); }); /** Then all remaining generalPackages are loaded. */ generalPackages.forEach(filename => { let filenameOnly = Path.basename(filename); logger.trace(`Deploying package: ${filename}...`); /** Handles apps for general bots - .gbapp must stay out of deploy folder. */ if (Path.extname(filename) === ".gbapp" || Path.extname(filename) === ".gblib") { // Skips .gbapp inside deploy folder. if (!filename.startsWith('deploy')) { import(filename).then(m => { let p = new m.Package(); p.loadPackage(core); appPackages.push(p); logger.trace(`App (.gbapp) deployed: ${filenameOnly}.`); }); } /** Themes for bots. */ } else if (Path.extname(filename) === ".gbtheme") { server.use("/themes/" + filenameOnly, express.static(filename)); logger.trace(`Theme (.gbtheme) assets acessible at: ${"/themes/" + filenameOnly}.`); /** Knowledge base for bots. */ } else if (Path.extname(filename) === ".gbkb") { server.use( "/kb/" + filenameOnly + "/subjects", express.static(UrlJoin(filename, "subjects")) ); logger.trace(`KB (.gbkb) assets acessible at: ${"/kb/" + filenameOnly}.`); } else if (Path.extname(filename) === ".gbui" || filename.endsWith(".git")) { // Already Handled } /** Unknown package format. */ else { let err = new Error(`Package type not handled: ${filename}.`); reject(err); } botsProcessed++; }); WaitUntil() .interval(100) .times(50) .condition(function (cb) { logger.trace(`Waiting for package deployment...`); cb(botsProcessed == (generalPackages.length + botPackages.length)); }) .done(function (result) { logger.trace(`Package deployment done.`); resolve(); }); } catch (err) { reject(err) } }); } }