Revert "Codex/fix bling response validation"

CHANGELOG.md

@@ -7,13 +7,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [0.3.2] - 2026-10-07
-
-### Fixed
-
-- Tracking timestamps in logistics objects and shipment objects now accept offset-free Bling values through the generated `BlingDatetime` type. Naive timestamps use `America/Sao_Paulo` (including historical daylight saving time); explicit offsets are preserved, and JSON serialization emits an ISO timestamp with its offset. The generator and shared model namespace use the same type, with portable timezone data supplied by `tzdata`.
-- Tracking dates now normalize MySQL zero-date sentinels, empty strings and null to `None`, matching absent-date handling in `BlingDate`. This fixes a second failure confirmed in read-only live logistics objects. Other malformed dates still raise validation errors; the tracking timestamp key remains required, and unrelated DTO requirements are unchanged.
-
 ## [0.3.1] - 2026-10-06
 
 ### Fixed

docs/getting-started.md

@@ -114,23 +114,6 @@ with BlingClient.from_env() as client:
         print(contato.get("data", {}).get("nome"))
 ```
 
-### Datas de rastreamento
-
-Os campos `rastreamento.ultima_alteracao` de objetos e remessas usam
-`BlingDatetime`. Datas sem fuso, como `"2026-10-07 11:24:02"`, são interpretadas
-no fuso IANA `America/Sao_Paulo`, incluindo suas regras históricas de horário
-de verão. Datas que já possuem fuso mantêm o offset informado pelo Bling.
-Na serialização JSON, o resultado inclui o offset:
-`"2026-10-07T11:24:02-03:00"`. A dependência `tzdata` fornece essas regras
-também em sistemas sem uma base de fusos instalada.
-
-Sentinelas de data ausente (`"0000-00-00 00:00:00"`, `"0000-00-00"`,
-`"0001-01-01"`, `"0001-01-01 00:00:00"`), strings vazias e `null` são
-representadas por `None`. `model_dump(mode="json")` preserva `null`;
-`to_json_object()` omite esses valores. Outras datas malformadas continuam
-causando erro de validação, e a chave `ultimaAlteracao` continua obrigatória
-no objeto de rastreamento.
-
 ### Paginação
 
 Endpoints de listagem aceitam `page` e `limit`:

mkdocs.yml

@@ -64,7 +64,6 @@ nav:
   - Autenticação: authentication.md
   - Paginação: pagination.md
   - Erros: errors.md
-  - Validação de respostas: response-validation-audit.md
   - Recursos:
       - resources/sales_orders.md
       - resources/products.md

pyproject.toml

@@ -24,7 +24,6 @@ dependencies = [
     "pydantic>=2.13.4,<3.0.0",
     "pydantic-settings>=2.14.1,<3.0.0",
     "python-dotenv>=1.2.2,<2.0.0",
-    "tzdata>=2025.2",
 ]
 
 [project.urls]

scripts/generate_models.py

@@ -117,8 +117,8 @@
 )
 BUILTIN_TYPE_NAMES = {
     "Any",
+    "AwareDatetime",
     "BlingDate",
-    "BlingDatetime",
     "BlingModel",
     "Field",
     "None",
@@ -181,7 +181,7 @@
 
 # Type that replaces bare ``date`` in all generated annotations.
 DATE_TYPE_REWRITE = "BlingDate"
-DATE_IMPORT = "from bling_erp_api.models.fields import BlingDate, BlingDatetime"
+DATE_IMPORT = "from bling_erp_api.models.fields import BlingDate"
 
 # ``Field(...)`` keywords that affect the wire format. Inserted redeclarations
 # of parent-inherited fields only clone the parent's ``Field(...)`` call when
@@ -604,10 +604,10 @@ def _schema_module_content(
         "",
         "from __future__ import annotations",
         "",
-        DATE_IMPORT,
+        "from bling_erp_api.models.fields import BlingDate",
         "from typing import TYPE_CHECKING, Any",
         "",
-        "from pydantic import AliasChoices, Field, RootModel",
+        "from pydantic import AliasChoices, AwareDatetime, Field, RootModel",
         "",
         "from bling_erp_api.models.base import BlingModel",
     ]
@@ -653,9 +653,11 @@ def _schema_init_content(
         "",
         "from __future__ import annotations",
         "",
-        DATE_IMPORT,
+        "from bling_erp_api.models.fields import BlingDate",
         "from typing import Any",
         "",
+        "from pydantic import AwareDatetime",
+        "",
     ]
     for module, names in sorted(by_module.items()):
         imports = ", ".join(names)
@@ -669,7 +671,7 @@ def _schema_init_content(
             exports + "]",
             "",
             "_MODEL_NAMESPACE = {name: globals()[name] for name in __all__}",
-            "_MODEL_NAMESPACE.update({'Any': Any, 'BlingDate': BlingDate, 'BlingDatetime': BlingDatetime})",
+            "_MODEL_NAMESPACE.update({'Any': Any, 'AwareDatetime': AwareDatetime, 'BlingDate': BlingDate})",
             "for _model in _MODEL_NAMESPACE.values():",
             "    if isinstance(_model, type) and hasattr(_model, 'model_rebuild'):",
             "        _model.model_rebuild(_types_namespace=_MODEL_NAMESPACE)",
@@ -910,11 +912,10 @@ def _remove_pass_if_empty(node: ast.ClassDef) -> None:
 
 
 def _rewrite_date_types(node: ast.ClassDef) -> None:
-    """Use Bling date and datetime parsing in generated field annotations."""
-    replacements = {"date": "BlingDate", "AwareDatetime": "BlingDatetime"}
+    """Replace ``date`` with ``BlingDate`` in all field annotations."""
     for stmt in ast.walk(node):
-        if isinstance(stmt, ast.Name) and stmt.id in replacements:
-            stmt.id = replacements[stmt.id]
+        if isinstance(stmt, ast.Name) and stmt.id == "date":
+            stmt.id = "BlingDate"
 
 
 def _inherited_field_value(parent_decl: ast.AnnAssign | None, field_name: str) -> ast.expr:

src/bling_erp_api/_version.py

@@ -1,3 +1,3 @@
 """Package version."""
 
-__version__ = "0.3.2"
+__version__ = "0.3.1"

src/bling_erp_api/models/fields.py

@@ -2,11 +2,9 @@
 
 from __future__ import annotations
 
-from datetime import date, datetime
+from datetime import date
 from typing import Annotated
-from zoneinfo import ZoneInfo
 
-from pydantic import AfterValidator, BeforeValidator
 from pydantic.functional_serializers import PlainSerializer
 from pydantic.functional_validators import PlainValidator
 
@@ -46,37 +44,3 @@ def _serialize_bling_date(value: date | None) -> str | None:
     PlainValidator(_parse_bling_date),
     PlainSerializer(_serialize_bling_date, return_type=str | None, when_used="json"),
 ]
-
-
-def _normalize_bling_datetime(value: object) -> object:
-    """Map Bling's absent timestamp sentinels to None before datetime parsing."""
-    if isinstance(value, str):
-        stripped = value.strip()
-        if not stripped or stripped in {
-            "0000-00-00",
-            "0000-00-00 00:00:00",
-            "0001-01-01",
-            "0001-01-01 00:00:00",
-        }:
-            return None
-        return stripped
-    return value
-
-
-def _localize_bling_datetime(value: datetime | None) -> datetime | None:
-    """Interpret offset-free Bling timestamps in America/Sao_Paulo.
-
-    Preserve explicit offsets and use the IANA timezone rules for naive values,
-    including historical daylight saving time. Invalid timestamps still fail
-    Pydantic's normal datetime validation before this validator is called.
-    """
-    if value is not None and (value.tzinfo is None or value.utcoffset() is None):
-        return value.replace(tzinfo=ZoneInfo("America/Sao_Paulo"))
-    return value
-
-
-BlingDatetime = Annotated[
-    datetime | None,
-    BeforeValidator(_normalize_bling_datetime),
-    AfterValidator(_localize_bling_datetime),
-]

src/bling_erp_api/models/generated/schemas/__init__.py

@@ -4,9 +4,11 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import Any
 
+from pydantic import AwareDatetime
+
 from .anuncios import (
     AnunciosAtributoDTO,
     AnunciosCategoriaDTO,
@@ -1482,7 +1484,7 @@
 ]
 
 _MODEL_NAMESPACE = {name: globals()[name] for name in __all__}
-_MODEL_NAMESPACE.update({"Any": Any, "BlingDate": BlingDate, "BlingDatetime": BlingDatetime})
+_MODEL_NAMESPACE.update({"Any": Any, "AwareDatetime": AwareDatetime, "BlingDate": BlingDate})
 for _model in _MODEL_NAMESPACE.values():
     if isinstance(_model, type) and hasattr(_model, "model_rebuild"):
         _model.model_rebuild(_types_namespace=_MODEL_NAMESPACE)

src/bling_erp_api/models/generated/schemas/anuncios.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/anuncios_categorias.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/borderos.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/caixas_bancos.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/calculos_impostos.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/campos_customizados.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/canais_venda.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/categorias_lojas.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/categorias_produtos.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel
 

src/bling_erp_api/models/generated/schemas/categorias_receitas_despesas.py

@@ -4,10 +4,10 @@
 
 from __future__ import annotations
 
-from bling_erp_api.models.fields import BlingDate, BlingDatetime
+from bling_erp_api.models.fields import BlingDate
 from typing import TYPE_CHECKING, Any
 
-from pydantic import AliasChoices, Field, RootModel
+from pydantic import AliasChoices, AwareDatetime, Field, RootModel
 
 from bling_erp_api.models.base import BlingModel