bpm-core 0.0.131 → 0.0.132

package/README.md

@@ -1,7 +1,7 @@
-> ⚠️ **Important Notice**  
-> Starting from **`bpm-core@0.0.121`**, **Angular 19** is required.
+## ⚠️ Read Before Upgrading
 
-> Ensure your project is updated to Angular 19 to avoid compatibility issues.
+- Update your project to **Angular 19** to avoid compatibility issues.  
+- Review the [Changes Log](#changes-log) for breaking changes and apply necessary updates.
 
 ---
 
@@ -16,7 +16,8 @@
 
 ---
 
-## [Recently Added Features](#recently-added-features)
+## Recently Added Features
+
 - ### [BPM Core CLI](#bpm-core-cli)
   A command-line interface tool that provides helper scripts to speed up common tasks.
 
@@ -247,18 +248,22 @@
   ```
   </details> 
 
-## [Changes Log](#changes-log)
+## Changes Log
+
+<a id="bpm-core00132-2025-10-06"></a>
+### [bpm-core@0.0.132 — 2025-10-06](#bpm-core00132-2025-10-06)
+- fix(npm): resolve npm install issues.
 
 <a id="bpm-core00130-2025-09-18"></a>
 ### [bpm-core@0.0.130 — 2025-09-18](#bpm-core00130-2025-09-18)
 - feat(cli): add `generate new` command to generate an initial service from a config like the form builder.
 - fix(cli/mock-data): restructure LOVs in payload and enhance logged path generation.
-- [BREAKING CHANGE] fix(custom-searchable): update the default value of the `key` input property to 'value' (was 'description').
+- **[BREAKING CHANGE]** fix(custom-searchable): update the default value of the `key` input property to 'value' (was 'description').
 - feat(radio): activate and enhance radio component.
 - refactor: remove ngx-translate package.
-- [BREAKING CHANGE] refactor(input & textarea): remove 'enOnly' and 'arOnly' type values, use filterFn instead.
+- **[BREAKING CHANGE]** refactor(input & textarea): remove 'enOnly' and 'arOnly' type values, use filterFn instead.
 - fix(input-number): prevent dropping text into input number.
-- [BREAKING CHANGE] refactor(attachment-section): replace `isRequired` input with `descriptionRequired` input and add `commentsRequired` input.
+- **[BREAKING CHANGE]** refactor(attachment-section): replace `isRequired` input with `descriptionRequired` input and add `commentsRequired` input.
 - fix(attachment-section): hide label in read-only mode if no attachments.
 - fix(custom-searchable): add padding for search and clear icons in RTL.
 - feat(input): add `maxLength` input property.

package/cli/deploy/build.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LibraryBuild = exports.Build = void 0;
+const utilities_1 = require("../utilities/utilities");
+const fs = __importStar(require("fs"));
+class Build {
+    constructor() { }
+    async runBuild(servicePath) {
+        await this.runNgBuild(servicePath);
+        this.renameBuildFiles(servicePath);
+        this.removeUnneededBuildFiles(servicePath);
+    }
+}
+exports.Build = Build;
+class LibraryBuild extends Build {
+    runNgBuild(servicePath) {
+        return (0, utilities_1.runCommand)('npx ng build --aot -c production --output-hashing none', servicePath);
+    }
+    isWebpackBuildRequired() {
+        return false;
+    }
+    renameBuildFiles(servicePath) {
+        const filesToRenameAfterBuild = [
+            { from: `${servicePath}/dist/main.js`, to: `${servicePath}/dist/wm-main.bundle.js` },
+            { from: `${servicePath}/dist/styles.css`, to: `${servicePath}/dist/wm-styles.bundle.css` },
+            { from: `${servicePath}/dist/polyfills.js`, to: `${servicePath}/dist/wm-polyfills.bundle.js` },
+            { from: `${servicePath}/dist/scripts.js`, to: `${servicePath}/dist/wm-scripts.bundle.js` },
+            { from: `${servicePath}/dist/runtime.js`, to: `${servicePath}/dist/wm-inline.bundle.js` }
+        ];
+        filesToRenameAfterBuild.forEach(item => fs.renameSync(item.from, item.to));
+    }
+    removeUnneededBuildFiles(servicePath) {
+        const scssDirPath = `${servicePath}/dis/assets/scss`;
+        if (fs.existsSync(scssDirPath)) {
+            fs.rmdirSync(scssDirPath, { recursive: true });
+        }
+    }
+}
+exports.LibraryBuild = LibraryBuild;

package/cli/deploy/git-operations-handler.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitOperationsHandler = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const util_1 = require("util");
+const child_process_1 = require("child_process");
+const utilities_1 = require("../utilities/utilities");
+class GitOperationsHandler {
+    constructor() { }
+    async sync(localBuildRepoPath, serviceRemoteDir, servicePath, commitMessage, logger, env) {
+        if (await this.getCurrentBranch(localBuildRepoPath) !== env) {
+            throw new Error(`Current branch in build repo is not "${env}". Please switch to the correct branch and try again.`);
+        }
+        logger.log('Pulling latest changes from remote repo...');
+        await this.pull(localBuildRepoPath);
+        logger.log('Copying build files to service directory in build repo...');
+        await this.copyBuildFilesToServiceDirInBuildRepo(localBuildRepoPath, serviceRemoteDir, servicePath);
+        logger.log(`Files copied from "${servicePath}" to "${path.join(localBuildRepoPath, serviceRemoteDir)}".`);
+        logger.log('Committing changes to local build repo...');
+        await this.commit(localBuildRepoPath, commitMessage);
+        logger.log('Pushing changes to remote repo...');
+        await this.push(localBuildRepoPath);
+    }
+    async pull(localBuildRepoPath) {
+        return await (0, utilities_1.runCommand)('git pull', localBuildRepoPath);
+    }
+    copyBuildFilesToServiceDirInBuildRepo(localBuildRepoPath, serviceDirNameInBuildRepo, servicePath) {
+        const from = path.join(servicePath, 'dist');
+        const to = path.join(localBuildRepoPath, serviceDirNameInBuildRepo);
+        return this.copyFiles(from, to);
+    }
+    async commit(localBuildRepoPath, commitMessage) {
+        const execAsync = (0, util_1.promisify)(child_process_1.exec);
+        try {
+            const { stdout: status } = await execAsync('git status --porcelain', { cwd: localBuildRepoPath });
+            if (status.trim().length === 0) {
+                throw new Error('No changes to commit');
+            }
+            await execAsync('git add .', { cwd: localBuildRepoPath });
+            await execAsync(`git commit -m "${commitMessage}"`, { cwd: localBuildRepoPath });
+        }
+        catch (error) {
+            throw new Error('Failed to commit', { cause: error });
+        }
+    }
+    push(localBuildRepoPath) {
+        return (0, utilities_1.runCommand)('git push', localBuildRepoPath);
+    }
+    async copyFiles(srcDir, destDir) {
+        try {
+            await fs.promises.mkdir(destDir, { recursive: true });
+            const items = await fs.promises.readdir(srcDir, { withFileTypes: true });
+            for (const item of items) {
+                const srcPath = path.join(srcDir, item.name);
+                const destPath = path.join(destDir, item.name);
+                if (item.isDirectory()) {
+                    await this.copyFiles(srcPath, destPath);
+                }
+                else {
+                    await fs.promises.copyFile(srcPath, destPath);
+                }
+            }
+        }
+        catch (error) {
+            const errorMsg = `Error copying files: ${error.message}`;
+            throw Error(errorMsg);
+        }
+    }
+    async getCurrentBranch(localBuildRepoPath) {
+        const execAsync = (0, util_1.promisify)(child_process_1.exec);
+        try {
+            const { stdout: currentBranch } = await execAsync('git rev-parse --abbrev-ref HEAD', { cwd: localBuildRepoPath });
+            return currentBranch.trim();
+        }
+        catch (error) {
+            throw new Error('Failed to get current branch', { cause: error });
+        }
+    }
+}
+exports.GitOperationsHandler = GitOperationsHandler;

package/cli/deploy/index.js

@@ -0,0 +1,61 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deployCommand = void 0;
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const build_1 = require("./build");
+const git_operations_handler_1 = require("./git-operations-handler");
+const jenkins_manager_1 = require("./jenkins-manager");
+const utilities_1 = require("../utilities/utilities");
+exports.deployCommand = new commander_1.Command('deploy');
+exports.deployCommand
+    .description('Deploy a service to a specific environment, deployment process includes building the service, syncing with the remote repository, and running a Jenkins job if credentials are provided.')
+    .requiredOption('--env <string>', 'The env you want to deploy to it (dev, sit, or bat)')
+    .requiredOption('--repo-path <string>', 'The path for the local build repo make sure it is switched to env branch you want to deploy to it')
+    .requiredOption('--commit-msg <string>', 'The commit message for the changes you want to commit to the build repo')
+    .requiredOption('--remote-dir <string>', 'The remote directory name in the build repo where the service files will be copied to')
+    .option('--skip-build', 'Skip Angular build (optional)', false)
+    .option('--username <string>', 'Jenkins username (optional, if not provided Jenkins job will not run)')
+    .option('--token <string>', 'Jenkins token or password (optional, if not provided Jenkins job will not run)')
+    .action(async (options) => {
+    const cwd = process.cwd();
+    const serviceName = path.basename(cwd);
+    const env = (0, utilities_1.parseEnv)(options.env);
+    const logger = new utilities_1.Logger();
+    try {
+        if (!options.skipBuild) {
+            await logger.asyncLog('Building...')(new build_1.LibraryBuild().runBuild(cwd), 'Build Done.', 'Build Failed.');
+        }
+        await logger.asyncLog('Syncing with the remote repo...')(new git_operations_handler_1.GitOperationsHandler().sync(options.repoPath, options.remoteDir, cwd, options.commitMsg, logger, env), 'Sync Done.', 'Sync Failed.');
+        if (options.username && options.token) {
+            await logger.asyncLog('Running Jenkins job...')(new jenkins_manager_1.JenkinsManager().run(options.username, options.token, env, logger), 'Jenkins Job Done.', 'Failed to run Jenkins job.');
+            logger.success(`${serviceName.toLocaleUpperCase()} deployed to ${options.env.toUpperCase()} successfully.`);
+        }
+    }
+    catch (err) {
+        console.log(`${err.message} ${(err.cause?.message || err.cause) ? 'because ' + (err.cause?.message || err.cause) : ''}`);
+    }
+});

package/cli/deploy/jenkins-manager.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JenkinsManager = void 0;
+class JenkinsManager {
+    async run(username, token, env, logger) {
+        const jobName = this.getJobName(env);
+        try {
+            const buildNumber = await this.triggerJenkinsAndGetBuildNumber(username, token, jobName, logger);
+            await this.waitForBuildToFinish(buildNumber, username, token, jobName, logger);
+        }
+        catch (err) {
+            throw new Error(`Failed to run Jenkins job`, { cause: err });
+        }
+    }
+    async triggerJenkinsAndGetBuildNumber(username, token, jobName, logger) {
+        const JENKINS_URL = 'http://172.20.151.119:9090';
+        const auth = btoa(`${username}:${token}`);
+        try {
+            const triggerResponse = await fetch(`${JENKINS_URL}/job/${jobName}/build`, {
+                method: 'POST',
+                headers: {
+                    'Authorization': `Basic ${auth}`
+                },
+                redirect: 'manual'
+            });
+            if (triggerResponse.status !== 201) {
+                throw new Error(`Failed to trigger build:, ${triggerResponse.statusText}`);
+            }
+            const queueUrl = triggerResponse.headers.get('Location');
+            if (!queueUrl) {
+                throw new Error('No queue URL returned');
+            }
+            logger.log(`Build queued.`);
+            let buildNumber = null;
+            const maxAttempts = 20;
+            const delay = 3000;
+            for (let attempt = 0; attempt < maxAttempts; attempt++) {
+                const queueRes = await fetch(`${queueUrl}api/json`, {
+                    headers: {
+                        'Authorization': `Basic ${auth}`
+                    }
+                });
+                const queueData = await queueRes.json();
+                if (queueData.executable && queueData.executable.number) {
+                    buildNumber = queueData.executable.number;
+                    break;
+                }
+                logger.log(`Waiting for build to start... (${attempt + 1})`);
+                await new Promise(resolve => setTimeout(resolve, delay));
+            }
+            if (buildNumber) {
+                logger.log(`Build started with number: ${buildNumber}`);
+                return buildNumber;
+            }
+            else {
+                throw new Error('Failed to get build number.');
+            }
+        }
+        catch (err) {
+            throw new Error(`Error triggering Jenkins build: ${err.message}`);
+        }
+    }
+    async waitForBuildToFinish(buildNumber, username, token, jobName, logger) {
+        const JENKINS_URL = 'http://172.20.151.119:9090';
+        const auth = btoa(`${username}:${token}`);
+        const maxAttempts = 40;
+        const delay = 5000;
+        for (let i = 0; i < maxAttempts; i++) {
+            const res = await fetch(`${JENKINS_URL}/job/${jobName}/${buildNumber}/api/json`, {
+                headers: {
+                    'Authorization': `Basic ${auth}`
+                }
+            });
+            const data = await res.json();
+            if (!data.building) {
+                const result = data.result;
+                if (result === 'SUCCESS') {
+                    logger.log(`Build #${buildNumber} completed successfully.`);
+                    return data;
+                }
+                else {
+                    throw new Error(`Build #${buildNumber} failed.`);
+                }
+            }
+            logger.log(`Build #${buildNumber} is still running... (${i + 1})`);
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+        return null;
+    }
+    getJobName(env) {
+        if (!env) {
+            throw new Error('Environment is required to get the job name');
+        }
+        env = env.toLowerCase();
+        const jobNameMap = {
+            dev: 'wmbpm-web-dev',
+            sit: 'wmbpm-web-sit',
+            bat: 'wmbpm-web-bat'
+        };
+        const jobName = jobNameMap[env];
+        if (!jobName) {
+            throw new Error(`No job name found for environment: ${env}`);
+        }
+        return jobName;
+    }
+}
+exports.JenkinsManager = JenkinsManager;

