@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/sdk/constants.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFORM_OPERATOR = exports.ROUTE_OPERATOR = exports.DEFAULT_TRIGGER_TYPE = exports.HOOK_ACTION = void 0;
+const enums_1 = require("../constants/enums");
+/**
+ * Hook action types for pipeline lifecycle events.
+ * Used in the `hooks` configuration of pipelines.
+ *
+ * @example
+ * ```typescript
+ * import { HOOK_ACTION } from '@oronts/vendure-data-hub-plugin/sdk';
+ *
+ * const action = { type: HOOK_ACTION.WEBHOOK, url: 'https://...' };
+ * ```
+ */
+exports.HOOK_ACTION = {
+    /** Send HTTP POST to a webhook URL */
+    WEBHOOK: enums_1.HookActionType.WEBHOOK,
+    /** Emit an event to the event bus */
+    EMIT: enums_1.HookActionType.EMIT,
+    /** Trigger another pipeline by code */
+    TRIGGER_PIPELINE: enums_1.HookActionType.TRIGGER_PIPELINE,
+    /** Log a message */
+    LOG: enums_1.HookActionType.LOG,
+    /** Run a sandboxed interceptor function that can modify records */
+    INTERCEPTOR: enums_1.HookActionType.INTERCEPTOR,
+    /** Run a named script function registered via plugin options */
+    SCRIPT: enums_1.HookActionType.SCRIPT,
+};
+/**
+ * Default trigger type used when no trigger config is provided.
+ * @default 'manual'
+ */
+exports.DEFAULT_TRIGGER_TYPE = 'MANUAL';
+/**
+ * Route condition comparison operators.
+ * Used in route step branch conditions and filter operators.
+ *
+ * @example
+ * ```typescript
+ * import { ROUTE_OPERATOR } from '@oronts/vendure-data-hub-plugin/sdk';
+ *
+ * const condition = { field: 'status', cmp: ROUTE_OPERATOR.EQ, value: 'active' };
+ * ```
+ */
+exports.ROUTE_OPERATOR = {
+    /** Equal (==) */
+    EQ: enums_1.RouteConditionOperator.EQ,
+    /** Not equal (!=) */
+    NE: enums_1.RouteConditionOperator.NE,
+    /** Greater than (>) */
+    GT: enums_1.RouteConditionOperator.GT,
+    /** Less than (<) */
+    LT: enums_1.RouteConditionOperator.LT,
+    /** Greater than or equal (>=) */
+    GTE: enums_1.RouteConditionOperator.GTE,
+    /** Less than or equal (<=) */
+    LTE: enums_1.RouteConditionOperator.LTE,
+    /** Value is in array */
+    IN: enums_1.RouteConditionOperator.IN,
+    /** Value is not in array */
+    NOT_IN: enums_1.RouteConditionOperator.NOT_IN,
+    /** String contains substring */
+    CONTAINS: enums_1.RouteConditionOperator.CONTAINS,
+    /** String does not contain substring */
+    NOT_CONTAINS: enums_1.RouteConditionOperator.NOT_CONTAINS,
+    /** String starts with prefix */
+    STARTS_WITH: enums_1.RouteConditionOperator.STARTS_WITH,
+    /** String ends with suffix */
+    ENDS_WITH: enums_1.RouteConditionOperator.ENDS_WITH,
+    /** String matches glob pattern */
+    MATCHES: enums_1.RouteConditionOperator.MATCHES,
+    /** String matches regex pattern */
+    REGEX: enums_1.RouteConditionOperator.REGEX,
+    /** Field exists (is defined) */
+    EXISTS: enums_1.RouteConditionOperator.EXISTS,
+    /** Field is null */
+    IS_NULL: enums_1.RouteConditionOperator.IS_NULL,
+};
+/**
+ * Transform step operators.
+ * Used in transform step configurations to specify data transformations.
+ *
+ * @example
+ * ```typescript
+ * import { TRANSFORM_OPERATOR } from '@oronts/vendure-data-hub-plugin/sdk';
+ *
+ * const operator = { op: TRANSFORM_OPERATOR.MAP, args: { mapping: {...} } };
+ * ```
+ */
+exports.TRANSFORM_OPERATOR = {
+    // Data operators
+    /** Map fields from source to destination paths */
+    MAP: 'map',
+    /** Set a static value at a path */
+    SET: 'set',
+    /** Remove a field */
+    REMOVE: 'remove',
+    /** Rename a field */
+    RENAME: 'rename',
+    /** Copy a field value to another path */
+    COPY: 'copy',
+    /** Render a string template */
+    TEMPLATE: 'template',
+    /** Generate hash of field values */
+    HASH: 'hash',
+    /** Generate a UUID */
+    UUID: 'uuid',
+    // String operators
+    /** Split string into array */
+    SPLIT: 'split',
+    /** Join array into string */
+    JOIN: 'join',
+    /** Trim whitespace */
+    TRIM: 'trim',
+    /** Convert to lowercase */
+    LOWERCASE: 'lowercase',
+    /** Convert to uppercase */
+    UPPERCASE: 'uppercase',
+    /** Generate URL-safe slug */
+    SLUGIFY: 'slugify',
+    /** Concatenate multiple fields into one */
+    CONCAT: 'concat',
+    /** Replace substring in a field */
+    REPLACE: 'replace',
+    /** Extract value using regex pattern */
+    EXTRACT_REGEX: 'extractRegex',
+    /** Replace using regex pattern */
+    REPLACE_REGEX: 'replaceRegex',
+    /** Strip HTML tags from a string */
+    STRIP_HTML: 'stripHtml',
+    /** Truncate string to a maximum length */
+    TRUNCATE: 'truncate',
+    // Numeric operators
+    /** Perform math operations (add, subtract, multiply, etc.) */
+    MATH: 'math',
+    /** Convert currency to minor units */
+    CURRENCY: 'currency',
+    /** Convert between units */
+    UNIT: 'unit',
+    /** Convert value to number */
+    TO_NUMBER: 'toNumber',
+    /** Convert value to string */
+    TO_STRING: 'toString',
+    /** Parse number from locale-formatted string */
+    PARSE_NUMBER: 'parseNumber',
+    /** Format number with locale/currency support */
+    FORMAT_NUMBER: 'formatNumber',
+    /** Convert decimal amount to cents */
+    TO_CENTS: 'toCents',
+    /** Round a number */
+    ROUND: 'round',
+    // Date operators
+    /** Format a date */
+    DATE_FORMAT: 'dateFormat',
+    /** Parse a date from string */
+    DATE_PARSE: 'dateParse',
+    /** Add time to a date */
+    DATE_ADD: 'dateAdd',
+    /** Calculate difference between two dates */
+    DATE_DIFF: 'dateDiff',
+    /** Set field to current timestamp */
+    NOW: 'now',
+    // Logic operators
+    /** Conditional filter (keep/drop) */
+    WHEN: 'when',
+    /** Conditional value assignment (if/then/else) */
+    IF_THEN_ELSE: 'ifThenElse',
+    /** Map values using switch/case logic */
+    SWITCH: 'switch',
+    /** Filter unchanged records (delta detection) */
+    DELTA_FILTER: 'deltaFilter',
+    // JSON operators
+    /** Parse JSON string to object */
+    PARSE_JSON: 'parseJson',
+    /** Stringify object to JSON */
+    STRINGIFY_JSON: 'stringifyJson',
+    /** Keep only specified fields */
+    PICK: 'pick',
+    /** Remove specified fields */
+    OMIT: 'omit',
+    // Enrichment operators
+    /** Lookup value from a map */
+    LOOKUP: 'lookup',
+    /** Return first non-null value from paths */
+    COALESCE: 'coalesce',
+    /** Enrich with defaults or lookups */
+    ENRICH: 'enrich',
+    /** Set a default value if field is missing */
+    DEFAULT: 'default',
+    /** Fetch data from HTTP endpoint */
+    HTTP_LOOKUP: 'httpLookup',
+    // Aggregation operators
+    /** Compute aggregate (count, sum, avg, etc.) */
+    AGGREGATE: 'aggregate',
+    /** Count items in an array field */
+    COUNT: 'count',
+    /** Deduplicate array values */
+    UNIQUE: 'unique',
+    /** Flatten nested arrays */
+    FLATTEN: 'flatten',
+    /** Get first element of an array */
+    FIRST: 'first',
+    /** Get last element of an array */
+    LAST: 'last',
+    /** Expand array field into multiple records */
+    EXPAND: 'expand',
+    /** Join two datasets by matching key fields */
+    MULTI_JOIN: 'multiJoin',
+    // Validation operators
+    /** Validate required fields are present */
+    VALIDATE_REQUIRED: 'validateRequired',
+    /** Validate field matches a pattern */
+    VALIDATE_FORMAT: 'validateFormat',
+    // Script operator
+    /** Execute inline JavaScript code */
+    SCRIPT: 'script',
+    // File operators
+    /** Resize images referenced in record fields */
+    IMAGE_RESIZE: 'imageResize',
+    /** Convert image format (JPEG, PNG, WebP, AVIF, GIF) */
+    IMAGE_CONVERT: 'imageConvert',
+    /** Generate PDF from HTML template with record data */
+    PDF_GENERATE: 'pdfGenerate',
+};
+//# sourceMappingURL=constants.js.map

