arc-1 1.1.2 → 1.3.0

package/dist/adt/internal-data-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-data-operations.d.ts","sourceRoot":"","sources":["../../src/adt/internal-data-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,MAAM,uBAAuB,GAC/B,iBAAiB,GACjB,yBAAyB,GACzB,iBAAiB,GACjB,wBAAwB,GACxB,mBAAmB,GACnB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAAC;IAC1C,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,uBAAuB,EAAE,qBAAqB,CA8C3F,CAAC;AAEF,6FAA6F;AAC7F,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,uEAAuE;AACvE,wBAAgB,2BAA2B,CACzC,kBAAkB,EAAE,SAAS,MAAM,EAAE,GACpC,KAAK,CAAC;IAAE,EAAE,EAAE,uBAAuB,CAAC;IAAC,SAAS,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAU7F;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,uBAAuB,EAC3B,KAAK,EAAE,qBAAqB,EAC5B,aAAa,EAAE,OAAO,GACrB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG5F"}

package/dist/adt/internal-data-operations.js

@@ -0,0 +1,99 @@
+/**
+ * Private registry of ARC-1's own fixed data reads.
+ *
+ * Some features read SAP metadata tables with statements ARC-1 builds itself: repository lookup,
+ * class hierarchy, transaction enrichment, BOR method resolution and authorization-trace decoding.
+ * They are declared here so that code, tests and operator documentation cannot drift apart, and so
+ * that "which feature breaks if I block this table?" has one answer.
+ *
+ * This registry is NOT a bypass. Every entry still goes through the same
+ * `checkOperation(Query|FreeSQL)` capability gate, the same caller scopes, and the same data-source
+ * blocklist, in that order. There is deliberately no `internal=true` argument, no caller-settable
+ * flag, and nothing here is reachable from an MCP tool schema — blocking a table listed below really
+ * does disable the feature that reads it, which is the intended, documented behaviour.
+ *
+ * Criticality drives model feedback:
+ * - `core`     the feature cannot produce a correct answer without the source, so it must fail with
+ *              an actionable reason (and an alternative where one exists);
+ * - `optional` the feature degrades to a still-correct but less complete answer, so it must return
+ *              its data WITH an explicit warning. Silently swallowing the policy error would let the
+ *              model infer success from an incomplete result, which is the failure mode this
+ *              registry exists to prevent.
+ */
+export const INTERNAL_DATA_OPERATIONS = {
+    tadir_lookup_db: {
+        sources: ['TADIR'],
+        consumer: 'SAPSearch(searchType="tadir_lookup", source="db"|"both")',
+        criticality: 'core',
+        guidance: 'Retry with source="adt", which uses the ADT information system instead of TADIR. ' +
+            'Note the ADT path cannot see orphan/ghost TADIR rows, so a "db"/"both" split-brain check is not possible while TADIR is blocked.',
+    },
+    tran_program_enrichment: {
+        sources: ['TSTC'],
+        consumer: 'SAPRead(type="TRAN") program-name enrichment',
+        criticality: 'optional',
+        guidance: 'Transaction metadata is returned without the program name; read the transaction in SAP GUI (SE93) for it.',
+    },
+    class_hierarchy: {
+        sources: ['SEOMETAREL'],
+        consumer: 'SAPNavigate(action="hierarchy")',
+        criticality: 'core',
+        guidance: 'Class hierarchy is derived from SEOMETAREL and has no alternative source in ARC-1. ' +
+            'Use SAPRead(type="CLAS", grep="INTERFACES|INHERITING") on the class MAIN source for declarations, not a complete subclass list.',
+    },
+    interface_implementers: {
+        sources: ['SEOMETAREL'],
+        consumer: 'SAPNavigate.references / SAPContext.usages interface-implementer augmentation',
+        criticality: 'optional',
+        guidance: 'The native SAP where-used result is returned, but the list of classes implementing this interface may be incomplete.',
+    },
+    bor_method_lookup: {
+        sources: ['SWOTLV'],
+        consumer: 'SAPRead(type="SOBJ") BOR method catalogue and implementation lookup',
+        criticality: 'core',
+        guidance: 'BOR method resolution requires SWOTLV and has no alternative source in ARC-1. Inspect the object type in SAP GUI (SWO1) instead.',
+    },
+    authorization_trace: {
+        sources: ['SUAUTHVALTRC', 'TOBJ'],
+        consumer: 'SAPDiagnose(action="authorization_trace")',
+        criticality: 'core',
+        guidance: 'The authorization trace needs SUAUTHVALTRC for the trace rows and TOBJ to decode field names. ' +
+            'Both are required: returning positional values without their field names would be ambiguous and misleading, so the action is denied rather than partially answered.',
+    },
+};
+/** Every distinct source ARC-1 reads for its own features, for docs and operator tooling. */
+export function internalDataSources() {
+    return [...new Set(Object.values(INTERNAL_DATA_OPERATIONS).flatMap((op) => [...op.sources]))].sort();
+}
+/** Registry entries whose sources intersect a configured blocklist. */
+export function internalOperationsBlockedBy(blockedDataSources) {
+    const blocked = new Set(blockedDataSources);
+    const hits = [];
+    for (const [id, operation] of Object.entries(INTERNAL_DATA_OPERATIONS)) {
+        const matched = operation.sources.filter((source) => blocked.has(source));
+        if (matched.length > 0) {
+            hits.push({ id: id, operation, blocked: matched });
+        }
+    }
+    return hits;
+}
+/**
+ * Model-facing explanation for a denied internal read.
+ *
+ * Takes the error, not its text, so the policy part always honours `ARC1_MINIMAL_ERRORS`. The added
+ * guidance names only the operation's documented sources, never a configured rule or variable.
+ */
+export function internalOperationDenial(id, error, minimalErrors) {
+    const operation = INTERNAL_DATA_OPERATIONS[id];
+    return `${error.clientMessage(minimalErrors)}\n\nAffected: ${operation.consumer}. ${operation.guidance}`;
+}
+/**
+ * Warning appended to a degraded-but-correct result when an optional internal read is denied.
+ * `reason` must be stable caller-authored text (normally an error code), never caught policy or
+ * backend text: warnings bypass `ARC1_MINIMAL_ERRORS`.
+ */
+export function internalOperationWarning(id, reason) {
+    const operation = INTERNAL_DATA_OPERATIONS[id];
+    return `Incomplete result: ${operation.consumer} could not read ${operation.sources.join(' / ')}. ${operation.guidance} (${reason})`;
+}
+//# sourceMappingURL=internal-data-operations.js.map

