@murabei-data-science/pumpwood-services 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Murabei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,504 @@
+# pumpwood-services
+
+Biblioteca TypeScript para conectar e interagir com uma API Pumpwood. Fornece um cliente de alto nível (`PumpwoodClient`) e serviços individuais para operações CRUD, uploads, downloads e execução de actions.
+
+## Instalação
+
+```bash
+npm install @murabei-data-science/pumpwood-services
+```
+
+## Início rápido
+
+### Client-side (browser)
+
+Crie o cliente **uma vez** como singleton e importe onde precisar:
+
+```typescript
+// src/lib/pumpwood.ts
+import { PumpwoodClient } from "@murabei-data-science/pumpwood-services";
+
+export const pumpwood = new PumpwoodClient({
+  baseUrl: "https://api.seuapp.com/rest",
+  token: () => localStorage.getItem("auth_token") ?? "",
+  //       ↑ factory: reavaliada a cada request
+});
+```
+
+### Server-side (Next.js Server Actions)
+
+```typescript
+// src/lib/pumpwood.server.ts
+import { PumpwoodClient } from "@murabei-data-science/pumpwood-services";
+import { cookies } from "next/headers";
+
+async function getToken(): Promise<string> {
+  return (await cookies()).get("auth_token")?.value ?? "";
+}
+
+export const pumpwood = new PumpwoodClient({
+  baseUrl: process.env.NEXT_PUBLIC_APP_API_URL!,
+  token: getToken,
+});
+```
+
+### Uso direto na page / server action
+
+```typescript
+import { pumpwood } from "@/lib/pumpwood.server";
+
+export async function fetchVariable(id: string) {
+  const [data, error] = await pumpwood.retrieve<IMyModel>(
+    "mymodel",
+    Number.parseInt(id, 10),
+    { foreign_key_fields: true, related_fields: true },
+  );
+  if (error) throw new Error(error.message);
+  if (!data) throw new Error("Nenhum dado retornado");
+  return data;
+}
+```
+
+---
+
+## `PumpwoodClient` — referência completa
+
+### `list`
+
+```typescript
+pumpwood.list<T>(modelClass, body?, queryParams?)
+```
+
+`POST /{modelClass}/list/` — listagem paginada com filtros.
+
+```typescript
+const [areas, error] = await pumpwood.list<GeoArea[]>("descriptiongeoarea", {
+  filter_dict: { is_active: true },
+  order_by: ["-created_at"],
+  limit: 20,
+  offset: 0,
+});
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `listWithoutPag`
+
+```typescript
+pumpwood.listWithoutPag<T>(modelClass, body?, queryParams?)
+```
+
+`POST /{modelClass}/list-without-pag/` — retorna **todos** os resultados sem paginação. Use para datasets pequenos (lookups, combos, versões).
+
+```typescript
+const [allAreas, error] = await pumpwood.listWithoutPag<GeoArea[]>(
+  "descriptiongeoarea",
+  {
+    filter_dict: { is_active: true },
+    fields: ["pk", "name"],
+    order_by: ["name"],
+  },
+);
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `retrieve`
+
+```typescript
+pumpwood.retrieve<T>(modelClass, pk, options?)
+```
+
+`GET /{modelClass}/retrieve/{pk}/` — busca um registro por pk.
+
+`options` aceita booleans diretamente (convertidos para query params internamente):
+
+```typescript
+const [area, error] = await pumpwood.retrieve<GeoArea>(
+  "descriptiongeoarea",
+  1,
+  { foreign_key_fields: true, related_fields: true },
+);
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `retrieveOptions`
+
+```typescript
+pumpwood.retrieveOptions<T>(modelClass, body?)
+```
+
+`POST /{modelClass}/retrieve-options/` — busca definições de campos, choices e regras de validação do modelo.
+
+```typescript
+const [options, error] = await pumpwood.retrieveOptions("descriptiongeoarea");
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `save`
+
+```typescript
+pumpwood.save<T>(modelClass, body, options?)
+```
+
+`POST /{modelClass}/save/` — cria se `pk=null`, atualiza se `pk` existe.
+
+```typescript
+const [saved, error] = await pumpwood.save<GeoArea>(
+  "descriptiongeoarea",
+  { pk: null, name: "Nova Área" },
+  { foreign_key_fields: true },
+);
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `delete`
+
+```typescript
+pumpwood.delete<T>(modelClass, pk);
+```
+
+`DELETE /{modelClass}/delete/{pk}/`
+
+```typescript
+const [, error] = await pumpwood.delete("descriptiongeoarea", 1);
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `uploadFile`
+
+```typescript
+pumpwood.uploadFile<T>(modelClass, file, jsonData, queryParams?)
+```
+
+`POST /{modelClass}/save/` via `multipart/form-data`. O arquivo é enviado como `"file"` e os dados JSON como `"__json__"`.
+
+```typescript
+const file = new File(["conteúdo"], "data.csv", { type: "text/csv" });
+const [result, error] = await pumpwood.uploadFile("documents", file, {
+  origin: "USER_UPLOAD",
+  format_type: "MELTED",
+});
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `retrieveFile`
+
+```typescript
+pumpwood.retrieveFile(modelClass, pk, fileField?)
+```
+
+`GET /{modelClass}/retrieve-file/{pk}/?file-field={fileField}` — retorna `IFileData` (`{ blob, contentType }`).
+
+⚠️ **Sempre use `try/finally` para revogar o URL e evitar memory leak:**
+
+```typescript
+const [fileData, error] = await pumpwood.retrieveFile("documents", 42, "file");
+if (error) throw new Error(error.message);
+
+const url = URL.createObjectURL(fileData!.blob);
+try {
+  window.open(url);
+} finally {
+  URL.revokeObjectURL(url);
+}
+```
+
+---
+
+### `executeAction`
+
+```typescript
+pumpwood.executeAction<T>({ modelClass, pk, actionName, parameters?, queryParams? })
+```
+
+`POST /{modelClass}/actions/{actionName}/{pk}/` — executa uma action em uma instância.
+
+```typescript
+const [result, error] = await pumpwood.executeAction({
+  modelClass: "MaterialApprovalActivity",
+  pk: 123,
+  actionName: "review",
+  parameters: { new_status: "approved" },
+});
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `executeStaticAction`
+
+```typescript
+pumpwood.executeStaticAction<T>({ modelClass, actionName, parameters?, queryParams? })
+```
+
+Wrapper de `executeAction` com `pk=0`. Para actions de classe que não operam em instância específica.
+
+```typescript
+const [stats, error] = await pumpwood.executeStaticAction({
+  modelClass: "MaterialApprovalActivity",
+  actionName: "get_statistics",
+  parameters: { year: 2024 },
+});
+if (error) throw new Error(error.message);
+```
+
+---
+
+### `executeActionFile`
+
+```typescript
+pumpwood.executeActionFile({ modelClass, pk, actionName, parameters?, queryParams? })
+```
+
+`POST /{modelClass}/actions/{actionName}/{pk}/` — action que retorna arquivo binário (Excel, PDF, CSV). Retorna `IFileData`.
+
+⚠️ **Sempre revogue o URL após o download:**
+
+```typescript
+const [fileData, error] = await pumpwood.executeActionFile({
+  modelClass: "Report",
+  pk: 123,
+  actionName: "export_excel",
+});
+if (error) throw new Error(error.message);
+
+const url = URL.createObjectURL(fileData!.blob);
+const a = document.createElement("a");
+a.href = url;
+a.download = "report.xlsx";
+document.body.appendChild(a);
+try {
+  a.click();
+} finally {
+  document.body.removeChild(a);
+  URL.revokeObjectURL(url);
+}
+```
+
+---
+
+### `executeStaticActionFile`
+
+```typescript
+pumpwood.executeStaticActionFile({ modelClass, actionName, parameters?, queryParams? })
+```
+
+Wrapper de `executeActionFile` com `pk=0`. Para exports/geração de arquivos sem instância.
+
+```typescript
+const [fileData, error] = await pumpwood.executeStaticActionFile({
+  modelClass: "DataExport",
+  actionName: "generate_report",
+  parameters: { year: 2024, format: "xlsx" },
+});
+if (error) throw new Error(error.message);
+
+const url = URL.createObjectURL(fileData!.blob);
+try {
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = "export.xlsx";
+  a.click();
+} finally {
+  URL.revokeObjectURL(url);
+}
+```
+
+---
+
+### `loginWithCredentials`
+
+```typescript
+pumpwood.loginWithCredentials({ username, password });
+```
+
+`POST /registration/login/` — autentica com username e password, retorna o token.
+
+```typescript
+const [result, error] = await pumpwood.loginWithCredentials({
+  username: "john",
+  password: "secret",
+});
+if (error) throw new Error(error.message);
+
+// Consumidor decide onde guardar o token (cookie, localStorage, etc.)
+setCookie("PumpwoodAuthorization", result.token);
+```
+
+---
+
+### `loginWithSSO`
+
+```typescript
+pumpwood.loginWithSSO(email);
+```
+
+`POST /registration/oauth2-login/` — inicia o fluxo SSO OAuth2, retorna a URL de redirecionamento.
+
+```typescript
+const [result, error] = await pumpwood.loginWithSSO("user@example.com");
+if (error) throw new Error(error.message);
+
+// Redireciona para o provider OAuth2
+window.location.href = result.redirect_url;
+```
+
+---
+
+### `getSSOToken`
+
+```typescript
+pumpwood.getSSOToken(url);
+```
+
+Troca a URL de callback SSO (após redirect do provider) pelo token e dados do usuário.
+
+```typescript
+// Chamado após o provider redirecionar de volta
+const callbackUrl = `${baseUrl}/sso/callback/?code=xyz&state=abc`;
+const [result, error] = await pumpwood.getSSOToken(callbackUrl);
+if (error) throw new Error(error.message);
+
+setCookie("PumpwoodAuthorization", result.token);
+setCookie("user", JSON.stringify(result.user)); // { email, username }
+```
+
+---
+
+## Serviços de baixo nível
+
+Para quem precisa de controle direto, todos os serviços também são exportados individualmente e recebem um `ApiService` explícito:
+
+```typescript
+import { ApiService, ListService, RetrieveService } from "@murabei-data-science/pumpwood-services";
+
+const api = new ApiService({ baseUrl: "...", token: "..." });
+
+const [items, error] = await ListService<Item[]>(api, "mymodel", {
+  filter_dict: {},
+});
+```
+
+Serviços disponíveis: `ListService`, `ListWithoutPagService`, `RetrieveService`, `RetrieveOptionsService`, `RetrieveFileService`, `SaveService`, `DeleteService`, `UploadFileService`, `ExecuteActionService`, `ExecuteStaticActionService`, `ExecuteActionFileService`, `LoginService`, `LoginSSOService`, `GetSSOTokenService`.
+
+---
+
+## Erros de autenticação (401)
+
+Quando o token expira ou é inválido, a API retorna **401**. Configure `onUnauthorized` **uma vez** no `PumpwoodClient` para limpar a sessão e redirecionar ao login:
+
+### Server-side (Next.js Server Actions)
+
+```typescript
+// src/lib/pumpwood.server.ts
+import { PumpwoodClient } from "@murabei-data-science/pumpwood-services";
+import { cookies } from "next/headers";
+import { redirect } from "next/navigation";
+
+async function getToken() {
+  return (await cookies()).get("PumpwoodAuthorization")?.value ?? "";
+}
+
+async function logout() {
+  (await cookies()).delete("PumpwoodAuthorization");
+  (await cookies()).delete("user");
+  redirect("/login?session-expired=true");
+}
+
+export const pumpwood = new PumpwoodClient({
+  baseUrl: process.env.API_URL!,
+  token: getToken,
+  onUnauthorized: logout,
+});
+```
+
+### Client-side (browser)
+
+```typescript
+export const pumpwood = new PumpwoodClient({
+  baseUrl: process.env.NEXT_PUBLIC_API_URL!,
+  token: () => localStorage.getItem("auth_token") ?? "",
+  onUnauthorized: () => {
+    localStorage.removeItem("auth_token");
+    window.location.href = "/login?session-expired=true";
+  },
+});
+```
+
+Uso normal — a lib chama `onUnauthorized` automaticamente antes de retornar o erro:
+
+```typescript
+const [data, error] = await pumpwood.list("mymodel", filter);
+if (error) throw new Error(error.message);
+```
+
+### Uso low-level (`ApiService` direto)
+
+```typescript
+const api = new ApiService({
+  baseUrl: "...",
+  token: "...",
+  onUnauthorized: logout,
+});
+
+// ou, sem callback:
+import { isUnauthorizedError } from "@murabei-data-science/pumpwood-services";
+
+if (isUnauthorizedError(error)) await logout();
+```
+
+O campo `error.status` (401) e o helper `isUnauthorizedError(error)` também estão disponíveis no `IErrorDict` retornado pelos serviços.
+
+> Endpoints de login (`loginWithCredentials`, `loginWithSSO`, `getSSOToken`) **não** disparam `onUnauthorized` — 401 nesses casos significa credenciais inválidas, não sessão expirada.
+
+---
+
+## Tipos exportados
+
+| Tipo / Interface        | Descrição                                                                        |
+| ----------------------- | -------------------------------------------------------------------------------- |
+| `IErrorDict`            | Formato padronizado de erro: `{ message, type, payload, status?, ... }`           |
+| `UnauthorizedHandler`   | Callback `() => void \| Promise<void>` para sessão expirada (401)                  |
+| `IFileData`             | Dados de arquivo: `{ blob: Blob, contentType: string }`                          |
+| `IRetrieveOptions`      | Opções para `retrieve` e `save`: `{ foreign_key_fields?, related_fields?, ... }` |
+| `ISaveOptions`          | Alias tipado para opções de `save` (mesma forma que `IRetrieveOptions`)          |
+| `IPumpwoodClientConfig` | Config do `PumpwoodClient`: `{ baseUrl, token, onUnauthorized? }`                |
+| `TokenProvider`         | `string` ou `() => string \| Promise<string>`                                    |
+| `ApiServiceConfig`      | Config do `ApiService`: `{ baseUrl, token, onUnauthorized? }`                    |
+| `HttpMethod`            | `"GET" \| "POST" \| "PUT" \| "DELETE"`                                           |
+| `ILoginResult`          | Resultado de `loginWithCredentials`: `{ token: string }`                         |
+| `ILoginSSOResult`       | Resultado de `loginWithSSO`: `{ redirect_url: string }`                          |
+| `IGetSSOTokenUser`      | Dados do usuário SSO: `{ email: string, username: string }`                      |
+| `IGetSSOTokenResult`    | Resultado de `getSSOToken`: `{ token: string, user: IGetSSOTokenUser }`          |
+
+---
+
+## Memory leak — downloads com Blob URL
+
+Toda operação que retorna `IFileData` (Blob) requer que o URL criado por `URL.createObjectURL` seja revogado após o uso. Sem isso, o browser mantém a referência ao Blob em memória até o fechamento da aba.
+
+**Padrão correto:**
+
+```typescript
+const url = URL.createObjectURL(blob);
+try {
+  // usa o url
+} finally {
+  URL.revokeObjectURL(url); // sempre executado, mesmo em caso de erro
+}
+```
+
+Para detalhes e o caso especial de Next.js Server Actions (serialização Blob → `number[]`), veja [`docs/adr-execute-action-file.md`](./docs/adr-execute-action-file.md).

