altcodepro-polydb-python 2.5.18__tar.gz → 2.5.20__tar.gz

{altcodepro_polydb_python-2.5.18/src/altcodepro_polydb_python.egg-info → altcodepro_polydb_python-2.5.20}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.5.18
+Version: 2.5.20
 Summary: Production-ready multi-cloud database abstraction layer with connection pooling, retry logic, and thread safety
 Author: AltCodePro
 Project-URL: Homepage, https://github.com/altcodepro/polydb-python

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "altcodepro-polydb-python"
-version = "2.5.18"
+version = "2.5.20"
 description = "Production-ready multi-cloud database abstraction layer with connection pooling, retry logic, and thread safety"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.11"

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20/src/altcodepro_polydb_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.5.18
+Version: 2.5.20
 Summary: Production-ready multi-cloud database abstraction layer with connection pooling, retry logic, and thread safety
 Author: AltCodePro
 Project-URL: Homepage, https://github.com/altcodepro/polydb-python

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/altcodepro_polydb_python.egg-info/SOURCES.txt

@@ -99,6 +99,7 @@ tests/test_azure_table_unpack_entity.py
 tests/test_blockchain.py
 tests/test_blockchain_overflow_guard.py
 tests/test_cloud_factory.py
+tests/test_factory_wiring.py
 tests/test_field_encryption.py
 tests/test_gcp.py
 tests/test_kafka.py
@@ -115,6 +116,7 @@ tests/test_postgresql.py
 tests/test_postgresql_deserialize_row.py
 tests/test_queue_extend_delay_cancel.py
 tests/test_rabbitmq.py
+tests/test_read_projection.py
 tests/test_redis_kv.py
 tests/test_schema_ddl_injection.py
 tests/test_secrets_aws.py

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/PolyDB.py

@@ -158,6 +158,8 @@ class PolyDB:
         cache_ttl: Optional[int] = None,
         include_deleted: bool = False,
         engine_override: Optional[EngineOverride] = None,
