@mseep/bw-modeling-mcp 0.8.0

package/dist/tools/datasource.js

@@ -0,0 +1,536 @@
+const BASE = '/sap/bw/modeling/repo/datasourcestructure';
+const BASE_PREFIX = `${BASE}/`;
+function parseEntries(xml) {
+    const entries = [];
+    const entryRegex = /<atom:entry\b[^>]*>([\s\S]*?)<\/atom:entry>/g;
+    let em;
+    while ((em = entryRegex.exec(xml)) !== null) {
+        const body = em[1];
+        const bwObjMatch = body.match(/<bwModel:object\b([\s\S]*?)(?:\/>|>)/);
+        const bwAttrs = bwObjMatch?.[1] ?? '';
+        const objectName = bwAttrs.match(/\bobjectName="([^"]*)"/)?.[1] ?? '';
+        const objectType = bwAttrs.match(/\bobjectType="([^"]*)"/)?.[1] ?? '';
+        const objectSubtype = bwAttrs.match(/\bobjectSubtype="([^"]*)"/)?.[1] ?? null;
+        const objectStatus = bwAttrs.match(/\bobjectStatus="([^"]*)"/)?.[1] ?? null;
+        const displayObjectName = bwAttrs.match(/\bdisplayObjectName="([^"]*)"/)?.[1] ?? null;
+        const title = body.match(/<atom:title[^>]*>([^<]*)<\/atom:title>/)?.[1] ?? '';
+        let selfHref = null;
+        let childrenHref = null;
+        const linkRegex = /<atom:link\b([\s\S]*?)(?:\/>|>)/g;
+        let lm;
+        while ((lm = linkRegex.exec(body)) !== null) {
+            const attrs = lm[1];
+            const rel = attrs.match(/\brel="([^"]*)"/)?.[1] ?? '';
+            const href = attrs.match(/\bhref="([^"]*)"/)?.[1] ?? '';
+            if (rel === 'self')
+                selfHref = href || null;
+            else if (rel === 'http://www.sap.com/bw/modeling/relations:children')
+                childrenHref = href || null;
+        }
+        entries.push({ objectName, objectType, objectSubtype, objectStatus, displayObjectName, title, selfHref, childrenHref });
+    }
+    return entries;
+}
+function stripBase(href) {
+    return href.startsWith(BASE_PREFIX) ? href.slice(BASE_PREFIX.length) : href;
+}
+export async function bwListSourceSystems(client, sourceSystemType) {
+    const ssysUrls = [];
+    if (sourceSystemType) {
+        ssysUrls.push(`${BASE}/ssys/${sourceSystemType.toLowerCase()}`);
+    }
+    else {
+        const { body: rootBody } = await client.get(BASE, 'application/atom+xml');
+        for (const e of parseEntries(rootBody)) {
+            if (e.childrenHref)
+                ssysUrls.push(e.childrenHref);
+        }
+    }
+    const sourceSystems = [];
+    for (const url of ssysUrls) {
+        const { body } = await client.get(url, 'application/atom+xml');
+        for (const e of parseEntries(body)) {
+            if (e.objectType !== 'LSYS')
+                continue;
+            sourceSystems.push({
+                name: e.objectName,
+                description: e.title,
+                source_system_type: e.objectSubtype,
+                status: e.objectStatus,
+                self_url: e.selfHref,
+                children_path: e.childrenHref ? stripBase(e.childrenHref) : null,
+            });
+        }
+    }
+    return JSON.stringify({ count: sourceSystems.length, source_systems: sourceSystems }, null, 2);
+}
+export async function bwListDatasources(client, sourceSystem, format = 'text', apcoPathFilter) {
+    const filterSegments = apcoPathFilter
+        ? apcoPathFilter.split('>').map(s => s.trim().toLowerCase()).filter(s => s.length > 0)
+        : [];
+    const filterLen = filterSegments.length;
+    const segmentMatches = (title, name, idx) => {
+        const seg = filterSegments[idx];
+        return title.trim().toLowerCase() === seg || name.trim().toLowerCase() === seg;
+    };
+    const advanceMatch = (currentPtr, title, name) => {
+        if (filterLen === 0)
+            return 0;
+        if (currentPtr >= filterLen)
+            return currentPtr;
+        if (segmentMatches(title, name, currentPtr))
+            return currentPtr + 1;
+        if (currentPtr > 0 && segmentMatches(title, name, 0))
+            return 1;
+        return 0;
+    };
+    const datasources = [];
+    const rawBlocks = [];
+    const sourceSystemUpper = sourceSystem.toUpperCase();
+    async function recurse(url, apcoPath, matchPtr) {
+        const { body } = await client.get(url, 'application/atom+xml');
+        const inside = matchPtr >= filterLen;
+        if (format === 'raw') {
+            if (inside)
+                rawBlocks.push(`Source System: ${sourceSystemUpper}\n${body}`);
+            for (const e of parseEntries(body)) {
+                if (e.objectType === 'APCO' && e.childrenHref) {
+                    const nextPtr = advanceMatch(matchPtr, e.title, e.objectName);
+                    await recurse(e.childrenHref, [...apcoPath, e.title], nextPtr);
+                }
+            }
+            return;
+        }
+        for (const e of parseEntries(body)) {
+            if (e.objectType === 'RSDS') {
+                if (!inside)
+                    continue;
+                const name = e.displayObjectName
+                    ? e.displayObjectName.split(' (')[0]
+                    : e.objectName.trim().split(' ')[0];
+                datasources.push({
+                    name,
+                    description: e.title,
+                    status: e.objectStatus,
+                    self_url: e.selfHref,
+                    apco_path: [...apcoPath],
+                });
+            }
+            else if (e.objectType === 'APCO' && e.childrenHref) {
+                const nextPtr = advanceMatch(matchPtr, e.title, e.objectName);
+                await recurse(e.childrenHref, [...apcoPath, e.title], nextPtr);
+            }
+        }
+    }
+    await recurse(`${BASE}/lsys/${sourceSystem.toLowerCase()}`, [], 0);
+    if (format === 'raw')
+        return rawBlocks.join('\n\n');
+    const p = (s, n) => s.padEnd(n);
+    const header = `${p('NAME', 30)} ${p('STATUS', 9)} ${p('APCO PATH', 32)} ${p('DESCRIPTION', 36)} URL`;
+    const sep = '-'.repeat(header.length);
+    const headerLines = [
+        `Source System: ${sourceSystemUpper}`,
+        `DataSources: ${datasources.length}`,
+    ];
+    if (apcoPathFilter)
+        headerLines.push(`APCO Path Filter: ${apcoPathFilter}`);
+    const lines = [
+        ...headerLines,
+        '',
+        header,
+        sep,
+    ];
+    for (const ds of datasources) {
+        const apco = ds.apco_path.join(' > ');
+        lines.push(`${p(ds.name, 30)} ${p(ds.status ?? '', 9)} ${p(apco, 32)} ${p(ds.description, 36)} ${ds.self_url ?? ''}`);
+    }
+    return lines.join('\n');
+}
+const RSDS_ACCEPT = 'application/vnd.sap.bw.modeling.rsds-v1_0_0+xml, application/vnd.sap.bw.modeling.rsds-v1_1_0+xml';
+function summarizeDatasource(d) {
+    const lines = [];
+    lines.push(`DataSource: ${d.name ?? ''}`);
+    lines.push(`Source System: ${d.source_system ?? ''}`);
+    lines.push(`Status: ${d.status ?? ''} | Type: ${d.type ?? ''} | Delta: ${d.delta ?? ''} | Direct Access: ${d.direct_access ?? ''}`);
+    lines.push(`Description: ${d.description ?? ''}`);
+    lines.push(`Application Component: ${d.application_component ?? ''}`);
+    lines.push(`Changed: ${d.changed_at ?? ''} by ${d.changed_by ?? ''}`);
+    lines.push(`Created: ${d.created_at ?? ''} by ${d.created_by ?? ''}`);
+    lines.push(`Package: ${d.package ?? ''}`);
+    // ── Fields ────────────────────────────────────────────────────────────────
+    lines.push('');
+    lines.push(`── Fields (${d.field_count}) ──`);
+    const compactLabel = (f) => {
+        const len = f.length !== null
+            ? String(f.length)
+            : (f.precision !== undefined && f.scale !== undefined ? `P${f.precision}/S${f.scale}` : '');
+        return `${f.name}(${f.type ?? ''}/${len})`;
+    };
+    const notTransferred = d.fields.filter(f => f.transfer === false);
+    const keyFields = d.fields.filter(f => f.is_key);
+    const transferred = d.fields.filter(f => f.transfer === true)
+        .sort((a, b) => (a.position ?? 0) - (b.position ?? 0));
+    const ntLabels = notTransferred.map(compactLabel);
+    if (ntLabels.length === 0) {
+        lines.push(`Not transferred (0):`);
+    }
+    else {
+        const chunks = [];
+        for (let i = 0; i < ntLabels.length; i += 10)
+            chunks.push(ntLabels.slice(i, i + 10));
+        if (chunks.length === 1) {
+            lines.push(`Not transferred (${notTransferred.length}): ${chunks[0].join(', ')}`);
+        }
+        else {
+            lines.push(`Not transferred (${notTransferred.length}):`);
+            for (const chunk of chunks)
+                lines.push(`  ${chunk.join(', ')}`);
+        }
+    }
+    lines.push(`Key fields (${keyFields.length}): ${keyFields.map(compactLabel).join(', ')}`);
+    lines.push('');
+    lines.push(`Transferred (${transferred.length}):`);
+    const pe = (s, n) => s.padEnd(n);
+    const pr = (s, n) => s.padStart(n);
+    lines.push(`  ${'POS'.padEnd(4)}  ${'NAME'.padEnd(30)} ${'TYPE'.padEnd(7)} ${'LEN'.padStart(5)}  ${'KEY'.padEnd(4)} ${'SEL'.padEnd(4)} DESCRIPTION`);
+    for (const f of transferred) {
+        const pos = String(f.position ?? 0).padStart(4, '0');
+        const lenStr = f.length !== null
+            ? String(f.length)
+            : (f.precision !== undefined && f.scale !== undefined ? `P${f.precision}/S${f.scale}` : '');
+        const keyStr = f.is_key ? 'key' : '';
+        const selStr = String(f.selection_options ?? '');
+        let desc = f.description ?? '';
+        if (f.conversion_exit)
+            desc += ` [conv: ${f.conversion_exit}]`;
+        if (f.unit_currency_ref)
+            desc += ` [unit: ${f.unit_currency_ref}]`;
+        lines.push(`  ${pos}  ${pe(f.name, 30)} ${pe(f.type ?? '', 7)} ${pr(lenStr, 5)}  ${pe(keyStr, 4)} ${pe(selStr, 4)} ${desc}`);
+    }
+    // ── Adapter ────────────────────────────────────────────────────────────────
+    lines.push('');
+    lines.push('── Adapter ──');
+    for (const [key, value] of Object.entries(d.adapter)) {
+        lines.push(`${key}: ${value ?? ''}`);
+    }
+    return lines.join('\n');
+}
+function parseDescLabel(xml) {
+    const re = /<description\b([^>]*)\/>/g;
+    let m;
+    while ((m = re.exec(xml)) !== null) {
+        const attrs = m[1];
+        if (attrs.includes('textType="3"'))
+            return attrs.match(/\blabel="([^"]*)"/)?.[1] ?? null;
+    }
+    return null;
+}
+export async function bwGetDatasource(client, datasourceName, sourceSystem, format = 'text') {
+    const url = `/sap/bw/modeling/rsds/${datasourceName}/${sourceSystem.toUpperCase()}/m`;
+    const { body, headers } = await client.get(url, RSDS_ACCEPT);
+    if (format === 'raw')
+        return body;
+    // Root element attributes
+    const rootMatch = body.match(/<rsds:dataSource\b([\s\S]*?)>/);
+    const rootAttrs = rootMatch?.[1] ?? '';
+    const name = rootAttrs.match(/(?:^|\s)name="([^"]*)"/)?.[1] ?? null;
+    const sourceSystemAttr = rootAttrs.match(/\bsourceSystemName="([^"]*)"/)?.[1] ?? null;
+    const type = rootAttrs.match(/(?<![a-zA-Z:])type="([^"]*)"/)?.[1] ?? null;
+    const applicationComponent = rootAttrs.match(/\bapplicationComponent="([^"]*)"/)?.[1] ?? null;
+    const directAccess = rootAttrs.match(/\bdirectAccess="([^"]*)"/)?.[1] ?? null;
+    // delta from <deltaProperties>
+    const delta = body.match(/<deltaProperties\b[\s\S]*?\bdelta="([^"]*)"/)?.[1] ?? null;
+    // DataSource-level description (header section, before first <segment>)
+    const segStart = body.indexOf('<segment');
+    const headerSection = segStart >= 0 ? body.slice(0, segStart) : body;
+    const description = parseDescLabel(headerSection);
+    // Status from response header (axios lowercases all header names)
+    const status = headers['object_status'] ?? null;
+    // tlogoProperties
+    const tlogoMatch = body.match(/<tlogoProperties\b([\s\S]*?)>/);
+    const tlogoAttrs = tlogoMatch?.[1] ?? '';
+    const changedAt = tlogoAttrs.match(/\badtcore:changedAt="([^"]*)"/)?.[1] ?? null;
+    const changedBy = tlogoAttrs.match(/\badtcore:changedBy="([^"]*)"/)?.[1] ?? null;
+    const createdAt = tlogoAttrs.match(/\badtcore:createdAt="([^"]*)"/)?.[1] ?? null;
+    const createdBy = tlogoAttrs.match(/\badtcore:createdBy="([^"]*)"/)?.[1] ?? null;
+    // Package from <adtcore:packageRef adtcore:name="...">
+    const pkg = body.match(/<adtcore:packageRef\b[\s\S]*?\badtcore:name="([^"]*)"/)?.[1] ?? null;
+    // Segment ID="0001" — key fields and field list
+    const segMatch = body.match(/<segment\b[^>]*ID="0001"[^>]*>([\s\S]*?)<\/segment>/);
+    const segBody = segMatch?.[1] ?? '';
+    const keyFields = new Set();
+    const kfRe = /<keyField>([^<]*)<\/keyField>/g;
+    let kfm;
+    while ((kfm = kfRe.exec(segBody)) !== null) {
+        const kv = kfm[1].trim().match(/^#\/\/\/0001\/(.+)$/);
+        if (kv)
+            keyFields.add(kv[1]);
+    }
+    const fields = [];
+    const fieldRe = /<field\b([\s\S]*?)>([\s\S]*?)<\/field>/g;
+    let fm;
+    while ((fm = fieldRe.exec(segBody)) !== null) {
+        const fTag = fm[1];
+        const fBody = fm[2];
+        const fieldName = fTag.match(/\bname="([^"]*)"/)?.[1] ?? '';
+        const itMatch = fBody.match(/<inlineType\b([\s\S]*?)(?:\/>|>)/);
+        const itAttrs = itMatch?.[1] ?? '';
+        const fType = itAttrs.match(/\bname="([^"]*)"/)?.[1] ?? null;
+        const lengthRaw = itAttrs.match(/\blength="([^"]*)"/)?.[1];
+        const length = lengthRaw !== undefined ? parseInt(lengthRaw, 10) : null;
+        const precisionRaw = itAttrs.match(/\bprecision="([^"]*)"/)?.[1];
+        const scaleRaw = itAttrs.match(/\bscale="([^"]*)"/)?.[1];
+        const fpMatch = fBody.match(/<fieldProperties\b([\s\S]*?)(?:\/>|>)/);
+        const fpAttrs = fpMatch?.[1] ?? '';
+        const transferRaw = fpAttrs.match(/\btransfer="([^"]*)"/)?.[1];
+        const selOptRaw = fpAttrs.match(/\bselectionOptions="([^"]*)"/)?.[1];
+        const posRaw = fpAttrs.match(/\bposition="([^"]*)"/)?.[1];
+        const convExit = fpAttrs.match(/\bconversionExitSource="([^"]*)"/)?.[1] || undefined;
+        const ucRaw = fBody.match(/<unitCurrencyElement>([^<]*)<\/unitCurrencyElement>/)?.[1];
+        const field = {
+            name: fieldName,
+            description: parseDescLabel(fBody),
+            type: fType,
+            length,
+            transfer: transferRaw === 'true' ? true : transferRaw === 'false' ? false : null,
+            selection_options: selOptRaw !== undefined ? parseInt(selOptRaw, 10) : null,
+            position: posRaw !== undefined ? parseInt(posRaw, 10) : null,
+            is_key: keyFields.has(fieldName),
+        };
+        if (precisionRaw !== undefined)
+            field['precision'] = parseInt(precisionRaw, 10);
+        if (scaleRaw !== undefined)
+            field['scale'] = parseInt(scaleRaw, 10);
+        if (convExit)
+            field['conversion_exit'] = convExit;
+        if (ucRaw)
+            field['unit_currency_ref'] = ucRaw.replace(/^#\/\/\/0001\//, '');
+        fields.push(field);
+    }
+    // Active adapter(s)
+    const adapter = {};
+    const adapterTagRe = /<adapter\b([\s\S]*?)(?:\/>|>)/g;
+    let adm;
+    while ((adm = adapterTagRe.exec(body)) !== null) {
+        const aAttrs = adm[1];
+        if (!aAttrs.includes('currentlyUsed="true"'))
+            continue;
+        const rawAType = aAttrs.match(/\bxsi:type="([^"]*)"/)?.[1] ?? '';
+        const aType = rawAType.replace(/^rsds:/, '');
+        const extObj = aAttrs.match(/\bexternalObject="([^"]*)"/)?.[1] || null;
+        if (aType === 'ConverterCSVFL') {
+            const dataSep = aAttrs.match(/\bdataSeparator="([^"]*)"/)?.[1] ?? null;
+            const escChar = aAttrs.match(/\bescapeCharacter="([^"]*)"/)?.[1] ?? null;
+            if (dataSep !== null)
+                adapter['data_separator'] = dataSep;
+            if (escChar !== null)
+                adapter['escape_character'] = escChar;
+        }
+        else {
+            adapter['adapter_name'] = aAttrs.match(/(?:^|\s)name="([^"]*)"/)?.[1] ?? null;
+            adapter['adapter_type'] = aType;
+            if (extObj)
+                adapter['external_object'] = extObj;
+            if (aType === 'ExtractorODP') {
+                adapter['context_description'] = aAttrs.match(/\bcontextDescription="([^"]*)"/)?.[1] ?? null;
+                adapter['semantics'] = aAttrs.match(/\bsemantics="([^"]*)"/)?.[1] ?? null;
+            }
+            else if (aType === 'ExtractorHANA') {
+                adapter['hana_type'] = aAttrs.match(/\bhanaType="([^"]*)"/)?.[1] ?? null;
+                adapter['schema'] = aAttrs.match(/\bschema="([^"]*)"/)?.[1] ?? null;
+                adapter['remote_source'] = aAttrs.match(/\bremoteSource="([^"]*)"/)?.[1] ?? null;
+            }
+            else if (aType.startsWith('ExtractorFile')) {
+                const ignoreLines = aAttrs.match(/\bignoreLines="([^"]*)"/)?.[1] || null;
+                if (ignoreLines !== null)
+                    adapter['ignore_lines'] = ignoreLines;
+            }
+        }
+    }
+    const data = {
+        name,
+        source_system: sourceSystemAttr,
+        type,
+        application_component: applicationComponent,
+        direct_access: directAccess,
+        delta,
+        description,
+        status,
+        changed_at: changedAt,
+        changed_by: changedBy,
+        created_at: createdAt,
+        created_by: createdBy,
+        package: pkg,
+        field_count: fields.length,
+        fields,
+        adapter,
+    };
+    return summarizeDatasource(data);
+}
+const LSYS_ACCEPT = 'application/vnd.sap.bw.modeling.lsys-v1_0_0+xml, application/vnd.sap.bw.modeling.lsys-v1_1_0+xml';
+function deriveSourceSystemType(xsiType, context, hanaType) {
+    if (xsiType === 'SourceSystemFILE')
+        return 'FILE';
+    if (xsiType === 'SourceSystemHANA') {
+        return hanaType === '1' ? 'HANA_LOCAL' : 'HANA_SDA';
+    }
+    if (xsiType === 'SourceSystemODP') {
+        if (context === 'SAPI')
+            return 'ODP_SAP';
+        if (context === 'ABAP_CDS')
+            return 'ODP_CDS';
+        if (context === 'BW')
+            return 'ODP_BW';
+        return 'ODP';
+    }
+    return xsiType;
+}
+export async function bwGetSourceSystem(client, sourceSystem) {
+    const url = `/sap/bw/modeling/lsys/${sourceSystem.toLowerCase()}/a`;
+    const { body, headers } = await client.get(url, LSYS_ACCEPT);
+    // Root element opening tag attributes (up to first closing >)
+    const rootMatch = body.match(/<lsys:sourceSystem\b([\s\S]*?)>/);
+    const rootAttrs = rootMatch?.[1] ?? '';
+    const name = rootAttrs.match(/(?:^|\s)name="([^"]*)"/)?.[1] ?? null;
+    const rawXsiType = rootAttrs.match(/\bxsi:type="([^"]*)"/)?.[1] ?? '';
+    const xsiType = rawXsiType.replace(/^lsys:/, '');
+    // Use negative lookbehind to avoid matching xsi:type or adtcore:type
+    const type = rootAttrs.match(/(?<![a-zA-Z:])type="([^"]*)"/)?.[1] ?? null;
+    // ODP-specific root attributes
+    const context = rootAttrs.match(/\bcontext="([^"]*)"/)?.[1] ?? null;
+    const destination = rootAttrs.match(/\bdestination="([^"]*)"/)?.[1] ?? null;
+    const destinationValid = rootAttrs.match(/\bdestinationValid="([^"]*)"/)?.[1] ?? null;
+    const treeRemote = rootAttrs.match(/\btreeRemote="([^"]*)"/)?.[1] ?? null;
+    const treeReplicatable = rootAttrs.match(/\btreeReplicatable="([^"]*)"/)?.[1] ?? null;
+    // HANA-specific root attributes
+    const hanaType = rootAttrs.match(/\bhanaType="([^"]*)"/)?.[1] ?? null;
+    const remoteSource = rootAttrs.match(/\bremoteSource="([^"]*)"/)?.[1] ?? null;
+    const database = rootAttrs.match(/\bdatabase="([^"]*)"/)?.[1] ?? null;
+    const schema = rootAttrs.match(/\bschema="([^"]*)"/)?.[1] ?? null;
+    const sdiAdapter = rootAttrs.match(/\bsdiAdapter="([^"]*)"/)?.[1] ?? null;
+    // <description textType="3" label="..."/>
+    let description = null;
+    const descRegex = /<description\b([^>]*?)(?:\/>|>)/g;
+    let dm;
+    while ((dm = descRegex.exec(body)) !== null) {
+        const dAttrs = dm[1];
+        if (dAttrs.includes('textType="3"')) {
+            description = dAttrs.match(/\blabel="([^"]*)"/)?.[1] ?? null;
+            break;
+        }
+    }
+    // tlogoProperties attributes
+    const tlogoMatch = body.match(/<tlogoProperties\b([\s\S]*?)>/);
+    const tlogoAttrs = tlogoMatch?.[1] ?? '';
+    const changedAt = tlogoAttrs.match(/\badtcore:changedAt="([^"]*)"/)?.[1] ?? null;
+    const changedBy = tlogoAttrs.match(/\badtcore:changedBy="([^"]*)"/)?.[1] ?? null;
+    // <objectStatus> text content
+    const objectStatus = body.match(/<objectStatus>([^<]*)<\/objectStatus>/)?.[1] ?? null;
+    // Response header (axios lowercases header names)
+    const status = headers['object_status'] ?? null;
+    const sourceSystemType = deriveSourceSystemType(xsiType, context, hanaType);
+    const result = {
+        name,
+        xsi_type: xsiType,
+        type,
+        status,
+        description,
+        changed_at: changedAt,
+        changed_by: changedBy,
+        object_status: objectStatus,
+        source_system_type: sourceSystemType,
+    };
+    if (xsiType === 'SourceSystemODP') {
+        result['context'] = context;
+        result['destination'] = destination;
+        result['destination_valid'] = destinationValid === 'true' ? true : destinationValid === 'false' ? false : null;
+        result['tree_remote'] = treeRemote === 'true' ? true : treeRemote === 'false' ? false : null;
+        result['tree_replicatable'] = treeReplicatable === 'true' ? true : treeReplicatable === 'false' ? false : null;
+    }
+    else if (xsiType === 'SourceSystemHANA') {
+        result['hana_type'] = hanaType;
+        result['remote_source'] = remoteSource;
+        result['database'] = database;
+        result['schema'] = schema;
+        result['sdi_adapter'] = sdiAdapter;
+    }
+    return JSON.stringify(result, null, 2);
+}
+export async function bwPreviewDatasource(client, datasourceName, sourceSystem, records = 20) {
+    const structureUrl = `/sap/bw/modeling/rsds/${datasourceName.toLowerCase()}/${sourceSystem.toUpperCase()}/m`;
+    const { body: structureBody } = await client.get(structureUrl, RSDS_ACCEPT);
+    const segMatch = structureBody.match(/<segment\b[^>]*ID="0001"[^>]*>([\s\S]*?)<\/segment>/);
+    const segBody = segMatch?.[1] ?? '';
+    const fieldEntries = [];
+    const fieldRe = /<field\b([\s\S]*?)>([\s\S]*?)<\/field>/g;
+    let fm;
+    while ((fm = fieldRe.exec(segBody)) !== null) {
+        const fTag = fm[1];
+        const fBody = fm[2];
+        const fieldName = fTag.match(/\bname="([^"]*)"/)?.[1] ?? '';
+        const fpMatch = fBody.match(/<fieldProperties\b([\s\S]*?)(?:\/>|>)/);
+        const fpAttrs = fpMatch?.[1] ?? '';
+        const transferRaw = fpAttrs.match(/\btransfer="([^"]*)"/)?.[1];
+        if (transferRaw === 'false')
+            continue;
+        const posRaw = fpAttrs.match(/\bposition="([^"]*)"/)?.[1];
+        const position = posRaw !== undefined ? parseInt(posRaw, 10) : 0;
+        fieldEntries.push({ name: fieldName, position });
+    }
+    fieldEntries.sort((a, b) => a.position - b.position);
+    const fieldNames = fieldEntries.map(f => f.name);
+    const url = `/sap/bw/modeling/rsdsint/dataprev/${datasourceName.toUpperCase()}/${sourceSystem.toUpperCase()}?records=${records}&external=true`;
+    const csrfToken = await client.getCsrfToken();
+    const { body: previewBody } = await client.rawPost(url, '', {
+        'x-csrf-token': csrfToken,
+        'X-sap-adt-profiling': 'server-time',
+    });
+    const contentMatch = previewBody.match(/<simpleParams\b[^>]*\bcontent="([^"]*)"/);
+    const content = contentMatch?.[1] ?? '';
+    const decoded = Buffer.from(content, 'base64').toString('utf-8');
+    const parsed = JSON.parse(decoded);
+    const rows = parsed['T_DATA_0001'] ?? [];
+    const summaryHeader = [
+        `DataSource: ${datasourceName.toUpperCase()} / Source System: ${sourceSystem.toUpperCase()}`,
+        `Records: ${rows.length} (requested: ${records})`,
+    ].join('\n');
+    if (rows.length === 0) {
+        return `${summaryHeader}\n(no data returned)`;
+    }
+    const columnCount = rows[0].length;
+    let headers;
+    let mismatchWarning = null;
+    if (fieldNames.length !== columnCount) {
+        headers = Array.from({ length: columnCount }, (_, i) => `COL_${i + 1}`);
+        mismatchWarning = `Warning: field count mismatch (fields: ${fieldNames.length}, columns: ${columnCount}) — column names may be incorrect.`;
+    }
+    else {
+        headers = fieldNames;
+    }
+    const MAX_WIDTH = 30;
+    const truncate = (s) => (s.length > MAX_WIDTH ? s.slice(0, 27) + '...' : s);
+    const truncatedRows = rows.map(row => row.map(truncate));
+    const truncatedHeaders = headers.map(truncate);
+    const widths = truncatedHeaders.map((h, i) => {
+        let w = h.length;
+        for (const row of truncatedRows) {
+            const cell = row[i] ?? '';
+            if (cell.length > w)
+                w = cell.length;
+        }
+        return Math.min(w, MAX_WIDTH);
+    });
+    const formatRow = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join(' ');
+    const headerLine = formatRow(truncatedHeaders);
+    const sepLine = widths.map(w => '-'.repeat(w)).join(' ');
+    const lines = [summaryHeader, '', headerLine, sepLine];
+    for (const row of truncatedRows) {
+        const cells = headers.map((_, i) => row[i] ?? '');
+        lines.push(formatRow(cells));
+    }
+    if (mismatchWarning) {
+        lines.push('');
+        lines.push(mismatchWarning);
+    }
+    return lines.join('\n');
+}

package/dist/tools/delete.js

@@ -0,0 +1,22 @@
+import { MEDIA_TYPES } from '../bw-client.js';
+function parseAtomTitles(xml) {
+    return [...xml.matchAll(/<atom:title[^>]*>([^<]+)<\/atom:title>/g)].map(m => m[1]);
+}
+export async function bwDelete(client, objectType, objectName) {
+    const typeLower = objectType.toLowerCase();
+    const mediaType = MEDIA_TYPES[typeLower] ?? 'application/xml';
+    // 1. Lock — uses /m before ?action=lock (delete-specific lock URL)
+    const lockHandle = await client.lockForDelete(typeLower, objectName, mediaType);
+    // 2. DELETE
+    const deleteResult = await client.delete(typeLower, objectName, lockHandle, mediaType);
+    // 3. Unlock — no /m (same as normal unlock)
+    await client.unlock(typeLower, objectName);
+    // 4. Parse atom feed response
+    const messages = parseAtomTitles(deleteResult);
+    return JSON.stringify({
+        success: true,
+        object_type: objectType.toUpperCase(),
+        object_name: objectName.toUpperCase(),
+        messages,
+    });
+}