@forzalabs/remora 0.0.12

package/Constants.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const CONSTANTS = {
+    cliVersion: '0.0.1',
+    lambdaVersion: 1,
+    port: 5069
+};
+exports.default = CONSTANTS;

package/actions/automap.js

@@ -0,0 +1,73 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.automap = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const compile_1 = require("./compile");
+const AutoMapperEngine_1 = __importDefault(require("../engines/ai/AutoMapperEngine"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const Environment_1 = __importDefault(require("../engines/Environment"));
+const ProducerEngine_1 = __importDefault(require("../engines/ProducerEngine"));
+/**
+ * e.g. npm run automap -- myclaims Claim
+ */
+const automap = (producerName, schemaNames) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        (0, compile_1.compile)();
+        const spinner = (0, ora_1.default)(chalk_1.default.blue('Auto-mapping producer data...\n')).start();
+        // Get the producer
+        const producer = Environment_1.default.getProducer(producerName);
+        if (!producer) {
+            throw new Error(`Producer ${producerName} not found`);
+        }
+        // Get the specified schemas
+        const schemas = [];
+        for (const schemaName of schemaNames) {
+            const schema = Environment_1.default.getSchema(schemaName);
+            if (!schema) {
+                throw new Error(`Schema ${schemaName} not found`);
+            }
+            schemas.push(schema);
+        }
+        // Read and convert sample data
+        const sampleData = yield ProducerEngine_1.default.readSampleData(producer);
+        // Convert sample data to strings for AutoMapperEngine
+        const sampleStrings = sampleData.map(item => JSON.stringify(item));
+        // Call the automapper
+        const mapResult = yield AutoMapperEngine_1.default.map(sampleStrings, schemas);
+        // Create the producers based on the mapping
+        for (const producer of mapResult.producers) {
+            const producerPath = path_1.default.join('remora/producers', `${producer.name}.json`);
+            fs_1.default.writeFileSync(producerPath, JSON.stringify(producer, null, 4));
+            console.log(chalk_1.default.blue(`Created producer: ${producer.name}`));
+        }
+        // Create the consumers based on the mapping
+        for (const consumer of mapResult.consumers) {
+            const consumerPath = path_1.default.join('remora/consumers', `${consumer.name}.json`);
+            fs_1.default.writeFileSync(consumerPath, JSON.stringify(consumer, null, 4));
+            console.log(chalk_1.default.blue(`Created consumer: ${consumer.name}`));
+        }
+        spinner.succeed('Producer has been successfully mapped');
+        console.log(chalk_1.default.green(`\n✅ Created ${mapResult.producers.length} producers!`));
+        console.log(chalk_1.default.green(`✅ Created ${mapResult.consumers.length} consumers!`));
+        process.exit(0);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red.bold('\n❌ Unexpected error during automapping:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+exports.automap = automap;

package/actions/compile.js

@@ -0,0 +1,57 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compile = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const ora_1 = __importDefault(require("ora"));
+const Environment_1 = __importDefault(require("../engines/Environment"));
+const compile = () => __awaiter(void 0, void 0, void 0, function* () {
+    // TODO compile single file
+    let errors = [];
+    try {
+        const spinner = (0, ora_1.default)(chalk_1.default.blue('Validating project structure...')).start();
+        Environment_1.default.load('');
+        if (!fs_extra_1.default.existsSync('./remora'))
+            errors.push(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora'));
+        if (!fs_extra_1.default.existsSync('./remora/consumers'))
+            errors.push(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora/consumers'));
+        if (!fs_extra_1.default.existsSync('./remora/producers'))
+            errors.push(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora/producers'));
+        if (!fs_extra_1.default.existsSync('./remora/producers'))
+            errors.push(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora/producers'));
+        if (!fs_extra_1.default.existsSync('./remora/sources'))
+            errors.push(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora/sources'));
+        if (!fs_extra_1.default.existsSync('./remora/schemas'))
+            errors.push(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora/schemas'));
+        const envErrors = Environment_1.default.validate();
+        errors = [...errors, ...envErrors];
+        if (errors.length === 0) {
+            spinner.succeed(chalk_1.default.green('Project structure validated successfully'));
+            console.log(chalk_1.default.green.bold('\n✅ Compilation complete!'));
+        }
+        else {
+            spinner.fail(chalk_1.default.red('Validation failed with errors:'));
+            console.log('');
+            errors.forEach(error => console.log(chalk_1.default.red('• ' + error)));
+            console.log(chalk_1.default.red.bold('\n❌ Compilation aborted due to errors.'));
+            process.exit(1);
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.red.bold('\n❌ Unexpected error during validation:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+exports.compile = compile;

package/actions/debug.js

@@ -0,0 +1,61 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.debug = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const DriverFactory_1 = __importDefault(require("../drivers/DriverFactory"));
+const Environment_1 = __importDefault(require("../engines/Environment"));
+const compile_1 = require("./compile");
+const debug = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        (0, compile_1.compile)();
+        console.log('\n');
+        const spinner = (0, ora_1.default)({ text: '⏳ Checking producers connections...', color: 'blue' }).start();
+        const producers = Environment_1.default._env.producers;
+        const failures = [];
+        for (const producer of producers) {
+            spinner.text = `🔍 Testing producer "${producer.name}" (source: ${producer.source})`;
+            const source = Environment_1.default.getSource(producer.source);
+            const driver = yield DriverFactory_1.default.instantiateSource(source);
+            const canConnect = yield driver.exist(producer);
+            if (canConnect) {
+                spinner.succeed(`Producer "${producer.name}" connected successfully.`);
+            }
+            else {
+                spinner.fail(chalk_1.default.red(`✖ Producer "${producer.name}" failed to connect.`));
+                failures.push(producer.name);
+            }
+            // Avoid restarting the spinner unless needed
+            if (producer !== producers[producers.length - 1]) {
+                spinner.start();
+            }
+        }
+        if (failures.length > 0) {
+            console.log(chalk_1.default.red.bold(`\n‼ ${failures.length} producer(s) could not connect:`));
+            failures.forEach(name => console.log(chalk_1.default.yellow(`  • ${name}`)));
+            process.exit(1);
+        }
+        else {
+            // Stop spinner silently (no ✔ line)
+            spinner.stop();
+            console.log(chalk_1.default.green.bold('\n🎉 All producers are up and running!'));
+        }
+    }
+    catch (err) {
+        console.error(chalk_1.default.red.bold('\n❌ Unexpected error during debug:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+exports.debug = debug;

package/actions/deploy.js

@@ -0,0 +1,95 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deploy = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_1 = __importDefault(require("fs"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const path_1 = __importDefault(require("path"));
+const Constants_1 = __importDefault(require("../Constants"));
+const deploy = (options) => __awaiter(void 0, void 0, void 0, function* () {
+    console.log(chalk_1.default.blue.bold(`🚀 Deploying to ${options.env}...`));
+    try {
+        const rootDir = './remora';
+        if (!fs_1.default.existsSync('./remora'))
+            throw new Error(chalk_1.default.red('Missing directory: ') + chalk_1.default.yellow('./remora'));
+        const zip = new adm_zip_1.default();
+        // Function to recursively add files to zip
+        const addDirectoryToZip = (directoryPath, zipPath = '') => {
+            const files = fs_1.default.readdirSync(directoryPath);
+            files.forEach(file => {
+                const fullPath = path_1.default.join(directoryPath, file);
+                const stat = fs_1.default.statSync(fullPath);
+                if (file === 'temp')
+                    return;
+                if (stat.isDirectory()) {
+                    addDirectoryToZip(fullPath, path_1.default.join(zipPath, file));
+                }
+                else {
+                    const fileContent = fs_1.default.readFileSync(fullPath);
+                    zip.addFile(path_1.default.join(zipPath, file), fileContent);
+                }
+            });
+        };
+        addDirectoryToZip(rootDir);
+        // Write the zip file to a temporary location
+        const tempZipPath = path_1.default.join(process.cwd(), 'temp_deployment.zip');
+        zip.writeZipPromise(tempZipPath)
+            .then(() => __awaiter(void 0, void 0, void 0, function* () {
+            try {
+                // Read the zip file as a buffer
+                const zipBuffer = fs_1.default.readFileSync(tempZipPath);
+                const host = process.env.REMORA_WORKER_HOST;
+                const version = Constants_1.default.lambdaVersion;
+                const workerAPI = `${host}/cli/v${version}/uploaddeployment`;
+                const formData = new FormData();
+                const blob = new Blob([zipBuffer], { type: 'application/zip' });
+                formData.append('remora_config', blob, 'temp_deployment.zip'); // Updated to match the actual file name
+                const apiKey = process.env.REMORA_LICENCE_KEY;
+                if (!apiKey)
+                    throw new Error('REMORA_LICENCE_KEY environment variable is not set');
+                console.log('workerAPI', workerAPI);
+                const response = yield fetch(workerAPI, {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Bearer ${apiKey}`
+                    },
+                    body: formData
+                });
+                if (!response.ok) {
+                    throw new Error(`Upload failed with status ${response.status}: ${yield response.text()}`);
+                }
+                console.log(chalk_1.default.green('✅ Deployment package uploaded successfully'));
+            }
+            finally {
+                // Clean up the temporary zip file
+                fs_1.default.unlinkSync(tempZipPath);
+            }
+        }))
+            .catch(error => {
+            throw error;
+        });
+        // TODO
+        // Check if exist remora worker
+        // if not pull remora image and doker compose up
+        // compile
+        // upload configuration into rw
+        // create consumers tath require creation ( view, materialized view )
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Deployment error:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+exports.deploy = deploy;

package/actions/discover.js

@@ -0,0 +1,36 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discover = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const Environment_1 = __importDefault(require("../engines/Environment"));
+const compile_1 = require("./compile");
+const DeveloperEngine_1 = __importDefault(require("../engines/ai/DeveloperEngine"));
+const discover = (producerName) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        (0, compile_1.compile)();
+        const spinner = (0, ora_1.default)(chalk_1.default.blue('Discovering producer...\n')).start();
+        const producer = Environment_1.default.getProducer(producerName);
+        yield DeveloperEngine_1.default.discover(producer);
+        spinner.succeed('Producer has been successfully discovered');
+        console.log(chalk_1.default.green('\n✅ Discovery complete!'));
+        process.exit(1);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red.bold('\n❌ Unexpected error during discover:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+exports.discover = discover;

package/actions/init.js

@@ -0,0 +1,78 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const ora_1 = __importDefault(require("ora"));
+const path_1 = __importDefault(require("path"));
+const init = () => __awaiter(void 0, void 0, void 0, function* () {
+    // TODO init single folder
+    console.log(chalk_1.default.blue.bold('📦 Initializing your application...'));
+    try {
+        const spinner = (0, ora_1.default)('Creating configuration files...').start();
+        const directories = [
+            'remora',
+            'remora/consumers',
+            'remora/producers',
+            'remora/schemas',
+            'remora/sources'
+        ];
+        const defaultSource = fs_extra_1.default.readFileSync(path_1.default.join(__dirname, `../documentation/default_resources/source.json`), 'utf-8');
+        const defaultConsumer = fs_extra_1.default.readFileSync(path_1.default.join(__dirname, `../documentation/default_resources/consumer.json`), 'utf-8');
+        const defaultProducer = fs_extra_1.default.readFileSync(path_1.default.join(__dirname, `../documentation/default_resources/producer.json`), 'utf-8');
+        const defaultSchema = fs_extra_1.default.readFileSync(path_1.default.join(__dirname, `../documentation/default_resources/schema.json`), 'utf-8');
+        const defaultRemoraProject = fs_extra_1.default.readFileSync(path_1.default.join(__dirname, `../documentation/default_resources/project.json`), 'utf-8');
+        const readme = fs_extra_1.default.readFileSync(path_1.default.join(__dirname, `../documentation/README.md`), 'utf-8');
+        const files = [
+            { path: 'remora/sources/.gitkeep', content: '' },
+            { path: 'remora/sources/default-source.json', content: defaultSource },
+            { path: 'remora/consumers/.gitkeep', content: '' },
+            { path: 'remora/consumers/default-consumer.json', content: defaultConsumer },
+            { path: 'remora/producers/.gitkeep', content: '' },
+            { path: 'remora/producers/default-producer.json', content: defaultProducer },
+            { path: 'remora/schemas/.gitkeep', content: '' },
+            { path: 'remora/schemas/default-schemas.json', content: defaultSchema },
+            { path: 'remora/project.json', content: defaultRemoraProject },
+            { path: 'remora/README.md', content: readme }
+        ];
+        for (let i = 0; i < directories.length; i++) {
+            const dir = directories[i];
+            yield fs_extra_1.default.ensureDir(dir);
+        }
+        for (let i = 0; i < files.length; i++) {
+            const file = files[i];
+            yield fs_extra_1.default.ensureFile(file.path);
+            yield fs_extra_1.default.writeFile(file.path, file.content);
+        }
+        spinner.succeed('Remora configuration files successfully created.');
+        console.log(chalk_1.default.green('✅ Initialization complete!'));
+        console.log(chalk_1.default.green('📁 A new folder named ') + chalk_1.default.cyan('remora/') + chalk_1.default.green(' has been created in your project.'));
+        console.log(chalk_1.default.green('✏️  Customize the generated configuration files inside this folder to setup Remora.'));
+        console.log(chalk_1.default.green('\n👣 Next steps: configure your environment variables.'));
+        console.log(chalk_1.default.green('\n🔧 Local development (add these to your .env file):'));
+        console.log(chalk_1.default.blue('• REMORA_WORKER_HOST') + chalk_1.default.gray(' → URL of your Remora Worker instance'));
+        console.log(chalk_1.default.blue('• REMORA_LICENCE_KEY') + chalk_1.default.gray(' → Your valid Remora license key'));
+        console.log(chalk_1.default.green('\n🔐 Production environment (store these in your Secret Manager):'));
+        console.log(chalk_1.default.yellow('• ROOT_TEMP_PASSWORD') + chalk_1.default.gray(' → Temporary root password for first-time setup'));
+        console.log(chalk_1.default.yellow('• INSTALLATION_ID') + chalk_1.default.gray(' → Unique ID for this installation instance'));
+        console.log(chalk_1.default.yellow('• ADMIN_JWT_SECRET') + chalk_1.default.gray(' → JWT secret for admin-level access'));
+        console.log(chalk_1.default.yellow('• JWT_SECRET') + chalk_1.default.gray(' → JWT secret for regular user authentication'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red('❌ Error during initialization:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+exports.init = init;

package/actions/run.js

@@ -0,0 +1,51 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const Environment_1 = __importDefault(require("../engines/Environment"));
+const UserManager_1 = __importDefault(require("../engines/UserManager"));
+const ConsumerEngine_1 = __importDefault(require("../engines/consumer/ConsumerEngine"));
+const compile_1 = require("./compile");
+const run = (options, consumersName) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        (0, compile_1.compile)();
+        const spinner = (0, ora_1.default)(chalk_1.default.blue('Run Consumers...\n')).start();
+        const consumersToExecute = (consumersName && consumersName.length > 0) ? [Environment_1.default.getConsumer(consumersName)] : Environment_1.default._env.consumers;
+        const user = UserManager_1.default.getUser();
+        const results = [];
+        for (let i = 0; i < consumersToExecute.length; i++) {
+            const consumer = consumersToExecute[i];
+            const response = yield ConsumerEngine_1.default.execute(consumer, {}, user);
+            results.push({ consumer, response });
+        }
+        spinner.succeed('All consumers have been successfully executed');
+        results.forEach(result => {
+            if (result.response.fileUri) {
+                console.log(chalk_1.default.green(`• Consumer ${result.consumer.name} -> ${result.response.fileUri}`));
+            }
+            else {
+                console.log(chalk_1.default.green(`• Consumer ${result.consumer.name} -> ${result.response.data.slice(0, 5).join('\n')}`));
+            }
+        });
+        console.log(chalk_1.default.green('\n✅ Initialization complete!'));
+        process.exit(1);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red.bold('\n❌ Unexpected error during run:'), err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+exports.run = run;

package/auth/AdminManager.js

@@ -0,0 +1,48 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Affirm_1 = __importDefault(require("../core/Affirm"));
+const DatabaseEngine_1 = __importDefault(require("../database/DatabaseEngine"));
+const UserManager_1 = __importDefault(require("../engines/UserManager"));
+const Settings_1 = __importDefault(require("../helper/Settings"));
+const bcryptjs_1 = __importDefault(require("bcryptjs"));
+const JWTManager_1 = __importDefault(require("./JWTManager"));
+class AdminManagerClass {
+    constructor() {
+        this.COLLECTION = Settings_1.default.db.collections.users;
+        this.rootSignIn = (password) => __awaiter(this, void 0, void 0, function* () {
+            (0, Affirm_1.default)(password, 'Invalid password');
+            const rootUser = yield DatabaseEngine_1.default.findOne(this.COLLECTION, { isRoot: true });
+            (0, Affirm_1.default)(rootUser, 'Incorrect system configuration: root user not found');
+            const isSame = yield bcryptjs_1.default.compare(password, rootUser.rootPasswordHash);
+            if (!isSame)
+                throw new Error('Invalid credentials');
+            rootUser.lastLogin = new Date().toJSON();
+            yield UserManager_1.default.update(rootUser);
+            const adminSecret = process.env.ADMIN_JWT_SECRET;
+            (0, Affirm_1.default)(adminSecret, 'Wrong system config: missing admin jwt secret');
+            const payload = {
+                apiKeyId: rootUser._id,
+                installationId: process.env.INSTALLATION_ID,
+                name: rootUser.name,
+                scopes: { consumers: ['*'], projects: ['*'] },
+                isAdmin: true
+            };
+            const token = JWTManager_1.default.issue(adminSecret, payload, 8);
+            return token;
+        });
+    }
+}
+const AdminManager = new AdminManagerClass();
+exports.default = AdminManager;

package/auth/ApiKeysManager.js

@@ -0,0 +1,45 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const Affirm_1 = __importDefault(require("../core/Affirm"));
+const DatabaseEngine_1 = __importDefault(require("../database/DatabaseEngine"));
+const Helper_1 = __importDefault(require("../helper/Helper"));
+const Settings_1 = __importDefault(require("../helper/Settings"));
+const JWTManager_1 = __importDefault(require("./JWTManager"));
+class ApiKeysManagerClass {
+    constructor() {
+        this.COLLECTION = Settings_1.default.db.collections.apiKeys;
+        this.create = (name, scopes) => __awaiter(this, void 0, void 0, function* () {
+            (0, Affirm_1.default)(name, 'Invalid name');
+            const apiKeyId = Helper_1.default.uuid();
+            const apiSecret = JWTManager_1.default.sign(apiKeyId, name, scopes);
+            const newApiKey = {
+                _id: apiKeyId,
+                _signature: '',
+                createdAt: new Date().toJSON(),
+                isActive: true,
+                name: name,
+                scopes: scopes,
+                value: apiSecret
+            };
+            return yield DatabaseEngine_1.default.upsert(this.COLLECTION, newApiKey._id, newApiKey);
+        });
+        this.get = (apiKeyId) => __awaiter(this, void 0, void 0, function* () {
+            (0, Affirm_1.default)(apiKeyId, 'Invalid api key id');
+            return yield DatabaseEngine_1.default.get(this.COLLECTION, apiKeyId);
+        });
+    }
+}
+const ApiKeysManager = new ApiKeysManagerClass();
+exports.default = ApiKeysManager;

package/auth/JWTManager.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+const Affirm_1 = __importDefault(require("../core/Affirm"));
+//
+class JWTManagerClass {
+    constructor() {
+        // ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!!⚠️ ATTENTION!!
+        // ATTENTION!! The remoteSecretKey is saved in CLEAR text because we are studying a way to not make it visible to the customer. ATTENTION!!
+        // ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!! ⚠️ ATTENTION!!⚠️ ATTENTION!!
+        this.remoraSecretKey = 'violetevergardenisaworkofart';
+        this.issue = (secret, payload, expirationHours) => {
+            return jsonwebtoken_1.default.sign(payload, secret, { expiresIn: `${expirationHours}h` });
+        };
+        this.sign = (apiKeyId, name, scopes) => {
+            (0, Affirm_1.default)(apiKeyId, 'Invalid api key id');
+            (0, Affirm_1.default)(name, 'Invalid name');
+            (0, Affirm_1.default)(scopes, 'Invalid scopes');
+            const JWT_SECRET = process.env.JWT_SECRET;
+            const INSTALLATION_ID = process.env.INSTALLATION_ID;
+            (0, Affirm_1.default)(JWT_SECRET, 'Invalid JWT SECRET');
+            (0, Affirm_1.default)(INSTALLATION_ID, 'Invalid INSTALLATION ID');
+            const payload = {
+                apiKeyId: apiKeyId,
+                installationId: INSTALLATION_ID,
+                name: name,
+                scopes: scopes
+            };
+            return jsonwebtoken_1.default.sign(payload, JWT_SECRET, { expiresIn: '365000d' });
+        };
+        this.verify = (token) => {
+            (0, Affirm_1.default)(token, 'Invalid token');
+            const JWT_SECRET = process.env.JWT_SECRET;
+            (0, Affirm_1.default)(JWT_SECRET, 'Invalid JWT SECRET');
+            return jsonwebtoken_1.default.verify(token, JWT_SECRET);
+        };
+        this.verifyAdmin = (token) => {
+            (0, Affirm_1.default)(token, 'Invalid token');
+            const ADMIN_JWT_SECRET = process.env.ADMIN_JWT_SECRET;
+            (0, Affirm_1.default)(ADMIN_JWT_SECRET, 'Invalid ADMIN JWT SECRET');
+            return jsonwebtoken_1.default.verify(token, ADMIN_JWT_SECRET);
+        };
+        this.verifyCLI = (token) => {
+            (0, Affirm_1.default)(token, 'Invalid token');
+            // ⚠️ ATTENTION!! The remoteSecretKey is saved in clear text because we are studying a way to not make it visible to the customer. ATTENTION!!
+            const REMORA_KEY_SECRET = this.remoraSecretKey; // process.env.REMORA_KEY_SECRET
+            (0, Affirm_1.default)(REMORA_KEY_SECRET, 'Invalid CLI JWT SECRET');
+            return jsonwebtoken_1.default.verify(token, REMORA_KEY_SECRET);
+        };
+    }
+}
+const JWTManager = new JWTManagerClass();
+exports.default = JWTManager;