@shirudo/ddd-kit 3.0.0-rc.5 → 3.0.0-rc.6

package/dist/index.d.ts

@@ -2031,9 +2031,11 @@ declare abstract class Entity<TState, TId extends Id<string>> implements IEntity
    * `TState` publicly would expose the aggregate's live object graph and
    * let nested mutation bypass behavior, validation, versioning, and
    * dirty tracking. Concrete entities should expose business-meaningful queries or
-   * detached immutable DTOs. Snapshot projection belongs to the persistence
-   * adapter, which captures the aggregate from outside rather than asking
-   * the entity to create its own persistence memento.
+   * detached immutable DTOs (`deepFreeze(detachState(this.state))` for a
+   * plain-data state). Snapshot projection belongs to the persistence
+   * adapter, which captures the aggregate from outside through those
+   * queries and DTOs rather than asking the entity to create its own
+   * persistence memento.
    */
   protected get state(): TState;
   /**
@@ -3159,9 +3161,12 @@ declare function deepFreeze<T>(obj: T): Readonly<T>;
  * The input is first deep-cloned, then the clone is frozen, so calling
  * `vo(input)` never freezes the caller's own object graph as a
  * side-effect. Mutating the input afterwards does not bleed into the VO.
- * Symbol-keyed properties are preserved (matching `voEquals`); function
- * values and custom class instances are rejected (Value Objects are plain
- * data, not behaviour-bearing object graphs). Inputs must be trusted and
+ * Symbol-keyed properties are preserved (matching `voEquals`). A kit
+ * `ValueObject` instance nested in the input is kept by reference and
+ * frozen in place; it must keep all of its state in `props`. A value
+ * object as the input itself is rejected.
+ * Function values and every other custom class instance are rejected
+ * (Value Objects are plain data, not behaviour-bearing object graphs). Inputs must be trusted and
  * Proxy-free: ECMAScript provides no portable way to identify a transparent
  * Proxy without potentially executing its traps, so `vo()` is not a sandbox
  * for hostile in-process objects. Built-ins that cannot provide immutable,
@@ -3212,6 +3217,11 @@ declare function voEquals<T>(a: VO<T>, b: VO<T>): boolean;
  * Useful for comparing value objects that contain metadata or optional fields
  * that should not affect equality comparison.
  *
+ * The walk enters a nested `ValueObject` instance like any other object,
+ * so inside it the path continues with `props`; `ignoreKeys: ["props"]`
+ * empties every nested value object. The key under which the kit records
+ * the class of the instance is never ignored.
+ *
  * @param a - First value object
  * @param b - Second value object
  * @param options - Options specifying which keys to ignore during comparison
@@ -3310,7 +3320,11 @@ interface IValueObject<T extends object> {
 }
 /**
  * Abstract base class for creating Value Objects.
- * Value Objects are immutable and defined by their properties.
+ * Value Objects are immutable and defined by their properties. A value
+ * object can hold other value objects in its props. Every instance
+ * records its class under an own symbol key, so `equals` compares a
+ * nested value object by class and props and does not call its `equals`
+ * method.
  *
  * @template T - The shape of the value object's properties
  */
