fluidattacks_zoho_sdk 1.0.0__tar.gz

fluidattacks_zoho_sdk-1.0.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-1.0.0/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: fluidattacks_zoho_sdk
+Version: 1.0.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 >=1.0.0, <2.0.0
+Requires-Dist: pure-requests >=3.0.0, <4.0.0

fluidattacks_zoho_sdk-1.0.0/build/default.nix

@@ -0,0 +1,7 @@
+{ 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-1.0.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-1.0.0/flake.lock

@@ -0,0 +1,351 @@
+{
+  "nodes": {
+    "flake-parts": {
+      "inputs": {
+        "nixpkgs-lib": "nixpkgs-lib"
+      },
+      "locked": {
+        "lastModified": 1754487366,
+        "narHash": "sha256-pHYj8gUBapuUzKV/kN/tR3Zvqc7o6gdFB9XKXIp1SQ8=",
+        "owner": "hercules-ci",
+        "repo": "flake-parts",
+        "rev": "af66ad14b28a127c5c0f3bbb298218fc63528a18",
+        "type": "github"
+      },
+      "original": {
+        "owner": "hercules-ci",
+        "repo": "flake-parts",
+        "type": "github"
+      }
+    },
+    "nix_filter": {
+      "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"
+      }
+    },
+    "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": 1753579242,
+        "narHash": "sha256-zvaMGVn14/Zz8hnp4VWT9xVnhc8vuL3TStRqwk22biA=",
+        "owner": "nix-community",
+        "repo": "nixpkgs.lib",
+        "rev": "0f36c44e01a6129be94e3ade315a5883f0228a6e",
+        "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": 1756313514,
+        "narHash": "sha256-3Xbak0pXR8ziNv1ghHyJ5a5Ti2kt/LWq6hKZVJTvjBs=",
+        "owner": "nixos",
+        "repo": "nixpkgs",
+        "rev": "181464235b2daff8725773fef43ffc9d6b02e1c2",
+        "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": 1761684858,
+        "narHash": "sha256-gybMRO/MSOPXQjI//u2UKfvs8pD0sACqL2Kjp+xR4rI=",
+        "owner": "fluidattacks",
+        "repo": "universe",
+        "rev": "c5053864bb838edbe226d74a650d901c0270843b",
+        "type": "github"
+      },
+      "original": {
+        "dir": "observes/common/std_flake_2",
+        "owner": "fluidattacks",
+        "repo": "universe",
+        "rev": "c5053864bb838edbe226d74a650d901c0270843b",
+        "type": "github"
+      }
+    },
+    "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": 1759113590,
+        "narHash": "sha256-fgxP2RCN4cg0jYiMYoETYc7TZ2JjgyvJa2y9l8oSUFE=",
+        "owner": "pyproject-nix",
+        "repo": "build-system-pkgs",
+        "rev": "dbfc0483b5952c6b86e36f8b3afeb9dde30ea4b5",
+        "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": 1760402624,
+        "narHash": "sha256-jF6UKLs2uGc2rtved8Vrt58oTWjTQoAssuYs/0578Z4=",
+        "owner": "pyproject-nix",
+        "repo": "pyproject.nix",
+        "rev": "84c4ea102127c77058ea1ed7be7300261fafc7d2",
+        "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": 1752896460,
+        "narHash": "sha256-AsyTatXMx839cGsF6knwTrDZHk3Eue2QD3eSP7bkmpg=",
+        "owner": "fluidattacks",
+        "repo": "universe",
+        "rev": "27749d2c3a2b018eb010a322e5e1352f993c9e86",
+        "type": "github"
+      },
+      "original": {
+        "dir": "common/utils/shell-helpers",
+        "owner": "fluidattacks",
+        "repo": "universe",
+        "rev": "27749d2c3a2b018eb010a322e5e1352f993c9e86",
+        "type": "github"
+      }
+    },
+    "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": 1761527626,
+        "narHash": "sha256-neDfvbpFlzUQfH9C+hVRUX0/RXUbJBidw4pFcdMYhZA=",
+        "owner": "pyproject-nix",
+        "repo": "uv2nix",
+        "rev": "46a8e8bbb2d9e34b686329ac16e4a8861394f03a",
+        "type": "github"
+      },
+      "original": {
+        "owner": "pyproject-nix",
+        "repo": "uv2nix",
+        "type": "github"
+      }
+    }
+  },
+  "root": "root",
+  "version": 7
+}

fluidattacks_zoho_sdk-1.0.0/flake.nix

