tutanus 0.12.0

package/dist/shared/helpers/line-lookup.js

@@ -0,0 +1,26 @@
+export function createLineLookup(src) {
+    const newlineIndexes = [];
+    for (let indice = 0; indice < src.length; indice++) {
+        if (src.charCodeAt(indice) === 10)
+            newlineIndexes.push(indice);
+    }
+    const lineAt = (index) => {
+        if (!index || index <= 0)
+            return 1;
+        const clampedIndex = Math.min(src.length, Math.max(0, index));
+        let lo = 0;
+        let hi = newlineIndexes.length;
+        while (lo < hi) {
+            const mid = lo + hi >>> 1;
+            if (newlineIndexes[mid] < clampedIndex)
+                lo = mid + 1;
+            else
+                hi = mid;
+        }
+        return lo + 1;
+    };
+    return {
+        lineAt
+    };
+}
+//# sourceMappingURL=line-lookup.js.map

package/dist/shared/helpers/line-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-lookup.js","sourceRoot":"","sources":["../../../src/shared/helpers/line-lookup.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,cAAc,GAAa,EAAE,CAAC;IACpC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACnD,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,EAAE;YAAE,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,KAAqB,EAAU,EAAE;QAC/C,IAAI,CAAC,KAAK,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACnC,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAG9D,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,IAAI,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC;QAC/B,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1B,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,YAAY;gBAAE,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;;gBAAK,EAAE,GAAG,GAAG,CAAC;QACrE,CAAC;QACD,OAAO,EAAE,GAAG,CAAC,CAAC;IAChB,CAAC,CAAC;IACF,OAAO;QACL,MAAM;KACP,CAAC;AACJ,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n\nexport type LineLookup = {\n  lineAt: (index?: number | null) => number;\n};\n\n/**\n * Cria uma função de consulta de linha (1-based) para um índice de string (0-based).\n * Otimiza casos com muitos `matchAll`/índices evitando `slice(0, i).split('\\n')`.\n */\nexport function createLineLookup(src: string): LineLookup {\n  const newlineIndexes: number[] = [];\n  for (let indice = 0; indice < src.length; indice++) {\n    if (src.charCodeAt(indice) === 10) newlineIndexes.push(indice);\n  }\n  const lineAt = (index?: number | null): number => {\n    if (!index || index <= 0) return 1;\n    const clampedIndex = Math.min(src.length, Math.max(0, index));\n\n    // upper_bound: quantidade de '\\n' com pos < i\n    let lo = 0;\n    let hi = newlineIndexes.length;\n    while (lo < hi) {\n      const mid = lo + hi >>> 1;\n      if (newlineIndexes[mid] < clampedIndex) lo = mid + 1;else hi = mid;\n    }\n    return lo + 1;\n  };\n  return {\n    lineAt\n  };\n}"]}

package/dist/shared/helpers/lines.d.ts

@@ -0,0 +1,2 @@
+export declare function splitLines(src: string): string[];
+//# sourceMappingURL=lines.d.ts.map

package/dist/shared/helpers/lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/lines.ts"],"names":[],"mappings":"AAKA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhD"}

package/dist/shared/helpers/lines.js

@@ -0,0 +1,4 @@
+export function splitLines(src) {
+    return src.split(/\r?\n/);
+}
+//# sourceMappingURL=lines.js.map

package/dist/shared/helpers/lines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lines.js","sourceRoot":"","sources":["../../../src/shared/helpers/lines.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\n\n/**\n * Divide o conteúdo de um arquivo em linhas de forma compatível com diferentes sistemas operacionais.\n */\nexport function splitLines(src: string): string[] {\n  return src.split(/\\r?\\n/);\n}\n"]}

package/dist/shared/helpers/magic-constants-whitelist.d.ts

@@ -0,0 +1,10 @@
+import type { MagicConstantRule } from '../../types/index.js';
+export type { MagicConstantRule };
+export declare const DISCORD_LIMITES: MagicConstantRule[];
+export declare const HTTP_STATUS_CODIGOS: MagicConstantRule[];
+export declare const COMUM_LIMITES: MagicConstantRule[];
+export declare const MATH_CONSTANTES: MagicConstantRule[];
+export declare const FRAMEWORK_WHITELISTS: Record<string, MagicConstantRule[]>;
+export declare function isWhitelistedConstant(value: number, frameworks: string[], userWhitelist?: number[]): boolean;
+export declare function getConstantDescription(value: number, frameworks: string[]): string | undefined;
+//# sourceMappingURL=magic-constants-whitelist.d.ts.map

package/dist/shared/helpers/magic-constants-whitelist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-constants-whitelist.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/magic-constants-whitelist.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,GAAG,CAAC;AAE3C,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAOlC,eAAO,MAAM,eAAe,EAAE,iBAAiB,EA2B7C,CAAC;AAKH,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EA8BjD,CAAC;AAKH,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAY3C,CAAC;AAKH,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAqB7C,CAAC;AAKH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAUpE,CAAC;AAKF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CA6B5G;AAKD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAK9F"}

package/dist/shared/helpers/magic-constants-whitelist.js

@@ -0,0 +1,132 @@
+export const DISCORD_LIMITES = [{
+        value: 10,
+        description: 'Máximo de fields em embed'
+    }, {
+        value: 25,
+        description: 'Máximo de opções em SelectMenu'
+    }, {
+        value: 90,
+        description: 'Máximo de caracteres em button label'
+    }, {
+        value: 100,
+        description: 'Máximo de caracteres em select option label'
+    }, {
+        value: 256,
+        description: 'Máximo de caracteres em embed field name'
+    }, {
+        value: 1024,
+        description: 'Máximo de caracteres em embed field value'
+    }, {
+        value: 2000,
+        description: 'Máximo de caracteres em mensagem'
+    }, {
+        value: 4000,
+        description: 'Máximo de caracteres em embed description'
+    }, {
+        value: 6000,
+        description: 'Máximo total de caracteres em embed'
+    }];
+export const HTTP_STATUS_CODIGOS = [{
+        value: 200,
+        description: 'HTTP OK'
+    }, {
+        value: 201,
+        description: 'HTTP Created'
+    }, {
+        value: 204,
+        description: 'HTTP No Content'
+    }, {
+        value: 400,
+        description: 'HTTP Bad Request'
+    }, {
+        value: 401,
+        description: 'HTTP Unauthorized'
+    }, {
+        value: 403,
+        description: 'HTTP Forbidden'
+    }, {
+        value: 404,
+        description: 'HTTP Not Found'
+    }, {
+        value: 500,
+        description: 'HTTP Internal Server Error'
+    }, {
+        value: 502,
+        description: 'HTTP Bad Gateway'
+    }, {
+        value: 503,
+        description: 'HTTP Service Unavailable'
+    }];
+export const COMUM_LIMITES = [{
+        value: 20,
+        description: 'Paginação padrão (20 items)'
+    }, {
+        value: 50,
+        description: 'Paginação média (50 items)'
+    }, {
+        value: 5000,
+        description: 'Limite comum de batch operations'
+    }, {
+        value: 10000,
+        description: 'Limite de query results'
+    }];
+export const MATH_CONSTANTES = [{
+        value: -1,
+        description: 'Index not found'
+    }, {
+        value: 0,
+        description: 'Zero/inicial'
+    }, {
+        value: 1,
+        description: 'Um/incremento'
+    }, {
+        value: 2,
+        description: 'Dois/par'
+    }, {
+        value: 10,
+        description: 'Base decimal'
+    }, {
+        value: 100,
+        description: 'Porcentagem'
+    }, {
+        value: 1000,
+        description: 'Milhar/conversão ms→s'
+    }];
+export const FRAMEWORK_WHITELISTS = {
+    'Discord.js': DISCORD_LIMITES,
+    Express: HTTP_STATUS_CODIGOS,
+    Fastify: HTTP_STATUS_CODIGOS,
+    'Next.js': HTTP_STATUS_CODIGOS,
+    React: [],
+    Vue: [],
+    Angular: [],
+    Stripe: [],
+    'AWS SDK': []
+};
+export function isWhitelistedConstant(value, frameworks, userWhitelist) {
+    if (userWhitelist && userWhitelist.includes(value)) {
+        return true;
+    }
+    if (MATH_CONSTANTES.some(rule => rule.value === value)) {
+        return true;
+    }
+    if (COMUM_LIMITES.some(rule => rule.value === value)) {
+        return true;
+    }
+    if (HTTP_STATUS_CODIGOS.some(rule => rule.value === value)) {
+        return true;
+    }
+    for (const framework of frameworks) {
+        const whitelist = FRAMEWORK_WHITELISTS[framework];
+        if (whitelist && whitelist.some(rule => rule.value === value)) {
+            return true;
+        }
+    }
+    return false;
+}
+export function getConstantDescription(value, frameworks) {
+    const allRules = [...MATH_CONSTANTES, ...COMUM_LIMITES, ...HTTP_STATUS_CODIGOS, ...frameworks.flatMap(arquivo => FRAMEWORK_WHITELISTS[arquivo] || [])];
+    const rule = allRules?.find(raiz => raiz.value === value);
+    return rule?.description;
+}
+//# sourceMappingURL=magic-constants-whitelist.js.map

package/dist/shared/helpers/magic-constants-whitelist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic-constants-whitelist.js","sourceRoot":"","sources":["../../../src/shared/helpers/magic-constants-whitelist.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n\n/**\n * Whitelist de magic constants conhecidos de frameworks populares.\n *\n * Esses valores são limitações documentadas de APIs externas e não devem\n * ser reportados como magic numbers, pois criar constantes para eles é verboso\n * e todos os desenvolvedores que usam essas APIs conhecem esses limites.\n */\n\nimport type { MagicConstantRule } from '@';\n\nexport type { MagicConstantRule };\n\n/**\n * Discord.js API limits (oficialmente documentados)\n * @see https://discord.com/developers/docs/resources/channel#embed-limits\n * @see https://discord.com/developers/docs/interactions/message-components#select-menus\n */\nexport const DISCORD_LIMITES: MagicConstantRule[] = [{\n  value: 10,\n  description: 'Máximo de fields em embed'\n}, {\n  value: 25,\n  description: 'Máximo de opções em SelectMenu'\n}, {\n  value: 90,\n  description: 'Máximo de caracteres em button label'\n}, {\n  value: 100,\n  description: 'Máximo de caracteres em select option label'\n}, {\n  value: 256,\n  description: 'Máximo de caracteres em embed field name'\n}, {\n  value: 1024,\n  description: 'Máximo de caracteres em embed field value'\n}, {\n  value: 2000,\n  description: 'Máximo de caracteres em mensagem'\n}, {\n  value: 4000,\n  description: 'Máximo de caracteres em embed description'\n}, {\n  value: 6000,\n  description: 'Máximo total de caracteres em embed'\n}];\n\n/**\n * HTTP Status Codes comuns\n */\nexport const HTTP_STATUS_CODIGOS: MagicConstantRule[] = [{\n  value: 200,\n  description: 'HTTP OK'\n}, {\n  value: 201,\n  description: 'HTTP Created'\n}, {\n  value: 204,\n  description: 'HTTP No Content'\n}, {\n  value: 400,\n  description: 'HTTP Bad Request'\n}, {\n  value: 401,\n  description: 'HTTP Unauthorized'\n}, {\n  value: 403,\n  description: 'HTTP Forbidden'\n}, {\n  value: 404,\n  description: 'HTTP Not Found'\n}, {\n  value: 500,\n  description: 'HTTP Internal Server Error'\n}, {\n  value: 502,\n  description: 'HTTP Bad Gateway'\n}, {\n  value: 503,\n  description: 'HTTP Service Unavailable'\n}];\n\n/**\n * Limites comuns de paginação e performance\n */\nexport const COMUM_LIMITES: MagicConstantRule[] = [{\n  value: 20,\n  description: 'Paginação padrão (20 items)'\n}, {\n  value: 50,\n  description: 'Paginação média (50 items)'\n}, {\n  value: 5000,\n  description: 'Limite comum de batch operations'\n}, {\n  value: 10000,\n  description: 'Limite de query results'\n}];\n\n/**\n * Valores matemáticos comuns (já cobertos no detector, mas listados para completude)\n */\nexport const MATH_CONSTANTES: MagicConstantRule[] = [{\n  value: -1,\n  description: 'Index not found'\n}, {\n  value: 0,\n  description: 'Zero/inicial'\n}, {\n  value: 1,\n  description: 'Um/incremento'\n}, {\n  value: 2,\n  description: 'Dois/par'\n}, {\n  value: 10,\n  description: 'Base decimal'\n}, {\n  value: 100,\n  description: 'Porcentagem'\n}, {\n  value: 1000,\n  description: 'Milhar/conversão ms→s'\n}];\n\n/**\n * Mapa de frameworks para suas whitelists\n */\nexport const FRAMEWORK_WHITELISTS: Record<string, MagicConstantRule[]> = {\n  'Discord.js': DISCORD_LIMITES,\n  Express: HTTP_STATUS_CODIGOS,\n  Fastify: HTTP_STATUS_CODIGOS,\n  'Next.js': HTTP_STATUS_CODIGOS,\n  React: [],\n  Vue: [],\n  Angular: [],\n  Stripe: [],\n  'AWS SDK': []\n};\n\n/**\n * Verifica se um valor numérico está na whitelist para os frameworks detectados\n */\nexport function isWhitelistedConstant(value: number, frameworks: string[], userWhitelist?: number[]): boolean {\n  // Verificar whitelist do usuário primeiro\n  if (userWhitelist && userWhitelist.includes(value)) {\n    return true;\n  }\n\n  // Verificar valores matemáticos comuns (sempre válidos)\n  if (MATH_CONSTANTES.some(rule => rule.value === value)) {\n    return true;\n  }\n\n  // Verificar limites comuns\n  if (COMUM_LIMITES.some(rule => rule.value === value)) {\n    return true;\n  }\n\n  // Verificar HTTP status codes (sempre válidos em projetos web)\n  if (HTTP_STATUS_CODIGOS.some(rule => rule.value === value)) {\n    return true;\n  }\n\n  // Verificar whitelists específicas de frameworks\n  for (const framework of frameworks) {\n    const whitelist = FRAMEWORK_WHITELISTS[framework];\n    if (whitelist && whitelist.some(rule => rule.value === value)) {\n      return true;\n    }\n  }\n  return false;\n}\n\n/**\n * Obtém a descrição de um magic constant, se estiver na whitelist\n */\nexport function getConstantDescription(value: number, frameworks: string[]): string | undefined {\n  // Verificar todas as whitelists\n  const allRules = [...MATH_CONSTANTES, ...COMUM_LIMITES, ...HTTP_STATUS_CODIGOS, ...frameworks.flatMap(arquivo => FRAMEWORK_WHITELISTS[arquivo] || [])];\n  const rule = allRules?.find(raiz => raiz.value === value);\n  return rule?.description;\n}"]}

package/dist/shared/helpers/masking.d.ts

@@ -0,0 +1,12 @@
+export declare function maskKeepingNewlines(src: string, start: number, end: number): string;
+export declare function maskJsComments(src: string): string;
+export declare function maskHtmlComments(src: string): string;
+export declare function maskTagBlocks(src: string, tag: 'script' | 'style'): string;
+export declare function maskXmlNonCode(src: string): string;
+export declare function maskPythonStringsAndComments(src: string): string;
+export declare function maskPythonComments(src: string): string;
+export declare function maskGoComments(src: string): string;
+export declare function maskRustComments(src: string): string;
+export declare function maskJavaComments(src: string): string;
+export declare function maskPhpComments(src: string): string;
+//# sourceMappingURL=masking.d.ts.map

package/dist/shared/helpers/masking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"masking.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/masking.ts"],"names":[],"mappings":"AAWA,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnF;AAQD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAelD;AAOD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQpD;AASD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAS1E;AAQD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAalD;AAQD,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAahE;AAOD,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQtD;AAOD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAalD;AAOD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAQD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAapD;AAQD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAanD"}

package/dist/shared/helpers/masking.js

@@ -0,0 +1,137 @@
+export function maskKeepingNewlines(src, start, end) {
+    const before = src.slice(0, start);
+    const mid = src.slice(start, end).replace(/[^\n]/g, ' ');
+    const after = src.slice(end);
+    return before + mid + after;
+}
+export function maskJsComments(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    for (const metrica of out.matchAll(/(?<![\\:])\/\/.*$/gm)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + (metrica[0]?.length ?? 0));
+    }
+    return out;
+}
+export function maskHtmlComments(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/<!--([\s\S]*?)-->/g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+export function maskTagBlocks(src, tag) {
+    let out = src;
+    const re = new RegExp(`<${tag}\\b[^>]*>[\\s\\S]*?<\\/${tag}>`, 'gi');
+    for (const metrica of out.matchAll(re)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+export function maskXmlNonCode(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/<!--[\s\S]*?-->/g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    for (const metrica of out.matchAll(/<!\[CDATA\[[\s\S]*?\]\]>/g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+export function maskPythonStringsAndComments(src) {
+    let out = maskPythonComments(src);
+    for (const metrica of out.matchAll(/([ruRUfFbB]{0,3})("""|''')[\s\S]*?\2/g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    for (const metrica of out.matchAll(/([ruRUfFbB]{0,3})("([^"\\\n]|\\.)*"|'([^'\\\n]|\\.)*')/g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+export function maskPythonComments(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/(^|[^\\])#.*$/gm)) {
+        const start = (metrica.index ?? -1) + (metrica[1] ? metrica[1].length : 0);
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + (metrica[0]?.length ?? 0) - (metrica[1] ? metrica[1].length : 0));
+    }
+    return out;
+}
+export function maskGoComments(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    for (const metrica of out.matchAll(/\/\/.*$/gm)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+export function maskRustComments(src) {
+    return maskGoComments(src);
+}
+export function maskJavaComments(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    for (const metrica of out.matchAll(/\/\/.*$/gm)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+export function maskPhpComments(src) {
+    let out = src;
+    for (const metrica of out.matchAll(/\/\*[\s\S]*?\*\//g)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    for (const metrica of out.matchAll(/(\/\/|#).*$/gm)) {
+        const start = metrica.index ?? -1;
+        if (start < 0)
+            continue;
+        out = maskKeepingNewlines(out, start, start + metrica[0].length);
+    }
+    return out;
+}
+//# sourceMappingURL=masking.js.map

package/dist/shared/helpers/masking.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"masking.js","sourceRoot":"","sources":["../../../src/shared/helpers/masking.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n// Utilitários de mascaramento que preservam quebras de linha para manter o cálculo de linhas estável.\n\n/**\n * Mascara uma região de texto substituindo caracteres por espaços,\n * preservando quebras de linha para manter a contagem de linhas estável.\n * @param src - Texto fonte\n * @param start - Índice de início da região a mascarar\n * @param end - Índice de fim da região a mascarar\n * @returns Texto com a região mascarada\n */\nexport function maskKeepingNewlines(src: string, start: number, end: number): string {\n  const before = src.slice(0, start);\n  const mid = src.slice(start, end).replace(/[^\\n]/g, ' ');\n  const after = src.slice(end);\n  return before + mid + after;\n}\n\n/**\n * Mascara comentários JavaScript/TypeScript (bloco e linha),\n * preservando quebras de linha.\n * @param src - Código fonte JS/TS\n * @returns Código com comentários mascarados\n */\nexport function maskJsComments(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/\\/\\*[\\s\\S]*?\\*\\//g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n\n  // Usa negative lookbehind para evitar match em URLs (://)\n  for (const metrica of out.matchAll(/(?<![\\\\:])\\/\\/.*$/gm)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + (metrica[0]?.length ?? 0));\n  }\n  return out;\n}\n\n/**\n * Mascara comentários HTML (`<!-- -->`), preservando quebras de linha.\n * @param src - Código fonte HTML\n * @returns Código com comentários HTML mascarados\n */\nexport function maskHtmlComments(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/<!--([\\s\\S]*?)-->/g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}\n\n/**\n * Mascara blocos de tags HTML (script ou style) inteiros,\n * preservando quebras de linha.\n * @param src - Código fonte HTML\n * @param tag - Tag a mascarar ('script' ou 'style')\n * @returns Código com os blocos da tag mascarados\n */\nexport function maskTagBlocks(src: string, tag: 'script' | 'style'): string {\n  let out = src;\n  const re = new RegExp(`<${tag}\\\\b[^>]*>[\\\\s\\\\S]*?<\\\\/${tag}>`, 'gi');\n  for (const metrica of out.matchAll(re)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}\n\n/**\n * Mascara conteúdo não-código em XML (comentários e seções CDATA),\n * preservando quebras de linha.\n * @param src - Código fonte XML\n * @returns Código com conteúdo não-código mascarado\n */\nexport function maskXmlNonCode(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/<!--[\\s\\S]*?-->/g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  for (const metrica of out.matchAll(/<!\\[CDATA\\[[\\s\\S]*?\\]\\]>/g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}\n\n/**\n * Mascara strings e comentários Python, preservando quebras de linha.\n * Trata strings triplas, strings simples e comentários com `#`.\n * @param src - Código fonte Python\n * @returns Código com strings e comentários mascarados\n */\nexport function maskPythonStringsAndComments(src: string): string {\n  let out = maskPythonComments(src);\n  for (const metrica of out.matchAll(/([ruRUfFbB]{0,3})(\"\"\"|''')[\\s\\S]*?\\2/g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  for (const metrica of out.matchAll(/([ruRUfFbB]{0,3})(\"([^\"\\\\\\n]|\\\\.)*\"|'([^'\\\\\\n]|\\\\.)*')/g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}\n\n/**\n * Mascara comentários Python (linhas com `#`), preservando quebras de linha.\n * @param src - Código fonte Python\n * @returns Código com comentários mascarados\n */\nexport function maskPythonComments(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/(^|[^\\\\])#.*$/gm)) {\n    const start = (metrica.index ?? -1) + (metrica[1] ? metrica[1].length : 0);\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + (metrica[0]?.length ?? 0) - (metrica[1] ? metrica[1].length : 0));\n  }\n  return out;\n}\n\n/**\n * Mascara comentários Go (linha e bloco), preservando quebras de linha.\n * @param src - Código fonte Go\n * @returns Código com comentários mascarados\n */\nexport function maskGoComments(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/\\/\\*[\\s\\S]*?\\*\\//g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  for (const metrica of out.matchAll(/\\/\\/.*$/gm)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}\n\n/**\n * Mascara comentários Rust (linha e bloco), preservando quebras de linha.\n * @param src - Código fonte Rust\n * @returns Código com comentários mascarados\n */\nexport function maskRustComments(src: string): string {\n  return maskGoComments(src);\n}\n\n/**\n * Mascara comentários (linha, bloco),\n * preservando quebras de linha.\n * @param src - Código fonte\n * @returns Código com comentários mascarados\n */\nexport function maskJavaComments(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/\\/\\*[\\s\\S]*?\\*\\//g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  for (const metrica of out.matchAll(/\\/\\/.*$/gm)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}\n\n/**\n * Mascara strings e comentários PHP, preservando quebras de linha.\n * Trata strings com aspas simples/duplas e comentarios de linha.\n * @param src - Código fonte PHP\n * @returns Código com strings e comentários mascarados\n */\nexport function maskPhpComments(src: string): string {\n  let out = src;\n  for (const metrica of out.matchAll(/\\/\\*[\\s\\S]*?\\*\\//g)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  for (const metrica of out.matchAll(/(\\/\\/|#).*$/gm)) {\n    const start = metrica.index ?? -1;\n    if (start < 0) continue;\n    out = maskKeepingNewlines(out, start, start + metrica[0].length);\n  }\n  return out;\n}"]}

package/dist/shared/helpers/occurrences.d.ts

@@ -0,0 +1,3 @@
+import { type Ocorrencia } from '../../types/index.js';
+export declare function criarErroAnalise(relPath: string, erro?: unknown): Ocorrencia;
+//# sourceMappingURL=occurrences.d.ts.map

package/dist/shared/helpers/occurrences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/occurrences.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,GAAG,CAAC;AAMrD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAQ5E"}

package/dist/shared/helpers/occurrences.js

@@ -0,0 +1,12 @@
+import { SharedCommonMensagens } from '../../core/messages/index.js';
+import { criarOcorrencia } from '../../types/index.js';
+export function criarErroAnalise(relPath, erro) {
+    return criarOcorrencia({
+        tipo: 'ERRO_ANALISE',
+        nivel: 'aviso',
+        mensagem: erro instanceof Error ? erro.message : SharedCommonMensagens.ocorrencias.erroAnalisar(''),
+        relPath,
+        linha: 1,
+    });
+}
+//# sourceMappingURL=occurrences.js.map

package/dist/shared/helpers/occurrences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrences.js","sourceRoot":"","sources":["../../../src/shared/helpers/occurrences.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,eAAe,EAAmB,MAAM,GAAG,CAAC;AAMrD,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,IAAc;IAC9D,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,cAAc;QACpB,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,IAAI,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,WAAW,CAAC,YAAY,CAAC,EAAE,CAAC;QACnG,OAAO;QACP,KAAK,EAAE,CAAC;KACT,CAAe,CAAC;AACnB,CAAC","sourcesContent":["// SPDX-License-Identifier: MIT\nimport { SharedCommonMensagens } from '@core/messages';\n\nimport { criarOcorrencia, type Ocorrencia } from '@';\n\n/**\n * Cria uma ocorrência de erro de análise padronizada.\n * Útil para capturar try/catch em detectores e analistas.\n */\nexport function criarErroAnalise(relPath: string, erro?: unknown): Ocorrencia {\n  return criarOcorrencia({\n    tipo: 'ERRO_ANALISE',\n    nivel: 'aviso',\n    mensagem: erro instanceof Error ? erro.message : SharedCommonMensagens.ocorrencias.erroAnalisar(''),\n    relPath,\n    linha: 1,\n  }) as Ocorrencia;\n}\n"]}

package/dist/shared/helpers/path.d.ts

@@ -0,0 +1,2 @@
+export declare function normalizePath(caminho: string, useNativeNormalize?: boolean): string;
+//# sourceMappingURL=path.d.ts.map

package/dist/shared/helpers/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/path.ts"],"names":[],"mappings":"AAMA,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,kBAAkB,UAAQ,GAAG,MAAM,CAGjF"}

package/dist/shared/helpers/path.js

@@ -0,0 +1,6 @@
+import path from 'node:path';
+export function normalizePath(caminho, useNativeNormalize = false) {
+    const normalized = useNativeNormalize ? path.normalize(caminho) : caminho;
+    return normalized.replace(/\\/g, '/');
+}
+//# sourceMappingURL=path.js.map

package/dist/shared/helpers/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../src/shared/helpers/path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,kBAAkB,GAAG,KAAK;IACvE,MAAM,UAAU,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAC1E,OAAO,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC","sourcesContent":["import path from 'node:path';\n\n/**\n * Normaliza caminhos de arquivo para usar barras (/) consistentemente.\n * Se useNativeNormalize for true, também aplica o path.normalize do Node antes da substituição de barras.\n */\nexport function normalizePath(caminho: string, useNativeNormalize = false): string {\n  const normalized = useNativeNormalize ? path.normalize(caminho) : caminho;\n  return normalized.replace(/\\\\/g, '/');\n}"]}

package/dist/shared/helpers/pool.d.ts

@@ -0,0 +1,10 @@
+export declare class ObjectPool<T> {
+    private free;
+    private factory;
+    private reset;
+    constructor(factory: () => T, reset: (obj: T) => void, initialSize?: number);
+    acquire(): T;
+    release(obj: T): void;
+    get size(): number;
+}
+//# sourceMappingURL=pool.d.ts.map

package/dist/shared/helpers/pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/pool.ts"],"names":[],"mappings":"AAKA,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAW;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAmB;gBAEpB,OAAO,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,WAAW,SAAM;IAMxE,OAAO,IAAI,CAAC;IAIZ,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI;IAKrB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/shared/helpers/pool.js

@@ -0,0 +1,22 @@
+export class ObjectPool {
+    free = [];
+    factory;
+    reset;
+    constructor(factory, reset, initialSize = 256) {
+        this.factory = factory;
+        this.reset = reset;
+        for (let i = 0; i < initialSize; i++)
+            this.free.push(factory());
+    }
+    acquire() {
+        return this.free?.pop() ?? this.factory();
+    }
+    release(obj) {
+        this.reset(obj);
+        this.free.push(obj);
+    }
+    get size() {
+        return this.free.length;
+    }
+}
+//# sourceMappingURL=pool.js.map

package/dist/shared/helpers/pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pool.js","sourceRoot":"","sources":["../../../src/shared/helpers/pool.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,UAAU;IACb,IAAI,GAAQ,EAAE,CAAC;IACf,OAAO,CAAU;IACjB,KAAK,CAAmB;IAEhC,YAAY,OAAgB,EAAE,KAAuB,EAAE,WAAW,GAAG,GAAG;QACtE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,EAAE,CAAC,EAAE;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;IAED,OAAO,CAAC,GAAM;QACZ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;CACF","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * @fileoverview Object pool genérico para reutilização de objetos e redução de alocações\n */\n\nexport class ObjectPool<T> {\n  private free: T[] = [];\n  private factory: () => T;\n  private reset: (obj: T) => void;\n\n  constructor(factory: () => T, reset: (obj: T) => void, initialSize = 256) {\n    this.factory = factory;\n    this.reset = reset;\n    for (let i = 0; i < initialSize; i++) this.free.push(factory());\n  }\n\n  acquire(): T {\n    return this.free?.pop() ?? this.factory();\n  }\n\n  release(obj: T): void {\n    this.reset(obj);\n    this.free.push(obj);\n  }\n\n  get size(): number {\n    return this.free.length;\n  }\n}\n"]}

package/dist/shared/helpers/reader-report.d.ts

@@ -0,0 +1,21 @@
+import type { LeitorRelatorioOptions } from '../../types/index.js';
+export type { LeitorRelatorioOptions };
+export declare function lerRelatorioVersionado<T = unknown>(options: LeitorRelatorioOptions): Promise<{
+    sucesso: boolean;
+    dados?: T;
+    schema?: Record<string, unknown>;
+    erro?: string;
+    migrado?: boolean;
+}>;
+export declare function lerDadosRelatorio<T = unknown>(caminho: string): Promise<{
+    sucesso: boolean;
+    dados?: T;
+    erro?: string;
+}>;
+export declare function verificarSchemaRelatorio(caminho: string): Promise<{
+    valido: boolean;
+    versao?: string;
+    erros?: string[];
+    erro?: string;
+}>;
+//# sourceMappingURL=reader-report.d.ts.map

package/dist/shared/helpers/reader-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader-report.d.ts","sourceRoot":"","sources":["../../../src/shared/helpers/reader-report.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,GAAG,CAAC;AAGhD,YAAY,EAAE,sBAAsB,EAAE,CAAC;AAWvC,wBAAsB,sBAAsB,CAAC,CAAC,GAAG,OAAO,EACtD,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC,CAyED;AAKD,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EACjD,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAaD;AAMD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CA0BD"}

package/dist/shared/helpers/reader-report.js

@@ -0,0 +1,97 @@
+import { migrarParaVersaoAtual, validarSchema } from '../../core/schema/index.js';
+import { lerEstado } from '../persistence/index.js';
+export async function lerRelatorioVersionado(options) {
+    const { caminho, validar = true, migrar = false } = options;
+    try {
+        const conteudo = await lerEstado(caminho);
+        if (!conteudo) {
+            return {
+                sucesso: false,
+                erro: 'Arquivo não encontrado ou vazio',
+            };
+        }
+        let relatorioFinal = conteudo;
+        let migrado = false;
+        if (validar) {
+            const validacao = validarSchema(conteudo);
+            if (!validacao.valido) {
+                return {
+                    sucesso: false,
+                    erro: `Schema inválido: ${validacao.erros.join(', ')}`,
+                };
+            }
+        }
+        if (!conteudo._schema || !conteudo.dados) {
+            if (migrar) {
+                relatorioFinal = migrarParaVersaoAtual(conteudo);
+                migrado = true;
+            }
+            else if (!validar) {
+                relatorioFinal = conteudo;
+                migrado = false;
+            }
+            else {
+                return {
+                    sucesso: false,
+                    erro: 'Relatório em formato antigo (sem _schema); habilite migrar para atualizá-lo explicitamente.',
+                };
+            }
+        }
+        let dados;
+        const relObj = relatorioFinal;
+        if ('_schema' in relObj && relObj._schema) {
+            dados = relObj.dados;
+        }
+        else {
+            dados = relatorioFinal;
+        }
+        return {
+            sucesso: true,
+            dados,
+            schema: relObj._schema || undefined,
+            migrado,
+        };
+    }
+    catch (error) {
+        return {
+            sucesso: false,
+            erro: `Erro ao ler relatório: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+export async function lerDadosRelatorio(caminho) {
+    const resultado = await lerRelatorioVersionado({
+        caminho,
+        validar: false,
+        migrar: true,
+    });
+    return {
+        sucesso: resultado.sucesso,
+        dados: resultado.dados,
+        erro: resultado.erro,
+    };
+}
+export async function verificarSchemaRelatorio(caminho) {
+    try {
+        const conteudo = await lerEstado(caminho);
+        if (!conteudo) {
+            return {
+                valido: false,
+                erros: ['Arquivo não encontrado ou vazio'],
+            };
+        }
+        const validacao = validarSchema(conteudo);
+        return {
+            valido: validacao.valido,
+            versao: conteudo._schema?.versao,
+            erros: validacao.erros,
+        };
+    }
+    catch (error) {
+        return {
+            valido: false,
+            erro: `Erro ao verificar schema: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
+//# sourceMappingURL=reader-report.js.map

package/dist/shared/helpers/reader-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader-report.js","sourceRoot":"","sources":["../../../src/shared/helpers/reader-report.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: MIT\n/**\n * Utilitários para trabalhar com relatórios JSON versionados\n */\n\nimport { migrarParaVersaoAtual, validarSchema } from '@core/schema';\nimport { lerEstado } from '@shared/persistence';\n\nimport type { LeitorRelatorioOptions } from '@';\n\n// Re-exporta o tipo para compatibilidade\nexport type { LeitorRelatorioOptions };\n\ntype RelatorioGenerico = Record<string, unknown>;\ntype RelatorioVersionado<T = unknown> = RelatorioGenerico & {\n  _schema?: Record<string, unknown>;\n  dados?: T;\n};\n\n/**\n * Lê um relatório JSON versionado do disco\n */\nexport async function lerRelatorioVersionado<T = unknown>(\n  options: LeitorRelatorioOptions,\n): Promise<{\n  sucesso: boolean;\n  dados?: T;\n  schema?: Record<string, unknown>;\n  erro?: string;\n  migrado?: boolean;\n}> {\n  const { caminho, validar = true, migrar = false } = options;\n\n  try {\n    // Ler arquivo\n    const conteudo = await lerEstado<Record<string, unknown>>(caminho);\n\n    if (!conteudo) {\n      return {\n        sucesso: false,\n        erro: 'Arquivo não encontrado ou vazio',\n      };\n    }\n\n    let relatorioFinal = conteudo;\n    let migrado = false;\n\n    // Validar schema se solicitado\n    if (validar) {\n      const validacao = validarSchema(conteudo);\n      if (!validacao.valido) {\n        return {\n          sucesso: false,\n          erro: `Schema inválido: ${validacao.erros.join(', ')}`,\n        };\n      }\n    }\n\n    // Migrar se necessário e solicitado.\n    // - Se migrar=true: migramos explicitamente.\n    // - Se migrar=false e validar=false: aceitamos o conteúdo legado como está (modo permissivo).\n    // - Se migrar=false e validar=true: rejeitamos (chamador pediu validação estrita).\n    if (!conteudo._schema || !conteudo.dados) {\n      if (migrar) {\n        relatorioFinal = migrarParaVersaoAtual<unknown>(\n          conteudo,\n        ) as unknown as Record<string, unknown>;\n        migrado = true;\n      } else if (!validar) {\n        // modo permissivo: aceitar o conteúdo legado sem migrar\n        relatorioFinal = conteudo;\n        migrado = false;\n      } else {\n        return {\n          sucesso: false,\n          erro: 'Relatório em formato antigo (sem _schema); habilite migrar para atualizá-lo explicitamente.',\n        };\n      }\n    }\n\n    // Extrair dados: se for relatório versionado, retornamos apenas `dados`.\n    // Se for formato legado (sem _schema), retornamos o objeto inteiro.\n    let dados: T;\n    const relObj = relatorioFinal as RelatorioVersionado<T>;\n\n    if ('_schema' in relObj && relObj._schema) {\n      dados = relObj.dados as T;\n    } else {\n      dados = relatorioFinal as T;\n    }\n\n    return {\n      sucesso: true,\n      dados,\n      schema: (relObj._schema as Record<string, unknown>) || undefined,\n      migrado,\n    };\n  } catch (error) {\n    return {\n      sucesso: false,\n      erro: `Erro ao ler relatório: ${error instanceof Error ? error.message : String(error)}`,\n    };\n  }\n}\n\n/**\n * Lê apenas os dados de um relatório, ignorando metadados de versão\n */\nexport async function lerDadosRelatorio<T = unknown>(\n  caminho: string,\n): Promise<{\n  sucesso: boolean;\n  dados?: T;\n  erro?: string;\n}> {\n  // Para obtenção superficial de dados, permitimos migração automática aqui\n  const resultado = await lerRelatorioVersionado<T>({\n    caminho,\n    validar: false,\n    migrar: true,\n  });\n\n  return {\n    sucesso: resultado.sucesso,\n    dados: resultado.dados,\n    erro: resultado.erro,\n  };\n}\n\n/**\n * Verifica se um relatório tem schema válido\n */\n\nexport async function verificarSchemaRelatorio(caminho: string): Promise<{\n  valido: boolean;\n  versao?: string;\n  erros?: string[];\n  erro?: string;\n}> {\n  try {\n    const conteudo = await lerEstado<Record<string, unknown>>(caminho);\n\n    if (!conteudo) {\n      return {\n        valido: false,\n        erros: ['Arquivo não encontrado ou vazio'],\n      };\n    }\n\n    const validacao = validarSchema(conteudo);\n\n    return {\n      valido: validacao.valido,\n      versao: (conteudo._schema as Record<string, unknown>)?.versao as\n        | string\n        | undefined,\n      erros: validacao.erros,\n    };\n  } catch (error) {\n    return {\n      valido: false,\n      erro: `Erro ao verificar schema: ${error instanceof Error ? error.message : String(error)}`,\n    };\n  }\n}\n"]}