@oronts/vendure-data-hub-plugin 0.1.3 → 0.1.5

package/docs/reference/operators.md

@@ -289,7 +289,7 @@ Enrich records by fetching data from external HTTP endpoints with caching, authe
 | `basicAuthSecretCode` | string | No | Secret code for Basic auth (username:password) |
 | `bodyField` | string | No | Field path for POST body (uses record value at this path) |
 | `body` | json | No | Static POST body (JSON object) |
-| `skipOn404` | boolean | No | Skip record if endpoint returns 404 |
+| `skipOn404` | boolean | No | Remove record from pipeline if endpoint returns 404 (see note below) |
 | `failOnError` | boolean | No | Fail pipeline if HTTP request fails |
 | `maxRetries` | number | No | Maximum retry attempts on transient errors |
 | `batchSize` | number | No | Process this many records in parallel (default: 50) |
@@ -322,6 +322,8 @@ Enrich records by fetching data from external HTTP endpoints with caching, authe
 } }
 ```
 
+> **`skipOn404` behavior:** When `skipOn404: true` and the enrichment HTTP lookup returns a 404, the record is **removed from the pipeline** (not passed through with original values). To preserve records when enrichment fails, use `default` to provide a fallback value instead.
+
 ---
 
 ## String Operators
@@ -697,6 +699,8 @@ Add or subtract time from a date.
 | `amount` | number | Yes | Amount (negative to subtract) |
 | `unit` | string | Yes | `seconds`, `minutes`, `hours`, `days`, `weeks`, `months`, `years` |
 
+> **Important:** Unit strings must be plural: `"days"`, `"hours"`, `"minutes"`, `"seconds"`, `"weeks"`, `"months"`, `"years"`. Singular forms like `"day"` are not supported.
+
 ```typescript
 { op: 'dateAdd', args: { source: 'orderDate', target: 'expiresAt', amount: 30, unit: 'days' } }
 { op: 'dateAdd', args: { source: 'createdAt', target: 'previousDay', amount: -1, unit: 'days' } }
@@ -714,6 +718,8 @@ Calculate the difference between two dates.
 | `unit` | select | Yes | `seconds`, `minutes`, `hours`, `days`, `weeks`, `months`, `years` |
 | `absolute` | boolean | No | Return absolute value (no negative numbers) |
 
+> **Important:** Unit strings must be plural: `"days"`, `"hours"`, `"minutes"`, `"seconds"`, `"weeks"`, `"months"`, `"years"`. Singular forms like `"day"` are not supported.
+
 ```typescript
 { op: 'dateDiff', args: { startDate: 'createdAt', endDate: 'completedAt', target: 'durationDays', unit: 'days' } }
 { op: 'dateDiff', args: { startDate: 'orderDate', endDate: 'deliveryDate', target: 'deliveryHours', unit: 'hours', absolute: true } }
@@ -748,7 +754,7 @@ Filter records by conditions.
 | `conditions` | array | Yes | Array of condition objects |
 | `action` | string | Yes | `keep` or `drop` |
 
-Condition operators: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `endsWith`, `regex`, `exists`, `isNull`
+Condition operators: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `endsWith`, `regex`, `exists`, `notExists`, `isNull`, `isEmpty`, `isNotEmpty`, `matches` (glob)
 
 ```typescript
 { op: 'when', args: {
@@ -805,6 +811,34 @@ Set a value based on multiple conditions.
 }}
 ```
 
+### Comparison Operators
+
+All 19 comparison operators used by `when`, `ifThenElse`, `switch`, and ROUTE step conditions:
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| `eq` | Equal (strict `===`) | `{ field: 'status', cmp: 'eq', value: 'active' }` |
+| `ne` | Not equal (strict `!==`) | `{ field: 'status', cmp: 'ne', value: 'deleted' }` |
+| `gt` | Greater than (numeric) | `{ field: 'price', cmp: 'gt', value: 0 }` |
+| `gte` | Greater than or equal (numeric) | `{ field: 'stock', cmp: 'gte', value: 10 }` |
+| `lt` | Less than (numeric) | `{ field: 'price', cmp: 'lt', value: 1000 }` |
+| `lte` | Less than or equal (numeric) | `{ field: 'weight', cmp: 'lte', value: 50 }` |
+| `in` | Value in array | `{ field: 'status', cmp: 'in', value: ['active', 'pending'] }` |
+| `notIn` | Value not in array | `{ field: 'status', cmp: 'notIn', value: ['deleted', 'archived'] }` |
+| `contains` | String contains substring | `{ field: 'name', cmp: 'contains', value: 'widget' }` |
+| `notContains` | String does not contain | `{ field: 'name', cmp: 'notContains', value: 'test' }` |
+| `startsWith` | String starts with | `{ field: 'sku', cmp: 'startsWith', value: 'PRD-' }` |
+| `endsWith` | String ends with | `{ field: 'email', cmp: 'endsWith', value: '@example.com' }` |
+| `regex` | Regular expression match | `{ field: 'sku', cmp: 'regex', value: '^[A-Z]{3}-\\d+$' }` |
+| `matches` | Glob pattern match | `{ field: 'path', cmp: 'matches', value: '/products/**/*.json' }` |
+| `exists` | Value is not null/undefined | `{ field: 'email', cmp: 'exists', value: true }` |
+| `notExists` | Value is null or undefined | `{ field: 'deletedAt', cmp: 'notExists', value: true }` |
+| `isNull` | Value is null or undefined | `{ field: 'description', cmp: 'isNull', value: true }` |
+| `isEmpty` | Empty string, null, undefined, or empty array | `{ field: 'tags', cmp: 'isEmpty', value: true }` |
+| `isNotEmpty` | Non-empty value (string, array, etc.) | `{ field: 'name', cmp: 'isNotEmpty', value: true }` |
+
+---
+
 ### deltaFilter
 
 Filter out unchanged records using stable hashing.

package/docs/reference/sinks.md

@@ -352,14 +352,13 @@ Adjust batch size based on:
 
 ### Concurrency
 
-For large datasets, use multiple workers:
+For large datasets, configure parallel processing per pipeline step:
 
 ```typescript
