botql 1.0.0 → 1.0.2

package/Bootstrap.js

@@ -0,0 +1,74 @@
+'use strict';
+
+/**
+ * Bootstrap.js — ponto de entrada do BotQL.
+ *
+ * Lê um ficheiro .sql (com suporte a IMPORT), cria o interpreter, liga os
+ * connectors reais das plataformas usadas via CONNECT, corre ON START e
+ * fica pronto a receber mensagens.
+ *
+ * Uso:
+ *   node Bootstrap.js caminho/para/bot.sql
+ *
+ * Uso programático:
+ *   const { bootstrap } = require('./Bootstrap.js');
+ *   const bot = await bootstrap('bot.sql');
+ *   await bot.receiveMessage('+244900000000', 'quero comprar');
+ */
+
+const path = require('path');
+const { BotQLInterpreter } = require('./botql.js');
+const { ConnectorRegistry, attachConnectors } = require('./Connectors.js');
+const { SQLiteDatabase } = require('./Database.js');
+
+/**
+ * @param {string} sqlFilePath Caminho do ficheiro .sql principal do bot.
+ * @param {object} options
+ * @param {string} [options.dbPath] Caminho do ficheiro .sqlite. Sem isto,
+ *   usa MemoryDatabase (sem persistência), que é o omisso do interpreter.
+ * @param {string} [options.connectorsPath] Caminho alternativo para o JSON
+ *   de connectors. Por omissão usa o Connectors.json ao lado deste ficheiro.
+ * @param {boolean} [options.autoStart] Corre ON START automaticamente (omissão: true).
+ */
+async function bootstrap(sqlFilePath, options = {}) {
+    const interpreterOptions = {};
+    if (options.dbPath) {
+        interpreterOptions.db = new SQLiteDatabase(options.dbPath);
+    }
+
+    const bot = BotQLInterpreter.fromFile(sqlFilePath, interpreterOptions);
+
+    const registry = new ConnectorRegistry(
+        options.connectorsPath || path.join(__dirname, 'Connectors.json')
+    );
+    attachConnectors(bot, registry);
+
+    if (options.autoStart !== false) {
+        await bot.start();
+    }
+
+    return bot;
+}
+
+// Execução direta: node Bootstrap.js caminho/bot.sql
+if (require.main === module) {
+    const sqlFilePath = process.argv[2];
+    if (!sqlFilePath) {
+        console.error('Uso: node Bootstrap.js caminho/para/bot.sql');
+        process.exit(1);
+    }
+
+    bootstrap(sqlFilePath)
+        .then((bot) => {
+            console.log(`BotQL: bot "${bot.botName || '(sem nome)'}" iniciado.`);
+            if (!bot.running) {
+                console.log('Aviso: o ficheiro não tem "RUN BOT" — o bot foi carregado mas não marcado como em execução.');
+            }
+        })
+        .catch((err) => {
+            console.error(err.message);
+            process.exit(1);
+        });
+}
+
+module.exports = { bootstrap };

package/Connectors.json

@@ -0,0 +1,17 @@
+{
+    "TELEGRAM": "./connectors/telegram.js",
+    "WHATSAPP": "./connectors/whatsapp.js",
+    "DISCORD": "./connectors/discord.js",
+    "SLACK": "./connectors/slack.js",
+    "MESSENGER": "./connectors/messenger.js",
+    "INSTAGRAM": "./connectors/instagram.js",
+    "TWITTER": "./connectors/twitter.js",
+    "SMS": "./connectors/sms.js",
+    "EMAIL": "./connectors/email.js",
+    "WEBHOOK": "./connectors/webhook.js",
+    "VIBER": "./connectors/viber.js",
+    "LINE": "./connectors/line.js",
+    "WECHAT": "./connectors/wechat.js",
+    "MATRIX": "./connectors/matrix.js",
+    "GOOGLECHAT": "./connectors/googlechat.js"
+}

