@longzai-intelligence/shared-kernel 0.0.1

package/README.md

@@ -0,0 +1,35 @@
+# @longzai-intelligence/shared-kernel
+
+DDD 基础抽象包 - 提供领域驱动设计的核心抽象，无具体业务实现。
+
+## 安装
+
+```bash
+bun add @longzai-intelligence/shared-kernel
+```
+
+## 核心模块
+
+### 实体基类
+
+提供领域实体和聚合根的基础抽象。
+
+### 领域事件
+
+提供领域事件的基类和通用事件类型。
+
+### Result 模式
+
+提供函数式的错误处理模式。
+
+### 领域异常
+
+提供统一的领域异常体系。
+
+### 值对象
+
+提供值对象的基础抽象。
+
+### 仓储接口
+
+提供仓储的基础接口定义。

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`zod`);var t=class{_id;_props;_events=[];constructor(e,t){this._id=e,this._props=t}get id(){return this._id}get props(){return this._props}updateProps(e,t){this._props[e]=t}addEvent(e){this._events.push(e)}pullEvents(){let e=[...this._events];return this._events=[],e}hasEvents(){return this._events.length>0}equals(e){return this._id===e._id}},n=class extends t{_version=1;_isDirty=!1;get version(){return this._version}get isDirty(){return this._isDirty}markAsDirty(){this._isDirty=!0,this._version++}},r=class{static TYPE;eventId;occurredAt;traceContext;constructor(e,t){this.eventId=e,this.occurredAt=new Date,this.traceContext=t}toJSON(){return{eventId:this.eventId,type:this.type,occurredAt:this.occurredAt.toISOString(),traceContext:this.traceContext}}},i=class extends r{type=`entity:created`;constructor(e,t,n){super(e),this.entityType=t,this.entityId=n}toJSON(){return{...super.toJSON(),entityType:this.entityType,entityId:this.entityId}}},a=class extends r{type=`entity:updated`;constructor(e,t,n,r){super(e),this.entityType=t,this.entityId=n,this.changes=r}toJSON(){return{...super.toJSON(),entityType:this.entityType,entityId:this.entityId,changes:this.changes}}},o=class extends r{type=`entity:deleted`;constructor(e,t,n){super(e),this.entityType=t,this.entityId=n}toJSON(){return{...super.toJSON(),entityType:this.entityType,entityId:this.entityId}}},s=class extends Error{constructor(e,t=`DOMAIN_ERROR`,n){super(e),this.code=t,this.context=n,this.name=`DomainError`}toJSON(){return{name:this.name,code:this.code,message:this.message,context:this.context,stack:this.stack}}},c=class extends s{constructor(e,t,n){super(e,`VALIDATION_ERROR`,{field:t,value:n}),this.field=t,this.value=n,this.name=`ValidationError`}},l=class extends s{constructor(e,t){super(e,`BUSINESS_RULE_ERROR`,{rule:t}),this.name=`BusinessRuleError`}},u=class extends s{constructor(e,t){super(`${e} 未找到: ${t}`,`ENTITY_NOT_FOUND`,{entityType:e,entityId:t}),this.entityType=e,this.entityId=t,this.name=`EntityNotFoundError`}},d=class extends s{constructor(e,t,n){super(e,`REPOSITORY_ERROR`,n),this.cause=t,this.name=`RepositoryError`}toJSON(){return{...super.toJSON(),cause:this.cause?.message}}},f=class extends s{constructor(e=`并发冲突，请重试`){super(e,`CONCURRENCY_ERROR`),this.name=`ConcurrencyError`}},p=class extends s{constructor(e,t){super(`无权限执行操作: ${t} on ${e}`,`PERMISSION_DENIED`,{resource:e,action:t}),this.resource=e,this.action=t,this.name=`PermissionDeniedError`}},m=class extends s{constructor(e,t){super(e,`CONFIGURATION_ERROR`,{key:t}),this.key=t,this.name=`ConfigurationError`}},h=class extends s{constructor(e,t,n){super(t,`EXTERNAL_SERVICE_ERROR`,{service:e}),this.service=e,this.name=`ExternalServiceError`,n&&(this.cause=n)}};function g(e){return e instanceof s?e:e instanceof Error?new d(e.message,e):new d(String(e))}function _(e,t,n){(n?t.withOperation(n):t).error(e.message,e,{code:e.code,name:e.name,context:e.context})}function v(e){return[`CONCURRENCY_ERROR`,`EXTERNAL_SERVICE_ERROR`].includes(e.code)}function y(e){return[`VALIDATION_ERROR`,`BUSINESS_RULE_ERROR`,`ENTITY_NOT_FOUND`,`PERMISSION_DENIED`].includes(e.code)}function b(e){return e instanceof c}function x(e){return e instanceof l}function S(e){return e instanceof u}function C(e){return e instanceof d}function w(e){return e instanceof f}function T(e){return e instanceof p}function E(e){return e instanceof m}function D(e){return e instanceof h}const O=Symbol(`UnitOfWork`);var k=class{_value;constructor(e){this._value=Object.freeze(e)}get value(){return this._value}valueOf(){return this._value}toString(){return String(this._value)}},A=class e extends k{constructor(e){super(e)}static fromString(t){if(!t||t.trim().length===0)throw Error(`实体 ID 不能为空`);return new e(t)}equals(e){return this._value===e._value}},j=class e extends k{constructor(e){super(e)}static now(){return new e(Date.now())}static fromDate(t){return new e(t.getTime())}static fromMillis(t){return new e(t)}toDate(){return new Date(this._value)}equals(e){return this._value===e._value}},M=class e extends k{constructor(e){super(e)}static initial(){return new e(0)}static fromNumber(t){if(!Number.isInteger(t)||t<0)throw Error(`版本号必须是非负整数`);return new e(t)}increment(){return new e(this._value+1)}equals(e){return this._value===e._value}isInitial(){return this._value===0}};let N=function(e){return e.LOCAL=`local`,e.PENDING=`pending`,e.SYNCED=`synced`,e.CONFLICT=`conflict`,e}({});var P=class e extends k{constructor(e){super(e)}static local(){return new e(N.LOCAL)}static pending(){return new e(N.PENDING)}static synced(){return new e(N.SYNCED)}static conflict(){return new e(N.CONFLICT)}static fromString(t){switch(t){case`local`:return e.local();case`pending`:return e.pending();case`synced`:return e.synced();case`conflict`:return e.conflict();default:throw Error(`未知的同步状态: ${t}`)}}needsSync(){return this._value===N.LOCAL||this._value===N.PENDING}equals(e){return this._value===e._value}},F=class{isSuccess=!0;isFailure=!1;constructor(e){this.value=e}map(e){return L(e(this.value))}flatMap(e){return e(this.value)}mapError(e){return L(this.value)}getOrElse(e){return this.value}match(e){return e.success(this.value)}},I=class{isSuccess=!1;isFailure=!0;constructor(e){this.error=e}map(e){return R(this.error)}flatMap(e){return R(this.error)}mapError(e){return R(e(this.error))}getOrElse(e){return e}match(e){return e.failure(this.error)}};function L(e){return new F(e)}function R(e){return new I(e)}function z(e){let t=[];for(let n of e){if(n.isFailure)return R(n.error);t.push(n.value)}return L(t)}function B(e){return e.isSuccess}function V(e){return e.isFailure}function H(e){if(e.isFailure)throw g(e.error);return e.value}const U=e.z.string().uuid(`无效的UUID格式`),W=U,G=e.z.number().int().positive(),K=e.z.number().int().nonnegative(),q=e.z.enum([`create`,`update`,`delete`]),J=e.z.enum([`local-wins`,`remote-wins`,`merge`,`manual`]),Y=e.z.object({id:e.z.string(),type:e.z.string()}),X=e.z.object({start:e.z.coerce.date(),end:e.z.coerce.date()}),Z=e.z.object({id:e.z.string(),type:e.z.string(),version:K,data:e.z.record(e.z.string(),e.z.unknown()),timestamp:G}),Q=e.z.object({entityId:e.z.string(),entityType:e.z.string(),changeType:q,data:e.z.record(e.z.string(),e.z.unknown()).optional(),timestamp:G,version:K}),$=e.z.object({id:e.z.string(),entityType:e.z.string(),entityId:e.z.string(),localVersion:K,remoteVersion:K,localData:e.z.record(e.z.string(),e.z.unknown()),remoteData:e.z.record(e.z.string(),e.z.unknown()),conflictedAt:G}),ee=e.z.object({conflictId:e.z.string(),strategy:J,resolvedData:e.z.record(e.z.string(),e.z.unknown()),resolvedAt:G});exports.AggregateRoot=n,exports.AggregateRootEntity=n,exports.BusinessRuleError=l,exports.ChangeTypeSchema=q,exports.ConcurrencyError=f,exports.ConfigurationError=m,exports.ConflictDataSchema=$,exports.ConflictResolutionSchema=ee,exports.ConflictResolutionStrategySchema=J,exports.DomainError=s,exports.DomainEvent=r,exports.Entity=t,exports.EntityChangeSchema=Q,exports.EntityCreatedEvent=i,exports.EntityDeletedEvent=o,exports.EntityIdSchema=W,exports.EntityIdVO=A,exports.EntityNotFoundError=u,exports.EntityUpdatedEvent=a,exports.ExternalServiceError=h,exports.Failure=I,exports.IdReferenceSchema=Y,exports.PermissionDeniedError=p,exports.RepositoryError=d,exports.Success=F,exports.SyncDataSchema=Z,exports.SyncStatus=N,exports.SyncStatusVO=P,exports.TimeRangeSchema=X,exports.TimestampSchema=G,exports.TimestampVO=j,exports.UNIT_OF_WORK_TOKEN=O,exports.UuidSchema=U,exports.ValidationError=c,exports.ValueObject=k,exports.VersionSchema=K,exports.VersionVO=M,exports.combine=z,exports.failure=R,exports.isBusinessRuleError=x,exports.isClientError=y,exports.isConcurrencyError=w,exports.isConfigurationError=E,exports.isEntityNotFoundError=S,exports.isExternalServiceError=D,exports.isFailure=V,exports.isPermissionDeniedError=T,exports.isRepositoryError=C,exports.isRetryableError=v,exports.isSuccess=B,exports.isValidationError=b,exports.logError=_,exports.success=L,exports.toDomainError=g,exports.unwrapResult=H;