+        fields: Optional[List[str]] = None,
+        omit: Optional[List[str]] = None,
     ) -> List[JsonDict]:
         return self.db.read(
             model,
@@ -168,6 +170,8 @@ class PolyDB:
             cache_ttl=cache_ttl,
             include_deleted=include_deleted,
             engine_override=engine_override,
+            fields=fields,
+            omit=omit,
         )
 
     def read_one(

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/__init__.py

@@ -4,7 +4,7 @@ PolyDB - Enterprise Cloud-Independent Database Abstraction
 Full LINQ support, field-level audit, cache, soft delete, overflow storage
 """
 
-__version__ = "2.5.18"
+__version__ = "2.5.20"
 
 from .aio import AsyncDatabaseFactory, AsyncPolyDB
 from .audit.context import AuditContext

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/adapters/AzureTableStorageAdapter.py

@@ -633,9 +633,35 @@ class AzureTableStorageAdapter(NoSQLKVAdapter):
                 return None
             raise NoSQLError(f"Azure Table get failed: {str(e)}")
 
+    # `fields` / `omit` are sent to Azure as `$select`, so unrequested properties never leave the service.
+    SUPPORTS_SELECT_PUSHDOWN = True
+
+    def _select_properties(self, select: Optional[List[str]]) -> Optional[List[str]]:
+        """The Azure property names to `$select` for the requested field names -- the requested ones, plus what `_unpack_entity`
+        needs to rebuild a row (the keys, the model tag, and the sanitized-name map). A per-property blob overflow is stored in
+        the property itself, so selecting the property is enough for `_restore_overflow_properties`. None = no pushdown: if any
+        requested name is rewritten by `_sanitize_prop_name` (so its stored name could carry a collision suffix), the whole row is
+        fetched and trimmed afterwards instead of risking a silently missing column."""
+        if not select:
+            return None
+        props: List[str] = []
+        for name in select:
+            safe = self._sanitize_prop_name(name)
+            if safe != str(name):
+                return None
+            props.append(safe)
+        for needed in ("PartitionKey", "RowKey", _MODEL_FIELD, "__keymap__"):
+            if needed not in props:
+                props.append(needed)
+        return props
+
     @retry(max_attempts=3, delay=1.0, exceptions=(NoSQLError,))
     def _query_raw(
-        self, model: type, filters: Dict[str, Any], limit: Optional[int]
+        self,
+        model: type,
+        filters: Dict[str, Any],
+        limit: Optional[int],
+        select: Optional[List[str]] = None,
     ) -> List[JsonDict]:
         try:
             table_client = self._get_table_client(model)
@@ -685,7 +711,11 @@ class AzureTableStorageAdapter(NoSQLKVAdapter):
             else:
                 query_filter = " and ".join(parts)
 
-            entities = table_client.query_entities(query_filter=query_filter)
+            props = self._select_properties(select)
+            if props is None:
+                entities = table_client.query_entities(query_filter=query_filter)
+            else:
+                entities = table_client.query_entities(query_filter=query_filter, select=props)
 
             results: List[JsonDict] = []
             count = 0

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/adapters/DynamoDBAdapter.py

@@ -196,6 +196,13 @@ class DynamoDBAdapter(NoSQLKVAdapter):
     def _blob_key(self, model: type, pk: str, rk: str, checksum: str) -> str:
         return f"overflow/{self._table_name(model)}/{pk}/{rk}/{checksum}.json"
 
+    def _check_overflow(self, data: JsonDict):  # type: ignore[override]
+        """DynamoDB overflows inside `_put_raw` (`_maybe_overflow_to_s3`, into this adapter's own bucket), never in the
+        base class. The base whole-record overflow replaced the record with a stub pointing at a key in the separate
+        object store, which `_resolve_overflow` (it reads this adapter's bucket) can never find -- the record was lost
+        on read. Returning the data untouched leaves the one working path in charge."""
+        return data, None
+
     def _maybe_overflow_to_s3(
         self, model: type, pk: str, rk: str, payload: JsonDict
     ) -> Optional[JsonDict]:

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/adapters/PostgreSQLAdapter.py

@@ -487,8 +487,12 @@ class PostgreSQLAdapter:
         tx: Optional[Any] = None,
         *,
         session_vars: Optional[Dict[str, str]] = None,
+        fields: Optional[List[str]] = None,
     ) -> List[JsonDict]:
         table = validate_table_name(table)
+        if fields:
+            for f in fields:
+                validate_column_name(f)
         conn = tx
         own_conn = False
         if not conn:
@@ -498,7 +502,7 @@ class PostgreSQLAdapter:
         try:
             self._apply_session_vars(conn, session_vars)
             cursor = conn.cursor()
-            sql = f"SELECT * FROM {table}"
+            sql = f"SELECT {', '.join(fields)} FROM {table}" if fields else f"SELECT * FROM {table}"
             params: List[Any] = []
 
             if query:

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/base/NoSQLKVAdapter.py

@@ -17,9 +17,43 @@ if TYPE_CHECKING:
     from ..models import PartitionConfig
 
 
+def project_rows(
+    rows: List[JsonDict], fields: Optional[List[str]] = None, omit: Optional[List[str]] = None
+) -> List[JsonDict]:
+    """The exact `fields` / `omit` semantics every NoSQL read shares: `fields` keeps only those keys, `omit` drops those keys
+    (`fields` wins if both are given). Applied by the base `query()` AFTER overflow rehydration, so it is correct for every
+    adapter whether or not it also pushes the projection down to the store."""
+    if fields:
+        keep = set(fields)
+        return [{k: v for k, v in r.items() if k in keep} for r in rows]
+    if omit:
+        drop = set(omit)
+        return [{k: v for k, v in r.items() if k not in drop} for r in rows]
+    return rows
+
+
+def select_columns(
+    fields: Optional[List[str]], omit: Optional[List[str]], columns: Optional[List[str]]
+) -> Optional[List[str]]:
+    """The column list a store can be asked for: `fields` as given, or -- for `omit` -- the model's known `columns` minus the
+    omitted ones. None means "no column list can be derived" (no projection, or `omit` on a model whose columns are unknown):
+    the read then fetches whole rows and `project_rows` trims them."""
+    if fields:
+        return list(fields)
+    if omit and columns:
+        drop = set(omit)
+        return [c for c in columns if c not in drop]
+    return None
+
+
 class NoSQLKVAdapter:
     """Base with auto-overflow and LINQ support"""
 
+    # An adapter sets this True when its `_query_raw` accepts `select=[property names]` and really sends it to the store (Azure
+    # Table's `$select`). False (the default) means `fields`/`omit` are applied after the rows come back -- same result, no
+    # network saving. Opt in per adapter only once the adapter's own rehydration is proven to survive a narrowed row.
+    SUPPORTS_SELECT_PUSHDOWN = False
+
     def __init__(
         self,
         partition_config: Optional[PartitionConfig] = None,
@@ -242,16 +276,24 @@ class NoSQLKVAdapter:
         limit: Optional[int] = None,
         no_cache: bool = False,
         cache_ttl: Optional[int] = None,
+        fields: Optional[List[str]] = None,
+        omit: Optional[List[str]] = None,
     ) -> List[JsonDict]:
-        results = self._query_raw(model, query or {}, limit)
-        return [self._retrieve_overflow(r) for r in results]
+        select = select_columns(fields, omit, getattr(model, "__polydb__", {}).get("columns"))
+        if select is not None and self.SUPPORTS_SELECT_PUSHDOWN:
+            results = self._query_raw(model, query or {}, limit, select=select)
+        else:
+            results = self._query_raw(model, query or {}, limit)
+        return project_rows([self._retrieve_overflow(r) for r in results], fields, omit)
 
     def query_page(
         self, model: type, query: Lookup, page_size: int, continuation_token: Optional[str] = None
     ) -> Tuple[List[JsonDict], Optional[str]]:
         # Basic implementation - override per provider
         offset = int(continuation_token) if continuation_token else 0
-        results = self.query(model, query, limit=page_size + 1)
+        # Fetch through the end of THIS page (+1 to learn whether another follows) and drop what earlier pages already
+        # returned -- reading from the start every time made every page after the first a repeat of the first.
+        results = self.query(model, query, limit=offset + page_size + 1)[offset:]
 
         has_more = len(results) > page_size
         if has_more:

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/databaseFactory.py

@@ -19,12 +19,12 @@ from dataclasses import dataclass, field
 from datetime import datetime
 from typing import Any, Callable, Dict, List, Optional, Set, Tuple, Union
 
-from tenacity import retry, stop_after_attempt, wait_exponential
+from tenacity import retry, retry_if_exception, stop_after_attempt, wait_exponential
 
 from .adapters.PostgreSQLAdapter import PostgreSQLAdapter
 from .audit.context import AuditContext
 from .audit.manager import AuditManager
-from .base.NoSQLKVAdapter import NoSQLKVAdapter
+from .base.NoSQLKVAdapter import NoSQLKVAdapter, project_rows, select_columns
 from .batch import BatchOperations
 from .cache import CacheWarmer, RedisCacheEngine
 from .cloudDatabaseFactory import CloudDatabaseFactory
@@ -32,6 +32,7 @@ from .errors import AdapterConfigurationError
 from .models import PageRequest, PageResult
 from .monitoring import HealthCheck, MetricsCollector, PerformanceMonitor
 from .query import QueryBuilder
+from .retry import _is_non_retryable
 from .security import DataMasking, FieldEncryption
 from .types import JsonDict, Lookup, ModelMeta
 
@@ -53,6 +54,31 @@ _DEFAULT_RETRY = retry(
     reraise=True,
 )
 
+_TRANSIENT_MARKERS = (
+    "timeout", "timed out", "connection reset", "connection refused", "connection closed", "connection aborted",
+    "server closed the connection", "temporarily unavailable", "too many requests", "throttl", "service unavailable",
+    "serverbusy", "503", "could not connect",
+)
+
+
+def _is_transient(exc: BaseException) -> bool:
+    if _is_non_retryable(exc):
+        return False
+    if isinstance(exc, (ConnectionError, TimeoutError)):
+        return True
+    s = str(exc).lower()
+    return any(m in s for m in _TRANSIENT_MARKERS)
+
+
+def _TRANSIENT_RETRY(fn):
+    return retry(
+        retry=retry_if_exception(_is_transient),
+        wait=wait_exponential(multiplier=0.5, min=0.5, max=6),
+        stop=stop_after_attempt(3),
+        reraise=True,
+    )(fn)
+
+
 _UNIQUE_VIOLATION_MARKERS = (
     "23505",  # Postgres SQLSTATE
     "duplicate key value violates",  # Postgres message
@@ -140,6 +166,7 @@ def _extract_meta(model: Union[type, str]) -> ModelMeta:
                 provider=raw.get("provider"),
                 cache=raw.get("cache", False),
                 cache_ttl=raw.get("cache_ttl"),
+                encrypted_fields=tuple(raw.get("encrypted_fields") or ()),
             )
     return ModelMeta(storage="nosql", table=None, collection=None)
 
@@ -348,7 +375,42 @@ class DatabaseFactory:
         return result
 
     def _run(self, fn: Callable[[], Any]) -> Any:
-        return fn()
+        """Run one storage operation, retrying only TRANSIENT failures (connection loss, timeouts, throttling) with
+        exponential backoff when retries are enabled. Constraint violations, bad arguments and anything the retry
+        classifier marks non-retryable are raised at once -- a retry could not change their outcome."""
+        if not self._enable_retries:
+            return fn()
+        return _TRANSIENT_RETRY(fn)()
+
+    def _audit_write(
+        self, action: str, name: str, meta: ModelMeta, entity_id: Any, success: bool,
+        before: Optional[JsonDict], after: Optional[JsonDict], error: Optional[str],
+    ) -> None:
+        """Record a write in the audit log. Never raises: an audit failure must not turn a completed write into an
+        error. Encrypted fields are masked so the log never holds their plaintext."""
+        if not (self._enable_audit and self._audit):
+            return
+
+        def _mask(row: Optional[JsonDict]) -> Optional[JsonDict]:
+            if not row or not meta.encrypted_fields:
+                return row
+            return {k: ("[encrypted]" if k in meta.encrypted_fields else v) for k, v in row.items()}
+
+        try:
+            before_m, after_m = _mask(before), _mask(after)
+            changed = (
+                sorted(k for k in set(after_m or {}) | set(before_m or {}) if (before_m or {}).get(k) != (after_m or {}).get(k))
+                if before_m is not None and after_m is not None else None
+            )
+            if isinstance(entity_id, dict):
+                entity_id = entity_id.get("id")
+            self._audit.record(
+                action=action, model=name, entity_id=None if entity_id is None else str(entity_id),
+                storage_type=meta.storage, provider=meta.provider or "default", success=success,
+                before=before_m, after=after_m, error=error, changed_fields=changed,
+            )
+        except Exception as exc:  # noqa: BLE001
+            logger.warning("Audit write failed (non-fatal): %s", exc)
 
     def _is_sql(self, meta: ModelMeta, override: Optional[EngineOverride] = None) -> bool:
         if override and override.force_sql:
@@ -432,9 +494,12 @@ class DatabaseFactory:
                 with monitor as m:
                     result = self._run(_op)
                     m.rows_affected = 1
-                    return result
-            return self._run(_op)
-        except Exception:
+            else:
+                result = self._run(_op)
+            self._audit_write("create", name, meta, entity_id, True, None, after_plain, None)
+            return result
+        except Exception as exc:
+            self._audit_write("create", name, meta, entity_id, False, None, None, str(exc))
             raise
 
     # ──────────────────────────────────────────────────────────
@@ -453,43 +518,83 @@ class DatabaseFactory:
         include_deleted: bool = False,
         engine_override: Optional[EngineOverride] = None,
         session_vars: Optional[Dict[str, str]] = None,
+        fields: Optional[List[str]] = None,
+        omit: Optional[List[str]] = None,
     ) -> List[JsonDict]:
+        """`fields` returns only those keys; `omit` returns every key except those (`fields` wins if both are given). SQL
+        names the columns in the SELECT; NoSQL adapters that can ($select on Azure Table) send the property list to the store,
+        the rest trim the rows after the read -- same result either way. `omit` needs the model's `__polydb__["columns"]` to
+        be turned into a column list for the store; without it the whole row is fetched and trimmed. A projected read never
+        goes through the external cache (its key does not include the projection)."""
         name = _model_name(model)
         meta = _extract_meta(model)
+        columns = (getattr(model, "__polydb__", None) or {}).get("columns") if isinstance(model, type) else None
+        projected = bool(fields or omit)
+        sql_columns = select_columns(fields, omit, columns)
 
+        drop_deleted = False
         if self._soft_delete and not include_deleted:
-            query = self._apply_soft_delete_filter(query)
+            if self._is_sql(meta, engine_override):
+                query = self._apply_soft_delete_filter(query)
+            else:
+                # A NoSQL equality filter on `deleted_at = None` matches nothing when the attribute was never written
+                # (Azure Table, DynamoDB), so filter the returned rows instead.
+                drop_deleted = True
 
         adapters = self._adapters_for(model, meta, engine_override)
-        use_external_cache = self._enable_cache and self._cache and getattr(meta, "cache", False)
+        use_external_cache = (
+            self._enable_cache and self._cache and getattr(meta, "cache", False) and not projected
+        )
         encrypted_fields = getattr(meta, "encrypted_fields", [])
+        # The cache key must cover everything that changes the result: the query, the window, and the session variables
+        # (e.g. the tenant a row-level-security policy filters by) -- otherwise two callers share an entry.
+        cache_key_query = {
+            "q": query or {}, "limit": limit, "offset": offset,
+            "sv": sorted((session_vars or {}).items()), "e": bool(engine_override),
+        }
 
         def _op() -> List[JsonDict]:
             if self._is_sql(meta, engine_override):
-                raw = adapters.sql.select(
-                    meta.table, query, limit=limit, offset=offset, session_vars=session_vars
-                )
+                if sql_columns is not None:
+                    raw = adapters.sql.select(
+                        meta.table, query, limit=limit, offset=offset,
+                        session_vars=session_vars, fields=sql_columns,
+                    )
+                else:
+                    raw = adapters.sql.select(
+                        meta.table, query, limit=limit, offset=offset, session_vars=session_vars
+                    )
+                    raw = project_rows(raw, fields, omit)
             else:
                 cls = (
                     model
                     if isinstance(model, type)
                     else type(name, (), {"__polydb__": meta.__dict__})
                 )
+                nosql_kwargs: Dict[str, Any] = {}
+                if projected:
+                    nosql_kwargs = {"fields": fields, "omit": omit}
+                skip = offset or 0
                 raw = adapters.nosql.query(
-                    cls, query=query, limit=limit, no_cache=no_cache or bool(use_external_cache)
+                    cls, query=query, limit=(limit + skip) if limit else None,
+                    no_cache=no_cache or bool(use_external_cache), **nosql_kwargs,
                 )
+                if skip:
+                    raw = raw[skip:]  # NoSQL adapters take no offset: read through it, then drop the skipped rows
+            if drop_deleted:
+                raw = [r for r in raw if not r.get("deleted_at")]
             if self.encryption and encrypted_fields:
                 raw = [self.encryption.decrypt_fields(r, encrypted_fields) for r in raw]
             if self._cache and use_external_cache and not no_cache:
                 ttl = cache_ttl or getattr(meta, "cache_ttl", 300)
                 try:
-                    self._cache.set(name, query or {}, raw, ttl)
+                    self._cache.set(name, cache_key_query, raw, ttl)
                 except Exception as _ce:
                     logger.warning("Cache set failed (non-fatal): %s", _ce)
             return raw
 
         if self._cache and use_external_cache and not no_cache:
-            cached = self._cache.get(name, query or {})
+            cached = self._cache.get(name, cache_key_query)
             if cached is not None:
                 return cached
 
@@ -654,9 +759,12 @@ class DatabaseFactory:
                 with monitor as m:
                     result = self._run(_op)
                     m.rows_affected = 1
-                    return result
-            return self._run(_op)
-        except Exception:
+            else:
+                result = self._run(_op)
+            self._audit_write("update", name, meta, entity_id, True, before, after_plain, None)
+            return result
+        except Exception as exc:
+            self._audit_write("update", name, meta, entity_id, False, before, None, str(exc))
             raise
 
     # ──────────────────────────────────────────────────────────
@@ -714,9 +822,12 @@ class DatabaseFactory:
                 with monitor as m:
                     result = self._run(_op)
                     m.rows_affected = 1
-                    return result
-            return self._run(_op)
-        except Exception:
+            else:
+                result = self._run(_op)
+            self._audit_write("upsert", name, meta, (after_plain or {}).get('id'), True, None, after_plain, None)
+            return result
+        except Exception as exc:
+            self._audit_write("upsert", name, meta, None, False, None, None, str(exc))
             raise
 
     # ──────────────────────────────────────────────────────────
@@ -827,9 +938,12 @@ class DatabaseFactory:
                 with monitor as m:
                     result = self._run(_op)
                     m.rows_affected = 1
-                    return result
-            return self._run(_op)
-        except Exception:
+            else:
+                result = self._run(_op)
+            self._audit_write("delete", name, meta, entity_id, True, before, None, None)
+            return result
+        except Exception as exc:
+            self._audit_write("delete", name, meta, entity_id, False, before, None, str(exc))
             raise
 
     # ──────────────────────────────────────────────────────────
@@ -883,8 +997,12 @@ class DatabaseFactory:
         name = _model_name(model)
         meta = _extract_meta(model)
 
+        drop_deleted = False
         if self._soft_delete and not include_deleted:
-            query = self._apply_soft_delete_filter(query)
+            if self._is_sql(meta, engine_override):
+                query = self._apply_soft_delete_filter(query)
+            else:
+                drop_deleted = True
 
         adapters = self._adapters_for(model, meta, engine_override)
         encrypted_fields = getattr(meta, "encrypted_fields", [])
@@ -901,6 +1019,8 @@ class DatabaseFactory:
                     else type(name, (), {"__polydb__": meta.__dict__})
                 )
                 raw, token = adapters.nosql.query_page(cls, query, page_size, continuation_token)
+                if drop_deleted:
+                    raw = [r for r in raw if not r.get("deleted_at")]
             if self.encryption and encrypted_fields:
                 raw = [self.encryption.decrypt_fields(r, encrypted_fields) for r in raw]
             return raw, token

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/schema.py

@@ -131,6 +131,27 @@ class SchemaBuilder:
 
         return sql
 
+    def to_add_missing_columns(self, table_name: str) -> List[str]:
+        """`ALTER TABLE ... ADD COLUMN IF NOT EXISTS` for every non-key column. `CREATE TABLE IF NOT EXISTS` never adds a
+        column that was declared after the table was first created; appending these to the same migration makes an edited
+        column list reach existing tables. Added columns are always nullable (existing rows have no value) and never
+        UNIQUE; a declared default is kept."""
+        validate_table_name(table_name)
+        keys = set(self.primary_keys or [])
+        out: List[str] = []
+        for col in self.columns:
+            if col.name in keys or col.primary_key:
+                continue
+            parts = [validate_column_name(col.name)]
+            if col.type == ColumnType.VARCHAR and col.max_length:
+                parts.append(f"VARCHAR({col.max_length})")
+            else:
+                parts.append(col.type.value)
+            if col.default is not None:
+                parts.append(_render_default(col.default))
+            out.append(f"ALTER TABLE {table_name} ADD COLUMN IF NOT EXISTS {' '.join(parts)};")
+        return out
+
     def to_create_indexes(self, table_name: str) -> List[str]:
         """Generate CREATE INDEX statements"""
         statements = []
@@ -185,15 +206,31 @@ class MigrationManager:
 
         # Check if already applied
         existing = self.sql.execute(
-            "SELECT version FROM polydb_migrations WHERE version = %s", [version], fetch_one=True
+            "SELECT version, checksum FROM polydb_migrations WHERE version = %s", [version], fetch_one=True
         )
 
-        if existing:
-            return False
-
         # Calculate checksum
         checksum = hashlib.sha256(up_sql.encode()).hexdigest()
 
+        if existing:
+            stored = existing.get("checksum") if isinstance(existing, dict) else None
+            if not stored or stored == checksum:
+                return False
+            # The DDL under this version was edited (a column added, an index changed). Re-apply it -- the statements
+            # this codebase generates are idempotent (IF NOT EXISTS) -- and remember the new checksum. A failure here
+            # must not stop a deployment from starting: keep the old checksum so the next start tries again.
+            try:
+                self.sql.execute(up_sql)
+                self.sql.execute(
+                    "UPDATE polydb_migrations SET checksum = %s WHERE version = %s", [checksum, version]
+                )
+                return True
+            except Exception as exc:  # noqa: BLE001
+                import logging
+
+                logging.getLogger(__name__).warning("Re-applying edited migration %s failed (kept old): %s", version, exc)
+                return False
+
         try:
             # Execute migration
             self.sql.execute(up_sql)

{altcodepro_polydb_python-2.5.18 → altcodepro_polydb_python-2.5.20}/src/polydb/types.py

@@ -24,6 +24,8 @@ class ModelMeta:
     provider: Optional[str] = None
     cache: bool = False
     cache_ttl: Optional[int] = None
+    # Fields stored encrypted when the factory has encryption enabled (a tuple: the dataclass is frozen/hashable).
+    encrypted_fields: Tuple[str, ...] = ()
 
 
 @runtime_checkable