@kuckit/infrastructure 1.0.1 → 1.0.3

package/dist/logger-Bl10drB8.d.ts

@@ -0,0 +1,23 @@
+//#region ../domain/src/ports/logger.d.ts
+/**
+ * Logger port - structured logging for Loki/Prometheus
+ * Loki-compatible: labels and structured fields in meta
+ */
+interface Logger {
+  debug: (message: string, meta?: LogContext) => void;
+  info: (message: string, meta?: LogContext) => void;
+  warn: (message: string, meta?: LogContext) => void;
+  error: (message: string, meta?: LogContext | Error) => void;
+}
+/**
+ * Structured log context (Loki labels)
+ */
+interface LogContext {
+  requestId?: string;
+  userId?: string;
+  feature?: string;
+  [key: string]: any;
+}
+//#endregion
+export { Logger as n, LogContext as t };
+//# sourceMappingURL=logger-Bl10drB8.d.ts.map

package/dist/logging/index.d.ts

@@ -0,0 +1,5 @@
+import "../logger-Bl10drB8.js";
+import { n as makeStructuredLogger, t as StructuredLogger } from "../structured-logger-Dz06Uz-u.js";
+import { n as makeRequestLogger, t as RequestLoggerOptions } from "../request-logger-CK3SOnoz.js";
+import "../index-DVGDAddE.js";
+export { RequestLoggerOptions, StructuredLogger, makeRequestLogger, makeStructuredLogger };

package/dist/logging/index.js

@@ -0,0 +1,5 @@
+import { n as makeStructuredLogger, t as StructuredLogger } from "../structured-logger-BsxDI9zX.js";
+import { t as makeRequestLogger } from "../request-logger-Cw1XQWTV.js";
+import "../logging-4mLSrMc6.js";
+
+export { StructuredLogger, makeRequestLogger, makeStructuredLogger };

package/dist/logging/request-logger.d.ts

@@ -0,0 +1,2 @@
+import { n as makeRequestLogger, t as RequestLoggerOptions } from "../request-logger-CK3SOnoz.js";
+export { RequestLoggerOptions, makeRequestLogger };

package/dist/logging/request-logger.js

@@ -0,0 +1,3 @@
+import { t as makeRequestLogger } from "../request-logger-Cw1XQWTV.js";
+
+export { makeRequestLogger };

package/dist/logging/structured-logger.d.ts

@@ -0,0 +1,3 @@
+import "../logger-Bl10drB8.js";
+import { n as makeStructuredLogger, t as StructuredLogger } from "../structured-logger-Dz06Uz-u.js";
+export { StructuredLogger, makeStructuredLogger };

package/dist/logging/structured-logger.js

@@ -0,0 +1,3 @@
+import { n as makeStructuredLogger, t as StructuredLogger } from "../structured-logger-BsxDI9zX.js";
+
+export { StructuredLogger, makeStructuredLogger };

package/dist/logging-4mLSrMc6.js

@@ -0,0 +1 @@
+export {  };

package/dist/modules/core.module.d.ts

@@ -0,0 +1,10 @@
+import "../db-tAPHBDyL.js";
+import "../logger-Bl10drB8.js";
+import "../error-handler-BDid7SIZ.js";
+import "../index-LKrIp3Oo.js";
+import "../structured-logger-Dz06Uz-u.js";
+import "../request-logger-CK3SOnoz.js";
+import "../index-DVGDAddE.js";
+import "../types-65aFqB5L.js";
+import { t as registerCoreModule } from "../core.module-B1TdC0yX.js";
+export { registerCoreModule };

package/dist/modules/core.module.js

@@ -0,0 +1,13 @@
+import "../db-C4IcCT04.js";
+import "../structured-logger-BsxDI9zX.js";
+import "../request-logger-Cw1XQWTV.js";
+import "../logging-4mLSrMc6.js";
+import "../errors-BB_jeye8.js";
+import "../error-handler-D4s_TTI1.js";
+import "../errors-DfkerzdO.js";
+import "../in-memory-event-bus-BCyPrNAE.js";
+import "../in-memory-cache-store-oClww-8m.js";
+import "../in-memory-rate-limiter-BDSHZXxf.js";
+import { t as registerCoreModule } from "../core.module-DMtIkTcz.js";
+
+export { registerCoreModule };

package/dist/modules/index.d.ts

