evo360-types 1.3.438 → 1.3.444

package/dist/apps/evo-med/calendar/zod-schemas.js

@@ -7,29 +7,75 @@ const zod_schemas_2 = require("../people/zod-schemas");
 const zod_schemas_3 = require("../../evo-integrations/zod-schemas");
 // ----- Notification config (feat-048) — molde do `sync_config`: estruturado +
 // `.passthrough()` p/ tolerar campos futuros sem republish.
+//
+// Todo campo opcional aqui é `.nullable()`: o editor do FE materializa "não
+// escolhido" como `null` explícito (`department_id: wa.department_id ?? null` em
+// `utils/calendarNotificationConfig.ts`), e `.passthrough()` NÃO cobre isso —
+// ele só tolera chaves não declaradas, não valor null em chave declarada. Sem
+// `.nullable()` o doc inteiro do calendário reprova, e quem usa `parseDoc`
+// estrito (ex.: AppointmentRouterDialog) fica sem calendário e não renderiza.
 const zNotificationWhatsappConfigSchema = zod_1.z
     .object({
     enabled: zod_1.z.boolean(),
-    channel_id: zod_1.z.string().min(1).max(60).optional(),
-    department_id: zod_1.z.string().min(1).max(60).optional(),
-    reminder_template_id: zod_1.z.string().min(1).max(120).optional(),
-    on_confirm_quick_reply_id: zod_1.z.string().min(1).max(120).optional(),
-    on_reschedule_quick_reply_id: zod_1.z.string().min(1).max(120).optional(),
+    channel_id: zod_1.z.string().min(1).max(60).nullable().optional(),
+    department_id: zod_1.z.string().min(1).max(60).nullable().optional(),
+    reminder_template_id: zod_1.z.string().min(1).max(120).nullable().optional(),
+    on_confirm_quick_reply_id: zod_1.z.string().min(1).max(120).nullable().optional(),
+    on_reschedule_quick_reply_id: zod_1.z
+        .string()
+        .min(1)
+        .max(120)
+        .nullable()
+        .optional(),
 })
     .passthrough();
 const zNotificationEmailConfigSchema = zod_1.z
     .object({
     enabled: zod_1.z.boolean(),
-    channel_id: zod_1.z.string().min(1).max(60).optional(),
-    reminder_template_id: zod_1.z.string().min(1).max(120).optional(),
-    on_confirm_template_id: zod_1.z.string().min(1).max(120).optional(),
-    on_reschedule_template_id: zod_1.z.string().min(1).max(120).optional(),
+    channel_id: zod_1.z.string().min(1).max(60).nullable().optional(),
+    reminder_template_id: zod_1.z.string().min(1).max(120).nullable().optional(),
+    on_confirm_template_id: zod_1.z.string().min(1).max(120).nullable().optional(),
+    on_reschedule_template_id: zod_1.z.string().min(1).max(120).nullable().optional(),
+})
+    .passthrough();
+// feat-092: mapa GENÉRICO de configs de notificação (config × canal × template).
+// Tudo opcional + `.passthrough()`; SEM `.default()` (o data-validator grava só as
+// chaves do input → um default não persistiria). Chave/canal são strings abertas
+// (z.record) ⇒ extensível a novos eventos/canais sem republish.
+const zNotificationCtaSchema = zod_1.z
+    .object({
+    key: zod_1.z.string().min(1).max(60),
+    template_id: zod_1.z.string().min(1).max(120),
+    template_type: zod_1.z.string().min(1).max(40).optional(),
+})
+    .passthrough();
+const zNotificationChannelEntrySchema = zod_1.z
+    .object({
+    enabled: zod_1.z.boolean().nullable().optional(),
+    channel_id: zod_1.z.string().min(1).max(60).nullable().optional(),
+    department_id: zod_1.z.string().min(1).max(60).nullable().optional(),
+    template_id: zod_1.z.string().min(1).max(120).nullable().optional(),
+    template_type: zod_1.z.string().min(1).max(40).nullable().optional(),
+    ctas: zod_1.z.array(zNotificationCtaSchema).nullable().optional(),
+})
+    .passthrough();
+const zNotificationEntrySchema = zod_1.z
+    .object({
+    enabled: zod_1.z.boolean().nullable().optional(),
+    channels: zod_1.z
+        .record(zod_1.z.string(), zNotificationChannelEntrySchema)
+        .nullable()
+        .optional(),
 })
     .passthrough();
 exports.zMedCalendarNotificationConfigSchema = zod_1.z
     .object({
-    whatsapp: zNotificationWhatsappConfigSchema.optional(),
-    email: zNotificationEmailConfigSchema.optional(),
+    whatsapp: zNotificationWhatsappConfigSchema.nullable().optional(),
+    email: zNotificationEmailConfigSchema.nullable().optional(),
+    configs: zod_1.z
+        .record(zod_1.z.string(), zNotificationEntrySchema)
+        .nullable()
+        .optional(),
 })
     .passthrough();
 exports.zMedCalendarSchema = zod_schemas_1.zFireDocSchema

