@primitivedotdev/sdk 1.22.1 → 1.24.0

package/dist/{index-x795QzI4.d.ts → index-fS1gVNuX.d.ts}

@@ -1,5 +1,5 @@
-import { L as WebhookEvent, f as EmailReceivedEvent } from "./types-DJsEJwJ6.js";
-import { u as WebhookValidationError, y as ReceivedEmail } from "./errors-BSsdMlef.js";
+import { L as WebhookEvent, f as EmailReceivedEvent } from "./types-DcXtFARL.js";
+import { u as WebhookValidationError, y as ReceivedEmail } from "./errors-BgI9FKHK.js";
 
 //#region src/validation.d.ts
 interface ValidationSuccess<T> {
@@ -804,7 +804,7 @@ declare const emailReceivedEventJsonSchema: {
         };
         readonly forward: {
           readonly $ref: "#/definitions/ForwardAnalysis";
-          readonly description: "Forward detection and analysis results.\n\nOptional. Present when the email was processed by a forward-detection pipeline (always present in Primitive's managed service). When absent, forward detection was not performed on this email.";
+          readonly description: "Forward detection and analysis results.\n\nOptional. In Primitive's managed service this object is included only when forwarded content is detected; when absent, no forward was detected or forward detection was not performed.";
         };
         readonly bounce: {
           readonly $ref: "#/definitions/BounceAnalysis";

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { A as client, B as PrimitiveApiError, C as SendAttachment, D as SendResult, Hr as CreateAgentClaimLinkInput, Ir as CreateAgentAccountInput, M as createPrimitiveClient, O as SendThreadInput, Rm as StartAgentClaimInput, T as SendInput, Zd as PlanLimits, _ as MemorySetInput, a as ForwardInput, b as ReplyInput, c as InboxStreamOptions, d as MemoryGetInput, dr as AgentAccountUpgradeHint, f as MemoryJsonValue, fr as AgentClaimLinkResult, g as MemorySearchResponse, h as MemorySearchInput, i as CreatedAgent, j as createAgent, k as WaitForNextOptions, l as MemoriesResource, m as MemoryRecordWithValue, mr as AgentClaimStartResult, nr as Account, o as InboundEmail, p as MemoryRecord, pr as AgentClaimResult, r as CreateAgentOptions, r_ as VerifyAgentClaimInput, s as InboxResource, t as AccountResource, u as MemoryDeleteInput, ur as AgentAccountResult, v as PrimitiveClient, y as PrimitiveClientOptions } from "./index-PTY8VraQ.js";
-import { $ as isPaymentFailedEvent, A as RawContentInline, B as InteractionEvent, C as ParsedData, D as ParsedStatus, E as ParsedError, F as ValidateEmailAuthResult, G as PaymentFailedEvent, H as InteractionX402Suffix, I as WebhookAttachment, J as WebhookEventType, K as PaymentSettledEvent, L as WebhookEvent, M as SpfResult, N as TlsReportAnalysis, O as RawContent, P as UnknownEvent, Q as isPaymentEvent, R as EMAIL_EVENT_TYPES, S as KnownWebhookEvent, T as ParsedDataFailed, U as PAYMENT_EVENT_TYPES, V as InteractionX402Event, W as PaymentEvent, X as isInteractionX402Event, Y as isEmailReceivedEvent, Z as isKnownWebhookEventType, _ as ForwardResultAttachmentAnalyzed, a as DkimSignature, b as ForwardVerdict, c as DmarcResult, d as EmailAuth, et as isPaymentSettledEvent, f as EmailReceivedEvent, g as ForwardResult, h as ForwardOriginalSender, i as DkimResult, j as RoutingDecision, k as RawContentDownloadOnly, l as EmailAddress, m as ForwardAnalysis, n as AuthVerdict, o as DmarcPolicy, p as EventType, q as WEBHOOK_EVENT_TYPES, r as BounceAnalysis, s as DmarcReportAnalysis, t as AuthConfidence, u as EmailAnalysis, v as ForwardResultAttachmentSkipped, w as ParsedDataComplete, x as ForwardVerification, y as ForwardResultInline, z as INTERACTION_EVENT_TYPES } from "./types-DJsEJwJ6.js";
-import { C as buildReplySubject, E as parseHeaderAddress, S as buildForwardSubject, T as normalizeReceivedEmail, _ as isTrustedSender, a as RawEmailDecodeErrorCode, b as ReceivedEmailAddress, c as WebhookPayloadError, d as WebhookValidationErrorCode, f as WebhookVerificationError, g as TrustedSenderResult, h as TrustedSenderOptions, i as RawEmailDecodeError, l as WebhookPayloadErrorCode, m as TrustReason, n as PrimitiveWebhookError, o as VERIFICATION_ERRORS, p as WebhookVerificationErrorCode, r as RAW_EMAIL_ERRORS, s as WebhookErrorCode, t as PAYLOAD_ERRORS, u as WebhookValidationError, v as validateEmailAuth, w as formatAddress, x as ReceivedEmailThread, y as ReceivedEmail } from "./errors-BSsdMlef.js";
-import { A as SignResult, B as validateEmailReceivedEvent, C as StandardWebhooksVerifyOptions, D as LEGACY_SIGNATURE_HEADER, E as LEGACY_CONFIRMED_HEADER, F as VerifyDownloadTokenOptions, I as VerifyDownloadTokenResult, L as generateDownloadToken, M as signWebhookPayload, N as verifyWebhookSignature, O as PRIMITIVE_CONFIRMED_HEADER, P as GenerateDownloadTokenOptions, R as verifyDownloadToken, S as StandardWebhooksSignResult, T as verifyStandardWebhooksSignature, _ as WEBHOOK_VERSION, a as WebhookHeaders, b as STANDARD_WEBHOOK_SIGNATURE_HEADER, c as getDownloadTimeRemaining, d as handleWebhookEvent, f as isDownloadExpired, g as verifyRawEmailDownload, h as receive, i as WEBHOOK_EVENT_HEADER, j as VerifyOptions, k as PRIMITIVE_SIGNATURE_HEADER, l as getEventHeader, m as parseWebhookEvent, n as HandleWebhookOptions, o as confirmedHeaders, p as isRawIncluded, r as ReceiveRequestOptions, s as decodeRawEmail, t as DecodeRawEmailOptions, u as handleWebhook, v as emailReceivedEventJsonSchema, w as signStandardWebhooksPayload, x as STANDARD_WEBHOOK_TIMESTAMP_HEADER, y as STANDARD_WEBHOOK_ID_HEADER, z as safeValidateEmailReceivedEvent } from "./index-x795QzI4.js";
-import { NonceBinding, PayoutRegistrationMessageInput, TokenDomain, TransferAuthorization, X402Challenge, X402ChargeInput, X402Client, X402ClientOptions, X402DeclinedPayment, X402Error, X402PaymentPayload, X402PaymentRequirements, X402PayoutAddress, X402Receipt, X402Signer, X402SpendPolicy, buildPayoutRegistrationMessage, createX402Client, deriveEip3009Nonce, parseEmailChallengeFromPart } from "./x402/index.js";
+import { A as WaitForNextOptions, Cr as AgentClaimLinkResult, E as SendInput, Ei as CreateAgentClaimLinkInput, M as createAgent, N as createPrimitiveClient, O as SendResult, Ov as VerifyAgentClaimInput, Sr as AgentAccountUpgradeHint, Tr as AgentClaimStartResult, V as PrimitiveApiError, _ as MemorySearchResponse, a as CreatedAgent, b as PrimitiveClientOptions, bi as CreateAgentAccountInput, c as InboxResource, d as MemoryDeleteInput, f as MemoryGetInput, g as MemorySearchInput, h as MemoryRecordWithValue, i as CreateAgentOptions, j as client, k as SendThreadInput, l as InboxStreamOptions, m as MemoryRecord, ng as StartAgentClaimInput, o as ForwardInput, p as MemoryJsonValue, pr as Account, r as AttachmentPartDownload, s as InboundEmail, t as AccountResource, tp as PlanLimits, u as MemoriesResource, v as MemorySetInput, w as SendAttachment, wr as AgentClaimResult, x as ReplyInput, xr as AgentAccountResult, y as PrimitiveClient } from "./index-Dv1zvPCc.js";
+import { $ as isPaymentFailedEvent, A as RawContentInline, B as InteractionEvent, C as ParsedData, D as ParsedStatus, E as ParsedError, F as ValidateEmailAuthResult, G as PaymentFailedEvent, H as InteractionX402Suffix, I as WebhookAttachment, J as WebhookEventType, K as PaymentSettledEvent, L as WebhookEvent, M as SpfResult, N as TlsReportAnalysis, O as RawContent, P as UnknownEvent, Q as isPaymentEvent, R as EMAIL_EVENT_TYPES, S as KnownWebhookEvent, T as ParsedDataFailed, U as PAYMENT_EVENT_TYPES, V as InteractionX402Event, W as PaymentEvent, X as isInteractionX402Event, Y as isEmailReceivedEvent, Z as isKnownWebhookEventType, _ as ForwardResultAttachmentAnalyzed, a as DkimSignature, b as ForwardVerdict, c as DmarcResult, d as EmailAuth, et as isPaymentSettledEvent, f as EmailReceivedEvent, g as ForwardResult, h as ForwardOriginalSender, i as DkimResult, j as RoutingDecision, k as RawContentDownloadOnly, l as EmailAddress, m as ForwardAnalysis, n as AuthVerdict, o as DmarcPolicy, p as EventType, q as WEBHOOK_EVENT_TYPES, r as BounceAnalysis, s as DmarcReportAnalysis, t as AuthConfidence, u as EmailAnalysis, v as ForwardResultAttachmentSkipped, w as ParsedDataComplete, x as ForwardVerification, y as ForwardResultInline, z as INTERACTION_EVENT_TYPES } from "./types-DcXtFARL.js";
+import { C as buildReplySubject, E as parseHeaderAddress, S as buildForwardSubject, T as normalizeReceivedEmail, _ as isTrustedSender, a as RawEmailDecodeErrorCode, b as ReceivedEmailAddress, c as WebhookPayloadError, d as WebhookValidationErrorCode, f as WebhookVerificationError, g as TrustedSenderResult, h as TrustedSenderOptions, i as RawEmailDecodeError, l as WebhookPayloadErrorCode, m as TrustReason, n as PrimitiveWebhookError, o as VERIFICATION_ERRORS, p as WebhookVerificationErrorCode, r as RAW_EMAIL_ERRORS, s as WebhookErrorCode, t as PAYLOAD_ERRORS, u as WebhookValidationError, v as validateEmailAuth, w as formatAddress, x as ReceivedEmailThread, y as ReceivedEmail } from "./errors-BgI9FKHK.js";
+import { A as SignResult, B as validateEmailReceivedEvent, C as StandardWebhooksVerifyOptions, D as LEGACY_SIGNATURE_HEADER, E as LEGACY_CONFIRMED_HEADER, F as VerifyDownloadTokenOptions, I as VerifyDownloadTokenResult, L as generateDownloadToken, M as signWebhookPayload, N as verifyWebhookSignature, O as PRIMITIVE_CONFIRMED_HEADER, P as GenerateDownloadTokenOptions, R as verifyDownloadToken, S as StandardWebhooksSignResult, T as verifyStandardWebhooksSignature, _ as WEBHOOK_VERSION, a as WebhookHeaders, b as STANDARD_WEBHOOK_SIGNATURE_HEADER, c as getDownloadTimeRemaining, d as handleWebhookEvent, f as isDownloadExpired, g as verifyRawEmailDownload, h as receive, i as WEBHOOK_EVENT_HEADER, j as VerifyOptions, k as PRIMITIVE_SIGNATURE_HEADER, l as getEventHeader, m as parseWebhookEvent, n as HandleWebhookOptions, o as confirmedHeaders, p as isRawIncluded, r as ReceiveRequestOptions, s as decodeRawEmail, t as DecodeRawEmailOptions, u as handleWebhook, v as emailReceivedEventJsonSchema, w as signStandardWebhooksPayload, x as STANDARD_WEBHOOK_TIMESTAMP_HEADER, y as STANDARD_WEBHOOK_ID_HEADER, z as safeValidateEmailReceivedEvent } from "./index-fS1gVNuX.js";
+import { a as NonceBinding, c as TokenDomain, f as X402PaymentPayload, l as TransferAuthorization, m as X402Signer, o as PayoutRegistrationMessageInput, x as deriveEip3009Nonce, y as buildPayoutRegistrationMessage } from "./sign-m3ZStnNw.js";
+import { X402Challenge, X402ChargeInput, X402Client, X402ClientOptions, X402DeclinedPayment, X402Error, X402PaymentRequirements, X402PayoutAddress, X402Receipt, X402SpendPolicy, createX402Client, parseEmailChallengeFromPart } from "./x402/index.js";
 
 //#region src/index.d.ts
 declare const primitive: {
@@ -11,4 +12,4 @@ declare const primitive: {
   x402: typeof createX402Client;
 };
 //#endregion
-export { type Account, AccountResource, type AgentAccountResult, type AgentAccountUpgradeHint, type AgentClaimLinkResult, type AgentClaimResult, type AgentClaimStartResult, AuthConfidence, AuthVerdict, BounceAnalysis, type CreateAgentAccountInput, type CreateAgentClaimLinkInput, type CreateAgentOptions, type CreatedAgent, DecodeRawEmailOptions, DkimResult, DkimSignature, DmarcPolicy, DmarcReportAnalysis, DmarcResult, EMAIL_EVENT_TYPES, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EventType, ForwardAnalysis, type ForwardInput, ForwardOriginalSender, ForwardResult, ForwardResultAttachmentAnalyzed, ForwardResultAttachmentSkipped, ForwardResultInline, ForwardVerdict, ForwardVerification, GenerateDownloadTokenOptions, HandleWebhookOptions, INTERACTION_EVENT_TYPES, type InboundEmail, InboxResource, type InboxStreamOptions, InteractionEvent, InteractionX402Event, InteractionX402Suffix, KnownWebhookEvent, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, MemoriesResource, type MemoryDeleteInput, type MemoryGetInput, type MemoryJsonValue, type MemoryRecord, type MemoryRecordWithValue, type MemorySearchInput, type MemorySearchResponse, type MemorySetInput, type NonceBinding, PAYLOAD_ERRORS, PAYMENT_EVENT_TYPES, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus, PaymentEvent, PaymentFailedEvent, PaymentSettledEvent, type PayoutRegistrationMessageInput, type PlanLimits, PrimitiveApiError, PrimitiveClient, type PrimitiveClientOptions, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawContent, RawContentDownloadOnly, RawContentInline, RawEmailDecodeError, RawEmailDecodeErrorCode, ReceiveRequestOptions, ReceivedEmail, ReceivedEmailAddress, ReceivedEmailThread, type ReplyInput, RoutingDecision, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, type SendAttachment, type SendInput, type SendResult, type SendThreadInput, SignResult, SpfResult, StandardWebhooksSignResult, StandardWebhooksVerifyOptions, type StartAgentClaimInput, TlsReportAnalysis, type TokenDomain, type TransferAuthorization, TrustReason, TrustedSenderOptions, TrustedSenderResult, UnknownEvent, VERIFICATION_ERRORS, ValidateEmailAuthResult, type VerifyAgentClaimInput, VerifyDownloadTokenOptions, VerifyDownloadTokenResult, VerifyOptions, WEBHOOK_EVENT_HEADER, WEBHOOK_EVENT_TYPES, WEBHOOK_VERSION, type WaitForNextOptions, WebhookAttachment, WebhookErrorCode, WebhookEvent, WebhookEventType, WebhookHeaders, WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError, WebhookVerificationErrorCode, type X402Challenge, type X402ChargeInput, X402Client, type X402ClientOptions, type X402DeclinedPayment, X402Error, type X402PaymentPayload, type X402PaymentRequirements, type X402PayoutAddress, type X402Receipt, type X402Signer, type X402SpendPolicy, buildForwardSubject, buildPayoutRegistrationMessage, buildReplySubject, client, confirmedHeaders, createAgent, createPrimitiveClient, createX402Client, decodeRawEmail, primitive as default, deriveEip3009Nonce, emailReceivedEventJsonSchema, formatAddress, generateDownloadToken, getDownloadTimeRemaining, getEventHeader, handleWebhook, handleWebhookEvent, isDownloadExpired, isEmailReceivedEvent, isInteractionX402Event, isKnownWebhookEventType, isPaymentEvent, isPaymentFailedEvent, isPaymentSettledEvent, isRawIncluded, isTrustedSender, normalizeReceivedEmail, parseEmailChallengeFromPart, parseHeaderAddress, parseWebhookEvent, receive, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature };
+export { type Account, AccountResource, type AgentAccountResult, type AgentAccountUpgradeHint, type AgentClaimLinkResult, type AgentClaimResult, type AgentClaimStartResult, type AttachmentPartDownload, AuthConfidence, AuthVerdict, BounceAnalysis, type CreateAgentAccountInput, type CreateAgentClaimLinkInput, type CreateAgentOptions, type CreatedAgent, DecodeRawEmailOptions, DkimResult, DkimSignature, DmarcPolicy, DmarcReportAnalysis, DmarcResult, EMAIL_EVENT_TYPES, EmailAddress, EmailAnalysis, EmailAuth, EmailReceivedEvent, EventType, ForwardAnalysis, type ForwardInput, ForwardOriginalSender, ForwardResult, ForwardResultAttachmentAnalyzed, ForwardResultAttachmentSkipped, ForwardResultInline, ForwardVerdict, ForwardVerification, GenerateDownloadTokenOptions, HandleWebhookOptions, INTERACTION_EVENT_TYPES, type InboundEmail, InboxResource, type InboxStreamOptions, InteractionEvent, InteractionX402Event, InteractionX402Suffix, KnownWebhookEvent, LEGACY_CONFIRMED_HEADER, LEGACY_SIGNATURE_HEADER, MemoriesResource, type MemoryDeleteInput, type MemoryGetInput, type MemoryJsonValue, type MemoryRecord, type MemoryRecordWithValue, type MemorySearchInput, type MemorySearchResponse, type MemorySetInput, type NonceBinding, PAYLOAD_ERRORS, PAYMENT_EVENT_TYPES, PRIMITIVE_CONFIRMED_HEADER, PRIMITIVE_SIGNATURE_HEADER, ParsedData, ParsedDataComplete, ParsedDataFailed, ParsedError, ParsedStatus, PaymentEvent, PaymentFailedEvent, PaymentSettledEvent, type PayoutRegistrationMessageInput, type PlanLimits, PrimitiveApiError, PrimitiveClient, type PrimitiveClientOptions, PrimitiveWebhookError, RAW_EMAIL_ERRORS, RawContent, RawContentDownloadOnly, RawContentInline, RawEmailDecodeError, RawEmailDecodeErrorCode, ReceiveRequestOptions, ReceivedEmail, ReceivedEmailAddress, ReceivedEmailThread, type ReplyInput, RoutingDecision, STANDARD_WEBHOOK_ID_HEADER, STANDARD_WEBHOOK_SIGNATURE_HEADER, STANDARD_WEBHOOK_TIMESTAMP_HEADER, type SendAttachment, type SendInput, type SendResult, type SendThreadInput, SignResult, SpfResult, StandardWebhooksSignResult, StandardWebhooksVerifyOptions, type StartAgentClaimInput, TlsReportAnalysis, type TokenDomain, type TransferAuthorization, TrustReason, TrustedSenderOptions, TrustedSenderResult, UnknownEvent, VERIFICATION_ERRORS, ValidateEmailAuthResult, type VerifyAgentClaimInput, VerifyDownloadTokenOptions, VerifyDownloadTokenResult, VerifyOptions, WEBHOOK_EVENT_HEADER, WEBHOOK_EVENT_TYPES, WEBHOOK_VERSION, type WaitForNextOptions, WebhookAttachment, WebhookErrorCode, WebhookEvent, WebhookEventType, WebhookHeaders, WebhookPayloadError, WebhookPayloadErrorCode, WebhookValidationError, WebhookValidationErrorCode, WebhookVerificationError, WebhookVerificationErrorCode, type X402Challenge, type X402ChargeInput, X402Client, type X402ClientOptions, type X402DeclinedPayment, X402Error, type X402PaymentPayload, type X402PaymentRequirements, type X402PayoutAddress, type X402Receipt, type X402Signer, type X402SpendPolicy, buildForwardSubject, buildPayoutRegistrationMessage, buildReplySubject, client, confirmedHeaders, createAgent, createPrimitiveClient, createX402Client, decodeRawEmail, primitive as default, deriveEip3009Nonce, emailReceivedEventJsonSchema, formatAddress, generateDownloadToken, getDownloadTimeRemaining, getEventHeader, handleWebhook, handleWebhookEvent, isDownloadExpired, isEmailReceivedEvent, isInteractionX402Event, isKnownWebhookEventType, isPaymentEvent, isPaymentFailedEvent, isPaymentSettledEvent, isRawIncluded, isTrustedSender, normalizeReceivedEmail, parseEmailChallengeFromPart, parseHeaderAddress, parseWebhookEvent, receive, safeValidateEmailReceivedEvent, signStandardWebhooksPayload, signWebhookPayload, validateEmailAuth, validateEmailReceivedEvent, verifyDownloadToken, verifyRawEmailDownload, verifyStandardWebhooksSignature, verifyWebhookSignature };

package/dist/index.js

@@ -1,6 +1,6 @@
-import { a as PrimitiveClient, c as createPrimitiveClient, i as MemoriesResource, m as PrimitiveApiError, o as client, r as InboxResource, s as createAgent, t as AccountResource } from "./api-D18uroMD.js";
+import { a as PrimitiveClient, c as createPrimitiveClient, i as MemoriesResource, m as PrimitiveApiError, o as client, r as InboxResource, s as createAgent, t as AccountResource } from "./api-C_OS8hb4.js";
 import { C as normalizeReceivedEmail, S as formatAddress, _ as ForwardVerdict, a as VERIFICATION_ERRORS, b as buildForwardSubject, c as WebhookVerificationError, d as AuthConfidence, f as AuthVerdict, g as EventType, h as DmarcResult, i as RawEmailDecodeError, l as isTrustedSender, m as DmarcPolicy, n as PrimitiveWebhookError, o as WebhookPayloadError, p as DkimResult, r as RAW_EMAIL_ERRORS, s as WebhookValidationError, t as PAYLOAD_ERRORS, u as validateEmailAuth, v as ParsedStatus, w as parseHeaderAddress, x as buildReplySubject, y as SpfResult } from "./errors-Bo0f7eId.js";
-import { A as isEmailReceivedEvent, C as PRIMITIVE_SIGNATURE_HEADER, D as INTERACTION_EVENT_TYPES, E as EMAIL_EVENT_TYPES, F as isPaymentSettledEvent, I as generateDownloadToken, L as verifyDownloadToken, M as isKnownWebhookEventType, N as isPaymentEvent, O as PAYMENT_EVENT_TYPES, P as isPaymentFailedEvent, R as safeValidateEmailReceivedEvent, S as PRIMITIVE_CONFIRMED_HEADER, T as verifyWebhookSignature, _ as STANDARD_WEBHOOK_TIMESTAMP_HEADER, a as getEventHeader, b as LEGACY_CONFIRMED_HEADER, c as isDownloadExpired, d as receive, f as verifyRawEmailDownload, g as STANDARD_WEBHOOK_SIGNATURE_HEADER, h as STANDARD_WEBHOOK_ID_HEADER, i as getDownloadTimeRemaining, j as isInteractionX402Event, k as WEBHOOK_EVENT_TYPES, l as isRawIncluded, m as emailReceivedEventJsonSchema, n as confirmedHeaders, o as handleWebhook, p as WEBHOOK_VERSION, r as decodeRawEmail, s as handleWebhookEvent, t as WEBHOOK_EVENT_HEADER, u as parseWebhookEvent, v as signStandardWebhooksPayload, w as signWebhookPayload, x as LEGACY_SIGNATURE_HEADER, y as verifyStandardWebhooksSignature, z as validateEmailReceivedEvent } from "./webhook-CTaEuJz2.js";
+import { A as isEmailReceivedEvent, C as PRIMITIVE_SIGNATURE_HEADER, D as INTERACTION_EVENT_TYPES, E as EMAIL_EVENT_TYPES, F as isPaymentSettledEvent, I as generateDownloadToken, L as verifyDownloadToken, M as isKnownWebhookEventType, N as isPaymentEvent, O as PAYMENT_EVENT_TYPES, P as isPaymentFailedEvent, R as safeValidateEmailReceivedEvent, S as PRIMITIVE_CONFIRMED_HEADER, T as verifyWebhookSignature, _ as STANDARD_WEBHOOK_TIMESTAMP_HEADER, a as getEventHeader, b as LEGACY_CONFIRMED_HEADER, c as isDownloadExpired, d as receive, f as verifyRawEmailDownload, g as STANDARD_WEBHOOK_SIGNATURE_HEADER, h as STANDARD_WEBHOOK_ID_HEADER, i as getDownloadTimeRemaining, j as isInteractionX402Event, k as WEBHOOK_EVENT_TYPES, l as isRawIncluded, m as emailReceivedEventJsonSchema, n as confirmedHeaders, o as handleWebhook, p as WEBHOOK_VERSION, r as decodeRawEmail, s as handleWebhookEvent, t as WEBHOOK_EVENT_HEADER, u as parseWebhookEvent, v as signStandardWebhooksPayload, w as signWebhookPayload, x as LEGACY_SIGNATURE_HEADER, y as verifyStandardWebhooksSignature, z as validateEmailReceivedEvent } from "./webhook-BtyuJtUF.js";
 import { X402Client, X402Error, buildPayoutRegistrationMessage, createX402Client, deriveEip3009Nonce, parseEmailChallengeFromPart } from "./x402/index.js";
 //#region src/index.ts
 const primitive = {

package/dist/interactions/index.d.ts

@@ -0,0 +1,132 @@
+import { i as InteractionEnvelope } from "../sign-m3ZStnNw.js";
+
+//#region src/interactions/classify.d.ts
+interface SignalContentPart {
+  filename: string | null;
+  contentType: string | null;
+}
+type SignalContentInventory = {
+  status: "complete";
+  parts: readonly SignalContentPart[];
+} | {
+  status: "unavailable";
+};
+type SignalContentBodies = {
+  status: "complete";
+  text: string | null;
+  html: string | null;
+} | {
+  status: "unavailable";
+};
+interface SignalContentInput {
+  /** Complete means the full outer inventory, including offloaded parts. */
+  inventory: SignalContentInventory;
+  bodies: SignalContentBodies;
+  /** Decoded bytes for the unique canonical part, never base64 text. */
+  canonicalPartBytes: Uint8Array | null;
+}
+type SignalContentReason = "inventory_unavailable" | "no_canonical_part" | "duplicate_canonical_parts" | "additional_parts" | "part_unavailable" | "invalid_interaction" | "unsupported_signal" | "unsupported_content_type" | "bodies_unavailable" | "html_present" | "text_mismatch" | "informational_signal";
+interface SignalContentResult {
+  classification: "plain" | "informational_only" | "mixed_or_unsupported" | "unavailable";
+  reason: SignalContentReason;
+  /** Syntax/source evidence only. Never authentication or an interpreted receipt. */
+  interaction?: InteractionParseResult;
+}
+/** Pure content classification. It establishes no sender, receipt or task authority. */
+declare function classifySignalContent(input: SignalContentInput): SignalContentResult;
+//#endregion
+//#region src/interactions/signals.d.ts
+/** Explicit preparation of optional email signals. This module never sends automatically. */
+interface SignalParent {
+  accountScope: string;
+  /** Authenticated original sender, as a bare mailbox. */
+  from: string;
+  /** Explicit authorized recipient identity to send from, as a bare mailbox. */
+  to: string;
+  messageId: string | null;
+  subject: string | null;
+  references: readonly string[];
+}
+type SignalInput = {
+  parent: SignalParent;
+} & ({
+  kind: "ack";
+  status: "received" | "will_process" | "will_not_process";
+  note?: string;
+} | {
+  kind: "read";
+} | {
+  kind: "working";
+  expiresAtMs: number;
+});
+interface SignalDependencies {
+  uuid: () => string;
+  /** Unix time in integer milliseconds. */
+  now: () => number;
+}
+/** Persist this whole value before dispatch. requestJson fixes the ordinary send body. */
+interface PreparedSignal {
+  readonly accountScope: string;
+  readonly preparedAtMs: number;
+  readonly expiresAtMs: number | null;
+  readonly idempotencyKey: string;
+  readonly requestJson: string;
+}
+type SignalPreparation = {
+  status: "waiting_on_parent";
+} | {
+  status: "prepared";
+  prepared: PreparedSignal;
+};
+interface SignalSendBody {
+  from: string;
+  to: string;
+  subject: string;
+  body_text: string;
+  in_reply_to: string;
+  references: string[];
+  attachments: {
+    filename: string;
+    content_type: string;
+    content_base64: string;
+  }[];
+}
+type SignalSendResult<T> = {
+  status: "response";
+  result: T;
+} | {
+  status: "expired";
+  idempotencyKey: string;
+};
+declare function prepareSignalEmail(input: SignalInput, dependencies: SignalDependencies): SignalPreparation;
+/** One ordinary send attempt; the caller owns persistence, reconciliation and retries. */
+declare function sendPreparedSignal<T>(sendMail: (body: SignalSendBody, idempotencyKey: string) => Promise<T>, prepared: PreparedSignal, options: {
+  accountScope: string;
+  now: () => number;
+}): Promise<SignalSendResult<T>>;
+//#endregion
+//#region src/interactions/index.d.ts
+declare const MAX_INTERACTION_BYTES = 65536;
+declare const MAX_INTERACTION_DEPTH = 64;
+type InteractionValidationResult = {
+  status: "valid";
+  envelope: InteractionEnvelope & Record<string, unknown>;
+} | {
+  status: "unsupported";
+  version: number;
+} | {
+  status: "invalid";
+  reason: "invalid_input" | "too_large" | "invalid_json" | "invalid_envelope";
+};
+type InteractionParseResult = InteractionValidationResult & {
+  /** Present on valid/unsupported input. Bytes are a defensive copy, never reserialized. */source?: {
+    text: string;
+    bytes?: Uint8Array;
+  };
+};
+/** Parse at most 64 KiB of strict UTF-8 JSON. Unknown protocols remain valid. */
+declare function parseInteractionEnvelope(input: string | Uint8Array): InteractionParseResult;
+/** Validate a decoded JSON value. Cannot detect lost duplicate keys or original bytes. */
+declare function validateInteractionEnvelope(input: unknown): InteractionValidationResult;
+//#endregion
+export { type InteractionEnvelope, InteractionParseResult, InteractionValidationResult, MAX_INTERACTION_BYTES, MAX_INTERACTION_DEPTH, type PreparedSignal, type SignalContentBodies, type SignalContentInput, type SignalContentInventory, type SignalContentPart, type SignalContentReason, type SignalContentResult, type SignalDependencies, type SignalInput, type SignalParent, type SignalPreparation, type SignalSendBody, type SignalSendResult, classifySignalContent, parseInteractionEnvelope, prepareSignalEmail, sendPreparedSignal, validateInteractionEnvelope };