@@ -0,0 +1,12 @@
+import "../db-tAPHBDyL.js";
+import "../logger-Bl10drB8.js";
+import "../error-handler-BDid7SIZ.js";
+import "../index-LKrIp3Oo.js";
+import "../structured-logger-Dz06Uz-u.js";
+import "../request-logger-CK3SOnoz.js";
+import "../index-DVGDAddE.js";
+import { n as Cradle, t as Config } from "../types-65aFqB5L.js";
+import { t as registerCoreModule } from "../core.module-B1TdC0yX.js";
+import { t as registerUserModule } from "../user.module-D3lVJ98T.js";
+import "../index-B7z6dpFd.js";
+export { Config, Cradle, registerCoreModule, registerUserModule };

package/dist/modules/index.js

@@ -0,0 +1,16 @@
+import "../db-C4IcCT04.js";
+import "../user.drizzle-CgKIqqb3.js";
+import "../structured-logger-BsxDI9zX.js";
+import "../request-logger-Cw1XQWTV.js";
+import "../logging-4mLSrMc6.js";
+import "../errors-BB_jeye8.js";
+import "../error-handler-D4s_TTI1.js";
+import "../errors-DfkerzdO.js";
+import "../in-memory-event-bus-BCyPrNAE.js";
+import "../in-memory-cache-store-oClww-8m.js";
+import "../in-memory-rate-limiter-BDSHZXxf.js";
+import { t as registerCoreModule } from "../core.module-DMtIkTcz.js";
+import { t as registerUserModule } from "../user.module-BEpCbKsU.js";
+import "../modules-C_2SF3he.js";
+
+export { registerCoreModule, registerUserModule };

package/dist/modules/types.d.ts

@@ -0,0 +1,9 @@
+import "../db-tAPHBDyL.js";
+import "../logger-Bl10drB8.js";
+import "../error-handler-BDid7SIZ.js";
+import "../index-LKrIp3Oo.js";
+import "../structured-logger-Dz06Uz-u.js";
+import "../request-logger-CK3SOnoz.js";
+import "../index-DVGDAddE.js";
+import { n as Cradle, t as Config } from "../types-65aFqB5L.js";
+export { Config, Cradle };

package/dist/modules/types.js

@@ -0,0 +1,6 @@
+import "../db-C4IcCT04.js";
+import { Pool } from "pg";
+import { google } from "@ai-sdk/google";
+import { auth } from "@kuckit/auth";
+
+export {  };

package/dist/modules/user.module.d.ts

@@ -0,0 +1,10 @@
+import "../db-tAPHBDyL.js";
+import "../logger-Bl10drB8.js";
+import "../error-handler-BDid7SIZ.js";
+import "../index-LKrIp3Oo.js";
+import "../structured-logger-Dz06Uz-u.js";
+import "../request-logger-CK3SOnoz.js";
+import "../index-DVGDAddE.js";
+import "../types-65aFqB5L.js";
+import { t as registerUserModule } from "../user.module-D3lVJ98T.js";
+export { registerUserModule };

package/dist/modules/user.module.js

@@ -0,0 +1,4 @@
+import "../user.drizzle-CgKIqqb3.js";
+import { t as registerUserModule } from "../user.module-BEpCbKsU.js";
+
+export { registerUserModule };

package/dist/modules-C_2SF3he.js

@@ -0,0 +1 @@
+export {  };

package/dist/rate-limiter/in-memory-rate-limiter.d.ts

@@ -0,0 +1,2 @@
+import { t as InMemoryRateLimiterStore } from "../in-memory-rate-limiter-DJsxdZZR.js";
+export { InMemoryRateLimiterStore };

package/dist/rate-limiter/in-memory-rate-limiter.js

@@ -0,0 +1,3 @@
+import { t as InMemoryRateLimiterStore } from "../in-memory-rate-limiter-BDSHZXxf.js";
+
+export { InMemoryRateLimiterStore };

package/dist/rate-limiter/index.d.ts

@@ -0,0 +1,3 @@
+import { t as InMemoryRateLimiterStore } from "../in-memory-rate-limiter-DJsxdZZR.js";
+import { t as RateLimiterStore } from "../index-BH67NKRs.js";
+export { InMemoryRateLimiterStore, RateLimiterStore };

package/dist/rate-limiter/index.js

@@ -0,0 +1,4 @@
+import { t as InMemoryRateLimiterStore } from "../in-memory-rate-limiter-BDSHZXxf.js";
+import "../rate-limiter-BnvPGJOK.js";
+
+export { InMemoryRateLimiterStore };

package/dist/rate-limiter-BnvPGJOK.js

@@ -0,0 +1 @@
+export {  };

package/dist/repositories-nTfSJyvW.js

