@mcp-abap-adt/interfaces-adt 1.0.0

package/dist/runtime/IAtcRun.d.ts

@@ -0,0 +1,99 @@
+/**
+ * ATC (ABAP Test Cockpit): starting a check run, asking whether it is done,
+ * and reading what it found.
+ *
+ * Separate from `IAtcLog`, which reads the execution log and the check-failure
+ * logs. Same subject, different resources — a worklist is not a log, and
+ * nothing here takes an execution id.
+ */
+import type { IAdtResponse } from '../adt/IAdtResponse';
+/**
+ * The object kinds ATC will check, at a URI a client can build for them.
+ *
+ * **Confirmed on an ABAP Cloud trial**, each by a run submitted at the URI the
+ * client builds whose finished worklist then listed that object under that
+ * type. A run being *accepted* proves nothing: a URI that cannot exist is
+ * answered `201` too.
+ *
+ * **This set is expected to grow, and growing it is a breaking change.**
+ * `program` and `include` are absent because ABAP Cloud refuses to hold either
+ * (`403`, authorization object `S_DEVELOP`), so nothing there could confirm
+ * them; an on-prem system would. Adding a member does not disturb a caller
+ * *passing* a value, but it does break one *exhausting* the union —
+ * `Record<AtcObjectType, …>`, or a `switch` with a `never` check. Do not build
+ * an exhaustive structure over this without meaning to revisit it.
+ */
+export type AtcObjectType = 'class' | 'interface' | 'function_group' | 'package' | 'ddl_source' | 'table' | 'behavior_definition';
+/** One object to check, by kind and name. The client builds the URI. */
+export interface IAtcObjectRef {
+    objectType: AtcObjectType;
+    objectName: string;
+}
+export interface IAtcRunTarget {
+    /**
+     * One or more objects to check, as one inclusive object set.
+     *
+     * A non-empty tuple rather than an array: "one or more" in a doc comment
+     * over a type that admits `[]` is a promise the compiler does not keep, and
+     * an empty object set would start a run over nothing.
+     */
+    objects: readonly [IAtcObjectRef, ...IAtcObjectRef[]];
+}
+export interface IAtcRunOptions {
+    /**
+     * Have the server hold the request until the checks finish (`clientWait`).
+     *
+     * Defaults to **false**: that is the mode which answers with a run id, and a
+     * run id is the only thing that can be polled, reported on while it runs, or
+     * abandoned on the caller's own timetable. `true` is one request instead of
+     * a loop, at the cost of a connection held for as long as the checks take —
+     * which nothing bounds, and which grows with the object set.
+     *
+     * The two modes answer with different shapes, and what those shapes are is the
+     * implementation's since 31.0.0.
+     */
+    wait?: boolean;
+    /**
+     * The check variant to run.
+     *
+     * Omitted, the client reads `systemCheckVariant` from ATC customizing. That
+     * is not a convenience: on a system where the variant list comes back empty,
+     * customizing is the only source of a usable one, and a contract demanding
+     * the caller supply it would be unusable there.
+     */
+    checkVariant?: string;
+    /**
+     * `maximumVerdicts` in the run payload: a **cap on results**, not a page
+     * size. Defaults to 100.
+     *
+     * A caller wanting everything raises it rather than paging — nothing
+     * observed says what happens at the boundary, so a truncated worklist is
+     * the failure to design against. Must be a positive integer; the server
+     * answers `0` with a 400.
+     */
+    maximumVerdicts?: number;
+}
+export interface IAtcRunStatusReadable<TStatus> {
+    /**
+     * Status of a run started with `wait: false`.
+     *
+     * **Poll it under a bound you choose.** There is no `waitForRun` helper here
+     * and that is deliberate: waiting needs a stopping condition for the case
+     * where a run does not finish, no failed run has ever been observed, and a
+     * helper would have to invent one. Whoever knows how long their checks take
+     * is the one who can decide when to give up — and `status` travels beside
+     * `isFinished` so they can report the state they last saw.
+     */
+    getRunStatus(runId: string): Promise<IAdtResponse<TStatus>>;
+}
+export interface IAtcFindings<TFindings> {
+    /**
+     * The worklist for a run: every object it checked, each with its findings,
+     * empty for the ones that were clean.
+     *
+     * Read it after the run reports finished. Read earlier it is empty whatever
+     * happened, which is indistinguishable from a run that found nothing.
+     */
+    getFindings(worklistId: string): Promise<IAdtResponse<TFindings>>;
+}
+//# sourceMappingURL=IAtcRun.d.ts.map

