planvortex 0.18.0__tar.gz → 0.20.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.
Files changed (109) hide show
  1. {planvortex-0.18.0 → planvortex-0.20.0}/CHANGELOG.md +61 -0
  2. {planvortex-0.18.0 → planvortex-0.20.0}/PKG-INFO +2 -2
  3. {planvortex-0.18.0 → planvortex-0.20.0}/README.md +1 -1
  4. {planvortex-0.18.0 → planvortex-0.20.0}/openapi/planvortex.openapi.json +188 -35
  5. {planvortex-0.18.0 → planvortex-0.20.0}/pyproject.toml +1 -1
  6. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/errors.py +4 -3
  7. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_generated/models.py +60 -7
  8. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_shapes.py +9 -3
  9. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_version.py +1 -1
  10. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/accounts.py +6 -5
  11. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/catalog.py +2 -1
  12. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/clients.py +8 -5
  13. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/contacts.py +3 -0
  14. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/organizations.py +8 -3
  15. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/accounts.py +6 -5
  16. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/catalog.py +2 -1
  17. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/clients.py +2 -2
  18. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/organizations.py +8 -3
  19. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/types.py +8 -1
  20. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_core.py +4 -1
  21. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_models.py +15 -0
  22. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_organizations.py +20 -0
  23. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_types.py +11 -1
  24. {planvortex-0.18.0 → planvortex-0.20.0}/.gitignore +0 -0
  25. {planvortex-0.18.0 → planvortex-0.20.0}/LICENSE +0 -0
  26. {planvortex-0.18.0 → planvortex-0.20.0}/scripts/build_docs.py +0 -0
  27. {planvortex-0.18.0 → planvortex-0.20.0}/scripts/check_packaging.py +0 -0
  28. {planvortex-0.18.0 → planvortex-0.20.0}/scripts/generate_models.py +0 -0
  29. {planvortex-0.18.0 → planvortex-0.20.0}/scripts/generate_sync.py +0 -0
  30. {planvortex-0.18.0 → planvortex-0.20.0}/scripts/route_coverage.py +0 -0
  31. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/__init__.py +0 -0
  32. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_client.py +0 -0
  33. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_client_sync.py +0 -0
  34. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/__init__.py +0 -0
  35. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/auth.py +0 -0
  36. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/auth_sync.py +0 -0
  37. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/files.py +0 -0
  38. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/http.py +0 -0
  39. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/http_sync.py +0 -0
  40. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/pagination.py +0 -0
  41. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/query.py +0 -0
  42. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_core/transport.py +0 -0
  43. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/_generated/__init__.py +0 -0
  44. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/py.typed +0 -0
  45. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/__init__.py +0 -0
  46. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/ai_plans.py +0 -0
  47. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/apps.py +0 -0
  48. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/base.py +0 -0
  49. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/comments.py +0 -0
  50. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/dashboard.py +0 -0
  51. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/integrations.py +0 -0
  52. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/messages.py +0 -0
  53. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/products.py +0 -0
  54. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/publications.py +0 -0
  55. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources/uploads.py +0 -0
  56. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/__init__.py +0 -0
  57. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/ai_plans.py +0 -0
  58. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/apps.py +0 -0
  59. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/base.py +0 -0
  60. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/comments.py +0 -0
  61. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/contacts.py +0 -0
  62. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/dashboard.py +0 -0
  63. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/integrations.py +0 -0
  64. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/messages.py +0 -0
  65. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/products.py +0 -0
  66. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/publications.py +0 -0
  67. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/resources_sync/uploads.py +0 -0
  68. {planvortex-0.18.0 → planvortex-0.20.0}/src/planvortex/webhooks.py +0 -0
  69. {planvortex-0.18.0 → planvortex-0.20.0}/tests/__init__.py +0 -0
  70. {planvortex-0.18.0 → planvortex-0.20.0}/tests/conftest.py +0 -0
  71. {planvortex-0.18.0 → planvortex-0.20.0}/tests/contrato.py +0 -0
  72. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/__init__.py +0 -0
  73. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/conftest.py +0 -0
  74. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/test_auth.py +0 -0
  75. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/test_catalog.py +0 -0
  76. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/test_connect_flow.py +0 -0
  77. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/test_errors.py +0 -0
  78. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/test_publish.py +0 -0
  79. {planvortex-0.18.0 → planvortex-0.20.0}/tests/live/test_read.py +0 -0
  80. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_accounts.py +0 -0
  81. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_ai_plans.py +0 -0
  82. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_apps.py +0 -0
  83. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_catalog.py +0 -0
  84. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_client.py +0 -0
  85. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_clients.py +0 -0
  86. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_comments.py +0 -0
  87. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_contacts.py +0 -0
  88. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_dashboard.py +0 -0
  89. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_example_comments.py +0 -0
  90. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_example_connect.py +0 -0
  91. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_example_publish.py +0 -0
  92. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_example_schedule.py +0 -0
  93. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_example_webhooks.py +0 -0
  94. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_files.py +0 -0
  95. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_generate_models.py +0 -0
  96. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_generate_sync.py +0 -0
  97. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_integrations.py +0 -0
  98. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_messages.py +0 -0
  99. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_openapi_freshness.py +0 -0
  100. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_packaging.py +0 -0
  101. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_pagination.py +0 -0
  102. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_products.py +0 -0
  103. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_publications.py +0 -0
  104. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_query_parity.py +0 -0
  105. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_readme.py +0 -0
  106. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_route_coverage.py +0 -0
  107. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_shapes_parity.py +0 -0
  108. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_uploads.py +0 -0
  109. {planvortex-0.18.0 → planvortex-0.20.0}/tests/test_webhooks.py +0 -0
