altcodepro-polydb-python 2.5.11__py3-none-any.whl → 2.5.18__py3-none-any.whl

{altcodepro_polydb_python-2.5.11.dist-info → altcodepro_polydb_python-2.5.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: altcodepro-polydb-python
-Version: 2.5.11
+Version: 2.5.18
 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.11.dist-info → altcodepro_polydb_python-2.5.18.dist-info}/RECORD

@@ -1,6 +1,6 @@
-altcodepro_polydb_python-2.5.11.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
+altcodepro_polydb_python-2.5.18.dist-info/licenses/LICENSE,sha256=9X8GLocsBwy-5aR5JGOt2SAMDDPs9Qv-YnqmHBHOXrw,1067
 polydb/PolyDB.py,sha256=_6YaeX7-9G9fK6hj4I-JbsfdVIwAotx7E_4IJqdGcjQ,23536
-polydb/__init__.py,sha256=pQrfRlbXkMQyaRZuHlNrJEhVArOQADemoXqFQYxqq1c,1876
+polydb/__init__.py,sha256=p9dAWJ3-JNCeHgb1WzkTMkuURFQy-RUNI4QeD9zBVf0,1876
 polydb/advanced_query.py,sha256=M9sKmdF2PsLZWSc-zKpXRcwaDumbYYTsibmL_IAjKP4,6931
 polydb/aio.py,sha256=0EQ6hXrf6N4If6pcht6L9B7qz0PU2yGahyGzEss2eQg,8340
 polydb/batch.py,sha256=ulvSdtVeofsOiVNVAQwrE9tXIIaP8fjiW1Sbpz3dcv0,4093
@@ -17,7 +17,7 @@ polydb/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 polydb/query.py,sha256=17V-e70df9NaiaUYPN5_MQz7O0vRdBaCR4xlZU3F2YE,8511
 polydb/registry.py,sha256=RD_elvFXcmhTdCyZDm2f3ej0elxqhArnSJ2aO9k5VCU,2352
 polydb/retry.py,sha256=0rILN3-auuzomOXPveIAvgnhBbtXXGNKvxg6qcRgN4g,4926
-polydb/schema.py,sha256=7Nz1EHcl4FWpdfsTonoFpMrkb0HcWKOiBpW_TTpPlrE,6447
+polydb/schema.py,sha256=jDjUuOaz2DANddhMTSxMwZ1MB-EOVDgDrCHbxkp-iM4,7712
 polydb/security.py,sha256=IF8Oh6Y6YU9xSjz_pi6lotfJuhIUJgP7cCmpGc8bz6w,20158
 polydb/types.py,sha256=Z1R8z06-WYoh7cnn0oE_2N10v6hdx7VJD7TNL5ynWhA,2667
 polydb/utils.py,sha256=YS-BhBpQfQsOf-z_i1zw_kvMYwJ05Zn1S2Xt6K4_2ak,3171
@@ -27,7 +27,7 @@ polydb/adapters/AzureBlobStorageAdapter.py,sha256=ZTovSC_CVduGnIoIQUUeNxDQlf-IbF
 polydb/adapters/AzureFileStorageAdapter.py,sha256=VZNprqlBXCuWUgtqClNT-NrQmRf-XFYEiRA2BLbf-Sc,7046
 polydb/adapters/AzureKeyVaultAdapter.py,sha256=7Nizs9qGh6cytbZNgV78f-odOO4Z6sUlwm_HQYqt-pc,2339
 polydb/adapters/AzureQueueAdapter.py,sha256=1e2HiFvkH1BI_JKS9fgays2J41kOfH6pUPbZDe1wmWA,13658
-polydb/adapters/AzureTableStorageAdapter.py,sha256=Ff4xbpqJKMN6EdMcsR9WMMFkMaceXmzb32v-nIiqVRo,33340
+polydb/adapters/AzureTableStorageAdapter.py,sha256=WsaivYIPYv0ScuuaJtCLDaBle9zTrwMsQ2ml_02m0dk,34043
 polydb/adapters/BlockchainBlobAdapter.py,sha256=85H3PxiL9rGDtK-sTsW26jOuUQ_SGipLSPu3s-juZRA,3298
 polydb/adapters/BlockchainFileAdapter.py,sha256=lZbRyC18LghZcVh5QyIRP7tCftNF_Ep1FKG0KRkvMmk,8335
 polydb/adapters/BlockchainKVAdapter.py,sha256=pvpiPshDE5Z_IRcSBvBwgAXT--86lgEyIsEUeqcmoE8,5422
