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

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 All notable changes to the Data Hub Plugin are documented here.
 
+## [0.1.5] - 2026-03-05
+
+### Added
+- **Operation-aware sink CRUD**: Sink executor partitions records by `__operation` field (UPSERT/DELETE) and dispatches to appropriate handlers. Delete handlers for all 7 sink engines: MeiliSearch, Elasticsearch, OpenSearch, Algolia, Typesense, Webhook, Queue Producer
+- **Event trigger operation injection**: Vendure entity events (ProductEvent, OrderEvent, etc.) now inject `__operation` (CREATE/UPDATE/DELETE) into seed records, enabling operation-aware pipelines
+- **BEFORE_SINK / AFTER_SINK hooks**: Sink step strategy now supports record-modifying interceptor hooks before and after search index operations
+- **5 hook demo pipelines**: Interceptor demo, Script demo (DI closure), Search enrichment (BEFORE_SINK), Multi-hook chain (proves modifications flow through all stages), All-stages demo (hooks at every step boundary)
+- **Hook stage metadata**: Extended hook stage constants with sink-specific stages and error handling stages
+- **117 e2e test implementations** across 14 loader test files: customer addresses (5 modes), product facet values (4 modes), product assets (4 modes + featured), variant modes (facets/assets/options), order lines (4 modes), collection modes (assets + filters), promotion modes (conditions + actions) — all using shared test helpers
+- **All 257 e2e tests passing** (was 204/259 in v0.1.4)
+
+### Fixed
+- Shared-helpers `updateViaService()` for ProductVariantService array signature
+- Product variant loader `updateEntity()` uses translations array correctly
+- Security and operator tests: query vs mutation, uppercase adapter types
+- Pipeline execution + error recovery tests: isolated `beforeAll`/`afterAll` per block
+- Variant/collection/promotion mode tests: use correct loader classes (not raw handlers)
+- Customer address handler: UPDATE_BY_ID falls back to APPEND_ONLY correctly
+- Order lines: customer setup + linesMode propagation
+- 14 unused imports removed, `let` → `const` fixes, lint-clean codebase
+
+### Changed
+- **DRY feed generators**: Extracted `buildBaseFeedItem()` shared across Google/Facebook generators, `flattenTranslationFields()` + `isJsonPrimitive()` in vendure-query helpers, `MAX_SERIALIZATION_DEPTH` constant
+
+## [0.1.4] - 2026-03-03
+
+### Added
+- **ROUTE step** with condition-based branching: per-branch condition editors using 19 comparison operators (eq, ne, gt, gte, lt, lte, in, notIn, contains, notContains, startsWith, endsWith, regex, exists, notExists, isNull, isEmpty, isNotEmpty, matches)
+- **dependencyOnly edge type** for graph execution: edges that enforce ordering without passing data
+- **Internal queue adapter** for testing sink/message pipelines without external infrastructure
+- **Stale run cleanup**: runs exceeding 1 hour automatically transition to TIMEOUT status
+- **Webhook HMAC-SHA256 signing** for sink webhook deliveries
+- **Export file registration** in REST API: exported files accessible via `/data-hub/files/:id`
+- **Per-branch condition editors** in dashboard route step configuration
+- **Resizable Configure Node panel** in workflow graph editor
+- **45 example pipelines** (previously 28) covering all step types, operators, and adapter combinations
+
+### Fixed
+- 9 critical runtime bugs: feed executor batch accumulation, gate timeout scheduling, slugify regex metacharacter injection, dot-notation field access in nested objects, trigger validation for FILE/MESSAGE types, event subscription field name mismatch, schedule activation field propagation, export format selection, and sink error serialization
+- Order import no longer produces NaN on completed orders with calculated totals
+- Trigger validation is now case-insensitive for trigger type matching
+- Webhook authentication errors now return 401 (was 500) for invalid credentials
+- Meilisearch sink correctly indexes both EN and DE translations
+
 ## [0.1.3] - 2026-02-26
 
 ### Added
@@ -167,7 +211,7 @@ Initial production release of the Data Hub Plugin for Vendure.
 - **Typesense** - Open-source search engine
 - **Queue Producer** - RabbitMQ/Redis Streams/SQS message publishing
 - **Webhook** - HTTP POST to external services
-- **PDF Generator** - Generate PDF documents from templates
+- **OpenSearch** - Open-source search and analytics engine
 
 ### Advanced Features
 