@@ -0,0 +1 @@
+export {  };

package/dist/request-logger-CK3SOnoz.d.ts

@@ -0,0 +1,23 @@
+import { Logger } from "@kuckit/domain/ports/logger";
+
+//#region src/logging/request-logger.d.ts
+
+/**
+ * Options for creating a request-scoped logger
+ */
+interface RequestLoggerOptions {
+  requestId: string;
+  userId?: string;
+  baseLogger: Logger;
+}
+/**
+ * Create a request-scoped logger that automatically includes
+ * requestId and userId in all log entries.
+ *
+ * This wraps the base singleton logger and enriches all log
+ * calls with request context for Loki-compatible structured logging.
+ */
+declare const makeRequestLogger: (options: RequestLoggerOptions) => Logger;
+//#endregion
+export { makeRequestLogger as n, RequestLoggerOptions as t };
+//# sourceMappingURL=request-logger-CK3SOnoz.d.ts.map

package/dist/request-logger-Cw1XQWTV.js

@@ -0,0 +1,49 @@
+//#region src/logging/request-logger.ts
+/**
+* Create a request-scoped logger that automatically includes
+* requestId and userId in all log entries.
+*
+* This wraps the base singleton logger and enriches all log
+* calls with request context for Loki-compatible structured logging.
+*/
+const makeRequestLogger = (options) => {
+	const context = {
+		requestId: options.requestId,
+		...options.userId && { userId: options.userId }
+	};
+	return {
+		debug: (message, meta) => {
+			options.baseLogger.debug(message, {
+				...context,
+				...meta
+			});
+		},
+		info: (message, meta) => {
+			options.baseLogger.info(message, {
+				...context,
+				...meta
+			});
+		},
+		warn: (message, meta) => {
+			options.baseLogger.warn(message, {
+				...context,
+				...meta
+			});
+		},
+		error: (message, meta) => {
+			if (meta instanceof Error) options.baseLogger.error(message, {
+				...context,
+				error: meta.message,
+				stack: meta.stack
+			});
+			else options.baseLogger.error(message, {
+				...context,
+				...meta
+			});
+		}
+	};
+};
+
+//#endregion
+export { makeRequestLogger as t };
+//# sourceMappingURL=request-logger-Cw1XQWTV.js.map

package/dist/request-logger-Cw1XQWTV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-logger-Cw1XQWTV.js","names":["context: LogContext"],"sources":["../src/logging/request-logger.ts"],"sourcesContent":["import type { Logger, LogContext } from '@kuckit/domain/ports/logger'\n\n/**\n * Options for creating a request-scoped logger\n */\nexport interface RequestLoggerOptions {\n\trequestId: string\n\tuserId?: string\n\tbaseLogger: Logger\n}\n\n/**\n * Create a request-scoped logger that automatically includes\n * requestId and userId in all log entries.\n *\n * This wraps the base singleton logger and enriches all log\n * calls with request context for Loki-compatible structured logging.\n */\nexport const makeRequestLogger = (options: RequestLoggerOptions): Logger => {\n\tconst context: LogContext = {\n\t\trequestId: options.requestId,\n\t\t...(options.userId && { userId: options.userId }),\n\t}\n\n\treturn {\n\t\tdebug: (message: string, meta?: LogContext) => {\n\t\t\toptions.baseLogger.debug(message, { ...context, ...meta })\n\t\t},\n\n\t\tinfo: (message: string, meta?: LogContext) => {\n\t\t\toptions.baseLogger.info(message, { ...context, ...meta })\n\t\t},\n\n\t\twarn: (message: string, meta?: LogContext) => {\n\t\t\toptions.baseLogger.warn(message, { ...context, ...meta })\n\t\t},\n\n\t\terror: (message: string, meta?: LogContext | Error) => {\n\t\t\tif (meta instanceof Error) {\n\t\t\t\toptions.baseLogger.error(message, {\n\t\t\t\t\t...context,\n\t\t\t\t\terror: meta.message,\n\t\t\t\t\tstack: meta.stack,\n\t\t\t\t})\n\t\t\t} else {\n\t\t\t\toptions.baseLogger.error(message, { ...context, ...meta })\n\t\t\t}\n\t\t},\n\t}\n}\n"],"mappings":";;;;;;;;AAkBA,MAAa,qBAAqB,YAA0C;CAC3E,MAAMA,UAAsB;EAC3B,WAAW,QAAQ;EACnB,GAAI,QAAQ,UAAU,EAAE,QAAQ,QAAQ,QAAQ;EAChD;AAED,QAAO;EACN,QAAQ,SAAiB,SAAsB;AAC9C,WAAQ,WAAW,MAAM,SAAS;IAAE,GAAG;IAAS,GAAG;IAAM,CAAC;;EAG3D,OAAO,SAAiB,SAAsB;AAC7C,WAAQ,WAAW,KAAK,SAAS;IAAE,GAAG;IAAS,GAAG;IAAM,CAAC;;EAG1D,OAAO,SAAiB,SAAsB;AAC7C,WAAQ,WAAW,KAAK,SAAS;IAAE,GAAG;IAAS,GAAG;IAAM,CAAC;;EAG1D,QAAQ,SAAiB,SAA8B;AACtD,OAAI,gBAAgB,MACnB,SAAQ,WAAW,MAAM,SAAS;IACjC,GAAG;IACH,OAAO,KAAK;IACZ,OAAO,KAAK;IACZ,CAAC;OAEF,SAAQ,WAAW,MAAM,SAAS;IAAE,GAAG;IAAS,GAAG;IAAM,CAAC;;EAG5D"}

