typeshi 1.0.1 → 1.2.0

package/dist/config/env.d.ts

@@ -1,9 +1,6 @@
-/** = `process.cwd()` */
-export declare const NODE_HOME_DIR: string;
-/** = {@link NODE_HOME_DIR}`/src` = `process.cwd()/src`*/
-export declare const SRC_DIR: string;
-/** = `typeshi/src/data` */
-export declare const DATA_DIR: string;
+/**
+ * @file src/config/env.ts
+ */
 /**
  * @description Exit the program/script for debugging purposes
  * @param exitCode `number` - The exit code to use when exiting the program. Default is `0`. Use `1` for error.

package/dist/config/env.js

@@ -1,19 +1,9 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DELAY = exports.STOP_RUNNING = exports.DATA_DIR = exports.SRC_DIR = exports.NODE_HOME_DIR = void 0;
 /**
  * @file src/config/env.ts
  */
-const node_path_1 = __importDefault(require("node:path"));
-/** = `process.cwd()` */
-exports.NODE_HOME_DIR = process.cwd();
-/** = {@link NODE_HOME_DIR}`/src` = `process.cwd()/src`*/
-exports.SRC_DIR = node_path_1.default.join(exports.NODE_HOME_DIR, 'node_modules', 'typeshi', 'dist');
-/** = `typeshi/src/data` */
-exports.DATA_DIR = node_path_1.default.join(exports.SRC_DIR, 'data');
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DELAY = exports.STOP_RUNNING = void 0;
 /**
  * @description Exit the program/script for debugging purposes
  * @param exitCode `number` - The exit code to use when exiting the program. Default is `0`. Use `1` for error.

package/dist/config/index.d.ts

@@ -3,4 +3,3 @@
  */
 export * from "./setupLog";
 export * from "./env";
-export * from "./dataLoader";

package/dist/config/index.js

@@ -19,4 +19,3 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./setupLog"), exports);
 __exportStar(require("./env"), exports);
-__exportStar(require("./dataLoader"), exports);

package/dist/config/setupLog.d.ts

@@ -2,7 +2,7 @@
  * @file src/config/setupLog.ts
  * @reference https://tslog.js.org/#/?id=pretty-templates-and-styles-color-settings
  */
-import { Logger, ILogObj, ILogObjMeta } from 'tslog';
+import { Logger, ILogObj } from 'tslog';
 /**
  * `TAB = INDENT_LOG_LINE =  '\n\t• '` = newLine + tab + bullet + space
  * - log.debug(s1, INDENT_LOG_LINE + s2, INDENT_LOG_LINE + s3,...)
@@ -27,13 +27,4 @@ export declare const NEW_LINE: string;
  * */
 export declare const typeshiLogger: Logger<ILogObj>;
 export declare const typeshiSimpleLogger: Logger<ILogObj>;
-/**
- * compress metadata into `logObj['-1']` then return stringified `logObj`
- * @param logObj {@link ILogObj}
- * @returns `string`
- */
-export declare function formatLogObj(logObj: ILogObj | (ILogObj & ILogObjMeta)): string;
-/**suppress logs by putting them here (do not print to console) */
-export declare const SUPPRESSED_LOGS: any[];
-export declare const INFO_LOGS: any[];
-export declare const DEBUG_LOGS: any[];
+export declare const typeshiHiddenLogger: Logger<ILogObj>;

