semola 0.5.2 → 0.5.4

package/dist/lib/logging/index.mjs

@@ -0,0 +1,374 @@
+import { mightThrowSync } from "../errors/index.mjs";
+import { basename, dirname, extname, join } from "node:path";
+import { appendFileSync, existsSync, mkdirSync, statSync } from "node:fs";
+//#region src/lib/logging/formatter/index.ts
+var Formatter = class {
+	dateFmt;
+	constructor(dateFmt) {
+		this.dateFmt = dateFmt;
+	}
+};
+var BaseFormatter = class extends Formatter {
+	constructor(dateFmt = isoDateTimeFormat) {
+		super(dateFmt);
+	}
+	format(logData) {
+		let { prefix, level, msg, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const levelType = level.toUpperCase();
+		if (typeof msg === "object") msg = JSON.stringify(msg);
+		const fileData = `${prefix}/${fileName}:${row}:${column}`;
+		let header = `[${levelType}]`;
+		if (method) header = `${header}\t[${method}]\t[${fileData}]`;
+		else header = `${header}\t[${fileData}]`;
+		return `${timestamp}  ${header} : ${msg}`;
+	}
+	formatError(logData, error) {
+		const { prefix, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const fileData = `${prefix}/${fileName}:${row}:${column}`;
+		let errorMsg = `Error name="${error.name}" Error message="${error.message}"`;
+		let header = "[ERROR]";
+		if (method) header = `${header}\t[${method}]\t[${fileData}]`;
+		else header = `${header}\t[${fileData}]`;
+		if (error.cause) errorMsg = `${errorMsg}\n\tError cause="${error.cause}"`;
+		if (error.stack) errorMsg = `${errorMsg}\n\tStack trace="${error.stack}"`;
+		return `${timestamp}  ${header} : ${errorMsg}`;
+	}
+};
+var JSONFormatter = class extends Formatter {
+	constructor(dateFmt = isoDateTimeFormat) {
+		super(dateFmt);
+	}
+	format(logData) {
+		const { prefix, level, msg, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		const levelType = level.toUpperCase();
+		let position = {};
+		if (method) position = { method };
+		position = {
+			...position,
+			fileName,
+			row,
+			column
+		};
+		return JSON.stringify({
+			timestamp,
+			level: levelType,
+			prefix,
+			position,
+			msg
+		});
+	}
+	formatError(logData, error) {
+		const { prefix, fileName, row, column, method } = logData;
+		const timestamp = this.dateFmt();
+		let errorMsg = {
+			errorName: error.name,
+			errorMessage: error.message
+		};
+		let position = {};
+		if (method) position = { method };
+		position = {
+			...position,
+			fileName,
+			row,
+			column
+		};
+		if (error.cause) errorMsg = {
+			...errorMsg,
+			errorCause: error.cause
+		};
+		if (error.stack) errorMsg = {
+			...errorMsg,
+			stackTrace: error.stack
+		};
+		return JSON.stringify({
+			timestamp,
+			level: "ERROR",
+			prefix,
+			position,
+			msg: errorMsg
+		});
+	}
+};
+function isoDateTimeFormat() {
+	return (/* @__PURE__ */ new Date()).toISOString();
+}
+function isoDateFormat() {
+	const date = isoDateTimeFormat().split("T")[0];
+	if (!date) return "";
+	return date;
+}
+function dmyFormat() {
+	const isoDate = isoDateFormat();
+	if (!isoDate) return "";
+	const info = isoDate.split("-");
+	return `${info[2]}-${info[1]}-${info[0]}`;
+}
+function mdyFormat() {
+	const isoDate = isoDateFormat();
+	if (!isoDate) return "";
+	const info = isoDate.split("-");
+	return `${info[1]}-${info[2]}-${info[0]}`;
+}
+//#endregion
+//#region src/lib/logging/core/index.ts
+const PROVIDER_OPTION_DEFAULT = {
+	formatter: new BaseFormatter(),
+	level: "debug"
+};
+const STACK_FRAME_IDX = 1;
+var StackData = class {
+	stack = [];
+	constructor(fn) {
+		const oldStackTrace = Error.prepareStackTrace;
+		const [stackTraceError] = mightThrowSync(() => {
+			Error.prepareStackTrace = (_, stack) => {
+				return stack.map((callSite) => {
+					return {
+						fileName: callSite.getFileName(),
+						column: callSite.getColumnNumber(),
+						row: callSite.getLineNumber(),
+						functionCall: callSite.getFunctionName()
+					};
+				});
+			};
+			Error.captureStackTrace(this, fn);
+			this.stack;
+		});
+		Error.prepareStackTrace = oldStackTrace;
+		if (stackTraceError) this.stack = [];
+	}
+	retrieveFrame() {
+		if (this.stack.length === 0) return void 0;
+		return this.stack[STACK_FRAME_IDX];
+	}
+};
+var AbstractLogger = class {
+	providers;
+	prefix;
+	constructor(prefix, providers) {
+		this.prefix = prefix;
+		this.providers = providers;
+	}
+	createLogData(level, msg, prefix) {
+		const logCall = new StackData(this.createLogData).retrieveFrame();
+		let logData = {
+			level,
+			msg,
+			prefix
+		};
+		if (!logCall) return logData;
+		const { column, fileName, functionCall, row } = logCall;
+		if (fileName) logData = {
+			...logData,
+			fileName: basename(fileName)
+		};
+		if (column) logData = {
+			...logData,
+			column: String(column)
+		};
+		if (row) logData = {
+			...logData,
+			row: String(row)
+		};
+		if (functionCall) logData = {
+			...logData,
+			method: functionCall
+		};
+		return logData;
+	}
+};
+var Logger = class extends AbstractLogger {
+	debug(msg) {
+		const data = this.createLogData("debug", msg, this.prefix);
+		this.run(data);
+	}
+	info(msg) {
+		const data = this.createLogData("info", msg, this.prefix);
+		this.run(data);
+	}
+	warning(msg) {
+		const data = this.createLogData("warning", msg, this.prefix);
+		this.run(data);
+	}
+	error(msg) {
+		const data = this.createLogData("error", msg, this.prefix);
+		this.run(data);
+	}
+	critical(msg) {
+		const data = this.createLogData("critical", msg, this.prefix);
+		this.run(data);
+	}
+	run(data) {
+		for (let i = 0; i < this.providers.length; i++) this.providers[i]?.execute(data);
+	}
+};
+//#endregion
+//#region src/lib/logging/core/types.ts
+const LogLevel = {
+	debug: 10,
+	info: 20,
+	warning: 30,
+	error: 40,
+	critical: 50
+};
+//#endregion
+//#region src/lib/logging/provider/index.ts
+const DEFAULT_MAX_SIZE = 4 * 1024;
+const DurationUnit = {
+	hour: 1e3 * 60 * 60,
+	day: 1e3 * 60 * 60 * 24,
+	week: 1e3 * 60 * 60 * 24 * 7,
+	month: 1e3 * 60 * 60 * 24 * 7 * 4.345
+};
+var LoggerProvider = class {
+	options;
+	constructor(options = PROVIDER_OPTION_DEFAULT) {
+		this.options = {
+			...PROVIDER_OPTION_DEFAULT,
+			...options
+		};
+	}
+	getLogLevel() {
+		if (!this.options.level) return LogLevel.debug;
+		return LogLevel[this.options.level];
+	}
+};
+const FILE_PROVIDER_OPTION_DEFAULT = {
+	...PROVIDER_OPTION_DEFAULT,
+	policy: { type: "size" }
+};
+var FileProvider = class extends LoggerProvider {
+	filePath;
+	counter;
+	file;
+	policy;
+	constructor(file, options = FILE_PROVIDER_OPTION_DEFAULT) {
+		super({
+			formatter: options.formatter ?? PROVIDER_OPTION_DEFAULT.formatter,
+			level: options.level ?? PROVIDER_OPTION_DEFAULT.level
+		});
+		this.policy = options.policy ?? FILE_PROVIDER_OPTION_DEFAULT.policy;
+		this.filePath = file;
+		this.counter = 0;
+		this.file = this.createNewFileName();
+	}
+	execute(data) {
+		if (this.getLogLevel() > LogLevel[data.level]) return;
+		const [error, formattedMessage] = mightThrowSync(() => {
+			if (this.isJSONFile()) return JSON.stringify({
+				timestamp: isoDateTimeFormat(),
+				level: data.level,
+				message: data.msg
+			});
+			const { formatter } = this.options;
+			return formatter?.format(data) ?? "";
+		});
+		const [fsError] = mightThrowSync(() => {
+			if (error && error instanceof Error) {
+				const { formatter } = this.options;
+				const errorMsg = formatter?.formatError(data, error);
+				appendFileSync(this.file, `${errorMsg}\n`);
+			}
+			if (this.canRollFile()) {
+				this.counter += 1;
+				this.file = this.createNewFileName();
+			}
+			if (error || !formattedMessage) return;
+			appendFileSync(this.file, `${formattedMessage}\n`);
+		});
+		if (fsError && fsError instanceof Error) throw fsError;
+	}
+	canRollFile() {
+		if (!this.policy) return false;
+		switch (this.policy.type) {
+			case "size":
+				if (this.policy.maxSize) return this.getFileSize() >= this.policy.maxSize;
+				return this.getFileSize() >= DEFAULT_MAX_SIZE;
+			case "time": {
+				if (!existsSync(this.file)) return false;
+				const { duration, instant } = this.policy;
+				const { birthtime } = statSync(this.file);
+				const creationTimeMs = birthtime.getTime();
+				const currenTimeMs = Date.now();
+				const diffMs = currenTimeMs - creationTimeMs;
+				switch (instant) {
+					case "hour": return Math.floor(diffMs / DurationUnit.hour) >= duration;
+					case "day": return Math.floor(diffMs / DurationUnit.day) >= duration;
+					case "week": return Math.floor(diffMs / DurationUnit.week) >= duration;
+					case "month": {
+						const currentDate = new Date(currenTimeMs);
+						const monthsDiff = (currentDate.getFullYear() - birthtime.getFullYear()) * 12 + (currentDate.getMonth() - birthtime.getMonth());
+						return (currentDate.getDate() >= birthtime.getDate() ? monthsDiff : monthsDiff - 1) >= duration;
+					}
+				}
+			}
+		}
+	}
+	getFileSize() {
+		if (!existsSync(this.file)) return 0;
+		const [statError, size] = mightThrowSync(() => {
+			const { size } = statSync(this.file);
+			return size;
+		});
+		if (statError && statError instanceof Error) return 0;
+		if (!size) return 0;
+		return size;
+	}
+	isJSONFile() {
+		return extname(this.filePath) === ".json";
+	}
+	createNewFileName() {
+		const fileName = basename(this.filePath);
+		const directory = dirname(this.filePath);
+		if (!existsSync(directory)) mkdirSync(directory, { recursive: true });
+		const fileInfo = fileName.split(".");
+		const extension = fileInfo.pop();
+		return join(directory, [
+			...fileInfo,
+			this.counter,
+			extension
+		].join("."));
+	}
+};
+var ConsoleProvider = class extends LoggerProvider {
+	execute(data) {
+		const level = this.getLogLevel();
+		const userLevel = LogLevel[data.level];
+		if (level > userLevel) return;
+		const [error, formattedMessage] = mightThrowSync(() => {
+			const { formatter } = this.options;
+			return formatter?.format(data) ?? "";
+		});
+		if (error && error instanceof Error) {
+			const { formatter } = this.options;
+			console.error(formatter?.formatError(data, error));
+			return;
+		}
+		if (!formattedMessage) return;
+		switch (userLevel) {
+			case LogLevel.debug:
+				console.debug(formattedMessage);
+				break;
+			case LogLevel.info:
+				console.info(formattedMessage);
+				break;
+			case LogLevel.warning:
+				console.warn(formattedMessage);
+				break;
+			case LogLevel.error:
+				console.error(formattedMessage);
+				break;
+			case LogLevel.critical:
+				console.error(formattedMessage);
+				break;
+			default:
+				console.debug(formattedMessage);
+				break;
+		}
+	}
+};
+//#endregion
+export { AbstractLogger, BaseFormatter, ConsoleProvider, FileProvider, Formatter, JSONFormatter, LogLevel, Logger, LoggerProvider, dmyFormat, isoDateFormat, isoDateTimeFormat, mdyFormat };

package/dist/lib/policy/index.cjs

@@ -1,5 +1,191 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_helpers = require("../../policy/helpers.cjs");
+//#region src/lib/policy/helpers.ts
+const _brand = Symbol("conditionHelper");
+const eq = (value) => {
+	const fn = (actual) => actual === value;
+	return {
+		[_brand]: fn,
+		operator: "eq",
+		value,
+		fn
+	};
+};
+const neq = (value) => {
+	const fn = (actual) => actual !== value;
+	return {
+		[_brand]: fn,
+		operator: "neq",
+		value,
+		fn
+	};
+};
+const gt = (value) => {
+	const fn = (actual) => actual > value;
+	return {
+		[_brand]: fn,
+		operator: "gt",
+		value,
+		fn
+	};
+};
+const gte = (value) => {
+	const fn = (actual) => actual >= value;
+	return {
+		[_brand]: fn,
+		operator: "gte",
+		value,
+		fn
+	};
+};
+const lt = (value) => {
+	const fn = (actual) => actual < value;
+	return {
+		[_brand]: fn,
+		operator: "lt",
+		value,
+		fn
+	};
+};
+const lte = (value) => {
+	const fn = (actual) => actual <= value;
+	return {
+		[_brand]: fn,
+		operator: "lte",
+		value,
+		fn
+	};
+};
+const not = (inner) => {
+	const fn = (actual) => !inner.fn(actual);
+	return {
+		[_brand]: fn,
+		operator: "not",
+		value: inner,
+		fn
+	};
+};
+const and = (...helpers) => {
+	const fn = (actual) => helpers.every((h) => h.fn(actual));
+	return {
+		[_brand]: fn,
+		operator: "and",
+		value: helpers,
+		fn
+	};
+};
+const or = (...helpers) => {
+	const fn = (actual) => helpers.some((h) => h.fn(actual));
+	return {
+		[_brand]: fn,
+		operator: "or",
+		value: helpers,
+		fn
+	};
+};
+const startsWith = (prefix) => {
+	const fn = (actual) => actual.startsWith(prefix);
+	return {
+		[_brand]: fn,
+		operator: "startsWith",
+		value: prefix,
+		fn
+	};
+};
+const endsWith = (suffix) => {
+	const fn = (actual) => actual.endsWith(suffix);
+	return {
+		[_brand]: fn,
+		operator: "endsWith",
+		value: suffix,
+		fn
+	};
+};
+const includes = (substring) => {
+	const fn = (actual) => actual.includes(substring);
+	return {
+		[_brand]: fn,
+		operator: "includes",
+		value: substring,
+		fn
+	};
+};
+const matches = (pattern) => {
+	const fn = (actual) => {
+		pattern.lastIndex = 0;
+		return pattern.test(actual);
+	};
+	return {
+		[_brand]: fn,
+		operator: "matches",
+		value: pattern,
+		fn
+	};
+};
+const has = (items) => {
+	const fn = (actual) => {
+		if (Array.isArray(items)) return items.every((item) => actual.includes(item));
+		return actual.includes(items);
+	};
+	return {
+		[_brand]: fn,
+		operator: "has",
+		value: items,
+		fn
+	};
+};
+const hasAny = (items) => {
+	const normalized = Array.isArray(items) ? items : [items];
+	const fn = (actual) => normalized.some((item) => actual.includes(item));
+	return {
+		[_brand]: fn,
+		operator: "hasAny",
+		value: items,
+		fn
+	};
+};
+const hasLength = (length) => {
+	const fn = (actual) => {
+		const len = actual.length;
+		if (typeof length === "number") return len === length;
+		if (length.min !== void 0 && len < length.min) return false;
+		if (length.max !== void 0 && len > length.max) return false;
+		return true;
+	};
+	return {
+		[_brand]: fn,
+		operator: "hasLength",
+		value: length,
+		fn
+	};
+};
+const isEmpty = () => {
+	const fn = (actual) => actual.length === 0;
+	return {
+		[_brand]: fn,
+		operator: "isEmpty",
+		value: void 0,
+		fn
+	};
+};
+const isDefined = () => {
+	const fn = (actual) => actual !== null && actual !== void 0;
+	return {
+		[_brand]: fn,
+		operator: "isDefined",
+		value: void 0,
+		fn
+	};
+};
+const isNullish = () => {
+	const fn = (actual) => actual === null || actual === void 0;
+	return {
+		[_brand]: fn,
+		operator: "isNullish",
+		value: void 0,
+		fn
+	};
+};
+//#endregion
 //#region src/lib/policy/index.ts
 var Policy = class {
 	rules = [];
@@ -78,22 +264,22 @@ var Policy = class {
 };
 //#endregion
 exports.Policy = Policy;
-exports.and = require_helpers.and;
-exports.endsWith = require_helpers.endsWith;
-exports.eq = require_helpers.eq;
-exports.gt = require_helpers.gt;
-exports.gte = require_helpers.gte;
-exports.has = require_helpers.has;
-exports.hasAny = require_helpers.hasAny;
-exports.hasLength = require_helpers.hasLength;
-exports.includes = require_helpers.includes;
-exports.isDefined = require_helpers.isDefined;
-exports.isEmpty = require_helpers.isEmpty;
-exports.isNullish = require_helpers.isNullish;
-exports.lt = require_helpers.lt;
-exports.lte = require_helpers.lte;
-exports.matches = require_helpers.matches;
-exports.neq = require_helpers.neq;
-exports.not = require_helpers.not;
-exports.or = require_helpers.or;
-exports.startsWith = require_helpers.startsWith;
+exports.and = and;
+exports.endsWith = endsWith;
+exports.eq = eq;
+exports.gt = gt;
+exports.gte = gte;
+exports.has = has;
+exports.hasAny = hasAny;
+exports.hasLength = hasLength;
+exports.includes = includes;
+exports.isDefined = isDefined;
+exports.isEmpty = isEmpty;
+exports.isNullish = isNullish;
+exports.lt = lt;
+exports.lte = lte;
+exports.matches = matches;
+exports.neq = neq;
+exports.not = not;
+exports.or = or;
+exports.startsWith = startsWith;

package/dist/lib/policy/index.d.cts

@@ -1,6 +1,63 @@
-import { ConditionHelper, and, endsWith, eq, gt, gte, has, hasAny, hasLength, includes, isDefined, isEmpty, isNullish, lt, lte, matches, neq, not, or, startsWith } from "../../policy/helpers.cjs";
-import { Action, AllowParams, ForbidParams } from "../../policy/types.cjs";
-
+//#region src/lib/policy/helpers.d.ts
+declare const _brand: unique symbol;
+type ConditionHelper<V> = {
+  readonly [_brand]: (actual: V) => boolean;
+  operator: string;
+  value: unknown;
+  fn: (actual: V) => boolean;
+};
+declare const eq: <V>(value: V) => ConditionHelper<V>;
+declare const neq: <V>(value: V) => ConditionHelper<V>;
+declare const gt: {
+  (value: Date): ConditionHelper<Date>;
+  (value: number): ConditionHelper<number>;
+  (value: string): ConditionHelper<string>;
+};
+declare const gte: {
+  (value: Date): ConditionHelper<Date>;
+  (value: number): ConditionHelper<number>;
+  (value: string): ConditionHelper<string>;
+};
+declare const lt: {
+  (value: Date): ConditionHelper<Date>;
+  (value: number): ConditionHelper<number>;
+  (value: string): ConditionHelper<string>;
+};
+declare const lte: {
+  (value: Date): ConditionHelper<Date>;
+  (value: number): ConditionHelper<number>;
+  (value: string): ConditionHelper<string>;
+};
+declare const not: <V>(inner: ConditionHelper<V>) => ConditionHelper<V>;
+declare const and: <V>(...helpers: ConditionHelper<V>[]) => ConditionHelper<V>;
+declare const or: <V>(...helpers: ConditionHelper<V>[]) => ConditionHelper<V>;
+declare const startsWith: (prefix: string) => ConditionHelper<string>;
+declare const endsWith: (suffix: string) => ConditionHelper<string>;
+declare const includes: (substring: string) => ConditionHelper<string>;
+declare const matches: (pattern: RegExp) => ConditionHelper<string>;
+declare const has: <V>(items: V | V[]) => ConditionHelper<V[]>;
+declare const hasAny: <V>(items: V | V[]) => ConditionHelper<V[]>;
+type HasLengthArg = number | {
+  min?: number;
+  max?: number;
+};
+declare const hasLength: (length: HasLengthArg) => ConditionHelper<string | unknown[]>;
+declare const isEmpty: () => ConditionHelper<string | unknown[]>;
+declare const isDefined: () => ConditionHelper<unknown>;
+declare const isNullish: () => ConditionHelper<unknown>;
+//#endregion
+//#region src/lib/policy/types.d.ts
+type Action = "read" | "create" | "update" | "delete" | (string & {});
+type ConditionValue<V> = V extends Record<string, unknown> ? ConditionHelper<V> | Conditions<V> : ConditionHelper<V>;
+type Conditions<T = Record<string, unknown>> = { [K in keyof T]?: ConditionValue<T[K]> };
+type PolicyRuleParams<T = Record<string, unknown>> = {
+  action: Action | Action[];
+  conditions?: Conditions<T>;
+  reason?: string;
+};
+type AllowParams<T = Record<string, unknown>> = PolicyRuleParams<T>;
+type ForbidParams<T = Record<string, unknown>> = PolicyRuleParams<T>;
+//#endregion
 //#region src/lib/policy/index.d.ts
 declare class Policy<TEntity extends Record<string, unknown> = Record<string, unknown>> {
   private rules;
@@ -17,5 +74,4 @@ declare class Policy<TEntity extends Record<string, unknown> = Record<string, un
   private matchValue;
 }
 //#endregion
-export { type ConditionHelper, Policy, and, endsWith, eq, gt, gte, has, hasAny, hasLength, includes, isDefined, isEmpty, isNullish, lt, lte, matches, neq, not, or, startsWith };
-//# sourceMappingURL=index.d.cts.map
+export { type ConditionHelper, Policy, and, endsWith, eq, gt, gte, has, hasAny, hasLength, includes, isDefined, isEmpty, isNullish, lt, lte, matches, neq, not, or, startsWith };