@aglyn/plugins-workflows 1.0.0-beta.222 → 1.0.0-beta.224

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aglyn/plugins-workflows",
-  "version": "1.0.0-beta.222",
+  "version": "1.0.0-beta.224",
   "license": "Apache-2.0",
   "homepage": "https://aglyn.com",
   "repository": {
@@ -25,17 +25,17 @@
     "./package.json": "./package.json"
   },
   "dependencies": {
-    "@aglyn/aglyn": "1.0.0-beta.222",
-    "@aglyn/shared-data-mdi": "1.0.0-beta.222",
-    "@aglyn/shared-ui-jsx": "1.0.0-beta.222",
-    "@aglyn/shared-ui-next": "1.0.0-beta.222",
-    "@aglyn/shared-ui-snackstack": "1.0.0-beta.222",
-    "@aglyn/shared-util-email": "1.0.0-beta.222",
-    "@aglyn/shared-util-http": "1.0.0-beta.222",
-    "@aglyn/shared-util-timestamp": "1.0.0-beta.222",
-    "@aglyn/tenant-data-admin": "1.0.0-beta.222",
-    "@aglyn/tenant-feature-instance": "1.0.0-beta.222",
-    "@aglyn/tenant-runtime": "1.0.0-beta.222",
+    "@aglyn/aglyn": "1.0.0-beta.224",
+    "@aglyn/shared-data-mdi": "1.0.0-beta.224",
+    "@aglyn/shared-ui-jsx": "1.0.0-beta.224",
+    "@aglyn/shared-ui-next": "1.0.0-beta.224",
+    "@aglyn/shared-ui-snackstack": "1.0.0-beta.224",
+    "@aglyn/shared-util-email": "1.0.0-beta.224",
+    "@aglyn/shared-util-http": "1.0.0-beta.224",
+    "@aglyn/shared-util-timestamp": "1.0.0-beta.224",
+    "@aglyn/tenant-data-admin": "1.0.0-beta.224",
+    "@aglyn/tenant-feature-instance": "1.0.0-beta.224",
+    "@aglyn/tenant-runtime": "1.0.0-beta.224",
     "@swc/helpers": "0.5.23"
   },
   "peerDependencies": {

package/src/lib/components/automation-step-fields.component.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { HostActionStep, HostActionStepType } from '../model/host-actions';
+import { type HostActionStep, type HostActionStepType } from '../model/host-actions';
 /**
  * What a field holding a placeholder shows: an error state and what to do
  * about it. A placeholder is a value a person still has to supply, written in
@@ -52,9 +52,23 @@ export interface AutomationStepFieldsProps {
      * step and a function call is not one.
      */
     fields?: ReactNode;
+    /**
+     * Where the step sits (AGL-3458): the automation's trigger event and
+     * whether a wait comes before it — what decides whether a `sendEmail` step
+     * can be a transactional reply. Absent, the email step shows no switch.
+     */
+    replyContext?: {
+        event: string | null | undefined;
+        afterWait: boolean;
+    };
 }
+/**
+ * What the email step says about its merge tags (AGL-3458): both spellings
+ * the run fills, from the contact or the lead the event is about.
+ */
+export declare const SEND_EMAIL_MERGE_HELP: string;
 /**
  * One step's row: its number, what it does, the fields that kind takes, and
  * the condition that gates it.
  */
-export declare function AutomationStepFields({ step, index, kind, kinds, stepForKind, pickers, onSteps, fields, }: AutomationStepFieldsProps): import("react").JSX.Element;
+export declare function AutomationStepFields({ step, index, kind, kinds, stepForKind, pickers, onSteps, fields, replyContext, }: AutomationStepFieldsProps): import("react").JSX.Element;

package/src/lib/components/automation-step-fields.component.js

@@ -31,7 +31,8 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  * allowed, and what a kind the Actions vocabulary does not hold looks like —
  * a workflow's function call, handed in as `fields`.
  */ import { CONTACT_LIFECYCLE_STAGE_LABELS, CONTACT_LIFECYCLE_STAGES, CONTACT_TAG_MAX_LENGTH, CRM_ACTIVITY_DIRECTION_LABELS, CRM_ACTIVITY_DIRECTIONS, CRM_ACTIVITY_KIND_LABELS, CRM_ACTIVITY_KINDS, CRM_TASK_KIND_LABELS, CRM_TASK_KINDS, CRM_TASK_MAX_DUE_DAYS, HOST_EVENT_TYPES, hostEventLabel, isInteractionAttributeAllowed } from "@aglyn/aglyn";
-import { IconButton, MenuItem, Stack, TextField, Typography } from "@mui/material";
+import { FormControlLabel, FormHelperText, IconButton, MenuItem, Stack, Switch, TextField, Typography } from "@mui/material";
+import { SEND_EMAIL_REPLY_INELIGIBLE_REASONS, sendEmailIsTransactionalReply, sendEmailReplyIneligibility } from "../model/host-actions.js";
 import { draftPlaceholderIn } from "@aglyn/aglyn/app-utils/draft-placeholders";
 /** A task's priorities, by meaning, as the create-task step offers them (AGL-3517). */ const TASK_PRIORITY_OPTIONS = [
     {
@@ -338,10 +339,50 @@ export function defaultStep(type) {
             };
     }
 }