package/dist/runtime/IAtcRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IAtcRun.d.ts","sourceRoot":"","sources":["../../src/runtime/IAtcRun.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,aAAa,GACrB,OAAO,GACP,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,YAAY,GACZ,OAAO,GACP,qBAAqB,CAAC;AAE1B,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,OAAO,EAAE,SAAS,CAAC,aAAa,EAAE,GAAG,aAAa,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB,CAAC,OAAO;IAC5C;;;;;;;;;OASG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;CAC7D;AAED,MAAM,WAAW,YAAY,CAAC,SAAS;IACrC;;;;;;OAMG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC;CACnE"}

package/dist/runtime/IAtcRun.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * ATC (ABAP Test Cockpit): starting a check run, asking whether it is done,
+ * and reading what it found.
+ *
+ * Separate from `IAtcLog`, which reads the execution log and the check-failure
+ * logs. Same subject, different resources — a worklist is not a log, and
+ * nothing here takes an execution id.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/ICrossTrace.d.ts

@@ -0,0 +1,32 @@
+import type { IAdtResponse } from '../adt/IAdtResponse';
+export interface IListCrossTracesOptions {
+    traceUser?: string;
+    actCreateUser?: string;
+    actChangeUser?: string;
+}
+/**
+ * One key per distinct answer this contract has, not one per member.
+ *
+ * Five separate type parameters would make the fourth unnameable without
+ * spelling the first three; a record names them, and a consumer overriding one
+ * reading writes the key rather than counting positions. The same shape
+ * `@mcp-abap-adt/adt-clients` carries its result sets in.
+ */
+export interface ICrossTraceResults {
+    list: unknown;
+    trace: unknown;
+    records: unknown;
+    recordContent: unknown;
+    activations: unknown;
+}
+export interface ICrossTrace<R extends ICrossTraceResults> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'crossTrace';
+    /** The traces this system holds. */
+    list(options?: IListCrossTracesOptions): Promise<IAdtResponse<R['list']>>;
+    getById(traceId: string, includeSensitiveData?: boolean): Promise<IAdtResponse<R['trace']>>;
+    getRecords(traceId: string): Promise<IAdtResponse<R['records']>>;
+    getRecordContent(traceId: string, recordNumber: number): Promise<IAdtResponse<R['recordContent']>>;
+    getActivations(): Promise<IAdtResponse<R['activations']>>;
+}
+//# sourceMappingURL=ICrossTrace.d.ts.map

package/dist/runtime/ICrossTrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICrossTrace.d.ts","sourceRoot":"","sources":["../../src/runtime/ICrossTrace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,kBAAkB;IACvD,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B,oCAAoC;IACpC,IAAI,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE1E,OAAO,CACL,OAAO,EAAE,MAAM,EACf,oBAAoB,CAAC,EAAE,OAAO,GAC7B,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACjE,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC7C,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAC3D"}

package/dist/runtime/ICrossTrace.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/IDdicActivation.d.ts

@@ -0,0 +1,12 @@
+import type { IAdtResponse } from '../adt/IAdtResponse';
+export interface IGetActivationGraphOptions {
+    objectName?: string;
+    objectType?: string;
+    logName?: string;
+}
+export interface IDdicActivation<TGraph> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'ddicActivation';
+    getGraph(options?: IGetActivationGraphOptions): Promise<IAdtResponse<TGraph>>;
+}
+//# sourceMappingURL=IDdicActivation.d.ts.map

package/dist/runtime/IDdicActivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDdicActivation.d.ts","sourceRoot":"","sources":["../../src/runtime/IDdicActivation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe,CAAC,MAAM;IACrC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;CAC/E"}

package/dist/runtime/IDdicActivation.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/IGatewayErrorLog.d.ts

@@ -0,0 +1,10 @@
+import type { IAdtResponse } from '../adt/IAdtResponse';
+import type { IFeedQueryOptions } from '../feeds/types';
+export interface IGatewayErrorLog<TList, TError> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'gatewayErrorLog';
+    /** The errors the gateway has logged. */
+    list(options?: IFeedQueryOptions): Promise<IAdtResponse<TList>>;
+    getById(errorType: string, errorId: string): Promise<IAdtResponse<TError>>;
+}
+//# sourceMappingURL=IGatewayErrorLog.d.ts.map