@@ -451,4 +495,5 @@ Pre-built integration for Pimcore PIM/DAM → Vendure sync:
 
 ## Version History
 
+- **0.1.5** (2026-03-05) - Operation-aware sink CRUD, hook demos, 257 e2e tests passing
 - **0.1.0** (2026-02-24) - Initial production release

package/README.md

@@ -37,18 +37,19 @@ A full-featured ETL (Extract, Transform, Load) plugin for [Vendure](https://www.
 - **Visual Pipeline Builder** - Drag-and-drop workflow editor with live validation
 - **Code-First DSL** - TypeScript API for defining pipelines programmatically
 - **9 Data Extractors** - HTTP/REST API, GraphQL, Vendure Query, File (CSV/JSON/XML/XLSX/NDJSON/TSV), Database (SQL), S3, FTP/SFTP, Webhook, CDC (Change Data Capture)
-- **22 Entity Loaders (16 entity types with multiple operations)** - Products, Variants, Customers, Customer Groups, Collections, Facets, Facet Values, Promotions, Orders (notes, transitions, coupons), Shipping Methods, Stock Locations, Stock/Inventory, Assets, Tax Rates, Payment Methods, Channels, REST POST, GraphQL Mutation
+- **24 Entity Loaders (16 entity types, 4 order operations, 1 deletion, 2 external API, 1 inventory)** - Products, Variants, Customers, Customer Groups, Collections, Facets, Facet Values, Promotions, Orders (upsert, notes, transitions, coupons), Shipping Methods, Stock Locations, Stock/Inventory, Assets, Tax Rates, Payment Methods, Channels, Entity Deletion, REST POST, GraphQL Mutation
 - **61 Transform Operators** - String (12), Date (5), Numeric (9), Logic (4), JSON (4), Data (8), Enrichment (5), Aggregation (8), Validation (2), Script (1), File (3) - **includes HTTP Lookup with caching, circuit breaker, and rate limiting**
 - **4 Feed Generators** - Google Merchant Center, Meta/Facebook Catalog, Amazon Seller Central, Custom Feed (CSV/JSON/XML/TSV)
-- **7 Search & Integration Sinks** - Elasticsearch, OpenSearch, MeiliSearch, Algolia, Typesense, Queue Producer (RabbitMQ/SQS/Redis), Webhook
+- **7 Search & Integration Sinks** - Elasticsearch, OpenSearch, MeiliSearch, Algolia, Typesense, Queue Producer (RabbitMQ/SQS/Redis), Webhook (with HMAC signing)
 - **24 Hook Stages** (18 for step types and 6 global) - Interceptors and scripts to modify data at any pipeline stage
 - **7 Connection Types** - HTTP/REST, S3, FTP, SFTP, Database (PostgreSQL/MySQL/SQLite/MSSQL/Oracle), Message Queue (RabbitMQ/SQS/Redis), Custom
 - **6 Trigger Types** - Manual, Scheduled (cron), Webhook, Vendure Events, File Watch, **Message Queue Consumer**
-- **Bi-directional Queue Support** - Consume from and produce to RabbitMQ (AMQP), Amazon SQS, Redis Streams
+- **Bi-directional Queue Support** - Consume from and produce to RabbitMQ (AMQP), Amazon SQS, Redis Streams, and internal queue adapter
 - **Horizontal Scaling** - Distributed locks via Redis or PostgreSQL for multi-instance deployments
 - **Checkpoint Recovery** - Resume failed pipelines from last successful record
 - **File Upload** - Drag-and-drop CSV/JSON file upload with automatic processing
 - **Real-time Monitoring** - Logs, analytics, error tracking, and dead letter queue
+- **Nested Entity Modes** - Configurable behavior for all nested entities (addresses, facet values, order lines, assets, etc.) to prevent duplicates and provide full control over data management
 
 ## Screenshots
 
@@ -339,7 +340,7 @@ Math operations: `add`, `subtract`, `multiply`, `divide`, `modulo`, `power`, `ro
 | `ifThenElse` | Conditional value | `{ op: 'ifThenElse', args: { condition: { field: 'type', cmp: 'eq', value: 'digital' }, thenValue: true, elseValue: false, target: 'isDigital' } }` |
 | `switch` | Multi-case mapping | `{ op: 'switch', args: { source: 'code', cases: [{ value: 'A', result: 'Active' }], default: 'Unknown', target: 'status' } }` |
 
-Comparison operators: `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `endsWith`, `regex`, `exists`, `isNull`
+Comparison operators (19): `eq`, `ne`, `gt`, `gte`, `lt`, `lte`, `in`, `notIn`, `contains`, `notContains`, `startsWith`, `endsWith`, `regex`, `exists`, `notExists`, `isNull`, `isEmpty`, `isNotEmpty`, `matches` (glob)
 
 ### Validation Operators
 
@@ -437,6 +438,7 @@ Execute custom JavaScript for complex transformations:
 | Customer Group Loader | `customerGroupUpsert` | Create/update customer groups by name; assign customers by email |
 | Collection Loader | `collectionUpsert` | Create/update collections with parent relationships |
 | Promotion Loader | `promotionUpsert` | Create/update promotions with conditions and actions |
+| Order Upsert Loader | `orderUpsert` | Order create/update for migrations with state transitions and line management |
 | Order Note Loader | `orderNote` | Attach notes to orders by code or id |
 | Order Transition Loader | `orderTransition` | Transition orders to new states |
 | Stock Adjust Loader | `stockAdjust` | Adjust inventory levels by SKU and stock location map |
@@ -450,6 +452,7 @@ Execute custom JavaScript for complex transformations:
 | Stock Location Loader | `stockLocationUpsert` | Create/update stock locations and warehouses |
 | Facet Loader | `facetUpsert` | Create/update facets with translations |
 | Facet Value Loader | `facetValueUpsert` | Create/update facet values with translations |
+| Entity Deletion Loader | `entityDeletion` | Soft-delete any of 13 entity types (Products, Variants, Collections, Facets, FacetValues, Customers, CustomerGroups, Promotions, ShippingMethods, PaymentMethods, TaxRates, Assets, StockLocations) by slug, SKU, ID, code, email, or name |
 | GraphQL Mutation Loader | `graphqlMutation` | Execute arbitrary GraphQL mutations against Vendure |
 | Asset Import Loader | `assetImport` | Import assets from URLs or file paths |
 | REST POST Loader | `restPost` | POST/PUT records to external REST endpoints |
@@ -506,25 +509,41 @@ Execute custom JavaScript for complex transformations:
 })
 ```
 
+### Condition-Based Routing (ROUTE Step)
+
+Route records to different branches based on field conditions using 19 comparison operators. Supports AND logic (multiple conditions per branch), automatic `default` branch for unmatched records, and `dependencyOnly` edges for execution ordering without data flow.
+
+```typescript
+.route('split-by-type', {
+    branches: [
+        { name: 'physical', when: [{ field: 'type', cmp: 'eq', value: 'physical' }] },
+        { name: 'digital', when: [{ field: 'type', cmp: 'eq', value: 'digital' }] },
+    ],
+})
+```
+
 ---
 
 ## Hooks
 
-Hooks let you run code at 18 different pipeline stages. Two types:
+Hooks let you run code at 24 different pipeline stages (18 step-level + 6 global). Two types:
 - **Interceptors**: Modify the record array (return modified records)
 - **Observation hooks**: Side effects only (webhooks, events, logging)
 
 ### Hook Stages
 
-**Data Processing:**
+**Data Processing (18 step-level):**
 - `BEFORE_EXTRACT`, `AFTER_EXTRACT`
 - `BEFORE_TRANSFORM`, `AFTER_TRANSFORM`
 - `BEFORE_VALIDATE`, `AFTER_VALIDATE`
 - `BEFORE_ENRICH`, `AFTER_ENRICH`
 - `BEFORE_ROUTE`, `AFTER_ROUTE`
 - `BEFORE_LOAD`, `AFTER_LOAD`
+- `BEFORE_EXPORT`, `AFTER_EXPORT`
+- `BEFORE_FEED`, `AFTER_FEED`
+- `BEFORE_SINK`, `AFTER_SINK`
 
-**Pipeline Lifecycle:**
+**Pipeline Lifecycle (6 global):**
 - `PIPELINE_STARTED`, `PIPELINE_COMPLETED`, `PIPELINE_FAILED`
 - `ON_ERROR`, `ON_RETRY`, `ON_DEAD_LETTER`
 
@@ -850,6 +869,8 @@ The plugin includes a full-featured admin dashboard:
 - **Visual Mode**: Drag-and-drop workflow builder with node palette
 - Live validation with error highlighting
 - Step tester for testing individual steps
+- `dependencyOnly` edges for execution ordering without data flow in graph mode
+- Stale run cleanup with automatic TIMEOUT status for stuck pipeline runs
 
 ### Dry Run
 - Execute pipeline without persisting changes
@@ -862,6 +883,7 @@ The plugin includes a full-featured admin dashboard:
 - Analytics dashboard with metrics
 - Per-pipeline health stats
 - Error rate tracking
+- `completedAt` and `errorMessage` fields on pipeline runs for precise tracking
 
 ### Queue Management
 - View pending, running, and failed jobs
@@ -890,7 +912,7 @@ DataHubPlugin.init({
 
 ### Code-First Connections
 
-Supported connection types: `http`, `postgres`, `mysql`, `s3`, `ftp`, `sftp`
+Supported connection types: `http`, `postgres`, `mysql`, `s3`, `ftp`, `sftp`, `rabbitmq`, `custom`
 
 ```typescript
 DataHubPlugin.init({

package/dashboard/components/pipelines/PipelineEditor.tsx

@@ -8,6 +8,7 @@ import {
     AlertTriangle,
     Zap,
     Bell,
+    Webhook,
 } from 'lucide-react';
 import { TriggersPanel } from '../shared/triggers-panel';
 import { StepConfigPanel } from '../shared/step-config';
@@ -19,9 +20,10 @@ import {
     PIPELINE_EDITOR_PANEL,
     DEFAULT_STEP_CONFIGS,
 } from '../../constants';
-import { useStepConfigs, useTriggerTypes } from '../../hooks';
+import { useStepConfigs, useTriggerTypes, useHookStages, useHookStageCategories } from '../../hooks';
 import type { MoveDirection, PipelineEditorPanel } from '../../constants';
 import { useAdapterCatalog } from '../../hooks';
+import { FALLBACK_STAGE_CATEGORIES } from '../../constants';
 import type {
     StepType,
     PipelineStepDefinition,
@@ -29,7 +31,7 @@ import type {
     PipelineEditorProps,
     JsonObject,
 } from '../../types';
-import { getCombinedTriggers, updateDefinitionWithTriggers } from '../../utils';
+import { getCombinedTriggers, updateDefinitionWithTriggers, resolveIconName } from '../../utils';
 
 const ADDABLE_STEP_TYPES = Object.keys(DEFAULT_STEP_CONFIGS).filter(
     t => t !== STEP_TYPE.ROUTE && t !== STEP_TYPE.GATE
@@ -157,10 +159,21 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
     // Get combined triggers from both steps and triggers array
     const combinedTriggers = useMemo(() => getCombinedTriggers(definition), [definition]);
 
+    // Hook stage metadata
+    const { hookStages: backendStages } = useHookStages();
+    const { categories: backendCategories } = useHookStageCategories();
+    const stageCategories = useMemo(
+        () => backendCategories.length > 0 ? backendCategories : FALLBACK_STAGE_CATEGORIES,
+        [backendCategories],
+    );
+    const hooks = definition.hooks ?? {};
+    const hookCount = useMemo(() => Object.values(hooks).reduce((sum, arr) => sum + (Array.isArray(arr) ? arr.length : 0), 0), [hooks]);
+
     // Panel switch handlers
     const handleSwitchToSteps = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.STEPS), []);
     const handleSwitchToTriggers = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.TRIGGERS), []);
     const handleSwitchToSettings = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.SETTINGS), []);