package/dist/structured-logger-BsxDI9zX.js

@@ -0,0 +1,119 @@
+import { createWriteStream, existsSync, mkdirSync } from "fs";
+import path from "path";
+
+//#region src/logging/structured-logger.ts
+/**
+* Structured logger implementation
+* - JSON logs compatible with Loki
+* - File + stdout support
+* - Prometheus metrics collection
+*/
+var StructuredLogger = class {
+	fileStream = null;
+	metrics;
+	constructor(options = {}) {
+		this.options = options;
+		this.metrics = new MetricsCollector();
+		if (options.enableFile && options.logDir) this.initFileStream(options.logDir);
+	}
+	initFileStream(logDir) {
+		if (!existsSync(logDir)) mkdirSync(logDir, { recursive: true });
+		this.fileStream = createWriteStream(path.join(logDir, `app-${(/* @__PURE__ */ new Date()).toISOString().split("T")[0]}.log`), { flags: "a" });
+	}
+	debug(message, meta) {
+		this.log("DEBUG", message, meta);
+	}
+	info(message, meta) {
+		this.log("INFO", message, meta);
+	}
+	warn(message, meta) {
+		this.log("WARN", message, meta);
+	}
+	error(message, meta) {
+		const context = meta instanceof Error ? {
+			error: meta.message,
+			stack: meta.stack
+		} : meta;
+		this.log("ERROR", message, context);
+	}
+	log(level, message, meta) {
+		if (this.shouldSkip(level)) return;
+		const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+		const logEntry = this.formatLog(level, message, meta, timestamp);
+		console.log(logEntry);
+		if (this.fileStream) this.fileStream.write(logEntry + "\n");
+		this.metrics.recordLog(level, meta?.feature);
+	}
+	shouldSkip(level) {
+		const levels = [
+			"DEBUG",
+			"INFO",
+			"WARN",
+			"ERROR"
+		];
+		const minLevel = this.options.minLevel || "DEBUG";
+		return levels.indexOf(level) < levels.indexOf(minLevel);
+	}
+	formatLog(level, message, meta, timestamp) {
+		const logObject = {
+			timestamp,
+			level,
+			message,
+			...meta
+		};
+		if (meta?.requestId) logObject.requestId = meta.requestId;
+		if (meta?.userId) logObject.userId = meta.userId;
+		if (meta?.feature) logObject.feature = meta.feature;
+		return JSON.stringify(logObject);
+	}
+	/**
+	* Get metrics in Prometheus text format
+	*/
+	getMetrics() {
+		return this.metrics.toPrometheusFormat();
+	}
+	/**
+	* Cleanup resources
+	*/
+	async dispose() {
+		return new Promise((resolve) => {
+			if (this.fileStream) this.fileStream.end(() => resolve());
+			else resolve();
+		});
+	}
+};
+/**
+* Prometheus metrics collector
+*/
+var MetricsCollector = class {
+	logCount = new Map([
+		["DEBUG", 0],
+		["INFO", 0],
+		["WARN", 0],
+		["ERROR", 0]
+	]);
+	featureCount = /* @__PURE__ */ new Map();
+	recordLog(level, feature) {
+		this.logCount.set(level, (this.logCount.get(level) || 0) + 1);
+		if (feature) this.featureCount.set(feature, (this.featureCount.get(feature) || 0) + 1);
+	}
+	toPrometheusFormat() {
+		const lines = ["# HELP app_logs_total Total number of logs by level", "# TYPE app_logs_total counter"];
+		for (const [level, count] of this.logCount) lines.push(`app_logs_total{level="${level}"} ${count}`);
+		lines.push("");
+		lines.push("# HELP app_feature_logs_total Total logs by feature");
+		lines.push("# TYPE app_feature_logs_total counter");
+		for (const [feature, count] of this.featureCount) lines.push(`app_feature_logs_total{feature="${feature}"} ${count}`);
+		return lines.join("\n");
+	}
+};
+/**
+* Create logger instance
+*/
+const makeStructuredLogger = (options) => {
+	return new StructuredLogger(options);
+};
+
+//#endregion
+export { makeStructuredLogger as n, StructuredLogger as t };
+//# sourceMappingURL=structured-logger-BsxDI9zX.js.map

