@sixtyninecommerce/admin 0.9.0 → 0.11.0

package/dist/index.js

@@ -2,8 +2,8 @@
  * `@sixtyninecommerce/admin` — the back-office SDK.
  *
  * Every capability of the platform is a method here (the parity rule, spec §5).
- * Shipped so far: auth, personal API tokens, channel resolution, CMS forms, SEO
- * redirects, the meta catalog, the tenant's own audit trail, its retention
+ * Shipped so far: auth, personal API tokens, channel resolution, CMS forms, content types and
+ * items, SEO redirects, the meta catalog, the tenant's own audit trail, its retention
  * policy and its stock location profiles — plus the `platform` guard every
  * cross-tenant method added later runs through.
  *
@@ -28,27 +28,65 @@
  * being transitive, pnpm would not resolve for them anyway.
  */
 /** Platform events: the webhook handler, the verifier and the payload types, from core. */
-export { APP_MANIFEST_SCHEMA, APP_MANIFEST_SCHEMA_SOURCE, AuthenticationError, BusinessRuleError, ConflictError, createEventHandler, EventStreamClosedError, HookRejectedError, HookUnavailableError, isEventType, NotFoundError, PermissionDeniedError, PlatformError, RateLimitedError, TransportError, UpstreamError, ValidationError, verifyEventDelivery, } from '@sixtyninecommerce/core';
-export { MAX_AVAILABILITY_PRODUCTS, MAX_AVAILABILITY_STORES, MAX_PRODUCT_COLLECTION_IDS, MAX_STORE_EXCLUSION_PRODUCTS, } from './catalog/products.js';
+export { APP_MANIFEST_SCHEMA, APP_MANIFEST_SCHEMA_SOURCE, AuthenticationError, BusinessRuleError, ConflictError, createEventHandler, EventStreamClosedError, HookRejectedError, HookUnavailableError, isEventType, NotFoundError, 
+/**
+ * The cursor of the page that starts at an offset, for a table that jumps to page N of an
+ * offset-paged list (`Page.nextCursor` is the next page's): `after: offsetCursor((n - 1) * size)`.
+ */
+offsetCursor, PermissionDeniedError, PlatformError, RateLimitedError, TransportError, UpstreamError, ValidationError, verifyEventDelivery, } from '@sixtyninecommerce/core';
+export { ASSET_SORT_FIELDS } from './catalog/assets.js';
+export { MAX_COLLECTION_SEARCH_TAKE } from './catalog/collections.js';
+export { MAX_AVAILABILITY_PRODUCTS, MAX_AVAILABILITY_STORES, MAX_PRODUCT_COLLECTION_IDS, MAX_STORE_EXCLUSION_PRODUCTS, MAX_STORE_PRICE_RANGE_PRODUCTS, } from './catalog/products.js';
 export { MAX_BULK_PRODUCTS, PRODUCT_BULK_ACTIONS } from './catalog/products-bulk.js';
-export { MAX_REVERT_PRICE_VARIANTS } from './catalog/variants.js';
+export { RECOMMENDATION_SOURCE_TYPES_WITH_ID } from './catalog/recommendations.js';
+export { MAX_BULK_REVIEWS, MAX_REVIEW_PAGE_SIZE, REVIEW_STATUSES, } from './catalog/reviews.js';
+export { MAX_VARIANT_FIND_PRODUCTS, MAX_VARIANT_FIND_TAKE } from './catalog/variant-find.js';
+export { DEFAULT_OPTION_SET_LIMIT, MAX_OPTION_SET_LIMIT, MAX_REVERT_PRICE_VARIANTS, } from './catalog/variants.js';
 export { createAdminClient, } from './client.js';
