@semacode/cli 1.3.6 → 1.4.0

package/node_modules/@sema/nucleo/dist/persistencia/contratos.js

@@ -0,0 +1,294 @@
+export const ENGINES_BANCO_SUPORTADOS = new Set([
+    "postgres",
+    "mysql",
+    "sqlite",
+    "mongodb",
+    "redis",
+]);
+export const TIPOS_RECURSO_PERSISTENCIA = new Set([
+    "table",
+    "view",
+    "query",
+    "transaction",
+    "index",
+    "constraint",
+    "relationship",
+    "collection",
+    "document",
+    "keyspace",
+    "stream",
+    "lock",
+    "retention",
+    "replication",
+]);
+export const CAMPOS_DATABASE_SUPORTADOS = new Set([
+    "engine",
+    "schema",
+    "database",
+    "consistency",
+    "durability",
+    "transaction_model",
+    "query_model",
+    "portavel",
+    "adapter",
+    "perfil",
+    "compatibilidade",
+]);
+export const CAMPOS_RECURSO_PERSISTENCIA_SUPORTADOS = new Set([
+    "entity",
+    "consistency",
+    "durability",
+    "transaction_model",
+    "query_model",
+    "portavel",
+    "mode",
+    "isolation",
+    "strategy",
+    "ttl",
+    "retention",
+    "path",
+    "from",
+    "to",
+    "surface",
+    "adapter",
+    "resource_kind",
+    "collection",
+    "table",
+    "compatibilidade",
+]);
+const CONSISTENCIAS_SUPORTADAS = new Set([
+    "eventual",
+    "forte",
+    "serializable",
+    "snapshot",
+    "causal",
+]);
+const DURABILIDADES_SUPORTADAS = new Set([
+    "baixa",
+    "media",
+    "alta",
+]);
+const MODELOS_TRANSACAO_SUPORTADOS = new Set([
+    "mvcc",
+    "bloqueio",
+    "documento",
+    "otimista",
+    "single_thread",
+]);
+const MODELOS_CONSULTA_SUPORTADOS = new Set([
+    "sql",
+    "documento",
+    "chave_valor",
+    "pipeline",
+    "stream",
+]);
+export function valorCampoCompletoPersistencia(campo) {
+    if (!campo) {
+        return undefined;
+    }
+    return [campo.valor, ...campo.modificadores].join(" ").trim() || undefined;
+}
+export function localizarCampoPersistencia(bloco, ...nomes) {
+    return bloco?.campos.find((campo) => nomes.includes(campo.nome));
+}
+export function parsearBooleanoPersistencia(valor) {
+    if (!valor) {
+        return undefined;
+    }
+    const normalizado = valor.toLowerCase();
+    if (normalizado === "verdadeiro" || normalizado === "true") {
+        return true;
+    }
+    if (normalizado === "falso" || normalizado === "false") {
+        return false;
+    }
+    return undefined;
+}
+export function normalizarEngineBanco(valor) {
+    switch ((valor ?? "").toLowerCase()) {
+        case "postgres":
+        case "postgresql":
+            return "postgres";
+        case "mysql":
+            return "mysql";
+        case "sqlite":
+        case "sqlite3":
+            return "sqlite";
+        case "mongo":
+        case "mongodb":
+            return "mongodb";
+        case "redis":
+            return "redis";
+        default:
+            return undefined;
+    }
+}
+export function normalizarConsistenciaPersistencia(valor) {
+    if (!valor) {
+        return undefined;
+    }
+    const normalizado = valor.toLowerCase();
+    return CONSISTENCIAS_SUPORTADAS.has(normalizado) ? normalizado : undefined;
+}
+export function normalizarDurabilidadePersistencia(valor) {
+    if (!valor) {
+        return undefined;
+    }
+    const normalizado = valor.toLowerCase();
+    return DURABILIDADES_SUPORTADAS.has(normalizado) ? normalizado : undefined;
+}
+export function normalizarModeloTransacaoPersistencia(valor) {
+    if (!valor) {
+        return undefined;
+    }
+    const normalizado = valor.toLowerCase();
+    return MODELOS_TRANSACAO_SUPORTADOS.has(normalizado) ? normalizado : undefined;
+}
+export function normalizarModeloConsultaPersistencia(valor) {
+    if (!valor) {
+        return undefined;
+    }
+    const normalizado = valor.toLowerCase();
+    return MODELOS_CONSULTA_SUPORTADOS.has(normalizado) ? normalizado : undefined;
+}
+export function nomeTipoRecursoPersistencia(bloco) {
+    const candidato = (bloco.palavraChave === "desconhecido"
+        ? bloco.nome
+        : bloco.palavraChave)?.toLowerCase();
+    if (!candidato) {
+        return undefined;
+    }
+    return TIPOS_RECURSO_PERSISTENCIA.has(candidato)
+        ? candidato
+        : undefined;
+}
+export function listarRecursosPersistencia(bloco) {
+    if (!bloco) {
+        return [];
+    }
+    return bloco.blocos.filter((item) => item.tipo === "bloco_generico" && Boolean(nomeTipoRecursoPersistencia(item)));
+}
+function compatibilidadeBasica(engine, status, motivo) {
+    return { engine, status, motivo };
+}
+function classificarCompatibilidadePorTipo(tipo, engine) {
+    switch (tipo) {
+        case "table":
+        case "view":
+            if (engine === "postgres" || engine === "mysql" || engine === "sqlite") {
+                return compatibilidadeBasica(engine, "nativo", `${tipo} e nativo em motores relacionais.`);
+            }
+            return compatibilidadeBasica(engine, "invalido", `${tipo} nao existe como primitivo em ${engine}.`);
+        case "query":
+            if (engine === "postgres" || engine === "mysql" || engine === "sqlite" || engine === "mongodb") {
+                return compatibilidadeBasica(engine, "nativo", `query e suportado de forma nativa em ${engine}.`);
+            }
+            return compatibilidadeBasica(engine, "parcial", "Redis consulta dados, mas a expressividade depende da estrutura escolhida.");
+        case "transaction":
+            if (engine === "postgres" || engine === "mysql" || engine === "sqlite") {
+                return compatibilidadeBasica(engine, "nativo", "Transacao ACID e parte do contrato principal do engine.");
+            }
+            if (engine === "mongodb") {
+                return compatibilidadeBasica(engine, "parcial", "MongoDB suporta transacoes, mas com restricoes operacionais e de topologia.");
+            }
+            return compatibilidadeBasica(engine, "invalido", "Redis nao oferece transacao de banco relacional como primitivo equivalente.");
+        case "index":
+            if (engine === "postgres" || engine === "mysql" || engine === "sqlite" || engine === "mongodb") {
+                return compatibilidadeBasica(engine, "nativo", "Indexacao e um recurso nativo do engine.");
+            }
+            return compatibilidadeBasica(engine, "parcial", "Redis indexa via modulos/estrategias especificas, nao como indice generico universal.");
+        case "constraint":
+            if (engine === "postgres" || engine === "mysql") {
+                return compatibilidadeBasica(engine, "nativo", "Constraints fazem parte do contrato relacional do engine.");
+            }
+            if (engine === "sqlite") {
+                return compatibilidadeBasica(engine, "parcial", "SQLite suporta constraints, mas com escopo e enforcement mais limitados.");
+            }
+            return compatibilidadeBasica(engine, "invalido", `Constraint relacional nao e nativo em ${engine}.`);
+        case "relationship":
+            if (engine === "postgres" || engine === "mysql" || engine === "sqlite") {
+                return compatibilidadeBasica(engine, "nativo", "Relacionamentos por chave e join sao nativos em motores relacionais.");
+            }
+            if (engine === "mongodb") {
+                return compatibilidadeBasica(engine, "adaptado", "MongoDB modela relacionamento por referencia ou embutimento.");
+            }
+            return compatibilidadeBasica(engine, "invalido", "Redis nao modela relacionamento com garantias relacionais nativas.");
+        case "collection":
+            return engine === "mongodb"
+                ? compatibilidadeBasica(engine, "nativo", "Collection e o recurso estrutural principal do MongoDB.")
+                : compatibilidadeBasica(engine, "invalido", `Collection nao e recurso estrutural nativo de ${engine}.`);
+        case "document":
+            if (engine === "mongodb") {
+                return compatibilidadeBasica(engine, "nativo", "Documentos sao o recurso central do MongoDB.");
+            }
+            if (engine === "postgres" || engine === "mysql" || engine === "sqlite") {
+                return compatibilidadeBasica(engine, "adaptado", "Documentos podem ser modelados sobre JSON ou blobs estruturados.");
+            }
+            return compatibilidadeBasica(engine, "parcial", "Redis suporta documentos por modulos, mas nao como baseline universal.");
+        case "keyspace":
+            return engine === "redis"
+                ? compatibilidadeBasica(engine, "nativo", "Keyspace e o modelo estrutural primario do Redis.")
+                : compatibilidadeBasica(engine, "invalido", `Keyspace nao e primitivo nativo em ${engine}.`);
+        case "stream":
+            if (engine === "redis") {
+                return compatibilidadeBasica(engine, "nativo", "Streams sao nativos em Redis.");
+            }
+            if (engine === "postgres" || engine === "mysql") {
+                return compatibilidadeBasica(engine, "adaptado", "Stream exige adaptacao sobre log, outbox ou fila auxiliar.");
+            }
+            if (engine === "mongodb") {
+                return compatibilidadeBasica(engine, "parcial", "MongoDB oferece change streams, mas nao um stream geral identico.");
+            }
+            return compatibilidadeBasica(engine, "invalido", "SQLite nao oferece stream nativo comparavel.");
+        case "lock":
+            if (engine === "postgres" || engine === "mysql") {
+                return compatibilidadeBasica(engine, "nativo", "Locks e concorrencia controlada sao nativos do engine.");
+            }
+            if (engine === "sqlite" || engine === "mongodb") {
+                return compatibilidadeBasica(engine, "parcial", "O engine controla concorrencia, mas com semantica diferente de lock explicito relacional.");
+            }
+            return compatibilidadeBasica(engine, "adaptado", "Redis consegue coordenar lock, mas por convencao e nao por contrato relacional.");
+        case "retention":
+            if (engine === "redis" || engine === "mongodb") {
+                return compatibilidadeBasica(engine, "nativo", "Retencao/TTL faz parte do repertorio nativo do engine.");
+            }
+            return compatibilidadeBasica(engine, "adaptado", "Retencao exige politica auxiliar, cleanup agendado ou particionamento.");
+        case "replication":
+            if (engine === "sqlite") {
+                return compatibilidadeBasica(engine, "invalido", "SQLite nao trata replicacao como capacidade nativa principal.");
+            }
+            return compatibilidadeBasica(engine, "nativo", "Replicacao e tratada como capacidade oficial do engine ou da plataforma gerenciada.");
+        default:
+            return compatibilidadeBasica(engine, "invalido", `Recurso ${tipo} ainda nao foi classificado para ${engine}.`);
+    }
+}
+export function classificarCompatibilidadePersistencia(tipo, engine, opcoes = {}) {
+    const compatibilidade = classificarCompatibilidadePorTipo(tipo, engine);
+    if (tipo === "query") {
+        const modo = normalizarModeloConsultaPersistencia(opcoes.mode);
+        if (modo === "sql" && (engine === "mongodb" || engine === "redis")) {
+            return compatibilidadeBasica(engine, "invalido", `Query em modo sql nao e nativo em ${engine}.`);
+        }
+        if (modo === "documento" && (engine === "postgres" || engine === "mysql" || engine === "sqlite")) {
+            return compatibilidadeBasica(engine, "adaptado", `Query documental em ${engine} depende de JSON e adaptacao do runtime.`);
+        }
+        if (modo === "pipeline" && engine !== "mongodb") {
+            return compatibilidadeBasica(engine, engine === "redis" ? "parcial" : "invalido", `Pipeline foi pedido, mas ${engine} nao tem pipeline documental nativo equivalente ao MongoDB.`);
+        }
+        if (modo === "stream" && engine !== "redis") {
+            return compatibilidadeBasica(engine, compatibilidade.status === "nativo" ? "adaptado" : compatibilidade.status, `Query orientada a stream em ${engine} exige adaptacao fora do baseline do engine.`);
+        }
+    }
+    if (tipo === "transaction" && opcoes.isolation && (engine === "mongodb" || engine === "redis")) {
+        return compatibilidadeBasica(engine, "invalido", `Transaction com isolation explicita nao e suportada de forma equivalente em ${engine}.`);
+    }
+    return compatibilidade;
+}
+export function matrizCompatibilidadePersistencia(tipo, opcoes = {}) {
+    return [...ENGINES_BANCO_SUPORTADOS].map((engine) => classificarCompatibilidadePersistencia(tipo, engine, opcoes));
+}
+export function recursoPersistenciaPodeSerPortavel(tipo, opcoes = {}) {
+    return matrizCompatibilidadePersistencia(tipo, opcoes)
+        .every((item) => item.status === "nativo" || item.status === "adaptado");
+}
+//# sourceMappingURL=contratos.js.map

