using System.Text.Json;

namespace GB5Shared.ActionProcessor
{
    /// <summary>
    /// Message payload published to and consumed from RabbitMQ action-exec-p{n} queues.
    /// ActionRunId maps to TEVENTACTIONRUN.ACTIONRUNID (app-generated INT).
    /// ActionType: 0=Email, 1=SMS, 2=Webhook, 3=Notification, 4=Report
    /// </summary>
    public class ActionEventDto
    {
        public int ActionRunId { get; set; }
        public int ActionId { get; set; }
        public int ActionType { get; set; }
        public int TenantId { get; set; }

        /// <summary>
        /// The tenant's real, physical database name (MSERVERCONFIG.DATABASENAME) — for
        /// display/logging/business-context purposes only. NOT usable for DB connection
        /// resolution — <see cref="ApplicationConnection"/> looks up connection strings by
        /// CONNECTIONNAME, not DATABASENAME. Use <see cref="ConnectionName"/> for that.
        /// </summary>
        public string DatabaseName { get; set; } = string.Empty;

        /// <summary>
        /// MSERVERCONFIG.CONNECTIONNAME — an arbitrary per-tenant alias (can differ from
        /// DatabaseName) that GB5Shared.Connection.ApplicationConnection actually keys its
        /// connection-string lookup on. Required for any fresh LoginDTO this action's
        /// handler needs to build for its own DB access (e.g. IWebhookEndpointResolver).
        /// </summary>
        public string ConnectionName { get; set; } = string.Empty;

        /// <summary>
        /// TJOBEXECUTION.JOBEXECUTIONID this action belongs to. 0 when the action was not
        /// generated from a scheduler run (e.g. workflow/event-driven actions) — consumers
        /// must skip TJOBEXECUTION finalization when this is &lt;= 0.
        /// </summary>
        public int JobExecutionId { get; set; }

        // ── Email / SMS ──────────────────────────────────────────────
        public string? SendTo { get; set; }
        /// <summary>3=direct email, 2=field name in payload, 1=mail list, 12=EnrichQualifier (SENDTO = QueryCode)</summary>
        public int ToDeliveryType { get; set; }
        /// <summary>0=Direct, 1=Employee, 2=Party, 3=User, 4=Contact, 5=UserGroup, 6=Role. Used when DeliveryType=2.</summary>
        public int ToContentType { get; set; }
        public int TemplateId { get; set; }
        public string? MailCc { get; set; }
        /// <summary>3=direct email, 2=field name in payload, 1=mail list, 12=EnrichQualifier</summary>
        public int MailCcDeliveryType { get; set; }
        public string? MailBcc { get; set; }
        /// <summary>3=direct email, 2=field name in payload, 1=mail list, 12=EnrichQualifier</summary>
        public int MailBccDeliveryType { get; set; }
        public string? ReplyTo { get; set; }

        // ── Webhook ──────────────────────────────────────────────────
        public int WebServiceId { get; set; }
        public string? UriParameterValue { get; set; }

        // ── Report ───────────────────────────────────────────────────
        public int ReportId { get; set; }

        // ── Attachment (generic — used by Email today; benefits any future action type) ──
        /// <summary>
        /// Optional TATTACHMENT.ATTACHMENTID to attach to the outbound message. Added for
        /// Correspondence (Phase 2 — CorrespondenceActionHandler sets this to
        /// TCORRESPONDENCE.GENERATEDATTACHMENTID) but deliberately generic: any ActionType /
        /// MACTION-configured action can populate it and EmailActionHandler will attach it,
        /// platform-wide, not just for Correspondence sends.
        /// </summary>
        public int? AttachmentId { get; set; }

        // ── Tracing ──────────────────────────────────────────────────
        public string CorrelationKey { get; set; } = string.Empty;

        /// <summary>
        /// W3C traceparent of the span active when this DTO was built (e.g. EventSubBLL's
        /// Dapr-subscribe span, or SchedulerActionGeneratorBLL's caller). Carried in the
        /// message body itself — same pattern as OutboxEventMessage.TraceParent — so
        /// ActionProcessorWorker.OnActionExecAsync can reconstruct the parent
        /// ActivityContext and keep the whole dispatch chain (Quartz fire -> ... -> Dapr
        /// publish/subscribe -> TACTIONOUTBOX -> RabbitMQ -> this handler -> actual send)
        /// under one trace, regardless of Dapr/RabbitMQ broker metadata propagation.
        /// </summary>
        public string? TraceParent { get; set; }

        /// <summary>W3C tracestate accompanying <see cref="TraceParent"/>, if any.</summary>
        public string? TraceState { get; set; }

        // ── Enriched handler input ───────────────────────────────────
        public JsonElement Payload { get; set; }

        // ── Workflow approval buttons (email action links) ────────────
        /// <summary>When true, the email handler renders Approve/Reject/Return links using WorkflowTaskId and ApprovalBaseUrl.</summary>
        public bool IncludeApprovalActions { get; set; }

        /// <summary>TWORKFLOWTASK.WORKFLOWTASKID — embedded in the signed token for email-link approval.</summary>
        public int WorkflowTaskId { get; set; }

        /// <summary>Base URL of the framework service (e.g. https://api.example.com) used to construct /Action/Execute links.</summary>
        public string? ApprovalBaseUrl { get; set; }

        // ── Generalized direct action buttons ────────────────────────
        /// <summary>FK to MDIRECTACTION header. -1 = no action buttons (one-way notification).</summary>
        public int DirectActionId { get; set; } = -1;

        /// <summary>Context PK extracted from the entity payload via MDIRECTACTION.CONTEXTIDFIELD (e.g. WorkflowTaskId).</summary>
        public int ContextId { get; set; }

        /// <summary>Assignee user ID extracted from the entity payload via MDIRECTACTION.ASSIGNEEUSERIDFIELD.</summary>
        public int AssigneeUserId { get; set; } = -1;

        /// <summary>
        /// Pipeline context JSON forwarded from <see cref="GB5Shared.DTO.PubSub.OutboxEventMessage.ContextJson"/>.
        /// Contains EntityId, ObjectId, EventTypeId, caller Facts, and every DB_ENRICH bag value
        /// written by qualifier rules (e.g. MailId, ReportingToEmployeeId, DepartmentId, WorkflowInfo).
        /// <para>
        /// Handlers use this to resolve configured field names (e.g. MACTION.SENDTO = "MailId")
        /// against the enriched bag when the field is absent from the entity DTO payload.
        /// </para>
        /// Null/empty when the event arrived via the outbox background-retry path.
        /// </summary>
        public string? ContextJson { get; set; }
    }
}