-export { MAX_REPLACE_GROUP_MEMBERS } from './customers/index.js';
-export { MAX_DOCUMENT_EXTENSIONS } from './documents/index.js';
+export { CUSTOMER_GROUP_LIST_INCLUDES, CUSTOMER_GROUP_LIST_SORT_FIELDS, CUSTOMER_HISTORY_TAKE, CUSTOMER_INCLUDES, CUSTOMER_LIST_INCLUDES, CUSTOMER_LIST_SORT_FIELDS, MAX_CUSTOMER_GROUP_LIST_TAKE, MAX_CUSTOMER_LIST_TAKE, MAX_REPLACE_GROUP_MEMBERS, } from './customers/index.js';
+export { VAT_VALIDATION_TIMEOUT_MS } from './customers/vat.js';
+export { DOCUMENT_EMAIL_EVENTS, MAX_DOCUMENT_EXTENSIONS } from './documents/index.js';
+export { decodePdf } from './documents/pdf.js';
 export { AdminProjectionError } from './errors.js';
 export { MAX_REDRIVE_EVENT_IDS } from './events/index.js';
 export { AI_UNAVAILABLE_CODE, DEFAULT_FEED_PAGE_LIMIT, DEFAULT_PREVIEW_SAMPLE_SIZE, DEFAULT_REFRESH_INTERVAL_MINUTES, FEED_CATEGORY_MAPPING_SOURCES, FEED_CATEGORY_MAPPING_STATUSES, FEED_CATEGORY_MATCH_TYPES, FEED_CONDITION_OPERATORS, FEED_DESTINATIONS, FEED_IDENTIFIER_PATTERN, FEED_ITEM_ISSUE_SEVERITIES, FEED_PREVIEW_TIMEOUT_MS, FEED_REGENERATE_THROTTLED, FEED_RUN_STATUSES, FEED_RUN_TRIGGERS, FEED_TRANSFORM_KINDS, FEED_VALUE_SOURCE_KINDS, isAiUnavailable, isFeedConditionGroup, isFeedValueSourceKind, MAX_BULK_STATUS_IDS, MAX_FEED_PAGE_LIMIT, MAX_LOOKUP_ENTRIES, MAX_PREVIEW_SAMPLE_SIZE, MAX_REFRESH_INTERVAL_MINUTES, MIN_REFRESH_INTERVAL_MINUTES, readFeedRegenerateThrottle, TAXONOMY_DEFAULT_LIMIT, TAXONOMY_MAX_LIMIT, TITLE_PRESET_TIMEOUT_MS, VALUELESS_FEED_CONDITION_OPERATORS, } from './feeds/index.js';
+export { FULFILLMENT_COVERAGE_REASON_MAX_LENGTH } from './fulfillments/index.js';
+export { DEFAULT_FULFILLMENT_PAYMENT_POLICY, FULFILLMENT_PAYMENT_POLICY_EXEMPT_METHODS_MAX, FULFILLMENT_PAYMENT_POLICY_METHOD_CODE_MAX_LENGTH, normalizeFulfillmentPolicyMethodCode, } from './fulfillments/payment-policy.js';
+export { MAX_WAREHOUSE_BULK_IDS } from './fulfillments/warehouse.js';
+export { mostSpecificZone } from './geo/index.js';
+export { AFAS_CUSTOMER_SEARCH_LIMIT, AFAS_SYNC_LOG_PAGE_LIMIT, ESP_BACKFILL_RESOURCES, ESP_SYNC_LOG_PAGE_LIMIT, PIPELINE_CONNECTION_PRESERVE_KEYS, PIPELINE_DRAFT_PRESERVE_KEYS, PIPELINE_DRAFT_SLOW_TIMEOUT_MS, } from './integrations/index.js';
 export { TERMINAL_BULK_ACTION_STATUSES } from './jobs/bulk-action-run.js';
 export { TERMINAL_JOB_STATUSES } from './jobs/index.js';
-export { OPENING_HOURS_DAYS } from './locations/index.js';
+export { OPENING_HOURS_DAYS, STORE_PICKUP_HOLD_DAYS, STORE_PICKUP_INSTRUCTIONS_MAX_LENGTH, } from './locations/index.js';
 export { METAFIELD_OWNER_TYPES, METAFIELD_SCALAR_TYPES } from './metafields/index.js';
+export { MAX_BULK_ORDERS, ORDER_BULK_ACTIONS, ORDER_BULK_TRANSITION_REFUSED, } from './orders/bulk.js';
+export { DEFAULT_ORDER_DEPOSIT_POLICY, DEPOSIT_POLICY_AUTO_CANCEL_DAYS_MIN, DEPOSIT_POLICY_MINIMUM_PERCENT_MAX, DEPOSIT_POLICY_STOREFRONT_METHODS_MAX, } from './orders/deposit-policy.js';
 export { ORDER_INCLUDES } from './orders/get.js';