package/cli/generate/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCommand = void 0;
+const commander_1 = require("commander");
+const mock_1 = require("./mock");
+const new_1 = require("./new");
+exports.generateCommand = new commander_1.Command('generate');
+exports.generateCommand.alias('g');
+exports.generateCommand.addCommand(mock_1.generateMockDataCommand);
+exports.generateCommand.addCommand(new_1.generateNewProjectCommand);

package/cli/generate/mock/form-node.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ControlNode = exports.GroupNode = void 0;
+const lov_1 = require("./lov");
+const randomNumber = () => Math.floor(Math.random() * 100);
+const CONTROL_MOCK_MAP = {
+    'app-input': () => `Sample text ${randomNumber()}`,
+    'app-textarea': () => `Multiline ${randomNumber()}\nText ${randomNumber()}\nHere ${randomNumber()}`,
+    'app-datepicker': () => new Date().toISOString(),
+    'app-input-number': () => randomNumber().toString(),
+    'app-custom-searchable': (control) => {
+        const lovName = control.options?.options?.match(/lov\??\.(?<lovName>\w+?)\??\.options/)?.groups?.lovName || control.name;
+        return (0, lov_1.getLOVFieldValue)(lovName);
+    },
+    'app-checkbox': () => "false",
+    'app-search-employee': () => ({
+        "personName": "Jehad Saleh A Alluhayd",
+        "personEmail": "jsalluhayd@stc.com.sa"
+    }),
+    'app-file-uploader': (control) => {
+        const attachment = () => ({
+            "fileName": `ajm_location_issue_${randomNumber()}.png`,
+            "attachmentId": `b7d2915d-930e-4e93-930e-3675a5959ba8${randomNumber()}`,
+            "mimeType": "image\/png"
+        });
+        control.options?.multiple === 'true' ? [attachment(), attachment()] : attachment();
+    },
+    'app-input-currency': () => '123' + randomNumber().toString(),
+    'app-attachment-section': () => {
+        const attachment = () => ({
+            "fileDescription": "desc " + randomNumber(),
+            "attachmentcomment": "comm " + randomNumber(),
+            "fileComments": "comm " + randomNumber(),
+            "fileName": `dummy_${randomNumber()}.pdf`,
+            "attachmentId": "idd_40910B7B-0000-CE16-BD92-EC800D2FDFC6" + randomNumber(),
+            "mimeType": "application/pdf"
+        });
+        return [attachment(), attachment()];
+    },
+    'app-radio': (control) => {
+        const lovName = control.options?.options?.match(/lov\??\.(?<lovName>\w+?)\??\.options/)?.groups?.lovName || control.name;
+        return (0, lov_1.getLOVFieldValue)(lovName);
+    },
+};
+class FormNode {
+}
+class GroupNode extends FormNode {
+    constructor(name, children = {}) {
+        super();
+        this.name = name;
+        this.children = children;
+    }
+    getValue() {
+        const output = {};
+        for (const key in this.children) {
+            output[key] = this.children[key].getValue();
+        }
+        return output;
+    }
+    addChild(child) {
+        this.children[child.name] = child;
+    }
+}
+exports.GroupNode = GroupNode;
+class ControlNode extends FormNode {
+    constructor(name, tag, options) {
+        super();
+        this.name = name;
+        this.tag = tag;
+        this.options = options;
+    }
+    getValue() {
+        const generator = CONTROL_MOCK_MAP[this.tag] || (() => 'Unknown');
+        return generator(this);
+    }
+}
+exports.ControlNode = ControlNode;