package/dist/src/sdk/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/sdk/constants.ts"],"names":[],"mappings":"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"}

package/dist/src/sdk/dsl/context-builder.d.ts

@@ -0,0 +1,44 @@
+import { PipelineContext, PipelineCapabilities, Throughput, HookAction } from '../../types/index';
+export declare const hooks: {
+    /** `hooks.webhook('https://api.example.com/notify', { 'X-API-Key': 'secret' })` */
+    webhook(url: string, headers?: Record<string, string>): HookAction;
+    /** `hooks.emit('product.imported')` */
+    emit(event: string): HookAction;
+    /** `hooks.triggerPipeline('index-products')` */
+    triggerPipeline(pipelineCode: string): HookAction;
+    /** `hooks.log('INFO', 'Pipeline completed with {{recordCount}} records')` */
+    log(level: "DEBUG" | "INFO" | "WARN" | "ERROR", message: string): HookAction;
+};
+export declare const context: {
+    /** `context.forChannel('us-store', { contentLanguage: 'en' })` */
+    forChannel(channel: string, options?: Partial<Omit<PipelineContext, "channel">>): PipelineContext;
+    /** `context.withLanguage('de', { channel: 'eu-store' })` */
+    withLanguage(language: string, options?: Partial<Omit<PipelineContext, "contentLanguage">>): PipelineContext;
+    /** `context.batch(100, { channel: 'default' })` */
+    batch(batchSize: number, options?: Partial<Omit<PipelineContext, "throughput">>): PipelineContext;
+    /** `context.stream({ channel: 'realtime' })` */
+    stream(options?: Partial<Omit<PipelineContext, "runMode">>): PipelineContext;
+};
+export declare const throughput: {
+    /** `throughput.rateLimit(100)` */
+    rateLimit(rps: number): Throughput;
+    /** `throughput.batch(50, 4)` */
+    batch(size: number, concurrency?: number): Throughput;
+    /** `throughput.concurrent(8)` */
+    concurrent(concurrency: number): Throughput;
+    /** `throughput.withPause(0.1, 60, 'backoff')` */
+    withPause(threshold: number, intervalSec: number, strategy?: "BACKOFF" | "SHED" | "QUEUE"): Throughput;
+};
+export declare const capabilities: {
+    /** `capabilities.catalog()` - products, variants, collections */
+    catalog(): PipelineCapabilities;
+    /** `capabilities.customers()` */
+    customers(): PipelineCapabilities;
+    /** `capabilities.orders()` */
+    orders(): PipelineCapabilities;
+    /** `capabilities.inventory()` */
+    inventory(): PipelineCapabilities;
+    /** `capabilities.full()` - SuperAdmin required */
+    full(): PipelineCapabilities;
+};
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/src/sdk/dsl/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../../../src/sdk/dsl/context-builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAKlG,eAAO,MAAM,KAAK;IACd,mFAAmF;iBACtE,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU;IAIlE,uCAAuC;gBAC3B,MAAM,GAAG,UAAU;IAI/B,gDAAgD;kCAClB,MAAM,GAAG,UAAU;IAIjD,6EAA6E;eAClE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,WAAW,MAAM,GAAG,UAAU;CAG/E,CAAC;AAIF,eAAO,MAAM,OAAO;IAChB,kEAAkE;wBAC9C,MAAM,YAAY,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,GAAG,eAAe;IAIjG,4DAA4D;2BACrC,MAAM,YAAY,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,CAAC,GAAG,eAAe;IAI5G,mDAAmD;qBAClC,MAAM,YAAY,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC,GAAG,eAAe;IAIjG,gDAAgD;qBAC/B,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,GAAG,eAAe;CAG/E,CAAC;AAIF,eAAO,MAAM,UAAU;IACnB,kCAAkC;mBACnB,MAAM,GAAG,UAAU;IAIlC,gCAAgC;gBACpB,MAAM,yBAAoB,UAAU;IAIhD,iCAAiC;4BACT,MAAM,GAAG,UAAU;IAI3C,iDAAiD;yBAC5B,MAAM,eAAe,MAAM,aAAY,SAAS,GAAG,MAAM,GAAG,OAAO,GAAe,UAAU;CAGpH,CAAC;AAIF,eAAO,MAAM,YAAY;IACrB,iEAAiE;eACtD,oBAAoB;IAI/B,iCAAiC;iBACpB,oBAAoB;IAIjC,8BAA8B;cACpB,oBAAoB;IAI9B,iCAAiC;iBACpB,oBAAoB;IAIjC,kDAAkD;YAC1C,oBAAoB;CAM/B,CAAC"}