package/dist/structured-logger-BsxDI9zX.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structured-logger-BsxDI9zX.js","names":["options: {\n\t\t\tlogDir?: string\n\t\t\tenableFile?: boolean\n\t\t\tminLevel?: LogLevel\n\t\t}","levels: LogLevel[]","logObject: Record<string, any>","lines: string[]"],"sources":["../src/logging/structured-logger.ts"],"sourcesContent":["import { createWriteStream, existsSync, mkdirSync } from 'fs'\nimport path from 'path'\nimport type { Logger, LogContext } from '../../../domain/src/ports/logger'\n\ntype LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR'\n\n/**\n * Structured logger implementation\n * - JSON logs compatible with Loki\n * - File + stdout support\n * - Prometheus metrics collection\n */\nexport class StructuredLogger implements Logger {\n\tprivate fileStream: ReturnType<typeof createWriteStream> | null = null\n\tprivate metrics: MetricsCollector\n\n\tconstructor(\n\t\tprivate options: {\n\t\t\tlogDir?: string\n\t\t\tenableFile?: boolean\n\t\t\tminLevel?: LogLevel\n\t\t} = {}\n\t) {\n\t\tthis.metrics = new MetricsCollector()\n\n\t\tif (options.enableFile && options.logDir) {\n\t\t\tthis.initFileStream(options.logDir)\n\t\t}\n\t}\n\n\tprivate initFileStream(logDir: string): void {\n\t\tif (!existsSync(logDir)) {\n\t\t\tmkdirSync(logDir, { recursive: true })\n\t\t}\n\n\t\tconst logFile = path.join(logDir, `app-${new Date().toISOString().split('T')[0]}.log`)\n\t\tthis.fileStream = createWriteStream(logFile, { flags: 'a' })\n\t}\n\n\tdebug(message: string, meta?: LogContext): void {\n\t\tthis.log('DEBUG', message, meta)\n\t}\n\n\tinfo(message: string, meta?: LogContext): void {\n\t\tthis.log('INFO', message, meta)\n\t}\n\n\twarn(message: string, meta?: LogContext): void {\n\t\tthis.log('WARN', message, meta)\n\t}\n\n\terror(message: string, meta?: LogContext | Error): void {\n\t\tconst context = meta instanceof Error ? { error: meta.message, stack: meta.stack } : meta\n\t\tthis.log('ERROR', message, context)\n\t}\n\n\tprivate log(level: LogLevel, message: string, meta?: any): void {\n\t\tif (this.shouldSkip(level)) return\n\n\t\tconst timestamp = new Date().toISOString()\n\t\tconst logEntry = this.formatLog(level, message, meta, timestamp)\n\n\t\t// stdout\n\t\tconsole.log(logEntry)\n\n\t\t// file\n\t\tif (this.fileStream) {\n\t\t\tthis.fileStream.write(logEntry + '\\n')\n\t\t}\n\n\t\t// metrics\n\t\tthis.metrics.recordLog(level, meta?.feature)\n\t}\n\n\tprivate shouldSkip(level: LogLevel): boolean {\n\t\tconst levels: LogLevel[] = ['DEBUG', 'INFO', 'WARN', 'ERROR']\n\t\tconst minLevel = this.options.minLevel || 'DEBUG'\n\t\treturn levels.indexOf(level) < levels.indexOf(minLevel)\n\t}\n\n\tprivate formatLog(level: LogLevel, message: string, meta: any, timestamp: string): string {\n\t\tconst logObject: Record<string, any> = {\n\t\t\ttimestamp,\n\t\t\tlevel,\n\t\t\tmessage,\n\t\t\t...meta,\n\t\t}\n\n\t\t// Loki labels (structured fields at root level)\n\t\tif (meta?.requestId) logObject.requestId = meta.requestId\n\t\tif (meta?.userId) logObject.userId = meta.userId\n\t\tif (meta?.feature) logObject.feature = meta.feature\n\n\t\treturn JSON.stringify(logObject)\n\t}\n\n\t/**\n\t * Get metrics in Prometheus text format\n\t */\n\tgetMetrics(): string {\n\t\treturn this.metrics.toPrometheusFormat()\n\t}\n\n\t/**\n\t * Cleanup resources\n\t */\n\tasync dispose(): Promise<void> {\n\t\treturn new Promise((resolve) => {\n\t\t\tif (this.fileStream) {\n\t\t\t\tthis.fileStream.end(() => resolve())\n\t\t\t} else {\n\t\t\t\tresolve()\n\t\t\t}\n\t\t})\n\t}\n}\n\n/**\n * Prometheus metrics collector\n */\nclass MetricsCollector {\n\tprivate logCount: Map<LogLevel, number> = new Map([\n\t\t['DEBUG', 0],\n\t\t['INFO', 0],\n\t\t['WARN', 0],\n\t\t['ERROR', 0],\n\t])\n\tprivate featureCount: Map<string, number> = new Map()\n\n\trecordLog(level: LogLevel, feature?: string): void {\n\t\tthis.logCount.set(level, (this.logCount.get(level) || 0) + 1)\n\t\tif (feature) {\n\t\t\tthis.featureCount.set(feature, (this.featureCount.get(feature) || 0) + 1)\n\t\t}\n\t}\n\n\ttoPrometheusFormat(): string {\n\t\tconst lines: string[] = [\n\t\t\t'# HELP app_logs_total Total number of logs by level',\n\t\t\t'# TYPE app_logs_total counter',\n\t\t]\n\n\t\t// Log counters by level\n\t\tfor (const [level, count] of this.logCount) {\n\t\t\tlines.push(`app_logs_total{level=\"${level}\"} ${count}`)\n\t\t}\n\n\t\tlines.push('')\n\t\tlines.push('# HELP app_feature_logs_total Total logs by feature')\n\t\tlines.push('# TYPE app_feature_logs_total counter')\n\n\t\t// Log counters by feature\n\t\tfor (const [feature, count] of this.featureCount) {\n\t\t\tlines.push(`app_feature_logs_total{feature=\"${feature}\"} ${count}`)\n\t\t}\n\n\t\treturn lines.join('\\n')\n\t}\n}\n\n/**\n * Create logger instance\n */\nexport const makeStructuredLogger = (options?: {\n\tlogDir?: string\n\tenableFile?: boolean\n\tminLevel?: LogLevel\n}): StructuredLogger => {\n\treturn new StructuredLogger(options)\n}\n"],"mappings":"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"}