package/dist/runtime/IGatewayErrorLog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IGatewayErrorLog.d.ts","sourceRoot":"","sources":["../../src/runtime/IGatewayErrorLog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,gBAAgB,CAAC,KAAK,EAAE,MAAM;IAC7C,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAEjC,yCAAyC;IACzC,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;CAC5E"}

package/dist/runtime/IGatewayErrorLog.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/IProfiler.d.ts

@@ -0,0 +1,65 @@
+import type { ITraceDeletion, ITraceEntry, ITraceFamily, ITraceListing, ITraceReading, ITraceView } from './ITrace';
+/**
+ * The profiler: what a run left behind, and what a caller passes to ask for it.
+ *
+ * `IProfiler` is a **composition of atoms**, and it stayed — a consumer needs it
+ * to type a profiler and to implement one, and making each of them spell the
+ * intersection by hand is the bloat decision 24 is against, not the bloat it is
+ * about. What left in 31.0.0 are the concrete readings it used to name:
+ * `IAbapTraceEntry`, `IAbapTraceViews` and the view shapes. They arrive as type
+ * parameters now, with **no defaults**, exactly as {@link IClassExecutor} and
+ * {@link ICrossTrace} take theirs.
+ */
+export interface IProfilerListOptions {
+    user?: string;
+}
+/**
+ * What to measure.
+ *
+ * This is an argument to a *run*, not to a read, which is why it travels with
+ * scheduling rather than staying on the reading surface.
+ */
+export interface IProfilerTraceParameters {
+    allMiscAbapStatements?: boolean;
+    allProceduralUnits?: boolean;
+    allInternalTableEvents?: boolean;
+    allDynproEvents?: boolean;
+    description?: string;
+    aggregate?: boolean;
+    explicitOnOff?: boolean;
+    withRfcTracing?: boolean;
+    allSystemKernelEvents?: boolean;
+    sqlTrace?: boolean;
+    allDbEvents?: boolean;
+    maxSizeForTraceFile?: number;
+    amdpTrace?: boolean;
+    maxTimeForTracing?: number;
+}
+export interface IProfilerTraceHitListOptions {
+    withSystemEvents?: boolean;
+}
+export interface IProfilerTraceStatementsOptions {
+    id?: number;
+    withDetails?: boolean;
+    autoDrillDownThreshold?: number;
+    withSystemEvents?: boolean;
+}
+export interface IProfilerTraceDbAccessesOptions {
+    withSystemEvents?: boolean;
+}
+/**
+ * A profiler, composed.
+ *
+ * `TEntry` is what its listing answers per trace; `TViews` maps each view name
+ * to the reading that view performs. Both are the implementation's — this
+ * package says a profiler lists, reads and deletes, and says nothing about what
+ * a hit list looks like.
+ *
+ * ```typescript
+ * type MyProfiler = IProfiler<MyTraceEntry, { hitlist: ITraceView<MyHitList> }>;
+ * ```
+ */
+export type IProfiler<TEntry extends ITraceEntry, TViews extends {
+    [K in keyof TViews]: ITraceView<unknown, unknown>;
+}> = ITraceFamily<'profiler'> & ITraceListing<TEntry, IProfilerListOptions> & ITraceReading<TViews> & ITraceDeletion;
+//# sourceMappingURL=IProfiler.d.ts.map

package/dist/runtime/IProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProfiler.d.ts","sourceRoot":"","sources":["../../src/runtime/IProfiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,UAAU,EACX,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,4BAA4B;IAC3C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,+BAA+B;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,+BAA+B;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,SAAS,CACnB,MAAM,SAAS,WAAW,EAC1B,MAAM,SAAS;KAAG,CAAC,IAAI,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;CAAE,IAClE,YAAY,CAAC,UAAU,CAAC,GAC1B,aAAa,CAAC,MAAM,EAAE,oBAAoB,CAAC,GAC3C,aAAa,CAAC,MAAM,CAAC,GACrB,cAAc,CAAC"}

package/dist/runtime/IProfiler.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/IRuntimeDumps.d.ts