package/dist/apps/evo-med/calendar/zod-schemas.ts

@@ -5,31 +5,80 @@ import { zMedCalendarIntegrationSchema } from "../../evo-integrations/zod-schema
 
 // ----- Notification config (feat-048) — molde do `sync_config`: estruturado +
 // `.passthrough()` p/ tolerar campos futuros sem republish.
+//
+// Todo campo opcional aqui é `.nullable()`: o editor do FE materializa "não
+// escolhido" como `null` explícito (`department_id: wa.department_id ?? null` em
+// `utils/calendarNotificationConfig.ts`), e `.passthrough()` NÃO cobre isso —
+// ele só tolera chaves não declaradas, não valor null em chave declarada. Sem
+// `.nullable()` o doc inteiro do calendário reprova, e quem usa `parseDoc`
+// estrito (ex.: AppointmentRouterDialog) fica sem calendário e não renderiza.
 const zNotificationWhatsappConfigSchema = z
   .object({
     enabled: z.boolean(),
-    channel_id: z.string().min(1).max(60).optional(),
-    department_id: z.string().min(1).max(60).optional(),
-    reminder_template_id: z.string().min(1).max(120).optional(),
-    on_confirm_quick_reply_id: z.string().min(1).max(120).optional(),
-    on_reschedule_quick_reply_id: z.string().min(1).max(120).optional(),
+    channel_id: z.string().min(1).max(60).nullable().optional(),
+    department_id: z.string().min(1).max(60).nullable().optional(),
+    reminder_template_id: z.string().min(1).max(120).nullable().optional(),
+    on_confirm_quick_reply_id: z.string().min(1).max(120).nullable().optional(),
+    on_reschedule_quick_reply_id: z
+      .string()
+      .min(1)
+      .max(120)
+      .nullable()
+      .optional(),
   })
   .passthrough();
 
 const zNotificationEmailConfigSchema = z
   .object({
     enabled: z.boolean(),
-    channel_id: z.string().min(1).max(60).optional(),
-    reminder_template_id: z.string().min(1).max(120).optional(),
-    on_confirm_template_id: z.string().min(1).max(120).optional(),
-    on_reschedule_template_id: z.string().min(1).max(120).optional(),
+    channel_id: z.string().min(1).max(60).nullable().optional(),
+    reminder_template_id: z.string().min(1).max(120).nullable().optional(),
+    on_confirm_template_id: z.string().min(1).max(120).nullable().optional(),
+    on_reschedule_template_id: z.string().min(1).max(120).nullable().optional(),
+  })
+  .passthrough();
+
+// feat-092: mapa GENÉRICO de configs de notificação (config × canal × template).
+// Tudo opcional + `.passthrough()`; SEM `.default()` (o data-validator grava só as
+// chaves do input → um default não persistiria). Chave/canal são strings abertas
+// (z.record) ⇒ extensível a novos eventos/canais sem republish.
+const zNotificationCtaSchema = z
+  .object({
+    key: z.string().min(1).max(60),
+    template_id: z.string().min(1).max(120),
+    template_type: z.string().min(1).max(40).optional(),
+  })
+  .passthrough();
+
+const zNotificationChannelEntrySchema = z
+  .object({
+    enabled: z.boolean().nullable().optional(),
+    channel_id: z.string().min(1).max(60).nullable().optional(),
+    department_id: z.string().min(1).max(60).nullable().optional(),
+    template_id: z.string().min(1).max(120).nullable().optional(),
+    template_type: z.string().min(1).max(40).nullable().optional(),
+    ctas: z.array(zNotificationCtaSchema).nullable().optional(),
+  })
+  .passthrough();
+
+const zNotificationEntrySchema = z
+  .object({
+    enabled: z.boolean().nullable().optional(),
+    channels: z
+      .record(z.string(), zNotificationChannelEntrySchema)
+      .nullable()
+      .optional(),
   })
   .passthrough();
 
 export const zMedCalendarNotificationConfigSchema = z
   .object({
-    whatsapp: zNotificationWhatsappConfigSchema.optional(),
-    email: zNotificationEmailConfigSchema.optional(),
+    whatsapp: zNotificationWhatsappConfigSchema.nullable().optional(),
+    email: zNotificationEmailConfigSchema.nullable().optional(),
+    configs: z
+      .record(z.string(), zNotificationEntrySchema)
+      .nullable()
+      .optional(),
   })
   .passthrough();
 

