@wildo-ai/external-connectors-models 1.1.10 → 1.1.12

package/dist/esm/protocols/electronic-signature.external-connectors-models.schemas.js

@@ -0,0 +1,134 @@
+import { z } from "zod";
+//===============================================================
+// Electronic Signature Provider (#2293)
+// --------
+// A deliverable sent to a trust-service vendor so the people who must sign it apply their own electronic signature
+// (level 2 of epic #2916). The vendor renders the signing page, authenticates each signer and returns the signed
+// document; the engine never trusts the vendor's word that it is signed (it validates the document at receipt).
+//
+// ## Why the exchange is a sequence of steps
+//
+// Vendors do not agree on how many calls a request takes. DocuSign creates an envelope, its documents and its recipients
+// in one call; Yousign and IgniSign create the request, upload each document, add each signer and then activate (or
+// publish) it, each a call of its own. So creation is a CONVERSATION the provider drives with pure functions: the
+// engine asks for the first request, sends it, hands the answer back with whatever the provider chose to carry, and
+// repeats until the provider answers SENT or REFUSED. The provider never touches the network, a key or a clock.
+//
+// spec-cite: N/A — the step counts above are a paraphrase of each vendor's public API reference (DocuSign eSignature
+// REST `Envelopes:create`; Yousign API v3 "create a signature request, add documents and signers, activate"; IgniSign v4
+// init, documents, signers, publish), cited for the shape the exchange must admit, not quoted.
+//
+// ## What a provider is given
+//
+// The document's bytes and name, its SHA-256, the required level, and per signer the opaque reference the engine keys
+// them by, their name and their contact: what a vendor needs to send the invitation and nothing about the tenant, the
+// record or the approval. Contact data comes from the operator's database; that is a stated residual of the epic.
+//===============================================================
+/**
+ * The level of electronic signature a deliverable requires, and a provider declares it can apply.
+ *
+ * eIDAS Art. 3(10) and Art. 26: an advanced signature is uniquely linked to and capable of identifying the signatory,
+ * created with data under their sole control, and linked to the signed data so that any later change is detectable.
+ * Qualified signatures (Art. 3(12)) are deliberately not a member (Paul, 2026-10-19).
+ *
+ * spec-cite: Regulation (EU) No 910/2014, Art. 3(10), 3(11), 3(12) and Art. 26 — the definitions of simple, advanced
+ * and qualified electronic signatures; paraphrased, not quoted.
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ */
+export var ElectronicSignature_Level;
+(function (ElectronicSignature_Level) {
+    /** A simple electronic signature: data the signatory attaches to sign (Art. 3(10)). Any vendor applies it. */
+    ElectronicSignature_Level["SIMPLE"] = "simple";
+    /** An advanced electronic signature (Art. 26), applied by a trust-service vendor. */
+    ElectronicSignature_Level["ADVANCED"] = "advanced";
+})(ElectronicSignature_Level || (ElectronicSignature_Level = {}));
+/** The levels from weakest to strongest: the one order {@link electronicSignatureLevelSatisfies} compares on. */
+const ELECTRONIC_SIGNATURE_LEVEL_ORDER = [ElectronicSignature_Level.SIMPLE, ElectronicSignature_Level.ADVANCED];
+/**
+ * Whether a signature at `achieved` meets a requirement of `required`. An advanced signature is also a simple one, so it
+ * meets a SIMPLE requirement; a simple one never meets an ADVANCED requirement.
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ */
+export function electronicSignatureLevelSatisfies(achieved, required) {
+    return ELECTRONIC_SIGNATURE_LEVEL_ORDER.indexOf(achieved) >= ELECTRONIC_SIGNATURE_LEVEL_ORDER.indexOf(required);
+}
+/**
+ * Whether a provider's contract reaches the vendor's PRODUCTION environment or one of its test environments. Evidence
+ * signed in a test environment is refused in production (its chain does not reach the production anchors), and a
+ * contract declaring a test environment is refused at startup in a production runtime.
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ */
+export var ElectronicSignature_VendorEnvironment;
+(function (ElectronicSignature_VendorEnvironment) {
+    ElectronicSignature_VendorEnvironment["PRODUCTION"] = "production";
+    ElectronicSignature_VendorEnvironment["NON_PRODUCTION"] = "non_production";
+})(ElectronicSignature_VendorEnvironment || (ElectronicSignature_VendorEnvironment = {}));
+/**
+ * The electronic-signature operation vocabulary — disjoint from every other protocol's operation keys.
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ */
+export var ElectronicSignatureProvider_OperationKey;
+(function (ElectronicSignatureProvider_OperationKey) {
+    /** Create a request at the vendor: the document, its signers, the level. */
+    ElectronicSignatureProvider_OperationKey["SEND_REQUEST"] = "electronicSignature.sendRequest";
+    /** Re-read a request's status at the vendor. */
+    ElectronicSignatureProvider_OperationKey["READ_REQUEST"] = "electronicSignature.readRequest";
+    /** Download the signed document of a request the vendor reports complete. */
+    ElectronicSignatureProvider_OperationKey["DOWNLOAD_SIGNED_DOCUMENT"] = "electronicSignature.downloadSignedDocument";
+    /** Cancel an open request at the vendor, and (where the provider deletes on removal) delete it there. */
+    ElectronicSignatureProvider_OperationKey["CANCEL_REQUEST"] = "electronicSignature.cancelRequest";
+})(ElectronicSignatureProvider_OperationKey || (ElectronicSignatureProvider_OperationKey = {}));
+/**
+ * Where the vendor says a request stands, read from its own API. A CLAIM of the vendor's: the engine moves its own record
+ * on it (declined, expired, cancelled, partially signed) but never to SIGNED, which needs the validated document.
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ */
+export var ElectronicSignature_VendorRequestStatus;
+(function (ElectronicSignature_VendorRequestStatus) {
+    /** Created and waiting for its signers; nobody has signed. */
+    ElectronicSignature_VendorRequestStatus["PENDING"] = "pending";
+    /** Some signers signed, others have not yet. */
+    ElectronicSignature_VendorRequestStatus["PARTIALLY_SIGNED"] = "partially_signed";
+    /** Every signer signed; the signed document can be downloaded. */
+    ElectronicSignature_VendorRequestStatus["COMPLETED"] = "completed";
+    /** A signer refused. */
+    ElectronicSignature_VendorRequestStatus["DECLINED"] = "declined";
+    /** The vendor's deadline passed. */
+    ElectronicSignature_VendorRequestStatus["EXPIRED"] = "expired";
+    /** Cancelled at the vendor. */
+    ElectronicSignature_VendorRequestStatus["CANCELLED"] = "cancelled";
+})(ElectronicSignature_VendorRequestStatus || (ElectronicSignature_VendorRequestStatus = {}));
+/** What a provider reads from the vendor's answer to a status re-read. */
+export const ElectronicSignature_VendorRequestReadingSchema = z.object({
+    status: z.enum(ElectronicSignature_VendorRequestStatus),
+    /** The vendor's references of the signers the vendor reports as signed, when it says. */
+    signedVendorSignerReferences: z.array(z.string().min(1)).optional(),
+});
+/** What a provider reads from the vendor's answer to a cancellation. */
+export var ElectronicSignature_CancellationOutcome;
+(function (ElectronicSignature_CancellationOutcome) {
+    /** The request is cancelled at the vendor (now, or already). */
+    ElectronicSignature_CancellationOutcome["CANCELLED"] = "cancelled";
+    /** The vendor refuses: the request is already final there (signed, declined, expired). */
+    ElectronicSignature_CancellationOutcome["ALREADY_FINAL"] = "already_final";
+    /** The vendor could not be asked or did not answer usably. Try again. */
+    ElectronicSignature_CancellationOutcome["FAILED"] = "failed";
+})(ElectronicSignature_CancellationOutcome || (ElectronicSignature_CancellationOutcome = {}));
+/**
+ * The provider's limits the engine enforces on its side: how many steps a sending may take, and how large a document
+ * and a signed document may be. A provider declares its vendor's documented maxima.
+ */
+export const ElectronicSignature_LimitsSchema = z.object({
+    /** The most requests one sending makes (every step of the conversation counts). */
+    maxSendSteps: z.number().int().positive().max(64),
+    /** The largest document, in bytes, the vendor accepts. */
+    maxDocumentBytes: z.number().int().positive(),
+    /** The largest signed document, in bytes, the engine reads back. */
+    maxSignedDocumentBytes: z.number().int().positive(),
+});
+//# sourceMappingURL=electronic-signature.external-connectors-models.schemas.js.map