package/dist/src/sdk/dsl/context-builder.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capabilities = exports.throughput = exports.context = exports.hooks = void 0;
+const constants_1 = require("../constants");
+// HOOK BUILDERS
+exports.hooks = {
+    /** `hooks.webhook('https://api.example.com/notify', { 'X-API-Key': 'secret' })` */
+    webhook(url, headers) {
+        return { type: constants_1.HOOK_ACTION.WEBHOOK, url, headers };
+    },
+    /** `hooks.emit('product.imported')` */
+    emit(event) {
+        return { type: constants_1.HOOK_ACTION.EMIT, event };
+    },
+    /** `hooks.triggerPipeline('index-products')` */
+    triggerPipeline(pipelineCode) {
+        return { type: constants_1.HOOK_ACTION.TRIGGER_PIPELINE, pipelineCode };
+    },
+    /** `hooks.log('INFO', 'Pipeline completed with {{recordCount}} records')` */
+    log(level, message) {
+        return { type: constants_1.HOOK_ACTION.LOG, level, message };
+    },
+};
+// CONTEXT BUILDERS
+exports.context = {
+    /** `context.forChannel('us-store', { contentLanguage: 'en' })` */
+    forChannel(channel, options) {
+        return { channel, ...options };
+    },
+    /** `context.withLanguage('de', { channel: 'eu-store' })` */
+    withLanguage(language, options) {
+        return { contentLanguage: language, ...options };
+    },
+    /** `context.batch(100, { channel: 'default' })` */
+    batch(batchSize, options) {
+        return { throughput: { batchSize }, runMode: 'BATCH', ...options };
+    },
+    /** `context.stream({ channel: 'realtime' })` */
+    stream(options) {
+        return { runMode: 'STREAM', ...options };
+    },
+};
+// THROUGHPUT BUILDERS
+exports.throughput = {
+    /** `throughput.rateLimit(100)` */
+    rateLimit(rps) {
+        return { rateLimitRps: rps };
+    },
+    /** `throughput.batch(50, 4)` */
+    batch(size, concurrency = 1) {
+        return { batchSize: size, concurrency };
+    },
+    /** `throughput.concurrent(8)` */
+    concurrent(concurrency) {
+        return { concurrency };
+    },
+    /** `throughput.withPause(0.1, 60, 'backoff')` */
+    withPause(threshold, intervalSec, strategy = 'BACKOFF') {
+        return { pauseOnErrorRate: { threshold, intervalSec }, drainStrategy: strategy };
+    },
+};
+// CAPABILITIES BUILDERS
+exports.capabilities = {
+    /** `capabilities.catalog()` - products, variants, collections */
+    catalog() {
+        return { writes: ['CATALOG'], requires: ['UpdateCatalog'] };
+    },
+    /** `capabilities.customers()` */
+    customers() {
+        return { writes: ['CUSTOMERS'], requires: ['UpdateCustomer'] };
+    },
+    /** `capabilities.orders()` */
+    orders() {
+        return { writes: ['ORDERS'], requires: ['UpdateOrder'] };
+    },
+    /** `capabilities.inventory()` */
+    inventory() {
+        return { writes: ['INVENTORY'], requires: ['UpdateCatalog'] };
+    },
+    /** `capabilities.full()` - SuperAdmin required */
+    full() {
+        return {
+            writes: ['CATALOG', 'CUSTOMERS', 'ORDERS', 'PROMOTIONS', 'INVENTORY'],
+            requires: ['SuperAdmin'],
+        };
+    },
+};
+//# sourceMappingURL=context-builder.js.map