+    const handleSwitchToHooks = useCallback(() => setActivePanel(PIPELINE_EDITOR_PANEL.HOOKS), []);
 
     // Settings change handler
     const handleContextChange = useCallback((context: JsonObject) => {
@@ -192,7 +205,8 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
             ...selectedStep,
             key: updated.key,
             type: updated.type as StepType,
-            config: { ...updated.config, adapterCode: updated.adapterCode },
+            adapterCode: updated.adapterCode || selectedStep.adapterCode,
+            config: updated.config,
         });
     }, [selectedStepIndex, selectedStep, updateStep]);
 
@@ -249,6 +263,25 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                             <Settings className="h-3 w-3 inline mr-1" />
                             Settings
                         </button>
+                        <button
+                            type="button"
+                            role="tab"
+                            aria-selected={activePanel === PIPELINE_EDITOR_PANEL.HOOKS}
+                            aria-controls="panel-hooks"
+                            className={`flex-1 px-3 py-2 text-xs font-medium transition-colors ${
+                                activePanel === PIPELINE_EDITOR_PANEL.HOOKS
+                                    ? 'bg-primary/10 text-primary border-b-2 border-primary'
+                                    : 'text-muted-foreground hover:bg-muted'
+                            }`}
+                            onClick={handleSwitchToHooks}
+                            data-testid="datahub-editor-tab-hooks"
+                        >
+                            <Webhook className="h-3 w-3 inline mr-1" />
+                            Hooks
+                            {hookCount > 0 && (
+                                <span className="ml-1 px-1 py-0.5 text-[10px] rounded-full bg-primary/20 text-primary">{hookCount}</span>
+                            )}
+                        </button>
                     </div>
                 </div>
 
