fluidattacks_zoho_sdk 2.10.0__tar.gz

fluidattacks_zoho_sdk-2.10.0/.envrc

@@ -0,0 +1,3 @@
+# use https://github.com/nix-community/nix-direnv
+ln -f ../../common/mypy.ini ./mypy.ini
+use_flake ".#python311.devShell"

fluidattacks_zoho_sdk-2.10.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: fluidattacks_zoho_sdk
+Version: 2.10.0
+Summary: zoho SDK
+Author-email: Product Team <development@fluidattacks.com>
+Requires-Python: >=3.11
+Requires-Dist: fa-purity >=2.5.0, <3.0.0
+Requires-Dist: fluidattacks-etl-utils >=2.0.0, <3.0.0
+Requires-Dist: pure-requests >=3.0.0, <4.0.0

fluidattacks_zoho_sdk-2.10.0/build/default.nix

@@ -0,0 +1,13 @@
+{
+  nixpkgs,
+  builders,
+  scripts,
+  src,
+}:
+{
+  inherit src;
+  root_path = "observes/sdk/zoho";
+  module_name = "fluidattacks_zoho_sdk";
+  pypi_token_var = "ZOHO_SDK_TOKEN";
+  override = b: b;
+}

fluidattacks_zoho_sdk-2.10.0/build/filter.nix

@@ -0,0 +1,12 @@
+path_filter: src:
+path_filter {
+  root = src;
+  include = [
+    "fluidattacks_zoho_sdk"
+    "tests"
+    "pyproject.toml"
+    "mypy.ini"
+    "ruff.toml"
+    "uv.lock"
+  ];
+}

fluidattacks_zoho_sdk-2.10.0/flake.lock

