evo360-types 1.3.476 → 1.3.480

package/dist/apps/evo-med/appointment/zod-schemas.d.ts

@@ -633,6 +633,7 @@ export declare const zAppointmentSchema: z.ZodObject<{
     isDraft: z.ZodDefault<z.ZodBoolean>;
     draftExpirationMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status_external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
@@ -969,6 +970,7 @@ export declare const zAppointmentSchema: z.ZodObject<{
     isDraft: z.ZodDefault<z.ZodBoolean>;
     draftExpirationMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status_external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodString>;
@@ -1305,6 +1307,7 @@ export declare const zAppointmentSchema: z.ZodObject<{
     isDraft: z.ZodDefault<z.ZodBoolean>;
     draftExpirationMinutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status_external_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         color: z.ZodOptional<z.ZodString>;

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

@@ -202,6 +202,15 @@ exports.zAppointmentSchema = zod_schemas_1.zFireDocSchema
     draftExpirationMinutes: zod_1.z.number().nullable().optional(), // tempo em minutos para expiração do rascunho
     // ID externo da consulta
     external_id: zod_1.z.string().nullable().optional(),
+    // ID do STATUS na agenda externa de origem — algumas agendas identificam o
+    // status por id além do rótulo (`status`), e os workflows n8n usam esse id
+    // pra reescrever o agendamento sem resolver o rótulo de volta.
+    //
+    // `coerce` de propósito: agenda externa que devolve id NUMÉRICO é caso
+    // conhecido nesta base (quebrou o `patient.create` uma vez). Com `z.string()`
+    // puro, um `4` faria o write-through reprovar com `contract_violation`.
+    // Nullable/optional resolvem ANTES da coerção — `null` continua `null`.
+    status_external_id: zod_1.z.coerce.string().nullable().optional(),
     tags: zod_1.z.array(zod_schemas_1.zTagSchema).nullable().optional(),
 })
     .passthrough();

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

@@ -223,6 +223,16 @@ export const zAppointmentSchema = zFireDocSchema
     // ID externo da consulta
     external_id: z.string().nullable().optional(),
 
+    // ID do STATUS na agenda externa de origem — algumas agendas identificam o
+    // status por id além do rótulo (`status`), e os workflows n8n usam esse id
+    // pra reescrever o agendamento sem resolver o rótulo de volta.
+    //
+    // `coerce` de propósito: agenda externa que devolve id NUMÉRICO é caso
+    // conhecido nesta base (quebrou o `patient.create` uma vez). Com `z.string()`
+    // puro, um `4` faria o write-through reprovar com `contract_violation`.
+    // Nullable/optional resolvem ANTES da coerção — `null` continua `null`.
+    status_external_id: z.coerce.string().nullable().optional(),
+
     tags: z.array(zTagSchema).nullable().optional(),
   })
   .passthrough();

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

@@ -159,11 +159,50 @@ export interface ICampaignSentToday {
         email?: number;
     };
 }
+/**
+ * Where ONE channel stands in the dispatch queue (F3.3).
+ *
+ * The four pacing knobs are configured per channel, so the two channels advance through
+ * the audience at different speeds and each needs its own position. Both channels read
+ * the SAME queue (`dispatch_state == 'pending'` ordered by `__name__`); what separates
+ * them is the `startAfter` each one uses.
+ */
+export interface ICampaignDispatchChannelState {
+    /**
+     * Last recipient id this channel dispatched — the `startAfter` of its own page.
+     * A channel held back by its window or its daily limit simply does NOT advance this,
+     * which is what records the legs it still owes.
+     */
+    cursor_doc_id?: string | null;
+    /**
+     * Earliest instant this channel may dispatch again (its own `batch_interval_minutes`).
+     * This is the AUTHORITY on the channel's turn: the scheduled `campaign.dispatch_batch`
+     * task is only a wake-up call and grants no permission by itself, so a batch that fires
+     * early (the feat-080 sweep reviving a chain, say) re-reads this and defers.
+     * Firestore returns a Timestamp — `.toDate()` before comparing.
+     */
+    next_at?: Date | null;
+}
 export interface ICampaignDispatchState {
+    /**
+     * LEGACY (pre-F3.3): the single campaign-wide cursor. It no longer governs sending —
+     * `per_channel.{channel}.cursor_doc_id` does. It is still written, as the MINIMUM of
+     * the per-channel cursors, for two reasons: a campaign in flight when F3.3 deployed
+     * seeds both channels from it, and a rollback to the previous engine must resume
+     * BEHIND every channel rather than ahead of one (re-reading is inert — the send task
+     * is idempotent on `dedup_key` — whereas skipping loses a send silently).
+     * Do not read this to answer "how far has the campaign got": ask per channel.
+     */
     cursor_doc_id?: string | null;
     next_dispatch_task_id?: string | null;
     sent_today?: ICampaignSentToday;
     batches_dispatched?: number;
+    /** Per-channel queue position and turn (F3.3). Absent on a campaign that last ran
+     *  under the pre-F3.3 engine; each channel then falls back to `cursor_doc_id`. */
+    per_channel?: {
+        whatsapp?: ICampaignDispatchChannelState;
+        email?: ICampaignDispatchChannelState;
+    };
 }
 export type CampaignPrevalidationStatus = "approved" | "warnings" | "blocked";
 export interface ICampaignPrevalidation {

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

@@ -231,11 +231,51 @@ export interface ICampaignSentToday {
   };
 }
 