package/dist/adt/internal-data-operations.js.map

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

package/dist/adt/package-contents.d.ts

@@ -0,0 +1,12 @@
+/** ADT quick search provides neither a total nor proof of full package coverage. */
+export declare function describePackageListing(returned: number, requested: number | undefined): {
+    returned: number;
+    effectiveLimit: number;
+    limitReached: boolean;
+    possiblyTruncated: boolean;
+    completeness: 'unknown';
+    total: null;
+    coverage: 'adt-search';
+    note: string;
+};
+//# sourceMappingURL=package-contents.d.ts.map

package/dist/adt/package-contents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-contents.d.ts","sourceRoot":"","sources":["../../src/adt/package-contents.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS;;;;;kBAQpE,SAAS;;cAEb,YAAY;;EAMzB"}

package/dist/adt/package-contents.js

@@ -0,0 +1,19 @@
+import { clampUrlLimit } from './result-limits.js';
+/** ADT quick search provides neither a total nor proof of full package coverage. */
+export function describePackageListing(returned, requested) {
+    const effectiveLimit = clampUrlLimit(requested, 200);
+    const limitReached = returned >= effectiveLimit;
+    return {
+        returned,
+        effectiveLimit,
+        limitReached,
+        possiblyTruncated: limitReached,
+        completeness: 'unknown',
+        total: null,
+        coverage: 'adt-search',
+        note: (limitReached
+            ? `Result limit reached; listing may be truncated. ${effectiveLimit < 1000 ? 'Raise maxResults up to 1000 or use targeted SAPSearch queries. ' : 'Use targeted SAPSearch queries. '}`
+            : '') + 'ADT search omits many repository object types; this is not a complete package inventory.',
+    };
+}
+//# sourceMappingURL=package-contents.js.map

