@indra.ai/deva/lib/index.js

Deva Core a Vedic-inspired Event Based Context Aware Feature, Zone, Action, and State Machine integrated Artificial Intelligence Framework

"use strict";
// Copyright ©2000-2025 Quinn A Michaels; All rights reserved. 
// Legal Signature Required For Lawful Use.
// Distributed under VLA:38159520729793885324 LICENSE.md

import path from 'path';
import fs from 'fs';
import os from 'os';
import {exec, spawn}  from 'node:child_process';

import { createHash, randomUUID, createCipheriv, createDecipheriv, randomBytes } from 'crypto';

class Node {
	constructor(opts) {
		for (let opt in opts) this[opt] = opts[opt];
	}
}
class LIB {
	constructor(opts) {
		this.pkg = opts.pkg || {};
		this.lang = opts.lang || 'en';
		this.locale = opts.locale || 'en-US';
		this.currency = opts.currency || 'USD';
		this.os = os;
		this.fs = fs;
		this.path = path;
		this.exec = exec;
		this.spawn = spawn;		
		this.randomUUID = randomUUID;
	}
	
	help(msg, help_dir) {
		return new Promise((resolve, reject) => {
			const params = msg.split(' ');
			let helpFile = 'main';
			if (params[0]) helpFile = params[0];
			if (params[1]) helpFile = `${params[0]}_${params[1]}`;
			helpFile = path.join(help_dir, 'help', `${helpFile}.feecting`);
			try {
				return resolve(fs.readFileSync(helpFile, 'utf8'))
			} catch (e) {
				return reject(e)
			}
		})
	}

	/**************
	func: encrypt
	params: 
		str - string to encrypt
		opts - options for the encryption.
	describe:
		The encrypt function allows for the internal encryption of data based on the
		defined client security settings.
	***************/
	encrypt(str, opts) {
		const {password, algorithm} = opts;
		const key = createHash('sha256').update(String(password)).digest('base64');
		const key_in_bytes = Buffer.from(key, 'base64')
		const iv = randomBytes(16);
		// create a new cipher
		const _cipher = createCipheriv(algorithm, key_in_bytes, iv);
		const encrypted = _cipher.update(String(str), 'utf8', 'hex') + _cipher.final('hex');
	
		return {
			iv: iv.toString('base64'),
			key,
			encrypted,
		}
	}

	/**************
	func: decrypt
	params: 
		opts - options for the encryption.
	describe:
		The decrypt function allows for the internal decryption of data based on the
		defined options.
	***************/
	decrypt(opts) {
		const {key, algorithm} = opts;
		const iv = Buffer.from(opts.iv, 'base64');
		const encrypted = Buffer.from(opts.encrypted, 'hex');
		const key_in_bytes = Buffer.from(key, 'base64')
		const decipher = createDecipheriv(algorithm, key_in_bytes, iv);
		let decrypted = decipher.update(encrypted, 'hex', 'utf8');
		decrypted += decipher.final('utf8');

		return decrypted;
	}

	/**************
	func: copy
	params: obj
	describe:
		a simple copy object to create a memory clean copy of data to
		prevent collisions when needed. Handles clean text, array, object copy.
		it makes the assumption tha the user is submitting either an array or object
		for copying.
	***************/
	copy(obj) {
		return JSON.parse(JSON.stringify(obj));
	}

	/**************
	func: getToday
	params:
		- d: The date string to get the day of..
	describe:
		a date can be passed in or generated to produce a date string for the day
		where time is 0. This feature is useful for logging for getting a date
		with no time value for the current day.
	***************/
	getToday(d) {
		d = d ? d : Date.now();
		const today = new Date(d);
		today.setHours(0);
		today.setMinutes(0);
		today.setSeconds(0);
		today.setMilliseconds(0);
		return today.getTime();
	}

	/**************
	func: /date
	params:
		- d: The date string to format.
		- format: the various formats that can be selected.
		- time: boolean flag to include the time stampt iwth the date.
		- locale: The locale formatting of the date to return.
	describe:
		formats: long, long_month, short, short_month, year, month, day
		FDate format ensures that consistent date formatting is used within the
		system based on the language and locale in the client profile.
	***************/
	formatDate(d, format='milli', time=false) {
		if (!d) d = Date.now();
		d = new Date(d);
	
		if (format === 'milli') return d.getTime();
		// pre-set date formats for returning user dates.
		const formats = {
			long: { weekday: 'long', year: 'numeric', month: 'long', day: 'numeric' },
			long_month: { year: 'numeric', month: 'long', day: 'numeric'},
			short: { weekday: 'short', year: 'numeric', month: 'short', day: 'numeric' },
			short_month: { year: 'numeric', month: 'short', day: 'numeric' },
			numeric: { year: 'numeric', month: 'numeric', day: 'numeric' },
			year: { year: 'numeric' },
			month: { month: 'long' },
			day: { day: 'long' },
			log: { year: 'numeric', month: 'short', day: 'numeric' },
		};
		const theDate = d.toLocaleDateString(this.locale, formats[format]);
		const theTime = time ? this.formatTime(d) : false;
		return !theTime ? theDate : `${theDate} - ${theTime}`;
	}

	/**************
	func: formatTime
	params:
		- t: the time to format
	describe:
		The formatTime fucntion will return a consistent local time for the t
		parameter based on the locale setting in the client profile..
	***************/
	formatTime(t) {
		return t.toLocaleTimeString(this.locale);     // return the formatted time string
	}
	
	/**************
	func: formatCurrency
	params:
		- n: is the number that you want to return the currency of.
	describe:
		The formatCurrency function will format a currency value based on the setting
		in the client profile.
	***************/
	formatCurrency(n, cur=false) {
		const currency = cur || this.currency;
		return new Intl.NumberFormat(this.locale, { style: 'currency', currency: currency }).format(n);
	}
	
	/**************
	func: formatCurrency
	params:
		- n: is the number that you want to return the currency of.
	describe:
		The formatCurrency function will format a currency value based on the setting
		in the client profile.
	***************/
	formatNumber(n) {
		return new Intl.NumberFormat(this.locale).format(n);
	}
	
	/**************
	func: formatPercent
	params:
		- n: is the number that you want to format as a percent.
		- dec: is the number of decimal places to apply to the number.
	describe:
	***************/
	formatPercent(n, dec=2) {
		return parseFloat(n).toFixed(dec) + '%';
	}
	
	/**************
	func: trimWords
	params:
		- text: The text to trim.
		- max words: The number of words to max.
	describe:
		A utility function to trimText input to a specific word count.
	***************/
	trimWords(text, maxwords) {
		const splitter = text.split(' ');
		if (splitter < maxwords) return text;
		return splitter.slice(0, maxwords).join(' ');
	}
	
	/**************
	func: dupes
	params: dupers
	describe: remove duplicates from an array.
	***************/
	dupes(dupers) {
		if (!Array.isArray(dupers)) return dupers;
		const check = [];
		return dupers.filter(dupe => {
			if (!check.includes(dupe)) {
				check.push(dupe);
				return dupe;
			}
		});
	}
};
export default LIB