@designliquido/delegua-entidades 0.0.0

package/README.md

@@ -0,0 +1,96 @@
+<br>
+
+<p align="center">
+  <h3 align="center">Delégua Entidades</h3>
+  <p align="center">
+    Biblioteca Node.js com o intuito de trabalhar com entidades de dados, com base nas instruções da <a href="https://github.com/DesignLiquido/delegua" target="_blank">Linguagem Delégua</a>, junto com o framework <a href="https://github.com/DesignLiquido/liquido" target="_blank">Liquido</a>.
+  </p>
+</p>
+
+<p align="center">
+    <a href="https://github.com/DesignLiquido/delegua-entidades/issues" target="_blank">
+      <img src="https://img.shields.io/github/issues/DesignLiquido/delegua-entidades" />
+    </a>
+    <img src="https://img.shields.io/github/stars/DesignLiquido/delegua-entidades" />
+    <img src="https://img.shields.io/github/forks/DesignLiquido/delegua-entidades" />
+    <a href="https://www.npmjs.com/package/DesignLiquido/delegua-entidades" target="_blank">
+      <img src="https://img.shields.io/npm/v/DesignLiquido/delegua-entidades" />
+    </a>
+    <img src="https://img.shields.io/npm/dw/DesignLiquido/delegua-entidades" />
+    <img src="https://img.shields.io/github/license/DesignLiquido/delegua-entidades" />
+</p>
+
+## Motivação
+
+[LinConEs](https://github.com/DesignLiquido/LinConEs) nasceu da necessidade de uma linguagem de consulta em português. No entanto, escrever código de produção diretamente com uma linguagem de consulta pode ocasionar uma série de problemas, como por exemplo ataques por _SQL Injection_, uma técnica bem conhecida em que uma consulta pode ser forjada para executar operações não desejadas pelos desenvolvedores originais.
+
+Entidades é uma biblioteca para Delégua que trabalha com estruturas de manipulação de dados em alto nível, e que torna possível uma série de funcionalidades, como por exemplo:
+
+- Gerar código em linguagem de consulta de maneira segura, a partir de classes e objetos em Delégua, observando parâmetros e impedindo a injeção de outras consultas indesejadas nas operações da sua aplicação;
+- Trabalhar de maneira agnóstica, não importando qual tecnologia de dados esteja sendo usada, seja a própria memória do servidor, um banco de dados, etc.
+
+Essa biblioteca usa uma outra biblioteca chamada `lincones-js`, onde uma lógica menos especializada é implementada para ler sentenças escritas em LinConEs e traduzi-las para SQL. Como um passo intermediário dessa tradução, há a geração de objetos de alto nível que representam comandos a serem executados em SQL. Esta biblioteca, portanto, utiliza código Delégua para também gerar esses objetos de operações de bancos de dados de alto nível, que então são utilizados por bibliotecas especializadas em uma ou outra tecnologia para a geração do SQL final.
+
+### Inspiração
+
+- [Active Record (Ruby on Rails)](https://guides.rubyonrails.org/active_record_basics.html);
+- [SQLAlchemy (Python)](https://www.sqlalchemy.org/)
+- [Entity Framework (.NET)](https://learn.microsoft.com/en-us/aspnet/entity-framework)
+
+## Utilização
+
+Esta biblioteca funciona por si só apenas com [Delégua](https://github.com/DesignLiquido/delegua), mas seu maior proveito ocorre com a utilização de outras bibliotecas, usadas para escrever diversas aplicações, como sistemas Web usando [Líquido](https://github.com/DesignLiquido/liquido). Ao usar apenas por si só, toda a geração de sentenças pode ser feita ou em LinConEs, ou em SQL ANSI. Ao ser combinadas com outras bibliotecas, pode ser usada na geração de SQL mais direcionado, como por exemplo para SQLite ou PostgreSQL.
+
+O ponto de entrada dessa biblioteca é uma classe chamada `ContextoEntidades`. Esta classe contém uma série do que chamamos de coleções de dados. Cada coleção é mapeada ou como uma _collection_ de documentos ou registros (por exemplo, se usamos NoSQL), ou como uma tabela de banco de dados (quando o banco de dados é relacional). É cada uma dessas classes de coleções que geram as sentenças que as bibliotecas tecnológicas utilizam.
+
+Para melhor ilustrar este funcionamento, vamos supor uma tabela de banco de dados de artigos. Cada artigo possui um identificador (abreviado como `id`), um título (texto) e um conteúdo (também texto). Em Delégua, cada linha desta tabela pode ser mapeada como a seguinte classe:
+
+```js
+classe Artigo {
+  id: numero
+  titulo: texto
+  conteudo: texto
+}
+```
+
+Se queremos selecionar todos os artigos dessa classe e imprimi-los usando apenass Delégua, podemos fazê-lo da seguinte forma:
+
+```js
+const entidades = importar('entidades')
+const contexto = entidades.Contexto()
+const artigos = contexto.colecao(Artigo).todos()
+escreva(artigos) // Imprime a lista de todos os artigos encontrados.
+```
+
+### Colunas computadas
+
+Colunas computadas podem ser declaradas com o decorador `@computada`, informando a expressao SQL e se a coluna e persistida:
+
+```js
+classe Pedido {
+  id: numero
+  quantidade: numero
+  preco: numero
+
+  @computada({ expressao: "quantidade * preco", persistida: verdadeiro })
+  total: numero
+}
+```
+
+Colunas computadas nao sao incluídas em inserts/updates, mas podem ser lidas normalmente nas consultas.
+
+### Comandos
+
+Entidades conta com alguns comandos de seleção e manipulação de dados:
+
+- `contexto.colecao(Modelo).todos()`
+- `contexto.colecao(Modelo).obterPorId()`
+- `contexto.colecao(Modelo).obterPorCondicao()`
+
+Há também comandos de geração de SQL, se for interessante obter a consulta gerada antes da execução:
+
+- `contexto.modelo(Modelo).gerarSQLSelecionar()`
+
+## Execução por linha de comando
+
+Este pacote não funciona sozinho em modo por linha de comando. É necessário também instalar um dos pacotes específicos de tecnologia de LinConEs. 

package/fontes/analisador-dicas.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Sistema de Dicas de Otimização
+ *
+ * Fornece recomendações para otimizar consultas baseado em padrões detectados.
+ */
+export declare enum TipoDica {
+    INDICE_AUSENTE = "INDICE_AUSENTE",
+    N_MAIS_1 = "N_MAIS_1",
+    SELECAO_DESNECESSARIA = "SELECAO_DESNECESSARIA",
+    JUNCAO_REDUNDANTE = "JUNCAO_REDUNDANTE",
+    PAGINACAO_FALTANTE = "PAGINACAO_FALTANTE",
+    ORDEM_INEFICIENTE = "ORDEM_INEFICIENTE",
+    USAR_CARGA_ANTECIPADA = "USAR_CARGA_ANTECIPADA",
+    USAR_CARGA_EM_LOTE = "USAR_CARGA_EM_LOTE",
+    CACHE_RECOMENDADA = "CACHE_RECOMENDADA"
+}
+export declare enum NivelSeveridade {
+    CRITICO = "CRITICO",
+    ALTO = "ALTO",
+    MEDIO = "MEDIO",
+    BAIXO = "BAIXO",
+    INFO = "INFO"
+}
+export interface Dica {
+    tipo: TipoDica;
+    severidade: NivelSeveridade;
+    mensagem: string;
+    sugestao: string;
+    metrica?: {
+        nome: string;
+        valor: number;
+        unidade: string;
+    };
+}
+export declare class AnalisadorDicas {
+    /**
+     * Analisa consulta e retorna dicas de otimização
+     */
+    static analisar(sql: string, metricasExecucao?: {
+        tempoMs: number;
+        linhas: number;
+        contagemJuncoes: number;
+    }): Dica[];
+    /**
+     * Formata dicas para exibição
+     */
+    static formatarDicas(dicas: Dica[]): string;
+}
+//# sourceMappingURL=analisador-dicas.d.ts.map

package/fontes/analisador-dicas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analisador-dicas.d.ts","sourceRoot":"","sources":["../../fontes/analisador-dicas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,oBAAY,QAAQ;IAChB,cAAc,mBAAmB;IACjC,QAAQ,aAAa;IACrB,qBAAqB,0BAA0B;IAC/C,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,qBAAqB,0BAA0B;IAC/C,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;CAC1C;AAED,oBAAY,eAAe;IACvB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,KAAK,UAAU;IACf,KAAK,UAAU;IACf,IAAI,SAAS;CAChB;AAED,MAAM,WAAW,IAAI;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,eAAe,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;KACnB,CAAC;CACL;AAED,qBAAa,eAAe;IACxB;;OAEG;IACH,MAAM,CAAC,QAAQ,CACX,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,eAAe,EAAE,MAAM,CAAC;KAC3B,GACF,IAAI,EAAE;IAoET;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM;CAwD9C"}

package/fontes/analisador-dicas.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Sistema de Dicas de Otimização
+ *
+ * Fornece recomendações para otimizar consultas baseado em padrões detectados.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AnalisadorDicas = exports.NivelSeveridade = exports.TipoDica = void 0;
+var TipoDica;
+(function (TipoDica) {
+    TipoDica["INDICE_AUSENTE"] = "INDICE_AUSENTE";
+    TipoDica["N_MAIS_1"] = "N_MAIS_1";
+    TipoDica["SELECAO_DESNECESSARIA"] = "SELECAO_DESNECESSARIA";
+    TipoDica["JUNCAO_REDUNDANTE"] = "JUNCAO_REDUNDANTE";
+    TipoDica["PAGINACAO_FALTANTE"] = "PAGINACAO_FALTANTE";
+    TipoDica["ORDEM_INEFICIENTE"] = "ORDEM_INEFICIENTE";
+    TipoDica["USAR_CARGA_ANTECIPADA"] = "USAR_CARGA_ANTECIPADA";
+    TipoDica["USAR_CARGA_EM_LOTE"] = "USAR_CARGA_EM_LOTE";
+    TipoDica["CACHE_RECOMENDADA"] = "CACHE_RECOMENDADA";
+})(TipoDica || (exports.TipoDica = TipoDica = {}));
+var NivelSeveridade;
+(function (NivelSeveridade) {
+    NivelSeveridade["CRITICO"] = "CRITICO";
+    NivelSeveridade["ALTO"] = "ALTO";
+    NivelSeveridade["MEDIO"] = "MEDIO";
+    NivelSeveridade["BAIXO"] = "BAIXO";
+    NivelSeveridade["INFO"] = "INFO";
+})(NivelSeveridade || (exports.NivelSeveridade = NivelSeveridade = {}));
+class AnalisadorDicas {
+    /**
+     * Analisa consulta e retorna dicas de otimização
+     */
+    static analisar(sql, metricasExecucao) {
+        const dicas = [];
+        // Detecta SELECT *
+        if (sql.toLowerCase().includes("select *")) {
+            dicas.push({
+                tipo: TipoDica.SELECAO_DESNECESSARIA,
+                severidade: NivelSeveridade.MEDIO,
+                mensagem: "Consulta usa SELECT * (todas as colunas)",
+                sugestao: "Especifique apenas as colunas necessárias para melhorar performance"
+            });
+        }
+        // Detecta múltiplos JOINs
+        const juncoes = (sql.match(/join/gi) || []).length;
+        if (juncoes > 2) {
+            dicas.push({
+                tipo: TipoDica.JUNCAO_REDUNDANTE,
+                severidade: NivelSeveridade.ALTO,
+                mensagem: `Consulta tem ${juncoes} junções (acima do recomendado)`,
+                sugestao: "Considere usar eager loading ou reorganizar a estrutura de dados",
+                metrica: {
+                    nome: "Junções",
+                    valor: juncoes,
+                    unidade: "quantidade"
+                }
+            });
+        }
+        // Detecta falta de LIMIT
+        if (!sql.toLowerCase().includes("limit") && !sql.toLowerCase().includes("top")) {
+            dicas.push({
+                tipo: TipoDica.PAGINACAO_FALTANTE,
+                severidade: NivelSeveridade.ALTO,
+                mensagem: "Consulta sem LIMITE pode retornar muitas linhas",
+                sugestao: "Adicione paginação com LIMITE e DESLOCAMENTO para dados em larga escala"
+            });
+        }
+        // Análise de desempenho se métricas disponíveis
+        if (metricasExecucao) {
+            if (metricasExecucao.tempoMs > 1000 && metricasExecucao.linhas > 10000) {
+                dicas.push({
+                    tipo: TipoDica.CACHE_RECOMENDADA,
+                    severidade: NivelSeveridade.ALTO,
+                    mensagem: "Consulta lenta com muitos resultados",
+                    sugestao: "Use cache para resultados desta consulta ou otimize índices",
+                    metrica: {
+                        nome: "Tempo",
+                        valor: metricasExecucao.tempoMs,
+                        unidade: "ms"
+                    }
+                });
+            }
+            if (metricasExecucao.tempoMs > 500 && juncoes > 0) {
+                dicas.push({
+                    tipo: TipoDica.USAR_CARGA_EM_LOTE,
+                    severidade: NivelSeveridade.MEDIO,
+                    mensagem: "JOINs resultando em consulta lenta",
+                    sugestao: "Considere usar carga em lote em vez de junções diretas"
+                });
+            }
+        }
+        return dicas;
+    }
+    /**
+     * Formata dicas para exibição
+     */
+    static formatarDicas(dicas) {
+        if (dicas.length === 0) {
+            return "✅ Nenhuma dica de otimização necessária";
+        }
+        const linhas = [
+            `📋 Dicas de Otimização (${dicas.length} encontrada${dicas.length > 1 ? 's' : ''}):`,
+            ""
+        ];
+        // Agrupa por severidade
+        const porSeveridade = new Map();
+        for (const dica of dicas) {
+            if (!porSeveridade.has(dica.severidade)) {
+                porSeveridade.set(dica.severidade, []);
+            }
+            porSeveridade.get(dica.severidade).push(dica);
+        }
+        // Ordem de severidade
+        const ordem = [
+            NivelSeveridade.CRITICO,
+            NivelSeveridade.ALTO,
+            NivelSeveridade.MEDIO,
+            NivelSeveridade.BAIXO,
+            NivelSeveridade.INFO
+        ];
+        for (const severidade of ordem) {
+            const dicasPorSev = porSeveridade.get(severidade);
+            if (!dicasPorSev)
+                continue;
+            const icone = {
+                [NivelSeveridade.CRITICO]: "🔴",
+                [NivelSeveridade.ALTO]: "🟠",
+                [NivelSeveridade.MEDIO]: "🟡",
+                [NivelSeveridade.BAIXO]: "🔵",
+                [NivelSeveridade.INFO]: "ℹ️"
+            };
+            linhas.push(`\n${icone[severidade]} ${severidade}:`);
+            for (const dica of dicasPorSev) {
+                linhas.push(`  • ${dica.mensagem}`);
+                linhas.push(`    → ${dica.sugestao}`);
+                if (dica.metrica) {
+                    linhas.push(`    | ${dica.metrica.nome}: ${dica.metrica.valor} ${dica.metrica.unidade}`);
+                }
+            }
+        }
+        return linhas.join("\n");
+    }
+}
+exports.AnalisadorDicas = AnalisadorDicas;
+//# sourceMappingURL=analisador-dicas.js.map

package/fontes/analisador-dicas.js.map

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

package/fontes/cache-consultas.d.ts

@@ -0,0 +1,39 @@
+export declare class CacheConsultas<T = any> {
+    private cache;
+    private limite;
+    private estatisticas;
+    constructor(limite?: number);
+    /**
+     * Gera chave única para a consulta
+     */
+    private gerarChave;
+    /**
+     * Obtém consulta do cache se existir
+     */
+    obter(sql: string, parametros?: any[]): T | null;
+    /**
+     * Armazena consulta no cache
+     */
+    armazenar(sql: string, consulta: T, parametros?: any[]): void;
+    /**
+     * Remove entrada menos usada/mais antiga
+     */
+    private limparEntrada;
+    /**
+     * Limpa todo o cache
+     */
+    limparTudo(): void;
+    /**
+     * Retorna estatísticas de cache
+     */
+    obterEstatisticas(): {
+        tamanho: number;
+        limite: number;
+        acertos: number;
+        extravios: number;
+        limpezas: number;
+        taxaAcerto: string;
+        utilizacao: string;
+    };
+}
+//# sourceMappingURL=cache-consultas.d.ts.map

package/fontes/cache-consultas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-consultas.d.ts","sourceRoot":"","sources":["../../fontes/cache-consultas.ts"],"names":[],"mappings":"AAYA,qBAAa,cAAc,CAAC,CAAC,GAAG,GAAG;IAC/B,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAIlB;gBAEU,MAAM,GAAE,MAAY;IAIhC;;OAEG;IACH,OAAO,CAAC,UAAU;IAKlB;;OAEG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAehD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,IAAI;IAe7D;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,iBAAiB;;;;;;;;;CAgBpB"}

package/fontes/cache-consultas.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CacheConsultas = void 0;
+class CacheConsultas {
+    constructor(limite = 100) {
+        this.cache = new Map();
+        this.estatisticas = {
+            acertos: 0,
+            extravios: 0,
+            limpezas: 0
+        };
+        this.limite = limite;
+    }
+    /**
+     * Gera chave única para a consulta
+     */
+    gerarChave(sql, parametros = []) {
+        const parametrosStr = JSON.stringify(parametros);
+        return `${sql}:${parametrosStr}`;
+    }
+    /**
+     * Obtém consulta do cache se existir
+     */
+    obter(sql, parametros) {
+        const chave = this.gerarChave(sql, parametros);
+        const entrada = this.cache.get(chave);
+        if (entrada) {
+            entrada.acessos++;
+            entrada.ultimoAcesso = new Date();
+            this.estatisticas.acertos++;
+            return entrada.consulta;
+        }
+        this.estatisticas.extravios++;
+        return null;
+    }
+    /**
+     * Armazena consulta no cache
+     */
+    armazenar(sql, consulta, parametros) {
+        const chave = this.gerarChave(sql, parametros);
+        // Limpar se cache cheio
+        if (this.cache.size >= this.limite) {
+            this.limparEntrada();
+        }
+        this.cache.set(chave, {
+            consulta,
+            acessos: 0,
+            ultimoAcesso: new Date()
+        });
+    }
+    /**
+     * Remove entrada menos usada/mais antiga
+     */
+    limparEntrada() {
+        let chaveParaRemover = null;
+        let menorPontuacao = Infinity;
+        for (const [chave, entrada] of this.cache.entries()) {
+            // Pontuação = acessos + dias desde último acesso (penalidade)
+            const diasDesdeAcesso = (new Date().getTime() - entrada.ultimoAcesso.getTime()) / (1000 * 60 * 60 * 24);
+            const pontuacao = entrada.acessos - (diasDesdeAcesso * 0.1);
+            if (pontuacao < menorPontuacao) {
+                menorPontuacao = pontuacao;
+                chaveParaRemover = chave;
+            }
+        }
+        if (chaveParaRemover) {
+            this.cache.delete(chaveParaRemover);
+            this.estatisticas.limpezas++;
+        }
+    }
+    /**
+     * Limpa todo o cache
+     */
+    limparTudo() {
+        this.cache.clear();
+        this.estatisticas = { acertos: 0, extravios: 0, limpezas: 0 };
+    }
+    /**
+     * Retorna estatísticas de cache
+     */
+    obterEstatisticas() {
+        const total = this.estatisticas.acertos + this.estatisticas.extravios;
+        const taxaAcerto = total > 0
+            ? ((this.estatisticas.acertos / total) * 100).toFixed(2)
+            : "0.00";
+        return {
+            tamanho: this.cache.size,
+            limite: this.limite,
+            acertos: this.estatisticas.acertos,
+            extravios: this.estatisticas.extravios,
+            limpezas: this.estatisticas.limpezas,
+            taxaAcerto: `${taxaAcerto}%`,
+            utilizacao: `${((this.cache.size / this.limite) * 100).toFixed(2)}%`
+        };
+    }
+}
+exports.CacheConsultas = CacheConsultas;
+//# sourceMappingURL=cache-consultas.js.map

package/fontes/cache-consultas.js.map

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

package/fontes/carregador-lotes.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Carregador em Lote (DataLoader)
+ *
+ * Agrupa múltiplas requisições de relacionamentos em poucas queries,
+ * evitando o problema N+1 através de batching inteligente.
+ */
+interface ConfiguracaoLote {
+    tamanhoLote: number;
+    intervaloMs: number;
+    cache: boolean;
+}
+export declare class CarregadorLote<T> {
+    private funcaoCarregamento;
+    private fila;
+    private tempoMaximo;
+    private cache;
+    private configuracao;
+    constructor(funcaoCarregamento: (chaves: any[]) => Promise<Map<any, T>>, config?: Partial<ConfiguracaoLote>);
+    /**
+     * Solicita carregamento de um item
+     */
+    carregar(chave: any): Promise<T>;
+    /**
+     * Processa lote de carregamentos
+     */
+    private processar;
+    /**
+     * Limpa cache
+     */
+    limparCache(): void;
+    /**
+     * Retorna estatísticas
+     */
+    obterEstatisticas(): {
+        filaAtual: number;
+        tamanhoCache: number;
+        tamanhoLote: number;
+        intervaloMs: number;
+    };
+}
+/**
+ * Gerenciador de Carregadores em Lote para Relacionamentos
+ */
+export declare class GerenciadorCarregadoresLote {
+    private carregadores;
+    /**
+     * Cria carregador para um relacionamento específico
+     */
+    criarCarregador<T>(chave: string, funcaoCarregamento: (ids: any[]) => Promise<Map<any, T>>, config?: Partial<ConfiguracaoLote>): CarregadorLote<T>;
+    /**
+     * Obtém carregador existente
+     */
+    obterCarregador<T>(chave: string): CarregadorLote<T> | null;
+    /**
+     * Limpa todos os carregadores
+     */
+    limparTodos(): void;
+    /**
+     * Obtém status de todos os carregadores
+     */
+    obterStatus(): Record<string, any>;
+}
+export {};
+//# sourceMappingURL=carregador-lotes.d.ts.map

package/fontes/carregador-lotes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"carregador-lotes.d.ts","sourceRoot":"","sources":["../../fontes/carregador-lotes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,UAAU,gBAAgB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAClB;AAQD,qBAAa,cAAc,CAAC,CAAC;IAOrB,OAAO,CAAC,kBAAkB;IAN9B,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,YAAY,CAAmB;gBAG3B,kBAAkB,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EACnE,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;IAStC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC;IAwBhC;;OAEG;YACW,SAAS;IA2CvB;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,iBAAiB;;;;;;CAQpB;AAED;;GAEG;AACH,qBAAa,2BAA2B;IACpC,OAAO,CAAC,YAAY,CAA+C;IAEnE;;OAEG;IACH,eAAe,CAAC,CAAC,EACb,KAAK,EAAE,MAAM,EACb,kBAAkB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EACxD,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACnC,cAAc,CAAC,CAAC,CAAC;IAMpB;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI;IAI3D;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,WAAW;CASd"}

package/fontes/carregador-lotes.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Carregador em Lote (DataLoader)
+ *
+ * Agrupa múltiplas requisições de relacionamentos em poucas queries,
+ * evitando o problema N+1 através de batching inteligente.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GerenciadorCarregadoresLote = exports.CarregadorLote = void 0;
+class CarregadorLote {
+    constructor(funcaoCarregamento, config) {
+        this.funcaoCarregamento = funcaoCarregamento;
+        this.fila = [];
+        this.tempoMaximo = null;
+        this.cache = new Map();
+        this.configuracao = {
+            tamanhoLote: config?.tamanhoLote ?? 100,
+            intervaloMs: config?.intervaloMs ?? 16,
+            cache: config?.cache ?? true
+        };
+    }
+    /**
+     * Solicita carregamento de um item
+     */
+    carregar(chave) {
+        return new Promise((resolver, rejeitar) => {
+            // Verifica cache primeiro
+            if (this.configuracao.cache) {
+                const chaveStr = String(chave);
+                const emCache = this.cache.get(chaveStr);
+                if (emCache) {
+                    return resolver(emCache);
+                }
+            }
+            // Adiciona à fila
+            this.fila.push({ chave, resolver, rejeitar });
+            // Processa se atingiu tamanho do lote
+            if (this.fila.length >= this.configuracao.tamanhoLote) {
+                this.processar();
+            }
+            else if (!this.tempoMaximo) {
+                // Agenda processamento após delay
+                this.tempoMaximo = setTimeout(() => this.processar(), this.configuracao.intervaloMs);
+            }
+        });
+    }
+    /**
+     * Processa lote de carregamentos
+     */
+    async processar() {
+        const loteAtual = this.fila.splice(0, this.configuracao.tamanhoLote);
+        if (this.tempoMaximo) {
+            clearTimeout(this.tempoMaximo);
+            this.tempoMaximo = null;
+        }
+        if (loteAtual.length === 0)
+            return;
+        try {
+            const chaves = loteAtual.map(r => r.chave);
+            const resultados = await this.funcaoCarregamento(chaves);
+            // Distribui resultados
+            for (const requisicao of loteAtual) {
+                const resultado = resultados.get(requisicao.chave);
+                if (resultado !== undefined) {
+                    // Armazena em cache
+                    if (this.configuracao.cache) {
+                        this.cache.set(String(requisicao.chave), resultado);
+                    }
+                    requisicao.resolver(resultado);
+                }
+                else {
+                    requisicao.rejeitar(new Error(`Nenhum resultado para chave: ${requisicao.chave}`));
+                }
+            }
+        }
+        catch (erro) {
+            // Rejeita todos em caso de erro
+            for (const requisicao of loteAtual) {
+                requisicao.rejeitar(erro);
+            }
+        }
+        // Processa próximo lote se houver
+        if (this.fila.length > 0) {
+            this.processar();
+        }
+    }
+    /**
+     * Limpa cache
+     */
+    limparCache() {
+        this.cache.clear();
+    }
+    /**
+     * Retorna estatísticas
+     */
+    obterEstatisticas() {
+        return {
+            filaAtual: this.fila.length,
+            tamanhoCache: this.cache.size,
+            tamanhoLote: this.configuracao.tamanhoLote,
+            intervaloMs: this.configuracao.intervaloMs
+        };
+    }
+}
+exports.CarregadorLote = CarregadorLote;
+/**
+ * Gerenciador de Carregadores em Lote para Relacionamentos
+ */
+class GerenciadorCarregadoresLote {
+    constructor() {
+        this.carregadores = new Map();
+    }
+    /**
+     * Cria carregador para um relacionamento específico
+     */
+    criarCarregador(chave, funcaoCarregamento, config) {
+        const carregador = new CarregadorLote(funcaoCarregamento, config);
+        this.carregadores.set(chave, carregador);
+        return carregador;
+    }
+    /**
+     * Obtém carregador existente
+     */
+    obterCarregador(chave) {
+        return this.carregadores.get(chave) || null;
+    }
+    /**
+     * Limpa todos os carregadores
+     */
+    limparTodos() {
+        for (const carregador of this.carregadores.values()) {
+            carregador.limparCache();
+        }
+        this.carregadores.clear();
+    }
+    /**
+     * Obtém status de todos os carregadores
+     */
+    obterStatus() {
+        const status = {};
+        for (const [chave, carregador] of this.carregadores.entries()) {
+            status[chave] = carregador.obterEstatisticas();
+        }
+        return status;
+    }
+}
+exports.GerenciadorCarregadoresLote = GerenciadorCarregadoresLote;
+//# sourceMappingURL=carregador-lotes.js.map