+/**
+ * The email step's TRANSACTIONAL REPLY switch (AGL-3458) — visible on every
+ * email step, so which kind of message it sends is never a guess.
+ *
+ * On by default for a step that qualifies: the trigger is the recipient's own
+ * form submission, booking or sign-up, nothing waits before the step, and it
+ * goes to the address the event carries. Such a reply leaves with no
+ * unsubscribe header and no unsubscribe link. A step that does not qualify
+ * shows the switch off and disabled, saying why, because it is a mailing and
+ * keeps its unsubscribe whatever it says.
+ */ function SendEmailReplySwitch({ step, context, onChange }) {
+    const ineligible = sendEmailReplyIneligibility(step, context);
+    const on = sendEmailIsTransactionalReply(step, context);
+    return /*#__PURE__*/ _jsxs(Stack, {
+        sx: {
+            pl: 3
+        },
+        children: [
+            /*#__PURE__*/ _jsx(FormControlLabel, {
+                control: /*#__PURE__*/ _jsx(Switch, {
+                    size: "small",
+                    checked: on,
+                    disabled: ineligible !== null,
+                    onChange: (event)=>onChange(event.target.checked)
+                }),
+                label: "Transactional reply (no unsubscribe)"
+            }),
+            /*#__PURE__*/ _jsx(FormHelperText, {
+                sx: {
+                    mt: 0
+                },
+                children: ineligible ? `Sent as a mailing with an unsubscribe link: ${SEND_EMAIL_REPLY_INELIGIBLE_REASONS[ineligible]}.` : on ? 'Answers what this person just did, so it goes without an unsubscribe ' + 'link or header. Bounced, complaining and unsubscribed addresses are still skipped.' : 'Sent as a mailing, with an unsubscribe link and header.'
+            })
+        ]
+    });
+}
+/**
+ * What the email step says about its merge tags (AGL-3458): both spellings
+ * the run fills, from the contact or the lead the event is about.
+ */ export const SEND_EMAIL_MERGE_HELP = 'Merge tags: {{firstName|there}}, {{name}}, {{email}}, or {{contact.firstName}}, ' + '{{lead.company}}, {{site.name}} — filled from the contact or lead the event is ' + 'about; the text after | is used when there is no value.';
 /**
  * One step's row: its number, what it does, the fields that kind takes, and
  * the condition that gates it.
- */ export function AutomationStepFields({ step, index, kind, kinds, stepForKind, pickers, onSteps, fields }) {
+ */ export function AutomationStepFields({ step, index, kind, kinds, stepForKind, pickers, onSteps, fields, replyContext }) {
     var _ref, _step_workflowId, _step_severity, _ref1, _step_webhookId, _ref2, _step_datasetId, _step_overlayId, _step_selector, _step_selector1, _step_className, _step_selector2, _step_selector3, _step_offsetPx, _step_selector4, _step_name, _step_value, _step_drawerNodeId, _step_menuNodeId, _step_html, _step_code, _step_url, _step_eventName, _step_subject, _step_body, _step_title, _step_listId, _step_campaignId, _step_lifecycleStage, _step_tag, _step_title1, _step_kind, _step_priority, _step_dueInDays, _step_kind1, _step_direction, _CRM_ACTIVITY_DIRECTIONS_step_kind, _step_body1, _step_eventName1, _step_timeoutMinutes, _step_delayMinutes, _ref3, _step_when_conditions__field, _step_when_conditions__value;
     var _workflowOptions_find, _webhookOptions_find, _datasetOptions_find, _CRM_ACTIVITY_DIRECTIONS_step_kind1, _step_when_conditions_, _step_when_conditions, _step_when, _step_when_conditions_1, _step_when_conditions1, _step_when1, _step_when_conditions_2, _step_when_conditions2, _step_when2, _step_when_conditions_3, _step_when_conditions3, _step_when3;
     const { workflowOptions, datasetOptions, overlayOptions, listOptions, campaignOptions, webhookOptions } = pickers;
@@ -789,6 +830,7 @@ export function defaultStep(type) {
                                 size: "small",
                                 multiline: true,
                                 maxRows: 3,
+                                helperText: SEND_EMAIL_MERGE_HELP,
                                 sx: {
                                     flex: 1
                                 }
@@ -1186,6 +1228,15 @@ export function defaultStep(type) {
                     })
                 ]
             }),
+            !fields && step.type === 'sendEmail' && replyContext ? /*#__PURE__*/ _jsx(SendEmailReplySwitch, {
+                step: step,
+                context: replyContext,
+                onChange: (transactional)=>patch((previous)=>_extends({}, previous, {
+                            steps: previous.steps.map((s, index2)=>index2 === index ? _extends({}, s, {
+                                    transactional
+                                }) : s)
+                        }))
+            }) : null,
             fields ? null : /*#__PURE__*/ _jsxs(Stack, {
                 direction: "row",
                 spacing: 1,