evo360-types 1.3.656 → 1.3.662

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/apps/evo-task/zod-schemas.d.ts

@@ -10,7 +10,36 @@ export declare const zTaskDedupScopeSchema: z.ZodEnum<["per_recipient", "per_rec
 export declare const zTaskDedupWindowSchema: z.ZodEnum<["same_day", "n_hours", "custom"]>;
 export declare const zExternalObjectTypeSchema: z.ZodEnum<["crm_lead", "med_patient", "med_professional", "med_appointment", "chat_contact", "evo_task", "campaign", "nex_billing", "nex_contract", "nex_customer", "teleconsultation"]>;
 export declare const zTaskExternalObjectTypeSchema: z.ZodEnum<["crm_lead", "med_patient", "med_professional", "med_appointment", "chat_contact", "evo_task", "campaign", "nex_billing", "nex_contract", "nex_customer", "teleconsultation"]>;
-export declare const zTaskExecutionStatusSchema: z.ZodEnum<["success", "error", "retry"]>;
+export declare const zTaskExecutionStatusSchema: z.ZodEnum<["success", "error", "retry", "suppressed"]>;
+export declare const zTaskOutcomeClassSchema: z.ZodEnum<["legitimate", "defect"]>;
+export declare const zTaskOutcomeSchema: z.ZodObject<{
+    class: z.ZodEnum<["legitimate", "defect"]>;
+    reason: z.ZodString;
+    label: z.ZodString;
+    message: z.ZodString;
+    action_hint: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    at: z.ZodDate;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    class: z.ZodEnum<["legitimate", "defect"]>;
+    reason: z.ZodString;
+    label: z.ZodString;
+    message: z.ZodString;
+    action_hint: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    at: z.ZodDate;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    class: z.ZodEnum<["legitimate", "defect"]>;
+    reason: z.ZodString;
+    label: z.ZodString;
+    message: z.ZodString;
+    action_hint: z.ZodOptional<z.ZodString>;
+    scope: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    at: z.ZodDate;
+}, z.ZodTypeAny, "passthrough">>;
 export declare const zExternalOwnerSystemSchema: z.ZodEnum<["nexus"]>;
 export declare const zExternalLinkKindSchema: z.ZodEnum<["identity", "representation"]>;
 export declare const zExternalLinkStatusSchema: z.ZodEnum<["suggested", "confirmed", "rejected"]>;
@@ -1106,6 +1135,34 @@ export declare const zTaskSchema: z.ZodObject<{
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         idempotency_key: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>;
+    outcome: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">>>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -1619,6 +1676,34 @@ export declare const zTaskSchema: z.ZodObject<{
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         idempotency_key: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>;
+    outcome: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">>>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -2132,6 +2217,34 @@ export declare const zTaskSchema: z.ZodObject<{
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
         idempotency_key: z.ZodOptional<z.ZodString>;
     }, z.ZodTypeAny, "passthrough">>>;
+    outcome: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">>>>;
 }, z.ZodTypeAny, "passthrough">>;
 export declare const zTaskCommentAuthorSchema: z.ZodObject<{
     name: z.ZodString;
@@ -2248,7 +2361,7 @@ export declare const zTaskExecutionSchema: z.ZodObject<{
     taskId: z.ZodString;
     handler: z.ZodEnum<["notifications", "ai_agent", "invoices", "webhook", "custom", "lead_reactivation", "appointment_action", "appointment_reminder", "appointment_confirmation", "appointment_post_consultation", "evo-integrations.sync-run", "lead_form_capture", "campaign.materialize", "campaign.dispatch_batch", "telemedicine_join_reminder", "appointment_invoice"]>;
     kind: z.ZodString;
-    status: z.ZodEnum<["success", "error", "retry"]>;
+    status: z.ZodEnum<["success", "error", "retry", "suppressed"]>;
     attempt: z.ZodNumber;
     started_at: z.ZodDate;
     completed_at: z.ZodOptional<z.ZodDate>;
@@ -2266,6 +2379,34 @@ export declare const zTaskExecutionSchema: z.ZodObject<{
         code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    outcome: z.ZodOptional<z.ZodObject<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">>>;
     provider: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         message_id: z.ZodOptional<z.ZodString>;
@@ -2288,7 +2429,7 @@ export declare const zTaskExecutionSchema: z.ZodObject<{
     taskId: z.ZodString;
     handler: z.ZodEnum<["notifications", "ai_agent", "invoices", "webhook", "custom", "lead_reactivation", "appointment_action", "appointment_reminder", "appointment_confirmation", "appointment_post_consultation", "evo-integrations.sync-run", "lead_form_capture", "campaign.materialize", "campaign.dispatch_batch", "telemedicine_join_reminder", "appointment_invoice"]>;
     kind: z.ZodString;
-    status: z.ZodEnum<["success", "error", "retry"]>;
+    status: z.ZodEnum<["success", "error", "retry", "suppressed"]>;
     attempt: z.ZodNumber;
     started_at: z.ZodDate;
     completed_at: z.ZodOptional<z.ZodDate>;
@@ -2306,6 +2447,34 @@ export declare const zTaskExecutionSchema: z.ZodObject<{
         code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    outcome: z.ZodOptional<z.ZodObject<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">>>;
     provider: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         message_id: z.ZodOptional<z.ZodString>;
@@ -2328,7 +2497,7 @@ export declare const zTaskExecutionSchema: z.ZodObject<{
     taskId: z.ZodString;
     handler: z.ZodEnum<["notifications", "ai_agent", "invoices", "webhook", "custom", "lead_reactivation", "appointment_action", "appointment_reminder", "appointment_confirmation", "appointment_post_consultation", "evo-integrations.sync-run", "lead_form_capture", "campaign.materialize", "campaign.dispatch_batch", "telemedicine_join_reminder", "appointment_invoice"]>;
     kind: z.ZodString;
-    status: z.ZodEnum<["success", "error", "retry"]>;
+    status: z.ZodEnum<["success", "error", "retry", "suppressed"]>;
     attempt: z.ZodNumber;
     started_at: z.ZodDate;
     completed_at: z.ZodOptional<z.ZodDate>;
@@ -2346,6 +2515,34 @@ export declare const zTaskExecutionSchema: z.ZodObject<{
         code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
         details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    outcome: z.ZodOptional<z.ZodObject<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        class: z.ZodEnum<["legitimate", "defect"]>;
+        reason: z.ZodString;
+        label: z.ZodString;
+        message: z.ZodString;
+        action_hint: z.ZodOptional<z.ZodString>;
+        scope: z.ZodOptional<z.ZodString>;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        at: z.ZodDate;
+    }, z.ZodTypeAny, "passthrough">>>;
     provider: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         message_id: z.ZodOptional<z.ZodString>;

package/dist/apps/evo-task/zod-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zTaskLogSchema = exports.zTaskExecutionSchema = exports.zTaskExecutionProviderSchema = exports.zTaskExecutionErrorSchema = exports.zTaskCommentSchema = exports.zTaskCommentAuthorSchema = exports.zTaskSchema = exports.zTaskCreatorSchema = exports.zTaskOnFailureSchema = exports.zTaskAutoSpecSchema = exports.zTaskDedupSchema = exports.zTaskRetryPolicySchema = exports.zTaskRunnerStateSchema = exports.zTaskLockSchema = exports.zTaskUserAssigneeSchema = exports.zTaskScheduleSchema = exports.zTaskExternalLinkSchema = exports.zExternalLinkSchema = exports.zExternalLinkRelationSchema = exports.zLinkRelationRoleSchema = exports.zLinkRelationPairSchema = exports.zExternalLinkSourceSchema = exports.zExternalLinkStatusSchema = exports.zExternalLinkKindSchema = exports.zExternalOwnerSystemSchema = exports.zTaskExecutionStatusSchema = exports.zTaskExternalObjectTypeSchema = exports.zExternalObjectTypeSchema = exports.zTaskDedupWindowSchema = exports.zTaskDedupScopeSchema = exports.zTaskRetryStrategySchema = exports.zTaskAutoHandlerSchema = exports.zTaskModeSchema = exports.zTaskSourceSchema = exports.zTaskPrioritySchema = exports.zTaskStatusSchema = exports.zTaskActionSchema = void 0;
+exports.zTaskLogSchema = exports.zTaskExecutionSchema = exports.zTaskExecutionProviderSchema = exports.zTaskExecutionErrorSchema = exports.zTaskCommentSchema = exports.zTaskCommentAuthorSchema = exports.zTaskSchema = exports.zTaskCreatorSchema = exports.zTaskOnFailureSchema = exports.zTaskAutoSpecSchema = exports.zTaskDedupSchema = exports.zTaskRetryPolicySchema = exports.zTaskRunnerStateSchema = exports.zTaskLockSchema = exports.zTaskUserAssigneeSchema = exports.zTaskScheduleSchema = exports.zTaskExternalLinkSchema = exports.zExternalLinkSchema = exports.zExternalLinkRelationSchema = exports.zLinkRelationRoleSchema = exports.zLinkRelationPairSchema = exports.zExternalLinkSourceSchema = exports.zExternalLinkStatusSchema = exports.zExternalLinkKindSchema = exports.zExternalOwnerSystemSchema = exports.zTaskOutcomeSchema = exports.zTaskOutcomeClassSchema = exports.zTaskExecutionStatusSchema = exports.zTaskExternalObjectTypeSchema = exports.zExternalObjectTypeSchema = exports.zTaskDedupWindowSchema = exports.zTaskDedupScopeSchema = exports.zTaskRetryStrategySchema = exports.zTaskAutoHandlerSchema = exports.zTaskModeSchema = exports.zTaskSourceSchema = exports.zTaskPrioritySchema = exports.zTaskStatusSchema = exports.zTaskActionSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 exports.zTaskActionSchema = zod_1.z.enum([
@@ -105,7 +105,25 @@ exports.zExternalObjectTypeSchema = zod_1.z.enum([
 ]);
 // Backward compatibility alias
 exports.zTaskExternalObjectTypeSchema = exports.zExternalObjectTypeSchema;
-exports.zTaskExecutionStatusSchema = zod_1.z.enum(["success", "error", "retry"]);
+exports.zTaskExecutionStatusSchema = zod_1.z.enum([
+    "success",
+    "error",
+    "retry",
+    "suppressed",
+]);
+exports.zTaskOutcomeClassSchema = zod_1.z.enum(["legitimate", "defect"]);
+exports.zTaskOutcomeSchema = zod_1.z
+    .object({
+    class: exports.zTaskOutcomeClassSchema,
+    reason: zod_1.z.string(),
+    label: zod_1.z.string(),
+    message: zod_1.z.string(),
+    action_hint: zod_1.z.string().optional(),
+    scope: zod_1.z.string().optional(),
+    details: zod_1.z.record(zod_1.z.unknown()).optional(),
+    at: zod_1.z.coerce.date(),
+})
+    .passthrough();
 // Schema para IExternalLink (promoted to shared, renamed from Task-specific)
 exports.zExternalOwnerSystemSchema = zod_1.z.enum(["nexus"]);
 // feat-193 — contrato do vínculo lead/paciente (espelha os enums de
@@ -319,6 +337,7 @@ exports.zTaskSchema = zod_schemas_1.zFireDocSchema
     on_failure: exports.zTaskOnFailureSchema.optional(), // for auto tasks
     runner_state: exports.zTaskRunnerStateSchema.optional(), // for auto tasks (maintained by Task Runner)
     auto: exports.zTaskAutoSpecSchema.optional(), // for auto tasks (required when mode=auto)
+    outcome: exports.zTaskOutcomeSchema.nullable().optional(), // for auto tasks (suppressed | failed by defect)
 })
     .passthrough();
 // Schema para ITaskComment
@@ -360,6 +379,7 @@ exports.zTaskExecutionSchema = zod_schemas_1.zFireDocSchema
     completed_at: zod_1.z.coerce.date().optional(),
     result: zod_1.z.record(zod_1.z.unknown()).optional(),
     error: exports.zTaskExecutionErrorSchema.optional(),
+    outcome: exports.zTaskOutcomeSchema.optional(),
     provider: exports.zTaskExecutionProviderSchema.optional(),
 })
     .passthrough();

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

@@ -114,7 +114,27 @@ export const zExternalObjectTypeSchema = z.enum([
 // Backward compatibility alias
 export const zTaskExternalObjectTypeSchema = zExternalObjectTypeSchema;
 
-export const zTaskExecutionStatusSchema = z.enum(["success", "error", "retry"]);
+export const zTaskExecutionStatusSchema = z.enum([
+  "success",
+  "error",
+  "retry",
+  "suppressed",
+]);
+
+export const zTaskOutcomeClassSchema = z.enum(["legitimate", "defect"]);
+
+export const zTaskOutcomeSchema = z
+  .object({
+    class: zTaskOutcomeClassSchema,
+    reason: z.string(),
+    label: z.string(),
+    message: z.string(),
+    action_hint: z.string().optional(),
+    scope: z.string().optional(),
+    details: z.record(z.unknown()).optional(),
+    at: z.coerce.date(),
+  })
+  .passthrough();
 
 // Schema para IExternalLink (promoted to shared, renamed from Task-specific)
 export const zExternalOwnerSystemSchema = z.enum(["nexus"]);
@@ -352,6 +372,7 @@ export const zTaskSchema = zFireDocSchema
     on_failure: zTaskOnFailureSchema.optional(), // for auto tasks
     runner_state: zTaskRunnerStateSchema.optional(), // for auto tasks (maintained by Task Runner)
     auto: zTaskAutoSpecSchema.optional(), // for auto tasks (required when mode=auto)
+    outcome: zTaskOutcomeSchema.nullable().optional(), // for auto tasks (suppressed | failed by defect)
   })
   .passthrough();
 
@@ -398,6 +419,7 @@ export const zTaskExecutionSchema = zFireDocSchema
     completed_at: z.coerce.date().optional(),
     result: z.record(z.unknown()).optional(),
     error: zTaskExecutionErrorSchema.optional(),
+    outcome: zTaskOutcomeSchema.optional(),
     provider: zTaskExecutionProviderSchema.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[];