@oronts/vendure-data-hub-plugin 0.1.2 → 0.1.4

package/shared/types/adapter-config.types.ts

@@ -324,26 +324,48 @@ export type TypedOperatorConfig =
 /** Product Upsert Loader */
 export interface ProductUpsertLoaderConfig {
     adapterCode: 'productUpsert';
-    /** Channel code (required) */
-    channel: string;
-    /** Merge strategy */
-    strategy: 'CREATE_ONLY' | 'UPDATE_ONLY' | 'SOURCE_WINS' | 'TARGET_WINS' | 'MERGE';
+    /** Channel code */
+    channel?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Conflict strategy: SOURCE_WINS (default), VENDURE_WINS, or MERGE */
+    conflictStrategy?: 'SOURCE_WINS' | 'VENDURE_WINS' | 'MERGE';
     /** Field containing product name */
     nameField?: string;
     /** Field containing slug */
     slugField?: string;
     /** Field containing description */
     descriptionField?: string;
+    /** Field containing product enabled/published flag */
+    enabledField?: string;
+    /** Record field containing channel codes (array or comma-separated) for dynamic per-record channel assignment */
+    channelsField?: string;
+    /** Record field containing translations array or object map for multi-language support.
+     *  Array format: [{ languageCode: 'en', name: '...', slug?: '...', description?: '...' }, ...]
+     *  Object map: { en: { name, slug?, description? }, de: { ... } } */
+    translationsField?: string;
     /** Field containing SKU */
     skuField?: string;
     /** Field containing price */
     priceField?: string;
     /** Field containing stock quantity */
     stockField?: string;
+    /** Field containing stock by location map */
+    stockByLocationField?: string;
     /** Track inventory flag */
     trackInventory?: string | boolean;
     /** Tax category name */
     taxCategoryName?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Whether to create/update variants alongside the product (default: true). Set to false when variants are handled by a separate variantUpsert step. */
+    createVariants?: boolean;
+    /** How to handle product facet values on update */
+    facetValuesMode?: FacetValuesMode;
+    /** How to handle product assets on update */
+    assetsMode?: AssetsMode;
+    /** How to handle product featured asset on update */
+    featuredAssetMode?: FeaturedAssetMode;
 }
 
 /** Variant Upsert Loader */
@@ -353,14 +375,81 @@ export interface VariantUpsertLoaderConfig {
     channel?: string;
     /** Field containing SKU */
     skuField?: string;
-    /** Field containing price */
+    /** Field containing variant name */
+    nameField?: string;
+    /** Field containing variant enabled/published flag (defaults to "enabled") */
+    enabledField?: string;
+    /** Record field containing channel codes (array or comma-separated) for dynamic per-record channel assignment */
+    channelsField?: string;
+    /** Record field containing translations array or object map for multi-language support.
+     *  Array format: [{ languageCode: 'en', name: '...' }, ...]
+     *  Object map: { en: { name: '...' }, de: { name: '...' } } */
+    translationsField?: string;
+    /** Field containing price (major units, auto-converted to minor) */
     priceField?: string;
-    /** Field containing stock */
+    /** Field containing price map by currency code (object, e.g. { USD: 19.99, EUR: 17.50 }) */
+    priceByCurrencyField?: string;
+    /** Field containing stock on hand */
     stockField?: string;
+    /** Field containing stock by location map (object, e.g. { "Warehouse A": 100, "Warehouse B": 50 }) */
+    stockByLocationField?: string;
     /** Tax category name */
     taxCategoryName?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Field containing option group→value pairs (object, e.g. { size: 'S', color: 'Blue' }). Auto-creates option groups and assigns them to the parent product. */
+    optionGroupsField?: string;
+    /** Field containing pre-existing Vendure option IDs (array, e.g. [1, 2, 3]). Passed directly without lookup. */
+    optionIdsField?: string;
+    /** Field containing option codes (array, e.g. ['size-s', 'color-blue']). Resolved to IDs by code lookup. */
+    optionCodesField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE.
+     *  UPSERT: update existing or create new (record must contain productSlug, productId, or productName for creation).
+     *  CREATE: only create new variants, skip existing.
+     *  UPDATE: only update existing variants, skip missing. */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** How to handle variant facet values on update */
+    facetValuesMode?: FacetValuesMode;
+    /** How to handle variant assets on update */
+    assetsMode?: AssetsMode;
+    /** How to handle variant featured asset on update */
+    featuredAssetMode?: FeaturedAssetMode;
+    /** How to handle variant options on update */
+    optionsMode?: OptionsMode;
 }
 