package/dist/structured-logger-Dz06Uz-u.d.ts

@@ -0,0 +1,47 @@
+import { n as Logger, t as LogContext } from "./logger-Bl10drB8.js";
+
+//#region src/logging/structured-logger.d.ts
+type LogLevel = 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+/**
+ * Structured logger implementation
+ * - JSON logs compatible with Loki
+ * - File + stdout support
+ * - Prometheus metrics collection
+ */
+declare class StructuredLogger implements Logger {
+  private options;
+  private fileStream;
+  private metrics;
+  constructor(options?: {
+    logDir?: string;
+    enableFile?: boolean;
+    minLevel?: LogLevel;
+  });
+  private initFileStream;
+  debug(message: string, meta?: LogContext): void;
+  info(message: string, meta?: LogContext): void;
+  warn(message: string, meta?: LogContext): void;
+  error(message: string, meta?: LogContext | Error): void;
+  private log;
+  private shouldSkip;
+  private formatLog;
+  /**
+   * Get metrics in Prometheus text format
+   */
+  getMetrics(): string;
+  /**
+   * Cleanup resources
+   */
+  dispose(): Promise<void>;
+}
+/**
+ * Create logger instance
+ */
+declare const makeStructuredLogger: (options?: {
+  logDir?: string;
+  enableFile?: boolean;
+  minLevel?: LogLevel;
+}) => StructuredLogger;
+//#endregion
+export { makeStructuredLogger as n, StructuredLogger as t };
+//# sourceMappingURL=structured-logger-Dz06Uz-u.d.ts.map

package/dist/transaction-akuz5Fch.d.ts

