docs(*): update v2-v3-migration guide

Author: Michael Wittwer

src/aws-sdk-v2.types.ts

@@ -14,7 +14,7 @@ export type AttributeMap = { [key: string]: AttributeValue }
 
 export type Key = { [key: string]: AttributeValue }
 
-// FIXME somehow the import of KeyType from @aws-sdk/client-dynamodb does not work at runtime
+// TODO v3: somehow the import of KeyType from @aws-sdk/client-dynamodb does not work at runtime
 export enum KeyType {
   HASH = 'HASH',
   RANGE = 'RANGE',

v2-v3-migration.md

@@ -1,20 +1,21 @@
-# Migrate dynamo-easy to sdk v3
+# Migrate dynamo-easy to aws-sdk v3
 
-## To complete before releasing
-- [ ] Update demo
-- [ ] Update doc with new snippets
+## 📋 To complete before releasing
+- [x] Make sure the snippets compile
+- [x] Make tests compile and run successfully
+- [ ] Search for `TODO v3:` in the code to see open issues / notes, and create followup issues to decide if we have more to fix prior to a major release or keep it for later follow-up
+- [ ] Check on new attribute type [$UnknownAttribute](./src/mapper/type/attribute.type.ts) and implement tests
+- [ ] Remove [sessionValidityEnsurer](./src/config/dynamo-easy-config.ts) and add demo with using [middleware stack](https://github.com/aws/aws-sdk-js-v3#middleware-stack)
+  to implement the same
+  - [ ] The old behavior (sessionValidityEnsurer) was executed before every request, with the new implementation we
+    only react to failing requests, so we should probably provide a way to automatically retry failed requests after
+    successfully refreshing any invalid session.
+- [ ] Switch to new implementation of pagination, see [official doc](https://github.com/aws/aws-sdk-js-v3#paginators).
+- [ ] Use middleware stack to implement verbose logging of request / response data
+- [ ] Update [dynamo-easy-demo](https://github.com/shiftcode/dynamo-easy-demo) see [this](https://github.com/shiftcode/dynamo-easy-demo/issues/1) issue
 
 ## Useful Links
 
 - [Doc in Repo](https://github.com/aws/aws-sdk-js-v3)
 - [Official migration Guide](https://github.com/aws/aws-sdk-js-v3/blob/main/UPGRADING.md)
 
-## Todo
-Search for `TODO v3:` to see open issues / notes, here are some more general ones:
-- [x] Make sure the snippets compile
-- [ ] Check on new attribute type [$UnknownAttribute](./src/mapper/type/attribute.type.ts) and implement tests
-- [ ] Add new [demo](https://github.com/shiftcode/dynamo-easy-demo) with aws-cdk
-- [x] Make tests compile and run successfully
-- [ ] Remove [sessionValidityEnsurer](./src/config/dynamo-easy-config.ts) and add demo with using [middleware stack](https://github.com/aws/aws-sdk-js-v3#middleware-stack) 
-to implement the same
-- [ ] Switch to new implementation of pagination, see [official doc](https://github.com/aws/aws-sdk-js-v3#paginators).