evo360-types 1.3.697 → 1.3.703

package/dist/apps/evo-notifications/zod-schemas.d.ts

@@ -78,6 +78,61 @@ export declare const zNotificationErrorSchema: z.ZodObject<{
     code: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
     details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.ZodTypeAny, "passthrough">>;
+/** Human email content; plain text remains in the legacy top-level body_text. */
+export declare const zNotificationEmailContentSchema: z.ZodEffects<z.ZodObject<{
+    subject: z.ZodOptional<z.ZodString>;
+    body_text: z.ZodOptional<z.ZodString>;
+    body_html: z.ZodOptional<z.ZodString>;
+    thread_id: z.ZodOptional<z.ZodString>;
+    reply_to_message_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    thread_id?: string | undefined;
+    body_text?: string | undefined;
+    subject?: string | undefined;
+    body_html?: string | undefined;
+    reply_to_message_id?: string | undefined;
+}, {
+    thread_id?: string | undefined;
+    body_text?: string | undefined;
+    subject?: string | undefined;
+    body_html?: string | undefined;
+    reply_to_message_id?: string | undefined;
+}>, {
+    thread_id?: string | undefined;
+    body_text?: string | undefined;
+    subject?: string | undefined;
+    body_html?: string | undefined;
+    reply_to_message_id?: string | undefined;
+}, {
+    thread_id?: string | undefined;
+    body_text?: string | undefined;
+    subject?: string | undefined;
+    body_html?: string | undefined;
+    reply_to_message_id?: string | undefined;
+}>;
+export declare const EMAIL_ATTACHMENT_TOTAL_MAX_BYTES: number;
+export declare const zEmailSmtpConfigSchema: z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodNumber;
+    secure: z.ZodBoolean;
+    username: z.ZodString;
+    password_secret_ref: z.ZodString;
+    max_attachment_total_bytes: z.ZodOptional<z.ZodNumber>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    host: z.ZodString;
+    port: z.ZodNumber;
+    secure: z.ZodBoolean;
+    username: z.ZodString;
+    password_secret_ref: z.ZodString;
+    max_attachment_total_bytes: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    host: z.ZodString;
+    port: z.ZodNumber;
+    secure: z.ZodBoolean;
+    username: z.ZodString;
+    password_secret_ref: z.ZodString;
+    max_attachment_total_bytes: z.ZodOptional<z.ZodNumber>;
+}, z.ZodTypeAny, "passthrough">>;
 export declare const zNotificationMessageSchema: z.ZodObject<{
     id: z.ZodString;
     ref: z.ZodAny;
@@ -119,6 +174,37 @@ export declare const zNotificationMessageSchema: z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     recipient: z.ZodObject<{
         kind: z.ZodEnum<["patient", "professional", "preconfigured", "raw"]>;
         id: z.ZodOptional<z.ZodString>;
@@ -314,6 +400,37 @@ export declare const zNotificationMessageSchema: z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     recipient: z.ZodObject<{
         kind: z.ZodEnum<["patient", "professional", "preconfigured", "raw"]>;
         id: z.ZodOptional<z.ZodString>;
@@ -509,6 +626,37 @@ export declare const zNotificationMessageSchema: z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     recipient: z.ZodObject<{
         kind: z.ZodEnum<["patient", "professional", "preconfigured", "raw"]>;
         id: z.ZodOptional<z.ZodString>;
@@ -923,6 +1071,37 @@ export declare const zDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         locale: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: z.ZodOptional<z.ZodString>;
     direct_send: z.ZodOptional<z.ZodObject<{
@@ -1129,6 +1308,37 @@ export declare const zDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         locale: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: z.ZodOptional<z.ZodString>;
     direct_send: z.ZodOptional<z.ZodObject<{
@@ -1335,6 +1545,37 @@ export declare const zDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         locale: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: z.ZodOptional<z.ZodString>;
     direct_send: z.ZodOptional<z.ZodObject<{
@@ -1541,6 +1782,37 @@ export declare const zDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         locale: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: z.ZodOptional<z.ZodString>;
     direct_send: z.ZodOptional<z.ZodObject<{
@@ -1747,6 +2019,37 @@ export declare const zDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         locale: z.ZodOptional<z.ZodString>;
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: z.ZodOptional<z.ZodString>;
     direct_send: z.ZodOptional<z.ZodObject<{
@@ -1954,6 +2257,37 @@ export declare const zNexusDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     direct_send: z.ZodOptional<z.ZodObject<{
         category: z.ZodLiteral<"utility">;
         ttl_seconds: z.ZodOptional<z.ZodNumber>;
@@ -2145,6 +2479,37 @@ export declare const zNexusDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     direct_send: z.ZodOptional<z.ZodObject<{
         category: z.ZodLiteral<"utility">;
         ttl_seconds: z.ZodOptional<z.ZodNumber>;
@@ -2336,6 +2701,37 @@ export declare const zNexusDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     direct_send: z.ZodOptional<z.ZodObject<{
         category: z.ZodLiteral<"utility">;
         ttl_seconds: z.ZodOptional<z.ZodNumber>;
@@ -2527,6 +2923,37 @@ export declare const zNexusDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     direct_send: z.ZodOptional<z.ZodObject<{
         category: z.ZodLiteral<"utility">;
         ttl_seconds: z.ZodOptional<z.ZodNumber>;
@@ -2718,6 +3145,37 @@ export declare const zNexusDirectSendPayloadSchema: z.ZodEffects<z.ZodObject<{
         version: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
     }, z.ZodTypeAny, "passthrough">>>;
     body_text: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        subject: z.ZodOptional<z.ZodString>;
+        body_text: z.ZodOptional<z.ZodString>;
+        body_html: z.ZodOptional<z.ZodString>;
+        thread_id: z.ZodOptional<z.ZodString>;
+        reply_to_message_id: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }, {
+        thread_id?: string | undefined;
+        body_text?: string | undefined;
+        subject?: string | undefined;
+        body_html?: string | undefined;
+        reply_to_message_id?: string | undefined;
+    }>>;
     direct_send: z.ZodOptional<z.ZodObject<{
         category: z.ZodLiteral<"utility">;
         ttl_seconds: z.ZodOptional<z.ZodNumber>;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.zNexusDirectSendPayloadSchema = exports.zDirectSendPayloadSchema = exports.zNotificationAttachmentSchema = exports.NOTIFICATION_ATTACHMENT_MAX_BASE64_BYTES = exports.zNotificationDirectSendSchema = exports.zNotificationLogSchema = exports.zNotificationAttemptSchema = exports.zNotificationMessageSchema = exports.zNotificationErrorSchema = exports.zNotificationProviderMetaSchema = exports.zNotificationTemplateRefSchema = exports.zNotificationChannelRefSchema = exports.zNotificationRecipientSchema = exports.zNotificationLogLevelSchema = exports.zNotificationRecipientKindSchema = exports.zNotificationAttemptStatusSchema = exports.zNotificationMessageStatusSchema = exports.zNotificationChannelTypeSchema = void 0;
+exports.zNexusDirectSendPayloadSchema = exports.zDirectSendPayloadSchema = exports.zNotificationAttachmentSchema = exports.NOTIFICATION_ATTACHMENT_MAX_BASE64_BYTES = exports.zNotificationDirectSendSchema = exports.zNotificationLogSchema = exports.zNotificationAttemptSchema = exports.zNotificationMessageSchema = exports.zEmailSmtpConfigSchema = exports.EMAIL_ATTACHMENT_TOTAL_MAX_BYTES = exports.zNotificationEmailContentSchema = exports.zNotificationErrorSchema = exports.zNotificationProviderMetaSchema = exports.zNotificationTemplateRefSchema = exports.zNotificationChannelRefSchema = exports.zNotificationRecipientSchema = exports.zNotificationLogLevelSchema = exports.zNotificationRecipientKindSchema = exports.zNotificationAttemptStatusSchema = exports.zNotificationMessageStatusSchema = exports.zNotificationChannelTypeSchema = void 0;
 const zod_1 = require("zod");
 const zod_schemas_1 = require("../shared/zod-schemas");
 const zod_schemas_2 = require("../evo-task/zod-schemas");
@@ -78,6 +78,41 @@ exports.zNotificationErrorSchema = zod_1.z
     details: zod_1.z.record(zod_1.z.unknown()).optional(),
 })
     .passthrough();
+/** Human email content; plain text remains in the legacy top-level body_text. */
+exports.zNotificationEmailContentSchema = zod_1.z
+    .object({
+    subject: zod_1.z.string().trim().min(1).max(998).optional(),
+    body_text: zod_1.z.string().optional(),
+    body_html: zod_1.z.string().optional(),
+    thread_id: zod_1.z.string().min(1).optional(),
+    reply_to_message_id: zod_1.z.string().min(1).optional(),
+})
+    .strict()
+    .superRefine((data, ctx) => {
+    if (!data.reply_to_message_id && !data.subject) {
+        ctx.addIssue({
+            code: zod_1.z.ZodIssueCode.custom,
+            message: "Informe o assunto para iniciar uma nova conversa por email.",
+            path: ["subject"],
+        });
+    }
+});
+exports.EMAIL_ATTACHMENT_TOTAL_MAX_BYTES = 15 * 1024 * 1024;
+exports.zEmailSmtpConfigSchema = zod_1.z
+    .object({
+    host: zod_1.z.string(),
+    port: zod_1.z.number(),
+    secure: zod_1.z.boolean(),
+    username: zod_1.z.string(),
+    password_secret_ref: zod_1.z.string(),
+    max_attachment_total_bytes: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(exports.EMAIL_ATTACHMENT_TOTAL_MAX_BYTES)
+        .optional(),
+})
+    .passthrough();
 // ---- Main document schemas ----
 exports.zNotificationMessageSchema = zod_schemas_1.zFireDocSchema
     .extend({
@@ -90,6 +125,7 @@ exports.zNotificationMessageSchema = zod_schemas_1.zFireDocSchema
     channel: exports.zNotificationChannelRefSchema,
     template: exports.zNotificationTemplateRefSchema.optional(),
     body_text: zod_1.z.string().max(4096).optional(),
+    email: exports.zNotificationEmailContentSchema.optional(),
     recipient: exports.zNotificationRecipientSchema,
     variables: zod_1.z.record(zod_1.z.unknown()).optional(),
     status: exports.zNotificationMessageStatusSchema,
@@ -160,6 +196,7 @@ exports.zDirectSendPayloadSchema = zod_1.z
     recipient: exports.zNotificationRecipientSchema,
     channel: exports.zNotificationChannelRefSchema,
     template: exports.zNotificationTemplateRefSchema.optional(),
+    email: exports.zNotificationEmailContentSchema.optional(),
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: zod_1.z.string().max(4096).optional(),
     direct_send: exports.zNotificationDirectSendSchema.optional(),
@@ -219,6 +256,7 @@ exports.zNexusDirectSendPayloadSchema = zod_1.z
     channel: exports.zNotificationChannelRefSchema,
     template: exports.zNotificationTemplateRefSchema.optional(),
     body_text: zod_1.z.string().max(4096).optional(),
+    email: exports.zNotificationEmailContentSchema.optional(),
     direct_send: exports.zNotificationDirectSendSchema.optional(),
     variables: zod_1.z.record(zod_1.z.unknown()).optional(),
     routine: zod_1.z

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

@@ -88,6 +88,44 @@ export const zNotificationErrorSchema = z
   })
   .passthrough();
 
+/** Human email content; plain text remains in the legacy top-level body_text. */
+export const zNotificationEmailContentSchema = z
+  .object({
+    subject: z.string().trim().min(1).max(998).optional(),
+    body_text: z.string().optional(),
+    body_html: z.string().optional(),
+    thread_id: z.string().min(1).optional(),
+    reply_to_message_id: z.string().min(1).optional(),
+  })
+  .strict()
+  .superRefine((data, ctx) => {
+    if (!data.reply_to_message_id && !data.subject) {
+      ctx.addIssue({
+        code: z.ZodIssueCode.custom,
+        message: "Informe o assunto para iniciar uma nova conversa por email.",
+        path: ["subject"],
+      });
+    }
+  });
+
+export const EMAIL_ATTACHMENT_TOTAL_MAX_BYTES = 15 * 1024 * 1024;
+
+export const zEmailSmtpConfigSchema = z
+  .object({
+    host: z.string(),
+    port: z.number(),
+    secure: z.boolean(),
+    username: z.string(),
+    password_secret_ref: z.string(),
+    max_attachment_total_bytes: z
+      .number()
+      .int()
+      .positive()
+      .max(EMAIL_ATTACHMENT_TOTAL_MAX_BYTES)
+      .optional(),
+  })
+  .passthrough();
+
 // ---- Main document schemas ----
 
 export const zNotificationMessageSchema = zFireDocSchema
@@ -101,6 +139,7 @@ export const zNotificationMessageSchema = zFireDocSchema
     channel: zNotificationChannelRefSchema,
     template: zNotificationTemplateRefSchema.optional(),
     body_text: z.string().max(4096).optional(),
+    email: zNotificationEmailContentSchema.optional(),
     recipient: zNotificationRecipientSchema,
     variables: z.record(z.unknown()).optional(),
     status: zNotificationMessageStatusSchema,
@@ -179,6 +218,7 @@ export const zDirectSendPayloadSchema = z
     recipient: zNotificationRecipientSchema,
     channel: zNotificationChannelRefSchema,
     template: zNotificationTemplateRefSchema.optional(),
+    email: zNotificationEmailContentSchema.optional(),
     /** WhatsApp session text (no HSM). Max length per Meta. */
     body_text: z.string().max(4096).optional(),
     direct_send: zNotificationDirectSendSchema.optional(),
@@ -244,6 +284,7 @@ export const zNexusDirectSendPayloadSchema = z
     channel: zNotificationChannelRefSchema,
     template: zNotificationTemplateRefSchema.optional(),
     body_text: z.string().max(4096).optional(),
+    email: zNotificationEmailContentSchema.optional(),
     direct_send: zNotificationDirectSendSchema.optional(),
     variables: z.record(z.unknown()).optional(),
     routine: z

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

@@ -9,6 +9,7 @@ export * from "./common/nfse-fee-reimbursement";
 export * from "./providers";
 export * from "./providers/provider_fiscal_types";
 export * from "./providers/asaas/asaas_provider";
+export * from "./providers/asaas/asaas_kyc";
 export * from "./providers/inter/inter_provider";
 export * from "./dic";
 export * from "./invoices";

package/dist/types/evo-finops/index.js

@@ -26,6 +26,7 @@ __exportStar(require("./common/nfse-fee-reimbursement"), exports);
 __exportStar(require("./providers"), exports);
 __exportStar(require("./providers/provider_fiscal_types"), exports);
 __exportStar(require("./providers/asaas/asaas_provider"), exports);
+__exportStar(require("./providers/asaas/asaas_kyc"), exports);
 __exportStar(require("./providers/inter/inter_provider"), exports);
 __exportStar(require("./dic"), exports);
 __exportStar(require("./invoices"), exports);

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

@@ -11,6 +11,7 @@ export * from "./common/nfse-fee-reimbursement";
 export * from "./providers";
 export * from "./providers/provider_fiscal_types";
 export * from "./providers/asaas/asaas_provider";
+export * from "./providers/asaas/asaas_kyc";
 export * from "./providers/inter/inter_provider";
 export * from "./dic";
 export * from "./invoices";

package/dist/types/evo-finops/providers/asaas/asaas_kyc.d.ts

@@ -0,0 +1,63 @@
+import { AsaasAccessTokenStatus, AsaasAccountStatusValue, AsaasEnvironment, AsaasKycNotificationTrigger, AsaasOnboardingNextAction, IAsaasCommercialInfoExpiration } from "./asaas_provider";
+/** Tópico Pub/Sub dos pedidos de aviso de KYC (publicado pelo functions-app). */
+export declare const FINOPS_ASAAS_KYC_NOTIFY_TOPIC = "app_evo-finops_asaas-kyc_notify-requested";
+/** Gatilho do aviso: os de KYC + alerta de chave de API (destinado ao staff). */
+export type FinopsAsaasKycNotifyTrigger = AsaasKycNotificationTrigger | "access_token_alert";
+export interface IFinopsAsaasKycNotifyRecipient {
+    name?: string | null;
+    email?: string | null;
+    /** E.164 normalizado. */
+    mobile_phone?: string | null;
+}
+export interface IFinopsAsaasKycNotifyMessage {
+    tenant: string;
+    provider_id: string;
+    provider_name?: string;
+    trigger: FinopsAsaasKycNotifyTrigger;
+    /** Escopo do dedup (ex.: hash do link, data agendada). Chave = `${trigger}:${dedup_scope}`. */
+    dedup_scope: string;
+    /**
+     * Opcional: o consumidor resolve o contato administrativo da clínica
+     * (cliente do Nexus por `tenant_refs[].tenant`, leads com role `administrative`).
+     */
+    recipients?: IFinopsAsaasKycNotifyRecipient[];
+    /** Usado quando o cliente do Nexus não tem contato administrativo (vem do `holder_contact`). */
+    fallback_recipients?: IFinopsAsaasKycNotifyRecipient[];
+    /** nome, clinica, link, data_limite, motivo… */
+    variables: Record<string, string>;
+    /** ISO datetime. */
+    requested_at: string;
+}
+/** Grupo de documento pendente, resumido para a fila. */
+export interface INexKycQueuePendingGroup {
+    title?: string | null;
+    status?: string | null;
+}
+/** Resumo de `IAsaasAccessTokenMeta` exibido na fila. */
+export interface INexKycQueueAccessTokenSummary {
+    status: AsaasAccessTokenStatus;
+    projected_expiration_by_lack_of_use?: string | null;
+    last_event?: string | null;
+}
+/** feat-275 — linha da fila de KYC do Nexus (uma por provider `asaas_subaccount` não aprovado). */
+export interface INexKycQueueItem {
+    tenant: string;
+    provider_id: string;
+    provider_name?: string | null;
+    /** Ambiente do snapshot exibido. */
+    env?: AsaasEnvironment;
+    /** ISO datetime de criação do provider. */
+    created_at?: string | null;
+    general?: AsaasAccountStatusValue | null;
+    documentation?: AsaasAccountStatusValue | null;
+    commercialInfo?: AsaasAccountStatusValue | null;
+    next_action?: AsaasOnboardingNextAction | null;
+    documents_fetched_at?: string | null;
+    has_onboarding_url: boolean;
+    pending_groups: INexKycQueuePendingGroup[];
+    commercial_info_expiration?: IAsaasCommercialInfoExpiration | null;
+    access_token_meta?: INexKycQueueAccessTokenSummary | null;
+    last_error?: {
+        code?: string | null;
+    } | null;
+}

package/dist/types/evo-finops/providers/asaas/asaas_kyc.js

@@ -0,0 +1,14 @@
+"use strict";
+// ── feat-275 — KYC da subconta Asaas (BaaS) ──
+//
+// Contratos compartilhados functions-app ↔ functions-nexus:
+// - mensagem Pub/Sub que pede um aviso de KYC ao cliente (o consumidor no
+//   functions-nexus resolve o contato administrativo da clínica no cadastro do
+//   cliente do Nexus; `fallback_recipients` vem do `holder_contact` da subconta);
+// - linha da fila de KYC do Nexus.
+//
+// Runtime `lib: es6`: as constantes abaixo são só dados.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FINOPS_ASAAS_KYC_NOTIFY_TOPIC = void 0;
+/** Tópico Pub/Sub dos pedidos de aviso de KYC (publicado pelo functions-app). */
+exports.FINOPS_ASAAS_KYC_NOTIFY_TOPIC = "app_evo-finops_asaas-kyc_notify-requested";

package/dist/types/evo-finops/providers/asaas/asaas_kyc.ts

@@ -0,0 +1,85 @@
+// ── feat-275 — KYC da subconta Asaas (BaaS) ──
+//
+// Contratos compartilhados functions-app ↔ functions-nexus:
+// - mensagem Pub/Sub que pede um aviso de KYC ao cliente (o consumidor no
+//   functions-nexus resolve o contato administrativo da clínica no cadastro do
+//   cliente do Nexus; `fallback_recipients` vem do `holder_contact` da subconta);
+// - linha da fila de KYC do Nexus.
+//
+// Runtime `lib: es6`: as constantes abaixo são só dados.
+
+import {
+  AsaasAccessTokenStatus,
+  AsaasAccountStatusValue,
+  AsaasEnvironment,
+  AsaasKycNotificationTrigger,
+  AsaasOnboardingNextAction,
+  IAsaasCommercialInfoExpiration,
+} from "./asaas_provider";
+
+/** Tópico Pub/Sub dos pedidos de aviso de KYC (publicado pelo functions-app). */
+export const FINOPS_ASAAS_KYC_NOTIFY_TOPIC = "app_evo-finops_asaas-kyc_notify-requested";
+
+/** Gatilho do aviso: os de KYC + alerta de chave de API (destinado ao staff). */
+export type FinopsAsaasKycNotifyTrigger = AsaasKycNotificationTrigger | "access_token_alert";
+
+export interface IFinopsAsaasKycNotifyRecipient {
+  name?: string | null;
+  email?: string | null;
+  /** E.164 normalizado. */
+  mobile_phone?: string | null;
+}
+
+export interface IFinopsAsaasKycNotifyMessage {
+  tenant: string;
+  provider_id: string;
+  provider_name?: string;
+  trigger: FinopsAsaasKycNotifyTrigger;
+  /** Escopo do dedup (ex.: hash do link, data agendada). Chave = `${trigger}:${dedup_scope}`. */
+  dedup_scope: string;
+  /**
+   * Opcional: o consumidor resolve o contato administrativo da clínica
+   * (cliente do Nexus por `tenant_refs[].tenant`, leads com role `administrative`).
+   */
+  recipients?: IFinopsAsaasKycNotifyRecipient[];
+  /** Usado quando o cliente do Nexus não tem contato administrativo (vem do `holder_contact`). */
+  fallback_recipients?: IFinopsAsaasKycNotifyRecipient[];
+  /** nome, clinica, link, data_limite, motivo… */
+  variables: Record<string, string>;
+  /** ISO datetime. */
+  requested_at: string;
+}
+
+/** Grupo de documento pendente, resumido para a fila. */
+export interface INexKycQueuePendingGroup {
+  title?: string | null;
+  status?: string | null;
+}
+
+/** Resumo de `IAsaasAccessTokenMeta` exibido na fila. */
+export interface INexKycQueueAccessTokenSummary {
+  status: AsaasAccessTokenStatus;
+  projected_expiration_by_lack_of_use?: string | null;
+  last_event?: string | null;
+}
+
+/** feat-275 — linha da fila de KYC do Nexus (uma por provider `asaas_subaccount` não aprovado). */
+export interface INexKycQueueItem {
+  tenant: string;
+  provider_id: string;
+  provider_name?: string | null;
+  /** Ambiente do snapshot exibido. */
+  env?: AsaasEnvironment;
+  /** ISO datetime de criação do provider. */
+  created_at?: string | null;
+  general?: AsaasAccountStatusValue | null;
+  documentation?: AsaasAccountStatusValue | null;
+  commercialInfo?: AsaasAccountStatusValue | null;
+  next_action?: AsaasOnboardingNextAction | null;
+  documents_fetched_at?: string | null;
+  has_onboarding_url: boolean;
+  pending_groups: INexKycQueuePendingGroup[];
+  commercial_info_expiration?: IAsaasCommercialInfoExpiration | null;
+  access_token_meta?: INexKycQueueAccessTokenSummary | null;
+  last_error?: { code?: string | null } | null;
+}

package/dist/types/evo-finops/providers/asaas/asaas_provider.d.ts

@@ -99,9 +99,27 @@ export interface IAsaasSubaccountInput {
 /** Valores do status cadastral devolvidos pelo Asaas em GET /v3/myAccount/status. */
 export type AsaasAccountStatusValue = "APPROVED" | "AWAITING_APPROVAL" | "PENDING" | "REJECTED" | "EXPIRING_SOON" | "EXPIRED";
 /** O que originou a escrita do snapshot cadastral. */
-export type AsaasOnboardingSource = "manual_refresh" | "webhook" | "provider_create" | "scheduled_refresh";
+export type AsaasOnboardingSource = "manual_refresh" | "webhook" | "provider_create" | "scheduled_refresh"
+/** feat-275 — rebusca de documentos disparada por webhook ACCOUNT_STATUS_*. */
+ | "webhook_refetch"
+/** feat-275 — refresh inline no gate de emissão (subconta sem snapshot). */
+ | "gate_refresh"
+/** feat-275 — upload de documento pela nossa tela. */
+ | "document_upload"
+/** feat-275 — atualização/confirmação dos dados comerciais pela nossa tela. */
+ | "commercial_info_update"
+/** feat-275 — troca/registro de chave de API da subconta. */
+ | "key_rotation";
 /** Próxima ação que o dono da conta precisa executar para destravar a subconta. */
-export type AsaasOnboardingNextAction = "approved" | "rejected" | "awaiting_analysis" | "open_onboarding_link" | "send_documents_external" | "fix_commercial_info" | "pending_bank_account" | "unknown";
+export type AsaasOnboardingNextAction = "approved" | "rejected" | "awaiting_analysis" | "open_onboarding_link"
+/** Legado: permanece para snapshots antigos; o mapper da feat-275 deixa de emiti-lo. */
+ | "send_documents_external" | "fix_commercial_info" | "pending_bank_account"
+/** feat-275 — grupo sem onboarding_url: upload pela nossa tela. */
+ | "upload_documents"
+/** feat-275 — confirmação anual dos dados comerciais (EXPIRING_SOON / EXPIRED). */
+ | "confirm_commercial_info"
+/** feat-275 — subconta recém-criada; o Asaas ainda não gerou os documentos. */
+ | "awaiting_link" | "unknown";
 /** Snapshot de GET /v3/myAccount/status. Sobrescrito inteiro a cada leitura/evento. */
 export interface IAsaasAccountStatusSnapshot {
     fetched_at: string;
@@ -134,6 +152,10 @@ export interface IAsaasOnboardingDocumentGroup {
         id?: string;
         status?: string;
     }>;
+    /** feat-275 — quando fizemos o último upload deste grupo (metadado; nunca o arquivo). */
+    last_upload_at?: string | null;
+    /** feat-275 — userId de quem fez o último upload. */
+    last_upload_by?: string | null;
 }
 /** Snapshot de GET /v3/myAccount/documents + próxima ação derivada. */
 export interface IAsaasOnboardingSnapshot {
@@ -142,6 +164,61 @@ export interface IAsaasOnboardingSnapshot {
     document_groups: IAsaasOnboardingDocumentGroup[];
     next_action: AsaasOnboardingNextAction;
 }
+/**
+ * feat-275 — confirmação anual dos dados comerciais.
+ * Com `is_expired` o Asaas responde 403 em tudo, exceto GET/POST /myAccount/commercialInfo.
+ */
+export interface IAsaasCommercialInfoExpiration {
+    is_expired: boolean;
+    /** YYYY-MM-DD (`additionalInfo.scheduledDate` do evento EXPIRING_SOON). */
+    scheduled_date?: string | null;
+    updated_at: string;
+    source: "provider_create" | "webhook" | "commercial_info_fetch" | "commercial_info_update";
+}
+/** feat-275 — contato de negócio do titular da subconta (LGPD: só nome, e-mail e celular). */
+export interface IAsaasHolderContact {
+    name?: string | null;
+    email?: string | null;
+    /** E.164 normalizado. */
+    mobile_phone?: string | null;
+    source: "provider_create" | "commercial_info";
+    updated_at: string;
+}
+/** feat-275 — gatilhos de aviso de KYC ao cliente. */
+export type AsaasKycNotificationTrigger = "link_available" | "link_renewed" | "rejected" | "commercial_info_expiring" | "commercial_info_expired";
+/** feat-275 — estado de dedup dos avisos de KYC. */
+export interface IAsaasKycNotificationState {
+    /** chave = `${trigger}:${scope}` (ex.: `link_available:3f9a...`); valor = quando foi publicado. */
+    sent?: Record<string, {
+        at: string;
+        trigger: AsaasKycNotificationTrigger;
+    }>;
+    /** sha256(url).slice(0,16) — nunca a URL. */
+    last_link_hash?: string | null;
+}
+/** feat-275 — estado da chave de API da subconta. */
+export type AsaasAccessTokenStatus = "active" | "disabled" | "expired" | "deleted" | "invalid" | "unknown";
+/**
+ * feat-275 — metadado da chave de API (nunca o valor). Alimentado por eventos ACCESS_TOKEN_*
+ * e pela checagem diária (`GET /myAccount/status` com a chave da subconta).
+ */
+export interface IAsaasAccessTokenMeta {
+    asaas_access_token_id?: string | null;
+    name?: string | null;
+    status: AsaasAccessTokenStatus;
+    enabled?: boolean | null;
+    /** MANUAL | LACK_OF_USE */
+    disable_reason?: string | null;
+    expiration_date?: string | null;
+    /** A chave BaaS expira após 6 meses SEM USO; data projetada pelo Asaas. */
+    projected_expiration_by_lack_of_use?: string | null;
+    /** ACCESS_TOKEN_* */
+    last_event?: string | null;
+    last_event_at?: string | null;
+    rotated_at?: string | null;
+    /** loginId do staff. */
+    rotated_by?: string | null;
+}
 export interface IAsaasEnvAuthConfig {
     enabled: boolean;
     base_url?: string;
@@ -152,6 +229,14 @@ export interface IAsaasEnvAuthConfig {
     account_scope?: IAsaasAccountScope;
     account_status?: IAsaasAccountStatusSnapshot;
     onboarding?: IAsaasOnboardingSnapshot;
+    /** feat-275 — confirmação anual dos dados comerciais. */
+    commercial_info_expiration?: IAsaasCommercialInfoExpiration;
+    /** feat-275 — contato do titular (fallback de destinatário dos avisos de KYC). */
+    holder_contact?: IAsaasHolderContact;
+    /** feat-275 — dedup dos avisos de KYC. */
+    kyc_notifications?: IAsaasKycNotificationState;
+    /** feat-275 — estado da chave de API (nunca o valor). */
+    access_token_meta?: IAsaasAccessTokenMeta;
     subaccount_input?: IAsaasSubaccountInput;
     operational?: {
         rate_limit_max_per_minute?: number;

package/dist/types/evo-finops/providers/asaas/asaas_provider.ts

@@ -145,7 +145,17 @@ export type AsaasOnboardingSource =
   | "manual_refresh"
   | "webhook"
   | "provider_create"
-  | "scheduled_refresh";
+  | "scheduled_refresh"
+  /** feat-275 — rebusca de documentos disparada por webhook ACCOUNT_STATUS_*. */
+  | "webhook_refetch"
+  /** feat-275 — refresh inline no gate de emissão (subconta sem snapshot). */
+  | "gate_refresh"
+  /** feat-275 — upload de documento pela nossa tela. */
+  | "document_upload"
+  /** feat-275 — atualização/confirmação dos dados comerciais pela nossa tela. */
+  | "commercial_info_update"
+  /** feat-275 — troca/registro de chave de API da subconta. */
+  | "key_rotation";
 
 /** Próxima ação que o dono da conta precisa executar para destravar a subconta. */
 export type AsaasOnboardingNextAction =
@@ -153,9 +163,16 @@ export type AsaasOnboardingNextAction =
   | "rejected"
   | "awaiting_analysis"
   | "open_onboarding_link"
+  /** Legado: permanece para snapshots antigos; o mapper da feat-275 deixa de emiti-lo. */
   | "send_documents_external"
   | "fix_commercial_info"
   | "pending_bank_account"
+  /** feat-275 — grupo sem onboarding_url: upload pela nossa tela. */
+  | "upload_documents"
+  /** feat-275 — confirmação anual dos dados comerciais (EXPIRING_SOON / EXPIRED). */
+  | "confirm_commercial_info"
+  /** feat-275 — subconta recém-criada; o Asaas ainda não gerou os documentos. */
+  | "awaiting_link"
   | "unknown";
 
 /** Snapshot de GET /v3/myAccount/status. Sobrescrito inteiro a cada leitura/evento. */
@@ -185,6 +202,10 @@ export interface IAsaasOnboardingDocumentGroup {
   onboarding_url?: string | null;
   responsible?: { name?: string | null; type?: string | null };
   documents?: Array<{ id?: string; status?: string }>;
+  /** feat-275 — quando fizemos o último upload deste grupo (metadado; nunca o arquivo). */
+  last_upload_at?: string | null;
+  /** feat-275 — userId de quem fez o último upload. */
+  last_upload_by?: string | null;
 }
 
 /** Snapshot de GET /v3/myAccount/documents + próxima ação derivada. */
@@ -195,6 +216,79 @@ export interface IAsaasOnboardingSnapshot {
   next_action: AsaasOnboardingNextAction;
 }
 
+/**
+ * feat-275 — confirmação anual dos dados comerciais.
+ * Com `is_expired` o Asaas responde 403 em tudo, exceto GET/POST /myAccount/commercialInfo.
+ */
+export interface IAsaasCommercialInfoExpiration {
+  is_expired: boolean;
+  /** YYYY-MM-DD (`additionalInfo.scheduledDate` do evento EXPIRING_SOON). */
+  scheduled_date?: string | null;
+  updated_at: string;
+  source:
+    | "provider_create"
+    | "webhook"
+    | "commercial_info_fetch"
+    | "commercial_info_update";
+}
+
+/** feat-275 — contato de negócio do titular da subconta (LGPD: só nome, e-mail e celular). */
+export interface IAsaasHolderContact {
+  name?: string | null;
+  email?: string | null;
+  /** E.164 normalizado. */
+  mobile_phone?: string | null;
+  source: "provider_create" | "commercial_info";
+  updated_at: string;
+}
+
+/** feat-275 — gatilhos de aviso de KYC ao cliente. */
+export type AsaasKycNotificationTrigger =
+  | "link_available"
+  | "link_renewed"
+  | "rejected"
+  | "commercial_info_expiring"
+  | "commercial_info_expired";
+
+/** feat-275 — estado de dedup dos avisos de KYC. */
+export interface IAsaasKycNotificationState {
+  /** chave = `${trigger}:${scope}` (ex.: `link_available:3f9a...`); valor = quando foi publicado. */
+  sent?: Record<string, { at: string; trigger: AsaasKycNotificationTrigger }>;
+  /** sha256(url).slice(0,16) — nunca a URL. */
+  last_link_hash?: string | null;
+}
+
+/** feat-275 — estado da chave de API da subconta. */
+export type AsaasAccessTokenStatus =
+  | "active"
+  | "disabled"
+  | "expired"
+  | "deleted"
+  | "invalid"
+  | "unknown";
+
+/**
+ * feat-275 — metadado da chave de API (nunca o valor). Alimentado por eventos ACCESS_TOKEN_*
+ * e pela checagem diária (`GET /myAccount/status` com a chave da subconta).
+ */
+export interface IAsaasAccessTokenMeta {
+  asaas_access_token_id?: string | null;
+  name?: string | null;
+  status: AsaasAccessTokenStatus;
+  enabled?: boolean | null;
+  /** MANUAL | LACK_OF_USE */
+  disable_reason?: string | null;
+  expiration_date?: string | null;
+  /** A chave BaaS expira após 6 meses SEM USO; data projetada pelo Asaas. */
+  projected_expiration_by_lack_of_use?: string | null;
+  /** ACCESS_TOKEN_* */
+  last_event?: string | null;
+  last_event_at?: string | null;
+  rotated_at?: string | null;
+  /** loginId do staff. */
+  rotated_by?: string | null;
+}
+
 export interface IAsaasEnvAuthConfig {
   enabled: boolean;
 
@@ -218,6 +312,18 @@ export interface IAsaasEnvAuthConfig {
   // Documentos pendentes e próxima ação de ativação.
   onboarding?: IAsaasOnboardingSnapshot;
 
+  /** feat-275 — confirmação anual dos dados comerciais. */
+  commercial_info_expiration?: IAsaasCommercialInfoExpiration;
+
+  /** feat-275 — contato do titular (fallback de destinatário dos avisos de KYC). */
+  holder_contact?: IAsaasHolderContact;
+
+  /** feat-275 — dedup dos avisos de KYC. */
+  kyc_notifications?: IAsaasKycNotificationState;
+
+  /** feat-275 — estado da chave de API (nunca o valor). */
+  access_token_meta?: IAsaasAccessTokenMeta;
+
   // Input data used only when creating subaccounts (not persisted).
   subaccount_input?: IAsaasSubaccountInput;
 

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

@@ -137,6 +137,25 @@ export interface INotificationAttachment {
     /** Conteúdo em base64. <= 64 KB já codificado. */
     content_base64: string;
 }
+/** Campos compartilhados pelo conteúdo de email novo e de resposta. */
+interface INotificationEmailContentBase {
+    /** Versões textuais do corpo livre. */
+    body_text?: string;
+    body_html?: string;
+    /** Identificador interno da conversa Hub-Omni. */
+    thread_id?: string;
+}
+/** Conteúdo de email humano. Replies podem reutilizar o assunto persistido. */
+export type INotificationEmailContent = (INotificationEmailContentBase & {
+    /** Obrigatório ao iniciar uma conversa. */
+    subject: string;
+    reply_to_message_id?: never;
+}) | (INotificationEmailContentBase & {
+    /** Opcional na resposta: o backend reutiliza o assunto da conversa. */
+    subject?: string;
+    /** ID interno Hub-Omni da mensagem respondida; headers derivam no backend. */
+    reply_to_message_id: string;
+});
 export interface INotificationSendPayload {
     kind: "notification.send";
     classification?: string;
@@ -145,6 +164,8 @@ export interface INotificationSendPayload {
     channel: INotificationChannelRef;
     template?: INotificationTemplateRef;
     variables?: Record<string, unknown>;
+    /** Dados de email livre. Para payloads humanos, subject é obrigatório. */
+    email?: INotificationEmailContent;
     /**
      * WhatsApp (sessão): texto livre enviado via Hermes `type: text` (sem HSM).
      * Mutuamente exclusivo com `template.template_id` para `channel.type === 'whatsapp'`.
@@ -195,6 +216,8 @@ export interface INotificationMessage extends IFireDoc {
     template?: INotificationTemplateRef;
     /** Snapshot quando o envio foi texto de sessão WhatsApp (sem template). */
     body_text?: string;
+    /** Snapshot do assunto/HTML/threading de envios humanos por email. */
+    email?: INotificationEmailContent;
     recipient: INotificationRecipient;
     variables?: Record<string, unknown>;
     status: NotificationMessageStatus;
@@ -246,6 +269,8 @@ export interface IEmailSmtpConfig {
      * Formato: 'projects/{projectId}/secrets/{secretId}/versions/latest'
      */
     password_secret_ref: string;
+    /** Limite opcional do total de anexos por mensagem, em bytes. */
+    max_attachment_total_bytes?: number;
 }
 /**
  * Provider de transporte do canal de email.

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

@@ -222,6 +222,29 @@ export interface INotificationAttachment {
   content_base64: string;
 }
 
+/** Campos compartilhados pelo conteúdo de email novo e de resposta. */
+interface INotificationEmailContentBase {
+  /** Versões textuais do corpo livre. */
+  body_text?: string;
+  body_html?: string;
+  /** Identificador interno da conversa Hub-Omni. */
+  thread_id?: string;
+}
+
+/** Conteúdo de email humano. Replies podem reutilizar o assunto persistido. */
+export type INotificationEmailContent =
+  | (INotificationEmailContentBase & {
+      /** Obrigatório ao iniciar uma conversa. */
+      subject: string;
+      reply_to_message_id?: never;
+    })
+  | (INotificationEmailContentBase & {
+      /** Opcional na resposta: o backend reutiliza o assunto da conversa. */
+      subject?: string;
+      /** ID interno Hub-Omni da mensagem respondida; headers derivam no backend. */
+      reply_to_message_id: string;
+    });
+
 export interface INotificationSendPayload {
   kind: "notification.send";
 
@@ -237,6 +260,9 @@ export interface INotificationSendPayload {
   template?: INotificationTemplateRef;
   variables?: Record<string, unknown>; // resolved upstream (Automation Hub / Task Runner)
 
+  /** Dados de email livre. Para payloads humanos, subject é obrigatório. */
+  email?: INotificationEmailContent;
+
   /**
    * WhatsApp (sessão): texto livre enviado via Hermes `type: text` (sem HSM).
    * Mutuamente exclusivo com `template.template_id` para `channel.type === 'whatsapp'`.
@@ -313,6 +339,8 @@ export interface INotificationMessage extends IFireDoc {
   template?: INotificationTemplateRef;
   /** Snapshot quando o envio foi texto de sessão WhatsApp (sem template). */
   body_text?: string;
+  /** Snapshot do assunto/HTML/threading de envios humanos por email. */
+  email?: INotificationEmailContent;
 
   // Recipient snapshot
   recipient: INotificationRecipient;
@@ -394,6 +422,8 @@ export interface IEmailSmtpConfig {
    * Formato: 'projects/{projectId}/secrets/{secretId}/versions/latest'
    */
   password_secret_ref: string;
+  /** Limite opcional do total de anexos por mensagem, em bytes. */
+  max_attachment_total_bytes?: number;
 }
 
 /**

package/package.json

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