@@ -0,0 +1,19 @@
+{
+  description = "Zoho API auth SDK";
+
+  inputs = {
+    observes_flake_builder = {
+      url =
+        "github:fluidattacks/universe/c5053864bb838edbe226d74a650d901c0270843b?shallow=1&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-1.0.0/fluidattacks_zoho_sdk/__init__.py

@@ -0,0 +1,8 @@
+from fluidattacks_zoho_sdk.auth import AuthApiFactory, Credentials
+
+__version__ = "1.0.0"
+
+__all__ = [
+    "AuthApiFactory",
+    "Credentials",
+]

fluidattacks_zoho_sdk-1.0.0/fluidattacks_zoho_sdk/_decoders.py

@@ -0,0 +1,177 @@
+from typing import (
+    IO,
+)
+
+from fa_purity import Maybe, ResultE, Unsafe
+from fa_purity.date_time import DatetimeUTC
+from fa_purity.json import (
+    JsonObj,
+    JsonPrimitiveUnfolder,
+    JsonUnfolder,
+    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,
+    ProductId,
+    ProfileId,
+    RoleId,
+    TeamId,
+    TicketId,
+    UserId,
+)
+
+
+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_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(raw: JsonObj) -> ResultE[AccountId]:
+    return (
+        JsonUnfolder.require(raw, "accountId", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(AccountId)
+    )
+
+
+def decode_crm_id(raw: JsonObj) -> ResultE[CrmId]:
+    return (
+        JsonUnfolder.require(get_sub_json(raw, "zohoCRMContact"), "id", DecodeUtils.to_str)
+        .bind(lambda v: Natural.from_int(int(v)))
+        .map(lambda obj: CrmId(obj))
+    )
+
+
+def decode_deparment_id(raw: JsonObj) -> ResultE[DeparmentId]:
+    return (
+        JsonUnfolder.optional(raw, "departmentId", DecodeUtils.to_opt_str)
+        .map(
+            lambda v: v.bind(lambda x: x).map(
+                lambda j: Natural.from_int(int(j)).alt(Unsafe.raise_exception).to_union(),
+            ),
+        )
+        .map(lambda obj: DeparmentId(obj))
+    )
+
+
+def decode_product_id(raw: JsonObj) -> ResultE[ProductId]:
+    return (
+        JsonUnfolder.optional(raw, "productId", DecodeUtils.to_opt_str)
+        .map(
+            lambda v: v.bind(lambda x: x).map(
+                lambda j: Natural.from_int(int(j)).alt(Unsafe.raise_exception).to_union(),
+            ),
+        )
+        .map(lambda obj: ProductId(obj))
+    )
+
+
+def decode_team_id(raw: JsonObj) -> ResultE[TeamId]:
+    return JsonUnfolder.require(raw, "teamId", 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(get_sub_json(raw, "contact"), "id", DecodeUtils.to_str).bind(
+        lambda v: Natural.from_int(int(v)).map(lambda obj: ContactId(obj)),
+    )
+
+
+def decode_account_id_ticket(raw: JsonObj) -> ResultE[AccountId]:
+    account_obj = get_sub_json(raw, "contact")
+    return JsonUnfolder.require(
+        get_sub_json(account_obj, "account"),
+        "id",
+        DecodeUtils.to_str,
+    ).bind(lambda v: Natural.from_int(int(v)).map(lambda obj: AccountId(obj)))

fluidattacks_zoho_sdk-1.0.0/fluidattacks_zoho_sdk/auth/__init__.py

@@ -0,0 +1,51 @@
+import logging
+from dataclasses import (
+    dataclass,
+)
+
+from fa_purity import (
+    Cmd,
+)
+from fa_purity.json import (
+    JsonObj,
+)
+
+from . import (
+    _access,
+    _refresh,
+    _revoke,
+)
+from ._core import (
+    Credentials,
+    RefreshToken,
+    Token,
+)
+
+ACCOUNTS_URL = "https://accounts.zoho.com"  # for US region
+LOG = logging.getLogger(__name__)
+
+
+@dataclass(frozen=True)
+class AuthApi:
+    new_access_token: Cmd[Token]
+    manual_new_refresh_token: Cmd[RefreshToken]
+    manual_revoke_token: Cmd[JsonObj]
+
+
+@dataclass(frozen=True)
+class AuthApiFactory:
+    @staticmethod
+    def auth_api(creds: Credentials) -> AuthApi:
+        return AuthApi(
+            _access.new_access_token(creds),
+            _refresh.generate_refresh_token(creds),
+            _revoke.revoke_refresh_token(),
+        )
+
+
+__version__ = "1.0.0"
+__all__ = [
+    "Credentials",
+    "RefreshToken",
+    "Token",
+]