+// NESTED ENTITY MODE TYPES
+
+/** How to handle customer addresses on update */
+export type AddressesMode = 'UPSERT_BY_MATCH' | 'REPLACE_ALL' | 'APPEND_ONLY' | 'UPDATE_BY_ID' | 'SKIP';
+
+/** How to handle facet values on product/variant update */
+export type FacetValuesMode = 'REPLACE_ALL' | 'MERGE' | 'REMOVE' | 'SKIP';
+
+/** How to handle order lines on order update */
+export type LinesMode = 'REPLACE_ALL' | 'MERGE_BY_SKU' | 'APPEND_ONLY' | 'UPDATE_BY_ID' | 'SKIP';
+
+/** How to handle assets (product/variant/collection) */
+export type AssetsMode = 'UPSERT_BY_URL' | 'REPLACE_ALL' | 'APPEND_ONLY' | 'SKIP';
+
+/** How to handle featured asset (product/variant) */
+export type FeaturedAssetMode = 'UPSERT_BY_URL' | 'REPLACE' | 'SKIP';
+
+/** How to handle variant options */
+export type OptionsMode = 'REPLACE_ALL' | 'MERGE' | 'SKIP';
+
+/** How to handle collection filters */
+export type FiltersMode = 'REPLACE_ALL' | 'MERGE' | 'SKIP';
+
+/** How to handle promotion conditions */
+export type ConditionsMode = 'REPLACE_ALL' | 'MERGE' | 'SKIP';
+
+/** How to handle promotion actions */
+export type ActionsMode = 'REPLACE_ALL' | 'MERGE' | 'SKIP';
+
+/** How to handle customer groups */
+export type GroupsMode = 'add' | 'set';
+
 /** Customer Upsert Loader */
 export interface CustomerUpsertLoaderConfig {
     adapterCode: 'customerUpsert';
@@ -374,10 +463,18 @@ export interface CustomerUpsertLoaderConfig {
     phoneNumberField?: string;
     /** Field containing addresses array */
     addressesField?: string;
+    /** How to handle customer addresses on update */
+    addressesMode?: AddressesMode;
+    /** Comma-separated fields to match existing addresses (for UPSERT_BY_MATCH mode) */
+    addressMatchFields?: string;
     /** Field containing group codes */
     groupsField?: string;
     /** Groups mode */
-    groupsMode?: 'add' | 'set';
+    groupsMode?: GroupsMode;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
 }
 
 /** Stock Adjust Loader */
@@ -424,6 +521,43 @@ export interface RestPostLoaderConfig {
     timeoutMs?: number;
 }
 
+/** Order Upsert Loader */
+export interface OrderUpsertLoaderConfig {
+    adapterCode: 'orderUpsert';
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Lookup fields for matching existing orders */
+    lookupFields?: string;
+    /** Field containing order code */
+    codeField?: string;
+    /** Field containing customer email */
+    customerEmailField?: string;
+    /** Field containing order lines array */
+    linesField?: string;
+    /** How to handle order lines on update */
+    linesMode?: LinesMode;
+    /** Field to match order lines by (for MERGE_BY_SKU and UPDATE_BY_ID modes, default: 'sku') */
+    linesMatchBy?: string;
+    /** Field containing shipping address */
+    shippingAddressField?: string;
+    /** Field containing billing address */
+    billingAddressField?: string;
+    /** Field containing shipping method code */
+    shippingMethodCodeField?: string;
+    /** Payment method code */
+    paymentMethodCode?: string;
+    /** Field containing payment method code */
+    paymentMethodCodeField?: string;
+    /** Target state */
+    state?: string;
+    /** Field containing state */
+    stateField?: string;
+    /** Field containing order placed at date */
+    orderPlacedAtField?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+}
+
 /** Order Note Loader */
 export interface OrderNoteLoaderConfig {
     adapterCode: 'orderNote';
@@ -453,6 +587,8 @@ export interface CollectionUpsertLoaderConfig {
     adapterCode: 'collectionUpsert';
     /** Channel code */
     channel?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
     /** Field containing name */
     nameField?: string;
     /** Field containing slug */
@@ -461,6 +597,20 @@ export interface CollectionUpsertLoaderConfig {
     descriptionField?: string;
     /** Field containing parent slug */
     parentSlugField?: string;
+    /** Apply collection filters after upsert */
+    applyFilters?: boolean;
+    /** Field containing multi-language translations (array or object map) */
+    translationsField?: string;
+    /** Field containing channel codes for per-record channel assignment */
+    channelsField?: string;
+    /** Field containing isPrivate flag */
+    isPrivateField?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** How to handle collection assets on update */
+    assetsMode?: AssetsMode;
+    /** How to handle collection filters on update */
+    filtersMode?: FiltersMode;
 }
 
 /** Asset Attach Loader */
@@ -492,6 +642,8 @@ export interface PromotionUpsertLoaderConfig {
     codeField: string;
     /** Field containing name */
     nameField?: string;
+    /** Field containing enabled flag */
+    enabledField?: string;
     /** Field containing starts at date */
     startsAtField?: string;
     /** Field containing ends at date */
@@ -500,8 +652,264 @@ export interface PromotionUpsertLoaderConfig {
     perCustomerUsageLimitField?: string;
     /** Field containing conditions */
     conditionsField?: string;
+    /** How to handle promotion conditions on update */
+    conditionsMode?: ConditionsMode;
     /** Field containing actions */
     actionsField?: string;
+    /** How to handle promotion actions on update */
+    actionsMode?: ActionsMode;
+    /** Channel code */
+    channel?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Field containing multi-language translations (array or object map) */
+    translationsField?: string;
+    /** Field containing channel codes for per-record channel assignment */
+    channelsField?: string;
+    /** Field containing promotion description */
+    descriptionField?: string;
+}
+
+/** GraphQL Mutation Loader */
+export interface GraphqlMutationLoaderConfig {
+    adapterCode: 'graphqlMutation';
+    /** GraphQL endpoint URL (required) */
+    endpoint: string;
+    /** GraphQL mutation string (required) */
+    mutation: string;
+    /** Variable mapping: { "input.name": "productName" } (required) */
+    variableMapping: Record<string, string>;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Auth preset */
+    auth?: 'NONE' | 'BEARER' | 'BASIC';
+    /** Bearer token secret code */
+    bearerTokenSecretCode?: string;
+    /** Basic auth secret code */
+    basicSecretCode?: string;
+    /** Batch mode */
+    batchMode?: 'SINGLE' | 'BATCH';
+    /** Max records per batch */
+    maxBatchSize?: number;
+    /** Number of retries */
+    retries?: number;
+    /** Delay between retries (ms) */
+    retryDelayMs?: number;
+    /** Request timeout (ms) */
+    timeoutMs?: number;
+}
+
+/** Facet Upsert Loader */
+export interface FacetUpsertLoaderConfig {
+    adapterCode: 'facetUpsert';
+    /** Field containing facet code (required) */
+    codeField: string;
+    /** Field containing facet name (required) */
+    nameField: string;
+    /** Field containing private flag */
+    privateField?: string;
+    /** Channel code */
+    channel?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Field containing multi-language translations (array or object map) */
+    translationsField?: string;
+    /** Field containing channel codes for per-record channel assignment */
+    channelsField?: string;
+}
+
+/** Facet Value Upsert Loader */
+export interface FacetValueUpsertLoaderConfig {
+    adapterCode: 'facetValueUpsert';
+    /** Field containing parent facet code (required) */
+    facetCodeField: string;
+    /** Field containing value code (required) */
+    codeField: string;
+    /** Field containing value name (required) */
+    nameField: string;
+    /** Channel code */
+    channel?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Field containing multi-language translations (array or object map) */
+    translationsField?: string;
+    /** Field containing channel codes for per-record channel assignment */
+    channelsField?: string;
+}
+
+/** Asset Import Loader */
+export interface AssetImportLoaderConfig {
+    adapterCode: 'assetImport';
+    /** Field containing source URL to download (required) */
+    sourceUrlField: string;
+    /** Field containing target filename */
+    filenameField?: string;
+    /** Field containing asset name */
+    nameField?: string;
+    /** Field containing tags (array) */
+    tagsField?: string;
+    /** Channel code */
+    channel?: string;
+}
+
+/** Tax Rate Upsert Loader */
+export interface TaxRateUpsertLoaderConfig {
+    adapterCode: 'taxRateUpsert';
+    /** Field containing tax rate name (required) */
+    nameField: string;
+    /** Field containing tax rate percentage 0-100 (required) */
+    valueField: string;
+    /** Field containing enabled flag */
+    enabledField?: string;
+    /** Field containing tax category code/name (required) */
+    taxCategoryCodeField: string;
+    /** Field containing tax category ID (alternative) */
+    taxCategoryIdField?: string;
+    /** Field containing zone code/name (required) */
+    zoneCodeField: string;
+    /** Field containing zone ID (alternative) */
+    zoneIdField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+}
+
+/** Payment Method Upsert Loader */
+export interface PaymentMethodUpsertLoaderConfig {
+    adapterCode: 'paymentMethodUpsert';
+    /** Field containing payment method name (required) */
+    nameField: string;
+    /** Field containing unique code (required) */
+    codeField: string;
+    /** Field containing description */
+    descriptionField?: string;
+    /** Field containing enabled flag */
+    enabledField?: string;
+    /** Field containing handler config { code, args } (required) */
+    handlerField: string;
+    /** Field containing eligibility checker config { code, args } */
+    checkerField?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Field containing multi-language translations (array or object map) */
+    translationsField?: string;
+    /** Field containing channel codes for per-record channel assignment */
+    channelsField?: string;
+}
+
+/** Channel Upsert Loader */
+export interface ChannelUpsertLoaderConfig {
+    adapterCode: 'channelUpsert';
+    /** Field containing unique channel code (required) */
+    codeField: string;
+    /** Field containing channel token */
+    tokenField?: string;
+    /** Field containing default language code (required) */
+    defaultLanguageCodeField: string;
+    /** Field containing available language codes (array) */
+    availableLanguageCodesField?: string;
+    /** Field containing default currency code (required) */
+    defaultCurrencyCodeField: string;
+    /** Field containing available currency codes (array) */
+    availableCurrencyCodesField?: string;
+    /** Field containing prices-include-tax flag */
+    pricesIncludeTaxField?: string;
+    /** Field containing default tax zone code */
+    defaultTaxZoneCodeField?: string;
+    /** Field containing default shipping zone code */
+    defaultShippingZoneCodeField?: string;
+    /** Field containing seller ID (for multi-vendor) */
+    sellerIdField?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+}
+
+/** Shipping Method Upsert Loader */
+export interface ShippingMethodUpsertLoaderConfig {
+    adapterCode: 'shippingMethodUpsert';
+    /** Field containing display name (required) */
+    nameField: string;
+    /** Field containing unique code (required) */
+    codeField: string;
+    /** Field containing description */
+    descriptionField?: string;
+    /** Field containing fulfillment handler code (required) */
+    fulfillmentHandlerField: string;
+    /** Field containing calculator config { code, args } (required) */
+    calculatorField: string;
+    /** Field containing eligibility checker config { code, args } */
+    checkerField?: string;
+    /** Field containing custom fields object */
+    customFieldsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+    /** Field containing multi-language translations (array or object map) */
+    translationsField?: string;
+    /** Field containing channel codes for per-record channel assignment */
+    channelsField?: string;
+}
+
+/** Customer Group Upsert Loader */
+export interface CustomerGroupUpsertLoaderConfig {
+    adapterCode: 'customerGroupUpsert';
+    /** Field containing group name (required) */
+    nameField: string;
+    /** Field containing customer email addresses (array) */
+    customerEmailsField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+}
+
+/** Stock Location Upsert Loader */
+export interface StockLocationUpsertLoaderConfig {
+    adapterCode: 'stockLocationUpsert';
+    /** Field containing stock location name (required) */
+    nameField: string;
+    /** Field containing location description */
+    descriptionField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+}
+
+/** Inventory Adjust Loader */
+export interface InventoryAdjustLoaderConfig {
+    adapterCode: 'inventoryAdjust';
+    /** Field containing variant SKU (required) */
+    skuField: string;
+    /** Field containing stock on hand quantity (required) */
+    stockOnHandField: string;
+    /** Field containing stock location name */
+    stockLocationNameField?: string;
+    /** Field containing stock location ID (alternative) */
+    stockLocationIdField?: string;
+    /** Field containing adjustment reason */
+    reasonField?: string;
+    /** Load strategy: UPSERT (default), CREATE, or UPDATE */
+    strategy?: 'UPSERT' | 'CREATE' | 'UPDATE';
+}
+
+/** Entity Deletion Loader - Delete entities */
+export interface EntityDeletionLoaderConfig {
+    adapterCode: 'entityDeletion';
+    /** Entity type to delete (default: 'product') */
+    entityType?: 'product' | 'variant' | 'collection' | 'promotion' | 'shipping-method' | 'customer' | 'payment-method' | 'facet' | 'facet-value' | 'customer-group' | 'tax-rate' | 'asset' | 'stock-location';
+    /** Record field containing the identifier to match (default depends on entity type) */
+    identifierField?: string;
+    /** How to match the entity (default depends on entity type) */
+    matchBy?: 'slug' | 'sku' | 'id' | 'code' | 'email' | 'name';
+    /** Delete variants when deleting a product (default: true) */
+    cascadeVariants?: boolean;
+    /** Channel code */
+    channel?: string;
 }
 
 /** Generic config for custom loader adapters */
@@ -515,14 +923,27 @@ export type TypedLoaderConfig =
     | ProductUpsertLoaderConfig
     | VariantUpsertLoaderConfig
     | CustomerUpsertLoaderConfig
+    | OrderUpsertLoaderConfig
     | StockAdjustLoaderConfig
     | RestPostLoaderConfig
+    | GraphqlMutationLoaderConfig
     | OrderNoteLoaderConfig
     | OrderTransitionLoaderConfig
     | CollectionUpsertLoaderConfig
     | AssetAttachLoaderConfig
+    | AssetImportLoaderConfig
     | ApplyCouponLoaderConfig
     | PromotionUpsertLoaderConfig
+    | FacetUpsertLoaderConfig
+    | FacetValueUpsertLoaderConfig
+    | TaxRateUpsertLoaderConfig
+    | PaymentMethodUpsertLoaderConfig
+    | ChannelUpsertLoaderConfig
+    | ShippingMethodUpsertLoaderConfig
+    | CustomerGroupUpsertLoaderConfig
+    | StockLocationUpsertLoaderConfig
+    | InventoryAdjustLoaderConfig
+    | EntityDeletionLoaderConfig
     | GenericLoaderConfig;
 
 // EXPORTER CONFIGS
@@ -711,10 +1132,10 @@ export interface RouteConfig {
 // PERMISSION MAPPINGS
 
 /** Loader adapter codes that require UpdateCatalog permission */
-export type UpdateCatalogLoaders = 'productUpsert' | 'variantUpsert' | 'stockAdjust' | 'collectionUpsert' | 'assetAttach';
+export type UpdateCatalogLoaders = 'productUpsert' | 'variantUpsert' | 'stockAdjust' | 'collectionUpsert' | 'assetAttach' | 'assetImport' | 'facetUpsert' | 'facetValueUpsert' | 'stockLocationUpsert' | 'inventoryAdjust' | 'entityDeletion';
 
 /** Loader adapter codes that require UpdateCustomer permission */
-export type UpdateCustomerLoaders = 'customerUpsert';
+export type UpdateCustomerLoaders = 'customerUpsert' | 'customerGroupUpsert';
 
 /** Loader adapter codes that require UpdateOrder permission */
 export type UpdateOrderLoaders = 'orderNote' | 'orderTransition' | 'applyCoupon';
@@ -722,8 +1143,14 @@ export type UpdateOrderLoaders = 'orderNote' | 'orderTransition' | 'applyCoupon'
 /** Loader adapter codes that require UpdatePromotion permission */
 export type UpdatePromotionLoaders = 'promotionUpsert';
 
+/** Loader adapter codes that require UpdateSettings permission */
+export type UpdateSettingsLoaders = 'taxRateUpsert' | 'paymentMethodUpsert' | 'channelUpsert';
+
+/** Loader adapter codes that require UpdateShippingMethod permission */
+export type UpdateShippingMethodLoaders = 'shippingMethodUpsert';
+
 /** Loader adapter codes that require UpdateDataHubSettings permission */
-export type UpdateDataHubSettingsLoaders = 'restPost';
+export type UpdateDataHubSettingsLoaders = 'restPost' | 'graphqlMutation';
 
 /** All loader adapter codes */
 export type LoaderAdapterCode =
@@ -731,5 +1158,7 @@ export type LoaderAdapterCode =
     | UpdateCustomerLoaders
     | UpdateOrderLoaders
     | UpdatePromotionLoaders
+    | UpdateSettingsLoaders
+    | UpdateShippingMethodLoaders
     | UpdateDataHubSettingsLoaders;
 

package/shared/types/index.ts

@@ -305,6 +305,16 @@ export type {
 } from './runtime-config.types';
 
 export type {
+    AddressesMode,
+    FacetValuesMode,
+    LinesMode,
+    AssetsMode,
+    FeaturedAssetMode,
+    OptionsMode,
+    FiltersMode,
+    ConditionsMode,
+    ActionsMode,
+    GroupsMode,
     CsvExtractorConfig,
     JsonExtractorConfig,
     ExcelExtractorConfig,
@@ -330,14 +340,27 @@ export type {
     ProductUpsertLoaderConfig,
     VariantUpsertLoaderConfig,
     CustomerUpsertLoaderConfig,
+    OrderUpsertLoaderConfig,
     StockAdjustLoaderConfig,
     RestPostLoaderConfig,
+    GraphqlMutationLoaderConfig,
     OrderNoteLoaderConfig,
     OrderTransitionLoaderConfig,
     CollectionUpsertLoaderConfig,
     AssetAttachLoaderConfig,
+    AssetImportLoaderConfig,
     ApplyCouponLoaderConfig,
     PromotionUpsertLoaderConfig,
+    FacetUpsertLoaderConfig,
+    FacetValueUpsertLoaderConfig,
+    TaxRateUpsertLoaderConfig,
+    PaymentMethodUpsertLoaderConfig,
+    ChannelUpsertLoaderConfig,
+    ShippingMethodUpsertLoaderConfig,
+    CustomerGroupUpsertLoaderConfig,
+    StockLocationUpsertLoaderConfig,
+    InventoryAdjustLoaderConfig,
+    EntityDeletionLoaderConfig,
     GenericLoaderConfig,
     TypedLoaderConfig,
     CsvExportConfig,
@@ -357,6 +380,8 @@ export type {
     UpdateCustomerLoaders,
     UpdateOrderLoaders,
     UpdatePromotionLoaders,
+    UpdateSettingsLoaders,
+    UpdateShippingMethodLoaders,
     UpdateDataHubSettingsLoaders,
     LoaderAdapterCode,
 } from './adapter-config.types';

package/shared/types/loader.types.ts

@@ -23,6 +23,8 @@ export interface LoaderOptions {
     skipDuplicates?: boolean;
     /** Language code for translations */
     languageCode?: string;
+    /** Loader-specific configuration (e.g., nested entity modes) */
+    config?: Record<string, unknown>;
 }
 
 // LOAD RESULT (Entity-specific, distinct from pipeline LoadResult)
@@ -51,6 +53,8 @@ export interface EntityValidationResult {
     valid: boolean;
     errors: EntityValidationError[];
     warnings: EntityValidationWarning[];
+    /** Formatted error message with full context (only present when valid=false) */
+    errorMessage?: string;
 }
 
 export interface EntityValidationError {

package/shared/types/step.types.ts

@@ -192,6 +192,12 @@ export interface PipelineEdge {
     condition?: string;
     /** Display label for the edge */
     label?: string;
+    /**
+     * When true, this edge enforces execution ordering only — records
+     * from the source step are NOT passed as input to the target step.
+     * Useful for "must run after" semantics without data flow.
+     */
+    dependencyOnly?: boolean;
 }
 
 /**

package/shared/utils/error.ts

@@ -23,3 +23,14 @@ export function ensureError(error: unknown): Error {
 export function toErrorOrUndefined(error: unknown): Error | undefined {
     return error instanceof Error ? error : undefined;
 }
+
+/**
+ * Extracts the stack trace from an unknown caught value.
+ * Returns undefined if the value is not an Error or has no stack.
+ */
+export function getErrorStack(error: unknown): string | undefined {
+    if (error instanceof Error && error.stack) {
+        return error.stack;
+    }
+    return undefined;
+}