@sixtyninecommerce/admin 0.10.0 → 0.12.0

package/dist/integrations/afas-actions.d.ts

@@ -0,0 +1,234 @@
+import { type Page, type Transport } from '@sixtyninecommerce/core';
+import type { Call } from '../types.js';
+import type { AfasAddressPreview, AfasCustomerBalance, AfasCustomerPreview, AfasCustomerSearchFilter, AfasDebtorLink, AfasDirectInvoiceResult, AfasOrderPreview, AfasOrderState, AfasPushResult, AfasSettleResult, AfasStockTransferInvoiceResult, AfasStockTransferState, CreateAfasDirectInvoiceInput, CreateAfasStockTransferInvoiceInput, SyncAfasCustomerInput, SyncAfasOrderInput } from './afas-types.js';
+/** The most debtors `customers.search` asks AFAS for; the default is 10. */
+export declare const AFAS_CUSTOMER_SEARCH_LIMIT = 50;
+/**
+ * An order's AFAS documents (`admin.integrations.afas.orders`). AFAS keeps every document the
+ * platform writes into the store's administration: nothing here can be undone from the
+ * platform, only in AFAS by the store's accountant.
+ *
+ * Every method refuses an order the store does not hold with `ENTITY_NOT_FOUND`
+ * (`NotFoundError`, 404), and a store whose AFAS is not saved and switched on with
+ * `AFAS_NOT_CONFIGURED` (`BusinessRuleError`, 422).
+ */
+export interface AfasOrdersModule {
+    /**
+     * The AFAS sales order the order was pushed as, read live from AFAS; `null` when it was not
+     * pushed as one, or AFAS answered nothing.
+     *
+     * @effect read
+     * @permission UpdateOrder
+     */
+    preview(orderId: string, options?: Call): Promise<AfasOrderPreview | null>;
+    /**
+     * The order's AFAS state, read from the platform (no AFAS call): which path it is on, what
+     * AFAS answered, and whether its state lets it be pushed (`stateAllowsPush`,
+     * `stateAllowsPrepaidSettlement`), so a screen offers only what the engine accepts.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    state(orderId: string, options?: Call): Promise<AfasOrderState>;
+    /**
+     * Push the order to AFAS as a sales order (`FbSales`), with its customer: an unlinked
+     * customer is linked to `customerAfasVrId`, or created as a new AFAS debtor when it is `null`.
+     * This writes into the store's AFAS administration and cannot be undone from the platform.
+     *
+     * Refused, with nothing sent to AFAS:
+     * - `AFAS_ORDER_STATE_BLOCKS_PUSH` (`BusinessRuleError`, 422): the order is in `Draft`,
+     *   `AddingItems`, `ArrangingPayment` (its payment is still being arranged) or `Cancelled`;
+     * - `AFAS_ADMINISTRATION_NOT_CONFIGURED` (422): the store's connection names no administration;
+     * - `SANDBOX_PUSH_REFUSED` (422): a sandbox store never writes to AFAS.
+     *
+     * What AFAS itself refuses, and the path rules (an order already a direct invoice, or locked
+     * as invoiced), answer `success: false` with the reason in `error` (and `errorCode` when it
+     * has one), not a throw.
+     *
+     * `options.idempotencyKey` is accepted and sent, but the engine does not store it yet: a
+     * repeat runs again (an order already pushed answers `alreadySynced`).
+     *
+     * @effect irreversible
+     * @permission UpdateOrder
+     */
+    sync(orderId: string, input?: SyncAfasOrderInput, options?: Call): Promise<AfasPushResult>;
+    /**
+     * Settle the order's AFAS sales order (`FbSettleOrder`): AFAS marks it "Afgehandeld" for the
+     * accountant to invoice; it creates no invoice. This writes into the store's AFAS
+     * administration and cannot be undone from the platform.
+     *
+     * Refused with `AFAS_ADMINISTRATION_NOT_CONFIGURED` or `SANDBOX_PUSH_REFUSED` (422). An
+     * order with no sales order, already settled, or a direct invoice answers `success: false`
+     * with the reason in `error`, as does a refusal from AFAS.
+     *
+     * `options.idempotencyKey` is accepted and sent, but the engine does not store it yet.
+     *
+     * @effect irreversible
+     * @permission UpdateOrder
+     */
+    settle(orderId: string, options?: Call): Promise<AfasSettleResult>;
+    /**
+     * Create a direct invoice for the order in AFAS (`FbDirectInvoice`): AFAS numbers a packing
+     * slip and an invoice in one go. The customer is resolved as in {@link sync}. With
+     * `settleAsZeroValue` it is a settlement from prepaid credit instead: a €0 document that books
+     * no receivable and keeps the lines, so AFAS deducts the stock. This writes into the store's
+     * AFAS administration and cannot be undone from the platform. The engine refuses a second
+     * direct invoice for the order, so a repeat writes nothing twice.
+     *
+     * Refused, with nothing sent to AFAS:
+     * - `AFAS_ORDER_STATE_BLOCKS_PUSH` (422): the order is in `Draft`, `AddingItems`,
+     *   `ArrangingPayment` or `Cancelled`; a settlement from prepaid is allowed in
+     *   `ArrangingPayment`, since it is one way such an order gets paid;
+     * - `AFAS_ADMINISTRATION_NOT_CONFIGURED`, `SANDBOX_PUSH_REFUSED` (422).
+     *
+     * An order already on an AFAS path, a store whose invoices AFAS numbers (use the invoice
+     * door), and a refusal from AFAS answer `success: false` with the reason in `error`.
+     *
+     * `options.idempotencyKey` is accepted and sent, but the engine does not store it yet.
+     *
+     * @effect irreversible
+     * @permission UpdateOrder
+     */
+    createDirectInvoice(orderId: string, input?: CreateAfasDirectInvoiceInput, options?: Call): Promise<AfasDirectInvoiceResult>;
+    /**
+     * The order's AFAS invoice as PDF bytes, read live from AFAS; `null` when the order has no
+     * AFAS invoice number, the store has no invoice report connector, or AFAS answered nothing.
+     *
+     * @effect read
+     * @permission ReadOrder
+     */
+    invoicePdf(orderId: string, options?: Call): Promise<Uint8Array | null>;
+}
+/**
+ * A customer's AFAS debtor (`admin.integrations.afas.customers`). Every method but `balance`
+ * refuses a store whose AFAS is not saved and switched on with `AFAS_NOT_CONFIGURED`
+ * (`BusinessRuleError`, 422), and a customer the store does not hold with `ENTITY_NOT_FOUND`
+ * (`NotFoundError`, 404).
+ */
+export interface AfasCustomersModule {
+    /**
+     * The AFAS debtor the customer is linked to, read live; `null` when it is not linked, or AFAS
+     * answered nothing.
+     *
+     * @effect read
+     * @permission UpdateCustomer
+     */
+    preview(customerId: string, options?: Call): Promise<AfasCustomerPreview | null>;
+    /**
+     * The AFAS delivery address one of the customer's addresses is linked to, read live; `null`
+     * when it is not linked.
+     *
+     * @effect read
+     * @permission UpdateCustomer
+     */
+    previewAddress(addressId: string, options?: Call): Promise<AfasAddressPreview | null>;
+    /**
+     * AFAS debtors matching an email, a phone number or a name, read live; most specific first.
+     * One page: AFAS answers at most `limit` (default 10, at most
+     * {@link AFAS_CUSTOMER_SEARCH_LIMIT}). A filter with nothing to look for answers an empty page.
+     * `AFAS_READ_FAILED` (`BusinessRuleError`, 422) when AFAS could not be read at all; the message
+     * says what to fix.
+     *
+     * @effect read
+     * @permission UpdateCustomer
+     */
+    search(filter: AfasCustomerSearchFilter, options?: Call): Promise<Page<AfasCustomerPreview>>;
+    /**
+     * Push the customer to AFAS: link it to `afasVrId` and update that debtor from the customer,
+     * or create a new debtor when `afasVrId` is `null` or absent. This writes into the store's AFAS
+     * administration and cannot be undone from the platform. To attach a customer to an existing
+     * debtor WITHOUT changing the debtor, use {@link link}.
+     *
+     * Refused with `AFAS_ADMINISTRATION_NOT_CONFIGURED` or `SANDBOX_PUSH_REFUSED` (422),
+     * nothing sent. A refusal from AFAS answers `success: false` with the reason in `error`.
+     *
+     * The engine takes no idempotency key for it yet, so `options.idempotencyKey` is not sent: a
+     * repeat runs again.
+     *
+     * @effect irreversible
+     * @permission UpdateCustomer
+     */
+    sync(customerId: string, input?: SyncAfasCustomerInput, options?: Call): Promise<AfasPushResult>;
+    /**
+     * Link the customer to an existing AFAS debtor without writing anything to AFAS (the debtor's
+     * own data stays as it is), and read its payment condition. `true` when the link changed,
+     * `false` when it was already in place. Refused `AFAS_LINK_INVALID` (400) for a blank
+     * `afasVrId`; `INVALID_AFAS_INPUT` (`ValidationError`, 400) before sending when it is not a
+     * string; `AFAS_ADMINISTRATION_NOT_CONFIGURED` (422).
+     *
+     * @effect write
+     * @permission UpdateCustomer
+     */
+    link(customerId: string, debtor: AfasDebtorLink, options?: Call): Promise<boolean>;
+    /**
+     * Clear the customer's link to its AFAS debtor without writing anything to AFAS. `true` when
+     * a link was cleared, `false` when there was none. Refused
+     * `AFAS_ADMINISTRATION_NOT_CONFIGURED` (422).
+     *
+     * @effect write
+     * @permission UpdateCustomer
+     */
+    unlink(customerId: string, options?: Call): Promise<boolean>;
+    /**
+     * The customer's outstanding AFAS balance, read live. Never refuses for AFAS: an unreachable
+     * AFAS answers `available: false`, AFAS off or an unlinked customer `linked: false`.
+     *
+     * @effect read
+     * @permission ReadCustomer
+     */
+    balance(customerId: string, options?: Call): Promise<AfasCustomerBalance>;
+}
+/** A stock transfer's AFAS document (`admin.integrations.afas.stockTransfers`). */
+export interface AfasStockTransfersModule {
+    /**
+     * The transfer's AFAS state, read from the platform (no AFAS call): whether it was sent, which
+     * way its stock moves and on which warehouse, and why it cannot be sent (`blockReason`).
+     *
+     * @effect read
+     * @permission ReadStockLocation
+     */
+    state(stockTransferId: string, options?: Call): Promise<AfasStockTransferState>;
+    /**
+     * Send the transfer to AFAS as a €0 direct invoice booked against `afasDebtorId`, so AFAS
+     * moves the stock and books no receivable. This writes into the store's AFAS administration
+     * and cannot be undone from the platform. Idempotent per transfer: sending one again answers
+     * `alreadyPushed` and writes nothing.
+     *
+     * What blocks it (`state().blockReason`) and a refusal from AFAS answer `success: false` with
+     * the reason in `error`. `INVALID_AFAS_INPUT` (`ValidationError`, 400) before sending when
+     * `afasDebtorId` is not a non-empty string.
+     *
+     * `options.idempotencyKey` is accepted and sent, but the engine does not store it yet; the
+     * per-transfer rule above is what makes a repeat safe.
+     *
+     * @effect irreversible
+     * @permission UpdateStockLocation
+     */
+    createInvoice(stockTransferId: string, input: CreateAfasStockTransferInvoiceInput, options?: Call): Promise<AfasStockTransferInvoiceResult>;
+}
+export declare const PREVIEW_AFAS_ORDER_QUERY = "\n  query PreviewAfasOrder($orderId: ID!) {\n    previewAfasOrder(orderId: $orderId) {\n      orNu\n      debtorBcCo\n      reference\n      orderDate\n      totalAmount\n      currency\n      status\n      settled\n    }\n  }\n";
+export declare const AFAS_ORDER_STATE_QUERY = "\n  query AfasOrderState($orderId: ID!) {\n    afasOrderState(orderId: $orderId) {\n      path\n      afasSalesOrderId\n      afasSettled\n      afasDirectInvoiceOrNu\n      afasInvoiceNumber\n      afasInvoiceDate\n      hasPdfReport\n      stateAllowsPush\n      stateAllowsPrepaidSettlement\n    }\n  }\n";
+export declare const SYNC_ORDER_TO_AFAS_MUTATION = "\n  mutation SyncOrderToAfas($input: SyncOrderToAfasInput!, $idempotencyKey: String) {\n    syncOrderToAfas(input: $input, idempotencyKey: $idempotencyKey) { \n  success\n  locked\n  alreadySynced\n  externalRef\n  message\n  error\n  errorCode\n }\n  }\n";
+export declare const SETTLE_AFAS_ORDER_MUTATION = "\n  mutation SettleAfasOrder($orderId: ID!, $idempotencyKey: String) {\n    settleAfasOrder(orderId: $orderId, idempotencyKey: $idempotencyKey) {\n      success\n      locked\n      afasSettled\n      error\n    }\n  }\n";
+export declare const CREATE_AFAS_DIRECT_INVOICE_MUTATION = "\n  mutation CreateAfasDirectInvoice($input: CreateAfasDirectInvoiceInput!, $idempotencyKey: String) {\n    createAfasDirectInvoice(input: $input, idempotencyKey: $idempotencyKey) {\n      success\n      afasDirectInvoiceOrNu\n      afasInvoiceNumber\n      afasInvoiceDate\n      error\n      errorCode\n    }\n  }\n";
+export declare const AFAS_INVOICE_PDF_QUERY = "\n  query AfasInvoicePdf($orderId: ID!) {\n    afasInvoicePdf(orderId: $orderId)\n  }\n";
+export declare const PREVIEW_AFAS_CUSTOMER_QUERY = "\n  query PreviewAfasCustomer($customerId: ID!) {\n    previewAfasCustomer(customerId: $customerId) { \n  bcCo\n  debtorId\n  name\n  kind\n  email\n  phone\n  vatNumber\n  kvkNumber\n  addressLine1\n  addressLine3\n  addressLine4\n  currency\n  paymentCondition\n  blocked\n }\n  }\n";
+export declare const PREVIEW_AFAS_ADDRESS_QUERY = "\n  query PreviewAfasAddress($addressId: ID!) {\n    previewAfasAddress(addressId: $addressId) {\n      adId\n      bcCo\n      street\n      houseNumber\n      postalCode\n      city\n      countryCode\n    }\n  }\n";
+export declare const SEARCH_AFAS_CUSTOMERS_QUERY = "\n  query SearchAfasCustomers($email: String, $phone: String, $name: String, $limit: Int) {\n    searchAfasCustomers(email: $email, phone: $phone, name: $name, limit: $limit) {\n      \n  bcCo\n  debtorId\n  name\n  kind\n  email\n  phone\n  vatNumber\n  kvkNumber\n  addressLine1\n  addressLine3\n  addressLine4\n  currency\n  paymentCondition\n  blocked\n\n    }\n  }\n";
+export declare const SYNC_CUSTOMER_TO_AFAS_MUTATION = "\n  mutation SyncCustomerToAfas($input: SyncCustomerToAfasInput!) {\n    syncCustomerToAfas(input: $input) { \n  success\n  locked\n  alreadySynced\n  externalRef\n  message\n  error\n  errorCode\n }\n  }\n";
+export declare const LINK_CUSTOMER_TO_AFAS_MUTATION = "\n  mutation LinkCustomerToAfas(\n    $customerId: ID!\n    $afasVrId: String!\n    $afasBcCo: String\n    $afasKind: AfasDebtorKind\n  ) {\n    linkCustomerToAfas(\n      customerId: $customerId\n      afasVrId: $afasVrId\n      afasBcCo: $afasBcCo\n      afasKind: $afasKind\n    )\n  }\n";
+export declare const UNLINK_CUSTOMER_FROM_AFAS_MUTATION = "\n  mutation UnlinkCustomerFromAfas($customerId: ID!) {\n    unlinkCustomerFromAfas(customerId: $customerId)\n  }\n";
+export declare const AFAS_CUSTOMER_BALANCE_QUERY = "\n  query AfasCustomerBalance($customerId: ID!) {\n    afasCustomerBalance(customerId: $customerId) {\n      linked\n      available\n      balance\n      currencyCode\n      debtorId\n    }\n  }\n";
+/**
+ * Only the current document: every engine in production answers the return fields (a read-only
+ * probe of production's Admin schema, 2026-10-13, headless W10-54), so the older-engine document
+ * without them is gone.
+ */
+export declare const AFAS_STOCK_TRANSFER_STATE_QUERY = "\n  query AfasStockTransferState($stockTransferId: ID!) {\n    afasStockTransferState(stockTransferId: $stockTransferId) {\n      enabled\n      pushed\n      afasDirectInvoiceOrNu\n      afasInvoiceNumber\n      afasDebtorId\n      pushedAt\n      sourceAfasWarehouse\n      destinationAfasWarehouse\n      isReturn\n      stockDirection\n      pushable\n      blockReason\n    }\n  }\n";
+export declare const CREATE_AFAS_STOCK_TRANSFER_INVOICE_MUTATION = "\n  mutation CreateAfasStockTransferInvoice(\n    $input: CreateAfasStockTransferInvoiceInput!\n    $idempotencyKey: String\n  ) {\n    createAfasStockTransferInvoice(input: $input, idempotencyKey: $idempotencyKey) {\n      success\n      alreadyPushed\n      afasDirectInvoiceOrNu\n      afasInvoiceNumber\n      error\n    }\n  }\n";
+export interface AfasActionsModules {
+    orders: AfasOrdersModule;
+    customers: AfasCustomersModule;
+    stockTransfers: AfasStockTransfersModule;
+}
+export declare function createAfasActionsModules(transport: Transport): AfasActionsModules;