package/dist/adt/package-contents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-contents.js","sourceRoot":"","sources":["../../src/adt/package-contents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,UAAU,sBAAsB,CAAC,QAAgB,EAAE,SAA6B;IACpF,MAAM,cAAc,GAAG,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,QAAQ,IAAI,cAAc,CAAC;IAChD,OAAO;QACL,QAAQ;QACR,cAAc;QACd,YAAY;QACZ,iBAAiB,EAAE,YAAY;QAC/B,YAAY,EAAE,SAAkB;QAChC,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,YAAqB;QAC/B,IAAI,EACF,CAAC,YAAY;YACX,CAAC,CAAC,mDAAmD,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,iEAAiE,CAAC,CAAC,CAAC,kCAAkC,EAAE;YACrL,CAAC,CAAC,EAAE,CAAC,GAAG,0FAA0F;KACvG,CAAC;AACJ,CAAC"}

package/dist/adt/relation-objects.d.ts

@@ -0,0 +1,385 @@
+/** Live-verified identity adapters, not a registry of everything SAP can display. */
+export declare const RELATION_OBJECTS: readonly [{
+    readonly type: 'CLAS';
+    readonly native: 'CLAS/OC';
+    readonly path: 'oo/classes';
+    readonly metadataRoot: 'abapClass';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'INTF';
+    readonly native: 'INTF/OI';
+    readonly path: 'oo/interfaces';
+    readonly metadataRoot: 'abapInterface';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'DDLS';
+    readonly native: 'DDLS/DF';
+    readonly path: 'ddic/ddl/sources';
+    readonly metadataRoot: 'ddlSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'DCLS';
+    readonly native: 'DCLS/DL';
+    readonly path: 'acm/dcl/sources';
+    readonly metadataRoot: 'dclSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'BDEF';
+    readonly native: 'BDEF/BDO';
+    readonly path: 'bo/behaviordefinitions';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'SRVD';
+    readonly native: 'SRVD/SRV';
+    readonly path: 'ddic/srvd/sources';
+    readonly metadataRoot: 'srvdSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'TABL';
+    readonly native: 'TABL/DT';
+    readonly path: 'ddic/tables';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'TABL';
+    readonly native: 'TABL/DS';
+    readonly path: 'ddic/structures';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'TTYP';
+    readonly native: 'TTYP/DA';
+    readonly path: 'ddic/tabletypes';
+    readonly metadataRoot: 'tableType';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'DTEL';
+    readonly native: 'DTEL/DE';
+    readonly path: 'ddic/dataelements';
+    readonly metadataRoot: 'wbobj';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'DOMA';
+    readonly native: 'DOMA/DD';
+    readonly path: 'ddic/domains';
+    readonly metadataRoot: 'domain';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'PROG';
+    readonly native: 'PROG/P';
+    readonly path: 'programs/programs';
+    readonly metadataRoot: 'abapProgram';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'INCL';
+    readonly native: 'PROG/I';
+    readonly path: 'programs/includes';
+    readonly metadataRoot: 'abapInclude';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'FUGR';
+    readonly native: 'FUGR/F';
+    readonly path: 'functions/groups';
+    readonly metadataRoot: 'abapFunctionGroup';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'FUNC';
+    readonly native: 'FUGR/FF';
+    readonly path: 'functions/groups';
+    readonly metadataRoot: 'abapFunctionModule';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'VIEW';
+    readonly native: 'VIEW/DV';
+    readonly path: 'vit/wb/object_type/viewdv/object_name';
+    readonly metadataRoot: 'mainObject';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'upper';
+}, {
+    readonly type: 'ENHO';
+    readonly native: 'ENHO/XHB';
+    readonly path: 'enhancements/enhoxhb';
+    readonly metadataRoot: 'objectData';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'MSAG';
+    readonly native: 'MSAG/N';
+    readonly path: 'messageclass';
+    readonly metadataRoot: 'messageClass';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'TRAN';
+    readonly native: 'TRAN/T';
+    readonly path: 'vit/wb/object_type/trant/object_name';
+    readonly metadataRoot: 'mainObject';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'upper';
+}, {
+    readonly type: 'SHLP';
+    readonly native: 'SHLP/DH';
+    readonly path: 'vit/wb/object_type/shlpdh/object_name';
+    readonly metadataRoot: 'mainObject';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'upper';
+}, {
+    readonly type: 'SKTD';
+    readonly native: 'SKTD/TYP';
+    readonly path: 'documentation/ktd/documents';
+    readonly metadataRoot: 'docu';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'ENHS';
+    readonly native: 'ENHS/XSB';
+    readonly path: 'enhancements/enhsxsb';
+    readonly metadataRoot: 'objectData';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'ENQU';
+    readonly native: 'ENQU/DL';
+    readonly path: 'ddic/lockobjects/sources';
+    readonly metadataRoot: 'lockobject';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'TYPE';
+    readonly native: 'TYPE/DG';
+    readonly path: 'ddic/typegroups';
+    readonly metadataRoot: 'abapTypeGroup';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'EVTB';
+    readonly native: 'EVTB/EVB';
+    readonly path: 'businessservices/evtbevb';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}, {
+    readonly type: 'DSFD';
+    readonly native: 'DSFD/SCF';
+    readonly path: 'ddic/dsfd/sources';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+}];
+export declare const RELATION_ROOT_TYPES: ("BDEF" | "CLAS" | "DCLS" | "DDLS" | "DOMA" | "DSFD" | "DTEL" | "ENHO" | "ENHS" | "ENQU" | "EVTB" | "FUGR" | "FUNC" | "INCL" | "INTF" | "MSAG" | "PROG" | "SHLP" | "SKTD" | "SRVD" | "TABL" | "TRAN" | "TTYP" | "TYPE" | "VIEW")[];
+export declare const RELATION_NAME: RegExp;
+export declare class RelationProtocolError extends Error {
+    constructor(message: string);
+}
+export declare function relationObjectSpec(type: string): {
+    readonly type: 'CLAS';
+    readonly native: 'CLAS/OC';
+    readonly path: 'oo/classes';
+    readonly metadataRoot: 'abapClass';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'INTF';
+    readonly native: 'INTF/OI';
+    readonly path: 'oo/interfaces';
+    readonly metadataRoot: 'abapInterface';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'DDLS';
+    readonly native: 'DDLS/DF';
+    readonly path: 'ddic/ddl/sources';
+    readonly metadataRoot: 'ddlSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'DCLS';
+    readonly native: 'DCLS/DL';
+    readonly path: 'acm/dcl/sources';
+    readonly metadataRoot: 'dclSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'BDEF';
+    readonly native: 'BDEF/BDO';
+    readonly path: 'bo/behaviordefinitions';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'SRVD';
+    readonly native: 'SRVD/SRV';
+    readonly path: 'ddic/srvd/sources';
+    readonly metadataRoot: 'srvdSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'TABL';
+    readonly native: 'TABL/DT';
+    readonly path: 'ddic/tables';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'TABL';
+    readonly native: 'TABL/DS';
+    readonly path: 'ddic/structures';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'TTYP';
+    readonly native: 'TTYP/DA';
+    readonly path: 'ddic/tabletypes';
+    readonly metadataRoot: 'tableType';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'DTEL';
+    readonly native: 'DTEL/DE';
+    readonly path: 'ddic/dataelements';
+    readonly metadataRoot: 'wbobj';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'DOMA';
+    readonly native: 'DOMA/DD';
+    readonly path: 'ddic/domains';
+    readonly metadataRoot: 'domain';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'PROG';
+    readonly native: 'PROG/P';
+    readonly path: 'programs/programs';
+    readonly metadataRoot: 'abapProgram';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'INCL';
+    readonly native: 'PROG/I';
+    readonly path: 'programs/includes';
+    readonly metadataRoot: 'abapInclude';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'FUGR';
+    readonly native: 'FUGR/F';
+    readonly path: 'functions/groups';
+    readonly metadataRoot: 'abapFunctionGroup';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'FUNC';
+    readonly native: 'FUGR/FF';
+    readonly path: 'functions/groups';
+    readonly metadataRoot: 'abapFunctionModule';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'VIEW';
+    readonly native: 'VIEW/DV';
+    readonly path: 'vit/wb/object_type/viewdv/object_name';
+    readonly metadataRoot: 'mainObject';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'upper';
+} | {
+    readonly type: 'ENHO';
+    readonly native: 'ENHO/XHB';
+    readonly path: 'enhancements/enhoxhb';
+    readonly metadataRoot: 'objectData';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'MSAG';
+    readonly native: 'MSAG/N';
+    readonly path: 'messageclass';
+    readonly metadataRoot: 'messageClass';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'TRAN';
+    readonly native: 'TRAN/T';
+    readonly path: 'vit/wb/object_type/trant/object_name';
+    readonly metadataRoot: 'mainObject';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'upper';
+} | {
+    readonly type: 'SHLP';
+    readonly native: 'SHLP/DH';
+    readonly path: 'vit/wb/object_type/shlpdh/object_name';
+    readonly metadataRoot: 'mainObject';
+    readonly resolve: 'quickSearch';
+    readonly nameCase: 'upper';
+} | {
+    readonly type: 'SKTD';
+    readonly native: 'SKTD/TYP';
+    readonly path: 'documentation/ktd/documents';
+    readonly metadataRoot: 'docu';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'ENHS';
+    readonly native: 'ENHS/XSB';
+    readonly path: 'enhancements/enhsxsb';
+    readonly metadataRoot: 'objectData';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'ENQU';
+    readonly native: 'ENQU/DL';
+    readonly path: 'ddic/lockobjects/sources';
+    readonly metadataRoot: 'lockobject';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'TYPE';
+    readonly native: 'TYPE/DG';
+    readonly path: 'ddic/typegroups';
+    readonly metadataRoot: 'abapTypeGroup';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'EVTB';
+    readonly native: 'EVTB/EVB';
+    readonly path: 'businessservices/evtbevb';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | {
+    readonly type: 'DSFD';
+    readonly native: 'DSFD/SCF';
+    readonly path: 'ddic/dsfd/sources';
+    readonly metadataRoot: 'blueSource';
+    readonly resolve: 'path';
+    readonly nameCase: 'lower';
+} | undefined;
+/** Reconstruct a fixed read-only object path; never follow arbitrary SAP-returned hrefs. */
+export declare function relationObjectUri(type: string, name: string, group?: string): string;
+/** Group/name can be decoded only after the caller canonicalizes the host-relative ADT URI. */
+export declare function relationFunctionIdentity(uri: string): {
+    group: string;
+    name: string;
+};
+/** 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 declare function relationReferenceName(name: string, type: string, uri: string): string;
+//# sourceMappingURL=relation-objects.d.ts.map

package/dist/adt/relation-objects.d.ts.map

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