plugsync-cli 0.7.0__tar.gz → 0.8.0__tar.gz

plugsync_cli-0.8.0/LICENSE

@@ -0,0 +1,35 @@
+plugsync-cli
+Copyright (c) 2026 Exelab S.r.l. All rights reserved.
+
+This package is the plugsync command-line interface (the "CLI"), client
+software distributed by Exelab S.r.l. ("Exelab") for use with the plugsync
+service. It is not open source software.
+
+The right to install and use the CLI is granted by paragraph 11.2 of the
+plugsync Terms of Service (the "Terms"), published at:
+
+    https://plugsync.com/it/terms
+
+Paragraph 11.2 of the Terms reads:
+
+    11.2 Software client. Per la durata del Contratto Exelab concede al
+    Cliente una licenza non esclusiva, non trasferibile e gratuita di
+    installare e utilizzare la CLI e il Server MCP al solo fine di utilizzare
+    il Servizio, nel rispetto dell'Articolo 6.
+
+    (Courtesy translation: For the term of the Agreement, Exelab grants the
+    Customer a non-exclusive, non-transferable, free-of-charge license to
+    install and use the CLI and the MCP Server solely for the purpose of using
+    the Service, in compliance with Article 6.)
+
+No other right is granted. Exelab remains the sole owner of the CLI and of
+every intellectual property right in it (paragraph 11.1 of the Terms).
+Warranties and liability are governed by the Terms. Capitalised words have
+the meaning given to them in the Terms.
+
+The Terms are drafted in Italian, which is the authoritative text; any
+translation, including the one above, is provided as a courtesy only. Where
+this notice and the Terms differ, the Terms prevail.
+
+Third-party components that the CLI depends on are distributed under their
+own open source licenses, which continue to govern them.

{plugsync_cli-0.7.0 → plugsync_cli-0.8.0}/PKG-INFO

@@ -1,18 +1,16 @@
 Metadata-Version: 2.4
 Name: plugsync-cli
-Version: 0.7.0
+Version: 0.8.0
 Summary: Command-line client for plugsync HubSpot connectors -- manage connectors and plugins like code, no repo checkout required
 Author-email: Exelab <hello@plugsync.com>
-License: Proprietary
+License-Expression: LicenseRef-Proprietary
 Project-URL: Homepage, https://plugsync.com
-Project-URL: Documentation, https://github.com/exelab/plugsync/blob/main/docs/content/reference/plugins/dev-loop.md
-Project-URL: Repository, https://github.com/exelab/plugsync
-Project-URL: Issues, https://github.com/exelab/plugsync/issues
+Project-URL: Documentation, https://docs.plugsync.com/reference/cli/
+Project-URL: Terms of Service, https://plugsync.com/it/terms
 Keywords: plugsync,hubspot,cli,connectors,integration
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
-Classifier: License :: Other/Proprietary License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
@@ -20,6 +18,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
+License-File: LICENSE
 Requires-Dist: click>=8.1
 Requires-Dist: httpx>=0.27
 Requires-Dist: pyyaml>=6.0
@@ -28,6 +27,7 @@ Provides-Extra: dev
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
 Requires-Dist: respx>=0.21; extra == "dev"
+Dynamic: license-file
 
 # plugsync-cli
 
@@ -91,11 +91,13 @@ against the API at the start of any command that talks to it, warning
 ## Documentation
 
 Full reference docs, including the plugin authoring dev-loop, live at
