@kuckit/infrastructure 1.0.2 → 1.0.3

package/dist/use-case-decorator-GmDeYViz.js

@@ -0,0 +1,118 @@
+import { t as AppError } from "./errors-BB_jeye8.js";
+
+//#region src/decorators/use-case-decorator.ts
+/**
+* Base decorator that adds performance monitoring
+*/
+const withPerformanceMonitoring = (useCase, context, featureName) => {
+	return (async (...args) => {
+		const startTime = Date.now();
+		try {
+			const result = await useCase(...args);
+			const durationMs = Date.now() - startTime;
+			context.logger.debug(`${featureName}_completed`, {
+				requestId: context.requestId,
+				feature: featureName,
+				durationMs
+			});
+			return result;
+		} catch (error) {
+			const durationMs = Date.now() - startTime;
+			if (error instanceof AppError) context.logger.debug(`${featureName}_error`, {
+				requestId: context.requestId,
+				feature: featureName,
+				durationMs,
+				code: error.code,
+				severity: error.severity
+			});
+			throw error;
+		}
+	});
+};
+/**
+* Base decorator that adds error handling and conversion
+*/
+const withErrorHandling = (useCase, context, featureName) => {
+	return (async (...args) => {
+		try {
+			return await useCase(...args);
+		} catch (error) {
+			if (error instanceof AppError) throw error;
+			if (error instanceof Error) {
+				context.logger.error(`${featureName}_unexpected_error`, {
+					requestId: context.requestId,
+					feature: featureName,
+					errorName: error.name,
+					errorMessage: error.message,
+					stack: error.stack
+				});
+				throw new AppError("INTERNAL_SERVER_ERROR", `Unexpected error in ${featureName}`, {
+					statusCode: 500,
+					meta: {
+						originalError: error.message,
+						feature: featureName
+					}
+				});
+			}
+			context.logger.error(`${featureName}_unknown_error`, {
+				requestId: context.requestId,
+				feature: featureName
+			});
+			throw new AppError("INTERNAL_SERVER_ERROR", `Unknown error in ${featureName}`, {
+				statusCode: 500,
+				meta: { feature: featureName }
+			});
+		}
+	});
+};
+/**
+* Request tracing decorator - adds context to logs
+*/
+const withRequestTracing = (useCase, context, featureName) => {
+	return (async (...args) => {
+		context.logger.info(`${featureName}_started`, {
+			requestId: context.requestId,
+			userId: context.userId,
+			feature: featureName
+		});
+		try {
+			const result = await useCase(...args);
+			context.logger.info(`${featureName}_success`, {
+				requestId: context.requestId,
+				userId: context.userId,
+				feature: featureName
+			});
+			return result;
+		} catch (error) {
+			context.logger.error(`${featureName}_failed`, {
+				requestId: context.requestId,
+				userId: context.userId,
+				feature: featureName,
+				error: error instanceof Error ? error.message : "Unknown error"
+			});
+			throw error;
+		}
+	});
+};
+/**
+* Compose multiple decorators together
+* Order: Tracing → Performance → Error Handling
+* (outermost → innermost)
+*/
+const decorateUseCase = (useCase, context, featureName) => {
+	let decorated = withErrorHandling(useCase, context, featureName);
+	decorated = withPerformanceMonitoring(decorated, context, featureName);
+	decorated = withRequestTracing(decorated, context, featureName);
+	return decorated;
+};
+/**
+* Factory for creating decorated use cases
+* Used in dependency injection to wrap use cases automatically
+*/
+const makeDecoratedUseCase = (useCase, context, featureName) => {
+	return decorateUseCase(useCase, context, featureName);
+};
+
+//#endregion
+export { withRequestTracing as a, withPerformanceMonitoring as i, makeDecoratedUseCase as n, withErrorHandling as r, decorateUseCase as t };
+//# sourceMappingURL=use-case-decorator-GmDeYViz.js.map