+export { DraftInsufficientStockError, MAX_ORDER_LIST_TAKE, MAX_RECENT_ORDERS, ORDER_LIST_SORT_FIELDS, } from './orders/index.js';
+export { MINIMUM_AGE_MAX, MINIMUM_AGE_MIN, ORDER_CODE_DIGITS_MAX, ORDER_CODE_DIGITS_MIN, ORDER_CODE_PREFIX_MAX_LENGTH, ORDER_SETTINGS_AMOUNT_MAX, ORDER_STATUS_RULE_CONDITION_TYPES, ORDER_STATUS_RULE_TARGET_STATES, } from './orders/settings.js';
 export { ORDER_ALLOCATION_BADGES, ORDER_EDIT_BLOCK_CODES, ORDER_LOCK_REASONS, ORDER_STATUS_ACTIONS, ORDER_STATUS_REASON_CODES, } from './orders/status.js';
+export { PAYMENT_REQUEST_CLOSE_REASONS, PAYMENT_REQUEST_DEFAULT_EXPIRY_DAYS, PAYMENT_REQUEST_MAX_EXPIRY_DAYS, PAYMENT_REQUEST_STATUSES, } from './payments/index.js';
+export { PAYMENT_LINK_REQUEST_STATUSES } from './payments/payment-links.js';
+export { STORE_PICKUP_RELEASE_BLOCKED, STORE_PICKUP_STATUSES } from './pickups/index.js';
+export { releaseStateOf } from './platform/channels.js';
 export { requireHumanSession } from './platform/guard.js';
 export { PROVISION_PROFILES } from './platform/provision-store.js';
-export { promotionActions, promotionConditions } from './pricing/index.js';
+export { POS_ANOMALY_FLAGS_DEFAULT_PAGE, POS_ANOMALY_FLAGS_MAX_PAGE, } from './pos/anomalies.js';
+export { POS_ASSISTED_SELLING_LIMITS } from './pos/assisted-selling.js';
+export { POS_DEVICE_KINDS, POS_STAFF_GRANTS, POS_STAFF_LOCALES } from './pos/index.js';
+export { POS_OFFLINE_CASH_SALES_LIMITS, POS_OFFLINE_NOT_READY_REASONS, POS_OFFLINE_SALE_NOTE_MAX_LENGTH, POS_OFFLINE_SALE_REASONS, } from './pos/offline-sales.js';
+export { POS_PAY_BY_LINK_EXPIRY_MINUTES } from './pos/pay-by-link.js';
+export { POS_QUICK_KEY_COLORS, POS_QUICK_KEY_LIMITS } from './pos/quick-keys.js';
+export { POS_REPORT_PRODUCTS_DEFAULT_PAGE, POS_REPORT_PRODUCTS_MAX_PAGE, } from './pos/reports.js';
+export { PROMOTION_SORT_FIELDS, promotionActions, promotionConditions, } from './pricing/index.js';
+export { MAX_BULK_PRICE_LISTS, MAX_CUSTOMER_PRICE_LIST_ENTRIES, MAX_PRICE_LIST_ENTRY_EXPORT, MAX_PRICE_LIST_ENTRY_TAKE, MAX_PRICE_LIST_LIST_TAKE, PRICE_LIST_BULK_ACTIONS, PRICE_LIST_ENTRY_SEARCH_MODES, PRICE_LIST_SEARCH_MIN_TERM_LENGTH, PRICE_LIST_SEARCH_MODES, } from './pricing/price-lists.js';
 export { PROVENANCE_MAX_IDS } from './provenance/index.js';
+export { QUOTE_STATUSES } from './quotes/index.js';
+export { RETURN_ACTIONS, RETURN_SETTLEMENT_BLOCKERS, RETURN_SETTLEMENT_METHODS, RETURN_STATES, } from './returns/index.js';
+export { escapeSearchFilterValue, SEARCH_ENTITIES_MAX_TAKE, SEARCH_ENTITIES_MIN_TERM_LENGTH, SEARCH_INDEX_MAX_FILTERS, SEARCH_INDEXES, } from './search/index.js';
 export { PARCEL_SUGGESTION_MAX_ITEMS, PARCEL_SUGGESTION_MAX_QUANTITY, } from './shipping/parcel-count-suggestion.js';
 export { PARCEL_CAPACITY_MAX, PARCEL_WEIGHT_GRAMS_MAX } from './shipping/parcel-rule.js';
+export { STOCK_LOCATION_SORT_FIELDS } from './stock/locations.js';
+export { SUBSCRIPTION_STATUSES } from './subscriptions/index.js';
 export { TAX_CLASS_FALLBACK_COUNTRY } from './tax/index.js';
 export { SETTINGS_GROUPS } from './tenant/settings-sources.js';

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,
+                });
+            },
+        },
+    };
+}