package/dist/config/setupLog.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEBUG_LOGS = exports.INFO_LOGS = exports.SUPPRESSED_LOGS = exports.typeshiSimpleLogger = exports.typeshiLogger = exports.NEW_LINE = exports.INDENT_LOG_LINE = void 0;
-exports.formatLogObj = formatLogObj;
+exports.typeshiHiddenLogger = exports.typeshiSimpleLogger = exports.typeshiLogger = exports.NEW_LINE = exports.INDENT_LOG_LINE = void 0;
 /**
  * @file src/config/setupLog.ts
  * @reference https://tslog.js.org/#/?id=pretty-templates-and-styles-color-settings
@@ -122,23 +121,15 @@ const SIMPLE_LOGGER_SETTINGS = {
     prettyLogStyles: PRETTY_LOG_STYLES,
 };
 exports.typeshiSimpleLogger = new tslog_1.Logger(SIMPLE_LOGGER_SETTINGS);
-/**
- * compress metadata into `logObj['-1']` then return stringified `logObj`
- * @param logObj {@link ILogObj}
- * @returns `string`
- */
-function formatLogObj(logObj) {
-    const meta = logObj['_meta'];
-    const { logLevelName, date, path } = meta;
-    const timestamp = date ? date.toLocaleString() : '';
-    const fileInfo = `${path?.filePathWithLine}:${path?.fileColumn}`;
-    const methodInfo = `${path?.method ? path.method + '()' : ''}`;
-    delete logObj['_meta'];
-    logObj['meta0'] = `[${logLevelName}] (${timestamp})`;
-    logObj['meta1'] = `${fileInfo} @ ${methodInfo}`;
-    return JSON.stringify(logObj, null, 4) + "\n";
-}
-/**suppress logs by putting them here (do not print to console) */
-exports.SUPPRESSED_LOGS = [];
-exports.INFO_LOGS = [];
-exports.DEBUG_LOGS = [];
+const HIDDEN_LOGGER_SETTINGS = {
+    type: "hidden",
+    name: "typeshi_hidden",
+    minLevel: 0,
+    prettyLogTemplate: SIMPLE_LOG_TEMPLATE,
+    prettyErrorTemplate: ERROR_TEMPLATE,
+    prettyErrorStackTemplate: ERROR_STACK_TEMPLATE,
+    stylePrettyLogs: true,
+    prettyLogTimeZone: "local",
+    prettyLogStyles: PRETTY_LOG_STYLES,
+};
+exports.typeshiHiddenLogger = new tslog_1.Logger(HIDDEN_LOGGER_SETTINGS);

package/dist/utils/io/logging.d.ts

@@ -1,3 +1,4 @@
+import { ILogObj, ILogObjMeta } from "tslog";
 /**
  * @param fileName `string` passed into `extractFileName()`
  * @param func `Function` - to get Function.name
@@ -32,3 +33,9 @@ export declare function formatDebugLogFile(inputFilePath: string, outputFilePath
  * @returns `void`
  */
 export declare function formatAllDebugLogs(logDirectory: string): void;
+/**
+ * reduce metadata to two entries, then return stringified `logObj`
+ * @param logObj {@link ILogObj}
+ * @returns `string`
+ */
+export declare function formatLogObj(logObj: ILogObj | (ILogObj & ILogObjMeta)): string;

package/dist/utils/io/logging.js

@@ -40,6 +40,7 @@ exports.getSourceString = getSourceString;
 exports.autoFormatLogsOnExit = autoFormatLogsOnExit;
 exports.formatDebugLogFile = formatDebugLogFile;
 exports.formatAllDebugLogs = formatAllDebugLogs;
+exports.formatLogObj = formatLogObj;
 /**
  * @file src/utils/io/logging.ts
  */
@@ -49,7 +50,6 @@ const typeValidation_1 = require("../typeValidation");
 const regex_1 = require("../regex");
 const validate = __importStar(require("../argumentValidation"));
 const node_path_1 = __importDefault(require("node:path"));
