feat: Annotate DynamoDB schemas with validation code

[khvn26]

In this PR, we annotate DynamoDB schema types to enable their usage with Pydantic, when it's available.

It is now possible to use the document typed dicts with pydantic.TypeAdapter like so:

import json

from pydantic import TypeAdapter

from flagsmith_schemas.dynamodb import Identity

# Produce a ready to persist Dynamo document
TypeAdapter(Identity).validate_python(json.load(open("tests/integration/flagsmith_schemas/data/flagsmith_identities.json")))

The TypeAdapter will:

• Validate if a feature state value string value length exceeds 20k characters.
• Validate UUID strings, accepting both string and uuid.UUID values.
• Validate datetime strings, accepting both string and datetime.datetime values.
• Raise an error for multivariate feature states with total percentage_allocation higher than 100.
• Raise an error when an identity document contains non-unique feature IDs.

The validation is intended to be used in Core API, when writing documents.

If pydantic not present, the schemas can still be used as plain typed dicts, i.e. to annotate data returned from DynamoDB.

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 95.48%. Comparing base (9f9518b) to head (b08502f).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #148      +/-   ##
==========================================
+ Coverage   95.32%   95.48%   +0.15%     
==========================================
  Files          79       83       +4     
  Lines        2673     2767      +94     
==========================================
+ Hits         2548     2642      +94     
  Misses        125      125              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Zaimwa9]

Approving with 2 NITs:

• The naming might be quite subjective
• The nested loop could be a low hanging fruit to solve now and buy some tranquility