+/**
+ * Where ONE channel stands in the dispatch queue (F3.3).
+ *
+ * The four pacing knobs are configured per channel, so the two channels advance through
+ * the audience at different speeds and each needs its own position. Both channels read
+ * the SAME queue (`dispatch_state == 'pending'` ordered by `__name__`); what separates
+ * them is the `startAfter` each one uses.
+ */
+export interface ICampaignDispatchChannelState {
+  /**
+   * Last recipient id this channel dispatched — the `startAfter` of its own page.
+   * A channel held back by its window or its daily limit simply does NOT advance this,
+   * which is what records the legs it still owes.
+   */
+  cursor_doc_id?: string | null;
+  /**
+   * Earliest instant this channel may dispatch again (its own `batch_interval_minutes`).
+   * This is the AUTHORITY on the channel's turn: the scheduled `campaign.dispatch_batch`
+   * task is only a wake-up call and grants no permission by itself, so a batch that fires
+   * early (the feat-080 sweep reviving a chain, say) re-reads this and defers.
+   * Firestore returns a Timestamp — `.toDate()` before comparing.
+   */
+  next_at?: Date | null;
+}
+
 export interface ICampaignDispatchState {
+  /**
+   * LEGACY (pre-F3.3): the single campaign-wide cursor. It no longer governs sending —
+   * `per_channel.{channel}.cursor_doc_id` does. It is still written, as the MINIMUM of
+   * the per-channel cursors, for two reasons: a campaign in flight when F3.3 deployed
+   * seeds both channels from it, and a rollback to the previous engine must resume
+   * BEHIND every channel rather than ahead of one (re-reading is inert — the send task
+   * is idempotent on `dedup_key` — whereas skipping loses a send silently).
+   * Do not read this to answer "how far has the campaign got": ask per channel.
+   */
   cursor_doc_id?: string | null;
   next_dispatch_task_id?: string | null;
   sent_today?: ICampaignSentToday;
   batches_dispatched?: number;
+  /** Per-channel queue position and turn (F3.3). Absent on a campaign that last ran
+   *  under the pre-F3.3 engine; each channel then falls back to `cursor_doc_id`. */
+  per_channel?: {
+    whatsapp?: ICampaignDispatchChannelState;
+    email?: ICampaignDispatchChannelState;
+  };
 }
 
 export type CampaignPrevalidationStatus = "approved" | "warnings" | "blocked";

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

@@ -159,6 +159,17 @@ export interface IAppointment extends IFireDoc {
     payment?: IAppointmentPayment | null;
     reschedules?: IAppointmentReschedule[] | null;
     external_id?: string | null;
+    /**
+     * ID do STATUS na agenda externa de origem. Algumas agendas identificam o
+     * status por id além do rótulo (`status`), e os workflows n8n precisam desse
+     * id pra reescrever o agendamento no externo sem ter que resolver o rótulo
+     * de volta.
+     *
+     * Opcional por natureza: só algumas agendas têm. Autoridade do externo — não
+     * declarado na base global de política, então resolve como `external`.
+     * Não replicado no embed do paciente (ver `IPatientAppointment`).
+     */
+    status_external_id?: string | null;
     isDraft: boolean;
     draftExpirationMinutes?: number | null;
     tags?: ITag[] | null;

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

@@ -201,6 +201,17 @@ export interface IAppointment extends IFireDoc {
   // Controle de remarcações
   reschedules?: IAppointmentReschedule[] | null;
   external_id?: string | null; // ID externo da consulta
+  /**
+   * ID do STATUS na agenda externa de origem. Algumas agendas identificam o
+   * status por id além do rótulo (`status`), e os workflows n8n precisam desse
+   * id pra reescrever o agendamento no externo sem ter que resolver o rótulo
+   * de volta.
+   *
+   * Opcional por natureza: só algumas agendas têm. Autoridade do externo — não
+   * declarado na base global de política, então resolve como `external`.
+   * Não replicado no embed do paciente (ver `IPatientAppointment`).
+   */
+  status_external_id?: string | null;
   // Propriedades para controle de rascunho
   isDraft: boolean;
   draftExpirationMinutes?: number | null; // tempo em minutos para expiração do rascunho

package/package.json

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