@@ -41,7 +41,7 @@ polydb/adapters/GCPSecretManagerAdapter.py,sha256=ZFL2FGh7uTaBfpUo-HKXZAxS9s-w0w
 polydb/adapters/GCPStorageAdapter.py,sha256=ce7vCOW46XbdjiupAgMgkgopy3IV7nM5YvIwEhLIKvQ,7133
 polydb/adapters/KafkaQueueAdapter.py,sha256=_FrcI6JLIoJHPOtSIL2q1uXHeao9ZkGMyUnT68p36HQ,14329
 polydb/adapters/MongoDBAdapter.py,sha256=Rs1L9gbGj2hHiJuz62Ms7uRK6sppHc1aIO4MNrtZ3Zo,11750
-polydb/adapters/PostgreSQLAdapter.py,sha256=NPmf-s4UMGUFtQsqlAufrGtWI0N1vDvBYNSGAFEnBW4,45040
+polydb/adapters/PostgreSQLAdapter.py,sha256=xbRLYMt6w0eAwPOagb5lt6i3gJX9orzNOU8dX9JiBl0,47976
 polydb/adapters/RabbitMQAdapter.py,sha256=rMeqWXQmnfRX_pakaZX6q1bHkZ8E1boQ_Pkj3byl4E4,19903
 polydb/adapters/S3Adapter.py,sha256=ZkMR91u1e4SnrXSUbV3siKFYdw0ykYHJfyP2cUJUVso,7564
 polydb/adapters/S3CompatibleAdapter.py,sha256=Qj9SUtCnOFNL9c05wNVjICxZacFCnee-Wn_-hh0lwwE,7006
@@ -68,7 +68,7 @@ polydb/observability/logging.py,sha256=FWYky-Mg1IhLpwuaKuLIsTROBZc9bI_-AO-y53nvE
 polydb/services/__init__.py,sha256=Zs3PZbHutgPdPjJatygvtYvKPZMBt1qKSqESbFRPHJs,241
 polydb/services/compliance_service.py,sha256=UMjCbQ4z13-w6pT4RLQpMi_u1zbShEpiz8kawA2WsSU,5075
 polydb/services/security_service.py,sha256=gGo_j9Ca_rgvxS7s6C5JUktugQBj1PV1DXpMnOYAGbI,4992
-altcodepro_polydb_python-2.5.11.dist-info/METADATA,sha256=lCtZ5IOmpMi28p20Tifh50NbHIVHjFrOz8OC-7LthrY,15599
-altcodepro_polydb_python-2.5.11.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-altcodepro_polydb_python-2.5.11.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
-altcodepro_polydb_python-2.5.11.dist-info/RECORD,,
+altcodepro_polydb_python-2.5.18.dist-info/METADATA,sha256=Lp7sTTTNxyekuXaPMLtDyslq8Mv-hA65LAxy_WeGKoI,15599
+altcodepro_polydb_python-2.5.18.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+altcodepro_polydb_python-2.5.18.dist-info/top_level.txt,sha256=WgLFWJoYjUhwvyPxJFl6jYLrVFuBJDX3OABf4ocwk_E,7
+altcodepro_polydb_python-2.5.18.dist-info/RECORD,,

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.14"
+__version__ = "2.5.18"
 
 from .aio import AsyncDatabaseFactory, AsyncPolyDB
 from .audit.context import AuditContext

polydb/adapters/AzureTableStorageAdapter.py

@@ -125,6 +125,19 @@ class AzureTableStorageAdapter(NoSQLKVAdapter):
         s = re.sub(r"[\\/#\?\x00-\x1f\x7f:+ ]", "_", s)
         return s[:1024] if len(s) > 1024 else s
 
+    def _check_overflow(self, data: JsonDict):  # type: ignore[override]
+        """Azure overflows per PROPERTY inside `_put_raw`, never per record.
+
+        The base class' whole-record overflow replaces the record with a stub
+        of underscore keys (`_overflow`, `_blob_key`, ...), but `_put_raw`
+        drops every key starting with "_" when it builds the entity -- so the
+        stub's pointer was never stored and the real fields of the write were
+        silently lost (only an orphaned blob remained). Returning the data
+        untouched lets `_put_raw` spill each >30KB property on its own, which
+        `_get_raw`/`_query_raw` already rehydrate.
+        """
+        return data, None
+
     def _sanitize_prop_name(self, name: Any) -> str:
         s = str(name)
         s = re.sub(r"[^A-Za-z0-9_]", "_", s)

polydb/adapters/PostgreSQLAdapter.py