@@ -6,6 +6,67 @@ All notable changes to this package are documented here. The format follows
6
6
 
7
7
  ## [Unreleased]
8
8
 
9
+ ## [0.20.0] - 2026-11-17
10
+
11
+ ### Added
12
+
13
+ - **`own_use` on an organization** (with `get_use=True`, in `organizations.get()`, `children()` and
14
+ `clients.organizations()`): what that organization uses on its own, without the folders it shares
15
+ a plan with. `actual_use` is still the figure of the whole pool it draws from, the one the server
16
+ checks before letting one more account in, so every organization in a pool shows the same
17
+ `actual_use`. Adding up the `own_use` of the organizations in a pool gives its `actual_use`.
18
+ `organizations.use()` now returns it too (`OrganizationUse.own_use`). Absent from a server older
19
+ than November 2026.
20
+ - **`pool_use` on a client** (with `get_use=True`): what the client's shared pool is using, that
21
+ is, the organizations without a plan of their own that draw straight from the client. With
22
+ `actual_asigned` and `actual_plan["plan_data"]` it splits the plan in three: used by the shared
23
+ pool, free in the shared pool (`plan_data` minus `actual_asigned` minus `pool_use`) and handed out
24
+ to organizations with a plan of their own.
25
+ - The regenerated models also carry `Message.delivery_status` (`"sent"`, `"delivered"`, `"read"`
26
+ or `"failed"`), how far a message we sent got, like the ticks in WhatsApp (typing only: the field
27
+ already came back from the API).
28
+
29
+ ### Changed
30
+
31
+ - **A client's `actual_use` now counts every organization of the client**, which is the figure
32
+ billing charges for. It used to count only the shared pool, so it did not match the accounts on
33
+ the invoice as soon as an organization had a plan of its own. What it counted before is now
34
+ `pool_use`. This is a server change: an organization's `actual_use` keeps its meaning.
35
+ - Users in a client's or an organization's consumption are now counted as people: someone with a
36
+ role in three organizations used to count three times.
37
+ - On the free plan `google_business` joins `whatsapp` as a network that needs a paid plan: it is
38
+ left out of the connect links, a temporal connect token asked for it answers error 516 and so
39
+ does enabling a new account, because reviews are behind a paid plan. An organization that
40
+ already has an active one can still reconnect it. This is a server change; only the
41
+ descriptions of the regenerated types say so.
42
+
43
+ ## [0.19.0] - 2026-11-13
44
+
45
+ ### Added
46
+
47
+ - **`statistics` in `catalog.social_capabilities()`.** `True` when PlanVortex reads any metric
48
+ of that network: every network but `whatsapp` today. Use it to decide which accounts to offer on
49
+ a statistics screen instead of finding out from an empty series, or ask the server directly with
50
+ `accounts.list(org, capability="statistics")`.
51
+ - The regenerated models also carry `Message.reactions`, the emoji reactions a message has on
52
+ WhatsApp, Instagram, Messenger and Bluesky (typing only: the field already came back from the API).
53
+ - **`user_id` on `SocialIdentifier` (WhatsApp).** The person's business-scoped user id at Meta
54
+ (BSUID), such as `ES.13491208655302741918`. Since 2026 Meta may leave the phone number out for
55
+ people who use a WhatsApp username and have not dealt with that business number by phone in the
56
+ last 30 days. For them the WhatsApp `external_identifier` **is the BSUID, not a phone number**: it
57
+ has a country code and a dot in front, so don't show it or dial it as one. You can still write to
58
+ them, and when their number arrives later the same contact gets it, with the same `_id` and
59
+ messages.
60
+ - The regenerated models also carry two things the API added to the spec: the `playable` query
61
+ parameter on the file downloads (`download_file()` does not take it yet) and the per-account
62
+ `accounts` list in the `unread_messages` response (`unread_count()` still returns the total).
63
+
64
+ ### Fixed
65
+
66
+ - **Error 1517 is a `MessagingError`.** It is an audio or a video that could not be converted with
67
+ `playable`; the original file is still there without the parameter. It was above the top of the
68
+ messaging range and arrived as the base error.
69
+
9
70
  ## [0.18.0] - 2026-11-10
10
71
 
11
72
  ### Added
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: planvortex
3
- Version: 0.18.0
3
+ Version: 0.20.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/
@@ -300,7 +300,7 @@ memorising numbers:
300
300
  | 1100-1111 | `organization` | `OrganizationError` |
301
301
  | 1200-1207 | `role` | `PlanVortexError` |
302
302
  | 1300-1308, 1400-1408 | `plan_limit` | `PlanLimitError` |
303
- | 1500-1516 | `messaging` | `MessagingError` |
303
+ | 1500-1517 | `messaging` | `MessagingError` |
304
304
  | 1600-1601 | `contact` | `ContactError` |
305
305
  | 1900-1906 | `payment` | `PlanVortexError` |
306
306
  | 2000-2099 | `product` | `ProductError` |
@@ -270,7 +270,7 @@ memorising numbers:
270
270
  | 1100-1111 | `organization` | `OrganizationError` |
271
271
  | 1200-1207 | `role` | `PlanVortexError` |
272
272
  | 1300-1308, 1400-1408 | `plan_limit` | `PlanLimitError` |
273
- | 1500-1516 | `messaging` | `MessagingError` |
273
+ | 1500-1517 | `messaging` | `MessagingError` |
274
274
  | 1600-1601 | `contact` | `ContactError` |
275
275
  | 1900-1906 | `payment` | `PlanVortexError` |
276
276
  | 2000-2099 | `product` | `ProductError` |