@marlinjai/mail-contract 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -9139,6 +9139,15 @@ declare function previewInsertions(main: Insertions, translation: TranslationIns
  * as the preview showed it before insertions: it is filled per recipient.
  */
 declare function previewPersonalization(insertions: Insertions, picks: Readonly<Record<string, string>>): Personalization;
+/**
+ * The insertions a refused save names that the editor's drafts do not have:
+ * added in a version somebody else saved meanwhile, after the person chose to
+ * save theirs over it. Their texts cannot be written in that editor, so the
+ * way forward is loading that version, or setting the language back to draft.
+ * Read off `details.missing` (a ready language's missing texts) and the
+ * issues' paths; empty for any refusal that is not about an insertion.
+ */
+declare function unknownRefusedInsertions(details: Readonly<Record<string, unknown>> | null | undefined, drafts: LanguageDrafts): string[];
 /** What to do about a save refused for an insertion, from the error's `details`; null for any other refusal. */
 declare function insertionRefusalHint(details: Readonly<Record<string, unknown>> | undefined | null): string | null;
 /** One text that places a renamed insertion: which language (null is the main one), which part, how many times. */
@@ -105275,4 +105284,4 @@ declare function matchRoute(method: HttpMethod, pathname: string): {
     params: Record<string, string>;
 } | null;
 
-export { AB_TEST_STATUSES, AB_WINNER_METRICS, API_KEY_SCOPES, API_VERSION_PREFIX, ASSET_CONTENT_TYPES, ASSET_POLICIES, ASSET_UPLOAD_FIELD, AUDIT_ACTIONS, AUTHORIZATION_HEADER, AUTOMATION_DATE_TRIGGER_KINDS, AUTOMATION_END_REASONS, AUTOMATION_ENTRY_REFUSALS, AUTOMATION_FILTER_FIELD_OPERATORS, AUTOMATION_FILTER_FIELD_PATTERN, AUTOMATION_ISSUE_CODES, AUTOMATION_STATUSES, AUTOMATION_STEP_KINDS, AUTOMATION_TRIGGER_KINDS, AUTOMATION_WAIT_REASONS, AbTestConfig, AbTestState, AbVariant, AbWinnerRequest, ApiKey, ApiKeyCreate, ApiKeyCreated, ApiKeyScope, Asset, AssetContentType, AssetHost, AssetImport, AssetPolicy, AuditAction, AuditActor, AuditEntry, AuditQuery, Automation, AutomationCounts, AutomationCreate, type AutomationDateTriggerKind, AutomationDuplicateRequest, AutomationEndReason, AutomationEnrollRequest, AutomationEnrollResult, AutomationEnrollment, AutomationEntryRefusal, AutomationExitRunRequest, AutomationFilter, AutomationFilterCondition, AutomationFilterField, AutomationFlow, AutomationIssue, AutomationIssueCode, AutomationJourney, AutomationListQuery, AutomationPublishMove, AutomationPublishRequest, AutomationPublishResult, AutomationReport, AutomationRun, AutomationRunCompletedData, AutomationRunExitedData, AutomationRunFailedData, AutomationRunListQuery, AutomationRunParams, AutomationRunStartedData, AutomationRunStatus, AutomationSettings, AutomationStatus, AutomationStep, AutomationStepExecution, AutomationStepKind, AutomationStepParams, AutomationStepReport, AutomationSummary, AutomationTestEmailRequest, AutomationTrigger, AutomationTriggerKind, AutomationUpdate, AutomationValidateRequest, AutomationValidation, AutomationWaitReason, AutomationWebhookData, AutomationWithFlow, BEARER_PREFIX, BILLING_NOT_CONFIGURED_REASON, BoundedAutomationFilter, BoundedSegmentFilter, CONTACT_PROPERTY_TYPES, CatalogPlan, CheckoutRequest, CheckoutSession, CompanyId, CompileMessage, CompileRequest, CompileResult, ConditionStep, Contact, ContactAutomationListQuery, ContactAutomationRun, ContactBouncedData, ContactErased, ContactListQuery, ContactPropertyDefinition, ContactPropertyKey, ContactPropertyParams, ContactPropertyType, ContactResubscribedData, ContactSubscribedData, ContactTaggedData, ContactUnsubscribedData, ContactUpdatedData, ContactUpsert, ContactUpsertResult, DATE_PASSED_ANSWERS, DEFAULT_INVITE_TTL_DAYS, DEFAULT_PAGE_LIMIT, DOCUMENT_SCHEMA_VERSIONS, DateOnly, DatePassedAnswer, DelayStep, DocumentSchemaVersion, type DraftInsertionProblem, EDITABLE_MAILING_STATUSES, ERROR_CODES, ERROR_STATUS, EXPORT_CONTENT_TYPES, EXPORT_FORMATS, EXPORT_WARNINGS_HEADER, EXPORT_WARNING_COUNT_HEADER, type EditableLanguage, Email, EmailStep, EmailStepLanguage, ErrorBody, type ErrorCode, ErrorCodeSchema, Event, EventCreate, EventListQuery, EventName, ExportFormat, FILTER_FIELD_OPERATORS, FILTER_OPERATORS, FilterCondition, FilterField, type FilterLeafProblem, FilterOperator, GotoStep, HEALTH_PATH, HOSTED_PAGE_LOCALES, type HttpMethod, ICLOUD_SMTP_POLICY, IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_KEY_MAX_LENGTH, IDEMPOTENCY_KEY_RETENTION_HOURS, IMPORT_FILE_FIELD, IMPORT_ROW_OUTCOMES, IMPORT_SKIP_REASONS, IMPORT_STATUSES, IMPORT_TERMINAL_STATUSES, INSERTION_PROBLEM_REASONS, INSERTION_TEXT_SLOTS, INVITE_REFUSAL_REASONS, INVITE_STATUSES, Id, IdParams, ImportColumnMapping, ImportCommitRequest, ImportFinishedData, ImportJob, ImportMappingRequest, ImportReport, ImportRow, ImportRowListQuery, ImportRowOutcome, ImportSkipReason, ImportStatus, ImportWarning, ImportedAsset, Insertion, InsertionChoice, InsertionChoiceKey, type InsertionChoiceMade, InsertionChoices, type InsertionEdit, InsertionName, type InsertionProblem, type InsertionProblemReason, InsertionText, Insertions, Invite, InviteAccept, InviteAccepted, InviteCreate, InviteCreated, InviteListQuery, type InviteRefusalReason, InviteStatus, JsonValue, LETTER_RECIPIENT_REFUSAL, LIST_UNSUBSCRIBE_POST_VALUE, LOCALE_TAG_PATTERN, type LanguageDrafts, type LanguageTab, LocaleTag, MAILING_ACTIONS, MAILING_KINDS, MAILING_STATUSES, MAILING_TRANSITIONS, MAX_ALLOWED_ASSET_HOSTS, MAX_ASSET_BYTES, MAX_DELAY_SECONDS, MAX_DOCUMENT_BYTES, MAX_ENGAGEMENT_DAYS, MAX_EXPORT_WARNINGS_HEADER_LENGTH, MAX_FILTER_DEPTH, MAX_IMPORTED_REMOTE_IMAGES, MAX_IMPORT_BYTES, MAX_IMPORT_ROWS, MAX_IMPORT_URL_LENGTH, MAX_INSERTIONS, MAX_INSERTION_CHOICES, MAX_INSERTION_TEXT_LENGTH, MAX_INVITE_TTL_DAYS, MAX_IN_LIST, MAX_LETTER_RECIPIENTS, MAX_MERGE_DEFAULTS, MAX_MERGE_DEFAULT_LENGTH, MAX_MJML_DEPTH, MAX_MJML_ELEMENTS, MAX_MJML_IMPORT_BYTES, MAX_PAGE_LIMIT, MAX_PREHEADER_LENGTH, MAX_RECIPIENTS_PER_BATCH, MAX_RE_ENTRY_COOLDOWN_SECONDS, MAX_SAVED_SECTIONS, MAX_SPLIT_BRANCHES, MAX_STEPS, MAX_STEP_VISITS, MAX_SUBJECT_LENGTH, MAX_TEMPLATE_INPUTS, MAX_TEMPLATE_INPUTS_APP_LENGTH, MAX_TEMPLATE_INPUTS_SEEN, MAX_TEMPLATE_INPUT_EXAMPLE_LENGTH, MAX_TEMPLATE_INPUT_LABEL_LENGTH, MAX_TEMPLATE_INPUT_NOTE_LENGTH, MAX_TEMPLATE_INPUT_VALUES, MAX_TEMPLATE_TRANSLATIONS, MAX_TRIGGERS, MEMBER_ROLES, MERGE_FIELD_PATTERN, MESSAGE_OUTCOMES, MIN_SPLIT_BRANCHES, MJML_IMPORT_REFUSALS, Mailing, MailingAbWinnerSelectedData, MailingAction, MailingActionRequest, MailingAnalytics, MailingAudienceFromSegment, MailingCounts, MailingCreate, MailingExportQuery, MailingFinishedData, MailingKind, MailingLanguage, MailingLanguageReport, MailingLanguageStatus, MailingListQuery, MailingMetadata, MailingRetryFailedRequest, MailingScheduleFailedData, MailingScheduleRequest, MailingScheduledData, MailingSendRequest, MailingStartedData, MailingStatus, MailingSummary, MailingTestRequest, MailingTestResult, MailingUpdate, Member, MemberCreate, MemberRole, MemberUpdate, MergeDefaultValue, MergeDefaults, MergeFieldName, type MergeFieldUse, type MergeValue, Message, MessageFailedData, MessageListQuery, MessageOutcome, MessageSentData, MessageSummary, type MissingInsertionText, type MjmlImportRefusal, NotifyRecipients, NotifyStep, ON_BEHALF_OF_HEADER, ON_BEHALF_OF_MAX_LENGTH, OffsetDays, Ok, type OperationId, PLAN_FEATURES, PLAN_IDS, PREVIEW_EMPTY, PREVIEW_FILLED, PROVIDER_KINDS, type Page, PageQuery, type Personalization, type Phase, Plan, type PlanFeature, PlanFeatures, PlanId, PlanLimits, PortalRequest, PortalSession, type PreviewControl, Properties, Provider, ProviderCreate, ProviderEvents, ProviderEventsSecret, ProviderKind, ProviderPolicy, ProviderRejections, ProviderUpdate, ProviderUsage, ProviderVerifyResult, QuietHours, RECIPIENT_REJECTIONS, RECIPIENT_STATUSES, REQUEST_ID_HEADER, RESEND_EVENT_TYPES, RESERVED_MERGE_FIELDS, RETRYABLE_ERRORS, RETRY_AFTER_HEADER, RE_ENTRY_MODES, ReEntryMode, Recipient, RecipientBatch, RecipientBatchResult, RecipientInput, RecipientListQuery, RecipientStatus, RemoteImage, type RenamedPlacement, ResendSigningSecret, type ReservedMergeField, type RouteAccess, type RouteBody, type RouteDef, type RouteParams, type RouteQuery, type RouteResponse, type Routes, SERVICE_FILLED_MERGE_FIELDS, SIGNUP_FORM_FIELDS, SKIP_REASONS, SMTP_SECURITY, SUBJECT_HEADER, SUPPRESSION_REASONS, type SaveDemotion, SavedSection, SavedSectionBody, SavedSectionCreate, SavedSectionUpdate, Segment, SegmentCreate, SegmentFilter, SegmentPreview, SegmentPreviewRequest, SignupForm, SignupFormCreate, SignupFormEmbed, SignupFormTranslation, SignupSubmission, SkipReason, Slug, SplitBranchKey, SplitStep, StepId, type StepTarget, Subscription, Suppression, SuppressionCreate, SuppressionListQuery, SuppressionReason, TEMPLATE_INPUT_KINDS, TEMPLATE_INPUT_PROBLEM_REASONS, TEMPLATE_LANGUAGE_STATUSES, TERMINAL_MAILING_STATUSES, Tag, TagAssignment, TagCreate, Template, TemplateCompileRequest, TemplateCreate, TemplateCreatedData, TemplateDeletedData, TemplateDocument, TemplateExportQuery, TemplateImport, TemplateImportPreview, TemplateImportPreviewRequest, TemplateImportResult, TemplateInput, type TemplateInputKind, TemplateInputMap, TemplateInputName, type TemplateInputProblem, type TemplateInputProblemReason, TemplateInputSeen, TemplateInputSource, TemplateInputValue, TemplateInputs, TemplateInputsDeclaration, TemplateInputsDeclared, TemplateInputsSeen, TemplateLanguageStatus, TemplateListQuery, TemplatePreheader, TemplateSubject, TemplateSummary, TemplateTranslation, TemplateTranslations, TemplateUpdate, TemplateUpdatedData, TemplateVersion, TemplateVersionParams, TimeOfDay, Timestamp, TimezoneName, Topic, TopicCreate, TopicUpdate, TrackingSettings, TranslationInsertion, TranslationInsertions, UNSUBSCRIBE_PATH_PREFIX, UNSUBSCRIBE_SOURCES, USAGE_METRICS, USAGE_WARNING_HEADER, USAGE_WARNING_RATIO, type UnsubscribeToken, type UnsubscribeTokenClaims, Usage, UsageMetric, UsageWarning, type UsageWarningHeaderEntry, type ValidationContext, ValidationIssue, VariantAnalytics, type VerifyWebhookInput, WEBHOOK_DELIVERY_STATUSES, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPES, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_RETRY_DELAYS_SECONDS, WEBHOOK_SECRET_PREFIX, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_SIGNATURE_VERSION, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, WORKSPACE_HEADER, WebhookDelivery, WebhookDeliveryListQuery, WebhookDeliveryParams, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointCreate, WebhookEndpointUpdate, WebhookEndpointWithSecret, WebhookEvent, type WebhookEventOf, WebhookEventType, WebhookStep, WebhookUrl, type WebhookVerifyFailure, type WebhookVerifyResult, Weekday, Workspace, WorkspaceCreate, WorkspaceMembership, WorkspaceMove, WorkspaceSettings, WorkspaceUpdate, acceptsIdempotencyKey, addInsertion, addInsertionChoice, addLanguageDraft, alignTranslationInsertions, alwaysWaits, automationFilterFamily, automationRoutes, billingRoutes, buildPath, buildTemplatePatch, canTransition, canonicalLocale, choiceKeyProblem, chooseInsertion, cycles, defaultPreviewPick, defaultSettings, demoteForSave, demotedBySave, describeMissingTexts, draftDocument, draftInsertionProblems, draftsDirty, draftsFromTemplate, draftsPatch, editInsertionText, editLanguageDraft, editMainInsertionText, editMainInsertions, effectivePreviewPicks, emptyFlow, errorBody, escapeMergeHtml, exportFilename, filterConditions, filterDepth, filterFieldFamily, filterLeafProblem, findMergeFields, formatExportWarningsHeader, formatUsageWarningHeader, foundationRoutes, insertionByProblem, insertionChoices, insertionCoverage, insertionInputs, insertionNameProblem, insertionProblems, insertionRefusalHint, insertionSlotLabel, insertionTextSlots, insertionTokens, insertionValue, inviteRoutes, isDayEntirelyPast, isPublishable, isRetryableError, keepLanguageDocument, languageInsertions, languageName, languageTabs, mainInsertionText, matchLocale, matchRoute, missingInsertionTexts, missingRequiredMergeFields, normalizeChoiceKey, nowSeconds, operationsWithAccess, ownEntry, page, parseExportWarningsHeader, parseUsageWarningHeader, personalizeHtml, personalizeText, placementProblems, platformRoutes, previewControls, previewInsertions, previewPersonalization, primaryLanguage, reachable, readyWithoutInsertions, readyWithoutSubject, rebaseDrafts, removeInsertion, removeInsertionChoice, removeLanguageDraft, renameInsertion, renameInsertionChecked, renameInsertionChoice, renameInsertionChoiceChecked, renameInsertionEverywhere, renameInsertionPlacements, renameTokenInDocument, renameTokenInText, resolveInsertions, restorePatch, routes, sameJson, sampleMergeValue, saveDemotions, sendingRoutes, setInsertionBy, setInsertionFilled, setLanguageStatus, signWebhook, statusForError, stepTargets, storedTemplateLine, stronglyConnected, templateInputDrift, templateInputProblems, templateRoutes, testGroupSize, tightLoops, timingSafeEqualString, translationInsertionProblems, translationTextFromInput, triggerKey, unplacedInsertions, validateAutomation, verifyWebhook };
+export { AB_TEST_STATUSES, AB_WINNER_METRICS, API_KEY_SCOPES, API_VERSION_PREFIX, ASSET_CONTENT_TYPES, ASSET_POLICIES, ASSET_UPLOAD_FIELD, AUDIT_ACTIONS, AUTHORIZATION_HEADER, AUTOMATION_DATE_TRIGGER_KINDS, AUTOMATION_END_REASONS, AUTOMATION_ENTRY_REFUSALS, AUTOMATION_FILTER_FIELD_OPERATORS, AUTOMATION_FILTER_FIELD_PATTERN, AUTOMATION_ISSUE_CODES, AUTOMATION_STATUSES, AUTOMATION_STEP_KINDS, AUTOMATION_TRIGGER_KINDS, AUTOMATION_WAIT_REASONS, AbTestConfig, AbTestState, AbVariant, AbWinnerRequest, ApiKey, ApiKeyCreate, ApiKeyCreated, ApiKeyScope, Asset, AssetContentType, AssetHost, AssetImport, AssetPolicy, AuditAction, AuditActor, AuditEntry, AuditQuery, Automation, AutomationCounts, AutomationCreate, type AutomationDateTriggerKind, AutomationDuplicateRequest, AutomationEndReason, AutomationEnrollRequest, AutomationEnrollResult, AutomationEnrollment, AutomationEntryRefusal, AutomationExitRunRequest, AutomationFilter, AutomationFilterCondition, AutomationFilterField, AutomationFlow, AutomationIssue, AutomationIssueCode, AutomationJourney, AutomationListQuery, AutomationPublishMove, AutomationPublishRequest, AutomationPublishResult, AutomationReport, AutomationRun, AutomationRunCompletedData, AutomationRunExitedData, AutomationRunFailedData, AutomationRunListQuery, AutomationRunParams, AutomationRunStartedData, AutomationRunStatus, AutomationSettings, AutomationStatus, AutomationStep, AutomationStepExecution, AutomationStepKind, AutomationStepParams, AutomationStepReport, AutomationSummary, AutomationTestEmailRequest, AutomationTrigger, AutomationTriggerKind, AutomationUpdate, AutomationValidateRequest, AutomationValidation, AutomationWaitReason, AutomationWebhookData, AutomationWithFlow, BEARER_PREFIX, BILLING_NOT_CONFIGURED_REASON, BoundedAutomationFilter, BoundedSegmentFilter, CONTACT_PROPERTY_TYPES, CatalogPlan, CheckoutRequest, CheckoutSession, CompanyId, CompileMessage, CompileRequest, CompileResult, ConditionStep, Contact, ContactAutomationListQuery, ContactAutomationRun, ContactBouncedData, ContactErased, ContactListQuery, ContactPropertyDefinition, ContactPropertyKey, ContactPropertyParams, ContactPropertyType, ContactResubscribedData, ContactSubscribedData, ContactTaggedData, ContactUnsubscribedData, ContactUpdatedData, ContactUpsert, ContactUpsertResult, DATE_PASSED_ANSWERS, DEFAULT_INVITE_TTL_DAYS, DEFAULT_PAGE_LIMIT, DOCUMENT_SCHEMA_VERSIONS, DateOnly, DatePassedAnswer, DelayStep, DocumentSchemaVersion, type DraftInsertionProblem, EDITABLE_MAILING_STATUSES, ERROR_CODES, ERROR_STATUS, EXPORT_CONTENT_TYPES, EXPORT_FORMATS, EXPORT_WARNINGS_HEADER, EXPORT_WARNING_COUNT_HEADER, type EditableLanguage, Email, EmailStep, EmailStepLanguage, ErrorBody, type ErrorCode, ErrorCodeSchema, Event, EventCreate, EventListQuery, EventName, ExportFormat, FILTER_FIELD_OPERATORS, FILTER_OPERATORS, FilterCondition, FilterField, type FilterLeafProblem, FilterOperator, GotoStep, HEALTH_PATH, HOSTED_PAGE_LOCALES, type HttpMethod, ICLOUD_SMTP_POLICY, IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_KEY_MAX_LENGTH, IDEMPOTENCY_KEY_RETENTION_HOURS, IMPORT_FILE_FIELD, IMPORT_ROW_OUTCOMES, IMPORT_SKIP_REASONS, IMPORT_STATUSES, IMPORT_TERMINAL_STATUSES, INSERTION_PROBLEM_REASONS, INSERTION_TEXT_SLOTS, INVITE_REFUSAL_REASONS, INVITE_STATUSES, Id, IdParams, ImportColumnMapping, ImportCommitRequest, ImportFinishedData, ImportJob, ImportMappingRequest, ImportReport, ImportRow, ImportRowListQuery, ImportRowOutcome, ImportSkipReason, ImportStatus, ImportWarning, ImportedAsset, Insertion, InsertionChoice, InsertionChoiceKey, type InsertionChoiceMade, InsertionChoices, type InsertionEdit, InsertionName, type InsertionProblem, type InsertionProblemReason, InsertionText, Insertions, Invite, InviteAccept, InviteAccepted, InviteCreate, InviteCreated, InviteListQuery, type InviteRefusalReason, InviteStatus, JsonValue, LETTER_RECIPIENT_REFUSAL, LIST_UNSUBSCRIBE_POST_VALUE, LOCALE_TAG_PATTERN, type LanguageDrafts, type LanguageTab, LocaleTag, MAILING_ACTIONS, MAILING_KINDS, MAILING_STATUSES, MAILING_TRANSITIONS, MAX_ALLOWED_ASSET_HOSTS, MAX_ASSET_BYTES, MAX_DELAY_SECONDS, MAX_DOCUMENT_BYTES, MAX_ENGAGEMENT_DAYS, MAX_EXPORT_WARNINGS_HEADER_LENGTH, MAX_FILTER_DEPTH, MAX_IMPORTED_REMOTE_IMAGES, MAX_IMPORT_BYTES, MAX_IMPORT_ROWS, MAX_IMPORT_URL_LENGTH, MAX_INSERTIONS, MAX_INSERTION_CHOICES, MAX_INSERTION_TEXT_LENGTH, MAX_INVITE_TTL_DAYS, MAX_IN_LIST, MAX_LETTER_RECIPIENTS, MAX_MERGE_DEFAULTS, MAX_MERGE_DEFAULT_LENGTH, MAX_MJML_DEPTH, MAX_MJML_ELEMENTS, MAX_MJML_IMPORT_BYTES, MAX_PAGE_LIMIT, MAX_PREHEADER_LENGTH, MAX_RECIPIENTS_PER_BATCH, MAX_RE_ENTRY_COOLDOWN_SECONDS, MAX_SAVED_SECTIONS, MAX_SPLIT_BRANCHES, MAX_STEPS, MAX_STEP_VISITS, MAX_SUBJECT_LENGTH, MAX_TEMPLATE_INPUTS, MAX_TEMPLATE_INPUTS_APP_LENGTH, MAX_TEMPLATE_INPUTS_SEEN, MAX_TEMPLATE_INPUT_EXAMPLE_LENGTH, MAX_TEMPLATE_INPUT_LABEL_LENGTH, MAX_TEMPLATE_INPUT_NOTE_LENGTH, MAX_TEMPLATE_INPUT_VALUES, MAX_TEMPLATE_TRANSLATIONS, MAX_TRIGGERS, MEMBER_ROLES, MERGE_FIELD_PATTERN, MESSAGE_OUTCOMES, MIN_SPLIT_BRANCHES, MJML_IMPORT_REFUSALS, Mailing, MailingAbWinnerSelectedData, MailingAction, MailingActionRequest, MailingAnalytics, MailingAudienceFromSegment, MailingCounts, MailingCreate, MailingExportQuery, MailingFinishedData, MailingKind, MailingLanguage, MailingLanguageReport, MailingLanguageStatus, MailingListQuery, MailingMetadata, MailingRetryFailedRequest, MailingScheduleFailedData, MailingScheduleRequest, MailingScheduledData, MailingSendRequest, MailingStartedData, MailingStatus, MailingSummary, MailingTestRequest, MailingTestResult, MailingUpdate, Member, MemberCreate, MemberRole, MemberUpdate, MergeDefaultValue, MergeDefaults, MergeFieldName, type MergeFieldUse, type MergeValue, Message, MessageFailedData, MessageListQuery, MessageOutcome, MessageSentData, MessageSummary, type MissingInsertionText, type MjmlImportRefusal, NotifyRecipients, NotifyStep, ON_BEHALF_OF_HEADER, ON_BEHALF_OF_MAX_LENGTH, OffsetDays, Ok, type OperationId, PLAN_FEATURES, PLAN_IDS, PREVIEW_EMPTY, PREVIEW_FILLED, PROVIDER_KINDS, type Page, PageQuery, type Personalization, type Phase, Plan, type PlanFeature, PlanFeatures, PlanId, PlanLimits, PortalRequest, PortalSession, type PreviewControl, Properties, Provider, ProviderCreate, ProviderEvents, ProviderEventsSecret, ProviderKind, ProviderPolicy, ProviderRejections, ProviderUpdate, ProviderUsage, ProviderVerifyResult, QuietHours, RECIPIENT_REJECTIONS, RECIPIENT_STATUSES, REQUEST_ID_HEADER, RESEND_EVENT_TYPES, RESERVED_MERGE_FIELDS, RETRYABLE_ERRORS, RETRY_AFTER_HEADER, RE_ENTRY_MODES, ReEntryMode, Recipient, RecipientBatch, RecipientBatchResult, RecipientInput, RecipientListQuery, RecipientStatus, RemoteImage, type RenamedPlacement, ResendSigningSecret, type ReservedMergeField, type RouteAccess, type RouteBody, type RouteDef, type RouteParams, type RouteQuery, type RouteResponse, type Routes, SERVICE_FILLED_MERGE_FIELDS, SIGNUP_FORM_FIELDS, SKIP_REASONS, SMTP_SECURITY, SUBJECT_HEADER, SUPPRESSION_REASONS, type SaveDemotion, SavedSection, SavedSectionBody, SavedSectionCreate, SavedSectionUpdate, Segment, SegmentCreate, SegmentFilter, SegmentPreview, SegmentPreviewRequest, SignupForm, SignupFormCreate, SignupFormEmbed, SignupFormTranslation, SignupSubmission, SkipReason, Slug, SplitBranchKey, SplitStep, StepId, type StepTarget, Subscription, Suppression, SuppressionCreate, SuppressionListQuery, SuppressionReason, TEMPLATE_INPUT_KINDS, TEMPLATE_INPUT_PROBLEM_REASONS, TEMPLATE_LANGUAGE_STATUSES, TERMINAL_MAILING_STATUSES, Tag, TagAssignment, TagCreate, Template, TemplateCompileRequest, TemplateCreate, TemplateCreatedData, TemplateDeletedData, TemplateDocument, TemplateExportQuery, TemplateImport, TemplateImportPreview, TemplateImportPreviewRequest, TemplateImportResult, TemplateInput, type TemplateInputKind, TemplateInputMap, TemplateInputName, type TemplateInputProblem, type TemplateInputProblemReason, TemplateInputSeen, TemplateInputSource, TemplateInputValue, TemplateInputs, TemplateInputsDeclaration, TemplateInputsDeclared, TemplateInputsSeen, TemplateLanguageStatus, TemplateListQuery, TemplatePreheader, TemplateSubject, TemplateSummary, TemplateTranslation, TemplateTranslations, TemplateUpdate, TemplateUpdatedData, TemplateVersion, TemplateVersionParams, TimeOfDay, Timestamp, TimezoneName, Topic, TopicCreate, TopicUpdate, TrackingSettings, TranslationInsertion, TranslationInsertions, UNSUBSCRIBE_PATH_PREFIX, UNSUBSCRIBE_SOURCES, USAGE_METRICS, USAGE_WARNING_HEADER, USAGE_WARNING_RATIO, type UnsubscribeToken, type UnsubscribeTokenClaims, Usage, UsageMetric, UsageWarning, type UsageWarningHeaderEntry, type ValidationContext, ValidationIssue, VariantAnalytics, type VerifyWebhookInput, WEBHOOK_DELIVERY_STATUSES, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPES, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_RETRY_DELAYS_SECONDS, WEBHOOK_SECRET_PREFIX, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_SIGNATURE_VERSION, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, WORKSPACE_HEADER, WebhookDelivery, WebhookDeliveryListQuery, WebhookDeliveryParams, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointCreate, WebhookEndpointUpdate, WebhookEndpointWithSecret, WebhookEvent, type WebhookEventOf, WebhookEventType, WebhookStep, WebhookUrl, type WebhookVerifyFailure, type WebhookVerifyResult, Weekday, Workspace, WorkspaceCreate, WorkspaceMembership, WorkspaceMove, WorkspaceSettings, WorkspaceUpdate, acceptsIdempotencyKey, addInsertion, addInsertionChoice, addLanguageDraft, alignTranslationInsertions, alwaysWaits, automationFilterFamily, automationRoutes, billingRoutes, buildPath, buildTemplatePatch, canTransition, canonicalLocale, choiceKeyProblem, chooseInsertion, cycles, defaultPreviewPick, defaultSettings, demoteForSave, demotedBySave, describeMissingTexts, draftDocument, draftInsertionProblems, draftsDirty, draftsFromTemplate, draftsPatch, editInsertionText, editLanguageDraft, editMainInsertionText, editMainInsertions, effectivePreviewPicks, emptyFlow, errorBody, escapeMergeHtml, exportFilename, filterConditions, filterDepth, filterFieldFamily, filterLeafProblem, findMergeFields, formatExportWarningsHeader, formatUsageWarningHeader, foundationRoutes, insertionByProblem, insertionChoices, insertionCoverage, insertionInputs, insertionNameProblem, insertionProblems, insertionRefusalHint, insertionSlotLabel, insertionTextSlots, insertionTokens, insertionValue, inviteRoutes, isDayEntirelyPast, isPublishable, isRetryableError, keepLanguageDocument, languageInsertions, languageName, languageTabs, mainInsertionText, matchLocale, matchRoute, missingInsertionTexts, missingRequiredMergeFields, normalizeChoiceKey, nowSeconds, operationsWithAccess, ownEntry, page, parseExportWarningsHeader, parseUsageWarningHeader, personalizeHtml, personalizeText, placementProblems, platformRoutes, previewControls, previewInsertions, previewPersonalization, primaryLanguage, reachable, readyWithoutInsertions, readyWithoutSubject, rebaseDrafts, removeInsertion, removeInsertionChoice, removeLanguageDraft, renameInsertion, renameInsertionChecked, renameInsertionChoice, renameInsertionChoiceChecked, renameInsertionEverywhere, renameInsertionPlacements, renameTokenInDocument, renameTokenInText, resolveInsertions, restorePatch, routes, sameJson, sampleMergeValue, saveDemotions, sendingRoutes, setInsertionBy, setInsertionFilled, setLanguageStatus, signWebhook, statusForError, stepTargets, storedTemplateLine, stronglyConnected, templateInputDrift, templateInputProblems, templateRoutes, testGroupSize, tightLoops, timingSafeEqualString, translationInsertionProblems, translationTextFromInput, triggerKey, unknownRefusedInsertions, unplacedInsertions, validateAutomation, verifyWebhook };

package/dist/index.d.ts

@@ -9139,6 +9139,15 @@ declare function previewInsertions(main: Insertions, translation: TranslationIns
  * as the preview showed it before insertions: it is filled per recipient.
  */
 declare function previewPersonalization(insertions: Insertions, picks: Readonly<Record<string, string>>): Personalization;
+/**
+ * The insertions a refused save names that the editor's drafts do not have:
+ * added in a version somebody else saved meanwhile, after the person chose to
+ * save theirs over it. Their texts cannot be written in that editor, so the
+ * way forward is loading that version, or setting the language back to draft.
+ * Read off `details.missing` (a ready language's missing texts) and the
+ * issues' paths; empty for any refusal that is not about an insertion.
+ */
+declare function unknownRefusedInsertions(details: Readonly<Record<string, unknown>> | null | undefined, drafts: LanguageDrafts): string[];
 /** What to do about a save refused for an insertion, from the error's `details`; null for any other refusal. */
 declare function insertionRefusalHint(details: Readonly<Record<string, unknown>> | undefined | null): string | null;
 /** One text that places a renamed insertion: which language (null is the main one), which part, how many times. */
@@ -105275,4 +105284,4 @@ declare function matchRoute(method: HttpMethod, pathname: string): {
     params: Record<string, string>;
 } | null;
 
-export { AB_TEST_STATUSES, AB_WINNER_METRICS, API_KEY_SCOPES, API_VERSION_PREFIX, ASSET_CONTENT_TYPES, ASSET_POLICIES, ASSET_UPLOAD_FIELD, AUDIT_ACTIONS, AUTHORIZATION_HEADER, AUTOMATION_DATE_TRIGGER_KINDS, AUTOMATION_END_REASONS, AUTOMATION_ENTRY_REFUSALS, AUTOMATION_FILTER_FIELD_OPERATORS, AUTOMATION_FILTER_FIELD_PATTERN, AUTOMATION_ISSUE_CODES, AUTOMATION_STATUSES, AUTOMATION_STEP_KINDS, AUTOMATION_TRIGGER_KINDS, AUTOMATION_WAIT_REASONS, AbTestConfig, AbTestState, AbVariant, AbWinnerRequest, ApiKey, ApiKeyCreate, ApiKeyCreated, ApiKeyScope, Asset, AssetContentType, AssetHost, AssetImport, AssetPolicy, AuditAction, AuditActor, AuditEntry, AuditQuery, Automation, AutomationCounts, AutomationCreate, type AutomationDateTriggerKind, AutomationDuplicateRequest, AutomationEndReason, AutomationEnrollRequest, AutomationEnrollResult, AutomationEnrollment, AutomationEntryRefusal, AutomationExitRunRequest, AutomationFilter, AutomationFilterCondition, AutomationFilterField, AutomationFlow, AutomationIssue, AutomationIssueCode, AutomationJourney, AutomationListQuery, AutomationPublishMove, AutomationPublishRequest, AutomationPublishResult, AutomationReport, AutomationRun, AutomationRunCompletedData, AutomationRunExitedData, AutomationRunFailedData, AutomationRunListQuery, AutomationRunParams, AutomationRunStartedData, AutomationRunStatus, AutomationSettings, AutomationStatus, AutomationStep, AutomationStepExecution, AutomationStepKind, AutomationStepParams, AutomationStepReport, AutomationSummary, AutomationTestEmailRequest, AutomationTrigger, AutomationTriggerKind, AutomationUpdate, AutomationValidateRequest, AutomationValidation, AutomationWaitReason, AutomationWebhookData, AutomationWithFlow, BEARER_PREFIX, BILLING_NOT_CONFIGURED_REASON, BoundedAutomationFilter, BoundedSegmentFilter, CONTACT_PROPERTY_TYPES, CatalogPlan, CheckoutRequest, CheckoutSession, CompanyId, CompileMessage, CompileRequest, CompileResult, ConditionStep, Contact, ContactAutomationListQuery, ContactAutomationRun, ContactBouncedData, ContactErased, ContactListQuery, ContactPropertyDefinition, ContactPropertyKey, ContactPropertyParams, ContactPropertyType, ContactResubscribedData, ContactSubscribedData, ContactTaggedData, ContactUnsubscribedData, ContactUpdatedData, ContactUpsert, ContactUpsertResult, DATE_PASSED_ANSWERS, DEFAULT_INVITE_TTL_DAYS, DEFAULT_PAGE_LIMIT, DOCUMENT_SCHEMA_VERSIONS, DateOnly, DatePassedAnswer, DelayStep, DocumentSchemaVersion, type DraftInsertionProblem, EDITABLE_MAILING_STATUSES, ERROR_CODES, ERROR_STATUS, EXPORT_CONTENT_TYPES, EXPORT_FORMATS, EXPORT_WARNINGS_HEADER, EXPORT_WARNING_COUNT_HEADER, type EditableLanguage, Email, EmailStep, EmailStepLanguage, ErrorBody, type ErrorCode, ErrorCodeSchema, Event, EventCreate, EventListQuery, EventName, ExportFormat, FILTER_FIELD_OPERATORS, FILTER_OPERATORS, FilterCondition, FilterField, type FilterLeafProblem, FilterOperator, GotoStep, HEALTH_PATH, HOSTED_PAGE_LOCALES, type HttpMethod, ICLOUD_SMTP_POLICY, IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_KEY_MAX_LENGTH, IDEMPOTENCY_KEY_RETENTION_HOURS, IMPORT_FILE_FIELD, IMPORT_ROW_OUTCOMES, IMPORT_SKIP_REASONS, IMPORT_STATUSES, IMPORT_TERMINAL_STATUSES, INSERTION_PROBLEM_REASONS, INSERTION_TEXT_SLOTS, INVITE_REFUSAL_REASONS, INVITE_STATUSES, Id, IdParams, ImportColumnMapping, ImportCommitRequest, ImportFinishedData, ImportJob, ImportMappingRequest, ImportReport, ImportRow, ImportRowListQuery, ImportRowOutcome, ImportSkipReason, ImportStatus, ImportWarning, ImportedAsset, Insertion, InsertionChoice, InsertionChoiceKey, type InsertionChoiceMade, InsertionChoices, type InsertionEdit, InsertionName, type InsertionProblem, type InsertionProblemReason, InsertionText, Insertions, Invite, InviteAccept, InviteAccepted, InviteCreate, InviteCreated, InviteListQuery, type InviteRefusalReason, InviteStatus, JsonValue, LETTER_RECIPIENT_REFUSAL, LIST_UNSUBSCRIBE_POST_VALUE, LOCALE_TAG_PATTERN, type LanguageDrafts, type LanguageTab, LocaleTag, MAILING_ACTIONS, MAILING_KINDS, MAILING_STATUSES, MAILING_TRANSITIONS, MAX_ALLOWED_ASSET_HOSTS, MAX_ASSET_BYTES, MAX_DELAY_SECONDS, MAX_DOCUMENT_BYTES, MAX_ENGAGEMENT_DAYS, MAX_EXPORT_WARNINGS_HEADER_LENGTH, MAX_FILTER_DEPTH, MAX_IMPORTED_REMOTE_IMAGES, MAX_IMPORT_BYTES, MAX_IMPORT_ROWS, MAX_IMPORT_URL_LENGTH, MAX_INSERTIONS, MAX_INSERTION_CHOICES, MAX_INSERTION_TEXT_LENGTH, MAX_INVITE_TTL_DAYS, MAX_IN_LIST, MAX_LETTER_RECIPIENTS, MAX_MERGE_DEFAULTS, MAX_MERGE_DEFAULT_LENGTH, MAX_MJML_DEPTH, MAX_MJML_ELEMENTS, MAX_MJML_IMPORT_BYTES, MAX_PAGE_LIMIT, MAX_PREHEADER_LENGTH, MAX_RECIPIENTS_PER_BATCH, MAX_RE_ENTRY_COOLDOWN_SECONDS, MAX_SAVED_SECTIONS, MAX_SPLIT_BRANCHES, MAX_STEPS, MAX_STEP_VISITS, MAX_SUBJECT_LENGTH, MAX_TEMPLATE_INPUTS, MAX_TEMPLATE_INPUTS_APP_LENGTH, MAX_TEMPLATE_INPUTS_SEEN, MAX_TEMPLATE_INPUT_EXAMPLE_LENGTH, MAX_TEMPLATE_INPUT_LABEL_LENGTH, MAX_TEMPLATE_INPUT_NOTE_LENGTH, MAX_TEMPLATE_INPUT_VALUES, MAX_TEMPLATE_TRANSLATIONS, MAX_TRIGGERS, MEMBER_ROLES, MERGE_FIELD_PATTERN, MESSAGE_OUTCOMES, MIN_SPLIT_BRANCHES, MJML_IMPORT_REFUSALS, Mailing, MailingAbWinnerSelectedData, MailingAction, MailingActionRequest, MailingAnalytics, MailingAudienceFromSegment, MailingCounts, MailingCreate, MailingExportQuery, MailingFinishedData, MailingKind, MailingLanguage, MailingLanguageReport, MailingLanguageStatus, MailingListQuery, MailingMetadata, MailingRetryFailedRequest, MailingScheduleFailedData, MailingScheduleRequest, MailingScheduledData, MailingSendRequest, MailingStartedData, MailingStatus, MailingSummary, MailingTestRequest, MailingTestResult, MailingUpdate, Member, MemberCreate, MemberRole, MemberUpdate, MergeDefaultValue, MergeDefaults, MergeFieldName, type MergeFieldUse, type MergeValue, Message, MessageFailedData, MessageListQuery, MessageOutcome, MessageSentData, MessageSummary, type MissingInsertionText, type MjmlImportRefusal, NotifyRecipients, NotifyStep, ON_BEHALF_OF_HEADER, ON_BEHALF_OF_MAX_LENGTH, OffsetDays, Ok, type OperationId, PLAN_FEATURES, PLAN_IDS, PREVIEW_EMPTY, PREVIEW_FILLED, PROVIDER_KINDS, type Page, PageQuery, type Personalization, type Phase, Plan, type PlanFeature, PlanFeatures, PlanId, PlanLimits, PortalRequest, PortalSession, type PreviewControl, Properties, Provider, ProviderCreate, ProviderEvents, ProviderEventsSecret, ProviderKind, ProviderPolicy, ProviderRejections, ProviderUpdate, ProviderUsage, ProviderVerifyResult, QuietHours, RECIPIENT_REJECTIONS, RECIPIENT_STATUSES, REQUEST_ID_HEADER, RESEND_EVENT_TYPES, RESERVED_MERGE_FIELDS, RETRYABLE_ERRORS, RETRY_AFTER_HEADER, RE_ENTRY_MODES, ReEntryMode, Recipient, RecipientBatch, RecipientBatchResult, RecipientInput, RecipientListQuery, RecipientStatus, RemoteImage, type RenamedPlacement, ResendSigningSecret, type ReservedMergeField, type RouteAccess, type RouteBody, type RouteDef, type RouteParams, type RouteQuery, type RouteResponse, type Routes, SERVICE_FILLED_MERGE_FIELDS, SIGNUP_FORM_FIELDS, SKIP_REASONS, SMTP_SECURITY, SUBJECT_HEADER, SUPPRESSION_REASONS, type SaveDemotion, SavedSection, SavedSectionBody, SavedSectionCreate, SavedSectionUpdate, Segment, SegmentCreate, SegmentFilter, SegmentPreview, SegmentPreviewRequest, SignupForm, SignupFormCreate, SignupFormEmbed, SignupFormTranslation, SignupSubmission, SkipReason, Slug, SplitBranchKey, SplitStep, StepId, type StepTarget, Subscription, Suppression, SuppressionCreate, SuppressionListQuery, SuppressionReason, TEMPLATE_INPUT_KINDS, TEMPLATE_INPUT_PROBLEM_REASONS, TEMPLATE_LANGUAGE_STATUSES, TERMINAL_MAILING_STATUSES, Tag, TagAssignment, TagCreate, Template, TemplateCompileRequest, TemplateCreate, TemplateCreatedData, TemplateDeletedData, TemplateDocument, TemplateExportQuery, TemplateImport, TemplateImportPreview, TemplateImportPreviewRequest, TemplateImportResult, TemplateInput, type TemplateInputKind, TemplateInputMap, TemplateInputName, type TemplateInputProblem, type TemplateInputProblemReason, TemplateInputSeen, TemplateInputSource, TemplateInputValue, TemplateInputs, TemplateInputsDeclaration, TemplateInputsDeclared, TemplateInputsSeen, TemplateLanguageStatus, TemplateListQuery, TemplatePreheader, TemplateSubject, TemplateSummary, TemplateTranslation, TemplateTranslations, TemplateUpdate, TemplateUpdatedData, TemplateVersion, TemplateVersionParams, TimeOfDay, Timestamp, TimezoneName, Topic, TopicCreate, TopicUpdate, TrackingSettings, TranslationInsertion, TranslationInsertions, UNSUBSCRIBE_PATH_PREFIX, UNSUBSCRIBE_SOURCES, USAGE_METRICS, USAGE_WARNING_HEADER, USAGE_WARNING_RATIO, type UnsubscribeToken, type UnsubscribeTokenClaims, Usage, UsageMetric, UsageWarning, type UsageWarningHeaderEntry, type ValidationContext, ValidationIssue, VariantAnalytics, type VerifyWebhookInput, WEBHOOK_DELIVERY_STATUSES, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPES, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_RETRY_DELAYS_SECONDS, WEBHOOK_SECRET_PREFIX, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_SIGNATURE_VERSION, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, WORKSPACE_HEADER, WebhookDelivery, WebhookDeliveryListQuery, WebhookDeliveryParams, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointCreate, WebhookEndpointUpdate, WebhookEndpointWithSecret, WebhookEvent, type WebhookEventOf, WebhookEventType, WebhookStep, WebhookUrl, type WebhookVerifyFailure, type WebhookVerifyResult, Weekday, Workspace, WorkspaceCreate, WorkspaceMembership, WorkspaceMove, WorkspaceSettings, WorkspaceUpdate, acceptsIdempotencyKey, addInsertion, addInsertionChoice, addLanguageDraft, alignTranslationInsertions, alwaysWaits, automationFilterFamily, automationRoutes, billingRoutes, buildPath, buildTemplatePatch, canTransition, canonicalLocale, choiceKeyProblem, chooseInsertion, cycles, defaultPreviewPick, defaultSettings, demoteForSave, demotedBySave, describeMissingTexts, draftDocument, draftInsertionProblems, draftsDirty, draftsFromTemplate, draftsPatch, editInsertionText, editLanguageDraft, editMainInsertionText, editMainInsertions, effectivePreviewPicks, emptyFlow, errorBody, escapeMergeHtml, exportFilename, filterConditions, filterDepth, filterFieldFamily, filterLeafProblem, findMergeFields, formatExportWarningsHeader, formatUsageWarningHeader, foundationRoutes, insertionByProblem, insertionChoices, insertionCoverage, insertionInputs, insertionNameProblem, insertionProblems, insertionRefusalHint, insertionSlotLabel, insertionTextSlots, insertionTokens, insertionValue, inviteRoutes, isDayEntirelyPast, isPublishable, isRetryableError, keepLanguageDocument, languageInsertions, languageName, languageTabs, mainInsertionText, matchLocale, matchRoute, missingInsertionTexts, missingRequiredMergeFields, normalizeChoiceKey, nowSeconds, operationsWithAccess, ownEntry, page, parseExportWarningsHeader, parseUsageWarningHeader, personalizeHtml, personalizeText, placementProblems, platformRoutes, previewControls, previewInsertions, previewPersonalization, primaryLanguage, reachable, readyWithoutInsertions, readyWithoutSubject, rebaseDrafts, removeInsertion, removeInsertionChoice, removeLanguageDraft, renameInsertion, renameInsertionChecked, renameInsertionChoice, renameInsertionChoiceChecked, renameInsertionEverywhere, renameInsertionPlacements, renameTokenInDocument, renameTokenInText, resolveInsertions, restorePatch, routes, sameJson, sampleMergeValue, saveDemotions, sendingRoutes, setInsertionBy, setInsertionFilled, setLanguageStatus, signWebhook, statusForError, stepTargets, storedTemplateLine, stronglyConnected, templateInputDrift, templateInputProblems, templateRoutes, testGroupSize, tightLoops, timingSafeEqualString, translationInsertionProblems, translationTextFromInput, triggerKey, unplacedInsertions, validateAutomation, verifyWebhook };
+export { AB_TEST_STATUSES, AB_WINNER_METRICS, API_KEY_SCOPES, API_VERSION_PREFIX, ASSET_CONTENT_TYPES, ASSET_POLICIES, ASSET_UPLOAD_FIELD, AUDIT_ACTIONS, AUTHORIZATION_HEADER, AUTOMATION_DATE_TRIGGER_KINDS, AUTOMATION_END_REASONS, AUTOMATION_ENTRY_REFUSALS, AUTOMATION_FILTER_FIELD_OPERATORS, AUTOMATION_FILTER_FIELD_PATTERN, AUTOMATION_ISSUE_CODES, AUTOMATION_STATUSES, AUTOMATION_STEP_KINDS, AUTOMATION_TRIGGER_KINDS, AUTOMATION_WAIT_REASONS, AbTestConfig, AbTestState, AbVariant, AbWinnerRequest, ApiKey, ApiKeyCreate, ApiKeyCreated, ApiKeyScope, Asset, AssetContentType, AssetHost, AssetImport, AssetPolicy, AuditAction, AuditActor, AuditEntry, AuditQuery, Automation, AutomationCounts, AutomationCreate, type AutomationDateTriggerKind, AutomationDuplicateRequest, AutomationEndReason, AutomationEnrollRequest, AutomationEnrollResult, AutomationEnrollment, AutomationEntryRefusal, AutomationExitRunRequest, AutomationFilter, AutomationFilterCondition, AutomationFilterField, AutomationFlow, AutomationIssue, AutomationIssueCode, AutomationJourney, AutomationListQuery, AutomationPublishMove, AutomationPublishRequest, AutomationPublishResult, AutomationReport, AutomationRun, AutomationRunCompletedData, AutomationRunExitedData, AutomationRunFailedData, AutomationRunListQuery, AutomationRunParams, AutomationRunStartedData, AutomationRunStatus, AutomationSettings, AutomationStatus, AutomationStep, AutomationStepExecution, AutomationStepKind, AutomationStepParams, AutomationStepReport, AutomationSummary, AutomationTestEmailRequest, AutomationTrigger, AutomationTriggerKind, AutomationUpdate, AutomationValidateRequest, AutomationValidation, AutomationWaitReason, AutomationWebhookData, AutomationWithFlow, BEARER_PREFIX, BILLING_NOT_CONFIGURED_REASON, BoundedAutomationFilter, BoundedSegmentFilter, CONTACT_PROPERTY_TYPES, CatalogPlan, CheckoutRequest, CheckoutSession, CompanyId, CompileMessage, CompileRequest, CompileResult, ConditionStep, Contact, ContactAutomationListQuery, ContactAutomationRun, ContactBouncedData, ContactErased, ContactListQuery, ContactPropertyDefinition, ContactPropertyKey, ContactPropertyParams, ContactPropertyType, ContactResubscribedData, ContactSubscribedData, ContactTaggedData, ContactUnsubscribedData, ContactUpdatedData, ContactUpsert, ContactUpsertResult, DATE_PASSED_ANSWERS, DEFAULT_INVITE_TTL_DAYS, DEFAULT_PAGE_LIMIT, DOCUMENT_SCHEMA_VERSIONS, DateOnly, DatePassedAnswer, DelayStep, DocumentSchemaVersion, type DraftInsertionProblem, EDITABLE_MAILING_STATUSES, ERROR_CODES, ERROR_STATUS, EXPORT_CONTENT_TYPES, EXPORT_FORMATS, EXPORT_WARNINGS_HEADER, EXPORT_WARNING_COUNT_HEADER, type EditableLanguage, Email, EmailStep, EmailStepLanguage, ErrorBody, type ErrorCode, ErrorCodeSchema, Event, EventCreate, EventListQuery, EventName, ExportFormat, FILTER_FIELD_OPERATORS, FILTER_OPERATORS, FilterCondition, FilterField, type FilterLeafProblem, FilterOperator, GotoStep, HEALTH_PATH, HOSTED_PAGE_LOCALES, type HttpMethod, ICLOUD_SMTP_POLICY, IDEMPOTENCY_KEY_HEADER, IDEMPOTENCY_KEY_MAX_LENGTH, IDEMPOTENCY_KEY_RETENTION_HOURS, IMPORT_FILE_FIELD, IMPORT_ROW_OUTCOMES, IMPORT_SKIP_REASONS, IMPORT_STATUSES, IMPORT_TERMINAL_STATUSES, INSERTION_PROBLEM_REASONS, INSERTION_TEXT_SLOTS, INVITE_REFUSAL_REASONS, INVITE_STATUSES, Id, IdParams, ImportColumnMapping, ImportCommitRequest, ImportFinishedData, ImportJob, ImportMappingRequest, ImportReport, ImportRow, ImportRowListQuery, ImportRowOutcome, ImportSkipReason, ImportStatus, ImportWarning, ImportedAsset, Insertion, InsertionChoice, InsertionChoiceKey, type InsertionChoiceMade, InsertionChoices, type InsertionEdit, InsertionName, type InsertionProblem, type InsertionProblemReason, InsertionText, Insertions, Invite, InviteAccept, InviteAccepted, InviteCreate, InviteCreated, InviteListQuery, type InviteRefusalReason, InviteStatus, JsonValue, LETTER_RECIPIENT_REFUSAL, LIST_UNSUBSCRIBE_POST_VALUE, LOCALE_TAG_PATTERN, type LanguageDrafts, type LanguageTab, LocaleTag, MAILING_ACTIONS, MAILING_KINDS, MAILING_STATUSES, MAILING_TRANSITIONS, MAX_ALLOWED_ASSET_HOSTS, MAX_ASSET_BYTES, MAX_DELAY_SECONDS, MAX_DOCUMENT_BYTES, MAX_ENGAGEMENT_DAYS, MAX_EXPORT_WARNINGS_HEADER_LENGTH, MAX_FILTER_DEPTH, MAX_IMPORTED_REMOTE_IMAGES, MAX_IMPORT_BYTES, MAX_IMPORT_ROWS, MAX_IMPORT_URL_LENGTH, MAX_INSERTIONS, MAX_INSERTION_CHOICES, MAX_INSERTION_TEXT_LENGTH, MAX_INVITE_TTL_DAYS, MAX_IN_LIST, MAX_LETTER_RECIPIENTS, MAX_MERGE_DEFAULTS, MAX_MERGE_DEFAULT_LENGTH, MAX_MJML_DEPTH, MAX_MJML_ELEMENTS, MAX_MJML_IMPORT_BYTES, MAX_PAGE_LIMIT, MAX_PREHEADER_LENGTH, MAX_RECIPIENTS_PER_BATCH, MAX_RE_ENTRY_COOLDOWN_SECONDS, MAX_SAVED_SECTIONS, MAX_SPLIT_BRANCHES, MAX_STEPS, MAX_STEP_VISITS, MAX_SUBJECT_LENGTH, MAX_TEMPLATE_INPUTS, MAX_TEMPLATE_INPUTS_APP_LENGTH, MAX_TEMPLATE_INPUTS_SEEN, MAX_TEMPLATE_INPUT_EXAMPLE_LENGTH, MAX_TEMPLATE_INPUT_LABEL_LENGTH, MAX_TEMPLATE_INPUT_NOTE_LENGTH, MAX_TEMPLATE_INPUT_VALUES, MAX_TEMPLATE_TRANSLATIONS, MAX_TRIGGERS, MEMBER_ROLES, MERGE_FIELD_PATTERN, MESSAGE_OUTCOMES, MIN_SPLIT_BRANCHES, MJML_IMPORT_REFUSALS, Mailing, MailingAbWinnerSelectedData, MailingAction, MailingActionRequest, MailingAnalytics, MailingAudienceFromSegment, MailingCounts, MailingCreate, MailingExportQuery, MailingFinishedData, MailingKind, MailingLanguage, MailingLanguageReport, MailingLanguageStatus, MailingListQuery, MailingMetadata, MailingRetryFailedRequest, MailingScheduleFailedData, MailingScheduleRequest, MailingScheduledData, MailingSendRequest, MailingStartedData, MailingStatus, MailingSummary, MailingTestRequest, MailingTestResult, MailingUpdate, Member, MemberCreate, MemberRole, MemberUpdate, MergeDefaultValue, MergeDefaults, MergeFieldName, type MergeFieldUse, type MergeValue, Message, MessageFailedData, MessageListQuery, MessageOutcome, MessageSentData, MessageSummary, type MissingInsertionText, type MjmlImportRefusal, NotifyRecipients, NotifyStep, ON_BEHALF_OF_HEADER, ON_BEHALF_OF_MAX_LENGTH, OffsetDays, Ok, type OperationId, PLAN_FEATURES, PLAN_IDS, PREVIEW_EMPTY, PREVIEW_FILLED, PROVIDER_KINDS, type Page, PageQuery, type Personalization, type Phase, Plan, type PlanFeature, PlanFeatures, PlanId, PlanLimits, PortalRequest, PortalSession, type PreviewControl, Properties, Provider, ProviderCreate, ProviderEvents, ProviderEventsSecret, ProviderKind, ProviderPolicy, ProviderRejections, ProviderUpdate, ProviderUsage, ProviderVerifyResult, QuietHours, RECIPIENT_REJECTIONS, RECIPIENT_STATUSES, REQUEST_ID_HEADER, RESEND_EVENT_TYPES, RESERVED_MERGE_FIELDS, RETRYABLE_ERRORS, RETRY_AFTER_HEADER, RE_ENTRY_MODES, ReEntryMode, Recipient, RecipientBatch, RecipientBatchResult, RecipientInput, RecipientListQuery, RecipientStatus, RemoteImage, type RenamedPlacement, ResendSigningSecret, type ReservedMergeField, type RouteAccess, type RouteBody, type RouteDef, type RouteParams, type RouteQuery, type RouteResponse, type Routes, SERVICE_FILLED_MERGE_FIELDS, SIGNUP_FORM_FIELDS, SKIP_REASONS, SMTP_SECURITY, SUBJECT_HEADER, SUPPRESSION_REASONS, type SaveDemotion, SavedSection, SavedSectionBody, SavedSectionCreate, SavedSectionUpdate, Segment, SegmentCreate, SegmentFilter, SegmentPreview, SegmentPreviewRequest, SignupForm, SignupFormCreate, SignupFormEmbed, SignupFormTranslation, SignupSubmission, SkipReason, Slug, SplitBranchKey, SplitStep, StepId, type StepTarget, Subscription, Suppression, SuppressionCreate, SuppressionListQuery, SuppressionReason, TEMPLATE_INPUT_KINDS, TEMPLATE_INPUT_PROBLEM_REASONS, TEMPLATE_LANGUAGE_STATUSES, TERMINAL_MAILING_STATUSES, Tag, TagAssignment, TagCreate, Template, TemplateCompileRequest, TemplateCreate, TemplateCreatedData, TemplateDeletedData, TemplateDocument, TemplateExportQuery, TemplateImport, TemplateImportPreview, TemplateImportPreviewRequest, TemplateImportResult, TemplateInput, type TemplateInputKind, TemplateInputMap, TemplateInputName, type TemplateInputProblem, type TemplateInputProblemReason, TemplateInputSeen, TemplateInputSource, TemplateInputValue, TemplateInputs, TemplateInputsDeclaration, TemplateInputsDeclared, TemplateInputsSeen, TemplateLanguageStatus, TemplateListQuery, TemplatePreheader, TemplateSubject, TemplateSummary, TemplateTranslation, TemplateTranslations, TemplateUpdate, TemplateUpdatedData, TemplateVersion, TemplateVersionParams, TimeOfDay, Timestamp, TimezoneName, Topic, TopicCreate, TopicUpdate, TrackingSettings, TranslationInsertion, TranslationInsertions, UNSUBSCRIBE_PATH_PREFIX, UNSUBSCRIBE_SOURCES, USAGE_METRICS, USAGE_WARNING_HEADER, USAGE_WARNING_RATIO, type UnsubscribeToken, type UnsubscribeTokenClaims, Usage, UsageMetric, UsageWarning, type UsageWarningHeaderEntry, type ValidationContext, ValidationIssue, VariantAnalytics, type VerifyWebhookInput, WEBHOOK_DELIVERY_STATUSES, WEBHOOK_EVENT_ID_HEADER, WEBHOOK_EVENT_TYPES, WEBHOOK_MAX_ATTEMPTS, WEBHOOK_RETRY_DELAYS_SECONDS, WEBHOOK_SECRET_PREFIX, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_SIGNATURE_VERSION, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, WORKSPACE_HEADER, WebhookDelivery, WebhookDeliveryListQuery, WebhookDeliveryParams, WebhookDeliveryStatus, WebhookEndpoint, WebhookEndpointCreate, WebhookEndpointUpdate, WebhookEndpointWithSecret, WebhookEvent, type WebhookEventOf, WebhookEventType, WebhookStep, WebhookUrl, type WebhookVerifyFailure, type WebhookVerifyResult, Weekday, Workspace, WorkspaceCreate, WorkspaceMembership, WorkspaceMove, WorkspaceSettings, WorkspaceUpdate, acceptsIdempotencyKey, addInsertion, addInsertionChoice, addLanguageDraft, alignTranslationInsertions, alwaysWaits, automationFilterFamily, automationRoutes, billingRoutes, buildPath, buildTemplatePatch, canTransition, canonicalLocale, choiceKeyProblem, chooseInsertion, cycles, defaultPreviewPick, defaultSettings, demoteForSave, demotedBySave, describeMissingTexts, draftDocument, draftInsertionProblems, draftsDirty, draftsFromTemplate, draftsPatch, editInsertionText, editLanguageDraft, editMainInsertionText, editMainInsertions, effectivePreviewPicks, emptyFlow, errorBody, escapeMergeHtml, exportFilename, filterConditions, filterDepth, filterFieldFamily, filterLeafProblem, findMergeFields, formatExportWarningsHeader, formatUsageWarningHeader, foundationRoutes, insertionByProblem, insertionChoices, insertionCoverage, insertionInputs, insertionNameProblem, insertionProblems, insertionRefusalHint, insertionSlotLabel, insertionTextSlots, insertionTokens, insertionValue, inviteRoutes, isDayEntirelyPast, isPublishable, isRetryableError, keepLanguageDocument, languageInsertions, languageName, languageTabs, mainInsertionText, matchLocale, matchRoute, missingInsertionTexts, missingRequiredMergeFields, normalizeChoiceKey, nowSeconds, operationsWithAccess, ownEntry, page, parseExportWarningsHeader, parseUsageWarningHeader, personalizeHtml, personalizeText, placementProblems, platformRoutes, previewControls, previewInsertions, previewPersonalization, primaryLanguage, reachable, readyWithoutInsertions, readyWithoutSubject, rebaseDrafts, removeInsertion, removeInsertionChoice, removeLanguageDraft, renameInsertion, renameInsertionChecked, renameInsertionChoice, renameInsertionChoiceChecked, renameInsertionEverywhere, renameInsertionPlacements, renameTokenInDocument, renameTokenInText, resolveInsertions, restorePatch, routes, sameJson, sampleMergeValue, saveDemotions, sendingRoutes, setInsertionBy, setInsertionFilled, setLanguageStatus, signWebhook, statusForError, stepTargets, storedTemplateLine, stronglyConnected, templateInputDrift, templateInputProblems, templateRoutes, testGroupSize, tightLoops, timingSafeEqualString, translationInsertionProblems, translationTextFromInput, triggerKey, unknownRefusedInsertions, unplacedInsertions, validateAutomation, verifyWebhook };

package/dist/index.js

@@ -588,6 +588,7 @@ __export(index_exports, {
   translationInsertionProblems: () => translationInsertionProblems,
   translationTextFromInput: () => translationTextFromInput,
   triggerKey: () => triggerKey,
+  unknownRefusedInsertions: () => unknownRefusedInsertions,
   unplacedInsertions: () => unplacedInsertions,
   validateAutomation: () => validateAutomation,
   verifyWebhook: () => verifyWebhook
@@ -3901,6 +3902,25 @@ var REFUSAL_HINTS = {
   insertion_with_fallback: 'Remove the |fallback from the insertion in the subject, preheader or body: its "otherwise" text is the fallback.',
   unknown_translation_insertion: "A language names an insertion or a choice the main language no longer has. Reload the template and try again."
 };
+function unknownRefusedInsertions(details, drafts) {
+  const reason = details?.reason;
+  if (typeof reason !== "string" || !has(REFUSAL_HINTS, reason)) return [];
+  const names = [];
+  const add = (name) => {
+    if (typeof name === "string" && name !== "" && ownEntry(drafts.insertions, name) === void 0 && !names.includes(name)) names.push(name);
+  };
+  if (Array.isArray(details?.missing)) {
+    for (const m of details.missing) if (typeof m === "object" && m !== null) add(m.insertion);
+  }
+  if (Array.isArray(details?.issues)) {
+    for (const issue of details.issues) {
+      const path = typeof issue === "object" && issue !== null && Array.isArray(issue.path) ? issue.path.map(String) : [];
+      const at = path.indexOf("insertions");
+      if (at >= 0) add(path[at + 1]);
+    }
+  }
+  return names;
+}
 function insertionRefusalHint(details) {
   const reason = details?.reason;
   if (typeof reason !== "string" || !has(REFUSAL_HINTS, reason)) return null;
@@ -6659,6 +6679,7 @@ function matchRoute(method, pathname) {
   translationInsertionProblems,
   translationTextFromInput,
   triggerKey,
+  unknownRefusedInsertions,
   unplacedInsertions,
   validateAutomation,
   verifyWebhook

package/dist/index.mjs

@@ -3305,6 +3305,25 @@ var REFUSAL_HINTS = {
   insertion_with_fallback: 'Remove the |fallback from the insertion in the subject, preheader or body: its "otherwise" text is the fallback.',
   unknown_translation_insertion: "A language names an insertion or a choice the main language no longer has. Reload the template and try again."
 };
+function unknownRefusedInsertions(details, drafts) {
+  const reason = details?.reason;
+  if (typeof reason !== "string" || !has(REFUSAL_HINTS, reason)) return [];
+  const names = [];
+  const add = (name) => {
+    if (typeof name === "string" && name !== "" && ownEntry(drafts.insertions, name) === void 0 && !names.includes(name)) names.push(name);
+  };
+  if (Array.isArray(details?.missing)) {
+    for (const m of details.missing) if (typeof m === "object" && m !== null) add(m.insertion);
+  }
+  if (Array.isArray(details?.issues)) {
+    for (const issue of details.issues) {
+      const path = typeof issue === "object" && issue !== null && Array.isArray(issue.path) ? issue.path.map(String) : [];
+      const at = path.indexOf("insertions");
+      if (at >= 0) add(path[at + 1]);
+    }
+  }
+  return names;
+}
 function insertionRefusalHint(details) {
   const reason = details?.reason;
   if (typeof reason !== "string" || !has(REFUSAL_HINTS, reason)) return null;
@@ -6062,6 +6081,7 @@ export {
   translationInsertionProblems,
   translationTextFromInput,
   triggerKey,
+  unknownRefusedInsertions,
   unplacedInsertions,
   validateAutomation,
   verifyWebhook

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "The v1 API contract of the mail service: zod schemas and types for every request, response, error and webhook, the route table, and webhook signing helpers",
   "license": "MIT",
   "repository": {