@classytic/repo-core 0.12.0 → 0.13.0

package/dist/repository/types.d.mts

@@ -344,7 +344,7 @@ interface ClaimTransition {
 }
 /**
  * Structural contract for the state machine consumed by
- * `StandardRepo.transition()` — the CANONICAL shape; mongokit's
+ * `StandardRepo.applyTransition()` — the CANONICAL shape; mongokit's
  * `TransitionMachine` and primitives' `StateMachine` (from
  * `@classytic/primitives/state-machine`, whose `defineStateMachine()`
  * satisfies it as-is) are structurally identical by design. Neither
@@ -361,7 +361,7 @@ interface TransitionMachine {
   assertTransition(entityId: string, from: string, to: string): void;
 }
 /**
- * Args for `StandardRepo.transition()` — the state-machine-backed CAS
+ * Args for `StandardRepo.applyTransition()` — the state-machine-backed CAS
  * with status history. See the method JSDoc for semantics.
  */
 interface TransitionArgs {
@@ -373,6 +373,10 @@ interface TransitionArgs {
   set?: Record<string, unknown>;
   /** Kit-specific extra append entries merged beside the history append. */
   push?: Record<string, unknown>;
+  /** Counter increments applied alongside the state write. */
+  inc?: Record<string, number>;
+  /** Field paths cleared alongside the state write. */
+  unset?: Record<string, unknown>;
   /** Additional CAS guards, AND-merged into the match (same as `ClaimTransition.where`). */
   where?: Record<string, unknown>;
   by?: string;
@@ -1452,7 +1456,7 @@ interface StandardRepo<TDoc> extends MinimalRepo<TDoc> {
   claimVersion(id: string, transition: ClaimVersionTransition, update: Record<string, unknown>, options?: WriteOptions): Promise<TDoc | null>;
   /**
    * State-machine-backed CAS transition with status history — the
-   * canonical domain-verb shape (mongokit 3.22 `Repository.transition`).
+   * canonical domain-verb shape (mongokit 3.22 `Repository.applyTransition`).
    * One call: machine legality pre-flight (the machine throws the
    * DOMAIN's typed error), CAS via `claim`, appended history entry
    * (`{ status: to, occurredAt, by?, note? }` onto `args.history` /
@@ -1470,7 +1474,7 @@ interface StandardRepo<TDoc> extends MinimalRepo<TDoc> {
    * required once sqlitekit implements it (SQL kits compile the
    * history append to their JSON-array/audit-table strategy).
    */
-  transition?(id: string, machine: TransitionMachine, args: TransitionArgs, options?: WriteOptions): Promise<TDoc>;
+  applyTransition?(id: string, machine: TransitionMachine, args: TransitionArgs, options?: WriteOptions): Promise<TDoc>;
   /**
    * Classify an error from a write as a unique-constraint violation.
    * Arc's idempotency + outbox adapters need this to distinguish

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classytic/repo-core",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Driver-agnostic repository primitives: hooks, Filter IR, operations, pagination, cache contract. Foundation for mongokit, sqlitekit, pgkit, and prismakit. Lean by design — no plugins ship here; each kit owns its own.",
   "type": "module",
   "sideEffects": false,