corisco 1.3.0-dev

package/README.md

@@ -0,0 +1,368 @@
+# ChatJT - Extensão para Captura de Documentos PJe
+
+Esta extensão do Chrome integra com o sistema PJe (Processo Judicial Eletrônico) para capturar documentos automaticamente e enviá-los para o ChatJT.
+
+## Arquitetura
+
+### Visão Geral
+
+A extensão é composta por múltiplos módulos que trabalham em conjunto para detectar, capturar e processar documentos do PJe:
+
+```mermaid
+graph TD
+    subgraph Content Script
+        A[content.js] --> B[UI Panel]
+        B --> C[ChatJT Iframe]
+    end
+
+    subgraph PJe Tool
+        D[main.js] --> E[PJeCurrentDocumentCapture]
+        D --> F[PJeSelectedDocuments]
+        D --> G[PJeTimeline]
+    end
+
+    E --> H[Captura Doc. Atual]
+    F --> I[Captura Docs. Selecionados]
+    G --> J[Captura Timeline]
+
+    subgraph Comunicação
+        H --> C
+        I --> C
+        J --> C
+    end
+
+```
+
+### Fluxo de Funcionamento
+
+```mermaid
+sequenceDiagram
+    participant User as Usuário
+    participant Page as Página PJe
+    participant CS as Content Script
+    participant PJeTool as Módulos PJe
+    participant Iframe as ChatJT Iframe
+
+    Page->>CS: Carrega página
+    CS->>PJeTool: Scripts são injetados (manifest.json)
+    PJeTool->>PJeTool: pje-document.js inicializa módulos
+    PJeTool->>Page: Observa mudanças no DOM
+
+    User->>Page: Navega para um documento
+    PJeTool->>PJeTool: Detecta e captura documento
+    PJeTool->>Iframe: Envia dados via postMessage
+
+    User->>Page: Seleciona documentos na timeline
+    User->>Iframe: Clica em "Anexar Selecionados"
+    Iframe->>PJeTool: Solicita extração
+    PJeTool->>Iframe: Envia documentos capturados
+```
+
+## Estrutura de Arquivos
+
+```text
+chat-jt-extensao/
+├── manifest.json              # Configuração da extensão
+├── config.js                  # Configurações centralizadas
+├── content.js                 # Script principal injetado
+├── popup/                     # Interface do popup
+├── tools/                     # Módulos de captura PJe
+│   └── pje
+│       ├── main.js                    # Gerenciador principal
+│       ├── pje-current-document.js    # Captura documento atual
+│       ├── pje-selected-documents.js  # Captura documentos selecionados
+│       └── pje-timeline.js            # Extração da timeline
+├── public/                    # Assets (ícones, etc.)
+└── styles/                    # Estilos CSS
+```
+
+## Módulos Principais
+
+### 1. Main (Gerenciador Principal)
+
+- **Responsabilidade**: Coordena todos os módulos e gerencia comunicação
+- **Funcionalidades**:
+  - Inicialização dos módulos especializados
+  - Distribuição de mensagens entre módulos
+  - Métodos comuns (extração de IDs, download de PDFs, etc.)
+
+### 2. PJeCurrentDocumentCapture
+
+- **Responsabilidade**: Captura do documento atualmente visualizado
+- **Funcionalidades**:
+  - Detecção automática de documentos
+  - Captura de PDFs via API
+  - Fallback para captura como TXT
+  - Observação de mudanças no DOM
+
+### 3. PJeSelectedDocuments
+
+- **Responsabilidade**: Captura de múltiplos documentos selecionados
+- **Funcionalidades**:
+  - Detecção de documentos marcados/selecionados
+  - Captura em lote
+  - Identificação por cor de fundo e classes CSS
+
+### 4. PJeTimeline
+
+- **Responsabilidade**: Extração da timeline do processo
+- **Funcionalidades**:
+  - Mapeamento de documentos na timeline
+  - Correlação entre IDs alfanuméricos e numéricos
+  - Extração de metadados dos documentos
+
+## Configuração
+
+### config.js
+
+Este arquivo centraliza todas as configurações da extensão:
+
+```javascript
+window.EXTENSION_CONFIG = {
+ // Configurações da aplicação
+ app: {
+  name: 'ChatJT', // Nome da extensão
+  version: '1.0', // Versão
+  iframe_url: 'http://localhost:3000/chat', // URL do ChatJT
+ },
+
+ // Configurações da interface
+ ui: {
+  panel: {
+   min_width: 520, // Largura mínima do painel
+   max_width_ratio: 0.5, // Máximo 50% da tela
+  },
+ },
+
+ // Assets da extensão
+ assets: {
+  icon: 'public/logo-white-128.png', // Ícone principal
+  chevron: 'public/chevron-right.svg', // Ícone de seta
+ },
+
+ // Configurações de desenvolvimento
+ development: {
+  debug: true, // Habilita logs
+  log_level: 1, // Nível de detalhamento (1-3)
+ },
+};
+```
+
+#### Parâmetros Configuráveis
+
+- **`app.iframe_url`**: URL do ChatJT (altere para produção)
+- **`ui.panel.min_width`**: Largura mínima do painel lateral
+- **`ui.panel.max_width_ratio`**: Proporção máxima da tela
+- **`development.debug`**: Habilita/desabilita logs no console
+- **`development.log_level`**: Controla verbosidade dos logs (1=básico, 2=detalhado, 3=verbose)
+
+### manifest.json
+
+Arquivo de configuração principal da extensão Chrome:
+
+```json
+{
+ "manifest_version": 3,
+ "name": "ChatJT",
+ "version": "1.0",
+ "description": "Extensão ChatJT para captura de documentos PJe",
+
+ "permissions": ["storage", "tabs", "activeTab"],
+
+ "host_permissions": [
+  "https://pje-hml.trt19.jus.br/*", // Hosts permitidos
+  "https://pje.trt19.jus.br/*"
+ ],
+
+ "content_scripts": [
+  {
+   "matches": ["https://*.jus.br/*"],
+   "css": ["style.css"],
+   "js": [
+    "config.js",
+    "utils.js",
+    "tools/pje/main.js",
+    "tools/pje/pje-current-document.js",
+    "tools/pje/pje-selected-documents.js",
+    "tools/pje/pje-timeline.js",
+    "content.js"
+   ]
+  }
+ ],
+
+ "web_accessible_resources": [
+  {
+   "resources": ["public/*"],
+   "matches": ["https://*.jus.br/*"]
+  }
+ ]
+}
+```
+
+#### Principais Alterações no Manifest
+
+1. **Adicionar novos hosts**:
+
+    ```json
+    "host_permissions": [
+      "https://pje-hml.trt19.jus.br/*",
+      "https://pje.trt19.jus.br/*",
+      "https://pje.trt1.jus.br/*"  // Novo host
+    ]
+    ```
+
+## Sistema de Logs
+
+A extensão possui um sistema de logging centralizado com 3 níveis:
+
+- **Nível 1 (info)**: Informações básicas
+- **Nível 2 (detail)**: Informações detalhadas
+- **Nível 3 (verbose)**: Informações muito detalhadas
+
+```javascript
+ChatJTLog.info('Mensagem básica');
+ChatJTLog.detail('Informação detalhada');
+ChatJTLog.verbose('Informação muito detalhada');
+ChatJTLog.warn('Aviso');
+ChatJTLog.error('Erro');
+```
+
+## Comunicação Entre Módulos
+
+A comunicação acontece através de `postMessage` entre os módulos e o iframe:
+
+```javascript
+// Envio de documento capturado
+this.pjeDocument.sendToIframe({
+ type: 'DOCUMENT_EXTRACTED',
+ document: documentData,
+});
+
+// Tipos de mensagens suportadas
+DOCUMENT_EXTRACTED; // Documento capturado
+DOCUMENT_DETECTED; // Documento detectado
+DOCUMENT_REMOVED; // Documento removido
+SELECTED_DOCUMENTS_EXTRACTED; // Documentos selecionados
+TIMELINE_DATA_EXTRACTED; // Timeline extraída
+```
+
+## Instalação e Desenvolvimento
+
+1. **Clone o repositório**
+2. **Configure o ambiente**:
+    - Altere os config.[env].ts dentro de `src/config/` conforme necessário
+    - Ajuste manifest.json para os hosts desejados
+3. **Instale as dependências**
+    - Execute `npm install` (é necessário ter o Node.js instalado)
+4. **Faça o build da extensão em Desenvolvimento**
+    - Execute `npm run build:dev` para gerar os arquivos necessários em `dist/`
+5. **Carregue no Chrome**:
+    - Abra `chrome://extensions/`
+    - Ative "Modo desenvolvedor"
+    - Clique em "Carregar extensão sem compactação"
+    - Selecione a pasta `dist/`
+
+### Versionamento automático
+
+Para atualizar a versão automaticamente, utilize o comando `npm run bump` com os parâmetros desejados:
+
+```bash
+# Para aumentar a versão patch 0.0.+1
+npm run bump:patch
+
+# Para aumentar a versão minor 0.+1.0
+npm run bump:minor
+
+# Para aumentar a versão major +1.0.0
+npm run bump:major
+
+# Para designar uma versão específica
+npm run bump -- 1.2.3
+```
+
+Esse comando atualizará o `package.json`, `manifest.json` e outros arquivos de configuração em `src/config/` com a nova versão.
+
+## Publicação do Módulo NPM
+
+### Configuração do Repositório Nexus
+
+A extensão utiliza o repositório npm interno do TRT19 para publicação de pacotes.
+
+**Repositório**: `https://nexus.trt19.jus.br/repository/npm/`
+
+### Configuração de Autenticação
+
+1. **Gere as credenciais em base64**:
+
+    - Utilize o comando abaixo, substituindo `user` e `password` pelas suas credenciais do Nexus (senha de rede):
+
+    ```bash
+    echo -n 'user:password' | openssl base64
+    ```
+
+2. **Configure o arquivo `~/.npmrc`**:
+
+    - Crie se não existir e adicione a linha abaixo, substituindo `<valor_base64_gerado>` pelo valor obtido no passo anterior:
+
+    ```bash
+    //nexus.trt19.jus.br/repository/npm/:_auth=<valor_base64_gerado>
+    ```
+
+3. **Verifique a autenticação**:
+
+    ```bash
+    npm whoami --registry=https://nexus.trt19.jus.br/repository/npm/
+    ```
+
+    - Deve retornar o nome do usuário se a autenticação estiver correta.
+
+### Publicação
+
+Para publicar uma nova versão do pacote:
+
+```bash
+# 1. Atualize a versão (se necessário)
+npm run bump:patch  # ou minor/major
+
+# 2. Faça o build do projeto
+npm run build:prd
+
+# 3. Publique no repositório interno
+npm publish --registry=https://nexus.trt19.jus.br/repository/npm/
+
+#4. Se quiser publicar em ambientes diferentes, use as flags --tag (dev, hml)
+# Exemplo para publicar como 'hml' (homologação)
+npm publish --tag hml --registry=https://nexus.trt19.jus.br/repository/npm/
+```
+
+### Instalação de Pacotes Publicados
+
+Para instalar pacotes do repositório interno em outros projetos:
+
+```bash
+# Instalar usando o registry específico
+npm install --registry=https://nexus.trt19.jus.br/repository/npm/ nome-do-pacote
+
+# Ou configurar o registry globalmente
+npm config set registry https://nexus.trt19.jus.br/repository/npm/
+npm install nome-do-pacote
+```
+
+## Troubleshooting
+
+### Problemas com Publicação NPM
+
+**Erro de autenticação**:
+
+- Verifique se as credenciais base64 estão corretas no `~/.npmrc`
+- Teste a autenticação: `npm whoami --registry=https://nexus.trt19.jus.br/repository/npm/`
+
+**Erro de permissão**:
+
+- Verifique se o usuário tem permissão de publicação no repositório Nexus
+- Contate o administrador do Nexus para liberação de acesso
+
+**Versão já existe**:
+
+- Atualize a versão: `npm run bump:patch` ou `minor` ou `major`
+- Ou force a republicação: `npm publish --force --registry=...`

