evo360-types 1.3.656 → 1.3.662

package/dist/types/evo-modules/activation.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moduleDateToMillis = moduleDateToMillis;
+exports.isModuleActive = isModuleActive;
+exports.hasModuleCapability = hasModuleCapability;
+exports.moduleContractMismatches = moduleContractMismatches;
+const catalog_1 = require("./catalog");
+/**
+ * Normaliza qualquer forma de data que chega às superfícies: `Date`, Firestore
+ * `Timestamp` (`toDate()`), Timestamp serializado (`{_seconds}` / `{seconds}`),
+ * ISO string e epoch em ms. Inválido ⇒ `null` (equivale a "sem data").
+ */
+function moduleDateToMillis(value) {
+    if (value === null || value === undefined || value === "")
+        return null;
+    if (value instanceof Date) {
+        const t = value.getTime();
+        return isNaN(t) ? null : t;
+    }
+    if (typeof value === "number")
+        return isFinite(value) ? value : null;
+    if (typeof value === "string") {
+        const t = new Date(value).getTime();
+        return isNaN(t) ? null : t;
+    }
+    if (typeof value === "object") {
+        const v = value;
+        if (typeof v.toDate === "function") {
+            try {
+                const d = v.toDate();
+                if (d instanceof Date) {
+                    const t = d.getTime();
+                    return isNaN(t) ? null : t;
+                }
+            }
+            catch {
+                return null;
+            }
+            return null;
+        }
+        const seconds = typeof v._seconds === "number" ? v._seconds : typeof v.seconds === "number" ? v.seconds : null;
+        if (seconds !== null && isFinite(seconds)) {
+            const nanos = typeof v._nanoseconds === "number" ? v._nanoseconds : typeof v.nanoseconds === "number" ? v.nanoseconds : 0;
+            return seconds * 1000 + Math.floor(nanos / 1e6);
+        }
+    }
+    return null;
+}
+/**
+ * Decide se o entitlement autoriza um uso NOVO do módulo. Função pura e ÚNICA:
+ * backend (`Core.Tenant.isModuleActive`), web-app e Nexus usam esta; o Flutter
+ * espelha e prova pela fixture `fixtures/tenant-modules/is-module-active.parity.json`.
+ *
+ * Ordem das cláusulas (importa):
+ * 1. `override_until` futuro COM `override_by` libera (D6: exceção operacional
+ *    temporária e auditada) — mesmo suspenso/cancelado/vencido;
+ * 2. `enabled !== true` bloqueia;
+ * 3. `suspended`/`cancelled` bloqueiam;
+ * 4. `effective_at` no futuro bloqueia;
+ * 5. `expires_at` no passado (ou agora) bloqueia, para QUALQUER status;
+ * 6. só `active` e `trial` liberam.
+ *
+ * Não tem parâmetro de papel: super admin não ignora entitlement (D6).
+ */
+function isModuleActive(entitlement, now = new Date()) {
+    if (!entitlement || typeof entitlement !== "object")
+        return false;
+    const t = now.getTime();
+    const overrideUntil = moduleDateToMillis(entitlement.override_until);
+    if (overrideUntil !== null && overrideUntil > t && !!entitlement.override_by)
+        return true;
+    if (entitlement.enabled !== true)
+        return false;
+    if (entitlement.status === "suspended" || entitlement.status === "cancelled")
+        return false;
+    const effectiveAt = moduleDateToMillis(entitlement.effective_at);
+    if (effectiveAt !== null && effectiveAt > t)
+        return false;
+    const expiresAt = moduleDateToMillis(entitlement.expires_at);
+    if (expiresAt !== null && expiresAt <= t)
+        return false;
+    return entitlement.status === "active" || entitlement.status === "trial";
+}
+/**
+ * Capability ausente, não-booleana (`"true"`, `1`) ou `false` equivale a `false`.
+ * Não implica módulo ativo: o gate de UI equivalente ao backend é
+ * `isModuleActive(e) && hasModuleCapability(e, cap)`.
+ */
+function hasModuleCapability(entitlement, capability) {
+    if (!entitlement || !entitlement.capabilities)
+        return false;
+    return entitlement.capabilities[capability] === true;
+}
+/**
+ * Divergências entre franquias do contrato (`allowances`) e módulos do tenant,
+ * pelas `allowance_metrics` do catálogo. Só informa (a tela de contrato mostra);
+ * nada sincroniza sozinho (Q1).
+ *
+ * - `active_without_allowance`: módulo ativo e nenhuma métrica dele no contrato
+ *   (consumo invisível ao alerta e ao portal);
+ * - `allowance_without_module`: contrato tem franquia de uma métrica do módulo e
+ *   o módulo não está ativo.
+ */
+function moduleContractMismatches(allowances, modules, now = new Date()) {
+    const out = [];
+    const allow = allowances && typeof allowances === "object" ? allowances : {};
+    const mods = modules && typeof modules === "object" ? modules : {};
+    for (const key in catalog_1.PLATFORM_MODULE_CATALOG) {
+        if (!Object.prototype.hasOwnProperty.call(catalog_1.PLATFORM_MODULE_CATALOG, key))
+            continue;
+        const def = catalog_1.PLATFORM_MODULE_CATALOG[key];
+        if (def.allowance_metrics.length === 0)
+            continue;
+        const active = isModuleActive(Object.prototype.hasOwnProperty.call(mods, key) ? mods[key] : null, now);
+        const present = [];
+        for (const m of def.allowance_metrics) {
+            if (Object.prototype.hasOwnProperty.call(allow, m.metric) && allow[m.metric] !== null && allow[m.metric] !== undefined) {
+                present.push(m.metric);
+            }
+        }
+        if (active && present.length === 0) {
+            out.push({ module: key, metric: def.allowance_metrics[0].metric, kind: "active_without_allowance" });
+        }
+        if (!active) {
+            for (const metric of present) {
+                out.push({ module: key, metric, kind: "allowance_without_module" });
+            }
+        }
+    }
+    return out;
+}