@@ -3431,6 +3445,33 @@ declare function voValidated<T>(t: T, validate: (issues: ValidationError, value:
  */
 declare function deepEqual(a: unknown, b: unknown): boolean;
 //#endregion
+//#region src/internal/structural/detach-state.d.ts
+/**
+ * Returns a copy of `state` that shares no object with the original.
+ * Throws a `TypeError` that names the path when the graph carries a value
+ * a structured clone would lose or silently degrade. A class instance, a
+ * subclass of a built-in included, loses the methods on its prototype. A
+ * symbol-keyed, non-enumerable, or accessor property and an expando on a
+ * built-in are dropped. A function or a symbol value throws a raw
+ * `DataCloneError`. An Error, a Promise, a WeakMap, or a WeakSet cannot be
+ * detached at all. A SharedArrayBuffer and a view over one keep sharing
+ * their memory. A Proxy is invisible to the walk and fails inside the
+ * clone; that failure is rethrown as a `TypeError` with the cause.
+ *
+ * Plain objects (from any realm), arrays, Dates, Maps, Sets, bigints, and
+ * typed arrays pass. A RegExp passes: pattern and flags survive the clone,
+ * and `lastIndex` restores as 0. The scan state of a global or sticky
+ * pattern is not domain data. A non-enumerable property on a built-in
+ * passes: it is the built-in's own machinery (`lastIndex`), not data. A
+ * non-enumerable symbol key passes anywhere: it is metadata by convention.
+ *
+ * The concrete entity uses it for a detached read DTO of a plain-data
+ * state. The snapshot model uses it for the captured DTO and the restored
+ * state. A state that carries a class-based child is mapped to plain data
+ * first, in the entity or in the model.
+ */
+declare function detachState<T>(state: T): T;
+//#endregion
 //#region src/messaging/event-bus/errors.d.ts
 /**
  * Thrown when one publish chain reaches `maxPublishDepth`.
@@ -4222,5 +4263,5 @@ declare function captureAggregateSnapshot<TAggregate extends SnapshotAggregate,
  */
 declare function reconstituteAggregateFromSnapshot<TAggregate extends SnapshotAggregate, TSnapshotState>(model: SnapshotModel<TAggregate, TSnapshotState>, id: TAggregate["id"], snapshot: AggregateSnapshot<unknown>): TAggregate;
 //#endregion
-export { type Aggregate, type AggregateAddress, type AggregateAddressMismatchOptions, type AggregateClass, type AggregateCommitToken, type AggregateConfig, AggregateDeletedError, AggregateNotFoundError, type AggregateNotFoundErrorOptions, type AggregatePersistence, type AggregatePersistenceWrite, type AggregateSnapshot, AggregateTrackingError, type AggregateTrackingFailure, type AggregateWriteIntent, type AggregateWriteRegistration, type AnyDomainEvent, type AnyUncommittedDomainEvent, CapabilityRegistryConflictError, type ClockFactory, type Command, CommandBus, type CommandBusOptions, type CommandCommitOriginCandidate, type CommandHandler, type CommandMessageContent, type CommandMessageRelationships, type CommandOutboxCommitCandidate, type CommandOutboxMapper, type CommandOutboxWriter, type CommitEnrollment, type CommitEnrollmentOptions, CommitError, type CommitPosition, type CommittedDomainEvent, type CompatibleRepositoryDefinitions, ConcurrencyConflictError, type ConcurrencyConflictErrorOptions, type CreateDomainEventFromFactsOptions, type CreateDomainEventOptions, type CreateDomainEventStampOptions, type CreateUncommittedDomainEventOptions, type DeadLetterDeadline, type DeadLetterRecord, DeadlineProcessor, type DeadlineProcessorObservers, type DeadlineProcessorOptions, type DeadlineStore, type DeepEqualExceptOptions, type DeepOmitKey, type DeepOmitOptions, type DeepOmitPathSegment, type DeliveryFailureAssessment, type DeliveryFailureClassifier, type DeliveryFailureKind, DirectStateMutationError, type DispatchTrackingOutbox, DomainError, type DomainErrorClass, type DomainEvent, type DomainEventFactory, type DomainEventFactoryOptions, type DomainEventStamp, type DomainEventStampFactory, type DomainEventStampProvider, type DomainEventValidationCode, DomainEventValidationError, type DomainEventValidationField, type DomainMachineDefinition, type DomainMachineDefinitionAnalysis, type DomainMachineDefinitionDiagnostic, type DomainMachineInput, type DomainMachineReadonly, type DomainMachineSnapshot, type DomainMachineTransitionDescription, DomainStateMachine, type DomainStateNode, type DomainTransition, DomainTransitionGuardRejectedError, type DomainTransitionGuardResult, type DomainTransitionOutcome, type DomainTransitionResult, type DueDeadline, DuplicateAggregateError, type DuplicateAggregateErrorOptions, DuplicateEventIdError, DuplicateHandlerRegistrationError, type DuplicateHandlerRegistrationErrorOptions, type DurableCommandMessage, Entity, type EntityConfig, ErrorMapperFailedError, type ErrorMapperFailedErrorOptions, type EventBus, EventBusClosedError, EventBusImpl, type EventBusObservers, type EventBusOptions, type EventCommitCandidate, type EventCommitCandidatePosition, type EventHandler, EventHarvestError, type EventIdFactory, type EventMetadata, EventSourcedAggregate, type EventStore, type EventStoreAppendOptions, type ExecutionContext, FoldReturnedNoStateError, ForeignEventError, type HandlerFailureReport, HostileStateKeyError, type ICommandBus, type IEntity, type IQueryBus, type IValueObject, type Id, type IdGenerator, type IdempotencyClaim, type IdempotencyClaimHandle, IdempotencyClaimLostError, type IdempotencyClaimLostErrorOptions, IdempotencyCompletionWithoutClaimError, IdempotencyInFlightError, type IdempotencyInFlightErrorOptions, IdempotencyKeyReuseError, type IdempotencyKeyReuseErrorOptions, type IdempotencyLease, type IdempotencyOperationErrorContext, type IdempotencyReconciliation, type IdempotencyReconciliationDecision, IdempotencyReconciliationRequiredError, type IdempotencyReconciliationRequiredErrorOptions, type IdempotencyStore, type IdempotentCommitRequest, type IdempotentCommitResult, type IdempotentExecution, type Identifiable, IdentityMap, InMemoryCapacityExceededError, type InMemoryCapacityExceededErrorOptions, InMemoryDeadlineStore, type InMemoryDeadlineStoreOptions, InMemoryEventStore, type InMemoryEventStoreOptions, InMemoryIdempotencyStore, type InMemoryIdempotencyStoreOptions, InMemoryOutbox, type InMemoryOutboxOptions, InMemoryProjectionCheckpointStore, type InMemoryProjectionCheckpointStoreOptions, InMemorySnapshotStore, type InMemorySnapshotStoreOptions, InfrastructureError, type IntegrationMessage, type IntegrationMessageContent, type IntegrationMessageMapper, type IntegrationMessageRelationships, InvalidCommandMessageError, InvalidDomainMachineContextError, InvalidDomainMachineDefinitionError, InvalidDomainMachineInputError, InvalidDomainMachineSnapshotError, InvalidDomainTransitionError, InvalidDomainTransitionGuardResultError, InvalidDomainTransitionResultError, InvalidIntegrationMessageError, InvalidRepositoryAdapterError, InvalidRepositoryDefinitionError, InvalidVersionError, type JsonObject, type JsonPrimitive, type JsonValue, type KitErrorCode, type KitErrorOptions, MisaddressedEventError, MissingEntityIdError, MissingFoldError, MissingHandlerError, NestedUnitOfWorkError, NonProgressingEventStreamPageError, type NonProgressingEventStreamPageErrorOptions, type OnceOptions, type Outbox, OutboxDispatcher, type OutboxDispatcherObservers, type OutboxDispatcherOptions, type OutboxRecord, type OutboxSink, type OutboxWriter, type PendingDomainEvent, PendingEventBatchMismatchError, PendingEventLimitExceededError, type PendingEventLimitExceededErrorOptions, type PersistenceBaseline, type PersistenceChanges, type PersistenceLifecycle, type PersistenceModel, type PhysicalRemovalRegistration, type PreparedDomainMachineDefinition, type ProjectOptions, type Projection, type ProjectionBatchResult, type ProjectionCheckpoint, type ProjectionCheckpointStore, type ProjectionEventHandler, type ProjectionFromHandlersOptions, ProjectionGapError, type ProjectionHandlers, ProjectionIdentityViolationError, ProjectionOrderViolationError, type ProjectionPosition, ProjectionReceiptViolationError, Projector, type ProjectorOptions, type PublishAbortedReport, type PublishChainState, type PublishChainStore, PublishDepthExceededError, type PublishOptions, type PublishedCommand, type Query, QueryBus, type QueryBusOptions, type QueryHandler, type ReadStreamOptions, ReentrantDomainStateMachineEvaluationError, ReentrantEventRecordingError, ReplayHeadMismatchError, type ReplayHeadMismatchErrorOptions, type ReplayableAggregate, type RepositoriesOf, type Repository, type RepositoryDefinition, type RepositoryDefinitionOptions, RepositoryErrorMappingFailedError, type RepositoryTracking, type RetryPolicy, RetryingTransactionScope, RollbackError, type RunOptions, type SharedDomainEventStampOptions, SnapshotCorruptedError, type SnapshotModel, SnapshotSchemaMismatchError, type SnapshotSchemaMismatchErrorOptions, type SnapshotStore, SnapshotTimeValidationError, SnapshotVersionNotRestoredError, type SnapshotVersionNotRestoredErrorOptions, Specification, type SpecificationComposite, StateStoredAggregate, type StateValidator, type StreamReadResult, type SubscriptionThresholdReport, TransactionClosedError, type TransactionScope, type TransactionalOptions, type UncommittedDomainEvent, type UncommittedDomainEventOf, UnenrolledChangesError, UnitOfWork, type UnitOfWorkContext, type UnitOfWorkDeps, type UnitOfWorkIdentityMap, UnmanagedInstanceError, UnmintedEventError, UnprojectableEventError, UnregisteredHandlerError, type UnregisteredHandlerErrorOptions, UnreplayableAggregateError, type VO, ValueObject, type Version, type WithCommitDeps, type WithCommitWorkResult, type WithIdempotentCommitDeps, analyzeDomainMachineDefinition, canTransitionDomainState, captureAggregateSnapshot, capturePersistenceBaseline, copyMetadata, createDomainEvent, createDomainEventFactory, createDomainEventFromFacts, createInitialDomainMachineSnapshot, createIntegrationMessage, createUncommittedDomainEvent, decodeIntegrationMessage, deepEqual, deepEqualExcept, deepFreeze, deepOmit, defaultDomainEventFactory, defineRepository, defineSnapshotModel, derivePersistenceChanges, domainErrorToResult, encodeIntegrationMessage, entityIds, eventBusSink, findEntityById, freezeShallow, hasEntityId, ignoreProjectionEvent, insertPersistenceBaseline, integrationMessageToCommittedEvent, isDomainErrorLike, isInfrastructureErrorLike, isPositionAfter, mergeMetadata, outboxWriterAcceptingEventLoss, persistenceProjectionDrifted, prepareDomainMachineDefinition, projectionFromHandlers, recapturePersistenceBaseline, reconstituteAggregateFromHistory, reconstituteAggregateFromSnapshot, recordDomainEvent, recordPendingEvents, removeEntityById, replaceEntityById, routeEventsToCommandOutbox, sameEntity, sameVersion, specification, toVersion, transitionDomainState, updateEntityById, vo, voEquals, voEqualsExcept, voValidated, voWithValidation, withCommit, withIdempotentCommit };
+export { type Aggregate, type AggregateAddress, type AggregateAddressMismatchOptions, type AggregateClass, type AggregateCommitToken, type AggregateConfig, AggregateDeletedError, AggregateNotFoundError, type AggregateNotFoundErrorOptions, type AggregatePersistence, type AggregatePersistenceWrite, type AggregateSnapshot, AggregateTrackingError, type AggregateTrackingFailure, type AggregateWriteIntent, type AggregateWriteRegistration, type AnyDomainEvent, type AnyUncommittedDomainEvent, CapabilityRegistryConflictError, type ClockFactory, type Command, CommandBus, type CommandBusOptions, type CommandCommitOriginCandidate, type CommandHandler, type CommandMessageContent, type CommandMessageRelationships, type CommandOutboxCommitCandidate, type CommandOutboxMapper, type CommandOutboxWriter, type CommitEnrollment, type CommitEnrollmentOptions, CommitError, type CommitPosition, type CommittedDomainEvent, type CompatibleRepositoryDefinitions, ConcurrencyConflictError, type ConcurrencyConflictErrorOptions, type CreateDomainEventFromFactsOptions, type CreateDomainEventOptions, type CreateDomainEventStampOptions, type CreateUncommittedDomainEventOptions, type DeadLetterDeadline, type DeadLetterRecord, DeadlineProcessor, type DeadlineProcessorObservers, type DeadlineProcessorOptions, type DeadlineStore, type DeepEqualExceptOptions, type DeepOmitKey, type DeepOmitOptions, type DeepOmitPathSegment, type DeliveryFailureAssessment, type DeliveryFailureClassifier, type DeliveryFailureKind, DirectStateMutationError, type DispatchTrackingOutbox, DomainError, type DomainErrorClass, type DomainEvent, type DomainEventFactory, type DomainEventFactoryOptions, type DomainEventStamp, type DomainEventStampFactory, type DomainEventStampProvider, type DomainEventValidationCode, DomainEventValidationError, type DomainEventValidationField, type DomainMachineDefinition, type DomainMachineDefinitionAnalysis, type DomainMachineDefinitionDiagnostic, type DomainMachineInput, type DomainMachineReadonly, type DomainMachineSnapshot, type DomainMachineTransitionDescription, DomainStateMachine, type DomainStateNode, type DomainTransition, DomainTransitionGuardRejectedError, type DomainTransitionGuardResult, type DomainTransitionOutcome, type DomainTransitionResult, type DueDeadline, DuplicateAggregateError, type DuplicateAggregateErrorOptions, DuplicateEventIdError, DuplicateHandlerRegistrationError, type DuplicateHandlerRegistrationErrorOptions, type DurableCommandMessage, Entity, type EntityConfig, ErrorMapperFailedError, type ErrorMapperFailedErrorOptions, type EventBus, EventBusClosedError, EventBusImpl, type EventBusObservers, type EventBusOptions, type EventCommitCandidate, type EventCommitCandidatePosition, type EventHandler, EventHarvestError, type EventIdFactory, type EventMetadata, EventSourcedAggregate, type EventStore, type EventStoreAppendOptions, type ExecutionContext, FoldReturnedNoStateError, ForeignEventError, type HandlerFailureReport, HostileStateKeyError, type ICommandBus, type IEntity, type IQueryBus, type IValueObject, type Id, type IdGenerator, type IdempotencyClaim, type IdempotencyClaimHandle, IdempotencyClaimLostError, type IdempotencyClaimLostErrorOptions, IdempotencyCompletionWithoutClaimError, IdempotencyInFlightError, type IdempotencyInFlightErrorOptions, IdempotencyKeyReuseError, type IdempotencyKeyReuseErrorOptions, type IdempotencyLease, type IdempotencyOperationErrorContext, type IdempotencyReconciliation, type IdempotencyReconciliationDecision, IdempotencyReconciliationRequiredError, type IdempotencyReconciliationRequiredErrorOptions, type IdempotencyStore, type IdempotentCommitRequest, type IdempotentCommitResult, type IdempotentExecution, type Identifiable, IdentityMap, InMemoryCapacityExceededError, type InMemoryCapacityExceededErrorOptions, InMemoryDeadlineStore, type InMemoryDeadlineStoreOptions, InMemoryEventStore, type InMemoryEventStoreOptions, InMemoryIdempotencyStore, type InMemoryIdempotencyStoreOptions, InMemoryOutbox, type InMemoryOutboxOptions, InMemoryProjectionCheckpointStore, type InMemoryProjectionCheckpointStoreOptions, InMemorySnapshotStore, type InMemorySnapshotStoreOptions, InfrastructureError, type IntegrationMessage, type IntegrationMessageContent, type IntegrationMessageMapper, type IntegrationMessageRelationships, InvalidCommandMessageError, InvalidDomainMachineContextError, InvalidDomainMachineDefinitionError, InvalidDomainMachineInputError, InvalidDomainMachineSnapshotError, InvalidDomainTransitionError, InvalidDomainTransitionGuardResultError, InvalidDomainTransitionResultError, InvalidIntegrationMessageError, InvalidRepositoryAdapterError, InvalidRepositoryDefinitionError, InvalidVersionError, type JsonObject, type JsonPrimitive, type JsonValue, type KitErrorCode, type KitErrorOptions, MisaddressedEventError, MissingEntityIdError, MissingFoldError, MissingHandlerError, NestedUnitOfWorkError, NonProgressingEventStreamPageError, type NonProgressingEventStreamPageErrorOptions, type OnceOptions, type Outbox, OutboxDispatcher, type OutboxDispatcherObservers, type OutboxDispatcherOptions, type OutboxRecord, type OutboxSink, type OutboxWriter, type PendingDomainEvent, PendingEventBatchMismatchError, PendingEventLimitExceededError, type PendingEventLimitExceededErrorOptions, type PersistenceBaseline, type PersistenceChanges, type PersistenceLifecycle, type PersistenceModel, type PhysicalRemovalRegistration, type PreparedDomainMachineDefinition, type ProjectOptions, type Projection, type ProjectionBatchResult, type ProjectionCheckpoint, type ProjectionCheckpointStore, type ProjectionEventHandler, type ProjectionFromHandlersOptions, ProjectionGapError, type ProjectionHandlers, ProjectionIdentityViolationError, ProjectionOrderViolationError, type ProjectionPosition, ProjectionReceiptViolationError, Projector, type ProjectorOptions, type PublishAbortedReport, type PublishChainState, type PublishChainStore, PublishDepthExceededError, type PublishOptions, type PublishedCommand, type Query, QueryBus, type QueryBusOptions, type QueryHandler, type ReadStreamOptions, ReentrantDomainStateMachineEvaluationError, ReentrantEventRecordingError, ReplayHeadMismatchError, type ReplayHeadMismatchErrorOptions, type ReplayableAggregate, type RepositoriesOf, type Repository, type RepositoryDefinition, type RepositoryDefinitionOptions, RepositoryErrorMappingFailedError, type RepositoryTracking, type RetryPolicy, RetryingTransactionScope, RollbackError, type RunOptions, type SharedDomainEventStampOptions, SnapshotCorruptedError, type SnapshotModel, SnapshotSchemaMismatchError, type SnapshotSchemaMismatchErrorOptions, type SnapshotStore, SnapshotTimeValidationError, SnapshotVersionNotRestoredError, type SnapshotVersionNotRestoredErrorOptions, Specification, type SpecificationComposite, StateStoredAggregate, type StateValidator, type StreamReadResult, type SubscriptionThresholdReport, TransactionClosedError, type TransactionScope, type TransactionalOptions, type UncommittedDomainEvent, type UncommittedDomainEventOf, UnenrolledChangesError, UnitOfWork, type UnitOfWorkContext, type UnitOfWorkDeps, type UnitOfWorkIdentityMap, UnmanagedInstanceError, UnmintedEventError, UnprojectableEventError, UnregisteredHandlerError, type UnregisteredHandlerErrorOptions, UnreplayableAggregateError, type VO, ValueObject, type Version, type WithCommitDeps, type WithCommitWorkResult, type WithIdempotentCommitDeps, analyzeDomainMachineDefinition, canTransitionDomainState, captureAggregateSnapshot, capturePersistenceBaseline, copyMetadata, createDomainEvent, createDomainEventFactory, createDomainEventFromFacts, createInitialDomainMachineSnapshot, createIntegrationMessage, createUncommittedDomainEvent, decodeIntegrationMessage, deepEqual, deepEqualExcept, deepFreeze, deepOmit, defaultDomainEventFactory, defineRepository, defineSnapshotModel, derivePersistenceChanges, detachState, domainErrorToResult, encodeIntegrationMessage, entityIds, eventBusSink, findEntityById, freezeShallow, hasEntityId, ignoreProjectionEvent, insertPersistenceBaseline, integrationMessageToCommittedEvent, isDomainErrorLike, isInfrastructureErrorLike, isPositionAfter, mergeMetadata, outboxWriterAcceptingEventLoss, persistenceProjectionDrifted, prepareDomainMachineDefinition, projectionFromHandlers, recapturePersistenceBaseline, reconstituteAggregateFromHistory, reconstituteAggregateFromSnapshot, recordDomainEvent, recordPendingEvents, removeEntityById, replaceEntityById, routeEventsToCommandOutbox, sameEntity, sameVersion, specification, toVersion, transitionDomainState, updateEntityById, vo, voEquals, voEqualsExcept, voValidated, voWithValidation, withCommit, withIdempotentCommit };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,5 +1,5 @@
 import { A as NonProgressingEventStreamPageError, B as SnapshotSchemaMismatchError, C as InvalidIntegrationMessageError, D as MissingEntityIdError, E as MisaddressedEventError, F as ProjectionOrderViolationError, G as UnprojectableEventError, H as UnenrolledChangesError, I as ProjectionReceiptViolationError, J as assertNoHostileOwnProtoKey, K as UnregisteredHandlerError, L as ReentrantEventRecordingError, M as PendingEventLimitExceededError, N as ProjectionGapError, O as MissingFoldError, P as ProjectionIdentityViolationError, R as ReplayHeadMismatchError, S as InvalidCommandMessageError, T as KitWiringError, U as UnmanagedInstanceError, V as SnapshotVersionNotRestoredError, W as UnmintedEventError, X as isInfrastructureErrorLike, Y as isDomainErrorLike, _ as IdempotencyInFlightError, a as DirectStateMutationError, b as InMemoryCapacityExceededError, c as DuplicateEventIdError, d as EventHarvestError, f as FoldReturnedNoStateError, g as IdempotencyCompletionWithoutClaimError, h as IdempotencyClaimLostError, i as ConcurrencyConflictError, j as PendingEventBatchMismatchError, k as MissingHandlerError, l as DuplicateHandlerRegistrationError, m as HostileStateKeyError, n as AggregateNotFoundError, o as DomainError, p as ForeignEventError, q as UnreplayableAggregateError, r as CapabilityRegistryConflictError, s as DuplicateAggregateError, t as AggregateDeletedError, u as ErrorMapperFailedError, v as IdempotencyKeyReuseError, w as InvalidVersionError, x as InfrastructureError, y as IdempotencyReconciliationRequiredError, z as SnapshotCorruptedError } from "./chunks/kit-errors.js";
-import { A as isWeakMap, C as voWithValidation, D as findPropertyDescriptor, E as deepEqual, O as isBuiltInObject, S as voEqualsExcept, T as deepOmit, _ as stampCooperativeBrand, a as createDomainEvent, b as vo, c as createUncommittedDomainEvent, d as isUncommittedDomainEvent, f as mergeMetadata, g as hasCooperativeBrand, h as SnapshotTimeValidationError, i as copyMetadata, k as isIntrinsicConstructorPrototype, l as defaultDomainEventFactory, m as DomainEventValidationError, n as adoptRecordedDomainEvent, o as createDomainEventFactory, p as recordDomainEvent, r as adoptUncommittedDomainEvent, s as createDomainEventFromFacts, t as isDispatchTrackingOutbox, u as isRecordedDomainEvent, v as ValueObject, w as deepEqualExcept, x as voEquals, y as deepFreeze } from "./chunks/ports.js";
+import { A as isBuiltInObject, C as voWithValidation, D as builtInTagWithoutInvokingAccessors, E as deepEqual, M as isWeakMap, O as findPropertyDescriptor, S as voEqualsExcept, T as deepOmit, _ as stampCooperativeBrand, a as createDomainEvent, b as vo, c as createUncommittedDomainEvent, d as isUncommittedDomainEvent, f as mergeMetadata, g as hasCooperativeBrand, h as SnapshotTimeValidationError, i as copyMetadata, j as isIntrinsicConstructorPrototype, k as hasIntrinsicPrototypeChain, l as defaultDomainEventFactory, m as DomainEventValidationError, n as adoptRecordedDomainEvent, o as createDomainEventFactory, p as recordDomainEvent, r as adoptUncommittedDomainEvent, s as createDomainEventFromFacts, t as isDispatchTrackingOutbox, u as isRecordedDomainEvent, v as ValueObject, w as deepEqualExcept, x as voEquals, y as deepFreeze } from "./chunks/ports.js";
 import { err, ok } from "@shirudo/result";
 import { ValidationError, someChainRetryable } from "@shirudo/base-error";
 
@@ -3518,9 +3518,11 @@ var Entity = class {
 	* `TState` publicly would expose the aggregate's live object graph and
 	* let nested mutation bypass behavior, validation, versioning, and
 	* dirty tracking. Concrete entities should expose business-meaningful queries or
-	* detached immutable DTOs. Snapshot projection belongs to the persistence
-	* adapter, which captures the aggregate from outside rather than asking
-	* the entity to create its own persistence memento.
+	* detached immutable DTOs (`deepFreeze(detachState(this.state))` for a
+	* plain-data state). Snapshot projection belongs to the persistence
+	* adapter, which captures the aggregate from outside through those
+	* queries and DTOs rather than asking the entity to create its own
+	* persistence memento.
 	*/
 	get state() {
 		return this._state;
@@ -5327,6 +5329,117 @@ function voValidated(t, validate, message = "Validation failed") {
 	return issues.hasIssues() ? err(issues) : ok(vo(t));
 }
 
+//#endregion
+//#region src/internal/structural/detach-state.ts
+/**
+* Returns a copy of `state` that shares no object with the original.
+* Throws a `TypeError` that names the path when the graph carries a value
+* a structured clone would lose or silently degrade. A class instance, a
+* subclass of a built-in included, loses the methods on its prototype. A
+* symbol-keyed, non-enumerable, or accessor property and an expando on a
+* built-in are dropped. A function or a symbol value throws a raw
+* `DataCloneError`. An Error, a Promise, a WeakMap, or a WeakSet cannot be
+* detached at all. A SharedArrayBuffer and a view over one keep sharing
+* their memory. A Proxy is invisible to the walk and fails inside the
+* clone; that failure is rethrown as a `TypeError` with the cause.
+*
+* Plain objects (from any realm), arrays, Dates, Maps, Sets, bigints, and
+* typed arrays pass. A RegExp passes: pattern and flags survive the clone,
+* and `lastIndex` restores as 0. The scan state of a global or sticky
+* pattern is not domain data. A non-enumerable property on a built-in
+* passes: it is the built-in's own machinery (`lastIndex`), not data. A
+* non-enumerable symbol key passes anywhere: it is metadata by convention.
+*
+* The concrete entity uses it for a detached read DTO of a plain-data
+* state. The snapshot model uses it for the captured DTO and the restored
+* state. A state that carries a class-based child is mapped to plain data
+* first, in the entity or in the model.
+*/
+function detachState(state) {
+	assertDetachable(state, "", /* @__PURE__ */ new WeakSet());
+	try {
+		return structuredClone(state);
+	} catch (cause) {
+		throw new TypeError("detachState: state holds a Proxy or a host object that cannot be cloned; map it to plain data", { cause });
+	}
+}
+const INDEX_KEY = /^(0|[1-9]\d*)$/;
+function assertDetachable(value, path, seen) {
+	if (typeof value === "function") throw new TypeError(`detachState: state${path} is a function; map it to plain data`);
+	if (typeof value === "symbol") throw new TypeError(`detachState: state${path} is a symbol; map it to plain data`);
+	if (value === null || typeof value !== "object") return;
+	const object = value;
+	if (seen.has(object)) return;
+	seen.add(object);
+	if (Array.isArray(object)) {
+		if (!hasIntrinsicPrototypeChain(object, "Array")) throwClassInstance(object, path);
+		assertOwnPropertiesDetachable(object, path, seen, "array");
+		return;
+	}
+	const tag = builtInTagWithoutInvokingAccessors(object);
+	if (tag !== void 0) {
+		if (!hasIntrinsicPrototypeChain(object)) throwClassInstance(object, path);
+		if (tag === "[object Map]") {
+			let index = 0;
+			for (const [key, entry] of object) {
+				assertDetachable(key, `${path}<map key #${index}>`, seen);
+				assertDetachable(entry, `${path}<map value #${index}>`, seen);
+				index++;
+			}
+		} else if (tag === "[object Set]") {
+			let index = 0;
+			for (const member of object) {
+				assertDetachable(member, `${path}<set member #${index}>`, seen);
+				index++;
+			}
+		} else if (tag === "[object Promise]" || tag === "[object WeakMap]" || tag === "[object WeakSet]") throw new TypeError(`detachState: state${path} is a ${tag.slice(8, -1)} and cannot be detached`);
+		else if (tag === "[object Error]") throw new TypeError(`detachState: state${path} is an Error; map it to plain data`);
+		else if (sharesMemory(object, tag)) throw new TypeError(`detachState: state${path} is backed by a SharedArrayBuffer and the copy would share its memory; map it to plain data`);
+		assertOwnPropertiesDetachable(object, path, seen, "built-in");
+		return;
+	}
+	const prototype = Object.getPrototypeOf(object);
+	if (!(prototype === null || isIntrinsicConstructorPrototype(prototype, "Object") && Object.getPrototypeOf(prototype) === null)) throwClassInstance(object, path);
+	assertOwnPropertiesDetachable(object, path, seen, "record");
+}
+/**
+* Audits the own properties the clone would copy or drop. The clone keeps
+* the enumerable own keys of a record and of an array, expandos included,
+* and drops every own key of another built-in. `length` on an array and
+* the non-enumerable keys of a built-in (`lastIndex`) are its own
+* machinery, not data. Index keys of a typed array or a boxed String are
+* its content and pass as such.
+*/
+function assertOwnPropertiesDetachable(object, path, seen, kind) {
+	for (const key of Reflect.ownKeys(object)) {
+		const descriptor = Object.getOwnPropertyDescriptor(object, key);
+		if (descriptor === void 0) continue;
+		if (typeof key === "symbol") {
+			if (!descriptor.enumerable) continue;
+			throw new TypeError(`detachState: state${path} has a symbol-keyed property; map it to plain data`);
+		}
+		if (kind === "array" && key === "length") continue;
+		const isIndex = INDEX_KEY.test(key);
+		if (!descriptor.enumerable) {
+			if (kind === "built-in") continue;
+			throw new TypeError(`detachState: state${path}.${key} is not enumerable and the clone would drop it; map it to plain data`);
+		}
+		if (kind === "built-in" && isIndex) continue;
+		const memberPath = isIndex ? `${path}[${key}]` : `${path}.${key}`;
+		if (!("value" in descriptor)) throw new TypeError(`detachState: state${memberPath} is an accessor property; map it to plain data`);
+		if (kind === "built-in") throw new TypeError(`detachState: state${memberPath} is an expando on a ${object.constructor?.name ?? "built-in"} and the clone would drop it; map it to plain data`);
+		assertDetachable(descriptor.value, memberPath, seen);
+	}
+}
+function sharesMemory(object, tag) {
+	if (tag === "[object SharedArrayBuffer]") return true;
+	return ArrayBuffer.isView(object) && Object.prototype.toString.call(object.buffer) === "[object SharedArrayBuffer]";
+}
+function throwClassInstance(object, path) {
+	const name = Object.getPrototypeOf(object)?.constructor?.name || "anonymous class";
+	throw new TypeError(`detachState: state${path} is a class instance (${name}); map it to plain data`);
+}
+
 //#endregion
 //#region src/messaging/event-bus/errors.ts
 /** Keeps a deep chain readable in the message without losing the recent path. */
@@ -6907,7 +7020,7 @@ function defineSnapshotModel(model) {
 function captureAggregateSnapshot(model, aggregate, snapshotAt) {
 	assertSnapshotModel(model);
 	const recordedAt = copySnapshotAt(snapshotAt);
-	const state = detachSnapshotState(model.capture(aggregate));
+	const state = detachState(model.capture(aggregate));
 	return deepFreeze({
 		state,
 		version: aggregate.version,
@@ -6943,8 +7056,8 @@ function reconstituteAggregateFromSnapshot(model, id, snapshot) {
 	let aggregate;
 	try {
 		let state;
-		if (storedSchemaVersion === model.schemaVersion) state = detachSnapshotState(snapshot.state);
-		else if (model.migrate) state = detachSnapshotState(model.migrate(detachSnapshotState(snapshot.state), storedSchemaVersion));
+		if (storedSchemaVersion === model.schemaVersion) state = detachState(snapshot.state);
+		else if (model.migrate) state = detachState(model.migrate(detachState(snapshot.state), storedSchemaVersion));
 		else throw new SnapshotSchemaMismatchError({
 			aggregateType: model.aggregateType,
 			aggregateId: String(id),
@@ -6974,64 +7087,7 @@ function copySnapshotAt(snapshotAt) {
 	if (!(snapshotAt instanceof Date) || !Number.isFinite(snapshotAt.getTime())) throw new SnapshotTimeValidationError();
 	return new Date(snapshotAt.getTime());
 }
-function detachSnapshotState(state) {
-	assertSnapshotSafe(state, "", /* @__PURE__ */ new WeakSet());
-	return structuredClone(state);
-}
-/**
-* Rejects graphs that structured cloning would lose or silently degrade.
-* Snapshot models map class-based domain state to plain persistence DTOs.
-* A RegExp passes: pattern and flags survive the clone, and `lastIndex`
-* restores as 0. The scan state of a global or sticky pattern is not
-* domain data.
-*/
-function assertSnapshotSafe(value, path, seen) {
-	if (typeof value === "function") throw new TypeError(`snapshot state${path} is a function; map it to serialisable data in the snapshot model`);
-	if (typeof value === "symbol") throw new TypeError(`snapshot state${path} is a symbol; map it to serialisable data in the snapshot model`);
-	if (value === null || typeof value !== "object") return;
-	const object = value;
-	if (seen.has(object)) return;
-	seen.add(object);
-	if (Array.isArray(object)) {
-		for (let index = 0; index < object.length; index++) assertSnapshotSafe(object[index], `${path}[${index}]`, seen);
-		return;
-	}
-	const tag = Object.prototype.toString.call(object);
-	if (isBuiltInObject(object, tag)) {
-		if (tag === "[object Map]") {
-			let index = 0;
-			for (const [key, entry] of object) {
-				assertSnapshotSafe(key, `${path}<map key #${index}>`, seen);
-				assertSnapshotSafe(entry, `${path}<map value #${index}>`, seen);
-				index++;
-			}
-			return;
-		}
-		if (tag === "[object Set]") {
-			let index = 0;
-			for (const member of object) {
-				assertSnapshotSafe(member, `${path}<set member #${index}>`, seen);
-				index++;
-			}
-			return;
-		}
-		if (tag === "[object Promise]" || tag === "[object WeakMap]" || tag === "[object WeakSet]") throw new TypeError(`snapshot state${path} is a ${tag.slice(8, -1)} and cannot be persisted`);
-		if (tag === "[object Error]") throw new TypeError(`snapshot state${path} is an Error; map it to plain data in the snapshot model`);
-		return;
-	}
-	const prototype = Object.getPrototypeOf(object);
-	if (prototype === Object.prototype || prototype === null) {
-		for (const key of Reflect.ownKeys(object)) {
-			if (!Object.getOwnPropertyDescriptor(object, key)?.enumerable) continue;
-			if (typeof key === "symbol") throw new TypeError(`snapshot state${path} has a symbol-keyed property; map it to plain data in the snapshot model`);
-			assertSnapshotSafe(object[key], `${path}.${key}`, seen);
-		}
-		return;
-	}
-	const name = prototype.constructor?.name || "anonymous class";
-	throw new TypeError(`snapshot state${path} is a class instance (${name}); map it to plain data in the snapshot model`);
-}
 
 //#endregion
-export { AggregateDeletedError, AggregateNotFoundError, AggregateTrackingError, CapabilityRegistryConflictError, CommandBus, CommitError, ConcurrencyConflictError, DeadlineProcessor, DirectStateMutationError, DomainError, DomainEventValidationError, DomainStateMachine, DomainTransitionGuardRejectedError, DuplicateAggregateError, DuplicateEventIdError, DuplicateHandlerRegistrationError, Entity, ErrorMapperFailedError, EventBusClosedError, EventBusImpl, EventHarvestError, EventSourcedAggregate, FoldReturnedNoStateError, ForeignEventError, HostileStateKeyError, IdempotencyClaimLostError, IdempotencyCompletionWithoutClaimError, IdempotencyInFlightError, IdempotencyKeyReuseError, IdempotencyReconciliationRequiredError, IdentityMap, InMemoryCapacityExceededError, InMemoryDeadlineStore, InMemoryEventStore, InMemoryIdempotencyStore, InMemoryOutbox, InMemoryProjectionCheckpointStore, InMemorySnapshotStore, InfrastructureError, InvalidCommandMessageError, InvalidDomainMachineContextError, InvalidDomainMachineDefinitionError, InvalidDomainMachineInputError, InvalidDomainMachineSnapshotError, InvalidDomainTransitionError, InvalidDomainTransitionGuardResultError, InvalidDomainTransitionResultError, InvalidIntegrationMessageError, InvalidRepositoryAdapterError, InvalidRepositoryDefinitionError, InvalidVersionError, MisaddressedEventError, MissingEntityIdError, MissingFoldError, MissingHandlerError, NestedUnitOfWorkError, NonProgressingEventStreamPageError, OutboxDispatcher, PendingEventBatchMismatchError, PendingEventLimitExceededError, ProjectionGapError, ProjectionIdentityViolationError, ProjectionOrderViolationError, ProjectionReceiptViolationError, Projector, PublishDepthExceededError, QueryBus, ReentrantDomainStateMachineEvaluationError, ReentrantEventRecordingError, ReplayHeadMismatchError, RepositoryErrorMappingFailedError, RetryingTransactionScope, RollbackError, SnapshotCorruptedError, SnapshotSchemaMismatchError, SnapshotTimeValidationError, SnapshotVersionNotRestoredError, Specification, StateStoredAggregate, TransactionClosedError, UnenrolledChangesError, UnitOfWork, UnmanagedInstanceError, UnmintedEventError, UnprojectableEventError, UnregisteredHandlerError, UnreplayableAggregateError, ValueObject, analyzeDomainMachineDefinition, canTransitionDomainState, captureAggregateSnapshot, capturePersistenceBaseline, copyMetadata, createDomainEvent, createDomainEventFactory, createDomainEventFromFacts, createInitialDomainMachineSnapshot, createIntegrationMessage, createUncommittedDomainEvent, decodeIntegrationMessage, deepEqual, deepEqualExcept, deepFreeze, deepOmit, defaultDomainEventFactory, defineRepository, defineSnapshotModel, derivePersistenceChanges, domainErrorToResult, encodeIntegrationMessage, entityIds, eventBusSink, findEntityById, freezeShallow, hasEntityId, ignoreProjectionEvent, insertPersistenceBaseline, integrationMessageToCommittedEvent, isDomainErrorLike, isInfrastructureErrorLike, isPositionAfter, mergeMetadata, outboxWriterAcceptingEventLoss, persistenceProjectionDrifted, prepareDomainMachineDefinition, projectionFromHandlers, recapturePersistenceBaseline, reconstituteAggregateFromHistory, reconstituteAggregateFromSnapshot, recordDomainEvent, recordPendingEvents, removeEntityById, replaceEntityById, routeEventsToCommandOutbox, sameEntity, sameVersion, specification, toVersion, transitionDomainState, updateEntityById, vo, voEquals, voEqualsExcept, voValidated, voWithValidation, withCommit, withIdempotentCommit };
+export { AggregateDeletedError, AggregateNotFoundError, AggregateTrackingError, CapabilityRegistryConflictError, CommandBus, CommitError, ConcurrencyConflictError, DeadlineProcessor, DirectStateMutationError, DomainError, DomainEventValidationError, DomainStateMachine, DomainTransitionGuardRejectedError, DuplicateAggregateError, DuplicateEventIdError, DuplicateHandlerRegistrationError, Entity, ErrorMapperFailedError, EventBusClosedError, EventBusImpl, EventHarvestError, EventSourcedAggregate, FoldReturnedNoStateError, ForeignEventError, HostileStateKeyError, IdempotencyClaimLostError, IdempotencyCompletionWithoutClaimError, IdempotencyInFlightError, IdempotencyKeyReuseError, IdempotencyReconciliationRequiredError, IdentityMap, InMemoryCapacityExceededError, InMemoryDeadlineStore, InMemoryEventStore, InMemoryIdempotencyStore, InMemoryOutbox, InMemoryProjectionCheckpointStore, InMemorySnapshotStore, InfrastructureError, InvalidCommandMessageError, InvalidDomainMachineContextError, InvalidDomainMachineDefinitionError, InvalidDomainMachineInputError, InvalidDomainMachineSnapshotError, InvalidDomainTransitionError, InvalidDomainTransitionGuardResultError, InvalidDomainTransitionResultError, InvalidIntegrationMessageError, InvalidRepositoryAdapterError, InvalidRepositoryDefinitionError, InvalidVersionError, MisaddressedEventError, MissingEntityIdError, MissingFoldError, MissingHandlerError, NestedUnitOfWorkError, NonProgressingEventStreamPageError, OutboxDispatcher, PendingEventBatchMismatchError, PendingEventLimitExceededError, ProjectionGapError, ProjectionIdentityViolationError, ProjectionOrderViolationError, ProjectionReceiptViolationError, Projector, PublishDepthExceededError, QueryBus, ReentrantDomainStateMachineEvaluationError, ReentrantEventRecordingError, ReplayHeadMismatchError, RepositoryErrorMappingFailedError, RetryingTransactionScope, RollbackError, SnapshotCorruptedError, SnapshotSchemaMismatchError, SnapshotTimeValidationError, SnapshotVersionNotRestoredError, Specification, StateStoredAggregate, TransactionClosedError, UnenrolledChangesError, UnitOfWork, UnmanagedInstanceError, UnmintedEventError, UnprojectableEventError, UnregisteredHandlerError, UnreplayableAggregateError, ValueObject, analyzeDomainMachineDefinition, canTransitionDomainState, captureAggregateSnapshot, capturePersistenceBaseline, copyMetadata, createDomainEvent, createDomainEventFactory, createDomainEventFromFacts, createInitialDomainMachineSnapshot, createIntegrationMessage, createUncommittedDomainEvent, decodeIntegrationMessage, deepEqual, deepEqualExcept, deepFreeze, deepOmit, defaultDomainEventFactory, defineRepository, defineSnapshotModel, derivePersistenceChanges, detachState, domainErrorToResult, encodeIntegrationMessage, entityIds, eventBusSink, findEntityById, freezeShallow, hasEntityId, ignoreProjectionEvent, insertPersistenceBaseline, integrationMessageToCommittedEvent, isDomainErrorLike, isInfrastructureErrorLike, isPositionAfter, mergeMetadata, outboxWriterAcceptingEventLoss, persistenceProjectionDrifted, prepareDomainMachineDefinition, projectionFromHandlers, recapturePersistenceBaseline, reconstituteAggregateFromHistory, reconstituteAggregateFromSnapshot, recordDomainEvent, recordPendingEvents, removeEntityById, replaceEntityById, routeEventsToCommandOutbox, sameEntity, sameVersion, specification, toVersion, transitionDomainState, updateEntityById, vo, voEquals, voEqualsExcept, voValidated, voWithValidation, withCommit, withIdempotentCommit };
 //# sourceMappingURL=index.js.map