@@ -0,0 +1,23 @@
+import type { IAdtResponse } from '../adt/IAdtResponse';
+export type IRuntimeDumpReadView = 'default' | 'summary' | 'formatted';
+export interface IRuntimeDumpsListOptions {
+    query?: string;
+    inlinecount?: 'allpages' | 'none';
+    top?: number;
+    skip?: number;
+    orderby?: string;
+    from?: string;
+    to?: string;
+}
+export interface IRuntimeDumpReadOptions {
+    view?: IRuntimeDumpReadView;
+}
+export interface IRuntimeDumps<TList, TDump> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'runtimeDumps';
+    /** The dumps this system holds. */
+    list(options?: IRuntimeDumpsListOptions): Promise<IAdtResponse<TList>>;
+    listByUser(user?: string, options?: Omit<IRuntimeDumpsListOptions, 'query'>): Promise<IAdtResponse<TList>>;
+    getById(dumpId: string, options?: IRuntimeDumpReadOptions): Promise<IAdtResponse<TDump>>;
+}
+//# sourceMappingURL=IRuntimeDumps.d.ts.map

package/dist/runtime/IRuntimeDumps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRuntimeDumps.d.ts","sourceRoot":"","sources":["../../src/runtime/IRuntimeDumps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;AAEvE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,EAAE,KAAK;IACzC,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAE9B,mCAAmC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvE,UAAU,CACR,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,OAAO,CAAC,GAChD,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC,OAAO,CACL,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;CACjC"}

package/dist/runtime/IRuntimeDumps.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/ISt05Trace.d.ts

@@ -0,0 +1,8 @@
+import type { IAdtResponse } from '../adt/IAdtResponse';
+export interface ISt05Trace<TState, TDirectory> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'st05Trace';
+    getState(): Promise<IAdtResponse<TState>>;
+    getDirectory(): Promise<IAdtResponse<TDirectory>>;
+}
+//# sourceMappingURL=ISt05Trace.d.ts.map

package/dist/runtime/ISt05Trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISt05Trace.d.ts","sourceRoot":"","sources":["../../src/runtime/ISt05Trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,UAAU,CAAC,MAAM,EAAE,UAAU;IAC5C,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1C,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC;CACnD"}

package/dist/runtime/ISt05Trace.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/ISystemMessages.d.ts

@@ -0,0 +1,10 @@
+import type { IAdtResponse } from '../adt/IAdtResponse';
+import type { IFeedQueryOptions } from '../feeds/types';
+export interface ISystemMessages<TList, TMessage> {
+    /** Which runtime resource this is, for a consumer narrowing a union of them. */
+    readonly kind: 'systemMessages';
+    /** The messages this system is showing. */
+    list(options?: IFeedQueryOptions): Promise<IAdtResponse<TList>>;
+    getById(messageId: string): Promise<IAdtResponse<TMessage>>;
+}
+//# sourceMappingURL=ISystemMessages.d.ts.map

package/dist/runtime/ISystemMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISystemMessages.d.ts","sourceRoot":"","sources":["../../src/runtime/ISystemMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,QAAQ;IAC9C,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,2CAA2C;IAC3C,IAAI,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;IAEhE,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7D"}