package/dist/index.d.cts

@@ -0,0 +1,410 @@
+import { z } from "zod";
+
+//#region src/domain/events/domain-event.types.d.ts
+type Event = {
+  readonly eventId: string;
+  readonly occurredAt: Date;
+  readonly type: string;
+};
+type TraceContext = {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+};
+type DomainEvent$1 = Event & {
+  readonly traceContext?: TraceContext;
+};
+//#endregion
+//#region src/domain/events/domain-event.base.d.ts
+declare abstract class DomainEvent implements DomainEvent$1 {
+  static readonly TYPE: string;
+  readonly eventId: string;
+  readonly occurredAt: Date;
+  abstract readonly type: string;
+  readonly traceContext?: TraceContext;
+  constructor(eventId: string, traceContext?: TraceContext);
+  toJSON(): Record<string, unknown>;
+}
+//#endregion
+//#region src/domain/events/entity.events.d.ts
+declare class EntityCreatedEvent extends DomainEvent {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly type = "entity:created";
+  constructor(eventId: string, entityType: string, entityId: string);
+  toJSON(): Record<string, unknown>;
+}
+declare class EntityUpdatedEvent extends DomainEvent {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly changes: Record<string, unknown>;
+  readonly type = "entity:updated";
+  constructor(eventId: string, entityType: string, entityId: string, changes: Record<string, unknown>);
+  toJSON(): Record<string, unknown>;
+}
+declare class EntityDeletedEvent extends DomainEvent {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly type = "entity:deleted";
+  constructor(eventId: string, entityType: string, entityId: string);
+  toJSON(): Record<string, unknown>;
+}
+//#endregion
+//#region src/domain/events/event-bus.types.d.ts
+type DomainEventHandler<T extends DomainEvent$1> = (event: T) => Promise<void> | void;
+type DomainEventConstructor<T extends DomainEvent$1> = {
+  readonly TYPE: string;
+  new (...args: unknown[]): T;
+};
+type EventConstructor<T extends DomainEvent$1> = DomainEventConstructor<T>;
+//#endregion
+//#region src/domain/entities/entity.base.d.ts
+declare abstract class Entity<T> {
+  protected readonly _id: string;
+  protected _props: T;
+  private _events;
+  constructor(id: string, props: T);
+  get id(): string;
+  get props(): Readonly<T>;
+  protected updateProps<K extends keyof T>(key: K, value: T[K]): void;
+  protected addEvent(event: DomainEvent): void;
+  pullEvents(): DomainEvent[];
+  hasEvents(): boolean;
+  equals(other: Entity<T>): boolean;
+}
+//#endregion
+//#region src/domain/entities/aggregate-root.entity.d.ts
+declare abstract class AggregateRootEntity<T> extends Entity<T> {
+  protected _version: number;
+  protected _isDirty: boolean;
+  get version(): number;
+  get isDirty(): boolean;
+  protected markAsDirty(): void;
+}
+//#endregion
+//#region src/domain/tracing/tracing-context.types.d.ts
+type TracingContextManager = {
+  getCurrentContext(): TraceContext | undefined;
+  getCurrentTraceId(): string | undefined;
+  getCurrentSpanId(): string | undefined;
+  createNewContext(): TraceContext;
+  createChildContext(parentContext: TraceContext): TraceContext;
+  runWithContext<T>(context: TraceContext, fn: () => T): T;
+  runWithNewTrace<T>(fn: () => T): T;
+  runWithChildSpan<T>(fn: () => T): T;
+};
+//#endregion
+//#region src/domain/exception/domain-exception.errors.d.ts
+declare abstract class DomainError extends Error {
+  readonly code: string;
+  readonly context?: Record<string, unknown> | undefined;
+  constructor(message: string, code?: string, context?: Record<string, unknown> | undefined);
+  toJSON(): object;
+}
+declare class ValidationError extends DomainError {
+  readonly field?: string | undefined;
+  readonly value?: unknown | undefined;
+  constructor(message: string, field?: string | undefined, value?: unknown | undefined);
+}
+declare class BusinessRuleError extends DomainError {
+  constructor(message: string, rule?: string);
+}
+declare class EntityNotFoundError extends DomainError {
+  readonly entityType: string;
+  readonly entityId: string;
+  constructor(entityType: string, entityId: string);
+}
+declare class RepositoryError extends DomainError {
+  readonly cause?: Error | undefined;
+  constructor(message: string, cause?: Error | undefined, context?: Record<string, unknown>);
+  toJSON(): object;
+}
+declare class ConcurrencyError extends DomainError {
+  constructor(message?: string);
+}
+declare class PermissionDeniedError extends DomainError {
+  readonly resource: string;
+  readonly action: string;
+  constructor(resource: string, action: string);
+}
+declare class ConfigurationError extends DomainError {
+  readonly key?: string | undefined;
+  constructor(message: string, key?: string | undefined);
+}
+declare class ExternalServiceError extends DomainError {
+  readonly service: string;
+  constructor(service: string, message: string, cause?: Error);
+}
+//#endregion
+//#region ../logger/core/dist/index.d.mts
+//#endregion
+//#region src/tracing/context.types.d.ts
+type TraceContext$1 = {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+};
+//#endregion
+//#region src/log/logger.types.d.ts
+type Logger = {
+  debug(message: string, metadata?: Record<string, unknown>): void;
+  info(message: string, metadata?: Record<string, unknown>): void;
+  warn(message: string, metadata?: Record<string, unknown>): void;
+  error(message: string, error?: Error, metadata?: Record<string, unknown>): void;
+  withOperation(operation: string): Logger;
+  withTrace(trace: TraceContext$1): Logger;
+};
+//#endregion
+//#region src/domain/exception/error-utils.d.ts
+declare function toDomainError(error: unknown): DomainError;
+declare function logError(error: DomainError, logger: Logger, operation?: string): void;
+declare function isRetryableError(error: DomainError): boolean;
+declare function isClientError(error: DomainError): boolean;
+declare function isValidationError(error: DomainError): error is ValidationError;
+declare function isBusinessRuleError(error: DomainError): error is BusinessRuleError;
+declare function isEntityNotFoundError(error: DomainError): error is EntityNotFoundError;
+declare function isRepositoryError(error: DomainError): error is RepositoryError;
+declare function isConcurrencyError(error: DomainError): error is ConcurrencyError;
+declare function isPermissionDeniedError(error: DomainError): error is PermissionDeniedError;
+declare function isConfigurationError(error: DomainError): error is ConfigurationError;
+declare function isExternalServiceError(error: DomainError): error is ExternalServiceError;
+//#endregion
+//#region src/domain/repositories/repository.types.d.ts
+type PaginationParams = {
+  page: number;
+  pageSize: number;
+};
+type SortParams = {
+  field: string;
+  direction: 'asc' | 'desc';
+};
+type QueryOptions = {
+  pagination?: PaginationParams;
+  sort?: SortParams[];
+  includeDeleted?: boolean;
+};
+type Repository<T extends Entity<unknown>> = {
+  findById(id: string): Promise<T | null>;
+  findAll(): Promise<T[]>;
+  save(entity: T): Promise<void>;
+  saveAll(entities: T[]): Promise<void>;
+  delete(id: string): Promise<void>;
+  exists(id: string): Promise<boolean>;
+};
+//#endregion
+//#region src/domain/result/result.types.d.ts
+type MapFunction<T, U> = (value: T) => U;
+type FlatMapFunction<T, U, E> = (value: T) => Result<U, E>;
+type ErrorMapFunction<E, F> = (error: E) => F;
+type MatchHandlers<T, E, U> = {
+  success: (value: T) => U;
+  failure: (error: E) => U;
+};
+type Result<T, E = DomainError> = Success<T, E> | Failure<T, E>;
+declare class Success<T, E = DomainError> {
+  readonly value: T;
+  readonly isSuccess: true;
+  readonly isFailure: false;
+  constructor(value: T);
+  map<U>(fn: MapFunction<T, U>): Result<U, E>;
+  flatMap<U>(fn: FlatMapFunction<T, U, E>): Result<U, E>;
+  mapError<F>(_fn: ErrorMapFunction<E, F>): Result<T, F>;
+  getOrElse(_defaultValue: T): T;
+  match<U>(handlers: MatchHandlers<T, E, U>): U;
+}
+declare class Failure<T, E = DomainError> {
+  readonly error: E;
+  readonly isSuccess: false;
+  readonly isFailure: true;
+  constructor(error: E);
+  map<U>(_fn: MapFunction<T, U>): Result<U, E>;
+  flatMap<U>(_fn: FlatMapFunction<T, U, E>): Result<U, E>;
+  mapError<F>(fn: ErrorMapFunction<E, F>): Result<T, F>;
+  getOrElse(defaultValue: T): T;
+  match<U>(handlers: MatchHandlers<T, E, U>): U;
+}
+declare function success<T, E = DomainError>(value: T): Result<T, E>;
+declare function failure<T, E = DomainError>(error: E): Result<T, E>;
+declare function combine<T, E = DomainError>(results: Result<T, E>[]): Result<T[], E>;
+declare function isSuccess<T, E>(result: Result<T, E>): result is Success<T, E>;
+declare function isFailure<T, E>(result: Result<T, E>): result is Failure<T, E>;
+declare function unwrapResult<T, E = DomainError>(result: Result<T, E>): T;
+//#endregion
+//#region src/domain/repositories/unit-of-work.types.d.ts
+type UnitOfWork = {
+  start(): Promise<Result<void, DomainError>>;
+  commit(): Promise<Result<void, DomainError>>;
+  rollback(): Promise<Result<void, DomainError>>;
+  withTransaction<T>(work: () => Promise<Result<T, DomainError>>): Promise<Result<T, DomainError>>;
+};
+declare const UNIT_OF_WORK_TOKEN: unique symbol;
+//#endregion
+//#region src/domain/value-object/value-object.base.d.ts
+declare abstract class ValueObject<T> {
+  protected readonly _value: T;
+  constructor(value: T);
+  get value(): T;
+  valueOf(): T;
+  abstract equals(other: ValueObject<T>): boolean;
+  toString(): string;
+}
+//#endregion
+//#region src/domain/value-object/entity-id.vo.d.ts
+declare class EntityIdVO extends ValueObject<string> {
+  private constructor();
+  static fromString(value: string): EntityIdVO;
+  equals(other: EntityIdVO): boolean;
+}
+//#endregion
+//#region src/domain/value-object/timestamp.vo.d.ts
+declare class TimestampVO extends ValueObject<number> {
+  private constructor();
+  static now(): TimestampVO;
+  static fromDate(date: Date): TimestampVO;
+  static fromMillis(millis: number): TimestampVO;
+  toDate(): Date;
+  equals(other: TimestampVO): boolean;
+}
+//#endregion
+//#region src/domain/value-object/version.vo.d.ts
+declare class VersionVO extends ValueObject<number> {
+  private constructor();
+  static initial(): VersionVO;
+  static fromNumber(value: number): VersionVO;
+  increment(): VersionVO;
+  equals(other: VersionVO): boolean;
+  isInitial(): boolean;
+}
+//#endregion
+//#region src/domain/value-object/sync-status.vo.d.ts
+declare enum SyncStatus {
+  LOCAL = "local",
+  PENDING = "pending",
+  SYNCED = "synced",
+  CONFLICT = "conflict"
+}
+declare class SyncStatusVO extends ValueObject<SyncStatus> {
+  private constructor();
+  static local(): SyncStatusVO;
+  static pending(): SyncStatusVO;
+  static synced(): SyncStatusVO;
+  static conflict(): SyncStatusVO;
+  static fromString(value: string): SyncStatusVO;
+  needsSync(): boolean;
+  equals(other: SyncStatusVO): boolean;
+}
+//#endregion
+//#region src/domain/types/types.d.ts
+type SyncData = {
+  id: string;
+  type: string;
+  version: number;
+  data: Record<string, unknown>;
+  timestamp: number;
+};
+type EntityChange = {
+  entityId: string;
+  entityType: string;
+  changeType: 'create' | 'update' | 'delete';
+  data?: Record<string, unknown>;
+  timestamp: number;
+  version: number;
+};
+type ConflictData = {
+  id: string;
+  entityType: string;
+  entityId: string;
+  localVersion: number;
+  remoteVersion: number;
+  localData: Record<string, unknown>;
+  remoteData: Record<string, unknown>;
+  conflictedAt: number;
+};
+type ConflictResolutionStrategy = 'local-wins' | 'remote-wins' | 'merge' | 'manual';
+type ConflictResolution = {
+  conflictId: string;
+  strategy: ConflictResolutionStrategy;
+  resolvedData: Record<string, unknown>;
+  resolvedAt: number;
+};
+type TimeRange = {
+  start: Date;
+  end: Date;
+};
+type Reference = {
+  id: string;
+  type: string;
+};
+//#endregion
+//#region src/domain/schemas/common.schema.d.ts
+declare const UuidSchema: z.ZodString;
+declare const EntityIdSchema: z.ZodString;
+declare const TimestampSchema: z.ZodNumber;
+declare const VersionSchema: z.ZodNumber;
+declare const ChangeTypeSchema: z.ZodEnum<{
+  create: "create";
+  update: "update";
+  delete: "delete";
+}>;
+declare const ConflictResolutionStrategySchema: z.ZodEnum<{
+  "local-wins": "local-wins";
+  "remote-wins": "remote-wins";
+  merge: "merge";
+  manual: "manual";
+}>;
+declare const IdReferenceSchema: z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodString;
+}, z.core.$strip>;
+declare const TimeRangeSchema: z.ZodObject<{
+  start: z.ZodCoercedDate<unknown>;
+  end: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;
+declare const SyncDataSchema: z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodString;
+  version: z.ZodNumber;
+  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  timestamp: z.ZodNumber;
+}, z.core.$strip>;
+declare const EntityChangeSchema: z.ZodObject<{
+  entityId: z.ZodString;
+  entityType: z.ZodString;
+  changeType: z.ZodEnum<{
+    create: "create";
+    update: "update";
+    delete: "delete";
+  }>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  timestamp: z.ZodNumber;
+  version: z.ZodNumber;
+}, z.core.$strip>;
+declare const ConflictDataSchema: z.ZodObject<{
+  id: z.ZodString;
+  entityType: z.ZodString;
+  entityId: z.ZodString;
+  localVersion: z.ZodNumber;
+  remoteVersion: z.ZodNumber;
+  localData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  remoteData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  conflictedAt: z.ZodNumber;
+}, z.core.$strip>;
+declare const ConflictResolutionSchema: z.ZodObject<{
+  conflictId: z.ZodString;
+  strategy: z.ZodEnum<{
+    "local-wins": "local-wins";
+    "remote-wins": "remote-wins";
+    merge: "merge";
+    manual: "manual";
+  }>;
+  resolvedData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  resolvedAt: z.ZodNumber;
+}, z.core.$strip>;
+type Uuid = z.infer<typeof UuidSchema>;
+type EntityId = z.infer<typeof EntityIdSchema>;
+type Timestamp = z.infer<typeof TimestampSchema>;
+type Version = z.infer<typeof VersionSchema>;
+type ChangeType = z.infer<typeof ChangeTypeSchema>;
+type IdReference = z.infer<typeof IdReferenceSchema>;
+//#endregion
+export { AggregateRootEntity as AggregateRoot, AggregateRootEntity, BusinessRuleError, type ChangeType, ChangeTypeSchema, ConcurrencyError, ConfigurationError, type ConflictData, ConflictDataSchema, type ConflictResolution, ConflictResolutionSchema, type ConflictResolutionStrategy, ConflictResolutionStrategySchema, DomainError, DomainEvent, type DomainEventConstructor, type DomainEventHandler, Entity, type EntityChange, EntityChangeSchema, EntityCreatedEvent, EntityDeletedEvent, type EntityId, EntityIdSchema, EntityIdVO, EntityNotFoundError, EntityUpdatedEvent, type EventConstructor, ExternalServiceError, Failure, type IdReference, IdReferenceSchema, PermissionDeniedError, type QueryOptions, type Reference, type Repository, RepositoryError, type Result, type SortParams, Success, type SyncData, SyncDataSchema, SyncStatus, SyncStatusVO, type TimeRange, TimeRangeSchema, type Timestamp, TimestampSchema, TimestampVO, type TraceContext, type TracingContextManager, UNIT_OF_WORK_TOKEN, type UnitOfWork, type Uuid, UuidSchema, ValidationError, ValueObject, type Version, VersionSchema, VersionVO, combine, failure, isBusinessRuleError, isClientError, isConcurrencyError, isConfigurationError, isEntityNotFoundError, isExternalServiceError, isFailure, isPermissionDeniedError, isRepositoryError, isRetryableError, isSuccess, isValidationError, logError, success, toDomainError, unwrapResult };

