evo360-types 1.3.656 → 1.3.659

package/dist/apps/evo-modules/zod-schemas.ts

@@ -0,0 +1,153 @@
+import { z } from "zod";
+import { zFireDocSchema, zFirestoreDateSchema } from "../shared/zod-schemas";
+import { getModuleDefinition } from "../../types/evo-modules/catalog";
+
+// ======================================================
+// evo-modules (feat-263) — zod schemas
+//
+// Espelham `ModuleAction`, `ModuleStepKind`, `ModuleStepStatus` e os shapes de
+// `types/evo-modules/index.ts`. As listas são à mão: manter os dois lados
+// sincronizados (o teste do catálogo confere).
+// ======================================================
+
+export const zModuleActionSchema = z.enum(["enable", "disable", "trial", "override"]);
+
+export const zModuleStepKindSchema = z.enum([
+  "entitlement",
+  "rbac_group",
+  "rbac_recompute",
+  "contract_allowance",
+  "contract_check",
+  "rollout_check",
+]);
+
+export const zModuleStepStatusSchema = z.enum([
+  "pending",
+  "noop",
+  "change",
+  "done",
+  "failed",
+  "blocked",
+  "skipped",
+]);
+
+export const zModuleRunModeSchema = z.enum(["plan", "apply"]);
+
+export const zModuleRunStatusSchema = z.enum([
+  "planned",
+  "running",
+  "done",
+  "failed",
+  "blocked",
+  "superseded",
+]);
+
+export const zModuleChangeParamsSchema = z.object({
+  expires_at: zFirestoreDateSchema.nullable().optional(),
+  override_until: zFirestoreDateSchema.nullable().optional(),
+  allow_without_contract: z.boolean().optional(),
+  purge_rbac: z.boolean().optional(),
+  suspend: z.boolean().optional(),
+});
+
+const zModuleKeyInCatalog = z
+  .string()
+  .min(1)
+  .refine((k) => getModuleDefinition(k) !== null, { message: "module is not in PLATFORM_MODULE_CATALOG" });
+
+/** Body de `nex_tenants-planModuleChange` (e entrada do runner). */
+export const zModuleChangeRequestSchema = z
+  .object({
+    tenant: z.string().trim().min(1).max(255),
+    module: zModuleKeyInCatalog,
+    action: zModuleActionSchema,
+    params: zModuleChangeParamsSchema.optional().default({}),
+    reason: z.string().trim().min(3).max(1000),
+  })
+  .superRefine((req, ctx) => {
+    const now = Date.now();
+    if (req.action === "trial") {
+      const exp = req.params.expires_at;
+      if (!exp) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["params", "expires_at"], message: "trial requires params.expires_at" });
+      } else if (exp.getTime() <= now) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["params", "expires_at"], message: "params.expires_at must be in the future" });
+      }
+    }
+    if (req.action === "override") {
+      const until = req.params.override_until;
+      if (!until) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["params", "override_until"], message: "override requires params.override_until" });
+      } else if (until.getTime() <= now) {
+        ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["params", "override_until"], message: "params.override_until must be in the future" });
+      }
+    }
+  });
+
+/** Body de `nex_tenants-applyModuleChange`: exatamente um de `plan_run_id` / `resume_run_id`. */
+export const zModuleApplyRequestSchema = z
+  .object({
+    tenant: z.string().trim().min(1).max(255),
+    plan_run_id: z.string().trim().min(1).optional(),
+    resume_run_id: z.string().trim().min(1).optional(),
+    params: z.object({ allow_without_contract: z.boolean().optional() }).optional(),
+  })
+  .superRefine((req, ctx) => {
+    const n = (req.plan_run_id ? 1 : 0) + (req.resume_run_id ? 1 : 0);
+    if (n !== 1) {
+      ctx.addIssue({ code: z.ZodIssueCode.custom, path: ["plan_run_id"], message: "exactly one of plan_run_id / resume_run_id is required" });
+    }
+  });
+
+/** Body de `nex_tenants-getModuleOverview`. */
+export const zModuleOverviewRequestSchema = z.object({
+  tenant: z.string().trim().min(1).max(255),
+});
+
+export const zModuleProvisioningStepSchema = z.object({
+  kind: zModuleStepKindSchema,
+  status: zModuleStepStatusSchema,
+  summary: z.string(),
+  before: z.unknown().optional(),
+  after: z.unknown().optional(),
+  error: z.string().nullable().optional(),
+  started_at: zFirestoreDateSchema.nullable().optional(),
+  finished_at: zFirestoreDateSchema.nullable().optional(),
+});
+
+export const zModuleRunActorSchema = z.object({
+  type: z.enum(["user", "system", "script"]),
+  id: z.string().optional(),
+  login_id: z.string().optional(),
+});
+
+export const zModuleProvisioningRunSchema = zFireDocSchema
+  .extend({
+    tenant: z.string().min(1),
+    module: z.string().min(1),
+    action: zModuleActionSchema,
+    mode: zModuleRunModeSchema,
+    status: zModuleRunStatusSchema,
+    params: zModuleChangeParamsSchema,
+    plan_hash: z.string(),
+    types_version: z.string(),
+    steps: z.array(zModuleProvisioningStepSchema),
+    actor: zModuleRunActorSchema,
+    reason: z.string(),
+    resumed_from: z.string().nullable().optional(),
+    plan_run_id: z.string().nullable().optional(),
+    error: z.string().nullable().optional(),
+    finished_at: zFirestoreDateSchema.nullable().optional(),
+    created_at: zFirestoreDateSchema.nullable().optional(),
+    updated_at: zFirestoreDateSchema.nullable().optional(),
+  })
+  .passthrough();
+
+export const zModuleRolloutDocSchema = z
+  .object({
+    flags: z.record(z.string(), z.boolean()).default({}),
+    emergency_kill: z.boolean().default(false),
+    updated_at: zFirestoreDateSchema.nullable().optional(),
+    updated_by: z.string().optional(),
+  })
+  .passthrough();

