jsegd-fluig-types 1.0.12 → 1.0.13

package/README.md

@@ -1,9 +1,9 @@
 # jsegd-fluig-types
 
-![Version](https://img.shields.io/badge/version-1.0.12-blue.svg)
+![Version](https://img.shields.io/badge/version-1.0.13-blue.svg)
 ![License](https://img.shields.io/badge/license-CC--BY--NC--ND--4.0-green.svg)
 
-Pacote de tipos TypeScript para desenvolvimento com a plataforma Fluig. Este pacote fornece tipagens completas para APIs do Fluig, facilitando o desenvolvimento tanto no frontend quanto no backend.
+Pacote de tipos TypeScript para desenvolvimento com a plataforma Fluig. Este pacote fornece tipagens completas para APIs do Fluig, facilitando o desenvolvimento tanto no frontend quanto no backend, incluindo suporte para webservices e implementações duais de DatasetFactory.
 
 ## 📦 Instalação
 
@@ -28,6 +28,18 @@ import "jsegd-fluig-types";
 // Exemplo: usando tipos de formulário
 const mode: FormMod = FormMod.ADD;
 
+// Exemplo: usando DatasetFactory no frontend (retorna DatasetWcmResult)
+DatasetFactory.getDataset(
+  "colleague", 
+  ["colleagueId", "colleagueName"], 
+  constraints, 
+  ["colleagueName"]
+).then(result => {
+  // result é do tipo DatasetWcmResult
+  console.log(result.columns); // string[]
+  console.log(result.values);  // unknown[]
+});
+
 // Exemplo: usando componentes de autocomplete
 const autocompleteConfig: AutocompleteOptions = {
   type: AutocompleteTypes.tag,
@@ -37,17 +49,40 @@ const autocompleteConfig: AutocompleteOptions = {
 
 #### Backend (Dataset/Evento de Workflow)
 ```typescript
-// Tipos para datasets
-function createDataset(fields: string[], constraints: Constraint[]): DatasetBuilder {
-  // Implementação do dataset
+// Tipos para datasets (retorna DefaultDataset com tipos Java)
+function createDataset(fields: string[], constraints: SearchConstraint[]): DefaultDataset {
+  const dataset = DatasetFactory.getDataset("myDataset", fields, constraints, []);
+  // dataset é do tipo DefaultDataset com métodos Java tipados
+  return dataset;
 }
 
+// Criando constraints com tipos específicos para backend
+const constraint = DatasetFactory.createConstraint(
+  "status",
+  "active",
+  "active",
+  ConstraintType.MUST
+); // Retorna SearchConstraint para backend
+
 // Tipos para eventos de workflow
 function beforeTaskSave(colleagueId: string, nextSequenceId: number, userTaskVO: UserTaskVO): void {
   // Implementação do evento
 }
 ```
 
+#### Webservices
+```typescript
+// Exemplo: usando ECMWorkflowEngineService
+const serviceManager = new ServiceManager();
+const workflowService = serviceManager.instantiate("ECMWorkflowEngineService");
+// ou alternativamente:
+const workflowService2 = serviceManager.instantiate("WorkflowEngineService");
+
+// Acesso ao service port com tipagem completa
+const port = serviceManager.getWorkflowEngineServicePort();
+const processes = port.listMyRequestProcesses("usuario123", 0, 10);
+```
+
 #### SDK do Fluig
 ```typescript
 // Acesso às APIs do Fluig com tipagem completa
@@ -62,8 +97,10 @@ const userService = fluigAPI.getUserService();
 |---------|-----------|
 | **`fluig.sdk.d.ts`** | Tipos para SDK do Fluig - APIs Java disponíveis no servidor |
 | **`java.d.ts`** | Tipos para classes Java básicas (List, ArrayList, HashMap, etc.) |
-| **`fluig.frontend.d.ts`** | Tipos para desenvolvimento frontend (widgets, portais) |
-| **`fluig.backend.d.ts`** | Tipos para desenvolvimento backend (datasets, eventos) |
+| **`fluig.frontend.d.ts`** | Tipos para desenvolvimento frontend (widgets, portais, DatasetFactory frontend) |
+| **`fluig.backend.d.ts`** | Tipos para desenvolvimento backend (datasets, eventos, ClassNameMap, ServiceManager) |
+| **`fluig.webservice.d.ts`** | Tipos para webservices (ECMWorkflowEngineService, WorkflowEngineService) |
+| **`fluig.dataset.d.ts`** | Tipos compartilhados para datasets (enums, interfaces, classes base) |
 | **`index.d.ts`** | Arquivo principal que exporta todos os tipos |
 
 ## 🎯 Funcionalidades
@@ -73,12 +110,22 @@ const userService = fluigAPI.getUserService();
 - Enums para modos de formulário (`FormMod`)
 - Tipos para autocomplete e widgets
 - Interfaces para eventos frontend
+- **DatasetFactory** com retorno otimizado para JavaScript (`DatasetWcmResult`)
 
 ### ✅ Backend  
 - Tipos para datasets e constrangimentos
 - Interfaces para eventos de workflow
 - Tipos para respostas de APIs
 - Enums para status e tipos de dados
+- **ClassNameMap** para tipagem inteligente do método `instantiate()`
+- **ServiceManager** com suporte a webservices
+- **DatasetFactory** com retorno de tipos Java (`DefaultDataset`)
+
+### ✅ Webservices
+- **ECMWorkflowEngineService** com tipagem completa baseada em WSDL
+- Mais de 40 métodos tipados para workflow engine
+- Interface **WorkflowEngineService** para operações de workflow
+- Suporte a mapeamento duplo de nomes de classe
 
 ### ✅ SDK
 - Tipagem completa para todas as APIs do Fluig
@@ -87,23 +134,68 @@ const userService = fluigAPI.getUserService();
 
 ## 💡 Exemplos Práticos
 
-### Criando um Dataset
+### DatasetFactory - Implementação Dual
+
+#### No Backend (Tipos Java)
 ```typescript
-function createDataset(fields: string[], constraints: Constraint[]): DatasetBuilder {
-  const dataset = DatasetBuilder.newDataset();
-  
-  // Adicionar colunas
-  fields.forEach(field => {
-    dataset.addColumn(field);
-  });
-  
-  // Aplicar constraints
-  constraints.forEach(constraint => {
-    // Processar constraint com tipagem
-  });
-  
-  return dataset;
-}
+// Retorna DefaultDataset com métodos Java tipados
+const dataset = DatasetFactory.getDataset(
+  "colleague",
+  ["colleagueId", "colleagueName"],
+  constraints,
+  ["colleagueName"]
+);
+
+// Métodos Java disponíveis
+const rowCount = dataset.getRowsCount(); // number
+const value = dataset.getValue(0, "colleagueId"); // java.lang.Object
+const resultSet = dataset.toResultSet(); // java.sql.ResultSet
+```
+
+#### No Frontend (Tipos JavaScript)
+```typescript
+// Retorna DatasetWcmResult otimizado para frontend
+const result = DatasetFactory.getDataset(
+  "colleague",
+  ["colleagueId", "colleagueName"],
+  constraints,
+  ["colleagueName"]
+);
+
+// Estrutura JavaScript simples
+console.log(result.columns); // string[]
+console.log(result.values);  // unknown[]
+```
+
+### ServiceManager e ClassNameMap
+```typescript
+const serviceManager = new ServiceManager();
+
+// Tipagem inteligente - ambas as formas funcionam
+const service1 = serviceManager.instantiate("ECMWorkflowEngineService");
+const service2 = serviceManager.instantiate("WorkflowEngineService");
+
+// IntelliSense completo para métodos do webservice
+const processes = service1.listMyRequestProcesses("usuario", 0, 10);
+```
+
+### Criando Constraints Específicas por Contexto
+```typescript
+// Backend - retorna SearchConstraint
+const backendConstraint = DatasetFactory.createConstraint(
+  "field",
+  "value1",
+  "value2",
+  ConstraintType.MUST
+);
+
+// Frontend - retorna Constraint
+const frontendConstraint = DatasetFactory.createConstraint(
+  "field",
+  "value1", 
+  "value2",
+  ConstraintType.MUST
+);
 ```
 
 ### Evento de Workflow

package/fluig.backend.d.ts

@@ -4,36 +4,12 @@ declare enum FormMod {
   "VIEW" = "VIEW",
   "NONE" = "NONE",
 }
-declare enum DatasetFieldType {
-  NUMBER = "NUMBER",
-  DATE = "DATE",
-  BOOLEAN = "BOOLEAN",
-  STRING = "STRING",
-  TEXT = "TEXT",
-}
 
-declare enum Status {
-  SUCCESS = "success",
-  ERROR = "error",
-  WARNING = "warning",
-  FAIL = "fail",
-}
 
 declare type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
 
 declare global {
-  interface ErrorDetail {
-    code: string;
-    message: string;
-    field?: string;
-  }
-  interface DatasetResponse {
-    status: Status;
-    code: number;
-    message: string;
-    data?: unknown;
-    errors?: ErrorDetail[];
-  }
+
 
   interface WKValues {
     WKDef: string;
@@ -58,139 +34,6 @@ declare global {
     WKActualThread: string;
   }
 
-  interface DatasetRequest {
-    wkValues: WKValues;
-    cardData: { [key: string]: string };
-  }
-
-  // Classe que representa um Dataset padrão do Fluig
-  class DefaultDataset {
-    // Implementação para adicionar uma coluna ao Dataset
-    addColumn(colName: keyof DatasetResponse): void;
-    addColumn(colName: java.lang.String): void;
-
-    // Implementação para adicionar uma linha ao Dataset
-    addRow(values: DatasetResponse): void;
-    addRow(values: java.lang.Object[]): void;
-
-    // Implementação para atualizar uma linha do Dataset
-    updateRow(values: java.lang.Object[]): void;
-
-    // Implementação para adicionar ou atualizar uma linha do Dataset
-    addOrUpdateRow(values: java.lang.Object[]): void;
-
-    // Implementação para remover uma linha do Dataset
-    deleteRow(values: java.lang.Object[]): void;
-
-    // Implementação para retornar o nome de uma coluna do Dataset
-    getColumnName(colNum: number): java.lang.String;
-
-    // Implementação para retornar os nomes das colunas do Dataset
-    getColumnsName(): java.lang.String[];
-
-    // Implementação para retornar a quantidade de colunas de um Dataset
-    getColumnsCount(): number;
-
-    // Implementação para retornar os valores do Dataset na forma de uma lista contendo mapas
-    getMap(): java.util.ArrayList<
-      java.util.HashMap<java.lang.String, java.lang.Object>
-    >;
-
-    // Implementação para retornar a quantidade de linhas disponíveis no Dataset
-    getRowsCount(): number;
-
-    // Implementação para retornar um subconjunto dos dados do Dataset, na forma de um novo Dataset
-    getSubDataset(
-      field: java.lang.String,
-      value: java.lang.Object
-    ): DefaultDataset;
-
-    // Implementação para retornar o valor armazenado no Dataset, na linha e coluna passadas por parâmetro
-    getValue(row: number, col: number): java.lang.Object;
-
-    // Implementação para retornar o valor armazenado no Dataset, na linha passada e campo passados por parâmetro
-    getValue(row: number, colName: java.lang.String): java.lang.Object;
-
-    // Implementação para retornar todos os valores de um Dataset, na forma de um array bidimensional
-    getValues(): java.lang.Object[][];
-
-    // Implementação para retornar um ResultSet contendo os dados do Dataset.
-    toResultSet(): java.sql.ResultSet;
-  }
-
-  // Cria uma nova instância do DatasetBuilder
-  class DatasetBuilder {
-    // Cria um novo Dataset
-    static newDataset(): DefaultDataset;
-  }
-
-  enum ConstraintType {
-    MUST = 1,
-    SHOULD = 2,
-    MUST_NOT = 3,
-  }
-
-  class DatasetFactory {
-    // Cria uma nova constraint para a seleção de registros do Dataset.
-    static createConstraint(
-      field: java.lang.String,
-      initialValue: java.lang.String,
-      finalValue: java.lang.String,
-      type: ConstraintType
-    ): SearchConstraint;
-
-    // Retorna uma lista de todos os Datasets disponíveis no sistema.
-    static getAvailableDatasets(): java.util.List<java.lang.String>;
-
-    // Carrega os dados de um Dataset.
-    static getDataset(
-      name: java.lang.String,
-      fields: java.lang.String[],
-      constraints: SearchConstraint[],
-      order: java.lang.String[]
-    ): DefaultDataset;
-  }
-
-  class SearchConstraint {
-    fieldName: string;
-    initialValue: string;
-    finalValue: string;
-    constraintType: ConstraintType;
-    likeSearch: boolean;
-
-    getFieldName(): string;
-    getInitialValue(): string;
-    getFinalValue(): string;
-    setLikeSearch(likeSearch: boolean): void;
-  }
-
-  // Cria um campo na tabela com o nome e tipo informados. O nome sempre deve ser informado em caracteres maiúsculos. O tipo de campo pode ser omitido e neste caso o campo será criado com o tipo String
-  function AddColumn(field: java.lang.String, type: DatasetFieldType): void;
-
-  // Determina quais são os campos chaves para o dataset. No banco de dados será criado um índice utilizando os campos informados neste método. Esses campos serão utilizados na localização dos registros para atualização ou remoção das linhas através dos métodos updateRow e deleteRow. Importante informar apenas campos que foram previamente definidos com a função addColumn. Devem ser informados em caracteres maiúsculos.
-  function setKey(fields: java.lang.String[]): void;
-
-  // Permite adicionar mais índices para obtenção de maior performance nas consultas do dataset. Devem ser informados em caracteres maiúsculos.
-  function addIndex(fields: java.lang.String[]): void;
-
-  /**
-   * Define a estrutura do dataset.
-   * @example
-   * function defineStructure(): void{
-   *    AddColumn("NOME", DatasetFieldType.STRING);
-   *    AddColumn("IDADE", DatasetFieldType.NUMBER);
-   *    setKey(["NOME"]);
-   *    addIndex(["IDADE"]);
-   * };
-   */
-  function defineStructure(): void;
-  function onSync(lastSyncDate: Date): DefaultDataset;
-  function createDataset(
-    fields: string[],
-    constraints: SearchConstraint[],
-    sortFields: string[]
-  ): DefaultDataset;
-  function onMobileSync(user: string): void;
 
   /**
    * GlobalVars

package/fluig.dataset.d.ts

@@ -0,0 +1,192 @@
+declare enum DatasetFieldType {
+  NUMBER = "NUMBER",
+  DATE = "DATE",
+  BOOLEAN = "BOOLEAN",
+  STRING = "STRING",
+  TEXT = "TEXT",
+}
+
+declare enum Status {
+  SUCCESS = "success",
+  ERROR = "error",
+  WARNING = "warning",
+  FAIL = "fail",
+}
+declare global {
+  interface ErrorDetail {
+    code: string;
+    message: string;
+    field?: string;
+  }
+  interface DatasetResponse {
+    status: Status;
+    code: number;
+    message: string;
+    data?: unknown;
+    errors?: ErrorDetail[];
+  }
+  interface DatasetRequest {
+    wkValues: WKValues;
+    cardData: { [key: string]: string };
+  }
+
+  interface DatasetWcmResult<T = unknown> {
+    columns: string[];
+    values: T[];
+  }
+
+  interface DatasetWcmCallback {
+    success: (result: DatasetWcmResult) => unknown;
+    error: (error: object, message: string, details: string) => void;
+  }
+
+  // Classe que representa um Dataset padrão do Fluig
+  class DefaultDataset {
+    // Implementação para adicionar uma coluna ao Dataset
+    addColumn(colName: keyof DatasetResponse): void;
+    addColumn(colName: java.lang.String): void;
+
+    // Implementação para adicionar uma linha ao Dataset
+    addRow(values: DatasetResponse): void;
+    addRow(values: java.lang.Object[]): void;
+
+    // Implementação para atualizar uma linha do Dataset
+    updateRow(values: java.lang.Object[]): void;
+
+    // Implementação para adicionar ou atualizar uma linha do Dataset
+    addOrUpdateRow(values: java.lang.Object[]): void;
+
+    // Implementação para remover uma linha do Dataset
+    deleteRow(values: java.lang.Object[]): void;
+
+    // Implementação para retornar o nome de uma coluna do Dataset
+    getColumnName(colNum: number): java.lang.String;
+
+    // Implementação para retornar os nomes das colunas do Dataset
+    getColumnsName(): java.lang.String[];
+
+    // Implementação para retornar a quantidade de colunas de um Dataset
+    getColumnsCount(): number;
+
+    // Implementação para retornar os valores do Dataset na forma de uma lista contendo mapas
+    getMap(): java.util.ArrayList<
+      java.util.HashMap<java.lang.String, java.lang.Object>
+    >;
+
+    // Implementação para retornar a quantidade de linhas disponíveis no Dataset
+    getRowsCount(): number;
+
+    // Implementação para retornar um subconjunto dos dados do Dataset, na forma de um novo Dataset
+    getSubDataset(
+      field: java.lang.String,
+      value: java.lang.Object
+    ): DefaultDataset;
+
+    // Implementação para retornar o valor armazenado no Dataset, na linha e coluna passadas por parâmetro
+    getValue(row: number, col: number): java.lang.Object;
+
+    // Implementação para retornar o valor armazenado no Dataset, na linha passada e campo passados por parâmetro
+    getValue(row: number, colName: java.lang.String): java.lang.Object;
+
+    // Implementação para retornar todos os valores de um Dataset, na forma de um array bidimensional
+    getValues(): java.lang.Object[][];
+
+    // Implementação para retornar um ResultSet contendo os dados do Dataset.
+    toResultSet(): java.sql.ResultSet;
+  }
+
+  // Cria uma nova instância do DatasetBuilder
+  class DatasetBuilder {
+    // Cria um novo Dataset
+    static newDataset(): DefaultDataset;
+  }
+
+  enum ConstraintType {
+    MUST = 1,
+    SHOULD = 2,
+    MUST_NOT = 3,
+  }
+
+  class DatasetFactory {
+    // Cria uma nova constraint para a seleção de registros do Dataset.
+    static createConstraint(
+      field: java.lang.String,
+      initialValue: java.lang.String,
+      finalValue: java.lang.String,
+      type: ConstraintType
+    ): SearchConstraint;
+    static createConstraint(
+      field: string,
+      initialValue: string,
+      finalValue: string,
+      type: ConstraintType
+    ): Constraint;
+
+    // Retorna uma lista de todos os Datasets disponíveis no sistema.
+    static getAvailableDatasets(): java.util.List<java.lang.String>;
+
+    // Carrega os dados de um Dataset.
+    static getDataset(
+      name: java.lang.String,
+      fields: java.lang.String[],
+      constraints: SearchConstraint[],
+      order: java.lang.String[]
+    ): DefaultDataset;
+    static getDataset(
+      name: string,
+      fields: string[],
+      constraints: SearchConstraint[],
+      order: string[]
+    ): DatasetWcmResult<unknown>;
+  }
+
+  class SearchConstraint {
+    fieldName: string;
+    initialValue: string;
+    finalValue: string;
+    constraintType: ConstraintType;
+    likeSearch: boolean;
+
+    getFieldName(): string;
+    getInitialValue(): string;
+    getFinalValue(): string;
+    setLikeSearch(likeSearch: boolean): void;
+  }
+
+  class Constraint {
+    fieldName: string;
+    initialValue: string;
+    finalValue: string;
+    constraintType: ConstraintType;
+    likeSearch: boolean;
+  }
+
+  // Cria um campo na tabela com o nome e tipo informados. O nome sempre deve ser informado em caracteres maiúsculos. O tipo de campo pode ser omitido e neste caso o campo será criado com o tipo String
+  function AddColumn(field: java.lang.String, type: DatasetFieldType): void;
+
+  // Determina quais são os campos chaves para o dataset. No banco de dados será criado um índice utilizando os campos informados neste método. Esses campos serão utilizados na localização dos registros para atualização ou remoção das linhas através dos métodos updateRow e deleteRow. Importante informar apenas campos que foram previamente definidos com a função addColumn. Devem ser informados em caracteres maiúsculos.
+  function setKey(fields: java.lang.String[]): void;
+
+  // Permite adicionar mais índices para obtenção de maior performance nas consultas do dataset. Devem ser informados em caracteres maiúsculos.
+  function addIndex(fields: java.lang.String[]): void;
+
+  /**
+   * Define a estrutura do dataset.
+   * @example
+   * function defineStructure(): void{
+   *    AddColumn("NOME", DatasetFieldType.STRING);
+   *    AddColumn("IDADE", DatasetFieldType.NUMBER);
+   *    setKey(["NOME"]);
+   *    addIndex(["IDADE"]);
+   * };
+   */
+  function defineStructure(): void;
+  function onSync(lastSyncDate: Date): DefaultDataset;
+  function createDataset(
+    fields: string[],
+    constraints: SearchConstraint[],
+    sortFields: string[]
+  ): DefaultDataset;
+  function onMobileSync(user: string): void;
+}
+export {};

package/fluig.frontend.d.ts

@@ -157,8 +157,6 @@ declare type ConfirmCallback = (
 ) => void;
 declare type MessageCallback = (element: HTMLElement, event: Event) => void;
 
-
-
 declare type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
 
 // =============================
@@ -257,21 +255,11 @@ declare global {
   // Variável global definida pelo Fluig no navegador
   const formMode: FormMod;
 
-  // Adicione as declarações de tipos para Dataset e Constraint se não estiverem disponíveis globalmente
-
+ 
   // =============================
-  // CLASSES DE DATASET
+  // CLASSES DE DATATABLE
   // =============================
 
-  // Adicione o tipo HttpMethod
-
-  
-
-  class DatasetWcmCallback {
-    success: (result: DatasetWcmResult) => unknown;
-    error: (error: object, message: string, details: string) => void;
-  }
-
   interface DataCallback {
     selectedRows(): number[];
     selectedIndex: number[];
@@ -458,11 +446,5 @@ declare global {
     static setMessage(message: string): void;
     static setVisible(visible: boolean): void;
   }
-
-  interface DatasetWcmResult<T = unknown> {
-    columns: string[];
-    values: T[];
-  }
-
 }
 export {};

package/index.d.ts

@@ -3,3 +3,4 @@ export * from "./java.d";
 export * from "./fluig.frontend.d";
 export * from "./fluig.backend.d";
 export * from "./fluig.webservice.d";
+export * from "./fluig.dataset.d";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsegd-fluig-types",
-  "version": "1.0.12",
+  "version": "1.0.13",
   "description": "Pacote de tipos para fluig",
   "license": "CC-BY-NC-ND-4.0",
   "author": "Elemar Deckmann",
@@ -12,6 +12,7 @@
     "fluig.frontend.d.ts",
     "fluig.backend.d.ts",
     "fluig.webservice.d.ts",
+    "fluig.dataset.d.ts",
     "java.d.ts"
   ]
 }