@caracal-lynx/sluice 0.1.0

package/dist/adapters/target/bluecherry.js

@@ -0,0 +1,127 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+/**
+ * BlueCherry (CGS) ERP target adapter.
+ *
+ * Validates that every REQUIRED_COLUMN for the target entity exists in
+ * stg_transformed, then writes a CSV honouring:
+ *   - default includeHeader: true
+ *   - default dateFormat: MM/DD/YYYY
+ *   - any column whose name ends with `Date` (case-insensitive) auto-formatted
+ *   - nullValue for null/undefined cells
+ *   - template: 'default' → REQUIRED_COLUMNS[entity] + any extra stg_transformed columns
+ *   - template: '<path>'  → first line of the CSV file is the column order
+ *
+ * Per plan risk #5: the required-column check runs at the top of `load()`
+ * (the `connect()` interface doesn't carry a StagingStore, so the check can't
+ * live there without changing the interface).
+ */
+import * as fs from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
+import * as path from 'node:path';
+import { stringify } from 'csv-stringify/sync';
+import dayjs from 'dayjs';
+import customParseFormat from 'dayjs/plugin/customParseFormat.js';
+import { ConfigError, LoadError } from '../../utils/errors.js';
+import { logger } from '../../utils/logger.js';
+dayjs.extend(customParseFormat);
+const STAGING_TABLE = 'stg_transformed';
+// These column names are internal conventions. Verify against actual
+// BlueCherry import documentation before running a live migration.
+const REQUIRED_COLUMNS = Object.freeze({
+    Style: ['StyleNo', 'StyleDesc', 'Division', 'Season', 'CostPrice', 'RetailPrice', 'ActiveFlag'],
+    Vendor: ['VendorNo', 'VendorName', 'Country', 'CurrencyCode'],
+    PurchaseOrder: ['PONumber', 'VendorNo', 'Season', 'OrderDate', 'DeliveryDate'],
+    PODetail: ['PONumber', 'StyleNo', 'ColourCode', 'SizeCode', 'Quantity', 'CostPrice'],
+    Season: ['SeasonCode', 'SeasonDesc', 'StartDate', 'EndDate'],
+    ColourSize: ['StyleNo', 'ColourCode', 'ColourDesc', 'SizeCode', 'SizeDesc'],
+});
+function isDateColumn(name) {
+    return name.toLowerCase().endsWith('date');
+}
+function reformatIfDate(colName, value, outputFormat) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    if (!isDateColumn(colName))
+        return String(value);
+    const parsed = dayjs(String(value));
+    if (!parsed.isValid())
+        return String(value);
+    return parsed.format(outputFormat);
+}
+export class BlueCherryTargetAdapter {
+    id = 'bluecherry';
+    async connect(config) {
+        // Basic config sanity — the full column check needs access to the store,
+        // so it runs inside load().
+        if (!config.entity) {
+            throw new ConfigError('bluecherry target requires `entity`');
+        }
+        if (!REQUIRED_COLUMNS[config.entity]) {
+            throw new ConfigError(`bluecherry: unknown entity "${config.entity}". Known: ${Object.keys(REQUIRED_COLUMNS).join(', ')}`);
+        }
+    }
+    async disconnect() {
+        // nothing to release
+    }
+    async load(config, store, _runConfig, onProgress) {
+        if (!config.output) {
+            throw new LoadError('bluecherry target requires `output`');
+        }
+        if (!config.entity) {
+            throw new ConfigError('bluecherry target requires `entity`');
+        }
+        const required = REQUIRED_COLUMNS[config.entity];
+        if (!required) {
+            throw new ConfigError(`bluecherry: unknown entity "${config.entity}"`);
+        }
+        const staged = await store.columnNames(STAGING_TABLE);
+        const missing = required.filter((c) => !staged.includes(c));
+        if (missing.length > 0) {
+            throw new ConfigError(`bluecherry: stg_transformed is missing required columns for entity "${config.entity}": ${missing.join(', ')}`);
+        }
+        // Resolve column order from `template`
+        let columnOrder;
+        if (config.template === 'default' || config.template === undefined) {
+            const extras = staged.filter((c) => !required.includes(c));
+            columnOrder = [...required, ...extras];
+        }
+        else {
+            try {
+                const firstLine = readFileSync(config.template, 'utf-8').split(/\r?\n/)[0] ?? '';
+                columnOrder = firstLine
+                    .split(config.delimiter ?? ',')
+                    .map((c) => c.trim())
+                    .filter(Boolean);
+            }
+            catch (err) {
+                throw new ConfigError(`bluecherry: failed to read template "${config.template}": ${err instanceof Error ? err.message : String(err)}`, err);
+            }
+            const templateMissing = required.filter((c) => !columnOrder.includes(c));
+            if (templateMissing.length > 0) {
+                throw new ConfigError(`bluecherry: template is missing required columns: ${templateMissing.join(', ')}`);
+            }
+        }
+        const outputPath = path.resolve(config.output);
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        const dateFormat = config.dateFormat ?? 'MM/DD/YYYY';
+        const nullValue = config.nullValue;
+        const includeHeader = config.includeHeader ?? true;
+        const rows = await store.query(`SELECT * FROM "${STAGING_TABLE}"`);
+        const csvRows = [];
+        if (includeHeader)
+            csvRows.push(columnOrder);
+        for (const row of rows) {
+            csvRows.push(columnOrder.map((col) => {
+                const formatted = reformatIfDate(col, row[col], dateFormat);
+                return formatted === null ? nullValue : formatted;
+            }));
+        }
+        const csv = stringify(csvRows, { delimiter: config.delimiter ?? ',' });
+        await fs.writeFile(outputPath, csv, 'utf-8');
+        onProgress(rows.length);
+        logger.debug({ outputPath, rowsLoaded: rows.length, entity: config.entity, columns: columnOrder.length }, 'bluecherry target: load complete');
+        return { rowsLoaded: rows.length, rowsFailed: 0, outputPath };
+    }
+}
+//# sourceMappingURL=bluecherry.js.map