package/dist/example-usage.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Exemplos de uso do PumpwoodClient.
+ *
+ * Em projetos externos: import { PumpwoodClient } from "pumpwood-services";
+ */
+import { PumpwoodClient } from "./index.js";
+export declare const pumpwood: PumpwoodClient;
+//# sourceMappingURL=example-usage.d.ts.map

package/dist/example-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-usage.d.ts","sourceRoot":"","sources":["../example-usage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQ5C,eAAO,MAAM,QAAQ,gBAInB,CAAC"}

package/dist/example-usage.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pumpwood = void 0;
+/**
+ * Exemplos de uso do PumpwoodClient.
+ *
+ * Em projetos externos: import { PumpwoodClient } from "pumpwood-services";
+ */
+const index_js_1 = require("./index.js");
+// =============================================================================
+// CONFIGURAÇÃO — crie o cliente UMA VEZ como singleton
+//
+// CLIENT-SIDE (browser) — Arquivo: src/lib/pumpwood.ts
+// =============================================================================
+exports.pumpwood = new index_js_1.PumpwoodClient({
+    baseUrl: "http://localhost:8080/rest",
+    token: () => localStorage.getItem("auth_token") ?? "",
+    //       ↑ factory: reavaliada a cada request, sem precisar recriar o cliente
+});
+async function referenceExamples() {
+    // --- LIST ---
+    // Listagem paginada com filtros
+    const [areas, listErr] = await exports.pumpwood.list("descriptiongeoarea", {
+        filter_dict: { is_active: true },
+        order_by: ["-created_at"],
+        limit: 20,
+        offset: 0,
+    });
+    if (listErr)
+        throw new Error(listErr.message);
+    // Listagem SEM paginação — para datasets pequenos (lookups, combos, etc.)
+    const [allAreas, listNoPagErr] = await exports.pumpwood.listWithoutPag("descriptiongeoarea", {
+        filter_dict: { is_active: true },
+        fields: ["pk", "name"],
+        order_by: ["name"],
+    });
+    if (listNoPagErr)
+        throw new Error(listNoPagErr.message);
+    // --- RETRIEVE ---
+    // Busca simples
+    const [area, retrieveErr] = await exports.pumpwood.retrieve("descriptiongeoarea", 1);
+    if (retrieveErr)
+        throw new Error(retrieveErr.message);
+    // Busca com relações expandidas — opções tipadas com boolean
+    const [areaFull, retrieveFullErr] = await exports.pumpwood.retrieve("descriptiongeoarea", 1, { foreign_key_fields: true, related_fields: true });
+    if (retrieveFullErr)
+        throw new Error(retrieveFullErr.message);
+    // Opções do modelo (field definitions, choices, validation rules)
+    const [options, optionsErr] = await exports.pumpwood.retrieveOptions("descriptiongeoarea");
+    if (optionsErr)
+        throw new Error(optionsErr.message);
+    // --- SAVE ---
+    // Cria se pk=null, atualiza se pk existe
+    const [saved, saveErr] = await exports.pumpwood.save("descriptiongeoarea", {
+        pk: null,
+        name: "Nova Área",
+    });
+    if (saveErr)
+        throw new Error(saveErr.message);
+    // Save retornando relações expandidas
+    const [savedFull, saveFullErr] = await exports.pumpwood.save("descriptiongeoarea", { pk: 1, name: "Área Atualizada" }, { foreign_key_fields: true });
+    if (saveFullErr)
+        throw new Error(saveFullErr.message);
+    // --- DELETE ---
+    const [, deleteErr] = await exports.pumpwood.delete("descriptiongeoarea", 1);
+    if (deleteErr)
+        throw new Error(deleteErr.message);
+    // --- ACTIONS ---
+    // Action em instância (com pk)
+    const [, actionErr] = await exports.pumpwood.executeAction({
+        modelClass: "MaterialApprovalActivity",
+        pk: 123,
+        actionName: "review",
+        parameters: { new_status: "approved" },
+    });
+    if (actionErr)
+        throw new Error(actionErr.message);
+    // Static action (sem instância — pk=0 internamente)
+    const [stats, staticActionErr] = await exports.pumpwood.executeStaticAction({
+        modelClass: "MaterialApprovalActivity",
+        actionName: "get_statistics",
+        parameters: { year: 2024 },
+    });
+    if (staticActionErr)
+        throw new Error(staticActionErr.message);
+    // --- UPLOAD DE ARQUIVO ---
+    const file = new File(["conteúdo"], "data.csv", { type: "text/csv" });
+    const [, uploadErr] = await exports.pumpwood.uploadFile("documents", file, { origin: "USER_UPLOAD", format_type: "MELTED" });
+    if (uploadErr)
+        throw new Error(uploadErr.message);
+    // --- DOWNLOAD DE ARQUIVO (retrieve-file) ---
+    // ⚠️ Use try/finally para garantir que o URL seja sempre revogado
+    const [fileData, fileErr] = await exports.pumpwood.retrieveFile("documents", 42, "file");
+    if (fileErr)
+        throw new Error(fileErr.message);
+    {
+        const url = URL.createObjectURL(fileData.blob);
+        try {
+            window.open(url);
+        }
+        finally {
+            URL.revokeObjectURL(url);
+        }
+    }
+    // --- ACTION QUE RETORNA ARQUIVO (ex: export Excel/PDF) ---
+    // Instância com pk
+    const [reportFile, reportErr] = await exports.pumpwood.executeActionFile({
+        modelClass: "Report",
+        pk: 123,
+        actionName: "export_excel",
+        parameters: { include_charts: true },
+    });
+    if (reportErr)
+        throw new Error(reportErr.message);
+    {
+        const url = URL.createObjectURL(reportFile.blob);
+        try {
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = "report.xlsx";
+            a.click();
+        }
+        finally {
+            URL.revokeObjectURL(url); // sempre revogue para evitar memory leak
+        }
+    }
+    // Static action que retorna arquivo (sem instância)
+    const [exportFile, exportErr] = await exports.pumpwood.executeStaticActionFile({
+        modelClass: "DataExport",
+        actionName: "generate_report",
+        parameters: { year: 2024, format: "xlsx" },
+    });
+    if (exportErr)
+        throw new Error(exportErr.message);
+    {
+        const url = URL.createObjectURL(exportFile.blob);
+        try {
+            const a = document.createElement("a");
+            a.href = url;
+            a.download = "export.xlsx";
+            a.click();
+        }
+        finally {
+            URL.revokeObjectURL(url);
+        }
+    }
+    void areas;
+    void allAreas;
+    void area;
+    void areaFull;
+    void options;
+    void saved;
+    void savedFull;
+    void stats;
+}
+//# sourceMappingURL=example-usage.js.map

package/dist/example-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example-usage.js","sourceRoot":"","sources":["../example-usage.ts"],"names":[],"mappings":"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"}