arc-1 1.1.2 → 1.3.0

package/dist/adt/relation-objects.js

@@ -0,0 +1,262 @@
+/** Live-verified identity adapters, not a registry of everything SAP can display. */
+export const RELATION_OBJECTS = [
+    {
+        type: 'CLAS',
+        native: 'CLAS/OC',
+        path: 'oo/classes',
+        metadataRoot: 'abapClass',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'INTF',
+        native: 'INTF/OI',
+        path: 'oo/interfaces',
+        metadataRoot: 'abapInterface',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'DDLS',
+        native: 'DDLS/DF',
+        path: 'ddic/ddl/sources',
+        metadataRoot: 'ddlSource',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'DCLS',
+        native: 'DCLS/DL',
+        path: 'acm/dcl/sources',
+        metadataRoot: 'dclSource',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'BDEF',
+        native: 'BDEF/BDO',
+        path: 'bo/behaviordefinitions',
+        metadataRoot: 'blueSource',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'SRVD',
+        native: 'SRVD/SRV',
+        path: 'ddic/srvd/sources',
+        metadataRoot: 'srvdSource',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'TABL',
+        native: 'TABL/DT',
+        path: 'ddic/tables',
+        metadataRoot: 'blueSource',
+        resolve: 'quickSearch',
+        nameCase: 'lower',
+    },
+    {
+        type: 'TABL',
+        native: 'TABL/DS',
+        path: 'ddic/structures',
+        metadataRoot: 'blueSource',
+        resolve: 'quickSearch',
+        nameCase: 'lower',
+    },
+    {
+        type: 'TTYP',
+        native: 'TTYP/DA',
+        path: 'ddic/tabletypes',
+        metadataRoot: 'tableType',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'DTEL',
+        native: 'DTEL/DE',
+        path: 'ddic/dataelements',
+        metadataRoot: 'wbobj',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    { type: 'DOMA', native: 'DOMA/DD', path: 'ddic/domains', metadataRoot: 'domain', resolve: 'path', nameCase: 'lower' },
+    {
+        type: 'PROG',
+        native: 'PROG/P',
+        path: 'programs/programs',
+        metadataRoot: 'abapProgram',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'INCL',
+        native: 'PROG/I',
+        path: 'programs/includes',
+        metadataRoot: 'abapInclude',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'FUGR',
+        native: 'FUGR/F',
+        path: 'functions/groups',
+        metadataRoot: 'abapFunctionGroup',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'FUNC',
+        native: 'FUGR/FF',
+        path: 'functions/groups',
+        metadataRoot: 'abapFunctionModule',
+        resolve: 'quickSearch',
+        nameCase: 'lower',
+    },
+    {
+        type: 'VIEW',
+        native: 'VIEW/DV',
+        path: 'vit/wb/object_type/viewdv/object_name',
+        metadataRoot: 'mainObject',
+        resolve: 'quickSearch',
+        nameCase: 'upper',
+    },
+    {
+        type: 'ENHO',
+        native: 'ENHO/XHB',
+        path: 'enhancements/enhoxhb',
+        metadataRoot: 'objectData',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'MSAG',
+        native: 'MSAG/N',
+        path: 'messageclass',
+        metadataRoot: 'messageClass',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'TRAN',
+        native: 'TRAN/T',
+        path: 'vit/wb/object_type/trant/object_name',
+        metadataRoot: 'mainObject',
+        resolve: 'quickSearch',
+        nameCase: 'upper',
+    },
+    {
+        type: 'SHLP',
+        native: 'SHLP/DH',
+        path: 'vit/wb/object_type/shlpdh/object_name',
+        metadataRoot: 'mainObject',
+        resolve: 'quickSearch',
+        nameCase: 'upper',
+    },
+    {
+        type: 'SKTD',
+        native: 'SKTD/TYP',
+        path: 'documentation/ktd/documents',
+        metadataRoot: 'docu',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'ENHS',
+        native: 'ENHS/XSB',
+        path: 'enhancements/enhsxsb',
+        metadataRoot: 'objectData',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'ENQU',
+        native: 'ENQU/DL',
+        path: 'ddic/lockobjects/sources',
+        metadataRoot: 'lockobject',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'TYPE',
+        native: 'TYPE/DG',
+        path: 'ddic/typegroups',
+        metadataRoot: 'abapTypeGroup',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'EVTB',
+        native: 'EVTB/EVB',
+        path: 'businessservices/evtbevb',
+        metadataRoot: 'blueSource',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+    {
+        type: 'DSFD',
+        native: 'DSFD/SCF',
+        path: 'ddic/dsfd/sources',
+        metadataRoot: 'blueSource',
+        resolve: 'path',
+        nameCase: 'lower',
+    },
+];
+export const RELATION_ROOT_TYPES = [...new Set(RELATION_OBJECTS.map(({ type }) => type))];
+export const RELATION_NAME = /^(?:\/[A-Z0-9_]+\/)?[A-Z0-9_$]+$/i;
+export class RelationProtocolError extends Error {
+    constructor(message) {
+        super(`Experimental live relations: ${message}`);
+        this.name = 'RelationProtocolError';
+    }
+}
+export function relationObjectSpec(type) {
+    return RELATION_OBJECTS.find((spec) => spec.native === type || spec.type === type);
+}
+function validName(name) {
+    if (name.length > 120 || !RELATION_NAME.test(name))
+        throw new RelationProtocolError('invalid object name.');
+    return name;
+}
+/** Reconstruct a fixed read-only object path; never follow arbitrary SAP-returned hrefs. */
+export function relationObjectUri(type, name, group) {
+    const spec = relationObjectSpec(type);
+    if (!spec)
+        throw new RelationProtocolError('unsupported relation object type.');
+    const encoded = encodeURIComponent(validName(name)[spec.nameCase === 'upper' ? 'toUpperCase' : 'toLowerCase']());
+    const base = `/sap/bc/adt/${spec.path}`;
+    if (spec.type === 'FUNC') {
+        if (!group)
+            throw new RelationProtocolError('function module requires a resolved function group.');
+        return `${base}/${encodeURIComponent(validName(group).toLowerCase())}/fmodules/${encoded}`;
+    }
+    return `${base}/${encoded}`;
+}
+/** Group/name can be decoded only after the caller canonicalizes the host-relative ADT URI. */
+export function relationFunctionIdentity(uri) {
+    const match = /^\/sap\/bc\/adt\/functions\/groups\/([^/]+)\/fmodules\/([^/]+)$/.exec(uri);
+    if (!match)
+        throw new RelationProtocolError('invalid function module URI.');
+    const group = validName(decodeURIComponent(match[1])).toUpperCase();
+    const name = validName(decodeURIComponent(match[2])).toUpperCase();
+    if (relationObjectUri('FUNC', name, group) !== uri)
+        throw new RelationProtocolError('function URI mismatch.');
+    return { group, name };
+}
+/** SAP 7.58 may prefix the module with its group or function pool, padded to 40 chars.
+ * Example: group /ACME/GROUP → pool /ACME/SAPLGROUP; either prefix + spaces + ZFUNCTION.
+ * Validate the entire prefix, not just the module suffix: a different parent is not this object.
+ */
+export function relationReferenceName(name, type, uri) {
+    if (type !== 'FUGR/FF')
+        return name;
+    const identity = relationFunctionIdentity(uri);
+    const pool = identity.group.startsWith('/')
+        ? identity.group.replace(/^(\/[^/]+\/)/, '$1SAPL')
+        : `SAPL${identity.group}`;
+    if (![identity.name, `${pool.padEnd(40)}${identity.name}`, `${identity.group.padEnd(40)}${identity.name}`].includes(name.toUpperCase())) {
+        throw new RelationProtocolError('function reference name/URI mismatch.');
+    }
+    return identity.name;
+}
+//# sourceMappingURL=relation-objects.js.map

package/dist/adt/relation-objects.js.map

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

package/dist/adt/repository-relations.d.ts

@@ -0,0 +1,41 @@
+import type { AdtClient } from './client.js';
+import type { AdtRequestOptions } from './http-deadline.js';
+export declare const RELATIONS_PATH = "/sap/bc/adt/objectrelations/network";
+export declare const RELATION_XML_MAX_BYTES: number;
+export declare const RELATIONS_MIME = "application/vnd.sap.adt.objectrelations.request.v1+xml";
+export { RELATION_NAME, RelationProtocolError, relationObjectUri } from './relation-objects.js';
+export type RelationDirection = 'incoming' | 'outgoing';
+export interface RelationObject {
+    uri: string;
+    name: string;
+    type: string;
+    package: string;
+    version: 'active';
+    existence: 'metadata_validated' | 'observed_reference';
+}
+export interface RelationEdge {
+    from: string;
+    to: string;
+    kind: 'uses';
+    context: 'ENV' | 'WUL';
+    evidence: 'sap_relation_explorer';
+    direct: null;
+}
+export interface RelationNetwork {
+    objects: RelationObject[];
+    edges: RelationEdge[];
+}
+export declare function supportsRelations(map?: ReadonlyMap<string, string[]>): boolean;
+/** Bound parser work as well as wire bytes. Reject entities and unexpectedly deep XML. */
+export declare function parseRelationXml(xml: string): Record<string, unknown>;
+export declare function normalizeRelationNetwork(xml: string, context: 'ENV' | 'WUL', requested: RelationObject): RelationNetwork;
+export declare class NativeRelationProvider {
+    private readonly client;
+    readonly options: AdtRequestOptions;
+    constructor(client: AdtClient, options: AdtRequestOptions);
+    discover(known?: ReadonlyMap<string, string[]>): Promise<ReadonlyMap<string, string[]>>;
+    private resolveRootUri;
+    validateRoot(type: string, name: string): Promise<RelationObject>;
+    lookup(object: RelationObject, direction: RelationDirection): Promise<RelationNetwork>;
+}
+//# sourceMappingURL=repository-relations.d.ts.map

package/dist/adt/repository-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-relations.d.ts","sourceRoot":"","sources":["../../src/adt/repository-relations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAa5D,eAAO,MAAM,cAAc,wCAAwC,CAAC;AACpE,eAAO,MAAM,sBAAsB,QAAc,CAAC;AAClD,eAAO,MAAM,cAAc,2DAA2D,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAChG,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,CAAC;AACxD,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,QAAQ,CAAC;IAClB,SAAS,EAAE,oBAAoB,GAAG,oBAAoB,CAAC;CACxD;AACD,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,IAAI,CAAC;CACd;AACD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAE9E;AAqCD,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBrE;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,KAAK,GAAG,KAAK,EACtB,SAAS,EAAE,cAAc,GACxB,eAAe,CA6DjB;AAED,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,QAAQ,CAAC,OAAO,EAAE,iBAAiB;IAFrC,YACmB,MAAM,EAAE,SAAS,EACzB,OAAO,EAAE,iBAAiB,EACjC;IAEE,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAgB5F;YAEa,cAAc;IAwCtB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA2CtE;IAEK,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAc3F;CACF"}

package/dist/adt/repository-relations.js

@@ -0,0 +1,246 @@
+/** Experimental Relation Explorer adapter. No source reads, SQL fallback or shared results. */
+import { XMLValidator } from 'fast-xml-parser';
+import { AdtResponseLimitError } from './errors.js';
+import { canonicalHostRelativeAdtPath } from './path-safety.js';
+import { RELATION_NAME, RelationProtocolError, relationFunctionIdentity, relationObjectSpec, relationObjectUri, relationReferenceName, } from './relation-objects.js';
+import { checkOperation, OperationType } from './safety.js';
+import { escapeXmlAttr, parseDiscoveryObject, parseXml } from './xml-parser.js';
+export const RELATIONS_PATH = '/sap/bc/adt/objectrelations/network';
+export const RELATION_XML_MAX_BYTES = 1024 * 1024;
+export const RELATIONS_MIME = 'application/vnd.sap.adt.objectrelations.request.v1+xml';
+export { RELATION_NAME, RelationProtocolError, relationObjectUri } from './relation-objects.js';
+export function supportsRelations(map) {
+    return map?.get(RELATIONS_PATH)?.includes(RELATIONS_MIME) === true;
+}
+/** SAP-returned URIs remain untrusted. They are evidence, never an unrestricted HTTP target. */
+function safeUri(value) {
+    const uri = text(value, 512);
+    // STOB entities are location identities, not DDLS aliases or fetchable roots. Keep the
+    // exact fragment so two entities in a source never collapse. Only this observed shape
+    // is allowed; lookup still reconstructs fixed paths for qualified object types.
+    const anchor = /^(\/sap\/bc\/adt\/ddic\/ddl\/sources\/[^/?#]+\/source\/main)#name=([A-Za-z0-9_$%/]+)$/.exec(uri);
+    if (anchor && !RELATION_NAME.test(decodeURIComponent(anchor[2])))
+        throw new RelationProtocolError('invalid entity anchor.');
+    const canonical = canonicalHostRelativeAdtPath(anchor ? anchor[1] : uri, '/sap/bc/adt/', {
+        allowRawEncodedSlash: true,
+    });
+    if (!canonical || canonical.includes('?') || canonical.includes('//') || /\s/.test(decodeURIComponent(canonical))) {
+        throw new RelationProtocolError('unsafe response URI.');
+    }
+    return `${canonical}${anchor ? `#name=${anchor[2]}` : ''}`.replace(/%[a-f0-9]{2}/gi, (part) => part.toUpperCase());
+}
+function containsControl(value) {
+    return Array.from(value).some((char) => char.charCodeAt(0) < 32 || char.charCodeAt(0) === 127);
+}
+function text(value, max, empty = false) {
+    if (typeof value !== 'string' || value.length > max || (!empty && !value.length) || containsControl(value)) {
+        throw new RelationProtocolError('invalid or oversized metadata field.');
+    }
+    return value;
+}
+function record(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new RelationProtocolError('invalid XML shape.');
+    return value;
+}
+function array(value) {
+    return value === undefined ? [] : Array.isArray(value) ? value : [value];
+}
+/** Bound parser work as well as wire bytes. Reject entities and unexpectedly deep XML. */
+export function parseRelationXml(xml) {
+    const bytes = Buffer.byteLength(xml);
+    if (bytes > RELATION_XML_MAX_BYTES) {
+        throw new AdtResponseLimitError(RELATION_XML_MAX_BYTES, bytes, 'repository-relations');
+    }
+    if (/<!DOCTYPE|<!ENTITY|<!--|<!\[CDATA\[|<\?/i.test(xml.replace(/^\s*<\?xml\s+[^<>]*\?>/i, ''))) {
+        throw new RelationProtocolError('XML DTDs, entities, comments, CDATA and custom processing instructions are unsupported.');
+    }
+    let depth = 0, tags = 0;
+    for (const match of xml.matchAll(/<([^<>]+)>/g)) {
+        const tag = match[1];
+        if (++tags > 20000)
+            throw new RelationProtocolError('too many XML records.');
+        if (tag.startsWith('?') || tag.startsWith('!'))
+            continue;
+        if (tag.startsWith('/'))
+            depth--;
+        else if (!tag.endsWith('/'))
+            depth++;
+        if (depth > 40)
+            throw new RelationProtocolError('XML nesting limit exceeded.');
+    }
+    if (XMLValidator.validate(xml) !== true)
+        throw new RelationProtocolError('malformed XML.');
+    return parseXml(xml);
+}
+export function normalizeRelationNetwork(xml, context, requested) {
+    const root = record(parseRelationXml(xml).networkResponse);
+    if (root.activeContext !== context)
+        throw new RelationProtocolError('SAP did not honor the requested context.');
+    const objects = new Map();
+    const refs = array(root.objectReference), relations = array(root.relation);
+    if (refs.length > 2000 || relations.length > 4000)
+        throw new RelationProtocolError('native record limit exceeded.');
+    for (const value of refs) {
+        const raw = record(value), uri = safeUri(raw['@_uri']);
+        const type = text(raw['@_type'], 64);
+        if (raw['@_version'] !== 'active' || raw['@_exists'] !== 'true') {
+            throw new RelationProtocolError('non-active or unresolved native reference.');
+        }
+        const object = {
+            uri,
+            name: relationReferenceName(text(raw['@_name'], type === 'FUGR/FF' ? 160 : 120), type, uri),
+            type,
+            package: text(raw['@_packageName'] ?? '', 120, true),
+            version: 'active',
+            existence: 'observed_reference',
+        };
+        const prior = objects.get(uri);
+        if (prior && (prior.name !== object.name || prior.type !== object.type || prior.package !== object.package)) {
+            throw new RelationProtocolError('conflicting native object identity.');
+        }
+        objects.set(uri, object);
+    }
+    const rootObject = objects.get(requested.uri);
+    if (!rootObject ||
+        rootObject.name.toUpperCase() !== requested.name.toUpperCase() ||
+        rootObject.type !== requested.type) {
+        throw new RelationProtocolError('native result does not match the requested root.');
+    }
+    const edges = new Map();
+    for (const value of relations) {
+        const raw = record(value);
+        const a = safeUri(raw.object1), b = safeUri(raw.object2);
+        if (raw['@_relationType'] !== 'parentChild' ||
+            raw['@_state'] !== 'A' ||
+            a !== requested.uri ||
+            !objects.has(a) ||
+            !objects.has(b))
+            throw new RelationProtocolError('unsupported native relationship shape.');
+        const from = context === 'ENV' ? a : b, to = context === 'ENV' ? b : a;
+        edges.set(JSON.stringify([from, to]), {
+            from,
+            to,
+            kind: 'uses',
+            context,
+            evidence: 'sap_relation_explorer',
+            direct: null,
+        });
+    }
+    return { objects: [...objects.values()], edges: [...edges.values()] };
+}
+export class NativeRelationProvider {
+    client;
+    options;
+    constructor(client, options) {
+        this.client = client;
+        this.options = options;
+    }
+    async discover(known) {
+        let map = known;
+        if (!map) {
+            checkOperation(this.client.safety, OperationType.Read, 'DiscoverRepositoryRelations');
+            const result = await this.client.http.get('/sap/bc/adt/discovery', { Accept: 'application/atomsvc+xml' }, this.options);
+            const parsed = parseRelationXml(result.body);
+            if (!parsed.service)
+                throw new RelationProtocolError('invalid discovery document.');
+            map = parseDiscoveryObject(parsed);
+        }
+        if (!supportsRelations(map))
+            throw new RelationProtocolError('Relation Explorer endpoint/MIME is not advertised by SAP.');
+        return map;
+    }
+    async resolveRootUri(type, name) {
+        if (name.length > 120 || !RELATION_NAME.test(name))
+            throw new RelationProtocolError('invalid root name.');
+        let spec = relationObjectSpec(type);
+        if (!spec)
+            throw new RelationProtocolError('unsupported root type.');
+        // TABL has two physical paths; FUNC requires its parent group; VIT metadata
+        // can echo nonexistent names as active. Resolve these identities independently,
+        // with the SAME deadline/attempt/byte budgets as the rest of the analysis.
+        let uri;
+        if (spec.resolve === 'quickSearch') {
+            checkOperation(this.client.safety, OperationType.Read, 'ResolveRepositoryRelationRoot');
+            const params = new URLSearchParams({
+                operation: 'quickSearch',
+                query: name,
+                objectType: type === 'TABL' ? 'TABL' : spec.native,
+                maxResults: '2',
+            });
+            const result = await this.client.http.get(`/sap/bc/adt/repository/informationsystem/search?${params}`, {}, this.options);
+            const references = parseRelationXml(result.body).objectReferences;
+            const refs = references === '' ? [] : array(record(references).objectReference).map(record);
+            if (refs.length !== 1 || text(refs[0]['@_name'], 120).toUpperCase() !== name.toUpperCase()) {
+                throw new RelationProtocolError('root resolution is missing or ambiguous. Use SAPSearch to verify the exact name and type.');
+            }
+            const resolved = relationObjectSpec(text(refs[0]['@_type'], 64));
+            if (!resolved || resolved.type !== type || resolved.native !== refs[0]['@_type'])
+                throw new RelationProtocolError('root resolution type mismatch.');
+            spec = resolved;
+            uri = safeUri(refs[0]['@_uri']);
+            const group = type === 'FUNC' ? relationFunctionIdentity(uri).group : undefined;
+            if (uri !== relationObjectUri(spec.native, name, group))
+                throw new RelationProtocolError('root resolution URI mismatch.');
+        }
+        else
+            uri = relationObjectUri(type, name);
+        return { spec, uri };
+    }
+    async validateRoot(type, name) {
+        const { spec, uri } = await this.resolveRootUri(type, name);
+        checkOperation(this.client.safety, OperationType.Read, 'ValidateRepositoryRelationRoot');
+        const response = await this.client.http.get(uri, { Accept: 'application/*' }, this.options);
+        const parsed = parseRelationXml(response.body);
+        const metadata = record(parsed[spec.metadataRoot]);
+        const expectedType = spec.native;
+        if (text(metadata['@_name'], 120).toUpperCase() !== name.toUpperCase() ||
+            metadata['@_type'] !== expectedType ||
+            metadata['@_version'] !== 'active') {
+            const version = metadata['@_version'];
+            const state = version === 'inactive' || version === 'new'
+                ? ` SAP returned ${version} metadata; no native lookup was performed.`
+                : '';
+            throw new RelationProtocolError(`root metadata does not match the requested active object.${state}`);
+        }
+        const pkg = metadata.packageRef === undefined
+            ? type === 'FUNC'
+                ? (record(metadata.containerRef)['@_packageName'] ?? '')
+                : ''
+            : record(metadata.packageRef)['@_name'];
+        if (type === 'FUNC') {
+            const group = relationFunctionIdentity(uri).group;
+            const parent = record(metadata.containerRef);
+            if (parent['@_type'] !== 'FUGR/F' ||
+                parent['@_name'] !== group ||
+                safeUri(parent['@_uri']) !== relationObjectUri('FUGR', group))
+                throw new RelationProtocolError('function metadata parent mismatch.');
+        }
+        return {
+            uri,
+            name: name.toUpperCase(),
+            type: expectedType,
+            package: text(pkg, 120, true),
+            version: 'active',
+            existence: 'metadata_validated',
+        };
+    }
+    async lookup(object, direction) {
+        // Rebuild at the sink; a returned URI can never select an arbitrary ADT operation.
+        const group = object.type === 'FUGR/FF' ? relationFunctionIdentity(safeUri(object.uri)).group : undefined;
+        const uri = relationObjectUri(object.type, object.name, group);
+        if (uri !== object.uri)
+            throw new RelationProtocolError('expansion identity/URI mismatch.');
+        const context = direction === 'outgoing' ? 'ENV' : 'WUL';
+        const body = `<or:request xmlns:or="http://www.sap.com/adt/objectrelations" xmlns:adtcore="http://www.sap.com/adt/core"><or:reference adtcore:uri="${escapeXmlAttr(uri)}"/><or:preferredContext>${context}</or:preferredContext></or:request>`;
+        checkOperation(this.client.safety, OperationType.Intelligence, 'RepositoryRelations');
+        const response = await this.client.http.post(RELATIONS_PATH, body, RELATIONS_MIME, { Accept: '*/*' }, this.options);
+        const network = normalizeRelationNetwork(response.body, context, object);
+        // Serial, request-local traversal: only a fully validated expansion proves that an
+        // earlier 401/session or 403/CSRF retry recovered. Headers/control requests are not proof.
+        if (this.options.attemptBudget)
+            this.options.attemptBudget.authorizationFailureObserved = false;
+        return network;
+    }
+}
+//# sourceMappingURL=repository-relations.js.map

package/dist/adt/repository-relations.js.map

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

package/dist/adt/request-attempt-budget.d.ts

@@ -0,0 +1,26 @@
+import { type RequestInit } from 'undici';
+import { AdtNetworkError } from './errors.js';
+import type { AdtRequestOptions } from './http-deadline.js';
+/** Typed, non-retryable exhaustion; never carries SAP response data. */
+export declare class AdtRequestBudgetError extends AdtNetworkError {
+    readonly limit: number;
+    constructor(limit: number);
+}
+/** Analysis admission/work allowance, not a failure to reach SAP. */
+export declare class AdtAnalysisDeadlineError extends AdtNetworkError {
+    constructor();
+}
+/** A time boundary may yield partial evidence; cancellation, auth and send exhaustion may not masquerade as it. */
+export declare function isDeadlineFailure(error: unknown, options: AdtRequestOptions): boolean;
+/** Request-local allowance, charged immediately before each direct/proxy SAP send. */
+export declare class RequestAttemptBudget {
+    readonly limit: number;
+    used: number;
+    /** Unresolved auth evidence; only a validated native expansion may clear it after retry recovery. */
+    authorizationFailureObserved: boolean;
+    constructor(limit: number);
+    consume(): void;
+}
+/** Count below Fetch's internal 421 replay; preserve the existing dispatcher/TLS configuration. */
+export declare function fetchWithAttemptBudget(url: string, init: RequestInit, budget?: RequestAttemptBudget): Promise<import("undici").Response>;
+//# sourceMappingURL=request-attempt-budget.d.ts.map

package/dist/adt/request-attempt-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-attempt-budget.d.ts","sourceRoot":"","sources":["../../src/adt/request-attempt-budget.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,wEAAwE;AACxE,qBAAa,qBAAsB,SAAQ,eAAe;IAC5C,QAAQ,CAAC,KAAK,EAAE,MAAM;IAAlC,YAAqB,KAAK,EAAE,MAAM,EAGjC;CACF;AAED,qEAAqE;AACrE,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,cAGC;CACF;AAED,mHAAmH;AACnH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CASrF;AAED,sFAAsF;AACtF,qBAAa,oBAAoB;IAInB,QAAQ,CAAC,KAAK,EAAE,MAAM;IAHlC,IAAI,SAAK;IACT,qGAAqG;IACrG,4BAA4B,UAAS;IACrC,YAAqB,KAAK,EAAE,MAAM,EAEjC;IACD,OAAO,IAAI,IAAI,CAGd;CACF;AAED,mGAAmG;AACnG,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,oBAAoB,sCAazG"}