@kuckit/domain 1.0.2 → 2.0.0

package/dist/cache-BCBllCiT.d.ts

@@ -0,0 +1,37 @@
+//#region src/ports/cache.d.ts
+/**
+ * Cache store port interface
+ * Defines contract for caching implementations
+ */
+interface CacheStore {
+  /**
+   * Get a value from cache
+   * @param key Cache key
+   * @returns Cached value or undefined if not found or expired
+   */
+  get<T>(key: string): Promise<T | undefined>;
+  /**
+   * Set a value in cache
+   * @param key Cache key
+   * @param value Value to cache
+   * @param ttlMs Time to live in milliseconds (undefined = no expiration)
+   */
+  set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
+  /**
+   * Delete a value from cache
+   * @param key Cache key
+   */
+  del(key: string): Promise<void>;
+  /**
+   * Clear all values from cache
+   */
+  clear(): Promise<void>;
+  /**
+   * Check if a key exists in cache
+   * @param key Cache key
+   */
+  has(key: string): Promise<boolean>;
+}
+//#endregion
+export { CacheStore as t };
+//# sourceMappingURL=cache-BCBllCiT.d.ts.map

package/dist/clock-B_Gmbgwt.d.ts

@@ -0,0 +1,14 @@
+//#region src/ports/clock.d.ts
+/**
+ * Clock port for time-related operations
+ * Enables testing with fixed time
+ */
+interface Clock {
+  now(): Date;
+}
+declare class SystemClock implements Clock {
+  now(): Date;
+}
+//#endregion
+export { SystemClock as n, Clock as t };
+//# sourceMappingURL=clock-B_Gmbgwt.d.ts.map

package/dist/clock-CS5-oXPW.js

@@ -0,0 +1,10 @@
+//#region src/ports/clock.ts
+var SystemClock = class {
+	now() {
+		return /* @__PURE__ */ new Date();
+	}
+};
+
+//#endregion
+export { SystemClock as t };
+//# sourceMappingURL=clock-CS5-oXPW.js.map

package/dist/clock-CS5-oXPW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock-CS5-oXPW.js","names":[],"sources":["../src/ports/clock.ts"],"sourcesContent":["/**\n * Clock port for time-related operations\n * Enables testing with fixed time\n */\nexport interface Clock {\n\tnow(): Date\n}\n\nexport class SystemClock implements Clock {\n\tnow(): Date {\n\t\treturn new Date()\n\t}\n}\n"],"mappings":";AAQA,IAAa,cAAb,MAA0C;CACzC,MAAY;AACX,yBAAO,IAAI,MAAM"}

package/dist/entities/index.d.ts

@@ -0,0 +1,3 @@
+import { t as User } from "../user-BZDhbOim.js";
+import "../index-D25YYUbd.js";
+export { User };

package/dist/entities/index.js

@@ -0,0 +1,3 @@
+import "../entities-CSLBfyVE.js";
+
+export {  };

package/dist/entities/user.d.ts

@@ -0,0 +1,2 @@
+import { t as User } from "../user-BZDhbOim.js";
+export { User };

package/dist/entities/user.js

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

package/dist/entities-CSLBfyVE.js

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

package/dist/errors/index.d.ts

@@ -0,0 +1,2 @@
+import { a as forbidden, c as unauthorized, i as conflict, l as validationError, n as ErrorCode, o as internalError, r as ErrorSeverity, s as notFound, t as AppError } from "../index-mPubFfG4.js";
+export { AppError, ErrorCode, ErrorSeverity, conflict, forbidden, internalError, notFound, unauthorized, validationError };

package/dist/errors/index.js

@@ -0,0 +1,3 @@
+import { a as forbidden, c as unauthorized, i as conflict, l as validationError, n as ErrorCode, o as internalError, r as ErrorSeverity, s as notFound, t as AppError } from "../errors-CIxiXSCn.js";
+
+export { AppError, ErrorCode, ErrorSeverity, conflict, forbidden, internalError, notFound, unauthorized, validationError };

package/dist/errors-CIxiXSCn.js

