render-lab-tasks-cloudflare 0.1.0__tar.gz

render_lab_tasks_cloudflare-0.1.0/.gitignore

@@ -0,0 +1,11 @@
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/
+*.egg-info/
+.env
+.env.*
+!.env.example

render_lab_tasks_cloudflare-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Render Lab
+
+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.

render_lab_tasks_cloudflare-0.1.0/PKG-INFO

@@ -0,0 +1,69 @@
+Metadata-Version: 2.5
+Name: render-lab-tasks-cloudflare
+Version: 0.1.0
+Summary: cloudflare tasks for Render Workflows
+Project-URL: Repository, https://github.com/render-lab/render-tasks-python
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: httpx<0.29,>=0.28
+Requires-Dist: render-lab-tasks-core<0.2,>=0.1.0
+Requires-Dist: render==1.0.1
+Description-Content-Type: text/markdown
+
+# render-lab-tasks-cloudflare
+
+Python port of all 7 registered tasks in the pinned TypeScript pack at
+`45f9c2d44bd28e01ae9813e0d2ff56ee6c533816`. Python 3.12+.
+
+From the repository, install this pack and its supporting core together:
+
+```sh
+pip install render-lab-tasks-cloudflare==0.1.0
+```
+
+Import task definitions from `render_lab_tasks_cloudflare.tasks`. Combine its `app` with
+other pack apps using `Workflows.from_workflows(...)` and call tasks with
+`await ctx.run(task, input)`. Package roots do not register tasks. JSON fields
+retain the TS spelling; Python functions use snake_case.
+
+## Tasks
+
+| Registered name | Python export (also exposes `_impl`) |
+| --- | --- |
+| `cloudflare.deleteDnsRecord` | `delete_dns_record` |
+| `cloudflare.deployWorker` | `deploy_worker` |
+| `cloudflare.dnsUpsert` | `dns_upsert` |
+| `cloudflare.listDnsRecords` | `list_dns_records` |
+| `cloudflare.purgeCache` | `purge_cache` |
+| `cloudflare.workersKvGet` | `workers_kv_get` |
+| `cloudflare.workersKvPut` | `workers_kv_put` |
+
+## Dependencies and retries
+
+Raw implementations accept context first and keyword-only `deps`. The `.client`
+module exports typed `Port`, `Deps`, and `Client` classes (also vendor-named aliases).
+Inject a fake port, or pass a caller-owned `httpx.AsyncClient` to `Client` for custom
+transport/configuration. Default dependencies close their HTTP clients after the
+operation. Credentials resolve at first use. HTTP and SDK retries are disabled;
+`retry.py` owns durable retry settings. DTO types live in `.types`.
+
+## Environment
+
+| Variable | Contract |
+| --- | --- |
+| `CLOUDFLARE_API_TOKEN` | Required on API calls. |
+| `CLOUDFLARE_ZONE_ID` | Default zone when zoneId is omitted. |
+| `CLOUDFLARE_ACCOUNT_ID` | Default account when accountId is omitted. |
+| `CLOUDFLARE_KV_NAMESPACE_ID` | Default KV namespace when namespaceId is omitted. |
+
+## Verification and limitations
+
+DNS upsert is a read-then-write operation and is not atomic. Worker upload sends a multipart ES module (`worker.js`) plus JSON metadata, correcting the pinned TS request (ADR-0007). Supply a single JavaScript ES module in `script`. Bindings, assets, routes, and compatibility dates are outside this input surface; Cloudflare applies its default compatibility date. Live Worker validation remains pending. KV GET returns null on 404 and preserves empty text values.
+
+Shared JSON fixtures compare the Python task output with the actual pinned TS
+implementation. REST fixtures also compare HTTP requests; HubSpot and Linear
+fixtures compare source SDK arguments with HTTP payloads/GraphQL variables.
+No live vendor calls were made for this batch. Registered-task parity does not
+claim live readiness or all supporting TS exports. See the root verification
+tracker and docs/porting-batches.md. Licensed under MIT.

render_lab_tasks_cloudflare-0.1.0/README.md

