planvortex 0.16.1__tar.gz → 0.18.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {planvortex-0.16.1 → planvortex-0.18.0}/CHANGELOG.md +46 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/PKG-INFO +17 -2
- {planvortex-0.16.1 → planvortex-0.18.0}/README.md +16 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/openapi/planvortex.openapi.json +266 -30
- {planvortex-0.16.1 → planvortex-0.18.0}/pyproject.toml +1 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/scripts/route_coverage.py +2 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/__init__.py +2 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/errors.py +6 -2
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/http.py +4 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/http_sync.py +4 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/transport.py +23 -2
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_generated/models.py +53 -11
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_version.py +1 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/base.py +43 -2
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/comments.py +21 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/messages.py +29 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/base.py +41 -2
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/comments.py +21 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/messages.py +29 -1
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/webhooks.py +28 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_comments.py +16 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_core.py +11 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_messages.py +82 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_route_coverage.py +5 -3
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_webhooks.py +8 -2
- {planvortex-0.16.1 → planvortex-0.18.0}/.gitignore +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/LICENSE +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/scripts/build_docs.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/scripts/check_packaging.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/scripts/generate_models.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/scripts/generate_sync.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_client.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_client_sync.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/__init__.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/auth.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/auth_sync.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/files.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/pagination.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_core/query.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_generated/__init__.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/_shapes.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/py.typed +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/__init__.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/accounts.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/ai_plans.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/apps.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/catalog.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/clients.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/contacts.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/dashboard.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/integrations.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/organizations.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/products.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/publications.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources/uploads.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/__init__.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/accounts.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/ai_plans.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/apps.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/catalog.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/clients.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/contacts.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/dashboard.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/integrations.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/organizations.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/products.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/publications.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/resources_sync/uploads.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/src/planvortex/types.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/__init__.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/conftest.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/contrato.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/__init__.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/conftest.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/test_auth.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/test_catalog.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/test_connect_flow.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/test_errors.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/test_publish.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/live/test_read.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_accounts.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_ai_plans.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_apps.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_catalog.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_client.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_clients.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_contacts.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_dashboard.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_example_comments.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_example_connect.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_example_publish.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_example_schedule.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_example_webhooks.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_files.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_generate_models.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_generate_sync.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_integrations.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_models.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_openapi_freshness.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_organizations.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_packaging.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_pagination.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_products.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_publications.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_query_parity.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_readme.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_shapes_parity.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_types.py +0 -0
- {planvortex-0.16.1 → planvortex-0.18.0}/tests/test_uploads.py +0 -0
|
@@ -4,6 +4,52 @@ All notable changes to this package are documented here. The format follows
|
|
|
4
4
|
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to
|
|
5
5
|
[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
6
|
|
|
7
|
+
## [Unreleased]
|
|
8
|
+
|
|
9
|
+
## [0.18.0] - 2026-11-10
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- **`pv.messages.download_file()` and `pv.comments.download_file()`.** The files that arrive from
|
|
14
|
+
the network (a photo, a voice note or a document in a private message; a photo, a GIF or a sticker
|
|
15
|
+
in a comment) are not stored by PlanVortex: `files_urls` says where each one is, and these two ask
|
|
16
|
+
PlanVortex to fetch it from the network right then. They return a `DownloadedFile` with the
|
|
17
|
+
`data` bytes, the real `content_type`, the `file_name` when there is one and the `disposition`.
|
|
18
|
+
Every WhatsApp file needs them (none has a `url`, photos and videos included), as do Telegram
|
|
19
|
+
files, LinkedIn images and Bluesky videos. Both exist in the async and the sync client.
|
|
20
|
+
- **`files_urls` on comments**: a comment that is only a photo is no longer an empty row. Facebook,
|
|
21
|
+
Threads, LinkedIn, X, Bluesky, Discord and Telegram give them, and on Google Business they are the
|
|
22
|
+
photos and videos of a review; on Instagram and YouTube the list is always empty.
|
|
23
|
+
|
|
24
|
+
### Fixed
|
|
25
|
+
|
|
26
|
+
- **Errors 1515 and 1516 are `MessagingError`.** They are the files: 1515 is the network no longer
|
|
27
|
+
having one (on a comment too), 1516 a message with no file at that position.
|
|
28
|
+
|
|
29
|
+
- **Errors 1513 and 1514 are `MessagingError`.** They are the WhatsApp message templates: 1513 is a
|
|
30
|
+
template PlanVortex refuses before sending it to WhatsApp because WhatsApp would reject its format
|
|
31
|
+
(`data.field` and `data.reason` say which rule, such as `missing_examples`), and 1514 is WhatsApp
|
|
32
|
+
refusing it when it is created (`data.code`, `data.subcode` and `data.message` are WhatsApp’s). Both
|
|
33
|
+
were above the top of the messaging range and arrived as the base error.
|
|
34
|
+
|
|
35
|
+
## [0.17.0] - 2026-10-28
|
|
36
|
+
|
|
37
|
+
### Added
|
|
38
|
+
|
|
39
|
+
- **`message_echoes` webhook event (WhatsApp).** When a WhatsApp number is also used in the
|
|
40
|
+
WhatsApp Business app on a phone, what the business sends from the app arrives as
|
|
41
|
+
`field: "message_echoes"`, with the message in `messageObj` as one of **ours**: `contact_id` is
|
|
42
|
+
the person it was sent to and `from_contact_id` is absent. New type `MessageEchoChange` and
|
|
43
|
+
predicate `is_message_echo_change()`. It is deliberately **not** part of `is_message_change()`: a
|
|
44
|
+
bot that answers every incoming message must not answer the business itself. Store it, do not
|
|
45
|
+
reply.
|
|
46
|
+
- **`edit_date` and `deleted_date` on messages.** A contact edited or deleted the message on
|
|
47
|
+
WhatsApp. An edited message already carries the new text; a deleted one has no text and no files.
|
|
48
|
+
No webhook event is sent for either: the message itself changes.
|
|
49
|
+
- **`unsupported_message`** in the message types: a WhatsApp message the API cannot show (a voice
|
|
50
|
+
note, a document, a sticker, or a type WhatsApp does not let the API read). It only ever arrives,
|
|
51
|
+
keeps the caption as `text` when there is one, and sending one is refused.
|
|
52
|
+
|
|
7
53
|
## [0.16.1] - 2026-10-25
|
|
8
54
|
|
|
9
55
|
### Changed
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: planvortex
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.18.0
|
|
4
4
|
Summary: Official Python client for the PlanVortex API
|
|
5
5
|
Project-URL: Homepage, https://planvortex.com/en/developers
|
|
6
6
|
Project-URL: Documentation, https://taliasoftworks.github.io/PlanVortexPython/
|
|
@@ -214,6 +214,21 @@ if (pv.comments.actions_for("linkedin") or {}).get("hide"):
|
|
|
214
214
|
...
|
|
215
215
|
```
|
|
216
216
|
|
|
217
|
+
A photo, a voice note or a document in a private message, and a photo or a sticker in a comment,
|
|
218
|
+
**are not stored by PlanVortex**: they stay on the network, and `files_urls` says where each one is.
|
|
219
|
+
When an entry has a `url`, load it directly. When it has none (every WhatsApp and Telegram file, a
|
|
220
|
+
LinkedIn image, a Bluesky video) or the `url` stopped loading, ask PlanVortex for it:
|
|
221
|
+
|
|
222
|
+
```python
|
|
223
|
+
file = pv.messages.download_file(org_id, account_id, message["_id"], 0)
|
|
224
|
+
# or: pv.comments.download_file(org_id, comment["_id"], 0)
|
|
225
|
+
print(file.content_type, file.file_name, len(file.data))
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
WhatsApp lets go of a file 7 days after it arrived; from then on the answer is error 1515. A
|
|
229
|
+
`disposition` of `"attachment"` is a document somebody outside the business sent: don't render it
|
|
230
|
+
inside your own pages.
|
|
231
|
+
|
|
217
232
|
## AI plans, and what they are generated from
|
|
218
233
|
|
|
219
234
|
A plan is a **week** of drafts written by a model: you queue it, a job generates it, and what comes
|
|
@@ -285,7 +300,7 @@ memorising numbers:
|
|
|
285
300
|
| 1100-1111 | `organization` | `OrganizationError` |
|
|
286
301
|
| 1200-1207 | `role` | `PlanVortexError` |
|
|
287
302
|
| 1300-1308, 1400-1408 | `plan_limit` | `PlanLimitError` |
|
|
288
|
-
| 1500-
|
|
303
|
+
| 1500-1516 | `messaging` | `MessagingError` |
|
|
289
304
|
| 1600-1601 | `contact` | `ContactError` |
|
|
290
305
|
| 1900-1906 | `payment` | `PlanVortexError` |
|
|
291
306
|
| 2000-2099 | `product` | `ProductError` |
|
|
@@ -184,6 +184,21 @@ if (pv.comments.actions_for("linkedin") or {}).get("hide"):
|
|
|
184
184
|
...
|
|
185
185
|
```
|
|
186
186
|
|
|
187
|
+
A photo, a voice note or a document in a private message, and a photo or a sticker in a comment,
|
|
188
|
+
**are not stored by PlanVortex**: they stay on the network, and `files_urls` says where each one is.
|
|
189
|
+
When an entry has a `url`, load it directly. When it has none (every WhatsApp and Telegram file, a
|
|
190
|
+
LinkedIn image, a Bluesky video) or the `url` stopped loading, ask PlanVortex for it:
|
|
191
|
+
|
|
192
|
+
```python
|
|
193
|
+
file = pv.messages.download_file(org_id, account_id, message["_id"], 0)
|
|
194
|
+
# or: pv.comments.download_file(org_id, comment["_id"], 0)
|
|
195
|
+
print(file.content_type, file.file_name, len(file.data))
|
|
196
|
+
```
|
|
197
|
+
|
|
198
|
+
WhatsApp lets go of a file 7 days after it arrived; from then on the answer is error 1515. A
|
|
199
|
+
`disposition` of `"attachment"` is a document somebody outside the business sent: don't render it
|
|
200
|
+
inside your own pages.
|
|
201
|
+
|
|
187
202
|
## AI plans, and what they are generated from
|
|
188
203
|
|
|
189
204
|
A plan is a **week** of drafts written by a model: you queue it, a job generates it, and what comes
|
|
@@ -255,7 +270,7 @@ memorising numbers:
|
|
|
255
270
|
| 1100-1111 | `organization` | `OrganizationError` |
|
|
256
271
|
| 1200-1207 | `role` | `PlanVortexError` |
|
|
257
272
|
| 1300-1308, 1400-1408 | `plan_limit` | `PlanLimitError` |
|
|
258
|
-
| 1500-
|
|
273
|
+
| 1500-1516 | `messaging` | `MessagingError` |
|
|
259
274
|
| 1600-1601 | `contact` | `ContactError` |
|
|
260
275
|
| 1900-1906 | `payment` | `PlanVortexError` |
|
|
261
276
|
| 2000-2099 | `product` | `ProductError` |
|