-DataHubPlugin.init({
-    jobQueueOptions: {
-        concurrency: 4,
-    },
-})
+{
+    batchSize: 500,
+    rateLimitPerSecond: 100,  // Adjust based on target system capacity
+}
 ```
 
 ### Refresh Strategy
@@ -469,6 +468,8 @@ Send records to an HTTP endpoint via POST requests.
 | `batchSize` | number | No | Records per request |
 | `timeoutMs` | number | No | Request timeout in milliseconds (default: 30000) |
 | `retries` | number | No | Maximum retry attempts on failure (default: 3) |
+| `hmacSecretCode` | string | No | Secret code for HMAC signing. When set, each request includes an HMAC-SHA256 signature computed over the request body |
+| `signatureHeaderName` | string | No | Header name for the HMAC signature (default: `X-DataHub-Signature`) |
 
 ### Example - Single Records with Bearer Auth
 

package/docs/reference/step-types.md

@@ -78,8 +78,15 @@ See [Pipeline Builder - enrich](../developer-guide/dsl/pipeline-builder.md#enric
 
 Splits data flow based on field conditions. Each branch defines a set of
 conditions using comparison operators (`eq`, `ne`, `gt`, `lt`, `in`,
-`contains`, `regex`, etc.). An optional `defaultTo` branch handles
-unmatched records.
+`contains`, `regex`, etc.).
+
+> **Unmatched records:** In graph execution mode, records that don't match any
+> branch condition are collected into a `default` branch. In linear execution
+> mode, if no branch matches any records, the step returns an empty result and
+> unmatched records are silently dropped. A warning is logged when records are
+> dropped. To ensure all records are handled, add a catch-all branch with
+> `{ name: 'fallback', when: [] }` (no conditions = always matches) as the
+> last branch.
 
 See [Pipeline Builder - route](../developer-guide/dsl/pipeline-builder.md#route) for configuration.
 
@@ -87,9 +94,9 @@ See [Pipeline Builder - route](../developer-guide/dsl/pipeline-builder.md#route)
 
 ## LOAD
 
-Creates, updates, or deletes Vendure entities. Supports 22 entity types
-including products, variants, customers, collections, facets, orders,
-promotions, assets, and more.
+Creates, updates, or deletes Vendure entities. Supports 24 loader codes
+including products, variants, customers, collections, facets, orders (upsert, notes, transitions, coupons),
+promotions, assets, inventory, entity deletion, and more.
 
 **Strategies:** `CREATE`, `UPDATE`, `UPSERT`, `MERGE`, `SOFT_DELETE`, `HARD_DELETE`
 

package/docs/user-guide/pipelines.md

@@ -217,19 +217,25 @@ Hooks allow you to execute custom code at specific stages of pipeline execution.
 | `AFTER_ENRICH` | After enrichment | Yes |
 | `BEFORE_ROUTE` | Before routing | Yes |
 | `AFTER_ROUTE` | After routing | Yes |
-| `BEFORE_LOAD` | Before loading | Yes |
-| `AFTER_LOAD` | After loading | No |
-
-**Lifecycle Stages:**
-
-| Stage | When It Runs |
-|-------|--------------|
-| `PIPELINE_STARTED` | Pipeline execution begins |
-| `PIPELINE_COMPLETED` | Pipeline finishes successfully |
-| `PIPELINE_FAILED` | Pipeline fails |
-| `ON_ERROR` | When an error occurs |
-| `ON_RETRY` | When a record is retried |
-| `ON_DEAD_LETTER` | When a record is sent to dead letter queue |
+| `BEFORE_LOAD` | Before loading to Vendure | Yes |
+| `AFTER_LOAD` | After loading | Yes |
+| `BEFORE_EXPORT` | Before file export | Yes |
+| `AFTER_EXPORT` | After file export | Yes |
+| `BEFORE_FEED` | Before feed generation | Yes |
+| `AFTER_FEED` | After feed generation | Yes |
+| `BEFORE_SINK` | Before search indexing | Yes |
+| `AFTER_SINK` | After search indexing | Yes |
+
+**Lifecycle Stages** (observe-only — WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE only, no INTERCEPTOR/SCRIPT):
+
+| Stage | When It Runs | Supported Hook Types |
+|-------|--------------|---------------------|
+| `PIPELINE_STARTED` | Pipeline execution begins | WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE |
+| `PIPELINE_COMPLETED` | Pipeline finishes successfully | WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE |
+| `PIPELINE_FAILED` | Pipeline fails | WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE |
+| `ON_ERROR` | When an error occurs | WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE |
+| `ON_RETRY` | When a record is retried | WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE |
+| `ON_DEAD_LETTER` | When a record is sent to dead letter queue | WEBHOOK, EMIT, LOG, TRIGGER_PIPELINE |
 
 ### Hook Types
 
@@ -262,6 +268,43 @@ Interceptors run JavaScript code that can modify the records array:
 })
 ```
 