@@ -0,0 +1,56 @@
+# render-lab-tasks-cloudflare
+
+Python port of all 7 registered tasks in the pinned TypeScript pack at
+`45f9c2d44bd28e01ae9813e0d2ff56ee6c533816`. Python 3.12+.
+
+From the repository, install this pack and its supporting core together:
+
+```sh
+pip install render-lab-tasks-cloudflare==0.1.0
+```
+
+Import task definitions from `render_lab_tasks_cloudflare.tasks`. Combine its `app` with
+other pack apps using `Workflows.from_workflows(...)` and call tasks with
+`await ctx.run(task, input)`. Package roots do not register tasks. JSON fields
+retain the TS spelling; Python functions use snake_case.
+
+## Tasks
+
+| Registered name | Python export (also exposes `_impl`) |
+| --- | --- |
+| `cloudflare.deleteDnsRecord` | `delete_dns_record` |
+| `cloudflare.deployWorker` | `deploy_worker` |
+| `cloudflare.dnsUpsert` | `dns_upsert` |
+| `cloudflare.listDnsRecords` | `list_dns_records` |
+| `cloudflare.purgeCache` | `purge_cache` |
+| `cloudflare.workersKvGet` | `workers_kv_get` |
+| `cloudflare.workersKvPut` | `workers_kv_put` |
+
+## Dependencies and retries
+
+Raw implementations accept context first and keyword-only `deps`. The `.client`
+module exports typed `Port`, `Deps`, and `Client` classes (also vendor-named aliases).
+Inject a fake port, or pass a caller-owned `httpx.AsyncClient` to `Client` for custom
+transport/configuration. Default dependencies close their HTTP clients after the
+operation. Credentials resolve at first use. HTTP and SDK retries are disabled;
+`retry.py` owns durable retry settings. DTO types live in `.types`.
+
+## Environment
+
+| Variable | Contract |
+| --- | --- |
+| `CLOUDFLARE_API_TOKEN` | Required on API calls. |
+| `CLOUDFLARE_ZONE_ID` | Default zone when zoneId is omitted. |
+| `CLOUDFLARE_ACCOUNT_ID` | Default account when accountId is omitted. |
+| `CLOUDFLARE_KV_NAMESPACE_ID` | Default KV namespace when namespaceId is omitted. |
+
+## Verification and limitations
+
+DNS upsert is a read-then-write operation and is not atomic. Worker upload sends a multipart ES module (`worker.js`) plus JSON metadata, correcting the pinned TS request (ADR-0007). Supply a single JavaScript ES module in `script`. Bindings, assets, routes, and compatibility dates are outside this input surface; Cloudflare applies its default compatibility date. Live Worker validation remains pending. KV GET returns null on 404 and preserves empty text values.
+
+Shared JSON fixtures compare the Python task output with the actual pinned TS
+implementation. REST fixtures also compare HTTP requests; HubSpot and Linear
+fixtures compare source SDK arguments with HTTP payloads/GraphQL variables.
+No live vendor calls were made for this batch. Registered-task parity does not
+claim live readiness or all supporting TS exports. See the root verification
+tracker and docs/porting-batches.md. Licensed under MIT.

render_lab_tasks_cloudflare-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling>=1.27,<2"]
+build-backend = "hatchling.build"
+
+[project]
+name = "render-lab-tasks-cloudflare"
+version = "0.1.0"
+description = "cloudflare tasks for Render Workflows"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.12"
+dependencies = ["render==1.0.1", "httpx>=0.28,<0.29", "render-lab-tasks-core>=0.1.0,<0.2"]
+
+[project.urls]
+Repository = "https://github.com/render-lab/render-tasks-python"
+
+[tool.uv.sources]
+render-lab-tasks-core = { workspace = true }
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/render_lab_tasks_cloudflare"]

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/__init__.py

@@ -0,0 +1 @@
+"""Import .tasks explicitly to register durable tasks."""

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/_app.py

@@ -0,0 +1,3 @@
+from render import Workflows
+
+app = Workflows()

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/client.py

