torque-http 0.5.0__tar.gz → 0.6.0__tar.gz

torque_http-0.6.0/LICENSE

@@ -0,0 +1,196 @@
+TORQUE END-USER LICENSE AGREEMENT (EULA)
+
+Copyright (c) 2025-2026 Truespar. All rights reserved.
+
+IMPORTANT — READ CAREFULLY: This End-User License Agreement ("Agreement") is a
+legal agreement between you (either an individual or a single entity, "Licensee")
+and Truespar ("Licensor") for the Torque software,
+including all source code, binaries, documentation, and associated files
+(collectively, the "Software").
+
+By downloading, installing, copying, or otherwise using the Software, you agree
+to be bound by the terms of this Agreement. If you do not agree, do not use the
+Software.
+
+1. GRANT OF LICENSE
+
+   Subject to the terms of this Agreement, Licensor grants Licensee a limited,
+   non-exclusive, non-transferable, revocable license to:
+
+   (a) Use the Software for internal purposes, including evaluation, development,
+       and production deployment.
+
+   (b) Create applications and services that interface with the Software through
+       its published APIs (Bolt protocol, FFI bindings, gRPC, and CLI).
+
+2. RESTRICTIONS
+
+   Licensee shall NOT:
+
+   (a) Modify, adapt, alter, translate, or create derivative works of the
+       Software or any part thereof.
+
+   (b) Reverse engineer, disassemble, decompile, or otherwise attempt to derive
+       the source code, underlying ideas, algorithms, data structures, or
+       non-public APIs of the Software. To the extent that applicable law
+       (including EU Directive 2009/24/EC) grants a non-waivable right to
+       decompile for interoperability purposes, Licensee must first provide
+       thirty (30) days' prior written notice to Licensor and may exercise such
+       right only to the minimum extent necessary to achieve interoperability
+       with independently created software.
+
+   (c) Redistribute, sublicense, lease, rent, loan, sell, or otherwise transfer
+       the Software or any rights therein to any third party.
+
+   (d) Remove, alter, or obscure any proprietary notices, labels, or marks on
+       the Software.
+
+   (e) Use the Software to operate a service bureau, outsourcing service, or
+       managed-service offering for the benefit of third parties, or to provide
+       database-as-a-service offerings based on the Software, without a separate
+       commercial agreement with the Licensor.
+
+   (f) Use the Software to build a product or service that competes with the
+       Software.
+
+   (g) Publish benchmark results, performance comparisons, or similar evaluations
+       of the Software without prior written consent of the Licensor.
+
+3. INTELLECTUAL PROPERTY
+
+   The Software is the intellectual property of the Licensor and is protected by
+   copyright law and international treaties. Licensor retains all right, title,
+   and interest in and to the Software, including all intellectual property rights
+   therein. This Agreement does not convey any ownership interest in the Software.
+
+4. FEEDBACK
+
+   If Licensee provides suggestions, ideas, enhancement requests, or other
+   feedback regarding the Software ("Feedback"), Licensor may freely use,
+   incorporate, modify, license, and distribute such Feedback without restriction,
+   attribution, or compensation to Licensee. Licensee hereby assigns to Licensor
+   all right, title, and interest in and to any Feedback.
+
+5. CONFIDENTIALITY
+
+   (a) "Confidential Information" means the source code, object code, algorithms,
+       data structures, architecture, internal APIs, performance characteristics,
+       and any other non-public technical or business information of the Licensor
+       disclosed to or accessed by Licensee, whether in written, electronic, or
+       other form.
+
+   (b) Licensee shall hold all Confidential Information in strict confidence,
+       using at least the same degree of care it uses to protect its own
+       confidential information, but no less than reasonable care.
+
+   (c) Licensee shall not disclose Confidential Information to any third party
+       without the prior written consent of Licensor, except to Licensee's
+       employees or contractors who have a need to know and are bound by
+       confidentiality obligations at least as protective as those herein.
+
+   (d) The obligations in this section do not apply to information that:
+       (i) is or becomes publicly available through no fault of Licensee;
+       (ii) was rightfully known to Licensee prior to disclosure by Licensor;
+       (iii) is independently developed by Licensee without use of or reference
+       to the Confidential Information; or (iv) is required to be disclosed by
+       law, provided Licensee gives Licensor prompt written notice and
+       cooperates to limit the scope of disclosure.
+
+   (e) These confidentiality obligations survive termination of this Agreement
+       for a period of five (5) years, or indefinitely for trade secrets for as
+       long as they remain trade secrets under applicable law.
+
+6. THIRD-PARTY COMPONENTS
+
+   The Software incorporates open-source components licensed under permissive
+   licenses (MIT, Apache-2.0, BSD, and similar). These components retain their
+   original licenses. A list of third-party components and their licenses is
+   provided in the THIRD-PARTY-NOTICES file included with the Software.
+
+   Nothing in this Agreement restricts, limits, or otherwise affects any rights
+   Licensee may have under the licenses of such third-party components.
+
+7. NO WARRANTY
+
+   THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+   IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+   FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+   LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN
+   ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN
+   CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+8. LIMITATION OF LIABILITY
+
+   (a) IN NO EVENT SHALL LICENSOR'S TOTAL AGGREGATE LIABILITY TO LICENSEE FOR
+       ALL CLAIMS ARISING UNDER OR IN CONNECTION WITH THIS AGREEMENT EXCEED THE
+       GREATER OF: (I) THE TOTAL AMOUNT OF FEES ACTUALLY PAID BY LICENSEE TO
+       LICENSOR FOR THE SOFTWARE DURING THE TWELVE (12) MONTHS IMMEDIATELY
+       PRECEDING THE EVENT GIVING RISE TO THE CLAIM; OR (II) FIFTY US DOLLARS
+       (USD $50.00).
+
+   (b) IN NO EVENT SHALL LICENSOR BE LIABLE FOR ANY INDIRECT, INCIDENTAL,
+       SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, INCLUDING BUT NOT LIMITED TO
+       LOSS OF PROFITS, DATA, BUSINESS, OR GOODWILL, REGARDLESS OF THE CAUSE OF
+       ACTION OR THE THEORY OF LIABILITY, EVEN IF LICENSOR HAS BEEN ADVISED OF
+       THE POSSIBILITY OF SUCH DAMAGES.
+
+   (c) THE LIMITATIONS IN SUBSECTIONS (a) AND (b) ABOVE SHALL NOT APPLY TO
+       LIABILITY ARISING FROM: (I) FRAUD OR FRAUDULENT MISREPRESENTATION;
+       (II) GROSS NEGLIGENCE OR WILLFUL MISCONDUCT; (III) LICENSEE'S BREACH OF
+       SECTIONS 2 (RESTRICTIONS) OR 5 (CONFIDENTIALITY); OR (IV) EITHER PARTY'S
+       INDEMNIFICATION OBLIGATIONS UNDER SECTION 9.
+
+9. INDEMNIFICATION
+
+   (a) Licensee shall defend, indemnify, and hold harmless Licensor and its
+       officers, directors, employees, and agents from and against any and all
+       third-party claims, damages, losses, liabilities, costs, and expenses
+       (including reasonable attorneys' fees) arising out of or related to:
+       (i) Licensee's breach of this Agreement, including but not limited to the
+       restrictions in Section 2 and the confidentiality obligations in
+       Section 5; (ii) Licensee's use of the Software in violation of applicable
+       law; or (iii) Licensee's gross negligence or willful misconduct.
+
+   (b) Licensor shall promptly notify Licensee of any such claim and provide
+       reasonable cooperation at Licensee's expense. Licensee shall have sole
+       control of the defense and settlement, provided that any settlement
+       requiring Licensor to admit liability or pay money shall require
+       Licensor's prior written consent.
+
+10. TERMINATION
+
+   (a) This Agreement is effective until terminated.
+
+   (b) Licensor may terminate this Agreement immediately upon written notice if
+       Licensee breaches Section 2 (Restrictions), Section 5 (Confidentiality),
+       or Section 9 (Indemnification).
+
+   (c) For any other material breach, the non-breaching party may terminate this
+       Agreement if the breaching party fails to cure such breach within thirty
+       (30) days of receiving written notice thereof.
+
+   (d) Upon termination, Licensee must immediately cease all use of the Software
+       and destroy all copies (including backups) in its possession or control
+       within five (5) business days. Upon Licensor's request, Licensee shall
+       certify such destruction in writing.
+
+   (e) Sections 2, 3, 4, 5, 7, 8, 9, 11, and 12 survive termination of this
+       Agreement.
+
+11. GOVERNING LAW
+
+   This Agreement shall be governed by and construed in accordance with the laws
+   of the State of Delaware, United States, without regard to its conflict-of-law
+   provisions. The United Nations Convention on Contracts for the International
+   Sale of Goods is expressly excluded. Any disputes arising under this Agreement
+   shall be resolved exclusively in the state or federal courts located in the
+   State of Delaware. Notwithstanding the foregoing, Licensor may seek injunctive
+   or other equitable relief in any court of competent jurisdiction to protect its
+   intellectual property rights or Confidential Information.
+
+12. ENTIRE AGREEMENT
+
+   This Agreement constitutes the entire agreement between the parties with
+   respect to the Software and supersedes all prior negotiations, representations,
+   or agreements relating thereto. No modification of this Agreement shall be
+   binding unless in writing and signed by both parties.

{torque_http-0.5.0 → torque_http-0.6.0}/PKG-INFO

@@ -1,16 +1,15 @@
 Metadata-Version: 2.4
 Name: torque-http
-Version: 0.5.0
+Version: 0.6.0
 Summary: Official Python client for Torque — Truespar's in-memory search engine with a Typesense v30.1 compatible API. Zero external dependencies.
 Project-URL: Homepage, https://truespar.com/torque/docs
 Project-URL: Documentation, https://truespar.com/torque/docs
 Author: Truespar
-License-Expression: MIT
+License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Keywords: search,torque,truespar,typesense,vector-search
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -30,7 +29,7 @@ Official Python client for [Torque](https://truespar.com/torque/docs) — Truesp
 - **TQBF file upload** for bulk import
 - Multi-node failover with automatic retry
 - Typed search parameters and response models
-- Python 3.10+, MIT licensed
+- Python 3.10+
 
 ## Installation
 
@@ -129,4 +128,4 @@ client.import_binary("products", "data.tqbf")
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+Copyright 2025-2026 Truespar. All rights reserved. See [LICENSE](LICENSE).

{torque_http-0.5.0 → torque_http-0.6.0}/README.md

@@ -8,7 +8,7 @@ Official Python client for [Torque](https://truespar.com/torque/docs) — Truesp
 - **TQBF file upload** for bulk import
 - Multi-node failover with automatic retry
 - Typed search parameters and response models
-- Python 3.10+, MIT licensed
+- Python 3.10+
 
 ## Installation
 
@@ -107,4 +107,4 @@ client.import_binary("products", "data.tqbf")
 
 ## License
 
-MIT — see [LICENSE](LICENSE).
+Copyright 2025-2026 Truespar. All rights reserved. See [LICENSE](LICENSE).

{torque_http-0.5.0 → torque_http-0.6.0}/pyproject.toml

@@ -4,17 +4,17 @@ build-backend = "hatchling.build"
 
 [project]
 name = "torque-http"
-version = "0.5.0"
+version = "0.6.0"
 description = "Official Python client for Torque — Truespar's in-memory search engine with a Typesense v30.1 compatible API. Zero external dependencies."
 readme = "README.md"
-license = "MIT"
+license = "LicenseRef-Proprietary"
+license-files = ["LICENSE"]
 requires-python = ">=3.10"
 authors = [{ name = "Truespar" }]
 keywords = ["search", "torque", "typesense", "truespar", "vector-search"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",
-    "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",

{torque_http-0.5.0 → torque_http-0.6.0}/src/torque_http/__init__.py

@@ -118,4 +118,4 @@ __all__ = [
     "TorqueConnectionError",
 ]
 
-__version__ = "0.5.0"
+__version__ = "0.6.0"

{torque_http-0.5.0 → torque_http-0.6.0}/src/torque_http/client.py

@@ -1,6 +1,6 @@
 """Torque Python HTTP client — zero external dependencies.
 
-Uses only Python 3.13+ stdlib: http.client, json, ssl, threading.
+Uses only Python 3.10+ stdlib: http.client, json, ssl, threading.
 Features: connection pooling with keep-alive, multi-node round-robin,
 configurable retry with exponential backoff, typed error hierarchy.
 """
@@ -813,7 +813,7 @@ class TorqueHttpClient:
         if params is not None:
             merged.update(params)
         merged.update(kwargs)
-        qs = urlencode({k: v for k, v in merged.items() if v is not None})
+        qs = _encode_search_params(merged)
         d = self._get(f"/collections/{_enc(collection)}/documents/search?{qs}")
         return _parse_search(d)
 
@@ -837,7 +837,7 @@ class TorqueHttpClient:
         if params is not None:
             merged.update(params)
         merged.update(kwargs)
-        qs = urlencode({k: v for k, v in merged.items() if v is not None})
+        qs = _encode_search_params(merged)
         d = self._get(f"/collections/{_enc(collection)}/documents/search?{qs}")
         return _parse_grouped_search(d)
 
@@ -866,6 +866,44 @@ class TorqueHttpClient:
         d = self._post("/multi_search", {"searches": searches})
         return [_parse_search(r) for r in d.get("results", [])]
 
+    def multi_search_union(
+        self,
+        searches: list[dict[str, Any]],
+        common_params: dict[str, Any] | None = None,
+        *,
+        page: int | None = None,
+        per_page: int | None = None,
+    ) -> SearchResult:
+        """Execute multiple searches merged into one ranked result set.
+
+        Uses Typesense v30.1 ``union: true`` — hits from all searches are
+        merged and ranked by text_match. Not compatible with ``group_by``
+        searches.
+
+        Args:
+            searches: List of search parameter dicts, each with at least
+                ``collection`` and ``q`` keys.
+            common_params: Optional dict of parameters merged into every
+                search. Per-search values override common values.
+            page: Page number for the merged result set (1-based).
+            per_page: Results per page for the merged result set.
+
+        Returns:
+            A single SearchResult with the merged, ranked hits.
+        """
+        if common_params:
+            searches = [{**common_params, **s} for s in searches]
+        path = "/multi_search"
+        query: list[str] = []
+        if page is not None:
+            query.append(f"page={page}")
+        if per_page is not None:
+            query.append(f"per_page={per_page}")
+        if query:
+            path += "?" + "&".join(query)
+        d = self._post(path, {"searches": searches, "union": True})
+        return _parse_search(d)
+
     # ── Aliases ────────────────────────────────────────────────────────
 
     def upsert_alias(self, name: str, collection_name: str) -> CollectionAlias:
@@ -1413,6 +1451,15 @@ def _enc(s: str) -> str:
     return quote(s, safe="")
 
 
+def _encode_search_params(params: dict[str, Any]) -> str:
+    """URL-encode search params, serializing Python bools as true/false."""
+    return urlencode({
+        k: ("true" if v is True else "false" if v is False else v)
+        for k, v in params.items()
+        if v is not None
+    })
+
+
 def _parse_collection(d: dict) -> CollectionResponse:
     return CollectionResponse(
         name=d.get("name", ""),

{torque_http-0.5.0 → torque_http-0.6.0}/src/torque_http/models.py

@@ -171,10 +171,15 @@ class SearchParameters(TypedDict, total=False):
     facet_by: str
     max_facet_values: int
     facet_query: str
+    facet_strategy: str
+    facet_sample_percent: int
+    facet_sample_threshold: int
+    facet_return_parent: str
 
     # ── Grouping ──────────────────────────────────────────────────────
     group_by: str
     group_limit: int
+    group_missing_values: bool
 
     # ── Pagination ────────────────────────────────────────────────────
     per_page: int
@@ -191,6 +196,7 @@ class SearchParameters(TypedDict, total=False):
     highlight_full_fields: str
     highlight_start_tag: str
     highlight_end_tag: str
+    highlight_affix_num_tokens: int
     snippet_threshold: int
 
     # ── Pinning / hiding ──────────────────────────────────────────────
@@ -200,17 +206,41 @@ class SearchParameters(TypedDict, total=False):
 
     # ── Token dropping ────────────────────────────────────────────────
     drop_tokens_threshold: int
+    drop_tokens_mode: str
     typo_tokens_threshold: int
 
+    # ── Typo tolerance ────────────────────────────────────────────────
+    min_len_1typo: int
+    min_len_2typo: int
+    split_join_tokens: str
+    synonym_num_typos: int
+    enable_typos_for_numerical_tokens: bool
+    enable_typos_for_alpha_numerical_tokens: bool
+
+    # ── Infix search ──────────────────────────────────────────────────
+    infix: str
+    max_extra_prefix: int
+    max_extra_suffix: int
+
     # ── Performance ───────────────────────────────────────────────────
     exhaustive_search: bool
     search_cutoff_ms: int
+    max_candidates: int
+
+    # ── Caching ───────────────────────────────────────────────────────
+    use_cache: bool
+    cache_ttl: int
+
+    # ── Validation & toggles ──────────────────────────────────────────
+    validate_field_names: bool
+    enable_synonyms: bool
 
     # ── Preset ────────────────────────────────────────────────────────
     preset: str
 
-    # ── Stopwords ─────────────────────────────────────────────────────
+    # ── Stopwords & synonyms ──────────────────────────────────────────
     stopwords: str
+    synonym_sets: str
 
     # ── Vector search ─────────────────────────────────────────────────
     vector_query: str

torque_http-0.5.0/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Truespar
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.