-const F = (0, regex_1.extractFileName)(__filename);
 /**
  * @param fileName `string` passed into `extractFileName()`
  * @param func `Function` - to get Function.name
@@ -78,7 +78,7 @@ function getSourceString(fileName, func, funcInfo, startLine, endLine) {
  * @returns `void`
  */
 function autoFormatLogsOnExit(filePaths) {
-    const source = `[${F}.${autoFormatLogsOnExit.name}()]`;
+    const source = getSourceString(__filename, autoFormatLogsOnExit.name, `Array<string>(${(filePaths ?? []).length})`);
     if (!(0, typeValidation_1.isStringArray)(filePaths)) {
         setupLog_1.typeshiLogger.warn([`${source} Invalid param 'filePaths'`,
             `Expected: string[] (array of filePaths)`,
@@ -258,3 +258,24 @@ function formatAllDebugLogs(logDirectory) {
         throw error;
     }
 }
+/**
+ * reduce metadata to two entries, then return stringified `logObj`
+ * @param logObj {@link ILogObj}
+ * @returns `string`
+ */
+function formatLogObj(logObj) {
+    const meta = logObj['_meta'];
+    const { logLevelName, date, path: stackFrame } = meta;
+    const timestamp = date ? date.toLocaleString() : '';
+    if (stackFrame) {
+        const fileInfo = [
+            stackFrame.filePathWithLine ? `${stackFrame.filePathWithLine}` : '',
+            stackFrame.fileColumn && stackFrame.filePathWithLine ? `:${stackFrame.fileColumn}` : '',
+        ].join('');
+        const methodInfo = stackFrame.method ? `${stackFrame.method}()` : '';
+        logObj['meta0'] = `[${logLevelName}] (${timestamp})`;
+        logObj['meta1'] = `${fileInfo || 'unknown_file'} @ ${methodInfo || 'unknown_method'}`;
+        delete logObj['_meta'];
+    }
+    return JSON.stringify(logObj, null, 4) + "\n";
+}

package/dist/utils/io/reading.js

@@ -365,7 +365,7 @@ async function getCsvRows(arg1) {
             .pipe((0, csv_parser_1.default)({ separator: delimiter }))
             .on('data', (row) => rows.push(row))
             .on('end', () => {
-            config_1.SUPPRESSED_LOGS.push([`${source} Successfully read CSV file.`,
+            config_1.typeshiHiddenLogger.debug([`${source} Successfully read CSV file.`,
                 `filePath: '${filePath}'`,
                 `Number of rows read: ${rows.length}`
             ].join(config_1.INDENT_LOG_LINE));

package/dist/utils/io/writing.d.ts

@@ -29,7 +29,7 @@ export declare const writeJsonSync: typeof writeObjectToJsonSync;
  */
 export declare function indentedStringify(data: Record<string, any> | string, indent?: number, spaces?: number): string;
 /**
- * @returns **`timestamp`** `string` = `(${MM}-${DD})-(${HH}-${mm}.${ss}.${ms})`
+ * @returns **`timestamp`** `string` = `(${MM}-${DD})_(${HH}-${mm}.${ss}.${ms})`
  */
 export declare function getFileNameTimestamp(): string;
 /**

package/dist/utils/io/writing.js

@@ -135,7 +135,7 @@ function indentedStringify(data, indent = 0, spaces = 4) {
     return jsonString;
 }
 /**
- * @returns **`timestamp`** `string` = `(${MM}-${DD})-(${HH}-${mm}.${ss}.${ms})`
+ * @returns **`timestamp`** `string` = `(${MM}-${DD})_(${HH}-${mm}.${ss}.${ms})`
  */
 function getFileNameTimestamp() {
     const now = new Date();
@@ -145,7 +145,7 @@ function getFileNameTimestamp() {
     const mm = String(now.getMinutes()).padStart(2, '0');
     const ss = String(now.getSeconds()).padStart(2, '0');
     const ms = String(now.getMilliseconds()).padStart(3, '0');
-    return `(${MM}-${DD})-(${HH}-${mm}.${ss}.${ms})`;
+    return `(${MM}-${DD})_(${HH}-${mm}.${ss}.${ms})`;
 }
 /**
  * @param listData `Record<string, Array<string>>` map col names to col values
@@ -156,7 +156,6 @@ function getFileNameTimestamp() {
 function writeListsToCsvSync(listData, outputPath, delimiter = types_1.DelimiterCharacterEnum.TAB, columnDelimiter = '') {
     const listNames = Object.keys(listData);
     const listValues = Object.values(listData);
-    // Get the maximum length of the lists
     const maxLength = Math.max(...listValues.map(list => list.length));
     let csvContent = listNames.join(delimiter) + '\n';
     if ((0, typeValidation_1.isNonEmptyString)(columnDelimiter)) {

package/dist/utils/regex/configureParameters.d.ts

@@ -2,9 +2,6 @@
  * @file src/utils/regex/configureParameters.ts
  */
 import { StringStripOptions, StringReplaceParams } from ".";
-export declare function getCompanyKeywordList(): string[];
-export declare function getJobTitleSuffixList(): string[];
-/** strip leading `.` and (trailing `.` if satisfy stripRightCondition: {@link doesNotEndWithKnownAbbreviation}) */
 /**
  * @param {string} s - `string` - the string to check
  * @returns `!s.endsWith('Ph.D.') && !`{@link stringEndsWithAnyOf}`(s`, {@link COMPANY_ABBREVIATION_PATTERN} as RegExp, `[`{@link RegExpFlagsEnum.IGNORE_CASE}`]) && !stringEndsWithAnyOf(s, /\b[A-Z]\.?\b/, [RegExpFlagsEnum.IGNORE_CASE]);` */

package/dist/utils/regex/configureParameters.js

@@ -1,22 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.REPLACE_EM_HYPHEN = exports.ENSURE_SPACE_AROUND_HYPHEN = exports.UNCONDITIONAL_STRIP_DOT_OPTIONS = exports.STRIP_DOT_IF_NOT_END_WITH_ABBREVIATION = void 0;
-exports.getCompanyKeywordList = getCompanyKeywordList;
-exports.getJobTitleSuffixList = getJobTitleSuffixList;
 exports.doesNotEndWithKnownAbbreviation = doesNotEndWithKnownAbbreviation;
 /**
  * @file src/utils/regex/configureParameters.ts
  */
 const _1 = require(".");
-const dataLoader_1 = require("../../config/dataLoader");
-// These are now loaded via the dataLoader system
-function getCompanyKeywordList() {
-    return (0, dataLoader_1.getRegexConstants)().COMPANY_KEYWORD_LIST;
-}
-function getJobTitleSuffixList() {
-    return (0, dataLoader_1.getRegexConstants)().JOB_TITLE_SUFFIX_LIST;
-}
-/** strip leading `.` and (trailing `.` if satisfy stripRightCondition: {@link doesNotEndWithKnownAbbreviation}) */
 /**
  * @param {string} s - `string` - the string to check
  * @returns `!s.endsWith('Ph.D.') && !`{@link stringEndsWithAnyOf}`(s`, {@link COMPANY_ABBREVIATION_PATTERN} as RegExp, `[`{@link RegExpFlagsEnum.IGNORE_CASE}`]) && !stringEndsWithAnyOf(s, /\b[A-Z]\.?\b/, [RegExpFlagsEnum.IGNORE_CASE]);` */

package/dist/utils/regex/entity.js

@@ -68,7 +68,11 @@ function extractName(name, includeJobTitleSuffix = true) {
         || _1.KOREA_ADDRESS_LATIN_TEXT_PATTERN.test(name)) {
         return { first: '', middle: '', last: '' };
     }
-    config_1.DEBUG_LOGS.push(`extractName()`, config_1.INDENT_LOG_LINE + `  originalName = "${originalName}"`, config_1.INDENT_LOG_LINE + `  cleaned name = "${name}"`, config_1.INDENT_LOG_LINE + `jobTitleSuffix = "${jobTitleSuffix}"`);
+    config_1.typeshiHiddenLogger.debug([`extractName()`,
+        `  originalName = "${originalName}"`,
+        `  cleaned name = "${name}"`,
+        `jobTitleSuffix = "${jobTitleSuffix}"`
+    ].join(config_1.INDENT_LOG_LINE));
     let nameSplit = name.split(/(?<!,)\s+/);
     if (nameSplit.length === 0) {
         return { first: '', middle: '', last: '' };
@@ -81,7 +85,9 @@ function extractName(name, includeJobTitleSuffix = true) {
         strip: _1.STRIP_DOT_IF_NOT_END_WITH_ABBREVIATION,
         replace: [{ searchValue: /(^[-+])*/g, replaceValue: '' }]
     }));
-    config_1.DEBUG_LOGS.push(config_1.NEW_LINE + `nameSplit.length === ${nameSplit.length},`, `nameSplit: ${JSON.stringify(nameSplit)}`);
+    config_1.typeshiHiddenLogger.debug([`nameSplit.length === ${nameSplit.length},`,
+        `nameSplit: ${JSON.stringify(nameSplit)}`
+    ].join(config_1.INDENT_LOG_LINE));
     if (nameSplit.length == 1) {
         return {
             first: nameSplit[0].replace(/(,|\.)$/g, ''),
@@ -125,7 +131,7 @@ function extractName(name, includeJobTitleSuffix = true) {
             // .replace(/(,|\.)$/g, '') 
         };
     }
-    config_1.DEBUG_LOGS.push(config_1.NEW_LINE + `extractName() - no valid name parts found, returning empty strings`);
+    config_1.typeshiHiddenLogger.debug(config_1.NEW_LINE + `extractName() - no valid name parts found, returning empty strings`);
     return { first: '', middle: '', last: '' };
 }
 /**
@@ -148,11 +154,11 @@ function extractJobTitleSuffix(s) {
             { searchValue: /,$/g, replaceValue: '' }
         ] });
     if (exports.JOB_TITLE_SUFFIX_PATTERN.test(s)) {
-        config_1.DEBUG_LOGS.push(config_1.NEW_LINE + `[regex/entity.extractJobTitleSuffix()]`, config_1.INDENT_LOG_LINE + `s = "${s}"`);
+        config_1.typeshiHiddenLogger.debug(config_1.NEW_LINE + `[regex/entity.extractJobTitleSuffix()]`, `s = "${s}"`);
         const jobTitleMatch = s.match(exports.JOB_TITLE_SUFFIX_PATTERN);
         if (jobTitleMatch && jobTitleMatch.length > 0) {
             let jobTitle = jobTitleMatch[0].replace(/^\s*,\s*/g, '').trim();
-            config_1.DEBUG_LOGS.push(config_1.INDENT_LOG_LINE + `jobTitleMatch[0] = "${jobTitleMatch[0]}" -> trim and return "${jobTitle}"`);
+            config_1.typeshiHiddenLogger.debug(`jobTitleMatch[0] = "${jobTitleMatch[0]}" -> trim and return "${jobTitle}"`);
             return jobTitle;
         }
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "typeshi",
-    "version": "1.0.1",
+    "version": "1.2.0",
     "description": "TypeScript utility modules",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/dist/config/dataLoader.d.ts

@@ -1,37 +0,0 @@
-/**
- * @enum {string} **`DataDomainEnum`** `string`
- * @property **`REGEX`** = `'regex'`
- */
-export declare enum DataDomainEnum {
-    REGEX = "regex"
-}
-/**
- * Initialize all data required by the application.
- * This should be called once at the start of the application.
- */
-export declare function initializeData(...domains: DataDomainEnum[]): Promise<void>;
-export declare function getRegexConstants(): RegexConstants;
-/**
- * `Sync` Get company keyword list
- * @returns **`COMPANY_KEYWORD_LIST`** `string[]`
- */
-export declare function getCompanyKeywordList(): string[];
-/**
- * Get job title suffix list
- * @returns **`JOB_TITLE_SUFFIX_LIST`** `string[]`
- */
-export declare function getJobTitleSuffixList(): string[];
-export declare function isDataInitialized(): boolean;
-/**
- * @interface **`RegexConstants`**
- * @property **`COMPANY_KEYWORD_LIST`** `string[]`
- * @property **`JOB_TITLE_SUFFIX_LIST`** `string[]`
- */
-export interface RegexConstants {
-    COMPANY_KEYWORD_LIST: string[];
-    JOB_TITLE_SUFFIX_LIST: string[];
-}
-export type DataLoaderConfig = {
-    regexFile: string;
-    [key: string]: string;
-};

package/dist/config/dataLoader.js

@@ -1,171 +0,0 @@
-"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 () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DataDomainEnum = void 0;
-exports.initializeData = initializeData;
-exports.getRegexConstants = getRegexConstants;
-exports.getCompanyKeywordList = getCompanyKeywordList;
-exports.getJobTitleSuffixList = getJobTitleSuffixList;
-exports.isDataInitialized = isDataInitialized;
-/**
- * @file src/config/dataLoader.ts
- * @TODO change this file and env.ts to use initializeEnvironment() pattern
- */
-const env_1 = require("./env");
-const setupLog_1 = require("./setupLog");
-const reading_1 = require("../utils/io/reading");
-const typeValidation_1 = require("../utils/typeValidation");
-const node_path_1 = __importDefault(require("node:path"));
-const validate = __importStar(require("../utils/argumentValidation"));
-let dataInitialized = false;
-let config = null;
-/**
- * @enum {string} **`DataDomainEnum`** `string`
- * @property **`REGEX`** = `'regex'`
- */
-var DataDomainEnum;
-(function (DataDomainEnum) {
-    DataDomainEnum["REGEX"] = "regex";
-})(DataDomainEnum || (exports.DataDomainEnum = DataDomainEnum = {}));
-/* ---------------------- LOAD REGEX CONFIG -------------------------- */
-let regexConstants = null;
-/* ------------------------- MAIN FUNCTION ----------------------------- */
-const DEFAULT_DOMAINS_TO_LOAD = [
-    DataDomainEnum.REGEX,
-];
-/**
- * Initialize all data required by the application.
- * This should be called once at the start of the application.
- */
-async function initializeData(...domains) {
-    const source = getSourceString(__filename, initializeData.name);
-    if (dataInitialized) {
-        setupLog_1.typeshiLogger.info(`${source} Data already initialized, skipping...`);
-        return;
-    }
-    if (!domains || domains.length === 0) {
-        domains.push(...DEFAULT_DOMAINS_TO_LOAD);
-    }
-    setupLog_1.typeshiSimpleLogger.info(`${source} Starting data initialization...`);
-    try {
-        const configPath = node_path_1.default.join(env_1.DATA_DIR, `typeshi.data.config.json`);
-        config = await loadConfig(configPath);
-        for (const d of domains) {
-            switch (d) {
-                case DataDomainEnum.REGEX:
-                    regexConstants = await loadRegexConstants(node_path_1.default.join(env_1.DATA_DIR, DataDomainEnum.REGEX, config.regexFile));
-                    break;
-                default:
-                    setupLog_1.typeshiLogger.warn(`${source} Unrecognized data domain: '${d}'. Skipping...`);
-                    continue;
-            }
-        }
-        dataInitialized = true;
-        setupLog_1.typeshiSimpleLogger.info(`${source} ✓ All data initialized successfully`);
-    }
-    catch (error) {
-        setupLog_1.typeshiLogger.error(`${source} ✗ Failed to initialize data:`, error);
-        (0, env_1.STOP_RUNNING)(1, `Data initialization failed`);
-    }
-}
-function getRegexConstants() {
-    if (!dataInitialized || !regexConstants) {
-        throw new Error('[dataLoader.getRegexConstants()] Regex constants not initialized. Call initializeData() first.');
-    }
-    return regexConstants;
-}
-/**
- * `Sync` Get company keyword list
- * @returns **`COMPANY_KEYWORD_LIST`** `string[]`
- */
-function getCompanyKeywordList() {
-    const constants = getRegexConstants();
-    return constants.COMPANY_KEYWORD_LIST;
-}
-/**
- * Get job title suffix list
- * @returns **`JOB_TITLE_SUFFIX_LIST`** `string[]`
- */
-function getJobTitleSuffixList() {
-    const constants = getRegexConstants();
-    return constants.JOB_TITLE_SUFFIX_LIST;
-}
-function isDataInitialized() {
-    return dataInitialized;
-}
-async function loadConfig(jsonPath) {
-    const source = getSourceString(__filename, loadConfig.name);
-    validate.existingFileArgument(source, '.json', { jsonPath });
-    let configData = (0, reading_1.readJsonFileAsObject)(jsonPath);
-    validate.objectArgument(source, { configData, isDataLoaderConfig });
-    return configData;
-}
-/**
- * Load regex constants
- */
-async function loadRegexConstants(filePath) {
-    const source = getSourceString(__filename, loadRegexConstants.name);
-    setupLog_1.typeshiSimpleLogger.info(`${source} Loading regex constants...`);
-    validate.existingFileArgument(source, '.json', { filePath });
-    const REGEX_CONSTANTS = (0, reading_1.readJsonFileAsObject)(filePath);
-    if (!REGEX_CONSTANTS || !(0, typeValidation_1.hasKeys)(REGEX_CONSTANTS, ['COMPANY_KEYWORD_LIST', 'JOB_TITLE_SUFFIX_LIST'])) {
-        throw new Error(`${source} Invalid REGEX_CONSTANTS file at '${filePath}'. Expected json object to have 'COMPANY_KEYWORD_LIST' and 'JOB_TITLE_SUFFIX_LIST' keys.`);
-    }
-    const COMPANY_KEYWORD_LIST = REGEX_CONSTANTS.COMPANY_KEYWORD_LIST || [];
-    if (!(0, typeValidation_1.isNonEmptyArray)(COMPANY_KEYWORD_LIST)) {
-        throw new Error(`${source} Invalid COMPANY_KEYWORD_LIST in REGEX_CONSTANTS file at '${filePath}'`);
-    }
-    const JOB_TITLE_SUFFIX_LIST = REGEX_CONSTANTS.JOB_TITLE_SUFFIX_LIST || [];
-    if (!(0, typeValidation_1.isNonEmptyArray)(JOB_TITLE_SUFFIX_LIST)) {
-        throw new Error(`${source} Invalid JOB_TITLE_SUFFIX_LIST in REGEX_CONSTANTS file at '${filePath}'`);
-    }
-    setupLog_1.typeshiSimpleLogger.info(`${source} ✓ Regex constants loaded successfully`);
-    return {
-        COMPANY_KEYWORD_LIST,
-        JOB_TITLE_SUFFIX_LIST,
-    };
-}
-function isDataLoaderConfig(value) {
-    return ((0, typeValidation_1.isObject)(value)
-        && Object.values(value).every(v => (0, typeValidation_1.isNonEmptyString)(v)));
-}
-function getSourceString(fileName, func, funcInfo) {
-    fileName = node_path_1.default.basename(fileName).replace(/(?<=.+)\.[a-z0-9]{1,}$/i, '');
-    let funcName = typeof func === 'string' ? func : func.name;
-    return `[typeshi.${fileName}.${funcName}(${(0, typeValidation_1.isNonEmptyString)(funcInfo) ? ` ${funcInfo} ` : ''})]`;
-}