package/dist/types/evo-med/calendar/index.d.ts

@@ -15,28 +15,84 @@ export interface IMedCalendarNotificationConfig {
     whatsapp?: {
         enabled: boolean;
         /** Doc id do canal evo-chat/whatsapp por onde o lembrete sai. */
-        channel_id?: string;
-        department_id?: string;
+        channel_id?: string | null;
+        department_id?: string | null;
         /** HSM que carrega o texto do lembrete (a Meta guarda o corpo; nós só passamos as variáveis). */
-        reminder_template_id?: string;
+        reminder_template_id?: string | null;
         /** Quick-reply a responder quando o paciente confirmar (consumido pela feat-056). */
-        on_confirm_quick_reply_id?: string;
+        on_confirm_quick_reply_id?: string | null;
         /** Quick-reply a responder quando o paciente pedir remarcação (feat-056). */
-        on_reschedule_quick_reply_id?: string;
-    };
+        on_reschedule_quick_reply_id?: string | null;
+    } | null;
     /** E-mail: envia o lembrete via template de e-mail (corpo renderizado pelo engine). */
     email?: {
         enabled: boolean;
         /** Doc id do canal de e-mail. */
-        channel_id?: string;
+        channel_id?: string | null;
         /** Template do e-mail de lembrete. */
-        reminder_template_id?: string;
+        reminder_template_id?: string | null;
         /** Template do e-mail enviado após confirmação (feat-056). */
-        on_confirm_template_id?: string;
+        on_confirm_template_id?: string | null;
         /** Template do e-mail enviado após pedido de remarcação (feat-056). */
-        on_reschedule_template_id?: string;
-    };
+        on_reschedule_template_id?: string | null;
+    } | null;
+    /**
+     * Mapa GENÉRICO de configs de notificação (feat-092). A chave (`configKey`) é
+     * livre; o SIGNIFICADO (`appointment_reminder` | `appointment_created` | …) mora
+     * em quem CONSULTA, não no schema. Não envia nada por si só — é referência para
+     * agentes que, conforme suas políticas de execução, decidem enviar. Ausência ou
+     * config incompleta ⇒ o leitor não faz nada. Coexiste com os blocos `whatsapp`/
+     * `email` legados (que os consumidores atuais ainda leem).
+     */
+    configs?: {
+        [configKey: string]: IMedCalendarNotificationEntry;
+    } | null;
+}
+/** Uma config de notificação (feat-092): um evento/momento × seus canais. */
+export interface IMedCalendarNotificationEntry {
+    /** Opt-in do config inteiro. Ausente/false ⇒ leitor ignora. */
+    enabled?: boolean | null;
+    /** Canais habilitados, keyed por tipo ('whatsapp' | 'email' | futuro). */
+    channels?: {
+        [channelKind: string]: IMedCalendarNotificationChannelEntry;
+    } | null;
 }