@@ -309,6 +342,58 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                         onChange={handleContextChange}
                     />
                 )}
+
+                {activePanel === PIPELINE_EDITOR_PANEL.HOOKS && (
+                    <div className="flex-1 overflow-auto">
+                        <div className="p-3 border-b bg-muted/50">
+                            <h3 className="font-semibold text-sm">Pipeline Hooks</h3>
+                            <p className="text-xs text-muted-foreground">
+                                {hookCount > 0 ? `${hookCount} hook${hookCount === 1 ? '' : 's'} configured (read-only)` : 'No hooks configured'}
+                            </p>
+                        </div>
+                        <div className="p-2 space-y-3">
+                            {stageCategories.map(cat => {
+                                const catStages = backendStages.filter(s => s.category === cat.key);
+                                const configuredStages = catStages.filter(s => {
+                                    const stageHooks = (hooks as Record<string, unknown[]>)[s.key];
+                                    return Array.isArray(stageHooks) && stageHooks.length > 0;
+                                });
+                                if (configuredStages.length === 0) return null;
+                                return (
+                                    <div key={cat.key}>
+                                        <div className="flex items-center gap-1.5 mb-1.5 px-1">
+                                            <span className={`text-[10px] px-1.5 py-0.5 rounded-full font-medium ${cat.color}`}>
+                                                {cat.label}
+                                            </span>
+                                        </div>
+                                        <div className="space-y-1">
+                                            {configuredStages.map(stage => {
+                                                const stageHooks = (hooks as Record<string, unknown[]>)[stage.key] ?? [];
+                                                const StageIcon = resolveIconName(stage.icon) ?? Zap;
+                                                return (
+                                                    <div key={stage.key} className="px-2 py-1.5 rounded bg-muted/50 border text-xs">
+                                                        <div className="flex items-center gap-1.5 font-medium">
+                                                            <StageIcon className="h-3 w-3 text-muted-foreground" />
+                                                            {stage.label}
+                                                            <span className="text-muted-foreground">({stageHooks.length})</span>
+                                                        </div>
+                                                    </div>
+                                                );
+                                            })}
+                                        </div>
+                                    </div>
+                                );
+                            })}
+                            {hookCount === 0 && (
+                                <div className="p-4 text-center text-muted-foreground text-xs">
+                                    <Webhook className="h-6 w-6 mx-auto mb-2 opacity-30" />
+                                    <p>No hooks configured.</p>
+                                    <p className="mt-1">Hooks are defined in code via the pipeline builder DSL.</p>
+                                </div>
+                            )}
+                        </div>
+                    </div>
+                )}
             </div>
 
             <div className="flex-1 overflow-auto">