package/botql-mode.js

@@ -0,0 +1,72 @@
+'use strict';
+
+/**
+ * Modo BotQL para CodeMirror 5 (addon/mode/simple.js).
+ *
+ * Usa exatamente a mesma lista de keywords do Parser.js (KEYWORDS),
+ * para nunca desalinhar highlight vs. sintaxe real aceite pelo parser.
+ *
+ * Uso (depois de incluir codemirror.js, mode/sql/sql.js NÃO é necessário,
+ * e addon/mode/simple.js):
+ *
+ *   <script src="codemirror.js"></script>
+ *   <script src="addon/mode/simple.js"></script>
+ *   <script src="botql-mode.js"></script>
+ *
+ *   const editor = CodeMirror(document.body, {
+ *       mode: "botql",
+ *       theme: "default"
+ *   });
+ */
+
+// Mesma lista do Parser.js — SQL real (CREATE, INSERT, UPDATE, ...)
+// e BotQL (ON, WHEN, REPLY, ...) juntas, porque highlight não separa
+// os dois mundos: é uma linguagem só.
+const BOTQL_KEYWORDS = [
+    'CREATE', 'BOT', 'PLATFORM', 'CONNECT', 'TABLE', 'PREVENT', 'DEFAULT',
+    'ON', 'START', 'MESSAGE', 'FROM',
+    'WHEN', 'CONTAINS', 'OR', 'OTHERWISE',
+    'REPLY', 'TO', 'FORWARD', 'PARSE', 'SEND',
+    'INSERT', 'INTO', 'VALUES', 'UPDATE', 'SET', 'WHERE',
+    'IMPORT', 'RUN'
+];
+
+// Palavras especiais que merecem cor própria por serem "mágicas"
+// no interpreter (botql.js), não por serem sintaxe da gramática.
+const BOTQL_BUILTINS = ['Context', 'NOW', 'LAST_INSERT_ID'];
+
+// Variáveis implícitas do runtime (client, message, lastMsg, SIGNAL).
+const BOTQL_VARS = ['client', 'message', 'lastMsg', 'SIGNAL'];
+
+function defineBotQLMode(CodeMirror) {
+    const keywordRegex = new RegExp('^(?:' + BOTQL_KEYWORDS.join('|') + ')\\b');
+    const builtinRegex = new RegExp('^(?:' + BOTQL_BUILTINS.join('|') + ')\\b');
+    const varRegex = new RegExp('^(?:' + BOTQL_VARS.join('|') + ')\\b');
+
+    CodeMirror.defineSimpleMode('botql', {
+        start: [
+            { regex: /--.*/, token: 'comment' },
+            { regex: /"(?:[^"\\]|\\.)*"?/, token: 'string' },
+            { regex: /'(?:[^'\\]|\\.)*'?/, token: 'string' },
+            { regex: /\b\d+(?:\.\d+)?\b/, token: 'number' },
+            { regex: keywordRegex, token: 'keyword' },
+            { regex: builtinRegex, token: 'builtin' },
+            { regex: varRegex, token: 'variable-2' },
+            { regex: /[A-Za-z_]\w*(?=\s*\()/, token: 'variable-2' }, // chamadas: NOME(
+            { regex: /[{}]/, token: 'bracket' },
+            { regex: /[()]/, token: 'bracket' },
+            { regex: /[+=,.]/, token: 'operator' },
+            { regex: /[A-Za-z_]\w*/, token: 'variable' }
+        ],
+        meta: {
+            lineComment: '--'
+        }
+    });
+}
+
+if (typeof module !== 'undefined' && module.exports) {
+    module.exports = { defineBotQLMode, BOTQL_KEYWORDS, BOTQL_BUILTINS, BOTQL_VARS };
+}
+if (typeof window !== 'undefined' && window.CodeMirror) {
+    defineBotQLMode(window.CodeMirror);
+}