package/dist/index.d.mts

@@ -0,0 +1,410 @@
+import { z } from "zod";
+
+//#region src/domain/events/domain-event.types.d.ts
+type Event = {
+  readonly eventId: string;
+  readonly occurredAt: Date;
+  readonly type: string;
+};
+type TraceContext = {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+};
+type DomainEvent$1 = Event & {
+  readonly traceContext?: TraceContext;
+};
+//#endregion
+//#region src/domain/events/domain-event.base.d.ts
+declare abstract class DomainEvent implements DomainEvent$1 {
+  static readonly TYPE: string;
+  readonly eventId: string;
+  readonly occurredAt: Date;
+  abstract readonly type: string;
+  readonly traceContext?: TraceContext;
+  constructor(eventId: string, traceContext?: TraceContext);
+  toJSON(): Record<string, unknown>;
+}
+//#endregion
+//#region src/domain/events/entity.events.d.ts
+declare class EntityCreatedEvent extends DomainEvent {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly type = "entity:created";
+  constructor(eventId: string, entityType: string, entityId: string);
+  toJSON(): Record<string, unknown>;
+}
+declare class EntityUpdatedEvent extends DomainEvent {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly changes: Record<string, unknown>;
+  readonly type = "entity:updated";
+  constructor(eventId: string, entityType: string, entityId: string, changes: Record<string, unknown>);
+  toJSON(): Record<string, unknown>;
+}
+declare class EntityDeletedEvent extends DomainEvent {
+  readonly entityType: string;
+  readonly entityId: string;
+  readonly type = "entity:deleted";
+  constructor(eventId: string, entityType: string, entityId: string);
+  toJSON(): Record<string, unknown>;
+}
+//#endregion
+//#region src/domain/events/event-bus.types.d.ts
+type DomainEventHandler<T extends DomainEvent$1> = (event: T) => Promise<void> | void;
+type DomainEventConstructor<T extends DomainEvent$1> = {
+  readonly TYPE: string;
+  new (...args: unknown[]): T;
+};
+type EventConstructor<T extends DomainEvent$1> = DomainEventConstructor<T>;
+//#endregion
+//#region src/domain/entities/entity.base.d.ts
+declare abstract class Entity<T> {
+  protected readonly _id: string;
+  protected _props: T;
+  private _events;
+  constructor(id: string, props: T);
+  get id(): string;
+  get props(): Readonly<T>;
+  protected updateProps<K extends keyof T>(key: K, value: T[K]): void;
+  protected addEvent(event: DomainEvent): void;
+  pullEvents(): DomainEvent[];
+  hasEvents(): boolean;
+  equals(other: Entity<T>): boolean;
+}
+//#endregion
+//#region src/domain/entities/aggregate-root.entity.d.ts
+declare abstract class AggregateRootEntity<T> extends Entity<T> {
+  protected _version: number;
+  protected _isDirty: boolean;
+  get version(): number;
+  get isDirty(): boolean;
+  protected markAsDirty(): void;
+}
+//#endregion
+//#region src/domain/tracing/tracing-context.types.d.ts
+type TracingContextManager = {
+  getCurrentContext(): TraceContext | undefined;
+  getCurrentTraceId(): string | undefined;
+  getCurrentSpanId(): string | undefined;
+  createNewContext(): TraceContext;
+  createChildContext(parentContext: TraceContext): TraceContext;
+  runWithContext<T>(context: TraceContext, fn: () => T): T;
+  runWithNewTrace<T>(fn: () => T): T;
+  runWithChildSpan<T>(fn: () => T): T;
+};
+//#endregion
+//#region src/domain/exception/domain-exception.errors.d.ts
+declare abstract class DomainError extends Error {
+  readonly code: string;
+  readonly context?: Record<string, unknown> | undefined;
+  constructor(message: string, code?: string, context?: Record<string, unknown> | undefined);
+  toJSON(): object;
+}
+declare class ValidationError extends DomainError {
+  readonly field?: string | undefined;
+  readonly value?: unknown | undefined;
+  constructor(message: string, field?: string | undefined, value?: unknown | undefined);
+}
+declare class BusinessRuleError extends DomainError {
+  constructor(message: string, rule?: string);
+}
+declare class EntityNotFoundError extends DomainError {
+  readonly entityType: string;
+  readonly entityId: string;
+  constructor(entityType: string, entityId: string);
+}
+declare class RepositoryError extends DomainError {
+  readonly cause?: Error | undefined;
+  constructor(message: string, cause?: Error | undefined, context?: Record<string, unknown>);
+  toJSON(): object;
+}
+declare class ConcurrencyError extends DomainError {
+  constructor(message?: string);
+}
+declare class PermissionDeniedError extends DomainError {
+  readonly resource: string;
+  readonly action: string;
+  constructor(resource: string, action: string);
+}
+declare class ConfigurationError extends DomainError {
+  readonly key?: string | undefined;
+  constructor(message: string, key?: string | undefined);
+}
+declare class ExternalServiceError extends DomainError {
+  readonly service: string;
+  constructor(service: string, message: string, cause?: Error);
+}
+//#endregion
+//#region ../logger/core/dist/index.d.mts
+//#endregion
+//#region src/tracing/context.types.d.ts
+type TraceContext$1 = {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+};
+//#endregion
+//#region src/log/logger.types.d.ts
+type Logger = {
+  debug(message: string, metadata?: Record<string, unknown>): void;
+  info(message: string, metadata?: Record<string, unknown>): void;
+  warn(message: string, metadata?: Record<string, unknown>): void;
+  error(message: string, error?: Error, metadata?: Record<string, unknown>): void;
+  withOperation(operation: string): Logger;
+  withTrace(trace: TraceContext$1): Logger;
+};
+//#endregion
+//#region src/domain/exception/error-utils.d.ts
+declare function toDomainError(error: unknown): DomainError;
+declare function logError(error: DomainError, logger: Logger, operation?: string): void;
+declare function isRetryableError(error: DomainError): boolean;
+declare function isClientError(error: DomainError): boolean;
+declare function isValidationError(error: DomainError): error is ValidationError;
+declare function isBusinessRuleError(error: DomainError): error is BusinessRuleError;
+declare function isEntityNotFoundError(error: DomainError): error is EntityNotFoundError;
+declare function isRepositoryError(error: DomainError): error is RepositoryError;
+declare function isConcurrencyError(error: DomainError): error is ConcurrencyError;
+declare function isPermissionDeniedError(error: DomainError): error is PermissionDeniedError;
+declare function isConfigurationError(error: DomainError): error is ConfigurationError;
+declare function isExternalServiceError(error: DomainError): error is ExternalServiceError;
+//#endregion
+//#region src/domain/repositories/repository.types.d.ts
+type PaginationParams = {
+  page: number;
+  pageSize: number;
+};
+type SortParams = {
+  field: string;
+  direction: 'asc' | 'desc';
+};
+type QueryOptions = {
+  pagination?: PaginationParams;
+  sort?: SortParams[];
+  includeDeleted?: boolean;
+};
+type Repository<T extends Entity<unknown>> = {
+  findById(id: string): Promise<T | null>;
+  findAll(): Promise<T[]>;
+  save(entity: T): Promise<void>;
+  saveAll(entities: T[]): Promise<void>;
+  delete(id: string): Promise<void>;
+  exists(id: string): Promise<boolean>;
+};
+//#endregion
+//#region src/domain/result/result.types.d.ts
+type MapFunction<T, U> = (value: T) => U;
+type FlatMapFunction<T, U, E> = (value: T) => Result<U, E>;
+type ErrorMapFunction<E, F> = (error: E) => F;
+type MatchHandlers<T, E, U> = {
+  success: (value: T) => U;
+  failure: (error: E) => U;
+};
+type Result<T, E = DomainError> = Success<T, E> | Failure<T, E>;
+declare class Success<T, E = DomainError> {
+  readonly value: T;
+  readonly isSuccess: true;
+  readonly isFailure: false;
+  constructor(value: T);
+  map<U>(fn: MapFunction<T, U>): Result<U, E>;
+  flatMap<U>(fn: FlatMapFunction<T, U, E>): Result<U, E>;
+  mapError<F>(_fn: ErrorMapFunction<E, F>): Result<T, F>;
+  getOrElse(_defaultValue: T): T;
+  match<U>(handlers: MatchHandlers<T, E, U>): U;
+}
+declare class Failure<T, E = DomainError> {
+  readonly error: E;
+  readonly isSuccess: false;
+  readonly isFailure: true;
+  constructor(error: E);
+  map<U>(_fn: MapFunction<T, U>): Result<U, E>;
+  flatMap<U>(_fn: FlatMapFunction<T, U, E>): Result<U, E>;
+  mapError<F>(fn: ErrorMapFunction<E, F>): Result<T, F>;
+  getOrElse(defaultValue: T): T;
+  match<U>(handlers: MatchHandlers<T, E, U>): U;
+}
+declare function success<T, E = DomainError>(value: T): Result<T, E>;
+declare function failure<T, E = DomainError>(error: E): Result<T, E>;
+declare function combine<T, E = DomainError>(results: Result<T, E>[]): Result<T[], E>;
+declare function isSuccess<T, E>(result: Result<T, E>): result is Success<T, E>;
+declare function isFailure<T, E>(result: Result<T, E>): result is Failure<T, E>;
+declare function unwrapResult<T, E = DomainError>(result: Result<T, E>): T;
+//#endregion
+//#region src/domain/repositories/unit-of-work.types.d.ts
+type UnitOfWork = {
+  start(): Promise<Result<void, DomainError>>;
+  commit(): Promise<Result<void, DomainError>>;
+  rollback(): Promise<Result<void, DomainError>>;
+  withTransaction<T>(work: () => Promise<Result<T, DomainError>>): Promise<Result<T, DomainError>>;
+};
+declare const UNIT_OF_WORK_TOKEN: unique symbol;
+//#endregion
+//#region src/domain/value-object/value-object.base.d.ts
+declare abstract class ValueObject<T> {
+  protected readonly _value: T;
+  constructor(value: T);
+  get value(): T;
+  valueOf(): T;
+  abstract equals(other: ValueObject<T>): boolean;
+  toString(): string;
+}
+//#endregion
+//#region src/domain/value-object/entity-id.vo.d.ts
+declare class EntityIdVO extends ValueObject<string> {
+  private constructor();
+  static fromString(value: string): EntityIdVO;
+  equals(other: EntityIdVO): boolean;
+}
+//#endregion
+//#region src/domain/value-object/timestamp.vo.d.ts
+declare class TimestampVO extends ValueObject<number> {
+  private constructor();
+  static now(): TimestampVO;
+  static fromDate(date: Date): TimestampVO;
+  static fromMillis(millis: number): TimestampVO;
+  toDate(): Date;
+  equals(other: TimestampVO): boolean;
+}
+//#endregion
+//#region src/domain/value-object/version.vo.d.ts
+declare class VersionVO extends ValueObject<number> {
+  private constructor();
+  static initial(): VersionVO;
+  static fromNumber(value: number): VersionVO;
+  increment(): VersionVO;
+  equals(other: VersionVO): boolean;
+  isInitial(): boolean;
+}
+//#endregion
+//#region src/domain/value-object/sync-status.vo.d.ts
+declare enum SyncStatus {
+  LOCAL = "local",
+  PENDING = "pending",
+  SYNCED = "synced",
+  CONFLICT = "conflict"
+}
+declare class SyncStatusVO extends ValueObject<SyncStatus> {
+  private constructor();
+  static local(): SyncStatusVO;
+  static pending(): SyncStatusVO;
+  static synced(): SyncStatusVO;
+  static conflict(): SyncStatusVO;
+  static fromString(value: string): SyncStatusVO;
+  needsSync(): boolean;
+  equals(other: SyncStatusVO): boolean;
+}
+//#endregion
+//#region src/domain/types/types.d.ts
+type SyncData = {
+  id: string;
+  type: string;
+  version: number;
+  data: Record<string, unknown>;
+  timestamp: number;
+};
+type EntityChange = {
+  entityId: string;
+  entityType: string;
+  changeType: 'create' | 'update' | 'delete';
+  data?: Record<string, unknown>;
+  timestamp: number;
+  version: number;
+};
+type ConflictData = {
+  id: string;
+  entityType: string;
+  entityId: string;
+  localVersion: number;
+  remoteVersion: number;
+  localData: Record<string, unknown>;
+  remoteData: Record<string, unknown>;
+  conflictedAt: number;
+};
+type ConflictResolutionStrategy = 'local-wins' | 'remote-wins' | 'merge' | 'manual';
+type ConflictResolution = {
+  conflictId: string;
+  strategy: ConflictResolutionStrategy;
+  resolvedData: Record<string, unknown>;
+  resolvedAt: number;
+};
+type TimeRange = {
+  start: Date;
+  end: Date;
+};
+type Reference = {
+  id: string;
+  type: string;
+};
+//#endregion
+//#region src/domain/schemas/common.schema.d.ts
+declare const UuidSchema: z.ZodString;
+declare const EntityIdSchema: z.ZodString;
+declare const TimestampSchema: z.ZodNumber;
+declare const VersionSchema: z.ZodNumber;
+declare const ChangeTypeSchema: z.ZodEnum<{
+  create: "create";
+  update: "update";
+  delete: "delete";
+}>;
+declare const ConflictResolutionStrategySchema: z.ZodEnum<{
+  "local-wins": "local-wins";
+  "remote-wins": "remote-wins";
+  merge: "merge";
+  manual: "manual";
+}>;
+declare const IdReferenceSchema: z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodString;
+}, z.core.$strip>;
+declare const TimeRangeSchema: z.ZodObject<{
+  start: z.ZodCoercedDate<unknown>;
+  end: z.ZodCoercedDate<unknown>;
+}, z.core.$strip>;
+declare const SyncDataSchema: z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodString;
+  version: z.ZodNumber;
+  data: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  timestamp: z.ZodNumber;
+}, z.core.$strip>;
+declare const EntityChangeSchema: z.ZodObject<{
+  entityId: z.ZodString;
+  entityType: z.ZodString;
+  changeType: z.ZodEnum<{
+    create: "create";
+    update: "update";
+    delete: "delete";
+  }>;
+  data: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  timestamp: z.ZodNumber;
+  version: z.ZodNumber;
+}, z.core.$strip>;
+declare const ConflictDataSchema: z.ZodObject<{
+  id: z.ZodString;
+  entityType: z.ZodString;
+  entityId: z.ZodString;
+  localVersion: z.ZodNumber;
+  remoteVersion: z.ZodNumber;
+  localData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  remoteData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  conflictedAt: z.ZodNumber;
+}, z.core.$strip>;
+declare const ConflictResolutionSchema: z.ZodObject<{
+  conflictId: z.ZodString;
+  strategy: z.ZodEnum<{
+    "local-wins": "local-wins";
+    "remote-wins": "remote-wins";
+    merge: "merge";
+    manual: "manual";
+  }>;
+  resolvedData: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+  resolvedAt: z.ZodNumber;
+}, z.core.$strip>;
+type Uuid = z.infer<typeof UuidSchema>;
+type EntityId = z.infer<typeof EntityIdSchema>;
+type Timestamp = z.infer<typeof TimestampSchema>;
+type Version = z.infer<typeof VersionSchema>;
+type ChangeType = z.infer<typeof ChangeTypeSchema>;
+type IdReference = z.infer<typeof IdReferenceSchema>;
+//#endregion
+export { AggregateRootEntity as AggregateRoot, AggregateRootEntity, BusinessRuleError, type ChangeType, ChangeTypeSchema, ConcurrencyError, ConfigurationError, type ConflictData, ConflictDataSchema, type ConflictResolution, ConflictResolutionSchema, type ConflictResolutionStrategy, ConflictResolutionStrategySchema, DomainError, DomainEvent, type DomainEventConstructor, type DomainEventHandler, Entity, type EntityChange, EntityChangeSchema, EntityCreatedEvent, EntityDeletedEvent, type EntityId, EntityIdSchema, EntityIdVO, EntityNotFoundError, EntityUpdatedEvent, type EventConstructor, ExternalServiceError, Failure, type IdReference, IdReferenceSchema, PermissionDeniedError, type QueryOptions, type Reference, type Repository, RepositoryError, type Result, type SortParams, Success, type SyncData, SyncDataSchema, SyncStatus, SyncStatusVO, type TimeRange, TimeRangeSchema, type Timestamp, TimestampSchema, TimestampVO, type TraceContext, type TracingContextManager, UNIT_OF_WORK_TOKEN, type UnitOfWork, type Uuid, UuidSchema, ValidationError, ValueObject, type Version, VersionSchema, VersionVO, combine, failure, isBusinessRuleError, isClientError, isConcurrencyError, isConfigurationError, isEntityNotFoundError, isExternalServiceError, isFailure, isPermissionDeniedError, isRepositoryError, isRetryableError, isSuccess, isValidationError, logError, success, toDomainError, unwrapResult };