@@ -319,7 +404,7 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                                 key: selectedStep.key,
                                 type: selectedStep.type,
                                 config: selectedStep.config ?? {},
-                                adapterCode: selectedStep.config?.adapterCode as string | undefined,
+                                adapterCode: selectedStep.adapterCode ?? selectedStep.config?.adapterCode as string | undefined,
                             }}
                             onChange={handleSelectedStepChange}
                             catalog={adapters}
@@ -369,7 +454,7 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                             )}
                         </div>
                     </div>
-                ) : (
+                ) : activePanel === PIPELINE_EDITOR_PANEL.SETTINGS ? (
                     <div className="p-6">
                         <h3 className="font-semibold mb-4">Pipeline Settings</h3>
                         <p className="text-sm text-muted-foreground">
@@ -406,6 +491,75 @@ export function PipelineEditor({ definition, onChange, issues = [] }: PipelineEd
                             </div>
                         </div>
                     </div>
+                ) : (
+                    <div className="p-6">
+                        <div className="flex items-center gap-2 mb-4">
+                            <Webhook className="h-5 w-5 text-primary" />
+                            <h3 className="font-semibold">Pipeline Hooks</h3>
+                            <span className="text-xs text-muted-foreground">(read-only)</span>
+                        </div>
+                        <p className="text-sm text-muted-foreground mb-4">
+                            Hooks run custom code at specific points during pipeline execution.
+                            They are defined in code via the pipeline builder DSL.
+                        </p>
+                        {hookCount > 0 ? (
+                            <div className="space-y-4">
+                                {stageCategories.map(cat => {
+                                    const catStages = backendStages.filter(s => s.category === cat.key);
+                                    const configuredStages = catStages.filter(s => {
+                                        const stageHooks = (hooks as Record<string, unknown[]>)[s.key];
+                                        return Array.isArray(stageHooks) && stageHooks.length > 0;
+                                    });
+                                    if (configuredStages.length === 0) return null;
+                                    return (
+                                        <div key={cat.key}>
+                                            <div className="flex items-center gap-2 mb-2">
+                                                <span className={`text-xs px-2 py-0.5 rounded-full font-medium ${cat.color}`}>
+                                                    {cat.label}
+                                                </span>
+                                                <span className="text-xs text-muted-foreground">{cat.description}</span>
+                                            </div>
+                                            <div className="space-y-2">
+                                                {configuredStages.map(stage => {
+                                                    const stageHooks = (hooks as Record<string, Array<Record<string, unknown>>>)[stage.key] ?? [];
+                                                    const StageIcon = resolveIconName(stage.icon) ?? Zap;
+                                                    return (
+                                                        <div key={stage.key} className="p-3 rounded-lg border bg-muted/30">
+                                                            <div className="flex items-center gap-2 mb-2">
+                                                                <StageIcon className="h-4 w-4 text-primary" />
+                                                                <span className="text-sm font-medium">{stage.label}</span>
+                                                            </div>
+                                                            <p className="text-xs text-muted-foreground mb-2">{stage.description}</p>
+                                                            <div className="space-y-1">
+                                                                {stageHooks.map((hook, i) => (
+                                                                    <div key={i} className="flex items-center gap-2 text-xs px-2 py-1 rounded bg-background border">
+                                                                        <span className="px-1.5 py-0.5 rounded bg-primary/10 text-primary font-mono">
+                                                                            {String(hook.type || 'UNKNOWN')}
+                                                                        </span>
+                                                                        <span className="text-muted-foreground truncate">
+                                                                            {String(hook.name || hook.scriptName || hook.event || hook.message || '')}
+                                                                        </span>
+                                                                    </div>
+                                                                ))}
+                                                            </div>
+                                                        </div>
+                                                    );
+                                                })}
+                                            </div>
+                                        </div>
+                                    );
+                                })}
+                            </div>
+                        ) : (
+                            <div className="flex flex-col items-center justify-center py-12 text-muted-foreground">
+                                <Webhook className="h-12 w-12 mb-4 opacity-20" />
+                                <p className="text-sm font-medium">No hooks configured</p>
+                                <p className="text-xs mt-1 text-center max-w-xs">
+                                    Add hooks via the pipeline builder DSL using <code className="px-1 py-0.5 bg-muted rounded text-xs">.hooks()</code>
+                                </p>
+                            </div>
+                        )}
+                    </div>
                 )}
             </div>
         </div>