+**Modify records before search indexing (Meilisearch, Elasticsearch, etc.):**
+
+```typescript
+.hooks({
+    BEFORE_SINK: [{
+        type: 'INTERCEPTOR',
+        name: 'Enrich for search',
+        code: `
+            return records.map(r => ({
+                ...r,
+                searchText: [r.name, r.sku, r.description].filter(Boolean).join(' ').toLowerCase(),
+                facetTags: (r.tags || '').split(',').map(t => t.trim()).filter(Boolean),
+                boostScore: r.featured ? 1.5 : 1.0,
+            }));
+        `,
+    }],
+})
+```
+
+**Transform records before CSV/JSON export:**
+
+```typescript
+.hooks({
+    BEFORE_EXPORT: [{
+        type: 'INTERCEPTOR',
+        name: 'Format for export',
+        code: `
+            return records.map(r => ({
+                ...r,
+                price: (r.price / 100).toFixed(2),
+                createdAt: new Date(r.createdAt).toISOString(),
+            }));
+        `,
+    }],
+})
+```
+
 **Available in interceptor code:**
 - `records` - The current records array
 - `context` - Hook context with `pipelineId`, `runId`, `stage`
@@ -319,6 +362,10 @@ export class MyPlugin implements OnModuleInit {
 }
 ```
 
+> **Tip:** When registering scripts via `HookService.registerScript()` in a NestJS service,
+> your scripts can access any injected service (database, external APIs, Vendure services)
+> through JavaScript closures. See the [Developer Guide](../developer-guide/extending/README.md#hook-capabilities--limitations) for examples.
+
 **Use in pipeline:**
 
 ```typescript