package/dist/esm/protocols/electronic-signature.external-connectors-models.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"electronic-signature.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../src/protocols/electronic-signature.external-connectors-models.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\"\nimport type { API_HttpMethod } from \"../core/commons.external-connectors-models.schemas\"\n\n//===============================================================\n// Electronic Signature Provider (#2293)\n// --------\n// A deliverable sent to a trust-service vendor so the people who must sign it apply their own electronic signature\n// (level 2 of epic #2916). The vendor renders the signing page, authenticates each signer and returns the signed\n// document; the engine never trusts the vendor's word that it is signed (it validates the document at receipt).\n//\n// ## Why the exchange is a sequence of steps\n//\n// Vendors do not agree on how many calls a request takes. DocuSign creates an envelope, its documents and its recipients\n// in one call; Yousign and IgniSign create the request, upload each document, add each signer and then activate (or\n// publish) it, each a call of its own. So creation is a CONVERSATION the provider drives with pure functions: the\n// engine asks for the first request, sends it, hands the answer back with whatever the provider chose to carry, and\n// repeats until the provider answers SENT or REFUSED. The provider never touches the network, a key or a clock.\n//\n// spec-cite: N/A — the step counts above are a paraphrase of each vendor's public API reference (DocuSign eSignature\n// REST `Envelopes:create`; Yousign API v3 \"create a signature request, add documents and signers, activate\"; IgniSign v4\n// init, documents, signers, publish), cited for the shape the exchange must admit, not quoted.\n//\n// ## What a provider is given\n//\n// The document's bytes and name, its SHA-256, the required level, and per signer the opaque reference the engine keys\n// them by, their name and their contact: what a vendor needs to send the invitation and nothing about the tenant, the\n// record or the approval. Contact data comes from the operator's database; that is a stated residual of the epic.\n//===============================================================\n\n/**\n * The level of electronic signature a deliverable requires, and a provider declares it can apply.\n *\n * eIDAS Art. 3(10) and Art. 26: an advanced signature is uniquely linked to and capable of identifying the signatory,\n * created with data under their sole control, and linked to the signed data so that any later change is detectable.\n * Qualified signatures (Art. 3(12)) are deliberately not a member (Paul, 2026-10-19).\n *\n * spec-cite: Regulation (EU) No 910/2014, Art. 3(10), 3(11), 3(12) and Art. 26 — the definitions of simple, advanced\n * and qualified electronic signatures; paraphrased, not quoted.\n *\n * Import path: `@wildo-ai/external-connectors-models`.\n */\nexport enum ElectronicSignature_Level {\n  /** A simple electronic signature: data the signatory attaches to sign (Art. 3(10)). Any vendor applies it. */\n  SIMPLE = \"simple\",\n  /** An advanced electronic signature (Art. 26), applied by a trust-service vendor. */\n  ADVANCED = \"advanced\",\n}\n\n/** The levels from weakest to strongest: the one order {@link electronicSignatureLevelSatisfies} compares on. */\nconst ELECTRONIC_SIGNATURE_LEVEL_ORDER: readonly ElectronicSignature_Level[] = [ElectronicSignature_Level.SIMPLE, ElectronicSignature_Level.ADVANCED]\n\n/**\n * Whether a signature at `achieved` meets a requirement of `required`. An advanced signature is also a simple one, so it\n * meets a SIMPLE requirement; a simple one never meets an ADVANCED requirement.\n *\n * Import path: `@wildo-ai/external-connectors-models`.\n */\nexport function electronicSignatureLevelSatisfies(achieved: ElectronicSignature_Level, required: ElectronicSignature_Level): boolean {\n  return ELECTRONIC_SIGNATURE_LEVEL_ORDER.indexOf(achieved) >= ELECTRONIC_SIGNATURE_LEVEL_ORDER.indexOf(required)\n}\n\n/**\n * Whether a provider's contract reaches the vendor's PRODUCTION environment or one of its test environments. Evidence\n * signed in a test environment is refused in production (its chain does not reach the production anchors), and a\n * contract declaring a test environment is refused at startup in a production runtime.\n *\n * Import path: `@wildo-ai/external-connectors-models`.\n */\nexport enum ElectronicSignature_VendorEnvironment {\n  PRODUCTION = \"production\",\n  NON_PRODUCTION = \"non_production\",\n}\n\n/**\n * The electronic-signature operation vocabulary — disjoint from every other protocol's operation keys.\n *\n * Import path: `@wildo-ai/external-connectors-models`.\n */\nexport enum ElectronicSignatureProvider_OperationKey {\n  /** Create a request at the vendor: the document, its signers, the level. */\n  SEND_REQUEST = \"electronicSignature.sendRequest\",\n  /** Re-read a request's status at the vendor. */\n  READ_REQUEST = \"electronicSignature.readRequest\",\n  /** Download the signed document of a request the vendor reports complete. */\n  DOWNLOAD_SIGNED_DOCUMENT = \"electronicSignature.downloadSignedDocument\",\n  /** Cancel an open request at the vendor, and (where the provider deletes on removal) delete it there. */\n  CANCEL_REQUEST = \"electronicSignature.cancelRequest\",\n}\n\n/**\n * Where the vendor says a request stands, read from its own API. A CLAIM of the vendor's: the engine moves its own record\n * on it (declined, expired, cancelled, partially signed) but never to SIGNED, which needs the validated document.\n *\n * Import path: `@wildo-ai/external-connectors-models`.\n */\nexport enum ElectronicSignature_VendorRequestStatus {\n  /** Created and waiting for its signers; nobody has signed. */\n  PENDING = \"pending\",\n  /** Some signers signed, others have not yet. */\n  PARTIALLY_SIGNED = \"partially_signed\",\n  /** Every signer signed; the signed document can be downloaded. */\n  COMPLETED = \"completed\",\n  /** A signer refused. */\n  DECLINED = \"declined\",\n  /** The vendor's deadline passed. */\n  EXPIRED = \"expired\",\n  /** Cancelled at the vendor. */\n  CANCELLED = \"cancelled\",\n}\n\n/**\n * One HTTP request a provider function asks the engine to send. The engine owns the host (the contract's base URL, never\n * anything here), the API-key header, the timeout and the redirect refusal; `path` is appended to the base URL and must\n * start with `/` (an absolute URL is refused). `body` is already encoded; `transportHeaders` describe it (a\n * `content-type` at minimum when there is a body) and can never replace the engine's authentication header.\n */\nexport interface ElectronicSignature_ProviderRequest {\n  readonly method: API_HttpMethod\n  readonly path: string\n  readonly body?: string | Uint8Array\n  readonly transportHeaders?: Readonly<Record<string, string>>\n}\n\n/** A vendor answer as the engine hands it to a provider function: status, lower-cased headers, best-effort decoded body. */\nexport interface ElectronicSignature_ProviderResponse {\n  readonly status: number\n  readonly headers: Readonly<Record<string, string>>\n  readonly body: unknown\n}\n\n/** One signer of a request, as a provider is given it. */\nexport interface ElectronicSignature_SignerInput {\n  /** The engine's own opaque reference to this signer (its signer row). The provider maps it to the vendor's signer. */\n  readonly signerRef: string\n  /** The order in which the vendor asks the signers, from 0. Equal orders sign in parallel. */\n  readonly signingOrder: number\n  readonly firstName: string\n  readonly lastName: string\n  readonly email: string\n}\n\n/** What a provider is given to send a request. Nothing about the tenant, the record or the approval. */\nexport interface ElectronicSignature_SendInput {\n  readonly document: Uint8Array\n  readonly documentName: string\n  readonly mimeType: string\n  /** The SHA-256 of `document`, lower-case hex, as the file recorded it. */\n  readonly contentSha256: string\n  readonly level: ElectronicSignature_Level\n  readonly signers: readonly ElectronicSignature_SignerInput[]\n}\n\n/**\n * What a provider answers at each step of sending: another request to make (with JSON-safe state it wants back), or\n * the end, SENT or REFUSED.\n */\nexport type ElectronicSignature_SendStep =\n  | { readonly kind: \"request\"; readonly request: ElectronicSignature_ProviderRequest; readonly carry?: unknown }\n  | {\n      readonly kind: \"sent\"\n      /** The vendor's references for the request: several when the vendor splits it per document. Never empty. */\n      readonly vendorReferences: readonly string[]\n      /** The vendor's reference to each signer, keyed by the engine's `signerRef`. */\n      readonly vendorSignerReferences: Readonly<Record<string, string>>\n    }\n  | {\n      readonly kind: \"refused\"\n      readonly reason: string\n      /** Whether asking again later could succeed (a vendor outage or throttle), as opposed to a refusal of the request. */\n      readonly retryable: boolean\n    }\n\n/** What a provider reads from the vendor's answer to a status re-read. */\nexport const ElectronicSignature_VendorRequestReadingSchema = z.object({\n  status: z.enum(ElectronicSignature_VendorRequestStatus),\n  /** The vendor's references of the signers the vendor reports as signed, when it says. */\n  signedVendorSignerReferences: z.array(z.string().min(1)).optional(),\n})\nexport type ElectronicSignature_VendorRequestReading = z.infer<typeof ElectronicSignature_VendorRequestReadingSchema>\n\n/** What a provider reads from the vendor's answer to a cancellation. */\nexport enum ElectronicSignature_CancellationOutcome {\n  /** The request is cancelled at the vendor (now, or already). */\n  CANCELLED = \"cancelled\",\n  /** The vendor refuses: the request is already final there (signed, declined, expired). */\n  ALREADY_FINAL = \"already_final\",\n  /** The vendor could not be asked or did not answer usably. Try again. */\n  FAILED = \"failed\",\n}\n\n/**\n * The provider's limits the engine enforces on its side: how many steps a sending may take, and how large a document\n * and a signed document may be. A provider declares its vendor's documented maxima.\n */\nexport const ElectronicSignature_LimitsSchema = z.object({\n  /** The most requests one sending makes (every step of the conversation counts). */\n  maxSendSteps: z.number().int().positive().max(64),\n  /** The largest document, in bytes, the vendor accepts. */\n  maxDocumentBytes: z.number().int().positive(),\n  /** The largest signed document, in bytes, the engine reads back. */\n  maxSignedDocumentBytes: z.number().int().positive(),\n})\nexport type ElectronicSignature_Limits = z.infer<typeof ElectronicSignature_LimitsSchema>\n"]}

package/dist/esm/protocols/email-inbound.standard-interface.schemas.d.ts

@@ -64,6 +64,7 @@ export type StandardInboundEmail_Attachment = z.infer<typeof StandardInboundEmai
 export declare const StandardInboundEmail_NotificationSchema: z.ZodObject<{
     providerMessageId: z.ZodString;
     receivedFor: z.ZodArray<z.ZodString>;
+    namedAddresses: z.ZodOptional<z.ZodArray<z.ZodString>>;
     receivedAt: z.ZodCoercedDate<unknown>;
 }, z.core.$strip>;
 export type StandardInboundEmail_Notification = z.infer<typeof StandardInboundEmail_NotificationSchema>;
