@oronts/vendure-data-hub-plugin 0.1.0

package/dist/src/services/templates/template-registry.service.js

@@ -0,0 +1,328 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateRegistryService = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../../constants");
+const imports_1 = require("../../templates/imports");
+const OPERATION_TO_WIZARD = {
+    CREATE: 'SKIP',
+    UPDATE: 'UPDATE',
+    UPSERT: 'UPDATE',
+    MERGE: 'UPDATE',
+    DELETE: 'SKIP',
+};
+const SOURCE_TYPE_MAP = {
+    FILE_UPLOAD: 'FILE',
+    HTTP_API: 'API',
+    WEBHOOK: 'WEBHOOK',
+    GRAPHQL: 'API',
+    DATABASE: 'API',
+    FTP: 'FILE',
+    S3: 'FILE',
+    VENDURE_QUERY: 'API',
+    CDC: 'API',
+};
+function toWizardDefinition(template) {
+    const def = template.definition;
+    if (!def)
+        return undefined;
+    const sourceType = SOURCE_TYPE_MAP[def.source?.type ?? ''] ?? 'FILE';
+    const fileFormat = def.source?.format?.format ?? 'CSV';
+    const targetEntity = def.target?.entity;
+    const existingRecords = OPERATION_TO_WIZARD[def.target?.operation ?? ''] ?? 'UPDATE';
+    const lookupFields = def.target?.lookupFields;
+    const fieldMappings = def.mappings?.map(m => ({
+        sourceField: m.source,
+        targetField: m.target,
+    }));
+    return {
+        sourceType,
+        fileFormat,
+        targetEntity,
+        existingRecords,
+        lookupFields,
+        fieldMappings,
+    };
+}
+function builtinToCustom(template) {
+    return {
+        id: template.id,
+        name: template.name,
+        description: template.description,
+        category: template.category,
+        icon: template.icon,
+        requiredFields: template.requiredFields,
+        optionalFields: template.optionalFields,
+        sampleData: template.sampleData,
+        featured: template.featured,
+        tags: template.tags,
+        formats: template.formats?.map(f => f.toUpperCase()),
+        definition: toWizardDefinition(template),
+    };
+}
+let TemplateRegistryService = class TemplateRegistryService {
+    constructor(options) {
+        this.options = options;
+        this.customImportTemplates = [];
+        this.customExportTemplates = [];
+        if (this.options.importTemplates) {
+            this.customImportTemplates.push(...this.options.importTemplates);
+        }
+        if (this.options.exportTemplates) {
+            this.customExportTemplates.push(...this.options.exportTemplates);
+        }
+        if (this.options.connectors) {
+            for (const { definition } of this.options.connectors) {
+                if (definition.importTemplates) {
+                    for (const template of definition.importTemplates) {
+                        this.registerImportTemplate(template);
+                    }
+                }
+                if (definition.exportTemplates) {
+                    for (const template of definition.exportTemplates) {
+                        this.registerExportTemplate(template);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Register a custom import template.
+     * If a template with the same id already exists, it is replaced.
+     */
+    registerImportTemplate(template) {
+        const existing = this.customImportTemplates.findIndex(t => t.id === template.id);
+        if (existing >= 0) {
+            this.customImportTemplates[existing] = template;
+        }
+        else {
+            this.customImportTemplates.push(template);
+        }
+    }
+    /**
+     * Register a custom export template.
+     * If a template with the same id already exists, it is replaced.
+     */
+    registerExportTemplate(template) {
+        const existing = this.customExportTemplates.findIndex(t => t.id === template.id);
+        if (existing >= 0) {
+            this.customExportTemplates[existing] = template;
+        }
+        else {
+            this.customExportTemplates.push(template);
+        }
+    }
+    /** Returns built-in import templates (converted to wizard format) merged with custom templates */
+    getImportTemplates() {
+        const builtIn = (0, imports_1.getImportTemplates)().map(builtinToCustom);
+        const all = [...builtIn];
+        for (const custom of this.customImportTemplates) {
+            const idx = all.findIndex(t => t.id === custom.id);
+            if (idx >= 0) {
+                all[idx] = custom;
+            }
+            else {
+                all.push(custom);
+            }
+        }
+        return all;
+    }
+    /** Returns built-in export templates merged with custom templates */
+    getExportTemplates() {
+        const builtIn = BUILTIN_EXPORT_TEMPLATES;
+        const all = [...builtIn];
+        for (const custom of this.customExportTemplates) {
+            const idx = all.findIndex(t => t.id === custom.id);
+            if (idx >= 0) {
+                all[idx] = custom;
+            }
+            else {
+                all.push(custom);
+            }
+        }
+        return all;
+    }
+    /** Returns category metadata with template counts */
+    getImportTemplateCategories() {
+        return (0, imports_1.getTemplateCategories)();
+    }
+};
+exports.TemplateRegistryService = TemplateRegistryService;
+exports.TemplateRegistryService = TemplateRegistryService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(constants_1.DATAHUB_PLUGIN_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], TemplateRegistryService);
+/**
+ * All built-in export templates shipped with the plugin.
+ * This is the single source of truth for export templates.
+ * Custom templates are registered separately via plugin options or connectors.
+ */
+const BUILTIN_EXPORT_TEMPLATES = [
+    // --- Marketplace feed templates ---
+    {
+        id: 'GOOGLE_SHOPPING',
+        name: 'Google Merchant Center',
+        description: 'Google Shopping product feed with required attributes for Merchant Center listings',
+        format: 'XML',
+        requiredFields: ['id', 'title', 'description', 'link', 'image_link', 'price', 'availability'],
+        tags: ['feed', 'google', 'shopping'],
+        definition: {
+            sourceEntity: 'Product',
+            fields: ['id', 'name', 'description', 'slug', 'featuredAsset', 'price'],
+            formatOptions: { feedFormat: 'GOOGLE_SHOPPING' },
+        },
+    },
+    {
+        id: 'META_CATALOG',
+        name: 'Meta (Facebook) Catalog',
+        description: 'Facebook/Instagram product catalog feed for dynamic ads and shops',
+        format: 'CSV',
+        requiredFields: ['id', 'title', 'description', 'availability', 'condition', 'price', 'link', 'image_link', 'brand'],
+        tags: ['feed', 'meta', 'facebook'],
+        definition: {
+            sourceEntity: 'Product',
+            fields: ['id', 'name', 'description', 'price', 'slug', 'featuredAsset'],
+            formatOptions: { feedFormat: 'META_CATALOG' },
+        },
+    },
+    {
+        id: 'AMAZON',
+        name: 'Amazon Product Feed',
+        description: 'Amazon marketplace product feed with inventory and pricing data',
+        format: 'XML',
+        requiredFields: ['sku', 'product-id', 'title', 'description', 'price', 'quantity'],
+        tags: ['feed', 'amazon', 'marketplace'],
+        definition: {
+            sourceEntity: 'Product',
+            fields: ['sku', 'id', 'name', 'description', 'price'],
+            formatOptions: { feedFormat: 'AMAZON' },
+        },
+    },
+    // --- Product export templates ---
+    {
+        id: 'product-xml-feed',
+        name: 'Product XML Feed',
+        description: 'Export product catalog as XML feed for marketplace listings, comparison engines, or partner integrations.',
+        icon: 'file-code',
+        format: 'XML',
+        tags: ['products', 'feed', 'xml', 'marketplace'],
+        definition: {
+            sourceEntity: 'Product',
+            formatOptions: { xmlRoot: 'products', xmlItem: 'product' },
+        },
+    },
+    {
+        id: 'product-csv-export',
+        name: 'Product Catalog (CSV)',
+        description: 'Export full product catalog with variants, pricing, and attributes to CSV',
+        format: 'CSV',
+        requiredFields: [],
+        tags: ['products', 'catalog'],
+        definition: {
+            sourceEntity: 'Product',
+            formatOptions: { delimiter: ',', includeHeaders: true },
+        },
+    },
+    {
+        id: 'product-json-export',
+        name: 'Product Catalog (JSON)',
+        description: 'Export product catalog as structured JSON for API integrations and headless frontends',
+        format: 'JSON',
+        requiredFields: [],
+        tags: ['products', 'api', 'integration'],
+        definition: {
+            sourceEntity: 'Product',
+            formatOptions: { pretty: true },
+        },
+    },
+    // --- Order export templates ---
+    {
+        id: 'order-analytics-csv',
+        name: 'Order Analytics Export',
+        description: 'Export order data with line items, totals, and customer info for business intelligence and reporting.',
+        icon: 'bar-chart',
+        format: 'CSV',
+        requiredFields: ['id', 'code', 'total', 'createdAt'],
+        tags: ['orders', 'analytics', 'reporting', 'csv'],
+        definition: {
+            sourceEntity: 'Order',
+            formatOptions: { delimiter: ',', includeHeaders: true },
+        },
+    },
+    {
+        id: 'order-csv-export',
+        name: 'Order Export (CSV)',
+        description: 'Export order data with line items and totals for reporting and analytics',
+        format: 'CSV',
+        requiredFields: [],
+        tags: ['orders', 'reporting'],
+        definition: {
+            sourceEntity: 'Order',
+            formatOptions: { delimiter: ',', includeHeaders: true },
+        },
+    },
+    // --- Customer export templates ---
+    {
+        id: 'customer-export-gdpr',
+        name: 'Customer Data Export (GDPR)',
+        description: 'Export customer personal data for GDPR data portability requests. Includes all PII fields.',
+        icon: 'shield',
+        format: 'JSON',
+        tags: ['customers', 'gdpr', 'compliance', 'privacy'],
+        definition: {
+            sourceEntity: 'Customer',
+            formatOptions: { pretty: true },
+        },
+    },
+    {
+        id: 'customer-csv-export',
+        name: 'Customer Export (CSV)',
+        description: 'Export customer data with email, name, and addresses to CSV',
+        format: 'CSV',
+        requiredFields: [],
+        tags: ['customers'],
+        definition: {
+            sourceEntity: 'Customer',
+            formatOptions: { delimiter: ',', includeHeaders: true },
+        },
+    },
+    // --- Inventory export templates ---
+    {
+        id: 'inventory-report-csv',
+        name: 'Inventory Reconciliation Report',
+        description: 'Export current stock levels across all locations for warehouse reconciliation and audit.',
+        icon: 'clipboard-list',
+        format: 'CSV',
+        tags: ['inventory', 'reporting', 'audit'],
+        definition: {
+            sourceEntity: 'StockLevel',
+            formatOptions: { delimiter: ',', includeHeaders: true },
+        },
+    },
+    {
+        id: 'inventory-csv-export',
+        name: 'Inventory Report (CSV)',
+        description: 'Export current stock levels across all locations for inventory reconciliation',
+        format: 'CSV',
+        requiredFields: [],
+        tags: ['inventory', 'reporting'],
+        definition: {
+            sourceEntity: 'StockLevel',
+            formatOptions: { delimiter: ',', includeHeaders: true },
+        },
+    },
+];
+//# sourceMappingURL=template-registry.service.js.map

package/dist/src/services/templates/template-registry.service.js.map

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

package/dist/src/services/testing/index.d.ts

@@ -0,0 +1,2 @@
+export * from './step-test.service';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/services/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/src/services/testing/index.js

@@ -0,0 +1,18 @@
+"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-test.service"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/services/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/services/testing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC"}

package/dist/src/services/testing/step-test.service.d.ts

@@ -0,0 +1,45 @@
+import { RequestContext } from '@vendure/core';
+import { JsonObject } from '../../types/index';
+import { ExtractExecutor } from '../../runtime/executors/extract.executor';
+import { TransformExecutor } from '../../runtime/executors/transform.executor';
+import { LoadExecutor } from '../../runtime/executors/load.executor';
+import { RecordObject } from '../../runtime/executor-types';
+export interface ExtractPreviewResult {
+    records: RecordObject[];
+    totalCount: number;
+    notes: string[];
+}
+type TransformSimulationResult = RecordObject[];
+export interface ValidateSimulationResult {
+    records: RecordObject[];
+    summary: {
+        input: number;
+        passed: number;
+        failed: number;
+        passRate: number;
+    };
+}
+export interface LoadSimulationResult {
+    [key: string]: unknown;
+    summary: {
+        recordCount: number;
+        adapterCode: string;
+    };
+}
+interface ExtractPreviewOptions {
+    limit?: number;
+}
+export declare class StepTestService {
+    private readonly extractExecutor;
+    private readonly transformExecutor;
+    private readonly loadExecutor;
+    constructor(extractExecutor: ExtractExecutor, transformExecutor: TransformExecutor, loadExecutor: LoadExecutor);
+    private createTestExecutorContext;
+    previewExtract(ctx: RequestContext, stepConfig: JsonObject, options?: ExtractPreviewOptions): Promise<ExtractPreviewResult>;
+    simulateTransform(ctx: RequestContext, stepConfig: JsonObject, sampleData: JsonObject[]): Promise<TransformSimulationResult>;
+    simulateValidate(ctx: RequestContext, stepConfig: JsonObject, sampleData: JsonObject[]): Promise<ValidateSimulationResult>;
+    /** Dry-run simulation of load step without persisting data */
+    validateLoadConfig(ctx: RequestContext, stepConfig: JsonObject, sampleData: JsonObject[]): Promise<LoadSimulationResult>;
+}
+export {};
+//# sourceMappingURL=step-test.service.d.ts.map

package/dist/src/services/testing/step-test.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-test.service.d.ts","sourceRoot":"","sources":["../../../../src/services/testing/step-test.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAY,UAAU,EAA2C,MAAM,mBAAmB,CAAC;AAElG,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,KAAK,yBAAyB,GAAG,YAAY,EAAE,CAAC;AAEhD,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KACpB,CAAC;CACL;AAED,MAAM,WAAW,oBAAoB;IACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAED,UAAU,qBAAqB;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBACa,eAAe;IAEpB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,eAAe,EAAE,eAAe,EAChC,iBAAiB,EAAE,iBAAiB,EACpC,YAAY,EAAE,YAAY;IAG/C,OAAO,CAAC,yBAAyB;IAQ3B,cAAc,CAChB,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,qBAA0B,GACpC,OAAO,CAAC,oBAAoB,CAAC;IAoB1B,iBAAiB,CACnB,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EAAE,GACzB,OAAO,CAAC,yBAAyB,CAAC;IAmB/B,gBAAgB,CAClB,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EAAE,GACzB,OAAO,CAAC,wBAAwB,CAAC;IA8BpC,8DAA8D;IACxD,kBAAkB,CACpB,GAAG,EAAE,cAAc,EACnB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EAAE,GACzB,OAAO,CAAC,oBAAoB,CAAC;CAuBnC"}

package/dist/src/services/testing/step-test.service.js

@@ -0,0 +1,106 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StepTestService = void 0;
+const common_1 = require("@nestjs/common");
+const index_1 = require("../../types/index");
+const index_2 = require("../../constants/index");
+const extract_executor_1 = require("../../runtime/executors/extract.executor");
+const transform_executor_1 = require("../../runtime/executors/transform.executor");
+const load_executor_1 = require("../../runtime/executors/load.executor");
+let StepTestService = class StepTestService {
+    constructor(extractExecutor, transformExecutor, loadExecutor) {
+        this.extractExecutor = extractExecutor;
+        this.transformExecutor = transformExecutor;
+        this.loadExecutor = loadExecutor;
+    }
+    createTestExecutorContext() {
+        return {
+            cpData: null,
+            cpDirty: false,
+            markCheckpointDirty: () => { },
+        };
+    }
+    async previewExtract(ctx, stepConfig, options = {}) {
+        const step = {
+            key: 'test-extract',
+            type: index_1.StepType.EXTRACT,
+            name: 'Test Extract',
+            config: stepConfig ?? {},
+        };
+        const executorCtx = this.createTestExecutorContext();
+        const records = await this.extractExecutor.execute(ctx, step, executorCtx);
+        const limit = typeof options.limit === 'number' ? options.limit : index_2.PAGINATION.LIST_PAGE_SIZE;
+        return {
+            records: records.slice(0, Math.max(0, limit)),
+            totalCount: records.length,
+            notes: [],
+        };
+    }
+    async simulateTransform(ctx, stepConfig, sampleData) {
+        const step = {
+            key: 'test-transform',
+            type: index_1.StepType.TRANSFORM,
+            name: 'Test Transform',
+            config: stepConfig ?? {},
+        };
+        const input = Array.isArray(sampleData) ? sampleData : [];
+        const executorCtx = this.createTestExecutorContext();
+        return await this.transformExecutor.executeOperator(ctx, step, input, executorCtx);
+    }
+    async simulateValidate(ctx, stepConfig, sampleData) {
+        const step = {
+            key: 'test-validate',
+            type: index_1.StepType.VALIDATE,
+            name: 'Test Validate',
+            config: stepConfig ?? {},
+        };
+        const input = Array.isArray(sampleData) ? sampleData : [];
+        const out = await this.transformExecutor.executeValidate(ctx, step, input);
+        const passed = out.length;
+        const failed = input.length - passed;
+        return {
+            records: out,
+            summary: {
+                input: input.length,
+                passed,
+                failed,
+                passRate: input.length > 0 ? Math.round((passed / input.length) * 100) : 0,
+            },
+        };
+    }
+    /** Dry-run simulation of load step without persisting data */
+    async validateLoadConfig(ctx, stepConfig, sampleData) {
+        const step = {
+            key: 'test-load',
+            type: index_1.StepType.LOAD,
+            name: 'Test Load',
+            config: stepConfig ?? {},
+        };
+        const input = Array.isArray(sampleData) ? sampleData : [];
+        const simulation = await this.loadExecutor.simulate(ctx, step, input);
+        return {
+            ...simulation,
+            summary: {
+                recordCount: input.length,
+                adapterCode: stepConfig?.adapterCode || 'unknown',
+            },
+        };
+    }
+};
+exports.StepTestService = StepTestService;
+exports.StepTestService = StepTestService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [extract_executor_1.ExtractExecutor,
+        transform_executor_1.TransformExecutor,
+        load_executor_1.LoadExecutor])
+], StepTestService);
+//# sourceMappingURL=step-test.service.js.map

package/dist/src/services/testing/step-test.service.js.map

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

package/dist/src/services/validation/adapter-validation.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Adapter configuration validation for pipeline definitions.
+ * Handles validation of adapter codes, field schemas, and connectivity requirements.
+ */
+import { JsonValue, PipelineDefinition, StepType } from '../../types/index';
+import { DataHubRegistryService } from '../../sdk/registry.service';
+import { AdapterDefinition, StepConfigSchema, StepConfigSchemaField, SelectOption } from '../../sdk/types';
+import { PipelineDefinitionIssue } from '../../validation/pipeline-definition-error';
+import { AdapterType } from '../../../shared/types';
+export type { AdapterType } from '../../../shared/types';
+/**
+ * Step configuration with adapter code
+ */
+export interface AdapterStepConfig {
+    adapterCode?: string;
+    query?: string;
+    variables?: Record<string, JsonValue>;
+    [key: string]: unknown;
+}
+/**
+ * Type guard to check if adapter has a valid schema
+ */
+export declare function hasValidSchema(adapter: AdapterDefinition | undefined): adapter is AdapterDefinition & {
+    schema: StepConfigSchema;
+};
+/**
+ * Type guard for adapter field with options
+ */
+export declare function isFieldWithOptions(field: StepConfigSchemaField): field is StepConfigSchemaField & {
+    options: readonly SelectOption[];
+};
+/**
+ * Type guard to check if adapter has pure property
+ */
+export declare function hasStreamSafetyInfo(adapter: AdapterDefinition | undefined): adapter is AdapterDefinition & {
+    pure: boolean;
+};
+/**
+ * Validates that an operator is stream-safe when running in STREAM mode.
+ */
+export declare function validateOperatorStreamSafety(stepKey: string, opCode: string, adapter: AdapterDefinition, definition: PipelineDefinition, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Validates adapter code and returns the adapter definition if valid.
+ */
+export declare function validateAdapterConfig(stepKey: string, stepType: StepType, cfg: AdapterStepConfig, adapterType: AdapterType, registry: DataHubRegistryService, issues: PipelineDefinitionIssue[]): {
+    adapter: AdapterDefinition;
+    adapterCode: string;
+} | null;
+/**
+ * Validates adapter connectivity and stream safety requirements.
+ */
+export declare function validateAdapterConnectivity(stepKey: string, adapterCode: string, adapterType: AdapterType, adapter: AdapterDefinition, definition: PipelineDefinition, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Validates all fields in an adapter configuration against the schema.
+ */
+export declare function validateAdapterFields(stepKey: string, cfg: AdapterStepConfig, adapter: AdapterDefinition, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Validates that required fields are present.
+ */
+export declare function validateRequiredFields(stepKey: string, field: StepConfigSchemaField, value: JsonValue | undefined, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Validates field types match the expected schema type.
+ */
+export declare function validateFieldTypes(stepKey: string, field: StepConfigSchemaField, value: JsonValue, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Validates field values against allowed select options.
+ */
+export declare function validateFieldMappings(stepKey: string, field: StepConfigSchemaField, value: JsonValue, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Validates GraphQL extractor configuration including query variables.
+ */
+export declare function validateGraphQLExtractor(stepKey: string, cfg: AdapterStepConfig, issues: PipelineDefinitionIssue[]): void;
+/**
+ * Checks if a step type requires an adapter and returns true if built-in config is used.
+ */
+export declare function isUsingBuiltInEnrichment(stepType: StepType, cfg: AdapterStepConfig): boolean;
+/**
+ * Checks if this is a GraphQL extractor step.
+ */
+export declare function isGraphQLExtractor(adapterType: AdapterType, adapterCode: string): boolean;
+//# sourceMappingURL=adapter-validation.d.ts.map

package/dist/src/services/validation/adapter-validation.d.ts.map

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