package/node_modules/@sema/nucleo/dist/persistencia/contratos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contratos.js","sourceRoot":"","sources":["../../src/persistencia/contratos.ts"],"names":[],"mappings":"AA8BA,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAAc;IAC3D,UAAU;IACV,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAA0B;IACzE,OAAO;IACP,MAAM;IACN,OAAO;IACP,aAAa;IACb,OAAO;IACP,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,UAAU;IACV,UAAU;IACV,QAAQ;IACR,MAAM;IACN,WAAW;IACX,aAAa;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,GAAG,CAAC;IAChD,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,aAAa;IACb,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,UAAU;IACV,SAAS;IACT,QAAQ;IACR,iBAAiB;CAClB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,sCAAsC,GAAG,IAAI,GAAG,CAAC;IAC5D,QAAQ;IACR,aAAa;IACb,YAAY;IACZ,mBAAmB;IACnB,aAAa;IACb,UAAU;IACV,MAAM;IACN,WAAW;IACX,UAAU;IACV,KAAK;IACL,WAAW;IACX,MAAM;IACN,MAAM;IACN,IAAI;IACJ,SAAS;IACT,SAAS;IACT,eAAe;IACf,YAAY;IACZ,OAAO;IACP,iBAAiB;CAClB,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAA2B;IACjE,UAAU;IACV,OAAO;IACP,cAAc;IACd,UAAU;IACV,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,IAAI,GAAG,CAA2B;IACjE,OAAO;IACP,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAA8B;IACxE,MAAM;IACN,UAAU;IACV,WAAW;IACX,UAAU;IACV,eAAe;CAChB,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAA6B;IACtE,KAAK;IACL,WAAW;IACX,aAAa;IACb,UAAU;IACV,QAAQ;CACT,CAAC,CAAC;AAEH,MAAM,UAAU,8BAA8B,CAAC,KAAgB;IAC7D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAmC,EAAE,GAAG,KAAe;IAChG,OAAO,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,WAAW,KAAK,YAAY,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;QAC3D,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QACvD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QACpC,KAAK,UAAU,CAAC;QAChB,KAAK,YAAY;YACf,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,QAAQ,CAAC;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC;QACnB,KAAK,OAAO;YACV,OAAO,OAAO,CAAC;QACjB;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAA8B,CAAC;IACpE,OAAO,wBAAwB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAA8B,CAAC;IACpE,OAAO,wBAAwB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,qCAAqC,CAAC,KAAc;IAClE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAiC,CAAC;IACvE,OAAO,4BAA4B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,oCAAoC,CAAC,KAAc;IACjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAgC,CAAC;IACtE,OAAO,2BAA2B,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAuB;IACjE,MAAM,SAAS,GAAG,CAChB,KAAK,CAAC,YAAY,KAAK,cAAc;QACnC,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,KAAK,CAAC,YAAY,CACvB,EAAE,WAAW,EAAE,CAAC;IAEjB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,0BAA0B,CAAC,GAAG,CAAC,SAAoC,CAAC;QACzE,CAAC,CAAC,SAAoC;QACtC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAmC;IAC5E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAA4B,EAAE,CAC5D,IAAI,CAAC,IAAI,KAAK,gBAAgB,IAAI,OAAO,CAAC,2BAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAmB,EACnB,MAAyC,EACzC,MAAc;IAEd,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,iCAAiC,CACxC,IAA6B,EAC7B,MAAmB;IAEnB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvE,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,mCAAmC,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,iCAAiC,MAAM,GAAG,CAAC,CAAC;QACtG,KAAK,OAAO;YACV,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/F,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,wCAAwC,MAAM,GAAG,CAAC,CAAC;YACpG,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,4EAA4E,CAAC,CAAC;QAChI,KAAK,aAAa;YAChB,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvE,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,yDAAyD,CAAC,CAAC;YAC5G,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,6EAA6E,CAAC,CAAC;YACjI,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,6EAA6E,CAAC,CAAC;QAClI,KAAK,OAAO;YACV,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/F,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,0CAA0C,CAAC,CAAC;YAC7F,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,uFAAuF,CAAC,CAAC;QAC3I,KAAK,YAAY;YACf,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAChD,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,2DAA2D,CAAC,CAAC;YAC9G,CAAC;YACD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,0EAA0E,CAAC,CAAC;YAC9H,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,yCAAyC,MAAM,GAAG,CAAC,CAAC;QACvG,KAAK,cAAc;YACjB,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvE,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,sEAAsE,CAAC,CAAC;YACzH,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,8DAA8D,CAAC,CAAC;YACnH,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,oEAAoE,CAAC,CAAC;QACzH,KAAK,YAAY;YACf,OAAO,MAAM,KAAK,SAAS;gBACzB,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,yDAAyD,CAAC;gBACpG,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,iDAAiD,MAAM,GAAG,CAAC,CAAC;QAC5G,KAAK,UAAU;YACb,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,8CAA8C,CAAC,CAAC;YACjG,CAAC;YACD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvE,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,kEAAkE,CAAC,CAAC;YACvH,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,wEAAwE,CAAC,CAAC;QAC5H,KAAK,UAAU;YACb,OAAO,MAAM,KAAK,OAAO;gBACvB,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,mDAAmD,CAAC;gBAC9F,CAAC,CAAC,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,sCAAsC,MAAM,GAAG,CAAC,CAAC;QACjG,KAAK,QAAQ;YACX,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,+BAA+B,CAAC,CAAC;YAClF,CAAC;YACD,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAChD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,4DAA4D,CAAC,CAAC;YACjH,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,mEAAmE,CAAC,CAAC;YACvH,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,8CAA8C,CAAC,CAAC;QACnG,KAAK,MAAM;YACT,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBAChD,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,wDAAwD,CAAC,CAAC;YAC3G,CAAC;YACD,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAChD,OAAO,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,2FAA2F,CAAC,CAAC;YAC/I,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,iFAAiF,CAAC,CAAC;QACtI,KAAK,WAAW;YACd,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC/C,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,wDAAwD,CAAC,CAAC;YAC3G,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,wEAAwE,CAAC,CAAC;QAC7H,KAAK,aAAa;YAChB,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACxB,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,+DAA+D,CAAC,CAAC;YACpH,CAAC;YACD,OAAO,qBAAqB,CAAC,MAAM,EAAE,QAAQ,EAAE,qFAAqF,CAAC,CAAC;QACxI;YACE,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,IAAI,oCAAoC,MAAM,GAAG,CAAC,CAAC;IACnH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sCAAsC,CACpD,IAA6B,EAC7B,MAAmB,EACnB,SAGI,EAAE;IAEN,MAAM,eAAe,GAAG,iCAAiC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAExE,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,oCAAoC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC;YACnE,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,qCAAqC,MAAM,GAAG,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,IAAI,KAAK,WAAW,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,QAAQ,CAAC,EAAE,CAAC;YACjG,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,uBAAuB,MAAM,0CAA0C,CAAC,CAAC;QAC5H,CAAC;QACD,IAAI,IAAI,KAAK,UAAU,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO,qBAAqB,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,4BAA4B,MAAM,6DAA6D,CAAC,CAAC;QACrL,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YAC5C,OAAO,qBAAqB,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,+BAA+B,MAAM,8CAA8C,CAAC,CAAC;QACvM,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,aAAa,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,OAAO,CAAC,EAAE,CAAC;QAC/F,OAAO,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,+EAA+E,MAAM,GAAG,CAAC,CAAC;IAC7I,CAAC;IAED,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,IAA6B,EAC7B,SAGI,EAAE;IAEN,OAAO,CAAC,GAAG,wBAAwB,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,sCAAsC,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,IAA6B,EAC7B,SAGI,EAAE;IAEN,OAAO,iCAAiC,CAAC,IAAI,EAAE,MAAM,CAAC;SACnD,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;AAC7E,CAAC"}