package/dist/runtime/ISystemMessages.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/runtime/ITrace.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Reading what a run left behind.
+ *
+ * Two atoms — a listing and a read — composed per trace family. A family that
+ * has views composes {@link ITraceReading} in; a family that has none says
+ * nothing about reading, which is the only truthful way for a type to say it.
+ *
+ * The shapes here are transcribed from measurements, not designed. `ITraceEntry`
+ * is what an `abaptraces` feed entry carries — measured on a cloud tenant and on
+ * an on-prem system, every field present in every entry of both. The systems,
+ * releases and raw bodies are in the design spec and its evidence files.
+ */
+import type { IAdtResponse } from '../adt/IAdtResponse';
+/**
+ * A trace's lifecycle state.
+ *
+ * A named type rather than an inline `{ value; text }`, because a consumer that
+ * implements the contract has to *return* this, and an anonymous shape leaves it
+ * re-declaring the same two fields in its own code — which is the duplication
+ * this package exists to remove. Naming it costs one export.
+ */
+export interface ITraceState {
+    /** `trc:state/@value` — `R` on every entry read. */
+    value: string;
+    /** `trc:state/@text` — `Finished` for `R`. */
+    text: string;
+}
+/**
+ * One trace, as every family can describe it.
+ *
+ * The optional members are optional because a family other than `abaptraces`
+ * may not have them — not because that one sometimes omits them.
+ */
+export interface ITraceEntry {
+    /** `atom:id` — a URI, not an opaque token. */
+    id: string;
+    /**
+     * `atom:published`.
+     *
+     * Position in a feed is NOT age: measured, a feed's first entries were minutes
+     * old while its last were eight days older, so anything picking "the first id
+     * in the document" gets a trace chosen at random.
+     */
+    recordedAt: string;
+    /** `trc:user`, which equals `atom:author/atom:name`. */
+    user?: string;
+    /** `trc:objectName` — the generated form, e.g. `ZCL_SOMETHING=========CP`. */
+    objectName?: string;
+    uri?: string;
+    /**
+     * `trc:state` — `R`/Finished on every entry seen.
+     *
+     * A trace has a lifecycle, so "it exists" and "it is readable" are not the
+     * same claim.
+     */
+    state?: ITraceState;
+    /**
+     * `trc:expiration`. The system deletes traces — about four weeks out on both
+     * systems measured, though that is a system setting and not a contract.
+     * Reading one a week later is fine; a year later is not, and this says when.
+     */
+    expiresAt?: string;
+}
+/**
+ * What a view yields, and what it must be given.
+ *
+ * A pair from the start: a map of result types alone has nowhere to keep
+ * options, and nothing about a result implies them — cross-trace's
+ * `recordContent` needs a record number that no result type mentions.
+ */
+export interface ITraceView<TResult, TOptions = void> {
+    result: TResult;
+    options: TOptions;
+}
+export type ViewResult<TViews, K extends keyof TViews> = TViews[K] extends ITraceView<infer TResult, infer _TOptions> ? TResult : never;
+export type ViewOptions<TViews, K extends keyof TViews> = TViews[K] extends ITraceView<infer _TResult, infer TOptions> ? TOptions : never;
+/** Options are required when the view says so, and absent when it says `void`. */
+export type ViewArgs<TViews, K extends keyof TViews> = ViewOptions<TViews, K> extends void ? [] : undefined extends ViewOptions<TViews, K> ? [options?: ViewOptions<TViews, K>] : [options: ViewOptions<TViews, K>];
+/** What traces exist. */
+export interface ITraceListing<TEntry extends ITraceEntry = ITraceEntry, TOptions = void> {
+    list(options?: TOptions): Promise<IAdtResponse<TEntry[]>>;
+}
+/**
+ * What is inside one trace.
+ *
+ * The constraint is self-mapped — every property of the map must BE a view.
+ * `Record<string, unknown>` cannot be used, because an `interface` has no
+ * implicit index signature and would be rejected; a bare `object` would accept
+ * anything, so a map with a non-view member would compile and fail later,
+ * silently, with a result of `never` at the call site. This form needs no index
+ * signature and refuses the bad map where it is written.
+ */
+export interface ITraceReading<TViews extends {
+    [K in keyof TViews]: ITraceView<unknown, unknown>;
+}> {
+    read<K extends keyof TViews>(traceId: string, view: K, ...args: ViewArgs<TViews, K>): Promise<IAdtResponse<ViewResult<TViews, K>>>;
+}
+/**
+ * Reading a trace differently is a strategy, not a member.
+ *
+ * `ITraceReadingWithParser` stood here until 30.0.0, taking
+ * `parse: (data: unknown) => T` at the call. It is gone for the reason decision
+ * 22 gives: a reading is chosen once, when the implementation is constructed,
+ * and the member's result type follows it. A consumer that needs a trace read
+ * differently — or that runs against a system answering in a shape the default
+ * does not fit — supplies an `IResultStrategy` and keeps a type, exactly as
+ * before, without every implementer owing a second signature.
+ *
+ * What has not changed is what this is *not* for. Searching and filtering
+ * belong to the server, which has endpoints for them.
+ */
+/**
+ * Removing a trace.
+ *
+ * Its own atom, beside {@link ITraceListing} and {@link ITraceReading}, because
+ * not every family need offer it and a composition should say which does.
+ *
+ * ADT advertises this itself: every entry in the ABAP trace feed carries
+ * `<atom:link rel="http://www.sap.com/adt/relations/delete">` next to the links
+ * for its three views, and the `DELETE` it points at answers `200` — measured
+ * on an on-prem system, 2026-08-30, on a trace produced by a profiled run.
+ *
+ * The value is `void`: a caller has nothing to read from a deletion. The
+ * *answer* is not — it is {@link IAdtResponse} like everything else, so whether
+ * the deletion happened is asked of `ok`, not caught. Until 30.0.0 this member
+ * resolved with nothing and rejected on failure, and a consumer migrating from
+ * that contract replaces the `catch` with the check.
+ *
+ * **What deleting an id that is not there does has NOT been measured.** Only the
+ * `200` above was: one existing trace, once. An earlier draft said a trace that
+ * is gone and one that never was leave the caller in the same place, and a
+ * caller writing cleanup would have relied on that.
+ *
+ * Note what the HTTP definition does and does not give here. `DELETE` is
+ * idempotent (RFC 9110 §9.2.2), but that is a statement about the **effect on
+ * the server** — the resource ends up absent either way. It promises nothing
+ * about the **status returned**, and the status is what a strategy reads to
+ * decide whether this is a failure. So idempotence is true and useless to a
+ * caller.
+ *
+ * What a caller needs to know is still unmeasured: whether a second delete
+ * answers `200` or `404`. What has changed is what to do about it — code that
+ * must tolerate a missing id reads `ok` and decides, instead of catching.
+ *
+ * **This member takes no options, so there is no per-call `analyse` here.**
+ * `IAdtOperationOptions` is carried by eleven members on the capability atoms,
+ * where a caller overrules
+ * the verdict for one request; a consumer who wants a repeat delete counted as
+ * success everywhere states that in the error strategy their implementation is
+ * constructed with, which is the same place its result strategy comes from
+ * (decision 22). A member with no options is not a member with no choice.
+ */
+export interface ITraceDeletion {
+    delete(traceId: string): Promise<IAdtResponse<void>>;
+}
+/**
+ * What a trace family is called.
+ *
+ * Nothing is extended in here. Until 30.0.0 this carried `ITraceListing` along
+ * with the name, so a family that only lists and one that also reads could not
+ * be told apart by their types — inheritance decides for the composer what
+ * belongs together. `IProfiler` and `ICrossTrace` are published compositions of
+ * this with listing, reading and deletion — the composition is a contract, and
+ * the readings it is instantiated with are the implementation's.
+ */
+export interface ITraceFamily<TKind extends string> {
+    /** Literal, so it still discriminates when several families share a shape. */
+    readonly kind: TKind;
+}
+//# sourceMappingURL=ITrace.d.ts.map