package/dashboard/components/pipelines/ReactFlowPipelineEditor.tsx

@@ -156,7 +156,7 @@ export function ReactFlowPipelineEditor({
                 label,
                 type: category,
                 adapterCode: nodeType,
-                config: { adapterCode: nodeType },
+                config: {},
             },
         };
 
@@ -194,7 +194,7 @@ export function ReactFlowPipelineEditor({
                     label,
                     type: category,
                     adapterCode: nodeType,
-                    config: { adapterCode: nodeType },
+                    config: {},
                 },
             };
 
@@ -487,7 +487,7 @@ function NodePaletteDynamic({ adapters, onDragStart, onAddNode }: { adapters: Ad
                 const items = adapters.filter(a => a.type === adapterType);
                 return {
                     key: category,
-                    label: config.label === 'Source' ? 'Data Sources' : `${config.label}s`,
+                    label: config.label === 'Source' ? 'Data Sources' : config.label === 'Enrich' ? 'Enrichment' : `${config.label}s`,
                     items,
                     category,
                     icon: config.icon,

package/dashboard/components/pipelines/shared/NodePropertiesPanel.tsx

@@ -16,6 +16,9 @@ import { useAdapterCatalog, AdapterMetadata } from '../../../hooks';
 import { StepConfigPanel, StepConfigData, OperatorCheatSheetButton } from '../../shared/step-config';
 import { PANEL_WIDTHS, SCROLL_HEIGHTS } from '../../../constants';
 
+/** Minimum panel width (pixels) when resizing */
+const MIN_PANEL_WIDTH = parseInt(PANEL_WIDTHS.PROPERTIES_MIN, 10) || 380;
+
 export interface NodePropertiesPanelProps {
     node: Node<PipelineNodeData> | null;
     onUpdate: (node: Node<PipelineNodeData>) => void;
@@ -48,6 +51,31 @@ function NodePropertiesPanelComponent({
     const connectionCodes = externalConnectionCodes ?? hookResult.connectionCodes;
     const secretOptions = externalSecretOptions ?? hookResult.secretOptions;
 
+    // Resizable panel width
+    const defaultWidth = parseInt(panelWidth, 10) || 520;
+    const [width, setWidth] = React.useState(defaultWidth);
+    const dragging = React.useRef(false);
+
+    const onResizeStart = useCallback((e: React.MouseEvent) => {
+        e.preventDefault();
+        dragging.current = true;
+        const startX = e.clientX;
+        const startW = width;
+        const onMove = (ev: MouseEvent) => {
+            if (!dragging.current) return;
+            // Panel opens from right — dragging left increases width
+            const delta = startX - ev.clientX;
+            setWidth(Math.max(MIN_PANEL_WIDTH, Math.min(window.innerWidth * 0.9, startW + delta)));
+        };
+        const onUp = () => {
+            dragging.current = false;
+            document.removeEventListener('mousemove', onMove);
+            document.removeEventListener('mouseup', onUp);
+        };
+        document.addEventListener('mousemove', onMove);
+        document.addEventListener('mouseup', onUp);
+    }, [width]);
+
     const data = node?.data;
 
     const selectedAdapter = useMemo(
@@ -73,8 +101,8 @@ function NodePropertiesPanelComponent({
                 ...data,
                 label: updated.key,
                 type: updated.type,
-                config: { ...updated.config, adapterCode: updated.adapterCode },
-                adapterCode: updated.adapterCode,
+                config: updated.config,
+                adapterCode: updated.adapterCode || data.adapterCode,
             },
         });
     }, [node, data, onUpdate]);
@@ -85,9 +113,19 @@ function NodePropertiesPanelComponent({
     return (
         <Sheet open={!!node} onOpenChange={() => onClose()}>
             <SheetContent
-                className="overflow-y-auto p-0"
-                style={{ width: panelWidth, maxWidth: PANEL_WIDTHS.MAX_VW }}
+                side="right"
+                className="overflow-y-auto p-0 !max-w-none"
+                style={{ width: `${width}px`, maxWidth: PANEL_WIDTHS.MAX_VW }}
             >
+                {/* Resize drag handle (left edge) */}
+                <div
+                    className="absolute left-0 top-0 bottom-0 w-1.5 cursor-col-resize z-50
+                               hover:bg-primary/20 active:bg-primary/30 transition-colors"
+                    onMouseDown={onResizeStart}
+                    role="separator"
+                    aria-orientation="vertical"
+                    aria-label="Resize panel"
+                />
                 <SheetHeader className="px-4 py-3 border-b bg-muted/30">
                     <SheetTitle className="flex items-center justify-between">
                         <div className="flex items-center gap-2">

package/dashboard/components/pipelines/shared/StepListItem.tsx

@@ -96,9 +96,9 @@ function StepListItemComponent({
                         {config?.label ?? step.type}
                     </Badge>
                 </div>
-                {step.config?.adapterCode && (
+                {(step.adapterCode || step.config?.adapterCode) && (
                     <p className="text-xs text-muted-foreground truncate">
-                        {String(step.config.adapterCode)}
+                        {String(step.adapterCode || step.config?.adapterCode)}
                     </p>
                 )}
             </div>