@lexnode/legal-data-sdk 1.24.0 → 1.25.0

package/README.md

@@ -302,6 +302,25 @@ if (meta.partialIndex) {
 }
 ```
 
+Antes de recusar a resposta parcial que veio sem o processo porque partes do
+índice ficaram fora, o motor consulta a fonte de novo — até duas vezes, com uma
+pausa curta, enquanto a espera couber.
+
+**`meta.otherInstances`: o número tem outro documento na fonte.** A fonte pode
+guardar mais de um documento por número — em geral um por instância (1º grau,
+2º grau, turma recursal…), às vezes dois no mesmo grau —, e o motor serve e
+guarda um só: o de `data`, cujo grau está em `degree`. Quando a resposta da
+fonte trouxe outros, `meta.otherInstances` lista cada um com o grau (`grau`), a
+data em que a fonte o atualizou (`updatedAt`) e o órgão julgador (`courtBody`,
+quando vem). A lista não sai para processo restrito e não inclui documento que o
+motor classificaria como segredo de justiça.
+
+```ts
+for (const outra of meta.otherInstances ?? []) {
+  // Ex.: { grau: "G1", updatedAt: "2026-04-15T12:00:00.000Z" }
+}
+```
+
 **Agentes têm a espera deles.** No canal para agentes (MCP), as tools
 `ler_processo` e `consultar_processo` escolhem a espera em `maxWaitSeconds`, na
 mesma faixa e com padrão de 120 s; esse canal não passa pelo SDK.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lexnode/legal-data-sdk",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "Cliente TypeScript do LexNode, o motor de dados jur\u00eddicos do Brasil: transporte tipado, erros classificados, verifica\u00e7\u00e3o de webhook e os tipos gerados do contrato OpenAPI.",
   "license": "MIT",
   "homepage": "https://www.lexnode.com.br/docs",

package/schema.d.ts

@@ -159,7 +159,7 @@ export interface paths {
         };
         /**
          * Obter um processo pelo número
-         * @description Retorna o registro exato do processo para o tribunal e o número informados, com resolução cache-first quando disponível. `waitSeconds` escolhe quanto esperar pela fonte processual. Quando a fonte responde com parte do índice e o processo está na parte que respondeu, ele é servido e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`), de quantas (`shardsTotal`) e se o prazo interno da fonte estourou (`timedOut`): outra instância do mesmo número, se existir, pode não ter vindo. A exceção é o processo que veio de uma instância diferente da que o acervo já guarda do número: a guardada pode estar na parte que não respondeu, e a resposta parcial não é servida. Resposta parcial que não serve o processo — sem ele, ou com a outra instância — é 502 `UPSTREAM_UNAVAILABLE` retentável, nunca 404.
+         * @description Retorna o registro exato do processo para o tribunal e o número informados, com resolução cache-first quando disponível. `waitSeconds` escolhe quanto esperar pela fonte processual. Quando a fonte responde com parte do índice e o processo está na parte que respondeu, ele é servido e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`), de quantas (`shardsTotal`) e se o prazo interno da fonte estourou (`timedOut`): outra instância do mesmo número, se existir, pode não ter vindo. A exceção é o processo que veio de uma instância diferente da que o acervo já guarda do número: a guardada pode estar na parte que não respondeu, e a resposta parcial não é servida. Resposta parcial que não serve o processo — sem ele, ou com a outra instância — é 502 `UPSTREAM_UNAVAILABLE` retentável, nunca 404; antes dela, o motor consulta a fonte de novo, até duas vezes, enquanto o prazo de `waitSeconds` couber. Quando a resposta traz mais de um documento do número — em geral um por instância, mas dois podem ser do mesmo grau —, o motor serve e guarda um só, o de `data` (grau em `degree`), e `meta.otherInstances` lista os outros que vieram: grau, data de atualização na fonte e órgão julgador.
          *
          *     **Escopo exigido na chave de API:** `PROCESSES_READ`
          */
@@ -203,7 +203,7 @@ export interface paths {
         };
         /**
          * Obter um snapshot vivo do processo
-         * @description Busca o hit exato do processo no upstream do CNJ e retorna o registro normalizado do processo, o payload bruto da fonte e as movimentações CNJ normalizadas. `waitSeconds` escolhe quanto esperar pela fonte processual. Quando a fonte responde com parte do índice e o processo está na parte que respondeu, ele é servido e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`), de quantas (`shardsTotal`) e se o prazo interno da fonte estourou (`timedOut`): outra instância do mesmo número, se existir, pode não ter vindo. A exceção é o processo que veio de uma instância diferente da que o acervo já guarda do número: a guardada pode estar na parte que não respondeu, e a resposta parcial não é servida. Resposta parcial que não serve o processo — sem ele, ou com a outra instância — é 502 `UPSTREAM_UNAVAILABLE` retentável, nunca 404.
+         * @description Busca o hit exato do processo no upstream do CNJ e retorna o registro normalizado do processo, o payload bruto da fonte e as movimentações CNJ normalizadas. `waitSeconds` escolhe quanto esperar pela fonte processual. Quando a fonte responde com parte do índice e o processo está na parte que respondeu, ele é servido e `meta.partialIndex` diz quantas partes falharam (`shardsFailed`), de quantas (`shardsTotal`) e se o prazo interno da fonte estourou (`timedOut`): outra instância do mesmo número, se existir, pode não ter vindo. A exceção é o processo que veio de uma instância diferente da que o acervo já guarda do número: a guardada pode estar na parte que não respondeu, e a resposta parcial não é servida. Resposta parcial que não serve o processo — sem ele, ou com a outra instância — é 502 `UPSTREAM_UNAVAILABLE` retentável, nunca 404; antes dela, o motor consulta a fonte de novo, até duas vezes, enquanto o prazo de `waitSeconds` couber. Quando a resposta traz mais de um documento do número — em geral um por instância, mas dois podem ser do mesmo grau —, o motor serve e guarda um só, o de `data` (grau em `degree`), e `meta.otherInstances` lista os outros que vieram: grau, data de atualização na fonte e órgão julgador.
          *
          *     **Escopo exigido na chave de API:** `PROCESSES_READ`
          */