@@ -0,0 +1,180 @@
+"""Injected vendor interface and one-attempt async HTTP adapter."""
+
+from __future__ import annotations
+
+import json
+import os
+from collections.abc import AsyncIterator, Mapping
+from contextlib import asynccontextmanager
+from dataclasses import dataclass
+from typing import Any, Protocol
+
+import httpx
+from render_lab_tasks_core.http import ApiError, HttpClient, enc, nullish, pick, query, required
+
+from . import types as t
+
+
+class Port(Protocol):
+    async def delete_dns_record(self, input: t.DeleteDnsRecordInput) -> t.DeleteDnsRecordResult: ...
+    async def deploy_worker(self, input: t.DeployWorkerInput) -> t.DeployWorkerResult: ...
+    async def dns_upsert(self, input: t.DnsUpsertInput) -> t.DnsUpsertResult: ...
+    async def list_dns_records(self, input: t.ListDnsRecordsInput) -> list[t.DnsRecord]: ...
+    async def purge_cache(self, input: t.PurgeCacheInput) -> t.PurgeCacheResult: ...
+    async def workers_kv_get(self, input: t.WorkersKvGetInput) -> t.WorkersKvGetResult: ...
+    async def workers_kv_put(self, input: t.WorkersKvPutInput) -> t.WorkersKvPutResult: ...
+
+
+@dataclass(frozen=True)
+class Deps:
+    cloudflare: Port
+
+
+class Client:
+    def __init__(self, http: httpx.AsyncClient, env: Mapping[str, str] | None = None) -> None:
+        self.env = os.environ if env is None else env
+        self.http = HttpClient(
+            http,
+            "https://api.cloudflare.com/client/v4",
+            auth=lambda: {"authorization": "Bearer " + required(self.env, "CLOUDFLARE_API_TOKEN")},
+            label="Cloudflare API",
+        )
+
+    def _id(self, input: Mapping[str, Any], field: str, env: str) -> str:
+        value = nullish(input.get(field), self.env.get(env))
+        if not value:
+            raise ValueError(f"A {field} is required: pass {{ {field} }} or set {env}.")
+        return str(value)
+
+    def _zone(self, input: Mapping[str, Any]) -> str:
+        return self._id(input, "zoneId", "CLOUDFLARE_ZONE_ID")
+
+    def _kv(self, input: Mapping[str, Any]) -> str:
+        account = self._id(input, "accountId", "CLOUDFLARE_ACCOUNT_ID")
+        namespace = self._id(input, "namespaceId", "CLOUDFLARE_KV_NAMESPACE_ID")
+        return f"/accounts/{account}/storage/kv/namespaces/{namespace}/values/{enc(input['key'])}"
+
+    async def _call(self, path: str, **kwargs: Any) -> Any:
+        data = await self.http.call(path, **kwargs)
+        if isinstance(data, dict) and data.get("success") is False:
+            detail = "; ".join(
+                nullish(e.get("message"), "") for e in data.get("errors", []) if isinstance(e, dict)
+            )
+            raise RuntimeError(f"Cloudflare API {path} failed: {detail}".strip())
+        return data
+
+    async def purge_cache(self, input: t.PurgeCacheInput) -> Any:
+        zone = self._zone(input)
+        body = (
+            {"files": input["files"]}
+            if input.get("files")
+            else {"purge_everything": nullish(input.get("everything"), True)}
+        )
+        await self._call(f"/zones/{zone}/purge_cache", method="POST", body=body)
+        return {"zoneId": zone, "purged": True}
+
+    async def dns_upsert(self, input: t.DnsUpsertInput) -> Any:
+        path = f"/zones/{self._zone(input)}/dns_records"
+        existing = await self._call(path + "?" + query(pick(input, "type", "name")))
+        rows = (existing or {}).get("result")
+        found = rows[0] if isinstance(rows, list) and rows else None
+        body = {
+            **pick(input, "type", "name", "content"),
+            "ttl": nullish(input.get("ttl"), 1),
+            "proxied": nullish(input.get("proxied"), False),
+        }
+        data = await self._call(
+            path + (f"/{found['id']}" if found is not None else ""),
+            method="PUT" if found is not None else "POST",
+            body=body,
+        )
+        result = (data or {}).get("result") or {}
+        return {
+            "recordId": nullish(result.get("id"), ""),
+            "name": nullish(result.get("name"), input["name"]),
+        }
+
+    async def deploy_worker(self, input: t.DeployWorkerInput) -> Any:
+        account = self._id(input, "accountId", "CLOUDFLARE_ACCOUNT_ID")
+        path = f"/accounts/{account}/workers/scripts/{enc(input['scriptName'])}"
+        # Use HTTPX's multipart encoder; only the script content comes from the caller.
+        upload = httpx.Request(
+            "PUT",
+            "https://api.cloudflare.com/client/v4" + path,
+            files={
+                "metadata": (
+                    None,
+                    json.dumps({"main_module": "worker.js"}),
+                    "application/json",
+                ),
+                "worker.js": ("worker.js", input["script"], "application/javascript+module"),
+            },
+        )
+        await self._call(
+            path,
+            method="PUT",
+            raw_body=upload.read().decode("utf-8"),
+            headers={"content-type": upload.headers["content-type"]},
+        )
+        return {"scriptName": input["scriptName"], "deployed": True}
+
+    async def list_dns_records(self, input: t.ListDnsRecordsInput) -> Any:
+        params = query({k: input[k] for k in ("type", "name") if input.get(k)})
+        data = await self._call(
+            f"/zones/{self._zone(input)}/dns_records" + ("?" + params if params else "")
+        )
+        rows = (data or {}).get("result")
+        return (
+            [
+                {
+                    **{k: nullish(r.get(k), "") for k in ("id", "type", "name", "content")},
+                    "proxied": nullish(r.get("proxied"), False),
+                }
+                for r in rows
+            ]
+            if isinstance(rows, list)
+            else []
+        )
+
+    async def delete_dns_record(self, input: t.DeleteDnsRecordInput) -> Any:
+        data = await self._call(
+            f"/zones/{self._zone(input)}/dns_records/{input['recordId']}", method="DELETE"
+        )
+        return {
+            "id": nullish(((data or {}).get("result") or {}).get("id"), input["recordId"]),
+            "deleted": True,
+        }
+
+    async def workers_kv_put(self, input: t.WorkersKvPutInput) -> Any:
+        await self._call(
+            self._kv(input),
+            method="PUT",
+            raw_body=input["value"],
+            headers={"content-type": "text/plain"},
+        )
+        return {"key": input["key"], "stored": True}
+
+    async def workers_kv_get(self, input: t.WorkersKvGetInput) -> Any:
+        try:
+            value = await self.http.call(self._kv(input), response_type="text")
+        except ApiError as error:
+            if error.status != 404:
+                raise
+            value = None
+        return {"key": input["key"], "value": value}
+
+
+@asynccontextmanager
+async def dependencies(deps: Deps | None) -> AsyncIterator[Deps]:
+    if deps is not None:
+        yield deps
+    else:
+        async with httpx.AsyncClient(
+            timeout=30, transport=httpx.AsyncHTTPTransport(retries=0)
+        ) as http:
+            yield Deps(cloudflare=Client(http))
+
+
+CloudflarePort = Port
+CloudflareClient = Client
+CloudflareDeps = Deps

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/delete_dns_record.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import DeleteDnsRecordInput, DeleteDnsRecordResult
+
+
+async def delete_dns_record_impl(
+    ctx: TaskContext, input: DeleteDnsRecordInput, *, deps: Deps | None = None
+) -> DeleteDnsRecordResult:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.delete_dns_record(input)
+
+
+@app.task(name="cloudflare.deleteDnsRecord", retry=CLOUDFLARE_RETRY)
+async def delete_dns_record(ctx: TaskContext, input: DeleteDnsRecordInput) -> DeleteDnsRecordResult:
+    return await delete_dns_record_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/deploy_worker.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import DeployWorkerInput, DeployWorkerResult
+
+
+async def deploy_worker_impl(
+    ctx: TaskContext, input: DeployWorkerInput, *, deps: Deps | None = None
+) -> DeployWorkerResult:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.deploy_worker(input)
+
+
+@app.task(name="cloudflare.deployWorker", retry=CLOUDFLARE_RETRY)
+async def deploy_worker(ctx: TaskContext, input: DeployWorkerInput) -> DeployWorkerResult:
+    return await deploy_worker_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/dns_upsert.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import DnsUpsertInput, DnsUpsertResult
+
+
+async def dns_upsert_impl(
+    ctx: TaskContext, input: DnsUpsertInput, *, deps: Deps | None = None
+) -> DnsUpsertResult:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.dns_upsert(input)
+
+
+@app.task(name="cloudflare.dnsUpsert", retry=CLOUDFLARE_RETRY)
+async def dns_upsert(ctx: TaskContext, input: DnsUpsertInput) -> DnsUpsertResult:
+    return await dns_upsert_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/list_dns_records.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import DnsRecord, ListDnsRecordsInput
+
+
+async def list_dns_records_impl(
+    ctx: TaskContext, input: ListDnsRecordsInput, *, deps: Deps | None = None
+) -> list[DnsRecord]:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.list_dns_records(input)
+
+
+@app.task(name="cloudflare.listDnsRecords", retry=CLOUDFLARE_RETRY)
+async def list_dns_records(ctx: TaskContext, input: ListDnsRecordsInput) -> list[DnsRecord]:
+    return await list_dns_records_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/purge_cache.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import PurgeCacheInput, PurgeCacheResult
+
+
+async def purge_cache_impl(
+    ctx: TaskContext, input: PurgeCacheInput, *, deps: Deps | None = None
+) -> PurgeCacheResult:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.purge_cache(input)
+
+
+@app.task(name="cloudflare.purgeCache", retry=CLOUDFLARE_RETRY)
+async def purge_cache(ctx: TaskContext, input: PurgeCacheInput) -> PurgeCacheResult:
+    return await purge_cache_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/retry.py