package/dist/index.mjs

@@ -0,0 +1 @@
+import{z as e}from"zod";var t=class{_id;_props;_events=[];constructor(e,t){this._id=e,this._props=t}get id(){return this._id}get props(){return this._props}updateProps(e,t){this._props[e]=t}addEvent(e){this._events.push(e)}pullEvents(){let e=[...this._events];return this._events=[],e}hasEvents(){return this._events.length>0}equals(e){return this._id===e._id}},n=class extends t{_version=1;_isDirty=!1;get version(){return this._version}get isDirty(){return this._isDirty}markAsDirty(){this._isDirty=!0,this._version++}},r=class{static TYPE;eventId;occurredAt;traceContext;constructor(e,t){this.eventId=e,this.occurredAt=new Date,this.traceContext=t}toJSON(){return{eventId:this.eventId,type:this.type,occurredAt:this.occurredAt.toISOString(),traceContext:this.traceContext}}},i=class extends r{type=`entity:created`;constructor(e,t,n){super(e),this.entityType=t,this.entityId=n}toJSON(){return{...super.toJSON(),entityType:this.entityType,entityId:this.entityId}}},a=class extends r{type=`entity:updated`;constructor(e,t,n,r){super(e),this.entityType=t,this.entityId=n,this.changes=r}toJSON(){return{...super.toJSON(),entityType:this.entityType,entityId:this.entityId,changes:this.changes}}},o=class extends r{type=`entity:deleted`;constructor(e,t,n){super(e),this.entityType=t,this.entityId=n}toJSON(){return{...super.toJSON(),entityType:this.entityType,entityId:this.entityId}}},s=class extends Error{constructor(e,t=`DOMAIN_ERROR`,n){super(e),this.code=t,this.context=n,this.name=`DomainError`}toJSON(){return{name:this.name,code:this.code,message:this.message,context:this.context,stack:this.stack}}},c=class extends s{constructor(e,t,n){super(e,`VALIDATION_ERROR`,{field:t,value:n}),this.field=t,this.value=n,this.name=`ValidationError`}},l=class extends s{constructor(e,t){super(e,`BUSINESS_RULE_ERROR`,{rule:t}),this.name=`BusinessRuleError`}},u=class extends s{constructor(e,t){super(`${e} 未找到: ${t}`,`ENTITY_NOT_FOUND`,{entityType:e,entityId:t}),this.entityType=e,this.entityId=t,this.name=`EntityNotFoundError`}},d=class extends s{constructor(e,t,n){super(e,`REPOSITORY_ERROR`,n),this.cause=t,this.name=`RepositoryError`}toJSON(){return{...super.toJSON(),cause:this.cause?.message}}},f=class extends s{constructor(e=`并发冲突，请重试`){super(e,`CONCURRENCY_ERROR`),this.name=`ConcurrencyError`}},p=class extends s{constructor(e,t){super(`无权限执行操作: ${t} on ${e}`,`PERMISSION_DENIED`,{resource:e,action:t}),this.resource=e,this.action=t,this.name=`PermissionDeniedError`}},m=class extends s{constructor(e,t){super(e,`CONFIGURATION_ERROR`,{key:t}),this.key=t,this.name=`ConfigurationError`}},h=class extends s{constructor(e,t,n){super(t,`EXTERNAL_SERVICE_ERROR`,{service:e}),this.service=e,this.name=`ExternalServiceError`,n&&(this.cause=n)}};function g(e){return e instanceof s?e:e instanceof Error?new d(e.message,e):new d(String(e))}function _(e,t,n){(n?t.withOperation(n):t).error(e.message,e,{code:e.code,name:e.name,context:e.context})}function v(e){return[`CONCURRENCY_ERROR`,`EXTERNAL_SERVICE_ERROR`].includes(e.code)}function y(e){return[`VALIDATION_ERROR`,`BUSINESS_RULE_ERROR`,`ENTITY_NOT_FOUND`,`PERMISSION_DENIED`].includes(e.code)}function b(e){return e instanceof c}function x(e){return e instanceof l}function S(e){return e instanceof u}function C(e){return e instanceof d}function w(e){return e instanceof f}function T(e){return e instanceof p}function E(e){return e instanceof m}function D(e){return e instanceof h}const O=Symbol(`UnitOfWork`);var k=class{_value;constructor(e){this._value=Object.freeze(e)}get value(){return this._value}valueOf(){return this._value}toString(){return String(this._value)}},A=class e extends k{constructor(e){super(e)}static fromString(t){if(!t||t.trim().length===0)throw Error(`实体 ID 不能为空`);return new e(t)}equals(e){return this._value===e._value}},j=class e extends k{constructor(e){super(e)}static now(){return new e(Date.now())}static fromDate(t){return new e(t.getTime())}static fromMillis(t){return new e(t)}toDate(){return new Date(this._value)}equals(e){return this._value===e._value}},M=class e extends k{constructor(e){super(e)}static initial(){return new e(0)}static fromNumber(t){if(!Number.isInteger(t)||t<0)throw Error(`版本号必须是非负整数`);return new e(t)}increment(){return new e(this._value+1)}equals(e){return this._value===e._value}isInitial(){return this._value===0}};let N=function(e){return e.LOCAL=`local`,e.PENDING=`pending`,e.SYNCED=`synced`,e.CONFLICT=`conflict`,e}({});var P=class e extends k{constructor(e){super(e)}static local(){return new e(N.LOCAL)}static pending(){return new e(N.PENDING)}static synced(){return new e(N.SYNCED)}static conflict(){return new e(N.CONFLICT)}static fromString(t){switch(t){case`local`:return e.local();case`pending`:return e.pending();case`synced`:return e.synced();case`conflict`:return e.conflict();default:throw Error(`未知的同步状态: ${t}`)}}needsSync(){return this._value===N.LOCAL||this._value===N.PENDING}equals(e){return this._value===e._value}},F=class{isSuccess=!0;isFailure=!1;constructor(e){this.value=e}map(e){return L(e(this.value))}flatMap(e){return e(this.value)}mapError(e){return L(this.value)}getOrElse(e){return this.value}match(e){return e.success(this.value)}},I=class{isSuccess=!1;isFailure=!0;constructor(e){this.error=e}map(e){return R(this.error)}flatMap(e){return R(this.error)}mapError(e){return R(e(this.error))}getOrElse(e){return e}match(e){return e.failure(this.error)}};function L(e){return new F(e)}function R(e){return new I(e)}function z(e){let t=[];for(let n of e){if(n.isFailure)return R(n.error);t.push(n.value)}return L(t)}function B(e){return e.isSuccess}function V(e){return e.isFailure}function H(e){if(e.isFailure)throw g(e.error);return e.value}const U=e.string().uuid(`无效的UUID格式`),W=U,G=e.number().int().positive(),K=e.number().int().nonnegative(),q=e.enum([`create`,`update`,`delete`]),J=e.enum([`local-wins`,`remote-wins`,`merge`,`manual`]),Y=e.object({id:e.string(),type:e.string()}),X=e.object({start:e.coerce.date(),end:e.coerce.date()}),Z=e.object({id:e.string(),type:e.string(),version:K,data:e.record(e.string(),e.unknown()),timestamp:G}),Q=e.object({entityId:e.string(),entityType:e.string(),changeType:q,data:e.record(e.string(),e.unknown()).optional(),timestamp:G,version:K}),$=e.object({id:e.string(),entityType:e.string(),entityId:e.string(),localVersion:K,remoteVersion:K,localData:e.record(e.string(),e.unknown()),remoteData:e.record(e.string(),e.unknown()),conflictedAt:G}),ee=e.object({conflictId:e.string(),strategy:J,resolvedData:e.record(e.string(),e.unknown()),resolvedAt:G});export{n as AggregateRoot,n as AggregateRootEntity,l as BusinessRuleError,q as ChangeTypeSchema,f as ConcurrencyError,m as ConfigurationError,$ as ConflictDataSchema,ee as ConflictResolutionSchema,J as ConflictResolutionStrategySchema,s as DomainError,r as DomainEvent,t as Entity,Q as EntityChangeSchema,i as EntityCreatedEvent,o as EntityDeletedEvent,W as EntityIdSchema,A as EntityIdVO,u as EntityNotFoundError,a as EntityUpdatedEvent,h as ExternalServiceError,I as Failure,Y as IdReferenceSchema,p as PermissionDeniedError,d as RepositoryError,F as Success,Z as SyncDataSchema,N as SyncStatus,P as SyncStatusVO,X as TimeRangeSchema,G as TimestampSchema,j as TimestampVO,O as UNIT_OF_WORK_TOKEN,U as UuidSchema,c as ValidationError,k as ValueObject,K as VersionSchema,M as VersionVO,z as combine,R as failure,x as isBusinessRuleError,y as isClientError,w as isConcurrencyError,E as isConfigurationError,S as isEntityNotFoundError,D as isExternalServiceError,V as isFailure,T as isPermissionDeniedError,C as isRepositoryError,v as isRetryableError,B as isSuccess,b as isValidationError,_ as logError,L as success,g as toDomainError,H as unwrapResult};

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@longzai-intelligence/shared-kernel",
+  "version": "0.0.1",
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "main": "./dist/index.cjs",
+  "exports": {
+    ".": {
+      "types": {
+        "import": "./dist/index.d.mts",
+        "require": "./dist/index.d.cts"
+      },
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "build:prod": "NODE_ENV=production tsdown",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "tsdown --watch",
+    "clean": "rimraf dist tsconfig/.cache",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "tsc --noEmit -p tsconfig/app.json",
+    "typecheck:node": "tsc --noEmit -p tsconfig/node.json",
+    "typecheck:test": "tsc --noEmit -p tsconfig/test.json"
+  },
+  "dependencies": {
+    "reflect-metadata": "^0.2.2",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@longzai-intelligence/logger-core": "0.0.2",
+    "@types/node": "^25.5.2",
+    "bun-types": "^1.3.11",
+    "eslint": "^10.2.0",
+    "rimraf": "^6.1.3",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.3",
+    "@longzai-intelligence/eslint-preset-library": "0.0.3",
+    "@longzai-intelligence/vitest-config": "0.0.3",
+    "@longzai-intelligence/typescript-config": "0.0.2",
+    "tsdown": "^0.21.7",
+    "@longzai-intelligence/tsdown-config": "0.0.1"
+  },
+  "packageManager": "bun@1.3.11",
+  "license": "UNLICENSED",
+  "module": "./dist/index.mjs"
+}