@@ -0,0 +1,22 @@
+import { AwilixContainer } from "awilix";
+
+//#region src/db/transaction.d.ts
+
+/**
+ * Run a function within a database transaction
+ * Creates a child scope with transaction-bound repositories
+ *
+ * Usage:
+ * ```typescript
+ * const result = await runInTransaction(container, async (txScope) => {
+ *   const { userRepository } = txScope.cradle
+ *   await userRepository.save(user)
+ *   return user
+ * })
+ * ```
+ */
+declare const runInTransaction: <T>(container: AwilixContainer, fn: (txScope: AwilixContainer) => Promise<T>) => Promise<T>;
+type TransactionFn<T> = (txScope: AwilixContainer) => Promise<T>;
+//#endregion
+export { runInTransaction as n, TransactionFn as t };
+//# sourceMappingURL=transaction-akuz5Fch.d.ts.map

package/dist/transaction-r4Sy3eC-.js

@@ -0,0 +1,35 @@
+import { t as makeDrizzleUserRepository } from "./user.drizzle-CgKIqqb3.js";
+import { asFunction, asValue } from "awilix";
+
+//#region src/db/transaction.ts
+/**
+* Run a function within a database transaction
+* Creates a child scope with transaction-bound repositories
+*
+* Usage:
+* ```typescript
+* const result = await runInTransaction(container, async (txScope) => {
+*   const { userRepository } = txScope.cradle
+*   await userRepository.save(user)
+*   return user
+* })
+* ```
+*/
+const runInTransaction = async (container, fn) => {
+	return container.resolve("db").transaction(async (tx) => {
+		const txScope = container.createScope();
+		txScope.register({
+			db: asValue(tx),
+			userRepository: asFunction(({ db }) => makeDrizzleUserRepository(db)).scoped()
+		});
+		try {
+			return await fn(txScope);
+		} finally {
+			txScope.dispose();
+		}
+	});
+};
+
+//#endregion
+export { runInTransaction as t };
+//# sourceMappingURL=transaction-r4Sy3eC-.js.map