package/dist/runtime/ITrace.d.ts.map

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

package/dist/runtime/ITrace.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Reading what a run left behind.
+ *
+ * Two atoms — a listing and a read — composed per trace family. A family that
+ * has views composes {@link ITraceReading} in; a family that has none says
+ * nothing about reading, which is the only truthful way for a type to say it.
+ *
+ * The shapes here are transcribed from measurements, not designed. `ITraceEntry`
+ * is what an `abaptraces` feed entry carries — measured on a cloud tenant and on
+ * an on-prem system, every field present in every entry of both. The systems,
+ * releases and raw bodies are in the design spec and its evidence files.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sap/ISapConfig.d.ts

@@ -0,0 +1,22 @@
+import type { SapAuthType, SapConnectionType } from './SapAuthType';
+export interface ISapConfig {
+    url: string;
+    client?: string;
+    authType: SapAuthType;
+    connectionType?: SapConnectionType;
+    username?: string;
+    password?: string;
+    jwtToken?: string;
+    refreshToken?: string;
+    sessionCookies?: string;
+    certPath?: string;
+    certKeyPath?: string;
+    certPfxPath?: string;
+    certPassphrase?: string;
+    kerberosSpn?: string;
+    kerberosService?: string;
+    uaaUrl?: string;
+    uaaClientId?: string;
+    uaaClientSecret?: string;
+}
+//# sourceMappingURL=ISapConfig.d.ts.map

package/dist/sap/ISapConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ISapConfig.d.ts","sourceRoot":"","sources":["../../src/sap/ISapConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEpE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;IACtB,cAAc,CAAC,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/sap/ISapConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/sap/SapAuthType.d.ts

@@ -0,0 +1,3 @@
+export type SapAuthType = 'basic' | 'jwt' | 'saml' | 'certificate' | 'kerberos';
+export type SapConnectionType = 'http' | 'rfc';
+//# sourceMappingURL=SapAuthType.d.ts.map

package/dist/sap/SapAuthType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SapAuthType.d.ts","sourceRoot":"","sources":["../../src/sap/SapAuthType.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;AAEhF,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,CAAC"}

package/dist/sap/SapAuthType.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });