@sixtyninecommerce/admin 0.11.0 → 0.13.0

package/dist/customers/groups.d.ts

@@ -25,6 +25,13 @@ export interface CustomerGroup {
     canViewIncomingStock: boolean;
     /** Members may order more than is in stock, within the store's or the variant's backorder policy. */
     canBackorder: boolean;
+    /**
+     * "View only": signed-in members see the store's retail prices including VAT (the prices an
+     * anonymous shopper sees, never a price list's) and can fill a basket on the storefront, but
+     * checkout, payments and quote requests are refused (`VIEW_ONLY_ACCOUNT`). Staff can still
+     * place orders for them. The Exact customer import never links a customer to such a group.
+     */
+    viewOnly: boolean;
     /**
      * The store's own group, or its organization's (shared while the organization shares
      * `customer_groups`); see {@link CatalogueOwnership}. `editableHere` false: rename it, change
@@ -91,6 +98,7 @@ export interface CustomerGroupListItem {
     name: string;
     canViewIncomingStock: boolean;
     canBackorder: boolean;
+    viewOnly: boolean;
     /**
      * How many of the store's customers are in the group, present only when the call asked for
      * `include: ['memberCount']`.
@@ -134,12 +142,15 @@ export interface CreateCustomerGroupInput {
     canViewIncomingStock?: boolean;
     /** See {@link CustomerGroup.canBackorder}. Off when omitted. */
     canBackorder?: boolean;
+    /** See {@link CustomerGroup.viewOnly}. Off when omitted. */
+    viewOnly?: boolean;
 }
 /** A PATCH: an absent field keeps what the group has. */
 export interface UpdateCustomerGroupInput {
     name?: string;
     canViewIncomingStock?: boolean;
     canBackorder?: boolean;
+    viewOnly?: boolean;
 }
 /** A group by id and name. */
 export interface CustomerGroupRef {
@@ -168,9 +179,9 @@ export interface CustomerB2BGroupsModule {
     set(groupIds: readonly string[], options?: Call): Promise<CustomerGroupRef[]>;
 }
 /** A customer group as `get`, `create` and `update` read it. */
-export declare const CUSTOMER_GROUP_FIELDS = "\n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n";
-export declare const CUSTOMER_GROUP_QUERY = "\n  query CustomerGroup($id: ID!) {\n    customerGroup(id: $id) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
-export declare const CUSTOMER_GROUP_MEMBERS_QUERY = "\n  query CustomerGroupWithMembers($id: ID!, $members: CustomerListOptions) {\n    customerGroup(id: $id) {\n      \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n\n      customers(options: $members) {\n        items {\n          id\n          createdAt\n          firstName\n          lastName\n          emailAddress\n          addresses {\n            company\n            defaultBillingAddress\n            defaultShippingAddress\n          }\n        }\n        totalItems\n      }\n    }\n  }\n";
+export declare const CUSTOMER_GROUP_FIELDS = "\n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n";
+export declare const CUSTOMER_GROUP_QUERY = "\n  query CustomerGroup($id: ID!) {\n    customerGroup(id: $id) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
+export declare const CUSTOMER_GROUP_MEMBERS_QUERY = "\n  query CustomerGroupWithMembers($id: ID!, $members: CustomerListOptions) {\n    customerGroup(id: $id) {\n      \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n\n      customers(options: $members) {\n        items {\n          id\n          createdAt\n          firstName\n          lastName\n          emailAddress\n          addresses {\n            company\n            defaultBillingAddress\n            defaultShippingAddress\n          }\n        }\n        totalItems\n      }\n    }\n  }\n";
 /**
  * The list document for a set of blocks. The member count is the `totalItems` of a one-row page
  * of the group's customers: a `take` of 0 would make that page every member.
@@ -184,8 +195,8 @@ export declare const CUSTOMER_GROUP_MEMBERS_QUERY = "\n  query CustomerGroupWith
  * fix is `omit: ['customers']` on those two resolvers, which this package cannot make.
  */
 export declare function customerGroupListQuery(include: readonly CustomerGroupListInclude[]): string;
-export declare const CREATE_CUSTOMER_GROUP_MUTATION = "\n  mutation CreateCustomerGroup($input: CreateCustomerGroupInput!) {\n    createCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
-export declare const UPDATE_CUSTOMER_GROUP_MUTATION = "\n  mutation UpdateCustomerGroup($input: UpdateCustomerGroupInput!) {\n    updateCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
+export declare const CREATE_CUSTOMER_GROUP_MUTATION = "\n  mutation CreateCustomerGroup($input: CreateCustomerGroupInput!) {\n    createCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
+export declare const UPDATE_CUSTOMER_GROUP_MUTATION = "\n  mutation UpdateCustomerGroup($input: UpdateCustomerGroupInput!) {\n    updateCustomerGroup(input: $input) { \n  id\n  createdAt\n  updatedAt\n  name\n  externalKey\n  \n  customFields {\n    canViewIncomingStock\n    canBackorder\n    viewOnly\n  }\n\n  \n  catalogueOwnership {\n    state\n    organizationName\n    editableHere\n  }\n\n }\n  }\n";
 export declare const DELETE_CUSTOMER_GROUP_MUTATION = "\n  mutation DeleteCustomerGroup($id: ID!) {\n    deleteCustomerGroup(id: $id) { \n  result\n  message\n }\n  }\n";
 export declare const DELETE_CUSTOMER_GROUPS_MUTATION = "\n  mutation DeleteCustomerGroups($ids: [ID!]!) {\n    deleteCustomerGroups(ids: $ids) { \n  result\n  message\n }\n  }\n";
 export declare const B2B_CUSTOMER_GROUPS_QUERY = "\n  query CustomerGroupRefs {\n    b2bCustomerGroups {\n      id\n      name\n    }\n  }\n";

package/dist/customers/groups.js

@@ -16,10 +16,13 @@ export const MAX_CUSTOMER_GROUP_LIST_TAKE = 1000;
 export const CUSTOMER_GROUP_LIST_SORT_FIELDS = ['name', 'createdAt', 'updatedAt'];
 /** The blocks a list row can add: `memberCount`, how many of the store's customers are in it. */
 export const CUSTOMER_GROUP_LIST_INCLUDES = ['memberCount'];
+/** The group's boolean flags, each a `CustomerGroup.customFields` field of the same name. */
+const GROUP_FLAGS = ['canViewIncomingStock', 'canBackorder', 'viewOnly'];
 const GROUP_FLAG_FIELDS = /* GraphQL */ `
   customFields {
     canViewIncomingStock
     canBackorder
+    viewOnly
   }
 `;
 /** A customer group as `get`, `create` and `update` read it. */
@@ -144,11 +147,12 @@ const isPageSize = (take) => typeof take === 'number' &&
     take >= 1 &&
     take <= MAX_CUSTOMER_GROUP_LIST_TAKE;
 const isOffset = (skip) => typeof skip === 'number' && Number.isInteger(skip) && skip >= 0;
-/** Both flags are `false` unless the engine answers `true`: a group has no third state. */
+/** Every flag is `false` unless the engine answers `true`: a group has no third state. */
 function flagsOf(wire) {
     return {
         canViewIncomingStock: wire.customFields?.canViewIncomingStock === true,
         canBackorder: wire.customFields?.canBackorder === true,
+        viewOnly: wire.customFields?.viewOnly === true,
     };
 }
 function toCustomerGroup(wire) {
@@ -341,7 +345,7 @@ export async function listCustomerGroups(transport, options) {
 /** Only the flags the caller set travel: an omitted flag is never sent as `null`. */
 function flagFields(input) {
     const customFields = {};
-    for (const flag of ['canViewIncomingStock', 'canBackorder']) {
+    for (const flag of GROUP_FLAGS) {
         const value = input[flag];
         if (value === undefined)
             continue;

package/dist/customers/index.d.ts

@@ -6,6 +6,7 @@ import type { Call, ListOptions } from '../types.js';
 import { type CustomerAgeVerification, type CustomerDateOfBirthModule } from './age-verification.js';
 import { type CustomerCreditModule } from './credit.js';
 import { type CustomerDeliveryPreferencesModule } from './delivery-preferences.js';
+import { type CustomerDeliveryTerms } from './delivery-terms.js';
 import { type CreateCustomerGroupInput, type CustomerB2BGroupsModule, type CustomerGroup, type CustomerGroupListItem, type CustomerGroupListOptions, type CustomerGroupMembersOptions, type CustomerGroupRef, type CustomerGroupWithMembers, type UpdateCustomerGroupInput } from './groups.js';
 import { type CustomerInvitationStatus } from './invitation-status.js';
 import { type CustomerNotesModule } from './notes.js';
@@ -1026,6 +1027,20 @@ export interface CustomersModule {
      * @effect read
      */
     savedLists(customerId: string, options?: Call): Promise<CustomerSavedList[] | null>;
+    /**
+     * The customer's delivery terms as an order placed now would take them: the preferred and
+     * allowed shipping methods, the Incoterm, the dispatch lead time and whether a partial delivery
+     * is accepted, from whichever source governs them (an ERP such as Exact Online). `null` when
+     * nothing governs the customer's delivery. A local read of what the source last synchronized;
+     * it calls no ERP.
+     *
+     * Refused `USER_INPUT_ERROR` (`ValidationError`, 400) for a customer this store does not hold
+     * (another store's included). Needs `ReadCustomer`.
+     *
+     * @effect read
+     * @permission ReadCustomer
+     */
+    deliveryTerms(customerId: string, options?: Call): Promise<CustomerDeliveryTerms | null>;
     groups: CustomerGroupsModule;
     addresses: CustomerAddressesModule;
     /** A customer's B2B credit: account, limit, terms, status and what may be invoiced. */

package/dist/customers/index.js

@@ -6,6 +6,7 @@ import { listCustomerOrders, listCustomerRecentOrders, } from '../orders/list.js
 import { createCustomerDateOfBirthModule, readCustomerAgeVerification, } from './age-verification.js';
 import { createCustomerCreditModule } from './credit.js';
 import { createCustomerDeliveryPreferencesModule, } from './delivery-preferences.js';
+import { readCustomerDeliveryTerms } from './delivery-terms.js';
 import { createCustomerB2BGroupsModule, createCustomerGroup, deleteCustomerGroup, deleteCustomerGroups, listCustomerGroups, readCustomerGroup, updateCustomerGroup, } from './groups.js';
 import { readCustomerInvitationStatus, } from './invitation-status.js';
 import { createCustomerNotesModule } from './notes.js';
@@ -616,6 +617,9 @@ export function createCustomersModule(transport) {
         savedLists(customerId, options) {
             return readCustomerSavedLists(transport, customerId, options);
         },
+        deliveryTerms(customerId, options) {
+            return readCustomerDeliveryTerms(transport, customerId, options);
+        },
         // The answer holds exactly the blocks asked for; `CustomerFor` decides how many of them the
         // caller's type of `include` may rely on. The overloads narrow this one implementation, which
         // TypeScript cannot check for them.

package/dist/documents/emails.d.ts

@@ -0,0 +1,154 @@
+/**
+ * `admin.documents.emails` — the store's email delivery log, its counts, a retry of one delivery,
+ * and a test send of a template (headless spec §9.2 `documents`, "email sends"; W10-103).
+ *
+ * Every call needs `UpdateSettings` on the active store. A delivery's recipients, subject, error
+ * and metadata are customer data: below `customerData: full` (an app installation) they read
+ * `''`/`null` and the row carries `redacted: true`.
+ */
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call, ListOptions } from '../types.js';
+/**
+ * Where a delivery stands. `skipped`: the store's `sender: none` for the event (the platform sent
+ * nothing, on purpose). `suppressed_sandbox`: a sandbox store withheld the customer's copy. The
+ * engine may add others; a reader keeps a default branch.
+ */
+export type EmailDeliveryStatus = 'sent' | 'failed' | 'blocked' | 'pending' | 'skipped' | 'suppressed_sandbox' | (string & {});
+/** One email the store sent, or tried to. */
+export interface EmailDelivery {
+    id: string;
+    /** The template it was rendered from (`order_confirmation`, …). */
+    templateType: string;
+    /** The notification event that sent it (`order_placed`, …). */
+    notificationEvent: string;
+    /** Comma-separated addresses. */
+    recipientTo: string;
+    recipientCc: string | null;
+    recipientBcc: string | null;
+    subject: string;
+    gatewayId: string | null;
+    status: EmailDeliveryStatus;
+    /** 1 for the first send; each retry adds one. */
+    attempt: number;
+    /** The mail provider's message id, when it took the email. */
+    messageId: string | null;
+    /**
+     * Why the last attempt failed, as a coded sentence: `CODE: not sent (facts). Plain sentence.`
+     * (`SMTP_SEND_FAILED: not sent (code=EAUTH step=AUTH PLAIN reply=535). …`). Never the
+     * provider's or the mail server's own words, which can quote the gateway's user name or hosts.
+     */
+    error: string | null;
+    durationMs: number | null;
+    /** The ids the email was rendered from (`orderId`, `invoiceId`, …) and other send facts. */
+    metadata: Record<string, unknown> | null;
+    /** ISO-8601 UTC. */
+    createdAt: string;
+    /**
+     * Set when the caller's customer-data level withheld part of the row (an app installation
+     * below `customerData: full`): the recipients, subject, error and metadata then read `''` or
+     * `null`, meaning "not granted", never "none on record".
+     */
+    redacted?: true;
+}
+/**
+ * Which deliveries a list or a count covers. The two instants need an explicit offset (`Z` or
+ * `±HH:mm`) and are refused before the request leaves without one (`INVALID_DATETIME`): a store's
+ * day is not the caller's. To cover the store's days, send the first instant of the first day as
+ * `createdFrom` and the first instant of the day AFTER the last one as `createdBefore`
+ * ({@link EmailDeliveriesModule.list}).
+ */
+export interface EmailDeliveryFilter {
+    status?: EmailDeliveryStatus;
+    templateType?: string;
+    /** Created at or after this instant. */
+    createdFrom?: string;
+    /** Created strictly before this instant. */
+    createdBefore?: string;
+}
+/** How many of the store's deliveries are in each state, over a filter. */
+export interface EmailDeliveryStats {
+    sent: number;
+    failed: number;
+    /** Never sent: every recipient is on the mail provider's suppression list. */
+    blocked: number;
+    pending: number;
+}
+export interface SendTestEmailInput {
+    /** A template type the platform renders (`admin.tenant.emailTemplates.catalog()`). */
+    templateType: string;
+    /** One email address. */
+    recipientEmail: string;
+}
+export interface EmailDeliveriesModule {
+    /**
+     * The store's deliveries, newest first, one page at a time (`limit` 1–100, 50 when omitted).
+     *
+     * **Store days.** The page that shows "from 24 to 25 October" in Europe/Amsterdam sends
+     * `createdFrom: '2026-10-24T00:00:00+02:00'` and `createdBefore: '2026-10-26T00:00:00+01:00'`:
+     * 25 October 2026 is 25 hours long there (the clocks go back), and the end is exclusive, so
+     * the whole last day is in and nothing of the next.
+     *
+     * **Coded refusals:** `INVALID_DATETIME` → `ValidationError` (400), an instant without an
+     * offset, before the request leaves; `EMAIL_DELIVERY_FILTER_INVALID` → `ValidationError`
+     * (400), a `limit` outside 1–100 or a range that ends before it starts.
+     *
+     * Rows carry `redacted: true` below `customerData: full` (see {@link EmailDelivery}).
+     *
+     * @effect read
+     * @permission UpdateSettings
+     */
+    list(filter?: EmailDeliveryFilter, options?: ListOptions): Promise<Page<EmailDelivery>>;
+    /**
+     * How many deliveries are `sent`, `failed`, `blocked` and `pending`, over the same filter as
+     * {@link list} without its `status` (a count by status). Without a filter: the store's whole
+     * log. On an engine from before this release (no filter argument) a filtered count is made
+     * from the list's totals, one read per status.
+     *
+     * @effect read
+     * @permission UpdateSettings
+     */
+    stats(filter?: Omit<EmailDeliveryFilter, 'status'>, options?: Call): Promise<EmailDeliveryStats>;
+    /**
+     * Send a `failed` or `blocked` delivery again, now, and answer the row with the new outcome:
+     * `status` is `sent`, `failed` again (with its `error`), `blocked` (the address is still on the
+     * provider's suppression list) or `suppressed_sandbox`. It resolves either way; read `status`.
+     * Synchronous: the email has been handed to the provider (or not) when it resolves.
+     *
+     * This sends the email to the CUSTOMER (or whoever it was addressed to) once more. Never call
+     * it in a loop or on a timer without a person deciding to.
+     *
+     * **Coded refusals** (nothing is sent): `EMAIL_DELIVERY_NOT_FOUND` → `NotFoundError` (404), no
+     * such delivery in this store; `EMAIL_DELIVERY_NOT_RETRYABLE` → `BusinessRuleError` (422), the
+     * delivery is not `failed` or `blocked`, it is a gift card's email (its code is not kept), or
+     * another retry of it started first.
+     *
+     * @effect irreversible
+     * @permission UpdateSettings
+     */
+    retry(id: string, options?: Call): Promise<EmailDelivery>;
+}
+export interface DocumentEmailsModule {
+    deliveries: EmailDeliveriesModule;
+    /**
+     * Render `templateType` with sample data and send it, now, through the store's own email
+     * gateway, to `recipientEmail`. It is real mail. The send writes no delivery row.
+     *
+     * **Coded refusals:** `INVALID_TEST_EMAIL_RECIPIENT` and `INVALID_TEST_EMAIL_TEMPLATE` →
+     * `ValidationError` (400), before anything is sent; `TEST_EMAIL_SEND_FAILED` →
+     * `BusinessRuleError` (422), the gateway did not take it (the message names the SMTP step or
+     * the provider's code, never the server's own words).
+     *
+     * @effect irreversible
+     * @permission UpdateSettings
+     */
+    sendTest(input: SendTestEmailInput, options?: Call): Promise<void>;
+}
+export declare const EMAIL_DELIVERIES_QUERY = "\n  query AdminEmailDeliveries($options: EmailDeliveryLogListOptions) {\n    emailDeliveryLogs(options: $options) {\n      items { \n  id\n  templateType\n  notificationEvent\n  recipientTo\n  recipientCc\n  recipientBcc\n  subject\n  gatewayId\n  status\n  attempt\n  messageId\n  error\n  durationMs\n  metadata\n  createdAt\n }\n      totalItems\n    }\n  }\n";
+export declare const EMAIL_DELIVERY_STATS_QUERY = "\n  query AdminEmailDeliveryStats($options: EmailDeliveryStatsOptions) {\n    emailDeliveryStats(options: $options) {\n      sent\n      failed\n      blocked\n      pending\n    }\n  }\n";
+/** The store's whole log, without the filter argument an older engine does not know. */
+export declare const EMAIL_DELIVERY_STATS_ALL_QUERY = "\n  query AdminEmailDeliveryStatsAll {\n    emailDeliveryStats {\n      sent\n      failed\n      blocked\n      pending\n    }\n  }\n";
+/** How many deliveries match: the older engine's way to count over a filter. */
+export declare const EMAIL_DELIVERY_COUNT_QUERY = "\n  query AdminEmailDeliveryCount($options: EmailDeliveryLogListOptions) {\n    emailDeliveryLogs(options: $options) {\n      totalItems\n    }\n  }\n";
+export declare const RETRY_EMAIL_DELIVERY_MUTATION = "\n  mutation AdminRetryEmailDelivery($id: ID!) {\n    retryEmailDelivery(id: $id) { \n  id\n  templateType\n  notificationEvent\n  recipientTo\n  recipientCc\n  recipientBcc\n  subject\n  gatewayId\n  status\n  attempt\n  messageId\n  error\n  durationMs\n  metadata\n  createdAt\n }\n  }\n";
+export declare const SEND_TEST_EMAIL_MUTATION = "\n  mutation AdminSendTestEmail($templateType: String!, $recipientEmail: String!) {\n    sendTestEmail(templateType: $templateType, recipientEmail: $recipientEmail)\n  }\n";
+export declare function createDocumentEmailsModule(transport: Transport): DocumentEmailsModule;

package/dist/documents/emails.js

@@ -0,0 +1,220 @@
+/**
+ * `admin.documents.emails` — the store's email delivery log, its counts, a retry of one delivery,
+ * and a test send of a template (headless spec §9.2 `documents`, "email sends"; W10-103).
+ *
+ * Every call needs `UpdateSettings` on the active store. A delivery's recipients, subject, error
+ * and metadata are customer data: below `customerData: full` (an app installation) they read
+ * `''`/`null` and the row carries `redacted: true`.
+ */
+import { pageFromVendureList, readOffsetCursor, ValidationError, } from '@sixtyninecommerce/core';
+import { assertInstant } from '../catalog/types.js';
+import { customerDataField } from '../customers/wire.js';
+const DELIVERY_FIELDS = /* GraphQL */ `
+  id
+  templateType
+  notificationEvent
+  recipientTo
+  recipientCc
+  recipientBcc
+  subject
+  gatewayId
+  status
+  attempt
+  messageId
+  error
+  durationMs
+  metadata
+  createdAt
+`;
+export const EMAIL_DELIVERIES_QUERY = /* GraphQL */ `
+  query AdminEmailDeliveries($options: EmailDeliveryLogListOptions) {
+    emailDeliveryLogs(options: $options) {
+      items { ${DELIVERY_FIELDS} }
+      totalItems
+    }
+  }
+`;
+export const EMAIL_DELIVERY_STATS_QUERY = /* GraphQL */ `
+  query AdminEmailDeliveryStats($options: EmailDeliveryStatsOptions) {
+    emailDeliveryStats(options: $options) {
+      sent
+      failed
+      blocked
+      pending
+    }
+  }
+`;
+/** The store's whole log, without the filter argument an older engine does not know. */
+export const EMAIL_DELIVERY_STATS_ALL_QUERY = /* GraphQL */ `
+  query AdminEmailDeliveryStatsAll {
+    emailDeliveryStats {
+      sent
+      failed
+      blocked
+      pending
+    }
+  }
+`;
+/** How many deliveries match: the older engine's way to count over a filter. */
+export const EMAIL_DELIVERY_COUNT_QUERY = /* GraphQL */ `
+  query AdminEmailDeliveryCount($options: EmailDeliveryLogListOptions) {
+    emailDeliveryLogs(options: $options) {
+      totalItems
+    }
+  }
+`;
+export const RETRY_EMAIL_DELIVERY_MUTATION = /* GraphQL */ `
+  mutation AdminRetryEmailDelivery($id: ID!) {
+    retryEmailDelivery(id: $id) { ${DELIVERY_FIELDS} }
+  }
+`;
+export const SEND_TEST_EMAIL_MUTATION = /* GraphQL */ `
+  mutation AdminSendTestEmail($templateType: String!, $recipientEmail: String!) {
+    sendTestEmail(templateType: $templateType, recipientEmail: $recipientEmail)
+  }
+`;
+/** The engine's default page; the SDK states it so the cursor arithmetic knows the size. */
+const DELIVERIES_PAGE_SIZE = 50;
+function toDelivery(row) {
+    return {
+        id: String(row.id),
+        templateType: row.templateType,
+        notificationEvent: row.notificationEvent,
+        recipientTo: row.recipientTo,
+        recipientCc: row.recipientCc ?? null,
+        recipientBcc: row.recipientBcc ?? null,
+        subject: row.subject,
+        gatewayId: row.gatewayId ?? null,
+        status: row.status,
+        attempt: row.attempt,
+        messageId: row.messageId ?? null,
+        error: row.error ?? null,
+        durationMs: row.durationMs ?? null,
+        metadata: row.metadata ?? null,
+        createdAt: row.createdAt,
+    };
+}
+/** The engine's filter input: only the keys the caller set, so an older engine still answers. */
+function wireFilter(filter) {
+    if (filter === undefined)
+        return {};
+    if (filter === null || typeof filter !== 'object' || Array.isArray(filter)) {
+        throw new ValidationError({
+            code: 'EMAIL_DELIVERY_FILTER_INVALID',
+            message: 'The delivery filter must be an object.',
+            status: 400,
+            service: 'vendure',
+        });
+    }
+    assertInstant('createdFrom', filter.createdFrom);
+    assertInstant('createdBefore', filter.createdBefore);
+    return {
+        ...(filter.status ? { status: filter.status } : {}),
+        ...(filter.templateType ? { templateType: filter.templateType } : {}),
+        ...(filter.createdFrom ? { dateFrom: filter.createdFrom } : {}),
+        ...(filter.createdBefore ? { dateBefore: filter.createdBefore } : {}),
+    };
+}
+/**
+ * The engine refused the document over a field or argument it does not know: an engine from
+ * before this release (no `dateBefore`, no `emailDeliveryStats(options:)`). The dashboard can be
+ * live before vendure-server (`.claude/rules/backend.md`, additive rule), so the module falls
+ * back to the older spelling instead of failing. Matched on the names this module added, so a
+ * real refusal is never retried.
+ */
+function isOlderEngineRejection(error) {
+    if (!(error instanceof ValidationError) || error.service !== 'vendure')
+        return false;
+    // Apollo answers a document that fails validation (an unknown type or argument: the stats
+    // filter) with HTTP 400, which the transport reports as BAD_REQUEST without the engine's
+    // words; an unknown input field (dateBefore) is a variable coercion error at HTTP 200 and
+    // keeps them. Only ever asked about the documents this module added the names to.
+    return (error.code === 'BAD_REQUEST' ||
+        error.code === 'GRAPHQL_VALIDATION_FAILED' ||
+        /dateBefore|EmailDeliveryStatsOptions|Unknown argument "options"/.test(error.message));
+}
+/** The old inclusive spelling of an exclusive end: one millisecond before it. */
+function legacyFilter(filter) {
+    const { dateBefore, ...rest } = filter;
+    if (typeof dateBefore !== 'string')
+        return rest;
+    return { ...rest, dateTo: new Date(Date.parse(dateBefore) - 1).toISOString() };
+}
+const COUNTED_STATUSES = ['sent', 'failed', 'blocked', 'pending'];
+export function createDocumentEmailsModule(transport) {
+    /** Latched once the engine proved it predates `dateBefore` (one refused request per client). */
+    let olderEngine = false;
+    const listPage = async (skip, take, filter, options) => {
+        const read = (wire) => customerDataField(transport, EMAIL_DELIVERIES_QUERY, 'emailDeliveryLogs', { options: { ...wire, take, skip } }, options);
+        let answer;
+        if (olderEngine || !('dateBefore' in filter)) {
+            answer = await read(olderEngine ? legacyFilter(filter) : filter);
+        }
+        else {
+            try {
+                answer = await read(filter);
+            }
+            catch (error) {
+                if (!isOlderEngineRejection(error))
+                    throw error;
+                olderEngine = true;
+                answer = await read(legacyFilter(filter));
+            }
+        }
+        const { value, mark } = answer;
+        const items = value.items.map((row) => mark(toDelivery(row)));
+        // Each following page re-sends the same filter and per-call options.
+        return pageFromVendureList({ items, totalItems: value.totalItems }, skip, take, (cursor) => listPage(readOffsetCursor(cursor), take, filter, options));
+    };
+    return {
+        deliveries: {
+            async list(filter, options) {
+                const wire = wireFilter(filter);
+                const take = options?.limit ?? DELIVERIES_PAGE_SIZE;
+                const skip = options?.after === undefined ? 0 : readOffsetCursor(options.after);
+                return listPage(skip, take, wire, options);
+            },
+            async stats(filter, options) {
+                const { status: _status, ...counted } = wireFilter(filter);
+                if (Object.keys(counted).length === 0) {
+                    const data = await transport.graphql({ api: 'admin', query: EMAIL_DELIVERY_STATS_ALL_QUERY }, options);
+                    return data.emailDeliveryStats;
+                }
+                if (!olderEngine) {
+                    try {
+                        const data = await transport.graphql({ api: 'admin', query: EMAIL_DELIVERY_STATS_QUERY, variables: { options: counted } }, options);
+                        return data.emailDeliveryStats;
+                    }
+                    catch (error) {
+                        if (!isOlderEngineRejection(error))
+                            throw error;
+                        olderEngine = true;
+                    }
+                }
+                // An older engine counts only the whole log: count each status over the filter through
+                // the list's totals instead (one row read per status).
+                const totals = await Promise.all(COUNTED_STATUSES.map(async (status) => {
+                    const data = await transport.graphql({
+                        api: 'admin',
+                        query: EMAIL_DELIVERY_COUNT_QUERY,
+                        variables: { options: { ...legacyFilter(counted), status, take: 1, skip: 0 } },
+                    }, options);
+                    return data.emailDeliveryLogs.totalItems;
+                }));
+                const [sent = 0, failed = 0, blocked = 0, pending = 0] = totals;
+                return { sent, failed, blocked, pending };
+            },
+            async retry(id, options) {
+                const { value, mark } = await customerDataField(transport, RETRY_EMAIL_DELIVERY_MUTATION, 'retryEmailDelivery', { id }, options);
+                return mark(toDelivery(value));
+            },
+        },
+        async sendTest(input, options) {
+            await transport.graphql({
+                api: 'admin',
+                query: SEND_TEST_EMAIL_MUTATION,
+                variables: { templateType: input.templateType, recipientEmail: input.recipientEmail },
+            }, options);
+        },
+    };
+}

package/dist/documents/index.d.ts

@@ -1,6 +1,7 @@
 import { type Page, type Transport } from '@sixtyninecommerce/core';
 import type { Call, ListOptions } from '../types.js';
 import { type ArDocumentsModule } from './ar.js';
+import { type DocumentEmailsModule } from './emails.js';
 import { decodePdf } from './pdf.js';
 export { decodePdf };
 /**
@@ -402,6 +403,16 @@ export interface InvoiceCorrectionInput {
     refundPaymentId?: string;
     /** RETAIL only: move the credited amount to the customer's account instead (`accountCredit`). */
     creditToAccount?: boolean;
+    /**
+     * `commitCorrection` with `creditToAccount` in a store whose book is store credit (the plan's
+     * `accountCredit.book` `STORE_CREDIT`): whether the customer expressly agreed to store credit
+     * instead of a refund to their payment (EU consumer law, CRD art. 13(1)), as staff recorded it.
+     * The move records it on its ledger entries (`StoredValueEntry.customerAgreed`); never a
+     * condition, nothing is refused for it. The plan ignores it and its `planHash` never sees it, so
+     * leave it out of `planCorrection` (an engine before the field, incentives sprint 8 PR 6a,
+     * refuses any call that gives it) and add it to the commit's input.
+     */
+    customerAgreed?: boolean;
     /**
      * Details wrong only: the order's payment term in days. The corrected invoice is reissued
      * under it and the order keeps it (its `paymentTermsDays`; its payment condition is cleared).
@@ -1591,6 +1602,8 @@ export interface DocumentsModule {
     extensions: DocumentExtensionsModule;
     /** The accounts-receivable ledger's documents: AR invoices, statements and credit notes. */
     ar: ArDocumentsModule;
+    /** The store's email delivery log (counts, a retry) and a template's test send. */
+    emails: DocumentEmailsModule;
 }
 export declare const GENERATE_INVOICE_MUTATION = "\n  mutation GenerateInvoice(\n    $orderId: ID!\n    $invoicedOn: String!\n    $languageCode: String\n    $note: String\n    $extensions: [DocumentExtensionInput!]\n  ) {\n    generateInvoice(\n      orderId: $orderId\n      invoicedOn: $invoicedOn\n      languageCode: $languageCode\n      note: $note\n      extensions: $extensions\n    ) { \n  id\n  invoiceNumber\n  invoicedOn\n  orderId\n  languageCode\n  storageKey\n  totalWithTax\n  currencyCode\n  note\n  voidedOn\n  reversedByCreditNoteId\n  supersededByInvoiceId\n  reissueOfInvoiceId\n  kind\n  supplementsInvoiceId\n  lines { \n  description\n  sku\n  orderLineId\n  quantity\n  unitPriceNet\n  unitPriceWithTax\n  taxRate\n  lineTotalNet\n  lineTotalWithTax\n  unitPriceBasis\n }\n  numberingProvider\n  amountPaid\n  amountDue\n  createdAt\n }\n  }\n";
 export declare const GENERATE_PACKING_SLIP_MUTATION = "\n  mutation GeneratePackingSlip(\n    $fulfillmentId: ID!\n    $languageCode: String\n    $extensions: [DocumentExtensionInput!]\n  ) {\n    generatePackingSlip(\n      fulfillmentId: $fulfillmentId\n      languageCode: $languageCode\n      extensions: $extensions\n    ) { \n  id\n  packingSlipNumber\n  fulfillmentId\n  languageCode\n  storageKey\n  createdAt\n }\n  }\n";

package/dist/documents/index.js

@@ -1,6 +1,7 @@
 import { createPage, idempotencyKey as mintIdempotencyKey, pageFromVendureList, readOffsetCursor, ValidationError, } from '@sixtyninecommerce/core';
 import { storeCreditAware } from '../payments/store-credit-fields.js';
 import { createArDocumentsModule } from './ar.js';
+import { createDocumentEmailsModule } from './emails.js';
 import { decodePdf } from './pdf.js';
 // Also what `documents.ar.pdf` decodes with (headless W10-30).
 export { decodePdf };
@@ -903,6 +904,7 @@ export function createDocumentsModule(transport) {
             },
         },
         ar: createArDocumentsModule(transport),
+        emails: createDocumentEmailsModule(transport),
         extensions: {
             async list(options) {
                 const data = await transport.graphql({ api: 'admin', query: DOCUMENT_EXTENSIONS_QUERY }, options);

package/dist/fulfillments/create.d.ts

@@ -162,6 +162,6 @@ export interface FulfillmentCreateMethods {
      */
     profileChargePreview(input: FulfillmentProfileChargePreviewInput, options?: Call): Promise<FulfillmentProfileChargePreview>;
 }
-export declare const CREATE_WAREHOUSE_FULFILLMENTS_MUTATION = "\n  mutation CreateWarehouseFulfillments(\n    $input: CreateWarehouseFulfillmentsInput!\n    $idempotencyKey: String\n  ) {\n    createWarehouseFulfillments(input: $input, idempotencyKey: $idempotencyKey) {\n      __typename\n      ... on WarehouseCreateResult {\n        created\n        failed\n        results {\n          index\n          fulfillment {\n            \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n          }\n          error {\n            code\n            message\n            field\n          }\n          claimError {\n            code\n            message\n            field\n          }\n        }\n      }\n      ... on WarehouseError {\n        errorCode\n        code\n        message\n        field\n      }\n    }\n  }\n";
+export declare const CREATE_WAREHOUSE_FULFILLMENTS_MUTATION = "\n  mutation CreateWarehouseFulfillments(\n    $input: CreateWarehouseFulfillmentsInput!\n    $idempotencyKey: String\n  ) {\n    createWarehouseFulfillments(input: $input, idempotencyKey: $idempotencyKey) {\n      __typename\n      ... on WarehouseCreateResult {\n        created\n        failed\n        results {\n          index\n          fulfillment {\n            \n  id\n  state\n  handlerCode\n  method\n  mode\n  trackingCode\n  stockLocationId\n  stockLocationName\n  dropShipSupplierName\n  createdAt\n  stateChangedAt\n  overdue\n  claimedBy {\n    id\n    name\n  }\n  claimedAt\n  packedAt\n  bookingStatus\n  bookingError\n  parcels {\n    weightGrams\n    lengthMm\n    widthMm\n    heightMm\n  }\n  orders {\n    id\n    code\n    poNumber\n    orderNotes\n    requestedDeliveryDate\n    deliveryDue\n    paymentBadge\n    hold {\n      reason\n      note\n    }\n  }\n  customer {\n    id\n    name\n    phone\n  }\n  shippingAddress {\n    \n  fullName\n  company\n  streetLine1\n  streetLine2\n  city\n  province\n  postalCode\n  countryCode\n\n  }\n  lineCount\n  unitCount\n\n          }\n          error {\n            code\n            message\n            field\n          }\n          claimError {\n            code\n            message\n            field\n          }\n        }\n      }\n      ... on WarehouseError {\n        errorCode\n        code\n        message\n        field\n      }\n    }\n  }\n";
 export declare const FULFILLMENT_PROFILE_CHARGE_PREVIEW_QUERY = "\n  query FulfillmentProfileChargePreview($input: FulfillmentProfileChargePreviewInput!) {\n    fulfillmentProfileChargePreview(input: $input) {\n      profileName\n      currencyCode\n      minOrder\n      selectedNet\n      shortfall\n      deliveryCharge\n      deliveryChargeIncludesTax\n      settled\n      handedOver\n    }\n  }\n";
 export declare function createFulfillmentCreateMethods(transport: Transport): FulfillmentCreateMethods;

package/dist/fulfillments/create.js

@@ -9,7 +9,7 @@
  * 400, never a 422). Each group's own refusal is data in `results[].error`.
  */
 import { idempotencyKey as mintIdempotencyKey, ValidationError, } from '@sixtyninecommerce/core';
-import { assertId, FULFILLMENT_FIELDS, invalid, isWarehouseErrorMember, toFulfillment, toRefusal, warehouseRefusalError, withAttemptKey, } from './warehouse.js';
+import { assertId, dropShipSupplierAware, FULFILLMENT_FIELDS, invalid, isWarehouseErrorMember, toFulfillment, toRefusal, warehouseRefusalError, withAttemptKey, } from './warehouse.js';
 export const CREATE_WAREHOUSE_FULFILLMENTS_MUTATION = /* GraphQL */ `
   mutation CreateWarehouseFulfillments(
     $input: CreateWarehouseFulfillmentsInput!
@@ -134,12 +134,15 @@ function assertPreviewInput(input) {
     }
 }
 export function createFulfillmentCreateMethods(transport) {
+    // The create answers the warehouse's fulfilment fields, `dropShipSupplierName` among them: an
+    // engine before purchase-orders step 5.5 refuses that field before the mutation runs.
+    const engine = dropShipSupplierAware(transport);
     return {
         async create(input, options) {
             assertCreateInput(input);
             const key = options?.idempotencyKey ?? mintIdempotencyKey();
             try {
-                const data = await transport.graphql({
+                const data = await engine.graphql({
                     api: 'admin',
                     query: CREATE_WAREHOUSE_FULFILLMENTS_MUTATION,
                     variables: {