package/dist/types/evo-modules/activation.ts

@@ -0,0 +1,150 @@
+import type { ITenantModuleEntitlement } from "../evo-tenant";
+import { PLATFORM_MODULE_CATALOG } from "./catalog";
+
+/**
+ * Normaliza qualquer forma de data que chega às superfícies: `Date`, Firestore
+ * `Timestamp` (`toDate()`), Timestamp serializado (`{_seconds}` / `{seconds}`),
+ * ISO string e epoch em ms. Inválido ⇒ `null` (equivale a "sem data").
+ */
+export function moduleDateToMillis(value: unknown): number | null {
+  if (value === null || value === undefined || value === "") return null;
+  if (value instanceof Date) {
+    const t = value.getTime();
+    return isNaN(t) ? null : t;
+  }
+  if (typeof value === "number") return isFinite(value) ? value : null;
+  if (typeof value === "string") {
+    const t = new Date(value).getTime();
+    return isNaN(t) ? null : t;
+  }
+  if (typeof value === "object") {
+    const v = value as {
+      toDate?: unknown;
+      _seconds?: unknown;
+      seconds?: unknown;
+      _nanoseconds?: unknown;
+      nanoseconds?: unknown;
+    };
+    if (typeof v.toDate === "function") {
+      try {
+        const d = (v.toDate as () => unknown)();
+        if (d instanceof Date) {
+          const t = d.getTime();
+          return isNaN(t) ? null : t;
+        }
+      } catch {
+        return null;
+      }
+      return null;
+    }
+    const seconds = typeof v._seconds === "number" ? v._seconds : typeof v.seconds === "number" ? v.seconds : null;
+    if (seconds !== null && isFinite(seconds)) {
+      const nanos =
+        typeof v._nanoseconds === "number" ? v._nanoseconds : typeof v.nanoseconds === "number" ? v.nanoseconds : 0;
+      return seconds * 1000 + Math.floor(nanos / 1e6);
+    }
+  }
+  return null;
+}
+
+/**
+ * Decide se o entitlement autoriza um uso NOVO do módulo. Função pura e ÚNICA:
+ * backend (`Core.Tenant.isModuleActive`), web-app e Nexus usam esta; o Flutter
+ * espelha e prova pela fixture `fixtures/tenant-modules/is-module-active.parity.json`.
+ *
+ * Ordem das cláusulas (importa):
+ * 1. `override_until` futuro COM `override_by` libera (D6: exceção operacional
+ *    temporária e auditada) — mesmo suspenso/cancelado/vencido;
+ * 2. `enabled !== true` bloqueia;
+ * 3. `suspended`/`cancelled` bloqueiam;
+ * 4. `effective_at` no futuro bloqueia;
+ * 5. `expires_at` no passado (ou agora) bloqueia, para QUALQUER status;
+ * 6. só `active` e `trial` liberam.
+ *
+ * Não tem parâmetro de papel: super admin não ignora entitlement (D6).
+ */
+export function isModuleActive(
+  entitlement: ITenantModuleEntitlement | null | undefined,
+  now: Date = new Date(),
+): boolean {
+  if (!entitlement || typeof entitlement !== "object") return false;
+
+  const t = now.getTime();
+
+  const overrideUntil = moduleDateToMillis(entitlement.override_until);
+  if (overrideUntil !== null && overrideUntil > t && !!entitlement.override_by) return true;
+
+  if (entitlement.enabled !== true) return false;
+  if (entitlement.status === "suspended" || entitlement.status === "cancelled") return false;
+
+  const effectiveAt = moduleDateToMillis(entitlement.effective_at);
+  if (effectiveAt !== null && effectiveAt > t) return false;
+
+  const expiresAt = moduleDateToMillis(entitlement.expires_at);
+  if (expiresAt !== null && expiresAt <= t) return false;
+
+  return entitlement.status === "active" || entitlement.status === "trial";
+}
+
+/**
+ * Capability ausente, não-booleana (`"true"`, `1`) ou `false` equivale a `false`.
+ * Não implica módulo ativo: o gate de UI equivalente ao backend é
+ * `isModuleActive(e) && hasModuleCapability(e, cap)`.
+ */
+export function hasModuleCapability(
+  entitlement: ITenantModuleEntitlement | null | undefined,
+  capability: string,
+): boolean {
+  if (!entitlement || !entitlement.capabilities) return false;
+  return entitlement.capabilities[capability] === true;
+}
+
+export interface IModuleContractMismatch {
+  module: string;
+  metric: string;
+  kind: "active_without_allowance" | "allowance_without_module";
+}
+
+/**
+ * Divergências entre franquias do contrato (`allowances`) e módulos do tenant,
+ * pelas `allowance_metrics` do catálogo. Só informa (a tela de contrato mostra);
+ * nada sincroniza sozinho (Q1).
+ *
+ * - `active_without_allowance`: módulo ativo e nenhuma métrica dele no contrato
+ *   (consumo invisível ao alerta e ao portal);
+ * - `allowance_without_module`: contrato tem franquia de uma métrica do módulo e
+ *   o módulo não está ativo.
+ */
+export function moduleContractMismatches(
+  allowances: Record<string, unknown> | null | undefined,
+  modules: Record<string, ITenantModuleEntitlement> | null | undefined,
+  now: Date = new Date(),
+): IModuleContractMismatch[] {
+  const out: IModuleContractMismatch[] = [];
+  const allow = allowances && typeof allowances === "object" ? allowances : {};
+  const mods = modules && typeof modules === "object" ? modules : {};
+
+  for (const key in PLATFORM_MODULE_CATALOG) {
+    if (!Object.prototype.hasOwnProperty.call(PLATFORM_MODULE_CATALOG, key)) continue;
+    const def = PLATFORM_MODULE_CATALOG[key];
+    if (def.allowance_metrics.length === 0) continue;
+
+    const active = isModuleActive(Object.prototype.hasOwnProperty.call(mods, key) ? mods[key] : null, now);
+    const present: string[] = [];
+    for (const m of def.allowance_metrics) {
+      if (Object.prototype.hasOwnProperty.call(allow, m.metric) && allow[m.metric] !== null && allow[m.metric] !== undefined) {
+        present.push(m.metric);
+      }
+    }
+
+    if (active && present.length === 0) {
+      out.push({ module: key, metric: def.allowance_metrics[0].metric, kind: "active_without_allowance" });
+    }
+    if (!active) {
+      for (const metric of present) {
+        out.push({ module: key, metric, kind: "allowance_without_module" });
+      }
+    }
+  }
+  return out;
+}