package/dist/transaction-r4Sy3eC-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-r4Sy3eC-.js","names":[],"sources":["../src/db/transaction.ts"],"sourcesContent":["import type { AwilixContainer } from 'awilix'\nimport { asValue, asFunction } from 'awilix'\nimport type { NodePgDatabase } from 'drizzle-orm/node-postgres'\nimport { makeDrizzleUserRepository } from './drizzle/repositories/user.drizzle'\n\n/**\n * Run a function within a database transaction\n * Creates a child scope with transaction-bound repositories\n *\n * Usage:\n * ```typescript\n * const result = await runInTransaction(container, async (txScope) => {\n *   const { userRepository } = txScope.cradle\n *   await userRepository.save(user)\n *   return user\n * })\n * ```\n */\nexport const runInTransaction = async <T>(\n\tcontainer: AwilixContainer,\n\tfn: (txScope: AwilixContainer) => Promise<T>\n): Promise<T> => {\n\tconst db = container.resolve<NodePgDatabase>('db')\n\n\treturn db.transaction(async (tx) => {\n\t\t// Create child scope for transaction\n\t\tconst txScope = container.createScope()\n\n\t\t// Register transaction-bound database and repositories\n\t\ttxScope.register({\n\t\t\tdb: asValue(tx),\n\t\t\t// Re-register repositories with tx-bound db\n\t\t\tuserRepository: asFunction(({ db }) => makeDrizzleUserRepository(db)).scoped(),\n\t\t})\n\n\t\ttry {\n\t\t\t// Execute function with transaction scope\n\t\t\treturn await fn(txScope)\n\t\t} finally {\n\t\t\t// Cleanup scope\n\t\t\ttxScope.dispose()\n\t\t}\n\t})\n}\n\nexport type TransactionFn<T> = (txScope: AwilixContainer) => Promise<T>\n"],"mappings":";;;;;;;;;;;;;;;;;AAkBA,MAAa,mBAAmB,OAC/B,WACA,OACgB;AAGhB,QAFW,UAAU,QAAwB,KAAK,CAExC,YAAY,OAAO,OAAO;EAEnC,MAAM,UAAU,UAAU,aAAa;AAGvC,UAAQ,SAAS;GAChB,IAAI,QAAQ,GAAG;GAEf,gBAAgB,YAAY,EAAE,SAAS,0BAA0B,GAAG,CAAC,CAAC,QAAQ;GAC9E,CAAC;AAEF,MAAI;AAEH,UAAO,MAAM,GAAG,QAAQ;YACf;AAET,WAAQ,SAAS;;GAEjB"}

package/dist/types-65aFqB5L.d.ts

@@ -0,0 +1,62 @@
+import { t as createDb } from "./db-tAPHBDyL.js";
+import { t as ErrorHandler } from "./error-handler-BDid7SIZ.js";
+import { t as StructuredLogger } from "./structured-logger-Dz06Uz-u.js";
+import { Pool } from "pg";
+import { CacheStore, Clock, EventBus, EventPublisher, Logger, RateLimiterStore, User, UserRepository } from "@kuckit/domain";
+import { google } from "@ai-sdk/google";
+import { auth } from "@kuckit/auth";
+
+//#region src/modules/types.d.ts
+
+/**
+ * Application configuration
+ */
+interface Config {
+  databaseUrl: string;
+  port: number;
+  corsOrigin: string;
+  googleAiApiKey: string;
+  logLevel: 'DEBUG' | 'INFO' | 'WARN' | 'ERROR';
+  enableFileLogging: boolean;
+  logDir: string;
+}
+/**
+ * Typed Cradle interface for full type safety
+ * Includes all registrations from all modules
+ */
+interface Cradle {
+  config: Config;
+  dbPool: Pool;
+  db: ReturnType<typeof createDb>;
+  clock: Clock;
+  logger: Logger & StructuredLogger;
+  errorHandler: ErrorHandler;
+  auth: typeof auth;
+  aiProvider: ReturnType<typeof google>;
+  eventBus: EventBus;
+  cacheStore: CacheStore;
+  rateLimiterStore: RateLimiterStore;
+  userRepository: UserRepository;
+  getUserProfile: (input: {
+    userId: string;
+  }) => Promise<User>;
+  updateUserProfile: (input: {
+    userId: string;
+    updates: Partial<{
+      name: string;
+      email: string;
+    }>;
+  }) => Promise<User>;
+  createUser: (input: {
+    name: string;
+    email: string;
+    emailVerified: boolean;
+  }) => Promise<User>;
+  eventPublisher: EventPublisher;
+  session?: any;
+  requestId: string;
+  requestLogger: Logger;
+}
+//#endregion
+export { Cradle as n, Config as t };
+//# sourceMappingURL=types-65aFqB5L.d.ts.map

package/dist/use-case-decorator-DzPSPSv5.d.ts

@@ -0,0 +1,52 @@
+import { n as Logger } from "./logger-Bl10drB8.js";
+
+//#region src/decorators/use-case-decorator.d.ts
+
+/**
+ * Use case decorator type
+ * Wraps a use case function with cross-cutting concerns
+ */
+type UseCase<T extends (...args: any[]) => Promise<any>> = T;
+/**
+ * Decorator context passed to all decorators
+ */
+interface DecoratorContext {
+  logger: Logger;
+  requestId?: string;
+  userId?: string;
+  feature?: string;
+}
+/**
+ * Performance metrics collected by decorator
+ */
+interface PerformanceMetrics {
+  startTime: number;
+  endTime: number;
+  durationMs: number;
+}
+/**
+ * Base decorator that adds performance monitoring
+ */
+declare const withPerformanceMonitoring: <T extends (...args: any[]) => Promise<any>>(useCase: T, context: DecoratorContext, featureName: string) => T;
+/**
+ * Base decorator that adds error handling and conversion
+ */
+declare const withErrorHandling: <T extends (...args: any[]) => Promise<any>>(useCase: T, context: DecoratorContext, featureName: string) => T;
+/**
+ * Request tracing decorator - adds context to logs
+ */
+declare const withRequestTracing: <T extends (...args: any[]) => Promise<any>>(useCase: T, context: DecoratorContext, featureName: string) => T;
+/**
+ * Compose multiple decorators together
+ * Order: Tracing → Performance → Error Handling
+ * (outermost → innermost)
+ */
+declare const decorateUseCase: <T extends (...args: any[]) => Promise<any>>(useCase: T, context: DecoratorContext, featureName: string) => T;
+/**
+ * Factory for creating decorated use cases
+ * Used in dependency injection to wrap use cases automatically
+ */
+declare const makeDecoratedUseCase: <T extends (...args: any[]) => Promise<any>>(useCase: T, context: DecoratorContext, featureName: string) => T;
+//#endregion
+export { makeDecoratedUseCase as a, withRequestTracing as c, decorateUseCase as i, PerformanceMetrics as n, withErrorHandling as o, UseCase as r, withPerformanceMonitoring as s, DecoratorContext as t };
+//# sourceMappingURL=use-case-decorator-DzPSPSv5.d.ts.map