@@ -0,0 +1,3 @@
+from render import Retry
+
+CLOUDFLARE_RETRY = Retry(max_retries=3, wait_duration_ms=1000, backoff_scaling=2)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/tasks.py

@@ -0,0 +1,26 @@
+from ._app import app
+from .delete_dns_record import delete_dns_record, delete_dns_record_impl
+from .deploy_worker import deploy_worker, deploy_worker_impl
+from .dns_upsert import dns_upsert, dns_upsert_impl
+from .list_dns_records import list_dns_records, list_dns_records_impl
+from .purge_cache import purge_cache, purge_cache_impl
+from .workers_kv_get import workers_kv_get, workers_kv_get_impl
+from .workers_kv_put import workers_kv_put, workers_kv_put_impl
+
+__all__ = [
+    "app",
+    "delete_dns_record",
+    "delete_dns_record_impl",
+    "deploy_worker",
+    "deploy_worker_impl",
+    "dns_upsert",
+    "dns_upsert_impl",
+    "list_dns_records",
+    "list_dns_records_impl",
+    "purge_cache",
+    "purge_cache_impl",
+    "workers_kv_get",
+    "workers_kv_get_impl",
+    "workers_kv_put",
+    "workers_kv_put_impl",
+]

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/types.py

@@ -0,0 +1,88 @@
+"""JSON contracts ported from the pinned TypeScript pack."""
+
+from __future__ import annotations
+
+from typing import Literal, NotRequired, TypedDict
+
+
+class PurgeCacheInput(TypedDict):
+    zoneId: NotRequired[str]
+    everything: NotRequired[bool]
+    files: NotRequired[list[str]]
+
+
+class PurgeCacheResult(TypedDict):
+    zoneId: str
+    purged: bool
+
+
+class DnsUpsertInput(TypedDict):
+    zoneId: NotRequired[str]
+    type: Literal["A"] | Literal["AAAA"] | Literal["CNAME"] | Literal["TXT"] | Literal["MX"]
+    name: str
+    content: str
+    ttl: NotRequired[float]
+    proxied: NotRequired[bool]
+
+
+class DnsUpsertResult(TypedDict):
+    recordId: str
+    name: str
+
+
+class DeployWorkerInput(TypedDict):
+    accountId: NotRequired[str]
+    scriptName: str
+    script: str
+
+
+class DeployWorkerResult(TypedDict):
+    scriptName: str
+    deployed: bool
+
+
+class ListDnsRecordsInput(TypedDict):
+    zoneId: NotRequired[str]
+    type: NotRequired[str]
+    name: NotRequired[str]
+
+
+class DnsRecord(TypedDict):
+    id: str
+    type: str
+    name: str
+    content: str
+    proxied: bool
+
+
+class DeleteDnsRecordInput(TypedDict):
+    zoneId: NotRequired[str]
+    recordId: str
+
+
+class DeleteDnsRecordResult(TypedDict):
+    id: str
+    deleted: bool
+
+
+class WorkersKvPutInput(TypedDict):
+    accountId: NotRequired[str]
+    namespaceId: NotRequired[str]
+    key: str
+    value: str
+
+
+class WorkersKvPutResult(TypedDict):
+    key: str
+    stored: bool
+
+
+class WorkersKvGetInput(TypedDict):
+    accountId: NotRequired[str]
+    namespaceId: NotRequired[str]
+    key: str
+
+
+class WorkersKvGetResult(TypedDict):
+    key: str
+    value: str | None

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/workers_kv_get.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import WorkersKvGetInput, WorkersKvGetResult
+
+
+async def workers_kv_get_impl(
+    ctx: TaskContext, input: WorkersKvGetInput, *, deps: Deps | None = None
+) -> WorkersKvGetResult:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.workers_kv_get(input)
+
+
+@app.task(name="cloudflare.workersKvGet", retry=CLOUDFLARE_RETRY)
+async def workers_kv_get(ctx: TaskContext, input: WorkersKvGetInput) -> WorkersKvGetResult:
+    return await workers_kv_get_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/src/render_lab_tasks_cloudflare/workers_kv_put.py

