maleo-foundation 0.0.77__tar.gz → 0.0.79__tar.gz

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.0.77
+Version: 0.0.79
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/maleo_foundation/clients/general/http.py

@@ -4,6 +4,7 @@ from typing import AsyncGenerator, Optional
 
 class HTTPClientManager:
     client:Optional[httpx.AsyncClient] = None
+    base_url:Optional[str] = None
 
     @classmethod
     def initialize(cls) -> None:
@@ -20,12 +21,12 @@ class HTTPClientManager:
         yield cls.client
 
     @classmethod
-    async def inject(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
+    async def inject_client(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
         return cls._client_handler()
 
     @classmethod
     @asynccontextmanager
-    async def get(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
+    async def get_client(cls) -> AsyncGenerator[httpx.AsyncClient, None]:
         """
         Async context manager for manual HTTP client handling.
         Supports `async with HTTPClientManager.get() as client:`
@@ -33,9 +34,17 @@ class HTTPClientManager:
         async for client in cls._client_handler():
             yield client
 
+    @classmethod
+    def get_url(cls) -> str:
+        if cls.base_url is None:
+            raise RuntimeError("Base URL has not been initialized. Call initialize first.")
+        return cls.base_url
+
     @classmethod
     async def dispose(cls) -> None:
         """Dispose of the HTTP client and release any resources."""
         if cls.client is not None:
             await cls.client.aclose()
-            cls.client = None
+            cls.client = None
+        if cls.base_url is not None:
+            cls.base_url = None

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/maleo_foundation/enums.py

@@ -1,5 +1,5 @@
 import logging
-from enum import IntEnum, StrEnum
+from enum import IntEnum, StrEnum, Enum
 from fastapi import responses
 
 class BaseEnums:
@@ -40,6 +40,14 @@ class BaseEnums:
     class ClientControllerType(StrEnum):
         HTTP = "http"
 
+    class KeyType(StrEnum):
+        PRIVATE = "private"
+        PUBLIC = "public"
+
+    class KeyFormatType(Enum):
+        BYTES = bytes
+        STRING = str
+
     class RESTControllerResponseType(StrEnum):
         NONE = "none"
         HTML = "html"

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/maleo_foundation/models/schemas/general.py

@@ -1,8 +1,7 @@
 from __future__ import annotations
-from datetime import datetime, timedelta, timezone
-from pydantic import BaseModel, Field, model_validator
+from datetime import datetime
+from pydantic import BaseModel, Field
 from uuid import UUID
-from maleo_foundation.constants import REFRESH_TOKEN_DURATION_DAYS, ACCESS_TOKEN_DURATION_MINUTES
 from maleo_foundation.enums import BaseEnums
 from maleo_foundation.types import BaseTypes
 
@@ -81,42 +80,5 @@ class BaseGeneralSchemas:
     class Secret(BaseModel):
         secret:UUID = Field(..., description="Data's secret")
 
-    class TokenPayload(BaseModel):
-        t:BaseEnums.TokenType = Field(..., description="Token Type")
-        sr:UUID = Field(..., description="System role")
-        u:UUID = Field(..., description="user")
-        o:BaseTypes.OptionalUUID = Field(..., description="Organization")
-        uor:BaseTypes.OptionalListOfUUIDs = Field(..., description="User Organization Role")
-        iat_dt:datetime = Field(datetime.now(timezone.utc), description="Issued at (datetime)")
-        iat:int = Field(None, description="Issued at (integer)")
-        exp_dt:datetime = Field(None, description="Expired at (datetime)")
-        exp:int = Field(None, description="Expired at (integet)")
-
-        @model_validator(mode="before")
-        @classmethod
-        def set_iat_and_exp(cls, values:dict):
-            iat_dt = values.get("iat_dt", None)
-            if not iat_dt:
-                iat_dt = datetime.now(timezone.utc)
-            else:
-                if not isinstance(iat_dt, datetime):
-                    iat_dt = datetime.fromisoformat(iat_dt)
-            values["iat_dt"] = iat_dt
-            #* Convert `iat` to timestamp (int)
-            values["iat"] = int(iat_dt.timestamp())
-            exp_dt = values.get("exp_dt", None)
-            if not exp_dt:
-                if values["t"] == BaseEnums.TokenType.REFRESH:
-                    exp_dt = iat_dt + timedelta(days=REFRESH_TOKEN_DURATION_DAYS)
-                elif values["t"] == BaseEnums.TokenType.ACCESS:
-                    exp_dt = iat_dt + timedelta(minutes=ACCESS_TOKEN_DURATION_MINUTES)
-            else:
-                if not isinstance(exp_dt, datetime):
-                    exp_dt = datetime.fromisoformat(exp_dt)
-            values["exp_dt"] = exp_dt
-            #* Convert `exp_dt` to timestamp (int)
-            values["exp"] = int(exp_dt.timestamp())
-            return values
-
     class Data(BaseModel):
         data:BaseTypes.StringToAnyDict = Field(..., description="Data")

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/maleo_foundation/models/transfers/__init__.py

@@ -1,7 +1,9 @@
 from __future__ import annotations
+from .general import BaseGeneralTransfers
 from .parameters import BaseParametersTransfers
 from .results import BaseResultsTransfers
 
 class BaseTransfers:
+    General = BaseGeneralTransfers
     Parameters = BaseParametersTransfers
     Results = BaseResultsTransfers

maleo_foundation-0.0.79/maleo_foundation/models/transfers/general/__init__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+from .token import BaseTokenGeneralTransfers
+
+class BaseGeneralTransfers:
+    Token = BaseTokenGeneralTransfers

maleo_foundation-0.0.79/maleo_foundation/models/transfers/general/token.py

@@ -0,0 +1,44 @@
+from pydantic import BaseModel, Field, model_validator
+from datetime import datetime, timedelta, timezone
+from maleo_foundation.types import BaseTypes
+
+class BaseTokenGeneralTransfers:
+    class DecodePayload(BaseModel):
+        sr:str = Field(..., description="System role")
+        u_u:str = Field(..., description="user's username")
+        u_e:str = Field(..., description="user's email")
+        u_ut:str = Field(..., description="user's type")
+        o:BaseTypes.OptionalString = Field(..., description="Organization's key")
+        o_ot:BaseTypes.OptionalString = Field(..., description="Organization's type")
+        uor:BaseTypes.OptionalListOfStrings = Field(..., description="User Organization Role")
+        iat_dt:datetime = Field(datetime.now(timezone.utc), description="Issued at (datetime)")
+        iat:int = Field(..., description="Issued at (integer)")
+        exp_dt:datetime = Field(..., description="Expired at (datetime)")
+        exp:int = Field(..., description="Expired at (integet)")
+
+    class EncodePayload(DecodePayload):
+        exp_in:int = Field(5, ge=5, description="Expires in (integer, minutes)", exclude=True)
+
+        @model_validator(mode="before")
+        @classmethod
+        def set_iat_and_exp(cls, values:dict):
+            iat_dt = values.get("iat_dt", None)
+            if not iat_dt:
+                iat_dt = datetime.now(timezone.utc)
+            else:
+                if not isinstance(iat_dt, datetime):
+                    iat_dt = datetime.fromisoformat(iat_dt)
+            values["iat_dt"] = iat_dt
+            #* Convert `iat` to timestamp (int)
+            values["iat"] = int(iat_dt.timestamp())
+            exp_in = values.get("exp_in")
+            exp_dt = values.get("exp_dt", None)
+            if not exp_dt:
+                exp_dt = iat_dt + timedelta(minutes=exp_in)
+            else:
+                if not isinstance(exp_dt, datetime):
+                    exp_dt = datetime.fromisoformat(exp_dt)
+            values["exp_dt"] = exp_dt
+            #* Convert `exp_dt` to timestamp (int)
+            values["exp"] = int(exp_dt.timestamp())
+            return values

maleo_foundation-0.0.79/maleo_foundation/utils/keyloader.py

@@ -0,0 +1,65 @@
+import pathlib
+from cryptography.hazmat.primitives import serialization
+from typing import Union
+from maleo_foundation.enums import BaseEnums
+
+def load_key(
+    type:BaseEnums.KeyType,
+    path: Union[str, pathlib.Path],
+    password:Union[str, bytes, None] = None,
+    format:BaseEnums.KeyFormatType = BaseEnums.KeyFormatType.STRING,
+) -> Union[bytes, str]:
+    """
+    Load an RSA private or public key strictly from a file.
+
+    Args:
+        path (str | pathlib.Path): Path to the PEM file.
+        password (str | bytes | None): Password for encrypted private keys (optional).
+
+    Returns:
+        rsa.RSAPrivateKey | rsa.RSAPublicKey
+    """
+    if not isinstance(type, BaseEnums.KeyType):
+        raise TypeError("Invalid key type")
+
+    file_path = pathlib.Path(path)
+
+    if not file_path.is_file():
+        raise FileNotFoundError(f"Key file not found: {file_path}")
+
+    if not isinstance(password, (str, bytes, None)):
+        raise TypeError("Invalid passsword type")
+
+    if not isinstance(type, BaseEnums.KeyFormatType):
+        raise TypeError("Invalid key format type")
+
+    key_data = file_path.read_bytes()
+
+    if type == BaseEnums.KeyType.PRIVATE:
+        private_key = serialization.load_pem_private_key(
+            key_data,
+            password=password.encode() if isinstance(password, str) else password,
+        )
+        private_key_bytes = private_key.private_bytes(
+            encoding=serialization.Encoding.PEM,
+            format=serialization.PrivateFormat.PKCS8,
+            encryption_algorithm=serialization.NoEncryption()
+        )
+        if format == BaseEnums.KeyFormatType.BYTES:
+            return private_key_bytes
+        elif format == BaseEnums.KeyFormatType.STRING:
+            return private_key_bytes.decode()
+
+    elif type == BaseEnums.KeyType.PUBLIC:
+        public_key = serialization.load_pem_public_key(key_data)
+        public_key_bytes = public_key.public_bytes(
+            encoding=serialization.Encoding.PEM,
+            format=serialization.PublicFormat.SubjectPublicKeyInfo
+        )
+        if format == BaseEnums.KeyFormatType.BYTES:
+            return public_key_bytes
+        elif format == BaseEnums.KeyFormatType.STRING:
+            return public_key_bytes.decode()
+
+    else:
+        raise ValueError(f"Unsupported key type: {type}")

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/maleo_foundation.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.0.77
+Version: 0.0.79
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/maleo_foundation.egg-info/SOURCES.txt

@@ -40,6 +40,8 @@ maleo_foundation/models/schemas/general.py
 maleo_foundation/models/schemas/parameter.py
 maleo_foundation/models/schemas/result.py
 maleo_foundation/models/transfers/__init__.py
+maleo_foundation/models/transfers/general/__init__.py
+maleo_foundation/models/transfers/general/token.py
 maleo_foundation/models/transfers/parameters/__init__.py
 maleo_foundation/models/transfers/parameters/client.py
 maleo_foundation/models/transfers/parameters/general.py
@@ -57,6 +59,7 @@ maleo_foundation/models/transfers/results/service/controllers/rest.py
 maleo_foundation/utils/__init__.py
 maleo_foundation/utils/controller.py
 maleo_foundation/utils/exceptions.py
+maleo_foundation/utils/keyloader.py
 maleo_foundation/utils/logger.py
 maleo_foundation/utils/query.py
 maleo_foundation/utils/formatter/__init__.py

{maleo_foundation-0.0.77 → maleo_foundation-0.0.79}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "maleo_foundation"
-version = "0.0.77"
+version = "0.0.79"
 description = "Foundation package for Maleo"
 authors = [
     { name = "Agra Bima Yuda", email = "agra@nexmedis.com" }