package/dist/types/evo-modules/catalog.d.ts

@@ -0,0 +1,28 @@
+import type { IPlatformModuleDefinition } from "./index";
+/**
+ * Versão do catálogo, gravada em `IModuleProvisioningRun.types_version`.
+ * Mudou capability, passo, grupo ou métrica de algum módulo ⇒ incrementar: o
+ * run antigo precisa dizer com que catálogo foi planejado.
+ */
+export declare const PLATFORM_MODULE_CATALOG_VERSION = "2026-10-06.1";
+export declare const PLATFORM_MODULE_TELEMEDICINE = "telemedicine";
+export declare const PLATFORM_MODULE_CSQ = "csq";
+/**
+ * Catálogo de módulos da plataforma (feat-263). É código, não Firestore: carrega
+ * comportamento (passos, grupos, métricas) e precisa de versionamento e tipos.
+ *
+ * Módulo novo = uma entrada aqui + publish. O estado por tenant continua em
+ * `tenants/{t}.modules[key]`.
+ */
+export declare const PLATFORM_MODULE_CATALOG: Readonly<Record<string, IPlatformModuleDefinition>>;
+export declare function getModuleDefinition(key: string | null | undefined): IPlatformModuleDefinition | null;
+/** Definições em ordem estável (ordem de declaração). */
+export declare function listModuleDefinitions(): IPlatformModuleDefinition[];
+/** Chaves do catálogo em ordem de declaração. */
+export declare function listModuleKeys(): string[];
+/** Capabilities default do módulo (mapa novo a cada chamada). */
+export declare function buildModuleDefaultCapabilities(definition: IPlatformModuleDefinition): Record<string, boolean | number | string>;
+/** Módulos que tenant novo recebe habilitados. */
+export declare function listDefaultModulesForNewTenants(): IPlatformModuleDefinition[];
+/** União, sem repetição e em ordem, dos grupos RBAC dos módulos default de tenant novo. */
+export declare function listDefaultTenantRbacGroups(): string[];