@@ -0,0 +1,353 @@
+{
+  "nodes": {
+    "flake-parts": {
+      "inputs": {
+        "nixpkgs-lib": "nixpkgs-lib"
+      },
+      "locked": {
+        "lastModified": 1762810396,
+        "narHash": "sha256-dxFVgQPG+R72dkhXTtqUm7KpxElw3u6E+YlQ2WaDgt8=",
+        "owner": "hercules-ci",
+        "repo": "flake-parts",
+        "rev": "0bdadb1b265fb4143a75bd1ec7d8c915898a9923",
+        "type": "github"
+      },
+      "original": {
+        "owner": "hercules-ci",
+        "repo": "flake-parts",
+        "type": "github"
+      }
+    },
+    "nix_filter": {
+      "locked": {
+        "lastModified": 1757882181,
+        "narHash": "sha256-+cCxYIh2UNalTz364p+QYmWHs0P+6wDhiWR4jDIKQIU=",
+        "owner": "numtide",
+        "repo": "nix-filter",
+        "rev": "59c44d1909c72441144b93cf0f054be7fe764de5",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "nix-filter",
+        "type": "github"
+      }
+    },
+    "nix_filter_2": {
+      "locked": {
+        "lastModified": 1731533336,
+        "narHash": "sha256-oRam5PS1vcrr5UPgALW0eo1m/5/pls27Z/pabHNy2Ms=",
+        "owner": "numtide",
+        "repo": "nix-filter",
+        "rev": "f7653272fd234696ae94229839a99b73c9ab7de0",
+        "type": "github"
+      },
+      "original": {
+        "owner": "numtide",
+        "repo": "nix-filter",
+        "type": "github"
+      }
+    },
+    "nixpkgs": {
+      "locked": {
+        "lastModified": 1736441877,
+        "narHash": "sha256-m3+PhBFkDwqo9lBplG4AyMW8P4/KcioJRS1UG8N7okM=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "ce3899414dab3297cf025bfa356dc2da426feefd",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs-lib": {
+      "locked": {
+        "lastModified": 1761765539,
+        "narHash": "sha256-b0yj6kfvO8ApcSE+QmA6mUfu8IYG6/uU28OFn4PaC8M=",
+        "owner": "nix-community",
+        "repo": "nixpkgs.lib",
+        "rev": "719359f4562934ae99f5443f20aa06c2ffff91fc",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-community",
+        "repo": "nixpkgs.lib",
+        "type": "github"
+      }
+    },
+    "nixpkgs_2": {
+      "locked": {
+        "lastModified": 1758690382,
+        "narHash": "sha256-NY3kSorgqE5LMm1LqNwGne3ZLMF2/ILgLpFr1fS4X3o=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "e643668fd71b949c53f8626614b21ff71a07379d",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs_3": {
+      "locked": {
+        "lastModified": 1758690382,
+        "narHash": "sha256-NY3kSorgqE5LMm1LqNwGne3ZLMF2/ILgLpFr1fS4X3o=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "e643668fd71b949c53f8626614b21ff71a07379d",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs_4": {
+      "locked": {
+        "lastModified": 1761373498,
+        "narHash": "sha256-Q/uhWNvd7V7k1H1ZPMy/vkx3F8C13ZcdrKjO7Jv7v0c=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "6a08e6bb4e46ff7fcbb53d409b253f6bad8a28ce",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "ref": "nixos-unstable",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "nixpkgs_flake": {
+      "locked": {
+        "lastModified": 1762812764,
+        "narHash": "sha256-MNqrovkO8AEQeYQK7e3X2GDx2H8vfDIxV4K/VEaIjjo=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "400156fe527ab6b54cf6f70cca2c8385548a29c4",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "type": "github"
+      }
+    },
+    "observes_flake_builder": {
+      "inputs": {
+        "nix_filter": "nix_filter",
+        "nixpkgs_flake": "nixpkgs_flake",
+        "pynix_flake": "pynix_flake",
+        "pyproject-build-systems": "pyproject-build-systems",
+        "pyproject-nix": "pyproject-nix_2",
+        "shell-helpers": "shell-helpers",
+        "uv2nix": "uv2nix_2"
+      },
+      "locked": {
+        "dir": "observes/common/std_flake_2",
+        "lastModified": 1764767408,
+        "narHash": "sha256-CYGyCtQuboXbHQ0OUXNNdXXIcPOM1ZhOM94LUNjEQig=",
+        "ref": "refs/heads/trunk",
+        "rev": "28bda83eeda56c9c4016f43c86aaf93a366446c3",
+        "shallow": true,
+        "type": "git",
+        "url": "ssh://git@gitlab.com/fluidattacks/universe"
+      },
+      "original": {
+        "dir": "observes/common/std_flake_2",
+        "rev": "28bda83eeda56c9c4016f43c86aaf93a366446c3",
+        "shallow": true,
+        "type": "git",
+        "url": "ssh://git@gitlab.com/fluidattacks/universe"
+      }
+    },
+    "pynix_flake": {
+      "inputs": {
+        "nix_filter": "nix_filter_2",
+        "nixpkgs": "nixpkgs"
+      },
+      "locked": {
+        "lastModified": 1758642502,
+        "narHash": "sha256-PD/bQMz2dqZSkydHyvRh+jS/0qoV8SdcIVs6sassteQ=",
+        "owner": "dmurciaatfluid",
+        "repo": "python_nix_builder",
+        "rev": "809aafe2e1995e72c15378d099bf251b78f04a20",
+        "type": "gitlab"
+      },
+      "original": {
+        "owner": "dmurciaatfluid",
+        "repo": "python_nix_builder",
+        "type": "gitlab"
+      }
+    },
+    "pyproject-build-systems": {
+      "inputs": {
+        "nixpkgs": "nixpkgs_2",
+        "pyproject-nix": "pyproject-nix",
+        "uv2nix": "uv2nix"
+      },
+      "locked": {
+        "lastModified": 1761781027,
+        "narHash": "sha256-YDvxPAm2WnxrznRqWwHLjryBGG5Ey1ATEJXrON+TWt8=",
+        "owner": "pyproject-nix",
+        "repo": "build-system-pkgs",
+        "rev": "795a980d25301e5133eca37adae37283ec3c8e66",
+        "type": "github"
+      },
+      "original": {
+        "owner": "pyproject-nix",
+        "repo": "build-system-pkgs",
+        "type": "github"
+      }
+    },
+    "pyproject-nix": {
+      "inputs": {
+        "nixpkgs": [
+          "observes_flake_builder",
+          "pyproject-build-systems",
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1758265079,
+        "narHash": "sha256-amLaLNwKSZPShQHzfgmc/9o76dU8xzN0743dWgvYlr8=",
+        "owner": "nix-community",
+        "repo": "pyproject.nix",
+        "rev": "02e9418fd4af638447dca4b17b1280da95527fc9",
+        "type": "github"
+      },
+      "original": {
+        "owner": "nix-community",
+        "repo": "pyproject.nix",
+        "type": "github"
+      }
+    },
+    "pyproject-nix_2": {
+      "inputs": {
+        "nixpkgs": "nixpkgs_3"
+      },
+      "locked": {
+        "lastModified": 1762427963,
+        "narHash": "sha256-CkPlAbIQ87wmjy5qHibfzk4DmMGBNqFer+lLfXjpP5M=",
+        "owner": "pyproject-nix",
+        "repo": "pyproject.nix",
+        "rev": "4540ea004e04fcd12dd2738d51383d10f956f7b9",
+        "type": "github"
+      },
+      "original": {
+        "owner": "pyproject-nix",
+        "repo": "pyproject.nix",
+        "type": "github"
+      }
+    },
+    "pyproject-nix_3": {
+      "inputs": {
+        "nixpkgs": [
+          "observes_flake_builder",
+          "uv2nix",
+          "nixpkgs"
+        ]
+      },
+      "locked": {
+        "lastModified": 1760402624,
+        "narHash": "sha256-jF6UKLs2uGc2rtved8Vrt58oTWjTQoAssuYs/0578Z4=",
+        "owner": "pyproject-nix",
+        "repo": "pyproject.nix",
+        "rev": "84c4ea102127c77058ea1ed7be7300261fafc7d2",
+        "type": "github"
+      },
+      "original": {
+        "owner": "pyproject-nix",
+        "repo": "pyproject.nix",
+        "type": "github"
+      }
+    },
+    "root": {
+      "inputs": {
+        "observes_flake_builder": "observes_flake_builder"
+      }
+    },
+    "shell-helpers": {
+      "inputs": {
+        "flake-parts": "flake-parts",
+        "nixpkgs": [
+          "observes_flake_builder",
+          "nixpkgs_flake"
+        ]
+      },
+      "locked": {
+        "dir": "common/utils/shell-helpers",
+        "lastModified": 1762806066,
+        "narHash": "sha256-Wz99Fl7SpPU1NkTHJ36XOo6DjOEAMXCw3ThRABOS2Hs=",
+        "ref": "refs/heads/trunk",
+        "rev": "d73cfdc7ae9e7f547e22a4481d4c2ccce38b26a8",
+        "shallow": true,
+        "type": "git",
+        "url": "ssh://git@gitlab.com/fluidattacks/universe"
+      },
+      "original": {
+        "dir": "common/utils/shell-helpers",
+        "rev": "d73cfdc7ae9e7f547e22a4481d4c2ccce38b26a8",
+        "shallow": true,
+        "type": "git",
+        "url": "ssh://git@gitlab.com/fluidattacks/universe"
+      }
+    },
+    "uv2nix": {
+      "inputs": {
+        "nixpkgs": [
+          "observes_flake_builder",
+          "pyproject-build-systems",
+          "nixpkgs"
+        ],
+        "pyproject-nix": [
+          "observes_flake_builder",
+          "pyproject-build-systems",
+          "pyproject-nix"
+        ]
+      },
+      "locked": {
+        "lastModified": 1758933732,
+        "narHash": "sha256-HAmm1GBS1myZCFuog0DC2ZLaynvZtiUI2Crmo+cdQI0=",
+        "owner": "pyproject-nix",
+        "repo": "uv2nix",
+        "rev": "273ce18f913d8559e0d04f820d724308966d7c4d",
+        "type": "github"
+      },
+      "original": {
+        "owner": "pyproject-nix",
+        "repo": "uv2nix",
+        "type": "github"
+      }
+    },
+    "uv2nix_2": {
+      "inputs": {
+        "nixpkgs": "nixpkgs_4",
+        "pyproject-nix": "pyproject-nix_3"
+      },
+      "locked": {
+        "lastModified": 1761872265,
+        "narHash": "sha256-i25GRgp2vUOebY70L3NTAgkd+Pr1hnn5xM3qHxH0ONU=",
+        "owner": "pyproject-nix",
+        "repo": "uv2nix",
+        "rev": "74dfb62871be152ad3673b143b0cc56105a4f3c5",
+        "type": "github"
+      },
+      "original": {
+        "owner": "pyproject-nix",
+        "repo": "uv2nix",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

fluidattacks_zoho_sdk-2.10.0/flake.nix

@@ -0,0 +1,29 @@
+{
+  description = "Zoho API auth SDK";
+
+  inputs = {
+    observes_flake_builder = {
+      url = "git+ssh://git@gitlab.com/fluidattacks/universe?shallow=1&rev=28bda83eeda56c9c4016f43c86aaf93a366446c3&dir=observes/common/std_flake_2";
+    };
+  };
+
+  outputs =
+    { self, ... }@inputs:
+    let
+      build_args =
+        {
+          system,
+          python_version,
+          nixpkgs,
+          builders,
+          scripts,
+        }:
+        import ./build {
+          inherit nixpkgs builders scripts;
+          src = import ./build/filter.nix nixpkgs.nix-filter self;
+        };
+    in
+    {
+      packages = inputs.observes_flake_builder.outputs.build build_args;
+    };
+}

fluidattacks_zoho_sdk-2.10.0/fluidattacks_zoho_sdk/__init__.py

@@ -0,0 +1,6 @@
+from fluidattacks_zoho_sdk._http_client import TokenManager
+from fluidattacks_zoho_sdk.auth import AuthApiFactory, Credentials
+
+__version__ = "2.10.0"
+
+__all__ = ["AuthApiFactory", "Credentials", "TokenManager"]

fluidattacks_zoho_sdk-2.10.0/fluidattacks_zoho_sdk/_decoders.py

@@ -0,0 +1,268 @@
+from collections.abc import Callable
+from datetime import UTC, datetime
+from typing import (
+    IO,
+    TypeVar,
+)
+
+from fa_purity import (
+    Coproduct,
+    FrozenList,
+    Maybe,
+    PureIterFactory,
+    Result,
+    ResultE,
+    ResultTransform,
+    Unsafe,
+)
+from fa_purity.date_time import DatetimeUTC
+from fa_purity.json import (
+    JsonObj,
+    JsonPrimitiveUnfolder,
+    JsonUnfolder,
+    JsonValueFactory,
+    UnfoldedFactory,
+    Unfolder,
+)
+from fluidattacks_etl_utils.decode import DecodeUtils
+from fluidattacks_etl_utils.natural import Natural
+
+from fluidattacks_zoho_sdk.auth import Credentials
+from fluidattacks_zoho_sdk.ids import (
+    AccountId,
+    ContactId,
+    CrmId,
+    DeparmentId,
+    NumberId,
+    ProductId,
+    ProfileId,
+    RoleId,
+    TeamId,
+    TicketId,
+    UserId,
+)
+from fluidattacks_zoho_sdk.zoho_desk.core import OptionalId
+
+_T = TypeVar("_T")
+
+
+def decode_list_objs(
+    items: FrozenList[JsonObj],
+    transaform: Callable[[JsonObj], ResultE[_T]],
+) -> ResultE[FrozenList[_T]]:
+    if not items:
+        return Result.failure(ValueError("Expected a list"))
+
+    return ResultTransform.all_ok(
+        PureIterFactory.from_list(items).map(lambda v: transaform(v)).to_list(),
+    )
+
+
+def _decode_zoho_creds(raw: JsonObj) -> ResultE[Credentials]:
+    client_id = JsonUnfolder.require(raw, "client_id", Unfolder.to_primitive).bind(
+        JsonPrimitiveUnfolder.to_str,
+    )
+    client_secret = JsonUnfolder.require(raw, "client_secret", Unfolder.to_primitive).bind(
+        JsonPrimitiveUnfolder.to_str,
+    )
+    refresh_token = JsonUnfolder.require(raw, "refresh_token", Unfolder.to_primitive).bind(
+        JsonPrimitiveUnfolder.to_str,
+    )
+    scopes_result = JsonUnfolder.require(
+        raw,
+        "scopes",
+        lambda i: Unfolder.to_list_of(
+            i,
+            lambda x: Unfolder.to_primitive(x).bind(JsonPrimitiveUnfolder.to_str),
+        ),
+    )
+    return client_id.bind(
+        lambda cid: client_secret.bind(
+            lambda secret: refresh_token.bind(
+                lambda token: scopes_result.map(
+                    lambda scopes: Credentials(cid, secret, token, frozenset(scopes)),
+                ),
+            ),
+        ),
+    )
+
+
+def get_sub_json(raw: JsonObj, key: str) -> JsonObj:
+    return (
+        JsonUnfolder.require(raw, key, lambda v: Unfolder.to_json(v))
+        .alt(Unsafe.raise_exception)
+        .to_union()
+    )
+
+
+def decode_optional_date(raw: JsonObj, key: str) -> ResultE[Maybe[DatetimeUTC]]:
+    return JsonUnfolder.optional(raw, key, DecodeUtils.to_opt_date_time).map(
+        lambda v: v.bind(lambda j: j),
+    )
+
+
+def decode_datetime_assume_utc(s: str) -> ResultE[Maybe[DatetimeUTC]]:
+    try:
+        if not s or not s.strip():
+            return Result.success(Maybe.empty())
+
+        dt = datetime.strptime(s, "%Y-%m-%d %H:%M:%S").replace(tzinfo=UTC)
+        return DecodeUtils.to_opt_date_time(JsonValueFactory.from_unfolded(str(dt)))
+
+    except ValueError as e:
+        return Result.failure(e)
+
+
+def flatten_decoder_date(
+    y: Result[Maybe[ResultE[Maybe[DatetimeUTC]]], Exception],
+) -> ResultE[Maybe[DatetimeUTC]]:
+    return y.bind(lambda maybe_inner: maybe_inner.value_or(Result.success(Maybe.empty())))
+
+
+def decode_opt_date_to_utc(raw: JsonObj, key: str) -> ResultE[Maybe[DatetimeUTC]]:
+    date = JsonUnfolder.optional(raw, key, DecodeUtils.to_opt_str).map(
+        lambda maybe_str: maybe_str.bind(lambda j: j).map(lambda v: decode_datetime_assume_utc(v)),
+    )
+    return flatten_decoder_date(date)
+
+
+def decode_require_date(raw: JsonObj, key: str) -> ResultE[DatetimeUTC]:
+    return JsonUnfolder.require(raw, key, DecodeUtils.to_date_time)
+
+
+def decode_maybe_str(raw: JsonObj, key: str) -> ResultE[Maybe[str]]:
+    return JsonUnfolder.optional(raw, key, DecodeUtils.to_opt_str).map(
+        lambda v: v.bind(lambda j: j),
+    )
+
+
+def decode_zoho_creds(auth_file: IO[str]) -> ResultE[Credentials]:
+    return UnfoldedFactory.load(auth_file).bind(_decode_zoho_creds)
+
+
+def decode_user_id(raw: JsonObj) -> ResultE[UserId]:
+    return (
+        JsonUnfolder.require(raw, "id", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(UserId)
+    )
+
+
+def decode_rol_id(raw: JsonObj) -> ResultE[RoleId]:
+    return (
+        JsonUnfolder.require(raw, "roleId", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(RoleId)
+    )
+
+
+def decode_profile_id(raw: JsonObj) -> ResultE[ProfileId]:
+    return (
+        JsonUnfolder.require(raw, "profileId", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(ProfileId)
+    )
+
+
+def decode_account_id_bulk(raw: JsonObj) -> ResultE[AccountId]:
+    return JsonUnfolder.require(raw, "Account ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(AccountId),
+    )
+
+
+def decode_account_id(raw: JsonObj) -> ResultE[AccountId]:
+    return (
+        JsonUnfolder.require(raw, "Account ID", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(AccountId)
+    )
+
+
+def decode_crm_id(raw: JsonObj) -> ResultE[CrmId]:
+    return JsonUnfolder.require(raw, "CRM ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(CrmId),
+    )
+
+
+def decode_department_id(raw: JsonObj) -> ResultE[DeparmentId]:
+    return (
+        JsonUnfolder.require(raw, "Department", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(DeparmentId)
+    )
+
+
+def decode_department_id_team(raw: JsonObj) -> ResultE[DeparmentId]:
+    return (
+        JsonUnfolder.require(raw, "departmentId", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(DeparmentId)
+    )
+
+
+def decode_require_product_id(raw: JsonObj) -> ResultE[ProductId]:
+    return JsonUnfolder.require(raw, "Product ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: ProductId(obj)),
+    )
+
+
+def decode_team_id(raw: JsonObj) -> ResultE[TeamId]:
+    return JsonUnfolder.require(raw, "Team Id", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: TeamId(obj)),
+    )
+
+
+def decode_ticket_id(raw: JsonObj) -> ResultE[TicketId]:
+    return JsonUnfolder.require(raw, "ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: TicketId(obj)),
+    )
+
+
+def decode_contact_id(raw: JsonObj) -> ResultE[ContactId]:
+    return JsonUnfolder.require(raw, "Contact ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: ContactId(obj)),
+    )
+
+
+def decode_contact_id_bulk(raw: JsonObj) -> ResultE[ContactId]:
+    return JsonUnfolder.require(raw, "ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: ContactId(obj)),
+    )
+
+
+def decode_id_team(raw: JsonObj) -> ResultE[TeamId]:
+    return JsonUnfolder.require(raw, "id", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: TeamId(obj)),
+    )
+
+
+def decode_user_id_bulk(raw: JsonObj) -> ResultE[UserId]:
+    return JsonUnfolder.require(raw, "ID", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(UserId),
+    )
+
+
+def decode_number_id(raw: JsonObj) -> ResultE[NumberId]:
+    return JsonUnfolder.require(raw, "Request Id", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(NumberId),
+    )
+
+
+def decode_optional_id(raw: JsonObj, key: str) -> ResultE[Maybe[OptionalId]]:
+    return JsonUnfolder.optional(raw, key, DecodeUtils.to_opt_str).map(
+        lambda v: v.bind(lambda x: x).map(lambda j: OptionalId(j)),
+    )
+
+
+def assert_single(item: Coproduct[JsonObj, FrozenList[JsonObj]]) -> ResultE[JsonObj]:
+    return item.map(
+        Result.success,
+        lambda _: Result.failure(ValueError("Expected a json not a list")),
+    )
+
+
+def assert_multiple(item: Coproduct[JsonObj, FrozenList[JsonObj]]) -> ResultE[FrozenList[JsonObj]]:
+    return item.map(
+        lambda _: Result.failure(ValueError("Expected a json list not a single json")),
+        Result.success,
+    )