evo360-types 1.3.656 → 1.3.662

package/dist/types/evo-task/index.ts

@@ -357,6 +357,10 @@ export interface IAutoTask extends ITaskBase {
   // Runtime state populated by the Task Runner
   runner_state?: ITaskRunnerState;
 
+  // Why the handler decided not to deliver (suppressed | failed by defect).
+  // Reset to null when the task completes or is retried manually.
+  outcome?: ITaskOutcome | null;
+
   // What to execute
   auto: ITaskAutoSpec;
 }
@@ -369,11 +373,29 @@ export const TaskExecutionStatusEnum = {
   Success: "success",
   Error: "error",
   Retry: "retry",
+  // Handler ran and decided not to deliver; `outcome` says why. The runner
+  // finalizes the task directly (no retry, fallback or handoff).
+  Suppressed: "suppressed",
 } as const;
 
 export type TaskExecutionStatus =
   (typeof TaskExecutionStatusEnum)[keyof typeof TaskExecutionStatusEnum];
 
+export type TaskOutcomeClass = "legitimate" | "defect";
+
+// Outcome of an execution that did not deliver. `legitimate` ends the task as
+// `suppressed`; `defect` ends it as `failed` (actionable problem).
+export interface ITaskOutcome {
+  class: TaskOutcomeClass;
+  reason: string;
+  label: string;
+  message: string;
+  action_hint?: string;
+  scope?: string;
+  details?: Record<string, unknown>;
+  at: Date;
+}
+
 export interface ITaskExecution extends IFireDoc {
   taskId: string;
   handler: TaskAutoHandler;
@@ -391,6 +413,9 @@ export interface ITaskExecution extends IFireDoc {
     details?: Record<string, unknown>;
   };
 
+  // Present when status is suppressed
+  outcome?: ITaskOutcome;
+
   // Optional provider metadata (e.g. WhatsApp provider message id)
   provider?: {
     name?: string;

package/dist/types/evo-task-runner/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./fb_collections";
 import type { IFireDoc } from "../shared";
-import type { TaskAutoHandler, TaskExecutionStatus, TaskRetryStrategy } from "../evo-task";
+import type { TaskAutoHandler, ITaskOutcome, TaskExecutionStatus, TaskRetryStrategy } from "../evo-task";
 export declare const EvoTaskRunnerPermissions: {
     readonly List: "evo_task_runner_read";
     readonly Get: "evo_task_runner_read";
@@ -55,6 +55,7 @@ export interface ITaskExecutionReport {
     attempt: number;
     correlation_id?: string;
     status: TaskExecutionStatus;
+    outcome?: ITaskOutcome;
     started_at: Date;
     completed_at: Date;
     suggested_retry?: {

package/dist/types/evo-task-runner/index.ts

@@ -2,6 +2,7 @@ export * from "./fb_collections";
 import type { IFireDoc } from "../shared";
 import type {
   TaskAutoHandler,
+  ITaskOutcome,
   TaskExecutionStatus,
   TaskRetryStrategy,
 } from "../evo-task";
@@ -115,7 +116,10 @@ export interface ITaskExecutionReport {
   correlation_id?: string;
 
   // Status/result
-  status: TaskExecutionStatus; // success | error | retry
+  status: TaskExecutionStatus; // success | error | retry | suppressed
+
+  // Required when status is suppressed: why nothing was delivered
+  outcome?: ITaskOutcome;
 
   started_at: Date;
   completed_at: Date;

package/dist/types/evo-telemedicine/fb_collections.js

@@ -13,7 +13,7 @@ exports.TELEMEDICINE_CONFIG_TRANSCRIPTION_DOC = exports.TELEMEDICINE_CONFIG_ROLL
 // - Events:            .../teleconsultations/{id}/events/{eventId}            (append-only)
 // - Webhook events:    .../teleconsultations/{id}/webhook-events/{providerEventId} (dedup + outbox)
 // - Appointment index: /tenants/{t}/apps/evo-telemedicine/appointment-index/{calendarId}__{appointmentId}
-// - Entitlement audit: /tenants/{t}/apps/evo-telemedicine/entitlement-audit/{id}
+// - Entitlement audit: /tenants/{t}/apps/evo-telemedicine/entitlement-audit/{id}  (congelada; nova: apps/evo-modules, feat-263)
 //
 // Plataforma (só backend; rules negam leitura ao FE):
 // - Legal texts:  /platform/evo-telemedicine/legal-texts/{subject}-{locale}-{version}

package/dist/types/evo-telemedicine/fb_collections.ts

@@ -10,7 +10,7 @@
 // - Events:            .../teleconsultations/{id}/events/{eventId}            (append-only)
 // - Webhook events:    .../teleconsultations/{id}/webhook-events/{providerEventId} (dedup + outbox)
 // - Appointment index: /tenants/{t}/apps/evo-telemedicine/appointment-index/{calendarId}__{appointmentId}
-// - Entitlement audit: /tenants/{t}/apps/evo-telemedicine/entitlement-audit/{id}
+// - Entitlement audit: /tenants/{t}/apps/evo-telemedicine/entitlement-audit/{id}  (congelada; nova: apps/evo-modules, feat-263)
 //
 // Plataforma (só backend; rules negam leitura ao FE):
 // - Legal texts:  /platform/evo-telemedicine/legal-texts/{subject}-{locale}-{version}

package/dist/types/evo-telemedicine/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./fb_collections";
 import type { IFireDoc, IFireGlobalDoc } from "../shared";
-import type { ITenantModuleEntitlement } from "../evo-tenant";
+import type { IModuleEntitlementAudit } from "../evo-modules";
 import type { VirtualCareRecordingMode } from "../evo-med/calendar";
 export declare const EvoTelemedicinePermissions: {
     /** Ver estado e dados operacionais básicos. */
@@ -816,17 +816,13 @@ export interface IEntitlementAuditActor {
     type: "user" | "system" | "script";
     id?: string;
 }
-/** Fora do doc do tenant, como pede o data-model. `before/after` são a projeção sanitizada (sem preço/contrato). */
-export interface ITelemedicineEntitlementAudit extends IFireDoc {
-    module: string;
-    action: EntitlementAuditAction;
-    before?: ITenantModuleEntitlement | null;
-    after: ITenantModuleEntitlement;
-    actor: IEntitlementAuditActor;
-    reason: string;
-    occurred_at: Date;
-    correlation_id?: string;
-}
+/**
+ * Fora do doc do tenant, como pede o data-model. `before/after` são a projeção sanitizada (sem preço/contrato).
+ * feat-263: alias da auditoria genérica. Docs novos vão para
+ * `tenants/{t}/apps/evo-modules/entitlement-audit/{id}`; a trilha antiga em
+ * `apps/evo-telemedicine/entitlement-audit` fica congelada (só leitura).
+ */
+export type ITelemedicineEntitlementAudit = IModuleEntitlementAudit;
 export declare const TelemedicineErrorCode: {
     /** 403 — entitlement ausente/inativo (sem bypass de super admin). */
     readonly TenantModuleDisabled: "TENANT_MODULE_DISABLED";

package/dist/types/evo-telemedicine/index.ts

@@ -1,6 +1,6 @@
 export * from "./fb_collections";
 import type { IFireDoc, IFireGlobalDoc } from "../shared";
-import type { ITenantModuleEntitlement } from "../evo-tenant";
+import type { IModuleEntitlementAudit } from "../evo-modules";
 // feat-160 F15/F16 — a política da sala é projeção do `calendar.virtual_care`:
 // o MODO de gravação é o mesmo tipo dos dois lados, de propósito.
 import type { VirtualCareRecordingMode } from "../evo-med/calendar";
@@ -930,17 +930,13 @@ export interface IEntitlementAuditActor {
   id?: string;
 }
 
-/** Fora do doc do tenant, como pede o data-model. `before/after` são a projeção sanitizada (sem preço/contrato). */
-export interface ITelemedicineEntitlementAudit extends IFireDoc {
-  module: string;
-  action: EntitlementAuditAction;
-  before?: ITenantModuleEntitlement | null;
-  after: ITenantModuleEntitlement;
-  actor: IEntitlementAuditActor;
-  reason: string;
-  occurred_at: Date;
-  correlation_id?: string;
-}
+/**
+ * Fora do doc do tenant, como pede o data-model. `before/after` são a projeção sanitizada (sem preço/contrato).
+ * feat-263: alias da auditoria genérica. Docs novos vão para
+ * `tenants/{t}/apps/evo-modules/entitlement-audit/{id}`; a trilha antiga em
+ * `apps/evo-telemedicine/entitlement-audit` fica congelada (só leitura).
+ */
+export type ITelemedicineEntitlementAudit = IModuleEntitlementAudit;
 
 // ======================================================
 // Códigos de erro (plan §4 — `{ ok: false, error: '<CODE>', message? }` com status estável)

package/dist/types/evo-tenant/index.ts

@@ -58,7 +58,9 @@ export enum ITenantStatus {
 // - ausência da chave em `modules` equivale a desabilitado;
 // - `enabled=false`, `suspended`, `cancelled` ou trial expirado bloqueia usos novos;
 // - capability ausente equivale a `false`;
-// - alteração gera auditoria FORA do doc do tenant (`entitlement-audit` do módulo);
+// - alteração gera auditoria FORA do doc do tenant, no caminho genérico
+//   `tenants/{t}/apps/evo-modules/entitlement-audit/{id}` (feat-263; a trilha
+//   antiga da telemedicina em `apps/evo-telemedicine/entitlement-audit` fica só leitura);
 // - super admin NÃO ignora entitlement (D6) — exceção só via `override_until`,
 //   temporária e auditada.
 export type TenantModuleStatus = "active" | "trial" | "suspended" | "cancelled";

package/fixtures/tenant-modules/is-module-active.parity.json

@@ -0,0 +1,364 @@
+{
+  "version": 1,
+  "description": "Golden de paridade de isModuleActive/hasModuleCapability (evo360-types, feat-263). Toda implementação (backend, web-app, Flutter) deve dar o mesmo resultado para cada caso, avaliado com `now`. capability_checks: capability -> esperado de hasModuleCapability (independe de estar ativo).",
+  "now": "2026-10-06T12:00:00.000Z",
+  "cases": [
+    {
+      "name": "ausente (null)",
+      "entitlement": null,
+      "expect_active": false
+    },
+    {
+      "name": "active + enabled, sem datas",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "capabilities": {
+          "recording": true,
+          "transcription": false,
+          "auto_admit": true
+        }
+      },
+      "expect_active": true,
+      "capability_checks": {
+        "recording": true,
+        "transcription": false,
+        "auto_admit": true,
+        "inexistente": false
+      }
+    },
+    {
+      "name": "enabled=false",
+      "entitlement": {
+        "status": "active",
+        "enabled": false,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "enabled ausente",
+      "entitlement": {
+        "status": "active",
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "suspended",
+      "entitlement": {
+        "status": "suspended",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "cancelled",
+      "entitlement": {
+        "status": "cancelled",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "status desconhecido",
+      "entitlement": {
+        "status": "pending",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "trial válido (expires ISO futuro)",
+      "entitlement": {
+        "status": "trial",
+        "enabled": true,
+        "source": "trial",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": "2026-11-05T12:00:00.000Z"
+      },
+      "expect_active": true
+    },
+    {
+      "name": "trial vencido (expires ISO passado)",
+      "entitlement": {
+        "status": "trial",
+        "enabled": true,
+        "source": "trial",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": "2026-09-06T12:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "trial sem expires_at",
+      "entitlement": {
+        "status": "trial",
+        "enabled": true,
+        "source": "trial",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": null
+      },
+      "expect_active": true
+    },
+    {
+      "name": "active com expires_at passado",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": "2026-09-06T12:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "active com expires_at == now (vence no instante)",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": "2026-10-06T12:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "effective_at futuro",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "effective_at": "2026-11-05T12:00:00.000Z"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "effective_at passado",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "effective_at": "2026-09-06T12:00:00.000Z"
+      },
+      "expect_active": true
+    },
+    {
+      "name": "override futuro com override_by (cancelled)",
+      "entitlement": {
+        "status": "cancelled",
+        "enabled": false,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "override_until": "2026-11-05T12:00:00.000Z",
+        "override_by": "ops@hubmedica"
+      },
+      "expect_active": true
+    },
+    {
+      "name": "override futuro SEM override_by",
+      "entitlement": {
+        "status": "cancelled",
+        "enabled": false,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "override_until": "2026-11-05T12:00:00.000Z",
+        "override_by": null
+      },
+      "expect_active": false
+    },
+    {
+      "name": "override vencido com override_by",
+      "entitlement": {
+        "status": "suspended",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "override_until": "2026-09-06T12:00:00.000Z",
+        "override_by": "ops@hubmedica"
+      },
+      "expect_active": false
+    },
+    {
+      "name": "override futuro libera trial vencido",
+      "entitlement": {
+        "status": "trial",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": "2026-09-06T12:00:00.000Z",
+        "override_until": "2026-11-05T12:00:00.000Z",
+        "override_by": "ops"
+      },
+      "expect_active": true
+    },
+    {
+      "name": "datas como epoch ms: expires futuro",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": 1793880000000
+      },
+      "expect_active": true
+    },
+    {
+      "name": "datas como epoch ms: expires passado",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": 1788696000000
+      },
+      "expect_active": false
+    },
+    {
+      "name": "datas como Timestamp serializado {_seconds}: expires passado",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": {
+          "_seconds": 1788696000,
+          "_nanoseconds": 0
+        }
+      },
+      "expect_active": false
+    },
+    {
+      "name": "datas como Timestamp serializado {seconds}: expires futuro",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": {
+          "seconds": 1793880000,
+          "nanoseconds": 0
+        }
+      },
+      "expect_active": true
+    },
+    {
+      "name": "datas como Timestamp serializado: override futuro",
+      "entitlement": {
+        "status": "cancelled",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "override_until": {
+          "_seconds": 1793880000,
+          "_nanoseconds": 0
+        },
+        "override_by": "ops"
+      },
+      "expect_active": true
+    },
+    {
+      "name": "data inválida equivale a ausente",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "expires_at": "not-a-date"
+      },
+      "expect_active": true
+    },
+    {
+      "name": "capabilities: só o booleano true conta",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "capabilities": {
+          "a": true,
+          "b": "true",
+          "c": 1,
+          "d": false,
+          "e": 0
+        }
+      },
+      "expect_active": true,
+      "capability_checks": {
+        "a": true,
+        "b": false,
+        "c": false,
+        "d": false,
+        "e": false,
+        "ausente": false
+      }
+    },
+    {
+      "name": "capabilities ausentes",
+      "entitlement": {
+        "status": "active",
+        "enabled": true,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z"
+      },
+      "expect_active": true,
+      "capability_checks": {
+        "recording": false
+      }
+    },
+    {
+      "name": "capability true com módulo inativo continua true (não implica ativo)",
+      "entitlement": {
+        "status": "active",
+        "enabled": false,
+        "source": "contract",
+        "version": 1,
+        "updated_at": "2026-10-01T00:00:00.000Z",
+        "capabilities": {
+          "recording": true
+        }
+      },
+      "expect_active": false,
+      "capability_checks": {
+        "recording": true
+      }
+    }
+  ]
+}

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "evo360-types",
-  "version": "1.3.656",
+  "version": "1.3.662",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "fixtures"
   ],
   "scripts": {
     "prebuild": "node scripts/bump-version.cjs",
@@ -17,7 +18,8 @@
     "bump:minor": "node scripts/bump-version.cjs minor",
     "bump:major": "node scripts/bump-version.cjs major",
     "deploy": "bash scripts/deploy.sh",
-    "push-tags": "bash scripts/push-tags.sh"
+    "push-tags": "bash scripts/push-tags.sh",
+    "test": "vitest run"
   },
   "homepage": "https://www.hubmedica.com.br",
   "repository": {
@@ -34,6 +36,7 @@
     "copyfiles": "^2.4.1",
     "rimraf": "^6.0.1",
     "semver": "^7.7.2",
-    "typescript": "~5.8.3"
+    "typescript": "~5.8.3",
+    "vitest": "^4.1.11"
   }
 }