package/dist/types/evo-modules/catalog.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_MODULE_CATALOG = exports.PLATFORM_MODULE_CSQ = exports.PLATFORM_MODULE_TELEMEDICINE = exports.PLATFORM_MODULE_CATALOG_VERSION = void 0;
+exports.getModuleDefinition = getModuleDefinition;
+exports.listModuleDefinitions = listModuleDefinitions;
+exports.listModuleKeys = listModuleKeys;
+exports.buildModuleDefaultCapabilities = buildModuleDefaultCapabilities;
+exports.listDefaultModulesForNewTenants = listDefaultModulesForNewTenants;
+exports.listDefaultTenantRbacGroups = listDefaultTenantRbacGroups;
+/**
+ * Versão do catálogo, gravada em `IModuleProvisioningRun.types_version`.
+ * Mudou capability, passo, grupo ou métrica de algum módulo ⇒ incrementar: o
+ * run antigo precisa dizer com que catálogo foi planejado.
+ */
+exports.PLATFORM_MODULE_CATALOG_VERSION = "2026-10-06.1";
+exports.PLATFORM_MODULE_TELEMEDICINE = "telemedicine";
+exports.PLATFORM_MODULE_CSQ = "csq";
+/**
+ * Catálogo de módulos da plataforma (feat-263). É código, não Firestore: carrega
+ * comportamento (passos, grupos, métricas) e precisa de versionamento e tipos.
+ *
+ * Módulo novo = uma entrada aqui + publish. O estado por tenant continua em
+ * `tenants/{t}.modules[key]`.
+ */
+exports.PLATFORM_MODULE_CATALOG = {
+    telemedicine: {
+        key: exports.PLATFORM_MODULE_TELEMEDICINE,
+        label: "Virtual Care (Telemedicina)",
+        description: "Teleconsultas por vídeo integradas à agenda, com gravação e admissão automática.",
+        app_id: "evo-telemedicine",
+        // Defaults idênticos ao `TELEMEDICINE_DEFAULT_CAPABILITIES` da R5 (feat-160):
+        // transcrição NUNCA nasce ligada (gate documental D12).
+        capabilities: {
+            recording: { label: "Gravação", default: true },
+            transcription: { label: "Transcrição", default: false },
+            auto_admit: { label: "Admissão automática", default: true },
+        },
+        // `active/contract` sem `expires_at`: a franquia faz parte do contrato; um
+        // `expires_at` desligaria a base inteira numa data, em silêncio.
+        default_entitlement: { status: "active", source: "contract" },
+        default_for_new_tenants: true,
+        rbac_groups: ["evo-telemedicine"],
+        allowance_metrics: [{ metric: "teleconsultations_unrecorded", default_included: 5 }],
+        rollout: {
+            path: "platform/evo-telemedicine/config/rollout",
+            layout: "legacy_fields",
+            flags: {
+                create: "create_enabled",
+                join: "join_enabled",
+                recording: "recording_enabled",
+                transcription: "transcription_enabled",
+            },
+        },
+        depends_on: [],
+        provisioning: {
+            enable: ["entitlement", "rbac_group", "rbac_recompute", "contract_allowance", "rollout_check"],
+            // O grupo RBAC fica no disable (Q7): o upsell depende de `evo_telemedicine_read`.
+            disable: ["entitlement", "contract_check"],
+        },
+        legacy: { audit_collections: ["apps/evo-telemedicine/entitlement-audit"] },
+    },
+    csq: {
+        key: exports.PLATFORM_MODULE_CSQ,
+        label: "CSQ — Qualidade do atendimento",
+        description: "Avaliação automática da qualidade das conversas encerradas (laudo por ticket).",
+        app_id: "evo-csq",
+        capabilities: {},
+        default_entitlement: { status: "active", source: "manual" },
+        default_for_new_tenants: false,
+        rbac_groups: [],
+        allowance_metrics: [],
+        rollout: null,
+        depends_on: [],
+        provisioning: {
+            enable: ["entitlement"],
+            disable: ["entitlement"],
+        },
+    },
+};
+function getModuleDefinition(key) {
+    if (!key || typeof key !== "string")
+        return null;
+    if (!Object.prototype.hasOwnProperty.call(exports.PLATFORM_MODULE_CATALOG, key))
+        return null;
+    return exports.PLATFORM_MODULE_CATALOG[key];
+}
+/** Definições em ordem estável (ordem de declaração). */
+function listModuleDefinitions() {
+    const out = [];
+    for (const key in exports.PLATFORM_MODULE_CATALOG) {
+        if (Object.prototype.hasOwnProperty.call(exports.PLATFORM_MODULE_CATALOG, key)) {
+            out.push(exports.PLATFORM_MODULE_CATALOG[key]);
+        }
+    }
+    return out;
+}
+/** Chaves do catálogo em ordem de declaração. */
+function listModuleKeys() {
+    const out = [];
+    for (const key in exports.PLATFORM_MODULE_CATALOG) {
+        if (Object.prototype.hasOwnProperty.call(exports.PLATFORM_MODULE_CATALOG, key))
+            out.push(key);
+    }
+    return out;
+}
+/** Capabilities default do módulo (mapa novo a cada chamada). */
+function buildModuleDefaultCapabilities(definition) {
+    const out = {};
+    for (const cap in definition.capabilities) {
+        if (Object.prototype.hasOwnProperty.call(definition.capabilities, cap)) {
+            out[cap] = definition.capabilities[cap].default;
+        }
+    }
+    return out;
+}
+/** Módulos que tenant novo recebe habilitados. */
+function listDefaultModulesForNewTenants() {
+    return listModuleDefinitions().filter((d) => d.default_for_new_tenants);
+}
+/** União, sem repetição e em ordem, dos grupos RBAC dos módulos default de tenant novo. */
+function listDefaultTenantRbacGroups() {
+    const out = [];
+    for (const def of listDefaultModulesForNewTenants()) {
+        for (const g of def.rbac_groups) {
+            if (out.indexOf(g) === -1)
+                out.push(g);
+        }
+    }
+    return out;
+}