@@ -0,0 +1,18 @@
+from render import TaskContext
+
+from ._app import app
+from .client import Deps, dependencies
+from .retry import CLOUDFLARE_RETRY
+from .types import WorkersKvPutInput, WorkersKvPutResult
+
+
+async def workers_kv_put_impl(
+    ctx: TaskContext, input: WorkersKvPutInput, *, deps: Deps | None = None
+) -> WorkersKvPutResult:
+    async with dependencies(deps) as resolved:
+        return await resolved.cloudflare.workers_kv_put(input)
+
+
+@app.task(name="cloudflare.workersKvPut", retry=CLOUDFLARE_RETRY)
+async def workers_kv_put(ctx: TaskContext, input: WorkersKvPutInput) -> WorkersKvPutResult:
+    return await workers_kv_put_impl(ctx, input)

render_lab_tasks_cloudflare-0.1.0/tests/test_contracts.py

@@ -0,0 +1,8 @@
+import pytest
+
+from tests.batch_contracts import check_fixture, fixtures
+
+
+@pytest.mark.parametrize("case", fixtures("cloudflare"))
+async def test_ts_contract(case, ctx, monkeypatch):
+    await check_fixture(case, ctx, monkeypatch)

render_lab_tasks_cloudflare-0.1.0/tests/test_upload.py