package/dist/index.d.ts

@@ -36,6 +36,7 @@ export * from "./types/evo-csq";
 export * from "./types/evo-mcp";
 export * from "./types/evo-reports";
 export * from "./types/evo-telemedicine";
+export * from "./types/evo-modules";
 export * from "./apps/shared/zod-schemas";
 export * from "./apps/evo-core/zod-schemas";
 export * from "./apps/evo-tenant/zod-schemas";
@@ -78,3 +79,4 @@ export * from "./apps/evo-task-runner/zod-schemas";
 export * from "./apps/hub-automation/zod-schemas";
 export * from "./apps/evo-integrations/zod-schemas";
 export * from "./apps/evo-telemedicine/zod-schemas";
+export * from "./apps/evo-modules/zod-schemas";

package/dist/index.js

@@ -53,6 +53,7 @@ __exportStar(require("./types/evo-csq"), exports);
 __exportStar(require("./types/evo-mcp"), exports);
 __exportStar(require("./types/evo-reports"), exports);
 __exportStar(require("./types/evo-telemedicine"), exports);
+__exportStar(require("./types/evo-modules"), exports);
 // zod schemas
 __exportStar(require("./apps/shared/zod-schemas"), exports);
 __exportStar(require("./apps/evo-core/zod-schemas"), exports);
@@ -96,3 +97,4 @@ __exportStar(require("./apps/evo-task-runner/zod-schemas"), exports);
 __exportStar(require("./apps/hub-automation/zod-schemas"), exports);
 __exportStar(require("./apps/evo-integrations/zod-schemas"), exports);
 __exportStar(require("./apps/evo-telemedicine/zod-schemas"), exports);
+__exportStar(require("./apps/evo-modules/zod-schemas"), exports);

package/dist/index.ts

@@ -37,6 +37,7 @@ export * from "./types/evo-csq";
 export * from "./types/evo-mcp";
 export * from "./types/evo-reports";
 export * from "./types/evo-telemedicine";
+export * from "./types/evo-modules";
 
 // zod schemas
 export * from "./apps/shared/zod-schemas";
@@ -81,3 +82,4 @@ export * from "./apps/evo-task-runner/zod-schemas";
 export * from "./apps/hub-automation/zod-schemas";
 export * from "./apps/evo-integrations/zod-schemas";
 export * from "./apps/evo-telemedicine/zod-schemas";
+export * from "./apps/evo-modules/zod-schemas";

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

@@ -0,0 +1,46 @@
+import type { ITenantModuleEntitlement } from "../evo-tenant";
+/**
+ * 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 declare function moduleDateToMillis(value: unknown): number | 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 declare function isModuleActive(entitlement: ITenantModuleEntitlement | null | undefined, now?: Date): boolean;
+/**
+ * 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 declare function hasModuleCapability(entitlement: ITenantModuleEntitlement | null | undefined, capability: string): boolean;
+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 declare function moduleContractMismatches(allowances: Record<string, unknown> | null | undefined, modules: Record<string, ITenantModuleEntitlement> | null | undefined, now?: Date): IModuleContractMismatch[];

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;
+}