package/dist/types/evo-modules/catalog.ts

@@ -0,0 +1,131 @@
+import type { IPlatformModuleDefinition } from "./index";
+
+/**
+ * Versão do catálogo, gravada em `IModuleProvisioningRun.types_version`.
+ * Mudou capability, passo, grupo ou métrica de algum módulo ⇒ incrementar: o
+ * run antigo precisa dizer com que catálogo foi planejado.
+ */
+export const PLATFORM_MODULE_CATALOG_VERSION = "2026-10-06.1";
+
+export const PLATFORM_MODULE_TELEMEDICINE = "telemedicine";
+export const PLATFORM_MODULE_CSQ = "csq";
+
+/**
+ * Catálogo de módulos da plataforma (feat-263). É código, não Firestore: carrega
+ * comportamento (passos, grupos, métricas) e precisa de versionamento e tipos.
+ *
+ * Módulo novo = uma entrada aqui + publish. O estado por tenant continua em
+ * `tenants/{t}.modules[key]`.
+ */
+export const PLATFORM_MODULE_CATALOG: Readonly<Record<string, IPlatformModuleDefinition>> = {
+  telemedicine: {
+    key: PLATFORM_MODULE_TELEMEDICINE,
+    label: "Virtual Care (Telemedicina)",
+    description:
+      "Teleconsultas por vídeo integradas à agenda, com gravação e admissão automática.",
+    app_id: "evo-telemedicine",
+    // Defaults idênticos ao `TELEMEDICINE_DEFAULT_CAPABILITIES` da R5 (feat-160):
+    // transcrição NUNCA nasce ligada (gate documental D12).
+    capabilities: {
+      recording: { label: "Gravação", default: true },
+      transcription: { label: "Transcrição", default: false },
+      auto_admit: { label: "Admissão automática", default: true },
+    },
+    // `active/contract` sem `expires_at`: a franquia faz parte do contrato; um
+    // `expires_at` desligaria a base inteira numa data, em silêncio.
+    default_entitlement: { status: "active", source: "contract" },
+    default_for_new_tenants: true,
+    rbac_groups: ["evo-telemedicine"],
+    allowance_metrics: [{ metric: "teleconsultations_unrecorded", default_included: 5 }],
+    rollout: {
+      path: "platform/evo-telemedicine/config/rollout",
+      layout: "legacy_fields",
+      flags: {
+        create: "create_enabled",
+        join: "join_enabled",
+        recording: "recording_enabled",
+        transcription: "transcription_enabled",
+      },
+    },
+    depends_on: [],
+    provisioning: {
+      enable: ["entitlement", "rbac_group", "rbac_recompute", "contract_allowance", "rollout_check"],
+      // O grupo RBAC fica no disable (Q7): o upsell depende de `evo_telemedicine_read`.
+      disable: ["entitlement", "contract_check"],
+    },
+    legacy: { audit_collections: ["apps/evo-telemedicine/entitlement-audit"] },
+  },
+  csq: {
+    key: PLATFORM_MODULE_CSQ,
+    label: "CSQ — Qualidade do atendimento",
+    description:
+      "Avaliação automática da qualidade das conversas encerradas (laudo por ticket).",
+    app_id: "evo-csq",
+    capabilities: {},
+    default_entitlement: { status: "active", source: "manual" },
+    default_for_new_tenants: false,
+    rbac_groups: [],
+    allowance_metrics: [],
+    rollout: null,
+    depends_on: [],
+    provisioning: {
+      enable: ["entitlement"],
+      disable: ["entitlement"],
+    },
+  },
+};
+
+export function getModuleDefinition(key: string | null | undefined): IPlatformModuleDefinition | null {
+  if (!key || typeof key !== "string") return null;
+  if (!Object.prototype.hasOwnProperty.call(PLATFORM_MODULE_CATALOG, key)) return null;
+  return PLATFORM_MODULE_CATALOG[key];
+}
+
+/** Definições em ordem estável (ordem de declaração). */
+export function listModuleDefinitions(): IPlatformModuleDefinition[] {
+  const out: IPlatformModuleDefinition[] = [];
+  for (const key in PLATFORM_MODULE_CATALOG) {
+    if (Object.prototype.hasOwnProperty.call(PLATFORM_MODULE_CATALOG, key)) {
+      out.push(PLATFORM_MODULE_CATALOG[key]);
+    }
+  }
+  return out;
+}
+
+/** Chaves do catálogo em ordem de declaração. */
+export function listModuleKeys(): string[] {
+  const out: string[] = [];
+  for (const key in PLATFORM_MODULE_CATALOG) {
+    if (Object.prototype.hasOwnProperty.call(PLATFORM_MODULE_CATALOG, key)) out.push(key);
+  }
+  return out;
+}
+
+/** Capabilities default do módulo (mapa novo a cada chamada). */
+export function buildModuleDefaultCapabilities(
+  definition: IPlatformModuleDefinition,
+): Record<string, boolean | number | string> {
+  const out: Record<string, boolean | number | string> = {};
+  for (const cap in definition.capabilities) {
+    if (Object.prototype.hasOwnProperty.call(definition.capabilities, cap)) {
+      out[cap] = definition.capabilities[cap].default;
+    }
+  }
+  return out;
+}
+
+/** Módulos que tenant novo recebe habilitados. */
+export function listDefaultModulesForNewTenants(): IPlatformModuleDefinition[] {
+  return listModuleDefinitions().filter((d) => d.default_for_new_tenants);
+}
+
+/** União, sem repetição e em ordem, dos grupos RBAC dos módulos default de tenant novo. */
+export function listDefaultTenantRbacGroups(): string[] {
+  const out: string[] = [];
+  for (const def of listDefaultModulesForNewTenants()) {
+    for (const g of def.rbac_groups) {
+      if (out.indexOf(g) === -1) out.push(g);
+    }
+  }
+  return out;
+}