@@ -0,0 +1,54 @@
+import json
+from email import policy
+from email.parser import BytesParser
+
+import httpx
+import pytest
+from render_lab_tasks_cloudflare.client import Client
+from render_lab_tasks_core.http import ApiError
+
+ENV = {"CLOUDFLARE_API_TOKEN": "test-token", "CLOUDFLARE_ACCOUNT_ID": "test-account"}
+
+
+async def test_upload_preserves_unicode_script_as_module_and_metadata():
+    calls = []
+    script = 'export default {fetch() {return new Response("héllo 🌍");}};\r\n'
+
+    async def handle(request):
+        calls.append(request)
+        return httpx.Response(200, json={"success": True, "result": {"id": "test-worker"}})
+
+    async with httpx.AsyncClient(transport=httpx.MockTransport(handle)) as http:
+        assert await Client(http, ENV).deploy_worker(
+            {"scriptName": "test-worker", "script": script}
+        ) == {"scriptName": "test-worker", "deployed": True}
+    assert len(calls) == 1
+    request = calls[0]
+    assert request.method == "PUT"
+    assert str(request.url).endswith("/accounts/test-account/workers/scripts/test-worker")
+    assert request.headers["authorization"] == "Bearer test-token"
+    message = BytesParser(policy=policy.default).parsebytes(
+        f"Content-Type: {request.headers['content-type']}\r\n\r\n".encode() + request.content
+    )
+    parts = list(message.iter_parts())
+    assert len(parts) == 2
+    assert parts[0].get_param("name", header="content-disposition") == "metadata"
+    assert json.loads(parts[0].get_payload(decode=True)) == {"main_module": "worker.js"}
+    assert parts[1].get_param("name", header="content-disposition") == "worker.js"
+    assert parts[1].get_content_type() == "application/javascript+module"
+    assert parts[1].get_payload(decode=True).decode() == script
+
+
+@pytest.mark.parametrize("status", [400, 429, 503])
+async def test_upload_failure_is_one_attempt(status):
+    calls = []
+
+    async def handle(request):
+        calls.append(request)
+        return httpx.Response(status, json={"success": False, "errors": []})
+
+    async with httpx.AsyncClient(transport=httpx.MockTransport(handle)) as http:
+        with pytest.raises(ApiError) as error:
+            await Client(http, ENV).deploy_worker({"scriptName": "test-worker", "script": "bad"})
+    assert error.value.status == status
+    assert len(calls) == 1