@@ -118,6 +119,77 @@ export declare const StandardInboundEmail_MessageSchema: z.ZodObject<{
     rawRef: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type StandardInboundEmail_Message = z.infer<typeof StandardInboundEmail_MessageSchema>;
+/**
+ * How a receiving provider hands the engine a message (#3395). A closed vocabulary because the engine's whole path
+ * from the webhook to the stored message depends on it.
+ */
+export declare enum InboundEmailMessageDelivery {
+    /**
+     * The webhook NOTIFIES: a small signed notification names the message, and the engine fetches the message, its
+     * attachments and its original bytes through the provider's API (Resend). The default.
+     */
+    FETCHED = "fetched",
+    /**
+     * The webhook IS the message: the whole message, attachments included as base64, arrives in the request body, and
+     * nothing is fetched (Postmark; Mailgun's routes post the message too). The engine reads the bytes out of the body
+     * it verified and stores them through the same path a fetched message's bytes take.
+     */
+    PUSHED = "pushed"
+}
+/**
+ * A pushed message as a provider module maps it (#3395): the standard message, and the bytes its attachments and its
+ * original copy arrived with. The engine re-validates it, refuses an attachment whose content is absent or not
+ * base64, and refuses a `rawRef` with no raw content (or raw content with no `rawRef`).
+ */
+export declare const StandardInboundEmail_PushedMessageSchema: z.ZodObject<{
+    message: z.ZodObject<{
+        providerMessageId: z.ZodString;
+        messageId: z.ZodOptional<z.ZodString>;
+        inReplyTo: z.ZodOptional<z.ZodString>;
+        references: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        from: z.ZodObject<{
+            address: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        to: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        cc: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            address: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        replyTo: z.ZodOptional<z.ZodObject<{
+            address: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        receivedFor: z.ZodArray<z.ZodString>;
+        subject: z.ZodDefault<z.ZodString>;
+        textBody: z.ZodOptional<z.ZodString>;
+        htmlBody: z.ZodOptional<z.ZodString>;
+        headers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        authentication: z.ZodObject<{
+            spf: z.ZodEnum<typeof EmailAuthenticationVerdict>;
+            dkim: z.ZodEnum<typeof EmailAuthenticationVerdict>;
+            dmarc: z.ZodEnum<typeof EmailAuthenticationVerdict>;
+            dmarcAligned: z.ZodBoolean;
+        }, z.core.$strip>;
+        attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            ref: z.ZodString;
+            filename: z.ZodString;
+            contentType: z.ZodString;
+            sizeBytes: z.ZodNumber;
+            contentId: z.ZodOptional<z.ZodString>;
+            disposition: z.ZodOptional<z.ZodEnum<typeof EmailAttachmentDisposition>>;
+        }, z.core.$strip>>>;
+        sizeBytes: z.ZodOptional<z.ZodNumber>;
+        receivedAt: z.ZodCoercedDate<unknown>;
+        rawRef: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    attachmentContents: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    raw: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StandardInboundEmail_PushedMessage = z.infer<typeof StandardInboundEmail_PushedMessageSchema>;
 /** The bytes of one attachment. */
 export interface StandardInboundEmail_OpenedAttachment {
     readonly bytes: Uint8Array;
@@ -204,8 +276,20 @@ export interface StandardInboundEmail_Interface {
 export type InboundEmailProviderRequest = {
     readonly path: string;
     readonly method?: EmailProviderHttpMethod;
+    readonly headers?: Readonly<Record<string, string>>;
+    /** A JSON body (Resend). At most one of `jsonBody` and `multipartFormFields`. */
     readonly jsonBody?: unknown;
+    readonly multipartFormFields?: never;
+} | {
+    readonly path: string;
+    readonly method?: EmailProviderHttpMethod;
     readonly headers?: Readonly<Record<string, string>>;
+    /**
+     * Text fields sent as a `multipart/form-data` body (#3395), for an API documented to take one (Mailgun's domains
+     * API). The engine encodes it and sets the content type with its boundary.
+     */
+    readonly multipartFormFields: Readonly<Record<string, string>>;
+    readonly jsonBody?: never;
 } | {
     readonly url: string;
     readonly headers?: Readonly<Record<string, string>>;
@@ -217,6 +301,7 @@ export type InboundEmailProviderRequest = {
 export declare enum EmailProviderHttpMethod {
     GET = "GET",
     POST = "POST",
+    PUT = "PUT",
     PATCH = "PATCH",
     DELETE = "DELETE"
 }

package/dist/esm/protocols/email-inbound.standard-interface.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email-inbound.standard-interface.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/email-inbound.standard-interface.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"email-inbound.standard-interface.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/email-inbound.standard-interface.schemas.ts"],"names":[],"mappings":"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"}

package/dist/esm/protocols/email-inbound.standard-interface.schemas.js

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { z_wireDate } from '@wildo-ai/zod-decorators';
 // ===============================================================
 // Standard Inbound Email Interface (#1630)
 // --------
@@ -81,7 +82,15 @@ export const StandardInboundEmail_NotificationSchema = z.object({
     providerMessageId: z.string().min(1),
     /** The addresses the message was delivered FOR (the SMTP envelope recipients), which routing reads. */
     receivedFor: z.array(z.string().min(1)).min(1),
-    receivedAt: z.coerce.date(),
+    /**
+     * Every address the stored notification body names, sender first, then its recipients and copied (#1642). Read for one
+     * purpose only: the subject keys of the delivery that stores the body, so a person's erasure finds and deletes it, and
+     * their access export reads it. Never trusted for routing, identity or anything else. Absent when the provider module
+     * does not project it, and then the delivery is keyed by `receivedFor` alone.
+     */
+    namedAddresses: z.array(z.string().min(1)).optional(),
+    // Framework-internal z_wireDate (#3480): a provider adapter parses the provider's own HTTP JSON with this contract directly (email-inbound-provider-adapter), outside every framework conversion.
+    receivedAt: z_wireDate(),
 });
 /**
  * One received message, provider-neutral.
@@ -107,13 +116,47 @@ export const StandardInboundEmail_MessageSchema = z.object({
     authentication: StandardInboundEmail_AuthenticationSchema,
     attachments: z.array(StandardInboundEmail_AttachmentSchema).default([]),
     sizeBytes: z.number().int().nonnegative().optional(),
-    receivedAt: z.coerce.date(),
+    receivedAt: z_wireDate(),
     /**
      * Where the ORIGINAL message bytes are, when the provider keeps them (#1600). Opaque to the engine; handed
      * to `openRaw`. Absent when the provider offers no raw copy — the engine then keeps no raw MIME.
      */
     rawRef: z.string().min(1).optional(),
 });
+/**
+ * How a receiving provider hands the engine a message (#3395). A closed vocabulary because the engine's whole path
+ * from the webhook to the stored message depends on it.
+ */
+export var InboundEmailMessageDelivery;
+(function (InboundEmailMessageDelivery) {
+    /**
+     * The webhook NOTIFIES: a small signed notification names the message, and the engine fetches the message, its
+     * attachments and its original bytes through the provider's API (Resend). The default.
+     */
+    InboundEmailMessageDelivery["FETCHED"] = "fetched";
+    /**
+     * The webhook IS the message: the whole message, attachments included as base64, arrives in the request body, and
+     * nothing is fetched (Postmark; Mailgun's routes post the message too). The engine reads the bytes out of the body
+     * it verified and stores them through the same path a fetched message's bytes take.
+     */
+    InboundEmailMessageDelivery["PUSHED"] = "pushed";
+})(InboundEmailMessageDelivery || (InboundEmailMessageDelivery = {}));
+/**
+ * A pushed message as a provider module maps it (#3395): the standard message, and the bytes its attachments and its
+ * original copy arrived with. The engine re-validates it, refuses an attachment whose content is absent or not
+ * base64, and refuses a `rawRef` with no raw content (or raw content with no `rawRef`).
+ */
+export const StandardInboundEmail_PushedMessageSchema = z.object({
+    message: StandardInboundEmail_MessageSchema,
+    /** Each attachment's content as the vendor posted it, base64, keyed by the attachment's `ref`. */
+    attachmentContents: z.record(z.string(), z.string()).default({}),
+    /**
+     * The original message as text, when the vendor includes it (Postmark's `RawEmail`, a server option), stored under
+     * the message's `rawRef`. A JSON string, so it is the vendor's text rendering of the MIME message, re-encoded as UTF-8:
+     * not necessarily byte-identical to what the sending server transmitted.
+     */
+    raw: z.string().optional(),
+});
 // ===============================================================
 // Receiving domains (#1600)
 // ===============================================================
@@ -154,6 +197,7 @@ export var EmailProviderHttpMethod;
 (function (EmailProviderHttpMethod) {
     EmailProviderHttpMethod["GET"] = "GET";
     EmailProviderHttpMethod["POST"] = "POST";
+    EmailProviderHttpMethod["PUT"] = "PUT";
     EmailProviderHttpMethod["PATCH"] = "PATCH";
     EmailProviderHttpMethod["DELETE"] = "DELETE";
 })(EmailProviderHttpMethod || (EmailProviderHttpMethod = {}));

package/dist/esm/protocols/email-inbound.standard-interface.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"email-inbound.standard-interface.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/email-inbound.standard-interface.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\n\n// ===============================================================\n// Standard Inbound Email Interface (#1630)\n// --------\n// The canonical shape of a message an EMAIL_INBOUND provider RECEIVED for the application, and the\n// three calls the engine makes on the provider to get it. Provider-agnostic: a vendor's module maps\n// its own notification and message payloads onto these schemas, and nothing past that mapping ever\n// sees a vendor field.\n//\n// There is deliberately NO `verify` here. The notification reaches the application through the\n// provider's `WEBHOOK_ORIGINATOR` endpoint (the `inbound-email` key, capability `EMAIL_INBOUND`), and\n// that endpoint is verified by the ENGINE-owned scheme its `signatureConfig` names (#1596). A\n// provider that verified its own notifications would put the one fail-closed decision of the inbound\n// path in vendor code, where nothing checks it.\n// ===============================================================\n\n/**\n * One authentication method's result, as a receiving server records it in `Authentication-Results`.\n *\n * The union of the results the three methods define, so one vocabulary serves SPF, DKIM and DMARC.\n * Two members go beyond what a DMARC result can be — `SOFTFAIL` (SPF only) and `POLICY` (DKIM and\n * SPF) — and are here because mapping them onto a neighbour would record a result the receiver did\n * not report: a softfail is neither a fail nor neutral.\n *\n * spec-cite: RFC 8601 §2.7.1 (DKIM results: none, pass, fail, policy, neutral, temperror, permerror)\n * and §2.7.2 (SPF results: none, pass, fail, softfail, neutral, temperror, permerror, plus policy\n * from §2.4); DMARC results per RFC 7489 §11.2 (none, pass, fail, temperror, permerror). Fetched 2026-09-27.\n */\nexport enum EmailAuthenticationVerdict {\n  PASS = \"pass\",\n  FAIL = \"fail\",\n  SOFTFAIL = \"softfail\",\n  NEUTRAL = \"neutral\",\n  NONE = \"none\",\n  POLICY = \"policy\",\n  TEMPERROR = \"temperror\",\n  PERMERROR = \"permerror\",\n}\n\n/**\n * What the receiving provider concluded about a message's origin.\n *\n * `dmarcAligned` is kept beside the DMARC verdict rather than folded into it because it is the fact\n * sender assurance is built on: DMARC authenticates the `From` DOMAIN by requiring that it align with\n * an identifier SPF or DKIM authenticated. A provider that reports DMARC `pass` has already required\n * alignment, so for most vendors `dmarcAligned` equals `dmarc === PASS`; it is a separate field so a\n * vendor that reports the two independently is not forced to invent one from the other.\n */\nexport const StandardInboundEmail_AuthenticationSchema = z.object({\n  spf: z.enum(EmailAuthenticationVerdict),\n  dkim: z.enum(EmailAuthenticationVerdict),\n  dmarc: z.enum(EmailAuthenticationVerdict),\n  dmarcAligned: z.boolean(),\n});\n\nexport type StandardInboundEmail_Authentication = z.infer<typeof StandardInboundEmail_AuthenticationSchema>;\n\nexport const StandardInboundEmail_AddressSchema = z.object({\n  address: z.string().min(1),\n  name: z.string().optional(),\n});\n\nexport type StandardInboundEmail_Address = z.infer<typeof StandardInboundEmail_AddressSchema>;\n\n/** How a MIME part asks to be presented (`Content-Disposition`). spec-cite: RFC 2183 §2.1 (`inline`) and §2.2 (`attachment`). */\nexport enum EmailAttachmentDisposition {\n  ATTACHMENT = \"attachment\",\n  INLINE = \"inline\",\n}\n\n/** One attachment as the provider describes it. The bytes are fetched through `openAttachment`, never inlined. */\nexport const StandardInboundEmail_AttachmentSchema = z.object({\n  /** Opaque to the engine; handed back to `openAttachment`. */\n  ref: z.string().min(1),\n  filename: z.string(),\n  contentType: z.string(),\n  sizeBytes: z.number().int().nonnegative(),\n  /** The `Content-ID` of an inline part, without angle brackets. */\n  contentId: z.string().optional(),\n  disposition: z.enum(EmailAttachmentDisposition).optional(),\n});\n\nexport type StandardInboundEmail_Attachment = z.infer<typeof StandardInboundEmail_AttachmentSchema>;\n\n/**\n * What a provider's notification says, parsed. Small on purpose: a notification tells the engine\n * THAT a message arrived and where to fetch it, and nothing past this point trusts it for more.\n */\nexport const StandardInboundEmail_NotificationSchema = z.object({\n  /** The provider's id for the message — what `fetchMessage` takes, and the dedup key of the channel delivery. */\n  providerMessageId: z.string().min(1),\n  /** The addresses the message was delivered FOR (the SMTP envelope recipients), which routing reads. */\n  receivedFor: z.array(z.string().min(1)).min(1),\n  receivedAt: z.coerce.date(),\n});\n\nexport type StandardInboundEmail_Notification = z.infer<typeof StandardInboundEmail_NotificationSchema>;\n\n/**\n * One received message, provider-neutral.\n *\n * The threading headers are separated out because the engine correlates threads from them;\n * `headers` carries the rest, for a channel record that chooses to keep an allow-listed subset.\n */\nexport const StandardInboundEmail_MessageSchema = z.object({\n  providerMessageId: z.string().min(1),\n  /** The RFC 5322 `Message-ID`, angle brackets included, or absent when the sender set none. */\n  messageId: z.string().optional(),\n  inReplyTo: z.string().optional(),\n  references: z.array(z.string()).default([]),\n  from: StandardInboundEmail_AddressSchema,\n  to: z.array(StandardInboundEmail_AddressSchema).default([]),\n  cc: z.array(StandardInboundEmail_AddressSchema).default([]),\n  replyTo: StandardInboundEmail_AddressSchema.optional(),\n  receivedFor: z.array(z.string().min(1)).min(1),\n  subject: z.string().default(\"\"),\n  textBody: z.string().optional(),\n  htmlBody: z.string().optional(),\n  headers: z.record(z.string(), z.string()).default({}),\n  authentication: StandardInboundEmail_AuthenticationSchema,\n  attachments: z.array(StandardInboundEmail_AttachmentSchema).default([]),\n  sizeBytes: z.number().int().nonnegative().optional(),\n  receivedAt: z.coerce.date(),\n  /**\n   * Where the ORIGINAL message bytes are, when the provider keeps them (#1600). Opaque to the engine; handed\n   * to `openRaw`. Absent when the provider offers no raw copy — the engine then keeps no raw MIME.\n   */\n  rawRef: z.string().min(1).optional(),\n});\n\nexport type StandardInboundEmail_Message = z.infer<typeof StandardInboundEmail_MessageSchema>;\n\n/** The bytes of one attachment. */\nexport interface StandardInboundEmail_OpenedAttachment {\n  readonly bytes: Uint8Array;\n  readonly contentType: string;\n  readonly filename: string;\n}\n\n/** The original bytes of a message, exactly as the provider serves them. */\nexport interface StandardInboundEmail_OpenedRaw {\n  readonly bytes: Uint8Array;\n}\n\n// ===============================================================\n// Receiving domains (#1600)\n// ===============================================================\n\n/** Where a domain stands AT THE PROVIDER — distinct from the organization's own status, which also records ownership proof. */\nexport enum EmailProviderDomainStatus {\n  /** The provider has not verified the domain's records yet (not started, pending, or a temporary failure it will retry). */\n  PENDING = \"pending\",\n  /** The provider verified the domain's records. */\n  VERIFIED = \"verified\",\n  /** The provider gave up verifying the records. */\n  FAILED = \"failed\",\n}\n\n/** One DNS record the provider asks to be published. */\nexport const StandardEmailDomain_DnsRecordSchema = z.object({\n  /** What it is for, as the provider names it (DKIM, SPF, MX, Receiving…). */\n  purpose: z.string(),\n  type: z.string(),\n  name: z.string(),\n  value: z.string(),\n  priority: z.number().int().optional(),\n  status: z.string().optional(),\n});\n\nexport type StandardEmailDomain_DnsRecord = z.infer<typeof StandardEmailDomain_DnsRecordSchema>;\n\n/** A domain as the provider describes it. */\nexport const StandardEmailDomainSchema = z.object({\n  providerDomainId: z.string().min(1),\n  name: z.string().min(1),\n  status: z.enum(EmailProviderDomainStatus),\n  sending: z.boolean(),\n  receiving: z.boolean(),\n  records: z.array(StandardEmailDomain_DnsRecordSchema).default([]),\n});\n\nexport type StandardEmailDomain = z.infer<typeof StandardEmailDomainSchema>;\n\n/**\n * What an EMAIL_INBOUND provider implements to host an organization's own domain. Every tenant shares one\n * provider account, so the ENGINE proves the organization owns the domain before it ever calls `createDomain`.\n */\nexport interface StandardEmailDomains_Interface {\n  createDomain(input: { readonly name: string; readonly sending: boolean; readonly receiving: boolean }): Promise<StandardEmailDomain>;\n  getDomain(providerDomainId: string): Promise<StandardEmailDomain | null>;\n  /** Start the provider's (asynchronous) verification. */\n  verifyDomain(providerDomainId: string): Promise<void>;\n  deleteDomain(providerDomainId: string): Promise<void>;\n}\n\n/**\n * What an EMAIL_INBOUND provider implements. Built by the provider module's adapter factory with the\n * credential the engine resolved, exactly as a billing adapter is — the module never reads a secret\n * itself.\n */\nexport interface StandardInboundEmail_Interface {\n  /** Map the verified notification body onto the standard notification. Pure; refuses an unknown shape by throwing. */\n  parseNotification(body: unknown): StandardInboundEmail_Notification;\n  /** Fetch the whole message the notification announced. */\n  fetchMessage(providerMessageId: string): Promise<StandardInboundEmail_Message>;\n  /** Fetch one attachment's bytes, by the `ref` the message listed. */\n  openAttachment(ref: string): Promise<StandardInboundEmail_OpenedAttachment>;\n  /** Fetch the original message bytes, by the message's `rawRef`. */\n  openRaw(rawRef: string): Promise<StandardInboundEmail_OpenedRaw>;\n}\n\n// ===============================================================\n// What a provider module DECLARES (pure functions; the engine owns the transport)\n// ===============================================================\n\n/**\n * One request a provider module asks the engine to make on its behalf.\n *\n * `path` is appended to the contract's `baseUrl`. A provider that serves bytes from ANOTHER host (a\n * signed download URL) returns `url` instead, and the engine admits it only against the hosts the\n * contract declares — a provider-supplied URL is never fetched merely because a provider named it.\n */\nexport type InboundEmailProviderRequest =\n  | { readonly path: string; readonly method?: EmailProviderHttpMethod; readonly jsonBody?: unknown; readonly headers?: Readonly<Record<string, string>> }\n  | { readonly url: string; readonly headers?: Readonly<Record<string, string>> };\n\n/**\n * The methods a provider's `path` request may use. A `url` request (a signed download link) is always a GET.\n * Absent means GET.\n */\nexport enum EmailProviderHttpMethod {\n  GET = \"GET\",\n  POST = \"POST\",\n  PATCH = \"PATCH\",\n  DELETE = \"DELETE\",\n}\n\n/** A provider's HTTP answer, as the engine hands it to the provider's parser. */\nexport interface InboundEmailProviderResponseInput {\n  readonly status: number;\n  /** The JSON body, or `undefined` when the answer was not JSON. */\n  readonly body: unknown;\n}\n"]}
+{"version":3,"file":"email-inbound.standard-interface.schemas.js","sourceRoot":"","sources":["../../../src/protocols/email-inbound.standard-interface.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { z_wireDate } from '@wildo-ai/zod-decorators';\n\n// ===============================================================\n// Standard Inbound Email Interface (#1630)\n// --------\n// The canonical shape of a message an EMAIL_INBOUND provider RECEIVED for the application, and the\n// three calls the engine makes on the provider to get it. Provider-agnostic: a vendor's module maps\n// its own notification and message payloads onto these schemas, and nothing past that mapping ever\n// sees a vendor field.\n//\n// There is deliberately NO `verify` here. The notification reaches the application through the\n// provider's `WEBHOOK_ORIGINATOR` endpoint (the `inbound-email` key, capability `EMAIL_INBOUND`), and\n// that endpoint is verified by the ENGINE-owned scheme its `signatureConfig` names (#1596). A\n// provider that verified its own notifications would put the one fail-closed decision of the inbound\n// path in vendor code, where nothing checks it.\n// ===============================================================\n\n/**\n * One authentication method's result, as a receiving server records it in `Authentication-Results`.\n *\n * The union of the results the three methods define, so one vocabulary serves SPF, DKIM and DMARC.\n * Two members go beyond what a DMARC result can be — `SOFTFAIL` (SPF only) and `POLICY` (DKIM and\n * SPF) — and are here because mapping them onto a neighbour would record a result the receiver did\n * not report: a softfail is neither a fail nor neutral.\n *\n * spec-cite: RFC 8601 §2.7.1 (DKIM results: none, pass, fail, policy, neutral, temperror, permerror)\n * and §2.7.2 (SPF results: none, pass, fail, softfail, neutral, temperror, permerror, plus policy\n * from §2.4); DMARC results per RFC 7489 §11.2 (none, pass, fail, temperror, permerror). Fetched 2026-09-27.\n */\nexport enum EmailAuthenticationVerdict {\n  PASS = \"pass\",\n  FAIL = \"fail\",\n  SOFTFAIL = \"softfail\",\n  NEUTRAL = \"neutral\",\n  NONE = \"none\",\n  POLICY = \"policy\",\n  TEMPERROR = \"temperror\",\n  PERMERROR = \"permerror\",\n}\n\n/**\n * What the receiving provider concluded about a message's origin.\n *\n * `dmarcAligned` is kept beside the DMARC verdict rather than folded into it because it is the fact\n * sender assurance is built on: DMARC authenticates the `From` DOMAIN by requiring that it align with\n * an identifier SPF or DKIM authenticated. A provider that reports DMARC `pass` has already required\n * alignment, so for most vendors `dmarcAligned` equals `dmarc === PASS`; it is a separate field so a\n * vendor that reports the two independently is not forced to invent one from the other.\n */\nexport const StandardInboundEmail_AuthenticationSchema = z.object({\n  spf: z.enum(EmailAuthenticationVerdict),\n  dkim: z.enum(EmailAuthenticationVerdict),\n  dmarc: z.enum(EmailAuthenticationVerdict),\n  dmarcAligned: z.boolean(),\n});\n\nexport type StandardInboundEmail_Authentication = z.infer<typeof StandardInboundEmail_AuthenticationSchema>;\n\nexport const StandardInboundEmail_AddressSchema = z.object({\n  address: z.string().min(1),\n  name: z.string().optional(),\n});\n\nexport type StandardInboundEmail_Address = z.infer<typeof StandardInboundEmail_AddressSchema>;\n\n/** How a MIME part asks to be presented (`Content-Disposition`). spec-cite: RFC 2183 §2.1 (`inline`) and §2.2 (`attachment`). */\nexport enum EmailAttachmentDisposition {\n  ATTACHMENT = \"attachment\",\n  INLINE = \"inline\",\n}\n\n/** One attachment as the provider describes it. The bytes are fetched through `openAttachment`, never inlined. */\nexport const StandardInboundEmail_AttachmentSchema = z.object({\n  /** Opaque to the engine; handed back to `openAttachment`. */\n  ref: z.string().min(1),\n  filename: z.string(),\n  contentType: z.string(),\n  sizeBytes: z.number().int().nonnegative(),\n  /** The `Content-ID` of an inline part, without angle brackets. */\n  contentId: z.string().optional(),\n  disposition: z.enum(EmailAttachmentDisposition).optional(),\n});\n\nexport type StandardInboundEmail_Attachment = z.infer<typeof StandardInboundEmail_AttachmentSchema>;\n\n/**\n * What a provider's notification says, parsed. Small on purpose: a notification tells the engine\n * THAT a message arrived and where to fetch it, and nothing past this point trusts it for more.\n */\nexport const StandardInboundEmail_NotificationSchema = z.object({\n  /** The provider's id for the message — what `fetchMessage` takes, and the dedup key of the channel delivery. */\n  providerMessageId: z.string().min(1),\n  /** The addresses the message was delivered FOR (the SMTP envelope recipients), which routing reads. */\n  receivedFor: z.array(z.string().min(1)).min(1),\n  /**\n   * Every address the stored notification body names, sender first, then its recipients and copied (#1642). Read for one\n   * purpose only: the subject keys of the delivery that stores the body, so a person's erasure finds and deletes it, and\n   * their access export reads it. Never trusted for routing, identity or anything else. Absent when the provider module\n   * does not project it, and then the delivery is keyed by `receivedFor` alone.\n   */\n  namedAddresses: z.array(z.string().min(1)).optional(),\n  // Framework-internal z_wireDate (#3480): a provider adapter parses the provider's own HTTP JSON with this contract directly (email-inbound-provider-adapter), outside every framework conversion.\n  receivedAt: z_wireDate(),\n});\n\nexport type StandardInboundEmail_Notification = z.infer<typeof StandardInboundEmail_NotificationSchema>;\n\n/**\n * One received message, provider-neutral.\n *\n * The threading headers are separated out because the engine correlates threads from them;\n * `headers` carries the rest, for a channel record that chooses to keep an allow-listed subset.\n */\nexport const StandardInboundEmail_MessageSchema = z.object({\n  providerMessageId: z.string().min(1),\n  /** The RFC 5322 `Message-ID`, angle brackets included, or absent when the sender set none. */\n  messageId: z.string().optional(),\n  inReplyTo: z.string().optional(),\n  references: z.array(z.string()).default([]),\n  from: StandardInboundEmail_AddressSchema,\n  to: z.array(StandardInboundEmail_AddressSchema).default([]),\n  cc: z.array(StandardInboundEmail_AddressSchema).default([]),\n  replyTo: StandardInboundEmail_AddressSchema.optional(),\n  receivedFor: z.array(z.string().min(1)).min(1),\n  subject: z.string().default(\"\"),\n  textBody: z.string().optional(),\n  htmlBody: z.string().optional(),\n  headers: z.record(z.string(), z.string()).default({}),\n  authentication: StandardInboundEmail_AuthenticationSchema,\n  attachments: z.array(StandardInboundEmail_AttachmentSchema).default([]),\n  sizeBytes: z.number().int().nonnegative().optional(),\n  receivedAt: z_wireDate(),\n  /**\n   * Where the ORIGINAL message bytes are, when the provider keeps them (#1600). Opaque to the engine; handed\n   * to `openRaw`. Absent when the provider offers no raw copy — the engine then keeps no raw MIME.\n   */\n  rawRef: z.string().min(1).optional(),\n});\n\nexport type StandardInboundEmail_Message = z.infer<typeof StandardInboundEmail_MessageSchema>;\n\n/**\n * How a receiving provider hands the engine a message (#3395). A closed vocabulary because the engine's whole path\n * from the webhook to the stored message depends on it.\n */\nexport enum InboundEmailMessageDelivery {\n  /**\n   * The webhook NOTIFIES: a small signed notification names the message, and the engine fetches the message, its\n   * attachments and its original bytes through the provider's API (Resend). The default.\n   */\n  FETCHED = \"fetched\",\n  /**\n   * The webhook IS the message: the whole message, attachments included as base64, arrives in the request body, and\n   * nothing is fetched (Postmark; Mailgun's routes post the message too). The engine reads the bytes out of the body\n   * it verified and stores them through the same path a fetched message's bytes take.\n   */\n  PUSHED = \"pushed\",\n}\n\n/**\n * A pushed message as a provider module maps it (#3395): the standard message, and the bytes its attachments and its\n * original copy arrived with. The engine re-validates it, refuses an attachment whose content is absent or not\n * base64, and refuses a `rawRef` with no raw content (or raw content with no `rawRef`).\n */\nexport const StandardInboundEmail_PushedMessageSchema = z.object({\n  message: StandardInboundEmail_MessageSchema,\n  /** Each attachment's content as the vendor posted it, base64, keyed by the attachment's `ref`. */\n  attachmentContents: z.record(z.string(), z.string()).default({}),\n  /**\n   * The original message as text, when the vendor includes it (Postmark's `RawEmail`, a server option), stored under\n   * the message's `rawRef`. A JSON string, so it is the vendor's text rendering of the MIME message, re-encoded as UTF-8:\n   * not necessarily byte-identical to what the sending server transmitted.\n   */\n  raw: z.string().optional(),\n});\n\nexport type StandardInboundEmail_PushedMessage = z.infer<typeof StandardInboundEmail_PushedMessageSchema>;\n\n/** The bytes of one attachment. */\nexport interface StandardInboundEmail_OpenedAttachment {\n  readonly bytes: Uint8Array;\n  readonly contentType: string;\n  readonly filename: string;\n}\n\n/** The original bytes of a message, exactly as the provider serves them. */\nexport interface StandardInboundEmail_OpenedRaw {\n  readonly bytes: Uint8Array;\n}\n\n// ===============================================================\n// Receiving domains (#1600)\n// ===============================================================\n\n/** Where a domain stands AT THE PROVIDER — distinct from the organization's own status, which also records ownership proof. */\nexport enum EmailProviderDomainStatus {\n  /** The provider has not verified the domain's records yet (not started, pending, or a temporary failure it will retry). */\n  PENDING = \"pending\",\n  /** The provider verified the domain's records. */\n  VERIFIED = \"verified\",\n  /** The provider gave up verifying the records. */\n  FAILED = \"failed\",\n}\n\n/** One DNS record the provider asks to be published. */\nexport const StandardEmailDomain_DnsRecordSchema = z.object({\n  /** What it is for, as the provider names it (DKIM, SPF, MX, Receiving…). */\n  purpose: z.string(),\n  type: z.string(),\n  name: z.string(),\n  value: z.string(),\n  priority: z.number().int().optional(),\n  status: z.string().optional(),\n});\n\nexport type StandardEmailDomain_DnsRecord = z.infer<typeof StandardEmailDomain_DnsRecordSchema>;\n\n/** A domain as the provider describes it. */\nexport const StandardEmailDomainSchema = z.object({\n  providerDomainId: z.string().min(1),\n  name: z.string().min(1),\n  status: z.enum(EmailProviderDomainStatus),\n  sending: z.boolean(),\n  receiving: z.boolean(),\n  records: z.array(StandardEmailDomain_DnsRecordSchema).default([]),\n});\n\nexport type StandardEmailDomain = z.infer<typeof StandardEmailDomainSchema>;\n\n/**\n * What an EMAIL_INBOUND provider implements to host an organization's own domain. Every tenant shares one\n * provider account, so the ENGINE proves the organization owns the domain before it ever calls `createDomain`.\n */\nexport interface StandardEmailDomains_Interface {\n  createDomain(input: { readonly name: string; readonly sending: boolean; readonly receiving: boolean }): Promise<StandardEmailDomain>;\n  getDomain(providerDomainId: string): Promise<StandardEmailDomain | null>;\n  /** Start the provider's (asynchronous) verification. */\n  verifyDomain(providerDomainId: string): Promise<void>;\n  deleteDomain(providerDomainId: string): Promise<void>;\n}\n\n/**\n * What an EMAIL_INBOUND provider implements. Built by the provider module's adapter factory with the\n * credential the engine resolved, exactly as a billing adapter is — the module never reads a secret\n * itself.\n */\nexport interface StandardInboundEmail_Interface {\n  /** Map the verified notification body onto the standard notification. Pure; refuses an unknown shape by throwing. */\n  parseNotification(body: unknown): StandardInboundEmail_Notification;\n  /** Fetch the whole message the notification announced. */\n  fetchMessage(providerMessageId: string): Promise<StandardInboundEmail_Message>;\n  /** Fetch one attachment's bytes, by the `ref` the message listed. */\n  openAttachment(ref: string): Promise<StandardInboundEmail_OpenedAttachment>;\n  /** Fetch the original message bytes, by the message's `rawRef`. */\n  openRaw(rawRef: string): Promise<StandardInboundEmail_OpenedRaw>;\n}\n\n// ===============================================================\n// What a provider module DECLARES (pure functions; the engine owns the transport)\n// ===============================================================\n\n/**\n * One request a provider module asks the engine to make on its behalf.\n *\n * `path` is appended to the contract's `baseUrl`. A provider that serves bytes from ANOTHER host (a\n * signed download URL) returns `url` instead, and the engine admits it only against the hosts the\n * contract declares — a provider-supplied URL is never fetched merely because a provider named it.\n */\nexport type InboundEmailProviderRequest =\n  | {\n      readonly path: string;\n      readonly method?: EmailProviderHttpMethod;\n      readonly headers?: Readonly<Record<string, string>>;\n      /** A JSON body (Resend). At most one of `jsonBody` and `multipartFormFields`. */\n      readonly jsonBody?: unknown;\n      readonly multipartFormFields?: never;\n    }\n  | {\n      readonly path: string;\n      readonly method?: EmailProviderHttpMethod;\n      readonly headers?: Readonly<Record<string, string>>;\n      /**\n       * Text fields sent as a `multipart/form-data` body (#3395), for an API documented to take one (Mailgun's domains\n       * API). The engine encodes it and sets the content type with its boundary.\n       */\n      readonly multipartFormFields: Readonly<Record<string, string>>;\n      readonly jsonBody?: never;\n    }\n  | { readonly url: string; readonly headers?: Readonly<Record<string, string>> };\n\n/**\n * The methods a provider's `path` request may use. A `url` request (a signed download link) is always a GET.\n * Absent means GET.\n */\nexport enum EmailProviderHttpMethod {\n  GET = \"GET\",\n  POST = \"POST\",\n  PUT = \"PUT\",\n  PATCH = \"PATCH\",\n  DELETE = \"DELETE\",\n}\n\n/** A provider's HTTP answer, as the engine hands it to the provider's parser. */\nexport interface InboundEmailProviderResponseInput {\n  readonly status: number;\n  /** The JSON body, or `undefined` when the answer was not JSON. */\n  readonly body: unknown;\n}\n"]}

package/dist/esm/protocols/email.external-connectors-models.schemas.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/email.external-connectors-models.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { \n  ExternalProvider_ExchangeProtocol_Kind \n} from \"../core/commons.external-connectors-models.schemas\";\nimport { ExternalProvider_OperationContextSchema, ExternalProvider_OperationDefinition_Base } from \"../core/operations.external-connectors-models.schemas\";\n\n//===============================================================\n// Email Provider\n// --------\n// Integration with email service providers for sending transactional\n// and marketing emails. Supports both REST API and SMTP-based providers\n// with differentiated operations for each email type.\n//\n// CONFIGURATION LEVELS:\n// - Profile (Provider-level): Fixed by the provider, cannot be changed.\n//   Examples: API endpoints, SMTP server addresses, capabilities, limits.\n// - Configuration (Consumer-level): User-configurable settings.\n//   Examples: API keys, sender addresses, tracking preferences, webhooks.\n//===============================================================\n\n// ===============================================================\n// Email Provider Enums\n// ===============================================================\n\n/**\n * The type of email operation - transactional vs marketing have different\n * requirements, compliance rules, and often use separate sending domains/IPs.\n */\nexport enum EmailProvider_EmailType {\n  TRANSACTIONAL = \"transactional\",  // Password resets, receipts, notifications\n  MARKETING = \"marketing\",          // Newsletters, promotions, campaigns\n}\n\n/**\n * The delivery method used by the email provider.\n * REST API provides more features, SMTP is simpler but more limited.\n */\nexport enum EmailProvider_DeliveryMethod {\n  REST_API = \"rest_api\",\n  SMTP = \"smtp\",\n}\n\n/**\n * SMTP encryption/security modes.\n */\nexport enum EmailProvider_SMTP_Security {\n  NONE = \"none\",           // Plain text (port 25, not recommended)\n  STARTTLS = \"starttls\",   // Upgrade to TLS (port 587)\n  TLS = \"tls\",             // Implicit TLS/SSL (port 465)\n}\n\n/**\n * Email delivery status for tracking.\n */\nexport enum EmailProvider_DeliveryStatus {\n  QUEUED = \"queued\",\n  SENT = \"sent\",\n  DELIVERED = \"delivered\",\n  OPENED = \"opened\",\n  CLICKED = \"clicked\",\n  BOUNCED = \"bounced\",\n  SOFT_BOUNCED = \"soft_bounced\",\n  SPAM_COMPLAINT = \"spam_complaint\",\n  UNSUBSCRIBED = \"unsubscribed\",\n  DROPPED = \"dropped\",\n  DEFERRED = \"deferred\",\n  FAILED = \"failed\",\n}\n\n/**\n * Email bounce types.\n */\nexport enum EmailProvider_BounceType {\n  HARD = \"hard\",      // Permanent failure (address doesn't exist)\n  SOFT = \"soft\",      // Temporary failure (mailbox full, server down)\n  TRANSIENT = \"transient\",\n}\n\n/**\n * Standard email provider operation keys.\n * Each provider implements a subset of these based on capabilities.\n */\nexport enum EmailProvider_OperationKey {\n  // Core Transactional Operations\n  SEND_EMAIL = \"email.send\",\n  SEND_BATCH = \"email.sendBatch\",\n  SEND_TEMPLATE = \"email.sendTemplate\",\n  \n  // Marketing/Campaign Operations\n  SEND_CAMPAIGN = \"email.campaign.send\",\n  CREATE_CAMPAIGN = \"email.campaign.create\",\n  SCHEDULE_CAMPAIGN = \"email.campaign.schedule\",\n  GET_CAMPAIGN = \"email.campaign.get\",\n  \n  // List Management (Marketing)\n  LIST_CREATE = \"email.list.create\",\n  LIST_ADD_CONTACT = \"email.list.addContact\",\n  LIST_REMOVE_CONTACT = \"email.list.removeContact\",\n  LIST_GET = \"email.list.get\",\n  \n  // Template Operations\n  TEMPLATE_CREATE = \"email.template.create\",\n  TEMPLATE_GET = \"email.template.get\",\n  TEMPLATE_LIST = \"email.template.list\",\n  TEMPLATE_DELETE = \"email.template.delete\",\n  \n  // Status & Analytics\n  GET_MESSAGE_STATUS = \"email.message.getStatus\",\n  GET_ANALYTICS = \"email.analytics.get\",\n  \n  // Suppression/Bounces\n  GET_SUPPRESSIONS = \"email.suppressions.get\",\n  ADD_SUPPRESSION = \"email.suppressions.add\",\n  DELETE_SUPPRESSION = \"email.suppressions.delete\",\n  \n  // Domain Verification\n  DOMAIN_VERIFY = \"email.domain.verify\",\n  DOMAIN_GET_STATUS = \"email.domain.getStatus\",\n}\n\n/**\n * Email provider capabilities - what features the provider supports.\n * Used to determine which operations are available.\n */\nexport enum EmailProvider_Capability {\n  // Delivery Methods\n  SUPPORTS_REST_API = \"supports_rest_api\",\n  SUPPORTS_SMTP = \"supports_smtp\",\n  \n  // Email Types\n  SUPPORTS_TRANSACTIONAL = \"supports_transactional\",\n  SUPPORTS_MARKETING = \"supports_marketing\",\n  \n  // Core Features\n  SUPPORTS_TEMPLATES = \"supports_templates\",\n  SUPPORTS_BATCH_SENDING = \"supports_batch_sending\",\n  SUPPORTS_SCHEDULING = \"supports_scheduling\",\n  SUPPORTS_ATTACHMENTS = \"supports_attachments\",\n  SUPPORTS_INLINE_IMAGES = \"supports_inline_images\",\n  \n  // Tracking\n  SUPPORTS_OPEN_TRACKING = \"supports_open_tracking\",\n  SUPPORTS_CLICK_TRACKING = \"supports_click_tracking\",\n  SUPPORTS_WEBHOOKS = \"supports_webhooks\",\n  \n  // Marketing Specific\n  SUPPORTS_CAMPAIGNS = \"supports_campaigns\",\n  SUPPORTS_LIST_MANAGEMENT = \"supports_list_management\",\n  SUPPORTS_SEGMENTATION = \"supports_segmentation\",\n  SUPPORTS_AB_TESTING = \"supports_ab_testing\",\n  \n  // Compliance & Deliverability\n  SUPPORTS_SUPPRESSION_LISTS = \"supports_suppression_lists\",\n  SUPPORTS_DEDICATED_IP = \"supports_dedicated_ip\",\n  SUPPORTS_CUSTOM_DOMAIN = \"supports_custom_domain\",\n  SUPPORTS_EMAIL_VALIDATION = \"supports_email_validation\",\n}\n\n// ===============================================================\n// SMTP Server Profile (Provider-level, fixed)\n// ===============================================================\n\nexport const EmailProvider_SMTP_ServerProfileSchema = z.object({\n  host: z.string().min(1),\n  port: z.number().int().min(1).max(65535),\n  security: z.enum(EmailProvider_SMTP_Security),\n  // Note: username/password are consumer-level (in Configuration)\n});\nexport type EmailProvider_SMTP_ServerProfile = z.infer<typeof EmailProvider_SMTP_ServerProfileSchema>;\n\n// ===============================================================\n// Email Address Schema\n// ===============================================================\n\nexport const EmailProvider_AddressSchema = z.object({\n  email: z.email(),\n  name: z.string().optional(),\n});\nexport type EmailProvider_Address = z.infer<typeof EmailProvider_AddressSchema>;\n\n// ===============================================================\n// Email Attachment Schema\n// ===============================================================\n\nexport const EmailProvider_AttachmentSchema = z.object({\n  filename: z.string().min(1),\n  content: z.string(), // Base64 encoded content\n  contentType: z.string().optional(),\n  contentId: z.string().optional(), // For inline images (cid:)\n});\nexport type EmailProvider_Attachment = z.infer<typeof EmailProvider_AttachmentSchema>;\n\n// ===============================================================\n// Send Email Input Schema\n// ===============================================================\n\nexport const EmailProvider_SendEmailInputSchema = z.object({\n  // Recipients\n  to: z.array(EmailProvider_AddressSchema).min(1),\n  cc: z.array(EmailProvider_AddressSchema).optional(),\n  bcc: z.array(EmailProvider_AddressSchema).optional(),\n  \n  // Sender (can override configuration default)\n  from: EmailProvider_AddressSchema.optional(),\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Content\n  subject: z.string().min(1),\n  text: z.string().optional(),\n  html: z.string().optional(),\n  \n  // Attachments\n  attachments: z.array(EmailProvider_AttachmentSchema).optional(),\n  \n  // Headers\n  headers: z.record(z.string(), z.string()).optional(),\n  \n  // Tags for categorization/analytics\n  tags: z.array(z.string()).optional(),\n  \n  // Scheduling\n  scheduledAt: z.iso.datetime().optional(),\n  \n  // Tracking overrides\n  trackOpens: z.boolean().optional(),\n  trackClicks: z.boolean().optional(),\n});\nexport type EmailProvider_SendEmailInput = z.infer<typeof EmailProvider_SendEmailInputSchema>;\n\n// ===============================================================\n// Send Email Output Schema\n// ===============================================================\n\nexport const EmailProvider_SendEmailOutputSchema = z.object({\n  // Provider's message ID\n  id: z.string(),\n  \n  // Status (if available immediately)\n  status: z.enum(EmailProvider_DeliveryStatus).optional(),\n  \n  // Provider-specific data\n  providerMessageId: z.string().optional(),\n});\nexport type EmailProvider_SendEmailOutput = z.infer<typeof EmailProvider_SendEmailOutputSchema>;\n\n// ===============================================================\n// Send Template Email Input Schema\n// ===============================================================\n\nexport const EmailProvider_SendTemplateInputSchema = z.object({\n  // Recipients\n  to: z.array(EmailProvider_AddressSchema).min(1),\n  cc: z.array(EmailProvider_AddressSchema).optional(),\n  bcc: z.array(EmailProvider_AddressSchema).optional(),\n  \n  // Sender\n  from: EmailProvider_AddressSchema.optional(),\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Template\n  templateId: z.string().min(1),\n  templateAlias: z.string().optional(), // Some providers use alias instead of ID\n  \n  // Template variables\n  variables: z.record(z.string(), z.unknown()).optional(),\n  \n  // Subject override (if template allows)\n  subject: z.string().optional(),\n  \n  // Tags\n  tags: z.array(z.string()).optional(),\n  \n  // Scheduling\n  scheduledAt: z.iso.datetime().optional(),\n});\nexport type EmailProvider_SendTemplateInput = z.infer<typeof EmailProvider_SendTemplateInputSchema>;\n\n// ===============================================================\n// Batch Send Input Schema\n// ===============================================================\n\nconst emailProviderBatchItemSchema = z.object({\n  to: EmailProvider_AddressSchema,\n  variables: z.record(z.string(), z.unknown()).optional(),\n  subject: z.string().optional(), // Override per recipient\n});\n\nexport const EmailProvider_SendBatchInputSchema = z.object({\n  // Sender\n  from: EmailProvider_AddressSchema.optional(),\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Content (direct or template)\n  subject: z.string().optional(), // Default subject\n  text: z.string().optional(),\n  html: z.string().optional(),\n  templateId: z.string().optional(),\n  \n  // Recipients with personalizations\n  recipients: z.array(emailProviderBatchItemSchema).min(1),\n  \n  // Tags\n  tags: z.array(z.string()).optional(),\n});\nexport type EmailProvider_SendBatchInput = z.infer<typeof EmailProvider_SendBatchInputSchema>;\n\n// ===============================================================\n// Batch Send Output Schema\n// ===============================================================\n\nexport const EmailProvider_SendBatchOutputSchema = z.object({\n  // Summary\n  totalRequested: z.number().int(),\n  totalAccepted: z.number().int(),\n  totalRejected: z.number().int(),\n  \n  // Results per recipient\n  results: z.array(z.object({\n    email: z.string(),\n    id: z.string().optional(),\n    status: z.enum([\"accepted\", \"rejected\"]),\n    error: z.string().optional(),\n  })),\n});\nexport type EmailProvider_SendBatchOutput = z.infer<typeof EmailProvider_SendBatchOutputSchema>;\n\n// ===============================================================\n// Campaign Input Schema (Marketing)\n// ===============================================================\n\nexport const EmailProvider_CreateCampaignInputSchema = z.object({\n  // Campaign details\n  name: z.string().min(1),\n  subject: z.string().min(1),\n  previewText: z.string().optional(),\n  \n  // Sender\n  from: EmailProvider_AddressSchema,\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Content\n  html: z.string().optional(),\n  text: z.string().optional(),\n  templateId: z.string().optional(),\n  \n  // Recipients\n  listIds: z.array(z.string()).optional(),\n  segmentIds: z.array(z.string()).optional(),\n  \n  // Scheduling\n  scheduledAt: z.iso.datetime().optional(),\n  \n  // Tracking\n  trackOpens: z.boolean().optional().default(true),\n  trackClicks: z.boolean().optional().default(true),\n});\nexport type EmailProvider_CreateCampaignInput = z.infer<typeof EmailProvider_CreateCampaignInputSchema>;\n\n// ===============================================================\n// Campaign Output Schema\n// ===============================================================\n\nexport const EmailProvider_CampaignOutputSchema = z.object({\n  id: z.string(),\n  status: z.enum([\"draft\", \"scheduled\", \"sending\", \"sent\", \"cancelled\"]),\n  scheduledAt: z.iso.datetime().optional(),\n  sentAt: z.iso.datetime().optional(),\n});\nexport type EmailProvider_CampaignOutput = z.infer<typeof EmailProvider_CampaignOutputSchema>;\n\n// ===============================================================\n// Message Status Schema\n// ===============================================================\n\nexport const EmailProvider_MessageStatusSchema = z.object({\n  id: z.string(),\n  status: z.enum(EmailProvider_DeliveryStatus),\n  to: z.email(),\n  subject: z.string().optional(),\n  sentAt: z.iso.datetime().optional(),\n  deliveredAt: z.iso.datetime().optional(),\n  openedAt: z.iso.datetime().optional(),\n  clickedAt: z.iso.datetime().optional(),\n  bouncedAt: z.iso.datetime().optional(),\n  bounceType: z.enum(EmailProvider_BounceType).optional(),\n  bounceReason: z.string().optional(),\n});\nexport type EmailProvider_MessageStatus = z.infer<typeof EmailProvider_MessageStatusSchema>;\n\n// ===============================================================\n// Email Operation Context (for tracking)\n// ===============================================================\n\nexport const EmailProvider_OperationContextSchema = ExternalProvider_OperationContextSchema.extend({\n  // Message identification\n  messageId: z.string().optional(),\n  \n  // Delivery info\n  deliveryMethod: z.enum(EmailProvider_DeliveryMethod).optional(),\n  deliveryStatus: z.enum(EmailProvider_DeliveryStatus).optional(),\n  \n  // Email type\n  emailType: z.enum(EmailProvider_EmailType).optional(),\n  \n  // Counts\n  recipientCount: z.number().int().optional(),\n  \n  // Rate limit headers from provider\n  rateLimitRemaining: z.number().optional(),\n  rateLimitResetAt: z.iso.datetime().optional(),\n});\nexport type EmailProvider_OperationContext = z.infer<typeof EmailProvider_OperationContextSchema>;\n\n// ===============================================================\n// Webhook Event Schema\n// ===============================================================\n\nexport const EmailProvider_WebhookEventSchema = z.object({\n  eventType: z.enum(EmailProvider_DeliveryStatus),\n  messageId: z.string(),\n  email: z.email(),\n  timestamp: z.iso.datetime(),\n  \n  // Event-specific data\n  bounceType: z.enum(EmailProvider_BounceType).optional(),\n  bounceReason: z.string().optional(),\n  link: z.url().optional(), // For click events\n  userAgent: z.string().optional(),\n  \n  // Original tags\n  tags: z.array(z.string()).optional(),\n});\nexport type EmailProvider_WebhookEvent = z.infer<typeof EmailProvider_WebhookEventSchema>;\n\n// ===============================================================\n// Email Operation Definition\n// ===============================================================\n\nexport type EmailProvider_OperationDefinition = ExternalProvider_OperationDefinition_Base & {\n  operationContextSchema: typeof EmailProvider_OperationContextSchema;\n  \n  // Which email types this operation supports\n  supportedEmailTypes: EmailProvider_EmailType[];\n  \n  // Which delivery methods work for this operation\n  supportedDeliveryMethods: EmailProvider_DeliveryMethod[];\n  \n  // Required capabilities\n  requiredCapabilities?: EmailProvider_Capability[];\n};\n\n"]}
+{"version":3,"file":"email.external-connectors-models.schemas.js","sourceRoot":"","sources":["../../../src/protocols/email.external-connectors-models.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { \n  ExternalProvider_ExchangeProtocol_Kind \n} from \"../core/commons.external-connectors-models.schemas\";\nimport { ExternalProvider_OperationContextSchema, ExternalProvider_OperationDefinition_Base } from \"../core/operations.external-connectors-models.schemas\";\n\n//===============================================================\n// Email Provider\n// --------\n// Integration with email service providers for sending transactional\n// and marketing emails. Supports both REST API and SMTP-based providers\n// with differentiated operations for each email type.\n//\n// CONFIGURATION LEVELS:\n// - Profile (Provider-level): Fixed by the provider, cannot be changed.\n//   Examples: API endpoints, SMTP server addresses, capabilities, limits.\n// - Configuration (Consumer-level): User-configurable settings.\n//   Examples: API keys, sender addresses, tracking preferences, webhooks.\n//===============================================================\n\n// ===============================================================\n// Email Provider Enums\n// ===============================================================\n\n/**\n * The type of email operation - transactional vs marketing have different\n * requirements, compliance rules, and often use separate sending domains/IPs.\n */\nexport enum EmailProvider_EmailType {\n  TRANSACTIONAL = \"transactional\",  // Password resets, receipts, notifications\n  MARKETING = \"marketing\",          // Newsletters, promotions, campaigns\n}\n\n/**\n * The delivery method used by the email provider.\n * REST API provides more features, SMTP is simpler but more limited.\n */\nexport enum EmailProvider_DeliveryMethod {\n  REST_API = \"rest_api\",\n  SMTP = \"smtp\",\n}\n\n/**\n * SMTP encryption/security modes.\n */\nexport enum EmailProvider_SMTP_Security {\n  NONE = \"none\",           // Plain text (port 25, not recommended)\n  STARTTLS = \"starttls\",   // Upgrade to TLS (port 587)\n  TLS = \"tls\",             // Implicit TLS/SSL (port 465)\n}\n\n/**\n * Email delivery status for tracking.\n */\nexport enum EmailProvider_DeliveryStatus {\n  QUEUED = \"queued\",\n  SENT = \"sent\",\n  DELIVERED = \"delivered\",\n  OPENED = \"opened\",\n  CLICKED = \"clicked\",\n  BOUNCED = \"bounced\",\n  SOFT_BOUNCED = \"soft_bounced\",\n  SPAM_COMPLAINT = \"spam_complaint\",\n  UNSUBSCRIBED = \"unsubscribed\",\n  DROPPED = \"dropped\",\n  DEFERRED = \"deferred\",\n  FAILED = \"failed\",\n}\n\n/**\n * Email bounce types.\n */\nexport enum EmailProvider_BounceType {\n  HARD = \"hard\",      // Permanent failure (address doesn't exist)\n  SOFT = \"soft\",      // Temporary failure (mailbox full, server down)\n  TRANSIENT = \"transient\",\n}\n\n/**\n * Standard email provider operation keys.\n * Each provider implements a subset of these based on capabilities.\n */\nexport enum EmailProvider_OperationKey {\n  // Core Transactional Operations\n  SEND_EMAIL = \"email.send\",\n  SEND_BATCH = \"email.sendBatch\",\n  SEND_TEMPLATE = \"email.sendTemplate\",\n  \n  // Marketing/Campaign Operations\n  SEND_CAMPAIGN = \"email.campaign.send\",\n  CREATE_CAMPAIGN = \"email.campaign.create\",\n  SCHEDULE_CAMPAIGN = \"email.campaign.schedule\",\n  GET_CAMPAIGN = \"email.campaign.get\",\n  \n  // List Management (Marketing)\n  LIST_CREATE = \"email.list.create\",\n  LIST_ADD_CONTACT = \"email.list.addContact\",\n  LIST_REMOVE_CONTACT = \"email.list.removeContact\",\n  LIST_GET = \"email.list.get\",\n  \n  // Template Operations\n  TEMPLATE_CREATE = \"email.template.create\",\n  TEMPLATE_GET = \"email.template.get\",\n  TEMPLATE_LIST = \"email.template.list\",\n  TEMPLATE_DELETE = \"email.template.delete\",\n  \n  // Status & Analytics\n  GET_MESSAGE_STATUS = \"email.message.getStatus\",\n  GET_ANALYTICS = \"email.analytics.get\",\n  \n  // Suppression/Bounces\n  GET_SUPPRESSIONS = \"email.suppressions.get\",\n  ADD_SUPPRESSION = \"email.suppressions.add\",\n  DELETE_SUPPRESSION = \"email.suppressions.delete\",\n  \n  // Domain Verification\n  DOMAIN_VERIFY = \"email.domain.verify\",\n  DOMAIN_GET_STATUS = \"email.domain.getStatus\",\n}\n\n/**\n * Email provider capabilities - what features the provider supports.\n * Used to determine which operations are available.\n */\nexport enum EmailProvider_Capability {\n  // Delivery Methods\n  SUPPORTS_REST_API = \"supports_rest_api\",\n  SUPPORTS_SMTP = \"supports_smtp\",\n  \n  // Email Types\n  SUPPORTS_TRANSACTIONAL = \"supports_transactional\",\n  SUPPORTS_MARKETING = \"supports_marketing\",\n  \n  // Core Features\n  SUPPORTS_TEMPLATES = \"supports_templates\",\n  SUPPORTS_BATCH_SENDING = \"supports_batch_sending\",\n  SUPPORTS_SCHEDULING = \"supports_scheduling\",\n  SUPPORTS_ATTACHMENTS = \"supports_attachments\",\n  SUPPORTS_INLINE_IMAGES = \"supports_inline_images\",\n  \n  // Tracking\n  SUPPORTS_OPEN_TRACKING = \"supports_open_tracking\",\n  SUPPORTS_CLICK_TRACKING = \"supports_click_tracking\",\n  SUPPORTS_WEBHOOKS = \"supports_webhooks\",\n  \n  // Marketing Specific\n  SUPPORTS_CAMPAIGNS = \"supports_campaigns\",\n  SUPPORTS_LIST_MANAGEMENT = \"supports_list_management\",\n  SUPPORTS_SEGMENTATION = \"supports_segmentation\",\n  SUPPORTS_AB_TESTING = \"supports_ab_testing\",\n  \n  // Compliance & Deliverability\n  SUPPORTS_SUPPRESSION_LISTS = \"supports_suppression_lists\",\n  SUPPORTS_DEDICATED_IP = \"supports_dedicated_ip\",\n  SUPPORTS_CUSTOM_DOMAIN = \"supports_custom_domain\",\n  SUPPORTS_EMAIL_VALIDATION = \"supports_email_validation\",\n}\n\n// ===============================================================\n// SMTP Server Profile (Provider-level, fixed)\n// ===============================================================\n\nexport const EmailProvider_SMTP_ServerProfileSchema = z.object({\n  host: z.string().min(1),\n  port: z.number().int().min(1).max(65535),\n  security: z.enum(EmailProvider_SMTP_Security),\n  // Note: username/password are consumer-level (in Configuration)\n});\nexport type EmailProvider_SMTP_ServerProfile = z.infer<typeof EmailProvider_SMTP_ServerProfileSchema>;\n\n// ===============================================================\n// Email Address Schema\n// ===============================================================\n\nexport const EmailProvider_AddressSchema = z.object({\n  email: z.email(),\n  name: z.string().optional(),\n});\nexport type EmailProvider_Address = z.infer<typeof EmailProvider_AddressSchema>;\n\n// ===============================================================\n// Email Attachment Schema\n// ===============================================================\n\nexport const EmailProvider_AttachmentSchema = z.object({\n  filename: z.string().min(1),\n  content: z.string(), // Base64 encoded content\n  contentType: z.string().optional(),\n  contentId: z.string().optional(), // For inline images (cid:)\n});\nexport type EmailProvider_Attachment = z.infer<typeof EmailProvider_AttachmentSchema>;\n\n// ===============================================================\n// Send Email Input Schema\n// ===============================================================\n\nexport const EmailProvider_SendEmailInputSchema = z.object({\n  // Recipients\n  to: z.array(EmailProvider_AddressSchema).min(1),\n  cc: z.array(EmailProvider_AddressSchema).optional(),\n  bcc: z.array(EmailProvider_AddressSchema).optional(),\n  \n  // Sender (can override configuration default)\n  from: EmailProvider_AddressSchema.optional(),\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Content\n  subject: z.string().min(1),\n  text: z.string().optional(),\n  html: z.string().optional(),\n  \n  // Attachments\n  attachments: z.array(EmailProvider_AttachmentSchema).optional(),\n  \n  // Headers\n  headers: z.record(z.string(), z.string()).optional(),\n  \n  // Tags for categorization/analytics\n  tags: z.array(z.string()).optional(),\n  \n  // Scheduling\n  scheduledAt: z.iso.datetime().optional(),\n  \n  // Tracking overrides\n  trackOpens: z.boolean().optional(),\n  trackClicks: z.boolean().optional(),\n});\nexport type EmailProvider_SendEmailInput = z.infer<typeof EmailProvider_SendEmailInputSchema>;\n\n// ===============================================================\n// Send Email Output Schema\n// ===============================================================\n\nexport const EmailProvider_SendEmailOutputSchema = z.object({\n  // Provider's message ID\n  id: z.string(),\n  \n  // Status (if available immediately)\n  status: z.enum(EmailProvider_DeliveryStatus).optional(),\n  \n  // Provider-specific data\n  providerMessageId: z.string().optional(),\n});\nexport type EmailProvider_SendEmailOutput = z.infer<typeof EmailProvider_SendEmailOutputSchema>;\n\n// ===============================================================\n// Send Template Email Input Schema\n// ===============================================================\n\nexport const EmailProvider_SendTemplateInputSchema = z.object({\n  // Recipients\n  to: z.array(EmailProvider_AddressSchema).min(1),\n  cc: z.array(EmailProvider_AddressSchema).optional(),\n  bcc: z.array(EmailProvider_AddressSchema).optional(),\n  \n  // Sender\n  from: EmailProvider_AddressSchema.optional(),\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Template\n  templateId: z.string().min(1),\n  templateAlias: z.string().optional(), // Some providers use alias instead of ID\n  \n  // Template variables\n  variables: z.record(z.string(), z.unknown()).optional(),\n  \n  // Subject override (if template allows)\n  subject: z.string().optional(),\n  \n  // Tags\n  tags: z.array(z.string()).optional(),\n  \n  // Scheduling\n  scheduledAt: z.iso.datetime().optional(),\n});\nexport type EmailProvider_SendTemplateInput = z.infer<typeof EmailProvider_SendTemplateInputSchema>;\n\n// ===============================================================\n// Batch Send Input Schema\n// ===============================================================\n\nconst emailProviderBatchItemSchema = z.object({\n  to: EmailProvider_AddressSchema,\n  variables: z.record(z.string(), z.unknown()).optional(),\n  subject: z.string().optional(), // Override per recipient\n});\n\nexport const EmailProvider_SendBatchInputSchema = z.object({\n  // Sender\n  from: EmailProvider_AddressSchema.optional(),\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Content (direct or template)\n  subject: z.string().optional(), // Default subject\n  text: z.string().optional(),\n  html: z.string().optional(),\n  templateId: z.string().optional(),\n  \n  // Recipients with personalizations\n  recipients: z.array(emailProviderBatchItemSchema).min(1),\n  \n  // Tags\n  tags: z.array(z.string()).optional(),\n});\nexport type EmailProvider_SendBatchInput = z.infer<typeof EmailProvider_SendBatchInputSchema>;\n\n// ===============================================================\n// Batch Send Output Schema\n// ===============================================================\n\nexport const EmailProvider_SendBatchOutputSchema = z.object({\n  // Summary\n  totalRequested: z.number().int(),\n  totalAccepted: z.number().int(),\n  totalRejected: z.number().int(),\n  \n  // Results per recipient\n  results: z.array(z.object({\n    email: z.string(),\n    id: z.string().optional(),\n    status: z.enum([\"accepted\", \"rejected\"]),\n    error: z.string().optional(),\n  })),\n});\nexport type EmailProvider_SendBatchOutput = z.infer<typeof EmailProvider_SendBatchOutputSchema>;\n\n// ===============================================================\n// Campaign Input Schema (Marketing)\n// ===============================================================\n\nexport const EmailProvider_CreateCampaignInputSchema = z.object({\n  // Campaign details\n  name: z.string().min(1),\n  subject: z.string().min(1),\n  previewText: z.string().optional(),\n  \n  // Sender\n  from: EmailProvider_AddressSchema,\n  replyTo: EmailProvider_AddressSchema.optional(),\n  \n  // Content\n  html: z.string().optional(),\n  text: z.string().optional(),\n  templateId: z.string().optional(),\n  \n  // Recipients\n  listIds: z.array(z.string()).optional(),\n  segmentIds: z.array(z.string()).optional(),\n  \n  // Scheduling\n  scheduledAt: z.iso.datetime().optional(),\n  \n  // Tracking\n  trackOpens: z.boolean().optional().default(true),\n  trackClicks: z.boolean().optional().default(true),\n});\nexport type EmailProvider_CreateCampaignInput = z.infer<typeof EmailProvider_CreateCampaignInputSchema>;\n\n// ===============================================================\n// Campaign Output Schema\n// ===============================================================\n\nexport const EmailProvider_CampaignOutputSchema = z.object({\n  id: z.string(),\n  status: z.enum([\"draft\", \"scheduled\", \"sending\", \"sent\", \"cancelled\"]),\n  scheduledAt: z.iso.datetime().optional(),\n  sentAt: z.iso.datetime().optional(),\n});\nexport type EmailProvider_CampaignOutput = z.infer<typeof EmailProvider_CampaignOutputSchema>;\n\n// ===============================================================\n// Message Status Schema\n// ===============================================================\n\nexport const EmailProvider_MessageStatusSchema = z.object({\n  id: z.string(),\n  status: z.enum(EmailProvider_DeliveryStatus),\n  to: z.email(),\n  subject: z.string().optional(),\n  sentAt: z.iso.datetime().optional(),\n  deliveredAt: z.iso.datetime().optional(),\n  openedAt: z.iso.datetime().optional(),\n  clickedAt: z.iso.datetime().optional(),\n  bouncedAt: z.iso.datetime().optional(),\n  bounceType: z.enum(EmailProvider_BounceType).optional(),\n  bounceReason: z.string().optional(),\n});\nexport type EmailProvider_MessageStatus = z.infer<typeof EmailProvider_MessageStatusSchema>;\n\n// ===============================================================\n// Email Operation Context (for tracking)\n// ===============================================================\n\nexport const EmailProvider_OperationContextSchema = ExternalProvider_OperationContextSchema.extend({\n  // Message identification\n  messageId: z.string().optional(),\n  \n  // Delivery info\n  deliveryMethod: z.enum(EmailProvider_DeliveryMethod).optional(),\n  deliveryStatus: z.enum(EmailProvider_DeliveryStatus).optional(),\n  \n  // Email type\n  emailType: z.enum(EmailProvider_EmailType).optional(),\n  \n  // Counts\n  recipientCount: z.number().int().optional(),\n  \n  // Rate limit headers from provider\n  rateLimitRemaining: z.number().optional(),\n  rateLimitResetAt: z.iso.datetime().optional(),\n});\nexport type EmailProvider_OperationContext = z.infer<typeof EmailProvider_OperationContextSchema>;\n\n// ===============================================================\n// Webhook Event Schema\n// ===============================================================\n\nexport const EmailProvider_WebhookEventSchema = z.object({\n  eventType: z.enum(EmailProvider_DeliveryStatus),\n  messageId: z.string(),\n  email: z.email(),\n  timestamp: z.iso.datetime(),\n  \n  // Event-specific data\n  bounceType: z.enum(EmailProvider_BounceType).optional(),\n  bounceReason: z.string().optional(),\n  link: z.url().optional(), // For click events\n  userAgent: z.string().optional(),\n  \n  // Original tags\n  tags: z.array(z.string()).optional(),\n});\nexport type EmailProvider_WebhookEvent = z.infer<typeof EmailProvider_WebhookEventSchema>;\n\n// ===============================================================\n// Email Operation Definition\n// ===============================================================\n\nexport type EmailProvider_OperationDefinition = ExternalProvider_OperationDefinition_Base & {\n  operationContextSchema: typeof EmailProvider_OperationContextSchema;\n  \n  // Which email types this operation supports\n  supportedEmailTypes: EmailProvider_EmailType[];\n  \n  // Which delivery methods work for this operation\n  supportedDeliveryMethods: EmailProvider_DeliveryMethod[];\n  \n  // Required capabilities\n  requiredCapabilities?: EmailProvider_Capability[];\n};\n\n"]}

package/dist/esm/protocols/email.standard-interface.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"email.standard-interface.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/email.standard-interface.schemas.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"email.standard-interface.schemas.d.ts","sourceRoot":"","sources":["../../../src/protocols/email.standard-interface.schemas.ts"],"names":[],"mappings":"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"}