@@ -365,6 +365,50 @@ class PostgreSQLAdapter:
         return [self._serialize_param(p) for p in params]
 
     def _deserialize_row(self, row: JsonDict) -> JsonDict:
+        """Best-effort convenience decode: any string column value that
+        LOOKS like JSON (starts/ends with `{}`/`[]`) is `json.loads`'d,
+        regardless of the column's own declared type. This is a real,
+        deliberate, LOAD-BEARING convenience a real caller depends on --
+        e.g. universal-interprter's `observability.py`'s `Observability.
+        query()` writes a `logs.emit` payload as `json.dumps(...)` into a
+        plain TEXT column (`payload`, never JSONB -- see that module's
+        own comment) and its own docstring explicitly promises "logs.
+        query's own `payload` field gets a real dict back"; removing this
+        heuristic (briefly tried, then reverted -- see this repo's own
+        2.5.16/2.5.17 CLAUDE.md history) silently broke that real,
+        already-shipped contract. `query_log.py`'s own `fields` column is
+        the identical shape, just defended a second way: it independently
+        `json.loads`'s its own value with an `isinstance(..., str)` guard
+        rather than relying on this method at all -- proof this repo has
+        real callers on both sides (some lean on this adapter-level
+        decode, some defend for themselves).
+
+        **The real, honest trade-off, unavoidable at this layer**: a
+        genuinely non-JSON TEXT/VARCHAR string whose own real content
+        merely LOOKS JSON-shaped (e.g. a prompt template's own `content`
+        column holding a literal JSON-encoded email template -- see
+        universal-interprter's `prompt_template_store.py`) gets coerced
+        from `str` to `dict`/`list` here too, since this method has no
+        way to distinguish "real app data serialized as JSON text" from
+        "a legitimately JSON-shaped string that must stay a string" --
+        both are simply "a string that starts with `{` and ends with
+        `}`." This adapter deliberately does NOT try to solve that
+        ambiguity generically (declaring the column JSONB instead sidesteps
+        it entirely -- psycopg2 registers global JSON/JSONB typecasters
+        for OIDs 114/3802 automatically at import time, so a genuine
+        `json`/`jsonb` column never even reaches this heuristic, `isinstance
+        (v, str)` already `False` by the time this method sees it); a
+        caller that must keep a TEXT column's string content literal
+        despite it being JSON-shaped owns that coercion at ITS OWN layer
+        instead (see `prompt_template_store.py`'s own `_coerce_content_to_str`
+        for the concrete pattern: re-`json.dumps()` a `content` value that
+        came back non-`str`, restoring the real string every caller of
+        that store is promised). This adapter stays a "dumb storage
+        layer" in the sense that it never MODELS what a column's real
+        semantic type should be -- it does still apply this one generic,
+        best-effort convenience decode uniformly, exactly as it always
+        has.
+        """
         for k, v in list(row.items()):
             if isinstance(v, str):
                 s = v.strip()

polydb/schema.py

@@ -61,6 +61,17 @@ class Index:
     name: str
     columns: List[str]
     unique: bool = False
+    # Postgres index access method -- "btree" (the default, and the only
+    # one Postgres actually permits combined with UNIQUE) plus the real
+    # non-default methods a caller may need for a specific column shape:
+    # "gin"/"gist" (full-text search, JSONB containment, array overlap),
+    # "hash" (equality-only, smaller than btree for that one case), "brin"
+    # (large, naturally-ordered, append-mostly columns -- cheap to
+    # maintain relative to btree at real scale). Never validated against
+    # Postgres's own real per-type support here -- that's a live DDL
+    # concern the caller's own database will enforce; this dataclass only
+    # carries the caller's choice through to the generated statement.
+    using: str = "btree"
 
 
 class SchemaBuilder:
@@ -128,10 +139,17 @@ class SchemaBuilder:
 
         for idx in self.indexes:
             unique = "UNIQUE " if idx.unique else ""
+            # "btree" omitted outright rather than spelled out as
+            # "USING btree" -- it's Postgres's own implicit default, and
+            # every index this codebase generated before `using` existed
+            # rendered without a USING clause at all; emitting it only for
+            # a non-default method keeps every pre-existing caller's own
+            # generated SQL text byte-for-byte unchanged.
+            using = f"USING {idx.using} " if idx.using != "btree" else ""
             cols = ", ".join(validate_column_name(c) for c in idx.columns)
             sql = (
                 f"CREATE {unique}INDEX IF NOT EXISTS {validate_table_name(idx.name)} "
-                f"ON {table_name}({cols});"
+                f"ON {table_name}{' ' if using else ''}{using}({cols});"
             )
             statements.append(sql)