@kuckit/users-module 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import * as _kuckit_sdk0 from "@kuckit/sdk";
+
+//#region src/module.d.ts
+/**
+ * Configuration options for the users module
+ */
+interface UsersModuleConfig {
+  /** Enable caching for user profile reads */
+  enableCaching?: boolean;
+  /** Cache TTL in milliseconds */
+  cacheTtlMs?: number;
+  /** Enable retry logic for write operations */
+  enableRetry?: boolean;
+}
+/**
+ * Users module for Kuckit SDK
+ *
+ * This module provides user management functionality:
+ * - User repository (Drizzle-based)
+ * - Use cases: getUserProfile, updateUserProfile, createUser
+ * - Event publishing for user domain events
+ *
+ * @example
+ * ```ts
+ * // In your application's module config:
+ * const modules: ModuleSpec[] = [
+ *   {
+ *     package: '@kuckit/users-module',
+ *     config: {
+ *       enableCaching: true,
+ *       cacheTtlMs: 60000,
+ *     },
+ *   },
+ * ]
+ * ```
+ */
+declare const kuckitModule: _kuckit_sdk0.KuckitModuleDefinition<UsersModuleConfig>;
+//#endregion
+export { type UsersModuleConfig, kuckitModule };

package/dist/index.js

@@ -0,0 +1,108 @@
+import { asFunction, defineKuckitModule } from "@kuckit/sdk";
+import { makeCreateUser, makeGetUserProfile, makeUpdateUserProfile } from "@kuckit/application";
+import { decorateUseCase, makeDrizzleUserRepository, makeEventPublisherAdapter, withCaching, withRetry } from "@kuckit/infrastructure";
+
+//#region src/module.ts
+/**
+* Users module for Kuckit SDK
+*
+* This module provides user management functionality:
+* - User repository (Drizzle-based)
+* - Use cases: getUserProfile, updateUserProfile, createUser
+* - Event publishing for user domain events
+*
+* @example
+* ```ts
+* // In your application's module config:
+* const modules: ModuleSpec[] = [
+*   {
+*     package: '@kuckit/users-module',
+*     config: {
+*       enableCaching: true,
+*       cacheTtlMs: 60000,
+*     },
+*   },
+* ]
+* ```
+*/
+const kuckitModule = defineKuckitModule({
+	id: "kuckit.users",
+	displayName: "Users",
+	description: "User accounts, profiles, and authentication features",
+	version: "0.1.0",
+	capabilities: ["nav.item", "settings.page"],
+	async register(ctx) {
+		const { container, config } = ctx;
+		const enableCaching = config.enableCaching ?? true;
+		const cacheTtlMs = config.cacheTtlMs ?? 6e4;
+		const enableRetry = config.enableRetry ?? true;
+		container.register({ userRepository: asFunction(({ db }) => makeDrizzleUserRepository(db)).scoped() });
+		container.register({ eventPublisher: asFunction(({ eventBus, logger }) => makeEventPublisherAdapter(eventBus, logger)).singleton() });
+		container.register({
+			getUserProfile: asFunction(({ userRepository, logger, requestId, cacheStore }) => {
+				let useCase = makeGetUserProfile({ userRepository });
+				if (enableCaching) useCase = withCaching(useCase, cacheStore, {
+					keyFn: (input) => `user:${input.userId}`,
+					ttlMs: cacheTtlMs,
+					staleWhileRevalidateMs: cacheTtlMs / 2
+				});
+				return decorateUseCase(useCase, {
+					logger,
+					requestId: requestId ?? "unknown",
+					feature: "getUserProfile"
+				}, "getUserProfile");
+			}).scoped(),
+			updateUserProfile: asFunction(({ userRepository, eventPublisher, clock, logger, requestId }) => {
+				let useCase = makeUpdateUserProfile({
+					userRepository,
+					eventPublisher,
+					clock
+				});
+				if (enableRetry) useCase = withRetry(useCase, {
+					maxAttempts: 3,
+					initialBackoffMs: 100,
+					maxBackoffMs: 5e3,
+					backoffMultiplier: 2
+				});
+				return decorateUseCase(useCase, {
+					logger,
+					requestId: requestId ?? "unknown",
+					feature: "updateUserProfile"
+				}, "updateUserProfile");
+			}).scoped(),
+			createUser: asFunction(({ userRepository, eventPublisher, clock, logger, requestId }) => {
+				let useCase = makeCreateUser({
+					userRepository,
+					eventPublisher,
+					clock
+				});
+				if (enableRetry) useCase = withRetry(useCase, {
+					maxAttempts: 2,
+					initialBackoffMs: 50,
+					maxBackoffMs: 50,
+					backoffMultiplier: 1
+				});
+				return decorateUseCase(useCase, {
+					logger,
+					requestId: requestId ?? "unknown",
+					feature: "createUser"
+				}, "createUser");
+			}).scoped()
+		});
+	},
+	async onBootstrap(ctx) {
+		const { container, config } = ctx;
+		container.resolve("logger").info("Users module initialized", {
+			enableCaching: config.enableCaching ?? true,
+			cacheTtlMs: config.cacheTtlMs ?? 6e4,
+			enableRetry: config.enableRetry ?? true
+		});
+	},
+	async onShutdown(ctx) {
+		const { container } = ctx;
+		container.resolve("logger").info("Users module shutting down");
+	}
+});
+
+//#endregion
+export { kuckitModule };

package/package.json

@@ -0,0 +1,47 @@
+{
+	"name": "@kuckit/users-module",
+	"version": "1.0.0",
+	"description": "User management module for Kuckit SDK",
+	"type": "module",
+	"main": "src/index.ts",
+	"types": "src/index.ts",
+	"files": [
+		"dist"
+	],
+	"kuckit": {
+		"id": "kuckit.users",
+		"server": ".",
+		"client": "./client"
+	},
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"default": "./src/index.ts"
+		}
+	},
+	"publishConfig": {
+		"main": "dist/index.js",
+		"types": "dist/index.d.ts",
+		"exports": {
+			".": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			}
+		}
+	},
+	"scripts": {
+		"build": "tsdown"
+	},
+	"peerDependencies": {
+		"@kuckit/sdk": "workspace:*",
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"@kuckit/domain": "workspace:*",
+		"@kuckit/application": "workspace:*",
+		"@kuckit/infrastructure": "workspace:*"
+	},
+	"devDependencies": {
+		"tsdown": "catalog:"
+	}
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { kuckitModule } from './module'
+export type { UsersModuleConfig } from './module'