@kvishal04/library-core 1.0.0

package/README.md

@@ -0,0 +1,458 @@
+# @kvishal04/library-core
+
+Reusable TypeScript utility library for backend applications.
+
+## Install
+
+```bash
+npm install @kvishal04/library-core
+```
+
+## Node Version
+
+- Node.js 18 or above is recommended.
+
+## Quick Start
+
+```ts
+import {
+	validator,
+	ResponseHandler,
+	SessionManager,
+	HTTP_RESPONSE_CODE,
+} from '@kvishal04/library-core';
+```
+
+## Environment Setup
+
+Set only what your used modules need.
+
+```bash
+# Encryption
+SECRET_KEY=your-secret
+SECRET_IV=your-secret-iv
+ENCRYPTION_METHOD=aes-256-cbc
+
+# GeoLocation
+GOOGLE_MAPS_API_KEY=your-google-api-key
+
+# Session store location (optional)
+PROJECT_ROOT=/absolute/project/path
+
+# DB module
+DB_CONFIG=[{"CONNECTION_NAME":"master","DB_TYPE":"mysql","CONFIG":{"SERVER_NAME":"localhost","PORT":3306,"USERNAME":"root","PASSWORD":"pass","DATABASE":"appdb"}}]
+
+# Cron scheduler
+CRON_JOBS=[{"JOB_NAME":"refresh-cache","CRON_EXPRESSION":"*/5 * * * *","url":"http://localhost:3000/internal/refresh","method":"POST","headers":{"authorization":"Bearer token"},"body":{}}]
+```
+
+## Exported Features
+
+- Constants and enums
+- Validator
+- ResponseHandler
+- SessionManager
+- Encryption helpers
+- GeoLocation
+- ExcelUtil
+- Image resizer
+- Cron scheduler helper
+- DB module
+- Spreadsheet module
+- ConfigManager module
+- Connectors loader
+- AppConfig singleton
+- Middleware helpers (auth, multipart, system/core/app middleware, error handler)
+- System config-manager router
+- System application helpers (CORS, controller, request context, render/util)
+- Utility helpers (HttpError, throwError, validateBodyForSpecialCharacter)
+- Core response type aliases (CoreJsonResponse, CoreBufferResponse, CoreRenderResponse, CoreServiceResponse)
+- Session store alias (SessionStore)
+
+## Detailed Usage
+
+### 1) Constants
+
+```ts
+import { HTTP_RESPONSE_CODE, Operators, ActionType } from '@kvishal04/library-core';
+
+if (code === HTTP_RESPONSE_CODE.SUCCESS) {
+	// success branch
+}
+
+const filter = { operator: Operators.And, action: ActionType.login };
+```
+
+### 2) Validator
+
+```ts
+import { validator } from '@kvishal04/library-core';
+
+const schema = {
+	required: ['name', 'email'],
+	string: ['name'],
+	email: ['email'],
+	number: ['age'],
+};
+
+const payload = {
+	name: 'Vishal',
+	email: 'vishal@example.com',
+	age: 28,
+};
+
+validator.validate(payload, schema);
+```
+
+### 3) ResponseHandler (Express)
+
+```ts
+import { ResponseHandler } from '@kvishal04/library-core';
+
+export function getProfile(_req: any, res: any) {
+	return ResponseHandler.success(res, 200, 'Profile fetched', { id: 'u_101' });
+}
+
+export function createUser(_req: any, res: any) {
+	return ResponseHandler.validationError(res, 'Validation failed', {
+		email: 'Invalid email',
+	});
+}
+```
+
+### 4) SessionManager
+
+```ts
+import { SessionManager } from '@kvishal04/library-core';
+
+const sessionId = SessionManager.createSession(
+	'user-123',
+	{
+		userAgent: req.headers['user-agent'],
+		acceptLanguage: req.headers['accept-language'],
+		ipAddress: req.ip,
+	},
+	'my-app'
+);
+
+const result = SessionManager.validateSession(
+	sessionId,
+	{
+		userAgent: req.headers['user-agent'],
+		acceptLanguage: req.headers['accept-language'],
+		ipAddress: req.ip,
+	},
+	'my-app'
+);
+
+if (!result.valid) {
+	// handle invalid session
+}
+```
+
+### 5) Encryption
+
+```ts
+import { encryptData, decryptData } from '@kvishal04/library-core';
+
+const encrypted = encryptData({ userId: 'user-123' });
+const decrypted = decryptData(encrypted);
+```
+
+### 6) GeoLocation
+
+```ts
+import { GeoLocation } from '@kvishal04/library-core';
+
+const latLng = await GeoLocation.getLatLngFromAddress(
+	'My Office',
+	'MG Road',
+	'Karnataka',
+	'Bengaluru',
+	'India'
+);
+
+const fullData = await GeoLocation.getGeoDataFromAddress(
+	'My Office',
+	'MG Road',
+	'Karnataka',
+	'Bengaluru',
+	'India',
+	process.env.MY_RUNTIME_MAP_KEY
+);
+```
+
+### 7) ExcelUtil
+
+```ts
+import { ExcelUtil } from '@kvishal04/library-core';
+
+const buffer = await ExcelUtil.createExcelBuffer([
+	{ id: 1, name: 'A' },
+	{ id: 2, name: 'B' },
+]);
+
+const multiBuffer = await ExcelUtil.createMultiSheetExcelBuffer([
+	{ sheetName: 'Users', data: [{ id: 1, name: 'Vishal' }] },
+	{ sheetName: 'Orders', data: [{ orderId: 'O1', amount: 1200 }] },
+]);
+```
+
+### 8) Image Resizer
+
+```ts
+import { resizeImageFromUrl } from '@kvishal04/library-core';
+
+const blobs = await resizeImageFromUrl({
+	baseImageUrl: 'https://example.com/image.jpg',
+	sizes: [64, 128, 256],
+	options: {
+		fit: 'contain',
+		quality: 90,
+		compressionLevel: 6,
+	},
+});
+
+// blobs['64x64'] -> Blob
+```
+
+### 9) Cron Scheduler
+
+```ts
+import { scheduleTaskSchedulerJob } from '@kvishal04/library-core';
+
+scheduleTaskSchedulerJob();
+```
+
+This reads `CRON_JOBS` from environment and schedules each valid cron expression.
+
+### 10) DB Module
+
+```ts
+import { DB } from '@kvishal04/library-core';
+
+const db = DB.connect('master');
+const rows = await db.raw('SELECT 1 AS ok');
+
+const health = await DB.status('master');
+```
+
+### 11) Spreadsheet Module
+
+```ts
+import { SpreadsheetService } from '@kvishal04/library-core';
+
+const svc = new SpreadsheetService();
+
+await svc.createFile('exports/report.xlsx', {
+	sheets: [
+		{
+			name: 'Report',
+			rows: [
+				{ id: 1, name: 'A' },
+				{ id: 2, name: 'B' },
+			],
+		},
+	],
+	freezeHeader: true,
+	autoFilter: true,
+});
+
+const parsed = await svc.readFile('exports/report.xlsx');
+```
+
+If you want API routes:
+
+```ts
+import express from 'express';
+import { SpreadsheetRouter } from '@kvishal04/library-core';
+
+const app = express();
+app.use(SpreadsheetRouter);
+```
+
+### 12) ConfigManager Module
+
+```ts
+import { ConfigManager, ConfigManagerApiRoutes } from '@kvishal04/library-core';
+
+await ConfigManager.reloadConfigs();
+const cfg = ConfigManager.getConfig('notify/email/gmail.config');
+
+ConfigManager.on('config:reloaded', ({ key }) => {
+	console.log('Config reloaded:', key);
+});
+```
+
+Mount API routes:
+
+```ts
+import express from 'express';
+import { ConfigManagerApiRoutes } from '@kvishal04/library-core';
+
+const app = express();
+app.use('/config-manager', ConfigManagerApiRoutes);
+```
+
+### 13) Connectors Loader
+
+```ts
+import { Connectors } from '@kvishal04/library-core';
+
+const connector = Connectors.load('payments');
+```
+
+### 14) AppConfig Singleton
+
+```ts
+import { AppConfig } from '@kvishal04/library-core';
+
+AppConfig.set('APP_CONFIG_ROOT', 'C:/configs');
+const root = AppConfig.get<string>('APP_CONFIG_ROOT');
+```
+
+### 15) CORS Setup Helper
+
+```ts
+import express from 'express';
+import { configureAppCors } from '@kvishal04/library-core';
+
+const app = express();
+
+app.use(
+	configureAppCors({
+		debug: false,
+		routes: [],
+		cors: {
+			allowedOrigins: ['http://localhost:3000'],
+			allowCredentials: true,
+			maxAge: 86400,
+		},
+		allowedMethods: ['GET', 'POST', 'PUT', 'DELETE', 'OPTIONS'],
+		allowedHeaders: ['Content-Type', 'Authorization'],
+	})
+);
+```
+
+### 16) ApiController and RequestContext
+
+```ts
+import { ApiController, RequestContext } from '@kvishal04/library-core';
+
+RequestContext.run(() => {
+	RequestContext.set('requestId', 'req-123');
+});
+
+const controller = new ApiController({
+	debug: true,
+	routes: [],
+	cors: {
+		allowedOrigins: ['*'],
+		allowCredentials: false,
+		maxAge: 0,
+	},
+	allowedMethods: ['POST', 'OPTIONS'],
+	allowedHeaders: ['Content-Type'],
+});
+```
+
+### 17) System Response Helper
+
+```ts
+import { SystemResponse } from '@kvishal04/library-core';
+
+return SystemResponse.JSON({ message: 'ok' }, 200);
+```
+
+### 18) System Config-Manager Router
+
+```ts
+import express from 'express';
+import { SystemConfigManagerRouter } from '@kvishal04/library-core';
+
+const app = express();
+app.use(SystemConfigManagerRouter);
+```
+
+### 19) Middleware Helpers
+
+```ts
+import express from 'express';
+import {
+	applicationMiddleware,
+	coreMiddleware,
+	systemMiddleware,
+	errorHandler,
+	multipartAny,
+	normalizeMultipartBody,
+	verifyJWT,
+	sessionAuth,
+	generateJWT,
+} from '@kvishal04/library-core';
+
+const app = express();
+
+app.use(applicationMiddleware);
+app.use(coreMiddleware);
+app.use(systemMiddleware);
+
+app.post('/upload', multipartAny, (req, res) => {
+	const body = normalizeMultipartBody(req);
+	res.json({ status: true, files: body.files?.length || 0 });
+});
+
+app.get('/secure', (req, res) => {
+	const user = verifyJWT(req);
+	if (!sessionAuth('my-app')) {
+		return res.status(401).json({ status: false, message: 'Unauthorized' });
+	}
+	return res.json({ status: true, user });
+});
+
+app.use(errorHandler);
+
+const token = generateJWT({ userId: 'u_101' }, '24h');
+```
+
+### 20) Utility Helpers
+
+```ts
+import {
+	HttpError,
+	throwError,
+	validateBodyForSpecialCharacter,
+	returnDateYYYYMMDD,
+} from '@learn/library-core';
+
+const isValid = validateBodyForSpecialCharacter({ name: 'Vishal' });
+if (!isValid) {
+	throw new HttpError('Invalid payload', 400);
+}
+
+const today = returnDateYYYYMMDD(new Date());
+```
+
+### 21) Core Response Type Aliases
+
+```ts
+import type { CoreServiceResponse } from '@kvishal04/library-core';
+
+const response: CoreServiceResponse = {
+	kind: 'json',
+	payload: { ok: true },
+	statusCode: 200,
+};
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+## Publish
+
+```bash
+npm login
+npm publish --access public
+```

package/dist/appConfig.d.ts

@@ -0,0 +1,16 @@
+type ConfigValue = any;
+declare class AppConfig {
+    private store;
+    set(key: string, value: ConfigValue): void;
+    get<T = ConfigValue>(key: string, defaultValue?: T): T;
+    has(key: string): boolean;
+    remove(key: string): void;
+    all(): Record<string, ConfigValue>;
+}
+/**
+ * SINGLETON EXPORT
+ * Same instance shared across entire app
+ */
+declare const __AppConfig: AppConfig;
+export default __AppConfig;
+//# sourceMappingURL=appConfig.d.ts.map

package/dist/appConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appConfig.d.ts","sourceRoot":"","sources":["../core/appConfig.ts"],"names":[],"mappings":"AAEA,KAAK,WAAW,GAAG,GAAG,CAAC;AAEvB,cAAM,SAAS;IACb,OAAO,CAAC,KAAK,CAAmC;IAEhD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI;IAO1C,GAAG,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC;IAYtD,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;CAGnC;AAED;;;GAGG;AACH,QAAA,MAAM,WAAW,WAAkB,CAAC;AACpC,eAAe,WAAW,CAAC"}

package/dist/appConfig.js

@@ -0,0 +1,37 @@
+"use strict";
+// src/core/config.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+class AppConfig {
+    store = {};
+    set(key, value) {
+        if (!key) {
+            throw new Error('Config key is required');
+        }
+        this.store[key] = value;
+    }
+    get(key, defaultValue) {
+        if (!key) {
+            throw new Error('Config key is required');
+        }
+        if (this.store.hasOwnProperty(key)) {
+            return this.store[key];
+        }
+        return defaultValue;
+    }
+    has(key) {
+        return this.store.hasOwnProperty(key);
+    }
+    remove(key) {
+        delete this.store[key];
+    }
+    all() {
+        return { ...this.store };
+    }
+}
+/**
+ * SINGLETON EXPORT
+ * Same instance shared across entire app
+ */
+const __AppConfig = new AppConfig();
+exports.default = __AppConfig;
+//# sourceMappingURL=appConfig.js.map

package/dist/appConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"appConfig.js","sourceRoot":"","sources":["../core/appConfig.ts"],"names":[],"mappings":";AAAA,qBAAqB;;AAIrB,MAAM,SAAS;IACL,KAAK,GAAgC,EAAE,CAAC;IAEhD,GAAG,CAAC,GAAW,EAAE,KAAkB;QACjC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,GAAG,CAAkB,GAAW,EAAE,YAAgB;QAChD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM,CAAC;QAC9B,CAAC;QAED,OAAO,YAAiB,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,GAAG;QACD,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,WAAW,GAAG,IAAI,SAAS,EAAE,CAAC;AACpC,kBAAe,WAAW,CAAC"}

package/dist/configmanager/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * ConfigManager — public barrel
+ *
+ * ── Router (mount in your Express app) ───────────────────────────────────────
+ *
+ *   import { ConfigManagerApiRoutes } from '@server/core/configmanager';
+ *   app.use('/config-manager', ConfigManagerApiRoutes);
+ *
+ * ── Service (use anywhere in the codebase) ────────────────────────────────────
+ *
+ *   import ConfigManager from '@server/core/configmanager';
+ *
+ *   await ConfigManager.reloadConfigs();
+ *   const cfg = ConfigManager.getConfig('notify/email/gmail.config');
+ *
+ * ── Events ────────────────────────────────────────────────────────────────────
+ *
+ *   import ConfigManager from '@server/core/configmanager';
+ *   ConfigManager.on('config:reloaded', ({ key }) => { ... });
+ *
+ * ── Named import ──────────────────────────────────────────────────────────────
+ *
+ *   import { ConfigManager } from '@server/core/configmanager';
+ */
+export { default } from './src/service';
+export { default as ConfigManager } from './src/service';
+export declare const ConfigManagerApiRoutes: import("express-serve-static-core").Router;
+export type { ConfigMeta, ConfigRegistry } from './src/types/config.meta.types';
+export type { CacheEntry, RuntimeMeta } from './src/types/config.types';
+export type { ApiResponse, ApiSuccessResponse, ApiErrorResponse } from './src/types/api.types';
+export { configEvents } from './src/events/config.events';
+export type { ConfigEventName, ConfigEventPayload } from './src/events/config.events';
+export { parseConfig } from './src/utils/config.parser';
+export { validateConfig } from './src/utils/config.validator';
+export type { ValidationRule, ValidationResult } from './src/utils/config.validator';
+export { sanitize, getAllConfigsSafe } from './src/utils/config.serializer';
+export { scanConfigFiles } from './src/utils/config.loader';
+//# sourceMappingURL=index.d.ts.map

package/dist/configmanager/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../core/configmanager/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,eAAe,CAAC;AAMzD,eAAO,MAAM,sBAAsB,4CAAsB,CAAC;AAI1D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAChF,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACxE,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI/F,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAItF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/configmanager/index.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * ConfigManager — public barrel
+ *
+ * ── Router (mount in your Express app) ───────────────────────────────────────
+ *
+ *   import { ConfigManagerApiRoutes } from '@server/core/configmanager';
+ *   app.use('/config-manager', ConfigManagerApiRoutes);
+ *
+ * ── Service (use anywhere in the codebase) ────────────────────────────────────
+ *
+ *   import ConfigManager from '@server/core/configmanager';
+ *
+ *   await ConfigManager.reloadConfigs();
+ *   const cfg = ConfigManager.getConfig('notify/email/gmail.config');
+ *
+ * ── Events ────────────────────────────────────────────────────────────────────
+ *
+ *   import ConfigManager from '@server/core/configmanager';
+ *   ConfigManager.on('config:reloaded', ({ key }) => { ... });
+ *
+ * ── Named import ──────────────────────────────────────────────────────────────
+ *
+ *   import { ConfigManager } from '@server/core/configmanager';
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanConfigFiles = exports.getAllConfigsSafe = exports.sanitize = exports.validateConfig = exports.parseConfig = exports.configEvents = exports.ConfigManagerApiRoutes = exports.ConfigManager = exports.default = void 0;
+// ─── Service ──────────────────────────────────────────────────────────────────
+var service_1 = require("./src/service");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(service_1).default; } });
+var service_2 = require("./src/service");
+Object.defineProperty(exports, "ConfigManager", { enumerable: true, get: function () { return __importDefault(service_2).default; } });
+// ─── Router ───────────────────────────────────────────────────────────────────
+const routes_1 = require("./src/routes");
+exports.ConfigManagerApiRoutes = routes_1.ConfigManagerRoutes;
+// ─── Events ───────────────────────────────────────────────────────────────────
+var config_events_1 = require("./src/events/config.events");
+Object.defineProperty(exports, "configEvents", { enumerable: true, get: function () { return config_events_1.configEvents; } });
+// ─── Utils (for advanced consumers) ──────────────────────────────────────────
+var config_parser_1 = require("./src/utils/config.parser");
+Object.defineProperty(exports, "parseConfig", { enumerable: true, get: function () { return config_parser_1.parseConfig; } });
+var config_validator_1 = require("./src/utils/config.validator");
+Object.defineProperty(exports, "validateConfig", { enumerable: true, get: function () { return config_validator_1.validateConfig; } });
+var config_serializer_1 = require("./src/utils/config.serializer");
+Object.defineProperty(exports, "sanitize", { enumerable: true, get: function () { return config_serializer_1.sanitize; } });
+Object.defineProperty(exports, "getAllConfigsSafe", { enumerable: true, get: function () { return config_serializer_1.getAllConfigsSafe; } });
+var config_loader_1 = require("./src/utils/config.loader");
+Object.defineProperty(exports, "scanConfigFiles", { enumerable: true, get: function () { return config_loader_1.scanConfigFiles; } });
+//# sourceMappingURL=index.js.map

package/dist/configmanager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../core/configmanager/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;AAEH,iFAAiF;AAEjF,yCAAwC;AAA/B,mHAAA,OAAO,OAAA;AAChB,yCAAyD;AAAhD,yHAAA,OAAO,OAAiB;AAEjC,iFAAiF;AAEjF,yCAAmD;AAEtC,QAAA,sBAAsB,GAAG,4BAAmB,CAAC;AAQ1D,iFAAiF;AAEjF,4DAA0D;AAAjD,6GAAA,YAAY,OAAA;AAGrB,gFAAgF;AAEhF,2DAAwD;AAA/C,4GAAA,WAAW,OAAA;AACpB,iEAA8D;AAArD,kHAAA,cAAc,OAAA;AAEvB,mEAA4E;AAAnE,6GAAA,QAAQ,OAAA;AAAE,sHAAA,iBAAiB,OAAA;AACpC,2DAA4D;AAAnD,gHAAA,eAAe,OAAA"}

package/dist/configmanager/src/events/config.events.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from 'events';
+export type ConfigEventName = 'config:loaded' | 'config:reloaded' | 'config:updated' | 'config:archived' | 'config:unarchived' | 'config:deleted' | 'config:cache-flushed';
+export interface ConfigEventPayload {
+    /** Normalized cache key (lowercase, forward-slash path) */
+    key: string;
+    /** Original relative path as supplied by the caller */
+    path: string;
+    /** Optional discriminator for handlers that care about the action taken */
+    action?: string;
+}
+declare class ConfigEventEmitter extends EventEmitter {
+    emit(event: ConfigEventName, payload?: ConfigEventPayload): boolean;
+    on(event: ConfigEventName, listener: (payload: ConfigEventPayload) => void): this;
+    once(event: ConfigEventName, listener: (payload: ConfigEventPayload) => void): this;
+    off(event: ConfigEventName, listener: (payload: ConfigEventPayload) => void): this;
+}
+export declare const configEvents: ConfigEventEmitter;
+export default configEvents;
+//# sourceMappingURL=config.events.d.ts.map

package/dist/configmanager/src/events/config.events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.events.d.ts","sourceRoot":"","sources":["../../../../core/configmanager/src/events/config.events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,iBAAiB,GACjB,mBAAmB,GACnB,gBAAgB,GAChB,sBAAsB,CAAC;AAI3B,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,cAAM,kBAAmB,SAAQ,YAAY;IAC3C,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO;IAInE,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAIjF,IAAI,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAInF,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;CAGnF;AAED,eAAO,MAAM,YAAY,oBAA2B,CAAC;AACrD,eAAe,YAAY,CAAC"}

package/dist/configmanager/src/events/config.events.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configEvents = void 0;
+const events_1 = require("events");
+// ─── Typed EventEmitter ───────────────────────────────────────────────────────
+class ConfigEventEmitter extends events_1.EventEmitter {
+    emit(event, payload) {
+        return super.emit(event, payload);
+    }
+    on(event, listener) {
+        return super.on(event, listener);
+    }
+    once(event, listener) {
+        return super.once(event, listener);
+    }
+    off(event, listener) {
+        return super.off(event, listener);
+    }
+}
+exports.configEvents = new ConfigEventEmitter();
+exports.default = exports.configEvents;
+//# sourceMappingURL=config.events.js.map

package/dist/configmanager/src/events/config.events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.events.js","sourceRoot":"","sources":["../../../../core/configmanager/src/events/config.events.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAwBtC,iFAAiF;AAEjF,MAAM,kBAAmB,SAAQ,qBAAY;IAC3C,IAAI,CAAC,KAAsB,EAAE,OAA4B;QACvD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,EAAE,CAAC,KAAsB,EAAE,QAA+C;QACxE,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,KAAsB,EAAE,QAA+C;QAC1E,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,KAAsB,EAAE,QAA+C;QACzE,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;CACF;AAEY,QAAA,YAAY,GAAG,IAAI,kBAAkB,EAAE,CAAC;AACrD,kBAAe,oBAAY,CAAC"}

package/dist/configmanager/src/models/config.cache.d.ts

@@ -0,0 +1,16 @@
+import { CacheEntry } from '../types/config.types';
+declare class ConfigCache {
+    private readonly store;
+    set(key: string, entry: CacheEntry): void;
+    get(key: string): CacheEntry | undefined;
+    has(key: string): boolean;
+    delete(key: string): boolean;
+    flush(): void;
+    keys(): string[];
+    /** Returns the raw internal map for read-only iteration */
+    entries(): ReadonlyMap<string, CacheEntry>;
+    size(): number;
+}
+export declare const configCache: ConfigCache;
+export default configCache;
+//# sourceMappingURL=config.cache.d.ts.map