daknode 0.3.9__tar.gz → 0.3.10__tar.gz

daknode-0.3.10/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.4
+Name: daknode
+Version: 0.3.10
+Summary: Typed sync and async client for DakNode's email and inbox-calendar API
+Keywords: daknode,email,calendar,sdk
+Requires-Python: >=3.9,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: attrs (>=22.2.0)
+Requires-Dist: httpx (>=0.23.0,<0.29.0)
+Requires-Dist: python-dateutil (>=2.8.0,<3.0.0)
+Project-URL: Documentation, https://daknode.com/integrations/python/
+Project-URL: Homepage, https://daknode.com
+Project-URL: Security, https://daknode.com/security/reporting/
+Description-Content-Type: text/markdown
+
+# DakNode Python SDK
+
+Typed synchronous and asynchronous client for DakNode's public email and
+inbox-calendar API. Keep credentials on your server, never in browser code.
+
+## Install and configure
+
+Use Python 3.10+ for this starter, in an isolated virtual environment.
+
+```sh
+python -m pip install 'daknode>=0.3.9,<0.4'
+```
+
+Configure DAKNODE_API_KEY through your server's private secret settings and
+DAKNODE_INBOX_ID with an inbox UUID you are authorized to read. Obtain both from
+the console. Do not put keys in command arguments, chat, source control or logs.
+The operation needs messages.read. Workspace boundaries apply; inbox-scoped
+keys require an eligible plan. Do not add send permissions for this example.
+
+## First operation: count one page
+
+Save this tested starter as daknode_tools.py, then run
+`python daknode_tools.py` in the configured environment. It makes one bounded
+read and prints only a count. Importing the module performs no request.
+
+```python
+"""Customer-side tools: one bounded SDK read, no mail contents or agent loop."""
+import os
+from uuid import UUID
+
+from daknode import AuthenticatedClient
+from daknode.api.messages import list_messages
+
+
+def count_recent_mail() -> int:
+    """Count up to ten retained messages in the privately configured inbox."""
+    key = os.environ.get("DAKNODE_API_KEY", "").strip()
+    identifier = os.environ.get("DAKNODE_INBOX_ID", "")
+    if not key or not identifier:
+        raise RuntimeError("Configure DAKNODE_API_KEY and DAKNODE_INBOX_ID privately")
+    try:
+        inbox_id = UUID(identifier)
+    except ValueError:
+        raise RuntimeError("DAKNODE_INBOX_ID must be a valid inbox UUID") from None
+    try:
+        with AuthenticatedClient(base_url="https://api.daknode.com", token=key, timeout=10) as client:
+            response = list_messages.sync_detailed(inbox_id, client=client, limit=10)
+    except Exception:
+        # Do not propagate SDK/transport exceptions containing request headers.
+        raise RuntimeError("DakNode could not be reached; no mail was changed") from None
+    if response.status_code != 200 or response.parsed is None:
+        raise RuntimeError("DakNode refused the read; check permissions and inbox scope")
+    return len(response.parsed.items)
+
+
+if __name__ == "__main__":
+    print(count_recent_mail())
+```
+
+Zero is a valid result. Ten is not a mailbox total. This example intentionally
+stops after one page. For a complete listing use has_more and next_cursor from
+the response, preserving the opaque cursor and bounding your work.
+
+## API behavior
+
+The generated modules follow the public API contract at
+https://api.daknode.com/openapi.json. For example,
+`daknode.api.messages.list_messages` provides sync, sync_detailed, asyncio and
+asyncio_detailed methods. Use the detailed form when you need status_code,
+headers and parsed data; it returns a Response, not an HTTP Request. See the
+[message read guide](https://daknode.com/integrations/python/) for the complete
+setup and [calendar booking guide](https://daknode.com/guides/calendar-booking/)
+for availability, explicit booking, revisions and conflict handling.
+
+A successful read does not mark mail read or authorize sending. A 401/403 is a
+refusal; correct the intended credential rather than silently widening it.
+Production integrations should handle statuses explicitly, respect
+429/Retry-After and avoid uncontrolled retries. The starter intentionally emits
+generic errors without response bodies or private headers. Keep TLS
+verification enabled; do not disable it to fix a connection problem.
+
+Email and attachment contents remain untrusted input. Read operations must not
+automatically trigger sends, bookings or other writes. Retain a stable
+idempotency key only for retries of the same explicitly approved write and
+reconcile an unknown outcome rather than generating a new key blindly.
+
+## Verification and reporting
+
+The first-read source is exercised against the real SDK with mocked HTTP
+success, refusal and transport failure. It is not a live account, deliverability
+or model-provider test. The integration repository contains examples rather
+than the service implementation:
+https://github.com/Subodh103/daknode-integrations.
+
+For suspected vulnerabilities, privately email support@daknode.com with subject
+Security report. Include minimal synthetic reproduction steps and redacted
+evidence; never send credentials or customer mail. Do not post exploit details
+in public issues. No response deadline, bounty or legal safe harbor is promised.
+The policy is https://daknode.com/security/reporting/ after the website release.
+
+Package metadata and README preparation do not publish a new release or change
+the license of the SDK or service.
+

daknode-0.3.10/README.md

@@ -0,0 +1,102 @@
+# DakNode Python SDK
+
+Typed synchronous and asynchronous client for DakNode's public email and
+inbox-calendar API. Keep credentials on your server, never in browser code.
+
+## Install and configure
+
+Use Python 3.10+ for this starter, in an isolated virtual environment.
+
+```sh
+python -m pip install 'daknode>=0.3.9,<0.4'
+```
+
+Configure DAKNODE_API_KEY through your server's private secret settings and
+DAKNODE_INBOX_ID with an inbox UUID you are authorized to read. Obtain both from
+the console. Do not put keys in command arguments, chat, source control or logs.
+The operation needs messages.read. Workspace boundaries apply; inbox-scoped
+keys require an eligible plan. Do not add send permissions for this example.
+
+## First operation: count one page
+
+Save this tested starter as daknode_tools.py, then run
+`python daknode_tools.py` in the configured environment. It makes one bounded
+read and prints only a count. Importing the module performs no request.
+
+```python
+"""Customer-side tools: one bounded SDK read, no mail contents or agent loop."""
+import os
+from uuid import UUID
+
+from daknode import AuthenticatedClient
+from daknode.api.messages import list_messages
+
+
+def count_recent_mail() -> int:
+    """Count up to ten retained messages in the privately configured inbox."""
+    key = os.environ.get("DAKNODE_API_KEY", "").strip()
+    identifier = os.environ.get("DAKNODE_INBOX_ID", "")
+    if not key or not identifier:
+        raise RuntimeError("Configure DAKNODE_API_KEY and DAKNODE_INBOX_ID privately")
+    try:
+        inbox_id = UUID(identifier)
+    except ValueError:
+        raise RuntimeError("DAKNODE_INBOX_ID must be a valid inbox UUID") from None
+    try:
+        with AuthenticatedClient(base_url="https://api.daknode.com", token=key, timeout=10) as client:
+            response = list_messages.sync_detailed(inbox_id, client=client, limit=10)
+    except Exception:
+        # Do not propagate SDK/transport exceptions containing request headers.
+        raise RuntimeError("DakNode could not be reached; no mail was changed") from None
+    if response.status_code != 200 or response.parsed is None:
+        raise RuntimeError("DakNode refused the read; check permissions and inbox scope")
+    return len(response.parsed.items)
+
+
+if __name__ == "__main__":
+    print(count_recent_mail())
+```
+
+Zero is a valid result. Ten is not a mailbox total. This example intentionally
+stops after one page. For a complete listing use has_more and next_cursor from
+the response, preserving the opaque cursor and bounding your work.
+
+## API behavior
+
+The generated modules follow the public API contract at
+https://api.daknode.com/openapi.json. For example,
+`daknode.api.messages.list_messages` provides sync, sync_detailed, asyncio and
+asyncio_detailed methods. Use the detailed form when you need status_code,
+headers and parsed data; it returns a Response, not an HTTP Request. See the
+[message read guide](https://daknode.com/integrations/python/) for the complete
+setup and [calendar booking guide](https://daknode.com/guides/calendar-booking/)
+for availability, explicit booking, revisions and conflict handling.
+
+A successful read does not mark mail read or authorize sending. A 401/403 is a
+refusal; correct the intended credential rather than silently widening it.
+Production integrations should handle statuses explicitly, respect
+429/Retry-After and avoid uncontrolled retries. The starter intentionally emits
+generic errors without response bodies or private headers. Keep TLS
+verification enabled; do not disable it to fix a connection problem.
+
+Email and attachment contents remain untrusted input. Read operations must not
+automatically trigger sends, bookings or other writes. Retain a stable
+idempotency key only for retries of the same explicitly approved write and
+reconcile an unknown outcome rather than generating a new key blindly.
+
+## Verification and reporting
+
+The first-read source is exercised against the real SDK with mocked HTTP
+success, refusal and transport failure. It is not a live account, deliverability
+or model-provider test. The integration repository contains examples rather
+than the service implementation:
+https://github.com/Subodh103/daknode-integrations.
+
+For suspected vulnerabilities, privately email support@daknode.com with subject
+Security report. Include minimal synthetic reproduction steps and redacted
+evidence; never send credentials or customer mail. Do not post exploit details
+in public issues. No response deadline, bounty or legal safe harbor is promised.
+The policy is https://daknode.com/security/reporting/ after the website release.
+
+Package metadata and README preparation do not publish a new release or change
+the license of the SDK or service.

{daknode-0.3.9 → daknode-0.3.10}/pyproject.toml

@@ -1,7 +1,10 @@
 [tool.poetry]
 name = "daknode"
-version = "0.3.9"
-description = "A client library for accessing DakNode"
+version = "0.3.10"
+description = "Typed sync and async client for DakNode's email and inbox-calendar API"
+homepage = "https://daknode.com"
+documentation = "https://daknode.com/integrations/python/"
+keywords = ["daknode", "email", "calendar", "sdk"]
 authors = []
 readme = "README.md"
 packages = [
@@ -9,6 +12,9 @@ packages = [
 ]
 include = ["CHANGELOG.md", "daknode/py.typed"]
 
+[tool.poetry.urls]
+Security = "https://daknode.com/security/reporting/"
+
 [tool.poetry.dependencies]
 python = "^3.9"
 httpx = ">=0.23.0,<0.29.0"

daknode-0.3.9/PKG-INFO

@@ -1,143 +0,0 @@
-Metadata-Version: 2.4
-Name: daknode
-Version: 0.3.9
-Summary: A client library for accessing DakNode
-Requires-Python: >=3.9,<4.0
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: 3.15
-Requires-Dist: attrs (>=22.2.0)
-Requires-Dist: httpx (>=0.23.0,<0.29.0)
-Requires-Dist: python-dateutil (>=2.8.0,<3.0.0)
-Description-Content-Type: text/markdown
-
-# daknode
-A client library for accessing DakNode
-
-## Usage
-First, create a client:
-
-```python
-from daknode import Client
-
-client = Client(base_url="https://api.example.com")
-```
-
-If the endpoints you're going to hit require authentication, use `AuthenticatedClient` instead:
-
-```python
-from daknode import AuthenticatedClient
-
-client = AuthenticatedClient(base_url="https://api.example.com", token="SuperSecretToken")
-```
-
-Now call your endpoint and use your models:
-
-```python
-from daknode.models import MyDataModel
-from daknode.api.my_tag import get_my_data_model
-from daknode.types import Response
-
-with client as client:
-    my_data: MyDataModel = get_my_data_model.sync(client=client)
-    # or if you need more info (e.g. status_code)
-    response: Response[MyDataModel] = get_my_data_model.sync_detailed(client=client)
-```
-
-Or do the same thing with an async version:
-
-```python
-from daknode.models import MyDataModel
-from daknode.api.my_tag import get_my_data_model
-from daknode.types import Response
-
-async with client as client:
-    my_data: MyDataModel = await get_my_data_model.asyncio(client=client)
-    response: Response[MyDataModel] = await get_my_data_model.asyncio_detailed(client=client)
-```
-
-By default, when you're calling an HTTPS API it will attempt to verify that SSL is working correctly. Using certificate verification is highly recommended most of the time, but sometimes you may need to authenticate to a server (especially an internal server) using a custom certificate bundle.
-
-```python
-client = AuthenticatedClient(
-    base_url="https://internal_api.example.com",
-    token="SuperSecretToken",
-    verify_ssl="/path/to/certificate_bundle.pem",
-)
-```
-
-You can also disable certificate validation altogether, but beware that **this is a security risk**.
-
-```python
-client = AuthenticatedClient(
-    base_url="https://internal_api.example.com",
-    token="SuperSecretToken",
-    verify_ssl=False
-)
-```
-
-Things to know:
-1. Every path/method combo becomes a Python module with four functions:
-    1. `sync`: Blocking request that returns parsed data (if successful) or `None`
-    1. `sync_detailed`: Blocking request that always returns a `Request`, optionally with `parsed` set if the request was successful.
-    1. `asyncio`: Like `sync` but async instead of blocking
-    1. `asyncio_detailed`: Like `sync_detailed` but async instead of blocking
-
-1. All path/query params, and bodies become method arguments.
-1. If your endpoint had any tags on it, the first tag will be used as a module name for the function (my_tag above)
-1. Any endpoint which did not have a tag will be in `daknode.api.default`
-
-## Advanced customizations
-
-There are more settings on the generated `Client` class which let you control more runtime behavior, check out the docstring on that class for more info. You can also customize the underlying `httpx.Client` or `httpx.AsyncClient` (depending on your use-case):
-
-```python
-from daknode import Client
-
-def log_request(request):
-    print(f"Request event hook: {request.method} {request.url} - Waiting for response")
-
-def log_response(response):
-    request = response.request
-    print(f"Response event hook: {request.method} {request.url} - Status {response.status_code}")
-
-client = Client(
-    base_url="https://api.example.com",
-    httpx_args={"event_hooks": {"request": [log_request], "response": [log_response]}},
-)
-
-# Or get the underlying httpx client to modify directly with client.get_httpx_client() or client.get_async_httpx_client()
-```
-
-You can even set the httpx client directly, but beware that this will override any existing settings (e.g., base_url):
-
-```python
-import httpx
-from daknode import Client
-
-client = Client(
-    base_url="https://api.example.com",
-)
-# Note that base_url needs to be re-set, as would any shared cookies, headers, etc.
-client.set_httpx_client(httpx.Client(base_url="https://api.example.com", proxies="http://localhost:8030"))
-```
-
-## Building / publishing this package
-This project uses [Poetry](https://python-poetry.org/) to manage dependencies  and packaging.  Here are the basics:
-1. Update the metadata in pyproject.toml (e.g. authors, version)
-1. If you're using a private repository, configure it with Poetry
-    1. `poetry config repositories.<your-repository-name> <url-to-your-repository>`
-    1. `poetry config http-basic.<your-repository-name> <username> <password>`
-1. Publish the client with `poetry publish --build -r <your-repository-name>` or, if for public PyPI, just `poetry publish --build`
-
-If you want to install this client into another project without publishing it (e.g. for development) then:
-1. If that project **is using Poetry**, you can simply do `poetry add <path-to-this-client>` from that project
-1. If that project is not using Poetry:
-    1. Build a wheel with `poetry build -f wheel`
-    1. Install that wheel from the other project `pip install <path-to-wheel>`
-

daknode-0.3.9/README.md

@@ -1,124 +0,0 @@
-# daknode
-A client library for accessing DakNode
-
-## Usage
-First, create a client:
-
-```python
-from daknode import Client
-
-client = Client(base_url="https://api.example.com")
-```
-
-If the endpoints you're going to hit require authentication, use `AuthenticatedClient` instead:
-
-```python
-from daknode import AuthenticatedClient
-
-client = AuthenticatedClient(base_url="https://api.example.com", token="SuperSecretToken")
-```
-
-Now call your endpoint and use your models:
-
-```python
-from daknode.models import MyDataModel
-from daknode.api.my_tag import get_my_data_model
-from daknode.types import Response
-
-with client as client:
-    my_data: MyDataModel = get_my_data_model.sync(client=client)
-    # or if you need more info (e.g. status_code)
-    response: Response[MyDataModel] = get_my_data_model.sync_detailed(client=client)
-```
-
-Or do the same thing with an async version:
-
-```python
-from daknode.models import MyDataModel
-from daknode.api.my_tag import get_my_data_model
-from daknode.types import Response
-
-async with client as client:
-    my_data: MyDataModel = await get_my_data_model.asyncio(client=client)
-    response: Response[MyDataModel] = await get_my_data_model.asyncio_detailed(client=client)
-```
-
-By default, when you're calling an HTTPS API it will attempt to verify that SSL is working correctly. Using certificate verification is highly recommended most of the time, but sometimes you may need to authenticate to a server (especially an internal server) using a custom certificate bundle.
-
-```python
-client = AuthenticatedClient(
-    base_url="https://internal_api.example.com",
-    token="SuperSecretToken",
-    verify_ssl="/path/to/certificate_bundle.pem",
-)
-```
-
-You can also disable certificate validation altogether, but beware that **this is a security risk**.
-
-```python
-client = AuthenticatedClient(
-    base_url="https://internal_api.example.com",
-    token="SuperSecretToken",
-    verify_ssl=False
-)
-```
-
-Things to know:
-1. Every path/method combo becomes a Python module with four functions:
-    1. `sync`: Blocking request that returns parsed data (if successful) or `None`
-    1. `sync_detailed`: Blocking request that always returns a `Request`, optionally with `parsed` set if the request was successful.
-    1. `asyncio`: Like `sync` but async instead of blocking
-    1. `asyncio_detailed`: Like `sync_detailed` but async instead of blocking
-
-1. All path/query params, and bodies become method arguments.
-1. If your endpoint had any tags on it, the first tag will be used as a module name for the function (my_tag above)
-1. Any endpoint which did not have a tag will be in `daknode.api.default`
-
-## Advanced customizations
-
-There are more settings on the generated `Client` class which let you control more runtime behavior, check out the docstring on that class for more info. You can also customize the underlying `httpx.Client` or `httpx.AsyncClient` (depending on your use-case):
-
-```python
-from daknode import Client
-
-def log_request(request):
-    print(f"Request event hook: {request.method} {request.url} - Waiting for response")
-
-def log_response(response):
-    request = response.request
-    print(f"Response event hook: {request.method} {request.url} - Status {response.status_code}")
-
-client = Client(
-    base_url="https://api.example.com",
-    httpx_args={"event_hooks": {"request": [log_request], "response": [log_response]}},
-)
-
-# Or get the underlying httpx client to modify directly with client.get_httpx_client() or client.get_async_httpx_client()
-```
-
-You can even set the httpx client directly, but beware that this will override any existing settings (e.g., base_url):
-
-```python
-import httpx
-from daknode import Client
-
-client = Client(
-    base_url="https://api.example.com",
-)
-# Note that base_url needs to be re-set, as would any shared cookies, headers, etc.
-client.set_httpx_client(httpx.Client(base_url="https://api.example.com", proxies="http://localhost:8030"))
-```
-
-## Building / publishing this package
-This project uses [Poetry](https://python-poetry.org/) to manage dependencies  and packaging.  Here are the basics:
-1. Update the metadata in pyproject.toml (e.g. authors, version)
-1. If you're using a private repository, configure it with Poetry
-    1. `poetry config repositories.<your-repository-name> <url-to-your-repository>`
-    1. `poetry config http-basic.<your-repository-name> <username> <password>`
-1. Publish the client with `poetry publish --build -r <your-repository-name>` or, if for public PyPI, just `poetry publish --build`
-
-If you want to install this client into another project without publishing it (e.g. for development) then:
-1. If that project **is using Poetry**, you can simply do `poetry add <path-to-this-client>` from that project
-1. If that project is not using Poetry:
-    1. Build a wheel with `poetry build -f wheel`
-    1. Install that wheel from the other project `pip install <path-to-wheel>`