@wildo-ai/external-connectors-models 1.0.1 → 1.1.1

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

@@ -28,10 +28,45 @@ export const StandardEmail_AttachmentSchema = z.object({
     contentType: z.string().optional(),
     contentId: z.string().optional(), // For inline images (cid:)
 });
+/**
+ * Wire encoding used by a network email provider gateway.
+ *
+ * This vocabulary is deliberately closed and explicit on every provider
+ * contract: JSON and multipart data require materially different headers and
+ * serialization. There is no implicit default.
+ */
+export var EmailProviderPayloadEncoding;
+(function (EmailProviderPayloadEncoding) {
+    EmailProviderPayloadEncoding["JSON"] = "json";
+    EmailProviderPayloadEncoding["MULTIPART_FORM_DATA"] = "multipart-form-data";
+})(EmailProviderPayloadEncoding || (EmailProviderPayloadEncoding = {}));
+/** Provider acknowledgement state returned by a synchronous send endpoint. */
+export var EmailProviderSubmissionStatus;
+(function (EmailProviderSubmissionStatus) {
+    EmailProviderSubmissionStatus["QUEUED"] = "queued";
+    EmailProviderSubmissionStatus["SENT"] = "sent";
+    EmailProviderSubmissionStatus["SCHEDULED"] = "scheduled";
+})(EmailProviderSubmissionStatus || (EmailProviderSubmissionStatus = {}));
+/** Provider-owned classification for HTTP responses whose status is ambiguous. */
+export var EmailProviderSubmissionClassification;
+(function (EmailProviderSubmissionClassification) {
+    EmailProviderSubmissionClassification["ACCEPTED"] = "accepted";
+    EmailProviderSubmissionClassification["REJECTED"] = "rejected";
+    EmailProviderSubmissionClassification["ACCEPTANCE_UNKNOWN"] = "acceptance_unknown";
+})(EmailProviderSubmissionClassification || (EmailProviderSubmissionClassification = {}));
 // ===============================================================
 // TRANSACTIONAL: Send Email Request
 // ===============================================================
 export const StandardEmail_SendRequestSchema = z.object({
+    /**
+     * Stable identity of ONE logical provider submission across retries.
+     *
+     * Deliberately not named `idempotencyKey`: it remains the framework's
+     * correlation identity even when the selected provider cannot enforce
+     * idempotency. Provider gateways may map it to a native idempotency field as
+     * an optional duplicate-risk reduction.
+     */
+    submissionId: z.string().min(1).max(256),
     // Recipients (required)
     to: z.array(StandardEmail_AddressSchema).min(1),
     cc: z.array(StandardEmail_AddressSchema).optional(),
@@ -60,10 +95,108 @@ export const StandardEmail_SendRequestSchema = z.object({
 // ===============================================================
 export const StandardEmail_SendResponseSchema = z.object({
     success: z.boolean(),
-    messageId: z.string(),
-    providerMessageId: z.string().optional(),
-    status: z.enum(["queued", "sent", "scheduled"]).optional(),
+    /**
+     * Mandatory provider-owned submission meaning. HTTP status, receipt shape,
+     * and recipient-level `success` are not interchangeable across providers.
+     */
+    classification: z.enum(EmailProviderSubmissionClassification),
+    /**
+     * Provider-assigned receipts. An array is required because Brevo and
+     * Mailchimp may acknowledge several recipient messages in one response.
+     * Empty is honest for a successful non-delivery preview or a provider that
+     * accepted the request without returning a receipt.
+     */
+    providerMessageIds: z.array(z.string().min(1)),
+    /** Per-recipient rejections returned inside an otherwise successful HTTP response. */
+    rejectedRecipients: z.array(z.object({
+        email: z.string().min(1),
+        reason: z.string().optional(),
+    })).optional(),
+    /**
+     * Provider-declared detail explaining its explicit classification, including
+     * semantic rejection or an ambiguous idempotency/processing conflict.
+     */
+    providerError: z.string().min(1).optional(),
+    /**
+     * Whether the caller should retry this response under at-least-once
+     * semantics. For an acceptance-unknown response, a retry may duplicate a
+     * message unless the selected provider happens to enforce the submission id.
+     */
+    retryable: z.boolean().optional(),
+    /** Provider reports that this submission identity was already suppressed. */
+    deduplicated: z.boolean().optional(),
+    status: z.enum(EmailProviderSubmissionStatus).optional(),
     scheduledAt: z.iso.datetime().optional(),
+}).superRefine((response, context) => {
+    const accepted = response.classification
+        === EmailProviderSubmissionClassification.ACCEPTED;
+    /**
+     * `success` describes whole-request success, whereas `classification`
+     * describes whether any provider submission was accepted. Once a provider
+     * adapter classifies a submission as accepted, auxiliary result metadata
+     * must never turn that acknowledgement into permission to replay. A false
+     * `success` may describe an honest partial result (for example Mailchimp)
+     * or anomalous adapter metadata; `rejectedRecipients` is therefore useful
+     * evidence, but not a prerequisite for preserving acceptance.
+     */
+    if (response.success && !accepted) {
+        context.addIssue({
+            code: 'custom',
+            path: ['success'],
+            message: 'A successful email response must be classified as accepted',
+        });
+    }
+    if (response.success && (response.rejectedRecipients?.length ?? 0) > 0) {
+        context.addIssue({
+            code: 'custom',
+            path: ['rejectedRecipients'],
+            message: 'A successful email response cannot contain rejected recipients',
+        });
+    }
+    if (!accepted && response.providerMessageIds.length > 0) {
+        context.addIssue({
+            code: 'custom',
+            path: ['providerMessageIds'],
+            message: 'A non-accepted email response cannot contain provider acceptance receipts',
+        });
+    }
+    for (const [index, providerMessageId] of response.providerMessageIds.entries()) {
+        if (response.providerMessageIds.indexOf(providerMessageId) !== index) {
+            context.addIssue({
+                code: 'custom',
+                path: ['providerMessageIds', index],
+                message: 'Provider message receipts must be unique',
+            });
+        }
+    }
+    for (const acceptedOnlyField of [
+        'deduplicated',
+        'status',
+        'scheduledAt',
+    ]) {
+        if (!accepted && response[acceptedOnlyField] !== undefined) {
+            context.addIssue({
+                code: 'custom',
+                path: [acceptedOnlyField],
+                message: `${acceptedOnlyField} is valid only for an accepted email response`,
+            });
+        }
+    }
+    if (response.scheduledAt !== undefined
+        && response.status !== EmailProviderSubmissionStatus.SCHEDULED) {
+        context.addIssue({
+            code: 'custom',
+            path: ['scheduledAt'],
+            message: 'A scheduledAt receipt requires provider status scheduled',
+        });
+    }
+    if (accepted && response.retryable === true) {
+        context.addIssue({
+            code: 'custom',
+            path: ['retryable'],
+            message: 'An accepted email response cannot request replay',
+        });
+    }
 });
 // ===============================================================
 // TRANSACTIONAL: Send Template Request
@@ -272,4 +405,4 @@ export const StandardEmail_OperationCapabilities = {
     sendCampaign: [EmailProvider_Capability.SUPPORTS_MARKETING, EmailProvider_Capability.SUPPORTS_CAMPAIGNS],
     manageList: [EmailProvider_Capability.SUPPORTS_LIST_MANAGEMENT],
 };
-//# sourceMappingURL=email.standard-interface.schemas.js.map
+//# sourceMappingURL=email.standard-interface.schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"email.standard-interface.schemas.js","sourceRoot":"","sources":["../../../src/protocols/email.standard-interface.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAA2B,4BAA4B,EAAE,MAAM,4CAA4C,CAAC;AAE7I,iEAAiE;AACjE,2BAA2B;AAC3B,WAAW;AACX,qEAAqE;AACrE,gEAAgE;AAChE,+BAA+B;AAC/B,EAAE;AACF,qBAAqB;AACrB,uDAAuD;AACvD,gEAAgE;AAChE,yEAAyE;AACzE,iEAAiE;AAEjE,kEAAkE;AAClE,yBAAyB;AACzB,kEAAkE;AAElE,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,kEAAkE;AAClE,sBAAsB;AACtB,kEAAkE;AAElE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB;IACtC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,2BAA2B;CAC9D,CAAC,CAAC;AAIH,kEAAkE;AAClE,oCAAoC;AACpC,kEAAkE;AAElE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,wBAAwB;IACxB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;IACnD,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;IAEpD,uDAAuD;IACvD,IAAI,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAC5C,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAE/C,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE3B,oBAAoB;IACpB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;IAC/D,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpC,uDAAuD;IACvD,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAExC,wDAAwD;IACxD,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAEnC,oCAAoC;IACpC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC,MAAM,CACP,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAC5D,EAAE,OAAO,EAAE,yCAAyC,EAAE,CACvD,CAAC;AAIF,kEAAkE;AAClE,qCAAqC;AACrC,kEAAkE;AAElE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1D,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAIH,kEAAkE;AAClE,uCAAuC;AACvC,kEAAkE;AAElE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9D,aAAa;IACb,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;IACnD,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;IAEpD,SAAS;IACT,IAAI,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAC5C,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAE/C,yCAAyC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,oCAAoC;IAC1E,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEvD,qBAAqB;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,4BAA4B;IAE5D,oBAAoB;IACpB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;IAC/D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAExC,WAAW;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH,kEAAkE;AAClE,oCAAoC;AACpC,kEAAkE;AAElE,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,EAAE,EAAE,2BAA2B;IAC/B,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;IACnD,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,QAAQ,EAAE;IACpD,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,iCAAiC;IACjE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,kBAAkB;IAClB,IAAI,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAC5C,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAE/C,+CAA+C;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,kBAAkB;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,qEAAqE;IACrE,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9D,oBAAoB;IACpB,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;IAC/D,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAIH,kEAAkE;AAClE,qCAAqC;AACrC,kEAAkE;AAElE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QACxB,4FAA4F;QAC5F,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC7B,CAAC,CAAC;CACJ,CAAC,CAAC;AAIH,kEAAkE;AAClE,qBAAqB;AACrB,kEAAkE;AAElE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE;IAChB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACzD,CAAC,CAAC;AAIH,kEAAkE;AAClE,kBAAkB;AAClB,kEAAkE;AAElE,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,6BAA6B;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAIH,kEAAkE;AAClE,wCAAwC;AACxC,kEAAkE;AAElE,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,8DAA8D;IAC9D,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACnC,CAAC,CAAC,MAAM,CACP,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAC1D,EAAE,OAAO,EAAE,yCAAyC,EAAE,CACvD;IAED,yDAAyD;IACzD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAC,CAAC;AAIH,kEAAkE;AAClE,8BAA8B;AAC9B,kEAAkE;AAElE,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,iCAAiC;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,iBAAiB,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE/D,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,cAAc;IACd,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,QAAQ,EAAE;CAChE,CAAC,CAAC,MAAM,CACP,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EACrE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CACxD,CAAC;AAIF,kEAAkE;AAClE,8BAA8B;AAC9B,kEAAkE;AAElE,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9D,gBAAgB;IAChB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEvB,SAAS;IACT,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,2BAA2B,CAAC,QAAQ,EAAE;IAE/C,WAAW;IACX,QAAQ,EAAE,gCAAgC;IAE1C,UAAU;IACV,OAAO,EAAE,+BAA+B;IAExC,YAAY;IACZ,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACjB,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACnC,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC,CAAC,QAAQ,EAAE;IAEb,WAAW;IACX,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAEjD,OAAO;IACP,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAEpC,WAAW;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIH,kEAAkE;AAClE,+BAA+B;AAC/B,kEAAkE;AAElE,MAAM,CAAC,MAAM,wCAAwC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/D,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;IACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACtE,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAIH,kEAAkE;AAClE,kCAAkC;AAClC,kEAAkE;AAElE,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5D,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,4BAA4B,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE;IACb,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAC;AAIH,kEAAkE;AAClE,iBAAiB;AACjB,kEAAkE;AAElE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QACX,kBAAkB;QAClB,gBAAgB;QAChB,0BAA0B;QAC1B,yBAAyB;QACzB,0BAA0B;QAC1B,oBAAoB;QACpB,qBAAqB;QACrB,uBAAuB;QACvB,gBAAgB;QAChB,eAAe;KAChB,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAE/B,8DAA8D;IAC9D,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IAC/D,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC,CAAC;AAIH,kEAAkE;AAClE,0BAA0B;AAC1B,kEAAkE;AAElE;;;GAGG;AACH,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,SAAS,EAAE,EAAgC,EAAE,mCAAmC;IAChF,YAAY,EAAE,CAAC,wBAAwB,CAAC,kBAAkB,CAAC;IAC3D,SAAS,EAAE,CAAC,wBAAwB,CAAC,sBAAsB,CAAC;IAC5D,aAAa,EAAE,CAAC,wBAAwB,CAAC,mBAAmB,CAAC;IAC7D,YAAY,EAAE,CAAC,wBAAwB,CAAC,kBAAkB,EAAE,wBAAwB,CAAC,kBAAkB,CAAC;IACxG,UAAU,EAAE,CAAC,wBAAwB,CAAC,wBAAwB,CAAC;CACvD,CAAC"}
+{"version":3,"file":"email.standard-interface.schemas.js","sourceRoot":"","sources":["../../../../src/protocols/email.standard-interface.schemas.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport { EmailProvider_Capability, EmailProvider_EmailType, EmailProvider_DeliveryStatus } from \"./email.external-connectors-models.schemas\";\n\n//===============================================================\n// Standard Email Interface\n// --------\n// This is the canonical interface that Wildo uses internally to send\n// emails. The ETL layer transforms these standard requests into\n// provider-specific API calls.\n//\n// Design Principles:\n// 1. Provider-agnostic - works with any email provider\n// 2. Capability-aware - validates against provider capabilities\n// 3. Extensible - new fields can be added without breaking existing code\n//===============================================================\n\n// ===============================================================\n// Standard Email Address\n// ===============================================================\n\nexport const StandardEmail_AddressSchema = z.object({\n  email: z.email(),\n  name: z.string().optional(),\n});\n\nexport type StandardEmail_Address = z.infer<typeof StandardEmail_AddressSchema>;\n\n// ===============================================================\n// Standard Attachment\n// ===============================================================\n\nexport const StandardEmail_AttachmentSchema = z.object({\n  filename: z.string().min(1),\n  content: z.string(), // Base64 encoded\n  contentType: z.string().optional(),\n  contentId: z.string().optional(), // For inline images (cid:)\n});\n\nexport type StandardEmail_Attachment = z.infer<typeof StandardEmail_AttachmentSchema>;\n\n/**\n * Wire encoding used by a network email provider gateway.\n *\n * This vocabulary is deliberately closed and explicit on every provider\n * contract: JSON and multipart data require materially different headers and\n * serialization. There is no implicit default.\n */\nexport enum EmailProviderPayloadEncoding {\n  JSON = \"json\",\n  MULTIPART_FORM_DATA = \"multipart-form-data\",\n}\n\n/** Provider acknowledgement state returned by a synchronous send endpoint. */\nexport enum EmailProviderSubmissionStatus {\n  QUEUED = \"queued\",\n  SENT = \"sent\",\n  SCHEDULED = \"scheduled\",\n}\n\n/** Provider-owned classification for HTTP responses whose status is ambiguous. */\nexport enum EmailProviderSubmissionClassification {\n  ACCEPTED = \"accepted\",\n  REJECTED = \"rejected\",\n  ACCEPTANCE_UNKNOWN = \"acceptance_unknown\",\n}\n\n// ===============================================================\n// TRANSACTIONAL: Send Email Request\n// ===============================================================\n\nexport const StandardEmail_SendRequestSchema = z.object({\n  /**\n   * Stable identity of ONE logical provider submission across retries.\n   *\n   * Deliberately not named `idempotencyKey`: it remains the framework's\n   * correlation identity even when the selected provider cannot enforce\n   * idempotency. Provider gateways may map it to a native idempotency field as\n   * an optional duplicate-risk reduction.\n   */\n  submissionId: z.string().min(1).max(256),\n\n  // Recipients (required)\n  to: z.array(StandardEmail_AddressSchema).min(1),\n  cc: z.array(StandardEmail_AddressSchema).optional(),\n  bcc: z.array(StandardEmail_AddressSchema).optional(),\n  \n  // Sender (required unless provider config has default)\n  from: StandardEmail_AddressSchema.optional(),\n  replyTo: StandardEmail_AddressSchema.optional(),\n  \n  // Content (html OR text required)\n  subject: z.string().min(1),\n  html: z.string().optional(),\n  text: z.string().optional(),\n  \n  // Optional features\n  attachments: z.array(StandardEmail_AttachmentSchema).optional(),\n  headers: z.record(z.string(), z.string()).optional(),\n  tags: z.array(z.string()).optional(),\n  \n  // Scheduling (optional - requires SUPPORTS_SCHEDULING)\n  scheduledAt: z.iso.datetime().optional(),\n  \n  // Tracking (optional, uses provider default if not set)\n  trackOpens: z.boolean().optional(),\n  trackClicks: z.boolean().optional(),\n  \n  // Metadata for correlation/tracking\n  metadata: z.record(z.string(), z.string()).optional(),\n}).refine(\n  (data) => data.html !== undefined || data.text !== undefined,\n  { message: \"Either html or text content is required\" }\n);\n\nexport type StandardEmail_SendRequest = z.infer<typeof StandardEmail_SendRequestSchema>;\n\n// ===============================================================\n// TRANSACTIONAL: Send Email Response\n// ===============================================================\n\nexport const StandardEmail_SendResponseSchema = z.object({\n  success: z.boolean(),\n  /**\n   * Mandatory provider-owned submission meaning. HTTP status, receipt shape,\n   * and recipient-level `success` are not interchangeable across providers.\n   */\n  classification: z.enum(EmailProviderSubmissionClassification),\n  /**\n   * Provider-assigned receipts. An array is required because Brevo and\n   * Mailchimp may acknowledge several recipient messages in one response.\n   * Empty is honest for a successful non-delivery preview or a provider that\n   * accepted the request without returning a receipt.\n   */\n  providerMessageIds: z.array(z.string().min(1)),\n  /** Per-recipient rejections returned inside an otherwise successful HTTP response. */\n  rejectedRecipients: z.array(z.object({\n    email: z.string().min(1),\n    reason: z.string().optional(),\n  })).optional(),\n  /**\n   * Provider-declared detail explaining its explicit classification, including\n   * semantic rejection or an ambiguous idempotency/processing conflict.\n   */\n  providerError: z.string().min(1).optional(),\n  /**\n   * Whether the caller should retry this response under at-least-once\n   * semantics. For an acceptance-unknown response, a retry may duplicate a\n   * message unless the selected provider happens to enforce the submission id.\n   */\n  retryable: z.boolean().optional(),\n  /** Provider reports that this submission identity was already suppressed. */\n  deduplicated: z.boolean().optional(),\n  status: z.enum(EmailProviderSubmissionStatus).optional(),\n  scheduledAt: z.iso.datetime().optional(),\n}).superRefine((response, context) => {\n  const accepted =\n    response.classification\n    === EmailProviderSubmissionClassification.ACCEPTED;\n\n  /**\n   * `success` describes whole-request success, whereas `classification`\n   * describes whether any provider submission was accepted. Once a provider\n   * adapter classifies a submission as accepted, auxiliary result metadata\n   * must never turn that acknowledgement into permission to replay. A false\n   * `success` may describe an honest partial result (for example Mailchimp)\n   * or anomalous adapter metadata; `rejectedRecipients` is therefore useful\n   * evidence, but not a prerequisite for preserving acceptance.\n   */\n  if (response.success && !accepted) {\n    context.addIssue({\n      code: 'custom',\n      path: ['success'],\n      message:\n        'A successful email response must be classified as accepted',\n    });\n  }\n  if (response.success && (response.rejectedRecipients?.length ?? 0) > 0) {\n    context.addIssue({\n      code: 'custom',\n      path: ['rejectedRecipients'],\n      message:\n        'A successful email response cannot contain rejected recipients',\n    });\n  }\n  if (!accepted && response.providerMessageIds.length > 0) {\n    context.addIssue({\n      code: 'custom',\n      path: ['providerMessageIds'],\n      message:\n        'A non-accepted email response cannot contain provider acceptance receipts',\n    });\n  }\n  for (const [index, providerMessageId] of response.providerMessageIds.entries()) {\n    if (response.providerMessageIds.indexOf(providerMessageId) !== index) {\n      context.addIssue({\n        code: 'custom',\n        path: ['providerMessageIds', index],\n        message: 'Provider message receipts must be unique',\n      });\n    }\n  }\n\n  for (const acceptedOnlyField of [\n    'deduplicated',\n    'status',\n    'scheduledAt',\n  ] as const) {\n    if (!accepted && response[acceptedOnlyField] !== undefined) {\n      context.addIssue({\n        code: 'custom',\n        path: [acceptedOnlyField],\n        message:\n          `${acceptedOnlyField} is valid only for an accepted email response`,\n      });\n    }\n  }\n  if (\n    response.scheduledAt !== undefined\n    && response.status !== EmailProviderSubmissionStatus.SCHEDULED\n  ) {\n    context.addIssue({\n      code: 'custom',\n      path: ['scheduledAt'],\n      message:\n        'A scheduledAt receipt requires provider status scheduled',\n    });\n  }\n  if (accepted && response.retryable === true) {\n    context.addIssue({\n      code: 'custom',\n      path: ['retryable'],\n      message: 'An accepted email response cannot request replay',\n    });\n  }\n});\n\nexport type StandardEmail_SendResponse = z.infer<typeof StandardEmail_SendResponseSchema>;\n\n// ===============================================================\n// TRANSACTIONAL: Send Template Request\n// ===============================================================\n\nexport const StandardEmail_SendTemplateRequestSchema = z.object({\n  // Recipients\n  to: z.array(StandardEmail_AddressSchema).min(1),\n  cc: z.array(StandardEmail_AddressSchema).optional(),\n  bcc: z.array(StandardEmail_AddressSchema).optional(),\n  \n  // Sender\n  from: StandardEmail_AddressSchema.optional(),\n  replyTo: StandardEmail_AddressSchema.optional(),\n  \n  // Template (requires SUPPORTS_TEMPLATES)\n  templateId: z.string().min(1),\n  templateAlias: z.string().optional(), // Alternative identifier (Postmark)\n  variables: z.record(z.string(), z.unknown()).optional(),\n  \n  // Optional overrides\n  subject: z.string().optional(), // Override template subject\n  \n  // Optional features\n  attachments: z.array(StandardEmail_AttachmentSchema).optional(),\n  tags: z.array(z.string()).optional(),\n  scheduledAt: z.iso.datetime().optional(),\n  \n  // Metadata\n  metadata: z.record(z.string(), z.string()).optional(),\n});\n\nexport type StandardEmail_SendTemplateRequest = z.infer<typeof StandardEmail_SendTemplateRequestSchema>;\n\n// ===============================================================\n// TRANSACTIONAL: Batch Send Request\n// ===============================================================\n\nexport const StandardEmail_BatchRecipientSchema = z.object({\n  to: StandardEmail_AddressSchema,\n  cc: z.array(StandardEmail_AddressSchema).optional(),\n  bcc: z.array(StandardEmail_AddressSchema).optional(),\n  variables: z.record(z.string(), z.unknown()).optional(),\n  subject: z.string().optional(), // Per-recipient subject override\n  metadata: z.record(z.string(), z.string()).optional(),\n});\n\nexport type StandardEmail_BatchRecipient = z.infer<typeof StandardEmail_BatchRecipientSchema>;\n\nexport const StandardEmail_BatchRequestSchema = z.object({\n  // Sender (shared)\n  from: StandardEmail_AddressSchema.optional(),\n  replyTo: StandardEmail_AddressSchema.optional(),\n  \n  // Content (shared - either direct or template)\n  subject: z.string().optional(), // Default subject\n  html: z.string().optional(),\n  text: z.string().optional(),\n  templateId: z.string().optional(),\n  \n  // Recipients with personalizations (requires SUPPORTS_BATCH_SENDING)\n  recipients: z.array(StandardEmail_BatchRecipientSchema).min(1),\n  \n  // Optional features\n  attachments: z.array(StandardEmail_AttachmentSchema).optional(),\n  tags: z.array(z.string()).optional(),\n  scheduledAt: z.iso.datetime().optional(),\n});\n\nexport type StandardEmail_BatchRequest = z.infer<typeof StandardEmail_BatchRequestSchema>;\n\n// ===============================================================\n// TRANSACTIONAL: Batch Send Response\n// ===============================================================\n\nexport const StandardEmail_BatchResponseSchema = z.object({\n  success: z.boolean(),\n  totalRequested: z.number().int(),\n  totalAccepted: z.number().int(),\n  totalRejected: z.number().int(),\n  results: z.array(z.object({\n    // Email address OR summary identifier (e.g. \"batch\" when provider returns aggregate result)\n    email: z.string().min(1),\n    success: z.boolean(),\n    messageId: z.string().optional(),\n    error: z.string().optional(),\n  })),\n});\n\nexport type StandardEmail_BatchResponse = z.infer<typeof StandardEmail_BatchResponseSchema>;\n\n// ===============================================================\n// MARKETING: Contact\n// ===============================================================\n\nexport const StandardMarketing_ContactSchema = z.object({\n  email: z.email(),\n  firstName: z.string().optional(),\n  lastName: z.string().optional(),\n  phone: z.string().optional(),\n  attributes: z.record(z.string(), z.unknown()).optional(),\n});\n\nexport type StandardMarketing_Contact = z.infer<typeof StandardMarketing_ContactSchema>;\n\n// ===============================================================\n// MARKETING: List\n// ===============================================================\n\nexport const StandardMarketing_ListSchema = z.object({\n  id: z.string().optional(), // Provider assigns on create\n  name: z.string().min(1),\n  description: z.string().optional(),\n});\n\nexport type StandardMarketing_List = z.infer<typeof StandardMarketing_ListSchema>;\n\n// ===============================================================\n// MARKETING: Audience (List + Contacts)\n// ===============================================================\n\nexport const StandardMarketing_AudienceSchema = z.object({\n  // List reference (use existing by ID, or create/find by name)\n  list: z.object({\n    id: z.string().optional(),\n    name: z.string().optional(),\n    description: z.string().optional(),\n  }).refine(\n    (data) => data.id !== undefined || data.name !== undefined,\n    { message: \"Either list.id or list.name is required\" }\n  ),\n  \n  // Contacts to add/sync (optional if using existing list)\n  contacts: z.array(StandardMarketing_ContactSchema).optional(),\n});\n\nexport type StandardMarketing_Audience = z.infer<typeof StandardMarketing_AudienceSchema>;\n\n// ===============================================================\n// MARKETING: Campaign Content\n// ===============================================================\n\nexport const StandardMarketing_ContentSchema = z.object({\n  // Use template OR inline content\n  templateId: z.string().optional(),\n  templateVariables: z.record(z.string(), z.unknown()).optional(),\n  \n  // Inline content (if no template)\n  subject: z.string().optional(),\n  html: z.string().optional(),\n  text: z.string().optional(),\n  previewText: z.string().optional(),\n  \n  // Attachments\n  attachments: z.array(StandardEmail_AttachmentSchema).optional(),\n}).refine(\n  (data) => data.templateId !== undefined || data.subject !== undefined,\n  { message: \"Either templateId or subject is required\" }\n);\n\nexport type StandardMarketing_Content = z.infer<typeof StandardMarketing_ContentSchema>;\n\n// ===============================================================\n// MARKETING: Campaign Request\n// ===============================================================\n\nexport const StandardMarketing_CampaignRequestSchema = z.object({\n  // Campaign name\n  name: z.string().min(1),\n  \n  // Sender\n  from: StandardEmail_AddressSchema,\n  replyTo: StandardEmail_AddressSchema.optional(),\n  \n  // Audience\n  audience: StandardMarketing_AudienceSchema,\n  \n  // Content\n  content: StandardMarketing_ContentSchema,\n  \n  // Execution\n  schedule: z.object({\n    sendAt: z.iso.datetime().optional(),\n    sendImmediately: z.boolean().optional(),\n  }).optional(),\n  \n  // Tracking\n  trackOpens: z.boolean().optional().default(true),\n  trackClicks: z.boolean().optional().default(true),\n  \n  // Tags\n  tags: z.array(z.string()).optional(),\n  \n  // Metadata\n  metadata: z.record(z.string(), z.string()).optional(),\n});\n\nexport type StandardMarketing_CampaignRequest = z.infer<typeof StandardMarketing_CampaignRequestSchema>;\n\n// ===============================================================\n// MARKETING: Campaign Response\n// ===============================================================\n\nexport const StandardMarketing_CampaignResponseSchema = z.object({\n  success: z.boolean(),\n  campaignId: z.string(),\n  providerCampaignId: z.string().optional(),\n  status: z.enum([\"draft\", \"scheduled\", \"sending\", \"sent\", \"cancelled\"]),\n  scheduledAt: z.iso.datetime().optional(),\n  listId: z.string().optional(),\n  audienceSize: z.number().int().optional(),\n});\n\nexport type StandardMarketing_CampaignResponse = z.infer<typeof StandardMarketing_CampaignResponseSchema>;\n\n// ===============================================================\n// Message Status Request/Response\n// ===============================================================\n\nexport const StandardEmail_GetStatusRequestSchema = z.object({\n  messageId: z.string().min(1),\n});\n\nexport type StandardEmail_GetStatusRequest = z.infer<typeof StandardEmail_GetStatusRequestSchema>;\n\nexport const StandardEmail_GetStatusResponseSchema = z.object({\n  messageId: 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  bounceReason: z.string().optional(),\n});\n\nexport type StandardEmail_GetStatusResponse = z.infer<typeof StandardEmail_GetStatusResponseSchema>;\n\n// ===============================================================\n// Standard Error\n// ===============================================================\n\nexport const StandardEmail_ErrorSchema = z.object({\n  code: z.enum([\n    \"VALIDATION_ERROR\",\n    \"PROVIDER_ERROR\",\n    \"CAPABILITY_NOT_SUPPORTED\",\n    \"MARKETING_NOT_SUPPORTED\",\n    \"SCHEDULING_NOT_SUPPORTED\",\n    \"TEMPLATE_NOT_FOUND\",\n    \"RATE_LIMIT_EXCEEDED\",\n    \"AUTHENTICATION_FAILED\",\n    \"QUOTA_EXCEEDED\",\n    \"UNKNOWN_ERROR\",\n  ]),\n  message: z.string(),\n  provider: z.string().optional(),\n  details: z.unknown().optional(),\n  \n  // For capability errors - dynamically populated from registry\n  requiredCapability: z.enum(EmailProvider_Capability).optional(),\n  supportedProviders: z.array(z.string()).optional(),\n});\n\nexport type StandardEmail_Error = z.infer<typeof StandardEmail_ErrorSchema>;\n\n// ===============================================================\n// Capability Requirements\n// ===============================================================\n\n/**\n * Maps standard operations to required capabilities.\n * Used by the ETL layer to validate provider support.\n */\nexport const StandardEmail_OperationCapabilities = {\n  sendEmail: [] as EmailProvider_Capability[], // All providers support basic send\n  sendTemplate: [EmailProvider_Capability.SUPPORTS_TEMPLATES],\n  sendBatch: [EmailProvider_Capability.SUPPORTS_BATCH_SENDING],\n  sendScheduled: [EmailProvider_Capability.SUPPORTS_SCHEDULING],\n  sendCampaign: [EmailProvider_Capability.SUPPORTS_MARKETING, EmailProvider_Capability.SUPPORTS_CAMPAIGNS],\n  manageList: [EmailProvider_Capability.SUPPORTS_LIST_MANAGEMENT],\n} as const;\n\nexport type StandardEmail_Operation = keyof typeof StandardEmail_OperationCapabilities;\n"]}

package/dist/esm/protocols/embeddings.external-connectors-models.schemas.d.ts

@@ -0,0 +1,175 @@
+import { z } from "zod";
+import { ExternalProvider_ExchangeProtocol_Configuration_Base, ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Profile_Base } from "../core/commons.external-connectors-models.schemas";
+/**
+ * Concrete embedding-model ids the framework knows. Ids and dimensions are published provider
+ * facts (OpenAI embeddings API); the runtime additionally verifies the MEASURED dimension of
+ * every returned vector against the catalog row before anything is persisted, so a wrong row
+ * here fails loudly instead of poisoning a vector store.
+ */
+export declare enum EmbeddingsProvider_Model {
+    /** OpenAI's cost-efficient embedding model — 1536 dimensions. The industry-default RAG choice. */
+    OPEN_AI_TEXT_EMBEDDING_3_SMALL = "text-embedding-3-small",
+    /** OpenAI's highest-quality embedding model — 3072 dimensions. */
+    OPEN_AI_TEXT_EMBEDDING_3_LARGE = "text-embedding-3-large"
+}
+/**
+ * The embeddings operation vocabulary — deliberately DISJOINT from `LLMProvider_OperationKey`
+ * and `ImageProvider_OperationKey` (each protocol kind owns its own operation enum, so a key's
+ * membership decides its protocol without inspection).
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ *
+ * (`@wildo_source` anchoring + the teaching skill are RAG-plan Phase-7 work — the
+ * capability-catalog rule's DoD is deferred there deliberately, not forgotten.)
+ */
+export declare enum EmbeddingsProvider_OperationKey {
+    /** A batch of texts → one vector per text, in input order. */
+    EMBED_TEXTS = "embeddings.embedTexts"
+}
+/**
+ * WHY a text is being embedded — some models embed retrieval QUERIES differently from the
+ * DOCUMENTS they search over (Voyage/Cohere `input_type`; instruction-prefixed models), so the
+ * caller's intent must travel with the call rather than being inferred. OpenAI `text-embedding-3-*`
+ * ignores the distinction; providers that honour it translate this value at their boundary.
+ *
+ * A named home (semantic-string-literals rule): `'corpus'`/`'query'` are a closed vocabulary,
+ * and this enum is where their semantics live.
+ */
+export declare enum EmbeddingsProvider_TextPurpose {
+    /** The text IS retrievable content — a RAG chunk entering the corpus. */
+    CORPUS = "corpus",
+    /** The text is a SEARCH query that will be matched against corpus vectors. */
+    QUERY = "query"
+}
+/**
+ * @wildo_source:part:start saas.external-providers.embeddings.applicability facet:kind:api facet:audience:app-developer
+ *
+ * WHAT an embedding is produced FOR — the durable axis of embedding-model selection
+ * (model-selection-by-applicability rule: an author names a CLASS, never a concrete model id;
+ * the framework resolves the id from the catalog + preference below).
+ *
+ * This is ALSO the persisted `embeddingClass` stamp on every RAG chunk row: the drain worker
+ * stamps the class it embedded under, and the model-migration pass re-embeds any chunk whose
+ * stamped class→model binding no longer matches the current resolution — so changing the
+ * preference below IS the migration trigger, with no chunk-table DDL and no call-site edits.
+ *
+ * NOTE both corpus AND query embedding of one retrieval surface MUST resolve through the SAME
+ * class — a similarity search across two models' vector spaces is meaningless. That is why the
+ * class names the SURFACE (`RAG_DEFAULT`), not the side (`purpose` carries the side).
+ */
+export declare enum Embeddings_Applicability {
+    /** The default RAG surface: `.ragSource()` corpus chunks and the retrieval queries over them. */
+    RAG_DEFAULT = "rag-default"
+}
+/** @wildo_source:part:end saas.external-providers.embeddings.applicability */
+/**
+ * One row per embedding model: everything the framework knows about a concrete id.
+ * Mirrors `LLM_ModelCatalogEntry`'s shape at the size this axis needs today.
+ */
+export type Embeddings_ModelCatalogEntry = {
+    /** The `ref` of the provider module that serves this id. */
+    providerRef: string;
+    /**
+     * The model's published output dimension. Load-bearing twice: the drain worker VERIFIES every
+     * returned vector against it before persisting (a wrong-dims write silently poisons ANN
+     * indexes), and the pgvector HNSW expression index is created per this dimension.
+     */
+    dims: number;
+    /** FRAMEWORK OPINION — which applicability classes this model may be resolved for. */
+    applicabilities: readonly Embeddings_Applicability[];
+};
+/**
+ * THE embedding-model catalog — the single per-model fact table (the `LLM_MODEL_CATALOG`
+ * discipline: an EXHAUSTIVE `Record`, so a new `EmbeddingsProvider_Model` member without a row
+ * is a compile error).
+ */
+export declare const EMBEDDINGS_MODEL_CATALOG: Record<EmbeddingsProvider_Model, Embeddings_ModelCatalogEntry>;
+/**
+ * The framework's DEFAULT answer to "which embedding model serves this class", ordered by
+ * preference, highest first. THIS BINDING IS THE MIGRATION KEY (RAG plan §3.d): editing it
+ * changes what `resolveEmbeddingsModelForApplicability` answers, which makes every chunk stamped
+ * with the previous model a migration candidate the drain worker re-embeds — bounded per run,
+ * converging over runs. No agent/worker definition changes.
+ */
+export declare const EMBEDDINGS_MODEL_APPLICABILITY_PREFERENCE: Record<Embeddings_Applicability, readonly EmbeddingsProvider_Model[]>;
+/** Why {@link resolveEmbeddingsModelForApplicability} could not answer — carried into a named CONFIGURATION error. */
+export declare enum Embeddings_ModelResolutionFailure {
+    /** The applicability has no candidate at all for this provider. */
+    NO_CANDIDATE_FOR_PROVIDER = "no_candidate_for_provider"
+}
+export type Embeddings_ModelResolution = {
+    resolved: true;
+    model: EmbeddingsProvider_Model;
+    entry: Embeddings_ModelCatalogEntry;
+} | {
+    resolved: false;
+    failure: Embeddings_ModelResolutionFailure;
+    consideredModels: readonly EmbeddingsProvider_Model[];
+};
+/**
+ * Resolve an applicability class to ONE concrete embedding model for a given provider.
+ *
+ * Fails CLOSED and explains itself (the `resolveModelForApplicability` contract): a silent
+ * fallback to some other model would fracture the vector space the class exists to keep whole.
+ * The resolved `(class, model)` pair is what the RAG drain worker stamps on every chunk and what
+ * its migration pass compares stamps against.
+ */
+export declare const resolveEmbeddingsModelForApplicability: (input: {
+    applicability: Embeddings_Applicability;
+    providerRef: string;
+}, catalog?: Record<EmbeddingsProvider_Model, Embeddings_ModelCatalogEntry>) => Embeddings_ModelResolution;
+export type EmbeddingsProvider_Profile = ExternalProvider_ExchangeProtocol_Profile_Base & {
+    baseURL?: string;
+    /** Model ids this provider serves (advertised for validation/UX). */
+    supportedModels?: string[];
+};
+export type EmbeddingsProvider_Configuration = ExternalProvider_ExchangeProtocol_Configuration_Base & {
+    customLocation?: string;
+};
+/**
+ * Usage of one embedding call. There is NO completion-token dimension — an embedding consumes
+ * input tokens and produces vectors, so usage-completeness for an embedding trace is judged on
+ * `inputTokens` alone (H4: an embedding trace must never be flagged token-incomplete for lacking
+ * completion tokens it structurally cannot have).
+ */
+export declare const EmbeddingsProvider_UsageSchema: z.ZodObject<{
+    inputTokens: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type EmbeddingsProvider_Usage = z.infer<typeof EmbeddingsProvider_UsageSchema>;
+export declare const EmbeddingsProvider_ExecutionTransportMetadataSchema: z.ZodObject<{
+    protocolKind: z.ZodLiteral<ExternalProvider_ExchangeProtocol_Kind.EMBEDDINGS_PROVIDER>;
+    providerRef: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EmbeddingsProvider_ExecutionTransportMetadata = z.infer<typeof EmbeddingsProvider_ExecutionTransportMetadataSchema>;
+/** Input of the {@link EmbeddingsProvider_OperationKey.EMBED_TEXTS} operation. */
+export declare const EmbeddingsProvider_EmbedTextsInputSchema: z.ZodObject<{
+    texts: z.ZodArray<z.ZodString>;
+    purpose: z.ZodEnum<typeof EmbeddingsProvider_TextPurpose>;
+}, z.core.$strip>;
+export type EmbeddingsProvider_EmbedTextsInput = z.infer<typeof EmbeddingsProvider_EmbedTextsInputSchema>;
+/**
+ * Output of {@link EmbeddingsProvider_OperationKey.EMBED_TEXTS}. `vectors[i]` embeds `texts[i]`.
+ *
+ * ⚠️ PRIVACY/OBSERVABILITY CONTRACT: raw vectors are a lossy ENCODING of the source text, not
+ * telemetry — they must NEVER reach analytics events, traces, or logs at any verbosity. Consumers
+ * summarize (`vectorCount`, `dims`) instead; the PostHog sink's embedding arm enforces this
+ * defensively even against a mis-built trace.
+ */
+export declare const EmbeddingsProvider_EmbedTextsOutputSchema: z.ZodObject<{
+    vectors: z.ZodArray<z.ZodArray<z.ZodNumber>>;
+    model: z.ZodString;
+    dims: z.ZodNumber;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type EmbeddingsProvider_EmbedTextsOutput = z.infer<typeof EmbeddingsProvider_EmbedTextsOutputSchema>;
+export declare const EmbeddingsProvider_StatusSchema: z.ZodObject<{
+    status: z.ZodEnum<typeof import("..").ExternalProvider_Status>;
+    lastCheckedAt: z.ZodString;
+    errorReason: z.ZodOptional<z.ZodString>;
+    protocolKind: z.ZodLiteral<ExternalProvider_ExchangeProtocol_Kind.EMBEDDINGS_PROVIDER>;
+}, z.core.$strip>;
+export type EmbeddingsProvider_Status = z.infer<typeof EmbeddingsProvider_StatusSchema>;
+//# sourceMappingURL=embeddings.external-connectors-models.schemas.d.ts.map

package/dist/esm/protocols/embeddings.external-connectors-models.schemas.d.ts.map

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

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

@@ -0,0 +1,191 @@
+import { z } from "zod";
+import { ExternalProvider_ExchangeProtocol_Kind, ExternalProvider_ExchangeProtocol_Status_BaseSchema, } from "../core/commons.external-connectors-models.schemas.js";
+//===============================================================
+// Embeddings Provider
+// --------
+// Text → vector embedding providers (OpenAI text-embedding-3, Voyage, Cohere embed, …).
+// Serves the RAG derived-data tier: the `rag:embedding-drain` worker embeds corpus chunks,
+// and retrieval (RAG plan Phase 5) embeds queries through the SAME provider seam so both
+// sides of a similarity search live in one vector space.
+//
+// Deliberately a SEPARATE protocol from `LLM_PROVIDER` (RAG plan DL2, the `IMAGE_PROVIDER`
+// precedent): its I/O is float vectors, its parameters (dimensions / batch size) share nothing
+// with LLM sampling, and — decisive — a sixth `LLMProvider_OperationKey` would fail SILENTLY
+// in every LLM consumer surface, while a new `runtimeContract.kind` fails COMPILATION at every
+// switch. It also fills its own `EngineCapability.AI_EMBEDDINGS` slot so an application can pick
+// Anthropic for chat and a different provider for embeddings.
+//===============================================================
+/**
+ * Concrete embedding-model ids the framework knows. Ids and dimensions are published provider
+ * facts (OpenAI embeddings API); the runtime additionally verifies the MEASURED dimension of
+ * every returned vector against the catalog row before anything is persisted, so a wrong row
+ * here fails loudly instead of poisoning a vector store.
+ */
+export var EmbeddingsProvider_Model;
+(function (EmbeddingsProvider_Model) {
+    /** OpenAI's cost-efficient embedding model — 1536 dimensions. The industry-default RAG choice. */
+    EmbeddingsProvider_Model["OPEN_AI_TEXT_EMBEDDING_3_SMALL"] = "text-embedding-3-small";
+    /** OpenAI's highest-quality embedding model — 3072 dimensions. */
+    EmbeddingsProvider_Model["OPEN_AI_TEXT_EMBEDDING_3_LARGE"] = "text-embedding-3-large";
+})(EmbeddingsProvider_Model || (EmbeddingsProvider_Model = {}));
+/**
+ * The embeddings operation vocabulary — deliberately DISJOINT from `LLMProvider_OperationKey`
+ * and `ImageProvider_OperationKey` (each protocol kind owns its own operation enum, so a key's
+ * membership decides its protocol without inspection).
+ *
+ * Import path: `@wildo-ai/external-connectors-models`.
+ *
+ * (`@wildo_source` anchoring + the teaching skill are RAG-plan Phase-7 work — the
+ * capability-catalog rule's DoD is deferred there deliberately, not forgotten.)
+ */
+export var EmbeddingsProvider_OperationKey;
+(function (EmbeddingsProvider_OperationKey) {
+    /** A batch of texts → one vector per text, in input order. */
+    EmbeddingsProvider_OperationKey["EMBED_TEXTS"] = "embeddings.embedTexts";
+})(EmbeddingsProvider_OperationKey || (EmbeddingsProvider_OperationKey = {}));
+/**
+ * WHY a text is being embedded — some models embed retrieval QUERIES differently from the
+ * DOCUMENTS they search over (Voyage/Cohere `input_type`; instruction-prefixed models), so the
+ * caller's intent must travel with the call rather than being inferred. OpenAI `text-embedding-3-*`
+ * ignores the distinction; providers that honour it translate this value at their boundary.
+ *
+ * A named home (semantic-string-literals rule): `'corpus'`/`'query'` are a closed vocabulary,
+ * and this enum is where their semantics live.
+ */
+export var EmbeddingsProvider_TextPurpose;
+(function (EmbeddingsProvider_TextPurpose) {
+    /** The text IS retrievable content — a RAG chunk entering the corpus. */
+    EmbeddingsProvider_TextPurpose["CORPUS"] = "corpus";
+    /** The text is a SEARCH query that will be matched against corpus vectors. */
+    EmbeddingsProvider_TextPurpose["QUERY"] = "query";
+})(EmbeddingsProvider_TextPurpose || (EmbeddingsProvider_TextPurpose = {}));
+/**
+ * @wildo_source:part:start saas.external-providers.embeddings.applicability facet:kind:api facet:audience:app-developer
+ *
+ * WHAT an embedding is produced FOR — the durable axis of embedding-model selection
+ * (model-selection-by-applicability rule: an author names a CLASS, never a concrete model id;
+ * the framework resolves the id from the catalog + preference below).
+ *
+ * This is ALSO the persisted `embeddingClass` stamp on every RAG chunk row: the drain worker
+ * stamps the class it embedded under, and the model-migration pass re-embeds any chunk whose
+ * stamped class→model binding no longer matches the current resolution — so changing the
+ * preference below IS the migration trigger, with no chunk-table DDL and no call-site edits.
+ *
+ * NOTE both corpus AND query embedding of one retrieval surface MUST resolve through the SAME
+ * class — a similarity search across two models' vector spaces is meaningless. That is why the
+ * class names the SURFACE (`RAG_DEFAULT`), not the side (`purpose` carries the side).
+ */
+export var Embeddings_Applicability;
+(function (Embeddings_Applicability) {
+    /** The default RAG surface: `.ragSource()` corpus chunks and the retrieval queries over them. */
+    Embeddings_Applicability["RAG_DEFAULT"] = "rag-default";
+})(Embeddings_Applicability || (Embeddings_Applicability = {}));
+/**
+ * THE embedding-model catalog — the single per-model fact table (the `LLM_MODEL_CATALOG`
+ * discipline: an EXHAUSTIVE `Record`, so a new `EmbeddingsProvider_Model` member without a row
+ * is a compile error).
+ */
+export const EMBEDDINGS_MODEL_CATALOG = {
+    [EmbeddingsProvider_Model.OPEN_AI_TEXT_EMBEDDING_3_SMALL]: {
+        providerRef: "openai",
+        dims: 1536,
+        applicabilities: [Embeddings_Applicability.RAG_DEFAULT],
+    },
+    [EmbeddingsProvider_Model.OPEN_AI_TEXT_EMBEDDING_3_LARGE]: {
+        providerRef: "openai",
+        dims: 3072,
+        // Deliberately NOT auto-selected for RAG_DEFAULT: 2× the storage + ANN cost for a quality
+        // delta most application corpora do not need. An application that wants it overrides the
+        // preference (or a future applicability class names the high-quality surface).
+        applicabilities: [],
+    },
+};
+/**
+ * The framework's DEFAULT answer to "which embedding model serves this class", ordered by
+ * preference, highest first. THIS BINDING IS THE MIGRATION KEY (RAG plan §3.d): editing it
+ * changes what `resolveEmbeddingsModelForApplicability` answers, which makes every chunk stamped
+ * with the previous model a migration candidate the drain worker re-embeds — bounded per run,
+ * converging over runs. No agent/worker definition changes.
+ */
+export const EMBEDDINGS_MODEL_APPLICABILITY_PREFERENCE = {
+    [Embeddings_Applicability.RAG_DEFAULT]: [
+        EmbeddingsProvider_Model.OPEN_AI_TEXT_EMBEDDING_3_SMALL,
+    ],
+};
+/** Why {@link resolveEmbeddingsModelForApplicability} could not answer — carried into a named CONFIGURATION error. */
+export var Embeddings_ModelResolutionFailure;
+(function (Embeddings_ModelResolutionFailure) {
+    /** The applicability has no candidate at all for this provider. */
+    Embeddings_ModelResolutionFailure["NO_CANDIDATE_FOR_PROVIDER"] = "no_candidate_for_provider";
+})(Embeddings_ModelResolutionFailure || (Embeddings_ModelResolutionFailure = {}));
+/**
+ * Resolve an applicability class to ONE concrete embedding model for a given provider.
+ *
+ * Fails CLOSED and explains itself (the `resolveModelForApplicability` contract): a silent
+ * fallback to some other model would fracture the vector space the class exists to keep whole.
+ * The resolved `(class, model)` pair is what the RAG drain worker stamps on every chunk and what
+ * its migration pass compares stamps against.
+ */
+export const resolveEmbeddingsModelForApplicability = (input, catalog = EMBEDDINGS_MODEL_CATALOG) => {
+    const candidates = EMBEDDINGS_MODEL_APPLICABILITY_PREFERENCE[input.applicability];
+    const forProvider = candidates.filter((model) => {
+        const entry = catalog[model];
+        return entry.providerRef === input.providerRef && entry.applicabilities.includes(input.applicability);
+    });
+    if (forProvider.length === 0) {
+        return { resolved: false, failure: Embeddings_ModelResolutionFailure.NO_CANDIDATE_FOR_PROVIDER, consideredModels: candidates };
+    }
+    const model = forProvider[0];
+    return { resolved: true, model, entry: catalog[model] };
+};
+// ===============================================================
+// Embeddings Operations Context
+// ===============================================================
+/**
+ * Usage of one embedding call. There is NO completion-token dimension — an embedding consumes
+ * input tokens and produces vectors, so usage-completeness for an embedding trace is judged on
+ * `inputTokens` alone (H4: an embedding trace must never be flagged token-incomplete for lacking
+ * completion tokens it structurally cannot have).
+ */
+export const EmbeddingsProvider_UsageSchema = z.object({
+    /** Provider-reported input tokens, when the model reports them (OpenAI does). */
+    inputTokens: z.number().optional(),
+});
+export const EmbeddingsProvider_ExecutionTransportMetadataSchema = z.object({
+    protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.EMBEDDINGS_PROVIDER),
+    providerRef: z.string(),
+    model: z.string().optional(),
+});
+// ===============================================================
+// Embeddings I/O Schemas
+// ===============================================================
+/** Input of the {@link EmbeddingsProvider_OperationKey.EMBED_TEXTS} operation. */
+export const EmbeddingsProvider_EmbedTextsInputSchema = z.object({
+    /** The texts to embed — one vector is returned per text, in this order. */
+    texts: z.array(z.string()).min(1),
+    /** Why these texts are embedded — see {@link EmbeddingsProvider_TextPurpose}. */
+    purpose: z.enum(EmbeddingsProvider_TextPurpose),
+});
+/**
+ * Output of {@link EmbeddingsProvider_OperationKey.EMBED_TEXTS}. `vectors[i]` embeds `texts[i]`.
+ *
+ * ⚠️ PRIVACY/OBSERVABILITY CONTRACT: raw vectors are a lossy ENCODING of the source text, not
+ * telemetry — they must NEVER reach analytics events, traces, or logs at any verbosity. Consumers
+ * summarize (`vectorCount`, `dims`) instead; the PostHog sink's embedding arm enforces this
+ * defensively even against a mis-built trace.
+ */
+export const EmbeddingsProvider_EmbedTextsOutputSchema = z.object({
+    vectors: z.array(z.array(z.number())),
+    /** The concrete model that produced the vectors — the chunk rows' `embeddingModel` stamp. */
+    model: z.string(),
+    /** The (verified) dimension every returned vector carries — the `embeddingDims` stamp. */
+    dims: z.number().int().positive(),
+    usage: EmbeddingsProvider_UsageSchema,
+});
+// ===============================================================
+// STATUS
+// ===============================================================
+export const EmbeddingsProvider_StatusSchema = ExternalProvider_ExchangeProtocol_Status_BaseSchema.extend({
+    protocolKind: z.literal(ExternalProvider_ExchangeProtocol_Kind.EMBEDDINGS_PROVIDER),
+});
+//# sourceMappingURL=embeddings.external-connectors-models.schemas.js.map