package/package.json

@@ -0,0 +1,77 @@
+{
+	"name": "corisco",
+	"private": false,
+	"version": "1.3.0-dev",
+	"description": "Corisco - Extensão ChatJT para captura de documentos PJe",
+	"type": "module",
+	"main": ".dist/corisco.umd.js",
+	"module": ".dist/corisco.es.js",
+	"types": ".dist/index.d.ts",
+	"files": [
+		".dist/**/*",
+		"README.md"
+	],
+	"exports": {
+		".": {
+			"types": "./.dist/index.d.ts",
+			"require": "./.dist/corisco.umd.js",
+			"import": "./.dist/corisco.es.js"
+		}
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://nexus.trt19.jus.br/repository/npm/"
+	},
+	"keywords": [
+		"pje",
+		"chatjt",
+		"extensao",
+		"chrome"
+	],
+	"author": "TRT19",
+	"license": "GPL-3.0-only",
+	"scripts": {
+		"dev": "cross-env NODE_ENV=dev vite",
+		"build": "cross-env NODE_ENV=dev vite build",
+		"build:dev": "cross-env NODE_ENV=dev vite build",
+		"build:hml": "cross-env NODE_ENV=hml vite build",
+		"build:prd": "cross-env NODE_ENV=prd vite build",
+		"bump": "bash ops/bump-version.sh",
+		"bump:patch": "bash ops/bump-version.sh -patch",
+		"bump:minor": "bash ops/bump-version.sh -minor",
+		"bump:major": "bash ops/bump-version.sh -major",
+		"publish:nexus:dev": "npm run build:dev && npm publish --tag dev --registry=https://nexus.trt19.jus.br/repository/npm/",
+		"publish:nexus:hml": "npm run build:hml && npm publish --tag hml --registry=https://nexus.trt19.jus.br/repository/npm/",
+		"publish:nexus": "npm run build:prd && npm publish --tag latest --registry=https://nexus.trt19.jus.br/repository/npm/"
+	},
+	"dependencies": {
+		"@sentry/browser": "^10.8.0",
+		"@tailwindcss/vite": "^4.1.11",
+		"js-yaml": "^4.1.0",
+		"pdfjs-dist": "^5.4.54",
+		"react": "^19.1.0",
+		"react-dom": "^19.1.0",
+		"react-resizable-panels": "^3.0.5",
+		"webextension-polyfill": "^0.12.0"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.30.1",
+		"@types/chrome": "^0.1.1",
+		"@types/firefox-webext-browser": "^120.0.4",
+		"@types/js-yaml": "^4.0.9",
+		"@types/node": "^24.5.1",
+		"@types/react": "^19.1.8",
+		"@types/react-dom": "^19.1.6",
+		"@types/webextension-polyfill": "^0.12.3",
+		"@vitejs/plugin-react": "^4.6.0",
+		"cross-env": "^10.0.0",
+		"eslint": "^9.30.1",
+		"eslint-plugin-react-hooks": "^5.2.0",
+		"eslint-plugin-react-refresh": "^0.4.20",
+		"globals": "^16.3.0",
+		"typescript": "~5.8.3",
+		"typescript-eslint": "^8.35.1",
+		"vite": "^7.0.4",
+		"vite-plugin-static-copy": "^3.1.1"
+	}
+}