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

package/dist/chunks/snapshot-store.d.ts

@@ -931,9 +931,11 @@ interface AggregateSnapshot<TState> {
  * part of this surface. The application shell holds that authority.
  *
  * @template TId    - The aggregate root identifier (branded via `Id<Tag>`)
- * @template TEvent - The domain-event union, defaults to `never`
+ * @template TEvent - The domain-event union. Defaults to `AnyDomainEvent`,
+ *   so a bound written as `Aggregate<TId>` admits every aggregate root,
+ *   with or without events.
  */
-interface Aggregate<TId extends Id<string>, TEvent extends AnyDomainEvent = never> {
+interface Aggregate<TId extends Id<string>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
   readonly id: TId;
   readonly version: Version;
   readonly pendingEvents: ReadonlyArray<PendingDomainEvent<TEvent>>;

package/dist/index.d.ts

@@ -1533,6 +1533,12 @@ interface RepositoryTracking<TAggregate extends Aggregate<Id<string>, AnyDomainE
  * the exact moment at which the application registered its write intent.
  * Adapters must use the expected/current version pair for their OCC predicate
  * and must not read mutable write state back from an aggregate reference.
+ *
+ * The predicate itself is adapter code. The compare-and-set must run in the
+ * store's own write statement. The kit does not know the store, so it cannot
+ * write that statement. The kit owns the version pair and
+ * {@link ConcurrencyConflictError}; the repository contract suite proves the
+ * predicate.
  */
 interface AggregatePersistenceWrite<TAggregate extends Aggregate<Id<string>, AnyDomainEvent>, TChangeSet> {
   readonly intent: AggregateWriteIntent;
@@ -1731,7 +1737,12 @@ interface RunOptions {
 declare const repositoryDefinitionBrand: unique symbol;
 /** Adapter wiring accepted by {@link defineRepository}. */
 interface RepositoryDefinitionOptions<TCtx, TRepositoryPort extends object, TAggregate extends Aggregate<Id<string>, AnyDomainEvent>, TBaseline, TChangeSet, TRemoval extends boolean = false> {
-  /** Concrete aggregate class used as the Identity Map key. */
+  /**
+   * Concrete aggregate class used as the Identity Map key, and for nothing
+   * else. The read adapter passes the same class to `identityMap.get`, so
+   * the class is exported. Its protected constructor keeps `new` out of
+   * reach; the static factories stay the only door.
+   */
   readonly aggregate: AggregateClass<TAggregate>;
   /** Adapter-owned projection, baseline, and change-set policy. */
   readonly persistence: PersistenceModel<TAggregate, TBaseline, TChangeSet>;
@@ -4017,7 +4028,7 @@ declare class InMemoryEventStore<Evt extends AnyDomainEvent> implements EventSto
  * @template TAggregate - Aggregate root loaded and registered by the port.
  * @template TId - Branded aggregate identifier.
  */
-interface AggregatePersistence<TAggregate extends Aggregate<TId>, TId extends Id<string>> {
+interface AggregatePersistence<TAggregate extends Aggregate<TId, AnyDomainEvent>, TId extends Id<string>> {
   /**
    * Finds an aggregate by identity.
    *
@@ -4066,7 +4077,7 @@ interface AggregatePersistence<TAggregate extends Aggregate<TId>, TId extends Id
  * by an order command, while read-heavy access remains on a projection or query
  * port.
  */
-interface Repository<TAggregate extends Aggregate<TId>, TId extends Id<string>> extends AggregatePersistence<TAggregate, TId> {
+interface Repository<TAggregate extends Aggregate<TId, AnyDomainEvent>, TId extends Id<string>> extends AggregatePersistence<TAggregate, TId> {
   /**
    * Registers a tracked aggregate for physical removal at commit.
    *