package/node_modules/@sema/nucleo/dist/semantico/analisador.d.ts

@@ -2,7 +2,7 @@ import { type Diagnostico } from "../diagnosticos/index.js";
 import type { ModuloAst } from "../ast/tipos.js";
 export interface SimboloSemantico {
     nome: string;
-    categoria: "tipo" | "entity" | "enum" | "task" | "flow" | "route" | "state" | "worker" | "evento" | "fila" | "cron" | "webhook" | "cache" | "storage" | "policy";
+    categoria: "tipo" | "entity" | "enum" | "task" | "flow" | "route" | "state" | "worker" | "evento" | "fila" | "cron" | "webhook" | "cache" | "storage" | "policy" | "database";
 }
 export interface CampoSemantico {
     nome: string;

package/node_modules/@sema/nucleo/dist/semantico/analisador.js

@@ -1,4 +1,5 @@
 import { criarDiagnostico } from "../diagnosticos/index.js";
+import { CAMPOS_DATABASE_SUPORTADOS, CAMPOS_RECURSO_PERSISTENCIA_SUPORTADOS, classificarCompatibilidadePersistencia, nomeTipoRecursoPersistencia, normalizarConsistenciaPersistencia, normalizarDurabilidadePersistencia, normalizarEngineBanco, normalizarModeloConsultaPersistencia, normalizarModeloTransacaoPersistencia, parsearBooleanoPersistencia, recursoPersistenciaPodeSerPortavel, } from "../persistencia/contratos.js";
 import { ehCategoriaEfeitoSemantico, ehCriticidadeEfeitoSemantico, extrairReferenciasDaExpressao, parsearEfeitoSemantico, parsearEtapaFlow, parsearExpressaoSemantica, parsearTransicaoEstado, } from "./estruturas.js";
 import { CLASSIFICACOES_DADO_SUPORTADAS, MODOS_AUTH_SUPORTADOS, MOTIVOS_AUDIT_SUPORTADOS, ORIGENS_AUTH_SUPORTADAS, PRINCIPAIS_AUTH_SUPORTADOS, REDACOES_LOG_SUPORTADAS, TENANTS_AUTHZ_SUPORTADOS, contratoDadosTemSegredoOuCredencial, contratoDadosTemSensivel, extrairContratoAudit, extrairContratoAuth, extrairContratoAuthz, extrairContratoDados, extrairContratoForbidden, extrairContratoSegredos, efeitoEhPrivilegiado, efeitoRequerSegredo, forbiddenContemRegra, } from "./seguranca.js";
 function ehUseInterop(use) {
@@ -285,6 +286,104 @@ function extrairPerfilCompatibilidade(bloco, padrao = "interno") {
     }
     return padrao;
 }
+function validarCamposSuportadosPersistencia(bloco, camposSuportados, diagnosticos, contexto, codigo, dica) {
+    for (const campo of bloco.campos) {
+        if (camposSuportados.has(campo.nome)) {
+            continue;
+        }
+        diagnosticos.push(criarDiagnostico(codigo, `Campo de persistencia "${campo.nome}" nao e suportado em ${contexto}.`, "erro", campo.intervalo, dica));
+    }
+}
+function validarBooleanoPersistencia(valor, intervalo, diagnosticos, codigo, mensagem) {
+    if (!valor) {
+        return;
+    }
+    if (parsearBooleanoPersistencia(valor) !== undefined) {
+        return;
+    }
+    diagnosticos.push(criarDiagnostico(codigo, mensagem, "erro", intervalo, "Use verdadeiro/falso ou true/false."));
+}
+function validarRecursoPersistencia(database, recurso, diagnosticos) {
+    const engine = normalizarEngineBanco(valorCampoCompleto(localizarCampo(database, "engine")));
+    if (!engine) {
+        return;
+    }
+    validarCamposSuportadosPersistencia(recurso, CAMPOS_RECURSO_PERSISTENCIA_SUPORTADOS, diagnosticos, `resource "${recurso.nome ?? recurso.palavraChave}" do database "${database.nome ?? "database"}"`, "SEM106", "Use apenas entity, consistency, durability, transaction_model, query_model, portavel, mode, isolation, strategy, ttl, retention, path, from, to, surface, adapter, resource_kind, collection, table ou compatibilidade.");
+    const tipoRecurso = nomeTipoRecursoPersistencia(recurso);
+    if (!tipoRecurso) {
+        return;
+    }
+    const nomeRecurso = recurso.nome ?? tipoRecurso;
+    const contexto = `resource "${nomeRecurso}" do database "${database.nome ?? "database"}"`;
+    const consistency = valorCampoCompleto(localizarCampo(recurso, "consistency"));
+    const durability = valorCampoCompleto(localizarCampo(recurso, "durability"));
+    const transactionModel = valorCampoCompleto(localizarCampo(recurso, "transaction_model"));
+    const queryModel = valorCampoCompleto(localizarCampo(recurso, "query_model"));
+    const mode = valorCampoCompleto(localizarCampo(recurso, "mode"));
+    const portavel = valorCampoCompleto(localizarCampo(recurso, "portavel"));
+    const isolation = valorCampoCompleto(localizarCampo(recurso, "isolation"));
+    if (consistency && !normalizarConsistenciaPersistencia(consistency)) {
+        diagnosticos.push(criarDiagnostico("SEM107", `${contexto} declarou consistency invalida: "${consistency}".`, "erro", localizarCampo(recurso, "consistency")?.intervalo, "Use eventual, forte, serializable, snapshot ou causal."));
+    }
+    if (durability && !normalizarDurabilidadePersistencia(durability)) {
+        diagnosticos.push(criarDiagnostico("SEM108", `${contexto} declarou durability invalida: "${durability}".`, "erro", localizarCampo(recurso, "durability")?.intervalo, "Use baixa, media ou alta."));
+    }
+    if (transactionModel && !normalizarModeloTransacaoPersistencia(transactionModel)) {
+        diagnosticos.push(criarDiagnostico("SEM109", `${contexto} declarou transaction_model invalido: "${transactionModel}".`, "erro", localizarCampo(recurso, "transaction_model")?.intervalo, "Use mvcc, bloqueio, documento, otimista ou single_thread."));
+    }
+    if (queryModel && !normalizarModeloConsultaPersistencia(queryModel)) {
+        diagnosticos.push(criarDiagnostico("SEM110", `${contexto} declarou query_model invalido: "${queryModel}".`, "erro", localizarCampo(recurso, "query_model")?.intervalo, "Use sql, documento, chave_valor, pipeline ou stream."));
+    }
+    if (mode && !normalizarModeloConsultaPersistencia(mode)) {
+        diagnosticos.push(criarDiagnostico("SEM111", `${contexto} declarou mode invalido: "${mode}".`, "erro", localizarCampo(recurso, "mode")?.intervalo, "Use sql, documento, chave_valor, pipeline ou stream."));
+    }
+    const compatibilidade = classificarCompatibilidadePersistencia(tipoRecurso, engine, { mode, isolation });
+    if (compatibilidade.status === "invalido") {
+        diagnosticos.push(criarDiagnostico("SEM112", `${contexto} nao e compativel com o engine ${engine}.`, "erro", recurso.intervalo, compatibilidade.motivo));
+    }
+    validarBooleanoPersistencia(portavel, localizarCampo(recurso, "portavel")?.intervalo ?? recurso.intervalo, diagnosticos, "SEM113", `${contexto} declarou portavel com valor invalido: "${portavel}".`);
+    if (parsearBooleanoPersistencia(portavel) && !recursoPersistenciaPodeSerPortavel(tipoRecurso, { mode, isolation })) {
+        diagnosticos.push(criarDiagnostico("SEM114", `${contexto} foi marcado como portavel, mas a compatibilidade entre os cinco bancos nao fecha sem perdas reais.`, "aviso", localizarCampo(recurso, "portavel")?.intervalo ?? recurso.intervalo, "Remova portavel ou reduza o recurso para um baseline comum entre postgres, mysql, sqlite, mongodb e redis."));
+    }
+}
+function validarDatabase(database, diagnosticos) {
+    validarCamposSuportadosPersistencia(database, CAMPOS_DATABASE_SUPORTADOS, diagnosticos, `database "${database.nome ?? "database"}"`, "SEM100", "Use apenas engine, schema, database, consistency, durability, transaction_model, query_model, portavel, adapter, perfil ou compatibilidade.");
+    const campoEngine = localizarCampo(database, "engine");
+    const engineBruto = valorCampoCompleto(campoEngine);
+    if (!engineBruto) {
+        diagnosticos.push(criarDiagnostico("SEM101", `Database "${database.nome ?? "database"}" precisa declarar engine.`, "erro", database.intervalo, "Use postgres, mysql, sqlite, mongodb ou redis."));
+        return;
+    }
+    const engine = normalizarEngineBanco(engineBruto);
+    if (!engine) {
+        diagnosticos.push(criarDiagnostico("SEM102", `Database "${database.nome ?? "database"}" declarou engine invalido: "${engineBruto}".`, "erro", campoEngine?.intervalo ?? database.intervalo, "Use postgres, mysql, sqlite, mongodb ou redis."));
+        return;
+    }
+    const consistency = valorCampoCompleto(localizarCampo(database, "consistency"));
+    const durability = valorCampoCompleto(localizarCampo(database, "durability"));
+    const transactionModel = valorCampoCompleto(localizarCampo(database, "transaction_model"));
+    const queryModel = valorCampoCompleto(localizarCampo(database, "query_model"));
+    const portavel = valorCampoCompleto(localizarCampo(database, "portavel"));
+    if (consistency && !normalizarConsistenciaPersistencia(consistency)) {
+        diagnosticos.push(criarDiagnostico("SEM103", `Database "${database.nome ?? "database"}" declarou consistency invalida: "${consistency}".`, "erro", localizarCampo(database, "consistency")?.intervalo, "Use eventual, forte, serializable, snapshot ou causal."));
+    }
+    if (durability && !normalizarDurabilidadePersistencia(durability)) {
+        diagnosticos.push(criarDiagnostico("SEM104", `Database "${database.nome ?? "database"}" declarou durability invalida: "${durability}".`, "erro", localizarCampo(database, "durability")?.intervalo, "Use baixa, media ou alta."));
+    }
+    if (transactionModel && !normalizarModeloTransacaoPersistencia(transactionModel)) {
+        diagnosticos.push(criarDiagnostico("SEM105", `Database "${database.nome ?? "database"}" declarou transaction_model invalido: "${transactionModel}".`, "erro", localizarCampo(database, "transaction_model")?.intervalo, "Use mvcc, bloqueio, documento, otimista ou single_thread."));
+    }
+    if (queryModel && !normalizarModeloConsultaPersistencia(queryModel)) {
+        diagnosticos.push(criarDiagnostico("SEM115", `Database "${database.nome ?? "database"}" declarou query_model invalido: "${queryModel}".`, "erro", localizarCampo(database, "query_model")?.intervalo, "Use sql, documento, chave_valor, pipeline ou stream."));
+    }
+    validarBooleanoPersistencia(portavel, localizarCampo(database, "portavel")?.intervalo ?? database.intervalo, diagnosticos, "SEM116", `Database "${database.nome ?? "database"}" declarou portavel com valor invalido: "${portavel}".`);
+    for (const recurso of database.blocos) {
+        if (recurso.tipo !== "bloco_generico") {
+            continue;
+        }
+        validarRecursoPersistencia(database, recurso, diagnosticos);
+    }
+}
 function coletarSuperficiesModulo(modulo) {
     return [
         ...modulo.workers.map((superficie) => ({ tipo: "worker", superficie })),
@@ -1102,7 +1201,9 @@ export function criarContextoLocal(modulo) {
             tasksConhecidas.add(nome);
             return;
         }
-        tiposConhecidos.add(nome);
+        if (categoria !== "database") {
+            tiposConhecidos.add(nome);
+        }
     };
     for (const type of modulo.types) {
         registrar(type.nome, "tipo");
@@ -1164,6 +1265,11 @@ export function criarContextoLocal(modulo) {
             registrar(policy.nome, "policy");
         }
     }
+    for (const database of modulo.databases) {
+        if (database.nome) {
+            registrar(database.nome, "database");
+        }
+    }
     for (const state of modulo.states) {
         if (state.nome) {
             registrar(state.nome, "state");
@@ -1336,7 +1442,9 @@ export function analisarSemantica(modulo, opcoes = {}) {
             tasksConhecidas.add(nome);
             return;
         }
-        tiposConhecidos.add(nome);
+        if (categoria !== "database") {
+            tiposConhecidos.add(nome);
+        }
     };
     for (const type of modulo.types) {
         registrar(type.nome, "tipo", type.intervalo);
@@ -1398,6 +1506,11 @@ export function analisarSemantica(modulo, opcoes = {}) {
             registrar(policy.nome, "policy", policy.intervalo);
         }
     }
+    for (const database of modulo.databases) {
+        if (database.nome) {
+            registrar(database.nome, "database", database.intervalo);
+        }
+    }
     for (const state of modulo.states) {
         if (state.nome) {
             registrar(state.nome, "state", state.intervalo);
@@ -1460,6 +1573,9 @@ export function analisarSemantica(modulo, opcoes = {}) {
     for (const policy of modulo.policies) {
         validarSuperficie(policy, "policy", tasksConhecidas, tiposConhecidos, diagnosticos);
     }
+    for (const database of modulo.databases) {
+        validarDatabase(database, diagnosticos);
+    }
     validarGuardrailsSeguranca(modulo, diagnosticos);
     const assinaturasRoute = new Map();
     for (const route of modulo.routes) {