maleo-foundation 0.0.81__py3-none-any.whl → 0.0.83__py3-none-any.whl

maleo_foundation/clients/utils/logger.py

@@ -30,4 +30,25 @@ class ClientLoggerManager:
         """Return client logger (if exist) or raise Runtime Error"""
         if cls not in cls._loggers:
             raise RuntimeError("Logger has not been initialized. Call 'initialize' first.")
-        return cls._loggers[cls]
+        return cls._loggers[cls]
+
+class MaleoFoundationLoggerManager(ClientLoggerManager):
+    @classmethod
+    def initialize(
+        cls,
+        base_dir:str,
+        service_name:BaseTypes.OptionalString = None,
+        level:BaseEnums.LoggerLevel = BaseEnums.LoggerLevel.INFO
+    ) -> BaseLogger:
+        """Initialize MaleoFoundation's client logger if not already initialized."""
+        return super().initialize(
+            base_dir=base_dir,
+            client_name="MaleoFoundation",
+            service_name=service_name,
+            level=level
+        )
+
+    @classmethod
+    def get(cls) -> BaseLogger:
+        """Return client logger (if exist) or raise Runtime Error"""
+        return super().get()

maleo_foundation/expanded_types/token.py

@@ -0,0 +1,13 @@
+from typing import Union
+from maleo_foundation.models.transfers.results.token import BaseTokenResultsTransfers
+
+class BaseTokenResultsTypes:
+    Encode = Union[
+        BaseTokenResultsTransfers.Fail,
+        BaseTokenResultsTransfers.Encode
+    ]
+
+    Decode = Union[
+        BaseTokenResultsTransfers.Fail,
+        BaseTokenResultsTransfers.Decode
+    ]

maleo_foundation/models/schemas/token.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from pydantic import BaseModel, Field
+from maleo_foundation.types import BaseTypes
+
+class BaseTokenSchemas:
+    class Key(BaseModel):
+        key:str = Field(..., description="Key")
+
+    class Password(BaseModel):
+        password:BaseTypes.OptionalString = Field(None, min_length=32, max_length=1024, description="password")
+
+    class Token(BaseModel):
+        token:str = Field(..., description="Token")
+
+    class ExpIn(BaseModel):
+        exp_in:int = Field(5, ge=5, description="Expires in (integer, minutes)")

maleo_foundation/models/transfers/general/token.py

@@ -1,6 +1,8 @@
+from __future__ import annotations
 from pydantic import BaseModel, Field, model_validator
 from datetime import datetime, timedelta, timezone
 from maleo_foundation.types import BaseTypes
+from maleo_foundation.models.schemas.token import BaseTokenSchemas
 
 class BaseTokenGeneralTransfers:
     class BasePayload(BaseModel):
@@ -13,12 +15,15 @@ class BaseTokenGeneralTransfers:
         uor:BaseTypes.OptionalListOfStrings = Field(..., description="User Organization Role")
 
     class DecodePayload(BasePayload):