package/dist/adapters/target/bluecherry.js.map

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

package/dist/adapters/target/csv.d.ts

@@ -0,0 +1,10 @@
+import type { RunConfig, TargetConfig } from '../../config/types.js';
+import type { StagingStore } from '../../staging/index.js';
+import type { LoadResult, TargetAdapter } from './types.js';
+export declare class CsvTargetAdapter implements TargetAdapter {
+    readonly id = "csv";
+    connect(_config: TargetConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    load(config: TargetConfig, store: StagingStore, _runConfig: RunConfig, onProgress: (rows: number) => void): Promise<LoadResult>;
+}
+//# sourceMappingURL=csv.d.ts.map

package/dist/adapters/target/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../../../src/adapters/target/csv.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI5D,qBAAa,gBAAiB,YAAW,aAAa;IACpD,QAAQ,CAAC,EAAE,SAAS;IAEd,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CACR,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,UAAU,CAAC;CAqBvB"}

package/dist/adapters/target/csv.js

@@ -0,0 +1,40 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+/**
+ * Generic CSV target adapter.
+ *
+ * Reads `stg_transformed` via StagingStore.exportToCsv (DuckDB COPY).
+ * Honours target.includeHeader (default true), delimiter, nullValue.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { LoadError } from '../../utils/errors.js';
+import { logger } from '../../utils/logger.js';
+const STAGING_TABLE = 'stg_transformed';
+export class CsvTargetAdapter {
+    id = 'csv';
+    async connect(_config) {
+        // No persistent connection needed.
+    }
+    async disconnect() {
+        // Nothing to release.
+    }
+    async load(config, store, _runConfig, onProgress) {
+        if (!config.output) {
+            throw new LoadError('csv target requires `output`');
+        }
+        const outputPath = path.resolve(config.output);
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        const rowsLoaded = await store.rowCount(STAGING_TABLE);
+        const includeHeader = config.includeHeader ?? true;
+        await store.exportToCsv(STAGING_TABLE, outputPath, {
+            delimiter: config.delimiter,
+            header: includeHeader,
+            nullValue: config.nullValue,
+        });
+        onProgress(rowsLoaded);
+        logger.debug({ outputPath, rowsLoaded }, 'csv target: load complete');
+        return { rowsLoaded, rowsFailed: 0, outputPath };
+    }
+}
+//# sourceMappingURL=csv.js.map

package/dist/adapters/target/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../../src/adapters/target/csv.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uCAAuC;AAEvC;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG/C,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,OAAO,gBAAgB;IAClB,EAAE,GAAG,KAAK,CAAC;IAEpB,KAAK,CAAC,OAAO,CAAC,OAAqB;QACjC,mCAAmC;IACrC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,sBAAsB;IACxB,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAoB,EACpB,KAAmB,EACnB,UAAqB,EACrB,UAAkC;QAElC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,MAAM,IAAI,SAAS,CAAC,8BAA8B,CAAC,CAAC;QACtD,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9D,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC;QAEnD,MAAM,KAAK,CAAC,WAAW,CAAC,aAAa,EAAE,UAAU,EAAE;YACjD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,aAAa;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,UAAU,CAAC,UAAU,CAAC,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,2BAA2B,CAAC,CAAC;QAEtE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC;IACnD,CAAC;CACF"}

package/dist/adapters/target/ifs.d.ts

@@ -0,0 +1,10 @@
+import type { RunConfig, TargetConfig } from '../../config/types.js';
+import { type StagingStore } from '../../staging/index.js';
+import type { LoadResult, TargetAdapter } from './types.js';
+export declare class IfsTargetAdapter implements TargetAdapter {
+    readonly id = "ifs";
+    connect(_config: TargetConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    load(config: TargetConfig, store: StagingStore, _runConfig: RunConfig, onProgress: (rows: number) => void): Promise<LoadResult>;
+}
+//# sourceMappingURL=ifs.d.ts.map

package/dist/adapters/target/ifs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ifs.d.ts","sourceRoot":"","sources":["../../../src/adapters/target/ifs.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI5D,qBAAa,gBAAiB,YAAW,aAAa;IACpD,QAAQ,CAAC,EAAE,SAAS;IAEd,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,IAAI,CACR,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,SAAS,EACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,UAAU,CAAC;CAyCvB"}

package/dist/adapters/target/ifs.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+/**
+ * IFS ERP target adapter.
+ *
+ * IFS bulk import expects a UTF-8 CSV, typically without a header row, with
+ * columns in a fixed order the downstream loader understands. This adapter
+ * emits the CSV via DuckDB's COPY with an explicit SELECT list when
+ * `columnOrder` is set.
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { quoteIdent } from '../../staging/index.js';
+import { LoadError } from '../../utils/errors.js';
+import { logger } from '../../utils/logger.js';
+const STAGING_TABLE = 'stg_transformed';
+export class IfsTargetAdapter {
+    id = 'ifs';
+    async connect(_config) {
+        // Nothing to establish.
+    }
+    async disconnect() {
+        // Nothing to release.
+    }
+    async load(config, store, _runConfig, onProgress) {
+        if (!config.output) {
+            throw new LoadError('ifs target requires `output`');
+        }
+        const outputPath = path.resolve(config.output);
+        await fs.mkdir(path.dirname(outputPath), { recursive: true });
+        const includeHeader = config.includeHeader ?? false; // IFS default: no header
+        const rowsLoaded = await store.rowCount(STAGING_TABLE);
+        const allColumns = await store.columnNames(STAGING_TABLE);
+        let orderedColumns;
+        if (config.columnOrder && config.columnOrder.length > 0) {
+            const missing = config.columnOrder.filter((c) => !allColumns.includes(c));
+            if (missing.length > 0) {
+                throw new LoadError(`ifs: columnOrder references columns not present in stg_transformed: ${missing.join(', ')}`);
+            }
+            orderedColumns = config.columnOrder;
+        }
+        else {
+            orderedColumns = allColumns;
+        }
+        const safePath = outputPath.replace(/\\/g, '/').replace(/'/g, "''");
+        const safeDelim = (config.delimiter ?? ',').replace(/'/g, "''");
+        const safeNull = config.nullValue.replace(/'/g, "''");
+        const selectList = orderedColumns.map(quoteIdent).join(', ');
+        await store.query(`COPY (SELECT ${selectList} FROM ${quoteIdent(STAGING_TABLE)}) TO '${safePath}' (HEADER ${includeHeader ? 'TRUE' : 'FALSE'}, DELIMITER '${safeDelim}', NULL '${safeNull}')`);
+        onProgress(rowsLoaded);
+        logger.debug({ outputPath, rowsLoaded, columns: orderedColumns.length }, 'ifs target: load complete');
+        return { rowsLoaded, rowsFailed: 0, outputPath };
+    }
+}
+//# sourceMappingURL=ifs.js.map

package/dist/adapters/target/ifs.js.map

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

package/dist/adapters/target/index.d.ts

@@ -0,0 +1,8 @@
+export { BcTargetAdapter, BcTokenManager } from './bc.js';
+export { BlueCherryTargetAdapter } from './bluecherry.js';
+export { CsvTargetAdapter } from './csv.js';
+export { IfsTargetAdapter } from './ifs.js';
+export { PgTargetAdapter } from './pg.js';
+export { TargetAdapterRegistry } from './registry.js';
+export type { LoadResult, TargetAdapter } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/target/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/target/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/adapters/target/index.js

@@ -0,0 +1,22 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+import { BcTargetAdapter } from './bc.js';
+import { BlueCherryTargetAdapter } from './bluecherry.js';
+import { CsvTargetAdapter } from './csv.js';
+import { IfsTargetAdapter } from './ifs.js';
+import { PgTargetAdapter } from './pg.js';
+import { TargetAdapterRegistry } from './registry.js';
+if (!TargetAdapterRegistry.has('csv')) {
+    TargetAdapterRegistry.register(new CsvTargetAdapter());
+    TargetAdapterRegistry.register(new IfsTargetAdapter());
+    TargetAdapterRegistry.register(new BlueCherryTargetAdapter());
+    TargetAdapterRegistry.register(new PgTargetAdapter());
+    TargetAdapterRegistry.register(new BcTargetAdapter());
+}
+export { BcTargetAdapter, BcTokenManager } from './bc.js';
+export { BlueCherryTargetAdapter } from './bluecherry.js';
+export { CsvTargetAdapter } from './csv.js';
+export { IfsTargetAdapter } from './ifs.js';
+export { PgTargetAdapter } from './pg.js';
+export { TargetAdapterRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/target/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/adapters/target/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uCAAuC;AAEvC,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;IACtC,qBAAqB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IACvD,qBAAqB,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;IACvD,qBAAqB,CAAC,QAAQ,CAAC,IAAI,uBAAuB,EAAE,CAAC,CAAC;IAC9D,qBAAqB,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IACtD,qBAAqB,CAAC,QAAQ,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/adapters/target/pg.d.ts

@@ -0,0 +1,11 @@
+import type { RunConfig, TargetConfig } from '../../config/types.js';
+import { type StagingStore } from '../../staging/index.js';
+import type { LoadResult, TargetAdapter } from './types.js';
+export declare class PgTargetAdapter implements TargetAdapter {
+    readonly id = "pg";
+    private pool;
+    connect(config: TargetConfig): Promise<void>;
+    disconnect(): Promise<void>;
+    load(config: TargetConfig, store: StagingStore, runConfig: RunConfig, onProgress: (rows: number) => void): Promise<LoadResult>;
+}
+//# sourceMappingURL=pg.d.ts.map

package/dist/adapters/target/pg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.d.ts","sourceRoot":"","sources":["../../../src/adapters/target/pg.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAGvE,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAI5D,qBAAa,eAAgB,YAAW,aAAa;IACnD,QAAQ,CAAC,EAAE,QAAQ;IACnB,OAAO,CAAC,IAAI,CAAwB;IAE9B,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5C,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,IAAI,CACR,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,UAAU,CAAC;CAuEvB"}

package/dist/adapters/target/pg.js

@@ -0,0 +1,103 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+/**
+ * PostgreSQL target adapter. Inserts rows from stg_transformed into
+ * `{schema}.{table}`, honouring `onConflict`:
+ *   - fail   → plain INSERT (PG raises on unique violations)
+ *   - upsert → INSERT … ON CONFLICT (upsertKey) DO UPDATE SET …
+ *   - ignore → INSERT … ON CONFLICT DO NOTHING
+ */
+import pg from 'pg';
+import { quoteIdent } from '../../staging/index.js';
+import { ConfigError, LoadError } from '../../utils/errors.js';
+import { logger } from '../../utils/logger.js';
+const STAGING_TABLE = 'stg_transformed';
+export class PgTargetAdapter {
+    id = 'pg';
+    pool = null;
+    async connect(config) {
+        if (!config.connection) {
+            throw new ConfigError('pg target requires `connection`');
+        }
+        this.pool = new pg.Pool({ connectionString: config.connection });
+        try {
+            const client = await this.pool.connect();
+            client.release();
+        }
+        catch (err) {
+            this.pool = null;
+            throw new LoadError(`pg target: connect failed: ${err instanceof Error ? err.message : String(err)}`, err);
+        }
+    }
+    async disconnect() {
+        if (this.pool) {
+            const p = this.pool;
+            this.pool = null;
+            await p.end();
+        }
+    }
+    async load(config, store, runConfig, onProgress) {
+        if (!this.pool)
+            throw new LoadError('pg target: not connected');
+        if (!config.table)
+            throw new ConfigError('pg target requires `table`');
+        const schema = config.schema;
+        const table = config.table;
+        const qualified = `${quoteIdent(schema)}.${quoteIdent(table)}`;
+        const columns = await store.columnNames(STAGING_TABLE);
+        if (columns.length === 0) {
+            throw new LoadError('pg target: stg_transformed has no columns');
+        }
+        const rows = await store.query(`SELECT * FROM "${STAGING_TABLE}"`);
+        const colList = columns.map(quoteIdent).join(', ');
+        let conflictClause = '';
+        if (config.onConflict === 'upsert') {
+            const key = config.upsertKey;
+            if (!key || key.length === 0) {
+                throw new ConfigError('pg target: onConflict: upsert requires upsertKey');
+            }
+            const updateSet = columns
+                .filter((c) => !key.includes(c))
+                .map((c) => `${quoteIdent(c)} = EXCLUDED.${quoteIdent(c)}`)
+                .join(', ');
+            const conflictCols = key.map(quoteIdent).join(', ');
+            conflictClause = updateSet.length > 0
+                ? `ON CONFLICT (${conflictCols}) DO UPDATE SET ${updateSet}`
+                : `ON CONFLICT (${conflictCols}) DO NOTHING`;
+        }
+        else if (config.onConflict === 'ignore') {
+            conflictClause = 'ON CONFLICT DO NOTHING';
+        }
+        let rowsLoaded = 0;
+        let rowsFailed = 0;
+        for (let i = 0; i < rows.length; i += runConfig.batchSize) {
+            const batch = rows.slice(i, i + runConfig.batchSize);
+            const placeholderRows = [];
+            const values = [];
+            let ph = 1;
+            for (const row of batch) {
+                const placeholders = [];
+                for (const col of columns) {
+                    placeholders.push(`$${ph++}`);
+                    values.push(row[col] === undefined ? null : row[col]);
+                }
+                placeholderRows.push(`(${placeholders.join(', ')})`);
+            }
+            const sql = `INSERT INTO ${qualified} (${colList}) VALUES ${placeholderRows.join(', ')} ${conflictClause}`.trim();
+            try {
+                const res = await this.pool.query(sql, values);
+                rowsLoaded += res.rowCount ?? batch.length;
+                onProgress(rowsLoaded);
+            }
+            catch (err) {
+                rowsFailed += batch.length;
+                if (runConfig.onError === 'stop') {
+                    throw new LoadError(`pg target: insert failed: ${err instanceof Error ? err.message : String(err)}`, err);
+                }
+                logger.warn({ err: err instanceof Error ? err.message : String(err), batchStart: i }, 'pg target: batch failed (onError: continue)');
+            }
+        }
+        return { rowsLoaded, rowsFailed };
+    }
+}
+//# sourceMappingURL=pg.js.map

package/dist/adapters/target/pg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg.js","sourceRoot":"","sources":["../../../src/adapters/target/pg.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uCAAuC;AAEvC;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAqB,MAAM,wBAAwB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAG/C,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAExC,MAAM,OAAO,eAAe;IACjB,EAAE,GAAG,IAAI,CAAC;IACX,IAAI,GAAmB,IAAI,CAAC;IAEpC,KAAK,CAAC,OAAO,CAAC,MAAoB;QAChC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACvB,MAAM,IAAI,WAAW,CAAC,iCAAiC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACzC,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,MAAM,IAAI,SAAS,CACjB,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAChF,GAAG,CACJ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;YACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;YACjB,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CACR,MAAoB,EACpB,KAAmB,EACnB,SAAoB,EACpB,UAAkC;QAElC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAChE,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,MAAM,IAAI,WAAW,CAAC,4BAA4B,CAAC,CAAC;QAEvE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,SAAS,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAE/D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CAAC,2CAA2C,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,KAAK,CAA0B,kBAAkB,aAAa,GAAG,CAAC,CAAC;QAE5F,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,cAAc,GAAG,EAAE,CAAC;QACxB,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC;YAC7B,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,MAAM,IAAI,WAAW,CAAC,kDAAkD,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,SAAS,GAAG,OAAO;iBACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;iBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC1D,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,YAAY,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpD,cAAc,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC;gBACnC,CAAC,CAAC,gBAAgB,YAAY,mBAAmB,SAAS,EAAE;gBAC5D,CAAC,CAAC,gBAAgB,YAAY,cAAc,CAAC;QACjD,CAAC;aAAM,IAAI,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1C,cAAc,GAAG,wBAAwB,CAAC;QAC5C,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;YACrD,MAAM,eAAe,GAAa,EAAE,CAAC;YACrC,MAAM,MAAM,GAAc,EAAE,CAAC;YAC7B,IAAI,EAAE,GAAG,CAAC,CAAC;YACX,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;gBACxB,MAAM,YAAY,GAAa,EAAE,CAAC;gBAClC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;oBAC1B,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;oBAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxD,CAAC;gBACD,eAAe,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,GAAG,GAAG,eAAe,SAAS,KAAK,OAAO,YAAY,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC,IAAI,EAAE,CAAC;YAClH,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;gBAC/C,UAAU,IAAI,GAAG,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC3C,UAAU,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC3B,IAAI,SAAS,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,SAAS,CACjB,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAC/E,GAAG,CACJ,CAAC;gBACJ,CAAC;gBACD,MAAM,CAAC,IAAI,CACT,EAAE,GAAG,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,EACxE,6CAA6C,CAC9C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/adapters/target/registry.d.ts

@@ -0,0 +1,9 @@
+import type { TargetAdapter } from './types.js';
+export declare class TargetAdapterRegistry {
+    static register(adapter: TargetAdapter): void;
+    static get(id: string): TargetAdapter;
+    static has(id: string): boolean;
+    static list(): string[];
+    static unregister(id: string): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/adapters/target/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/adapters/target/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD,qBAAa,qBAAqB;IAChC,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAO7C,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa;IAUrC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B,MAAM,CAAC,IAAI,IAAI,MAAM,EAAE;IAIvB,MAAM,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;CAGpC"}

package/dist/adapters/target/registry.js

@@ -0,0 +1,29 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+import { ConfigError } from '../../utils/errors.js';
+const adapters = new Map();
+export class TargetAdapterRegistry {
+    static register(adapter) {
+        if (adapters.has(adapter.id)) {
+            throw new ConfigError(`Duplicate target adapter id "${adapter.id}"`);
+        }
+        adapters.set(adapter.id, adapter);
+    }
+    static get(id) {
+        const adapter = adapters.get(id);
+        if (!adapter) {
+            throw new ConfigError(`No target adapter registered for "${id}". Known adapters: ${[...adapters.keys()].join(', ') || '(none)'}`);
+        }
+        return adapter;
+    }
+    static has(id) {
+        return adapters.has(id);
+    }
+    static list() {
+        return [...adapters.keys()];
+    }
+    static unregister(id) {
+        adapters.delete(id);
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/adapters/target/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/adapters/target/registry.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uCAAuC;AAEvC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,MAAM,OAAO,qBAAqB;IAChC,MAAM,CAAC,QAAQ,CAAC,OAAsB;QACpC,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,WAAW,CAAC,gCAAgC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;QACvE,CAAC;QACD,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,EAAU;QACnB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,WAAW,CACnB,qCAAqC,EAAE,sBAAsB,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAC3G,CAAC;QACJ,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,EAAU;QACnB,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,IAAI;QACT,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,EAAU;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtB,CAAC;CACF"}

package/dist/adapters/target/types.d.ts

@@ -0,0 +1,15 @@
+import type { RunConfig, TargetConfig } from '../../config/types.js';
+import type { StagingStore } from '../../staging/index.js';
+export interface TargetAdapter {
+    readonly id: string;
+    connect(config: TargetConfig): Promise<void>;
+    load(config: TargetConfig, store: StagingStore, runConfig: RunConfig, onProgress: (rows: number) => void): Promise<LoadResult>;
+    disconnect(): Promise<void>;
+}
+export interface LoadResult {
+    rowsLoaded: number;
+    rowsFailed: number;
+    /** Set for file-based targets (csv, ifs, bluecherry). */
+    outputPath?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/target/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/adapters/target/types.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,CACF,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/adapters/target/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Elastic-2.0
+// Copyright (c) 2026 Caracal Lynx Ltd.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/target/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/adapters/target/types.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,uCAAuC"}

package/dist/cli.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * Sluice CLI.
+ *
+ * Commands (per CLAUDE.md):
+ *   sluice run       <pipeline.yaml>   Full pipeline run
+ *   sluice validate  <pipeline.yaml>   DQ + transform only; no load
+ *   sluice profile   <pipeline.yaml>   Extract + column profiling; no DQ
+ *   sluice check     <pipeline.yaml>   Config validation only; no execution
+ *
+ * Exit codes:
+ *   0  success
+ *   1  pipeline error
+ *   2  DQ critical violations
+ *   3  config error
+ *   4  enrich error (Phase 4)
+ */
+import { Command } from 'commander';
+import { MultiSourcePipelineRunner } from './multi-source-runner.js';
+import { PipelineRunner } from './runner.js';
+export declare function resolvePluginDirs(cwd: string, pluginDirs?: string[]): string[];
+export declare function exitCodeFor(err: unknown): number;
+export declare function createRunnerForPipeline(yaml: string): Promise<PipelineRunner | MultiSourcePipelineRunner>;
+export declare function buildProgram(): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAIA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EACL,cAAc,EAGf,MAAM,aAAa,CAAC;AAiBrB,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAKlF;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMhD;AA0DD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,cAAc,GAAG,yBAAyB,CAAC,CAKrD;AA6ND,wBAAgB,YAAY,IAAI,OAAO,CAiEtC"}