-[docs.plugsync.com](https://docs.plugsync.com) and in the
-[plugsync repository](https://github.com/exelab/plugsync/tree/main/docs).
+[docs.plugsync.com](https://docs.plugsync.com).
 
 ## License
 
-Proprietary. This CLI talks to the plugsync SaaS API; see
-[plugsync.com/terms](https://plugsync.com/terms) for the terms governing use
-of the plugsync service.
+Proprietary, not open source. The license to install and use this CLI is
+granted by paragraph 11.2 of the plugsync Terms of Service, published at
+[plugsync.com/it/terms](https://plugsync.com/it/terms): a non-exclusive,
+non-transferable, free-of-charge license, for the term of your plugsync
+agreement, solely for the purpose of using the plugsync service. The
+`LICENSE` file shipped with the package carries the full notice.

{plugsync_cli-0.7.0 → plugsync_cli-0.8.0}/README.md

@@ -60,11 +60,13 @@ against the API at the start of any command that talks to it, warning
 ## Documentation
 
 Full reference docs, including the plugin authoring dev-loop, live at
-[docs.plugsync.com](https://docs.plugsync.com) and in the
-[plugsync repository](https://github.com/exelab/plugsync/tree/main/docs).
+[docs.plugsync.com](https://docs.plugsync.com).
 
 ## License
 
-Proprietary. This CLI talks to the plugsync SaaS API; see
-[plugsync.com/terms](https://plugsync.com/terms) for the terms governing use
-of the plugsync service.
+Proprietary, not open source. The license to install and use this CLI is
+granted by paragraph 11.2 of the plugsync Terms of Service, published at
+[plugsync.com/it/terms](https://plugsync.com/it/terms): a non-exclusive,
+non-transferable, free-of-charge license, for the term of your plugsync
+agreement, solely for the purpose of using the plugsync service. The
+`LICENSE` file shipped with the package carries the full notice.

{plugsync_cli-0.7.0 → plugsync_cli-0.8.0}/plugsync_cli/__init__.py

@@ -1,2 +1,2 @@
 """PluSync CLI — git-like connector management."""
-__version__ = "0.7.0"
+__version__ = "0.8.0"

{plugsync_cli-0.7.0 → plugsync_cli-0.8.0}/plugsync_cli/client.py

@@ -145,6 +145,98 @@ class PlugSyncClient:
             r.raise_for_status()
             return r.json()
 
+    def prewarm_start(
+        self,
+        connector_id: str,
+        *,
+        dry_run: bool = False,
+        modified_after: str | None = None,
+        entities: list[str] | None = None,
+        store_id: str | None = None,
+    ) -> dict:
+        """Start an identity map pre-warm job (#1885), returning the job.
+
+        The API answers 202 with the job already running in the background;
+        progress is read back with `prewarm_get`. `modified_after` is an ISO
+        8601 timestamp with a timezone and turns the run into an incremental
+        pass. Unset options are left out of the body so the server defaults
+        apply.
+        """
+        body: dict = {"dry_run": dry_run}
+        if modified_after is not None:
+            body["modified_after"] = modified_after
+        if entities:
+            body["entities"] = list(entities)
+        if store_id is not None:
+            body["store_id"] = store_id
+        with self._client() as c:
+            r = c.post(
+                self._url(f"/connectors/{connector_id}/identity-prewarm"), json=body
+            )
+            r.raise_for_status()
+            return r.json()
+
+    def prewarm_list(self, connector_id: str) -> list[dict]:
+        """The connector's most recent pre-warm jobs, newest first."""
+        with self._client() as c:
+            r = c.get(self._url(f"/connectors/{connector_id}/identity-prewarm"))
+            r.raise_for_status()
+            return r.json().get("jobs", [])
+
+    def prewarm_get(self, connector_id: str, job_id: str) -> dict:
+        """One pre-warm job with its per-entity progress."""
+        with self._client() as c:
+            r = c.get(
+                self._url(f"/connectors/{connector_id}/identity-prewarm/{job_id}")
+            )
+            r.raise_for_status()
+            return r.json()
+
+    def prewarm_findings(
+        self,
+        connector_id: str,
+        job_id: str,
+        *,
+        finding: str | None = None,
+        limit: int = 200,
+        offset: int = 0,
+    ) -> dict:
+        """A page of a job's findings: ambiguous values and conflicting mappings."""
+        params: dict = {"limit": limit, "offset": offset}
+        if finding is not None:
+            params["finding"] = finding
+        with self._client() as c:
+            r = c.get(
+                self._url(
+                    f"/connectors/{connector_id}/identity-prewarm/{job_id}/findings"
+                ),
+                params=params,
+            )
+            r.raise_for_status()
+            return r.json()
+
+    def prewarm_resume(self, connector_id: str, job_id: str) -> dict:
+        """Resume an interrupted or failed pre-warm job from its cursor."""
+        with self._client() as c:
+            r = c.post(
+                self._url(
+                    f"/connectors/{connector_id}/identity-prewarm/{job_id}/resume"
+                )
+            )
+            r.raise_for_status()
+            return r.json()
+
+    def prewarm_cancel(self, connector_id: str, job_id: str) -> dict:
+        """Cancel a pre-warm job for good: it cannot be resumed afterwards."""
+        with self._client() as c:
+            r = c.post(
+                self._url(
+                    f"/connectors/{connector_id}/identity-prewarm/{job_id}/cancel"
+                )
+            )
+            r.raise_for_status()
+            return r.json()
+
     def get_draft(self, connector_id: str) -> dict:
         """The connector's editable config (backend DraftResponse).