package/dist/integrations/afas-actions.js

@@ -0,0 +1,310 @@
+import { createPage, ValidationError } from '@sixtyninecommerce/core';
+import { fieldOf } from '../catalog/types.js';
+import { decodePdf } from '../documents/pdf.js';
+/** The most debtors `customers.search` asks AFAS for; the default is 10. */
+export const AFAS_CUSTOMER_SEARCH_LIMIT = 50;
+const AFAS_CUSTOMER_SEARCH_DEFAULT = 10;
+const PUSH_RESULT_FIELDS = /* GraphQL */ `
+  success
+  locked
+  alreadySynced
+  externalRef
+  message
+  error
+  errorCode
+`;
+const CUSTOMER_PREVIEW_FIELDS = /* GraphQL */ `
+  bcCo
+  debtorId
+  name
+  kind
+  email
+  phone
+  vatNumber
+  kvkNumber
+  addressLine1
+  addressLine3
+  addressLine4
+  currency
+  paymentCondition
+  blocked
+`;
+export const PREVIEW_AFAS_ORDER_QUERY = /* GraphQL */ `
+  query PreviewAfasOrder($orderId: ID!) {
+    previewAfasOrder(orderId: $orderId) {
+      orNu
+      debtorBcCo
+      reference
+      orderDate
+      totalAmount
+      currency
+      status
+      settled
+    }
+  }
+`;
+export const AFAS_ORDER_STATE_QUERY = /* GraphQL */ `
+  query AfasOrderState($orderId: ID!) {
+    afasOrderState(orderId: $orderId) {
+      path
+      afasSalesOrderId
+      afasSettled
+      afasDirectInvoiceOrNu
+      afasInvoiceNumber
+      afasInvoiceDate
+      hasPdfReport
+      stateAllowsPush
+      stateAllowsPrepaidSettlement
+    }
+  }
+`;
+export const SYNC_ORDER_TO_AFAS_MUTATION = /* GraphQL */ `
+  mutation SyncOrderToAfas($input: SyncOrderToAfasInput!, $idempotencyKey: String) {
+    syncOrderToAfas(input: $input, idempotencyKey: $idempotencyKey) { ${PUSH_RESULT_FIELDS} }
+  }
+`;
+export const SETTLE_AFAS_ORDER_MUTATION = /* GraphQL */ `
+  mutation SettleAfasOrder($orderId: ID!, $idempotencyKey: String) {
+    settleAfasOrder(orderId: $orderId, idempotencyKey: $idempotencyKey) {
+      success
+      locked
+      afasSettled
+      error
+    }
+  }
+`;
+export const CREATE_AFAS_DIRECT_INVOICE_MUTATION = /* GraphQL */ `
+  mutation CreateAfasDirectInvoice($input: CreateAfasDirectInvoiceInput!, $idempotencyKey: String) {
+    createAfasDirectInvoice(input: $input, idempotencyKey: $idempotencyKey) {
+      success
+      afasDirectInvoiceOrNu
+      afasInvoiceNumber
+      afasInvoiceDate
+      error
+      errorCode
+    }
+  }
+`;
+export const AFAS_INVOICE_PDF_QUERY = /* GraphQL */ `
+  query AfasInvoicePdf($orderId: ID!) {
+    afasInvoicePdf(orderId: $orderId)
+  }
+`;
+export const PREVIEW_AFAS_CUSTOMER_QUERY = /* GraphQL */ `
+  query PreviewAfasCustomer($customerId: ID!) {
+    previewAfasCustomer(customerId: $customerId) { ${CUSTOMER_PREVIEW_FIELDS} }
+  }
+`;
+export const PREVIEW_AFAS_ADDRESS_QUERY = /* GraphQL */ `
+  query PreviewAfasAddress($addressId: ID!) {
+    previewAfasAddress(addressId: $addressId) {
+      adId
+      bcCo
+      street
+      houseNumber
+      postalCode
+      city
+      countryCode
+    }
+  }
+`;
+export const SEARCH_AFAS_CUSTOMERS_QUERY = /* GraphQL */ `
+  query SearchAfasCustomers($email: String, $phone: String, $name: String, $limit: Int) {
+    searchAfasCustomers(email: $email, phone: $phone, name: $name, limit: $limit) {
+      ${CUSTOMER_PREVIEW_FIELDS}
+    }
+  }
+`;
+export const SYNC_CUSTOMER_TO_AFAS_MUTATION = /* GraphQL */ `
+  mutation SyncCustomerToAfas($input: SyncCustomerToAfasInput!) {
+    syncCustomerToAfas(input: $input) { ${PUSH_RESULT_FIELDS} }
+  }
+`;
+export const LINK_CUSTOMER_TO_AFAS_MUTATION = /* GraphQL */ `
+  mutation LinkCustomerToAfas(
+    $customerId: ID!
+    $afasVrId: String!
+    $afasBcCo: String
+    $afasKind: AfasDebtorKind
+  ) {
+    linkCustomerToAfas(
+      customerId: $customerId
+      afasVrId: $afasVrId
+      afasBcCo: $afasBcCo
+      afasKind: $afasKind
+    )
+  }
+`;
+export const UNLINK_CUSTOMER_FROM_AFAS_MUTATION = /* GraphQL */ `
+  mutation UnlinkCustomerFromAfas($customerId: ID!) {
+    unlinkCustomerFromAfas(customerId: $customerId)
+  }
+`;
+export const AFAS_CUSTOMER_BALANCE_QUERY = /* GraphQL */ `
+  query AfasCustomerBalance($customerId: ID!) {
+    afasCustomerBalance(customerId: $customerId) {
+      linked
+      available
+      balance
+      currencyCode
+      debtorId
+    }
+  }
+`;
+/**
+ * Only the current document: every engine in production answers the return fields (a read-only
+ * probe of production's Admin schema, 2026-10-13, headless W10-54), so the older-engine document
+ * without them is gone.
+ */
+export const AFAS_STOCK_TRANSFER_STATE_QUERY = /* GraphQL */ `
+  query AfasStockTransferState($stockTransferId: ID!) {
+    afasStockTransferState(stockTransferId: $stockTransferId) {
+      enabled
+      pushed
+      afasDirectInvoiceOrNu
+      afasInvoiceNumber
+      afasDebtorId
+      pushedAt
+      sourceAfasWarehouse
+      destinationAfasWarehouse
+      isReturn
+      stockDirection
+      pushable
+      blockReason
+    }
+  }
+`;
+export const CREATE_AFAS_STOCK_TRANSFER_INVOICE_MUTATION = /* GraphQL */ `
+  mutation CreateAfasStockTransferInvoice(
+    $input: CreateAfasStockTransferInvoiceInput!
+    $idempotencyKey: String
+  ) {
+    createAfasStockTransferInvoice(input: $input, idempotencyKey: $idempotencyKey) {
+      success
+      alreadyPushed
+      afasDirectInvoiceOrNu
+      afasInvoiceNumber
+      error
+    }
+  }
+`;
+const invalidInput = (message) => new ValidationError({ code: 'INVALID_AFAS_INPUT', message, status: 400, service: 'vendure' });
+const requireId = (value, name) => {
+    if (typeof value !== 'string' || value === '') {
+        throw invalidInput(`${name} must be a non-empty id.`);
+    }
+    return value;
+};
+const optionalObject = (value, method) => {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw invalidInput(`${method} takes an input object.`);
+    }
+    return value;
+};
+const trimmedOrNull = (value) => value?.trim() || null;
+export function createAfasActionsModules(transport) {
+    const read = (document, field, options, variables = {}) => fieldOf(transport, document, field, variables, options);
+    return {
+        orders: {
+            async preview(orderId, options) {
+                return ((await read(PREVIEW_AFAS_ORDER_QUERY, 'previewAfasOrder', options, { orderId: requireId(orderId, 'orderId') })) ?? null);
+            },
+            async state(orderId, options) {
+                return read(AFAS_ORDER_STATE_QUERY, 'afasOrderState', options, {
+                    orderId: requireId(orderId, 'orderId'),
+                });
+            },
+            async sync(orderId, input, options) {
+                const given = optionalObject(input, 'orders.sync') ?? {};
+                return read(SYNC_ORDER_TO_AFAS_MUTATION, 'syncOrderToAfas', options, {
+                    input: { ...given, orderId: requireId(orderId, 'orderId') },
+                    idempotencyKey: options?.idempotencyKey ?? null,
+                });
+            },
+            async settle(orderId, options) {
+                return read(SETTLE_AFAS_ORDER_MUTATION, 'settleAfasOrder', options, {
+                    orderId: requireId(orderId, 'orderId'),
+                    idempotencyKey: options?.idempotencyKey ?? null,
+                });
+            },
+            async createDirectInvoice(orderId, input, options) {
+                const given = optionalObject(input, 'orders.createDirectInvoice') ?? {};
+                return read(CREATE_AFAS_DIRECT_INVOICE_MUTATION, 'createAfasDirectInvoice', options, {
+                    input: { ...given, orderId: requireId(orderId, 'orderId') },
+                    idempotencyKey: options?.idempotencyKey ?? null,
+                });
+            },
+            async invoicePdf(orderId, options) {
+                const base64 = await read(AFAS_INVOICE_PDF_QUERY, 'afasInvoicePdf', options, { orderId: requireId(orderId, 'orderId') });
+                return base64 ? decodePdf(base64) : null;
+            },
+        },
+        customers: {
+            async preview(customerId, options) {
+                return ((await read(PREVIEW_AFAS_CUSTOMER_QUERY, 'previewAfasCustomer', options, { customerId: requireId(customerId, 'customerId') })) ?? null);
+            },
+            async previewAddress(addressId, options) {
+                return ((await read(PREVIEW_AFAS_ADDRESS_QUERY, 'previewAfasAddress', options, { addressId: requireId(addressId, 'addressId') })) ?? null);
+            },
+            async search(filter, options) {
+                const given = optionalObject(filter, 'customers.search') ?? {};
+                const email = trimmedOrNull(given.email);
+                const phone = trimmedOrNull(given.phone);
+                const name = trimmedOrNull(given.name);
+                const limit = Math.min(Math.max(Math.trunc(given.limit ?? AFAS_CUSTOMER_SEARCH_DEFAULT), 1), AFAS_CUSTOMER_SEARCH_LIMIT);
+                const single = (items) => createPage(items, { nextCursor: null, hasNext: false }, () => {
+                    throw invalidInput('customers.search answers a single page.');
+                });
+                // Nothing to look for: the engine would answer [] after an AFAS round trip.
+                if (!email && !phone && !name)
+                    return single([]);
+                const items = await read(SEARCH_AFAS_CUSTOMERS_QUERY, 'searchAfasCustomers', options, { email, phone, name, limit });
+                return single(items);
+            },
+            async sync(customerId, input, options) {
+                const given = optionalObject(input, 'customers.sync') ?? {};
+                return read(SYNC_CUSTOMER_TO_AFAS_MUTATION, 'syncCustomerToAfas', options, {
+                    input: { ...given, customerId: requireId(customerId, 'customerId') },
+                });
+            },
+            async link(customerId, debtor, options) {
+                const given = optionalObject(debtor, 'customers.link');
+                if (typeof given?.afasVrId !== 'string') {
+                    throw invalidInput('customers.link needs the AFAS debtor code (afasVrId).');
+                }
+                return ((await read(LINK_CUSTOMER_TO_AFAS_MUTATION, 'linkCustomerToAfas', options, {
+                    customerId: requireId(customerId, 'customerId'),
+                    afasVrId: given.afasVrId,
+                    afasBcCo: given.afasBcCo ?? null,
+                    afasKind: given.afasKind ?? null,
+                })) === true);
+            },
+            async unlink(customerId, options) {
+                return ((await read(UNLINK_CUSTOMER_FROM_AFAS_MUTATION, 'unlinkCustomerFromAfas', options, { customerId: requireId(customerId, 'customerId') })) === true);
+            },
+            async balance(customerId, options) {
+                return read(AFAS_CUSTOMER_BALANCE_QUERY, 'afasCustomerBalance', options, { customerId: requireId(customerId, 'customerId') });
+            },
+        },
+        stockTransfers: {
+            async state(stockTransferId, options) {
+                return read(AFAS_STOCK_TRANSFER_STATE_QUERY, 'afasStockTransferState', options, { stockTransferId: requireId(stockTransferId, 'stockTransferId') });
+            },
+            async createInvoice(stockTransferId, input, options) {
+                const given = optionalObject(input, 'stockTransfers.createInvoice');
+                if (typeof given?.afasDebtorId !== 'string' || given.afasDebtorId.trim() === '') {
+                    throw invalidInput('stockTransfers.createInvoice needs the AFAS relation (afasDebtorId).');
+                }
+                return read(CREATE_AFAS_STOCK_TRANSFER_INVOICE_MUTATION, 'createAfasStockTransferInvoice', options, {
+                    input: {
+                        stockTransferId: requireId(stockTransferId, 'stockTransferId'),
+                        afasDebtorId: given.afasDebtorId,
+                    },
+                    idempotencyKey: options?.idempotencyKey ?? null,
+                });
+            },
+        },
+    };
+}