+/** Config de um canal dentro de um config de notificação (feat-092). */
+export interface IMedCalendarNotificationChannelEntry {
+    /** Opt-in do canal. Ausente/false ⇒ leitor ignora este canal. */
+    enabled?: boolean | null;
+    /** Doc id do canal por onde a mensagem sai. Sem herança — usa o que estiver aqui. */
+    channel_id?: string | null;
+    /** Departamento que recebe/roteia (opcional). */
+    department_id?: string | null;
+    /** Template principal da mensagem (HSM name no WA / template_id lógico no email). */
+    template_id?: string | null;
+    /** Tipo do template principal: 'hsm' | 'email' | … O leitor pode inferir pelo canal. */
+    template_type?: string | null;
+    /** Botões/ações da mensagem → artefato de resposta de cada um. */
+    ctas?: IMedCalendarNotificationCta[] | null;
+}
+/** Um CTA (botão/ação) e o artefato enviado quando o paciente o aciona (feat-092). */
+export interface IMedCalendarNotificationCta {
+    /** Identificador livre da ação: 'confirm' | 'reschedule' | 'cancel' | … */
+    key: string;
+    /** Template/quick-reply de resposta ao acionar o CTA. */
+    template_id: string;
+    /** Tipo do artefato: 'quick_reply' | 'hsm' | 'email' | … */
+    template_type?: string;
+}
+/**
+ * Chaves canônicas conhecidas de `configs` (feat-092) — SÓ referência para
+ * autocomplete/UI. O schema NÃO restringe (a chave é string aberta) e os leitores
+ * ignoram chaves desconhecidas.
+ */
+export declare const MedCalendarNotificationConfigKeys: {
+    readonly AppointmentReminder: "appointment_reminder";
+    readonly AppointmentCreated: "appointment_created";
+    readonly AppointmentRescheduled: "appointment_rescheduled";
+    readonly AppointmentCancelled: "appointment_cancelled";
+};
+export type MedCalendarNotificationConfigKey = (typeof MedCalendarNotificationConfigKeys)[keyof typeof MedCalendarNotificationConfigKeys];
 export interface IMedCalendar extends IFireDoc {
     calendarId: string;
     color?: string;

package/dist/types/evo-med/calendar/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EvoMedCalendarPermissions = void 0;
+exports.MedCalendarNotificationConfigKeys = exports.EvoMedCalendarPermissions = void 0;
 __exportStar(require("../../evo-people/fb_collections"), exports);
 // Permissões para o calendário
 exports.EvoMedCalendarPermissions = {
@@ -24,3 +24,14 @@ exports.EvoMedCalendarPermissions = {
     Update: "evo_med_calendar_write",
     Delete: "evo_med_calendar_write",
 };
+/**
+ * Chaves canônicas conhecidas de `configs` (feat-092) — SÓ referência para
+ * autocomplete/UI. O schema NÃO restringe (a chave é string aberta) e os leitores
+ * ignoram chaves desconhecidas.
+ */
+exports.MedCalendarNotificationConfigKeys = {
+    AppointmentReminder: "appointment_reminder",
+    AppointmentCreated: "appointment_created",
+    AppointmentRescheduled: "appointment_rescheduled",
+    AppointmentCancelled: "appointment_cancelled",
+};

package/dist/types/evo-med/calendar/index.ts

@@ -20,34 +20,100 @@ export type EvoMedCalendarPermissions =
 // e, futuramente, pela feat-056 (resposta ao confirmar/remarcar). Molde do bloco
 // `integration.sync_config`: estruturado, validado por zod, com `.passthrough()`
 // para tolerar campos futuros sem republish.
+//
+// `| null` em todo campo opcional NÃO é decorativo: o editor do FE grava "não
+// escolhido" como `null` explícito (ver `utils/calendarNotificationConfig.ts`),
+// e `.passthrough()` não cobre valor null em chave declarada — só chave
+// desconhecida. Sem isso o doc do calendário inteiro reprova no zod.
 export interface IMedCalendarNotificationConfig {
   /** WhatsApp: envia o lembrete via HSM + botões de confirmar/remarcar. */
   whatsapp?: {
     enabled: boolean;
     /** Doc id do canal evo-chat/whatsapp por onde o lembrete sai. */
-    channel_id?: string;
-    department_id?: string;
+    channel_id?: string | null;
+    department_id?: string | null;
     /** HSM que carrega o texto do lembrete (a Meta guarda o corpo; nós só passamos as variáveis). */
-    reminder_template_id?: string;
+    reminder_template_id?: string | null;
     /** Quick-reply a responder quando o paciente confirmar (consumido pela feat-056). */
-    on_confirm_quick_reply_id?: string;
+    on_confirm_quick_reply_id?: string | null;
     /** Quick-reply a responder quando o paciente pedir remarcação (feat-056). */
-    on_reschedule_quick_reply_id?: string;
-  };
+    on_reschedule_quick_reply_id?: string | null;
+  } | null;
   /** E-mail: envia o lembrete via template de e-mail (corpo renderizado pelo engine). */
   email?: {
     enabled: boolean;
     /** Doc id do canal de e-mail. */
-    channel_id?: string;
+    channel_id?: string | null;
     /** Template do e-mail de lembrete. */
-    reminder_template_id?: string;
+    reminder_template_id?: string | null;
     /** Template do e-mail enviado após confirmação (feat-056). */
-    on_confirm_template_id?: string;
+    on_confirm_template_id?: string | null;
     /** Template do e-mail enviado após pedido de remarcação (feat-056). */
-    on_reschedule_template_id?: string;
-  };
+    on_reschedule_template_id?: string | null;
+  } | null;
+
+  /**
+   * Mapa GENÉRICO de configs de notificação (feat-092). A chave (`configKey`) é
+   * livre; o SIGNIFICADO (`appointment_reminder` | `appointment_created` | …) mora
+   * em quem CONSULTA, não no schema. Não envia nada por si só — é referência para
+   * agentes que, conforme suas políticas de execução, decidem enviar. Ausência ou
+   * config incompleta ⇒ o leitor não faz nada. Coexiste com os blocos `whatsapp`/
+   * `email` legados (que os consumidores atuais ainda leem).
+   */
+  configs?: { [configKey: string]: IMedCalendarNotificationEntry } | null;
+}
+
+/** Uma config de notificação (feat-092): um evento/momento × seus canais. */
+export interface IMedCalendarNotificationEntry {
+  /** Opt-in do config inteiro. Ausente/false ⇒ leitor ignora. */
+  enabled?: boolean | null;
+  /** Canais habilitados, keyed por tipo ('whatsapp' | 'email' | futuro). */
+  channels?: {
+    [channelKind: string]: IMedCalendarNotificationChannelEntry;
+  } | null;
+}
+
+/** Config de um canal dentro de um config de notificação (feat-092). */
+export interface IMedCalendarNotificationChannelEntry {
+  /** Opt-in do canal. Ausente/false ⇒ leitor ignora este canal. */
+  enabled?: boolean | null;
+  /** Doc id do canal por onde a mensagem sai. Sem herança — usa o que estiver aqui. */
+  channel_id?: string | null;
+  /** Departamento que recebe/roteia (opcional). */
+  department_id?: string | null;
+  /** Template principal da mensagem (HSM name no WA / template_id lógico no email). */
+  template_id?: string | null;
+  /** Tipo do template principal: 'hsm' | 'email' | … O leitor pode inferir pelo canal. */
+  template_type?: string | null;
+  /** Botões/ações da mensagem → artefato de resposta de cada um. */
+  ctas?: IMedCalendarNotificationCta[] | null;
+}
+
+/** Um CTA (botão/ação) e o artefato enviado quando o paciente o aciona (feat-092). */
+export interface IMedCalendarNotificationCta {
+  /** Identificador livre da ação: 'confirm' | 'reschedule' | 'cancel' | … */
+  key: string;
+  /** Template/quick-reply de resposta ao acionar o CTA. */
+  template_id: string;
+  /** Tipo do artefato: 'quick_reply' | 'hsm' | 'email' | … */
+  template_type?: string;
 }
 
+/**
+ * Chaves canônicas conhecidas de `configs` (feat-092) — SÓ referência para
+ * autocomplete/UI. O schema NÃO restringe (a chave é string aberta) e os leitores
+ * ignoram chaves desconhecidas.
+ */
+export const MedCalendarNotificationConfigKeys = {
+  AppointmentReminder: "appointment_reminder",
+  AppointmentCreated: "appointment_created",
+  AppointmentRescheduled: "appointment_rescheduled",
+  AppointmentCancelled: "appointment_cancelled",
+} as const;
+
+export type MedCalendarNotificationConfigKey =
+  (typeof MedCalendarNotificationConfigKeys)[keyof typeof MedCalendarNotificationConfigKeys];
+
 // ----- MedCalendarTypes
 export interface IMedCalendar extends IFireDoc {
   calendarId: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "evo360-types",
-  "version": "1.3.438",
+  "version": "1.3.444",
   "description": "HREVO360 Shared Types",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",