biatoolkit 1.2.1__py3-none-any.whl → 1.2.3__py3-none-any.whl

biatoolkit/sankhya_call.py

@@ -268,14 +268,17 @@ class Sankhya:
         Returns:
             dict: Resposta JSON (ou {"raw_text": "..."} se não for JSON)
         """
+
         # Resolve o token de sessão (JSESSIONID)
         sid = self._resolve_jsessionid(jsessionid)
+        # Para mgeSession na query, usar só a primeira parte antes do ponto
+        sid_query = sid.split(".", 1)[0] if "." in sid else sid
 
         # Monta a querystring, sempre incluindo o mgeSession
         query_parts = []
         if query:
             query_parts.append(query.lstrip("?"))
-        query_parts.append(f"mgeSession={sid}")
+        query_parts.append(f"mgeSession={sid_query}")
         final_query = "&".join(query_parts)
 
         # Monta a URL final da requisição
@@ -290,6 +293,9 @@ class Sankhya:
         if extra_headers:
             headers.update(extra_headers)
 
+        # Adiciona o JSESSIONID no header Cookie
+        headers["Cookie"] = f"JSESSIONID={sid}"
+
         # Define o timeout da requisição
         t = timeout or (self.sankhya_settings.timeout_connect, self.sankhya_settings.timeout_read)
 
@@ -364,13 +370,19 @@ class Sankhya:
             },
         }
         
+        # Se base_url não foi fornecido, tenta obter do MCP (se existir)
+        if not base_url:
+            if self.mcp is not None:
+                util = BiaUtil(self.mcp)
+                header = util.get_header()
+                base_url = getattr(header, "current_host", None)
 
-        util = BiaUtil(self.mcp)
-        # Se base_url não foi fornecido, tenta obter do util.get_header().current_host
+        # Se ainda não tem base_url, erro
         if not base_url:
-            base_url = util.get_header().current_host
-            if not base_url:
-                raise ValueError("base_url não definida e não foi possível obter current_host do header.")
+            raise ValueError(
+                "base_url não definida. Informe base_url explicitamente ou execute via MCP para obter do header."
+            )
+
 
         return self.call_json(
             payload=body,

biatoolkit/test_sankhya.py

@@ -4,14 +4,15 @@ import os
 from biatoolkit.sankhya_call import Sankhya, SankhyaHTTPError
 import json
 
+
 # Opcional: não depende mais disso, mas pode deixar.
 os.environ.setdefault("SANKHYA_SERVICE_PATH", "/mge/service.sbr")
 
 # ⚠️ COLE AQUI seu JSESSIONID em UMA LINHA (sem ENTER no meio)
-REAL = "CrK0qgoMYcnfZsURMi7iarpFKWSVqS-qO3HWMiu8.sankhya-w-78598f67f-n7mcp"
+REAL = "qwd6yyqtbw4xMURqiaxQIJx6NLE447ZvwReMA5TP.sankhya-w-78598f67f-n7mc"
 
-if not REAL or REAL == "COLE_SEU_JSESSIONID_AQUI":
-    raise SystemExit("Cole seu JSESSIONID na variável REAL (uma linha só) e rode: python -m biatoolkit.test_sankhya")
+if not REAL:
+    raise SystemExit("Token JSESSIONID não fornecido.")
 
 # Base URL do ambiente correto (o novo)
 BASE_URL = "https://ecossistema2.sankhyacloud.com.br"
@@ -22,11 +23,9 @@ try:
     out = sk.load_view(
         "BIA_VW_MB_RULES",
         "1=1",
-        fields="COMPLDESC_A,COMPLDESC_B,CONFIDENCE_A_B,LIFT_A_B,CNT_AB,DISPONIVEL_B,DTGERACAO",
+        fields="*",
         jsessionid=REAL,
-        base_url=BASE_URL,  # <-- NOVO: injeta a base url aqui
-        # url="/mge/service.sbr",  # opcional: se quiser passar só o path
-        # url="https://ecossistema2.sankhyacloud.com.br/mge/service.sbr",  # opcional: URL completa
+        base_url=BASE_URL
     )
     print("OK! Resposta (top-level keys):", list(out.keys()))
     print(out)

{biatoolkit-1.2.1.dist-info → biatoolkit-1.2.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: biatoolkit
-Version: 1.2.1
+Version: 1.2.3
 Summary: Biblioteca para desenvolvedores que utilizam o BiaAgentBuilder
 Author: Bia Platform Team
 Author-email: data.platform@sankhya.com.br
@@ -462,9 +462,58 @@ O Bia Toolkit oferece integração pronta para consumo de serviços HTTP da plat
 
 - **SankhyaSettings**: Dataclass de configuração de timeouts/retries/SSL. Use `SankhyaSettings.from_env()` para obter as configurações do ambiente.
 - **Sankhya**: Classe principal de integração. Permite instanciar com contexto MCP (`FastMCP`) ou usar métodos estáticos.
-    - `call_json(...)`: Realiza chamada HTTP autenticada, retorna JSON.
-    - `load_view(...)`: Helper para consultas a views Sankhya (`CRUDServiceProvider.loadView`).
-    - `Call(...)`: Método estático compatível com scaffolds legados.
+    - `call_json(...)`: Realiza chamada HTTP autenticada, retorna JSON. Veja detalhes dos parâmetros abaixo.
+    - `load_view(...)`: Helper para consultas a views Sankhya (`CRUDServiceProvider.loadView`). Veja detalhes dos parâmetros abaixo.
+    - `Call(...)`: Método estático compatível com scaffolds legados. Veja detalhes dos parâmetros abaixo.
+### Parâmetros dos métodos principais
+
+#### `call_json`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| payload           | Não         | Dicionário enviado como corpo da requisição (POST). Pode ser None. |
+| jsessionid        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| url               | Não         | URL completa para chamada. Se informado, ignora base_url. |
+| base_url          | Sim*        | Base URL do serviço Sankhya (ex: https://meu.sankhya.com.br). Obrigatório se não estiver em contexto MCP (header). |
+| query             | Não         | Querystring adicional (ex: serviceName=...&outputType=json). |
+| method            | Não         | "POST" (default) ou "GET". |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+| timeout           | Não         | Tupla (connect, read) para sobrescrever timeout padrão. |
+| raise_for_http_error | Não      | Se True (default), lança SankhyaHTTPError em erro HTTP. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) se disponível. Caso contrário, será obrigatório.
+
+#### `load_view`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| view_name         | Sim         | Nome da view no Sankhya. |
+| where_sql         | Sim         | Cláusula WHERE (string). |
+| fields            | Não         | Campos a retornar (string). Default: "*". |
+| jsessionid        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| url               | Não         | URL completa opcional (override). |
+| base_url          | Não*        | Base URL do serviço Sankhya. Se não informado, tenta extrair do header do runtime (current_host). |
+| output_type       | Não         | "json" (default). |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) via BiaUtil. Caso não consiga, lança erro.
+
+#### `Call`
+
+| Parâmetro         | Obrigatório | Descrição |
+|-------------------|-------------|-----------|
+| jsessionID        | Não         | Token de sessão JSESSIONID. Se não informado, tenta extrair do header do runtime (via MCP/BiaUtil). |
+| payload           | Não         | Dicionário enviado como corpo da requisição. |
+| mcp               | Não         | Instância opcional do FastMCP para contexto do runtime. |
+| url               | Não         | URL completa (opcional). |
+| base_url          | Sim*        | Base URL do serviço Sankhya. Obrigatório se não estiver em contexto MCP (header). |
+| query             | Não         | Querystring adicional (opcional). |
+| method            | Não         | "POST" (default) ou "GET". |
+| extra_headers     | Não         | Dicionário de headers adicionais. |
+
+*Se não passar base_url, o método tentará extrair automaticamente do header do runtime (MCP) se disponível. Caso contrário, será obrigatório.
+
+**Resumo:** Sempre que possível, o toolkit resolve automaticamente base_url e jsessionid do contexto MCP (headers). Se não estiver rodando em MCP, passe base_url explicitamente.
 - **SankhyaHTTPError**: Exceção lançada em caso de erro HTTP (status != 200), contendo status_code e response_text.
 
 ### Exemplo de uso (instanciado)

{biatoolkit-1.2.1.dist-info → biatoolkit-1.2.3.dist-info}/RECORD

@@ -1,15 +1,15 @@
 biatoolkit/__init__.py,sha256=OStl3T8OY7YdGdpKIpwXtTo-IjcQxzDRHzpAoBEM8yU,98
 biatoolkit/basic_client.py,sha256=qp5T85wm6D80i3Owjz9AxUYKmaKHgImxirYCduBi1gk,4760
-biatoolkit/sankhya_call.py,sha256=mL7RZotYRu7sZNEOfsSqPLsE_NEx59Jc-8TWFYqlFtc,15281
+biatoolkit/sankhya_call.py,sha256=aPooWgFz3E3MreO4161AnTrebLXNumNJ3coN-Nhyzlg,15701
 biatoolkit/settings.py,sha256=gA07EMEb9k5tt6ySCOYTV4pKHPSiG7nSap2qhHQhmFY,3494
-biatoolkit/test_sankhya.py,sha256=WmAD9i-I8rk7Bbhq58I6ogENrak-CY-UNdIcD8Hys6I,1473
+biatoolkit/test_sankhya.py,sha256=VE8mMbzLhtyIpvm2hUCjgZC65h4FVPfro_PqPkJOjGk,1084
 biatoolkit/util.py,sha256=PgYKRl85K4wmF4WFrabTQ3yiTmgw9S2BxZ-uvwFnP6A,7768
 biatoolkit/schema/__init__.py,sha256=6lvcENhbQnelI2faBGnEs0yG0k4SkwtIrtmn4PtKWvg,32
 biatoolkit/schema/header.py,sha256=COJPlqK1cFvvWzDcCw2ru1jszWPgyyvabkjzDCc8AjM,683
 biatoolkit/validation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 biatoolkit/validation/coercion.py,sha256=6njD6VWZ92OTbv0PhwsSQa6lpWzq74zA_X46I2Z9cIU,4136
 biatoolkit/validation/validation.py,sha256=4DwAAd9PfPS7zC0X_yRYimrdj2VuIpf_jh1SfjUCVE0,3304
-biatoolkit-1.2.1.dist-info/METADATA,sha256=0d5YDug_FznoYMStKajvKQX0k_CeCv3WjGi5YIqdLy8,19540
-biatoolkit-1.2.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-biatoolkit-1.2.1.dist-info/top_level.txt,sha256=DyrMS0X6u1FDA9uT854LxoT3X7gzMAlsFQabE-WuKMc,11
-biatoolkit-1.2.1.dist-info/RECORD,,
+biatoolkit-1.2.3.dist-info/METADATA,sha256=0PZgn3FCyh9jFewRsA7ik3PYIzNen1_yy6JL5QGIzXE,23020
+biatoolkit-1.2.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+biatoolkit-1.2.3.dist-info/top_level.txt,sha256=DyrMS0X6u1FDA9uT854LxoT3X7gzMAlsFQabE-WuKMc,11
+biatoolkit-1.2.3.dist-info/RECORD,,