@@ -335,6 +382,28 @@ export class MyPlugin implements OnModuleInit {
 })
 ```
 
+**Register a script for search index enrichment:**
+
+```typescript
+DataHubPlugin.init({
+    scripts: {
+        'buildSearchAttributes': async (records, context) => {
+            return records.map(r => ({
+                ...r,
+                searchText: [r.name, r.sku, r.description]
+                    .filter(Boolean).join(' ').toLowerCase(),
+                facetCategories: r.categories?.map(c => c.name) || [],
+            }));
+        },
+    },
+})
+
+// Use in pipeline:
+.hooks({
+    BEFORE_SINK: [{ type: 'SCRIPT', scriptName: 'buildSearchAttributes' }],
+})
+```
+
 #### Webhook Hooks
 
 Send HTTP notifications to external systems:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oronts/vendure-data-hub-plugin",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "ETL data integration plugin for Vendure e-commerce",
   "author": {
     "name": "Oronts Website",

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

@@ -338,6 +338,12 @@ export interface ProductUpsertLoaderConfig {
     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 */
@@ -354,6 +360,12 @@ export interface ProductUpsertLoaderConfig {
     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 */
@@ -365,6 +377,14 @@ export interface VariantUpsertLoaderConfig {
     skuField?: string;
     /** 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 price map by currency code (object, e.g. { USD: 19.99, EUR: 17.50 }) */
@@ -388,8 +408,48 @@ export interface VariantUpsertLoaderConfig {
      *  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';
@@ -403,10 +463,14 @@ 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 */
@@ -457,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';
@@ -498,8 +599,18 @@ export interface CollectionUpsertLoaderConfig {
     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 */
@@ -541,14 +652,24 @@ 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 */
@@ -595,6 +716,10 @@ export interface FacetUpsertLoaderConfig {
     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 */
@@ -612,6 +737,10 @@ export interface FacetValueUpsertLoaderConfig {
     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 */
@@ -665,8 +794,14 @@ export interface PaymentMethodUpsertLoaderConfig {
     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 */
@@ -692,6 +827,8 @@ export interface ChannelUpsertLoaderConfig {
     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';
 }
@@ -711,8 +848,14 @@ export interface ShippingMethodUpsertLoaderConfig {
     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 */
@@ -754,6 +897,21 @@ export interface InventoryAdjustLoaderConfig {
     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 */
 export interface GenericLoaderConfig {
     adapterCode: string;
@@ -765,6 +923,7 @@ export type TypedLoaderConfig =
     | ProductUpsertLoaderConfig
     | VariantUpsertLoaderConfig
     | CustomerUpsertLoaderConfig
+    | OrderUpsertLoaderConfig
     | StockAdjustLoaderConfig
     | RestPostLoaderConfig
     | GraphqlMutationLoaderConfig
@@ -784,6 +943,7 @@ export type TypedLoaderConfig =
     | CustomerGroupUpsertLoaderConfig
     | StockLocationUpsertLoaderConfig
     | InventoryAdjustLoaderConfig
+    | EntityDeletionLoaderConfig
     | GenericLoaderConfig;
 
 // EXPORTER CONFIGS
@@ -972,7 +1132,7 @@ export interface RouteConfig {
 // PERMISSION MAPPINGS
 
 /** Loader adapter codes that require UpdateCatalog permission */
-export type UpdateCatalogLoaders = 'productUpsert' | 'variantUpsert' | 'stockAdjust' | 'collectionUpsert' | 'assetAttach' | 'assetImport' | 'facetUpsert' | 'facetValueUpsert' | 'stockLocationUpsert' | 'inventoryAdjust';
+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' | 'customerGroupUpsert';

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,6 +340,7 @@ export type {
     ProductUpsertLoaderConfig,
     VariantUpsertLoaderConfig,
     CustomerUpsertLoaderConfig,
+    OrderUpsertLoaderConfig,
     StockAdjustLoaderConfig,
     RestPostLoaderConfig,
     GraphqlMutationLoaderConfig,
@@ -349,6 +360,7 @@ export type {
     CustomerGroupUpsertLoaderConfig,
     StockLocationUpsertLoaderConfig,
     InventoryAdjustLoaderConfig,
+    EntityDeletionLoaderConfig,
     GenericLoaderConfig,
     TypedLoaderConfig,
     CsvExportConfig,

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/types/trigger.types.ts

@@ -253,8 +253,6 @@ export interface TriggerConfig {
     retryDelayMs?: number;
     /** Timeout for trigger execution in milliseconds */
     timeoutMs?: number;
-    /** Event type for event triggers (shorthand) */
-    eventType?: string;
 }
 
 /**
@@ -300,6 +298,4 @@ export interface PipelineTrigger extends TriggerConfig {
     rateLimit?: number;
     /** Require idempotency key (webhook triggers) */
     requireIdempotencyKey?: boolean;
-    /** Event type (event triggers) */
-    eventType?: string;
 }