@@ -0,0 +1,94 @@
+//#region src/errors/index.ts
+/**
+* Application error codes (domain-level)
+*/
+let ErrorCode = /* @__PURE__ */ function(ErrorCode$1) {
+	ErrorCode$1["USER_NOT_FOUND"] = "USER_NOT_FOUND";
+	ErrorCode$1["USER_ALREADY_EXISTS"] = "USER_ALREADY_EXISTS";
+	ErrorCode$1["INVALID_EMAIL"] = "INVALID_EMAIL";
+	ErrorCode$1["UNAUTHORIZED"] = "UNAUTHORIZED";
+	ErrorCode$1["FORBIDDEN"] = "FORBIDDEN";
+	ErrorCode$1["SESSION_EXPIRED"] = "SESSION_EXPIRED";
+	ErrorCode$1["INVALID_INPUT"] = "INVALID_INPUT";
+	ErrorCode$1["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+	ErrorCode$1["RATE_LIMITED"] = "RATE_LIMITED";
+	ErrorCode$1["NOT_FOUND"] = "NOT_FOUND";
+	ErrorCode$1["CONFLICT"] = "CONFLICT";
+	ErrorCode$1["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
+	return ErrorCode$1;
+}({});
+/**
+* Severity levels for error classification
+*/
+let ErrorSeverity = /* @__PURE__ */ function(ErrorSeverity$1) {
+	ErrorSeverity$1["LOW"] = "LOW";
+	ErrorSeverity$1["MEDIUM"] = "MEDIUM";
+	ErrorSeverity$1["HIGH"] = "HIGH";
+	ErrorSeverity$1["CRITICAL"] = "CRITICAL";
+	return ErrorSeverity$1;
+}({});
+/**
+* Application error base class
+*/
+var AppError = class AppError extends Error {
+	code;
+	severity;
+	statusCode;
+	meta;
+	constructor(code, message, options = {}) {
+		super(message);
+		this.name = "AppError";
+		this.code = code;
+		this.severity = options.severity || ErrorSeverity.MEDIUM;
+		this.statusCode = options.statusCode || 500;
+		this.meta = options.meta || {};
+		Object.setPrototypeOf(this, AppError.prototype);
+	}
+	toJSON() {
+		return {
+			name: this.name,
+			code: this.code,
+			message: this.message,
+			severity: this.severity,
+			statusCode: this.statusCode,
+			meta: this.meta
+		};
+	}
+};
+/**
+* Helper functions to create specific errors
+*/
+const notFound = (resource, meta) => new AppError(ErrorCode.NOT_FOUND, `${resource} not found`, {
+	statusCode: 404,
+	severity: ErrorSeverity.LOW,
+	meta
+});
+const unauthorized = (reason, meta) => new AppError(ErrorCode.UNAUTHORIZED, reason, {
+	statusCode: 401,
+	severity: ErrorSeverity.LOW,
+	meta
+});
+const forbidden = (reason, meta) => new AppError(ErrorCode.FORBIDDEN, reason, {
+	statusCode: 403,
+	severity: ErrorSeverity.LOW,
+	meta
+});
+const validationError = (message, meta) => new AppError(ErrorCode.VALIDATION_ERROR, message, {
+	statusCode: 400,
+	severity: ErrorSeverity.LOW,
+	meta
+});
+const conflict = (message, meta) => new AppError(ErrorCode.CONFLICT, message, {
+	statusCode: 409,
+	severity: ErrorSeverity.LOW,
+	meta
+});
+const internalError = (message, meta) => new AppError(ErrorCode.INTERNAL_SERVER_ERROR, message, {
+	statusCode: 500,
+	severity: ErrorSeverity.HIGH,
+	meta
+});
+
+//#endregion
+export { forbidden as a, unauthorized as c, conflict as i, validationError as l, ErrorCode as n, internalError as o, ErrorSeverity as r, notFound as s, AppError as t };
+//# sourceMappingURL=errors-CIxiXSCn.js.map

package/dist/errors-CIxiXSCn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors-CIxiXSCn.js","names":[],"sources":["../src/errors/index.ts"],"sourcesContent":["/**\n * Application error codes (domain-level)\n */\nexport enum ErrorCode {\n\t// User errors\n\tUSER_NOT_FOUND = 'USER_NOT_FOUND',\n\tUSER_ALREADY_EXISTS = 'USER_ALREADY_EXISTS',\n\tINVALID_EMAIL = 'INVALID_EMAIL',\n\n\t// Auth errors\n\tUNAUTHORIZED = 'UNAUTHORIZED',\n\tFORBIDDEN = 'FORBIDDEN',\n\tSESSION_EXPIRED = 'SESSION_EXPIRED',\n\n\t// Validation errors\n\tINVALID_INPUT = 'INVALID_INPUT',\n\tVALIDATION_ERROR = 'VALIDATION_ERROR',\n\n\t// Rate limiting\n\tRATE_LIMITED = 'RATE_LIMITED',\n\n\t// Generic errors\n\tNOT_FOUND = 'NOT_FOUND',\n\tCONFLICT = 'CONFLICT',\n\tINTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR',\n}\n\n/**\n * Severity levels for error classification\n */\nexport enum ErrorSeverity {\n\tLOW = 'LOW', // Client error, expected\n\tMEDIUM = 'MEDIUM', // Unexpected but recoverable\n\tHIGH = 'HIGH', // System error, requires attention\n\tCRITICAL = 'CRITICAL', // Complete system failure\n}\n\n/**\n * Application error base class\n */\nexport class AppError extends Error {\n\tpublic readonly code: ErrorCode\n\tpublic readonly severity: ErrorSeverity\n\tpublic readonly statusCode: number\n\tpublic readonly meta: Record<string, any>\n\n\tconstructor(\n\t\tcode: ErrorCode,\n\t\tmessage: string,\n\t\toptions: {\n\t\t\tstatusCode?: number\n\t\t\tseverity?: ErrorSeverity\n\t\t\tmeta?: Record<string, any>\n\t\t} = {}\n\t) {\n\t\tsuper(message)\n\t\tthis.name = 'AppError'\n\t\tthis.code = code\n\t\tthis.severity = options.severity || ErrorSeverity.MEDIUM\n\t\tthis.statusCode = options.statusCode || 500\n\t\tthis.meta = options.meta || {}\n\n\t\tObject.setPrototypeOf(this, AppError.prototype)\n\t}\n\n\ttoJSON() {\n\t\treturn {\n\t\t\tname: this.name,\n\t\t\tcode: this.code,\n\t\t\tmessage: this.message,\n\t\t\tseverity: this.severity,\n\t\t\tstatusCode: this.statusCode,\n\t\t\tmeta: this.meta,\n\t\t}\n\t}\n}\n\n/**\n * Helper functions to create specific errors\n */\n\nexport const notFound = (resource: string, meta?: Record<string, any>) =>\n\tnew AppError(ErrorCode.NOT_FOUND, `${resource} not found`, {\n\t\tstatusCode: 404,\n\t\tseverity: ErrorSeverity.LOW,\n\t\tmeta,\n\t})\n\nexport const unauthorized = (reason: string, meta?: Record<string, any>) =>\n\tnew AppError(ErrorCode.UNAUTHORIZED, reason, {\n\t\tstatusCode: 401,\n\t\tseverity: ErrorSeverity.LOW,\n\t\tmeta,\n\t})\n\nexport const forbidden = (reason: string, meta?: Record<string, any>) =>\n\tnew AppError(ErrorCode.FORBIDDEN, reason, {\n\t\tstatusCode: 403,\n\t\tseverity: ErrorSeverity.LOW,\n\t\tmeta,\n\t})\n\nexport const validationError = (message: string, meta?: Record<string, any>) =>\n\tnew AppError(ErrorCode.VALIDATION_ERROR, message, {\n\t\tstatusCode: 400,\n\t\tseverity: ErrorSeverity.LOW,\n\t\tmeta,\n\t})\n\nexport const conflict = (message: string, meta?: Record<string, any>) =>\n\tnew AppError(ErrorCode.CONFLICT, message, {\n\t\tstatusCode: 409,\n\t\tseverity: ErrorSeverity.LOW,\n\t\tmeta,\n\t})\n\nexport const internalError = (message: string, meta?: Record<string, any>) =>\n\tnew AppError(ErrorCode.INTERNAL_SERVER_ERROR, message, {\n\t\tstatusCode: 500,\n\t\tseverity: ErrorSeverity.HIGH,\n\t\tmeta,\n\t})\n"],"mappings":";;;;AAGA,IAAY,kDAAL;AAEN;AACA;AACA;AAGA;AACA;AACA;AAGA;AACA;AAGA;AAGA;AACA;AACA;;;;;;AAMD,IAAY,0DAAL;AACN;AACA;AACA;AACA;;;;;;AAMD,IAAa,WAAb,MAAa,iBAAiB,MAAM;CACnC,AAAgB;CAChB,AAAgB;CAChB,AAAgB;CAChB,AAAgB;CAEhB,YACC,MACA,SACA,UAII,EAAE,EACL;AACD,QAAM,QAAQ;AACd,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,WAAW,QAAQ,YAAY,cAAc;AAClD,OAAK,aAAa,QAAQ,cAAc;AACxC,OAAK,OAAO,QAAQ,QAAQ,EAAE;AAE9B,SAAO,eAAe,MAAM,SAAS,UAAU;;CAGhD,SAAS;AACR,SAAO;GACN,MAAM,KAAK;GACX,MAAM,KAAK;GACX,SAAS,KAAK;GACd,UAAU,KAAK;GACf,YAAY,KAAK;GACjB,MAAM,KAAK;GACX;;;;;;AAQH,MAAa,YAAY,UAAkB,SAC1C,IAAI,SAAS,UAAU,WAAW,GAAG,SAAS,aAAa;CAC1D,YAAY;CACZ,UAAU,cAAc;CACxB;CACA,CAAC;AAEH,MAAa,gBAAgB,QAAgB,SAC5C,IAAI,SAAS,UAAU,cAAc,QAAQ;CAC5C,YAAY;CACZ,UAAU,cAAc;CACxB;CACA,CAAC;AAEH,MAAa,aAAa,QAAgB,SACzC,IAAI,SAAS,UAAU,WAAW,QAAQ;CACzC,YAAY;CACZ,UAAU,cAAc;CACxB;CACA,CAAC;AAEH,MAAa,mBAAmB,SAAiB,SAChD,IAAI,SAAS,UAAU,kBAAkB,SAAS;CACjD,YAAY;CACZ,UAAU,cAAc;CACxB;CACA,CAAC;AAEH,MAAa,YAAY,SAAiB,SACzC,IAAI,SAAS,UAAU,UAAU,SAAS;CACzC,YAAY;CACZ,UAAU,cAAc;CACxB;CACA,CAAC;AAEH,MAAa,iBAAiB,SAAiB,SAC9C,IAAI,SAAS,UAAU,uBAAuB,SAAS;CACtD,YAAY;CACZ,UAAU,cAAc;CACxB;CACA,CAAC"}

package/dist/event-bus-6ldeQa_H.d.ts

@@ -0,0 +1,51 @@
+import { a as TypedDomainEvent, i as EventName } from "./types-BMU8Ezie.js";
+
+//#region src/events/event-bus.d.ts
+
+/**
+ * Event handler function
+ * Handles a specific event type
+ * Should not throw; errors are caught and logged
+ */
+type EventHandler<TName extends EventName = EventName> = (event: TypedDomainEvent<TName>) => void | Promise<void>;
+/**
+ * Event bus interface
+ * Handles publishing domain events and managing subscriptions
+ */
+interface EventBus {
+  /**
+   * Publish event synchronously
+   * Awaits all handlers to complete before returning
+   * Errors in handlers are caught and logged, don't block others
+   *
+   * @param event The domain event to publish
+   */
+  publish<TName extends EventName>(event: TypedDomainEvent<TName>): Promise<void>;
+  /**
+   * Publish event asynchronously
+   * Uses queueMicrotask to defer execution, returns immediately
+   * Errors in handlers are caught and logged
+   *
+   * @param event The domain event to publish
+   */
+  publishAsync<TName extends EventName>(event: TypedDomainEvent<TName>): void;
+  /**
+   * Subscribe to specific event type
+   * Returns unsubscribe function to remove handler
+   *
+   * @param eventName Event name to subscribe to (e.g., 'user.created')
+   * @param handler Event handler function
+   * @returns Unsubscribe function
+   */
+  subscribe<TName extends EventName>(eventName: TName, handler: EventHandler<TName>): () => void;
+  /**
+   * Subscribe to all events
+   *
+   * @param handler Event handler function
+   * @returns Unsubscribe function
+   */
+  subscribeAll(handler: EventHandler): () => void;
+}
+//#endregion
+export { EventHandler as n, EventBus as t };
+//# sourceMappingURL=event-bus-6ldeQa_H.d.ts.map

package/dist/event-publisher-BBAp1zM3.d.ts

@@ -0,0 +1,27 @@
+//#region src/ports/event-publisher.d.ts
+/**
+ * Event publisher port
+ * Used by use cases to publish domain events
+ *
+ * Note: This is a simplified interface for use case dependencies.
+ * The actual EventBus in infrastructure is more feature-rich.
+ */
+interface EventPublisher {
+  /**
+   * Publish a domain event
+   * @param eventName Event name (e.g., 'user.created')
+   * @param payload Event payload data
+   * @param aggregateId The aggregate ID (e.g., userId)
+   */
+  publish(eventName: string, payload: Record<string, any>, aggregateId: string): Promise<void>;
+  /**
+   * Subscribe to events (for event handlers in infrastructure)
+   * @param eventName The event name to listen for
+   * @param handler The handler function
+   * @returns Unsubscribe function
+   */
+  subscribe(eventName: string, handler: (payload: Record<string, any>) => Promise<void> | void): () => void;
+}
+//#endregion
+export { EventPublisher as t };
+//# sourceMappingURL=event-publisher-BBAp1zM3.d.ts.map

package/dist/events/event-bus.d.ts

@@ -0,0 +1,3 @@
+import "../types-BMU8Ezie.js";
+import { n as EventHandler, t as EventBus } from "../event-bus-6ldeQa_H.js";
+export { EventBus, EventHandler };

package/dist/events/event-bus.js

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

package/dist/events/index.d.ts

@@ -0,0 +1,4 @@
+import { a as TypedDomainEvent, i as EventName, n as EventMap, r as EventMeta, t as DomainEvent } from "../types-BMU8Ezie.js";
+import { n as EventHandler, t as EventBus } from "../event-bus-6ldeQa_H.js";
+import "../index-BoGG5KAY.js";
+export { DomainEvent, EventBus, EventHandler, EventMap, EventMeta, EventName, TypedDomainEvent };

package/dist/events/index.js

@@ -0,0 +1,3 @@
+import "../events-CBFE7GCV.js";
+
+export {  };

package/dist/events/types.d.ts

@@ -0,0 +1,2 @@
+import { a as TypedDomainEvent, i as EventName, n as EventMap, r as EventMeta, t as DomainEvent } from "../types-BMU8Ezie.js";
+export { DomainEvent, EventMap, EventMeta, EventName, TypedDomainEvent };

package/dist/events/types.js

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

package/dist/events-CBFE7GCV.js

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

package/dist/index-BoGG5KAY.d.ts

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

package/dist/index-C2geSgue.d.ts

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

package/dist/index-D25YYUbd.d.ts

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

package/dist/index-mPubFfG4.d.ts

@@ -0,0 +1,64 @@
+//#region src/errors/index.d.ts
+/**
+ * Application error codes (domain-level)
+ */
+declare enum ErrorCode {
+  USER_NOT_FOUND = "USER_NOT_FOUND",
+  USER_ALREADY_EXISTS = "USER_ALREADY_EXISTS",
+  INVALID_EMAIL = "INVALID_EMAIL",
+  UNAUTHORIZED = "UNAUTHORIZED",
+  FORBIDDEN = "FORBIDDEN",
+  SESSION_EXPIRED = "SESSION_EXPIRED",
+  INVALID_INPUT = "INVALID_INPUT",
+  VALIDATION_ERROR = "VALIDATION_ERROR",
+  RATE_LIMITED = "RATE_LIMITED",
+  NOT_FOUND = "NOT_FOUND",
+  CONFLICT = "CONFLICT",
+  INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
+}
+/**
+ * Severity levels for error classification
+ */
+declare enum ErrorSeverity {
+  LOW = "LOW",
+  // Client error, expected
+  MEDIUM = "MEDIUM",
+  // Unexpected but recoverable
+  HIGH = "HIGH",
+  // System error, requires attention
+  CRITICAL = "CRITICAL",
+}
+/**
+ * Application error base class
+ */
+declare class AppError extends Error {
+  readonly code: ErrorCode;
+  readonly severity: ErrorSeverity;
+  readonly statusCode: number;
+  readonly meta: Record<string, any>;
+  constructor(code: ErrorCode, message: string, options?: {
+    statusCode?: number;
+    severity?: ErrorSeverity;
+    meta?: Record<string, any>;
+  });
+  toJSON(): {
+    name: string;
+    code: ErrorCode;
+    message: string;
+    severity: ErrorSeverity;
+    statusCode: number;
+    meta: Record<string, any>;
+  };
+}
+/**
+ * Helper functions to create specific errors
+ */
+declare const notFound: (resource: string, meta?: Record<string, any>) => AppError;
+declare const unauthorized: (reason: string, meta?: Record<string, any>) => AppError;
+declare const forbidden: (reason: string, meta?: Record<string, any>) => AppError;
+declare const validationError: (message: string, meta?: Record<string, any>) => AppError;
+declare const conflict: (message: string, meta?: Record<string, any>) => AppError;
+declare const internalError: (message: string, meta?: Record<string, any>) => AppError;
+//#endregion
+export { forbidden as a, unauthorized as c, conflict as i, validationError as l, ErrorCode as n, internalError as o, ErrorSeverity as r, notFound as s, AppError as t };
+//# sourceMappingURL=index-mPubFfG4.d.ts.map

package/dist/index.d.ts

@@ -1,313 +1,14 @@
-//#region src/entities/user.d.ts
-/**
- * User domain entity
- * Pure TypeScript type with no dependencies
- */
-interface User {
-  readonly id: string;
-  readonly name: string;
-  readonly email: string;
-  readonly emailVerified: boolean;
-  readonly permissions: readonly string[];
-  readonly createdAt: Date;
-  readonly updatedAt: Date;
-}
-//#endregion
-//#region src/ports/user-repository.d.ts
-/**
- * Repository port (interface) for user persistence
- * Infrastructure layer will implement this
- */
-interface UserRepository {
-  findById(id: string): Promise<User | null>;
-  findByEmail(email: string): Promise<User | null>;
-  save(user: User): Promise<void>;
-}
-//#endregion
-//#region src/ports/clock.d.ts
-/**
- * Clock port for time-related operations
- * Enables testing with fixed time
- */
-interface Clock {
-  now(): Date;
-}
-declare class SystemClock implements Clock {
-  now(): Date;
-}
-//#endregion
-//#region 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
-//#region src/ports/event-publisher.d.ts
-/**
- * Event publisher port
- * Used by use cases to publish domain events
- *
- * Note: This is a simplified interface for use case dependencies.
- * The actual EventBus in infrastructure is more feature-rich.
- */
-interface EventPublisher {
-  /**
-   * Publish a domain event
-   * @param eventName Event name (e.g., 'user.created')
-   * @param payload Event payload data
-   * @param aggregateId The aggregate ID (e.g., userId)
-   */
-  publish(eventName: string, payload: Record<string, any>, aggregateId: string): Promise<void>;
-  /**
-   * Subscribe to events (for event handlers in infrastructure)
-   * @param eventName The event name to listen for
-   * @param handler The handler function
-   * @returns Unsubscribe function
-   */
-  subscribe(eventName: string, handler: (payload: Record<string, any>) => Promise<void> | void): () => void;
-}
-//#endregion
-//#region src/ports/cache.d.ts
-/**
- * Cache store port interface
- * Defines contract for caching implementations
- */
-interface CacheStore {
-  /**
-   * Get a value from cache
-   * @param key Cache key
-   * @returns Cached value or undefined if not found or expired
-   */
-  get<T>(key: string): Promise<T | undefined>;
-  /**
-   * Set a value in cache
-   * @param key Cache key
-   * @param value Value to cache
-   * @param ttlMs Time to live in milliseconds (undefined = no expiration)
-   */
-  set<T>(key: string, value: T, ttlMs?: number): Promise<void>;
-  /**
-   * Delete a value from cache
-   * @param key Cache key
-   */
-  del(key: string): Promise<void>;
-  /**
-   * Clear all values from cache
-   */
-  clear(): Promise<void>;
-  /**
-   * Check if a key exists in cache
-   * @param key Cache key
-   */
-  has(key: string): Promise<boolean>;
-}
-//#endregion
-//#region src/ports/rate-limiter.d.ts
-/**
- * Rate limiter store port interface
- * Uses token bucket algorithm for rate limiting
- */
-interface RateLimiterStore {
-  /**
-   * Check if a request should be allowed
-   * @param key Rate limit key (per-user, per-IP, etc)
-   * @param capacity Bucket capacity (max tokens)
-   * @param refillPerSecond Number of tokens to refill per second
-   * @returns Object with allowed flag and reset time if rate limited
-   */
-  checkLimit(key: string, capacity: number, refillPerSecond: number): Promise<{
-    allowed: boolean;
-    tokensRemaining: number;
-    resetAt: Date;
-  }>;
-  /**
-   * Reset rate limit for a key
-   * @param key Rate limit key
-   */
-  reset(key: string): Promise<void>;
-  /**
-   * Clear all rate limit data
-   */
-  clear(): Promise<void>;
-}
-//#endregion
-//#region src/errors/index.d.ts
-/**
- * Application error codes (domain-level)
- */
-declare enum ErrorCode {
-  USER_NOT_FOUND = "USER_NOT_FOUND",
-  USER_ALREADY_EXISTS = "USER_ALREADY_EXISTS",
-  INVALID_EMAIL = "INVALID_EMAIL",
-  UNAUTHORIZED = "UNAUTHORIZED",
-  FORBIDDEN = "FORBIDDEN",
-  SESSION_EXPIRED = "SESSION_EXPIRED",
-  INVALID_INPUT = "INVALID_INPUT",
-  VALIDATION_ERROR = "VALIDATION_ERROR",
-  RATE_LIMITED = "RATE_LIMITED",
-  NOT_FOUND = "NOT_FOUND",
-  CONFLICT = "CONFLICT",
-  INTERNAL_SERVER_ERROR = "INTERNAL_SERVER_ERROR",
-}
-/**
- * Severity levels for error classification
- */
-declare enum ErrorSeverity {
-  LOW = "LOW",
-  // Client error, expected
-  MEDIUM = "MEDIUM",
-  // Unexpected but recoverable
-  HIGH = "HIGH",
-  // System error, requires attention
-  CRITICAL = "CRITICAL",
-}
-/**
- * Application error base class
- */
-declare class AppError extends Error {
-  readonly code: ErrorCode;
-  readonly severity: ErrorSeverity;
-  readonly statusCode: number;
-  readonly meta: Record<string, any>;
-  constructor(code: ErrorCode, message: string, options?: {
-    statusCode?: number;
-    severity?: ErrorSeverity;
-    meta?: Record<string, any>;
-  });
-  toJSON(): {
-    name: string;
-    code: ErrorCode;
-    message: string;
-    severity: ErrorSeverity;
-    statusCode: number;
-    meta: Record<string, any>;
-  };
-}
-/**
- * Helper functions to create specific errors
- */
-declare const notFound: (resource: string, meta?: Record<string, any>) => AppError;
-declare const unauthorized: (reason: string, meta?: Record<string, any>) => AppError;
-declare const forbidden: (reason: string, meta?: Record<string, any>) => AppError;
-declare const validationError: (message: string, meta?: Record<string, any>) => AppError;
-declare const conflict: (message: string, meta?: Record<string, any>) => AppError;
-declare const internalError: (message: string, meta?: Record<string, any>) => AppError;
-//#endregion
-//#region src/events/types.d.ts
-/**
- * Event-driven architecture types
- *
- * Event names follow 'module.action' pattern: 'user.created', 'user.updated'
- * All events are strongly typed through EventMap
- */
-/**
- * Event metadata included with every domain event
- */
-interface EventMeta {
-  /** Unique identifier for this event */
-  readonly eventId: string;
-  /** Timestamp when event occurred */
-  readonly occurredAt: Date;
-  /** Event schema version for migrations */
-  readonly version: number;
-  /** Aggregate ID (e.g., userId for user events) */
-  readonly aggregateId: string;
-  /** Correlation ID for tracing across services */
-  readonly correlationId: string;
-}
-/**
- * Base domain event type
- * All domain events extend this interface
- */
-interface DomainEvent<TName extends string = string, TPayload extends Record<string, any> = Record<string, any>> {
-  /** Event name in 'module.action' format */
-  readonly name: TName;
-  /** Event payload (action-specific data) */
-  readonly payload: TPayload;
-  /** Event metadata (standard for all events) */
-  readonly meta: EventMeta;
-}
-/**
- * Event map definition - extend this to add typed events
- * Maps event names to their payload types
- *
- * Example:
- * interface EventMap {
- *   'user.created': { userId: string; email: string }
- *   'user.updated': { userId: string; name: string }
- * }
- */
-interface EventMap {
-  [key: string]: Record<string, any>;
-}
-/**
- * Valid event names derived from EventMap
- */
-type EventName = keyof EventMap & string;
-/**
- * Typed domain event for a specific event name
- */
-type TypedDomainEvent<TName extends EventName = EventName> = DomainEvent<TName, EventMap[TName]>;
-//#endregion
-//#region src/events/event-bus.d.ts
-/**
- * Event handler function
- * Handles a specific event type
- * Should not throw; errors are caught and logged
- */
-type EventHandler<TName extends EventName = EventName> = (event: TypedDomainEvent<TName>) => void | Promise<void>;
-/**
- * Event bus interface
- * Handles publishing domain events and managing subscriptions
- */
-interface EventBus {
-  /**
-   * Publish event synchronously
-   * Awaits all handlers to complete before returning
-   * Errors in handlers are caught and logged, don't block others
-   *
-   * @param event The domain event to publish
-   */
-  publish<TName extends EventName>(event: TypedDomainEvent<TName>): Promise<void>;
-  /**
-   * Publish event asynchronously
-   * Uses queueMicrotask to defer execution, returns immediately
-   * Errors in handlers are caught and logged
-   *
-   * @param event The domain event to publish
-   */
-  publishAsync<TName extends EventName>(event: TypedDomainEvent<TName>): void;
-  /**
-   * Subscribe to specific event type
-   * Returns unsubscribe function to remove handler
-   *
-   * @param eventName Event name to subscribe to (e.g., 'user.created')
-   * @param handler Event handler function
-   * @returns Unsubscribe function
-   */
-  subscribe<TName extends EventName>(eventName: TName, handler: EventHandler<TName>): () => void;
-  /**
-   * Subscribe to all events
-   *
-   * @param handler Event handler function
-   * @returns Unsubscribe function
-   */
-  subscribeAll(handler: EventHandler): () => void;
-}
-//#endregion
+import { t as User } from "./user-BZDhbOim.js";
+import "./index-D25YYUbd.js";
+import { a as forbidden, c as unauthorized, i as conflict, l as validationError, n as ErrorCode, o as internalError, r as ErrorSeverity, s as notFound, t as AppError } from "./index-mPubFfG4.js";
+import { a as TypedDomainEvent, i as EventName, n as EventMap, r as EventMeta, t as DomainEvent } from "./types-BMU8Ezie.js";
+import { n as EventHandler, t as EventBus } from "./event-bus-6ldeQa_H.js";
+import "./index-BoGG5KAY.js";
+import { t as UserRepository } from "./user-repository-C4N9DoGU.js";
+import { n as SystemClock, t as Clock } from "./clock-B_Gmbgwt.js";
+import { n as Logger, t as LogContext } from "./logger-QZhxEopI.js";
+import { t as EventPublisher } from "./event-publisher-BBAp1zM3.js";
+import { t as CacheStore } from "./cache-BCBllCiT.js";
+import { t as RateLimiterStore } from "./rate-limiter--mNNkSfP.js";
+import "./index-C2geSgue.js";
 export { AppError, CacheStore, Clock, DomainEvent, ErrorCode, ErrorSeverity, EventBus, EventHandler, EventMap, EventMeta, EventName, EventPublisher, LogContext, Logger, RateLimiterStore, SystemClock, TypedDomainEvent, User, UserRepository, conflict, forbidden, internalError, notFound, unauthorized, validationError };

package/dist/index.js

@@ -1,101 +1,7 @@
-//#region src/ports/clock.ts
-var SystemClock = class {
-	now() {
-		return /* @__PURE__ */ new Date();
-	}
-};
+import "./entities-CSLBfyVE.js";
+import { t as SystemClock } from "./clock-CS5-oXPW.js";
+import "./ports-6MZqRxhO.js";
+import { a as forbidden, c as unauthorized, i as conflict, l as validationError, n as ErrorCode, o as internalError, r as ErrorSeverity, s as notFound, t as AppError } from "./errors-CIxiXSCn.js";
+import "./events-CBFE7GCV.js";
 
-//#endregion
-//#region src/errors/index.ts
-/**
-* Application error codes (domain-level)
-*/
-let ErrorCode = /* @__PURE__ */ function(ErrorCode$1) {
-	ErrorCode$1["USER_NOT_FOUND"] = "USER_NOT_FOUND";
-	ErrorCode$1["USER_ALREADY_EXISTS"] = "USER_ALREADY_EXISTS";
-	ErrorCode$1["INVALID_EMAIL"] = "INVALID_EMAIL";
-	ErrorCode$1["UNAUTHORIZED"] = "UNAUTHORIZED";
-	ErrorCode$1["FORBIDDEN"] = "FORBIDDEN";
-	ErrorCode$1["SESSION_EXPIRED"] = "SESSION_EXPIRED";
-	ErrorCode$1["INVALID_INPUT"] = "INVALID_INPUT";
-	ErrorCode$1["VALIDATION_ERROR"] = "VALIDATION_ERROR";
-	ErrorCode$1["RATE_LIMITED"] = "RATE_LIMITED";
-	ErrorCode$1["NOT_FOUND"] = "NOT_FOUND";
-	ErrorCode$1["CONFLICT"] = "CONFLICT";
-	ErrorCode$1["INTERNAL_SERVER_ERROR"] = "INTERNAL_SERVER_ERROR";
-	return ErrorCode$1;
-}({});
-/**
-* Severity levels for error classification
-*/
-let ErrorSeverity = /* @__PURE__ */ function(ErrorSeverity$1) {
-	ErrorSeverity$1["LOW"] = "LOW";
-	ErrorSeverity$1["MEDIUM"] = "MEDIUM";
-	ErrorSeverity$1["HIGH"] = "HIGH";
-	ErrorSeverity$1["CRITICAL"] = "CRITICAL";
-	return ErrorSeverity$1;
-}({});
-/**
-* Application error base class
-*/
-var AppError = class AppError extends Error {
-	code;
-	severity;
-	statusCode;
-	meta;
-	constructor(code, message, options = {}) {
-		super(message);
-		this.name = "AppError";
-		this.code = code;
-		this.severity = options.severity || ErrorSeverity.MEDIUM;
-		this.statusCode = options.statusCode || 500;
-		this.meta = options.meta || {};
-		Object.setPrototypeOf(this, AppError.prototype);
-	}
-	toJSON() {
-		return {
-			name: this.name,
-			code: this.code,
-			message: this.message,
-			severity: this.severity,
-			statusCode: this.statusCode,
-			meta: this.meta
-		};
-	}
-};
-/**
-* Helper functions to create specific errors
-*/
-const notFound = (resource, meta) => new AppError(ErrorCode.NOT_FOUND, `${resource} not found`, {
-	statusCode: 404,
-	severity: ErrorSeverity.LOW,
-	meta
-});
-const unauthorized = (reason, meta) => new AppError(ErrorCode.UNAUTHORIZED, reason, {
-	statusCode: 401,
-	severity: ErrorSeverity.LOW,
-	meta
-});
-const forbidden = (reason, meta) => new AppError(ErrorCode.FORBIDDEN, reason, {
-	statusCode: 403,
-	severity: ErrorSeverity.LOW,
-	meta
-});
-const validationError = (message, meta) => new AppError(ErrorCode.VALIDATION_ERROR, message, {
-	statusCode: 400,
-	severity: ErrorSeverity.LOW,
-	meta
-});
-const conflict = (message, meta) => new AppError(ErrorCode.CONFLICT, message, {
-	statusCode: 409,
-	severity: ErrorSeverity.LOW,
-	meta
-});
-const internalError = (message, meta) => new AppError(ErrorCode.INTERNAL_SERVER_ERROR, message, {
-	statusCode: 500,
-	severity: ErrorSeverity.HIGH,
-	meta
-});
-
-//#endregion
 export { AppError, ErrorCode, ErrorSeverity, SystemClock, conflict, forbidden, internalError, notFound, unauthorized, validationError };

package/dist/logger-QZhxEopI.d.ts

@@ -0,0 +1,23 @@
+//#region 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-QZhxEopI.d.ts.map

package/dist/ports/cache.d.ts

@@ -0,0 +1,2 @@
+import { t as CacheStore } from "../cache-BCBllCiT.js";
+export { CacheStore };

package/dist/ports/cache.js

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

package/dist/ports/clock.d.ts

@@ -0,0 +1,2 @@
+import { n as SystemClock, t as Clock } from "../clock-B_Gmbgwt.js";
+export { Clock, SystemClock };

package/dist/ports/clock.js

@@ -0,0 +1,3 @@
+import { t as SystemClock } from "../clock-CS5-oXPW.js";
+
+export { SystemClock };

package/dist/ports/event-publisher.d.ts

@@ -0,0 +1,2 @@
+import { t as EventPublisher } from "../event-publisher-BBAp1zM3.js";
+export { EventPublisher };

package/dist/ports/event-publisher.js

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

package/dist/ports/index.d.ts

@@ -0,0 +1,9 @@
+import "../user-BZDhbOim.js";
+import { t as UserRepository } from "../user-repository-C4N9DoGU.js";
+import { n as SystemClock, t as Clock } from "../clock-B_Gmbgwt.js";
+import { n as Logger, t as LogContext } from "../logger-QZhxEopI.js";
+import { t as EventPublisher } from "../event-publisher-BBAp1zM3.js";
+import { t as CacheStore } from "../cache-BCBllCiT.js";
+import { t as RateLimiterStore } from "../rate-limiter--mNNkSfP.js";
+import "../index-C2geSgue.js";
+export { CacheStore, Clock, EventPublisher, LogContext, Logger, RateLimiterStore, SystemClock, UserRepository };

package/dist/ports/index.js

@@ -0,0 +1,4 @@
+import { t as SystemClock } from "../clock-CS5-oXPW.js";
+import "../ports-6MZqRxhO.js";
+
+export { SystemClock };

package/dist/ports/logger.d.ts

@@ -0,0 +1,2 @@
+import { n as Logger, t as LogContext } from "../logger-QZhxEopI.js";
+export { LogContext, Logger };

package/dist/ports/logger.js

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

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

@@ -0,0 +1,2 @@
+import { t as RateLimiterStore } from "../rate-limiter--mNNkSfP.js";
+export { RateLimiterStore };

package/dist/ports/rate-limiter.js

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

package/dist/ports/user-repository.d.ts

@@ -0,0 +1,3 @@
+import "../user-BZDhbOim.js";
+import { t as UserRepository } from "../user-repository-C4N9DoGU.js";
+export { UserRepository };

package/dist/ports/user-repository.js

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

package/dist/ports-6MZqRxhO.js

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

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

@@ -0,0 +1,31 @@
+//#region src/ports/rate-limiter.d.ts
+/**
+ * Rate limiter store port interface
+ * Uses token bucket algorithm for rate limiting
+ */
+interface RateLimiterStore {
+  /**
+   * Check if a request should be allowed
+   * @param key Rate limit key (per-user, per-IP, etc)
+   * @param capacity Bucket capacity (max tokens)
+   * @param refillPerSecond Number of tokens to refill per second
+   * @returns Object with allowed flag and reset time if rate limited
+   */
+  checkLimit(key: string, capacity: number, refillPerSecond: number): Promise<{
+    allowed: boolean;
+    tokensRemaining: number;
+    resetAt: Date;
+  }>;
+  /**
+   * Reset rate limit for a key
+   * @param key Rate limit key
+   */
+  reset(key: string): Promise<void>;
+  /**
+   * Clear all rate limit data
+   */
+  clear(): Promise<void>;
+}
+//#endregion
+export { RateLimiterStore as t };
+//# sourceMappingURL=rate-limiter--mNNkSfP.d.ts.map

package/dist/types-BMU8Ezie.d.ts

@@ -0,0 +1,58 @@
+//#region src/events/types.d.ts
+/**
+ * Event-driven architecture types
+ *
+ * Event names follow 'module.action' pattern: 'user.created', 'user.updated'
+ * All events are strongly typed through EventMap
+ */
+/**
+ * Event metadata included with every domain event
+ */
+interface EventMeta {
+  /** Unique identifier for this event */
+  readonly eventId: string;
+  /** Timestamp when event occurred */
+  readonly occurredAt: Date;
+  /** Event schema version for migrations */
+  readonly version: number;
+  /** Aggregate ID (e.g., userId for user events) */
+  readonly aggregateId: string;
+  /** Correlation ID for tracing across services */
+  readonly correlationId: string;
+}
+/**
+ * Base domain event type
+ * All domain events extend this interface
+ */
+interface DomainEvent<TName extends string = string, TPayload extends Record<string, any> = Record<string, any>> {
+  /** Event name in 'module.action' format */
+  readonly name: TName;
+  /** Event payload (action-specific data) */
+  readonly payload: TPayload;
+  /** Event metadata (standard for all events) */
+  readonly meta: EventMeta;
+}
+/**
+ * Event map definition - extend this to add typed events
+ * Maps event names to their payload types
+ *
+ * Example:
+ * interface EventMap {
+ *   'user.created': { userId: string; email: string }
+ *   'user.updated': { userId: string; name: string }
+ * }
+ */
+interface EventMap {
+  [key: string]: Record<string, any>;
+}
+/**
+ * Valid event names derived from EventMap
+ */
+type EventName = keyof EventMap & string;
+/**
+ * Typed domain event for a specific event name
+ */
+type TypedDomainEvent<TName extends EventName = EventName> = DomainEvent<TName, EventMap[TName]>;
+//#endregion
+export { TypedDomainEvent as a, EventName as i, EventMap as n, EventMeta as r, DomainEvent as t };
+//# sourceMappingURL=types-BMU8Ezie.d.ts.map

package/dist/user-BZDhbOim.d.ts

@@ -0,0 +1,17 @@
+//#region src/entities/user.d.ts
+/**
+ * User domain entity
+ * Pure TypeScript type with no dependencies
+ */
+interface User {
+  readonly id: string;
+  readonly name: string;
+  readonly email: string;
+  readonly emailVerified: boolean;
+  readonly permissions: readonly string[];
+  readonly createdAt: Date;
+  readonly updatedAt: Date;
+}
+//#endregion
+export { User as t };
+//# sourceMappingURL=user-BZDhbOim.d.ts.map

package/dist/user-repository-C4N9DoGU.d.ts

@@ -0,0 +1,16 @@
+import { t as User } from "./user-BZDhbOim.js";
+
+//#region src/ports/user-repository.d.ts
+
+/**
+ * Repository port (interface) for user persistence
+ * Infrastructure layer will implement this
+ */
+interface UserRepository {
+  findById(id: string): Promise<User | null>;
+  findByEmail(email: string): Promise<User | null>;
+  save(user: User): Promise<void>;
+}
+//#endregion
+export { UserRepository as t };
+//# sourceMappingURL=user-repository-C4N9DoGU.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kuckit/domain",
-	"version": "1.0.2",
+	"version": "2.0.0",
 	"type": "module",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",