-        iat_dt:datetime = Field(datetime.now(timezone.utc), description="Issued at (datetime)")
+        iat_dt:datetime = Field(..., 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 BaseEncodePayload(BasePayload, BaseTokenSchemas.ExpIn): pass
+
     class EncodePayload(DecodePayload):
+        iat_dt:datetime = Field(datetime.now(timezone.utc), description="Issued at (datetime)")
         exp_in:int = Field(5, ge=5, description="Expires in (integer, minutes)", exclude=True)
 
         @model_validator(mode="before")

maleo_foundation/models/transfers/parameters/token.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+from pydantic import Field
+from maleo_foundation.models.schemas.token import BaseTokenSchemas
+from maleo_foundation.models.transfers.general.token import BaseTokenGeneralTransfers
+
+class BaseTokenParametersTransfers:
+    class Encode(
+        BaseTokenSchemas.Password,
+        BaseTokenSchemas.Key
+    ):
+        payload:BaseTokenGeneralTransfers.BaseEncodePayload = Field(..., description="Encode payload")
+
+    class Decode(
+        BaseTokenSchemas.Token,
+        BaseTokenSchemas.Key
+    ): pass

maleo_foundation/models/transfers/results/token.py

@@ -0,0 +1,12 @@
+from maleo_foundation.models.transfers.results.service.general import BaseServiceGeneralResultsTransfers
+from maleo_foundation.models.schemas.token import BaseTokenSchemas
+from maleo_foundation.models.transfers.general.token import BaseTokenGeneralTransfers
+
+class BaseTokenResultsTransfers:
+    class Fail(BaseServiceGeneralResultsTransfers.Fail): pass
+
+    class Encode(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseTokenSchemas.Token
+
+    class Decode(BaseServiceGeneralResultsTransfers.SingleData):
+        data:BaseTokenGeneralTransfers.DecodePayload

maleo_foundation/services/__init__.py

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

maleo_foundation/services/token.py

@@ -0,0 +1,43 @@
+import jwt
+from cryptography.hazmat.primitives import serialization
+from cryptography.hazmat.backends import default_backend
+from maleo_foundation.clients.utils.logger import MaleoFoundationLoggerManager
+from maleo_foundation.utils.exceptions import BaseExceptions
+from maleo_foundation.models.transfers.general.token import BaseTokenGeneralTransfers
+from maleo_foundation.models.schemas.token import BaseTokenSchemas
+from maleo_foundation.models.transfers.parameters.token import BaseTokenParametersTransfers
+from maleo_foundation.models.transfers.results.token import BaseTokenResultsTransfers
+from maleo_foundation.expanded_types.token import BaseTokenResultsTypes
+
+class BaseTokenService:
+    @staticmethod
+    @BaseExceptions.service_exception_handler(
+        operation="encoding a payload",
+        logger_factory=MaleoFoundationLoggerManager.get,
+        fail_result_class=BaseTokenResultsTransfers.Fail
+    )
+    def encode(parameters:BaseTokenParametersTransfers.Encode) -> BaseTokenResultsTypes.Encode:
+        #* Serialize private key
+        private_key_bytes = parameters.key.encode()
+        private_key = serialization.load_pem_private_key(
+            private_key_bytes,
+            password=parameters.password.encode() if parameters.password else None,
+            backend=default_backend()
+        )
+        payload = BaseTokenGeneralTransfers.EncodePayload.model_validate(parameters.payload.model_dump()).model_dump(mode="json")
+        token = jwt.encode(payload=payload, key=private_key, algorithm="RS256")
+        data = BaseTokenSchemas.Token(token=token)
+        MaleoFoundationLoggerManager.get().info("Payload successfully encoded")
+        return BaseTokenResultsTransfers.Encode(data=data)
+
+    @staticmethod
+    @BaseExceptions.service_exception_handler(
+        operation="decoding a token",
+        logger_factory=MaleoFoundationLoggerManager.get,
+        fail_result_class=BaseTokenResultsTransfers.Fail
+    )
+    def decode(parameters:BaseTokenParametersTransfers.Decode) -> BaseTokenResultsTypes.Decode:
+        payload = jwt.decode(jwt=parameters.token, key=parameters.key, algorithms=["RS256"])
+        data = BaseTokenGeneralTransfers.DecodePayload.model_validate(payload)
+        MaleoFoundationLoggerManager.get().info("Token successfully decoded")
+        return BaseTokenResultsTransfers.Decode(data=data)

{maleo_foundation-0.0.81.dist-info → maleo_foundation-0.0.83.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.0.81
+Version: 0.0.83
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT
@@ -57,6 +57,7 @@ Requires-Dist: pycparser>=2.22
 Requires-Dist: pydantic>=2.11.3
 Requires-Dist: pydantic_core>=2.33.1
 Requires-Dist: Pygments>=2.19.1
+Requires-Dist: PyJWT>=2.10.1
 Requires-Dist: pyproject_hooks>=1.2.0
 Requires-Dist: readme_renderer>=44.0
 Requires-Dist: requests>=2.32.3

{maleo_foundation-0.0.81.dist-info → maleo_foundation-0.0.83.dist-info}/RECORD

@@ -12,7 +12,7 @@ maleo_foundation/clients/google/cloud/logging.py,sha256=b-q6Mhlt2Vl5HBh-YXeEEfGu
 maleo_foundation/clients/google/cloud/secret.py,sha256=cFewA-EYsAaEfxc2G2XGzwHreW1FgyCK6MpwOARE24M,3452
 maleo_foundation/clients/google/cloud/storage.py,sha256=y_HAsbcGSnu5sxZPxaQWFWvOlF3vEcqkej2834OgAS0,2617
 maleo_foundation/clients/utils/__init__.py,sha256=hChEGABHH4tOFxPRcpxmlhkM9PgF18M7wXapH88hpu4,131
-maleo_foundation/clients/utils/logger.py,sha256=QhxljzrvNY_gXAHCqaOUJJAgwvvcE9v3IQK6AWYxzM4,1144
+maleo_foundation/clients/utils/logger.py,sha256=FMnHKV4i6xR6e8XN7kCNwTf1jhSLdJUIO7teSm5g0D4,1829
 maleo_foundation/db/__init__.py,sha256=fmvhCz4_siHfyKJujcUakKDKmuLxMhxn2w5tmfQwfcM,135
 maleo_foundation/db/engine.py,sha256=kw2SMMiWy5KARquh4TLk7v6HwlHW97lUIUvqdFbhNxk,1600
 maleo_foundation/db/manager.py,sha256=czs-6czNvKHZ7zWRX1nPpKJcdsadyX8R2DnZlA_6mlk,500
@@ -23,6 +23,7 @@ maleo_foundation/expanded_types/client.py,sha256=To0kRXp3QTmuSu5rWKaCiTsMK9qkYiy
 maleo_foundation/expanded_types/general.py,sha256=bjIBREYTS73tvS-Key7P7db82a2HHlSJ1XBAvKuYmT0,826
 maleo_foundation/expanded_types/query.py,sha256=0yUG-JIVsanzB7KAkrRz_OsrhP6J0bRqD9Q3l3atQnk,2384
 maleo_foundation/expanded_types/service.py,sha256=q8jpKdbCbLWwH1UPQavKpVE14rC5rveduk2cFWzuhGw,2416
+maleo_foundation/expanded_types/token.py,sha256=4fRTJw6W5MYq71NksNrWNi7qYHQ4_lQwfu9WxwrMipc,355
 maleo_foundation/middlewares/__init__.py,sha256=bqE2EIFC3rWcR2AwFPR0fk2kSFfeTRzgA24GbnuT5RA,3697
 maleo_foundation/middlewares/base.py,sha256=KcpODNs0DQXX8Cwc6T9dC6aiZIqxTLtuJjVAGWXPSKk,11633
 maleo_foundation/middlewares/cors.py,sha256=9uvBvY2N6Vxa9RP_YtESxcWo6Doi6uS0lzAG9iLY7Uc,2288
@@ -32,14 +33,17 @@ maleo_foundation/models/schemas/__init__.py,sha256=Xj8Ahsqyra-fmEaVcGPok5GOOsPQl
 maleo_foundation/models/schemas/general.py,sha256=hEQQPcddxMsJXMb36nqItIAfp3pqUyJOlaD7nXkNM2I,3609
 maleo_foundation/models/schemas/parameter.py,sha256=K47z2NzmTEhUiOfRiRLyRPXoQurbWsKBL7ObXAxIWRY,2100
 maleo_foundation/models/schemas/result.py,sha256=V3dljS2AdtWW4Pf8YsnQuiCylN1bZtEY1AtYC7okWuI,1747
+maleo_foundation/models/schemas/token.py,sha256=u71kPXJyCxqn_INK05MSNFhQr9MaLfQM-icYc536xik,551
 maleo_foundation/models/transfers/__init__.py,sha256=oJLJ3Geeme6vBw7R2Dhvdvg4ziVvzEYAGJaP-tm_90w,299
 maleo_foundation/models/transfers/general/__init__.py,sha256=0yW67vJvKgJmZ9htteOVatG7mb-YEpHF62dpwH2g_Bk,146
-maleo_foundation/models/transfers/general/token.py,sha256=BOb5rTn508ukYoqncZjpPV4QBr8L50iDV7nqTPzKr_c,2164
+maleo_foundation/models/transfers/general/token.py,sha256=FrXIVgVBwOPTsri271WAkq54Sqa8WSzY75BzsNq2P6k,2411
 maleo_foundation/models/transfers/parameters/__init__.py,sha256=oKW4RPIEISISRjsJzD8lsCGY1HhZRTzshPpWHcJu86k,353
 maleo_foundation/models/transfers/parameters/client.py,sha256=tn_Hwa-k-Utp5rODe7GylqZB8djIKKupgkUFscYCyLc,4059
 maleo_foundation/models/transfers/parameters/general.py,sha256=WoekZJCIoAllhXdRIJkNRdNq0QEIn0bteiHJLtzkCxU,579
 maleo_foundation/models/transfers/parameters/service.py,sha256=d7Xy_R-DtLBRozyD6r8YnTiuKlE3sb9HMDCCq9WmUbY,6757
+maleo_foundation/models/transfers/parameters/token.py,sha256=WTmCKoP-KJLqZjdwr__BeVnBrnRrsxzHSQ0IBaOKvqw,535
 maleo_foundation/models/transfers/results/__init__.py,sha256=0_8uJ1IQW87RZ4nIxzWkQVi3Fxb7B8myZTngXfoxgNc,241
+maleo_foundation/models/transfers/results/token.py,sha256=4zDgj8FWGK6Rcz_pprwnLcpRyyXKRBPbrCl3IOrRvVg,574
 maleo_foundation/models/transfers/results/client/__init__.py,sha256=xBRuY0NUIPpQEGQ2qoBnqLZGX4W1YSrQ0VnDf5OYJBo,290
 maleo_foundation/models/transfers/results/client/service.py,sha256=TO_U53vmUEnFWiiyuu33ao3BUidt6KFxvk3GC9uo8JE,1108
 maleo_foundation/models/transfers/results/client/controllers/__init__.py,sha256=x5pcJ33rsG8SqecwL1g762DFoySisTLbZqOqKqKoaKU,173
@@ -49,6 +53,8 @@ maleo_foundation/models/transfers/results/service/general.py,sha256=G4x-MhQI7Km9
 maleo_foundation/models/transfers/results/service/query.py,sha256=G5A4FRkHyRRlpuGWrPV5-vqgyyBjMqu8f-Ka9BjD0lA,1828
 maleo_foundation/models/transfers/results/service/controllers/__init__.py,sha256=HZJWMy2dskzOCzLmp_UaL9rjbQ-sDMI7sd2bXb-4QOU,175
 maleo_foundation/models/transfers/results/service/controllers/rest.py,sha256=wCuFyOTQkuBs2cqjPsWnPy0XIsCfMqGByhrSy57qp7Y,1107
+maleo_foundation/services/__init__.py,sha256=Ho5zJSA89xdGFKIwOdzjmd8sm23cIuwrqYAxCEBBTIU,120
+maleo_foundation/services/token.py,sha256=mULGv3wEeeFdNtk0k5pY3g7htFQM9EZBI1QIJdjfLy8,2348
 maleo_foundation/utils/__init__.py,sha256=FavmL5XYGCm955EAKiWWcXYeU15p5rSzfcglpV2yI6c,387
 maleo_foundation/utils/controller.py,sha256=ECzPzpw36zBAjKcWcDbUAhIJGbc6UpeypdUUX6ipXBg,6396
 maleo_foundation/utils/exceptions.py,sha256=nk3rD57fDR-D7BQkU1JEKV-Mu7FGMpLSEsqxdDZdKjU,4532
@@ -57,7 +63,7 @@ maleo_foundation/utils/logger.py,sha256=978P57JOhGR-WIu7xdPXBIwd3JrfLLA8WerVzxhE
 maleo_foundation/utils/query.py,sha256=ODQ3adOYQNj5E2cRW9ytbjBz56nEDcnfq8mQ6YZbCCM,4375
 maleo_foundation/utils/formatter/__init__.py,sha256=iKf5YCbEdg1qKnFHyKqqcQbqAqEeRUf8mhI3v3dQoj8,78
 maleo_foundation/utils/formatter/case.py,sha256=TmvvlfzGdC_omMTB5vAa40TZBxQ3hnr-SYeo0M52Rlg,1352
-maleo_foundation-0.0.81.dist-info/METADATA,sha256=T3tWP64f06-5rNYIYp--gew7qZ3RtT_E-H_R_L2tRqg,3161
-maleo_foundation-0.0.81.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
-maleo_foundation-0.0.81.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
-maleo_foundation-0.0.81.dist-info/RECORD,,
+maleo_foundation-0.0.83.dist-info/METADATA,sha256=hcQI1xP2pmn5LhuQN-C33rh4M8WbI6jWz1hf2pauIw8,3190
+maleo_foundation-0.0.83.dist-info/WHEEL,sha256=ck4Vq1_RXyvS4Jt6SI0Vz6fyVs4GWg7AINwpsaGEgPE,91
+maleo_foundation-0.0.83.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
+maleo_foundation-0.0.83.dist-info/RECORD,,