@kuckit/application 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,78 @@
+import { UserRepository } from "@kuckit/domain/ports/user-repository";
+import { User } from "@kuckit/domain/entities/user";
+import { EventPublisher } from "@kuckit/domain/ports/event-publisher";
+import { Clock } from "@kuckit/domain/ports/clock";
+import { CacheStore, DomainEvent, EventBus, EventHandler, EventMap, EventMeta, EventName, RateLimiterStore, TypedDomainEvent } from "@kuckit/domain";
+
+//#region src/usecases/get-user-profile.d.ts
+/**
+ * Dependencies required by the use case
+ */
+interface GetUserProfileDeps {
+  readonly userRepository: UserRepository;
+}
+/**
+ * Input for the use case
+ */
+interface GetUserProfileInput {
+  readonly userId: string;
+}
+/**
+ * Use case: Get user profile
+ * Pure business logic with no infrastructure dependencies
+ *
+ * No events for read operations - this is a query use case that doesn't
+ * modify state, so no domain events are published.
+ */
+declare const makeGetUserProfile: (deps: GetUserProfileDeps) => (input: GetUserProfileInput) => Promise<User>;
+//#endregion
+//#region src/usecases/update-user-profile.d.ts
+/**
+ * Dependencies required by the use case
+ */
+interface UpdateUserProfileDeps {
+  readonly userRepository: UserRepository;
+  readonly eventPublisher: EventPublisher;
+  readonly clock: Clock;
+}
+/**
+ * Input for the use case
+ */
+interface UpdateUserProfileInput {
+  readonly userId: string;
+  readonly updates: {
+    readonly name?: string;
+    readonly email?: string;
+    readonly emailVerified?: boolean;
+  };
+}
+/**
+ * Use case: Update user profile
+ * Publishes 'user.updated' event after successful update
+ */
+declare const makeUpdateUserProfile: (deps: UpdateUserProfileDeps) => (input: UpdateUserProfileInput) => Promise<User>;
+//#endregion
+//#region src/usecases/create-user.d.ts
+/**
+ * Dependencies required by the use case
+ */
+interface CreateUserDeps {
+  readonly userRepository: UserRepository;
+  readonly eventPublisher: EventPublisher;
+  readonly clock: Clock;
+}
+/**
+ * Input for the use case
+ */
+interface CreateUserInput {
+  readonly name: string;
+  readonly email: string;
+  readonly emailVerified: boolean;
+}
+/**
+ * Use case: Create user
+ * Publishes 'user.created' event after successful creation
+ */
+declare const makeCreateUser: (deps: CreateUserDeps) => (input: CreateUserInput) => Promise<User>;
+//#endregion
+export { type CacheStore, CreateUserDeps, CreateUserInput, type DomainEvent, type EventBus, type EventHandler, type EventMap, type EventMeta, type EventName, GetUserProfileDeps, GetUserProfileInput, type RateLimiterStore, type TypedDomainEvent, UpdateUserProfileDeps, UpdateUserProfileInput, makeCreateUser, makeGetUserProfile, makeUpdateUserProfile };

package/dist/index.js

@@ -0,0 +1,77 @@
+import { randomUUID } from "crypto";
+
+//#region src/usecases/get-user-profile.ts
+/**
+* Use case: Get user profile
+* Pure business logic with no infrastructure dependencies
+*
+* No events for read operations - this is a query use case that doesn't
+* modify state, so no domain events are published.
+*/
+const makeGetUserProfile = (deps) => {
+	return async (input) => {
+		const user = await deps.userRepository.findById(input.userId);
+		if (!user) throw new Error("USER_NOT_FOUND");
+		return user;
+	};
+};
+
+//#endregion
+//#region src/usecases/update-user-profile.ts
+/**
+* Use case: Update user profile
+* Publishes 'user.updated' event after successful update
+*/
+const makeUpdateUserProfile = (deps) => {
+	return async (input) => {
+		const existingUser = await deps.userRepository.findById(input.userId);
+		if (!existingUser) throw new Error("USER_NOT_FOUND");
+		const updatedUser = {
+			...existingUser,
+			name: input.updates.name ?? existingUser.name,
+			email: input.updates.email ?? existingUser.email,
+			emailVerified: input.updates.emailVerified ?? existingUser.emailVerified,
+			updatedAt: deps.clock.now()
+		};
+		await deps.userRepository.save(updatedUser);
+		await deps.eventPublisher.publish("user.updated", {
+			userId: updatedUser.id,
+			changes: input.updates,
+			updatedAt: updatedUser.updatedAt
+		}, updatedUser.id);
+		return updatedUser;
+	};
+};
+
+//#endregion
+//#region src/usecases/create-user.ts
+/**
+* Use case: Create user
+* Publishes 'user.created' event after successful creation
+*/
+const makeCreateUser = (deps) => {
+	return async (input) => {
+		if (await deps.userRepository.findByEmail(input.email)) throw new Error("USER_ALREADY_EXISTS");
+		const now = deps.clock.now();
+		const newUser = {
+			id: randomUUID(),
+			name: input.name,
+			email: input.email,
+			emailVerified: input.emailVerified,
+			permissions: ["modules:read"],
+			createdAt: now,
+			updatedAt: now
+		};
+		await deps.userRepository.save(newUser);
+		await deps.eventPublisher.publish("user.created", {
+			userId: newUser.id,
+			email: newUser.email,
+			name: newUser.name,
+			createdAt: newUser.createdAt
+		}, newUser.id);
+		return newUser;
+	};
+};
+
+//#endregion
+export { makeCreateUser, makeGetUserProfile, makeUpdateUserProfile };

package/package.json

@@ -0,0 +1,46 @@
+{
+	"name": "@kuckit/application",
+	"version": "1.0.0",
+	"type": "module",
+	"main": "src/index.ts",
+	"types": "src/index.ts",
+	"files": [
+		"dist"
+	],
+	"exports": {
+		".": {
+			"types": "./src/index.ts",
+			"default": "./src/index.ts"
+		},
+		"./*": {
+			"types": "./src/*.ts",
+			"default": "./src/*.ts"
+		}
+	},
+	"publishConfig": {
+		"main": "dist/index.js",
+		"types": "dist/index.d.ts",
+		"exports": {
+			".": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"./*": {
+				"types": "./dist/*.d.ts",
+				"default": "./dist/*.js"
+			}
+		}
+	},
+	"scripts": {
+		"build": "tsdown"
+	},
+	"dependencies": {
+		"@kuckit/domain": "workspace:*"
+	},
+	"devDependencies": {
+		"tsdown": "catalog:"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	}
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './usecases'
+export * from './events'
+export * from './ports'