package/dist/use-case-decorator-GmDeYViz.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-case-decorator-GmDeYViz.js","names":[],"sources":["../src/decorators/use-case-decorator.ts"],"sourcesContent":["import type { Logger } from '../../../domain/src/ports/logger'\nimport { AppError } from '../../../domain/src/errors'\n\n/**\n * Use case decorator type\n * Wraps a use case function with cross-cutting concerns\n */\nexport type UseCase<T extends (...args: any[]) => Promise<any>> = T\n\n/**\n * Decorator context passed to all decorators\n */\nexport interface DecoratorContext {\n\tlogger: Logger\n\trequestId?: string\n\tuserId?: string\n\tfeature?: string\n}\n\n/**\n * Performance metrics collected by decorator\n */\nexport interface PerformanceMetrics {\n\tstartTime: number\n\tendTime: number\n\tdurationMs: number\n}\n\n/**\n * Base decorator that adds performance monitoring\n */\nexport const withPerformanceMonitoring = <T extends (...args: any[]) => Promise<any>>(\n\tuseCase: T,\n\tcontext: DecoratorContext,\n\tfeatureName: string\n): T => {\n\treturn (async (...args: Parameters<T>) => {\n\t\tconst startTime = Date.now()\n\n\t\ttry {\n\t\t\tconst result = await useCase(...args)\n\t\t\tconst durationMs = Date.now() - startTime\n\n\t\t\tcontext.logger.debug(`${featureName}_completed`, {\n\t\t\t\trequestId: context.requestId,\n\t\t\t\tfeature: featureName,\n\t\t\t\tdurationMs,\n\t\t\t})\n\n\t\t\treturn result\n\t\t} catch (error) {\n\t\t\tconst durationMs = Date.now() - startTime\n\n\t\t\t// Log even errors with timing\n\t\t\tif (error instanceof AppError) {\n\t\t\t\tcontext.logger.debug(`${featureName}_error`, {\n\t\t\t\t\trequestId: context.requestId,\n\t\t\t\t\tfeature: featureName,\n\t\t\t\t\tdurationMs,\n\t\t\t\t\tcode: error.code,\n\t\t\t\t\tseverity: error.severity,\n\t\t\t\t})\n\t\t\t}\n\n\t\t\tthrow error\n\t\t}\n\t}) as T\n}\n\n/**\n * Base decorator that adds error handling and conversion\n */\nexport const withErrorHandling = <T extends (...args: any[]) => Promise<any>>(\n\tuseCase: T,\n\tcontext: DecoratorContext,\n\tfeatureName: string\n): T => {\n\treturn (async (...args: Parameters<T>) => {\n\t\ttry {\n\t\t\treturn await useCase(...args)\n\t\t} catch (error) {\n\t\t\t// AppErrors pass through (already have proper structure)\n\t\t\tif (error instanceof AppError) {\n\t\t\t\tthrow error\n\t\t\t}\n\n\t\t\t// Wrap unexpected errors\n\t\t\tif (error instanceof Error) {\n\t\t\t\tcontext.logger.error(`${featureName}_unexpected_error`, {\n\t\t\t\t\trequestId: context.requestId,\n\t\t\t\t\tfeature: featureName,\n\t\t\t\t\terrorName: error.name,\n\t\t\t\t\terrorMessage: error.message,\n\t\t\t\t\tstack: error.stack,\n\t\t\t\t})\n\n\t\t\t\tthrow new AppError('INTERNAL_SERVER_ERROR' as any, `Unexpected error in ${featureName}`, {\n\t\t\t\t\tstatusCode: 500,\n\t\t\t\t\tmeta: {\n\t\t\t\t\t\toriginalError: error.message,\n\t\t\t\t\t\tfeature: featureName,\n\t\t\t\t\t},\n\t\t\t\t})\n\t\t\t}\n\n\t\t\t// Unknown errors\n\t\t\tcontext.logger.error(`${featureName}_unknown_error`, {\n\t\t\t\trequestId: context.requestId,\n\t\t\t\tfeature: featureName,\n\t\t\t})\n\n\t\t\tthrow new AppError('INTERNAL_SERVER_ERROR' as any, `Unknown error in ${featureName}`, {\n\t\t\t\tstatusCode: 500,\n\t\t\t\tmeta: { feature: featureName },\n\t\t\t})\n\t\t}\n\t}) as T\n}\n\n/**\n * Request tracing decorator - adds context to logs\n */\nexport const withRequestTracing = <T extends (...args: any[]) => Promise<any>>(\n\tuseCase: T,\n\tcontext: DecoratorContext,\n\tfeatureName: string\n): T => {\n\treturn (async (...args: Parameters<T>) => {\n\t\tcontext.logger.info(`${featureName}_started`, {\n\t\t\trequestId: context.requestId,\n\t\t\tuserId: context.userId,\n\t\t\tfeature: featureName,\n\t\t})\n\n\t\ttry {\n\t\t\tconst result = await useCase(...args)\n\n\t\t\tcontext.logger.info(`${featureName}_success`, {\n\t\t\t\trequestId: context.requestId,\n\t\t\t\tuserId: context.userId,\n\t\t\t\tfeature: featureName,\n\t\t\t})\n\n\t\t\treturn result\n\t\t} catch (error) {\n\t\t\tcontext.logger.error(`${featureName}_failed`, {\n\t\t\t\trequestId: context.requestId,\n\t\t\t\tuserId: context.userId,\n\t\t\t\tfeature: featureName,\n\t\t\t\terror: error instanceof Error ? error.message : 'Unknown error',\n\t\t\t})\n\n\t\t\tthrow error\n\t\t}\n\t}) as T\n}\n\n/**\n * Compose multiple decorators together\n * Order: Tracing → Performance → Error Handling\n * (outermost → innermost)\n */\nexport const decorateUseCase = <T extends (...args: any[]) => Promise<any>>(\n\tuseCase: T,\n\tcontext: DecoratorContext,\n\tfeatureName: string\n): T => {\n\t// Apply decorators from outermost to innermost\n\t// Error handling (innermost - catches first)\n\tlet decorated = withErrorHandling(useCase, context, featureName)\n\n\t// Performance monitoring (middle - wraps error handling)\n\tdecorated = withPerformanceMonitoring(decorated, context, featureName)\n\n\t// Request tracing (outermost - visible in logs)\n\tdecorated = withRequestTracing(decorated, context, featureName)\n\n\treturn decorated\n}\n\n/**\n * Factory for creating decorated use cases\n * Used in dependency injection to wrap use cases automatically\n */\nexport const makeDecoratedUseCase = <T extends (...args: any[]) => Promise<any>>(\n\tuseCase: T,\n\tcontext: DecoratorContext,\n\tfeatureName: string\n): T => {\n\treturn decorateUseCase(useCase, context, featureName)\n}\n"],"mappings":";;;;;;AA+BA,MAAa,6BACZ,SACA,SACA,gBACO;AACP,SAAQ,OAAO,GAAG,SAAwB;EACzC,MAAM,YAAY,KAAK,KAAK;AAE5B,MAAI;GACH,MAAM,SAAS,MAAM,QAAQ,GAAG,KAAK;GACrC,MAAM,aAAa,KAAK,KAAK,GAAG;AAEhC,WAAQ,OAAO,MAAM,GAAG,YAAY,aAAa;IAChD,WAAW,QAAQ;IACnB,SAAS;IACT;IACA,CAAC;AAEF,UAAO;WACC,OAAO;GACf,MAAM,aAAa,KAAK,KAAK,GAAG;AAGhC,OAAI,iBAAiB,SACpB,SAAQ,OAAO,MAAM,GAAG,YAAY,SAAS;IAC5C,WAAW,QAAQ;IACnB,SAAS;IACT;IACA,MAAM,MAAM;IACZ,UAAU,MAAM;IAChB,CAAC;AAGH,SAAM;;;;;;;AAQT,MAAa,qBACZ,SACA,SACA,gBACO;AACP,SAAQ,OAAO,GAAG,SAAwB;AACzC,MAAI;AACH,UAAO,MAAM,QAAQ,GAAG,KAAK;WACrB,OAAO;AAEf,OAAI,iBAAiB,SACpB,OAAM;AAIP,OAAI,iBAAiB,OAAO;AAC3B,YAAQ,OAAO,MAAM,GAAG,YAAY,oBAAoB;KACvD,WAAW,QAAQ;KACnB,SAAS;KACT,WAAW,MAAM;KACjB,cAAc,MAAM;KACpB,OAAO,MAAM;KACb,CAAC;AAEF,UAAM,IAAI,SAAS,yBAAgC,uBAAuB,eAAe;KACxF,YAAY;KACZ,MAAM;MACL,eAAe,MAAM;MACrB,SAAS;MACT;KACD,CAAC;;AAIH,WAAQ,OAAO,MAAM,GAAG,YAAY,iBAAiB;IACpD,WAAW,QAAQ;IACnB,SAAS;IACT,CAAC;AAEF,SAAM,IAAI,SAAS,yBAAgC,oBAAoB,eAAe;IACrF,YAAY;IACZ,MAAM,EAAE,SAAS,aAAa;IAC9B,CAAC;;;;;;;AAQL,MAAa,sBACZ,SACA,SACA,gBACO;AACP,SAAQ,OAAO,GAAG,SAAwB;AACzC,UAAQ,OAAO,KAAK,GAAG,YAAY,WAAW;GAC7C,WAAW,QAAQ;GACnB,QAAQ,QAAQ;GAChB,SAAS;GACT,CAAC;AAEF,MAAI;GACH,MAAM,SAAS,MAAM,QAAQ,GAAG,KAAK;AAErC,WAAQ,OAAO,KAAK,GAAG,YAAY,WAAW;IAC7C,WAAW,QAAQ;IACnB,QAAQ,QAAQ;IAChB,SAAS;IACT,CAAC;AAEF,UAAO;WACC,OAAO;AACf,WAAQ,OAAO,MAAM,GAAG,YAAY,UAAU;IAC7C,WAAW,QAAQ;IACnB,QAAQ,QAAQ;IAChB,SAAS;IACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU;IAChD,CAAC;AAEF,SAAM;;;;;;;;;AAUT,MAAa,mBACZ,SACA,SACA,gBACO;CAGP,IAAI,YAAY,kBAAkB,SAAS,SAAS,YAAY;AAGhE,aAAY,0BAA0B,WAAW,SAAS,YAAY;AAGtE,aAAY,mBAAmB,WAAW,SAAS,YAAY;AAE/D,QAAO;;;;;;AAOR,MAAa,wBACZ,SACA,SACA,gBACO;AACP,QAAO,gBAAgB,SAAS,SAAS,YAAY"}

package/dist/user.drizzle-9kkstnkV.d.ts

@@ -0,0 +1,12 @@
+import { NodePgDatabase } from "drizzle-orm/node-postgres";
+import { UserRepository } from "@kuckit/domain/ports/user-repository";
+
+//#region src/db/drizzle/repositories/user.drizzle.d.ts
+
+/**
+ * Drizzle implementation of UserRepository
+ */
+declare const makeDrizzleUserRepository: (db: NodePgDatabase) => UserRepository;
+//#endregion
+export { makeDrizzleUserRepository as t };
+//# sourceMappingURL=user.drizzle-9kkstnkV.d.ts.map

package/dist/user.drizzle-CgKIqqb3.js

@@ -0,0 +1,57 @@
+import { eq } from "drizzle-orm";
+import { user } from "@kuckit/db/schema/auth";
+
+//#region src/db/drizzle/repositories/user.drizzle.ts
+/**
+* Map Drizzle row to domain entity
+*/
+const toDomainUser = (row) => ({
+	id: row.id,
+	name: row.name,
+	email: row.email,
+	emailVerified: row.emailVerified,
+	permissions: row.permissions,
+	createdAt: row.createdAt,
+	updatedAt: row.updatedAt
+});
+/**
+* Map domain entity to Drizzle insert type
+*/
+const toDbUser = (user$1) => ({
+	id: user$1.id,
+	name: user$1.name,
+	email: user$1.email,
+	emailVerified: user$1.emailVerified,
+	permissions: [...user$1.permissions],
+	createdAt: user$1.createdAt,
+	updatedAt: user$1.updatedAt
+});
+/**
+* Drizzle implementation of UserRepository
+*/
+const makeDrizzleUserRepository = (db) => ({
+	async findById(id) {
+		const rows = await db.select().from(user).where(eq(user.id, id)).limit(1);
+		return rows[0] ? toDomainUser(rows[0]) : null;
+	},
+	async findByEmail(email) {
+		const rows = await db.select().from(user).where(eq(user.email, email)).limit(1);
+		return rows[0] ? toDomainUser(rows[0]) : null;
+	},
+	async save(user$1) {
+		await db.insert(user).values(toDbUser(user$1)).onConflictDoUpdate({
+			target: user.id,
+			set: {
+				name: user$1.name,
+				email: user$1.email,
+				emailVerified: user$1.emailVerified,
+				permissions: [...user$1.permissions],
+				updatedAt: user$1.updatedAt
+			}
+		});
+	}
+});
+
+//#endregion
+export { makeDrizzleUserRepository as t };
+//# sourceMappingURL=user.drizzle-CgKIqqb3.js.map

package/dist/user.drizzle-CgKIqqb3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.drizzle-CgKIqqb3.js","names":["user","userTable"],"sources":["../src/db/drizzle/repositories/user.drizzle.ts"],"sourcesContent":["import type { NodePgDatabase } from 'drizzle-orm/node-postgres'\nimport { eq } from 'drizzle-orm'\nimport { user as userTable } from '@kuckit/db/schema/auth'\nimport type { UserRepository } from '@kuckit/domain/ports/user-repository'\nimport type { User } from '@kuckit/domain/entities/user'\n\n/**\n * Map Drizzle row to domain entity\n */\nconst toDomainUser = (row: typeof userTable.$inferSelect): User => ({\n\tid: row.id,\n\tname: row.name,\n\temail: row.email,\n\temailVerified: row.emailVerified,\n\tpermissions: row.permissions,\n\tcreatedAt: row.createdAt,\n\tupdatedAt: row.updatedAt,\n})\n\n/**\n * Map domain entity to Drizzle insert type\n */\nconst toDbUser = (user: User) => ({\n\tid: user.id,\n\tname: user.name,\n\temail: user.email,\n\temailVerified: user.emailVerified,\n\tpermissions: [...user.permissions],\n\tcreatedAt: user.createdAt,\n\tupdatedAt: user.updatedAt,\n})\n\n/**\n * Drizzle implementation of UserRepository\n */\nexport const makeDrizzleUserRepository = (db: NodePgDatabase): UserRepository => ({\n\tasync findById(id: string): Promise<User | null> {\n\t\tconst rows = await db.select().from(userTable).where(eq(userTable.id, id)).limit(1)\n\n\t\treturn rows[0] ? toDomainUser(rows[0]) : null\n\t},\n\n\tasync findByEmail(email: string): Promise<User | null> {\n\t\tconst rows = await db.select().from(userTable).where(eq(userTable.email, email)).limit(1)\n\n\t\treturn rows[0] ? toDomainUser(rows[0]) : null\n\t},\n\n\tasync save(user: User): Promise<void> {\n\t\tawait db\n\t\t\t.insert(userTable)\n\t\t\t.values(toDbUser(user))\n\t\t\t.onConflictDoUpdate({\n\t\t\t\ttarget: userTable.id,\n\t\t\t\tset: {\n\t\t\t\t\tname: user.name,\n\t\t\t\t\temail: user.email,\n\t\t\t\t\temailVerified: user.emailVerified,\n\t\t\t\t\tpermissions: [...user.permissions],\n\t\t\t\t\tupdatedAt: user.updatedAt,\n\t\t\t\t},\n\t\t\t})\n\t},\n})\n"],"mappings":";;;;;;;AASA,MAAM,gBAAgB,SAA8C;CACnE,IAAI,IAAI;CACR,MAAM,IAAI;CACV,OAAO,IAAI;CACX,eAAe,IAAI;CACnB,aAAa,IAAI;CACjB,WAAW,IAAI;CACf,WAAW,IAAI;CACf;;;;AAKD,MAAM,YAAY,YAAgB;CACjC,IAAIA,OAAK;CACT,MAAMA,OAAK;CACX,OAAOA,OAAK;CACZ,eAAeA,OAAK;CACpB,aAAa,CAAC,GAAGA,OAAK,YAAY;CAClC,WAAWA,OAAK;CAChB,WAAWA,OAAK;CAChB;;;;AAKD,MAAa,6BAA6B,QAAwC;CACjF,MAAM,SAAS,IAAkC;EAChD,MAAM,OAAO,MAAM,GAAG,QAAQ,CAAC,KAAKC,KAAU,CAAC,MAAM,GAAGA,KAAU,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE;AAEnF,SAAO,KAAK,KAAK,aAAa,KAAK,GAAG,GAAG;;CAG1C,MAAM,YAAY,OAAqC;EACtD,MAAM,OAAO,MAAM,GAAG,QAAQ,CAAC,KAAKA,KAAU,CAAC,MAAM,GAAGA,KAAU,OAAO,MAAM,CAAC,CAAC,MAAM,EAAE;AAEzF,SAAO,KAAK,KAAK,aAAa,KAAK,GAAG,GAAG;;CAG1C,MAAM,KAAK,QAA2B;AACrC,QAAM,GACJ,OAAOA,KAAU,CACjB,OAAO,SAASD,OAAK,CAAC,CACtB,mBAAmB;GACnB,QAAQC,KAAU;GAClB,KAAK;IACJ,MAAMD,OAAK;IACX,OAAOA,OAAK;IACZ,eAAeA,OAAK;IACpB,aAAa,CAAC,GAAGA,OAAK,YAAY;IAClC,WAAWA,OAAK;IAChB;GACD,CAAC;;CAEJ"}

package/dist/user.module-BEpCbKsU.js

@@ -0,0 +1,17 @@
+import { t as makeDrizzleUserRepository } from "./user.drizzle-CgKIqqb3.js";
+import { asFunction } from "awilix";
+
+//#region src/modules/user.module.ts
+/**
+* User repository module: registers user-related repositories
+*
+* Note: Use case registrations are in apps/server/src/modules/user.module.ts
+* to maintain Clean Architecture layering (Infrastructure should not import Application)
+*/
+const registerUserModule = (container) => {
+	container.register({ userRepository: asFunction(({ db }) => makeDrizzleUserRepository(db)).scoped() });
+};
+
+//#endregion
+export { registerUserModule as t };
+//# sourceMappingURL=user.module-BEpCbKsU.js.map

package/dist/user.module-BEpCbKsU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.module-BEpCbKsU.js","names":[],"sources":["../src/modules/user.module.ts"],"sourcesContent":["import { asFunction, type AwilixContainer } from 'awilix'\nimport { makeDrizzleUserRepository } from '../db/drizzle/repositories/user.drizzle'\nimport type { Cradle } from './types'\n\n/**\n * User repository module: registers user-related repositories\n *\n * Note: Use case registrations are in apps/server/src/modules/user.module.ts\n * to maintain Clean Architecture layering (Infrastructure should not import Application)\n */\nexport const registerUserModule = (container: AwilixContainer<Cradle>): void => {\n\tcontainer.register({\n\t\tuserRepository: asFunction(({ db }) => makeDrizzleUserRepository(db)).scoped(),\n\t})\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,sBAAsB,cAA6C;AAC/E,WAAU,SAAS,EAClB,gBAAgB,YAAY,EAAE,SAAS,0BAA0B,GAAG,CAAC,CAAC,QAAQ,EAC9E,CAAC"}

package/dist/user.module-D3lVJ98T.d.ts

@@ -0,0 +1,15 @@
+import { n as Cradle } from "./types-65aFqB5L.js";
+import { AwilixContainer } from "awilix";
+
+//#region src/modules/user.module.d.ts
+
+/**
+ * User repository module: registers user-related repositories
+ *
+ * Note: Use case registrations are in apps/server/src/modules/user.module.ts
+ * to maintain Clean Architecture layering (Infrastructure should not import Application)
+ */
+declare const registerUserModule: (container: AwilixContainer<Cradle>) => void;
+//#endregion
+export { registerUserModule as t };
+//# sourceMappingURL=user.module-D3lVJ98T.d.ts.map

package/dist/with-caching-BniS1aZd.d.ts

@@ -0,0 +1,39 @@
+import { CacheStore } from "@kuckit/domain";
+
+//#region src/decorators/with-caching.d.ts
+
+/**
+ * Options for caching decorator
+ */
+interface WithCachingOptions {
+  /** Cache key function - maps input to cache key */
+  keyFn: (input: any) => string;
+  /** Time to live in milliseconds */
+  ttlMs: number;
+  /** Stale-while-revalidate: return stale value while refreshing in background */
+  staleWhileRevalidateMs?: number;
+}
+/**
+ * Wraps a use case with caching
+ * - Only works with idempotent read operations
+ * - Key function determines cache key from input
+ * - TTL controls cache expiration
+ * - SWR allows returning stale value while revalidating
+ *
+ * @example
+ * ```ts
+ * const cachedGetUser = withCaching(
+ *   getUserProfile,
+ *   cacheStore,
+ *   {
+ *     keyFn: (input) => `user:${input.userId}`,
+ *     ttlMs: 60000, // 1 minute
+ *     staleWhileRevalidateMs: 120000, // 2 minutes
+ *   }
+ * )
+ * ```
+ */
+declare const withCaching: <I extends Record<string, any>, O>(fn: (input: I) => Promise<O>, cacheStore: CacheStore, options: WithCachingOptions) => ((input: I) => Promise<O>);
+//#endregion
+export { withCaching as n, WithCachingOptions as t };
+//# sourceMappingURL=with-caching-BniS1aZd.d.ts.map

package/dist/with-caching-NmBxu7vJ.js

@@ -0,0 +1,37 @@
+//#region src/decorators/with-caching.ts
+/**
+* Wraps a use case with caching
+* - Only works with idempotent read operations
+* - Key function determines cache key from input
+* - TTL controls cache expiration
+* - SWR allows returning stale value while revalidating
+*
+* @example
+* ```ts
+* const cachedGetUser = withCaching(
+*   getUserProfile,
+*   cacheStore,
+*   {
+*     keyFn: (input) => `user:${input.userId}`,
+*     ttlMs: 60000, // 1 minute
+*     staleWhileRevalidateMs: 120000, // 2 minutes
+*   }
+* )
+* ```
+*/
+const withCaching = (fn, cacheStore, options) => {
+	const cached = async (input) => {
+		const cacheKey = options.keyFn(input);
+		const cached$1 = await cacheStore.get(cacheKey);
+		if (cached$1 !== void 0) return cached$1;
+		const result = await fn(input);
+		await cacheStore.set(cacheKey, result, options.ttlMs);
+		return result;
+	};
+	Object.defineProperty(cached, "name", { value: `withCaching(${fn.name || "anonymous"})` });
+	return cached;
+};
+
+//#endregion
+export { withCaching as t };
+//# sourceMappingURL=with-caching-NmBxu7vJ.js.map

package/dist/with-caching-NmBxu7vJ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-caching-NmBxu7vJ.js","names":["cached"],"sources":["../src/decorators/with-caching.ts"],"sourcesContent":["import type { CacheStore } from '@kuckit/domain'\n\n/**\n * Options for caching decorator\n */\nexport interface WithCachingOptions {\n\t/** Cache key function - maps input to cache key */\n\tkeyFn: (input: any) => string\n\t/** Time to live in milliseconds */\n\tttlMs: number\n\t/** Stale-while-revalidate: return stale value while refreshing in background */\n\tstaleWhileRevalidateMs?: number\n}\n\n/**\n * Wraps a use case with caching\n * - Only works with idempotent read operations\n * - Key function determines cache key from input\n * - TTL controls cache expiration\n * - SWR allows returning stale value while revalidating\n *\n * @example\n * ```ts\n * const cachedGetUser = withCaching(\n *   getUserProfile,\n *   cacheStore,\n *   {\n *     keyFn: (input) => `user:${input.userId}`,\n *     ttlMs: 60000, // 1 minute\n *     staleWhileRevalidateMs: 120000, // 2 minutes\n *   }\n * )\n * ```\n */\nexport const withCaching = <I extends Record<string, any>, O>(\n\tfn: (input: I) => Promise<O>,\n\tcacheStore: CacheStore,\n\toptions: WithCachingOptions\n): ((input: I) => Promise<O>) => {\n\tconst cached = async (input: I): Promise<O> => {\n\t\tconst cacheKey = options.keyFn(input)\n\n\t\t// Try to get from cache\n\t\tconst cached = await cacheStore.get<O>(cacheKey)\n\t\tif (cached !== undefined) {\n\t\t\treturn cached\n\t\t}\n\n\t\t// Not in cache, call function\n\t\tconst result = await fn(input)\n\n\t\t// Store in cache\n\t\tawait cacheStore.set(cacheKey, result, options.ttlMs)\n\n\t\treturn result\n\t}\n\n\t// Preserve function name for debugging\n\tObject.defineProperty(cached, 'name', {\n\t\tvalue: `withCaching(${fn.name || 'anonymous'})`,\n\t})\n\n\treturn cached\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAkCA,MAAa,eACZ,IACA,YACA,YACgC;CAChC,MAAM,SAAS,OAAO,UAAyB;EAC9C,MAAM,WAAW,QAAQ,MAAM,MAAM;EAGrC,MAAMA,WAAS,MAAM,WAAW,IAAO,SAAS;AAChD,MAAIA,aAAW,OACd,QAAOA;EAIR,MAAM,SAAS,MAAM,GAAG,MAAM;AAG9B,QAAM,WAAW,IAAI,UAAU,QAAQ,QAAQ,MAAM;AAErD,SAAO;;AAIR,QAAO,eAAe,QAAQ,QAAQ,EACrC,OAAO,eAAe,GAAG,QAAQ,YAAY,IAC7C,CAAC;AAEF,QAAO"}

package/dist/with-rate-limit-Cp2V1RHn.js

@@ -0,0 +1,48 @@
+import { AppError, ErrorCode } from "@kuckit/domain";
+
+//#region src/decorators/with-rate-limit.ts
+/**
+* Rate limit error
+*/
+var RateLimitError = class extends AppError {
+	constructor(resetAt) {
+		super(ErrorCode.RATE_LIMITED, `Rate limit exceeded. Reset at ${resetAt.toISOString()}`, {
+			statusCode: 429,
+			meta: { resetAt }
+		});
+		this.resetAt = resetAt;
+	}
+};
+/**
+* Wraps a use case with rate limiting
+* - Uses token bucket algorithm
+* - Per-input rate limit tracking via keyFn
+* - Throws RateLimitError when limit exceeded
+*
+* @example
+* ```ts
+* const limitedCreatePost = withRateLimit(
+*   createPost,
+*   rateLimiterStore,
+*   {
+*     keyFn: (input) => `user:${input.userId}`,
+*     capacity: 10,
+*     refillPerSecond: 1, // 1 request per second
+*   }
+* )
+* ```
+*/
+const withRateLimit = (fn, rateLimiterStore, options) => {
+	const limited = async (input) => {
+		const limitKey = options.keyFn(input);
+		const result = await rateLimiterStore.checkLimit(limitKey, options.capacity, options.refillPerSecond);
+		if (!result.allowed) throw new RateLimitError(result.resetAt);
+		return await fn(input);
+	};
+	Object.defineProperty(limited, "name", { value: `withRateLimit(${fn.name || "anonymous"})` });
+	return limited;
+};
+
+//#endregion
+export { withRateLimit as n, RateLimitError as t };
+//# sourceMappingURL=with-rate-limit-Cp2V1RHn.js.map

package/dist/with-rate-limit-Cp2V1RHn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-rate-limit-Cp2V1RHn.js","names":["resetAt: Date"],"sources":["../src/decorators/with-rate-limit.ts"],"sourcesContent":["import type { RateLimiterStore } from '@kuckit/domain'\nimport { AppError, ErrorCode } from '@kuckit/domain'\n\n/**\n * Options for rate limiting decorator\n */\nexport interface WithRateLimitOptions {\n\t/** Rate limit key function - maps input to limit key */\n\tkeyFn: (input: any) => string\n\t/** Bucket capacity (max requests) */\n\tcapacity: number\n\t/** Tokens refilled per second */\n\trefillPerSecond: number\n}\n\n/**\n * Rate limit error\n */\nexport class RateLimitError extends AppError {\n\tconstructor(public readonly resetAt: Date) {\n\t\tsuper(ErrorCode.RATE_LIMITED, `Rate limit exceeded. Reset at ${resetAt.toISOString()}`, {\n\t\t\tstatusCode: 429,\n\t\t\tmeta: { resetAt },\n\t\t})\n\t}\n}\n\n/**\n * Wraps a use case with rate limiting\n * - Uses token bucket algorithm\n * - Per-input rate limit tracking via keyFn\n * - Throws RateLimitError when limit exceeded\n *\n * @example\n * ```ts\n * const limitedCreatePost = withRateLimit(\n *   createPost,\n *   rateLimiterStore,\n *   {\n *     keyFn: (input) => `user:${input.userId}`,\n *     capacity: 10,\n *     refillPerSecond: 1, // 1 request per second\n *   }\n * )\n * ```\n */\nexport const withRateLimit = <I extends Record<string, any>, O>(\n\tfn: (input: I) => Promise<O>,\n\trateLimiterStore: RateLimiterStore,\n\toptions: WithRateLimitOptions\n): ((input: I) => Promise<O>) => {\n\tconst limited = async (input: I): Promise<O> => {\n\t\tconst limitKey = options.keyFn(input)\n\n\t\tconst result = await rateLimiterStore.checkLimit(\n\t\t\tlimitKey,\n\t\t\toptions.capacity,\n\t\t\toptions.refillPerSecond\n\t\t)\n\n\t\tif (!result.allowed) {\n\t\t\tthrow new RateLimitError(result.resetAt)\n\t\t}\n\n\t\t// Rate limit allows, call function\n\t\treturn await fn(input)\n\t}\n\n\t// Preserve function name for debugging\n\tObject.defineProperty(limited, 'name', {\n\t\tvalue: `withRateLimit(${fn.name || 'anonymous'})`,\n\t})\n\n\treturn limited\n}\n"],"mappings":";;;;;;AAkBA,IAAa,iBAAb,cAAoC,SAAS;CAC5C,YAAY,AAAgBA,SAAe;AAC1C,QAAM,UAAU,cAAc,iCAAiC,QAAQ,aAAa,IAAI;GACvF,YAAY;GACZ,MAAM,EAAE,SAAS;GACjB,CAAC;EAJyB;;;;;;;;;;;;;;;;;;;;;;AA2B7B,MAAa,iBACZ,IACA,kBACA,YACgC;CAChC,MAAM,UAAU,OAAO,UAAyB;EAC/C,MAAM,WAAW,QAAQ,MAAM,MAAM;EAErC,MAAM,SAAS,MAAM,iBAAiB,WACrC,UACA,QAAQ,UACR,QAAQ,gBACR;AAED,MAAI,CAAC,OAAO,QACX,OAAM,IAAI,eAAe,OAAO,QAAQ;AAIzC,SAAO,MAAM,GAAG,MAAM;;AAIvB,QAAO,eAAe,SAAS,QAAQ,EACtC,OAAO,iBAAiB,GAAG,QAAQ,YAAY,IAC/C,CAAC;AAEF,QAAO"}

package/dist/with-rate-limit-DK4ZF-Qg.d.ts

@@ -0,0 +1,45 @@
+import { AppError, RateLimiterStore } from "@kuckit/domain";
+
+//#region src/decorators/with-rate-limit.d.ts
+
+/**
+ * Options for rate limiting decorator
+ */
+interface WithRateLimitOptions {
+  /** Rate limit key function - maps input to limit key */
+  keyFn: (input: any) => string;
+  /** Bucket capacity (max requests) */
+  capacity: number;
+  /** Tokens refilled per second */
+  refillPerSecond: number;
+}
+/**
+ * Rate limit error
+ */
+declare class RateLimitError extends AppError {
+  readonly resetAt: Date;
+  constructor(resetAt: Date);
+}
+/**
+ * Wraps a use case with rate limiting
+ * - Uses token bucket algorithm
+ * - Per-input rate limit tracking via keyFn
+ * - Throws RateLimitError when limit exceeded
+ *
+ * @example
+ * ```ts
+ * const limitedCreatePost = withRateLimit(
+ *   createPost,
+ *   rateLimiterStore,
+ *   {
+ *     keyFn: (input) => `user:${input.userId}`,
+ *     capacity: 10,
+ *     refillPerSecond: 1, // 1 request per second
+ *   }
+ * )
+ * ```
+ */
+declare const withRateLimit: <I extends Record<string, any>, O>(fn: (input: I) => Promise<O>, rateLimiterStore: RateLimiterStore, options: WithRateLimitOptions) => ((input: I) => Promise<O>);
+//#endregion
+export { WithRateLimitOptions as n, withRateLimit as r, RateLimitError as t };
+//# sourceMappingURL=with-rate-limit-DK4ZF-Qg.d.ts.map

package/dist/with-retry-B9-hUj7I.d.ts

@@ -0,0 +1,40 @@
+//#region src/decorators/with-retry.d.ts
+/**
+ * Options for retry decorator
+ */
+interface WithRetryOptions {
+  /** Maximum number of retry attempts (default: 3) */
+  maxAttempts?: number;
+  /** Initial backoff in milliseconds (default: 100) */
+  initialBackoffMs?: number;
+  /** Maximum backoff in milliseconds (default: 30000) */
+  maxBackoffMs?: number;
+  /** Backoff multiplier for exponential backoff (default: 2) */
+  backoffMultiplier?: number;
+  /** Predicate to determine if error is retryable */
+  retryOn?: (error: Error) => boolean;
+}
+/**
+ * Wraps a use case with retry logic
+ * - Uses exponential backoff
+ * - Only retries on specific errors via retryOn predicate
+ * - Backoff is capped at maxBackoffMs
+ *
+ * @example
+ * ```ts
+ * const retriedGetUser = withRetry(
+ *   getUserProfile,
+ *   {
+ *     maxAttempts: 3,
+ *     initialBackoffMs: 100,
+ *     maxBackoffMs: 30000,
+ *     backoffMultiplier: 2,
+ *     retryOn: (error) => error.message.includes('TIMEOUT'),
+ *   }
+ * )
+ * ```
+ */
+declare const withRetry: <I extends any[], O>(fn: (...args: I) => Promise<O>, options?: WithRetryOptions) => ((...args: I) => Promise<O>);
+//#endregion
+export { withRetry as n, WithRetryOptions as t };
+//# sourceMappingURL=with-retry-B9-hUj7I.d.ts.map

package/dist/with-retry-coyYPiX1.js

@@ -0,0 +1,49 @@
+//#region src/decorators/with-retry.ts
+/**
+* Wraps a use case with retry logic
+* - Uses exponential backoff
+* - Only retries on specific errors via retryOn predicate
+* - Backoff is capped at maxBackoffMs
+*
+* @example
+* ```ts
+* const retriedGetUser = withRetry(
+*   getUserProfile,
+*   {
+*     maxAttempts: 3,
+*     initialBackoffMs: 100,
+*     maxBackoffMs: 30000,
+*     backoffMultiplier: 2,
+*     retryOn: (error) => error.message.includes('TIMEOUT'),
+*   }
+* )
+* ```
+*/
+const withRetry = (fn, options = {}) => {
+	const maxAttempts = options.maxAttempts ?? 3;
+	const initialBackoffMs = options.initialBackoffMs ?? 100;
+	const maxBackoffMs = options.maxBackoffMs ?? 3e4;
+	const backoffMultiplier = options.backoffMultiplier ?? 2;
+	const retryOn = options.retryOn ?? ((error) => error instanceof Error);
+	const retried = async (...args) => {
+		let lastError = null;
+		let backoffMs = initialBackoffMs;
+		for (let attempt = 1; attempt <= maxAttempts; attempt++) try {
+			return await fn(...args);
+		} catch (error) {
+			lastError = error instanceof Error ? error : new Error(String(error));
+			if (!retryOn(lastError)) throw error;
+			if (attempt < maxAttempts) {
+				await new Promise((resolve) => setTimeout(resolve, backoffMs));
+				backoffMs = Math.min(backoffMs * backoffMultiplier, maxBackoffMs);
+			}
+		}
+		throw lastError ?? /* @__PURE__ */ new Error("Retry failed without error");
+	};
+	Object.defineProperty(retried, "name", { value: `withRetry(${fn.name || "anonymous"})` });
+	return retried;
+};
+
+//#endregion
+export { withRetry as t };
+//# sourceMappingURL=with-retry-coyYPiX1.js.map

package/dist/with-retry-coyYPiX1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-retry-coyYPiX1.js","names":["lastError: Error | null"],"sources":["../src/decorators/with-retry.ts"],"sourcesContent":["/**\n * Options for retry decorator\n */\nexport interface WithRetryOptions {\n\t/** Maximum number of retry attempts (default: 3) */\n\tmaxAttempts?: number\n\t/** Initial backoff in milliseconds (default: 100) */\n\tinitialBackoffMs?: number\n\t/** Maximum backoff in milliseconds (default: 30000) */\n\tmaxBackoffMs?: number\n\t/** Backoff multiplier for exponential backoff (default: 2) */\n\tbackoffMultiplier?: number\n\t/** Predicate to determine if error is retryable */\n\tretryOn?: (error: Error) => boolean\n}\n\n/**\n * Wraps a use case with retry logic\n * - Uses exponential backoff\n * - Only retries on specific errors via retryOn predicate\n * - Backoff is capped at maxBackoffMs\n *\n * @example\n * ```ts\n * const retriedGetUser = withRetry(\n *   getUserProfile,\n *   {\n *     maxAttempts: 3,\n *     initialBackoffMs: 100,\n *     maxBackoffMs: 30000,\n *     backoffMultiplier: 2,\n *     retryOn: (error) => error.message.includes('TIMEOUT'),\n *   }\n * )\n * ```\n */\nexport const withRetry = <I extends any[], O>(\n\tfn: (...args: I) => Promise<O>,\n\toptions: WithRetryOptions = {}\n): ((...args: I) => Promise<O>) => {\n\tconst maxAttempts = options.maxAttempts ?? 3\n\tconst initialBackoffMs = options.initialBackoffMs ?? 100\n\tconst maxBackoffMs = options.maxBackoffMs ?? 30000\n\tconst backoffMultiplier = options.backoffMultiplier ?? 2\n\tconst retryOn = options.retryOn ?? ((error: Error) => error instanceof Error)\n\n\tconst retried = async (...args: I): Promise<O> => {\n\t\tlet lastError: Error | null = null\n\t\tlet backoffMs = initialBackoffMs\n\n\t\tfor (let attempt = 1; attempt <= maxAttempts; attempt++) {\n\t\t\ttry {\n\t\t\t\treturn await fn(...args)\n\t\t\t} catch (error) {\n\t\t\t\tlastError = error instanceof Error ? error : new Error(String(error))\n\n\t\t\t\t// Check if error is retryable\n\t\t\t\tif (!retryOn(lastError)) {\n\t\t\t\t\tthrow error\n\t\t\t\t}\n\n\t\t\t\t// Don't wait after last attempt\n\t\t\t\tif (attempt < maxAttempts) {\n\t\t\t\t\tawait new Promise((resolve) => setTimeout(resolve, backoffMs))\n\n\t\t\t\t\t// Calculate next backoff (with cap)\n\t\t\t\t\tbackoffMs = Math.min(backoffMs * backoffMultiplier, maxBackoffMs)\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// All attempts exhausted\n\t\tthrow lastError ?? new Error('Retry failed without error')\n\t}\n\n\t// Preserve function name for debugging\n\tObject.defineProperty(retried, 'name', {\n\t\tvalue: `withRetry(${fn.name || 'anonymous'})`,\n\t})\n\n\treturn retried\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoCA,MAAa,aACZ,IACA,UAA4B,EAAE,KACI;CAClC,MAAM,cAAc,QAAQ,eAAe;CAC3C,MAAM,mBAAmB,QAAQ,oBAAoB;CACrD,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,MAAM,oBAAoB,QAAQ,qBAAqB;CACvD,MAAM,UAAU,QAAQ,aAAa,UAAiB,iBAAiB;CAEvE,MAAM,UAAU,OAAO,GAAG,SAAwB;EACjD,IAAIA,YAA0B;EAC9B,IAAI,YAAY;AAEhB,OAAK,IAAI,UAAU,GAAG,WAAW,aAAa,UAC7C,KAAI;AACH,UAAO,MAAM,GAAG,GAAG,KAAK;WAChB,OAAO;AACf,eAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AAGrE,OAAI,CAAC,QAAQ,UAAU,CACtB,OAAM;AAIP,OAAI,UAAU,aAAa;AAC1B,UAAM,IAAI,SAAS,YAAY,WAAW,SAAS,UAAU,CAAC;AAG9D,gBAAY,KAAK,IAAI,YAAY,mBAAmB,aAAa;;;AAMpE,QAAM,6BAAa,IAAI,MAAM,6BAA6B;;AAI3D,QAAO,eAAe,SAAS,QAAQ,EACtC,OAAO,aAAa,GAAG,QAAQ,YAAY,IAC3C,CAAC;AAEF,QAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kuckit/infrastructure",
-	"version": "1.0.2",
+	"version": "1.0.3",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -22,9 +22,9 @@
 		"prepublishOnly": "npm run build && node ../../scripts/resolve-workspace-protocols.cjs && node ../../scripts/check-no-workspace-protocol.cjs"
 	},
 	"dependencies": {
-		"@kuckit/domain": "^1.0.2",
-		"@kuckit/db": "^1.0.2",
-		"@kuckit/auth": "^1.0.2",
+		"@kuckit/domain": "^1.0.3",
+		"@kuckit/db": "^1.0.3",
+		"@kuckit/auth": "^1.0.3",
 		"@ai-sdk/google": "^2.0.13",
 		"awilix": "^10.0.2",
 		"drizzle-orm": "^0.44.2",