@@ -2131,6 +2131,18 @@ export interface operations {
                                 /** @description A fonte estourou o próprio prazo interno e devolveu só o que deu tempo de olhar. */
                                 timedOut: boolean;
                             };
+                            /** @description Presente só quando a resposta da fonte trouxe mais de um documento do número — em geral de instâncias diferentes, mas dois podem ter o mesmo `grau`. O motor serve e guarda um só (o de `data`, que diz o grau em `degree`); estes são os outros que vieram na mesma resposta. Não inclui documento que o motor classificaria como segredo de justiça, e não aparece quando o processo servido é restrito. */
+                            otherInstances?: {
+                                /** @description O grau deste documento na fonte: G1, G2, JE, TR… */
+                                grau: string | null;
+                                /**
+                                 * Format: date-time
+                                 * @description Quando a fonte atualizou este documento pela última vez.
+                                 */
+                                updatedAt: string | null;
+                                /** @description O órgão julgador deste documento, quando a fonte o traz. */
+                                courtBody?: string;
+                            }[];
                         } & {
                             [key: string]: unknown;
                         };
@@ -2764,6 +2776,18 @@ export interface operations {
                                 /** @description A fonte estourou o próprio prazo interno e devolveu só o que deu tempo de olhar. */
                                 timedOut: boolean;
                             };
+                            /** @description Presente só quando a resposta da fonte trouxe mais de um documento do número — em geral de instâncias diferentes, mas dois podem ter o mesmo `grau`. O motor serve e guarda um só (o de `data`, que diz o grau em `degree`); estes são os outros que vieram na mesma resposta. Não inclui documento que o motor classificaria como segredo de justiça, e não aparece quando o processo servido é restrito. */
+                            otherInstances?: {
+                                /** @description O grau deste documento na fonte: G1, G2, JE, TR… */
+                                grau: string | null;
+                                /**
+                                 * Format: date-time
+                                 * @description Quando a fonte atualizou este documento pela última vez.
+                                 */
+                                updatedAt: string | null;
+                                /** @description O órgão julgador deste documento, quando a fonte o traz. */
+                                courtBody?: string;
+                            }[];
                         } & {
                             [key: string]: unknown;
                         };