feat(mutate): support returning patches

README.md

@@ -68,6 +68,14 @@ test('base - mutate with error', () => {
 });
 ```
 
+## APIs
+
+### `mutate()`
+Mutate the mutable object
+
+### `apply()`
+Apply the mutable update with patches
+
 ## License
 
 Mutability is [MIT licensed](https://github.com/mutativejs/mutability/blob/main/LICENSE).

src/apply.ts

@@ -1,6 +1,9 @@
 import { DraftType, Operation, Patches } from './interface';
 import { deepClone, get, getType, unescapePath } from './utils';
 
+/**
+ * Apply patches to the state.
+ */
 export function apply(state: any, patches: Patches) {
   let i;
   for (i = patches.length - 1; i >= 0; i -= 1) {

src/index.ts

@@ -1,6 +1,8 @@
 import { create } from 'mutative';
 import { apply } from './apply';
 
+export { apply } from './apply';
+
 /**
  * Transactional updates to the base state with the recipe.
  */
@@ -9,4 +11,5 @@ export const mutate = <T>(baseState: T, recipe: (state: T) => void) => {
     enablePatches: true,
   });
   apply(baseState, patches);
+  return patches;
 };