package/dist/src/sdk/dsl/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../../../src/sdk/dsl/context-builder.ts"],"names":[],"mappings":"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"}

package/dist/src/sdk/dsl/index.d.ts

@@ -0,0 +1,6 @@
+export * from './step-configs';
+export * from './route-builder';
+export * from './pipeline-builder';
+export * from './transform-builder';
+export * from './context-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/sdk/dsl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/sdk/dsl/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC"}

package/dist/src/sdk/dsl/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./step-configs"), exports);
+__exportStar(require("./route-builder"), exports);
+__exportStar(require("./pipeline-builder"), exports);
+__exportStar(require("./transform-builder"), exports);
+__exportStar(require("./context-builder"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/sdk/dsl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sdk/dsl/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,kDAAgC;AAChC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC"}

package/dist/src/sdk/dsl/pipeline-builder.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @example
+ * ```typescript
+ * import { createPipeline, operators, conditions } from '@oronts/vendure-data-hub-plugin/sdk';
+ *
+ * const pipeline = createPipeline()
+ *   .name('Product Import')
+ *   .description('Import products from CSV')
+ *   .trigger('start', { type: 'MANUAL' })
+ *   .extract('csv', { adapterCode: 'file', path: '/data/products.csv', format: 'CSV' })
+ *   .transform('map', {
+ *     operators: [
+ *       operators.map({ 'SKU': 'sku', 'Name': 'name' }),
+ *       operators.set('imported', true),
+ *     ],
+ *   })
+ *   .load('products', { adapterCode: 'productUpsert', strategy: 'UPSERT' })
+ *   .edge('start', 'csv')
+ *   .edge('csv', 'map')
+ *   .edge('map', 'products')
+ *   .build();
+ * ```
+ */
+import { PipelineDefinition, PipelineStepDefinition, PipelineEdge, JsonObject, PipelineCapabilities, PipelineContext, PipelineHooks } from '../../types/index';
+import type { StepType } from '../../../shared/types';
+import { TriggerConfig, ExtractStepConfig, TransformStepConfig, ValidateStepConfig, EnrichStepConfig, LoadStepConfig, ExportStepConfig, FeedStepConfig, SinkStepConfig, RouteStepConfig, GateStepConfig } from './step-configs';
+/**
+ * Fluent interface for building pipeline definitions.
+ * All methods return `this` to enable method chaining.
+ */
+export interface PipelineBuilder {
+    name(name: string): this;
+    description(description: string): this;
+    version(version: number): this;
+    context(context: PipelineContext): this;
+    capabilities(capabilities: PipelineCapabilities): this;
+    dependsOn(...codes: string[]): this;
+    hooks(hooks: PipelineHooks): this;
+    parallel(config?: {
+        maxConcurrentSteps?: number;
+        errorPolicy?: 'FAIL_FAST' | 'CONTINUE' | 'BEST_EFFORT';
+    }): this;
+    trigger(key: string, config?: TriggerConfig): this;
+    extract(key: string, config: ExtractStepConfig): this;
+    transform(key: string, config: TransformStepConfig): this;
+    validate(key: string, config: ValidateStepConfig): this;
+    enrich(key: string, config: EnrichStepConfig): this;
+    route(key: string, config: RouteStepConfig): this;
+    load(key: string, config: LoadStepConfig): this;
+    export(key: string, config: ExportStepConfig): this;
+    feed(key: string, config: FeedStepConfig): this;
+    sink(key: string, config: SinkStepConfig): this;
+    gate(key: string, config: GateStepConfig): this;
+    edge(from: string, to: string, branch?: string): this;
+    build(): PipelineDefinition;
+}
+export declare function createPipeline(): PipelineBuilder;
+export declare function definePipeline<T extends PipelineDefinition>(definition: T): T;
+export declare function step(key: string, type: StepType, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, 'key' | 'type' | 'config'>>): PipelineStepDefinition;
+export declare const steps: {
+    trigger: (key: string, config?: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    extract: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    transform: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    validate: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    enrich: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    route: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    load: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    export: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    feed: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    sink: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+    gate: (key: string, config: JsonObject, extras?: Partial<Omit<PipelineStepDefinition, "key" | "type" | "config">>) => PipelineStepDefinition;
+};
+export declare function edge(from: string, to: string, branch?: string): PipelineEdge;
+//# sourceMappingURL=pipeline-builder.d.ts.map

package/dist/src/sdk/dsl/pipeline-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-builder.d.ts","sourceRoot":"","sources":["../../../../src/sdk/dsl/pipeline-builder.ts"],"names":[],"mappings":"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"}